@alneas/appkit-react 0.1.0 → 0.2.0

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

@@ -1 +1 @@
-{"version":3,"file":"registry.js","names":["defineGenerativeUIComponent","definition","type","validate","component","contract","dataSchema","createGenerativeUIContract","snapshot","data","result","createElement","createGenerativeUIRegistry","entries","components","described","describedTypes","failure","block","resolve","element","isValidElement"],"sources":["../../../src/ai/generative-ui/registry.ts"],"sourcesContent":["import { createElement, isValidElement, type ComponentType, type ReactElement } from 'react';\nimport { createGenerativeUIContract } from \"@alneas/appkit-core/ai\";\nimport type { GenerativeUIBlock, GenerativeUIObject } from \"@alneas/appkit-core/ai\";\n\n/** A pure application validator may transform JSON data into the component's typed input. */\nexport type GenerativeUIDataResult<TData> = { readonly ok: true; readonly data: TData } | { readonly ok: false };\n\n/** Safe diagnostic metadata; no raw payload, exception or validator message is exposed. */\nexport interface GenerativeUIIssue {\n  readonly code: 'INVALID_DOCUMENT' | 'UNKNOWN_COMPONENT' | 'INVALID_DATA' | 'RENDER_ERROR';\n  readonly blockId?: string;\n  readonly type?: string;\n}\n\n/** Validated component resolution, before React renders the element. */\nexport type GenerativeUIResolution =\n  | { readonly ok: true; readonly element: ReactElement }\n  | { readonly ok: false; readonly issue: GenerativeUIIssue };\n\n/** Application-owned component registration produced by defineGenerativeUIComponent. */\nexport interface GenerativeUIComponent {\n  readonly type: string;\n  /** Optional inline draft-07 schema, enforced before the component validator. */\n  readonly dataSchema?: GenerativeUIObject;\n  readonly resolve: (data: GenerativeUIObject) => ReactElement | null;\n}\n\n/** Immutable registry. Create a new registry to change the permitted components. */\nexport interface GenerativeUIRegistry {\n  readonly types: readonly string[];\n  /** Available only when every registration supplies dataSchema (including the empty registry). */\n  readonly documentSchema?: GenerativeUIObject;\n  resolve(block: GenerativeUIBlock): GenerativeUIResolution;\n}\n\n/**\n * Binds a component to a pure, synchronous validator. Components receive only the\n * validated `data` prop. Callbacks, current records and credentials belong to trusted\n * application code (for example React Context), never the generated document.\n * Optional dataSchema is snapshotted and validated before the custom validator.\n * It uses the inline draft-07 subset documented by createGenerativeUIContract.\n *\n * @example\n * ```tsx\n * import { defineGenerativeUIComponent } from \"./\";\n * const greeting = defineGenerativeUIComponent({\n *   type: 'greeting',\n *   validate: (data) => typeof data.text === 'string'\n *     ? { ok: true, data: { text: data.text } } : { ok: false },\n *   component: ({ data }) => <p>{data.text}</p>,\n * });\n * ```\n */\nexport function defineGenerativeUIComponent<TData>(definition: {\n  readonly type: string;\n  /** Optional shared schema for model output and runtime validation. */\n  readonly dataSchema?: GenerativeUIObject;\n  readonly validate: (data: GenerativeUIObject) => GenerativeUIDataResult<TData>;\n  readonly component: ComponentType<{ data: TData }>;\n}): GenerativeUIComponent {\n  const { type, validate, component, dataSchema } = definition;\n  if (!/^[A-Za-z][A-Za-z0-9_.-]{0,63}$/.test(type) || typeof validate !== 'function' || !component) {\n    throw new Error('A UI component requires a valid type, validator and component');\n  }\n  const contract = dataSchema !== undefined ? createGenerativeUIContract([{ type, dataSchema }]) : undefined;\n  const snapshot = contract?.components[0].dataSchema;\n  return Object.freeze({\n    type,\n    ...(snapshot ? { dataSchema: snapshot } : {}),\n    resolve(data: GenerativeUIObject) {\n      if (contract && !contract.validateData(type, data)) return null;\n      const result = validate(data);\n      return result?.ok === true ? createElement(component, { data: result.data }) : null;\n    },\n  });\n}\n\n/**\n * Creates an allowlist of application-defined UI components. No global registration,\n * dynamic imports, HTML evaluation or Action execution occurs. Validators must be pure;\n * their failures are isolated per block. Rendering exceptions are handled by the renderer.\n * documentSchema is available only if every component declares dataSchema; missing\n * schemas are not guessed. It covers structural validation, not custom business rules.\n */\nexport function createGenerativeUIRegistry(components: readonly GenerativeUIComponent[]): GenerativeUIRegistry {\n  const entries = new Map<string, GenerativeUIComponent['resolve']>();\n  for (const component of components) {\n    if (!/^[A-Za-z][A-Za-z0-9_.-]{0,63}$/.test(component.type) || typeof component.resolve !== 'function' || entries.has(component.type)) {\n      throw new Error('UI component types must be valid and unique');\n    }\n    entries.set(component.type, component.resolve);\n  }\n  const described = components.filter(\n    (component): component is GenerativeUIComponent & { dataSchema: GenerativeUIObject } =>\n      component.dataSchema !== undefined\n  );\n  const contract = createGenerativeUIContract(described);\n  const describedTypes = new Set(described.map(component => component.type));\n  return Object.freeze({\n    ...(described.length === components.length ? { documentSchema: contract.schema } : {}),\n    types: Object.freeze([...entries.keys()]),\n    resolve(block: GenerativeUIBlock): GenerativeUIResolution {\n      const failure = (code: GenerativeUIIssue['code']): GenerativeUIResolution => ({\n        ok: false,\n        issue: { code, blockId: block.id, type: block.type },\n      });\n      const resolve = entries.get(block.type);\n      if (!resolve) return failure('UNKNOWN_COMPONENT');\n      try {\n        if (describedTypes.has(block.type) && !contract.validateData(block.type, block.data)) return failure('INVALID_DATA');\n        const element = resolve(block.data);\n        return isValidElement(element) ? { ok: true, element } : failure('INVALID_DATA');\n      } catch {\n        return failure('INVALID_DATA');\n      }\n    },\n  });\n}\n"],"mappings":";;;;AAqDA,SAAgBA,EAAmC,GAMzB;CACxB,IAAM,EAAE,SAAM,aAAU,cAAW,kBAAeC;CAClD,IAAI,CAAC,iCAAiC,KAAKC,CAAI,KAAK,OAAOC,KAAa,cAAc,CAACC,GACrF,MAAU,MAAM,+DAA+D;CAEjF,IAAMC,IAAWC,MAAe,KAAA,IAAiE,KAAA,IAArDC,EAA2B,CAAC;EAAE;EAAM;CAAW,CAAC,CAAC,GACvFC,IAAWH,GAAU,WAAW,EAAE,CAAC;CACzC,OAAO,OAAO,OAAO;EACnB;EACA,GAAIG,IAAW,EAAE,YAAYA,EAAS,IAAI,CAAC;EAC3C,QAAQ,GAA0B;GAChC,IAAIH,KAAY,CAACA,EAAS,aAAaH,GAAMO,CAAI,GAAG,OAAO;GAC3D,IAAMC,IAASP,EAASM,CAAI;GAC5B,OAAOC,GAAQ,OAAO,KAAOC,EAAcP,GAAW,EAAE,MAAMM,EAAO,KAAK,CAAC,IAAI;EACjF;CACF,CAAC;AACH;AASA,SAAgBE,EAA2B,GAAoE;CAC7G,IAAMC,oBAAU,IAAI,IAA8C;CAClE,KAAK,IAAMT,KAAaU,GAAY;EAClC,IAAI,CAAC,iCAAiC,KAAKV,EAAU,IAAI,KAAK,OAAOA,EAAU,WAAY,cAAcS,EAAQ,IAAIT,EAAU,IAAI,GACjI,MAAU,MAAM,6CAA6C;EAE/D,EAAQ,IAAIA,EAAU,MAAMA,EAAU,OAAO;CAC/C;CACA,IAAMW,IAAYD,EAAW,QAC1B,MACCV,EAAU,eAAe,KAAA,CAC7B,GACMC,IAAWE,EAA2BQ,CAAS,GAC/CC,IAAiB,IAAI,IAAID,EAAU,KAAI,MAAaX,EAAU,IAAI,CAAC;CACzE,OAAO,OAAO,OAAO;EACnB,GAAIW,EAAU,WAAWD,EAAW,SAAS,EAAE,gBAAgBT,EAAS,OAAO,IAAI,CAAC;EACpF,OAAO,OAAO,OAAO,CAAC,GAAGQ,EAAQ,KAAK,CAAC,CAAC;EACxC,QAAQ,GAAkD;GACxD,IAAMI,KAAW,OAA6D;IAC5E,IAAI;IACJ,OAAO;KAAE;KAAM,SAASC,EAAM;KAAI,MAAMA,EAAM;IAAK;GACrD,IACMC,IAAUN,EAAQ,IAAIK,EAAM,IAAI;GACtC,IAAI,CAACC,GAAS,OAAOF,EAAQ,mBAAmB;GAChD,IAAI;IACF,IAAID,EAAe,IAAIE,EAAM,IAAI,KAAK,CAACb,EAAS,aAAaa,EAAM,MAAMA,EAAM,IAAI,GAAG,OAAOD,EAAQ,cAAc;IACnH,IAAMG,IAAUD,EAAQD,EAAM,IAAI;IAClC,OAAOG,EAAeD,CAAO,IAAI;KAAE,IAAI;KAAM;IAAQ,IAAIH,EAAQ,cAAc;GACjF,QAAQ;IACN,OAAOA,EAAQ,cAAc;GAC/B;EACF;CACF,CAAC;AACH"}
+{"version":3,"file":"registry.js","names":["defineGenerativeUIComponent","definition","type","validate","component","contract","dataSchema","createGenerativeUIContract","snapshot","data","result","createElement","createGenerativeUIRegistry","entries","components","described","describedTypes","failure","block","resolve","element","isValidElement"],"sources":["../../../src/ai/generative-ui/registry.ts"],"sourcesContent":["import { createElement, isValidElement, type ComponentType, type ReactElement } from 'react';\nimport { createGenerativeUIContract } from \"@alneas/appkit-core/ai\";\nimport type { GenerativeUIBlock, GenerativeUIObject } from \"@alneas/appkit-core/ai\";\n\n/**\n * Result of a pure validator: ok true supplies typed input; ok false rejects the block.\n *\n * @typeParam TData - Input shape accepted by the registered component.\n *\n * @remarks See defineGenerativeUIComponent for a complete registration example.\n *\n * @see defineGenerativeUIComponent for the canonical usage example.\n */\nexport type GenerativeUIDataResult<TData> = {\n  /** Successful validation discriminator. */\n  readonly ok: true;\n  /** Typed input passed to the registered component. */\n  readonly data: TData;\n} | {\n  /** Rejected validation discriminator; no typed input is available. */\n  readonly ok: false;\n};\n\n/**\n * Safe diagnostic metadata; no raw payload, exception or validator message is exposed.\n * @see GenerativeUIRenderer for the canonical usage example.\n */\nexport interface GenerativeUIIssue {\n  /** Safe failure category for document, allowlist, data or React rendering failures. */\n  readonly code: 'INVALID_DOCUMENT' | 'UNKNOWN_COMPONENT' | 'INVALID_DATA' | 'RENDER_ERROR';\n  /** Block identifier when failure is scoped to a block. */\n  readonly blockId?: string;\n  /** Requested component type when available. */\n  readonly type?: string;\n}\n\n/**\n * Validated component resolution, before React renders the element.\n * @see createGenerativeUIRegistry for the canonical usage example.\n */\nexport type GenerativeUIResolution =\n  | {\n      /** Successful allowlist and data resolution. */\n      readonly ok: true;\n      /** Resolved element; React rendering may still fail later. */\n      readonly element: ReactElement;\n    }\n  | {\n      /** Failed allowlist or data resolution. */\n      readonly ok: false;\n      /** Safe diagnostic metadata without raw payloads or errors. */\n      readonly issue: GenerativeUIIssue;\n    };\n\n/**\n * Application-owned component registration produced by defineGenerativeUIComponent.\n * @see defineGenerativeUIComponent for the canonical usage example.\n */\nexport interface GenerativeUIComponent {\n  /** Stable allowlist key: letter first, then up to 63 letters, digits, underscores, dots or hyphens. */\n  readonly type: string;\n  /** Optional inline draft-07 schema, enforced before the component validator. */\n  readonly dataSchema?: GenerativeUIObject;\n  /**\n   * Resolve input through the registration's schema and validator.\n   *\n   * @param data - JSON object to validate before passing typed data to the component.\n   *\n   * @returns Element for accepted data, or null when validation rejects it.\n   *\n   * @throws Direct calls propagate validator errors; registry.resolve isolates them.\n   *\n   * @remarks See defineGenerativeUIComponent for registration setup.\n   */\n  readonly resolve: (data: GenerativeUIObject) => ReactElement | null;\n}\n\n/**\n * Immutable registry. Create a new registry to change the permitted components.\n * @see createGenerativeUIRegistry for the canonical usage example.\n */\nexport interface GenerativeUIRegistry {\n  /** Frozen registration keys in insertion order. */\n  readonly types: readonly string[];\n  /** Available only when every registration supplies dataSchema (including the empty registry). */\n  readonly documentSchema?: GenerativeUIObject;\n  /**\n   * Resolve one structurally valid block through the allowlist.\n   *\n   * @param block - Block from a validated generative UI document.\n   *\n   * @returns Element on success, or safe issue metadata for an unknown type or rejected data.\n   *\n   * @remarks Validator/registration exceptions become INVALID_DATA; component rendering happens later.\n   * See createGenerativeUIRegistry for usage.\n   */\n  resolve(block: GenerativeUIBlock): GenerativeUIResolution;\n}\n\n/**\n * Binds a component to a pure, synchronous validator. Components receive only the\n * validated `data` prop. Callbacks, current records and credentials belong to trusted\n * application code (for example React Context), never the generated document.\n * Optional dataSchema is snapshotted and validated before the custom validator.\n * It uses the inline draft-07 subset documented by createGenerativeUIContract.\n *\n *\n * @typeParam TData - Validated input shape passed to the registered React component.\n *\n * @param definition - Unique type name, pure synchronous validator, component and optional schema.\n *\n * @returns Frozen registration for createGenerativeUIRegistry; resolve returns null on invalid data.\n *\n * @throws For an invalid type name, missing validator/component or unsupported data schema.\n *\n * @remarks Requires React. The registration itself needs no context or CSS; supplied\n * components own their provider/style requirements. Validator exceptions are caught by\n * registry resolution, but can escape direct registration.resolve calls.\n *\n * @example\n * ```tsx\n * import { defineGenerativeUIComponent } from \"@alneas/appkit-react/ai/generative-ui\";\n * const greeting = defineGenerativeUIComponent<{ text: string }>({\n *   type: 'greeting',\n *   validate: (data) => typeof data.text === 'string'\n *     ? { ok: true, data: { text: data.text } } : { ok: false },\n *   component: ({ data }) => <p>{data.text}</p>,\n * });\n * ```\n */\nexport function defineGenerativeUIComponent<TData>(definition: {\n  /** Allowlist name with the same syntax as GenerativeUIComponent.type. */\n  readonly type: string;\n  /** Optional shared schema for model output and runtime validation. */\n  readonly dataSchema?: GenerativeUIObject;\n  /**\n   * Pure synchronous conversion from JSON to typed input; return ok false to reject.\n   * @param data - JSON object to validate/transform synchronously.\n   *\n   * @returns ok true with typed component input, or ok false to reject this block.\n   */\n  readonly validate: (data: GenerativeUIObject) => GenerativeUIDataResult<TData>;\n  /** Trusted React component receiving only validated data; owns its context/style requirements. */\n  readonly component: ComponentType<{\n    /** Validated input returned by the registration validator. */\n    data: TData;\n  }>;\n}): GenerativeUIComponent {\n  const { type, validate, component, dataSchema } = definition;\n  if (!/^[A-Za-z][A-Za-z0-9_.-]{0,63}$/.test(type) || typeof validate !== 'function' || !component) {\n    throw new Error('A UI component requires a valid type, validator and component');\n  }\n  const contract = dataSchema !== undefined ? createGenerativeUIContract([{ type, dataSchema }]) : undefined;\n  const snapshot = contract?.components[0].dataSchema;\n  return Object.freeze({\n    type,\n    ...(snapshot ? { dataSchema: snapshot } : {}),\n    resolve(data: GenerativeUIObject) {\n      if (contract && !contract.validateData(type, data)) return null;\n      const result = validate(data);\n      return result?.ok === true ? createElement(component, { data: result.data }) : null;\n    },\n  });\n}\n\n/**\n * Creates an allowlist of application-defined UI components. No global registration,\n * dynamic imports, HTML evaluation or Action execution occurs. Validators must be pure;\n * their failures are isolated per block. Rendering exceptions are handled by the renderer.\n * documentSchema is available only if every component declares dataSchema; missing\n * schemas are not guessed. It covers structural validation, not custom business rules.\n *\n * @param components - Registrations with distinct, valid allowlist names; an empty list is permitted.\n *\n * @returns Frozen registry with insertion-ordered types and an optional document schema.\n *\n * @throws For invalid/duplicate names, missing resolve functions or invalid declared schemas.\n *\n * @example\n * ```ts\n * import { createGenerativeUIRegistry } from '@alneas/appkit-react/ai/generative-ui';\n * const registry = createGenerativeUIRegistry([]);\n * const result = registry.resolve({ id: 'missing', type: 'unknown', data: {} });\n * // result.ok is false: no component is registered.\n * ```\n */\nexport function createGenerativeUIRegistry(components: readonly GenerativeUIComponent[]): GenerativeUIRegistry {\n  const entries = new Map<string, GenerativeUIComponent['resolve']>();\n  for (const component of components) {\n    if (!/^[A-Za-z][A-Za-z0-9_.-]{0,63}$/.test(component.type) || typeof component.resolve !== 'function' || entries.has(component.type)) {\n      throw new Error('UI component types must be valid and unique');\n    }\n    entries.set(component.type, component.resolve);\n  }\n  const described = components.filter(\n    (component): component is GenerativeUIComponent & { dataSchema: GenerativeUIObject } =>\n      component.dataSchema !== undefined\n  );\n  const contract = createGenerativeUIContract(described);\n  const describedTypes = new Set(described.map(component => component.type));\n  return Object.freeze({\n    ...(described.length === components.length ? { documentSchema: contract.schema } : {}),\n    types: Object.freeze([...entries.keys()]),\n    resolve(block: GenerativeUIBlock): GenerativeUIResolution {\n      const failure = (code: GenerativeUIIssue['code']): GenerativeUIResolution => ({\n        ok: false,\n        issue: { code, blockId: block.id, type: block.type },\n      });\n      const resolve = entries.get(block.type);\n      if (!resolve) return failure('UNKNOWN_COMPONENT');\n      try {\n        if (describedTypes.has(block.type) && !contract.validateData(block.type, block.data)) return failure('INVALID_DATA');\n        const element = resolve(block.data);\n        return isValidElement(element) ? { ok: true, element } : failure('INVALID_DATA');\n      } catch {\n        return failure('INVALID_DATA');\n      }\n    },\n  });\n}\n"],"mappings":";;;;AAkIA,SAAgBA,EAAmC,GAiBzB;CACxB,IAAM,EAAE,SAAM,aAAU,cAAW,kBAAeC;CAClD,IAAI,CAAC,iCAAiC,KAAKC,CAAI,KAAK,OAAOC,KAAa,cAAc,CAACC,GACrF,MAAU,MAAM,+DAA+D;CAEjF,IAAMC,IAAWC,MAAe,KAAA,IAAiE,KAAA,IAArDC,EAA2B,CAAC;EAAE;EAAM;CAAW,CAAC,CAAC,GACvFC,IAAWH,GAAU,WAAW,EAAE,CAAC;CACzC,OAAO,OAAO,OAAO;EACnB;EACA,GAAIG,IAAW,EAAE,YAAYA,EAAS,IAAI,CAAC;EAC3C,QAAQ,GAA0B;GAChC,IAAIH,KAAY,CAACA,EAAS,aAAaH,GAAMO,CAAI,GAAG,OAAO;GAC3D,IAAMC,IAASP,EAASM,CAAI;GAC5B,OAAOC,GAAQ,OAAO,KAAOC,EAAcP,GAAW,EAAE,MAAMM,EAAO,KAAK,CAAC,IAAI;EACjF;CACF,CAAC;AACH;AAuBA,SAAgBE,EAA2B,GAAoE;CAC7G,IAAMC,oBAAU,IAAI,IAA8C;CAClE,KAAK,IAAMT,KAAaU,GAAY;EAClC,IAAI,CAAC,iCAAiC,KAAKV,EAAU,IAAI,KAAK,OAAOA,EAAU,WAAY,cAAcS,EAAQ,IAAIT,EAAU,IAAI,GACjI,MAAU,MAAM,6CAA6C;EAE/D,EAAQ,IAAIA,EAAU,MAAMA,EAAU,OAAO;CAC/C;CACA,IAAMW,IAAYD,EAAW,QAC1B,MACCV,EAAU,eAAe,KAAA,CAC7B,GACMC,IAAWE,EAA2BQ,CAAS,GAC/CC,IAAiB,IAAI,IAAID,EAAU,KAAI,MAAaX,EAAU,IAAI,CAAC;CACzE,OAAO,OAAO,OAAO;EACnB,GAAIW,EAAU,WAAWD,EAAW,SAAS,EAAE,gBAAgBT,EAAS,OAAO,IAAI,CAAC;EACpF,OAAO,OAAO,OAAO,CAAC,GAAGQ,EAAQ,KAAK,CAAC,CAAC;EACxC,QAAQ,GAAkD;GACxD,IAAMI,KAAW,OAA6D;IAC5E,IAAI;IACJ,OAAO;KAAE;KAAM,SAASC,EAAM;KAAI,MAAMA,EAAM;IAAK;GACrD,IACMC,IAAUN,EAAQ,IAAIK,EAAM,IAAI;GACtC,IAAI,CAACC,GAAS,OAAOF,EAAQ,mBAAmB;GAChD,IAAI;IACF,IAAID,EAAe,IAAIE,EAAM,IAAI,KAAK,CAACb,EAAS,aAAaa,EAAM,MAAMA,EAAM,IAAI,GAAG,OAAOD,EAAQ,cAAc;IACnH,IAAMG,IAAUD,EAAQD,EAAM,IAAI;IAClC,OAAOG,EAAeD,CAAO,IAAI;KAAE,IAAI;KAAM;IAAQ,IAAIH,EAAQ,cAAc;GACjF,QAAQ;IACN,OAAOA,EAAQ,cAAc;GAC/B;EACF;CACF,CAAC;AACH"}

