@marver-design/marver 0.30.0 → 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 +74 -0
- package/README.md +11 -7
- package/dist/{anchor-check-c52IDkiQ.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-C3mUtjEn.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-B0Wi1OQ3.mjs → daemon-MxoEQajX.mjs} +223 -26
- package/dist/deep-link-DYtuT740.mjs +163 -0
- package/dist/{dev-5dlxoW28.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-CXRoMA8g.mjs → plugin-CL8_wL7a.mjs} +519 -112
- package/dist/{poster-CYmCa00B.mjs → poster-B7uSjlEP.mjs} +1 -1
- package/dist/{profile-B1FKOM1e.mjs → profile-cdmSer1k.mjs} +1 -1
- package/dist/{publish-bakes-C_2ZtHou.mjs → publish-bakes-BjgDNeyS.mjs} +3 -3
- package/dist/{queue-DeSQm24g.mjs → queue-BLLfdlDw.mjs} +156 -11
- package/dist/{recover-XD8iXJOj.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-CRRGgxru.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/performance.md +2 -1
- 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/recorder.ts +3 -2
- package/src/client/shell/show.ts +250 -0
- package/src/client/shell/store.ts +79 -48
- 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
|
@@ -64,7 +64,9 @@ without narrating into the void; your next message is the reveal.
|
|
|
64
64
|
execution - assume, mark UNCONFIRMED, surface it first.) Once they confirm,
|
|
65
65
|
write that understanding as one sentence into `description` in
|
|
66
66
|
design/config.ts - the project's line in design/manifest.json, the first
|
|
67
|
-
thing every later session reads
|
|
67
|
+
thing every later session reads - and set `name` there to the product's
|
|
68
|
+
name as they say it (init's guess reads "Tms broker"; configure.md step 6
|
|
69
|
+
also gives the canvas its real logo).
|
|
68
70
|
2. **Confirm the stack aloud - what detection ACTUALLY found.** Read AGENTS.md's
|
|
69
71
|
UI line and design/theme.css and narrate the reality, for example: "Tailwind
|
|
70
72
|
+ shadcn/ui; brand tokens in <file>; design/theme.css imports them." No
|
|
@@ -110,10 +112,12 @@ Deliver conversationally when the first draft is ready - a short guided
|
|
|
110
112
|
message, not a manual. The canvas must be running: `npx marver ls` lists it.
|
|
111
113
|
Not yet? Ask the person to run `npx marver dev` in their own terminal - a
|
|
112
114
|
canvas you start dies with your job - or start it detached, as design/AGENTS.md
|
|
113
|
-
says ("Keeping the canvas up"); never with a port. ALWAYS
|
|
114
|
-
|
|
115
|
-
|
|
116
|
-
|
|
115
|
+
says ("Keeping the canvas up"); never with a port. ALWAYS end with what
|
|
116
|
+
`npx marver link <scene ...> --board <board>` prints for the board you prepared
|
|
117
|
+
(its scenes selected and in view), or the `on the canvas:` line `work done`
|
|
118
|
+
printed - a `marver://` link when the Mac app has this canvas open, else a
|
|
119
|
+
localhost one. Give it as printed: never a link you wrote, never the bare root
|
|
120
|
+
URL. The link goes
|
|
117
121
|
at the BOTTOM of the message, on its own line: the human reads through, then
|
|
118
122
|
clicks. The human has already played with the hosted tour by now, so keep it
|
|
119
123
|
short - let their own product carry the moment. The highlights, all real
|
|
@@ -24,7 +24,7 @@ project's values (which account, which domain, which gate) and every run in the
|
|
|
24
24
|
- The three decisions are made: **which boards ship** (`design/publish.json` - publishing is
|
|
25
25
|
default-closed), **who gets in** (Marver Sign In by default; the canvas password when nothing
|
|
26
26
|
external may be in the sign-in path), **collaboration** (a persistent volume for comments, or none).
|
|
27
|
-
- The canvas has a name: `
|
|
27
|
+
- The canvas has a name: `name: "..."` in `design/config.ts` (or `share: { name }`).
|
|
28
28
|
|
|
29
29
|
## Steps
|
|
30
30
|
|
package/dist/config-BezZTiov.mjs
DELETED
|
@@ -1,182 +0,0 @@
|
|
|
1
|
-
import { t as __exportAll } from "./rolldown-runtime-8H4AJuhK.mjs";
|
|
2
|
-
import { h as readDescription } from "./board-tree-BXR8dw4b.mjs";
|
|
3
|
-
import { i as onPath, n as AGENT_NAMES, r as detectAgent, t as AGENT_BIN } from "./agent-BsieQGTD.mjs";
|
|
4
|
-
import { existsSync } from "node:fs";
|
|
5
|
-
import { join } from "node:path";
|
|
6
|
-
import { pathToFileURL } from "node:url";
|
|
7
|
-
//#region src/server/config.ts
|
|
8
|
-
var config_exports = /* @__PURE__ */ __exportAll({
|
|
9
|
-
DEFAULTS: () => DEFAULTS,
|
|
10
|
-
loadConfig: () => loadConfig
|
|
11
|
-
});
|
|
12
|
-
const DEFAULTS = {
|
|
13
|
-
mode: "studio",
|
|
14
|
-
theme: null,
|
|
15
|
-
viewports: {
|
|
16
|
-
mobile: {
|
|
17
|
-
width: 390,
|
|
18
|
-
height: 844
|
|
19
|
-
},
|
|
20
|
-
tablet: {
|
|
21
|
-
width: 768,
|
|
22
|
-
height: 1024
|
|
23
|
-
},
|
|
24
|
-
laptop: {
|
|
25
|
-
width: 1280,
|
|
26
|
-
height: 800
|
|
27
|
-
},
|
|
28
|
-
monitor: {
|
|
29
|
-
width: 1920,
|
|
30
|
-
height: 1080
|
|
31
|
-
}
|
|
32
|
-
},
|
|
33
|
-
themes: ["light", "dark"],
|
|
34
|
-
port: 5199,
|
|
35
|
-
zoomSpeed: 1,
|
|
36
|
-
share: { branding: true }
|
|
37
|
-
};
|
|
38
|
-
/** Load design/config.ts via native TS import (Node >= 22.18). Missing or broken fields fall back to defaults. */
|
|
39
|
-
async function loadConfig(root) {
|
|
40
|
-
const file = join(root, "design", "config.ts");
|
|
41
|
-
if (!existsSync(file)) return {
|
|
42
|
-
...DEFAULTS,
|
|
43
|
-
...jamFields(void 0)
|
|
44
|
-
};
|
|
45
|
-
try {
|
|
46
|
-
const user = (await import(`${pathToFileURL(file).href}?t=${Date.now()}`)).default ?? {};
|
|
47
|
-
return {
|
|
48
|
-
...DEFAULTS,
|
|
49
|
-
...user,
|
|
50
|
-
viewports: validViewports(user.viewports) ?? DEFAULTS.viewports,
|
|
51
|
-
themes: Array.isArray(user.themes) && user.themes.length ? user.themes.map(String) : DEFAULTS.themes,
|
|
52
|
-
port: validPort(user.port) ?? DEFAULTS.port,
|
|
53
|
-
zoomSpeed: validZoom(user.zoomSpeed) ?? DEFAULTS.zoomSpeed,
|
|
54
|
-
description: readDescription(user.description),
|
|
55
|
-
share: {
|
|
56
|
-
branding: user.share?.branding !== false,
|
|
57
|
-
name: typeof user.share?.name === "string" ? user.share.name : void 0,
|
|
58
|
-
logo: typeof user.share?.logo === "string" ? user.share.logo : void 0,
|
|
59
|
-
frontDoor: user.share?.frontDoor !== false && user.share?.front_door !== false,
|
|
60
|
-
notify: user.share?.notify !== false
|
|
61
|
-
},
|
|
62
|
-
...jamFields(user.jam)
|
|
63
|
-
};
|
|
64
|
-
} catch (err) {
|
|
65
|
-
console.error(`[marver] design/config.ts failed to load, using defaults and leaving Live Jam OFF:\n ${err.message}`);
|
|
66
|
-
return {
|
|
67
|
-
...DEFAULTS,
|
|
68
|
-
jamOff: "unreadable"
|
|
69
|
-
};
|
|
70
|
-
}
|
|
71
|
-
}
|
|
72
|
-
const validDim = (n) => typeof n === "number" && Number.isFinite(n) && n >= 1 && n <= 2e4;
|
|
73
|
-
function validPort(n) {
|
|
74
|
-
return typeof n === "number" && Number.isInteger(n) && n > 0 && n < 65536 ? n : null;
|
|
75
|
-
}
|
|
76
|
-
function validZoom(n) {
|
|
77
|
-
return typeof n === "number" && Number.isFinite(n) && n >= .1 && n <= 10 ? n : null;
|
|
78
|
-
}
|
|
79
|
-
/** Six frames at once is what a jam actually feels like - at 3, half of a multi-frame
|
|
80
|
-
* ask sat waiting on the other half while the human watched. */
|
|
81
|
-
const DEFAULT_CONCURRENCY = 6;
|
|
82
|
-
/** A config value, printable in a warning. Never throws - a formatter that can crash inside an
|
|
83
|
-
* error path (JSON.stringify does, on a BigInt) turns a clear message into a mystery. */
|
|
84
|
-
const show = (v) => {
|
|
85
|
-
try {
|
|
86
|
-
return JSON.stringify(v) ?? String(v);
|
|
87
|
-
} catch {
|
|
88
|
-
return String(v);
|
|
89
|
-
}
|
|
90
|
-
};
|
|
91
|
-
/** A `{...}` written by hand, not a Date/Map/class instance that merely types as "object". */
|
|
92
|
-
const plainObject = (v) => {
|
|
93
|
-
if (!v || typeof v !== "object") return false;
|
|
94
|
-
const proto = Object.getPrototypeOf(v);
|
|
95
|
-
return proto === Object.prototype || proto === null;
|
|
96
|
-
};
|
|
97
|
-
/** The agent to arm with - or, when the human NAMED one we cannot use, why not (said once,
|
|
98
|
-
* here, because a bad `jam.agent` is a config-file error like any other).
|
|
99
|
-
*
|
|
100
|
-
* A named agent is never quietly swapped for another: running a different tool than the one
|
|
101
|
-
* asked for is worse than not running. Nor is one armed that cannot be spawned - that would
|
|
102
|
-
* claim every @marver mention, fail it, and never retry. */
|
|
103
|
-
function resolveAgent(named) {
|
|
104
|
-
if (named === void 0) return detectAgent() ?? "no-agent";
|
|
105
|
-
if (typeof named !== "string" || !Object.hasOwn(AGENT_BIN, named)) {
|
|
106
|
-
console.warn(`[marver] design/config.ts: jam.agent ${show(named)} is not an agent marver can spawn - Live Jam is off. Use ${AGENT_NAMES}.`);
|
|
107
|
-
return "bad-agent";
|
|
108
|
-
}
|
|
109
|
-
const agent = named;
|
|
110
|
-
if (!onPath(AGENT_BIN[agent])) {
|
|
111
|
-
console.warn(`[marver] design/config.ts names jam.agent "${agent}", but \`${AGENT_BIN[agent]}\` is not on PATH - Live Jam is off until it is installed.`);
|
|
112
|
-
return "bad-agent";
|
|
113
|
-
}
|
|
114
|
-
return agent;
|
|
115
|
-
}
|
|
116
|
-
/** Resolve the jam block. Live Jam is ON by default: an absent or partial `jam` resolves
|
|
117
|
-
* to whatever agent CLI this machine has, so a fresh workspace jams with nothing
|
|
118
|
-
* configured and an old one needs no re-init. `jam: false` is the off switch. */
|
|
119
|
-
function resolveJam(v) {
|
|
120
|
-
if (v === false) return "opted-out";
|
|
121
|
-
const shape = v === void 0 || v === true ? {} : typeof v === "string" ? { agent: v } : plainObject(v) ? v : null;
|
|
122
|
-
if (!shape) {
|
|
123
|
-
console.warn(`[marver] design/config.ts: jam must be false, an agent name, or an options object - got ${show(v)}. Live Jam is off.`);
|
|
124
|
-
return "bad-agent";
|
|
125
|
-
}
|
|
126
|
-
const j = shape;
|
|
127
|
-
const agent = resolveAgent(j.agent);
|
|
128
|
-
if (agent === "no-agent" || agent === "bad-agent") return agent;
|
|
129
|
-
const c = j.concurrency;
|
|
130
|
-
const pick = (key, v, ok, fallback, want) => {
|
|
131
|
-
if (v === void 0) return fallback;
|
|
132
|
-
if (ok(v)) return v;
|
|
133
|
-
console.warn(`[marver] design/config.ts: jam.${key} must be ${want} - got ${show(v)}. Using ${JSON.stringify(fallback)}.`);
|
|
134
|
-
return fallback;
|
|
135
|
-
};
|
|
136
|
-
const bool = (v) => typeof v === "boolean";
|
|
137
|
-
return {
|
|
138
|
-
agent,
|
|
139
|
-
concurrency: typeof c === "number" && Number.isInteger(c) && c >= 1 && c <= 16 ? c : DEFAULT_CONCURRENCY,
|
|
140
|
-
subagents: j.subagents !== false,
|
|
141
|
-
proactive: j.proactive === true,
|
|
142
|
-
chime: pick("chime", j.chime, bool, true, "true or false"),
|
|
143
|
-
capture: pick("capture", j.capture, (v) => v === "confirm" || v === "at-once", "confirm", `'confirm' or 'at-once'`),
|
|
144
|
-
loc: pick("loc", j.loc, bool, true, "true or false"),
|
|
145
|
-
names: pick("names", j.names, bool, true, "true or false"),
|
|
146
|
-
runner: pick("runner", j.runner, (v) => v === "auto" || v === "session" || v === "background", "auto", `'auto', 'session' or 'background'`),
|
|
147
|
-
session: pick("session", j.session, bool, true, "true or false"),
|
|
148
|
-
context: pick("context", j.context, (v) => v === "fork" || v === "fresh", "fork", `'fork' or 'fresh'`),
|
|
149
|
-
mcp: pick("mcp", j.mcp, bool, true, "true or false"),
|
|
150
|
-
skills: pick("skills", j.skills, bool, true, "true or false"),
|
|
151
|
-
others: pick("others", j.others, bool, false, "true or false"),
|
|
152
|
-
...((sm) => sm === void 0 ? {} : { sessionMax: sm })(pick("sessionMax", j.sessionMax, (v) => typeof v === "number" && Number.isInteger(v) && v >= 1 && v <= 8, void 0, "a whole number from 1 to 8"))
|
|
153
|
-
};
|
|
154
|
-
}
|
|
155
|
-
/** Exactly one of `jam` (armed) or `jamOff` (why not) - so the dev server can speak up about
|
|
156
|
-
* the one off-state nothing has reported yet, and stay quiet about the rest. BOTH keys are
|
|
157
|
-
* always written: these spread over the user's own `jam`, and a raw `jam: false` reaching the
|
|
158
|
-
* server as config would arm the daemon against a truthy object check. */
|
|
159
|
-
function jamFields(v) {
|
|
160
|
-
const r = resolveJam(v);
|
|
161
|
-
return typeof r === "string" ? {
|
|
162
|
-
jam: void 0,
|
|
163
|
-
jamOff: r
|
|
164
|
-
} : {
|
|
165
|
-
jam: r,
|
|
166
|
-
jamOff: void 0
|
|
167
|
-
};
|
|
168
|
-
}
|
|
169
|
-
function validViewports(v) {
|
|
170
|
-
if (!v || typeof v !== "object") return null;
|
|
171
|
-
const out = {};
|
|
172
|
-
for (const [k, val] of Object.entries(v)) {
|
|
173
|
-
const vp = val;
|
|
174
|
-
if (validDim(vp?.width) && validDim(vp?.height)) out[k] = {
|
|
175
|
-
width: Math.round(vp.width),
|
|
176
|
-
height: Math.round(vp.height)
|
|
177
|
-
};
|
|
178
|
-
}
|
|
179
|
-
return Object.keys(out).length ? out : null;
|
|
180
|
-
}
|
|
181
|
-
//#endregion
|
|
182
|
-
export { loadConfig as n, config_exports as t };
|