@bestagentkits/render 0.2.0 → 0.3.0

package/CHANGELOG.md

@@ -7,7 +7,106 @@ this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0.htm
 Release mechanics and the compatibility contract live in
 [docs/release-policy.md](./docs/release-policy.md).
 
-## [Unreleased]
+## [0.3.0] - 2026-10-06
+
+The Page Spec stays `version: 1`, and every spec that was valid in 0.2.0 stays
+valid. These changes alter existing behaviour or output on purpose:
+
+- `--theme` (and the `theme` render option) now replaces the spec's
+  `theme.recipes` as well as its tokens. Before, spec recipes applied
+  regardless.
+- Every `gallery` thumbnail opens a full-size lightbox. There is no author
+  flag, so every page with a gallery emits new markup, CSS and runtime.
+- Tabs no longer fire `select` for the initial tab when the page loads, so page
+  state keeps its declared initial values.
+- A remote video `poster` that the network policy blocks is a `validate` error
+  (`POLICY_VIOLATION` at the `poster` path), not a compile failure at `$`.
+- Pages with tabs or a carousel change markup and CSS so every panel and slide
+  reads without scripts and in print.
+- `catalog` text is grouped by category, and `catalog --json` prints one block
+  per line with new `category` and `tags` fields.
+- The Claude Code and Codex plugin manifests link to https://render.agentkit.best, and the Codex plugin shows an icon, a logo and the brand colour in the plugin directory.
+- The benchmarks are measured against AgentKit `9e322f928`. The legacy baseline no longer counts the slide guide for document tasks (AgentKit loads it for `--slides` only), so its per-task mean is ~25.0k tokens, not ~33.7k. `render-benchmark.mjs` measures the `ak-render` skill route per task: the AgentKit shared HTML contract, the skill, `catalog`, and `describe --json` for each block type the task's fixture compiles to. It fails when the AgentKit checkout is missing. Presentation context now drops 64–68% (previously reported as 87–88%). The typical-task estimate is 54% with full contracts and 66% with `describe --compact`, which counts the shared contract too (previously 65% and 75%). `agent-token-cost.mjs --reuse-legacy` reruns that estimate from recorded corpus measurements. The README and landing page use the new figures.
+- The landing page shows what the compiler saves an agent (measured and estimated token figures, kept apart), each component crop beside the fixture YAML that produced it, and a gallery of every demo page. The README gains a token cost section.
+
+### Added
+
+- Rich composition: a tab panel, an accordion section, a carousel slide and a bento tile hold child blocks in `items[i].blocks` (up to 12, or 6 in a bento tile). Any block may nest except `page`, `section` and `hero`, and tabs may nest in tabs. An item's `text`, and a bento tile's `title`, are optional when the item has blocks; an item with neither is an error at its path.
+- Nested slots with `accepts` and `parents` rules. Diagnostics carry the nested JSON path, and nested blocks count toward the block limit.
+- `grid-item` places blocks on a 12-track grid with `span`, `tabletSpan`, `mobileSpan`, `rowSpan`, `start` and `align`. `grid.columns` takes 1–12 or `auto` (with `minItemWidth`), grids take `gap` and `align`, and `stack` takes `align`.
+- Semantic page layouts: `sidebar-layout` (a `sidebar` beside the main `blocks`, on either `side`), `main-aside` (an `aside` that stays in view on wide screens) and `rail-layout` (a compact `rail`, a labelled `<nav>` when it holds only links or toolbars).
+- Datasets: top-level `datasets`, and `dataRef`, inline `data` and a bounded `transform` (filter, groupBy, sort, select, limit) on blocks that take data. Values format through one locale-free formatter (`number`, `integer`, `compact`, `percent`, `currency`, `duration`, `bytes`, `date`); `percent` takes `87` for "87%". See [docs/data-and-state.md](./docs/data-and-state.md).
+- `visibleWhen` shows a block only while a state value matches (`equals`, `notEquals`, `in`, `notIn`, `truthy`, `falsy`). The compiler emits the initial view, so the page reads correctly without scripts and in print.
+- Native input controls `select`, `radio-group`, `checkbox`, `switch`, `text-input`, `number-input` and `date-input`. Each has a visible label, writes one value to `state.<key>` through `bind`, and fires `change` with its value.
+- `filter-bar` filters a `data-table`, `kanban` or `log-viewer` with 1–8 controls, each naming a row `field` and a `match`. It adds an announced result count and a Reset button; `select` and `radio-group` can list the target's values with `optionsFrom`. A `data-table` that a filter-bar targets renders no search box, row count or "no match" note of its own, so two filters never fight over the same rows; put free-text search in the bar as a `search` child.
+- `data-table`: a typed, sortable table bound to a dataset. Column types `text`, `number`, `percent` (alias `percentage`), `currency`, `date`, `badge`, `link`, `progress` and `sparkline`; search past 10 rows (unless a filter-bar targets the table), a sticky header past 12, labelled cards on phones, and the full table in authored order without scripts or in print.
+- Chart kinds `scatter`, `histogram`, `stacked-bar`, `stacked-bar-100`, `heatmap`, `waterfall`, `funnel`, `gauge` and `treemap`. A chart can bind rows and read them through the `x`, `y`, `series: { field }` and `value` encodings, and takes `markers`, `annotations`, `sort` and a gauge `target`. A bound chart's fallback table comes from the bound rows. Charts that use `labels` and `series` render the same markup as before.
+- Engineering widgets: `kanban`, `roadmap`, `test-results`, `log-viewer`, `api-endpoint` and `schema-viewer`.
+- Evidence widgets: `benchmark-comparison` (computed delta, change and verdict; `currency` is set once for the whole block, not per metric), `metric-breakdown`, `annotated-image` and `references` (stable `#ref-<id>` anchors).
+- Product widgets: `pricing`, `feature-matrix`, `testimonial` (two or more quotes form a grid), `logo-cloud`, `people` and `calendar` (weeks start on Monday; `weekStart: sunday` changes that).
+- Theme recipes restyle components through closed enums for cards, sections, tables, charts, hero, metrics, media and callouts. A preset, a preset file or the spec's `theme.recipes` selects them. See [docs/themes.md](./docs/themes.md#recipes).
+- Four built-in presets: `data-console`, `executive-report`, `product-studio` and `research-notebook`. They reuse the bundled faces. Every built-in preset is tested for WCAG 2.2 contrast in both schemes.
+- An inline spec theme accepts `theme.dark`, dark-scheme token overrides.
+- Catalog discovery: every block has a category and tags. `ak-render catalog --category <c>` lists one category, `ak-render search-catalog <terms...>` ranks block types by intent words, and `ak-render describe <type...> --compact` returns up to 12 contracts with one line per prop; a shape repeated within a contract reads `like <field>` and a repeated long enum `enum as <field>`. Row-filtering words rank `filter-bar` first. MCP gains `search-catalog`, `catalog{category}` and `describe{types, compact}`, on the stdio and the remote server; the remote `search-catalog` needs no token. The library exports `searchCatalog` and `describeMany`.
+- Page recipes: `ak-render recipes [--json]` lists ten starter specs (`architecture-review`, `benchmark-report`, `case-study`, `dashboard`, `decision-memo`, `implementation-plan`, `incident-report`, `product-showcase`, `release-recap`, `research-report`), and `ak-render recipe <name>` prints one as YAML, or the full record with `--json`. An unknown name exits 1 and lists the allowed names; a missing name exits 2. Each recipe validates with no errors or warnings, compiles deterministically, stays within 3,000 bytes of YAML and loads nothing remote. MCP serves them as `recipes` and `recipe{name}` on the stdio and the remote server, and the library as `recipes()`, `recipe(name)` and the `PageRecipe` and `PageRecipeSummary` types; an unknown name throws `SPEC_VALIDATION_ERROR` at path `name` with `details.allowed`.
+- `pnpm recipes:generate` embeds the recipe YAML in `src/recipes/recipes.generated.ts`, and `pnpm recipes:check`, part of `pnpm verify`, fails when that module is stale.
+- The library exports `BLOCK_CATEGORIES`, `THEME_RECIPE_SPECS`, `VALUE_FORMATS` and the `MaterializedData`, `DataRow` and `DataScalar` types.
+- Remote MCP over Streamable HTTP at `https://render.agentkit.best/mcp`, served by the cloud Worker. It lists the same tools as `ak-render mcp`: `catalog`, `search-catalog`, `describe`, `recipes`, `recipe`, `validate`, `render` and `themes`. A remote `render` takes no `out`: it compiles through the same path as `POST /v1/render` (byte-identical HTML), stores the page and returns the summary plus `artifactUrl` and `expiresAt`, never the HTML. The artifact lives one hour, or becomes an expiring share with `share: true` (needs the share scope). `catalog`, `search-catalog`, `describe`, `recipes`, `recipe` and `themes` answer without a token; `validate` and `render` need an AgentKit bearer and count against the same per-subject rate limits as REST.
+- The MCP server is split into transport-independent modules under `src/mcp/`: protocol vocabulary, one set of tool contracts, JSON-RPC routing, the stdio transport, and a Fetch-API Streamable HTTP transport the Worker imports. `ak-render mcp` answers byte for byte as before.
+- `GET /v1/artifact/:id` serves the short-lived artifact a remote MCP render stored.
+- `scripts/cloud-smoke.mjs` smoke-tests a deployed renderer (MCP and REST, share lifecycle, exports) with `BASE_URL` and an optional `TOKEN`; the manual cloud deploy workflow runs it after deploying.
+- `benchmarks/agent-token-cost.mjs` estimates the tokens of a page task end to end: guidance read, output written and what returns into context, against a corpus of hand-written HTML passed with `--legacy-html`. Results are in `docs/artifacts/agent-token-cost.md`, with the corpus recorded by anonymous label. `--legacy-from <artifact.json>` refreshes the artifact from the recorded legacy rows without the private corpus, and a second typical-task row measures the compact workflow (`describe <types...> --compact`). Block types are read from the compiler IR.
+- `pnpm bench:spec` (`benchmarks/spec-compression.mjs`) records, per composition fixture, the spec bytes, the bytes with every `dataRef` inlined, the HTML bytes, and the catalog and compact-describe bytes an agent reads, in `docs/artifacts/spec-compression.{json,md}`. The output is deterministic.
+- Six composition fixtures: `complex-dashboard`, `benchmark-report`, `research-report`, `product-case-study`, `interactive-data-explorer` and `incident-report`. Each validates with no warnings and compiles to identical bytes three times. `fixtures/rejected/validation/` holds well-formed but wrong specs that must fail validation at a located path, optionally pinned by a first line `# expect: CODE $.path`.
+- `tests/browser/composition-matrix.spec.ts` checks every fixture page for horizontal overflow at 320, 375, 768 and 1440 in light and dark, running animation under reduced motion, script-off readability, print, keyboard focus, network requests and critical axe violations. `@axe-core/playwright` is a new devDependency.
+- `scripts/capture-demo-media.mjs` captures five more page shots and four component crops (KPI, terminal, checklist, file tree), and `--only <names>` recaptures a subset without the walkthrough video.
+- A pair of backticks in prose text renders as inline code, so `` `ak-render catalog` `` in a `text`, a step, a list item, a description or a caption reads as a command. The text is escaped before the span is wrapped, nothing else is parsed as markup, and an unpaired backtick stays literal. Titles, `code` blocks, `terminal` lines and the chart summary are unchanged, and `describe` and the JSON Schema say which props do this.
+
+### Changed
+
+- `catalog` text is grouped by category under `## <category>` headers, one `type — summary` line per block, without the kind column. `catalog --json` and the MCP `catalog` add `category` and `tags` to each entry and print one block and one action per line; the parsed value is otherwise unchanged. A single-type `describe <type>` is byte-identical.
+- The MCP `describe` input no longer requires `type`: pass `type` or `types`, plus optional `compact`. Every local tool description is at most 200 characters.
+- URL props declare the network capability of the asset they load, so the CSP origins and the validation gate come from one schema walk at any depth.
+- When a `oneOf` value fails, diagnostics come from the option the author meant, chosen by JSON shape and then by `type`.
+- A tab's `select` event passes the tab id as its value, so `set-value` without its own `value` stores the selected tab.
+- Chart `labels` is optional in the schema; a chart without bound data still requires it, with the same message and path.
+- The cloud Worker is routed at `render.agentkit.best/mcp` and `render.agentkit.best/v1/*`, beside the site's Custom Domain on the same hostname.
+- The Claude Code and Codex plugin manifests link to https://render.agentkit.best, and the Codex plugin shows an icon, a logo and the brand colour in the plugin directory.
+- The landing page shows what the compiler saves an agent (measured and estimated token figures, kept apart), each component crop beside the fixture YAML that produced it, and a gallery of every demo page. The README gains a token cost section.
+
+### Fixed
+
+- Tab panels and carousel slides are readable without scripts and in print: every panel ships visible with its title until the runtime marks the container ready.
+- Accordion sections print open, nested blocks included.
+- Accordion and carousel styles apply only to their own sections and slides, so a nested block keeps its own look.
+- The runtime escapes embedded state, so a value such as `</script>` cannot close the script element.
+- An event stops at the nearest block, so it no longer reaches an enclosing block's bindings.
+- A `set-value` action without `value` takes the event's value, for example a slider's. With no event value it does nothing; before, it set `undefined`.
+- The cloud Worker validates bearers against the canonical AgentKit endpoint, `GET https://agentkit.best/api/agentkit/entitlements`, instead of an unreachable host, so authenticated render, share and export can succeed. It fails closed on a rejected token (401), an inactive account (403), and an upstream error, redirect, timeout or malformed body (502). An active app or kit entitlement grants the `render` and `share` scopes, which stay separate checks.
+- Screenshot and PDF export call the Browser Run binding's Quick Actions with the compiled HTML inline and caching off, and `wrangler.jsonc` attaches the `BROWSER` binding.
+- Remote MCP bounds its anonymous surface: a JSON-RPC batch carries at most 16 members, never `initialize`, and is refused (400) under protocol revision 2025-06-18 or later, which removed batching. `catalog`, `search-catalog`, `describe`, `recipes`, `recipe` and `themes` stay anonymous but count per client IP (`anon-ip`, 120/min).
+- A remote MCP request that presents a rejected bearer answers HTTP 401 with `WWW-Authenticate: Bearer`, whatever the method, instead of a tool error; REST 401s carry the same challenge. A request without a bearer is still served, and `validate`/`render` still answer a tool error with `UNAUTHENTICATED`.
+- Cloud rate limits use the Workers Rate Limiting binding, one per route class, instead of KV counters that could fail on rapid writes; a limiter fault refuses the call with `RATE_LIMITED`. An MCP `render` with `share: true` counts against `share` only, as `POST /v1/share` does, and a call refused by authorization consumes nothing.
+- The cloud Worker caches entitlements answers in memory under a SHA-256 digest of the bearer (60 s accepted, 10 s rejected), and limits uncached bearer checks per client IP (30/min) before contacting the entitlements endpoint.
+- Remote MCP reports a storage or runtime fault as a generic `INTERNAL_ERROR` tool error, and the REST routes answer such a fault with a generic 500, so no internal message reaches a caller.
+- Hosted shares and artifacts are served with `content-security-policy: sandbox …; frame-ancestors 'none'`: they run in an opaque origin and cannot be framed.
+- The expiry sweep pages through every listed object with the cursor, reads expiry from listing metadata instead of downloading bodies, and deletes in batches; R2 lifecycle rules (`apps/cloud/r2-lifecycle.json`, applied on deploy) delete artifacts after 1 day and shares after the retention period plus a day.
+- A remote video `poster` that the network policy blocks now fails `validate` with a `POLICY_VIOLATION` at the block's `poster` path, naming the reason. Before, validate passed and compile failed at `$` with "emitted a remote resource reference". A poster is gated by the `images` capability, an allowed remote poster's origin joins the CSP, and the renderer drops a blocked poster even for an IR that skipped validation.
+- Diagram adapter `<style>` elements now receive the page style nonce, so styled adapter SVG renders as drawn instead of in default black. The policy stays nonce-only: inline `style` attributes are removed from adapter output with a warning. Adapter CSS is scoped with `@scope` to its own diagram canvas, so it cannot restyle the page, and it cannot load anything: escapes, character references, `url()` other than a fragment reference such as `url(#grad)`, `image-set()`, every at-rule except `@media`, `@keyframes` and `@supports`, and `@keyframes` that redefine the page's own reject the output to the structured fallback. Comments and `!important` are removed. Adapter markup that writes a `nonce` or any `data-ak-*` attribute, or an `href`, `xlink:href`, `src`, `srcset`, `poster`, `action`, `formaction`, `background`, `data`, `codebase` or `ping` that is not a same-document `#fragment`, or SVG animation whose `attributeName` is one of those, is rejected too, and so is markup that is not a self-contained fragment: a stray or missing end tag, a raw-text element such as `plaintext` or `textarea`, an element that merges into the page document such as `body` or `meta`, an HTML element inside SVG, or a comment. Output from the `ak:diagram` compiler passes these checks. Adapter animation stops under reduced motion, `motion-policy: none` and print. `docs/diagram-adapter.md` lists what adapter CSS may use.
+- Checking adapter markup is linear in its size. An unterminated tag repeated to the 256 KB bound took minutes; it now takes milliseconds.
+- A long unbroken token, such as a path or an env var list, no longer widens the page on a phone. Key-value values, list items, text and callouts break the token inside their own line, so the reported key-value page no longer scrolls sideways at 375px.
+- A `diagram-panel` shows adapter SVG at its natural size. A wide diagram scrolls sideways inside its panel, a named region that scrolls from the keyboard, instead of shrinking its labels until they are unreadable. In print it is scaled to the page width.
+- A `diagram-panel` whose adapter rendered no longer shows the structured description beside the drawing. The description stays in the document behind a closed "Text description" disclosure, which opens in print, with or without script.
+- A long `terminal` session no longer leaves its last lines blank in a capture. Lines now stagger 80ms apart instead of 340ms, lines past the twelfth share its delay, and the whole session is drawn about 1.4s after it arrives.
+- A wide `table` or adapter diagram now shows a soft shade on each edge that has more content beyond it, so a frame that scrolls sideways no longer looks clipped. A frame that fits shows none.
+- A `data-table` row that a filter hides stays hidden at phone widths, where rows become cards.
+- Blocks inside or after a `visibleWhen` view keep the normal block gap and the section-break gaps.
+- A thinned category axis always labels the last category, so a series never reads as ending early.
+- Chart ticks finer than 0.01 keep the decimals the step needs instead of all printing the same value, and only floating-point noise is removed before a value is formatted.
+- A histogram over huge, close values (such as 1e16 and 1e16 + 4) keeps finite, increasing bin edges: when clean steps cannot separate the values it draws one bin.
+- The page outline skips a section behind `visibleWhen`, so it never links to a hidden section.
+- Dataset field names `__proto__`, `constructor` and `prototype` are refused at validation, and a `log-viewer` level named like an object property gets the neutral tone.
+- `date-input` accepts ISO dates in the years 0001–0099.
 
 ## [0.2.0] - 2026-10-05
 

