waygraph 0.14.0 → 0.15.0

package/examples/routed-demo/src/{routes/(external)/docs/nav.block.ts → map/(external)/docs/_nav.block.ts}

@@ -1,6 +1,6 @@
 import { defineNavBlock, Trait } from "waygraph";
 import type { Docs } from "../../../states/routed-demo.states.js";
-import { DocsSel, DOCS_URL } from "./docs.sel.js";
+import { DocsSel, DOCS_URL } from "./_sel.js";
 
 /**
  * Kind: Nav
@@ -8,7 +8,7 @@ import { DocsSel, DOCS_URL } from "./docs.sel.js";
  *
  * `(external)` is a purely organizational group folder (Next.js route-group
  * style, parens never affect the Checkpoint tag) - separates cross-origin/
- * external tooling from the app's own `(base_app)` pages, matching the
+ * external tooling from the app's own `(app_base)` pages, matching the
  * already-established `*-external/` namespacing precedent from
  * waygraph-mail-adapters.
  */

package/examples/routed-demo/src/{routes/(external)/docs/page.block.ts → map/(external)/docs/_page.block.ts}

@@ -1,6 +1,6 @@
 import { definePageBlock, Trait } from "waygraph";
 import type { Docs } from "../../../states/routed-demo.states.js";
-import { DocsSel } from "./docs.sel.js";
+import { DocsSel } from "./_sel.js";
 
 /**
  * Kind: Page

package/examples/routed-demo/test-results/.last-run.json

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

package/examples/routed-demo/tests/routed-demo-map.spec.ts

@@ -0,0 +1,17 @@
+import { test, expect } from "@playwright/test";
+import { MemPage, checkpoint } from "waygraph";
+import { routedDemoMapFlow } from "../src/flows/routed-demo-map.flow.js";
+
+/**
+ * Proof that `engine.map()` (the fluent, kind-checked flow builder) works
+ * end to end against a real browser/DOM, not just the in-memory fakes
+ * tests/nav/map-builder.spec.ts already covers in the main waygraph
+ * package - same real fixture server and real Blocks routed-demo.spec.ts
+ * already proves work via defineFlow/the CLI, this time built with
+ * .start().gotoPage(...).method(...).gotoPage(...).end() instead.
+ */
+test("engine.map()-built flow runs for real: Dashboard -> click widget -> Docs", async ({ context }) => {
+  const mem = new MemPage();
+  const result = await routedDemoMapFlow.run(context, mem);
+  expect(result).toEqual(checkpoint("Docs"));
+});

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "waygraph",
-  "version": "0.14.0",
+  "version": "0.15.0",
   "type": "module",
   "description": "A typed graph of reusable Blocks for driving a browser through E2E flows.",
   "license": "MIT",

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

@@ -8,7 +8,15 @@ 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/blocks/demo-web");
+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";
 
