@ttsc/lint 0.13.0 → 0.14.0-dev.20250530.1

package/lib/structures/format/ITtscLintFormat.js.map

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

package/lib/structures/format/ITtscLintFormatJsDoc.d.ts

@@ -0,0 +1,17 @@
+/**
+ * Object form of {@link ITtscLintFormat.jsDoc}.
+ */
+export interface ITtscLintFormatJsDoc {
+    /**
+     * Extra `from → to` tag rewrites layered on the built-in synonym table
+     * (`@return` → `@returns`, `@arg` → `@param`, ...).
+     */
+    tagSynonyms?: Record<string, string>;
+    /**
+     * Sort JSDoc tags into canonical order. Reserved; the current MVP only
+     * rewrites tag names.
+     *
+     * @default false
+     */
+    sortTags?: boolean;
+}

package/lib/structures/{ITtscLintFormatConfig.js → format/ITtscLintFormatJsDoc.js}

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

package/lib/structures/format/ITtscLintFormatJsDoc.js.map

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

package/lib/structures/format/ITtscLintFormatSortImports.d.ts

@@ -0,0 +1,54 @@
+/**
+ * Object form of {@link ITtscLintFormat.sortImports}.
+ *
+ * The declarative {@link order} array expresses group order, blank-line
+ * separation, and special groups all by position. Multiple imports of the same
+ * module are always merged into one declaration; merging a value import with a
+ * type-only import additionally requires {@link combineTypeAndValue}.
+ */
+export interface ITtscLintFormatSortImports {
+    /**
+     * Group order. Each entry is a regular expression matched against a
+     * declaration's module specifier, or one of these placeholders:
+     *
+     * - `<BUILTIN_MODULES>` — Node built-in modules (`fs`, `node:path`, ...).
+     * - `<THIRD_PARTY_MODULES>` — catch-all for specifiers that match no other
+     *   group. Injected implicitly at the front when omitted.
+     * - `<TYPES>` — `import type` declarations. Combine with a regex to scope it,
+     *   e.g. `<TYPES>^[.]` groups type-only relative imports.
+     * - `""` (empty string) — emit one blank line at this position. An array with
+     *   no `""` entry produces no blank lines between groups.
+     *
+     * Named specifiers inside each declaration are always sorted. Omit for the
+     * default grouping. Example:
+     *
+     * ```ts
+     * order: [
+     *   "<BUILTIN_MODULES>",
+     *   "",
+     *   "<THIRD_PARTY_MODULES>",
+     *   "",
+     *   "<TYPES>^[.]",
+     *   "^[.]",
+     * ]
+     * ```
+     */
+    order?: readonly ("<BUILTIN_MODULES>" | "<THIRD_PARTY_MODULES>" | "<TYPES>" | "" | (string & {}))[];
+    /**
+     * Case-sensitive comparison. `false` (the default) sorts case-insensitively,
+     * so `React` and `react` order together; `true` uses raw ASCII order
+     * (uppercase before lowercase).
+     *
+     * @default false
+     */
+    caseSensitive?: boolean;
+    /**
+     * Merge a value import and a type-only import of the same module into one
+     * declaration with inline `type` specifiers: `import { foo } from "m"` plus
+     * `import type { Bar } from "m"` collapse to
+     * `import { foo, type Bar } from "m"`.
+     *
+     * @default false
+     */
+    combineTypeAndValue?: boolean;
+}

package/lib/structures/format/ITtscLintFormatSortImports.js

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

package/lib/structures/format/ITtscLintFormatSortImports.js.map

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

package/lib/structures/format/index.d.ts

@@ -0,0 +1,3 @@
+export * from "./ITtscLintFormat";
+export * from "./ITtscLintFormatJsDoc";
+export * from "./ITtscLintFormatSortImports";

package/lib/structures/format/index.js

@@ -0,0 +1,20 @@
+"use strict";
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+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("./ITtscLintFormat"), exports);
+__exportStar(require("./ITtscLintFormatJsDoc"), exports);
+__exportStar(require("./ITtscLintFormatSortImports"), exports);
+//# sourceMappingURL=index.js.map

package/lib/structures/format/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/structures/format/index.ts"],"names":[],"mappings":";;;;;;;;;;;;;;;;AAAA,oDAAkC;AAClC,yDAAuC;AACvC,+DAA6C"}

