parser-lr 0.0.0 → 0.2.0

package/dist/lib/grammar/grammar-literals.js

@@ -0,0 +1,67 @@
+import { ReadGrammarError } from './read-grammar-error.js';
+/**
+ * Decodes a grammar-file string literal into its value.
+ *
+ * @param text - Quoted string literal text including surrounding quotes.
+ * @returns Decoded string contents.
+ */
+export function decodeStringLiteral(text) {
+    let value = '';
+    let index = 1;
+    // Walk the literal body, expanding escape sequences.
+    while (index < text.length - 1) {
+        const char = text[index];
+        if (char === '\\') {
+            const next = text[index + 1];
+            switch (next) {
+                case '"':
+                case '\\':
+                    value += next;
+                    index += 2;
+                    continue;
+                case 'n':
+                    value += '\n';
+                    index += 2;
+                    continue;
+                case 'r':
+                    value += '\r';
+                    index += 2;
+                    continue;
+                case 't':
+                    value += '\t';
+                    index += 2;
+                    continue;
+                default:
+                    throw new ReadGrammarError(`Unsupported escape sequence \\${next ?? ''}`, index);
+            }
+        }
+        value += char;
+        index += 1;
+    }
+    return value;
+}
+/**
+ * Splits a regex literal token into pattern and flag components.
+ *
+ * @param text - Regex literal text including slashes and optional flags.
+ * @returns Pattern body and flag letters.
+ */
+export function splitRegexLiteral(text) {
+    let index = 1;
+    // Find the closing slash, honoring escapes.
+    while (index < text.length) {
+        const char = text[index];
+        if (char === '\\') {
+            index += 2;
+            continue;
+        }
+        if (char === '/') {
+            break;
+        }
+        index += 1;
+    }
+    const pattern = text.slice(1, index);
+    const flags = text.slice(index + 1);
+    return { pattern, flags };
+}
+//# sourceMappingURL=grammar-literals.js.map

package/dist/lib/grammar/grammar-literals.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"grammar-literals.js","sourceRoot":"","sources":["../../../src/lib/grammar/grammar-literals.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,gBAAgB,EAAE,MAAM,yBAAyB,CAAC;AAE3D;;;;;GAKG;AACH,MAAM,UAAU,mBAAmB,CAAC,IAAY;IAE5C,IAAI,KAAK,GAAG,EAAE,CAAC;IACf,IAAI,KAAK,GAAG,CAAC,CAAC;IAEd,qDAAqD;IACrD,OAAO,KAAK,GAAG,IAAI,CAAC,MAAM,GAAG,CAAC,EAC9B,CAAC;QACG,MAAM,IAAI,GAAG,IAAI,CAAC,KAAK,CAAC,CAAC;QAEzB,IAAI,IAAI,KAAK,IAAI,EACjB,CAAC;YACG,MAAM,IAAI,GAAG,IAAI,CAAC,KAAK,GAAG,CAAC,CAAC,CAAC;YAE7B,QAAQ,IAAI,EACZ,CAAC;gBACG,KAAK,GAAG,CAAC;gBACT,KAAK,IAAI;oBACL,KAAK,IAAI,IAAI,CAAC;oBACd,KAAK,IAAI,CAAC,CAAC;oBACX,SAAS;gBACb,KAAK,GAAG;oBACJ,KAAK,IAAI,IAAI,CAAC;oBACd,KAAK,IAAI,CAAC,CAAC;oBACX,SAAS;gBACb,KAAK,GAAG;oBACJ,KAAK,IAAI,IAAI,CAAC;oBACd,KAAK,IAAI,CAAC,CAAC;oBACX,SAAS;gBACb,KAAK,GAAG;oBACJ,KAAK,IAAI,IAAI,CAAC;oBACd,KAAK,IAAI,CAAC,CAAC;oBACX,SAAS;gBACb;oBACI,MAAM,IAAI,gBAAgB,CACtB,iCAAiC,IAAI,IAAI,EAAE,EAAE,EAC7C,KAAK,CACR,CAAC;YACV,CAAC;QACL,CAAC;QAED,KAAK,IAAI,IAAI,CAAC;QACd,KAAK,IAAI,CAAC,CAAC;IACf,CAAC;IAED,OAAO,KAAK,CAAC;AACjB,CAAC;AAED;;;;;GAKG;AACH,MAAM,UAAU,iBAAiB,CAAC,IAAY;IAE1C,IAAI,KAAK,GAAG,CAAC,CAAC;IAEd,4CAA4C;IAC5C,OAAO,KAAK,GAAG,IAAI,CAAC,MAAM,EAC1B,CAAC;QACG,MAAM,IAAI,GAAG,IAAI,CAAC,KAAK,CAAC,CAAC;QAEzB,IAAI,IAAI,KAAK,IAAI,EACjB,CAAC;YACG,KAAK,IAAI,CAAC,CAAC;YACX,SAAS;QACb,CAAC;QAED,IAAI,IAAI,KAAK,GAAG,EAChB,CAAC;YACG,MAAM;QACV,CAAC;QAED,KAAK,IAAI,CAAC,CAAC;IACf,CAAC;IAED,MAAM,OAAO,GAAG,IAAI,CAAC,KAAK,CAAC,CAAC,EAAE,KAAK,CAAC,CAAC;IACrC,MAAM,KAAK,GAAG,IAAI,CAAC,KAAK,CAAC,KAAK,GAAG,CAAC,CAAC,CAAC;IAEpC,OAAO,EAAE,OAAO,EAAE,KAAK,EAAE,CAAC;AAC9B,CAAC"}

