@marver-design/marver 0.17.0 → 0.19.0

package/CHANGELOG.md

@@ -2,6 +2,102 @@
 
 Notable changes to `@marver-design/marver`. Format follows [Keep a Changelog](https://keepachangelog.com); versions follow semver.
 
+## 0.19.0 - 2026-09-08
+
+### Added
+
+- **Sticky notes.** A markdown file beside a frame (`cart.note.md` next to `cart.tsx`, `.jsx` or
+  `.html`) or a scene (`_note.md` in the scene directory) renders as a yellow note left of the
+  frame on the canvas - the scene's on the scene's first frame of the board, above the frame's
+  own. Markdown with the Md block's rules (`goto:` links jump to a frame, images from
+  `design/assets/`, raw HTML inert) and ` ```mermaid ` fences drawn hand-drawn. Comments pin on a
+  note's elements as on a frame's; a folded note parks its pins on its tab. Tidy keeps room for
+  notes. Every viewer folds a note at its corner and hides all with `N`; the choice stays in the
+  browser, never in the board file. Published and shared canvases carry the notes, their images
+  copied like any Md image. An edit to a note file updates the sticky in place; the frame is never
+  reloaded. Every diagram family wears the note's look - flowchart, sequence, state, class, ER,
+  pie, mindmap, timeline, gantt, journey, quadrant, git graph, block: hand-sketched boxes, one
+  yellow palette, handwriting labels (the Diagram block in content frames keeps its own theme).
+
+### Changed
+
+- The manifest carries `note` on frames and scenes; the dev watcher regenerates it when a note
+  file changes.
+- The agent contract (`design/AGENTS.md`, refreshed by `npx marver init`) and
+  `instructions/shape.md` teach sticky notes: what one is, when to write one, what it supports
+  (markdown, tables, `goto:` links, images, hand-drawn mermaid) and how it works.
+- Markdown in content frames: text inside a raw `<script>`/`<style>` block is now escaped like
+  every other text, and the rendered HTML passes a tag and attribute allowlist before insertion.
+  Diagram source is judged after decoding escapes; image shapes and directives are refused.
+
+## 0.18.0 - 2026-09-07
+
+### Changed
+
+- **Hi-fi frames at rest sleep in place.** A frame on the canvas is one live document, awake
+  or asleep - the DOM-snapshot "lean" cover of earlier releases is gone. At rest, its CSS
+  animations pause and every `backdrop-filter` element (the glass that made a 4-frame hi-fi
+  board checkerboard at 20-70 % zoom) wears a static texture of its own filtered backdrop,
+  computed and certified pixel by pixel by the dev server in headless Chrome, under
+  `backdrop-filter: none` and a static `filter` (the containing block stays, the compositor
+  layer goes: a sleeping frame is one layer to raster, not thirty). Interact mode wakes the
+  frame by removing one `<style>`; laser, comment pins and selection work on the sleeping
+  document as it is. Nothing is copied, so nothing can shift at the transition: measured on
+  real frames in a window at 200 % zoom, 29 pixels of 5.2 million differ from the live paint
+  by more than 8 levels, none by more than 32. During a pan or a zoom the presented frames
+  stay whole where the live board leaves the frame body blank. The one residual: at a zoom
+  that puts a glass element on fractional device pixels, Chrome resamples the live effect
+  layer and paints the sleeping element at its true position, so its edge rows can differ by
+  up to 32 levels at the wake.
+  Markdown, image, slide and lo-fi frames have nothing to compile and never ask the server.
+- Theme flips and resizes wake the frame first and sleep it again once it has settled at the
+  new theme or size; an edit (HMR) or a reload does the same under a new source generation, so
+  a texture can never outlive the source it describes.
+
+- **Boards open in seconds, not minutes.** A board of 128 lo-fi frames went from 77-95 s to
+  under 8 s to fully ready, and its first frames show within the first second. Three causes,
+  three fixes: every frame evaluated the WHOLE prebundled icon package its scene imported one
+  icon from (`@phosphor-icons/react`: 3000 icons, 6.5 MB of JavaScript, ~400 ms per frame,
+  the entire boot of a lo-fi frame) - the dev server now unrolls icon barrel imports in design
+  sources to the per-icon modules the installed package's own barrel names (phosphor, lucide),
+  one line for one line;
+  all frames booted at once on one main thread and finished together, so nothing showed until
+  the last was done - frames are now admitted a few at a time, nearest the centre of the view
+  first; and the 10 s ready watchdog fired on every frame of a big board and renavigated it, so
+  every frame loaded twice - it now counts from admission. A frame reports ready when React
+  has committed, not when it was asked to render.
+
+### Added
+
+- **Published canvases rest under the same certified glass.** `marver build` compiles every
+  published node's textures, in every theme, against the site it just built, and ships them with
+  it (`__mv/bakes/`); the static shell reads one index. A shared hi-fi board now pans and zooms
+  like the dev canvas (measured: 36-59 flat blocks per presented frame at worst, from 1139-1417).
+  Needs Chrome on the build machine; without one the build ships without textures and says so.
+  `--no-textures` / `MARVER_NO_TEXTURES=1` skip the compile.
+- **Published glass was flat.** The CSS transform of a build kept only `-webkit-backdrop-filter`
+  on a rule that declared both, and Chromium then computed `backdrop-filter: none`: the sidebar
+  and header of every published hi-fi frame lost their blur. The build now puts the standard
+  declaration back beside the prefixed one.
+- **Chrome in a build container.** A root build on Linux (a Dockerfile, Railway) gets
+  `--no-sandbox` and `--disable-dev-shm-usage` from marver itself; `MARVER_CHROME` still names
+  a browser marver does not find. The publish guides carry a Dockerfile with Chromium.
+- **Published HTML frames never reported ready.** The build shipped the frame bridge without the
+  module it imports, so in a published canvas an HTML frame stayed "still loading" and neither
+  slept nor took laser or comments. Both files ship now.
+- `POST /__mv/api/bakes` (owner-gated) compiles frames in batch; textures are cached on disk
+  under `design/.local/bakes/<generation>/` and served immutable. Identical asks share one
+  compile; a compile the source outran is dropped; two dev servers on one project keep their
+  own generations.
+
+### Caveats
+
+- Only the dev canvas compiles (it needs Chrome): published canvases sleep with the animation
+  pause alone, their glass live as before.
+- Glass inside glass, a glass element with a blend mode, and any frame whose paint at rest is
+  not a function of its URL (random data at boot, a clock) stay live - the compiler refuses
+  what it cannot certify, and `?awake=1` on the canvas URL keeps every frame live for comparison.
+
 ## 0.17.0 - 2026-09-04
 
 ### Added

package/README.md

@@ -8,7 +8,7 @@
 
 Screens, prototypes, specs, and now slide decks - all real code, all on one canvas, all shareable with people who sign in as themselves.
 
-[marver.design](https://marver.design) · [Slides](docs/slides.md) · [Live Jam](docs/live-jam.md) · [Deploying a canvas](docs/publish.md) · [Sharing](docs/sharing.md) · [Changelog](CHANGELOG.md) · [Contributing](CONTRIBUTING.md) · [Issues](https://github.com/TNEP4/marver/issues)
+[marver.design](https://marver.design) · [Slides](docs/slides.md) · [Sticky notes](docs/sticky-notes.md) · [Live Jam](docs/live-jam.md) · [Deploying a canvas](docs/publish.md) · [Sharing](docs/sharing.md) · [Changelog](CHANGELOG.md) · [Contributing](CONTRIBUTING.md) · [Issues](https://github.com/TNEP4/marver/issues)
 
 ## Quickstart
 
@@ -45,6 +45,8 @@ 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`. 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.