waygraph 0.15.50 → 0.15.51

package/examples/saucedemo/scripts/show-add-to-cart-menu.mjs

@@ -1,123 +0,0 @@
-// Headful demo: login, then show the live add-to-cart menu (one row per
-// product still on the page), pick the bike light, prove that item lands in
-// the cart. Browser stays open ~12s at each pause so you can eyeball it.
-import { chromium } from "@playwright/test";
-import { join, dirname } from "node:path";
-import { fileURLToPath, pathToFileURL } from "node:url";
-import { createRequire } from "node:module";
-
-const require = createRequire(import.meta.url);
-await import(require.resolve("tsx/esm"));
-
-const root = join(dirname(fileURLToPath(import.meta.url)), "..");
-const waygraphDist = join(root, "../../dist");
-
-const { buildExploreContext, buildExploreMenu } = await import(
-  pathToFileURL(join(waygraphDist, "auto-explore.js")).href
-);
-const { MemPage, Engine, start, end } = await import(pathToFileURL(join(waygraphDist, "index.js")).href);
-const { installDemoChrome } = await import(pathToFileURL(join(waygraphDist, "step-overlay.js")).href);
-
-const exe = process.env.CHROME_PATH || process.env.CHROMIUM_PATH;
-const pauseMs = Number(process.env.WG_SHOW_PAUSE_MS ?? 10_000);
-
-async function runBlock(engine, entry, context, page, mem) {
-  const flow = engine.defineFlow([start, entry.block, end]);
-  await flow.run(context, mem, { page, closeOnFinish: false });
-}
-
-function sleep(ms) {
-  return new Promise((r) => setTimeout(r, ms));
-}
-
-async function paintMenu(page, menu) {
-  const lines = [];
-  lines.push(`<style>
-    #wg-show{position:fixed;z-index:2147483647;left:50%;bottom:16px;transform:translateX(-50%);
-      max-width:min(92vw,640px);max-height:70vh;overflow:auto;background:rgba(20,10,40,.95);color:#fff;
-      border-radius:14px;padding:16px 20px;font:14px/1.4 system-ui,sans-serif;
-      box-shadow:0 12px 30px rgba(0,0,0,.4)}
-    #wg-show h3{margin:0 0 8px;font-size:16px}
-    #wg-show .here{color:#c9a6ff;margin-bottom:10px}
-    #wg-show .sec{margin:10px 0 6px;font-size:11px;font-weight:700;color:#a78bfa;text-transform:uppercase}
-    #wg-show .row{display:block;margin:6px 0;padding:10px 12px;border-radius:10px;border:1px solid #5b3aa8;
-      background:#2a1450;color:#fff}
-    #wg-show .pick{border-color:#34d399;background:#14532d}
-  </style>`);
-  lines.push(`<div id="wg-show"><h3>waygraph auto — live menu</h3>`);
-  lines.push(`<div class="here">You are here: <strong>${menu.here}</strong></div>`);
-  for (const section of menu.sections) {
-    lines.push(`<div class="sec">${section.title}</div>`);
-    for (const e of section.edges) {
-      const text = e.label ?? `${e.block} → ${e.to}`;
-      const cls = e.block === "add-to-cart" ? "row pick" : "row";
-      lines.push(`<div class="${cls}">${text.replace(/</g, "&lt;")}</div>`);
-    }
-  }
-  lines.push(`</div>`);
-  const html = lines.join("");
-  await page.evaluate((inner) => {
-    let el = document.getElementById("wg-show");
-    if (!el) {
-      el = document.createElement("div");
-      document.documentElement.appendChild(el);
-    }
-    el.outerHTML = inner;
-  }, html);
-}
-
-const { graph, library } = await buildExploreContext(root);
-const mem = new MemPage();
-mem.set(library.byName.get("submit-login").block.requires[0], {
-  username: "standard_user",
-  password: "secret_sauce",
-});
-
-const browser = await chromium.launch({
-  headless: false,
-  slowMo: 200,
-  args: ["--start-maximized"],
-  ...(exe ? { executablePath: exe } : {}),
-});
-const context = await browser.newContext({
-  baseURL: "https://www.saucedemo.com",
-  viewport: null,
-});
-const page = await context.newPage();
-const engine = new Engine({ headless: false, slowMo: 200 });
-
-await page.goto("/", { waitUntil: "load" });
-await installDemoChrome(page, "show add-to-cart menu", { banner: false });
-
-console.error("SHOW: logging in…");
-await runBlock(engine, library.byName.get("submit-login"), context, page, mem);
-await page.waitForURL(/inventory\.html/);
-
-const menu1 = await buildExploreMenu(page, graph, library, "LoggedIn");
-const addRows = menu1.flat.filter((e) => e.block === "add-to-cart");
-console.error(`SHOW: ${addRows.length} add-to-cart rows (one per product still addable):`);
-for (const r of addRows) console.error(`  - ${r.label}`);
-
-await paintMenu(page, menu1);
-console.error(`SHOW: look at the purple panel — pause ${pauseMs / 1000}s`);
-await sleep(pauseMs);
-
-const bike = addRows.find((r) => r.instanceOption?.value?.id === "sauce-labs-bike-light");
-if (!bike) throw new Error("bike light row missing");
-mem.set(bike.instanceOption.key, bike.instanceOption.value);
-console.error(`SHOW: picking → ${bike.label}`);
-await runBlock(engine, library.byName.get("add-to-cart"), context, page, mem);
-
-const menu2 = await buildExploreMenu(page, graph, library, "LoggedIn");
-await paintMenu(page, menu2);
-const stillBike = menu2.flat.some(
-  (e) => e.block === "add-to-cart" && e.instanceOption?.value?.id === "sauce-labs-bike-light",
-);
-console.error(
-  `SHOW: bike light in cart (Remove button visible), menu no longer offers it: ${!stillBike}`,
-);
-console.error(`SHOW: pause ${pauseMs / 1000}s then closing`);
-await sleep(pauseMs);
-
-await browser.close();
-console.error("SHOW: done");

