claude-artifact-framework 0.10.0 → 0.11.0

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "claude-artifact-framework",
-  "version": "0.10.0",
+  "version": "0.11.0",
   "description": "Utilities for building apps inside Claude Artifacts: platform storage, chat tool-calling loops, and other primitives verified against the real runtime.",
   "type": "module",
   "main": "./dist/index.esm.js",

package/src/app.js

@@ -229,15 +229,13 @@ 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 — the conversation store is app-wide, not per document.'
-      );
-    }
-    if (flat.some((b) => (b.fields || []).some((f) => f.type === "file"))) {
+    // Inside documents both chat and file are PER DOCUMENT: the scoped ctx
+    // gives each document its own data.chat and its own ctx.files. One chat
+    // block in the declaration = one conversation per document.
+    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 — they are not supported inside documents (the live File cannot be scoped per document).'
+        "claude-artifact-framework: only one chat block per document — each document's conversation persists under its own data.chat and there is exactly one."
       );
     }
     return layout;
@@ -573,6 +571,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);
@@ -603,6 +602,11 @@ function DocumentsLayout({ spec, ctx }) {
         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 h(