@pinepaper.studio/mcp-server 1.6.13 → 1.6.15

package/README.de.md

@@ -5,6 +5,11 @@
 [English](README.md) · [简体中文](README.zh-CN.md) · [日本語](README.ja.md) · [한국어](README.ko.md) · [Español](README.es.md) · [Português (BR)](README.pt-BR.md) · [Français](README.fr.md) · **Deutsch** · [हिन्दी](README.hi.md)
 
 <p align="center">
+  <picture>
+    <source media="(prefers-color-scheme: dark)" srcset="assets/brand/pinepaper-lockup-horizontal-white.svg">
+    <img src="assets/brand/pinepaper-lockup-horizontal.svg" alt="PinePaper" width="360">
+  </picture>
+  <br>
   <img src="assets/hero.svg" alt="PinePaper MCP — animierte Grafiken aus Tool-Aufrufen" width="840">
 </p>
 
@@ -14,7 +19,7 @@
 
 Der PinePaper MCP-Server lässt KI-Assistenten über das Model Context Protocol Grafiken in [PinePaper Studio](https://pinepaper.studio) erstellen und animieren. Funktioniert mit jeder KI, die MCP-Tool-Aufrufe unterstützt (Claude, GPT, Gemini, lokale Modelle usw.).
 
-Der Server bietet **152 Tools**: Zeichnen, Animation, Diagramme, Karten, Typografie, Physik, Bildbearbeitung, Datenvisualisierung und Export:
+Der Server bietet **154 Tools**: Zeichnen, Animation, Diagramme, Karten, Typografie, Physik, Bildbearbeitung, Datenvisualisierung und Export:
 
 - Text, Formen, Geometrie und komplexe Grafiken erstellen
 - Mit deklarativen **Relationen** animieren statt mit Keyframes

package/README.es.md

@@ -5,6 +5,11 @@
 [English](README.md) · [简体中文](README.zh-CN.md) · [日本語](README.ja.md) · [한국어](README.ko.md) · **Español** · [Português (BR)](README.pt-BR.md) · [Français](README.fr.md) · [Deutsch](README.de.md) · [हिन्दी](README.hi.md)
 
 <p align="center">
+  <picture>
+    <source media="(prefers-color-scheme: dark)" srcset="assets/brand/pinepaper-lockup-horizontal-white.svg">
+    <img src="assets/brand/pinepaper-lockup-horizontal.svg" alt="PinePaper" width="360">
+  </picture>
+  <br>
   <img src="assets/hero.svg" alt="PinePaper MCP — gráficos animados hechos con llamadas a herramientas" width="840">
 </p>
 
@@ -14,7 +19,7 @@
 
 El servidor MCP de PinePaper permite a los asistentes de IA crear y animar gráficos en [PinePaper Studio](https://pinepaper.studio) a través del Model Context Protocol. Funciona con cualquier IA que soporte llamadas a herramientas MCP (Claude, GPT, Gemini, modelos locales, etc.).
 
-Expone **152 herramientas**: dibujo, animación, diagramas, mapas, tipografía, física, edición de imágenes, visualización de datos y exportación:
+Expone **154 herramientas**: dibujo, animación, diagramas, mapas, tipografía, física, edición de imágenes, visualización de datos y exportación:
 
 - Crear texto, formas, geometría y gráficos complejos
 - Animar con **relaciones** declarativas en lugar de fotogramas clave

package/README.fr.md

@@ -5,6 +5,11 @@
 [English](README.md) · [简体中文](README.zh-CN.md) · [日本語](README.ja.md) · [한국어](README.ko.md) · [Español](README.es.md) · [Português (BR)](README.pt-BR.md) · **Français** · [Deutsch](README.de.md) · [हिन्दी](README.hi.md)
 
 <p align="center">
+  <picture>
+    <source media="(prefers-color-scheme: dark)" srcset="assets/brand/pinepaper-lockup-horizontal-white.svg">
+    <img src="assets/brand/pinepaper-lockup-horizontal.svg" alt="PinePaper" width="360">
+  </picture>
+  <br>
   <img src="assets/hero.svg" alt="PinePaper MCP — graphiques animés créés par appels d'outils" width="840">
 </p>
 
@@ -14,7 +19,7 @@
 
 Le serveur MCP PinePaper permet aux assistants IA de créer et d'animer des graphiques dans [PinePaper Studio](https://pinepaper.studio) via le Model Context Protocol. Compatible avec toute IA gérant les appels d'outils MCP (Claude, GPT, Gemini, modèles locaux, etc.).
 
-Il expose **152 outils** : dessin, animation, diagrammes, cartes, typographie, physique, retouche d'image, visualisation de données et export :
+Il expose **154 outils** : dessin, animation, diagrammes, cartes, typographie, physique, retouche d'image, visualisation de données et export :
 
 - Créer du texte, des formes, de la géométrie et des graphiques complexes
 - Animer avec des **relations** déclaratives plutôt que des images clés

package/README.hi.md

@@ -5,6 +5,11 @@
 [English](README.md) · [简体中文](README.zh-CN.md) · [日本語](README.ja.md) · [한국어](README.ko.md) · [Español](README.es.md) · [Português (BR)](README.pt-BR.md) · [Français](README.fr.md) · [Deutsch](README.de.md) · **हिन्दी**
 
 <p align="center">
+  <picture>
+    <source media="(prefers-color-scheme: dark)" srcset="assets/brand/pinepaper-lockup-horizontal-white.svg">
+    <img src="assets/brand/pinepaper-lockup-horizontal.svg" alt="PinePaper" width="360">
+  </picture>
+  <br>
   <img src="assets/hero.svg" alt="PinePaper MCP — टूल कॉल से बने एनिमेटेड ग्राफ़िक्स" width="840">
 </p>
 
@@ -14,7 +19,7 @@
 
 PinePaper MCP सर्वर AI असिस्टेंट्स को Model Context Protocol के ज़रिए [PinePaper Studio](https://pinepaper.studio) में ग्राफ़िक्स बनाने और एनिमेट करने देता है। MCP टूल कॉलिंग वाले किसी भी AI (Claude, GPT, Gemini, लोकल मॉडल आदि) के साथ काम करता है।
 
-सर्वर **152 टूल** देता है — ड्रॉइंग, एनिमेशन, डायग्राम, नक्शे, टाइपोग्राफ़ी, फिज़िक्स, इमेज एडिटिंग, डेटा विज़ुअलाइज़ेशन और एक्सपोर्ट:
+सर्वर **154 टूल** देता है — ड्रॉइंग, एनिमेशन, डायग्राम, नक्शे, टाइपोग्राफ़ी, फिज़िक्स, इमेज एडिटिंग, डेटा विज़ुअलाइज़ेशन और एक्सपोर्ट:
 
 - टेक्स्ट, आकृतियाँ, ज्यामिति और जटिल ग्राफ़िक्स बनाना
 - कीफ़्रेम की जगह व्यवहार बताने वाले **रिलेशन** से एनिमेशन

package/README.ja.md

@@ -5,6 +5,11 @@
 [English](README.md) · [简体中文](README.zh-CN.md) · **日本語** · [한국어](README.ko.md) · [Español](README.es.md) · [Português (BR)](README.pt-BR.md) · [Français](README.fr.md) · [Deutsch](README.de.md) · [हिन्दी](README.hi.md)
 
 <p align="center">
+  <picture>
+    <source media="(prefers-color-scheme: dark)" srcset="assets/brand/pinepaper-lockup-horizontal-white.svg">
+    <img src="assets/brand/pinepaper-lockup-horizontal.svg" alt="PinePaper" width="360">
+  </picture>
+  <br>
   <img src="assets/hero.svg" alt="PinePaper MCP — ツールコールから生まれるアニメーション" width="840">
 </p>
 
@@ -14,7 +19,7 @@
 
 PinePaper MCP サーバーは、MCP 経由で AI アシスタントが [PinePaper Studio](https://pinepaper.studio) 上にグラフィックを作成・アニメーションさせるためのサーバーです。MCP ツールコールに対応した AI（Claude、GPT、Gemini、ローカルモデルなど）で動作します。
 
-**152 個のツール**を提供 — 描画・アニメーション・図・地図・タイポグラフィ・物理・画像編集・データ可視化・エクスポート：
+**154 個のツール**を提供 — 描画・アニメーション・図・地図・タイポグラフィ・物理・画像編集・データ可視化・エクスポート：
 
 - テキスト、図形、ジオメトリ、複雑なグラフィックの作成
 - キーフレームではなく、ふるまいを宣言する**リレーション**でアニメーション

package/README.ko.md

@@ -5,6 +5,11 @@
 [English](README.md) · [简体中文](README.zh-CN.md) · [日本語](README.ja.md) · **한국어** · [Español](README.es.md) · [Português (BR)](README.pt-BR.md) · [Français](README.fr.md) · [Deutsch](README.de.md) · [हिन्दी](README.hi.md)
 
 <p align="center">
+  <picture>
+    <source media="(prefers-color-scheme: dark)" srcset="assets/brand/pinepaper-lockup-horizontal-white.svg">
+    <img src="assets/brand/pinepaper-lockup-horizontal.svg" alt="PinePaper" width="360">
+  </picture>
+  <br>
   <img src="assets/hero.svg" alt="PinePaper MCP — 툴 콜로 만든 애니메이션" width="840">
 </p>
 
@@ -14,7 +19,7 @@
 
 PinePaper MCP 서버는 AI 어시스턴트가 MCP를 통해 [PinePaper Studio](https://pinepaper.studio)에서 그래픽을 만들고 애니메이션하게 해줍니다. MCP 툴 콜을 지원하는 모든 AI(Claude, GPT, Gemini, 로컬 모델 등)와 호환됩니다.
 
-**152개의 툴** 제공 — 드로잉, 애니메이션, 다이어그램, 지도, 타이포그래피, 물리, 이미지 편집, 데이터 시각화, 내보내기:
+**154개의 툴** 제공 — 드로잉, 애니메이션, 다이어그램, 지도, 타이포그래피, 물리, 이미지 편집, 데이터 시각화, 내보내기:
 
 - 텍스트·도형·기하·복잡한 그래픽 생성
 - 키프레임 대신 행동을 선언하는 **릴레이션**으로 애니메이션

package/README.md

@@ -8,6 +8,11 @@
 **English** · [简体中文](README.zh-CN.md) · [日本語](README.ja.md) · [한국어](README.ko.md) · [Español](README.es.md) · [Português (BR)](README.pt-BR.md) · [Français](README.fr.md) · [Deutsch](README.de.md) · [हिन्दी](README.hi.md)
 
 <p align="center">
+  <picture>
+    <source media="(prefers-color-scheme: dark)" srcset="assets/brand/pinepaper-lockup-horizontal-white.svg">
+    <img src="assets/brand/pinepaper-lockup-horizontal.svg" alt="PinePaper" width="360">
+  </picture>
+  <br>
   <img src="assets/edit-whenever.svg" alt="Generate once. Edit whenever. — animated PinePaper poster: the headline assembles from scatter, a color wave runs through every letter, and 'generate twice / thrice' get struck out before 'once' is highlighted" width="720">
 </p>
 
@@ -25,7 +30,7 @@
 
 PinePaper MCP Server enables AI assistants to create and animate graphics in [PinePaper Studio](https://pinepaper.studio) via the Model Context Protocol (MCP). Works with any AI that supports MCP tool calling (Claude, GPT, Gemini, local models, etc.).
 
-The server exposes **152 tools** across drawing, animation, diagrams, maps, typography, physics, image editing, data visualization, and export. Using natural language, you can:
+The server exposes **154 tools** across drawing, animation, diagrams, maps, typography, physics, image editing, data visualization, and export. Using natural language, you can:
 
 - Create geometric shapes, text collages, diagrams, and data charts
 - Apply 37+ character-level text effects and 28+ vertex deformation presets
@@ -36,7 +41,7 @@ The server exposes **152 tools** across drawing, animation, diagrams, maps, typo
 
 ## Running it: local or hosted
 
-**Local is free and complete.** Every one of the 152 tools works when you run
+**Local is free and complete.** Every one of the 154 tools works when you run
 this server yourself. There is no reduced tier and nothing held back.
 
 What it needs:
@@ -44,7 +49,7 @@ What it needs:
 | | |
 |---|---|
 | Node | 18 or newer |
-| Disk | Puppeteer downloads Chrome on install — roughly **320 MB** per version |
+| Disk | With Puppeteer (below), Chrome is downloaded on install — roughly **320 MB** per version |
 | Memory | a Chrome process plus the Studio canvas, so budget ~1 GB while a job runs |
 
 That is fine on a laptop and awkward on a small VPS, a locked-down work machine,
@@ -73,6 +78,30 @@ question you can answer yourself rather than take on trust: a benchmark runs one
 prompt across several models and puts the results side by side, any run
 shareable. It is in invite-only beta.
 
+### Quick start
+
+Puppeteer is an **optional** install, so a plain `npx @pinepaper.studio/mcp-server`
+has no browser: every tool then returns the code it would run instead of running
+it (the result says so). To execute in a real browser, install Puppeteer **in the
+same `npx` call** — a separate `npm i puppeteer` in your project is not visible to
+`npx`'s copy of the server:
+
+```json
+{
+  "mcpServers": {
+    "pinepaper": {
+      "command": "npx",
+      "args": ["-y", "-p", "puppeteer", "-p", "@pinepaper.studio/mcp-server", "pinepaper-mcp"]
+    }
+  }
+}
+```
+
+For code-only use (no Chrome, no 320 MB download), use
+`"args": ["-y", "@pinepaper.studio/mcp-server"]` and set
+`"env": { "PINEPAPER_EXECUTION_MODE": "code" }`. A global install works too:
+`npm i -g @pinepaper.studio/mcp-server puppeteer`, then `"command": "pinepaper-mcp"`.
+
 ## Made with tool calls
 
 <p align="center"><img src="assets/hero.svg" width="720" alt="Animated vector graphics, made by tool calls — a tool call on the left runs and becomes a curve drawing itself on the right, composed with PinePaper Studio"></p>
@@ -153,7 +182,7 @@ The same graph drives visuals, keyboard access, and screen-reader roles (WCAG 2.
 
 The snippets above are MCP tool-call arguments — they execute when an AI agent invokes the tool. Three ways to make that happen:
 
-**1 · Ask your agent (any MCP client).** With this server [configured](#2-configure-your-ai-client), paste a prompt like:
+**1 · Ask your agent (any MCP client).** With this server [configured](#quick-start), paste a prompt like:
 
 > Create a blue circle and make it ride a diamond-shaped path with easeInOut, looping. Add an orange rotating square beside it. Then export the scene as animated SVG.
 
@@ -217,6 +246,214 @@ If you do not want an agent executing anything, `code` mode is a first-class pat
 - Puppeteer mode launches Chrome with `--no-sandbox` and `--disable-setuid-sandbox`. That is routine for headless automation and it does weaken Chrome's own process sandbox. If that matters where you are running it, use `code` mode or put the server in a container.
 - Puppeteer itself is an **optional** peer dependency, kept out of the default tree precisely because a headless browser plus an install script is what scanners flag hardest. Install it only if you want the executing mode.
 
+## What's new in 1.6.15
+
+### New: the PinePaper mark
+
+The "origami pine" is the new PinePaper mark. The package now ships it as its
+icon (`icon.svg`, `icon.png`), and MCP bundle hosts that read `manifest.json`
+show it.
+
+### New: transparent WebM
+
+`pinepaper_agent_export` with `format: "webm"` takes `transparent: true` (and
+`alphaQuantizer`, 0–63) for a video with a real alpha channel, where the studio
+supports it. The result confirms the alpha stream; if none was written, the
+result says so instead of handing back an opaque file.
+
+### New: fonts in multi-page PDFs
+
+A PDF deck (`pdf.pages`) embeds the scene's fonts for its searchable text layer
+and reports them in `result.pdf.fonts`. On studios that support it, each page
+gets its own scene's fonts. Text hidden at the moment of rendering (outside its
+`bornAt` / `ttl` window, or invisible) is named in the result, since it is in
+neither the picture nor the text layer.
+
+### Fixed: `npx` setups could never execute in a browser
+
+Puppeteer is an optional install, and under `npx` a separate `npm i puppeteer`
+is not visible to the server. The README's new **Quick start** gives the `npx`
+configuration that includes it; the error message leads with the same
+advice.
+
+### Fixed: text-only properties on shapes
+
+`fontWeight`, `strokePosition` and other text-only properties passed to a
+non-text item are reported as not applied again.
+
+## What's new in 1.6.14
+
+Many of the features below rely on newer studio capabilities. Where a studio
+lacks one, the result says so — the call never quietly claims what it could
+not do.
+
+### New: ads, variants and broadcast deliverables
+
+- **`html5-ad`** export: a display-network zip (`index.html` with the
+  `ad.size` meta and a `clickTag` click target — the whole ad or a CTA's box)
+  plus a backup PNG beside it. The result checks the zip against a size budget
+  (`ad.maxBytes`, default 150 KB) and lists any external requests.
+- **`playable`** export: a single-file MRAID playable whose CTA
+  (`ad.ctaItemId`) opens the store link through `mraid.open`, leaving the rest
+  of the ad interactive.
+- **`pinepaper_render_batch`**: one creative per row of data — each row's item
+  changes or template params, then an export — with per-row files, warnings and
+  failures.
+- **`scc`** captions: CEA-608 (broadcast) from the same timed text as SRT / VTT,
+  with notes on anything cut, dropped or timed late.
+- **`pinepaper_accessibility_check`**: text contrast (WCAG AA) and flashing
+  (more than three flashes a second) as a quick screen before delivery.
+
+### New: text that fits its box
+
+- **`fit`** on text (`create_item`, `modify_item`, batch):
+  `{maxWidth, maxHeight?, minFontSize?, maxFontSize?, wrap?, hold?}` sizes the
+  text to the box, and later content changes refit it — the variant /
+  translation workflow. It holds the anchored edge (`top-*` holds the top);
+  `fit: null` stops fitting. The result's `textFit` gives the size, line count
+  and whether it fits.
+- **Overflow in every export.** `fidelity` lists `text_overflow` for text past
+  its box or off the frame — the check to run before rendering a batch.
+- **`direction`** (`auto` | `ltr` | `rtl`) for Arabic, Hebrew and other RTL
+  paragraphs; `auto` is reported with the way it resolved.
+- **`tabularFigures`** for counters and prices that should not jitter, and
+  **`strokePosition: 'outside'`** for thick caption outlines that keep the
+  letterform.
+- Weight, italic, line spacing, and fonts from the catalogue or Google Fonts
+  (`pinepaper_font` gained a `load` action) now reach the text, loaded before
+  it is drawn.
+
+### New: export formats and controls
+
+- **`apng`** — animation with full transparency, for overlays and stickers.
+- **`jpg` / `webp`** stills for byte-budgeted ad specs; **`srt` / `vtt`**
+  captions from the scene's timed text; **multi-page PDF**, one page per saved
+  scene, with a searchable text layer and print options (paper
+  size, orientation, bleed, trim marks, dpi).
+- **`region`** exports a part of the canvas — carousel slices, sheets of cards.
+  A cell leaves out a neighbour's overflowing items and names the items that
+  cross its edge.
+- **`time`** renders a still at a chosen moment rather than wherever the
+  playhead is.
+- **GIF** `loop` play count and a `maxBytes` budget (re-encoded smaller, with
+  each attempt reported).
+- **Broadcast MP4** — `broadcast: true` (BT.709, limited range, constant
+  bitrate), `bitrate` / `minBitrate`, and `broadcastHeadroom`. The result
+  reports the achieved bitrate and the measured luma; when the file would fail
+  broadcast QC, `fidelity` says so and gives the command that fixes it.
+- **NTSC rates** (29.97, 59.94, …) with a note when a duration overruns at
+  them, and a warning when H.264 rounds an odd side up by a pixel.
+- New platform presets `print-a4-landscape` and `print-letter-landscape`.
+
+### New: tools and parameters
+
+- **`pinepaper_lasso`** gained `cut`: cut a subject out along a polygon, no custom code.
+- **Generator regions** can be shaped (rounded rect, ellipse, circle, polygon,
+  star, or an existing path) and named with `region.id`; the same generator in
+  several boxes gives several instances.
+- **`modify_item`** takes `skewX` / `skewY` and an affine `matrix` (mockups).
+- **Pixel-art rasters** (`smoothing: 'off'`), a **globe `disable`** action,
+  **keyed audio gain**, and **widget HTML** `lang`, `dir` and `alt`.
+- `bornAt` / `ttl` now work as a visibility window in local renders, so shots
+  hand over cleanly on the boundary.
+- `serverInfo.version` names the exact build (`1.6.14+<sha>`).
+
+### Fixed: properties that were silently ignored
+
+`create_item` and `modify_item` now name any property they could not act on,
+with a suggestion for common misspellings. Beyond that, these used to be
+dropped and now work: no-fill (`null` / `'transparent'` / `'none'`), dashes,
+caps and joins on every shape, `color` on closed paths, a top-level `anchor`,
+path coordinates kept when no position is given, mesh colour on 3D shapes,
+`template_params` naming undeclared params, chart data in the documented
+shape, and gradients that cannot be read (now refused, not drawn as nothing).
+
+### Fixed: tools that reported success for the wrong thing
+
+- Batch create / modify / execute now behave exactly like their single-item
+  tools, with one undo step per batch.
+- `moves_along_path` follows the path you name (or refuses); relations to an
+  id not on the canvas are refused.
+- Uploaded media: the id you are given is the one other tools accept, audio
+  levels reach the mix, `data:` and server-side URLs upload in production,
+  and clearing the canvas removes uploaded media too.
+- A platform preset no longer stretches a canvas of another aspect ratio.
+- `camera_animate` no longer claims pitch / yaw as 3D perspective, and its
+  `duration` is optional.
+- Nine tools' published schemas disagreed with what they accepted; a guard
+  now keeps them in step.
+
+### New: a whole music bed in one call
+
+`pinepaper_sound` gained a `sequence` action taking `[{t, spec|preset, note?,
+duration?}]`. Every cue used to be its own call — a 112-cue bed cost 112 round
+trips — and nothing about the work needed one each. Failures come back by
+index, because a bed where three of a hundred cues didn't sound is neither a
+success nor a failure.
+
+### Fixed: create_scene drew the wrong shape for six of its ten types
+
+It built shapes itself instead of asking the engine — a hand-written branch per
+type covering circle, rectangle, star and text, and **a 30px circle for
+everything else**. So `ellipse`, `triangle`, `polygon`, `path`, `line` and
+`arc` silently came out as a small blue circle, and any property that branch
+didn't name was dropped (which is why an ellipse ignored `width`/`height` while
+the same values worked through `agent_batch_execute`).
+
+It now creates items the same way every other tool does, so all 28 item types
+work, along with every property they accept. Two related corrections: scene
+relations accepted 8 types while the catalogue documented ~90 — following the
+documentation failed validation — and scene animations gained `startTime`, so a
+scene can be staggered instead of everything moving from frame zero.
+
+### Fixed: layered-character import described the wrong manifest
+
+The docs implied a `layers[]` array; the engine reads `info.parts` keyed by tag.
+An array imports nothing. The description also implied `pinepaper_animate`
+could blink — only an `expresses` relation drives blink/smile/talk, and asking
+`animate` for it is a silent no-op.
+
+### Fixed: PDF export failed on every scene
+
+`pinepaper_agent_export` with `format: "pdf"` died with "parameter 1 is not of
+type 'Blob'" — an error naming `FileReader` and nothing about PDFs. The engine
+resolves a record `{blob, width, height, format}` and this passed the whole
+record where a `Blob` was expected. It now accepts either shape, reports the
+page geometry the record carries, and when something really is not a file it
+says so about the PDF rather than about `FileReader`.
+
+### Fixed: the validator's own findings were being swallowed
+
+`pinepaper_validate` answers `{success: true, ok: false, diagnostics: [...]}` —
+the call worked and the *scene* has problems, which is the whole point of the
+tool. An internal guard treated `ok: false` as a tool failure, so the result
+became "the studio reported failure without naming a reason" and the
+diagnostics were discarded. A refusal that carries diagnostics now names them.
+
+### Changed: export fidelity is always reported
+
+It used to appear only when there was something to lose, so that an empty list
+could not be misread as "this format is lossless". That traded one misreading
+for a worse one — you could not tell "checked, nothing lost" from "never
+checked". All three states are explicit now, and the caveat lives in a note
+rather than in the absence.
+
+`pinepaper_agent_export` also points at `pinepaper_capture_frames` as the cheap
+way to confirm a scene is actually moving **before** committing to a render.
+
+### Fixed: documentation that described the wrong contract
+
+- **`solveOde` state variables are positional** — `t`, `y0`, `y1`, `y2` …
+  matching `initialState`. There is no `x` or `y`, so the natural way to write
+  a Lorenz system failed with "Undefined symbol y". The working form is now in
+  the description.
+- **`moves_along_path` with `params.equation`** only works on the relation's
+  signal path. Easing `bounce` is piecewise and leaves that path, which
+  silently discards the equation and leaves the item where it started.
+- **`grid.blocked` in `pathfind`** is a **mask**, one entry per cell, not a
+  list of blocked indices. Both are arrays of numbers, so the wrong one used to
+  produce a plausible "no path" instead of an error; the length is now checked.
+
 ## What's new in 1.6.13
 
 ### Fixed: WebGL was switched off, so every shader feature silently did nothing
@@ -934,7 +1171,7 @@ Fourteen new tools (121 → 135) and new actions across the surface — the rele
 
 ## Toolkits & Token Budget
 
-152 tools is a lot of context. The server ships a **toolkit** system that serves only the tools a given client needs, plus a **verbosity** system that controls how long each tool description is.
+154 tools is a lot of context. The server ships a **toolkit** system that serves only the tools a given client needs, plus a **verbosity** system that controls how long each tool description is.
 
 **Toolkit profiles** (`PINEPAPER_TOOLKIT`):
 
@@ -1139,7 +1376,7 @@ Generate instruction/code pairs for LLM fine-tuning:
 
 ## Tools Reference
 
-All 152 tools, grouped by the tag used for toolkit filtering.
+All 154 tools, grouped by the tag used for toolkit filtering.
 
 ### Canvas (`canvas`)
 | Tool | Description |
@@ -1260,6 +1497,7 @@ All 152 tools, grouped by the tag used for toolkit filtering.
 | `pinepaper_scene_diff` | What changed between two scene states |
 | `pinepaper_audio_beats` | Detect beats; bake an item's animation onto them |
 | `pinepaper_template_params` | Templates with typed, coerced inputs |
+| `pinepaper_render_batch` | One creative per data row: apply the row, export it |
 
 ### Image Processing (`image_processing`)
 | Tool | Description |
@@ -1357,6 +1595,7 @@ All 152 tools, grouped by the tag used for toolkit filtering.
 | `pinepaper_analyze_design` | Analyze design quality |
 | `pinepaper_validate_design` | Validate against design rules |
 | `pinepaper_validate` | General validation |
+| `pinepaper_accessibility_check` | Text contrast and flashing (WCAG), as a heuristic screen |
 | `pinepaper_validate_scene` | Validate scene integrity |
 | `pinepaper_instantiate_ontology` | Compile a pp: design graph into a scene |
 | `pinepaper_lint_scene` | Relational-density audit + structural-relation suggestions |

package/README.pt-BR.md

@@ -5,6 +5,11 @@
 [English](README.md) · [简体中文](README.zh-CN.md) · [日本語](README.ja.md) · [한국어](README.ko.md) · [Español](README.es.md) · **Português (BR)** · [Français](README.fr.md) · [Deutsch](README.de.md) · [हिन्दी](README.hi.md)
 
 <p align="center">
+  <picture>
+    <source media="(prefers-color-scheme: dark)" srcset="assets/brand/pinepaper-lockup-horizontal-white.svg">
+    <img src="assets/brand/pinepaper-lockup-horizontal.svg" alt="PinePaper" width="360">
+  </picture>
+  <br>
   <img src="assets/hero.svg" alt="PinePaper MCP — gráficos animados feitos por chamadas de ferramenta" width="840">
 </p>
 
@@ -14,7 +19,7 @@
 
 O servidor MCP do PinePaper permite que assistentes de IA criem e animem gráficos no [PinePaper Studio](https://pinepaper.studio) via Model Context Protocol. Funciona com qualquer IA que suporte chamadas de ferramenta MCP (Claude, GPT, Gemini, modelos locais etc.).
 
-São **152 ferramentas**: desenho, animação, diagramas, mapas, tipografia, física, edição de imagens, visualização de dados e exportação:
+São **154 ferramentas**: desenho, animação, diagramas, mapas, tipografia, física, edição de imagens, visualização de dados e exportação:
 
 - Criar texto, formas, geometria e gráficos complexos
 - Animar com **relações** declarativas em vez de keyframes

package/README.zh-CN.md

@@ -5,6 +5,11 @@
 [English](README.md) · **简体中文** · [日本語](README.ja.md) · [한국어](README.ko.md) · [Español](README.es.md) · [Português (BR)](README.pt-BR.md) · [Français](README.fr.md) · [Deutsch](README.de.md) · [हिन्दी](README.hi.md)
 
 <p align="center">
+  <picture>
+    <source media="(prefers-color-scheme: dark)" srcset="assets/brand/pinepaper-lockup-horizontal-white.svg">
+    <img src="assets/brand/pinepaper-lockup-horizontal.svg" alt="PinePaper" width="360">
+  </picture>
+  <br>
   <img src="assets/hero.svg" alt="PinePaper MCP — 由工具调用生成的矢量动画" width="840">
 </p>
 
@@ -14,7 +19,7 @@
 
 PinePaper MCP 服务器让 AI 助手通过 MCP 协议在 [PinePaper Studio](https://pinepaper.studio) 中创建和驱动图形动画。兼容任何支持 MCP 工具调用的 AI（Claude、GPT、Gemini、本地模型等）。
 
-服务器提供 **152 个工具**，覆盖绘图、动画、图表、地图、排版、物理、图像编辑、数据可视化与导出：
+服务器提供 **154 个工具**，覆盖绘图、动画、图表、地图、排版、物理、图像编辑、数据可视化与导出：
 
 - 创建文本、形状、几何图形与复杂图稿
 - 用行为驱动的**关系（relations）**做动画，而不是逐帧关键帧

package/assets/brand/pinepaper-lockup-horizontal-white.svg

@@ -0,0 +1 @@
+<svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 2156.7 512" width="2156.7" height="512" role="img" aria-label="PinePaper"><title>PinePaper</title><defs><linearGradient id="pplh-bg" x1="0" y1="0" x2="1" y2="1"><stop offset="0" stop-color="#6366f1"/><stop offset="1" stop-color="#8b5cf6"/></linearGradient><linearGradient id="pplh-tr" x1="0" y1="0" x2="1" y2="1"><stop offset="0" stop-color="#f97316"/><stop offset="1" stop-color="#fbbf24"/></linearGradient></defs><rect x="0" y="0" width="512" height="512" rx="112" fill="url(#pplh-bg)"/><rect x="232" y="378" width="48" height="56" rx="6" fill="url(#pplh-tr)"/><path fill="#ffffff" d="M257 78 L172.8 182 L224 182 L147.2 278 L211.2 278 L121.6 390 L257 390 Z"/><path fill="#dfe3ff" d="M256 78 L339.2 182 L288 182 L364.8 278 L300.8 278 L390.4 390 L256 390 Z"/><path fill="#ffffff" d="M709.8 280.75H674.7V361.15H632.7V151.75H709.8Q734.1 151.75 751.2 160.15Q768.3 168.55 776.85 183.25Q785.4 197.95 785.4 216.55Q785.4 233.35 777.45 248.05Q769.5 262.75 752.55 271.75Q735.6 280.75 709.8 280.75ZM742.2 216.55Q742.2 185.95 708 185.95H674.7V246.85H708Q725.4 246.85 733.8 238.9Q742.2 230.95 742.2 216.55ZM810.6 150.55Q810.6 140.05 817.95 133Q825.3 125.95 836.4 125.95Q847.5 125.95 854.85 133Q862.2 140.05 862.2 150.55Q862.2 161.05 854.85 168.1Q847.5 175.15 836.4 175.15Q825.3 175.15 817.95 168.1Q810.6 161.05 810.6 150.55ZM857.1 194.95V361.15H815.1V194.95ZM1056.9 263.65V361.15H1014.9V269.35Q1014.9 249.55 1005 238.9Q995.1 228.25 978 228.25Q960.6 228.25 950.55 238.9Q940.5 249.55 940.5 269.35V361.15H898.5V194.95H940.5V215.65Q948.9 204.85 961.95 198.7Q975 192.55 990.6 192.55Q1020.3 192.55 1038.6 211.3Q1056.9 230.05 1056.9 263.65ZM1250.1 290.65H1128.6Q1130.1 308.65 1141.2 318.85Q1152.3 329.05 1168.5 329.05Q1191.9 329.05 1201.8 308.95H1247.1Q1239.9 332.95 1219.5 348.4Q1199.1 363.85 1169.4 363.85Q1145.4 363.85 1126.35 353.2Q1107.3 342.55 1096.65 323.05Q1086 303.55 1086 278.05Q1086 252.25 1096.5 232.75Q1107 213.25 1125.9 202.75Q1144.8 192.25 1169.4 192.25Q1193.1 192.25 1211.85 202.45Q1230.6 212.65 1240.95 231.4Q1251.3 250.15 1251.3 274.45Q1251.3 283.45 1250.1 290.65ZM1207.8 262.45Q1207.5 246.25 1196.1 236.5Q1184.7 226.75 1168.2 226.75Q1152.6 226.75 1141.95 236.2Q1131.3 245.65 1128.9 262.45ZM1359 280.75H1323.9V361.15H1281.9V151.75H1359Q1383.3 151.75 1400.4 160.15Q1417.5 168.55 1426.05 183.25Q1434.6 197.95 1434.6 216.55Q1434.6 233.35 1426.65 248.05Q1418.7 262.75 1401.75 271.75Q1384.8 280.75 1359 280.75ZM1391.4 216.55Q1391.4 185.95 1357.2 185.95H1323.9V246.85H1357.2Q1374.6 246.85 1383 238.9Q1391.4 230.95 1391.4 216.55ZM1529.4 192.25Q1548 192.25 1561.95 199.75Q1575.9 207.25 1584.3 218.65V194.95H1626.6V361.15H1584.3V336.85Q1576.2 348.55 1561.95 356.2Q1547.7 363.85 1529.1 363.85Q1508.1 363.85 1490.85 353.05Q1473.6 342.25 1463.55 322.6Q1453.5 302.95 1453.5 277.45Q1453.5 252.25 1463.55 232.75Q1473.6 213.25 1490.85 202.75Q1508.1 192.25 1529.4 192.25ZM1540.2 229.15Q1528.5 229.15 1518.6 234.85Q1508.7 240.55 1502.55 251.5Q1496.4 262.45 1496.4 277.45Q1496.4 292.45 1502.55 303.7Q1508.7 314.95 1518.75 320.95Q1528.8 326.95 1540.2 326.95Q1551.9 326.95 1562.1 321.1Q1572.3 315.25 1578.3 304.3Q1584.3 293.35 1584.3 278.05Q1584.3 262.75 1578.3 251.8Q1572.3 240.85 1562.1 235Q1551.9 229.15 1540.2 229.15ZM1764.6 192.25Q1785.9 192.25 1803.15 202.75Q1820.4 213.25 1830.45 232.6Q1840.5 251.95 1840.5 277.45Q1840.5 302.95 1830.45 322.6Q1820.4 342.25 1803.15 353.05Q1785.9 363.85 1764.6 363.85Q1746.3 363.85 1732.35 356.35Q1718.4 348.85 1709.7 337.45V440.35H1667.7V194.95H1709.7V218.95Q1717.8 207.55 1732.05 199.9Q1746.3 192.25 1764.6 192.25ZM1753.5 229.15Q1742.1 229.15 1732.05 235Q1722 240.85 1715.85 251.95Q1709.7 263.05 1709.7 278.05Q1709.7 293.05 1715.85 304.15Q1722 315.25 1732.05 321.1Q1742.1 326.95 1753.5 326.95Q1765.2 326.95 1775.25 320.95Q1785.3 314.95 1791.45 303.85Q1797.6 292.75 1797.6 277.45Q1797.6 262.45 1791.45 251.5Q1785.3 240.55 1775.25 234.85Q1765.2 229.15 1753.5 229.15ZM2024.4 290.65H1902.9Q1904.4 308.65 1915.5 318.85Q1926.6 329.05 1942.8 329.05Q1966.2 329.05 1976.1 308.95H2021.4Q2014.2 332.95 1993.8 348.4Q1973.4 363.85 1943.7 363.85Q1919.7 363.85 1900.65 353.2Q1881.6 342.55 1870.95 323.05Q1860.3 303.55 1860.3 278.05Q1860.3 252.25 1870.8 232.75Q1881.3 213.25 1900.2 202.75Q1919.1 192.25 1943.7 192.25Q1967.4 192.25 1986.15 202.45Q2004.9 212.65 2015.25 231.4Q2025.6 250.15 2025.6 274.45Q2025.6 283.45 2024.4 290.65ZM1982.1 262.45Q1981.8 246.25 1970.4 236.5Q1959 226.75 1942.5 226.75Q1926.9 226.75 1916.25 236.2Q1905.6 245.65 1903.2 262.45ZM2149.2 192.55V236.65H2138.1Q2118.3 236.65 2108.25 245.95Q2098.2 255.25 2098.2 278.35V361.15H2056.2V194.95H2098.2V220.75Q2106.3 207.55 2119.35 200.05Q2132.4 192.55 2149.2 192.55Z"/></svg>

package/assets/brand/pinepaper-lockup-horizontal.svg

@@ -0,0 +1 @@
+<svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 2156.7 512" width="2156.7" height="512" role="img" aria-label="PinePaper"><title>PinePaper</title><defs><linearGradient id="pplh-bg" x1="0" y1="0" x2="1" y2="1"><stop offset="0" stop-color="#6366f1"/><stop offset="1" stop-color="#8b5cf6"/></linearGradient><linearGradient id="pplh-tr" x1="0" y1="0" x2="1" y2="1"><stop offset="0" stop-color="#f97316"/><stop offset="1" stop-color="#fbbf24"/></linearGradient></defs><rect x="0" y="0" width="512" height="512" rx="112" fill="url(#pplh-bg)"/><rect x="232" y="378" width="48" height="56" rx="6" fill="url(#pplh-tr)"/><path fill="#ffffff" d="M257 78 L172.8 182 L224 182 L147.2 278 L211.2 278 L121.6 390 L257 390 Z"/><path fill="#dfe3ff" d="M256 78 L339.2 182 L288 182 L364.8 278 L300.8 278 L390.4 390 L256 390 Z"/><path fill="#1f2937" d="M709.8 280.75H674.7V361.15H632.7V151.75H709.8Q734.1 151.75 751.2 160.15Q768.3 168.55 776.85 183.25Q785.4 197.95 785.4 216.55Q785.4 233.35 777.45 248.05Q769.5 262.75 752.55 271.75Q735.6 280.75 709.8 280.75ZM742.2 216.55Q742.2 185.95 708 185.95H674.7V246.85H708Q725.4 246.85 733.8 238.9Q742.2 230.95 742.2 216.55ZM810.6 150.55Q810.6 140.05 817.95 133Q825.3 125.95 836.4 125.95Q847.5 125.95 854.85 133Q862.2 140.05 862.2 150.55Q862.2 161.05 854.85 168.1Q847.5 175.15 836.4 175.15Q825.3 175.15 817.95 168.1Q810.6 161.05 810.6 150.55ZM857.1 194.95V361.15H815.1V194.95ZM1056.9 263.65V361.15H1014.9V269.35Q1014.9 249.55 1005 238.9Q995.1 228.25 978 228.25Q960.6 228.25 950.55 238.9Q940.5 249.55 940.5 269.35V361.15H898.5V194.95H940.5V215.65Q948.9 204.85 961.95 198.7Q975 192.55 990.6 192.55Q1020.3 192.55 1038.6 211.3Q1056.9 230.05 1056.9 263.65ZM1250.1 290.65H1128.6Q1130.1 308.65 1141.2 318.85Q1152.3 329.05 1168.5 329.05Q1191.9 329.05 1201.8 308.95H1247.1Q1239.9 332.95 1219.5 348.4Q1199.1 363.85 1169.4 363.85Q1145.4 363.85 1126.35 353.2Q1107.3 342.55 1096.65 323.05Q1086 303.55 1086 278.05Q1086 252.25 1096.5 232.75Q1107 213.25 1125.9 202.75Q1144.8 192.25 1169.4 192.25Q1193.1 192.25 1211.85 202.45Q1230.6 212.65 1240.95 231.4Q1251.3 250.15 1251.3 274.45Q1251.3 283.45 1250.1 290.65ZM1207.8 262.45Q1207.5 246.25 1196.1 236.5Q1184.7 226.75 1168.2 226.75Q1152.6 226.75 1141.95 236.2Q1131.3 245.65 1128.9 262.45ZM1359 280.75H1323.9V361.15H1281.9V151.75H1359Q1383.3 151.75 1400.4 160.15Q1417.5 168.55 1426.05 183.25Q1434.6 197.95 1434.6 216.55Q1434.6 233.35 1426.65 248.05Q1418.7 262.75 1401.75 271.75Q1384.8 280.75 1359 280.75ZM1391.4 216.55Q1391.4 185.95 1357.2 185.95H1323.9V246.85H1357.2Q1374.6 246.85 1383 238.9Q1391.4 230.95 1391.4 216.55ZM1529.4 192.25Q1548 192.25 1561.95 199.75Q1575.9 207.25 1584.3 218.65V194.95H1626.6V361.15H1584.3V336.85Q1576.2 348.55 1561.95 356.2Q1547.7 363.85 1529.1 363.85Q1508.1 363.85 1490.85 353.05Q1473.6 342.25 1463.55 322.6Q1453.5 302.95 1453.5 277.45Q1453.5 252.25 1463.55 232.75Q1473.6 213.25 1490.85 202.75Q1508.1 192.25 1529.4 192.25ZM1540.2 229.15Q1528.5 229.15 1518.6 234.85Q1508.7 240.55 1502.55 251.5Q1496.4 262.45 1496.4 277.45Q1496.4 292.45 1502.55 303.7Q1508.7 314.95 1518.75 320.95Q1528.8 326.95 1540.2 326.95Q1551.9 326.95 1562.1 321.1Q1572.3 315.25 1578.3 304.3Q1584.3 293.35 1584.3 278.05Q1584.3 262.75 1578.3 251.8Q1572.3 240.85 1562.1 235Q1551.9 229.15 1540.2 229.15ZM1764.6 192.25Q1785.9 192.25 1803.15 202.75Q1820.4 213.25 1830.45 232.6Q1840.5 251.95 1840.5 277.45Q1840.5 302.95 1830.45 322.6Q1820.4 342.25 1803.15 353.05Q1785.9 363.85 1764.6 363.85Q1746.3 363.85 1732.35 356.35Q1718.4 348.85 1709.7 337.45V440.35H1667.7V194.95H1709.7V218.95Q1717.8 207.55 1732.05 199.9Q1746.3 192.25 1764.6 192.25ZM1753.5 229.15Q1742.1 229.15 1732.05 235Q1722 240.85 1715.85 251.95Q1709.7 263.05 1709.7 278.05Q1709.7 293.05 1715.85 304.15Q1722 315.25 1732.05 321.1Q1742.1 326.95 1753.5 326.95Q1765.2 326.95 1775.25 320.95Q1785.3 314.95 1791.45 303.85Q1797.6 292.75 1797.6 277.45Q1797.6 262.45 1791.45 251.5Q1785.3 240.55 1775.25 234.85Q1765.2 229.15 1753.5 229.15ZM2024.4 290.65H1902.9Q1904.4 308.65 1915.5 318.85Q1926.6 329.05 1942.8 329.05Q1966.2 329.05 1976.1 308.95H2021.4Q2014.2 332.95 1993.8 348.4Q1973.4 363.85 1943.7 363.85Q1919.7 363.85 1900.65 353.2Q1881.6 342.55 1870.95 323.05Q1860.3 303.55 1860.3 278.05Q1860.3 252.25 1870.8 232.75Q1881.3 213.25 1900.2 202.75Q1919.1 192.25 1943.7 192.25Q1967.4 192.25 1986.15 202.45Q2004.9 212.65 2015.25 231.4Q2025.6 250.15 2025.6 274.45Q2025.6 283.45 2024.4 290.65ZM1982.1 262.45Q1981.8 246.25 1970.4 236.5Q1959 226.75 1942.5 226.75Q1926.9 226.75 1916.25 236.2Q1905.6 245.65 1903.2 262.45ZM2149.2 192.55V236.65H2138.1Q2118.3 236.65 2108.25 245.95Q2098.2 255.25 2098.2 278.35V361.15H2056.2V194.95H2098.2V220.75Q2106.3 207.55 2119.35 200.05Q2132.4 192.55 2149.2 192.55Z"/></svg>

package/assets/edit-whenever.svg

@@ -3,7 +3,7 @@
      Effects showcased: print (kicker), scattered (headline assembly), colorwave (per-letter
      fill), wipe (underline bar), orbit (dot around period), pulse (period), fireworks,
      rings, swarm. Pure SMIL, no scripts. -->
-<rect width="800" height="600" fill="#0d1117"/>
+<rect width="800" height="600" fill="#0f172a"/>
 <!-- rings -->
 <g stroke="#22c55e" fill="none" stroke-width="2">
 <circle cx="132" cy="140" r="4"><animate attributeName="r" values="4;48" dur="3s" begin="0s" repeatCount="indefinite"/><animate attributeName="opacity" values=".7;0" dur="3s" begin="0s" repeatCount="indefinite"/></circle>

package/dist/browser/puppeteer-controller.js

@@ -241,7 +241,7 @@ export class PinePaperBrowserController {
                 puppeteer = await import('puppeteer');
             }
             catch {
-                throw new Error('The browser tools need puppeteer, which is an optional install: run `npm i puppeteer` (or `npm i -g puppeteer` for a global CLI) and retry. It is kept out of the default dependency tree for supply-chain hygiene.');
+                throw new Error('The browser tools need puppeteer, which is an optional install. Under npx, add it to the same call — args ["-y", "-p", "puppeteer", "-p", "@pinepaper.studio/mcp-server", "pinepaper-mcp"] — since a separate `npm i puppeteer` is not visible to npx\'s copy. Installed globally: `npm i -g puppeteer`; in a project: `npm i puppeteer`. Then retry. It is kept out of the default dependency tree for supply-chain hygiene.');
             }
             console.error('[PinePaper] Launching browser...');
             this.browser = await puppeteer.default.launch(this.launchOptions(this.config.headless, this.launchArgs(this.config.viewportWidth, this.config.viewportHeight)));
@@ -722,7 +722,7 @@ export class PinePaperBrowserController {
                 puppeteer = await import('puppeteer');
             }
             catch {
-                throw new Error('The browser tools need puppeteer, which is an optional install: run `npm i puppeteer` (or `npm i -g puppeteer` for a global CLI) and retry. It is kept out of the default dependency tree for supply-chain hygiene.');
+                throw new Error('The browser tools need puppeteer, which is an optional install. Under npx, add it to the same call — args ["-y", "-p", "puppeteer", "-p", "@pinepaper.studio/mcp-server", "pinepaper-mcp"] — since a separate `npm i puppeteer` is not visible to npx\'s copy. Installed globally: `npm i -g puppeteer`; in a project: `npm i puppeteer`. Then retry. It is kept out of the default dependency tree for supply-chain hygiene.');
             }
             // Agent mode defaults to visible browser so user can see PinePaper Studio
             const useHeadless = options.headless ?? this.config.headless;