sh-ast 0.3.1 → 0.5.0

package/dist/errors.d.ts

@@ -1,92 +1,19 @@
-import type { ShellDialect } from './types.js';
+/** Shared failure classes for binding invariants, resource limits, and analysis contracts. */
 /**
- * Common base class for every error this package throws — originally just
- * {@link sh-ast#parseSync | parseSync}'s errors, now also the
- * `sh-ast/analyze` layer's (see {@link ShAnalyzeMaxDepthError},
- * {@link ShAnalyzeInvalidWrapperSpecError}). Provides a stable, documented
- * `code` discriminator (e.g. `"SH_AST_PARSE_ERROR"`) alongside the usual
- * `instanceof` narrowing, so consumers can branch on failure kind
- * programmatically without parsing `.message` strings. Never thrown directly
- * — only via its concrete subclasses
- * ({@link sh-ast#ShParseError | ShParseError},
- * {@link sh-ast#ShInvalidDialectError | ShInvalidDialectError},
- * {@link sh-ast#ShInternalError | ShInternalError},
- * {@link ShAnalyzeMaxDepthError},
- * {@link sh-ast#ShParseMaxDepthError | ShParseMaxDepthError},
- * {@link ShAnalyzeInvalidWrapperSpecError}).
- *
- * Re-exported from `sh-ast/analyze` as well as the root `sh-ast` entry
- * point (see #23) — every subclass thrown by `sh-ast/analyze`'s own
- * functions extends this, so a consumer of that subpath alone can
- * `catch`/reference the base without also importing from root.
- *
+ * Common base for every package failure, including upstream syntax errors and
+ * analysis errors. The stable code discriminator supports programmatic handling
+ * without interpreting display messages. Only concrete subclasses are thrown.
  * @public
  */
 export declare abstract class ShAstError extends Error {
-    /**
-     * Stable, machine-readable discriminator for this error kind. Distinct
-     * per subclass and will not change once published.
-     */
+    /** Stable machine-readable identity of the concrete failure kind. */
     abstract readonly code: string;
 }
