claude-artifact-framework 0.7.2 → 0.7.3

package/README.md

@@ -1,8 +1,16 @@
 # claude-artifact-framework
 
-Utilities for building apps inside Claude Artifacts: platform storage, reactive
-state, and other primitives verified against the real runtime. Zero
-dependencies, no build step — drop it into an artifact straight from a CDN.
+A declarative framework for building apps inside Claude Artifacts: declare
+what the app **is** — fields, records, steps, a chat with tools, a workspace
+with a copilot — and the framework owns how it works. Persistence, hydration,
+validation, empty/loading/error states, light+dark theming, navigation, and
+the Claude tool loop are construction guarantees, not authoring tasks.
+
+Five layouts (`panel`, `records`, `steps`, `chat`, `workspace`), ten block
+types, tabs/conditional/collapsible composition, shared multi-viewer data,
+and a `custom` escape hatch that keeps every framework service. Zero
+dependencies, no build step — load it straight from a CDN. The decisions and
+the evidence behind them live in [DESIGN.md](./DESIGN.md).
 
 ## Usage via CDN
 
@@ -12,8 +20,11 @@ mirrors npm packages automatically.
 ### As a global script (`<script>` tag)
 
 ```html
-<script src="https://cdn.jsdelivr.net/npm/claude-artifact-framework@0.7.2/dist/index.global.js"></script>
+<script src="https://cdn.jsdelivr.net/npm/claude-artifact-framework@0.7.3/dist/index.global.js"></script>
 <script>
+  ArtifactKit.useReact(React); // hand over the page's React once
+  const App = ArtifactKit.createApp({ title: "Mi app", blocks: [ /* ... */ ] });
+  // lower-level utilities are also exported:
   const { storage, createStore, createPersistedStore, createSharedStore } = ArtifactKit;
 </script>
 ```
@@ -27,11 +38,11 @@ mirrors npm packages automatically.
     createStore,
     createPersistedStore,
     createSharedStore,
-  } from "https://cdn.jsdelivr.net/npm/claude-artifact-framework@0.7.2/dist/index.esm.js";
+  } from "https://cdn.jsdelivr.net/npm/claude-artifact-framework@0.7.3/dist/index.esm.js";
 </script>
 ```
 
-Pin a version (`@0.7.2`) for reproducible artifacts, or drop the version
+Pin a version (`@0.7.3`) for reproducible artifacts, or drop the version
 (`claude-artifact-framework/dist/...`) to always get the latest release.
 
 ### Inside a React artifact
@@ -172,6 +183,9 @@ blocks: [
 ]
 ```
 
+`timer` takes `minutes` and/or `seconds` (`{ seconds: 90 }` for a rest timer),
+plus optional `label` and `doneText`.
+
 `text` blocks also accept a function of data — `{ text: (d) => "Hola " + d.nombre }` —
 with the same contract as `output`.
 
@@ -379,7 +393,8 @@ view state — they survive reload, per viewer. Tabs cannot nest inside tabs;
 Everything an app can declare, in one place.
 
 **Top-level keys**: `title`, `subtitle`, `theme: { seed }`, `layout`, `blocks`,
-`records`, `steps`, `chat`, `data`, `shared`. Anything else throws.
+`records`, `steps`, `chat`, `main`, `sidebar` (workspace panes), `data`,
+`shared`. Anything else throws.
 
 **Layouts** (`layout:`): `panel` (default — grid of blocks), `records` (CRUD
 list), `steps` (wizard), `chat` (conversation with Claude), `workspace`
@@ -389,7 +404,10 @@ list), `steps` (wizard), `chat` (conversation with Claude), `workspace`
 **Block types** (entries of `blocks`, `main`, or `sidebar`): `fields`,
 `output`, `text`, `list`, `chart`, `timer`, `actions`, `chat`, `tabs`,
 `custom`. Any block also accepts `when: (d) => bool` (conditional
-visibility) and `collapsible: true | "collapsed"` (accordion; needs `title`). One type per entry, plus optional `title`, `empty`,
+visibility) and `collapsible: true | "collapsed"` (accordion; needs `title`).
+On every block `title` is the heading string; `list` additionally accepts a
+function as `title`, used as the per-row title (rows fall back to
+`r.title ?? r.name ?? r.label ?? r.text`). One type per entry, plus optional `title`, `empty`,
 `wide`. In the `records` layout, `blocks` render below the list (never on the
 detail screen); their functions receive the same `data` object as everywhere
 else — the collection lives at `d.records`.

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "claude-artifact-framework",
-  "version": "0.7.2",
+  "version": "0.7.3",
   "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",