package/dist/ai/proposal/ProposalFieldReview.cjs.map

@@ -1 +1 @@
-{"version":3,"file":"ProposalFieldReview.cjs","names":["react_jsx_runtime","LABELS","DiffBadge","className","decision","labels","ProposalDecisionButtons","field","allowReset","isSelected","value","buttonClassName","testId","onDecisionChange","ProposalFieldReview","change","beforeLabel","formatValue","afterLabel","error"],"sources":["../../../src/ai/proposal/ProposalFieldReview.tsx"],"sourcesContent":["import type { ReactNode } from 'react';\nimport type { FieldDecision, SupportedPrimitive } from \"@alneas/appkit-core/ai\";\n\n/** Localized labels for a review decision. */\nexport type ProposalDecisionLabels = Record<FieldDecision, string>;\nconst LABELS: ProposalDecisionLabels = { pending: '未判断', accepted: '採用', rejected: '却下' };\n\n/** Props for DiffBadge. */\nexport interface DiffBadgeProps {\n  decision: FieldDecision;\n  labels?: Partial<ProposalDecisionLabels>;\n  className?: string;\n}\n\n/** Displays review selection without implying that a change has been applied or saved. */\nexport function DiffBadge({ decision, labels, className }: DiffBadgeProps) {\n  return (\n    <span\n      className={className ?? 'inline-flex items-center px-2 py-0.5 rounded text-xs font-medium border'}\n      data-decision={decision}\n    >\n      {labels?.[decision] ?? LABELS[decision]}\n    </span>\n  );\n}\n\n/** Controlled accept/reject/reset controls shared by card and field layouts. */\nexport interface ProposalDecisionButtonsProps {\n  field: string;\n  decision: FieldDecision;\n  onDecisionChange: (decision: FieldDecision) => void;\n  disabled?: boolean;\n  labels?: Partial<ProposalDecisionLabels>;\n  /** Enables returning a single field to pending. */\n  allowReset?: boolean;\n  testId?: string;\n  buttonClassName?: (selected: boolean) => string;\n}\n\n/** Emits decisions only; does not mutate form values or apply a proposal. */\nexport function ProposalDecisionButtons({\n  field,\n  decision,\n  onDecisionChange,\n  disabled,\n  labels,\n  allowReset = false,\n  testId,\n  buttonClassName,\n}: ProposalDecisionButtonsProps) {\n  const values: FieldDecision[] = allowReset ? ['accepted', 'rejected', 'pending'] : ['accepted', 'rejected'];\n  return (\n    <div role=\"group\" aria-label={field} className=\"inline-flex flex-wrap gap-1\">\n      {values.map(value => {\n        const isSelected = decision === value;\n        const defaultClass = isSelected\n          ? 'px-2 py-1 text-xs rounded bg-neutral-900 text-white dark:bg-white dark:text-neutral-900'\n          : 'px-2 py-1 text-xs rounded border border-neutral-300 dark:border-neutral-700 hover:bg-neutral-100 dark:hover:bg-neutral-800';\n        return (\n          <button\n            key={value}\n            type=\"button\"\n            disabled={disabled}\n            aria-pressed={isSelected}\n            className={buttonClassName ? buttonClassName(isSelected) : defaultClass}\n            data-testid={\n              testId\n                ? `${testId}-${value === 'accepted' ? 'accept' : value === 'rejected' ? 'reject' : 'reset'}-${field}`\n                : undefined\n            }\n            onClick={() => onDecisionChange(value)}\n          >\n            {labels?.[value] ?? LABELS[value]}\n          </button>\n        );\n      })}\n    </div>\n  );\n}\n\n/** Controlled inline proposal review, suitable beside an existing form field or table cell. */\nexport interface ProposalFieldReviewProps {\n  change: {\n    readonly field: string;\n    readonly label?: string;\n    readonly before: SupportedPrimitive;\n    readonly after: SupportedPrimitive;\n    readonly reason?: string;\n  };\n  decision: FieldDecision;\n  onDecisionChange: (decision: FieldDecision) => void;\n  disabled?: boolean;\n  labels?: Partial<ProposalDecisionLabels>;\n  beforeLabel?: string;\n  afterLabel?: string;\n  formatValue?: (value: SupportedPrimitive) => ReactNode;\n  error?: string;\n  className?: string;\n}\n\n/**\n * Renders a field's proposed values, reason, decision and optional validation message.\n */\nexport function ProposalFieldReview({\n  change,\n  decision,\n  onDecisionChange,\n  disabled,\n  labels,\n  beforeLabel = '変更前',\n  afterLabel = '提案値',\n  formatValue = value => (value === null ? 'null' : String(value)),\n  error,\n  className,\n}: ProposalFieldReviewProps) {\n  return (\n    <section aria-label={change.label ?? change.field} className={className} data-proposal-field={change.field}>\n      <div className=\"flex items-center gap-2\">\n        <span className=\"font-medium\">{change.label ?? change.field}</span>\n        <DiffBadge decision={decision} labels={labels} />\n      </div>\n      <dl className=\"grid grid-cols-2 gap-2 text-sm my-2\">\n        <div>\n          <dt className=\"text-neutral-500 text-xs\">{beforeLabel}</dt>\n          <dd>{formatValue(change.before)}</dd>\n        </div>\n        <div>\n          <dt className=\"text-neutral-500 text-xs\">{afterLabel}</dt>\n          <dd>{formatValue(change.after)}</dd>\n        </div>\n      </dl>\n      {change.reason && <p className=\"text-xs text-neutral-500 my-1\">{change.reason}</p>}\n      <ProposalDecisionButtons\n        field={change.field}\n        decision={decision}\n        onDecisionChange={onDecisionChange}\n        disabled={disabled}\n        labels={labels}\n        allowReset\n      />\n      {error && (\n        <p role=\"alert\" className=\"text-sm text-red-600 mt-1\">\n          {error}\n        </p>\n      )}\n    </section>\n  );\n}\n"],"mappings":"A,mHAKA,IAAMC,EAAiC,CAAE,QAAS,MAAO,SAAU,KAAM,SAAU,IAAK,EAUxF,SAAgBC,EAAU,CAAE,WAAU,SAAQ,aAA6B,CACzE,OACE,EAAAF,EAAA,IAAA,CAAC,OAAD,CACE,UAAWG,GAAa,0EACxB,gBAAeC,EAEd,SAAAC,IAASD,IAAaH,EAAOG,EAC1B,CAAA,CAEV,CAgBA,SAAgBE,EAAwB,CACtC,QACA,WACA,mBACA,WACA,SACA,aAAa,GACb,SACA,mBAC+B,CAE/B,OACE,EAAAN,EAAA,IAAA,CAAC,MAAD,CAAK,KAAK,QAAQ,aAAYO,EAAO,UAAU,8BAC5C,UAH2BC,EAAa,CAAC,WAAY,WAAY,SAAS,EAAI,CAAC,WAAY,UAAU,EAAA,CAG9F,IAAI,GAAS,CACnB,IAAMC,EAAaL,IAAaM,EAIhC,OACE,EAAAV,EAAA,IAAA,CAAC,SAAD,CAEE,KAAK,SACK,WACV,eAAcS,EACd,UAAWE,EAAkBA,EAAgBF,CAAU,EATtCA,EACjB,0FACA,6HAQA,cACEG,EACI,GAAGA,EAAO,GAAGF,IAAU,WAAa,SAAWA,IAAU,WAAa,SAAW,QAAQ,GAAGH,IAC5F,IAAA,GAEN,YAAeM,EAAiBH,CAAK,EAEpC,SAAAL,IAASK,IAAUT,EAAOS,EACrB,EAbDA,CAaC,CAEZ,CAAC,CACE,CAAA,CAET,CAyBA,SAAgBI,EAAoB,CAClC,SACA,WACA,mBACA,WACA,SACA,cAAc,MACd,aAAa,MACb,cAAc,GAAUJ,IAAU,KAAO,OAAS,OAAOA,CAAK,EAC9D,QACA,aAC2B,CAC3B,OACE,EAAAV,EAAA,KAAA,CAAC,UAAD,CAAS,aAAYe,EAAO,OAASA,EAAO,MAAkB,YAAW,sBAAqBA,EAAO,MAArG,SAAA,EACE,EAAAf,EAAA,KAAA,CAAC,MAAD,CAAK,UAAU,0BAAf,SAAA,EACE,EAAAA,EAAA,IAAA,CAAC,OAAD,CAAM,UAAU,cAAe,SAAAe,EAAO,OAASA,EAAO,KAAY,CAAA,GAClE,EAAAf,EAAA,IAAA,CAACE,EAAD,CAAqB,WAAkB,QAAS,CAAA,CAC7C,C,IACL,EAAAF,EAAA,KAAA,CAAC,KAAD,CAAI,UAAU,sCAAd,SAAA,EACE,EAAAA,EAAA,KAAA,CAAC,MAAD,CAAA,SAAA,EACE,EAAAA,EAAA,IAAA,CAAC,KAAD,CAAI,UAAU,2BAA4B,SAAAgB,CAAgB,CAAA,GAC1D,EAAAhB,EAAA,IAAA,CAAC,KAAD,CAAA,SAAKiB,EAAYF,EAAO,MAAM,CAAM,CAAA,CACjC,CAAA,CAAA,GACL,EAAAf,EAAA,KAAA,CAAC,MAAD,CAAA,SAAA,EACE,EAAAA,EAAA,IAAA,CAAC,KAAD,CAAI,UAAU,2BAA4B,SAAAkB,CAAe,CAAA,GACzD,EAAAlB,EAAA,IAAA,CAAC,KAAD,CAAA,SAAKiB,EAAYF,EAAO,KAAK,CAAM,CAAA,CAChC,CAAA,CAAA,CACH,C,GACHA,EAAO,SAAU,EAAAf,EAAA,IAAA,CAAC,IAAD,CAAG,UAAU,gCAAiC,SAAAe,EAAO,MAAU,CAAA,GACjF,EAAAf,EAAA,IAAA,CAACM,EAAD,CACE,MAAOS,EAAO,MACJ,WACQ,mBACR,WACF,SACR,WAAA,EACD,CAAA,EACAI,IACC,EAAAnB,EAAA,IAAA,CAAC,IAAD,CAAG,KAAK,QAAQ,UAAU,4BACvB,SAAAmB,CACA,CAAA,CAEE,C,EAEb,C"}
+{"version":3,"file":"ProposalFieldReview.cjs","names":["react_jsx_runtime","LABELS","DiffBadge","className","decision","labels","ProposalDecisionButtons","field","allowReset","isSelected","value","buttonClassName","testId","onDecisionChange","ProposalFieldReview","change","beforeLabel","formatValue","afterLabel","error"],"sources":["../../../src/ai/proposal/ProposalFieldReview.tsx"],"sourcesContent":["import type { ReactNode } from 'react';\nimport type { FieldDecision, SupportedPrimitive } from \"@alneas/appkit-core/ai\";\n\n/**\n * Display labels for pending, accepted and rejected decisions.\n *\n * @see ProposalFieldReview for controlled usage.\n */\nexport type ProposalDecisionLabels = Record<FieldDecision, string>;\nconst LABELS: ProposalDecisionLabels = { pending: '未判断', accepted: '採用', rejected: '却下' };\n\n/**\n * Decision display settings for DiffBadge; see its usage example.\n *\n * @see DiffBadge for the canonical usage example.\n */\nexport interface DiffBadgeProps {\n  /**\n   * Current review choice; no save/apply status is implied.\n   */\n  decision: FieldDecision;\n  /**\n   * Optional per-choice localized text; omitted values use Japanese defaults.\n   */\n  labels?: Partial<ProposalDecisionLabels>;\n  /**\n   * Optional replacement classes; omission uses compact bordered badge classes.\n   */\n  className?: string;\n}\n\n/**\n * Displays the current review choice without implying persistence.\n *\n * @param props - Controlled state, optional labels/style settings and callbacks.\n *\n * @returns Span carrying data-decision and a localized label.\n *\n * @remarks Import Appkit styles for utility-class styling; no context provider is required.\n * Callbacks and formatters are synchronous and their errors propagate. Host code owns\n * review state and persistence; these controls do not apply changes automatically.\n *\n * @example\n * ```tsx\n * import { useState } from 'react';\n * import '@alneas/appkit-react/styles';\n * import { DiffBadge, type FieldDecision } from '@alneas/appkit-react/ai/proposal';\n * export function FieldReview() {\n *   const [decision, setDecision] = useState<FieldDecision>('pending');\n *   return <DiffBadge decision=\"pending\" />;\n * }\n * ```\n */\nexport function DiffBadge({ decision, labels, className }: DiffBadgeProps) {\n  return (\n    <span\n      className={className ?? 'inline-flex items-center px-2 py-0.5 rounded text-xs font-medium border'}\n      data-decision={decision}\n    >\n      {labels?.[decision] ?? LABELS[decision]}\n    </span>\n  );\n}\n\n/**\n * Controlled choice inputs; see ProposalDecisionButtons for usage.\n *\n * @see ProposalDecisionButtons for the canonical usage example.\n */\nexport interface ProposalDecisionButtonsProps {\n  /**\n   * Field key used as group aria-label and optional test-ID suffix.\n   */\n  field: string;\n  /**\n   * Current externally controlled choice.\n   */\n  decision: FieldDecision;\n  /**\n   * Synchronous callback receiving the clicked choice; the host must update decision.\n   *\n   * @param decision - Clicked pending/accepted/rejected choice.\n   *\n   * @returns No value; the host schedules its controlled state update.\n   */\n  onDecisionChange: (decision: FieldDecision) => void;\n  /**\n   * Disable every choice button; defaults to false/undefined.\n   */\n  disabled?: boolean;\n  /**\n   * Optional per-choice text; unspecified values use Japanese defaults.\n   */\n  labels?: Partial<ProposalDecisionLabels>;\n    /**\n     * Include a pending/reset choice; defaults to false.\n     */\n  allowReset?: boolean;\n  /**\n   * Optional prefix for {prefix}-accept/reject/reset-{field} test IDs.\n   */\n  testId?: string;\n  /**\n   * Optional synchronous class factory receiving whether this button is selected; replaces default button styling.\n   */\n  buttonClassName?: (selected: boolean) => string;\n}\n\n/**\n * Emits controlled accept/reject and optional reset choices.\n *\n * @param props - Controlled state, optional labels/style settings and callbacks.\n *\n * @returns Button group; no form values or proposals are mutated.\n *\n * @remarks Import Appkit styles for utility-class styling; no context provider is required.\n * Callbacks and formatters are synchronous and their errors propagate. Host code owns\n * review state and persistence; these controls do not apply changes automatically.\n *\n * @example\n * ```tsx\n * import { useState } from 'react';\n * import '@alneas/appkit-react/styles';\n * import { ProposalDecisionButtons, type FieldDecision } from '@alneas/appkit-react/ai/proposal';\n * export function FieldReview() {\n *   const [decision, setDecision] = useState<FieldDecision>('pending');\n *   return <ProposalDecisionButtons field=\"title\" decision={decision} onDecisionChange={setDecision} />;\n * }\n * ```\n */\nexport function ProposalDecisionButtons({\n  field,\n  decision,\n  onDecisionChange,\n  disabled,\n  labels,\n  allowReset = false,\n  testId,\n  buttonClassName,\n}: ProposalDecisionButtonsProps) {\n  const values: FieldDecision[] = allowReset ? ['accepted', 'rejected', 'pending'] : ['accepted', 'rejected'];\n  return (\n    <div role=\"group\" aria-label={field} className=\"inline-flex flex-wrap gap-1\">\n      {values.map(value => {\n        const isSelected = decision === value;\n        const defaultClass = isSelected\n          ? 'px-2 py-1 text-xs rounded bg-neutral-900 text-white dark:bg-white dark:text-neutral-900'\n          : 'px-2 py-1 text-xs rounded border border-neutral-300 dark:border-neutral-700 hover:bg-neutral-100 dark:hover:bg-neutral-800';\n        return (\n          <button\n            key={value}\n            type=\"button\"\n            disabled={disabled}\n            aria-pressed={isSelected}\n            className={buttonClassName ? buttonClassName(isSelected) : defaultClass}\n            data-testid={\n              testId\n                ? `${testId}-${value === 'accepted' ? 'accept' : value === 'rejected' ? 'reject' : 'reset'}-${field}`\n                : undefined\n            }\n            onClick={() => onDecisionChange(value)}\n          >\n            {labels?.[value] ?? LABELS[value]}\n          </button>\n        );\n      })}\n    </div>\n  );\n}\n\n/**\n * Controlled field-diff presentation; see ProposalFieldReview for usage.\n *\n * @see ProposalFieldReview for the canonical usage example.\n */\nexport interface ProposalFieldReviewProps {\n  /**\n   * Field identity, before/after primitive values and optional display reason.\n   */\n  change: {\n    /**\n     * Stable field identifier used in the section data attribute.\n     */\n    readonly field: string;\n    /**\n     * Optional display label; omission uses the field identifier.\n     */\n    readonly label?: string;\n    /**\n     * Original supported primitive value.\n     */\n    readonly before: SupportedPrimitive;\n    /**\n     * Proposed supported primitive value.\n     */\n    readonly after: SupportedPrimitive;\n    /**\n     * Optional explanatory text displayed below the diff.\n     */\n    readonly reason?: string;\n  };\n  /**\n   * Externally controlled field choice.\n   */\n  decision: FieldDecision;\n  /**\n   * Synchronous choice callback; update host state to reflect the selection.\n   *\n   * @param decision - Clicked pending/accepted/rejected choice.\n   *\n   * @returns No value; the host schedules its controlled state update.\n   */\n  onDecisionChange: (decision: FieldDecision) => void;\n  /**\n   * Disable review choice buttons; defaults to false/undefined.\n   */\n  disabled?: boolean;\n  /**\n   * Optional decision-text overrides; unspecified values use Japanese defaults.\n   */\n  labels?: Partial<ProposalDecisionLabels>;\n  /**\n   * Before-value caption, default Japanese label for previous value.\n   */\n  beforeLabel?: string;\n  /**\n   * After-value caption, default Japanese label for proposed value.\n   */\n  afterLabel?: string;\n  /**\n   * Synchronous value renderer; defaults to null text for null and String(value) otherwise.\n   */\n  formatValue?: (value: SupportedPrimitive) => ReactNode;\n  /**\n   * Optional validation message shown with role alert.\n   */\n  error?: string;\n  /**\n   * Optional classes on the outer section.\n   */\n  className?: string;\n}\n\n/**\n * Renders before/after values, reason, controlled choices and optional validation feedback.\n *\n * @param props - Controlled state, optional labels/style settings and callbacks.\n *\n * @returns Section with data-proposal-field and review controls.\n *\n * @remarks Import Appkit styles for utility-class styling; no context provider is required.\n * Callbacks and formatters are synchronous and their errors propagate. Host code owns\n * review state and persistence; these controls do not apply changes automatically.\n *\n * @example\n * ```tsx\n * import { useState } from 'react';\n * import '@alneas/appkit-react/styles';\n * import { ProposalFieldReview, type FieldDecision } from '@alneas/appkit-react/ai/proposal';\n * export function FieldReview() {\n *   const [decision, setDecision] = useState<FieldDecision>('pending');\n *   return <ProposalFieldReview change={{ field: 'title', before: 'Old', after: 'New' }} decision={decision} onDecisionChange={setDecision} />;\n * }\n * ```\n */\nexport function ProposalFieldReview({\n  change,\n  decision,\n  onDecisionChange,\n  disabled,\n  labels,\n  beforeLabel = '変更前',\n  afterLabel = '提案値',\n  formatValue = value => (value === null ? 'null' : String(value)),\n  error,\n  className,\n}: ProposalFieldReviewProps) {\n  return (\n    <section aria-label={change.label ?? change.field} className={className} data-proposal-field={change.field}>\n      <div className=\"flex items-center gap-2\">\n        <span className=\"font-medium\">{change.label ?? change.field}</span>\n        <DiffBadge decision={decision} labels={labels} />\n      </div>\n      <dl className=\"grid grid-cols-2 gap-2 text-sm my-2\">\n        <div>\n          <dt className=\"text-neutral-500 text-xs\">{beforeLabel}</dt>\n          <dd>{formatValue(change.before)}</dd>\n        </div>\n        <div>\n          <dt className=\"text-neutral-500 text-xs\">{afterLabel}</dt>\n          <dd>{formatValue(change.after)}</dd>\n        </div>\n      </dl>\n      {change.reason && <p className=\"text-xs text-neutral-500 my-1\">{change.reason}</p>}\n      <ProposalDecisionButtons\n        field={change.field}\n        decision={decision}\n        onDecisionChange={onDecisionChange}\n        disabled={disabled}\n        labels={labels}\n        allowReset\n      />\n      {error && (\n        <p role=\"alert\" className=\"text-sm text-red-600 mt-1\">\n          {error}\n        </p>\n      )}\n    </section>\n  );\n}\n"],"mappings":"A,mHASA,IAAMC,EAAiC,CAAE,QAAS,MAAO,SAAU,KAAM,SAAU,IAAK,EA4CxF,SAAgBC,EAAU,CAAE,WAAU,SAAQ,aAA6B,CACzE,OACE,EAAAF,EAAA,IAAA,CAAC,OAAD,CACE,UAAWG,GAAa,0EACxB,gBAAeC,EAEd,SAAAC,IAASD,IAAaH,EAAOG,EAC1B,CAAA,CAEV,CAoEA,SAAgBE,EAAwB,CACtC,QACA,WACA,mBACA,WACA,SACA,aAAa,GACb,SACA,mBAC+B,CAE/B,OACE,EAAAN,EAAA,IAAA,CAAC,MAAD,CAAK,KAAK,QAAQ,aAAYO,EAAO,UAAU,8BAC5C,UAH2BC,EAAa,CAAC,WAAY,WAAY,SAAS,EAAI,CAAC,WAAY,UAAU,EAAA,CAG9F,IAAI,GAAS,CACnB,IAAMC,EAAaL,IAAaM,EAIhC,OACE,EAAAV,EAAA,IAAA,CAAC,SAAD,CAEE,KAAK,SACK,WACV,eAAcS,EACd,UAAWE,EAAkBA,EAAgBF,CAAU,EATtCA,EACjB,0FACA,6HAQA,cACEG,EACI,GAAGA,EAAO,GAAGF,IAAU,WAAa,SAAWA,IAAU,WAAa,SAAW,QAAQ,GAAGH,IAC5F,IAAA,GAEN,YAAeM,EAAiBH,CAAK,EAEpC,SAAAL,IAASK,IAAUT,EAAOS,EACrB,EAbDA,CAaC,CAEZ,CAAC,CACE,CAAA,CAET,CAiGA,SAAgBI,EAAoB,CAClC,SACA,WACA,mBACA,WACA,SACA,cAAc,MACd,aAAa,MACb,cAAc,GAAUJ,IAAU,KAAO,OAAS,OAAOA,CAAK,EAC9D,QACA,aAC2B,CAC3B,OACE,EAAAV,EAAA,KAAA,CAAC,UAAD,CAAS,aAAYe,EAAO,OAASA,EAAO,MAAkB,YAAW,sBAAqBA,EAAO,MAArG,SAAA,EACE,EAAAf,EAAA,KAAA,CAAC,MAAD,CAAK,UAAU,0BAAf,SAAA,EACE,EAAAA,EAAA,IAAA,CAAC,OAAD,CAAM,UAAU,cAAe,SAAAe,EAAO,OAASA,EAAO,KAAY,CAAA,GAClE,EAAAf,EAAA,IAAA,CAACE,EAAD,CAAqB,WAAkB,QAAS,CAAA,CAC7C,C,IACL,EAAAF,EAAA,KAAA,CAAC,KAAD,CAAI,UAAU,sCAAd,SAAA,EACE,EAAAA,EAAA,KAAA,CAAC,MAAD,CAAA,SAAA,EACE,EAAAA,EAAA,IAAA,CAAC,KAAD,CAAI,UAAU,2BAA4B,SAAAgB,CAAgB,CAAA,GAC1D,EAAAhB,EAAA,IAAA,CAAC,KAAD,CAAA,SAAKiB,EAAYF,EAAO,MAAM,CAAM,CAAA,CACjC,CAAA,CAAA,GACL,EAAAf,EAAA,KAAA,CAAC,MAAD,CAAA,SAAA,EACE,EAAAA,EAAA,IAAA,CAAC,KAAD,CAAI,UAAU,2BAA4B,SAAAkB,CAAe,CAAA,GACzD,EAAAlB,EAAA,IAAA,CAAC,KAAD,CAAA,SAAKiB,EAAYF,EAAO,KAAK,CAAM,CAAA,CAChC,CAAA,CAAA,CACH,C,GACHA,EAAO,SAAU,EAAAf,EAAA,IAAA,CAAC,IAAD,CAAG,UAAU,gCAAiC,SAAAe,EAAO,MAAU,CAAA,GACjF,EAAAf,EAAA,IAAA,CAACM,EAAD,CACE,MAAOS,EAAO,MACJ,WACQ,mBACR,WACF,SACR,WAAA,EACD,CAAA,EACAI,IACC,EAAAnB,EAAA,IAAA,CAAC,IAAD,CAAG,KAAK,QAAQ,UAAU,4BACvB,SAAAmB,CACA,CAAA,CAEE,C,EAEb,C"}