@@ -23,7 +31,8 @@ const TYPES = {
 const server = createServer((req, res) => {
   const raw = (req.url || "/").split("?")[0] || "/";
   const rel = raw === "/" ? "home.html" : raw.replace(/^\//, "");
-  const full = normalize(join(ROOT, rel));
+  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");

package/templates/scaffold/src/flows/example.flow.ts

@@ -1,15 +1,17 @@
 import { Engine, start, end, withTitle, withHighlightFixtures } from "waygraph";
-import { NavHomeBlock } from "../blocks/demo-web/nav-home.block.js";
-import { AssertHelloBlock } from "../blocks/demo-web/methods/assert-hello.method.block.js";
-// Page hub registered for auto/docs grouping (arrival-only after nav).
-import "../blocks/demo-web/home.page.block.js";
+import { NavHomeBlock } from "../map/(app_base)/home/_nav.block.js";
+import { AssertHelloBlock } from "../map/(app_base)/home/_methods/assert-hello.method.block.js";
+import { NavDocsBlock } from "../map/(app_base)/docs/_nav.block.js";
+// Page hubs registered for auto/docs grouping (arrival-only after nav).
+import "../map/(app_base)/home/_page.block.js";
+import "../map/(app_base)/docs/_page.block.js";
 
 const engine = new Engine();
 
-/** Smoke: nav + assert (no mem). Green offline. */
+/** Smoke: nav + assert (no mem), then nav to the sibling docs/ page. Green offline. */
 export const exampleFlow = withHighlightFixtures(
   withTitle(
-    engine.defineFlow([start, NavHomeBlock, AssertHelloBlock, end]),
+    engine.defineFlow([start, NavHomeBlock, AssertHelloBlock, NavDocsBlock, end]),
     "Scaffold: Hello Waygraph",
   ),
   {

package/templates/scaffold/src/flows/mail-verify.flow.ts

@@ -1,12 +1,12 @@
 import { Engine, start, end, withTitle, withHighlightFixtures } from "waygraph";
-import { NavMailpitInboxBlock } from "../blocks/demo-external/mailpit/nav-mailpit-inbox.block.js";
-import { AssertEmailReceivedBlock } from "../blocks/demo-external/mailpit/methods/assert-email-received.method.block.js";
-import { OpenMessageBlock } from "../blocks/demo-external/mailpit/methods/open-message.method.block.js";
-import { AssertEmailContentBlock } from "../blocks/demo-external/mailpit/methods/assert-email-content.method.block.js";
-import { ExtractEmailLinkBlock } from "../blocks/demo-external/mailpit/methods/extract-email-link.method.block.js";
-import { NavVerificationLinkBlock } from "../blocks/demo-web/nav-verification-link.block.js";
-import "../blocks/demo-external/mailpit/mailpit-inbox.page.block.js";
-import { MailpitSel } from "../blocks/demo-external/mailpit/mailpit-sel.js";
+import { NavMailpitInboxBlock } from "../map/(external)/mailpit/_nav.block.js";
+import { AssertEmailReceivedBlock } from "../map/(external)/mailpit/_methods/assert-email-received.method.block.js";
+import { OpenMessageBlock } from "../map/(external)/mailpit/_methods/open-message.method.block.js";
+import { AssertEmailContentBlock } from "../map/(external)/mailpit/_methods/assert-email-content.method.block.js";
+import { ExtractEmailLinkBlock } from "../map/(external)/mailpit/_methods/extract-email-link.method.block.js";
+import { NavVerificationLinkBlock } from "../map/(app_base)/home/nav-verification-link.block.js";
+import "../map/(external)/mailpit/_page.block.js";
+import { MailpitSel } from "../map/(external)/mailpit/_sel.js";
 
 const engine = new Engine();
 

package/templates/scaffold/src/flows/shop.flow.ts

@@ -6,12 +6,12 @@ import {
   withHighlightFixtures,
   withSessionReset,
 } from "waygraph";
-import { NavHomeBlock } from "../blocks/demo-web/nav-home.block.js";
-import { AddItemBlock } from "../blocks/demo-web/methods/add-item.effect.block.js";
-import { AssertItemAddedBlock } from "../blocks/demo-web/methods/assert-item-added.method.block.js";
-import { RemoveItemBlock } from "../blocks/demo-web/methods/remove-item.effect.block.js";
-import { ClearCartBlock } from "../blocks/demo-web/methods/clear-cart.method.block.js";
-import "../blocks/demo-web/home.page.block.js";
+import { NavHomeBlock } from "../map/(app_base)/home/_nav.block.js";
+import { AddItemBlock } from "../map/(app_base)/home/_methods/add-item.effect.block.js";
+import { AssertItemAddedBlock } from "../map/(app_base)/home/_methods/assert-item-added.method.block.js";
+import { RemoveItemBlock } from "../map/(app_base)/home/_methods/remove-item.effect.block.js";
+import { ClearCartBlock } from "../map/(app_base)/home/_methods/clear-cart.method.block.js";
+import "../map/(app_base)/home/_page.block.js";
 
 const engine = new Engine();
 

package/templates/scaffold/src/{routes/(external)/docs/nav.block.ts → map/(app_base)/docs/_nav.block.ts}

@@ -1,15 +1,14 @@
 import { defineNavBlock, Trait } from "waygraph";
 import type { Docs } from "../../../states/demo.states.js";
-import { DocsSel, DOCS_URL } from "./docs.sel.js";
+import { DocsSel, DOCS_URL } from "./_sel.js";
 
 /**
  * Kind: Nav
- * Route: (external)/docs/
+ * Route: (app_base)/docs/
  *
- * Demonstrates the Waygraph Map folder convention alongside this scaffold's
- * own default "manual mode" (src/blocks/) - a second, optional authoring
- * style, not a replacement. See README.md "Waygraph Map" and
- * openspec/changes/waygraph-map. `(external)` is purely organizational
+ * Same origin as home/ (same fixture server, different HTML file) - lives
+ * under (app_base), not (external). See README.md "Waygraph Map" and
+ * openspec/changes/waygraph-map. `(app_base)` is purely organizational
  * (Next.js route-group style) - never part of the Checkpoint tag.
  */
 export const NavDocsBlock = defineNavBlock<Docs>({

package/templates/scaffold/src/{routes/(external)/docs/page.block.ts → map/(app_base)/docs/_page.block.ts}

@@ -1,10 +1,10 @@
 import { definePageBlock, Trait } from "waygraph";
 import type { Docs } from "../../../states/demo.states.js";
-import { DocsSel } from "./docs.sel.js";
+import { DocsSel } from "./_sel.js";
 
 /**
  * Kind: Page
- * Route: (external)/docs/
+ * Route: (app_base)/docs/
  * Arrival-only (nav.block.ts already landed on Docs).
  */
 export const DocsPageBlock = definePageBlock<Docs>({

package/templates/scaffold/src/{blocks/demo-web/methods → map/(app_base)/home/_methods}/add-item.effect.block.ts

@@ -4,9 +4,9 @@ import {
   type Checkpoint,
   type WaygraphInstanceOption,
 } from "waygraph";
-import type { ItemInCart } from "../../../states/demo.states.js";
-import { SelectedItem } from "../../../states/demo.mem-keys.js";
-import { DemoSel } from "../demo-sel.js";
+import type { ItemInCart } from "../../../../states/demo.states.js";
+import { SelectedItem } from "../../../../states/demo.mem-keys.js";
+import { DemoSel } from "../_sel.js";
 
 /**
  * Kind: Effect

package/templates/scaffold/src/{blocks/demo-web/methods → map/(app_base)/home/_methods}/assert-hello.method.block.ts

@@ -1,5 +1,5 @@
 import { defineAssertBlock, Trait } from "waygraph";
-import { DemoSel } from "../demo-sel.js";
+import { DemoSel } from "../_sel.js";
 
 /**
  * Kind: Assert

package/templates/scaffold/src/{blocks/demo-web/methods → map/(app_base)/home/_methods}/assert-item-added.method.block.ts

@@ -1,7 +1,7 @@
 import { defineAssertBlock, Trait, type Trait as TraitType } from "waygraph";
-import type { ItemInCart } from "../../../states/demo.states.js";
-import { SelectedItem } from "../../../states/demo.mem-keys.js";
-import { DemoSel } from "../demo-sel.js";
+import type { ItemInCart } from "../../../../states/demo.states.js";
+import { SelectedItem } from "../../../../states/demo.mem-keys.js";
+import { DemoSel } from "../_sel.js";
 
 /**
  * Mem-aware Trait: which item's Remove button should be visible depends on

package/templates/scaffold/src/{blocks/demo-web/methods → map/(app_base)/home/_methods}/clear-cart.method.block.ts

@@ -1,12 +1,18 @@
 import { defineMethodBlock, checkpoint, Trait } from "waygraph";
-import { DemoSel } from "../demo-sel.js";
+import type { ItemInCart, CartEmpty } from "../../../../states/demo.states.js";
+import { DemoSel } from "../_sel.js";
 
 /**
  * Kind: Method
  * Helper: defineMethodBlock
- * Route: demo-web/methods/
+ * Route: (app_base)/home/_methods/
+ *
+ * Real, pre-existing bug found live while verifying the Waygraph Map
+ * rename: this Block had no explicit <In, Out> generic at all, so static
+ * discovery (`waygraph graph`) always skipped it silently ("no ...generic
+ * call found") - present before this move, not caused by it.
  */
-export const ClearCartBlock = defineMethodBlock({
+export const ClearCartBlock = defineMethodBlock<ItemInCart, CartEmpty>({
   name: "clear-cart",
   description: "Clears every item via the Clear cart control.",
   instruction: {

package/templates/scaffold/src/{blocks/demo-web/methods → map/(app_base)/home/_methods}/remove-item.effect.block.ts

@@ -4,9 +4,9 @@ import {
   type Checkpoint,
   type WaygraphInstanceOption,
 } from "waygraph";
-import type { CartEmpty } from "../../../states/demo.states.js";
-import { SelectedItem } from "../../../states/demo.mem-keys.js";
-import { DemoSel } from "../demo-sel.js";
+import type { CartEmpty } from "../../../../states/demo.states.js";
+import { SelectedItem } from "../../../../states/demo.mem-keys.js";
+import { DemoSel } from "../_sel.js";
 
 /**
  * Kind: Effect

package/templates/scaffold/src/{blocks/demo-web/nav-home.block.ts → map/(app_base)/home/_nav.block.ts}

@@ -1,10 +1,10 @@
 import { defineNavBlock, Trait } from "waygraph";
-import { DemoSel, HOME_URL } from "./demo-sel.js";
+import { DemoSel, HOME_URL } from "./_sel.js";
 
 /**
  * Kind: Nav
  * Helper: defineNavBlock
- * Route: demo-web/  (synthetic "/")
+ * Route: (app_base)/home/  (synthetic "/")
  */
 export const NavHomeBlock = defineNavBlock({
   name: "nav-home",

package/templates/scaffold/src/{blocks/demo-web/home.page.block.ts → map/(app_base)/home/_page.block.ts}

@@ -1,15 +1,15 @@
 import { definePageBlock, Trait } from "waygraph";
-import type { Home } from "../../states/demo.states.js";
-import { DemoSel } from "./demo-sel.js";
-import { AddItemBlock } from "./methods/add-item.effect.block.js";
-import { RemoveItemBlock } from "./methods/remove-item.effect.block.js";
-import { ClearCartBlock } from "./methods/clear-cart.method.block.js";
-import { AssertHelloBlock } from "./methods/assert-hello.method.block.js";
+import type { Home } from "../../../states/demo.states.js";
+import { DemoSel } from "./_sel.js";
+import { AddItemBlock } from "./_methods/add-item.effect.block.js";
+import { RemoveItemBlock } from "./_methods/remove-item.effect.block.js";
+import { ClearCartBlock } from "./_methods/clear-cart.method.block.js";
+import { AssertHelloBlock } from "./_methods/assert-hello.method.block.js";
 
 /**
  * Kind: Page
  * Helper: definePageBlock
- * Route: demo-web/
+ * Route: (app_base)/home/
  *
  * Hub for the offline home screen. Methods hang here for docs/auto grouping;
  * edges in flows still reference the method Blocks directly.

package/templates/scaffold/src/{blocks/demo-web → map/(app_base)/home}/nav-verification-link.block.ts

@@ -1,12 +1,12 @@
 import { defineNavBlock, Trait } from "waygraph";
-import type { HomeVerified } from "../../states/demo.states.js";
-import { EmailLink } from "../../states/demo.mem-keys.js";
-import { DemoSel } from "./demo-sel.js";
+import type { HomeVerified } from "../../../states/demo.states.js";
+import { EmailLink } from "../../../states/demo.mem-keys.js";
+import { DemoSel } from "./_sel.js";
 
 /**
  * Kind: Nav
  * Helper: defineNavBlock
- * Route: demo-web/
+ * Route: (app_base)/home/
  *
  * Navigates back into the app to the link extract-email-link read out of
  * the real Mailpit message, then confirms the page actually reflects it

package/templates/scaffold/src/{blocks/demo-external/mailpit/methods → map/(external)/mailpit/_methods}/assert-email-content.method.block.ts

@@ -1,7 +1,7 @@
 import { defineAssertBlock, type Trait } from "waygraph";
 import type { MailpitMessageOpen } from "../../../../states/demo.states.js";
 import { ExpectedEmailContent } from "../../../../states/demo.mem-keys.js";
-import { MailpitSel } from "../mailpit-sel.js";
+import { MailpitSel } from "../_sel.js";
 
 /**
  * Mem-aware Trait: the expected copy varies per email scenario, so it can't
@@ -22,7 +22,7 @@ const bodyContainsExpectedText: Trait = {
 /**
  * Kind: Assert
  * Helper: defineAssertBlock
- * Route: demo-external/mailpit/methods/
+ * Route: demo-external/mailpit/_methods/
  *
  * "Does the email actually say what it's supposed to" - not just "does a
  * link exist somewhere in it." Reads the message body straight out of the

package/templates/scaffold/src/{blocks/demo-external/mailpit/methods → map/(external)/mailpit/_methods}/assert-email-received.method.block.ts

@@ -1,7 +1,7 @@
 import { defineAssertBlock, type Trait } from "waygraph";
 import type { MailpitInbox } from "../../../../states/demo.states.js";
 import { ExpectedRecipient } from "../../../../states/demo.mem-keys.js";
-import { MailpitSel } from "../mailpit-sel.js";
+import { MailpitSel } from "../_sel.js";
 
 /**
  * Mem-aware Trait: the selector depends on which recipient this run expects,
@@ -28,7 +28,7 @@ const emailReceived: Trait = {
 /**
  * Kind: Assert
  * Helper: defineAssertBlock
- * Route: demo-external/mailpit/methods/
+ * Route: demo-external/mailpit/_methods/
  *
  * "Did the email even arrive" - a lightweight existence check that does not
  * open or consume the message, so it's safe to run before deciding to open

package/templates/scaffold/src/{blocks/demo-external/mailpit/methods → map/(external)/mailpit/_methods}/extract-email-link.method.block.ts

@@ -1,12 +1,12 @@
 import { defineMethodBlock, checkpoint } from "waygraph";
 import type { MailpitMessageOpen } from "../../../../states/demo.states.js";
 import { EmailLink, ExpectedLinkPattern } from "../../../../states/demo.mem-keys.js";
-import { MailpitSel } from "../mailpit-sel.js";
+import { MailpitSel } from "../_sel.js";
 
 /**
  * Kind: Method
  * Helper: defineMethodBlock
- * Route: demo-external/mailpit/methods/
+ * Route: demo-external/mailpit/_methods/
  *
  * Reads a link straight out of the open message's HTML preview iframe via a
  * real DOM read (getAttribute) - no mail-catcher REST API - and stores it in

package/templates/scaffold/src/{blocks/demo-external/mailpit/methods → map/(external)/mailpit/_methods}/open-message.method.block.ts

@@ -1,12 +1,12 @@
 import { defineMethodBlock, checkpoint } from "waygraph";
 import type { MailpitInbox, MailpitMessageOpen } from "../../../../states/demo.states.js";
 import { ExpectedRecipient } from "../../../../states/demo.mem-keys.js";
-import { MailpitSel } from "../mailpit-sel.js";
+import { MailpitSel } from "../_sel.js";
 
 /**
  * Kind: Method
  * Helper: defineMethodBlock
- * Route: demo-external/mailpit/methods/
+ * Route: demo-external/mailpit/_methods/
  *
  * Opens the newest inbox row addressed to the mem-set recipient (not bare
  * inbox position - a prior run's leftover mail for a different recipient

package/templates/scaffold/src/{blocks/demo-external/mailpit/nav-mailpit-inbox.block.ts → map/(external)/mailpit/_nav.block.ts}

@@ -4,9 +4,9 @@ import type { MailpitInbox } from "../../../states/demo.states.js";
 /**
  * Kind: Nav
  * Helper: defineNavBlock
- * Route: demo-external/mailpit/  (cross-origin - a real Mailpit web UI, not this app)
+ * Route: (external)/mailpit/  (cross-origin - a real Mailpit web UI, not this app)
  *
- * Cross-origin tooling lives under demo-external/, never demo-web/ - this is
+ * Cross-origin tooling lives under (external)/, never (app_base)/ - this is
  * a dev-inbox screen, not part of the app under test. `WAYGRAPH_MAIL_URL`
  * defaults to Mailpit's own usual local port.
  */

package/templates/scaffold/src/{blocks/demo-external/mailpit/mailpit-inbox.page.block.ts → map/(external)/mailpit/_page.block.ts}

@@ -1,14 +1,14 @@
 import { definePageBlock, Trait } from "waygraph";
 import type { MailpitInbox } from "../../../states/demo.states.js";
-import { AssertEmailReceivedBlock } from "./methods/assert-email-received.method.block.js";
-import { OpenMessageBlock } from "./methods/open-message.method.block.js";
-import { AssertEmailContentBlock } from "./methods/assert-email-content.method.block.js";
-import { ExtractEmailLinkBlock } from "./methods/extract-email-link.method.block.js";
+import { AssertEmailReceivedBlock } from "./_methods/assert-email-received.method.block.js";
+import { OpenMessageBlock } from "./_methods/open-message.method.block.js";
+import { AssertEmailContentBlock } from "./_methods/assert-email-content.method.block.js";
+import { ExtractEmailLinkBlock } from "./_methods/extract-email-link.method.block.js";
 
 /**
  * Kind: Page
  * Helper: definePageBlock
- * Route: demo-external/mailpit/  (= http://127.0.0.1:8025/ by default)
+ * Route: (external)/mailpit/  (= http://127.0.0.1:8025/ by default)
  *
  * Hub for the Mailpit dev-inbox screen. Arrival-only (no url/click) -
  * nav-mailpit-inbox owns the goto. Methods: confirm the email arrived, open

package/templates/scaffold/src/states/demo.states.ts

@@ -5,7 +5,7 @@ export type HomeVerified = Checkpoint<"HomeVerified">;
 export type ItemInCart = Checkpoint<"ItemInCart">;
 export type CartEmpty = Checkpoint<"CartEmpty">;
 
-// --- Mailpit (external tool surface, demo-external lane) ---
+// --- Mailpit (external tool surface, src/map/(external)/mailpit/) ---
 
 /** Mailpit inbox UI reached; message list visible. */
 export type MailpitInbox = Checkpoint<"MailpitInbox">;
@@ -13,7 +13,5 @@ export type MailpitInbox = Checkpoint<"MailpitInbox">;
 /** The message addressed to the expected recipient is open; preview iframe visible. */
 export type MailpitMessageOpen = Checkpoint<"MailpitMessageOpen">;
 
-// --- Waygraph Map convention demo (src/routes/, alongside src/blocks/'s manual mode) ---
-
-/** Reached via src/routes/(external)/docs/ - see openspec/changes/waygraph-map. */
+/** Reached via src/map/(app_base)/docs/ - see openspec/changes/waygraph-map. */
 export type Docs = Checkpoint<"Docs">;

package/templates/scaffold/tests/example.spec.ts

@@ -4,9 +4,9 @@ import { exampleFlow } from "../src/flows/example.flow.js";
 import { shopFlow } from "../src/flows/shop.flow.js";
 import { SelectedItem } from "../src/states/demo.mem-keys.js";
 
-test("example flow reaches HomeVerified", async ({ context }) => {
+test("example flow reaches Docs (home -> assert -> sibling docs/ page)", async ({ context }) => {
   const result = await exampleFlow.run(context, new MemPage());
-  expect(result).toEqual(checkpoint("HomeVerified"));
+  expect(result).toEqual(checkpoint("Docs"));
 });
 
 test("shop flow adds then clears (Effect + Method)", async ({ context }) => {

package/templates/scaffold/tests/mail-verify.spec.ts

@@ -4,7 +4,7 @@ import net from "node:net";
 import { MemPage, checkpoint } from "waygraph";
 import { mailVerifyFlow } from "../src/flows/mail-verify.flow.js";
 import { ExpectedRecipient, ExpectedLinkPattern, ExpectedEmailContent } from "../src/states/demo.mem-keys.js";
-import { HOME_URL } from "../src/blocks/demo-web/demo-sel.js";
+import { HOME_URL } from "../src/map/(app_base)/home/_sel.js";
 
 /**
  * This scaffold has no real backend, so these tests play the role of "the

package/templates/scaffold/src/blocks/SITE-MAP.md

@@ -1,12 +0,0 @@
-# Site map (scaffold)
-
-Offline catalog uses one synthetic namespace (`demo-web/`) and a local
-`home.html` fixture so `npm test` / `waygraph auto` need no network.
-
-| Folder | URL | Notes |
-|--------|-----|-------|
-| `demo-web/` | `/` (synthetic) | Nav + Page hub + methods/effects |
-| `demo-web/methods/` | same URL | assert, add/remove Effects, clear |
-
-When you wire a real app, rename `demo-web/` to your FE origin namespace and
-add one folder per real `page.tsx` route. See **Consumer layout** docs.