package/README.md

@@ -67,19 +67,50 @@ Requires Node.js >= 20.11.
 
 ### Find the blocks you need
 
-There are 54 block types, from primitives (`section`, `grid`, `split`, `text`)
-to semantic blocks that carry the design for you (`hero`, `steps`, `timeline`,
-`comparison`, `kpi`, `chart`, `terminal`, `bento`, `cta`). List them, then read
-the full contract of the ones you use:
+There are 83 block types in eight categories (layout, content, data,
+interaction, media, showcase, engineering, product), from primitives (`section`,
+`grid`, `split`, `text`) to semantic blocks that carry the design for you
+(`hero`, `steps`, `timeline`, `kpi`, `data-table`, `chart`, `kanban`,
+`pricing`, `cta`). Find the ones you need, then read only their contracts:
 
 ```bash
-ak-render catalog                # every block and action, one line each
-ak-render describe timeline      # props, defaults, bounds, slots, a11y notes
-ak-render describe kpi --json    # the same, machine-readable
+ak-render catalog                        # every block by category, and every action
+ak-render catalog --category data        # one category
+ak-render search-catalog sortable table  # rank block types by intent words
+ak-render describe kpi chart --compact   # one line per prop, for several types
+ak-render describe timeline --json       # one full contract: defaults, bounds, a11y notes
 ```
 
