@embedpdf/react 3.0.0-next.14 → 3.0.0-next.15

package/dist/toolbar.cjs.map

@@ -1 +1 @@
-{"version":3,"file":"toolbar.cjs","names":["useCapability","CommandsToken","useDocumentId","useKernelValue","React","useKernel"],"sources":["../src/toolbar.tsx"],"sourcesContent":["/**\n * The headless <Toolbar> — where measurement meets the pure solver.\n *\n * The schema is structure-only; what fits is OBSERVED, not configured:\n *\n *   1. a hidden measurement layer renders every unit in every variant (plus\n *      collapsed group forms and the overflow trigger), each wrapped in a\n *      ResizeObserver — so locale flips, font loads, browser zoom, and\n *      embedder CSS all re-measure themselves with zero handling code;\n *   2. ui-core's solve() assigns each unit a variant / collapsed / overflow —\n *      pure, deterministic, tested in isolation;\n *   3. the live row renders the assignment; the overflow menu is DERIVED\n *      (projectOverflow) — the complement of the visible set, never authored.\n *\n * Rendering is render-prop driven with functional defaults: the app owns the\n * pixels, this component owns the physics.\n */\n\n// One-line-per-feature: registration travels with the UI.\nexport * from '@embedpdf/core-ui';\nimport * as React from 'react';\nimport { useEffect, useLayoutEffect, useMemo, useReducer, useRef, useState } from 'react';\nimport { filterBar, normalizeBar, projectOverflow, projectStrip, solve } from '@embedpdf/core-ui';\nimport type {\n  BarSchema,\n  FitMetrics,\n  NormalizedGroup,\n  NormalizedSection,\n  NormalizedUnit,\n  OverflowSection,\n} from '@embedpdf/core-ui';\nimport { CommandsToken, resolvedCommandsEqual } from '@embedpdf/plugin-commands/contract';\nimport type { ResolvedCommand } from '@embedpdf/plugin-commands/contract';\nimport { useCapability, useDocumentId, useKernel, useKernelValue } from './runtime';\n\n// ── public render-prop contracts ─────────────────────────────────────────────\n\nexport interface CollapsedGroupView {\n  readonly id: string;\n  readonly labelKey?: string;\n  readonly collapse: 'menu' | 'select';\n  readonly role: 'buttons' | 'tabs';\n  /** The group's commands (custom items via their terminal), resolved live. */\n  readonly commands: readonly ResolvedCommand[];\n  execute(id: string): void;\n}\n\nexport interface OverflowMenuView {\n  readonly sections: readonly OverflowSection[];\n  readonly isOpen: boolean;\n  close(): void;\n  resolve(id: string): ResolvedCommand | null;\n  execute(id: string): void;\n}\n\n/**\n * A shed group's disclosure — the derived trigger rendered INSIDE the group\n * (v2's overflow-tabs-button). `commands` is what sits behind the trigger:\n * the shed children in bar order, resolved live. In the measurement layer the\n * trigger is measured with the FULL group as content, so a count-dependent\n * trigger (e.g. a \"+3\" badge) is budgeted at its widest form.\n */\nexport interface GroupDisclosureView {\n  readonly id: string;\n  readonly labelKey?: string;\n  readonly role: 'buttons' | 'tabs';\n  readonly commands: readonly ResolvedCommand[];\n  execute(id: string): void;\n}\n\n// ── the strip view — a bar projected through the registry, live ──────────────\n\nexport interface StripViewGroup {\n  readonly id: string;\n  readonly labelKey?: string;\n  /** Visible commands, bar order. Groups are separator boundaries. */\n  readonly commands: readonly ResolvedCommand[];\n}\n\n/** A contextual strip, resolved: only visible commands, only non-empty groups. */\nexport interface StripView {\n  readonly groups: readonly StripViewGroup[];\n  execute(id: string): void;\n}\n\nconst stripGroupsEqual = (a: readonly StripViewGroup[], b: readonly StripViewGroup[]): boolean =>\n  a.length === b.length &&\n  a.every(\n    (g, i) =>\n      g.id === b[i].id &&\n      g.commands.length === b[i].commands.length &&\n      g.commands.every((c, j) => resolvedCommandsEqual(c, b[i].commands[j])),\n  );\n\nconst NO_STRIP_GROUPS: readonly StripViewGroup[] = [];\n\n/**\n * The live projection of a bar through the command registry — <Toolbar>'s\n * un-measured sibling, for contextual strips (ChromeSchema.strips). The schema\n * declares what COULD appear; each command's `visible` derivation decides what\n * DOES; null means nothing currently applies, so `if (!view) return null` is\n * the caller's entire show/hide logic. `execute` is pre-bound to this\n * subtree's document. Reads are value-equal (resolvedCommandsEqual), so\n * consumers re-render on real change, not on every store action.\n */\nexport function useStripView(bar: BarSchema | undefined): StripView | null {\n  const commands = useCapability(CommandsToken);\n  const documentId = useDocumentId();\n  const normalized = useMemo(() => (bar ? normalizeBar(bar) : null), [bar]);\n  const groups = useKernelValue(() => {\n    if (!normalized) return NO_STRIP_GROUPS;\n    const resolved = new Map<string, ResolvedCommand>();\n    const visible = (id: string) => {\n      const cmd = commands.resolve(id, documentId ?? undefined);\n      if (cmd) resolved.set(id, cmd);\n      return cmd?.visible === true;\n    };\n    return projectStrip(normalized, visible).map((g) => ({\n      id: g.id,\n      labelKey: g.labelKey,\n      commands: g.commands.map((id) => resolved.get(id)!),\n    }));\n  }, stripGroupsEqual);\n  return useMemo(\n    () =>\n      groups.length === 0\n        ? null\n        : { groups, execute: (id: string) => commands.execute(id, documentId ?? undefined) },\n    [groups, commands, documentId],\n  );\n}\n\nexport interface ToolbarProps {\n  bar: BarSchema;\n  /** Px between adjacent items (CSS flex gap; the solver budgets the same number). */\n  gap?: number;\n  /** Width of the separator ELEMENT your renderSeparator draws. Default 1. */\n  separatorWidth?: number;\n  className?: string;\n  style?: React.CSSProperties;\n  /** A command button at a given variant. Default: a plain <button>. */\n  renderCommand?: (cmd: ResolvedCommand, variant: string, run: () => void) => React.ReactNode;\n  /**\n   * Renderers for custom slots, per named variant. A custom unit with NO\n   * entry here renders as a native `<slot name={slot}>` socket with its\n   * terminal command as fallback content: in light DOM that displays the\n   * fallback (today's behavior); inside a shadow root the host's light-DOM\n   * children project into it — the children-as-slots contract. Sockets are\n   * measured LIVE (they can't be duplicated into the measurement layer:\n   * only the first same-named slot in tree order gets the projected nodes).\n   */\n  renderCustom?: Record<string, (variant: string, ctx: CustomSlotCtx) => React.ReactNode>;\n  /** A group in its collapsed form. Default: <select> for 'select', menu button for 'menu'. */\n  renderCollapsed?: (view: CollapsedGroupView) => React.ReactNode;\n  /** A shed group's disclosure trigger (+ its popover — the renderer owns the\n   *  open state). Default: a chevron button opening a radio menu. */\n  renderGroupTrigger?: (view: GroupDisclosureView) => React.ReactNode;\n  /** Derived separator between adjacent visible groups. Default: a 1px line. */\n  renderSeparator?: () => React.ReactNode;\n  renderOverflowTrigger?: (isOpen: boolean, toggle: () => void) => React.ReactNode;\n  /** The derived overflow menu. Default: a minimal popover. */\n  renderOverflowMenu?: (view: OverflowMenuView) => React.ReactNode;\n}\n\n/** Passed to custom-slot renderers alongside the variant. */\nexport interface CustomSlotCtx {\n  /** 'live' = the visible row; 'measure' = the hidden measurement layer. */\n  layer: 'live' | 'measure';\n  /** Report this unit's width to the solver — for content the measurement\n   *  layer can't duplicate. Identity is NOT stable across renders; capture\n   *  via ref if used in an effect. */\n  measure: (width: number) => void;\n}\n\n// ── measurement ───────────────────────────────────────────────────────────────\n\n/** Report this node's border-box width under `k`, live, via ResizeObserver. */\nfunction Measured({\n  k,\n  onWidth,\n  children,\n}: {\n  k: string;\n  onWidth: (key: string, width: number) => void;\n  children: React.ReactNode;\n}) {\n  const ref = useRef<HTMLSpanElement>(null);\n  useLayoutEffect(() => {\n    const el = ref.current;\n    if (!el) return;\n    const report = () => onWidth(k, el.getBoundingClientRect().width);\n    report();\n    const observer = new ResizeObserver(report);\n    observer.observe(el);\n    return () => observer.disconnect();\n  }, [k, onWidth]);\n  return (\n    <span ref={ref} style={{ display: 'inline-flex', flexShrink: 0 }}>\n      {children}\n    </span>\n  );\n}\n\n/**\n * The socket for an unregistered custom unit: a real `<slot>` element. Inside\n * the <embedpdf-viewer> shadow root the browser projects same-named light-DOM\n * children into it; anywhere else it just displays its fallback (the terminal\n * command). Measured live — the projected content lives in the HOST's world,\n * so its width can only be observed where it actually renders.\n */\nfunction NativeSlotSocket({\n  name,\n  k,\n  onWidth,\n  children,\n}: {\n  name: string;\n  k: string;\n  onWidth: (key: string, width: number) => void;\n  children: React.ReactNode;\n}) {\n  const ref = useRef<HTMLSlotElement>(null);\n  useLayoutEffect(() => {\n    const el = ref.current;\n    if (!el) return;\n    const report = () => onWidth(k, el.getBoundingClientRect().width);\n    report();\n    // Projection changes (a child slotted in/out) resize the socket's\n    // inline-flex box, so one observer covers both content and assignment.\n    const observer = new ResizeObserver(report);\n    observer.observe(el);\n    return () => observer.disconnect();\n  }, [k, onWidth]);\n  return (\n    <slot\n      ref={ref}\n      name={name}\n      style={{ display: 'inline-flex', alignItems: 'center', flexShrink: 0 }}\n    >\n      {children}\n    </slot>\n  );\n}\n\nconst measureLayerStyle: React.CSSProperties = {\n  position: 'absolute',\n  left: 0,\n  top: 0,\n  height: 0,\n  overflow: 'hidden',\n  visibility: 'hidden',\n  pointerEvents: 'none',\n  display: 'flex',\n  whiteSpace: 'nowrap',\n};\n\n// ── defaults (functional, unstyled-ish; products replace them) ───────────────\n\nconst defaultRenderCommand = (\n  cmd: ResolvedCommand,\n  variant: string,\n  run: () => void,\n): React.ReactNode => (\n  <button\n    type=\"button\"\n    onClick={run}\n    disabled={!cmd.enabled}\n    aria-pressed={cmd.active || undefined}\n    aria-haspopup={cmd.menu ? 'menu' : undefined}\n    title={cmd.label}\n    style={{\n      display: 'inline-flex',\n      alignItems: 'center',\n      gap: 4,\n      padding: '4px 8px',\n      whiteSpace: 'nowrap',\n      background: cmd.active ? 'rgba(0,0,0,0.12)' : 'transparent',\n      border: '1px solid rgba(0,0,0,0.15)',\n      borderRadius: 4,\n      cursor: cmd.enabled ? 'pointer' : 'default',\n      opacity: cmd.enabled ? 1 : 0.4,\n    }}\n  >\n    {variant === 'label' ? cmd.label : (cmd.icon ?? cmd.label)}\n    {variant === 'icon+label' ? ` ${cmd.label}` : null}\n  </button>\n);\n\nconst defaultRenderSeparator = (): React.ReactNode => (\n  <span style={{ width: 1, alignSelf: 'stretch', background: 'currentColor', opacity: 0.2 }} />\n);\n\nconst defaultRenderOverflowTrigger = (isOpen: boolean, toggle: () => void): React.ReactNode => (\n  <button\n    type=\"button\"\n    onClick={toggle}\n    aria-haspopup=\"menu\"\n    aria-expanded={isOpen}\n    title=\"More\"\n    style={{\n      display: 'inline-flex',\n      alignItems: 'center',\n      padding: '4px 8px',\n      border: '1px solid rgba(0,0,0,0.15)',\n      borderRadius: 4,\n      background: isOpen ? 'rgba(0,0,0,0.12)' : 'transparent',\n      cursor: 'pointer',\n    }}\n  >\n    ⋯\n  </button>\n);\n\nfunction DefaultOverflowMenu({ view }: { view: OverflowMenuView }) {\n  if (!view.isOpen) return null;\n  return (\n    <>\n      <div style={{ position: 'fixed', inset: 0, zIndex: 40 }} onClick={view.close} />\n      <div\n        role=\"menu\"\n        style={{\n          position: 'absolute',\n          right: 0,\n          top: '100%',\n          zIndex: 41,\n          minWidth: 200,\n          padding: 4,\n          background: 'white',\n          border: '1px solid rgba(0,0,0,0.15)',\n          borderRadius: 6,\n          boxShadow: '0 4px 16px rgba(0,0,0,0.15)',\n        }}\n      >\n        {view.sections.map((section, i) => (\n          <React.Fragment key={i}>\n            {i > 0 && <div style={{ height: 1, background: 'rgba(0,0,0,0.1)', margin: '4px 0' }} />}\n            {section.rows.map((row) => {\n              const cmd = view.resolve(row.command);\n              if (!cmd) return null;\n              const isSubmenu = row.type === 'submenu';\n              return (\n                <button\n                  key={row.command}\n                  type=\"button\"\n                  role={section.role === 'radio' ? 'menuitemradio' : 'menuitem'}\n                  aria-checked={section.role === 'radio' ? cmd.active : undefined}\n                  disabled={!cmd.enabled}\n                  onClick={() => {\n                    view.execute(row.command);\n                    if (!isSubmenu) view.close();\n                  }}\n                  style={{\n                    display: 'flex',\n                    width: '100%',\n                    alignItems: 'center',\n                    justifyContent: 'space-between',\n                    gap: 16,\n                    padding: '6px 8px',\n                    border: 'none',\n                    background: 'transparent',\n                    cursor: cmd.enabled ? 'pointer' : 'default',\n                    opacity: cmd.enabled ? 1 : 0.4,\n                    whiteSpace: 'nowrap',\n                  }}\n                >\n                  <span>\n                    {cmd.active && section.role === 'radio' ? '• ' : ''}\n                    {cmd.label}\n                  </span>\n                  {isSubmenu ? <span>▸</span> : null}\n                </button>\n              );\n            })}\n          </React.Fragment>\n        ))}\n      </div>\n    </>\n  );\n}\n\nfunction DefaultCollapsed({ view }: { view: CollapsedGroupView }) {\n  if (view.collapse === 'select') {\n    const active = view.commands.find((c) => c.active);\n    return (\n      <select\n        value={active?.id ?? ''}\n        onChange={(e) => view.execute(e.target.value)}\n        style={{ padding: '4px 6px', borderRadius: 4 }}\n      >\n        {view.commands.map((c) => (\n          <option key={c.id} value={c.id} disabled={!c.enabled}>\n            {c.label}\n          </option>\n        ))}\n      </select>\n    );\n  }\n  // 'menu': reuse the overflow popover, scoped to this group's commands.\n  return <CollapsedMenuButton view={view} />;\n}\n\nfunction CollapsedMenuButton({ view }: { view: CollapsedGroupView }) {\n  const [isOpen, setOpen] = useState(false);\n  const sections: OverflowSection[] = [\n    {\n      labelKey: view.labelKey,\n      role: view.role === 'tabs' ? 'radio' : undefined,\n      rows: view.commands.map((c) => ({ type: 'command' as const, command: c.id })),\n    },\n  ];\n  return (\n    <span style={{ position: 'relative', display: 'inline-flex' }}>\n      {defaultRenderOverflowTrigger(isOpen, () => setOpen((o) => !o))}\n      <DefaultOverflowMenu\n        view={{\n          sections,\n          isOpen,\n          close: () => setOpen(false),\n          resolve: (id) => view.commands.find((c) => c.id === id) ?? null,\n          execute: view.execute,\n        }}\n      />\n    </span>\n  );\n}\n\n/** Default shed-group disclosure: a chevron opening a radio menu of the\n *  hidden children — v2's overflow-tabs-button, derived. */\nfunction DefaultGroupTrigger({ view }: { view: GroupDisclosureView }) {\n  const [isOpen, setOpen] = useState(false);\n  const someActive = view.commands.some((c) => c.active);\n  const sections: OverflowSection[] = [\n    {\n      labelKey: view.labelKey,\n      role: view.role === 'tabs' ? 'radio' : undefined,\n      rows: view.commands.map((c) => ({ type: 'command' as const, command: c.id })),\n    },\n  ];\n  return (\n    <span style={{ position: 'relative', display: 'inline-flex' }}>\n      <button\n        type=\"button\"\n        onClick={() => setOpen((o) => !o)}\n        aria-haspopup=\"menu\"\n        aria-expanded={isOpen}\n        title=\"More\"\n        style={{\n          display: 'inline-flex',\n          alignItems: 'center',\n          padding: '4px 6px',\n          border: '1px solid rgba(0,0,0,0.15)',\n          borderRadius: 4,\n          // hint that the active item is hiding in here\n          background: isOpen || someActive ? 'rgba(0,0,0,0.12)' : 'transparent',\n          cursor: 'pointer',\n        }}\n      >\n        ▾\n      </button>\n      <DefaultOverflowMenu\n        view={{\n          sections,\n          isOpen,\n          close: () => setOpen(false),\n          resolve: (id) => view.commands.find((c) => c.id === id) ?? null,\n          execute: view.execute,\n        }}\n      />\n    </span>\n  );\n}\n\n// ── the toolbar ───────────────────────────────────────────────────────────────\n\nconst unitKey = (u: NormalizedUnit, variant: string) => `u:${u.key}@${variant}`;\nconst groupKey = (id: string) => `g:${id}`;\nconst groupTriggerKey = (id: string) => `gt:${id}`;\nconst TRIGGER_KEY = 't:';\n\nexport function Toolbar({\n  bar,\n  gap = 8,\n  separatorWidth = 1,\n  className,\n  style,\n  renderCommand = defaultRenderCommand,\n  renderCustom,\n  renderCollapsed,\n  renderGroupTrigger,\n  renderSeparator = defaultRenderSeparator,\n  renderOverflowTrigger = defaultRenderOverflowTrigger,\n  renderOverflowMenu,\n}: ToolbarProps) {\n  const kernel = useKernel();\n  const commands = useCapability(CommandsToken);\n  const documentId = useDocumentId();\n\n  // Command state is derived-on-read; re-render on the kernel's change stream\n  // so labels/active/visible (and thus the hidden layer's measurements) stay\n  // live. The toolbar is small — a per-action render is the simple, correct\n  // baseline.\n  const [, force] = useReducer((x: number) => x + 1, 0);\n  useEffect(() => kernel.subscribe(force), [kernel]);\n\n  const containerRef = useRef<HTMLDivElement>(null);\n  const [containerWidth, setContainerWidth] = useState(0);\n  useLayoutEffect(() => {\n    const el = containerRef.current;\n    if (!el) return;\n    const observer = new ResizeObserver((entries) => {\n      const w = entries[entries.length - 1]?.contentRect.width;\n      if (w !== undefined) setContainerWidth((prev) => (Math.abs(prev - w) > 0.5 ? w : prev));\n    });\n    observer.observe(el);\n    setContainerWidth(el.clientWidth);\n    return () => observer.disconnect();\n  }, []);\n\n  const widthsRef = useRef(new Map<string, number>());\n  const [, bumpMeasureVersion] = useReducer((x: number) => x + 1, 0);\n  const onWidth = useMemo(\n    () => (key: string, width: number) => {\n      const prev = widthsRef.current.get(key);\n      if (prev !== undefined && Math.abs(prev - width) <= 0.5) return;\n      widthsRef.current.set(key, width);\n      bumpMeasureVersion();\n    },\n    [],\n  );\n\n  const resolveCmd = (id: string): ResolvedCommand | null =>\n    commands.resolve(id, documentId ?? undefined);\n  const executeCmd = (id: string) => commands.execute(id, documentId ?? undefined);\n  const commandOf = (u: NormalizedUnit) => (u.kind === 'command' ? u.command : u.terminal);\n\n  // Structure → visible structure → fit. Cheap enough to run per render; all\n  // heavy lifting is O(items), and items is ~dozens.\n  const normalized = useMemo(() => normalizeBar(bar), [bar]);\n  // `=== true` and not `!== false`: an UNREGISTERED command resolves to null,\n  // and a unit the registry can't name must not render or consume budget —\n  // the schema validator's dev warning is the feedback channel, not raw text\n  // in the toolbar.\n  const visibleBar = filterBar(normalized, (u) => resolveCmd(commandOf(u))?.visible === true);\n  const metrics: FitMetrics = {\n    unit: (key, variant) => widthsRef.current.get(`u:${key}@${variant}`),\n    groupCollapsed: (id) => widthsRef.current.get(groupKey(id)),\n    groupTrigger: (id) => widthsRef.current.get(groupTriggerKey(id)),\n    overflowTrigger: widthsRef.current.get(TRIGGER_KEY) ?? 32,\n    gap,\n    // The separator is one extra flex child: its element width plus one flex gap.\n    separator: separatorWidth + gap,\n  };\n  const fit = solve(visibleBar, metrics, containerWidth);\n  const overflowSections = projectOverflow(visibleBar, fit, (id) => commands.menuTarget(id));\n\n  const [overflowOpen, setOverflowOpen] = useState(false);\n  useEffect(() => {\n    if (!fit.hasOverflow) setOverflowOpen(false);\n  }, [fit.hasOverflow]);\n\n  /** External = custom unit with no registered renderer → native socket,\n   *  live-measured (it must NOT appear in the measurement layer: only the\n   *  first same-named <slot> in tree order receives the projected nodes). */\n  const isExternalSlot = (u: NormalizedUnit): boolean =>\n    u.kind === 'custom' && !renderCustom?.[u.slot];\n\n  // ── unit / group rendering (shared by live row and measure layer) ──────────\n  const renderUnitAt = (\n    u: NormalizedUnit,\n    variant: string,\n    layer: 'live' | 'measure',\n  ): React.ReactNode => {\n    if (u.kind === 'custom') {\n      const registered = renderCustom?.[u.slot];\n      if (registered) {\n        const custom = registered(variant, {\n          layer,\n          measure: (width) => onWidth(unitKey(u, variant), width),\n        });\n        if (custom !== undefined) return custom;\n      } else if (layer === 'live') {\n        const cmd = resolveCmd(u.terminal);\n        return (\n          <NativeSlotSocket name={u.slot} k={unitKey(u, variant)} onWidth={onWidth}>\n            {cmd ? renderCommand(cmd, 'icon', () => executeCmd(u.terminal)) : null}\n          </NativeSlotSocket>\n        );\n      } else {\n        return null;\n      }\n      const cmd = resolveCmd(u.terminal);\n      return cmd ? renderCommand(cmd, 'icon', () => executeCmd(u.terminal)) : null;\n    }\n    const cmd = resolveCmd(u.command);\n    if (!cmd)\n      return renderCommand(\n        {\n          id: u.command,\n          label: u.command,\n          shortcuts: [],\n          enabled: false,\n          active: false,\n          visible: true,\n          categories: [],\n        },\n        variant,\n        () => {},\n      );\n    return renderCommand(cmd, variant, () => executeCmd(u.command));\n  };\n\n  const collapsedView = (g: NormalizedGroup): CollapsedGroupView => ({\n    id: g.id,\n    labelKey: g.labelKey,\n    collapse: g.collapse ?? 'menu',\n    role: g.role,\n    commands: g.units\n      .map((u) => resolveCmd(commandOf(u)))\n      .filter((c): c is ResolvedCommand => c !== null && c.visible),\n    execute: executeCmd,\n  });\n\n  const renderCollapsedGroup = (g: NormalizedGroup): React.ReactNode =>\n    renderCollapsed ? (\n      renderCollapsed(collapsedView(g))\n    ) : (\n      <DefaultCollapsed view={collapsedView(g)} />\n    );\n\n  /** The disclosure view: shed children for the live trigger; the WHOLE group\n   *  for the measured trigger, so width is budgeted at its fullest content. */\n  const disclosureView = (g: NormalizedGroup, allChildren: boolean): GroupDisclosureView => ({\n    id: g.id,\n    labelKey: g.labelKey,\n    role: g.role,\n    commands: g.units\n      .filter((u) => allChildren || fit.units.get(u.key)?.kind === 'shed')\n      .map((u) => resolveCmd(commandOf(u)))\n      .filter((c): c is ResolvedCommand => c !== null && c.visible),\n    execute: executeCmd,\n  });\n\n  const renderDisclosure = (g: NormalizedGroup, allChildren: boolean): React.ReactNode =>\n    renderGroupTrigger ? (\n      renderGroupTrigger(disclosureView(g, allChildren))\n    ) : (\n      <DefaultGroupTrigger view={disclosureView(g, allChildren)} />\n    );\n\n  const renderLiveGroup = (g: NormalizedGroup): React.ReactNode[] => {\n    const assignment = fit.groups.get(g.id);\n    if (!assignment || assignment.overflowed) return [];\n    if (assignment.collapsed)\n      return [<React.Fragment key={g.id}>{renderCollapsedGroup(g)}</React.Fragment>];\n    const nodes: React.ReactNode[] = [];\n    for (const u of g.units) {\n      const a = fit.units.get(u.key);\n      if (a?.kind !== 'variant') continue;\n      nodes.push(<React.Fragment key={u.key}>{renderUnitAt(u, a.variant, 'live')}</React.Fragment>);\n    }\n    // The derived group-local disclosure (v2's overflow-tabs-button).\n    if (assignment.shedCount > 0) {\n      nodes.push(\n        <React.Fragment key={`${g.id}::trigger`}>{renderDisclosure(g, false)}</React.Fragment>,\n      );\n    }\n    return nodes.length ? [<React.Fragment key={g.id}>{nodes}</React.Fragment>] : [];\n  };\n\n  const renderLiveSection = (section: NormalizedSection | undefined): React.ReactNode => {\n    if (!section) return null;\n    const rendered = section.groups\n      .map((g) => ({ id: g.id, nodes: renderLiveGroup(g) }))\n      .filter((g) => g.nodes.length > 0);\n    return rendered.map((g, i) => (\n      <React.Fragment key={g.id}>\n        {i > 0 && renderSeparator()}\n        {g.nodes}\n      </React.Fragment>\n    ));\n  };\n\n  const sectionByName = (name: 'start' | 'center' | 'end') =>\n    visibleBar.sections.find((s) => s.name === name);\n\n  /**\n   * Segment layout — v2's spacer model, natively. The center segment carries\n   * auto margins: it BALANCES in the leftover space (true center when the\n   * flanks are symmetric) and yields when they aren't, collapsing to zero\n   * before anything can overlap. The container itself has NO gap — segments\n   * space themselves — so the solver's global budget (sum of unit widths +\n   * per-unit gaps) is exactly the layout's minimum width: what the solver\n   * says fits, fits. Its cross-segment gap allowance (≤ 2×gap) becomes slack\n   * the auto margins absorb, keeping ≥ gap between segments at the floor.\n   * Segments never grow or shrink: fit is the SOLVER's job, not flexbox's.\n   */\n  const sectionStyle = (position: 'start' | 'center' | 'end'): React.CSSProperties => ({\n    display: 'flex',\n    alignItems: 'center',\n    gap,\n    flex: '0 0 auto',\n    ...(position === 'center' ? { marginLeft: 'auto', marginRight: 'auto' } : null),\n  });\n\n  const overflowView: OverflowMenuView = {\n    sections: overflowSections,\n    isOpen: overflowOpen,\n    close: () => setOverflowOpen(false),\n    resolve: resolveCmd,\n    execute: executeCmd,\n  };\n\n  return (\n    <div\n      ref={containerRef}\n      className={className}\n      style={{ position: 'relative', display: 'flex', alignItems: 'center', ...style }}\n    >\n      <div style={sectionStyle('start')}>{renderLiveSection(sectionByName('start'))}</div>\n      <div style={sectionStyle('center')}>{renderLiveSection(sectionByName('center'))}</div>\n      <div style={sectionStyle('end')}>\n        {renderLiveSection(sectionByName('end'))}\n        {fit.hasOverflow && (\n          <span style={{ position: 'relative', display: 'inline-flex' }}>\n            {renderOverflowTrigger(overflowOpen, () => setOverflowOpen((o) => !o))}\n            {renderOverflowMenu ? (\n              renderOverflowMenu(overflowView)\n            ) : (\n              <DefaultOverflowMenu view={overflowView} />\n            )}\n          </span>\n        )}\n      </div>\n\n      {/* The measurement layer: every unit in every variant, every collapsed\n          group form, and the trigger — hidden, inert, observed. Text reflow\n          (locale, fonts, zoom) fires the observers; no change-handling code. */}\n      <div aria-hidden style={measureLayerStyle}>\n        {visibleBar.sections.flatMap((s) =>\n          s.groups.flatMap((g) => [\n            // External sockets are excluded: they are live-measured, and a\n            // duplicate <slot> here would steal the projection from the row.\n            ...g.units\n              .filter((u) => !isExternalSlot(u))\n              .flatMap((u) =>\n                u.variants.map((variant) => (\n                  <Measured key={unitKey(u, variant)} k={unitKey(u, variant)} onWidth={onWidth}>\n                    {renderUnitAt(u, variant, 'measure')}\n                  </Measured>\n                )),\n              ),\n            ...(g.collapse\n              ? [\n                  <Measured key={groupKey(g.id)} k={groupKey(g.id)} onWidth={onWidth}>\n                    {renderCollapsedGroup(g)}\n                  </Measured>,\n                ]\n              : []),\n            ...(g.shed\n              ? [\n                  <Measured key={groupTriggerKey(g.id)} k={groupTriggerKey(g.id)} onWidth={onWidth}>\n                    {renderDisclosure(g, true)}\n                  </Measured>,\n                ]\n              : []),\n          ]),\n        )}\n        <Measured k={TRIGGER_KEY} onWidth={onWidth}>\n          {renderOverflowTrigger(false, () => {})}\n        </Measured>\n      </div>\n    </div>\n  );\n}\n"],"mappings":";;;;;;;;;AAqFA,MAAM,oBAAoB,GAA8B,MACtD,EAAE,WAAW,EAAE,UACf,EAAE,OACC,GAAG,MACF,EAAE,OAAO,EAAE,EAAE,CAAC,MACd,EAAE,SAAS,WAAW,EAAE,EAAE,CAAC,SAAS,UACpC,EAAE,SAAS,OAAO,GAAG,OAAA,GAAA,mCAAA,sBAAA,CAA4B,GAAG,EAAE,EAAE,CAAC,SAAS,EAAE,CAAC,CACzE;AAEF,MAAM,kBAA6C,CAAC;;;;;;;;;;AAWpD,SAAgB,aAAa,KAA8C;CACzE,MAAM,WAAWA,gBAAAA,cAAcC,mCAAAA,aAAa;CAC5C,MAAM,aAAaC,gBAAAA,cAAc;CACjC,MAAM,cAAA,GAAA,MAAA,QAAA,OAA4B,OAAA,GAAA,kBAAA,aAAA,CAAmB,GAAG,IAAI,MAAO,CAAC,GAAG,CAAC;CACxE,MAAM,SAASC,gBAAAA,qBAAqB;EAClC,IAAI,CAAC,YAAY,OAAO;EACxB,MAAM,2BAAW,IAAI,IAA6B;EAClD,MAAM,WAAW,OAAe;GAC9B,MAAM,MAAM,SAAS,QAAQ,IAAI,cAAc,KAAA,CAAS;GACxD,IAAI,KAAK,SAAS,IAAI,IAAI,GAAG;GAC7B,OAAO,KAAK,YAAY;EAC1B;EACA,QAAA,GAAA,kBAAA,aAAA,CAAoB,YAAY,OAAO,CAAC,CAAC,KAAK,OAAO;GACnD,IAAI,EAAE;GACN,UAAU,EAAE;GACZ,UAAU,EAAE,SAAS,KAAK,OAAO,SAAS,IAAI,EAAE,CAAE;EACpD,EAAE;CACJ,GAAG,gBAAgB;CACnB,QAAA,GAAA,MAAA,QAAA,OAEI,OAAO,WAAW,IACd,OACA;EAAE;EAAQ,UAAU,OAAe,SAAS,QAAQ,IAAI,cAAc,KAAA,CAAS;CAAE,GACvF;EAAC;EAAQ;EAAU;CAAU,CAC/B;AACF;;AA+CA,SAAS,SAAS,EAChB,GACA,SACA,YAKC;CACD,MAAM,OAAA,GAAA,MAAA,OAAA,CAA8B,IAAI;CACxC,CAAA,GAAA,MAAA,gBAAA,OAAsB;EACpB,MAAM,KAAK,IAAI;EACf,IAAI,CAAC,IAAI;EACT,MAAM,eAAe,QAAQ,GAAG,GAAG,sBAAsB,CAAC,CAAC,KAAK;EAChE,OAAO;EACP,MAAM,WAAW,IAAI,eAAe,MAAM;EAC1C,SAAS,QAAQ,EAAE;EACnB,aAAa,SAAS,WAAW;CACnC,GAAG,CAAC,GAAG,OAAO,CAAC;CACf,OACE,iBAAA,GAAA,kBAAA,IAAA,CAAC,QAAD;EAAW;EAAK,OAAO;GAAE,SAAS;GAAe,YAAY;EAAE;EAC5D;CACG,CAAA;AAEV;;;;;;;;AASA,SAAS,iBAAiB,EACxB,MACA,GACA,SACA,YAMC;CACD,MAAM,OAAA,GAAA,MAAA,OAAA,CAA8B,IAAI;CACxC,CAAA,GAAA,MAAA,gBAAA,OAAsB;EACpB,MAAM,KAAK,IAAI;EACf,IAAI,CAAC,IAAI;EACT,MAAM,eAAe,QAAQ,GAAG,GAAG,sBAAsB,CAAC,CAAC,KAAK;EAChE,OAAO;EAGP,MAAM,WAAW,IAAI,eAAe,MAAM;EAC1C,SAAS,QAAQ,EAAE;EACnB,aAAa,SAAS,WAAW;CACnC,GAAG,CAAC,GAAG,OAAO,CAAC;CACf,OACE,iBAAA,GAAA,kBAAA,IAAA,CAAC,QAAD;EACO;EACC;EACN,OAAO;GAAE,SAAS;GAAe,YAAY;GAAU,YAAY;EAAE;EAEpE;CACG,CAAA;AAEV;AAEA,MAAM,oBAAyC;CAC7C,UAAU;CACV,MAAM;CACN,KAAK;CACL,QAAQ;CACR,UAAU;CACV,YAAY;CACZ,eAAe;CACf,SAAS;CACT,YAAY;AACd;AAIA,MAAM,wBACJ,KACA,SACA,QAEA,iBAAA,GAAA,kBAAA,KAAA,CAAC,UAAD;CACE,MAAK;CACL,SAAS;CACT,UAAU,CAAC,IAAI;CACf,gBAAc,IAAI,UAAU,KAAA;CAC5B,iBAAe,IAAI,OAAO,SAAS,KAAA;CACnC,OAAO,IAAI;CACX,OAAO;EACL,SAAS;EACT,YAAY;EACZ,KAAK;EACL,SAAS;EACT,YAAY;EACZ,YAAY,IAAI,SAAS,qBAAqB;EAC9C,QAAQ;EACR,cAAc;EACd,QAAQ,IAAI,UAAU,YAAY;EAClC,SAAS,IAAI,UAAU,IAAI;CAC7B;CAlBF,UAAA,CAoBG,YAAY,UAAU,IAAI,QAAS,IAAI,QAAQ,IAAI,OACnD,YAAY,eAAe,IAAI,IAAI,UAAU,IACxC;;AAGV,MAAM,+BACJ,iBAAA,GAAA,kBAAA,IAAA,CAAC,QAAD,EAAM,OAAO;CAAE,OAAO;CAAG,WAAW;CAAW,YAAY;CAAgB,SAAS;AAAI,EAAI,CAAA;AAG9F,MAAM,gCAAgC,QAAiB,WACrD,iBAAA,GAAA,kBAAA,IAAA,CAAC,UAAD;CACE,MAAK;CACL,SAAS;CACT,iBAAc;CACd,iBAAe;CACf,OAAM;CACN,OAAO;EACL,SAAS;EACT,YAAY;EACZ,SAAS;EACT,QAAQ;EACR,cAAc;EACd,YAAY,SAAS,qBAAqB;EAC1C,QAAQ;CACV;CACD,UAAA;AAEO,CAAA;AAGV,SAAS,oBAAoB,EAAE,QAAoC;CACjE,IAAI,CAAC,KAAK,QAAQ,OAAO;CACzB,OACE,iBAAA,GAAA,kBAAA,KAAA,CAAA,kBAAA,UAAA,EAAA,UAAA,CACE,iBAAA,GAAA,kBAAA,IAAA,CAAC,OAAD;EAAK,OAAO;GAAE,UAAU;GAAS,OAAO;GAAG,QAAQ;EAAG;EAAG,SAAS,KAAK;CAAQ,CAAA,GAC/E,iBAAA,GAAA,kBAAA,IAAA,CAAC,OAAD;EACE,MAAK;EACL,OAAO;GACL,UAAU;GACV,OAAO;GACP,KAAK;GACL,QAAQ;GACR,UAAU;GACV,SAAS;GACT,YAAY;GACZ,QAAQ;GACR,cAAc;GACd,WAAW;EACb;EAEC,UAAA,KAAK,SAAS,KAAK,SAAS,MAC3B,iBAAA,GAAA,kBAAA,KAAA,CAACC,MAAM,UAAP,EAAA,UAAA,CACG,IAAI,KAAK,iBAAA,GAAA,kBAAA,IAAA,CAAC,OAAD,EAAK,OAAO;GAAE,QAAQ;GAAG,YAAY;GAAmB,QAAQ;EAAQ,EAAI,CAAA,GACrF,QAAQ,KAAK,KAAK,QAAQ;GACzB,MAAM,MAAM,KAAK,QAAQ,IAAI,OAAO;GACpC,IAAI,CAAC,KAAK,OAAO;GACjB,MAAM,YAAY,IAAI,SAAS;GAC/B,OACE,iBAAA,GAAA,kBAAA,KAAA,CAAC,UAAD;IAEE,MAAK;IACL,MAAM,QAAQ,SAAS,UAAU,kBAAkB;IACnD,gBAAc,QAAQ,SAAS,UAAU,IAAI,SAAS,KAAA;IACtD,UAAU,CAAC,IAAI;IACf,eAAe;KACb,KAAK,QAAQ,IAAI,OAAO;KACxB,IAAI,CAAC,WAAW,KAAK,MAAM;IAC7B;IACA,OAAO;KACL,SAAS;KACT,OAAO;KACP,YAAY;KACZ,gBAAgB;KAChB,KAAK;KACL,SAAS;KACT,QAAQ;KACR,YAAY;KACZ,QAAQ,IAAI,UAAU,YAAY;KAClC,SAAS,IAAI,UAAU,IAAI;KAC3B,YAAY;IACd;IAtBF,UAAA,CAwBE,iBAAA,GAAA,kBAAA,KAAA,CAAC,QAAD,EAAA,UAAA,CACG,IAAI,UAAU,QAAQ,SAAS,UAAU,OAAO,IAChD,IAAI,KACD,EAAA,CAAA,GACL,YAAY,iBAAA,GAAA,kBAAA,IAAA,CAAC,QAAD,EAAA,UAAM,IAAO,CAAA,IAAI,IACxB;GA5BD,GAAA,IAAI,OA4BH;EAEZ,CAAC,CACa,EAAA,GAvCK,CAuCL,CACjB;CACE,CAAA,CACL,EAAA,CAAA;AAEN;AAEA,SAAS,iBAAiB,EAAE,QAAsC;CAChE,IAAI,KAAK,aAAa,UAEpB,OACE,iBAAA,GAAA,kBAAA,IAAA,CAAC,UAAD;EACE,OAHW,KAAK,SAAS,MAAM,MAAM,EAAE,MAG3B,CAAC,EAAE,MAAM;EACrB,WAAW,MAAM,KAAK,QAAQ,EAAE,OAAO,KAAK;EAC5C,OAAO;GAAE,SAAS;GAAW,cAAc;EAAE;EAE5C,UAAA,KAAK,SAAS,KAAK,MAClB,iBAAA,GAAA,kBAAA,IAAA,CAAC,UAAD;GAAmB,OAAO,EAAE;GAAI,UAAU,CAAC,EAAE;GAC1C,UAAA,EAAE;EACG,GAFK,EAAE,EAEP,CACT;CACK,CAAA;CAIZ,OAAO,iBAAA,GAAA,kBAAA,IAAA,CAAC,qBAAD,EAA2B,KAAO,CAAA;AAC3C;AAEA,SAAS,oBAAoB,EAAE,QAAsC;CACnE,MAAM,CAAC,QAAQ,YAAA,GAAA,MAAA,SAAA,CAAoB,KAAK;CACxC,MAAM,WAA8B,CAClC;EACE,UAAU,KAAK;EACf,MAAM,KAAK,SAAS,SAAS,UAAU,KAAA;EACvC,MAAM,KAAK,SAAS,KAAK,OAAO;GAAE,MAAM;GAAoB,SAAS,EAAE;EAAG,EAAE;CAC9E,CACF;CACA,OACE,iBAAA,GAAA,kBAAA,KAAA,CAAC,QAAD;EAAM,OAAO;GAAE,UAAU;GAAY,SAAS;EAAc;EAA5D,UAAA,CACG,6BAA6B,cAAc,SAAS,MAAM,CAAC,CAAC,CAAC,GAC9D,iBAAA,GAAA,kBAAA,IAAA,CAAC,qBAAD,EACE,MAAM;GACJ;GACA;GACA,aAAa,QAAQ,KAAK;GAC1B,UAAU,OAAO,KAAK,SAAS,MAAM,MAAM,EAAE,OAAO,EAAE,KAAK;GAC3D,SAAS,KAAK;EAChB,EACD,CAAA,CACG;;AAEV;;;AAIA,SAAS,oBAAoB,EAAE,QAAuC;CACpE,MAAM,CAAC,QAAQ,YAAA,GAAA,MAAA,SAAA,CAAoB,KAAK;CACxC,MAAM,aAAa,KAAK,SAAS,MAAM,MAAM,EAAE,MAAM;CACrD,MAAM,WAA8B,CAClC;EACE,UAAU,KAAK;EACf,MAAM,KAAK,SAAS,SAAS,UAAU,KAAA;EACvC,MAAM,KAAK,SAAS,KAAK,OAAO;GAAE,MAAM;GAAoB,SAAS,EAAE;EAAG,EAAE;CAC9E,CACF;CACA,OACE,iBAAA,GAAA,kBAAA,KAAA,CAAC,QAAD;EAAM,OAAO;GAAE,UAAU;GAAY,SAAS;EAAc;EAA5D,UAAA,CACE,iBAAA,GAAA,kBAAA,IAAA,CAAC,UAAD;GACE,MAAK;GACL,eAAe,SAAS,MAAM,CAAC,CAAC;GAChC,iBAAc;GACd,iBAAe;GACf,OAAM;GACN,OAAO;IACL,SAAS;IACT,YAAY;IACZ,SAAS;IACT,QAAQ;IACR,cAAc;IAEd,YAAY,UAAU,aAAa,qBAAqB;IACxD,QAAQ;GACV;GACD,UAAA;EAEO,CAAA,GACR,iBAAA,GAAA,kBAAA,IAAA,CAAC,qBAAD,EACE,MAAM;GACJ;GACA;GACA,aAAa,QAAQ,KAAK;GAC1B,UAAU,OAAO,KAAK,SAAS,MAAM,MAAM,EAAE,OAAO,EAAE,KAAK;GAC3D,SAAS,KAAK;EAChB,EACD,CAAA,CACG;;AAEV;AAIA,MAAM,WAAW,GAAmB,YAAoB,KAAK,EAAE,IAAI,GAAG;AACtE,MAAM,YAAY,OAAe,KAAK;AACtC,MAAM,mBAAmB,OAAe,MAAM;AAC9C,MAAM,cAAc;AAEpB,SAAgB,QAAQ,EACtB,KACA,MAAM,GACN,iBAAiB,GACjB,WACA,OACA,gBAAgB,sBAChB,cACA,iBACA,oBACA,kBAAkB,wBAClB,wBAAwB,8BACxB,sBACe;CACf,MAAM,SAASC,gBAAAA,UAAU;CACzB,MAAM,WAAWL,gBAAAA,cAAcC,mCAAAA,aAAa;CAC5C,MAAM,aAAaC,gBAAAA,cAAc;CAMjC,MAAM,GAAG,UAAA,GAAA,MAAA,WAAA,EAAqB,MAAc,IAAI,GAAG,CAAC;CACpD,CAAA,GAAA,MAAA,UAAA,OAAgB,OAAO,UAAU,KAAK,GAAG,CAAC,MAAM,CAAC;CAEjD,MAAM,gBAAA,GAAA,MAAA,OAAA,CAAsC,IAAI;CAChD,MAAM,CAAC,gBAAgB,sBAAA,GAAA,MAAA,SAAA,CAA8B,CAAC;CACtD,CAAA,GAAA,MAAA,gBAAA,OAAsB;EACpB,MAAM,KAAK,aAAa;EACxB,IAAI,CAAC,IAAI;EACT,MAAM,WAAW,IAAI,gBAAgB,YAAY;GAC/C,MAAM,IAAI,QAAQ,QAAQ,SAAS,EAAE,EAAE,YAAY;GACnD,IAAI,MAAM,KAAA,GAAW,mBAAmB,SAAU,KAAK,IAAI,OAAO,CAAC,IAAI,KAAM,IAAI,IAAK;EACxF,CAAC;EACD,SAAS,QAAQ,EAAE;EACnB,kBAAkB,GAAG,WAAW;EAChC,aAAa,SAAS,WAAW;CACnC,GAAG,CAAC,CAAC;CAEL,MAAM,aAAA,GAAA,MAAA,OAAA,iBAAmB,IAAI,IAAoB,CAAC;CAClD,MAAM,GAAG,uBAAA,GAAA,MAAA,WAAA,EAAkC,MAAc,IAAI,GAAG,CAAC;CACjE,MAAM,WAAA,GAAA,MAAA,QAAA,QACG,KAAa,UAAkB;EACpC,MAAM,OAAO,UAAU,QAAQ,IAAI,GAAG;EACtC,IAAI,SAAS,KAAA,KAAa,KAAK,IAAI,OAAO,KAAK,KAAK,IAAK;EACzD,UAAU,QAAQ,IAAI,KAAK,KAAK;EAChC,mBAAmB;CACrB,GACA,CAAC,CACH;CAEA,MAAM,cAAc,OAClB,SAAS,QAAQ,IAAI,cAAc,KAAA,CAAS;CAC9C,MAAM,cAAc,OAAe,SAAS,QAAQ,IAAI,cAAc,KAAA,CAAS;CAC/E,MAAM,aAAa,MAAuB,EAAE,SAAS,YAAY,EAAE,UAAU,EAAE;CAS/E,MAAM,cAAA,GAAA,kBAAA,UAAA,EAAA,GAAA,MAAA,QAAA,QAAA,GAAA,kBAAA,aAAA,CALwC,GAAG,GAAG,CAAC,GAAG,CAKlB,IAAI,MAAM,WAAW,UAAU,CAAC,CAAC,CAAC,EAAE,YAAY,IAAI;CAU1F,MAAM,OAAA,GAAA,kBAAA,MAAA,CAAY,YAAY;EAR5B,OAAO,KAAK,YAAY,UAAU,QAAQ,IAAI,KAAK,IAAI,GAAG,SAAS;EACnE,iBAAiB,OAAO,UAAU,QAAQ,IAAI,SAAS,EAAE,CAAC;EAC1D,eAAe,OAAO,UAAU,QAAQ,IAAI,gBAAgB,EAAE,CAAC;EAC/D,iBAAiB,UAAU,QAAQ,IAAI,WAAW,KAAK;EACvD;EAEA,WAAW,iBAAiB;CAEM,GAAG,cAAc;CACrD,MAAM,oBAAA,GAAA,kBAAA,gBAAA,CAAmC,YAAY,MAAM,OAAO,SAAS,WAAW,EAAE,CAAC;CAEzF,MAAM,CAAC,cAAc,oBAAA,GAAA,MAAA,SAAA,CAA4B,KAAK;CACtD,CAAA,GAAA,MAAA,UAAA,OAAgB;EACd,IAAI,CAAC,IAAI,aAAa,gBAAgB,KAAK;CAC7C,GAAG,CAAC,IAAI,WAAW,CAAC;;;;CAKpB,MAAM,kBAAkB,MACtB,EAAE,SAAS,YAAY,CAAC,eAAe,EAAE;CAG3C,MAAM,gBACJ,GACA,SACA,UACoB;EACpB,IAAI,EAAE,SAAS,UAAU;GACvB,MAAM,aAAa,eAAe,EAAE;GACpC,IAAI,YAAY;IACd,MAAM,SAAS,WAAW,SAAS;KACjC;KACA,UAAU,UAAU,QAAQ,QAAQ,GAAG,OAAO,GAAG,KAAK;IACxD,CAAC;IACD,IAAI,WAAW,KAAA,GAAW,OAAO;GACnC,OAAO,IAAI,UAAU,QAAQ;IAC3B,MAAM,MAAM,WAAW,EAAE,QAAQ;IACjC,OACE,iBAAA,GAAA,kBAAA,IAAA,CAAC,kBAAD;KAAkB,MAAM,EAAE;KAAM,GAAG,QAAQ,GAAG,OAAO;KAAY;KAC9D,UAAA,MAAM,cAAc,KAAK,cAAc,WAAW,EAAE,QAAQ,CAAC,IAAI;IAClD,CAAA;GAEtB,OACE,OAAO;GAET,MAAM,MAAM,WAAW,EAAE,QAAQ;GACjC,OAAO,MAAM,cAAc,KAAK,cAAc,WAAW,EAAE,QAAQ,CAAC,IAAI;EAC1E;EACA,MAAM,MAAM,WAAW,EAAE,OAAO;EAChC,IAAI,CAAC,KACH,OAAO,cACL;GACE,IAAI,EAAE;GACN,OAAO,EAAE;GACT,WAAW,CAAC;GACZ,SAAS;GACT,QAAQ;GACR,SAAS;GACT,YAAY,CAAC;EACf,GACA,eACM,CAAC,CACT;EACF,OAAO,cAAc,KAAK,eAAe,WAAW,EAAE,OAAO,CAAC;CAChE;CAEA,MAAM,iBAAiB,OAA4C;EACjE,IAAI,EAAE;EACN,UAAU,EAAE;EACZ,UAAU,EAAE,YAAY;EACxB,MAAM,EAAE;EACR,UAAU,EAAE,MACT,KAAK,MAAM,WAAW,UAAU,CAAC,CAAC,CAAC,CAAC,CACpC,QAAQ,MAA4B,MAAM,QAAQ,EAAE,OAAO;EAC9D,SAAS;CACX;CAEA,MAAM,wBAAwB,MAC5B,kBACE,gBAAgB,cAAc,CAAC,CAAC,IAEhC,iBAAA,GAAA,kBAAA,IAAA,CAAC,kBAAD,EAAkB,MAAM,cAAc,CAAC,EAAI,CAAA;;;CAK/C,MAAM,kBAAkB,GAAoB,iBAA+C;EACzF,IAAI,EAAE;EACN,UAAU,EAAE;EACZ,MAAM,EAAE;EACR,UAAU,EAAE,MACT,QAAQ,MAAM,eAAe,IAAI,MAAM,IAAI,EAAE,GAAG,CAAC,EAAE,SAAS,MAAM,CAAC,CACnE,KAAK,MAAM,WAAW,UAAU,CAAC,CAAC,CAAC,CAAC,CACpC,QAAQ,MAA4B,MAAM,QAAQ,EAAE,OAAO;EAC9D,SAAS;CACX;CAEA,MAAM,oBAAoB,GAAoB,gBAC5C,qBACE,mBAAmB,eAAe,GAAG,WAAW,CAAC,IAEjD,iBAAA,GAAA,kBAAA,IAAA,CAAC,qBAAD,EAAqB,MAAM,eAAe,GAAG,WAAW,EAAI,CAAA;CAGhE,MAAM,mBAAmB,MAA0C;EACjE,MAAM,aAAa,IAAI,OAAO,IAAI,EAAE,EAAE;EACtC,IAAI,CAAC,cAAc,WAAW,YAAY,OAAO,CAAC;EAClD,IAAI,WAAW,WACb,OAAO,CAAC,iBAAA,GAAA,kBAAA,IAAA,CAACE,MAAM,UAAP,EAAA,UAA4B,qBAAqB,CAAC,EAAkB,GAA/C,EAAE,EAA6C,CAAC;EAC/E,MAAM,QAA2B,CAAC;EAClC,KAAK,MAAM,KAAK,EAAE,OAAO;GACvB,MAAM,IAAI,IAAI,MAAM,IAAI,EAAE,GAAG;GAC7B,IAAI,GAAG,SAAS,WAAW;GAC3B,MAAM,KAAK,iBAAA,GAAA,kBAAA,IAAA,CAACA,MAAM,UAAP,EAAA,UAA6B,aAAa,GAAG,EAAE,SAAS,MAAM,EAAkB,GAA3D,EAAE,GAAyD,CAAC;EAC9F;EAEA,IAAI,WAAW,YAAY,GACzB,MAAM,KACJ,iBAAA,GAAA,kBAAA,IAAA,CAACA,MAAM,UAAP,EAAA,UAA0C,iBAAiB,GAAG,KAAK,EAAkB,GAAhE,GAAG,EAAE,GAAG,UAAwD,CACvF;EAEF,OAAO,MAAM,SAAS,CAAC,iBAAA,GAAA,kBAAA,IAAA,CAACA,MAAM,UAAP,EAAA,UAA4B,MAAsB,GAA7B,EAAE,EAA2B,CAAC,IAAI,CAAC;CACjF;CAEA,MAAM,qBAAqB,YAA4D;EACrF,IAAI,CAAC,SAAS,OAAO;EAIrB,OAHiB,QAAQ,OACtB,KAAK,OAAO;GAAE,IAAI,EAAE;GAAI,OAAO,gBAAgB,CAAC;EAAE,EAAE,CAAC,CACrD,QAAQ,MAAM,EAAE,MAAM,SAAS,CACpB,CAAC,CAAC,KAAK,GAAG,MACtB,iBAAA,GAAA,kBAAA,KAAA,CAACA,MAAM,UAAP,EAAA,UAAA,CACG,IAAI,KAAK,gBAAgB,GACzB,EAAE,KACW,EAAA,GAHK,EAAE,EAGP,CACjB;CACH;CAEA,MAAM,iBAAiB,SACrB,WAAW,SAAS,MAAM,MAAM,EAAE,SAAS,IAAI;;;;;;;;;;;;CAajD,MAAM,gBAAgB,cAA+D;EACnF,SAAS;EACT,YAAY;EACZ;EACA,MAAM;EACN,GAAI,aAAa,WAAW;GAAE,YAAY;GAAQ,aAAa;EAAO,IAAI;CAC5E;CAEA,MAAM,eAAiC;EACrC,UAAU;EACV,QAAQ;EACR,aAAa,gBAAgB,KAAK;EAClC,SAAS;EACT,SAAS;CACX;CAEA,OACE,iBAAA,GAAA,kBAAA,KAAA,CAAC,OAAD;EACE,KAAK;EACM;EACX,OAAO;GAAE,UAAU;GAAY,SAAS;GAAQ,YAAY;GAAU,GAAG;EAAM;EAHjF,UAAA;GAKE,iBAAA,GAAA,kBAAA,IAAA,CAAC,OAAD;IAAK,OAAO,aAAa,OAAO;IAAI,UAAA,kBAAkB,cAAc,OAAO,CAAC;GAAO,CAAA;GACnF,iBAAA,GAAA,kBAAA,IAAA,CAAC,OAAD;IAAK,OAAO,aAAa,QAAQ;IAAI,UAAA,kBAAkB,cAAc,QAAQ,CAAC;GAAO,CAAA;GACrF,iBAAA,GAAA,kBAAA,KAAA,CAAC,OAAD;IAAK,OAAO,aAAa,KAAK;IAA9B,UAAA,CACG,kBAAkB,cAAc,KAAK,CAAC,GACtC,IAAI,eACH,iBAAA,GAAA,kBAAA,KAAA,CAAC,QAAD;KAAM,OAAO;MAAE,UAAU;MAAY,SAAS;KAAc;KAA5D,UAAA,CACG,sBAAsB,oBAAoB,iBAAiB,MAAM,CAAC,CAAC,CAAC,GACpE,qBACC,mBAAmB,YAAY,IAE/B,iBAAA,GAAA,kBAAA,IAAA,CAAC,qBAAD,EAAqB,MAAM,aAAe,CAAA,CAExC;IAEL,CAAA,CAAA;;GAKL,iBAAA,GAAA,kBAAA,KAAA,CAAC,OAAD;IAAK,eAAA;IAAY,OAAO;IAAxB,UAAA,CACG,WAAW,SAAS,SAAS,MAC5B,EAAE,OAAO,SAAS,MAAM;KAGtB,GAAG,EAAE,MACF,QAAQ,MAAM,CAAC,eAAe,CAAC,CAAC,CAAC,CACjC,SAAS,MACR,EAAE,SAAS,KAAK,YACd,iBAAA,GAAA,kBAAA,IAAA,CAAC,UAAD;MAAoC,GAAG,QAAQ,GAAG,OAAO;MAAY;MAClE,UAAA,aAAa,GAAG,SAAS,SAAS;KAC3B,GAFK,QAAQ,GAAG,OAAO,CAEvB,CACX,CACH;KACF,GAAI,EAAE,WACF,CACE,iBAAA,GAAA,kBAAA,IAAA,CAAC,UAAD;MAA+B,GAAG,SAAS,EAAE,EAAE;MAAY;MACxD,UAAA,qBAAqB,CAAC;KACf,GAFK,SAAS,EAAE,EAAE,CAElB,CACZ,IACA,CAAC;KACL,GAAI,EAAE,OACF,CACE,iBAAA,GAAA,kBAAA,IAAA,CAAC,UAAD;MAAsC,GAAG,gBAAgB,EAAE,EAAE;MAAY;MACtE,UAAA,iBAAiB,GAAG,IAAI;KACjB,GAFK,gBAAgB,EAAE,EAAE,CAEzB,CACZ,IACA,CAAC;IACP,CAAC,CACH,GACA,iBAAA,GAAA,kBAAA,IAAA,CAAC,UAAD;KAAU,GAAG;KAAsB;KAChC,UAAA,sBAAsB,aAAa,CAAC,CAAC;IAC9B,CAAA,CACP;;EACF;;AAET"}
+{"version":3,"file":"toolbar.cjs","names":["resolvedCommandsEqual","useCapability","CommandsToken","useDocumentId","useKernelValue","TOOLBAR_ITEM_ATTRIBUTE","React","useKernel","createToolbarLengths","unregisteredCommand","toolbarMeasureKey","INERT"],"sources":["../src/toolbar.tsx"],"sourcesContent":["/**\n * The headless <Toolbar>: it measures what fits and makes room, and you draw\n * every part.\n *\n *   1. a hidden measurement layer renders every unit in every variant (plus\n *      folded groups and the \"More\" button), each watched by\n *      `@embedpdf/web`'s `observeLength` along the toolbar (widths, or\n *      heights when it is vertical), so a new language, a font loading,\n *      browser zoom and your CSS all re-measure on their own; the lengths\n *      become fit metrics (`createToolbarLengths`);\n *   2. core-ui's `solve()` gives each unit a variant, a folded group or the\n *      \"More\" menu, and `layoutToolbar` turns that fit into the parts to\n *      draw: pure and tested on their own;\n *   3. the live row renders that; the \"More\" menu is derived (`projectOverflow`)\n *      from what didn't fit, never written by hand.\n *\n * The toolbar is one tab stop with arrow keys along it (`attachToolbarFocus`),\n * and its default menus take the menu keys (`attachMenuKeys`). Every part is a\n * render prop with a plain default: the app owns the pixels, this component\n * owns the fitting and the keyboard. The defaults' colors come from the\n * `--epdf-toolbar-*` CSS variables only.\n */\n\n// The toolbar's vocabulary: the schema a bar is written in.\nexport { DEFAULT_IMPORTANCE, PINNED, custom, group, item } from '@embedpdf/core-ui';\nexport type {\n  BarChild,\n  BarGroup,\n  BarItem,\n  BarSchema,\n  BarSections,\n  CustomItem,\n  Importance,\n  OverflowRow,\n  OverflowSection,\n  Variant,\n} from '@embedpdf/core-ui';\nimport * as React from 'react';\nimport { useEffect, useLayoutEffect, useMemo, useReducer, useRef, useState } from 'react';\nimport {\n  groupMenuView,\n  layoutToolbar,\n  normalizeBar,\n  sameStripGroups,\n  stripGroupsOf,\n} from '@embedpdf/core-ui';\nimport type {\n  BarSchema,\n  CollapsedGroupView as CollapsedGroupViewOf,\n  CustomSlotCtx,\n  GroupDisclosureView as GroupDisclosureViewOf,\n  LiveSection,\n  OverflowMenuView as OverflowMenuViewOf,\n  StripView as StripViewOf,\n  StripViewGroup as StripViewGroupOf,\n  ToolbarPart,\n} from '@embedpdf/core-ui';\nimport { resolvedCommandsEqual, unregisteredCommand } from '@embedpdf/plugin-commands/contract';\n// The \"More\" menu asks which menu a command opens, a host fact, so the host lens is bound here.\nimport { CommandsToken } from '@embedpdf/plugin-commands/contract/host';\nimport type { ResolvedCommand } from '@embedpdf/plugin-commands/contract';\nimport {\n  TOOLBAR_ITEM_ATTRIBUTE,\n  attachMenuKeys,\n  attachToolbarFocus,\n  createToolbarLengths,\n  focusablesIn,\n  observeContentLength,\n  observeLength,\n  observeOutsidePress,\n  paintDefault,\n  toolbarMeasureKey,\n} from '@embedpdf/web';\nimport type { Orientation, RovingFocus } from '@embedpdf/web';\nimport { INERT } from './inert';\nimport { useCapability, useDocumentId, useKernel, useKernelValue } from './runtime';\n\n// ── public render-prop contracts ─────────────────────────────────────────────\n\n/** A group folded into one control: its commands, resolved live, and how to run one. */\nexport type CollapsedGroupView = CollapsedGroupViewOf<ResolvedCommand>;\n\n/** The \"More\" menu: what didn't fit, in sections, and the calls a menu needs. */\nexport type OverflowMenuView = OverflowMenuViewOf<ResolvedCommand>;\n\n/**\n * A shed group's disclosure — the derived trigger rendered inside the group.\n * `commands` is what sits behind the trigger: the shed children in bar order,\n * resolved live. In the measurement layer the trigger is measured with the\n * full group as content, so a count-dependent trigger (e.g. a \"+3\" badge) is\n * budgeted at its widest form.\n */\nexport type GroupDisclosureView = GroupDisclosureViewOf<ResolvedCommand>;\n\n/** Passed to custom-slot renderers alongside the variant. */\nexport type { CustomSlotCtx };\n\n// ── the strip view — a bar projected through the registry, live ──────────────\n\n/** A group of a strip: its visible commands, bar order. Groups are separator boundaries. */\nexport type StripViewGroup = StripViewGroupOf<ResolvedCommand>;\n\n/** A contextual strip, resolved: only visible commands, only non-empty groups. */\nexport type StripView = StripViewOf<ResolvedCommand>;\n\nconst stripGroupsEqual = (\n  left: readonly StripViewGroup[],\n  right: readonly StripViewGroup[],\n): boolean => sameStripGroups(left, right, resolvedCommandsEqual);\n\nconst NO_STRIP_GROUPS: readonly StripViewGroup[] = [];\n\n/**\n * The live projection of a bar through the command registry — <Toolbar>'s\n * un-measured sibling, for contextual strips (a bar over a selection). The schema\n * declares what could appear; each command's `visible` derivation decides what\n * does; null means nothing currently applies, so `if (!view) return null` is\n * the caller's entire show/hide logic. `execute` is pre-bound to this\n * subtree's document. Reads are value-equal (resolvedCommandsEqual), so\n * consumers re-render on real change, not on every store action.\n */\nexport function useStripView(bar: BarSchema | undefined): StripView | null {\n  const commands = useCapability(CommandsToken);\n  const documentId = useDocumentId();\n  const normalized = useMemo(() => (bar ? normalizeBar(bar) : null), [bar]);\n  const groups = useKernelValue(\n    () =>\n      normalized\n        ? stripGroupsOf(normalized, (id) => commands.resolveCommand(id, documentId ?? undefined))\n        : NO_STRIP_GROUPS,\n    stripGroupsEqual,\n  );\n  return useMemo(\n    () =>\n      groups.length === 0\n        ? null\n        : {\n            groups,\n            execute: (id: string) =>\n              void commands.execute(id, { documentId: documentId ?? undefined }),\n          },\n    [groups, commands, documentId],\n  );\n}\n\nexport interface ToolbarProps {\n  bar: BarSchema;\n  /**\n   * Which way the toolbar runs. A vertical toolbar fits the height it's given,\n   * so give it one; it stacks its sections top, middle and bottom, and draws\n   * every command at `'icon'`, with the label for a tooltip. Default\n   * `'horizontal'`.\n   */\n  orientation?: 'horizontal' | 'vertical';\n  /** Px between adjacent items (CSS flex gap; the solver budgets the same number). */\n  gap?: number;\n  /**\n   * The thickness of the separator your renderSeparator draws: its width\n   * across a horizontal toolbar, its height in a vertical one. Default 1.\n   */\n  separatorWidth?: number;\n  /** The toolbar's name for screen readers, for a page with more than one toolbar. */\n  'aria-label'?: string;\n  className?: string;\n  style?: React.CSSProperties;\n  /** A command button at a given variant. Default: a plain <button> with the command's label. */\n  renderCommand?: (cmd: ResolvedCommand, variant: string, run: () => void) => React.ReactNode;\n  /**\n   * Your own items, one renderer per name (from `custom(name, command)`),\n   * called with the variant the fit chose. A renderer that returns\n   * `undefined` draws the item's command instead (`renderCommand` with the\n   * terminal command, variant `'icon'`). An item with no entry here renders\n   * as a native `<slot name={slot}>` socket with that command as fallback\n   * content: in light DOM that displays the fallback; inside a shadow root\n   * the host's light-DOM children project into it — the children-as-slots\n   * contract. Sockets are measured live (they can't be duplicated into the\n   * measurement layer: only the first same-named slot in tree order gets the\n   * projected nodes). A renderer that draws nothing (`null`) in the\n   * measurement layer (`ctx.layer === 'measure'`) is measured where it\n   * renders instead: report its length with `ctx.measure`, a new function on\n   * every render (capture it in a ref to use it in an effect). The first\n   * element of an item that takes focus is the item's stop in the toolbar's\n   * arrow-key order.\n   */\n  renderCustom?: Record<string, (variant: string, ctx: CustomSlotCtx) => React.ReactNode>;\n  /**\n   * A group in its collapsed form. Default: <select> for 'select', menu button for 'menu'; a\n   * renderer that returns `undefined` leaves the group to the default.\n   */\n  renderCollapsed?: (view: CollapsedGroupView) => React.ReactNode;\n  /** A shed group's disclosure trigger (+ its popover — the renderer owns the\n   *  open state). Default: a chevron button opening a radio menu; `undefined`\n   *  leaves it to the default too. */\n  renderGroupTrigger?: (view: GroupDisclosureView) => React.ReactNode;\n  /** Derived separator between adjacent visible groups. Default: a 1px line across the toolbar. */\n  renderSeparator?: () => React.ReactNode;\n  /** The \"More\" button. Default: a plain ⋯ button. */\n  renderOverflowTrigger?: (isOpen: boolean, toggle: () => void) => React.ReactNode;\n  /** The derived overflow menu. Default: a minimal popover. */\n  renderOverflowMenu?: (view: OverflowMenuView) => React.ReactNode;\n}\n\n// ── measurement ───────────────────────────────────────────────────────────────\n\n/** Report this node's border-box length along the toolbar under `k`, live. */\nfunction Measured({\n  k,\n  orientation,\n  onLength,\n  children,\n}: {\n  k: string;\n  orientation: Orientation;\n  onLength: (key: string, length: number) => void;\n  children: React.ReactNode;\n}) {\n  const ref = useRef<HTMLSpanElement>(null);\n  useLayoutEffect(\n    () =>\n      ref.current\n        ? observeLength(ref.current, orientation, (length) => onLength(k, length))\n        : undefined,\n    [k, orientation, onLength],\n  );\n  return (\n    <span ref={ref} style={{ display: 'inline-flex', flexShrink: 0 }}>\n      {children}\n    </span>\n  );\n}\n\n/**\n * The socket for an unregistered custom unit: a real `<slot>` element. Inside\n * the <embedpdf-viewer> shadow root the browser projects same-named light-DOM\n * children into it; anywhere else it just displays its fallback (the terminal\n * command). Measured live — the projected content lives in the host's world,\n * so its length can only be observed where it actually renders.\n */\nfunction NativeSlotSocket({\n  name,\n  k,\n  orientation,\n  onLength,\n  children,\n}: {\n  name: string;\n  k: string;\n  orientation: Orientation;\n  onLength: (key: string, length: number) => void;\n  children: React.ReactNode;\n}) {\n  const ref = useRef<HTMLSlotElement>(null);\n  // Projection changes (a child slotted in/out) resize the socket's\n  // inline-flex box, so one observer covers both content and assignment.\n  useLayoutEffect(\n    () =>\n      ref.current\n        ? observeLength(ref.current, orientation, (length) => onLength(k, length))\n        : undefined,\n    [k, orientation, onLength],\n  );\n  return (\n    <slot\n      ref={ref}\n      name={name}\n      style={{ display: 'inline-flex', alignItems: 'center', flexShrink: 0 }}\n    >\n      {children}\n    </slot>\n  );\n}\n\n/**\n * The hidden measurement layer: a row for a horizontal toolbar, a column for a\n * vertical one, and no height either way, so it never adds to the page. A\n * column keeps each item at its own width, so no text wraps and changes the\n * heights it reports.\n */\nconst measureLayerStyle = (orientation: Orientation): React.CSSProperties => ({\n  position: 'absolute',\n  left: 0,\n  top: 0,\n  height: 0,\n  overflow: 'hidden',\n  visibility: 'hidden',\n  pointerEvents: 'none',\n  display: 'flex',\n  whiteSpace: 'nowrap',\n  ...(orientation === 'vertical' ? { flexDirection: 'column', alignItems: 'flex-start' } : null),\n});\n\n/** Marks the element around each item of the live row: its first focusable element is a stop. */\nconst TOOLBAR_ITEM = { [TOOLBAR_ITEM_ATTRIBUTE]: '' } as Record<string, string>;\n\n/** The element around an item adds no box, so the item lays out as the section's own child. */\nconst ITEM_STYLE: React.CSSProperties = { display: 'contents' };\n\n// ── defaults: plain, and meant to be replaced ────────────────────────────────\n\nconst SURFACE = paintDefault('toolbar-surface');\nconst BORDER = paintDefault('toolbar-border');\nconst ACTIVE = paintDefault('toolbar-active');\n\nconst defaultRenderCommand = (\n  cmd: ResolvedCommand,\n  _variant: string,\n  run: () => void,\n): React.ReactNode => (\n  <button\n    type=\"button\"\n    onClick={run}\n    disabled={!cmd.enabled}\n    aria-pressed={cmd.active || undefined}\n    aria-haspopup={cmd.menu ? 'menu' : undefined}\n    title={cmd.label}\n    style={{\n      display: 'inline-flex',\n      alignItems: 'center',\n      gap: 4,\n      padding: '4px 8px',\n      whiteSpace: 'nowrap',\n      color: 'inherit',\n      font: 'inherit',\n      background: cmd.active ? ACTIVE : 'transparent',\n      border: `1px solid ${BORDER}`,\n      borderRadius: 4,\n      cursor: cmd.enabled ? 'pointer' : 'default',\n      opacity: cmd.enabled ? 1 : 0.4,\n    }}\n  >\n    {/* Icons are the app's: the plain button shows the label in every variant. */}\n    {cmd.label}\n  </button>\n);\n\n/** A 1px line across the toolbar: upright in a horizontal one, flat in a vertical one. */\nfunction DefaultSeparator({ orientation }: { orientation: Orientation }) {\n  const thickness = orientation === 'vertical' ? { height: 1 } : { width: 1 };\n  return (\n    <span\n      style={{ ...thickness, alignSelf: 'stretch', background: 'currentColor', opacity: 0.2 }}\n    />\n  );\n}\n\nconst defaultRenderOverflowTrigger = (isOpen: boolean, toggle: () => void): React.ReactNode => (\n  <button\n    type=\"button\"\n    onClick={toggle}\n    aria-haspopup=\"menu\"\n    aria-expanded={isOpen}\n    title=\"More\"\n    style={{\n      display: 'inline-flex',\n      alignItems: 'center',\n      padding: '4px 8px',\n      color: 'inherit',\n      font: 'inherit',\n      border: `1px solid ${BORDER}`,\n      borderRadius: 4,\n      background: isOpen ? ACTIVE : 'transparent',\n      cursor: 'pointer',\n    }}\n  >\n    ⋯\n  </button>\n);\n\n/** Where a default menu opens: under a horizontal toolbar's button, beside a vertical one's. */\nconst menuPlacement = (orientation: Orientation): React.CSSProperties =>\n  orientation === 'vertical'\n    ? { top: 0, insetInlineStart: '100%' }\n    : { top: '100%', insetInlineEnd: 0 };\n\n/**\n * The default menu, opened by the button beside it in the same parent: it\n * closes on a press outside that parent, and takes the menu keys while open.\n */\nfunction DefaultOverflowMenu({\n  view,\n  orientation,\n}: {\n  view: OverflowMenuView;\n  orientation: Orientation;\n}) {\n  const menu = useRef<HTMLDivElement>(null);\n  const close = useRef(view.close);\n  close.current = view.close;\n  useLayoutEffect(() => {\n    const element = menu.current;\n    if (!view.isOpen || !element) return;\n    // The menu's parent holds its button too: a press on it is the button's own toggle.\n    const container = element.parentElement ?? element;\n    const trigger =\n      focusablesIn(container).find((candidate) => !element.contains(candidate)) ?? null;\n    const stopOutside = observeOutsidePress(container, () => close.current());\n    const detachKeys = attachMenuKeys(element, { trigger, close: () => close.current() });\n    return () => {\n      stopOutside();\n      detachKeys();\n    };\n  }, [view.isOpen]);\n  if (!view.isOpen) return null;\n  return (\n    <div\n      ref={menu}\n      role=\"menu\"\n      style={{\n        position: 'absolute',\n        ...menuPlacement(orientation),\n        zIndex: 41,\n        minWidth: 200,\n        padding: 4,\n        background: SURFACE,\n        border: `1px solid ${BORDER}`,\n        borderRadius: 6,\n        boxShadow: '0 4px 16px rgba(0,0,0,0.15)',\n      }}\n    >\n      {view.sections.map((section, i) => (\n        <React.Fragment key={i}>\n          {i > 0 && <div style={{ height: 1, background: BORDER, margin: '4px 0' }} />}\n          {section.rows.map((row) => {\n            const cmd = view.resolve(row.command);\n            if (!cmd) return null;\n            const isSubmenu = row.type === 'submenu';\n            return (\n              <button\n                key={row.command}\n                type=\"button\"\n                role={section.role === 'radio' ? 'menuitemradio' : 'menuitem'}\n                aria-checked={section.role === 'radio' ? cmd.active : undefined}\n                disabled={!cmd.enabled}\n                tabIndex={-1}\n                onClick={() => {\n                  view.execute(row.command);\n                  if (!isSubmenu) view.close();\n                }}\n                style={{\n                  display: 'flex',\n                  width: '100%',\n                  alignItems: 'center',\n                  justifyContent: 'space-between',\n                  gap: 16,\n                  padding: '6px 8px',\n                  border: 'none',\n                  color: 'inherit',\n                  font: 'inherit',\n                  background: 'transparent',\n                  cursor: cmd.enabled ? 'pointer' : 'default',\n                  opacity: cmd.enabled ? 1 : 0.4,\n                  whiteSpace: 'nowrap',\n                }}\n              >\n                <span>\n                  {cmd.active && section.role === 'radio' ? '• ' : ''}\n                  {cmd.label}\n                </span>\n                {isSubmenu ? <span>▸</span> : null}\n              </button>\n            );\n          })}\n        </React.Fragment>\n      ))}\n    </div>\n  );\n}\n\nfunction DefaultCollapsed({\n  view,\n  orientation,\n}: {\n  view: CollapsedGroupView;\n  orientation: Orientation;\n}) {\n  if (view.collapse === 'select') {\n    const active = view.commands.find((command) => command.active);\n    return (\n      <select\n        value={active?.id ?? ''}\n        onChange={(event) => view.execute(event.target.value)}\n        style={{\n          padding: '4px 6px',\n          font: 'inherit',\n          borderRadius: 4,\n          border: `1px solid ${BORDER}`,\n          background: SURFACE,\n        }}\n      >\n        {view.commands.map((command) => (\n          <option key={command.id} value={command.id} disabled={!command.enabled}>\n            {command.label}\n          </option>\n        ))}\n      </select>\n    );\n  }\n  // 'menu': reuse the overflow popover, scoped to this group's commands.\n  return <CollapsedMenuButton view={view} orientation={orientation} />;\n}\n\nfunction CollapsedMenuButton({\n  view,\n  orientation,\n}: {\n  view: CollapsedGroupView;\n  orientation: Orientation;\n}) {\n  const [isOpen, setOpen] = useState(false);\n  return (\n    <span style={{ position: 'relative', display: 'inline-flex' }}>\n      {defaultRenderOverflowTrigger(isOpen, () => setOpen((previous) => !previous))}\n      <DefaultOverflowMenu\n        view={groupMenuView(view, isOpen, () => setOpen(false))}\n        orientation={orientation}\n      />\n    </span>\n  );\n}\n\n/** Default shed-group disclosure: a chevron opening a radio menu of the\n *  hidden children. */\nfunction DefaultGroupTrigger({\n  view,\n  orientation,\n}: {\n  view: GroupDisclosureView;\n  orientation: Orientation;\n}) {\n  const [isOpen, setOpen] = useState(false);\n  const someActive = view.commands.some((command) => command.active);\n  return (\n    <span style={{ position: 'relative', display: 'inline-flex' }}>\n      <button\n        type=\"button\"\n        onClick={() => setOpen((previous) => !previous)}\n        aria-haspopup=\"menu\"\n        aria-expanded={isOpen}\n        title=\"More\"\n        style={{\n          display: 'inline-flex',\n          alignItems: 'center',\n          padding: '4px 6px',\n          color: 'inherit',\n          font: 'inherit',\n          border: `1px solid ${BORDER}`,\n          borderRadius: 4,\n          // A hint that the active item is in here.\n          background: isOpen || someActive ? ACTIVE : 'transparent',\n          cursor: 'pointer',\n        }}\n      >\n        ▾\n      </button>\n      <DefaultOverflowMenu\n        view={groupMenuView(view, isOpen, () => setOpen(false))}\n        orientation={orientation}\n      />\n    </span>\n  );\n}\n\n// ── the toolbar ───────────────────────────────────────────────────────────────\n\nexport function Toolbar({\n  bar,\n  orientation = 'horizontal',\n  gap = 8,\n  separatorWidth = 1,\n  'aria-label': ariaLabel,\n  className,\n  style,\n  renderCommand = defaultRenderCommand,\n  renderCustom,\n  renderCollapsed,\n  renderGroupTrigger,\n  renderSeparator,\n  renderOverflowTrigger = defaultRenderOverflowTrigger,\n  renderOverflowMenu,\n}: ToolbarProps) {\n  const kernel = useKernel();\n  const commands = useCapability(CommandsToken);\n  const documentId = useDocumentId();\n  const vertical = orientation === 'vertical';\n\n  // Command state is derived-on-read; re-render on the kernel's change stream\n  // so labels/active/visible (and thus the hidden layer's measurements) stay\n  // live. The toolbar is small — a per-action render is the simple, correct\n  // baseline.\n  const [, force] = useReducer((x: number) => x + 1, 0);\n  useEffect(() => kernel.subscribe(force), [kernel]);\n\n  const containerRef = useRef<HTMLDivElement>(null);\n  const [containerLength, setContainerLength] = useState(0);\n  useLayoutEffect(\n    () =>\n      containerRef.current\n        ? observeContentLength(containerRef.current, orientation, setContainerLength)\n        : undefined,\n    [orientation],\n  );\n\n  // A length that changed renders (and solves) again.\n  const [lengths] = useState(createToolbarLengths);\n  const [, bumpMeasureVersion] = useReducer((version: number) => version + 1, 0);\n  const onLength = useMemo(\n    () => (key: string, length: number) => {\n      if (lengths.report(orientation, key, length)) bumpMeasureVersion();\n    },\n    [lengths, orientation],\n  );\n\n  // The keyboard: one tab stop, and arrow keys along the toolbar.\n  const roving = useRef<RovingFocus | null>(null);\n  useLayoutEffect(() => {\n    const toolbar = containerRef.current;\n    if (!toolbar) return;\n    const focus = attachToolbarFocus(toolbar, orientation);\n    roving.current = focus;\n    return () => {\n      focus.detach();\n      roving.current = null;\n    };\n  }, [orientation]);\n  // Any render can add, remove or disable an item, so the tab stop is checked after each one.\n  useLayoutEffect(() => roving.current?.refresh());\n\n  const resolveCmd = (id: string): ResolvedCommand | null =>\n    commands.resolveCommand(id, documentId ?? undefined);\n  const executeCmd = (id: string) =>\n    void commands.execute(id, { documentId: documentId ?? undefined });\n\n  // Structure → visible structure → fit → parts (core-ui's `layoutToolbar`).\n  // Cheap enough to run per render: O(items), and items is ~dozens.\n  const normalized = useMemo(() => normalizeBar(bar), [bar]);\n  const layout = layoutToolbar({\n    bar: normalized,\n    resolve: resolveCmd,\n    unregistered: unregisteredCommand,\n    execute: executeCmd,\n    menuTarget: (id) => commands.getMenuTarget(id),\n    metrics: lengths.metrics(orientation, gap, separatorWidth),\n    measureKey: toolbarMeasureKey,\n    containerLength,\n    orientation,\n  });\n\n  const [overflowOpen, setOverflowOpen] = useState(false);\n  useEffect(() => {\n    if (!layout.hasOverflow) setOverflowOpen(false);\n  }, [layout.hasOverflow]);\n\n  /** External = custom part with no registered renderer → native socket,\n   *  live-measured (it must not appear in the measurement layer: only the\n   *  first same-named <slot> in tree order receives the projected nodes). */\n  const isExternalSlot = (part: ToolbarPart<ResolvedCommand>): boolean =>\n    part.kind === 'custom' && !renderCustom?.[part.name];\n\n  // ── part rendering (shared by live row and measure layer) ──────────────────\n  // A render prop that returns `undefined` leaves the part to its default.\n  const renderPart = (\n    part: ToolbarPart<ResolvedCommand>,\n    layer: 'live' | 'measure',\n  ): React.ReactNode => {\n    switch (part.kind) {\n      case 'command':\n        return renderCommand(part.command, part.variant, part.run);\n      case 'custom': {\n        // The item's command, as a button: what it draws when nothing else does.\n        const terminal = () =>\n          part.terminal ? renderCommand(part.terminal, 'icon', part.runTerminal) : null;\n        const registered = renderCustom?.[part.name];\n        if (registered) {\n          const custom = registered(part.variant, {\n            layer,\n            measure: (length) => onLength(part.measureKey, length),\n          });\n          return custom === undefined ? terminal() : custom;\n        }\n        if (layer === 'measure') return null;\n        return (\n          <NativeSlotSocket\n            name={part.name}\n            k={part.measureKey}\n            orientation={orientation}\n            onLength={onLength}\n          >\n            {terminal()}\n          </NativeSlotSocket>\n        );\n      }\n      case 'collapsed': {\n        const drawn = renderCollapsed?.(part.view);\n        return drawn === undefined ? (\n          <DefaultCollapsed view={part.view} orientation={orientation} />\n        ) : (\n          drawn\n        );\n      }\n      case 'disclosure': {\n        const drawn = renderGroupTrigger?.(part.view);\n        return drawn === undefined ? (\n          <DefaultGroupTrigger view={part.view} orientation={orientation} />\n        ) : (\n          drawn\n        );\n      }\n    }\n  };\n\n  const renderLiveSection = (section: LiveSection<ResolvedCommand>): React.ReactNode =>\n    section.groups.map((group, i) => (\n      <React.Fragment key={group.id}>\n        {i > 0 &&\n          (renderSeparator ? renderSeparator() : <DefaultSeparator orientation={orientation} />)}\n        {group.parts.map((part) => (\n          <span key={part.key} {...TOOLBAR_ITEM} style={ITEM_STYLE}>\n            {renderPart(part, 'live')}\n          </span>\n        ))}\n      </React.Fragment>\n    ));\n\n  /**\n   * Segment layout, along the toolbar's axis. The center segment carries auto\n   * margins: it balances in the leftover space (true center when the flanks\n   * are symmetric) and yields when they aren't, collapsing to zero before\n   * anything can overlap. The container itself has no gap — segments space\n   * themselves — so the solver's global budget (sum of unit lengths +\n   * per-unit gaps) is exactly the layout's minimum length: what the solver\n   * says fits, fits. Its cross-segment gap allowance (≤ 2×gap) becomes slack\n   * the auto margins absorb, keeping ≥ gap between segments at the floor.\n   * Segments never grow or shrink: fit is the solver's job, not flexbox's.\n   */\n  const sectionStyle = (position: 'start' | 'center' | 'end'): React.CSSProperties => ({\n    display: 'flex',\n    flexDirection: vertical ? 'column' : 'row',\n    alignItems: 'center',\n    gap,\n    flex: '0 0 auto',\n    ...(position !== 'center'\n      ? null\n      : vertical\n        ? { marginTop: 'auto', marginBottom: 'auto' }\n        : { marginLeft: 'auto', marginRight: 'auto' }),\n  });\n\n  const overflowView: OverflowMenuView = {\n    sections: layout.overflow,\n    isOpen: overflowOpen,\n    close: () => setOverflowOpen(false),\n    resolve: resolveCmd,\n    execute: executeCmd,\n  };\n\n  return (\n    <div\n      ref={containerRef}\n      role=\"toolbar\"\n      aria-orientation={orientation}\n      aria-label={ariaLabel}\n      className={className}\n      style={{\n        position: 'relative',\n        display: 'flex',\n        flexDirection: vertical ? 'column' : 'row',\n        alignItems: 'center',\n        ...style,\n      }}\n    >\n      {layout.sections.map((section) => (\n        <div key={section.name} style={sectionStyle(section.name)}>\n          {renderLiveSection(section)}\n          {section.name === 'end' && layout.hasOverflow && (\n            <span {...TOOLBAR_ITEM} style={{ position: 'relative', display: 'inline-flex' }}>\n              {renderOverflowTrigger(overflowOpen, () => setOverflowOpen((previous) => !previous))}\n              {renderOverflowMenu ? (\n                renderOverflowMenu(overflowView)\n              ) : (\n                <DefaultOverflowMenu view={overflowView} orientation={orientation} />\n              )}\n            </span>\n          )}\n        </div>\n      ))}\n\n      {/* The measurement layer: every unit in every variant, every collapsed\n          group form, and the trigger — hidden, inert, observed. Text reflow\n          (locale, fonts, zoom) fires the observers; no change-handling code.\n          External sockets are excluded: they are live-measured, and a\n          duplicate <slot> here would steal the projection from the row. */}\n      <div aria-hidden {...INERT} style={measureLayerStyle(orientation)}>\n        {layout.measured\n          .filter((part) => !isExternalSlot(part))\n          .map((part) => {\n            const drawn = renderPart(part, 'measure');\n            // A custom item that draws nothing here is measured where it renders, by `ctx.measure`.\n            if (part.kind === 'custom' && drawn === null) return null;\n            return (\n              <Measured\n                key={part.measureKey}\n                k={part.measureKey}\n                orientation={orientation}\n                onLength={onLength}\n              >\n                {drawn}\n              </Measured>\n            );\n          })}\n        <Measured\n          k={toolbarMeasureKey.overflowTrigger}\n          orientation={orientation}\n          onLength={onLength}\n        >\n          {renderOverflowTrigger(false, () => {})}\n        </Measured>\n      </div>\n    </div>\n  );\n}\n"],"mappings":"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"}

