@alneas/appkit-react 0.1.0 → 0.3.0

package/dist/ai/action/use-screen-context.cjs.map

@@ -1 +1 @@
-{"version":3,"file":"use-screen-context.cjs","names":["useScreenActionRegistry","useRef","require_ai_action_context","react","useScreenContext","registry","key","keyOrOptions","getter","maybeGetter","description","maybeDescription","getterRef","unregister"],"sources":["../../../src/ai/action/use-screen-context.ts"],"sourcesContent":["import { useLayoutEffect, useRef } from 'react';\nimport type { ContextGetter } from \"@alneas/appkit-core/ai\";\nimport { useScreenActionRegistry } from './context';\nimport type { UseScreenContextOptions } from './types';\n\n/**\n * Registers an on-demand context getter on the current screen's ActionRegistry.\n *\n * The getter function automatically captures the latest committed props and state\n * via refs without requiring dependency arrays.\n * The context is automatically unregistered when the component unmounts\n * or when the context key changes.\n */\nexport function useScreenContext<T = unknown>(\n  key: string,\n  getter: ContextGetter<T>,\n  description?: string\n): void;\nexport function useScreenContext<T = unknown>(\n  options: UseScreenContextOptions<T>\n): void;\nexport function useScreenContext<T = unknown>(\n  keyOrOptions: string | UseScreenContextOptions<T>,\n  maybeGetter?: ContextGetter<T>,\n  maybeDescription?: string\n): void {\n  const registry = useScreenActionRegistry();\n\n  const key = typeof keyOrOptions === 'string' ? keyOrOptions : keyOrOptions.key;\n  const getter =\n    typeof keyOrOptions === 'string' ? maybeGetter! : keyOrOptions.getter;\n  const description =\n    typeof keyOrOptions === 'string'\n      ? maybeDescription\n      : keyOrOptions.description;\n\n  const getterRef = useRef(getter);\n  useLayoutEffect(() => {\n    getterRef.current = getter;\n  });\n\n  useLayoutEffect(() => {\n    const wrappedGetter: ContextGetter<T> = () => {\n      return getterRef.current();\n    };\n\n    const unregister = registry.registerContext({\n      key,\n      description,\n      getter: wrappedGetter,\n    });\n\n    return () => {\n      unregister();\n    };\n  }, [registry, key, description]);\n}\n"],"mappings":"A,wIAqBA,SAAgBI,EACd,EACA,EACA,EACM,CACN,IAAMC,EAAWL,EAAAA,wBAAwB,EAEnCM,EAAM,OAAOC,GAAiB,SAAWA,EAAeA,EAAa,IACrEC,EACJ,OAAOD,GAAiB,SAAWE,EAAeF,EAAa,OAC3DG,EACJ,OAAOH,GAAiB,SACpBI,EACAJ,EAAa,YAEbK,GAAA,EAAYX,EAAAA,OAAAA,CAAOO,CAAM,GAC/B,EAAAL,EAAA,gBAAA,KAAsB,CACpB,EAAU,QAAUK,CACtB,CAAC,GAED,EAAAL,EAAA,gBAAA,KAAsB,CAKpB,IAAMU,EAAaR,EAAS,gBAAgB,CAC1C,MACA,cACA,WANOO,EAAU,QAAQ,CAO3B,CAAC,EAED,UAAa,CACXC,EAAW,CACb,CACF,EAAG,CAACR,EAAUC,EAAKI,CAAW,CAAC,CACjC,C"}
+{"version":3,"file":"use-screen-context.cjs","names":["useScreenActionRegistry","useRef","require_ai_action_context","react","useScreenContext","registry","key","keyOrOptions","getter","maybeGetter","description","maybeDescription","getterRef","unregister"],"sources":["../../../src/ai/action/use-screen-context.ts"],"sourcesContent":["import { useLayoutEffect, useRef } from 'react';\nimport type { ContextGetter } from \"@alneas/appkit-core/ai\";\nimport { useScreenActionRegistry } from './context';\nimport type { UseScreenContextOptions } from './types';\n\n/**\n * Registers an on-demand context getter using positional arguments.\n *\n * @typeParam T - Context getter result shape; defaults to unknown.\n *\n * @param key - Stable registry key.\n *\n * @param getter - Pure host getter invoked by registry context reads, using its latest committed version.\n *\n * @param description - Optional human/model-facing description.\n *\n * @returns No value; cleanup unregisters the context.\n *\n * @throws Error without ScreenActionProvider; registry registration failures propagate from the layout effect.\n *\n * @remarks Requires ScreenActionProvider; no styles. Key/description/registry changes\n * re-register the context, while getter changes update a ref after commit.\n * Keep the ref/layout-effect bridge because external registry reads can invoke the\n * getter outside Effect-originated callbacks. useEffectEvent is restricted to Effect\n * logic and cannot replace this on-demand public callback. The bridge preserves the\n * latest committed getter without re-registering; it is not a React 18 compatibility shim.\n *\n * @example\n * ```tsx\n * import { ScreenActionProvider, useScreenContext } from '@alneas/appkit-react/ai/action';\n * function Context() { useScreenContext('selection', () => ({ ids: [] as string[] })); return null; }\n * export function Screen() { return <ScreenActionProvider><Context /></ScreenActionProvider>; }\n * ```\n */\nexport function useScreenContext<T = unknown>(\n  key: string,\n  getter: ContextGetter<T>,\n  description?: string\n): void;\n/**\n * Registers an on-demand context getter using an options object.\n *\n * @typeParam T - Context getter result shape; defaults to unknown.\n *\n * @param options - Stable key, optional description and latest committed getter.\n *\n * @returns No value; cleanup unregisters the context.\n *\n * @throws Error without ScreenActionProvider; registry registration errors propagate from the layout effect.\n *\n * @remarks Requires ScreenActionProvider; no styles. Lifecycle matches the positional overload.\n * The getter remains externally callable through the registry, so its latest committed\n * version is held in a ref rather than an Effect-scoped useEffectEvent callback.\n *\n * @example\n * ```tsx\n * import { ScreenActionProvider, useScreenContext } from '@alneas/appkit-react/ai/action';\n * function Context() { useScreenContext({ key: 'selection', getter: () => ({ ids: [] as string[] }) }); return null; }\n * export function Screen() { return <ScreenActionProvider><Context /></ScreenActionProvider>; }\n * ```\n */\nexport function useScreenContext<T = unknown>(\n  options: UseScreenContextOptions<T>\n): void;\nexport function useScreenContext<T = unknown>(\n  keyOrOptions: string | UseScreenContextOptions<T>,\n  maybeGetter?: ContextGetter<T>,\n  maybeDescription?: string\n): void {\n  const registry = useScreenActionRegistry();\n\n  const key = typeof keyOrOptions === 'string' ? keyOrOptions : keyOrOptions.key;\n  const getter =\n    typeof keyOrOptions === 'string' ? maybeGetter! : keyOrOptions.getter;\n  const description =\n    typeof keyOrOptions === 'string'\n      ? maybeDescription\n      : keyOrOptions.description;\n\n  const getterRef = useRef(getter);\n  useLayoutEffect(() => {\n    getterRef.current = getter;\n  });\n\n  useLayoutEffect(() => {\n    const wrappedGetter: ContextGetter<T> = () => {\n      return getterRef.current();\n    };\n\n    const unregister = registry.registerContext({\n      key,\n      description,\n      getter: wrappedGetter,\n    });\n\n    return () => {\n      unregister();\n    };\n  }, [registry, key, description]);\n}\n"],"mappings":"A,wIAgEA,SAAgBI,EACd,EACA,EACA,EACM,CACN,IAAMC,EAAWL,EAAAA,wBAAwB,EAEnCM,EAAM,OAAOC,GAAiB,SAAWA,EAAeA,EAAa,IACrEC,EACJ,OAAOD,GAAiB,SAAWE,EAAeF,EAAa,OAC3DG,EACJ,OAAOH,GAAiB,SACpBI,EACAJ,EAAa,YAEbK,GAAA,EAAYX,EAAAA,OAAAA,CAAOO,CAAM,GAC/B,EAAAL,EAAA,gBAAA,KAAsB,CACpB,EAAU,QAAUK,CACtB,CAAC,GAED,EAAAL,EAAA,gBAAA,KAAsB,CAKpB,IAAMU,EAAaR,EAAS,gBAAgB,CAC1C,MACA,cACA,WANOO,EAAU,QAAQ,CAO3B,CAAC,EAED,UAAa,CACXC,EAAW,CACb,CACF,EAAG,CAACR,EAAUC,EAAKI,CAAW,CAAC,CACjC,C"}

package/dist/ai/action/use-screen-context.d.cts

@@ -1,12 +1,55 @@
 import { ContextGetter } from '@alneas/appkit-core/ai';
 import { UseScreenContextOptions } from './types.cjs';
 /**
- * Registers an on-demand context getter on the current screen's ActionRegistry.
+ * Registers an on-demand context getter using positional arguments.
  *
- * The getter function automatically captures the latest committed props and state
- * via refs without requiring dependency arrays.
- * The context is automatically unregistered when the component unmounts
- * or when the context key changes.
+ * @typeParam T - Context getter result shape; defaults to unknown.
+ *
+ * @param key - Stable registry key.
+ *
+ * @param getter - Pure host getter invoked by registry context reads, using its latest committed version.
+ *
+ * @param description - Optional human/model-facing description.
+ *
+ * @returns No value; cleanup unregisters the context.
+ *
+ * @throws Error without ScreenActionProvider; registry registration failures propagate from the layout effect.
+ *
+ * @remarks Requires ScreenActionProvider; no styles. Key/description/registry changes
+ * re-register the context, while getter changes update a ref after commit.
+ * Keep the ref/layout-effect bridge because external registry reads can invoke the
+ * getter outside Effect-originated callbacks. useEffectEvent is restricted to Effect
+ * logic and cannot replace this on-demand public callback. The bridge preserves the
+ * latest committed getter without re-registering; it is not a React 18 compatibility shim.
+ *
+ * @example
+ * ```tsx
+ * import { ScreenActionProvider, useScreenContext } from '@alneas/appkit-react/ai/action';
+ * function Context() { useScreenContext('selection', () => ({ ids: [] as string[] })); return null; }
+ * export function Screen() { return <ScreenActionProvider><Context /></ScreenActionProvider>; }
+ * ```
  */
 export declare function useScreenContext<T = unknown>(key: string, getter: ContextGetter<T>, description?: string): void;
+/**
+ * Registers an on-demand context getter using an options object.
+ *
+ * @typeParam T - Context getter result shape; defaults to unknown.
+ *
+ * @param options - Stable key, optional description and latest committed getter.
+ *
+ * @returns No value; cleanup unregisters the context.
+ *
+ * @throws Error without ScreenActionProvider; registry registration errors propagate from the layout effect.
+ *
+ * @remarks Requires ScreenActionProvider; no styles. Lifecycle matches the positional overload.
+ * The getter remains externally callable through the registry, so its latest committed
+ * version is held in a ref rather than an Effect-scoped useEffectEvent callback.
+ *
+ * @example
+ * ```tsx
+ * import { ScreenActionProvider, useScreenContext } from '@alneas/appkit-react/ai/action';
+ * function Context() { useScreenContext({ key: 'selection', getter: () => ({ ids: [] as string[] }) }); return null; }
+ * export function Screen() { return <ScreenActionProvider><Context /></ScreenActionProvider>; }
+ * ```
+ */
 export declare function useScreenContext<T = unknown>(options: UseScreenContextOptions<T>): void;

