eidos-ui 2.1.0 → 3.1.0

package/dist/index.d.cts

@@ -67,6 +67,9 @@ export { CommandPalette } from './command-palette/index.cjs';
 export { C as CommandItem, a as CommandPaletteProps } from './CommandPalette.types-DRMMS_ev.cjs';
 export { VirtualList, VirtualListProps } from './virtual-list/index.cjs';
 export { DataGrid, DataGridActionsColumn, DataGridCellType, DataGridColumn, DataGridCustomColumn, DataGridFilterField, DataGridProps, DataGridQuickFilter, DataGridQuickFilterCombobox, DataGridQuickFilterComboboxOption, DataGridQuickFilterSegmented, DataGridQuickFilterSegmentedOption, DataGridQuickFilterSelect, DataGridQuickFilterSelectOption, DataGridRowAction, DataGridSelectOption, DataGridValueCellType, DataGridValueColumn, EditingCell } from './data-grid/index.cjs';
+export { FONT_ACCEPT, RegisteredFont, ThemeProvider, defaultTheme, familyNameFromFile, isFontAvailable, isFontStackAvailable, registerFontFace, registerFontFile, toFontStack, useTheme } from './theme-provider/index.cjs';
+export { R as ResolvedTheme, T as ThemeColorKey, a as ThemeColorValue, b as ThemeColors, c as ThemeConfig, d as ThemeContextValue, e as ThemeFontOption, f as ThemeProviderProps, g as ThemeTypography } from './ThemeProvider.types-DgXN0gEH.cjs';
+export { ThemeEditor, ThemeEditorProps } from './theme-editor/index.cjs';
 export { I as IconType, r as renderIcon } from './renderIcon-C2lEMMzb.cjs';
 export { C as ComponentSizeProps } from './sizes-DM6Rrrgq.cjs';
 import 'react';

package/dist/index.d.ts

@@ -67,6 +67,9 @@ export { CommandPalette } from './command-palette/index.js';
 export { C as CommandItem, a as CommandPaletteProps } from './CommandPalette.types-DRMMS_ev.js';
 export { VirtualList, VirtualListProps } from './virtual-list/index.js';
 export { DataGrid, DataGridActionsColumn, DataGridCellType, DataGridColumn, DataGridCustomColumn, DataGridFilterField, DataGridProps, DataGridQuickFilter, DataGridQuickFilterCombobox, DataGridQuickFilterComboboxOption, DataGridQuickFilterSegmented, DataGridQuickFilterSegmentedOption, DataGridQuickFilterSelect, DataGridQuickFilterSelectOption, DataGridRowAction, DataGridSelectOption, DataGridValueCellType, DataGridValueColumn, EditingCell } from './data-grid/index.js';
+export { FONT_ACCEPT, RegisteredFont, ThemeProvider, defaultTheme, familyNameFromFile, isFontAvailable, isFontStackAvailable, registerFontFace, registerFontFile, toFontStack, useTheme } from './theme-provider/index.js';
+export { R as ResolvedTheme, T as ThemeColorKey, a as ThemeColorValue, b as ThemeColors, c as ThemeConfig, d as ThemeContextValue, e as ThemeFontOption, f as ThemeProviderProps, g as ThemeTypography } from './ThemeProvider.types-DgXN0gEH.js';
+export { ThemeEditor, ThemeEditorProps } from './theme-editor/index.js';
 export { I as IconType, r as renderIcon } from './renderIcon-C2lEMMzb.js';
 export { C as ComponentSizeProps } from './sizes-DM6Rrrgq.js';
 import 'react';

package/dist/index.js

@@ -1,23 +1,38 @@
+import {
+  TreeView
+} from "./chunk-LUSLBNSG.js";
+import {
+  VirtualList
+} from "./chunk-CJVC3A4O.js";
 import {
   Tab,
   TabPanel,
   Tabs
-} from "./chunk-RAZRQ57B.js";
+} from "./chunk-74MBKLYI.js";
 import {
   TagInput
 } from "./chunk-R4PU2TBM.js";
 import {
   Textarea
 } from "./chunk-REVK7IGN.js";
