@ttsc/lint 0.11.0 → 0.12.0

package/lib/structures/ITtscLintPluginConfig.d.ts

@@ -1,4 +1,4 @@
-import type { TtscLintFormatConfig } from "./TtscLintFormatConfig";
+import type { ITtscLintFormatConfig } from "./ITtscLintFormatConfig";
 import type { TtscLintRuleMap } from "./TtscLintRuleMap";
 /** `compilerOptions.plugins[]` entry shape consumed by `@ttsc/lint`. */
 export interface ITtscLintPluginConfig {
@@ -61,7 +61,7 @@ export interface ITtscLintPluginConfig {
     plugins?: Record<string, string>;
     /**
      * Prettier-style flat configuration for the `format/*` rules. Sibling of
-     * `rules`. See {@link TtscLintFormatConfig} for the full surface.
+     * `rules`. See {@link ITtscLintFormatConfig} for the full surface.
      *
      * ```jsonc
      * {
@@ -74,7 +74,7 @@ export interface ITtscLintPluginConfig {
      * combined with `extends` on the same plugin entry — put format options
      * inside the extends-target lint.config.ts instead.
      */
-    format?: TtscLintFormatConfig;
+    format?: ITtscLintFormatConfig;
     /**
      * Inline rule map or path to a standalone lint config file.
      *
@@ -85,9 +85,9 @@ export interface ITtscLintPluginConfig {
      *
      *   The legacy shape is intentionally narrower than `rules`/`extends`: a string
      *   (file path) or a flat rule-name → severity map. The Go-side parser only
-     *   accepts those two shapes; widening the TS type to the new
-     *   `TtscLintConfig` union would silently let `config: [{ rules: {...} }]`
-     *   pass type-checking and fail at runtime.
+     *   accepts those two shapes; widening the TS type to the full config object
+     *   would silently let unsupported nested shapes pass type-checking and fail
+     *   at runtime.
      */
     config?: string | TtscLintRuleMap;
     /** Extra plugin-owned fields are passed through unchanged. */

package/lib/structures/TtscLintRuleMap.d.ts

@@ -1,17 +1,17 @@
-import type { PluginRuleNames } from "./PluginRuleNames";
-import type { TtscLintPlugins } from "./TtscLintPlugins";
 import type { TtscLintRule } from "./TtscLintRule";
-import type { TtscLintRuleOptionsMap } from "./TtscLintRuleOptions";
+import type { ITtscLintRuleOptionsMap } from "./TtscLintRuleOptions";
 import type { TtscLintSeverity } from "./TtscLintSeverity";
 /**
  * Rule-name → severity or severity-tuple map.
  *
  * Built from two independent mapped types intersected together:
  *
- * - Rules listed in `TtscLintRuleOptionsMap` accept `severity`, `[severity]`, or
+ * - Rules listed in `ITtscLintRuleOptionsMap` accept `severity`, `[severity]`, or
  *   `[severity, options]`, with the options type picked per rule key.
- * - Every other built-in rule plus any contributor plugin rule accepts `severity`
- *   or `[severity]`.
+ * - Every other built-in rule accepts `severity` or `[severity]`.
+ * - Namespaced contributor plugin rules accept `severity`, `[severity]`, or
+ *   `[severity, unknownOptions]` because the host type surface no longer
+ *   knows contributor rule schemas.
  *
  * Splitting the two halves (instead of folding them into one mapped type with a
  * conditional value) keeps TypeScript's contextual typing intact inside the
@@ -37,8 +37,10 @@ import type { TtscLintSeverity } from "./TtscLintSeverity";
  * splits each negative case into its own const to keep every branch
  * load-bearing.
  */
-export type TtscLintRuleMap<P extends TtscLintPlugins = Record<string, never>> = {
-    [K in keyof TtscLintRuleOptionsMap]?: TtscLintSeverity | readonly [TtscLintSeverity] | readonly [TtscLintSeverity, TtscLintRuleOptionsMap[K]];
+export type TtscLintRuleMap = {
+    [K in keyof ITtscLintRuleOptionsMap]?: TtscLintSeverity | readonly [TtscLintSeverity] | readonly [TtscLintSeverity, ITtscLintRuleOptionsMap[K]];
 } & {
-    [K in Exclude<TtscLintRule | PluginRuleNames<P>, keyof TtscLintRuleOptionsMap>]?: TtscLintSeverity | readonly [TtscLintSeverity];
+    [K in Exclude<TtscLintRule, keyof ITtscLintRuleOptionsMap>]?: TtscLintSeverity | readonly [TtscLintSeverity];
+} & {
+    [K in `${string}/${string}`]?: TtscLintSeverity | readonly [TtscLintSeverity] | readonly [TtscLintSeverity, unknown];
 };

package/lib/structures/TtscLintRuleOptions.d.ts

@@ -1,149 +1,123 @@
-/**
- * Per-rule option shapes used by `TtscLintRuleEntry` to type the second tuple
- * slot.
- *
- * Each entry here maps a rule name to its option struct. Rule names that do not
- * appear in this interface accept severity-only configuration (a `[severity]`
- * tuple is _also_ allowed for them, with an empty options blob).
- *
- * The shapes are designed to match the analogous prettier / ESLint options
- * where the rule absorbs an existing tool's behavior:
- *
- * - `format/semi` mirrors prettier `semi`.
- * - `format/quotes` mirrors prettier `singleQuote` (inverted).
- * - `format/trailing-comma` mirrors prettier `trailingComma`.
- * - `format/sort-imports` mirrors `@trivago/prettier-plugin-sort-imports`
- *   (`importOrder`, `importOrderSeparation`, `importOrderSortSpecifiers`,
- *   `importOrderCaseInsensitive`).
- * - `format/jsdoc` mirrors `prettier-plugin-jsdoc` (`tagSynonyms` layered onto
- *   the built-in synonym table, `sortTags` reserved for a future pass).
- *
- * Future option additions go here so the TypeScript autocomplete updates in one
- * place. The Go side reads these as `json.RawMessage` and each rule decodes
- * into its own struct.
- */
-export declare namespace TtscLintRuleOptions {
-    /** `format/semi` options. */
-    interface Semi {
-        /**
-         * Whether trailing semicolons must be present on ASI statements.
-         *
-         * @default "always"
-         */
-        prefer?: "always" | "never";
-    }
-    /** `format/quotes` options. */
-    interface Quotes {
-        /**
-         * Quote style for string literals. Template literals are always preserved
-         * regardless of this setting.
-         *
-         * @default "double"
-         */
-        prefer?: "double" | "single";
-    }
-    /** `format/trailing-comma` options. */
-    interface TrailingComma {
-        /**
-         * Which multi-line lists receive a trailing comma. `"all"` matches
-         * prettier's modern default; `"es5"` skips function calls and type
-         * parameter lists; `"none"` disables the rule entirely.
-         *
-         * @default "all"
-         */
-        mode?: "all" | "es5" | "none";
-    }
-    /** `format/sort-imports` options. */
-    interface SortImports {
-        /**
-         * Ordered list of regex strings (or the `<THIRD_PARTY_MODULES>`
-         * placeholder) defining the group order. Imports matching the first pattern
-         * land in group 0, the second in group 1, and so on. The placeholder
-         * absorbs any specifier that does not match another pattern. Mirrors
-         * trivago's `importOrder` semantics.
-         */
-        importOrder?: readonly string[];
-        /**
-         * Insert a blank line between groups.
-         *
-         * @default true
-         */
-        importOrderSeparation?: boolean;
-        /**
-         * Sort named import specifiers alphabetically within each declaration.
-         *
-         * @default true
-         */
-        importOrderSortSpecifiers?: boolean;
-        /**
-         * Treat `A` and `a` as equivalent when comparing module specifiers and
-         * specifier names. Mirrors trivago's `importOrderCaseInsensitive`.
-         *
-         * @default false
-         */
-        importOrderCaseInsensitive?: boolean;
-    }
-    /** `format/print-width` options. */
-    interface PrintWidth {
-        /**
-         * Maximum column width before broken-form layout is chosen. Mirrors
-         * prettier's `printWidth`.
-         *
-         * @default 80
-         */
-        printWidth?: number;
-        /**
-         * Indentation increment in columns. Mirrors prettier's `tabWidth`.
-         *
-         * @default 2
-         */
-        tabWidth?: number;
-        /**
-         * Emit indentation as tab characters rather than spaces. Mirrors
-         * prettier's `useTabs`. Continuation alignment beyond the tab
-         * boundary still falls back to spaces, matching dprint's
-         * "indent with tabs, align with spaces" convention.
-         *
-         * @default false
-         */
-        useTabs?: boolean;
-        /**
-         * Line-terminator emitted on every newline the printer inserts.
-         * Mirrors prettier's `endOfLine` `"lf"` and `"crlf"` modes.
-         *
-         * @default "lf"
-         */
-        endOfLine?: "lf" | "crlf";
-    }
-    /** `format/jsdoc` options. */
-    interface JSDoc {
-        /**
-         * Extra `from → to` tag rewrites layered on top of the built-in synonym
-         * table (`@return → @returns`, `@arg → @param`, etc.). User-supplied
-         * entries win on key collision, so a `{"return": "RETURN"}` entry overrides
-         * the built-in default for `@return`.
-         *
-         * @default {} (use built-in table unchanged)
-         */
-        tagSynonyms?: Record<string, string>;
-        /**
-         * Sort JSDoc tag blocks into the canonical order (`@description`, `@param`,
-         * `@returns`, …).
-         *
-         * @default false (deferred; MVP only normalizes tag names)
-         */
-        sortTags?: boolean;
-    }
+/** `format/semi` rule options. */
+export interface ITtscLintSemiRuleOptions {
+    /**
+     * Whether trailing semicolons must be present on ASI statements.
+     *
+     * @default "always"
+     */
+    prefer?: "always" | "never";
+}
+/** `format/quotes` rule options. */
+export interface ITtscLintQuotesRuleOptions {
+    /**
+     * Quote style for string literals. Template literals are always preserved
+     * regardless of this setting.
+     *
+     * @default "double"
+     */
+    prefer?: "double" | "single";
+}
+/** `format/trailing-comma` rule options. */
+export interface ITtscLintTrailingCommaRuleOptions {
+    /**
+     * Which multi-line lists receive a trailing comma. `"all"` matches prettier's
+     * modern default; `"es5"` skips function calls and type parameter lists;
+     * `"none"` disables the rule entirely.
+     *
+     * @default "all"
+     */
+    mode?: "all" | "es5" | "none";
+}
+/** `format/sort-imports` rule options. */
+export interface ITtscLintSortImportsRuleOptions {
+    /**
+     * Ordered list of regex strings (or the `<THIRD_PARTY_MODULES>` placeholder)
+     * defining the group order. Imports matching the first pattern land in group
+     * 0, the second in group 1, and so on. The placeholder absorbs any specifier
+     * that does not match another pattern. Mirrors trivago's `importOrder`
+     * semantics.
+     */
+    importOrder?: readonly string[];
+    /**
+     * Insert a blank line between groups.
+     *
+     * @default true
+     */
+    importOrderSeparation?: boolean;
+    /**
+     * Sort named import specifiers alphabetically within each declaration.
+     *
+     * @default true
+     */
+    importOrderSortSpecifiers?: boolean;
+    /**
+     * Treat `A` and `a` as equivalent when comparing module specifiers and
+     * specifier names. Mirrors trivago's `importOrderCaseInsensitive`.
+     *
+     * @default false
+     */
+    importOrderCaseInsensitive?: boolean;
+}
+/** `format/print-width` rule options. */
+export interface ITtscLintPrintWidthRuleOptions {
+    /**
+     * Maximum column width before broken-form layout is chosen. Mirrors
+     * prettier's `printWidth`.
+     *
+     * @default 80
+     */
+    printWidth?: number;
+    /**
+     * Indentation increment in columns. Mirrors prettier's `tabWidth`.
+     *
+     * @default 2
+     */
+    tabWidth?: number;
+    /**
+     * Emit indentation as tab characters rather than spaces. Mirrors prettier's
+     * `useTabs`. Continuation alignment beyond the tab boundary still falls back
+     * to spaces, matching dprint's "indent with tabs, align with spaces"
+     * convention.
+     *
+     * @default false
+     */
+    useTabs?: boolean;
+    /**
+     * Line-terminator emitted on every newline the printer inserts. Mirrors
+     * prettier's `endOfLine` `"lf"` and `"crlf"` modes.
+     *
+     * @default "lf"
+     */
+    endOfLine?: "lf" | "crlf";
+}
+/** `format/jsdoc` rule options. */
+export interface ITtscLintJsdocRuleOptions {
+    /**
+     * Extra `from -> to` tag rewrites layered on top of the built-in synonym
+     * table (`@return -> @returns`, `@arg -> @param`, etc.). User-supplied
+     * entries win on key collision, so a `{"return": "RETURN"}` entry overrides
+     * the built-in default for `@return`.
+     *
+     * @default {} (use built-in table unchanged)
+     */
+    tagSynonyms?: Record<string, string>;
+    /**
+     * Sort JSDoc tag blocks into the canonical order (`@description`, `@param`,
+     * `@returns`, ...).
+     *
+     * @default false (deferred; MVP only normalizes tag names)
+     */
+    sortTags?: boolean;
 }
 /**
- * Index from rule name to its option struct. Used by `TtscLintRuleEntry<R>` to
+ * Index from rule name to its option object. `TtscLintRuleMap` uses this to
  * produce precise tuple types per rule.
  */
-export interface TtscLintRuleOptionsMap {
-    "format/semi": TtscLintRuleOptions.Semi;
-    "format/quotes": TtscLintRuleOptions.Quotes;
-    "format/trailing-comma": TtscLintRuleOptions.TrailingComma;
-    "format/sort-imports": TtscLintRuleOptions.SortImports;
-    "format/jsdoc": TtscLintRuleOptions.JSDoc;
-    "format/print-width": TtscLintRuleOptions.PrintWidth;
+export interface ITtscLintRuleOptionsMap {
+    "format/semi": ITtscLintSemiRuleOptions;
+    "format/quotes": ITtscLintQuotesRuleOptions;
+    "format/trailing-comma": ITtscLintTrailingCommaRuleOptions;
+    "format/sort-imports": ITtscLintSortImportsRuleOptions;
+    "format/jsdoc": ITtscLintJsdocRuleOptions;
+    "format/print-width": ITtscLintPrintWidthRuleOptions;
 }

package/lib/structures/index.d.ts

@@ -1,14 +1,9 @@
-export * from "./defaultFormat";
+export * from "./ITtscLintConfig";
+export * from "./ITtscLintFormatConfig";
 export * from "./ITtscLintPlugin";
 export * from "./ITtscLintPluginConfig";
 export * from "./ITtscLintPluginMeta";
-export * from "./PluginRuleNames";
-export * from "./TtscLintConfig";
-export * from "./TtscLintConfigEntry";
-export * from "./TtscLintFormatConfig";
-export * from "./TtscLintPlugins";
 export * from "./TtscLintRule";
-export * from "./TtscLintRuleEntry";
 export * from "./TtscLintRuleMap";
 export * from "./TtscLintRuleOptions";
 export * from "./TtscLintSeverity";

package/lib/structures/index.js

@@ -14,17 +14,12 @@ var __exportStar = (this && this.__exportStar) || function(m, exports) {
     for (var p in m) if (p !== "default" && !Object.prototype.hasOwnProperty.call(exports, p)) __createBinding(exports, m, p);
 };
 Object.defineProperty(exports, "__esModule", { value: true });
-__exportStar(require("./defaultFormat"), exports);
+__exportStar(require("./ITtscLintConfig"), exports);
+__exportStar(require("./ITtscLintFormatConfig"), exports);
 __exportStar(require("./ITtscLintPlugin"), exports);
 __exportStar(require("./ITtscLintPluginConfig"), exports);
 __exportStar(require("./ITtscLintPluginMeta"), exports);
-__exportStar(require("./PluginRuleNames"), exports);
-__exportStar(require("./TtscLintConfig"), exports);
-__exportStar(require("./TtscLintConfigEntry"), exports);
-__exportStar(require("./TtscLintFormatConfig"), exports);
-__exportStar(require("./TtscLintPlugins"), exports);
 __exportStar(require("./TtscLintRule"), exports);
-__exportStar(require("./TtscLintRuleEntry"), exports);
 __exportStar(require("./TtscLintRuleMap"), exports);
 __exportStar(require("./TtscLintRuleOptions"), exports);
 __exportStar(require("./TtscLintSeverity"), exports);

package/lib/structures/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/structures/index.ts"],"names":[],"mappings":";;;;;;;;;;;;;;;;AAAA,kDAAgC;AAChC,oDAAkC;AAClC,0DAAwC;AACxC,wDAAsC;AACtC,oDAAkC;AAClC,mDAAiC;AACjC,wDAAsC;AACtC,yDAAuC;AACvC,oDAAkC;AAClC,iDAA+B;AAC/B,sDAAoC;AACpC,oDAAkC;AAClC,wDAAsC;AACtC,qDAAmC"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/structures/index.ts"],"names":[],"mappings":";;;;;;;;;;;;;;;;AAAA,oDAAkC;AAClC,0DAAwC;AACxC,oDAAkC;AAClC,0DAAwC;AACxC,wDAAsC;AACtC,iDAA+B;AAC/B,oDAAkC;AAClC,wDAAsC;AACtC,qDAAmC"}

package/linthost/config.go

@@ -490,7 +490,6 @@ func collectExternalConfigEntries(store *ConfigStore, raw any, baseDir, path str
         }
         merged := mergeRuleMaps(formatRulesRaw, rulesMap)
         if len(merged) == 0 {
-          // `format: { severity: "off" }` and no rules — drop entry.
           return nil
         }
         parsed, err := parseExternalRuleMapInto(merged, path+".rules", store)
@@ -798,9 +797,7 @@ func LoadConfigResolver(entry *PluginEntry, cwd, tsconfigPath string) (RuleResol
     return nil, fmt.Errorf("@ttsc/lint: \"format\" and \"extends\" cannot be combined on a single plugin entry; put format options inside the extends-target lint.config.ts instead")
   }
 
-  // Expand the format block (if any) into a rules-shaped map. The
-  // returned map is empty when `format.severity === "off"` so the
-  // downstream merge with `rules` still produces the right result.
+  // Expand the format block (if any) into a rules-shaped map.
   var formatRulesRaw map[string]any
   if hasFormat {
     formatMap, ok := formatValue.(map[string]any)
@@ -827,8 +824,6 @@ func LoadConfigResolver(entry *PluginEntry, cwd, tsconfigPath string) (RuleResol
     }
     merged := mergeRuleMaps(formatRulesRaw, rulesMap)
     if len(merged) == 0 {
-      // `format: { severity: "off" }` with no `rules` field — no
-      // rules to register.
       return InlineRuleResolver{Rules: RuleConfig{}, Options: RuleOptionsMap{}}, nil
     }
     cfg, opts, err := ParseRulesWithOptions(merged)