@eslint-sh/eslint-plugin 0.3.0 → 0.4.0

package/README.md

@@ -27,14 +27,14 @@ suppress it: for a rule you've configured as `sh/your-rule`,
 - `plugin` (default export) — `{ meta: { name, version, namespace: "sh" }, languages: { sh:
 ShellLanguage }, rules: {} }`. `meta.version` always matches this package's `package.json`.
 - `ShellLanguage` — the `@eslint/core` `Language` implementation: `fileType: "text"`,
-  `lineStart`/`columnStart: 1`, `nodeTypeKey: "type"`, the bridge's generated `visitorKeys`,
+  `lineStart`/`columnStart: 1`, `nodeTypeKey: "type"`, the consumer's schema-derived `visitorKeys`,
   `validateLanguageOptions`/`normalizeLanguageOptions` for the
   `{dialect, shellVersion, directivePrefix}` schema, `parse`/`createSourceCode`, and
   `matchesSelectorClass` for the six launch esquery selector classes (`:command`, `:loop`,
   `:conditional`, `:expansion`, `:quoted`, `:function` — see the
   [selector cookbook](./docs/selectors.md)).
 - `ShellSourceCode` — extends `@eslint/plugin-kit`'s `TextSourceCodeBase`; implements `traverse()`
-  (driven by the bridge's `visitorKeys`, yielding two-phase `VisitNodeStep`s), `getParent()`, and
+  (driven by the consumer's `visitorKeys`, yielding two-phase `VisitNodeStep`s), `getParent()`, and
   the disable-directive surface (`getDisableDirectives()`, `getInlineConfigNodes()`,
   `applyInlineConfig()`).
 - `ShellLanguageOptions` / `NormalizedShellLanguageOptions` / `ShellLanguageOptionsJSON` — the
@@ -42,13 +42,17 @@ ShellLanguage }, rules: {} }`. `meta.version` always matches this package's `pac
   prefix directive/inline-config comments must start with — e.g. the default `"eslint"` recognizes
   `# eslint-disable-next-line ...`; consumers who already overload `# eslint-*` comments for
   something else can configure a different prefix (e.g. `directivePrefix: 'shellcheck-sh'`).
-- `resolveWord` — re-export of `sh-ast`'s word-resolution helper, so a project that installs only
+- `ShellNode` / `ShellFile` / `ShellComment` / `ShellPosition` — the plugin's lint view: lowercase
+  fields, UTF-16 ranges, and one-based UTF-16 locations, independent of the raw parser syntax.
+  Locations come from one parse-time position snapshot and remain bound to that original source;
+  projecting the view does not run live bounds operations on every syntax subtree.
+- `resolveWord` — adapts a parsed lint Word to `sh-ast`'s word-resolution helper, so a project that installs only
   this package can write custom rules that resolve static shell words (e.g. the `no-rm-rf` example
   in the [custom-rule tutorial](./docs/custom-rule-tutorial.md)) without a separate `sh-ast`
-  install.
+  install. Fabricated nodes are rejected because they have no original syntax association.
 
-Parse failures surface as fatal lint messages at mvdan/sh's real reported position (never a 1:1
-placeholder) — see `ShParseError` in `sh-ast`.
+Syntax failures surface as fatal lint messages at mvdan/sh's reported byte offset, converted to
+the source's UTF-16 location. Failures without a valid syntax position use a 1:1 fallback.
 
 ## Writing your own rules
 

package/dist/eslint-plugin.d.ts

@@ -4,32 +4,26 @@ import type { FileProblem } from '@eslint/core';
 import type { Language } from '@eslint/core';
 import type { OkParseResult } from '@eslint/core';
 import type { ParseResult } from '@eslint/core';
-import { resolveWord as resolveWord_2 } from 'sh-ast/analyze';
+import type { ResolveWordOptions } from 'sh-ast/analyze';
 import type { RulesConfig } from '@eslint/core';
-import type { ShellDialect } from 'sh-ast';
-import type { ShFile } from 'sh-ast';
-import type { ShNode } from 'sh-ast';
-import type { ShNodes } from 'sh-ast';
 import type { SourceLocation } from '@eslint/core';
 import { TextSourceCodeBase } from '@eslint/plugin-kit';
 import type { TraversalStep } from '@eslint/core';
