@toon-ui/core 1.2.2 → 2.0.0

package/README.md

@@ -1,195 +1,65 @@
 # @toon-ui/core
 
-`@toon-ui/core` is the server and protocol foundation of ToonUI.
+`@toon-ui/core` is the protocol foundation of ToonUI.
 
-Use it when you need:
+Use it when you need the server model, the central catalog, parsing, validation, or event/message conversion.
 
-- `createToonProtocol()` on the server
-- prompt generation
-- parsing and validation
-- interaction payload formatting
-- chat-ready interaction messages
+## Quick path
 
----
-
-## Install
-
-```bash
-pnpm add @toon-ui/core
-```
-
----
+1. Create a protocol with `createToonProtocol()`.
+2. Feed `toon.prompt` into your system prompt.
+3. Use `toon.catalog`, `toon.events`, and `toon.messages` as the public API.
 
 ## Main exports
 
 - `createToonProtocol()`
-- `createToonCoreRuntime()` low-level runtime
+- `createToonCatalog()`
+- `TOON_CATALOG`
 - `parseToonUI()`
 - `validateToonUI()`
 - `extractToonBlocks()`
-- `formatReplyMessage()`
-- `formatSubmitMessage()`
-- `createChatMessage()`
-- `createChatUIMessage()`
-- `createPrompt()`
+- `toToonEventContent()`
 
----
-
-## Server integration
-
-This is the PRIMARY use case.
+## Recommended server usage
 
 ```ts
 import { createToonProtocol } from '@toon-ui/core';
-import { streamText } from 'ai';
-import { openai } from '@ai-sdk/openai';
 
 const toon = createToonProtocol();
+const system = [toon.prompt, 'Available tools:', '- searchProducts(query)'].join('
 
-const system = [
-  toon.prompt,
-  'Available tools:',
-  '- searchProducts(query)',
-  '- createProduct(name, price, stock)',
-].join('\n\n');
-
-export async function POST(req: Request) {
-  const { messages } = await req.json();
-
-  const result = streamText({
-    model: openai('gpt-4.1'),
-    system,
-    messages,
-    tools: {
-      searchProducts: async ({ query }) => ({ ok: true, query }),
-      createProduct: async ({ name, price, stock }) => ({ ok: true, name, price, stock }),
-    },
-  });
-
-  return result.toUIMessageStreamResponse();
-}
+');
 ```
 
-What `createToonProtocol()` gives you:
-
-- `prompt`
-- `rules`
-- `formatReplyMessage()`
-- `formatSubmitMessage()`
-- `createChatMessage()`
-
----
-
-## Frontend integration
-
-`@toon-ui/core` is NOT the recommended frontend renderer package.
-
-Use it on the frontend only if you are building custom tooling or your own renderer.
+## Public API shape
 
 ```ts
-import { extractToonBlocks, parseToonUI, validateToonUI } from '@toon-ui/core';
-
-const blocks = extractToonBlocks(content);
-const ast = parseToonUI(blocks[0].raw);
-const result = validateToonUI(ast);
-```
-
-If you want React rendering, use:
-
-- `@toon-ui/react`
-- or `@toon-ui/toon-ui`
-
----
-
-## Interaction helpers
-
-### `formatReplyMessage()`
-
-```ts
-import { formatReplyMessage } from '@toon-ui/core';
-
-const content = formatReplyMessage({
-  kind: 'ui_reply',
-  eventId: 'reply_123',
-  source: 'button',
-  component: 'button',
-  value: 'Sí, elimínalo',
-});
-```
-
-### `formatSubmitMessage()`
-
-```ts
-import { formatSubmitMessage } from '@toon-ui/core';
-
-const content = formatSubmitMessage({
-  kind: 'ui_submit',
-  eventId: 'submit_123',
-  source: 'form',
-  intent: 'create_product',
-  formTitle: 'Crear producto',
-  values: { name: 'Coca-Cola', price: 2500 },
-});
-```
-
-### `createChatMessage()`
+const toon = createToonProtocol();
 
-```ts
-import { createChatMessage } from '@toon-ui/core';
-
-const message = createChatMessage({
-  kind: 'ui_reply',
-  eventId: 'reply_123',
-  source: 'button',
-  component: 'button',
-  value: 'Sí, elimínalo',
-});
-
-console.log(message.content);
-console.log(message.displayContent);
+toon.catalog.components.form.syntax;
+toon.events.reply('Open details');
+toon.events.submit('create_product', { name: 'Coca-Cola' });
+toon.messages.toContent(payload);
+toon.messages.toModelMessage(payload);
+toon.messages.toUIMessage(payload);
 ```
 
-### `createChatUIMessage()`
+## Why this shape exists
 
-Useful when your frontend uses `useChat`/`UIMessage`-style state and you need:
+The old flat helpers were technically functional but conceptually noisy.
 
-- model-facing `content` in `parts`
-- human-facing `displayContent` in `metadata`
-
-```ts
-import { createChatUIMessage } from '@toon-ui/core';
-
-const message = createChatUIMessage({
-  kind: 'ui_submit',
-  eventId: 'submit_123',
-  source: 'form',
-  intent: 'agregar_cliente',
-  formTitle: 'Agregar cliente',
-  values: {
-    name: 'Jefferson Lopez Mendoza',
-    email: 'jeffersonlopezmendoza343@gmail.com',
-  },
-});
-
-console.log(message.parts[0].text); // model content
-console.log(message.metadata.displayContent); // human content
-```
+The new model is explicit:
 
----
+- `catalog` = language definition
+- `events` = user intent objects
+- `messages` = reinjection into chat state
 
 ## Boundary
 
-`@toon-ui/core` owns:
+`@toon-ui/core` does NOT render React.
 
-- grammar
-- AST
-- validation
-- prompts
-- interaction protocol
+If you need rendering:
 
