@techzyapp/ui-library 1.0.41 → 1.0.43

package/dist/TranslatedFields-BpWU5ZcG.js

@@ -0,0 +1,86 @@
+import { jsx as m } from "react/jsx-runtime";
+import { forwardRef as D, useState as J, useRef as b, useEffect as R } from "react";
+import { u as M } from "./formContext-B7ln1Miy.js";
+import { b as j } from "./translations-D15tFHM1.js";
+import { f as P } from "./messages-BiRLMy1E.js";
+import { F as Q } from "./Flag-BEIqYQZg.js";
+import { T as U } from "./Tabs-BxZrgozI.js";
+import { a as X, i as Y, r as Z } from "./ConfigProvider-Dqfu7UBU.js";
+const $ = "_fields_aawaf_4", ee = {
+  fields: $
+}, ue = D(
+  function({
+    children: w,
+    locales: A,
+    namespace: K,
+    value: p,
+    defaultValue: N,
+    onChange: f,
+    showFlags: O = !0,
+    icon: W = "Global",
+    variant: k,
+    size: x,
+    "aria-label": L,
+    className: _,
+    style: q
+  }, i) {
+    var S;
+    const E = X(), I = L ?? E("translatedFields.label"), B = Y(), c = A ?? B, C = Z(), y = K ?? C, t = M(), T = p !== void 0, [G, H] = J(N), a = (T ? p : G) ?? ((S = c[0]) == null ? void 0 : S.code) ?? "", h = (e) => {
+      T || H(e), f == null || f(e);
+    }, l = (e) => j(e, "", y), V = (e) => !!t && Object.keys(t.errors).some(
+      (s) => s.startsWith(l(e)) && (t.isSubmitted || t.touched[s] === !0)
+    ), v = b(null), g = (e) => {
+      v.current = e, typeof i == "function" ? i(e) : i && (i.current = e);
+    }, F = b(0), u = b(null);
+    if (R(() => {
+      const e = (t == null ? void 0 : t.submitCount) ?? 0;
+      if (!t || e === F.current) return;
+      F.current = e;
+      const s = Object.keys(t.errors);
+      if (s.length === 0) return;
+      const r = (n) => c.some((d) => n.startsWith(l(d.code)));
+      if (!s.every(r) || s.some((n) => n.startsWith(l(a)))) return;
+      const o = c.find((n) => s.some((d) => d.startsWith(l(n.code))));
+      o && o.code !== a && (u.current = o.code, h(o.code));
+    }, [t == null ? void 0 : t.submitCount]), R(() => {
+      var o;
+      if (u.current == null || u.current !== a) return;
+      u.current = null;
+      const e = v.current;
+      if (!e || !t) return;
+      const s = new Set(Object.keys(t.errors)), r = Array.from(e.querySelectorAll("[name]")).find(
+        (n) => s.has(n.getAttribute("name") ?? "")
+      );
+      (o = r == null ? void 0 : r.scrollIntoView) == null || o.call(r, { behavior: "smooth", block: "center" }), r == null || r.focus({ preventScroll: !0 });
+    }, [a]), c.length === 0) return null;
+    const z = c.map((e) => ({
+      value: e.code,
+      label: e.label ?? e.code,
+      // the locale's flag when it has one (and flags are enabled), else the fallback `icon` (Global)
+      icon: O && P(e.code) ? /* @__PURE__ */ m(Q, { code: e.code }) : W,
+      // an invalid locale shows the Tabs error dot (a small red dot — no full-tab tint)
+      error: V(e.code),
+      // keyed by locale so switching tabs remounts the fields (no value/state bleed between locales)
+      content: /* @__PURE__ */ m("div", { className: ee.fields, children: w((s) => j(e.code, s, y), e.code) }, e.code)
+    }));
+    return /* @__PURE__ */ m(
+      U,
+      {
+        ref: g,
+        className: _,
+        style: q,
+        items: z,
+        value: a,
+        onChange: h,
+        variant: k,
+        size: x,
+        queryKey: null,
+        "aria-label": I
+      }
+    );
+  }
+);
+export {
+  ue as T
+};
+//# sourceMappingURL=TranslatedFields-BpWU5ZcG.js.map

package/dist/TranslatedFields-BpWU5ZcG.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"TranslatedFields-BpWU5ZcG.js","sources":["../src/components/TranslatedFields/TranslatedFields.tsx"],"sourcesContent":["import { forwardRef, useEffect, useRef, useState, type CSSProperties, type ReactNode } from 'react'\nimport { useFormContext } from '../../form/formContext'\nimport { useLocales, useT, useTranslationsNamespace, type LocaleConfig } from '../../theme'\nimport { buildTranslationName } from '../../helpers/translations'\nimport { flagFor } from '../../i18n/messages'\nimport type { IconName } from '../../icons/names'\nimport { Flag } from '../Flag'\nimport { Tabs, type TabsSize, type TabsVariant } from '../Tabs'\nimport styles from './TranslatedFields.module.css'\n\n/** Builds a field's namespaced form name for the active locale (`(field) => name`). */\nexport type TranslatedFieldName = (field: string) => string\n\nexport interface TranslatedFieldsProps {\n  /**\n   * Render the fields for one locale. `name(field)` returns the namespaced form name to put on each\n   * control (e.g. `translations[en-US].title`); `locale` is the active code. The same render runs per\n   * locale, so the fields are identical bar their names.\n   */\n  children: (name: TranslatedFieldName, locale: string) => ReactNode\n  /**\n   * Locales (one tab each). Defaults to the app's configured locales\n   * (`<ConfigProvider config={{ locales }}>`).\n   */\n  locales?: LocaleConfig[]\n  /**\n   * Top-level namespace for the field names (`<namespace>[<locale>].<field>`) and the nested object.\n   * Falls back to `<ConfigProvider config={{ keys: { translationsNamespace } }}>`, then `'translations'`.\n   * Pass to override per-instance (e.g. `'languages'`).\n   */\n  namespace?: string\n  /** Controlled active locale code. */\n  value?: string\n  /** Initial active locale code (uncontrolled). Defaults to the first locale. */\n  defaultValue?: string\n  /** Fires with the next active locale code. */\n  onChange?: (locale: string) => void\n  /**\n   * Show each locale's **flag** on its tab (matched by the language via `flagFor`). A language with no\n   * built-in flag falls back to the `icon`. Defaults to `true`; pass `false` to always use `icon`.\n   */\n  showFlags?: boolean\n  /** Fallback icon shown on a locale tab when its language has no flag (or `showFlags={false}`). Defaults to `'Global'`. */\n  icon?: IconName\n  /** Tab strip variant. Defaults to `Tabs`' default (`underline`). */\n  variant?: TabsVariant\n  /** Tab + field density. Defaults to `Tabs`' default (`md`). */\n  size?: TabsSize\n  /** Accessible label for the tablist. Defaults to the localized `translatedFields.label` (\"Translations\"). */\n  'aria-label'?: string\n  className?: string\n  style?: CSSProperties\n}\n\n/**\n * A tabbed group of **per-locale** form fields — one tab per content locale, each rendering the same\n * fields with locale-namespaced `name`s (`translations[<locale>].<field>` by default), so a `<Form>`\n * submits e.g. `translations[en-US].title` / `translations[ka-GE].title`. You supply the fields once\n * via a render function that receives a `name(field)` builder for the active locale; bring any field\n * component (`TextField`, `MultilineTextField`, a rich-text editor, …). Locales come from\n * `<ConfigProvider config={{ locales }}>` (override with the `locales` prop). The top-level word is the\n * `namespace` (default `'translations'`, e.g. `'languages'`). Each tab shows its language's **flag**\n * (matched via `flagFor`); a language with no built-in flag falls back to the `icon` (a `Global` icon by\n * default), and `showFlags={false}` uses the `icon` for every tab. While inside a `<Form>`, an incomplete\n * locale's tab shows a **dot**, and on submit the strip auto-advances to the first locale with errors\n * and focuses its field. Build the schema / defaults with `buildTranslations`; the form values stay\n * **flat** (`translations[en-US].title` — the `FormData` shape) — convert to/from the **nested** JSON\n * shape (`{ translations: { 'en-US': { title } } }`) with `nestTranslations` / `flattenTranslations`.\n * Requires the `Tabs` component.\n */\nexport const TranslatedFields = forwardRef<HTMLDivElement, TranslatedFieldsProps>(\n  function TranslatedFields(\n    {\n      children,\n      locales: localesProp,\n      namespace: namespaceProp,\n      value,\n      defaultValue,\n      onChange,\n      showFlags = true,\n      icon = 'Global',\n      variant,\n      size,\n      'aria-label': ariaLabelProp,\n      className,\n      style,\n    },\n    ref,\n  ) {\n    const t = useT()\n    const ariaLabel = ariaLabelProp ?? t('translatedFields.label')\n    const configLocales = useLocales()\n    const locales = localesProp ?? configLocales\n    // namespace: the `namespace` prop wins, else the ConfigProvider's (which falls back to the default)\n    const configNamespace = useTranslationsNamespace()\n    const namespace = namespaceProp ?? configNamespace\n    const form = useFormContext()\n\n    // active locale — controlled (`value`) or internal; falls back to the first locale\n    const isControlled = value !== undefined\n    const [internal, setInternal] = useState<string | undefined>(defaultValue)\n    const active = (isControlled ? value : internal) ?? locales[0]?.code ?? ''\n    const setActive = (next: string) => {\n      if (!isControlled) setInternal(next)\n      onChange?.(next)\n    }\n\n    // the namespaced-name prefix for a locale (e.g. `translations[en-US].`)\n    const prefixOf = (code: string) => buildTranslationName(code, '', namespace)\n    // a locale's tab is flagged when any of its fields is invalid AND the error is shown (submitted/touched)\n    const localeHasError = (code: string): boolean =>\n      !!form &&\n      Object.keys(form.errors).some(\n        (key) => key.startsWith(prefixOf(code)) && (form.isSubmitted || form.touched[key] === true),\n      )\n\n    // merge the forwarded ref with an internal one (to query the mounted fields for scroll/focus)\n    const rootRef = useRef<HTMLDivElement | null>(null)\n    const setRootRef = (node: HTMLDivElement | null) => {\n      rootRef.current = node\n      if (typeof ref === 'function') ref(node)\n      else if (ref) (ref as { current: HTMLDivElement | null }).current = node\n    }\n\n    // on each submit, if the active tab is complete but another locale has the only remaining errors,\n    // switch to it and focus its first invalid field (the form's own scroll can't reach an unmounted tab)\n    const lastSubmit = useRef(0)\n    const pendingFocus = useRef<string | null>(null)\n    useEffect(() => {\n      const count = form?.submitCount ?? 0\n      if (!form || count === lastSubmit.current) return\n      lastSubmit.current = count\n      const errorKeys = Object.keys(form.errors)\n      if (errorKeys.length === 0) return\n      const isTranslationKey = (k: string) => locales.some((l) => k.startsWith(prefixOf(l.code)))\n      // a non-translation field is still invalid → the form's scroll-to-error handles it (above the tabs)\n      if (!errorKeys.every(isTranslationKey)) return\n      // active locale already shows its (mounted) errors → nothing to switch to\n      if (errorKeys.some((k) => k.startsWith(prefixOf(active)))) return\n      const firstBad = locales.find((l) => errorKeys.some((k) => k.startsWith(prefixOf(l.code))))\n      if (firstBad && firstBad.code !== active) {\n        pendingFocus.current = firstBad.code\n        setActive(firstBad.code)\n      }\n      // eslint-disable-next-line react-hooks/exhaustive-deps\n    }, [form?.submitCount])\n\n    // once the auto-switched tab has mounted, focus its first invalid field\n    useEffect(() => {\n      if (pendingFocus.current == null || pendingFocus.current !== active) return\n      pendingFocus.current = null\n      const root = rootRef.current\n      if (!root || !form) return\n      const errorKeys = new Set(Object.keys(form.errors))\n      const target = Array.from(root.querySelectorAll<HTMLElement>('[name]')).find((el) =>\n        errorKeys.has(el.getAttribute('name') ?? ''),\n      )\n      target?.scrollIntoView?.({ behavior: 'smooth', block: 'center' })\n      target?.focus({ preventScroll: true })\n      // eslint-disable-next-line react-hooks/exhaustive-deps\n    }, [active])\n\n    if (locales.length === 0) return null\n\n    const items = locales.map((loc) => ({\n      value: loc.code,\n      label: loc.label ?? loc.code,\n      // the locale's flag when it has one (and flags are enabled), else the fallback `icon` (Global)\n      icon: showFlags && flagFor(loc.code) ? <Flag code={loc.code} /> : icon,\n      // an invalid locale shows the Tabs error dot (a small red dot — no full-tab tint)\n      error: localeHasError(loc.code),\n      // keyed by locale so switching tabs remounts the fields (no value/state bleed between locales)\n      content: (\n        <div key={loc.code} className={styles.fields}>\n          {children((field) => buildTranslationName(loc.code, field, namespace), loc.code)}\n        </div>\n      ),\n    }))\n\n    return (\n      <Tabs\n        ref={setRootRef}\n        className={className}\n        style={style}\n        items={items}\n        value={active}\n        onChange={setActive}\n        variant={variant}\n        size={size}\n        // locale tabs are internal UI — never sync them to the page URL\n        queryKey={null}\n        aria-label={ariaLabel}\n      />\n    )\n  },\n)\n"],"names":["TranslatedFields","forwardRef","children","localesProp","namespaceProp","value","defaultValue","onChange","showFlags","icon","variant","size","ariaLabelProp","className","style","ref","t","useT","ariaLabel","configLocales","useLocales","locales","configNamespace","useTranslationsNamespace","namespace","form","useFormContext","isControlled","internal","setInternal","useState","active","_a","setActive","next","prefixOf","code","buildTranslationName","localeHasError","key","rootRef","useRef","setRootRef","node","lastSubmit","pendingFocus","useEffect","count","errorKeys","isTranslationKey","k","l","firstBad","root","target","el","items","loc","flagFor","jsx","Flag","styles","field","Tabs"],"mappings":"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"}

