@marver-design/marver 0.16.0 → 0.16.1

package/dist/{plugin-BXyezwfN.mjs → plugin-BeBGu3gH.mjs}

@@ -1,8 +1,8 @@
 import { t as __exportAll } from "./rolldown-runtime-D7D4PA-g.mjs";
 import { i as ROUTE, n as NAME, r as PKG } from "./cli.mjs";
-import { a as nodeExists, c as FOLDERS_FILE, f as readDescription, i as listBoardFiles, m as hash, n as checkBoardsDir, o as readRegistry, p as validateWire, r as isRegularFile, s as BOARD_NAME, t as boardFields } from "./boards-BdG1TJwU.mjs";
+import { a as listBoardFiles, c as BOARD_NAME, g as hash, h as validateWire, i as isRegularFile, l as FOLDERS_FILE, m as readTitle, n as checkBoardsDir, o as nodeExists, p as readDescription, s as readRegistry, t as boardFields } from "./boards-BmxcT3Lc.mjs";
 import { n as localProfile, t as isConnected } from "./profile-BjAPAJSb.mjs";
-import { i as writeManifest, n as scanFrames, o as loadConfig, t as affectedFrameIds } from "./manifest-CpbsqQ_v.mjs";
+import { a as writeManifest, n as scanFrames, r as setSceneTitle, s as loadConfig, t as affectedFrameIds } from "./manifest-CaslQIAO.mjs";
 import { copyFileSync, existsSync, linkSync, mkdirSync, readFileSync, readdirSync, realpathSync, renameSync, rmSync, watch, writeFileSync } from "node:fs";
 import { basename, dirname, join, resolve, sep } from "node:path";
 import { fileURLToPath } from "node:url";
@@ -155,9 +155,13 @@ function apiMiddleware(root, opts = {}) {
 					return json(res, 400, { error: "malformed JSON" });
 				}
 				if (!parsed || typeof parsed !== "object") return json(res, 400, { error: "expected an object" });
-				const { from, to } = parsed;
+				const { from, to: toRaw, title: titleRaw, baseHash } = parsed;
+				const to = toRaw === void 0 ? from : toRaw;
 				if (!validName(from) || !validName(to)) return json(res, 400, { error: "invalid board name" });