-It does NOT own:
+- `@toon-ui/react` for explicit adapters
+- `@toon-ui/toon-ui` for the simplest client path
 
-- React rendering
-- backend tools
-- persistence
-- model orchestration

package/dist/catalog.d.ts

@@ -0,0 +1,188 @@
+export declare const TOON_COMPONENT_KEYS: readonly ["text", "heading", "separator", "card", "form", "field", "button", "confirm", "list", "item", "badge", "alert", "table", "empty", "tabs", "accordion", "dialog", "sheet", "popover", "tooltip", "progress", "loading", "toast", "breadcrumb", "pagination", "menu", "command", "chart"];
+export declare const TOON_BUTTON_VARIANTS: readonly ["primary", "secondary", "danger", "ghost", "outline"];
+export declare const TOON_BADGE_VARIANTS: readonly ["success", "warning", "danger", "neutral", "info"];
+export declare const TOON_ALERT_VARIANTS: readonly ["info", "success", "warning", "danger"];
+export declare const TOON_CONFIRM_VARIANTS: readonly ["neutral", "info", "warning", "danger", "success"];
+export declare const TOON_FIELD_TYPES: readonly ["text", "email", "number", "password", "date", "time", "textarea", "select", "checkbox", "radio", "switch", "combobox", "otp", "slider", "multiselect"];
+export declare const TOON_CHART_TYPES: readonly ["bar", "line", "area", "pie"];
+export declare const TOON_SHEET_SIDES: readonly ["left", "right", "top", "bottom"];
+export declare const TOON_SEPARATOR_ORIENTATIONS: readonly ["horizontal", "vertical"];
+export declare const TOON_CATALOG: {
+    readonly components: {
+        readonly text: {
+            readonly group: "content";
+            readonly syntax: "text \"Visible text\"";
+            readonly summary: "Leaf node for visible copy.";
+        };
+        readonly heading: {
+            readonly group: "content";
+            readonly syntax: "heading <1-6> \"Visible text\"";
+            readonly summary: "Semantic heading for hierarchy.";
+        };
+        readonly separator: {
+            readonly group: "content";
+            readonly syntax: "separator OR separator horizontal|vertical";
+            readonly summary: "Visual divider between sections.";
+        };
+        readonly card: {
+            readonly group: "structure";
+            readonly syntax: "card \"Title\": followed by indented child nodes";
+            readonly summary: "General content container.";
+            readonly children: readonly ["*"];
+        };
+        readonly form: {
+            readonly group: "capture";
+            readonly syntax: "form \"Title\": followed by one or more field nodes and one submit button";
+            readonly summary: "Structured data capture block.";
+            readonly children: readonly ["field", "button"];
+        };
+        readonly field: {
+            readonly group: "capture";
+            readonly syntax: "field <name> <fieldType> \"Label\" [placeholder=\"...\"] [required]";
+            readonly summary: "Structured form input primitive.";
+        };
+        readonly button: {
+            readonly group: "capture";
+            readonly syntax: "button <variant> \"Label\" reply=\"Value\" OR button <variant> \"Label\" submit";
+            readonly summary: "Primary interaction trigger.";
+        };
+        readonly confirm: {
+            readonly group: "capture";
+            readonly syntax: "confirm <variant> \"Title\": followed by indented child nodes";
+            readonly summary: "Confirmation flow container.";
+            readonly children: readonly ["*"];
+        };
+        readonly list: {
+            readonly group: "structure";
+            readonly syntax: "list \"Title\": followed only by item nodes";
+            readonly summary: "Structured repeated result set.";
+            readonly children: readonly ["item"];
+        };
+        readonly item: {
+            readonly group: "structure";
+            readonly syntax: "item \"Title\": followed by indented child nodes";
+            readonly summary: "Single list entry container.";
+            readonly children: readonly ["*"];
+        };
+        readonly badge: {
+            readonly group: "content";
+            readonly syntax: "badge \"Label\" <variant>";
+            readonly summary: "Short semantic status label.";
+        };
+        readonly alert: {
+            readonly group: "feedback";
+            readonly syntax: "alert <variant> \"Title\": followed by indented child nodes";
+            readonly summary: "Callout block for important state.";
+            readonly children: readonly ["*"];
+        };
+        readonly table: {
+            readonly group: "structure";
+            readonly syntax: "table \"Title\": followed by columns: ... and one or more row: ... lines";
+            readonly summary: "Precise tabular data.";
+            readonly children: readonly ["columns", "row"];
+        };
+        readonly empty: {
+            readonly group: "feedback";
+            readonly syntax: "empty \"Title\": followed by indented child nodes";
+            readonly summary: "Zero-result or empty state.";
+            readonly children: readonly ["*"];
+        };
+        readonly tabs: {
+            readonly group: "structure";
+            readonly syntax: "tabs \"Title\": followed by one or more tab \"Label\": blocks";
+            readonly summary: "Parallel grouped views.";
+            readonly children: readonly ["tab"];
+        };
+        readonly accordion: {
+            readonly group: "structure";
+            readonly syntax: "accordion \"Title\": followed by one or more section \"Title\": blocks";
+            readonly summary: "Progressive disclosure container.";
+            readonly children: readonly ["section"];
+        };
+        readonly dialog: {
+            readonly group: "overlay";
+            readonly syntax: "dialog \"Title\": followed by indented child nodes";
+            readonly summary: "Modal interaction container.";
+            readonly children: readonly ["*"];
+        };
+        readonly sheet: {
+            readonly group: "overlay";
+            readonly syntax: "sheet \"Title\" side=\"left|right|top|bottom\": followed by indented child nodes";
+            readonly summary: "Edge-attached contextual panel.";
+            readonly children: readonly ["*"];
+        };
+        readonly popover: {
+            readonly group: "overlay";
+            readonly syntax: "popover \"Title\": followed by indented child nodes";
+            readonly summary: "Inline contextual overlay.";
+            readonly children: readonly ["*"];
+        };
+        readonly tooltip: {
+            readonly group: "overlay";
+            readonly syntax: "tooltip \"Visible text\"";
+            readonly summary: "Short contextual hint.";
+        };
+        readonly progress: {
+            readonly group: "feedback";
+            readonly syntax: "progress \"Label\" value=<number> max=<number>";
+            readonly summary: "Deterministic progress indicator.";
+        };
+        readonly loading: {
+            readonly group: "feedback";
+            readonly syntax: "loading \"Visible text\"";
+            readonly summary: "Transient loading feedback.";
+        };
+        readonly toast: {
+            readonly group: "feedback";
+            readonly syntax: "toast <variant> \"Visible text\"";
+            readonly summary: "Ephemeral result feedback.";
+        };
+        readonly breadcrumb: {
+            readonly group: "navigation";
+            readonly syntax: "breadcrumb: followed by one or more crumb \"Label\" [reply=\"...\"] lines";
+            readonly summary: "Hierarchical path navigation.";
+            readonly children: readonly ["crumb"];
+        };
+        readonly pagination: {
+            readonly group: "navigation";
+            readonly syntax: "pagination page=<number> totalPages=<number>";
+            readonly summary: "Page navigation state.";
+        };
+        readonly menu: {
+            readonly group: "navigation";
+            readonly syntax: "menu \"Title\": followed by one or more action \"Label\" reply=\"...\" or submit lines";
+            readonly summary: "Choice list of actions.";
+            readonly children: readonly ["action"];
+        };
+        readonly command: {
+            readonly group: "navigation";
+            readonly syntax: "command \"Title\": followed by one or more action \"Label\" reply=\"...\" or submit lines";
+            readonly summary: "Command palette style action list.";
+            readonly children: readonly ["action"];
+        };
+        readonly chart: {
+            readonly group: "analytics";
+            readonly syntax: "chart <type> \"Title\": followed by one or more series \"Label\": blocks with point \"Label\" <number> rows";
+            readonly summary: "Trend or comparison visualization.";
+            readonly children: readonly ["series"];
+        };
+    };
+    readonly variants: {
+        readonly button: readonly ["primary", "secondary", "danger", "ghost", "outline"];
+        readonly badge: readonly ["success", "warning", "danger", "neutral", "info"];
+        readonly alert: readonly ["info", "success", "warning", "danger"];
+        readonly confirm: readonly ["neutral", "info", "warning", "danger", "success"];
+        readonly field: readonly ["text", "email", "number", "password", "date", "time", "textarea", "select", "checkbox", "radio", "switch", "combobox", "otp", "slider", "multiselect"];
+        readonly chart: readonly ["bar", "line", "area", "pie"];
+        readonly sheet: readonly ["left", "right", "top", "bottom"];
+        readonly separator: readonly ["horizontal", "vertical"];
+    };
+    readonly examples: {
+        readonly valid: readonly [string, string, string, string, string, string, string, "progress \"Inventory sync\" value=65 max=100", "pagination page=2 totalPages=8", string];
+        readonly invalid: readonly ["header \"Customer\"  -> INVALID because header is not an allowed component", "card:             -> INVALID because card requires a quoted title", "badge success \"Customer\" -> INVALID because badge syntax is badge \"Label\" variant", "alert \"Low stock\" -> INVALID because alert requires a variant and nested block", "empty \"No data\" -> INVALID because empty requires a nested block after :", "progress 65 -> INVALID because progress requires a quoted label plus value= and max=", "pagination 2/8 -> INVALID because pagination requires page= and totalPages=", "confirm \"Delete customer?\": -> VALID for backward compatibility, but prefer confirm danger|warning|neutral \"Title\":", "form \"Customer\": with no submit button -> INVALID", "row: May 09, $ 8,155.35, Completed -> RISKY because commas inside values can break the table unless cells are quoted", "\"Do you want me to build a UI for this?\" -> BAD when a form, confirm, table, list, or card is already the obvious best response"];
+    };
+};
+export type ToonCatalog = typeof TOON_CATALOG;
+export declare function createToonCatalog(): ToonCatalog;
+export declare function listToonComponentKeys(): Array<(typeof TOON_COMPONENT_KEYS)[number]>;
+//# sourceMappingURL=catalog.d.ts.map

