@marver-design/marver 0.30.1 → 0.31.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 +58 -0
- package/README.md +11 -7
- package/dist/{anchor-check-Bv4o-R2T.mjs → anchor-check-B92s9tVv.mjs} +1 -1
- package/dist/{board-tree-BXR8dw4b.mjs → board-tree-DGj0HhEE.mjs} +6 -2
- package/dist/{boards-EH2onUXM.mjs → boards-Cim1GTKc.mjs} +32 -2
- package/dist/{boards-BeWtjGUM.mjs → boards-OlAhZ87x.mjs} +7 -7
- package/dist/{build-zWGXSzly.mjs → build-BNssmbqd.mjs} +14 -17
- package/dist/{capture-DEtM4qm5.mjs → capture-HaS-1or8.mjs} +1 -1
- package/dist/cli.mjs +38 -20
- package/dist/{collab-BEAcXrBb.mjs → collab-D2NcrOB8.mjs} +53 -14
- package/dist/comment-actions-Bxf9Ld4g.mjs +351 -0
- package/dist/{comments-XNhMmSSu.mjs → comments-BakJQwaf.mjs} +85 -10
- package/dist/config-B0YcFtqS.mjs +510 -0
- package/dist/{context-BUnFiyA3.mjs → context-Cj2TcC0H.mjs} +3 -3
- package/dist/{daemon-CChgWJNq.mjs → daemon-MxoEQajX.mjs} +222 -23
- package/dist/deep-link-DYtuT740.mjs +163 -0
- package/dist/{dev-DOgIITpT.mjs → dev-BBZe_brH.mjs} +23 -16
- package/dist/devices-uJZ2inMq.mjs +155 -0
- package/dist/{events-CLH4ijKP.mjs → events-Dieo1482.mjs} +49 -4
- package/dist/{init-CYlFaRzG.mjs → init-BgusplYn.mjs} +40 -10
- package/dist/{jam-Cj5gBvwD.mjs → jam-CkuLL8A8.mjs} +1 -1
- package/dist/{link-BFFRgrMt.mjs → link-Cmt9Xy4X.mjs} +54 -7
- package/dist/{logo-CXY-1yrn.mjs → logo-C9s7-Cy9.mjs} +89 -66
- package/dist/{ls-NqmePKOf.mjs → ls-DGVIW-Io.mjs} +1 -1
- package/dist/{manifest-DPZ3WNg_.mjs → manifest-CK8Qh4Nq.mjs} +255 -13
- package/dist/{marks-BnNANic9.mjs → marks-C8oX8kbE.mjs} +3 -3
- package/dist/{marks-DBp3h1Mc.mjs → marks-Dt-5JXCp.mjs} +18 -5
- package/dist/{marver-id-gate-vBLb_Icb.mjs → marver-id-gate-BAeuMeaU.mjs} +11 -7
- package/dist/md-B9_13Q0R.mjs +105 -0
- package/dist/notes-CRAX4wgk.mjs +148 -0
- package/dist/own-C8Mq0Hnf.mjs +128 -0
- package/dist/pdf-0m721FFn.mjs +117 -0
- package/dist/pdf-CZENT6t3.mjs +2299 -0
- package/dist/{perf-BCxAo0IS.mjs → perf-BB0XNt1M.mjs} +1 -1
- package/dist/{perf-6MOTHxay.mjs → perf-CIMijND6.mjs} +5 -5
- package/dist/{plugin-CFWBcAba.mjs → plugin-CL8_wL7a.mjs} +460 -83
- package/dist/{poster-DPPpQiva.mjs → poster-B7uSjlEP.mjs} +1 -1
- package/dist/{profile-B1FKOM1e.mjs → profile-cdmSer1k.mjs} +1 -1
- package/dist/{publish-bakes-_Zx8crP3.mjs → publish-bakes-BjgDNeyS.mjs} +3 -3
- package/dist/{queue-DeSQm24g.mjs → queue-BLLfdlDw.mjs} +156 -11
- package/dist/{recover-mDUVsnPd.mjs → recover-ByuFQOF9.mjs} +2 -2
- package/dist/{serve-DQv3Ti6X.mjs → serve-kcF6-H8V.mjs} +4 -4
- package/dist/{session-VDJfXEEm.mjs → session-DBF-nQvq.mjs} +29 -3
- package/dist/{share-Bu_kuOKL.mjs → share-CS2mg27O.mjs} +1 -1
- package/dist/{shot-d4h_hJi9.mjs → shot-BqwkdtKn.mjs} +4 -4
- package/dist/{shot-DBWN8hPP.mjs → shot-D2TQGo2V.mjs} +1 -1
- package/dist/show-B1u3DiJw.mjs +101 -0
- package/dist/{sizes-wjXDev3b.mjs → sizes-BckcL4Zz.mjs} +1 -1
- package/dist/{slots-Dn4Onb0V.mjs → slots-BOcfIqxy.mjs} +15 -3
- package/dist/{summary-Y8MY1Wuc.mjs → summary-cPmRDGpX.mjs} +1 -1
- package/dist/{sync-CMozOwZ0.mjs → sync-BNWwh8OF.mjs} +205 -7
- package/dist/{work-BYWD_1Zf.mjs → work-DRdzXPvg.mjs} +3 -3
- package/dist/{work-DJxH7cCX.mjs → work-Nv-n2_Un.mjs} +1 -1
- package/docs/app.md +49 -0
- package/docs/boards-and-folders.md +37 -6
- package/docs/jam-session.md +5 -0
- package/docs/live-jam.md +9 -0
- package/docs/pdf.md +108 -0
- package/docs/publish.md +9 -9
- package/docs/sharing.md +11 -0
- package/docs/slides.md +9 -0
- package/package.json +3 -1
- package/src/client/content/index.tsx +4 -2
- package/src/client/frame-host/main.tsx +3 -0
- package/src/client/shell/App.tsx +71 -24
- package/src/client/shell/BoardList.tsx +16 -7
- package/src/client/shell/Comments.tsx +77 -16
- package/src/client/shell/Play.tsx +24 -22
- package/src/client/shell/Toolbar.tsx +4 -3
- package/src/client/shell/app-bridge.ts +32 -5
- package/src/client/shell/canvas/Canvas.tsx +30 -8
- package/src/client/shell/canvas/FrameNode.tsx +3 -1
- package/src/client/shell/canvas/ctl.ts +16 -0
- package/src/client/shell/commands.ts +20 -0
- package/src/client/shell/comments-store.ts +81 -2
- package/src/client/shell/devices.tsx +42 -0
- package/src/client/shell/goto.ts +56 -9
- package/src/client/shell/icons.tsx +11 -4
- package/src/client/shell/jam-lines.ts +5 -3
- package/src/client/shell/jam-panel.tsx +17 -5
- package/src/client/shell/marks-ui.tsx +54 -0
- package/src/client/shell/notes.ts +21 -0
- package/src/client/shell/pdf-export.tsx +154 -0
- package/src/client/shell/pdf-notes.ts +20 -0
- package/src/client/shell/show.ts +250 -0
- package/src/client/shell/store.ts +23 -38
- package/src/client/shell/styles.css +43 -0
- package/src/shared/app-api.ts +49 -4
- package/src/shared/auto-place.ts +32 -0
- package/src/shared/board-tree.ts +3 -0
- package/src/shared/board-types.ts +6 -2
- package/src/shared/deep-link.ts +212 -0
- package/src/shared/devices.ts +89 -0
- package/src/shared/events.ts +48 -5
- package/src/shared/export-plan.ts +98 -0
- package/templates/AGENTS-embedded.md +76 -12
- package/templates/AGENTS-studio.md +76 -12
- package/templates/instructions/boards.md +6 -5
- package/templates/instructions/configure.md +32 -2
- package/templates/instructions/iterate.md +8 -0
- package/templates/instructions/jam.md +9 -0
- package/templates/instructions/publish.md +14 -4
- package/templates/instructions/review.md +4 -0
- package/templates/instructions/slides.md +67 -1
- package/templates/instructions/welcome.md +9 -5
- package/templates/playbooks/publish-canvas/PLAYBOOK.md +1 -1
- package/dist/config-BezZTiov.mjs +0 -182
|
@@ -1,9 +1,9 @@
|
|
|
1
1
|
import { t as __exportAll } from "./rolldown-runtime-8H4AJuhK.mjs";
|
|
2
|
-
import {
|
|
2
|
+
import { i as marverHome } from "./slots-BOcfIqxy.mjs";
|
|
3
|
+
import { n as deletedMessages, r as diffEvents } from "./events-Dieo1482.mjs";
|
|
3
4
|
import { a as readLog, i as listBoards, t as appendEvents } from "./comments-0BSbb04K.mjs";
|
|
4
5
|
import { t as CLI_TOKEN_CHARS } from "./auth-Dix8wrXV.mjs";
|
|
5
|
-
import {
|
|
6
|
-
import { chmodSync, closeSync, existsSync, mkdirSync, openSync, readFileSync, realpathSync, renameSync, unlinkSync, writeSync } from "node:fs";
|
|
6
|
+
import { chmodSync, closeSync, existsSync, mkdirSync, openSync, readFileSync, realpathSync, renameSync, unlinkSync, writeFileSync, writeSync } from "node:fs";
|
|
7
7
|
import { join } from "node:path";
|
|
8
8
|
import { createHash, randomBytes } from "node:crypto";
|
|
9
9
|
//#region src/server/sync.ts
|
|
@@ -23,13 +23,20 @@ import { createHash, randomBytes } from "node:crypto";
|
|
|
23
23
|
* which is traded for one and then forgotten.
|
|
24
24
|
*/
|
|
25
25
|
var sync_exports = /* @__PURE__ */ __exportAll({
|
|
26
|
+
admitted: () => admitted,
|
|
27
|
+
bindIdentity: () => bindIdentity,
|
|
26
28
|
connect: () => connect,
|
|
27
29
|
connectClaim: () => connectClaim,
|
|
28
30
|
connectToken: () => connectToken,
|
|
31
|
+
heldWords: () => heldWords,
|
|
32
|
+
identityBindings: () => identityBindings,
|
|
29
33
|
loadCollab: () => loadCollab,
|
|
30
34
|
localOnlyThreads: () => localOnlyThreads,
|
|
35
|
+
readHeld: () => readHeld,
|
|
31
36
|
saveCollab: () => saveCollab,
|
|
32
|
-
|
|
37
|
+
serverCapabilities: () => serverCapabilities,
|
|
38
|
+
syncOnce: () => syncOnce,
|
|
39
|
+
unauthorized: () => unauthorized
|
|
33
40
|
});
|
|
34
41
|
/**
|
|
35
42
|
* The credential does not live in the repository.
|
|
@@ -137,6 +144,10 @@ async function syncOnce(root, collab) {
|
|
|
137
144
|
if (bres.status === 401) throw new Error("the connect token was rejected - run `comments connect` again");
|
|
138
145
|
if (!bres.ok) throw new Error(`published canvas answered ${bres.status} - is it up?`);
|
|
139
146
|
const { rights, legacy } = await bres.json();
|
|
147
|
+
const myId = await fetch(`${base}/__mv/api/me`, { headers: auth }).then(async (r) => r.ok ? (await r.json()).id : void 0, () => void 0);
|
|
148
|
+
if (myId && collab.email) bindIdentity(root, base, collab.email, myId);
|
|
149
|
+
const bindings = identityBindings(root, base);
|
|
150
|
+
const caps = await serverCapabilities(base, auth);
|
|
140
151
|
const boards = [.../* @__PURE__ */ new Set([
|
|
141
152
|
...Object.keys(rights),
|
|
142
153
|
...listBoards(dir),
|
|
@@ -144,6 +155,7 @@ async function syncOnce(root, collab) {
|
|
|
144
155
|
])];
|
|
145
156
|
const out = {};
|
|
146
157
|
const failures = [];
|
|
158
|
+
const held = {};
|
|
147
159
|
for (const board of boards) {
|
|
148
160
|
const old = legacy?.board === board;
|
|
149
161
|
if (!(board in rights) && !old) continue;
|
|
@@ -153,13 +165,21 @@ async function syncOnce(root, collab) {
|
|
|
153
165
|
continue;
|
|
154
166
|
}
|
|
155
167
|
const { events: remote } = await res.json();
|
|
156
|
-
const pulled = appendEvents(dir, board, remote).length;
|
|
168
|
+
const pulled = appendEvents(dir, board, admitted(readLog(dir, board), remote, bindings)).length;
|
|
157
169
|
let pushed = 0;
|
|
158
170
|
if (rights[board] === "comment" || old) {
|
|
159
171
|
const local = readLog(dir, board);
|
|
160
172
|
const marverThreads = localOnlyThreads(local);
|
|
161
173
|
const shipped = old ? threadIds(local, (e) => legacy.frames.includes(e.frame ?? "")) : null;
|
|
162
|
-
const
|
|
174
|
+
const gone = deletedMessages([...local, ...remote]);
|
|
175
|
+
const candidates = diffEvents(local, remote.map((e) => e.id)).filter((e) => !e.agent && !marverThreads.has(threadOf(e)) && (!shipped || shipped.has(threadOf(e))) && (caps.delete || e.type !== "delete") && !(e.type === "edit" && gone.has(e.commentId ?? "")));
|
|
176
|
+
const keptHere = unauthorized(candidates, [...local, ...remote], {
|
|
177
|
+
email: collab.email,
|
|
178
|
+
id: myId
|
|
179
|
+
});
|
|
180
|
+
if (keptHere.length) held[board] = keptHere;
|
|
181
|
+
const keep = new Set(keptHere.map((h) => h.id));
|
|
182
|
+
const missing = candidates.filter((e) => !keep.has(e.id));
|
|
163
183
|
for (let i = 0; i < missing.length; i += 100) {
|
|
164
184
|
const r = await fetch(`${base}/__mv/api/comments/${board}`, {
|
|
165
185
|
method: "POST",
|
|
@@ -175,12 +195,190 @@ async function syncOnce(root, collab) {
|
|
|
175
195
|
}
|
|
176
196
|
out[board] = {
|
|
177
197
|
pulled,
|
|
178
|
-
pushed
|
|
198
|
+
pushed,
|
|
199
|
+
...held[board]?.length ? { held: held[board].length } : {}
|
|
179
200
|
};
|
|
180
201
|
}
|
|
202
|
+
saveHeld(root, held);
|
|
181
203
|
if (failures.length) throw new Error(`sync incomplete - ${failures.join(" · ")}`);
|
|
182
204
|
return out;
|
|
183
205
|
}
|
|
206
|
+
function unauthorized(events, log, account) {
|
|
207
|
+
const acct = typeof account === "string" ? { email: account } : account ?? {};
|
|
208
|
+
const myEmail = (acct.email ?? "").toLowerCase(), myId = acct.id ?? "";
|
|
209
|
+
if (!myEmail && !myId) return [];
|
|
210
|
+
const mine = (a) => a?.email ? myEmail ? a.email.toLowerCase() === myEmail : null : a?.id ? myId ? a.id === myId : null : false;
|
|
211
|
+
const authorOf = /* @__PURE__ */ new Map();
|
|
212
|
+
const rootOf = /* @__PURE__ */ new Map();
|
|
213
|
+
for (const e of [...log, ...events]) {
|
|
214
|
+
if ((e.type === "create" || e.type === "reply") && e.commentId && !authorOf.has(e.commentId)) authorOf.set(e.commentId, e.author);
|
|
215
|
+
if (e.type === "reply" && e.commentId && e.parentId) rootOf.set(e.commentId, e.parentId);
|
|
216
|
+
if (e.type === "create" && e.commentId) rootOf.set(e.commentId, e.commentId);
|
|
217
|
+
}
|
|
218
|
+
const byAuthor = /* @__PURE__ */ new Set([
|
|
219
|
+
"create",
|
|
220
|
+
"reply",
|
|
221
|
+
"react",
|
|
222
|
+
"edit",
|
|
223
|
+
"reanchor",
|
|
224
|
+
"profile",
|
|
225
|
+
"delete"
|
|
226
|
+
]);
|
|
227
|
+
const held = /* @__PURE__ */ new Map();
|
|
228
|
+
for (const e of events) {
|
|
229
|
+
let why = null;
|
|
230
|
+
if (byAuthor.has(e.type) && mine(e.author) === false) why = "another-account";
|
|
231
|
+
else if ((e.type === "edit" || e.type === "delete" || e.type === "reanchor") && mine(authorOf.get(e.commentId ?? "")) === false) why = "message-of-another-account";
|
|
232
|
+
if (why) held.set(e.id, {
|
|
233
|
+
id: e.id,
|
|
234
|
+
type: e.type,
|
|
235
|
+
why
|
|
236
|
+
});
|
|
237
|
+
}
|
|
238
|
+
for (let grew = true; grew;) {
|
|
239
|
+
grew = false;
|
|
240
|
+
const keptMsgs = new Set(events.filter((e) => held.has(e.id) && (e.type === "create" || e.type === "reply") && e.commentId).map((e) => e.commentId));
|
|
241
|
+
const keptThreads = new Set([...keptMsgs].map((m) => rootOf.get(m) ?? m).filter((m) => keptMsgs.has(m)));
|
|
242
|
+
for (const e of events) {
|
|
243
|
+
if (held.has(e.id)) continue;
|
|
244
|
+
const target = e.type === "reply" ? e.parentId : e.commentId;
|
|
245
|
+
const root = target ? rootOf.get(target) ?? target : "";
|
|
246
|
+
if (target && keptMsgs.has(target) || root && keptThreads.has(root)) {
|
|
247
|
+
held.set(e.id, {
|
|
248
|
+
id: e.id,
|
|
249
|
+
type: e.type,
|
|
250
|
+
why: "thread-kept-here"
|
|
251
|
+
});
|
|
252
|
+
grew = true;
|
|
253
|
+
}
|
|
254
|
+
}
|
|
255
|
+
}
|
|
256
|
+
return events.filter((e) => held.has(e.id)).map((e) => held.get(e.id));
|
|
257
|
+
}
|
|
258
|
+
/**
|
|
259
|
+
* Identity bindings (Codex r9): an address and the opaque id a published canvas gives it, learned only from that canvas's
|
|
260
|
+
* own `/me`, signed in as that address - never from an event, whose ids anyone may choose. Per canvas origin, kept in
|
|
261
|
+
* `design/.local/identity-bindings.json` (never synced) so a reconnect under another address still recognises the first
|
|
262
|
+
* one's messages as the server projects them.
|
|
263
|
+
*/
|
|
264
|
+
const bindingsFile = (root) => join(root, "design", ".local", "identity-bindings.json");
|
|
265
|
+
const readBindings = (root) => {
|
|
266
|
+
try {
|
|
267
|
+
const v = JSON.parse(readFileSync(bindingsFile(root), "utf8"));
|
|
268
|
+
return v && typeof v === "object" && !Array.isArray(v) ? v : {};
|
|
269
|
+
} catch {
|
|
270
|
+
return {};
|
|
271
|
+
}
|
|
272
|
+
};
|
|
273
|
+
const originOf = (base) => {
|
|
274
|
+
try {
|
|
275
|
+
return new URL(base).origin;
|
|
276
|
+
} catch {
|
|
277
|
+
return base.replace(/\/+$/, "");
|
|
278
|
+
}
|
|
279
|
+
};
|
|
280
|
+
function identityBindings(root, base) {
|
|
281
|
+
const all = readBindings(root);
|
|
282
|
+
const here = Object.hasOwn(all, originOf(base)) ? all[originOf(base)] : {};
|
|
283
|
+
const out = Object.create(null);
|
|
284
|
+
for (const [email, id] of Object.entries(here ?? {})) if (typeof id === "string" && /^[0-9a-f]{24}$/.test(id)) out[email.toLowerCase()] = id;
|
|
285
|
+
return out;
|
|
286
|
+
}
|
|
287
|
+
function bindIdentity(root, base, email, id) {
|
|
288
|
+
if (!/^[0-9a-f]{24}$/.test(id) || !email) return;
|
|
289
|
+
const all = readBindings(root);
|
|
290
|
+
const o = originOf(base);
|
|
291
|
+
const here = Object.assign(Object.create(null), Object.hasOwn(all, o) ? all[o] : {});
|
|
292
|
+
if (here[email.toLowerCase()] === id) return;
|
|
293
|
+
here[email.toLowerCase()] = id;
|
|
294
|
+
try {
|
|
295
|
+
mkdirSync(join(root, "design", ".local"), { recursive: true });
|
|
296
|
+
writeFileSync(bindingsFile(root), JSON.stringify({
|
|
297
|
+
...all,
|
|
298
|
+
[o]: here
|
|
299
|
+
}, null, 1) + "\n", { mode: 384 });
|
|
300
|
+
} catch {}
|
|
301
|
+
}
|
|
302
|
+
const heldFile = (root) => join(root, "design", ".local", "sync-held.json");
|
|
303
|
+
/** The last exchange's kept events, per board - what `marver comments sync` says, and what stays until you change it. */
|
|
304
|
+
function saveHeld(root, held) {
|
|
305
|
+
try {
|
|
306
|
+
if (!Object.keys(held).length) {
|
|
307
|
+
if (existsSync(heldFile(root))) unlinkSync(heldFile(root));
|
|
308
|
+
return;
|
|
309
|
+
}
|
|
310
|
+
mkdirSync(join(root, "design", ".local"), { recursive: true });
|
|
311
|
+
writeFileSync(heldFile(root), JSON.stringify({
|
|
312
|
+
at: Date.now(),
|
|
313
|
+
boards: held
|
|
314
|
+
}, null, 1) + "\n");
|
|
315
|
+
} catch {}
|
|
316
|
+
}
|
|
317
|
+
/** "1 edit kept local: written under another account" - one line per board and reason. */
|
|
318
|
+
function heldWords(held) {
|
|
319
|
+
const by = /* @__PURE__ */ new Map();
|
|
320
|
+
for (const h of held) by.set(h.why, [...by.get(h.why) ?? [], h]);
|
|
321
|
+
const what = (hs) => {
|
|
322
|
+
const types = [...new Set(hs.map((h) => h.type))];
|
|
323
|
+
const n = hs.length;
|
|
324
|
+
return types.length === 1 ? `${n} ${types[0]}${n === 1 ? "" : "s"}` : `${n} events`;
|
|
325
|
+
};
|
|
326
|
+
const words = {
|
|
327
|
+
"another-account": "written under another account",
|
|
328
|
+
"message-of-another-account": "its comment was written under another account",
|
|
329
|
+
"thread-kept-here": "its thread is kept local"
|
|
330
|
+
};
|
|
331
|
+
return [...by].map(([why, hs]) => `${what(hs)} kept local: ${words[why]}`);
|
|
332
|
+
}
|
|
333
|
+
function readHeld(root) {
|
|
334
|
+
try {
|
|
335
|
+
return JSON.parse(readFileSync(heldFile(root), "utf8")).boards ?? {};
|
|
336
|
+
} catch {
|
|
337
|
+
return {};
|
|
338
|
+
}
|
|
339
|
+
}
|
|
340
|
+
/** What a server's comment API takes (`GET /__mv/api/capabilities`, 0.31): anything but a JSON answer that says so
|
|
341
|
+
* (an older server's 404, its gate page) is an older server - nothing new is sent to it. */
|
|
342
|
+
async function serverCapabilities(base, headers = {}) {
|
|
343
|
+
try {
|
|
344
|
+
const r = await fetch(`${base.replace(/\/+$/, "")}/__mv/api/capabilities`, { headers });
|
|
345
|
+
if (!r.ok || !(r.headers.get("content-type") ?? "").includes("application/json")) return { delete: false };
|
|
346
|
+
return { delete: (await r.json())?.delete === true };
|
|
347
|
+
} catch {
|
|
348
|
+
return { delete: false };
|
|
349
|
+
}
|
|
350
|
+
}
|
|
351
|
+
/** What of a pull may join the local log (spec 31, Codex r4): the server validated each event against ITS log, which
|
|
352
|
+
* never held this machine's own messages (Marver's notes, captures - never pushed). So a message id already here is
|
|
353
|
+
* one message's: another event claiming it as a new message is refused, and an edit or a delete of it must come from
|
|
354
|
+
* its original author - never touching Marver's or a local-only message at all. */
|
|
355
|
+
function admitted(local, remote, bindings = {}) {
|
|
356
|
+
const msgs = /* @__PURE__ */ new Map();
|
|
357
|
+
for (const e of local) if ((e.type === "create" || e.type === "reply") && e.commentId && !msgs.has(e.commentId)) msgs.set(e.commentId, e);
|
|
358
|
+
const theirs = /* @__PURE__ */ new Map();
|
|
359
|
+
for (const e of remote) if (e && (e.type === "create" || e.type === "reply") && e.commentId && !theirs.has(e.commentId)) theirs.set(e.commentId, e);
|
|
360
|
+
const key = (a) => (a?.email ?? a?.id ?? "").toLowerCase();
|
|
361
|
+
const localIds = new Set(local.map((e) => e.id));
|
|
362
|
+
const offLimits = localOnlyThreads(local);
|
|
363
|
+
const out = [];
|
|
364
|
+
for (const e of remote) {
|
|
365
|
+
if (!e || typeof e.id !== "string" || localIds.has(e.id)) {
|
|
366
|
+
out.push(e);
|
|
367
|
+
continue;
|
|
368
|
+
}
|
|
369
|
+
if ((e.type === "create" || e.type === "reply") && e.commentId) {
|
|
370
|
+
if (msgs.has(e.commentId)) continue;
|
|
371
|
+
msgs.set(e.commentId, e);
|
|
372
|
+
} else if ((e.type === "edit" || e.type === "delete") && e.commentId) {
|
|
373
|
+
const orig = msgs.get(e.commentId), there = theirs.get(e.commentId);
|
|
374
|
+
if (!orig || !there || there.id !== orig.id || orig.agent || offLimits.has(e.commentId)) continue;
|
|
375
|
+
if (!(orig.author?.email && there.author?.email ? key(orig.author) === key(there.author) : orig.author?.id && there.author?.id ? orig.author.id === there.author.id : !!orig.author?.email && !!there.author?.id ? Object.hasOwn(bindings, key(orig.author)) && bindings[key(orig.author)] === there.author.id : !!orig.author?.id && !!there.author?.email && Object.hasOwn(bindings, key(there.author)) && bindings[key(there.author)] === orig.author.id)) continue;
|
|
376
|
+
if (!key(e.author) || key(e.author) !== key(there.author)) continue;
|
|
377
|
+
}
|
|
378
|
+
out.push(e);
|
|
379
|
+
}
|
|
380
|
+
return out;
|
|
381
|
+
}
|
|
184
382
|
/** The account endpoints live BEHIND the canvas gate (the outer READ boundary), so
|
|
185
383
|
* connecting passes the gate first when a canvas password is set. */
|
|
186
384
|
async function gateCookie(base, canvasPassword) {
|
|
@@ -1,6 +1,6 @@
|
|
|
1
1
|
import { r as NAME } from "./cli.mjs";
|
|
2
|
-
import { i as readDevInfo, n as WORK_TTL_MAX, t as WORK_TTL_DEFAULT } from "./work-
|
|
3
|
-
import { unreachable } from "./link-
|
|
2
|
+
import { i as readDevInfo, n as WORK_TTL_MAX, t as WORK_TTL_DEFAULT } from "./work-Nv-n2_Un.mjs";
|
|
3
|
+
import { unreachable } from "./link-Cmt9Xy4X.mjs";
|
|
4
4
|
//#region src/cli/work.ts
|
|
5
5
|
/**
|
|
6
6
|
* `marver work` - the coding agent's hand on the canvas working state.
|
|
@@ -68,7 +68,7 @@ async function workCommand(root, action, frames, opts) {
|
|
|
68
68
|
});
|
|
69
69
|
console.log(active.length ? `still working: ${active.join(", ")}` : "nothing working - all clear");
|
|
70
70
|
const done = before.filter((f) => !active.includes(f));
|
|
71
|
-
const { links, hints } = done.length ? await (await import("./link-
|
|
71
|
+
const { links, hints } = done.length ? await (await import("./link-Cmt9Xy4X.mjs")).handBack(root, done) : {
|
|
72
72
|
links: [],
|
|
73
73
|
hints: []
|
|
74
74
|
};
|
|
@@ -1,5 +1,5 @@
|
|
|
1
1
|
import { t as __exportAll } from "./rolldown-runtime-8H4AJuhK.mjs";
|
|
2
|
-
import {
|
|
2
|
+
import { l as listBoardFiles } from "./boards-Cim1GTKc.mjs";
|
|
3
3
|
import { r as pidRuns } from "./exclusive-B1RtpeeP.mjs";
|
|
4
4
|
import { mkdirSync, readFileSync, rmSync, writeFileSync } from "node:fs";
|
|
5
5
|
import { join } from "node:path";
|
package/docs/app.md
CHANGED
|
@@ -72,6 +72,45 @@ appears here, with its own tab, a second after it starts."), and for a repo with
|
|
|
72
72
|
@marver-design/marver && npx marver init` first. Each command has a button that copies it. Every canvas running on
|
|
73
73
|
this Mac gets its own tab; `⌘L`, or Home's field, opens a link - a local canvas's, or a shared canvas's.
|
|
74
74
|
|
|
75
|
+
A canvas's tab and Home card wear its name and its logo: `name` in its `design/config.ts` (else `share.name`, else
|
|
76
|
+
the folder's name) and `logo` (else `share.logo`, else the first of `design/logo.svg|png`, `public/logo.svg|png`,
|
|
77
|
+
`public/favicon.svg|png|ico`, else Marver's mark). A canvas still on its folder's name or Marver's mark looks like
|
|
78
|
+
every other one in the strip, so `marver dev` says so on its boot line.
|
|
79
|
+
|
|
80
|
+
## Links into the app
|
|
81
|
+
|
|
82
|
+
When Marver is open with a canvas in a tab, `npx marver link` prints a `marver://` link for that canvas instead of its
|
|
83
|
+
localhost one, and an agent hands you that. Click it anywhere - the terminal, a chat, a note - and Marver comes forward
|
|
84
|
+
on that board, the frames selected and in view:
|
|
85
|
+
|
|
86
|
+
- **The canvas's tab is already open:** Marver never reloads it. The tab moves to the place the link names, as
|
|
87
|
+
`marver show` does - and if you were typing a comment or a Jam edit there, it stays put and says "Your agent wants
|
|
88
|
+
to show you <the frame> · Go" instead, so nothing you typed is lost.
|
|
89
|
+
- **It has no tab yet:** a tab opens on that place.
|
|
90
|
+
- **The canvas is not running:** Home opens with its card first, highlighted, and its start command ready to copy.
|
|
91
|
+
|
|
92
|
+
A link names its canvas by its folder, and only a canvas running from that same folder opens it - never another canvas
|
|
93
|
+
that took the same port later. A link that names no place Marver understands opens the canvas on its board.
|
|
94
|
+
`marver link` gives the `marver://` link only while Marver is in use (it keeps `~/.marver/state/app-live.json` fresh
|
|
95
|
+
every 30 seconds) with that canvas open in a tab; otherwise, and with `--web`, the localhost link.
|
|
96
|
+
|
|
97
|
+
## A tab's badge and menu
|
|
98
|
+
|
|
99
|
+
Each canvas's tab shows an orange count of what needs you (Marver's questions, captures to review, runs that failed or
|
|
100
|
+
stalled), else a blue dot when frames are new since you looked (no number, from 1.1), else a shimmer while an agent
|
|
101
|
+
works. Right-click the tab of a canvas on this Mac for **Mark All as Seen** and, with Marver 0.31 or later, **Resolve
|
|
102
|
+
All Comments**: every open conversation on that canvas, never what Jam is working on, with Undo. [What the marks
|
|
103
|
+
mean](boards-and-folders.md#what-is-new-what-needs-you).
|
|
104
|
+
|
|
105
|
+
## Home
|
|
106
|
+
|
|
107
|
+
- **Running canvases** each have a card; one whose Marver has a newer release says "0.31.0 available" with the command
|
|
108
|
+
that updates it, in its own folder, ready to copy.
|
|
109
|
+
- **Recently here** lists the canvases that ran before, with their logo and start command - not those in a temporary
|
|
110
|
+
folder (`/tmp`, `/private/tmp`, `/var/folders`), which are tests and scratch copies.
|
|
111
|
+
- **Shared canvases** show their name and logo once Marver has opened them once (read from the canvas's own
|
|
112
|
+
`meta.json`, through that tab's sign-in).
|
|
113
|
+
|
|
75
114
|
## What it asks, and when
|
|
76
115
|
|
|
77
116
|
- **Notices.** Nothing touches macOS's notices or the Dock before you choose. The first time a canvas needs you while
|
|
@@ -126,6 +165,16 @@ Check for Updates…:
|
|
|
126
165
|
[the disk image](https://github.com/TNEP4/marver-app/releases/latest/download/Marver-arm64.dmg) again, open it,
|
|
127
166
|
drag Marver into Applications and choose Replace. Your settings and tabs stay.
|
|
128
167
|
|
|
168
|
+
## Exporting a PDF
|
|
169
|
+
|
|
170
|
+
**File > Export PDF…** (app 1.1, a canvas on Marver 0.31 or later) prints the open board as a PDF - one page per slide
|
|
171
|
+
([Deck PDFs](pdf.md)) - and, when it is ready, opens a save panel on `~/Downloads/<board>.pdf`. The canvas's own Export
|
|
172
|
+
PDF (a board's menu, slides and present mode's toolbar) saves the same way in the app. The canvas sends the app only
|
|
173
|
+
the finished job's id: the app fetches the file itself from that canvas, checks it is a PDF of 200 MB at most, checks
|
|
174
|
+
again that the tab still shows the same canvas page after you chose where to save, and writes it whole.
|
|
175
|
+
In app 1.0.1 (no File > Export PDF…), the canvas's Export PDF ends on a notice with **Download**: 1.0.1 cancels a
|
|
176
|
+
download its window did not start while in front, so the file waits for that click rather than for the last page.
|
|
177
|
+
|
|
129
178
|
## The performance report
|
|
130
179
|
|
|
131
180
|
When Marver is slow, crashes or flashes, a report helps find out why. **Help > Export Performance Report…** (also on a
|
|
@@ -78,8 +78,9 @@ The sidebar shows where to look.
|
|
|
78
78
|
- **One slot per row.** Every row keeps the one item at its right edge it has today, and what matters
|
|
79
79
|
most takes it: the bubble first, then the row's own count or status, then a frame's dot. A board
|
|
80
80
|
you are not on turns blue when its frames hold something new, and the bubble takes its status
|
|
81
|
-
glyph's place until answered. A closed folder
|
|
82
|
-
something inside is new,
|
|
81
|
+
glyph's place until answered. A closed folder shows the bubble when something inside waits on you,
|
|
82
|
+
else a blue dot when something inside is new, else nothing - never a number for new: it is not a
|
|
83
|
+
to-do count (0.31). An open folder shows how many boards it holds. A folded scene keeps its frame count, blue when something inside is new.
|
|
83
84
|
- **`U`** goes to the next frame that asks you something, then the next one waiting on you, then the
|
|
84
85
|
next new one.
|
|
85
86
|
|
|
@@ -94,15 +95,31 @@ a scene, board or folder - for the version on screen: a change still loading (or
|
|
|
94
95
|
focus or play) stays new until its new version shows, and a look you made while it loaded counts as
|
|
95
96
|
soon as it does.
|
|
96
97
|
|
|
98
|
+
**Resolve all comments** sits beside every **Mark all as seen** - a board's, a folder's, a scene's,
|
|
99
|
+
and the Mac app's tab menu - for when the bubbles are noise (0.31). It resolves what that row shows,
|
|
100
|
+
never a log: a board's every open thread on the frames it shows, a folder's over all its boards and
|
|
101
|
+
sub-folders, a scene's on its frames, the tab's every open thread on the canvas. It is the same as
|
|
102
|
+
resolving each one by hand - Jam's questions, reviews and failed runs on them are finished - except
|
|
103
|
+
live work: a thread Jam is queued or working on is left open and counted ("2 left open: work in
|
|
104
|
+
progress"). The notice says how many, with **Undo**: it reopens each thread nothing happened in since - no
|
|
105
|
+
reply, edit, reaction, resolve or reopen ("1 changed since - left as is"); what Jam finished stays finished. From the terminal: `npx marver
|
|
106
|
+
comments resolve --all --board <b>` (`--folder`, `--scene`, `--canvas`, `--dry-run`), then `--undo <op>`
|
|
107
|
+
with the op it prints. Missed the notice's Undo (it shows for 10 seconds)? Every run is kept as
|
|
108
|
+
`design/.local/comment-ops/<op>.json` (its `scope` and `at` say which), and `npx marver comments resolve --undo <op>`
|
|
109
|
+
undoes it. On the board you have open, it saves your latest edits first; while they are not saved it resolves nothing
|
|
110
|
+
and says so ("this board's latest changes are not saved yet"). A published canvas has no Resolve all of its own: run it
|
|
111
|
+
here, and each thread it resolves reaches the published canvas with the next sync.
|
|
112
|
+
|
|
97
113
|
The marks start when `marver dev` starts, so whatever your agent makes before you open the canvas is
|
|
98
114
|
new when you do; everything already there the first time counts as seen. They live in
|
|
99
115
|
`design/.local/`, on this machine only, and a published canvas shows none. `npx marver marks` prints
|
|
100
|
-
them - for you, or for your agent at the start of a session.
|
|
116
|
+
them, and the open conversations per board - for you, or for your agent at the start of a session.
|
|
101
117
|
|
|
102
118
|
**In the Mac app** (0.3, with Marver 0.29), each canvas's tab sums this up, even while it is hidden: an
|
|
103
119
|
orange count of what needs you - Marver's questions, captures to review, runs that failed or stalled -
|
|
104
|
-
else a blue
|
|
105
|
-
|
|
120
|
+
else a blue dot for new frames (no number, from app 1.1), else a shimmer while an agent works, and a teal
|
|
121
|
+
dot while a Jam session runs. Its right-click menu holds **Resolve All Comments** beside **Mark All as
|
|
122
|
+
Seen** for a canvas on Marver 0.31 or later. Turn notices on and a canvas you are not looking at sends one when something new needs you, and the
|
|
106
123
|
Dock counts them all. Clicking a notice opens what it names where you can see it, on its board: a question
|
|
107
124
|
in its thread on the frame (Play left and hidden pins shown for it), or in a panel with a field to answer
|
|
108
125
|
when no frame on the board holds it; a review in its review; a failed run with Retry in view, a stalled
|
|
@@ -274,7 +291,21 @@ last); frames that sit on several boards get one link per board, and a frame on
|
|
|
274
291
|
instead of a link. `--board` picks one. The link reads `#/b/<board>?f=<scene/frame>,...` (or
|
|
275
292
|
`?s=<scene>` for a whole scene), and a link naming a frame its board does not show follows the
|
|
276
293
|
frame to where it lives. `npx marver work done` prints the same links for the frames it clears, so an
|
|
277
|
-
agent's reply ends with them.
|
|
294
|
+
agent's reply ends with them. When the Mac app has this canvas open in a tab, each of them is a `marver://` link that
|
|
295
|
+
opens it there ([Links into the app](app.md#links-into-the-app)); `--web` prints the localhost link anyway.
|
|
296
|
+
|
|
297
|
+
## Showing you a place
|
|
298
|
+
|
|
299
|
+
`npx marver show <scene/frame | scene ... | board>` (needs `marver dev`) moves every tab where this canvas is open to
|
|
300
|
+
that place - its board, selected, the camera fitted, even when it is already there - and in the Mac app brings that tab
|
|
301
|
+
and the window forward. A name alone is a board, fitted whole, when no frame or scene has that name. `--thread <id>`
|
|
302
|
+
opens a comment thread there too; frames on two boards are refused (show one board at a time). A tab where you are
|
|
303
|
+
typing (a comment, a Jam edit) or recording a capture does not move: it says "Your agent wants to show you <title> ·
|
|
304
|
+
Go", and Go takes you. Click, pan or press a key while it is on its way and yours wins: it stops. The command waits 3
|
|
305
|
+
seconds and says "shown in 2 tabs" (or "not shown - no open tab took it" when no tab answered), then prints the link. Agents run it only
|
|
306
|
+
when you ask to be shown; otherwise they give the link.
|
|
307
|
+
|
|
308
|
+
A focus link (`#/f/<frame>`) opened on your dev canvas now has its way
|
|
278
309
|
back to the canvas (the grid button, or Esc); on a published canvas a focus link stays a page of
|
|
279
310
|
its own.
|
|
280
311
|
|
package/docs/jam-session.md
CHANGED
|
@@ -229,6 +229,11 @@ Threads live in `design/comments/<board>.jsonl`, which is committed with the res
|
|
|
229
229
|
comment would. They never reach a published canvas: `marver build` and `marver comments sync`
|
|
230
230
|
leave capture threads (and Marver's notes and replies) on your machine. The session
|
|
231
231
|
**record** your agent writes goes to `context/sessions/`, also meant to be committed.
|
|
232
|
+
|
|
233
|
+
In its thread, a capture's own comment can be deleted but not edited (0.31): Jam keeps the words it took, so an edit
|
|
234
|
+
would change what you see and never what your agent gets. Deleting it withdraws a capture your agent has not been
|
|
235
|
+
handed yet, as deleting a tagged comment does ([A deleted comment](live-jam.md#a-deleted-comment-031)); its tile reads
|
|
236
|
+
"Withdrawn capture".
|
|
232
237
|
Published canvases carry none of Jam: no captures, no queue, no microphone.
|
|
233
238
|
|
|
234
239
|
## A capture left on an old address
|
package/docs/live-jam.md
CHANGED
|
@@ -251,6 +251,15 @@ The larger caution is unchanged and worth stating plainly: `marver dev` imports
|
|
|
251
251
|
`design/config.ts`, so running a dev server in a repo you do not trust is already running
|
|
252
252
|
that repo's code. Live Jam adds no new hole to that; it does not make it safe.
|
|
253
253
|
|
|
254
|
+
### A deleted comment (0.31)
|
|
255
|
+
|
|
256
|
+
Delete one of your messages and Jam lets go of it: a request still queued drops it (a card left with no
|
|
257
|
+
request is dropped), and a run that has not been handed to the agent yet - a card is "working" while its
|
|
258
|
+
pictures are taken - has the message taken out of its packet, per message, history included; a frozen packet
|
|
259
|
+
recovered after a restart is rebuilt the same way. Work already handed to an agent cannot unread it: a
|
|
260
|
+
deleted message it read is in that run's context, though its reply never quotes it back. `marver comments
|
|
261
|
+
list` and the context the agent reads never show a deleted message's words.
|
|
262
|
+
|
|
254
263
|
## Provenance
|
|
255
264
|
|
|
256
265
|
Every jam reply is stamped with who acted: your dev user, the harness that ran, and the
|
package/docs/pdf.md
ADDED
|
@@ -0,0 +1,108 @@
|
|
|
1
|
+
# Deck PDFs
|
|
2
|
+
|
|
3
|
+
`npx marver pdf <board>` turns a board into a PDF: one page per slide, exactly what the stage shows, with real text you
|
|
4
|
+
can search and copy, vector shapes, and links that click. The running `marver dev` makes it with your own Chrome, so
|
|
5
|
+
what prints is the frame your agent built - fonts, images, charts and all.
|
|
6
|
+
|
|
7
|
+
```sh
|
|
8
|
+
npx marver pdf pitch # design/exports/pitch.pdf
|
|
9
|
+
npx marver pdf pitch --notes # design/exports/pitch-notes.pdf - a handout with the speaker notes
|
|
10
|
+
npx marver pdf pitch --theme dark --out ~/Desktop/pitch.pdf
|
|
11
|
+
```
|
|
12
|
+
|
|
13
|
+
On the canvas: **Export PDF** in a board's menu (right-click it in the sidebar), and the export button in slides and
|
|
14
|
+
present mode's toolbar, which prints in the theme the stage shows. A notice shows the page it is on, with Cancel; the
|
|
15
|
+
file downloads when it is done. In the Mac app, **File > Export PDF…** does the same for the open board and asks where
|
|
16
|
+
to save it. App 1.0.1 has no save panel for it: there the notice keeps the finished PDF and offers **Download**, since
|
|
17
|
+
that app drops a download its window did not start while in front. The canvas exports with the
|
|
18
|
+
defaults: the handout (`--notes`), `--paper`, `--raster`, `--vector`, `--keep-going` and `--out` are the command's.
|
|
19
|
+
|
|
20
|
+
## What goes in the PDF
|
|
21
|
+
|
|
22
|
+
- **A slides board** (its publish row plays it as slides) prints its deck: its `slide: true` frames in reading order -
|
|
23
|
+
top to bottom, then left to right - each once, as slides mode plays them. The publish row decides, not the mode you
|
|
24
|
+
are in: a board with no such row prints as any other board below, even from slides mode's export button. A board's
|
|
25
|
+
own type (`"type": "deck"` in its JSON) does not decide it either.
|
|
26
|
+
- **Any other board** prints its frames in the board's order, as Play walks them, html frames included. A slide frame
|
|
27
|
+
is its stage size on any board; any other frame is printed at the device Play shows it at - the viewport whose width
|
|
28
|
+
is its node's on the board, else the frame's own viewport, else the first - at that viewport's height.
|
|
29
|
+
- **Each page is the slide's own size** (1280×720 is 13.33 × 7.5 in), margins zero. A slide taller than its stage is
|
|
30
|
+
cut where the stage cuts it, and the report names it *clipped*.
|
|
31
|
+
- **The finished slide.** Entrances show their end state (the PDF is never "playing"), animations are stopped where
|
|
32
|
+
they end - an infinite one at its first pose, so a spinning mark rests upright - and a video shows its first frame.
|
|
33
|
+
Motion driven by your own `requestAnimationFrame` code cannot be stopped from outside: it prints as it is two frames
|
|
34
|
+
after the slide settles.
|
|
35
|
+
- **Screen styles, not print styles.** `@media print` and Tailwind's `print:` are ignored: the page is the slide you see.
|
|
36
|
+
- **Images at full resolution.** Every image is printed from its original file, never the downscaled copy the canvas
|
|
37
|
+
shows while you zoom.
|
|
38
|
+
- **Bookmarks** - one per page, named by the frame's title - and the PDF's title (the board's), author (the canvas's
|
|
39
|
+
name) and creator (`Marver x.y.z`).
|
|
40
|
+
- **Theme**: `--theme` when you give one, else the theme pinned on the frame's node, else the frame's own, else light.
|
|
41
|
+
|
|
42
|
+
## Effects Chrome cannot print
|
|
43
|
+
|
|
44
|
+
Some CSS effects come out wrong when Chrome prints: a frosted-glass `backdrop-filter` prints transparent, a `filter`,
|
|
45
|
+
`mix-blend-mode` or a CSS `mask` prints as a grey box, a large soft `box-shadow` prints as a hard grey rectangle, and a
|
|
46
|
+
`<canvas>` or `<video>` may print blank. (A `filter` that is only `drop-shadow()` prints right, and is left as it is.)
|
|
47
|
+
Marver fixes each one element by element, and checks its own work:
|
|
48
|
+
|
|
49
|
+
- **Glass** keeps its children live (text, links, icons stay vector and selectable); only the blurred backdrop behind it
|
|
50
|
+
becomes a picture, taken at 3x (lowered for a large slide so one picture stays under 16 megapixels: 2.75x at
|
|
51
|
+
1920×1080, 1x at 4096×4096).
|
|
52
|
+
- **A filtered, blended or masked box, a canvas, a video** becomes a 3x picture of itself, including the shadow or blur
|
|
53
|
+
that spills past its edge; any link inside it stays clickable.
|
|
54
|
+
- **A large soft shadow** is redrawn as a stack of sharp vector shadows that follows the blur's falloff - no picture
|
|
55
|
+
at all.
|
|
56
|
+
- **An effect on the page itself** (a filter or blend on `body` or `html`) has nothing to be patched into: that page is
|
|
57
|
+
printed as a 3x picture, and the report says why. So is an effect under a rotation or a skew.
|
|
58
|
+
|
|
59
|
+
Then the fixed page is compared with the unfixed screenshot, taken before anything was prepared for print. A fix that
|
|
60
|
+
changes more than 1 % of its own area, or anything outside it, is thrown away and that page is printed as a 3x picture
|
|
61
|
+
instead (*raster*). Every printed page is also rasterised (macOS `sips`) and compared with the screen - pixel by pixel,
|
|
62
|
+
allowing only the edge differences two renderers make, and area by area - which catches anything that only goes wrong
|
|
63
|
+
in print: such a page becomes a picture too. Where there is no rasteriser (not on a Mac), the report says *screen-certified only*.
|
|
64
|
+
|
|
65
|
+
`--raster` prints every page as a picture at that same scale (no vector text). `--vector` fixes nothing: every page exactly as Chrome
|
|
66
|
+
prints it (a page whose print differs from the screen is named, and kept).
|
|
67
|
+
|
|
68
|
+
## The report
|
|
69
|
+
|
|
70
|
+
```
|
|
71
|
+
design/exports/mark-ii.pdf - 32 pages, 2.7 MB, 17.8 s
|
|
72
|
+
patched: mark-ii/12-chat (::after mix-blend-mode: soft-light; mask-image), mark-ii/17b-navigation-views (backdrop-filter; box-shadow)
|
|
73
|
+
every page print-certified (rasterised and compared with the screen)
|
|
74
|
+
```
|
|
75
|
+
|
|
76
|
+
Each kind of slide that needs a look is named: **skipped** (a frame the manifest no longer lists, or a non-slide frame
|
|
77
|
+
on a slides board), **failed**, **patched** (and with what), **raster** (and why), **unsettled** (still loading images or
|
|
78
|
+
charts after 10 s - printed anyway), **clipped**, **spilled** (Chrome made more than one page; the first is kept),
|
|
79
|
+
**changed while printing** (its source changed while it rendered and again on the second try, or the frame left the
|
|
80
|
+
board), and with `--vector` **printed differently from the screen** (kept as Chrome printed it). The last line says
|
|
81
|
+
whether every page was print-certified, or screen-certified only. `--json` prints all of it, slide by slide, with the
|
|
82
|
+
file's absolute path.
|
|
83
|
+
|
|
84
|
+
A slide that fails to render fails the export - a PDF is never handed over with a page missing. `--keep-going` prints
|
|
85
|
+
the rest and leaves the failed page blank, named in the report. The command then exits 1, though the PDF is written.
|
|
86
|
+
|
|
87
|
+
## The handout (`--notes`)
|
|
88
|
+
|
|
89
|
+
`--notes` prints a handout instead: each slide's picture, its title, and its notes (the frame's `.note.md`, rendered as
|
|
90
|
+
Markdown at 11 pt or more) - "No notes" where there are none. Long notes continue on the next page. Letter landscape by
|
|
91
|
+
default, `--paper a4` for A4. Page numbers in the footer, a bookmark per slide. The slides in a handout are pictures:
|
|
92
|
+
the deck PDF is the one you search.
|
|
93
|
+
|
|
94
|
+
## What it does not do
|
|
95
|
+
|
|
96
|
+
- **Not a tagged (accessible) PDF**: the pages are merged with pdf-lib, which keeps each page but not Chrome's structure
|
|
97
|
+
tree. The handout, printed as one document, is tagged.
|
|
98
|
+
- **Links between slides** (`data-goto`) do not carry over; `https:` and `mailto:` links do.
|
|
99
|
+
- **Published canvases** cannot export: the build has no browser. Export from `marver dev`.
|
|
100
|
+
- A CJK character may copy out of the PDF as its compatibility form (a Kangxi radical) - how Chrome's font subsets map
|
|
101
|
+
it; it displays and prints right.
|
|
102
|
+
|
|
103
|
+
## Limits
|
|
104
|
+
|
|
105
|
+
One PDF at a time per canvas (a second is refused, naming the one running). 300 pages at most, a page side of 4096 CSS
|
|
106
|
+
px at most, 15 minutes, 500 MB. The job's folder (`design/.local/pdf/`) keeps only the finished file, for an hour, and
|
|
107
|
+
is emptied when `marver dev` starts. `marver init` keeps `design/exports/` out of git. The Mac app saves a PDF of 200 MB
|
|
108
|
+
at most; a larger one says "not saved (too-large)": export it with `npx marver pdf`.
|
package/docs/publish.md
CHANGED
|
@@ -251,14 +251,14 @@ mention from the page metadata, the sign-in screens included).
|
|
|
251
251
|
|
|
252
252
|
### Name the canvas
|
|
253
253
|
|
|
254
|
-
`
|
|
255
|
-
labels the brand pill,
|
|
256
|
-
canvas emits, so site analytics can tell which
|
|
257
|
-
falls back to your `package.json` name and the
|
|
258
|
-
directory name - which inside a container is usually `app`, so
|
|
259
|
-
containerised canvas reports as one campaign.
|
|
260
|
-
|
|
261
|
-
Your logo - `share.logo`, else the first of `design/logo.svg|png`, `public/logo.svg|png`
|
|
254
|
+
`name: "Your App"` in `design/config.ts` (`share: { name }` still works; `name` wins). That
|
|
255
|
+
name titles the gate, labels the brand pill, names the canvas in the Mac app, and becomes
|
|
256
|
+
`utm_campaign` on every powered-by link the canvas emits, so site analytics can tell which
|
|
257
|
+
canvas sent a visitor. Unset, the gate falls back to your `package.json` name and the
|
|
258
|
+
canvas shell to the root directory name - which inside a container is usually `app`, so
|
|
259
|
+
every unnamed containerised canvas reports as one campaign.
|
|
260
|
+
|
|
261
|
+
Your logo - `logo` in the config, else `share.logo`, else the first of `design/logo.svg|png`, `public/logo.svg|png`
|
|
262
262
|
and `public/favicon.svg|png|ico` - ships with the build. The gate shows it, and since
|
|
263
263
|
0.29 it is the only tab icon of the canvas and the gate, so a browser tab (and the Mac
|
|
264
264
|
app's tab for a shared canvas) wears it rather than Marver's mark. With no logo, the tab
|
|
@@ -283,7 +283,7 @@ Deploy. The repo itself is the deployable - nothing to export, nothing to sync.
|
|
|
283
283
|
FROM node:22-slim
|
|
284
284
|
RUN apt-get update && apt-get install -y --no-install-recommends chromium fonts-liberation \
|
|
285
285
|
&& rm -rf /var/lib/apt/lists/* # the browser `marver build` compiles the glass textures with
|
|
286
|
-
WORKDIR /app # set
|
|
286
|
+
WORKDIR /app # set name in design/config.ts - the fallback name is this directory
|
|
287
287
|
COPY . .
|
|
288
288
|
RUN npm ci && npx marver build # as root in a container: marver adds Chrome's --no-sandbox itself
|
|
289
289
|
ENV PORT=8080
|
package/docs/sharing.md
CHANGED
|
@@ -276,6 +276,17 @@ board". Note the gate's own entry check short-circuits step 1 for the owner - th
|
|
|
276
276
|
owner is always admitted so the canvas can be administered - which is the one
|
|
277
277
|
place the blocklist does not have the last word.
|
|
278
278
|
|
|
279
|
+
### What `comment` lets a person do with a thread
|
|
280
|
+
|
|
281
|
+
Anyone with `comment` on a board may write, reply, react, and **resolve or reopen any thread** on it - not only
|
|
282
|
+
their own. Editing and deleting a message stays its author's: the canvas compares the address of whoever wrote
|
|
283
|
+
the original comment or reply with the signed-in account's (0.31 adds delete; a deleted message's replies stay,
|
|
284
|
+
under "Comment deleted"). A canvas older than 0.31 takes no deletes: a delete made on your machine waits there,
|
|
285
|
+
held back by `marver dev`'s sync, until the canvas is upgraded, and its shell offers no Delete. Connected under a new
|
|
286
|
+
address, an edit or delete of a comment the old address wrote (or anything still signed with the old address) stays on
|
|
287
|
+
your machine - the canvas would refuse it - and `marver comments sync` says so ("1 edit kept local: its comment was
|
|
288
|
+
written under another account"); everything else still syncs.
|
|
289
|
+
|
|
279
290
|
## Mail, mentions, and the bell (v1.1)
|
|
280
291
|
|
|
281
292
|
Sharing's mail rides one relay at the identity service, and the canvas can only
|
package/docs/slides.md
CHANGED
|
@@ -79,6 +79,15 @@ the chrome) and Fill window (edge to edge). Publish it with:
|
|
|
79
79
|
|
|
80
80
|
Viewers land straight in the deck; the URL survives refresh and back.
|
|
81
81
|
|
|
82
|
+
## A deck as a PDF
|
|
83
|
+
|
|
84
|
+
`npx marver pdf <board>` writes `design/exports/<board>.pdf`: one page per slide in the deck's order, vector text and
|
|
85
|
+
shapes, links that click, a bookmark per slide. The deck's order needs the board's publish row above (`"type": "slides"`
|
|
86
|
+
or `"open": "slides"`); without it the PDF prints every frame, in the board's order. **Export PDF** in the board's menu and in slides mode's toolbar do the
|
|
87
|
+
same from the canvas, and `--notes` prints a handout with each slide's notes. Glass, filters, blends, masks and large
|
|
88
|
+
soft shadows - the effects Chrome prints wrong - are fixed slide by slide and checked against the screen. See
|
|
89
|
+
[Deck PDFs](pdf.md).
|
|
90
|
+
|
|
82
91
|
## Motion
|
|
83
92
|
|
|
84
93
|
Motion is yours to write. While a deck plays, the stage puts
|