@marver-design/marver 0.33.0 → 0.34.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.
- package/CHANGELOG.md +15 -0
- package/dist/{anchor-check-KCe6WeRA.mjs → anchor-check-Cld22HFE.mjs} +1 -1
- package/dist/{build-4-k2XhhX.mjs → build-C1AGScLz.mjs} +3 -3
- package/dist/cli.mjs +5 -5
- package/dist/{comments-C2SN1QdM.mjs → comments-C7NjFGgl.mjs} +14 -7
- package/dist/{daemon-CCDgagw2.mjs → daemon-CWl_0QF8.mjs} +2 -4
- package/dist/{dev-CJf5upVK.mjs → dev-Kfv8FgVw.mjs} +7 -7
- package/dist/{pdf-GGya_nI6.mjs → pdf-6JNQAKJv.mjs} +2 -2
- package/dist/{plugin-Cm74UDfp.mjs → plugin-C1SEQSU5.mjs} +15 -29
- package/dist/{poster-BnuT9UyW.mjs → poster-BO971KQR.mjs} +1 -1
- package/dist/{publish-bakes-zHmPEOB5.mjs → publish-bakes-JCG2kvQP.mjs} +2 -2
- package/dist/{recover-BpRQxBA7.mjs → recover-BIHPEDTa.mjs} +1 -1
- package/dist/{shot-HZtclbOT.mjs → shot-G0bBXwHl.mjs} +2 -2
- package/docs/boards-and-folders.md +1 -1
- package/docs/slides.md +8 -0
- package/package.json +1 -1
- package/templates/AGENTS-embedded.md +3 -3
- package/templates/AGENTS-studio.md +3 -3
- package/templates/instructions/iterate.md +1 -1
- package/templates/instructions/reference/deck-replicate.md +44 -0
- package/templates/instructions/slides.md +8 -0
package/CHANGELOG.md
CHANGED
|
@@ -2,6 +2,21 @@
|
|
|
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.34.0 - 2026-11-14
|
|
6
|
+
|
|
7
|
+
### Highlights
|
|
8
|
+
|
|
9
|
+
- **Your agent can replicate a deck in another presentation tool, ready for others to edit.** Google Slides,
|
|
10
|
+
PowerPoint, Keynote, Canva or any tool it can drive through an MCP or API: every text, shape, line and image becomes
|
|
11
|
+
a native element, never a picture of the slide. [Slides](docs/slides.md)
|
|
12
|
+
- **Your agent can resolve one frame's comments.** `npx marver comments resolve --all --frame <scene/frame>` does what
|
|
13
|
+
a frame's **Resolve comments** does in the sidebar (0.33), with `--dry-run` and `--undo` like the other scopes. Your
|
|
14
|
+
agent still asks you first. [Boards and folders](docs/boards-and-folders.md)
|
|
15
|
+
|
|
16
|
+
### Upgrading
|
|
17
|
+
|
|
18
|
+
- `npx marver init` - your agent's guide names the new `--frame` scope and teaches replicating a deck in another presentation tool.
|
|
19
|
+
|
|
5
20
|
## 0.33.0 - 2026-11-13
|
|
6
21
|
|
|
7
22
|
### Highlights
|
|
@@ -1,4 +1,4 @@
|
|
|
1
|
-
import { a as frameUrl, d as withBrowser, n as MOUNTED, o as manifestFrame, s as planShot } from "./shot-
|
|
1
|
+
import { a as frameUrl, d as withBrowser, n as MOUNTED, o as manifestFrame, s as planShot } from "./shot-G0bBXwHl.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
|
|
@@ -6,7 +6,7 @@ import { a as readLog, o as shareable, r as legacyExposure, t as appendEvents }
|
|
|
6
6
|
import { t as detectHost } from "./detect-C0wpaePX.mjs";
|
|
7
7
|
import { a as publishLogo, r as logoIcons } from "./logo-C9s7-Cy9.mjs";
|
|
8
8
|
import { n as loadConfig } from "./config-B0YcFtqS.mjs";
|
|
9
|
-
import { d as canvasIdentity, n as tailwind3Css, r as tailwind4Plugin, t as marverPlugin } from "./plugin-
|
|
9
|
+
import { d as canvasIdentity, n as tailwind3Css, r as tailwind4Plugin, t as marverPlugin } from "./plugin-C1SEQSU5.mjs";
|
|
10
10
|
import { i as measuringFrames, n as autoWidthOf, o as readSizes, r as keptSizes } from "./sizes-BckcL4Zz.mjs";
|
|
11
11
|
import { cpSync, existsSync, mkdirSync, readFileSync, realpathSync, rmSync, writeFileSync } from "node:fs";
|
|
12
12
|
import { dirname, join, sep } from "node:path";
|
|
@@ -790,7 +790,7 @@ async function buildSite(root, boardsFlag, allBoardsFlag, embedSeeds, textures =
|
|
|
790
790
|
const realAssets = existsSync(assetsDir) ? realpathSync(assetsDir) : null;
|
|
791
791
|
for (const r of refs) {
|
|
792
792
|
if (!isLocalAssetRef(r) || !r.endsWith(".poster.png") || existsSync(join(assetsDir, r))) continue;
|
|
793
|
-
const { ensurePoster } = await import("./poster-
|
|
793
|
+
const { ensurePoster } = await import("./poster-BO971KQR.mjs");
|
|
794
794
|
const g = await ensurePoster(assetsDir, r.slice(0, -11));
|
|
795
795
|
if (!g.ok) throw new Error(`design/assets/${r}: ${g.error}`);
|
|
796
796
|
console.log(` poster: rendered design/assets/${r} (${g.width}×${g.height})`);
|
|
@@ -849,7 +849,7 @@ async function buildSite(root, boardsFlag, allBoardsFlag, embedSeeds, textures =
|
|
|
849
849
|
}));
|
|
850
850
|
let textureLine = " textures: skipped (--no-textures)";
|
|
851
851
|
if (textures && bakeGen) {
|
|
852
|
-
const { bakePublished } = await import("./publish-bakes-
|
|
852
|
+
const { bakePublished } = await import("./publish-bakes-JCG2kvQP.mjs");
|
|
853
853
|
const pubFrameFile = new Map(pubFrames.map((f) => [f.id, f]));
|
|
854
854
|
const r = await bakePublished({
|
|
855
855
|
root,
|
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>", "A port of its own (default: a free slot, localhost:4805-4824 - usually the same one next time; a port in that range takes exactly that slot)").option("--recover [n]", "Run on an address this canvas had before, where an unsent Jam capture waits: alone it lists them; with a number it starts on that one; --recover --port <p>: the port 0.26 used").action(async (opts) => {
|
|
93
|
-
const { dev, DevStartError, DevLockError } = await import("./dev-
|
|
93
|
+
const { dev, DevStartError, DevLockError } = await import("./dev-Kfv8FgVw.mjs");
|
|
94
94
|
let port;
|
|
95
95
|
if (opts.port !== void 0) {
|
|
96
96
|
const n = Number(opts.port);
|
|
@@ -102,7 +102,7 @@ for (const [name, desc] of [["dev", "Start the local canvas (everything on: hot
|
|
|
102
102
|
process.exit(1);
|
|
103
103
|
};
|
|
104
104
|
try {
|
|
105
|
-
if (opts.recover !== void 0 && opts.recover !== false) await (await import("./recover-
|
|
105
|
+
if (opts.recover !== void 0 && opts.recover !== false) await (await import("./recover-BIHPEDTa.mjs")).recoverCommand(resolve$1(opts.root), opts.recover, port, { onFail });
|
|
106
106
|
else await dev(resolve$1(opts.root), {
|
|
107
107
|
port,
|
|
108
108
|
onFail
|
|
@@ -118,7 +118,7 @@ cli.command("ls", "The canvases running on this Mac: slot, link, name, version,
|
|
|
118
118
|
(await import("./ls-DGVIW-Io.mjs")).lsCommand({ json: opts.json === true });
|
|
119
119
|
});
|
|
120
120
|
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) => {
|
|
121
|
-
const { buildSite } = await import("./build-
|
|
121
|
+
const { buildSite } = await import("./build-C1AGScLz.mjs");
|
|
122
122
|
try {
|
|
123
123
|
const boards = opts.boards === void 0 ? void 0 : typeof opts.boards === "string" ? opts.boards : "";
|
|
124
124
|
await buildSite(resolve$1(opts.root), boards, opts.allBoards === true, opts.embedSeeds === true, opts.textures !== false && !process.env.MARVER_NO_TEXTURES);
|
|
@@ -136,8 +136,8 @@ cli.command("serve", "Serve design/.dist (set MARVER_PASSWORD to gate it)").opti
|
|
|
136
136
|
}
|
|
137
137
|
serve(resolve$1(opts.root), port);
|
|
138
138
|
});
|
|
139
|
-
cli.command("comments <action> [value]", "Comment collaboration: connect <url> · sync · list · new <scene/frame> · reply <thread> · move <thread> · resolve <thread> | --all · invite <email> · revoke <email>. Nothing here edits or deletes a message: people do their own on the canvas, and Marver's have no Edit or Delete - correct a wrong note in its thread").option("--root <dir>", "Host repo root", { default: "." }).option("--token <token>", "connect: the canvas's MARVER_CLI_TOKEN (default $MARVER_CLI_TOKEN) - the identity-mode path").option("--invite <token>", "connect: claim this invite instead of signing in").option("--canvas-password <password>", "connect: the canvas gate password (default $MARVER_PASSWORD or prompt)").option("--email <email>", "connect: account email (skips the prompt)").option("--password <password>", "connect: account password (skips the prompt - mind your shell history)").option("--name <name>", "connect --invite: display name for the new account").option("--open", "list: only unresolved threads").option("--json", "list: machine-readable output").option("--board <board>", "list: scope to one board · new: the board to pin on (default: the one its link opens) · resolve --all: the threads on frames this board shows").option("--body <text>", "new / reply: the text").option("--on <text>", "new / move: pin on the element showing these words").option("--at <selector>", "new / move: pin on the element this data-testid or CSS selector names (an element without words, like an icon)").option("--nth <n>", "new / move: which of several matching elements (1 = the first)").option("--viewport <name>", "new / move: check the frame at this viewport (default: its own)").option("--theme <name>", "new / move: check the frame in this theme (default: light)").option("--thread <id>", "new: add the note to this open thread instead of pinning a new one").option("--fyi", "new: the note asks nothing (default: it asks - it comes first for the human)").option("--ask", "reply: the reply asks the human something").option("--addressed-in <frame>", "resolve: the variant frame that answered the feedback").option("--all", "resolve: every open thread in a scope - with --board, --folder, --scene or --canvas (ask the human first)").option("--folder <folder>", "resolve --all: the threads on every board in this folder, sub-folders included").option("--scene <scene>", "resolve --all: the threads on this scene's frames").option("--canvas", "resolve --all: every open thread on the canvas").option("--dry-run", "resolve --all: count what it would resolve, write nothing").option("--undo <op>", "resolve: undo a resolve --all by the op id it printed").action(async (action, value, opts) => {
|
|
140
|
-
const { commentsCommand } = await import("./comments-
|
|
139
|
+
cli.command("comments <action> [value]", "Comment collaboration: connect <url> · sync · list · new <scene/frame> · reply <thread> · move <thread> · resolve <thread> | --all · invite <email> · revoke <email>. Nothing here edits or deletes a message: people do their own on the canvas, and Marver's have no Edit or Delete - correct a wrong note in its thread").option("--root <dir>", "Host repo root", { default: "." }).option("--token <token>", "connect: the canvas's MARVER_CLI_TOKEN (default $MARVER_CLI_TOKEN) - the identity-mode path").option("--invite <token>", "connect: claim this invite instead of signing in").option("--canvas-password <password>", "connect: the canvas gate password (default $MARVER_PASSWORD or prompt)").option("--email <email>", "connect: account email (skips the prompt)").option("--password <password>", "connect: account password (skips the prompt - mind your shell history)").option("--name <name>", "connect --invite: display name for the new account").option("--open", "list: only unresolved threads").option("--json", "list: machine-readable output").option("--board <board>", "list: scope to one board · new: the board to pin on (default: the one its link opens) · resolve --all: the threads on frames this board shows").option("--body <text>", "new / reply: the text").option("--on <text>", "new / move: pin on the element showing these words").option("--at <selector>", "new / move: pin on the element this data-testid or CSS selector names (an element without words, like an icon)").option("--nth <n>", "new / move: which of several matching elements (1 = the first)").option("--viewport <name>", "new / move: check the frame at this viewport (default: its own)").option("--theme <name>", "new / move: check the frame in this theme (default: light)").option("--thread <id>", "new: add the note to this open thread instead of pinning a new one").option("--fyi", "new: the note asks nothing (default: it asks - it comes first for the human)").option("--ask", "reply: the reply asks the human something").option("--addressed-in <frame>", "resolve: the variant frame that answered the feedback").option("--all", "resolve: every open thread in a scope - with --board, --folder, --scene, --frame or --canvas (ask the human first)").option("--folder <folder>", "resolve --all: the threads on every board in this folder, sub-folders included").option("--scene <scene>", "resolve --all: the threads on this scene's frames").option("--frame <frame>", "resolve --all: the threads on this one frame (scene/frame)").option("--canvas", "resolve --all: every open thread on the canvas").option("--dry-run", "resolve --all: count what it would resolve, write nothing").option("--undo <op>", "resolve: undo a resolve --all by the op id it printed").action(async (action, value, opts) => {
|
|
140
|
+
const { commentsCommand } = await import("./comments-C7NjFGgl.mjs");
|
|
141
141
|
try {
|
|
142
142
|
await commentsCommand(resolve$1(opts.root), action, value, opts);
|
|
143
143
|
} catch (err) {
|
|
@@ -29,7 +29,7 @@ import { createInterface } from "node:readline";
|
|
|
29
29
|
* --ask when the reply asks the human something
|
|
30
30
|
* move <thread> re-pin a thread on another element (--on / --at) - its author's only
|
|
31
31
|
* resolve <thread> mark addressed (--addressed-in <frame> records WHICH variant)
|
|
32
|
-
* resolve --all every open thread in one scope (--board | --folder | --scene | --canvas; --dry-run counts) -
|
|
32
|
+
* resolve --all every open thread in one scope (--board | --folder | --scene | --frame | --canvas; --dry-run counts) -
|
|
33
33
|
* never what Jam is at work on; --undo <op> reopens what it resolved. Only on the human's yes.
|
|
34
34
|
* invite <email> mint a single-use invite link (owner only, needs connect first)
|
|
35
35
|
* revoke <email> revoke an account and its sessions (owner only)
|
|
@@ -194,7 +194,7 @@ async function commentsCommand(root, action, value, opts) {
|
|
|
194
194
|
case "resolve": {
|
|
195
195
|
if (opts.undo !== void 0) return resolveUndo(root, String(opts.undo));
|
|
196
196
|
if (opts.all) return resolveAllCli(root, value, opts);
|
|
197
|
-
if (!value) throw new Error("usage: comments resolve <thread-id> [--addressed-in <frame>] | --all (--board b | --folder f | --scene s | --canvas) [--dry-run]");
|
|
197
|
+
if (!value) throw new Error("usage: comments resolve <thread-id> [--addressed-in <frame>] | --all (--board b | --folder f | --scene s | --frame scene/frame | --canvas) [--dry-run]");
|
|
198
198
|
const t = allThreads(root).find((t) => t.id === value);
|
|
199
199
|
if (!t) throw new Error(`no thread ${value} in design/comments/`);
|
|
200
200
|
appendEvents(join(root, "design", "comments"), t.board, [{
|
|
@@ -236,15 +236,22 @@ async function commentsCommand(root, action, value, opts) {
|
|
|
236
236
|
* memory is the one checked, in the same step as the writes), else here, against the journal on disk. Never decided by
|
|
237
237
|
* an agent alone: the guide says to ask, with the counts \`--dry-run\` prints. */
|
|
238
238
|
const resolveAllCli = async (root, value, opts) => {
|
|
239
|
-
if (value) throw new Error(`resolve --all takes no thread id - name a scope: --board, --folder, --scene or --canvas`);
|
|
239
|
+
if (value) throw new Error(`resolve --all takes no thread id - name a scope: --board, --folder, --scene, --frame or --canvas`);
|
|
240
240
|
const ca = await import("./comment-actions-BCBcd-Wq.mjs");
|
|
241
|
+
const typed = (flag) => {
|
|
242
|
+
if (Array.isArray(opts[flag])) throw new Error(`resolve --all names one --${flag}, not ${opts[flag].length}`);
|
|
243
|
+
const argv = process.argv, i = argv.indexOf(`--${flag}`);
|
|
244
|
+
const raw = i >= 0 ? argv[i + 1] : argv.find((t) => t.startsWith(`--${flag}=`))?.slice(flag.length + 3);
|
|
245
|
+
return raw !== void 0 && !raw.startsWith("--") ? raw : String(opts[flag]);
|
|
246
|
+
};
|
|
241
247
|
const named = [
|
|
242
|
-
opts.board !== void 0 && { board:
|
|
243
|
-
opts.folder !== void 0 && { folder:
|
|
244
|
-
opts.scene !== void 0 && { scene:
|
|
248
|
+
opts.board !== void 0 && { board: typed("board") },
|
|
249
|
+
opts.folder !== void 0 && { folder: typed("folder") },
|
|
250
|
+
opts.scene !== void 0 && { scene: typed("scene") },
|
|
251
|
+
opts.frame !== void 0 && { frame: typed("frame") },
|
|
245
252
|
opts.canvas && { canvas: true }
|
|
246
253
|
].filter(Boolean);
|
|
247
|
-
if (named.length !== 1) throw new Error("resolve --all needs exactly one scope: --board <b> | --folder <f> | --scene <s> | --canvas");
|
|
254
|
+
if (named.length !== 1) throw new Error("resolve --all needs exactly one scope: --board <b> | --folder <f> | --scene <s> | --frame <scene/frame> | --canvas");
|
|
248
255
|
const scope = ca.parseScope(named[0]);
|
|
249
256
|
if (typeof scope === "string") throw new Error(scope);
|
|
250
257
|
const op = randomUUID();
|
|
@@ -13,7 +13,7 @@ import { C as refusedAsk, S as parseMembers, T as sharedWhy, _ as wordsUntil, a
|
|
|
13
13
|
import { a as recordFile, c as storeWrapup, i as readWrapup, l as wrapupWithoutDeleted, n as buildWrapup, o as recordPathProblem, r as moreOf, t as SESSION_ID } from "./session-DBF-nQvq.mjs";
|
|
14
14
|
import { act, addCapture, addWrapup, answeredSince, beginStep, captureComment, captureIntact, conflictStep, createQueue, ctxFor, deletedEvents, dropDeleted, endSession, endStep, fail, failCard, form, joinAlone, liveThreads, looksGood, moreWrapup, ownerOnly, payloadKey, pending, prune, r as releaseLock, redelivering, requeue, runsAlone, sameComment, settle, startSession, stillOwned, t as acquireLock, textOf, tombstonesOf, undelivered, withdrawnCaptures, wrapupIntact, wrapupOf } from "./queue-BLLfdlDw.mjs";
|
|
15
15
|
import { d as logJam } from "./perf-BA_NDarr.mjs";
|
|
16
|
-
import { i as jamLive } from "./plugin-
|
|
16
|
+
import { i as jamLive } from "./plugin-C1SEQSU5.mjs";
|
|
17
17
|
import { t as PROTECTED_GLOBS } from "./permit-DDa6wqOs.mjs";
|
|
18
18
|
import { jamReservations, restoreHolds } from "./reserve-BURNQ2Y3.mjs";
|
|
19
19
|
import { recordOwn } from "./own-C8Mq0Hnf.mjs";
|
|
@@ -1102,9 +1102,7 @@ const STALL_MS = 9e5;
|
|
|
1102
1102
|
* MARVER_SLOT_BASE set (test-build.ts; as perf-run.ts's MV_PERF_RUN_T): a real stall in seconds, so a browser case
|
|
1103
1103
|
* drives one through this daemon and the page's own actions. */
|
|
1104
1104
|
const stallMs = () => {
|
|
1105
|
-
|
|
1106
|
-
const v = Number(process.env.MV_JAM_STALL_MS);
|
|
1107
|
-
return Number.isFinite(v) && v > 0 ? v : STALL_MS;
|
|
1105
|
+
return STALL_MS;
|
|
1108
1106
|
};
|
|
1109
1107
|
/** How long a request's answer is kept for the same request sent again. */
|
|
1110
1108
|
const RECEIPT_MS = 6e5;
|
|
@@ -2,7 +2,7 @@ import { i as PKG, r as NAME } from "./cli.mjs";
|
|
|
2
2
|
import { _ as runIdentity, a as notePrefer, c as ranDevBefore, f as startedWhere, i as marverHome, o as originOf, p as stopPrefer, s as place, t as forgetDevTraces } from "./slots-BOcfIqxy.mjs";
|
|
3
3
|
import { t as detectHost } from "./detect-C0wpaePX.mjs";
|
|
4
4
|
import { n as loadConfig } from "./config-B0YcFtqS.mjs";
|
|
5
|
-
import { c as installedVersion, d as canvasIdentity, f as identityNudge, n as tailwind3Css, o as liveChanged, r as tailwind4Plugin, t as marverPlugin } from "./plugin-
|
|
5
|
+
import { c as installedVersion, d as canvasIdentity, f as identityNudge, n as tailwind3Css, o as liveChanged, r as tailwind4Plugin, t as marverPlugin } from "./plugin-C1SEQSU5.mjs";
|
|
6
6
|
import { existsSync, mkdirSync, readFileSync, readdirSync, realpathSync, statSync, watch, writeSync } from "node:fs";
|
|
7
7
|
import { basename, dirname, isAbsolute, join, relative, resolve, sep } from "node:path";
|
|
8
8
|
import { fileURLToPath } from "node:url";
|
|
@@ -1021,7 +1021,7 @@ async function boot(root, opts, instance, t, ctx) {
|
|
|
1021
1021
|
if (fromConfig !== void 0 && !placed.fellBackFrom) console.log(` this canvas keeps its own port (${fromConfig} in design/config.ts); remove it to use the slots\n`);
|
|
1022
1022
|
setTimeout(async () => {
|
|
1023
1023
|
try {
|
|
1024
|
-
await (await import("./shot-
|
|
1024
|
+
await (await import("./shot-G0bBXwHl.mjs").then((n) => n.u)).sweepGhosts((m) => console.log(` ${m}`));
|
|
1025
1025
|
} catch {}
|
|
1026
1026
|
}, 0);
|
|
1027
1027
|
try {
|
|
@@ -1108,8 +1108,8 @@ async function boot(root, opts, instance, t, ctx) {
|
|
|
1108
1108
|
console.log(` comments: could not record who wrote what here - ${err.message}`);
|
|
1109
1109
|
}
|
|
1110
1110
|
if (config.jam) {
|
|
1111
|
-
const { startJam } = await import("./daemon-
|
|
1112
|
-
const { checkAnchor } = await import("./anchor-check-
|
|
1111
|
+
const { startJam } = await import("./daemon-CWl_0QF8.mjs");
|
|
1112
|
+
const { checkAnchor } = await import("./anchor-check-Cld22HFE.mjs");
|
|
1113
1113
|
const jam = startJam(root, config.jam, (m) => console.log(m), (board) => {
|
|
1114
1114
|
server.ws.send("sh:jam-comment", { board });
|
|
1115
1115
|
liveChanged();
|
|
@@ -1126,13 +1126,13 @@ async function boot(root, opts, instance, t, ctx) {
|
|
|
1126
1126
|
return () => {
|
|
1127
1127
|
due ??= setTimeout(async () => {
|
|
1128
1128
|
due = null;
|
|
1129
|
-
const { jamLive } = await import("./plugin-
|
|
1129
|
+
const { jamLive } = await import("./plugin-C1SEQSU5.mjs").then((n) => n.a);
|
|
1130
1130
|
server.ws.send("sh:jam-queue", jamLive.view?.() ?? { cards: [] });
|
|
1131
1131
|
liveChanged();
|
|
1132
1132
|
}, 60);
|
|
1133
1133
|
};
|
|
1134
1134
|
})(), async (frameId, theme, entry, size) => {
|
|
1135
|
-
const { shootFrame } = await import("./shot-
|
|
1135
|
+
const { shootFrame } = await import("./shot-G0bBXwHl.mjs").then((n) => n.u);
|
|
1136
1136
|
const r = await shootFrame({
|
|
1137
1137
|
root,
|
|
1138
1138
|
viewports: config.viewports,
|
|
@@ -1153,7 +1153,7 @@ async function boot(root, opts, instance, t, ctx) {
|
|
|
1153
1153
|
t.defer(() => jam.stop());
|
|
1154
1154
|
if (config.jam.session !== false) try {
|
|
1155
1155
|
const { ensureConnectors, connectorLine } = await import("./connectors-DekQvKt9.mjs");
|
|
1156
|
-
const { jamLive } = await import("./plugin-
|
|
1156
|
+
const { jamLive } = await import("./plugin-C1SEQSU5.mjs").then((n) => n.a);
|
|
1157
1157
|
const results = ensureConnectors(root);
|
|
1158
1158
|
jamLive.connectors = results;
|
|
1159
1159
|
const line = connectorLine(results);
|
|
@@ -1,8 +1,8 @@
|
|
|
1
1
|
import { a as ROUTE, o as slideSize } from "./cli.mjs";
|
|
2
2
|
import { s as checkRealDirs } from "./boards-Cim1GTKc.mjs";
|
|
3
3
|
import { n as BOARD_NAME } from "./board-tree-DGj0HhEE.mjs";
|
|
4
|
-
import { s as onPdfReset } from "./plugin-
|
|
5
|
-
import { c as pool, f as staleSurface, p as Browser } from "./shot-
|
|
4
|
+
import { s as onPdfReset } from "./plugin-C1SEQSU5.mjs";
|
|
5
|
+
import { c as pool, f as staleSurface, p as Browser } from "./shot-G0bBXwHl.mjs";
|
|
6
6
|
import { existsSync, lstatSync, mkdirSync, mkdtempSync, readFileSync, readdirSync, renameSync, rmSync, statSync, writeFileSync } from "node:fs";
|
|
7
7
|
import { join, sep } from "node:path";
|
|
8
8
|
import { randomBytes } from "node:crypto";
|
|
@@ -14,7 +14,7 @@ import { C as WRITE_MATCH_MS, S as WRITER_HEADERS, _ as ID12, b as RELOAD_BOUNDS
|
|
|
14
14
|
import { c as proofHeaders, i as logoRoute, s as appProofOk, t as findLogo } from "./logo-C9s7-Cy9.mjs";
|
|
15
15
|
import { n as loadConfig } from "./config-B0YcFtqS.mjs";
|
|
16
16
|
import { a as mergeSizes, c as serializeSizes, i as measuringFrames, l as sizesPath, n as autoWidthOf, o as readSizes, r as keptSizes, s as readSizesFile } from "./sizes-BckcL4Zz.mjs";
|
|
17
|
-
import { c as pool, d as withBrowser, h as launchFlags, l as shotConcurrency, p as Browser, r as SURFACE, t as AREA } from "./shot-
|
|
17
|
+
import { c as pool, d as withBrowser, h as launchFlags, l as shotConcurrency, p as Browser, r as SURFACE, t as AREA } from "./shot-G0bBXwHl.mjs";
|
|
18
18
|
import { closeSync, copyFileSync, existsSync, linkSync, lstatSync, mkdirSync, openSync, readFileSync, readdirSync, realpathSync, renameSync, rmSync, statSync, utimesSync, watch, writeFileSync } from "node:fs";
|
|
19
19
|
import { basename, dirname, isAbsolute, join, relative, resolve, sep } from "node:path";
|
|
20
20
|
import { fileURLToPath } from "node:url";
|
|
@@ -856,7 +856,7 @@ async function bakeIn(b, opts) {
|
|
|
856
856
|
const deadline = setTimeout(() => {
|
|
857
857
|
timedOut = true;
|
|
858
858
|
b.abort(me, TIMED_OUT);
|
|
859
|
-
},
|
|
859
|
+
}, DEADLINE_MS);
|
|
860
860
|
const closeTarget = async (id) => {
|
|
861
861
|
let t;
|
|
862
862
|
await Promise.race([b.send("Target.closeTarget", { targetId: id }).catch(() => {}), new Promise((r) => {
|
|
@@ -1341,13 +1341,11 @@ function endRunBakes(owner) {
|
|
|
1341
1341
|
* looks at a COMPILING outlast any held compile (A3.8 r1 #4's case, added by the review of a3-runs). */
|
|
1342
1342
|
const bakeSeams = {};
|
|
1343
1343
|
const holdMs = () => {
|
|
1344
|
-
|
|
1345
|
-
const v = process.env.MARVER_SLOT_BASE ? Number(process.env.MV_BAKE_HOLD_MS) : NaN;
|
|
1346
|
-
return Number.isFinite(v) && v > 0 ? Math.min(v, 6e4) : 0;
|
|
1344
|
+
return 0;
|
|
1347
1345
|
};
|
|
1348
1346
|
/** The suite's answer for a compile still running, under MV_BAKE_STOP_ASKING (above). */
|
|
1349
1347
|
const STOP_ASKING = "still compiling - the suite asks the page to stop asking";
|
|
1350
|
-
const stillCompiling = () =>
|
|
1348
|
+
const stillCompiling = () => COMPILING;
|
|
1351
1349
|
/** Compiles in flight, by generation and key: identical asks - inside one request or across
|
|
1352
1350
|
* concurrent ones - share one compile. */
|
|
1353
1351
|
const inflight = /* @__PURE__ */ new Map();
|
|
@@ -2157,17 +2155,7 @@ const runSeams = {};
|
|
|
2157
2155
|
/** RUN_T, with the suite's overrides: `runSeams.t` in-process, `MV_PERF_RUN_T` (JSON) for a dev server a test starts -
|
|
2158
2156
|
* both read only with MARVER_SLOT_BASE set (the suite's marker). */
|
|
2159
2157
|
function runT() {
|
|
2160
|
-
|
|
2161
|
-
if (!process.env.MARVER_SLOT_BASE) return t;
|
|
2162
|
-
let env = {};
|
|
2163
|
-
try {
|
|
2164
|
-
env = JSON.parse(process.env.MV_PERF_RUN_T ?? "{}");
|
|
2165
|
-
} catch {}
|
|
2166
|
-
for (const src of [env, runSeams.t ?? {}]) for (const k of Object.keys(t)) {
|
|
2167
|
-
const v = src[k];
|
|
2168
|
-
if (typeof v === "number" && v >= 0) t[k] = v;
|
|
2169
|
-
}
|
|
2170
|
-
return t;
|
|
2158
|
+
return { ...RUN_T };
|
|
2171
2159
|
}
|
|
2172
2160
|
/** The shell's address for a run's load: its run id, the warm-up's mark, the recorder's level when not `full` (spec 30
|
|
2173
2161
|
* #58: the shell reads it, `withWs()` carries it to the frames), the board. */
|
|
@@ -2235,7 +2223,6 @@ async function openPage(b, o) {
|
|
|
2235
2223
|
}
|
|
2236
2224
|
};
|
|
2237
2225
|
function call(m, p = {}, sid, ms = T.callMs) {
|
|
2238
|
-
runSeams.cdp?.(m, p);
|
|
2239
2226
|
const sent = b.send(m, p, sid, own);
|
|
2240
2227
|
let t;
|
|
2241
2228
|
const late = new Promise((_, reject) => {
|
|
@@ -2299,7 +2286,6 @@ async function openPage(b, o) {
|
|
|
2299
2286
|
async function closePage(b, page) {
|
|
2300
2287
|
page.stop();
|
|
2301
2288
|
const bounded = async (m, p, sid) => {
|
|
2302
|
-
runSeams.cdp?.(m, p);
|
|
2303
2289
|
let t;
|
|
2304
2290
|
await Promise.race([b.send(m, p, sid).catch(() => {}), new Promise((r) => {
|
|
2305
2291
|
t = setTimeout(r, 2e3);
|
|
@@ -2824,7 +2810,7 @@ async function serveRun(req, res, o) {
|
|
|
2824
2810
|
};
|
|
2825
2811
|
const beat = setInterval(() => write({ heartbeat: Date.now() }), T.heartbeatMs);
|
|
2826
2812
|
try {
|
|
2827
|
-
const drive =
|
|
2813
|
+
const drive = runOnce;
|
|
2828
2814
|
for (let i = 0; i < asked.req.repeat && !ac.signal.aborted; i++) write({ line: await drive({
|
|
2829
2815
|
root: o.root,
|
|
2830
2816
|
origin: o.origin,
|
|
@@ -3810,7 +3796,7 @@ function apiMiddleware(root, opts = {}) {
|
|
|
3810
3796
|
};
|
|
3811
3797
|
const asPng = url.searchParams.get("format") === "png";
|
|
3812
3798
|
const origin = opts.origin?.() ?? `http://${req.headers.host ?? "localhost"}`;
|
|
3813
|
-
const { shootFrame } = await import("./shot-
|
|
3799
|
+
const { shootFrame } = await import("./shot-G0bBXwHl.mjs").then((n) => n.u);
|
|
3814
3800
|
const r = await shootFrame({
|
|
3815
3801
|
root,
|
|
3816
3802
|
viewports: opts.viewports ?? {},
|
|
@@ -3848,7 +3834,7 @@ function apiMiddleware(root, opts = {}) {
|
|
|
3848
3834
|
const { readDevInfo } = await import("./work-B4tydWnf.mjs").then((n) => n.c);
|
|
3849
3835
|
const token = readDevInfo(root)?.token;
|
|
3850
3836
|
if (!ownerGated(req) && !(token && req.headers["x-mv-work"] === token)) return json(res, 403, { error: "forbidden" });
|
|
3851
|
-
const pdf = await import("./pdf-
|
|
3837
|
+
const pdf = await import("./pdf-6JNQAKJv.mjs");
|
|
3852
3838
|
if (pdfRoute[1] === void 0) {
|
|
3853
3839
|
if (req.method !== "POST") return json(res, 405, { error: "POST to start a PDF" });
|
|
3854
3840
|
const raw = await readBody(req);
|
|
@@ -3954,7 +3940,7 @@ function apiMiddleware(root, opts = {}) {
|
|
|
3954
3940
|
if (typeof theme !== "string" || !/^[a-z0-9-]+$/i.test(theme)) return json(res, 400, { error: "invalid theme" });
|
|
3955
3941
|
const scale = body.scale === void 0 ? void 0 : body.scale;
|
|
3956
3942
|
if (scale !== void 0 && !(Number.isInteger(scale) && scale >= 1 && scale <= 4)) return json(res, 400, { error: "invalid scale" });
|
|
3957
|
-
const { resolveFrames, shootBatch } = await import("./shot-
|
|
3943
|
+
const { resolveFrames, shootBatch } = await import("./shot-G0bBXwHl.mjs").then((n) => n.u);
|
|
3958
3944
|
const sel = resolveFrames(root, body);
|
|
3959
3945
|
if (!sel.ok) return json(res, sel.status, { error: sel.error });
|
|
3960
3946
|
const origin = opts.origin?.() ?? `http://${req.headers.host ?? "localhost"}`;
|
|
@@ -3988,7 +3974,7 @@ function apiMiddleware(root, opts = {}) {
|
|
|
3988
3974
|
if (typeof target === "string") return json(res, 400, { error: target });
|
|
3989
3975
|
const others = Array.isArray(b.others) ? b.others.filter((o) => typeof o?.key === "string").slice(0, 200) : [];
|
|
3990
3976
|
const origin = opts.origin?.() ?? `http://${req.headers.host ?? "localhost"}`;
|
|
3991
|
-
const { checkAnchor, CheckInputError } = await import("./anchor-check-
|
|
3977
|
+
const { checkAnchor, CheckInputError } = await import("./anchor-check-Cld22HFE.mjs");
|
|
3992
3978
|
try {
|
|
3993
3979
|
return json(res, 200, await checkAnchor({
|
|
3994
3980
|
root,
|
|
@@ -4096,8 +4082,8 @@ function apiMiddleware(root, opts = {}) {
|
|
|
4096
4082
|
return json(res, 400, { error: "malformed JSON" });
|
|
4097
4083
|
}
|
|
4098
4084
|
const src = typeof b?.src === "string" ? b.src : "";
|
|
4099
|
-
const { ensurePoster, isLocalClip } = await import("./poster-
|
|
4100
|
-
const { isLocalAssetRef } = await import("./build-
|
|
4085
|
+
const { ensurePoster, isLocalClip } = await import("./poster-BO971KQR.mjs");
|
|
4086
|
+
const { isLocalAssetRef } = await import("./build-C1AGScLz.mjs");
|
|
4101
4087
|
if (!isLocalAssetRef(src) || !isLocalClip(src)) return json(res, 400, { error: "src must be a clip under design/assets/" });
|
|
4102
4088
|
const r = await ensurePoster(join(root, "design", "assets"), src);
|
|
4103
4089
|
if (!r.ok) return json(res, r.error.includes("does not exist") ? 404 : 503, { error: r.error });
|
|
@@ -4553,7 +4539,7 @@ function apiMiddleware(root, opts = {}) {
|
|
|
4553
4539
|
if (!b || typeof b.capture !== "string" || !CAPTURE_ID.test(b.capture) || typeof b.frame !== "string") return json(res, 400, { error: "expected { capture, frame, theme?, viewport? }" });
|
|
4554
4540
|
if (readCapture(root, b.capture)) return json(res, 409, { error: "that capture is sealed" });
|
|
4555
4541
|
const theme = typeof b.theme === "string" && /^[a-z0-9-]+$/i.test(b.theme) ? b.theme : "light";
|
|
4556
|
-
const { shootFrame } = await import("./shot-
|
|
4542
|
+
const { shootFrame } = await import("./shot-G0bBXwHl.mjs").then((n) => n.u);
|
|
4557
4543
|
const origin = opts.origin?.() ?? `http://${req.headers.host ?? "localhost"}`;
|
|
4558
4544
|
const vp = typeof b.viewport === "string" ? opts.viewports?.[b.viewport] : void 0;
|
|
4559
4545
|
const dim = (v) => typeof v === "number" && Number.isFinite(v) ? Math.round(v) : void 0;
|
|
@@ -5682,7 +5668,7 @@ function marverPlugin(ctx) {
|
|
|
5682
5668
|
server.httpServer?.once("close", () => resetPdf(root));
|
|
5683
5669
|
server.middlewares.use((req, res, next) => {
|
|
5684
5670
|
if (!(req.url ?? "").startsWith(`/__mv/handout/`)) return next();
|
|
5685
|
-
import("./pdf-
|
|
5671
|
+
import("./pdf-6JNQAKJv.mjs").then((m) => m.handoutMiddleware()(req, res, next), next);
|
|
5686
5672
|
});
|
|
5687
5673
|
server.middlewares.use(apiMiddleware(root, {
|
|
5688
5674
|
viewports: config.viewports,
|
|
@@ -5968,7 +5954,7 @@ function marverPlugin(ctx) {
|
|
|
5968
5954
|
});
|
|
5969
5955
|
return;
|
|
5970
5956
|
}
|
|
5971
|
-
const { shootFrame, shootBatch, resolveFrames } = await import("./shot-
|
|
5957
|
+
const { shootFrame, shootBatch, resolveFrames } = await import("./shot-G0bBXwHl.mjs").then((n) => n.u);
|
|
5972
5958
|
if (ways[0] === "frame") {
|
|
5973
5959
|
if (typeof spec.frame !== "string") {
|
|
5974
5960
|
write({
|
|
@@ -1,4 +1,4 @@
|
|
|
1
|
-
import { i as capture, m as findChrome } from "./shot-
|
|
1
|
+
import { i as capture, m as findChrome } from "./shot-G0bBXwHl.mjs";
|
|
2
2
|
import { constants, copyFileSync, existsSync, mkdtempSync, realpathSync, rmSync, writeFileSync } from "node:fs";
|
|
3
3
|
import { basename, dirname, join, sep } from "node:path";
|
|
4
4
|
import { pathToFileURL } from "node:url";
|
|
@@ -1,6 +1,6 @@
|
|
|
1
1
|
import { o as slideSize } from "./cli.mjs";
|
|
2
|
-
import { l as ASK_MAX, u as bakeBatch } from "./plugin-
|
|
3
|
-
import { m as findChrome, s as planShot } from "./shot-
|
|
2
|
+
import { l as ASK_MAX, u as bakeBatch } from "./plugin-C1SEQSU5.mjs";
|
|
3
|
+
import { m as findChrome, s as planShot } from "./shot-G0bBXwHl.mjs";
|
|
4
4
|
import { MIME } from "./serve-kcF6-H8V.mjs";
|
|
5
5
|
import { copyFileSync, lstatSync, mkdirSync, readFileSync, realpathSync, rmSync, statSync, writeFileSync } from "node:fs";
|
|
6
6
|
import { extname, isAbsolute, join, relative, resolve } from "node:path";
|
|
@@ -1,6 +1,6 @@
|
|
|
1
1
|
import { r as NAME } from "./cli.mjs";
|
|
2
2
|
import { d as recoverTarget, r as legacyEntry, u as recoverEntries, v as workspaceId } from "./slots-BOcfIqxy.mjs";
|
|
3
|
-
import { DevStartError, dev } from "./dev-
|
|
3
|
+
import { DevStartError, dev } from "./dev-Kfv8FgVw.mjs";
|
|
4
4
|
//#region src/cli/recover.ts
|
|
5
5
|
/**
|
|
6
6
|
* `marver dev --recover` (spec 28 A1.6). A Jam capture the page could not send waits in that browser's
|
|
@@ -524,8 +524,8 @@ async function shootFrame(opts) {
|
|
|
524
524
|
};
|
|
525
525
|
const plan = planShot(frame, viewports, size);
|
|
526
526
|
if (frame.kind !== "html") try {
|
|
527
|
-
const { scanAssetRefs } = await import("./build-
|
|
528
|
-
const { ensurePoster } = await import("./poster-
|
|
527
|
+
const { scanAssetRefs } = await import("./build-C1AGScLz.mjs");
|
|
528
|
+
const { ensurePoster } = await import("./poster-BO971KQR.mjs");
|
|
529
529
|
const refs = scanAssetRefs(readFileSync(join(root, frame.file), "utf8"), frame.file);
|
|
530
530
|
for (const r of refs) if (r.endsWith(".poster.png")) await ensurePoster(join(root, "design", "assets"), r.slice(0, -11));
|
|
531
531
|
} catch {}
|
|
@@ -105,7 +105,7 @@ resolving each one by hand - Jam's questions, reviews and failed runs on them ar
|
|
|
105
105
|
live work: a thread Jam is queued or working on is left open and counted ("2 left open: work in
|
|
106
106
|
progress"). The notice says how many, with **Undo**: it reopens each thread nothing happened in since - no
|
|
107
107
|
reply, edit, reaction, resolve or reopen ("1 changed since - left as is"); what Jam finished stays finished. From the terminal: `npx marver
|
|
108
|
-
comments resolve --all --board <b>` (`--folder`, `--scene`, `--canvas`, `--dry-run`), then `--undo <op>`
|
|
108
|
+
comments resolve --all --board <b>` (`--folder`, `--scene`, `--frame`, `--canvas`, `--dry-run`), then `--undo <op>`
|
|
109
109
|
with the op it prints. Missed the notice's Undo (it shows for 10 seconds)? Every run is kept as
|
|
110
110
|
`design/.local/comment-ops/<op>.json` (its `scope` and `at` say which), and `npx marver comments resolve --undo <op>`
|
|
111
111
|
undoes it. On the board you have open, it saves your latest edits first; while they are not saved it resolves nothing
|
package/docs/slides.md
CHANGED
|
@@ -89,6 +89,14 @@ same from the canvas, and `--notes` prints a handout with each slide's notes. Gl
|
|
|
89
89
|
soft shadows - the effects Chrome prints wrong - are fixed slide by slide and checked against the screen. See
|
|
90
90
|
[Deck PDFs](pdf.md).
|
|
91
91
|
|
|
92
|
+
## A deck in another presentation tool
|
|
93
|
+
|
|
94
|
+
Ask your agent to replicate the deck in Google Slides, PowerPoint, Keynote, Canva or any presentation tool it can
|
|
95
|
+
drive through a good MCP or API. It rebuilds every slide there from the tool's native components, one element at a
|
|
96
|
+
time (every text a text box, every shape a shape, every line a line, every image an image) so anyone can edit it and
|
|
97
|
+
work on it together. It never pastes pictures of slides. It anchors each text box to the middle so the text lines up
|
|
98
|
+
as on the slide, checks each rebuilt slide against the original, and tells you anything it could not rebuild natively.
|
|
99
|
+
|
|
92
100
|
## Motion
|
|
93
101
|
|
|
94
102
|
Motion is yours to write. While a deck plays, the stage puts
|
package/package.json
CHANGED
|
@@ -1,6 +1,6 @@
|
|
|
1
1
|
{
|
|
2
2
|
"name": "@marver-design/marver",
|
|
3
|
-
"version": "0.
|
|
3
|
+
"version": "0.34.0",
|
|
4
4
|
"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.",
|
|
5
5
|
"type": "module",
|
|
6
6
|
"private": false,
|
|
@@ -44,7 +44,7 @@ file in design/instructions/ - they are short, strict, and part of this contract
|
|
|
44
44
|
| Review | before presenting anything | instructions/review.md |
|
|
45
45
|
| Boards | creating a board, choosing what ships | instructions/boards.md |
|
|
46
46
|
| Context | any question about what the product does or what is live; a behaviour change; a deploy; no `context/` yet | instructions/context.md |
|
|
47
|
-
| Slides | a deck is asked for; a PDF of a deck or of any board, a flow too (`npx marver pdf <board>`, then give back the path it prints); or `slide: true` frames exist | instructions/slides.md + design/slides.md |
|
|
47
|
+
| Slides | a deck is asked for; a PDF of a deck or of any board, a flow too (`npx marver pdf <board>`, then give back the path it prints); the deck replicated in another presentation tool (Google Slides, PowerPoint, Keynote, Canva...: native elements, never pictures of slides); or `slide: true` frames exist | instructions/slides.md + design/slides.md |
|
|
48
48
|
| Publish | deploying the canvas: gate, volume, accounts, invites | instructions/publish.md |
|
|
49
49
|
| Live Jam | responding to an `@marver` comment (a spawned job), or a "Live Jam: ... new request" message (below) - run `npx marver jam next`; on by default - confirm it names YOUR tool | instructions/jam.md |
|
|
50
50
|
|
|
@@ -311,10 +311,10 @@ The human reviews on the canvas, not in the chat - so the reply puts them there:
|
|
|
311
311
|
badges are noisy, ask - with the count per board it prints ("38 open: launch-plan 22,
|
|
312
312
|
checkout-compare 16 - resolve them?"). A frame on two boards counts on both. Only on a yes, and only for what
|
|
313
313
|
they said yes to: one board is `npx marver comments resolve --all --board <b>`, a folder
|
|
314
|
-
`--folder <f>`, a scene `--scene <s>`, everything `--canvas` (the only scope that also takes
|
|
314
|
+
`--folder <f>`, a scene `--scene <s>`, one frame `--frame <scene/frame>`, everything `--canvas` (the only scope that also takes
|
|
315
315
|
threads with no frame or on a frame that is gone; `--scene` takes its frames whether or not a board shows them). `--dry-run` counts first. Give them the `--undo` line it
|
|
316
316
|
prints. It never touches what Jam is working on, and the human has the same in every board,
|
|
317
|
-
folder and scene menu ("Resolve all comments") and on the Mac app's tab. Never on your own.
|
|
317
|
+
folder and scene menu ("Resolve all comments"), on a frame's row ("Resolve comments") and on the Mac app's tab. Never on your own.
|
|
318
318
|
- **Undo a resolve-all later.** The canvas's Undo notice lasts 10 seconds. After that, each run
|
|
319
319
|
is kept as `design/.local/comment-ops/<op>.json` (its `scope` and `at` say which; skip the
|
|
320
320
|
`.undo.json` files): `npx marver comments resolve --undo <op>` reopens each thread nothing
|
|
@@ -44,7 +44,7 @@ file in design/instructions/ - they are short, strict, and part of this contract
|
|
|
44
44
|
| Review | before presenting anything | instructions/review.md |
|
|
45
45
|
| Boards | creating a board, choosing what ships | instructions/boards.md |
|
|
46
46
|
| Context | any question about what the product does or what is live; a behaviour change; a deploy; no `context/` yet | instructions/context.md |
|
|
47
|
-
| Slides | a deck is asked for; a PDF of a deck or of any board, a flow too (`npx marver pdf <board>`, then give back the path it prints); or `slide: true` frames exist | instructions/slides.md + design/slides.md |
|
|
47
|
+
| Slides | a deck is asked for; a PDF of a deck or of any board, a flow too (`npx marver pdf <board>`, then give back the path it prints); the deck replicated in another presentation tool (Google Slides, PowerPoint, Keynote, Canva...: native elements, never pictures of slides); or `slide: true` frames exist | instructions/slides.md + design/slides.md |
|
|
48
48
|
| Publish | deploying the canvas: gate, volume, accounts, invites | instructions/publish.md |
|
|
49
49
|
| Live Jam | responding to an `@marver` comment (a spawned job), or a "Live Jam: ... new request" message (below) - run `npx marver jam next`; on by default - confirm it names YOUR tool | instructions/jam.md |
|
|
50
50
|
|
|
@@ -310,10 +310,10 @@ The human reviews on the canvas, not in the chat - so the reply puts them there:
|
|
|
310
310
|
badges are noisy, ask - with the count per board it prints ("38 open: launch-plan 22,
|
|
311
311
|
checkout-compare 16 - resolve them?"). A frame on two boards counts on both. Only on a yes, and only for what
|
|
312
312
|
they said yes to: one board is `npx marver comments resolve --all --board <b>`, a folder
|
|
313
|
-
`--folder <f>`, a scene `--scene <s>`, everything `--canvas` (the only scope that also takes
|
|
313
|
+
`--folder <f>`, a scene `--scene <s>`, one frame `--frame <scene/frame>`, everything `--canvas` (the only scope that also takes
|
|
314
314
|
threads with no frame or on a frame that is gone; `--scene` takes its frames whether or not a board shows them). `--dry-run` counts first. Give them the `--undo` line it
|
|
315
315
|
prints. It never touches what Jam is working on, and the human has the same in every board,
|
|
316
|
-
folder and scene menu ("Resolve all comments") and on the Mac app's tab. Never on your own.
|
|
316
|
+
folder and scene menu ("Resolve all comments"), on a frame's row ("Resolve comments") and on the Mac app's tab. Never on your own.
|
|
317
317
|
- **Undo a resolve-all later.** The canvas's Undo notice lasts 10 seconds. After that, each run
|
|
318
318
|
is kept as `design/.local/comment-ops/<op>.json` (its `scope` and `at` say which; skip the
|
|
319
319
|
`.undo.json` files): `npx marver comments resolve --undo <op>` reopens each thread nothing
|
|
@@ -199,7 +199,7 @@ The discipline:
|
|
|
199
199
|
Many open at once is the human's to clear, never yours: past ten open
|
|
200
200
|
(`npx marver marks` counts them per board), ask - and only on a yes run
|
|
201
201
|
`npx marver comments resolve --all --board <b>` (`--folder`, `--scene`,
|
|
202
|
-
`--canvas`; `--dry-run` counts first; it prints its `--undo`). It skips
|
|
202
|
+
`--frame`, `--canvas`; `--dry-run` counts first; it prints its `--undo`). It skips
|
|
203
203
|
every thread Jam is working on.
|
|
204
204
|
6. **A frame with open comments is load-bearing - never delete, rename, or
|
|
205
205
|
gut it.** Its threads are anchored to elements INSIDE it; restructure the
|
|
@@ -0,0 +1,44 @@
|
|
|
1
|
+
# Replicating a deck in a third-party tool
|
|
2
|
+
|
|
3
|
+
Run this when the human wants a Marver deck rebuilt in another presentation
|
|
4
|
+
tool, so other people can edit it and work on it together. It works in any
|
|
5
|
+
tool your session can drive through a good MCP or API: Google Slides,
|
|
6
|
+
PowerPoint (or a `.pptx` file you write), Keynote, Canva, and the like. Use
|
|
7
|
+
the human's own access, and say what you will create, and where, before you
|
|
8
|
+
create it. A PDF is not this (slides.md, "A deck as a PDF").
|
|
9
|
+
|
|
10
|
+
## The rule: native and atomic
|
|
11
|
+
|
|
12
|
+
Rebuild every slide from the tool's own components, one element at a time:
|
|
13
|
+
every text a text box, every shape a shape, every line a line (a divider or
|
|
14
|
+
rule too, even one the slide draws as a thin box), every table a table, every chart a chart (or the shapes and text that draw it), every
|
|
15
|
+
image an image. Never paste a picture of a slide, or of any part of one that
|
|
16
|
+
holds text, shapes or lines. A picture is only for what was a picture on the
|
|
17
|
+
slide already: a photo, an illustration. The test is simple: a colleague
|
|
18
|
+
clicks any word or shape and changes it.
|
|
19
|
+
|
|
20
|
+
Keep it one to one: the same positions, sizes, fonts, colours, line breaks
|
|
21
|
+
and stacking as the slide. Read them off the rendered slide (open it alone at
|
|
22
|
+
its stage size, `/__mv/frame/?id=<scene/frame>`, and measure), not from the
|
|
23
|
+
code. Scale every length to the tool's page, font sizes included. Group what
|
|
24
|
+
moves together, such as a card and its label. Copy each slide's speaker notes.
|
|
25
|
+
|
|
26
|
+
## The trap: text centred vertically
|
|
27
|
+
|
|
28
|
+
What you measure in the browser and what the tool draws place text
|
|
29
|
+
differently: the browser sets glyphs inside the line height, a slide tool
|
|
30
|
+
from the top of its box, after an inner padding you often cannot see. Text
|
|
31
|
+
lands too high or too low, and the layout no longer lines up.
|
|
32
|
+
|
|
33
|
+
So **anchor every text box to the middle**, put the box's centre on the
|
|
34
|
+
centre of the text you measured, and make the box a little taller than the
|
|
35
|
+
text. The text then sits where the slide had it, whatever the tool's padding
|
|
36
|
+
and font metrics. Keep the slide's line breaks and turn autofit off.
|
|
37
|
+
|
|
38
|
+
## Check it, then say what differs
|
|
39
|
+
|
|
40
|
+
Render each rebuilt slide in the tool and compare it with
|
|
41
|
+
`npx marver shot <scene/frame>`. Fix what moved. Then tell the human where
|
|
42
|
+
the deck is and anything that is not native or not exact: a picture you
|
|
43
|
+
kept and why, a font their readers must install, an effect the tool cannot
|
|
44
|
+
draw.
|
|
@@ -16,6 +16,7 @@ mechanics of how a slide plays. Take what serves the deck in front of you.
|
|
|
16
16
|
|---|---|
|
|
17
17
|
| reference/deck-story.md | intake is thin or rich, the room is senior, the slide list reads like a table of contents, or the words need work |
|
|
18
18
|
| reference/deck-layouts.md | a slide needs a composition and none comes - an idea bank, plus rebuilding an existing deck and chart craft |
|
|
19
|
+
| reference/deck-replicate.md | the deck is replicated in another presentation tool (Google Slides, PowerPoint, Keynote, Canva...) for others to edit |
|
|
19
20
|
| craft.md + its references | a slide's type, colour, layout or motion feels off - reference/typography.md, color.md, motion.md and slop.md hold for slides as for screens |
|
|
20
21
|
|
|
21
22
|
## What a slide is
|
|
@@ -349,6 +350,13 @@ size and time; each line under it names slides that need a look:
|
|
|
349
350
|
The PDF is the finished slide, as at rest: another reason every slide must
|
|
350
351
|
show its final composition without `data-sl-play` (Motion, above).
|
|
351
352
|
|
|
353
|
+
## A deck in another presentation tool
|
|
354
|
+
|
|
355
|
+
When the human wants the deck in Google Slides, PowerPoint, Keynote, Canva
|
|
356
|
+
or another tool with a good MCP or API, so others can edit it, rebuild it
|
|
357
|
+
there from native, atomic elements - never pictures of slides. Read
|
|
358
|
+
reference/deck-replicate.md before the first slide.
|
|
359
|
+
|
|
352
360
|
## design/slides.md - this project's deck look
|
|
353
361
|
|
|
354
362
|
The project's own file: the deck look (master, tones, type, mark, imagery,
|