package/dist/ai/proposal/ProposalFieldReview.d.cts

@@ -1,49 +1,211 @@
 import { ReactNode } from 'react';
 import { FieldDecision, SupportedPrimitive } from '@alneas/appkit-core/ai';
-/** Localized labels for a review decision. */
+/**
+ * Display labels for pending, accepted and rejected decisions.
+ *
+ * @see ProposalFieldReview for controlled usage.
+ */
 export type ProposalDecisionLabels = Record<FieldDecision, string>;
-/** Props for DiffBadge. */
+/**
+ * Decision display settings for DiffBadge; see its usage example.
+ *
+ * @see DiffBadge for the canonical usage example.
+ */
 export interface DiffBadgeProps {
+    /**
+     * Current review choice; no save/apply status is implied.
+     */
     decision: FieldDecision;
+    /**
+     * Optional per-choice localized text; omitted values use Japanese defaults.
+     */
     labels?: Partial<ProposalDecisionLabels>;
+    /**
+     * Optional replacement classes; omission uses compact bordered badge classes.
+     */
     className?: string;
 }
-/** Displays review selection without implying that a change has been applied or saved. */
+/**
+ * Displays the current review choice without implying persistence.
+ *
+ * @param props - Controlled state, optional labels/style settings and callbacks.
+ *
+ * @returns Span carrying data-decision and a localized label.
+ *
+ * @remarks Import Appkit styles for utility-class styling; no context provider is required.
+ * Callbacks and formatters are synchronous and their errors propagate. Host code owns
+ * review state and persistence; these controls do not apply changes automatically.
+ *
+ * @example
+ * ```tsx
+ * import { useState } from 'react';
+ * import '@alneas/appkit-react/styles';
+ * import { DiffBadge, type FieldDecision } from '@alneas/appkit-react/ai/proposal';
+ * export function FieldReview() {
+ *   const [decision, setDecision] = useState<FieldDecision>('pending');
+ *   return <DiffBadge decision="pending" />;
+ * }
+ * ```
+ */
 export declare function DiffBadge({ decision, labels, className }: DiffBadgeProps): import('react').JSX.Element;
