@gaia-harness/lint 0.0.0-stage → 3.0.3

package/dist/configs/react-router.d.ts

@@ -0,0 +1,37 @@
+import type { Linter } from 'eslint';
+/**
+ * React Router flat-config block. Optional, and required only for projects
+ * running React Router in framework mode.
+ *
+ * Its route block is SUBTRACTIVE: it relaxes a rule the rest of the bundle
+ * turns on, rather than adding rules the way `storybook` and `playwright` do. That
+ * is why it ships separately instead of living inside `react`. Its glob,
+ * `**\/routes/**\/*.tsx`, is not unique to React Router (TanStack Router uses
+ * a `routes/` directory too), so folding it into `react` would silently
+ * weaken lint for every file-based router that isn't React Router.
+ *
+ * Spread it after `react`:
+ *
+ *   ...lint.react,
+ *   ...lint.reactRouter,
+ *
+ * `no-empty-pattern` is off because a React Router route module destructures
+ * nothing from its typed props (`({}: Route.ComponentProps)`), which the rule
+ * reads as an empty pattern. TanStack Router names its component
+ * (`createFileRoute(...)({component: Named})`) and never produces that shape,
+ * so a TanStack project wants the rule left on.
+ *
+ * It also carries one ADDITIVE rule, `no-imperative-query-fetch`, on every
+ * TypeScript file under the source dir. It bans `ensureQueryData`,
+ * `fetchQuery`, `prefetchQuery` and their infinite variants, so a route has
+ * one fetch idiom: `queryClient.query` awaited in a clientLoader, read with
+ * `useSuspenseQuery`. That idiom is React Router's, which is why the rule
+ * lives here. It reports on any member call by name, so it needs no TanStack
+ * Query install to fire.
+ *
+ * Route modules, and `root.tsx` (the root route), may also export React
+ * Router's route-module names (`loader`, `action`, `meta`, ...) beside their
+ * component without tripping `react-refresh/only-export-components`.
+ */
+export declare const buildReactRouter: (sourceDir: string) => Linter.Config[];
+//# sourceMappingURL=react-router.d.ts.map

package/dist/configs/react-router.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"react-router.d.ts","sourceRoot":"","sources":["../../src/configs/react-router.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAC,MAAM,EAAC,MAAM,QAAQ,CAAC;AA0BnC;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAiCG;AACH,eAAO,MAAM,gBAAgB,GAAI,WAAW,MAAM,KAAG,MAAM,CAAC,MAAM,EA2BjE,CAAC"}

package/dist/configs/react.d.ts

@@ -0,0 +1,23 @@
+import type { Linter } from 'eslint';
+/**
+ * React flat-config block.
+ *
+ * Ports `reactConfig` + `reactCustomConfig` from GAIA's `eslint.config.mjs`.
+ * Pulls React, React Hooks, and JSX A11y plugins plus Airbnb's recommended
+ * React config, then layers GAIA's project-wide React rule overrides.
+ *
+ * Router-specific relaxations live in the optional `reactRouter` block, not
+ * here, so a project on a different file-based router keeps its full rule set.
+ */
+/**
+ * Options for `react-refresh/only-export-components`, shared with the route
+ * block in `reactRouter`, which repeats them because flat config replaces a
+ * rule's options wholesale. Vite's React plugin keeps state across a hot
+ * update for constant and compound-component exports, so both are allowed.
+ */
+export declare const ONLY_EXPORT_COMPONENTS_OPTIONS: {
+    readonly allowCompoundComponents: true;
+    readonly allowConstantExport: true;
+};
+export declare const react: Linter.Config[];
+//# sourceMappingURL=react.d.ts.map

