@marver-design/marver 0.22.0 → 0.23.0

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (61) hide show
  1. package/CHANGELOG.md +106 -0
  2. package/README.md +13 -9
  3. package/dist/agent-BsieQGTD.mjs +99 -0
  4. package/dist/{bake-BSX4XR_U.mjs → bake-l6N12qgx.mjs} +1 -1
  5. package/dist/{board-status-CWGHIdo_.mjs → board-status-D_lHZZ09.mjs} +69 -610
  6. package/dist/{boards-BTGNPVMx.mjs → boards-CahYhF5B.mjs} +3 -1
  7. package/dist/boards-DbVJlbd5.mjs +612 -0
  8. package/dist/{build-Dd2Qm3OG.mjs → build-CuRhHXcY.mjs} +10 -6
  9. package/dist/cli.mjs +22 -12
  10. package/dist/{comments-ClVgfQib.mjs → comments-0d3e274b.mjs} +71 -9
  11. package/dist/{config-DJxMRVD8.mjs → config-g-J8NrPn.mjs} +5 -97
  12. package/dist/{context-DUAENlJ6.mjs → context-fAtQLHt2.mjs} +3 -2
  13. package/dist/{daemon-BmkwErpC.mjs → daemon-DZ367fiM.mjs} +75 -17
  14. package/dist/{dev-BW7a5kDF.mjs → dev-R6zvwbqX.mjs} +55 -9
  15. package/dist/{init-NJ3xjLVu.mjs → init-DAnBlt-V.mjs} +6 -4
  16. package/dist/{ledger-Bu0BjqIe.mjs → ledger-BNXW14Xw.mjs} +1 -6
  17. package/dist/link-CcfAfKY-.mjs +132 -0
  18. package/dist/{manifest-BqBcMJcd.mjs → manifest-BkjJ5OQk.mjs} +73 -5
  19. package/dist/{plugin-8XntSCx_.mjs → plugin-C1avHL7g.mjs} +357 -31
  20. package/dist/{poster-DRZDszTI.mjs → poster-Bc4-3DlQ.mjs} +1 -1
  21. package/dist/{profile-BjAPAJSb.mjs → profile-CrZohD6g.mjs} +1 -1
  22. package/dist/{publish-bakes-CCWRV9iX.mjs → publish-bakes-DQWn14IY.mjs} +2 -2
  23. package/dist/{share--bdSc4G5.mjs → share-BD-wcDQq.mjs} +1 -1
  24. package/dist/{shot-BFEuYbaz.mjs → shot-C1YR_Sqx.mjs} +1 -1
  25. package/dist/{shot-C22Ues04.mjs → shot-CVOlQHUr.mjs} +2 -2
  26. package/dist/{sync-BZaCWqK-.mjs → sync-DoA1vf4u.mjs} +15 -1
  27. package/dist/{work-0YopuMt9.mjs → work-CJ8OIpBD.mjs} +9 -3
  28. package/dist/{work-CLrmY-vQ.mjs → work-CiUvBVa6.mjs} +72 -1
  29. package/docs/boards-and-folders.md +54 -6
  30. package/docs/context.md +10 -2
  31. package/docs/live-jam.md +11 -0
  32. package/package.json +1 -1
  33. package/src/client/content/diagram.tsx +7 -1
  34. package/src/client/content/img-lod.ts +12 -2
  35. package/src/client/content/index.tsx +69 -6
  36. package/src/client/frame-host/inspect.js +23 -0
  37. package/src/client/shell/App.tsx +19 -9
  38. package/src/client/shell/BoardList.tsx +21 -6
  39. package/src/client/shell/LockedApp.tsx +2 -2
  40. package/src/client/shell/Play.tsx +5 -1
  41. package/src/client/shell/StatusPicker.tsx +12 -5
  42. package/src/client/shell/Tip.tsx +25 -5
  43. package/src/client/shell/board-icons.tsx +15 -1
  44. package/src/client/shell/canvas/Canvas.tsx +42 -6
  45. package/src/client/shell/canvas/anchor.ts +41 -0
  46. package/src/client/shell/canvas/ctl.ts +6 -0
  47. package/src/client/shell/comments-store.ts +8 -5
  48. package/src/client/shell/goto.ts +52 -3
  49. package/src/client/shell/hash.ts +24 -3
  50. package/src/client/shell/store.ts +242 -28
  51. package/src/client/shell/styles.css +19 -2
  52. package/src/shared/board-types.ts +10 -6
  53. package/src/shared/status.ts +17 -8
  54. package/templates/AGENTS-embedded.md +54 -8
  55. package/templates/AGENTS-studio.md +54 -8
  56. package/templates/instructions/boards.md +15 -3
  57. package/templates/instructions/context.md +20 -7
  58. package/templates/instructions/iterate.md +29 -16
  59. package/templates/instructions/jam.md +9 -2
  60. package/templates/instructions/reference/deck-layouts.md +2 -1
  61. package/templates/instructions/reference/deck-story.md +2 -1
