@marver-design/marver 0.26.0 → 0.26.1

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 (44) hide show
  1. package/CHANGELOG.md +54 -0
  2. package/README.md +2 -2
  3. package/dist/{anchor-check-Dg5xpNnU.mjs → anchor-check-l-ny3UzH.mjs} +1 -1
  4. package/dist/{audio-CmSRYFEs.mjs → audio-Dw1lfMdb.mjs} +14 -0
  5. package/dist/{bake-DtVlm0_F.mjs → bake-C-awKgLA.mjs} +1 -1
  6. package/dist/{build-C_gUgcdC.mjs → build-BDRiO_mP.mjs} +3 -3
  7. package/dist/{capture-CrqvU_jh.mjs → capture-vadKjuCo.mjs} +2 -1
  8. package/dist/cli.mjs +6 -6
  9. package/dist/{daemon-DZo6o3rU.mjs → daemon-DL6Fwq6D.mjs} +394 -270
  10. package/dist/{dev-_Nlsc6v9.mjs → dev-Bw_qYWWq.mjs} +24 -11
  11. package/dist/{marks-NQi0wZJ4.mjs → marks-DyWMv_Z1.mjs} +1 -1
  12. package/dist/perf-C75MZ73h.mjs +167 -0
  13. package/dist/perf-jam-BU3TVrZu.mjs +239 -0
  14. package/dist/{plugin-CTD0rydA.mjs → plugin-DkGmZs_r.mjs} +42 -22
  15. package/dist/{poster-ChjXGTS5.mjs → poster-BdtSKMDm.mjs} +2 -1
  16. package/dist/{publish-bakes-CEP_2NRc.mjs → publish-bakes-9RzRToXV.mjs} +2 -2
  17. package/dist/{queue-BuiCKSX1.mjs → queue-29ok5_eZ.mjs} +2 -2
  18. package/dist/{session-qZWKt_VA.mjs → session-BAaJsK5c.mjs} +1 -1
  19. package/dist/{shot-DqcxJibP.mjs → shot-DQeR_Pfn.mjs} +337 -19
  20. package/dist/shot-XQV7HC9A.mjs +139 -0
  21. package/dist/speech-worker.mjs +40 -5
  22. package/docs/jam-session.md +24 -7
  23. package/docs/live-jam.md +8 -0
  24. package/package.json +1 -1
  25. package/src/client/frame-host/inspect.js +8 -3
  26. package/src/client/frame-host/keys.js +6 -2
  27. package/src/client/shell/App.tsx +8 -4
  28. package/src/client/shell/JamSurface.tsx +9 -3
  29. package/src/client/shell/Play.tsx +11 -7
  30. package/src/client/shell/Toolbar.tsx +5 -4
  31. package/src/client/shell/canvas/FrameNode.tsx +3 -2
  32. package/src/client/shell/icons.tsx +2 -0
  33. package/src/client/shell/jam-capture.ts +77 -11
  34. package/src/client/shell/jam-keys.ts +47 -18
  35. package/src/client/shell/jam-lane.tsx +46 -5
  36. package/src/client/shell/jam-panel.tsx +63 -13
  37. package/src/client/shell/jam-state.ts +48 -6
  38. package/src/client/shell/jam-surface-parts.tsx +10 -6
  39. package/src/client/shell/store.ts +14 -5
  40. package/src/client/shell/styles.css +28 -8
  41. package/src/client/stage/main.tsx +2 -0
  42. package/templates/instructions/jam.md +5 -3
  43. package/dist/perf-D6VmmJ2q.mjs +0 -68
  44. package/dist/shot-CNbHoZ6H.mjs +0 -86
package/CHANGELOG.md CHANGED
@@ -2,6 +2,60 @@
2
2
 