-Containers (`section`, `grid`, `split`, `stack`) take their children under
-`blocks:`.
+Containers (`section`, `grid`, `split`, `stack` and the page layouts
+`sidebar-layout`, `main-aside`, `rail-layout`) take their children under
+`blocks:`. Tabs, accordion sections, carousel slides and bento tiles hold
+blocks too, under `items[i].blocks`.
+
+Text is plain text, with one exception: in prose props such as `text`, a step's
+or list item's `text`, a `description` or a `caption`, a pair of backticks
+renders as inline code, so `` `ak-render catalog` `` reads as a command. Nothing
+else is parsed as markup, an unpaired backtick stays literal, and titles, code
+and terminal lines are never changed. `describe` marks each prop that does this.
+
+### Start from a page recipe
+
+A recipe is a complete, valid starter spec for a common page: a dashboard, a
+benchmark report, an architecture review, an incident report, a product
+showcase, a case study, a release recap, an implementation plan, a research
+report or a decision memo. Replace its placeholder text and data, then validate.
+
+```bash
+ak-render recipes                          # names, summaries and the blocks each uses
+ak-render recipe dashboard > page.yaml     # the starter spec as YAML
+```
+
+### Datasets and state
+
+Declare a table once under `datasets` and bind charts, tables and widgets to it
+with `dataRef`, reshaped by a bounded `transform`. Native controls write page
+`state`, `visibleWhen` switches views from it, and `filter-bar` filters a table,
+board or log. All of it is data, and every page still reads completely with
+scripts off. See [docs/data-and-state.md](./docs/data-and-state.md).
 
 ### Validate and fix
 
