@jini-ai/ui 0.4.6 → 0.4.8

package/dist/features/tabbed-dialog/styles/tabbed-dialog.css

@@ -35,6 +35,10 @@
   border-radius: var(--jini-radius-lg);
   box-shadow: var(--jini-shadow-lg);
   overflow: hidden;
+  /* Layout follows the dialog's OWN width, not the viewport's: an inline settings page beside an
+     expanded nav and an open assistant dock is narrow on a wide screen, and a 375px modal is narrow
+     on any screen. See the `@container jini-tabbed-dialog` block at the end. */
+  container: jini-tabbed-dialog / inline-size;
 }
 
 /* Page (non-modal) variant: the shell renders without `onClose`, so it should
@@ -271,3 +275,90 @@
 .jini-tabbed-dialog-sidebar-toggle:focus-visible {
   opacity: 1;
 }
+
+/* ============================================================
+   Narrow dialog: the side nav becomes one top tab row
+   ============================================================
+   A 240px side nav inside a ~500px dialog left the form a thin column with
+   its controls spilling past the edge (Chat settings at 500px, Chrome check
+   2026-10-11). Below 600px of DIALOG width (a 40rem dialog, e.g. Sites
+   settings, keeps its desktop look) the nav turns into a horizontal,
+   swipeable tab row over a full-width panel. The collapse chevron has
+   nothing to reclaim there, so it hides, and a collapsed nav reappears as
+   the row: a narrow dialog never loses its tabs. Modal-only spacing skips
+   the inline (page) variant, whose host owns its page insets. */
+@container jini-tabbed-dialog (max-width: 600px) {
+  .jini-tabbed-dialog:not(.jini-tabbed-dialog--inline) .jini-tabbed-dialog-head {
+    padding: 20px 56px 8px 16px;
+  }
+
+  .jini-tabbed-dialog:not(.jini-tabbed-dialog--inline) .jini-tabbed-dialog-chrome {
+    top: 16px;
+    right: 16px;
+  }
+
+  .jini-tabbed-dialog:not(.jini-tabbed-dialog--inline) .jini-tabbed-dialog-head-line h2,
+  .jini-tabbed-dialog:not(.jini-tabbed-dialog--inline) .jini-tabbed-dialog-head h2 {
+    font-size: 22px;
+  }
+
+  .jini-tabbed-dialog-body,
+  .jini-tabbed-dialog-sidebar-collapsed .jini-tabbed-dialog-body {
+    grid-template-columns: minmax(0, 1fr);
+    grid-template-rows: auto minmax(0, 1fr);
+  }
+
+  .jini-tabbed-dialog-sidebar,
+  .jini-tabbed-dialog-sidebar-collapsed .jini-tabbed-dialog-sidebar {
+    display: flex;
+    flex-direction: row;
+    gap: 2px;
+    padding: 0 16px;
+    background: transparent;
+    border-right: 0;
+    box-shadow: inset 0 -1px 0 var(--jini-border);
+    overflow-x: auto;
+    overflow-y: hidden;
+    overscroll-behavior-x: contain;
+    scrollbar-width: none;
+  }
+
+  .jini-tabbed-dialog-sidebar::-webkit-scrollbar {
+    display: none;
+  }
+
+  .jini-tabbed-dialog-nav-item {
+    flex: 0 0 auto;
+    width: auto;
+    grid-template-columns: auto auto;
+    gap: 6px;
+    padding: 9px 10px;
+    border: 0;
+    border-bottom: 2px solid transparent;
+    border-radius: 0;
+    white-space: nowrap;
+  }
+
+  .jini-tabbed-dialog-nav-item:hover {
+    background: transparent;
+    color: var(--jini-text);
+  }
+
+  .jini-tabbed-dialog-nav-item.active,
+  .jini-tabbed-dialog-nav-item.active:hover {
+    background: transparent;
+    border-bottom-color: var(--jini-accent);
+  }
+
+  .jini-tabbed-dialog-nav-text small {
+    display: none;
+  }
+
+  .jini-tabbed-dialog-sidebar-toggle {
+    display: none;
+  }
+
+  .jini-tabbed-dialog:not(.jini-tabbed-dialog--inline) .jini-tabbed-dialog-content {
+    padding: 14px 16px 18px;
+  }
+}

package/dist/react/components/RemixIcon.d.ts

@@ -1,50 +1,11 @@
 import type { CSSProperties } from 'react';