package/dist/toolbar.d.cts

@@ -1,100 +1,90 @@
 import * as React from "react";
-import { BarSchema, OverflowSection } from "@embedpdf/core-ui";
+import { BarChild, BarGroup, BarItem, BarSchema, BarSchema as BarSchema$1, BarSections, CollapsedGroupView as CollapsedGroupView$1, CustomItem, CustomSlotCtx, DEFAULT_IMPORTANCE, GroupDisclosureView as GroupDisclosureView$1, Importance, OverflowMenuView as OverflowMenuView$1, OverflowRow, OverflowSection, PINNED, StripView as StripView$1, StripViewGroup as StripViewGroup$1, Variant, custom, group, item } from "@embedpdf/core-ui";
 import { ResolvedCommand } from "@embedpdf/plugin-commands/contract";
-export * from "@embedpdf/core-ui";
 //#region src/toolbar.d.ts
-interface CollapsedGroupView {
-  readonly id: string;
-  readonly labelKey?: string;
-  readonly collapse: 'menu' | 'select';
-  readonly role: 'buttons' | 'tabs';
-  /** The group's commands (custom items via their terminal), resolved live. */
-  readonly commands: readonly ResolvedCommand[];
-  execute(id: string): void;
-}
-interface OverflowMenuView {
-  readonly sections: readonly OverflowSection[];
-  readonly isOpen: boolean;
-  close(): void;
-  resolve(id: string): ResolvedCommand | null;
-  execute(id: string): void;
-}
+/** A group folded into one control: its commands, resolved live, and how to run one. */
+type CollapsedGroupView = CollapsedGroupView$1<ResolvedCommand>;
+/** The "More" menu: what didn't fit, in sections, and the calls a menu needs. */
+type OverflowMenuView = OverflowMenuView$1<ResolvedCommand>;
 /**
- * A shed group's disclosure — the derived trigger rendered INSIDE the group
- * (v2's overflow-tabs-button). `commands` is what sits behind the trigger:
- * the shed children in bar order, resolved live. In the measurement layer the
- * trigger is measured with the FULL group as content, so a count-dependent
- * trigger (e.g. a "+3" badge) is budgeted at its widest form.
+ * A shed group's disclosure — the derived trigger rendered inside the group.
+ * `commands` is what sits behind the trigger: the shed children in bar order,
+ * resolved live. In the measurement layer the trigger is measured with the
+ * full group as content, so a count-dependent trigger (e.g. a "+3" badge) is
+ * budgeted at its widest form.
  */
