@ttsc/lint 0.14.0-dev.20260529.2 → 0.14.1

package/src/structures/rules/ITtscLintPromiseRules.ts

@@ -3,68 +3,64 @@ import type { TtscLintRuleSetting } from "../TtscLintRuleSetting";
 /**
  * Promise correctness and style rules from `eslint-plugin-promise`.
  *
- * Checks the chain shape of Promise-using code: every chain ends
- * with `catch`, no callback inside a `then`, no nested
- * `.then().then()`, and so on.
+ * Checks the chain shape of Promise-using code: every chain ends with `catch`,
+ * no callback inside a `then`, no nested `.then().then()`, and so on.
  *
- * AST-local only — type-aware Promise checks belong with
- * `typescript/*` checker rules.
+ * AST-local only — type-aware Promise checks belong with `typescript/*` checker
+ * rules.
  *
  * @reference https://github.com/eslint-community/eslint-plugin-promise
  */
 export interface ITtscLintPromiseRules {
   /**
-   * Require every `then()` callback to either `return` a value or
-   * `throw`.
+   * Require every `then()` callback to either `return` a value or `throw`.
    *
-   * A callback that does neither breaks the chain by returning
-   * `undefined`.
+   * A callback that does neither breaks the chain by returning `undefined`.
    *
    * @reference https://github.com/eslint-community/eslint-plugin-promise/blob/main/docs/rules/always-return.md
    */
   "promise/always-return"?: TtscLintRuleSetting;
 
   /**
-   * Reject every `new Promise(...)` construction. Most modern code
-   * can use `async`/`await` or existing Promise-returning APIs.
+   * Reject every `new Promise(...)` construction. Most modern code can use
+   * `async`/`await` or existing Promise-returning APIs.
    *
    * @reference https://github.com/eslint-community/eslint-plugin-promise/blob/main/docs/rules/avoid-new.md
    */
   "promise/avoid-new"?: TtscLintRuleSetting;
 
   /**
-   * Require unreturned promise chains to terminate with `catch()`
-   * so unhandled rejections cannot escape.
+   * Require unreturned promise chains to terminate with `catch()` so unhandled
+   * rejections cannot escape.
    *
    * @reference https://github.com/eslint-community/eslint-plugin-promise/blob/main/docs/rules/catch-or-return.md
    */
   "promise/catch-or-return"?: TtscLintRuleSetting;
 
   /**
-   * Reject direct invocation of an error-first callback inside a
-   * `then()` or `catch()` handler.
+   * Reject direct invocation of an error-first callback inside a `then()` or
+   * `catch()` handler.
    *
-   * Synchronously calling the callback from a promise handler can
-   * re-enter it on both the fulfilled and rejected paths. Upstream
-   * guidance: defer via `setImmediate`/`process.nextTick` if a
-   * callback bridge is genuinely required.
+   * Synchronously calling the callback from a promise handler can re-enter it
+   * on both the fulfilled and rejected paths. Upstream guidance: defer via
+   * `setImmediate`/`process.nextTick` if a callback bridge is genuinely
+   * required.
    *
-   * Also flags `.then(callback)` / `.catch(callback)` calls whose
-   * handler argument is a bare callback-shaped identifier
-   * (`callback`, `cb`, `next`, `done`).
+   * Also flags `.then(callback)` / `.catch(callback)` calls whose handler
+   * argument is a bare callback-shaped identifier (`callback`, `cb`, `next`,
+   * `done`).
    *
    * @reference https://github.com/eslint-community/eslint-plugin-promise/blob/main/docs/rules/no-callback-in-promise.md
    */
   "promise/no-callback-in-promise"?: TtscLintRuleSetting;
 
   /**
-   * Detect Promise executor bodies with more than one resolve/reject
-   * call. The native rule does not yet model branch exclusivity —
-   * bodies whose calls are split across mutually exclusive branches
-   * will be flagged too.
+   * Detect Promise executor bodies with more than one resolve/reject call. The
+   * native rule does not yet model branch exclusivity — bodies whose calls are
+   * split across mutually exclusive branches will be flagged too.
    *
-   * The second call is silently ignored, but the surrounding logic
-   * almost always assumed short-circuit.
+   * The second call is silently ignored, but the surrounding logic almost
+   * always assumed short-circuit.
    *
    * @reference https://github.com/eslint-community/eslint-plugin-promise/blob/main/docs/rules/no-multiple-resolved.md
    */
@@ -74,40 +70,38 @@ export interface ITtscLintPromiseRules {
    * Require every file that uses `Promise` to import or require the
    * implementation explicitly, instead of reaching the native global.
    *
-   * Useful for projects that substitute Bluebird or another library
-   * and want the choice grep-visible per file.
+   * Useful for projects that substitute Bluebird or another library and want
+   * the choice grep-visible per file.
    *
    * @reference https://github.com/eslint-community/eslint-plugin-promise/blob/main/docs/rules/no-native.md
    */
   "promise/no-native"?: TtscLintRuleSetting;
 
   /**
-   * Reject nested `then()`/`catch()` calls inside the body of a
-   * Promise callback. Use chained `.then()` instead.
+   * Reject nested `then()`/`catch()` calls inside the body of a Promise
+   * callback. Use chained `.then()` instead.
    *
    * @reference https://github.com/eslint-community/eslint-plugin-promise/blob/main/docs/rules/no-nesting.md
    */
   "promise/no-nesting"?: TtscLintRuleSetting;
 
   /**
-   * Reject `new` applied to Promise statics such as
-   * `new Promise.resolve(x)`, `new Promise.all([...])`, or
-   * `new Promise.race([...])`.
+   * Reject `new` applied to Promise statics such as `new Promise.resolve(x)`,
+   * `new Promise.all([...])`, or `new Promise.race([...])`.
    *
-   * The statics are plain functions, so `new` throws a `TypeError`
-   * at runtime — caught here before the call ships.
+   * The statics are plain functions, so `new` throws a `TypeError` at runtime —
+   * caught here before the call ships.
    *
    * @reference https://github.com/eslint-community/eslint-plugin-promise/blob/main/docs/rules/no-new-statics.md
    */
   "promise/no-new-statics"?: TtscLintRuleSetting;
 
   /**
-   * Reject building a promise chain inside the body of an
-   * error-first callback.
+   * Reject building a promise chain inside the body of an error-first callback.
    *
    * The callback already owns an error channel, so layering
-   * `.then()`/`.catch()` on top creates two incompatible failure
-   * pipelines. Upstream advice: promisify the outer API instead.
+   * `.then()`/`.catch()` on top creates two incompatible failure pipelines.
+   * Upstream advice: promisify the outer API instead.
    *
    * @reference https://github.com/eslint-community/eslint-plugin-promise/blob/main/docs/rules/no-promise-in-callback.md
    */
@@ -116,64 +110,62 @@ export interface ITtscLintPromiseRules {
   /**
    * Reject `return` from inside a `finally()` callback.
    *
-   * The chain's resolved value comes from the prior `then`/`catch`,
-   * so any value returned from `finally` is discarded — usually
-   * signals confusion about where the chain's value comes from.
+   * The chain's resolved value comes from the prior `then`/`catch`, so any
+   * value returned from `finally` is discarded — usually signals confusion
+   * about where the chain's value comes from.
    *
    * @reference https://github.com/eslint-community/eslint-plugin-promise/blob/main/docs/rules/no-return-in-finally.md
    */
   "promise/no-return-in-finally"?: TtscLintRuleSetting;
 
   /**
-   * Reject `return Promise.resolve(x)` and `return
-   * Promise.reject(x)` inside promise callbacks; return the bare
-   * value or `throw` instead.
+   * Reject `return Promise.resolve(x)` and `return Promise.reject(x)` inside
+   * promise callbacks; return the bare value or `throw` instead.
    *
    * @reference https://github.com/eslint-community/eslint-plugin-promise/blob/main/docs/rules/no-return-wrap.md
    */
   "promise/no-return-wrap"?: TtscLintRuleSetting;
 
   /**
-   * Enforce canonical parameter names (`resolve`, `reject`) on
-   * Promise executor functions.
+   * Enforce canonical parameter names (`resolve`, `reject`) on Promise executor
+   * functions.
    *
-   * Consistent names make executor bodies greppable and prevent
-   * accidental shadowing of the outer `resolve` symbol.
+   * Consistent names make executor bodies greppable and prevent accidental
+   * shadowing of the outer `resolve` symbol.
    *
    * @reference https://github.com/eslint-community/eslint-plugin-promise/blob/main/docs/rules/param-names.md
    */
   "promise/param-names"?: TtscLintRuleSetting;
 
   /**
-   * Flag continuation-passing callback shapes (last parameter is a
-   * function and an error-first invocation pattern is detected),
-   * suggesting an `async`/`await` rewrite.
+   * Flag continuation-passing callback shapes (last parameter is a function and
+   * an error-first invocation pattern is detected), suggesting an
+   * `async`/`await` rewrite.
    *
-   * Intended for codebases that have already migrated their I/O
-   * surface to promises and want to keep callers consistent.
+   * Intended for codebases that have already migrated their I/O surface to
+   * promises and want to keep callers consistent.
    *
    * @reference https://github.com/eslint-community/eslint-plugin-promise/blob/main/docs/rules/prefer-await-to-callbacks.md
    */
   "promise/prefer-await-to-callbacks"?: TtscLintRuleSetting;
 
   /**
-   * Prefer `await` over explicit `.then()`/`.catch()`/`.finally()`
-   * chains inside `async` functions.
+   * Prefer `await` over explicit `.then()`/`.catch()`/`.finally()` chains
+   * inside `async` functions.
    *
-   * Sequential awaits compose more naturally with try/catch and
-   * avoid the indentation creep of deeply nested handlers.
+   * Sequential awaits compose more naturally with try/catch and avoid the
+   * indentation creep of deeply nested handlers.
    *
    * @reference https://github.com/eslint-community/eslint-plugin-promise/blob/main/docs/rules/prefer-await-to-then.md
    */
   "promise/prefer-await-to-then"?: TtscLintRuleSetting;
 
   /**
-   * Prefer `.catch(handler)` over the two-argument form
-   * `.then(onFulfilled, onRejected)`.
+   * Prefer `.catch(handler)` over the two-argument form `.then(onFulfilled,
+   * onRejected)`.
    *
-   * The two-argument shape skips rejections raised inside
-   * `onFulfilled`, which surprises readers and hides errors from
-   * logging middleware.
+   * The two-argument shape skips rejections raised inside `onFulfilled`, which
+   * surprises readers and hides errors from logging middleware.
    *
    * @reference https://github.com/eslint-community/eslint-plugin-promise/blob/main/docs/rules/prefer-catch.md
    */
@@ -181,8 +173,7 @@ export interface ITtscLintPromiseRules {
 
   /**
    * Reject non-standard `Promise` statics such as `Promise.done`,
-   * `Promise.spread`, or library-specific extensions shimmed onto
-   * the global.
+   * `Promise.spread`, or library-specific extensions shimmed onto the global.
    *
    * Sticking to spec methods keeps code portable across Promise
    * implementations.
@@ -192,10 +183,10 @@ export interface ITtscLintPromiseRules {
   "promise/spec-only"?: TtscLintRuleSetting;
 
   /**
-   * Enforce the argument counts the Promise spec defines for each
-   * method — `Promise.all`/`Promise.race` take exactly one argument,
-   * `Promise.resolve`/`Promise.reject` take zero or one, `.then`
-   * takes one or two, `.catch`/`.finally` take exactly one.
+   * Enforce the argument counts the Promise spec defines for each method —
+   * `Promise.all`/`Promise.race` take exactly one argument,
+   * `Promise.resolve`/`Promise.reject` take zero or one, `.then` takes one or
+   * two, `.catch`/`.finally` take exactly one.
    *
    * Extra or missing arguments usually indicate a misread of the API.
    *

package/src/structures/rules/ITtscLintReactPerfRuleOptions.ts

@@ -9,11 +9,11 @@ export interface ITtscLintReactPerfRuleOptions {
   /**
    * Controls which intrinsic JSX element props are ignored.
    *
-   * `"all"` ignores every prop on lowercase / native elements such as
-   * `div`. An array ignores only those prop names on native elements,
-   * for example `["style"]`. Custom components are still checked.
+   * `"all"` ignores every prop on lowercase / native elements such as `div`. An
+   * array ignores only those prop names on native elements, for example
+   * `["style"]`. Custom components are still checked.
    *
-   * @default [] (native props are checked)
+   * @default [ ] (native props are checked)
    */
   nativeAllowList?: "all" | readonly string[];
 }

package/src/structures/rules/ITtscLintReactPerfRules.ts

@@ -1,34 +1,32 @@
-import type { ITtscLintReactPerfRuleOptions } from "./ITtscLintReactPerfRuleOptions";
 import type { TtscLintRuleOptionsSetting } from "../TtscLintRuleSetting";
+import type { ITtscLintReactPerfRuleOptions } from "./ITtscLintReactPerfRuleOptions";
 
 /**
  * React JSX performance rules from `eslint-plugin-react-perf`.
  *
- * Detects freshly-allocated reference values (arrays, objects,
- * functions, JSX elements) passed as JSX props. A new reference
- * invalidates `React.memo` / `useMemo` shallow checks on every
- * render. Useful for performance-critical render paths; usually
- * unnecessary for top-level pages.
+ * Detects freshly-allocated reference values (arrays, objects, functions, JSX
+ * elements) passed as JSX props. A new reference invalidates `React.memo` /
+ * `useMemo` shallow checks on every render. Useful for performance-critical
+ * render paths; usually unnecessary for top-level pages.
  *
- * Diagnostics only fire on `.tsx` source files — JSX heuristics rely
- * on the file extension, so `.ts` files are skipped even when they
- * contain JSX-like syntax.
+ * Diagnostics only fire on `.tsx` source files — JSX heuristics rely on the
+ * file extension, so `.ts` files are skipped even when they contain JSX-like
+ * syntax.
  *
  * @reference https://github.com/cvazac/eslint-plugin-react-perf
  */
 export interface ITtscLintReactPerfRules {
   /**
-   * Reject array literals (`[...]`) passed inline as a JSX prop.
-   * Hoist the array outside the render or stabilize it with
-   * `useMemo`.
+   * Reject array literals (`[...]`) passed inline as a JSX prop. Hoist the
+   * array outside the render or stabilize it with `useMemo`.
    *
    * @reference https://github.com/cvazac/eslint-plugin-react-perf/blob/master/docs/rules/jsx-no-new-array-as-prop.md
    */
   "react-perf/jsx-no-new-array-as-prop"?: TtscLintRuleOptionsSetting<ITtscLintReactPerfRuleOptions>;
 
   /**
-   * Reject inline `function` expressions / arrow functions passed
-   * as a JSX prop. Stabilize with `useCallback`.
+   * Reject inline `function` expressions / arrow functions passed as a JSX
+   * prop. Stabilize with `useCallback`.
    *
    * @reference https://github.com/cvazac/eslint-plugin-react-perf/blob/master/docs/rules/jsx-no-new-function-as-prop.md
    */
@@ -37,17 +35,17 @@ export interface ITtscLintReactPerfRules {
   /**
    * Reject inline object literals (`{...}`) passed as a JSX prop.
    *
-   * A fresh object on every render invalidates the shallow-equal
-   * check used by `React.memo` and `useMemo` consumers, so any
-   * downstream memoization keyed on that prop is wasted.
+   * A fresh object on every render invalidates the shallow-equal check used by
+   * `React.memo` and `useMemo` consumers, so any downstream memoization keyed
+   * on that prop is wasted.
    *
    * @reference https://github.com/cvazac/eslint-plugin-react-perf/blob/master/docs/rules/jsx-no-new-object-as-prop.md
    */
   "react-perf/jsx-no-new-object-as-prop"?: TtscLintRuleOptionsSetting<ITtscLintReactPerfRuleOptions>;
 
   /**
-   * Reject JSX expressions and fragments passed as a JSX prop —
-   * each evaluation creates a new React element.
+   * Reject JSX expressions and fragments passed as a JSX prop — each evaluation
+   * creates a new React element.
    *
    * @reference https://github.com/cvazac/eslint-plugin-react-perf/blob/master/docs/rules/jsx-no-jsx-as-prop.md
    */

package/src/structures/rules/ITtscLintReactRuleOptions.ts

@@ -1,6 +1,5 @@
 /**
- * Options shapes for the configurable rules in
- * {@link ITtscLintReactRules}.
+ * Options shapes for the configurable rules in {@link ITtscLintReactRules}.
  *
  * Currently only `react/only-export-components` (from
  * `eslint-plugin-react-refresh`) accepts options.
@@ -13,29 +12,28 @@ export interface ITtscLintReactOnlyExportComponentsRuleOptions {
   /**
    * Extra higher-order component names that wrap component exports.
    *
-   * @default []
+   * @default [ ]
    */
   extraHOCs?: readonly string[];
 
   /**
-   * Export names the active framework handles during refresh, such as
-   * route metadata exports.
+   * Export names the active framework handles during refresh, such as route
+   * metadata exports.
    *
-   * @default []
+   * @default [ ]
    */
   allowExportNames?: readonly string[];
 
   /**
-   * Permit literal / string / boolean / template / binary constant
-   * exports alongside component exports.
+   * Permit literal / string / boolean / template / binary constant exports
+   * alongside component exports.
    *
    * @default false
    */
   allowConstantExport?: boolean;
 
   /**
-   * Also scan JavaScript files that import React. TSX files are always
-   * scanned.
+   * Also scan JavaScript files that import React. TSX files are always scanned.
    *
    * @default false
    */