package/examples/saucedemo/scripts/show-auto-menu.mjs

@@ -1,72 +0,0 @@
-// Dump waygraph auto menu sections on inventory (incl. bulk add/remove-all).
-import { chromium } from "@playwright/test";
-import { join, dirname } from "node:path";
-import { fileURLToPath, pathToFileURL } from "node:url";
-import { createRequire } from "node:module";
-
-const require = createRequire(import.meta.url);
-await import(require.resolve("tsx/esm"));
-
-const root = join(dirname(fileURLToPath(import.meta.url)), "..");
-const waygraphDist = join(root, "../../dist");
-
-const { buildExploreContext, buildExploreMenu } = await import(
-  pathToFileURL(join(waygraphDist, "auto-explore.js")).href
-);
-const { MemPage, Engine, start, end } = await import(
-  pathToFileURL(join(waygraphDist, "index.js")).href
-);
-
-const exe = process.env.CHROME_PATH || process.env.CHROMIUM_PATH;
-
-async function runBlock(engine, entry, context, page, mem) {
-  const flow = engine.defineFlow([start, entry.block, end]);
-  await flow.run(context, mem, { page, closeOnFinish: false });
-}
-
-function dump(title, menu) {
-  console.log(`\n=== ${title} (here=${menu.here}) ===`);
-  for (const sec of menu.sections) {
-    console.log(`\n[${sec.title}]`);
-    for (const e of sec.edges) {
-      const label = e.label ?? `${e.block} -> ${e.to}`;
-      console.log(`  • ${label}`);
-    }
-  }
-}
-
-const { graph, library } = await buildExploreContext(root);
-const mem = new MemPage();
-mem.set(library.byName.get("submit-login").block.requires[0], {
-  username: "standard_user",
-  password: "secret_sauce",
-});
-
-const browser = await chromium.launch({
-  headless: true,
-  ...(exe ? { executablePath: exe, args: ["--no-sandbox"] } : {}),
-});
-const context = await browser.newContext({
-  baseURL: "https://www.saucedemo.com",
-  viewport: { width: 1280, height: 900 },
-});
-const page = await context.newPage();
-const engine = new Engine({ headless: true });
-
-await page.goto("/", { waitUntil: "load" });
-await runBlock(engine, library.byName.get("submit-login"), context, page, mem);
-await page.waitForURL(/inventory\.html/);
-
-const menu1 = await buildExploreMenu(page, graph, library, "LoggedIn");
-dump("AFTER LOGIN — cart empty", menu1);
-
-const bike = menu1.flat.find(
-  (e) => e.block === "add-to-cart" && e.instanceOption?.value?.id === "sauce-labs-bike-light",
-);
-mem.set(bike.instanceOption.key, bike.instanceOption.value);
-await runBlock(engine, library.byName.get("add-to-cart"), context, page, mem);
-
-const menu2 = await buildExploreMenu(page, graph, library, "LoggedIn");
-dump("AFTER ADD BIKE LIGHT — mixed", menu2);
-
-await browser.close();

package/templates/scaffold/scripts/README.md

@@ -1,13 +0,0 @@
-# `scripts/`
-
-- `fixture-server.mjs` - serves the offline `.html` fixture pages under `src/map/` on
-  `127.0.0.1:4177` (override with `WAYGRAPH_FIXTURE_PORT`/`WAYGRAPH_FIXTURE_HOST`). This is
-  what makes `npm test` pass with no network and no real app running.
-- `with-fixture.mjs` - starts `fixture-server.mjs`, runs whatever command you give it
-  (`waygraph auto`, `waygraph demo --blocks ...`), then tears the server down when that command
-  exits. Every `npm run demo*`/`auto*` script in `package.json` goes through this wrapper -
-  don't run `waygraph demo`/`auto` directly against this scaffold's own fixture pages without it.
-
-Pointing this scaffold at a real app instead of the offline fixtures: change `_nav.block.ts`'s
-`url`/`homeOrigin` to the real one and drop `with-fixture.mjs` from the scripts that no longer
-need it.