package/dist/TranslatedFields-SvS37hab.cjs

@@ -0,0 +1,2 @@
+"use strict";const b=require("react/jsx-runtime"),c=require("react"),z=require("./formContext-bTWrqdEV.cjs"),j=require("./translations-CXEeeUDL.cjs"),D=require("./messages-C_fRRCg6.cjs"),J=require("./Flag-B1ZvZVXi.cjs"),M=require("./Tabs-C4kB1yfG.cjs"),y=require("./ConfigProvider-Ci9Q2HLF.cjs"),Q="_fields_aawaf_4",U={fields:Q},X=c.forwardRef(function({children:x,locales:S,namespace:N,value:q,defaultValue:w,onChange:f,showFlags:A=!0,icon:K="Global",variant:O,size:W,"aria-label":g,className:k,style:C},l){var R;const E=y.useT(),L=g??E("translatedFields.label"),_=y.useLocales(),i=S??_,I=y.useTranslationsNamespace(),T=N??I,s=z.useFormContext(),p=q!==void 0,[B,G]=c.useState(w),a=(p?q:B)??((R=i[0])==null?void 0:R.code)??"",v=e=>{p||G(e),f==null||f(e)},u=e=>j.buildTranslationName(e,"",T),H=e=>!!s&&Object.keys(s.errors).some(t=>t.startsWith(u(e))&&(s.isSubmitted||s.touched[t]===!0)),F=c.useRef(null),P=e=>{F.current=e,typeof l=="function"?l(e):l&&(l.current=e)},h=c.useRef(0),d=c.useRef(null);if(c.useEffect(()=>{const e=(s==null?void 0:s.submitCount)??0;if(!s||e===h.current)return;h.current=e;const t=Object.keys(s.errors);if(t.length===0)return;const r=o=>i.some(m=>o.startsWith(u(m.code)));if(!t.every(r)||t.some(o=>o.startsWith(u(a))))return;const n=i.find(o=>t.some(m=>m.startsWith(u(o.code))));n&&n.code!==a&&(d.current=n.code,v(n.code))},[s==null?void 0:s.submitCount]),c.useEffect(()=>{var n;if(d.current==null||d.current!==a)return;d.current=null;const e=F.current;if(!e||!s)return;const t=new Set(Object.keys(s.errors)),r=Array.from(e.querySelectorAll("[name]")).find(o=>t.has(o.getAttribute("name")??""));(n=r==null?void 0:r.scrollIntoView)==null||n.call(r,{behavior:"smooth",block:"center"}),r==null||r.focus({preventScroll:!0})},[a]),i.length===0)return null;const V=i.map(e=>({value:e.code,label:e.label??e.code,icon:A&&D.flagFor(e.code)?b.jsx(J.Flag,{code:e.code}):K,error:H(e.code),content:b.jsx("div",{className:U.fields,children:x(t=>j.buildTranslationName(e.code,t,T),e.code)},e.code)}));return b.jsx(M.Tabs,{ref:P,className:k,style:C,items:V,value:a,onChange:v,variant:O,size:W,queryKey:null,"aria-label":L})});exports.TranslatedFields=X;
+//# sourceMappingURL=TranslatedFields-SvS37hab.cjs.map