package/dist/lib/grammar/grammar.d.ts

@@ -0,0 +1,45 @@
+import type { AstSchema } from './ast-schema.js';
+import type { Production } from './production.js';
+import type { TokenRule } from './token-rule.js';
+import type { TransformSchema } from './transform-schema.js';
+/**
+ * Parsed `.grammar` file: lexer rules, skip rules, and parser productions.
+ */
+export declare class Grammar {
+    readonly name: string;
+    readonly tokenRules: readonly TokenRule[];
+    readonly skipRules: readonly TokenRule[];
+    readonly states: readonly string[];
+    readonly startSymbol: string;
+    readonly productions: readonly Production[];
+    readonly astSchema: AstSchema | null;
+    readonly transformSchema: TransformSchema | null;
+    private readonly productionsByName;
+    /**
+     * Creates a grammar from its file-level sections.
+     *
+     * @param name - Grammar name from the `name` declaration.
+     * @param tokenRules - Token definitions from the `tokens` section.
+     * @param skipRules - Skip definitions from the `skip` section.
+     * @param states - State names from the `states` section.
+     * @param startSymbol - Entry production from the `start` declaration.
+     * @param productions - Productions from the `grammar` section.
+     * @param astSchema - AST types from the `ast` section, or null when omitted.
+     * @param transformSchema - CST-to-AST rules from the `transform` section, or null when omitted.
+     */
+    constructor(name: string, tokenRules: readonly TokenRule[], skipRules: readonly TokenRule[], states: readonly string[], startSymbol: string, productions: readonly Production[], astSchema?: AstSchema | null, transformSchema?: TransformSchema | null);
+    /**
+     * Returns a production by non-terminal name.
+     *
+     * @param name - Production name to look up.
+     * @returns The matching production, or null when the name is undefined.
+     */
+    production(name: string): Production | null;
+    /**
+     * Whether a named non-terminal is defined in this grammar.
+     *
+     * @param name - Production name to test.
+     */
+    hasProduction(name: string): boolean;
+}
+//# sourceMappingURL=grammar.d.ts.map

package/dist/lib/grammar/grammar.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"grammar.d.ts","sourceRoot":"","sources":["../../../src/lib/grammar/grammar.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,iBAAiB,CAAC;AACjD,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,iBAAiB,CAAC;AAClD,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,iBAAiB,CAAC;AACjD,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,uBAAuB,CAAC;AAE7D;;GAEG;AACH,qBAAa,OAAO;aAiBI,IAAI,EAAE,MAAM;aACZ,UAAU,EAAE,SAAS,SAAS,EAAE;aAChC,SAAS,EAAE,SAAS,SAAS,EAAE;aAC/B,MAAM,EAAE,SAAS,MAAM,EAAE;aACzB,WAAW,EAAE,MAAM;aACnB,WAAW,EAAE,SAAS,UAAU,EAAE;aAClC,SAAS,EAAE,SAAS,GAAG,IAAI;aAC3B,eAAe,EAAE,eAAe,GAAG,IAAI;IAtB3D,OAAO,CAAC,QAAQ,CAAC,iBAAiB,CAAkC;IAEpE;;;;;;;;;;;OAWG;gBAEiB,IAAI,EAAE,MAAM,EACZ,UAAU,EAAE,SAAS,SAAS,EAAE,EAChC,SAAS,EAAE,SAAS,SAAS,EAAE,EAC/B,MAAM,EAAE,SAAS,MAAM,EAAE,EACzB,WAAW,EAAE,MAAM,EACnB,WAAW,EAAE,SAAS,UAAU,EAAE,EAClC,SAAS,GAAE,SAAS,GAAG,IAAW,EAClC,eAAe,GAAE,eAAe,GAAG,IAAW;IAclE;;;;;OAKG;IACI,UAAU,CAAC,IAAI,EAAE,MAAM,GAAG,UAAU,GAAG,IAAI;IAKlD;;;;OAIG;IACI,aAAa,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO;CAI9C"}