package/dist/catalog.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"catalog.d.ts","sourceRoot":"","sources":["../src/catalog.ts"],"names":[],"mappings":"AAAA,eAAO,MAAM,mBAAmB,mSA6BtB,CAAC;AAEX,eAAO,MAAM,oBAAoB,iEAAkE,CAAC;AACpG,eAAO,MAAM,mBAAmB,8DAA+D,CAAC;AAChG,eAAO,MAAM,mBAAmB,mDAAoD,CAAC;AACrF,eAAO,MAAM,qBAAqB,8DAA+D,CAAC;AAClG,eAAO,MAAM,gBAAgB,mKAgBnB,CAAC;AACX,eAAO,MAAM,gBAAgB,yCAA0C,CAAC;AACxE,eAAO,MAAM,gBAAgB,6CAA8C,CAAC;AAC5E,eAAO,MAAM,2BAA2B,qCAAsC,CAAC;AAE/E,eAAO,MAAM,YAAY;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;CAoEf,CAAC;AAEX,MAAM,MAAM,WAAW,GAAG,OAAO,YAAY,CAAC;AAE9C,wBAAgB,iBAAiB,IAAI,WAAW,CAE/C;AAED,wBAAgB,qBAAqB,IAAI,KAAK,CAAC,CAAC,OAAO,mBAAmB,CAAC,CAAC,MAAM,CAAC,CAAC,CAEnF"}

package/dist/catalog.js