package/dist/TranslatedFields-SvS37hab.cjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"TranslatedFields-SvS37hab.cjs","sources":["../src/components/TranslatedFields/TranslatedFields.tsx"],"sourcesContent":["import { forwardRef, useEffect, useRef, useState, type CSSProperties, type ReactNode } from 'react'\nimport { useFormContext } from '../../form/formContext'\nimport { useLocales, useT, useTranslationsNamespace, type LocaleConfig } from '../../theme'\nimport { buildTranslationName } from '../../helpers/translations'\nimport { flagFor } from '../../i18n/messages'\nimport type { IconName } from '../../icons/names'\nimport { Flag } from '../Flag'\nimport { Tabs, type TabsSize, type TabsVariant } from '../Tabs'\nimport styles from './TranslatedFields.module.css'\n\n/** Builds a field's namespaced form name for the active locale (`(field) => name`). */\nexport type TranslatedFieldName = (field: string) => string\n\nexport interface TranslatedFieldsProps {\n  /**\n   * Render the fields for one locale. `name(field)` returns the namespaced form name to put on each\n   * control (e.g. `translations[en-US].title`); `locale` is the active code. The same render runs per\n   * locale, so the fields are identical bar their names.\n   */\n  children: (name: TranslatedFieldName, locale: string) => ReactNode\n  /**\n   * Locales (one tab each). Defaults to the app's configured locales\n   * (`<ConfigProvider config={{ locales }}>`).\n   */\n  locales?: LocaleConfig[]\n  /**\n   * Top-level namespace for the field names (`<namespace>[<locale>].<field>`) and the nested object.\n   * Falls back to `<ConfigProvider config={{ keys: { translationsNamespace } }}>`, then `'translations'`.\n   * Pass to override per-instance (e.g. `'languages'`).\n   */\n  namespace?: string\n  /** Controlled active locale code. */\n  value?: string\n  /** Initial active locale code (uncontrolled). Defaults to the first locale. */\n  defaultValue?: string\n  /** Fires with the next active locale code. */\n  onChange?: (locale: string) => void\n  /**\n   * Show each locale's **flag** on its tab (matched by the language via `flagFor`). A language with no\n   * built-in flag falls back to the `icon`. Defaults to `true`; pass `false` to always use `icon`.\n   */\n  showFlags?: boolean\n  /** Fallback icon shown on a locale tab when its language has no flag (or `showFlags={false}`). Defaults to `'Global'`. */\n  icon?: IconName\n  /** Tab strip variant. Defaults to `Tabs`' default (`underline`). */\n  variant?: TabsVariant\n  /** Tab + field density. Defaults to `Tabs`' default (`md`). */\n  size?: TabsSize\n  /** Accessible label for the tablist. Defaults to the localized `translatedFields.label` (\"Translations\"). */\n  'aria-label'?: string\n  className?: string\n  style?: CSSProperties\n}\n\n/**\n * A tabbed group of **per-locale** form fields — one tab per content locale, each rendering the same\n * fields with locale-namespaced `name`s (`translations[<locale>].<field>` by default), so a `<Form>`\n * submits e.g. `translations[en-US].title` / `translations[ka-GE].title`. You supply the fields once\n * via a render function that receives a `name(field)` builder for the active locale; bring any field\n * component (`TextField`, `MultilineTextField`, a rich-text editor, …). Locales come from\n * `<ConfigProvider config={{ locales }}>` (override with the `locales` prop). The top-level word is the\n * `namespace` (default `'translations'`, e.g. `'languages'`). Each tab shows its language's **flag**\n * (matched via `flagFor`); a language with no built-in flag falls back to the `icon` (a `Global` icon by\n * default), and `showFlags={false}` uses the `icon` for every tab. While inside a `<Form>`, an incomplete\n * locale's tab shows a **dot**, and on submit the strip auto-advances to the first locale with errors\n * and focuses its field. Build the schema / defaults with `buildTranslations`; the form values stay\n * **flat** (`translations[en-US].title` — the `FormData` shape) — convert to/from the **nested** JSON\n * shape (`{ translations: { 'en-US': { title } } }`) with `nestTranslations` / `flattenTranslations`.\n * Requires the `Tabs` component.\n */\nexport const TranslatedFields = forwardRef<HTMLDivElement, TranslatedFieldsProps>(\n  function TranslatedFields(\n    {\n      children,\n      locales: localesProp,\n      namespace: namespaceProp,\n      value,\n      defaultValue,\n      onChange,\n      showFlags = true,\n      icon = 'Global',\n      variant,\n      size,\n      'aria-label': ariaLabelProp,\n      className,\n      style,\n    },\n    ref,\n  ) {\n    const t = useT()\n    const ariaLabel = ariaLabelProp ?? t('translatedFields.label')\n    const configLocales = useLocales()\n    const locales = localesProp ?? configLocales\n    // namespace: the `namespace` prop wins, else the ConfigProvider's (which falls back to the default)\n    const configNamespace = useTranslationsNamespace()\n    const namespace = namespaceProp ?? configNamespace\n    const form = useFormContext()\n\n    // active locale — controlled (`value`) or internal; falls back to the first locale\n    const isControlled = value !== undefined\n    const [internal, setInternal] = useState<string | undefined>(defaultValue)\n    const active = (isControlled ? value : internal) ?? locales[0]?.code ?? ''\n    const setActive = (next: string) => {\n      if (!isControlled) setInternal(next)\n      onChange?.(next)\n    }\n\n    // the namespaced-name prefix for a locale (e.g. `translations[en-US].`)\n    const prefixOf = (code: string) => buildTranslationName(code, '', namespace)\n    // a locale's tab is flagged when any of its fields is invalid AND the error is shown (submitted/touched)\n    const localeHasError = (code: string): boolean =>\n      !!form &&\n      Object.keys(form.errors).some(\n        (key) => key.startsWith(prefixOf(code)) && (form.isSubmitted || form.touched[key] === true),\n      )\n\n    // merge the forwarded ref with an internal one (to query the mounted fields for scroll/focus)\n    const rootRef = useRef<HTMLDivElement | null>(null)\n    const setRootRef = (node: HTMLDivElement | null) => {\n      rootRef.current = node\n      if (typeof ref === 'function') ref(node)\n      else if (ref) (ref as { current: HTMLDivElement | null }).current = node\n    }\n\n    // on each submit, if the active tab is complete but another locale has the only remaining errors,\n    // switch to it and focus its first invalid field (the form's own scroll can't reach an unmounted tab)\n    const lastSubmit = useRef(0)\n    const pendingFocus = useRef<string | null>(null)\n    useEffect(() => {\n      const count = form?.submitCount ?? 0\n      if (!form || count === lastSubmit.current) return\n      lastSubmit.current = count\n      const errorKeys = Object.keys(form.errors)\n      if (errorKeys.length === 0) return\n      const isTranslationKey = (k: string) => locales.some((l) => k.startsWith(prefixOf(l.code)))\n      // a non-translation field is still invalid → the form's scroll-to-error handles it (above the tabs)\n      if (!errorKeys.every(isTranslationKey)) return\n      // active locale already shows its (mounted) errors → nothing to switch to\n      if (errorKeys.some((k) => k.startsWith(prefixOf(active)))) return\n      const firstBad = locales.find((l) => errorKeys.some((k) => k.startsWith(prefixOf(l.code))))\n      if (firstBad && firstBad.code !== active) {\n        pendingFocus.current = firstBad.code\n        setActive(firstBad.code)\n      }\n      // eslint-disable-next-line react-hooks/exhaustive-deps\n    }, [form?.submitCount])\n\n    // once the auto-switched tab has mounted, focus its first invalid field\n    useEffect(() => {\n      if (pendingFocus.current == null || pendingFocus.current !== active) return\n      pendingFocus.current = null\n      const root = rootRef.current\n      if (!root || !form) return\n      const errorKeys = new Set(Object.keys(form.errors))\n      const target = Array.from(root.querySelectorAll<HTMLElement>('[name]')).find((el) =>\n        errorKeys.has(el.getAttribute('name') ?? ''),\n      )\n      target?.scrollIntoView?.({ behavior: 'smooth', block: 'center' })\n      target?.focus({ preventScroll: true })\n      // eslint-disable-next-line react-hooks/exhaustive-deps\n    }, [active])\n\n    if (locales.length === 0) return null\n\n    const items = locales.map((loc) => ({\n      value: loc.code,\n      label: loc.label ?? loc.code,\n      // the locale's flag when it has one (and flags are enabled), else the fallback `icon` (Global)\n      icon: showFlags && flagFor(loc.code) ? <Flag code={loc.code} /> : icon,\n      // an invalid locale shows the Tabs error dot (a small red dot — no full-tab tint)\n      error: localeHasError(loc.code),\n      // keyed by locale so switching tabs remounts the fields (no value/state bleed between locales)\n      content: (\n        <div key={loc.code} className={styles.fields}>\n          {children((field) => buildTranslationName(loc.code, field, namespace), loc.code)}\n        </div>\n      ),\n    }))\n\n    return (\n      <Tabs\n        ref={setRootRef}\n        className={className}\n        style={style}\n        items={items}\n        value={active}\n        onChange={setActive}\n        variant={variant}\n        size={size}\n        // locale tabs are internal UI — never sync them to the page URL\n        queryKey={null}\n        aria-label={ariaLabel}\n      />\n    )\n  },\n)\n"],"names":["TranslatedFields","forwardRef","children","localesProp","namespaceProp","value","defaultValue","onChange","showFlags","icon","variant","size","ariaLabelProp","className","style","ref","t","useT","ariaLabel","configLocales","useLocales","locales","configNamespace","useTranslationsNamespace","namespace","form","useFormContext","isControlled","internal","setInternal","useState","active","_a","setActive","next","prefixOf","code","buildTranslationName","localeHasError","key","rootRef","useRef","setRootRef","node","lastSubmit","pendingFocus","useEffect","count","errorKeys","isTranslationKey","k","l","firstBad","root","target","el","items","loc","flagFor","jsx","Flag","styles","field","Tabs"],"mappings":"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"}

package/dist/{UserCard-B9bzkZph.cjs → UserCard-VPaexedS.cjs}