package/dist/ai/action/use-screen-context.d.ts

@@ -1,12 +1,55 @@
 import { ContextGetter } from '@alneas/appkit-core/ai';
 import { UseScreenContextOptions } from './types.js';
 /**
- * Registers an on-demand context getter on the current screen's ActionRegistry.
+ * Registers an on-demand context getter using positional arguments.
  *
- * The getter function automatically captures the latest committed props and state
- * via refs without requiring dependency arrays.
- * The context is automatically unregistered when the component unmounts
- * or when the context key changes.
+ * @typeParam T - Context getter result shape; defaults to unknown.
+ *
+ * @param key - Stable registry key.
+ *
+ * @param getter - Pure host getter invoked by registry context reads, using its latest committed version.
+ *
+ * @param description - Optional human/model-facing description.
+ *
+ * @returns No value; cleanup unregisters the context.
+ *
+ * @throws Error without ScreenActionProvider; registry registration failures propagate from the layout effect.
+ *
+ * @remarks Requires ScreenActionProvider; no styles. Key/description/registry changes
+ * re-register the context, while getter changes update a ref after commit.
+ * Keep the ref/layout-effect bridge because external registry reads can invoke the
+ * getter outside Effect-originated callbacks. useEffectEvent is restricted to Effect
+ * logic and cannot replace this on-demand public callback. The bridge preserves the
+ * latest committed getter without re-registering; it is not a React 18 compatibility shim.
+ *
+ * @example
+ * ```tsx
+ * import { ScreenActionProvider, useScreenContext } from '@alneas/appkit-react/ai/action';
+ * function Context() { useScreenContext('selection', () => ({ ids: [] as string[] })); return null; }
+ * export function Screen() { return <ScreenActionProvider><Context /></ScreenActionProvider>; }
+ * ```
  */
 export declare function useScreenContext<T = unknown>(key: string, getter: ContextGetter<T>, description?: string): void;
+/**
+ * Registers an on-demand context getter using an options object.
+ *
+ * @typeParam T - Context getter result shape; defaults to unknown.
+ *
+ * @param options - Stable key, optional description and latest committed getter.
+ *
+ * @returns No value; cleanup unregisters the context.
+ *
+ * @throws Error without ScreenActionProvider; registry registration errors propagate from the layout effect.
+ *
+ * @remarks Requires ScreenActionProvider; no styles. Lifecycle matches the positional overload.
+ * The getter remains externally callable through the registry, so its latest committed
+ * version is held in a ref rather than an Effect-scoped useEffectEvent callback.
+ *
+ * @example
+ * ```tsx
+ * import { ScreenActionProvider, useScreenContext } from '@alneas/appkit-react/ai/action';
+ * function Context() { useScreenContext({ key: 'selection', getter: () => ({ ids: [] as string[] }) }); return null; }
+ * export function Screen() { return <ScreenActionProvider><Context /></ScreenActionProvider>; }
+ * ```
+ */
 export declare function useScreenContext<T = unknown>(options: UseScreenContextOptions<T>): void;

package/dist/ai/action/use-screen-context.js.map

@@ -1 +1 @@
-{"version":3,"file":"use-screen-context.js","names":["useScreenContext","registry","useScreenActionRegistry","key","keyOrOptions","getter","maybeGetter","description","maybeDescription","getterRef","useRef","useLayoutEffect","unregister"],"sources":["../../../src/ai/action/use-screen-context.ts"],"sourcesContent":["import { useLayoutEffect, useRef } from 'react';\nimport type { ContextGetter } from \"@alneas/appkit-core/ai\";\nimport { useScreenActionRegistry } from './context';\nimport type { UseScreenContextOptions } from './types';\n\n/**\n * Registers an on-demand context getter on the current screen's ActionRegistry.\n *\n * The getter function automatically captures the latest committed props and state\n * via refs without requiring dependency arrays.\n * The context is automatically unregistered when the component unmounts\n * or when the context key changes.\n */\nexport function useScreenContext<T = unknown>(\n  key: string,\n  getter: ContextGetter<T>,\n  description?: string\n): void;\nexport function useScreenContext<T = unknown>(\n  options: UseScreenContextOptions<T>\n): void;\nexport function useScreenContext<T = unknown>(\n  keyOrOptions: string | UseScreenContextOptions<T>,\n  maybeGetter?: ContextGetter<T>,\n  maybeDescription?: string\n): void {\n  const registry = useScreenActionRegistry();\n\n  const key = typeof keyOrOptions === 'string' ? keyOrOptions : keyOrOptions.key;\n  const getter =\n    typeof keyOrOptions === 'string' ? maybeGetter! : keyOrOptions.getter;\n  const description =\n    typeof keyOrOptions === 'string'\n      ? maybeDescription\n      : keyOrOptions.description;\n\n  const getterRef = useRef(getter);\n  useLayoutEffect(() => {\n    getterRef.current = getter;\n  });\n\n  useLayoutEffect(() => {\n    const wrappedGetter: ContextGetter<T> = () => {\n      return getterRef.current();\n    };\n\n    const unregister = registry.registerContext({\n      key,\n      description,\n      getter: wrappedGetter,\n    });\n\n    return () => {\n      unregister();\n    };\n  }, [registry, key, description]);\n}\n"],"mappings":";;;;AAqBA,SAAgBA,EACd,GACA,GACA,GACM;CACN,IAAMC,IAAWC,EAAwB,GAEnCC,IAAM,OAAOC,KAAiB,WAAWA,IAAeA,EAAa,KACrEC,IACJ,OAAOD,KAAiB,WAAWE,IAAeF,EAAa,QAC3DG,IACJ,OAAOH,KAAiB,WACpBI,IACAJ,EAAa,aAEbK,IAAYC,EAAOL,CAAM;CAK/B,AAJAM,QAAsB;EACpB,EAAU,UAAUN;CACtB,CAAC,GAEDM,QAAsB;EAKpB,IAAMC,IAAaX,EAAS,gBAAgB;GAC1C;GACA;GACA,cANOQ,EAAU,QAAQ;EAO3B,CAAC;EAED,aAAa;GACX,EAAW;EACb;CACF,GAAG;EAACR;EAAUE;EAAKI;CAAW,CAAC;AACjC"}
+{"version":3,"file":"use-screen-context.js","names":["useScreenContext","registry","useScreenActionRegistry","key","keyOrOptions","getter","maybeGetter","description","maybeDescription","getterRef","useRef","useLayoutEffect","unregister"],"sources":["../../../src/ai/action/use-screen-context.ts"],"sourcesContent":["import { useLayoutEffect, useRef } from 'react';\nimport type { ContextGetter } from \"@alneas/appkit-core/ai\";\nimport { useScreenActionRegistry } from './context';\nimport type { UseScreenContextOptions } from './types';\n\n/**\n * Registers an on-demand context getter using positional arguments.\n *\n * @typeParam T - Context getter result shape; defaults to unknown.\n *\n * @param key - Stable registry key.\n *\n * @param getter - Pure host getter invoked by registry context reads, using its latest committed version.\n *\n * @param description - Optional human/model-facing description.\n *\n * @returns No value; cleanup unregisters the context.\n *\n * @throws Error without ScreenActionProvider; registry registration failures propagate from the layout effect.\n *\n * @remarks Requires ScreenActionProvider; no styles. Key/description/registry changes\n * re-register the context, while getter changes update a ref after commit.\n * Keep the ref/layout-effect bridge because external registry reads can invoke the\n * getter outside Effect-originated callbacks. useEffectEvent is restricted to Effect\n * logic and cannot replace this on-demand public callback. The bridge preserves the\n * latest committed getter without re-registering; it is not a React 18 compatibility shim.\n *\n * @example\n * ```tsx\n * import { ScreenActionProvider, useScreenContext } from '@alneas/appkit-react/ai/action';\n * function Context() { useScreenContext('selection', () => ({ ids: [] as string[] })); return null; }\n * export function Screen() { return <ScreenActionProvider><Context /></ScreenActionProvider>; }\n * ```\n */\nexport function useScreenContext<T = unknown>(\n  key: string,\n  getter: ContextGetter<T>,\n  description?: string\n): void;\n/**\n * Registers an on-demand context getter using an options object.\n *\n * @typeParam T - Context getter result shape; defaults to unknown.\n *\n * @param options - Stable key, optional description and latest committed getter.\n *\n * @returns No value; cleanup unregisters the context.\n *\n * @throws Error without ScreenActionProvider; registry registration errors propagate from the layout effect.\n *\n * @remarks Requires ScreenActionProvider; no styles. Lifecycle matches the positional overload.\n * The getter remains externally callable through the registry, so its latest committed\n * version is held in a ref rather than an Effect-scoped useEffectEvent callback.\n *\n * @example\n * ```tsx\n * import { ScreenActionProvider, useScreenContext } from '@alneas/appkit-react/ai/action';\n * function Context() { useScreenContext({ key: 'selection', getter: () => ({ ids: [] as string[] }) }); return null; }\n * export function Screen() { return <ScreenActionProvider><Context /></ScreenActionProvider>; }\n * ```\n */\nexport function useScreenContext<T = unknown>(\n  options: UseScreenContextOptions<T>\n): void;\nexport function useScreenContext<T = unknown>(\n  keyOrOptions: string | UseScreenContextOptions<T>,\n  maybeGetter?: ContextGetter<T>,\n  maybeDescription?: string\n): void {\n  const registry = useScreenActionRegistry();\n\n  const key = typeof keyOrOptions === 'string' ? keyOrOptions : keyOrOptions.key;\n  const getter =\n    typeof keyOrOptions === 'string' ? maybeGetter! : keyOrOptions.getter;\n  const description =\n    typeof keyOrOptions === 'string'\n      ? maybeDescription\n      : keyOrOptions.description;\n\n  const getterRef = useRef(getter);\n  useLayoutEffect(() => {\n    getterRef.current = getter;\n  });\n\n  useLayoutEffect(() => {\n    const wrappedGetter: ContextGetter<T> = () => {\n      return getterRef.current();\n    };\n\n    const unregister = registry.registerContext({\n      key,\n      description,\n      getter: wrappedGetter,\n    });\n\n    return () => {\n      unregister();\n    };\n  }, [registry, key, description]);\n}\n"],"mappings":";;;;AAgEA,SAAgBA,EACd,GACA,GACA,GACM;CACN,IAAMC,IAAWC,EAAwB,GAEnCC,IAAM,OAAOC,KAAiB,WAAWA,IAAeA,EAAa,KACrEC,IACJ,OAAOD,KAAiB,WAAWE,IAAeF,EAAa,QAC3DG,IACJ,OAAOH,KAAiB,WACpBI,IACAJ,EAAa,aAEbK,IAAYC,EAAOL,CAAM;CAK/B,AAJAM,QAAsB;EACpB,EAAU,UAAUN;CACtB,CAAC,GAEDM,QAAsB;EAKpB,IAAMC,IAAaX,EAAS,gBAAgB;GAC1C;GACA;GACA,cANOQ,EAAU,QAAQ;EAO3B,CAAC;EAED,aAAa;GACX,EAAW;EACb;CACF,GAAG;EAACR;EAAUE;EAAKI;CAAW,CAAC;AACjC"}

package/dist/ai/ai-chat/transport.cjs.map