-interface GroupDisclosureView {
-  readonly id: string;
-  readonly labelKey?: string;
-  readonly role: 'buttons' | 'tabs';
-  readonly commands: readonly ResolvedCommand[];
-  execute(id: string): void;
-}
-interface StripViewGroup {
-  readonly id: string;
-  readonly labelKey?: string;
-  /** Visible commands, bar order. Groups are separator boundaries. */
-  readonly commands: readonly ResolvedCommand[];
-}
+type GroupDisclosureView = GroupDisclosureView$1<ResolvedCommand>;
+/** A group of a strip: its visible commands, bar order. Groups are separator boundaries. */
+type StripViewGroup = StripViewGroup$1<ResolvedCommand>;
 /** A contextual strip, resolved: only visible commands, only non-empty groups. */
-interface StripView {
-  readonly groups: readonly StripViewGroup[];
-  execute(id: string): void;
-}
+type StripView = StripView$1<ResolvedCommand>;
 /**
  * The live projection of a bar through the command registry — <Toolbar>'s
- * un-measured sibling, for contextual strips (ChromeSchema.strips). The schema
- * declares what COULD appear; each command's `visible` derivation decides what
- * DOES; null means nothing currently applies, so `if (!view) return null` is
+ * un-measured sibling, for contextual strips (a bar over a selection). The schema
+ * declares what could appear; each command's `visible` derivation decides what
+ * does; null means nothing currently applies, so `if (!view) return null` is
  * the caller's entire show/hide logic. `execute` is pre-bound to this
  * subtree's document. Reads are value-equal (resolvedCommandsEqual), so
  * consumers re-render on real change, not on every store action.
  */