@@ -103,10 +134,12 @@ ak-render plan.yaml --theme blueprint          # override the spec's theme
 
 ### Themes
 
-Six built-in presets, each with a light and a dark scheme and an embedded
-display face: `blueprint`, `editorial`, `paper-ink`, `swiss-clean`,
-`terminal-mono` and `warm-signal`. Pick one under `theme.preset`, or extend one
-with validated tokens:
+Ten built-in presets, each with a light and a dark scheme and an embedded
+display face: `blueprint`, `data-console`, `editorial`, `executive-report`,
+`paper-ink`, `product-studio`, `research-notebook`, `swiss-clean`,
+`terminal-mono` and `warm-signal`. Presets also choose component recipes, such
+as ledger tables or outlined cards, from closed lists. Pick one under
+`theme.preset`, or extend one with validated tokens:
 
 ```yaml
 theme:
@@ -122,8 +155,9 @@ presets. See [docs/themes.md](./docs/themes.md).
 
 ### Interaction
 
-Tabs, accordions, carousels, sliders, dialogs, filters, copy buttons and the
-theme toggle come from a small trusted runtime. A spec wires them with a closed
+Tabs, accordions, carousels, native form controls, filter bars, sortable
+tables, dialogs, copy buttons and the theme toggle come from a small trusted
+runtime. A spec wires them with a closed
 set of declarative actions (`ak-render catalog` lists them); there is no
 JavaScript field. Every page reads completely with scripts off, with motion
 reduced, in print and in a screenshot.
@@ -131,7 +165,9 @@ reduced, in print and in a screenshot.
 ### Images, video and the network
 
 Local paths (`assets/shot.png`) always work. A remote URL renders as a labelled
-fallback with a link unless the spec opts in:
+fallback with a link unless the spec opts in. A remote video `poster` is the
+exception: it has no fallback, so `validate` rejects it at its own path until
+the page allows remote `images`:
 
 ```yaml
 policy:
