@ttsc/lint 0.11.0 → 0.12.0

package/lib/structures/TtscLintConfigEntry.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"TtscLintConfigEntry.js","sourceRoot":"","sources":["../../src/structures/TtscLintConfigEntry.ts"],"names":[],"mappings":""}

package/lib/structures/TtscLintFormatConfig.js

@@ -1,3 +0,0 @@
-"use strict";
-Object.defineProperty(exports, "__esModule", { value: true });
-//# sourceMappingURL=TtscLintFormatConfig.js.map

package/lib/structures/TtscLintFormatConfig.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"TtscLintFormatConfig.js","sourceRoot":"","sources":["../../src/structures/TtscLintFormatConfig.ts"],"names":[],"mappings":""}

package/lib/structures/TtscLintPlugins.d.ts

@@ -1,9 +0,0 @@
-import type { ITtscLintPlugin } from "./ITtscLintPlugin";
-/**
- * Map of contributor plugins, keyed by their namespace prefix.
- *
- * The key (e.g. `"import"`) is what `@ttsc/lint`'s rule-name union joins with
- * each plugin's exported `rules` tuple (`"no-cycle"`) to produce the namespaced
- * rule names a user writes in `rules` (`"import/no-cycle"`).
- */
-export type TtscLintPlugins = Record<string, ITtscLintPlugin>;

package/lib/structures/TtscLintPlugins.js

@@ -1,3 +0,0 @@
-"use strict";
-Object.defineProperty(exports, "__esModule", { value: true });
-//# sourceMappingURL=TtscLintPlugins.js.map

package/lib/structures/TtscLintPlugins.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"TtscLintPlugins.js","sourceRoot":"","sources":["../../src/structures/TtscLintPlugins.ts"],"names":[],"mappings":""}

package/lib/structures/TtscLintRuleEntry.d.ts

@@ -1,22 +0,0 @@
-import type { TtscLintRuleOptionsMap } from "./TtscLintRuleOptions";
-import type { TtscLintSeverity } from "./TtscLintSeverity";
-/**
- * One rule's configuration entry.
- *
- * Accepts either a bare severity literal or a `[severity, options]` tuple. The
- * options slot's type is _picked per rule name_ via `TtscLintRuleOptionsMap` —
- * so a user writing
- *
- *     "format/sort-imports": ["error", { importOrder: [...] }]
- *
- * Inside `TtscLintRuleMap` gets exact autocomplete and typo detection on the
- * options object. The rule name is the object key; the `[severity, options]`
- * tuple is the value.
- *
- * Rules that do not appear in `TtscLintRuleOptionsMap` accept only the severity
- * literal (or the bare `[severity]` tuple): the conditional arm collapses to
- * `never`, removing the options-tuple branch from the union for those rules.
- * This keeps `no-var` and friends from silently accepting unrecognized option
- * blobs.
- */
-export type TtscLintRuleEntry<R extends string = string> = TtscLintSeverity | readonly [TtscLintSeverity] | (R extends keyof TtscLintRuleOptionsMap ? readonly [TtscLintSeverity, TtscLintRuleOptionsMap[R]] : never);

package/lib/structures/TtscLintRuleEntry.js

@@ -1,3 +0,0 @@
-"use strict";
-Object.defineProperty(exports, "__esModule", { value: true });
-//# sourceMappingURL=TtscLintRuleEntry.js.map

package/lib/structures/TtscLintRuleEntry.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"TtscLintRuleEntry.js","sourceRoot":"","sources":["../../src/structures/TtscLintRuleEntry.ts"],"names":[],"mappings":""}

package/lib/structures/defaultFormat.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"defaultFormat.js","sourceRoot":"","sources":["../../src/structures/defaultFormat.ts"],"names":[],"mappings":";;;AAEA;;;;;;;;;;;;;;;;;;;;GAoBG;AACU,QAAA,aAAa,GAAG,MAAM,CAAC,MAAM,CAAC;IACzC,QAAQ,EAAE,SAAS;IACnB,IAAI,EAAE,IAAI;IACV,WAAW,EAAE,KAAK;IAClB,aAAa,EAAE,KAAK;IACpB,UAAU,EAAE,EAAE;IACd,QAAQ,EAAE,CAAC;IACX,OAAO,EAAE,KAAK;IACd,SAAS,EAAE,IAAI;CACe,CAAC,CAAC"}

package/src/defineConfig.ts

