eidos-ui 3.7.0 → 3.8.1

package/dist/chunk-OGGZIFTI.cjs.map

@@ -0,0 +1 @@
+{"version":3,"sources":["/home/runner/work/eidos-ui/eidos-ui/dist/chunk-OGGZIFTI.cjs","../src/components/ThemeEditor/ThemeEditor.component.tsx"],"names":["ratio","grade"],"mappings":"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","file":"/home/runner/work/eidos-ui/eidos-ui/dist/chunk-OGGZIFTI.cjs","sourcesContent":[null,"import React, { useCallback, useEffect, useMemo, useReducer, useRef, useState } from 'react';\nimport { CircleCheck, CircleX, RotateCcw, TriangleAlert, Upload } from 'lucide-react';\nimport { Alert } from '../Alert';\nimport { Button, IconButton } from '../Button';\nimport { Card } from '../Card';\nimport { ColorPicker } from '../ColorPicker';\nimport { Select } from '../Select';\nimport { Slider } from '../Slider';\nimport { Tooltip } from '../Tooltip';\nimport { useTheme } from '../ThemeProvider';\nimport type { ThemeColorKey, ThemeFontOption } from '../ThemeProvider';\nimport {\n  THEME_COLOR_KEYS,\n  FONT_SCALE_MAX,\n  FONT_SCALE_MIN,\n  defaultTheme,\n} from '../ThemeProvider/ThemeProvider.tokens';\nimport {\n  CONTRAST_DARK,\n  CONTRAST_LIGHT,\n  contrastRatio,\n  pickContrast,\n} from '../ThemeProvider/ThemeProvider.color';\nimport {\n  FONT_ACCEPT,\n  isFontStackAvailable,\n  registerFontFile,\n  subscribeToFontLoads,\n  toFontStack,\n} from '../ThemeProvider/ThemeProvider.fonts';\nimport type { ThemeEditorProps } from './ThemeEditor.types';\n\n/** The page surface every diagnostic is measured against - `--white`. */\nconst PAGE_SURFACE = CONTRAST_LIGHT;\n\n/** Below this, a fill is effectively invisible against the page behind it. */\nconst EDGE_MIN_RATIO = 1.5;\n\nconst COLOR_LABELS: Record<ThemeColorKey, string> = {\n  primary: 'Primary',\n  secondary: 'Secondary',\n  success: 'Success',\n  danger: 'Danger',\n  warning: 'Warning',\n  info: 'Info',\n  hyperlink: 'Hyperlink',\n};\n\n/** `hyperlink` is only ever text on a surface, so it is graded differently. */\nconst isFill = (key: ThemeColorKey): boolean => key !== 'hyperlink';\n\n/**\n * Built-in stacks, deliberately limited to fonts that can be relied on.\n *\n * A dropdown implies its entries are available, but a font stack is only a list\n * of *names* - nothing here can install a font. So the list is restricted to\n * generic families (guaranteed by CSS), `system-ui` (whatever the OS provides),\n * and the handful of genuinely web-safe faces. Fonts like Inter, which are not\n * installed anywhere by default, were removed: offering one is offering a\n * choice that silently does nothing on most machines.\n *\n * The preset is included because it is the shipped default and therefore has to\n * be representable - and note that `eidos-ui` does not ship the Plus Jakarta\n * Sans file either, so it renders only where the consumer provides it. That is\n * exactly why unavailable options are labelled as such.\n *\n * Anything beyond this belongs to the consuming app, via `fontOptions`.\n */\nconst FONT_STACKS: ThemeFontOption[] = [\n  // Taken from the preset rather than retyped, so the shipped default always\n  // matches an option exactly. A hand-copied shorter stack did not match, and\n  // the row fell back to showing a synthetic \"custom\" entry instead of the\n  // name of the font actually in use.\n  { label: 'Plus Jakarta Sans (theme default)', value: defaultTheme.typography.fontFamily! },\n  { label: 'System UI', value: \"system-ui, -apple-system, 'Segoe UI', sans-serif\" },\n  { label: 'Helvetica / Arial', value: 'Helvetica, Arial, sans-serif' },\n  { label: 'Georgia', value: \"Georgia, 'Times New Roman', serif\" },\n  { label: 'Sans-serif (generic)', value: 'sans-serif' },\n  { label: 'Serif (generic)', value: 'serif' },\n];\n\nconst MONO_STACKS: ThemeFontOption[] = [\n  { label: 'JetBrains Mono (theme default)', value: defaultTheme.typography.monoFamily! },\n  { label: 'Menlo / Consolas', value: 'Menlo, Consolas, monospace' },\n  { label: 'Courier New', value: \"'Courier New', Courier, monospace\" },\n  { label: 'Monospace (generic)', value: 'monospace' },\n];\n\ntype Grade = 'aa' | 'aa-large' | 'fail';\n\nconst gradeFor = (ratio: number): Grade => (ratio >= 4.5 ? 'aa' : ratio >= 3 ? 'aa-large' : 'fail');\n\n/** Spelled out for the middle grade, which is the one that misleads. */\nconst GRADE_CAVEAT: Partial<Record<Grade, string>> = {\n  'aa-large':\n    ' WCAG AA needs 4.5:1 for normal text and allows 3:1 only at 24px or larger - button and label text here is around 12px, so this does not pass.',\n  fail: ' Below 3:1, which fails WCAG AA at every text size.',\n};\n\n/**\n * Severity is carried by an icon and the label text, not by colour.\n *\n * These badges cannot use `Pill`, or any themed `--x-color`: the theme being\n * edited also styles this editor, so a washed-out `success` colour would render\n * the \"passes AA\" badge illegible at precisely the moment it is reporting that\n * a colour is illegible. The badge styling comes from the gray ramp, which is\n * deliberately not themeable.\n *\n * Not relying on colour alone also satisfies WCAG 1.4.1 (Use of Colour).\n */\nconst GRADE_BADGE: Record<\n  Grade,\n  { label: string; icon: React.ComponentType<{ className?: string }> }\n> = {\n  aa: { label: 'AA', icon: CircleCheck },\n  // Named for what it means in practice, not just for the threshold it clears.\n  // WCAG's relaxed 3:1 tier applies only to text at 24px (or 18.7px bold) and\n  // above, and nothing in this library is that large - `--font-size-sm` is\n  // ~12.25px at the default root size. A bare \"AA large only\" reads as a pass\n  // when for every component here it is a fail.\n  'aa-large': { label: 'Too low for body text', icon: TriangleAlert },\n  fail: { label: 'Fails AA', icon: CircleX },\n};\n\ninterface Diagnostic {\n  grade: Grade;\n  ratio: number;\n  /** What the ratio describes, for the tooltip. */\n  detail: string;\n  /** Set when the fill is too close to the page surface to be seen. */\n  edgeWarning?: string;\n}\n\nconst diagnose = (key: ThemeColorKey, base: string, explicitContrast?: string): Diagnostic => {\n  if (!isFill(key)) {\n    // Link text sits on the page, so the page is what it must contrast with.\n    const ratio = contrastRatio(base, PAGE_SURFACE);\n    const grade = gradeFor(ratio);\n    return {\n      grade,\n      ratio,\n      detail: `Link text on the page background: ${ratio.toFixed(2)}:1 against white.${GRADE_CAVEAT[grade] ?? ''}`,\n    };\n  }\n\n  const foreground = explicitContrast ?? pickContrast(base);\n  const ratio = contrastRatio(base, foreground);\n  const name = foreground.toLowerCase() === CONTRAST_DARK ? 'dark' : 'white';\n  const edge = contrastRatio(base, PAGE_SURFACE);\n\n  const grade = gradeFor(ratio);\n\n  return {\n    grade,\n    ratio,\n    detail: `${name === 'white' ? 'White' : 'Near-black'} text on this fill is ${ratio.toFixed(2)}:1.${\n      explicitContrast ? ' Foreground pinned via the theme.' : ''\n    }${GRADE_CAVEAT[grade] ?? ''}`,\n    edgeWarning:\n      edge < EDGE_MIN_RATIO\n        ? `Only ${edge.toFixed(2)}:1 against the page background - this fill is barely distinguishable from the page it sits on.`\n        : undefined,\n  };\n};\n\ninterface FontRowProps {\n  label: string;\n  /** Stack currently applied, used to pick the matching option. */\n  value: string;\n  options: ThemeFontOption[];\n  mono: boolean;\n  allowUpload: boolean;\n  onChange: (stack: string) => void;\n  onUploaded: (option: ThemeFontOption, file: File, family: string) => void;\n}\n\n/** Pulls the first family out of a stack, unquoted. */\nconst firstFamily = (stack: string): string =>\n  stack\n    .split(',')[0]\n    ?.trim()\n    .replace(/^['\"]|['\"]$/g, '') || 'Custom';\n\n/**\n * One font row: a `Select` over the known stacks, an optional upload, and an\n * availability warning.\n *\n * Uses `Select` rather than `Combobox` deliberately. `Combobox` filters its\n * options against the text in the field, and the field holds a full font stack\n * (`'Plus Jakarta Sans', -apple-system, …`) which matches no option label - so\n * the list read \"No results found\" until the text was cleared by hand. A font\n * is a choice from a known set, not a search.\n */\nconst FontRow: React.FC<FontRowProps> = ({\n  label,\n  value,\n  options,\n  mono,\n  allowUpload,\n  onChange,\n  onUploaded,\n}) => {\n  const inputRef = useRef<HTMLInputElement>(null);\n  const [error, setError] = useState<string | null>(null);\n\n  // Web fonts load asynchronously, so the first render always sees them as\n  // unavailable. Without re-checking once they arrive, the row would sit on a\n  // stale \"not installed\" warning for a font that is rendering perfectly.\n  // The reducer exists only to schedule that re-render; its value is unused.\n  const [, onFontsLoaded] = useReducer((count: number) => count + 1, 0);\n  useEffect(() => subscribeToFontLoads(onFontsLoaded), [onFontsLoaded]);\n\n  const baseOptions = useMemo(() => {\n    // A stack the theme carries but that isn't in the list (loaded by the host\n    // app, or set programmatically) still needs to be selectable, labelled with\n    // its own first family so the row names the font actually in use.\n    const known = options.some((o) => o.value === value);\n    return known ? options : [...options, { label: `${firstFamily(value)} (custom)`, value }];\n  }, [options, value]);\n\n  // Probed on every render rather than memoised: availability changes over time\n  // as fonts load, so a cached answer is a wrong answer. Four canvas\n  // measurements are far cheaper than getting this wrong.\n  //\n  // Availability is annotated per option rather than filtered or disabled. A\n  // theme is shared across machines, so a font present here may be absent for\n  // the next user - and vice versa, which would mean hiding a font someone\n  // legitimately wants. Annotating keeps every choice selectable while making\n  // the list stop implying that a name is a guarantee.\n  const selectOptions = baseOptions.map((option) => ({\n    id: option.value,\n    label: isFontStackAvailable(option.value) ? option.label : `${option.label} - not installed`,\n    value: option.value,\n  }));\n\n  const handleFile = useCallback(\n    async (file: File | undefined) => {\n      if (!file) return;\n      setError(null);\n      try {\n        const family = await registerFontFile(file);\n        const stack = toFontStack(family, mono);\n        onUploaded({ label: `${family} (this session)`, value: stack }, file, family);\n        onChange(stack);\n      } catch (cause) {\n        setError(\n          cause instanceof Error ? cause.message : 'That file could not be loaded as a font.',\n        );\n      }\n    },\n    [mono, onChange, onUploaded],\n  );\n\n  const unavailable = !isFontStackAvailable(value);\n\n  return (\n    <div className=\"eidos-theme-editor-row eidos-theme-editor-row--wide\">\n      <span className=\"eidos-theme-editor-row__label\">{label}</span>\n\n      <div className=\"eidos-theme-editor-row__control\">\n        <Select\n          options={selectOptions}\n          value={value}\n          onChange={(next) => onChange(Array.isArray(next) ? next[0] : next)}\n          fullWidth\n          // The row's visible label is a `<span>`, not a `<label htmlFor>`,\n          // so nothing associates it with the control. Naming the input\n          // directly keeps the two in step without restructuring the row.\n          inputProps={{ 'aria-label': label }}\n        />\n      </div>\n\n      {/* Occasional - lives before the action so it can never displace it. */}\n      <div className=\"eidos-theme-editor-row__diagnostics\">\n        {unavailable && (\n          <Tooltip\n            message={`${firstFamily(value)} isn't available here, so the browser is rendering the next family in the stack instead. Upload the file, or have your app serve it, to use it.`}\n          >\n            <span className=\"eidos-theme-editor-badge eidos-theme-editor-badge--aa-large\">\n              <TriangleAlert className=\"eidos-theme-editor-badge__icon\" />\n              Not installed\n            </span>\n          </Tooltip>\n        )}\n        {error && (\n          <Tooltip message={error}>\n            <span className=\"eidos-theme-editor-badge eidos-theme-editor-badge--fail\">\n              <CircleX className=\"eidos-theme-editor-badge__icon\" />\n              Upload failed\n            </span>\n          </Tooltip>\n        )}\n      </div>\n\n      {allowUpload && (\n        <div className=\"eidos-theme-editor-row__actions\">\n          <Button\n            variant=\"text\"\n            color=\"secondary\"\n            size=\"sm\"\n            preIcon={Upload}\n            onClick={() => inputRef.current?.click()}\n            tooltip=\"Load a font file to use it right away. Not saved - see onFontUpload to persist it.\"\n          >\n            Upload\n          </Button>\n          {/* Plain input rather than FileUpload: this is a single inline\n              action in a dense row, not a drop zone. */}\n          <input\n            ref={inputRef}\n            type=\"file\"\n            accept={FONT_ACCEPT}\n            // Same proxy pattern as `MessageComposer` - see the note there.\n            className=\"eidos-theme-editor-file\"\n            tabIndex={-1}\n            aria-hidden=\"true\"\n            onChange={(event) => {\n              void handleFile(event.target.files?.[0]);\n              // Allow re-picking the same file after a failure.\n              event.target.value = '';\n            }}\n          />\n        </div>\n      )}\n    </div>\n  );\n};\n\n/**\n * Live editor for the active `ThemeProvider` theme.\n *\n * Renders no preview of its own: the provider writes tokens to\n * `document.documentElement`, so the surrounding page is the preview.\n *\n * Contrast readouts are diagnostics only - a colour that fails is still\n * applied. Automatically \"correcting\" a chosen colour would mean silently\n * rendering something other than what was picked.\n */\nexport const ThemeEditor: React.FC<ThemeEditorProps> = ({\n  colors = THEME_COLOR_KEYS as ThemeColorKey[],\n  fontOptions = FONT_STACKS,\n  monoFontOptions = MONO_STACKS,\n  allowFontUpload = true,\n  onFontUpload,\n  hideTypography = false,\n  hideReset = false,\n  hideCssExport = false,\n  className,\n}) => {\n  const { theme, resolvedTheme, setTheme, updateTheme, resetTheme, isDefault, toCss } = useTheme();\n  const [copied, setCopied] = useState(false);\n\n  // Fonts registered through the upload control this session. Kept local\n  // because font *data* cannot live in a ThemeConfig - see the .mdx.\n  const [uploaded, setUploaded] = useState<ThemeFontOption[]>([]);\n  const [monoUploaded, setMonoUploaded] = useState<ThemeFontOption[]>([]);\n\n  const setColor = useCallback(\n    (key: ThemeColorKey, hex: string) => {\n      const current = theme.colors?.[key];\n      // Only the base is written here. A `contrast` pinned in the theme is\n      // preserved rather than dropped, since the editor never sets one.\n      const pinned = typeof current === 'object' ? current.contrast : undefined;\n      updateTheme({ colors: { [key]: pinned ? { base: hex, contrast: pinned } : hex } });\n    },\n    [theme.colors, updateTheme],\n  );\n\n  const resetColor = useCallback(\n    (key: ThemeColorKey) => {\n      // Must go through setTheme, not updateTheme: updateTheme merges, so a key\n      // left out of the patch keeps its existing value instead of being removed.\n      // Removal is what restores the preset, since resolveTheme fills gaps.\n      const nextColors = { ...theme.colors };\n      delete nextColors[key];\n      setTheme({ ...theme, colors: nextColors });\n    },\n    [theme, setTheme],\n  );\n\n  const diagnostics = useMemo(\n    () =>\n      colors.map((key) => {\n        const { base, contrast } = resolvedTheme.colors[key];\n        return { key, base, ...diagnose(key, base, contrast) };\n      }),\n    [colors, resolvedTheme],\n  );\n\n  const failing = diagnostics.filter((d) => d.grade === 'fail');\n  const invisible = diagnostics.filter((d) => d.edgeWarning);\n\n  const copyCss = useCallback(() => {\n    const css = toCss();\n    const done = () => {\n      setCopied(true);\n      setTimeout(() => setCopied(false), 1600);\n    };\n    if (navigator.clipboard?.writeText) {\n      navigator.clipboard.writeText(css).then(done, done);\n      return;\n    }\n    done();\n  }, [toCss]);\n\n  return (\n    <div className={['eidos-theme-editor', className].filter(Boolean).join(' ')}>\n      {(failing.length > 0 || invisible.length > 0) && (\n        <Alert variant=\"warning\" title=\"Contrast issues\">\n          {failing.length > 0 && (\n            <p>\n              Cannot reach WCAG AA (4.5:1) with either foreground:{' '}\n              {failing.map((d) => COLOR_LABELS[d.key]).join(', ')}.\n            </p>\n          )}\n          {invisible.length > 0 && (\n            <p>\n              Too close to the page background to read as a filled surface:{' '}\n              {invisible.map((d) => COLOR_LABELS[d.key]).join(', ')}.\n            </p>\n          )}\n        </Alert>\n      )}\n\n      <Card variant=\"outlined\" padding=\"lg\" className=\"eidos-theme-editor-section\">\n        <div className=\"eidos-theme-editor-section__header\">\n          <span className=\"eidos-theme-editor-section__title\">Colours</span>\n          <span className=\"eidos-theme-editor-section__hint\">\n            Shades, tints and foregrounds are derived from each base colour.\n          </span>\n        </div>\n\n        <div className=\"eidos-theme-editor-rows\">\n          {diagnostics.map(({ key, base, grade, ratio, detail, edgeWarning }) => {\n            const badge = GRADE_BADGE[grade];\n            const overridden = theme.colors?.[key] !== undefined;\n            return (\n              <div className=\"eidos-theme-editor-row\" key={key}>\n                <span className=\"eidos-theme-editor-row__label\">{COLOR_LABELS[key]}</span>\n\n                {/* `md` rather than `sm`: the size drives the panel's\n                    saturation/brightness canvas, and 120px is cramped for\n                    picking a lightness precisely. */}\n                <ColorPicker\n                  value={base}\n                  onChange={(hex) => setColor(key, hex)}\n                  size=\"md\"\n                  // The row draws its own visible label, so the picker must\n                  // not draw a second one - but without a name of its own\n                  // every picker here announced as \"Open colour picker\" and\n                  // they were indistinguishable.\n                  ariaLabel={COLOR_LABELS[key]}\n                />\n\n                <div className=\"eidos-theme-editor-row__diagnostics\">\n                  <Tooltip message={detail}>\n                    <span className={`eidos-theme-editor-badge eidos-theme-editor-badge--${grade}`}>\n                      <badge.icon className=\"eidos-theme-editor-badge__icon\" />\n                      {`${ratio.toFixed(2)}:1 ${badge.label}`}\n                    </span>\n                  </Tooltip>\n                  {edgeWarning && (\n                    <Tooltip message={edgeWarning}>\n                      <span className=\"eidos-theme-editor-badge eidos-theme-editor-badge--fail\">\n                        <CircleX className=\"eidos-theme-editor-badge__icon\" />\n                        Invisible on page\n                      </span>\n                    </Tooltip>\n                  )}\n                </div>\n\n                <div className=\"eidos-theme-editor-row__actions\">\n                  <IconButton\n                    icon={RotateCcw}\n                    variant=\"text\"\n                    color=\"secondary\"\n                    size=\"sm\"\n                    disabled={!overridden}\n                    onClick={() => resetColor(key)}\n                    tooltip={overridden ? `Reset ${COLOR_LABELS[key]} to the preset` : 'Unchanged'}\n                    aria-label={`Reset ${COLOR_LABELS[key]}`}\n                  />\n                </div>\n              </div>\n            );\n          })}\n        </div>\n      </Card>\n\n      {!hideTypography && (\n        <Card variant=\"outlined\" padding=\"lg\" className=\"eidos-theme-editor-section\">\n          <div className=\"eidos-theme-editor-section__header\">\n            <span className=\"eidos-theme-editor-section__title\">Typography</span>\n            <span className=\"eidos-theme-editor-section__hint\">\n              A stack only names a font - upload the file to use one the browser doesn&apos;t\n              already have. Spacing is declared in <code>em</code>, so the scale moves padding with\n              the text.\n            </span>\n          </div>\n\n          <div className=\"eidos-theme-editor-rows\">\n            <FontRow\n              label=\"Body font\"\n              value={resolvedTheme.typography.fontFamily}\n              options={[...fontOptions, ...uploaded]}\n              mono={false}\n              allowUpload={allowFontUpload}\n              onChange={(fontFamily) => updateTheme({ typography: { fontFamily } })}\n              onUploaded={(option, file, family) => {\n                setUploaded((prev) => [...prev, option]);\n                onFontUpload?.(file, family, false);\n              }}\n            />\n\n            <FontRow\n              label=\"Mono font\"\n              value={resolvedTheme.typography.monoFamily}\n              options={[...monoFontOptions, ...monoUploaded]}\n              mono\n              allowUpload={allowFontUpload}\n              onChange={(monoFamily) => updateTheme({ typography: { monoFamily } })}\n              onUploaded={(option, file, family) => {\n                setMonoUploaded((prev) => [...prev, option]);\n                onFontUpload?.(file, family, true);\n              }}\n            />\n\n            <div className=\"eidos-theme-editor-row eidos-theme-editor-row--wide\">\n              <span className=\"eidos-theme-editor-row__label\">Scale</span>\n              <div className=\"eidos-theme-editor-row__control\">\n                <Slider\n                  value={resolvedTheme.typography.fontScale}\n                  min={FONT_SCALE_MIN}\n                  max={FONT_SCALE_MAX}\n                  step={0.025}\n                  showValue\n                  showMinMax\n                  unit=\"×\"\n                  onChange={(value) => updateTheme({ typography: { fontScale: value } })}\n                />\n              </div>\n            </div>\n          </div>\n        </Card>\n      )}\n\n      {(!hideReset || !hideCssExport) && (\n        <div className=\"eidos-theme-editor-actions\">\n          {!hideReset && (\n            <Button variant=\"outlined\" color=\"secondary\" disabled={isDefault} onClick={resetTheme}>\n              Reset all\n            </Button>\n          )}\n          {!hideCssExport && (\n            <Button\n              variant=\"outlined\"\n              preIcon={copied ? 'Check' : 'Clipboard'}\n              onClick={copyCss}\n              tooltip=\"Copy the resolved tokens as a :root block you can paste into your own stylesheet\"\n            >\n              {copied ? 'Copied' : 'Copy as CSS'}\n            </Button>\n          )}\n        </div>\n      )}\n    </div>\n  );\n};\n\nThemeEditor.displayName = 'ThemeEditor';\n"]}