@@ -144,7 +180,8 @@ The page's Content Security Policy is derived from that policy. See
 
 ## Use it from an agent
 
-Agents follow one loop: `catalog` once, `describe` the blocks they use,
+Agents follow one loop: find blocks with `catalog` or `search-catalog`, start
+from a `recipe` when one fits, `describe --compact` the blocks they use,
 `validate` and fix diagnostics by JSON path, then compile. The
 [agent guide](./docs/agent-guide.md) has the details and [llms.txt](./llms.txt)
 is the LLM-facing index.
@@ -174,11 +211,26 @@ codex plugin marketplace add bestagentkits/ak-render
 codex plugin add ak-render@ak-render
 ```
 
-### MCP server
+### Three ways to run it
+
+All three serve the same tools with the same contracts, backed by the same
+compiler, so a spec renders to the same bytes whichever an agent picks.
+
+| Mode | Needs | `render` returns | Network |
+| --- | --- | --- | --- |
+| Local CLI | Node 20.11+ | writes `--out`, prints a summary with `--json` | none |
+| Local MCP (stdio) | Node 20.11+ | writes `out`, returns a summary | none |
+| Remote MCP (Streamable HTTP) | an AgentKit token | stores the page, returns a summary and `artifactUrl` | yes |
+
+Local is canonical and needs no account. The remote server exists for agents
+that cannot install Node or need a URL to hand someone.
 
-`ak-render mcp` serves `catalog`, `describe`, `validate`, `render` and `themes`
-as MCP tools over stdio. `render` writes the HTML to disk and returns only a
-summary, so the page never enters the agent's context.
+**Local CLI.** The loop above, with `ak-render` on the path or through `npx`.
+
+**Local MCP over stdio.** `ak-render mcp` serves `catalog`, `search-catalog`,
+`describe`, `recipes`, `recipe`, `validate`, `render` and `themes` as MCP
+tools. `render` writes the HTML to disk
+and returns only a summary, so the page never enters the agent's context.
 
 ```json
 {
@@ -188,6 +240,65 @@ summary, so the page never enters the agent's context.
 }
 ```
 
+**Remote MCP over Streamable HTTP.** `https://render.agentkit.best/mcp` serves
+`catalog`, `search-catalog`, `describe`, `recipes`, `recipe`, `validate`,
+`render` and `themes` with the same contracts. A remote server cannot write into your filesystem, so
+`render` takes no `out`: it stores the page and returns the same summary plus an
+`artifactUrl` that lives for one hour, or a share link that lives for 30 days
+with `share: true`. The HTML still never enters the agent's context.
+`catalog`, `search-catalog`, `describe`, `recipes`, `recipe` and `themes`
+answer without a token; `validate` and `render` need an AgentKit bearer token.
+
+```json
+{
+  "mcpServers": {
+    "ak-render": {
+      "type": "http",
+      "url": "https://render.agentkit.best/mcp",
+      "headers": { "Authorization": "Bearer ${AGENTKIT_TOKEN}" }
+    }
+  }
+}
+```
+
+Details, limits and the REST routes are in
+[apps/cloud/README.md](./apps/cloud/README.md).
+
+## Token cost
+
+The compiled page goes to disk, never through the model. What the agent pays
+is guidance it reads, the spec it writes, and a one-line summary it reads back.
+
+| Part of a page task | Hand-written HTML | AK Render |
+| --- | ---: | ---: |
+| Presentation guidance read | 25.0k (baseline mean) | 10.6k (shared contract, skill, catalog, `describe --json`) |
+| Written by the agent | 13.9k (median legacy page) | 7.2k (projected spec) |
+| Returned into context | the written page is already there | 0.1k (render summary) |
+| **Total, estimated** | **38.9k** | **17.9k (−54%)** |
+
+With the compact workflow the agent guide recommends,
+`describe <types...> --compact`, the guidance read is 5.7k and the total
+13.1k (−66%). The spec written and the summary returned are the same.
+
+- **Benchmarked:** presentation context drops 64–68%, from 23.7k–26.6k tokens
+  of AgentKit's legacy HTML guidance to 7.9k–8.5k on the `ak-render` skill
+  route: the shared AgentKit contract, the skill, `catalog`, and the
+  `describe --json` output of the blocks a task uses
+  ([render benchmark](./docs/artifacts/benchmark-render.md)). The `ak:preview`
+  diff task (68%) follows AgentKit's reference-loading table directly; the
+  explain, brainstorm and plan rows use the `ak-preview` reference set as a
+  proxy for their hand-written HTML route.
+- **Measured on 12 HTML pages agents wrote in real projects:** a median of 26%
+  of each page is visible text; the rest is markup, CSS and script. The
+  projected median output saving is 52%. A page that is mostly prose saves
+  little or nothing: one of the twelve grew by 35%.
+- **Not measured yet:** live model token counts, repair loops, wall time and
+  output quality.
+
+Characters are measured; tokens are estimated at 4 characters per token. Method
+and per-page data: [agent token cost](./docs/artifacts/agent-token-cost.md),
+produced by `benchmarks/agent-token-cost.mjs`.
+
 ## Design in one screen
 
 ```text
@@ -210,15 +321,17 @@ Six decisions define the boundary, argued in
    model-friendly spec normalizes into a flat node graph with stable IDs for
    rendering, future diff/patch/editor tooling, and MCP surfaces.
 2. **Catalog and registry are separate.** `catalog()` is compact and cheap;
-   `describe(type)` carries the full contract. Discovery stays out of the token
+   `describe(type)` carries the full contract, and `--compact` one line per
+   prop. Discovery stays out of the token
    budget until a block is actually selected.
 3. **The interaction runtime is trusted and declarative.** A closed action
    vocabulary, one small event-delegation script, native HTML controls first,
    and only the feature modules a page uses.
 4. **Themes are typed data, never CSS.** Built-in presets plus user presets that
    `extends` them. No CSS escape hatch, no CDN fonts.
-5. **Local is canonical; cloud is opt-in.** The hosted renderer reuses the same
-   compiler and is never the source of truth.
+5. **Local is canonical; cloud is opt-in.** The hosted renderer and the remote
+   MCP server reuse the same compiler and tool contracts and are never the
+   source of truth.
 6. **Optional capabilities arrive as adapters.** Diagrams can delegate to an
    installed diagram compiler; without one, a structured fallback renders.
 
@@ -248,8 +361,11 @@ import {
 | `render(spec, options)` | Compile a spec to a standalone HTML artifact | Available |
 | `validate(spec)` | Report spec diagnostics without rendering | Available |
 | `normalize(spec)` | Produce the flat internal IR | Available |
-| `catalog()` | Compact list of available blocks and actions | Available |
+| `catalog(options)` | Compact list of blocks and actions, optionally one `category` | Available |
+| `searchCatalog(query)` | Block types ranked by intent words | Available |
 | `describe(type)` | Full machine-readable contract for one entry | Available |
+| `describeMany(types, options)` | Up to 12 contracts, full or `compact` | Available |
+| `recipes()`, `recipe(name)` | Page recipe list, and one recipe's starter spec | Available |
 | `loadTheme(input)` | Validate and resolve a theme preset | Available |
 | `buildThemeCatalog(options)` | Discover built-in, user, project, and explicit presets | Available |
 
@@ -259,8 +375,11 @@ import {
 ak-render page.yaml --out page.html
 ak-render - --out page.html < page.yaml   # read the spec from stdin
 ak-render validate page.json
-ak-render catalog
-ak-render describe carousel
+ak-render catalog [--category <c>]
+ak-render search-catalog <terms...>
+ak-render describe <type...> [--compact]
+ak-render recipes
+ak-render recipe <name>                   # YAML by default
 ak-render themes
 ak-render mcp                             # MCP server over stdio
 
@@ -273,8 +392,10 @@ Every command accepts `--json` and never prompts.
 ## Fixtures and snapshots
 
 `fixtures/pages/` holds the representative corpus the compiler is built
-against: plan, explain, recap, diff, dashboard, media, interactive, and theme
-showcase pages. `fixtures/snapshots/` holds one committed artifact per built-in
+against: plan, explain, recap, diff, dashboard, media, interactive and theme
+showcase pages, one page per widget family, layout, data and theme feature,
+and six composition pages (a dashboard, a benchmark report, a research report,
+a product case study, a data explorer and an incident report). `fixtures/snapshots/` holds one committed artifact per built-in
 preset. See [fixtures/README.md](./fixtures/README.md) and
 [docs/themes.md](./docs/themes.md). Fixtures are the specification: a new
 capability is not done until a fixture exercises it.
@@ -290,18 +411,22 @@ capability is not done until a fixture exercises it.
 | `benchmarks/` | Reproducible measurement harnesses |
 | `docs/adr/` | Architecture decision records |
 | `docs/artifacts/` | Captured measurements and evidence |
-| `skills/`, `.claude-plugin/`, `.agents/plugins/` | Agent skill and plugin manifests |
+| `skills/`, `.claude-plugin/`, `.agents/plugins/`, `plugin.json`, `mcp.json` | Agent skill and plugin manifests |
+| `assets/` | Embedded font licences and the plugin icon (`icon.svg` is the source of `logo.png` and `composer-icon.png`) |
 | `site/` | Landing page spec, build script output and Cloudflare config |
-| `apps/cloud/` | Opt-in Cloudflare renderer (cloud milestone) |
+| `src/mcp/` | MCP protocol, shared tool contracts, stdio and Streamable HTTP transports |
+| `apps/cloud/` | Opt-in Cloudflare renderer: REST routes and the remote MCP endpoint |
 
 ## Development
 
 ```bash
 pnpm install