-declare function useStripView(bar: BarSchema | undefined): StripView | null;
+declare function useStripView(bar: BarSchema$1 | undefined): StripView | null;
 interface ToolbarProps {
-  bar: BarSchema;
+  bar: BarSchema$1;
+  /**
+   * Which way the toolbar runs. A vertical toolbar fits the height it's given,
+   * so give it one; it stacks its sections top, middle and bottom, and draws
+   * every command at `'icon'`, with the label for a tooltip. Default
+   * `'horizontal'`.
+   */
+  orientation?: 'horizontal' | 'vertical';
   /** Px between adjacent items (CSS flex gap; the solver budgets the same number). */
   gap?: number;
-  /** Width of the separator ELEMENT your renderSeparator draws. Default 1. */
+  /**
+   * The thickness of the separator your renderSeparator draws: its width
+   * across a horizontal toolbar, its height in a vertical one. Default 1.
+   */
   separatorWidth?: number;
+  /** The toolbar's name for screen readers, for a page with more than one toolbar. */
+  'aria-label'?: string;
   className?: string;
   style?: React.CSSProperties;
-  /** A command button at a given variant. Default: a plain <button>. */
+  /** A command button at a given variant. Default: a plain <button> with the command's label. */
   renderCommand?: (cmd: ResolvedCommand, variant: string, run: () => void) => React.ReactNode;
   /**
-   * Renderers for custom slots, per named variant. A custom unit with NO
-   * entry here renders as a native `<slot name={slot}>` socket with its
-   * terminal command as fallback content: in light DOM that displays the
-   * fallback (today's behavior); inside a shadow root the host's light-DOM
-   * children project into it — the children-as-slots contract. Sockets are
-   * measured LIVE (they can't be duplicated into the measurement layer:
-   * only the first same-named slot in tree order gets the projected nodes).
+   * Your own items, one renderer per name (from `custom(name, command)`),
+   * called with the variant the fit chose. A renderer that returns
+   * `undefined` draws the item's command instead (`renderCommand` with the
+   * terminal command, variant `'icon'`). An item with no entry here renders
+   * as a native `<slot name={slot}>` socket with that command as fallback
+   * content: in light DOM that displays the fallback; inside a shadow root
+   * the host's light-DOM children project into it — the children-as-slots
+   * contract. Sockets are measured live (they can't be duplicated into the
+   * measurement layer: only the first same-named slot in tree order gets the
+   * projected nodes). A renderer that draws nothing (`null`) in the
+   * measurement layer (`ctx.layer === 'measure'`) is measured where it
+   * renders instead: report its length with `ctx.measure`, a new function on
+   * every render (capture it in a ref to use it in an effect). The first
+   * element of an item that takes focus is the item's stop in the toolbar's
+   * arrow-key order.
    */
   renderCustom?: Record<string, (variant: string, ctx: CustomSlotCtx) => React.ReactNode>;
-  /** A group in its collapsed form. Default: <select> for 'select', menu button for 'menu'. */
+  /**
+   * A group in its collapsed form. Default: <select> for 'select', menu button for 'menu'; a
+   * renderer that returns `undefined` leaves the group to the default.
+   */
   renderCollapsed?: (view: CollapsedGroupView) => React.ReactNode;
   /** A shed group's disclosure trigger (+ its popover — the renderer owns the
-   *  open state). Default: a chevron button opening a radio menu. */
+   *  open state). Default: a chevron button opening a radio menu; `undefined`
+   *  leaves it to the default too. */
   renderGroupTrigger?: (view: GroupDisclosureView) => React.ReactNode;