package/dist/configs/react.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"react.d.ts","sourceRoot":"","sources":["../../src/configs/react.ts"],"names":[],"mappings":"AAIA,OAAO,KAAK,EAAS,MAAM,EAAC,MAAM,QAAQ,CAAC;AAE3C;;;;;;;;;GASG;AACH;;;;;GAKG;AACH,eAAO,MAAM,8BAA8B;;;CAGjC,CAAC;AAEX,eAAO,MAAM,KAAK,EAAE,MAAM,CAAC,MAAM,EA+GhC,CAAC"}

package/dist/configs/restricted-imports.d.ts

@@ -0,0 +1,29 @@
+/**
+ * Shared `no-restricted-imports` path bans.
+ *
+ * Referenced by BOTH the global base config and the testing config. ESLint
+ * flat config replaces a rule's options WHOLESALE across config objects (it
+ * does not merge them), so a later block that re-declares
+ * `no-restricted-imports` — testing.ts scopes one to test/story files — would
+ * otherwise DROP these bans on the files it matches. Both call sites spread
+ * this same const so the ban holds everywhere and stays DRY.
+ *
+ * Uses `paths` (exact specifier match), not `patterns` (glob match): only the
+ * bare `@conform-to/zod` specifier is banned, while the distinct
+ * `@conform-to/zod/v4` specifier stays allowed. A `patterns` entry keyed on
+ * `@conform-to/zod` would wrongly also catch the `/v4` subpath.
+ *
+ * The `react` entry bans only the `FC` and `FunctionComponent` names
+ * (`importNames`); every other `react` import stays allowed. The core rule
+ * reports type-only specifiers, so `import type {FC}` is caught too.
+ */
+export declare const RESTRICTED_IMPORT_PATHS: ({
+    importNames: string[];
+    message: string;
+    name: string;
+} | {
+    message: string;
+    name: string;
+    importNames?: undefined;
+})[];
+//# sourceMappingURL=restricted-imports.d.ts.map

package/dist/configs/restricted-imports.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"restricted-imports.d.ts","sourceRoot":"","sources":["../../src/configs/restricted-imports.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;GAkBG;AACH,eAAO,MAAM,uBAAuB;;;;;;;;IAYnC,CAAC"}

package/dist/configs/shadcn.d.ts

@@ -0,0 +1,59 @@
+import type { Linter } from 'eslint';
+export type GaiaLintShadcnOptions = {
+    /**
+     * Fallback: globs where `shadcn/no-restyle` is off outside the vendored ui
+     * folder (GAIA-owned components that restyle on purpose). The fallback block
+     * always ignores `${sourceDir}/components/ui/**`, so it can never reach the
+     * GAIA-authored `ui/tests/**` files.
+     *
+     * @default []
+     */
+    restyleOffFiles?: string[];
+    /**
+     * Import alias of the vendored ui folder. Written to the root-level
+     * `settings.shadcn.ui`, never to a rule option, so a later Oxlint config
+     * reads it unchanged.
+     *
+     * @default '~/components/ui'
+     */
+    ui?: string;
+    /**
+     * Globs of the vendored files (shadcn registry output kept byte-identical
+     * to `shadcn add`). Never matches `ui/tests/**`.
+     *
+     * @default [`${sourceDir}/components/ui/*.tsx`, ...the registry helpers
+     * shadcn writes outside the ui folder (`VENDORED_HELPER_FILES`)]
+     */
+    uiFiles?: string[];
+};
+/**
+ * `@shadcn/lint` flat-config factory (opt-in).
+ *
+ * Makes role tokens the only color vocabulary for GAIA components and exempts
+ * the vendored shadcn ui files from house style. Returns these blocks:
+ *
+ * - `shadcn/settings`: no `files`; registers the plugin and sets
+ *   `settings.shadcn.ui` at root level.
+ * - `shadcn/rules`: source files; `no-raw-colors`, `require-static-classes`,
+ *   `no-inline-styles` error, `no-restyle` error with `{allow: ['layout']}`,
+ *   `no-arbitrary-values` and `no-unknown-classes` off (better-tailwindcss's
+ *   `no-unknown-classes` stays the only unknown-class rule), and
+ *   `better-tailwindcss/no-restricted-classes` banning arbitrary colors.
+ * - `shadcn/vendored-ui`: `uiFiles` only; `prettier/prettier` and the house
+ *   style rules (plus the maintainer-sanctioned correctness-class rules the
+ *   shadcn source trips) off. `shadcn/no-raw-colors`,
+ *   `react-hooks/rules-of-hooks`, `react-hooks/exhaustive-deps` and every
+ *   other correctness rule stay on.
+ * - `shadcn/restyle-fallback`: only when `restyleOffFiles` is non-empty.
+ *
+ * ORDERING: the vendored-ui block names rules from plugins the other GAIA
+ * blocks register (prettier, prefer-arrow-functions, perfectionist, unicorn,
+ * better-tailwindcss, ...), so spread the full GAIA composition before it, and
+ * spread `shadcn()` LAST, after `...lint.prettier`, so its `prettier/prettier:
+ * off` wins on vendored files.
+ *
+ * @example
+ * ...lint.shadcn({ui: '~/components/ui'})
+ */
+export declare const buildShadcn: (sourceDir: string, opts?: GaiaLintShadcnOptions) => Linter.Config[];
+//# sourceMappingURL=shadcn.d.ts.map

