@alneas/appkit-react 0.2.0 → 0.3.1

package/consumer-ai/package-context.json

@@ -1,7 +1,7 @@
 {
   "schemaVersion": 1,
   "name": "@alneas/appkit-react",
-  "version": "0.2.0",
+  "version": "0.3.1",
   "exports": {
     ".": {
       "import": {
@@ -351,29 +351,29 @@
     "./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/core": "^6.3.1",
-    "@dnd-kit/sortable": "^10.0.0",
-    "@dnd-kit/utilities": "^3.2.2",
-    "@hookform/resolvers": "^5.9.2",
-    "@tanstack/react-query": "5.104.4",
+    "@dnd-kit/collision": "0.5.1",
+    "@dnd-kit/dom": "0.5.1",
+    "@dnd-kit/react": "0.5.1",
+    "@hookform/resolvers": "^6.0.0",
+    "@tanstack/react-query": "5.104.5",
     "@tanstack/react-table": "9.3.1",
     "class-variance-authority": "^0.7.1",
     "clsx": "^2.1.1",
     "cmdk-base": "^1.0.0",
     "date-fns": "^4.4.0",
     "input-otp": "^1.5.0",
-    "lucide-react": "^1.59.0",
+    "lucide-react": "^1.61.0",
     "react-day-picker": "^10.0.2",
     "react-hook-form": "^7.90.0",
-    "react-resizable-panels": "^4.14.6",
+    "react-resizable-panels": "^4.14.8",
     "tailwind-merge": "^3.7.0",
     "vaul-base": "^1.0.0",
-    "zustand": "^5.0.15",
+    "zustand": "^5.0.16",
     "tw-animate-css": "^1.4.0",
     "zod": "^4.2.1",
-    "@tanstack/query-core": "5.104.4",
+    "@tanstack/query-core": "5.104.5",
     "@tanstack/table-core": "9.3.1"
   },
   "peers": {

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

@@ -1 +1 @@
-{"version":3,"file":"use-screen-action.cjs","names":["useScreenActionRegistry","useRef","require_ai_action_context","react","useScreenAction","registry","actionRef","action","unregister","input","context","id","description","metadata"],"sources":["../../../src/ai/action/use-screen-action.ts"],"sourcesContent":["import { useLayoutEffect, useRef } from 'react';\nimport type { ActionDefinition, ActionValidator, ExecutionContext } from \"@alneas/appkit-core/ai\";\nimport { useScreenActionRegistry } from './context';\n\n/**\n * Registers a validated action on the nearest screen registry after commit.\n *\n * @typeParam TInput - Validated input shape; defaults to unknown.\n *\n * @typeParam TOutput - Handler output shape; defaults to unknown.\n *\n * @param action - Stable ID/description/metadata with validator and handler from the host.\n *\n * @returns No value; effect cleanup unregisters this registration.\n *\n * @throws Error without ScreenActionProvider; registration errors propagate from the layout effect.\n *\n * @remarks Latest committed validator/handler are read through refs. ID, description or\n * metadata identity changes trigger re-registration. No action executes automatically;\n * no styles are required. The host owns effects and authorization in its handler.\n *\n * @example\n * ```tsx\n * import { ScreenActionProvider, useScreenAction, type ActionDefinition } from '@alneas/appkit-react/ai/action';\n * function Registration({ action }: { action: ActionDefinition<string, string> }) { useScreenAction(action); return null; }\n * export function Screen({ action }: { action: ActionDefinition<string, string> }) {\n *   return <ScreenActionProvider><Registration action={action} /></ScreenActionProvider>;\n * }\n * ```\n */\nexport function useScreenAction<TInput = unknown, TOutput = unknown>(\n  action: ActionDefinition<TInput, TOutput>\n): void {\n  const registry = useScreenActionRegistry();\n\n  const actionRef = useRef(action);\n  useLayoutEffect(() => {\n    actionRef.current = action;\n  });\n\n  const { id, description, metadata } = action;\n\n  useLayoutEffect(() => {\n    const wrappedValidate: ActionValidator<TInput> = (input) => {\n      return actionRef.current.validate(input);\n    };\n\n    const wrappedHandler = (input: TInput, context?: ExecutionContext) => {\n      return context ? actionRef.current.handler(input, context) : actionRef.current.handler(input);\n    };\n\n    const unregister = registry.registerAction({\n      id,\n      description,\n      validate: wrappedValidate,\n      handler: wrappedHandler,\n      metadata,\n    });\n\n    return () => {\n      unregister();\n    };\n  }, [registry, id, description, metadata]);\n}\n"],"mappings":"A,wIA8BA,SAAgBI,EACd,EACM,CACN,IAAMC,EAAWL,EAAAA,wBAAwB,EAEnCM,GAAA,EAAYL,EAAAA,OAAAA,CAAOM,CAAM,GAC/B,EAAAJ,EAAA,gBAAA,KAAsB,CACpB,EAAU,QAAUI,CACtB,CAAC,EAED,GAAM,CAAE,KAAI,cAAa,YAAaA,GAEtC,EAAAJ,EAAA,gBAAA,KAAsB,CASpB,IAAMK,EAAaH,EAAS,eAAe,CACzC,KACA,cACA,SAXgD,GACzCC,EAAU,QAAQ,SAASG,CAAK,EAWvC,SARsB,EAAe,IAC9BC,EAAUJ,EAAU,QAAQ,QAAQG,EAAOC,CAAO,EAAIJ,EAAU,QAAQ,QAAQG,CAAK,EAQ5F,UACF,CAAC,EAED,UAAa,CACXD,EAAW,CACb,CACF,EAAG,CAACH,EAAUM,EAAIC,EAAaC,CAAQ,CAAC,CAC1C,C"}
+{"version":3,"file":"use-screen-action.cjs","names":["useScreenActionRegistry","useRef","require_ai_action_context","react","useScreenAction","registry","actionRef","action","unregister","input","context","id","description","metadata"],"sources":["../../../src/ai/action/use-screen-action.ts"],"sourcesContent":["import { useLayoutEffect, useRef } from 'react';\nimport type { ActionDefinition, ActionValidator, ExecutionContext } from \"@alneas/appkit-core/ai\";\nimport { useScreenActionRegistry } from './context';\n\n/**\n * Registers a validated action on the nearest screen registry after commit.\n *\n * @typeParam TInput - Validated input shape; defaults to unknown.\n *\n * @typeParam TOutput - Handler output shape; defaults to unknown.\n *\n * @param action - Stable ID/description/metadata with validator and handler from the host.\n *\n * @returns No value; effect cleanup unregisters this registration.\n *\n * @throws Error without ScreenActionProvider; registration errors propagate from the layout effect.\n *\n * @remarks Latest committed validator/handler are read through refs. ID, description or\n * metadata identity changes trigger re-registration. No action executes automatically;\n * no styles are required. The host owns effects and authorization in its handler.\n * Keep the ref/layout-effect bridge: external registry callers can invoke validation\n * and execution outside Effect-originated callbacks. useEffectEvent is restricted to\n * Effect logic and is not a replacement for these externally callable functions.\n * This preserves latest committed callbacks without re-registering on every render;\n * it is not a React 18 compatibility shim.\n *\n * @example\n * ```tsx\n * import { ScreenActionProvider, useScreenAction, type ActionDefinition } from '@alneas/appkit-react/ai/action';\n * function Registration({ action }: { action: ActionDefinition<string, string> }) { useScreenAction(action); return null; }\n * export function Screen({ action }: { action: ActionDefinition<string, string> }) {\n *   return <ScreenActionProvider><Registration action={action} /></ScreenActionProvider>;\n * }\n * ```\n */\nexport function useScreenAction<TInput = unknown, TOutput = unknown>(\n  action: ActionDefinition<TInput, TOutput>\n): void {\n  const registry = useScreenActionRegistry();\n\n  const actionRef = useRef(action);\n  useLayoutEffect(() => {\n    actionRef.current = action;\n  });\n\n  const { id, description, metadata } = action;\n\n  useLayoutEffect(() => {\n    const wrappedValidate: ActionValidator<TInput> = (input) => {\n      return actionRef.current.validate(input);\n    };\n\n    const wrappedHandler = (input: TInput, context?: ExecutionContext) => {\n      return context ? actionRef.current.handler(input, context) : actionRef.current.handler(input);\n    };\n\n    const unregister = registry.registerAction({\n      id,\n      description,\n      validate: wrappedValidate,\n      handler: wrappedHandler,\n      metadata,\n    });\n\n    return () => {\n      unregister();\n    };\n  }, [registry, id, description, metadata]);\n}\n"],"mappings":"A,wIAmCA,SAAgBI,EACd,EACM,CACN,IAAMC,EAAWL,EAAAA,wBAAwB,EAEnCM,GAAA,EAAYL,EAAAA,OAAAA,CAAOM,CAAM,GAC/B,EAAAJ,EAAA,gBAAA,KAAsB,CACpB,EAAU,QAAUI,CACtB,CAAC,EAED,GAAM,CAAE,KAAI,cAAa,YAAaA,GAEtC,EAAAJ,EAAA,gBAAA,KAAsB,CASpB,IAAMK,EAAaH,EAAS,eAAe,CACzC,KACA,cACA,SAXgD,GACzCC,EAAU,QAAQ,SAASG,CAAK,EAWvC,SARsB,EAAe,IAC9BC,EAAUJ,EAAU,QAAQ,QAAQG,EAAOC,CAAO,EAAIJ,EAAU,QAAQ,QAAQG,CAAK,EAQ5F,UACF,CAAC,EAED,UAAa,CACXD,EAAW,CACb,CACF,EAAG,CAACH,EAAUM,EAAIC,EAAaC,CAAQ,CAAC,CAC1C,C"}

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

@@ -15,6 +15,11 @@ import { ActionDefinition } from '@alneas/appkit-core/ai';
  * @remarks Latest committed validator/handler are read through refs. ID, description or
  * metadata identity changes trigger re-registration. No action executes automatically;
  * no styles are required. The host owns effects and authorization in its handler.
+ * Keep the ref/layout-effect bridge: external registry callers can invoke validation
+ * and execution outside Effect-originated callbacks. useEffectEvent is restricted to
+ * Effect logic and is not a replacement for these externally callable functions.
+ * This preserves latest committed callbacks without re-registering on every render;
+ * it is not a React 18 compatibility shim.
  *
  * @example
  * ```tsx

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

@@ -15,6 +15,11 @@ import { ActionDefinition } from '@alneas/appkit-core/ai';
  * @remarks Latest committed validator/handler are read through refs. ID, description or
  * metadata identity changes trigger re-registration. No action executes automatically;
  * no styles are required. The host owns effects and authorization in its handler.
+ * Keep the ref/layout-effect bridge: external registry callers can invoke validation
+ * and execution outside Effect-originated callbacks. useEffectEvent is restricted to
+ * Effect logic and is not a replacement for these externally callable functions.
+ * This preserves latest committed callbacks without re-registering on every render;
+ * it is not a React 18 compatibility shim.
  *
  * @example
  * ```tsx

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

@@ -1 +1 @@
-{"version":3,"file":"use-screen-action.js","names":["useScreenAction","registry","useScreenActionRegistry","actionRef","useRef","action","unregister","input","context","id","description","metadata"],"sources":["../../../src/ai/action/use-screen-action.ts"],"sourcesContent":["import { useLayoutEffect, useRef } from 'react';\nimport type { ActionDefinition, ActionValidator, ExecutionContext } from \"@alneas/appkit-core/ai\";\nimport { useScreenActionRegistry } from './context';\n\n/**\n * Registers a validated action on the nearest screen registry after commit.\n *\n * @typeParam TInput - Validated input shape; defaults to unknown.\n *\n * @typeParam TOutput - Handler output shape; defaults to unknown.\n *\n * @param action - Stable ID/description/metadata with validator and handler from the host.\n *\n * @returns No value; effect cleanup unregisters this registration.\n *\n * @throws Error without ScreenActionProvider; registration errors propagate from the layout effect.\n *\n * @remarks Latest committed validator/handler are read through refs. ID, description or\n * metadata identity changes trigger re-registration. No action executes automatically;\n * no styles are required. The host owns effects and authorization in its handler.\n *\n * @example\n * ```tsx\n * import { ScreenActionProvider, useScreenAction, type ActionDefinition } from '@alneas/appkit-react/ai/action';\n * function Registration({ action }: { action: ActionDefinition<string, string> }) { useScreenAction(action); return null; }\n * export function Screen({ action }: { action: ActionDefinition<string, string> }) {\n *   return <ScreenActionProvider><Registration action={action} /></ScreenActionProvider>;\n * }\n * ```\n */\nexport function useScreenAction<TInput = unknown, TOutput = unknown>(\n  action: ActionDefinition<TInput, TOutput>\n): void {\n  const registry = useScreenActionRegistry();\n\n  const actionRef = useRef(action);\n  useLayoutEffect(() => {\n    actionRef.current = action;\n  });\n\n  const { id, description, metadata } = action;\n\n  useLayoutEffect(() => {\n    const wrappedValidate: ActionValidator<TInput> = (input) => {\n      return actionRef.current.validate(input);\n    };\n\n    const wrappedHandler = (input: TInput, context?: ExecutionContext) => {\n      return context ? actionRef.current.handler(input, context) : actionRef.current.handler(input);\n    };\n\n    const unregister = registry.registerAction({\n      id,\n      description,\n      validate: wrappedValidate,\n      handler: wrappedHandler,\n      metadata,\n    });\n\n    return () => {\n      unregister();\n    };\n  }, [registry, id, description, metadata]);\n}\n"],"mappings":";;;;AA8BA,SAAgBA,EACd,GACM;CACN,IAAMC,IAAWC,EAAwB,GAEnCC,IAAYC,EAAOC,CAAM;CAC/B,QAAsB;EACpB,EAAU,UAAUA;CACtB,CAAC;CAED,IAAM,EAAE,OAAI,gBAAa,gBAAaA;CAEtC,QAAsB;EASpB,IAAMC,IAAaL,EAAS,eAAe;GACzC;GACA;GACA,WAXgD,MACzCE,EAAU,QAAQ,SAASI,CAAK;GAWvC,UARsB,GAAe,MAC9BC,IAAUL,EAAU,QAAQ,QAAQI,GAAOC,CAAO,IAAIL,EAAU,QAAQ,QAAQI,CAAK;GAQ5F;EACF,CAAC;EAED,aAAa;GACX,EAAW;EACb;CACF,GAAG;EAACN;EAAUQ;EAAIC;EAAaC;CAAQ,CAAC;AAC1C"}
+{"version":3,"file":"use-screen-action.js","names":["useScreenAction","registry","useScreenActionRegistry","actionRef","useRef","action","unregister","input","context","id","description","metadata"],"sources":["../../../src/ai/action/use-screen-action.ts"],"sourcesContent":["import { useLayoutEffect, useRef } from 'react';\nimport type { ActionDefinition, ActionValidator, ExecutionContext } from \"@alneas/appkit-core/ai\";\nimport { useScreenActionRegistry } from './context';\n\n/**\n * Registers a validated action on the nearest screen registry after commit.\n *\n * @typeParam TInput - Validated input shape; defaults to unknown.\n *\n * @typeParam TOutput - Handler output shape; defaults to unknown.\n *\n * @param action - Stable ID/description/metadata with validator and handler from the host.\n *\n * @returns No value; effect cleanup unregisters this registration.\n *\n * @throws Error without ScreenActionProvider; registration errors propagate from the layout effect.\n *\n * @remarks Latest committed validator/handler are read through refs. ID, description or\n * metadata identity changes trigger re-registration. No action executes automatically;\n * no styles are required. The host owns effects and authorization in its handler.\n * Keep the ref/layout-effect bridge: external registry callers can invoke validation\n * and execution outside Effect-originated callbacks. useEffectEvent is restricted to\n * Effect logic and is not a replacement for these externally callable functions.\n * This preserves latest committed callbacks without re-registering on every render;\n * it is not a React 18 compatibility shim.\n *\n * @example\n * ```tsx\n * import { ScreenActionProvider, useScreenAction, type ActionDefinition } from '@alneas/appkit-react/ai/action';\n * function Registration({ action }: { action: ActionDefinition<string, string> }) { useScreenAction(action); return null; }\n * export function Screen({ action }: { action: ActionDefinition<string, string> }) {\n *   return <ScreenActionProvider><Registration action={action} /></ScreenActionProvider>;\n * }\n * ```\n */\nexport function useScreenAction<TInput = unknown, TOutput = unknown>(\n  action: ActionDefinition<TInput, TOutput>\n): void {\n  const registry = useScreenActionRegistry();\n\n  const actionRef = useRef(action);\n  useLayoutEffect(() => {\n    actionRef.current = action;\n  });\n\n  const { id, description, metadata } = action;\n\n  useLayoutEffect(() => {\n    const wrappedValidate: ActionValidator<TInput> = (input) => {\n      return actionRef.current.validate(input);\n    };\n\n    const wrappedHandler = (input: TInput, context?: ExecutionContext) => {\n      return context ? actionRef.current.handler(input, context) : actionRef.current.handler(input);\n    };\n\n    const unregister = registry.registerAction({\n      id,\n      description,\n      validate: wrappedValidate,\n      handler: wrappedHandler,\n      metadata,\n    });\n\n    return () => {\n      unregister();\n    };\n  }, [registry, id, description, metadata]);\n}\n"],"mappings":";;;;AAmCA,SAAgBA,EACd,GACM;CACN,IAAMC,IAAWC,EAAwB,GAEnCC,IAAYC,EAAOC,CAAM;CAC/B,QAAsB;EACpB,EAAU,UAAUA;CACtB,CAAC;CAED,IAAM,EAAE,OAAI,gBAAa,gBAAaA;CAEtC,QAAsB;EASpB,IAAMC,IAAaL,EAAS,eAAe;GACzC;GACA;GACA,WAXgD,MACzCE,EAAU,QAAQ,SAASI,CAAK;GAWvC,UARsB,GAAe,MAC9BC,IAAUL,EAAU,QAAQ,QAAQI,GAAOC,CAAO,IAAIL,EAAU,QAAQ,QAAQI,CAAK;GAQ5F;EACF,CAAC;EAED,aAAa;GACX,EAAW;EACb;CACF,GAAG;EAACN;EAAUQ;EAAIC;EAAaC;CAAQ,CAAC;AAC1C"}

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 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 *\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 *\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,wIA0DA,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

@@ -17,6 +17,10 @@ import { UseScreenContextOptions } from './types.cjs';
  *
  * @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
@@ -38,6 +42,8 @@ export declare function useScreenContext<T = unknown>(key: string, getter: Conte
  * @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

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

@@ -17,6 +17,10 @@ import { UseScreenContextOptions } from './types.js';
  *
  * @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
@@ -38,6 +42,8 @@ export declare function useScreenContext<T = unknown>(key: string, getter: Conte
  * @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

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 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 *\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 *\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":";;;;AA0DA,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/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/ai/proposal/use-proposal-batch-review.cjs.map

@@ -1 +1 @@
-{"version":3,"file":"use-proposal-batch-review.cjs","names":["createExecutionSession","useState","useRef","useSyncExternalStore","prepareProposalBatch","react","_alneas_appkit_core_ai","initial","useProposalBatchReview","key","options","item","stored","setStored","state","session","live","latest","current","history","busy","record","update","change","entries","items","applied","preparation","editable","id","next","value","selected","field","decision","planned","outcome","context","completed","payload","checked","fraction","progress"],"sources":["../../../src/ai/proposal/use-proposal-batch-review.ts"],"sourcesContent":["import { useLayoutEffect, useRef, useState, useSyncExternalStore } from 'react';\nimport { createExecutionSession, type ExecutionContext, type ExecutionRecord, type ExecutionSession } from \"@alneas/appkit-core/ai\";\nimport {\n  prepareProposalBatch,\n  type ApplyProposalPayload,\n  type FieldDecision,\n  type FieldKey,\n  type PreparedProposalBatch,\n  type ProposalBatchEntry,\n  type ProposalBatchItem,\n  type ProposalBatchValidator,\n  type ReviewDecisions,\n} from \"@alneas/appkit-core/ai\";\n\n/**\n * Host inputs for reviewing unique immutable proposals across multiple records.\n *\n * @typeParam TRecord - Record shape; defaults to a string-keyed record.\n *\n * @see useProposalBatchReview for usage.\n */\nexport interface UseProposalBatchReviewOptions<TRecord extends Record<string, any> = Record<string, any>> {\n  /** Change for a new review session, including an intentional replay of the same proposals. */\n  batchId: string;\n  /**\n   * Validated proposals and latest records/versions; proposal IDs must be unique.\n   */\n  items: readonly ProposalBatchItem<TRecord>[];\n  /**\n   * Optional synchronous validator passed to Core batch preparation; thrown errors become invalid_candidate issues.\n   */\n  validateCandidate?: ProposalBatchValidator<TRecord>;\n    /**\n     * Sequential host callback receiving one prepared payload and cooperative abort/progress context.\n     *\n     * @param payload - Validated candidate and decisions for one proposal.\n     *\n     * @param context - Abort signal and fractional-progress reporting for this row.\n     *\n     * @returns No value after the host confirms application; reject to stop later rows.\n     */\n  onApply?: (payload: ApplyProposalPayload<TRecord>, context: ExecutionContext) => void | Promise<void>;\n}\n\n/**\n * Batch selection/decision state and explicit execution controls.\n *\n * @typeParam TRecord - Shared record shape; defaults to a string-keyed record.\n *\n * @see useProposalBatchReview for usage.\n */\nexport interface UseProposalBatchReviewReturn<TRecord extends Record<string, any> = Record<string, any>> {\n  /**\n   * Current selected proposal IDs; applied IDs are excluded from preparation.\n   */\n  selectedIds: ReadonlySet<string>;\n  /**\n   * Host-confirmed successes in this review session.\n   */\n  appliedIds: ReadonlySet<string>;\n  /**\n   * Per-proposal field decisions; absent choices remain pending.\n   */\n  decisions: ReadonlyMap<string, ReviewDecisions<TRecord>>;\n  /**\n   * Core batch preflight result for current selection and latest input props.\n   */\n  preparation: PreparedProposalBatch<TRecord>;\n  /**\n   * Whether a handler exists, preparation passes and state is not submitting.\n   */\n  canApply: boolean;\n  /**\n   * Whether the displayed batch is currently running.\n   */\n  isSubmitting: boolean;\n  /**\n   * Current row being applied, or null outside active row work.\n   */\n  activeProposalId: string | null;\n  /**\n   * Generic current-session batch failure message, or null; raw host exceptions are not exposed.\n   */\n  error: string | null;\n  /**\n   * Read-only execution history for this batch session.\n   */\n  history: readonly ExecutionRecord[];\n  /**\n   * Select or deselect an editable known proposal.\n   *\n   * @param id - Proposal identifier.\n   *\n   * @param selected - Desired selection state.\n   *\n   * @returns No value; unknown/applied/busy proposals are ignored.\n   */\n  setSelected(id: string, selected: boolean): void;\n  /**\n   * Change selection for the current items when idle.\n   *\n   * @param selected - True selects all current IDs; false retains only applied IDs in the selection set.\n   *\n   * @returns No value; calls while execution is busy are ignored.\n   */\n  selectAll(selected: boolean): void;\n  /**\n   * Change one existing proposed field while editable.\n   *\n   * @param id - Proposal identifier.\n   *\n   * @param field - Field present in that proposal.\n   *\n   * @param decision - Pending, accepted or rejected choice.\n   *\n   * @returns No value; invalid IDs/fields and busy/applied proposals are ignored.\n   */\n  setDecision(id: string, field: FieldKey<TRecord>, decision: FieldDecision): void;\n  /**\n   * Change every proposed field choice for one editable proposal.\n   *\n   * @param id - Proposal identifier.\n   *\n   * @param decision - Choice applied to all its changes.\n   *\n   * @returns No value; unknown/applied/busy proposals are ignored.\n   */\n  decideAll(id: string, decision: FieldDecision): void;\n  /**\n   * Preflight the selection, then apply rows sequentially with latest-record rechecks.\n   *\n   * @returns True only for current-session complete success; false when blocked, failed, cancelled or superseded.\n   *\n   * @remarks Confirmed successes are retained and skipped on retry; unconfirmed backend effects may still exist.\n   */\n  apply(): Promise<boolean>;\n  /**\n   * Request cooperative cancellation of current execution.\n   *\n   * @returns No value; does not roll back previously applied rows or force host work to stop.\n   */\n  cancel(): void;\n  /**\n   * Clear settled execution history using the session policy.\n   *\n   * @returns No value; does not clear review choices or confirmed applied IDs.\n   */\n  clearHistory(): void;\n}\n\ninterface ReviewState<TRecord extends Record<string, any>> {\n  key: string;\n  session: ExecutionSession;\n  selected: ReadonlySet<string>;\n  applied: ReadonlySet<string>;\n  decisions: ReadonlyMap<string, ReviewDecisions<TRecord>>;\n  running: boolean;\n  active: string | null;\n  error: string | null;\n}\n\nfunction initial<TRecord extends Record<string, any>>(key: string): ReviewState<TRecord> {\n  return {\n    key,\n    session: createExecutionSession(),\n    selected: new Set(),\n    applied: new Set(),\n    decisions: new Map(),\n    running: false,\n    active: null,\n    error: null,\n  };\n}\n\n/**\n * Reviews a batch with explicit field decisions and sequential host application.\n *\n * @typeParam TRecord - Record shape; defaults to a string-keyed record.\n *\n * @param options - Batch identity, unique immutable proposals/latest records, validation and optional host apply callback.\n *\n * @returns Selection/decision controls, preflight state, bounded execution history and cooperative cancellation.\n *\n * @remarks Requires React; no context/styles. Changing batchId or serialized proposal\n * content starts a new session; unmount/session changes request cancellation. Each row\n * is rechecked against latest committed host inputs before apply. Stops at the first\n * failure/cancellation; successes remain excluded from retries. Cancellation cannot\n * undo host effects, so persist idempotently and enforce concurrency/authorization in\n * the backend. A row that changed the backend before rejecting has an uncertain outcome.\n *\n * @example\n * ```tsx\n * import { useProposalBatchReview, type UseProposalBatchReviewOptions } from '@alneas/appkit-react/ai/proposal';\n * type RecordData = { title: string };\n * export function Batch({ options }: { options: UseProposalBatchReviewOptions<RecordData> }) {\n *   const review = useProposalBatchReview(options);\n *   return <button disabled={!review.canApply} onClick={() => { void review.apply(); }}>Apply selected records</button>;\n * }\n * ```\n */\nexport function useProposalBatchReview<TRecord extends Record<string, any> = Record<string, any>>(\n  options: UseProposalBatchReviewOptions<TRecord>\n): UseProposalBatchReviewReturn<TRecord> {\n  const key = JSON.stringify([options.batchId, options.items.map(item => JSON.stringify(item.proposal)).sort()]);\n  const [stored, setStored] = useState(() => initial<TRecord>(key));\n  let state = stored;\n  if (state.key !== key) {\n    state = initial<TRecord>(key);\n    setStored(state);\n  }\n  const session = state.session;\n  const live = useRef<{ session: ExecutionSession; applied: Set<string> } | null>(null);\n  const latest = useRef(options);\n  useLayoutEffect(() => {\n    latest.current = options;\n  });\n  useLayoutEffect(() => {\n    const current = { session, applied: new Set<string>() };\n    live.current = current;\n    return () => {\n      session.cancel();\n      if (live.current === current) live.current = null;\n    };\n  }, [session]);\n\n  const history = useSyncExternalStore(session.subscribe, session.getSnapshot, session.getSnapshot);\n  const busy = () => session.getSnapshot().some(record => record.status === 'running' || record.status === 'cancelling');\n  const update = (change: (current: ReviewState<TRecord>) => ReviewState<TRecord>) => {\n    setStored(current => (current.session === session ? change(current) : current));\n  };\n\n  const entries = (\n    items: readonly ProposalBatchItem<TRecord>[],\n    applied: ReadonlySet<string>\n  ): ProposalBatchEntry<TRecord>[] =>\n    items.map(item => ({\n      ...item,\n      decisions: state.decisions.get(item.proposal.id) ?? ({} as ReviewDecisions<TRecord>),\n      selected: state.selected.has(item.proposal.id) && !applied.has(item.proposal.id),\n    }));\n\n  const preparation = prepareProposalBatch(entries(options.items, state.applied), options.validateCandidate);\n  const editable = (id: string) =>\n    live.current?.session === session && !busy() && !live.current.applied.has(id) && options.items.some(item => item.proposal.id === id);\n\n  const apply = async (): Promise<boolean> => {\n    const current = live.current;\n    if (!current || current.session !== session || busy() || !latest.current.onApply) return false;\n    const planned = prepareProposalBatch(entries(latest.current.items, current.applied), latest.current.validateCandidate);\n    if (!planned.canApply) return false;\n    update(value => ({ ...value, running: true, error: null }));\n    const outcome = await session.run(`一括適用 ${planned.payloads.length} 件`, async context => {\n      context.reportProgress({ completed: 0, total: planned.payloads.length });\n      let completed = 0;\n      for (const payload of planned.payloads) {\n        context.signal.throwIfAborted();\n        if (live.current !== current) throw new DOMException('Review session changed', 'AbortError');\n        const item = latest.current.items.find(value => value.proposal.id === payload.proposalId);\n        if (!item) throw new Error('対象の提案が見つかりません。再確認してください。');\n        const checked = prepareProposalBatch(\n          [{ ...item, selected: true, decisions: state.decisions.get(payload.proposalId) ?? ({} as ReviewDecisions<TRecord>) }],\n          latest.current.validateCandidate\n        );\n        if (!checked.canApply || !latest.current.onApply) {\n          throw new Error('適用前にデータが変更されたため停止しました。再確認してください。');\n        }\n        update(value => ({ ...value, active: payload.proposalId }));\n        await latest.current.onApply(checked.payloads[0], {\n          signal: context.signal,\n          reportProgress(progress) {\n            const fraction =\n              progress.total && Number.isFinite(progress.total) && Number.isFinite(progress.completed)\n                ? Math.max(0, Math.min(1, progress.completed / progress.total))\n                : 0;\n            context.reportProgress({\n              completed: completed + fraction,\n              total: planned.payloads.length,\n              message: progress.message,\n            });\n          },\n        });\n        if (live.current !== current) throw new DOMException('Review session changed', 'AbortError');\n        current.applied.add(payload.proposalId);\n        update(value => ({ ...value, applied: new Set(current.applied) }));\n        context.reportProgress({ completed: ++completed, total: planned.payloads.length });\n      }\n    });\n    if (live.current !== current) return false;\n    update(value => ({\n      ...value,\n      running: false,\n      active: null,\n      error: outcome.status === 'failed' ? '適用に失敗しました。成功済みの提案を除いて再試行できます。' : null,\n    }));\n    return outcome.status === 'succeeded';\n  };\n\n  return {\n    selectedIds: state.selected,\n    appliedIds: state.applied,\n    decisions: state.decisions,\n    preparation,\n    canApply: !!options.onApply && preparation.canApply && !state.running,\n    isSubmitting: state.running,\n    activeProposalId: state.active,\n    error: state.error,\n    history,\n    setSelected(id, selected) {\n      if (!editable(id)) return;\n      update(value => {\n        const next = new Set(value.selected);\n        if (selected) next.add(id);\n        else next.delete(id);\n        return { ...value, selected: next, error: null };\n      });\n    },\n    selectAll(selected) {\n      if (busy()) return;\n      update(value => ({\n        ...value,\n        selected: new Set(selected ? options.items.map(item => item.proposal.id) : value.applied),\n        error: null,\n      }));\n    },\n    setDecision(id, field, decision) {\n      if (!editable(id) || !options.items.find(item => item.proposal.id === id)?.proposal.changes.some(change => change.field === field)) return;\n      update(value => ({\n        ...value,\n        decisions: new Map(value.decisions).set(id, {\n          ...value.decisions.get(id),\n          [field]: decision,\n        } as ReviewDecisions<TRecord>),\n        error: null,\n      }));\n    },\n    decideAll(id, decision) {\n      if (!editable(id)) return;\n      const item = options.items.find(value => value.proposal.id === id)!;\n      update(value => ({\n        ...value,\n        decisions: new Map(value.decisions).set(\n          id,\n          Object.fromEntries(item.proposal.changes.map(change => [change.field, decision])) as ReviewDecisions<TRecord>\n        ),\n        error: null,\n      }));\n    },\n    apply,\n    cancel: session.cancel,\n    clearHistory: session.clearHistory,\n  };\n}\n"],"mappings":"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"}
+{"version":3,"file":"use-proposal-batch-review.cjs","names":["createExecutionSession","useState","useRef","useSyncExternalStore","prepareProposalBatch","react","_alneas_appkit_core_ai","initial","useProposalBatchReview","key","options","item","stored","setStored","state","session","live","latest","current","history","busy","record","update","change","entries","items","applied","preparation","editable","id","next","value","selected","field","decision","planned","outcome","context","completed","payload","checked","fraction","progress"],"sources":["../../../src/ai/proposal/use-proposal-batch-review.ts"],"sourcesContent":["import { useLayoutEffect, useRef, useState, useSyncExternalStore } from 'react';\nimport { createExecutionSession, type ExecutionContext, type ExecutionRecord, type ExecutionSession } from \"@alneas/appkit-core/ai\";\nimport {\n  prepareProposalBatch,\n  type ApplyProposalPayload,\n  type FieldDecision,\n  type FieldKey,\n  type PreparedProposalBatch,\n  type ProposalBatchEntry,\n  type ProposalBatchItem,\n  type ProposalBatchValidator,\n  type ReviewDecisions,\n} from \"@alneas/appkit-core/ai\";\n\n/**\n * Host inputs for reviewing unique immutable proposals across multiple records.\n *\n * @typeParam TRecord - Record shape; defaults to a string-keyed record.\n *\n * @see useProposalBatchReview for usage.\n */\nexport interface UseProposalBatchReviewOptions<TRecord extends Record<string, any> = Record<string, any>> {\n  /** Change for a new review session, including an intentional replay of the same proposals. */\n  batchId: string;\n  /**\n   * Validated proposals and latest records/versions; proposal IDs must be unique.\n   */\n  items: readonly ProposalBatchItem<TRecord>[];\n  /**\n   * Optional synchronous validator passed to Core batch preparation; thrown errors become invalid_candidate issues.\n   */\n  validateCandidate?: ProposalBatchValidator<TRecord>;\n    /**\n     * Sequential host callback receiving one prepared payload and cooperative abort/progress context.\n     *\n     * @param payload - Validated candidate and decisions for one proposal.\n     *\n     * @param context - Abort signal and fractional-progress reporting for this row.\n     *\n     * @returns No value after the host confirms application; reject to stop later rows.\n     */\n  onApply?: (payload: ApplyProposalPayload<TRecord>, context: ExecutionContext) => void | Promise<void>;\n}\n\n/**\n * Batch selection/decision state and explicit execution controls.\n *\n * @typeParam TRecord - Shared record shape; defaults to a string-keyed record.\n *\n * @see useProposalBatchReview for usage.\n */\nexport interface UseProposalBatchReviewReturn<TRecord extends Record<string, any> = Record<string, any>> {\n  /**\n   * Current selected proposal IDs; applied IDs are excluded from preparation.\n   */\n  selectedIds: ReadonlySet<string>;\n  /**\n   * Host-confirmed successes in this review session.\n   */\n  appliedIds: ReadonlySet<string>;\n  /**\n   * Per-proposal field decisions; absent choices remain pending.\n   */\n  decisions: ReadonlyMap<string, ReviewDecisions<TRecord>>;\n  /**\n   * Core batch preflight result for current selection and latest input props.\n   */\n  preparation: PreparedProposalBatch<TRecord>;\n  /**\n   * Whether a handler exists, preparation passes and state is not submitting.\n   */\n  canApply: boolean;\n  /**\n   * Whether the displayed batch is currently running.\n   */\n  isSubmitting: boolean;\n  /**\n   * Current row being applied, or null outside active row work.\n   */\n  activeProposalId: string | null;\n  /**\n   * Generic current-session batch failure message, or null; raw host exceptions are not exposed.\n   */\n  error: string | null;\n  /**\n   * Read-only execution history for this batch session.\n   */\n  history: readonly ExecutionRecord[];\n  /**\n   * Select or deselect an editable known proposal.\n   *\n   * @param id - Proposal identifier.\n   *\n   * @param selected - Desired selection state.\n   *\n   * @returns No value; unknown/applied/busy proposals are ignored.\n   */\n  setSelected(id: string, selected: boolean): void;\n  /**\n   * Change selection for the current items when idle.\n   *\n   * @param selected - True selects all current IDs; false retains only applied IDs in the selection set.\n   *\n   * @returns No value; calls while execution is busy are ignored.\n   */\n  selectAll(selected: boolean): void;\n  /**\n   * Change one existing proposed field while editable.\n   *\n   * @param id - Proposal identifier.\n   *\n   * @param field - Field present in that proposal.\n   *\n   * @param decision - Pending, accepted or rejected choice.\n   *\n   * @returns No value; invalid IDs/fields and busy/applied proposals are ignored.\n   */\n  setDecision(id: string, field: FieldKey<TRecord>, decision: FieldDecision): void;\n  /**\n   * Change every proposed field choice for one editable proposal.\n   *\n   * @param id - Proposal identifier.\n   *\n   * @param decision - Choice applied to all its changes.\n   *\n   * @returns No value; unknown/applied/busy proposals are ignored.\n   */\n  decideAll(id: string, decision: FieldDecision): void;\n  /**\n   * Preflight the selection, then apply rows sequentially with latest-record rechecks.\n   *\n   * @returns True only for current-session complete success; false when blocked, failed, cancelled or superseded.\n   *\n   * @remarks Confirmed successes are retained and skipped on retry; unconfirmed backend effects may still exist.\n   */\n  apply(): Promise<boolean>;\n  /**\n   * Request cooperative cancellation of current execution.\n   *\n   * @returns No value; does not roll back previously applied rows or force host work to stop.\n   */\n  cancel(): void;\n  /**\n   * Clear settled execution history using the session policy.\n   *\n   * @returns No value; does not clear review choices or confirmed applied IDs.\n   */\n  clearHistory(): void;\n}\n\ninterface ReviewState<TRecord extends Record<string, any>> {\n  key: string;\n  session: ExecutionSession;\n  selected: ReadonlySet<string>;\n  applied: ReadonlySet<string>;\n  decisions: ReadonlyMap<string, ReviewDecisions<TRecord>>;\n  running: boolean;\n  active: string | null;\n  error: string | null;\n}\n\nfunction initial<TRecord extends Record<string, any>>(key: string): ReviewState<TRecord> {\n  return {\n    key,\n    session: createExecutionSession(),\n    selected: new Set(),\n    applied: new Set(),\n    decisions: new Map(),\n    running: false,\n    active: null,\n    error: null,\n  };\n}\n\n/**\n * Reviews a batch with explicit field decisions and sequential host application.\n *\n * @typeParam TRecord - Record shape; defaults to a string-keyed record.\n *\n * @param options - Batch identity, unique immutable proposals/latest records, validation and optional host apply callback.\n *\n * @returns Selection/decision controls, preflight state, bounded execution history and cooperative cancellation.\n *\n * @remarks Requires React; no context/styles. Changing batchId or serialized proposal\n * content starts a new session; unmount/session changes request cancellation. Each row\n * is rechecked against latest committed host inputs before apply. Stops at the first\n * failure/cancellation; successes remain excluded from retries. Cancellation cannot\n * undo host effects, so persist idempotently and enforce concurrency/authorization in\n * the backend. A row that changed the backend before rejecting has an uncertain outcome.\n * Keep the ref/layout-effect bridge for latest host inputs: the returned apply control\n * can be called by UI event handlers and other host code outside Effect logic.\n * useEffectEvent is restricted to Effect-originated callbacks and cannot replace this\n * externally callable execution path. The ref is not a React 18 compatibility shim.\n *\n * @example\n * ```tsx\n * import { useProposalBatchReview, type UseProposalBatchReviewOptions } from '@alneas/appkit-react/ai/proposal';\n * type RecordData = { title: string };\n * export function Batch({ options }: { options: UseProposalBatchReviewOptions<RecordData> }) {\n *   const review = useProposalBatchReview(options);\n *   return <button disabled={!review.canApply} onClick={() => { void review.apply(); }}>Apply selected records</button>;\n * }\n * ```\n */\nexport function useProposalBatchReview<TRecord extends Record<string, any> = Record<string, any>>(\n  options: UseProposalBatchReviewOptions<TRecord>\n): UseProposalBatchReviewReturn<TRecord> {\n  const key = JSON.stringify([options.batchId, options.items.map(item => JSON.stringify(item.proposal)).sort()]);\n  const [stored, setStored] = useState(() => initial<TRecord>(key));\n  let state = stored;\n  if (state.key !== key) {\n    state = initial<TRecord>(key);\n    setStored(state);\n  }\n  const session = state.session;\n  const live = useRef<{ session: ExecutionSession; applied: Set<string> } | null>(null);\n  const latest = useRef(options);\n  useLayoutEffect(() => {\n    latest.current = options;\n  });\n  useLayoutEffect(() => {\n    const current = { session, applied: new Set<string>() };\n    live.current = current;\n    return () => {\n      session.cancel();\n      if (live.current === current) live.current = null;\n    };\n  }, [session]);\n\n  const history = useSyncExternalStore(session.subscribe, session.getSnapshot, session.getSnapshot);\n  const busy = () => session.getSnapshot().some(record => record.status === 'running' || record.status === 'cancelling');\n  const update = (change: (current: ReviewState<TRecord>) => ReviewState<TRecord>) => {\n    setStored(current => (current.session === session ? change(current) : current));\n  };\n\n  const entries = (\n    items: readonly ProposalBatchItem<TRecord>[],\n    applied: ReadonlySet<string>\n  ): ProposalBatchEntry<TRecord>[] =>\n    items.map(item => ({\n      ...item,\n      decisions: state.decisions.get(item.proposal.id) ?? ({} as ReviewDecisions<TRecord>),\n      selected: state.selected.has(item.proposal.id) && !applied.has(item.proposal.id),\n    }));\n\n  const preparation = prepareProposalBatch(entries(options.items, state.applied), options.validateCandidate);\n  const editable = (id: string) =>\n    live.current?.session === session && !busy() && !live.current.applied.has(id) && options.items.some(item => item.proposal.id === id);\n\n  const apply = async (): Promise<boolean> => {\n    const current = live.current;\n    if (!current || current.session !== session || busy() || !latest.current.onApply) return false;\n    const planned = prepareProposalBatch(entries(latest.current.items, current.applied), latest.current.validateCandidate);\n    if (!planned.canApply) return false;\n    update(value => ({ ...value, running: true, error: null }));\n    const outcome = await session.run(`一括適用 ${planned.payloads.length} 件`, async context => {\n      context.reportProgress({ completed: 0, total: planned.payloads.length });\n      let completed = 0;\n      for (const payload of planned.payloads) {\n        context.signal.throwIfAborted();\n        if (live.current !== current) throw new DOMException('Review session changed', 'AbortError');\n        const item = latest.current.items.find(value => value.proposal.id === payload.proposalId);\n        if (!item) throw new Error('対象の提案が見つかりません。再確認してください。');\n        const checked = prepareProposalBatch(\n          [{ ...item, selected: true, decisions: state.decisions.get(payload.proposalId) ?? ({} as ReviewDecisions<TRecord>) }],\n          latest.current.validateCandidate\n        );\n        if (!checked.canApply || !latest.current.onApply) {\n          throw new Error('適用前にデータが変更されたため停止しました。再確認してください。');\n        }\n        update(value => ({ ...value, active: payload.proposalId }));\n        await latest.current.onApply(checked.payloads[0], {\n          signal: context.signal,\n          reportProgress(progress) {\n            const fraction =\n              progress.total && Number.isFinite(progress.total) && Number.isFinite(progress.completed)\n                ? Math.max(0, Math.min(1, progress.completed / progress.total))\n                : 0;\n            context.reportProgress({\n              completed: completed + fraction,\n              total: planned.payloads.length,\n              message: progress.message,\n            });\n          },\n        });\n        if (live.current !== current) throw new DOMException('Review session changed', 'AbortError');\n        current.applied.add(payload.proposalId);\n        update(value => ({ ...value, applied: new Set(current.applied) }));\n        context.reportProgress({ completed: ++completed, total: planned.payloads.length });\n      }\n    });\n    if (live.current !== current) return false;\n    update(value => ({\n      ...value,\n      running: false,\n      active: null,\n      error: outcome.status === 'failed' ? '適用に失敗しました。成功済みの提案を除いて再試行できます。' : null,\n    }));\n    return outcome.status === 'succeeded';\n  };\n\n  return {\n    selectedIds: state.selected,\n    appliedIds: state.applied,\n    decisions: state.decisions,\n    preparation,\n    canApply: !!options.onApply && preparation.canApply && !state.running,\n    isSubmitting: state.running,\n    activeProposalId: state.active,\n    error: state.error,\n    history,\n    setSelected(id, selected) {\n      if (!editable(id)) return;\n      update(value => {\n        const next = new Set(value.selected);\n        if (selected) next.add(id);\n        else next.delete(id);\n        return { ...value, selected: next, error: null };\n      });\n    },\n    selectAll(selected) {\n      if (busy()) return;\n      update(value => ({\n        ...value,\n        selected: new Set(selected ? options.items.map(item => item.proposal.id) : value.applied),\n        error: null,\n      }));\n    },\n    setDecision(id, field, decision) {\n      if (!editable(id) || !options.items.find(item => item.proposal.id === id)?.proposal.changes.some(change => change.field === field)) return;\n      update(value => ({\n        ...value,\n        decisions: new Map(value.decisions).set(id, {\n          ...value.decisions.get(id),\n          [field]: decision,\n        } as ReviewDecisions<TRecord>),\n        error: null,\n      }));\n    },\n    decideAll(id, decision) {\n      if (!editable(id)) return;\n      const item = options.items.find(value => value.proposal.id === id)!;\n      update(value => ({\n        ...value,\n        decisions: new Map(value.decisions).set(\n          id,\n          Object.fromEntries(item.proposal.changes.map(change => [change.field, decision])) as ReviewDecisions<TRecord>\n        ),\n        error: null,\n      }));\n    },\n    apply,\n    cancel: session.cancel,\n    clearHistory: session.clearHistory,\n  };\n}\n"],"mappings":"A,2IAiKA,SAASO,EAA6C,EAAmC,CACvF,MAAO,CACL,MACA,SAAA,EAASP,EAAAA,uBAAAA,CAAuB,EAChC,SAAU,IAAI,IACd,QAAS,IAAI,IACb,UAAW,IAAI,IACf,QAAS,GACT,OAAQ,KACR,MAAO,IACT,CACF,CAgCA,SAAgBQ,EACd,EACuC,CACvC,IAAMC,EAAM,KAAK,UAAU,CAACC,EAAQ,QAASA,EAAQ,MAAM,IAAI,GAAQ,KAAK,UAAUC,EAAK,QAAQ,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,EACvG,CAACC,EAAQC,IAAA,EAAaZ,EAAAA,SAAAA,KAAeM,EAAiBE,CAAG,CAAC,EAC5DK,EAAQF,EACRE,EAAM,MAAQL,IAChB,EAAQF,EAAiBE,CAAG,EAC5BI,EAAUC,CAAK,GAEjB,IAAMC,EAAUD,EAAM,QAChBE,GAAA,EAAOd,EAAAA,OAAAA,CAAmE,IAAI,EAC9Ee,GAAA,EAASf,EAAAA,OAAAA,CAAOQ,CAAO,GAC7B,EAAAL,EAAA,gBAAA,KAAsB,CACpB,EAAO,QAAUK,CACnB,CAAC,GACD,EAAAL,EAAA,gBAAA,KAAsB,CACpB,IAAMa,EAAU,CAAE,UAAS,QAAS,IAAI,GAAc,EAEtD,MADA,GAAK,QAAUA,MACF,CACXH,EAAQ,OAAO,EACXC,EAAK,UAAYE,IAAS,EAAK,QAAU,KAC/C,CACF,EAAG,CAACH,CAAO,CAAC,EAEZ,IAAMI,GAAA,EAAUhB,EAAAA,qBAAAA,CAAqBY,EAAQ,UAAWA,EAAQ,YAAaA,EAAQ,WAAW,EAC1FK,MAAaL,EAAQ,YAAY,CAAC,CAAC,KAAK,GAAUM,EAAO,SAAW,WAAaA,EAAO,SAAW,YAAY,EAC/GC,EAAU,GAAoE,CAClFT,EAAU,GAAYK,EAAQ,UAAYH,EAAUQ,EAAOL,CAAO,EAAIA,CAAQ,CAChF,EAEMM,GACJ,EACA,IAEAC,EAAM,IAAI,IAAS,CACjB,GAAGd,EACH,UAAWG,EAAM,UAAU,IAAIH,EAAK,SAAS,EAAE,GAAM,CAAC,EACtD,SAAUG,EAAM,SAAS,IAAIH,EAAK,SAAS,EAAE,GAAK,CAACe,EAAQ,IAAIf,EAAK,SAAS,EAAE,CACjF,EAAE,EAEEgB,GAAA,EAAcvB,EAAAA,qBAAAA,CAAqBoB,EAAQd,EAAQ,MAAOI,EAAM,OAAO,EAAGJ,EAAQ,iBAAiB,EACnGkB,EAAY,GAChBZ,EAAK,SAAS,UAAYD,GAAW,CAACK,EAAK,GAAK,CAACJ,EAAK,QAAQ,QAAQ,IAAIa,CAAE,GAAKnB,EAAQ,MAAM,KAAK,GAAQC,EAAK,SAAS,KAAOkB,CAAE,EAsDrI,MAAO,CACL,YAAaf,EAAM,SACnB,WAAYA,EAAM,QAClB,UAAWA,EAAM,UACjB,cACA,SAAU,CAAC,CAACJ,EAAQ,SAAWiB,EAAY,UAAY,CAACb,EAAM,QAC9D,aAAcA,EAAM,QACpB,iBAAkBA,EAAM,OACxB,MAAOA,EAAM,MACb,UACA,YAAY,EAAI,EAAU,CACnBc,EAASC,CAAE,GAChBP,EAAO,GAAS,CACd,IAAMQ,EAAO,IAAI,IAAIC,EAAM,QAAQ,EAGnC,OAFIC,EAAUF,EAAK,IAAID,CAAE,EACpBC,EAAK,OAAOD,CAAE,EACZ,CAAE,GAAGE,EAAO,SAAUD,EAAM,MAAO,IAAK,CACjD,CAAC,CACH,EACA,UAAU,EAAU,CACdV,EAAK,GACTE,EAAO,IAAU,CACf,GAAGS,EACH,SAAU,IAAI,IAAIC,EAAWtB,EAAQ,MAAM,IAAI,GAAQC,EAAK,SAAS,EAAE,EAAIoB,EAAM,OAAO,EACxF,MAAO,IACT,EAAE,CACJ,EACA,YAAY,EAAI,EAAO,EAAU,CAC1BH,EAASC,CAAE,GAAMnB,EAAQ,MAAM,KAAK,GAAQC,EAAK,SAAS,KAAOkB,CAAE,CAAC,EAAE,SAAS,QAAQ,KAAK,GAAUN,EAAO,QAAUU,CAAK,GACjIX,EAAO,IAAU,CACf,GAAGS,EACH,UAAW,IAAI,IAAIA,EAAM,SAAS,CAAC,CAAC,IAAIF,EAAI,CAC1C,GAAGE,EAAM,UAAU,IAAIF,CAAE,GACxBI,GAAQC,CACX,CAA6B,EAC7B,MAAO,IACT,EAAE,CACJ,EACA,UAAU,EAAI,EAAU,CACtB,GAAI,CAACN,EAASC,CAAE,EAAG,OACnB,IAAMlB,EAAOD,EAAQ,MAAM,KAAK,GAASqB,EAAM,SAAS,KAAOF,CAAE,EACjEP,EAAO,IAAU,CACf,GAAGS,EACH,UAAW,IAAI,IAAIA,EAAM,SAAS,CAAC,CAAC,IAClCF,EACA,OAAO,YAAYlB,EAAK,SAAS,QAAQ,IAAI,GAAU,CAACY,EAAO,MAAOW,CAAQ,CAAC,CAAC,CAClF,EACA,MAAO,IACT,EAAE,CACJ,EACA,eAtG0C,CAC1C,IAAMhB,EAAUF,EAAK,QACrB,GAAI,CAACE,GAAWA,EAAQ,UAAYH,GAAWK,EAAK,GAAK,CAACH,EAAO,QAAQ,QAAS,MAAO,GACzF,IAAMkB,GAAA,EAAU/B,EAAAA,qBAAAA,CAAqBoB,EAAQP,EAAO,QAAQ,MAAOC,EAAQ,OAAO,EAAGD,EAAO,QAAQ,iBAAiB,EACrH,GAAI,CAACkB,EAAQ,SAAU,MAAO,GAC9Bb,EAAO,IAAU,CAAE,GAAGS,EAAO,QAAS,GAAM,MAAO,IAAK,EAAE,EAC1D,IAAMK,EAAU,MAAMrB,EAAQ,IAAI,QAAQoB,EAAQ,SAAS,OAAO,IAAK,KAAM,IAAW,CACtFE,EAAQ,eAAe,CAAE,UAAW,EAAG,MAAOF,EAAQ,SAAS,MAAO,CAAC,EACvE,IAAIG,EAAY,EAChB,IAAK,IAAMC,KAAWJ,EAAQ,SAAU,CAEtC,GADAE,EAAQ,OAAO,eAAe,EAC1BrB,EAAK,UAAYE,EAAS,MAAM,IAAI,aAAa,yBAA0B,YAAY,EAC3F,IAAMP,EAAOM,EAAO,QAAQ,MAAM,KAAK,GAASc,EAAM,SAAS,KAAOQ,EAAQ,UAAU,EACxF,GAAI,CAAC5B,EAAM,MAAU,MAAM,0BAA0B,EACrD,IAAM6B,GAAA,EAAUpC,EAAAA,qBAAAA,CACd,CAAC,CAAE,GAAGO,EAAM,SAAU,GAAM,UAAWG,EAAM,UAAU,IAAIyB,EAAQ,UAAU,GAAM,CAAC,CAA+B,CAAC,EACpHtB,EAAO,QAAQ,iBACjB,EACA,GAAI,CAACuB,EAAQ,UAAY,CAACvB,EAAO,QAAQ,QACvC,MAAU,MAAM,kCAAkC,EAiBpD,GAfAK,EAAO,IAAU,CAAE,GAAGS,EAAO,OAAQQ,EAAQ,UAAW,EAAE,EAC1D,MAAMtB,EAAO,QAAQ,QAAQuB,EAAQ,SAAS,GAAI,CAChD,OAAQH,EAAQ,OAChB,eAAe,EAAU,CACvB,IAAMI,EACJC,EAAS,OAAS,OAAO,SAASA,EAAS,KAAK,GAAK,OAAO,SAASA,EAAS,SAAS,EACnF,KAAK,IAAI,EAAG,KAAK,IAAI,EAAGA,EAAS,UAAYA,EAAS,KAAK,CAAC,EAC5D,EACNL,EAAQ,eAAe,CACrB,UAAWC,EAAYG,EACvB,MAAON,EAAQ,SAAS,OACxB,QAASO,EAAS,OACpB,CAAC,CACH,CACF,CAAC,EACG1B,EAAK,UAAYE,EAAS,MAAM,IAAI,aAAa,yBAA0B,YAAY,EAC3FA,EAAQ,QAAQ,IAAIqB,EAAQ,UAAU,EACtCjB,EAAO,IAAU,CAAE,GAAGS,EAAO,QAAS,IAAI,IAAIb,EAAQ,OAAO,CAAE,EAAE,EACjEmB,EAAQ,eAAe,CAAE,UAAW,EAAEC,EAAW,MAAOH,EAAQ,SAAS,MAAO,CAAC,CACnF,CACF,CAAC,EAQD,OAPInB,EAAK,UAAYE,IACrBI,EAAO,IAAU,CACf,GAAGS,EACH,QAAS,GACT,OAAQ,KACR,MAAOK,EAAQ,SAAW,SAAW,gCAAkC,IACzE,EAAE,EACKA,EAAQ,SAAW,YAC5B,EAqDE,OAAQrB,EAAQ,OAChB,aAAcA,EAAQ,YACxB,CACF,C"}

package/dist/ai/proposal/use-proposal-batch-review.d.cts

@@ -148,6 +148,10 @@ export interface UseProposalBatchReviewReturn<TRecord extends Record<string, any
  * failure/cancellation; successes remain excluded from retries. Cancellation cannot
  * undo host effects, so persist idempotently and enforce concurrency/authorization in
  * the backend. A row that changed the backend before rejecting has an uncertain outcome.
+ * Keep the ref/layout-effect bridge for latest host inputs: the returned apply control
+ * can be called by UI event handlers and other host code outside Effect logic.
+ * useEffectEvent is restricted to Effect-originated callbacks and cannot replace this
+ * externally callable execution path. The ref is not a React 18 compatibility shim.
  *
  * @example
  * ```tsx

package/dist/ai/proposal/use-proposal-batch-review.d.ts

@@ -148,6 +148,10 @@ export interface UseProposalBatchReviewReturn<TRecord extends Record<string, any
  * failure/cancellation; successes remain excluded from retries. Cancellation cannot
  * undo host effects, so persist idempotently and enforce concurrency/authorization in
  * the backend. A row that changed the backend before rejecting has an uncertain outcome.
+ * Keep the ref/layout-effect bridge for latest host inputs: the returned apply control
+ * can be called by UI event handlers and other host code outside Effect logic.
+ * useEffectEvent is restricted to Effect-originated callbacks and cannot replace this
+ * externally callable execution path. The ref is not a React 18 compatibility shim.
  *
  * @example
  * ```tsx

package/dist/ai/proposal/use-proposal-batch-review.js.map

@@ -1 +1 @@
-{"version":3,"file":"use-proposal-batch-review.js","names":["initial","createExecutionSession","useProposalBatchReview","key","options","item","stored","setStored","useState","state","session","live","useRef","latest","useLayoutEffect","current","history","useSyncExternalStore","busy","record","update","change","entries","items","applied","preparation","prepareProposalBatch","editable","id","next","value","selected","field","decision","planned","outcome","completed","payload","context","checked","fraction","progress"],"sources":["../../../src/ai/proposal/use-proposal-batch-review.ts"],"sourcesContent":["import { useLayoutEffect, useRef, useState, useSyncExternalStore } from 'react';\nimport { createExecutionSession, type ExecutionContext, type ExecutionRecord, type ExecutionSession } from \"@alneas/appkit-core/ai\";\nimport {\n  prepareProposalBatch,\n  type ApplyProposalPayload,\n  type FieldDecision,\n  type FieldKey,\n  type PreparedProposalBatch,\n  type ProposalBatchEntry,\n  type ProposalBatchItem,\n  type ProposalBatchValidator,\n  type ReviewDecisions,\n} from \"@alneas/appkit-core/ai\";\n\n/**\n * Host inputs for reviewing unique immutable proposals across multiple records.\n *\n * @typeParam TRecord - Record shape; defaults to a string-keyed record.\n *\n * @see useProposalBatchReview for usage.\n */\nexport interface UseProposalBatchReviewOptions<TRecord extends Record<string, any> = Record<string, any>> {\n  /** Change for a new review session, including an intentional replay of the same proposals. */\n  batchId: string;\n  /**\n   * Validated proposals and latest records/versions; proposal IDs must be unique.\n   */\n  items: readonly ProposalBatchItem<TRecord>[];\n  /**\n   * Optional synchronous validator passed to Core batch preparation; thrown errors become invalid_candidate issues.\n   */\n  validateCandidate?: ProposalBatchValidator<TRecord>;\n    /**\n     * Sequential host callback receiving one prepared payload and cooperative abort/progress context.\n     *\n     * @param payload - Validated candidate and decisions for one proposal.\n     *\n     * @param context - Abort signal and fractional-progress reporting for this row.\n     *\n     * @returns No value after the host confirms application; reject to stop later rows.\n     */\n  onApply?: (payload: ApplyProposalPayload<TRecord>, context: ExecutionContext) => void | Promise<void>;\n}\n\n/**\n * Batch selection/decision state and explicit execution controls.\n *\n * @typeParam TRecord - Shared record shape; defaults to a string-keyed record.\n *\n * @see useProposalBatchReview for usage.\n */\nexport interface UseProposalBatchReviewReturn<TRecord extends Record<string, any> = Record<string, any>> {\n  /**\n   * Current selected proposal IDs; applied IDs are excluded from preparation.\n   */\n  selectedIds: ReadonlySet<string>;\n  /**\n   * Host-confirmed successes in this review session.\n   */\n  appliedIds: ReadonlySet<string>;\n  /**\n   * Per-proposal field decisions; absent choices remain pending.\n   */\n  decisions: ReadonlyMap<string, ReviewDecisions<TRecord>>;\n  /**\n   * Core batch preflight result for current selection and latest input props.\n   */\n  preparation: PreparedProposalBatch<TRecord>;\n  /**\n   * Whether a handler exists, preparation passes and state is not submitting.\n   */\n  canApply: boolean;\n  /**\n   * Whether the displayed batch is currently running.\n   */\n  isSubmitting: boolean;\n  /**\n   * Current row being applied, or null outside active row work.\n   */\n  activeProposalId: string | null;\n  /**\n   * Generic current-session batch failure message, or null; raw host exceptions are not exposed.\n   */\n  error: string | null;\n  /**\n   * Read-only execution history for this batch session.\n   */\n  history: readonly ExecutionRecord[];\n  /**\n   * Select or deselect an editable known proposal.\n   *\n   * @param id - Proposal identifier.\n   *\n   * @param selected - Desired selection state.\n   *\n   * @returns No value; unknown/applied/busy proposals are ignored.\n   */\n  setSelected(id: string, selected: boolean): void;\n  /**\n   * Change selection for the current items when idle.\n   *\n   * @param selected - True selects all current IDs; false retains only applied IDs in the selection set.\n   *\n   * @returns No value; calls while execution is busy are ignored.\n   */\n  selectAll(selected: boolean): void;\n  /**\n   * Change one existing proposed field while editable.\n   *\n   * @param id - Proposal identifier.\n   *\n   * @param field - Field present in that proposal.\n   *\n   * @param decision - Pending, accepted or rejected choice.\n   *\n   * @returns No value; invalid IDs/fields and busy/applied proposals are ignored.\n   */\n  setDecision(id: string, field: FieldKey<TRecord>, decision: FieldDecision): void;\n  /**\n   * Change every proposed field choice for one editable proposal.\n   *\n   * @param id - Proposal identifier.\n   *\n   * @param decision - Choice applied to all its changes.\n   *\n   * @returns No value; unknown/applied/busy proposals are ignored.\n   */\n  decideAll(id: string, decision: FieldDecision): void;\n  /**\n   * Preflight the selection, then apply rows sequentially with latest-record rechecks.\n   *\n   * @returns True only for current-session complete success; false when blocked, failed, cancelled or superseded.\n   *\n   * @remarks Confirmed successes are retained and skipped on retry; unconfirmed backend effects may still exist.\n   */\n  apply(): Promise<boolean>;\n  /**\n   * Request cooperative cancellation of current execution.\n   *\n   * @returns No value; does not roll back previously applied rows or force host work to stop.\n   */\n  cancel(): void;\n  /**\n   * Clear settled execution history using the session policy.\n   *\n   * @returns No value; does not clear review choices or confirmed applied IDs.\n   */\n  clearHistory(): void;\n}\n\ninterface ReviewState<TRecord extends Record<string, any>> {\n  key: string;\n  session: ExecutionSession;\n  selected: ReadonlySet<string>;\n  applied: ReadonlySet<string>;\n  decisions: ReadonlyMap<string, ReviewDecisions<TRecord>>;\n  running: boolean;\n  active: string | null;\n  error: string | null;\n}\n\nfunction initial<TRecord extends Record<string, any>>(key: string): ReviewState<TRecord> {\n  return {\n    key,\n    session: createExecutionSession(),\n    selected: new Set(),\n    applied: new Set(),\n    decisions: new Map(),\n    running: false,\n    active: null,\n    error: null,\n  };\n}\n\n/**\n * Reviews a batch with explicit field decisions and sequential host application.\n *\n * @typeParam TRecord - Record shape; defaults to a string-keyed record.\n *\n * @param options - Batch identity, unique immutable proposals/latest records, validation and optional host apply callback.\n *\n * @returns Selection/decision controls, preflight state, bounded execution history and cooperative cancellation.\n *\n * @remarks Requires React; no context/styles. Changing batchId or serialized proposal\n * content starts a new session; unmount/session changes request cancellation. Each row\n * is rechecked against latest committed host inputs before apply. Stops at the first\n * failure/cancellation; successes remain excluded from retries. Cancellation cannot\n * undo host effects, so persist idempotently and enforce concurrency/authorization in\n * the backend. A row that changed the backend before rejecting has an uncertain outcome.\n *\n * @example\n * ```tsx\n * import { useProposalBatchReview, type UseProposalBatchReviewOptions } from '@alneas/appkit-react/ai/proposal';\n * type RecordData = { title: string };\n * export function Batch({ options }: { options: UseProposalBatchReviewOptions<RecordData> }) {\n *   const review = useProposalBatchReview(options);\n *   return <button disabled={!review.canApply} onClick={() => { void review.apply(); }}>Apply selected records</button>;\n * }\n * ```\n */\nexport function useProposalBatchReview<TRecord extends Record<string, any> = Record<string, any>>(\n  options: UseProposalBatchReviewOptions<TRecord>\n): UseProposalBatchReviewReturn<TRecord> {\n  const key = JSON.stringify([options.batchId, options.items.map(item => JSON.stringify(item.proposal)).sort()]);\n  const [stored, setStored] = useState(() => initial<TRecord>(key));\n  let state = stored;\n  if (state.key !== key) {\n    state = initial<TRecord>(key);\n    setStored(state);\n  }\n  const session = state.session;\n  const live = useRef<{ session: ExecutionSession; applied: Set<string> } | null>(null);\n  const latest = useRef(options);\n  useLayoutEffect(() => {\n    latest.current = options;\n  });\n  useLayoutEffect(() => {\n    const current = { session, applied: new Set<string>() };\n    live.current = current;\n    return () => {\n      session.cancel();\n      if (live.current === current) live.current = null;\n    };\n  }, [session]);\n\n  const history = useSyncExternalStore(session.subscribe, session.getSnapshot, session.getSnapshot);\n  const busy = () => session.getSnapshot().some(record => record.status === 'running' || record.status === 'cancelling');\n  const update = (change: (current: ReviewState<TRecord>) => ReviewState<TRecord>) => {\n    setStored(current => (current.session === session ? change(current) : current));\n  };\n\n  const entries = (\n    items: readonly ProposalBatchItem<TRecord>[],\n    applied: ReadonlySet<string>\n  ): ProposalBatchEntry<TRecord>[] =>\n    items.map(item => ({\n      ...item,\n      decisions: state.decisions.get(item.proposal.id) ?? ({} as ReviewDecisions<TRecord>),\n      selected: state.selected.has(item.proposal.id) && !applied.has(item.proposal.id),\n    }));\n\n  const preparation = prepareProposalBatch(entries(options.items, state.applied), options.validateCandidate);\n  const editable = (id: string) =>\n    live.current?.session === session && !busy() && !live.current.applied.has(id) && options.items.some(item => item.proposal.id === id);\n\n  const apply = async (): Promise<boolean> => {\n    const current = live.current;\n    if (!current || current.session !== session || busy() || !latest.current.onApply) return false;\n    const planned = prepareProposalBatch(entries(latest.current.items, current.applied), latest.current.validateCandidate);\n    if (!planned.canApply) return false;\n    update(value => ({ ...value, running: true, error: null }));\n    const outcome = await session.run(`一括適用 ${planned.payloads.length} 件`, async context => {\n      context.reportProgress({ completed: 0, total: planned.payloads.length });\n      let completed = 0;\n      for (const payload of planned.payloads) {\n        context.signal.throwIfAborted();\n        if (live.current !== current) throw new DOMException('Review session changed', 'AbortError');\n        const item = latest.current.items.find(value => value.proposal.id === payload.proposalId);\n        if (!item) throw new Error('対象の提案が見つかりません。再確認してください。');\n        const checked = prepareProposalBatch(\n          [{ ...item, selected: true, decisions: state.decisions.get(payload.proposalId) ?? ({} as ReviewDecisions<TRecord>) }],\n          latest.current.validateCandidate\n        );\n        if (!checked.canApply || !latest.current.onApply) {\n          throw new Error('適用前にデータが変更されたため停止しました。再確認してください。');\n        }\n        update(value => ({ ...value, active: payload.proposalId }));\n        await latest.current.onApply(checked.payloads[0], {\n          signal: context.signal,\n          reportProgress(progress) {\n            const fraction =\n              progress.total && Number.isFinite(progress.total) && Number.isFinite(progress.completed)\n                ? Math.max(0, Math.min(1, progress.completed / progress.total))\n                : 0;\n            context.reportProgress({\n              completed: completed + fraction,\n              total: planned.payloads.length,\n              message: progress.message,\n            });\n          },\n        });\n        if (live.current !== current) throw new DOMException('Review session changed', 'AbortError');\n        current.applied.add(payload.proposalId);\n        update(value => ({ ...value, applied: new Set(current.applied) }));\n        context.reportProgress({ completed: ++completed, total: planned.payloads.length });\n      }\n    });\n    if (live.current !== current) return false;\n    update(value => ({\n      ...value,\n      running: false,\n      active: null,\n      error: outcome.status === 'failed' ? '適用に失敗しました。成功済みの提案を除いて再試行できます。' : null,\n    }));\n    return outcome.status === 'succeeded';\n  };\n\n  return {\n    selectedIds: state.selected,\n    appliedIds: state.applied,\n    decisions: state.decisions,\n    preparation,\n    canApply: !!options.onApply && preparation.canApply && !state.running,\n    isSubmitting: state.running,\n    activeProposalId: state.active,\n    error: state.error,\n    history,\n    setSelected(id, selected) {\n      if (!editable(id)) return;\n      update(value => {\n        const next = new Set(value.selected);\n        if (selected) next.add(id);\n        else next.delete(id);\n        return { ...value, selected: next, error: null };\n      });\n    },\n    selectAll(selected) {\n      if (busy()) return;\n      update(value => ({\n        ...value,\n        selected: new Set(selected ? options.items.map(item => item.proposal.id) : value.applied),\n        error: null,\n      }));\n    },\n    setDecision(id, field, decision) {\n      if (!editable(id) || !options.items.find(item => item.proposal.id === id)?.proposal.changes.some(change => change.field === field)) return;\n      update(value => ({\n        ...value,\n        decisions: new Map(value.decisions).set(id, {\n          ...value.decisions.get(id),\n          [field]: decision,\n        } as ReviewDecisions<TRecord>),\n        error: null,\n      }));\n    },\n    decideAll(id, decision) {\n      if (!editable(id)) return;\n      const item = options.items.find(value => value.proposal.id === id)!;\n      update(value => ({\n        ...value,\n        decisions: new Map(value.decisions).set(\n          id,\n          Object.fromEntries(item.proposal.changes.map(change => [change.field, decision])) as ReviewDecisions<TRecord>\n        ),\n        error: null,\n      }));\n    },\n    apply,\n    cancel: session.cancel,\n    clearHistory: session.clearHistory,\n  };\n}\n"],"mappings":"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"}
+{"version":3,"file":"use-proposal-batch-review.js","names":["initial","createExecutionSession","useProposalBatchReview","key","options","item","stored","setStored","useState","state","session","live","useRef","latest","useLayoutEffect","current","history","useSyncExternalStore","busy","record","update","change","entries","items","applied","preparation","prepareProposalBatch","editable","id","next","value","selected","field","decision","planned","outcome","completed","payload","context","checked","fraction","progress"],"sources":["../../../src/ai/proposal/use-proposal-batch-review.ts"],"sourcesContent":["import { useLayoutEffect, useRef, useState, useSyncExternalStore } from 'react';\nimport { createExecutionSession, type ExecutionContext, type ExecutionRecord, type ExecutionSession } from \"@alneas/appkit-core/ai\";\nimport {\n  prepareProposalBatch,\n  type ApplyProposalPayload,\n  type FieldDecision,\n  type FieldKey,\n  type PreparedProposalBatch,\n  type ProposalBatchEntry,\n  type ProposalBatchItem,\n  type ProposalBatchValidator,\n  type ReviewDecisions,\n} from \"@alneas/appkit-core/ai\";\n\n/**\n * Host inputs for reviewing unique immutable proposals across multiple records.\n *\n * @typeParam TRecord - Record shape; defaults to a string-keyed record.\n *\n * @see useProposalBatchReview for usage.\n */\nexport interface UseProposalBatchReviewOptions<TRecord extends Record<string, any> = Record<string, any>> {\n  /** Change for a new review session, including an intentional replay of the same proposals. */\n  batchId: string;\n  /**\n   * Validated proposals and latest records/versions; proposal IDs must be unique.\n   */\n  items: readonly ProposalBatchItem<TRecord>[];\n  /**\n   * Optional synchronous validator passed to Core batch preparation; thrown errors become invalid_candidate issues.\n   */\n  validateCandidate?: ProposalBatchValidator<TRecord>;\n    /**\n     * Sequential host callback receiving one prepared payload and cooperative abort/progress context.\n     *\n     * @param payload - Validated candidate and decisions for one proposal.\n     *\n     * @param context - Abort signal and fractional-progress reporting for this row.\n     *\n     * @returns No value after the host confirms application; reject to stop later rows.\n     */\n  onApply?: (payload: ApplyProposalPayload<TRecord>, context: ExecutionContext) => void | Promise<void>;\n}\n\n/**\n * Batch selection/decision state and explicit execution controls.\n *\n * @typeParam TRecord - Shared record shape; defaults to a string-keyed record.\n *\n * @see useProposalBatchReview for usage.\n */\nexport interface UseProposalBatchReviewReturn<TRecord extends Record<string, any> = Record<string, any>> {\n  /**\n   * Current selected proposal IDs; applied IDs are excluded from preparation.\n   */\n  selectedIds: ReadonlySet<string>;\n  /**\n   * Host-confirmed successes in this review session.\n   */\n  appliedIds: ReadonlySet<string>;\n  /**\n   * Per-proposal field decisions; absent choices remain pending.\n   */\n  decisions: ReadonlyMap<string, ReviewDecisions<TRecord>>;\n  /**\n   * Core batch preflight result for current selection and latest input props.\n   */\n  preparation: PreparedProposalBatch<TRecord>;\n  /**\n   * Whether a handler exists, preparation passes and state is not submitting.\n   */\n  canApply: boolean;\n  /**\n   * Whether the displayed batch is currently running.\n   */\n  isSubmitting: boolean;\n  /**\n   * Current row being applied, or null outside active row work.\n   */\n  activeProposalId: string | null;\n  /**\n   * Generic current-session batch failure message, or null; raw host exceptions are not exposed.\n   */\n  error: string | null;\n  /**\n   * Read-only execution history for this batch session.\n   */\n  history: readonly ExecutionRecord[];\n  /**\n   * Select or deselect an editable known proposal.\n   *\n   * @param id - Proposal identifier.\n   *\n   * @param selected - Desired selection state.\n   *\n   * @returns No value; unknown/applied/busy proposals are ignored.\n   */\n  setSelected(id: string, selected: boolean): void;\n  /**\n   * Change selection for the current items when idle.\n   *\n   * @param selected - True selects all current IDs; false retains only applied IDs in the selection set.\n   *\n   * @returns No value; calls while execution is busy are ignored.\n   */\n  selectAll(selected: boolean): void;\n  /**\n   * Change one existing proposed field while editable.\n   *\n   * @param id - Proposal identifier.\n   *\n   * @param field - Field present in that proposal.\n   *\n   * @param decision - Pending, accepted or rejected choice.\n   *\n   * @returns No value; invalid IDs/fields and busy/applied proposals are ignored.\n   */\n  setDecision(id: string, field: FieldKey<TRecord>, decision: FieldDecision): void;\n  /**\n   * Change every proposed field choice for one editable proposal.\n   *\n   * @param id - Proposal identifier.\n   *\n   * @param decision - Choice applied to all its changes.\n   *\n   * @returns No value; unknown/applied/busy proposals are ignored.\n   */\n  decideAll(id: string, decision: FieldDecision): void;\n  /**\n   * Preflight the selection, then apply rows sequentially with latest-record rechecks.\n   *\n   * @returns True only for current-session complete success; false when blocked, failed, cancelled or superseded.\n   *\n   * @remarks Confirmed successes are retained and skipped on retry; unconfirmed backend effects may still exist.\n   */\n  apply(): Promise<boolean>;\n  /**\n   * Request cooperative cancellation of current execution.\n   *\n   * @returns No value; does not roll back previously applied rows or force host work to stop.\n   */\n  cancel(): void;\n  /**\n   * Clear settled execution history using the session policy.\n   *\n   * @returns No value; does not clear review choices or confirmed applied IDs.\n   */\n  clearHistory(): void;\n}\n\ninterface ReviewState<TRecord extends Record<string, any>> {\n  key: string;\n  session: ExecutionSession;\n  selected: ReadonlySet<string>;\n  applied: ReadonlySet<string>;\n  decisions: ReadonlyMap<string, ReviewDecisions<TRecord>>;\n  running: boolean;\n  active: string | null;\n  error: string | null;\n}\n\nfunction initial<TRecord extends Record<string, any>>(key: string): ReviewState<TRecord> {\n  return {\n    key,\n    session: createExecutionSession(),\n    selected: new Set(),\n    applied: new Set(),\n    decisions: new Map(),\n    running: false,\n    active: null,\n    error: null,\n  };\n}\n\n/**\n * Reviews a batch with explicit field decisions and sequential host application.\n *\n * @typeParam TRecord - Record shape; defaults to a string-keyed record.\n *\n * @param options - Batch identity, unique immutable proposals/latest records, validation and optional host apply callback.\n *\n * @returns Selection/decision controls, preflight state, bounded execution history and cooperative cancellation.\n *\n * @remarks Requires React; no context/styles. Changing batchId or serialized proposal\n * content starts a new session; unmount/session changes request cancellation. Each row\n * is rechecked against latest committed host inputs before apply. Stops at the first\n * failure/cancellation; successes remain excluded from retries. Cancellation cannot\n * undo host effects, so persist idempotently and enforce concurrency/authorization in\n * the backend. A row that changed the backend before rejecting has an uncertain outcome.\n * Keep the ref/layout-effect bridge for latest host inputs: the returned apply control\n * can be called by UI event handlers and other host code outside Effect logic.\n * useEffectEvent is restricted to Effect-originated callbacks and cannot replace this\n * externally callable execution path. The ref is not a React 18 compatibility shim.\n *\n * @example\n * ```tsx\n * import { useProposalBatchReview, type UseProposalBatchReviewOptions } from '@alneas/appkit-react/ai/proposal';\n * type RecordData = { title: string };\n * export function Batch({ options }: { options: UseProposalBatchReviewOptions<RecordData> }) {\n *   const review = useProposalBatchReview(options);\n *   return <button disabled={!review.canApply} onClick={() => { void review.apply(); }}>Apply selected records</button>;\n * }\n * ```\n */\nexport function useProposalBatchReview<TRecord extends Record<string, any> = Record<string, any>>(\n  options: UseProposalBatchReviewOptions<TRecord>\n): UseProposalBatchReviewReturn<TRecord> {\n  const key = JSON.stringify([options.batchId, options.items.map(item => JSON.stringify(item.proposal)).sort()]);\n  const [stored, setStored] = useState(() => initial<TRecord>(key));\n  let state = stored;\n  if (state.key !== key) {\n    state = initial<TRecord>(key);\n    setStored(state);\n  }\n  const session = state.session;\n  const live = useRef<{ session: ExecutionSession; applied: Set<string> } | null>(null);\n  const latest = useRef(options);\n  useLayoutEffect(() => {\n    latest.current = options;\n  });\n  useLayoutEffect(() => {\n    const current = { session, applied: new Set<string>() };\n    live.current = current;\n    return () => {\n      session.cancel();\n      if (live.current === current) live.current = null;\n    };\n  }, [session]);\n\n  const history = useSyncExternalStore(session.subscribe, session.getSnapshot, session.getSnapshot);\n  const busy = () => session.getSnapshot().some(record => record.status === 'running' || record.status === 'cancelling');\n  const update = (change: (current: ReviewState<TRecord>) => ReviewState<TRecord>) => {\n    setStored(current => (current.session === session ? change(current) : current));\n  };\n\n  const entries = (\n    items: readonly ProposalBatchItem<TRecord>[],\n    applied: ReadonlySet<string>\n  ): ProposalBatchEntry<TRecord>[] =>\n    items.map(item => ({\n      ...item,\n      decisions: state.decisions.get(item.proposal.id) ?? ({} as ReviewDecisions<TRecord>),\n      selected: state.selected.has(item.proposal.id) && !applied.has(item.proposal.id),\n    }));\n\n  const preparation = prepareProposalBatch(entries(options.items, state.applied), options.validateCandidate);\n  const editable = (id: string) =>\n    live.current?.session === session && !busy() && !live.current.applied.has(id) && options.items.some(item => item.proposal.id === id);\n\n  const apply = async (): Promise<boolean> => {\n    const current = live.current;\n    if (!current || current.session !== session || busy() || !latest.current.onApply) return false;\n    const planned = prepareProposalBatch(entries(latest.current.items, current.applied), latest.current.validateCandidate);\n    if (!planned.canApply) return false;\n    update(value => ({ ...value, running: true, error: null }));\n    const outcome = await session.run(`一括適用 ${planned.payloads.length} 件`, async context => {\n      context.reportProgress({ completed: 0, total: planned.payloads.length });\n      let completed = 0;\n      for (const payload of planned.payloads) {\n        context.signal.throwIfAborted();\n        if (live.current !== current) throw new DOMException('Review session changed', 'AbortError');\n        const item = latest.current.items.find(value => value.proposal.id === payload.proposalId);\n        if (!item) throw new Error('対象の提案が見つかりません。再確認してください。');\n        const checked = prepareProposalBatch(\n          [{ ...item, selected: true, decisions: state.decisions.get(payload.proposalId) ?? ({} as ReviewDecisions<TRecord>) }],\n          latest.current.validateCandidate\n        );\n        if (!checked.canApply || !latest.current.onApply) {\n          throw new Error('適用前にデータが変更されたため停止しました。再確認してください。');\n        }\n        update(value => ({ ...value, active: payload.proposalId }));\n        await latest.current.onApply(checked.payloads[0], {\n          signal: context.signal,\n          reportProgress(progress) {\n            const fraction =\n              progress.total && Number.isFinite(progress.total) && Number.isFinite(progress.completed)\n                ? Math.max(0, Math.min(1, progress.completed / progress.total))\n                : 0;\n            context.reportProgress({\n              completed: completed + fraction,\n              total: planned.payloads.length,\n              message: progress.message,\n            });\n          },\n        });\n        if (live.current !== current) throw new DOMException('Review session changed', 'AbortError');\n        current.applied.add(payload.proposalId);\n        update(value => ({ ...value, applied: new Set(current.applied) }));\n        context.reportProgress({ completed: ++completed, total: planned.payloads.length });\n      }\n    });\n    if (live.current !== current) return false;\n    update(value => ({\n      ...value,\n      running: false,\n      active: null,\n      error: outcome.status === 'failed' ? '適用に失敗しました。成功済みの提案を除いて再試行できます。' : null,\n    }));\n    return outcome.status === 'succeeded';\n  };\n\n  return {\n    selectedIds: state.selected,\n    appliedIds: state.applied,\n    decisions: state.decisions,\n    preparation,\n    canApply: !!options.onApply && preparation.canApply && !state.running,\n    isSubmitting: state.running,\n    activeProposalId: state.active,\n    error: state.error,\n    history,\n    setSelected(id, selected) {\n      if (!editable(id)) return;\n      update(value => {\n        const next = new Set(value.selected);\n        if (selected) next.add(id);\n        else next.delete(id);\n        return { ...value, selected: next, error: null };\n      });\n    },\n    selectAll(selected) {\n      if (busy()) return;\n      update(value => ({\n        ...value,\n        selected: new Set(selected ? options.items.map(item => item.proposal.id) : value.applied),\n        error: null,\n      }));\n    },\n    setDecision(id, field, decision) {\n      if (!editable(id) || !options.items.find(item => item.proposal.id === id)?.proposal.changes.some(change => change.field === field)) return;\n      update(value => ({\n        ...value,\n        decisions: new Map(value.decisions).set(id, {\n          ...value.decisions.get(id),\n          [field]: decision,\n        } as ReviewDecisions<TRecord>),\n        error: null,\n      }));\n    },\n    decideAll(id, decision) {\n      if (!editable(id)) return;\n      const item = options.items.find(value => value.proposal.id === id)!;\n      update(value => ({\n        ...value,\n        decisions: new Map(value.decisions).set(\n          id,\n          Object.fromEntries(item.proposal.changes.map(change => [change.field, decision])) as ReviewDecisions<TRecord>\n        ),\n        error: null,\n      }));\n    },\n    apply,\n    cancel: session.cancel,\n    clearHistory: session.clearHistory,\n  };\n}\n"],"mappings":"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"}

package/dist/consumer-ai/SKILL.md

@@ -10,3 +10,11 @@ Use api-index.json for actual exported names, signatures and public import paths
 The Core package's appkit-api CLI searches locally available catalogs without running tools or contacting a provider. Check each result's package version and digest; registry 0.1.0 does not include this new CLI. Never replace a missing legacy catalog with a newer API surface. Always verify generated code with the consumer's type checker and relevant behavior tests.
 
 AI tool calls and outputs are untrusted. Schema validity is not approval. Bind host approval to immutable arguments/targets/session/registration, enforce server permissions and durable idempotency at execution, and project minimal outputs. Adapters do not run tools or authorize writes. Read the AI guide and Core error guide; never infer permission from a tool-output event or bypass duplicate-call protection.
+
+React 0.3.0 drag surfaces use native dnd-kit React. Read docs/migration.md from
+this installed package before adapting a 0.2.0 consumer. It covers nullable native
+events, cancellation guards, registration refs, React 19 function component types
+and Query 5.104.5 alignment. High-level features own their native providers;
+standalone registrations must share a native provider. Resolve exact types from
+the matching installed API catalog. A prepared source version does not prove
+registry availability, and a newer catalog must not replace an older installation.