-/** Controlled accept/reject/reset controls shared by card and field layouts. */
+/**
+ * Controlled choice inputs; see ProposalDecisionButtons for usage.
+ *
+ * @see ProposalDecisionButtons for the canonical usage example.
+ */
 export interface ProposalDecisionButtonsProps {
+    /**
+     * Field key used as group aria-label and optional test-ID suffix.
+     */
     field: string;
+    /**
+     * Current externally controlled choice.
+     */
     decision: FieldDecision;
+    /**
+     * Synchronous callback receiving the clicked choice; the host must update decision.
+     *
+     * @param decision - Clicked pending/accepted/rejected choice.
+     *
+     * @returns No value; the host schedules its controlled state update.
+     */
     onDecisionChange: (decision: FieldDecision) => void;
+    /**
+     * Disable every choice button; defaults to false/undefined.
+     */
     disabled?: boolean;
+    /**
+     * Optional per-choice text; unspecified values use Japanese defaults.
+     */
     labels?: Partial<ProposalDecisionLabels>;
-    /** Enables returning a single field to pending. */
+    /**
+     * Include a pending/reset choice; defaults to false.
+     */
     allowReset?: boolean;
+    /**
+     * Optional prefix for {prefix}-accept/reject/reset-{field} test IDs.
+     */
     testId?: string;
+    /**
+     * Optional synchronous class factory receiving whether this button is selected; replaces default button styling.
+     */
     buttonClassName?: (selected: boolean) => string;
 }
