@alneas/appkit-react 0.3.0 → 0.3.1

package/CHANGELOG.md

@@ -5,6 +5,33 @@ may be prepared before publication; confirm availability on the
 [npm package page](https://www.npmjs.com/package/@alneas/appkit-react). Publication
 dates are recorded only when confirmed.
 
+## [0.3.1]
+
+### Fixed
+
+- Preserve the KanbanColumnFrame registration/ref requirements in one JSDoc remarks
+  block so strict API documentation consumers retain the full guidance without
+  duplicate-tag warnings. Runtime behavior and callable types are unchanged.
+
+- Correct GenerativeUIRenderer declaration documentation to retain all rendering
+  requirements and fallback notes in one remarks block. Strict TypeDoc consumers
+  can generate API documentation without duplicate-tag warnings; runtime behavior,
+  exports and callable types are unchanged.
+- Require the published Core **^0.2.2** documentation patch. The compatible range
+  admits Core 0.2.x updates while excluding older declaration documentation;
+  applications retain exact resolved versions and integrity in their lockfile.
+  Verify that React and any host Core dependency resolve one shared installation.
+- This patch aligns the delivered Core documentation and dependency resolution;
+  it adds no public API changes. The breaking migration from React 0.2.x remains
+  documented under 0.3.0 and in the bundled migration guide.
+- This entry describes release preparation. Confirm npm availability before
+  adopting React 0.3.1; published React 0.3.0 continues to require Core 0.2.0.
+
+- Remove deprecated `aria-grabbed` from DataTable, shared Draggable/FileBrowser activators and enabled Kanban cards while
+  retaining `aria-pressed`, keyboard/pointer dragging, screen-reader instructions
+  and live announcements. This correction requires a new React package release;
+  published 0.3.0 archives do not contain it.
+
 ## [0.3.0]
 
 ### Breaking changes
@@ -106,6 +133,7 @@ dates are recorded only when confirmed.
 - Initial public release of React UI, forms, tables, providers and AI bindings,
   with ESM, CommonJS, TypeScript declarations and explicit styles.
 
+[0.3.1]: https://github.com/dataarthub/appkit/compare/appkit-react-v0.3.0...appkit-react-v0.3.1
 [0.3.0]: https://github.com/dataarthub/appkit/compare/appkit-react-v0.2.0...appkit-react-v0.3.0
 [0.2.0]: https://github.com/dataarthub/appkit/compare/v0.1.0...appkit-react-v0.2.0
 [0.1.0]: https://github.com/dataarthub/appkit/releases/tag/v0.1.0

package/consumer-ai/api-index.json

@@ -1,8 +1,8 @@
 {
   "schemaVersion": 1,
   "packageName": "@alneas/appkit-react",
-  "packageVersion": "0.3.0",
-  "inputDigest": "0c38b41b520f6e894c330ca36ae66d90da2eea86854b7d98edbf26c42b845bb8",
+  "packageVersion": "0.3.1",
+  "inputDigest": "9dbd7be71694e1b1dbfc1cc74cc55088a99220401b0cff370b7443119f81b508",
   "entries": [
     {
       "importPath": "@alneas/appkit-react",
@@ -22512,7 +22512,7 @@
       "tags": [
         {
           "name": "remarks",
-          "text": "Envelope validation snapshots input by reference. Pass immutable documents; replace\ninput when a response changes. Component validators run during rendering and must\nbe pure. Unknown types and invalid data get per-block fallbacks; malformed envelopes\nget a document fallback. MinimalErrorBoundary isolates client render failures.\nBlock identity includes document ID, block ID/type and data."
+          "text": "Envelope validation snapshots input by reference. Pass immutable documents; replace\ninput when a response changes. Component validators run during rendering and must\nbe pure. Unknown types and invalid data get per-block fallbacks; malformed envelopes\nget a document fallback. MinimalErrorBoundary isolates client render failures.\nBlock identity includes document ID, block ID/type and data.\n\n\nRequires React; registered components own any other providers or CSS.\nThe default fallback is an English status paragraph. Client error boundaries handle\ndescendant render failures; React server rendering errors are not isolated by them.\nFallback callback errors propagate. Changing registry identity remounts blocks."
         },
         {
           "name": "param",
@@ -22522,10 +22522,6 @@
           "name": "returns",
           "text": "Block wrappers and registered elements, or fallback content for invalid input."
         },
-        {
-          "name": "remarks",
-          "text": "Requires React; registered components own any other providers or CSS.\nThe default fallback is an English status paragraph. Client error boundaries handle\ndescendant render failures; React server rendering errors are not isolated by them.\nFallback callback errors propagate. Changing registry identity remounts blocks."
-        },
         {
           "name": "example",
           "text": "```tsx\nimport { createGenerativeUIRegistry, GenerativeUIRenderer } from '@alneas/appkit-react/ai/generative-ui';\nconst registry = createGenerativeUIRegistry([]);\n// Supply a parsed host response; unregistered types receive the fallback.\nexport function GeneratedResponse({ response }: { response: unknown }) {\n  return <GenerativeUIRenderer input={response} registry={registry} />;\n}\n```"
@@ -23508,16 +23504,12 @@
         },
         {
           "name": "remarks",
-          "text": "Automatically selects draft-07/2020-12 based on $schema; compiled functions are not shared across instances.\nDo not modify schemas after compilation; provide a new schema object instead.\nThe returned ajv instance corresponds to the default draft. Specify draft explicitly when using addSchema/addKeyword.\nThe default path disables type coercion and does not insert defaults or remove\nkeys. Explicit ajvOptions can enable input mutation. Unknown x-* keywords are\nnot business validation rules merely because strict mode is disabled.\nCompilation/configuration failures throw; invalid data returns valid: false.\nRuntime compilation requires a host that permits AJV's generated functions."
+          "text": "Automatically selects draft-07/2020-12 based on $schema; compiled functions are not shared across instances.\nDo not modify schemas after compilation; provide a new schema object instead.\nThe returned ajv instance corresponds to the default draft. Specify draft explicitly when using addSchema/addKeyword.\nThe default path disables type coercion and does not insert defaults or remove\nkeys. Explicit ajvOptions can enable input mutation. Unknown x-* keywords are\nnot business validation rules merely because strict mode is disabled.\nCompilation/configuration failures throw; invalid data returns valid: false.\nRuntime compilation requires a host that permits AJV's generated functions.\nOmitted options default to {}; draft-07, no explicit locale, and noncoercing data validation are used."
         },
         {
           "name": "throws",
           "text": "Throws Ajv configuration/format-registration failures during construction; later schema compilation failures propagate from the returned validator."
         },
-        {
-          "name": "remarks",
-          "text": "Omitted options default to {}; draft-07, no explicit locale, and noncoercing data validation are used."
-        },
         {
           "name": "example",
           "text": "```typescript\nimport { createAjvValidator } from '@alneas/appkit-core/ai/validation';\n\nconst validate = createAjvValidator({ locale: 'en' });\nconsole.log(validate({ type: 'object', properties: { name: { type: 'string' } }, required: ['name'] }, { name: 'Ada' }));\n```"
@@ -26109,16 +26101,12 @@
         },
         {
           "name": "remarks",
-          "text": "Automatically selects draft-07/2020-12 based on $schema; compiled functions are not shared across instances.\nDo not modify schemas after compilation; provide a new schema object instead.\nThe returned ajv instance corresponds to the default draft. Specify draft explicitly when using addSchema/addKeyword.\nThe default path disables type coercion and does not insert defaults or remove\nkeys. Explicit ajvOptions can enable input mutation. Unknown x-* keywords are\nnot business validation rules merely because strict mode is disabled.\nCompilation/configuration failures throw; invalid data returns valid: false.\nRuntime compilation requires a host that permits AJV's generated functions."
+          "text": "Automatically selects draft-07/2020-12 based on $schema; compiled functions are not shared across instances.\nDo not modify schemas after compilation; provide a new schema object instead.\nThe returned ajv instance corresponds to the default draft. Specify draft explicitly when using addSchema/addKeyword.\nThe default path disables type coercion and does not insert defaults or remove\nkeys. Explicit ajvOptions can enable input mutation. Unknown x-* keywords are\nnot business validation rules merely because strict mode is disabled.\nCompilation/configuration failures throw; invalid data returns valid: false.\nRuntime compilation requires a host that permits AJV's generated functions.\nOmitted options default to {}; draft-07, no explicit locale, and noncoercing data validation are used."
         },
         {
           "name": "throws",
           "text": "Throws Ajv configuration/format-registration failures during construction; later schema compilation failures propagate from the returned validator."
         },
-        {
-          "name": "remarks",
-          "text": "Omitted options default to {}; draft-07, no explicit locale, and noncoercing data validation are used."
-        },
         {
           "name": "example",
           "text": "```typescript\nimport { createAjvValidator } from '@alneas/appkit-core/ai/validation';\n\nconst validate = createAjvValidator({ locale: 'en' });\nconsole.log(validate({ type: 'object', properties: { name: { type: 'string' } }, required: ['name'] }, { name: 'Ada' }));\n```"
@@ -28462,16 +28450,12 @@
         },
         {
           "name": "remarks",
-          "text": "Automatically selects draft-07/2020-12 based on $schema; compiled functions are not shared across instances.\nDo not modify schemas after compilation; provide a new schema object instead.\nThe returned ajv instance corresponds to the default draft. Specify draft explicitly when using addSchema/addKeyword.\nThe default path disables type coercion and does not insert defaults or remove\nkeys. Explicit ajvOptions can enable input mutation. Unknown x-* keywords are\nnot business validation rules merely because strict mode is disabled.\nCompilation/configuration failures throw; invalid data returns valid: false.\nRuntime compilation requires a host that permits AJV's generated functions."
+          "text": "Automatically selects draft-07/2020-12 based on $schema; compiled functions are not shared across instances.\nDo not modify schemas after compilation; provide a new schema object instead.\nThe returned ajv instance corresponds to the default draft. Specify draft explicitly when using addSchema/addKeyword.\nThe default path disables type coercion and does not insert defaults or remove\nkeys. Explicit ajvOptions can enable input mutation. Unknown x-* keywords are\nnot business validation rules merely because strict mode is disabled.\nCompilation/configuration failures throw; invalid data returns valid: false.\nRuntime compilation requires a host that permits AJV's generated functions.\nOmitted options default to {}; draft-07, no explicit locale, and noncoercing data validation are used."
         },
         {
           "name": "throws",
           "text": "Throws Ajv configuration/format-registration failures during construction; later schema compilation failures propagate from the returned validator."
         },
-        {
-          "name": "remarks",
-          "text": "Omitted options default to {}; draft-07, no explicit locale, and noncoercing data validation are used."
-        },
         {
           "name": "example",
           "text": "```typescript\nimport { createAjvValidator } from '@alneas/appkit-core/ai/validation';\n\nconst validate = createAjvValidator({ locale: 'en' });\nconsole.log(validate({ type: 'object', properties: { name: { type: 'string' } }, required: ['name'] }, { name: 'Ada' }));\n```"
@@ -30058,7 +30042,7 @@
       "tags": [
         {
           "name": "remarks",
-          "text": "Envelope validation snapshots input by reference. Pass immutable documents; replace\ninput when a response changes. Component validators run during rendering and must\nbe pure. Unknown types and invalid data get per-block fallbacks; malformed envelopes\nget a document fallback. MinimalErrorBoundary isolates client render failures.\nBlock identity includes document ID, block ID/type and data."
+          "text": "Envelope validation snapshots input by reference. Pass immutable documents; replace\ninput when a response changes. Component validators run during rendering and must\nbe pure. Unknown types and invalid data get per-block fallbacks; malformed envelopes\nget a document fallback. MinimalErrorBoundary isolates client render failures.\nBlock identity includes document ID, block ID/type and data.\n\n\nRequires React; registered components own any other providers or CSS.\nThe default fallback is an English status paragraph. Client error boundaries handle\ndescendant render failures; React server rendering errors are not isolated by them.\nFallback callback errors propagate. Changing registry identity remounts blocks."
         },
         {
           "name": "param",
@@ -30068,10 +30052,6 @@
           "name": "returns",
           "text": "Block wrappers and registered elements, or fallback content for invalid input."
         },
-        {
-          "name": "remarks",
-          "text": "Requires React; registered components own any other providers or CSS.\nThe default fallback is an English status paragraph. Client error boundaries handle\ndescendant render failures; React server rendering errors are not isolated by them.\nFallback callback errors propagate. Changing registry identity remounts blocks."
-        },
         {
           "name": "example",
           "text": "```tsx\nimport { createGenerativeUIRegistry, GenerativeUIRenderer } from '@alneas/appkit-react/ai/generative-ui';\nconst registry = createGenerativeUIRegistry([]);\n// Supply a parsed host response; unregistered types receive the fallback.\nexport function GeneratedResponse({ response }: { response: unknown }) {\n  return <GenerativeUIRenderer input={response} registry={registry} />;\n}\n```"
@@ -30742,16 +30722,12 @@
         },
         {
           "name": "remarks",
-          "text": "Automatically selects draft-07/2020-12 based on $schema; compiled functions are not shared across instances.\nDo not modify schemas after compilation; provide a new schema object instead.\nThe returned ajv instance corresponds to the default draft. Specify draft explicitly when using addSchema/addKeyword.\nThe default path disables type coercion and does not insert defaults or remove\nkeys. Explicit ajvOptions can enable input mutation. Unknown x-* keywords are\nnot business validation rules merely because strict mode is disabled.\nCompilation/configuration failures throw; invalid data returns valid: false.\nRuntime compilation requires a host that permits AJV's generated functions."
+          "text": "Automatically selects draft-07/2020-12 based on $schema; compiled functions are not shared across instances.\nDo not modify schemas after compilation; provide a new schema object instead.\nThe returned ajv instance corresponds to the default draft. Specify draft explicitly when using addSchema/addKeyword.\nThe default path disables type coercion and does not insert defaults or remove\nkeys. Explicit ajvOptions can enable input mutation. Unknown x-* keywords are\nnot business validation rules merely because strict mode is disabled.\nCompilation/configuration failures throw; invalid data returns valid: false.\nRuntime compilation requires a host that permits AJV's generated functions.\nOmitted options default to {}; draft-07, no explicit locale, and noncoercing data validation are used."
         },
         {
           "name": "throws",
           "text": "Throws Ajv configuration/format-registration failures during construction; later schema compilation failures propagate from the returned validator."
         },
-        {
-          "name": "remarks",
-          "text": "Omitted options default to {}; draft-07, no explicit locale, and noncoercing data validation are used."
-        },
         {
           "name": "example",
           "text": "```typescript\nimport { createAjvValidator } from '@alneas/appkit-core/ai/validation';\n\nconst validate = createAjvValidator({ locale: 'en' });\nconsole.log(validate({ type: 'object', properties: { name: { type: 'string' } }, required: ['name'] }, { name: 'Ada' }));\n```"
@@ -33134,16 +33110,12 @@
         },
         {
           "name": "remarks",
-          "text": "Automatically selects draft-07/2020-12 based on $schema; compiled functions are not shared across instances.\nDo not modify schemas after compilation; provide a new schema object instead.\nThe returned ajv instance corresponds to the default draft. Specify draft explicitly when using addSchema/addKeyword.\nThe default path disables type coercion and does not insert defaults or remove\nkeys. Explicit ajvOptions can enable input mutation. Unknown x-* keywords are\nnot business validation rules merely because strict mode is disabled.\nCompilation/configuration failures throw; invalid data returns valid: false.\nRuntime compilation requires a host that permits AJV's generated functions."
+          "text": "Automatically selects draft-07/2020-12 based on $schema; compiled functions are not shared across instances.\nDo not modify schemas after compilation; provide a new schema object instead.\nThe returned ajv instance corresponds to the default draft. Specify draft explicitly when using addSchema/addKeyword.\nThe default path disables type coercion and does not insert defaults or remove\nkeys. Explicit ajvOptions can enable input mutation. Unknown x-* keywords are\nnot business validation rules merely because strict mode is disabled.\nCompilation/configuration failures throw; invalid data returns valid: false.\nRuntime compilation requires a host that permits AJV's generated functions.\nOmitted options default to {}; draft-07, no explicit locale, and noncoercing data validation are used."
         },
         {
           "name": "throws",
           "text": "Throws Ajv configuration/format-registration failures during construction; later schema compilation failures propagate from the returned validator."
         },
-        {
-          "name": "remarks",
-          "text": "Omitted options default to {}; draft-07, no explicit locale, and noncoercing data validation are used."
-        },
         {
           "name": "example",
           "text": "```typescript\nimport { createAjvValidator } from '@alneas/appkit-core/ai/validation';\n\nconst validate = createAjvValidator({ locale: 'en' });\nconsole.log(validate({ type: 'object', properties: { name: { type: 'string' } }, required: ['name'] }, { name: 'Ada' }));\n```"
@@ -79375,7 +79347,7 @@
       "tags": [
         {
           "name": "remarks",
-          "text": "Retain forwardRef to compose native registration and caller refs, including\ncallback cleanup; this is not a direct DOM-ref passthrough."
+          "text": "Retain forwardRef to compose native registration and caller refs, including\ncallback cleanup; this is not a direct DOM-ref passthrough.\nRequires the native Kanban surface. Pointer intersection excludes outside\ndrops; WIP limits are presentational and do not reject a host status callback."
         },
         {
           "name": "param",
@@ -79389,10 +79361,6 @@
           "name": "returns",
           "text": "A column div accepting Kanban task registrations."
         },
-        {
-          "name": "remarks",
-          "text": "Requires the native Kanban surface. Pointer intersection excludes outside\ndrops; WIP limits are presentational and do not reject a host status callback."
-        },
         {
           "name": "example",
           "text": "```tsx\nimport {KanbanDragSurface, KanbanColumnFrame, KanbanDraggableCard, useKanbanDrag}\n  from '@alneas/appkit-react/tools/kanban';\nimport '@alneas/appkit-react/styles';\nexport function CustomCards() {\n  const tasks = [{id: 'one', title: 'Review', status: 'todo'}];\n  const controller = useKanbanDrag({tasks});\n  return <KanbanDragSurface controller={controller}>\n    <KanbanColumnFrame column={{id: 'todo', title: 'Todo'}}>\n      <KanbanDraggableCard task={tasks[0]}>Review</KanbanDraggableCard>\n    </KanbanColumnFrame>\n  </KanbanDragSurface>;\n}\n```"

package/consumer-ai/package-context.json

@@ -1,7 +1,7 @@
 {
   "schemaVersion": 1,
   "name": "@alneas/appkit-react",
-  "version": "0.3.0",
+  "version": "0.3.1",
   "exports": {
     ".": {
       "import": {
@@ -351,7 +351,7 @@
     "./api-index.json": "./consumer-ai/api-index.json"
   },
   "dependencies": {
-    "@alneas/appkit-core": "0.2.0",
+    "@alneas/appkit-core": "^0.2.2",
     "@base-ui/react": "^1.9.0",
     "@dnd-kit/collision": "0.5.1",
     "@dnd-kit/dom": "0.5.1",

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/**\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"}
+{"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 * 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 * @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 * @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

@@ -24,15 +24,15 @@ export interface GenerativeUIRendererProps {
  * 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.
+ * 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.
  *
+ * @param props - Immutable response, explicit registry and optional localized fallback renderer.
+ *
+ * @returns Block wrappers and registered elements, or fallback content for invalid input.
+ *
  * @example
  * ```tsx
  * import { createGenerativeUIRegistry, GenerativeUIRenderer } from '@alneas/appkit-react/ai/generative-ui';

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

@@ -24,15 +24,15 @@ export interface GenerativeUIRendererProps {
  * 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.
+ * 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.
  *
+ * @param props - Immutable response, explicit registry and optional localized fallback renderer.
+ *
+ * @returns Block wrappers and registered elements, or fallback content for invalid input.
+ *
  * @example
  * ```tsx
  * import { createGenerativeUIRegistry, GenerativeUIRenderer } from '@alneas/appkit-react/ai/generative-ui';

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/**\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"}
+{"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 * 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 * @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 * @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/consumer-ai/api-index.json

@@ -1,8 +1,8 @@
 {
   "schemaVersion": 1,
   "packageName": "@alneas/appkit-react",
-  "packageVersion": "0.3.0",
-  "inputDigest": "0c38b41b520f6e894c330ca36ae66d90da2eea86854b7d98edbf26c42b845bb8",
+  "packageVersion": "0.3.1",
+  "inputDigest": "9dbd7be71694e1b1dbfc1cc74cc55088a99220401b0cff370b7443119f81b508",
   "entries": [
     {
       "importPath": "@alneas/appkit-react",
@@ -22512,7 +22512,7 @@
       "tags": [
         {
           "name": "remarks",
-          "text": "Envelope validation snapshots input by reference. Pass immutable documents; replace\ninput when a response changes. Component validators run during rendering and must\nbe pure. Unknown types and invalid data get per-block fallbacks; malformed envelopes\nget a document fallback. MinimalErrorBoundary isolates client render failures.\nBlock identity includes document ID, block ID/type and data."
+          "text": "Envelope validation snapshots input by reference. Pass immutable documents; replace\ninput when a response changes. Component validators run during rendering and must\nbe pure. Unknown types and invalid data get per-block fallbacks; malformed envelopes\nget a document fallback. MinimalErrorBoundary isolates client render failures.\nBlock identity includes document ID, block ID/type and data.\n\n\nRequires React; registered components own any other providers or CSS.\nThe default fallback is an English status paragraph. Client error boundaries handle\ndescendant render failures; React server rendering errors are not isolated by them.\nFallback callback errors propagate. Changing registry identity remounts blocks."
         },
         {
           "name": "param",
@@ -22522,10 +22522,6 @@
           "name": "returns",
           "text": "Block wrappers and registered elements, or fallback content for invalid input."
         },
-        {
-          "name": "remarks",
-          "text": "Requires React; registered components own any other providers or CSS.\nThe default fallback is an English status paragraph. Client error boundaries handle\ndescendant render failures; React server rendering errors are not isolated by them.\nFallback callback errors propagate. Changing registry identity remounts blocks."
-        },
         {
           "name": "example",
           "text": "```tsx\nimport { createGenerativeUIRegistry, GenerativeUIRenderer } from '@alneas/appkit-react/ai/generative-ui';\nconst registry = createGenerativeUIRegistry([]);\n// Supply a parsed host response; unregistered types receive the fallback.\nexport function GeneratedResponse({ response }: { response: unknown }) {\n  return <GenerativeUIRenderer input={response} registry={registry} />;\n}\n```"
@@ -23508,16 +23504,12 @@
         },
         {
           "name": "remarks",
-          "text": "Automatically selects draft-07/2020-12 based on $schema; compiled functions are not shared across instances.\nDo not modify schemas after compilation; provide a new schema object instead.\nThe returned ajv instance corresponds to the default draft. Specify draft explicitly when using addSchema/addKeyword.\nThe default path disables type coercion and does not insert defaults or remove\nkeys. Explicit ajvOptions can enable input mutation. Unknown x-* keywords are\nnot business validation rules merely because strict mode is disabled.\nCompilation/configuration failures throw; invalid data returns valid: false.\nRuntime compilation requires a host that permits AJV's generated functions."
+          "text": "Automatically selects draft-07/2020-12 based on $schema; compiled functions are not shared across instances.\nDo not modify schemas after compilation; provide a new schema object instead.\nThe returned ajv instance corresponds to the default draft. Specify draft explicitly when using addSchema/addKeyword.\nThe default path disables type coercion and does not insert defaults or remove\nkeys. Explicit ajvOptions can enable input mutation. Unknown x-* keywords are\nnot business validation rules merely because strict mode is disabled.\nCompilation/configuration failures throw; invalid data returns valid: false.\nRuntime compilation requires a host that permits AJV's generated functions.\nOmitted options default to {}; draft-07, no explicit locale, and noncoercing data validation are used."
         },
         {
           "name": "throws",
           "text": "Throws Ajv configuration/format-registration failures during construction; later schema compilation failures propagate from the returned validator."
         },
-        {
-          "name": "remarks",
-          "text": "Omitted options default to {}; draft-07, no explicit locale, and noncoercing data validation are used."
-        },
         {
           "name": "example",
           "text": "```typescript\nimport { createAjvValidator } from '@alneas/appkit-core/ai/validation';\n\nconst validate = createAjvValidator({ locale: 'en' });\nconsole.log(validate({ type: 'object', properties: { name: { type: 'string' } }, required: ['name'] }, { name: 'Ada' }));\n```"
@@ -26109,16 +26101,12 @@
         },
         {
           "name": "remarks",
-          "text": "Automatically selects draft-07/2020-12 based on $schema; compiled functions are not shared across instances.\nDo not modify schemas after compilation; provide a new schema object instead.\nThe returned ajv instance corresponds to the default draft. Specify draft explicitly when using addSchema/addKeyword.\nThe default path disables type coercion and does not insert defaults or remove\nkeys. Explicit ajvOptions can enable input mutation. Unknown x-* keywords are\nnot business validation rules merely because strict mode is disabled.\nCompilation/configuration failures throw; invalid data returns valid: false.\nRuntime compilation requires a host that permits AJV's generated functions."
+          "text": "Automatically selects draft-07/2020-12 based on $schema; compiled functions are not shared across instances.\nDo not modify schemas after compilation; provide a new schema object instead.\nThe returned ajv instance corresponds to the default draft. Specify draft explicitly when using addSchema/addKeyword.\nThe default path disables type coercion and does not insert defaults or remove\nkeys. Explicit ajvOptions can enable input mutation. Unknown x-* keywords are\nnot business validation rules merely because strict mode is disabled.\nCompilation/configuration failures throw; invalid data returns valid: false.\nRuntime compilation requires a host that permits AJV's generated functions.\nOmitted options default to {}; draft-07, no explicit locale, and noncoercing data validation are used."
         },
         {
           "name": "throws",
           "text": "Throws Ajv configuration/format-registration failures during construction; later schema compilation failures propagate from the returned validator."
         },
-        {
-          "name": "remarks",
-          "text": "Omitted options default to {}; draft-07, no explicit locale, and noncoercing data validation are used."
-        },
         {
           "name": "example",
           "text": "```typescript\nimport { createAjvValidator } from '@alneas/appkit-core/ai/validation';\n\nconst validate = createAjvValidator({ locale: 'en' });\nconsole.log(validate({ type: 'object', properties: { name: { type: 'string' } }, required: ['name'] }, { name: 'Ada' }));\n```"
@@ -28462,16 +28450,12 @@
         },
         {
           "name": "remarks",
-          "text": "Automatically selects draft-07/2020-12 based on $schema; compiled functions are not shared across instances.\nDo not modify schemas after compilation; provide a new schema object instead.\nThe returned ajv instance corresponds to the default draft. Specify draft explicitly when using addSchema/addKeyword.\nThe default path disables type coercion and does not insert defaults or remove\nkeys. Explicit ajvOptions can enable input mutation. Unknown x-* keywords are\nnot business validation rules merely because strict mode is disabled.\nCompilation/configuration failures throw; invalid data returns valid: false.\nRuntime compilation requires a host that permits AJV's generated functions."
+          "text": "Automatically selects draft-07/2020-12 based on $schema; compiled functions are not shared across instances.\nDo not modify schemas after compilation; provide a new schema object instead.\nThe returned ajv instance corresponds to the default draft. Specify draft explicitly when using addSchema/addKeyword.\nThe default path disables type coercion and does not insert defaults or remove\nkeys. Explicit ajvOptions can enable input mutation. Unknown x-* keywords are\nnot business validation rules merely because strict mode is disabled.\nCompilation/configuration failures throw; invalid data returns valid: false.\nRuntime compilation requires a host that permits AJV's generated functions.\nOmitted options default to {}; draft-07, no explicit locale, and noncoercing data validation are used."
         },
         {
           "name": "throws",
           "text": "Throws Ajv configuration/format-registration failures during construction; later schema compilation failures propagate from the returned validator."
         },
-        {
-          "name": "remarks",
-          "text": "Omitted options default to {}; draft-07, no explicit locale, and noncoercing data validation are used."
-        },
         {
           "name": "example",
           "text": "```typescript\nimport { createAjvValidator } from '@alneas/appkit-core/ai/validation';\n\nconst validate = createAjvValidator({ locale: 'en' });\nconsole.log(validate({ type: 'object', properties: { name: { type: 'string' } }, required: ['name'] }, { name: 'Ada' }));\n```"
@@ -30058,7 +30042,7 @@
       "tags": [
         {
           "name": "remarks",
-          "text": "Envelope validation snapshots input by reference. Pass immutable documents; replace\ninput when a response changes. Component validators run during rendering and must\nbe pure. Unknown types and invalid data get per-block fallbacks; malformed envelopes\nget a document fallback. MinimalErrorBoundary isolates client render failures.\nBlock identity includes document ID, block ID/type and data."
+          "text": "Envelope validation snapshots input by reference. Pass immutable documents; replace\ninput when a response changes. Component validators run during rendering and must\nbe pure. Unknown types and invalid data get per-block fallbacks; malformed envelopes\nget a document fallback. MinimalErrorBoundary isolates client render failures.\nBlock identity includes document ID, block ID/type and data.\n\n\nRequires React; registered components own any other providers or CSS.\nThe default fallback is an English status paragraph. Client error boundaries handle\ndescendant render failures; React server rendering errors are not isolated by them.\nFallback callback errors propagate. Changing registry identity remounts blocks."
         },
         {
           "name": "param",
@@ -30068,10 +30052,6 @@
           "name": "returns",
           "text": "Block wrappers and registered elements, or fallback content for invalid input."
         },
-        {
-          "name": "remarks",
-          "text": "Requires React; registered components own any other providers or CSS.\nThe default fallback is an English status paragraph. Client error boundaries handle\ndescendant render failures; React server rendering errors are not isolated by them.\nFallback callback errors propagate. Changing registry identity remounts blocks."
-        },
         {
           "name": "example",
           "text": "```tsx\nimport { createGenerativeUIRegistry, GenerativeUIRenderer } from '@alneas/appkit-react/ai/generative-ui';\nconst registry = createGenerativeUIRegistry([]);\n// Supply a parsed host response; unregistered types receive the fallback.\nexport function GeneratedResponse({ response }: { response: unknown }) {\n  return <GenerativeUIRenderer input={response} registry={registry} />;\n}\n```"
@@ -30742,16 +30722,12 @@
         },
         {
           "name": "remarks",
-          "text": "Automatically selects draft-07/2020-12 based on $schema; compiled functions are not shared across instances.\nDo not modify schemas after compilation; provide a new schema object instead.\nThe returned ajv instance corresponds to the default draft. Specify draft explicitly when using addSchema/addKeyword.\nThe default path disables type coercion and does not insert defaults or remove\nkeys. Explicit ajvOptions can enable input mutation. Unknown x-* keywords are\nnot business validation rules merely because strict mode is disabled.\nCompilation/configuration failures throw; invalid data returns valid: false.\nRuntime compilation requires a host that permits AJV's generated functions."
+          "text": "Automatically selects draft-07/2020-12 based on $schema; compiled functions are not shared across instances.\nDo not modify schemas after compilation; provide a new schema object instead.\nThe returned ajv instance corresponds to the default draft. Specify draft explicitly when using addSchema/addKeyword.\nThe default path disables type coercion and does not insert defaults or remove\nkeys. Explicit ajvOptions can enable input mutation. Unknown x-* keywords are\nnot business validation rules merely because strict mode is disabled.\nCompilation/configuration failures throw; invalid data returns valid: false.\nRuntime compilation requires a host that permits AJV's generated functions.\nOmitted options default to {}; draft-07, no explicit locale, and noncoercing data validation are used."
         },
         {
           "name": "throws",
           "text": "Throws Ajv configuration/format-registration failures during construction; later schema compilation failures propagate from the returned validator."
         },
-        {
-          "name": "remarks",
-          "text": "Omitted options default to {}; draft-07, no explicit locale, and noncoercing data validation are used."
-        },
         {
           "name": "example",
           "text": "```typescript\nimport { createAjvValidator } from '@alneas/appkit-core/ai/validation';\n\nconst validate = createAjvValidator({ locale: 'en' });\nconsole.log(validate({ type: 'object', properties: { name: { type: 'string' } }, required: ['name'] }, { name: 'Ada' }));\n```"
@@ -33134,16 +33110,12 @@
         },
         {
           "name": "remarks",
-          "text": "Automatically selects draft-07/2020-12 based on $schema; compiled functions are not shared across instances.\nDo not modify schemas after compilation; provide a new schema object instead.\nThe returned ajv instance corresponds to the default draft. Specify draft explicitly when using addSchema/addKeyword.\nThe default path disables type coercion and does not insert defaults or remove\nkeys. Explicit ajvOptions can enable input mutation. Unknown x-* keywords are\nnot business validation rules merely because strict mode is disabled.\nCompilation/configuration failures throw; invalid data returns valid: false.\nRuntime compilation requires a host that permits AJV's generated functions."
+          "text": "Automatically selects draft-07/2020-12 based on $schema; compiled functions are not shared across instances.\nDo not modify schemas after compilation; provide a new schema object instead.\nThe returned ajv instance corresponds to the default draft. Specify draft explicitly when using addSchema/addKeyword.\nThe default path disables type coercion and does not insert defaults or remove\nkeys. Explicit ajvOptions can enable input mutation. Unknown x-* keywords are\nnot business validation rules merely because strict mode is disabled.\nCompilation/configuration failures throw; invalid data returns valid: false.\nRuntime compilation requires a host that permits AJV's generated functions.\nOmitted options default to {}; draft-07, no explicit locale, and noncoercing data validation are used."
         },
         {
           "name": "throws",
           "text": "Throws Ajv configuration/format-registration failures during construction; later schema compilation failures propagate from the returned validator."
         },
-        {
-          "name": "remarks",
-          "text": "Omitted options default to {}; draft-07, no explicit locale, and noncoercing data validation are used."
-        },
         {
           "name": "example",
           "text": "```typescript\nimport { createAjvValidator } from '@alneas/appkit-core/ai/validation';\n\nconst validate = createAjvValidator({ locale: 'en' });\nconsole.log(validate({ type: 'object', properties: { name: { type: 'string' } }, required: ['name'] }, { name: 'Ada' }));\n```"
@@ -79375,7 +79347,7 @@
       "tags": [
         {
           "name": "remarks",
-          "text": "Retain forwardRef to compose native registration and caller refs, including\ncallback cleanup; this is not a direct DOM-ref passthrough."
+          "text": "Retain forwardRef to compose native registration and caller refs, including\ncallback cleanup; this is not a direct DOM-ref passthrough.\nRequires the native Kanban surface. Pointer intersection excludes outside\ndrops; WIP limits are presentational and do not reject a host status callback."
         },
         {
           "name": "param",
@@ -79389,10 +79361,6 @@
           "name": "returns",
           "text": "A column div accepting Kanban task registrations."
         },
-        {
-          "name": "remarks",
-          "text": "Requires the native Kanban surface. Pointer intersection excludes outside\ndrops; WIP limits are presentational and do not reject a host status callback."
-        },
         {
           "name": "example",
           "text": "```tsx\nimport {KanbanDragSurface, KanbanColumnFrame, KanbanDraggableCard, useKanbanDrag}\n  from '@alneas/appkit-react/tools/kanban';\nimport '@alneas/appkit-react/styles';\nexport function CustomCards() {\n  const tasks = [{id: 'one', title: 'Review', status: 'todo'}];\n  const controller = useKanbanDrag({tasks});\n  return <KanbanDragSurface controller={controller}>\n    <KanbanColumnFrame column={{id: 'todo', title: 'Todo'}}>\n      <KanbanDraggableCard task={tasks[0]}>Review</KanbanDraggableCard>\n    </KanbanColumnFrame>\n  </KanbanDragSurface>;\n}\n```"

package/dist/consumer-ai/package-context.json

@@ -1,7 +1,7 @@
 {
   "schemaVersion": 1,
   "name": "@alneas/appkit-react",
-  "version": "0.3.0",
+  "version": "0.3.1",
   "exports": {
     ".": {
       "import": {
@@ -351,7 +351,7 @@
     "./api-index.json": "./consumer-ai/api-index.json"
   },
   "dependencies": {
-    "@alneas/appkit-core": "0.2.0",
+    "@alneas/appkit-core": "^0.2.2",
     "@base-ui/react": "^1.9.0",
     "@dnd-kit/collision": "0.5.1",
     "@dnd-kit/dom": "0.5.1",