-/**
- * Position info attached to a {@link ShParseError}.
- *
- * @public
- */
-export interface ShParseErrorInfo {
-    /** 1-based line number, exactly as reported by mvdan/sh. */
-    line: number;
-    /**
-     * 1-based column number, in **UTF-16 code units** — converted from
-     * mvdan/sh's own byte-counting column so it agrees with
-     * {@link ShNode.loc}'s columns (mvdan/sh reports `column` as a byte count
-     * on the source line, not a UTF-16 code unit count; see
-     * design/ARCHITECTURE.md's "Byte→UTF-16 conversion"). For ASCII-only
-     * source text this is numerically identical to mvdan/sh's own column.
-     */
-    column: number;
-    /** The filename used for the parse (see {@link ParseOptions.filename}). */
-    filename: string;
-}
-/**
- * Thrown by {@link parseSync} when shell source fails to parse. Carries the
- * real position mvdan/sh reported — never 1:1 placeholders: `.line` is
- * 1-based exactly as mvdan/sh reports it, and `.column` is converted to
- * UTF-16 code units so it agrees with {@link ShNode.loc}'s columns (mvdan/sh
- * itself reports `column` as a byte count on the source line — see
- * {@link ShParseErrorInfo.column}). The unconverted, raw byte-column
- * position appears only inside `.message`, mvdan/sh's own formatted string,
- * verbatim.
- *
- * @public
- */
-export declare class ShParseError extends ShAstError {
-    readonly code = "SH_AST_PARSE_ERROR";
-    readonly line: number;
-    readonly column: number;
-    readonly filename: string;
-    constructor(message: string, info: ShParseErrorInfo);
-}
-/**
- * Thrown by {@link parseSync} when {@link ParseOptions.dialect} is not one
- * of the supported {@link ShellDialect} values. Carries the rejected value
- * as `.dialect`; `.message` lists the supported dialects. A foreseeable,
- * actionable user mistake — never an instance of {@link ShParseError}.
- *
- * @public
- */
-export declare class ShInvalidDialectError extends ShAstError {
-    readonly code = "SH_AST_INVALID_DIALECT";
-    /** The rejected dialect value, exactly as passed to {@link parseSync}. */
-    readonly dialect: string;
-    constructor(dialect: string, supportedDialects: readonly ShellDialect[]);
-}
 /**
  * Thrown by {@link parseSync} for failures that should never happen given a
  * correctly-behaving WASM shim: a malformed result envelope, an unexpected
  * root node type, or any other shim contract violation. Distinct from
- * {@link ShInvalidDialectError} and {@link ShParseError}, both of which
+ * {@link InputError} and {@link ParseError}, both of which
  * indicate a foreseeable, actionable user mistake rather than an internal
  * defect.
  *

package/dist/errors.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"errors.d.ts","sourceRoot":"","sources":["../src/errors.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,YAAY,CAAC;AAE/C;;;;;;;;;;;;;;;;;;;;;;GAsBG;AACH,8BAAsB,UAAW,SAAQ,KAAK;IAC5C;;;OAGG;IACH,QAAQ,CAAC,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;CAChC;AAED;;;;GAIG;AACH,MAAM,WAAW,gBAAgB;IAC/B,4DAA4D;IAC5D,IAAI,EAAE,MAAM,CAAC;IACb;;;;;;;OAOG;IACH,MAAM,EAAE,MAAM,CAAC;IACf,2EAA2E;IAC3E,QAAQ,EAAE,MAAM,CAAC;CAClB;AAED;;;;;;;;;;;GAWG;AACH,qBAAa,YAAa,SAAQ,UAAU;IAC1C,QAAQ,CAAC,IAAI,wBAAwB;IACrC,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;IACxB,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAC;gBAEd,OAAO,EAAE,MAAM,EAAE,IAAI,EAAE,gBAAgB;CAOpD;AAED;;;;;;;GAOG;AACH,qBAAa,qBAAsB,SAAQ,UAAU;IACnD,QAAQ,CAAC,IAAI,4BAA4B;IACzC,0EAA0E;IAC1E,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;gBAEb,OAAO,EAAE,MAAM,EAAE,iBAAiB,EAAE,SAAS,YAAY,EAAE;CAOxE;AAED;;;;;;;;;GASG;AACH,qBAAa,eAAgB,SAAQ,UAAU;IAC7C,QAAQ,CAAC,IAAI,qBAAqB;gBAEtB,OAAO,EAAE,MAAM;CAI5B;AAED;;;;;;;;;;;;;;;;;;;GAmBG;AACH,qBAAa,sBAAuB,SAAQ,UAAU;IACpD,QAAQ,CAAC,IAAI,8BAA8B;IAC3C,mHAAmH;IACnH,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAC;gBAEd,QAAQ,EAAE,MAAM;CAO7B;AAED;;;;;;;;;;;;;;;;;;;;;;;;;;;GA2BG;AACH,qBAAa,oBAAqB,SAAQ,UAAU;IAClD,QAAQ,CAAC,IAAI,4BAA4B;IACzC,qHAAqH;IACrH,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAC;IAC1B;;;;OAIG;IACH,QAAQ,CAAC,cAAc,EAAE,MAAM,CAAC;gBAEpB,QAAQ,EAAE,MAAM,EAAE,cAAc,EAAE,MAAM;CAQrD;AAED;;;;;;;;;;GAUG;AACH,qBAAa,gCAAiC,SAAQ,UAAU;IAC9D,QAAQ,CAAC,IAAI,yCAAyC;gBAE1C,OAAO,EAAE,MAAM;CAI5B"}
+{"version":3,"file":"errors.d.ts","sourceRoot":"","sources":["../src/errors.ts"],"names":[],"mappings":"AAAA,8FAA8F;AAE9F;;;;;GAKG;AACH,8BAAsB,UAAW,SAAQ,KAAK;IAC5C,qEAAqE;IACrE,QAAQ,CAAC,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;CAChC;AAED;;;;;;;;;GASG;AACH,qBAAa,eAAgB,SAAQ,UAAU;IAC7C,QAAQ,CAAC,IAAI,qBAAqB;gBAEtB,OAAO,EAAE,MAAM;CAI5B;AAED;;;;;;;;;;;;;;;;;;;GAmBG;AACH,qBAAa,sBAAuB,SAAQ,UAAU;IACpD,QAAQ,CAAC,IAAI,8BAA8B;IAC3C,mHAAmH;IACnH,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAC;gBAEd,QAAQ,EAAE,MAAM;CAO7B;AAED;;;;;;;;;;;;;;;;;;;;;;;;;;;GA2BG;AACH,qBAAa,oBAAqB,SAAQ,UAAU;IAClD,QAAQ,CAAC,IAAI,4BAA4B;IACzC,qHAAqH;IACrH,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAC;IAC1B;;;;OAIG;IACH,QAAQ,CAAC,cAAc,EAAE,MAAM,CAAC;gBAEpB,QAAQ,EAAE,MAAM,EAAE,cAAc,EAAE,MAAM;CAQrD;AAED;;;;;;;;;;GAUG;AACH,qBAAa,gCAAiC,SAAQ,UAAU;IAC9D,QAAQ,CAAC,IAAI,yCAAyC;gBAE1C,OAAO,EAAE,MAAM;CAI5B"}

package/dist/errors.js

@@ -1,76 +1,17 @@
+/** Shared failure classes for binding invariants, resource limits, and analysis contracts. */
 /**
- * Common base class for every error this package throws — originally just
- * {@link sh-ast#parseSync | parseSync}'s errors, now also the
- * `sh-ast/analyze` layer's (see {@link ShAnalyzeMaxDepthError},
- * {@link ShAnalyzeInvalidWrapperSpecError}). Provides a stable, documented
- * `code` discriminator (e.g. `"SH_AST_PARSE_ERROR"`) alongside the usual
- * `instanceof` narrowing, so consumers can branch on failure kind
- * programmatically without parsing `.message` strings. Never thrown directly
- * — only via its concrete subclasses
- * ({@link sh-ast#ShParseError | ShParseError},
- * {@link sh-ast#ShInvalidDialectError | ShInvalidDialectError},
- * {@link sh-ast#ShInternalError | ShInternalError},
- * {@link ShAnalyzeMaxDepthError},
- * {@link sh-ast#ShParseMaxDepthError | ShParseMaxDepthError},
- * {@link ShAnalyzeInvalidWrapperSpecError}).
- *
- * Re-exported from `sh-ast/analyze` as well as the root `sh-ast` entry
- * point (see #23) — every subclass thrown by `sh-ast/analyze`'s own
- * functions extends this, so a consumer of that subpath alone can
- * `catch`/reference the base without also importing from root.
- *
+ * Common base for every package failure, including upstream syntax errors and
+ * analysis errors. The stable code discriminator supports programmatic handling
+ * without interpreting display messages. Only concrete subclasses are thrown.
  * @public
  */
 export class ShAstError extends Error {
 }