-/** Emits decisions only; does not mutate form values or apply a proposal. */
+/**
+ * Emits controlled accept/reject and optional reset choices.
+ *
+ * @param props - Controlled state, optional labels/style settings and callbacks.
+ *
+ * @returns Button group; no form values or proposals are mutated.
+ *
+ * @remarks Import Appkit styles for utility-class styling; no context provider is required.
+ * Callbacks and formatters are synchronous and their errors propagate. Host code owns
+ * review state and persistence; these controls do not apply changes automatically.
+ *
+ * @example
+ * ```tsx
+ * import { useState } from 'react';
+ * import '@alneas/appkit-react/styles';
+ * import { ProposalDecisionButtons, type FieldDecision } from '@alneas/appkit-react/ai/proposal';
+ * export function FieldReview() {
+ *   const [decision, setDecision] = useState<FieldDecision>('pending');
+ *   return <ProposalDecisionButtons field="title" decision={decision} onDecisionChange={setDecision} />;
+ * }
+ * ```
+ */
 export declare function ProposalDecisionButtons({ field, decision, onDecisionChange, disabled, labels, allowReset, testId, buttonClassName, }: ProposalDecisionButtonsProps): import('react').JSX.Element;
-/** Controlled inline proposal review, suitable beside an existing form field or table cell. */
+/**
+ * Controlled field-diff presentation; see ProposalFieldReview for usage.
+ *
+ * @see ProposalFieldReview for the canonical usage example.
+ */
 export interface ProposalFieldReviewProps {
+    /**
+     * Field identity, before/after primitive values and optional display reason.
+     */
     change: {
+        /**
+         * Stable field identifier used in the section data attribute.
+         */
         readonly field: string;
+        /**
+         * Optional display label; omission uses the field identifier.
+         */
         readonly label?: string;
+        /**
+         * Original supported primitive value.
+         */
         readonly before: SupportedPrimitive;
+        /**
+         * Proposed supported primitive value.
+         */
         readonly after: SupportedPrimitive;
+        /**
+         * Optional explanatory text displayed below the diff.
+         */
         readonly reason?: string;
     };
+    /**
+     * Externally controlled field choice.
+     */
     decision: FieldDecision;
+    /**
+     * Synchronous choice callback; update host state to reflect the selection.
+     *
+     * @param decision - Clicked pending/accepted/rejected choice.
+     *
+     * @returns No value; the host schedules its controlled state update.
+     */
     onDecisionChange: (decision: FieldDecision) => void;
+    /**
+     * Disable review choice buttons; defaults to false/undefined.
+     */
     disabled?: boolean;
+    /**
+     * Optional decision-text overrides; unspecified values use Japanese defaults.
+     */
     labels?: Partial<ProposalDecisionLabels>;
+    /**
+     * Before-value caption, default Japanese label for previous value.
+     */
     beforeLabel?: string;
+    /**
+     * After-value caption, default Japanese label for proposed value.
+     */
     afterLabel?: string;
+    /**
+     * Synchronous value renderer; defaults to null text for null and String(value) otherwise.
+     */
     formatValue?: (value: SupportedPrimitive) => ReactNode;
+    /**
+     * Optional validation message shown with role alert.
+     */
     error?: string;
+    /**
+     * Optional classes on the outer section.
+     */
     className?: string;
 }
 /**
- * Renders a field's proposed values, reason, decision and optional validation message.
+ * Renders before/after values, reason, controlled choices and optional validation feedback.
+ *
+ * @param props - Controlled state, optional labels/style settings and callbacks.
+ *
+ * @returns Section with data-proposal-field and review controls.
+ *
+ * @remarks Import Appkit styles for utility-class styling; no context provider is required.
+ * Callbacks and formatters are synchronous and their errors propagate. Host code owns
+ * review state and persistence; these controls do not apply changes automatically.
+ *
+ * @example
+ * ```tsx
+ * import { useState } from 'react';
+ * import '@alneas/appkit-react/styles';
+ * import { ProposalFieldReview, type FieldDecision } from '@alneas/appkit-react/ai/proposal';
+ * export function FieldReview() {
+ *   const [decision, setDecision] = useState<FieldDecision>('pending');
+ *   return <ProposalFieldReview change={{ field: 'title', before: 'Old', after: 'New' }} decision={decision} onDecisionChange={setDecision} />;
+ * }
+ * ```
  */
 export declare function ProposalFieldReview({ change, decision, onDecisionChange, disabled, labels, beforeLabel, afterLabel, formatValue, error, className, }: ProposalFieldReviewProps): import('react').JSX.Element;