@@ -0,0 +1,130 @@
+export const TOON_COMPONENT_KEYS = [
+    'text',
+    'heading',
+    'separator',
+    'card',
+    'form',
+    'field',
+    'button',
+    'confirm',
+    'list',
+    'item',
+    'badge',
+    'alert',
+    'table',
+    'empty',
+    'tabs',
+    'accordion',
+    'dialog',
+    'sheet',
+    'popover',
+    'tooltip',
+    'progress',
+    'loading',
+    'toast',
+    'breadcrumb',
+    'pagination',
+    'menu',
+    'command',
+    'chart',
+];
+export const TOON_BUTTON_VARIANTS = ['primary', 'secondary', 'danger', 'ghost', 'outline'];
+export const TOON_BADGE_VARIANTS = ['success', 'warning', 'danger', 'neutral', 'info'];
+export const TOON_ALERT_VARIANTS = ['info', 'success', 'warning', 'danger'];
+export const TOON_CONFIRM_VARIANTS = ['neutral', 'info', 'warning', 'danger', 'success'];
+export const TOON_FIELD_TYPES = [
+    'text',
+    'email',
+    'number',
+    'password',
+    'date',
+    'time',
+    'textarea',
+    'select',
+    'checkbox',
+    'radio',
+    'switch',
+    'combobox',
+    'otp',
+    'slider',
+    'multiselect',
+];
+export const TOON_CHART_TYPES = ['bar', 'line', 'area', 'pie'];
+export const TOON_SHEET_SIDES = ['left', 'right', 'top', 'bottom'];
+export const TOON_SEPARATOR_ORIENTATIONS = ['horizontal', 'vertical'];
+export const TOON_CATALOG = {
+    components: {
+        text: { group: 'content', syntax: 'text "Visible text"', summary: 'Leaf node for visible copy.' },
+        heading: { group: 'content', syntax: 'heading <1-6> "Visible text"', summary: 'Semantic heading for hierarchy.' },
+        separator: { group: 'content', syntax: 'separator OR separator horizontal|vertical', summary: 'Visual divider between sections.' },
+        card: { group: 'structure', syntax: 'card "Title": followed by indented child nodes', summary: 'General content container.', children: ['*'] },
+        form: { group: 'capture', syntax: 'form "Title": followed by one or more field nodes and one submit button', summary: 'Structured data capture block.', children: ['field', 'button'] },
+        field: { group: 'capture', syntax: 'field <name> <fieldType> "Label" [placeholder="..."] [required]', summary: 'Structured form input primitive.' },
+        button: { group: 'capture', syntax: 'button <variant> "Label" reply="Value" OR button <variant> "Label" submit', summary: 'Primary interaction trigger.' },
+        confirm: { group: 'capture', syntax: 'confirm <variant> "Title": followed by indented child nodes', summary: 'Confirmation flow container.', children: ['*'] },
+        list: { group: 'structure', syntax: 'list "Title": followed only by item nodes', summary: 'Structured repeated result set.', children: ['item'] },
+        item: { group: 'structure', syntax: 'item "Title": followed by indented child nodes', summary: 'Single list entry container.', children: ['*'] },
+        badge: { group: 'content', syntax: 'badge "Label" <variant>', summary: 'Short semantic status label.' },
+        alert: { group: 'feedback', syntax: 'alert <variant> "Title": followed by indented child nodes', summary: 'Callout block for important state.', children: ['*'] },
+        table: { group: 'structure', syntax: 'table "Title": followed by columns: ... and one or more row: ... lines', summary: 'Precise tabular data.', children: ['columns', 'row'] },
+        empty: { group: 'feedback', syntax: 'empty "Title": followed by indented child nodes', summary: 'Zero-result or empty state.', children: ['*'] },
+        tabs: { group: 'structure', syntax: 'tabs "Title": followed by one or more tab "Label": blocks', summary: 'Parallel grouped views.', children: ['tab'] },
+        accordion: { group: 'structure', syntax: 'accordion "Title": followed by one or more section "Title": blocks', summary: 'Progressive disclosure container.', children: ['section'] },
+        dialog: { group: 'overlay', syntax: 'dialog "Title": followed by indented child nodes', summary: 'Modal interaction container.', children: ['*'] },
+        sheet: { group: 'overlay', syntax: 'sheet "Title" side="left|right|top|bottom": followed by indented child nodes', summary: 'Edge-attached contextual panel.', children: ['*'] },
+        popover: { group: 'overlay', syntax: 'popover "Title": followed by indented child nodes', summary: 'Inline contextual overlay.', children: ['*'] },
+        tooltip: { group: 'overlay', syntax: 'tooltip "Visible text"', summary: 'Short contextual hint.' },
+        progress: { group: 'feedback', syntax: 'progress "Label" value=<number> max=<number>', summary: 'Deterministic progress indicator.' },
+        loading: { group: 'feedback', syntax: 'loading "Visible text"', summary: 'Transient loading feedback.' },
+        toast: { group: 'feedback', syntax: 'toast <variant> "Visible text"', summary: 'Ephemeral result feedback.' },
+        breadcrumb: { group: 'navigation', syntax: 'breadcrumb: followed by one or more crumb "Label" [reply="..."] lines', summary: 'Hierarchical path navigation.', children: ['crumb'] },
+        pagination: { group: 'navigation', syntax: 'pagination page=<number> totalPages=<number>', summary: 'Page navigation state.' },
+        menu: { group: 'navigation', syntax: 'menu "Title": followed by one or more action "Label" reply="..." or submit lines', summary: 'Choice list of actions.', children: ['action'] },
+        command: { group: 'navigation', syntax: 'command "Title": followed by one or more action "Label" reply="..." or submit lines', summary: 'Command palette style action list.', children: ['action'] },
+        chart: { group: 'analytics', syntax: 'chart <type> "Title": followed by one or more series "Label": blocks with point "Label" <number> rows', summary: 'Trend or comparison visualization.', children: ['series'] },
+    },
+    variants: {
+        button: TOON_BUTTON_VARIANTS,
+        badge: TOON_BADGE_VARIANTS,
+        alert: TOON_ALERT_VARIANTS,
+        confirm: TOON_CONFIRM_VARIANTS,
+        field: TOON_FIELD_TYPES,
+        chart: TOON_CHART_TYPES,
+        sheet: TOON_SHEET_SIDES,
+        separator: TOON_SEPARATOR_ORIENTATIONS,
+    },
+    examples: {
+        valid: [
+            ['form "Create product":', '  field name text "Name" placeholder="Ex: Coca-Cola" required', '  field price number "Price" placeholder="Ex: 25.50" required', '  button primary "Create product" submit'].join('\n'),
+            ['card "Customer found":', '  text "Jefferson Lopez Mendoza"', '  badge "Active" success', '  button secondary "View history" reply="View customer history"'].join('\n'),
+            ['confirm danger "Delete customer?":', '  text "This action cannot be undone."', '  button secondary "Cancel" reply="Cancel"', '  button danger "Yes, delete" reply="Yes, delete customer"'].join('\n'),
+            ['confirm neutral "Continue with selected customer?":', '  text "We will use this customer for the current sale."', '  button secondary "Cancel" reply="Cancel"', '  button primary "Continue" reply="Continue with selected customer"'].join('\n'),
+            ['table "Sales":', '  columns: "Date", "Sale number", "Total", "Status"', '  row: "May 14", "177877222574876", "$ 387.45", "Completed"', '  row: "May 09", "177836532655064", "$ 8,155.35", "Completed"'].join('\n'),
+            ['alert warning "Low stock":', '  text "Only 3 units remain in the warehouse."'].join('\n'),
+            ['empty "No customers found":', '  text "Try another search term or create a new customer."', '  button secondary "Create customer" reply="Create customer"'].join('\n'),
+            'progress "Inventory sync" value=65 max=100',
+            'pagination page=2 totalPages=8',
+            ['chart bar "Weekly sales" x="Day" y="Revenue":', '  series "Store A":', '    point "Mon" 1200', '    point "Tue" 980'].join('\n'),
+        ],
+        invalid: [
+            'header "Customer"  -> INVALID because header is not an allowed component',
+            'card:             -> INVALID because card requires a quoted title',
+            'badge success "Customer" -> INVALID because badge syntax is badge "Label" variant',
+            'alert "Low stock" -> INVALID because alert requires a variant and nested block',
+            'empty "No data" -> INVALID because empty requires a nested block after :',
+            'progress 65 -> INVALID because progress requires a quoted label plus value= and max=',
+            'pagination 2/8 -> INVALID because pagination requires page= and totalPages=',
+            'confirm "Delete customer?": -> VALID for backward compatibility, but prefer confirm danger|warning|neutral "Title":',
+            'form "Customer": with no submit button -> INVALID',
+            'row: May 09, $ 8,155.35, Completed -> RISKY because commas inside values can break the table unless cells are quoted',
+            '"Do you want me to build a UI for this?" -> BAD when a form, confirm, table, list, or card is already the obvious best response',
+        ],
+    },
+};
+export function createToonCatalog() {
+    return TOON_CATALOG;
+}
+export function listToonComponentKeys() {
+    return [...TOON_COMPONENT_KEYS];
+}
+//# sourceMappingURL=catalog.js.map

