@ttsc/lint 0.14.0-dev.20260529.1 → 0.14.0

package/lib/defaultFormat.d.ts

@@ -1,12 +1,13 @@
 /**
  * Documented defaults for the `format` block's _always-on_ rules
- * (`format/semi`, `format/quotes`, `format/trailing-comma`,
+ * (`format/semi`, `format/quotes`, `format/arrow-parens`,
+ * `format/bracket-spacing`, `format/quote-props`, `format/trailing-comma`,
  * `format/print-width`).
  *
  * Exported so users can spread defaults next to overrides:
  *
  * ```ts
- * import { defaultFormat, type ITtscLintConfig } from "@ttsc/lint";
+ * import { type ITtscLintConfig, defaultFormat } from "@ttsc/lint";
  *
  * export default {
  *   format: { ...defaultFormat, printWidth: 100 },
@@ -16,15 +17,18 @@
  * 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; this
- * const documents only the rules that turn on unconditionally with a
- * non-empty `format` block — the Go host owns runtime activation.
+ * Notably absent: `sortImports`. Import sorting is opt-in by setting
+ * `sortImports`; JSDoc normalization is always on (set `jsDoc: false` to opt
+ * out). This const documents only the keys that turn on unconditionally with a
+ * non-empty `format` block; the Go host owns runtime activation.
  */
 export declare const defaultFormat: Readonly<{
     severity: "off";
     semi: true;
     singleQuote: false;
+    arrowParens: "always";
+    bracketSpacing: true;
+    quoteProps: "as-needed";
     trailingComma: "all";
     printWidth: number;
     tabWidth: number;

package/lib/defaultFormat.js

@@ -3,13 +3,14 @@ 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/semi`, `format/quotes`, `format/arrow-parens`,
+ * `format/bracket-spacing`, `format/quote-props`, `format/trailing-comma`,
  * `format/print-width`).
  *
  * Exported so users can spread defaults next to overrides:
  *
  * ```ts
- * import { defaultFormat, type ITtscLintConfig } from "@ttsc/lint";
+ * import { type ITtscLintConfig, defaultFormat } from "@ttsc/lint";
  *
  * export default {
  *   format: { ...defaultFormat, printWidth: 100 },
@@ -19,15 +20,18 @@ exports.defaultFormat = void 0;
  * 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; this
- * const documents only the rules that turn on unconditionally with a
- * non-empty `format` block — the Go host owns runtime activation.
+ * Notably absent: `sortImports`. Import sorting is opt-in by setting
+ * `sortImports`; JSDoc normalization is always on (set `jsDoc: false` to opt
+ * out). This const documents only the keys that turn on unconditionally with a
+ * non-empty `format` block; the Go host owns runtime activation.
  */
 exports.defaultFormat = Object.freeze({
     severity: "off",
     semi: true,
     singleQuote: false,
+    arrowParens: "always",
+    bracketSpacing: true,
+    quoteProps: "as-needed",
     trailingComma: "all",
     printWidth: 80,
     tabWidth: 2,

package/lib/defaultFormat.js.map

@@ -1 +1 @@
-{"version":3,"file":"defaultFormat.js","sourceRoot":"","sources":["../src/defaultFormat.ts"],"names":[],"mappings":";;;AAEA;;;;;;;;;;;;;;;;;;;;;;GAsBG;AACU,QAAA,aAAa,GAAG,MAAM,CAAC,MAAM,CAAC;IACzC,QAAQ,EAAE,KAAK;IACf,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;CACU,CAAC,CAAC"}
+{"version":3,"file":"defaultFormat.js","sourceRoot":"","sources":["../src/defaultFormat.ts"],"names":[],"mappings":";;;AAEA;;;;;;;;;;;;;;;;;;;;;;;GAuBG;AACU,QAAA,aAAa,GAAG,MAAM,CAAC,MAAM,CAAC;IACzC,QAAQ,EAAE,KAAK;IACf,IAAI,EAAE,IAAI;IACV,WAAW,EAAE,KAAK;IAClB,WAAW,EAAE,QAAQ;IACrB,cAAc,EAAE,IAAI;IACpB,UAAU,EAAE,WAAW;IACvB,aAAa,EAAE,KAAK;IACpB,UAAU,EAAE,EAAE;IACd,QAAQ,EAAE,CAAC;IACX,OAAO,EAAE,KAAK;IACd,SAAS,EAAE,IAAI;CACU,CAAC,CAAC"}

package/lib/structures/ITtscLintConfig.d.ts

@@ -1,5 +1,5 @@
-import type { ITtscLintFormat } from "./ITtscLintFormat";
 import type { ITtscLintPlugin } from "./ITtscLintPlugin";
+import type { ITtscLintFormat } from "./format/ITtscLintFormat";
 import type { ITtscLintRules } from "./rules/ITtscLintRules";
 /**
  * Top-level object accepted by `@ttsc/lint` config files.
@@ -18,8 +18,8 @@ export interface ITtscLintConfig {
      * Relative paths resolve from the containing config file's directory.
      */
     extends?: string;
-    /** Contributor plugin objects keyed by namespace. */
-    plugins?: Record<string, ITtscLintPlugin>;
+    /** Prettier-style flat configuration for the format rules. */
+    format?: ITtscLintFormat;
     /**
      * Kebab-case built-in rule severities plus namespaced contributor rules.
      *
@@ -28,6 +28,6 @@ export interface ITtscLintConfig {
      * form such as `react/jsx-key` or `demo/no-demo`.
      */
     rules?: ITtscLintRules;
-    /** Prettier-style flat configuration for the format rules. */
-    format?: ITtscLintFormat;
+    /** Contributor plugin objects keyed by namespace. */
+    plugins?: Record<string, ITtscLintPlugin>;
 }

package/lib/structures/TtscLintRuleSetting.d.ts

@@ -5,12 +5,12 @@ import type { TtscLintSeverity } from "./TtscLintSeverity";
  *
  * A rule may be configured either as a bare severity string (`"error"`,
  * `"warning"`, `"off"`) or as a single-element tuple containing the same
- * severity. Both forms are equivalent at runtime; the tuple form exists so
- * that severity-only rules and options-bearing rules look uniform when read
+ * severity. Both forms are equivalent at runtime; the tuple form exists so that
+ * severity-only rules and options-bearing rules look uniform when read
  * top-to-bottom in a `ttsc.lint.config.ts` file.
  *
- * Use {@link TtscLintRuleOptionsSetting} when the rule accepts a typed
- * options object.
+ * Use {@link TtscLintRuleOptionsSetting} when the rule accepts a typed options
+ * object.
  *
  * @example
  *   const config: ITtscLintConfig = {
@@ -26,24 +26,24 @@ export type TtscLintRuleSetting = TtscLintSeverity | readonly [TtscLintSeverity]
  * Per-rule severity-plus-options setting for rules that accept a typed options
  * object.
  *
- * This is the tuple form ESLint users know — `[severity, options]` —
- * kept strongly typed by way of the rule's dedicated options interface
- * (see `TtscLintRuleOptions.ts`). The bare {@link TtscLintRuleSetting}
- * forms remain accepted; omitting the options object means "use the
- * rule's default options".
- *
- * @typeParam TOptions - The rule's options shape. Each rule supplies its
- *   own interface from `TtscLintRuleOptions.ts` (for example
- *   `ITtscLintBoundariesElementTypesRuleOptions`).
+ * This is the tuple form ESLint users know — `[severity, options]` — kept
+ * strongly typed by way of the rule's dedicated options interface (see
+ * `TtscLintRuleOptions.ts`). The bare {@link TtscLintRuleSetting} forms remain
+ * accepted; omitting the options object means "use the rule's default
+ * options".
  *
  * @example
  *   const config: ITtscLintConfig = {
- *     rules: {
- *       "boundaries/element-types": [
- *         "error",
- *         { default: "disallow", rules: [...] },
- *       ],
- *     },
+ *   rules: {
+ *   "boundaries/element-types": [
+ *   "error",
+ *   { default: "disallow", rules: [...] },
+ *   ],
+ *   },
  *   };
+ *
+ * @typeParam TOptions - The rule's options shape. Each rule supplies its own
+ *   interface from `TtscLintRuleOptions.ts` (for example
+ *   `ITtscLintBoundariesElementTypesRuleOptions`).
  */
 export type TtscLintRuleOptionsSetting<TOptions> = TtscLintRuleSetting | readonly [TtscLintSeverity, TOptions];

package/lib/structures/{ITtscLintFormat.d.ts → format/ITtscLintFormat.d.ts}

@@ -1,9 +1,11 @@
-import type { TtscLintSeverity } from "./TtscLintSeverity";
+import type { TtscLintSeverity } from "../TtscLintSeverity";
+import type { ITtscLintFormatJsDoc } from "./ITtscLintFormatJsDoc";
+import type { ITtscLintFormatSortImports } from "./ITtscLintFormatSortImports";
 /**
  * Prettier-style flat configuration for the format rules.
  *
  * The `format` block is the recommended way to enable formatting in
- * `@ttsc/lint`. Each key mirrors a Prettier option of the same name — users
+ * `@ttsc/lint`. Each key mirrors a Prettier option of the same name, users
  * coming from a `.prettierrc` can copy their config almost verbatim. The block
  * is opt-in by presence: a `lint.config.ts` with no `format` field keeps every
  * format rule off, exactly as before.
@@ -13,42 +15,6 @@ import type { TtscLintSeverity } from "./TtscLintSeverity";
  * `ttsc check` does not report format findings unless `severity` is set to a
  * non-off value. Individual rules can be overridden or disabled through the
  * `rules` map (the `rules` entry wins on conflict).
- *
- * @example
- *   import type { ITtscLintConfig } from "@ttsc/lint";
- *
- *   export default {
- *   rules: { "no-var": "error" },
- *   format: {
- *   severity: "warning",
- *   printWidth: 100,
- *   singleQuote: true,
- *   importOrder: ["<THIRD_PARTY_MODULES>", "^[./]"],
- *   },
- *   } satisfies ITtscLintConfig;
- *
- *   Deviations from Prettier:
- *   - `endOfLine` is restricted to `"lf"` and `"crlf"`. Prettier's
- *   `"cr"` and `"auto"` modes are intentionally unsupported — the
- *   printer does not auto-detect terminators.
- *   - Many Prettier knobs (`bracketSpacing`, `arrowParens`,
- *   `quoteProps`, JSX-specific switches) are not yet implemented.
- *
- *   Rule enablement matrix (when the `format` block is present):
- *
- *   - `format/semi` — always on. `semi: false` flips it to `prefer:
- *   "never"`.
- *   - `format/quotes` — always on. `singleQuote: true` flips to
- *   `prefer: "single"`.
- *   - `format/trailing-comma` — always on. `trailingComma: "none"`
- *   disables the rule's edits without removing the surface.
- *   - `format/print-width` — always on, driven by `printWidth`,
- *   `tabWidth`, `useTabs`, `endOfLine`.
- *   - `format/sort-imports` — opt-in. Setting `importOrder` enables it.
- *   - `format/jsdoc` — opt-in. Setting `jsdoc` enables it.
- *
- *   Format findings produced from this block are off by default. Set `severity`
- *   only when a project intentionally wants check-time format diagnostics.
  */
 export interface ITtscLintFormat {
     /**
@@ -76,6 +42,37 @@ export interface ITtscLintFormat {
      * @default false
      */
     singleQuote?: boolean;
+    /**
+     * Parenthesize a single arrow-function parameter. Mirrors Prettier's
+     * `arrowParens`. `"always"` (the default) keeps `(x) => x`; `"avoid"` strips
+     * the parentheses of a single bare-identifier parameter, giving `x => x`. A
+     * typed, destructured, rest, optional, defaulted, or multi-parameter list
+     * keeps its parentheses in both modes.
+     *
+     * @default "always"
+     */
+    arrowParens?: "always" | "avoid";
+    /**
+     * Pad the inside of single-line braces with one space. Mirrors Prettier's
+     * `bracketSpacing`. `true` (the default) gives `{ x: 1 }`, `import { foo }`;
+     * `false` gives `{x: 1}`, `import {foo}`. Applies to object literals, object
+     * destructuring patterns, named imports/exports, and type literals; block,
+     * class, interface, and enum braces are unaffected.
+     *
+     * @default true
+     */
+    bracketSpacing?: boolean;
+    /**
+     * Quoting policy for object-literal property keys. Mirrors Prettier's
+     * `quoteProps`. `"as-needed"` (the default) removes quotes from a key that is
+     * a valid identifier (`{ "foo": 1 }` becomes `{ foo: 1 }`), keeping them on
+     * non-identifier or numeric keys (`"bar-baz"`, `"123"`). `"consistent"` keeps
+     * every key quoted when any one of them requires quotes. `"preserve"` never
+     * changes quoting.
+     *
+     * @default "as-needed"
+     */
+    quoteProps?: "as-needed" | "consistent" | "preserve";
     /**
      * Trailing-comma policy. Mirrors Prettier's `trailingComma`. The `"none"`
      * mode disables the rule's edits.
@@ -111,43 +108,21 @@ export interface ITtscLintFormat {
      */
     endOfLine?: "lf" | "crlf";
     /**
-     * Group order for `format/sort-imports`. Setting this enables the rule;
-     * mirrors `@trivago/prettier-plugin-sort-imports`' `importOrder`. The
-     * `<THIRD_PARTY_MODULES>` literal is the catch-all placeholder for specifiers
-     * that match no other group.
-     */
-    importOrder?: readonly ("<THIRD_PARTY_MODULES>" | (string & {}))[];
-    /**
-     * Insert blank line between sort-imports groups.
-     *
-     * @default true
-     */
-    importOrderSeparation?: boolean;
-    /**
-     * Sort named import specifiers alphabetically within each declaration.
-     *
-     * @default true
-     */
-    importOrderSortSpecifiers?: boolean;
-    /**
-     * Case-insensitive comparison for sort-imports.
+     * Import sorting & merging. Off unless present; `true` enables it with
+     * defaults, an object customizes.
      *
      * @default false
      */
-    importOrderCaseInsensitive?: boolean;
+    sortImports?: boolean | ITtscLintFormatSortImports;
     /**
-     * Enable `format/jsdoc`. Pass `true` to turn it on with built-in defaults, or
-     * an object to customize:
+     * JSDoc tag normalization. On by default like the rest of the format set;
+     * pass `false` to disable, or an object to customize.
      *
-     * - `tagSynonyms` — extra `from → to` rewrites layered on the built-in synonym
-     *   table.
-     * - `sortTags` — sort JSDoc tags into canonical order (reserved; today's MVP
-     *   only rewrites tag names).
+     * Today it only rewrites tag synonyms (`@return` → `@returns`, `@arg` →
+     * `@param`, ...); tag sorting, `@param` column alignment, and description
+     * wrapping are on the roadmap.
      *
-     * @default false (off)
+     * @default true
      */
-    jsdoc?: boolean | {
-        tagSynonyms?: Record<string, string>;
-        sortTags?: boolean;
-    };
+    jsDoc?: boolean | ITtscLintFormatJsDoc;
 }

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,15 @@
+/** 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/format/ITtscLintFormatJsDoc.js

@@ -0,0 +1,3 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+//# 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,5 +1,5 @@
 export * from "./ITtscLintConfig";
-export * from "./ITtscLintFormat";
+export * from "./format";
 export * from "./ITtscLintPlugin";
 export * from "./ITtscLintPluginConfig";
 export * from "./ITtscLintPluginMeta";

package/lib/structures/index.js

@@ -15,7 +15,7 @@ var __exportStar = (this && this.__exportStar) || function(m, exports) {
 };
 Object.defineProperty(exports, "__esModule", { value: true });
 __exportStar(require("./ITtscLintConfig"), exports);
-__exportStar(require("./ITtscLintFormat"), exports);
+__exportStar(require("./format"), exports);
 __exportStar(require("./ITtscLintPlugin"), exports);
 __exportStar(require("./ITtscLintPluginConfig"), exports);
 __exportStar(require("./ITtscLintPluginMeta"), exports);

package/lib/structures/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/structures/index.ts"],"names":[],"mappings":";;;;;;;;;;;;;;;;AAAA,oDAAkC;AAClC,oDAAkC;AAClC,oDAAkC;AAClC,0DAAwC;AACxC,wDAAsC;AACtC,wDAAsC;AACtC,qDAAmC;AACnC,0CAAwB"}
+{"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

@@ -1,11 +1,10 @@
 /**
  * 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.
+ * 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
  */
@@ -14,28 +13,25 @@ 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.
+     * 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`.
+     * 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`.
+     * 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.
-     */
+    /** 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[];
@@ -49,9 +45,7 @@ export interface ITtscLintBoundariesElementTypesRule {
  * `boundaries/*` rule.
  */
 export interface ITtscLintBoundariesElementsOptions {
-    /**
-     * Source path elements used to classify importers and imported files.
-     */
+    /** Source path elements used to classify importers and imported files. */
     elements?: readonly ITtscLintBoundariesElement[];
 }
 /** `boundaries/element-types` rule options. */
@@ -67,10 +61,7 @@ export interface ITtscLintBoundariesElementTypesRuleOptions extends ITtscLintBou
 }
 /** `boundaries/external` rule options. */
 export interface ITtscLintBoundariesExternalRuleOptions {
-    /**
-     * External package/specifier patterns that are allowed. Empty means
-     * all.
-     */
+    /** 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[];
@@ -87,10 +78,10 @@ export type ITtscLintBoundariesNoUnknownRuleOptions = ITtscLintBoundariesElement
  * `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`).
+ * `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 {
     /**

package/lib/structures/rules/ITtscLintBoundariesRuleOptions.js

@@ -2,11 +2,10 @@
 /**
  * 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.
+ * 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
  */

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

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