package/lib/structures/index.d.ts

@@ -1,9 +1,8 @@
 export * from "./ITtscLintConfig";
-export * from "./ITtscLintFormatConfig";
+export * from "./format";
 export * from "./ITtscLintPlugin";
 export * from "./ITtscLintPluginConfig";
 export * from "./ITtscLintPluginMeta";
-export * from "./TtscLintRule";
-export * from "./TtscLintRuleMap";
-export * from "./TtscLintRuleOptions";
+export * from "./TtscLintRuleSetting";
 export * from "./TtscLintSeverity";
+export * from "./rules";

package/lib/structures/index.js

@@ -15,12 +15,11 @@ var __exportStar = (this && this.__exportStar) || function(m, exports) {
 };
 Object.defineProperty(exports, "__esModule", { value: true });
 __exportStar(require("./ITtscLintConfig"), exports);
-__exportStar(require("./ITtscLintFormatConfig"), exports);
+__exportStar(require("./format"), exports);
 __exportStar(require("./ITtscLintPlugin"), exports);
 __exportStar(require("./ITtscLintPluginConfig"), exports);
 __exportStar(require("./ITtscLintPluginMeta"), exports);
-__exportStar(require("./TtscLintRule"), exports);
-__exportStar(require("./TtscLintRuleMap"), exports);
-__exportStar(require("./TtscLintRuleOptions"), exports);
+__exportStar(require("./TtscLintRuleSetting"), exports);
 __exportStar(require("./TtscLintSeverity"), exports);
+__exportStar(require("./rules"), 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,oDAAkC;AAClC,0DAAwC;AACxC,oDAAkC;AAClC,0DAAwC;AACxC,wDAAsC;AACtC,iDAA+B;AAC/B,oDAAkC;AAClC,wDAAsC;AACtC,qDAAmC"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/structures/index.ts"],"names":[],"mappings":";;;;;;;;;;;;;;;;AAAA,oDAAkC;AAClC,2CAAyB;AACzB,oDAAkC;AAClC,0DAAwC;AACxC,wDAAsC;AACtC,wDAAsC;AACtC,qDAAmC;AACnC,0CAAwB"}

package/lib/structures/rules/ITtscLintBoundariesRuleOptions.d.ts