@@ -1,2 +1,2 @@
-"use strict";const t=require("react/jsx-runtime"),q=require("react"),p=require("clsx"),g=require("./Avatar-l48Ice6t.cjs"),C=require("./Button-ClVfHGBc.cjs"),S=require("./Icon-B6lz-V0A.cjs"),a=require("./Skeleton-DK0lAjS9.cjs"),d=require("./Typography-d97DdbNd.cjs"),w=require("./ConfigProvider-DELhJlqo.cjs"),T="_card_1fykc_3",U="_identity_1fykc_16",b="_text_1fykc_20",I="_sm_1fykc_33",N="_lg_1fykc_37",s={card:T,identity:U,text:b,sm:I,lg:N},A=q.forwardRef(function({name:c,email:n,avatar:l,icon:u="User",color:y="primary",size:e="md",onLogout:i,logoutLabel:x,children:m,loading:r=!1,className:_,style:f,...h},v){const o=w.useT(),j=e==="lg"?"lg":e==="sm"?"sm":"md",k=e==="lg"?"md":"sm";return t.jsxs("div",{ref:v,className:p.clsx(s.card,s[e],_),style:f,"aria-busy":r||void 0,...h,children:[t.jsxs("div",{className:s.identity,children:[t.jsx(g.Avatar,{size:j,name:c,src:l,icon:c?void 0:u,color:y,loading:r}),t.jsxs("div",{className:s.text,children:[t.jsx(d.Typography,{variant:"bodySmall",truncate:!0,children:r?t.jsx(a.Skeleton,{width:"60%"}):c??o("userCard.welcome")}),(r||n!=null)&&t.jsx(d.Typography,{variant:"caption",color:"muted",truncate:!0,children:r?t.jsx(a.Skeleton,{width:"85%"}):n})]})]}),m,i?t.jsx(C.Button,{variant:"filled",color:"error",size:k,fullWidth:!0,startIcon:t.jsx(S.Icon,{name:"Logout2"}),onClick:i,children:x??o("userCard.signOut")}):null]})});exports.UserCard=A;
-//# sourceMappingURL=UserCard-B9bzkZph.cjs.map
+"use strict";const t=require("react/jsx-runtime"),q=require("react"),p=require("clsx"),g=require("./Avatar-l48Ice6t.cjs"),C=require("./Button-Q_5uA-zc.cjs"),S=require("./Icon-B6lz-V0A.cjs"),a=require("./Skeleton-DK0lAjS9.cjs"),d=require("./Typography-d97DdbNd.cjs"),w=require("./ConfigProvider-Ci9Q2HLF.cjs"),T="_card_1fykc_3",U="_identity_1fykc_16",b="_text_1fykc_20",I="_sm_1fykc_33",N="_lg_1fykc_37",s={card:T,identity:U,text:b,sm:I,lg:N},A=q.forwardRef(function({name:c,email:n,avatar:l,icon:u="User",color:y="primary",size:e="md",onLogout:i,logoutLabel:x,children:m,loading:r=!1,className:_,style:f,...h},v){const o=w.useT(),j=e==="lg"?"lg":e==="sm"?"sm":"md",k=e==="lg"?"md":"sm";return t.jsxs("div",{ref:v,className:p.clsx(s.card,s[e],_),style:f,"aria-busy":r||void 0,...h,children:[t.jsxs("div",{className:s.identity,children:[t.jsx(g.Avatar,{size:j,name:c,src:l,icon:c?void 0:u,color:y,loading:r}),t.jsxs("div",{className:s.text,children:[t.jsx(d.Typography,{variant:"bodySmall",truncate:!0,children:r?t.jsx(a.Skeleton,{width:"60%"}):c??o("userCard.welcome")}),(r||n!=null)&&t.jsx(d.Typography,{variant:"caption",color:"muted",truncate:!0,children:r?t.jsx(a.Skeleton,{width:"85%"}):n})]})]}),m,i?t.jsx(C.Button,{variant:"filled",color:"error",size:k,fullWidth:!0,startIcon:t.jsx(S.Icon,{name:"Logout2"}),onClick:i,children:x??o("userCard.signOut")}):null]})});exports.UserCard=A;
+//# sourceMappingURL=UserCard-VPaexedS.cjs.map

package/dist/UserCard-VPaexedS.cjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"UserCard-VPaexedS.cjs","sources":["../src/components/UserCard/UserCard.tsx"],"sourcesContent":["import { forwardRef, type CSSProperties, type HTMLAttributes, type ReactNode } from 'react'\nimport { clsx } from 'clsx'\nimport { useT, type ThemeColor } from '../../theme'\nimport type { IconName } from '../../icons/names'\nimport { Avatar } from '../Avatar'\nimport { Button } from '../Button'\nimport { Icon } from '../Icon'\nimport { Skeleton } from '../Skeleton'\nimport { Typography } from '../Typography'\nimport styles from './UserCard.module.css'\n\nexport type UserCardSize = 'sm' | 'md' | 'lg'\n\nexport interface UserCardProps extends Omit<HTMLAttributes<HTMLDivElement>, 'color'> {\n  /**\n   * Display name — the primary line, and the source of the avatar initials. When omitted, the primary\n   * line falls back to a localized **\"Welcome\"** greeting (and the avatar shows the `icon`).\n   */\n  name?: string\n  /** Secondary line under the name (usually the email). */\n  email?: ReactNode\n  /** Avatar image URL (falls back to the initials from `name`, else the `icon`). */\n  avatar?: string\n  /** Fallback avatar icon when there's no image or name. Defaults to `'User'`. */\n  icon?: IconName\n  /** Theme palette token tinting the avatar. Defaults to `'primary'`. */\n  color?: ThemeColor\n  /** Preset size (avatar + button + card padding; the text stays fixed). Defaults to `'md'`. */\n  size?: UserCardSize\n  /** When provided, a **Sign out** button is shown that calls this. */\n  onLogout?: () => void\n  /** Sign-out button label. Defaults to `'Sign Out'`. */\n  logoutLabel?: ReactNode\n  /** Extra content between the identity row and the sign-out button (e.g. a link or menu). */\n  children?: ReactNode\n  /** Show skeletons for the avatar, name and email while the user is being fetched (sign-out stays usable). Defaults to `false`. */\n  loading?: boolean\n}\n\n/**\n * A compact account card — an `Avatar` + name/email and an optional **Sign out** button — for a consistent\n * signed-in-user block across apps, instead of hand-rolling the markup each time. The shell's sidebar renders\n * one itself (`config.sidebar.userCard` / the `RootLayout` `showUserCard` prop), so place it by hand only\n * elsewhere. Shows the image (`avatar`) → initials (from `name`) →\n * `icon` (default `User`) in priority order; renders the sign-out `Button` (filled `error`) only when\n * `onLogout` is given. `size` (`sm`/`md`/`lg`) scales the avatar, button and padding; `color` (default `primary`)\n * tints the avatar. `loading` swaps the avatar + name + email for skeletons. Own CSS module (token-only).\n */\nexport const UserCard = forwardRef<HTMLDivElement, UserCardProps>(function UserCard(\n  {\n    name,\n    email,\n    avatar,\n    icon = 'User',\n    color = 'primary',\n    size = 'md',\n    onLogout,\n    logoutLabel,\n    children,\n    loading = false,\n    className,\n    style,\n    ...props\n  },\n  ref,\n) {\n  const t = useT()\n  // the identity row + the sign-out button share the same visual size step\n  const avatarSize = size === 'lg' ? 'lg' : size === 'sm' ? 'sm' : 'md'\n  const buttonSize = size === 'lg' ? 'md' : 'sm'\n\n  return (\n    <div\n      ref={ref}\n      className={clsx(styles.card, styles[size], className)}\n      style={style as CSSProperties}\n      aria-busy={loading || undefined}\n      {...props}\n    >\n      <div className={styles.identity}>\n        {/* Avatar priority is image → icon → initials, so pass `icon` only as the last resort (no\n            name), otherwise a name would still show the icon instead of its initials */}\n        <Avatar\n          size={avatarSize}\n          name={name}\n          src={avatar}\n          icon={name ? undefined : icon}\n          color={color}\n          loading={loading}\n        />\n        <div className={styles.text}>\n          {/* primary line: the name, or a \"Welcome\" greeting fallback when no name is given */}\n          <Typography variant=\"bodySmall\" truncate>\n            {loading ? <Skeleton width=\"60%\" /> : (name ?? t('userCard.welcome'))}\n          </Typography>\n          {(loading || email != null) && (\n            <Typography variant=\"caption\" color=\"muted\" truncate>\n              {loading ? <Skeleton width=\"85%\" /> : email}\n            </Typography>\n          )}\n        </div>\n      </div>\n\n      {children}\n\n      {onLogout ? (\n        <Button\n          variant=\"filled\"\n          color=\"error\"\n          size={buttonSize}\n          fullWidth\n          startIcon={<Icon name=\"Logout2\" />}\n          onClick={onLogout}\n        >\n          {logoutLabel ?? t('userCard.signOut')}\n        </Button>\n      ) : null}\n    </div>\n  )\n})\n"],"names":["UserCard","forwardRef","name","email","avatar","icon","color","size","onLogout","logoutLabel","children","loading","className","style","props","ref","t","useT","avatarSize","buttonSize","jsxs","clsx","styles","jsx","Avatar","Typography","Skeleton","Button","Icon"],"mappings":"0bAgDaA,EAAWC,EAAAA,WAA0C,SAChE,CACE,KAAAC,EACA,MAAAC,EACA,OAAAC,EACA,KAAAC,EAAO,OACP,MAAAC,EAAQ,UACR,KAAAC,EAAO,KACP,SAAAC,EACA,YAAAC,EACA,SAAAC,EACA,QAAAC,EAAU,GACV,UAAAC,EACA,MAAAC,EACA,GAAGC,CACL,EACAC,EACA,CACA,MAAMC,EAAIC,EAAAA,KAAA,EAEJC,EAAaX,IAAS,KAAO,KAAOA,IAAS,KAAO,KAAO,KAC3DY,EAAaZ,IAAS,KAAO,KAAO,KAE1C,OACEa,EAAAA,KAAC,MAAA,CACC,IAAAL,EACA,UAAWM,EAAAA,KAAKC,EAAO,KAAMA,EAAOf,CAAI,EAAGK,CAAS,EACpD,MAAAC,EACA,YAAWF,GAAW,OACrB,GAAGG,EAEJ,SAAA,CAAAM,EAAAA,KAAC,MAAA,CAAI,UAAWE,EAAO,SAGrB,SAAA,CAAAC,EAAAA,IAACC,EAAAA,OAAA,CACC,KAAMN,EACN,KAAAhB,EACA,IAAKE,EACL,KAAMF,EAAO,OAAYG,EACzB,MAAAC,EACA,QAAAK,CAAA,CAAA,EAEFS,EAAAA,KAAC,MAAA,CAAI,UAAWE,EAAO,KAErB,SAAA,CAAAC,EAAAA,IAACE,EAAAA,WAAA,CAAW,QAAQ,YAAY,SAAQ,GACrC,SAAAd,EAAUY,EAAAA,IAACG,WAAA,CAAS,MAAM,KAAA,CAAM,EAAMxB,GAAQc,EAAE,kBAAkB,EACrE,GACEL,GAAWR,GAAS,OACpBoB,EAAAA,IAACE,EAAAA,WAAA,CAAW,QAAQ,UAAU,MAAM,QAAQ,SAAQ,GACjD,SAAAd,EAAUY,MAACG,EAAAA,UAAS,MAAM,MAAM,EAAKvB,CAAA,CACxC,CAAA,CAAA,CAEJ,CAAA,EACF,EAECO,EAEAF,EACCe,EAAAA,IAACI,EAAAA,OAAA,CACC,QAAQ,SACR,MAAM,QACN,KAAMR,EACN,UAAS,GACT,UAAWI,EAAAA,IAACK,EAAAA,KAAA,CAAK,KAAK,SAAA,CAAU,EAChC,QAASpB,EAER,SAAAC,GAAeO,EAAE,kBAAkB,CAAA,CAAA,EAEpC,IAAA,CAAA,CAAA,CAGV,CAAC"}