@@ -1,69 +0,0 @@
-import type { TtscLintConfig } from "./structures/TtscLintConfig";
-import type { TtscLintPlugins } from "./structures/TtscLintPlugins";
-
-/**
- * Authoring helper that preserves the literal type of a lint config.
- *
- * ESLint's flat-config experience relies on `defineConfig` to capture the
- * const-narrowed type of the configuration array, which is what makes plugin
- * rule names autocomplete across entries. `@ttsc/lint` follows the same
- * pattern: pass your config through this helper and the contributor plugin
- * objects in `plugins` propagate their `rules` tuples into the rule-name
- * union.
- *
- * ```ts
- * import { defineConfig } from "@ttsc/lint";
- * import importPlugin from "@ttsc/lint-plugin-import";
- *
- * export default defineConfig([
- *   {
- *     plugins: { import: importPlugin },
- *     rules: {
- *       "no-var": "error",
- *       "import/no-cycle": ["error", { maxDepth: 1 }],
- *     },
- *   },
- * ]);
- * ```
- *
- * The function is a pure pass-through at runtime. The generic gymnastics below
- * gather every `plugins` map across the array of config entries into one
- * intersected `TtscLintPlugins` shape that gets threaded back into the
- * `TtscLintConfig<P>` constraint. Without this, `TtscLintConfig`'s default `P =
- * Record<string, never>` rules out every namespaced rule name and `{
- * "import/no-cycle": "error" }` would be flagged as a typo.
- */
-export function defineConfig<const T extends TtscLintConfig<GatherPlugins<T>>>(
-  config: T,
-): T {
-  return config;
-}
-
-/**
- * Walks the input type to collect every plugin map declared across entries.
- * Single entries yield the entry's `plugins`; arrays intersect every entry's
- * `plugins` so each entry's rule-name union remains valid for the whole array.
- * The intersection (vs. union) is load-bearing — TypeScript's `keyof (A | B)`
- * collapses to `never`, which would reject every namespaced rule name.
- *
- * Plugins declared exclusively inside an `extends` chain are NOT collected:
- * recursing into `T extends { extends?: infer E } ? GatherPlugins<E> : {}`
- * blows TypeScript's instantiation budget (`extends` is itself a
- * `TtscLintConfigEntry` tree). Authors should declare each plugin's `plugins`
- * map on the outermost entry where its rules are configured. The runtime
- * resolver still picks up plugins from `extends` entries; only the autocomplete
- * domain is bounded.
- */
-type GatherPlugins<T> = T extends { plugins?: infer P }
-  ? P extends TtscLintPlugins
-    ? P
-    : {}
-  : T extends readonly (infer Item)[]
-    ? UnionToIntersection<Item extends unknown ? GatherPlugins<Item> : never>
-    : {};
-
-type UnionToIntersection<U> = (
-  U extends unknown ? (x: U) => void : never
-) extends (x: infer I) => void
-  ? I
-  : never;

package/src/structures/PluginRuleNames.ts

@@ -1,19 +0,0 @@
-import type { TtscLintPlugins } from "./TtscLintPlugins";
-
-/**
- * Builds the union of `${namespace}/${rule}` strings from a plugins map.
- *
- * Each plugin's `rules` tuple is read literally: an `as const` tuple
- * (`["no-cycle", "order"] as const`) provides exact autocomplete, while a plain
- * `string[]` collapses to `${namespace}/${string}` and disables rule-level typo
- * detection for that namespace.
- */
-export type PluginRuleNames<P extends TtscLintPlugins> = {
-  [Ns in keyof P]: P[Ns] extends { rules?: infer R }
-    ? R extends readonly (infer N)[]
-      ? N extends string
-        ? `${Ns & string}/${N}`
-        : never
-      : never
-    : never;
-}[keyof P];

package/src/structures/TtscLintConfig.ts

@@ -1,31 +0,0 @@
-import type { TtscLintConfigEntry } from "./TtscLintConfigEntry";
-import type { TtscLintPlugins } from "./TtscLintPlugins";
-import type { TtscLintRuleMap } from "./TtscLintRuleMap";
-
-/**
- * Top-level config accepted by `@ttsc/lint`.
- *
- * Three accepted forms, listed in expected order of preference:
- *
- * 1. **Flat-config array** — mirrors ESLint flat config exactly. Each entry can
- *    scope by `files` / `ignores`, declare a `plugins` map of contributors,
- *    configure `rules`, and configure formatting through the Prettier-style
- *    {@link TtscLintFormatConfig | `format`} block. Multiple entries layer in
- *    order.
- * 2. **Single config object** — same shape as one flat-config entry. Useful when
- *    the project has no per-file scoping. Pass `format: { … }` here for the
- *    smallest "describe my style" config.
- * 3. **Rules-only map** — historical shape kept for backward compat with
- *    single-file projects. `{"no-var":"error"}` is interpreted as `[{rules:
- *    {"no-var":"error"}}]`. The shorthand intentionally has no slot for the
- *    `format` block — use form (1) or (2) to enable formatting.
- *
- * The generic parameter `P` lets `defineConfig` capture the literal plugin
- * object types declared in `plugins`. When non-empty, rule-name keys
- * autocomplete as `BuiltInRule | "<ns>/<rule>"` where the namespace-rule
- * combinations come from each plugin's `rules` tuple.
- */
-export type TtscLintConfig<P extends TtscLintPlugins = Record<string, never>> =
-  | TtscLintRuleMap<P>
-  | TtscLintConfigEntry<P>
-  | readonly TtscLintConfigEntry<P>[];