+import type { WordResolution } from 'sh-ast/analyze';
 
 /**
- * The `@eslint-sh/eslint-plugin` plugin object (design/PACKAGES.md,
- * `@eslint-sh/eslint-plugin`): `languages.sh` provides `ShellLanguage` /
- * `ShellSourceCode` (design/ARCHITECTURE.md, "SourceCode and Language
- * objects"), selected in a flat config via `language: "sh/sh"`
- * (`namespace: "sh"`). `meta.version` is read from this package's own
- * `package.json` at runtime — never hardcoded (see `version.ts`).
+ * The `@eslint-sh/eslint-plugin` plugin object: `languages.sh` provides
+ * `ShellLanguage` / `ShellSourceCode`, selected in a flat config via
+ * `language: "sh/sh"` (`namespace: "sh"`). `meta.version` is read from this
+ * package's own `package.json` at runtime — never hardcoded (see
+ * `version.ts`).
  *
- * `rules` is empty at this milestone (M2 — `ShellLanguage`/`ShellSourceCode`
- * core, plus the six launch esquery selector classes); rules and shared
- * `configs` are Milestone 3 (design/MILESTONES.md). Adding them later is
- * additive, not a breaking change to this object's shape.
+ * The empty `rules` registry lets consumers supply their own rules while
+ * sharing parsing, selectors, source coordinates, and directive semantics.
  *
  * Re-exported, unchanged, as the default export of the `eslint-sh` umbrella
- * package (design/PACKAGES.md's Naming decision): importing this package or
- * the umbrella package both yield the same plugin object.
+ * package: importing this package or the umbrella package both yield the
+ * same plugin object.
  */
 declare const _default: {
     meta: {
@@ -64,24 +58,38 @@ export declare interface NormalizedShellLanguageOptions extends Record<string, u
 }
 
 /**
- * Re-exported from `sh-ast/analyze` so a project that installs only
- * `@eslint-sh/eslint-plugin` can write custom rules that resolve static
- * shell words (e.g. `docs/custom-rule-tutorial.md`'s `no-rm-rf` example)
- * without a separate `sh-ast` install or relying on npm hoisting to make
- * `sh-ast` resolvable from the consumer's own `node_modules`. Declared
- * locally (instead of a bare re-export statement) so API Extractor
- * attaches this doc comment and its public release tag to the committed
- * api-report instead of emitting it as an untagged export.
- *
+ * Resolves a parsed lint Word using the upstream-shaped syntax associated with it.
+ * The view supplies locations and selector fields; sh-ast/analyze owns the word
+ * interpretation. Fabricated or synthetic view nodes have no source syntax and
+ * are rejected instead of being treated as known or unknown shell values.
  * @public
  */
-export declare const resolveWord: typeof resolveWord_2;
+export declare function resolveWord(word: ShellNode, options?: ResolveWordOptions): WordResolution;
+
+/** Directive processing uses the comment text without its leading shell hash. @public */
+export declare interface ShellComment extends ShellNode {
+    /** Comment discriminator used by directive collection. */
+    readonly type: 'Comment';
+    /** Decoded comment content after the leading hash, preserving its whitespace. */
+    readonly text: string;
+}
+
+/** Owns ESLint configuration labels and validates their consumer-facing meaning before parsing. */
+/** The dialect labels understood by ESLint configuration, mapped to upstream numeric variants when parsing. @public */
+export declare type ShellDialect = 'bash' | 'posix' | 'mksh' | 'bats' | 'zsh';
+
+/** The lint root has a statement collection even when upstream represents it as nil. @public */
+export declare interface ShellFile extends ShellNode {
+    /** Root discriminator retained for selectors. */
+    readonly type: 'File';
+    /** Top-level statements in source order; nil upstream slices become an empty view. */
+    readonly stmts: readonly ShellNode[];
+}
 
 /**
  * `ShellLanguage` — the `@eslint/core` `Language` implementation for shell
- * scripts (design/ARCHITECTURE.md, "SourceCode and Language objects";
- * design/PACKAGES.md, `@eslint-sh/eslint-plugin`). Registered by the plugin
- * as `languages.sh`, so consumers select it via `language: "sh/sh"`.
+ * scripts. Registered by the plugin as `languages.sh`, so consumers select
+ * it via `language: "sh/sh"`.
  *
  * Implements `matchesSelectorClass` (the six launch esquery selector
  * classes — see `./selector-classes.js`), so rules and end users can write
@@ -124,23 +132,22 @@ export declare class ShellLanguage implements Language {
      * needed there, but `:loop :command` is) match a whole family of node
      * types instead of one literal type name. Delegates to
      * `./selector-classes.js`'s `SELECTOR_CLASS_NODE_TYPES` table for the six
-     * launch classes (design/ARCHITECTURE.md, "SourceCode and Language
-     * objects"); `ancestry` is unused today because none of the six launch
+     * launch classes; `ancestry` is unused today because none of the six launch
      * classes need ancestor context, but the parameter is accepted to match
      * `Language.matchesSelectorClass`'s signature exactly.
      */
-    matchesSelectorClass(className: string, node: ShNode, _ancestry: ShNode[]): boolean;
+    matchesSelectorClass(className: string, node: ShellNode, _ancestry: ShellNode[]): boolean;
     /**
      * Parses `file.body` (guaranteed to be a `string`, since `fileType` is
-     * `"text"`) via `sh-ast`'s `parseSync`, mapping the result to
+     * `"text"`) with one synchronous parse and its original-position snapshot,
+     * mapping the result to
      * the `{ok: true, ast}` / `{ok: false, errors}` shape `Language.parse` is
      * required to return. Never throws — parse failures are reported as
-     * fatal lint messages, per the `Language` contract
-     * (design/ARCHITECTURE.md, "Parse errors and dialects").
+     * fatal lint messages, per the `Language` contract.
      */
     parse(file: File_2, context: {
         languageOptions: ShellLanguageOptions;
-    }): ParseResult<ShFile>;
+    }): ParseResult<ShellFile>;
     /**
      * Creates the `ShellSourceCode` ESLint uses to run rules against `ast`.
      * `context.languageOptions` is ESLint's already-normalized copy (see
@@ -152,18 +159,16 @@ export declare class ShellLanguage implements Language {
      * direct construction (e.g. tests that skip the `Language` normalization
      * step), mirroring `parse()`'s `dialect` default above.
      */