package/dist/catalog.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"catalog.js","sourceRoot":"","sources":["../src/catalog.ts"],"names":[],"mappings":"AAAA,MAAM,CAAC,MAAM,mBAAmB,GAAG;IACjC,MAAM;IACN,SAAS;IACT,WAAW;IACX,MAAM;IACN,MAAM;IACN,OAAO;IACP,QAAQ;IACR,SAAS;IACT,MAAM;IACN,MAAM;IACN,OAAO;IACP,OAAO;IACP,OAAO;IACP,OAAO;IACP,MAAM;IACN,WAAW;IACX,QAAQ;IACR,OAAO;IACP,SAAS;IACT,SAAS;IACT,UAAU;IACV,SAAS;IACT,OAAO;IACP,YAAY;IACZ,YAAY;IACZ,MAAM;IACN,SAAS;IACT,OAAO;CACC,CAAC;AAEX,MAAM,CAAC,MAAM,oBAAoB,GAAG,CAAC,SAAS,EAAE,WAAW,EAAE,QAAQ,EAAE,OAAO,EAAE,SAAS,CAAU,CAAC;AACpG,MAAM,CAAC,MAAM,mBAAmB,GAAG,CAAC,SAAS,EAAE,SAAS,EAAE,QAAQ,EAAE,SAAS,EAAE,MAAM,CAAU,CAAC;AAChG,MAAM,CAAC,MAAM,mBAAmB,GAAG,CAAC,MAAM,EAAE,SAAS,EAAE,SAAS,EAAE,QAAQ,CAAU,CAAC;AACrF,MAAM,CAAC,MAAM,qBAAqB,GAAG,CAAC,SAAS,EAAE,MAAM,EAAE,SAAS,EAAE,QAAQ,EAAE,SAAS,CAAU,CAAC;AAClG,MAAM,CAAC,MAAM,gBAAgB,GAAG;IAC9B,MAAM;IACN,OAAO;IACP,QAAQ;IACR,UAAU;IACV,MAAM;IACN,MAAM;IACN,UAAU;IACV,QAAQ;IACR,UAAU;IACV,OAAO;IACP,QAAQ;IACR,UAAU;IACV,KAAK;IACL,QAAQ;IACR,aAAa;CACL,CAAC;AACX,MAAM,CAAC,MAAM,gBAAgB,GAAG,CAAC,KAAK,EAAE,MAAM,EAAE,MAAM,EAAE,KAAK,CAAU,CAAC;AACxE,MAAM,CAAC,MAAM,gBAAgB,GAAG,CAAC,MAAM,EAAE,OAAO,EAAE,KAAK,EAAE,QAAQ,CAAU,CAAC;AAC5E,MAAM,CAAC,MAAM,2BAA2B,GAAG,CAAC,YAAY,EAAE,UAAU,CAAU,CAAC;AAE/E,MAAM,CAAC,MAAM,YAAY,GAAG;IAC1B,UAAU,EAAE;QACV,IAAI,EAAE,EAAE,KAAK,EAAE,SAAS,EAAE,MAAM,EAAE,qBAAqB,EAAE,OAAO,EAAE,6BAA6B,EAAE;QACjG,OAAO,EAAE,EAAE,KAAK,EAAE,SAAS,EAAE,MAAM,EAAE,8BAA8B,EAAE,OAAO,EAAE,iCAAiC,EAAE;QACjH,SAAS,EAAE,EAAE,KAAK,EAAE,SAAS,EAAE,MAAM,EAAE,4CAA4C,EAAE,OAAO,EAAE,kCAAkC,EAAE;QAClI,IAAI,EAAE,EAAE,KAAK,EAAE,WAAW,EAAE,MAAM,EAAE,gDAAgD,EAAE,OAAO,EAAE,4BAA4B,EAAE,QAAQ,EAAE,CAAC,GAAG,CAAC,EAAE;QAC9I,IAAI,EAAE,EAAE,KAAK,EAAE,SAAS,EAAE,MAAM,EAAE,yEAAyE,EAAE,OAAO,EAAE,gCAAgC,EAAE,QAAQ,EAAE,CAAC,OAAO,EAAE,QAAQ,CAAC,EAAE;QACvL,KAAK,EAAE,EAAE,KAAK,EAAE,SAAS,EAAE,MAAM,EAAE,iEAAiE,EAAE,OAAO,EAAE,kCAAkC,EAAE;QACnJ,MAAM,EAAE,EAAE,KAAK,EAAE,SAAS,EAAE,MAAM,EAAE,2EAA2E,EAAE,OAAO,EAAE,8BAA8B,EAAE;QAC1J,OAAO,EAAE,EAAE,KAAK,EAAE,SAAS,EAAE,MAAM,EAAE,6DAA6D,EAAE,OAAO,EAAE,8BAA8B,EAAE,QAAQ,EAAE,CAAC,GAAG,CAAC,EAAE;QAC9J,IAAI,EAAE,EAAE,KAAK,EAAE,WAAW,EAAE,MAAM,EAAE,2CAA2C,EAAE,OAAO,EAAE,iCAAiC,EAAE,QAAQ,EAAE,CAAC,MAAM,CAAC,EAAE;QACjJ,IAAI,EAAE,EAAE,KAAK,EAAE,WAAW,EAAE,MAAM,EAAE,gDAAgD,EAAE,OAAO,EAAE,8BAA8B,EAAE,QAAQ,EAAE,CAAC,GAAG,CAAC,EAAE;QAChJ,KAAK,EAAE,EAAE,KAAK,EAAE,SAAS,EAAE,MAAM,EAAE,yBAAyB,EAAE,OAAO,EAAE,8BAA8B,EAAE;QACvG,KAAK,EAAE,EAAE,KAAK,EAAE,UAAU,EAAE,MAAM,EAAE,2DAA2D,EAAE,OAAO,EAAE,oCAAoC,EAAE,QAAQ,EAAE,CAAC,GAAG,CAAC,EAAE;QACjK,KAAK,EAAE,EAAE,KAAK,EAAE,WAAW,EAAE,MAAM,EAAE,wEAAwE,EAAE,OAAO,EAAE,uBAAuB,EAAE,QAAQ,EAAE,CAAC,SAAS,EAAE,KAAK,CAAC,EAAE;QAC/K,KAAK,EAAE,EAAE,KAAK,EAAE,UAAU,EAAE,MAAM,EAAE,iDAAiD,EAAE,OAAO,EAAE,6BAA6B,EAAE,QAAQ,EAAE,CAAC,GAAG,CAAC,EAAE;QAChJ,IAAI,EAAE,EAAE,KAAK,EAAE,WAAW,EAAE,MAAM,EAAE,2DAA2D,EAAE,OAAO,EAAE,yBAAyB,EAAE,QAAQ,EAAE,CAAC,KAAK,CAAC,EAAE;QACxJ,SAAS,EAAE,EAAE,KAAK,EAAE,WAAW,EAAE,MAAM,EAAE,oEAAoE,EAAE,OAAO,EAAE,mCAAmC,EAAE,QAAQ,EAAE,CAAC,SAAS,CAAC,EAAE;QACpL,MAAM,EAAE,EAAE,KAAK,EAAE,SAAS,EAAE,MAAM,EAAE,kDAAkD,EAAE,OAAO,EAAE,8BAA8B,EAAE,QAAQ,EAAE,CAAC,GAAG,CAAC,EAAE;QAClJ,KAAK,EAAE,EAAE,KAAK,EAAE,SAAS,EAAE,MAAM,EAAE,8EAA8E,EAAE,OAAO,EAAE,iCAAiC,EAAE,QAAQ,EAAE,CAAC,GAAG,CAAC,EAAE;QAChL,OAAO,EAAE,EAAE,KAAK,EAAE,SAAS,EAAE,MAAM,EAAE,mDAAmD,EAAE,OAAO,EAAE,4BAA4B,EAAE,QAAQ,EAAE,CAAC,GAAG,CAAC,EAAE;QAClJ,OAAO,EAAE,EAAE,KAAK,EAAE,SAAS,EAAE,MAAM,EAAE,wBAAwB,EAAE,OAAO,EAAE,wBAAwB,EAAE;QAClG,QAAQ,EAAE,EAAE,KAAK,EAAE,UAAU,EAAE,MAAM,EAAE,8CAA8C,EAAE,OAAO,EAAE,mCAAmC,EAAE;QACrI,OAAO,EAAE,EAAE,KAAK,EAAE,UAAU,EAAE,MAAM,EAAE,wBAAwB,EAAE,OAAO,EAAE,6BAA6B,EAAE;QACxG,KAAK,EAAE,EAAE,KAAK,EAAE,UAAU,EAAE,MAAM,EAAE,gCAAgC,EAAE,OAAO,EAAE,4BAA4B,EAAE;QAC7G,UAAU,EAAE,EAAE,KAAK,EAAE,YAAY,EAAE,MAAM,EAAE,uEAAuE,EAAE,OAAO,EAAE,+BAA+B,EAAE,QAAQ,EAAE,CAAC,OAAO,CAAC,EAAE;QACnL,UAAU,EAAE,EAAE,KAAK,EAAE,YAAY,EAAE,MAAM,EAAE,8CAA8C,EAAE,OAAO,EAAE,wBAAwB,EAAE;QAC9H,IAAI,EAAE,EAAE,KAAK,EAAE,YAAY,EAAE,MAAM,EAAE,kFAAkF,EAAE,OAAO,EAAE,yBAAyB,EAAE,QAAQ,EAAE,CAAC,QAAQ,CAAC,EAAE;QACnL,OAAO,EAAE,EAAE,KAAK,EAAE,YAAY,EAAE,MAAM,EAAE,qFAAqF,EAAE,OAAO,EAAE,oCAAoC,EAAE,QAAQ,EAAE,CAAC,QAAQ,CAAC,EAAE;QACpM,KAAK,EAAE,EAAE,KAAK,EAAE,WAAW,EAAE,MAAM,EAAE,uGAAuG,EAAE,OAAO,EAAE,oCAAoC,EAAE,QAAQ,EAAE,CAAC,QAAQ,CAAC,EAAE;KACpN;IACD,QAAQ,EAAE;QACR,MAAM,EAAE,oBAAoB;QAC5B,KAAK,EAAE,mBAAmB;QAC1B,KAAK,EAAE,mBAAmB;QAC1B,OAAO,EAAE,qBAAqB;QAC9B,KAAK,EAAE,gBAAgB;QACvB,KAAK,EAAE,gBAAgB;QACvB,KAAK,EAAE,gBAAgB;QACvB,SAAS,EAAE,2BAA2B;KACvC;IACD,QAAQ,EAAE;QACR,KAAK,EAAE;YACL,CAAC,wBAAwB,EAAE,+DAA+D,EAAE,+DAA+D,EAAE,0CAA0C,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC;YACnN,CAAC,wBAAwB,EAAE,kCAAkC,EAAE,0BAA0B,EAAE,iEAAiE,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC;YACxK,CAAC,oCAAoC,EAAE,wCAAwC,EAAE,4CAA4C,EAAE,4DAA4D,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC;YACvM,CAAC,qDAAqD,EAAE,0DAA0D,EAAE,4CAA4C,EAAE,qEAAqE,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC;YACnP,CAAC,gBAAgB,EAAE,qDAAqD,EAAE,6DAA6D,EAAE,+DAA+D,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC;YACpN,CAAC,4BAA4B,EAAE,gDAAgD,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC;YAC3F,CAAC,6BAA6B,EAAE,4DAA4D,EAAE,8DAA8D,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC;YACxK,4CAA4C;YAC5C,gCAAgC;YAChC,CAAC,+CAA+C,EAAE,qBAAqB,EAAE,sBAAsB,EAAE,qBAAqB,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC;SACnI;QACD,OAAO,EAAE;YACP,0EAA0E;YAC1E,mEAAmE;YACnE,mFAAmF;YACnF,gFAAgF;YAChF,0EAA0E;YAC1E,sFAAsF;YACtF,6EAA6E;YAC7E,qHAAqH;YACrH,mDAAmD;YACnD,sHAAsH;YACtH,iIAAiI;SAClI;KACF;CACO,CAAC;AAIX,MAAM,UAAU,iBAAiB;IAC/B,OAAO,YAAY,CAAC;AACtB,CAAC;AAED,MAAM,UAAU,qBAAqB;IACnC,OAAO,CAAC,GAAG,mBAAmB,CAAC,CAAC;AAClC,CAAC"}

