routie dev init since i didn't adhere to any proper guidance up until now

frontend/node_modules/eslint-plugin-perfectionist/dist/utils/compute-group.d.ts

@@ -0,0 +1,72 @@
+import {
+  CommonGroupsOptions,
+  AnyOfCustomGroup,
+} from '../types/common-groups-options.js'
+/**
+ * Parameters for computing the group of an element.
+ *
+ * @template CustomGroupMatchOptions - Type of custom group match options.
+ */
+interface ComputeGroupParameters<CustomGroupMatchOptions> {
+  /**
+   * Configuration options for grouping.
+   */
+  options: Pick<
+    CommonGroupsOptions<string, unknown, CustomGroupMatchOptions>,
+    'customGroups' | 'groups'
+  >
+  /**
+   * Function to test if an element matches a custom group. Takes a custom
+   * group configuration and returns true if the element matches.
+   */
+  customGroupMatcher: CustomGroupMatcher<CustomGroupMatchOptions>
+  /**
+   * List of predefined groups that the element belongs to. These are checked
+   * after custom groups as a fallback.
+   */
+  predefinedGroups: string[]
+}
+type CustomGroupMatcher<MatchOptions> = (
+  customGroup: AnyOfCustomGroup<MatchOptions> | Partial<MatchOptions>,
+) => boolean
+/**
+ * Determines which group an element belongs to based on custom and predefined
+ * groups.
+ *
+ * The function checks groups in the following priority order:
+ *
+ * 1. Custom groups (if defined) - checked first, highest priority
+ * 2. Predefined groups - checked as fallback
+ * 3. Returns 'unknown' if no matching group is found.
+ *
+ * Only groups that exist in options.groups are considered valid.
+ *
+ * @example
+ *
+ * ```ts
+ * const group = computeGroup({
+ *   options: {
+ *     groups: ['react', 'external', 'internal'],
+ *     customGroups: [{ groupName: 'react', anyOf: ['react', 'react-*'] }],
+ *   },
+ *   customGroupMatcher: customGroup => customGroup.anyOf.includes('react'),
+ *   predefinedGroups: ['external'],
+ *   name: 'react-dom',
+ * })
+ * // Returns: 'react'
+ * ```
+ *
+ * @template CustomGroupMatchOptions - Type of custom group match options.
+ * @param params - Parameters for group computation.
+ * @param params.options - Configuration with available groups and custom
+ *   groups.
+ * @param params.customGroupMatcher - Matcher function for custom groups.
+ * @param params.predefinedGroups - Fallback predefined groups to check.
+ * @returns The matched group name or 'unknown' if no group matches.
+ */
+export declare function computeGroup<CustomGroupMatchOptions>({
+  customGroupMatcher,
+  predefinedGroups,
+  options,
+}: ComputeGroupParameters<CustomGroupMatchOptions>): 'unknown' | string
+export {}