+import {
+  ThemeEditor
+} from "./chunk-H5HWFOWZ.js";
+import {
+  FONT_ACCEPT,
+  ThemeProvider,
+  defaultTheme,
+  familyNameFromFile,
+  isFontAvailable,
+  isFontStackAvailable,
+  registerFontFace,
+  registerFontFile,
+  toFontStack,
+  useTheme
+} from "./chunk-2ZY7M72Q.js";
 import {
   Timeline
 } from "./chunk-NEQXEVHM.js";
-import {
-  TreeView
-} from "./chunk-LUSLBNSG.js";
-import {
-  VirtualList
-} from "./chunk-CJVC3A4O.js";
 import {
   Skeleton
 } from "./chunk-O3I3RBZJ.js";
@@ -99,7 +114,7 @@ import {
 } from "./chunk-SHYSLWQG.js";
 import {
   ColorPicker
-} from "./chunk-JV7Z3D3U.js";
+} from "./chunk-LEMCJW57.js";
 import {
   CommandPalette
 } from "./chunk-PY2376XI.js";
@@ -218,6 +233,7 @@ export {
   Dropdown,
   DropdownProvider,
   EmptyState,
+  FONT_ACCEPT,
   FileUpload,
   Footer,
   Header,
@@ -255,15 +271,25 @@ export {
   Tabs,
   TagInput,
   Textarea,
+  ThemeEditor,
+  ThemeProvider,
   TimeInput,
   Timeline,
   Toolbar,
   Tooltip,
   TreeView,
   VirtualList,
+  defaultTheme,
+  familyNameFromFile,
+  isFontAvailable,
+  isFontStackAvailable,
+  registerFontFace,
+  registerFontFile,
   renderIcon,
+  toFontStack,
   useDropdownContext,
   useSnackbar,
-  useSnackbarContext
+  useSnackbarContext,
+  useTheme
 };
 //# sourceMappingURL=index.js.map

package/dist/tabs/index.cjs

@@ -2,12 +2,12 @@
 
 
 
-var _chunkVHQTDITVcjs = require('../chunk-VHQTDITV.cjs');
+var _chunkKQD7CQ4Zcjs = require('../chunk-KQD7CQ4Z.cjs');
 require('../chunk-GEHL4LKK.cjs');
 require('../chunk-DZUJEN5N.cjs');
 
 
 
 
-exports.Tab = _chunkVHQTDITVcjs.Tab; exports.TabPanel = _chunkVHQTDITVcjs.TabPanel; exports.Tabs = _chunkVHQTDITVcjs.Tabs;
+exports.Tab = _chunkKQD7CQ4Zcjs.Tab; exports.TabPanel = _chunkKQD7CQ4Zcjs.TabPanel; exports.Tabs = _chunkKQD7CQ4Zcjs.Tabs;
 //# sourceMappingURL=index.cjs.map

package/dist/tabs/index.d.cts

@@ -3,6 +3,16 @@ import { I as IconType } from '../renderIcon-C2lEMMzb.cjs';
 import { C as ComponentSizeProps } from '../sizes-DM6Rrrgq.cjs';
 
 type TabsColorProps = 'primary' | 'secondary' | 'success' | 'danger' | 'warning' | 'info';
+/**
+ * How an overflowing tab strip is scrolled.
+ *
+ * - `auto` - previous/next buttons appear only while the strip overflows, and
+ *   the native scrollbar is hidden because the buttons are the affordance.
+ * - `none` - no buttons; the strip keeps its native scrollbar.
+ *
+ * Native scrolling (touch swipe, trackpad, shift+wheel) works either way.
+ */
+type TabsScrollButtonsProps = 'auto' | 'none';
 interface TabsProps {
     value?: string;
     defaultValue?: string;
@@ -11,6 +21,7 @@ interface TabsProps {
     size?: ComponentSizeProps;
     color?: TabsColorProps;
     fullWidth?: boolean;
+    scrollButtons?: TabsScrollButtonsProps;
     className?: string;
     children: React__default.ReactNode;
 }

package/dist/tabs/index.d.ts

@@ -3,6 +3,16 @@ import { I as IconType } from '../renderIcon-C2lEMMzb.js';
 import { C as ComponentSizeProps } from '../sizes-DM6Rrrgq.js';
 
 type TabsColorProps = 'primary' | 'secondary' | 'success' | 'danger' | 'warning' | 'info';
+/**
+ * How an overflowing tab strip is scrolled.
+ *
+ * - `auto` - previous/next buttons appear only while the strip overflows, and
+ *   the native scrollbar is hidden because the buttons are the affordance.
+ * - `none` - no buttons; the strip keeps its native scrollbar.
+ *
+ * Native scrolling (touch swipe, trackpad, shift+wheel) works either way.
+ */
+type TabsScrollButtonsProps = 'auto' | 'none';
 interface TabsProps {
     value?: string;
     defaultValue?: string;
@@ -11,6 +21,7 @@ interface TabsProps {
     size?: ComponentSizeProps;
     color?: TabsColorProps;
     fullWidth?: boolean;
+    scrollButtons?: TabsScrollButtonsProps;
     className?: string;
     children: React__default.ReactNode;
 }

package/dist/tabs/index.js

@@ -2,7 +2,7 @@ import {
   Tab,
   TabPanel,
   Tabs
-} from "../chunk-RAZRQ57B.js";
+} from "../chunk-74MBKLYI.js";
 import "../chunk-KBG77JHC.js";
 import "../chunk-5WRI5ZAA.js";
 export {

package/dist/theme-editor/index.cjs

@@ -0,0 +1,22 @@
+"use strict";Object.defineProperty(exports, "__esModule", {value: true});
+
+var _chunkSE7MWOC7cjs = require('../chunk-SE7MWOC7.cjs');
+require('../chunk-U5FHQ73U.cjs');
+require('../chunk-OZZHOEN5.cjs');
+require('../chunk-V5RS3JZN.cjs');
+require('../chunk-5BX4Q76D.cjs');
+require('../chunk-SJDTFR3I.cjs');
+require('../chunk-KJZUYC4X.cjs');
+require('../chunk-5VM2256W.cjs');
+require('../chunk-FRUOA2QU.cjs');
+require('../chunk-B5G5XVFJ.cjs');
+require('../chunk-EACNRR3C.cjs');
+require('../chunk-APK5OQRV.cjs');
+require('../chunk-I6UOIS4J.cjs');
+require('../chunk-GEHL4LKK.cjs');
+require('../chunk-Z5U4NJTW.cjs');
+require('../chunk-DZUJEN5N.cjs');
+
+
+exports.ThemeEditor = _chunkSE7MWOC7cjs.ThemeEditor;
+//# sourceMappingURL=index.cjs.map

package/dist/theme-editor/index.cjs.map

@@ -0,0 +1 @@
+{"version":3,"sources":["/home/runner/work/eidos-ui/eidos-ui/dist/theme-editor/index.cjs"],"names":[],"mappings":"AAAA;AACE;AACF,yDAA8B;AAC9B,iCAA8B;AAC9B,iCAA8B;AAC9B,iCAA8B;AAC9B,iCAA8B;AAC9B,iCAA8B;AAC9B,iCAA8B;AAC9B,iCAA8B;AAC9B,iCAA8B;AAC9B,iCAA8B;AAC9B,iCAA8B;AAC9B,iCAA8B;AAC9B,iCAA8B;AAC9B,iCAA8B;AAC9B,iCAA8B;AAC9B,iCAA8B;AAC9B;AACE;AACF,oDAAC","file":"/home/runner/work/eidos-ui/eidos-ui/dist/theme-editor/index.cjs"}

package/dist/theme-editor/index.d.cts

@@ -0,0 +1,65 @@
+import React__default from 'react';
+import { T as ThemeColorKey, e as ThemeFontOption } from '../ThemeProvider.types-DgXN0gEH.cjs';
+
+interface ThemeEditorProps {
+    /**
+     * Which colour rows to show, in this order. Defaults to all seven - pass a
+     * subset when only part of the palette should be user-editable.
+     */
+    colors?: ThemeColorKey[];
+    /**
+     * Body font stacks to offer. Defaults to a small built-in list.
+     *
+     * Supply your own to list the fonts your app actually ships - a stack is only
+     * a *name*, so offering one the browser cannot resolve silently falls through
+     * to the next entry.
+     */
+    fontOptions?: ThemeFontOption[];
+    /** Monospace font stacks to offer. Defaults to a small built-in list. */
+    monoFontOptions?: ThemeFontOption[];
+    /**
+     * Allow loading a font file from disk. Default `true`.
+     *
+     * The font is registered with the CSS Font Loading API from an `ArrayBuffer`,
+     * which needs no CSP allowance, and renders immediately. It is **not**
+     * persisted on its own - see `onFontUpload`.
+     */
+    allowFontUpload?: boolean;
+    /**
+     * Called with the file the user picked, after it has been registered and
+     * applied.
+     *
+     * This is the hook for making an uploaded font permanent. A `ThemeConfig` is
+     * JSON and cannot carry binary data, so the theme records only the family
+     * *name* - without persisting the file yourself, the name resolves to nothing
+     * on the next load and the stack quietly falls back. Upload the file to your
+     * server (or store it in IndexedDB), then `registerFontFace` it on startup
+     * and include it in `fontOptions`.
+     *
+     * @param file The font file as chosen by the user.
+     * @param family The family name it was registered under.
+     * @param mono `true` when it was picked for the monospace slot.
+     */
+    onFontUpload?: (file: File, family: string, mono: boolean) => void;
+    /** Hide the typography section. */
+    hideTypography?: boolean;
+    /** Hide the "Reset all" action. */
+    hideReset?: boolean;
+    /** Hide the "Copy as CSS" action. */
+    hideCssExport?: boolean;
+    className?: string;
+}
+
+/**
+ * Live editor for the active `ThemeProvider` theme.
+ *
+ * Renders no preview of its own: the provider writes tokens to
+ * `document.documentElement`, so the surrounding page is the preview.
+ *
+ * Contrast readouts are diagnostics only - a colour that fails is still
+ * applied. Automatically "correcting" a chosen colour would mean silently
+ * rendering something other than what was picked.
+ */
+declare const ThemeEditor: React__default.FC<ThemeEditorProps>;
+
+export { ThemeEditor, type ThemeEditorProps };

package/dist/theme-editor/index.d.ts

@@ -0,0 +1,65 @@
+import React__default from 'react';
+import { T as ThemeColorKey, e as ThemeFontOption } from '../ThemeProvider.types-DgXN0gEH.js';
+
+interface ThemeEditorProps {
+    /**
+     * Which colour rows to show, in this order. Defaults to all seven - pass a
+     * subset when only part of the palette should be user-editable.
+     */
+    colors?: ThemeColorKey[];
+    /**
+     * Body font stacks to offer. Defaults to a small built-in list.
+     *
+     * Supply your own to list the fonts your app actually ships - a stack is only
+     * a *name*, so offering one the browser cannot resolve silently falls through
+     * to the next entry.
+     */
+    fontOptions?: ThemeFontOption[];
+    /** Monospace font stacks to offer. Defaults to a small built-in list. */
+    monoFontOptions?: ThemeFontOption[];
+    /**
+     * Allow loading a font file from disk. Default `true`.
+     *
+     * The font is registered with the CSS Font Loading API from an `ArrayBuffer`,
+     * which needs no CSP allowance, and renders immediately. It is **not**
+     * persisted on its own - see `onFontUpload`.
+     */
+    allowFontUpload?: boolean;
+    /**
+     * Called with the file the user picked, after it has been registered and
+     * applied.
+     *
+     * This is the hook for making an uploaded font permanent. A `ThemeConfig` is
+     * JSON and cannot carry binary data, so the theme records only the family
+     * *name* - without persisting the file yourself, the name resolves to nothing
+     * on the next load and the stack quietly falls back. Upload the file to your
+     * server (or store it in IndexedDB), then `registerFontFace` it on startup
+     * and include it in `fontOptions`.
+     *
+     * @param file The font file as chosen by the user.
+     * @param family The family name it was registered under.
+     * @param mono `true` when it was picked for the monospace slot.
+     */
+    onFontUpload?: (file: File, family: string, mono: boolean) => void;
+    /** Hide the typography section. */
+    hideTypography?: boolean;
+    /** Hide the "Reset all" action. */
+    hideReset?: boolean;
+    /** Hide the "Copy as CSS" action. */
+    hideCssExport?: boolean;
+    className?: string;
+}
+
+/**
+ * Live editor for the active `ThemeProvider` theme.
+ *
+ * Renders no preview of its own: the provider writes tokens to
+ * `document.documentElement`, so the surrounding page is the preview.
+ *
+ * Contrast readouts are diagnostics only - a colour that fails is still
+ * applied. Automatically "correcting" a chosen colour would mean silently
+ * rendering something other than what was picked.
+ */
+declare const ThemeEditor: React__default.FC<ThemeEditorProps>;
+
+export { ThemeEditor, type ThemeEditorProps };

package/dist/theme-editor/index.js

@@ -0,0 +1,22 @@
+import {
+  ThemeEditor
+} from "../chunk-H5HWFOWZ.js";
+import "../chunk-2ZY7M72Q.js";
+import "../chunk-2BC4M4QZ.js";
+import "../chunk-EF4Y6Q35.js";
+import "../chunk-LEMCJW57.js";
+import "../chunk-KGXGTWUL.js";
+import "../chunk-A7WQINIG.js";
+import "../chunk-VHMOKXUT.js";
+import "../chunk-4BKTBV2I.js";
+import "../chunk-5ZL6PYU3.js";
+import "../chunk-N5JDL4VE.js";
+import "../chunk-YJXZR7RL.js";
+import "../chunk-66R54X6R.js";
+import "../chunk-KBG77JHC.js";
+import "../chunk-YV57RSPD.js";
+import "../chunk-5WRI5ZAA.js";
+export {
+  ThemeEditor
+};
+//# sourceMappingURL=index.js.map

package/dist/theme-editor/index.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":[],"sourcesContent":[],"mappings":"","names":[]}

package/dist/theme-provider/index.cjs

@@ -0,0 +1,27 @@
+"use strict";Object.defineProperty(exports, "__esModule", {value: true});
+
+
+
+
+
+
+
+
+
+
+var _chunkU5FHQ73Ucjs = require('../chunk-U5FHQ73U.cjs');
+require('../chunk-GEHL4LKK.cjs');
+require('../chunk-DZUJEN5N.cjs');
+
+
+
+
+
+
+
+
+
+
+
+exports.FONT_ACCEPT = _chunkU5FHQ73Ucjs.FONT_ACCEPT; exports.ThemeProvider = _chunkU5FHQ73Ucjs.ThemeProvider; exports.defaultTheme = _chunkU5FHQ73Ucjs.defaultTheme; exports.familyNameFromFile = _chunkU5FHQ73Ucjs.familyNameFromFile; exports.isFontAvailable = _chunkU5FHQ73Ucjs.isFontAvailable; exports.isFontStackAvailable = _chunkU5FHQ73Ucjs.isFontStackAvailable; exports.registerFontFace = _chunkU5FHQ73Ucjs.registerFontFace; exports.registerFontFile = _chunkU5FHQ73Ucjs.registerFontFile; exports.toFontStack = _chunkU5FHQ73Ucjs.toFontStack; exports.useTheme = _chunkU5FHQ73Ucjs.useTheme;
+//# sourceMappingURL=index.cjs.map

package/dist/theme-provider/index.cjs.map

@@ -0,0 +1 @@
+{"version":3,"sources":["/home/runner/work/eidos-ui/eidos-ui/dist/theme-provider/index.cjs"],"names":[],"mappings":"AAAA;AACE;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACF,yDAA8B;AAC9B,iCAA8B;AAC9B,iCAA8B;AAC9B;AACE;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACF,6kBAAC","file":"/home/runner/work/eidos-ui/eidos-ui/dist/theme-provider/index.cjs"}

package/dist/theme-provider/index.d.cts

@@ -0,0 +1,123 @@
+import React__default from 'react';
+import { f as ThemeProviderProps, d as ThemeContextValue, c as ThemeConfig } from '../ThemeProvider.types-DgXN0gEH.cjs';
+export { R as ResolvedTheme, T as ThemeColorKey, a as ThemeColorValue, b as ThemeColors, e as ThemeFontOption, g as ThemeTypography } from '../ThemeProvider.types-DgXN0gEH.cjs';
+
+/**
+ * Applies a theme by writing CSS custom properties to `document.documentElement`.
+ *
+ * Two deliberate choices worth knowing:
+ *
+ * **The target is `documentElement`, not a wrapper element.** Every overlay in
+ * this library (`Dropdown`, `Modal`, `Drawer`, `Snackbar`, `Tooltip`, …) portals
+ * to `document.body`, so tokens scoped to a wrapper `<div>` would leave every
+ * popup rendering the preset instead.
+ *
+ * **Properties are set through the CSSOM** (`style.setProperty`), which no CSP
+ * directive gates - `style-src` and `style-src-attr` only cover the `style`
+ * HTML attribute and stylesheet loads. Nothing here needs a nonce, and no
+ * `<style>` element is ever created. See `ContentSecurityPolicy.mdx`.
+ *
+ * Under SSR the server sends the preset from `dist/index.css` and the theme is
+ * applied on hydration; use `toCss()` if you need a themed first paint.
+ */
+declare const ThemeProvider: React__default.FC<ThemeProviderProps>;
+
+/**
+ * Reads the active theme. Throws outside a `ThemeProvider`, matching
+ * `useSnackbarContext` - a silent fallback would make a missing provider look
+ * like a theme that simply is not applying.
+ */
+declare const useTheme: () => ThemeContextValue;
+
+/**
+ * The shipped values from `src/styles/variables.scss`.
+ *
+ * This is a literal copy, not something derived: the ramp is hand-tuned and no
+ * generator reproduces it byte for byte. Keeping it literal means a theme equal
+ * to the preset writes no CSS properties at all, so default rendering is
+ * identical to `dist/index.css`.
+ *
+ * Must be kept in sync with `variables.scss` by hand. The bases are all chosen
+ * to clear WCAG AA against white text; see the comment at the top of that file.
+ */
+declare const defaultTheme: Required<ThemeConfig>;
+
+/**
+ * Runtime font registration for the theme system.
+ *
+ * `--font-family-primary` only *names* families - it cannot make a font
+ * available. Selecting "Plus Jakarta Sans" on a machine that doesn't have it
+ * installed silently falls through to the next stack entry, which is why a
+ * theme needs a way to supply the font data itself.
+ *
+ * ## Why this is CSP-safe
+ *
+ * Fonts are registered with the CSS Font Loading API from an `ArrayBuffer`:
+ *
+ * ```ts
+ * document.fonts.add(new FontFace(family, buffer));
+ * ```
+ *
+ * CSP's `font-src` directive governs *fetching* a font resource by URL - it is
+ * what gates `@font-face { src: url(...) }` and the string form of the
+ * `FontFace` constructor. The binary form performs no fetch at all, so there is
+ * no request for `font-src` to check and no allowance to configure. Notably
+ * this also avoids `blob:` URLs, which *would* require `font-src blob:`.
+ *
+ * No `<style>` element is created either, so nothing here needs a nonce - the
+ * same position as the rest of the theme system.
+ */
+/** A font registered at runtime, as listed by the editor. */
+interface RegisteredFont {
+    /** The family name to reference in a font stack. */
+    family: string;
+    /** Where it came from, so the UI can distinguish uploads from built-ins. */
+    source: 'upload';
+}
+/**
+ * Turns a filename into a usable CSS family name.
+ *
+ * Deliberately conservative: the real family name lives in the font's internal
+ * `name` table, and parsing SFNT tables to read it would be a disproportionate
+ * amount of binary handling for a label. The filename is what the user
+ * recognises anyway.
+ */
+declare const familyNameFromFile: (filename: string) => string;
+/**
+ * Builds a full stack from a custom family, keeping sensible fallbacks so the
+ * page stays readable if the font is ever unavailable.
+ */
+declare const toFontStack: (family: string, mono?: boolean) => string;
+/** Font formats accepted for upload, as an `accept` attribute value. */
+declare const FONT_ACCEPT = ".woff2,.woff,.ttf,.otf";
+/**
+ * Registers font data with the document so a theme can reference its family.
+ *
+ * Resolves with the family name actually registered. Rejects if the data is not
+ * a font the browser can parse, or if the Font Loading API is unavailable
+ * (notably during SSR, where there is no `document` to register against).
+ */
+declare const registerFontFace: (family: string, data: ArrayBuffer) => Promise<string>;
+/** Reads a File and registers it, returning the family name it was given. */
+declare const registerFontFile: (file: File, family?: string) => Promise<string>;
+/**
+ * Whether a font family will actually render, rather than silently falling
+ * through to the next entry in the stack.
+ *
+ * **`document.fonts.check` cannot answer this.** Per spec it reports whether
+ * the faces *in the FontFaceSet* matching the query are loaded, so with no
+ * matching face it returns `true` vacuously. Verified in a real browser: it
+ * answers `true` for `'Totally Not A Real Font 12345'`, and therefore for every
+ * uninstalled system font too. Using it here produced a check that could never
+ * fail.
+ *
+ * Instead the family is measured on a canvas against two fallbacks. If it
+ * resolves to anything real, the text measures differently from at least one
+ * fallback alone; if it does not resolve, the browser renders that fallback and
+ * the widths match exactly.
+ */
+declare const isFontAvailable: (family: string) => boolean;
+/** Whether the first family in a stack will render. */
+declare const isFontStackAvailable: (stack: string) => boolean;
+
+export { FONT_ACCEPT, type RegisteredFont, ThemeConfig, ThemeContextValue, ThemeProvider, ThemeProviderProps, defaultTheme, familyNameFromFile, isFontAvailable, isFontStackAvailable, registerFontFace, registerFontFile, toFontStack, useTheme };

package/dist/theme-provider/index.d.ts

@@ -0,0 +1,123 @@
+import React__default from 'react';
+import { f as ThemeProviderProps, d as ThemeContextValue, c as ThemeConfig } from '../ThemeProvider.types-DgXN0gEH.js';
+export { R as ResolvedTheme, T as ThemeColorKey, a as ThemeColorValue, b as ThemeColors, e as ThemeFontOption, g as ThemeTypography } from '../ThemeProvider.types-DgXN0gEH.js';
+
+/**
+ * Applies a theme by writing CSS custom properties to `document.documentElement`.
+ *
+ * Two deliberate choices worth knowing:
+ *
+ * **The target is `documentElement`, not a wrapper element.** Every overlay in
+ * this library (`Dropdown`, `Modal`, `Drawer`, `Snackbar`, `Tooltip`, …) portals
+ * to `document.body`, so tokens scoped to a wrapper `<div>` would leave every
+ * popup rendering the preset instead.
+ *
+ * **Properties are set through the CSSOM** (`style.setProperty`), which no CSP
+ * directive gates - `style-src` and `style-src-attr` only cover the `style`
+ * HTML attribute and stylesheet loads. Nothing here needs a nonce, and no
+ * `<style>` element is ever created. See `ContentSecurityPolicy.mdx`.
+ *
+ * Under SSR the server sends the preset from `dist/index.css` and the theme is
+ * applied on hydration; use `toCss()` if you need a themed first paint.
+ */
+declare const ThemeProvider: React__default.FC<ThemeProviderProps>;
+
+/**
+ * Reads the active theme. Throws outside a `ThemeProvider`, matching
+ * `useSnackbarContext` - a silent fallback would make a missing provider look
+ * like a theme that simply is not applying.
+ */
+declare const useTheme: () => ThemeContextValue;
+
+/**
+ * The shipped values from `src/styles/variables.scss`.
+ *
+ * This is a literal copy, not something derived: the ramp is hand-tuned and no
+ * generator reproduces it byte for byte. Keeping it literal means a theme equal
+ * to the preset writes no CSS properties at all, so default rendering is
+ * identical to `dist/index.css`.
+ *
+ * Must be kept in sync with `variables.scss` by hand. The bases are all chosen
+ * to clear WCAG AA against white text; see the comment at the top of that file.
+ */
+declare const defaultTheme: Required<ThemeConfig>;
+
+/**
+ * Runtime font registration for the theme system.
+ *
+ * `--font-family-primary` only *names* families - it cannot make a font
+ * available. Selecting "Plus Jakarta Sans" on a machine that doesn't have it
+ * installed silently falls through to the next stack entry, which is why a
+ * theme needs a way to supply the font data itself.
+ *
+ * ## Why this is CSP-safe
+ *
+ * Fonts are registered with the CSS Font Loading API from an `ArrayBuffer`:
+ *
+ * ```ts
+ * document.fonts.add(new FontFace(family, buffer));
+ * ```
+ *
+ * CSP's `font-src` directive governs *fetching* a font resource by URL - it is
+ * what gates `@font-face { src: url(...) }` and the string form of the
+ * `FontFace` constructor. The binary form performs no fetch at all, so there is
+ * no request for `font-src` to check and no allowance to configure. Notably
+ * this also avoids `blob:` URLs, which *would* require `font-src blob:`.
+ *
+ * No `<style>` element is created either, so nothing here needs a nonce - the
+ * same position as the rest of the theme system.
+ */
+/** A font registered at runtime, as listed by the editor. */
+interface RegisteredFont {
+    /** The family name to reference in a font stack. */
+    family: string;
+    /** Where it came from, so the UI can distinguish uploads from built-ins. */
+    source: 'upload';
+}
+/**
+ * Turns a filename into a usable CSS family name.
+ *
+ * Deliberately conservative: the real family name lives in the font's internal
+ * `name` table, and parsing SFNT tables to read it would be a disproportionate
+ * amount of binary handling for a label. The filename is what the user
+ * recognises anyway.
+ */
+declare const familyNameFromFile: (filename: string) => string;
+/**
+ * Builds a full stack from a custom family, keeping sensible fallbacks so the
+ * page stays readable if the font is ever unavailable.
+ */
+declare const toFontStack: (family: string, mono?: boolean) => string;
+/** Font formats accepted for upload, as an `accept` attribute value. */
+declare const FONT_ACCEPT = ".woff2,.woff,.ttf,.otf";
+/**
+ * Registers font data with the document so a theme can reference its family.
+ *
+ * Resolves with the family name actually registered. Rejects if the data is not
+ * a font the browser can parse, or if the Font Loading API is unavailable
+ * (notably during SSR, where there is no `document` to register against).
+ */
+declare const registerFontFace: (family: string, data: ArrayBuffer) => Promise<string>;
+/** Reads a File and registers it, returning the family name it was given. */
+declare const registerFontFile: (file: File, family?: string) => Promise<string>;
+/**
+ * Whether a font family will actually render, rather than silently falling
+ * through to the next entry in the stack.
+ *
+ * **`document.fonts.check` cannot answer this.** Per spec it reports whether
+ * the faces *in the FontFaceSet* matching the query are loaded, so with no
+ * matching face it returns `true` vacuously. Verified in a real browser: it
+ * answers `true` for `'Totally Not A Real Font 12345'`, and therefore for every
+ * uninstalled system font too. Using it here produced a check that could never
+ * fail.
+ *
+ * Instead the family is measured on a canvas against two fallbacks. If it
+ * resolves to anything real, the text measures differently from at least one
+ * fallback alone; if it does not resolve, the browser renders that fallback and
+ * the widths match exactly.
+ */
+declare const isFontAvailable: (family: string) => boolean;
+/** Whether the first family in a stack will render. */
+declare const isFontStackAvailable: (stack: string) => boolean;
+
+export { FONT_ACCEPT, type RegisteredFont, ThemeConfig, ThemeContextValue, ThemeProvider, ThemeProviderProps, defaultTheme, familyNameFromFile, isFontAvailable, isFontStackAvailable, registerFontFace, registerFontFile, toFontStack, useTheme };