waygraph 0.15.51 → 0.15.53

package/dist/runner/main.js

@@ -10,7 +10,8 @@ import { connect } from "../types.js";
 import { MemPage } from "../mem-page.js";
 import { Engine, start, end, chainFlow, isFastForwardBlock, branchRoutes, runBranchRegression } from "../core.js";
 import { withWebServer } from "../webserver.js";
-import { chromiumExecutablePath } from "../browser-path.js";
+import { resolveVideoDir } from "../video-dir.js";
+import { chromiumExecutablePath, extensionPathsFromEnv, launchContext } from "../browser.js";
 
 async function runMain() {
   const projectDir = process.argv[2];
@@ -230,6 +231,9 @@ async function runMain() {
         : "waygraph demo: opaque FFCompose in flow -> Playwright slowMo=0 (blitz); set WAYGRAPH_SLOWMO to override",
     );
   }
+  // Step (demo) mode: slowMo is waygraph's own beat after each action, not Playwright's per-operation slowMo, so a
+  // step's pace can remove it and typing is not taxed per keystroke. The browser launches at 0.
+  const launchSlowMo = step ? 0 : slowMo;
   const baseURL = process.env.WAYGRAPH_BASE_URL;
   const title = process.env.WAYGRAPH_TITLE;
   // Comma-separated Block names (their real .name, e.g. "login") that
