eidos-ui 4.0.0 → 4.1.0

package/dist/{chunk-PVNBH7XN.cjs → chunk-JO4NDJRA.cjs}

@@ -1,5 +1,6 @@
 "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 _chunkIXZMKIV5cjs = require('./chunk-IXZMKIV5.cjs');
 
 
 
@@ -13,12 +14,18 @@
 
 
 
-var _chunkQDZVZY53cjs = require('./chunk-QDZVZY53.cjs');
+
+
+
+var _chunkO45W57Y4cjs = require('./chunk-O45W57Y4.cjs');
 
 
 var _chunkOZZHOEN5cjs = require('./chunk-OZZHOEN5.cjs');
 
 
+var _chunkE7BFBU6Kcjs = require('./chunk-E7BFBU6K.cjs');
+
+
 var _chunkBKUZF7CWcjs = require('./chunk-BKUZF7CW.cjs');
 
 
@@ -39,9 +46,25 @@ var _chunkRZMQCVAScjs = require('./chunk-RZMQCVAS.cjs');
 
 // src/components/ThemeEditor/ThemeEditor.component.tsx
 var _react = require('react');
+
+
+
+
+
+
+
+
 var _lucidereact = require('lucide-react');
 var _jsxruntime = require('react/jsx-runtime');
-var PAGE_SURFACE = _chunkQDZVZY53cjs.CONTRAST_LIGHT;
+var PAGE_SURFACE = {
+  light: _chunkO45W57Y4cjs.CONTRAST_LIGHT,
+  dark: _chunkO45W57Y4cjs.DARK_SURFACE
+};
+var SCHEME_OPTIONS = [
+  { value: "light", label: "Light" },
+  { value: "dark", label: "Dark" },
+  { value: "system", label: "System" }
+];
 var EDGE_MIN_RATIO = 1.5;
 var COLOR_LABELS = {
   primary: "Primary",
@@ -58,7 +81,7 @@ var FONT_STACKS = [
   // matches an option exactly. A hand-copied shorter stack did not match, and
   // the row fell back to showing a synthetic "custom" entry instead of the
   // name of the font actually in use.
-  { label: "Plus Jakarta Sans (theme default)", value: _chunkQDZVZY53cjs.defaultTheme.typography.fontFamily },
+  { label: "Plus Jakarta Sans (theme default)", value: _chunkO45W57Y4cjs.defaultTheme.typography.fontFamily },
   { label: "System UI", value: "system-ui, -apple-system, 'Segoe UI', sans-serif" },
   { label: "Helvetica / Arial", value: "Helvetica, Arial, sans-serif" },
   { label: "Georgia", value: "Georgia, 'Times New Roman', serif" },
@@ -66,7 +89,7 @@ var FONT_STACKS = [
   { label: "Serif (generic)", value: "serif" }
 ];
 var MONO_STACKS = [
-  { label: "JetBrains Mono (theme default)", value: _chunkQDZVZY53cjs.defaultTheme.typography.monoFamily },
+  { label: "JetBrains Mono (theme default)", value: _chunkO45W57Y4cjs.defaultTheme.typography.monoFamily },
   { label: "Menlo / Consolas", value: "Menlo, Consolas, monospace" },
   { label: "Courier New", value: "'Courier New', Courier, monospace" },
   { label: "Monospace (generic)", value: "monospace" }
@@ -86,20 +109,21 @@ var GRADE_BADGE = {
   "aa-large": { label: "Too low for body text", icon: _lucidereact.TriangleAlert },
   fail: { label: "Fails AA", icon: _lucidereact.CircleX }
 };
-var diagnose = (key, base, explicitContrast) => {
+var diagnose = (key, base, explicitContrast, scheme) => {
+  const page = PAGE_SURFACE[scheme];
   if (!isFill(key)) {
-    const ratio2 = _chunkQDZVZY53cjs.contrastRatio.call(void 0, base, PAGE_SURFACE);
+    const ratio2 = _chunkO45W57Y4cjs.contrastRatio.call(void 0, base, page);
     const grade2 = gradeFor(ratio2);
     return {
       grade: grade2,
       ratio: ratio2,
-      detail: `Link text on the page background: ${ratio2.toFixed(2)}:1 against white.${_nullishCoalesce(GRADE_CAVEAT[grade2], () => ( ""))}`
+      detail: `Link text on the page background: ${ratio2.toFixed(2)}:1 against the ${scheme} page.${_nullishCoalesce(GRADE_CAVEAT[grade2], () => ( ""))}`
     };
   }
-  const foreground = _nullishCoalesce(explicitContrast, () => ( _chunkQDZVZY53cjs.pickContrast.call(void 0, base)));
-  const ratio = _chunkQDZVZY53cjs.contrastRatio.call(void 0, base, foreground);
-  const name = foreground.toLowerCase() === _chunkQDZVZY53cjs.CONTRAST_DARK ? "dark" : "white";
-  const edge = _chunkQDZVZY53cjs.contrastRatio.call(void 0, base, PAGE_SURFACE);
+  const foreground = _nullishCoalesce(explicitContrast, () => ( _chunkO45W57Y4cjs.pickContrast.call(void 0, base)));
+  const ratio = _chunkO45W57Y4cjs.contrastRatio.call(void 0, base, foreground);
+  const name = foreground.toLowerCase() === _chunkO45W57Y4cjs.CONTRAST_DARK ? "dark" : "white";
+  const edge = _chunkO45W57Y4cjs.contrastRatio.call(void 0, base, page);
   const grade = gradeFor(ratio);
   return {
     grade,
@@ -121,14 +145,14 @@ var FontRow = ({
   const inputRef = _react.useRef.call(void 0, null);
   const [error, setError] = _react.useState.call(void 0, null);
   const [, onFontsLoaded] = _react.useReducer.call(void 0, (count) => count + 1, 0);
-  _react.useEffect.call(void 0, () => _chunkQDZVZY53cjs.subscribeToFontLoads.call(void 0, onFontsLoaded), [onFontsLoaded]);
+  _react.useEffect.call(void 0, () => _chunkO45W57Y4cjs.subscribeToFontLoads.call(void 0, onFontsLoaded), [onFontsLoaded]);
   const baseOptions = _react.useMemo.call(void 0, () => {
     const known = options.some((o) => o.value === value);
     return known ? options : [...options, { label: `${firstFamily(value)} (custom)`, value }];
   }, [options, value]);
   const selectOptions = baseOptions.map((option) => ({
     id: option.value,
-    label: _chunkQDZVZY53cjs.isFontStackAvailable.call(void 0, option.value) ? option.label : `${option.label} - not installed`,
+    label: _chunkO45W57Y4cjs.isFontStackAvailable.call(void 0, option.value) ? option.label : `${option.label} - not installed`,
     value: option.value
   }));
   const handleFile = _react.useCallback.call(void 0, 
@@ -136,8 +160,8 @@ var FontRow = ({
       if (!file) return;
       setError(null);
       try {
-        const family = await _chunkQDZVZY53cjs.registerFontFile.call(void 0, file);
-        const stack = _chunkQDZVZY53cjs.toFontStack.call(void 0, family, mono);
+        const family = await _chunkO45W57Y4cjs.registerFontFile.call(void 0, file);
+        const stack = _chunkO45W57Y4cjs.toFontStack.call(void 0, family, mono);
         onUploaded({ label: `${family} (this session)`, value: stack }, file, family);
         onChange(stack);
       } catch (cause) {
@@ -148,7 +172,7 @@ var FontRow = ({
     },
     [mono, onChange, onUploaded]
   );
-  const unavailable = !_chunkQDZVZY53cjs.isFontStackAvailable.call(void 0, value);
+  const unavailable = !_chunkO45W57Y4cjs.isFontStackAvailable.call(void 0, value);
   return /* @__PURE__ */ _jsxruntime.jsxs.call(void 0, "div", { className: "eidos-theme-editor-row eidos-theme-editor-row--wide", children: [
     /* @__PURE__ */ _jsxruntime.jsx.call(void 0, "span", { className: "eidos-theme-editor-row__label", children: label }),
     /* @__PURE__ */ _jsxruntime.jsx.call(void 0, "div", { className: "eidos-theme-editor-row__control", children: /* @__PURE__ */ _jsxruntime.jsx.call(void 0, 
@@ -195,7 +219,7 @@ var FontRow = ({
         {
           ref: inputRef,
           type: "file",
-          accept: _chunkQDZVZY53cjs.FONT_ACCEPT,
+          accept: _chunkO45W57Y4cjs.FONT_ACCEPT,
           className: "eidos-theme-editor-file",
           tabIndex: -1,
           "aria-hidden": "true",
@@ -209,7 +233,7 @@ var FontRow = ({
   ] });
 };
 var ThemeEditor = ({
-  colors = _chunkQDZVZY53cjs.THEME_COLOR_KEYS,
+  colors = _chunkO45W57Y4cjs.THEME_COLOR_KEYS,
   fontOptions = FONT_STACKS,
   monoFontOptions = MONO_STACKS,
   allowFontUpload = true,
@@ -219,13 +243,26 @@ var ThemeEditor = ({
   hideCssExport = false,
   className
 }) => {
-  const { theme, resolvedTheme, setTheme, updateTheme, resetTheme, isDefault, toCss } = _chunkQDZVZY53cjs.useTheme.call(void 0, );
+  const {
+    theme,
+    resolvedTheme,
+    setTheme,
+    updateTheme,
+    resetTheme,
+    isDefault,
+    toCss,
+    colorScheme,
+    resolvedColorScheme,
+    setColorScheme
+  } = _chunkO45W57Y4cjs.useTheme.call(void 0, );
   const [copied, setCopied] = _react.useState.call(void 0, false);
+  const hasDarkOverrides = Object.keys(_nullishCoalesce(_optionalChain([theme, 'access', _14 => _14.dark, 'optionalAccess', _15 => _15.colors]), () => ( {}))).length > 0;
+  const [separateDark, setSeparateDark] = _react.useState.call(void 0, hasDarkOverrides);
   const [uploaded, setUploaded] = _react.useState.call(void 0, []);
   const [monoUploaded, setMonoUploaded] = _react.useState.call(void 0, []);
   const setColor = _react.useCallback.call(void 0, 
     (key, hex) => {
-      const current = _optionalChain([theme, 'access', _14 => _14.colors, 'optionalAccess', _15 => _15[key]]);
+      const current = _optionalChain([theme, 'access', _16 => _16.colors, 'optionalAccess', _17 => _17[key]]);
       const pinned = typeof current === "object" ? current.contrast : void 0;
       updateTheme({ colors: { [key]: pinned ? { base: hex, contrast: pinned } : hex } });
     },
@@ -239,12 +276,43 @@ var ThemeEditor = ({
     },
     [theme, setTheme]
   );
+  const setDarkColor = _react.useCallback.call(void 0, 
+    (key, hex) => updateTheme({ dark: { colors: { [key]: hex } } }),
+    [updateTheme]
+  );
+  const resetDarkColor = _react.useCallback.call(void 0, 
+    (key) => {
+      const nextDark = { ..._optionalChain([theme, 'access', _18 => _18.dark, 'optionalAccess', _19 => _19.colors]) };
+      delete nextDark[key];
+      setTheme({ ...theme, dark: { colors: nextDark } });
+    },
+    [theme, setTheme]
+  );
+  const toggleSeparateDark = _react.useCallback.call(void 0, 
+    (on) => {
+      setSeparateDark(on);
+      if (!on && hasDarkOverrides) setTheme({ ...theme, dark: { colors: {} } });
+    },
+    [hasDarkOverrides, setTheme, theme]
+  );
   const diagnostics = _react.useMemo.call(void 0, 
     () => colors.map((key) => {
-      const { base, contrast } = resolvedTheme.colors[key];
-      return { key, base, ...diagnose(key, base, contrast) };
+      const palette = resolvedColorScheme === "dark" ? resolvedTheme.dark.colors : resolvedTheme.colors;
+      const { base, contrast } = palette[key];
+      const diagnostic = diagnose(key, base, contrast, resolvedColorScheme);
+      const lightBase = resolvedTheme.colors[key].base;
+      return {
+        key,
+        base: lightBase,
+        darkBase: resolvedTheme.dark.colors[key].base,
+        ...diagnostic,
+        // In dark the picker still shows the colour as picked, but what is
+        // graded - and rendered - is its dark tone. Name it, or the badge
+        // appears to describe a colour that is not on screen.
+        detail: resolvedColorScheme === "dark" && base !== lightBase ? `In dark this renders as ${base}. ${diagnostic.detail}` : diagnostic.detail
+      };
     }),
-    [colors, resolvedTheme]
+    [colors, resolvedTheme, resolvedColorScheme]
   );
   const failing = diagnostics.filter((d) => d.grade === "fail");
   const invisible = diagnostics.filter((d) => d.edgeWarning);
@@ -254,7 +322,7 @@ var ThemeEditor = ({
       setCopied(true);
       setTimeout(() => setCopied(false), 1600);
     };
-    if (_optionalChain([navigator, 'access', _16 => _16.clipboard, 'optionalAccess', _17 => _17.writeText])) {
+    if (_optionalChain([navigator, 'access', _20 => _20.clipboard, 'optionalAccess', _21 => _21.writeText])) {
       navigator.clipboard.writeText(css).then(done, done);
       return;
     }
@@ -275,14 +343,52 @@ var ThemeEditor = ({
         "."
       ] })
     ] }),
+    /* @__PURE__ */ _jsxruntime.jsxs.call(void 0, _chunkV5RS3JZNcjs.Card, { variant: "outlined", padding: "lg", className: "eidos-theme-editor-section", children: [
+      /* @__PURE__ */ _jsxruntime.jsxs.call(void 0, "div", { className: "eidos-theme-editor-section__header", children: [
+        /* @__PURE__ */ _jsxruntime.jsx.call(void 0, "span", { className: "eidos-theme-editor-section__title", id: "eidos-theme-editor-scheme", children: "Colour scheme" }),
+        /* @__PURE__ */ _jsxruntime.jsx.call(void 0, "span", { className: "eidos-theme-editor-section__hint", children: "Your colours apply to both schemes. In dark each one is lightened until it reads on the dark page, with dark text on it - turn on separate dark colours to pick them yourself." })
+      ] }),
+      /* @__PURE__ */ _jsxruntime.jsxs.call(void 0, "div", { className: "eidos-theme-editor-rows", children: [
+        /* @__PURE__ */ _jsxruntime.jsxs.call(void 0, "div", { className: "eidos-theme-editor-row eidos-theme-editor-row--wide", children: [
+          /* @__PURE__ */ _jsxruntime.jsx.call(void 0, "span", { className: "eidos-theme-editor-row__label", children: "Scheme" }),
+          /* @__PURE__ */ _jsxruntime.jsx.call(void 0, "div", { className: "eidos-theme-editor-row__control", children: /* @__PURE__ */ _jsxruntime.jsx.call(void 0, 
+            _chunkE7BFBU6Kcjs.SegmentedControl,
+            {
+              options: SCHEME_OPTIONS,
+              value: colorScheme,
+              onChange: (value) => setColorScheme(value),
+              "aria-labelledby": "eidos-theme-editor-scheme",
+              size: "sm"
+            }
+          ) })
+        ] }),
+        /* @__PURE__ */ _jsxruntime.jsxs.call(void 0, "div", { className: "eidos-theme-editor-row eidos-theme-editor-row--wide", children: [
+          /* @__PURE__ */ _jsxruntime.jsx.call(void 0, "span", { className: "eidos-theme-editor-row__label" }),
+          /* @__PURE__ */ _jsxruntime.jsx.call(void 0, "div", { className: "eidos-theme-editor-row__control", children: /* @__PURE__ */ _jsxruntime.jsx.call(void 0, 
+            _chunkIXZMKIV5cjs.Switch,
+            {
+              label: "Separate dark colours",
+              checked: separateDark,
+              onChange: (event) => toggleSeparateDark(event.target.checked),
+              size: "sm"
+            }
+          ) })
+        ] })
+      ] })
+    ] }),
     /* @__PURE__ */ _jsxruntime.jsxs.call(void 0, _chunkV5RS3JZNcjs.Card, { variant: "outlined", padding: "lg", className: "eidos-theme-editor-section", children: [
       /* @__PURE__ */ _jsxruntime.jsxs.call(void 0, "div", { className: "eidos-theme-editor-section__header", children: [
         /* @__PURE__ */ _jsxruntime.jsx.call(void 0, "span", { className: "eidos-theme-editor-section__title", children: "Colours" }),
-        /* @__PURE__ */ _jsxruntime.jsx.call(void 0, "span", { className: "eidos-theme-editor-section__hint", children: "Shades, tints and foregrounds are derived from each base colour." })
+        /* @__PURE__ */ _jsxruntime.jsxs.call(void 0, "span", { className: "eidos-theme-editor-section__hint", children: [
+          "Shades, tints and foregrounds are derived from each base colour. Contrast is measured against the ",
+          resolvedColorScheme,
+          " page."
+        ] })
       ] }),
-      /* @__PURE__ */ _jsxruntime.jsx.call(void 0, "div", { className: "eidos-theme-editor-rows", children: diagnostics.map(({ key, base, grade, ratio, detail, edgeWarning }) => {
+      /* @__PURE__ */ _jsxruntime.jsx.call(void 0, "div", { className: "eidos-theme-editor-rows", children: diagnostics.map(({ key, base, darkBase, grade, ratio, detail, edgeWarning }) => {
         const badge = GRADE_BADGE[grade];
-        const overridden = _optionalChain([theme, 'access', _18 => _18.colors, 'optionalAccess', _19 => _19[key]]) !== void 0;
+        const overridden = _optionalChain([theme, 'access', _22 => _22.colors, 'optionalAccess', _23 => _23[key]]) !== void 0;
+        const darkOverridden = _optionalChain([theme, 'access', _24 => _24.dark, 'optionalAccess', _25 => _25.colors, 'optionalAccess', _26 => _26[key]]) !== void 0;
         return /* @__PURE__ */ _jsxruntime.jsxs.call(void 0, "div", { className: "eidos-theme-editor-row", children: [
           /* @__PURE__ */ _jsxruntime.jsx.call(void 0, "span", { className: "eidos-theme-editor-row__label", children: COLOR_LABELS[key] }),
           /* @__PURE__ */ _jsxruntime.jsx.call(void 0, 
@@ -294,6 +400,15 @@ var ThemeEditor = ({
               ariaLabel: COLOR_LABELS[key]
             }
           ),
+          separateDark && /* @__PURE__ */ _jsxruntime.jsx.call(void 0, 
+            _chunkSJPCBRKRcjs.ColorPicker,
+            {
+              value: darkBase,
+              onChange: (hex) => setDarkColor(key, hex),
+              size: "md",
+              ariaLabel: `${COLOR_LABELS[key]} (dark)`
+            }
+          ),
           /* @__PURE__ */ _jsxruntime.jsxs.call(void 0, "div", { className: "eidos-theme-editor-row__diagnostics", children: [
             /* @__PURE__ */ _jsxruntime.jsx.call(void 0, _chunkRZMQCVAScjs.Tooltip, { message: detail, children: /* @__PURE__ */ _jsxruntime.jsxs.call(void 0, "span", { className: `eidos-theme-editor-badge eidos-theme-editor-badge--${grade}`, children: [
               /* @__PURE__ */ _jsxruntime.jsx.call(void 0, badge.icon, { className: "eidos-theme-editor-badge__icon" }),
@@ -304,19 +419,34 @@ var ThemeEditor = ({
               "Invisible on page"
             ] }) })
           ] }),
-          /* @__PURE__ */ _jsxruntime.jsx.call(void 0, "div", { className: "eidos-theme-editor-row__actions", children: /* @__PURE__ */ _jsxruntime.jsx.call(void 0, 
-            _chunkNSA7ASZ7cjs.IconButton,
-            {
-              icon: _lucidereact.RotateCcw,
-              variant: "text",
-              color: "secondary",
-              size: "sm",
-              disabled: !overridden,
-              onClick: () => resetColor(key),
-              tooltip: overridden ? `Reset ${COLOR_LABELS[key]} to the preset` : "Unchanged",
-              "aria-label": `Reset ${COLOR_LABELS[key]}`
-            }
-          ) })
+          /* @__PURE__ */ _jsxruntime.jsxs.call(void 0, "div", { className: "eidos-theme-editor-row__actions", children: [
+            /* @__PURE__ */ _jsxruntime.jsx.call(void 0, 
+              _chunkNSA7ASZ7cjs.IconButton,
+              {
+                icon: _lucidereact.RotateCcw,
+                variant: "text",
+                color: "secondary",
+                size: "sm",
+                disabled: !overridden,
+                onClick: () => resetColor(key),
+                tooltip: overridden ? `Reset ${COLOR_LABELS[key]} to the preset` : "Unchanged",
+                "aria-label": `Reset ${COLOR_LABELS[key]}`
+              }
+            ),
+            separateDark && /* @__PURE__ */ _jsxruntime.jsx.call(void 0, 
+              _chunkNSA7ASZ7cjs.IconButton,
+              {
+                icon: _lucidereact.RotateCcw,
+                variant: "text",
+                color: "secondary",
+                size: "sm",
+                disabled: !darkOverridden,
+                onClick: () => resetDarkColor(key),
+                tooltip: darkOverridden ? `Use the derived dark ${COLOR_LABELS[key]} again` : "Derived from the light colour",
+                "aria-label": `Reset dark ${COLOR_LABELS[key]}`
+              }
+            )
+          ] })
         ] }, key);
       }) })
     ] }),
@@ -341,7 +471,7 @@ var ThemeEditor = ({
             onChange: (fontFamily) => updateTheme({ typography: { fontFamily } }),
             onUploaded: (option, file, family) => {
               setUploaded((prev) => [...prev, option]);
-              _optionalChain([onFontUpload, 'optionalCall', _20 => _20(file, family, false)]);
+              _optionalChain([onFontUpload, 'optionalCall', _27 => _27(file, family, false)]);
             }
           }
         ),
@@ -356,7 +486,7 @@ var ThemeEditor = ({
             onChange: (monoFamily) => updateTheme({ typography: { monoFamily } }),
             onUploaded: (option, file, family) => {
               setMonoUploaded((prev) => [...prev, option]);
-              _optionalChain([onFontUpload, 'optionalCall', _21 => _21(file, family, true)]);
+              _optionalChain([onFontUpload, 'optionalCall', _28 => _28(file, family, true)]);
             }
           }
         ),
@@ -366,8 +496,8 @@ var ThemeEditor = ({
             _chunkOZZHOEN5cjs.Slider,
             {
               value: resolvedTheme.typography.fontScale,
-              min: _chunkQDZVZY53cjs.FONT_SCALE_MIN,
-              max: _chunkQDZVZY53cjs.FONT_SCALE_MAX,
+              min: _chunkO45W57Y4cjs.FONT_SCALE_MIN,
+              max: _chunkO45W57Y4cjs.FONT_SCALE_MAX,
               step: 0.025,
               showValue: true,
               showMinMax: true,
@@ -384,9 +514,9 @@ var ThemeEditor = ({
         _chunkNSA7ASZ7cjs.Button,
         {
           variant: "outlined",
-          preIcon: copied ? "Check" : "Clipboard",
+          preIcon: copied ? _lucidereact.Check : _lucidereact.Clipboard,
           onClick: copyCss,
-          tooltip: "Copy the resolved tokens as a :root block you can paste into your own stylesheet",
+          tooltip: "Copy the resolved tokens - light and dark - as CSS you can paste into your own stylesheet",
           children: copied ? "Copied" : "Copy as CSS"
         }
       )
@@ -398,4 +528,4 @@ ThemeEditor.displayName = "ThemeEditor";
 
 
 exports.ThemeEditor = ThemeEditor;
-//# sourceMappingURL=chunk-PVNBH7XN.cjs.map
+//# sourceMappingURL=chunk-JO4NDJRA.cjs.map

package/dist/chunk-JO4NDJRA.cjs.map

@@ -0,0 +1 @@
+{"version":3,"sources":["/home/runner/work/eidos-ui/eidos-ui/dist/chunk-JO4NDJRA.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-JO4NDJRA.cjs","sourcesContent":[null,"import React, { useCallback, useEffect, useMemo, useReducer, useRef, useState } from 'react';\nimport {\n  Check,\n  CircleCheck,\n  CircleX,\n  Clipboard,\n  RotateCcw,\n  TriangleAlert,\n  Upload,\n} from 'lucide-react';\nimport { Alert } from '../Alert';\nimport { Button, IconButton } from '../Button';\nimport { Card } from '../Card';\nimport { ColorPicker } from '../ColorPicker';\nimport { SegmentedControl } from '../SegmentedControl';\nimport { Select } from '../Select';\nimport { Slider } from '../Slider';\nimport { Switch } from '../Switch';\nimport { Tooltip } from '../Tooltip';\nimport { useTheme } from '../ThemeProvider';\nimport type {\n  ColorScheme,\n  ResolvedColorScheme,\n  ThemeColorKey,\n  ThemeFontOption,\n} 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  DARK_SURFACE,\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/**\n * The page surface each scheme's diagnostics are measured against - the\n * `--surface` token's value in that scheme.\n */\nconst PAGE_SURFACE: Record<ResolvedColorScheme, string> = {\n  light: CONTRAST_LIGHT,\n  dark: DARK_SURFACE,\n};\n\nconst SCHEME_OPTIONS: { value: ColorScheme; label: string }[] = [\n  { value: 'light', label: 'Light' },\n  { value: 'dark', label: 'Dark' },\n  { value: 'system', label: 'System' },\n];\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 = (\n  key: ThemeColorKey,\n  base: string,\n  explicitContrast: string | undefined,\n  scheme: ResolvedColorScheme,\n): Diagnostic => {\n  const page = PAGE_SURFACE[scheme];\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);\n    const grade = gradeFor(ratio);\n    return {\n      grade,\n      ratio,\n      detail: `Link text on the page background: ${ratio.toFixed(2)}:1 against the ${scheme} page.${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);\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 {\n    theme,\n    resolvedTheme,\n    setTheme,\n    updateTheme,\n    resetTheme,\n    isDefault,\n    toCss,\n    colorScheme,\n    resolvedColorScheme,\n    setColorScheme,\n  } = useTheme();\n  const [copied, setCopied] = useState(false);\n\n  // Separate dark colours are opt-in: most palettes want the derived dark\n  // tones, which are accessible by construction. Starts on when the theme\n  // already carries dark overrides, so none are hidden from view.\n  const hasDarkOverrides = Object.keys(theme.dark?.colors ?? {}).length > 0;\n  const [separateDark, setSeparateDark] = useState(hasDarkOverrides);\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 setDarkColor = useCallback(\n    (key: ThemeColorKey, hex: string) => updateTheme({ dark: { colors: { [key]: hex } } }),\n    [updateTheme],\n  );\n\n  const resetDarkColor = useCallback(\n    (key: ThemeColorKey) => {\n      // As `resetColor`: removing the override is what restores the derived tone.\n      const nextDark = { ...theme.dark?.colors };\n      delete nextDark[key];\n      setTheme({ ...theme, dark: { colors: nextDark } });\n    },\n    [theme, setTheme],\n  );\n\n  const toggleSeparateDark = useCallback(\n    (on: boolean) => {\n      setSeparateDark(on);\n      // Turning it off discards the overrides rather than hiding them: a\n      // hidden override would keep changing the dark scheme with no control\n      // left on screen to explain or undo it.\n      if (!on && hasDarkOverrides) setTheme({ ...theme, dark: { colors: {} } });\n    },\n    [hasDarkOverrides, setTheme, theme],\n  );\n\n  // Diagnostics follow the scheme being previewed: a colour is graded against\n  // the page it is actually on right now, with the foreground it actually has.\n  const diagnostics = useMemo(\n    () =>\n      colors.map((key) => {\n        const palette =\n          resolvedColorScheme === 'dark' ? resolvedTheme.dark.colors : resolvedTheme.colors;\n        const { base, contrast } = palette[key];\n        const diagnostic = diagnose(key, base, contrast, resolvedColorScheme);\n        const lightBase = resolvedTheme.colors[key].base;\n        return {\n          key,\n          base: lightBase,\n          darkBase: resolvedTheme.dark.colors[key].base,\n          ...diagnostic,\n          // In dark the picker still shows the colour as picked, but what is\n          // graded - and rendered - is its dark tone. Name it, or the badge\n          // appears to describe a colour that is not on screen.\n          detail:\n            resolvedColorScheme === 'dark' && base !== lightBase\n              ? `In dark this renders as ${base}. ${diagnostic.detail}`\n              : diagnostic.detail,\n        };\n      }),\n    [colors, resolvedTheme, resolvedColorScheme],\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\" id=\"eidos-theme-editor-scheme\">\n            Colour scheme\n          </span>\n          <span className=\"eidos-theme-editor-section__hint\">\n            Your colours apply to both schemes. In dark each one is lightened until it reads on the\n            dark page, with dark text on it - turn on separate dark colours to pick them yourself.\n          </span>\n        </div>\n        <div className=\"eidos-theme-editor-rows\">\n          <div className=\"eidos-theme-editor-row eidos-theme-editor-row--wide\">\n            <span className=\"eidos-theme-editor-row__label\">Scheme</span>\n            <div className=\"eidos-theme-editor-row__control\">\n              <SegmentedControl\n                options={SCHEME_OPTIONS}\n                value={colorScheme}\n                onChange={(value) => setColorScheme(value as ColorScheme)}\n                aria-labelledby=\"eidos-theme-editor-scheme\"\n                size=\"sm\"\n              />\n            </div>\n          </div>\n          <div className=\"eidos-theme-editor-row eidos-theme-editor-row--wide\">\n            <span className=\"eidos-theme-editor-row__label\" />\n            <div className=\"eidos-theme-editor-row__control\">\n              <Switch\n                label=\"Separate dark colours\"\n                checked={separateDark}\n                onChange={(event) => toggleSeparateDark(event.target.checked)}\n                size=\"sm\"\n              />\n            </div>\n          </div>\n        </div>\n      </Card>\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. Contrast is measured\n            against the {resolvedColorScheme} page.\n          </span>\n        </div>\n\n        <div className=\"eidos-theme-editor-rows\">\n          {diagnostics.map(({ key, base, darkBase, grade, ratio, detail, edgeWarning }) => {\n            const badge = GRADE_BADGE[grade];\n            const overridden = theme.colors?.[key] !== undefined;\n            const darkOverridden = theme.dark?.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                {separateDark && (\n                  <ColorPicker\n                    value={darkBase}\n                    onChange={(hex) => setDarkColor(key, hex)}\n                    size=\"md\"\n                    ariaLabel={`${COLOR_LABELS[key]} (dark)`}\n                  />\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                  {separateDark && (\n                    <IconButton\n                      icon={RotateCcw}\n                      variant=\"text\"\n                      color=\"secondary\"\n                      size=\"sm\"\n                      disabled={!darkOverridden}\n                      onClick={() => resetDarkColor(key)}\n                      tooltip={\n                        darkOverridden\n                          ? `Use the derived dark ${COLOR_LABELS[key]} again`\n                          : 'Derived from the light colour'\n                      }\n                      aria-label={`Reset dark ${COLOR_LABELS[key]}`}\n                    />\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 - light and dark - as CSS 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"]}