@eslint-sh/eslint-plugin 0.2.0 → 0.4.0

package/dist/language/shell-source-code.js

@@ -1,5 +1,5 @@
 import { ConfigCommentParser, Directive, TextSourceCodeBase, VisitNodeStep, } from '@eslint/plugin-kit';
-import { visitorKeys as shellVisitorKeys, walk } from 'sh-ast';
+import { isShellComment, isShellNode, shellVisitorKeys, walkShell } from './syntax-view.js';
 /**
  * Shared instance — `ConfigCommentParser` is stateless (see
  * `@eslint/plugin-kit`'s implementation), so every `ShellSourceCode`
@@ -47,28 +47,158 @@ function getCommentText(comment) {
     return typeof text === 'string' ? text : '';
 }
 /**
- * Narrows an unknown field value to a normalized `ShNode` — used while
- * traversing (see `ShellSourceCode.traverse()` below) to tell an actual
- * child node apart from a scalar field (e.g. `Lit.value: string`) or
- * `undefined`.
- * Deliberately duck-typed (checks only `type`, matching
- * `ShellLanguage.nodeTypeKey`) rather than re-validating the full `ShNode`
- * shape — every value reachable through a `visitorKeys` field on a bridge
- * AST is either a normalized node or absent, by construction of
- * `sh-ast`'s `normalize()`.
+ * Length of the line terminator starting at `text[index]` — `2` for `\r\n`,
+ * `1` for a lone `\n` or a lone `\r` (classic-Mac style), `0` if `index`
+ * isn't the start of a line terminator at all (including end of string).
+ * Shared by both the forward-widening check and the preceding-line
+ * continuation check in {@link computeUnusedDirectiveFixRange} so both
+ * agree on what counts as "a newline" regardless of the file's line-ending
+ * convention.
  */