@@ -1 +1 @@
-{"version":3,"file":"transport.cjs","names":["normalizeAIChatMessages","createAIChatStream","_alneas_appkit_core_ai","toAIChatMessages","converted","messages","parts","part","message","value","name","createAIChatTransport","reader","adapter","options","body","chatId","abortSignal","chunks","textStarted","next","event","iterator","closed","output","error","reason"],"sources":["../../../src/ai/ai-chat/transport.ts"],"sourcesContent":["import type { ChatTransport, UIMessage, UIMessageChunk } from 'ai' with { 'resolution-mode': 'import' };\nimport { createAIChatStream, normalizeAIChatMessages, type AIChatAdapter, type AIChatMessage,\n  type AIChatPart, type AIChatRequest } from \"@alneas/appkit-core/ai\";\nimport type { ActionToolObject, ActionToolValue } from \"@alneas/appkit-core/ai\";\n\n/**\n * SDK 7 UIMessage -> provider-neutral history. Incomplete tool inputs and UI-only\n * reasoning/source/step parts are omitted. Completed tool calls/results, errors,\n * files, persistent data parts and metadata are preserved without executing tools.\n * The common JSON/history boundary is owned by ai-core, not this SDK binding.\n */\nexport function toAIChatMessages(messages: readonly UIMessage[]): AIChatMessage[] {\n  const converted = messages.map(message => {\n    const parts: AIChatPart[] = [];\n    for (const part of message.parts) {\n      if (part.type === 'text') parts.push({ type: 'text', text: part.text });\n      else if (part.type === 'file') parts.push({ type: 'file', url: part.url, mediaType: part.mediaType, ...(part.filename ? { filename: part.filename } : {}) });\n      else if (part.type.startsWith('data-') && 'data' in part) parts.push({ type: 'data', name: part.type.slice(5), data: part.data as ActionToolValue, ...('id' in part && typeof part.id === 'string' ? { id: part.id } : {}) });\n      else if (part.type === 'dynamic-tool' || part.type.startsWith('tool-')) {\n        const value = part as unknown as Record<string, unknown>;\n        if (value.state === 'input-streaming' || value.input === undefined) continue;\n        const name = part.type === 'dynamic-tool' ? value.toolName : part.type.slice(5);\n        if (typeof name !== 'string' || !name || typeof value.toolCallId !== 'string' || !value.toolCallId) throw new Error('Invalid SDK tool identity');\n        parts.push({ type: 'tool-call', name, callId: value.toolCallId, input: value.input as ActionToolObject });\n        if (value.state === 'output-available') parts.push({ type: 'tool-result', name, callId: value.toolCallId, output: value.output as ActionToolValue });\n        if (value.state === 'output-error') parts.push({ type: 'tool-result', name, callId: value.toolCallId, output: { error: typeof value.errorText === 'string' ? value.errorText : 'Tool failed' }, isError: true });\n      }\n    }\n    return { id: message.id, role: message.role, parts, ...(message.metadata !== undefined ? { metadata: message.metadata as ActionToolValue } : {}) };\n  });\n  return normalizeAIChatMessages(converted);\n}\n\n/**\n * SDK 7 ChatTransport binding. Install the optional ai peer for its declarations.\n * Network/lifecycle validation lives in ai-core. Cancellation reaches pending reads;\n * resumption is unsupported and tool execution stays explicit application work.\n * Nothing in this entry imports a provider SDK or browser persistence at runtime.\n */\nexport function createAIChatTransport(adapter: AIChatAdapter, options: Pick<AIChatRequest, 'tools' | 'parameters'> = {}): ChatTransport<UIMessage> {\n  return {\n    async sendMessages({ messages, abortSignal, chatId, body, trigger, messageId }) {\n      const reader = createAIChatStream(adapter, { messages: toAIChatMessages(messages), tools: options.tools,\n        parameters: { ...options.parameters, ...body } as ActionToolObject, conversationId: chatId, trigger, messageId, signal: abortSignal }).getReader();\n      async function* chunks(): AsyncGenerator<UIMessageChunk> {\n        let textStarted = false;\n        try {\n          yield { type: 'start' };\n          while (true) {\n            const next = await reader.read();\n            if (next.done) return;\n            const event = next.value;\n            if (event.type === 'text-delta') {\n              if (!textStarted) { textStarted = true; yield { type: 'text-start', id: 'answer-text' }; }\n              yield { type: 'text-delta', id: 'answer-text', delta: event.text };\n            } else if (event.type === 'tool-call') yield { type: 'tool-input-available', toolCallId: event.callId, toolName: event.name, input: event.input, dynamic: true };\n            else if (event.type === 'tool-result') yield event.isError ? { type: 'tool-output-error', toolCallId: event.callId, errorText: 'Tool execution failed', dynamic: true } : { type: 'tool-output-available', toolCallId: event.callId, output: event.output, dynamic: true };\n            else if (event.type === 'data') yield { type: `data-${event.name}`, data: event.data, ...(event.id ? { id: event.id } : {}) };\n            else if (event.type === 'metadata') yield { type: 'message-metadata', messageMetadata: event.metadata };\n            else if (event.type === 'finish') {\n              if (textStarted) yield { type: 'text-end', id: 'answer-text' };\n              yield { type: 'finish', finishReason: event.reason };\n            }\n          }\n        } finally { await reader.cancel().catch(() => {}); reader.releaseLock(); }\n      }\n      const iterator = chunks();\n      let closed = false;\n      return new ReadableStream<UIMessageChunk>({\n        async pull(output) {\n          try {\n            const next = await iterator.next();\n            if (closed) return;\n            if (next.done) { closed = true; output.close(); } else output.enqueue(next.value);\n          } catch (error) { if (!closed) { closed = true; output.error(error); } }\n        },\n        async cancel(reason) {\n          closed = true;\n          await reader.cancel(reason).catch(() => {});\n          await iterator.return(undefined);\n          // Returning before the generator starts never runs its finally block.\n          try { reader.releaseLock(); } catch { /* A generator finally may already have released it. */ }\n        },\n      });\n    },\n    async reconnectToStream() { return null; },\n  };\n}\n"],"mappings":"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"}
+{"version":3,"file":"transport.cjs","names":["normalizeAIChatMessages","createAIChatStream","_alneas_appkit_core_ai","toAIChatMessages","converted","messages","parts","part","message","value","name","createAIChatTransport","reader","adapter","options","body","chatId","abortSignal","chunks","textStarted","next","event","iterator","closed","output","error","reason"],"sources":["../../../src/ai/ai-chat/transport.ts"],"sourcesContent":["// biome-ignore syntax/correctness/noTypeOnlyImportAttributes: TypeScript resolution-mode selects ESM peer declarations under NodeNext.\nimport type { ChatTransport, UIMessage, UIMessageChunk } from 'ai' with { 'resolution-mode': 'import' };\nimport { createAIChatStream, normalizeAIChatMessages, type AIChatAdapter, type AIChatMessage,\n  type AIChatPart, type AIChatRequest } from \"@alneas/appkit-core/ai\";\nimport type { ActionToolObject, ActionToolValue } from \"@alneas/appkit-core/ai\";\n\n/**\n * Converts AI SDK 7 UI messages into normalized provider-neutral chat history.\n *\n * @param messages - SDK UI messages; incomplete tool inputs and UI-only reasoning/source/step parts are omitted.\n *\n * @returns New normalized history preserving supported text, files, tool calls/results, data and metadata.\n *\n * @throws Error for invalid tool identities or data rejected by Core history normalization.\n *\n * @remarks Requires the optional ai peer for types. Does not execute tools, call a model,\n * or create persistence. No React provider or CSS is required.\n *\n * @example\n * ```ts\n * import { toAIChatMessages } from '@alneas/appkit-react/ai/ai-chat';\n * const history = toAIChatMessages([{ id: 'user-1', role: 'user', parts: [{ type: 'text', text: 'Hello' }] }]);\n * ```\n */\nexport function toAIChatMessages(messages: readonly UIMessage[]): AIChatMessage[] {\n  const converted = messages.map(message => {\n    const parts: AIChatPart[] = [];\n    for (const part of message.parts) {\n      if (part.type === 'text') parts.push({ type: 'text', text: part.text });\n      else if (part.type === 'file') parts.push({ type: 'file', url: part.url, mediaType: part.mediaType, ...(part.filename ? { filename: part.filename } : {}) });\n      else if (part.type.startsWith('data-') && 'data' in part) parts.push({ type: 'data', name: part.type.slice(5), data: part.data as ActionToolValue, ...('id' in part && typeof part.id === 'string' ? { id: part.id } : {}) });\n      else if (part.type === 'dynamic-tool' || part.type.startsWith('tool-')) {\n        const value = part as unknown as Record<string, unknown>;\n        if (value.state === 'input-streaming' || value.input === undefined) continue;\n        const name = part.type === 'dynamic-tool' ? value.toolName : part.type.slice(5);\n        if (typeof name !== 'string' || !name || typeof value.toolCallId !== 'string' || !value.toolCallId) throw new Error('Invalid SDK tool identity');\n        parts.push({ type: 'tool-call', name, callId: value.toolCallId, input: value.input as ActionToolObject });\n        if (value.state === 'output-available') parts.push({ type: 'tool-result', name, callId: value.toolCallId, output: value.output as ActionToolValue });\n        if (value.state === 'output-error') parts.push({ type: 'tool-result', name, callId: value.toolCallId, output: { error: typeof value.errorText === 'string' ? value.errorText : 'Tool failed' }, isError: true });\n      }\n    }\n    return { id: message.id, role: message.role, parts, ...(message.metadata !== undefined ? { metadata: message.metadata as ActionToolValue } : {}) };\n  });\n  return normalizeAIChatMessages(converted);\n}\n\n/**\n * Binds a provider-neutral adapter to the AI SDK 7 ChatTransport interface.\n *\n * @param adapter - Host-configured chat adapter that owns provider calls and credentials.\n *\n * @param options - Optional tools and parameters forwarded to Core; request body fields override parameters.\n *\n * @returns Transport emitting SDK chunks; reconnectToStream resolves null because resumption is unsupported.\n *\n * @remarks Install optional ai peer for declarations. Sending messages creates a Core\n * stream; pending-read cancellation reaches it and readers are released on completion,\n * error or cancel. Tools are represented as data and never executed by this binding.\n * Request/conversion/adapter failures surface through sendMessages rejection or stream\n * errors. No provider SDK, React context, CSS or persistence is created here.\n *\n * @example\n * ```ts\n * import { createAIChatTransport, type AIChatAdapter } from '@alneas/appkit-react/ai/ai-chat';\n * export function transportFor(adapter: AIChatAdapter) { return createAIChatTransport(adapter); }\n * ```\n */\nexport function createAIChatTransport(adapter: AIChatAdapter, options: Pick<AIChatRequest, 'tools' | 'parameters'> = {}): ChatTransport<UIMessage> {\n  return {\n    async sendMessages({ messages, abortSignal, chatId, body, trigger, messageId }) {\n      const reader = createAIChatStream(adapter, { messages: toAIChatMessages(messages), tools: options.tools,\n        parameters: { ...options.parameters, ...body } as ActionToolObject, conversationId: chatId, trigger, messageId, signal: abortSignal }).getReader();\n      async function* chunks(): AsyncGenerator<UIMessageChunk> {\n        let textStarted = false;\n        try {\n          yield { type: 'start' };\n          while (true) {\n            const next = await reader.read();\n            if (next.done) return;\n            const event = next.value;\n            if (event.type === 'text-delta') {\n              if (!textStarted) { textStarted = true; yield { type: 'text-start', id: 'answer-text' }; }\n              yield { type: 'text-delta', id: 'answer-text', delta: event.text };\n            } else if (event.type === 'tool-call') yield { type: 'tool-input-available', toolCallId: event.callId, toolName: event.name, input: event.input, dynamic: true };\n            else if (event.type === 'tool-result') yield event.isError ? { type: 'tool-output-error', toolCallId: event.callId, errorText: 'Tool execution failed', dynamic: true } : { type: 'tool-output-available', toolCallId: event.callId, output: event.output, dynamic: true };\n            else if (event.type === 'data') yield { type: `data-${event.name}`, data: event.data, ...(event.id ? { id: event.id } : {}) };\n            else if (event.type === 'metadata') yield { type: 'message-metadata', messageMetadata: event.metadata };\n            else if (event.type === 'finish') {\n              if (textStarted) yield { type: 'text-end', id: 'answer-text' };\n              yield { type: 'finish', finishReason: event.reason };\n            }\n          }\n        } finally { await reader.cancel().catch(() => {}); reader.releaseLock(); }\n      }\n      const iterator = chunks();\n      let closed = false;\n      return new ReadableStream<UIMessageChunk>({\n        async pull(output) {\n          try {\n            const next = await iterator.next();\n            if (closed) return;\n            if (next.done) { closed = true; output.close(); } else output.enqueue(next.value);\n          } catch (error) { if (!closed) { closed = true; output.error(error); } }\n        },\n        async cancel(reason) {\n          closed = true;\n          await reader.cancel(reason).catch(() => {});\n          await iterator.return(undefined);\n          // Returning before the generator starts never runs its finally block.\n          try { reader.releaseLock(); } catch { /* A generator finally may already have released it. */ }\n        },\n      });\n    },\n    async reconnectToStream() { return null; },\n  };\n}\n"],"mappings":"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"}

