@marver-design/marver 0.19.1 → 0.20.0

package/CHANGELOG.md

@@ -2,6 +2,83 @@
 
 Notable changes to `@marver-design/marver`. Format follows [Keep a Changelog](https://keepachangelog.com); versions follow semver.
 
+## 0.20.0 - 2026-10-01
+
+### Changed
+
+- **A slide is any frame with `slide: true` - nothing else.** The slide type keeps everything
+  a deck needs around the frame: the badge, the board's reading order as the deck order, slides
+  mode, publishing as a deck, comments and laser in play. What goes inside is the author's own
+  code: any layout, typeface, drawing or animation. `<Slide>` is now an optional wrapper that
+  fills the frame. **Breaking for decks built on it:** it no longer pads the stage, centres the
+  content, sets the `sl-*` type sizes, freezes animation at rest or outlines an overflow, and
+  the `sl-*` classes carry no styles - such a deck still plays, and needs its own styles to look
+  as it did.
+- **The host scales the stage, not the slide.** A slide never reflows. Slides mode renders each
+  slide at its stage and scales the whole stage to the window, up as well as down - a projector
+  shows the deck at full size without the presenter picking Fill (the Slide device never went
+  past 100% before); Fill window now fits the same stage edge to edge, and slides mode offers no
+  viewport presets. A slide frame met in present or focus plays the same way - a device preset
+  never reflows it. A canvas node resized away from the stage shows it scaled and centred, like
+  a thumbnail, with comment pins mapped through the same fit; published sleep textures are
+  baked at the stage.
+- **A deck chooses its stage.** A slide's stage is the `viewport` it declares, when the project
+  defines it - `viewport: 'laptop'` makes a 16:10 deck at 1280×800 - else 1280×720. The canvas,
+  `marver shot`, copy as image and slides mode all use it.
+- **The slides guidance teaches instead of ruling.** `instructions/slides.md` drops the fixed
+  type roles, margins, bands, spacing scale, pacing quotas, recipe budgets and the defect
+  gate. In their place: how a slide plays and animates, the deck kit a strong deck is built on
+  (a master shell, whole-slide tones, the brand's type, hairlines and labels, a drawing
+  helper), ten craft habits distilled from the best decks built on marver, the method (the
+  answer first, a slide list that tells the argument, a `_brief.md`, an Aim / Say / Visual /
+  Source note per slide) and a review that squints at the contact sheet.
+  `reference/deck-layouts.md` becomes an idea bank, with the compositions of a strong
+  consulting deck described one by one. A new project's `design/slides.md` opens with a deck
+  look shaped the same way. Existing projects keep their `design/slides.md`; `marver init`
+  updates unedited shipped instructions and stages edited ones in `design/.local/latest/`.
+- **Docs.** [docs/slides.md](docs/slides.md) and the README's Slides section describe the new
+  model (a slide is code; the host scales the stage; motion hooks; the deck kit), with a section
+  for decks built before 0.20. [docs/sticky-notes.md](docs/sticky-notes.md) shows a note beside a
+  slide as the presenter's script - Aim / Say / Visual / Source context - and that published notes
+  are readable by viewers.
+
+### Added
+
+- **Motion hooks for any slide.** While a deck plays, the stage marks `data-sl-play` on
+  `<html>`, `data-sl-entered` once each slide has arrived, and `data-mv-slide` while the
+  mounted frame is a slide, so a slide's own CSS or JS animation runs when it arrives and the
+  canvas, `marver shot` and thumbnails show the finished slide. `useSlidePlay()` is exported from
+  `/content` for React. The `data-animate` entrance shortcuts and the `--marver-slide-tempo`
+  duration now work on any slide, wrapper or not, and every slide document shares one baseline
+  (no body margin) in every host, so its geometry never depends on what played before it.
+- **`Chart` and `Img` know a slide frame without the wrapper.** Labels take the stage scale and
+  images skip the canvas's decoded-to-size path, so a slide scaled up on a projector stays sharp.
+  `Chart` also reads `--marver-slide-accent`.
+
+### Upgrading
+
+- Run `npx marver init` to take the new slides guidance (unedited instruction files update in
+  place; edited ones are staged in `design/.local/latest/` for your agent to merge).
+- A deck built on `<Slide>` and the `sl-*` classes keeps playing but loses its padding, centring
+  and type sizes. Ask your agent to give it a deck kit (instructions/slides.md describes one), or
+  stay on 0.19 until you do.
+- A deck of ordinary frames becomes a slide deck by adding `slide: true` to each frame's meta -
+  keep its `viewport` if it was designed at one (a 1280×800 deck stays 16:10) - and setting its
+  publish row to `"type": "slides"`.
+
+## 0.19.2 - 2026-09-09
+
+### Fixed
+
+- **A note longer than its frame gets its room below.** 0.19.1 reserved a note's width beside its
+  frame and nothing under it: a long note ran on below the card and over the next row's notes and
+  frames. The column's height is now measured as it renders (markdown, fonts and diagrams decide
+  it) and fed to the layout: a composed board's next row starts under the note, the gutter still
+  the card's, and a board already saved re-applies its recipe when a note lands or grows past its
+  frame, as it did for width. Two columns running into each other count as cramped too; the empty
+  canvas under a card beside a long column is free. Leaving a device view re-checks the room the
+  restored rows have. Folding a note keeps its room, so a fold never moves the board.
+
 ## 0.19.1 - 2026-09-08
 
 ### Fixed

