claude-artifact-framework 0.10.0 → 0.11.0

package/README.md

@@ -428,9 +428,39 @@ blank pane), the per-document data pools (`d` inside any block, `output`,
 `custom`, or `when` is THAT document's data; `ctx.update` writes there),
 the empty state, and persistence — all documents and which one is open
 survive reload. Documents keys: `label`, `title`, `blocks`, `empty`.
-Inside `documents`, blocks work as in `panel`; `chat` blocks and `file`
-fields are not supported there (both are app-wide, not per-document) and
-throw at creation.
+
+Inside `documents`, blocks work as in `panel` — **including `chat` and
+`file`, which become per-document**:
+
+- A `chat` block inside `documents` gives **each document its own
+  conversation**, persisted with that document (`data.chat` is scoped). Its
+  `system` function receives the document's data, so the copilot talks
+  about THIS document. One chat block per document (a second throws).
+- A `file` field inside `documents` scopes `ctx.files[key]` to the active
+  document — two documents never collide on the same field key. As
+  everywhere, the live `File` is memory-only: metadata survives reload,
+  the file is re-picked per document.
+
+That combination — one file plus one conversation per tab — is the
+multi-document annotator shape (PDFs, images, CSVs) declared in full:
+
+```js
+ArtifactKit.createApp({
+  title: "Anotador de archivos",
+  layout: "documents",
+  documents: {
+    label: "archivo",
+    title: (d) => (d.archivo && d.archivo.name) || "Sin archivo",
+    blocks: [
+      { fields: [{ key: "archivo", label: "Archivo", type: "file" }] },
+      { custom: (ctx) => { /* render ctx.files.archivo */ }, fill: true },
+      { title: "Copiloto", chat: {
+          system: (d) => "Ayudás con el archivo " + ((d.archivo && d.archivo.name) || "(ninguno)"),
+      }},
+    ],
+  },
+})
+```
 
 ### External libraries, uploaded files, full-bleed custom, viewer identity
 

package/dist/index.esm.js

@@ -1550,15 +1550,10 @@ function validate(spec) {
       throw new Error("claude-artifact-framework: documents.title must be a function of the document's data returning the tab label.");
     }
     checkBlocks(d.blocks);
-    const flat = flattenBlocks(d.blocks);
-    if (flat.some((b) => b && b.chat)) {
-      throw new Error(
-        'claude-artifact-framework: a chat block inside "documents" is not supported \u2014 the conversation store is app-wide, not per document.'
-      );
-    }
-    if (flat.some((b) => (b.fields || []).some((f) => f.type === "file"))) {
+    const chats = flattenBlocks(d.blocks).filter((b) => b && b.chat);
+    if (chats.length > 1) {
       throw new Error(
-        "claude-artifact-framework: `file` fields live in the flat data pool \u2014 they are not supported inside documents (the live File cannot be scoped per document)."
+        "claude-artifact-framework: only one chat block per document \u2014 each document's conversation persists under its own data.chat and there is exactly one."
       );
     }
     return layout;
@@ -1845,6 +1840,7 @@ function DocumentsLayout({ spec, ctx }) {
     ctx.update((d) => {
       d.docs = d.docs.filter((doc) => doc.id !== id);
     });
+    delete ctx.files["doc:" + id];
     if (active && active.id === id) {
       const next = docs[idx + 1] || docs[idx - 1];
       if (next) ctx.setTab(DOC_TAB_KEY, next.id);
@@ -1869,7 +1865,12 @@ function DocumentsLayout({ spec, ctx }) {
     update: (fn) => ctx.update((d) => {
       const doc = (d.docs || []).find((x) => x.id === active.id);
       if (doc) fn(doc.data);
-    })
+    }),
+    // Live File objects scoped per document: each doc gets its own sub-map,
+    // so two documents with the same file field never collide. Like the flat
+    // pool, the File itself is memory-only — metadata survives reload, the
+    // file is re-picked per document.
+    files: ctx.files["doc:" + active.id] = ctx.files["doc:" + active.id] || {}
   };
   return createElement(
     "div",