@aparte/plugin-artifacts 0.16.0

package/dist/custom-elements.json

@@ -0,0 +1,1184 @@
+{
+  "schemaVersion": "1.0.0",
+  "readme": "",
+  "modules": [
+    {
+      "kind": "javascript-module",
+      "path": "src/binary-file.ts",
+      "declarations": [
+        {
+          "kind": "function",
+          "name": "resetBinaryArtifacts",
+          "return": {
+            "type": {
+              "text": "void"
+            }
+          },
+          "description": "For tests: forget every produced file and every generation in flight."
+        },
+        {
+          "kind": "function",
+          "name": "renderBinaryFileArtifact",
+          "return": {
+            "type": {
+              "text": "string"
+            }
+          },
+          "parameters": [
+            {
+              "name": "segment",
+              "type": {
+                "text": "ArtifactSegment"
+              }
+            },
+            {
+              "name": "kind",
+              "type": {
+                "text": "string"
+              }
+            }
+          ]
+        },
+        {
+          "kind": "function",
+          "name": "setupBinaryFileArtifact",
+          "return": {
+            "type": {
+              "text": "void"
+            }
+          },
+          "parameters": [
+            {
+              "name": "element",
+              "type": {
+                "text": "HTMLElement"
+              }
+            },
+            {
+              "name": "segment",
+              "type": {
+                "text": "ArtifactSegment"
+              }
+            },
+            {
+              "name": "kind",
+              "type": {
+                "text": "string"
+              }
+            }
+          ]
+        },
+        {
+          "kind": "function",
+          "name": "updateBinaryFileArtifact",
+          "return": {
+            "type": {
+              "text": "void"
+            }
+          },
+          "parameters": [
+            {
+              "name": "element",
+              "type": {
+                "text": "HTMLElement"
+              }
+            },
+            {
+              "name": "segment",
+              "type": {
+                "text": "ArtifactSegment"
+              }
+            },
+            {
+              "name": "isStreaming",
+              "type": {
+                "text": "boolean"
+              }
+            }
+          ]
+        }
+      ],
+      "exports": [
+        {
+          "kind": "js",
+          "name": "resetBinaryArtifacts",
+          "declaration": {
+            "name": "resetBinaryArtifacts",
+            "module": "src/binary-file.ts"
+          }
+        },
+        {
+          "kind": "js",
+          "name": "renderBinaryFileArtifact",
+          "declaration": {
+            "name": "renderBinaryFileArtifact",
+            "module": "src/binary-file.ts"
+          }
+        },
+        {
+          "kind": "js",
+          "name": "setupBinaryFileArtifact",
+          "declaration": {
+            "name": "setupBinaryFileArtifact",
+            "module": "src/binary-file.ts"
+          }
+        },
+        {
+          "kind": "js",
+          "name": "updateBinaryFileArtifact",
+          "declaration": {
+            "name": "updateBinaryFileArtifact",
+            "module": "src/binary-file.ts"
+          }
+        }
+      ]
+    },
+    {
+      "kind": "javascript-module",
+      "path": "src/card.ts",
+      "declarations": [
+        {
+          "kind": "variable",
+          "name": "artifactRenderer",
+          "type": {
+            "text": "AparteSegmentRenderer<ArtifactSegment>"
+          },
+          "default": "{ type: ARTIFACT_SEGMENT_TYPE, render: (segment: ArtifactSegment) => { const kind = (segment.artifactType || 'unknown').toLowerCase(); // Binary file kinds (xlsx/pdf/docx) follow a separate track: the generated JS // is implementation noise, so the file card shows progress, then the file. if (BINARY_FILE_KINDS.has(kind)) { return renderBinaryFileArtifact(segment, kind); } const title = segment.title?.trim() || labelForKind(kind); const displayLang = languageForKind(kind); const isStreaming = !!segment.isStreaming; const previewable = PREVIEWABLE_KINDS.has(kind) && previewEnabled(); // `t()`, not `getLocale().x ?? 'X'`: `t()` already falls back to // APARTE_DEFAULT_LOCALE, so the English lives in ONE place instead of being // re-typed at each call site — and `setLocale()` REPLACES rather than merges, // which makes a partial locale the normal case rather than an edge one. // `download` is title AND aria-label: they disagreed on the button next door, // whose title went through `t('copy')` while its aria-label said \"Copy\" in // every language. const cfg = contextConfig(); const downloadLabel = cfg.t('download'); const previewLabel = cfg.t('preview'); const codeLabel = cfg.t('code'); const isBinary = BINARY_FILE_KINDS.has(kind); const cleanContent = stripCodeFences(segment.content || ''); /* * Ids, so the tabs can POINT at their panels. * * The card announced `role=\"tablist\"` with `role=\"tab\"` buttons and shipped none * of the pattern's obligations: no `aria-controls`, no `role=\"tabpanel\"`, no ids * and no arrow keys. A role is a promise about behaviour — declaring tablist and * then behaving like two ordinary buttons tells a screen-reader user to expect a * relationship and a keyboard model that are not there, which is worse than the * plain buttons it actually was. * * Scoped to the segment id because a transcript holds many cards, and duplicate * ids would make `aria-controls` point at whichever one parsed first. * * Escaped HERE rather than inside an id-building helper: `check:attr-escaping` * follows a local produced by an escaper and cannot see through a function, and * teaching it to trust the helper's NAME is precisely the hole that guard was * just tightened to close. */ const cardId = escapeAttr(segment.id); // The card ALWAYS opens on the code tab, and the preview frame is not built // here at all — it is mounted only when the user presses Preview // (`mountPreviewFrame`, called from the tab handler). // // It used to open on Preview for any artifact that was not streaming, i.e. // every render of a completed one — so reloading a persisted conversation // executed the model's JS with no gesture. Defaulting the tab is not enough // on its own either: a `display:none` iframe still loads and still runs // scripts, so the frame has to be ABSENT, not hidden. // // Ratified decision #8, applied to a tier-(c) affordance: content the app // did not produce does not get to act on its own. return ` <div class=\"aparte-segment aparte-card aparte-segment-artifact-card\" data-segment-id=\"${escapeHtml(segment.id)}\" data-artifact-type=\"${escapeHtml(kind)}\" data-streaming=\"${isStreaming ? 'true' : 'false'}\" data-tab=\"code\" data-previewable=\"${previewable ? 'true' : 'false'}\" data-binary=\"${isBinary ? 'true' : 'false'}\"> <header class=\"aparte-art-card__header\"> <div class=\"aparte-art-card__title-block\"> <span class=\"aparte-badge aparte-badge--outline aparte-art-card__kind\" data-kind=\"${escapeHtml(kind)}\">${escapeHtml(displayLang)}</span> <span class=\"aparte-art-card__title\">${escapeHtml(title)}</span> ${isStreaming ? `<span class=\"aparte-dot aparte-art-card__pulse\" role=\"img\" aria-label=\"${escapeAttr(cfg.t('generating'))}\"></span>` : ''} </div> <div class=\"aparte-art-card__actions\"> <button type=\"button\" class=\"aparte-btn aparte-btn--icon aparte-art-card__btn\" data-action=\"copy\" title=\"${escapeAttr(contextConfig().t('copy'))}\" aria-label=\"${escapeAttr(contextConfig().t('copy'))}\"> ${contextConfig().getIcon('copy')} </button> <button type=\"button\" class=\"aparte-btn aparte-btn--icon aparte-art-card__btn\" data-action=\"download\" title=\"${escapeAttr(downloadLabel)}\" aria-label=\"${escapeAttr(downloadLabel)}\" ${isStreaming ? 'disabled' : ''}> ${contextConfig().getIcon('download')} </button> </div> </header> <nav class=\"aparte-tabs aparte-tabs--underline aparte-art-card__tabs\" role=\"tablist\"> <button type=\"button\" class=\"aparte-tabs__tab\" role=\"tab\" id=\"aparte-art-${cardId}-tab-code\" aria-controls=\"aparte-art-${cardId}-pane-code\" aria-selected=\"true\" tabindex=\"0\" data-tab-target=\"code\">${escapeHtml(codeLabel)}</button> ${previewable ? `<button type=\"button\" class=\"aparte-tabs__tab\" role=\"tab\" id=\"aparte-art-${cardId}-tab-preview\" aria-controls=\"aparte-art-${cardId}-pane-preview\" aria-selected=\"false\" tabindex=\"-1\" data-tab-target=\"preview\" ${isStreaming ? 'disabled' : ''}>${escapeHtml(previewLabel)}</button>` : ''} </nav> <div class=\"aparte-art-card__body\"> <div class=\"aparte-art-card__pane\" role=\"tabpanel\" id=\"aparte-art-${cardId}-pane-code\" aria-labelledby=\"aparte-art-${cardId}-tab-code\" tabindex=\"0\" data-pane=\"code\"> <div class=\"aparte-code-content-wrapper\"> <pre><code class=\"language-${escapeHtml(displayLang)}\">${escapeHtml(cleanContent)}</code></pre> </div> </div> ${previewable ? ` <div class=\"aparte-art-card__pane\" role=\"tabpanel\" id=\"aparte-art-${cardId}-pane-preview\" aria-labelledby=\"aparte-art-${cardId}-tab-preview\" tabindex=\"0\" data-pane=\"preview\"> <div class=\"aparte-art-card__pending\">${escapeHtml(cfg.t('previewPending'))}</div> </div> ` : ''} </div> </div> `; }, /** * Every string this card shows: the copy button's tooltip, glyph and accessible * name, the download button's title and label, and the two tab names. They were * all hardcoded literals until they got locale keys — including the copy button's * `aria-label`, which said \"Copy\" while its own `title` one attribute away already * went through `t('copy')`, so a French reader got a French tooltip and an English * announcement. * * Nothing here touches the tab state or the preview pane: a mounted iframe is * running model-authored code, and re-rendering this card is exactly what the * hook exists to avoid. */ relabel: (element: HTMLElement) => { const cfg = contextConfig(); const copyBtn = element.querySelector('.aparte-art-card__btn[data-action=\"copy\"]'); if (copyBtn) { copyBtn.setAttribute('title', cfg.t('copy')); copyBtn.setAttribute('aria-label', cfg.t('copy')); copyBtn.innerHTML = cfg.getIcon('copy'); } const dl = element.querySelector('.aparte-art-card__btn[data-action=\"download\"]'); if (dl) { const label = cfg.t('download'); dl.setAttribute('title', label); dl.setAttribute('aria-label', label); } // Text only, and never `aria-selected` or `data-tab`: which pane is open is // the reader's state, not the locale's. A relabel that touched it would close // a preview somebody had opened. const previewTab = element.querySelector('[data-tab-target=\"preview\"]'); if (previewTab) previewTab.textContent = cfg.t('preview'); const codeTab = element.querySelector('[data-tab-target=\"code\"]'); if (codeTab) codeTab.textContent = cfg.t('code'); }, setup: (element: HTMLElement, segment: AparteArtifactSegment) => { latestSegment.set(element, segment); const kind = (segment.artifactType || '').toLowerCase(); if (BINARY_FILE_KINDS.has(kind)) { setupBinaryFileArtifact(element, segment, kind); return; } // Async highlight on the code pane const wrapper = element.querySelector('.aparte-code-content-wrapper'); if (wrapper) { const displayLang = languageForKind(kind); const cleanContent = stripCodeFences(segment.content || ''); void contextConfig().highlightCode(cleanContent, displayLang).then(html => { wrapper.innerHTML = html; }).catch(() => { /* best-effort: a failed highlight degrades silently */ }); } /* * Tab switching — and, for Preview, the one place the frame is created. * * A `tablist` is a SINGLE tab stop with arrow keys inside it, not N tab stops. * This shipped as two ordinary buttons under a tablist role: Tab landed on each * in turn and the arrows did nothing, so the role promised a keyboard model the * card did not have. The roving `tabindex` and the arrow handling below are that * model; `aria-controls` / `role=\"tabpanel\"` in the markup are the other half. */ const tabs = [...element.querySelectorAll<HTMLButtonElement>('[data-tab-target]')]; const select = (btn: HTMLButtonElement, focus: boolean): void => { const target = btn.getAttribute('data-tab-target'); if (!target || btn.disabled) return; if (target === 'preview') mountPreviewFrame(element, segment); element.setAttribute('data-tab', target); for (const b of tabs) { const on = b === btn; b.setAttribute('aria-selected', on ? 'true' : 'false'); b.tabIndex = on ? 0 : -1; } if (focus) btn.focus(); }; for (const [i, btn] of tabs.entries()) { btn.addEventListener('click', () => select(btn, false)); btn.addEventListener('keydown', (e) => { // Home/End as well as the arrows: both are in the pattern, and on a // two-tab list they are the fastest way to the one you are not on. const step = e.key === 'ArrowRight' ? 1 : e.key === 'ArrowLeft' ? -1 : 0; let next = -1; if (step) next = (i + step + tabs.length) % tabs.length; else if (e.key === 'Home') next = 0; else if (e.key === 'End') next = tabs.length - 1; if (next < 0) return; e.preventDefault(); // Skip a disabled tab rather than trapping focus on it: Preview is // disabled while the artifact still streams. for (let n = 0; n < tabs.length; n++) { const candidate = tabs[(next + n * (step || 1) + tabs.length) % tabs.length]; if (candidate && !candidate.disabled) { select(candidate, true); return; } } }); } // Copy const copyBtn = element.querySelector<HTMLButtonElement>('[data-action=\"copy\"]'); if (copyBtn) { copyBtn.addEventListener('click', () => { // Late execution (user click) — resolve from the element. const code = stripCodeFences(segment.content || ''); void copyText(code).catch(() => { /* best-effort: a failed clipboard write degrades silently */ }); const original = copyBtn.innerHTML; copyBtn.innerHTML = contextConfig(copyBtn).getIcon('check'); copyBtn.setAttribute('title', contextConfig(copyBtn).t('copied')); setTimeout(() => { copyBtn.innerHTML = original; copyBtn.setAttribute('title', contextConfig(copyBtn).t('copy')); }, 1500); }); } // Download — a text artifact downloads from its own content. (A binary one // never reaches here: its setup returned above, and its file card owns the // button.) The LATEST segment, not the one this closure captured. const dlBtn = element.querySelector<HTMLButtonElement>('[data-action=\"download\"]'); if (dlBtn) { dlBtn.addEventListener('click', () => { if (dlBtn.disabled) return; downloadTextArtifact(latestSegment.get(element) ?? segment); }); } }, update: (element: HTMLElement, segment: AparteArtifactSegment) => { // Keep the click handler's view of the artifact current, and throw away a // frame that is now showing stale content so the next press rebuilds it. const previous = latestSegment.get(element); latestSegment.set(element, segment); if (previous && previous.content !== segment.content) { element.querySelector('.aparte-art-card__pane[data-pane=\"preview\"] iframe')?.remove(); } const isStreaming = !!segment.isStreaming; const kind = (segment.artifactType || '').toLowerCase(); if (BINARY_FILE_KINDS.has(kind)) { updateBinaryFileArtifact(element, segment, isStreaming); return; } const wasStreaming = element.getAttribute('data-streaming') === 'true'; const cleanContent = stripCodeFences(segment.content || ''); // 1. Live-update the code pane during streaming. // // One call owns both halves — the plain tail every token and the coloured // prefix on a throttle. Setting `textContent` here as well is what made the // pane flicker: it erased the highlighter's spans on every token. if (isStreaming) { const segId = element.getAttribute('data-segment-id') ?? segment.id; streamHighlight(element, '.aparte-code-content-wrapper', cleanContent, languageForKind(kind), segId); } else { const codeEl = element.querySelector('.aparte-code-content-wrapper code'); if (codeEl) { codeEl.textContent = cleanContent; } else { const wrapper = element.querySelector('.aparte-code-content-wrapper'); if (wrapper) { const displayLang = languageForKind(kind); wrapper.innerHTML = `<pre><code class=\"language-${escapeHtml(displayLang)}\">${escapeHtml(cleanContent)}</code></pre>`; } } } // 2. On stream-completion: highlight + build preview iframe + auto-switch if (wasStreaming && !isStreaming) { element.setAttribute('data-streaming', 'false'); // The pulse says \"the model is still writing this\". `render()` painted it // and nothing ever took it away, so a finished document kept claiming to be // in flight — forever, at 1.2s a cycle. Unnoticed until the artifact demo // actually streamed: the indicator had never been exercised. element.querySelector('.aparte-art-card__pulse')?.remove(); // Re-run syntax highlight now that content is final const wrapper = element.querySelector('.aparte-code-content-wrapper'); if (wrapper) { const displayLang = languageForKind(kind); void contextConfig().highlightCode(cleanContent, displayLang).then(html => { wrapper.innerHTML = html; }).catch(() => { /* best-effort: a failed highlight degrades silently */ }); } // Enable previously-disabled buttons (download, preview tab) element.querySelectorAll<HTMLButtonElement>('button[disabled]').forEach(b => { b.disabled = false; }); // Nothing to build and nothing to switch: enabling the Preview button // above is the whole of it. The frame is mounted by the tab handler, on // a real user press — see the note at `initialTab`. } }, // The card's sheet, injected once per document by core — the seam a renderer that // is not core's has onto the page. It is a real `.css` file, inlined at build. getStyles: () => artifactStyles, }"
+        }
+      ],
+      "exports": [
+        {
+          "kind": "js",
+          "name": "artifactRenderer",
+          "declaration": {
+            "name": "artifactRenderer",
+            "module": "src/card.ts"
+          }
+        }
+      ]
+    },
+    {
+      "kind": "javascript-module",
+      "path": "src/highlight.ts",
+      "declarations": [
+        {
+          "kind": "function",
+          "name": "markThrottle",
+          "return": {
+            "type": {
+              "text": "void"
+            }
+          },
+          "parameters": [
+            {
+              "name": "map",
+              "type": {
+                "text": "Map<string, number>"
+              }
+            },
+            {
+              "name": "id",
+              "type": {
+                "text": "string"
+              }
+            },
+            {
+              "name": "at",
+              "type": {
+                "text": "number"
+              }
+            }
+          ],
+          "description": "Record `id`'s last-seen time in a bounded, insertion-ordered map.\n\nShared with the artifact's event-dispatch throttle, which is why it is generic\nover the map rather than closing over one."
+        },
+        {
+          "kind": "function",
+          "name": "streamHighlight",
+          "return": {
+            "type": {
+              "text": "void"
+            }
+          },
+          "parameters": [
+            {
+              "name": "element",
+              "type": {
+                "text": "HTMLElement"
+              }
+            },
+            {
+              "name": "paneSelector",
+              "type": {
+                "text": "string"
+              }
+            },
+            {
+              "name": "content",
+              "type": {
+                "text": "string"
+              }
+            },
+            {
+              "name": "lang",
+              "type": {
+                "text": "string"
+              }
+            },
+            {
+              "name": "segId",
+              "type": {
+                "text": "string"
+              }
+            }
+          ],
+          "description": "Paint `content` into `paneSelector` while it streams.\n\nCall it on every token: the cheap half runs every time, the highlight is\nthrottled internally. The caller still runs one final, whole-content highlight\nwhen the segment settles — this function deliberately never colours the last\nline, so the settle pass is what completes it."
+        }
+      ],
+      "exports": [
+        {
+          "kind": "js",
+          "name": "markThrottle",
+          "declaration": {
+            "name": "markThrottle",
+            "module": "src/highlight.ts"
+          }
+        },
+        {
+          "kind": "js",
+          "name": "streamHighlight",
+          "declaration": {
+            "name": "streamHighlight",
+            "module": "src/highlight.ts"
+          }
+        }
+      ]
+    },
+    {
+      "kind": "javascript-module",
+      "path": "src/index.node.ts",
+      "declarations": [
+        {
+          "kind": "function",
+          "name": "setupArtifacts",
+          "return": {
+            "type": {
+              "text": "() => void"
+            }
+          },
+          "parameters": [
+            {
+              "name": "options",
+              "default": "{}",
+              "type": {
+                "text": "ArtifactsSetupOptions"
+              }
+            },
+            {
+              "name": "config",
+              "default": "aparteGlobalConfig",
+              "type": {
+                "text": "AparteConfig"
+              }
+            }
+          ],
+          "description": "Register the tool, its handler and the grammar on the server. No renderer: it builds DOM."
+        }
+      ],
+      "exports": [
+        {
+          "kind": "js",
+          "name": "setupArtifacts",
+          "declaration": {
+            "name": "setupArtifacts",
+            "module": "src/index.node.ts"
+          }
+        },
+        {
+          "kind": "js",
+          "name": "createArtifactTool",
+          "declaration": {
+            "name": "createArtifactTool",
+            "module": "./tool.js"
+          }
+        },
+        {
+          "kind": "js",
+          "name": "artifactHandler",
+          "declaration": {
+            "name": "artifactHandler",
+            "module": "./tool.js"
+          }
+        },
+        {
+          "kind": "js",
+          "name": "ARTIFACT_SYSTEM_PROMPT",
+          "declaration": {
+            "name": "ARTIFACT_SYSTEM_PROMPT",
+            "module": "./tool.js"
+          }
+        },
+        {
+          "kind": "js",
+          "name": "ArtifactToolOptions",
+          "declaration": {
+            "name": "ArtifactToolOptions",
+            "module": "./tool.js"
+          }
+        },
+        {
+          "kind": "js",
+          "name": "artifactBlock",
+          "declaration": {
+            "name": "artifactBlock",
+            "module": "./segment.js"
+          }
+        },
+        {
+          "kind": "js",
+          "name": "artifactSegment",
+          "declaration": {
+            "name": "artifactSegment",
+            "module": "./segment.js"
+          }
+        },
+        {
+          "kind": "js",
+          "name": "artifactFromToolCall",
+          "declaration": {
+            "name": "artifactFromToolCall",
+            "module": "./segment.js"
+          }
+        },
+        {
+          "kind": "js",
+          "name": "ARTIFACT_TAG",
+          "declaration": {
+            "name": "ARTIFACT_TAG",
+            "module": "./segment.js"
+          }
+        },
+        {
+          "kind": "js",
+          "name": "ARTIFACT_SEGMENT_TYPE",
+          "declaration": {
+            "name": "ARTIFACT_SEGMENT_TYPE",
+            "module": "./segment.js"
+          }
+        },
+        {
+          "kind": "js",
+          "name": "ArtifactSegment",
+          "declaration": {
+            "name": "ArtifactSegment",
+            "module": "./segment.js"
+          }
+        },
+        {
+          "kind": "js",
+          "name": "ArtifactInput",
+          "declaration": {
+            "name": "ArtifactInput",
+            "module": "./segment.js"
+          }
+        },
+        {
+          "kind": "js",
+          "name": "deriveArtifactKind",
+          "declaration": {
+            "name": "deriveArtifactKind",
+            "module": "./kinds.js"
+          }
+        },
+        {
+          "kind": "js",
+          "name": "buildSafePreviewDocument",
+          "declaration": {
+            "name": "buildSafePreviewDocument",
+            "module": "./preview-document.js"
+          }
+        },
+        {
+          "kind": "js",
+          "name": "PREVIEW_CSP",
+          "declaration": {
+            "name": "PREVIEW_CSP",
+            "module": "./preview-document.js"
+          }
+        },
+        {
+          "kind": "js",
+          "name": "ArtifactRenderOptions",
+          "declaration": {
+            "name": "ArtifactRenderOptions",
+            "module": "./options.js"
+          }
+        },
+        {
+          "kind": "js",
+          "name": "ArtifactPreviewBuilder",
+          "declaration": {
+            "name": "ArtifactPreviewBuilder",
+            "module": "./options.js"
+          }
+        },
+        {
+          "kind": "js",
+          "name": "ArtifactBinary",
+          "declaration": {
+            "name": "ArtifactBinary",
+            "module": "./options.js"
+          }
+        },
+        {
+          "kind": "js",
+          "name": "ArtifactBinaryResolver",
+          "declaration": {
+            "name": "ArtifactBinaryResolver",
+            "module": "./options.js"
+          }
+        },
+        {
+          "kind": "js",
+          "name": "ArtifactsSetupOptions",
+          "declaration": {
+            "name": "ArtifactsSetupOptions",
+            "module": "./options.js"
+          }
+        },
+        {
+          "kind": "js",
+          "name": "AparteTool",
+          "declaration": {
+            "name": "AparteTool",
+            "package": "@aparte/core"
+          }
+        },
+        {
+          "kind": "js",
+          "name": "AparteToolHandler",
+          "declaration": {
+            "name": "AparteToolHandler",
+            "package": "@aparte/core"
+          }
+        },
+        {
+          "kind": "js",
+          "name": "AparteToolCall",
+          "declaration": {
+            "name": "AparteToolCall",
+            "package": "@aparte/core"
+          }
+        },
+        {
+          "kind": "js",
+          "name": "AparteToolResult",
+          "declaration": {
+            "name": "AparteToolResult",
+            "package": "@aparte/core"
+          }
+        }
+      ]
+    },
+    {
+      "kind": "javascript-module",
+      "path": "src/index.ts",
+      "declarations": [
+        {
+          "kind": "function",
+          "name": "setupArtifacts",
+          "return": {
+            "type": {
+              "text": "() => void"
+            }
+          },
+          "parameters": [
+            {
+              "name": "options",
+              "default": "{}",
+              "type": {
+                "text": "ArtifactsSetupOptions"
+              }
+            },
+            {
+              "name": "config",
+              "default": "aparteGlobalConfig",
+              "type": {
+                "text": "AparteConfig"
+              }
+            }
+          ],
+          "description": "Register the tool, its renderer, the block grammar and the segment renderer on\n`config` (the global config by default). Call once at application startup;\nreturns a function that unregisters all four."
+        }
+      ],
+      "exports": [
+        {
+          "kind": "js",
+          "name": "setupArtifacts",
+          "declaration": {
+            "name": "setupArtifacts",
+            "module": "src/index.ts"
+          }
+        },
+        {
+          "kind": "js",
+          "name": "createArtifactTool",
+          "declaration": {
+            "name": "createArtifactTool",
+            "module": "./tool.js"
+          }
+        },
+        {
+          "kind": "js",
+          "name": "artifactHandler",
+          "declaration": {
+            "name": "artifactHandler",
+            "module": "./tool.js"
+          }
+        },
+        {
+          "kind": "js",
+          "name": "ARTIFACT_SYSTEM_PROMPT",
+          "declaration": {
+            "name": "ARTIFACT_SYSTEM_PROMPT",
+            "module": "./tool.js"
+          }
+        },
+        {
+          "kind": "js",
+          "name": "ArtifactToolOptions",
+          "declaration": {
+            "name": "ArtifactToolOptions",
+            "module": "./tool.js"
+          }
+        },
+        {
+          "kind": "js",
+          "name": "artifactRenderer",
+          "declaration": {
+            "name": "artifactRenderer",
+            "module": "./card.js"
+          }
+        },
+        {
+          "kind": "js",
+          "name": "AparteArtifactSegment",
+          "declaration": {
+            "name": "AparteArtifactSegment",
+            "module": "./card.js"
+          }
+        },
+        {
+          "kind": "js",
+          "name": "artifactBlock",
+          "declaration": {
+            "name": "artifactBlock",
+            "module": "./segment.js"
+          }
+        },
+        {
+          "kind": "js",
+          "name": "artifactSegment",
+          "declaration": {
+            "name": "artifactSegment",
+            "module": "./segment.js"
+          }
+        },
+        {
+          "kind": "js",
+          "name": "artifactFromToolCall",
+          "declaration": {
+            "name": "artifactFromToolCall",
+            "module": "./segment.js"
+          }
+        },
+        {
+          "kind": "js",
+          "name": "ARTIFACT_TAG",
+          "declaration": {
+            "name": "ARTIFACT_TAG",
+            "module": "./segment.js"
+          }
+        },
+        {
+          "kind": "js",
+          "name": "ARTIFACT_SEGMENT_TYPE",
+          "declaration": {
+            "name": "ARTIFACT_SEGMENT_TYPE",
+            "module": "./segment.js"
+          }
+        },
+        {
+          "kind": "js",
+          "name": "ArtifactSegment",
+          "declaration": {
+            "name": "ArtifactSegment",
+            "module": "./segment.js"
+          }
+        },
+        {
+          "kind": "js",
+          "name": "ArtifactInput",
+          "declaration": {
+            "name": "ArtifactInput",
+            "module": "./segment.js"
+          }
+        },
+        {
+          "kind": "js",
+          "name": "deriveArtifactKind",
+          "declaration": {
+            "name": "deriveArtifactKind",
+            "module": "./kinds.js"
+          }
+        },
+        {
+          "kind": "js",
+          "name": "buildSafePreviewDocument",
+          "declaration": {
+            "name": "buildSafePreviewDocument",
+            "module": "./preview-document.js"
+          }
+        },
+        {
+          "kind": "js",
+          "name": "PREVIEW_CSP",
+          "declaration": {
+            "name": "PREVIEW_CSP",
+            "module": "./preview-document.js"
+          }
+        },
+        {
+          "kind": "js",
+          "name": "ArtifactRenderOptions",
+          "declaration": {
+            "name": "ArtifactRenderOptions",
+            "module": "./options.js"
+          }
+        },
+        {
+          "kind": "js",
+          "name": "ArtifactPreviewBuilder",
+          "declaration": {
+            "name": "ArtifactPreviewBuilder",
+            "module": "./options.js"
+          }
+        },
+        {
+          "kind": "js",
+          "name": "ArtifactBinary",
+          "declaration": {
+            "name": "ArtifactBinary",
+            "module": "./options.js"
+          }
+        },
+        {
+          "kind": "js",
+          "name": "ArtifactBinaryResolver",
+          "declaration": {
+            "name": "ArtifactBinaryResolver",
+            "module": "./options.js"
+          }
+        },
+        {
+          "kind": "js",
+          "name": "ArtifactsSetupOptions",
+          "declaration": {
+            "name": "ArtifactsSetupOptions",
+            "module": "./options.js"
+          }
+        },
+        {
+          "kind": "js",
+          "name": "AparteTool",
+          "declaration": {
+            "name": "AparteTool",
+            "package": "@aparte/core"
+          }
+        },
+        {
+          "kind": "js",
+          "name": "AparteToolHandler",
+          "declaration": {
+            "name": "AparteToolHandler",
+            "package": "@aparte/core"
+          }
+        },
+        {
+          "kind": "js",
+          "name": "AparteToolCall",
+          "declaration": {
+            "name": "AparteToolCall",
+            "package": "@aparte/core"
+          }
+        },
+        {
+          "kind": "js",
+          "name": "AparteToolResult",
+          "declaration": {
+            "name": "AparteToolResult",
+            "package": "@aparte/core"
+          }
+        }
+      ]
+    },
+    {
+      "kind": "javascript-module",
+      "path": "src/kinds.ts",
+      "declarations": [
+        {
+          "kind": "function",
+          "name": "deriveArtifactKind",
+          "return": {
+            "type": {
+              "text": "string"
+            }
+          },
+          "parameters": [
+            {
+              "name": "mimeType",
+              "type": {
+                "text": "string"
+              }
+            },
+            {
+              "name": "fallback",
+              "default": "'unknown'"
+            }
+          ],
+          "description": "Map an artifact MIME type to a renderer kind — `'react'`, `'html'`, `'js'`, `'css'`,\n`'svg'`, `'json'`, `'markdown'`, `'csv'`, `'text'` — or `fallback` (default\n`'unknown'`) for anything else. Anthropic's `application/vnd.ant.*` namespace maps to\nits suffix; exact standard MIMEs are matched first, then a substring rescue for\nparameterised or vendor variants (`text/html; charset=utf-8`, `application/ld+json`).\n\nTHE implementation, and the plugin's: it used to live in `@aparte/engine` and be\nre-exported by `@aparte/core`, because the engine's built-in `create_artifact` and\ncore's parser both needed it. Neither does any more — an artifact is a plugin's\nconvention, so the function that names its kinds is the plugin's too."
+        }
+      ],
+      "exports": [
+        {
+          "kind": "js",
+          "name": "deriveArtifactKind",
+          "declaration": {
+            "name": "deriveArtifactKind",
+            "module": "src/kinds.ts"
+          }
+        }
+      ]
+    },
+    {
+      "kind": "javascript-module",
+      "path": "src/options.ts",
+      "declarations": [
+        {
+          "kind": "function",
+          "name": "setRenderOptions",
+          "return": {
+            "type": {
+              "text": "void"
+            }
+          },
+          "parameters": [
+            {
+              "name": "config",
+              "type": {
+                "text": "AparteConfig"
+              }
+            },
+            {
+              "name": "options",
+              "type": {
+                "text": "ArtifactRenderOptions"
+              }
+            }
+          ]
+        },
+        {
+          "kind": "function",
+          "name": "renderOptions",
+          "return": {
+            "type": {
+              "text": "ArtifactRenderOptions"
+            }
+          },
+          "parameters": [
+            {
+              "name": "config",
+              "type": {
+                "text": "AparteConfig"
+              }
+            }
+          ],
+          "description": "The options for this config, else the global config's, else the defaults."
+        },
+        {
+          "kind": "function",
+          "name": "clearRenderOptions",
+          "return": {
+            "type": {
+              "text": "void"
+            }
+          },
+          "parameters": [
+            {
+              "name": "config",
+              "type": {
+                "text": "AparteConfig"
+              }
+            }
+          ],
+          "description": "For tests and a teardown: forget what a config was told."
+        }
+      ],
+      "exports": [
+        {
+          "kind": "js",
+          "name": "setRenderOptions",
+          "declaration": {
+            "name": "setRenderOptions",
+            "module": "src/options.ts"
+          }
+        },
+        {
+          "kind": "js",
+          "name": "renderOptions",
+          "declaration": {
+            "name": "renderOptions",
+            "module": "src/options.ts"
+          }
+        },
+        {
+          "kind": "js",
+          "name": "clearRenderOptions",
+          "declaration": {
+            "name": "clearRenderOptions",
+            "module": "src/options.ts"
+          }
+        }
+      ]
+    },
+    {
+      "kind": "javascript-module",
+      "path": "src/preview-document.ts",
+      "declarations": [
+        {
+          "kind": "variable",
+          "name": "PREVIEW_CSP",
+          "type": {
+            "text": "string"
+          },
+          "default": "\"default-src 'none'; script-src 'unsafe-inline'; style-src 'unsafe-inline'; img-src data:; font-src data:\"",
+          "description": "What a previewed artifact is allowed to FETCH. Inline script and style are\npermitted (that IS the preview); no fetch, no XHR, no websocket, no remote image,\nno font. Without this the sandbox still lets injected code beacon out to any\norigin, so the policy does real work — measured blocked in Chromium, Firefox and\nWebKit.\n\nWHAT IT DOES NOT STOP, stated because the sentence here used to claim otherwise:\nthe frame NAVIGATING ITSELF. Assigning `location.href` is a navigation, not a\nfetch, and no directive in this policy governs it — CSP's `navigate-to` was\nremoved from the spec and never shipped, and the parent page's `frame-src` does\nnot apply to a navigation the frame initiates. Reproduced in all three engines;\nin Firefox and WebKit the frame then RENDERS the attacker's page inside the card,\nwhich is a phishing surface as well as an exfiltration channel.\n\nWhat still holds, and is why this is serious rather than fatal: the sandbox has\nno `allow-same-origin`, so the frame's origin is opaque — it cannot read the host\npage, its storage, or the API key — and no `allow-forms` or\n`allow-top-navigation`, so it can neither POST nor move the tab.\n\nThe honest summary for a consumer: a previewed artifact cannot reach your page or\nyour data, and can phone home once. Previewing model-authored HTML is running\nuntrusted content in a box, not running nothing."
+        },
+        {
+          "kind": "function",
+          "name": "buildSafePreviewDocument",
+          "return": {
+            "type": {
+              "text": "string"
+            }
+          },
+          "parameters": [
+            {
+              "name": "kind",
+              "type": {
+                "text": "string"
+              }
+            },
+            {
+              "name": "body",
+              "type": {
+                "text": "string"
+              }
+            },
+            {
+              "name": "title",
+              "type": {
+                "text": "string"
+              }
+            }
+          ]
+        }
+      ],
+      "exports": [
+        {
+          "kind": "js",
+          "name": "PREVIEW_CSP",
+          "declaration": {
+            "name": "PREVIEW_CSP",
+            "module": "src/preview-document.ts"
+          }
+        },
+        {
+          "kind": "js",
+          "name": "buildSafePreviewDocument",
+          "declaration": {
+            "name": "buildSafePreviewDocument",
+            "module": "src/preview-document.ts"
+          }
+        }
+      ]
+    },
+    {
+      "kind": "javascript-module",
+      "path": "src/segment.ts",
+      "declarations": [
+        {
+          "kind": "variable",
+          "name": "ARTIFACT_SEGMENT_TYPE",
+          "type": {
+            "text": "'artifact'"
+          },
+          "default": "'artifact'",
+          "description": "Segment type discriminator. Registered by `setupArtifacts()`, not built into core."
+        },
+        {
+          "kind": "variable",
+          "name": "ARTIFACT_TAG",
+          "type": {
+            "text": "string"
+          },
+          "default": "'artifact'",
+          "description": "The default tag the grammar recognises: `<artifact …>…</artifact>`."
+        },
+        {
+          "kind": "function",
+          "name": "artifactSegment",
+          "return": {
+            "type": {
+              "text": "ArtifactSegment"
+            }
+          },
+          "parameters": [
+            {
+              "name": "id",
+              "type": {
+                "text": "string"
+              }
+            },
+            {
+              "name": "input",
+              "type": {
+                "text": "Partial<ArtifactInput>"
+              }
+            }
+          ],
+          "description": "Build the segment for a document, from either path."
+        },
+        {
+          "kind": "function",
+          "name": "artifactBlock",
+          "return": {
+            "type": {
+              "text": "AparteStreamBlock"
+            }
+          },
+          "parameters": [
+            {
+              "name": "tag",
+              "default": "ARTIFACT_TAG",
+              "type": {
+                "text": "string"
+              }
+            }
+          ],
+          "description": "The block grammar for `<artifact …>…</artifact>` in the prose.\n\nBoth attribute spellings are read — `type=` (Anthropic's) and `mimeType=` — and\n`mimeType` wins when both are present; `title=` is optional. Everything the parser\ndoes with it (chunk boundaries, the partial closing tag, `finalize()`) is core's."
+        },
+        {
+          "kind": "function",
+          "name": "artifactFromToolCall",
+          "return": {
+            "type": {
+              "text": "ArtifactSegment"
+            }
+          },
+          "parameters": [
+            {
+              "name": "segment",
+              "type": {
+                "text": "AparteToolCallSegment"
+              }
+            }
+          ],
+          "description": "The artifact a tool-call segment carries: its structured result once the tool ran,\nelse the model's input while the call is pending — so the card can be drawn before\nthe handler returns, which is instantaneous anyway."
+        }
+      ],
+      "exports": [
+        {
+          "kind": "js",
+          "name": "ARTIFACT_SEGMENT_TYPE",
+          "declaration": {
+            "name": "ARTIFACT_SEGMENT_TYPE",
+            "module": "src/segment.ts"
+          }
+        },
+        {
+          "kind": "js",
+          "name": "ARTIFACT_TAG",
+          "declaration": {
+            "name": "ARTIFACT_TAG",
+            "module": "src/segment.ts"
+          }
+        },
+        {
+          "kind": "js",
+          "name": "artifactSegment",
+          "declaration": {
+            "name": "artifactSegment",
+            "module": "src/segment.ts"
+          }
+        },
+        {
+          "kind": "js",
+          "name": "artifactBlock",
+          "declaration": {
+            "name": "artifactBlock",
+            "module": "src/segment.ts"
+          }
+        },
+        {
+          "kind": "js",
+          "name": "artifactFromToolCall",
+          "declaration": {
+            "name": "artifactFromToolCall",
+            "module": "src/segment.ts"
+          }
+        }
+      ]
+    },
+    {
+      "kind": "javascript-module",
+      "path": "src/shared.ts",
+      "declarations": [
+        {
+          "kind": "function",
+          "name": "stripCodeFences",
+          "return": {
+            "type": {
+              "text": "string"
+            }
+          },
+          "parameters": [
+            {
+              "name": "content",
+              "type": {
+                "text": "string"
+              }
+            }
+          ],
+          "description": "Strip leading/trailing markdown code fences (``` or ~~~, optional lang tag).\nAlso strips any content that appears after the closing fence (small models\nfrequently duplicate lines after the closing ``` block).\n\nChar-based scanner — no regex."
+        },
+        {
+          "kind": "function",
+          "name": "labelForKind",
+          "return": {
+            "type": {
+              "text": "string"
+            }
+          },
+          "parameters": [
+            {
+              "name": "kind",
+              "type": {
+                "text": "string"
+              }
+            }
+          ]
+        }
+      ],
+      "exports": [
+        {
+          "kind": "js",
+          "name": "stripCodeFences",
+          "declaration": {
+            "name": "stripCodeFences",
+            "module": "src/shared.ts"
+          }
+        },
+        {
+          "kind": "js",
+          "name": "labelForKind",
+          "declaration": {
+            "name": "labelForKind",
+            "module": "src/shared.ts"
+          }
+        }
+      ]
+    },
+    {
+      "kind": "javascript-module",
+      "path": "src/tool.ts",
+      "declarations": [
+        {
+          "kind": "variable",
+          "name": "ARTIFACT_SYSTEM_PROMPT",
+          "description": "What the model is told, when the app does not say otherwise."
+        },
+        {
+          "kind": "function",
+          "name": "createArtifactTool",
+          "return": {
+            "type": {
+              "text": "AparteTool"
+            }
+          },
+          "parameters": [
+            {
+              "name": "options",
+              "default": "{}",
+              "type": {
+                "text": "ArtifactToolOptions"
+              }
+            }
+          ],
+          "description": "The tool definition — name, description, input schema, system prompt."
+        },
+        {
+          "kind": "function",
+          "name": "artifactHandler",
+          "return": {
+            "type": {
+              "text": "Promise<AparteToolResult>"
+            }
+          },
+          "parameters": [
+            {
+              "name": "call",
+              "type": {
+                "text": "AparteToolCall"
+              }
+            }
+          ],
+          "description": "The handler: the document IS the result. The prose tells the model what happened;\nthe structured twin carries the artifact for the renderer, verbatim."
+        },
+        {
+          "kind": "variable",
+          "name": "mimeType"
+        },
+        {
+          "kind": "variable",
+          "name": "content"
+        }
+      ],
+      "exports": [
+        {
+          "kind": "js",
+          "name": "ARTIFACT_SYSTEM_PROMPT",
+          "declaration": {
+            "name": "ARTIFACT_SYSTEM_PROMPT",
+            "module": "src/tool.ts"
+          }
+        },
+        {
+          "kind": "js",
+          "name": "createArtifactTool",
+          "declaration": {
+            "name": "createArtifactTool",
+            "module": "src/tool.ts"
+          }
+        },
+        {
+          "kind": "js",
+          "name": "artifactHandler",
+          "declaration": {
+            "name": "artifactHandler",
+            "module": "src/tool.ts"
+          }
+        }
+      ]
+    }
+  ]
+}