-/**
- * Thrown by {@link parseSync} when shell source fails to parse. Carries the
- * real position mvdan/sh reported — never 1:1 placeholders: `.line` is
- * 1-based exactly as mvdan/sh reports it, and `.column` is converted to
- * UTF-16 code units so it agrees with {@link ShNode.loc}'s columns (mvdan/sh
- * itself reports `column` as a byte count on the source line — see
- * {@link ShParseErrorInfo.column}). The unconverted, raw byte-column
- * position appears only inside `.message`, mvdan/sh's own formatted string,
- * verbatim.
- *
- * @public
- */
-export class ShParseError extends ShAstError {
-    code = 'SH_AST_PARSE_ERROR';
-    line;
-    column;
-    filename;
-    constructor(message, info) {
-        super(message);
-        this.name = 'ShParseError';
-        this.line = info.line;
-        this.column = info.column;
-        this.filename = info.filename;
-    }
-}
-/**
- * Thrown by {@link parseSync} when {@link ParseOptions.dialect} is not one
- * of the supported {@link ShellDialect} values. Carries the rejected value
- * as `.dialect`; `.message` lists the supported dialects. A foreseeable,
- * actionable user mistake — never an instance of {@link ShParseError}.
- *
- * @public
- */
-export class ShInvalidDialectError extends ShAstError {
-    code = 'SH_AST_INVALID_DIALECT';
-    /** The rejected dialect value, exactly as passed to {@link parseSync}. */
-    dialect;
-    constructor(dialect, supportedDialects) {
-        super(`bridge: unrecognized shell dialect "${dialect}"; supported dialects are: ${supportedDialects.join(', ')}`);
-        this.name = 'ShInvalidDialectError';
-        this.dialect = dialect;
-    }
-}
 /**
  * Thrown by {@link parseSync} for failures that should never happen given a
  * correctly-behaving WASM shim: a malformed result envelope, an unexpected
  * root node type, or any other shim contract violation. Distinct from
- * {@link ShInvalidDialectError} and {@link ShParseError}, both of which
+ * {@link InputError} and {@link ParseError}, both of which
  * indicate a foreseeable, actionable user mistake rather than an internal
  * defect.
  *

package/dist/errors.js.map

@@ -1 +1 @@
-{"version":3,"file":"errors.js","sourceRoot":"","sources":["../src/errors.ts"],"names":[],"mappings":"AAEA;;;;;;;;;;;;;;;;;;;;;;GAsBG;AACH,MAAM,OAAgB,UAAW,SAAQ,KAAK;CAM7C;AAuBD;;;;;;;;;;;GAWG;AACH,MAAM,OAAO,YAAa,SAAQ,UAAU;IACjC,IAAI,GAAG,oBAAoB,CAAC;IAC5B,IAAI,CAAS;IACb,MAAM,CAAS;IACf,QAAQ,CAAS;IAE1B,YAAY,OAAe,EAAE,IAAsB;QACjD,KAAK,CAAC,OAAO,CAAC,CAAC;QACf,IAAI,CAAC,IAAI,GAAG,cAAc,CAAC;QAC3B,IAAI,CAAC,IAAI,GAAG,IAAI,CAAC,IAAI,CAAC;QACtB,IAAI,CAAC,MAAM,GAAG,IAAI,CAAC,MAAM,CAAC;QAC1B,IAAI,CAAC,QAAQ,GAAG,IAAI,CAAC,QAAQ,CAAC;IAChC,CAAC;CACF;AAED;;;;;;;GAOG;AACH,MAAM,OAAO,qBAAsB,SAAQ,UAAU;IAC1C,IAAI,GAAG,wBAAwB,CAAC;IACzC,0EAA0E;IACjE,OAAO,CAAS;IAEzB,YAAY,OAAe,EAAE,iBAA0C;QACrE,KAAK,CACH,uCAAuC,OAAO,8BAA8B,iBAAiB,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE,CAC3G,CAAC;QACF,IAAI,CAAC,IAAI,GAAG,uBAAuB,CAAC;QACpC,IAAI,CAAC,OAAO,GAAG,OAAO,CAAC;IACzB,CAAC;CACF;AAED;;;;;;;;;GASG;AACH,MAAM,OAAO,eAAgB,SAAQ,UAAU;IACpC,IAAI,GAAG,iBAAiB,CAAC;IAElC,YAAY,OAAe;QACzB,KAAK,CAAC,OAAO,CAAC,CAAC;QACf,IAAI,CAAC,IAAI,GAAG,iBAAiB,CAAC;IAChC,CAAC;CACF;AAED;;;;;;;;;;;;;;;;;;;GAmBG;AACH,MAAM,OAAO,sBAAuB,SAAQ,UAAU;IAC3C,IAAI,GAAG,0BAA0B,CAAC;IAC3C,mHAAmH;IAC1G,QAAQ,CAAS;IAE1B,YAAY,QAAgB;QAC1B,KAAK,CACH,+EAA+E,MAAM,CAAC,QAAQ,CAAC,uGAAuG,CACvM,CAAC;QACF,IAAI,CAAC,IAAI,GAAG,wBAAwB,CAAC;QACrC,IAAI,CAAC,QAAQ,GAAG,QAAQ,CAAC;IAC3B,CAAC;CACF;AAED;;;;;;;;;;;;;;;;;;;;;;;;;;;GA2BG;AACH,MAAM,OAAO,oBAAqB,SAAQ,UAAU;IACzC,IAAI,GAAG,wBAAwB,CAAC;IACzC,qHAAqH;IAC5G,QAAQ,CAAS;IAC1B;;;;OAIG;IACM,cAAc,CAAS;IAEhC,YAAY,QAAgB,EAAE,cAAsB;QAClD,KAAK,CACH,0DAA0D,MAAM,CAAC,cAAc,CAAC,sDAAsD,MAAM,CAAC,QAAQ,CAAC,kKAAkK,CACzT,CAAC;QACF,IAAI,CAAC,IAAI,GAAG,sBAAsB,CAAC;QACnC,IAAI,CAAC,QAAQ,GAAG,QAAQ,CAAC;QACzB,IAAI,CAAC,cAAc,GAAG,cAAc,CAAC;IACvC,CAAC;CACF;AAED;;;;;;;;;;GAUG;AACH,MAAM,OAAO,gCAAiC,SAAQ,UAAU;IACrD,IAAI,GAAG,qCAAqC,CAAC;IAEtD,YAAY,OAAe;QACzB,KAAK,CAAC,qDAAqD,OAAO,EAAE,CAAC,CAAC;QACtE,IAAI,CAAC,IAAI,GAAG,kCAAkC,CAAC;IACjD,CAAC;CACF"}
+{"version":3,"file":"errors.js","sourceRoot":"","sources":["../src/errors.ts"],"names":[],"mappings":"AAAA,8FAA8F;AAE9F;;;;;GAKG;AACH,MAAM,OAAgB,UAAW,SAAQ,KAAK;CAG7C;AAED;;;;;;;;;GASG;AACH,MAAM,OAAO,eAAgB,SAAQ,UAAU;IACpC,IAAI,GAAG,iBAAiB,CAAC;IAElC,YAAY,OAAe;QACzB,KAAK,CAAC,OAAO,CAAC,CAAC;QACf,IAAI,CAAC,IAAI,GAAG,iBAAiB,CAAC;IAChC,CAAC;CACF;AAED;;;;;;;;;;;;;;;;;;;GAmBG;AACH,MAAM,OAAO,sBAAuB,SAAQ,UAAU;IAC3C,IAAI,GAAG,0BAA0B,CAAC;IAC3C,mHAAmH;IAC1G,QAAQ,CAAS;IAE1B,YAAY,QAAgB;QAC1B,KAAK,CACH,+EAA+E,MAAM,CAAC,QAAQ,CAAC,uGAAuG,CACvM,CAAC;QACF,IAAI,CAAC,IAAI,GAAG,wBAAwB,CAAC;QACrC,IAAI,CAAC,QAAQ,GAAG,QAAQ,CAAC;IAC3B,CAAC;CACF;AAED;;;;;;;;;;;;;;;;;;;;;;;;;;;GA2BG;AACH,MAAM,OAAO,oBAAqB,SAAQ,UAAU;IACzC,IAAI,GAAG,wBAAwB,CAAC;IACzC,qHAAqH;IAC5G,QAAQ,CAAS;IAC1B;;;;OAIG;IACM,cAAc,CAAS;IAEhC,YAAY,QAAgB,EAAE,cAAsB;QAClD,KAAK,CACH,0DAA0D,MAAM,CAAC,cAAc,CAAC,sDAAsD,MAAM,CAAC,QAAQ,CAAC,kKAAkK,CACzT,CAAC;QACF,IAAI,CAAC,IAAI,GAAG,sBAAsB,CAAC;QACnC,IAAI,CAAC,QAAQ,GAAG,QAAQ,CAAC;QACzB,IAAI,CAAC,cAAc,GAAG,cAAc,CAAC;IACvC,CAAC;CACF;AAED;;;;;;;;;;GAUG;AACH,MAAM,OAAO,gCAAiC,SAAQ,UAAU;IACrD,IAAI,GAAG,qCAAqC,CAAC;IAEtD,YAAY,OAAe;QACzB,KAAK,CAAC,qDAAqD,OAAO,EAAE,CAAC,CAAC;QACtE,IAAI,CAAC,IAAI,GAAG,kCAAkC,CAAC;IACjD,CAAC;CACF"}

package/dist/index.d.ts

@@ -1,18 +1,24 @@
-export { parseSync } from './parse.js';
-export { ShAnalyzeInvalidWrapperSpecError, ShAnalyzeMaxDepthError, ShAstError, ShInternalError, ShInvalidDialectError, ShParseError, ShParseMaxDepthError, } from './errors.js';
-export type { ShParseErrorInfo } from './errors.js';
-export type { ParseOptions, Position, ShellDialect, ShFile, ShNode } from './types.js';
-export { visitorKeys } from './visitor-keys.js';
-export { walk } from './walk.js';
+export { InputError, LangError, ParseError, newPos, nodeEnd, nodePos, parseSync, parseWithPositionsSync, rawOperator, } from './syntax.js';
+export type { ParseOptions, ParsedFile, PositionSnapshot, NodePositions } from './syntax.js';
+export { printSync } from './syntax-print.js';
+export type { PrintOptions } from './syntax-print.js';
+export { PrintError, PrintPanicError } from './syntax-print-errors.js';
+export { walk, WalkPanicError } from './syntax-walk.js';
+export type * from '../generated/syntax-types.js';
+export * from '../generated/syntax-constants.js';
+export type { SyntaxFieldSchema, SyntaxRecordSchema } from '../generated/syntax-schema.js';
+export { ShAnalyzeInvalidWrapperSpecError, ShAnalyzeMaxDepthError, ShAstError, ShInternalError, ShParseMaxDepthError, } from './errors.js';
 /**
- * Strongly-typed `ShNode` subtypes for every mvdan/sh node type — generated
- * by `tools/gen-visitor-keys` alongside {@link visitorKeys} (see
- * design/ARCHITECTURE.md, "The schema table is generated, not
- * hand-written"). {@link ShNode}'s index signature remains the base
- * contract; these are an additive, opt-in stronger typing for consumers
- * that want e.g. `ShNodes.ShCallExprNode` instead of a generic `ShNode`.
- *
+ * Complete upstream field metadata for validating or adapting syntax records.
+ * Metadata order is not the upstream Walk visitation order. Shared records are
+ * deeply frozen even though the syntax values they describe are mutable.
  * @public
  */
