{
  "$schema": "https://ui.shadcn.com/schema/registry-item.json",
  "name": "approval-card",
  "type": "registry:block",
  "title": "Approval Card",
  "description": "Binary confirmation for agent actions.",
  "dependencies": [
    "lucide-react",
    "zod"
  ],
  "registryDependencies": [
    "button",
    "separator"
  ],
  "files": [
    {
      "path": "components/tool-ui/approval-card/_adapter.tsx",
      "type": "registry:component",
      "target": "components/tool-ui/approval-card/_adapter.tsx",
      "content": "/**\n * Adapter: UI and utility re-exports for copy-standalone portability.\n *\n * When copying this component to another project, update these imports\n * to match your project's paths:\n *\n *   cn → Your Tailwind merge utility (e.g., \"@/lib/utils\", \"~/lib/cn\")\n */\n\nexport { cn } from \"@/lib/utils\";\nexport { Separator } from \"@/components/ui/separator\";\n"
    },
    {
      "path": "components/tool-ui/approval-card/approval-card.tsx",
      "type": "registry:component",
      "target": "components/tool-ui/approval-card/approval-card.tsx",
      "content": "\"use client\";\n\nimport * as React from \"react\";\nimport { cn, Separator } from \"./_adapter\";\nimport type { ApprovalCardProps, ApprovalDecision } from \"./schema\";\nimport { ActionButtons } from \"../shared/action-buttons\";\nimport { type Action } from \"../shared/schema\";\n\nimport { icons, Check, X } from \"lucide-react\";\n\ntype LucideIcon = React.ComponentType<{ className?: string }>;\n\nfunction getLucideIcon(name: string): LucideIcon | null {\n  const pascalName = name\n    .split(\"-\")\n    .map((part) => part.charAt(0).toUpperCase() + part.slice(1))\n    .join(\"\");\n\n  const Icon = icons[pascalName as keyof typeof icons];\n  return Icon ?? null;\n}\n\ninterface ApprovalCardReceiptProps {\n  id: string;\n  title: string;\n  choice: ApprovalDecision;\n  actionLabel?: string;\n  className?: string;\n}\n\nfunction ApprovalCardReceipt({\n  id,\n  title,\n  choice,\n  actionLabel,\n  className,\n}: ApprovalCardReceiptProps) {\n  const isApproved = choice === \"approved\";\n  const displayLabel = actionLabel ?? (isApproved ? \"Approved\" : \"Denied\");\n\n  return (\n    <div\n      className={cn(\n        \"flex w-full min-w-64 max-w-md flex-col\",\n        \"text-foreground\",\n        \"motion-safe:animate-in motion-safe:fade-in motion-safe:blur-in-sm motion-safe:zoom-in-95 motion-safe:duration-300 motion-safe:ease-[cubic-bezier(0.16,1,0.3,1)] motion-safe:fill-mode-both\",\n        className,\n      )}\n      data-slot=\"approval-card\"\n      data-tool-ui-id={id}\n      data-receipt=\"true\"\n      role=\"status\"\n      aria-label={displayLabel}\n    >\n      <div\n        className={cn(\n          \"bg-card/60 flex w-full items-center gap-3 rounded-2xl border px-4 py-3 shadow-xs\",\n        )}\n      >\n        <span\n          className={cn(\n            \"flex size-8 shrink-0 items-center justify-center rounded-full bg-muted\",\n            isApproved ? \"text-primary\" : \"text-muted-foreground\",\n          )}\n        >\n          {isApproved ? <Check className=\"size-4\" /> : <X className=\"size-4\" />}\n        </span>\n        <div className=\"flex flex-col\">\n          <span className=\"text-sm font-medium\">{displayLabel}</span>\n          <span className=\"text-muted-foreground text-sm\">{title}</span>\n        </div>\n      </div>\n    </div>\n  );\n}\n\nexport function ApprovalCard({\n  id,\n  title,\n  description,\n  icon,\n  metadata,\n  variant,\n  confirmLabel,\n  cancelLabel,\n  className,\n  choice,\n  onConfirm,\n  onCancel,\n}: ApprovalCardProps) {\n  const resolvedVariant = variant ?? \"default\";\n  const resolvedConfirmLabel = confirmLabel ?? \"Approve\";\n  const resolvedCancelLabel = cancelLabel ?? \"Deny\";\n  const Icon = icon ? getLucideIcon(icon) : null;\n\n  const handleAction = React.useCallback(\n    async (actionId: string) => {\n      if (actionId === \"confirm\") {\n        await onConfirm?.();\n      } else if (actionId === \"cancel\") {\n        await onCancel?.();\n      }\n    },\n    [onConfirm, onCancel],\n  );\n\n  const handleKeyDown = React.useCallback(\n    (event: React.KeyboardEvent) => {\n      if (event.key === \"Escape\") {\n        event.preventDefault();\n        onCancel?.();\n      }\n    },\n    [onCancel],\n  );\n\n  const isDestructive = resolvedVariant === \"destructive\";\n\n  const actions: Action[] = [\n    {\n      id: \"cancel\",\n      label: resolvedCancelLabel,\n      variant: \"ghost\",\n    },\n    {\n      id: \"confirm\",\n      label: resolvedConfirmLabel,\n      variant: isDestructive ? \"destructive\" : \"default\",\n    },\n  ];\n\n  const viewKey = choice ? `receipt-${choice}` : \"interactive\";\n\n  return (\n    <div key={viewKey} className=\"contents\">\n      {choice ? (\n        <ApprovalCardReceipt\n          id={id}\n          title={title}\n          choice={choice}\n          className={className}\n        />\n      ) : (\n        <article\n          className={cn(\n            \"flex w-full min-w-64 max-w-md flex-col gap-3\",\n            \"text-foreground\",\n            className,\n          )}\n          data-slot=\"approval-card\"\n          data-tool-ui-id={id}\n          role=\"dialog\"\n          aria-labelledby={`${id}-title`}\n          aria-describedby={description ? `${id}-description` : undefined}\n          onKeyDown={handleKeyDown}\n        >\n          <div className=\"bg-card flex w-full flex-col gap-4 rounded-2xl border p-5 shadow-xs\">\n            <div className=\"flex items-start gap-3\">\n              {Icon && (\n                <span\n                  className={cn(\n                    \"flex size-10 shrink-0 items-center justify-center rounded-xl\",\n                    isDestructive\n                      ? \"bg-destructive/10 text-destructive\"\n                      : \"bg-primary/10 text-primary\",\n                  )}\n                >\n                  <Icon className=\"size-5\" />\n                </span>\n              )}\n              <div className=\"flex flex-1 flex-col gap-1\">\n                <h2\n                  id={`${id}-title`}\n                  className=\"text-base font-semibold leading-tight\"\n                >\n                  {title}\n                </h2>\n                {description && (\n                  <p\n                    id={`${id}-description`}\n                    className=\"text-muted-foreground text-sm\"\n                  >\n                    {description}\n                  </p>\n                )}\n              </div>\n            </div>\n\n            {metadata && metadata.length > 0 && (\n              <>\n                <Separator />\n                <dl className=\"flex flex-col gap-2 text-sm\">\n                  {metadata.map((item, index) => (\n                    <div key={index} className=\"flex justify-between gap-4\">\n                      <dt className=\"text-muted-foreground shrink-0\">\n                        {item.key}\n                      </dt>\n                      <dd className=\"min-w-0 truncate\">{item.value}</dd>\n                    </div>\n                  ))}\n                </dl>\n              </>\n            )}\n          </div>\n          <div className=\"@container/actions\">\n            <ActionButtons actions={actions} onAction={handleAction} />\n          </div>\n        </article>\n      )}\n    </div>\n  );\n}\n"
    },
    {
      "path": "components/tool-ui/approval-card/index.tsx",
      "type": "registry:component",
      "target": "components/tool-ui/approval-card/index.tsx",
      "content": "export { ApprovalCard } from \"./approval-card\";\nexport {\n  type SerializableApprovalCard,\n  type ApprovalCardProps,\n  type ApprovalDecision,\n  type MetadataItem,\n} from \"./schema\";\n"
    },
    {
      "path": "components/tool-ui/approval-card/README.md",
      "type": "registry:file",
      "target": "components/tool-ui/approval-card/README.md",
      "content": "# Approval Card\n\nImplementation for the \"approval-card\" Tool UI surface.\n\n## Files\n\n- public exports: components/tool-ui/approval-card/index.tsx\n- serializable schema + parse helpers: components/tool-ui/approval-card/schema.ts\n\n## Companion assets\n\n- Docs page: app/docs/approval-card/content.mdx\n- Preset payload: lib/presets/approval-card.ts\n\n## Quick check\n\nRun this after edits:\n\npnpm test\n"
    },
    {
      "path": "components/tool-ui/approval-card/schema.ts",
      "type": "registry:lib",
      "target": "components/tool-ui/approval-card/schema.ts",
      "content": "import { z } from \"zod\";\nimport { ToolUIIdSchema, ToolUIRoleSchema } from \"../shared/schema\";\nimport { defineToolUiContract } from \"../shared/contract\";\n\nexport const MetadataItemSchema = z.object({\n  key: z.string().min(1),\n  value: z.string(),\n});\n\nexport type MetadataItem = z.infer<typeof MetadataItemSchema>;\n\nexport const ApprovalDecisionSchema = z.enum([\"approved\", \"denied\"]);\n\nexport type ApprovalDecision = z.infer<typeof ApprovalDecisionSchema>;\n\nexport const SerializableApprovalCardSchema = z.object({\n  id: ToolUIIdSchema,\n  role: ToolUIRoleSchema.optional(),\n\n  title: z.string().min(1),\n  description: z.string().optional(),\n  icon: z.string().optional(),\n  metadata: z.array(MetadataItemSchema).optional(),\n\n  variant: z.enum([\"default\", \"destructive\"]).optional(),\n\n  confirmLabel: z.string().optional(),\n  cancelLabel: z.string().optional(),\n\n  choice: ApprovalDecisionSchema.optional(),\n});\n\nexport type SerializableApprovalCard = z.infer<\n  typeof SerializableApprovalCardSchema\n>;\n\nconst SerializableApprovalCardSchemaContract = defineToolUiContract(\n  \"ApprovalCard\",\n  SerializableApprovalCardSchema,\n);\n\nexport const parseSerializableApprovalCard: (\n  input: unknown,\n) => SerializableApprovalCard = SerializableApprovalCardSchemaContract.parse;\n\nexport const safeParseSerializableApprovalCard: (\n  input: unknown,\n) => SerializableApprovalCard | null =\n  SerializableApprovalCardSchemaContract.safeParse;\nexport interface ApprovalCardProps extends SerializableApprovalCard {\n  className?: string;\n  onConfirm?: () => void | Promise<void>;\n  onCancel?: () => void | Promise<void>;\n}\n"
    },
    {
      "path": "components/tool-ui/shared/_adapter.tsx",
      "type": "registry:component",
      "target": "components/tool-ui/shared/_adapter.tsx",
      "content": "/**\n * Adapter: UI and utility re-exports for copy-standalone portability.\n *\n * When copying this component to another project, update these imports\n * to match your project's paths:\n *\n *   cn     → Your Tailwind merge utility (e.g., \"@/lib/utils\", \"~/lib/cn\")\n *   Button → shadcn/ui Button\n */\n\nexport { cn } from \"@/lib/utils\";\nexport { Button } from \"@/components/ui/button\";\n"
    },
    {
      "path": "components/tool-ui/shared/action-buttons.tsx",
      "type": "registry:component",
      "target": "components/tool-ui/shared/action-buttons.tsx",
      "content": "\"use client\";\n\nimport type { Action } from \"./schema\";\nimport { cn, Button } from \"./_adapter\";\nimport { useActionButtons } from \"./use-action-buttons\";\n\nexport interface ActionButtonsProps {\n  actions: Action[];\n  onAction: (actionId: string) => void | Promise<void>;\n  onBeforeAction?: (actionId: string) => boolean | Promise<boolean>;\n  confirmTimeout?: number;\n  align?: \"left\" | \"center\" | \"right\";\n  className?: string;\n}\n\nexport function ActionButtons({\n  actions,\n  onAction,\n  onBeforeAction,\n  confirmTimeout = 3000,\n  align = \"right\",\n  className,\n}: ActionButtonsProps) {\n  const { actions: resolvedActions, runAction } = useActionButtons({\n    actions,\n    onAction,\n    onBeforeAction,\n    confirmTimeout,\n  });\n\n  return (\n    <div\n      className={cn(\n        \"flex flex-col gap-3\",\n        \"@sm/actions:flex-row @sm/actions:flex-wrap @sm/actions:items-center @sm/actions:gap-2\",\n        align === \"left\" && \"@sm/actions:justify-start\",\n        align === \"center\" && \"@sm/actions:justify-center\",\n        align === \"right\" && \"@sm/actions:justify-end\",\n        className,\n      )}\n    >\n      {resolvedActions.map((action) => {\n        const label = action.currentLabel;\n        const variant = action.variant || \"default\";\n\n        return (\n          <Button\n            key={action.id}\n            variant={variant}\n            onClick={() => runAction(action.id)}\n            disabled={action.isDisabled}\n            className={cn(\n              \"rounded-full px-4!\",\n              \"justify-center\",\n              \"min-h-11 w-full text-base\",\n              \"@sm/actions:min-h-0 @sm/actions:w-auto @sm/actions:px-3 @sm/actions:py-2 @sm/actions:text-sm\",\n              action.isConfirming &&\n                \"ring-destructive ring-2 ring-offset-2 motion-safe:animate-pulse\",\n            )}\n            aria-label={\n              action.shortcut ? `${label} (${action.shortcut})` : label\n            }\n          >\n            {action.isLoading && (\n              <svg\n                className=\"mr-2 h-4 w-4 motion-safe:animate-spin\"\n                xmlns=\"http://www.w3.org/2000/svg\"\n                fill=\"none\"\n                viewBox=\"0 0 24 24\"\n              >\n                <circle\n                  className=\"opacity-25\"\n                  cx=\"12\"\n                  cy=\"12\"\n                  r=\"10\"\n                  stroke=\"currentColor\"\n                  strokeWidth=\"4\"\n                />\n                <path\n                  className=\"opacity-75\"\n                  fill=\"currentColor\"\n                  d=\"M4 12a8 8 0 018-8V0C5.373 0 0 5.373 0 12h4zm2 5.291A7.962 7.962 0 014 12H0c0 3.042 1.135 5.824 3 7.938l3-2.647z\"\n                />\n              </svg>\n            )}\n            {action.icon && !action.isLoading && (\n              <span className=\"mr-2\">{action.icon}</span>\n            )}\n            {label}\n            {action.shortcut && !action.isLoading && (\n              <kbd className=\"border-border bg-muted ml-2.5 hidden rounded-lg border px-2 py-0.5 font-mono text-xs font-medium sm:inline-block\">\n                {action.shortcut}\n              </kbd>\n            )}\n          </Button>\n        );\n      })}\n    </div>\n  );\n}\n"
    },
    {
      "path": "components/tool-ui/shared/contract.ts",
      "type": "registry:lib",
      "target": "components/tool-ui/shared/contract.ts",
      "content": "import { z } from \"zod\";\nimport { parseWithSchema, safeParseWithSchema } from \"./parse\";\n\nexport interface ToolUiContract<T> {\n  schema: z.ZodType<T>;\n  parse: (input: unknown) => T;\n  safeParse: (input: unknown) => T | null;\n}\n\nexport function defineToolUiContract<T>(\n  componentName: string,\n  schema: z.ZodType<T>,\n): ToolUiContract<T> {\n  return {\n    schema,\n    parse: (input: unknown) => parseWithSchema(schema, input, componentName),\n    safeParse: (input: unknown) => safeParseWithSchema(schema, input),\n  };\n}\n"
    },
    {
      "path": "components/tool-ui/shared/parse.ts",
      "type": "registry:lib",
      "target": "components/tool-ui/shared/parse.ts",
      "content": "import { z } from \"zod\";\n\nfunction formatZodPath(path: Array<string | number | symbol>): string {\n  if (path.length === 0) return \"root\";\n  return path\n    .map((segment) =>\n      typeof segment === \"number\" ? `[${segment}]` : String(segment),\n    )\n    .join(\".\");\n}\n\n/**\n * Format Zod errors into a compact `path: message` string.\n */\nexport function formatZodError(error: z.ZodError): string {\n  const parts = error.issues.map((issue) => {\n    const path = formatZodPath(issue.path);\n    return `${path}: ${issue.message}`;\n  });\n\n  return Array.from(new Set(parts)).join(\"; \");\n}\n\n/**\n * Parse unknown input and throw a readable error.\n */\nexport function parseWithSchema<T>(\n  schema: z.ZodType<T>,\n  input: unknown,\n  name: string,\n): T {\n  const res = schema.safeParse(input);\n  if (!res.success) {\n    throw new Error(`Invalid ${name} payload: ${formatZodError(res.error)}`);\n  }\n  return res.data;\n}\n\n/**\n * Parse unknown input, returning `null` instead of throwing on failure.\n *\n * Use this in assistant-ui `render` functions where `args` stream in\n * incrementally and may be incomplete until the tool call finishes.\n */\nexport function safeParseWithSchema<T>(\n  schema: z.ZodType<T>,\n  input: unknown,\n): T | null {\n  const res = schema.safeParse(input);\n  return res.success ? res.data : null;\n}\n"
    },
    {
      "path": "components/tool-ui/shared/schema.ts",
      "type": "registry:lib",
      "target": "components/tool-ui/shared/schema.ts",
      "content": "import { z } from \"zod\";\nimport type { ReactNode } from \"react\";\n\n/**\n * Tool UI conventions:\n * - Serializable schemas are JSON-safe (no callbacks/ReactNode/`className`).\n * - Schema: `SerializableXSchema`\n * - Parser: `parseSerializableX(input: unknown)` (throws on invalid)\n * - Safe parser: `safeParseSerializableX(input: unknown)` (returns `null` on invalid)\n * - Actions: `LocalActions` for non-receipt actions and `DecisionActions` for consequential actions\n * - Root attrs: `data-tool-ui-id` + `data-slot`\n */\n\n/**\n * Schema for tool UI identity.\n *\n * Every tool UI should have a unique identifier that:\n * - Is stable across re-renders\n * - Is meaningful (not auto-generated)\n * - Is unique within the conversation\n *\n * Format recommendation: `{component-type}-{semantic-identifier}`\n * Examples: \"data-table-expenses-q3\", \"option-list-deploy-target\"\n */\nexport const ToolUIIdSchema = z.string().min(1);\n\nexport type ToolUIId = z.infer<typeof ToolUIIdSchema>;\n\n/**\n * Primary role of a Tool UI surface in a chat context.\n */\nexport const ToolUIRoleSchema = z.enum([\n  \"information\",\n  \"decision\",\n  \"control\",\n  \"state\",\n  \"composite\",\n]);\n\nexport type ToolUIRole = z.infer<typeof ToolUIRoleSchema>;\n\nexport const ToolUIReceiptOutcomeSchema = z.enum([\n  \"success\",\n  \"partial\",\n  \"failed\",\n  \"cancelled\",\n]);\n\nexport type ToolUIReceiptOutcome = z.infer<typeof ToolUIReceiptOutcomeSchema>;\n\n/**\n * Optional receipt metadata: a durable summary of an outcome.\n */\nexport const ToolUIReceiptSchema = z.object({\n  outcome: ToolUIReceiptOutcomeSchema,\n  summary: z.string().min(1),\n  identifiers: z.record(z.string(), z.string()).optional(),\n  at: z.string().datetime(),\n});\n\nexport type ToolUIReceipt = z.infer<typeof ToolUIReceiptSchema>;\n\n/**\n * Base schema for Tool UI payloads (id + optional role/receipt).\n */\nexport const ToolUISurfaceSchema = z.object({\n  id: ToolUIIdSchema,\n  role: ToolUIRoleSchema.optional(),\n  receipt: ToolUIReceiptSchema.optional(),\n});\n\nexport type ToolUISurface = z.infer<typeof ToolUISurfaceSchema>;\n\nexport const ActionSchema = z.object({\n  id: z.string().min(1),\n  label: z.string().min(1),\n  /**\n   * Canonical narration the assistant can use after this action is taken.\n   *\n   * Example: \"I exported the table as CSV.\" / \"I opened the link in a new tab.\"\n   */\n  sentence: z.string().optional(),\n  confirmLabel: z.string().optional(),\n  variant: z\n    .enum([\"default\", \"destructive\", \"secondary\", \"ghost\", \"outline\"])\n    .optional(),\n  icon: z.custom<ReactNode>().optional(),\n  loading: z.boolean().optional(),\n  disabled: z.boolean().optional(),\n  shortcut: z.string().optional(),\n});\n\nexport type Action = z.infer<typeof ActionSchema>;\nexport type LocalAction = Action;\nexport type DecisionAction = Action;\n\nexport const DecisionResultSchema = z.object({\n  kind: z.literal(\"decision\"),\n  version: z.literal(1),\n  decisionId: z.string().min(1),\n  actionId: z.string().min(1),\n  actionLabel: z.string().min(1),\n  at: z.string().datetime(),\n  payload: z.record(z.string(), z.unknown()).optional(),\n});\n\nexport type DecisionResult<\n  TPayload extends Record<string, unknown> = Record<string, unknown>,\n> = Omit<z.infer<typeof DecisionResultSchema>, \"payload\"> & {\n  payload?: TPayload;\n};\n\nexport function createDecisionResult<\n  TPayload extends Record<string, unknown> = Record<string, unknown>,\n>(args: {\n  decisionId: string;\n  action: { id: string; label: string };\n  payload?: TPayload;\n}): DecisionResult<TPayload> {\n  return {\n    kind: \"decision\",\n    version: 1,\n    decisionId: args.decisionId,\n    actionId: args.action.id,\n    actionLabel: args.action.label,\n    at: new Date().toISOString(),\n    payload: args.payload,\n  };\n}\n\nexport const ActionButtonsPropsSchema = z.object({\n  actions: z.array(ActionSchema).min(1),\n  align: z.enum([\"left\", \"center\", \"right\"]).optional(),\n  confirmTimeout: z.number().positive().optional(),\n  className: z.string().optional(),\n});\n\nexport const SerializableActionSchema = ActionSchema.omit({ icon: true });\nexport const SerializableActionsSchema = ActionButtonsPropsSchema.extend({\n  actions: z.array(SerializableActionSchema),\n}).omit({ className: true });\n\nexport interface ActionsConfig {\n  items: Action[];\n  align?: \"left\" | \"center\" | \"right\";\n  confirmTimeout?: number;\n}\n\nexport const SerializableActionsConfigSchema = z.object({\n  items: z.array(SerializableActionSchema).min(1),\n  align: z.enum([\"left\", \"center\", \"right\"]).optional(),\n  confirmTimeout: z.number().positive().optional(),\n});\n\nexport type SerializableActionsConfig = z.infer<\n  typeof SerializableActionsConfigSchema\n>;\n\nexport type SerializableAction = z.infer<typeof SerializableActionSchema>;\n"
    },
    {
      "path": "components/tool-ui/shared/use-action-buttons.tsx",
      "type": "registry:component",
      "target": "components/tool-ui/shared/use-action-buttons.tsx",
      "content": "\"use client\";\n\nimport { useCallback, useEffect, useMemo, useRef, useState } from \"react\";\nimport type { Action } from \"./schema\";\n\nexport type UseActionButtonsOptions = {\n  actions: Action[];\n  onAction: (actionId: string) => void | Promise<void>;\n  onBeforeAction?: (actionId: string) => boolean | Promise<boolean>;\n  confirmTimeout?: number;\n};\n\nexport type UseActionButtonsResult = {\n  actions: Array<\n    Action & {\n      currentLabel: string;\n      isConfirming: boolean;\n      isExecuting: boolean;\n      isDisabled: boolean;\n      isLoading: boolean;\n    }\n  >;\n  runAction: (actionId: string) => Promise<void>;\n  confirmingActionId: string | null;\n  executingActionId: string | null;\n};\n\ntype ActionExecutionLock = {\n  tryAcquire: () => boolean;\n  release: () => void;\n};\n\nexport function createActionExecutionLock(): ActionExecutionLock {\n  let locked = false;\n\n  return {\n    tryAcquire: () => {\n      if (locked) return false;\n      locked = true;\n      return true;\n    },\n    release: () => {\n      locked = false;\n    },\n  };\n}\n\nexport function useActionButtons(\n  options: UseActionButtonsOptions,\n): UseActionButtonsResult {\n  const { actions, onAction, onBeforeAction, confirmTimeout = 3000 } = options;\n\n  const [confirmingActionId, setConfirmingActionId] = useState<string | null>(\n    null,\n  );\n  const [executingActionId, setExecutingActionId] = useState<string | null>(\n    null,\n  );\n  const executionLockRef = useRef<ActionExecutionLock>(\n    createActionExecutionLock(),\n  );\n\n  useEffect(() => {\n    if (!confirmingActionId) return;\n    const id = setTimeout(() => setConfirmingActionId(null), confirmTimeout);\n    return () => clearTimeout(id);\n  }, [confirmingActionId, confirmTimeout]);\n\n  useEffect(() => {\n    if (!confirmingActionId) return;\n    const handleKeyDown = (e: KeyboardEvent) => {\n      if (e.key === \"Escape\") {\n        setConfirmingActionId(null);\n      }\n    };\n\n    window.addEventListener(\"keydown\", handleKeyDown);\n    return () => window.removeEventListener(\"keydown\", handleKeyDown);\n  }, [confirmingActionId]);\n\n  const runAction = useCallback(\n    async (actionId: string) => {\n      const action = actions.find((a) => a.id === actionId);\n      if (!action) return;\n\n      const isAnyActionExecuting = executingActionId !== null;\n      if (action.disabled || action.loading || isAnyActionExecuting) {\n        return;\n      }\n\n      if (action.confirmLabel && confirmingActionId !== action.id) {\n        setConfirmingActionId(action.id);\n        return;\n      }\n\n      if (!executionLockRef.current.tryAcquire()) {\n        return;\n      }\n\n      if (onBeforeAction) {\n        const shouldProceed = await onBeforeAction(action.id);\n        if (!shouldProceed) {\n          setConfirmingActionId(null);\n          executionLockRef.current.release();\n          return;\n        }\n      }\n\n      try {\n        setExecutingActionId(action.id);\n        await onAction(action.id);\n      } finally {\n        executionLockRef.current.release();\n        setExecutingActionId(null);\n        setConfirmingActionId(null);\n      }\n    },\n    [actions, confirmingActionId, executingActionId, onAction, onBeforeAction],\n  );\n\n  const resolvedActions = useMemo(\n    () =>\n      actions.map((action) => {\n        const isConfirming = confirmingActionId === action.id;\n        const isThisActionExecuting = executingActionId === action.id;\n        const isLoading = action.loading || isThisActionExecuting;\n        const isDisabled =\n          action.disabled ||\n          (executingActionId !== null && !isThisActionExecuting);\n        const currentLabel =\n          isConfirming && action.confirmLabel\n            ? action.confirmLabel\n            : action.label;\n\n        return {\n          ...action,\n          currentLabel,\n          isConfirming,\n          isExecuting: isThisActionExecuting,\n          isDisabled,\n          isLoading,\n        };\n      }),\n    [actions, confirmingActionId, executingActionId],\n  );\n\n  return {\n    actions: resolvedActions,\n    runAction,\n    confirmingActionId,\n    executingActionId,\n  };\n}\n"
    }
  ]
}