package/dist/ai/ai-chat/transport.d.cts

@@ -1,16 +1,43 @@
 import { ChatTransport, UIMessage } from 'ai';
 import { AIChatAdapter, AIChatMessage, AIChatRequest } from '@alneas/appkit-core/ai';
 /**
- * SDK 7 UIMessage -> provider-neutral history. Incomplete tool inputs and UI-only
- * reasoning/source/step parts are omitted. Completed tool calls/results, errors,
- * files, persistent data parts and metadata are preserved without executing tools.
- * The common JSON/history boundary is owned by ai-core, not this SDK binding.
+ * Converts AI SDK 7 UI messages into normalized provider-neutral chat history.
+ *
+ * @param messages - SDK UI messages; incomplete tool inputs and UI-only reasoning/source/step parts are omitted.
+ *
+ * @returns New normalized history preserving supported text, files, tool calls/results, data and metadata.
+ *
+ * @throws Error for invalid tool identities or data rejected by Core history normalization.
+ *
+ * @remarks Requires the optional ai peer for types. Does not execute tools, call a model,
+ * or create persistence. No React provider or CSS is required.
+ *
+ * @example
+ * ```ts
+ * import { toAIChatMessages } from '@alneas/appkit-react/ai/ai-chat';
+ * const history = toAIChatMessages([{ id: 'user-1', role: 'user', parts: [{ type: 'text', text: 'Hello' }] }]);
+ * ```
  */
 export declare function toAIChatMessages(messages: readonly UIMessage[]): AIChatMessage[];
 /**
- * SDK 7 ChatTransport binding. Install the optional ai peer for its declarations.
- * Network/lifecycle validation lives in ai-core. Cancellation reaches pending reads;
- * resumption is unsupported and tool execution stays explicit application work.
- * Nothing in this entry imports a provider SDK or browser persistence at runtime.
+ * Binds a provider-neutral adapter to the AI SDK 7 ChatTransport interface.
+ *
+ * @param adapter - Host-configured chat adapter that owns provider calls and credentials.
+ *
+ * @param options - Optional tools and parameters forwarded to Core; request body fields override parameters.
+ *
+ * @returns Transport emitting SDK chunks; reconnectToStream resolves null because resumption is unsupported.
+ *
+ * @remarks Install optional ai peer for declarations. Sending messages creates a Core
+ * stream; pending-read cancellation reaches it and readers are released on completion,
+ * error or cancel. Tools are represented as data and never executed by this binding.
+ * Request/conversion/adapter failures surface through sendMessages rejection or stream
+ * errors. No provider SDK, React context, CSS or persistence is created here.
+ *
+ * @example
+ * ```ts
+ * import { createAIChatTransport, type AIChatAdapter } from '@alneas/appkit-react/ai/ai-chat';
+ * export function transportFor(adapter: AIChatAdapter) { return createAIChatTransport(adapter); }
+ * ```
  */
 export declare function createAIChatTransport(adapter: AIChatAdapter, options?: Pick<AIChatRequest, 'tools' | 'parameters'>): ChatTransport<UIMessage>;

package/dist/ai/ai-chat/transport.d.ts

@@ -1,16 +1,43 @@
 import { ChatTransport, UIMessage } from 'ai';
 import { AIChatAdapter, AIChatMessage, AIChatRequest } from '@alneas/appkit-core/ai';
 /**
- * SDK 7 UIMessage -> provider-neutral history. Incomplete tool inputs and UI-only
- * reasoning/source/step parts are omitted. Completed tool calls/results, errors,
- * files, persistent data parts and metadata are preserved without executing tools.
- * The common JSON/history boundary is owned by ai-core, not this SDK binding.
+ * Converts AI SDK 7 UI messages into normalized provider-neutral chat history.
+ *
+ * @param messages - SDK UI messages; incomplete tool inputs and UI-only reasoning/source/step parts are omitted.
+ *
+ * @returns New normalized history preserving supported text, files, tool calls/results, data and metadata.
+ *
+ * @throws Error for invalid tool identities or data rejected by Core history normalization.
+ *
+ * @remarks Requires the optional ai peer for types. Does not execute tools, call a model,
+ * or create persistence. No React provider or CSS is required.
+ *
+ * @example
+ * ```ts
+ * import { toAIChatMessages } from '@alneas/appkit-react/ai/ai-chat';
+ * const history = toAIChatMessages([{ id: 'user-1', role: 'user', parts: [{ type: 'text', text: 'Hello' }] }]);
+ * ```
  */
 export declare function toAIChatMessages(messages: readonly UIMessage[]): AIChatMessage[];
 /**
- * SDK 7 ChatTransport binding. Install the optional ai peer for its declarations.
- * Network/lifecycle validation lives in ai-core. Cancellation reaches pending reads;
- * resumption is unsupported and tool execution stays explicit application work.
- * Nothing in this entry imports a provider SDK or browser persistence at runtime.
+ * Binds a provider-neutral adapter to the AI SDK 7 ChatTransport interface.
+ *
+ * @param adapter - Host-configured chat adapter that owns provider calls and credentials.
+ *
+ * @param options - Optional tools and parameters forwarded to Core; request body fields override parameters.
+ *
+ * @returns Transport emitting SDK chunks; reconnectToStream resolves null because resumption is unsupported.
+ *
+ * @remarks Install optional ai peer for declarations. Sending messages creates a Core
+ * stream; pending-read cancellation reaches it and readers are released on completion,
+ * error or cancel. Tools are represented as data and never executed by this binding.
+ * Request/conversion/adapter failures surface through sendMessages rejection or stream
+ * errors. No provider SDK, React context, CSS or persistence is created here.
+ *
+ * @example
+ * ```ts
+ * import { createAIChatTransport, type AIChatAdapter } from '@alneas/appkit-react/ai/ai-chat';
+ * export function transportFor(adapter: AIChatAdapter) { return createAIChatTransport(adapter); }
+ * ```
  */
 export declare function createAIChatTransport(adapter: AIChatAdapter, options?: Pick<AIChatRequest, 'tools' | 'parameters'>): ChatTransport<UIMessage>;

package/dist/ai/ai-chat/transport.js.map