-function isShNode(value) {
-    return (typeof value === 'object' &&
-        value !== null &&
-        typeof value.type === 'string');
+function newlineLengthAt(text, index) {
+    if (text[index] === '\n')
+        return 1;
+    if (text[index] === '\r')
+        return text[index + 1] === '\n' ? 2 : 1;
+    return 0;
+}
+/**
+ * Computes the `.range` to hand `@eslint/plugin-kit`'s `Directive` as its
+ * backing `node` (see {@link ShellSourceCode.getDisableDirectives}) so that
+ * ESLint core's unused-directive `--fix` (issue #64, criterion 7) removes a
+ * whole-line directive comment cleanly instead of leaving a stray
+ * whitespace-only line, in the cases where that can be done **without
+ * risking a change to the fixed script's behavior**.
+ *
+ * ESLint core's `apply-disable-directives.js` (`createDirectiveRemoval`)
+ * always replaces whatever range `sourceCode.getRange(directive.node)`
+ * reports with a single literal `" "` — this is hardcoded, not something a
+ * `Language`/`SourceCode` can override. Reporting the comment's own bare
+ * range (`[start, end)`, spanning only the `#...` text) therefore autofixes
+ * `"echo hi\n# eslint-disable-next-line sh/foo -- x\necho bye\n"` into
+ * `"echo hi\n \necho bye\n"`: the forced space lands where the comment was,
+ * and the newlines on both sides of it are untouched, leaving a line that
+ * contains nothing but that one space.
+ *
+ * Widening the reported range forward to also swallow the newline
+ * *immediately following* the comment turns that same forced single-space
+ * insertion into a harmless leading space on the next real line instead of
+ * a line of its own — shell ignores leading whitespace before a command, so
+ * this has no effect on the fixed script's behavior. This is the **only**
+ * direction ever widened, and only when every one of the following holds:
+ *
+ * - The comment is genuinely alone on its source line (nothing but leading
+ *   whitespace precedes it — mvdan/sh's `#` comments always run to end of
+ *   line, so nothing but the line terminator can follow it). A directive
+ *   trailing real code on the same line (e.g.
+ *   `echo hi # eslint-disable-line sh/foo -- x`) keeps the bare range: the
+ *   existing "single space where the comment was, code stays on the line"
+ *   behavior is already correct there, and widening would eat into the
+ *   following line's content instead.
+ * - A line terminator (`\n`, `\r\n`, or a lone `\r`) immediately follows the
+ *   comment, *and* real content follows that terminator. A directive on the
+ *   file's last line with a trailing terminator but nothing after it (e.g.
+ *   `"echo hi\n# directive\n"`, EOF right after) has nothing for the forced
+ *   space to attach to as a leading space — widening there would only move
+ *   the stray-whitespace problem from a line of its own to a trailing space
+ *   with no line terminator at all, which is no better.
+ * - The physical line immediately preceding the comment's own line does
+ *   **not** end in an unescaped (odd count of trailing `\`) line-
+ *   continuation backslash. If it does, the comment's line is not a fresh
+ *   statement — it's a continuation of the previous logical line — and the
+ *   terminator right after the comment is what finally closes that still-
+ *   open logical line. Swallowing it would splice whatever follows into
+ *   that statement instead of starting a new one (reproduced: a `printf`
+ *   command continued with `\` onto a line holding only the directive
+ *   comment, followed by `echo bye`, autofixes from printing `<hi>` then
+ *   `bye` to printing `<hi>`, `<echo>`, `<bye>` — `echo` and `bye` become
+ *   extra `printf` arguments instead of a separate command).
+ *
+ * Backward widening (attaching the forced space as a *trailing* space on
+ * the *previous* line, for a directive on the file's last line with no
+ * trailing terminator at all) is deliberately never attempted, even though
+ * it would close that one remaining gap: joining the directive's line into
+ * whatever precedes it is not generally safe to do from text alone. A
+ * heredoc terminator line immediately before the directive is the sharpest
+ * counterexample — `"cat <<EOF\nbody\nEOF\n# eslint-disable-next-line ...".`
+ * (no trailing newline) would widen back across the newline that terminates
+ * the `EOF` line, and the forced single-space replacement respells the
+ * terminator as `"EOF "`, which no longer matches `<<EOF` (bash requires the
+ * terminator alone on its line); the next lint pass reports "unclosed
+ * here-document" and bash itself would read the following content as more
+ * heredoc body. An escaped continuation ending the previous line has the
+ * same problem in the backward direction. Detecting "the previous line is a
+ * heredoc terminator" reliably from text alone isn't tractable here (it
+ * depends on quoting/tab-stripping rules this function has no access to);
+ * fully safe removal in this one last-line/no-trailing-newline case would
+ * need an upstream ESLint core mechanism (e.g. a fixer that can express
+ * "remove and also delete one adjacent newline") rather than range
+ * manipulation, so this function leaves the bare (non-widened) range there
+ * — the pre-existing, but never behavior-changing, whitespace-only-line
+ * outcome — rather than risk corrupting the script.
+ */
+function computeUnusedDirectiveFixRange(comment, text) {
+    const [start, end] = comment.range;
+    const lineStart = text.lastIndexOf('\n', start - 1) + 1;
+    const textBeforeOnLine = text.slice(lineStart, start);
+    if (!/^[ \t]*$/u.test(textBeforeOnLine)) {
+        return comment.range;
+    }
+    const newlineLength = newlineLengthAt(text, end);
+    if (newlineLength === 0) {
+        // Last line, no trailing terminator at all — nothing safe to widen into
+        // (see the doc comment's "Backward widening" section).
+        return comment.range;
+    }
+    if (end + newlineLength >= text.length) {
+        // A trailing terminator, but nothing follows it — no next line to
+        // attach the forced space to as harmless leading whitespace.
+        return comment.range;
+    }
+    if (lineStart > 0) {
+        // Find where the *previous* physical line's real content ends (i.e.
+        // strip that line's own terminator, which sits directly before
+        // `lineStart`) so trailing-backslash counting only looks at content,
+        // never at `\n`/`\r`.
+        let previousLineContentEnd = lineStart - 1;
+        if (text[previousLineContentEnd] === '\n' && text[previousLineContentEnd - 1] === '\r') {
+            previousLineContentEnd -= 1;
+        }
+        let backslashRun = 0;
+        let cursor = previousLineContentEnd - 1;
+        while (cursor >= 0 && text[cursor] === '\\') {
+            backslashRun += 1;
+            cursor -= 1;
+        }
+        if (backslashRun % 2 === 1) {
+            // The previous line ends in an unescaped continuation backslash —
+            // this comment's line isn't a fresh statement (see the doc comment's
+            // continuation bullet).
+            return comment.range;
+        }
+    }
+    return [start, end + newlineLength];
+}
+/**
+ * Wraps `comment` in a shallow copy whose `.range` is
+ * {@link computeUnusedDirectiveFixRange}'s (possibly widened) range, while
+ * every other property — critically `.loc`, which ESLint core also reads
+ * off this same object to compute both the "unused directive" warning's
+ * reported location and a `disable-next-line` directive's target line — is
+ * byte-for-byte `comment`'s own. Widening only `.range` therefore changes
+ * what the unused-directive autofix removes without changing where
+ * anything is *reported*.
+ */
+function withUnusedDirectiveFixRange(comment, text) {
+    const range = computeUnusedDirectiveFixRange(comment, text);
+    return range === comment.range ? comment : { ...comment, range };
 }
 /**
  * `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
@@ -80,7 +210,7 @@ function isShNode(value) {
  * (`<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`)
@@ -101,8 +231,8 @@ export class ShellSourceCode extends TextSourceCodeBase {
      */
     #parents = new WeakMap();
     /**
-     * Cached traversal steps — the AST never mutates after `parse()` returns
-     * it, so `traverse()` only needs to compute this once (mirroring
+     * Cached traversal steps — the lint view is a snapshot independent of later
+     * raw syntax edits, so `traverse()` only needs to compute this once (mirroring
      * `@eslint/json`'s `JSONSourceCode`).
      */
     #steps;
@@ -124,15 +254,9 @@ export class ShellSourceCode extends TextSourceCodeBase {
      */
     #inlineConfigPattern;
     /**
-     * Every `Comment` node in the AST, gathered once (cached) via
-     * `sh-ast`'s `walk()` — deliberately *not* derived from
-     * `traverse()`/`visitorKeys` even though, verified against a real parse,
-     * `comments` and `last` already appear in the generated `visitorKeys`
-     * table (so `traverse()` does visit `Comment` nodes today too). `walk()`
-     * discovers children structurally rather than through that table (see its
-     * own doc comment: the hand-written table once missed a field and
-     * silently under-walked), so comment collection keeps working even if a
-     * future `visitorKeys` regeneration omits a comment-bearing field.
+     * Comments gathered through the consumer's child graph. Source-order sorting
+     * is required for repeated inline configuration; schema field order does not
+     * encode physical source order. The lint view is a stable parse snapshot.
      */
     #comments;
     /**
@@ -161,17 +285,9 @@ export class ShellSourceCode extends TextSourceCodeBase {
         return this.#parents.get(node);
     }
     /**
-     * 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() {
         if (this.#steps) {
@@ -189,12 +305,12 @@ export class ShellSourceCode extends TextSourceCodeBase {
                 const value = node[key];
                 if (Array.isArray(value)) {
                     for (const child of value) {
-                        if (isShNode(child)) {
+                        if (isShellNode(child)) {
                             visit(child, node);
                         }
                     }
                 }
-                else if (isShNode(value)) {
+                else if (isShellNode(value)) {
                     visit(value, node);
                 }
             }
@@ -204,28 +320,15 @@ export class ShellSourceCode extends TextSourceCodeBase {
         return steps.values();
     }
     /**
-     * Returns every `Comment` node in the AST, in source order, gathering them
-     * (once, cached) via `sh-ast`'s structural `walk()` rather than
-     * `traverse()` — see `#comments`'s doc comment for why.
-     *
-     * `walk()` discovers children in AST field/insertion order (e.g.
-     * `Stmt.comments` before descending into `Stmt.cmd`'s own nested
-     * comments), which is not guaranteed to match *source* order — a comment
-     * trailing an early statement can be visited after a comment buried
-     * inside a later command substitution's own sub-tree, depending on field
-     * layout. `getDisableDirectives()`'s `disable`/`enable` ranges happen to
-     * be safe regardless (ESLint core re-sorts directives by location
-     * internally), but `applyInlineConfig()`'s "last inline-config comment
-     * wins" semantics for a repeated whole-file rule config, and any external
-     * caller of `getInlineConfigNodes()`, both depend on source order. Sorting
-     * once here — rather than requiring every consumer to re-sort — is the
-     * fix that's correct regardless of how `walk()` happens to traverse.
+     * Returns retained comments in source order. Reflection-field order can place
+     * a later enclosing comment before an earlier nested comment, so sort by the
+     * exact derived source span before directive and inline-config processing.
      */
     #getComments() {
         if (!this.#comments) {
             const comments = [];
-            walk(this.ast, (node) => {
-                if (node.type === 'Comment') {
+            walkShell(this.ast, (node) => {
+                if (isShellComment(node)) {
                     comments.push(node);
                 }
             });
@@ -275,7 +378,7 @@ export class ShellSourceCode extends TextSourceCodeBase {
             if (directiveType) {
                 directives.push(new Directive({
                     type: directiveType,
-                    node: comment,
+                    node: withUnusedDirectiveFixRange(comment, this.text),
                     value: parsed.value,
                     justification: parsed.justification,
                 }));
@@ -293,7 +396,7 @@ export 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() {
         const problems = [];

package/dist/language/shell-source-code.js.map

@@ -1 +1 @@
-{"version":3,"file":"shell-source-code.js","sourceRoot":"","sources":["../../src/language/shell-source-code.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"shell-source-code.js","sourceRoot":"","sources":["../../src/language/shell-source-code.ts"],"names":[],"mappings":"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"}

package/dist/language/source-coordinates.d.ts

@@ -0,0 +1,23 @@
+/**
+ * Coordinates belong to the exact source string ESLint indexes. Upstream positions
+ * count bytes; this adapter derives UTF-16 indices and columns without replacing or
+ * mutating the raw syntax position. Display widths, graphemes, and tab expansion
+ * are deliberately outside this contract.
+ */
+/** A source boundary expressed in JavaScript indexing and ESLint's one-based location convention. @internal */
+export interface ISourceCoordinate {
+    readonly index: number;
+    readonly line: number;
+    readonly column: number;
+}
+/** Source-bound conversion shared by tree projection and diagnostic adaptation. @internal */
+export declare class SourceCoordinates {
+    #private;
+    /** Build one reusable coordinate index for the exact source passed to the parser. @internal */
+    constructor(source: string);
+    /** Reject mismatched/out-of-source/interior-byte positions rather than inventing a fix boundary. @internal */
+    fromByteOffset(offset: number): ISourceCoordinate;
+    /** Derive a one-based location from a known JavaScript source index. @internal */
+    atIndex(index: number): ISourceCoordinate;
+}
+//# sourceMappingURL=source-coordinates.d.ts.map

package/dist/language/source-coordinates.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"source-coordinates.d.ts","sourceRoot":"","sources":["../../src/language/source-coordinates.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,+GAA+G;AAC/G,MAAM,WAAW,iBAAiB;IAChC,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;IACvB,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;CACzB;AAED,6FAA6F;AAC7F,qBAAa,iBAAiB;;IAQ5B,+FAA+F;gBACnF,MAAM,EAAE,MAAM;IAgB1B,8GAA8G;IAC9G,cAAc,CAAC,MAAM,EAAE,MAAM,GAAG,iBAAiB;IAQjD,kFAAkF;IAClF,OAAO,CAAC,KAAK,EAAE,MAAM,GAAG,iBAAiB;CAgB1C"}

package/dist/language/source-coordinates.js

@@ -0,0 +1,58 @@
+/**
+ * Coordinates belong to the exact source string ESLint indexes. Upstream positions
+ * count bytes; this adapter derives UTF-16 indices and columns without replacing or
+ * mutating the raw syntax position. Display widths, graphemes, and tab expansion
+ * are deliberately outside this contract.
+ */
+/** Source-bound conversion shared by tree projection and diagnostic adaptation. @internal */
+export class SourceCoordinates {
+    /** Only complete UTF-8 character boundaries have meaningful JavaScript counterparts. */
+    #byteIndices = new Map();
+    /** UTF-16 start indices of lines; CRLF becomes one line break at its LF. */
+    #lineStarts = [0];
+    /** The source extent constrains all derived ranges, including empty-file fallback. */
+    #length;
+    /** Build one reusable coordinate index for the exact source passed to the parser. @internal */
+    constructor(source) {
+        this.#length = source.length;
+        let bytes = 0;
+        let index = 0;
+        this.#byteIndices.set(0, 0);
+        const encoder = new TextEncoder();
+        for (const character of source) {
+            bytes += encoder.encode(character).length;
+            index += character.length;
+            this.#byteIndices.set(bytes, index);
+            if (character === '\n') {
+                this.#lineStarts.push(index);
+            }
+        }
+    }
+    /** Reject mismatched/out-of-source/interior-byte positions rather than inventing a fix boundary. @internal */
+    fromByteOffset(offset) {
+        const index = this.#byteIndices.get(offset);
+        if (!Number.isInteger(offset) || index === undefined) {
+            throw new RangeError(`byte offset ${String(offset)} is not a boundary in this source`);
+        }
+        return this.atIndex(index);
+    }
+    /** Derive a one-based location from a known JavaScript source index. @internal */
+    atIndex(index) {
+        if (!Number.isInteger(index) || index < 0 || index > this.#length) {
+            throw new RangeError(`UTF-16 index ${String(index)} is outside this source`);
+        }
+        let low = 0;
+        let high = this.#lineStarts.length;
+        while (low + 1 < high) {
+            const middle = Math.floor((low + high) / 2);
+            if (this.#lineStarts[middle] <= index) {
+                low = middle;
+            }
+            else {
+                high = middle;
+            }
+        }
+        return { index, line: low + 1, column: index - this.#lineStarts[low] + 1 };
+    }
+}
+//# sourceMappingURL=source-coordinates.js.map

package/dist/language/source-coordinates.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"source-coordinates.js","sourceRoot":"","sources":["../../src/language/source-coordinates.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AASH,6FAA6F;AAC7F,MAAM,OAAO,iBAAiB;IAC5B,wFAAwF;IAC/E,YAAY,GAAG,IAAI,GAAG,EAAkB,CAAC;IAClD,4EAA4E;IACnE,WAAW,GAAa,CAAC,CAAC,CAAC,CAAC;IACrC,sFAAsF;IAC7E,OAAO,CAAS;IAEzB,+FAA+F;IAC/F,YAAY,MAAc;QACxB,IAAI,CAAC,OAAO,GAAG,MAAM,CAAC,MAAM,CAAC;QAC7B,IAAI,KAAK,GAAG,CAAC,CAAC;QACd,IAAI,KAAK,GAAG,CAAC,CAAC;QACd,IAAI,CAAC,YAAY,CAAC,GAAG,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC;QAC5B,MAAM,OAAO,GAAG,IAAI,WAAW,EAAE,CAAC;QAClC,KAAK,MAAM,SAAS,IAAI,MAAM,EAAE,CAAC;YAC/B,KAAK,IAAI,OAAO,CAAC,MAAM,CAAC,SAAS,CAAC,CAAC,MAAM,CAAC;YAC1C,KAAK,IAAI,SAAS,CAAC,MAAM,CAAC;YAC1B,IAAI,CAAC,YAAY,CAAC,GAAG,CAAC,KAAK,EAAE,KAAK,CAAC,CAAC;YACpC,IAAI,SAAS,KAAK,IAAI,EAAE,CAAC;gBACvB,IAAI,CAAC,WAAW,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;YAC/B,CAAC;QACH,CAAC;IACH,CAAC;IAED,8GAA8G;IAC9G,cAAc,CAAC,MAAc;QAC3B,MAAM,KAAK,GAAG,IAAI,CAAC,YAAY,CAAC,GAAG,CAAC,MAAM,CAAC,CAAC;QAC5C,IAAI,CAAC,MAAM,CAAC,SAAS,CAAC,MAAM,CAAC,IAAI,KAAK,KAAK,SAAS,EAAE,CAAC;YACrD,MAAM,IAAI,UAAU,CAAC,eAAe,MAAM,CAAC,MAAM,CAAC,mCAAmC,CAAC,CAAC;QACzF,CAAC;QACD,OAAO,IAAI,CAAC,OAAO,CAAC,KAAK,CAAC,CAAC;IAC7B,CAAC;IAED,kFAAkF;IAClF,OAAO,CAAC,KAAa;QACnB,IAAI,CAAC,MAAM,CAAC,SAAS,CAAC,KAAK,CAAC,IAAI,KAAK,GAAG,CAAC,IAAI,KAAK,GAAG,IAAI,CAAC,OAAO,EAAE,CAAC;YAClE,MAAM,IAAI,UAAU,CAAC,gBAAgB,MAAM,CAAC,KAAK,CAAC,yBAAyB,CAAC,CAAC;QAC/E,CAAC;QACD,IAAI,GAAG,GAAG,CAAC,CAAC;QACZ,IAAI,IAAI,GAAG,IAAI,CAAC,WAAW,CAAC,MAAM,CAAC;QACnC,OAAO,GAAG,GAAG,CAAC,GAAG,IAAI,EAAE,CAAC;YACtB,MAAM,MAAM,GAAG,IAAI,CAAC,KAAK,CAAC,CAAC,GAAG,GAAG,IAAI,CAAC,GAAG,CAAC,CAAC,CAAC;YAC5C,IAAI,IAAI,CAAC,WAAW,CAAC,MAAM,CAAC,IAAI,KAAK,EAAE,CAAC;gBACtC,GAAG,GAAG,MAAM,CAAC;YACf,CAAC;iBAAM,CAAC;gBACN,IAAI,GAAG,MAAM,CAAC;YAChB,CAAC;QACH,CAAC;QACD,OAAO,EAAE,KAAK,EAAE,IAAI,EAAE,GAAG,GAAG,CAAC,EAAE,MAAM,EAAE,KAAK,GAAG,IAAI,CAAC,WAAW,CAAC,GAAG,CAAC,GAAG,CAAC,EAAE,CAAC;IAC7E,CAAC;CACF"}

package/dist/language/syntax-view.d.ts

@@ -0,0 +1,60 @@
+import type { File, Node as SyntaxNode, PositionSnapshot } from 'sh-ast';
+/** An ESLint location counts UTF-16 units, with both line and column starting at one. @public */
+export 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;
+}
+/**
+ * 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 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;
+}
+/** The lint root has a statement collection even when upstream represents it as nil. @public */
+export 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[];
+}
+/** Directive processing uses the comment text without its leading shell hash. @public */
+export 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;
+}
+/** ESLint child relationships follow the consumer projection, including auxiliary views; not upstream Walk ordering. @internal */
+export declare const shellVisitorKeys: Readonly<Record<string, readonly string[]>>;
+/** Identifies projected children without confusing raw position records or byte strings with nodes. @internal */
+export declare function isShellNode(value: unknown): value is ShellNode;
+/** Directive processing requires both the comment kind and its decoded text. @internal */
+export declare function isShellComment(node: ShellNode): node is ShellComment;
+/** Returns the actual parser node, or undefined for consumer-created/synthetic views. @internal */
+export declare function syntaxForNode(node: ShellNode): SyntaxNode | undefined;
+/**
+ * Builds a source-bound view immediately from one parse's File and Positions.
+ * Snapshot bounds describe that original parse, never subsequent syntax edits.
+ * A missing observation indicates a mismatched/incomplete snapshot and cannot be
+ * repaired by querying live syntax without reintroducing repeated subtree work.
+ * @internal
+ */
+export declare function adaptSyntaxFile(file: File, source: string, positions: PositionSnapshot): ShellFile;
+/** Consumer traversal visits each projected child, including auxiliary views, without claiming upstream Walk control semantics. @internal */
+export declare function walkShell(root: ShellNode, visit: (node: ShellNode) => void): void;
+//# sourceMappingURL=syntax-view.d.ts.map

package/dist/language/syntax-view.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"syntax-view.d.ts","sourceRoot":"","sources":["../../src/language/syntax-view.ts"],"names":[],"mappings":"AAQA,OAAO,KAAK,EAAE,IAAI,EAAE,IAAI,IAAI,UAAU,EAAE,gBAAgB,EAAa,MAAM,QAAQ,CAAC;AAIpF,iGAAiG;AACjG,MAAM,WAAW,aAAa;IAC5B,kEAAkE;IAClE,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,0EAA0E;IAC1E,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;CACzB;AAED;;;;;GAKG;AACH,MAAM,WAAW,SAAS;IACxB,6EAA6E;IAC7E,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,kEAAkE;IAClE,QAAQ,CAAC,KAAK,EAAE,SAAS,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IAC1C,uDAAuD;IACvD,QAAQ,CAAC,GAAG,EAAE;QAAE,QAAQ,CAAC,KAAK,EAAE,aAAa,CAAC;QAAC,QAAQ,CAAC,GAAG,EAAE,aAAa,CAAA;KAAE,CAAC;IAC7E,qFAAqF;IACrF,QAAQ,EAAE,KAAK,EAAE,MAAM,GAAG,OAAO,CAAC;CACnC;AAED,gGAAgG;AAChG,MAAM,WAAW,SAAU,SAAQ,SAAS;IAC1C,iDAAiD;IACjD,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,sFAAsF;IACtF,QAAQ,CAAC,KAAK,EAAE,SAAS,SAAS,EAAE,CAAC;CACtC;AAED,yFAAyF;AACzF,MAAM,WAAW,YAAa,SAAQ,SAAS;IAC7C,0DAA0D;IAC1D,QAAQ,CAAC,IAAI,EAAE,SAAS,CAAC;IACzB,iFAAiF;IACjF,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;CACvB;AASD,kIAAkI;AAClI,eAAO,MAAM,gBAAgB,EAAE,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,SAAS,MAAM,EAAE,CAAC,CAWxE,CAAC;AAYF,iHAAiH;AACjH,wBAAgB,WAAW,CAAC,KAAK,EAAE,OAAO,GAAG,KAAK,IAAI,SAAS,CAE9D;AAED,0FAA0F;AAC1F,wBAAgB,cAAc,CAAC,IAAI,EAAE,SAAS,GAAG,IAAI,IAAI,YAAY,CAEpE;AAOD,mGAAmG;AACnG,wBAAgB,aAAa,CAAC,IAAI,EAAE,SAAS,GAAG,UAAU,GAAG,SAAS,CAErE;AAmBD;;;;;;GAMG;AACH,wBAAgB,eAAe,CAC7B,IAAI,EAAE,IAAI,EACV,MAAM,EAAE,MAAM,EACd,SAAS,EAAE,gBAAgB,GAC1B,SAAS,CAoFX;AAED,6IAA6I;AAC7I,wBAAgB,SAAS,CAAC,IAAI,EAAE,SAAS,EAAE,KAAK,EAAE,CAAC,IAAI,EAAE,SAAS,KAAK,IAAI,GAAG,IAAI,CAcjF"}