package/dist/ai/proposal/ProposalFieldReview.d.ts

@@ -1,49 +1,211 @@
 import { ReactNode } from 'react';
 import { FieldDecision, SupportedPrimitive } from '@alneas/appkit-core/ai';
-/** Localized labels for a review decision. */
+/**
+ * Display labels for pending, accepted and rejected decisions.
+ *
+ * @see ProposalFieldReview for controlled usage.
+ */
 export type ProposalDecisionLabels = Record<FieldDecision, string>;
-/** Props for DiffBadge. */
+/**
+ * Decision display settings for DiffBadge; see its usage example.
+ *
+ * @see DiffBadge for the canonical usage example.
+ */
 export interface DiffBadgeProps {
+    /**
+     * Current review choice; no save/apply status is implied.
+     */
     decision: FieldDecision;
+    /**
+     * Optional per-choice localized text; omitted values use Japanese defaults.
+     */
     labels?: Partial<ProposalDecisionLabels>;
+    /**
+     * Optional replacement classes; omission uses compact bordered badge classes.
+     */
     className?: string;
 }
-/** Displays review selection without implying that a change has been applied or saved. */
+/**
+ * Displays the current review choice without implying persistence.
+ *
+ * @param props - Controlled state, optional labels/style settings and callbacks.
+ *
+ * @returns Span carrying data-decision and a localized label.
+ *
+ * @remarks Import Appkit styles for utility-class styling; no context provider is required.
+ * Callbacks and formatters are synchronous and their errors propagate. Host code owns
+ * review state and persistence; these controls do not apply changes automatically.
+ *
+ * @example
+ * ```tsx
+ * import { useState } from 'react';
+ * import '@alneas/appkit-react/styles';
+ * import { DiffBadge, type FieldDecision } from '@alneas/appkit-react/ai/proposal';
+ * export function FieldReview() {
+ *   const [decision, setDecision] = useState<FieldDecision>('pending');
+ *   return <DiffBadge decision="pending" />;
+ * }
+ * ```
+ */
 export declare function DiffBadge({ decision, labels, className }: DiffBadgeProps): import('react').JSX.Element;
-/** Controlled accept/reject/reset controls shared by card and field layouts. */
+/**
+ * Controlled choice inputs; see ProposalDecisionButtons for usage.
+ *
+ * @see ProposalDecisionButtons for the canonical usage example.
+ */
 export interface ProposalDecisionButtonsProps {
+    /**
+     * Field key used as group aria-label and optional test-ID suffix.
+     */
     field: string;
+    /**
+     * Current externally controlled choice.
+     */
     decision: FieldDecision;
+    /**
+     * Synchronous callback receiving the clicked choice; the host must update decision.
+     *
+     * @param decision - Clicked pending/accepted/rejected choice.
+     *
+     * @returns No value; the host schedules its controlled state update.
+     */
     onDecisionChange: (decision: FieldDecision) => void;
+    /**
+     * Disable every choice button; defaults to false/undefined.
+     */
     disabled?: boolean;
+    /**
+     * Optional per-choice text; unspecified values use Japanese defaults.
+     */
     labels?: Partial<ProposalDecisionLabels>;
-    /** Enables returning a single field to pending. */
+    /**
+     * Include a pending/reset choice; defaults to false.
+     */
     allowReset?: boolean;
+    /**
+     * Optional prefix for {prefix}-accept/reject/reset-{field} test IDs.
+     */
     testId?: string;
+    /**
+     * Optional synchronous class factory receiving whether this button is selected; replaces default button styling.
+     */
     buttonClassName?: (selected: boolean) => string;
 }
-/** Emits decisions only; does not mutate form values or apply a proposal. */
+/**
+ * Emits controlled accept/reject and optional reset choices.
+ *
+ * @param props - Controlled state, optional labels/style settings and callbacks.
+ *
+ * @returns Button group; no form values or proposals are mutated.
+ *
+ * @remarks Import Appkit styles for utility-class styling; no context provider is required.
+ * Callbacks and formatters are synchronous and their errors propagate. Host code owns
+ * review state and persistence; these controls do not apply changes automatically.
+ *
+ * @example
+ * ```tsx
+ * import { useState } from 'react';
+ * import '@alneas/appkit-react/styles';
+ * import { ProposalDecisionButtons, type FieldDecision } from '@alneas/appkit-react/ai/proposal';
+ * export function FieldReview() {
+ *   const [decision, setDecision] = useState<FieldDecision>('pending');
+ *   return <ProposalDecisionButtons field="title" decision={decision} onDecisionChange={setDecision} />;
+ * }
+ * ```
+ */
 export declare function ProposalDecisionButtons({ field, decision, onDecisionChange, disabled, labels, allowReset, testId, buttonClassName, }: ProposalDecisionButtonsProps): import('react').JSX.Element;
-/** Controlled inline proposal review, suitable beside an existing form field or table cell. */
+/**
+ * Controlled field-diff presentation; see ProposalFieldReview for usage.
+ *
+ * @see ProposalFieldReview for the canonical usage example.
+ */
 export interface ProposalFieldReviewProps {
+    /**
+     * Field identity, before/after primitive values and optional display reason.
+     */
     change: {
+        /**
+         * Stable field identifier used in the section data attribute.
+         */
         readonly field: string;
+        /**
+         * Optional display label; omission uses the field identifier.
+         */
         readonly label?: string;
+        /**
+         * Original supported primitive value.
+         */
         readonly before: SupportedPrimitive;
+        /**
+         * Proposed supported primitive value.
+         */
         readonly after: SupportedPrimitive;
+        /**
+         * Optional explanatory text displayed below the diff.
+         */
         readonly reason?: string;
     };
+    /**
+     * Externally controlled field choice.
+     */
     decision: FieldDecision;
+    /**
+     * Synchronous choice callback; update host state to reflect the selection.
+     *
+     * @param decision - Clicked pending/accepted/rejected choice.
+     *
+     * @returns No value; the host schedules its controlled state update.
+     */
     onDecisionChange: (decision: FieldDecision) => void;
+    /**
+     * Disable review choice buttons; defaults to false/undefined.
+     */
     disabled?: boolean;
+    /**
+     * Optional decision-text overrides; unspecified values use Japanese defaults.
+     */
     labels?: Partial<ProposalDecisionLabels>;
+    /**
+     * Before-value caption, default Japanese label for previous value.
+     */
     beforeLabel?: string;
+    /**
+     * After-value caption, default Japanese label for proposed value.
+     */
     afterLabel?: string;
+    /**
+     * Synchronous value renderer; defaults to null text for null and String(value) otherwise.
+     */
     formatValue?: (value: SupportedPrimitive) => ReactNode;
+    /**
+     * Optional validation message shown with role alert.
+     */
     error?: string;
+    /**
+     * Optional classes on the outer section.
+     */
     className?: string;
 }
 /**
- * Renders a field's proposed values, reason, decision and optional validation message.
+ * Renders before/after values, reason, controlled choices and optional validation feedback.
+ *
+ * @param props - Controlled state, optional labels/style settings and callbacks.
+ *
+ * @returns Section with data-proposal-field and review controls.
+ *
+ * @remarks Import Appkit styles for utility-class styling; no context provider is required.
+ * Callbacks and formatters are synchronous and their errors propagate. Host code owns
+ * review state and persistence; these controls do not apply changes automatically.
+ *
+ * @example
+ * ```tsx
+ * import { useState } from 'react';
+ * import '@alneas/appkit-react/styles';
+ * import { ProposalFieldReview, type FieldDecision } from '@alneas/appkit-react/ai/proposal';
+ * export function FieldReview() {
+ *   const [decision, setDecision] = useState<FieldDecision>('pending');
+ *   return <ProposalFieldReview change={{ field: 'title', before: 'Old', after: 'New' }} decision={decision} onDecisionChange={setDecision} />;
+ * }
+ * ```
  */
 export declare function ProposalFieldReview({ change, decision, onDecisionChange, disabled, labels, beforeLabel, afterLabel, formatValue, error, className, }: ProposalFieldReviewProps): import('react').JSX.Element;

package/dist/ai/proposal/ProposalFieldReview.js.map