package/dist/{UserCard-DYK6S-nr.js → UserCard-cmZrMvwL.js}

@@ -2,11 +2,11 @@ import { jsxs as e, jsx as t } from "react/jsx-runtime";
 import { forwardRef as S } from "react";
 import { clsx as b } from "clsx";
 import { A as g } from "./Avatar-ClcmN0ba.js";
-import { B as w } from "./Button-CjsnB8gX.js";
+import { B as w } from "./Button-CtADzomU.js";
 import { b as U } from "./Icon-D5TxgfCc.js";
 import { S as m } from "./Skeleton-_-uGax2j.js";
 import { T as d } from "./Typography-ChSuxgkc.js";
-import { a as N } from "./ConfigProvider-Bgu85MsI.js";
+import { a as N } from "./ConfigProvider-Dqfu7UBU.js";
 const T = "_card_1fykc_3", j = "_identity_1fykc_16", A = "_text_1fykc_20", B = "_sm_1fykc_33", I = "_lg_1fykc_37", o = {
   card: T,
   identity: j,
@@ -75,4 +75,4 @@ const T = "_card_1fykc_3", j = "_identity_1fykc_16", A = "_text_1fykc_20", B = "
 export {
   J as U
 };
-//# sourceMappingURL=UserCard-DYK6S-nr.js.map
+//# sourceMappingURL=UserCard-cmZrMvwL.js.map

package/dist/UserCard-cmZrMvwL.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"UserCard-cmZrMvwL.js","sources":["../src/components/UserCard/UserCard.tsx"],"sourcesContent":["import { forwardRef, type CSSProperties, type HTMLAttributes, type ReactNode } from 'react'\nimport { clsx } from 'clsx'\nimport { useT, type ThemeColor } from '../../theme'\nimport type { IconName } from '../../icons/names'\nimport { Avatar } from '../Avatar'\nimport { Button } from '../Button'\nimport { Icon } from '../Icon'\nimport { Skeleton } from '../Skeleton'\nimport { Typography } from '../Typography'\nimport styles from './UserCard.module.css'\n\nexport type UserCardSize = 'sm' | 'md' | 'lg'\n\nexport interface UserCardProps extends Omit<HTMLAttributes<HTMLDivElement>, 'color'> {\n  /**\n   * Display name — the primary line, and the source of the avatar initials. When omitted, the primary\n   * line falls back to a localized **\"Welcome\"** greeting (and the avatar shows the `icon`).\n   */\n  name?: string\n  /** Secondary line under the name (usually the email). */\n  email?: ReactNode\n  /** Avatar image URL (falls back to the initials from `name`, else the `icon`). */\n  avatar?: string\n  /** Fallback avatar icon when there's no image or name. Defaults to `'User'`. */\n  icon?: IconName\n  /** Theme palette token tinting the avatar. Defaults to `'primary'`. */\n  color?: ThemeColor\n  /** Preset size (avatar + button + card padding; the text stays fixed). Defaults to `'md'`. */\n  size?: UserCardSize\n  /** When provided, a **Sign out** button is shown that calls this. */\n  onLogout?: () => void\n  /** Sign-out button label. Defaults to `'Sign Out'`. */\n  logoutLabel?: ReactNode\n  /** Extra content between the identity row and the sign-out button (e.g. a link or menu). */\n  children?: ReactNode\n  /** Show skeletons for the avatar, name and email while the user is being fetched (sign-out stays usable). Defaults to `false`. */\n  loading?: boolean\n}\n\n/**\n * A compact account card — an `Avatar` + name/email and an optional **Sign out** button — for a consistent\n * signed-in-user block across apps, instead of hand-rolling the markup each time. The shell's sidebar renders\n * one itself (`config.sidebar.userCard` / the `RootLayout` `showUserCard` prop), so place it by hand only\n * elsewhere. Shows the image (`avatar`) → initials (from `name`) →\n * `icon` (default `User`) in priority order; renders the sign-out `Button` (filled `error`) only when\n * `onLogout` is given. `size` (`sm`/`md`/`lg`) scales the avatar, button and padding; `color` (default `primary`)\n * tints the avatar. `loading` swaps the avatar + name + email for skeletons. Own CSS module (token-only).\n */\nexport const UserCard = forwardRef<HTMLDivElement, UserCardProps>(function UserCard(\n  {\n    name,\n    email,\n    avatar,\n    icon = 'User',\n    color = 'primary',\n    size = 'md',\n    onLogout,\n    logoutLabel,\n    children,\n    loading = false,\n    className,\n    style,\n    ...props\n  },\n  ref,\n) {\n  const t = useT()\n  // the identity row + the sign-out button share the same visual size step\n  const avatarSize = size === 'lg' ? 'lg' : size === 'sm' ? 'sm' : 'md'\n  const buttonSize = size === 'lg' ? 'md' : 'sm'\n\n  return (\n    <div\n      ref={ref}\n      className={clsx(styles.card, styles[size], className)}\n      style={style as CSSProperties}\n      aria-busy={loading || undefined}\n      {...props}\n    >\n      <div className={styles.identity}>\n        {/* Avatar priority is image → icon → initials, so pass `icon` only as the last resort (no\n            name), otherwise a name would still show the icon instead of its initials */}\n        <Avatar\n          size={avatarSize}\n          name={name}\n          src={avatar}\n          icon={name ? undefined : icon}\n          color={color}\n          loading={loading}\n        />\n        <div className={styles.text}>\n          {/* primary line: the name, or a \"Welcome\" greeting fallback when no name is given */}\n          <Typography variant=\"bodySmall\" truncate>\n            {loading ? <Skeleton width=\"60%\" /> : (name ?? t('userCard.welcome'))}\n          </Typography>\n          {(loading || email != null) && (\n            <Typography variant=\"caption\" color=\"muted\" truncate>\n              {loading ? <Skeleton width=\"85%\" /> : email}\n            </Typography>\n          )}\n        </div>\n      </div>\n\n      {children}\n\n      {onLogout ? (\n        <Button\n          variant=\"filled\"\n          color=\"error\"\n          size={buttonSize}\n          fullWidth\n          startIcon={<Icon name=\"Logout2\" />}\n          onClick={onLogout}\n        >\n          {logoutLabel ?? t('userCard.signOut')}\n        </Button>\n      ) : null}\n    </div>\n  )\n})\n"],"names":["UserCard","forwardRef","name","email","avatar","icon","color","size","onLogout","logoutLabel","children","loading","className","style","props","ref","t","useT","avatarSize","buttonSize","jsxs","clsx","styles","jsx","Avatar","Typography","Skeleton","Button","Icon"],"mappings":";;;;;;;;;;;;;;;GAgDaA,IAAWC,EAA0C,SAChE;AAAA,EACE,MAAAC;AAAA,EACA,OAAAC;AAAA,EACA,QAAAC;AAAA,EACA,MAAAC,IAAO;AAAA,EACP,OAAAC,IAAQ;AAAA,EACR,MAAAC,IAAO;AAAA,EACP,UAAAC;AAAA,EACA,aAAAC;AAAA,EACA,UAAAC;AAAA,EACA,SAAAC,IAAU;AAAA,EACV,WAAAC;AAAA,EACA,OAAAC;AAAA,EACA,GAAGC;AACL,GACAC,GACA;AACA,QAAMC,IAAIC,EAAA,GAEJC,IAAaX,MAAS,OAAO,OAAOA,MAAS,OAAO,OAAO,MAC3DY,IAAaZ,MAAS,OAAO,OAAO;AAE1C,SACE,gBAAAa;AAAA,IAAC;AAAA,IAAA;AAAA,MACC,KAAAL;AAAA,MACA,WAAWM,EAAKC,EAAO,MAAMA,EAAOf,CAAI,GAAGK,CAAS;AAAA,MACpD,OAAAC;AAAA,MACA,aAAWF,KAAW;AAAA,MACrB,GAAGG;AAAA,MAEJ,UAAA;AAAA,QAAA,gBAAAM,EAAC,OAAA,EAAI,WAAWE,EAAO,UAGrB,UAAA;AAAA,UAAA,gBAAAC;AAAA,YAACC;AAAA,YAAA;AAAA,cACC,MAAMN;AAAA,cACN,MAAAhB;AAAA,cACA,KAAKE;AAAA,cACL,MAAMF,IAAO,SAAYG;AAAA,cACzB,OAAAC;AAAA,cACA,SAAAK;AAAA,YAAA;AAAA,UAAA;AAAA,UAEF,gBAAAS,EAAC,OAAA,EAAI,WAAWE,EAAO,MAErB,UAAA;AAAA,YAAA,gBAAAC,EAACE,GAAA,EAAW,SAAQ,aAAY,UAAQ,IACrC,UAAAd,IAAU,gBAAAY,EAACG,GAAA,EAAS,OAAM,MAAA,CAAM,IAAMxB,KAAQc,EAAE,kBAAkB,GACrE;AAAA,aACEL,KAAWR,KAAS,SACpB,gBAAAoB,EAACE,GAAA,EAAW,SAAQ,WAAU,OAAM,SAAQ,UAAQ,IACjD,UAAAd,IAAU,gBAAAY,EAACG,KAAS,OAAM,OAAM,IAAKvB,EAAA,CACxC;AAAA,UAAA,EAAA,CAEJ;AAAA,QAAA,GACF;AAAA,QAECO;AAAA,QAEAF,IACC,gBAAAe;AAAA,UAACI;AAAA,UAAA;AAAA,YACC,SAAQ;AAAA,YACR,OAAM;AAAA,YACN,MAAMR;AAAA,YACN,WAAS;AAAA,YACT,WAAW,gBAAAI,EAACK,GAAA,EAAK,MAAK,UAAA,CAAU;AAAA,YAChC,SAASpB;AAAA,YAER,UAAAC,KAAeO,EAAE,kBAAkB;AAAA,UAAA;AAAA,QAAA,IAEpC;AAAA,MAAA;AAAA,IAAA;AAAA,EAAA;AAGV,CAAC;"}

