waygraph 0.16.0 → 0.16.1

package/dist/engine/flow/map-branch.js

@@ -0,0 +1,57 @@
+import { MSG_MAP_BRANCH_SHARED_SESSION_UNSUPPORTED, WaygraphError } from "../errors.js";
+import { MemPage } from "../mem/mem.js";
+/**
+ * Builds the `Flow` object `MapBuilder.branch()` returns: run `before`, then dispatch on the
+ * resolved tag into whichever `routes` entry matches (same page/context/mem), or return that
+ * Checkpoint as-is when its route is `null`. Factored out so `withBlockVerify`/`modBlockVerify`
+ * can patch `before` and rebuild the same branched shape, exactly like a plain Flow's own.
+ */
+export function buildBranchedFlow(before, routes) {
+    const run = (async (contextOrMem, memOrConfig, options) => {
+        if (contextOrMem instanceof MemPage) {
+            throw new WaygraphError("WG_MAP_BRANCH_SHARED_SESSION_UNSUPPORTED", MSG_MAP_BRANCH_SHARED_SESSION_UNSUPPORTED);
+        }
+        const context = contextOrMem;
+        const mem = memOrConfig;
+        const gotOwnPage = options?.page === undefined;
+        const page = options?.page ?? (await context.newPage());
+        const closeOnFinish = options?.closeOnFinish ?? gotOwnPage;
+        const first = (await before.run(context, mem, { ...options, page, closeOnFinish: false }));
+        const branchFlow = routes[first.result.__state];
+        if (!branchFlow) {
+            if (options?.closeOnFinish === false)
+                return { result: first.result, page: first.page };
+            if (closeOnFinish)
+                await first.page.close();
+            return first.result;
+        }
+        return branchFlow.run(context, mem, { ...options, page: first.page, closeOnFinish });
+    });
+    return {
+        resetSession: before.resetSession,
+        config: before.config,
+        ...(before.expectedFailureReason !== undefined ? { expectedFailureReason: before.expectedFailureReason } : {}),
+        ...(before.demoPace !== undefined ? { demoPace: before.demoPace } : {}),
+        ...(before.highlightStyle !== undefined ? { highlightStyle: before.highlightStyle } : {}),
+        ...(before.memStub !== undefined ? { memStub: before.memStub } : {}),
+        // Read by branchRoutes()/branchInfo() (branch-regression.ts) - real, ORDINARY (enumerable)
+        // properties, not hidden ones, specifically so a `{ ...flow, ... }` spread (withSettings) carries them
+        // through instead of silently dropping them -
+        // the same class of bug branch()'s missing copyWaygraphRuntime call already was.
+        __wgBranch: { before, routes },
+        // Static introspection (`waygraph graph`/list): the fixed prefix, plus every branch's own
+        // Blocks prefixed by the tag that leads to them - can't know at analysis time which one a real
+        // run takes, so this shows all of them rather than none.
+        blocks: () => [
+            ...before.blocks(),
+            ...Object.entries(routes).flatMap(([tag, f]) => f ? f.blocks().map((b) => ({ ...b, name: `${tag} -> ${b.name}` })) : []),
+        ],
+        run,
+        withBlockVerify(block, verify) {
+            return buildBranchedFlow(before.withBlockVerify(block, verify), routes);
+        },
+        modBlockVerify(block, nameOrIndex, newCheck) {
+            return buildBranchedFlow(before.modBlockVerify(block, nameOrIndex, newCheck), routes);
+        },
+    };
+}

package/dist/engine/flow/map-builder.d.ts

@@ -1,34 +1,19 @@
+import type { SomeBlock } from "../block/block.js";
+import type { EffectBlock } from "../block/kinds/effect.js";
+import type { AssertBlock, MethodBlock } from "../block/kinds/method.js";
+import type { NavBlock } from "../block/kinds/nav.js";
+import type { PageBlock } from "../block/kinds/page.js";
 import type { Checkpoint } from "../checkpoint/checkpoint.js";
-import type { Flow, FlowSettings } from "./flow.js";
 import type { DemoPace } from "../stub/pace.js";
 import type { HighlightStyleDefaults } from "../stub/ring.js";