package/dist/lib/grammar/grammar.js

@@ -0,0 +1,60 @@
+/**
+ * Parsed `.grammar` file: lexer rules, skip rules, and parser productions.
+ */
+export class Grammar {
+    name;
+    tokenRules;
+    skipRules;
+    states;
+    startSymbol;
+    productions;
+    astSchema;
+    transformSchema;
+    productionsByName;
+    /**
+     * Creates a grammar from its file-level sections.
+     *
+     * @param name - Grammar name from the `name` declaration.
+     * @param tokenRules - Token definitions from the `tokens` section.
+     * @param skipRules - Skip definitions from the `skip` section.
+     * @param states - State names from the `states` section.
+     * @param startSymbol - Entry production from the `start` declaration.
+     * @param productions - Productions from the `grammar` section.
+     * @param astSchema - AST types from the `ast` section, or null when omitted.
+     * @param transformSchema - CST-to-AST rules from the `transform` section, or null when omitted.
+     */
+    constructor(name, tokenRules, skipRules, states, startSymbol, productions, astSchema = null, transformSchema = null) {
+        this.name = name;
+        this.tokenRules = tokenRules;
+        this.skipRules = skipRules;
+        this.states = states;
+        this.startSymbol = startSymbol;
+        this.productions = productions;
+        this.astSchema = astSchema;
+        this.transformSchema = transformSchema;
+        // Index productions by name for lookup.
+        const productionsByName = new Map();
+        for (const production of productions) {
+            productionsByName.set(production.name, production);
+        }
+        this.productionsByName = productionsByName;
+    }
+    /**
+     * Returns a production by non-terminal name.
+     *
+     * @param name - Production name to look up.
+     * @returns The matching production, or null when the name is undefined.
+     */
+    production(name) {
+        return this.productionsByName.get(name) ?? null;
+    }
+    /**
+     * Whether a named non-terminal is defined in this grammar.
+     *
+     * @param name - Production name to test.
+     */
+    hasProduction(name) {
+        return this.productionsByName.has(name);
+    }
+}
+//# sourceMappingURL=grammar.js.map

package/dist/lib/grammar/grammar.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"grammar.js","sourceRoot":"","sources":["../../../src/lib/grammar/grammar.ts"],"names":[],"mappings":"AAKA;;GAEG;AACH,MAAM,OAAO,OAAO;IAiBI;IACA;IACA;IACA;IACA;IACA;IACA;IACA;IAtBH,iBAAiB,CAAkC;IAEpE;;;;;;;;;;;OAWG;IACH,YACoB,IAAY,EACZ,UAAgC,EAChC,SAA+B,EAC/B,MAAyB,EACzB,WAAmB,EACnB,WAAkC,EAClC,YAA8B,IAAI,EAClC,kBAA0C,IAAI;QAP9C,SAAI,GAAJ,IAAI,CAAQ;QACZ,eAAU,GAAV,UAAU,CAAsB;QAChC,cAAS,GAAT,SAAS,CAAsB;QAC/B,WAAM,GAAN,MAAM,CAAmB;QACzB,gBAAW,GAAX,WAAW,CAAQ;QACnB,gBAAW,GAAX,WAAW,CAAuB;QAClC,cAAS,GAAT,SAAS,CAAyB;QAClC,oBAAe,GAAf,eAAe,CAA+B;QAG9D,wCAAwC;QACxC,MAAM,iBAAiB,GAAG,IAAI,GAAG,EAAsB,CAAC;QAExD,KAAK,MAAM,UAAU,IAAI,WAAW,EACpC,CAAC;YACG,iBAAiB,CAAC,GAAG,CAAC,UAAU,CAAC,IAAI,EAAE,UAAU,CAAC,CAAC;QACvD,CAAC;QAED,IAAI,CAAC,iBAAiB,GAAG,iBAAiB,CAAC;IAC/C,CAAC;IAED;;;;;OAKG;IACI,UAAU,CAAC,IAAY;QAE1B,OAAO,IAAI,CAAC,iBAAiB,CAAC,GAAG,CAAC,IAAI,CAAC,IAAI,IAAI,CAAC;IACpD,CAAC;IAED;;;;OAIG;IACI,aAAa,CAAC,IAAY;QAE7B,OAAO,IAAI,CAAC,iBAAiB,CAAC,GAAG,CAAC,IAAI,CAAC,CAAC;IAC5C,CAAC;CACJ"}