package/dist/index.d.ts

@@ -1,7 +1,8 @@
+export * from './catalog';
 export * from './types';
 export { parseToonUI, ToonSyntaxError } from './parser';
 export { validateToonUI } from './validator';
 export { extractToonBlocks } from './formatter';
-export { createPrompt, createComponentPrompt, createSyntaxPrompt, createFallbackPrompt, createSafetyPrompt, createExamplesPrompt } from './prompts';
-export { createRules, createToonProtocol, createToonCoreRuntime, formatSubmitMessage, formatReplyMessage, createChatMessage, createChatUIMessage } from './runtime';
+export { createPrompt, createComponentPrompt, createSyntaxPrompt, createFallbackPrompt, createSafetyPrompt, createExamplesPrompt, } from './prompts';
+export { createRules, createToonProtocol, createToonCoreRuntime, } from './runtime';
 //# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,cAAc,SAAS,CAAC;AACxB,OAAO,EAAE,WAAW,EAAE,eAAe,EAAE,MAAM,UAAU,CAAC;AACxD,OAAO,EAAE,cAAc,EAAE,MAAM,aAAa,CAAC;AAC7C,OAAO,EAAE,iBAAiB,EAAE,MAAM,aAAa,CAAC;AAChD,OAAO,EAAE,YAAY,EAAE,qBAAqB,EAAE,kBAAkB,EAAE,oBAAoB,EAAE,kBAAkB,EAAE,oBAAoB,EAAE,MAAM,WAAW,CAAC;AACpJ,OAAO,EAAE,WAAW,EAAE,kBAAkB,EAAE,qBAAqB,EAAE,mBAAmB,EAAE,kBAAkB,EAAE,iBAAiB,EAAE,mBAAmB,EAAE,MAAM,WAAW,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,cAAc,WAAW,CAAC;AAC1B,cAAc,SAAS,CAAC;AACxB,OAAO,EAAE,WAAW,EAAE,eAAe,EAAE,MAAM,UAAU,CAAC;AACxD,OAAO,EAAE,cAAc,EAAE,MAAM,aAAa,CAAC;AAC7C,OAAO,EAAE,iBAAiB,EAAE,MAAM,aAAa,CAAC;AAChD,OAAO,EACL,YAAY,EACZ,qBAAqB,EACrB,kBAAkB,EAClB,oBAAoB,EACpB,kBAAkB,EAClB,oBAAoB,GACrB,MAAM,WAAW,CAAC;AACnB,OAAO,EACL,WAAW,EACX,kBAAkB,EAClB,qBAAqB,GACtB,MAAM,WAAW,CAAC"}