package/README.md

@@ -31,7 +31,7 @@ Frames appear on the canvas the moment the files land. That's the loop.
 ## Why marver
 
 - **Frames are real code.** Plain TSX/HTML files rendered from your repo's actual components and theme - zero imports from this package required. An approved design promotes into the app by moving a file, not by re-implementing a picture.
-- **Decks are real code too.** A slide is a frame with `slide: true`. One `Slide` primitive, your own markup inside it, a doctrine that teaches the agent to argue rather than decorate - and a stage that scales itself to any screen without the agent writing a single breakpoint. See [Slides](#slides).
+- **Decks are real code too.** A slide is a frame with `slide: true` - nothing else. Any layout, typeface, drawing or animation the browser can render, a guide that teaches the agent to argue and to wear your brand rather than decorate, and a player that scales the stage to any screen without the agent writing a single breakpoint. See [Slides](#slides).
 - **Everything hot-reloads.** The agent writes, you watch it land - live.
 - **True viewports.** Each frame is a real iframe: drag its edge and your actual breakpoints fire.
 - **Your agent answers on the canvas.** Tag `@marver` in a comment and it picks up the job, edits the real source, and replies in the thread - no wiring, on by default. See [Live Jam](#live-jam).
@@ -45,23 +45,21 @@ Frames appear on the canvas the moment the files land. That's the loop.
 - **Prototype links.** `data-goto="scene/frame"` on any element links frames into a walkable prototype - across boards, too.
 - **Five ways to view a board.** The canvas (frames on a plane), the board (the same, tidy), **present** (`p`: a full-screen clickable walkthrough - `data-goto` navigates, arrows step, `[` / `]` cycle variants, laser, comments, theme and device pickers in the toolbar), **focus** (one frame as a document - the reading preset for specs), and **slides** (a deck). A published board names its landing view; a frame deep link opens straight into it.
 - **Content frames.** Specs, Mermaid diagrams, mood boards, and slides live on the same canvas as the screens - import `Doc`, `Md`, `Diagram`, `Img`, `Slide`, `Chart`, `Video` from `@marver-design/marver/content` and think a feature through before any pixels exist. Works in a repo with no app at all: idea first, design second.
-- **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; published canvases carry them.
+- **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.
 - **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.
 - **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.
-- **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 slide is 5120×2880). Paste into Slack, a doc, or a chat with your agent.
+- **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.
 
 ## Slides
 
-A deck is a scene of `slide: true` frames. On the canvas they are 1280×720 frames like any other - comment on them, laser them, fork variants, drag them to reorder the deck (the board's reading order is the play order). Press `p` on a slides board and you get slides mode: the 16:9 stage, arrows / Space / click to advance, `d` cycles the theme, devices including fill window, morphs between slides where the agent named the same element twice.
+A deck is a scene of `slide: true` frames. On the canvas they are frames like any other - comment on them, laser them, fork variants, drag them to reorder the deck (the board's reading order is the play order). Press `p` on a slides board and you get slides mode: arrows / Space / click to advance, `d` cycles the theme, morphs between slides where the agent named the same element twice.
 
-What makes it light on the agent side, and good on every screen:
+- **A slide is just code.** No component library, no wrapper, no fixed type scale: the agent builds each slide from your project's own components and styles - an intricate diagram, a full-bleed photograph, an SVG drawing that animates in - the way it builds a screen.
+- **A stage, and a player that scales it.** A slide renders at 1280×720, or at the `viewport` it declares (a 16:10 deck at 1280×800). Slides mode scales the whole stage to the screen - up on a projector, down on a phone - so the composition you approved is the one everyone sees.
+- **Still at rest, alive in play.** On the canvas a resting slide is asleep like any frame; while the deck plays, the stage marks `data-sl-play` and `data-sl-entered` on the document so the agent's own animations run when a slide arrives, and `view-transition-name` morphs carry elements from one slide to the next.
+- **Craft, not rules.** `init` ships `design/instructions/slides.md`: the deck kit a strong deck is built on (a master, whole-slide tones, the brand's type, a drawing system), the habits that make a deck look made rather than typed, the method (the answer first, a slide list that tells the argument, notes that carry the talk track), an idea bank of compositions, and your own project-owned `design/slides.md` with a **deck look** the agent drafts from your brand.
 
-- **One primitive, no component library.** `Slide` owns the stage, the margins, six fixed type roles, your theme's tokens, and the motion contract. Everything inside is your project's own markup and components - a slide is built the way a screen is built.
-- **The fit is pure CSS.** The agent authors at exactly 1280×720; the root scales and centers itself to a phone, a laptop, a projector, or a resized canvas node. No `vw`, no media queries, no breakpoints - the composition you approved is the composition everyone sees, and a dev-only overflow marker outlines a slide whose content escapes the stage, or whose flex/grid child outgrows its parent.
-- **Still at rest.** Charts are final-state SVG in a lazy chunk, videos are posters, and every CSS animation under `Slide` is suspended until slides mode plays - so a 40-slide deck of the shipped primitives pans like 40 statics on the canvas. (Your own `<canvas>`, `<video>`, or JS-driven motion stays live, as in any frame.)
-- **A doctrine, not a template.** `init` ships `design/instructions/slides.md`: assertion-first argument, the space (three bands, the 85% rule, one spacing scale), seven silhouettes chosen before any recipe so a deck never reads as one repeated shape, 19 recipes with budgets, choreography rules, and a review gate - plus two depth references and your own project-owned `design/slides.md` with a fill-in **deck look** the agent drafts from your brand.
-
-Publish a deck with `{ "boards": { "pitch": { "max": "read", "type": "slides", "open": "slides", "lock": true } } }` in `design/publish.json` and the link opens straight into the deck, read-only, with no canvas behind it. The [slides guide](docs/slides.md) has the rest - morphs, build steps, `Chart` and `Video`, the theme tokens.
+Publish a deck with `{ "boards": { "pitch": { "max": "read", "type": "slides", "open": "slides", "lock": true } } }` in `design/publish.json` and the link opens straight into the deck, read-only, with no canvas behind it. The [slides guide](docs/slides.md) has the rest - motion, build steps, `Chart` and `Video`, notes.
 
 ## Collaboration
 

package/dist/{bake-kaf5kGZ7.mjs → bake-tAb0D6Rc.mjs}

@@ -1,4 +1,4 @@
-import { AREA, SURFACE, pool, shotConcurrency, withBrowser } from "./shot-DMDvDbeP.mjs";
+import { AREA, SURFACE, pool, shotConcurrency, withBrowser } from "./shot-iw3SEcpn.mjs";
 import { existsSync, mkdirSync, readFileSync, readdirSync, realpathSync, renameSync, rmSync, statSync, utimesSync, writeFileSync } from "node:fs";
 import { join, sep } from "node:path";
 import { createHash } from "node:crypto";

package/dist/{build-7ed5H2vT.mjs → build-DwpNPl6Z.mjs}

@@ -1,7 +1,7 @@
 import { a as ROUTE, r as NAME } from "./cli.mjs";
 import { a as listBoardFiles, d as flatten, f as isBoardName, n as checkBoardsDir, s as readRegistry, t as boardFields, u as buildTree } from "./boards-BmxcT3Lc.mjs";
 import { c as loadConfig, r as scanFrames, u as detectHost } from "./manifest-B01PSyDc.mjs";
-import { n as tailwind3Css, r as tailwind4Plugin, t as marverPlugin } from "./plugin-DI-7NAnx.mjs";
+import { n as tailwind3Css, r as tailwind4Plugin, t as marverPlugin } from "./plugin-y4Ch7o_A.mjs";
 import { cpSync, existsSync, mkdirSync, readFileSync, realpathSync, rmSync, writeFileSync } from "node:fs";
 import { basename, dirname, join, sep } from "node:path";
 import { fileURLToPath } from "node:url";
@@ -683,7 +683,7 @@ async function buildSite(root, boardsFlag, allBoardsFlag, embedSeeds, textures =
 	const realAssets = existsSync(assetsDir) ? realpathSync(assetsDir) : null;
 	for (const r of refs) {
 		if (!isLocalAssetRef(r) || !r.endsWith(".poster.png") || existsSync(join(assetsDir, r))) continue;
-		const { ensurePoster } = await import("./poster-DNh6N27C.mjs");
+		const { ensurePoster } = await import("./poster-FCv_nXyP.mjs");
 		const g = await ensurePoster(assetsDir, r.slice(0, -11));
 		if (!g.ok) throw new Error(`design/assets/${r}: ${g.error}`);
 		console.log(`  poster: rendered design/assets/${r} (${g.width}×${g.height})`);
@@ -750,7 +750,7 @@ async function buildSite(root, boardsFlag, allBoardsFlag, embedSeeds, textures =
 	}));
 	let textureLine = "  textures: skipped (--no-textures)";
 	if (textures && bakeGen) {
-		const { bakePublished } = await import("./publish-bakes-Dp-ZFk3d.mjs");
+		const { bakePublished } = await import("./publish-bakes-XH6Bac58.mjs");
 		const pubFrameFile = new Map(pubFrames.map((f) => [f.id, f]));
 		const r = await bakePublished({
 			root,

package/dist/cli.mjs

@@ -17,19 +17,25 @@ const CONTENT_WIDTH = {
 	document: 760,
 	wide: 1280
 };
-/** The slide stage (v1.5): a runtime-reserved intrinsic, deliberately NOT a
-*  config viewport - no migration for existing projects, no deck device in
-*  sweeps. Dependency-neutral so server (shot) and shell (store) share it. */
+/** The default slide stage: 16:9 at 1280×720, deliberately NOT a config viewport - no
+*  migration for existing projects, no deck device in sweeps. Dependency-neutral so
+*  server (shot) and shell (store, play) share it. */
 const SLIDE_INTRINSIC = {
 	width: 1280,
 	height: 720
 };
-/** The one DEFAULT sizing rule for slide frames, shared by canvas and shot:
-*  `slide: true` sets the intrinsic 1280×720 stage, over any authored viewport.
-*  Board nodes stay resizable (the Slide root scales into whatever box it is
-*  given); this governs defaults, shots, and stage coordinates. */
-function slideSize(frame) {
-	return frame.slide ? SLIDE_INTRINSIC : null;
+/** The one sizing rule for slide frames, shared by canvas, shot and slides mode: a
+*  `slide: true` frame's stage is its declared viewport when the project defines one
+*  (a 16:10 deck authored at `laptop` stays 1280×800), else the 1280×720 default. A
+*  slide is an ordinary frame at that size - slides mode scales the whole stage to the
+*  screen, so the frame never has to. */
+function slideSize(frame, viewports = {}) {
+	if (!frame.slide) return null;
+	const vp = frame.viewport ? viewports[frame.viewport] : void 0;
+	return vp ? {
+		width: vp.width,
+		height: vp.height
+	} : SLIDE_INTRINSIC;
 }
 //#endregion
 //#region src/cli/name.ts
@@ -72,14 +78,14 @@ const resolve$1 = (dir) => {
 };
 const cli = cac(NAME);
 cli.command("init", "Scaffold design/ in this repo").option("--mode <mode>", "studio | embedded", { default: "studio" }).option("--no-demo", "Skip the demo scene (the demo ships unless this flag is passed)").option("--root <dir>", "Host repo root", { default: "." }).action(async (opts) => {
-	const { init } = await import("./init-BQYCS3EU.mjs");
+	const { init } = await import("./init-DKxuRxBr.mjs");
 	init(resolve$1(opts.root), {
 		mode: opts.mode === "embedded" ? "embedded" : "studio",
 		demo: opts.demo !== false
 	});
 });
 for (const [name, desc] of [["dev", "Start the local canvas (everything on: hot reload, comments, Live Jam)"], ["canvas", "Start the local canvas - same as dev"]]) cli.command(name, desc).option("--root <dir>", "Host repo root", { default: "." }).option("--port <port>", "Port (default 5199)").action(async (opts) => {
-	const { dev } = await import("./dev-D3mP2x27.mjs");
+	const { dev } = await import("./dev-BjdDP69b.mjs");
 	let port;
 	if (opts.port !== void 0) {
 		const n = Number(opts.port);
@@ -89,7 +95,7 @@ for (const [name, desc] of [["dev", "Start the local canvas (everything on: hot
 	await dev(resolve$1(opts.root), port);
 });
 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) => {
-	const { buildSite } = await import("./build-7ed5H2vT.mjs");
+	const { buildSite } = await import("./build-DwpNPl6Z.mjs");
 	try {
 		const boards = opts.boards === void 0 ? void 0 : typeof opts.boards === "string" ? opts.boards : "";
 		await buildSite(resolve$1(opts.root), boards, opts.allBoards === true, opts.embedSeeds === true, opts.textures !== false && !process.env.MARVER_NO_TEXTURES);

package/dist/{dev-D3mP2x27.mjs → dev-BjdDP69b.mjs}

@@ -1,6 +1,6 @@
 import { i as PKG, r as NAME } from "./cli.mjs";
 import { c as loadConfig, u as detectHost } from "./manifest-B01PSyDc.mjs";
-import { n as tailwind3Css, r as tailwind4Plugin, t as marverPlugin } from "./plugin-DI-7NAnx.mjs";
+import { n as tailwind3Css, r as tailwind4Plugin, t as marverPlugin } from "./plugin-y4Ch7o_A.mjs";
 import { readFileSync, readdirSync, realpathSync, statSync } from "node:fs";
 import { basename, dirname, isAbsolute, join, relative, resolve } from "node:path";
 import { fileURLToPath } from "node:url";
@@ -452,12 +452,12 @@ async function dev(root, portFlag) {
 	console.log(`\n  ${NAME} · ${projectName} → http://localhost:${port}/\n`);
 	setTimeout(async () => {
 		try {
-			await (await import("./shot-DMDvDbeP.mjs")).sweepGhosts((m) => console.log(`  ${m}`));
+			await (await import("./shot-iw3SEcpn.mjs")).sweepGhosts((m) => console.log(`  ${m}`));
 		} catch {}
 	}, 0);
 	try {
 		const { staleManagedInstructions } = await import("./managed-HwHVNI3h.mjs");
-		const { installedVersion } = await import("./plugin-DI-7NAnx.mjs").then((n) => n.i);
+		const { installedVersion } = await import("./plugin-y4Ch7o_A.mjs").then((n) => n.i);
 		const stale = staleManagedInstructions(root);
 		if (stale.length) {
 			const shown = stale.slice(0, 4).join(", ") + (stale.length > 4 ? `, +${stale.length - 4} more` : "");

package/dist/{init-BQYCS3EU.mjs → init-DKxuRxBr.mjs}

@@ -153,11 +153,11 @@ function init(root, opts) {
 		}
 	}
 	write("slides.md", [
-		"# This project's slide layouts and house rules",
+		"# This project's deck look and house habits",
 		"",
-		"The agent reads BOTH the shipped doctrine (instructions/slides.md) and this",
-		"file - and this file WINS where they disagree. Add your own layouts, house",
-		"rules, and banned moves here; it is yours and marver never touches it.",
+		"The agent reads BOTH the shipped guide (instructions/slides.md) and this",
+		"file - and this file WINS where they disagree. Add your own deck look,",
+		"compositions and habits here; it is yours and marver never touches it.",
 		"",
 		"To grow it from examples: drop decks (PPTX, PDF, screenshots) into",
 		"design/slides-inspiration/ and ask the agent to \"study my inspiration\" -",
@@ -166,44 +166,45 @@ function init(root, opts) {
 		"## The deck look",
 		"",
 		"How a deck wears this brand. The agent drafts it from DESIGN.md and",
-		"theme.css on the first deck (a reviewed edit, building on provisionally",
-		"with the theme's tokens); anything it cannot settle stays `TBD` for you.",
-		"Each line shows the shape with an example - replace the example, keep the",
-		"shape.",
+		"theme.css on the first deck (a reviewed edit); anything it cannot settle",
+		"stays `TBD` for you. Each line shows the shape with an example - replace",
+		"the example, keep the shape.",
 		"",
-		"- **Tokens** (`--marver-slide-*` in theme.css, read by the Slide root):",
-		"  ground / ink / muted, each with a `-dark` twin; accent, one value for",
-		"  both themes. e.g. ground = the page background, ink = the heading",
-		"  colour, accent = the primary button.",
-		"- **Type** (`--marver-slide-font`): one family, the theme's; the type",
-		"  roles carry their weights. e.g. Inter.",
-		"- **The mark**: which asset, where, how big. e.g. wordmark SVG, bottom-left",
-		"  of the cover and the closing only, 120px wide - never on content slides.",
-		"- **Colour meaning** (charts, cards, badges): hue = category, fixed across",
-		"  the deck. e.g. accent = us, slate = competitors, muted = the baseline;",
-		"  green / amber / red reserved for status.",
-		"- **Backgrounds allowed**: e.g. the flat ground; a theme gradient on covers",
-		"  and sections only; no photos behind text without a scrim.",
-		"- **Imagery**: e.g. product screenshots on a device-less frame, real people,",
-		"  no stock; illustrations in the product's line style only. Evidentiary",
-		"  images (a report fragment, a log line, a reasoning trace, a real",
-		"  screen) are evidence objects, not decoration - hero material when the",
-		"  message warrants it.",
-		"- **Tempo** (`--marver-slide-tempo`): e.g. 350ms - one value, every deck.",
+		"- **Stage**: e.g. 1280×720 (the default); or `viewport: 'laptop'` on every",
+		"  slide for a 16:10 deck.",
+		"- **The master**: what every content slide wears. e.g. the mark top left,",
+		"  \"Prepared for <client> · Confidential · <month year>\" top right in the",
+		"  muted colour; the cover and the closing step outside it.",
+		"- **Tones**: whole-slide colour sets. e.g. paper (#F1F0EA on #151616) for",
+		"  working slides, ink for statements and turns, the brand blue once, for",
+		"  the proof.",
+		"- **Type**: family, weights, tracking, the few sizes. e.g. the brand sans at",
+		"  400 for headlines and text, tight tracking on headlines; a display, a",
+		"  heading, a body and a small label size - hierarchy by size and colour.",
+		"- **The mark**: which asset, where, how big. e.g. the lockup in the master,",
+		"  paired with the client's mark on the cover.",
+		"- **Imagery**: e.g. the client's own photography, full- or half-bleed under",
+		"  a uniform scrim; product screenshots on a device-less frame; no stock.",
+		"- **Drawings**: e.g. native SVG line drawings on a shared dotted grid, ink",
+		"  with one accent per slide, light and dark versions.",
+		"- **Colour meaning**: e.g. accent = the point of the slide; dark red = the",
+		"  problem loop; green = the outcome; never decoration.",
+		"- **Motion** (`--marver-slide-tempo` in theme.css): e.g. 350ms morphs;",
+		"  drawings trace in when a slide arrives; nothing loops.",
 		"- **Numbers**: e.g. $ and k / M (lowercase k), fiscal years as FY26,",
 		"  negatives in brackets, one decimal on percentages.",
 		"- **Voice**: three words the deck sounds like, and the words it never",
 		"  uses. e.g. direct, warm, specific; never \"leverage\", \"seamless\", \"journey\".",
 		"- **Terminology**: user-facing word → never-shown internal word.",
 		"  e.g. \"Comments\" → \"Enrichment\".",
-		"- **End card**: yes / no. e.g. yes - the mark on the ground, no text; the",
-		"  ask lives on the slide before it.",
+		"- **End card**: e.g. a full-bleed photograph, the mark and a contact; the",
+		"  ask lives on the slide before.",
 		"",
-		"## Layouts",
+		"## Compositions",
 		"",
-		"(none yet - the shipped recipe list and atlas apply)",
+		"(none yet - the shipped idea bank in instructions/reference/deck-layouts.md applies)",
 		"",
-		"## House rules",
+		"## House habits",
 		"",
 		"(none yet)",
 		""

package/dist/{plugin-DI-7NAnx.mjs → plugin-y4Ch7o_A.mjs}

@@ -422,7 +422,7 @@ function apiMiddleware(root, opts = {}) {
 				};
 				const asPng = url.searchParams.get("format") === "png";
 				const origin = opts.origin?.() ?? `http://${req.headers.host ?? "localhost"}`;
-				const { shootFrame } = await import("./shot-DMDvDbeP.mjs");
+				const { shootFrame } = await import("./shot-iw3SEcpn.mjs");
 				const r = await shootFrame({
 					root,
 					viewports: opts.viewports ?? {},
@@ -472,7 +472,7 @@ function apiMiddleware(root, opts = {}) {
 				if (typeof theme !== "string" || !/^[a-z0-9-]+$/i.test(theme)) return json(res, 400, { error: "invalid theme" });
 				const scale = body.scale === void 0 ? void 0 : body.scale;
 				if (scale !== void 0 && !(Number.isInteger(scale) && scale >= 1 && scale <= 4)) return json(res, 400, { error: "invalid scale" });
-				const { resolveFrames, shootBatch } = await import("./shot-DMDvDbeP.mjs");
+				const { resolveFrames, shootBatch } = await import("./shot-iw3SEcpn.mjs");
 				const sel = resolveFrames(root, body);
 				if (!sel.ok) return json(res, sel.status, { error: sel.error });
 				const origin = opts.origin?.() ?? `http://${req.headers.host ?? "localhost"}`;
@@ -500,7 +500,7 @@ function apiMiddleware(root, opts = {}) {
 					return json(res, 400, { error: "malformed JSON" });
 				}
 				if (!body || typeof body !== "object" || !Array.isArray(body.asks) || !body.asks.length || body.asks.length > 200) return json(res, 400, { error: "asks must list 1-200 frames" });
-				const { bakeBatch, ASK_MAX } = await import("./bake-kaf5kGZ7.mjs");
+				const { bakeBatch, ASK_MAX } = await import("./bake-tAb0D6Rc.mjs");
 				let manifest = {};
 				try {
 					manifest = JSON.parse(readFileSync(join(root, "design", "manifest.json"), "utf8"));
@@ -544,8 +544,8 @@ function apiMiddleware(root, opts = {}) {
 			if (path === "poster" && req.method === "GET") {
 				if (!ownerGated(req)) return json(res, 403, { error: "forbidden" });
 				const src = url.searchParams.get("src") ?? "";
-				const { ensurePoster, isLocalClip } = await import("./poster-DNh6N27C.mjs");
-				const { isLocalAssetRef } = await import("./build-7ed5H2vT.mjs");
+				const { ensurePoster, isLocalClip } = await import("./poster-FCv_nXyP.mjs");
+				const { isLocalAssetRef } = await import("./build-DwpNPl6Z.mjs");
 				if (!isLocalAssetRef(src) || !isLocalClip(src)) return json(res, 400, { error: "src must be a clip under design/assets/" });
 				const r = await ensurePoster(join(root, "design", "assets"), src);
 				if (!r.ok) return json(res, r.error.includes("does not exist") ? 404 : 503, { error: r.error });
@@ -1027,7 +1027,7 @@ function marverPlugin(ctx) {
 			};
 			const prune = () => setTimeout(async () => {
 				try {
-					(await import("./bake-kaf5kGZ7.mjs")).pruneBakes(root, bakeGen);
+					(await import("./bake-tAb0D6Rc.mjs")).pruneBakes(root, bakeGen);
 				} catch {}
 			}, 500);
 			prune();
@@ -1166,7 +1166,7 @@ function marverPlugin(ctx) {
 								});
 								return;
 							}
-							const { shootFrame, shootBatch, resolveFrames } = await import("./shot-DMDvDbeP.mjs");
+							const { shootFrame, shootBatch, resolveFrames } = await import("./shot-iw3SEcpn.mjs");
 							if (ways[0] === "frame") {
 								if (typeof spec.frame !== "string") {
 									write({

package/dist/{poster-DNh6N27C.mjs → poster-FCv_nXyP.mjs}

@@ -1,4 +1,4 @@
-import { capture, t as findChrome } from "./shot-DMDvDbeP.mjs";
+import { capture, t as findChrome } from "./shot-iw3SEcpn.mjs";
 import { constants, copyFileSync, existsSync, mkdtempSync, realpathSync, rmSync, writeFileSync } from "node:fs";
 import { basename, dirname, join, sep } from "node:path";
 import { pathToFileURL } from "node:url";

package/dist/{publish-bakes-Dp-ZFk3d.mjs → publish-bakes-XH6Bac58.mjs}

@@ -1,5 +1,6 @@
-import { planShot, t as findChrome } from "./shot-DMDvDbeP.mjs";
-import { ASK_MAX, bakeBatch } from "./bake-kaf5kGZ7.mjs";
+import { o as slideSize } from "./cli.mjs";
+import { planShot, t as findChrome } from "./shot-iw3SEcpn.mjs";
+import { ASK_MAX, bakeBatch } from "./bake-tAb0D6Rc.mjs";
 import { MIME } from "./serve-z5qtj_wJ.mjs";
 import { copyFileSync, lstatSync, mkdirSync, readFileSync, realpathSync, rmSync, statSync, writeFileSync } from "node:fs";
 import { extname, isAbsolute, join, relative, resolve } from "node:path";
@@ -43,6 +44,11 @@ function publishedAsks(boards, themes, frames, viewports, allScenes = false) {
 		}
 	};
 	const size = (f, n) => {
+		const sl = slideSize(f, viewports);
+		if (sl) return {
+			w: sl.width,
+			h: sl.height
+		};
 		const nw = n && typeof n.w === "number" && n.w > 0 ? n.w : void 0, nh = n && typeof n.h === "number" && n.h > 0 ? n.h : void 0;
 		const p = planShot(f, viewports, {});
 		if (p.fullHeight && !nh) return null;

package/dist/{shot-DMDvDbeP.mjs → shot-iw3SEcpn.mjs}

@@ -283,16 +283,16 @@ function planShot(frame, viewports, override = {}) {
 	const cw = num(frame.contentWidth);
 	const vpObj = frame.viewport ? viewports[frame.viewport] : void 0;
 	const ow = num(override.w), oh = num(override.h);
-	const sl = slideSize(frame);
+	const fallback = viewports.mobile ?? {
+		width: 390,
+		height: 844
+	};
+	const sl = slideSize(frame, viewports);
 	if (sl) return {
 		width: sl.width,
 		initialHeight: sl.height,
 		fullHeight: false
 	};
-	const fallback = viewports.mobile ?? {
-		width: 390,
-		height: 844
-	};
 	if (cw) {
 		const width = clamp(ow ?? vpObj?.width ?? cw, 320, 1600);
 		return {
@@ -337,8 +337,8 @@ async function shootFrame(opts) {
 	};
 	const plan = planShot(frame, viewports, size);
 	if (frame.kind !== "html") try {
-		const { scanAssetRefs } = await import("./build-7ed5H2vT.mjs");
-		const { ensurePoster } = await import("./poster-DNh6N27C.mjs");
+		const { scanAssetRefs } = await import("./build-DwpNPl6Z.mjs");
+		const { ensurePoster } = await import("./poster-FCv_nXyP.mjs");
 		const refs = scanAssetRefs(readFileSync(join(root, frame.file), "utf8"), frame.file);
 		for (const r of refs) if (r.endsWith(".poster.png")) await ensurePoster(join(root, "design", "assets"), r.slice(0, -11));
 	} catch {}

package/docs/live-jam.md

@@ -105,7 +105,7 @@ obvious one:
   scale}` for humans and shell-ful agents - the same renderer, one line. A batch is ONE
   operation: one headless browser, `MARVER_SHOT_CONCURRENCY` frames at a time inside it
   (default up to 6, sized to the machine), so a scene costs about what a frame does. Default
-  2x; `--scale 4` for a print-quality still (a slide comes back 5120×2880). A frame too tall
+  2x; `--scale 4` for a print-quality still (a 1280×720 slide comes back 5120×2880). A frame too tall
   for the asked scale steps down and says so in `note`; the file name carries the scale
   actually used (`…@4x.png`). A frame that ran out of settle budget still ships, marked
   `unsettled` with a note.