{
  "$schema": "https://ui.shadcn.com/schema/registry-item.json",
  "name": "chat-workspace",
  "type": "registry:component",
  "title": "ChatWorkspace",
  "description": "A chat that floats as an island over the content or pins beside it as a resizable column, without remounting.",
  "dependencies": [
    "lucide-react@^1.47.0"
  ],
  "registryDependencies": [
    "https://control-ui.dev/r/button.json",
    "https://control-ui.dev/r/core.json",
    "https://control-ui.dev/r/motion.json",
    "https://control-ui.dev/r/view-transition.json"
  ],
  "files": [
    {
      "path": "src/registry/docs/chat-workspace.md",
      "target": "@components/control-ui/docs/chat-workspace.md",
      "type": "registry:file",
      "content": "<!-- Generated by Control UI from its catalog and the installed source (apps/docs/scripts/gen-component-docs.ts). Do not edit: updating the component replaces this file. -->\n\n# ChatWorkspace\n\n> A chat that floats as an island over the content or pins beside it as a resizable column, without remounting.\n\nThis file matches the installed `chat-workspace` source. The online docs follow the latest release and may describe a newer version.\n\n## Install\n\n```bash\nnpx shadcn@latest add https://control-ui.dev/r/chat-workspace.json\n```\n\nWith `@ctrl-ui/react` instead of the registry, import from `@ctrl-ui/react/` where this file says `@/components/control-ui/`; this file then lives at `node_modules/@ctrl-ui/react/dist/docs/chat-workspace.md`.\n\n## npm dependencies\n\n- `lucide-react@^1.47.0`\n\n## Registry dependencies\n\n- `button`\n- `core`\n- `motion`\n- `view-transition`\n\n## Exports\n\n- `@/components/control-ui/chat-workspace-fold`: `foldPanel`\n- `@/components/control-ui/chat-workspace-resize-handle`: `ChatWorkspaceResizeHandle`, types `ChatWorkspaceResizeHandleProps`\n- `@/components/control-ui/chat-workspace-state`: `ChatWorkspaceContext`, `ChatWorkspaceElementsContext`, `useChatWorkspace`, `useChatWorkspaceElements`, `useControllableState`, `clamp`, types `ChatWorkspaceSide`, `ChatWorkspacePresentation`, `ChatWorkspaceContextValue`, `ChatWorkspaceElements`\n- `@/components/control-ui/chat-workspace`: `ChatWorkspaceResizeHandle`, `useChatWorkspace`, `ChatWorkspace`, `ChatWorkspaceMain`, `ChatWorkspacePanel`, `ChatWorkspaceInset`, `ChatWorkspaceCollapsible`, `ChatWorkspaceExpandToggle`, `ChatWorkspaceDockToggle`, types `ChatWorkspaceResizeHandleProps`, `ChatWorkspaceContextValue`, `ChatWorkspacePresentation`, `ChatWorkspaceSide`, `ChatWorkspaceProps`, `ChatWorkspaceMainProps`, `ChatWorkspacePanelProps`, `ChatWorkspaceInsetProps`, `ChatWorkspaceCollapsibleProps`, `ChatWorkspaceExpandToggleProps`, `ChatWorkspaceDockToggleProps`\n\n## Composition\n\n### Floating or pinned chat\n\n```tsx\n<ChatWorkspace>\n  <ChatWorkspaceMain>\n    page content\n    <ChatWorkspaceInset />\n  </ChatWorkspaceMain>\n  <ChatWorkspacePanel>\n    <ChatLayout>\n      <ChatLayoutHeader>\n        <ChatWorkspaceExpandToggle />\n        <ChatLayoutTitle />\n        <ChatLayoutActions>\n          <ChatWorkspaceDockToggle />\n        </ChatLayoutActions>\n      </ChatLayoutHeader>\n      <ChatWorkspaceCollapsible>\n        <ChatThread />\n      </ChatWorkspaceCollapsible>\n      <ChatComposer />\n    </ChatLayout>\n    <ChatWorkspaceResizeHandle />\n  </ChatWorkspacePanel>\n</ChatWorkspace>\n```\n\n## Usage\n\n```tsx\n\"use client\";\n\nimport { ArrowUp } from \"lucide-react\";\nimport {\n  ChatComposer,\n  ChatComposerShell,\n  ChatComposerSubmit,\n  ChatComposerTextarea,\n  ChatComposerToolbar,\n} from \"@/components/control-ui/chat-composer\";\nimport {\n  ChatLayout,\n  ChatLayoutActions,\n  ChatLayoutHeader,\n  ChatLayoutTitle,\n  ChatThread,\n  ChatTurn,\n} from \"@/components/control-ui/chat-layout\";\nimport { ChatMessage, ChatMessageBody, ChatMessageContent, ChatMessageRow } from \"@/components/control-ui/chat-message\";\nimport {\n  ChatWorkspace,\n  ChatWorkspaceCollapsible,\n  ChatWorkspaceDockToggle,\n  ChatWorkspaceExpandToggle,\n  ChatWorkspaceInset,\n  ChatWorkspaceMain,\n  ChatWorkspacePanel,\n  ChatWorkspaceResizeHandle,\n} from \"@/components/control-ui/chat-workspace\";\nimport { ScrollArea } from \"@/components/control-ui/ui/scroll-area\";\n\nconst sections = [\n  \"A workspace keeps the conversation next to the thing it is about.\",\n  \"Floating, the chat is a small island over the bottom of the page: collapse it to just the composer when you want the room.\",\n  \"Pinned, it becomes a column at the side that you can drag wider or narrower, or resize from the keyboard with the arrow keys.\",\n  \"Switching between the two never remounts the chat, so a half-written message and the scroll position in the transcript stay put.\",\n  \"When the space is too narrow for a column, the chat keeps floating and the pin button steps aside.\",\n];\n\nconst turns = [\n  { id: \"ask\", from: \"user\" as const, text: \"Summarise what changed in this draft.\" },\n  { id: \"answer\", from: \"assistant\" as const, text: \"You tightened the intro and moved the examples after the rules.\" },\n];\n\nexport function ChatWorkspaceExample() {\n  return (\n    <ChatWorkspace className=\"h-[36rem] w-full\">\n      <ChatWorkspaceMain>\n        <ScrollArea aria-label=\"Document\" className=\"h-full\">\n          <article className=\"mx-auto flex max-w-prose flex-col gap-4 p-8\">\n            {sections.map((section) => (\n              <p key={section}>{section}</p>\n            ))}\n            <ChatWorkspaceInset />\n          </article>\n        </ScrollArea>\n      </ChatWorkspaceMain>\n      <ChatWorkspacePanel>\n        <ChatLayout chrome=\"embedded\">\n          <ChatLayoutHeader>\n            <ChatWorkspaceExpandToggle />\n            <ChatLayoutTitle>Draft review</ChatLayoutTitle>\n            <ChatLayoutActions>\n              <ChatWorkspaceDockToggle />\n            </ChatLayoutActions>\n          </ChatLayoutHeader>\n          <ChatWorkspaceCollapsible>\n            <ChatThread>\n              {turns.map((turn) => (\n                <ChatTurn key={turn.id} from={turn.from}>\n                  <ChatMessage from={turn.from} density=\"compact\">\n                    <ChatMessageRow>\n                      <ChatMessageBody>\n                        <ChatMessageContent>{turn.text}</ChatMessageContent>\n                      </ChatMessageBody>\n                    </ChatMessageRow>\n                  </ChatMessage>\n                </ChatTurn>\n              ))}\n            </ChatThread>\n          </ChatWorkspaceCollapsible>\n          <ChatComposer density=\"compact\" onSubmit={({ clear }) => clear()}>\n            <ChatComposerShell>\n              <ChatComposerTextarea aria-label=\"Message\" placeholder=\"Ask about this draft…\" />\n              <ChatComposerToolbar>\n                <ChatComposerSubmit size=\"sm\" iconOnly aria-label=\"Send message\">\n                  <ArrowUp />\n                </ChatComposerSubmit>\n              </ChatComposerToolbar>\n            </ChatComposerShell>\n          </ChatComposer>\n        </ChatLayout>\n        <ChatWorkspaceResizeHandle />\n      </ChatWorkspacePanel>\n    </ChatWorkspace>\n  );\n}\n```\n\n## Anatomy\n\nScopes, their parts, and the state attributes each part carries. Selector pattern: `[data-skin=\"{skin}\"] :where([data-slot=\"{part}\"][data-control-family=\"{family}\"])`.\n\n- `chat-workspace`\n  - `collapsible`\n  - `inset`\n  - `main`\n  - `panel`\n  - `resize-handle`\n  - `resize-shield`\n  - `root`: `data-docked`, `data-expanded`, `data-side` (`left` | `right`)\n\n## Knobs\n\nRegistered `--cui-*` custom properties with their recipe defaults. Set them through the component's `style` prop or a skin.\n\n### chat-workspace\n\n- `--cui-chat-workspace-gap`: `calc(var(--spacing) * 3)`\n- `--cui-chat-workspace-island-max-inline-size`: `44rem`\n- `--cui-chat-workspace-transcript-block-size`: `28rem`\n- `--cui-chat-workspace-background`: `var(--card)`\n- `--cui-chat-workspace-foreground`: `var(--card-foreground)`\n- `--cui-chat-workspace-border-color`: `var(--border)`\n- `--cui-chat-workspace-border-width`: `var(--control-rim-width)`\n- `--cui-chat-workspace-radius`: `max(\n      var(--radius-panel),\n      calc(var(--radius-composer) + var(--composer-padding) + var(--cui-chat-workspace-border-width))\n    )`\n- `--cui-chat-workspace-shadow`: `var(--shadow-pop)`\n- `--cui-chat-workspace-handle-background`: `oklch(from var(--foreground) l c h / 0.3)`\n\n## Links\n\n- Online docs (latest release): https://control-ui.dev/kits/chat-workspace\n- Anatomy contract: https://control-ui.dev/r/contract/chat-workspace.json\n"
    },
    {
      "path": "src/registry/sources/control-ui/chat-workspace-fold.ts",
      "target": "@components/control-ui/chat-workspace-fold.ts",
      "type": "registry:component",
      "content": "import { prefersReducedMotion, readDurationMs } from \"@/components/control-ui/lib/motion\";\n\nconst running = new WeakMap<HTMLElement, Animation>();\n\nexport function foldPanel(root: HTMLElement | null, panel: HTMLElement | null, apply: () => void) {\n  const duration = panel && !prefersReducedMotion(panel) ? readDurationMs(panel, \"--duration-slow\") : 0;\n  if (!root || !panel || duration <= 0) {\n    apply();\n    return;\n  }\n  const before = panel.getBoundingClientRect().height;\n  running.get(panel)?.cancel();\n  root.removeAttribute(\"data-folding\");\n  apply();\n  const after = panel.getBoundingClientRect().height;\n  if (Math.abs(before - after) < 0.5) return;\n  root.setAttribute(\"data-folding\", \"\");\n  const easing = getComputedStyle(panel).getPropertyValue(\"--ease-emphasized\").trim() || \"ease\";\n  const animation = panel.animate({ blockSize: [`${before}px`, `${after}px`] }, { duration, easing });\n  running.set(panel, animation);\n  const settle = () => {\n    if (running.get(panel) !== animation) return;\n    running.delete(panel);\n    root.removeAttribute(\"data-folding\");\n  };\n  animation.finished.then(settle, settle);\n}\n"
    },
    {
      "path": "src/registry/sources/control-ui/chat-workspace-resize-handle.tsx",
      "target": "@components/control-ui/chat-workspace-resize-handle.tsx",
      "type": "registry:component",
      "content": "\"use client\";\n\nimport type { ComponentProps, KeyboardEvent, PointerEvent as ReactPointerEvent } from \"react\";\nimport { useEffect, useRef } from \"react\";\nimport { useChatWorkspace, useChatWorkspaceElements } from \"@/components/control-ui/chat-workspace-state\";\nimport { cn } from \"@/components/control-ui/lib/cn\";\n\nconst DRAG_THRESHOLD_PX = 5;\nconst KEYBOARD_STEP_PX = 16;\nconst KEYBOARD_LARGE_STEP_PX = 64;\nconst RESIZE_SHIELD_STAMP = { \"data-control-ui\": \"chat-workspace\", \"data-control-family\": \"chat-workspace\", \"data-slot\": \"resize-shield\" };\n\nexport type ChatWorkspaceResizeHandleProps = Omit<\n  ComponentProps<\"div\">,\n  \"role\" | \"aria-orientation\" | \"aria-valuenow\" | \"aria-valuemin\" | \"aria-valuemax\" | \"aria-controls\"\n>;\n\nexport function ChatWorkspaceResizeHandle({\n  className,\n  onPointerDown,\n  onKeyDown,\n  \"aria-label\": ariaLabel = \"Resize chat panel\",\n  ...props\n}: ChatWorkspaceResizeHandleProps) {\n  const { presentation, side, panelId, panelWidth, minPanelWidth, maxPanelWidth, setPanelWidth, clampPanelWidth } = useChatWorkspace();\n  const { panelRef } = useChatWorkspaceElements();\n  const cancelGestureRef = useRef<(() => void) | null>(null);\n\n  useEffect(() => () => cancelGestureRef.current?.(), []);\n\n  if (presentation !== \"docked\") return null;\n\n  const widenSign = side === \"right\" ? -1 : 1;\n\n  function startGesture(event: ReactPointerEvent<HTMLDivElement>) {\n    onPointerDown?.(event);\n    const panel = panelRef.current;\n    if (event.defaultPrevented || event.button !== 0 || !panel) return;\n    event.preventDefault();\n    cancelGestureRef.current?.();\n    const handle = event.currentTarget;\n    handle.focus({ preventScroll: true, focusVisible: false });\n    handle.setPointerCapture(event.pointerId);\n    const pointerId = event.pointerId;\n    const startX = event.clientX;\n    const startWidth = panel.getBoundingClientRect().width;\n    const shield = document.createElement(\"div\");\n    for (const [name, value] of Object.entries(RESIZE_SHIELD_STAMP)) shield.setAttribute(name, value);\n    const controller = new AbortController();\n    let dragged = false;\n    let draftWidth = startWidth;\n\n    function endGesture() {\n      controller.abort();\n      shield.remove();\n      handle.removeAttribute(\"data-resizing\");\n      if (handle.hasPointerCapture(pointerId)) handle.releasePointerCapture(pointerId);\n      cancelGestureRef.current = null;\n    }\n\n    function cancelGesture() {\n      endGesture();\n      if (dragged && panel) panel.style.inlineSize = `${startWidth}px`;\n    }\n    cancelGestureRef.current = cancelGesture;\n\n    function dragging(pointer: PointerEvent) {\n      if (dragged) return true;\n      if (Math.abs(pointer.clientX - startX) <= DRAG_THRESHOLD_PX) return false;\n      dragged = true;\n      document.body.append(shield);\n      handle.setAttribute(\"data-resizing\", \"\");\n      return true;\n    }\n\n    function movePointer(pointer: PointerEvent) {\n      if (pointer.pointerId !== pointerId || !dragging(pointer) || !panel) return;\n      draftWidth = clampPanelWidth(startWidth + widenSign * (pointer.clientX - startX));\n      panel.style.inlineSize = `${draftWidth}px`;\n    }\n\n    function finishPointer(pointer: PointerEvent) {\n      if (pointer.pointerId !== pointerId) return;\n      endGesture();\n      if (dragged) setPanelWidth(draftWidth);\n    }\n\n    function cancelPointer(pointer: PointerEvent) {\n      if (pointer.pointerId === pointerId) cancelGesture();\n    }\n\n    function cancelWithEscape(keyboard: globalThis.KeyboardEvent) {\n      if (keyboard.key !== \"Escape\") return;\n      keyboard.preventDefault();\n      cancelGesture();\n    }\n\n    window.addEventListener(\"pointermove\", movePointer, { signal: controller.signal });\n    window.addEventListener(\"pointerup\", finishPointer, { signal: controller.signal });\n    window.addEventListener(\"pointercancel\", cancelPointer, { signal: controller.signal });\n    handle.addEventListener(\"lostpointercapture\", cancelPointer, { signal: controller.signal });\n    window.addEventListener(\"blur\", cancelGesture, { signal: controller.signal });\n    window.addEventListener(\"keydown\", cancelWithEscape, { signal: controller.signal });\n  }\n\n  function keyboardWidth(event: KeyboardEvent<HTMLDivElement>) {\n    const step = event.shiftKey ? KEYBOARD_LARGE_STEP_PX : KEYBOARD_STEP_PX;\n    if (event.key === \"ArrowLeft\") return panelWidth - widenSign * step;\n    if (event.key === \"ArrowRight\") return panelWidth + widenSign * step;\n    if (event.key === \"Home\") return minPanelWidth;\n    if (event.key === \"End\") return maxPanelWidth;\n    return undefined;\n  }\n\n  function resizeWithKeyboard(event: KeyboardEvent<HTMLDivElement>) {\n    onKeyDown?.(event);\n    if (event.defaultPrevented) return;\n    const next = keyboardWidth(event);\n    if (next === undefined) return;\n    event.preventDefault();\n    setPanelWidth(clampPanelWidth(next));\n  }\n\n  return (\n    // biome-ignore lint/a11y/useSemanticElements: focusable window splitter needs pointer and key handlers an <hr> cannot carry\n    <div\n      {...props}\n      role=\"separator\"\n      tabIndex={0}\n      aria-label={ariaLabel}\n      aria-orientation=\"vertical\"\n      aria-controls={panelId}\n      aria-valuenow={panelWidth}\n      aria-valuemin={minPanelWidth}\n      aria-valuemax={maxPanelWidth}\n      data-control-ui=\"chat-workspace\"\n      data-control-family=\"chat-workspace\"\n      data-slot=\"resize-handle\"\n      className={cn(\"absolute inset-y-0 touch-none select-none\", className)}\n      onPointerDown={startGesture}\n      onKeyDown={resizeWithKeyboard}\n    />\n  );\n}\n"
    },
    {
      "path": "src/registry/sources/control-ui/chat-workspace-state.ts",
      "target": "@components/control-ui/chat-workspace-state.ts",
      "type": "registry:component",
      "content": "\"use client\";\n\nimport type { RefObject } from \"react\";\nimport { createContext, useContext, useState } from \"react\";\n\nexport type ChatWorkspaceSide = \"left\" | \"right\";\n\nexport type ChatWorkspacePresentation = \"floating\" | \"docked\";\n\nexport type ChatWorkspaceContextValue = {\n  docked: boolean;\n  presentation: ChatWorkspacePresentation;\n  canDock: boolean;\n  expanded: boolean;\n  side: ChatWorkspaceSide;\n  panelWidth: number;\n  minPanelWidth: number;\n  maxPanelWidth: number;\n  minMainWidth: number;\n  panelId: string;\n  collapsibleId: string;\n  setDocked: (docked: boolean) => void;\n  setExpanded: (expanded: boolean) => void;\n  setPanelWidth: (width: number) => void;\n  clampPanelWidth: (width: number) => number;\n};\n\nexport type ChatWorkspaceElements = {\n  rootRef: RefObject<HTMLDivElement | null>;\n  mainRef: RefObject<HTMLDivElement | null>;\n  panelRef: RefObject<HTMLElement | null>;\n  registerPanel: (panel: HTMLElement | null) => void;\n  registerInset: (inset: HTMLDivElement | null) => void;\n};\n\nexport const ChatWorkspaceContext = createContext<ChatWorkspaceContextValue | null>(null);\n\nexport const ChatWorkspaceElementsContext = createContext<ChatWorkspaceElements | null>(null);\n\nexport function useChatWorkspace(): ChatWorkspaceContextValue {\n  const workspace = useContext(ChatWorkspaceContext);\n  if (!workspace) throw new Error(\"useChatWorkspace() must be called inside <ChatWorkspace>.\");\n  return workspace;\n}\n\nexport function useChatWorkspaceElements(): ChatWorkspaceElements {\n  const elements = useContext(ChatWorkspaceElementsContext);\n  if (!elements) throw new Error(\"ChatWorkspace parts must be rendered inside <ChatWorkspace>.\");\n  return elements;\n}\n\nexport function useControllableState<T>(controlled: T | undefined, defaultValue: T, onChange?: (value: T) => void) {\n  const [uncontrolled, setUncontrolled] = useState(defaultValue);\n  const value = controlled ?? uncontrolled;\n  function setValue(next: T) {\n    if (controlled === undefined) setUncontrolled(next);\n    onChange?.(next);\n  }\n  return [value, setValue] as const;\n}\n\nexport function clamp(value: number, min: number, max: number) {\n  return Math.min(Math.max(value, min), Math.max(min, max));\n}\n"
    },
    {
      "path": "src/registry/sources/control-ui/chat-workspace.tsx",
      "target": "@components/control-ui/chat-workspace.tsx",
      "type": "registry:component",
      "content": "\"use client\";\n\nimport { ChevronDown, PanelLeft, PanelRight, PictureInPicture2 } from \"lucide-react\";\nimport type { ComponentProps, CSSProperties, MouseEvent, RefObject } from \"react\";\nimport { useCallback, useId, useLayoutEffect, useRef, useState } from \"react\";\nimport { flushSync } from \"react-dom\";\nimport { foldPanel } from \"@/components/control-ui/chat-workspace-fold\";\nimport {\n  ChatWorkspaceContext,\n  type ChatWorkspaceContextValue,\n  ChatWorkspaceElementsContext,\n  type ChatWorkspaceSide,\n  clamp,\n  useChatWorkspace,\n  useChatWorkspaceElements,\n  useControllableState,\n} from \"@/components/control-ui/chat-workspace-state\";\nimport { startMorphViewTransition } from \"@/components/control-ui/extensions/view-transition\";\nimport { cn } from \"@/components/control-ui/lib/cn\";\nimport { Button, type ButtonProps } from \"@/components/control-ui/ui/button\";\n\n// biome-ignore lint/performance/noBarrelFile: The workspace exposes one install-facing API across its split files.\nexport { ChatWorkspaceResizeHandle, type ChatWorkspaceResizeHandleProps } from \"@/components/control-ui/chat-workspace-resize-handle\";\nexport {\n  type ChatWorkspaceContextValue,\n  type ChatWorkspacePresentation,\n  type ChatWorkspaceSide,\n  useChatWorkspace,\n} from \"@/components/control-ui/chat-workspace-state\";\n\nconst DEFAULT_PANEL_WIDTH = 384;\nconst DEFAULT_MIN_PANEL_WIDTH = 288;\nconst DEFAULT_MAX_PANEL_WIDTH = 640;\nconst DEFAULT_MIN_MAIN_WIDTH = 320;\nconst MORPH_CLASS = \"aui-morph\";\nconst MORPH_NAME = \"cui-chat-workspace\";\n\nexport type ChatWorkspaceProps = ComponentProps<\"div\"> & {\n  side?: ChatWorkspaceSide;\n  docked?: boolean;\n  defaultDocked?: boolean;\n  onDockedChange?: (docked: boolean) => void;\n  expanded?: boolean;\n  defaultExpanded?: boolean;\n  onExpandedChange?: (expanded: boolean) => void;\n  panelWidth?: number;\n  defaultPanelWidth?: number;\n  onPanelWidthChange?: (width: number) => void;\n  minPanelWidth?: number;\n  maxPanelWidth?: number;\n  /** Narrowest the main content may get beside a pinned panel; below it the panel floats instead. */\n  minMainWidth?: number;\n};\n\nfunction useFits(rootRef: RefObject<HTMLDivElement | null>, required: number) {\n  const [fits, setFits] = useState(true);\n  useLayoutEffect(() => {\n    const root = rootRef.current;\n    if (!root) return;\n    const measure = () => setFits(root.clientWidth >= required);\n    measure();\n    const observer = new ResizeObserver(measure);\n    observer.observe(root);\n    return () => observer.disconnect();\n  }, [rootRef, required]);\n  return fits;\n}\n\nfunction useInsets(rootRef: RefObject<HTMLDivElement | null>, panel: HTMLElement | null, docked: boolean) {\n  const insetsRef = useRef(new Set<HTMLDivElement>());\n  const updateRef = useRef(() => {});\n\n  useLayoutEffect(() => {\n    updateRef.current = () => {\n      const root = rootRef.current;\n      let size = 0;\n      if (root && panel && !docked) {\n        const gap = Number.parseFloat(getComputedStyle(panel).marginBlockEnd) || 0;\n        size = Math.max(0, root.getBoundingClientRect().bottom - panel.getBoundingClientRect().top + gap);\n      }\n      for (const inset of insetsRef.current) inset.style.blockSize = `${size}px`;\n    };\n    updateRef.current();\n  }, [rootRef, panel, docked]);\n\n  useLayoutEffect(() => {\n    const root = rootRef.current;\n    if (!root) return;\n    const observer = new ResizeObserver(() => updateRef.current());\n    observer.observe(root);\n    if (panel) observer.observe(panel);\n    return () => observer.disconnect();\n  }, [rootRef, panel]);\n\n  return useCallback((inset: HTMLDivElement | null) => {\n    if (!inset) return;\n    insetsRef.current.add(inset);\n    updateRef.current();\n    return () => {\n      insetsRef.current.delete(inset);\n    };\n  }, []);\n}\n\nfunction useMorph(elements: { panelRef: RefObject<HTMLElement | null>; mainRef: RefObject<HTMLDivElement | null> }) {\n  const token = useId().replace(/[^a-zA-Z0-9]/g, \"\");\n  const activeRef = useRef<ViewTransition | undefined>(undefined);\n\n  function name(named: boolean) {\n    const parts = [\n      [elements.panelRef.current, `${MORPH_NAME}-panel-${token}`],\n      [elements.mainRef.current, `${MORPH_NAME}-main-${token}`],\n    ] as const;\n    for (const [element, value] of parts) {\n      if (!element) continue;\n      element.style.viewTransitionName = named ? value : \"\";\n      element.style.setProperty(\"view-transition-class\", named ? MORPH_CLASS : \"\");\n    }\n  }\n\n  return function morph(update: () => void) {\n    name(true);\n    const transition = startMorphViewTransition(() => flushSync(update));\n    activeRef.current = transition;\n    if (!transition) {\n      name(false);\n      return;\n    }\n    transition.finished\n      .catch(() => {})\n      .finally(() => {\n        if (activeRef.current !== transition) return;\n        activeRef.current = undefined;\n        name(false);\n      });\n  };\n}\n\nexport function ChatWorkspace({\n  side = \"right\",\n  docked: dockedProp,\n  defaultDocked = false,\n  onDockedChange,\n  expanded: expandedProp,\n  defaultExpanded = true,\n  onExpandedChange,\n  panelWidth: panelWidthProp,\n  defaultPanelWidth = DEFAULT_PANEL_WIDTH,\n  onPanelWidthChange,\n  minPanelWidth = DEFAULT_MIN_PANEL_WIDTH,\n  maxPanelWidth = DEFAULT_MAX_PANEL_WIDTH,\n  minMainWidth = DEFAULT_MIN_MAIN_WIDTH,\n  className,\n  children,\n  ...props\n}: ChatWorkspaceProps) {\n  const [docked, setDockedState] = useControllableState(dockedProp, defaultDocked, onDockedChange);\n  const [requestedExpanded, setExpanded] = useControllableState(expandedProp, defaultExpanded, onExpandedChange);\n  const [requestedWidth, setRequestedWidth] = useControllableState(panelWidthProp, defaultPanelWidth, onPanelWidthChange);\n  const rootRef = useRef<HTMLDivElement>(null);\n  const mainRef = useRef<HTMLDivElement>(null);\n  const panelRef = useRef<HTMLElement>(null);\n  const [panel, setPanel] = useState<HTMLElement | null>(null);\n  const registerPanel = useCallback((element: HTMLElement | null) => {\n    panelRef.current = element;\n    setPanel(element);\n  }, []);\n  const panelId = useId();\n  const collapsibleId = useId();\n\n  const canDock = useFits(rootRef, minMainWidth + minPanelWidth);\n  const presentation = docked && canDock ? \"docked\" : \"floating\";\n  const registerInset = useInsets(rootRef, panel, presentation === \"docked\");\n  const morph = useMorph({ panelRef, mainRef });\n  const expanded = presentation === \"docked\" || requestedExpanded;\n\n  function clampPanelWidth(width: number) {\n    const room = rootRef.current ? rootRef.current.clientWidth - minMainWidth : maxPanelWidth;\n    return Math.round(clamp(width, minPanelWidth, Math.min(maxPanelWidth, room)));\n  }\n\n  const workspace: ChatWorkspaceContextValue = {\n    docked,\n    presentation,\n    canDock,\n    expanded,\n    side,\n    panelWidth: Math.round(clamp(requestedWidth, minPanelWidth, maxPanelWidth)),\n    minPanelWidth,\n    maxPanelWidth,\n    minMainWidth,\n    panelId,\n    collapsibleId,\n    setDocked: (next) => {\n      if (next === docked) return;\n      morph(() => setDockedState(next));\n    },\n    setExpanded: (next) => foldPanel(rootRef.current, panelRef.current, () => flushSync(() => setExpanded(next))),\n    setPanelWidth: (width) => setRequestedWidth(clamp(width, minPanelWidth, maxPanelWidth)),\n    clampPanelWidth,\n  };\n\n  return (\n    <ChatWorkspaceContext.Provider value={workspace}>\n      <ChatWorkspaceElementsContext.Provider value={{ rootRef, mainRef, panelRef, registerPanel, registerInset }}>\n        <div\n          {...props}\n          ref={rootRef}\n          data-control-ui=\"chat-workspace\"\n          data-control-family=\"chat-workspace\"\n          data-slot=\"root\"\n          data-side={side}\n          data-docked={presentation === \"docked\" ? \"\" : undefined}\n          data-expanded={expanded ? \"\" : undefined}\n          className={cn(\"relative grid min-h-0 min-w-0\", className)}\n        >\n          {children}\n        </div>\n      </ChatWorkspaceElementsContext.Provider>\n    </ChatWorkspaceContext.Provider>\n  );\n}\n\nexport type ChatWorkspaceMainProps = ComponentProps<\"div\">;\n\nexport function ChatWorkspaceMain({ className, ...props }: ChatWorkspaceMainProps) {\n  const { mainRef } = useChatWorkspaceElements();\n  return (\n    <div\n      {...props}\n      ref={mainRef}\n      data-control-ui=\"chat-workspace\"\n      data-control-family=\"chat-workspace\"\n      data-slot=\"main\"\n      className={cn(\"min-h-0 min-w-0\", className)}\n    />\n  );\n}\n\nexport type ChatWorkspacePanelProps = Omit<ComponentProps<\"aside\">, \"id\">;\n\nexport function ChatWorkspacePanel({ className, style, \"aria-label\": ariaLabel = \"Chat\", ...props }: ChatWorkspacePanelProps) {\n  const { panelId, panelWidth, minMainWidth, presentation } = useChatWorkspace();\n  const { registerPanel } = useChatWorkspaceElements();\n  const sized: CSSProperties | undefined =\n    presentation === \"docked\" ? { ...style, inlineSize: `${panelWidth}px`, maxInlineSize: `calc(100cqi - ${minMainWidth}px)` } : style;\n  return (\n    <aside\n      {...props}\n      ref={registerPanel}\n      id={panelId}\n      aria-label={ariaLabel}\n      data-control-ui=\"chat-workspace\"\n      data-control-family=\"chat-workspace\"\n      data-slot=\"panel\"\n      className={cn(\"relative flex min-h-0 min-w-0 flex-col\", className)}\n      style={sized}\n    />\n  );\n}\n\nexport type ChatWorkspaceInsetProps = Omit<ComponentProps<\"div\">, \"children\">;\n\n/** Spacer for the end of the main content's scroller, so its last lines can scroll clear of the floating panel. */\nexport function ChatWorkspaceInset({ className, ...props }: ChatWorkspaceInsetProps) {\n  const { registerInset } = useChatWorkspaceElements();\n  return (\n    <div\n      {...props}\n      ref={registerInset}\n      aria-hidden=\"true\"\n      data-control-ui=\"chat-workspace\"\n      data-control-family=\"chat-workspace\"\n      data-slot=\"inset\"\n      className={cn(\"pointer-events-none shrink-0\", className)}\n    />\n  );\n}\n\nexport type ChatWorkspaceCollapsibleProps = Omit<ComponentProps<\"div\">, \"id\">;\n\nexport function ChatWorkspaceCollapsible({ className, ...props }: ChatWorkspaceCollapsibleProps) {\n  const { collapsibleId, expanded } = useChatWorkspace();\n  return (\n    <div\n      {...props}\n      id={collapsibleId}\n      inert={!expanded}\n      data-control-ui=\"chat-workspace\"\n      data-control-family=\"chat-workspace\"\n      data-slot=\"collapsible\"\n      className={cn(\"grid min-h-0 min-w-0\", className)}\n    />\n  );\n}\n\nexport type ChatWorkspaceExpandToggleProps = Omit<ButtonProps, \"aria-expanded\" | \"aria-controls\">;\n\nexport function ChatWorkspaceExpandToggle({\n  onClick,\n  children,\n  \"aria-label\": ariaLabel = \"Conversation\",\n  ...props\n}: ChatWorkspaceExpandToggleProps) {\n  const { collapsibleId, expanded, presentation, setExpanded } = useChatWorkspace();\n  if (presentation === \"docked\") return null;\n  function toggle(event: MouseEvent<HTMLButtonElement>) {\n    onClick?.(event);\n    if (!event.defaultPrevented) setExpanded(!expanded);\n  }\n  return (\n    <Button\n      variant=\"ghost\"\n      size=\"sm\"\n      iconOnly\n      {...props}\n      type=\"button\"\n      aria-label={ariaLabel}\n      aria-expanded={expanded}\n      aria-controls={collapsibleId}\n      onClick={toggle}\n    >\n      {children ?? <ChevronDown aria-hidden=\"true\" data-control-family=\"chat-workspace\" data-slot=\"expand-icon\" />}\n    </Button>\n  );\n}\n\nexport type ChatWorkspaceDockToggleProps = Omit<ButtonProps, \"aria-label\"> & {\n  pinLabel?: string;\n  floatLabel?: string;\n};\n\nexport function ChatWorkspaceDockToggle({\n  onClick,\n  children,\n  pinLabel = \"Pin to side\",\n  floatLabel = \"Float\",\n  ...props\n}: ChatWorkspaceDockToggleProps) {\n  const { docked, canDock, side, setDocked } = useChatWorkspace();\n  if (!canDock) return null;\n  const PinIcon = side === \"left\" ? PanelLeft : PanelRight;\n  function toggle(event: MouseEvent<HTMLButtonElement>) {\n    onClick?.(event);\n    if (!event.defaultPrevented) setDocked(!docked);\n  }\n  return (\n    <Button variant=\"ghost\" size=\"sm\" iconOnly {...props} type=\"button\" aria-label={docked ? floatLabel : pinLabel} onClick={toggle}>\n      {children ?? (docked ? <PictureInPicture2 aria-hidden=\"true\" /> : <PinIcon aria-hidden=\"true\" />)}\n    </Button>\n  );\n}\n"
    },
    {
      "path": "src/registry/sources/control-ui/recipes/chat-workspace.css",
      "target": "@components/control-ui/styles/recipes/chat-workspace.css",
      "type": "registry:file",
      "content": "@layer components {\n  :where([data-control-family=\"chat-workspace\"][data-slot=\"root\"]) {\n    --cui-chat-workspace-gap: calc(var(--spacing) * 3);\n    --cui-chat-workspace-island-max-inline-size: 44rem;\n    --cui-chat-workspace-transcript-block-size: 28rem;\n    --cui-chat-workspace-background: var(--card);\n    --cui-chat-workspace-foreground: var(--card-foreground);\n    --cui-chat-workspace-border-color: var(--border);\n    --cui-chat-workspace-border-width: var(--control-rim-width);\n    --cui-chat-workspace-radius: max(\n      var(--radius-panel),\n      calc(var(--radius-composer) + var(--composer-padding) + var(--cui-chat-workspace-border-width))\n    );\n    --cui-chat-workspace-shadow: var(--shadow-pop);\n    --cui-chat-workspace-handle-background: oklch(from var(--foreground) l c h / 0.3);\n    container-type: inline-size;\n    grid-template-columns: minmax(0, 1fr);\n    grid-template-rows: minmax(0, 1fr);\n    overflow: hidden;\n  }\n\n  :where([data-control-family=\"chat-workspace\"][data-slot=\"main\"]) {\n    grid-area: 1 / 1;\n  }\n\n  :where([data-control-family=\"chat-workspace\"][data-slot=\"panel\"]) {\n    z-index: var(--z-raised);\n    grid-area: 1 / 1;\n    align-self: end;\n    justify-self: center;\n    inline-size: min(var(--cui-chat-workspace-island-max-inline-size), 100% - var(--cui-chat-workspace-gap) * 2);\n    max-block-size: calc(100% - var(--cui-chat-workspace-gap) * 2);\n    margin-block-end: var(--cui-chat-workspace-gap);\n    overflow: hidden;\n    border: var(--cui-chat-workspace-border-width) solid var(--cui-chat-workspace-border-color);\n    border-radius: var(--cui-chat-workspace-radius);\n    background-color: var(--cui-chat-workspace-background);\n    color: var(--cui-chat-workspace-foreground);\n    box-shadow: var(--cui-chat-workspace-shadow);\n  }\n\n  :where([data-control-family=\"chat-workspace\"][data-slot=\"root\"][data-docked]) {\n    grid-template-columns: minmax(0, 1fr) auto;\n  }\n\n  :where([data-control-family=\"chat-workspace\"][data-slot=\"root\"][data-docked][data-side=\"left\"]) {\n    grid-template-columns: auto minmax(0, 1fr);\n  }\n\n  :where([data-control-family=\"chat-workspace\"][data-slot=\"root\"][data-docked][data-side=\"left\"] > [data-slot=\"main\"]) {\n    grid-column: 2;\n  }\n\n  :where([data-control-family=\"chat-workspace\"][data-slot=\"root\"][data-docked] > [data-slot=\"panel\"]) {\n    grid-column: 2;\n    align-self: stretch;\n    justify-self: stretch;\n    max-block-size: none;\n    margin: 0;\n    border-block-width: 0;\n    border-inline-end-width: 0;\n    border-radius: 0;\n    box-shadow: none;\n  }\n\n  :where([data-control-family=\"chat-workspace\"][data-slot=\"root\"][data-docked][data-side=\"left\"] > [data-slot=\"panel\"]) {\n    grid-column: 1;\n    border-inline-start-width: 0;\n    border-inline-end-width: var(--cui-chat-workspace-border-width);\n  }\n\n  :where([data-control-family=\"chat-workspace\"][data-slot=\"collapsible\"]) {\n    display: contents;\n  }\n\n  :where(\n    [data-control-family=\"chat-workspace\"][data-slot=\"root\"]:not([data-docked])\n      > [data-slot=\"panel\"]\n      [data-control-family=\"chat-layout\"][data-chat-layout-kind=\"thread\"][data-slot=\"root\"]\n  ) {\n    max-block-size: var(--cui-chat-workspace-transcript-block-size);\n  }\n\n  :where([data-control-family=\"chat-workspace\"][data-slot=\"expand-icon\"]) {\n    transition: rotate var(--duration-base) var(--ease-emphasized);\n  }\n\n  :where([data-control-family=\"chat-workspace\"][data-slot=\"root\"]:not([data-expanded]) [data-slot=\"expand-icon\"]) {\n    rotate: 180deg;\n  }\n\n  :where([data-control-family=\"chat-workspace\"][data-slot=\"resize-handle\"]) {\n    --_chat-workspace-handle-color: transparent;\n    z-index: 1;\n    inline-size: calc(var(--spacing) * 2);\n    cursor: col-resize;\n    outline: none;\n  }\n\n  :where([data-control-family=\"chat-workspace\"][data-slot=\"root\"][data-side=\"right\"] [data-slot=\"resize-handle\"]) {\n    left: 0;\n  }\n\n  :where([data-control-family=\"chat-workspace\"][data-slot=\"root\"][data-side=\"left\"] [data-slot=\"resize-handle\"]) {\n    right: 0;\n  }\n\n  :where([data-control-family=\"chat-workspace\"][data-slot=\"resize-handle\"])::after {\n    content: \"\";\n    position: absolute;\n    inset-block: 0;\n    inline-size: max(1px, var(--cui-chat-workspace-border-width));\n    background-color: var(--_chat-workspace-handle-color);\n  }\n\n  :where([data-control-family=\"chat-workspace\"][data-slot=\"root\"][data-side=\"right\"] [data-slot=\"resize-handle\"])::after {\n    left: 0;\n  }\n\n  :where([data-control-family=\"chat-workspace\"][data-slot=\"root\"][data-side=\"left\"] [data-slot=\"resize-handle\"])::after {\n    right: 0;\n  }\n\n  @media (hover: hover) {\n    :where([data-control-family=\"chat-workspace\"][data-slot=\"resize-handle\"]:hover) {\n      --_chat-workspace-handle-color: var(--cui-chat-workspace-handle-background);\n    }\n  }\n\n  :where([data-control-family=\"chat-workspace\"][data-slot=\"resize-handle\"][data-resizing]) {\n    --_chat-workspace-handle-color: var(--cui-chat-workspace-handle-background);\n  }\n\n  :where([data-control-family=\"chat-workspace\"][data-slot=\"resize-handle\"]:focus-visible) {\n    --_chat-workspace-handle-color: var(--focus-ring);\n  }\n\n  :where([data-control-family=\"chat-workspace\"][data-slot=\"resize-shield\"]) {\n    position: fixed;\n    inset: 0;\n    z-index: var(--z-tooltip);\n    cursor: col-resize;\n    user-select: none;\n  }\n\n  @media (prefers-reduced-motion: reduce) {\n    :where([data-control-family=\"chat-workspace\"][data-slot=\"expand-icon\"]) {\n      transition: none;\n    }\n  }\n}\n\n@property --cui-chat-workspace-gap {\n  syntax: \"<length-percentage>\";\n  inherits: true;\n  initial-value: 0px;\n}\n\n@property --cui-chat-workspace-island-max-inline-size {\n  syntax: \"<length-percentage>\";\n  inherits: true;\n  initial-value: 0px;\n}\n\n@property --cui-chat-workspace-transcript-block-size {\n  syntax: \"<length-percentage>\";\n  inherits: true;\n  initial-value: 0px;\n}\n\n@property --cui-chat-workspace-background {\n  syntax: \"<color>\";\n  inherits: true;\n  initial-value: transparent;\n}\n\n@property --cui-chat-workspace-foreground {\n  syntax: \"<color>\";\n  inherits: true;\n  initial-value: transparent;\n}\n\n@property --cui-chat-workspace-border-color {\n  syntax: \"<color>\";\n  inherits: true;\n  initial-value: transparent;\n}\n\n@property --cui-chat-workspace-border-width {\n  syntax: \"<length>\";\n  inherits: true;\n  initial-value: 0px;\n}\n\n@property --cui-chat-workspace-radius {\n  syntax: \"<length-percentage>\";\n  inherits: true;\n  initial-value: 0px;\n}\n\n@property --cui-chat-workspace-shadow {\n  syntax: \"*\";\n  inherits: true;\n}\n\n@property --cui-chat-workspace-handle-background {\n  syntax: \"<color>\";\n  inherits: true;\n  initial-value: transparent;\n}\n"
    }
  ],
  "css": {
    "@import \"../components/control-ui/styles/recipes/chat-workspace.css\"": {}
  }
}