+export { installRemixIconStylesheet, REMIXICON_STYLESHEET_MARKER } from './RemixIcon.stylesheet.js';
 interface RemixIconProps {
     name: string;
     size?: number;
     className?: string;
     style?: CSSProperties;
 }
-/**
- * Marks whichever stylesheet is currently serving `.ri-*` glyphs — this package's own default, or
- * a host override that got inserted first. `ensureRemixIconStylesheet` checks for this attribute
- * (not a specific `href`) before injecting, so a host that wants its own icon set/font just needs
- * to add a `<link data-jini-remixicon rel="stylesheet" href="...">` (or an equivalent `<style
- * data-jini-remixicon>`) anywhere in `<head>` before the first `RemixIcon` mounts, and this
- * package's default never loads.
- *
- * Exported because every host that has needed the override so far re-declared this string
- * literally rather than importing it -- three copies outside this file, across two apps of the
- * one downstream checkout inspected (2026-09-06), and they do not agree on element type: one
- * installs a `<style>`, the other a `<link>`. A copied magic string is a rename away from
- * silently double-loading the font; importing the constant is not.
- */
-export declare const REMIXICON_STYLESHEET_MARKER = "data-jini-remixicon";
-/**
- * Installs a caller-supplied stylesheet as the one serving `.ri-*` glyphs, claiming
- * {@link REMIXICON_STYLESHEET_MARKER} so this package's own default never loads.
- *
- * This is the supported opt-in for any host whose bundler defeats the default's `import.meta.url`
- * resolution (see {@link ensureRemixIconStylesheet}) — point it at
- * `@jini-ai/ui/remixicon.css`, which is a normal subpath export a bundler resolves and rewrites
- * like any other asset. Call it before the first `RemixIcon` mounts; module top level in the
- * host's entry file is the usual place, since the default injection runs from a `useEffect` and
- * therefore only has to lose a race against React's commit phase.
- *
- * Idempotent and safe to call unconditionally: it no-ops if any marked stylesheet is already
- * present (including one a previous call installed), and no-ops outside a DOM.
- *
- * @param options.href URL of a stylesheet defining the `.ri-*` classes and its own `@font-face`.
- *   Resolved by the browser against the document, so relative values follow the page's base URL —
- *   pass a bundler-produced URL rather than a hand-written relative path.
- * @returns `true` if this call inserted the stylesheet, `false` if it no-opped.
- * @sideEffects Appends one `<link>` to `document.head`.
- * @complexity O(1) time (one `querySelector` on an attribute selector), O(1) space.
- * @overallScore 100
- */
-export declare function installRemixIconStylesheet(options: {
-    href: string;
-}): boolean;
 /**
  * Thin wrapper around a RemixIcon webfont glyph (`ri-<name>`). Loads this package's own default
  * RemixIcon CSS/font the first time any `RemixIcon` mounts — see
@@ -52,5 +13,4 @@ export declare function installRemixIconStylesheet(options: {
  * {@link installRemixIconStylesheet} for what a bundled host should call instead.
  */
 export declare function RemixIcon({ name, size, className, style }: RemixIconProps): import("react").JSX.Element;
-export {};
 //# sourceMappingURL=RemixIcon.d.ts.map

package/dist/react/components/RemixIcon.js

@@ -1,180 +1,7 @@
 import { jsx as _jsx } from "react/jsx-runtime";
 import { useEffect } from 'react';