@@ -1 +1 @@
-{"version":3,"file":"transport.js","names":["toAIChatMessages","converted","messages","parts","part","message","value","name","normalizeAIChatMessages","createAIChatTransport","reader","createAIChatStream","adapter","options","body","chatId","abortSignal","chunks","textStarted","next","event","iterator","closed","output","error","reason"],"sources":["../../../src/ai/ai-chat/transport.ts"],"sourcesContent":["import type { ChatTransport, UIMessage, UIMessageChunk } from 'ai' with { 'resolution-mode': 'import' };\nimport { createAIChatStream, normalizeAIChatMessages, type AIChatAdapter, type AIChatMessage,\n  type AIChatPart, type AIChatRequest } from \"@alneas/appkit-core/ai\";\nimport type { ActionToolObject, ActionToolValue } from \"@alneas/appkit-core/ai\";\n\n/**\n * SDK 7 UIMessage -> provider-neutral history. Incomplete tool inputs and UI-only\n * reasoning/source/step parts are omitted. Completed tool calls/results, errors,\n * files, persistent data parts and metadata are preserved without executing tools.\n * The common JSON/history boundary is owned by ai-core, not this SDK binding.\n */\nexport function toAIChatMessages(messages: readonly UIMessage[]): AIChatMessage[] {\n  const converted = messages.map(message => {\n    const parts: AIChatPart[] = [];\n    for (const part of message.parts) {\n      if (part.type === 'text') parts.push({ type: 'text', text: part.text });\n      else if (part.type === 'file') parts.push({ type: 'file', url: part.url, mediaType: part.mediaType, ...(part.filename ? { filename: part.filename } : {}) });\n      else if (part.type.startsWith('data-') && 'data' in part) parts.push({ type: 'data', name: part.type.slice(5), data: part.data as ActionToolValue, ...('id' in part && typeof part.id === 'string' ? { id: part.id } : {}) });\n      else if (part.type === 'dynamic-tool' || part.type.startsWith('tool-')) {\n        const value = part as unknown as Record<string, unknown>;\n        if (value.state === 'input-streaming' || value.input === undefined) continue;\n        const name = part.type === 'dynamic-tool' ? value.toolName : part.type.slice(5);\n        if (typeof name !== 'string' || !name || typeof value.toolCallId !== 'string' || !value.toolCallId) throw new Error('Invalid SDK tool identity');\n        parts.push({ type: 'tool-call', name, callId: value.toolCallId, input: value.input as ActionToolObject });\n        if (value.state === 'output-available') parts.push({ type: 'tool-result', name, callId: value.toolCallId, output: value.output as ActionToolValue });\n        if (value.state === 'output-error') parts.push({ type: 'tool-result', name, callId: value.toolCallId, output: { error: typeof value.errorText === 'string' ? value.errorText : 'Tool failed' }, isError: true });\n      }\n    }\n    return { id: message.id, role: message.role, parts, ...(message.metadata !== undefined ? { metadata: message.metadata as ActionToolValue } : {}) };\n  });\n  return normalizeAIChatMessages(converted);\n}\n\n/**\n * SDK 7 ChatTransport binding. Install the optional ai peer for its declarations.\n * Network/lifecycle validation lives in ai-core. Cancellation reaches pending reads;\n * resumption is unsupported and tool execution stays explicit application work.\n * Nothing in this entry imports a provider SDK or browser persistence at runtime.\n */\nexport function createAIChatTransport(adapter: AIChatAdapter, options: Pick<AIChatRequest, 'tools' | 'parameters'> = {}): ChatTransport<UIMessage> {\n  return {\n    async sendMessages({ messages, abortSignal, chatId, body, trigger, messageId }) {\n      const reader = createAIChatStream(adapter, { messages: toAIChatMessages(messages), tools: options.tools,\n        parameters: { ...options.parameters, ...body } as ActionToolObject, conversationId: chatId, trigger, messageId, signal: abortSignal }).getReader();\n      async function* chunks(): AsyncGenerator<UIMessageChunk> {\n        let textStarted = false;\n        try {\n          yield { type: 'start' };\n          while (true) {\n            const next = await reader.read();\n            if (next.done) return;\n            const event = next.value;\n            if (event.type === 'text-delta') {\n              if (!textStarted) { textStarted = true; yield { type: 'text-start', id: 'answer-text' }; }\n              yield { type: 'text-delta', id: 'answer-text', delta: event.text };\n            } else if (event.type === 'tool-call') yield { type: 'tool-input-available', toolCallId: event.callId, toolName: event.name, input: event.input, dynamic: true };\n            else if (event.type === 'tool-result') yield event.isError ? { type: 'tool-output-error', toolCallId: event.callId, errorText: 'Tool execution failed', dynamic: true } : { type: 'tool-output-available', toolCallId: event.callId, output: event.output, dynamic: true };\n            else if (event.type === 'data') yield { type: `data-${event.name}`, data: event.data, ...(event.id ? { id: event.id } : {}) };\n            else if (event.type === 'metadata') yield { type: 'message-metadata', messageMetadata: event.metadata };\n            else if (event.type === 'finish') {\n              if (textStarted) yield { type: 'text-end', id: 'answer-text' };\n              yield { type: 'finish', finishReason: event.reason };\n            }\n          }\n        } finally { await reader.cancel().catch(() => {}); reader.releaseLock(); }\n      }\n      const iterator = chunks();\n      let closed = false;\n      return new ReadableStream<UIMessageChunk>({\n        async pull(output) {\n          try {\n            const next = await iterator.next();\n            if (closed) return;\n            if (next.done) { closed = true; output.close(); } else output.enqueue(next.value);\n          } catch (error) { if (!closed) { closed = true; output.error(error); } }\n        },\n        async cancel(reason) {\n          closed = true;\n          await reader.cancel(reason).catch(() => {});\n          await iterator.return(undefined);\n          // Returning before the generator starts never runs its finally block.\n          try { reader.releaseLock(); } catch { /* A generator finally may already have released it. */ }\n        },\n      });\n    },\n    async reconnectToStream() { return null; },\n  };\n}\n"],"mappings":"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"}
+{"version":3,"file":"transport.js","names":["toAIChatMessages","converted","messages","parts","part","message","value","name","normalizeAIChatMessages","createAIChatTransport","reader","createAIChatStream","adapter","options","body","chatId","abortSignal","chunks","textStarted","next","event","iterator","closed","output","error","reason"],"sources":["../../../src/ai/ai-chat/transport.ts"],"sourcesContent":["// biome-ignore syntax/correctness/noTypeOnlyImportAttributes: TypeScript resolution-mode selects ESM peer declarations under NodeNext.\nimport type { ChatTransport, UIMessage, UIMessageChunk } from 'ai' with { 'resolution-mode': 'import' };\nimport { createAIChatStream, normalizeAIChatMessages, type AIChatAdapter, type AIChatMessage,\n  type AIChatPart, type AIChatRequest } from \"@alneas/appkit-core/ai\";\nimport type { ActionToolObject, ActionToolValue } from \"@alneas/appkit-core/ai\";\n\n/**\n * Converts AI SDK 7 UI messages into normalized provider-neutral chat history.\n *\n * @param messages - SDK UI messages; incomplete tool inputs and UI-only reasoning/source/step parts are omitted.\n *\n * @returns New normalized history preserving supported text, files, tool calls/results, data and metadata.\n *\n * @throws Error for invalid tool identities or data rejected by Core history normalization.\n *\n * @remarks Requires the optional ai peer for types. Does not execute tools, call a model,\n * or create persistence. No React provider or CSS is required.\n *\n * @example\n * ```ts\n * import { toAIChatMessages } from '@alneas/appkit-react/ai/ai-chat';\n * const history = toAIChatMessages([{ id: 'user-1', role: 'user', parts: [{ type: 'text', text: 'Hello' }] }]);\n * ```\n */\nexport function toAIChatMessages(messages: readonly UIMessage[]): AIChatMessage[] {\n  const converted = messages.map(message => {\n    const parts: AIChatPart[] = [];\n    for (const part of message.parts) {\n      if (part.type === 'text') parts.push({ type: 'text', text: part.text });\n      else if (part.type === 'file') parts.push({ type: 'file', url: part.url, mediaType: part.mediaType, ...(part.filename ? { filename: part.filename } : {}) });\n      else if (part.type.startsWith('data-') && 'data' in part) parts.push({ type: 'data', name: part.type.slice(5), data: part.data as ActionToolValue, ...('id' in part && typeof part.id === 'string' ? { id: part.id } : {}) });\n      else if (part.type === 'dynamic-tool' || part.type.startsWith('tool-')) {\n        const value = part as unknown as Record<string, unknown>;\n        if (value.state === 'input-streaming' || value.input === undefined) continue;\n        const name = part.type === 'dynamic-tool' ? value.toolName : part.type.slice(5);\n        if (typeof name !== 'string' || !name || typeof value.toolCallId !== 'string' || !value.toolCallId) throw new Error('Invalid SDK tool identity');\n        parts.push({ type: 'tool-call', name, callId: value.toolCallId, input: value.input as ActionToolObject });\n        if (value.state === 'output-available') parts.push({ type: 'tool-result', name, callId: value.toolCallId, output: value.output as ActionToolValue });\n        if (value.state === 'output-error') parts.push({ type: 'tool-result', name, callId: value.toolCallId, output: { error: typeof value.errorText === 'string' ? value.errorText : 'Tool failed' }, isError: true });\n      }\n    }\n    return { id: message.id, role: message.role, parts, ...(message.metadata !== undefined ? { metadata: message.metadata as ActionToolValue } : {}) };\n  });\n  return normalizeAIChatMessages(converted);\n}\n\n/**\n * Binds a provider-neutral adapter to the AI SDK 7 ChatTransport interface.\n *\n * @param adapter - Host-configured chat adapter that owns provider calls and credentials.\n *\n * @param options - Optional tools and parameters forwarded to Core; request body fields override parameters.\n *\n * @returns Transport emitting SDK chunks; reconnectToStream resolves null because resumption is unsupported.\n *\n * @remarks Install optional ai peer for declarations. Sending messages creates a Core\n * stream; pending-read cancellation reaches it and readers are released on completion,\n * error or cancel. Tools are represented as data and never executed by this binding.\n * Request/conversion/adapter failures surface through sendMessages rejection or stream\n * errors. No provider SDK, React context, CSS or persistence is created here.\n *\n * @example\n * ```ts\n * import { createAIChatTransport, type AIChatAdapter } from '@alneas/appkit-react/ai/ai-chat';\n * export function transportFor(adapter: AIChatAdapter) { return createAIChatTransport(adapter); }\n * ```\n */\nexport function createAIChatTransport(adapter: AIChatAdapter, options: Pick<AIChatRequest, 'tools' | 'parameters'> = {}): ChatTransport<UIMessage> {\n  return {\n    async sendMessages({ messages, abortSignal, chatId, body, trigger, messageId }) {\n      const reader = createAIChatStream(adapter, { messages: toAIChatMessages(messages), tools: options.tools,\n        parameters: { ...options.parameters, ...body } as ActionToolObject, conversationId: chatId, trigger, messageId, signal: abortSignal }).getReader();\n      async function* chunks(): AsyncGenerator<UIMessageChunk> {\n        let textStarted = false;\n        try {\n          yield { type: 'start' };\n          while (true) {\n            const next = await reader.read();\n            if (next.done) return;\n            const event = next.value;\n            if (event.type === 'text-delta') {\n              if (!textStarted) { textStarted = true; yield { type: 'text-start', id: 'answer-text' }; }\n              yield { type: 'text-delta', id: 'answer-text', delta: event.text };\n            } else if (event.type === 'tool-call') yield { type: 'tool-input-available', toolCallId: event.callId, toolName: event.name, input: event.input, dynamic: true };\n            else if (event.type === 'tool-result') yield event.isError ? { type: 'tool-output-error', toolCallId: event.callId, errorText: 'Tool execution failed', dynamic: true } : { type: 'tool-output-available', toolCallId: event.callId, output: event.output, dynamic: true };\n            else if (event.type === 'data') yield { type: `data-${event.name}`, data: event.data, ...(event.id ? { id: event.id } : {}) };\n            else if (event.type === 'metadata') yield { type: 'message-metadata', messageMetadata: event.metadata };\n            else if (event.type === 'finish') {\n              if (textStarted) yield { type: 'text-end', id: 'answer-text' };\n              yield { type: 'finish', finishReason: event.reason };\n            }\n          }\n        } finally { await reader.cancel().catch(() => {}); reader.releaseLock(); }\n      }\n      const iterator = chunks();\n      let closed = false;\n      return new ReadableStream<UIMessageChunk>({\n        async pull(output) {\n          try {\n            const next = await iterator.next();\n            if (closed) return;\n            if (next.done) { closed = true; output.close(); } else output.enqueue(next.value);\n          } catch (error) { if (!closed) { closed = true; output.error(error); } }\n        },\n        async cancel(reason) {\n          closed = true;\n          await reader.cancel(reason).catch(() => {});\n          await iterator.return(undefined);\n          // Returning before the generator starts never runs its finally block.\n          try { reader.releaseLock(); } catch { /* A generator finally may already have released it. */ }\n        },\n      });\n    },\n    async reconnectToStream() { return null; },\n  };\n}\n"],"mappings":"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"}

package/dist/ai/generative-ui/GenerativeUIRenderer.cjs.map

