parseman 0.61.2 → 0.61.4

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

@@ -1 +1 @@
-{"version":3,"file":"evaluator.d.ts","sourceRoot":"","sources":["../../src/plugin/evaluator.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"evaluator.d.ts","sourceRoot":"","sources":["../../src/plugin/evaluator.ts"],"names":[],"mappings":"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"}

package/dist/plugin/index.d.ts

@@ -71,23 +71,41 @@ export type ParsecraftPluginOptions = {
      */
     assemblyProfile?: AssemblyProfile;
     /**
-     * Generated assembly bytes each module may spend, as a multiple of its own source
-     * length. **Default `0.25`.** `0` ships no assembly. The right number is
+     * Generated assembly bytes each module may spend, as a multiple of its own code,
+     * comments and whitespace aside. **Default `0.5`.** `0` ships no assembly. The right number is
      * per grammar: a larger one parses faster in steady state and costs import and
      * first-parse time, so measure both, and keep the artifact within 5× its source
-     * (docs/design/runtime-and-size-contract.md, rules 4 and 6).
+     * (docs/design/runtime-and-size-contract.md, rules 4 and 6). A larger budget never
+     * loses a site, with one limit: a module with two AST grammars spends it in order, so
+     * a larger budget can buy the first a big site and leave the second fewer.
      */
     assemblyBudget?: number;
 };
 /** A corpus a build parses to rank selective-assembly sites — see `assemblyProfile`. */
 export type AssemblyProfile = {
-    /** The rule each corpus file is parsed from, e.g. `'Stylesheet'`. A grammar
-     * without this rule keeps the static ranking. */
+    /** The rule each corpus file is parsed from, e.g. `'Stylesheet'`. A grammar without
+     * this rule keeps the static ranking. A build fails when grammars were profiled and
+     * none has the rule. A direct `transformMacro` caller gets `assemblyProfile:
+     * 'no-entry'` on the result instead, and has to read it. */
     readonly entry: string;
     /** Paths of representative inputs. At least one must have content, and each that
      * does has to parse in full without recovery, or the build fails. A file with only
-     * whitespace counts as empty. */
+     * whitespace counts as empty. A callback the corpus doesn't reach is never run, so
+     * nothing checks it. */
     readonly files: readonly string[];
+    /**
+     * The values of names a grammar's reducers and gates import, for the corpus run.
+     * Their source runs at build time with no module around it, so a grammar whose
+     * callbacks read imported helpers passes those helpers here. See
+     * `docs/guide/macro-mode.md` for what this does and doesn't cover.
+     *
+     * It's one flat namespace, so two modules can't bind one name to different helpers.
+     * A name that's already a global fails the build. A helper named like a global and
+     * left out of `scope` silently uses the global. A direct `node()` builder doesn't
+     * run in the corpus run: a plain node stands in for it, so a helper only a builder
+     * reads is neither needed here nor checked.
+     */
+    readonly scope?: Readonly<Record<string, unknown>>;
 };
 declare const _default: import("unplugin").UnpluginInstance<ParsecraftPluginOptions, boolean>;
 export default _default;
@@ -96,6 +114,11 @@ export type TransformMacroResult = {
     map: ReturnType<MagicString['generateMap']>;
     /** Diagnostics for macro-referencing shapes that fell back to the interpreter. */
     warnings: string[];
+    /** With an `assemblyProfile`: `'ran'` when a grammar here parsed the corpus,
+     * `'no-entry'` when the grammars that could have don't have its `entry` rule. */
+    assemblyProfile?: 'ran' | 'no-entry';
+    /** The sites the module's `assemblyBudget` bought, by program offset, in rank order. */
+    assemblySites: number[];
 };
 /**
  * Transform one module, ALWAYS releasing the process-global capture state.

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

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/plugin/index.ts"],"names":[],"mappings":"AAyBA,OAAO,WAAW,MAAM,cAAc,CAAA;AActC,OAAO,EAAsC,KAAK,OAAO,EAAE,MAAM,uBAAuB,CAAA;AA6BxF;;;;;;;;;;;;;;;GAeG;AACH,MAAM,MAAM,kBAAkB,GAAG,OAAO,GAAG;IAAE,IAAI,EAAE,MAAM,CAAC;IAAC,IAAI,EAAE,MAAM,CAAA;CAAE,CAAA;AACzE;;;;;GAKG;AACH,MAAM,MAAM,eAAe,GAAG,OAAO,GAAG;IAAE,IAAI,EAAE,MAAM,CAAC;IAAC,IAAI,EAAE,MAAM,CAAC;IAAC,QAAQ,CAAC,EAAE,SAAS,kBAAkB,EAAE,CAAA;CAAE,CAAA;AAChH,kDAAkD;AAClD,MAAM,MAAM,WAAW,GAAG,GAAG,CAAC,MAAM,EAAE,eAAe,EAAE,CAAC,CAAA;AACxD,eAAO,MAAM,sBAAsB,mBAAmB,CAAA;AAQtD;;;;GAIG;AACH,wBAAgB,cAAc,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,CAGnD;AA+BD,MAAM,MAAM,uBAAuB,GAAG;IACpC,8DAA8D;IAC9D,aAAa,CAAC,EAAE,MAAM,EAAE,CAAA;IACxB;;;;;;OAMG;IACH,kBAAkB,CAAC,EAAE,OAAO,CAAA;IAC5B;;;;OAIG;IACH,QAAQ,CAAC,EAAE,OAAO,CAAA;IAClB;8CAC0C;IAC1C,eAAe,CAAC,EAAE,OAAO,CAAA;IACzB;;;;;;;;OAQG;IACH,eAAe,CAAC,EAAE,eAAe,CAAA;IACjC;;;;;;OAMG;IACH,cAAc,CAAC,EAAE,MAAM,CAAA;CACxB,CAAA;AAED,wFAAwF;AACxF,MAAM,MAAM,eAAe,GAAG;IAC5B;qDACiD;IACjD,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAA;IACtB;;qCAEiC;IACjC,QAAQ,CAAC,KAAK,EAAE,SAAS,MAAM,EAAE,CAAA;CAClC,CAAA;;;AAgkBD,MAAM,MAAM,oBAAoB,GAAG;IACjC,IAAI,EAAE,MAAM,CAAA;IACZ,GAAG,EAAE,UAAU,CAAC,WAAW,CAAC,aAAa,CAAC,CAAC,CAAA;IAC3C,kFAAkF;IAClF,QAAQ,EAAE,MAAM,EAAE,CAAA;CACnB,CAAA;AA0CD;;;;;;;;;;;;;;;;;GAiBG;AACH,wBAAgB,cAAc,CAC5B,IAAI,EAAE,MAAM,EACZ,EAAE,EAAE,MAAM,EACV,aAAa,cAA6B,EAC1C,kBAAkB,UAAQ,EAC1B,QAAQ,UAAQ,EAChB,eAAe,UAAQ,EACvB,eAAe,CAAC,EAAE,eAAe,EACjC,cAAc,SAA0B,EACxC,WAAW,CAAC,EAAE,WAAW,GACxB,oBAAoB,GAAG,IAAI,CAW7B"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/plugin/index.ts"],"names":[],"mappings":"AA0BA,OAAO,WAAW,MAAM,cAAc,CAAA;AActC,OAAO,EAAsC,KAAK,OAAO,EAAE,MAAM,uBAAuB,CAAA;AA6BxF;;;;;;;;;;;;;;;GAeG;AACH,MAAM,MAAM,kBAAkB,GAAG,OAAO,GAAG;IAAE,IAAI,EAAE,MAAM,CAAC;IAAC,IAAI,EAAE,MAAM,CAAA;CAAE,CAAA;AACzE;;;;;GAKG;AACH,MAAM,MAAM,eAAe,GAAG,OAAO,GAAG;IAAE,IAAI,EAAE,MAAM,CAAC;IAAC,IAAI,EAAE,MAAM,CAAC;IAAC,QAAQ,CAAC,EAAE,SAAS,kBAAkB,EAAE,CAAA;CAAE,CAAA;AAChH,kDAAkD;AAClD,MAAM,MAAM,WAAW,GAAG,GAAG,CAAC,MAAM,EAAE,eAAe,EAAE,CAAC,CAAA;AACxD,eAAO,MAAM,sBAAsB,mBAAmB,CAAA;AAQtD;;;;GAIG;AACH,wBAAgB,cAAc,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,CAGnD;AA+BD,MAAM,MAAM,uBAAuB,GAAG;IACpC,8DAA8D;IAC9D,aAAa,CAAC,EAAE,MAAM,EAAE,CAAA;IACxB;;;;;;OAMG;IACH,kBAAkB,CAAC,EAAE,OAAO,CAAA;IAC5B;;;;OAIG;IACH,QAAQ,CAAC,EAAE,OAAO,CAAA;IAClB;8CAC0C;IAC1C,eAAe,CAAC,EAAE,OAAO,CAAA;IACzB;;;;;;;;OAQG;IACH,eAAe,CAAC,EAAE,eAAe,CAAA;IACjC;;;;;;;;OAQG;IACH,cAAc,CAAC,EAAE,MAAM,CAAA;CACxB,CAAA;AAED,wFAAwF;AACxF,MAAM,MAAM,eAAe,GAAG;IAC5B;;;gEAG4D;IAC5D,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAA;IACtB;;;4BAGwB;IACxB,QAAQ,CAAC,KAAK,EAAE,SAAS,MAAM,EAAE,CAAA;IACjC;;;;;;;;;;;OAWG;IACH,QAAQ,CAAC,KAAK,CAAC,EAAE,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC,CAAA;CACnD,CAAA;;;AA4lBD,MAAM,MAAM,oBAAoB,GAAG;IACjC,IAAI,EAAE,MAAM,CAAA;IACZ,GAAG,EAAE,UAAU,CAAC,WAAW,CAAC,aAAa,CAAC,CAAC,CAAA;IAC3C,kFAAkF;IAClF,QAAQ,EAAE,MAAM,EAAE,CAAA;IAClB;qFACiF;IACjF,eAAe,CAAC,EAAE,KAAK,GAAG,UAAU,CAAA;IACpC,wFAAwF;IACxF,aAAa,EAAE,MAAM,EAAE,CAAA;CACxB,CAAA;AA0CD;;;;;;;;;;;;;;;;;GAiBG;AACH,wBAAgB,cAAc,CAC5B,IAAI,EAAE,MAAM,EACZ,EAAE,EAAE,MAAM,EACV,aAAa,cAA6B,EAC1C,kBAAkB,UAAQ,EAC1B,QAAQ,UAAQ,EAChB,eAAe,UAAQ,EACvB,eAAe,CAAC,EAAE,eAAe,EACjC,cAAc,SAA0B,EACxC,WAAW,CAAC,EAAE,WAAW,GACxB,oBAAoB,GAAG,IAAI,CAW7B"}

package/dist/plugin/index.js

@@ -2,7 +2,7 @@
 import * as fs2 from "node:fs";
 import * as path2 from "node:path";
 import { createUnplugin } from "unplugin";
-import { parseSync as parseSync5 } from "oxc-parser";
+import { parseSync as parseSync6 } from "oxc-parser";
 import { ResolverFactory } from "oxc-resolver";
 import MagicString from "magic-string";
 
@@ -2081,6 +2081,9 @@ function linkRules(recipes, link) {
   return cache;
 }
 
+// src/plugin/evaluator.ts
+import { parseSync as parseSync2 } from "oxc-parser";
+
 // src/combinators/probe.ts
 function failAt(ctx, expected, pos) {
   const r = { ok: false, expected, span: { start: pos, end: pos } };
@@ -5619,7 +5622,7 @@ function sourceLeaf(root, fn) {
 }
 
 // src/version.ts
-var PARSEMAN_VERSION = "0.61.2";
+var PARSEMAN_VERSION = "0.61.4";
 
 // src/table/lex-body.ts
 function buildLexBodyRecognizer(spec, constants) {
@@ -19148,13 +19151,21 @@ function selectHotSites(code, entries, siteBytes, budget, profile) {
   let spent = 0;
   for (const ip of ranked) {
     if (w(ip) === 0) break;
-    const bytes = siteBytes.get(ip);
-    if (spent + bytes > budget) continue;
-    spent += bytes;
+    spent += siteBytes.get(ip);
+    if (spent > budget) break;
     selected.add(ip);
   }
   return selected;
 }
+function fitHotSites(code, entries, siteBytes, fixed, ceiling, sourceBytes, profile) {
+  const ranked = [...selectHotSites(code, entries, siteBytes, ceiling - fixed, profile)];
+  for (; ranked.length > 0; ranked.pop()) {
+    const sites = new Set(ranked);
+    const bytes = sourceBytes(sites);
+    if (bytes <= ceiling) return { sites, bytes };
+  }
+  return void 0;
+}
 function staticWeights(code, entries) {
   let weight = /* @__PURE__ */ new Map();
   const kids = [];
@@ -19294,19 +19305,20 @@ function compileRuleMap(ruleMap, opts = {}) {
     }
     const ceiling = budget / SUPERCOMPILE_GROWTH;
     if (ceiling <= fixed) return none;
-    let target = ceiling;
-    for (; ; ) {
-      const sites = selectHotSites(artifact.code, Object.values(artifact.rules), siteBytes, target - fixed, profile);
-      if (sites.size === 0) {
-        return {
-          ...none,
-          refusal: `a site within its ${Math.floor(ceiling)} B selection ceiling (the prelude alone is ${fixed} B)`
-        };
-      }
-      const bytes = emitAssemblySource(table, artifact, cfg, roots, true, sites, true).source.length;
-      if (bytes <= ceiling) return { sites, bytes: Math.ceil(bytes * SUPERCOMPILE_GROWTH) };
-      target *= Math.min(ceiling / bytes, 0.99);
-    }
+    const fit = fitHotSites(
+      artifact.code,
+      Object.values(artifact.rules),
+      siteBytes,
+      fixed,
+      ceiling,
+      (sites) => emitAssemblySource(table, artifact, cfg, roots, true, sites, true).source.length,
+      profile
+    );
+    if (fit !== void 0) return { sites: fit.sites, bytes: Math.ceil(fit.bytes * SUPERCOMPILE_GROWTH) };
+    return {
+      ...none,
+      refusal: `a site within its ${Math.floor(ceiling)} B selection ceiling (the prelude alone is ${fixed} B)`
+    };
   };
   return {
     keys: ruleMap.map(([key]) => key),
@@ -20719,7 +20731,7 @@ function stripTsFromSource(node2, code) {
   walk(node2);
   const start = node2.start;
   const end = node2.end;
-  if (cuts.length === 0) return code.slice(start, end);
+  if (cuts.length === 0) return stripComments(code.slice(start, end));
   cuts.sort((a, b) => a[0] - b[0]);
   let out = "";
   let cur = start;
@@ -20728,7 +20740,36 @@ function stripTsFromSource(node2, code) {
     out += code.slice(cur, s);
     cur = e;
   }
-  return out + code.slice(cur, end);
+  return stripComments(out + code.slice(cur, end));
+}
+var LINE_TERMINATOR = /[\n\r\u2028\u2029]/;
+function stripComments(text) {
+  if (!text.includes("/*") && !text.includes("//")) return text;
+  const wrapped = `(${text})`;
+  let out = "";
+  let cur = 0;
+  let lineEnd = false;
+  const comments = parseSync2("reducer.ts", wrapped).comments;
+  comments.forEach((c, i) => {
+    const before = text.slice(cur, c.start - 1);
+    const kept = before.trimEnd();
+    out += kept;
+    lineEnd ||= LINE_TERMINATOR.test(before.slice(kept.length)) || LINE_TERMINATOR.test(c.value);
+    cur = c.end - 1;
+    const after = /^\s*/.exec(text.slice(cur))[0];
+    const endsLine = LINE_TERMINATOR.test(after);
+    if (comments[i + 1]?.start === c.end + after.length) {
+      lineEnd ||= endsLine;
+      cur += after.length;
+      return;
+    }
+    if (out !== "" && cur + after.length < text.length && !endsLine) {
+      if (lineEnd) out += "\n";
+      else if (after === "") out += " ";
+    }
+    lineEnd = false;
+  });
+  return out + text.slice(cur);
 }
 var UnevaluatedExtra = class {
 };
@@ -21754,7 +21795,7 @@ function referencesAny(node2, names, scope2) {
 import * as fs from "node:fs";
 import * as path from "node:path";
 import { createRequire } from "node:module";
-import { parseSync as parseSync2 } from "oxc-parser";
+import { parseSync as parseSync3 } from "oxc-parser";
 var FUNCTION_TYPES = /* @__PURE__ */ new Set(["FunctionDeclaration", "FunctionExpression", "ArrowFunctionExpression"]);
 var SCOPE_TYPES = /* @__PURE__ */ new Set([
   ...FUNCTION_TYPES,
@@ -21960,7 +22001,7 @@ function analyseModuleFile(file) {
   let mod = null;
   try {
     const src = fs.readFileSync(file, "utf8");
-    const r = parseSync2(file, src);
+    const r = parseSync3(file, src);
     if (r.errors.length === 0) {
       const body = r.program.body;
       const scopes = buildScopeTree(body, src.length);
@@ -22138,7 +22179,7 @@ function createReducerResolver(entryFile, body, src) {
 }
 
 // src/plugin/free-identifiers.ts
-import { parseSync as parseSync3 } from "oxc-parser";
+import { parseSync as parseSync4 } from "oxc-parser";
 var isNode = (v) => typeof v === "object" && v !== null && typeof v.type === "string";
 var TYPE_KEYS = /* @__PURE__ */ new Set([
   "typeAnnotation",
@@ -22286,7 +22327,7 @@ function describeTopLevel(stmt) {
 function findFreeIdentifiers(code, filename) {
   let parsed;
   try {
-    parsed = parseSync3(filename, code);
+    parsed = parseSync4(filename, code);
   } catch {
     return [];
   }
@@ -22363,7 +22404,7 @@ function findFreeIdentifiers(code, filename) {
 }
 
 // src/plugin/entry-supercompiler.ts
-import { parseSync as parseSync4 } from "oxc-parser";
+import { parseSync as parseSync5 } from "oxc-parser";
 var PIECE = /^_pf(\d+)$/;
 var WRAP = "function __parseman_supercompile__(){\n";
 var SUFFIX = "\n}";
@@ -22512,7 +22553,7 @@ function supercompileRuleMapReplacement(prog, replacement, select) {
   }
   if (!candidate.supercompile.activated) return replacement;
   const prefix = "const __parseman_macro_replacement__=";
-  const parsed = parseSync4("parseman-entry-supercompile-replacement.js", prefix + replacement);
+  const parsed = parseSync5("parseman-entry-supercompile-replacement.js", prefix + replacement);
   if (parsed.errors.length > 0) return replacement;
   const program = parsed.program;
   const declaration = nodes(program.body)[0];
@@ -22533,12 +22574,12 @@ function supercompileRuleMapReplacement(prog, replacement, select) {
   const end = body.end - prefix.length - 1;
   if (replacement.slice(start, end) !== FACTORY_ARITY_GUARD + canonical2.source + "\n") return replacement;
   const transformed = replacement.slice(0, start) + FACTORY_ARITY_GUARD + candidate.source + "\n" + replacement.slice(end);
-  const checked = parseSync4("parseman-entry-supercompile-replacement-result.js", prefix + transformed);
+  const checked = parseSync5("parseman-entry-supercompile-replacement-result.js", prefix + transformed);
   return checked.errors.length === 0 ? transformed : replacement;
 }
 function supercompileEmittedAssembly(prog, _cfg, extraIps, emitted) {
   const source = emitted.source;
-  const parsed = parseSync4("parseman-entry-supercompile.js", WRAP + source + SUFFIX);
+  const parsed = parseSync5("parseman-entry-supercompile.js", WRAP + source + SUFFIX);
   if (parsed.errors.length > 0) {
     const zero = { functionsBefore: 0, pieceCallsBefore: 0, sourceBefore: source.length, barriers: {} };
     return fallback(emitted, "canonical emitted source did not parse", zero);
@@ -22764,7 +22805,7 @@ ${nested}
   }
   const functionsAfter = roots.length;
   const removed = fns.size - functionsAfter;
-  const checked = parseSync4("parseman-entry-supercompile-result.js", WRAP + candidate + SUFFIX);
+  const checked = parseSync5("parseman-entry-supercompile-result.js", WRAP + candidate + SUFFIX);
   if (checked.errors.length > 0) return fallback(emitted, "structured candidate did not parse", before);
   const declared = /* @__PURE__ */ new Set();
   const referenced = /* @__PURE__ */ new Set();
@@ -23039,7 +23080,17 @@ function corpusTexts(profile) {
   });
 }
 var PARSEMAN_MODULE = "parseman";
-var DEFAULT_ASSEMBLY_BUDGET = 0.25;
+var DEFAULT_ASSEMBLY_BUDGET = 0.5;
+function codeBytes(code, comments, end = code.length) {
+  let bytes = 0;
+  let at = 0;
+  for (const c of comments) {
+    if (c.start >= end) break;
+    bytes += code.slice(at, c.start).replace(/\s+/g, "").length;
+    at = c.end;
+  }
+  return bytes + code.slice(at, end).replace(/\s+/g, "").length;
+}
 var LinkRefusal = class extends Error {
 };
 function reasonSuffix(runtimeOnly) {
@@ -23140,7 +23191,7 @@ function parseModuleCached(filePath) {
   let parsed = null;
   try {
     const src = fs2.readFileSync(filePath, "utf8");
-    const r = parseSync5(filePath, src);
+    const r = parseSync6(filePath, src);
     if (r.errors.length === 0) parsed = { body: r.program.body, src };
   } catch {
   }
@@ -23181,7 +23232,7 @@ async function followCarried(sinks, moduleId, name, depth = 0) {
   if (own !== void 0) return { items: own, recorder: moduleId };
   const code = this.getModuleInfo(moduleId)?.code;
   if (!code) return void 0;
-  const parsed = parseSync5(moduleId, code);
+  const parsed = parseSync6(moduleId, code);
   if (parsed.errors.length > 0) return void 0;
   const origin = exportOrigin(parsed.program.body, name);
   if (origin === "local") return null;
@@ -23242,6 +23293,7 @@ async function emitCarriedSidecars(sinks, bundle) {
 var SIDECAR_FRAMEWORKS = /* @__PURE__ */ new Set(["rollup", "rolldown", "vite"]);
 var plugin_default = createUnplugin((opts = {}, meta) => {
   const sinks = SIDECAR_FRAMEWORKS.has(meta.framework) ? /* @__PURE__ */ new Map() : void 0;
+  const profiled = /* @__PURE__ */ new Map();
   const generateBundle = sinks === void 0 ? void 0 : {
     generateBundle: {
       order: "post",
@@ -23260,8 +23312,15 @@ var plugin_default = createUnplugin((opts = {}, meta) => {
     transformInclude(id) {
       return /\.[jt]sx?$/.test(id) && !id.includes("node_modules");
     },
+    buildEnd(error) {
+      if (error) return;
+      const ids = [...this.getModuleIds?.() ?? profiled.keys()].filter((id) => profiled.has(id));
+      if (ids.length === 0 || ids.some((id) => profiled.get(id) === "ran")) return;
+      throw new Error(`assemblyProfile: no grammar has rule "${opts.assemblyProfile?.entry}", so the corpus never ran (${ids.join(", ")})`);
+    },
     transform(code, id) {
       sinks?.delete(id);
+      profiled.delete(id);
       if (!code.includes("parseman")) return null;
       if (!code.includes("macro")) return null;
       for (const file of opts.assemblyProfile?.files ?? []) this?.addWatchFile?.(file);
@@ -23269,6 +23328,7 @@ var plugin_default = createUnplugin((opts = {}, meta) => {
       const sink = sinks && /* @__PURE__ */ new Map();
       const result = transformMacro(code, id, moduleAliases, opts.warnUnloweredRegex === true, opts.recovery === true, opts.grammarCoverage === true, opts.assemblyProfile, opts.assemblyBudget, sink);
       if (sinks && sink && sink.size > 0) sinks.set(id, sink);
+      if (result?.assemblyProfile !== void 0) profiled.set(id, result.assemblyProfile);
       if (result?.warnings.length) {
         for (const w of result.warnings) {
           if (typeof this?.warn === "function") this.warn(`[parseman] ${w}`);
@@ -23415,7 +23475,7 @@ function lowerPrivateSourceModule(file, moduleAliases, warnUnloweredRegex, recov
     const source = fs2.readFileSync(file, "utf8");
     const transformed = transformMacro(source, file, moduleAliases, warnUnloweredRegex, recovery);
     if (!transformed || transformed.warnings.length > 0) return null;
-    const parsed = parseSync5(file, transformed.code);
+    const parsed = parseSync6(file, transformed.code);
     parsedModule = parsed.errors.length === 0 ? { body: parsed.program.body, src: transformed.code } : null;
     return parsedModule;
   } catch {
@@ -23438,7 +23498,7 @@ function transformMacro(code, id, moduleAliases = /* @__PURE__ */ new Set([PARSE
 function transformMacroImpl(code, id, moduleAliases, warnUnloweredRegex, recovery, grammarCoverage, assemblyProfile, assemblyBudgetShare, carriedSink) {
   let result;
   try {
-    result = parseSync5(id, code);
+    result = parseSync6(id, code);
   } catch {
     return null;
   }
@@ -23997,6 +24057,7 @@ ${names.map((n) => `  - ${n}`).join("\n")}` : " (it is not a static combinator/v
   const localRuleMaps = /* @__PURE__ */ new Map();
   const localGrammarTrivia = /* @__PURE__ */ new Map();
   const localGrammarScanSkip = /* @__PURE__ */ new Map();
+  const callLabel = (fn, start) => `${fn}${codeBytes(code, result.comments, start)}`;
   const nsFor = (label2) => `_${createHash("sha1").update(`${id}#${label2}`).digest("hex").slice(0, 8)}_`;
   const isSpread = (it) => "__spreadLocal" in it;
   const isIR = (it) => "ir" in it;
@@ -24252,7 +24313,7 @@ ${names.map((n) => `  - ${n}`).join("\n")}` : " (it is not a static combinator/v
     const carried = [];
     const importedFactories = [];
     for (let i = 0; i < elements.length; i++) {
-      const r = argPieces(elements[i], `compose${init.start}_${i}`, composing);
+      const r = argPieces(elements[i], `${callLabel("compose", init.start)}_${i}`, composing);
       if (!r) {
         const el = elements[i];
         const name = el.type === "Identifier" ? el.name : void 0;
@@ -24315,7 +24376,8 @@ ${names.map((n) => `  - ${n}`).join("\n")}` : " (it is not a static combinator/v
     warn(init.start, "compose(): a carried piece has no re-lowerable IR; leaving the runtime compose() in place");
     return null;
   };
-  let assemblyBudget = Math.floor(code.length * assemblyBudgetShare);
+  let assemblyBudget = Math.floor(codeBytes(code, result.comments) * assemblyBudgetShare);
+  const assemblySites = [];
   let leafDeclared;
   const declaresLeaf = () => leafDeclared ??= body.some((stmt) => {
     const vd = unwrapVd(stmt);
@@ -24328,10 +24390,17 @@ ${names.map((n) => `  - ${n}`).join("\n")}` : " (it is not a static combinator/v
       warnings.push(`${id}:${lineOf(pos)} \u2014 ${label2}: its precompiled assembly cannot emit ${refusal}; the artifact runs on the closure engine`);
     }
     assemblyBudget -= bytes;
+    assemblySites.push(...sites);
     return sites;
   };
+  let profileOutcome;
   const profileOf = (compiled) => {
-    if (assemblyProfile === void 0 || compiled.hostMode !== "ast" || compiled.prog.lines === 1 || !(assemblyProfile.entry in compiled.prog.rules)) return void 0;
+    if (assemblyProfile === void 0 || compiled.hostMode !== "ast" || compiled.prog.lines === 1) return void 0;
+    if (!(assemblyProfile.entry in compiled.prog.rules)) {
+      profileOutcome ??= "no-entry";
+      return void 0;
+    }
+    profileOutcome = "ran";
     const refuse = (why) => {
       throw new Error(`${id} \u2014 assemblyProfile: ${why}`);
     };
@@ -24351,26 +24420,36 @@ ${names.map((n) => `  - ${n}`).join("\n")}` : " (it is not a static combinator/v
         }
       });
     });
-    return countSiteVisits(compiled.prog, (rules3) => {
-      const entry = rules3[assemblyProfile.entry];
-      corpusTexts(assemblyProfile).forEach((text, i) => {
-        const file = assemblyProfile.files[i];
-        if (text.trim() === "") return;
-        let result2;
-        try {
-          result2 = run(entry, text);
-        } catch (e) {
-          const source = String(thrower).replace(/\s+/g, " ").slice(0, 200);
-          throw new Error(`${id} \u2014 assemblyProfile: ${thrower === void 0 ? "the parse" : `gate or reducer \`${source}\``} threw on ${file}: ${String(e)}`, { cause: e });
-        }
-        if (!result2.ok || result2.unconsumedFrom !== null) {
-          refuse(`${file} does not parse from rule "${assemblyProfile.entry}": it stops at offset ${result2.ok ? result2.unconsumedFrom : result2.span.end}`);
-        }
-        if (result2.errors.length > 0) {
-          refuse(`${file} parses only by recovering from ${result2.errors.length} error(s), first at offset ${result2.errors[0].span.start}`);
-        }
-      });
-    }, fns);
+    const scope3 = assemblyProfile.scope ?? {};
+    const names = Object.keys(scope3);
+    for (const name of names) {
+      if (name in globalThis) refuse(`\`scope\` name "${name}" is already a global; a callback couldn't tell which one it reads`);
+    }
+    try {
+      for (const name of names) Object.defineProperty(globalThis, name, { value: scope3[name], configurable: true });
+      return countSiteVisits(compiled.prog, (rules3) => {
+        const entry = rules3[assemblyProfile.entry];
+        corpusTexts(assemblyProfile).forEach((text, i) => {
+          const file = assemblyProfile.files[i];
+          if (text.trim() === "") return;
+          let result2;
+          try {
+            result2 = run(entry, text);
+          } catch (e) {
+            const source = String(thrower).replace(/\s+/g, " ").slice(0, 200);
+            throw new Error(`${id} \u2014 assemblyProfile: ${thrower === void 0 ? "the parse" : `gate or reducer \`${source}\``} threw on ${file}: ${String(e)}`, { cause: e });
+          }
+          if (!result2.ok || result2.unconsumedFrom !== null) {
+            refuse(`${file} does not parse from rule "${assemblyProfile.entry}": it stops at offset ${result2.ok ? result2.unconsumedFrom : result2.span.end}`);
+          }
+          if (result2.errors.length > 0) {
+            refuse(`${file} parses only by recovering from ${result2.errors.length} error(s), first at offset ${result2.errors[0].span.start}`);
+          }
+        });
+      }, fns);
+    } finally {
+      for (const name of names) Reflect.deleteProperty(globalThis, name);
+    }
   };
   const assembledReplacement = (compiled, metadata, select) => select.size === 0 ? compiled.replacementWithMetadata(metadata) : supercompileRuleMapReplacement(compiled.prog, compiled.replacementWithMetadata(metadata, { select }), select);
   const compileComposeLeafCall = (init) => {
@@ -24389,7 +24468,7 @@ ${names.map((n) => `  - ${n}`).join("\n")}` : " (it is not a static combinator/v
     let localRules = null;
     const importedFactories = [];
     if (isRulesCall(localArg)) {
-      const evaluated = evaluateRulesFactory(localArg, `composeLeaf${init.start}`);
+      const evaluated = evaluateRulesFactory(localArg, callLabel("composeLeaf", init.start));
       localRules = evaluated?.ruleMap ?? null;
       if (evaluated?.importedFactory) importedFactories.push(evaluated.importedFactory);
     } else if (localArg.type === "Identifier") {
@@ -24404,7 +24483,7 @@ ${names.map((n) => `  - ${n}`).join("\n")}` : " (it is not a static combinator/v
     const composing = composingTrivia(elements);
     const carried = [];
     for (let i = 0; i < elements.length - 1; i++) {
-      const r = argPieces(elements[i], `composeLeaf${init.start}_${i}`, composing);
+      const r = argPieces(elements[i], `${callLabel("composeLeaf", init.start)}_${i}`, composing);
       if (!r) {
         warn(init.start, `composeLeaf(): argument ${i} isn't a build-resolvable recognition grammar`);
         return null;
@@ -24880,9 +24959,11 @@ ${lines2.join("\n")}`);
     for (const l of lines2) warnings.push(`${id}: ${l}`);
   }
   return {
+    assemblySites: applied.length > 0 ? assemblySites : [],
     code: ms.toString(),
     map: ms.generateMap({ hires: true }),
-    warnings
+    warnings,
+    ...profileOutcome === void 0 ? {} : { assemblyProfile: profileOutcome }
   };
 }
 export {