@ttsc/lint 0.14.0-dev.20260529.1 → 0.14.0

package/lib/structures/rules/ITtscLintStorybookRules.d.ts

@@ -1,34 +1,33 @@
-import type { ITtscLintStorybookNoUninstalledAddonsRuleOptions } from "./ITtscLintStorybookRuleOptions";
 import type { TtscLintRuleOptionsSetting, TtscLintRuleSetting } from "../TtscLintRuleSetting";
+import type { ITtscLintStorybookNoUninstalledAddonsRuleOptions } from "./ITtscLintStorybookRuleOptions";
 /**
- * Storybook CSF and configuration rules from
- * `eslint-plugin-storybook`.
+ * Storybook CSF and configuration rules from `eslint-plugin-storybook`.
  *
- * Checks Component Story Format conventions (default export meta,
- * named story exports, play-function shape) and configuration
- * pitfalls in `.storybook/main.ts`.
+ * Checks Component Story Format conventions (default export meta, named story
+ * exports, play-function shape) and configuration pitfalls in
+ * `.storybook/main.ts`.
  *
  * @reference https://github.com/storybookjs/eslint-plugin-storybook
  */
 export interface ITtscLintStorybookRules {
     /**
-     * Require `await` on Storybook interaction helpers (`userEvent`,
-     * `expect`, `waitFor`, ...) inside a `play` function.
+     * Require `await` on Storybook interaction helpers (`userEvent`, `expect`,
+     * `waitFor`, ...) inside a `play` function.
      *
-     * The interactions addon intercepts the awaited promises to record
-     * steps, so a missing `await` skips that frame in the debugger and
-     * races the next assertion.
+     * The interactions addon intercepts the awaited promises to record steps, so
+     * a missing `await` skips that frame in the debugger and races the next
+     * assertion.
      *
      * @reference https://github.com/storybookjs/eslint-plugin-storybook/blob/main/docs/rules/await-interactions.md
      */
     "storybook/await-interactions"?: TtscLintRuleSetting;
     /**
-     * Require forwarding the play-function `context` argument when
-     * invoking another story's `play` function.
+     * Require forwarding the play-function `context` argument when invoking
+     * another story's `play` function.
      *
-     * Storybook hangs the canvas, step tracker, and interactions addon
-     * off `context`; omitting it leaves the nested call without the
-     * runtime hooks it needs to drive the canvas.
+     * Storybook hangs the canvas, step tracker, and interactions addon off
+     * `context`; omitting it leaves the nested call without the runtime hooks it
+     * needs to drive the canvas.
      *
      * @reference https://github.com/storybookjs/eslint-plugin-storybook/blob/main/docs/rules/context-in-play-function.md
      */
@@ -36,9 +35,8 @@ export interface ITtscLintStorybookRules {
     /**
      * Require the CSF default meta object to declare a `component`.
      *
-     * The reference unlocks Storybook's auto-generated controls,
-     * prop-table docs, and CSF3 default render — without it those
-     * features silently no-op.
+     * The reference unlocks Storybook's auto-generated controls, prop-table docs,
+     * and CSF3 default render — without it those features silently no-op.
      *
      * @reference https://github.com/storybookjs/eslint-plugin-storybook/blob/main/docs/rules/csf-component.md
      */
@@ -46,59 +44,56 @@ export interface ITtscLintStorybookRules {
     /**
      * Require every story file to provide the CSF default export.
      *
-     * Storybook keys all per-file configuration (title, decorators,
-     * parameters, component) off that default; files without it are
-     * skipped at indexing time.
+     * Storybook keys all per-file configuration (title, decorators, parameters,
+     * component) off that default; files without it are skipped at indexing
+     * time.
      *
      * @reference https://github.com/storybookjs/eslint-plugin-storybook/blob/main/docs/rules/default-exports.md
      */
     "storybook/default-exports"?: TtscLintRuleSetting;
     /**
-     * Reject the legacy `|` separator in Storybook story titles
-     * (`"Foo|Bar"`).
+     * Reject the legacy `|` separator in Storybook story titles (`"Foo|Bar"`).
      *
-     * Storybook 6 standardized on `/` for hierarchy and treats `|` as
-     * a literal character, so the title collapses into a single
-     * sidebar entry instead of nested folders.
+     * Storybook 6 standardized on `/` for hierarchy and treats `|` as a literal
+     * character, so the title collapses into a single sidebar entry instead of
+     * nested folders.
      *
      * @reference https://github.com/storybookjs/eslint-plugin-storybook/blob/main/docs/rules/hierarchy-separator.md
      */
     "storybook/hierarchy-separator"?: TtscLintRuleSetting;
     /**
-     * Require `title` and `args` in CSF meta to be inline literals,
-     * not references to outside variables or function calls.
+     * Require `title` and `args` in CSF meta to be inline literals, not
+     * references to outside variables or function calls.
      *
-     * Storybook's indexer and upgrade codemods read these via static
-     * analysis and skip stories where the value is not literal.
+     * Storybook's indexer and upgrade codemods read these via static analysis and
+     * skip stories where the value is not literal.
      *
      * @reference https://github.com/storybookjs/eslint-plugin-storybook/blob/main/docs/rules/meta-inline-properties.md
      */
     "storybook/meta-inline-properties"?: TtscLintRuleSetting;
     /**
-     * Require CSF meta objects to type-check with `satisfies Meta<…>`
-     * rather than a `: Meta<…>` annotation or `as` cast.
+     * Require CSF meta objects to type-check with `satisfies Meta<…>` rather than
+     * a `: Meta<…>` annotation or `as` cast.
      *
-     * `satisfies` preserves the narrowed literal types so dependent
-     * `StoryObj` declarations can infer the component's args
-     * precisely.
+     * `satisfies` preserves the narrowed literal types so dependent `StoryObj`
+     * declarations can infer the component's args precisely.
      *
      * @reference https://github.com/storybookjs/eslint-plugin-storybook/blob/main/docs/rules/meta-satisfies-type.md
      */
     "storybook/meta-satisfies-type"?: TtscLintRuleSetting;
     /**
-     * Reject `name` metadata on a story when it matches Storybook's
-     * auto-derived name from the export identifier.
+     * Reject `name` metadata on a story when it matches Storybook's auto-derived
+     * name from the export identifier.
      *
-     * The explicit value adds boilerplate and drifts from the export
-     * when one side is renamed without the other.
+     * The explicit value adds boilerplate and drifts from the export when one
+     * side is renamed without the other.
      *
      * @reference https://github.com/storybookjs/eslint-plugin-storybook/blob/main/docs/rules/no-redundant-story-name.md
      */
     "storybook/no-redundant-story-name"?: TtscLintRuleSetting;
     /**
-     * Reject direct imports from Storybook renderer packages
-     * (`@storybook/react`, etc.); use the user-facing package
-     * surface.
+     * Reject direct imports from Storybook renderer packages (`@storybook/react`,
+     * etc.); use the user-facing package surface.
      *
      * @reference https://github.com/storybookjs/eslint-plugin-storybook/blob/main/docs/rules/no-renderer-packages.md
      */
@@ -106,27 +101,25 @@ export interface ITtscLintStorybookRules {
     /**
      * Reject the legacy `storiesOf(...)` builder API.
      *
-     * Storybook 7 removed it in favour of CSF default-export metadata;
-     * remaining uses block the migration to CSF3 and the modern
-     * indexer.
+     * Storybook 7 removed it in favour of CSF default-export metadata; remaining
+     * uses block the migration to CSF3 and the modern indexer.
      *
      * @reference https://github.com/storybookjs/eslint-plugin-storybook/blob/main/docs/rules/no-stories-of.md
      */
     "storybook/no-stories-of"?: TtscLintRuleSetting;
     /**
-     * Reject the `title` property in CSF meta when the project uses
-     * Storybook's auto-title generation.
+     * Reject the `title` property in CSF meta when the project uses Storybook's
+     * auto-title generation.
      *
-     * CSF3 derives the title from the file path, so an explicit
-     * `title` is redundant and drifts from the on-disk layout when
-     * files are moved.
+     * CSF3 derives the title from the file path, so an explicit `title` is
+     * redundant and drifts from the on-disk layout when files are moved.
      *
      * @reference https://github.com/storybookjs/eslint-plugin-storybook/blob/main/docs/rules/no-title-property-in-meta.md
      */
     "storybook/no-title-property-in-meta"?: TtscLintRuleSetting;
     /**
-     * Validate Storybook addon names against the project's
-     * dependencies, so misspelled addon ids surface at lint time.
+     * Validate Storybook addon names against the project's dependencies, so
+     * misspelled addon ids surface at lint time.
      *
      * @reference https://github.com/storybookjs/eslint-plugin-storybook/blob/main/docs/rules/no-uninstalled-addons.md
      */
@@ -134,39 +127,37 @@ export interface ITtscLintStorybookRules {
     /**
      * Require named story exports to use PascalCase.
      *
-     * Storybook derives the displayed story name from the export
-     * identifier and inserts spaces at case boundaries, so
-     * non-PascalCase exports render with awkward or merged labels in
-     * the sidebar.
+     * Storybook derives the displayed story name from the export identifier and
+     * inserts spaces at case boundaries, so non-PascalCase exports render with
+     * awkward or merged labels in the sidebar.
      *
      * @reference https://github.com/storybookjs/eslint-plugin-storybook/blob/main/docs/rules/prefer-pascal-case.md
      */
     "storybook/prefer-pascal-case"?: TtscLintRuleSetting;
     /**
-     * Require every story file to export at least one named story
-     * alongside the default meta.
+     * Require every story file to export at least one named story alongside the
+     * default meta.
      *
-     * A file with only the default export contributes nothing to the
-     * sidebar and usually means a story was deleted but the file was
-     * not.
+     * A file with only the default export contributes nothing to the sidebar and
+     * usually means a story was deleted but the file was not.
      *
      * @reference https://github.com/storybookjs/eslint-plugin-storybook/blob/main/docs/rules/story-exports.md
      */
     "storybook/story-exports"?: TtscLintRuleSetting;
     /**
-     * Require `expect` to be imported from `@storybook/test` in play
-     * functions, not from Jest.
+     * Require `expect` to be imported from `@storybook/test` in play functions,
+     * not from Jest.
      *
-     * The Storybook re-export is built for the browser interactions
-     * runner; Jest's `expect` ships only Node-only matchers and throws
-     * when the play function executes in a browser preview.
+     * The Storybook re-export is built for the browser interactions runner;
+     * Jest's `expect` ships only Node-only matchers and throws when the play
+     * function executes in a browser preview.
      *
      * @reference https://github.com/storybookjs/eslint-plugin-storybook/blob/main/docs/rules/use-storybook-expect.md
      */
     "storybook/use-storybook-expect"?: TtscLintRuleSetting;
     /**
-     * Reject direct Testing Library imports inside story files;
-     * use the Storybook-bundled re-exports.
+     * Reject direct Testing Library imports inside story files; use the
+     * Storybook-bundled re-exports.
      *
      * @reference https://github.com/storybookjs/eslint-plugin-storybook/blob/main/docs/rules/use-storybook-testing-library.md
      */

package/lib/structures/rules/ITtscLintTanstackQueryRules.d.ts

@@ -2,40 +2,36 @@ import type { TtscLintRuleSetting } from "../TtscLintRuleSetting";
 /**
  * TanStack Query rules from `@tanstack/eslint-plugin-query`.
  *
- * Guards the ergonomic and correctness contracts of TanStack Query
- * (`useQuery`, `useMutation`, query-options factories) inside React
- * TypeScript sources.
+ * Guards the ergonomic and correctness contracts of TanStack Query (`useQuery`,
+ * `useMutation`, query-options factories) inside React TypeScript sources.
  *
  * @reference https://github.com/TanStack/query/tree/main/packages/eslint-plugin-query
  */
 export interface ITtscLintTanstackQueryRules {
     /**
-     * Require TanStack Query `queryKey` arrays to include every
-     * variable read by the `queryFn` body, mirroring React Hooks
-     * dependency tracking.
+     * Require TanStack Query `queryKey` arrays to include every variable read by
+     * the `queryFn` body, mirroring React Hooks dependency tracking.
      *
      * @reference https://tanstack.com/query/latest/docs/eslint/exhaustive-deps
      */
     "tanstack-query/exhaustive-deps"?: TtscLintRuleSetting;
     /**
-     * Require `queryFn`, `getPreviousPageParam`, and `getNextPageParam`
-     * inside `useInfiniteQuery` to appear in the order TanStack Query
-     * documents.
+     * Require `queryFn`, `getPreviousPageParam`, and `getNextPageParam` inside
+     * `useInfiniteQuery` to appear in the order TanStack Query documents.
      *
-     * Type inference flows through these callbacks in sequence, so a
-     * reordered options object widens the page-param type to
-     * `unknown`.
+     * Type inference flows through these callbacks in sequence, so a reordered
+     * options object widens the page-param type to `unknown`.
      *
      * @reference https://tanstack.com/query/latest/docs/eslint/infinite-query-property-order
      */
     "tanstack-query/infinite-query-property-order"?: TtscLintRuleSetting;
     /**
-     * Require `useMutation` callbacks to declare `onMutate` before
-     * `onError` and `onSettled`.
+     * Require `useMutation` callbacks to declare `onMutate` before `onError` and
+     * `onSettled`.
      *
-     * The options object's type inference threads the `onMutate`
-     * return value into the later callbacks' `context` parameter,
-     * which collapses to `unknown` when the order is wrong.
+     * The options object's type inference threads the `onMutate` return value
+     * into the later callbacks' `context` parameter, which collapses to `unknown`
+     * when the order is wrong.
      *
      * @reference https://tanstack.com/query/latest/docs/eslint/mutation-property-order
      */
@@ -43,21 +39,20 @@ export interface ITtscLintTanstackQueryRules {
     /**
      * Reject `...rest` destructuring on TanStack Query hook results.
      *
-     * The result object is a tracked proxy that only re-renders for
-     * the fields you read; rest-destructuring touches every field,
-     * subscribes the component to all of them, and disables that
-     * optimization.
+     * The result object is a tracked proxy that only re-renders for the fields
+     * you read; rest-destructuring touches every field, subscribes the component
+     * to all of them, and disables that optimization.
      *
      * @reference https://tanstack.com/query/latest/docs/eslint/no-rest-destructuring
      */
     "tanstack-query/no-rest-destructuring"?: TtscLintRuleSetting;
     /**
-     * Reject passing entire TanStack Query hook results into React
-     * dependency arrays.
+     * Reject passing entire TanStack Query hook results into React dependency
+     * arrays.
      *
-     * The returned object is a fresh reference on every render, so
-     * `useEffect` / `useMemo` / `useCallback` would re-run
-     * unconditionally; depend on the specific fields you read instead.
+     * The returned object is a fresh reference on every render, so `useEffect` /
+     * `useMemo` / `useCallback` would re-run unconditionally; depend on the
+     * specific fields you read instead.
      *
      * @reference https://tanstack.com/query/latest/docs/eslint/no-unstable-deps
      */
@@ -65,28 +60,27 @@ export interface ITtscLintTanstackQueryRules {
     /**
      * Reject `queryFn` callbacks that resolve to `void`.
      *
-     * The return value is what TanStack Query caches and exposes as
-     * `data`; a void implementation always populates the cache with
-     * `undefined` and almost always indicates a forgotten `return`.
+     * The return value is what TanStack Query caches and exposes as `data`; a
+     * void implementation always populates the cache with `undefined` and almost
+     * always indicates a forgotten `return`.
      *
      * @reference https://tanstack.com/query/latest/docs/eslint/no-void-query-fn
      */
     "tanstack-query/no-void-query-fn"?: TtscLintRuleSetting;
     /**
-     * Prefer wrapping query options in the `queryOptions()` helper
-     * over inline `{ queryKey, queryFn }` literals.
+     * Prefer wrapping query options in the `queryOptions()` helper over inline `{
+     * queryKey, queryFn }` literals.
      *
-     * The helper co-locates key and fetcher, lets
-     * `queryClient.getQueryData` and `setQueryData` share the same
-     * typed key, and prevents the same key being paired with two
-     * different `queryFn`s.
+     * The helper co-locates key and fetcher, lets `queryClient.getQueryData` and
+     * `setQueryData` share the same typed key, and prevents the same key being
+     * paired with two different `queryFn`s.
      *
      * @reference https://tanstack.com/query/latest/docs/eslint/prefer-query-options
      */
     "tanstack-query/prefer-query-options"?: TtscLintRuleSetting;
     /**
-     * Reject creating a `QueryClient` inside a React component or
-     * hook body — the client must be stable across renders.
+     * Reject creating a `QueryClient` inside a React component or hook body — the
+     * client must be stable across renders.
      *
      * @reference https://tanstack.com/query/latest/docs/eslint/stable-query-client
      */

package/lib/structures/rules/ITtscLintTestingLibraryRuleOptions.d.ts

@@ -8,9 +8,8 @@
 /** `testing-library/consistent-data-testid` rule options. */
 export interface ITtscLintTestingLibraryConsistentDataTestIdRuleOptions {
     /**
-     * Regular expression string every configured test-id attribute value
-     * must match. `{fileName}` is replaced with the basename before the
-     * first dot.
+     * Regular expression string every configured test-id attribute value must
+     * match. `{fileName}` is replaced with the basename before the first dot.
      */
     testIdPattern: string;
     /**