@@ -1 +1 @@
-{"version":3,"file":"GenerativeUIRenderer.cjs","names":["useMemo","validateGenerativeUIDocument","useState","_Fragment","MinimalErrorBoundary","require_ai_generative_ui_error_boundary","react_jsx_runtime","react","_alneas_appkit_core_ai","defaultFallback","issue","GenerativeUIRenderer","document","input","scope","setScope","registry","resolved","block","key","fallback","renderFallback"],"sources":["../../../src/ai/generative-ui/GenerativeUIRenderer.tsx"],"sourcesContent":["import { useMemo, useState, type ReactNode } from 'react';\nimport { validateGenerativeUIDocument } from \"@alneas/appkit-core/ai\";\nimport { MinimalErrorBoundary } from './error-boundary';\nimport type { GenerativeUIIssue, GenerativeUIRegistry } from './registry';\n\n/** Props for rendering a fully assembled, immutable JSON response. */\nexport interface GenerativeUIRendererProps {\n  /** Parsed JSON input. Replace its reference to submit a new immutable document. */\n  input: unknown;\n  /** Only explicitly registered component types can render. */\n  registry: GenerativeUIRegistry;\n  /** Application-owned fallback/localization. Receives safe metadata, never raw exceptions. */\n  renderFallback?: (issue: GenerativeUIIssue) => ReactNode;\n}\n\nfunction defaultFallback(issue: GenerativeUIIssue): ReactNode {\n  return <p role=\"status\" data-generative-ui-error={issue.code}>This content cannot be displayed.</p>;\n}\n\n/**\n * Renders validated JSON blocks using an explicit application registry.\n *\n * @remarks\n * Envelope validation snapshots input by reference. Pass immutable documents; replace\n * input when a response changes. Component validators run during rendering and must\n * be pure. Unknown types and invalid data get per-block fallbacks; malformed envelopes\n * get a document fallback. MinimalErrorBoundary isolates client render failures.\n * Block identity includes document ID, block ID/type and data.\n *\n * @example\n * ```tsx\n * import { GenerativeUIRenderer } from \"./\";\n * <GenerativeUIRenderer input={response} registry={registry} />\n * ```\n */\nexport function GenerativeUIRenderer({\n  input,\n  registry,\n  renderFallback = defaultFallback,\n}: GenerativeUIRendererProps): ReactNode {\n  const document = useMemo(() => validateGenerativeUIDocument(input), [input]);\n  const [scope, setScope] = useState({ registry, generation: 0 });\n  if (scope.registry !== registry) setScope({ registry, generation: scope.generation + 1 });\n  if (!document.ok) return renderFallback({ code: 'INVALID_DOCUMENT' });\n\n  return (\n    <>\n      {document.data.blocks.map(block => {\n        const resolved = registry.resolve(block);\n        const key = JSON.stringify([scope.generation, document.data.id, block]);\n        const fallback = (issue: GenerativeUIIssue) => (\n          <div data-generative-ui-block={block.id}>{renderFallback(issue)}</div>\n        );\n        if (!resolved.ok) return <div key={key}>{fallback(resolved.issue)}</div>;\n        return (\n          <MinimalErrorBoundary\n            key={key}\n            fallback={() => fallback({ code: 'RENDER_ERROR', blockId: block.id, type: block.type })}\n          >\n            <div data-generative-ui-block={block.id}>{resolved.element}</div>\n          </MinimalErrorBoundary>\n        );\n      })}\n    </>\n  );\n}\n"],"mappings":"A,kNAeA,SAASS,EAAgB,EAAqC,CAC5D,OAAO,EAAAH,EAAA,IAAA,CAAC,IAAD,CAAG,KAAK,SAAS,2BAA0BI,EAAM,KAAM,SAAA,mCAAoC,CAAA,CACpG,CAkBA,SAAgBC,EAAqB,CACnC,QACA,WACA,iBAAiBF,GACsB,CACvC,IAAMG,GAAA,EAAWZ,EAAAA,QAAAA,MAAAA,EAAcC,EAAAA,6BAAAA,CAA6BY,CAAK,EAAG,CAACA,CAAK,CAAC,EACrE,CAACC,EAAOC,IAAA,EAAYb,EAAAA,SAAAA,CAAS,CAAE,WAAU,WAAY,CAAE,CAAC,EAI9D,OAHIY,EAAM,WAAaE,GAAUD,EAAS,CAAE,WAAU,WAAYD,EAAM,WAAa,CAAE,CAAC,EACnFF,EAAS,IAGZ,EAAAN,EAAA,IAAA,CAAAH,EAAAA,SAAA,CAAA,SACGS,EAAS,KAAK,OAAO,IAAI,GAAS,CACjC,IAAMK,EAAWD,EAAS,QAAQE,CAAK,EACjCC,EAAM,KAAK,UAAU,CAACL,EAAM,WAAYF,EAAS,KAAK,GAAIM,CAAK,CAAC,EAChEE,EAAY,IAChB,EAAAd,EAAA,IAAA,CAAC,MAAD,CAAK,2BAA0BY,EAAM,GAAK,SAAAG,EAAeX,CAAK,CAAO,CAAA,EAGvE,OADKO,EAAS,IAEZ,EAAAX,EAAA,IAAA,CAACF,EAAAA,qBAAD,CAEE,aAAgBgB,EAAS,CAAE,KAAM,eAAgB,QAASF,EAAM,GAAI,KAAMA,EAAM,IAAK,CAAC,EAEtF,UAAA,EAAAZ,EAAA,IAAA,CAAC,MAAD,CAAK,2BAA0BY,EAAM,GAAK,SAAAD,EAAS,OAAa,CAAA,CAC5C,EAJfE,CAIe,GAPC,EAAAb,EAAA,IAAA,CAAC,MAAD,CAAA,SAAgBc,EAASH,EAAS,KAAK,CAAO,EAApCE,CAAoC,CASzE,CAAC,CACD,CAAA,EApBqBE,EAAe,CAAE,KAAM,kBAAmB,CAAC,CAsBtE,C"}
+{"version":3,"file":"GenerativeUIRenderer.cjs","names":["useMemo","validateGenerativeUIDocument","useState","_Fragment","MinimalErrorBoundary","require_ai_generative_ui_error_boundary","react_jsx_runtime","react","_alneas_appkit_core_ai","defaultFallback","issue","GenerativeUIRenderer","document","input","scope","setScope","registry","resolved","block","key","fallback","renderFallback"],"sources":["../../../src/ai/generative-ui/GenerativeUIRenderer.tsx"],"sourcesContent":["import { useMemo, useState, type ReactNode } from 'react';\nimport { validateGenerativeUIDocument } from \"@alneas/appkit-core/ai\";\nimport { MinimalErrorBoundary } from './error-boundary';\nimport type { GenerativeUIIssue, GenerativeUIRegistry } from './registry';\n\n/**\n * Props for rendering a fully assembled, immutable JSON response.\n * @see GenerativeUIRenderer for the canonical usage example.\n */\nexport interface GenerativeUIRendererProps {\n  /** Parsed JSON input. Replace its reference to submit a new immutable document. */\n  input: unknown;\n  /** Only explicitly registered component types can render. */\n  registry: GenerativeUIRegistry;\n  /** Application-owned fallback/localization. Receives safe metadata, never raw exceptions. */\n  renderFallback?: (issue: GenerativeUIIssue) => ReactNode;\n}\n\nfunction defaultFallback(issue: GenerativeUIIssue): ReactNode {\n  return <p role=\"status\" data-generative-ui-error={issue.code}>This content cannot be displayed.</p>;\n}\n\n/**\n * Renders validated JSON blocks using an explicit application registry.\n *\n *\n * @remarks\n * Envelope validation snapshots input by reference. Pass immutable documents; replace\n * input when a response changes. Component validators run during rendering and must\n * be pure. Unknown types and invalid data get per-block fallbacks; malformed envelopes\n * get a document fallback. MinimalErrorBoundary isolates client render failures.\n * Block identity includes document ID, block ID/type and data.\n *\n *\n * @param props - Immutable response, explicit registry and optional localized fallback renderer.\n *\n * @returns Block wrappers and registered elements, or fallback content for invalid input.\n *\n * @remarks Requires React; registered components own any other providers or CSS.\n * The default fallback is an English status paragraph. Client error boundaries handle\n * descendant render failures; React server rendering errors are not isolated by them.\n * Fallback callback errors propagate. Changing registry identity remounts blocks.\n *\n * @example\n * ```tsx\n * import { createGenerativeUIRegistry, GenerativeUIRenderer } from '@alneas/appkit-react/ai/generative-ui';\n * const registry = createGenerativeUIRegistry([]);\n * // Supply a parsed host response; unregistered types receive the fallback.\n * export function GeneratedResponse({ response }: { response: unknown }) {\n *   return <GenerativeUIRenderer input={response} registry={registry} />;\n * }\n * ```\n */\nexport function GenerativeUIRenderer({\n  input,\n  registry,\n  renderFallback = defaultFallback,\n}: GenerativeUIRendererProps): ReactNode {\n  const document = useMemo(() => validateGenerativeUIDocument(input), [input]);\n  const [scope, setScope] = useState({ registry, generation: 0 });\n  if (scope.registry !== registry) setScope({ registry, generation: scope.generation + 1 });\n  if (!document.ok) return renderFallback({ code: 'INVALID_DOCUMENT' });\n\n  return (\n    <>\n      {document.data.blocks.map(block => {\n        const resolved = registry.resolve(block);\n        const key = JSON.stringify([scope.generation, document.data.id, block]);\n        const fallback = (issue: GenerativeUIIssue) => (\n          <div data-generative-ui-block={block.id}>{renderFallback(issue)}</div>\n        );\n        if (!resolved.ok) return <div key={key}>{fallback(resolved.issue)}</div>;\n        return (\n          <MinimalErrorBoundary\n            key={key}\n            fallback={() => fallback({ code: 'RENDER_ERROR', blockId: block.id, type: block.type })}\n          >\n            <div data-generative-ui-block={block.id}>{resolved.element}</div>\n          </MinimalErrorBoundary>\n        );\n      })}\n    </>\n  );\n}\n"],"mappings":"A,kNAkBA,SAASS,EAAgB,EAAqC,CAC5D,OAAO,EAAAH,EAAA,IAAA,CAAC,IAAD,CAAG,KAAK,SAAS,2BAA0BI,EAAM,KAAM,SAAA,mCAAoC,CAAA,CACpG,CAiCA,SAAgBC,EAAqB,CACnC,QACA,WACA,iBAAiBF,GACsB,CACvC,IAAMG,GAAA,EAAWZ,EAAAA,QAAAA,MAAAA,EAAcC,EAAAA,6BAAAA,CAA6BY,CAAK,EAAG,CAACA,CAAK,CAAC,EACrE,CAACC,EAAOC,IAAA,EAAYb,EAAAA,SAAAA,CAAS,CAAE,WAAU,WAAY,CAAE,CAAC,EAI9D,OAHIY,EAAM,WAAaE,GAAUD,EAAS,CAAE,WAAU,WAAYD,EAAM,WAAa,CAAE,CAAC,EACnFF,EAAS,IAGZ,EAAAN,EAAA,IAAA,CAAAH,EAAAA,SAAA,CAAA,SACGS,EAAS,KAAK,OAAO,IAAI,GAAS,CACjC,IAAMK,EAAWD,EAAS,QAAQE,CAAK,EACjCC,EAAM,KAAK,UAAU,CAACL,EAAM,WAAYF,EAAS,KAAK,GAAIM,CAAK,CAAC,EAChEE,EAAY,IAChB,EAAAd,EAAA,IAAA,CAAC,MAAD,CAAK,2BAA0BY,EAAM,GAAK,SAAAG,EAAeX,CAAK,CAAO,CAAA,EAGvE,OADKO,EAAS,IAEZ,EAAAX,EAAA,IAAA,CAACF,EAAAA,qBAAD,CAEE,aAAgBgB,EAAS,CAAE,KAAM,eAAgB,QAASF,EAAM,GAAI,KAAMA,EAAM,IAAK,CAAC,EAEtF,UAAA,EAAAZ,EAAA,IAAA,CAAC,MAAD,CAAK,2BAA0BY,EAAM,GAAK,SAAAD,EAAS,OAAa,CAAA,CAC5C,EAJfE,CAIe,GAPC,EAAAb,EAAA,IAAA,CAAC,MAAD,CAAA,SAAgBc,EAASH,EAAS,KAAK,CAAO,EAApCE,CAAoC,CASzE,CAAC,CACD,CAAA,EApBqBE,EAAe,CAAE,KAAM,kBAAmB,CAAC,CAsBtE,C"}

package/dist/ai/generative-ui/GenerativeUIRenderer.d.cts

@@ -1,6 +1,9 @@
 import { ReactNode } from 'react';
 import { GenerativeUIIssue, GenerativeUIRegistry } from './registry.cjs';