-/**
- * Marks whichever stylesheet is currently serving `.ri-*` glyphs — this package's own default, or
- * a host override that got inserted first. `ensureRemixIconStylesheet` checks for this attribute
- * (not a specific `href`) before injecting, so a host that wants its own icon set/font just needs
- * to add a `<link data-jini-remixicon rel="stylesheet" href="...">` (or an equivalent `<style
- * data-jini-remixicon>`) anywhere in `<head>` before the first `RemixIcon` mounts, and this
- * package's default never loads.
- *
- * Exported because every host that has needed the override so far re-declared this string
- * literally rather than importing it -- three copies outside this file, across two apps of the
- * one downstream checkout inspected (2026-09-06), and they do not agree on element type: one
- * installs a `<style>`, the other a `<link>`. A copied magic string is a rename away from
- * silently double-loading the font; importing the constant is not.
- */
-export const REMIXICON_STYLESHEET_MARKER = 'data-jini-remixicon';
-let injected = false;
-let warned = false;
-/**
- * One diagnostic per page load, not one per `RemixIcon` mount — the failure this reports is a
- * build/bundler property, so it is the same failure every time and a per-mount warning would bury
- * the rest of the console under it.
- *
- * @complexity O(1) time, O(1) space.
- * @overallScore 100
- */
-function warnOnce(message) {
-    if (warned)
-        return;
-    warned = true;
-    console.warn(`[@jini-ai/ui] RemixIcon: ${message}`);
-}
-const OPT_IN_HINT = 'Import the stylesheet yourself and install it via ' +
-    "`installRemixIconStylesheet({ href })` — the subpath export `@jini-ai/ui/remixicon.css` " +
-    'resolves through your bundler normally, unlike this runtime default.';
-/**
- * Installs a caller-supplied stylesheet as the one serving `.ri-*` glyphs, claiming
- * {@link REMIXICON_STYLESHEET_MARKER} so this package's own default never loads.
- *
- * This is the supported opt-in for any host whose bundler defeats the default's `import.meta.url`
- * resolution (see {@link ensureRemixIconStylesheet}) — point it at
- * `@jini-ai/ui/remixicon.css`, which is a normal subpath export a bundler resolves and rewrites
- * like any other asset. Call it before the first `RemixIcon` mounts; module top level in the
- * host's entry file is the usual place, since the default injection runs from a `useEffect` and
- * therefore only has to lose a race against React's commit phase.
- *
- * Idempotent and safe to call unconditionally: it no-ops if any marked stylesheet is already
- * present (including one a previous call installed), and no-ops outside a DOM.
- *
- * @param options.href URL of a stylesheet defining the `.ri-*` classes and its own `@font-face`.
- *   Resolved by the browser against the document, so relative values follow the page's base URL —
- *   pass a bundler-produced URL rather than a hand-written relative path.
- * @returns `true` if this call inserted the stylesheet, `false` if it no-opped.
- * @sideEffects Appends one `<link>` to `document.head`.
- * @complexity O(1) time (one `querySelector` on an attribute selector), O(1) space.
- * @overallScore 100
- */
-export function installRemixIconStylesheet(options) {
-    if (typeof document === 'undefined')
-        return false;
-    if (document.querySelector(`[${REMIXICON_STYLESHEET_MARKER}]`)) {
-        injected = true;
-        return false;
-    }
-    const link = document.createElement('link');
-    link.rel = 'stylesheet';
-    link.setAttribute(REMIXICON_STYLESHEET_MARKER, '');
-    link.href = options.href;
-    document.head.appendChild(link);
-    injected = true;
-    return true;
-}
-/**
- * Resolves this package's bundled RemixIcon CSS relative to its own module URL, or `null` when
- * that resolution has provably produced something unusable.
- *
- * The `null` case is not hypothetical. Bundling a `new URL(..., import.meta.url)` asset reference
- * into a non-ESM output (Vite/Rollup `iife`, for one) makes Rollup inline the referenced file as a
- * `data:text/css;base64,...` href instead. That stylesheet then loads, but its own
- * `@font-face { src: url("./remixicon.woff2") }` is relative and a `data:` URL has no location to
- * be relative *to*, so the font request is never even attempted and every glyph renders as tofu.
- * Injecting it is strictly worse than injecting nothing, because it also claims
- * {@link REMIXICON_STYLESHEET_MARKER} and so suppresses any override installed later.
- *
- * @returns An absolute URL string, or `null` if resolution failed or yielded a `data:`/`blob:` URL.
- * @complexity O(1) time, O(1) space.
- * @overallScore 100
- */
-function resolveDefaultStylesheetHref() {
-    let resolved;
-    try {
-        resolved = new URL('./remixicon-font/remixicon.css', import.meta.url);
-    }
-    catch {
-        return null;
-    }
-    if (resolved.protocol === 'data:' || resolved.protocol === 'blob:')
-        return null;
-    return resolved.href;
-}
-/**
- * Idempotently loads this package's default RemixIcon webfont/CSS on first use, so a host gets
- * working icons out of the box with zero setup — see {@link REMIXICON_STYLESHEET_MARKER} for how a
- * host overrides this and {@link installRemixIconStylesheet} for the supported way to do it.
- *
- * **This default only survives unbundled ESM, and that is not a fixable property of this
- * function.** It resolves the CSS with `new URL('./remixicon-font/remixicon.css',
- * import.meta.url)`, which is correct exactly while this module is still a real ES module sitting
- * next to its own `remixicon-font/` directory. Three bundler transformations break it three
- * different ways. The first two were confirmed live against this component; the third was
- * confirmed live against its sibling, and is listed because nothing exempts this file from it:
- *
- * - **`iife`/`umd` output** cannot express the reference at all and degrades it to an inlined
- *   `data:` URL whose own relative `@font-face` src can never resolve. Confirmed live in a
- *   downstream `lib`/`iife` widget bundle, where `document.fonts` reported the `remixicon` face
- *   as `status: "error"` with no matching resource entry at all — an unattempted fetch, not a
- *   404. Detected and refused by {@link resolveDefaultStylesheetHref}.
- * - **Production ESM builds** may copy the CSS as an opaque asset without descending into its
- *   `url(./remixicon.woff2)`, emitting the stylesheet without the font beside it. Confirmed live
- *   in a downstream admin SPA build, which is why that host imports the CSS through its
- *   bundler's real CSS pipeline instead of letting this default run.
- * - **Vite dev-server dependency pre-bundling** flattens a package module into a `.vite/deps/`
- *   chunk, so an `import.meta.url`-relative URL resolves against the chunk's location instead.
- *   Observed live for this package's `AgentIcon` (fixed in 58bf42fa by inlining those assets as
- *   `data:` URIs — not an option here, see {@link installRemixIconStylesheet}), *not* observed
- *   for this component, whose two known hosts both claim the marker before this default ever
- *   runs. Worth knowing how it presented there: not as a 404, but as the dev server's SPA
- *   history fallback answering `200 text/html`.
- *
- * A previous version of this comment claimed "Vite/Rollup/webpack all rewrite this correctly at
- * build time". They do not, and each downstream host that hit it rediscovered a different half
- * of the above independently. There is no runtime-resolvable URL that survives all of it — the
- * cannot know where, or whether, its sibling asset was emitted — so the honest contract is: the
- * default is a convenience for unbundled ESM, and any bundled host should call
- * {@link installRemixIconStylesheet} instead. This function's job is to make that failure *loud*
- * rather than silent, since tofu glyphs give no clue where to look.
- *
- * @sideEffects Appends at most one `<link>` to `document.head`; may emit one `console.warn`.
- * @complexity O(1) time, O(1) space.
- * @overallScore 100
- */
-function ensureRemixIconStylesheet() {
-    if (injected || typeof document === 'undefined')
-        return;
-    if (document.querySelector(`[${REMIXICON_STYLESHEET_MARKER}]`)) {
-        injected = true;
-        return;
-    }
-    const href = resolveDefaultStylesheetHref();
-    if (href === null) {
-        // Claiming the marker with a stylesheet that cannot work would block a later override, so
-        // stay out of the way entirely and let the host know why its icons are blank.
-        injected = true;
-        warnOnce(`this bundle defeated the default stylesheet's own URL resolution. ${OPT_IN_HINT}`);
-        return;
-    }
-    const link = document.createElement('link');
-    link.rel = 'stylesheet';
-    link.setAttribute(REMIXICON_STYLESHEET_MARKER, '');
-    link.href = href;
-    link.addEventListener('error', () => {
-        // The pre-bundling case above: undetectable synchronously, because the href looked perfectly
-        // well formed. Drop the dead <link> so it stops holding the marker hostage — a host can
-        // still recover by calling installRemixIconStylesheet — but leave `injected` set so a later
-        // mount does not re-request the same missing file.
-        //
-        // UNVERIFIED, and deliberately not relied on: whether this also fires for the `200 text/html`
-        // SPA-fallback shape that case actually takes. A stylesheet served as `text/html` is refused
-        // under strict MIME checking, which is specified to fire `error` — but that has not been
-        // exercised here, so treat the warning as a bonus in that shape, not a guarantee.
-        link.remove();
-        warnOnce(`the default stylesheet failed to load from ${href}. ${OPT_IN_HINT}`);
-    });
-    document.head.appendChild(link);
-    injected = true;
-}
+import { ensureRemixIconStylesheet } from './RemixIcon.stylesheet.js';
+export { installRemixIconStylesheet, REMIXICON_STYLESHEET_MARKER } from './RemixIcon.stylesheet.js';
 /**
  * Thin wrapper around a RemixIcon webfont glyph (`ri-<name>`). Loads this package's own default
  * RemixIcon CSS/font the first time any `RemixIcon` mounts — see
@@ -183,7 +10,7 @@ function ensureRemixIconStylesheet() {
  */
 export function RemixIcon({ name, size = 14, className, style }) {
     useEffect(() => {
-        ensureRemixIconStylesheet();
+        ensureRemixIconStylesheet({});
     }, []);
     return (_jsx("i", { className: `ri-${name}${className ? ` ${className}` : ''}`, "aria-hidden": "true", style: {
             fontSize: size,

package/dist/react/components/RemixIcon.stylesheet.d.ts

@@ -0,0 +1,84 @@
+/**
+ * Marks whichever stylesheet is currently serving `.ri-*` glyphs — this package's own default, or
+ * a host override that got inserted first. `ensureRemixIconStylesheet` checks for this attribute
+ * (not a specific `href`) before injecting, so a host that wants its own icon set/font just needs
+ * to add a `<link data-jini-remixicon rel="stylesheet" href="...">` (or an equivalent `<style
+ * data-jini-remixicon>`) anywhere in `<head>` before the first `RemixIcon` mounts, and this
+ * package's default never loads.
+ *
+ * Exported because every host that has needed the override so far re-declared this string
+ * literally rather than importing it -- three copies outside this file, across two apps of the
+ * one downstream checkout inspected (2026-09-06), and they do not agree on element type: one
+ * installs a `<style>`, the other a `<link>`. A copied magic string is a rename away from
+ * silently double-loading the font; importing the constant is not.
+ */
+export declare const REMIXICON_STYLESHEET_MARKER = "data-jini-remixicon";
+/**
+ * Installs a caller-supplied stylesheet as the one serving `.ri-*` glyphs, claiming
+ * {@link REMIXICON_STYLESHEET_MARKER} so this package's own default never loads.
+ *
+ * This is the supported opt-in for any host whose bundler defeats the default's `import.meta.url`
+ * resolution (see {@link ensureRemixIconStylesheet}) — point it at
+ * `@jini-ai/ui/remixicon.css`, which is a normal subpath export a bundler resolves and rewrites
+ * like any other asset. Call it before the first `RemixIcon` mounts; module top level in the
+ * host's entry file is the usual place, since the default injection runs from a `useEffect` and
+ * therefore only has to lose a race against React's commit phase.
+ *
+ * Idempotent and safe to call unconditionally: it no-ops if any marked stylesheet is already
+ * present (including one a previous call installed), and no-ops outside a DOM.
+ *
+ * @param options.href URL of a stylesheet defining the `.ri-*` classes and its own `@font-face`.
+ *   Resolved by the browser against the document, so relative values follow the page's base URL —
+ *   pass a bundler-produced URL rather than a hand-written relative path.
+ * @returns `true` if this call inserted the stylesheet, `false` if it no-opped.
+ * @sideEffects Appends one `<link>` to `document.head`; probes and retries its icon font.
+ * @complexity O(n + r) including recovery, for n stylesheet rules and r bounded retries.
+ * @overallScore 100
+ */
+export declare function installRemixIconStylesheet(options: {
+    href: string;
+}, _optional?: object): boolean;
+/**
+ * Idempotently loads this package's default RemixIcon webfont/CSS on first use, so a host gets
+ * working icons out of the box with zero setup — see {@link REMIXICON_STYLESHEET_MARKER} for how a
+ * host overrides this and {@link installRemixIconStylesheet} for the supported way to do it.
+ *
+ * **This default only survives unbundled ESM, and that is not a fixable property of this
+ * function.** It resolves the CSS with `new URL('./remixicon-font/remixicon.css',
+ * import.meta.url)`, which is correct exactly while this module is still a real ES module sitting
+ * next to its own `remixicon-font/` directory. Three bundler transformations break it three
+ * different ways. The first two were confirmed live against this component; the third was
+ * confirmed live against its sibling, and is listed because nothing exempts this file from it:
+ *
+ * - **`iife`/`umd` output** cannot express the reference at all and degrades it to an inlined
+ *   `data:` URL whose own relative `@font-face` src can never resolve. Confirmed live in a
+ *   downstream `lib`/`iife` widget bundle, where `document.fonts` reported the `remixicon` face
+ *   as `status: "error"` with no matching resource entry at all — an unattempted fetch, not a
+ *   404. Detected and refused by {@link resolveDefaultStylesheetHref}.
+ * - **Production ESM builds** may copy the CSS as an opaque asset without descending into its
+ *   `url(./remixicon.woff2)`, emitting the stylesheet without the font beside it. Confirmed live
+ *   in a downstream admin SPA build, which is why that host imports the CSS through its
+ *   bundler's real CSS pipeline instead of letting this default run.
+ * - **Vite dev-server dependency pre-bundling** flattens a package module into a `.vite/deps/`
+ *   chunk, so an `import.meta.url`-relative URL resolves against the chunk's location instead.
+ *   Observed live for this package's `AgentIcon` (fixed in 58bf42fa by inlining those assets as
+ *   `data:` URIs — not an option here, see {@link installRemixIconStylesheet}), *not* observed
+ *   for this component, whose two known hosts both claim the marker before this default ever
+ *   runs. Worth knowing how it presented there: not as a 404, but as the dev server's SPA
+ *   history fallback answering `200 text/html`.
+ *
+ * A previous version of this comment claimed "Vite/Rollup/webpack all rewrite this correctly at
+ * build time". They do not, and each downstream host that hit it rediscovered a different half
+ * of the above independently. There is no runtime-resolvable URL that survives all of it — the
+ * cannot know where, or whether, its sibling asset was emitted — so the honest contract is: the
+ * default is a convenience for unbundled ESM, and any bundled host should call
+ * {@link installRemixIconStylesheet} instead. This function's job is to make that failure *loud*
+ * rather than silent, since tofu glyphs give no clue where to look.
+ *
+ * @sideEffects Appends at most one `<link>` to `document.head`; may emit one `console.warn`.
+ *   Probes and retries the installed font, including a host-provided marked override.
+ * @complexity O(n + r) including recovery, for n stylesheet rules and r bounded retries.
+ * @overallScore 100
+ */
+export declare function ensureRemixIconStylesheet(_input: object, _optional?: object): void;
+//# sourceMappingURL=RemixIcon.stylesheet.d.ts.map

package/dist/react/components/RemixIcon.stylesheet.js

@@ -0,0 +1,208 @@
+import { startRemixIconStylesheetRecovery } from './remixicon-font-recovery.js';
+/** Start once per installed sheet, waiting for linked CSS before inspecting its font source. */
+function recoverFont({ stylesheet }) {
+    if (!document.fonts || typeof FontFace === 'undefined')
+        return;
+    if (stylesheet.tagName !== 'STYLE' && stylesheet.tagName !== 'LINK')
+        return;
+    const sheet = stylesheet;
+    const start = () => startRemixIconStylesheetRecovery({
+        stylesheet: sheet,
+        fonts: document.fonts,
+        baseUrl: document.baseURI,
+        createFontFace: ({ family, source, descriptors }) => new FontFace(family, source, descriptors),
+        timers: {
+            setTimeout: (run, delay) => globalThis.setTimeout(run, delay),
+            clearTimeout: (handle) => globalThis.clearTimeout(handle),
+        },
+    });
+    if (sheet.sheet) {
+        start();
+        return;
+    }
+    sheet.addEventListener('load', start, { once: true });
+}
+/**
+ * Marks whichever stylesheet is currently serving `.ri-*` glyphs — this package's own default, or
+ * a host override that got inserted first. `ensureRemixIconStylesheet` checks for this attribute
+ * (not a specific `href`) before injecting, so a host that wants its own icon set/font just needs
+ * to add a `<link data-jini-remixicon rel="stylesheet" href="...">` (or an equivalent `<style
+ * data-jini-remixicon>`) anywhere in `<head>` before the first `RemixIcon` mounts, and this
+ * package's default never loads.
+ *
+ * Exported because every host that has needed the override so far re-declared this string
+ * literally rather than importing it -- three copies outside this file, across two apps of the
+ * one downstream checkout inspected (2026-09-06), and they do not agree on element type: one
+ * installs a `<style>`, the other a `<link>`. A copied magic string is a rename away from
+ * silently double-loading the font; importing the constant is not.
+ */
+export const REMIXICON_STYLESHEET_MARKER = 'data-jini-remixicon';
+let injected = false;
+let warned = false;
+/**
+ * One diagnostic per page load, not one per `RemixIcon` mount — the failure this reports is a
+ * build/bundler property, so it is the same failure every time and a per-mount warning would bury
+ * the rest of the console under it.
+ *
+ * @complexity O(1) time, O(1) space.
+ * @overallScore 100
+ */
+function warnOnce(message) {
+    if (warned)
+        return;
+    warned = true;
+    console.warn(`[@jini-ai/ui] RemixIcon: ${message}`);
+}
+const OPT_IN_HINT = 'Import the stylesheet yourself and install it via ' +
+    "`installRemixIconStylesheet({ href })` — the subpath export `@jini-ai/ui/remixicon.css` " +
+    'resolves through your bundler normally, unlike this runtime default.';
+/**
+ * Installs a caller-supplied stylesheet as the one serving `.ri-*` glyphs, claiming
+ * {@link REMIXICON_STYLESHEET_MARKER} so this package's own default never loads.
+ *
+ * This is the supported opt-in for any host whose bundler defeats the default's `import.meta.url`
+ * resolution (see {@link ensureRemixIconStylesheet}) — point it at
+ * `@jini-ai/ui/remixicon.css`, which is a normal subpath export a bundler resolves and rewrites
+ * like any other asset. Call it before the first `RemixIcon` mounts; module top level in the
+ * host's entry file is the usual place, since the default injection runs from a `useEffect` and
+ * therefore only has to lose a race against React's commit phase.
+ *
+ * Idempotent and safe to call unconditionally: it no-ops if any marked stylesheet is already
+ * present (including one a previous call installed), and no-ops outside a DOM.
+ *
+ * @param options.href URL of a stylesheet defining the `.ri-*` classes and its own `@font-face`.
+ *   Resolved by the browser against the document, so relative values follow the page's base URL —
+ *   pass a bundler-produced URL rather than a hand-written relative path.
+ * @returns `true` if this call inserted the stylesheet, `false` if it no-opped.
+ * @sideEffects Appends one `<link>` to `document.head`; probes and retries its icon font.
+ * @complexity O(n + r) including recovery, for n stylesheet rules and r bounded retries.
+ * @overallScore 100
+ */
+export function installRemixIconStylesheet(options, _optional = {}) {
+    if (typeof document === 'undefined')
+        return false;
+    const existing = document.querySelector(`[${REMIXICON_STYLESHEET_MARKER}]`);
+    if (existing) {
+        if (!injected)
+            recoverFont({ stylesheet: existing });
+        injected = true;
+        return false;
+    }
+    const link = document.createElement('link');
+    link.rel = 'stylesheet';
+    link.setAttribute(REMIXICON_STYLESHEET_MARKER, '');
+    link.href = options.href;
+    recoverFont({ stylesheet: link });
+    document.head.appendChild(link);
+    injected = true;
+    return true;
+}
+/**
+ * Resolves this package's bundled RemixIcon CSS relative to its own module URL, or `null` when
+ * that resolution has provably produced something unusable.
+ *
+ * The `null` case is not hypothetical. Bundling a `new URL(..., import.meta.url)` asset reference
+ * into a non-ESM output (Vite/Rollup `iife`, for one) makes Rollup inline the referenced file as a
+ * `data:text/css;base64,...` href instead. That stylesheet then loads, but its own
+ * `@font-face { src: url("./remixicon.woff2") }` is relative and a `data:` URL has no location to
+ * be relative *to*, so the font request is never even attempted and every glyph renders as tofu.
+ * Injecting it is strictly worse than injecting nothing, because it also claims
+ * {@link REMIXICON_STYLESHEET_MARKER} and so suppresses any override installed later.
+ *
+ * @returns An absolute URL string, or `null` if resolution failed or yielded a `data:`/`blob:` URL.
+ * @complexity O(1) time, O(1) space.
+ * @overallScore 100
+ */
+function resolveDefaultStylesheetHref() {
+    let resolved;
+    try {
+        resolved = new URL('./remixicon-font/remixicon.css', import.meta.url);
+    }
+    catch {
+        return null;
+    }
+    if (resolved.protocol === 'data:' || resolved.protocol === 'blob:')
+        return null;
+    return resolved.href;
+}
+/**
+ * Idempotently loads this package's default RemixIcon webfont/CSS on first use, so a host gets
+ * working icons out of the box with zero setup — see {@link REMIXICON_STYLESHEET_MARKER} for how a
+ * host overrides this and {@link installRemixIconStylesheet} for the supported way to do it.
+ *
+ * **This default only survives unbundled ESM, and that is not a fixable property of this
+ * function.** It resolves the CSS with `new URL('./remixicon-font/remixicon.css',
+ * import.meta.url)`, which is correct exactly while this module is still a real ES module sitting
+ * next to its own `remixicon-font/` directory. Three bundler transformations break it three
+ * different ways. The first two were confirmed live against this component; the third was
+ * confirmed live against its sibling, and is listed because nothing exempts this file from it:
+ *
+ * - **`iife`/`umd` output** cannot express the reference at all and degrades it to an inlined
+ *   `data:` URL whose own relative `@font-face` src can never resolve. Confirmed live in a
+ *   downstream `lib`/`iife` widget bundle, where `document.fonts` reported the `remixicon` face
+ *   as `status: "error"` with no matching resource entry at all — an unattempted fetch, not a
+ *   404. Detected and refused by {@link resolveDefaultStylesheetHref}.
+ * - **Production ESM builds** may copy the CSS as an opaque asset without descending into its
+ *   `url(./remixicon.woff2)`, emitting the stylesheet without the font beside it. Confirmed live
+ *   in a downstream admin SPA build, which is why that host imports the CSS through its
+ *   bundler's real CSS pipeline instead of letting this default run.
+ * - **Vite dev-server dependency pre-bundling** flattens a package module into a `.vite/deps/`
+ *   chunk, so an `import.meta.url`-relative URL resolves against the chunk's location instead.
+ *   Observed live for this package's `AgentIcon` (fixed in 58bf42fa by inlining those assets as
+ *   `data:` URIs — not an option here, see {@link installRemixIconStylesheet}), *not* observed
+ *   for this component, whose two known hosts both claim the marker before this default ever
+ *   runs. Worth knowing how it presented there: not as a 404, but as the dev server's SPA
+ *   history fallback answering `200 text/html`.
+ *
+ * A previous version of this comment claimed "Vite/Rollup/webpack all rewrite this correctly at
+ * build time". They do not, and each downstream host that hit it rediscovered a different half
+ * of the above independently. There is no runtime-resolvable URL that survives all of it — the
+ * cannot know where, or whether, its sibling asset was emitted — so the honest contract is: the
+ * default is a convenience for unbundled ESM, and any bundled host should call
+ * {@link installRemixIconStylesheet} instead. This function's job is to make that failure *loud*
+ * rather than silent, since tofu glyphs give no clue where to look.
+ *
+ * @sideEffects Appends at most one `<link>` to `document.head`; may emit one `console.warn`.
+ *   Probes and retries the installed font, including a host-provided marked override.
+ * @complexity O(n + r) including recovery, for n stylesheet rules and r bounded retries.
+ * @overallScore 100
+ */
+export function ensureRemixIconStylesheet(_input, _optional = {}) {
+    if (injected || typeof document === 'undefined')
+        return;
+    const existing = document.querySelector(`[${REMIXICON_STYLESHEET_MARKER}]`);
+    if (existing) {
+        recoverFont({ stylesheet: existing });
+        injected = true;
+        return;
+    }
+    const href = resolveDefaultStylesheetHref();
+    if (href === null) {
+        // Claiming the marker with a stylesheet that cannot work would block a later override, so
+        // stay out of the way entirely and let the host know why its icons are blank.
+        injected = true;
+        warnOnce(`this bundle defeated the default stylesheet's own URL resolution. ${OPT_IN_HINT}`);
+        return;
+    }
+    const link = document.createElement('link');
+    link.rel = 'stylesheet';
+    link.setAttribute(REMIXICON_STYLESHEET_MARKER, '');
+    link.href = href;
+    link.addEventListener('error', () => {
+        // The pre-bundling case above: undetectable synchronously, because the href looked perfectly
+        // well formed. Drop the dead <link> so it stops holding the marker hostage — a host can
+        // still recover by calling installRemixIconStylesheet — but leave `injected` set so a later
+        // mount does not re-request the same missing file.
+        //
+        // UNVERIFIED, and deliberately not relied on: whether this also fires for the `200 text/html`
+        // SPA-fallback shape that case actually takes. A stylesheet served as `text/html` is refused
+        // under strict MIME checking, which is specified to fire `error` — but that has not been
+        // exercised here, so treat the warning as a bonus in that shape, not a guarantee.
+        link.remove();
+        warnOnce(`the default stylesheet failed to load from ${href}. ${OPT_IN_HINT}`);
+    });
+    recoverFont({ stylesheet: link });
+    document.head.appendChild(link);
+    injected = true;
+}
+//# sourceMappingURL=RemixIcon.stylesheet.js.map