@@ -0,0 +1,95 @@
+/**
+ * Options shapes for every rule in {@link ITtscLintBoundariesRules}.
+ *
+ * The `boundaries/*` family classifies each source file as belonging to a named
+ * _element_ (a layer, feature, or app within the project). Every rule below
+ * shares the same element-declaration block, so the helper interfaces in this
+ * file describe that block first and then layer the per-rule options on top.
+ *
+ * @reference https://github.com/javierbrea/eslint-plugin-boundaries
+ */
+/** One source-path element used by the `boundaries/*` rules. */
+export interface ITtscLintBoundariesElement {
+    /** Element type name used by `boundaries/element-types` policies. */
+    type: string;
+    /**
+     * Glob-like source path pattern. Relative patterns are matched against any
+     * project-path suffix, so `src/app/**` works in temporary and monorepo roots
+     * alike.
+     */
+    pattern: string;
+    /**
+     * File(s) inside the element that may be imported from outside that element.
+     * Used by `boundaries/entry-point`.
+     */
+    entry?: string | readonly string[];
+    /**
+     * File(s) inside the element that may only be imported by the same element.
+     * Used by `boundaries/no-private`.
+     */
+    private?: string | readonly string[];
+}
+/** Dependency policy used by `boundaries/element-types`. */
+export interface ITtscLintBoundariesElementTypesRule {
+    /** Source element type(s) the policy applies to. Omit to match all sources. */
+    from?: string | readonly string[];
+    /** Target element type(s) allowed from the matching source. */
+    allow?: string | readonly string[];
+    /** Target element type(s) rejected from the matching source. */
+    disallow?: string | readonly string[];
+    /** Optional diagnostic override. */
+    message?: string;
+}
+/**
+ * Shared element-declaration block used by every TypeScript source-path
+ * `boundaries/*` rule.
+ */
+export interface ITtscLintBoundariesElementsOptions {
+    /** Source path elements used to classify importers and imported files. */
+    elements?: readonly ITtscLintBoundariesElement[];
+}
+/** `boundaries/element-types` rule options. */
+export interface ITtscLintBoundariesElementTypesRuleOptions extends ITtscLintBoundariesElementsOptions {
+    /**
+     * Fallback policy when no rule matches.
+     *
+     * @default "allow"
+     */
+    default?: "allow" | "disallow";
+    /** Ordered dependency policies. First matching policy wins. */
+    rules?: readonly ITtscLintBoundariesElementTypesRule[];
+}
+/** `boundaries/external` rule options. */
+export interface ITtscLintBoundariesExternalRuleOptions {
+    /** External package/specifier patterns that are allowed. Empty means all. */
+    allow?: string | readonly string[];
+    /** External package/specifier patterns that are rejected. */
+    disallow?: string | readonly string[];
+    /** Optional diagnostic override. */
+    message?: string;
+}
+/** `boundaries/entry-point` rule options. */
+export type ITtscLintBoundariesEntryPointRuleOptions = ITtscLintBoundariesElementsOptions;
+/** `boundaries/no-private` rule options. */
+export type ITtscLintBoundariesNoPrivateRuleOptions = ITtscLintBoundariesElementsOptions;
+/** `boundaries/no-unknown` rule options. */
+export type ITtscLintBoundariesNoUnknownRuleOptions = ITtscLintBoundariesElementsOptions;
+/**
+ * `boundaries/dependencies` rule options.
+ *
+ * The upstream unified rule subsumes `element-types`, `entry-point`,
+ * `external`, `no-private`, and `no-unknown` behind a single direction-aware
+ * policy block. The v1 native port registers the rule name and decodes this
+ * config shape but does not yet emit diagnostics (`v1 stub; full validation
+ * deferred` — see `rules_boundaries.go`).
+ */
+export interface ITtscLintBoundariesDependenciesRuleOptions extends ITtscLintBoundariesElementsOptions {
+    /**
+     * Fallback policy when no rule matches.
+     *
+     * @default "allow"
+     */
+    default?: "allow" | "disallow";
+    /** Ordered dependency policies. First matching policy wins. */
+    rules?: readonly ITtscLintBoundariesElementTypesRule[];
+}

package/lib/structures/rules/ITtscLintBoundariesRuleOptions.js