-export type * as ShNodes from '../generated/node-types.js';
+export declare const SYNTAX_SCHEMA: Readonly<Readonly<Record<string, import("../generated/syntax-schema.js").SyntaxRecordSchema>>>;
+/**
+ * Concrete alternatives for upstream syntax interfaces. Auxiliary records are
+ * absent from Node; consumers must preserve that distinction in their adapters.
+ * @public
+ */
+export declare const SYNTAX_INTERFACES: Readonly<Readonly<Record<string, readonly string[]>>>;
 //# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,SAAS,EAAE,MAAM,YAAY,CAAC;AACvC,OAAO,EACL,gCAAgC,EAChC,sBAAsB,EACtB,UAAU,EACV,eAAe,EACf,qBAAqB,EACrB,YAAY,EACZ,oBAAoB,GACrB,MAAM,aAAa,CAAC;AACrB,YAAY,EAAE,gBAAgB,EAAE,MAAM,aAAa,CAAC;AACpD,YAAY,EAAE,YAAY,EAAE,QAAQ,EAAE,YAAY,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,YAAY,CAAC;AACvF,OAAO,EAAE,WAAW,EAAE,MAAM,mBAAmB,CAAC;AAChD,OAAO,EAAE,IAAI,EAAE,MAAM,WAAW,CAAC;AAEjC;;;;;;;;;GASG;AACH,YAAY,KAAK,OAAO,MAAM,4BAA4B,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAWA,OAAO,EACL,UAAU,EACV,SAAS,EACT,UAAU,EACV,MAAM,EACN,OAAO,EACP,OAAO,EACP,SAAS,EACT,sBAAsB,EACtB,WAAW,GACZ,MAAM,aAAa,CAAC;AACrB,YAAY,EAAE,YAAY,EAAE,UAAU,EAAE,gBAAgB,EAAE,aAAa,EAAE,MAAM,aAAa,CAAC;AAC7F,OAAO,EAAE,SAAS,EAAE,MAAM,mBAAmB,CAAC;AAC9C,YAAY,EAAE,YAAY,EAAE,MAAM,mBAAmB,CAAC;AACtD,OAAO,EAAE,UAAU,EAAE,eAAe,EAAE,MAAM,0BAA0B,CAAC;AACvE,OAAO,EAAE,IAAI,EAAE,cAAc,EAAE,MAAM,kBAAkB,CAAC;AACxD,mBAAmB,8BAA8B,CAAC;AAClD,cAAc,kCAAkC,CAAC;AACjD,YAAY,EAAE,iBAAiB,EAAE,kBAAkB,EAAE,MAAM,+BAA+B,CAAC;AAC3F,OAAO,EACL,gCAAgC,EAChC,sBAAsB,EACtB,UAAU,EACV,eAAe,EACf,oBAAoB,GACrB,MAAM,aAAa,CAAC;AAErB;;;;;GAKG;AACH,eAAO,MAAM,aAAa,gGAAqB,CAAC;AAEhD;;;;GAIG;AACH,eAAO,MAAM,iBAAiB,uDAAyB,CAAC"}