@@ -1,7 +1,7 @@
1
1
  import { i as PKG, r as NAME } from "./cli.mjs";
2
- import { i as detectHost, n as loadConfig } from "./config-DJxMRVD8.mjs";
3
- import { n as tailwind3Css, r as tailwind4Plugin, t as marverPlugin } from "./plugin-8XntSCx_.mjs";
4
- import { readFileSync, readdirSync, realpathSync, statSync } from "node:fs";
2
+ import { n as loadConfig, r as detectHost } from "./config-g-J8NrPn.mjs";
3
+ import { n as tailwind3Css, r as tailwind4Plugin, t as marverPlugin } from "./plugin-C1avHL7g.mjs";
4
+ import { existsSync, mkdirSync, readFileSync, readdirSync, realpathSync, statSync, watch } from "node:fs";
5
5
  import { basename, dirname, isAbsolute, join, relative, resolve } from "node:path";
6
6
  import { fileURLToPath } from "node:url";
7
7
  import { createLogger, createServer, parseAst, searchForWorkspaceRoot } from "vite";
@@ -454,12 +454,12 @@ async function dev(root, portFlag) {
454
454
  console.log(`\n ${NAME} · ${projectName} → http://localhost:${port}/\n`);
455
455
  setTimeout(async () => {
456
456
  try {
457
- await (await import("./shot-C22Ues04.mjs")).sweepGhosts((m) => console.log(` ${m}`));
457
+ await (await import("./shot-CVOlQHUr.mjs")).sweepGhosts((m) => console.log(` ${m}`));
458
458
  } catch {}
459
459
  }, 0);
460
460
  try {
461
461
  const { staleManagedInstructions } = await import("./managed-HwHVNI3h.mjs");
462
- const { installedVersion } = await import("./plugin-8XntSCx_.mjs").then((n) => n.i);
462
+ const { installedVersion } = await import("./plugin-C1avHL7g.mjs").then((n) => n.i);
463
463
  const stale = staleManagedInstructions(root);
464
464
  if (stale.length) {
465
465
  const shown = stale.slice(0, 4).join(", ") + (stale.length > 4 ? `, +${stale.length - 4} more` : "");
@@ -467,7 +467,13 @@ async function dev(root, portFlag) {
467
467
  console.log(` instructions predate ${v ? NAME + " " + v : "the installed version"} (${shown}) - run: npx ${NAME} init\n`);
468
468
  }
469
469
  } catch {}
470
- const { loadCollab, syncOnce } = await import("./sync-BZaCWqK-.mjs").then((n) => n.o);
470
+ try {
471
+ if (!existsSync(join(root, "context"))) {
472
+ const n = (await import("./manifest-BkjJ5OQk.mjs").then((n) => n.i)).statusBoards(root).length;
473
+ if (n) console.log(` ${n} feature/project board${n === 1 ? "" : "s"}, no context/ - every status reads Backlog. To start it, tell your agent: "Set up our context."\n`);
474
+ }
475
+ } catch {}
476
+ const { loadCollab, syncOnce } = await import("./sync-DoA1vf4u.mjs").then((n) => n.o);
471
477
  if (loadCollab(root)) console.log(` comments: syncing with the published canvas\n`);
472
478
  let syncing = false;
473
479
  const tick = async () => {
@@ -482,8 +488,25 @@ async function dev(root, portFlag) {
482
488
  };
483
489
  tick();
484
490
  setInterval(tick, 3e4).unref();
485
- const { workActivity, writeDevInfo, removeDevInfo } = await import("./work-CLrmY-vQ.mjs");
486
- const unsubscribe = workActivity.onChange((frames) => server.ws.send("sh:jam-activity", { frames }));
491
+ const { workActivity, writeDevInfo, removeDevInfo, boardsShowing, onBoardsChanged, nextActivitySeq } = await import("./work-CiUvBVa6.mjs").then((n) => n.o);
492
+ let sent = "";
493
+ const broadcast = (frames) => {
494
+ const state = {
495
+ frames: [...frames].sort(),
496
+ boards: boardsShowing(root, frames)
497
+ };
498
+ const key = JSON.stringify(state);
499
+ if (key === sent) return;
500
+ sent = key;
501
+ server.ws.send("sh:jam-activity", {
502
+ ...state,
503
+ seq: nextActivitySeq()
504
+ });
505
+ };
506
+ const unsubscribe = workActivity.onChange(broadcast);
507
+ const offBoards = onBoardsChanged((r) => {
508
+ if (r === root) broadcast(workActivity.active());
509
+ });
487
510
  const sweep = setInterval(() => workActivity.sweep(), 15e3);
488
511
  sweep.unref?.();
489
512
  writeDevInfo(root, port);
@@ -491,13 +514,36 @@ async function dev(root, portFlag) {
491
514
  const close = server.close.bind(server);
492
515
  server.close = (async () => {
493
516
  unsubscribe();
517
+ offBoards();
494
518
  clearInterval(sweep);
495
519
  removeDevInfo(root);
496
520
  return close();
497
521
  });
498
522
  }
523
+ {
524
+ const dir = join(root, "design", "comments");
525
+ const due = /* @__PURE__ */ new Map();
526
+ try {
527
+ mkdirSync(dir, { recursive: true });
528
+ const w = watch(dir, { persistent: false }, (_e, file) => {
529
+ const m = typeof file === "string" ? file.match(/^([a-z0-9][a-z0-9-]*)\.jsonl$/) : null;
530
+ if (!m) return;
531
+ clearTimeout(due.get(m[1]));
532
+ due.set(m[1], setTimeout(() => {
533
+ due.delete(m[1]);
534
+ server.ws.send("sh:jam-comment", { board: m[1] });
535
+ }, 120));
536
+ });
537
+ const close = server.close.bind(server);
538
+ server.close = (async () => {
539
+ w.close();
540
+ for (const t of due.values()) clearTimeout(t);
541
+ return close();
542
+ });
543
+ } catch {}
544
+ }
499
545
  if (config.jam) {
500
- const { startJam } = await import("./daemon-BmkwErpC.mjs");
546
+ const { startJam } = await import("./daemon-DZ367fiM.mjs");
501
547
  const jam = startJam(root, config.jam, (m) => console.log(m), (board) => server.ws.send("sh:jam-comment", { board }));
502
548
  if (jam) {
503
549
  const close = server.close.bind(server);
@@ -1,9 +1,10 @@
1
1
  import { r as NAME } from "./cli.mjs";
2
- import { E as addFolders, J as FOLDER_MODULES, X as KIND_FOLDERS } from "./board-status-CWGHIdo_.mjs";
2
+ import { D as KIND_FOLDERS, T as FOLDER_MODULES, n as addFolders } from "./boards-DbVJlbd5.mjs";
3
+ import { r as detectAgent } from "./agent-BsieQGTD.mjs";
3
4
  import { MANAGED_PREFIX, enumerateInstructionTemplates, hashBody, pkgDir } from "./managed-HwHVNI3h.mjs";
4
5
  import { t as writeManaged } from "./managed-write-Bo-oPc-i.mjs";
5
- import { o as writeManifest, r as scanFrames } from "./manifest-BqBcMJcd.mjs";
6
- import { a as readJson, i as detectHost, r as detectAgent, t as DEFAULTS } from "./config-DJxMRVD8.mjs";
6
+ import { l as writeManifest, o as scanFrames } from "./manifest-BkjJ5OQk.mjs";
7
+ import { i as readJson, r as detectHost, t as DEFAULTS } from "./config-g-J8NrPn.mjs";
7
8
  import { cpSync, existsSync, mkdirSync, readFileSync, readdirSync, rmSync, writeFileSync } from "node:fs";
8
9
  import { basename, dirname, join, relative } from "node:path";
9
10
  //#region src/cli/init.ts
@@ -234,10 +235,11 @@ function init(root, opts) {
234
235
  console.log(`\n commit design/ - only .local/ is ignored`);
235
236
  console.log(` uninstall = delete design/, remove the ${NAME} dependency${host.tsconfigSweepsDesign ? ", revert the \"design\" line in tsconfig exclude" : ""}`);
236
237
  if (!noApp(host) && !existsSync(join(design, "DESIGN.md"))) console.log(`\n note: design/DESIGN.md (the brand doc) does not exist yet - have your agent create it from the app's tokens (instructions/brand.md, Path A) to reach the idle state.`);
238
+ if (!existsSync(join(root, "context"))) console.log(`\n note: no context/ yet - feature and project boards read Backlog until there is one, and nothing records what shipped. To start it, tell your agent: "Set up our context." (design/instructions/context.md)`);
237
239
  if (!jamAgent) console.log(`\n note: Live Jam found no agent CLI on PATH (claude, codex, cursor, droid, opencode, grok, or pi) - install one and it arms itself on the next \`${NAME} dev\`.`);
238
240
  else if (created.includes("design/config.ts")) console.log(`\n Live Jam is on (${jamAgent}): tag @${NAME} in a canvas comment and your agent does the work, then replies in the thread.`);
239
241
  console.log(`\n next: npx ${NAME} dev (or: npx ${NAME} canvas - same thing; canvas on http://localhost:${DEFAULTS.port} by default)\n`);
240
- if (!noApp(host)) console.log(` then, to your agent: "Read design/AGENTS.md. This is our first session - follow design/instructions/welcome.md."\n`);
242
+ if (!noApp(host) && created.includes("design/config.ts")) console.log(` then, to your agent: "Read design/AGENTS.md. This is our first session - follow design/instructions/welcome.md."\n`);
241
243
  }
242
244
  /** The host's path aliases, re-rooted one level down for design/tsconfig.json.
243
245
  * "./src/*" becomes "../src/*" so `@/` imports resolve from inside design/. */
@@ -1,4 +1,3 @@
1
- import { t as __exportAll } from "./rolldown-runtime-D7D4PA-g.mjs";
2
1
  import { closeSync, existsSync, fsyncSync, mkdirSync, openSync, readFileSync, writeSync } from "node:fs";
3
2
  import { dirname, join } from "node:path";
4
3
  import { createHash } from "node:crypto";
@@ -59,10 +58,6 @@ function deviceId() {
59
58
  * design/.local/ and hand a clone a ledger full of pre-authorized ids. Lines stamped with
60
59
  * another machine match nothing here (device.ts).
61
60
  */
62
- var ledger_exports = /* @__PURE__ */ __exportAll({
63
- has: () => has,
64
- record: () => record
65
- });
66
61
  const ledgerFile = (root) => join(root, "design", ".local", "jam-ledger");
67
62
  const line = (board, id) => `${deviceId()}\t${board}\t${id}`;
68
63
  /** Was this (board, id) authorized on this device by the gated dev POST? */
@@ -89,4 +84,4 @@ function record(root, board, id) {
89
84
  }
90
85
  }
91
86
  //#endregion
92
- export { ledger_exports as n, deviceId as r, has as t };
87
+ export { has, record, deviceId as t };
@@ -0,0 +1,132 @@
1
+ import { r as NAME } from "./cli.mjs";
2
+ import { P as resolveType, g as folderMap, i as checkBoardsDir, l as readRegistry, m as flatten, p as buildTree, r as boardFields, s as listBoardFiles, v as isBoardName } from "./boards-DbVJlbd5.mjs";
3
+ import { o as scanFrames } from "./manifest-BkjJ5OQk.mjs";
4
+ import { i as readDevInfo } from "./work-CiUvBVa6.mjs";
5
+ import { join } from "node:path";
6
+ //#region src/cli/link.ts
7
+ /**
8
+ * `marver link <scene/frame | scene ...>` - the canvas link that lands ON the work: the board the
9
+ * frames sit on, opened in canvas mode with them selected and the camera fitted (never past 100%) -
10
+ * not the full-screen focus view. An agent knows frame ids and scene names; it does not know the
11
+ * shell's node keys or which port `marver dev` took, so it asks here and pastes what comes back.
12
+ * `work done` prints the same link for the frames it clears; `comments new` prints its thread's.
13
+ *
14
+ * The board: `--board` when given; else the first board in sidebar order that shows EVERY frame
15
+ * asked for (archive boards last - history is not where a change is reviewed); else `all-scenes`,
16
+ * which holds every frame.
17
+ */
18
+ function resolveLink(root, targets, board) {
19
+ if (!targets.length) throw new Error("name what to link: link <scene/frame | scene ...>");
20
+ const known = scanFrames(root).frames.map((f) => f.id);
21
+ const ids = new Set(known);
22
+ const frames = [], scenes = [], all = [], exact = [];
23
+ for (const raw of targets) {
24
+ const t = raw.replace(/^design\/scenes\//, "").replace(/\.(tsx|jsx|html)$/, "").replace(/\/+$/, "");
25
+ if (ids.has(t)) {
26
+ if (!frames.includes(t)) frames.push(t);
27
+ if (!all.includes(t)) all.push(t);
28
+ if (!exact.includes(t)) exact.push(t);
29
+ continue;
30
+ }
31
+ const members = known.filter((id) => id.startsWith(`${t}/`));
32
+ if (members.length) {
33
+ if (t.includes("/")) for (const m of members) {
34
+ if (!frames.includes(m)) frames.push(m);
35
+ if (!all.includes(m)) all.push(m);
36
+ }
37
+ else {
38
+ if (!scenes.includes(t)) scenes.push(t);
39
+ for (const m of members) if (!all.includes(m)) all.push(m);
40
+ }
41
+ continue;
42
+ }
43
+ throw new Error(`no frame or scene "${raw}" in design/scenes/ - a frame is <scene>/<name>, a scene is its folder`);
44
+ }
45
+ const dir = join(root, "design", "boards");
46
+ const files = checkBoardsDir(root, dir) ? [] : listBoardFiles(dir).boards;
47
+ const nodesOf = (name) => {
48
+ const json = files.find((b) => b.name === name)?.json;
49
+ return Array.isArray(json?.nodes) ? json.nodes.filter((n) => !!n && typeof n.frame === "string") : [];
50
+ };
51
+ const shows = (name) => {
52
+ const pins = new Set(nodesOf(name).map((n) => n.frame));
53
+ return all.every((f) => pins.has(f));
54
+ };
55
+ let pick = board;
56
+ let fellBack = false;
57
+ if (pick) {
58
+ if (!isBoardName(pick)) throw new Error(`"${pick}" is not a board name`);
59
+ if (pick !== "all-scenes" && !files.some((b) => b.name === pick)) throw new Error(`no board "${pick}" in design/boards/`);
60
+ if (pick !== "all-scenes" && !shows(pick)) {
61
+ const missing = all.filter((f) => !nodesOf(pick).some((n) => n.frame === f));
62
+ throw new Error(`board "${pick}" does not show ${missing.join(", ")} - pin ${missing.length === 1 ? "it" : "them"} there first, or leave --board out`);
63
+ }
64
+ } else {
65
+ const reg = readRegistry(dir);
66
+ const folders = reg.state === "ok" ? reg.folders : [];
67
+ const rows = files.filter((b) => b.name !== "all-scenes").map((b) => ({
68
+ name: b.name,
69
+ ...boardFields(b.json, isBoardName)
70
+ }));
71
+ const tree = buildTree(rows, folders);
72
+ const order = flatten(tree);
73
+ const fm = folderMap(tree);
74
+ const byName = new Map(folders.map((f) => [f.name, f]));
75
+ const typeOf = (n) => {
76
+ const folder = byName.get(fm.get(n) ?? "");
77
+ return resolveType(rows.find((r) => r.name === n)?.type, folder?.type, folder?.parent ? byName.get(folder.parent)?.type : void 0);
78
+ };
79
+ const isArchive = (n) => n === "archive" || typeOf(n) === "archive";
80
+ pick = [...order.filter((n) => !isArchive(n)), ...order.filter(isArchive)].find(shows);
81
+ if (!pick) {
82
+ pick = "all-scenes";
83
+ fellBack = true;
84
+ }
85
+ }
86
+ const q = [frames.length ? `f=${frames.join(",")}` : "", scenes.length ? `s=${scenes.join(",")}` : ""].filter(Boolean).join("&");
87
+ return {
88
+ board: pick,
89
+ frames,
90
+ exact,
91
+ scenes,
92
+ all,
93
+ hash: `#/b/${pick}?${q}`,
94
+ ...fellBack ? { fellBack } : {},
95
+ nodesOf
96
+ };
97
+ }
98
+ /** The dev server's origin when it is running in this repo and answers like `marver dev` - else null. */
99
+ async function devOrigin(root) {
100
+ const info = readDevInfo(root);
101
+ if (!info) return null;
102
+ try {
103
+ const res = await fetch(`http://localhost:${info.port}/__mv/api/work`, {
104
+ headers: { "x-mv-work": info.token },
105
+ signal: AbortSignal.timeout(1500)
106
+ });
107
+ const data = await res.json().catch(() => null);
108
+ return res.ok && Array.isArray(data?.frames) ? `http://localhost:${info.port}/` : null;
109
+ } catch {
110
+ return null;
111
+ }
112
+ }
113
+ const NOT_RUNNING = `\`${NAME} dev\` is not running in this repo - start it (\`npx ${NAME} dev\`), then run this again: the link carries its port`;
114
+ async function linkCommand(root, targets, opts) {
115
+ const r = resolveLink(root, targets, opts.board);
116
+ const origin = await devOrigin(root);
117
+ if (!origin) throw new Error(NOT_RUNNING);
118
+ if (r.fellBack) console.error(` (no curated board shows ${r.all.length === 1 ? "it" : "all of them"} - the link opens on all-scenes; pin ${r.all.length === 1 ? "it" : "them"} on a board for a tighter view)`);
119
+ console.log(`${origin}${r.hash}`);
120
+ }
121
+ /** The link line other commands print after their own output - never fails them. */
122
+ async function linkLine(root, targets) {
123
+ try {
124
+ const r = resolveLink(root, targets);
125
+ const origin = await devOrigin(root);
126
+ return origin ? `${origin}${r.hash}` : null;
127
+ } catch {
128
+ return null;
129
+ }
130
+ }
131
+ //#endregion
132
+ export { devOrigin, linkCommand, linkLine, resolveLink };
@@ -1,9 +1,34 @@
1
+ import { t as __exportAll } from "./rolldown-runtime-D7D4PA-g.mjs";
1
2
  import { i as PKG, n as CONTENT_WIDTH } from "./cli.mjs";
2
- import { D as boardFields, H as isBoardName, L as buildTree, N as readRegistry, O as checkBoardsDir, R as flatten, U as readDescription, W as readTitle, at as hash, j as listBoardFiles, k as checkRealDirs, t as annotateBoards, z as folderEntries } from "./board-status-CWGHIdo_.mjs";
3
+ import { I as hash, a as checkRealDirs, b as readTitle, h as folderEntries, i as checkBoardsDir, l as readRegistry, m as flatten, p as buildTree, r as boardFields, s as listBoardFiles, v as isBoardName, y as readDescription } from "./boards-DbVJlbd5.mjs";
4
+ import { t as annotateBoards } from "./board-status-D_lHZZ09.mjs";
3
5
  import { existsSync, lstatSync, mkdirSync, readFileSync, readdirSync, renameSync, rmSync, writeFileSync } from "node:fs";
4
6
  import { join, relative, sep } from "node:path";
5
7
  import { randomBytes } from "node:crypto";
6
8
  //#region src/server/manifest.ts
9
+ var manifest_exports = /* @__PURE__ */ __exportAll({
10
+ NOTE_MAX: () => NOTE_MAX,
11
+ affectedFrameIds: () => affectedFrameIds,
12
+ codeOnly: () => codeOnly,
13
+ contentScan: () => contentScan,
14
+ contentWidthOf: () => contentWidthOf,
15
+ docTags: () => docTags,
16
+ extractMeta: () => extractMeta,
17
+ frontMatter: () => frontMatter,
18
+ isNoteFile: () => isNoteFile,
19
+ layoutDocSource: () => layoutDocSource,
20
+ noteFileFor: () => noteFileFor,
21
+ readNote: () => readNote,
22
+ rendersDoc: () => rendersDoc,
23
+ scanFrames: () => scanFrames,
24
+ sceneBrief: () => sceneBrief,
25
+ sceneNote: () => sceneNote,
26
+ setSceneTitle: () => setSceneTitle,
27
+ statusBoards: () => statusBoards,
28
+ tagPattern: () => tagPattern,
29
+ toFrameId: () => toFrameId,
30
+ writeManifest: () => writeManifest
31
+ });
7
32
  const FRAME_EXT = /\.(tsx|jsx|html)$/;
8
33
  const RESERVED_SCENES = /* @__PURE__ */ new Set(["components", "screens"]);
9
34
  /** Sticky notes (spec 18): the longest note the manifest carries - a note is an aside, not a spec. */
@@ -64,8 +89,46 @@ function extractMeta(src) {
64
89
  * <Chart> is still a screen (device height, no document measuring), never a spec. Returns
65
90
  * the inferred intent + natural width, or null for UI frames. */
66
91
  const CONTENT_IMPORT = new RegExp(`from\\s+['"]${PKG}/content['"]`);
67
- const WIDE_DOC = /<Doc\b[^>]*\blayout\s*=\s*["']wide["']/;
68
- const contentWidthOf = (src) => WIDE_DOC.test(src) ? CONTENT_WIDTH.wide : CONTENT_WIDTH.document;
92
+ /** The JSX names a Doc renders under in this source: `Doc`, an alias (`import { Doc as Page }`),
93
+ * a namespace's member (`import * as C` -> `C.Doc`). Read from the code only (codeOnly). */
94
+ function docTags(code) {
95
+ const tags = ["Doc"];
96
+ for (const m of code.matchAll(/\bDoc\s+as\s+([A-Za-z_$][\w$]*)/g)) tags.push(m[1]);
97
+ for (const m of code.matchAll(/import\s+\*\s+as\s+([A-Za-z_$][\w$]*)\s+from/g)) tags.push(`${m[1]}.Doc`);
98
+ return tags;
99
+ }
100
+ const tagPattern = (tag) => tag.replace(/[.$]/g, "\\$&");
101
+ /** Does this source render a `<Doc>` - the one primitive that measures (content/index.tsx)? Lexical
102
+ * on the code (comments and strings blanked), through an aliased or namespace import too. */
103
+ function rendersDoc(src) {
104
+ const code = codeOnly(src);
105
+ return docTags(code).some((t) => new RegExp(`<${tagPattern(t)}[\\s>/]`).test(code));
106
+ }
107
+ /** The source of the nearest `_layout.tsx|jsx` around a frame that renders a Doc - the frame host
108
+ * wraps a frame in every `_layout` from its directory up to `scenes/` or `components/` - or null.
109
+ * `file` is the frame's path from the root; `memo` caches per directory across one scan. */
110
+ function layoutDocSource(root, file, memo) {
111
+ const parts = file.split("/").slice(0, -1);
112
+ if (parts.includes("..")) return null;
113
+ for (let i = parts.length; i >= 2; i--) {
114
+ const dir = parts.slice(0, i).join("/");
115
+ let found = memo.get(dir);
116
+ if (found === void 0) {
117
+ found = null;
118
+ for (const ext of ["tsx", "jsx"]) try {
119
+ const src = readFileSync(join(root, dir, `_layout.${ext}`), "utf8");
120
+ if (rendersDoc(src)) {
121
+ found = src;
122
+ break;
123
+ }
124
+ } catch {}
125
+ memo.set(dir, found);
126
+ }
127
+ if (found !== null) return found;
128
+ }
129
+ return null;
130
+ }
131
+ const contentWidthOf = (src) => docTags(codeOnly(src)).some((t) => new RegExp(`<${tagPattern(t)}\\b[^>]*\\blayout\\s*=\\s*["']wide["']`).test(src)) ? CONTENT_WIDTH.wide : CONTENT_WIDTH.document;
69
132
  /** The source with comments, template literals and CODE-shaped strings blanked (a JSX
70
133
  * expression string `{'<Diagram>'}`, an attribute value), so a tag name quoted in an example
71
134
  * or a comment never counts as a rendered element. Prose is left alone: JSX text has
@@ -296,9 +359,13 @@ function scanBoards(root) {
296
359
  ...boards.length ? { boards } : {}
297
360
  };
298
361
  }
362
+ /** The boards that wear a status (feature and project, by their resolved type) - for the dev
363
+ * server's word at boot when there is no context/ to read it from. */
364
+ const statusBoards = (root) => (scanBoards(root).boards ?? []).filter((b) => b.type === "feature" || b.type === "project").map((b) => b.name);
299
365
  function scanFrames(root, project) {
300
366
  const design = join(root, "design");
301
367
  const frames = [];
368
+ const layoutDocs = /* @__PURE__ */ new Map();
302
369
  for (const base of ["scenes", "components"]) for (const abs of walk(join(design, base))) {
303
370
  const name = abs.split(sep).pop();
304
371
  if (name.startsWith("_") || !FRAME_EXT.test(name)) continue;
@@ -331,7 +398,8 @@ function scanFrames(root, project) {
331
398
  const content = contentScan(src);
332
399
  if (content || meta.intent) {
333
400
  entry.intent = meta.intent ?? content.intent;
334
- entry.contentWidth = content?.width ?? contentWidthOf(src);
401
+ const layout = rendersDoc(src) ? null : layoutDocSource(root, entry.file, layoutDocs);
402
+ entry.contentWidth = layout !== null ? contentWidthOf(layout) : content?.width ?? contentWidthOf(src);
335
403
  }
336
404
  }
337
405
  frames.push(entry);
@@ -452,4 +520,4 @@ function writeManifest(root, manifest) {
452
520
  return true;
453
521
  }
454
522
  //#endregion
455
- export { toFrameId as a, setSceneTitle as i, isNoteFile as n, writeManifest as o, scanFrames as r, affectedFrameIds as t };
523
+ export { rendersDoc as a, toFrameId as c, manifest_exports as i, writeManifest as l, isNoteFile as n, scanFrames as o, layoutDocSource as r, setSceneTitle as s, affectedFrameIds as t };