package/dist/app/AdminRoot.d.cts

@@ -1,5 +1,5 @@
 import type { ReactNode } from 'react';
-import { type ErrorBoundaryProps, type IconName, type RootLayoutHeader, type RootLayoutProps } from '../components';
+import { type ErrorBoundaryProps, type ToasterProps, type IconName, type RootLayoutHeader, type RootLayoutProps } from '../components';
 import { type ThemeColor } from '../theme';
 /** Why the session can't be used — see `AdminRootUnavailable.reason`. */
 export type AdminRootUnavailableReason = 'forbidden' | 'unreachable';
@@ -56,7 +56,10 @@ export interface AdminRootProps<U extends AdminUser = AdminUser> {
     authRouteId?: string;
     /** Guard target for signed-out visitors + post-logout redirect. Default `'/login'`. */
     loginPath?: string;
-    /** Show a `UserCard` in the sidebar footer. Default `true`. */
+    /**
+     * Show a `UserCard` (the user + Sign Out) at the bottom of the sidebar — passed to `RootLayout`. Unset, the
+     * app-wide `config.sidebar.userCard` applies (default `false`, hidden).
+     */
     showUserCard?: boolean;
     /**
      * The sidebar's look, passed to `RootLayout` — `'floating'` or `'docked'` (flush to the edges). **Unset
@@ -78,6 +81,13 @@ export interface AdminRootProps<U extends AdminUser = AdminUser> {
      * per-route boundary, so page crashes need `createRouter({ defaultErrorComponent: PageError })`.
      */
     errorBoundary?: boolean | Omit<ErrorBoundaryProps, 'children' | 'resetKeys'>;
+    /**
+     * The one app-wide toast viewport AdminRoot mounts (the inner `RootLayout`'s is always off, so there's never a
+     * second one). Unset / `true` → `<Toaster />`, following the app-wide `config.toast`; `ToasterProps`
+     * (`{ position, duration }`) → this shell's override, anything unset still falls back to `config.toast`;
+     * `false` → no viewport (e.g. the app mounts its own `<Toaster>`). Same shape as `RootLayout`'s `toaster`.
+     */
+    toaster?: boolean | ToasterProps;
     /**
      * The app is still finding out who is signed in (e.g. verifying a stored token or refreshing a cookie
      * session). While `true`, AdminRoot renders only `pendingFallback` — no shell, no public page, no
@@ -102,9 +112,10 @@ export interface AdminRootProps<U extends AdminUser = AdminUser> {
 /**
  * Root-route component for admin apps — it wires up the whole shell orchestration so an app only has to
  * supply `logo` + `getUser` + `onLogout`. Public pages (route id under `authRouteId`) render standalone;
- * everything else renders inside the guarded admin shell (`RootLayout` + a sidebar `UserCard`), gated by
+ * everything else renders inside the guarded admin shell (`RootLayout`, with an optional sidebar `UserCard`), gated by
  * `AuthGuard` (signed-out visitors bounce to `loginPath`). Logout clears the session and navigates to
- * `loginPath`. Mounts exactly one app-wide `<Toaster/>` (the inner `RootLayout` gets `toaster={false}`),
+ * `loginPath`. Mounts exactly one app-wide `<Toaster/>` (`toaster`; none with `toaster={false}` — the inner
+ * `RootLayout` always gets `toaster={false}`),
  * and wraps the page in an `ErrorBoundary` that resets on navigation (`errorBoundary`, default on).
  * While the app is still checking the session, pass `pending` (a full-screen loader instead of a premature
  * sign-in redirect); when the check failed or the server refuses this account, pass `unavailable` (a
@@ -131,4 +142,4 @@ export interface AdminRootProps<U extends AdminUser = AdminUser> {
  *   },
  * })
  */
-export declare const AdminRoot: <U extends AdminUser = AdminUser>({ logo, logoTo, getUser, onLogout, authRouteId, loginPath, showUserCard, sidebarVariant, header, errorBoundary, pending, pendingFallback, unavailable, unavailableFallback, }: AdminRootProps<U>) => import("react/jsx-runtime").JSX.Element;
+export declare const AdminRoot: <U extends AdminUser = AdminUser>({ logo, logoTo, getUser, onLogout, authRouteId, loginPath, showUserCard, sidebarVariant, header, errorBoundary, toaster, pending, pendingFallback, unavailable, unavailableFallback, }: AdminRootProps<U>) => import("react/jsx-runtime").JSX.Element;

package/dist/app/AdminRoot.d.ts

@@ -1,5 +1,5 @@
 import type { ReactNode } from 'react';
-import { type ErrorBoundaryProps, type IconName, type RootLayoutHeader, type RootLayoutProps } from '../components';
+import { type ErrorBoundaryProps, type ToasterProps, type IconName, type RootLayoutHeader, type RootLayoutProps } from '../components';
 import { type ThemeColor } from '../theme';
 /** Why the session can't be used — see `AdminRootUnavailable.reason`. */
 export type AdminRootUnavailableReason = 'forbidden' | 'unreachable';
@@ -56,7 +56,10 @@ export interface AdminRootProps<U extends AdminUser = AdminUser> {
     authRouteId?: string;
     /** Guard target for signed-out visitors + post-logout redirect. Default `'/login'`. */
     loginPath?: string;
-    /** Show a `UserCard` in the sidebar footer. Default `true`. */
+    /**
+     * Show a `UserCard` (the user + Sign Out) at the bottom of the sidebar — passed to `RootLayout`. Unset, the
+     * app-wide `config.sidebar.userCard` applies (default `false`, hidden).
+     */
     showUserCard?: boolean;
     /**
      * The sidebar's look, passed to `RootLayout` — `'floating'` or `'docked'` (flush to the edges). **Unset
@@ -78,6 +81,13 @@ export interface AdminRootProps<U extends AdminUser = AdminUser> {
      * per-route boundary, so page crashes need `createRouter({ defaultErrorComponent: PageError })`.
      */
     errorBoundary?: boolean | Omit<ErrorBoundaryProps, 'children' | 'resetKeys'>;
+    /**
+     * The one app-wide toast viewport AdminRoot mounts (the inner `RootLayout`'s is always off, so there's never a
+     * second one). Unset / `true` → `<Toaster />`, following the app-wide `config.toast`; `ToasterProps`
+     * (`{ position, duration }`) → this shell's override, anything unset still falls back to `config.toast`;
+     * `false` → no viewport (e.g. the app mounts its own `<Toaster>`). Same shape as `RootLayout`'s `toaster`.
+     */
+    toaster?: boolean | ToasterProps;
     /**
      * The app is still finding out who is signed in (e.g. verifying a stored token or refreshing a cookie
      * session). While `true`, AdminRoot renders only `pendingFallback` — no shell, no public page, no
@@ -102,9 +112,10 @@ export interface AdminRootProps<U extends AdminUser = AdminUser> {
 /**
  * Root-route component for admin apps — it wires up the whole shell orchestration so an app only has to
  * supply `logo` + `getUser` + `onLogout`. Public pages (route id under `authRouteId`) render standalone;
- * everything else renders inside the guarded admin shell (`RootLayout` + a sidebar `UserCard`), gated by
+ * everything else renders inside the guarded admin shell (`RootLayout`, with an optional sidebar `UserCard`), gated by
  * `AuthGuard` (signed-out visitors bounce to `loginPath`). Logout clears the session and navigates to
- * `loginPath`. Mounts exactly one app-wide `<Toaster/>` (the inner `RootLayout` gets `toaster={false}`),
+ * `loginPath`. Mounts exactly one app-wide `<Toaster/>` (`toaster`; none with `toaster={false}` — the inner
+ * `RootLayout` always gets `toaster={false}`),
  * and wraps the page in an `ErrorBoundary` that resets on navigation (`errorBoundary`, default on).
  * While the app is still checking the session, pass `pending` (a full-screen loader instead of a premature
  * sign-in redirect); when the check failed or the server refuses this account, pass `unavailable` (a
@@ -131,4 +142,4 @@ export interface AdminRootProps<U extends AdminUser = AdminUser> {
  *   },
  * })
  */
-export declare const AdminRoot: <U extends AdminUser = AdminUser>({ logo, logoTo, getUser, onLogout, authRouteId, loginPath, showUserCard, sidebarVariant, header, errorBoundary, pending, pendingFallback, unavailable, unavailableFallback, }: AdminRootProps<U>) => import("react/jsx-runtime").JSX.Element;
+export declare const AdminRoot: <U extends AdminUser = AdminUser>({ logo, logoTo, getUser, onLogout, authRouteId, loginPath, showUserCard, sidebarVariant, header, errorBoundary, toaster, pending, pendingFallback, unavailable, unavailableFallback, }: AdminRootProps<U>) => import("react/jsx-runtime").JSX.Element;

package/dist/components/Alert/Alert.d.cts

@@ -16,7 +16,7 @@ export interface AlertProps extends Omit<HTMLAttributes<HTMLDivElement>, 'color'
     action?: ReactNode;
     /** When provided, a trailing × close button appears that calls this. */
     onClose?: () => void;
-    /** Accessible label for the close button. Defaults to `"Close"`. */
+    /** Accessible label for the close button. Defaults to the localized "Close" (`common.close`). */
     closeLabel?: string;
     /** Alert message. */
     children?: ReactNode;

package/dist/components/Alert/Alert.d.ts

@@ -16,7 +16,7 @@ export interface AlertProps extends Omit<HTMLAttributes<HTMLDivElement>, 'color'
     action?: ReactNode;
     /** When provided, a trailing × close button appears that calls this. */
     onClose?: () => void;
-    /** Accessible label for the close button. Defaults to `"Close"`. */
+    /** Accessible label for the close button. Defaults to the localized "Close" (`common.close`). */
     closeLabel?: string;
     /** Alert message. */
     children?: ReactNode;

package/dist/components/Alert/index.cjs

@@ -1,2 +1,2 @@
-"use strict";Object.defineProperties(exports,{__esModule:{value:!0},[Symbol.toStringTag]:{value:"Module"}});const e=require("../../Alert-5tpyGb2M.cjs");exports.Alert=e.Alert;exports.default=e.Alert;
+"use strict";Object.defineProperties(exports,{__esModule:{value:!0},[Symbol.toStringTag]:{value:"Module"}});const e=require("../../Alert-B4XZDk16.cjs");exports.Alert=e.Alert;exports.default=e.Alert;
 //# sourceMappingURL=index.cjs.map

package/dist/components/Alert/index.js

@@ -1,4 +1,4 @@
-import { A as r, A as t } from "../../Alert-Dz0sNGpz.js";
+import { A as r, A as t } from "../../Alert-D5E1PLkV.js";
 export {
   r as Alert,
   t as default

package/dist/components/AuthLayout/AuthLayout.d.cts

@@ -12,7 +12,7 @@ export interface AuthLayoutProps extends Omit<HTMLAttributes<HTMLDivElement>, 't
      * kept), so you can pass an unsized logo and it's sized/centered for you.
      */
     logo?: ReactNode;
-    /** Optional glyph in a soft tinted circle above the title — an `IconName` or any node. */
+    /** Optional glyph in a solid `color`-filled circle above the title — an `IconName` or any node. */
     icon?: IconName | ReactNode;
     /** Bottom slot under the form — e.g. a "Back to login" / "Sign up" link row. */
     footer?: ReactNode;
@@ -28,7 +28,7 @@ export interface AuthLayoutProps extends Omit<HTMLAttributes<HTMLDivElement>, 't
  * reset-password, OTP, …) — so each page just supplies its `title` + form instead of hand-building the
  * layout. Fills the viewport (`100dvh`) with the app `background` canvas and vertically centers a
  * `logo` (on the canvas, above the card) + an elevated `surface` card, as a group. The card stacks: an
- * optional `icon` (in a soft tinted `Avatar` circle), the `title` + `subtitle` (centered), the
+ * optional `icon` (in a solid `color`-filled `Avatar` circle), the `title` + `subtitle` (centered), the
  * `children` (your form), and an optional `footer` (link row). Token-only styling; responsive.
  *
  * @example

package/dist/components/AuthLayout/AuthLayout.d.ts

@@ -12,7 +12,7 @@ export interface AuthLayoutProps extends Omit<HTMLAttributes<HTMLDivElement>, 't
      * kept), so you can pass an unsized logo and it's sized/centered for you.
      */
     logo?: ReactNode;