3
3
  Notable changes to `@marver-design/marver`. Format follows [Keep a Changelog](https://keepachangelog.com); versions follow semver.
4
4
 
5
+ ## 0.26.1 - 2026-10-20
6
+
7
+ ### Fixed
8
+
9
+ - **Pictures are what the frame shows** ([#14](https://github.com/TNEP4/marver/issues/14),
10
+ [#24](https://github.com/TNEP4/marver/issues/24)). About one picture in thirty at 2x - and a very tall frame almost
11
+ every time - came back as the frame's top-left corner repeated across the image, with nothing to say it was wrong.
12
+ Headless Chrome copied its view before resizing it for the picture and tiled the old copy. Each picture now gets a
13
+ window of its own, and a fixed-size frame or a slide has its window sized to the picture first, so there is nothing
14
+ left to resize: in 900 pictures, none came back tiled (31 did before). Every picture - a tall content frame's too - is
15
+ also checked for that tiling; one that still shows it is taken again (a tall one at 1x if need be), and if it never
16
+ comes out right the shot fails instead of shipping a wrong picture. This covers `marver shot`, your agent's
17
+ pictures, copy as image, video posters and Jam's before and after pictures.
18
+ - **Content frames keep their diagrams** ([#7](https://github.com/TNEP4/marver/issues/7)). A state, sequence, gantt or
19
+ pie diagram - or a first `Md` - could fail with "Failed to fetch dynamically imported module" until `marver dev`
20
+ restarted. Another Vite server on the same project (your app's own, for one) was replacing the files the canvas had
21
+ prepared. The canvas now keeps its own folder for them, `node_modules/.vite-marver`. The first chart frame also loads
22
+ much faster: its chart library is prepared up front (about 40 requests instead of 600).
23
+ - **A capture outlives its page.** Closing or reloading the tab while a capture was recording or finishing used to
24
+ lose it. Now it is kept as it stood - with your notes, and a line saying the page closed before it finished - and
25
+ comes back as a draft to read, resume or drop. It never goes to your agent on its own, even with
26
+ `jam: { capture: "at-once" }`.
27
+ - **`marver shot` works inside a sandbox.** An agent whose sandbox blocks the network (Codex) could not reach the
28
+ canvas and said it could not look at its work. The command now takes the same picture through the canvas's file
29
+ inbox when it cannot connect, with the same output.
30
+
31
+ ### Added
32
+
33
+ - **`npx marver perf --jam`** shows how long each step of Jam takes on your machine - a capture sealing, its pictures,
34
+ your words, naming, the queue, your agent, the pictures before and after, the reply - with the median, the slowest
35
+ and anything that went wrong lately. It reads `design/.local/perf/jam.jsonl`: numbers and fixed codes only, never
36
+ your words, kept on your machine.
37
+
38
+ ### Changed
39
+
40
+ From a first long real Jam session:
41
+
42
+ - **Review shows before and after at once.** Side by side for a tall frame (a phone), one above the other for a wide
43
+ one (a laptop), and the panel grows as wide as that takes, up to the window. **Both · Before · After** shows one
44
+ alone; `B` steps through them.
45
+ - **The lane stays readable when full.** Its tiles lost their frosted blur exactly when the lane scrolled (its edge
46
+ fades cut them off from what was behind); the fades are now strips of their own, and the tiles a touch more opaque.
47
+ - **Done captures fold into one tile.** With two or more done, one **Done** tile - "4 captures · 6 frames changed" -
48
+ keeps the lane for what still needs you. Click it (or `⏎` with `Q`) to open them, a collapse tile folds them back.
49
+ - **The laser is a pointer.** `L` now lights only the element under the cursor, as comment mode does; a click still
50
+ copies its path (or, in a capture, is its pick). The old laser, every element outlined, is **inspect**: `⌥L`, or
51
+ ⌥-click the laser button. `Esc` turns a laser off before it closes or drops anything.
52
+
53
+ ### Upgrading
54
+
55
+ `npm install @marver-design/marver@latest`, then `npx marver init` to refresh the agent instructions (a sandboxed agent
56
+ now knows `marver shot` reaches the canvas through the file inbox). The first `marver dev` after the upgrade prepares
57
+ its new `node_modules/.vite-marver` folder (a moment, once).
58
+
5
59
  ## 0.26.0 - 2026-10-20
6
60
 
7
61
  ### Added
package/README.md CHANGED
@@ -77,7 +77,7 @@ Publish a deck with `{ "boards": { "pitch": { "max": "read", "type": "slides", "
77
77
  ## Collaboration
78
78
 
79
79
  - **Comments.** Google-Docs-style feedback pinned to actual elements. Press `c`, click a div inside a frame, write - the thread lives on that element and survives edits via a layered anchor (source semantics → structure → fuzzy text). Type `@` to mention someone who can already see the canvas; they get a mail with the comment and a link that lands on the thread, and the mention pulses its pin in their canvas with an in-app notification. A reply mails the thread's other participants, throttled per person and thread; anyone can mute a canvas's mail. `marver dev` syncs the same threads into `design/comments/*.jsonl`, where your agent works the queue: `npx marver comments list --open --json` → fork a variant → `resolve --addressed-in`. Live via SSE; one deploy, no extra services.
80
- - **Laser mode.** Press `l`: every element in every frame gets depth-hued outlines plus a hover label - the fastest way to see structure. Click any element to copy its full address (frame file + CSS path) for the agent. (On a published canvas, laser needs `"reveal": { "source": true }` in `publish.json` - source paths go opaque by default.)
80
+ - **Laser mode.** Press `l`: the element under your cursor lights up with a label naming it and its source. Click it to copy its full address (frame file + CSS path) for the agent. `⌥L` is the inspect laser: every element in every frame gets depth-hued outlines - the fastest way to see structure. (On a published canvas, laser needs `"reveal": { "source": true }` in `publish.json` - source paths go opaque by default.)
81
81
  - **Publishing.** `npx marver build` exports a static canvas (default-closed: `design/publish.json` names what ships, each board's ceiling - `read` or `comment` - and, since 0.12, its **type** and **landing view**: `{ "max", "type": "doc" | "slides" | "design" | "sketch" | "refs" | "mix", "open": "canvas" | "board" | "present" | "focus" | "slides", "lock": true }`); `npx marver serve` hosts it. One deploy on Railway, Docker, or any static host - the [publishing guide](docs/publish.md) has the one-pagers.
82
82
  - **Sharing, person by person.** On a canvas with a persistent volume, `marver share add sam@acme.com --role comment` (or the browser's share dialog) grants one person access, `@acme.com` grants a domain, `general private|password|public` sets the floor, and a refused visitor can ask to get in - approve from the terminal. One resolver answers "what can this person do here", and `marver share explain <email>` shows its reasoning. The [sharing guide](docs/sharing.md) has the whole surface.
83
83
 
@@ -134,7 +134,7 @@ The same glow, driven from the terminal. When your agent takes a request, it cre
134
134
 
135
135
  **Where to look** - `u` goes to the next frame that needs you (an orange question bubble), then the next new one (blue) - see [what is new, what needs you](docs/boards-and-folders.md#what-is-new-what-needs-you).
136
136
 
137
- **Modes** - `c` comment mode · `l` laser mode · `⇧C` hide/show comment pins · `⇧L` laser comment (spotlight a thread's element) · `p` play (present, or slides on a slides board) · `h` hide all chrome.
137
+ **Modes** - `c` comment mode · `l` laser · `⌥L` inspect laser · `⇧C` hide/show comment pins · `⇧L` laser comment (spotlight a thread's element) · `p` play (present, or slides on a slides board) · `h` hide all chrome.
138
138
 
139
139
  **In play** - `←` `→` step (Space and click advance a deck) · `[` `]` cycle variants · `d` cycles the theme · digits pick a device, the digit after your last one fills the window · `esc` exits, unless the board is locked to that view.
140
140
 
@@ -1,4 +1,4 @@
1
- import { MOUNTED, frameUrl, manifestFrame, planShot, withBrowser } from "./shot-DqcxJibP.mjs";
1
+ import { MOUNTED, frameUrl, manifestFrame, planShot, withBrowser } from "./shot-DQeR_Pfn.mjs";
2
2
  //#region src/server/anchor-check.ts
3
3
  /**
4
4
  * The anchor check (spec 26, Part 6): `comments new --on|--at`, `comments move` and a Live Jam re-pin
@@ -96,7 +96,21 @@ function createSpeech(opts = {}) {
96
96
  }
97
97
  };
98
98
  w.on("message", (m) => {
99
+ if (m?.type === "timing") {
100
+ try {
101
+ opts.onTiming?.({
102
+ audioMs: m.audioMs,
103
+ waitMs: m.waitMs,
104
+ decodeMs: m.decodeMs,
105
+ backlogMs: m.backlogMs
106
+ });
107
+ } catch {}
108
+ return;
109
+ }
99
110
  if (m?.type === "ready") {
111
+ if (typeof m.modelLoadMs === "number") try {
112
+ opts.onTiming?.({ modelLoadMs: m.modelLoadMs });
113
+ } catch {}
100
114
  if (worker && worker !== w) {
101
115
  w.terminate();
102
116
  settle(worker);
@@ -1,4 +1,4 @@
1
- import { AREA, SURFACE, pool, shotConcurrency, withBrowser } from "./shot-DqcxJibP.mjs";
1
+ import { AREA, SURFACE, pool, shotConcurrency, withBrowser } from "./shot-DQeR_Pfn.mjs";
2
2
  import { existsSync, mkdirSync, readFileSync, readdirSync, realpathSync, renameSync, rmSync, statSync, utimesSync, writeFileSync } from "node:fs";
3
3
  import { join, sep } from "node:path";
4
4
  import { createHash } from "node:crypto";
@@ -4,7 +4,7 @@ import { C as PROPOSED_PUBLISH, a as buildTree, f as isBoardName, l as framesOn,
4
4
  import { g as PUBLISHABLE, s as scanFrames, v as publishableStatus } from "./manifest-Nl3KSVOk.mjs";
5
5
  import { a as readLog, o as shareable, r as legacyExposure, t as appendEvents } from "./comments-0BSbb04K.mjs";
6
6
  import { n as loadConfig, r as detectHost } from "./config-Cf7EjAMf.mjs";
7
- import { a as autoWidthOf, c as readSizes, n as tailwind3Css, o as keptSizes, r as tailwind4Plugin, s as measuringFrames, t as marverPlugin } from "./plugin-CTD0rydA.mjs";
7
+ import { a as autoWidthOf, c as readSizes, n as tailwind3Css, o as keptSizes, r as tailwind4Plugin, s as measuringFrames, t as marverPlugin } from "./plugin-DkGmZs_r.mjs";
8
8
  import { cpSync, existsSync, mkdirSync, readFileSync, realpathSync, rmSync, writeFileSync } from "node:fs";
9
9
  import { basename, dirname, join, sep } from "node:path";
10
10
  import { fileURLToPath } from "node:url";
@@ -785,7 +785,7 @@ async function buildSite(root, boardsFlag, allBoardsFlag, embedSeeds, textures =
785
785
  const realAssets = existsSync(assetsDir) ? realpathSync(assetsDir) : null;
786
786
  for (const r of refs) {
787
787
  if (!isLocalAssetRef(r) || !r.endsWith(".poster.png") || existsSync(join(assetsDir, r))) continue;
788
- const { ensurePoster } = await import("./poster-ChjXGTS5.mjs");
788
+ const { ensurePoster } = await import("./poster-BdtSKMDm.mjs");
789
789
  const g = await ensurePoster(assetsDir, r.slice(0, -11));
790
790
  if (!g.ok) throw new Error(`design/assets/${r}: ${g.error}`);
791
791
  console.log(` poster: rendered design/assets/${r} (${g.width}×${g.height})`);
@@ -862,7 +862,7 @@ async function buildSite(root, boardsFlag, allBoardsFlag, embedSeeds, textures =
862
862
  }));
863
863
  let textureLine = " textures: skipped (--no-textures)";
864
864
  if (textures && bakeGen) {
865
- const { bakePublished } = await import("./publish-bakes-CEP_2NRc.mjs");
865
+ const { bakePublished } = await import("./publish-bakes-9RzRToXV.mjs");
866
866
  const pubFrameFile = new Map(pubFrames.map((f) => [f.id, f]));
867
867
  const r = await bakePublished({
868
868
  root,
@@ -544,7 +544,8 @@ function checkRecord(raw) {
544
544
  board: c.board,
545
545
  ...str(c.session, 200) ? { session: str(c.session, 200) } : {},
546
546
  ...reviewing ? { reviewing } : {},
547
- ...resumes ? { resumes } : {}
547
+ ...resumes ? { resumes } : {},
548
+ ...c.interrupted === true ? { interrupted: true } : {}
548
549
  },
549
550
  view: viewOf(r.view),
550
551
  timeline,
package/dist/cli.mjs CHANGED
@@ -90,7 +90,7 @@ cli.command("init", "Scaffold design/ in this repo").option("--mode <mode>", "st
90
90
  });
91
91
  });
92
92
  for (const [name, desc] of [["dev", "Start the local canvas (everything on: hot reload, comments, Live Jam)"], ["canvas", "Start the local canvas - same as dev"]]) cli.command(name, desc).option("--root <dir>", "Host repo root", { default: "." }).option("--port <port>", "Port (default 5199)").action(async (opts) => {
93
- const { dev, DevLockError } = await import("./dev-_Nlsc6v9.mjs");
93
+ const { dev, DevLockError } = await import("./dev-Bw_qYWWq.mjs");
94
94
  let port;
95
95
  if (opts.port !== void 0) {
96
96
  const n = Number(opts.port);
@@ -106,7 +106,7 @@ for (const [name, desc] of [["dev", "Start the local canvas (everything on: hot
106
106
  }
107
107
  });
108
108
  cli.command("build", "Static export → design/.dist (what ships comes from design/publish.json - publishing is default-closed)").option("--boards <names>", "Publish only these boards (comma-separated); overrides the publish policy").option("--all-boards", "Publish every board - the loud override for the default-closed policy").option("--embed-seeds", "Copy comment history INTO the web root (identifying - every event carries its author's email)").option("--no-textures", "Skip compiling the glass textures the published frames rest under (needs Chrome; a CI without one skips on its own)").option("--root <dir>", "Host repo root", { default: "." }).action(async (opts) => {
109
- const { buildSite } = await import("./build-C_gUgcdC.mjs");
109
+ const { buildSite } = await import("./build-BDRiO_mP.mjs");
110
110
  try {
111
111
  const boards = opts.boards === void 0 ? void 0 : typeof opts.boards === "string" ? opts.boards : "";
112
112
  await buildSite(resolve$1(opts.root), boards, opts.allBoards === true, opts.embedSeeds === true, opts.textures !== false && !process.env.MARVER_NO_TEXTURES);
@@ -231,15 +231,15 @@ cli.command("context <action>", "The project's context/ (spec 19) · init: creat
231
231
  }
232
232
  });
233
233
  cli.command("marks", "What the human has not reviewed: frames waiting on them (the ones that ask first), their answers nothing has acted on yet, and frames new since they looked").option("--root <dir>", "Host repo root", { default: "." }).option("--json", "Machine-readable output").option("--all", "Also list the answers from before 0.26 that may already be handled").action(async (opts) => {
234
- const { marksCommand } = await import("./marks-NQi0wZJ4.mjs");
234
+ const { marksCommand } = await import("./marks-DyWMv_Z1.mjs");
235
235
  marksCommand(resolve$1(opts.root), opts);
236
236
  });
237
- cli.command("perf", "The reload log: what each edit reloaded, page-wide reloads, the slowest frames to settle").option("--root <dir>", "Host repo root", { default: "." }).option("--minutes <n>", "How far back to read (default 60)").option("--json", "Machine-readable output").action(async (opts) => {
238
- const { perfCommand } = await import("./perf-D6VmmJ2q.mjs");
237
+ cli.command("perf", "The reload log: what each edit reloaded, page-wide reloads, the slowest frames to settle; --jam: Jam's timings").option("--root <dir>", "Host repo root", { default: "." }).option("--minutes <n>", "How far back to read (default 60; 24 h with --jam)").option("--jam", "Jam's timings: captures, pictures, words, naming, runs, shots - numbers only (design/.local/perf/jam.jsonl)").option("--json", "Machine-readable output").action(async (opts) => {
238
+ const { perfCommand } = await import("./perf-C75MZ73h.mjs");
239
239
  perfCommand(resolve$1(opts.root), opts);
240
240
  });
241
241
  cli.command("shot [...frames]", "Render frames headless and print the PNG paths (needs `dev` running): ids, --scene <name> or --all").option("--root <dir>", "Host repo root", { default: "." }).option("--scene <name>", "Every frame of one scene").option("--all", "Every frame of the canvas").option("--theme <name>", "Theme to render (default: light)").option("--scale <n>", "Device pixels per CSS px, 1-4 (default: 2; 4 for print-quality stills)").option("--json", "Print the results as JSON ({ results: [...] }) instead of paths").action(async (frames, opts) => {
242
- const { shotCommand } = await import("./shot-CNbHoZ6H.mjs");
242
+ const { shotCommand } = await import("./shot-XQV7HC9A.mjs");
243
243
  try {
244
244
  await shotCommand(resolve$1(opts.root), frames, opts);
245
245
  } catch (err) {