package/dist/configs/shadcn.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"shadcn.d.ts","sourceRoot":"","sources":["../../src/configs/shadcn.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAS,MAAM,EAAC,MAAM,QAAQ,CAAC;AAG3C,MAAM,MAAM,qBAAqB,GAAG;IAClC;;;;;;;OAOG;IACH,eAAe,CAAC,EAAE,MAAM,EAAE,CAAC;IAC3B;;;;;;OAMG;IACH,EAAE,CAAC,EAAE,MAAM,CAAC;IACZ;;;;;;OAMG;IACH,OAAO,CAAC,EAAE,MAAM,EAAE,CAAC;CACpB,CAAC;AAoLF;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA4BG;AACH,eAAO,MAAM,WAAW,GACtB,WAAW,MAAM,EACjB,OAAO,qBAAqB,KAC3B,MAAM,CAAC,MAAM,EA4Df,CAAC"}

package/dist/configs/storybook.d.ts

@@ -0,0 +1,9 @@
+import type { Linter } from 'eslint';
+/**
+ * Storybook flat-config block.
+ *
+ * Ports `storybookConfig` from GAIA's `eslint.config.mjs` — applies the
+ * official `flat/recommended` config from `eslint-plugin-storybook`.
+ */
+export declare const storybook: Linter.Config[];
+//# sourceMappingURL=storybook.d.ts.map

package/dist/configs/storybook.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"storybook.d.ts","sourceRoot":"","sources":["../../src/configs/storybook.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAC,MAAM,EAAC,MAAM,QAAQ,CAAC;AAEnC;;;;;GAKG;AACH,eAAO,MAAM,SAAS,EAAE,MAAM,CAAC,MAAM,EAEpC,CAAC"}

package/dist/configs/style-hygiene.d.ts

@@ -0,0 +1,3 @@
+import type { Linter } from 'eslint';
+export declare const buildStyleHygiene: (sourceDir: string) => Linter.Config[];
+//# sourceMappingURL=style-hygiene.d.ts.map

package/dist/configs/style-hygiene.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"style-hygiene.d.ts","sourceRoot":"","sources":["../../src/configs/style-hygiene.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAC,MAAM,EAAC,MAAM,QAAQ,CAAC;AAmTnC,eAAO,MAAM,iBAAiB,GAAI,WAAW,MAAM,KAAG,MAAM,CAAC,MAAM,EAMlE,CAAC"}

package/dist/configs/testing.d.ts

@@ -0,0 +1,10 @@
+import type { Linter } from 'eslint';
+/**
+ * Testing flat-config block.
+ *
+ * Ports `testHarnessConfig` + `testingLibraryConfig` from GAIA's
+ * `eslint.config.mjs`. Wires up Vitest and jest-dom recommended rules
+ * across test/story/test-harness files.
+ */
+export declare const testing: Linter.Config[];
+//# sourceMappingURL=testing.d.ts.map