package/dist/index.js

@@ -1,7 +1,8 @@
+export * from './catalog';
 export * from './types';
 export { parseToonUI, ToonSyntaxError } from './parser';
 export { validateToonUI } from './validator';
 export { extractToonBlocks } from './formatter';
-export { createPrompt, createComponentPrompt, createSyntaxPrompt, createFallbackPrompt, createSafetyPrompt, createExamplesPrompt } from './prompts';
-export { createRules, createToonProtocol, createToonCoreRuntime, formatSubmitMessage, formatReplyMessage, createChatMessage, createChatUIMessage } from './runtime';
+export { createPrompt, createComponentPrompt, createSyntaxPrompt, createFallbackPrompt, createSafetyPrompt, createExamplesPrompt, } from './prompts';
+export { createRules, createToonProtocol, createToonCoreRuntime, } from './runtime';
 //# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,cAAc,SAAS,CAAC;AACxB,OAAO,EAAE,WAAW,EAAE,eAAe,EAAE,MAAM,UAAU,CAAC;AACxD,OAAO,EAAE,cAAc,EAAE,MAAM,aAAa,CAAC;AAC7C,OAAO,EAAE,iBAAiB,EAAE,MAAM,aAAa,CAAC;AAChD,OAAO,EAAE,YAAY,EAAE,qBAAqB,EAAE,kBAAkB,EAAE,oBAAoB,EAAE,kBAAkB,EAAE,oBAAoB,EAAE,MAAM,WAAW,CAAC;AACpJ,OAAO,EAAE,WAAW,EAAE,kBAAkB,EAAE,qBAAqB,EAAE,mBAAmB,EAAE,kBAAkB,EAAE,iBAAiB,EAAE,mBAAmB,EAAE,MAAM,WAAW,CAAC"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,cAAc,WAAW,CAAC;AAC1B,cAAc,SAAS,CAAC;AACxB,OAAO,EAAE,WAAW,EAAE,eAAe,EAAE,MAAM,UAAU,CAAC;AACxD,OAAO,EAAE,cAAc,EAAE,MAAM,aAAa,CAAC;AAC7C,OAAO,EAAE,iBAAiB,EAAE,MAAM,aAAa,CAAC;AAChD,OAAO,EACL,YAAY,EACZ,qBAAqB,EACrB,kBAAkB,EAClB,oBAAoB,EACpB,kBAAkB,EAClB,oBAAoB,GACrB,MAAM,WAAW,CAAC;AACnB,OAAO,EACL,WAAW,EACX,kBAAkB,EAClB,qBAAqB,GACtB,MAAM,WAAW,CAAC"}

