@ttsc/lint 0.10.2 → 0.11.0-dev.20260517

package/lib/structures/TtscLintRuleOptions.d.ts

@@ -0,0 +1,149 @@
+/**
+ * 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;
+    }
+}
+/**
+ * Index from rule name to its option struct. Used by `TtscLintRuleEntry<R>` 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;
+}

package/lib/structures/TtscLintRuleOptions.js

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

package/lib/structures/TtscLintRuleOptions.js.map

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

package/lib/structures/defaultFormat.d.ts

@@ -0,0 +1,31 @@
+/**
+ * Documented defaults for the `format` block's *always-on* rules
+ * (`format/semi`, `format/quotes`, `format/trailing-comma`,
+ * `format/print-width`).
+ *
+ * Exported so users can spread defaults next to overrides:
+ *
+ *   import { defaultFormat, type TtscLintConfig } from "@ttsc/lint";
+ *
+ *   export default {
+ *     format: { ...defaultFormat, printWidth: 100 },
+ *   } satisfies TtscLintConfig;
+ *
+ * The values mirror Prettier 1:1 except for the documented
+ * `endOfLine` narrowing (no `"cr"` / `"auto"`).
+ *
+ * Notably absent: `importOrder` and `jsdoc`. `format/sort-imports`
+ * and `format/jsdoc` are opt-in by setting their corresponding
+ * fields; the defaults const only seeds the rules that turn on
+ * unconditionally with a non-empty `format` block.
+ */
+export declare const defaultFormat: Readonly<{
+    severity: "warning";
+    semi: true;
+    singleQuote: false;
+    trailingComma: "all";
+    printWidth: number;
+    tabWidth: number;
+    useTabs: false;
+    endOfLine: "lf";
+}>;

package/lib/structures/defaultFormat.js

@@ -0,0 +1,35 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.defaultFormat = void 0;
+/**
+ * Documented defaults for the `format` block's *always-on* rules
+ * (`format/semi`, `format/quotes`, `format/trailing-comma`,
+ * `format/print-width`).
+ *
+ * Exported so users can spread defaults next to overrides:
+ *
+ *   import { defaultFormat, type TtscLintConfig } from "@ttsc/lint";
+ *
+ *   export default {
+ *     format: { ...defaultFormat, printWidth: 100 },
+ *   } satisfies TtscLintConfig;
+ *
+ * The values mirror Prettier 1:1 except for the documented
+ * `endOfLine` narrowing (no `"cr"` / `"auto"`).
+ *
+ * Notably absent: `importOrder` and `jsdoc`. `format/sort-imports`
+ * and `format/jsdoc` are opt-in by setting their corresponding
+ * fields; the defaults const only seeds the rules that turn on
+ * unconditionally with a non-empty `format` block.
+ */
+exports.defaultFormat = Object.freeze({
+    severity: "warning",
+    semi: true,
+    singleQuote: false,
+    trailingComma: "all",
+    printWidth: 80,
+    tabWidth: 2,
+    useTabs: false,
+    endOfLine: "lf",
+});
+//# sourceMappingURL=defaultFormat.js.map

package/lib/structures/defaultFormat.js.map

@@ -0,0 +1 @@
+{"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/lib/structures/index.d.ts

@@ -1,4 +1,14 @@
+export * from "./defaultFormat";
+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,8 +14,18 @@ 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("./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);
 //# sourceMappingURL=index.js.map

package/lib/structures/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/structures/index.ts"],"names":[],"mappings":";;;;;;;;;;;;;;;;AAAA,0DAAwC;AACxC,mDAAiC;AACjC,iDAA+B;AAC/B,qDAAmC"}
+{"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"}

package/{plugin → linthost}/ast_helpers.go

@@ -1,4 +1,4 @@
-package main
+package linthost
 
 import (
   "strings"
@@ -26,6 +26,97 @@ func nodeText(file *shimast.SourceFile, node *shimast.Node) string {
   return strings.TrimRight(src[pos:end], " \t\r\n")
 }
 
+// keywordStart returns the source offset of a declaration keyword such as
+// `var` or `let` at the start of a node after leading trivia.
+func keywordStart(file *shimast.SourceFile, node *shimast.Node, keyword string) int {
+  if file == nil || node == nil || keyword == "" {
+    return -1
+  }
+  src := file.Text()
+  pos := shimscanner.SkipTrivia(src, node.Pos())
+  end := pos + len(keyword)
+  if pos < 0 || end > len(src) {
+    return -1
+  }
+  if strings.HasPrefix(src[pos:], keyword) && (end == len(src) || !isIdentifierPart(src[end])) {
+    return pos
+  }
+  limit := node.End()
+  if limit > len(src) {
+    limit = len(src)
+  }
+  for i := pos; i+len(keyword) <= limit && i < pos+32; i++ {
+    end = i + len(keyword)
+    if strings.HasPrefix(src[i:], keyword) &&
+      (i == 0 || !isIdentifierPart(src[i-1])) &&
+      (end == len(src) || !isIdentifierPart(src[end])) {
+      return i
+    }
+  }
+  return -1
+}
+
+// findKeyword scans [pos, end) for a keyword token whose lexeme is
+// `keyword`. Returns the byte offset of the keyword's first character,
+// or -1 if not found. Unlike keywordStart this is unbounded by a node's
+// leading-trivia start, so it can locate `module` inside a
+// ModuleDeclaration or insert points like the end of `import`.
+//
+// The match is identifier-aware: a hit must be preceded and followed by
+// a non-identifier byte so that e.g. searching for `import` does not
+// match the `import` prefix of `importStr`.
+func findKeyword(file *shimast.SourceFile, pos, end int, keyword string) int {
+  if file == nil || keyword == "" {
+    return -1
+  }
+  src := file.Text()
+  if pos < 0 {
+    pos = 0
+  }
+  if end > len(src) {
+    end = len(src)
+  }
+  limit := end - len(keyword)
+  for i := pos; i <= limit; i++ {
+    if src[i] != keyword[0] {
+      continue
+    }
+    tail := i + len(keyword)
+    if src[i:tail] != keyword {
+      continue
+    }
+    if i > 0 && isIdentifierPart(src[i-1]) {
+      continue
+    }
+    if tail < len(src) && isIdentifierPart(src[tail]) {
+      continue
+    }
+    return i
+  }
+  return -1
+}
+
+func tokenRange(file *shimast.SourceFile, node *shimast.Node) (int, int) {
+  if file == nil || node == nil {
+    return -1, -1
+  }
+  src := file.Text()
+  pos := shimscanner.SkipTrivia(src, node.Pos())
+  end := node.End()
+  if pos < 0 || pos > len(src) || end < pos || end > len(src) {
+    return -1, -1
+  }
+  return pos, end
+}
+
+func isIdentifierPart(ch byte) bool {
+  return (ch >= 'a' && ch <= 'z') ||
+    (ch >= 'A' && ch <= 'Z') ||
+    (ch >= '0' && ch <= '9') ||
+    ch == '_' ||
+    ch == '$'
+}
+
 // identifierText returns the lexical name of an Identifier node, or "" if
 // the node isn't an Identifier.
 func identifierText(node *shimast.Node) string {

package/{plugin → linthost}/compile.go

@@ -9,7 +9,7 @@
 // The split between this file and `engine.go` is deliberate: the engine
 // is pure (rules + AST traversal), and this file owns every side effect
 // (process flags, stderr/stdout, emit, exit codes).
-package main
+package linthost
 
 import (
   "context"