@@ -252,7 +256,7 @@ async function runMain() {
   const videoEnv = process.env.WAYGRAPH_VIDEO;
   let videoDir = null;
   if (videoEnv) {
-    videoDir = videoEnv === "1" ? join(projectDir, ".waygraph-videos") : videoEnv;
+    videoDir = videoEnv === "1" ? await resolveVideoDir(projectDir) : videoEnv;
     mkdirSync(videoDir, { recursive: true });
   }
   /** Fixed 16:9 capture for --video (demo QA and headless run). Step+video no longer maximizes. */
@@ -262,7 +266,7 @@ async function runMain() {
   const fixedVideoViewport = videoDir
     ? (videoViewportParsed ?? (step ? DEFAULT_VIDEO_VIEWPORT : DEFAULT_RUN_VIDEO_VIEWPORT))
     : null;
-  const engine = new Engine({ headless: !headed, slowMo });
+  const engine = new Engine({ headless: !headed, slowMo: launchSlowMo });
   let result;
   // Non-interactive execution (no --step) runs the whole chain as one
   // composed flow with no per-block loop of its own to defer seeding
@@ -290,12 +294,6 @@ async function runMain() {
     const executablePath = chromiumExecutablePath();
     // Maximized for interactive step, and for fixed video viewport so the
     // locked record size can actually fit (otherwise .webm gets grey pad).
-    const browser = await chromium.launch({
-      headless: !headed,
-      slowMo,
-      args: step || fixedVideoViewport ? ["--start-maximized"] : [],
-      ...(executablePath ? { executablePath } : {}),
-    });
     const contextOpts = fixedVideoViewport
       ? {
           baseURL,
@@ -313,7 +311,17 @@ async function runMain() {
         ? { dir: videoDir, size: fixedVideoViewport }
         : { dir: videoDir };
     }
-    const context = await browser.newContext(contextOpts);
+    const { context, close: closeBrowser } = await launchContext({
+      launcher: chromium,
+      launch: {
+        headless: !headed,
+        slowMo: launchSlowMo,
+        args: step || fixedVideoViewport ? ["--start-maximized"] : [],
+        ...(executablePath ? { executablePath } : {}),
+      },
+      context: contextOpts,
+      extensions: extensionPathsFromEnv(),
+    });
     let pageForVideo = null;
     try {
       if (step) {
@@ -369,7 +377,7 @@ async function runMain() {
       if (savedVideo) {
         console.log("waygraph: video saved to " + savedVideo);
       }
-      await browser.close();
+      await closeBrowser();
     }
   } else {
     if (chainFlows && chainFlows.length > 0) {
@@ -421,6 +429,9 @@ async function runAllBranchesMode(chainFlows, mem, baseURL, headed, engine) {
     process.exitCode = 1;
     return;
   }
+  if (extensionPathsFromEnv().length > 0) {
+    console.warn("waygraph run --all-branches: extensions are not loaded (branches run in cloned contexts)");
+  }
   const { chromium } = await import("@playwright/test");
   const browser = await chromium.launch({ headless: !headed });
   const cloneSession = process.env.WAYGRAPH_SHARED_SESSION !== "1";

package/dist/runner/rings.js

@@ -381,55 +381,6 @@ export async function cycleHighlightRings(page, highlights, gatesFast, opts) {
 }
 
 
-/**
- * Paint a NAMED ring instance (ui/css/ring.css's shared `.wg-ring-el`/`.wg-ring-el-label`) at a
- * known viewport box - the primitive both the demo/auto singleton (`showRing`, always "wg-ring")
- * and Pilot's several simultaneous fixture rings (their own ids) paint through, so there is one
- * ring-rendering implementation, not two. No collision/follow/focus - those are `#wg-ring`'s own
- * extras (see `showRing`/`inpage/core.js`'s `__wgPositionRing`), meaningless for an independent
- * fixture ring that isn't "the current action."
- */
-export async function showRingAt(page, ringId, labelId, box, label, tone, style) {
-  const size = normalizeHighlightSize(style && style.size);
-  const weight = normalizeHighlightWeight(style && style.weight);
-  const color = style && style.color ? String(style.color) : "";
-  await page
-    .evaluate(
-      ({ ringId, labelId, box, label, tone, size, weight, color }) => {
-        if (window.__wgPaintRingAt) {
-          window.__wgPaintRingAt(ringId, labelId, box, label, tone, { size, weight, color });
-        }
-      },
-      { ringId, labelId, box, label, tone: tone || "planned", size, weight, color },
-    )
-    .catch(() => {});
-}
-
-/** Hide (not remove) a named ring instance painted via {@link showRingAt}. */
-export async function hideRingAt(page, ringId, labelId) {
-  await page
-    .evaluate(
-      ({ ringId, labelId }) => {
-        if (window.__wgHideRingAt) window.__wgHideRingAt(ringId, labelId);
-      },
-      { ringId, labelId },
-    )
-    .catch(() => {});
-}
-
-/** Remove a named ring instance entirely (Pilot's fixture rings are short-lived, not reused). */
-export async function removeRingAt(page, ringId, labelId) {
-  await page
-    .evaluate(
-      ({ ringId, labelId }) => {
-        __wgById(ringId)?.remove();
-        __wgById(labelId)?.remove();
-      },
-      { ringId, labelId },
-    )
-    .catch(() => {});
-}
-
 export async function showRing(page, box, label, tone, style) {
   const size = normalizeHighlightSize(style && style.size);
   const weight = normalizeHighlightWeight(style && style.weight);

package/dist/runner/step-mode.js

@@ -1,7 +1,7 @@
 // Moved verbatim from the former CHAIN_RUNNER_SCRIPT template string in cli.ts (see src/ARCHITECTURE.md).
 // Runs inside the target project's own waygraph copy - keep it dependency-light and self-contained.
 import { instrumentInteractionHighlighting } from "./interaction-patch.js";
-import { applyHighlightStyleDefaults, demoPaceGateMs, demoPaceIsBlitz, demoPaceIsFast, demoPaceIsSlow, formatHighlightCaption, hasAuthoredStubAfter, resolveSlides, resolveStepDemoPace, resolveTodoDockUi, runStubPhase } from "../highlights.js";
+import { applyHighlightStyleDefaults, normalizeDemoPace, demoPaceGateMs, demoPaceIsBlitz, demoPaceIsFast, demoPaceIsSlow, formatHighlightCaption, hasAuthoredStubAfter, resolveSlides, resolveStepDemoPace, resolveTodoDockUi, runStubPhase } from "../highlights.js";
 import { markStepRunning, resetPageState, teardownOverlay } from "./teardown.js";
 import { demoLog, logStubPhaseFixtures, logTodoDockFull, paceSpeakFields, summarizeDevice } from "./demo-log.js";
 import { extractVerifyHighlights, presentFailPanel, renderAfterStep, renderBeforeStep } from "./step-panels.js";
@@ -26,6 +26,8 @@ export async function runStepMode(engine, start, end, context, page, mem, resolv
   const demoFast = process.env.WAYGRAPH_DEMO_FAST === "1";
   const stepperMode = process.env.WAYGRAPH_STEPPER === "full" ? "full" : "carousel";
   const pacing = { gatesFast: demoFast, gatesSlow: false, skipTheater: false, demoPace: "normal" };
+  // A title set by a stub (`ctx.title`) names the flow from that step on, until another stub sets a new one.
+  let stickyTitle;
   const stubBeforeRef = { current: [] };
   /** Live todo dock for Method fill/click advance (same carry as stage.state.lastTodoDock). */
   const todoDockRef = { current: undefined };
@@ -213,15 +215,18 @@ export async function runStepMode(engine, start, end, context, page, mem, resolv
     }
     // Episode pace: block > flow > CLI --fast (only when no authored pace).
     // Authoring wins: withDemoPace("slow"|2|4500) keeps slow dwell even under --fast.
+    // `demo.pace` in the config (WAYGRAPH_DEMO_PACE) is the default for flows and steps that set none.
+    const defaultPace = process.env.WAYGRAPH_DEMO_PACE ? normalizeDemoPace(process.env.WAYGRAPH_DEMO_PACE) : undefined;
     const stepPace = resolveStepDemoPace({
       blockPace: r.block.demoPace,
-      flowPace: r.demoPace,
+      flowPace: r.demoPace ?? defaultPace,
       fastForward: !!r.block.fastForward,
       wasFastForward: !!r.wasFastForward,
     });
     const authoredPace =
       (r.block.demoPace != null && r.block.demoPace !== "") ||
-      (r.demoPace != null && r.demoPace !== "");
+      (r.demoPace != null && r.demoPace !== "") ||
+      defaultPace != null;
     const cliFast = demoFast || fastBlockNames.has(r.block.name);
     pacing.demoPace =
       stepPace === "normal" && cliFast && !authoredPace
@@ -266,8 +271,9 @@ export async function runStepMode(engine, start, end, context, page, mem, resolv
       (stage.state.lastTodoDock && stage.state.lastTodoDock.groups[0] && stage.state.lastTodoDock.groups[0].items) ||
       stubBeforePhase.todos ||
       [];
+    if (stubBeforePhase.title && String(stubBeforePhase.title).trim()) stickyTitle = String(stubBeforePhase.title).trim();
     const overlayTitle =
-      (stubBeforePhase.title && String(stubBeforePhase.title).trim()) ||
+      stickyTitle ||
       (r.episodeTitle && String(r.episodeTitle).trim()) ||
       title ||
       "waygraph demo";

package/dist/session/auto-explore-run.js

@@ -5,9 +5,9 @@ import { Engine, start, end, locate } from "../core.js";
 import { MemPage } from "../mem-page.js";
 import { buildExploreContext, buildExploreMenu, } from "./auto-explore.js";
 import { installDemoChrome, instrumentInteractionHighlighting } from "./step-overlay.js";
-import { resolveBaseUrl } from "../config.js";
+import { configuredExtensions, resolveBaseUrl } from "../config.js";
 import { withWebServer } from "../webserver.js";
-import { chromiumExecutablePath } from "../browser-path.js";
+import { chromiumExecutablePath, launchContext } from "../browser.js";
 /** See `../config.js`'s own `resolveBaseUrl` - re-exported so existing importers of this module
  * don't need to change their import path. */
 export { resolveBaseUrl };
@@ -587,13 +587,17 @@ async function runAutoExploreCore(projectDir, options = {}) {
         launchOpts.slowMo = 250;
     if (executablePath)
         launchOpts.executablePath = executablePath;
-    const browser = await chromium.launch(launchOpts);
     const contextOpts = cli
         ? { viewport: { width: 1280, height: 720 } }
         : { viewport: null };
     if (baseURL)
         contextOpts.baseURL = baseURL;
-    const context = await browser.newContext(contextOpts);
+    const { close: closeBrowser, context } = await launchContext({
+        launcher: chromium,
+        launch: launchOpts,
+        context: contextOpts,
+        extensions: await configuredExtensions(projectDir),
+    });
     let page = await context.newPage();
     if (startUrl) {
         await page.goto(startUrl, { waitUntil: "domcontentloaded" }).catch(() => { });
@@ -692,6 +696,6 @@ async function runAutoExploreCore(projectDir, options = {}) {
     finally {
         cliRl?.close();
         await context.close();
-        await browser.close();
+        await closeBrowser();
     }
 }

package/dist/session/auto-explore.d.ts

@@ -24,7 +24,7 @@ export interface ExploreEdge extends WaygraphEdge {
     label?: string;
     instanceOption?: WaygraphInstanceOption;
 }
-export interface ExploreSection {
+interface ExploreSection {
     title: string;
     edges: ExploreEdge[];
 }
@@ -55,3 +55,4 @@ export declare function buildExploreContext(projectDir: string, opts?: ExploreCo
     graph: WaygraphGraph;
     library: Awaited<ReturnType<typeof loadBlockLibrary>>;
 }>;
+export {};

package/dist/session/auto-explore.js

@@ -169,7 +169,7 @@ export function exploreChoices(graph, here) {
     const out = [];
     for (const edge of graph.edges) {
         if (here === null) {
-            if (edge.kind !== "nav")
+            if (edge.kind !== "nav" || edge.from !== "*")
                 continue;
         }
         else if (edge.from !== here && edge.from !== "*") {
@@ -283,8 +283,9 @@ export async function buildExploreMenu(page, graph, library, here) {
             continue;
         if (here === null) {
             // Bootstrap only: URL deep-links as "Start here". Click-nav needs a live
-            // control so it cannot seed an unknown page.
-            if (!isUrlNav(entry))
+            // control so it cannot seed an unknown page, and a Nav with `from` needs
+            // that state first (e.g. signed in) so it cannot start one either.
+            if (!isUrlNav(entry) || edge.from !== "*")
                 continue;
             push(navigate, edge);
             continue;
@@ -295,7 +296,8 @@ export async function buildExploreMenu(page, graph, library, here) {
         // Graph still marks NavBlocks from:"*" for pathfinding/traverse; auto menu
         // only offers click-nav whose control is visible on this page (navRunnable).
         // Otherwise LoginForm lists every app route + mailpit as if legal moves.
-        if (isUrlNav(entry))
+        // A url Nav that declares `from` is only an edge from those pages, so it IS a real move here.
+        if (isUrlNav(entry) && edge.from === "*")
             continue;
         if (isBackEdge(edge) && (edge.from === here || edge.from === "*")) {
             push(back, edge);

package/dist/session/auto-session-ipc.d.ts

@@ -1,6 +1,6 @@
 import { AutoSession, type AutoSessionInit, type SessionSnapshot, type InspectDomOptions, type DomSnapshot, type TraceStep, type ApplyPathResult, type ConsoleLogEntry, type StorageSnapshot, type StubFileKind } from "../auto-session.js";
 import type { PilotHighlightFixtures } from "../pilot-overlay.js";
-export type { PilotHighlightFixtures, PilotFixtureRing } from "../pilot-overlay.js";
+export type { PilotHighlightFixtures } from "../pilot-overlay.js";
 export interface SessionMeta {
     sessionId: string;
     socketPath: string;
@@ -54,7 +54,6 @@ export type HighlightResponse = {
     ok: false;
     error: string;
 };
-export declare function readSessionMeta(projectDir: string, sessionId: string): SessionMeta | null;
 /**
  * Resolve session metadata from a project hint (cwd) or the global registry.
  * Fixes "session unreachable" when the agent calls status/send from a different

package/dist/session/auto-session-ipc.js

@@ -58,7 +58,7 @@ function logPathFor(projectDir, sessionId) {
 function generateSessionId() {
     return randomBytes(4).toString("hex");
 }
-export function readSessionMeta(projectDir, sessionId) {
+function readSessionMeta(projectDir, sessionId) {
     const p = metaPath(projectDir, sessionId);
     if (!existsSync(p))
         return null;

package/dist/session/block-inject.d.ts

@@ -1,21 +1,8 @@
-/**
- * This package's own installed root (contains `templates/`/`examples/`, sibling to `dist/`) -
- * this file compiles to `dist/session/block-inject.js`, two levels down, not one. Same class of
- * bug as `cli/util.ts`'s own `packageRoot()` (see its comment) - self-inflicted here by moving
- * this file into `src/session/` without updating the path math to match the new depth.
- */
-export declare function packageRoot(): string;
-/** Human label for an injected root (used in merged `file` paths). */
-export declare function injectLabel(root: string): string;
 /**
  * Display path for a Block discovered under an inject root (not the host cwd).
  * Primary project files stay relative as-is; injected ones are tagged `@label/...`.
  */
 export declare function injectTaggedFile(hostDir: string, root: string, relFile: string): string;
-/**
- * Resolve one `--inject` token to an absolute directory (preset name or path).
- */
-export declare function resolveInjectRoot(token: string, cwd?: string): string;
 export declare function resolveInjectRoots(tokens: string[], cwd?: string): string[];
 /** Roots to scan: host project first, then each inject path (deduped). */
 export declare function exploreRoots(projectDir: string, inject?: string[]): string[];

package/dist/session/block-inject.js

@@ -12,11 +12,11 @@ import { homedir } from "node:os";
  * bug as `cli/util.ts`'s own `packageRoot()` (see its comment) - self-inflicted here by moving
  * this file into `src/session/` without updating the path math to match the new depth.
  */
-export function packageRoot() {
+function packageRoot() {
     return resolve(dirname(fileURLToPath(import.meta.url)), "..", "..");
 }
 /** Human label for an injected root (used in merged `file` paths). */
-export function injectLabel(root) {
+function injectLabel(root) {
     return basename(root.replace(/\/$/, ""));
 }
 /**
@@ -50,7 +50,7 @@ const PRESETS = {
 /**
  * Resolve one `--inject` token to an absolute directory (preset name or path).
  */
-export function resolveInjectRoot(token, cwd = process.cwd()) {
+function resolveInjectRoot(token, cwd = process.cwd()) {
     const raw = token.trim();
     if (!raw)
         throw new Error("waygraph inject: empty --inject value");

package/dist/session/pilot.d.ts

@@ -29,7 +29,6 @@
  * new execution primitive.
  */
 import { type WaygraphGraph } from "../analysis/graph.js";
-import { listBrowserSessions, type SessionMeta } from "./auto-session-ipc.js";
 import { type BrowserStartInit } from "./browser.js";
 import type { SessionSnapshot } from "../auto-session.js";
 export interface PilotStartResult {
@@ -51,4 +50,3 @@ export interface PilotStartResult {
 export declare function pilotStart(init: BrowserStartInit): Promise<PilotStartResult>;
 /** Reattach to an existing browser session — does not spawn a new browser. */
 export declare function pilotAttach(projectDir: string, sessionId: string, inject?: string[]): Promise<PilotStartResult>;
-export { listBrowserSessions, type SessionMeta };

package/dist/session/pilot.js

@@ -29,7 +29,7 @@
  * new execution primitive.
  */
 import { discoverGraph } from "../analysis/graph.js";
-import { requestSession, listBrowserSessions, resolveSessionMeta, } from "./auto-session-ipc.js";
+import { requestSession, resolveSessionMeta, } from "./auto-session-ipc.js";
 import { browserStart } from "./browser.js";
 /**
  * Starts a detached session and reads back its own graph + starting
@@ -77,4 +77,3 @@ export async function pilotAttach(projectDir, sessionId, inject) {
         snapshot: status.snapshot,
     };
 }
-export { listBrowserSessions };

package/dist/session/step-overlay.js

@@ -86,7 +86,9 @@ export async function installDemoChrome(page, title = "waygraph auto", options =
             ring.style.width = box.width + pad * 2 + "px";
             ring.style.height = box.height + pad * 2 + "px";
             ring.style.opacity = "1";
-            ringLabel.textContent = label;
+            // Drawn from data-label (CSS ::after), not DOM text, so the page's own text selectors never match it.
+            ringLabel.dataset.label = label;
+            ringLabel.textContent = "";
             ringLabel.style.left = box.x + "px";
             ringLabel.style.top = box.y + box.height + 8 + "px";
             ringLabel.style.opacity = "1";

package/dist/traverse/coverage.d.ts

@@ -27,10 +27,6 @@ export interface TraverseCoverageReport {
         leaf?: string;
     }>;
 }
-/** Static graph edge key = Block runtime name. */
-export declare function edgeKeyFromGraphEdge(edge: {
-    block: string;
-}): string;
 /** Collect unique edge keys from a WaygraphGraph-like edges list. */
 export declare function collectGraphEdgeKeys(edges: ReadonlyArray<{
     block: string;

package/dist/traverse/coverage.js

@@ -10,7 +10,7 @@
 import { mkdirSync, writeFileSync } from "node:fs";
 import { dirname, join } from "node:path";
 /** Static graph edge key = Block runtime name. */
-export function edgeKeyFromGraphEdge(edge) {
+function edgeKeyFromGraphEdge(edge) {
     return edge.block;
 }
 /** Collect unique edge keys from a WaygraphGraph-like edges list. */

package/dist/traverse/run.js

@@ -5,7 +5,7 @@ import { defaultMemValueForKey } from "../session/auto-explore-run.js";
 import { resolveBaseUrl } from "../config.js";
 import { EdgeLeaseCoordinator } from "./lease.js";
 import { buildCoverageReport, collectGraphEdgeKeys, defaultCoverageOutPath, formatCoverageLine, writeCoverageReport, } from "./coverage.js";
-import { chromiumExecutablePath } from "../browser-path.js";
+import { chromiumExecutablePath } from "../browser.js";
 function seedMem(library, mem, dataJson) {
     const raw = dataJson ?? process.env.WAYGRAPH_DATA ?? process.env.WAYGRAPH_AUTO_MEM;
     let envParsed = {};
@@ -253,6 +253,8 @@ export async function runTraverse(projectDir, options = {}) {
     const allEdgeKeys = collectGraphEdgeKeys(graph.edges);
     const leases = new EdgeLeaseCoordinator({ projectDir, persist: parallel > 1 });
     const engine = new Engine({ headless: !headed, slowMo: headed ? 100 : 0 });
+    if (process.env.WAYGRAPH_EXTENSIONS)
+        console.error("waygraph traverse: extensions are not loaded (workers use plain contexts)");
     const { chromium } = await import("@playwright/test");
     const executablePath = chromiumExecutablePath();
     const launchOpts = {

package/dist/types.d.ts

@@ -2,7 +2,7 @@ import type { Page } from "@playwright/test";
 import type { MemPage, MemKey } from "./mem-page.js";
 import type { Trait } from "./trait.js";
 import type { HighlightStubPhaseOrFn, WaygraphHighlight, WaygraphSlidesOrFn } from "./highlights.js";
-export type { WaygraphHighlight, WaygraphHighlightStub, WaygraphHighlightFixture, WaygraphSlide, HighlightStubPhase, HighlightStubPhaseOrFn, HighlightFixtureMap, ResolvedHighlight, StubCtx, StubLifecycleFn, StubPhaseResult, StubPhaseFixtures, WaygraphTodoItem, WaygraphTodoInput, } from "./highlights.js";
+export type { WaygraphHighlight } from "./highlights.js";
 /**
  * A Checkpoint is identified solely by its string tag - a phantom marker with no
  * embedded data. Two Checkpoints with the same tag are the same state everywhere.

package/dist/ui/components/ring.js

@@ -20,6 +20,7 @@ export function ringCss() {
         "#wg-ring-label{position:fixed;z-index:2147483646;pointer-events:none;opacity:0;" +
         `max-width:min(360px,70vw);white-space:normal;padding:6px 10px;border-radius:7px;background:${p.labelBg};color:${p.labelFg};` +
         "font:600 12px/1.35 system-ui,sans-serif;transition:opacity .3s ease;}" +
+        "#wg-ring-label::after{content:attr(data-label);}" +
         toneRules("#wg-ring-label", (t) => `background:${t.labelBg};color:${t.labelFg};`) +
         // Gray = a real Playwright-driven instruction: mark it with a robot.
         `#wg-ring-label[data-tone=auto]::before{${ROBOT}}` +

package/dist/ui/overlay.css

@@ -86,6 +86,7 @@
   font: 600 12px/1.35 var(--wg-font); transition: opacity .3s ease;
   overflow: hidden; text-overflow: ellipsis; white-space: nowrap; box-shadow: 0 2px 8px rgba(0,0,0,.25);
 }
+#wg-ring-label::after { content: attr(data-label); }
 .wg-ring-el-label[data-tone=planned] { --wg-tone-bg: var(--wg-tone-planned-bg); --wg-tone-fg: var(--wg-tone-planned-fg); }
 .wg-ring-el-label[data-tone=auto]    { --wg-tone-bg: var(--wg-tone-auto-bg);    --wg-tone-fg: var(--wg-tone-auto-fg); }
 .wg-ring-el-label[data-tone=info]    { --wg-tone-bg: var(--wg-tone-info-bg);    --wg-tone-fg: var(--wg-tone-info-fg); }

package/dist/ui/shadow.d.ts

@@ -7,7 +7,7 @@
  * lookups check the shadow root first and fall back to the light DOM (the device stage shell and
  * host-page markers such as `[data-wg-zoomed]` intentionally stay in the light DOM).
  */
-import type { BrowserContext, Page } from "@playwright/test";
+import type { Page } from "@playwright/test";
 /**
  * `overlaySheet` is the ONE real-CSS bundle (`ui/stylesheet.ts` -> `dist/ui/overlay.css`, built on
  * Open Props - see `src/ui/css/README.md`) every surface shares; passed in from Node since in-page
@@ -16,5 +16,3 @@ import type { BrowserContext, Page } from "@playwright/test";
 export declare function installShadowRoot(overlaySheet?: string): void;
 /** Idempotent; call before any overlay install on a page. Installs the shared stylesheet bundle. */
 export declare function ensureShadowRoot(page: Page): Promise<void>;
-/** Also define the helpers on every future document (pilot overlay persists across navigations). */
-export declare function installShadowRootEverywhere(context: BrowserContext): Promise<void>;

package/dist/ui/shadow.js

@@ -44,7 +44,3 @@ export function installShadowRoot(overlaySheet) {
 export async function ensureShadowRoot(page) {
     await page.evaluate(installShadowRoot, getOverlaySheet()).catch(() => { });
 }
-/** Also define the helpers on every future document (pilot overlay persists across navigations). */
-export async function installShadowRootEverywhere(context) {
-    await context.addInitScript(installShadowRoot, getOverlaySheet());
-}

package/dist/ui/tokens.d.ts

@@ -18,14 +18,3 @@ export interface Tone {
 export declare const TONES: Record<ToneName, Tone>;
 /** Dark surface shared by panels, banner, docks, HUD chips. */
 export declare const SURFACE = "rgba(20,10,40,.94)";
-export declare const ACCENT = "#7C3AED";
-/** Secondary accent used on the dark surface (section titles, kinds). */
-export declare const ACCENT_SOFT = "#c9a6ff";
-/** Stacking order: one scale instead of magic numbers. */
-export declare const Z: {
-    readonly top: 2147483647;
-    readonly ring: 2147483646;
-    readonly fx: 2147483645;
-    readonly focus: 2147483644;
-    readonly dock: 2147483000;
-};

package/dist/ui/tokens.js

@@ -14,8 +14,3 @@ export const TONES = {
 };
 /** Dark surface shared by panels, banner, docks, HUD chips. */
 export const SURFACE = "rgba(20,10,40,.94)";
-export const ACCENT = "#7C3AED";
-/** Secondary accent used on the dark surface (section titles, kinds). */
-export const ACCENT_SOFT = "#c9a6ff";
-/** Stacking order: one scale instead of magic numbers. */
-export const Z = { top: 2147483647, ring: 2147483646, fx: 2147483645, focus: 2147483644, dock: 2147483000 };

package/dist/video-dir.d.ts

@@ -0,0 +1,8 @@
+/** The user's Downloads folder, or undefined when there is none (a server, a container). */
+export declare function downloadsDir(): string | undefined;
+/**
+ * Where `--video` recordings go: `WAYGRAPH_VIDEO_DIR`, else `video.dir` from the config (absolute, `~/…`, or relative to
+ * the project), else `<Downloads>/waygraph-videos/<project>`. With no usable Downloads folder, or on CI, it is
+ * `<project>/.waygraph-videos`. An explicit `--video <dir>` never reaches this.
+ */
+export declare function resolveVideoDir(projectDir: string): Promise<string>;

package/dist/video-dir.js

@@ -0,0 +1,60 @@
+import { existsSync, mkdirSync, readFileSync, rmSync, writeFileSync } from "node:fs";
+import { homedir } from "node:os";
+import { basename, isAbsolute, join, resolve } from "node:path";
+import { loadWaygraphConfig } from "./config.js";
+/** The user's Downloads folder, or undefined when there is none (a server, a container). */
+export function downloadsDir() {
+    const home = homedir();
+    let dir = process.env.XDG_DOWNLOAD_DIR;
+    if (!dir && process.platform === "linux") {
+        try {
+            const line = readFileSync(join(process.env.XDG_CONFIG_HOME ?? join(home, ".config"), "user-dirs.dirs"), "utf-8")
+                .split("\n")
+                .find((l) => l.startsWith("XDG_DOWNLOAD_DIR="));
+            dir = line?.slice("XDG_DOWNLOAD_DIR=".length).replace(/^"|"$/g, "").replace("$HOME", home);
+        }
+        catch {
+            /* no user-dirs file: use the conventional name */
+        }
+    }
+    dir ??= join(home, "Downloads");
+    return existsSync(dir) ? dir : undefined;
+}
+const expandHome = (p) => (p === "~" || p.startsWith("~/") ? join(homedir(), p.slice(1)) : p);
+/** True if a file can be created in `dir` (macOS asks permission for Downloads the first time; a denial surfaces here). */
+function writable(dir) {
+    try {
+        mkdirSync(dir, { recursive: true });
+        const probe = join(dir, `.waygraph-probe-${process.pid}`);
+        writeFileSync(probe, "");
+        rmSync(probe);
+        return true;
+    }
+    catch {
+        return false;
+    }
+}
+/**
+ * Where `--video` recordings go: `WAYGRAPH_VIDEO_DIR`, else `video.dir` from the config (absolute, `~/…`, or relative to
+ * the project), else `<Downloads>/waygraph-videos/<project>`. With no usable Downloads folder, or on CI, it is
+ * `<project>/.waygraph-videos`. An explicit `--video <dir>` never reaches this.
+ */
+export async function resolveVideoDir(projectDir) {
+    const fallback = join(projectDir, ".waygraph-videos");
+    const configured = process.env.WAYGRAPH_VIDEO_DIR || (await loadWaygraphConfig(projectDir))?.video?.dir;
+    if (configured) {
+        const dir = isAbsolute(expandHome(configured)) ? expandHome(configured) : resolve(projectDir, configured);
+        if (writable(dir))
+            return dir;
+        console.error(`waygraph: cannot write videos to ${dir} - using ${fallback}`);
+        return fallback;
+    }
+    const downloads = process.env.CI ? undefined : downloadsDir();
+    if (!downloads)
+        return fallback;
+    const dir = join(downloads, "waygraph-videos", basename(resolve(projectDir)));
+    if (writable(dir))
+        return dir;
+    console.error(`waygraph: cannot write to ${downloads} (denied?) - saving videos in ${fallback}`);
+    return fallback;
+}

package/dist/webserver.js

@@ -1,9 +1,10 @@
-// Starts/stops a project's own playwright.config `webServer` around `waygraph run`/`demo`/`auto`,
+// Starts/stops a project's `webServer` (waygraph.config, or a legacy playwright.config) around `waygraph run`/`demo`/`auto`,
 // the same block `waygraph test` already honors.
 import { existsSync } from "node:fs";
 import { join } from "node:path";
 import { pathToFileURL } from "node:url";
 import { spawn } from "node:child_process";
+import { loadWaygraphConfig } from "./config.js";
 const CONFIG_FILES = [
     "playwright.config.ts",
     "playwright.config.mts",
@@ -12,6 +13,9 @@ const CONFIG_FILES = [
     "playwright.config.cjs",
 ];
 async function loadWebServerConfigs(projectDir) {
+    const fromWaygraph = (await loadWaygraphConfig(projectDir))?.webServer;
+    if (fromWaygraph)
+        return Array.isArray(fromWaygraph) ? fromWaygraph : [fromWaygraph];
     for (const name of CONFIG_FILES) {
         const p = join(projectDir, name);
         if (!existsSync(p))