{
  "$schema": "https://ui.shadcn.com/schema/registry-item.json",
  "name": "mermaid-diagram",
  "title": "Mermaid Diagram",
  "description": "A responsive Mermaid rendering surface with streaming and error states, repair hooks, and accessible pan and zoom both inline and in a fullscreen viewer.",
  "dependencies": [
    "@base-ui/react",
    "lucide-react",
    "mermaid"
  ],
  "registryDependencies": [
    "button",
    "separator",
    "tooltip",
    "https://ui.ericts.com/r/use-reduced-motion.json"
  ],
  "files": [
    {
      "path": "registry/base/blocks/mermaid-diagram.tsx",
      "content": "\"use client\";\n\nimport {\n  useCallback,\n  useEffect,\n  useId,\n  useLayoutEffect,\n  useMemo,\n  useRef,\n  useState,\n  useSyncExternalStore,\n  type HTMLAttributes,\n  type KeyboardEvent,\n  type PointerEvent,\n  type ReactNode,\n  type Ref,\n  type RefObject,\n} from \"react\";\nimport { Dialog as DialogPrimitive } from \"@base-ui/react/dialog\";\nimport { Maximize2, RotateCcw, X, ZoomIn, ZoomOut } from \"lucide-react\";\nimport type { MermaidConfig } from \"mermaid\";\n\nimport { cn } from \"@/lib/utils\";\nimport { useReducedMotion } from \"@/hooks/use-reduced-motion\";\nimport { Button } from \"@/components/ui/button\";\nimport { Separator } from \"@/components/ui/separator\";\nimport {\n  Tooltip,\n  TooltipContent,\n  TooltipProvider,\n  TooltipTrigger,\n} from \"@/components/ui/tooltip\";\n\nexport interface MermaidRepairRequest {\n  chart: string;\n  error: string;\n}\n\nexport type MermaidDiagramClassNames = {\n  root?: string;\n  header?: string;\n  title?: string;\n  caption?: string;\n  viewport?: string;\n  toolbar?: string;\n  error?: string;\n};\n\nexport type MermaidDiagramTool =\n  \"zoom-in\" | \"zoom-out\" | \"reset\" | \"fullscreen\";\n\nexport interface MermaidDiagramProps {\n  chart: string;\n  responsiveChart?: MermaidResponsiveChart;\n  title?: string;\n  caption?: string;\n  showCaption?: boolean;\n  meta?: string;\n  config?: MermaidConfig;\n  isIncomplete?: boolean;\n  /**\n   * Header buttons for the inline diagram; omit one to hide it. Zoom tools\n   * render in the given order and only while `inlineZoom` is on; the\n   * fullscreen button always sits last, and leaving it out removes the\n   * fullscreen viewer. The fullscreen toolbar always keeps every zoom tool.\n   */\n  tools?: readonly MermaidDiagramTool[];\n  inlineZoom?: boolean;\n  wheelZoom?: boolean;\n  initialZoom?: number;\n  minZoom?: number;\n  maxZoom?: number;\n  zoomStep?: number;\n  className?: string;\n  classNames?: MermaidDiagramClassNames;\n  onRepair?: (request: MermaidRepairRequest) => void | Promise<void>;\n  onRenderError?: (error: Error) => void;\n  renderLoading?: () => ReactNode;\n  renderError?: (context: MermaidRepairRequest) => ReactNode;\n  ref?: Ref<HTMLElement>;\n}\n\nexport type MermaidResponsiveChart = {\n  chart: string;\n  query?: string;\n};\n\nexport type DiagramViewportControls = {\n  reset: () => void;\n  zoomIn: () => void;\n  zoomOut: () => void;\n};\n\nexport interface DiagramViewportProps extends Omit<\n  HTMLAttributes<HTMLDivElement>,\n  \"children\"\n> {\n  children: ReactNode;\n  controlsRef?: Ref<DiagramViewportControls>;\n  /**\n   * For viewports that sit inside a scrolling page: plain wheel and touch\n   * gestures scroll the page, while ctrl/⌘+wheel (and trackpad pinch) zoom and\n   * mouse or pen drags pan.\n   */\n  embedded?: boolean;\n  initialZoom?: number;\n  interactive?: boolean;\n  maxZoom?: number;\n  minZoom?: number;\n  wheelZoom?: boolean;\n  zoomStep?: number;\n  ref?: Ref<HTMLDivElement>;\n}\n\ntype MermaidRenderResult = {\n  svg: string;\n};\n\ntype RenderState =\n  | { status: \"empty\" | \"idle\" }\n  | { status: \"loading\"; lastSvg?: string }\n  | { status: \"success\"; svg: string }\n  | { status: \"error\"; message: string };\n\ntype RenderSnapshot =\n  | { status: \"success\"; svg: string; requestKey: string }\n  | { status: \"error\"; message: string; requestKey: string };\n\ntype DiagramMeta = {\n  caption?: string;\n  title?: string;\n};\n\ntype ViewState = {\n  scale: number;\n  x: number;\n  y: number;\n};\n\ntype ViewportPoint = {\n  x: number;\n  y: number;\n};\n\nconst DEFAULT_MERMAID_CONFIG: MermaidConfig = {\n  fontFamily:\n    \"ui-monospace, SFMono-Regular, Menlo, Monaco, Consolas, monospace\",\n  maxEdges: 500,\n  maxTextSize: 50_000,\n  securityLevel: \"strict\",\n  startOnLoad: false,\n  suppressErrorRendering: true,\n};\n\nconst DEFAULT_TOOLS: readonly MermaidDiagramTool[] = [\n  \"zoom-in\",\n  \"zoom-out\",\n  \"reset\",\n  \"fullscreen\",\n];\nconst FULLSCREEN_TOOLS: readonly MermaidDiagramTool[] = [\n  \"zoom-in\",\n  \"zoom-out\",\n  \"reset\",\n];\nconst DEFAULT_MIN_ZOOM = 0.5;\nconst DEFAULT_MAX_ZOOM = 4;\nconst DEFAULT_ZOOM_STEP = 0.25;\nconst DEFAULT_RESPONSIVE_CHART_QUERY = \"(max-width: 640px)\";\nconst EMPTY_MERMAID_CONFIG: MermaidConfig = {};\nconst WHEEL_ZOOM_INTENSITY = 0.002;\nconst PINCH_WHEEL_ZOOM_INTENSITY = 0.008;\nconst WHEEL_GESTURE_IDLE_MS = 160;\nconst KEYBOARD_PAN_STEP = 40;\nconst KEYBOARD_PAN_STEP_FAST = 120;\n\nlet renderQueue: Promise<void> = Promise.resolve();\nlet renderSequence = 0;\n\nconst subscribeToRootTheme = (callback: () => void) => {\n  if (typeof document === \"undefined\") return () => {};\n\n  const observer = new MutationObserver(callback);\n  observer.observe(document.documentElement, {\n    attributeFilter: [\"class\", \"data-theme\"],\n    attributes: true,\n  });\n  return () => observer.disconnect();\n};\n\nfunction getResolvedMermaidTheme(): \"dark\" | \"default\" {\n  if (typeof document === \"undefined\") return \"default\";\n  const root = document.documentElement;\n  const isDark =\n    root.classList.contains(\"dark\") ||\n    (root.dataset.theme?.toLowerCase().includes(\"dark\") ?? false);\n  return isDark ? \"dark\" : \"default\";\n}\n\nfunction getServerMermaidTheme(): \"dark\" | \"default\" {\n  return \"default\";\n}\n\nfunction parseMermaidFenceMeta(meta?: string): DiagramMeta {\n  if (!meta) return {};\n\n  const result: DiagramMeta = {};\n  const attributePattern =\n    /(?:^|\\s)(title|caption)=(?:\"([^\"]*)\"|'([^']*)'|([^\\s]+))/g;\n  let match = attributePattern.exec(meta);\n\n  while (match) {\n    const key = match[1];\n    const value = (match[2] ?? match[3] ?? match[4] ?? \"\").trim();\n    if ((key === \"title\" || key === \"caption\") && value) result[key] = value;\n    match = attributePattern.exec(meta);\n  }\n\n  return result;\n}\n\n// Charts can be as large as maxTextSize, so requests are identified by a hash\n// instead of carrying the full source around in state comparisons.\nfunction hashRenderInput(input: string) {\n  let h1 = 0xdeadbeef;\n  let h2 = 0x41c6ce57;\n  for (let index = 0; index < input.length; index += 1) {\n    const code = input.charCodeAt(index);\n    h1 = Math.imul(h1 ^ code, 2654435761);\n    h2 = Math.imul(h2 ^ code, 1597334677);\n  }\n  h1 =\n    Math.imul(h1 ^ (h1 >>> 16), 2246822507) ^\n    Math.imul(h2 ^ (h2 >>> 13), 3266489909);\n  h2 =\n    Math.imul(h2 ^ (h2 >>> 16), 2246822507) ^\n    Math.imul(h1 ^ (h1 >>> 13), 3266489909);\n  return `${(h2 >>> 0).toString(36)}${(h1 >>> 0).toString(36)}:${input.length}`;\n}\n\nfunction getRenderRequestKey(\n  chart: string,\n  config: MermaidConfig,\n  theme: string,\n) {\n  try {\n    return hashRenderInput(JSON.stringify([chart, config, theme]));\n  } catch {\n    return hashRenderInput(`${chart}:${theme}`);\n  }\n}\n\nasync function renderMermaid(\n  idBase: string,\n  chart: string,\n  config: MermaidConfig,\n  theme: \"dark\" | \"default\",\n) {\n  const task = renderQueue\n    .catch(() => undefined)\n    .then(async () => {\n      const mermaid = (await import(\"mermaid\")).default;\n      const renderId = `mermaid-diagram-${idBase}-${++renderSequence}`;\n      mermaid.initialize({\n        ...DEFAULT_MERMAID_CONFIG,\n        ...config,\n        theme: config.theme ?? theme,\n        maxEdges: Math.min(\n          config.maxEdges ?? DEFAULT_MERMAID_CONFIG.maxEdges!,\n          2_000,\n        ),\n        maxTextSize: Math.min(\n          config.maxTextSize ?? DEFAULT_MERMAID_CONFIG.maxTextSize!,\n          100_000,\n        ),\n        securityLevel: \"strict\",\n        startOnLoad: false,\n        suppressErrorRendering: true,\n      });\n      try {\n        const result = (await mermaid.render(\n          renderId,\n          chart,\n        )) as MermaidRenderResult;\n        return result.svg;\n      } catch (error) {\n        // Mermaid can leave its temporary render element in the document when\n        // parsing fails; remove it so failed renders never accumulate nodes.\n        document.getElementById(renderId)?.remove();\n        document.getElementById(`d${renderId}`)?.remove();\n        throw error;\n      }\n    });\n  renderQueue = task.then(\n    () => undefined,\n    () => undefined,\n  );\n\n  return task;\n}\n\nexport function MermaidDiagram({\n  chart,\n  responsiveChart,\n  title: titleProp,\n  caption: captionProp,\n  showCaption = true,\n  meta,\n  config = EMPTY_MERMAID_CONFIG,\n  isIncomplete = false,\n  tools = DEFAULT_TOOLS,\n  inlineZoom = true,\n  wheelZoom = true,\n  initialZoom = 1,\n  minZoom = DEFAULT_MIN_ZOOM,\n  maxZoom = DEFAULT_MAX_ZOOM,\n  zoomStep = DEFAULT_ZOOM_STEP,\n  className,\n  classNames,\n  onRepair,\n  onRenderError,\n  renderLoading,\n  renderError,\n  ref,\n}: MermaidDiagramProps) {\n  const parsedMeta = useMemo(() => parseMermaidFenceMeta(meta), [meta]);\n  const title = titleProp?.trim() || parsedMeta.title;\n  const caption = showCaption\n    ? captionProp?.trim() || parsedMeta.caption\n    : undefined;\n  const useResponsiveChart = useMediaQuery(\n    responsiveChart?.query ?? DEFAULT_RESPONSIVE_CHART_QUERY,\n    Boolean(responsiveChart),\n  );\n  const selectedChart = useResponsiveChart\n    ? (responsiveChart?.chart ?? chart)\n    : chart;\n  const normalizedChart = useMemo(\n    () => selectedChart.replace(/\\n+$/u, \"\"),\n    [selectedChart],\n  );\n  const renderState = useMermaidRender(\n    normalizedChart,\n    config,\n    isIncomplete,\n    onRenderError,\n  );\n\n  if (isIncomplete) {\n    return (\n      <figure\n        ref={ref}\n        className={cn(\n          \"my-4 border bg-card p-4 text-sm text-muted-foreground\",\n          className,\n          classNames?.root,\n        )}\n      >\n        Mermaid diagram is still streaming…\n      </figure>\n    );\n  }\n\n  if (renderState.status === \"empty\") {\n    return (\n      <figure\n        ref={ref}\n        className={cn(\n          \"my-4 border bg-card p-4 text-sm text-muted-foreground\",\n          className,\n          classNames?.root,\n        )}\n      >\n        No Mermaid source to render.\n      </figure>\n    );\n  }\n\n  if (renderState.status === \"error\") {\n    const context = { chart: normalizedChart, error: renderState.message };\n    return renderError ? (\n      <>{renderError(context)}</>\n    ) : (\n      <MermaidRenderError\n        ref={(node) => setRefValue(ref, node)}\n        chart={normalizedChart}\n        error={renderState.message}\n        onRepair={onRepair}\n        className={cn(className, classNames?.error)}\n      />\n    );\n  }\n\n  const svgHtml =\n    renderState.status === \"success\"\n      ? renderState.svg\n      : renderState.status === \"loading\"\n        ? renderState.lastSvg\n        : undefined;\n\n  if (svgHtml) {\n    return (\n      <SvgViewer\n        ref={ref}\n        svgHtml={svgHtml}\n        isRefreshing={renderState.status === \"loading\"}\n        title={title}\n        caption={caption}\n        tools={tools}\n        inlineZoom={inlineZoom}\n        wheelZoom={wheelZoom}\n        initialZoom={initialZoom}\n        minZoom={minZoom}\n        maxZoom={maxZoom}\n        zoomStep={zoomStep}\n        viewportClassName={classNames?.viewport}\n        toolbarClassName={classNames?.toolbar}\n        className={cn(className, classNames?.root)}\n        headerClassName={classNames?.header}\n        titleClassName={classNames?.title}\n        captionClassName={classNames?.caption}\n      />\n    );\n  }\n\n  return (\n    <MermaidFrame\n      ref={ref}\n      title={title}\n      caption={caption}\n      isLoading\n      className={cn(className, classNames?.root)}\n      headerClassName={classNames?.header}\n      titleClassName={classNames?.title}\n      captionClassName={classNames?.caption}\n    >\n      {renderLoading ? (\n        renderLoading()\n      ) : (\n        <div className=\"flex min-h-48 items-center justify-center text-sm text-muted-foreground\">\n          <span\n            aria-hidden=\"true\"\n            className=\"mr-2 size-4 animate-spin rounded-full border border-muted-foreground/30 border-b-muted-foreground\"\n          />\n          Rendering diagram…\n        </div>\n      )}\n    </MermaidFrame>\n  );\n}\n\nfunction useMediaQuery(query: string, enabled: boolean) {\n  const subscribe = useCallback(\n    (callback: () => void) => {\n      if (!enabled || typeof window === \"undefined\") return () => {};\n      const mediaQuery = window.matchMedia(query);\n      mediaQuery.addEventListener(\"change\", callback);\n      return () => mediaQuery.removeEventListener(\"change\", callback);\n    },\n    [enabled, query],\n  );\n  const getSnapshot = useCallback(\n    () =>\n      enabled &&\n      typeof window !== \"undefined\" &&\n      window.matchMedia(query).matches,\n    [enabled, query],\n  );\n  const getServerSnapshot = useCallback(() => false, []);\n\n  return useSyncExternalStore(subscribe, getSnapshot, getServerSnapshot);\n}\n\nfunction useMermaidRender(\n  chart: string,\n  config: MermaidConfig,\n  isIncomplete: boolean,\n  onRenderError?: (error: Error) => void,\n): RenderState {\n  const reactId = useId();\n  const idBase = useMemo(\n    () => reactId.replace(/[^a-zA-Z0-9_-]/g, \"\"),\n    [reactId],\n  );\n  const theme = useSyncExternalStore(\n    subscribeToRootTheme,\n    getResolvedMermaidTheme,\n    getServerMermaidTheme,\n  );\n  const [snapshot, setSnapshot] = useState<RenderSnapshot | null>(null);\n  const requestKey = getRenderRequestKey(chart, config, theme);\n\n  // Inline `config` objects and `onRenderError` callbacks get a new identity on\n  // every parent render; reading them through refs keeps them out of the render\n  // effect's dependencies so only content changes (via requestKey) re-render.\n  const configRef = useRef(config);\n  const onRenderErrorRef = useRef(onRenderError);\n  useEffect(() => {\n    configRef.current = config;\n    onRenderErrorRef.current = onRenderError;\n  });\n\n  useEffect(() => {\n    if (isIncomplete || !chart.trim()) return;\n\n    let active = true;\n    void renderMermaid(idBase, chart, configRef.current, theme).then(\n      (svg) => {\n        if (active) setSnapshot({ status: \"success\", svg, requestKey });\n      },\n      (caught: unknown) => {\n        if (!active) return;\n        const error =\n          caught instanceof Error\n            ? caught\n            : new Error(\"Failed to render Mermaid diagram.\");\n        onRenderErrorRef.current?.(error);\n        setSnapshot({\n          status: \"error\",\n          message: error.message.trim() || \"Failed to render Mermaid diagram.\",\n          requestKey,\n        });\n      },\n    );\n\n    return () => {\n      active = false;\n    };\n  }, [chart, idBase, isIncomplete, requestKey, theme]);\n\n  if (isIncomplete) return { status: \"idle\" };\n  if (!chart.trim()) return { status: \"empty\" };\n  if (snapshot?.requestKey === requestKey) {\n    return snapshot.status === \"success\"\n      ? { status: \"success\", svg: snapshot.svg }\n      : { status: \"error\", message: snapshot.message };\n  }\n  // While a new request renders, keep the previous diagram on screen instead of\n  // flashing back to the loading state.\n  return {\n    status: \"loading\",\n    lastSvg: snapshot?.status === \"success\" ? snapshot.svg : undefined,\n  };\n}\n\nfunction MermaidFrame({\n  title,\n  caption,\n  isLoading,\n  children,\n  actions,\n  actionsClassName,\n  className,\n  headerClassName,\n  titleClassName,\n  captionClassName,\n  ref,\n}: {\n  title?: string;\n  caption?: string;\n  isLoading: boolean;\n  children: ReactNode;\n  actions?: ReactNode;\n  actionsClassName?: string;\n  className?: string;\n  headerClassName?: string;\n  titleClassName?: string;\n  captionClassName?: string;\n  ref?: Ref<HTMLElement>;\n}) {\n  return (\n    <figure\n      ref={ref}\n      className={cn(\n        \"my-4 overflow-hidden rounded-xl border bg-card text-card-foreground\",\n        className,\n      )}\n    >\n      <div\n        data-slot=\"mermaid-diagram-header\"\n        className={cn(\n          \"flex min-h-14 items-center justify-between gap-3 border-b bg-muted/45 px-3 py-2\",\n          headerClassName,\n        )}\n      >\n        <div className=\"min-w-0\">\n          <figcaption\n            data-slot=\"mermaid-diagram-title\"\n            className={cn(\n              \"truncate text-base font-medium text-foreground\",\n              titleClassName,\n            )}\n          >\n            {title?.trim() || \"Mermaid diagram\"}\n          </figcaption>\n          {caption?.trim() ? (\n            <p\n              data-slot=\"mermaid-diagram-caption\"\n              className={cn(\n                \"truncate text-xs text-muted-foreground\",\n                captionClassName,\n              )}\n            >\n              {caption}\n            </p>\n          ) : null}\n        </div>\n        <div\n          className={cn(\"flex shrink-0 items-center gap-1\", actionsClassName)}\n        >\n          {isLoading ? (\n            <span className=\"font-mono text-[10px] text-muted-foreground uppercase\">\n              Loading\n            </span>\n          ) : null}\n          {actions}\n        </div>\n      </div>\n      {children}\n    </figure>\n  );\n}\n\nfunction SvgViewer({\n  ref,\n  svgHtml,\n  isRefreshing,\n  title,\n  caption,\n  tools,\n  inlineZoom,\n  wheelZoom,\n  initialZoom,\n  minZoom,\n  maxZoom,\n  zoomStep,\n  viewportClassName,\n  toolbarClassName,\n  className,\n  headerClassName,\n  titleClassName,\n  captionClassName,\n}: {\n  ref?: Ref<HTMLElement>;\n  svgHtml: string;\n  isRefreshing: boolean;\n  title?: string;\n  caption?: string;\n  tools: readonly MermaidDiagramTool[];\n  inlineZoom: boolean;\n  wheelZoom: boolean;\n  initialZoom: number;\n  minZoom: number;\n  maxZoom: number;\n  zoomStep: number;\n  viewportClassName?: string;\n  toolbarClassName?: string;\n  className?: string;\n  headerClassName?: string;\n  titleClassName?: string;\n  captionClassName?: string;\n}) {\n  const [open, setOpen] = useState(false);\n  const [animateFullscreen, setAnimateFullscreen] = useState(true);\n  const controlsRef = useRef<DiagramViewportControls | null>(null);\n  const inlineControlsRef = useRef<DiagramViewportControls | null>(null);\n  // Fullscreen opens on the diagram itself: it is the content, it takes the\n  // pan/zoom keys, and focusing a toolbar button would pop its tooltip open,\n  // so the first Escape would close the tooltip instead of fullscreen.\n  const fullscreenViewportRef = useRef<HTMLDivElement | null>(null);\n  const label = title?.trim() ? `${title} diagram` : \"Mermaid diagram\";\n  const fullscreen = tools.includes(\"fullscreen\");\n  const inlineTools = inlineZoom\n    ? [...new Set(tools)].filter((tool) => tool !== \"fullscreen\")\n    : [];\n  useFullscreenDocumentScrollLock(open);\n\n  return (\n    <TooltipProvider delay={150}>\n      <MermaidFrame\n        ref={ref}\n        title={title}\n        caption={caption}\n        isLoading={isRefreshing}\n        className={className}\n        headerClassName={headerClassName}\n        titleClassName={titleClassName}\n        captionClassName={captionClassName}\n        actionsClassName={toolbarClassName}\n        actions={\n          <>\n            {inlineTools.length > 0 ? (\n              <ViewerToolbar\n                controlsRef={inlineControlsRef}\n                tools={inlineTools}\n              />\n            ) : null}\n            {fullscreen ? (\n              <Button\n                aria-label=\"View diagram fullscreen\"\n                onClick={(event) => {\n                  setAnimateFullscreen(event.detail > 0);\n                  setOpen(true);\n                }}\n                variant=\"ghost\"\n                size=\"icon\"\n              >\n                <Maximize2 />\n              </Button>\n            ) : null}\n          </>\n        }\n      >\n        <DiagramViewport\n          controlsRef={inlineControlsRef}\n          interactive={inlineZoom}\n          embedded\n          wheelZoom={wheelZoom}\n          initialZoom={initialZoom}\n          minZoom={minZoom}\n          maxZoom={maxZoom}\n          zoomStep={zoomStep}\n          className={cn(\"min-h-48\", viewportClassName)}\n        >\n          <SvgMount svgHtml={svgHtml} ariaLabel={label} />\n        </DiagramViewport>\n      </MermaidFrame>\n      <DialogPrimitive.Root\n        open={open}\n        onOpenChange={(nextOpen, eventDetails) => {\n          if (!nextOpen && eventDetails.event instanceof window.KeyboardEvent) {\n            setAnimateFullscreen(false);\n          }\n          setOpen(nextOpen);\n        }}\n        modal=\"trap-focus\"\n      >\n        <DialogPrimitive.Portal>\n          <DialogPrimitive.Backdrop\n            data-slot=\"mermaid-fullscreen-backdrop\"\n            className=\"fixed inset-0 isolate z-50 bg-transparent\"\n          />\n          <DialogPrimitive.Popup\n            data-slot=\"mermaid-fullscreen\"\n            initialFocus={fullscreenViewportRef}\n            className={cn(\n              \"fixed inset-0 z-50 grid size-full grid-rows-[auto_minmax(0,1fr)] bg-popover text-sm text-popover-foreground opacity-100 outline-none\",\n              animateFullscreen\n                ? \"transition-opacity duration-200 ease-[cubic-bezier(0.23,1,0.32,1)] data-ending-style:opacity-0 data-ending-style:duration-150 data-starting-style:opacity-0 motion-reduce:duration-100\"\n                : \"transition-none\",\n            )}\n          >\n            <div className=\"flex min-h-14 items-stretch justify-between border-b bg-card\">\n              <div className=\"flex min-w-0 flex-1 flex-col justify-center px-4\">\n                <DialogPrimitive.Title\n                  className={cn(\n                    \"truncate text-base font-medium\",\n                    titleClassName,\n                  )}\n                >\n                  {title?.trim() || \"Mermaid diagram\"}\n                </DialogPrimitive.Title>\n                <DialogPrimitive.Description\n                  className={cn(\n                    \"truncate text-xs text-muted-foreground\",\n                    captionClassName,\n                    !caption && \"sr-only\",\n                  )}\n                >\n                  {caption?.trim() ||\n                    \"Interactive fullscreen diagram. Drag to pan and use the toolbar to zoom.\"}\n                </DialogPrimitive.Description>\n              </div>\n              <div className=\"flex shrink-0 items-stretch\">\n                <ViewerToolbar\n                  controlsRef={controlsRef}\n                  tools={FULLSCREEN_TOOLS}\n                  className={cn(\"px-3\", toolbarClassName)}\n                />\n                <Separator\n                  orientation=\"vertical\"\n                  className=\"w-px bg-foreground/20\"\n                />\n                <DialogPrimitive.Close\n                  render={\n                    <Button\n                      aria-label=\"Exit fullscreen\"\n                      className=\"size-14 rounded-none [&_svg:not([class*='size-'])]:size-6\"\n                      variant=\"ghost\"\n                      size=\"icon\"\n                    />\n                  }\n                >\n                  <X />\n                </DialogPrimitive.Close>\n              </div>\n            </div>\n            <DiagramViewport\n              ref={fullscreenViewportRef}\n              controlsRef={controlsRef}\n              interactive\n              wheelZoom={wheelZoom}\n              initialZoom={initialZoom}\n              minZoom={minZoom}\n              maxZoom={maxZoom}\n              zoomStep={zoomStep}\n              className={cn(\"min-h-0\", viewportClassName)}\n            >\n              <SvgMount svgHtml={svgHtml} ariaLabel={label} />\n            </DiagramViewport>\n          </DialogPrimitive.Popup>\n        </DialogPrimitive.Portal>\n      </DialogPrimitive.Root>\n    </TooltipProvider>\n  );\n}\n\nfunction useFullscreenDocumentScrollLock(open: boolean) {\n  useLayoutEffect(() => {\n    if (!open) return;\n\n    const root = document.documentElement;\n    const body = document.body;\n    const rootOverflow = root.style.overflow;\n    const bodyOverflow = body.style.overflow;\n\n    root.style.overflow = \"hidden\";\n    body.style.overflow = \"hidden\";\n\n    return () => {\n      root.style.overflow = rootOverflow;\n      body.style.overflow = bodyOverflow;\n    };\n  }, [open]);\n}\n\nfunction IconButton({\n  label,\n  onClick,\n  children,\n}: {\n  label: string;\n  onClick: () => void;\n  children: ReactNode;\n}) {\n  return (\n    <Tooltip>\n      <TooltipTrigger\n        render={\n          <Button\n            aria-label={label}\n            onClick={onClick}\n            variant=\"ghost\"\n            size=\"icon\"\n          />\n        }\n      >\n        {children}\n      </TooltipTrigger>\n      <TooltipContent>{label}</TooltipContent>\n    </Tooltip>\n  );\n}\n\nfunction ViewerToolbar({\n  controlsRef,\n  tools,\n  className,\n}: {\n  controlsRef: RefObject<DiagramViewportControls | null>;\n  tools: readonly MermaidDiagramTool[];\n  className?: string;\n}) {\n  const getControls = () => controlsRef.current;\n  return (\n    <div className={cn(\"flex shrink-0 items-center gap-1\", className)}>\n      {tools.map((tool) => {\n        switch (tool) {\n          case \"zoom-in\":\n            return (\n              <IconButton\n                key={tool}\n                label=\"Zoom in\"\n                onClick={() => getControls()?.zoomIn()}\n              >\n                <ZoomIn />\n              </IconButton>\n            );\n          case \"zoom-out\":\n            return (\n              <IconButton\n                key={tool}\n                label=\"Zoom out\"\n                onClick={() => getControls()?.zoomOut()}\n              >\n                <ZoomOut />\n              </IconButton>\n            );\n          case \"reset\":\n            return (\n              <IconButton\n                key={tool}\n                label=\"Reset diagram view\"\n                onClick={() => getControls()?.reset()}\n              >\n                <RotateCcw />\n              </IconButton>\n            );\n          default:\n            return null;\n        }\n      })}\n    </div>\n  );\n}\n\nfunction setRefValue<T>(ref: Ref<T> | undefined, value: T | null) {\n  if (typeof ref === \"function\") ref(value);\n  else if (ref) ref.current = value;\n}\n\nexport function DiagramViewport({\n  children,\n  controlsRef,\n  embedded = false,\n  initialZoom = 1,\n  interactive = true,\n  maxZoom = DEFAULT_MAX_ZOOM,\n  minZoom = DEFAULT_MIN_ZOOM,\n  wheelZoom = true,\n  zoomStep = DEFAULT_ZOOM_STEP,\n  className,\n  ref,\n  onKeyDown,\n  onPointerCancel,\n  onPointerDown,\n  onPointerMove,\n  onPointerUp,\n  ...props\n}: DiagramViewportProps) {\n  const reducedMotion = useReducedMotion();\n  const clampScale = useCallback(\n    (scale: number) =>\n      Math.min(\n        Math.max(maxZoom, minZoom),\n        Math.max(Math.min(minZoom, maxZoom), scale),\n      ),\n    [maxZoom, minZoom],\n  );\n  const initialView = useMemo<ViewState>(\n    () => ({ scale: clampScale(initialZoom), x: 0, y: 0 }),\n    [clampScale, initialZoom],\n  );\n  const [view, setView] = useState(initialView);\n  const [isGesturing, setIsGesturing] = useState(false);\n  const viewportRef = useRef<HTMLDivElement | null>(null);\n  const viewRef = useRef(view);\n  const pointersRef = useRef(new Map<number, ViewportPoint>());\n  const dragRef = useRef<{\n    pointerId: number;\n    startX: number;\n    startY: number;\n    x: number;\n    y: number;\n  } | null>(null);\n  const pinchRef = useRef<{ distance: number; midpoint: ViewportPoint } | null>(\n    null,\n  );\n  const pendingViewRef = useRef<ViewState | null>(null);\n  const frameRef = useRef<number | null>(null);\n  const wheelIdleTimerRef = useRef<number | null>(null);\n\n  const setViewportNode = useCallback(\n    (node: HTMLDivElement | null) => {\n      viewportRef.current = node;\n      setRefValue(ref, node);\n    },\n    [ref],\n  );\n\n  const commitView = useCallback((next: ViewState) => {\n    if (frameRef.current !== null) cancelAnimationFrame(frameRef.current);\n    frameRef.current = null;\n    pendingViewRef.current = null;\n    viewRef.current = next;\n    setView(next);\n  }, []);\n\n  const scheduleView = useCallback((next: ViewState) => {\n    viewRef.current = next;\n    pendingViewRef.current = next;\n    if (frameRef.current !== null) return;\n    frameRef.current = requestAnimationFrame(() => {\n      frameRef.current = null;\n      const pending = pendingViewRef.current;\n      pendingViewRef.current = null;\n      if (pending) setView(pending);\n    });\n  }, []);\n\n  // Zooming toward a point keeps the content under that point stationary. The\n  // point is expressed relative to the viewport center, which is also the\n  // content's transform origin.\n  const zoomAtPoint = useCallback(\n    (nextScale: number, point?: ViewportPoint, immediate = true) => {\n      const current = viewRef.current;\n      const scale = clampScale(nextScale);\n      if (scale === current.scale) return;\n      const next = point\n        ? {\n            scale,\n            x: point.x - (point.x - current.x) * (scale / current.scale),\n            y: point.y - (point.y - current.y) * (scale / current.scale),\n          }\n        : { ...current, scale };\n      if (immediate) commitView(next);\n      else scheduleView(next);\n    },\n    [clampScale, commitView, scheduleView],\n  );\n\n  const zoom = useCallback(\n    (direction: 1 | -1) => {\n      zoomAtPoint(viewRef.current.scale + zoomStep * direction);\n    },\n    [zoomAtPoint, zoomStep],\n  );\n  const reset = useCallback(\n    () => commitView(initialView),\n    [commitView, initialView],\n  );\n\n  const getViewportPoint = useCallback(\n    (clientX: number, clientY: number): ViewportPoint => {\n      const node = viewportRef.current;\n      if (!node) return { x: 0, y: 0 };\n      const rect = node.getBoundingClientRect();\n      return {\n        x: clientX - rect.left - rect.width / 2,\n        y: clientY - rect.top - rect.height / 2,\n      };\n    },\n    [],\n  );\n\n  useLayoutEffect(() => {\n    setRefValue(controlsRef, {\n      reset,\n      zoomIn: () => zoom(1),\n      zoomOut: () => zoom(-1),\n    });\n    return () => setRefValue(controlsRef, null);\n  }, [controlsRef, reset, zoom]);\n\n  // React attaches wheel listeners passively, so preventing page scroll while\n  // zooming requires a native non-passive listener.\n  useEffect(() => {\n    const node = viewportRef.current;\n    if (!node || !interactive || !wheelZoom) return;\n\n    const handleWheel = (event: WheelEvent) => {\n      // Inside a page, an unmodified wheel is the reader scrolling past the\n      // diagram, not asking to zoom it.\n      if (embedded && !event.ctrlKey && !event.metaKey) return;\n      event.preventDefault();\n      const deltaY =\n        event.deltaMode === WheelEvent.DOM_DELTA_LINE\n          ? event.deltaY * 16\n          : event.deltaMode === WheelEvent.DOM_DELTA_PAGE\n            ? event.deltaY * 120\n            : event.deltaY;\n      // Trackpad pinches arrive as ctrl+wheel and expect a stronger response.\n      const intensity = event.ctrlKey\n        ? PINCH_WHEEL_ZOOM_INTENSITY\n        : WHEEL_ZOOM_INTENSITY;\n      setIsGesturing(true);\n      if (wheelIdleTimerRef.current !== null)\n        window.clearTimeout(wheelIdleTimerRef.current);\n      wheelIdleTimerRef.current = window.setTimeout(() => {\n        wheelIdleTimerRef.current = null;\n        if (pointersRef.current.size === 0) setIsGesturing(false);\n      }, WHEEL_GESTURE_IDLE_MS);\n      zoomAtPoint(\n        viewRef.current.scale * Math.exp(-deltaY * intensity),\n        getViewportPoint(event.clientX, event.clientY),\n        false,\n      );\n    };\n\n    node.addEventListener(\"wheel\", handleWheel, { passive: false });\n    return () => node.removeEventListener(\"wheel\", handleWheel);\n  }, [embedded, getViewportPoint, interactive, wheelZoom, zoomAtPoint]);\n\n  useEffect(\n    () => () => {\n      if (frameRef.current !== null) cancelAnimationFrame(frameRef.current);\n      if (wheelIdleTimerRef.current !== null)\n        window.clearTimeout(wheelIdleTimerRef.current);\n    },\n    [],\n  );\n\n  const startPinch = useCallback(() => {\n    const [first, second] = [...pointersRef.current.values()];\n    if (!first || !second) return;\n    dragRef.current = null;\n    pinchRef.current = {\n      distance: Math.hypot(second.x - first.x, second.y - first.y),\n      midpoint: getViewportPoint(\n        (first.x + second.x) / 2,\n        (first.y + second.y) / 2,\n      ),\n    };\n  }, [getViewportPoint]);\n\n  const handlePointerDown = (event: PointerEvent<HTMLDivElement>) => {\n    onPointerDown?.(event);\n    if (!interactive || event.defaultPrevented || event.button !== 0) return;\n    // Touch keeps scrolling the page; fullscreen is where fingers pan and pinch.\n    if (embedded && event.pointerType === \"touch\") return;\n    event.currentTarget.setPointerCapture(event.pointerId);\n    pointersRef.current.set(event.pointerId, {\n      x: event.clientX,\n      y: event.clientY,\n    });\n    setIsGesturing(true);\n    if (pointersRef.current.size >= 2) {\n      startPinch();\n    } else {\n      dragRef.current = {\n        pointerId: event.pointerId,\n        startX: event.clientX,\n        startY: event.clientY,\n        x: viewRef.current.x,\n        y: viewRef.current.y,\n      };\n    }\n  };\n\n  const handlePointerMove = (event: PointerEvent<HTMLDivElement>) => {\n    onPointerMove?.(event);\n    const tracked = pointersRef.current.get(event.pointerId);\n    if (!tracked) return;\n    tracked.x = event.clientX;\n    tracked.y = event.clientY;\n\n    const pinch = pinchRef.current;\n    if (pinch && pointersRef.current.size >= 2) {\n      const [first, second] = [...pointersRef.current.values()];\n      const distance = Math.hypot(second.x - first.x, second.y - first.y);\n      if (pinch.distance <= 0 || distance <= 0) return;\n      const midpoint = getViewportPoint(\n        (first.x + second.x) / 2,\n        (first.y + second.y) / 2,\n      );\n      const current = viewRef.current;\n      const scale = clampScale(current.scale * (distance / pinch.distance));\n      const ratio = scale / current.scale;\n      scheduleView({\n        scale,\n        x: midpoint.x - (pinch.midpoint.x - current.x) * ratio,\n        y: midpoint.y - (pinch.midpoint.y - current.y) * ratio,\n      });\n      pinch.distance = distance;\n      pinch.midpoint = midpoint;\n      return;\n    }\n\n    const drag = dragRef.current;\n    if (!drag || drag.pointerId !== event.pointerId) return;\n    scheduleView({\n      ...viewRef.current,\n      x: drag.x + event.clientX - drag.startX,\n      y: drag.y + event.clientY - drag.startY,\n    });\n  };\n\n  const finishPointer = (event: PointerEvent<HTMLDivElement>) => {\n    if (!pointersRef.current.delete(event.pointerId)) return;\n    if (event.currentTarget.hasPointerCapture(event.pointerId))\n      event.currentTarget.releasePointerCapture(event.pointerId);\n\n    if (pointersRef.current.size >= 2) {\n      startPinch();\n      return;\n    }\n    pinchRef.current = null;\n    if (pointersRef.current.size === 1) {\n      const [remaining] = [...pointersRef.current.entries()];\n      dragRef.current = {\n        pointerId: remaining[0],\n        startX: remaining[1].x,\n        startY: remaining[1].y,\n        x: viewRef.current.x,\n        y: viewRef.current.y,\n      };\n      return;\n    }\n    dragRef.current = null;\n    const pending = pendingViewRef.current;\n    if (pending) commitView(pending);\n    setIsGesturing(false);\n  };\n\n  const handleKeyDown = (event: KeyboardEvent<HTMLDivElement>) => {\n    onKeyDown?.(event);\n    if (\n      !interactive ||\n      event.defaultPrevented ||\n      event.metaKey ||\n      event.ctrlKey ||\n      event.altKey\n    )\n      return;\n    const panStep = event.shiftKey ? KEYBOARD_PAN_STEP_FAST : KEYBOARD_PAN_STEP;\n    const current = viewRef.current;\n    switch (event.key) {\n      case \"ArrowUp\":\n        commitView({ ...current, y: current.y + panStep });\n        break;\n      case \"ArrowDown\":\n        commitView({ ...current, y: current.y - panStep });\n        break;\n      case \"ArrowLeft\":\n        commitView({ ...current, x: current.x + panStep });\n        break;\n      case \"ArrowRight\":\n        commitView({ ...current, x: current.x - panStep });\n        break;\n      case \"+\":\n      case \"=\":\n        zoom(1);\n        break;\n      case \"-\":\n      case \"_\":\n        zoom(-1);\n        break;\n      case \"0\":\n        reset();\n        break;\n      default:\n        return;\n    }\n    event.preventDefault();\n  };\n\n  return (\n    <div\n      role={interactive ? \"group\" : undefined}\n      aria-label={\n        !interactive\n          ? undefined\n          : embedded\n            ? \"Diagram viewport. Drag or use arrow keys to pan, press plus and minus to zoom, 0 to reset.\"\n            : \"Diagram viewport. Drag or use arrow keys to pan, pinch or press plus and minus to zoom, 0 to reset.\"\n      }\n      tabIndex={interactive ? 0 : undefined}\n      {...props}\n      ref={setViewportNode}\n      data-mermaid-viewport={\n        !interactive ? \"static\" : embedded ? \"embedded\" : \"interactive\"\n      }\n      className={cn(\n        \"relative flex overflow-hidden bg-background\",\n        interactive &&\n          \"cursor-grab select-none focus-visible:ring-2 focus-visible:ring-ring/60 focus-visible:outline-none focus-visible:ring-inset active:cursor-grabbing\",\n        interactive && !embedded ? \"touch-none\" : \"touch-auto\",\n        className,\n      )}\n      onPointerDown={handlePointerDown}\n      onPointerMove={handlePointerMove}\n      onPointerUp={(event) => {\n        onPointerUp?.(event);\n        finishPointer(event);\n      }}\n      onPointerCancel={(event) => {\n        onPointerCancel?.(event);\n        finishPointer(event);\n      }}\n      onKeyDown={handleKeyDown}\n    >\n      <div\n        data-mermaid-viewport-content\n        className=\"flex min-h-full w-full origin-center items-center justify-center p-4\"\n        style={{\n          transform: `translate(${view.x}px, ${view.y}px) scale(${view.scale})`,\n          transition:\n            isGesturing || reducedMotion ? \"none\" : \"transform 120ms ease-out\",\n          // A page can hold many inline diagrams; only promote those in motion.\n          willChange:\n            interactive && (!embedded || isGesturing) ? \"transform\" : undefined,\n        }}\n      >\n        {children}\n      </div>\n    </div>\n  );\n}\n\nfunction SvgMount({\n  svgHtml,\n  ariaLabel,\n}: {\n  svgHtml: string;\n  ariaLabel: string;\n}) {\n  const ref = useRef<HTMLDivElement | null>(null);\n\n  useLayoutEffect(() => {\n    const svg = ref.current?.querySelector(\"svg\");\n    // Mermaid inlines a pixel max-width on the root svg, which beats the\n    // class-based sizing below; override it so the diagram fits the viewport.\n    if (svg instanceof SVGSVGElement) {\n      svg.style.maxWidth = \"100%\";\n      svg.style.maxHeight = \"100%\";\n    }\n  }, [svgHtml]);\n\n  return (\n    <div\n      ref={ref}\n      role=\"img\"\n      aria-label={ariaLabel}\n      className=\"flex size-full items-center justify-center text-foreground [&_svg]:h-auto [&_svg]:max-h-full [&_svg]:max-w-full\"\n      dangerouslySetInnerHTML={{ __html: svgHtml }}\n    />\n  );\n}\n\nfunction MermaidRenderError({\n  chart,\n  error,\n  onRepair,\n  className,\n  ref,\n}: {\n  chart: string;\n  error: string;\n  onRepair?: (request: MermaidRepairRequest) => void | Promise<void>;\n  className?: string;\n  ref?: Ref<HTMLDivElement>;\n}) {\n  const [isRepairing, setIsRepairing] = useState(false);\n  const [repairError, setRepairError] = useState<string | null>(null);\n\n  const repair = async () => {\n    if (!onRepair || isRepairing) return;\n    setIsRepairing(true);\n    setRepairError(null);\n    try {\n      await onRepair({ chart, error });\n    } catch (caught) {\n      setRepairError(\n        caught instanceof Error && caught.message.trim()\n          ? caught.message\n          : \"Could not repair this diagram.\",\n      );\n    } finally {\n      setIsRepairing(false);\n    }\n  };\n\n  return (\n    <div\n      ref={ref}\n      className={cn(\n        \"my-4 rounded-xl border border-destructive/30 bg-destructive/5 p-3 text-sm text-foreground\",\n        className,\n      )}\n    >\n      <div className=\"flex flex-wrap items-start justify-between gap-3\">\n        <div className=\"min-w-0\">\n          <p className=\"font-medium text-destructive\">\n            Mermaid diagram could not render.\n          </p>\n          <p className=\"mt-1 wrap-break-word text-muted-foreground\">{error}</p>\n          {repairError ? (\n            <p className=\"mt-2 text-xs wrap-break-word text-destructive\">\n              {repairError}\n            </p>\n          ) : null}\n        </div>\n        {onRepair ? (\n          <Button\n            disabled={isRepairing}\n            onClick={() => void repair()}\n            size=\"sm\"\n            type=\"button\"\n            variant=\"outline\"\n          >\n            {isRepairing ? \"Repairing…\" : \"Repair diagram\"}\n          </Button>\n        ) : null}\n      </div>\n      <details className=\"mt-3\">\n        <summary className=\"cursor-pointer text-xs font-medium text-muted-foreground\">\n          View Mermaid source\n        </summary>\n        <pre className=\"mt-2 max-h-64 overflow-auto rounded-lg border bg-muted p-3 text-xs text-muted-foreground\">\n          <code>{chart}</code>\n        </pre>\n      </details>\n    </div>\n  );\n}\n",
      "type": "registry:block",
      "target": "@components/blocks/mermaid-diagram.tsx"
    }
  ],
  "meta": {
    "tags": [
      "diagram",
      "flowchart",
      "markdown",
      "svg",
      "pan",
      "zoom",
      "fullscreen",
      "responsive",
      "streaming",
      "error-recovery"
    ],
    "effects": [
      "pan",
      "zoom",
      "fullscreen",
      "reduced-motion"
    ]
  },
  "categories": [
    "app-pattern"
  ],
  "type": "registry:block"
}