-/** Props for rendering a fully assembled, immutable JSON response. */
+/**
+ * Props for rendering a fully assembled, immutable JSON response.
+ * @see GenerativeUIRenderer for the canonical usage example.
+ */
 export interface GenerativeUIRendererProps {
     /** Parsed JSON input. Replace its reference to submit a new immutable document. */
     input: unknown;
@@ -12,6 +15,7 @@ export interface GenerativeUIRendererProps {
 /**
  * Renders validated JSON blocks using an explicit application registry.
  *
+ *
  * @remarks
  * Envelope validation snapshots input by reference. Pass immutable documents; replace
  * input when a response changes. Component validators run during rendering and must
@@ -19,10 +23,24 @@ export interface GenerativeUIRendererProps {
  * get a document fallback. MinimalErrorBoundary isolates client render failures.
  * Block identity includes document ID, block ID/type and data.
  *
+ *
+ * @param props - Immutable response, explicit registry and optional localized fallback renderer.
+ *
+ * @returns Block wrappers and registered elements, or fallback content for invalid input.
+ *
+ * @remarks Requires React; registered components own any other providers or CSS.
+ * The default fallback is an English status paragraph. Client error boundaries handle
+ * descendant render failures; React server rendering errors are not isolated by them.
+ * Fallback callback errors propagate. Changing registry identity remounts blocks.
+ *
  * @example
  * ```tsx
- * import { GenerativeUIRenderer } from "./index.cjs";
- * <GenerativeUIRenderer input={response} registry={registry} />
+ * import { createGenerativeUIRegistry, GenerativeUIRenderer } from '@alneas/appkit-react/ai/generative-ui';
+ * const registry = createGenerativeUIRegistry([]);
+ * // Supply a parsed host response; unregistered types receive the fallback.
+ * export function GeneratedResponse({ response }: { response: unknown }) {
+ *   return <GenerativeUIRenderer input={response} registry={registry} />;
+ * }
  * ```
  */
 export declare function GenerativeUIRenderer({ input, registry, renderFallback, }: GenerativeUIRendererProps): ReactNode;

package/dist/ai/generative-ui/GenerativeUIRenderer.d.ts

@@ -1,6 +1,9 @@
 import { ReactNode } from 'react';
 import { GenerativeUIIssue, GenerativeUIRegistry } from './registry.js';
-/** Props for rendering a fully assembled, immutable JSON response. */
+/**
+ * Props for rendering a fully assembled, immutable JSON response.
+ * @see GenerativeUIRenderer for the canonical usage example.
+ */
 export interface GenerativeUIRendererProps {
     /** Parsed JSON input. Replace its reference to submit a new immutable document. */
     input: unknown;
@@ -12,6 +15,7 @@ export interface GenerativeUIRendererProps {
 /**
  * Renders validated JSON blocks using an explicit application registry.
  *
+ *
  * @remarks
  * Envelope validation snapshots input by reference. Pass immutable documents; replace
  * input when a response changes. Component validators run during rendering and must
@@ -19,10 +23,24 @@ export interface GenerativeUIRendererProps {
  * get a document fallback. MinimalErrorBoundary isolates client render failures.
  * Block identity includes document ID, block ID/type and data.
  *
+ *
+ * @param props - Immutable response, explicit registry and optional localized fallback renderer.
+ *
+ * @returns Block wrappers and registered elements, or fallback content for invalid input.
+ *
+ * @remarks Requires React; registered components own any other providers or CSS.
+ * The default fallback is an English status paragraph. Client error boundaries handle
+ * descendant render failures; React server rendering errors are not isolated by them.
+ * Fallback callback errors propagate. Changing registry identity remounts blocks.
+ *
  * @example
  * ```tsx
- * import { GenerativeUIRenderer } from "./index.js";
- * <GenerativeUIRenderer input={response} registry={registry} />
+ * import { createGenerativeUIRegistry, GenerativeUIRenderer } from '@alneas/appkit-react/ai/generative-ui';
+ * const registry = createGenerativeUIRegistry([]);
+ * // Supply a parsed host response; unregistered types receive the fallback.
+ * export function GeneratedResponse({ response }: { response: unknown }) {
+ *   return <GenerativeUIRenderer input={response} registry={registry} />;
+ * }
  * ```
  */
 export declare function GenerativeUIRenderer({ input, registry, renderFallback, }: GenerativeUIRendererProps): ReactNode;

package/dist/ai/generative-ui/GenerativeUIRenderer.js.map

@@ -1 +1 @@
-{"version":3,"file":"GenerativeUIRenderer.js","names":["_Fragment","defaultFallback","issue","GenerativeUIRenderer","document","useMemo","validateGenerativeUIDocument","input","scope","setScope","useState","registry","Fragment","resolved","block","key","fallback","renderFallback","MinimalErrorBoundary"],"sources":["../../../src/ai/generative-ui/GenerativeUIRenderer.tsx"],"sourcesContent":["import { useMemo, useState, type ReactNode } from 'react';\nimport { validateGenerativeUIDocument } from \"@alneas/appkit-core/ai\";\nimport { MinimalErrorBoundary } from './error-boundary';\nimport type { GenerativeUIIssue, GenerativeUIRegistry } from './registry';\n\n/** Props for rendering a fully assembled, immutable JSON response. */\nexport interface GenerativeUIRendererProps {\n  /** Parsed JSON input. Replace its reference to submit a new immutable document. */\n  input: unknown;\n  /** Only explicitly registered component types can render. */\n  registry: GenerativeUIRegistry;\n  /** Application-owned fallback/localization. Receives safe metadata, never raw exceptions. */\n  renderFallback?: (issue: GenerativeUIIssue) => ReactNode;\n}\n\nfunction defaultFallback(issue: GenerativeUIIssue): ReactNode {\n  return <p role=\"status\" data-generative-ui-error={issue.code}>This content cannot be displayed.</p>;\n}\n\n/**\n * Renders validated JSON blocks using an explicit application registry.\n *\n * @remarks\n * Envelope validation snapshots input by reference. Pass immutable documents; replace\n * input when a response changes. Component validators run during rendering and must\n * be pure. Unknown types and invalid data get per-block fallbacks; malformed envelopes\n * get a document fallback. MinimalErrorBoundary isolates client render failures.\n * Block identity includes document ID, block ID/type and data.\n *\n * @example\n * ```tsx\n * import { GenerativeUIRenderer } from \"./\";\n * <GenerativeUIRenderer input={response} registry={registry} />\n * ```\n */\nexport function GenerativeUIRenderer({\n  input,\n  registry,\n  renderFallback = defaultFallback,\n}: GenerativeUIRendererProps): ReactNode {\n  const document = useMemo(() => validateGenerativeUIDocument(input), [input]);\n  const [scope, setScope] = useState({ registry, generation: 0 });\n  if (scope.registry !== registry) setScope({ registry, generation: scope.generation + 1 });\n  if (!document.ok) return renderFallback({ code: 'INVALID_DOCUMENT' });\n\n  return (\n    <>\n      {document.data.blocks.map(block => {\n        const resolved = registry.resolve(block);\n        const key = JSON.stringify([scope.generation, document.data.id, block]);\n        const fallback = (issue: GenerativeUIIssue) => (\n          <div data-generative-ui-block={block.id}>{renderFallback(issue)}</div>\n        );\n        if (!resolved.ok) return <div key={key}>{fallback(resolved.issue)}</div>;\n        return (\n          <MinimalErrorBoundary\n            key={key}\n            fallback={() => fallback({ code: 'RENDER_ERROR', blockId: block.id, type: block.type })}\n          >\n            <div data-generative-ui-block={block.id}>{resolved.element}</div>\n          </MinimalErrorBoundary>\n        );\n      })}\n    </>\n  );\n}\n"],"mappings":";;;;;;AAeA,SAASC,EAAgB,GAAqC;CAC5D,OAAO,kBAAC,KAAD;EAAG,MAAK;EAAS,4BAA0BC,EAAM;EAAM,UAAA;CAAoC,CAAA;AACpG;AAkBA,SAAgBC,EAAqB,EACnC,UACA,aACA,oBAAiBF,KACsB;CACvC,IAAMG,IAAWC,QAAcC,EAA6BC,CAAK,GAAG,CAACA,CAAK,CAAC,GACrE,CAACC,GAAOC,KAAYC,EAAS;EAAE;EAAU,YAAY;CAAE,CAAC;CAI9D,OAHIF,EAAM,aAAaG,KAAUF,EAAS;EAAE;EAAU,YAAYD,EAAM,aAAa;CAAE,CAAC,GACnFJ,EAAS,KAGZ,kBAAAJ,GAAA,EAAA,UACGI,EAAS,KAAK,OAAO,KAAI,MAAS;EACjC,IAAMS,IAAWF,EAAS,QAAQG,CAAK,GACjCC,IAAM,KAAK,UAAU;GAACP,EAAM;GAAYJ,EAAS,KAAK;GAAIU;EAAK,CAAC,GAChEE,KAAY,MAChB,kBAAC,OAAD;GAAK,4BAA0BF,EAAM;GAAK,UAAAG,EAAef,CAAK;EAAO,CAAA;EAGvE,OADKW,EAAS,KAEZ,kBAACK,GAAD;GAEE,gBAAgBF,EAAS;IAAE,MAAM;IAAgB,SAASF,EAAM;IAAI,MAAMA,EAAM;GAAK,CAAC;GAEtF,UAAA,kBAAC,OAAD;IAAK,4BAA0BA,EAAM;IAAK,UAAAD,EAAS;GAAa,CAAA;EAC5C,GAJfE,CAIe,IAPC,kBAAC,OAAD,EAAA,UAAgBC,EAASH,EAAS,KAAK,EAAO,GAApCE,CAAoC;CASzE,CAAC,EACD,CAAA,IApBqBE,EAAe,EAAE,MAAM,mBAAmB,CAAC;AAsBtE"}
+{"version":3,"file":"GenerativeUIRenderer.js","names":["_Fragment","defaultFallback","issue","GenerativeUIRenderer","document","useMemo","validateGenerativeUIDocument","input","scope","setScope","useState","registry","Fragment","resolved","block","key","fallback","renderFallback","MinimalErrorBoundary"],"sources":["../../../src/ai/generative-ui/GenerativeUIRenderer.tsx"],"sourcesContent":["import { useMemo, useState, type ReactNode } from 'react';\nimport { validateGenerativeUIDocument } from \"@alneas/appkit-core/ai\";\nimport { MinimalErrorBoundary } from './error-boundary';\nimport type { GenerativeUIIssue, GenerativeUIRegistry } from './registry';\n\n/**\n * Props for rendering a fully assembled, immutable JSON response.\n * @see GenerativeUIRenderer for the canonical usage example.\n */\nexport interface GenerativeUIRendererProps {\n  /** Parsed JSON input. Replace its reference to submit a new immutable document. */\n  input: unknown;\n  /** Only explicitly registered component types can render. */\n  registry: GenerativeUIRegistry;\n  /** Application-owned fallback/localization. Receives safe metadata, never raw exceptions. */\n  renderFallback?: (issue: GenerativeUIIssue) => ReactNode;\n}\n\nfunction defaultFallback(issue: GenerativeUIIssue): ReactNode {\n  return <p role=\"status\" data-generative-ui-error={issue.code}>This content cannot be displayed.</p>;\n}\n\n/**\n * Renders validated JSON blocks using an explicit application registry.\n *\n *\n * @remarks\n * Envelope validation snapshots input by reference. Pass immutable documents; replace\n * input when a response changes. Component validators run during rendering and must\n * be pure. Unknown types and invalid data get per-block fallbacks; malformed envelopes\n * get a document fallback. MinimalErrorBoundary isolates client render failures.\n * Block identity includes document ID, block ID/type and data.\n *\n *\n * @param props - Immutable response, explicit registry and optional localized fallback renderer.\n *\n * @returns Block wrappers and registered elements, or fallback content for invalid input.\n *\n * @remarks Requires React; registered components own any other providers or CSS.\n * The default fallback is an English status paragraph. Client error boundaries handle\n * descendant render failures; React server rendering errors are not isolated by them.\n * Fallback callback errors propagate. Changing registry identity remounts blocks.\n *\n * @example\n * ```tsx\n * import { createGenerativeUIRegistry, GenerativeUIRenderer } from '@alneas/appkit-react/ai/generative-ui';\n * const registry = createGenerativeUIRegistry([]);\n * // Supply a parsed host response; unregistered types receive the fallback.\n * export function GeneratedResponse({ response }: { response: unknown }) {\n *   return <GenerativeUIRenderer input={response} registry={registry} />;\n * }\n * ```\n */\nexport function GenerativeUIRenderer({\n  input,\n  registry,\n  renderFallback = defaultFallback,\n}: GenerativeUIRendererProps): ReactNode {\n  const document = useMemo(() => validateGenerativeUIDocument(input), [input]);\n  const [scope, setScope] = useState({ registry, generation: 0 });\n  if (scope.registry !== registry) setScope({ registry, generation: scope.generation + 1 });\n  if (!document.ok) return renderFallback({ code: 'INVALID_DOCUMENT' });\n\n  return (\n    <>\n      {document.data.blocks.map(block => {\n        const resolved = registry.resolve(block);\n        const key = JSON.stringify([scope.generation, document.data.id, block]);\n        const fallback = (issue: GenerativeUIIssue) => (\n          <div data-generative-ui-block={block.id}>{renderFallback(issue)}</div>\n        );\n        if (!resolved.ok) return <div key={key}>{fallback(resolved.issue)}</div>;\n        return (\n          <MinimalErrorBoundary\n            key={key}\n            fallback={() => fallback({ code: 'RENDER_ERROR', blockId: block.id, type: block.type })}\n          >\n            <div data-generative-ui-block={block.id}>{resolved.element}</div>\n          </MinimalErrorBoundary>\n        );\n      })}\n    </>\n  );\n}\n"],"mappings":";;;;;;AAkBA,SAASC,EAAgB,GAAqC;CAC5D,OAAO,kBAAC,KAAD;EAAG,MAAK;EAAS,4BAA0BC,EAAM;EAAM,UAAA;CAAoC,CAAA;AACpG;AAiCA,SAAgBC,EAAqB,EACnC,UACA,aACA,oBAAiBF,KACsB;CACvC,IAAMG,IAAWC,QAAcC,EAA6BC,CAAK,GAAG,CAACA,CAAK,CAAC,GACrE,CAACC,GAAOC,KAAYC,EAAS;EAAE;EAAU,YAAY;CAAE,CAAC;CAI9D,OAHIF,EAAM,aAAaG,KAAUF,EAAS;EAAE;EAAU,YAAYD,EAAM,aAAa;CAAE,CAAC,GACnFJ,EAAS,KAGZ,kBAAAJ,GAAA,EAAA,UACGI,EAAS,KAAK,OAAO,KAAI,MAAS;EACjC,IAAMS,IAAWF,EAAS,QAAQG,CAAK,GACjCC,IAAM,KAAK,UAAU;GAACP,EAAM;GAAYJ,EAAS,KAAK;GAAIU;EAAK,CAAC,GAChEE,KAAY,MAChB,kBAAC,OAAD;GAAK,4BAA0BF,EAAM;GAAK,UAAAG,EAAef,CAAK;EAAO,CAAA;EAGvE,OADKW,EAAS,KAEZ,kBAACK,GAAD;GAEE,gBAAgBF,EAAS;IAAE,MAAM;IAAgB,SAASF,EAAM;IAAI,MAAMA,EAAM;GAAK,CAAC;GAEtF,UAAA,kBAAC,OAAD;IAAK,4BAA0BA,EAAM;IAAK,UAAAD,EAAS;GAAa,CAAA;EAC5C,GAJfE,CAIe,IAPC,kBAAC,OAAD,EAAA,UAAgBC,EAASH,EAAS,KAAK,EAAO,GAApCE,CAAoC;CASzE,CAAC,EACD,CAAA,IApBqBE,EAAe,EAAE,MAAM,mBAAmB,CAAC;AAsBtE"}

package/dist/ai/generative-ui/error-boundary.cjs.map

@@ -1 +1 @@
-{"version":3,"file":"error-boundary.cjs","names":["Component","react","MinimalErrorBoundary","error"],"sources":["../../../src/ai/generative-ui/error-boundary.tsx"],"sourcesContent":["import { Component, type ReactNode } from 'react';\n\n/** Props for MinimalErrorBoundary. */\nexport interface MinimalErrorBoundaryProps {\n  children: ReactNode;\n  fallback: (error: Error) => ReactNode;\n  onError?: (error: Error) => void;\n}\n\ninterface State {\n  error: Error | null;\n}\n\n/**\n * Lightweight, zero-dependency Error Boundary for safely isolating UI block rendering errors.\n */\nexport class MinimalErrorBoundary extends Component<MinimalErrorBoundaryProps, State> {\n  override state: State = { error: null };\n\n  static getDerivedStateFromError(error: Error): State {\n    return { error };\n  }\n\n  override componentDidCatch(error: Error) {\n    this.props.onError?.(error);\n  }\n\n  override render(): ReactNode {\n    if (this.state.error) {\n      return this.props.fallback(this.state.error);\n    }\n    return this.props.children;\n  }\n}\n"],"mappings":"A,uGAgBA,IAAaE,EAAb,cAA0CF,EAAAA,SAA4C,CACpF,MAAwB,CAAE,MAAO,IAAK,EAEtC,OAAO,yBAAyB,EAAqB,CACnD,MAAO,CAAE,OAAM,CACjB,CAEA,kBAA2B,EAAc,CACvC,KAAK,MAAM,UAAUG,CAAK,CAC5B,CAEA,QAA6B,CAI3B,OAHI,KAAK,MAAM,MACN,KAAK,MAAM,SAAS,KAAK,MAAM,KAAK,EAEtC,KAAK,MAAM,QACpB,CACF,E"}
+{"version":3,"file":"error-boundary.cjs","names":["Component","react","MinimalErrorBoundary","error"],"sources":["../../../src/ai/generative-ui/error-boundary.tsx"],"sourcesContent":["import { Component, type ReactNode } from 'react';\n\n/**\n * Client render isolation inputs; see MinimalErrorBoundary for usage.\n *\n * @see MinimalErrorBoundary for the canonical usage example.\n */\nexport interface MinimalErrorBoundaryProps {\n  /**\n   * Descendant content whose render errors are isolated on the client.\n   */\n  children: ReactNode;\n  /**\n   * Render callback receiving the caught Error; callback failures are not caught by this same boundary.\n   *\n   * @param error - Stored descendant render error.\n   *\n   * @returns Fallback content replacing all children.\n   */\n  fallback: (error: Error) => ReactNode;\n  /**\n   * Optional callback invoked by componentDidCatch after a descendant failure.\n   */\n  onError?: (error: Error) => void;\n}\n\n/**\n * Stored client render failure; see MinimalErrorBoundary lifecycle.\n *\n * @see MinimalErrorBoundary for the canonical usage example.\n */\ninterface State {\n  /**\n   * Caught Error, or null before a render failure.\n   */\n  error: Error | null;\n}\n\n/**\n * Isolates descendant client render failures behind an application fallback.\n *\n * @remarks Requires React only. This boundary does not catch SSR, event-handler or async\n * errors, nor its own fallback errors. It keeps the failure until remounted; changing\n * children does not reset state. onError exceptions propagate to an outer boundary.\n *\n * @example\n * ```tsx\n * import { MinimalErrorBoundary } from '@alneas/appkit-react/ai/generative-ui';\n * export function Block() {\n *   return <MinimalErrorBoundary fallback={() => <p>Unavailable</p>}><span>Content</span></MinimalErrorBoundary>;\n * }\n * ```\n */\nexport class MinimalErrorBoundary extends Component<MinimalErrorBoundaryProps, State> {\n  /**\n   * Current caught-error state; initialized without an error.\n   */\n  override state: State = { error: null };\n\n  /**\n   * Store the descendant render failure for fallback rendering.\n   *\n   * @param error - Error delivered by React.\n   *\n   * @returns Replacement state containing the error.\n   *\n   * @see MinimalErrorBoundary for the usage example.\n   *\n   * @example\n   * ```tsx\n   * import { MinimalErrorBoundary } from '@alneas/appkit-react/ai/generative-ui';\n   * // React invokes the lifecycle method; mount the boundary rather than calling it directly.\n   * export function IsolatedBlock() {\n   *   return <MinimalErrorBoundary fallback={() => <p>Unavailable</p>}><span>Block content</span></MinimalErrorBoundary>;\n   * }\n   * ```\n   */\n  static getDerivedStateFromError(error: Error): State {\n    return { error };\n  }\n\n  /**\n   * Notify the optional host error observer after React catches a descendant failure.\n   *\n   * @param error - Caught descendant render error.\n   *\n   * @returns No value after observer invocation.\n   *\n   * @throws Observer errors propagate to an outer boundary.\n   *\n   * @see MinimalErrorBoundary for setup.\n   *\n   * @example\n   * ```tsx\n   * import { MinimalErrorBoundary } from '@alneas/appkit-react/ai/generative-ui';\n   * // React invokes the lifecycle method; mount the boundary rather than calling it directly.\n   * export function IsolatedBlock() {\n   *   return <MinimalErrorBoundary fallback={() => <p>Unavailable</p>}><span>Block content</span></MinimalErrorBoundary>;\n   * }\n   * ```\n   */\n  override componentDidCatch(error: Error) {\n    this.props.onError?.(error);\n  }\n\n  /**\n   * Render children until an error is stored, then invoke fallback.\n   *\n   * @returns Descendants or host fallback content.\n   *\n   * @throws Fallback errors propagate to an outer boundary.\n   *\n   * @see MinimalErrorBoundary for setup.\n   *\n   * @example\n   * ```tsx\n   * import { MinimalErrorBoundary } from '@alneas/appkit-react/ai/generative-ui';\n   * // React invokes the lifecycle method; mount the boundary rather than calling it directly.\n   * export function IsolatedBlock() {\n   *   return <MinimalErrorBoundary fallback={() => <p>Unavailable</p>}><span>Block content</span></MinimalErrorBoundary>;\n   * }\n   * ```\n   */\n  override render(): ReactNode {\n    if (this.state.error) {\n      return this.props.fallback(this.state.error);\n    }\n    return this.props.children;\n  }\n}\n"],"mappings":"A,uGAqDA,IAAaE,EAAb,cAA0CF,EAAAA,SAA4C,CAIpF,MAAwB,CAAE,MAAO,IAAK,EAoBtC,OAAO,yBAAyB,EAAqB,CACnD,MAAO,CAAE,OAAM,CACjB,CAsBA,kBAA2B,EAAc,CACvC,KAAK,MAAM,UAAUG,CAAK,CAC5B,CAoBA,QAA6B,CAI3B,OAHI,KAAK,MAAM,MACN,KAAK,MAAM,SAAS,KAAK,MAAM,KAAK,EAEtC,KAAK,MAAM,QACpB,CACF,E"}