@@ -1 +1 @@
-{"version":3,"file":"ProposalFieldReview.js","names":["LABELS","DiffBadge","className","decision","labels","ProposalDecisionButtons","field","allowReset","isSelected","value","buttonClassName","testId","onDecisionChange","ProposalFieldReview","change","beforeLabel","formatValue","afterLabel","error"],"sources":["../../../src/ai/proposal/ProposalFieldReview.tsx"],"sourcesContent":["import type { ReactNode } from 'react';\nimport type { FieldDecision, SupportedPrimitive } from \"@alneas/appkit-core/ai\";\n\n/** Localized labels for a review decision. */\nexport type ProposalDecisionLabels = Record<FieldDecision, string>;\nconst LABELS: ProposalDecisionLabels = { pending: '未判断', accepted: '採用', rejected: '却下' };\n\n/** Props for DiffBadge. */\nexport interface DiffBadgeProps {\n  decision: FieldDecision;\n  labels?: Partial<ProposalDecisionLabels>;\n  className?: string;\n}\n\n/** Displays review selection without implying that a change has been applied or saved. */\nexport function DiffBadge({ decision, labels, className }: DiffBadgeProps) {\n  return (\n    <span\n      className={className ?? 'inline-flex items-center px-2 py-0.5 rounded text-xs font-medium border'}\n      data-decision={decision}\n    >\n      {labels?.[decision] ?? LABELS[decision]}\n    </span>\n  );\n}\n\n/** Controlled accept/reject/reset controls shared by card and field layouts. */\nexport interface ProposalDecisionButtonsProps {\n  field: string;\n  decision: FieldDecision;\n  onDecisionChange: (decision: FieldDecision) => void;\n  disabled?: boolean;\n  labels?: Partial<ProposalDecisionLabels>;\n  /** Enables returning a single field to pending. */\n  allowReset?: boolean;\n  testId?: string;\n  buttonClassName?: (selected: boolean) => string;\n}\n\n/** Emits decisions only; does not mutate form values or apply a proposal. */\nexport function ProposalDecisionButtons({\n  field,\n  decision,\n  onDecisionChange,\n  disabled,\n  labels,\n  allowReset = false,\n  testId,\n  buttonClassName,\n}: ProposalDecisionButtonsProps) {\n  const values: FieldDecision[] = allowReset ? ['accepted', 'rejected', 'pending'] : ['accepted', 'rejected'];\n  return (\n    <div role=\"group\" aria-label={field} className=\"inline-flex flex-wrap gap-1\">\n      {values.map(value => {\n        const isSelected = decision === value;\n        const defaultClass = isSelected\n          ? 'px-2 py-1 text-xs rounded bg-neutral-900 text-white dark:bg-white dark:text-neutral-900'\n          : 'px-2 py-1 text-xs rounded border border-neutral-300 dark:border-neutral-700 hover:bg-neutral-100 dark:hover:bg-neutral-800';\n        return (\n          <button\n            key={value}\n            type=\"button\"\n            disabled={disabled}\n            aria-pressed={isSelected}\n            className={buttonClassName ? buttonClassName(isSelected) : defaultClass}\n            data-testid={\n              testId\n                ? `${testId}-${value === 'accepted' ? 'accept' : value === 'rejected' ? 'reject' : 'reset'}-${field}`\n                : undefined\n            }\n            onClick={() => onDecisionChange(value)}\n          >\n            {labels?.[value] ?? LABELS[value]}\n          </button>\n        );\n      })}\n    </div>\n  );\n}\n\n/** Controlled inline proposal review, suitable beside an existing form field or table cell. */\nexport interface ProposalFieldReviewProps {\n  change: {\n    readonly field: string;\n    readonly label?: string;\n    readonly before: SupportedPrimitive;\n    readonly after: SupportedPrimitive;\n    readonly reason?: string;\n  };\n  decision: FieldDecision;\n  onDecisionChange: (decision: FieldDecision) => void;\n  disabled?: boolean;\n  labels?: Partial<ProposalDecisionLabels>;\n  beforeLabel?: string;\n  afterLabel?: string;\n  formatValue?: (value: SupportedPrimitive) => ReactNode;\n  error?: string;\n  className?: string;\n}\n\n/**\n * Renders a field's proposed values, reason, decision and optional validation message.\n */\nexport function ProposalFieldReview({\n  change,\n  decision,\n  onDecisionChange,\n  disabled,\n  labels,\n  beforeLabel = '変更前',\n  afterLabel = '提案値',\n  formatValue = value => (value === null ? 'null' : String(value)),\n  error,\n  className,\n}: ProposalFieldReviewProps) {\n  return (\n    <section aria-label={change.label ?? change.field} className={className} data-proposal-field={change.field}>\n      <div className=\"flex items-center gap-2\">\n        <span className=\"font-medium\">{change.label ?? change.field}</span>\n        <DiffBadge decision={decision} labels={labels} />\n      </div>\n      <dl className=\"grid grid-cols-2 gap-2 text-sm my-2\">\n        <div>\n          <dt className=\"text-neutral-500 text-xs\">{beforeLabel}</dt>\n          <dd>{formatValue(change.before)}</dd>\n        </div>\n        <div>\n          <dt className=\"text-neutral-500 text-xs\">{afterLabel}</dt>\n          <dd>{formatValue(change.after)}</dd>\n        </div>\n      </dl>\n      {change.reason && <p className=\"text-xs text-neutral-500 my-1\">{change.reason}</p>}\n      <ProposalDecisionButtons\n        field={change.field}\n        decision={decision}\n        onDecisionChange={onDecisionChange}\n        disabled={disabled}\n        labels={labels}\n        allowReset\n      />\n      {error && (\n        <p role=\"alert\" className=\"text-sm text-red-600 mt-1\">\n          {error}\n        </p>\n      )}\n    </section>\n  );\n}\n"],"mappings":";;;AAKA,IAAMA,IAAiC;CAAE,SAAS;CAAO,UAAU;CAAM,UAAU;AAAK;AAUxF,SAAgBC,EAAU,EAAE,aAAU,WAAQ,gBAA6B;CACzE,OACE,kBAAC,QAAD;EACE,WAAWC,KAAa;EACxB,iBAAeC;EAEd,UAAAC,IAASD,MAAaH,EAAOG;CAC1B,CAAA;AAEV;AAgBA,SAAgBE,EAAwB,EACtC,UACA,aACA,qBACA,aACA,WACA,gBAAa,IACb,WACA,sBAC+B;CAE/B,OACE,kBAAC,OAAD;EAAK,MAAK;EAAQ,cAAYC;EAAO,WAAU;EAC5C,WAH2BC,IAAa;GAAC;GAAY;GAAY;EAAS,IAAI,CAAC,YAAY,UAAU,EAAA,CAG9F,KAAI,MAAS;GACnB,IAAMC,IAAaL,MAAaM;GAIhC,OACE,kBAAC,UAAD;IAEE,MAAK;IACK;IACV,gBAAcD;IACd,WAAWE,IAAkBA,EAAgBF,CAAU,IATtCA,IACjB,4FACA;IAQA,eACEG,IACI,GAAGA,EAAO,GAAGF,MAAU,aAAa,WAAWA,MAAU,aAAa,WAAW,QAAQ,GAAGH,MAC5F,KAAA;IAEN,eAAeM,EAAiBH,CAAK;IAEpC,UAAAL,IAASK,MAAUT,EAAOS;GACrB,GAbDA,CAaC;EAEZ,CAAC;CACE,CAAA;AAET;AAyBA,SAAgBI,EAAoB,EAClC,WACA,aACA,qBACA,aACA,WACA,iBAAc,OACd,gBAAa,OACb,kBAAc,MAAUJ,MAAU,OAAO,SAAS,OAAOA,CAAK,GAC9D,UACA,gBAC2B;CAC3B,OACE,kBAAC,WAAD;EAAS,cAAYK,EAAO,SAASA,EAAO;EAAkB;EAAW,uBAAqBA,EAAO;EAArG,UAAA;GACE,kBAAC,OAAD;IAAK,WAAU;IAAf,UAAA,CACE,kBAAC,QAAD;KAAM,WAAU;KAAe,UAAAA,EAAO,SAASA,EAAO;IAAY,CAAA,GAClE,kBAACb,GAAD;KAAqB;KAAkB;IAAS,CAAA,CAC7C;;GACL,kBAAC,MAAD;IAAI,WAAU;IAAd,UAAA,CACE,kBAAC,OAAD,EAAA,UAAA,CACE,kBAAC,MAAD;KAAI,WAAU;KAA4B,UAAAc;IAAgB,CAAA,GAC1D,kBAAC,MAAD,EAAA,UAAKC,EAAYF,EAAO,MAAM,EAAM,CAAA,CACjC,EAAA,CAAA,GACL,kBAAC,OAAD,EAAA,UAAA,CACE,kBAAC,MAAD;KAAI,WAAU;KAA4B,UAAAG;IAAe,CAAA,GACzD,kBAAC,MAAD,EAAA,UAAKD,EAAYF,EAAO,KAAK,EAAM,CAAA,CAChC,EAAA,CAAA,CACH;;GACHA,EAAO,UAAU,kBAAC,KAAD;IAAG,WAAU;IAAiC,UAAAA,EAAO;GAAU,CAAA;GACjF,kBAACT,GAAD;IACE,OAAOS,EAAO;IACJ;IACQ;IACR;IACF;IACR,YAAA;GACD,CAAA;GACAI,KACC,kBAAC,KAAD;IAAG,MAAK;IAAQ,WAAU;IACvB,UAAAA;GACA,CAAA;EAEE;;AAEb"}
+{"version":3,"file":"ProposalFieldReview.js","names":["LABELS","DiffBadge","className","decision","labels","ProposalDecisionButtons","field","allowReset","isSelected","value","buttonClassName","testId","onDecisionChange","ProposalFieldReview","change","beforeLabel","formatValue","afterLabel","error"],"sources":["../../../src/ai/proposal/ProposalFieldReview.tsx"],"sourcesContent":["import type { ReactNode } from 'react';\nimport type { FieldDecision, SupportedPrimitive } from \"@alneas/appkit-core/ai\";\n\n/**\n * Display labels for pending, accepted and rejected decisions.\n *\n * @see ProposalFieldReview for controlled usage.\n */\nexport type ProposalDecisionLabels = Record<FieldDecision, string>;\nconst LABELS: ProposalDecisionLabels = { pending: '未判断', accepted: '採用', rejected: '却下' };\n\n/**\n * Decision display settings for DiffBadge; see its usage example.\n *\n * @see DiffBadge for the canonical usage example.\n */\nexport interface DiffBadgeProps {\n  /**\n   * Current review choice; no save/apply status is implied.\n   */\n  decision: FieldDecision;\n  /**\n   * Optional per-choice localized text; omitted values use Japanese defaults.\n   */\n  labels?: Partial<ProposalDecisionLabels>;\n  /**\n   * Optional replacement classes; omission uses compact bordered badge classes.\n   */\n  className?: string;\n}\n\n/**\n * Displays the current review choice without implying persistence.\n *\n * @param props - Controlled state, optional labels/style settings and callbacks.\n *\n * @returns Span carrying data-decision and a localized label.\n *\n * @remarks Import Appkit styles for utility-class styling; no context provider is required.\n * Callbacks and formatters are synchronous and their errors propagate. Host code owns\n * review state and persistence; these controls do not apply changes automatically.\n *\n * @example\n * ```tsx\n * import { useState } from 'react';\n * import '@alneas/appkit-react/styles';\n * import { DiffBadge, type FieldDecision } from '@alneas/appkit-react/ai/proposal';\n * export function FieldReview() {\n *   const [decision, setDecision] = useState<FieldDecision>('pending');\n *   return <DiffBadge decision=\"pending\" />;\n * }\n * ```\n */\nexport function DiffBadge({ decision, labels, className }: DiffBadgeProps) {\n  return (\n    <span\n      className={className ?? 'inline-flex items-center px-2 py-0.5 rounded text-xs font-medium border'}\n      data-decision={decision}\n    >\n      {labels?.[decision] ?? LABELS[decision]}\n    </span>\n  );\n}\n\n/**\n * Controlled choice inputs; see ProposalDecisionButtons for usage.\n *\n * @see ProposalDecisionButtons for the canonical usage example.\n */\nexport interface ProposalDecisionButtonsProps {\n  /**\n   * Field key used as group aria-label and optional test-ID suffix.\n   */\n  field: string;\n  /**\n   * Current externally controlled choice.\n   */\n  decision: FieldDecision;\n  /**\n   * Synchronous callback receiving the clicked choice; the host must update decision.\n   *\n   * @param decision - Clicked pending/accepted/rejected choice.\n   *\n   * @returns No value; the host schedules its controlled state update.\n   */\n  onDecisionChange: (decision: FieldDecision) => void;\n  /**\n   * Disable every choice button; defaults to false/undefined.\n   */\n  disabled?: boolean;\n  /**\n   * Optional per-choice text; unspecified values use Japanese defaults.\n   */\n  labels?: Partial<ProposalDecisionLabels>;\n    /**\n     * Include a pending/reset choice; defaults to false.\n     */\n  allowReset?: boolean;\n  /**\n   * Optional prefix for {prefix}-accept/reject/reset-{field} test IDs.\n   */\n  testId?: string;\n  /**\n   * Optional synchronous class factory receiving whether this button is selected; replaces default button styling.\n   */\n  buttonClassName?: (selected: boolean) => string;\n}\n\n/**\n * Emits controlled accept/reject and optional reset choices.\n *\n * @param props - Controlled state, optional labels/style settings and callbacks.\n *\n * @returns Button group; no form values or proposals are mutated.\n *\n * @remarks Import Appkit styles for utility-class styling; no context provider is required.\n * Callbacks and formatters are synchronous and their errors propagate. Host code owns\n * review state and persistence; these controls do not apply changes automatically.\n *\n * @example\n * ```tsx\n * import { useState } from 'react';\n * import '@alneas/appkit-react/styles';\n * import { ProposalDecisionButtons, type FieldDecision } from '@alneas/appkit-react/ai/proposal';\n * export function FieldReview() {\n *   const [decision, setDecision] = useState<FieldDecision>('pending');\n *   return <ProposalDecisionButtons field=\"title\" decision={decision} onDecisionChange={setDecision} />;\n * }\n * ```\n */\nexport function ProposalDecisionButtons({\n  field,\n  decision,\n  onDecisionChange,\n  disabled,\n  labels,\n  allowReset = false,\n  testId,\n  buttonClassName,\n}: ProposalDecisionButtonsProps) {\n  const values: FieldDecision[] = allowReset ? ['accepted', 'rejected', 'pending'] : ['accepted', 'rejected'];\n  return (\n    <div role=\"group\" aria-label={field} className=\"inline-flex flex-wrap gap-1\">\n      {values.map(value => {\n        const isSelected = decision === value;\n        const defaultClass = isSelected\n          ? 'px-2 py-1 text-xs rounded bg-neutral-900 text-white dark:bg-white dark:text-neutral-900'\n          : 'px-2 py-1 text-xs rounded border border-neutral-300 dark:border-neutral-700 hover:bg-neutral-100 dark:hover:bg-neutral-800';\n        return (\n          <button\n            key={value}\n            type=\"button\"\n            disabled={disabled}\n            aria-pressed={isSelected}\n            className={buttonClassName ? buttonClassName(isSelected) : defaultClass}\n            data-testid={\n              testId\n                ? `${testId}-${value === 'accepted' ? 'accept' : value === 'rejected' ? 'reject' : 'reset'}-${field}`\n                : undefined\n            }\n            onClick={() => onDecisionChange(value)}\n          >\n            {labels?.[value] ?? LABELS[value]}\n          </button>\n        );\n      })}\n    </div>\n  );\n}\n\n/**\n * Controlled field-diff presentation; see ProposalFieldReview for usage.\n *\n * @see ProposalFieldReview for the canonical usage example.\n */\nexport interface ProposalFieldReviewProps {\n  /**\n   * Field identity, before/after primitive values and optional display reason.\n   */\n  change: {\n    /**\n     * Stable field identifier used in the section data attribute.\n     */\n    readonly field: string;\n    /**\n     * Optional display label; omission uses the field identifier.\n     */\n    readonly label?: string;\n    /**\n     * Original supported primitive value.\n     */\n    readonly before: SupportedPrimitive;\n    /**\n     * Proposed supported primitive value.\n     */\n    readonly after: SupportedPrimitive;\n    /**\n     * Optional explanatory text displayed below the diff.\n     */\n    readonly reason?: string;\n  };\n  /**\n   * Externally controlled field choice.\n   */\n  decision: FieldDecision;\n  /**\n   * Synchronous choice callback; update host state to reflect the selection.\n   *\n   * @param decision - Clicked pending/accepted/rejected choice.\n   *\n   * @returns No value; the host schedules its controlled state update.\n   */\n  onDecisionChange: (decision: FieldDecision) => void;\n  /**\n   * Disable review choice buttons; defaults to false/undefined.\n   */\n  disabled?: boolean;\n  /**\n   * Optional decision-text overrides; unspecified values use Japanese defaults.\n   */\n  labels?: Partial<ProposalDecisionLabels>;\n  /**\n   * Before-value caption, default Japanese label for previous value.\n   */\n  beforeLabel?: string;\n  /**\n   * After-value caption, default Japanese label for proposed value.\n   */\n  afterLabel?: string;\n  /**\n   * Synchronous value renderer; defaults to null text for null and String(value) otherwise.\n   */\n  formatValue?: (value: SupportedPrimitive) => ReactNode;\n  /**\n   * Optional validation message shown with role alert.\n   */\n  error?: string;\n  /**\n   * Optional classes on the outer section.\n   */\n  className?: string;\n}\n\n/**\n * Renders before/after values, reason, controlled choices and optional validation feedback.\n *\n * @param props - Controlled state, optional labels/style settings and callbacks.\n *\n * @returns Section with data-proposal-field and review controls.\n *\n * @remarks Import Appkit styles for utility-class styling; no context provider is required.\n * Callbacks and formatters are synchronous and their errors propagate. Host code owns\n * review state and persistence; these controls do not apply changes automatically.\n *\n * @example\n * ```tsx\n * import { useState } from 'react';\n * import '@alneas/appkit-react/styles';\n * import { ProposalFieldReview, type FieldDecision } from '@alneas/appkit-react/ai/proposal';\n * export function FieldReview() {\n *   const [decision, setDecision] = useState<FieldDecision>('pending');\n *   return <ProposalFieldReview change={{ field: 'title', before: 'Old', after: 'New' }} decision={decision} onDecisionChange={setDecision} />;\n * }\n * ```\n */\nexport function ProposalFieldReview({\n  change,\n  decision,\n  onDecisionChange,\n  disabled,\n  labels,\n  beforeLabel = '変更前',\n  afterLabel = '提案値',\n  formatValue = value => (value === null ? 'null' : String(value)),\n  error,\n  className,\n}: ProposalFieldReviewProps) {\n  return (\n    <section aria-label={change.label ?? change.field} className={className} data-proposal-field={change.field}>\n      <div className=\"flex items-center gap-2\">\n        <span className=\"font-medium\">{change.label ?? change.field}</span>\n        <DiffBadge decision={decision} labels={labels} />\n      </div>\n      <dl className=\"grid grid-cols-2 gap-2 text-sm my-2\">\n        <div>\n          <dt className=\"text-neutral-500 text-xs\">{beforeLabel}</dt>\n          <dd>{formatValue(change.before)}</dd>\n        </div>\n        <div>\n          <dt className=\"text-neutral-500 text-xs\">{afterLabel}</dt>\n          <dd>{formatValue(change.after)}</dd>\n        </div>\n      </dl>\n      {change.reason && <p className=\"text-xs text-neutral-500 my-1\">{change.reason}</p>}\n      <ProposalDecisionButtons\n        field={change.field}\n        decision={decision}\n        onDecisionChange={onDecisionChange}\n        disabled={disabled}\n        labels={labels}\n        allowReset\n      />\n      {error && (\n        <p role=\"alert\" className=\"text-sm text-red-600 mt-1\">\n          {error}\n        </p>\n      )}\n    </section>\n  );\n}\n"],"mappings":";;;AASA,IAAMA,IAAiC;CAAE,SAAS;CAAO,UAAU;CAAM,UAAU;AAAK;AA4CxF,SAAgBC,EAAU,EAAE,aAAU,WAAQ,gBAA6B;CACzE,OACE,kBAAC,QAAD;EACE,WAAWC,KAAa;EACxB,iBAAeC;EAEd,UAAAC,IAASD,MAAaH,EAAOG;CAC1B,CAAA;AAEV;AAoEA,SAAgBE,EAAwB,EACtC,UACA,aACA,qBACA,aACA,WACA,gBAAa,IACb,WACA,sBAC+B;CAE/B,OACE,kBAAC,OAAD;EAAK,MAAK;EAAQ,cAAYC;EAAO,WAAU;EAC5C,WAH2BC,IAAa;GAAC;GAAY;GAAY;EAAS,IAAI,CAAC,YAAY,UAAU,EAAA,CAG9F,KAAI,MAAS;GACnB,IAAMC,IAAaL,MAAaM;GAIhC,OACE,kBAAC,UAAD;IAEE,MAAK;IACK;IACV,gBAAcD;IACd,WAAWE,IAAkBA,EAAgBF,CAAU,IATtCA,IACjB,4FACA;IAQA,eACEG,IACI,GAAGA,EAAO,GAAGF,MAAU,aAAa,WAAWA,MAAU,aAAa,WAAW,QAAQ,GAAGH,MAC5F,KAAA;IAEN,eAAeM,EAAiBH,CAAK;IAEpC,UAAAL,IAASK,MAAUT,EAAOS;GACrB,GAbDA,CAaC;EAEZ,CAAC;CACE,CAAA;AAET;AAiGA,SAAgBI,EAAoB,EAClC,WACA,aACA,qBACA,aACA,WACA,iBAAc,OACd,gBAAa,OACb,kBAAc,MAAUJ,MAAU,OAAO,SAAS,OAAOA,CAAK,GAC9D,UACA,gBAC2B;CAC3B,OACE,kBAAC,WAAD;EAAS,cAAYK,EAAO,SAASA,EAAO;EAAkB;EAAW,uBAAqBA,EAAO;EAArG,UAAA;GACE,kBAAC,OAAD;IAAK,WAAU;IAAf,UAAA,CACE,kBAAC,QAAD;KAAM,WAAU;KAAe,UAAAA,EAAO,SAASA,EAAO;IAAY,CAAA,GAClE,kBAACb,GAAD;KAAqB;KAAkB;IAAS,CAAA,CAC7C;;GACL,kBAAC,MAAD;IAAI,WAAU;IAAd,UAAA,CACE,kBAAC,OAAD,EAAA,UAAA,CACE,kBAAC,MAAD;KAAI,WAAU;KAA4B,UAAAc;IAAgB,CAAA,GAC1D,kBAAC,MAAD,EAAA,UAAKC,EAAYF,EAAO,MAAM,EAAM,CAAA,CACjC,EAAA,CAAA,GACL,kBAAC,OAAD,EAAA,UAAA,CACE,kBAAC,MAAD;KAAI,WAAU;KAA4B,UAAAG;IAAe,CAAA,GACzD,kBAAC,MAAD,EAAA,UAAKD,EAAYF,EAAO,KAAK,EAAM,CAAA,CAChC,EAAA,CAAA,CACH;;GACHA,EAAO,UAAU,kBAAC,KAAD;IAAG,WAAU;IAAiC,UAAAA,EAAO;GAAU,CAAA;GACjF,kBAACT,GAAD;IACE,OAAOS,EAAO;IACJ;IACQ;IACR;IACF;IACR,YAAA;GACD,CAAA;GACAI,KACC,kBAAC,KAAD;IAAG,MAAK;IAAQ,WAAU;IACvB,UAAAA;GACA,CAAA;EAEE;;AAEb"}