package/dist/index.js

@@ -1,5 +1,27 @@
-export { parseSync } from './parse.js';
-export { ShAnalyzeInvalidWrapperSpecError, ShAnalyzeMaxDepthError, ShAstError, ShInternalError, ShInvalidDialectError, ShParseError, ShParseMaxDepthError, } from './errors.js';
-export { visitorKeys } from './visitor-keys.js';
-export { walk } from './walk.js';
+/**
+ * A faithful synchronous interface to mvdan/sh syntax. The root exposes upstream
+ * records, constants, parser controls, traversal, printing and position operations. Consumer-specific
+ * source views and semantic analysis are separate responsibilities.
+ */
+import { SYNTAX_INTERFACES as interfaces, SYNTAX_SCHEMA as schema, } from '../generated/syntax-schema.js';
+import { deepFreeze } from './deep-freeze.js';
+export { InputError, LangError, ParseError, newPos, nodeEnd, nodePos, parseSync, parseWithPositionsSync, rawOperator, } from './syntax.js';
+export { printSync } from './syntax-print.js';
+export { PrintError, PrintPanicError } from './syntax-print-errors.js';
+export { walk, WalkPanicError } from './syntax-walk.js';
+export * from '../generated/syntax-constants.js';
+export { ShAnalyzeInvalidWrapperSpecError, ShAnalyzeMaxDepthError, ShAstError, ShInternalError, ShParseMaxDepthError, } from './errors.js';
+/**
+ * Complete upstream field metadata for validating or adapting syntax records.
+ * Metadata order is not the upstream Walk visitation order. Shared records are
+ * deeply frozen even though the syntax values they describe are mutable.
+ * @public
+ */
+export const SYNTAX_SCHEMA = deepFreeze(schema);
+/**
+ * Concrete alternatives for upstream syntax interfaces. Auxiliary records are
+ * absent from Node; consumers must preserve that distinction in their adapters.
+ * @public
+ */
+export const SYNTAX_INTERFACES = deepFreeze(interfaces);
 //# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,SAAS,EAAE,MAAM,YAAY,CAAC;AACvC,OAAO,EACL,gCAAgC,EAChC,sBAAsB,EACtB,UAAU,EACV,eAAe,EACf,qBAAqB,EACrB,YAAY,EACZ,oBAAoB,GACrB,MAAM,aAAa,CAAC;AAGrB,OAAO,EAAE,WAAW,EAAE,MAAM,mBAAmB,CAAC;AAChD,OAAO,EAAE,IAAI,EAAE,MAAM,WAAW,CAAC"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AACH,OAAO,EACL,iBAAiB,IAAI,UAAU,EAC/B,aAAa,IAAI,MAAM,GACxB,MAAM,+BAA+B,CAAC;AACvC,OAAO,EAAE,UAAU,EAAE,MAAM,kBAAkB,CAAC;AAE9C,OAAO,EACL,UAAU,EACV,SAAS,EACT,UAAU,EACV,MAAM,EACN,OAAO,EACP,OAAO,EACP,SAAS,EACT,sBAAsB,EACtB,WAAW,GACZ,MAAM,aAAa,CAAC;AAErB,OAAO,EAAE,SAAS,EAAE,MAAM,mBAAmB,CAAC;AAE9C,OAAO,EAAE,UAAU,EAAE,eAAe,EAAE,MAAM,0BAA0B,CAAC;AACvE,OAAO,EAAE,IAAI,EAAE,cAAc,EAAE,MAAM,kBAAkB,CAAC;AAExD,cAAc,kCAAkC,CAAC;AAEjD,OAAO,EACL,gCAAgC,EAChC,sBAAsB,EACtB,UAAU,EACV,eAAe,EACf,oBAAoB,GACrB,MAAM,aAAa,CAAC;AAErB;;;;;GAKG;AACH,MAAM,CAAC,MAAM,aAAa,GAAG,UAAU,CAAC,MAAM,CAAC,CAAC;AAEhD;;;;GAIG;AACH,MAAM,CAAC,MAAM,iBAAiB,GAAG,UAAU,CAAC,UAAU,CAAC,CAAC"}