-pnpm verify          # lint + typecheck + unit tests + build
+pnpm verify          # lint, typecheck, font and recipe checks, unit tests, build
 pnpm test:browser    # Playwright, after: pnpm exec playwright install chromium
 pnpm test:package    # pack, install into a temp project, exercise API and bin
 pnpm bench:baseline  # re-run the legacy presentation-context measurement
+pnpm bench:spec      # spec compression for the composition fixtures
+pnpm build && pnpm bench:render --agentkit ../agentkit --repeat 9  # committed render artifact
 pnpm site:build      # compile the landing page and gallery into site/dist
 pnpm site:deploy     # build, then deploy site/dist with wrangler
 ```

package/dist/blocks/chart/chart-check-kind-rules.d.ts

@@ -0,0 +1,10 @@
+/**
+ * Chart rules that run on the same resolved input the renderer draws: gauge
+ * range, funnel order, treemap size, stacked shares, clipped values, pivot
+ * gaps and overlay positions.
+ */
+import type { IrNode } from '../../ir.js';
+import type { Report } from './chart-check.js';
+/** Rules that run on the resolved chart, once its shape and fields are valid. */
+export declare function checkKindRules(node: IrNode, kind: string, report: Report): void;
+//# sourceMappingURL=chart-check-kind-rules.d.ts.map

package/dist/blocks/chart/chart-check-kind-rules.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"chart-check-kind-rules.d.ts","sourceRoot":"","sources":["../../../src/blocks/chart/chart-check-kind-rules.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAIH,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,aAAa,CAAC;AAG1C,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,kBAAkB,CAAC;AAkC/C,iFAAiF;AACjF,wBAAgB,cAAc,CAAC,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,GAAG,IAAI,CAyF/E"}

package/dist/blocks/chart/chart-check-kind-rules.js

@@ -0,0 +1,151 @@
+/**
+ * Chart rules that run on the same resolved input the renderer draws: gauge
+ * range, funnel order, treemap size, stacked shares, clipped values, pivot
+ * gaps and overlay positions.
+ */
+import { fieldValue } from '../../data/dataset-types.js';
+import { pathIndex, pathKey } from '../../diagnostics.js';
+import { objectListProp, stringProp } from '../../render/block-helpers.js';
+import { encodingProp, magnitudeEncoding, seriesField } from './chart-encodings.js';
+import { CARTESIAN_KINDS, MAX_TREEMAP_CELLS, NUMERIC_X_KINDS, SINGLE_SERIES_KINDS, } from './chart-kinds.js';
+import { buildChartInput } from './chart-model.js';
+/** Overlay x positions must land on the axis: a category name, or a number on a numeric axis. */
+function checkOverlays(node, kind, input, report) {
+    if (!CARTESIAN_KINDS.includes(kind))
+        return;
+    const numericAxis = NUMERIC_X_KINDS.includes(kind);
+    const known = kind === 'waterfall' ? [...input.labels, 'Total'] : input.labels;
+    for (const key of ['markers', 'annotations']) {
+        const items = objectListProp(node, key);
+        const placed = key === 'markers' ? input.encoded?.markers : input.encoded?.annotations;
+        items.forEach((_, index) => {
+            const x = placed?.[index]?.x;
+            const fits = numericAxis ? typeof x === 'number' : known.includes(String(x));
+            if (fits)
+                return;
+            report({
+                path: pathKey(pathIndex(pathKey(node.path, key), index), 'x'),
+                severity: 'warning',
+                message: numericAxis
+                    ? `a ${kind} chart places overlays by number; "${String(x)}" is not drawn`
+                    : `"${String(x)}" is not a category of this chart and is not drawn`,
+                details: { allowed: [...known] },
+            });
+        });
+    }
+}
+/** Rules that run on the resolved chart, once its shape and fields are valid. */
+export function checkKindRules(node, kind, report) {
+    const input = buildChartInput(node);
+    const encoded = input.encoded;
+    const values = input.series[0]?.values ?? [];
+    const valuesPath = node.data === undefined
+        ? pathKey(pathIndex(pathKey(node.path, 'series'), 0), 'values')
+        : pathKey(pathKey(node.path, magnitudeEncoding(node).key), 'field');
+    if (SINGLE_SERIES_KINDS.includes(kind) && node.data === undefined && input.series.length > 1) {
+        report({
+            path: pathKey(node.path, 'series'),
+            severity: 'warning',
+            message: `a ${kind} chart draws only the first series`,
+        });
+    }
+    if (kind === 'gauge' && encoded !== undefined) {
+        const min = encoded.value.min ?? 0;
+        const max = encoded.value.max ?? 100;
+        const count = node.data === undefined ? values.length : node.data.rows.length;
+        if (count !== 1 || (node.data === undefined && input.labels.length !== 1)) {
+            report({ path: valuesPath, message: `a gauge shows exactly one value; found ${count}` });
+        }
+        else if ((values[0] ?? 0) < min || (values[0] ?? 0) > max) {
+            report({
+                path: valuesPath,
+                message: `the gauge value ${values[0]} is outside ${min}–${max}; set value.min or value.max`,
+            });
+        }
+        if (encoded.target !== undefined && (encoded.target < min || encoded.target > max)) {
+            report({
+                path: pathKey(node.path, 'target'),
+                severity: 'warning',
+                message: `target ${encoded.target} is outside ${min}–${max} and is drawn at the edge`,
+            });
+        }
+    }
+    if (kind === 'funnel') {
+        const rises = values.findIndex((value, index) => index > 0 && value > (values[index - 1] ?? 0));
+        if (rises > 0) {
+            report({
+                path: valuesPath,
+                severity: 'warning',
+                message: `funnel stage "${input.labels[rises]}" is larger than the stage before it`,
+            });
+        }
+    }
+    if (kind === 'treemap') {
+        if (input.labels.length > MAX_TREEMAP_CELLS) {
+            report({
+                path: valuesPath,
+                code: 'SPEC_BOUNDS_ERROR',
+                message: `a treemap holds at most ${MAX_TREEMAP_CELLS} cells; found ${input.labels.length}`,
+            });
+        }
+        if (values.some((value) => value < 0)) {
+            report({ path: valuesPath, message: 'treemap values must not be negative' });
+        }
+    }
+    if (kind === 'stacked-bar-100' &&
+        input.series.some((series) => series.values.some((v) => v < 0))) {
+        report({ path: valuesPath, message: 'stacked-bar-100 values must not be negative' });
+    }
+    if (CARTESIAN_KINDS.includes(kind) && encoded !== undefined && kind !== 'stacked-bar-100') {
+        const { min, max } = encoded.y;
+        const plotted = kind === 'scatter'
+            ? encoded.points.map((point) => point.y)
+            : input.series.flatMap((s) => s.values);
+        const outside = plotted.filter((value) => (min !== undefined && value < min) || (max !== undefined && value > max)).length;
+        if (outside > 0 && kind !== 'histogram' && kind !== 'waterfall') {
+            report({
+                path: pathKey(node.path, 'y'),
+                severity: 'warning',
+                message: `${outside} values fall outside y.min/y.max and are clipped at the edge`,
+            });
+        }
+    }
+    if (node.data !== undefined &&
+        seriesField(node) !== undefined &&
+        !SINGLE_SERIES_KINDS.includes(kind)) {
+        checkPivotGaps(node, input.labels.length, report);
+    }
+    checkOverlays(node, kind, input, report);
+}
+/** Warn when a pivoted series misses a category (drawn as 0) or repeats one (summed). */
+function checkPivotGaps(node, categories, report) {
+    if (stringProp(node, 'kind') === 'scatter' || stringProp(node, 'kind') === 'heatmap')
+        return;
+    const x = encodingProp(node, 'x')?.field;
+    const group = seriesField(node);
+    if (x === undefined || group === undefined || node.data === undefined)
+        return;
+    const seen = new Map();
+    const groups = new Set();
+    for (const row of node.data.rows) {
+        const key = JSON.stringify([fieldValue(row, group), fieldValue(row, x)]);
+        groups.add(JSON.stringify(fieldValue(row, group)));
+        seen.set(key, (seen.get(key) ?? 0) + 1);
+    }
+    const path = pathKey(pathKey(node.path, 'series'), 'field');
+    if ([...seen.values()].some((count) => count > 1)) {
+        report({
+            path,
+            severity: 'warning',
+            message: 'some series repeat an x value; their values are summed (use transform.groupBy to aggregate explicitly)',
+        });
+    }
+    if (seen.size < groups.size * categories) {
+        report({
+            path,
+            severity: 'warning',
+            message: 'some series have no row for an x value; those points are drawn as 0',
+        });
+    }
+}
+//# sourceMappingURL=chart-check-kind-rules.js.map

package/dist/blocks/chart/chart-check-kind-rules.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"chart-check-kind-rules.js","sourceRoot":"","sources":["../../../src/blocks/chart/chart-check-kind-rules.ts"],"names":[],"mappings":"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"}

package/dist/blocks/chart/chart-check.d.ts

@@ -0,0 +1,15 @@
+/**
+ * Cross-field chart checks: what the prop schema cannot express.
+ *
+ * Inline charts need labels and series; bound charts must not repeat them and
+ * must name existing, numeric fields for each kind's encodings. Kind rules
+ * (gauge range, funnel order, treemap size, stacked shares) run on the same
+ * resolved input the renderer draws.
+ */
+import { type DiagnosticBag, type DiagnosticInput } from '../../diagnostics.js';
+import type { IrNode } from '../../ir.js';
+export type Report = (input: Omit<DiagnosticInput, 'code'> & {
+    code?: DiagnosticInput['code'];
+}) => void;
+export declare function checkChart(node: IrNode, bag: DiagnosticBag): void;
+//# sourceMappingURL=chart-check.d.ts.map

package/dist/blocks/chart/chart-check.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"chart-check.d.ts","sourceRoot":"","sources":["../../../src/blocks/chart/chart-check.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAIH,OAAO,EAAE,KAAK,aAAa,EAAE,KAAK,eAAe,EAAW,MAAM,sBAAsB,CAAC;AACzF,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,aAAa,CAAC;AAiB1C,MAAM,MAAM,MAAM,GAAG,CACnB,KAAK,EAAE,IAAI,CAAC,eAAe,EAAE,MAAM,CAAC,GAAG;IAAE,IAAI,CAAC,EAAE,eAAe,CAAC,MAAM,CAAC,CAAA;CAAE,KACtE,IAAI,CAAC;AAiLV,wBAAgB,UAAU,CAAC,IAAI,EAAE,MAAM,EAAE,GAAG,EAAE,aAAa,GAAG,IAAI,CAcjE"}