package/dist/configs/testing.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"testing.d.ts","sourceRoot":"","sources":["../../src/configs/testing.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAC,MAAM,EAAC,MAAM,QAAQ,CAAC;AAEnC;;;;;;GAMG;AACH,eAAO,MAAM,OAAO,EAAE,MAAM,CAAC,MAAM,EAmIlC,CAAC"}

package/dist/configs/zod.d.ts

@@ -0,0 +1,16 @@
+import type { Linter } from 'eslint';
+/**
+ * Zod flat-config block (opt-in), for Zod 4 projects.
+ *
+ * `eslint-plugin-zod`'s recommended set: conflicting or duplicate checks,
+ * `.optional()` with `.default()`, a `throw` inside `.refine()`, a refine
+ * without an error message (users see a generic "Invalid input"),
+ * `z.nativeEnum`, `z.any()`, and the Zod 3 forms Zod 4 deprecates.
+ *
+ * `consistent-import` is off: it wants `import * as z from 'zod'` by default,
+ * and even in `named` mode it reports a named `ZodError` import. The
+ * stylistic set is not included; it pushes toward enums, which `no-zod-enum`
+ * in `guardrails` bans.
+ */
+export declare const zod: Linter.Config[];
+//# sourceMappingURL=zod.d.ts.map

package/dist/configs/zod.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"zod.d.ts","sourceRoot":"","sources":["../../src/configs/zod.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAS,MAAM,EAAC,MAAM,QAAQ,CAAC;AAE3C;;;;;;;;;;;;GAYG;AACH,eAAO,MAAM,GAAG,EAAE,MAAM,CAAC,MAAM,EAU9B,CAAC"}

package/dist/index.d.ts