-  /** Derived separator between adjacent visible groups. Default: a 1px line. */
+  /** Derived separator between adjacent visible groups. Default: a 1px line across the toolbar. */
   renderSeparator?: () => React.ReactNode;
+  /** The "More" button. Default: a plain ⋯ button. */
   renderOverflowTrigger?: (isOpen: boolean, toggle: () => void) => React.ReactNode;
   /** The derived overflow menu. Default: a minimal popover. */
   renderOverflowMenu?: (view: OverflowMenuView) => React.ReactNode;
 }
-/** Passed to custom-slot renderers alongside the variant. */
-interface CustomSlotCtx {
-  /** 'live' = the visible row; 'measure' = the hidden measurement layer. */
-  layer: 'live' | 'measure';
-  /** Report this unit's width to the solver — for content the measurement
-   *  layer can't duplicate. Identity is NOT stable across renders; capture
-   *  via ref if used in an effect. */
-  measure: (width: number) => void;
-}
-declare function Toolbar({ bar, gap, separatorWidth, className, style, renderCommand, renderCustom, renderCollapsed, renderGroupTrigger, renderSeparator, renderOverflowTrigger, renderOverflowMenu }: ToolbarProps): import("react/jsx-runtime").JSX.Element;
+declare function Toolbar({ bar, orientation, gap, separatorWidth, 'aria-label': ariaLabel, className, style, renderCommand, renderCustom, renderCollapsed, renderGroupTrigger, renderSeparator, renderOverflowTrigger, renderOverflowMenu }: ToolbarProps): import("react/jsx-runtime").JSX.Element;
 //#endregion