-    /** Optional glyph in a soft tinted circle above the title — an `IconName` or any node. */
+    /** Optional glyph in a solid `color`-filled circle above the title — an `IconName` or any node. */
     icon?: IconName | ReactNode;
     /** Bottom slot under the form — e.g. a "Back to login" / "Sign up" link row. */
     footer?: ReactNode;
@@ -28,7 +28,7 @@ export interface AuthLayoutProps extends Omit<HTMLAttributes<HTMLDivElement>, 't
  * reset-password, OTP, …) — so each page just supplies its `title` + form instead of hand-building the
  * layout. Fills the viewport (`100dvh`) with the app `background` canvas and vertically centers a
  * `logo` (on the canvas, above the card) + an elevated `surface` card, as a group. The card stacks: an
- * optional `icon` (in a soft tinted `Avatar` circle), the `title` + `subtitle` (centered), the
+ * optional `icon` (in a solid `color`-filled `Avatar` circle), the `title` + `subtitle` (centered), the
  * `children` (your form), and an optional `footer` (link row). Token-only styling; responsive.
  *
  * @example

package/dist/components/Breadcrumbs/Breadcrumbs.d.cts

@@ -12,6 +12,7 @@ export interface BreadcrumbsProps {
  * content. It always starts with a home icon that links to the first allowed menu page (the same
  * target as `FirstRouteRedirect`), followed by one crumb per matched route that declares a
  * `staticData.name`. Intermediate crumbs link to their page when navigable; the current page is
- * plain text. Renders nothing when the current route has no named matches. Token-only styling.
+ * plain text. Renders nothing when no path prefix has a name and the leaf route has no
+ * `staticData.breadcrumb`. Token-only styling.
  */
 export declare function Breadcrumbs({ separator }?: BreadcrumbsProps): import("react/jsx-runtime").JSX.Element | null;

package/dist/components/Breadcrumbs/Breadcrumbs.d.ts

@@ -12,6 +12,7 @@ export interface BreadcrumbsProps {
  * content. It always starts with a home icon that links to the first allowed menu page (the same
  * target as `FirstRouteRedirect`), followed by one crumb per matched route that declares a
  * `staticData.name`. Intermediate crumbs link to their page when navigable; the current page is
- * plain text. Renders nothing when the current route has no named matches. Token-only styling.
+ * plain text. Renders nothing when no path prefix has a name and the leaf route has no
+ * `staticData.breadcrumb`. Token-only styling.
  */
 export declare function Breadcrumbs({ separator }?: BreadcrumbsProps): import("react/jsx-runtime").JSX.Element | null;

package/dist/components/Breadcrumbs/index.cjs

@@ -1,2 +1,2 @@
-"use strict";Object.defineProperties(exports,{__esModule:{value:!0},[Symbol.toStringTag]:{value:"Module"}});const e=require("../../Breadcrumbs-B6Pii2Y_.cjs");exports.Breadcrumbs=e.Breadcrumbs;exports.default=e.Breadcrumbs;
+"use strict";Object.defineProperties(exports,{__esModule:{value:!0},[Symbol.toStringTag]:{value:"Module"}});const e=require("../../Breadcrumbs-DSUxcp6u.cjs");exports.Breadcrumbs=e.Breadcrumbs;exports.default=e.Breadcrumbs;
 //# sourceMappingURL=index.cjs.map

package/dist/components/Breadcrumbs/index.js

@@ -1,4 +1,4 @@
-import { B as e, B as s } from "../../Breadcrumbs-DKYJOdHZ.js";
+import { B as e, B as s } from "../../Breadcrumbs-M31xyok8.js";
 export {
   e as Breadcrumbs,
   s as default

package/dist/components/Button/index.cjs

@@ -1,2 +1,2 @@
-"use strict";Object.defineProperties(exports,{__esModule:{value:!0},[Symbol.toStringTag]:{value:"Module"}});const t=require("../../Button-ClVfHGBc.cjs");exports.Button=t.Button;exports.default=t.Button;
+"use strict";Object.defineProperties(exports,{__esModule:{value:!0},[Symbol.toStringTag]:{value:"Module"}});const t=require("../../Button-Q_5uA-zc.cjs");exports.Button=t.Button;exports.default=t.Button;
 //# sourceMappingURL=index.cjs.map

package/dist/components/Button/index.js

@@ -1,4 +1,4 @@
-import { B as o, B } from "../../Button-CjsnB8gX.js";
+import { B as o, B } from "../../Button-CtADzomU.js";
 export {
   o as Button,
   B as default

package/dist/components/Card/Card.d.cts

@@ -1,5 +1,5 @@
 import { type HTMLAttributes, type ReactNode } from 'react';
-import type { ThemeColor } from '../../theme';
+import { type ThemeColor } from '../../theme';
 import { type IconName } from '../../icons/names';
 export interface CardProps extends Omit<HTMLAttributes<HTMLDivElement>, 'title' | 'color'> {
     /** Header title (left, next to the icon). */

package/dist/components/Card/Card.d.ts

@@ -1,5 +1,5 @@
 import { type HTMLAttributes, type ReactNode } from 'react';
-import type { ThemeColor } from '../../theme';
+import { type ThemeColor } from '../../theme';
 import { type IconName } from '../../icons/names';
 export interface CardProps extends Omit<HTMLAttributes<HTMLDivElement>, 'title' | 'color'> {
     /** Header title (left, next to the icon). */

package/dist/components/Card/index.cjs

@@ -1,2 +1,2 @@
-"use strict";Object.defineProperties(exports,{__esModule:{value:!0},[Symbol.toStringTag]:{value:"Module"}});const e=require("../../Card-CIRGqg3P.cjs");exports.Card=e.Card;exports.default=e.Card;
+"use strict";Object.defineProperties(exports,{__esModule:{value:!0},[Symbol.toStringTag]:{value:"Module"}});const e=require("../../Card-CntRsQfm.cjs");exports.Card=e.Card;exports.default=e.Card;
 //# sourceMappingURL=index.cjs.map

package/dist/components/Card/index.js

@@ -1,4 +1,4 @@
-import { C, C as d } from "../../Card-Co3A4Qgo.js";
+import { C, C as d } from "../../Card-Br9IB0yM.js";
 export {
   C as Card,
   d as default

package/dist/components/Chip/Chip.d.cts

@@ -21,7 +21,7 @@ export interface ChipProps extends Omit<HTMLAttributes<HTMLDivElement>, 'color'>
     onDelete?: () => void;
     /** Custom delete icon. Defaults to a `CloseCircle`. */
     deleteIcon?: ReactNode;
-    /** Accessible label for the delete button. Defaults to `"Remove"`. */
+    /** Accessible label for the delete button. Defaults to the localized "Remove" (`common.remove`). */
     deleteLabel?: string;
     /** Tab index for the delete button — pass `-1` when the chip lives inside a composite widget (e.g. a multi-select) that owns keyboard focus. */
     deleteTabIndex?: number;

package/dist/components/Chip/Chip.d.ts

@@ -21,7 +21,7 @@ export interface ChipProps extends Omit<HTMLAttributes<HTMLDivElement>, 'color'>
     onDelete?: () => void;
     /** Custom delete icon. Defaults to a `CloseCircle`. */
     deleteIcon?: ReactNode;
-    /** Accessible label for the delete button. Defaults to `"Remove"`. */
+    /** Accessible label for the delete button. Defaults to the localized "Remove" (`common.remove`). */
     deleteLabel?: string;
     /** Tab index for the delete button — pass `-1` when the chip lives inside a composite widget (e.g. a multi-select) that owns keyboard focus. */
     deleteTabIndex?: number;

package/dist/components/Chip/index.cjs

@@ -1,2 +1,2 @@
-"use strict";Object.defineProperties(exports,{__esModule:{value:!0},[Symbol.toStringTag]:{value:"Module"}});const e=require("../../Chip-Dp8skUZ2.cjs");exports.Chip=e.Chip;exports.default=e.Chip;
+"use strict";Object.defineProperties(exports,{__esModule:{value:!0},[Symbol.toStringTag]:{value:"Module"}});const e=require("../../Chip-CrBizrvG.cjs");exports.Chip=e.Chip;exports.default=e.Chip;
 //# sourceMappingURL=index.cjs.map

package/dist/components/Chip/index.js

@@ -1,4 +1,4 @@
-import { C as e, C as f } from "../../Chip-BjSNgaAf.js";
+import { C as e, C as f } from "../../Chip-DYZ5w7VM.js";
 export {
   e as Chip,
   f as default

package/dist/components/ChoiceCard/ChoiceCard.d.cts

@@ -32,7 +32,7 @@ export interface ChoiceCardProps extends Omit<InputHTMLAttributes<HTMLInputEleme
 /**
  * A selectable card — a rich checkbox/radio with an icon, title and description. The native input is
  * visually hidden but fully accessible (Space toggles; in an `exclusive` group the cards are real
- * radios, so Arrow keys rove between them); the card shows the state with a accent border + soft halo,
+ * radios, so Arrow keys rove between them); the card shows the state with a `color` border + soft halo,
  * a top-right tick indicator, and an icon circle that fills with the color while selected. Designed to
  * live inside a `<ChoiceCardGroup>` (which supplies the selection, `exclusive` mode and
  * `size`/`color`/`disabled`/`error` via context), but also works standalone as a single fancy checkbox

package/dist/components/ChoiceCard/ChoiceCard.d.ts

@@ -32,7 +32,7 @@ export interface ChoiceCardProps extends Omit<InputHTMLAttributes<HTMLInputEleme
 /**
  * A selectable card — a rich checkbox/radio with an icon, title and description. The native input is
  * visually hidden but fully accessible (Space toggles; in an `exclusive` group the cards are real
- * radios, so Arrow keys rove between them); the card shows the state with a accent border + soft halo,
+ * radios, so Arrow keys rove between them); the card shows the state with a `color` border + soft halo,
  * a top-right tick indicator, and an icon circle that fills with the color while selected. Designed to
  * live inside a `<ChoiceCardGroup>` (which supplies the selection, `exclusive` mode and
  * `size`/`color`/`disabled`/`error` via context), but also works standalone as a single fancy checkbox

package/dist/components/ChoiceCard/index.cjs

@@ -1,2 +1,2 @@
-"use strict";Object.defineProperties(exports,{__esModule:{value:!0},[Symbol.toStringTag]:{value:"Module"}});const e=require("../../ChoiceCardGroup-143hR0v_.cjs");exports.ChoiceCard=e.ChoiceCard;exports.ChoiceCardGroup=e.ChoiceCardGroup;exports.default=e.ChoiceCard;
+"use strict";Object.defineProperties(exports,{__esModule:{value:!0},[Symbol.toStringTag]:{value:"Module"}});const e=require("../../ChoiceCardGroup-C7Eengyd.cjs");exports.ChoiceCard=e.ChoiceCard;exports.ChoiceCardGroup=e.ChoiceCardGroup;exports.default=e.ChoiceCard;
 //# sourceMappingURL=index.cjs.map

package/dist/components/ChoiceCard/index.js

@@ -1,4 +1,4 @@
-import { C as o, a as r, C as e } from "../../ChoiceCardGroup-Cx8CtmPl.js";
+import { C as o, a as r, C as e } from "../../ChoiceCardGroup-q0yN-TeQ.js";
 export {
   o as ChoiceCard,
   r as ChoiceCardGroup,

package/dist/components/CodeBlock/CodeBlock.d.cts

@@ -29,6 +29,6 @@ export interface CodeBlockProps extends Omit<HTMLAttributes<HTMLDivElement>, 'ch
  * tick on click — with an optional `title` (e.g. a filename) on its left; `showLineNumbers` (default
  * `true`), `maxHeight` (scrolls inside) and `wrap` shape the body. The whole block
  * keeps VS Code's own dark colors (a deliberate literal-color exception, like the Modal scrim); only
- * the outer border/radius uses `--tz-*` tokens.
+ * the outer radius uses a `--tz-*` token (the border is a literal white-alpha hairline).
  */
 export declare const CodeBlock: import("react").ForwardRefExoticComponent<CodeBlockProps & import("react").RefAttributes<HTMLDivElement>>;

package/dist/components/CodeBlock/CodeBlock.d.ts

@@ -29,6 +29,6 @@ export interface CodeBlockProps extends Omit<HTMLAttributes<HTMLDivElement>, 'ch
  * tick on click — with an optional `title` (e.g. a filename) on its left; `showLineNumbers` (default
  * `true`), `maxHeight` (scrolls inside) and `wrap` shape the body. The whole block
  * keeps VS Code's own dark colors (a deliberate literal-color exception, like the Modal scrim); only
- * the outer border/radius uses `--tz-*` tokens.
+ * the outer radius uses a `--tz-*` token (the border is a literal white-alpha hairline).
  */
 export declare const CodeBlock: import("react").ForwardRefExoticComponent<CodeBlockProps & import("react").RefAttributes<HTMLDivElement>>;

package/dist/components/CodeBlock/index.cjs

@@ -1,2 +1,2 @@
-"use strict";Object.defineProperties(exports,{__esModule:{value:!0},[Symbol.toStringTag]:{value:"Module"}});const e=require("../../CodeBlock-o_VSkAek.cjs");exports.CodeBlock=e.CodeBlock;exports.default=e.CodeBlock;
+"use strict";Object.defineProperties(exports,{__esModule:{value:!0},[Symbol.toStringTag]:{value:"Module"}});const e=require("../../CodeBlock-DW4uaZXM.cjs");exports.CodeBlock=e.CodeBlock;exports.default=e.CodeBlock;
 //# sourceMappingURL=index.cjs.map

package/dist/components/CodeBlock/index.js

@@ -1,4 +1,4 @@
-import { C as e, C } from "../../CodeBlock-CcJjS0_q.js";
+import { C as e, C } from "../../CodeBlock-B6Eqc4HR.js";
 export {
   e as CodeBlock,
   C as default

package/dist/components/ColorPicker/index.cjs

@@ -1,2 +1,2 @@
-"use strict";Object.defineProperties(exports,{__esModule:{value:!0},[Symbol.toStringTag]:{value:"Module"}});const e=require("../../ColorPicker-DY6Vk1uS.cjs");exports.ColorPicker=e.ColorPicker;exports.default=e.ColorPicker;
+"use strict";Object.defineProperties(exports,{__esModule:{value:!0},[Symbol.toStringTag]:{value:"Module"}});const e=require("../../ColorPicker-nhWd_nOW.cjs");exports.ColorPicker=e.ColorPicker;exports.default=e.ColorPicker;
 //# sourceMappingURL=index.cjs.map