@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
package/CHANGELOG.md
CHANGED
|
@@ -2,6 +2,64 @@
|
|
|
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.31.0 - 2026-11-10
|
|
6
|
+
|
|
7
|
+
### Highlights
|
|
8
|
+
|
|
9
|
+
- **Export a deck as a PDF.** `npx marver pdf <board>`, Export PDF in a board's menu or in slides and present mode, and in the
|
|
10
|
+
Mac app File > Export PDF. One page per slide at the slide's own size, real searchable text, vector shapes, links that
|
|
11
|
+
click, a bookmark per slide, images at full resolution, CSS and Web Animations at their end (a looping one at its first pose).
|
|
12
|
+
Glass, filters, blends, masks and large soft shadows - which browsers print wrong - are rebuilt so the page looks as it
|
|
13
|
+
does on screen, and checked against it (each printed page too, where macOS can render it); anything that cannot be rebuilt prints as a picture, and the
|
|
14
|
+
report names every page rebuilt, pictured or not settled. `--notes`
|
|
15
|
+
prints a handout with each slide's notes beside it. Any board that plays exports, present boards too.
|
|
16
|
+
[Deck PDFs](docs/pdf.md)
|
|
17
|
+
- **Resolve all comments.** Next to Mark all as seen - in a board's, a folder's and a scene's menu, and on the Mac app's
|
|
18
|
+
canvas tab - one click resolves every open conversation there, with Undo. It never touches what Jam is working on. Your
|
|
19
|
+
agent can do it too (`marver comments resolve --all --board <b>`, or `--folder`, `--scene`, `--canvas`; `--undo <op>`
|
|
20
|
+
takes it back), and asks you first when the conversations pile up.
|
|
21
|
+
- **Calmer badges.** Frames new since you looked show a blue dot instead of a count, on the app's tab and on a closed folder;
|
|
22
|
+
orange still counts what waits on you.
|
|
23
|
+
- **Links that open the Mac app.** When Marver is open with the canvas in a tab, `marver link` gives a `marver://` link: click
|
|
24
|
+
it anywhere and the app comes forward on that board, frames selected and in view. `marver work done` hands back the same
|
|
25
|
+
links. And ask your agent to show you something - a frame, a scene, a board or a comment thread - and `marver show`
|
|
26
|
+
moves your open canvas there; while you are typing a comment it offers to go instead.
|
|
27
|
+
- **Comments you can copy, edit and delete.** Select and copy a comment's words (⌘A in a card selects its text). Edit or
|
|
28
|
+
delete your own; a deleted first comment keeps its replies under "Comment deleted". Deleted words never reach your agent.
|
|
29
|
+
|
|
30
|
+
### Added
|
|
31
|
+
|
|
32
|
+
- **Your own breakpoint icons and names.** A viewport in `design/config.ts` takes a `label` and an `icon` - a built-in glyph
|
|
33
|
+
(`mobile`, `tablet`, `laptop`, `monitor`, `tv`, `watch`, `desktop`, `ereader`; `-landscape` turns it) or an SVG in your repo, drawn in the
|
|
34
|
+
toolbar's ink. Without them, both come from the name: "ipad-landscape" shows as "iPad landscape" with a tablet turned on
|
|
35
|
+
its side.
|
|
36
|
+
- **A canvas that looks like itself in the app.** `name` and `logo` in `design/config.ts` name the canvas everywhere (the app's
|
|
37
|
+
tab and Home card, the sidebar, the sign-in page); `share.name` and `share.logo` still work. `marver init` writes a `name`,
|
|
38
|
+
and `marver dev` tells you when a canvas still shows its folder name or Marver's mark. The agent guide now sets this up.
|
|
39
|
+
- `marver marks` shows open conversations per board.
|
|
40
|
+
|
|
41
|
+
### Fixed
|
|
42
|
+
|
|
43
|
+
- A frame's `meta` with an escaped quote (`'Nic\'s board'`) is no longer dropped.
|
|
44
|
+
- The Marver ID sign-in page shows the canvas's logo, not Marver's.
|
|
45
|
+
- A Jam batch whose cards are gone no longer slows every `marver dev` start by about 7 seconds.
|
|
46
|
+
- A board whose file says `"type": "slides"` is read as a deck (its type only: playing and printing as slides still follow
|
|
47
|
+
its publish row).
|
|
48
|
+
- A long-running canvas now learns of a new Marver release (`/__mv/api/update` refreshes daily and always answers).
|
|
49
|
+
- Docs: any commenter may resolve a conversation; only its author may edit or delete it.
|
|
50
|
+
|
|
51
|
+
### Upgrading
|
|
52
|
+
|
|
53
|
+
- `npx marver init` after upgrading, for the agent guide's new steps (identity, resolve-all, `marver show`, `marver link`,
|
|
54
|
+
deck PDFs with `marver pdf`) and `design/exports/` in `.gitignore`.
|
|
55
|
+
- Restart `marver dev` after upgrading: `marver pdf`, `marver show` and `marver comments resolve --all` need the 0.31 dev
|
|
56
|
+
server.
|
|
57
|
+
- `init` writes `name` only into a new `design/config.ts`. An existing canvas keeps its folder's name until you, or your
|
|
58
|
+
agent, add `name: "Your Product"` and a real `design/logo.svg`; `marver dev`'s boot line says when either is missing.
|
|
59
|
+
- Comment deletes reach a published canvas once it runs 0.31; until then they wait on this Mac.
|
|
60
|
+
- The `marver://` links and Export PDF's save panel need the Mac app 1.1; app 1.0.1 still exports: when the PDF is ready,
|
|
61
|
+
its notice offers **Download**.
|
|
62
|
+
|
|
5
63
|
## 0.30.1 - 2026-11-09
|
|
6
64
|
|
|
7
65
|
### Fixed
|
package/README.md
CHANGED
|
@@ -8,7 +8,7 @@
|
|
|
8
8
|
|
|
9
9
|
Screens, prototypes, specs, and now slide decks - all real code, all on one canvas, all shareable with people who sign in as themselves.
|
|
10
10
|
|
|
11
|
-
[marver.design](https://marver.design) · [Mac app](docs/app.md) · [Boards and folders](docs/boards-and-folders.md) · [Context](docs/context.md) · [Slides](docs/slides.md) · [Sticky notes](docs/sticky-notes.md) · [Live Jam](docs/live-jam.md) · [Jam sessions](docs/jam-session.md) · [Performance](docs/performance.md) · [Deploying a canvas](docs/publish.md) · [Sharing](docs/sharing.md) · [Changelog](CHANGELOG.md) · [Contributing](CONTRIBUTING.md) · [Issues](https://github.com/TNEP4/marver/issues)
|
|
11
|
+
[marver.design](https://marver.design) · [Mac app](docs/app.md) · [Boards and folders](docs/boards-and-folders.md) · [Context](docs/context.md) · [Slides](docs/slides.md) · [Deck PDFs](docs/pdf.md) · [Sticky notes](docs/sticky-notes.md) · [Live Jam](docs/live-jam.md) · [Jam sessions](docs/jam-session.md) · [Performance](docs/performance.md) · [Deploying a canvas](docs/publish.md) · [Sharing](docs/sharing.md) · [Changelog](CHANGELOG.md) · [Contributing](CONTRIBUTING.md) · [Issues](https://github.com/TNEP4/marver/issues)
|
|
12
12
|
|
|
13
13
|
## Quickstart
|
|
14
14
|
|
|
@@ -49,6 +49,7 @@ Frames appear on the canvas the moment the files land. That's the loop.
|
|
|
49
49
|
- **Sticky notes.** A markdown file beside a frame (`cart.note.md`) or a scene (`_note.md`) becomes a yellow note left of the frame on the canvas - what it is for, how two variations differ, an open question. Markdown, `goto:` links to frames, hand-drawn Mermaid; readers comment on a note's text like on a frame's, fold it to its corner, hide them all with `n`. The layout makes room for it, beside the frame and below; published canvases carry them.
|
|
50
50
|
- **Hi-fi at rest.** A frame at rest is its own live document, asleep: animations paused and every `backdrop-filter` element painted with a certified texture of its filtered backdrop (compiled by the dev server's headless Chrome), so a board of 30 glass screens pans like 30 statics and wakes pixel-identical on interact. Glass inside glass, blend modes and frames whose paint depends on random data or the clock stay live; `?awake=1` keeps every frame live for comparison.
|
|
51
51
|
- **Charts and video in any frame.** `Chart` (Apache ECharts, SVG, still at rest) inherits the ink, typeface and accent of whatever frame it sits in - a Tailwind dashboard, a dark spec, a slide - sizes its type to the context and follows the layout on resize. `Video` is poster-first everywhere: click to play wherever the frame is live, `autoplay` for an ambient loop, `ratio` for vertical clips; omit the poster and marver renders one from the clip. A screen with a chart or a clip is still a screen.
|
|
52
|
+
- **Deck PDFs.** **Export PDF** on a board (or `npx marver pdf <board>`) prints it one page per slide (any other board, one page per frame): real text you can search, vector shapes, links that click, a bookmark per slide - and the glass, blur and shadows Chrome usually prints wrong, fixed and checked against the screen. `--notes` makes a handout with the speaker notes ([Deck PDFs](docs/pdf.md)).
|
|
52
53
|
- **Copy as image.** Select a frame, press `i` - a 2x PNG of it lands on the clipboard, rendered by the same headless Chrome that serves `marver shot`; `⇧i` for 4x (a 1280×720 slide is 5120×2880, whatever size its node has). Paste into Slack, a doc, or a chat with your agent.
|
|
53
54
|
|
|
54
55
|
## Context
|
|
@@ -76,7 +77,7 @@ Publish a deck with `{ "boards": { "pitch": { "max": "read", "type": "slides", "
|
|
|
76
77
|
|
|
77
78
|
## Collaboration
|
|
78
79
|
|
|
79
|
-
- **Comments.** Google-Docs-style feedback pinned to actual elements. Press `c`, click a div inside a frame, write - the thread lives on that element and survives edits via a layered anchor (source semantics → structure → fuzzy text). Type `@` to mention someone who can already see the canvas; they get a mail with the comment and a link that lands on the thread, and the mention pulses its pin in their canvas with an in-app notification. A reply mails the thread's other participants, throttled per person and thread; anyone can mute a canvas's mail. `marver dev` syncs the same threads into `design/comments/*.jsonl`, where your agent works the queue: `npx marver comments list --open --json` → fork a variant → `resolve --addressed-in`. Live via SSE; one deploy, no extra services.
|
|
80
|
+
- **Comments.** Google-Docs-style feedback pinned to actual elements. Press `c`, click a div inside a frame, write - the thread lives on that element and survives edits via a layered anchor (source semantics → structure → fuzzy text). Type `@` to mention someone who can already see the canvas; they get a mail with the comment and a link that lands on the thread, and the mention pulses its pin in their canvas with an in-app notification. A reply mails the thread's other participants, throttled per person and thread; anyone can mute a canvas's mail. `marver dev` syncs the same threads into `design/comments/*.jsonl`, where your agent works the queue: `npx marver comments list --open --json` → fork a variant → `resolve --addressed-in`. Select and copy any message's words; edit or delete your own (a capture's own comment: delete only - Jam keeps its words; a deleted first comment keeps its replies under "Comment deleted"); clear the noise with **Resolve all comments** on a board, folder or scene, with Undo. Live via SSE; one deploy, no extra services.
|
|
80
81
|
- **Laser mode.** Press `l`: the element under your cursor lights up with a label naming it and its source. Click it to copy its full address (frame file + CSS path) for the agent. `⌥L` is the inspect laser: every element in every frame gets depth-hued outlines - the fastest way to see structure. (On a published canvas, laser needs `"reveal": { "source": true }` in `publish.json` - source paths go opaque by default.)
|
|
81
82
|
- **Publishing.** `npx marver build` exports a static canvas (default-closed: `design/publish.json` names what ships, each board's ceiling - `read` or `comment` - and, since 0.12, its **type** and **landing view**: `{ "max", "type": "doc" | "slides" | "design" | "sketch" | "refs" | "mix", "open": "canvas" | "board" | "present" | "focus" | "slides", "lock": true }`); `npx marver serve` hosts it. One deploy on Railway, Docker, or any static host - the [publishing guide](docs/publish.md) has the one-pagers.
|
|
82
83
|
- **Sharing, person by person.** On a canvas with a persistent volume, `marver share add sam@acme.com --role comment` (or the browser's share dialog) grants one person access, `@acme.com` grants a domain, `general private|password|public` sets the floor, and a refused visitor can ask to get in - approve from the terminal. One resolver answers "what can this person do here", and `marver share explain <email>` shows its reasoning. The [sharing guide](docs/sharing.md) has the whole surface.
|
|
@@ -114,10 +115,12 @@ The same glow, driven from the terminal. When your agent takes a request, it cre
|
|
|
114
115
|
| `npx marver build` | Static export → `design/.dist`; what ships comes from `design/publish.json` (default-closed) |
|
|
115
116
|
| `npx marver serve` | Serve the export; `MARVER_ID_ISSUER` or `MARVER_PASSWORD` gates it, `MARVER_DATA_DIR` persists comments + accounts |
|
|
116
117
|
| `npx marver share …` | The roster (owner): `add <who> [--role]` · `remove` · `block` / `unblock` · `general <mode>` · `list` · `requests` · `explain <who>` · `who` |
|
|
117
|
-
| `npx marver comments …` | The agent's queue: `connect <url>` · `sync` · `list` · `new <scene/frame>` · `reply` · `resolve` · `invite <email>` · `revoke <email>` |
|
|
118
|
+
| `npx marver comments …` | The agent's queue: `connect <url>` · `sync` · `list` · `new <scene/frame>` · `reply` · `resolve` (`--all --board <b>`, only on the human's yes; `--undo <op>`) · `invite <email>` · `revoke <email>` |
|
|
118
119
|
| `npx marver work …` | Working glow from the terminal: `start <scene/frame …>` · `done … \| --all` (prints the canvas link) · `list` |
|
|
119
|
-
| `npx marver link <scene/frame \| scene
|
|
120
|
+
| `npx marver link <scene/frame \| scene ...> [--web]` | The canvas link that lands on those frames - their board, selected and in view (needs `dev` running); a `marver://` link that opens the Mac app when it has this canvas open, `--web` for localhost |
|
|
121
|
+
| `npx marver show <scene/frame \| scene ... \| board> [--thread <id>]` | Move every open tab of this canvas to that place, fitted (in the Mac app, its tab comes forward); a tab with words not yet sent shows a notice instead; then the link |
|
|
120
122
|
| `npx marver shot <frame ...> \| --scene <name> \| --all [--scale 1-4] [--json]` | Render frames headless and print the PNG paths (needs `dev` running); a scene is one browser, several frames at a time; 2x by default |
|
|
123
|
+
| `npx marver pdf <board> [--notes [--paper letter\|a4]] [--theme t] [--out file] [--raster \| --vector] [--keep-going] [--json]` | A board as a PDF: a deck one page per slide, any other board one page per frame - vector text, links, bookmarks; glass and other effects Chrome prints wrong fixed and checked against the screen (needs `dev` running; [Deck PDFs](docs/pdf.md)) |
|
|
121
124
|
| `npx marver perf [--loads \| --jam \| --runs] [--json]` | What the canvas did lately: each edit's reloads; `--loads` each board load (time to settled, how many moves and why, the slowest frames, errors); `--jam` Jam's timings; `--runs` the headless runs compared ([Performance](docs/performance.md)) |
|
|
122
125
|
| `npx marver perf --all` / `--live` | Every canvas on this Mac in one summary, no repo needed; or the records as they happen, in a terminal. |
|
|
123
126
|
| `npx marver perf run <board> [--slow] [--repeat n]` | Measure a board the same way every time - a load, a fit, a zoom and a pan in the canvas's own headless Chrome, read-only - so you or your agent can compare before and after a change (needs `dev` running; [Headless runs](docs/performance.md#headless-runs)) |
|
|
@@ -128,7 +131,7 @@ The same glow, driven from the terminal. When your agent takes a request, it cre
|
|
|
128
131
|
|
|
129
132
|
**Where the canvas runs.** Each canvas on your Mac takes one of twenty fixed ports, localhost:4805 to localhost:4824 - usually the same one each time - and prints its link; `npx marver ls` lists them all. `--port <n>`, or a `port` in `design/config.ts` (other than the old 5199), gives a canvas a port of its own instead. Because an address is reused by whichever canvas starts there next, a tab left open after its canvas stopped says so, and how to bring it back, and keeps your unsaved edits until its own canvas is back, and a local canvas runs no service workers.
|
|
130
133
|
|
|
131
|
-
**The Mac app.** In Marver's Mac app a canvas tells the app what it holds, so closing its tab, quitting or reloading asks before losing unsaved work, and the app follows its theme and shows its View and Jam items in the menu bar. Since 0.29 (app 0.3) it also tells the app what needs you - a question, a capture to review, a run that failed or stalled - which the app counts on the canvas's tab and, with notices on, sends as a notice that opens it; and a capture's pictures in play are your screen as you saw it ([what needs you](docs/boards-and-folders.md#what-is-new-what-needs-you)). In a browser none of this runs; browsers ask before a reload or a close loses unsaved work too.
|
|
134
|
+
**The Mac app.** In Marver's Mac app a canvas tells the app what it holds, so closing its tab, quitting or reloading asks before losing unsaved work, and the app follows its theme and shows its View and Jam items in the menu bar. Since 0.29 (app 0.3) it also tells the app what needs you - a question, a capture to review, a run that failed or stalled - which the app counts on the canvas's tab and, with notices on, sends as a notice that opens it; and a capture's pictures in play are your screen as you saw it ([what needs you](docs/boards-and-folders.md#what-is-new-what-needs-you)). Since 0.31 (app 1.1), `marver link` gives a `marver://` link while the app has the canvas open - click it anywhere and the app comes forward on that board, the frames selected ([Links into the app](docs/app.md#links-into-the-app)); `marver show` brings the tab forward too; File > Export PDF saves a board's PDF where you choose; and the tab's menu has Resolve All Comments beside Mark All as Seen, with a blue dot, not a count, for what is new. In a browser none of this runs; browsers ask before a reload or a close loses unsaved work too.
|
|
132
135
|
|
|
133
136
|
## Shortcuts
|
|
134
137
|
|
|
@@ -141,7 +144,7 @@ The same glow, driven from the terminal. When your agent takes a request, it cre
|
|
|
141
144
|
|
|
142
145
|
**Board & chrome** - `t` tidy · `d` toggle light/dark for the board · `⌘\` (ctrl+\) collapse/open sidebar.
|
|
143
146
|
|
|
144
|
-
**Selection** - click selects · shift+click (canvas or sidebar) builds a multi-selection · `⌘A` selects every frame on the board · `⇧P` copies the selected frames' paths (board, frame, and file) · `i` copies the selected frame to the clipboard as a 2x PNG (`⇧i` for 4x; also the images-square button in the floating toolbar - dev canvases only, the renderer is the dev server's headless Chrome) · double-click enters interact mode (`esc` or click outside leaves) · drag the title bar to move, edges to resize (widths snap to devices).
|
|
147
|
+
**Selection** - click selects · shift+click (canvas or sidebar) builds a multi-selection · `⌘A` selects every frame on the board (inside a comment card, its words - select and copy any comment) · `⇧P` copies the selected frames' paths (board, frame, and file) · `i` copies the selected frame to the clipboard as a 2x PNG (`⇧i` for 4x; also the images-square button in the floating toolbar - dev canvases only, the renderer is the dev server's headless Chrome) · double-click enters interact mode (`esc` or click outside leaves) · drag the title bar to move, edges to resize (widths snap to devices).
|
|
145
148
|
|
|
146
149
|
**Where to look** - `u` goes to the next frame that needs you (an orange question bubble), then the next new one (blue) - see [what is new, what needs you](docs/boards-and-folders.md#what-is-new-what-needs-you).
|
|
147
150
|
|
|
@@ -153,7 +156,8 @@ The same glow, driven from the terminal. When your agent takes a request, it cre
|
|
|
153
156
|
|
|
154
157
|
- **Next.js**: supported with one caveat - frames render in Vite, outside Next. `next/font` CSS variables are undefined inside frames (give font tokens a fallback chain), `next/image`/`next/link` should be plain `img`/`data-goto` in frames, and Server Components cannot run there. `init` writes the specifics into `design/AGENTS.md` when it detects Next.
|
|
155
158
|
- **Upgrade**: `npm i -D @marver-design/marver@latest && npx marver init`. The canvas tells you when a new version is out (one anonymous registry check per day, cached in `design/.local/`; `MARVER_NO_UPDATE_CHECK=1` disables), and warns when your `design/instructions/` predate the installed package. Re-running init refreshes the managed files (AGENTS.md, `design/instructions/`) - your edits to them are detected and preserved; when both you and a release changed a file, the fresh version is staged at `design/.local/latest/` for you (or your agent) to merge. Everything else in `design/` is yours and never touched.
|
|
156
|
-
- **
|
|
159
|
+
- **Your own breakpoints**: `viewports` in `design/config.ts` takes any device - `"boox-full": { width: 1240, height: 1860 }` - and each can carry a `label` and an `icon`: a built-in glyph (`mobile`, `tablet`, `laptop`, `monitor`, `tv`, `watch`, `desktop`, `ereader`; `-landscape` turns it) or a repo-relative `.svg` (read inside the repo only, 32 KB, rebuilt from paths and shapes and drawn as a mask in the toolbar's ink - nothing in it runs). Without them both come from the name: `ipad-landscape` shows as "iPad landscape" with the tablet glyph turned.
|
|
160
|
+
- **Name your canvas**: `name: "Your App"` in `design/config.ts` names it in the Mac app's tab and Home card and in the sidebar, titles the gate, labels the brand pill, names the canvas in `marver ls`, and tags every powered-by link (`share.name` still works; `name` wins). Unset, the canvas shell shows the directory name - `app` inside most containers - and the gate falls back to your `package.json` name; `marver dev` says so at boot. Its logo is the first of `logo`, `share.logo`, `design/logo.svg|png`, `public/logo.svg|png` and `public/favicon.svg|png|ico` that is a real file in the repo (never a symlink) of at most 256 KB, an SVG, PNG or ICO by its bytes; the gate page, a published canvas's browser tab (built with 0.29 or later) and the Mac app's tab wear it.
|
|
157
161
|
- **Uninstall**: delete `design/`, remove the dependency. (If `init` patched your tsconfig `exclude`, revert that one line.)
|
|
158
162
|
|
|
159
163
|
## Status
|
|
@@ -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-BqwkdtKn.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
|
|
@@ -23,13 +23,17 @@ const BOARD_TYPES = [
|
|
|
23
23
|
const TYPE_GRAMMAR = /^[a-z][a-z-]{0,31}$/;
|
|
24
24
|
/** A type off a file: the word when it is on-grammar, else absent. */
|
|
25
25
|
const readType = (v) => typeof v === "string" && TYPE_GRAMMAR.test(v) ? v : void 0;
|
|
26
|
+
/** Words read as another type (spec 31): `slides` is a deck - for the type only; whether a board plays as slides stays
|
|
27
|
+
* its publish policy's. */
|
|
28
|
+
const TYPE_ALIASES = { slides: "deck" };
|
|
29
|
+
const alias = (v) => typeof v === "string" && Object.hasOwn(TYPE_ALIASES, v) ? TYPE_ALIASES[v] : v;
|
|
26
30
|
/** A type this Marver draws. */
|
|
27
31
|
const knownType = (v) => BOARD_TYPES.includes(v) ? v : void 0;
|
|
28
32
|
/** A board's type: its own when it states one (an unknown word reads as plain - the board spoke
|
|
29
33
|
* for itself), else its folder's, else that folder's parent's, else plain. */
|
|
30
34
|
function resolveType(own, folder, parent) {
|
|
31
|
-
if (readType(own)) return knownType(own) ?? "plain";
|
|
32
|
-
return knownType(folder) ?? knownType(parent) ?? "plain";
|
|
35
|
+
if (readType(own)) return knownType(alias(own)) ?? "plain";
|
|
36
|
+
return knownType(alias(folder)) ?? knownType(alias(parent)) ?? "plain";
|
|
33
37
|
}
|
|
34
38
|
/** The publish type a board's type proposes when its publish row names none - how a board
|
|
35
39
|
* PRESENTS when published, a separate question from what it is for. */
|
|
@@ -1,4 +1,5 @@
|
|
|
1
|
-
import {
|
|
1
|
+
import { t as __exportAll } from "./rolldown-runtime-8H4AJuhK.mjs";
|
|
2
|
+
import { A as resolveType, D as readReason, E as readCapability, O as readStatusWord, a as buildTree, c as folderMap, d as isBoardFile, f as isBoardName, g as readTitle, h as readDescription, i as archiveLast, k as readType, l as framesOn, m as parseFolders, o as flatten, r as FOLDERS_FILE } from "./board-tree-DGj0HhEE.mjs";
|
|
2
3
|
import { existsSync, lstatSync, mkdirSync, readFileSync, readdirSync, realpathSync, renameSync, rmSync, writeFileSync } from "node:fs";
|
|
3
4
|
import { join, sep } from "node:path";
|
|
4
5
|
import { createHash, randomBytes } from "node:crypto";
|
|
@@ -7,6 +8,11 @@ import { createHash, randomBytes } from "node:crypto";
|
|
|
7
8
|
const hash = (s) => createHash("sha256").update(s).digest("hex");
|
|
8
9
|
//#endregion
|
|
9
10
|
//#region src/client/shell/tidy.ts
|
|
11
|
+
var tidy_exports = /* @__PURE__ */ __exportAll({
|
|
12
|
+
dropGone: () => dropGone,
|
|
13
|
+
parseLayout: () => parseLayout,
|
|
14
|
+
tidy: () => tidy
|
|
15
|
+
});
|
|
10
16
|
const isSpace = (x) => !!x && typeof x === "object" && !Array.isArray(x);
|
|
11
17
|
/** Drop the items `isGone` names, each with the spacer that led into it (or, at the start, the
|
|
12
18
|
* one that followed it) - what is left reads as if the item was never there. (`boards place` takes a frame out of a
|
|
@@ -414,6 +420,30 @@ function parseFlow(o, warn) {
|
|
|
414
420
|
* the build can fail closed). The folder registry is read the same way: absent = no folders,
|
|
415
421
|
* malformed = an error the human must fix, never a silently empty registry.
|
|
416
422
|
*/
|
|
423
|
+
var boards_exports = /* @__PURE__ */ __exportAll({
|
|
424
|
+
AUTHOR_FIELDS: () => AUTHOR_FIELDS,
|
|
425
|
+
REGISTRY_LOCK: () => REGISTRY_LOCK,
|
|
426
|
+
addFolders: () => addFolders,
|
|
427
|
+
boardFields: () => boardFields,
|
|
428
|
+
boardLayoutOf: () => boardLayoutOf,
|
|
429
|
+
boardLock: () => boardLock,
|
|
430
|
+
checkBoardsDir: () => checkBoardsDir,
|
|
431
|
+
checkRealDirs: () => checkRealDirs,
|
|
432
|
+
isRegularFile: () => isRegularFile,
|
|
433
|
+
listBoardFiles: () => listBoardFiles,
|
|
434
|
+
nodeExists: () => nodeExists,
|
|
435
|
+
parseBoard: () => parseBoard,
|
|
436
|
+
pinFrames: () => pinFrames,
|
|
437
|
+
placeFrame: () => placeFrame,
|
|
438
|
+
readMembership: () => readMembership,
|
|
439
|
+
readRegistry: () => readRegistry,
|
|
440
|
+
takeFileLock: () => takeFileLock,
|
|
441
|
+
tryFileLock: () => tryFileLock,
|
|
442
|
+
underRoot: () => underRoot,
|
|
443
|
+
unplacedHint: () => unplacedHint,
|
|
444
|
+
withFileLock: () => withFileLock,
|
|
445
|
+
withRegistryLock: () => withRegistryLock
|
|
446
|
+
});
|
|
417
447
|
/** Does realpath(dir) stay inside realpath(root)? A symlinked design/boards can't escape. */
|
|
418
448
|
function underRoot(root, dir) {
|
|
419
449
|
try {
|
|
@@ -992,4 +1022,4 @@ function placeFrame(root, board, frame, rel, anchor, frames, viewports = {}, hei
|
|
|
992
1022
|
return out;
|
|
993
1023
|
}
|
|
994
1024
|
//#endregion
|
|
995
|
-
export {
|
|
1025
|
+
export { tryFileLock as _, boards_exports as a, tidy_exports as b, isRegularFile as c, parseBoard as d, pinFrames as f, takeFileLock as g, readRegistry as h, boardLock as i, listBoardFiles as l, readMembership as m, addFolders as n, checkBoardsDir as o, placeFrame as p, boardFields as r, checkRealDirs as s, AUTHOR_FIELDS as t, nodeExists as u, unplacedHint as v, hash as x, withRegistryLock as y };
|
|
@@ -1,8 +1,8 @@
|
|
|
1
1
|
import { r as NAME } from "./cli.mjs";
|
|
2
|
-
import {
|
|
3
|
-
import { A as resolveType, E as readCapability, T as knownType, a as buildTree, c as folderMap, f as isBoardName, o as flatten, u as humanize, x as FOLDER_MODULES, y as BOARD_TYPES } from "./board-tree-
|
|
4
|
-
import { _ as STATUS_LABEL, d as annotateBoards, h as PHASE_LABEL, s as scanFrames } from "./manifest-
|
|
5
|
-
import { resolveTargets } from "./link-
|
|
2
|
+
import { f as pinFrames, h as readRegistry, l as listBoardFiles, m as readMembership, n as addFolders, o as checkBoardsDir, p as placeFrame, r as boardFields, s as checkRealDirs } from "./boards-Cim1GTKc.mjs";
|
|
3
|
+
import { A as resolveType, E as readCapability, T as knownType, a as buildTree, c as folderMap, f as isBoardName, o as flatten, u as humanize, x as FOLDER_MODULES, y as BOARD_TYPES } from "./board-tree-DGj0HhEE.mjs";
|
|
4
|
+
import { _ as STATUS_LABEL, d as annotateBoards, h as PHASE_LABEL, s as scanFrames } from "./manifest-CK8Qh4Nq.mjs";
|
|
5
|
+
import { resolveTargets } from "./link-Cmt9Xy4X.mjs";
|
|
6
6
|
import { existsSync, mkdirSync, writeFileSync } from "node:fs";
|
|
7
7
|
import { join } from "node:path";
|
|
8
8
|
//#region src/cli/boards.ts
|
|
@@ -202,7 +202,7 @@ function boardsPin(root, board, targets) {
|
|
|
202
202
|
* works (the canvas refuses when another run or your chat agent has one). */
|
|
203
203
|
async function toRun(root, frames, opts) {
|
|
204
204
|
if (typeof opts.run !== "string" || !opts.run) throw new Error("name the run: --run <handle> (r-xxxxxxxx.N, from jam next)");
|
|
205
|
-
const { ownConn } = await import("./jam-
|
|
205
|
+
const { ownConn } = await import("./jam-CkuLL8A8.mjs");
|
|
206
206
|
const { request } = await import("./transport-C5FnY9ni.mjs");
|
|
207
207
|
for (const frame of frames) {
|
|
208
208
|
const r = await request(root, ownConn(root, process.env, typeof opts.as === "string" ? opts.as : void 0), "own", {
|
|
@@ -238,9 +238,9 @@ async function boardsPlace(root, board, targets, opts) {
|
|
|
238
238
|
};
|
|
239
239
|
const frame = one(targets[0]), anchor = one(after ?? before);
|
|
240
240
|
if (opts.run !== void 0) await toRun(root, [frame], opts);
|
|
241
|
-
const { loadConfig } = await import("./config-
|
|
241
|
+
const { loadConfig } = await import("./config-B0YcFtqS.mjs").then((n) => n.t);
|
|
242
242
|
const viewports = await loadConfig(root).then((c) => c.viewports, () => ({}));
|
|
243
|
-
const { readSizes } = await import("./sizes-
|
|
243
|
+
const { readSizes } = await import("./sizes-BckcL4Zz.mjs").then((n) => n.u);
|
|
244
244
|
return placeFrame(root, board, frame, after ? "after" : "before", anchor, manifest.frames, viewports, readSizes(root));
|
|
245
245
|
}
|
|
246
246
|
/** `marver folders add <module...>` - the shared sidebar's typed folders (spec 20): start, features,
|
|
@@ -1,15 +1,15 @@
|
|
|
1
1
|
import { a as ROUTE, r as NAME } from "./cli.mjs";
|
|
2
|
-
import {
|
|
3
|
-
import { a as buildTree, f as isBoardName, l as framesOn, o as flatten, t as ALL_SCENES, w as PROPOSED_PUBLISH } from "./board-tree-
|
|
4
|
-
import { g as PUBLISHABLE, s as scanFrames, v as publishableStatus } from "./manifest-
|
|
2
|
+
import { c as isRegularFile, h as readRegistry, l as listBoardFiles, o as checkBoardsDir, r as boardFields } from "./boards-Cim1GTKc.mjs";
|
|
3
|
+
import { a as buildTree, f as isBoardName, l as framesOn, o as flatten, t as ALL_SCENES, w as PROPOSED_PUBLISH } from "./board-tree-DGj0HhEE.mjs";
|
|
4
|
+
import { g as PUBLISHABLE, s as scanFrames, v as publishableStatus } from "./manifest-CK8Qh4Nq.mjs";
|
|
5
5
|
import { a as readLog, o as shareable, r as legacyExposure, t as appendEvents } from "./comments-0BSbb04K.mjs";
|
|
6
6
|
import { t as detectHost } from "./detect-C0wpaePX.mjs";
|
|
7
|
-
import {
|
|
8
|
-
import { n as
|
|
9
|
-
import {
|
|
10
|
-
import { i as
|
|
7
|
+
import { a as publishLogo, r as logoIcons } from "./logo-C9s7-Cy9.mjs";
|
|
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-CL8_wL7a.mjs";
|
|
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
|
-
import {
|
|
12
|
+
import { dirname, join, sep } from "node:path";
|
|
13
13
|
import { fileURLToPath } from "node:url";
|
|
14
14
|
import { createHash, randomBytes } from "node:crypto";
|
|
15
15
|
import { build } from "vite";
|
|
@@ -558,8 +558,9 @@ async function buildSite(root, boardsFlag, allBoardsFlag, embedSeeds, textures =
|
|
|
558
558
|
const pkgDir = packageDir();
|
|
559
559
|
const clientDir = join(pkgDir, "src", "client");
|
|
560
560
|
const outDir = join(root, "design", ".dist");
|
|
561
|
+
const identity = canvasIdentity(root, config);
|
|
561
562
|
const manifest = scanFrames(root, {
|
|
562
|
-
name:
|
|
563
|
+
name: identity.local,
|
|
563
564
|
description: config.description
|
|
564
565
|
});
|
|
565
566
|
const allBoards = readBoards(root);
|
|
@@ -789,7 +790,7 @@ async function buildSite(root, boardsFlag, allBoardsFlag, embedSeeds, textures =
|
|
|
789
790
|
const realAssets = existsSync(assetsDir) ? realpathSync(assetsDir) : null;
|
|
790
791
|
for (const r of refs) {
|
|
791
792
|
if (!isLocalAssetRef(r) || !r.endsWith(".poster.png") || existsSync(join(assetsDir, r))) continue;
|
|
792
|
-
const { ensurePoster } = await import("./poster-
|
|
793
|
+
const { ensurePoster } = await import("./poster-B7uSjlEP.mjs");
|
|
793
794
|
const g = await ensurePoster(assetsDir, r.slice(0, -11));
|
|
794
795
|
if (!g.ok) throw new Error(`design/assets/${r}: ${g.error}`);
|
|
795
796
|
console.log(` poster: rendered design/assets/${r} (${g.width}×${g.height})`);
|
|
@@ -832,12 +833,8 @@ async function buildSite(root, boardsFlag, allBoardsFlag, embedSeeds, textures =
|
|
|
832
833
|
if (seeded) console.log(` comments: ${seeded} board log${seeded === 1 ? "" : "s"} seeded${embedSeeds ? "" : " (design/.dist-seeds, outside the web root)"}`);
|
|
833
834
|
if (seeded && embedSeeds) console.log(" WARNING: --embed-seeds put comment history in the web root - every event carries\n its author's email, readable by anyone who can reach the deployed files.");
|
|
834
835
|
}
|
|
835
|
-
|
|
836
|
-
|
|
837
|
-
name = JSON.parse(readFileSync(join(root, "package.json"), "utf8")).name ?? name;
|
|
838
|
-
} catch {}
|
|
839
|
-
if (config.share.name) name = config.share.name;
|
|
840
|
-
const logo = publishLogo(root, config.share.logo, outDir, (m) => console.warn(` ${m}`));
|
|
836
|
+
const name = identity.published;
|
|
837
|
+
const logo = publishLogo(root, identity.logos, outDir, (m) => console.warn(` ${m}`));
|
|
841
838
|
if (logo) writeFileSync(join(outDir, "index.html"), logoIcons(readFileSync(join(outDir, "index.html"), "utf8"), logo));
|
|
842
839
|
writeFileSync(join(outDir, "meta.json"), JSON.stringify({
|
|
843
840
|
name,
|
|
@@ -852,7 +849,7 @@ async function buildSite(root, boardsFlag, allBoardsFlag, embedSeeds, textures =
|
|
|
852
849
|
}));
|
|
853
850
|
let textureLine = " textures: skipped (--no-textures)";
|
|
854
851
|
if (textures && bakeGen) {
|
|
855
|
-
const { bakePublished } = await import("./publish-bakes-
|
|
852
|
+
const { bakePublished } = await import("./publish-bakes-BjgDNeyS.mjs");
|
|
856
853
|
const pubFrameFile = new Map(pubFrames.map((f) => [f.id, f]));
|
|
857
854
|
const r = await bakePublished({
|
|
858
855
|
root,
|
|
@@ -1,5 +1,5 @@
|
|
|
1
1
|
import { t as __exportAll } from "./rolldown-runtime-8H4AJuhK.mjs";
|
|
2
|
-
import { m as BOUNDS } from "./slots-
|
|
2
|
+
import { m as BOUNDS } from "./slots-BOcfIqxy.mjs";
|
|
3
3
|
import { n as readTarget } from "./anchor-5H1vnoLu.mjs";
|
|
4
4
|
import { closeSync, copyFileSync, existsSync, fsyncSync, mkdirSync, openSync, readFileSync, realpathSync, renameSync, rmSync, writeFileSync, writeSync } from "node:fs";
|
|
5
5
|
import { join, relative, resolve, sep } from "node:path";
|
package/dist/cli.mjs
CHANGED
|
@@ -82,7 +82,7 @@ cli.command("init", "Scaffold design/ in this repo").option("--mode <mode>", "st
|
|
|
82
82
|
console.error(`[${NAME}] --kind ${opts.kind}: use product or knowledge`);
|
|
83
83
|
process.exit(1);
|
|
84
84
|
}
|
|
85
|
-
const { init } = await import("./init-
|
|
85
|
+
const { init } = await import("./init-BgusplYn.mjs");
|
|
86
86
|
init(resolve$1(opts.root), {
|
|
87
87
|
mode: opts.mode === "embedded" ? "embedded" : "studio",
|
|
88
88
|
demo: opts.demo !== false,
|
|
@@ -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-BBZe_brH.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-ByuFQOF9.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
|
|
@@ -115,10 +115,10 @@ for (const [name, desc] of [["dev", "Start the local canvas (everything on: hot
|
|
|
115
115
|
}
|
|
116
116
|
});
|
|
117
117
|
cli.command("ls", "The canvases running on this Mac: slot, link, name, version, state, uptime, folder (no repo needed)").option("--json", "Machine-readable output (never a canvas's key)").action(async (opts) => {
|
|
118
|
-
(await import("./ls-
|
|
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-BNssmbqd.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);
|
|
@@ -128,7 +128,7 @@ cli.command("build", "Static export → design/.dist (what ships comes from desi
|
|
|
128
128
|
}
|
|
129
129
|
});
|
|
130
130
|
cli.command("serve", "Serve design/.dist (set MARVER_PASSWORD to gate it)").option("--root <dir>", "Host repo root", { default: "." }).option("--port <port>", "Port (default $PORT or 4199)").action(async (opts) => {
|
|
131
|
-
const { serve } = await import("./serve-
|
|
131
|
+
const { serve } = await import("./serve-kcF6-H8V.mjs");
|
|
132
132
|
let port;
|
|
133
133
|
if (opts.port !== void 0) {
|
|
134
134
|
const n = Number(opts.port);
|
|
@@ -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> · invite <email> · revoke <email
|
|
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 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-BakJQwaf.mjs");
|
|
141
141
|
try {
|
|
142
142
|
await commentsCommand(resolve$1(opts.root), action, value, opts);
|
|
143
143
|
} catch (err) {
|
|
@@ -146,7 +146,7 @@ cli.command("comments <action> [value]", "Comment collaboration: connect <url>
|
|
|
146
146
|
}
|
|
147
147
|
});
|
|
148
148
|
cli.command("share <action> [value]", "Sharing roster (owner): add <who> · remove <who> · block/unblock <email> · general <mode> · list · requests · explain <who> · who").option("--root <dir>", "Host repo root", { default: "." }).option("--role <role>", "add / requests --approve: view (default) or comment").option("--expires <iso>", "add: expiry timestamp, e.g. 2026-12-31T00:00:00Z").option("--approve <email>", "requests: approve this pending request (canvas-wide in v1)").option("--decline <email>", "requests: decline this pending request (silent to the asker)").option("--json", "list: machine-readable output").action(async (action, value, opts) => {
|
|
149
|
-
const { shareCommand } = await import("./share-
|
|
149
|
+
const { shareCommand } = await import("./share-CS2mg27O.mjs");
|
|
150
150
|
try {
|
|
151
151
|
await shareCommand(resolve$1(opts.root), action, value, opts);
|
|
152
152
|
} catch (err) {
|
|
@@ -155,7 +155,7 @@ cli.command("share <action> [value]", "Sharing roster (owner): add <who> · remo
|
|
|
155
155
|
}
|
|
156
156
|
});
|
|
157
157
|
cli.command("work <action> [...frames]", "Working state on the canvas: start <scene/frame ...> · done <scene/frame ...> | --all · list").option("--root <dir>", "Host repo root", { default: "." }).option("--ttl <minutes>", "start: minutes before the glow self-expires (default 10, max 30)").option("--all", "done: clear every working frame").action(async (action, frames, opts) => {
|
|
158
|
-
const { workCommand } = await import("./work-
|
|
158
|
+
const { workCommand } = await import("./work-DRdzXPvg.mjs");
|
|
159
159
|
try {
|
|
160
160
|
await workCommand(resolve$1(opts.root), action, frames ?? [], opts);
|
|
161
161
|
} catch (err) {
|
|
@@ -164,7 +164,7 @@ cli.command("work <action> [...frames]", "Working state on the canvas: start <sc
|
|
|
164
164
|
}
|
|
165
165
|
});
|
|
166
166
|
cli.command("jam <action> [...args]", "Live Jam from your coding-agent session: next · say <handle> <words> · progress <handle> · done <handle> --file <f> · release <handle> · status · mute (hook, listen and permit are run by the tools themselves)").option("--root <dir>", "Host repo root (default: the repo above this folder)").option("--as <connection>", "the connection Marver Jam named (Cursor)").option("--file <file>", "done: the final message (the marver-reply blocks)").option("--json", "print the answer as JSON").action(async (action, args, opts) => {
|
|
167
|
-
const jam = await import("./jam-
|
|
167
|
+
const jam = await import("./jam-CkuLL8A8.mjs");
|
|
168
168
|
if (action === "hook") return jam.hookCommand(args[0] ?? "", args[1] ?? "", opts.root);
|
|
169
169
|
if (action === "listen") return jam.listenCommand(opts.root);
|
|
170
170
|
if (action === "permit") return (await import("./permit-DDa6wqOs.mjs").then((n) => n.n)).permitCommand();
|
|
@@ -177,8 +177,8 @@ cli.command("jam <action> [...args]", "Live Jam from your coding-agent session:
|
|
|
177
177
|
process.exit(1);
|
|
178
178
|
}
|
|
179
179
|
});
|
|
180
|
-
cli.command("link [...targets]", "The canvas link that lands on frames: link <scene/frame | scene ...> - their board, in canvas mode, selected and fitted").option("--root <dir>", "Host repo root", { default: "." }).option("--board <board>", "The board to open (default: the first board that shows them all, else one link per board)").action(async (targets, opts) => {
|
|
181
|
-
const { linkCommand } = await import("./link-
|
|
180
|
+
cli.command("link [...targets]", "The canvas link that lands on frames (needs `dev` running): link <scene/frame | scene ...> - their board, in canvas mode, selected and fitted; a bare name is a scene, never a board (a whole board: its scenes with --board <board>). A marver:// link when the Mac app has this canvas open, else localhost").option("--root <dir>", "Host repo root", { default: "." }).option("--board <board>", "The board to open (default: the first board that shows them all, else one link per board)").option("--web", "The localhost link even when the Mac app has this canvas open").action(async (targets, opts) => {
|
|
181
|
+
const { linkCommand } = await import("./link-Cmt9Xy4X.mjs");
|
|
182
182
|
try {
|
|
183
183
|
await linkCommand(resolve$1(opts.root), targets ?? [], opts);
|
|
184
184
|
} catch (err) {
|
|
@@ -186,8 +186,17 @@ cli.command("link [...targets]", "The canvas link that lands on frames: link <sc
|
|
|
186
186
|
process.exit(1);
|
|
187
187
|
}
|
|
188
188
|
});
|
|
189
|
+
cli.command("show [...targets]", "Show the human a place - only when they ask to be shown (needs `dev` running): show <scene/frame | scene ... | board> - a bare name is a frame or scene first, else a board, fitted whole; every open tab of this canvas goes there, selected and fitted (a tab holding unsent words shows a notice instead); then the link").option("--root <dir>", "Host repo root", { default: "." }).option("--board <board>", "The board to show them on (default: the first board that shows them all)").option("--thread <id>", "A comment thread to open there too: its id from `comments list`, with its frame or board still named (show <scene/frame> --thread <id>); it opens only on its own board, so pass --board when the frame sits on more than one").option("--web", "Print the localhost link even when the Mac app has this canvas open").action(async (targets, opts) => {
|
|
190
|
+
const { showCommand } = await import("./show-B1u3DiJw.mjs");
|
|
191
|
+
try {
|
|
192
|
+
await showCommand(resolve$1(opts.root), targets ?? [], opts);
|
|
193
|
+
} catch (err) {
|
|
194
|
+
console.error(`[${NAME}] ${err.message}`);
|
|
195
|
+
process.exit(1);
|
|
196
|
+
}
|
|
197
|
+
});
|
|
189
198
|
cli.command("boards [action] [...args]", "The sidebar as files: every folder and board in reading order, with types and statuses, and the frames on no board · new <name>: a board in its type's starting layout · pin <board> <scene/frame ...>: put frames on a board · place <board> <scene/frame> --after|--before <scene/frame>: put a frame next to another, making room").option("--root <dir>", "Host repo root", { default: "." }).option("--json", "The tree as JSON ({ tree, boards, landing, unplaced, registry })").option("--type <type>", "new: start | feature | surface | project | feedback | context | deck | archive (default: the folder's)").option("--folder <folder>", "new: the folder it sits in").option("--title <title>", "new: what humans see").option("--description <sentence>", "new: what agents read").option("--capability <slug>", "new: the capability it shows, when not its own name").option("--after <frame>", "place: right after this frame, in its row").option("--before <frame>", "place: right before this frame, in its row").option("--run <handle>", "place, pin: a Live Jam run's new frame - given to that run first (r-xxxxxxxx.N)").option("--as <conn>", "place --run, pin --run: the session connection to speak for (as `jam` does)").action(async (action, args, opts) => {
|
|
190
|
-
const { boardsCommand, boardsNew, boardsPin, boardsPinRun, boardsPlace } = await import("./boards-
|
|
199
|
+
const { boardsCommand, boardsNew, boardsPin, boardsPinRun, boardsPlace } = await import("./boards-OlAhZ87x.mjs");
|
|
191
200
|
const [name, ...frames] = args ?? [];
|
|
192
201
|
try {
|
|
193
202
|
if (action === void 0) boardsCommand(resolve$1(opts.root), opts);
|
|
@@ -216,7 +225,7 @@ cli.command("boards [action] [...args]", "The sidebar as files: every folder and
|
|
|
216
225
|
}
|
|
217
226
|
});
|
|
218
227
|
cli.command("folders <action> [...modules]", "The shared sidebar's typed folders · add <start|features|surfaces|projects|feedback|context|decks|archive ...>").option("--root <dir>", "Host repo root", { default: "." }).action(async (action, modules, opts) => {
|
|
219
|
-
const { foldersAdd } = await import("./boards-
|
|
228
|
+
const { foldersAdd } = await import("./boards-OlAhZ87x.mjs");
|
|
220
229
|
try {
|
|
221
230
|
if (action !== "add") throw new Error(`unknown action "${action}" - \`folders add <module ...>\``);
|
|
222
231
|
const { added, existing } = foldersAdd(resolve$1(opts.root), modules);
|
|
@@ -228,7 +237,7 @@ cli.command("folders <action> [...modules]", "The shared sidebar's typed folders
|
|
|
228
237
|
}
|
|
229
238
|
});
|
|
230
239
|
cli.command("context <action>", "The project's context/ (spec 19) · init: create it · check: keep it true (exit 0 pass, 1 fail, 2 cannot determine) · index: regenerate the index's capability table").option("--root <dir>", "Host repo root", { default: "." }).option("--base <ref>", "check: the pull request's base - a change to a contracted capability's code must change its contract or say why (in ci, read from the event)").option("--head <ref>", "check: the pull request's head (default HEAD)").option("--body-file <file>", "check: the pull request's body, for `no-contract-change: <capability> - <why>`").option("--json", "check: the findings as JSON ({ exit, failures, unsure, notes })").option("--kind <kind>", "init: product (a shipped record) or knowledge (a delivered record)", { default: "product" }).action(async (action, opts) => {
|
|
231
|
-
const ctx = await import("./context-
|
|
240
|
+
const ctx = await import("./context-Cj2TcC0H.mjs");
|
|
232
241
|
const root = resolve$1(opts.root);
|
|
233
242
|
try {
|
|
234
243
|
if (action === "init") {
|
|
@@ -263,8 +272,8 @@ cli.command("context <action>", "The project's context/ (spec 19) · init: creat
|
|
|
263
272
|
process.exit(1);
|
|
264
273
|
}
|
|
265
274
|
});
|
|
266
|
-
cli.command("marks", "What the human has not reviewed: frames waiting on them (the ones that ask first), their answers nothing has acted on yet,
|
|
267
|
-
const { marksCommand } = await import("./marks-
|
|
275
|
+
cli.command("marks", "What the human has not reviewed: frames waiting on them (the ones that ask first), their answers nothing has acted on yet, frames new since they looked, and the open conversations per board (more than 10: offer `comments resolve --all` to the human - never run it on your own)").option("--root <dir>", "Host repo root", { default: "." }).option("--json", "Machine-readable output").option("--all", "Also list the answers from before 0.26 that may already be handled").action(async (opts) => {
|
|
276
|
+
const { marksCommand } = await import("./marks-Dt-5JXCp.mjs");
|
|
268
277
|
marksCommand(resolve$1(opts.root), opts);
|
|
269
278
|
});
|
|
270
279
|
cli.command("perf [action] [board]", "The reload log: what each edit reloaded, page-wide reloads, the slowest frames to settle, one line per board load; --loads: what each board load did; --jam: Jam's timings; `perf run <board>`: a headless run of the board, read-only (needs `dev` running); --runs: those runs compared; --crashes, --flashes, --machine: the Mac app's records; --all: every canvas this Mac knows, one summary; --live: a tail in the terminal").option("--root <dir>", "Host repo root", { default: "." }).option("--minutes <n>", "How far back to read (default 60; 24 h with --jam)").option("--loads", "Board loads, from the page, each board by its title: time to the visible frames ready and all ready (each frame's first render), still from the last move and settled (a second still after it) - or why it was cut, and how many frames were ready by then - how many moves and their causes, when the first frame started, the slowest frames to settle (their last height) and how long each waited for its turn to start, errors (design/.local/perf/page.jsonl)").option("--jam", "Jam's timings: captures, pictures, words, naming, runs, shots - numbers only (design/.local/perf/jam.jsonl)").option("--runs", "The headless runs (`perf run`), compared only inside a cohort (script, board, Chrome, flags, machine, power, --slow, bakes): the latest against the one before with the same inputs, and against the last with other inputs; overlapped and invalid runs listed apart (design/.local/perf/runs.jsonl)").option("--against <run>", "With --runs: the latest run of that run's cohort against it, whatever their inputs (you changed something on purpose)").option("--crashes", "The Mac app's crashes and hangs of this repo's canvases, each joined to its board load by page (what had settled, the last gesture), the minute before it, and the GPU and utility processes' ends by time (~/.marver/perf/app.jsonl, app-dev.jsonl)").option("--flashes", "The flashes marked in the Mac app (⌃⌥F) on this repo's canvases: the board, the gesture the mark fell in (or the one ending within 2 s of it), the GPU process's events, pressure at the mark, the GPU figures and the picture's path; the white-out detector's candidates apart, automatic and not verified").option("--machine", "The machine profiles the Mac app and headless runs wrote (~/.marver/perf/machine), by host, which is current, and how many records and runs name each").option("--all", "Every canvas this Mac knows (running, or that the app remembers): one summary per canvas and the Mac app's, no repo needed; with --live, every known canvas's live files; with --flashes, also the marks made on other canvases or on Home").option("--live", "A tail in the terminal: the live files of this repo (--all: every known canvas) and the app's app.jsonl, from now, one line per record - about 3 s behind (Ctrl-C ends it)").option("--kinds <list>", "With --live: only these kinds, comma-separated (load,cmd,error, ...)").option("--days <n>", "How far back --all, --runs, --crashes, --flashes and --machine read (default 14)").option("--slow", "With `run`: the CPU throttled 4x (a stand-in for a slower Mac's CPU, not its GPU or memory)").option("--repeat <n>", "With `run`: how many runs, one after another (1-5, default 1)").option("--recorder <level>", "With `run`: core (only what the run's driver reads, 0.29's load tracking) or full (everything the recorder records, the default); the two never compare as one").option("--json", "Machine-readable output").action(async (action, board, opts) => {
|
|
@@ -272,7 +281,7 @@ cli.command("perf [action] [board]", "The reload log: what each edit reloaded, p
|
|
|
272
281
|
console.error(`[${NAME}] unknown action "${action}" - the one action is run: ${NAME} perf run <board>`);
|
|
273
282
|
process.exit(1);
|
|
274
283
|
}
|
|
275
|
-
const { perfCommand, perfRunCommand } = await import("./perf-
|
|
284
|
+
const { perfCommand, perfRunCommand } = await import("./perf-CIMijND6.mjs");
|
|
276
285
|
const typed = (v) => typeof v === "number" ? process.argv.find((t) => !t.startsWith("-") && Number(t) === v) ?? String(v) : v === void 0 ? void 0 : String(v);
|
|
277
286
|
if (action !== "run") return perfCommand(resolve$1(opts.root), {
|
|
278
287
|
...opts,
|
|
@@ -286,7 +295,7 @@ cli.command("perf [action] [board]", "The reload log: what each edit reloaded, p
|
|
|
286
295
|
}
|
|
287
296
|
});
|
|
288
297
|
cli.command("shot [...frames]", "Render frames headless and print the PNG paths (needs `dev` running): ids, --scene <name> or --all").option("--root <dir>", "Host repo root", { default: "." }).option("--scene <name>", "Every frame of one scene").option("--all", "Every frame of the canvas").option("--theme <name>", "Theme to render (default: light)").option("--scale <n>", "Device pixels per CSS px, 1-4 (default: 2; 4 for print-quality stills)").option("--json", "Print the results as JSON ({ results: [...] }) instead of paths").action(async (frames, opts) => {
|
|
289
|
-
const { shotCommand } = await import("./shot-
|
|
298
|
+
const { shotCommand } = await import("./shot-D2TQGo2V.mjs");
|
|
290
299
|
try {
|
|
291
300
|
await shotCommand(resolve$1(opts.root), frames, opts);
|
|
292
301
|
} catch (err) {
|
|
@@ -294,6 +303,15 @@ cli.command("shot [...frames]", "Render frames headless and print the PNG paths
|
|
|
294
303
|
process.exit(1);
|
|
295
304
|
}
|
|
296
305
|
});
|
|
306
|
+
cli.command("pdf [board]", "A board as a PDF (needs `dev` running): a slides board's deck one page per slide, any other board one page per frame - design/exports/<board>.pdf").option("--root <dir>", "Host repo root", { default: "." }).option("--theme <name>", "Theme to print (default: each page's theme on the board, else its frame's own, else light)").option("--notes", "A handout instead: each slide with its title and its notes (design/exports/<board>-notes.pdf)").option("--paper <size>", "The handout's paper, landscape: letter (default) or a4").option("--out <file>", "Where to write the PDF").option("--raster", "Every page a picture (3x) - no vector text").option("--vector", "Patch nothing: every page as Chrome prints it").option("--keep-going", "A slide that fails to render is left blank and named, instead of failing the export").option("--json", "Print the report as JSON, with the file's absolute path (file)").action(async (board, opts) => {
|
|
307
|
+
const { pdfCommand } = await import("./pdf-0m721FFn.mjs");
|
|
308
|
+
try {
|
|
309
|
+
process.exit(await pdfCommand(resolve$1(opts.root), board, opts));
|
|
310
|
+
} catch (err) {
|
|
311
|
+
console.error(`[${NAME}] ${err.message}`);
|
|
312
|
+
process.exit(1);
|
|
313
|
+
}
|
|
314
|
+
});
|
|
297
315
|
cli.help();
|
|
298
316
|
cli.version(version());
|
|
299
317
|
cli.parse();
|