-export { CollapsedGroupView, CustomSlotCtx, GroupDisclosureView, OverflowMenuView, StripView, StripViewGroup, Toolbar, ToolbarProps, useStripView };
+export { type BarChild, type BarGroup, type BarItem, type BarSchema, type BarSections, CollapsedGroupView, type CustomItem, type CustomSlotCtx, DEFAULT_IMPORTANCE, GroupDisclosureView, type Importance, OverflowMenuView, type OverflowRow, type OverflowSection, PINNED, StripView, StripViewGroup, Toolbar, ToolbarProps, type Variant, custom, group, item, useStripView };
 //# sourceMappingURL=toolbar.d.cts.map

package/dist/toolbar.d.ts

@@ -1,100 +1,90 @@
-import * as React from "react";
-import { BarSchema, OverflowSection } from "@embedpdf/core-ui";
+import * as React$1 from "react";
+import { BarChild, BarGroup, BarItem, BarSchema, BarSchema as BarSchema$1, BarSections, CollapsedGroupView as CollapsedGroupView$1, CustomItem, CustomSlotCtx, DEFAULT_IMPORTANCE, GroupDisclosureView as GroupDisclosureView$1, Importance, OverflowMenuView as OverflowMenuView$1, OverflowRow, OverflowSection, PINNED, StripView as StripView$1, StripViewGroup as StripViewGroup$1, Variant, custom, group, item } from "@embedpdf/core-ui";
 import { ResolvedCommand } from "@embedpdf/plugin-commands/contract";