-import type { NavBlock } from "../block/kinds/nav.js";
-import type { PageBlock } from "../block/kinds/page.js";
-import type { AssertBlock, MethodBlock } from "../block/kinds/method.js";
-import type { EffectBlock } from "../block/kinds/effect.js";
-import type { SomeBlock } from "../block/block.js";
+import type { Flow, FlowSettings } from "./flow.js";
+import { MapStepOpts } from "./map-steps.js";
 type S = Checkpoint<"__start__">;
 /**
  * The one capability MapBuilder needs from Engine: turn the finished steps into a Flow with the engine's config. A
  * function, not the Engine class, so engine.ts and map-builder.ts don't import each other.
  */
 export type BuildFlowFn = (steps: readonly SomeBlock[], settings: FlowSettings) => Flow<Checkpoint<string>>;
-/** Per-step options for the map builder: `ff` fast-forwards the step, `pace` sets its demo pace. */
-export interface MapStepOpts {
-    /**
-     * Fast-forward just this step, inline - no `.ffStart()/.ffEnd()` bracket needed. Consecutive
-     * `{ ff: true }` steps merge into ONE fast-forward block, same result as the explicit bracket
-     * form; a step without the flag closes an auto-opened window first.
-     * @example map().gotoPage(NavLoginBlock, { ff: true }).method(FillUsernameBlock, { ff: true })
-     */
-    ff?: boolean;
-    /**
-     * Demo pace for just this step (`"blitz"` skips the typing animation and the pause after the action; `"fast"`, `"slow"`,
-     * or a number scale the narration gates).
-     * @example map().method(SetBearerTokenBlock, { pace: "blitz" })
-     */
-    pace?: DemoPace;
-}
 /** Flow-level settings for `engine.map({ … })`: `memStub`, `sessionReset`, `expectedFailure`, `demoPace`, `highlightStyle`, `homeOrigin`. */
 export interface MapBuilderOptions {
     /**

package/dist/engine/flow/map-builder.js

@@ -1,148 +1,7 @@
-import { WaygraphError, MSG_MAP_WRONG_KIND, MSG_MAP_WRONG_SALT, MSG_MAP_WRONG_ORIGIN_INTERNAL, MSG_MAP_WRONG_ORIGIN_EXTERNAL, MSG_MAP_BRANCH_SHARED_SESSION_UNSUPPORTED, MSG_MAP_FF_ALREADY_OPEN, MSG_MAP_FF_NOT_OPEN, MSG_MAP_FF_EMPTY, MSG_MAP_METHOD_GOT_ASSERT, MSG_MAP_BRANCH_NO_PRIOR_STEP, MSG_MAP_FF_NOT_CLOSED, MSG_MAP_EMPTY, } from "../errors.js";
-import { MemPage } from "../mem/mem.js";
 import { fastForwardComposeBlock } from "../block/compose.js";
-import { clearSessionState } from "./flow.js";
-import { copyWaygraphRuntime } from "../block/block.js";
-/** Per-step options every `MapBuilder` step method (`.gotoPage()`/`.method()`/`.assert()`) takes. */
-/** The same Block, but it clears cookies and storage before it acts. Keeps the runtime markers. */
-function resetBefore(block) {
-    const act = block.instruction.act.bind(block.instruction);
-    const next = {
-        ...block,
-        instruction: {
-            ...block.instruction,
-            async act(page, input, mem) {
-                await clearSessionState(page.context(), page);
-                return act(page, input, mem);
-            },
-        },
-    };
-    copyWaygraphRuntime(block, next);
-    Object.defineProperty(next, "__waygraphResetBefore", { value: true, enumerable: false, configurable: true });
-    return next;
-}
-/** Applies a step's `pace` option, keeping the Block's runtime markers. */
-function paced(block, opts) {
-    if (opts?.pace === undefined)
-        return block;
-    const next = { ...block, demoPace: opts.pace };
-    copyWaygraphRuntime(block, next);
-    return next;
-}
-function mapKindOf(block) {
-    return block?.__waygraphKind;
-}
-function mapSaltOf(block) {
-    return block?.__waygraphSalt;
-}
-function mapNavUrlOf(block) {
-    const url = block?.__waygraphNavUrl;
-    return typeof url === "string" ? url : undefined;
-}
-const MAP_KIND_FACTORY_HINT = {
-    nav: "defineNavBlock/defineMemNavBlock",
-    page: "definePageBlock",
-    assert: "defineAssertBlock",
-};
-const MAP_SALT_FACTORY_HINT = {
-    method: "defineMethodBlock",
-    effect: "defineEffectBlock",
-    api: "defineApiBlock",
-};
-function assertMapKind(block, allowed, method) {
-    const kind = mapKindOf(block);
-    if (kind !== undefined && allowed.includes(kind))
-        return;
-    const wanted = allowed.map((k) => MAP_KIND_FACTORY_HINT[k] ?? k).join(" or ");
-    const found = kind ? `a Block of kind "${kind}"` : "an object with no waygraph kind marker at all";
-    throw new WaygraphError("WG_MAP_WRONG_KIND", MSG_MAP_WRONG_KIND(method, block?.name ?? "?", wanted, found));
-}
-function assertMapSalt(block, allowed, method) {
-    const salt = mapSaltOf(block);
-    if (salt !== undefined && allowed.includes(salt))
-        return;
-    const wanted = allowed.map((s) => MAP_SALT_FACTORY_HINT[s] ?? s).join(" or ");
-    const found = salt ? `a Block salted "${salt}"` : "an object with no waygraph salt marker at all";
-    throw new WaygraphError("WG_MAP_WRONG_SALT", MSG_MAP_WRONG_SALT(method, block?.name ?? "?", wanted, found));
-}
-function assertMapOrigin(block, homeOrigin, expect, method) {
-    if (!homeOrigin)
-        return; // not configured - can't validate, honest no-op
-    const navUrl = mapNavUrlOf(block);
-    if (navUrl === undefined)
-        return; // click-based/dynamic nav - not statically checkable
-    let targetOrigin;
-    let wantOrigin;
-    try {
-        targetOrigin = new URL(navUrl, homeOrigin).origin;
-        wantOrigin = new URL(homeOrigin).origin;
-    }
-    catch {
-        return; // malformed URL - not this check's job to validate that
-    }
-    const isExternal = targetOrigin !== wantOrigin;
-    if (expect === "internal" && isExternal) {
-        throw new WaygraphError("WG_MAP_WRONG_ORIGIN", MSG_MAP_WRONG_ORIGIN_INTERNAL(block.name, targetOrigin, wantOrigin));
-    }
-    if (expect === "external" && !isExternal) {
-        throw new WaygraphError("WG_MAP_WRONG_ORIGIN", MSG_MAP_WRONG_ORIGIN_EXTERNAL(block.name, targetOrigin, wantOrigin));
-    }
-}
-/**
- * Builds the `Flow` object `MapBuilder.branch()` returns: run `before`, then dispatch on the
- * resolved tag into whichever `routes` entry matches (same page/context/mem), or return that
- * Checkpoint as-is when its route is `null`. Factored out so `withBlockVerify`/`modBlockVerify`
- * can patch `before` and rebuild the same branched shape, exactly like a plain Flow's own.
- */
-function buildBranchedFlow(before, routes) {
-    const run = (async (contextOrMem, memOrConfig, options) => {
-        if (contextOrMem instanceof MemPage) {
-            throw new WaygraphError("WG_MAP_BRANCH_SHARED_SESSION_UNSUPPORTED", MSG_MAP_BRANCH_SHARED_SESSION_UNSUPPORTED);
-        }
-        const context = contextOrMem;
-        const mem = memOrConfig;
-        const gotOwnPage = options?.page === undefined;
-        const page = options?.page ?? (await context.newPage());
-        const closeOnFinish = options?.closeOnFinish ?? gotOwnPage;
-        const first = (await before.run(context, mem, { ...options, page, closeOnFinish: false }));
-        const branchFlow = routes[first.result.__state];
-        if (!branchFlow) {
-            if (options?.closeOnFinish === false)
-                return { result: first.result, page: first.page };
-            if (closeOnFinish)
-                await first.page.close();
-            return first.result;
-        }
-        return branchFlow.run(context, mem, { ...options, page: first.page, closeOnFinish });
-    });
-    return {
-        resetSession: before.resetSession,
-        config: before.config,
-        ...(before.expectedFailureReason !== undefined ? { expectedFailureReason: before.expectedFailureReason } : {}),
-        ...(before.demoPace !== undefined ? { demoPace: before.demoPace } : {}),
-        ...(before.highlightStyle !== undefined ? { highlightStyle: before.highlightStyle } : {}),
-        ...(before.memStub !== undefined ? { memStub: before.memStub } : {}),
-        // Read by branchRoutes()/branchInfo() (branch-regression.ts) - real, ORDINARY (enumerable)
-        // properties, not hidden ones, specifically so a `{ ...flow, ... }` spread (withSettings) carries them
-        // through instead of silently dropping them -
-        // the same class of bug branch()'s missing copyWaygraphRuntime call already was.
-        __wgBranch: { before, routes },
-        // Static introspection (`waygraph graph`/list): the fixed prefix, plus every branch's own
-        // Blocks prefixed by the tag that leads to them - can't know at analysis time which one a real
-        // run takes, so this shows all of them rather than none.
-        blocks: () => [
-            ...before.blocks(),
-            ...Object.entries(routes).flatMap(([tag, f]) => f ? f.blocks().map((b) => ({ ...b, name: `${tag} -> ${b.name}` })) : []),
-        ],
-        run,
-        withBlockVerify(block, verify) {
-            return buildBranchedFlow(before.withBlockVerify(block, verify), routes);
-        },
-        modBlockVerify(block, nameOrIndex, newCheck) {
-            return buildBranchedFlow(before.modBlockVerify(block, nameOrIndex, newCheck), routes);
-        },
-    };
-}
+import { MSG_MAP_BRANCH_NO_PRIOR_STEP, MSG_MAP_EMPTY, MSG_MAP_FF_ALREADY_OPEN, MSG_MAP_FF_EMPTY, MSG_MAP_FF_NOT_CLOSED, MSG_MAP_FF_NOT_OPEN, MSG_MAP_METHOD_GOT_ASSERT, WaygraphError, } from "../errors.js";
+import { buildBranchedFlow } from "./map-branch.js";
+import { assertMapKind, assertMapOrigin, assertMapSalt, mapKindOf, paced, resetBefore } from "./map-steps.js";
 /**
  * The flow builder behind `engine.map()` - see `map()`'s own doc
  * comment for why this exists. Each step method is scoped to exactly the
@@ -220,7 +79,9 @@ export class MapBuilder {
         if (ff.buffer.length === 0) {
             throw new WaygraphError("WG_MAP_FF_EMPTY", MSG_MAP_FF_EMPTY(ff.name));
         }
-        const composed = fastForwardComposeBlock(ff.name, ff.buffer);
+        const composed = fastForwardComposeBlock(ff.name, 
+        // The window's steps were typechecked as they were added; the one-step overload takes them as one Block.
+        ff.buffer);
         return new MapBuilder(this.build, this.settings, [...this.steps, composed], this.homeOrigin, null);
     }
     /**

package/dist/engine/flow/map-steps.d.ts

@@ -0,0 +1,30 @@
+import { type SomeBlock, type SomeDefinedBlock } from "../block/block.js";
+import type { DemoPace } from "../stub/pace.js";
+/** The same Block, but it clears cookies and storage before it acts. Keeps the runtime markers. */
+export declare function resetBefore(block: SomeBlock): SomeBlock;
+/** Applies a step's `pace` option, keeping the Block's runtime markers. */
+export declare function paced(block: object, opts: MapStepOpts | undefined): SomeDefinedBlock;
+export declare function mapKindOf(block: unknown): string | undefined;
+export declare function mapSaltOf(block: unknown): string | undefined;
+export declare function mapNavUrlOf(block: unknown): string | undefined;
+export declare function assertMapKind(block: SomeBlock, allowed: readonly string[], method: string): void;
+export declare function assertMapSalt(block: SomeBlock, allowed: readonly string[], method: string): void;
+export declare function assertMapOrigin(block: SomeBlock, homeOrigin: string | undefined, expect: "internal" | "external", method: string): void;
+export declare const MAP_KIND_FACTORY_HINT: Record<string, string>;
+export declare const MAP_SALT_FACTORY_HINT: Record<string, string>;
+/** Per-step options for the map builder: `ff` fast-forwards the step, `pace` sets its demo pace. */
+export interface MapStepOpts {
+    /**
+     * Fast-forward just this step, inline - no `.ffStart()/.ffEnd()` bracket needed. Consecutive
+     * `{ ff: true }` steps merge into ONE fast-forward block, same result as the explicit bracket
+     * form; a step without the flag closes an auto-opened window first.
+     * @example map().gotoPage(NavLoginBlock, { ff: true }).method(FillUsernameBlock, { ff: true })
+     */
+    ff?: boolean;
+    /**
+     * Demo pace for just this step (`"blitz"` skips the typing animation and the pause after the action; `"fast"`, `"slow"`,
+     * or a number scale the narration gates).
+     * @example map().method(SetBearerTokenBlock, { pace: "blitz" })
+     */
+    pace?: DemoPace;
+}

package/dist/engine/flow/map-steps.js

@@ -0,0 +1,87 @@
+import { copyWaygraphRuntime } from "../block/block.js";
+import { MSG_MAP_WRONG_KIND, MSG_MAP_WRONG_ORIGIN_EXTERNAL, MSG_MAP_WRONG_ORIGIN_INTERNAL, MSG_MAP_WRONG_SALT, WaygraphError } from "../errors.js";
+import { clearSessionState } from "./flow.js";
+/** The same Block, but it clears cookies and storage before it acts. Keeps the runtime markers. */
+export function resetBefore(block) {
+    const act = block.instruction.act.bind(block.instruction);
+    const next = {
+        ...block,
+        instruction: {
+            ...block.instruction,
+            async act(page, input, mem) {
+                await clearSessionState(page.context(), page);
+                return act(page, input, mem);
+            },
+        },
+    };
+    copyWaygraphRuntime(block, next);
+    Object.defineProperty(next, "__waygraphResetBefore", { value: true, enumerable: false, configurable: true });
+    return next;
+}
+/** Applies a step's `pace` option, keeping the Block's runtime markers. */
+export function paced(block, opts) {
+    if (opts?.pace === undefined)
+        return block;
+    const next = { ...block, demoPace: opts.pace };
+    copyWaygraphRuntime(block, next);
+    return next;
+}
+export function mapKindOf(block) {
+    return block?.__waygraphKind;
+}
+export function mapSaltOf(block) {
+    return block?.__waygraphSalt;
+}
+export function mapNavUrlOf(block) {
+    const url = block?.__waygraphNavUrl;
+    return typeof url === "string" ? url : undefined;
+}
+export function assertMapKind(block, allowed, method) {
+    const kind = mapKindOf(block);
+    if (kind !== undefined && allowed.includes(kind))
+        return;
+    const wanted = allowed.map((k) => MAP_KIND_FACTORY_HINT[k] ?? k).join(" or ");
+    const found = kind ? `a Block of kind "${kind}"` : "an object with no waygraph kind marker at all";
+    throw new WaygraphError("WG_MAP_WRONG_KIND", MSG_MAP_WRONG_KIND(method, block?.name ?? "?", wanted, found));
+}
+export function assertMapSalt(block, allowed, method) {
+    const salt = mapSaltOf(block);
+    if (salt !== undefined && allowed.includes(salt))
+        return;
+    const wanted = allowed.map((s) => MAP_SALT_FACTORY_HINT[s] ?? s).join(" or ");
+    const found = salt ? `a Block salted "${salt}"` : "an object with no waygraph salt marker at all";
+    throw new WaygraphError("WG_MAP_WRONG_SALT", MSG_MAP_WRONG_SALT(method, block?.name ?? "?", wanted, found));
+}
+export function assertMapOrigin(block, homeOrigin, expect, method) {
+    if (!homeOrigin)
+        return; // not configured - can't validate, honest no-op
+    const navUrl = mapNavUrlOf(block);
+    if (navUrl === undefined)
+        return; // click-based/dynamic nav - not statically checkable
+    let targetOrigin;
+    let wantOrigin;
+    try {
+        targetOrigin = new URL(navUrl, homeOrigin).origin;
+        wantOrigin = new URL(homeOrigin).origin;
+    }
+    catch {
+        return; // malformed URL - not this check's job to validate that
+    }
+    const isExternal = targetOrigin !== wantOrigin;
+    if (expect === "internal" && isExternal) {
+        throw new WaygraphError("WG_MAP_WRONG_ORIGIN", MSG_MAP_WRONG_ORIGIN_INTERNAL(block.name, targetOrigin, wantOrigin));
+    }
+    if (expect === "external" && !isExternal) {
+        throw new WaygraphError("WG_MAP_WRONG_ORIGIN", MSG_MAP_WRONG_ORIGIN_EXTERNAL(block.name, targetOrigin, wantOrigin));
+    }
+}
+export const MAP_KIND_FACTORY_HINT = {
+    nav: "defineNavBlock/defineMemNavBlock",
+    page: "definePageBlock",
+    assert: "defineAssertBlock",
+};
+export const MAP_SALT_FACTORY_HINT = {
+    method: "defineMethodBlock",
+    effect: "defineEffectBlock",
+    api: "defineApiBlock",
+};

package/dist/engine/trait/trait.js

@@ -1,5 +1,5 @@
 // URLPattern is only a Node global from v23.8+ (and even then, Node's own, not a browser's) -
-// CI's Node 20/22 matrix has no global at all. Side-effect import only: the polyfill package sets
+// Node 22 (the oldest supported) has no global at all. Side-effect import only: the polyfill package sets
 // globalThis.URLPattern itself, but only when one doesn't already exist - so below Node 23.8 this
 // becomes THE global, and from 23.8 up it's a no-op and the native one stays. Playwright's own
 // waitForURL(pattern) checks `pattern instanceof globalThis.URLPattern` internally, so the instance

package/dist/index.d.ts

@@ -1,7 +1,8 @@
 import "./runtime/full-launch.js";
 import "./runtime/run-log.js";
 export type { Checkpoint, Start } from "./engine/checkpoint/checkpoint.js";
-export type { Instruction, Block, DefinedBlock, SomeBlock, SomeDefinedBlock, WaygraphInstanceOption } from "./engine/block/block.js";
+export type { Instruction, Block, DefinedBlock, SomeBlock, SomeDefinedBlock } from "./engine/block/block.js";
+export type { WaygraphInstanceOption } from "./engine/block/action-page.js";
 export { connect } from "./engine/run/connect.js";
 export { checkpoint } from "./engine/checkpoint/checkpoint.js";
 export { MemKey, MemPage, key, keyGroup } from "./engine/mem/mem.js";
@@ -9,10 +10,12 @@ export { registerMemStub, seedMemStub, getMemStub } from "./engine/mem/mem-stub.
 export { css, byText, byRole } from "./engine/trait/selector.js";
 export { WaygraphError, WAYGRAPH_ERRORS } from "./engine/errors.js";
 export type { WaygraphErrorCode } from "./engine/errors.js";
-export { Trait, urlMatches, textEquals, visible, disabled, enabled, frameVisible, frameTextEquals, frameContainsText, } from "./engine/trait/trait.js";
+export { Trait, urlMatches, textEquals, visible, disabled, enabled, frameVisible, frameTextEquals, frameContainsText } from "./engine/trait/trait.js";
 export { runGraph, spawnTab, narrate, preflight, defineLayout } from "./engine/run/run.js";
 export { Engine, map } from "./engine/engine.js";
-export { branch, withVerify, modVerify, modVerifyAll, defineBlock, withDialog } from "./engine/block/block.js";
+export { branch } from "./engine/block/branch.js";
+export { withVerify, modVerify, modVerifyAll, defineBlock } from "./engine/block/block.js";
+export { withDialog } from "./engine/block/dialog.js";
 export { defineNavBlock, defineNavClickBlock, defineMemNavBlock } from "./engine/block/kinds/nav.js";
 export { defineMethodBlock, defineAssertBlock } from "./engine/block/kinds/method.js";
 export { definePageBlock } from "./engine/block/kinds/page.js";
@@ -24,7 +27,8 @@ export { MapBuilder } from "./engine/flow/map-builder.js";
 export { branchRoutes, collectBranchFlows, runBranchRegression } from "./engine/flow/branch-regression.js";
 export type { BranchEntry, BranchRunResult, RunBranchRegressionOptions } from "./engine/flow/branch-regression.js";
 export type { ApiBlockOptions, ApiCallResult } from "./engine/block/kinds/api.js";
-export type { MapStepOpts, MapFlowOpts } from "./engine/flow/map-builder.js";
+export type { MapStepOpts } from "./engine/flow/map-steps.js";
+export type { MapFlowOpts } from "./engine/flow/map-builder.js";
 export { resolveHighlightSlots, resolveSlides, runStubPhase, hasAuthoredStubAfter, hasAuthoredStubOnError } from "./demo/narration/narration.js";
 export { resolveFixtureDwellMs, normalizeDemoPace, resolveStepDemoPace, demoPaceScale, demoPaceIsBlitz, demoPaceIsFast, demoPaceIsSlow, demoPaceGateMs, formatDemoPaceBadge, formatDemoPaceLabel, FIXTURE_DURATION_MS_DEFAULT, FIXTURE_DURATION_FAST_MS_DEFAULT, FIXTURE_DURATION_SLOW_MS_DEFAULT } from "./demo/narration/demo-pace.js";
 export { formatHighlightCaption, applyHighlightStyleDefaults, toneIconPrefix } from "./demo/narration/style.js";
@@ -46,21 +50,21 @@ export type { MethodBlock, AssertBlock, AssertBlockOptions } from "./engine/bloc
 export type { PageBlock, PageBlockOptions, PageMethodEntry } from "./engine/block/kinds/page.js";
 export type { EffectBlock } from "./engine/block/kinds/effect.js";
 export type { MapBuilderOptions } from "./engine/flow/map-builder.js";
-export type { ActionPage } from "./engine/block/block.js";
+export type { ActionPage } from "./engine/block/action-page.js";
 export { discoverGraph, toMermaid, findOrphanBlocks, findBlockPath } from "./analysis/graph.js";
 export { buildManifest } from "./manifest/manifest.js";
 export { onRunEvent } from "./engine/run/events.js";
 export type { RunEvent } from "./engine/run/events.js";
 export type { Manifest, ManifestBlock, ManifestFlow } from "./manifest/manifest.js";
 export type { WaygraphGraph, WaygraphNode, WaygraphEdge, SkippedBlock, OrphanBlock } from "./analysis/graph.js";
-export { isFileSelectToken, parseBlocksSelect, matchBlocksSelect, globToRegExp, } from "./manifest/select.js";
+export { isFileSelectToken, parseBlocksSelect, matchBlocksSelect, globToRegExp } from "./manifest/select.js";
 export type { BlocksSelect, BlocksSelectKind } from "./manifest/select.js";
 export { EdgeLeaseCoordinator } from "./live/traverse/lease.js";
 export { runTraverse } from "./live/traverse/traverse.js";
-export type { TraverseOptions, TraverseSessionMode, TraverseWorkerResult, } from "./live/traverse/traverse.js";
-export { buildCoverageReport, collectGraphEdgeKeys, defaultCoverageOutPath, formatCoverageLine, normalizeHitKey, parseMinEdgeCoverage, writeCoverageReport, } from "./live/traverse/coverage.js";
+export type { TraverseOptions, TraverseSessionMode, TraverseWorkerResult } from "./live/traverse/traverse.js";
+export { buildCoverageReport, collectGraphEdgeKeys, defaultCoverageOutPath, formatCoverageLine, normalizeHitKey, parseMinEdgeCoverage, writeCoverageReport } from "./live/traverse/coverage.js";
 export type { TraverseCoverageReport } from "./live/traverse/coverage.js";
-export { WG_UI_SEL, WG_READY_PANEL_SEL, WG_READY_AUTO_SEL, WG_READY_BANNER_SEL, readWgOverlayBeacon, readWgOverlayBeaconInPage, assertWgOverlayReady, } from "./demo/overlay/beacon.js";
+export { WG_UI_SEL, WG_READY_PANEL_SEL, WG_READY_AUTO_SEL, WG_READY_BANNER_SEL, readWgOverlayBeacon, readWgOverlayBeaconInPage, assertWgOverlayReady } from "./demo/overlay/beacon.js";
 export type { WgModalKind, WgBeaconRow } from "./demo/overlay/beacon.js";
 export { AutoSession } from "./live/auto-session/auto-session.js";
 export { stubFilePath } from "./live/auto-session/helpers.js";

package/dist/index.js

@@ -8,10 +8,12 @@ export { MemKey, MemPage, key, keyGroup } from "./engine/mem/mem.js";
 export { registerMemStub, seedMemStub, getMemStub } from "./engine/mem/mem-stub.js";
 export { css, byText, byRole } from "./engine/trait/selector.js";
 export { WaygraphError, WAYGRAPH_ERRORS } from "./engine/errors.js";
-export { Trait, urlMatches, textEquals, visible, disabled, enabled, frameVisible, frameTextEquals, frameContainsText, } from "./engine/trait/trait.js";
+export { Trait, urlMatches, textEquals, visible, disabled, enabled, frameVisible, frameTextEquals, frameContainsText } from "./engine/trait/trait.js";
 export { runGraph, spawnTab, narrate, preflight, defineLayout } from "./engine/run/run.js";
 export { Engine, map } from "./engine/engine.js";
-export { branch, withVerify, modVerify, modVerifyAll, defineBlock, withDialog } from "./engine/block/block.js";
+export { branch } from "./engine/block/branch.js";
+export { withVerify, modVerify, modVerifyAll, defineBlock } from "./engine/block/block.js";
+export { withDialog } from "./engine/block/dialog.js";
 export { defineNavBlock, defineNavClickBlock, defineMemNavBlock } from "./engine/block/kinds/nav.js";
 export { defineMethodBlock, defineAssertBlock } from "./engine/block/kinds/method.js";
 export { definePageBlock } from "./engine/block/kinds/page.js";
@@ -31,11 +33,11 @@ export { WAYGRAPH_RING_CSS } from "./demo/narration/css.js";
 export { discoverGraph, toMermaid, findOrphanBlocks, findBlockPath } from "./analysis/graph.js";
 export { buildManifest } from "./manifest/manifest.js";
 export { onRunEvent } from "./engine/run/events.js";
-export { isFileSelectToken, parseBlocksSelect, matchBlocksSelect, globToRegExp, } from "./manifest/select.js";
+export { isFileSelectToken, parseBlocksSelect, matchBlocksSelect, globToRegExp } from "./manifest/select.js";
 export { EdgeLeaseCoordinator } from "./live/traverse/lease.js";
 export { runTraverse } from "./live/traverse/traverse.js";
-export { buildCoverageReport, collectGraphEdgeKeys, defaultCoverageOutPath, formatCoverageLine, normalizeHitKey, parseMinEdgeCoverage, writeCoverageReport, } from "./live/traverse/coverage.js";
-export { WG_UI_SEL, WG_READY_PANEL_SEL, WG_READY_AUTO_SEL, WG_READY_BANNER_SEL, readWgOverlayBeacon, readWgOverlayBeaconInPage, assertWgOverlayReady, } from "./demo/overlay/beacon.js";
+export { buildCoverageReport, collectGraphEdgeKeys, defaultCoverageOutPath, formatCoverageLine, normalizeHitKey, parseMinEdgeCoverage, writeCoverageReport } from "./live/traverse/coverage.js";
+export { WG_UI_SEL, WG_READY_PANEL_SEL, WG_READY_AUTO_SEL, WG_READY_BANNER_SEL, readWgOverlayBeacon, readWgOverlayBeaconInPage, assertWgOverlayReady } from "./demo/overlay/beacon.js";
 export { AutoSession } from "./live/auto-session/auto-session.js";
 export { stubFilePath } from "./live/auto-session/helpers.js";
 export { pilotStart } from "./live/pilot/pilot.js";

package/dist/live/auto/auto.d.ts

@@ -1,9 +1,8 @@
-import type { BlockEntry } from "../../manifest/project.js";
-import type { Page, BrowserContext } from "@playwright/test";
+import type { BrowserContext, Page } from "@playwright/test";
+import type { Checkpoint } from "../../engine/checkpoint/checkpoint.js";
 import { Engine } from "../../engine/engine.js";
 import { MemPage } from "../../engine/mem/mem.js";
-import type { MemKey } from "../../engine/mem/mem.js";
-import type { Checkpoint } from "../../engine/checkpoint/checkpoint.js";
+import type { BlockEntry } from "../../manifest/project.js";
 export interface AutoExploreOptions {
     /** Terminal menu (browser still runs for act()). Default false = headful picker panel. */
     cli?: boolean;
@@ -16,18 +15,7 @@ export interface AutoExploreOptions {
 /** Which Checkpoint the page is on, asked of the project's own Nav / Page Blocks (their verify). */
 export declare function detectHere(page: Page, navBlocks: BlockEntry[]): Promise<string | null>;
 export declare function ensureLivePage(context: BrowserContext, page: Page, startUrl: string | undefined): Promise<Page>;
-/** The project's own default for a key: its `registerMemStub` fake (live sessions load every `*.mem-stubs.ts`). */
-export declare function memStubValue(key: MemKey<unknown>): unknown | undefined;
-/** Pre-seeds required keys from WAYGRAPH_DATA and the project's mem stubs, so a session does not stop for mem forms. */
-export declare function seedDefaultMem(library: Map<string, BlockEntry>, mem: MemPage): void;
-export declare function ensureMem(entry: BlockEntry, mem: MemPage, cli: boolean): Promise<void>;
 export declare function runOneBlock(engine: Engine, entry: BlockEntry, context: BrowserContext, page: Page, mem: MemPage, headful: boolean): Promise<Checkpoint<string>>;
-export type PickResult = {
-    type: "pick";
-    index: number;
-} | {
-    type: "quit";
-};
 /**
  * Interactive waygraph auto: locate current Checkpoint, list runnable Blocks, pick one, repeat.
  */