@ttsc/lint 0.14.0-dev.20260529.2 → 0.14.0

package/src/structures/rules/ITtscLintStorybookRules.ts

@@ -1,39 +1,38 @@
-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
    */
@@ -42,9 +41,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
    */
@@ -53,64 +51,61 @@ 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
    */
@@ -119,29 +114,27 @@ 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
    */
@@ -150,42 +143,40 @@ 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/src/structures/rules/ITtscLintTanstackQueryRules.ts

@@ -3,42 +3,38 @@ 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
    */
@@ -47,22 +43,21 @@ 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
    */
@@ -71,30 +66,29 @@ 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/src/structures/rules/ITtscLintTestingLibraryRuleOptions.ts

@@ -9,9 +9,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;