-				if (to === "all-scenes" || from === "all-scenes" || to === from) return json(res, 400, { error: "invalid rename" });
+				if (titleRaw !== void 0 && (typeof titleRaw !== "string" || Array.from(titleRaw).length > 120)) return json(res, 400, { error: "invalid title" });
+				if (baseHash !== void 0 && typeof baseHash !== "string") return json(res, 400, { error: "invalid baseHash" });
+				if (to === "all-scenes" || from === "all-scenes") return json(res, 400, { error: "invalid rename" });
+				if (to === from && titleRaw === void 0) return json(res, 400, { error: "invalid rename" });
 				{
 					const de = dirError();
 					if (de) return json(res, 400, { error: de });
@@ -166,21 +170,74 @@ function apiMiddleware(root, opts = {}) {
 				if (!fromPath || !toPath) return json(res, 400, { error: "invalid board name" });
 				if (!existsSync(fromPath)) return json(res, 404, { error: `board "${from}" does not exist` });
 				if (!notSymlink(fromPath)) return json(res, 400, { error: "refusing to rename a symlinked board file" });
-				if (isConnected(root)) return json(res, 409, { error: "disconnect before renaming boards - comment sync is board-keyed" });
-				if (existsSync(join(root, "design", "comments", `${from}.jsonl`))) return json(res, 409, { error: "rename a board before commenting on it - this board has threads" });
-				if (nodeExists$1(toPath)) return json(res, 409, { error: `a board named "${to}" already exists` });
-				try {
-					linkSync(fromPath, toPath);
-				} catch (err) {
-					const code = err.code;
-					if (code === "EEXIST") return json(res, 409, { error: `a board named "${to}" already exists` });
-					if (code !== "EPERM" && code !== "ENOSYS" && code !== "ENOTSUP" && code !== "EOPNOTSUPP") throw err;
+				const current = readFileSync(fromPath, "utf8");
+				if (baseHash !== void 0 && baseHash !== hash(current)) return json(res, 409, {
+					error: "board changed on disk",
+					sha256: hash(current)
+				});
+				let obj = null;
+				if (titleRaw !== void 0) {
+					let parsedBoard;
+					try {
+						parsedBoard = JSON.parse(current);
+					} catch {
+						return json(res, 422, { error: `board "${from}" is not valid JSON - fix the file` });
+					}
+					if (!parsedBoard || typeof parsedBoard !== "object" || Array.isArray(parsedBoard)) return json(res, 422, { error: `board "${from}" is not a JSON object - fix the file` });
+					obj = parsedBoard;
+				}
+				let next;
+				if (obj) {
+					const title = readTitle(titleRaw);
+					if (title) obj.title = title;
+					else delete obj.title;
+					next = JSON.stringify(obj, null, 2) + "\n";
+				}
+				if (to !== from) {
+					if (isConnected(root)) return json(res, 409, { error: "disconnect before renaming boards - comment sync is board-keyed" });
+					if (existsSync(join(root, "design", "comments", `${from}.jsonl`))) return json(res, 409, { error: "rename a board before commenting on it - this board has threads" });
 					if (nodeExists$1(toPath)) return json(res, 409, { error: `a board named "${to}" already exists` });
-					renameSync(fromPath, toPath);
-					return json(res, 200, { name: to });
+					try {
+						if (next !== void 0) writeFileSync(toPath, next, { flag: "wx" });
+						else linkSync(fromPath, toPath);
+					} catch (err) {
+						const code = err.code;
+						if (code === "EEXIST") return json(res, 409, { error: `a board named "${to}" already exists` });
+						if (next !== void 0 || code !== "EPERM" && code !== "ENOSYS" && code !== "ENOTSUP" && code !== "EOPNOTSUPP") throw err;
+						if (nodeExists$1(toPath)) return json(res, 409, { error: `a board named "${to}" already exists` });
+						renameSync(fromPath, toPath);
+						return json(res, 200, { name: to });
+					}
+					rmSync(fromPath);
+					return json(res, 200, {
+						name: to,
+						...next !== void 0 ? { sha256: hash(next) } : {}
+					});
 				}
-				rmSync(fromPath);
-				return json(res, 200, { name: to });
+				atomicWrite(toPath, next);
+				return json(res, 200, {
+					name: to,
+					sha256: hash(next)
+				});
+			}
+			if (path === "scenes/rename" && req.method === "POST") {
+				if (!ownerGated(req)) return json(res, 403, { error: "forbidden" });
+				const raw = await readBody(req);
+				if (raw == null) return json(res, 400, { error: "body too large or unreadable" });
+				let parsed;
+				try {
+					parsed = JSON.parse(raw);
+				} catch {
+					return json(res, 400, { error: "malformed JSON" });
+				}
+				if (!parsed || typeof parsed !== "object") return json(res, 400, { error: "expected an object" });
+				const { scene, title } = parsed;
+				if (typeof scene !== "string" || !scene || scene.length > 128 || /[\\/]/.test(scene) || scene === "." || scene === "..") return json(res, 400, { error: "invalid scene name" });
+				if (typeof title !== "string" || Array.from(title).length > 120) return json(res, 400, { error: "invalid title" });
+				if (!scanFrames(root).scenes.some((sc) => sc.name === scene)) return json(res, 400, { error: `scene "${scene}" does not exist (no frames under design/scenes/${scene}/)` });
+				const e = setSceneTitle(root, scene, readTitle(title) ?? "");
+				if (e) return json(res, 400, { error: e });
+				return json(res, 200, { ok: true });
 			}
 			if (path === "boards/reorder" && req.method === "POST") {
 				if (!ownerGated(req)) return json(res, 403, { error: "forbidden" });
@@ -249,10 +306,11 @@ function apiMiddleware(root, opts = {}) {
 						if (e) return json(res, 422, { error: e });
 						continue;
 					}
-					const description = readDescription(it.description);
+					const title = readTitle(it.title), description = readDescription(it.description);
 					folders.push({
 						name: it.folder,
 						order: i,
+						...title ? { title } : {},
 						...description ? { description } : {}
 					});
 					for (const [j, kid] of it.boards.entries()) {
@@ -339,6 +397,7 @@ function apiMiddleware(root, opts = {}) {
 						const disk = JSON.parse(current);
 						if (incoming.order === void 0 && typeof disk.order === "number" && Number.isFinite(disk.order)) incoming.order = disk.order;
 						if (incoming.folder === void 0 && validName(disk.folder)) incoming.folder = disk.folder;
+						if (incoming.title === void 0 && readTitle(disk.title)) incoming.title = disk.title;
 						if (incoming.description === void 0 && readDescription(disk.description)) incoming.description = disk.description;
 					} catch {}
 					const next2 = JSON.stringify(body.board, null, 2) + "\n";
@@ -363,7 +422,7 @@ function apiMiddleware(root, opts = {}) {
 				};
 				const asPng = url.searchParams.get("format") === "png";
 				const origin = opts.origin?.() ?? `http://${req.headers.host ?? "localhost"}`;
-				const { shootFrame } = await import("./shot-CwmHO5T4.mjs");
+				const { shootFrame } = await import("./shot-z-d-zMzf.mjs");
 				const r = await shootFrame({
 					root,
 					viewports: opts.viewports ?? {},
@@ -397,8 +456,8 @@ function apiMiddleware(root, opts = {}) {
 			if (path === "poster" && req.method === "GET") {
 				if (!ownerGated(req)) return json(res, 403, { error: "forbidden" });
 				const src = url.searchParams.get("src") ?? "";
-				const { ensurePoster, isLocalClip } = await import("./poster-DOY7pax8.mjs");
-				const { isLocalAssetRef } = await import("./build-Ct0iMoSi.mjs");
+				const { ensurePoster, isLocalClip } = await import("./poster-CoyobbGW.mjs");
+				const { isLocalAssetRef } = await import("./build-B4yPgFNF.mjs");
 				if (!isLocalAssetRef(src) || !isLocalClip(src)) return json(res, 400, { error: "src must be a clip under design/assets/" });
 				const r = await ensurePoster(join(root, "design", "assets"), src);
 				if (!r.ok) return json(res, r.error.includes("does not exist") ? 404 : 503, { error: r.error });
@@ -827,12 +886,15 @@ function marverPlugin(ctx) {
 			server.middlewares.use(routesMiddleware(server, clientDir));
 			devServer = server;
 			let framesKey = JSON.stringify(manifest.frames);
+			let scenesKey = JSON.stringify(manifest.scenes);
 			const regen = debounce(() => {
 				manifest = scanFrames(root, projectInfo());
 				const changed = writeManifest(root, manifest);
-				const key = JSON.stringify(manifest.frames);
+				const key = JSON.stringify(manifest.frames), sKey = JSON.stringify(manifest.scenes);
 				if (changed && key !== framesKey) server.ws.send("sh:manifest", manifest);
+				else if (changed && sKey !== scenesKey) server.ws.send("sh:scenes", { scenes: manifest.scenes });
 				framesKey = key;
+				scenesKey = sKey;
 			}, 150);
 			const watched = [join(root, "design", "scenes"), join(root, "design", "components")];
 			const inScope = (file) => watched.some((w) => file.startsWith(w));
@@ -944,7 +1006,7 @@ function marverPlugin(ctx) {
 								});
 								return;
 							}
-							const { shootFrame } = await import("./shot-CwmHO5T4.mjs");
+							const { shootFrame } = await import("./shot-z-d-zMzf.mjs");
 							write(await shootFrame({
 								root,
 								viewports: config.viewports,

package/dist/{poster-DOY7pax8.mjs → poster-CoyobbGW.mjs}

@@ -1,4 +1,4 @@
-import { capture, findChrome } from "./shot-CwmHO5T4.mjs";
+import { capture, findChrome } from "./shot-z-d-zMzf.mjs";
 import { constants, copyFileSync, existsSync, mkdtempSync, realpathSync, rmSync, writeFileSync } from "node:fs";
 import { basename, dirname, join, sep } from "node:path";
 import { pathToFileURL } from "node:url";

package/dist/{shot-CwmHO5T4.mjs → shot-z-d-zMzf.mjs}

@@ -95,8 +95,8 @@ async function shootFrame(opts) {
 	};
 	const plan = planShot(frame, viewports, size);
 	if (frame.kind !== "html") try {
-		const { scanAssetRefs } = await import("./build-Ct0iMoSi.mjs");
-		const { ensurePoster } = await import("./poster-DOY7pax8.mjs");
+		const { scanAssetRefs } = await import("./build-B4yPgFNF.mjs");
+		const { ensurePoster } = await import("./poster-CoyobbGW.mjs");
 		const refs = scanAssetRefs(readFileSync(join(root, frame.file), "utf8"), frame.file);
 		for (const r of refs) if (r.endsWith(".poster.png")) await ensurePoster(join(root, "design", "assets"), r.slice(0, -11));
 	} catch {}

package/docs/publish.md

@@ -33,8 +33,8 @@ opens the same view on the published site, as long as its board and frame shippe
 directory in full (the `--boards` filter covers frames, not public assets). A flow you
 publish must have all its `data-goto` targets on a published board. Sidebar folders ship
 only around published boards (a folder with nothing published never reaches the bundle),
-and `description`s ship only for published things - the project's, the published boards',
-their folders', scenes' and frames'.
+and `title`s and `description`s ship only for published things - the project's, the
+published boards', their folders', scenes' and frames'.
 
 ## Who can open your canvas
 

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@marver-design/marver",
-  "version": "0.16.0",
+  "version": "0.16.1",
   "description": "The agent-native design canvas. A design/ folder, one command, a canvas of live frames built from your repo's real components - comment @marver and your own coding agent does the work. The tool ships no AI.",
   "type": "module",
   "private": false,

package/src/client/shell/App.tsx

@@ -1,5 +1,5 @@
 import { Component, useEffect, useRef, useState, type MouseEvent as ReactMouseEvent, type ReactNode } from 'react'
-import { useStore, CONFIG, LOCKED_SHELL, PUBLISHED, SOURCE_REVEALED, boardLabel, boardFrames, cap, humanize, fetchBoardNames, hydrateBoardPolicy, landingMode, playsAsSlides, type FrameEntry } from './store.ts'
+import { useStore, CONFIG, LOCKED_SHELL, PUBLISHED, SOURCE_REVEALED, boardLabel, boardFrames, cap, humanize, fetchBoardNames, hydrateBoardPolicy, landingMode, playsAsSlides, sceneLabel, type FrameEntry } from './store.ts'
 import { BoardList } from './BoardList.tsx'
 import { ContextMenu, copyToClipboard, framePath, useContextMenu, type MenuItem } from './ContextMenu.tsx'
 import { Tip } from './Tip.tsx'
@@ -8,7 +8,8 @@ import { animateLayout, Canvas, canvasCtl } from './canvas/Canvas.tsx'
 import { frameByWindow } from './canvas/frame-registry.ts'
 import { enterFocus, enterPlay, enterSlides, playCtl, PlayOverlay } from './Play.tsx'
 import { bootHash, parseHash, writeHash } from './hash.ts'
-import { CaretIcon, CheckIcon, ColumnsIcon, FrameRectIcon, ImagesSquareIcon, IntentGlyph, MoonIcon, PanelFilledIcon, PanelHollowIcon, ParallelogramDuoIcon, ParallelogramFillIcon, PlayIcon, SignpostIcon, SlideFrameIcon, SunIcon, VariantsIcon, XIcon, deviceIcon } from './icons.tsx'
+import { CaretIcon, CheckIcon, ColumnsIcon, FrameRectIcon, ImagesSquareIcon, IntentGlyph, MoonIcon, PanelFilledIcon, PanelHollowIcon, ParallelogramDuoIcon, ParallelogramFillIcon, PencilSimpleIcon, PlayIcon, SignpostIcon, SlideFrameIcon, SunIcon, VariantsIcon, XIcon, deviceIcon } from './icons.tsx'
+import { humanize as slugLabel, readTitle } from '../../shared/board-tree.ts'
 import { CommentsController, revealThread } from './Comments.tsx'
 import { poweredByUrl } from '../../shared/utm.ts'
 import { avatarFallback, useComments } from './comments-store.ts'
@@ -19,17 +20,31 @@ const commentsStore = () => useComments.getState()
 let booted = false                             // survives Fast Refresh; see the boot effect
 
 /** One collapsible scene group in the sidebar. `held` marks a scene that contains a
- *  selected frame - a quiet secondary wash so ancestry survives collapsing the group. */
-function SceneGroup({ name, count, held, onPick, onContextMenu, children }: { name: string; count: number; held: boolean; onPick?: () => void; onContextMenu?: (e: ReactMouseEvent) => void; children: ReactNode }) {
+ *  selected frame - a quiet secondary wash so ancestry survives collapsing the group.
+ *  `renaming` swaps the label for an input: the scene's TITLE (its brief's front matter) -
+ *  the directory never moves from here. */
+function SceneGroup({ name, label, count, held, renaming, onRename, onPick, onContextMenu, children }: { name: string; label: string; count: number; held: boolean; renaming?: boolean; onRename?: (title: string | null) => void; onPick?: () => void; onContextMenu?: (e: ReactMouseEvent) => void; children: ReactNode }) {
   const [open, setOpen] = useState(true)
+  const done = useRef(false)   // Enter then blur: one commit
+  if (renaming) { done.current = false }
+  const finish = (v: string | null) => { if (done.current) return; done.current = true; onRename?.(v) }
   return (
     <div>
-      <button className={`it${held ? ' held' : ''}`} onClick={() => setOpen(!open)} onContextMenu={onContextMenu}>
-        <CaretIcon size={11} className="tw" style={{ transform: open ? undefined : 'rotate(-90deg)' }} />
-        {/* the NAME selects every frame in the scene; the caret/row still collapses */}
-        <span onClick={(e) => { if (!onPick) return; e.stopPropagation(); onPick() }}>{humanize(name) || '(root)'}</span>
-        <small>{count}</small>
-      </button>
+      {renaming ? (
+        <div className="it editing">
+          <CaretIcon size={11} className="tw" style={{ transform: open ? undefined : 'rotate(-90deg)' }} />
+          <input autoFocus defaultValue={label} spellCheck={false} onFocus={(e) => e.currentTarget.select()}
+            onKeyDown={(e) => { if (e.key === 'Enter') { e.preventDefault(); finish(e.currentTarget.value) } else if (e.key === 'Escape') { e.preventDefault(); finish(null) } }}
+            onBlur={(e) => finish(e.currentTarget.value)} />
+        </div>
+      ) : (
+        <button className={`it${held ? ' held' : ''}`} onClick={() => setOpen(!open)} onContextMenu={onContextMenu}>
+          <CaretIcon size={11} className="tw" style={{ transform: open ? undefined : 'rotate(-90deg)' }} />
+          {/* the NAME selects every frame in the scene; the caret/row still collapses */}
+          <span onClick={(e) => { if (!onPick) return; e.stopPropagation(); onPick() }}>{label || '(root)'}</span>
+          <small>{count}</small>
+        </button>
+      )}
       {open && children}
     </div>
   )
@@ -325,6 +340,7 @@ export function App() {
   const { boot, applyManifest, togglePanel, select, setInteract, runTidy, toast, spawn } = useStore.getState()
   const [pillOpen, setPillOpen] = useState(true)
   const cm = useContextMenu()   // shared sidebar right-click menu (boards + scenes)
+  const [sceneNaming, setSceneNaming] = useState<string | null>(null)   // the scene whose title is being edited inline
 
   // boot honors the deep link: board before load, play mode after it.
   // Selection + camera intent are restored by the Canvas boot effect. The module-level
@@ -431,9 +447,10 @@ export function App() {
     return () => { window.removeEventListener('popstate', onPop); window.removeEventListener('hashchange', onPop) }
   }, [])
 
-  // page title follows the open board
+  // page title follows the open board (and its title, when one is set)
   const board = useStore((s) => s.board)
-  useEffect(() => { document.title = board ? `${boardLabel(board)} - Marver` : 'Marver' }, [board])
+  const titles = useStore((s) => s.boardTitles)
+  useEffect(() => { document.title = board ? `${boardLabel(board)} - Marver` : 'Marver' }, [board, titles])
 
   // favicon follows the mode: blue pack in design mode, purple pack in interact.
   // The links are rebuilt (not toggled) so the set stays deterministic; the .ico is
@@ -484,6 +501,8 @@ export function App() {
   useEffect(() => {
     if (!import.meta.hot) return
     import.meta.hot.on('sh:manifest', (m: any) => applyManifest(m))
+    // a brief's title or description changed with the frames intact: relabel, never re-key
+    import.meta.hot.on('sh:scenes', (m: any) => useStore.getState().setScenes(m?.scenes))
     // Live Jam presence: the daemon broadcasts the set of frames Marver is editing.
     // Camera-safe by construction - this only toggles a glow class, never moves the view.
     import.meta.hot.on('sh:jam-activity', (m: any) => useStore.getState().setWorking(Array.isArray(m?.frames) ? m.frames.filter((x: unknown) => typeof x === 'string') : []))
@@ -779,15 +798,24 @@ export function App() {
             <BoardList onMenu={cm.open} />
             <div className="hd" style={{ marginTop: 10 }}>Scenes</div>
             {scenes.map((sc) => (
-              <SceneGroup key={sc.name} name={sc.name} count={sc.frames}
+              <SceneGroup key={sc.name} name={sc.name} label={sceneLabel(sc.name)} count={sc.frames}
                 held={frames.some((f) => f.scene === sc.name && selFrames.has(f.id))}
+                renaming={sceneNaming === sc.name}
+                onRename={(raw) => {
+                  setSceneNaming(null)
+                  const title = raw === null ? undefined : readTitle(raw)
+                  if (!title || title === sceneLabel(sc.name)) return                    // Escape, empty, or unchanged = never mind
+                  if (scenes.some((o) => o.name !== sc.name && sceneLabel(o.name) === title)) { toast(`a scene called "${title}" already exists`); return }
+                  // typing what the directory reads as anyway clears the title - the brief stays clean
+                  useStore.getState().renameScene(sc.name, title === slugLabel(sc.name) ? '' : title).then((r) => { if (!r.ok) toast(r.error ?? 'rename failed') })
+                }}
                 onContextMenu={(e) => cm.open(e, [{
                   label: 'Copy path',
                   icon: <SignpostIcon size={15} />,
                   onClick: () => copyToClipboard(sc.name
                     ? `board: ${useStore.getState().board} · scene: ${sc.name}  (design/scenes/${sc.name}/)`
                     : `board: ${useStore.getState().board} · scene: (root)`, 'path copied'),
-                }])}
+                }, ...(!PUBLISHED && sc.name ? [{ label: 'Rename', icon: <PencilSimpleIcon size={15} />, onClick: () => setSceneNaming(sc.name) }] : [])])}
                 onPick={() => {
                   const keys = nodes.filter((n) => frames.some((f) => f.scene === sc.name && f.id === n.frame) && !n.missing).map((n) => n.key)
                   if (!keys.length) return