parseman 0.2.0 → 0.3.0

package/dist/plugin/evaluator.d.ts

@@ -2,14 +2,34 @@
  * Statically evaluates parseman combinator call expressions from an oxc AST
  * into actual Combinator<unknown> objects by calling the real library functions.
  *
- * Returns null for anything unresolvable (user closures, external variables,
- * template literals, computed keys, etc.) — callers leave those as-is.
+ * Returns null for anything unresolvable (external variables, template literals,
+ * computed keys, etc.) — callers leave those as-is.
  */
 import type { Expression, Node } from '@oxc-project/types';
 import type { Combinator } from '../types.ts';
-export type Scope = Map<string, Combinator<unknown>>;
-/** Try to evaluate an oxc AST Expression as a parseman Combinator. Returns null if impossible. */
-export declare function evaluateExpr(node: Expression, scope: Scope): Combinator<unknown> | null;
-/** Check if an AST node references any name from the given set (used to detect parseman usage). */
+export type ScopeEntry = {
+    combi: Combinator<unknown>;
+    mfSrcs: string[];
+};
+export type Scope = Map<string, ScopeEntry>;
+/** Evaluate a single combinator expression. Returns null if unresolvable. */
+export declare function evaluateExpr(node: Expression, scope: Scope, code?: string, mapFnSources?: string[]): Combinator<unknown> | null;
+/**
+ * Evaluate a `parser(g => { ... return { ruleName: combinator, ... } })` call.
+ * Returns a map of rule names → defined Combinators, or null if the factory
+ * can't be statically evaluated.
+ *
+ * mapFnSources is populated with the sources for mapFns that codegen will push
+ * when compiling each returned rule — each rule's entry in the map will produce
+ * a sub-slice of mapFnSources aligned to its specific ctx.mapFns.
+ *
+ * Important: this function uses a SEPARATE accumulator for body statement
+ * evaluation so that only the return-expression phase adds entries to the
+ * caller-provided mapFnSources (which is what compile() will receive).
+ * The body-phase entries are stored as `mfSrcs` on localScope entries and
+ * replayed when those entries are referenced during return evaluation.
+ */
+export declare function evaluateParserFactory(factoryNode: Expression, scope: Scope, code: string, mapFnSources: string[]): Map<string, Combinator<unknown>> | null;
+/** Check if an AST node references any name from the given scope or names set. */
 export declare function referencesAny(node: Node, names: Set<string>, scope: Scope): boolean;
 //# sourceMappingURL=evaluator.d.ts.map

package/dist/plugin/evaluator.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"evaluator.d.ts","sourceRoot":"","sources":["../../src/plugin/evaluator.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AACH,OAAO,KAAK,EAAE,UAAU,EAAE,IAAI,EAAE,MAAM,oBAAoB,CAAA;AAC1D,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,aAAa,CAAA;AAG7C,MAAM,MAAM,KAAK,GAAG,GAAG,CAAC,MAAM,EAAE,UAAU,CAAC,OAAO,CAAC,CAAC,CAAA;AAcpD,kGAAkG;AAClG,wBAAgB,YAAY,CAAC,IAAI,EAAE,UAAU,EAAE,KAAK,EAAE,KAAK,GAAG,UAAU,CAAC,OAAO,CAAC,GAAG,IAAI,CAsBvF;AAoCD,mGAAmG;AACnG,wBAAgB,aAAa,CAAC,IAAI,EAAE,IAAI,EAAE,KAAK,EAAE,GAAG,CAAC,MAAM,CAAC,EAAE,KAAK,EAAE,KAAK,GAAG,OAAO,CAcnF"}
+{"version":3,"file":"evaluator.d.ts","sourceRoot":"","sources":["../../src/plugin/evaluator.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AACH,OAAO,KAAK,EACV,UAAU,EAAE,IAAI,EAMjB,MAAM,oBAAoB,CAAA;AAC3B,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,aAAa,CAAA;AAa7C,MAAM,MAAM,UAAU,GAAG;IACvB,KAAK,EAAE,UAAU,CAAC,OAAO,CAAC,CAAA;IAC1B,MAAM,EAAE,MAAM,EAAE,CAAA;CACjB,CAAA;AACD,MAAM,MAAM,KAAK,GAAG,GAAG,CAAC,MAAM,EAAE,UAAU,CAAC,CAAA;AAoQ3C,6EAA6E;AAC7E,wBAAgB,YAAY,CAC1B,IAAI,EAAE,UAAU,EAChB,KAAK,EAAE,KAAK,EACZ,IAAI,CAAC,EAAE,MAAM,EACb,YAAY,CAAC,EAAE,MAAM,EAAE,GACtB,UAAU,CAAC,OAAO,CAAC,GAAG,IAAI,CAE5B;AAED;;;;;;;;;;;;;;GAcG;AACH,wBAAgB,qBAAqB,CACnC,WAAW,EAAE,UAAU,EACvB,KAAK,EAAE,KAAK,EACZ,IAAI,EAAE,MAAM,EACZ,YAAY,EAAE,MAAM,EAAE,GACrB,GAAG,CAAC,MAAM,EAAE,UAAU,CAAC,OAAO,CAAC,CAAC,GAAG,IAAI,CAuGzC;AAED,kFAAkF;AAClF,wBAAgB,aAAa,CAAC,IAAI,EAAE,IAAI,EAAE,KAAK,EAAE,GAAG,CAAC,MAAM,CAAC,EAAE,KAAK,EAAE,KAAK,GAAG,OAAO,CAcnF"}