-export * from "@embedpdf/core-ui";
 //#region src/toolbar.d.ts
-interface CollapsedGroupView {
-  readonly id: string;
-  readonly labelKey?: string;
-  readonly collapse: 'menu' | 'select';
-  readonly role: 'buttons' | 'tabs';
-  /** The group's commands (custom items via their terminal), resolved live. */
-  readonly commands: readonly ResolvedCommand[];
-  execute(id: string): void;
-}
-interface OverflowMenuView {
-  readonly sections: readonly OverflowSection[];
-  readonly isOpen: boolean;
-  close(): void;
-  resolve(id: string): ResolvedCommand | null;
-  execute(id: string): void;
-}
+/** A group folded into one control: its commands, resolved live, and how to run one. */
+type CollapsedGroupView = CollapsedGroupView$1<ResolvedCommand>;
+/** The "More" menu: what didn't fit, in sections, and the calls a menu needs. */
+type OverflowMenuView = OverflowMenuView$1<ResolvedCommand>;
 /**
- * A shed group's disclosure — the derived trigger rendered INSIDE the group
- * (v2's overflow-tabs-button). `commands` is what sits behind the trigger:
- * the shed children in bar order, resolved live. In the measurement layer the
- * trigger is measured with the FULL group as content, so a count-dependent
- * trigger (e.g. a "+3" badge) is budgeted at its widest form.
+ * A shed group's disclosure — the derived trigger rendered inside the group.
+ * `commands` is what sits behind the trigger: the shed children in bar order,
+ * resolved live. In the measurement layer the trigger is measured with the
+ * full group as content, so a count-dependent trigger (e.g. a "+3" badge) is
+ * budgeted at its widest form.
  */