package/templates/scaffold/scripts/fixture-server.mjs

@@ -1,50 +0,0 @@
-#!/usr/bin/env node
-/**
- * Tiny static server for the offline scaffold fixture (home.html).
- * Flatpak Chromium cannot open file:// under /tmp — HTTP localhost works.
- */
-import { createServer } from "node:http";
-import { readFileSync, existsSync } from "node:fs";
-import { join, dirname, extname, normalize } from "node:path";
-import { fileURLToPath } from "node:url";
-
-const ROOT = join(dirname(fileURLToPath(import.meta.url)), "../src/map/(app_base)");
-// Each fixture HTML file lives beside its own _page.block.ts under the
-// Waygraph Map convention now (home/home.html, docs/docs.html) - no longer
-// a single flat directory, so this maps the request filename to its own
-// page's subfolder instead of assuming one shared ROOT holds every file.
-const FILE_DIRS = {
-  "home.html": "home",
-  "docs.html": "docs",
-};
-const PORT = Number(process.env.WAYGRAPH_FIXTURE_PORT || 4177);
-const HOST = process.env.WAYGRAPH_FIXTURE_HOST || "127.0.0.1";
-
-const TYPES = {
-  ".html": "text/html; charset=utf-8",
-  ".css": "text/css; charset=utf-8",
-  ".js": "text/javascript; charset=utf-8",
-  ".svg": "image/svg+xml",
-  ".png": "image/png",
-};
-
-const server = createServer((req, res) => {
-  const raw = (req.url || "/").split("?")[0] || "/";
-  const rel = raw === "/" ? "home.html" : raw.replace(/^\//, "");
-  const subdir = FILE_DIRS[rel];
-  const full = subdir ? normalize(join(ROOT, subdir, rel)) : normalize(join(ROOT, rel));
-  if (!full.startsWith(ROOT) || !existsSync(full)) {
-    res.writeHead(404, { "content-type": "text/plain" });
-    res.end("not found");
-    return;
-  }
-  const type = TYPES[extname(full)] || "application/octet-stream";
-  res.writeHead(200, { "content-type": type });
-  res.end(readFileSync(full));
-});
-
-server.listen(PORT, HOST, () => {
-  if (process.env.WAYGRAPH_FIXTURE_QUIET !== "1") {
-    console.error(`waygraph fixture: http://${HOST}:${PORT}/home.html`);
-  }
-});

package/templates/scaffold/scripts/with-fixture.mjs

@@ -1,69 +0,0 @@
-#!/usr/bin/env node
-/**
- * Start fixture-server, run a child command, tear down on exit.
- * Usage: node scripts/with-fixture.mjs [--] <cmd> [args...]
- */
-import { spawn } from "node:child_process";
-import { dirname, join } from "node:path";
-import { fileURLToPath } from "node:url";
-
-const HERE = dirname(fileURLToPath(import.meta.url));
-const PORT = process.env.WAYGRAPH_FIXTURE_PORT || "4177";
-const HOST = process.env.WAYGRAPH_FIXTURE_HOST || "127.0.0.1";
-
-const argv = process.argv.slice(2).filter((a) => a !== "--");
-if (argv.length === 0) {
-  console.error("usage: node scripts/with-fixture.mjs <cmd> [args...]");
-  process.exit(1);
-}
-
-const env = {
-  ...process.env,
-  WAYGRAPH_FIXTURE_PORT: PORT,
-  WAYGRAPH_FIXTURE_HOST: HOST,
-  WAYGRAPH_FIXTURE_QUIET: "1",
-  WAYGRAPH_BASE_URL: process.env.WAYGRAPH_BASE_URL || `http://${HOST}:${PORT}`,
-};
-
-const server = spawn(process.execPath, [join(HERE, "fixture-server.mjs")], {
-  env,
-  stdio: ["ignore", "ignore", "inherit"],
-});
-
-function killServer() {
-  try {
-    server.kill("SIGTERM");
-  } catch {
-    /* ignore */
-  }
-}
-
-async function waitReady(ms = 5000) {
-  const url = `http://${HOST}:${PORT}/home.html`;
-  const start = Date.now();
-  while (Date.now() - start < ms) {
-    try {
-      const res = await fetch(url);
-      if (res.ok) return;
-    } catch {
-      /* retry */
-    }
-    await new Promise((r) => setTimeout(r, 50));
-  }
-  throw new Error(`fixture server not ready at ${url}`);
-}
-
-let code = 1;
-try {
-  await waitReady();
-  const child = spawn(argv[0], argv.slice(1), { env, stdio: "inherit", shell: false });
-  code = await new Promise((resolve) => {
-    child.on("exit", (c, signal) => resolve(signal ? 1 : (c ?? 1)));
-  });
-} catch (e) {
-  console.error(e instanceof Error ? e.message : String(e));
-  code = 1;
-} finally {
-  killServer();
-}
-process.exit(code);

package/templates/scaffold/test-results/.last-run.json

@@ -1,4 +0,0 @@
-{
-  "status": "failed",
-  "failedTests": []
-}