@@ -0,0 +1,13 @@
+"use strict";
+/**
+ * Options shapes for every rule in {@link ITtscLintBoundariesRules}.
+ *
+ * The `boundaries/*` family classifies each source file as belonging to a named
+ * _element_ (a layer, feature, or app within the project). Every rule below
+ * shares the same element-declaration block, so the helper interfaces in this
+ * file describe that block first and then layer the per-rule options on top.
+ *
+ * @reference https://github.com/javierbrea/eslint-plugin-boundaries
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+//# sourceMappingURL=ITtscLintBoundariesRuleOptions.js.map

package/lib/structures/rules/ITtscLintBoundariesRuleOptions.js.map

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

package/lib/structures/rules/ITtscLintBoundariesRules.d.ts

@@ -0,0 +1,75 @@
+import type { TtscLintRuleOptionsSetting } from "../TtscLintRuleSetting";
+import type { ITtscLintBoundariesDependenciesRuleOptions, ITtscLintBoundariesElementTypesRuleOptions, ITtscLintBoundariesEntryPointRuleOptions, ITtscLintBoundariesExternalRuleOptions, ITtscLintBoundariesNoPrivateRuleOptions, ITtscLintBoundariesNoUnknownRuleOptions } from "./ITtscLintBoundariesRuleOptions";
+/**
+ * Architecture-boundary rules that enforce import direction and module
+ * visibility between configured source-path _elements_ (layers, features, apps
+ * in a monorepo).
+ *
+ * Every rule operates on the _resolved source file_ of an import — relative
+ * imports are followed to the real `.ts`/`.tsx`/`.d.ts` file before
+ * classification.
+ *
+ * @reference https://github.com/javierbrea/eslint-plugin-boundaries
+ */
+export interface ITtscLintBoundariesRules {
+    /**
+     * Enforce allowed dependency directions between configured source-path
+     * element types.
+     *
+     * Each `element` entry declares a name, a matching glob, and the other
+     * element types it is allowed to import.
+     *
+     * Imports that fall outside the allow-list are reported.
+     *
+     * @reference https://github.com/javierbrea/eslint-plugin-boundaries/blob/master/docs/rules/element-types.md
+     */
+    "boundaries/element-types"?: TtscLintRuleOptionsSetting<ITtscLintBoundariesElementTypesRuleOptions>;
+    /**
+     * Require imports that cross element boundaries to target the importee
+     * element's configured public entry files (typically `index.ts`), so the
+     * public surface of each element is explicit.
+     *
+     * @reference https://github.com/javierbrea/eslint-plugin-boundaries/blob/master/docs/rules/entry-point.md
+     */
+    "boundaries/entry-point"?: TtscLintRuleOptionsSetting<ITtscLintBoundariesEntryPointRuleOptions>;
+    /**
+     * Restrict external package imports by package or specifier pattern.
+     *
+     * Useful for forbidding direct imports of an underlying library when a
+     * project-local facade exists.
+     *
+     * @reference https://github.com/javierbrea/eslint-plugin-boundaries/blob/master/docs/rules/external.md
+     */
+    "boundaries/external"?: TtscLintRuleOptionsSetting<ITtscLintBoundariesExternalRuleOptions>;
+    /**
+     * Reject imports of files declared _private_ by a parent element from outside
+     * that element.
+     *
+     * Combines with `element-types` to keep implementation details hidden.
+     *
+     * @reference https://github.com/javierbrea/eslint-plugin-boundaries/blob/master/docs/rules/no-private.md
+     */
+    "boundaries/no-private"?: TtscLintRuleOptionsSetting<ITtscLintBoundariesNoPrivateRuleOptions>;
+    /**
+     * Reject relative imports whose resolved source file falls under no
+     * configured element.
+     *
+     * Catches stray files that escape the project's boundary map.
+     *
+     * @reference https://github.com/javierbrea/eslint-plugin-boundaries/blob/master/docs/rules/no-unknown.md
+     */
+    "boundaries/no-unknown"?: TtscLintRuleOptionsSetting<ITtscLintBoundariesNoUnknownRuleOptions>;
+    /**
+     * Unified dependency-direction rule from upstream `eslint-plugin-boundaries`,
+     * intended to replace `element-types` / `entry-point` / `external` /
+     * `no-private` / `no-unknown` with a single policy block.
+     *
+     * The native port registers the rule name and accepts the same `elements` +
+     * `rules` config shape as `element-types`, but does not emit diagnostics yet
+     * (v1 stub; full direction validation deferred). Configure it today to claim
+     * the upstream rule id; the legacy split rules continue to enforce policy.
+     *
+     * @reference https://github.com/javierbrea/eslint-plugin-boundaries/blob/master/docs/rules/dependencies.md
+     */
+    "boundaries/dependencies"?: TtscLintRuleOptionsSetting<ITtscLintBoundariesDependenciesRuleOptions>;
+}

package/lib/structures/rules/ITtscLintBoundariesRules.js

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

package/lib/structures/rules/ITtscLintBoundariesRules.js.map

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

package/lib/structures/rules/ITtscLintContributorRules.d.ts

@@ -0,0 +1,16 @@
+import type { TtscLintRuleSetting } from "../TtscLintRuleSetting";
+import type { TtscLintSeverity } from "../TtscLintSeverity";
+/**
+ * Catch-all index signature for contributor plugin rules.
+ *
+ * Plugin authors expose rules under their own namespace prefix (`demo/no-demo`,
+ * `myplugin/foo-bar`). The signature here accepts any `"<namespace>/<rule>"`
+ * key with either the bare severity form, the severity tuple, or the
+ * severity-plus-options tuple. Plugins ship their own typings to tighten the
+ * options shape per rule.
+ *
+ * @reference https://ttsc.dev/lint/development/rules
+ */
+export interface ITtscLintContributorRules {
+    [ruleName: `${string}/${string}`]: TtscLintRuleSetting | readonly [TtscLintSeverity, unknown] | undefined;
+}

package/lib/structures/rules/ITtscLintContributorRules.js

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

package/lib/structures/rules/ITtscLintContributorRules.js.map

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