-    createSourceCode(file: File_2, parseResult: OkParseResult<ShFile>, context: {
+    createSourceCode(file: File_2, parseResult: OkParseResult<ShellFile>, context: {
         languageOptions: ShellLanguageOptions;
     }): ShellSourceCode;
 }
 
 /**
- * `languageOptions` accepted by {@link ShellLanguage} (design/PACKAGES.md's
- * `languageOptions` schema): `dialect` selects mvdan/sh's `LangVariant` by
- * string name (default `"bash"`); `shellVersion` is consumed by the
- * rule layer (e.g. the bash-3.2 compatibility pack), never by the parser
- * itself (see design/ARCHITECTURE.md, "A verified nuance worth stating
- * loudly").
+ * `languageOptions` accepted by {@link ShellLanguage}: `dialect` selects
+ * mvdan/sh's `LangVariant` through a consumer-owned mapping (default `"bash"`); `shellVersion`
+ * is consumed by the rule layer (e.g. the bash-3.2 compatibility pack),
+ * never by the parser itself.
  *
  * Extends `Record<string, unknown>` (rather than a bare interface) so this
  * type satisfies the `@eslint/core` package's `LanguageOptions` bound
@@ -182,8 +187,7 @@ export declare interface ShellLanguageOptions extends Record<string, unknown> {
      * default `"eslint"` recognizes `# eslint-disable-next-line ...` and
      * `# eslint <rule-config>`. Consumers who embed shell-linting inside a
      * larger toolchain that already overloads `#eslint-*` comments for
-     * something else can configure a different prefix (design/ARCHITECTURE.md,
-     * "SourceCode and Language objects").
+     * something else can configure a different prefix.
      * @defaultValue `"eslint"`
      */
     readonly directivePrefix?: string;
@@ -212,13 +216,40 @@ export declare interface ShellLanguageOptionsJSON {
     readonly shellVersion?: string;
 }
 
+/**
+ * A node in the consumer's lint view. Scalar/child fields use lowercase upstream
+ * spellings; syntax fidelity belongs to the associated upstream tree. Auxiliary
+ * view nodes may have spans derived from children and are not upstream Nodes.
+ * @public
+ */
+export declare interface ShellNode {
+    /** Original syntax kind retained as the discriminator for lint selectors. */
+    readonly type: string;
+    /** Half-open UTF-16 span used to slice source and place fixes. */
+    readonly range: readonly [number, number];
+    /** Source-derived endpoints for ESLint diagnostics. */
+    readonly loc: {
+        readonly start: ShellPosition;
+        readonly end: ShellPosition;
+    };
+    /** Lowercase syntax fields containing consumer children or decoded scalar values. */
+    readonly [field: string]: unknown;
+}
+
+/** An ESLint location counts UTF-16 units, with both line and column starting at one. @public */
+export declare interface ShellPosition {
+    /** One-based source line, with CRLF treated as one line break. */
+    readonly line: number;
+    /** One-based UTF-16 column; tabs and grapheme widths are not expanded. */
+    readonly column: number;
+}
+
 /**
  * `ShellSourceCode` — the `SourceCode` object ESLint uses to work with a
- * parsed shell file (design/ARCHITECTURE.md, "SourceCode and Language
- * objects"). Extends `@eslint/plugin-kit`'s `TextSourceCodeBase`, which
+ * parsed shell file. Extends `@eslint/plugin-kit`'s `TextSourceCodeBase`, which
  * already implements `getLoc`/`getRange`/`getText`/`lines` (both by reading
  * the normalized node's own `loc`/`range` fields — see
- * `sh-ast`'s "Normalized node shape"), `getLocFromIndex`, and
+ * the consumer's source-view contract), `getLocFromIndex`, and
  * `getIndexFromLoc`; this class adds the two members the base class
  * deliberately leaves unimplemented: `traverse()` (base throws "Not
  * implemented") and `getParent()` (base throws "Not implemented", and
@@ -230,7 +261,7 @@ export declare interface ShellLanguageOptionsJSON {
  * (`<prefix>-disable`, `<prefix>-enable`, `<prefix>-disable-line`,
  * `<prefix>-disable-next-line`) plus whole-file inline rule config
  * (bare `<prefix> <rule-config>`), sourced from `Comment` nodes gathered via
- * `sh-ast`'s structural `walk()` and parsed with
+ * the consumer's `walkShell()` and parsed with
  * `@eslint/plugin-kit`'s `ConfigCommentParser` — the same building blocks
  * `@eslint/json`'s `JSONSourceCode` uses, generalized so the `<prefix>` is
  * configurable (default `"eslint"`; see `ShellLanguageOptions.directivePrefix`)
@@ -244,14 +275,14 @@ export declare interface ShellLanguageOptionsJSON {
  */
 export declare class ShellSourceCode extends TextSourceCodeBase<{
     LangOptions: ShellLanguageOptions;
-    RootNode: ShFile;
-    SyntaxElementWithLoc: ShNode;
-    ConfigNode: ShNodes.ShCommentNode;
+    RootNode: ShellFile;
+    SyntaxElementWithLoc: ShellNode;
+    ConfigNode: ShellComment;
 }> {
     #private;
     constructor(options: {
         text: string;
-        ast: ShFile;
+        ast: ShellFile;
         directivePrefix?: string;
     });
     /**
@@ -261,19 +292,11 @@ export declare class ShellSourceCode extends TextSourceCodeBase<{
      * so in practice the map is always populated by the time a rule observes
      * it.
      */
-    getParent(node: ShNode): ShNode | undefined;
+    getParent(node: ShellNode): ShellNode | undefined;
     /**
-     * Traverses the AST pre-order, yielding a `VisitNodeStep` on node enter
-     * (`phase: 1`) and another on node exit (`phase: 2`) for every node —
-     * exactly the two-phase shape `@eslint/json`/`@eslint/css` produce, which
-     * is what lets rule listeners use `NodeType` and `NodeType:exit` esquery
-     * selectors. Children are discovered via `sh-ast`'s generated,
-     * frozen `visitorKeys` table (per node `type`) — **not** structurally
-     * (contrast `sh-ast`'s own `walk()`, which deliberately walks
-     * structurally so its correctness never depends on that table) — because
-     * ESLint's traversal contract is defined in terms of a language's
-     * declared `visitorKeys`, and this class's whole job is to honor that
-     * contract for shell ASTs.
+     * Produces the enter/exit steps ESLint uses for selectors and ancestor lookup.
+     * Child keys describe the consumer view, including its auxiliary records.
+     * This callback protocol is ESLint's, independent of upstream syntax.Walk.
      */
     traverse(): Iterable<TraversalStep>;
     /**
@@ -284,7 +307,7 @@ export declare class ShellSourceCode extends TextSourceCodeBase<{
      * effect" when `linterOptions.noInlineConfig` is set — see
      * `eslint`'s `lib/linter/linter.js`, the `warnInlineConfig` branch).
      */
-    getInlineConfigNodes(): ShNodes.ShCommentNode[];
+    getInlineConfigNodes(): ShellComment[];
     /**
      * Returns the disable/enable directives found among
      * {@link ShellSourceCode.getInlineConfigNodes}'s comments, recognizing all four forms —
@@ -316,7 +339,7 @@ export declare class ShellSourceCode extends TextSourceCodeBase<{
      * calling this method — and `getDisableDirectives`, together, since both
      * are gated by the same flag in `eslint`'s own `linter.js` — and instead
      * calls `getInlineConfigNodes` to emit a "has no effect" warning per
-     * comment; see design/ARCHITECTURE.md, "SourceCode and Language objects").
+     * comment).
      */
     applyInlineConfig(): {
         configs: {

package/dist/index.d.ts

@@ -1,37 +1,23 @@
-import { resolveWord as shAstResolveWord } from 'sh-ast/analyze';
 import { ShellLanguage } from './language/shell-language.js';
 export { ShellLanguage } from './language/shell-language.js';
 export { ShellSourceCode } from './language/shell-source-code.js';
 export type { NormalizedShellLanguageOptions, ShellLanguageOptions, ShellLanguageOptionsJSON, } from './language/shell-language-options.js';
+export { resolveWord } from './language/word-resolution.js';
+export type { ShellFile, ShellNode, ShellComment, ShellPosition } from './language/syntax-view.js';
+export type { ShellDialect } from './language/shell-language-options.js';
 /**
- * Re-exported from `sh-ast/analyze` so a project that installs only
- * `@eslint-sh/eslint-plugin` can write custom rules that resolve static
- * shell words (e.g. `docs/custom-rule-tutorial.md`'s `no-rm-rf` example)
- * without a separate `sh-ast` install or relying on npm hoisting to make
- * `sh-ast` resolvable from the consumer's own `node_modules`. Declared
- * locally (instead of a bare re-export statement) so API Extractor
- * attaches this doc comment and its public release tag to the committed
- * api-report instead of emitting it as an untagged export.
+ * The `@eslint-sh/eslint-plugin` plugin object: `languages.sh` provides
+ * `ShellLanguage` / `ShellSourceCode`, selected in a flat config via
+ * `language: "sh/sh"` (`namespace: "sh"`). `meta.version` is read from this
+ * package's own `package.json` at runtime — never hardcoded (see
+ * `version.ts`).
  *
- * @public
- */
-export declare const resolveWord: typeof shAstResolveWord;
-/**
- * The `@eslint-sh/eslint-plugin` plugin object (design/PACKAGES.md,
- * `@eslint-sh/eslint-plugin`): `languages.sh` provides `ShellLanguage` /
- * `ShellSourceCode` (design/ARCHITECTURE.md, "SourceCode and Language
- * objects"), selected in a flat config via `language: "sh/sh"`
- * (`namespace: "sh"`). `meta.version` is read from this package's own
- * `package.json` at runtime — never hardcoded (see `version.ts`).
- *
- * `rules` is empty at this milestone (M2 — `ShellLanguage`/`ShellSourceCode`
- * core, plus the six launch esquery selector classes); rules and shared
- * `configs` are Milestone 3 (design/MILESTONES.md). Adding them later is
- * additive, not a breaking change to this object's shape.
+ * The empty `rules` registry lets consumers supply their own rules while
+ * sharing parsing, selectors, source coordinates, and directive semantics.
  *
  * Re-exported, unchanged, as the default export of the `eslint-sh` umbrella
- * package (design/PACKAGES.md's Naming decision): importing this package or
- * the umbrella package both yield the same plugin object.
+ * package: importing this package or the umbrella package both yield the
+ * same plugin object.
  */
 declare const _default: {
     meta: {

package/dist/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,WAAW,IAAI,gBAAgB,EAAE,MAAM,gBAAgB,CAAC;AACjE,OAAO,EAAE,aAAa,EAAE,MAAM,8BAA8B,CAAC;AAG7D,OAAO,EAAE,aAAa,EAAE,MAAM,8BAA8B,CAAC;AAC7D,OAAO,EAAE,eAAe,EAAE,MAAM,iCAAiC,CAAC;AAClE,YAAY,EACV,8BAA8B,EAC9B,oBAAoB,EACpB,wBAAwB,GACzB,MAAM,sCAAsC,CAAC;AAE9C;;;;;;;;;;;GAWG;AACH,eAAO,MAAM,WAAW,yBAAmB,CAAC;AAE5C;;;;;;;;;;;;;;;;GAgBG;;;;;;;;;;;;AACH,wBAUmB"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,aAAa,EAAE,MAAM,8BAA8B,CAAC;AAG7D,OAAO,EAAE,aAAa,EAAE,MAAM,8BAA8B,CAAC;AAC7D,OAAO,EAAE,eAAe,EAAE,MAAM,iCAAiC,CAAC;AAClE,YAAY,EACV,8BAA8B,EAC9B,oBAAoB,EACpB,wBAAwB,GACzB,MAAM,sCAAsC,CAAC;AAE9C,OAAO,EAAE,WAAW,EAAE,MAAM,+BAA+B,CAAC;AAC5D,YAAY,EAAE,SAAS,EAAE,SAAS,EAAE,YAAY,EAAE,aAAa,EAAE,MAAM,2BAA2B,CAAC;AACnG,YAAY,EAAE,YAAY,EAAE,MAAM,sCAAsC,CAAC;AAEzE;;;;;;;;;;;;;GAaG;;;;;;;;;;;;AACH,wBAUmB"}

package/dist/index.js

@@ -1,37 +1,21 @@
-import { resolveWord as shAstResolveWord } from 'sh-ast/analyze';
 import { ShellLanguage } from './language/shell-language.js';
 import { readPackageVersion } from './version.js';
 export { ShellLanguage } from './language/shell-language.js';
 export { ShellSourceCode } from './language/shell-source-code.js';
+export { resolveWord } from './language/word-resolution.js';
 /**
- * Re-exported from `sh-ast/analyze` so a project that installs only
- * `@eslint-sh/eslint-plugin` can write custom rules that resolve static
- * shell words (e.g. `docs/custom-rule-tutorial.md`'s `no-rm-rf` example)
- * without a separate `sh-ast` install or relying on npm hoisting to make
- * `sh-ast` resolvable from the consumer's own `node_modules`. Declared
- * locally (instead of a bare re-export statement) so API Extractor
- * attaches this doc comment and its public release tag to the committed
- * api-report instead of emitting it as an untagged export.
+ * The `@eslint-sh/eslint-plugin` plugin object: `languages.sh` provides
+ * `ShellLanguage` / `ShellSourceCode`, selected in a flat config via
+ * `language: "sh/sh"` (`namespace: "sh"`). `meta.version` is read from this
+ * package's own `package.json` at runtime — never hardcoded (see
+ * `version.ts`).
  *
- * @public
- */
-export const resolveWord = shAstResolveWord;
-/**
- * The `@eslint-sh/eslint-plugin` plugin object (design/PACKAGES.md,
- * `@eslint-sh/eslint-plugin`): `languages.sh` provides `ShellLanguage` /
- * `ShellSourceCode` (design/ARCHITECTURE.md, "SourceCode and Language
- * objects"), selected in a flat config via `language: "sh/sh"`
- * (`namespace: "sh"`). `meta.version` is read from this package's own
- * `package.json` at runtime — never hardcoded (see `version.ts`).
- *
- * `rules` is empty at this milestone (M2 — `ShellLanguage`/`ShellSourceCode`
- * core, plus the six launch esquery selector classes); rules and shared
- * `configs` are Milestone 3 (design/MILESTONES.md). Adding them later is
- * additive, not a breaking change to this object's shape.
+ * The empty `rules` registry lets consumers supply their own rules while
+ * sharing parsing, selectors, source coordinates, and directive semantics.
  *
  * Re-exported, unchanged, as the default export of the `eslint-sh` umbrella
- * package (design/PACKAGES.md's Naming decision): importing this package or
- * the umbrella package both yield the same plugin object.
+ * package: importing this package or the umbrella package both yield the
+ * same plugin object.
  */
 export default {
     meta: {

package/dist/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,WAAW,IAAI,gBAAgB,EAAE,MAAM,gBAAgB,CAAC;AACjE,OAAO,EAAE,aAAa,EAAE,MAAM,8BAA8B,CAAC;AAC7D,OAAO,EAAE,kBAAkB,EAAE,MAAM,cAAc,CAAC;AAElD,OAAO,EAAE,aAAa,EAAE,MAAM,8BAA8B,CAAC;AAC7D,OAAO,EAAE,eAAe,EAAE,MAAM,iCAAiC,CAAC;AAOlE;;;;;;;;;;;GAWG;AACH,MAAM,CAAC,MAAM,WAAW,GAAG,gBAAgB,CAAC;AAE5C;;;;;;;;;;;;;;;;GAgBG;AACH,eAAe;IACb,IAAI,EAAE;QACJ,IAAI,EAAE,0BAA0B;QAChC,OAAO,EAAE,kBAAkB,EAAE;QAC7B,SAAS,EAAE,IAAI;KAChB;IACD,SAAS,EAAE;QACT,EAAE,EAAE,IAAI,aAAa,EAAE;KACxB;IACD,KAAK,EAAE,EAAE;CACO,CAAC"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,aAAa,EAAE,MAAM,8BAA8B,CAAC;AAC7D,OAAO,EAAE,kBAAkB,EAAE,MAAM,cAAc,CAAC;AAElD,OAAO,EAAE,aAAa,EAAE,MAAM,8BAA8B,CAAC;AAC7D,OAAO,EAAE,eAAe,EAAE,MAAM,iCAAiC,CAAC;AAOlE,OAAO,EAAE,WAAW,EAAE,MAAM,+BAA+B,CAAC;AAI5D;;;;;;;;;;;;;GAaG;AACH,eAAe;IACb,IAAI,EAAE;QACJ,IAAI,EAAE,0BAA0B;QAChC,OAAO,EAAE,kBAAkB,EAAE;QAC7B,SAAS,EAAE,IAAI;KAChB;IACD,SAAS,EAAE;QACT,EAAE,EAAE,IAAI,aAAa,EAAE;KACxB;IACD,KAAK,EAAE,EAAE;CACO,CAAC"}

package/dist/language/selector-classes.d.ts

@@ -1,8 +1,7 @@
-import type { ShNode } from 'sh-ast';
+import type { ShellNode as ShNode } from './syntax-view.js';
 /**
  * The six launch esquery selector classes `ShellLanguage.matchesSelectorClass`
- * implements (design/ARCHITECTURE.md, "SourceCode and Language objects";
- * the issue that introduced this module). Keys are the *bare* class name —
+ * implements. Keys are the *bare* class name —
  * esquery strips the leading `:` before invoking a language's
  * `matchesSelectorClass` (confirmed against `esquery`'s own `case 'class'`
  * matcher, which calls `options.matchClass(selector.name, node, ancestry)`
@@ -10,18 +9,15 @@ import type { ShNode } from 'sh-ast';
  * `:command` calls this table with `"command"`, not `":command"`.
  *
  * `:loop` intentionally matches only `ForClause` and `WhileClause` — the
- * two loop *statement* nodes, exactly as the bridge's generated schema
- * names them (`packages/bridge/generated/visitor-keys.js`), even though
- * design/ARCHITECTURE.md's prose shorthand says "For/While". `CStyleLoop`
+ * two loop *statement* nodes in the upstream syntax schema. `CStyleLoop`
  * is deliberately excluded from `:loop`: it is `ForClause.loop`'s nested
- * C-style arithmetic header (`init`/`cond`/`post` — see
- * `packages/bridge/generated/node-types.d.ts`'s `ShCStyleLoopNode`), not a
+ * C-style arithmetic header (`init`/`cond`/`post`), not a
  * loop statement in its own right. A `for ((i=0;i<3;i++))` loop's outer
  * node is still `ForClause`, so `:loop` already reaches every C-style loop
  * without needing to include `CStyleLoop` itself.
  *
- * `as const satisfies Record<string, readonly ShNodes.ShNodeTypeName[]>`
- * pins every listed node type to a real member of the bridge's generated
+ * `as const satisfies Record<string, readonly Node['Type'][]>`
+ * pins every listed node type to a real member of the parser's generated
  * type union — a typo or a since-renamed node type here is a compile error,
  * not a silent no-op match.
  *

package/dist/language/selector-classes.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"selector-classes.d.ts","sourceRoot":"","sources":["../../src/language/selector-classes.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,MAAM,EAAW,MAAM,QAAQ,CAAC;AAE9C;;;;;;;;;;;;;;;;;;;;;;;;;;;GA2BG;AACH,eAAO,MAAM,yBAAyB;;;;;;;CAOgC,CAAC;AAEvE;;;;;GAKG;AACH,MAAM,MAAM,iBAAiB,GAAG,MAAM,OAAO,yBAAyB,CAAC;AASvE;;;;;;;;;;GAUG;AACH,wBAAgB,oBAAoB,CAAC,SAAS,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,GAAG,OAAO,CAE7E"}
+{"version":3,"file":"selector-classes.d.ts","sourceRoot":"","sources":["../../src/language/selector-classes.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,SAAS,IAAI,MAAM,EAAE,MAAM,kBAAkB,CAAC;AAE5D;;;;;;;;;;;;;;;;;;;;;;;GAuBG;AACH,eAAO,MAAM,yBAAyB;;;;;;;CAOsB,CAAC;AAE7D;;;;;GAKG;AACH,MAAM,MAAM,iBAAiB,GAAG,MAAM,OAAO,yBAAyB,CAAC;AAUvE;;;;;;;;;;GAUG;AACH,wBAAgB,oBAAoB,CAAC,SAAS,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,GAAG,OAAO,CAE7E"}

package/dist/language/selector-classes.js

@@ -1,7 +1,6 @@
 /**
  * The six launch esquery selector classes `ShellLanguage.matchesSelectorClass`
- * implements (design/ARCHITECTURE.md, "SourceCode and Language objects";
- * the issue that introduced this module). Keys are the *bare* class name —
+ * implements. Keys are the *bare* class name —
  * esquery strips the leading `:` before invoking a language's
  * `matchesSelectorClass` (confirmed against `esquery`'s own `case 'class'`
  * matcher, which calls `options.matchClass(selector.name, node, ancestry)`
@@ -9,18 +8,15 @@
  * `:command` calls this table with `"command"`, not `":command"`.
  *
  * `:loop` intentionally matches only `ForClause` and `WhileClause` — the
- * two loop *statement* nodes, exactly as the bridge's generated schema
- * names them (`packages/bridge/generated/visitor-keys.js`), even though
- * design/ARCHITECTURE.md's prose shorthand says "For/While". `CStyleLoop`
+ * two loop *statement* nodes in the upstream syntax schema. `CStyleLoop`
  * is deliberately excluded from `:loop`: it is `ForClause.loop`'s nested
- * C-style arithmetic header (`init`/`cond`/`post` — see
- * `packages/bridge/generated/node-types.d.ts`'s `ShCStyleLoopNode`), not a
+ * C-style arithmetic header (`init`/`cond`/`post`), not a
  * loop statement in its own right. A `for ((i=0;i<3;i++))` loop's outer
  * node is still `ForClause`, so `:loop` already reaches every C-style loop
  * without needing to include `CStyleLoop` itself.
  *
- * `as const satisfies Record<string, readonly ShNodes.ShNodeTypeName[]>`
- * pins every listed node type to a real member of the bridge's generated
+ * `as const satisfies Record<string, readonly Node['Type'][]>`
+ * pins every listed node type to a real member of the parser's generated
  * type union — a typo or a since-renamed node type here is a compile error,
  * not a silent no-op match.
  *
@@ -34,6 +30,7 @@ export const SELECTOR_CLASS_NODE_TYPES = {
     quoted: ['SglQuoted', 'DblQuoted'],
     function: ['FuncDecl'],
 };
+/** Membership is independent of syntax field values or source positions. */
 const nodeTypesByClassName = new Map(Object.entries(SELECTOR_CLASS_NODE_TYPES).map(([className, nodeTypes]) => [
     className,
     new Set(nodeTypes),

package/dist/language/selector-classes.js.map

@@ -1 +1 @@
-{"version":3,"file":"selector-classes.js","sourceRoot":"","sources":["../../src/language/selector-classes.ts"],"names":[],"mappings":"AAEA;;;;;;;;;;;;;;;;;;;;;;;;;;;GA2BG;AACH,MAAM,CAAC,MAAM,yBAAyB,GAAG;IACvC,OAAO,EAAE,CAAC,UAAU,CAAC;IACrB,IAAI,EAAE,CAAC,WAAW,EAAE,aAAa,CAAC;IAClC,WAAW,EAAE,CAAC,UAAU,EAAE,YAAY,CAAC;IACvC,SAAS,EAAE,CAAC,UAAU,EAAE,UAAU,EAAE,WAAW,EAAE,WAAW,CAAC;IAC7D,MAAM,EAAE,CAAC,WAAW,EAAE,WAAW,CAAC;IAClC,QAAQ,EAAE,CAAC,UAAU,CAAC;CAC8C,CAAC;AAUvE,MAAM,oBAAoB,GAA6C,IAAI,GAAG,CAC5E,MAAM,CAAC,OAAO,CAAC,yBAAyB,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,SAAS,EAAE,SAAS,CAAC,EAAE,EAAE,CAAC;IACxE,SAAS;IACT,IAAI,GAAG,CAAS,SAAS,CAAC;CAC3B,CAAC,CACH,CAAC;AAEF;;;;;;;;;;GAUG;AACH,MAAM,UAAU,oBAAoB,CAAC,SAAiB,EAAE,IAAY;IAClE,OAAO,oBAAoB,CAAC,GAAG,CAAC,SAAS,CAAC,EAAE,GAAG,CAAC,IAAI,CAAC,IAAI,CAAC,IAAI,KAAK,CAAC;AACtE,CAAC"}
+{"version":3,"file":"selector-classes.js","sourceRoot":"","sources":["../../src/language/selector-classes.ts"],"names":[],"mappings":"AAIA;;;;;;;;;;;;;;;;;;;;;;;GAuBG;AACH,MAAM,CAAC,MAAM,yBAAyB,GAAG;IACvC,OAAO,EAAE,CAAC,UAAU,CAAC;IACrB,IAAI,EAAE,CAAC,WAAW,EAAE,aAAa,CAAC;IAClC,WAAW,EAAE,CAAC,UAAU,EAAE,YAAY,CAAC;IACvC,SAAS,EAAE,CAAC,UAAU,EAAE,UAAU,EAAE,WAAW,EAAE,WAAW,CAAC;IAC7D,MAAM,EAAE,CAAC,WAAW,EAAE,WAAW,CAAC;IAClC,QAAQ,EAAE,CAAC,UAAU,CAAC;CACoC,CAAC;AAU7D,4EAA4E;AAC5E,MAAM,oBAAoB,GAA6C,IAAI,GAAG,CAC5E,MAAM,CAAC,OAAO,CAAC,yBAAyB,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,SAAS,EAAE,SAAS,CAAC,EAAE,EAAE,CAAC;IACxE,SAAS;IACT,IAAI,GAAG,CAAS,SAAS,CAAC;CAC3B,CAAC,CACH,CAAC;AAEF;;;;;;;;;;GAUG;AACH,MAAM,UAAU,oBAAoB,CAAC,SAAiB,EAAE,IAAY;IAClE,OAAO,oBAAoB,CAAC,GAAG,CAAC,SAAS,CAAC,EAAE,GAAG,CAAC,IAAI,CAAC,IAAI,CAAC,IAAI,KAAK,CAAC;AACtE,CAAC"}

package/dist/language/shell-language-options.d.ts

@@ -1,11 +1,11 @@
-import type { ShellDialect } from 'sh-ast';
+/** Owns ESLint configuration labels and validates their consumer-facing meaning before parsing. */
+/** The dialect labels understood by ESLint configuration, mapped to upstream numeric variants when parsing. @public */
+export type ShellDialect = 'bash' | 'posix' | 'mksh' | 'bats' | 'zsh';
 /**
- * `languageOptions` accepted by {@link ShellLanguage} (design/PACKAGES.md's
- * `languageOptions` schema): `dialect` selects mvdan/sh's `LangVariant` by
- * string name (default `"bash"`); `shellVersion` is consumed by the
- * rule layer (e.g. the bash-3.2 compatibility pack), never by the parser
- * itself (see design/ARCHITECTURE.md, "A verified nuance worth stating
- * loudly").
+ * `languageOptions` accepted by {@link ShellLanguage}: `dialect` selects
+ * mvdan/sh's `LangVariant` through a consumer-owned mapping (default `"bash"`); `shellVersion`
+ * is consumed by the rule layer (e.g. the bash-3.2 compatibility pack),
+ * never by the parser itself.
  *
  * Extends `Record<string, unknown>` (rather than a bare interface) so this
  * type satisfies the `@eslint/core` package's `LanguageOptions` bound
@@ -24,8 +24,7 @@ export interface ShellLanguageOptions extends Record<string, unknown> {
      * default `"eslint"` recognizes `# eslint-disable-next-line ...` and
      * `# eslint <rule-config>`. Consumers who embed shell-linting inside a
      * larger toolchain that already overloads `#eslint-*` comments for
-     * something else can configure a different prefix (design/ARCHITECTURE.md,
-     * "SourceCode and Language objects").
+     * something else can configure a different prefix.
      * @defaultValue `"eslint"`
      */
     readonly directivePrefix?: string;
@@ -79,8 +78,7 @@ export interface NormalizedShellLanguageOptions extends Record<string, unknown>
  * nonexistent version like `'99.99'` is accepted — shape is validated, not
  * membership in a known-versions list), or when `directivePrefix` is present
  * but not a valid directive-comment label (see {@link DIRECTIVE_PREFIX_PATTERN}).
- * Unknown keys are silently ignored, per the ESLint `Language` contract
- * (design/ARCHITECTURE.md's `languageOptions` schema comment).
+ * Unknown keys are silently ignored, per the ESLint `Language` contract.
  *
  * The parameter is treated as `Record<string, unknown>` internally (rather
  * than trusting {@link ShellLanguageOptions}'s declared field types) because

package/dist/language/shell-language-options.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"shell-language-options.d.ts","sourceRoot":"","sources":["../../src/language/shell-language-options.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,QAAQ,CAAC;AA4D3C;;;;;;;;;;;;;;;;GAgBG;AACH,MAAM,WAAW,oBAAqB,SAAQ,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC;IACnE,QAAQ,CAAC,OAAO,CAAC,EAAE,YAAY,CAAC;IAChC,QAAQ,CAAC,YAAY,CAAC,EAAE,MAAM,CAAC;IAE/B;;;;;;;;OAQG;IACH,QAAQ,CAAC,eAAe,CAAC,EAAE,MAAM,CAAC;CACnC;AAED;;;;;;;;;;;;;;;;GAgBG;AACH,MAAM,WAAW,wBAAwB;IACvC,QAAQ,CAAC,OAAO,EAAE,YAAY,CAAC;IAC/B,QAAQ,CAAC,eAAe,EAAE,MAAM,CAAC;IACjC,QAAQ,CAAC,YAAY,CAAC,EAAE,MAAM,CAAC;CAChC;AAED;;;;;;;;;;;GAWG;AACH,MAAM,WAAW,8BAA+B,SAAQ,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC;IAC7E,QAAQ,CAAC,OAAO,EAAE,YAAY,CAAC;IAC/B,QAAQ,CAAC,eAAe,EAAE,MAAM,CAAC;IACjC,QAAQ,CAAC,YAAY,CAAC,EAAE,MAAM,CAAC;IAC/B,MAAM,IAAI,wBAAwB,CAAC;CACpC;AAED;;;;;;;;;;;;;;;;;;GAkBG;AACH,wBAAgB,4BAA4B,CAAC,eAAe,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,IAAI,CA8B3F;AAED;;;;;;;;;GASG;AACH,wBAAgB,6BAA6B,CAC3C,eAAe,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GACvC,8BAA8B,CAkBhC"}
+{"version":3,"file":"shell-language-options.d.ts","sourceRoot":"","sources":["../../src/language/shell-language-options.ts"],"names":[],"mappings":"AAAA,mGAAmG;AACnG,uHAAuH;AACvH,MAAM,MAAM,YAAY,GAAG,MAAM,GAAG,OAAO,GAAG,MAAM,GAAG,MAAM,GAAG,KAAK,CAAC;AAyDtE;;;;;;;;;;;;;;GAcG;AACH,MAAM,WAAW,oBAAqB,SAAQ,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC;IACnE,QAAQ,CAAC,OAAO,CAAC,EAAE,YAAY,CAAC;IAChC,QAAQ,CAAC,YAAY,CAAC,EAAE,MAAM,CAAC;IAE/B;;;;;;;OAOG;IACH,QAAQ,CAAC,eAAe,CAAC,EAAE,MAAM,CAAC;CACnC;AAED;;;;;;;;;;;;;;;;GAgBG;AACH,MAAM,WAAW,wBAAwB;IACvC,QAAQ,CAAC,OAAO,EAAE,YAAY,CAAC;IAC/B,QAAQ,CAAC,eAAe,EAAE,MAAM,CAAC;IACjC,QAAQ,CAAC,YAAY,CAAC,EAAE,MAAM,CAAC;CAChC;AAED;;;;;;;;;;;GAWG;AACH,MAAM,WAAW,8BAA+B,SAAQ,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC;IAC7E,QAAQ,CAAC,OAAO,EAAE,YAAY,CAAC;IAC/B,QAAQ,CAAC,eAAe,EAAE,MAAM,CAAC;IACjC,QAAQ,CAAC,YAAY,CAAC,EAAE,MAAM,CAAC;IAC/B,MAAM,IAAI,wBAAwB,CAAC;CACpC;AAED;;;;;;;;;;;;;;;;;GAiBG;AACH,wBAAgB,4BAA4B,CAAC,eAAe,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,IAAI,CA8B3F;AAED;;;;;;;;;GASG;AACH,wBAAgB,6BAA6B,CAC3C,eAAe,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GACvC,8BAA8B,CAkBhC"}

package/dist/language/shell-language-options.js

@@ -1,22 +1,18 @@
 /**
  * The full set of dialects {@link ShellLanguage.validateLanguageOptions}
  * accepts, in the order surfaced by its error message. Mirrors
- * `sh-ast`'s `SUPPORTED_SHELL_DIALECTS` (see
- * design/ARCHITECTURE.md, "Parse errors and dialects", and
- * design/PACKAGES.md's `languageOptions` schema) — kept as an independent
- * constant here (rather than imported) because the bridge does not export
- * its internal list; both lists are exercised by tests that pin the same
- * five dialect names.
+ * the consumer's configuration labels; the syntax interface itself accepts
+ * upstream numeric constants rather than these configuration strings.
  */
 const SUPPORTED_SHELL_DIALECTS = ['bash', 'posix', 'mksh', 'bats', 'zsh'];
+/** Narrows configuration labels without treating arbitrary strings as parser variants. */
 function isShellDialect(value) {
     return (typeof value === 'string' && SUPPORTED_SHELL_DIALECTS.includes(value));
 }
 /**
  * Default for {@link ShellLanguageOptions.directivePrefix} — the
- * ESLint-conventional spelling (design/ARCHITECTURE.md, "SourceCode and
- * Language objects": "The directive prefix is configurable but defaults to
- * the ESLint-conventional spelling").
+ * ESLint-conventional spelling. The directive prefix is configurable but
+ * defaults to the ESLint-conventional spelling.
  */
 const DEFAULT_DIRECTIVE_PREFIX = 'eslint';
 /**
@@ -29,6 +25,7 @@ const DEFAULT_DIRECTIVE_PREFIX = 'eslint';
  * is a strict improvement.
  */
 const DIRECTIVE_PREFIX_PATTERN = /^[a-z]+(?:-[a-z]+)*$/u;
+/** Requires a label that the directive parser can recognize once a command suffix is appended. */
 function isValidDirectivePrefix(value) {
     return typeof value === 'string' && DIRECTIVE_PREFIX_PATTERN.test(value);
 }
@@ -56,8 +53,7 @@ function isValidShellVersionShape(value) {
  * nonexistent version like `'99.99'` is accepted — shape is validated, not
  * membership in a known-versions list), or when `directivePrefix` is present
  * but not a valid directive-comment label (see {@link DIRECTIVE_PREFIX_PATTERN}).
- * Unknown keys are silently ignored, per the ESLint `Language` contract
- * (design/ARCHITECTURE.md's `languageOptions` schema comment).
+ * Unknown keys are silently ignored, per the ESLint `Language` contract.
  *
  * The parameter is treated as `Record<string, unknown>` internally (rather
  * than trusting {@link ShellLanguageOptions}'s declared field types) because

package/dist/language/shell-language-options.js.map

@@ -1 +1 @@
-{"version":3,"file":"shell-language-options.js","sourceRoot":"","sources":["../../src/language/shell-language-options.ts"],"names":[],"mappings":"AAEA;;;;;;;;;GASG;AACH,MAAM,wBAAwB,GAA4B,CAAC,MAAM,EAAE,OAAO,EAAE,MAAM,EAAE,MAAM,EAAE,KAAK,CAAC,CAAC;AAEnG,SAAS,cAAc,CAAC,KAAc;IACpC,OAAO,CACL,OAAO,KAAK,KAAK,QAAQ,IAAK,wBAA8C,CAAC,QAAQ,CAAC,KAAK,CAAC,CAC7F,CAAC;AACJ,CAAC;AAED;;;;;GAKG;AACH,MAAM,wBAAwB,GAAG,QAAQ,CAAC;AAE1C;;;;;;;;GAQG;AACH,MAAM,wBAAwB,GAAG,uBAAuB,CAAC;AAEzD,SAAS,sBAAsB,CAAC,KAAc;IAC5C,OAAO,OAAO,KAAK,KAAK,QAAQ,IAAI,wBAAwB,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;AAC3E,CAAC;AAED;;;;;;;;;;GAUG;AACH,MAAM,qBAAqB,GAAG,kBAAkB,CAAC;AAEjD,SAAS,wBAAwB,CAAC,KAAa;IAC7C,OAAO,qBAAqB,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;AAC3C,CAAC;AA6ED;;;;;;;;;;;;;;;;;;GAkBG;AACH,MAAM,UAAU,4BAA4B,CAAC,eAAwC;IACnF,MAAM,EAAE,OAAO,EAAE,YAAY,EAAE,eAAe,EAAE,GAAG,eAAe,CAAC;IACnE,IAAI,OAAO,KAAK,SAAS,IAAI,CAAC,cAAc,CAAC,OAAO,CAAC,EAAE,CAAC;QACtD,MAAM,IAAI,SAAS,CACjB,oEAAoE,wBAAwB,CAAC,IAAI,CAC/F,IAAI,CACL,cAAc,IAAI,CAAC,SAAS,CAAC,OAAO,CAAC,GAAG,CAC1C,CAAC;IACJ,CAAC;IACD,IAAI,YAAY,KAAK,SAAS,IAAI,OAAO,YAAY,KAAK,QAAQ,EAAE,CAAC;QACnE,MAAM,IAAI,SAAS,CACjB,kGAAkG,IAAI,CAAC,SAAS,CAC9G,YAAY,CACb,GAAG,CACL,CAAC;IACJ,CAAC;IACD,IAAI,OAAO,YAAY,KAAK,QAAQ,IAAI,CAAC,wBAAwB,CAAC,YAAY,CAAC,EAAE,CAAC;QAChF,MAAM,IAAI,SAAS,CACjB,yHAAyH,IAAI,CAAC,SAAS,CACrI,YAAY,CACb,GAAG,CACL,CAAC;IACJ,CAAC;IACD,IAAI,eAAe,KAAK,SAAS,IAAI,CAAC,sBAAsB,CAAC,eAAe,CAAC,EAAE,CAAC;QAC9E,MAAM,IAAI,SAAS,CACjB,8JAA8J,IAAI,CAAC,SAAS,CAC1K,eAAe,CAChB,GAAG,CACL,CAAC;IACJ,CAAC;AACH,CAAC;AAED;;;;;;;;;GASG;AACH,MAAM,UAAU,6BAA6B,CAC3C,eAAwC;IAExC,MAAM,OAAO,GAAI,eAAe,CAAC,OAAoC,IAAI,MAAM,CAAC;IAChF,MAAM,eAAe,GAClB,eAAe,CAAC,eAAsC,IAAI,wBAAwB,CAAC;IACtF,MAAM,YAAY,GAAG,eAAe,CAAC,YAAkC,CAAC;IACxE,OAAO;QACL,OAAO;QACP,eAAe;QACf,mEAAmE;QACnE,wEAAwE;QACxE,+DAA+D;QAC/D,GAAG,CAAC,YAAY,KAAK,SAAS,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,EAAE,YAAY,EAAE,CAAC;QACvD,MAAM;YACJ,OAAO,YAAY,KAAK,SAAS;gBAC/B,CAAC,CAAC,EAAE,OAAO,EAAE,eAAe,EAAE;gBAC9B,CAAC,CAAC,EAAE,OAAO,EAAE,eAAe,EAAE,YAAY,EAAE,CAAC;QACjD,CAAC;KACF,CAAC;AACJ,CAAC"}
+{"version":3,"file":"shell-language-options.js","sourceRoot":"","sources":["../../src/language/shell-language-options.ts"],"names":[],"mappings":"AAIA;;;;;GAKG;AACH,MAAM,wBAAwB,GAA4B,CAAC,MAAM,EAAE,OAAO,EAAE,MAAM,EAAE,MAAM,EAAE,KAAK,CAAC,CAAC;AAEnG,0FAA0F;AAC1F,SAAS,cAAc,CAAC,KAAc;IACpC,OAAO,CACL,OAAO,KAAK,KAAK,QAAQ,IAAK,wBAA8C,CAAC,QAAQ,CAAC,KAAK,CAAC,CAC7F,CAAC;AACJ,CAAC;AAED;;;;GAIG;AACH,MAAM,wBAAwB,GAAG,QAAQ,CAAC;AAE1C;;;;;;;;GAQG;AACH,MAAM,wBAAwB,GAAG,uBAAuB,CAAC;AAEzD,kGAAkG;AAClG,SAAS,sBAAsB,CAAC,KAAc;IAC5C,OAAO,OAAO,KAAK,KAAK,QAAQ,IAAI,wBAAwB,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;AAC3E,CAAC;AAED;;;;;;;;;;GAUG;AACH,MAAM,qBAAqB,GAAG,kBAAkB,CAAC;AAEjD,SAAS,wBAAwB,CAAC,KAAa;IAC7C,OAAO,qBAAqB,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;AAC3C,CAAC;AA0ED;;;;;;;;;;;;;;;;;GAiBG;AACH,MAAM,UAAU,4BAA4B,CAAC,eAAwC;IACnF,MAAM,EAAE,OAAO,EAAE,YAAY,EAAE,eAAe,EAAE,GAAG,eAAe,CAAC;IACnE,IAAI,OAAO,KAAK,SAAS,IAAI,CAAC,cAAc,CAAC,OAAO,CAAC,EAAE,CAAC;QACtD,MAAM,IAAI,SAAS,CACjB,oEAAoE,wBAAwB,CAAC,IAAI,CAC/F,IAAI,CACL,cAAc,IAAI,CAAC,SAAS,CAAC,OAAO,CAAC,GAAG,CAC1C,CAAC;IACJ,CAAC;IACD,IAAI,YAAY,KAAK,SAAS,IAAI,OAAO,YAAY,KAAK,QAAQ,EAAE,CAAC;QACnE,MAAM,IAAI,SAAS,CACjB,kGAAkG,IAAI,CAAC,SAAS,CAC9G,YAAY,CACb,GAAG,CACL,CAAC;IACJ,CAAC;IACD,IAAI,OAAO,YAAY,KAAK,QAAQ,IAAI,CAAC,wBAAwB,CAAC,YAAY,CAAC,EAAE,CAAC;QAChF,MAAM,IAAI,SAAS,CACjB,yHAAyH,IAAI,CAAC,SAAS,CACrI,YAAY,CACb,GAAG,CACL,CAAC;IACJ,CAAC;IACD,IAAI,eAAe,KAAK,SAAS,IAAI,CAAC,sBAAsB,CAAC,eAAe,CAAC,EAAE,CAAC;QAC9E,MAAM,IAAI,SAAS,CACjB,8JAA8J,IAAI,CAAC,SAAS,CAC1K,eAAe,CAChB,GAAG,CACL,CAAC;IACJ,CAAC;AACH,CAAC;AAED;;;;;;;;;GASG;AACH,MAAM,UAAU,6BAA6B,CAC3C,eAAwC;IAExC,MAAM,OAAO,GAAI,eAAe,CAAC,OAAoC,IAAI,MAAM,CAAC;IAChF,MAAM,eAAe,GAClB,eAAe,CAAC,eAAsC,IAAI,wBAAwB,CAAC;IACtF,MAAM,YAAY,GAAG,eAAe,CAAC,YAAkC,CAAC;IACxE,OAAO;QACL,OAAO;QACP,eAAe;QACf,mEAAmE;QACnE,wEAAwE;QACxE,+DAA+D;QAC/D,GAAG,CAAC,YAAY,KAAK,SAAS,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,EAAE,YAAY,EAAE,CAAC;QACvD,MAAM;YACJ,OAAO,YAAY,KAAK,SAAS;gBAC/B,CAAC,CAAC,EAAE,OAAO,EAAE,eAAe,EAAE;gBAC9B,CAAC,CAAC,EAAE,OAAO,EAAE,eAAe,EAAE,YAAY,EAAE,CAAC;QACjD,CAAC;KACF,CAAC;AACJ,CAAC"}