package/dist/{chunk-2PCCGQOH.js → chunk-P6OJQ2RN.js}

@@ -1,20 +1,20 @@
 import {
   Select
-} from "./chunk-MQAOXZD4.js";
+} from "./chunk-4S57PE43.js";
 import {
   Input
-} from "./chunk-YAKTVIVK.js";
+} from "./chunk-XIUZT4TO.js";
 import {
   Dropdown
-} from "./chunk-JHX6JK3M.js";
+} from "./chunk-3X6QVHTD.js";
 import {
   Button
-} from "./chunk-75GFIQRU.js";
+} from "./chunk-JY77VJAZ.js";
 import {
   devWarn,
   fullWidthModifier,
   useDialogFocus
-} from "./chunk-RHHZRTWM.js";
+} from "./chunk-U34INRFO.js";
 import {
   __commonJS,
   __toESM
@@ -1389,4 +1389,4 @@ export {
   TimeInput,
   DatePicker
 };
-//# sourceMappingURL=chunk-2PCCGQOH.js.map
+//# sourceMappingURL=chunk-P6OJQ2RN.js.map

package/dist/{chunk-3RWZC6OW.cjs → chunk-PE2SLXUS.cjs}

@@ -1,9 +1,9 @@
 "use strict";Object.defineProperty(exports, "__esModule", {value: true});
 
-var _chunkDA375AI6cjs = require('./chunk-DA375AI6.cjs');
+var _chunkXPG56DLQcjs = require('./chunk-XPG56DLQ.cjs');
 
 
-var _chunk35LGEPLPcjs = require('./chunk-35LGEPLP.cjs');
+var _chunkENMDOQQOcjs = require('./chunk-ENMDOQQO.cjs');
 
 // src/components/Alert/Alert.component.tsx
 var _lucidereact = require('lucide-react');
@@ -40,7 +40,7 @@ var Alert = ({
       const DefaultIcon = DEFAULT_ICONS[variant];
       iconNode = /* @__PURE__ */ _jsxruntime.jsx.call(void 0, DefaultIcon, { className: "eidos-alert-icon", "aria-hidden": "true" });
     } else if (isIconType(icon)) {
-      iconNode = _chunk35LGEPLPcjs.renderIcon.call(void 0, icon, "eidos-alert-icon");
+      iconNode = _chunkENMDOQQOcjs.renderIcon.call(void 0, icon, "eidos-alert-icon");
     }
   }
   const buttonColor = VARIANT_TO_BUTTON_COLOR[variant];
@@ -50,7 +50,7 @@ var Alert = ({
       title && /* @__PURE__ */ _jsxruntime.jsx.call(void 0, "p", { className: "eidos-alert-title", children: title }),
       children && /* @__PURE__ */ _jsxruntime.jsx.call(void 0, "div", { className: "eidos-alert-content", children }),
       action && /* @__PURE__ */ _jsxruntime.jsx.call(void 0, "div", { className: "eidos-alert-action", children: /* @__PURE__ */ _jsxruntime.jsx.call(void 0, 
-        _chunkDA375AI6cjs.Button,
+        _chunkXPG56DLQcjs.Button,
         {
           variant: action.variant === "filled" ? "filled" : "text",
           size: "sm",
@@ -76,4 +76,4 @@ var Alert = ({
 
 
 exports.Alert = Alert;
-//# sourceMappingURL=chunk-3RWZC6OW.cjs.map
+//# sourceMappingURL=chunk-PE2SLXUS.cjs.map

package/dist/{chunk-3RWZC6OW.cjs.map → chunk-PE2SLXUS.cjs.map}

@@ -1 +1 @@
-{"version":3,"sources":["/home/runner/work/eidos-ui/eidos-ui/dist/chunk-3RWZC6OW.cjs","../src/components/Alert/Alert.component.tsx"],"names":[],"mappings":"AAAA;AACE;AACF,wDAA6B;AAC7B;AACE;AACF,wDAA6B;AAC7B;AACA;ACNA,2CAA6D;AA6D5C,+CAAA;AAhDjB,IAAM,cAAA,EAA8E;AAAA,EAClF,IAAA,EAAM,iBAAA;AAAA,EACN,OAAA,EAAS,wBAAA;AAAA,EACT,OAAA,EAAS,0BAAA;AAAA,EACT,MAAA,EAAQ;AACV,CAAA;AAMA,IAAM,wBAAA,EAA6E;AAAA,EACjF,IAAA,EAAM,SAAA;AAAA,EACN,OAAA,EAAS,SAAA;AAAA,EACT,OAAA,EAAS,SAAA;AAAA,EACT,MAAA,EAAQ;AACV,CAAA;AAMA,SAAS,UAAA,CAAW,KAAA,EAA8C;AAChE,EAAA,OAAO,OAAO,MAAA,IAAU,SAAA;AAC1B;AAMO,IAAM,MAAA,EAA8B,CAAC;AAAA,EAC1C,QAAA,EAAU,MAAA;AAAA,EACV,KAAA;AAAA,EACA,QAAA;AAAA,EACA,IAAA;AAAA,EACA,SAAA;AAAA,EACA,MAAA;AAAA,EACA,UAAA,EAAY;AACd,CAAA,EAAA,GAAM;AACJ,EAAA,MAAM,QAAA,EAAU,CAAC,aAAA,EAAe,CAAA,aAAA,EAAgB,OAAO,CAAA,CAAA;AAG7B,EAAA;AACM,EAAA;AAElB,EAAA;AAC6B,IAAA;AACE,MAAA;AACjB,MAAA;AACG,IAAA;AACmB,MAAA;AAChD,IAAA;AACF,EAAA;AAEmD,EAAA;AAGjC,EAAA;AACe,IAAA;AAEd,oBAAA;AACU,MAAA;AACK,MAAA;AAEX,MAAA;AACZ,QAAA;AAAA,QAAA;AACwC,UAAA;AAClC,UAAA;AACE,UAAA;AACS,UAAA;AAER,UAAA;AAAA,QAAA;AAEZ,MAAA;AAEJ,IAAA;AAGE,IAAA;AAAC,MAAA;AAAA,MAAA;AACW,QAAA;AACD,QAAA;AACJ,QAAA;AACM,QAAA;AAEI,QAAA;AAAO,MAAA;AACxB,IAAA;AAEJ,EAAA;AAEJ;AD7B0D;AACA;AACA;AACA","file":"/home/runner/work/eidos-ui/eidos-ui/dist/chunk-3RWZC6OW.cjs","sourcesContent":[null,"import React from 'react';\nimport { Info, CircleCheck, TriangleAlert, CircleX, X } from 'lucide-react';\nimport type { AlertProps } from './Alert.types';\nimport type { IconType } from '../../utils';\nimport { renderIcon } from '../../utils';\nimport { Button } from '../Button/Button.component';\nimport './Alert.scss';\n\n// ============================================================================\n// Constants\n// ============================================================================\n\ntype Variant = NonNullable<AlertProps['variant']>;\n\nconst DEFAULT_ICONS: Record<Variant, React.ComponentType<{ className?: string }>> = {\n  info: Info,\n  success: CircleCheck,\n  warning: TriangleAlert,\n  danger: CircleX,\n};\n\n/**\n * Button only ships primary | secondary | success | danger.\n * Warning maps to primary (closest neutral-positive colour available).\n */\nconst VARIANT_TO_BUTTON_COLOR: Record<Variant, 'primary' | 'success' | 'danger'> = {\n  info: 'primary',\n  success: 'success',\n  warning: 'primary',\n  danger: 'danger',\n};\n\n// ============================================================================\n// Type guard\n// ============================================================================\n\nfunction isIconType(value: boolean | IconType): value is IconType {\n  return typeof value !== 'boolean';\n}\n\n// ============================================================================\n// Component\n// ============================================================================\n\nexport const Alert: React.FC<AlertProps> = ({\n  variant = 'info',\n  title,\n  children,\n  icon,\n  onDismiss,\n  action,\n  className = '',\n}) => {\n  const classes = ['eidos-alert', `eidos-alert--${variant}`, className].filter(Boolean).join(' ');\n\n  // Determine icon rendering\n  const showIcon = icon !== false;\n  let iconNode: React.ReactNode = null;\n\n  if (showIcon) {\n    if (icon === true || icon === undefined) {\n      const DefaultIcon = DEFAULT_ICONS[variant];\n      iconNode = <DefaultIcon className=\"eidos-alert-icon\" aria-hidden=\"true\" />;\n    } else if (isIconType(icon)) {\n      iconNode = renderIcon(icon, 'eidos-alert-icon');\n    }\n  }\n\n  const buttonColor = VARIANT_TO_BUTTON_COLOR[variant];\n\n  return (\n    <div className={classes} role=\"alert\">\n      {showIcon && <span className=\"eidos-alert-icon-wrapper\">{iconNode}</span>}\n\n      <div className=\"eidos-alert-body\">\n        {title && <p className=\"eidos-alert-title\">{title}</p>}\n        {children && <div className=\"eidos-alert-content\">{children}</div>}\n        {action && (\n          <div className=\"eidos-alert-action\">\n            <Button\n              variant={action.variant === 'filled' ? 'filled' : 'text'}\n              size=\"sm\"\n              color={buttonColor}\n              onClick={action.onClick}\n            >\n              {action.label}\n            </Button>\n          </div>\n        )}\n      </div>\n\n      {onDismiss && (\n        <button\n          className=\"eidos-alert-dismiss\"\n          onClick={onDismiss}\n          type=\"button\"\n          aria-label=\"Dismiss\"\n        >\n          <X aria-hidden=\"true\" />\n        </button>\n      )}\n    </div>\n  );\n};\n"]}
+{"version":3,"sources":["/home/runner/work/eidos-ui/eidos-ui/dist/chunk-PE2SLXUS.cjs","../src/components/Alert/Alert.component.tsx"],"names":[],"mappings":"AAAA;AACE;AACF,wDAA6B;AAC7B;AACE;AACF,wDAA6B;AAC7B;AACA;ACNA,2CAA6D;AA6D5C,+CAAA;AAhDjB,IAAM,cAAA,EAA8E;AAAA,EAClF,IAAA,EAAM,iBAAA;AAAA,EACN,OAAA,EAAS,wBAAA;AAAA,EACT,OAAA,EAAS,0BAAA;AAAA,EACT,MAAA,EAAQ;AACV,CAAA;AAMA,IAAM,wBAAA,EAA6E;AAAA,EACjF,IAAA,EAAM,SAAA;AAAA,EACN,OAAA,EAAS,SAAA;AAAA,EACT,OAAA,EAAS,SAAA;AAAA,EACT,MAAA,EAAQ;AACV,CAAA;AAMA,SAAS,UAAA,CAAW,KAAA,EAA8C;AAChE,EAAA,OAAO,OAAO,MAAA,IAAU,SAAA;AAC1B;AAMO,IAAM,MAAA,EAA8B,CAAC;AAAA,EAC1C,QAAA,EAAU,MAAA;AAAA,EACV,KAAA;AAAA,EACA,QAAA;AAAA,EACA,IAAA;AAAA,EACA,SAAA;AAAA,EACA,MAAA;AAAA,EACA,UAAA,EAAY;AACd,CAAA,EAAA,GAAM;AACJ,EAAA,MAAM,QAAA,EAAU,CAAC,aAAA,EAAe,CAAA,aAAA,EAAgB,OAAO,CAAA,CAAA;AAG7B,EAAA;AACM,EAAA;AAElB,EAAA;AAC6B,IAAA;AACE,MAAA;AACjB,MAAA;AACG,IAAA;AACmB,MAAA;AAChD,IAAA;AACF,EAAA;AAEmD,EAAA;AAGjC,EAAA;AACe,IAAA;AAEd,oBAAA;AACU,MAAA;AACK,MAAA;AAEX,MAAA;AACZ,QAAA;AAAA,QAAA;AACwC,UAAA;AAClC,UAAA;AACE,UAAA;AACS,UAAA;AAER,UAAA;AAAA,QAAA;AAEZ,MAAA;AAEJ,IAAA;AAGE,IAAA;AAAC,MAAA;AAAA,MAAA;AACW,QAAA;AACD,QAAA;AACJ,QAAA;AACM,QAAA;AAEI,QAAA;AAAO,MAAA;AACxB,IAAA;AAEJ,EAAA;AAEJ;AD7B0D;AACA;AACA;AACA","file":"/home/runner/work/eidos-ui/eidos-ui/dist/chunk-PE2SLXUS.cjs","sourcesContent":[null,"import React from 'react';\nimport { Info, CircleCheck, TriangleAlert, CircleX, X } from 'lucide-react';\nimport type { AlertProps } from './Alert.types';\nimport type { IconType } from '../../utils';\nimport { renderIcon } from '../../utils';\nimport { Button } from '../Button/Button.component';\nimport './Alert.scss';\n\n// ============================================================================\n// Constants\n// ============================================================================\n\ntype Variant = NonNullable<AlertProps['variant']>;\n\nconst DEFAULT_ICONS: Record<Variant, React.ComponentType<{ className?: string }>> = {\n  info: Info,\n  success: CircleCheck,\n  warning: TriangleAlert,\n  danger: CircleX,\n};\n\n/**\n * Button only ships primary | secondary | success | danger.\n * Warning maps to primary (closest neutral-positive colour available).\n */\nconst VARIANT_TO_BUTTON_COLOR: Record<Variant, 'primary' | 'success' | 'danger'> = {\n  info: 'primary',\n  success: 'success',\n  warning: 'primary',\n  danger: 'danger',\n};\n\n// ============================================================================\n// Type guard\n// ============================================================================\n\nfunction isIconType(value: boolean | IconType): value is IconType {\n  return typeof value !== 'boolean';\n}\n\n// ============================================================================\n// Component\n// ============================================================================\n\nexport const Alert: React.FC<AlertProps> = ({\n  variant = 'info',\n  title,\n  children,\n  icon,\n  onDismiss,\n  action,\n  className = '',\n}) => {\n  const classes = ['eidos-alert', `eidos-alert--${variant}`, className].filter(Boolean).join(' ');\n\n  // Determine icon rendering\n  const showIcon = icon !== false;\n  let iconNode: React.ReactNode = null;\n\n  if (showIcon) {\n    if (icon === true || icon === undefined) {\n      const DefaultIcon = DEFAULT_ICONS[variant];\n      iconNode = <DefaultIcon className=\"eidos-alert-icon\" aria-hidden=\"true\" />;\n    } else if (isIconType(icon)) {\n      iconNode = renderIcon(icon, 'eidos-alert-icon');\n    }\n  }\n\n  const buttonColor = VARIANT_TO_BUTTON_COLOR[variant];\n\n  return (\n    <div className={classes} role=\"alert\">\n      {showIcon && <span className=\"eidos-alert-icon-wrapper\">{iconNode}</span>}\n\n      <div className=\"eidos-alert-body\">\n        {title && <p className=\"eidos-alert-title\">{title}</p>}\n        {children && <div className=\"eidos-alert-content\">{children}</div>}\n        {action && (\n          <div className=\"eidos-alert-action\">\n            <Button\n              variant={action.variant === 'filled' ? 'filled' : 'text'}\n              size=\"sm\"\n              color={buttonColor}\n              onClick={action.onClick}\n            >\n              {action.label}\n            </Button>\n          </div>\n        )}\n      </div>\n\n      {onDismiss && (\n        <button\n          className=\"eidos-alert-dismiss\"\n          onClick={onDismiss}\n          type=\"button\"\n          aria-label=\"Dismiss\"\n        >\n          <X aria-hidden=\"true\" />\n        </button>\n      )}\n    </div>\n  );\n};\n"]}

package/dist/chunk-QD32IMMH.js

@@ -0,0 +1,13 @@
+import {
+  LinkContext
+} from "./chunk-U32K2H3N.js";
+
+// src/components/LinkProvider/LinkProvider.component.tsx
+import { jsx } from "react/jsx-runtime";
+var LinkProvider = ({ component, children }) => /* @__PURE__ */ jsx(LinkContext.Provider, { value: component, children });
+LinkProvider.displayName = "LinkProvider";
+
+export {
+  LinkProvider
+};
+//# sourceMappingURL=chunk-QD32IMMH.js.map

package/dist/chunk-QD32IMMH.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/components/LinkProvider/LinkProvider.component.tsx"],"sourcesContent":["import React from 'react';\nimport { LinkContext } from './LinkProvider.context';\nimport type { LinkProviderProps } from './LinkProvider.types';\n\n/**\n * Sets the component every library link renders with.\n *\n * A context rather than a per-component prop because the router is app-wide:\n * one provider at the root reaches every `Button`, `Chip`, `Header` and\n * `Toolbar` action and `Breadcrumb` crumb, including ones built from config\n * objects where there is nowhere to pass a component. Unlike `ThemeProvider`\n * it writes nothing global, so nesting is fine - the nearest one wins.\n */\nexport const LinkProvider: React.FC<LinkProviderProps> = ({ component, children }) => (\n  <LinkContext.Provider value={component}>{children}</LinkContext.Provider>\n);\n\nLinkProvider.displayName = 'LinkProvider';\n"],"mappings":";;;;;AAcE;AADK,IAAM,eAA4C,CAAC,EAAE,WAAW,SAAS,MAC9E,oBAAC,YAAY,UAAZ,EAAqB,OAAO,WAAY,UAAS;AAGpD,aAAa,cAAc;","names":[]}

package/dist/{chunk-OOCCSMWM.js → chunk-RHWZX7PB.js}

@@ -1,19 +1,20 @@
 import {
   Popover
-} from "./chunk-4J25XZDI.js";
+} from "./chunk-ZJWQPZ7E.js";
 import {
   Avatar
 } from "./chunk-XJBWFDDE.js";
 import {
   Button
-} from "./chunk-75GFIQRU.js";
+} from "./chunk-JY77VJAZ.js";
 import {
   devWarn,
   renderIcon
-} from "./chunk-RHHZRTWM.js";
+} from "./chunk-U34INRFO.js";
 
 // src/components/Header/Header.component.tsx
 import { useCallback, useEffect, useLayoutEffect, useRef, useState } from "react";
+import { Ellipsis } from "lucide-react";
 import { jsx, jsxs } from "react/jsx-runtime";
 var Header = ({
   title,
@@ -21,6 +22,7 @@ var Header = ({
   media,
   meta,
   variant = "default",
+  titleAs: TitleElement = "h1",
   actions,
   collapseActionsBelow = 640,
   actionsVisibleWhenCollapsed = 1,
@@ -67,7 +69,7 @@ var Header = ({
     return /* @__PURE__ */ jsx(Button, { ...action, size: "md", onClick: handleClick }, index);
   };
   const titles = /* @__PURE__ */ jsxs("div", { className: "eidos-header__titles", children: [
-    /* @__PURE__ */ jsx("h1", { className: "eidos-header__title", children: title }),
+    /* @__PURE__ */ jsx(TitleElement, { className: "eidos-header__title", children: title }),
     subtitle && /* @__PURE__ */ jsx("span", { className: "eidos-header__subtitle", children: subtitle }),
     !!meta?.length && /* @__PURE__ */ jsx("div", { className: "eidos-header__meta", children: meta.map((item, index) => /* @__PURE__ */ jsxs("span", { className: "eidos-header__meta-item", children: [
       item.icon && renderIcon(item.icon, "eidos-header__meta-icon"),
@@ -84,7 +86,7 @@ var Header = ({
       overflowActions.length > 0 && /* @__PURE__ */ jsx(
         Popover,
         {
-          isOpen: overflowOpen,
+          open: overflowOpen,
           onOpenChange: setOverflowOpen,
           placement: "bottom",
           maxWidth: 260,
@@ -95,7 +97,7 @@ var Header = ({
             /* @__PURE__ */ jsx(
               Button,
               {
-                icon: "ellipsis",
+                icon: Ellipsis,
                 size: "md",
                 variant: "outlined",
                 color: "secondary",
@@ -142,4 +144,4 @@ export {
   Header,
   IdentityHeader
 };
-//# sourceMappingURL=chunk-OOCCSMWM.js.map
+//# sourceMappingURL=chunk-RHWZX7PB.js.map

package/dist/chunk-RHWZX7PB.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/components/Header/Header.component.tsx","../src/components/Header/IdentityHeader.component.tsx"],"sourcesContent":["import React, { useCallback, useEffect, useLayoutEffect, useRef, useState } from 'react';\nimport type { HeaderActionProps, HeaderProps } from './Header.types';\nimport './Header.scss';\nimport { Button } from '../Button';\nimport { Popover } from '../Popover';\nimport { renderIcon } from '../../utils';\nimport { Ellipsis } from 'lucide-react';\n\nexport const Header: React.FC<HeaderProps> = ({\n  title,\n  subtitle,\n  media,\n  meta,\n  variant = 'default',\n  titleAs: TitleElement = 'h1',\n  actions,\n  collapseActionsBelow = 640,\n  actionsVisibleWhenCollapsed = 1,\n  className = '',\n}) => {\n  const classes = ['eidos-header', `eidos-header--${variant}`, className].filter(Boolean).join(' ');\n\n  const rootRef = useRef<HTMLDivElement>(null);\n  const [isNarrow, setIsNarrow] = useState(false);\n  const [overflowOpen, setOverflowOpen] = useState(false);\n\n  // Measures the header's own box rather than the viewport, so the collapse\n  // point matches the container queries in Header.scss - a viewport query\n  // would disagree with them by the width of PageLayout's navigation rail,\n  // which is itself collapsible. The 1px hero border makes this border-box\n  // reading differ from the container query's content-box one by 2px; that is\n  // far below any threshold worth caring about, and using one measurement for\n  // both the initial pass and the observer keeps it to a single code path.\n  const measure = useCallback(() => {\n    const element = rootRef.current;\n    if (!element) return;\n    setIsNarrow(element.getBoundingClientRect().width <= collapseActionsBelow);\n  }, [collapseActionsBelow]);\n\n  // `useLayoutEffect` for the first measurement specifically: ResizeObserver\n  // delivers its initial callback asynchronously, so relying on it alone\n  // would paint the full action row for a frame before collapsing it. Reading\n  // the box synchronously here collapses before paint instead. Nothing runs\n  // during SSR, so the server renders the uncollapsed row and hydration\n  // matches - the same client-only posture Navigation's `collapseBelow` has.\n  useLayoutEffect(() => {\n    if (!collapseActionsBelow) {\n      setIsNarrow(false);\n      return;\n    }\n\n    measure();\n\n    const element = rootRef.current;\n    if (!element || typeof ResizeObserver === 'undefined') return;\n\n    const observer = new ResizeObserver(measure);\n    observer.observe(element);\n    return () => observer.disconnect();\n  }, [collapseActionsBelow, measure]);\n\n  const allActions = actions ?? [];\n  const keptCount = Math.max(0, actionsVisibleWhenCollapsed);\n  const isCollapsed = isNarrow && !!collapseActionsBelow && allActions.length > keptCount;\n\n  // The *last* actions stay inline: a primary call to action is conventionally\n  // rightmost, which is also how Header's own stories order them.\n  const overflowActions = isCollapsed ? allActions.slice(0, allActions.length - keptCount) : [];\n  const inlineActions = isCollapsed ? allActions.slice(allActions.length - keptCount) : allActions;\n\n  // A portalled popover would otherwise stay on screen after the header grows\n  // back past the threshold and its trigger stops being rendered.\n  useEffect(() => {\n    if (!isCollapsed && overflowOpen) setOverflowOpen(false);\n  }, [isCollapsed, overflowOpen]);\n\n  const renderOverflowAction = (action: HeaderActionProps, index: number) => {\n    // Typed on `HTMLElement` so it satisfies both the button and the link\n    // form's handler; the action's own handler is one or the other, and is\n    // only ever called with the element it was attached to.\n    const handleClick = (event: React.MouseEvent<HTMLElement>) => {\n      (action.onClick as React.MouseEventHandler<HTMLElement> | undefined)?.(event);\n      setOverflowOpen(false);\n    };\n\n    // An icon-only action has no visible label, which is fine in a horizontal\n    // row of small buttons and useless in a vertical list. Its tooltip is\n    // already the label, so promote it rather than showing a bare glyph.\n    if (action.icon && !action.children && action.tooltip) {\n      const { icon, tooltip, ...rest } = action;\n      return (\n        <Button key={index} {...rest} size=\"md\" preIcon={icon} onClick={handleClick}>\n          {tooltip}\n        </Button>\n      );\n    }\n\n    return <Button key={index} {...action} size=\"md\" onClick={handleClick} />;\n  };\n\n  const titles = (\n    <div className=\"eidos-header__titles\">\n      <TitleElement className=\"eidos-header__title\">{title}</TitleElement>\n      {subtitle && <span className=\"eidos-header__subtitle\">{subtitle}</span>}\n      {!!meta?.length && (\n        <div className=\"eidos-header__meta\">\n          {meta.map((item, index) => (\n            <span key={index} className=\"eidos-header__meta-item\">\n              {item.icon && renderIcon(item.icon, 'eidos-header__meta-icon')}\n              {item.label && <span className=\"eidos-header__meta-label\">{item.label}</span>}\n              <span className=\"eidos-header__meta-value\">{item.value}</span>\n            </span>\n          ))}\n        </div>\n      )}\n    </div>\n  );\n\n  return (\n    <div className={classes} ref={rootRef}>\n      <div className=\"eidos-header__content\">\n        {/* The `__lead` wrapper only exists when there is media to group with\n            the titles. Media and titles need a tighter gap than titles and\n            actions do, and a flex container has a single gap - but rendering\n            the wrapper unconditionally would change the markup for every\n            existing consumer, and the `eidos-*` class names are documented as\n            targetable. */}\n        {media ? (\n          <div className=\"eidos-header__lead\">\n            <div className=\"eidos-header__media\">{media}</div>\n            {titles}\n          </div>\n        ) : (\n          titles\n        )}\n        <div className=\"eidos-header__actions\">\n          {overflowActions.length > 0 && (\n            <Popover\n              open={overflowOpen}\n              onOpenChange={setOverflowOpen}\n              placement=\"bottom\"\n              maxWidth={260}\n              // Popover puts `className` on its trigger wrapper, which is the\n              // element that actually becomes a flex item of `__actions`.\n              className=\"eidos-header__overflow-trigger\"\n              trigger={\n                // No `aria-haspopup`/`aria-expanded` here: Popover already\n                // sets both on the wrapper it renders around this button.\n                <Button\n                  icon={Ellipsis}\n                  size=\"md\"\n                  variant=\"outlined\"\n                  color=\"secondary\"\n                  aria-label={`${overflowActions.length} more actions`}\n                />\n              }\n            >\n              <div className=\"eidos-header__overflow-actions\">\n                {overflowActions.map(renderOverflowAction)}\n              </div>\n            </Popover>\n          )}\n          {inlineActions.map((action, index) => (\n            <Button key={index} size=\"md\" {...action} />\n          ))}\n        </div>\n      </div>\n    </div>\n  );\n};\n","import React from 'react';\nimport type { IdentityHeaderProps } from './IdentityHeader.types';\nimport { Header } from './Header.component';\nimport { Avatar } from '../Avatar';\nimport { devWarn } from '../../utils';\n\n/**\n * `Header` preconfigured for the \"this page is about one person or entity\"\n * shape - an avatar beside the name, supporting facts below it, actions on\n * the end - which account and profile pages share. Settings-style pages want\n * a plain `Header` instead; they have no identity to lead with.\n *\n * Deliberately thin: it pins `variant=\"hero\"`, types the avatar so consumers\n * don't have to import `Avatar` to fill the slot, and gives the shape a name\n * worth discovering. Everything else is `Header`.\n */\nexport const IdentityHeader: React.FC<IdentityHeaderProps> = ({\n  avatar,\n  media,\n  variant = 'hero',\n  className = '',\n  ...rest\n}) => {\n  if (avatar && media) {\n    devWarn(\n      'identity-header-avatar-and-media',\n      'IdentityHeader received both `avatar` and `media`. `media` takes precedence - drop `avatar` to silence this.',\n    );\n  }\n\n  const resolvedMedia = media ?? (avatar ? <Avatar size=\"lg\" {...avatar} /> : undefined);\n\n  return (\n    <Header\n      {...rest}\n      variant={variant}\n      media={resolvedMedia}\n      className={['eidos-identity-header', className].filter(Boolean).join(' ')}\n    />\n  );\n};\n"],"mappings":"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","names":["jsx"]}

package/dist/{chunk-YXRKBKFB.js → chunk-S5CMZFX6.js}

@@ -1,10 +1,10 @@
 import {
   Tooltip
-} from "./chunk-JNY7TUDS.js";
+} from "./chunk-MCPGI6EI.js";
 import {
   fullWidthModifier,
   renderIcon
-} from "./chunk-RHHZRTWM.js";
+} from "./chunk-U34INRFO.js";
 
 // src/components/Textarea/Textarea.component.tsx
 import { forwardRef, useState, useId } from "react";
@@ -127,4 +127,4 @@ Textarea.displayName = "Textarea";
 export {
   Textarea
 };
-//# sourceMappingURL=chunk-YXRKBKFB.js.map
+//# sourceMappingURL=chunk-S5CMZFX6.js.map

package/dist/{chunk-4AO5RKV5.cjs → chunk-SLHIVEFW.cjs}

@@ -1,12 +1,12 @@
 "use strict";Object.defineProperty(exports, "__esModule", {value: true}); function _nullishCoalesce(lhs, rhsFn) { if (lhs != null) { return lhs; } else { return rhsFn(); } } function _optionalChain(ops) { let lastAccessLHS = undefined; let value = ops[0]; let i = 1; while (i < ops.length) { const op = ops[i]; const fn = ops[i + 1]; i += 2; if ((op === 'optionalAccess' || op === 'optionalCall') && value == null) { return undefined; } if (op === 'access' || op === 'optionalAccess') { lastAccessLHS = value; value = fn(value); } else if (op === 'call' || op === 'optionalCall') { value = fn((...args) => value.call(lastAccessLHS, ...args)); lastAccessLHS = undefined; } } return value; }
 
-var _chunk7VJCGKVPcjs = require('./chunk-7VJCGKVP.cjs');
+var _chunk4HZIXRAJcjs = require('./chunk-4HZIXRAJ.cjs');
 
 
-var _chunkKIZVY57Hcjs = require('./chunk-KIZVY57H.cjs');
+var _chunkVXC7Z7XBcjs = require('./chunk-VXC7Z7XB.cjs');
 
 
-var _chunk35LGEPLPcjs = require('./chunk-35LGEPLP.cjs');
+var _chunkENMDOQQOcjs = require('./chunk-ENMDOQQO.cjs');
 
 // src/components/Combobox/Combobox.component.tsx
 var _react = require('react');
@@ -364,7 +364,7 @@ var Combobox = ({
   const posIconClick = hasClearableValue ? handleClearClick : handleChevronClick;
   const containerClasses = [
     "eidos-combobox",
-    fullWidth && _chunk35LGEPLPcjs.fullWidthModifier.call(void 0, "eidos-combobox"),
+    fullWidth && _chunkENMDOQQOcjs.fullWidthModifier.call(void 0, "eidos-combobox"),
     error && "eidos-combobox--error",
     disabled && "eidos-combobox--disabled",
     className
@@ -379,7 +379,7 @@ var Combobox = ({
     /* @__PURE__ */ _jsxruntime.jsxs.call(void 0, "div", { ref: containerRef, className: containerClasses, children: [
       /* @__PURE__ */ _jsxruntime.jsxs.call(void 0, "div", { ref: comboboxTriggerRef, className: "eidos-combobox-trigger", children: [
         /* @__PURE__ */ _jsxruntime.jsx.call(void 0, 
-          _chunk7VJCGKVPcjs.Input,
+          _chunk4HZIXRAJcjs.Input,
           {
             ref: inputRef,
             value: inputValue,
@@ -408,7 +408,7 @@ var Combobox = ({
           }
         ),
         /* @__PURE__ */ _jsxruntime.jsx.call(void 0, 
-          _chunkKIZVY57Hcjs.Dropdown,
+          _chunkVXC7Z7XBcjs.Dropdown,
           {
             open: isOpen,
             onOpenChange: setIsOpen,
@@ -445,4 +445,4 @@ Combobox.displayName = "Combobox";
 
 
 exports.Combobox = Combobox;
-//# sourceMappingURL=chunk-4AO5RKV5.cjs.map
+//# sourceMappingURL=chunk-SLHIVEFW.cjs.map

package/dist/{chunk-4AO5RKV5.cjs.map → chunk-SLHIVEFW.cjs.map}

@@ -1 +1 @@
-{"version":3,"sources":["/home/runner/work/eidos-ui/eidos-ui/dist/chunk-4AO5RKV5.cjs","../src/components/Combobox/Combobox.component.tsx"],"names":["label"],"mappings":"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","file":"/home/runner/work/eidos-ui/eidos-ui/dist/chunk-4AO5RKV5.cjs","sourcesContent":[null,"import React, { useState, useCallback, useRef, useEffect, useMemo, useId } from 'react';\nimport { Check, ChevronDown, X, Loader2, CircleAlert } from 'lucide-react';\nimport { Input } from '../Input/Input.component';\nimport { Dropdown } from '../Dropdown/Dropdown.component';\nimport { fullWidthModifier } from '../../utils';\nimport type { ComboboxProps, ComboboxOption } from './Combobox.types';\nimport './Combobox.scss';\n\n// ─── Types ───────────────────────────────────────────────────────────────────\n\ntype OptionEntry =\n  | { type: 'group'; group: string; key: string }\n  | { type: 'option'; option: ComboboxOption; index: number; key: string };\n\n// ─── Component ───────────────────────────────────────────────────────────────\n\nexport const Combobox: React.FC<ComboboxProps> = ({\n  options = [],\n  value,\n  defaultValue,\n  onChange,\n  onSearch,\n  placeholder = 'Search or select…',\n  loading = false,\n  loadingText = 'Searching…',\n  emptyText = 'No results found',\n  allowFreeText = false,\n  clearable = true,\n  disabled = false,\n  size = 'md',\n  label,\n  error,\n  hint,\n  fullWidth = false,\n  className = '',\n  maxHeight = '300px',\n  renderOption,\n}) => {\n  const uid = useId();\n\n  // ─── Refs ─────────────────────────────────────────────────────────────────\n\n  /** Entire combobox wrapper - used for click-outside detection */\n  const containerRef = useRef<HTMLDivElement>(null);\n\n  /** The trigger wrapper div - passed to Dropdown as externalTriggerRef for width */\n  const comboboxTriggerRef = useRef<HTMLDivElement>(null);\n\n  /** The 0-height span that IS the Dropdown trigger element - programmatically clicked to open */\n\n  /** Native input element */\n  const inputRef = useRef<HTMLInputElement>(null);\n\n  /** Focusable option divs for scroll-into-view */\n  const optionRefs = useRef<(HTMLDivElement | null)[]>([]);\n\n  /**\n   * Synchronous open-state flag.\n   * React state updates are async; reading this ref inside event handlers\n   * gives us the true current value without waiting for a re-render.\n   */\n  const isOpenRef = useRef(false);\n\n  // ─── State ────────────────────────────────────────────────────────────────\n\n  const isControlled = value !== undefined;\n\n  const getInitialInputValue = (): string => {\n    const seed = isControlled ? value : defaultValue;\n    if (!seed) return '';\n    const match = options.find((o) => o.value === seed);\n    return match ? match.label : allowFreeText ? seed : '';\n  };\n\n  const getInitialCommittedValue = (): string => {\n    return isControlled ? (value ?? '') : (defaultValue ?? '');\n  };\n\n  const [inputValue, _setInputValue] = useState<string>(getInitialInputValue);\n  const inputValueRef = useRef<string>(inputValue);\n  const setInputValue = useCallback((v: string) => {\n    inputValueRef.current = v;\n    _setInputValue(v);\n  }, []);\n\n  const [committedValue, _setCommittedValue] = useState<string>(getInitialCommittedValue);\n  const committedValueRef = useRef<string>(committedValue);\n  const setCommittedValue = useCallback((v: string) => {\n    committedValueRef.current = v;\n    _setCommittedValue(v);\n  }, []);\n\n  const [isOpen, setIsOpen] = useState(false);\n  const [focusedIndex, setFocusedIndex] = useState(-1);\n\n  // ─── Sync controlled value ────────────────────────────────────────────────\n\n  useEffect(() => {\n    if (!isControlled) return;\n    const v = value ?? '';\n    const match = options.find((o) => o.value === v);\n    const label = match ? match.label : allowFreeText ? v : '';\n    setInputValue(label);\n    setCommittedValue(v);\n  }, [value, isControlled, options, allowFreeText, setInputValue, setCommittedValue]);\n\n  // ─── Derived: filtered options ────────────────────────────────────────────\n\n  const filteredOptions = useMemo<ComboboxOption[]>(() => {\n    const q = inputValue.toLowerCase();\n    if (!q) return options;\n    return options.filter((o) => o.label.toLowerCase().includes(q));\n  }, [options, inputValue]);\n\n  // Reset focused index when the filtered set changes\n  useEffect(() => {\n    setFocusedIndex(-1);\n  }, [filteredOptions]);\n\n  // Keep optionRefs array in sync with filteredOptions length\n  useEffect(() => {\n    optionRefs.current = optionRefs.current.slice(0, filteredOptions.length);\n  }, [filteredOptions.length]);\n\n  // ─── Derived: option entries (with group headers) ─────────────────────────\n\n  const optionEntries = useMemo<OptionEntry[]>(() => {\n    const entries: OptionEntry[] = [];\n    const hasGroups = filteredOptions.some((o) => o.group);\n\n    if (!hasGroups) {\n      filteredOptions.forEach((option, index) => {\n        entries.push({ type: 'option', option, index, key: option.id });\n      });\n      return entries;\n    }\n\n    // Build ordered group map while preserving insertion order\n    const groupMap = new Map<string | null, ComboboxOption[]>();\n    for (const option of filteredOptions) {\n      const g = option.group ?? null;\n      if (!groupMap.has(g)) groupMap.set(g, []);\n      groupMap.get(g)!.push(option);\n    }\n\n    let optionIndex = 0;\n    for (const [group, opts] of groupMap.entries()) {\n      if (group !== null) {\n        entries.push({ type: 'group', group, key: `group-${group}` });\n      }\n      for (const option of opts) {\n        entries.push({ type: 'option', option, index: optionIndex++, key: option.id });\n      }\n    }\n\n    return entries;\n  }, [filteredOptions]);\n\n  // ─── Open / Close helpers ─────────────────────────────────────────────────\n\n  /**\n   * Open the dropdown by programmatically clicking the 0-height span trigger.\n   * The click bubbles to div.eidos-dropdown-trigger → Dropdown.handleTriggerClick → opens.\n   *\n   * We set isOpenRef AFTER the synthetic click so that the Dropdown's toggle\n   * handler fires while isOpenRef is still false (allowing it to open).\n   */\n  const openDropdown = useCallback(() => {\n    if (isOpenRef.current || disabled) return;\n    // This used to synthesise a click on a hidden zero-height `span` so it would\n    // bubble to the dropdown's trigger wrapper, because the overlay kept its\n    // open state private and a click was the only way to change it.\n    isOpenRef.current = true;\n    setIsOpen(true);\n  }, [disabled]);\n\n  /**\n   * Close the dropdown, optionally reverting `inputValue` to the last committed\n   * value. This used to close it by remounting the whole subtree through a\n   * changing `key`.\n   */\n  const closeDropdown = useCallback(\n    (revertInput = false) => {\n      isOpenRef.current = false;\n      setIsOpen(false);\n      setFocusedIndex(-1);\n\n      if (revertInput) {\n        const match = options.find((o) => o.value === committedValueRef.current);\n        setInputValue(match ? match.label : allowFreeText ? committedValueRef.current : '');\n      }\n    },\n    [options, allowFreeText, setInputValue],\n  );\n\n  // ─── Click-outside detection ──────────────────────────────────────────────\n\n  useEffect(() => {\n    const handleMouseDown = (e: MouseEvent) => {\n      if (!isOpenRef.current) return;\n      // defaultPrevented is set by the listbox's onMouseDown - means the user\n      // clicked an option in the portal, not truly outside the combobox.\n      if (e.defaultPrevented) return;\n      if (containerRef.current?.contains(e.target as Node)) return;\n\n      // Focus leaving to a non-focusable target: validate and close\n      isOpenRef.current = false;\n      setIsOpen(false);\n      setFocusedIndex(-1);\n\n      const current = inputValueRef.current;\n      const committed = committedValueRef.current;\n\n      if (!allowFreeText) {\n        const match = options.find((o) => o.label.toLowerCase() === current.toLowerCase());\n        if (match) {\n          if (match.value !== committed) {\n            setCommittedValue(match.value);\n            onChange?.(match.value);\n            setInputValue(match.label);\n          }\n        } else {\n          const revertMatch = options.find((o) => o.value === committed);\n          setInputValue(revertMatch ? revertMatch.label : '');\n        }\n      } else {\n        if (current !== committed) {\n          setCommittedValue(current);\n          onChange?.(current);\n        }\n      }\n    };\n\n    document.addEventListener('mousedown', handleMouseDown);\n    return () => document.removeEventListener('mousedown', handleMouseDown);\n  }, [allowFreeText, options, onChange, setCommittedValue, setInputValue]);\n\n  // ─── Input handlers ───────────────────────────────────────────────────────\n\n  const handleFocus = useCallback(() => {\n    openDropdown();\n  }, [openDropdown]);\n\n  const handleChange = useCallback(\n    (e: React.ChangeEvent<HTMLInputElement>) => {\n      const query = e.target.value;\n      setInputValue(query);\n      onSearch?.(query);\n      if (!isOpenRef.current) openDropdown();\n    },\n    [setInputValue, onSearch, openDropdown],\n  );\n\n  /**\n   * On blur, validate the typed value against options.\n   * A 0ms defer ensures a click on a posIcon button (X / chevron) inside the\n   * Input completes its onClick before we run close logic, so we can check\n   * document.activeElement reliably.\n   */\n  const handleBlur = useCallback(() => {\n    setTimeout(() => {\n      // If focus came back inside the container (e.g., posIcon button clicked),\n      // don't close or validate yet.\n      if (containerRef.current?.contains(document.activeElement)) return;\n\n      // Read both refs *inside* the deferred callback, never captured at blur\n      // time - that's the whole reason they're kept in sync by the setters.\n      // Anything can run in the gap this 0ms defer opens, including the click\n      // that caused the blur: a controlled consumer clearing `value` from\n      // another control (e.g. DataGrid's \"Clear filters\", which resets every\n      // quick filter at once) updates the refs via the sync effect, and stale\n      // captured values would then resurrect the label that was just cleared.\n      const current = inputValueRef.current;\n      const committed = committedValueRef.current;\n\n      // Close\n      isOpenRef.current = false;\n      setIsOpen(false);\n      setFocusedIndex(-1);\n\n      // Validate\n      if (!allowFreeText) {\n        const match = options.find((o) => o.label.toLowerCase() === current.toLowerCase());\n        if (match) {\n          if (match.value !== committed) {\n            setCommittedValue(match.value);\n            onChange?.(match.value);\n            setInputValue(match.label);\n          } else {\n            // Normalize the display label (fix casing)\n            setInputValue(match.label);\n          }\n        } else {\n          // No match - revert to last committed value\n          const revertMatch = options.find((o) => o.value === committed);\n          setInputValue(revertMatch ? revertMatch.label : '');\n        }\n      } else {\n        // allowFreeText: commit whatever the user typed\n        if (current !== committed) {\n          setCommittedValue(current);\n          onChange?.(current);\n        }\n      }\n    }, 0);\n  }, [allowFreeText, options, onChange, setCommittedValue, setInputValue]);\n\n  const handleKeyDown = useCallback(\n    (e: React.KeyboardEvent<HTMLInputElement>) => {\n      if (disabled) return;\n\n      switch (e.key) {\n        case 'ArrowDown':\n          e.preventDefault();\n          if (!isOpenRef.current) {\n            openDropdown();\n            setFocusedIndex(0);\n          } else {\n            setFocusedIndex((prev) => {\n              const next = prev < filteredOptions.length - 1 ? prev + 1 : 0;\n              setTimeout(\n                () =>\n                  optionRefs.current[next]?.scrollIntoView({\n                    block: 'nearest',\n                    behavior: 'smooth',\n                  }),\n                0,\n              );\n              return next;\n            });\n          }\n          break;\n\n        case 'ArrowUp':\n          e.preventDefault();\n          if (!isOpenRef.current) {\n            openDropdown();\n            setFocusedIndex(filteredOptions.length - 1);\n          } else {\n            setFocusedIndex((prev) => {\n              const next = prev > 0 ? prev - 1 : filteredOptions.length - 1;\n              setTimeout(\n                () =>\n                  optionRefs.current[next]?.scrollIntoView({\n                    block: 'nearest',\n                    behavior: 'smooth',\n                  }),\n                0,\n              );\n              return next;\n            });\n          }\n          break;\n\n        case 'Enter':\n          e.preventDefault();\n          if (isOpenRef.current && focusedIndex >= 0 && focusedIndex < filteredOptions.length) {\n            handleOptionSelect(filteredOptions[focusedIndex]);\n          } else if (allowFreeText && inputValue.trim()) {\n            const trimmed = inputValue.trim();\n            setCommittedValue(trimmed);\n            onChange?.(trimmed);\n            closeDropdown();\n          }\n          break;\n\n        case 'Escape':\n          e.preventDefault();\n          if (isOpenRef.current) {\n            closeDropdown(true /* revert */);\n          }\n          break;\n\n        default:\n          break;\n      }\n    },\n    // eslint-disable-next-line react-hooks/exhaustive-deps\n    [\n      disabled,\n      filteredOptions,\n      focusedIndex,\n      allowFreeText,\n      inputValue,\n      onChange,\n      openDropdown,\n      closeDropdown,\n      setCommittedValue,\n    ],\n  );\n\n  // ─── Option selection ─────────────────────────────────────────────────────\n\n  const handleOptionSelect = useCallback(\n    (option: ComboboxOption) => {\n      if (option.disabled) return;\n      setInputValue(option.label);\n      setCommittedValue(option.value);\n      onChange?.(option.value);\n      closeDropdown();\n      // Return focus to the input so the user can continue interacting\n      inputRef.current?.focus();\n    },\n    [onChange, closeDropdown, setInputValue, setCommittedValue],\n  );\n\n  // ─── Clear ────────────────────────────────────────────────────────────────\n\n  const handleClearClick = useCallback(() => {\n    setInputValue('');\n    setCommittedValue('');\n    onChange?.('');\n    // Re-focus input so the user can immediately start typing again\n    inputRef.current?.focus();\n  }, [onChange, setInputValue, setCommittedValue]);\n\n  // ─── Chevron toggle ───────────────────────────────────────────────────────\n\n  const handleChevronClick = useCallback(() => {\n    if (isOpenRef.current) {\n      closeDropdown();\n    } else {\n      openDropdown();\n    }\n  }, [closeDropdown, openDropdown]);\n\n  // ─── Render: individual option ────────────────────────────────────────────\n\n  const renderOptionItem = useCallback(\n    (option: ComboboxOption, index: number): React.ReactNode => {\n      const isSelected = option.value === committedValue;\n      const isFocused = index === focusedIndex;\n\n      const classes = [\n        'eidos-combobox-option',\n        isSelected && 'eidos-combobox-option--selected',\n        isFocused && 'eidos-combobox-option--focused',\n        option.disabled && 'eidos-combobox-option--disabled',\n      ]\n        .filter(Boolean)\n        .join(' ');\n\n      return (\n        <div\n          key={option.id}\n          ref={(el) => {\n            optionRefs.current[index] = el;\n          }}\n          className={classes}\n          onClick={() => handleOptionSelect(option)}\n          onMouseEnter={() => !option.disabled && setFocusedIndex(index)}\n          role=\"option\"\n          aria-selected={isSelected}\n          aria-disabled={option.disabled}\n          id={`${uid}-option-${index}`}\n        >\n          {renderOption ? (\n            renderOption(option)\n          ) : (\n            <>\n              <Check\n                className={`eidos-combobox-option-icon${\n                  !isSelected ? ' eidos-combobox-option-icon--hidden' : ''\n                }`}\n              />\n              <span className=\"eidos-combobox-option-label\">{option.label}</span>\n              {option.description && (\n                <span className=\"eidos-combobox-option-description\">{option.description}</span>\n              )}\n            </>\n          )}\n        </div>\n      );\n    },\n    [committedValue, focusedIndex, handleOptionSelect, renderOption, uid],\n  );\n\n  // ─── Render: dropdown content ─────────────────────────────────────────────\n\n  const dropdownContent = useMemo(() => {\n    if (loading) {\n      return (\n        <div className=\"eidos-combobox-loading\">\n          <Loader2 className=\"eidos-combobox-loading-icon\" />\n          <span>{loadingText}</span>\n        </div>\n      );\n    }\n\n    if (filteredOptions.length === 0) {\n      return <div className=\"eidos-combobox-empty\">{emptyText}</div>;\n    }\n\n    return optionEntries.map((entry) => {\n      if (entry.type === 'group') {\n        return (\n          <div key={entry.key} className=\"eidos-combobox-option-group-label\">\n            {entry.group}\n          </div>\n        );\n      }\n      return renderOptionItem(entry.option, entry.index);\n    });\n  }, [loading, loadingText, filteredOptions.length, emptyText, optionEntries, renderOptionItem]);\n\n  // ─── posIcon / posIconButton wiring ───────────────────────────────────────\n\n  const hasClearableValue = clearable && !!inputValue;\n  const posIcon = hasClearableValue ? X : ChevronDown;\n  const posIconClick = hasClearableValue ? handleClearClick : handleChevronClick;\n\n  // ─── CSS classes ──────────────────────────────────────────────────────────\n\n  const containerClasses = [\n    'eidos-combobox',\n    fullWidth && fullWidthModifier('eidos-combobox'),\n    error && 'eidos-combobox--error',\n    disabled && 'eidos-combobox--disabled',\n    className,\n  ]\n    .filter(Boolean)\n    .join(' ');\n\n  const maxHeightValue = typeof maxHeight === 'number' ? `${maxHeight}px` : maxHeight;\n\n  // ─── Render ───────────────────────────────────────────────────────────────\n\n  return (\n    // No ARIA on this wrapper.\n    //\n    // It carried `aria-expanded` and `aria-haspopup` while having no role at\n    // all, which is invalid - both are only meaningful on an element whose\n    // role supports them. They belong on the input, which is the combobox.\n    <div ref={containerRef} className={containerClasses}>\n      <div ref={comboboxTriggerRef} className=\"eidos-combobox-trigger\">\n        {/*\n          The Input is a direct child of eidos-combobox-trigger.\n          It is NOT inside the Dropdown trigger div, so clicking it\n          never bubbles to Dropdown.handleTriggerClick and never\n          accidentally toggles the dropdown closed mid-edit.\n        */}\n        <Input\n          ref={inputRef}\n          value={inputValue}\n          onChange={handleChange}\n          onFocus={handleFocus}\n          onBlur={handleBlur}\n          onKeyDown={handleKeyDown}\n          placeholder={placeholder}\n          disabled={disabled}\n          size={size}\n          fullWidth\n          label={label}\n          clearable={false} // we render our own clear via posIcon\n          isSelect={false}\n          posIcon={posIcon}\n          posIconButton\n          onPosIconClick={posIconClick}\n          // The same button does two jobs depending on state, so the name\n          // has to follow the icon - \"Clear\" on a chevron would be a lie.\n          posIconLabel={hasClearableValue ? 'Clear selection' : 'Show options'}\n          // The ARIA 1.2 combobox pattern: the input *is* the combobox.\n          role=\"combobox\"\n          aria-expanded={isOpen}\n          // `Combobox` renders its own error message rather than passing\n          // `error` down, so it does not inherit `Input`'s wiring and has to\n          // associate the message itself (SC 3.3.1).\n          aria-invalid={error ? true : undefined}\n          aria-describedby={error ? `${uid}-error` : undefined}\n          aria-autocomplete=\"list\"\n          // Only while the listbox exists. `aria-controls` pointing at an id\n          // that is not in the document is invalid, and that is what shipped\n          // - the listbox only renders once the dropdown opens.\n          aria-controls={isOpen ? `${uid}-listbox` : undefined}\n          aria-activedescendant={focusedIndex >= 0 ? `${uid}-option-${focusedIndex}` : undefined}\n        />\n\n        {/*\n          The Dropdown trigger is a 0-height span placed AFTER the Input\n          in the normal document flow. Its getBoundingClientRect sits at\n          exactly the bottom edge of the Input, giving the Dropdown correct\n          placement without any click-toggle collision with the Input above.\n          closeOnClickOutside and closeOnEscape are disabled because we own\n          those interactions in our mousedown listener and onKeyDown handler.\n        */}\n        <Dropdown\n          open={isOpen}\n          onOpenChange={setIsOpen}\n          // Positioning comes from `triggerRef` below; this span is only here\n          // because a trigger is required. It used to carry a ref so that\n          // `openDropdown` could click it.\n          trigger={<span className=\"eidos-combobox-dropdown-anchor\" aria-hidden=\"true\" />}\n          content={\n            <div\n              id={`${uid}-listbox`}\n              className=\"eidos-combobox-options\"\n              role=\"listbox\"\n              aria-label={label ?? 'Options'}\n              // Prevent the input from blurring when the user clicks an option,\n              // and mark this event so the click-outside handler ignores it.\n              onMouseDown={(e) => e.preventDefault()}\n            >\n              {dropdownContent}\n            </div>\n          }\n          triggerRef={comboboxTriggerRef as React.RefObject<HTMLElement | null>}\n          maxHeight={maxHeightValue}\n          autoWidth\n          closeOnClickOutside={false}\n          closeOnEscape={false}\n        />\n      </div>\n\n      {hint && !error && <span className=\"eidos-combobox-hint\">{hint}</span>}\n      {error && (\n        <span id={`${uid}-error`} className=\"eidos-combobox-error-message\">\n          <CircleAlert className=\"eidos-combobox-error-icon\" />\n          {error}\n        </span>\n      )}\n    </div>\n  );\n};\n\nCombobox.displayName = 'Combobox';\n"]}
+{"version":3,"sources":["/home/runner/work/eidos-ui/eidos-ui/dist/chunk-SLHIVEFW.cjs","../src/components/Combobox/Combobox.component.tsx"],"names":["label"],"mappings":"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","file":"/home/runner/work/eidos-ui/eidos-ui/dist/chunk-SLHIVEFW.cjs","sourcesContent":[null,"import React, { useState, useCallback, useRef, useEffect, useMemo, useId } from 'react';\nimport { Check, ChevronDown, X, Loader2, CircleAlert } from 'lucide-react';\nimport { Input } from '../Input/Input.component';\nimport { Dropdown } from '../Dropdown/Dropdown.component';\nimport { fullWidthModifier } from '../../utils';\nimport type { ComboboxProps, ComboboxOption } from './Combobox.types';\nimport './Combobox.scss';\n\n// ─── Types ───────────────────────────────────────────────────────────────────\n\ntype OptionEntry =\n  | { type: 'group'; group: string; key: string }\n  | { type: 'option'; option: ComboboxOption; index: number; key: string };\n\n// ─── Component ───────────────────────────────────────────────────────────────\n\nexport const Combobox: React.FC<ComboboxProps> = ({\n  options = [],\n  value,\n  defaultValue,\n  onChange,\n  onSearch,\n  placeholder = 'Search or select…',\n  loading = false,\n  loadingText = 'Searching…',\n  emptyText = 'No results found',\n  allowFreeText = false,\n  clearable = true,\n  disabled = false,\n  size = 'md',\n  label,\n  error,\n  hint,\n  fullWidth = false,\n  className = '',\n  maxHeight = '300px',\n  renderOption,\n}) => {\n  const uid = useId();\n\n  // ─── Refs ─────────────────────────────────────────────────────────────────\n\n  /** Entire combobox wrapper - used for click-outside detection */\n  const containerRef = useRef<HTMLDivElement>(null);\n\n  /** The trigger wrapper div - passed to Dropdown as externalTriggerRef for width */\n  const comboboxTriggerRef = useRef<HTMLDivElement>(null);\n\n  /** The 0-height span that IS the Dropdown trigger element - programmatically clicked to open */\n\n  /** Native input element */\n  const inputRef = useRef<HTMLInputElement>(null);\n\n  /** Focusable option divs for scroll-into-view */\n  const optionRefs = useRef<(HTMLDivElement | null)[]>([]);\n\n  /**\n   * Synchronous open-state flag.\n   * React state updates are async; reading this ref inside event handlers\n   * gives us the true current value without waiting for a re-render.\n   */\n  const isOpenRef = useRef(false);\n\n  // ─── State ────────────────────────────────────────────────────────────────\n\n  const isControlled = value !== undefined;\n\n  const getInitialInputValue = (): string => {\n    const seed = isControlled ? value : defaultValue;\n    if (!seed) return '';\n    const match = options.find((o) => o.value === seed);\n    return match ? match.label : allowFreeText ? seed : '';\n  };\n\n  const getInitialCommittedValue = (): string => {\n    return isControlled ? (value ?? '') : (defaultValue ?? '');\n  };\n\n  const [inputValue, _setInputValue] = useState<string>(getInitialInputValue);\n  const inputValueRef = useRef<string>(inputValue);\n  const setInputValue = useCallback((v: string) => {\n    inputValueRef.current = v;\n    _setInputValue(v);\n  }, []);\n\n  const [committedValue, _setCommittedValue] = useState<string>(getInitialCommittedValue);\n  const committedValueRef = useRef<string>(committedValue);\n  const setCommittedValue = useCallback((v: string) => {\n    committedValueRef.current = v;\n    _setCommittedValue(v);\n  }, []);\n\n  const [isOpen, setIsOpen] = useState(false);\n  const [focusedIndex, setFocusedIndex] = useState(-1);\n\n  // ─── Sync controlled value ────────────────────────────────────────────────\n\n  useEffect(() => {\n    if (!isControlled) return;\n    const v = value ?? '';\n    const match = options.find((o) => o.value === v);\n    const label = match ? match.label : allowFreeText ? v : '';\n    setInputValue(label);\n    setCommittedValue(v);\n  }, [value, isControlled, options, allowFreeText, setInputValue, setCommittedValue]);\n\n  // ─── Derived: filtered options ────────────────────────────────────────────\n\n  const filteredOptions = useMemo<ComboboxOption[]>(() => {\n    const q = inputValue.toLowerCase();\n    if (!q) return options;\n    return options.filter((o) => o.label.toLowerCase().includes(q));\n  }, [options, inputValue]);\n\n  // Reset focused index when the filtered set changes\n  useEffect(() => {\n    setFocusedIndex(-1);\n  }, [filteredOptions]);\n\n  // Keep optionRefs array in sync with filteredOptions length\n  useEffect(() => {\n    optionRefs.current = optionRefs.current.slice(0, filteredOptions.length);\n  }, [filteredOptions.length]);\n\n  // ─── Derived: option entries (with group headers) ─────────────────────────\n\n  const optionEntries = useMemo<OptionEntry[]>(() => {\n    const entries: OptionEntry[] = [];\n    const hasGroups = filteredOptions.some((o) => o.group);\n\n    if (!hasGroups) {\n      filteredOptions.forEach((option, index) => {\n        entries.push({ type: 'option', option, index, key: option.id });\n      });\n      return entries;\n    }\n\n    // Build ordered group map while preserving insertion order\n    const groupMap = new Map<string | null, ComboboxOption[]>();\n    for (const option of filteredOptions) {\n      const g = option.group ?? null;\n      if (!groupMap.has(g)) groupMap.set(g, []);\n      groupMap.get(g)!.push(option);\n    }\n\n    let optionIndex = 0;\n    for (const [group, opts] of groupMap.entries()) {\n      if (group !== null) {\n        entries.push({ type: 'group', group, key: `group-${group}` });\n      }\n      for (const option of opts) {\n        entries.push({ type: 'option', option, index: optionIndex++, key: option.id });\n      }\n    }\n\n    return entries;\n  }, [filteredOptions]);\n\n  // ─── Open / Close helpers ─────────────────────────────────────────────────\n\n  /**\n   * Open the dropdown by programmatically clicking the 0-height span trigger.\n   * The click bubbles to div.eidos-dropdown-trigger → Dropdown.handleTriggerClick → opens.\n   *\n   * We set isOpenRef AFTER the synthetic click so that the Dropdown's toggle\n   * handler fires while isOpenRef is still false (allowing it to open).\n   */\n  const openDropdown = useCallback(() => {\n    if (isOpenRef.current || disabled) return;\n    // This used to synthesise a click on a hidden zero-height `span` so it would\n    // bubble to the dropdown's trigger wrapper, because the overlay kept its\n    // open state private and a click was the only way to change it.\n    isOpenRef.current = true;\n    setIsOpen(true);\n  }, [disabled]);\n\n  /**\n   * Close the dropdown, optionally reverting `inputValue` to the last committed\n   * value. This used to close it by remounting the whole subtree through a\n   * changing `key`.\n   */\n  const closeDropdown = useCallback(\n    (revertInput = false) => {\n      isOpenRef.current = false;\n      setIsOpen(false);\n      setFocusedIndex(-1);\n\n      if (revertInput) {\n        const match = options.find((o) => o.value === committedValueRef.current);\n        setInputValue(match ? match.label : allowFreeText ? committedValueRef.current : '');\n      }\n    },\n    [options, allowFreeText, setInputValue],\n  );\n\n  // ─── Click-outside detection ──────────────────────────────────────────────\n\n  useEffect(() => {\n    const handleMouseDown = (e: MouseEvent) => {\n      if (!isOpenRef.current) return;\n      // defaultPrevented is set by the listbox's onMouseDown - means the user\n      // clicked an option in the portal, not truly outside the combobox.\n      if (e.defaultPrevented) return;\n      if (containerRef.current?.contains(e.target as Node)) return;\n\n      // Focus leaving to a non-focusable target: validate and close\n      isOpenRef.current = false;\n      setIsOpen(false);\n      setFocusedIndex(-1);\n\n      const current = inputValueRef.current;\n      const committed = committedValueRef.current;\n\n      if (!allowFreeText) {\n        const match = options.find((o) => o.label.toLowerCase() === current.toLowerCase());\n        if (match) {\n          if (match.value !== committed) {\n            setCommittedValue(match.value);\n            onChange?.(match.value);\n            setInputValue(match.label);\n          }\n        } else {\n          const revertMatch = options.find((o) => o.value === committed);\n          setInputValue(revertMatch ? revertMatch.label : '');\n        }\n      } else {\n        if (current !== committed) {\n          setCommittedValue(current);\n          onChange?.(current);\n        }\n      }\n    };\n\n    document.addEventListener('mousedown', handleMouseDown);\n    return () => document.removeEventListener('mousedown', handleMouseDown);\n  }, [allowFreeText, options, onChange, setCommittedValue, setInputValue]);\n\n  // ─── Input handlers ───────────────────────────────────────────────────────\n\n  const handleFocus = useCallback(() => {\n    openDropdown();\n  }, [openDropdown]);\n\n  const handleChange = useCallback(\n    (e: React.ChangeEvent<HTMLInputElement>) => {\n      const query = e.target.value;\n      setInputValue(query);\n      onSearch?.(query);\n      if (!isOpenRef.current) openDropdown();\n    },\n    [setInputValue, onSearch, openDropdown],\n  );\n\n  /**\n   * On blur, validate the typed value against options.\n   * A 0ms defer ensures a click on a posIcon button (X / chevron) inside the\n   * Input completes its onClick before we run close logic, so we can check\n   * document.activeElement reliably.\n   */\n  const handleBlur = useCallback(() => {\n    setTimeout(() => {\n      // If focus came back inside the container (e.g., posIcon button clicked),\n      // don't close or validate yet.\n      if (containerRef.current?.contains(document.activeElement)) return;\n\n      // Read both refs *inside* the deferred callback, never captured at blur\n      // time - that's the whole reason they're kept in sync by the setters.\n      // Anything can run in the gap this 0ms defer opens, including the click\n      // that caused the blur: a controlled consumer clearing `value` from\n      // another control (e.g. DataGrid's \"Clear filters\", which resets every\n      // quick filter at once) updates the refs via the sync effect, and stale\n      // captured values would then resurrect the label that was just cleared.\n      const current = inputValueRef.current;\n      const committed = committedValueRef.current;\n\n      // Close\n      isOpenRef.current = false;\n      setIsOpen(false);\n      setFocusedIndex(-1);\n\n      // Validate\n      if (!allowFreeText) {\n        const match = options.find((o) => o.label.toLowerCase() === current.toLowerCase());\n        if (match) {\n          if (match.value !== committed) {\n            setCommittedValue(match.value);\n            onChange?.(match.value);\n            setInputValue(match.label);\n          } else {\n            // Normalize the display label (fix casing)\n            setInputValue(match.label);\n          }\n        } else {\n          // No match - revert to last committed value\n          const revertMatch = options.find((o) => o.value === committed);\n          setInputValue(revertMatch ? revertMatch.label : '');\n        }\n      } else {\n        // allowFreeText: commit whatever the user typed\n        if (current !== committed) {\n          setCommittedValue(current);\n          onChange?.(current);\n        }\n      }\n    }, 0);\n  }, [allowFreeText, options, onChange, setCommittedValue, setInputValue]);\n\n  const handleKeyDown = useCallback(\n    (e: React.KeyboardEvent<HTMLInputElement>) => {\n      if (disabled) return;\n\n      switch (e.key) {\n        case 'ArrowDown':\n          e.preventDefault();\n          if (!isOpenRef.current) {\n            openDropdown();\n            setFocusedIndex(0);\n          } else {\n            setFocusedIndex((prev) => {\n              const next = prev < filteredOptions.length - 1 ? prev + 1 : 0;\n              setTimeout(\n                () =>\n                  optionRefs.current[next]?.scrollIntoView({\n                    block: 'nearest',\n                    behavior: 'smooth',\n                  }),\n                0,\n              );\n              return next;\n            });\n          }\n          break;\n\n        case 'ArrowUp':\n          e.preventDefault();\n          if (!isOpenRef.current) {\n            openDropdown();\n            setFocusedIndex(filteredOptions.length - 1);\n          } else {\n            setFocusedIndex((prev) => {\n              const next = prev > 0 ? prev - 1 : filteredOptions.length - 1;\n              setTimeout(\n                () =>\n                  optionRefs.current[next]?.scrollIntoView({\n                    block: 'nearest',\n                    behavior: 'smooth',\n                  }),\n                0,\n              );\n              return next;\n            });\n          }\n          break;\n\n        case 'Enter':\n          e.preventDefault();\n          if (isOpenRef.current && focusedIndex >= 0 && focusedIndex < filteredOptions.length) {\n            handleOptionSelect(filteredOptions[focusedIndex]);\n          } else if (allowFreeText && inputValue.trim()) {\n            const trimmed = inputValue.trim();\n            setCommittedValue(trimmed);\n            onChange?.(trimmed);\n            closeDropdown();\n          }\n          break;\n\n        case 'Escape':\n          e.preventDefault();\n          if (isOpenRef.current) {\n            closeDropdown(true /* revert */);\n          }\n          break;\n\n        default:\n          break;\n      }\n    },\n    // eslint-disable-next-line react-hooks/exhaustive-deps\n    [\n      disabled,\n      filteredOptions,\n      focusedIndex,\n      allowFreeText,\n      inputValue,\n      onChange,\n      openDropdown,\n      closeDropdown,\n      setCommittedValue,\n    ],\n  );\n\n  // ─── Option selection ─────────────────────────────────────────────────────\n\n  const handleOptionSelect = useCallback(\n    (option: ComboboxOption) => {\n      if (option.disabled) return;\n      setInputValue(option.label);\n      setCommittedValue(option.value);\n      onChange?.(option.value);\n      closeDropdown();\n      // Return focus to the input so the user can continue interacting\n      inputRef.current?.focus();\n    },\n    [onChange, closeDropdown, setInputValue, setCommittedValue],\n  );\n\n  // ─── Clear ────────────────────────────────────────────────────────────────\n\n  const handleClearClick = useCallback(() => {\n    setInputValue('');\n    setCommittedValue('');\n    onChange?.('');\n    // Re-focus input so the user can immediately start typing again\n    inputRef.current?.focus();\n  }, [onChange, setInputValue, setCommittedValue]);\n\n  // ─── Chevron toggle ───────────────────────────────────────────────────────\n\n  const handleChevronClick = useCallback(() => {\n    if (isOpenRef.current) {\n      closeDropdown();\n    } else {\n      openDropdown();\n    }\n  }, [closeDropdown, openDropdown]);\n\n  // ─── Render: individual option ────────────────────────────────────────────\n\n  const renderOptionItem = useCallback(\n    (option: ComboboxOption, index: number): React.ReactNode => {\n      const isSelected = option.value === committedValue;\n      const isFocused = index === focusedIndex;\n\n      const classes = [\n        'eidos-combobox-option',\n        isSelected && 'eidos-combobox-option--selected',\n        isFocused && 'eidos-combobox-option--focused',\n        option.disabled && 'eidos-combobox-option--disabled',\n      ]\n        .filter(Boolean)\n        .join(' ');\n\n      return (\n        <div\n          key={option.id}\n          ref={(el) => {\n            optionRefs.current[index] = el;\n          }}\n          className={classes}\n          onClick={() => handleOptionSelect(option)}\n          onMouseEnter={() => !option.disabled && setFocusedIndex(index)}\n          role=\"option\"\n          aria-selected={isSelected}\n          aria-disabled={option.disabled}\n          id={`${uid}-option-${index}`}\n        >\n          {renderOption ? (\n            renderOption(option)\n          ) : (\n            <>\n              <Check\n                className={`eidos-combobox-option-icon${\n                  !isSelected ? ' eidos-combobox-option-icon--hidden' : ''\n                }`}\n              />\n              <span className=\"eidos-combobox-option-label\">{option.label}</span>\n              {option.description && (\n                <span className=\"eidos-combobox-option-description\">{option.description}</span>\n              )}\n            </>\n          )}\n        </div>\n      );\n    },\n    [committedValue, focusedIndex, handleOptionSelect, renderOption, uid],\n  );\n\n  // ─── Render: dropdown content ─────────────────────────────────────────────\n\n  const dropdownContent = useMemo(() => {\n    if (loading) {\n      return (\n        <div className=\"eidos-combobox-loading\">\n          <Loader2 className=\"eidos-combobox-loading-icon\" />\n          <span>{loadingText}</span>\n        </div>\n      );\n    }\n\n    if (filteredOptions.length === 0) {\n      return <div className=\"eidos-combobox-empty\">{emptyText}</div>;\n    }\n\n    return optionEntries.map((entry) => {\n      if (entry.type === 'group') {\n        return (\n          <div key={entry.key} className=\"eidos-combobox-option-group-label\">\n            {entry.group}\n          </div>\n        );\n      }\n      return renderOptionItem(entry.option, entry.index);\n    });\n  }, [loading, loadingText, filteredOptions.length, emptyText, optionEntries, renderOptionItem]);\n\n  // ─── posIcon / posIconButton wiring ───────────────────────────────────────\n\n  const hasClearableValue = clearable && !!inputValue;\n  const posIcon = hasClearableValue ? X : ChevronDown;\n  const posIconClick = hasClearableValue ? handleClearClick : handleChevronClick;\n\n  // ─── CSS classes ──────────────────────────────────────────────────────────\n\n  const containerClasses = [\n    'eidos-combobox',\n    fullWidth && fullWidthModifier('eidos-combobox'),\n    error && 'eidos-combobox--error',\n    disabled && 'eidos-combobox--disabled',\n    className,\n  ]\n    .filter(Boolean)\n    .join(' ');\n\n  const maxHeightValue = typeof maxHeight === 'number' ? `${maxHeight}px` : maxHeight;\n\n  // ─── Render ───────────────────────────────────────────────────────────────\n\n  return (\n    // No ARIA on this wrapper.\n    //\n    // It carried `aria-expanded` and `aria-haspopup` while having no role at\n    // all, which is invalid - both are only meaningful on an element whose\n    // role supports them. They belong on the input, which is the combobox.\n    <div ref={containerRef} className={containerClasses}>\n      <div ref={comboboxTriggerRef} className=\"eidos-combobox-trigger\">\n        {/*\n          The Input is a direct child of eidos-combobox-trigger.\n          It is NOT inside the Dropdown trigger div, so clicking it\n          never bubbles to Dropdown.handleTriggerClick and never\n          accidentally toggles the dropdown closed mid-edit.\n        */}\n        <Input\n          ref={inputRef}\n          value={inputValue}\n          onChange={handleChange}\n          onFocus={handleFocus}\n          onBlur={handleBlur}\n          onKeyDown={handleKeyDown}\n          placeholder={placeholder}\n          disabled={disabled}\n          size={size}\n          fullWidth\n          label={label}\n          clearable={false} // we render our own clear via posIcon\n          isSelect={false}\n          posIcon={posIcon}\n          posIconButton\n          onPosIconClick={posIconClick}\n          // The same button does two jobs depending on state, so the name\n          // has to follow the icon - \"Clear\" on a chevron would be a lie.\n          posIconLabel={hasClearableValue ? 'Clear selection' : 'Show options'}\n          // The ARIA 1.2 combobox pattern: the input *is* the combobox.\n          role=\"combobox\"\n          aria-expanded={isOpen}\n          // `Combobox` renders its own error message rather than passing\n          // `error` down, so it does not inherit `Input`'s wiring and has to\n          // associate the message itself (SC 3.3.1).\n          aria-invalid={error ? true : undefined}\n          aria-describedby={error ? `${uid}-error` : undefined}\n          aria-autocomplete=\"list\"\n          // Only while the listbox exists. `aria-controls` pointing at an id\n          // that is not in the document is invalid, and that is what shipped\n          // - the listbox only renders once the dropdown opens.\n          aria-controls={isOpen ? `${uid}-listbox` : undefined}\n          aria-activedescendant={focusedIndex >= 0 ? `${uid}-option-${focusedIndex}` : undefined}\n        />\n\n        {/*\n          The Dropdown trigger is a 0-height span placed AFTER the Input\n          in the normal document flow. Its getBoundingClientRect sits at\n          exactly the bottom edge of the Input, giving the Dropdown correct\n          placement without any click-toggle collision with the Input above.\n          closeOnClickOutside and closeOnEscape are disabled because we own\n          those interactions in our mousedown listener and onKeyDown handler.\n        */}\n        <Dropdown\n          open={isOpen}\n          onOpenChange={setIsOpen}\n          // Positioning comes from `triggerRef` below; this span is only here\n          // because a trigger is required. It used to carry a ref so that\n          // `openDropdown` could click it.\n          trigger={<span className=\"eidos-combobox-dropdown-anchor\" aria-hidden=\"true\" />}\n          content={\n            <div\n              id={`${uid}-listbox`}\n              className=\"eidos-combobox-options\"\n              role=\"listbox\"\n              aria-label={label ?? 'Options'}\n              // Prevent the input from blurring when the user clicks an option,\n              // and mark this event so the click-outside handler ignores it.\n              onMouseDown={(e) => e.preventDefault()}\n            >\n              {dropdownContent}\n            </div>\n          }\n          triggerRef={comboboxTriggerRef as React.RefObject<HTMLElement | null>}\n          maxHeight={maxHeightValue}\n          autoWidth\n          closeOnClickOutside={false}\n          closeOnEscape={false}\n        />\n      </div>\n\n      {hint && !error && <span className=\"eidos-combobox-hint\">{hint}</span>}\n      {error && (\n        <span id={`${uid}-error`} className=\"eidos-combobox-error-message\">\n          <CircleAlert className=\"eidos-combobox-error-icon\" />\n          {error}\n        </span>\n      )}\n    </div>\n  );\n};\n\nCombobox.displayName = 'Combobox';\n"]}

package/dist/{chunk-HEX4IMLO.js → chunk-TJQNGJHP.js}

@@ -3,13 +3,13 @@ import {
 } from "./chunk-XJBWFDDE.js";
 import {
   IconButton
-} from "./chunk-75GFIQRU.js";
+} from "./chunk-JY77VJAZ.js";
 import {
   Tooltip
-} from "./chunk-JNY7TUDS.js";
+} from "./chunk-MCPGI6EI.js";
 import {
   renderIcon
-} from "./chunk-RHHZRTWM.js";
+} from "./chunk-U34INRFO.js";
 
 // src/components/Navigation/Navigation.component.tsx
 import { useCallback, useEffect, useRef, useState } from "react";
@@ -126,4 +126,4 @@ Navigation.displayName = "Navigation";
 export {
   Navigation
 };
-//# sourceMappingURL=chunk-HEX4IMLO.js.map
+//# sourceMappingURL=chunk-TJQNGJHP.js.map

package/dist/{chunk-JCKGAAPZ.cjs → chunk-TNQ2ZZ7W.cjs}

@@ -1,18 +1,18 @@
 "use strict";Object.defineProperty(exports, "__esModule", {value: true});
 
-var _chunk2T7ZMMH5cjs = require('./chunk-2T7ZMMH5.cjs');
+var _chunk7NUVLVSLcjs = require('./chunk-7NUVLVSL.cjs');
 
 
-var _chunkJ76JHN7Jcjs = require('./chunk-J76JHN7J.cjs');
+var _chunkN5NXKVFJcjs = require('./chunk-N5NXKVFJ.cjs');
 
 
 var _chunkQ3GNKF74cjs = require('./chunk-Q3GNKF74.cjs');
 
 
-var _chunk5O73AALPcjs = require('./chunk-5O73AALP.cjs');
+var _chunkGP6EEZH5cjs = require('./chunk-GP6EEZH5.cjs');
 
 
-var _chunkDA375AI6cjs = require('./chunk-DA375AI6.cjs');
+var _chunkXPG56DLQcjs = require('./chunk-XPG56DLQ.cjs');
 
 // src/components/Toolbar/Toolbar.component.tsx
 var _jsxruntime = require('react/jsx-runtime');
@@ -29,12 +29,12 @@ var Toolbar = ({
   const hasMenu = userMenu !== void 0 && userMenu.length > 0;
   const avatar = user || hasMenu ? /* @__PURE__ */ _jsxruntime.jsx.call(void 0, _chunkQ3GNKF74cjs.Avatar, { ...user, size: "sm" }) : null;
   return /* @__PURE__ */ _jsxruntime.jsxs.call(void 0, "div", { className: classes, children: [
-    breadcrumbs && /* @__PURE__ */ _jsxruntime.jsx.call(void 0, _chunk5O73AALPcjs.Breadcrumb, { ...breadcrumbs }),
+    breadcrumbs && /* @__PURE__ */ _jsxruntime.jsx.call(void 0, _chunkGP6EEZH5cjs.Breadcrumb, { ...breadcrumbs }),
     /* @__PURE__ */ _jsxruntime.jsxs.call(void 0, "div", { className: "eidos-toolbar__content", children: [
       content && /* @__PURE__ */ _jsxruntime.jsx.call(void 0, "div", { className: "eidos-toolbar__slot", children: content }),
-      cmdPaletteItems && cmdPaletteItems.length > 0 && /* @__PURE__ */ _jsxruntime.jsx.call(void 0, _chunk2T7ZMMH5cjs.CommandPalette, { trigger: true, triggerLabel: "Search", items: cmdPaletteItems }),
-      actions && actions.length > 0 && /* @__PURE__ */ _jsxruntime.jsx.call(void 0, "div", { className: "eidos-toolbar__actions", children: actions.map((action, index) => /* @__PURE__ */ _jsxruntime.jsx.call(void 0, _chunkDA375AI6cjs.IconButton, { variant: "text", size: "sm", ...action }, index)) }),
-      hasMenu ? /* @__PURE__ */ _jsxruntime.jsx.call(void 0, _chunkJ76JHN7Jcjs.Menu, { trigger: avatar, items: userMenu, minWidth: 220 }) : avatar
+      cmdPaletteItems && cmdPaletteItems.length > 0 && /* @__PURE__ */ _jsxruntime.jsx.call(void 0, _chunk7NUVLVSLcjs.CommandPalette, { trigger: true, triggerLabel: "Search", items: cmdPaletteItems }),
+      actions && actions.length > 0 && /* @__PURE__ */ _jsxruntime.jsx.call(void 0, "div", { className: "eidos-toolbar__actions", children: actions.map((action, index) => /* @__PURE__ */ _jsxruntime.jsx.call(void 0, _chunkXPG56DLQcjs.IconButton, { variant: "text", size: "sm", ...action }, index)) }),
+      hasMenu ? /* @__PURE__ */ _jsxruntime.jsx.call(void 0, _chunkN5NXKVFJcjs.Menu, { trigger: avatar, items: userMenu, minWidth: 220 }) : avatar
     ] })
   ] });
 };
@@ -42,4 +42,4 @@ var Toolbar = ({
 
 
 exports.Toolbar = Toolbar;
-//# sourceMappingURL=chunk-JCKGAAPZ.cjs.map
+//# sourceMappingURL=chunk-TNQ2ZZ7W.cjs.map

package/dist/{chunk-JCKGAAPZ.cjs.map → chunk-TNQ2ZZ7W.cjs.map}

@@ -1 +1 @@
-{"version":3,"sources":["/home/runner/work/eidos-ui/eidos-ui/dist/chunk-JCKGAAPZ.cjs","../src/components/Toolbar/Toolbar.component.tsx"],"names":[],"mappings":"AAAA;AACE;AACF,wDAA6B;AAC7B;AACE;AACF,wDAA6B;AAC7B;AACE;AACF,wDAA6B;AAC7B;AACE;AACF,wDAA6B;AAC7B;AACE;AACF,wDAA6B;AAC7B;AACA;ACUmC,+CAAA;AAjB5B,IAAM,QAAA,EAAkC,CAAC;AAAA,EAC9C,WAAA;AAAA,EACA,OAAA;AAAA,EACA,IAAA;AAAA,EACA,QAAA;AAAA,EACA,eAAA;AAAA,EACA,OAAA;AAAA,EACA,UAAA,EAAY;AACd,CAAA,EAAA,GAAM;AACJ,EAAA,MAAM,QAAA,EAAU,CAAC,eAAA,EAAiB,SAAS,CAAA,CAAE,MAAA,CAAO,OAAO,CAAA,CAAE,IAAA,CAAK,GAAG,CAAA;AAOrE,EAAA,MAAM,QAAA,EAAU,SAAA,IAAa,KAAA,EAAA,GAAa,QAAA,CAAS,OAAA,EAAS,CAAA;AAC5D,EAAA,MAAM,OAAA,EAAS,KAAA,GAAQ,QAAA,kBAAU,6BAAA,wBAAC,EAAA,EAAQ,GAAG,IAAA,EAAM,IAAA,EAAK,KAAA,CAAK,EAAA,EAAK,IAAA;AAElE,EAAA,uBACE,8BAAA,KAAC,EAAA,EAAI,SAAA,EAAW,OAAA,EACb,QAAA,EAAA;AAAA,IAAA,YAAA,mBAAe,6BAAA,4BAAC,EAAA,EAAY,GAAG,YAAA,CAAa,CAAA;AAAA,oBAC7C,8BAAA,KAAC,EAAA,EAAI,SAAA,EAAU,wBAAA,EACZ,QAAA,EAAA;AAAA,MAAA,QAAA,mBAAW,6BAAA,KAAC,EAAA,EAAI,SAAA,EAAU,qBAAA,EAAuB,QAAA,EAAA,QAAA,CAAQ,CAAA;AAAA,MACzD,gBAAA,GAAmB,eAAA,CAAgB,OAAA,EAAS,EAAA,mBAC3C,6BAAA,gCAAC,EAAA,EAAe,OAAA,EAAO,IAAA,EAAC,YAAA,EAAa,QAAA,EAAS,KAAA,EAAO,gBAAA,CAAiB,CAAA;AAAA,MAEvE,QAAA,GAAW,OAAA,CAAQ,OAAA,EAAS,EAAA,mBAC3B,6BAAA,KAAC,EAAA,EAAI,SAAA,EAAU,wBAAA,EACZ,QAAA,EAAA,OAAA,CAAQ,GAAA,CAAI,CAAC,MAAA,EAAQ,KAAA,EAAA,mBACpB,6BAAA,4BAAC,EAAA,EAAuB,OAAA,EAAQ,MAAA,EAAO,IAAA,EAAK,IAAA,EAAM,GAAG,OAAA,CAAA,EAApC,KAA4C,CAC9D,EAAA,CACH,CAAA;AAAA,MAED,QAAA,kBAAU,6BAAA,sBAAC,EAAA,EAAK,OAAA,EAAS,MAAA,EAAQ,KAAA,EAAO,QAAA,EAAU,QAAA,EAAU,IAAA,CAAK,EAAA,EAAK;AAAA,IAAA,EAAA,CACzE;AAAA,EAAA,EAAA,CACF,CAAA;AAEJ,CAAA;ADPA;AACA;AACE;AACF,0BAAC","file":"/home/runner/work/eidos-ui/eidos-ui/dist/chunk-JCKGAAPZ.cjs","sourcesContent":[null,"import React from 'react';\nimport type { ToolbarProps } from './Toolbar.types';\nimport './Toolbar.scss';\nimport { IconButton } from '../Button';\nimport { Breadcrumb } from '../Breadcrumb';\nimport { Avatar } from '../Avatar';\nimport { Menu } from '../Menu';\nimport { CommandPalette } from '../CommandPalette';\n\nexport const Toolbar: React.FC<ToolbarProps> = ({\n  breadcrumbs,\n  actions,\n  user,\n  userMenu,\n  cmdPaletteItems,\n  content,\n  className = '',\n}) => {\n  const classes = ['eidos-toolbar', className].filter(Boolean).join(' ');\n\n  // The avatar is the menu's trigger when there are items to open, and a\n  // plain mark when there aren't - `Menu` with an empty `items` array would\n  // render an interactive, focusable trigger that opens nothing. A menu\n  // given without a `user` still needs a trigger, and `Avatar` already\n  // falls back to a generic user icon when it has neither `name` nor `src`.\n  const hasMenu = userMenu !== undefined && userMenu.length > 0;\n  const avatar = user || hasMenu ? <Avatar {...user} size=\"sm\" /> : null;\n\n  return (\n    <div className={classes}>\n      {breadcrumbs && <Breadcrumb {...breadcrumbs} />}\n      <div className=\"eidos-toolbar__content\">\n        {content && <div className=\"eidos-toolbar__slot\">{content}</div>}\n        {cmdPaletteItems && cmdPaletteItems.length > 0 && (\n          <CommandPalette trigger triggerLabel=\"Search\" items={cmdPaletteItems} />\n        )}\n        {actions && actions.length > 0 && (\n          <div className=\"eidos-toolbar__actions\">\n            {actions.map((action, index) => (\n              <IconButton key={index} variant=\"text\" size=\"sm\" {...action} />\n            ))}\n          </div>\n        )}\n        {hasMenu ? <Menu trigger={avatar} items={userMenu} minWidth={220} /> : avatar}\n      </div>\n    </div>\n  );\n};\n"]}
+{"version":3,"sources":["/home/runner/work/eidos-ui/eidos-ui/dist/chunk-TNQ2ZZ7W.cjs","../src/components/Toolbar/Toolbar.component.tsx"],"names":[],"mappings":"AAAA;AACE;AACF,wDAA6B;AAC7B;AACE;AACF,wDAA6B;AAC7B;AACE;AACF,wDAA6B;AAC7B;AACE;AACF,wDAA6B;AAC7B;AACE;AACF,wDAA6B;AAC7B;AACA;ACUmC,+CAAA;AAjB5B,IAAM,QAAA,EAAkC,CAAC;AAAA,EAC9C,WAAA;AAAA,EACA,OAAA;AAAA,EACA,IAAA;AAAA,EACA,QAAA;AAAA,EACA,eAAA;AAAA,EACA,OAAA;AAAA,EACA,UAAA,EAAY;AACd,CAAA,EAAA,GAAM;AACJ,EAAA,MAAM,QAAA,EAAU,CAAC,eAAA,EAAiB,SAAS,CAAA,CAAE,MAAA,CAAO,OAAO,CAAA,CAAE,IAAA,CAAK,GAAG,CAAA;AAOrE,EAAA,MAAM,QAAA,EAAU,SAAA,IAAa,KAAA,EAAA,GAAa,QAAA,CAAS,OAAA,EAAS,CAAA;AAC5D,EAAA,MAAM,OAAA,EAAS,KAAA,GAAQ,QAAA,kBAAU,6BAAA,wBAAC,EAAA,EAAQ,GAAG,IAAA,EAAM,IAAA,EAAK,KAAA,CAAK,EAAA,EAAK,IAAA;AAElE,EAAA,uBACE,8BAAA,KAAC,EAAA,EAAI,SAAA,EAAW,OAAA,EACb,QAAA,EAAA;AAAA,IAAA,YAAA,mBAAe,6BAAA,4BAAC,EAAA,EAAY,GAAG,YAAA,CAAa,CAAA;AAAA,oBAC7C,8BAAA,KAAC,EAAA,EAAI,SAAA,EAAU,wBAAA,EACZ,QAAA,EAAA;AAAA,MAAA,QAAA,mBAAW,6BAAA,KAAC,EAAA,EAAI,SAAA,EAAU,qBAAA,EAAuB,QAAA,EAAA,QAAA,CAAQ,CAAA;AAAA,MACzD,gBAAA,GAAmB,eAAA,CAAgB,OAAA,EAAS,EAAA,mBAC3C,6BAAA,gCAAC,EAAA,EAAe,OAAA,EAAO,IAAA,EAAC,YAAA,EAAa,QAAA,EAAS,KAAA,EAAO,gBAAA,CAAiB,CAAA;AAAA,MAEvE,QAAA,GAAW,OAAA,CAAQ,OAAA,EAAS,EAAA,mBAC3B,6BAAA,KAAC,EAAA,EAAI,SAAA,EAAU,wBAAA,EACZ,QAAA,EAAA,OAAA,CAAQ,GAAA,CAAI,CAAC,MAAA,EAAQ,KAAA,EAAA,mBACpB,6BAAA,4BAAC,EAAA,EAAuB,OAAA,EAAQ,MAAA,EAAO,IAAA,EAAK,IAAA,EAAM,GAAG,OAAA,CAAA,EAApC,KAA4C,CAC9D,EAAA,CACH,CAAA;AAAA,MAED,QAAA,kBAAU,6BAAA,sBAAC,EAAA,EAAK,OAAA,EAAS,MAAA,EAAQ,KAAA,EAAO,QAAA,EAAU,QAAA,EAAU,IAAA,CAAK,EAAA,EAAK;AAAA,IAAA,EAAA,CACzE;AAAA,EAAA,EAAA,CACF,CAAA;AAEJ,CAAA;ADPA;AACA;AACE;AACF,0BAAC","file":"/home/runner/work/eidos-ui/eidos-ui/dist/chunk-TNQ2ZZ7W.cjs","sourcesContent":[null,"import React from 'react';\nimport type { ToolbarProps } from './Toolbar.types';\nimport './Toolbar.scss';\nimport { IconButton } from '../Button';\nimport { Breadcrumb } from '../Breadcrumb';\nimport { Avatar } from '../Avatar';\nimport { Menu } from '../Menu';\nimport { CommandPalette } from '../CommandPalette';\n\nexport const Toolbar: React.FC<ToolbarProps> = ({\n  breadcrumbs,\n  actions,\n  user,\n  userMenu,\n  cmdPaletteItems,\n  content,\n  className = '',\n}) => {\n  const classes = ['eidos-toolbar', className].filter(Boolean).join(' ');\n\n  // The avatar is the menu's trigger when there are items to open, and a\n  // plain mark when there aren't - `Menu` with an empty `items` array would\n  // render an interactive, focusable trigger that opens nothing. A menu\n  // given without a `user` still needs a trigger, and `Avatar` already\n  // falls back to a generic user icon when it has neither `name` nor `src`.\n  const hasMenu = userMenu !== undefined && userMenu.length > 0;\n  const avatar = user || hasMenu ? <Avatar {...user} size=\"sm\" /> : null;\n\n  return (\n    <div className={classes}>\n      {breadcrumbs && <Breadcrumb {...breadcrumbs} />}\n      <div className=\"eidos-toolbar__content\">\n        {content && <div className=\"eidos-toolbar__slot\">{content}</div>}\n        {cmdPaletteItems && cmdPaletteItems.length > 0 && (\n          <CommandPalette trigger triggerLabel=\"Search\" items={cmdPaletteItems} />\n        )}\n        {actions && actions.length > 0 && (\n          <div className=\"eidos-toolbar__actions\">\n            {actions.map((action, index) => (\n              <IconButton key={index} variant=\"text\" size=\"sm\" {...action} />\n            ))}\n          </div>\n        )}\n        {hasMenu ? <Menu trigger={avatar} items={userMenu} minWidth={220} /> : avatar}\n      </div>\n    </div>\n  );\n};\n"]}