package/src/structures/TtscLintConfigEntry.ts

@@ -1,50 +0,0 @@
-import type { TtscLintFormatConfig } from "./TtscLintFormatConfig";
-import type { TtscLintPlugins } from "./TtscLintPlugins";
-import type { TtscLintRuleMap } from "./TtscLintRuleMap";
-
-/**
- * One flat-config entry. ESLint-style `files` / `ignores` glob scoping, a
- * `plugins` namespace map of contributor plugin objects, an `extends` list of
- * child entries to fold in first, and a severity-keyed `rules` map applied
- * after the extends chain.
- *
- * Prettier-style formatting opts in through a sibling `format` block — see
- * `TtscLintFormatConfig`. The block can scope per-entry (e.g. wider
- * `printWidth` for `legacy/**`) just like `rules` does.
- */
-export interface TtscLintConfigEntry<
-  P extends TtscLintPlugins = Record<string, never>,
-> {
-  /** Globs that select the files this entry applies to. */
-  files?: string | readonly string[];
-
-  /** Globs that exclude files this entry would otherwise match. */
-  ignores?: string | readonly string[];
-
-  /**
-   * Nested entries (or arrays of entries) folded in before this entry's own
-   * rules apply. Mirrors ESLint flat config's `extends`: each child's rules
-   * layer first, with `this.rules` taking precedence on key collisions.
-   */
-  extends?:
-    | TtscLintConfigEntry<P>
-    | readonly TtscLintConfigEntry<P>[]
-    | readonly (TtscLintConfigEntry<P> | readonly TtscLintConfigEntry<P>[])[];
-
-  /**
-   * Contributor plugin objects keyed by namespace. Each value is the default
-   * export of a `@ttsc/lint` contributor package (an `ITtscLintPlugin`).
-   */
-  plugins?: P;
-
-  /** Rule-name → severity map. Supports severity tuples with options. */
-  rules?: TtscLintRuleMap<P>;
-
-  /**
-   * Prettier-style flat configuration for the `format/*` rules. Presence
-   * (even an empty `format: {}`) enables format-class rules at Prettier
-   * defaults; absence keeps them all off. Per-rule overrides go through
-   * the `rules` map — the `rules` entry wins on conflict.
-   */
-  format?: TtscLintFormatConfig;
-}

package/src/structures/TtscLintPlugins.ts

@@ -1,10 +0,0 @@
-import type { ITtscLintPlugin } from "./ITtscLintPlugin";
-
-/**
- * Map of contributor plugins, keyed by their namespace prefix.
- *
- * The key (e.g. `"import"`) is what `@ttsc/lint`'s rule-name union joins with
- * each plugin's exported `rules` tuple (`"no-cycle"`) to produce the namespaced
- * rule names a user writes in `rules` (`"import/no-cycle"`).
- */
-export type TtscLintPlugins = Record<string, ITtscLintPlugin>;

package/src/structures/TtscLintRuleEntry.ts

@@ -1,28 +0,0 @@
-import type { TtscLintRuleOptionsMap } from "./TtscLintRuleOptions";
-import type { TtscLintSeverity } from "./TtscLintSeverity";
-
-/**
- * One rule's configuration entry.
- *
- * Accepts either a bare severity literal or a `[severity, options]` tuple. The
- * options slot's type is _picked per rule name_ via `TtscLintRuleOptionsMap` —
- * so a user writing
- *
- *     "format/sort-imports": ["error", { importOrder: [...] }]
- *
- * Inside `TtscLintRuleMap` gets exact autocomplete and typo detection on the
- * options object. The rule name is the object key; the `[severity, options]`
- * tuple is the value.
- *
- * Rules that do not appear in `TtscLintRuleOptionsMap` accept only the severity
- * literal (or the bare `[severity]` tuple): the conditional arm collapses to
- * `never`, removing the options-tuple branch from the union for those rules.
- * This keeps `no-var` and friends from silently accepting unrecognized option
- * blobs.
- */
-export type TtscLintRuleEntry<R extends string = string> =
-  | TtscLintSeverity
-  | readonly [TtscLintSeverity]
-  | (R extends keyof TtscLintRuleOptionsMap
-      ? readonly [TtscLintSeverity, TtscLintRuleOptionsMap[R]]
-      : never);