@@ -0,0 +1,62 @@
+import type { Linter } from 'eslint';
+import { type GaiaLintBetterTailwindOptions } from './configs/better-tailwind.js';
+import { type GaiaLintIgnoresOptions } from './configs/ignores.js';
+import { type GaiaLintShadcnOptions } from './configs/shadcn.js';
+export type { GaiaLintBetterTailwindOptions, GaiaLintIgnoresOptions, GaiaLintShadcnOptions, };
+export type GaiaLintOptions = {
+    /**
+     * Application source directory (relative to project root). Used to scope
+     * file-path-based rules — filename conventions, hook-folder scoping,
+     * `no-relative-import-paths` root, etc.
+     *
+     * @default 'app'
+     */
+    sourceDir?: string;
+};
+/**
+ * Dual-shape `ignores` accessor. Spread it directly for the default
+ * configuration (`...lint.ignores`) or call it to override
+ * (`...lint.ignores({extra: ['coverage/**']})`).
+ */
+export type GaiaLintIgnores = ((opts?: GaiaLintIgnoresOptions) => Linter.Config[]) & Iterable<Linter.Config>;
+export type GaiaLintBundle = {
+    base: Linter.Config[];
+    betterTailwind: (opts: GaiaLintBetterTailwindOptions) => Linter.Config[];
+    guardrails: Linter.Config[];
+    /**
+     * Opt-in `i18next/no-literal-string` (JSX text only) for projects that
+     * translate their UI. Drop it when the project drops i18n.
+     */
+    i18n: Linter.Config[];
+    ignores: GaiaLintIgnores;
+    playwright: Linter.Config[];
+    prettier: Linter.Config[];
+    react: Linter.Config[];
+    reactRouter: Linter.Config[];
+    /**
+     * Opt-in `@shadcn/lint` token rules plus the vendored-ui exemption. Assumes
+     * the full GAIA composition is spread before it and must be the LAST entry,
+     * after `...lint.prettier`.
+     */
+    shadcn: (opts?: GaiaLintShadcnOptions) => Linter.Config[];
+    storybook: Linter.Config[];
+    styleHygiene: Linter.Config[];
+    testing: Linter.Config[];
+    /** Opt-in `eslint-plugin-zod` recommended rules, for Zod 4 projects. */
+    zod: Linter.Config[];
+};
+/**
+ * GAIA lint configuration factory.
+ *
+ * Call once at the top of your `eslint.config.mjs` to bind a `sourceDir`,
+ * then spread the returned configs into `defineConfig`. Defaults to GAIA's
+ * `'app'` layout; pass `{sourceDir: 'src'}` (or any other value) for
+ * projects that store source elsewhere.
+ *
+ * @example
+ * const lint = gaiaLint();                       // GAIA / app/
+ * const lint = gaiaLint({sourceDir: 'src'});     // src/
+ */
+declare const gaiaLint: (opts?: GaiaLintOptions) => GaiaLintBundle;
+export default gaiaLint;
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAC,MAAM,EAAC,MAAM,QAAQ,CAAC;AAEnC,OAAO,EAEL,KAAK,6BAA6B,EACnC,MAAM,8BAA8B,CAAC;AAGtC,OAAO,EAAU,KAAK,sBAAsB,EAAC,MAAM,sBAAsB,CAAC;AAK1E,OAAO,EAAc,KAAK,qBAAqB,EAAC,MAAM,qBAAqB,CAAC;AAM5E,YAAY,EACV,6BAA6B,EAC7B,sBAAsB,EACtB,qBAAqB,GACtB,CAAC;AAEF,MAAM,MAAM,eAAe,GAAG;IAC5B;;;;;;OAMG;IACH,SAAS,CAAC,EAAE,MAAM,CAAC;CACpB,CAAC;AAEF;;;;GAIG;AACH,MAAM,MAAM,eAAe,GAAG,CAAC,CAC7B,IAAI,CAAC,EAAE,sBAAsB,KAC1B,MAAM,CAAC,MAAM,EAAE,CAAC,GACnB,QAAQ,CAAC,MAAM,CAAC,MAAM,CAAC,CAAC;AAE1B,MAAM,MAAM,cAAc,GAAG;IAC3B,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,CAAC;IACtB,cAAc,EAAE,CAAC,IAAI,EAAE,6BAA6B,KAAK,MAAM,CAAC,MAAM,EAAE,CAAC;IACzE,UAAU,EAAE,MAAM,CAAC,MAAM,EAAE,CAAC;IAC5B;;;OAGG;IACH,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,CAAC;IACtB,OAAO,EAAE,eAAe,CAAC;IACzB,UAAU,EAAE,MAAM,CAAC,MAAM,EAAE,CAAC;IAC5B,QAAQ,EAAE,MAAM,CAAC,MAAM,EAAE,CAAC;IAC1B,KAAK,EAAE,MAAM,CAAC,MAAM,EAAE,CAAC;IACvB,WAAW,EAAE,MAAM,CAAC,MAAM,EAAE,CAAC;IAC7B;;;;OAIG;IACH,MAAM,EAAE,CAAC,IAAI,CAAC,EAAE,qBAAqB,KAAK,MAAM,CAAC,MAAM,EAAE,CAAC;IAC1D,SAAS,EAAE,MAAM,CAAC,MAAM,EAAE,CAAC;IAC3B,YAAY,EAAE,MAAM,CAAC,MAAM,EAAE,CAAC;IAC9B,OAAO,EAAE,MAAM,CAAC,MAAM,EAAE,CAAC;IACzB,wEAAwE;IACxE,GAAG,EAAE,MAAM,CAAC,MAAM,EAAE,CAAC;CACtB,CAAC;AAWF;;;;;;;;;;;GAWG;AACH,QAAA,MAAM,QAAQ,GAAI,OAAO,eAAe,KAAG,cAkB1C,CAAC;AAEF,eAAe,QAAQ,CAAC"}