package/dist/parser.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"parser.d.ts","sourceRoot":"","sources":["../src/parser.ts"],"names":[],"mappings":"AAAA,OAAO,EAmCL,KAAK,YAAY,EACjB,KAAK,aAAa,EAGlB,KAAK,eAAe,EACrB,MAAM,SAAS,CAAC;AAOjB,qBAAa,eAAgB,SAAQ,KAAK;IACxC,IAAI,EAAE,aAAa,CAAC;IACpB,IAAI,EAAE,MAAM,CAAC;IACb,MAAM,EAAE,MAAM,CAAC;gBAEH,KAAK,EAAE,eAAe;CAOnC;AAuaD,wBAAgB,WAAW,CAAC,MAAM,EAAE,MAAM,GAAG,YAAY,CA2BxD"}
+{"version":3,"file":"parser.d.ts","sourceRoot":"","sources":["../src/parser.ts"],"names":[],"mappings":"AACA,OAAO,EAkCL,KAAK,YAAY,EACjB,KAAK,aAAa,EAGlB,KAAK,eAAe,EACrB,MAAM,SAAS,CAAC;AAOjB,qBAAa,eAAgB,SAAQ,KAAK;IACxC,IAAI,EAAE,aAAa,CAAC;IACpB,IAAI,EAAE,MAAM,CAAC;IACb,MAAM,EAAE,MAAM,CAAC;gBAEH,KAAK,EAAE,eAAe;CAOnC;AAuaD,wBAAgB,WAAW,CAAC,MAAM,EAAE,MAAM,GAAG,YAAY,CA2BxD"}

package/dist/parser.js

@@ -1,4 +1,4 @@
-import { OFFICIAL_COMPONENT_KEYS, } from './types';
+import { TOON_COMPONENT_KEYS as OFFICIAL_COMPONENT_KEYS } from './catalog';
 export class ToonSyntaxError extends Error {
     code;
     line;