-interface GroupDisclosureView {
-  readonly id: string;
-  readonly labelKey?: string;
-  readonly role: 'buttons' | 'tabs';
-  readonly commands: readonly ResolvedCommand[];
-  execute(id: string): void;
-}
-interface StripViewGroup {
-  readonly id: string;
-  readonly labelKey?: string;
-  /** Visible commands, bar order. Groups are separator boundaries. */
-  readonly commands: readonly ResolvedCommand[];
-}
+type GroupDisclosureView = GroupDisclosureView$1<ResolvedCommand>;
+/** A group of a strip: its visible commands, bar order. Groups are separator boundaries. */
+type StripViewGroup = StripViewGroup$1<ResolvedCommand>;
 /** A contextual strip, resolved: only visible commands, only non-empty groups. */
-interface StripView {
-  readonly groups: readonly StripViewGroup[];
-  execute(id: string): void;
-}
+type StripView = StripView$1<ResolvedCommand>;
 /**
  * The live projection of a bar through the command registry — <Toolbar>'s
- * un-measured sibling, for contextual strips (ChromeSchema.strips). The schema
- * declares what COULD appear; each command's `visible` derivation decides what
- * DOES; null means nothing currently applies, so `if (!view) return null` is
+ * un-measured sibling, for contextual strips (a bar over a selection). The schema
+ * declares what could appear; each command's `visible` derivation decides what
+ * does; null means nothing currently applies, so `if (!view) return null` is
  * the caller's entire show/hide logic. `execute` is pre-bound to this
  * subtree's document. Reads are value-equal (resolvedCommandsEqual), so
  * consumers re-render on real change, not on every store action.
  */
-declare function useStripView(bar: BarSchema | undefined): StripView | null;
+declare function useStripView(bar: BarSchema$1 | undefined): StripView | null;
 interface ToolbarProps {
-  bar: BarSchema;
+  bar: BarSchema$1;
+  /**
+   * Which way the toolbar runs. A vertical toolbar fits the height it's given,
+   * so give it one; it stacks its sections top, middle and bottom, and draws
+   * every command at `'icon'`, with the label for a tooltip. Default
+   * `'horizontal'`.
+   */
+  orientation?: 'horizontal' | 'vertical';
   /** Px between adjacent items (CSS flex gap; the solver budgets the same number). */
   gap?: number;
-  /** Width of the separator ELEMENT your renderSeparator draws. Default 1. */
+  /**
+   * The thickness of the separator your renderSeparator draws: its width
+   * across a horizontal toolbar, its height in a vertical one. Default 1.
+   */
   separatorWidth?: number;
+  /** The toolbar's name for screen readers, for a page with more than one toolbar. */
+  'aria-label'?: string;
   className?: string;
-  style?: React.CSSProperties;
-  /** A command button at a given variant. Default: a plain <button>. */
-  renderCommand?: (cmd: ResolvedCommand, variant: string, run: () => void) => React.ReactNode;
+  style?: React$1.CSSProperties;
+  /** A command button at a given variant. Default: a plain <button> with the command's label. */
+  renderCommand?: (cmd: ResolvedCommand, variant: string, run: () => void) => React$1.ReactNode;
   /**
-   * Renderers for custom slots, per named variant. A custom unit with NO
-   * entry here renders as a native `<slot name={slot}>` socket with its
-   * terminal command as fallback content: in light DOM that displays the
-   * fallback (today's behavior); inside a shadow root the host's light-DOM
-   * children project into it — the children-as-slots contract. Sockets are
-   * measured LIVE (they can't be duplicated into the measurement layer:
-   * only the first same-named slot in tree order gets the projected nodes).
+   * Your own items, one renderer per name (from `custom(name, command)`),
+   * called with the variant the fit chose. A renderer that returns
+   * `undefined` draws the item's command instead (`renderCommand` with the
+   * terminal command, variant `'icon'`). An item with no entry here renders
+   * as a native `<slot name={slot}>` socket with that command as fallback
+   * content: in light DOM that displays the fallback; inside a shadow root
+   * the host's light-DOM children project into it — the children-as-slots
+   * contract. Sockets are measured live (they can't be duplicated into the
+   * measurement layer: only the first same-named slot in tree order gets the
+   * projected nodes). A renderer that draws nothing (`null`) in the
+   * measurement layer (`ctx.layer === 'measure'`) is measured where it
+   * renders instead: report its length with `ctx.measure`, a new function on
+   * every render (capture it in a ref to use it in an effect). The first
+   * element of an item that takes focus is the item's stop in the toolbar's
+   * arrow-key order.
    */
-  renderCustom?: Record<string, (variant: string, ctx: CustomSlotCtx) => React.ReactNode>;
-  /** A group in its collapsed form. Default: <select> for 'select', menu button for 'menu'. */
-  renderCollapsed?: (view: CollapsedGroupView) => React.ReactNode;
+  renderCustom?: Record<string, (variant: string, ctx: CustomSlotCtx) => React$1.ReactNode>;
+  /**
+   * A group in its collapsed form. Default: <select> for 'select', menu button for 'menu'; a
+   * renderer that returns `undefined` leaves the group to the default.
+   */
+  renderCollapsed?: (view: CollapsedGroupView) => React$1.ReactNode;
   /** A shed group's disclosure trigger (+ its popover — the renderer owns the
-   *  open state). Default: a chevron button opening a radio menu. */
-  renderGroupTrigger?: (view: GroupDisclosureView) => React.ReactNode;
-  /** Derived separator between adjacent visible groups. Default: a 1px line. */
-  renderSeparator?: () => React.ReactNode;
-  renderOverflowTrigger?: (isOpen: boolean, toggle: () => void) => React.ReactNode;
+   *  open state). Default: a chevron button opening a radio menu; `undefined`
+   *  leaves it to the default too. */
+  renderGroupTrigger?: (view: GroupDisclosureView) => React$1.ReactNode;
+  /** Derived separator between adjacent visible groups. Default: a 1px line across the toolbar. */
+  renderSeparator?: () => React$1.ReactNode;
+  /** The "More" button. Default: a plain ⋯ button. */
+  renderOverflowTrigger?: (isOpen: boolean, toggle: () => void) => React$1.ReactNode;
   /** The derived overflow menu. Default: a minimal popover. */
-  renderOverflowMenu?: (view: OverflowMenuView) => React.ReactNode;
-}
-/** Passed to custom-slot renderers alongside the variant. */
-interface CustomSlotCtx {
-  /** 'live' = the visible row; 'measure' = the hidden measurement layer. */
-  layer: 'live' | 'measure';
-  /** Report this unit's width to the solver — for content the measurement
-   *  layer can't duplicate. Identity is NOT stable across renders; capture
-   *  via ref if used in an effect. */
-  measure: (width: number) => void;
+  renderOverflowMenu?: (view: OverflowMenuView) => React$1.ReactNode;
 }
-declare function Toolbar({ bar, gap, separatorWidth, className, style, renderCommand, renderCustom, renderCollapsed, renderGroupTrigger, renderSeparator, renderOverflowTrigger, renderOverflowMenu }: ToolbarProps): import("react/jsx-runtime").JSX.Element;
+declare function Toolbar({ bar, orientation, gap, separatorWidth, 'aria-label': ariaLabel, className, style, renderCommand, renderCustom, renderCollapsed, renderGroupTrigger, renderSeparator, renderOverflowTrigger, renderOverflowMenu }: ToolbarProps): import("react/jsx-runtime").JSX.Element;
 //#endregion
-export { CollapsedGroupView, CustomSlotCtx, GroupDisclosureView, OverflowMenuView, StripView, StripViewGroup, Toolbar, ToolbarProps, useStripView };
+export { type BarChild, type BarGroup, type BarItem, type BarSchema, type BarSections, CollapsedGroupView, type CustomItem, type CustomSlotCtx, DEFAULT_IMPORTANCE, GroupDisclosureView, type Importance, OverflowMenuView, type OverflowRow, type OverflowSection, PINNED, StripView, StripViewGroup, Toolbar, ToolbarProps, type Variant, custom, group, item, useStripView };
 //# sourceMappingURL=toolbar.d.ts.map