@techzyapp/ui-library 1.0.27 → 1.0.29

package/dist/{TranslatedFields-D_a0NVKI.cjs.map → TranslatedFields-CbTlgKnh.cjs.map}

@@ -1 +1 @@
-{"version":3,"file":"TranslatedFields-D_a0NVKI.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, 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 `'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': ariaLabel = 'Translations',\n      className,\n      style,\n    },\n    ref,\n  ) {\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","ariaLabel","className","style","ref","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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"}
+{"version":3,"file":"TranslatedFields-CbTlgKnh.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, 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 `'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': ariaLabel = 'Translations',\n      className,\n      style,\n    },\n    ref,\n  ) {\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","ariaLabel","className","style","ref","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":"yUAsEaA,EAAmBC,EAAAA,WAC9B,SACE,CACE,SAAAC,EACA,QAASC,EACT,UAAWC,EACX,MAAAC,EACA,aAAAC,EACA,SAAAC,EACA,UAAAC,EAAY,GACZ,KAAAC,EAAO,SACP,QAAAC,EACA,KAAAC,EACA,aAAcC,EAAY,eAC1B,UAAAC,EACA,MAAAC,CAAA,EAEFC,EACA,OACA,MAAMC,EAAgBC,EAAAA,WAAA,EAChBC,EAAUf,GAAea,EAEzBG,EAAkBC,EAAAA,yBAAA,EAClBC,EAAYjB,GAAiBe,EAC7BG,EAAOC,EAAAA,eAAA,EAGPC,EAAenB,IAAU,OACzB,CAACoB,EAAUC,CAAW,EAAIC,EAAAA,SAA6BrB,CAAY,EACnEsB,GAAUJ,EAAenB,EAAQoB,MAAaI,EAAAX,EAAQ,CAAC,IAAT,YAAAW,EAAY,OAAQ,GAClEC,EAAaC,GAAiB,CAC7BP,GAAcE,EAAYK,CAAI,EACnCxB,GAAA,MAAAA,EAAWwB,EACb,EAGMC,EAAYC,GAAiBC,EAAAA,qBAAqBD,EAAM,GAAIZ,CAAS,EAErEc,EAAkBF,GACtB,CAAC,CAACX,GACF,OAAO,KAAKA,EAAK,MAAM,EAAE,KACtBc,GAAQA,EAAI,WAAWJ,EAASC,CAAI,CAAC,IAAMX,EAAK,aAAeA,EAAK,QAAQc,CAAG,IAAM,GAAA,EAIpFC,EAAUC,EAAAA,OAA8B,IAAI,EAC5CC,EAAcC,GAAgC,CAClDH,EAAQ,QAAUG,EACd,OAAOzB,GAAQ,WAAYA,EAAIyB,CAAI,EAC9BzB,IAAMA,EAA2C,QAAUyB,EACtE,EAIMC,EAAaH,EAAAA,OAAO,CAAC,EACrBI,EAAeJ,EAAAA,OAAsB,IAAI,EAmC/C,GAlCAK,EAAAA,UAAU,IAAM,CACd,MAAMC,GAAQtB,GAAA,YAAAA,EAAM,cAAe,EACnC,GAAI,CAACA,GAAQsB,IAAUH,EAAW,QAAS,OAC3CA,EAAW,QAAUG,EACrB,MAAMC,EAAY,OAAO,KAAKvB,EAAK,MAAM,EACzC,GAAIuB,EAAU,SAAW,EAAG,OAC5B,MAAMC,EAAoBC,GAAc7B,EAAQ,KAAM8B,GAAMD,EAAE,WAAWf,EAASgB,EAAE,IAAI,CAAC,CAAC,EAI1F,GAFI,CAACH,EAAU,MAAMC,CAAgB,GAEjCD,EAAU,KAAME,GAAMA,EAAE,WAAWf,EAASJ,CAAM,CAAC,CAAC,EAAG,OAC3D,MAAMqB,EAAW/B,EAAQ,KAAM8B,GAAMH,EAAU,KAAME,GAAMA,EAAE,WAAWf,EAASgB,EAAE,IAAI,CAAC,CAAC,CAAC,EACtFC,GAAYA,EAAS,OAASrB,IAChCc,EAAa,QAAUO,EAAS,KAChCnB,EAAUmB,EAAS,IAAI,EAG3B,EAAG,CAAC3B,GAAA,YAAAA,EAAM,WAAW,CAAC,EAGtBqB,EAAAA,UAAU,IAAM,OACd,GAAID,EAAa,SAAW,MAAQA,EAAa,UAAYd,EAAQ,OACrEc,EAAa,QAAU,KACvB,MAAMQ,EAAOb,EAAQ,QACrB,GAAI,CAACa,GAAQ,CAAC5B,EAAM,OACpB,MAAMuB,EAAY,IAAI,IAAI,OAAO,KAAKvB,EAAK,MAAM,CAAC,EAC5C6B,EAAS,MAAM,KAAKD,EAAK,iBAA8B,QAAQ,CAAC,EAAE,KAAME,GAC5EP,EAAU,IAAIO,EAAG,aAAa,MAAM,GAAK,EAAE,CAAA,GAE7CvB,EAAAsB,GAAA,YAAAA,EAAQ,iBAAR,MAAAtB,EAAA,KAAAsB,EAAyB,CAAE,SAAU,SAAU,MAAO,WACtDA,GAAA,MAAAA,EAAQ,MAAM,CAAE,cAAe,EAAA,EAEjC,EAAG,CAACvB,CAAM,CAAC,EAEPV,EAAQ,SAAW,EAAG,OAAO,KAEjC,MAAMmC,EAAQnC,EAAQ,IAAKoC,IAAS,CAClC,MAAOA,EAAI,KACX,MAAOA,EAAI,OAASA,EAAI,KAExB,KAAM9C,GAAa+C,EAAAA,QAAQD,EAAI,IAAI,EAAIE,EAAAA,IAACC,EAAAA,KAAA,CAAK,KAAMH,EAAI,IAAA,CAAM,EAAK7C,EAElE,MAAO0B,EAAemB,EAAI,IAAI,EAE9B,QACEE,EAAAA,IAAC,MAAA,CAAmB,UAAWE,EAAO,OACnC,WAAUC,GAAUzB,EAAAA,qBAAqBoB,EAAI,KAAMK,EAAOtC,CAAS,EAAGiC,EAAI,IAAI,GADvEA,EAAI,IAEd,CAAA,EAEF,EAEF,OACEE,EAAAA,IAACI,EAAAA,KAAA,CACC,IAAKrB,EACL,UAAA1B,EACA,MAAAC,EACA,MAAAuC,EACA,MAAOzB,EACP,SAAUE,EACV,QAAApB,EACA,KAAAC,EAEA,SAAU,KACV,aAAYC,CAAA,CAAA,CAGlB,CACF"}

package/dist/{TranslatedFields-HmP0Mg5t.js → TranslatedFields-Ccjhq2YL.js}

@@ -2,10 +2,10 @@ import { jsx as d } from "react/jsx-runtime";
 import { forwardRef as g, useState as z, useRef as b, useEffect as R } from "react";
 import { u as D } from "./formContext-B7ln1Miy.js";
 import { b as j } from "./translations-D15tFHM1.js";
-import { f as J } from "./messages-B06Kl5rI.js";
-import { F as M } from "./Flag-CzCEpB8E.js";
-import { T as P } from "./Tabs-v1GEGUDQ.js";
-import { h as Q, n as U } from "./ConfigProvider-DL9fylMo.js";
+import { f as J } from "./messages-DCefu6Pn.js";
+import { F as M } from "./Flag-CmDXvd7j.js";
+import { T as P } from "./Tabs-D1RGhKsa.js";
+import { h as Q, n as U } from "./ConfigProvider-BbsI15b-.js";
 const X = "_fields_aawaf_4", Y = {
   fields: X
 }, ie = g(
@@ -83,4 +83,4 @@ const X = "_fields_aawaf_4", Y = {
 export {
   ie as T
 };
-//# sourceMappingURL=TranslatedFields-HmP0Mg5t.js.map
+//# sourceMappingURL=TranslatedFields-Ccjhq2YL.js.map

package/dist/{TranslatedFields-HmP0Mg5t.js.map → TranslatedFields-Ccjhq2YL.js.map}

@@ -1 +1 @@
-{"version":3,"file":"TranslatedFields-HmP0Mg5t.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, 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 `'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': ariaLabel = 'Translations',\n      className,\n      style,\n    },\n    ref,\n  ) {\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","ariaLabel","className","style","ref","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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"}
+{"version":3,"file":"TranslatedFields-Ccjhq2YL.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, 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 `'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': ariaLabel = 'Translations',\n      className,\n      style,\n    },\n    ref,\n  ) {\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","ariaLabel","className","style","ref","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/Typography-B6ASPrzT.cjs

@@ -0,0 +1,2 @@
+"use strict";const b=require("react/jsx-runtime"),w=require("react"),v=require("clsx"),m="_typography_1s1ws_2",f="_h1_1s1ws_10",g="_h2_1s1ws_15",x="_h3_1s1ws_20",S="_h4_1s1ws_25",q="_subtitle_1s1ws_30",z="_body_1s1ws_34",C="_bodySmall_1s1ws_38",T="_caption_1s1ws_42",j="_overline_1s1ws_47",R="_uppercase_1s1ws_55",A="_truncate_1s1ws_58",t={typography:m,h1:f,h2:g,h3:x,h4:S,subtitle:q,body:z,bodySmall:C,caption:T,overline:j,uppercase:R,truncate:A},E={h1:"h1",h2:"h2",h3:"h3",h4:"h4",subtitle:"h6",body:"p",bodySmall:"p",caption:"span",overline:"span",uppercase:"span"};function N(s){if(s)return s==="text"?"var(--tz-color-text)":s==="muted"?"var(--tz-color-primary-shade600)":`var(--tz-color-${s})`}const V=w.forwardRef(function({variant:e="body",as:c,color:a,align:o,truncate:p=!1,uppercase:_=!1,className:l,style:h,children:u,...i},y){const r=e==="uppercase"?"overline":e,d=c??E[r],n=N(a);return b.jsx(d,{ref:y,className:v.clsx(t.typography,t[r],p&&t.truncate,_&&t.uppercase,l),style:{...n&&{color:n},...o&&{textAlign:o},...h},...i,children:u})});exports.Typography=V;
+//# sourceMappingURL=Typography-B6ASPrzT.cjs.map

package/dist/Typography-B6ASPrzT.cjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"Typography-B6ASPrzT.cjs","sources":["../src/components/Typography/Typography.tsx"],"sourcesContent":["import {\n  forwardRef,\n  type CSSProperties,\n  type ElementType,\n  type HTMLAttributes,\n  type ReactNode,\n} from 'react'\nimport { clsx } from 'clsx'\nimport type { ThemeColor } from '../../theme'\nimport styles from './Typography.module.css'\n\nexport type TypographyVariant =\n  | 'h1'\n  | 'h2'\n  | 'h3'\n  | 'h4'\n  | 'subtitle'\n  | 'body'\n  | 'bodySmall'\n  | 'caption'\n  | 'overline'\n  /** @deprecated Use `overline` (same look) — or the `uppercase` prop to capitalize any variant. */\n  | 'uppercase'\n\nexport type TypographyAlign = 'left' | 'center' | 'right' | 'justify'\n\n/**\n * Text color: a theme palette token, the semantic `text` role, or `muted` (a soft primary shade for\n * secondary text). Omit to inherit the surrounding color.\n */\nexport type TypographyColor = ThemeColor | 'text' | 'muted'\n\n/** Default HTML element rendered for each variant. Override with the `as` prop. */\nconst variantElement: Record<TypographyVariant, ElementType> = {\n  h1: 'h1',\n  h2: 'h2',\n  h3: 'h3',\n  h4: 'h4',\n  subtitle: 'h6',\n  body: 'p',\n  bodySmall: 'p',\n  caption: 'span',\n  overline: 'span',\n  uppercase: 'span',\n}\n\nfunction resolveColor(color?: TypographyColor): string | undefined {\n  if (!color) return undefined\n  if (color === 'text') return 'var(--tz-color-text)'\n  if (color === 'muted') return 'var(--tz-color-primary-shade600)'\n  return `var(--tz-color-${color})`\n}\n\nexport interface TypographyProps extends Omit<HTMLAttributes<HTMLElement>, 'color'> {\n  /**\n   * Type scale + default element. `h1`–`h4` headings · `subtitle` · `body` (default) · `bodySmall` · `caption` ·\n   * `overline` (a small, spaced-out, all-caps eyebrow label). `uppercase` is a deprecated alias of `overline`.\n   */\n  variant?: TypographyVariant\n  /** Render a different HTML element (or component) than the variant's default — keeps the styling, changes the tag. */\n  as?: ElementType\n  /** Text color. Omit to inherit the surrounding color. */\n  color?: TypographyColor\n  /** Horizontal text alignment. */\n  align?: TypographyAlign\n  /** Clamp to a single line, hiding overflow with an ellipsis. */\n  truncate?: boolean\n  /** Render the text in capitals (`text-transform: uppercase`) — any variant, size and spacing untouched. */\n  uppercase?: boolean\n  children?: ReactNode\n}\n\n/**\n * Text primitive for the design system. Each `variant` maps to a sensible HTML\n * element and a font size from the `--tz-font-size-*` scale; override the tag\n * with `as` when the semantics differ from the look. Default browser margins are\n * removed. Without a `color` it inherits the surrounding text color, mirroring\n * `Icon` and `Loader`. `uppercase` capitalizes any variant; `truncate` clamps to one line.\n */\nexport const Typography = forwardRef<HTMLElement, TypographyProps>(function Typography(\n  {\n    variant = 'body',\n    as,\n    color,\n    align,\n    truncate = false,\n    uppercase = false,\n    className,\n    style,\n    children,\n    ...props\n  },\n  ref,\n) {\n  // `uppercase` the VARIANT is the old name of `overline` (kept as an alias); `uppercase` the PROP is the\n  // plain capitals modifier — so the variant resolves to the `.overline` class, freeing `.uppercase`\n  const resolvedVariant = variant === 'uppercase' ? 'overline' : variant\n  const Component = (as ?? variantElement[resolvedVariant]) as ElementType\n  const resolvedColor = resolveColor(color)\n\n  return (\n    <Component\n      ref={ref}\n      className={clsx(\n        styles.typography,\n        styles[resolvedVariant],\n        truncate && styles.truncate,\n        uppercase && styles.uppercase,\n        className,\n      )}\n      style={\n        {\n          ...(resolvedColor && { color: resolvedColor }),\n          ...(align && { textAlign: align }),\n          ...style,\n        } as CSSProperties\n      }\n      {...props}\n    >\n      {children}\n    </Component>\n  )\n})\n"],"names":["variantElement","resolveColor","color","Typography","forwardRef","variant","as","align","truncate","uppercase","className","style","children","props","ref","resolvedVariant","Component","resolvedColor","jsx","clsx","styles"],"mappings":"gcAiCMA,EAAyD,CAC7D,GAAI,KACJ,GAAI,KACJ,GAAI,KACJ,GAAI,KACJ,SAAU,KACV,KAAM,IACN,UAAW,IACX,QAAS,OACT,SAAU,OACV,UAAW,MACb,EAEA,SAASC,EAAaC,EAA6C,CACjE,GAAKA,EACL,OAAIA,IAAU,OAAe,uBACzBA,IAAU,QAAgB,mCACvB,kBAAkBA,CAAK,GAChC,CA4BO,MAAMC,EAAaC,EAAAA,WAAyC,SACjE,CACE,QAAAC,EAAU,OACV,GAAAC,EACA,MAAAJ,EACA,MAAAK,EACA,SAAAC,EAAW,GACX,UAAAC,EAAY,GACZ,UAAAC,EACA,MAAAC,EACA,SAAAC,EACA,GAAGC,CACL,EACAC,EACA,CAGA,MAAMC,EAAkBV,IAAY,YAAc,WAAaA,EACzDW,EAAaV,GAAMN,EAAee,CAAe,EACjDE,EAAgBhB,EAAaC,CAAK,EAExC,OACEgB,EAAAA,IAACF,EAAA,CACC,IAAAF,EACA,UAAWK,EAAAA,KACTC,EAAO,WACPA,EAAOL,CAAe,EACtBP,GAAYY,EAAO,SACnBX,GAAaW,EAAO,UACpBV,CAAA,EAEF,MACE,CACE,GAAIO,GAAiB,CAAE,MAAOA,CAAA,EAC9B,GAAIV,GAAS,CAAE,UAAWA,CAAA,EAC1B,GAAGI,CAAA,EAGN,GAAGE,EAEH,SAAAD,CAAA,CAAA,CAGP,CAAC"}

package/dist/Typography-CJv5AnRP.js

@@ -0,0 +1,70 @@
+import { jsx as m } from "react/jsx-runtime";
+import { forwardRef as b } from "react";
+import { clsx as w } from "clsx";
+const f = "_typography_1s1ws_2", v = "_h1_1s1ws_10", g = "_h2_1s1ws_15", x = "_h3_1s1ws_20", S = "_h4_1s1ws_25", z = "_subtitle_1s1ws_30", C = "_body_1s1ws_34", T = "_bodySmall_1s1ws_38", j = "_caption_1s1ws_42", A = "_overline_1s1ws_47", E = "_uppercase_1s1ws_55", N = "_truncate_1s1ws_58", t = {
+  typography: f,
+  h1: v,
+  h2: g,
+  h3: x,
+  h4: S,
+  subtitle: z,
+  body: C,
+  bodySmall: T,
+  caption: j,
+  overline: A,
+  uppercase: E,
+  truncate: N
+}, R = {
+  h1: "h1",
+  h2: "h2",
+  h3: "h3",
+  h4: "h4",
+  subtitle: "h6",
+  body: "p",
+  bodySmall: "p",
+  caption: "span",
+  overline: "span",
+  uppercase: "span"
+};
+function V(s) {
+  if (s)
+    return s === "text" ? "var(--tz-color-text)" : s === "muted" ? "var(--tz-color-primary-shade600)" : `var(--tz-color-${s})`;
+}
+const B = b(function({
+  variant: o = "body",
+  as: a,
+  color: p,
+  align: e,
+  truncate: c = !1,
+  uppercase: _ = !1,
+  className: l,
+  style: h,
+  children: i,
+  ...y
+}, u) {
+  const r = o === "uppercase" ? "overline" : o, d = a ?? R[r], n = V(p);
+  return /* @__PURE__ */ m(
+    d,
+    {
+      ref: u,
+      className: w(
+        t.typography,
+        t[r],
+        c && t.truncate,
+        _ && t.uppercase,
+        l
+      ),
+      style: {
+        ...n && { color: n },
+        ...e && { textAlign: e },
+        ...h
+      },
+      ...y,
+      children: i
+    }
+  );
+});
+export {
+  B as T
+};
+//# sourceMappingURL=Typography-CJv5AnRP.js.map

package/dist/Typography-CJv5AnRP.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"Typography-CJv5AnRP.js","sources":["../src/components/Typography/Typography.tsx"],"sourcesContent":["import {\n  forwardRef,\n  type CSSProperties,\n  type ElementType,\n  type HTMLAttributes,\n  type ReactNode,\n} from 'react'\nimport { clsx } from 'clsx'\nimport type { ThemeColor } from '../../theme'\nimport styles from './Typography.module.css'\n\nexport type TypographyVariant =\n  | 'h1'\n  | 'h2'\n  | 'h3'\n  | 'h4'\n  | 'subtitle'\n  | 'body'\n  | 'bodySmall'\n  | 'caption'\n  | 'overline'\n  /** @deprecated Use `overline` (same look) — or the `uppercase` prop to capitalize any variant. */\n  | 'uppercase'\n\nexport type TypographyAlign = 'left' | 'center' | 'right' | 'justify'\n\n/**\n * Text color: a theme palette token, the semantic `text` role, or `muted` (a soft primary shade for\n * secondary text). Omit to inherit the surrounding color.\n */\nexport type TypographyColor = ThemeColor | 'text' | 'muted'\n\n/** Default HTML element rendered for each variant. Override with the `as` prop. */\nconst variantElement: Record<TypographyVariant, ElementType> = {\n  h1: 'h1',\n  h2: 'h2',\n  h3: 'h3',\n  h4: 'h4',\n  subtitle: 'h6',\n  body: 'p',\n  bodySmall: 'p',\n  caption: 'span',\n  overline: 'span',\n  uppercase: 'span',\n}\n\nfunction resolveColor(color?: TypographyColor): string | undefined {\n  if (!color) return undefined\n  if (color === 'text') return 'var(--tz-color-text)'\n  if (color === 'muted') return 'var(--tz-color-primary-shade600)'\n  return `var(--tz-color-${color})`\n}\n\nexport interface TypographyProps extends Omit<HTMLAttributes<HTMLElement>, 'color'> {\n  /**\n   * Type scale + default element. `h1`–`h4` headings · `subtitle` · `body` (default) · `bodySmall` · `caption` ·\n   * `overline` (a small, spaced-out, all-caps eyebrow label). `uppercase` is a deprecated alias of `overline`.\n   */\n  variant?: TypographyVariant\n  /** Render a different HTML element (or component) than the variant's default — keeps the styling, changes the tag. */\n  as?: ElementType\n  /** Text color. Omit to inherit the surrounding color. */\n  color?: TypographyColor\n  /** Horizontal text alignment. */\n  align?: TypographyAlign\n  /** Clamp to a single line, hiding overflow with an ellipsis. */\n  truncate?: boolean\n  /** Render the text in capitals (`text-transform: uppercase`) — any variant, size and spacing untouched. */\n  uppercase?: boolean\n  children?: ReactNode\n}\n\n/**\n * Text primitive for the design system. Each `variant` maps to a sensible HTML\n * element and a font size from the `--tz-font-size-*` scale; override the tag\n * with `as` when the semantics differ from the look. Default browser margins are\n * removed. Without a `color` it inherits the surrounding text color, mirroring\n * `Icon` and `Loader`. `uppercase` capitalizes any variant; `truncate` clamps to one line.\n */\nexport const Typography = forwardRef<HTMLElement, TypographyProps>(function Typography(\n  {\n    variant = 'body',\n    as,\n    color,\n    align,\n    truncate = false,\n    uppercase = false,\n    className,\n    style,\n    children,\n    ...props\n  },\n  ref,\n) {\n  // `uppercase` the VARIANT is the old name of `overline` (kept as an alias); `uppercase` the PROP is the\n  // plain capitals modifier — so the variant resolves to the `.overline` class, freeing `.uppercase`\n  const resolvedVariant = variant === 'uppercase' ? 'overline' : variant\n  const Component = (as ?? variantElement[resolvedVariant]) as ElementType\n  const resolvedColor = resolveColor(color)\n\n  return (\n    <Component\n      ref={ref}\n      className={clsx(\n        styles.typography,\n        styles[resolvedVariant],\n        truncate && styles.truncate,\n        uppercase && styles.uppercase,\n        className,\n      )}\n      style={\n        {\n          ...(resolvedColor && { color: resolvedColor }),\n          ...(align && { textAlign: align }),\n          ...style,\n        } as CSSProperties\n      }\n      {...props}\n    >\n      {children}\n    </Component>\n  )\n})\n"],"names":["variantElement","resolveColor","color","Typography","forwardRef","variant","as","align","truncate","uppercase","className","style","children","props","ref","resolvedVariant","Component","resolvedColor","jsx","clsx","styles"],"mappings":";;;;;;;;;;;;;;;;GAiCMA,IAAyD;AAAA,EAC7D,IAAI;AAAA,EACJ,IAAI;AAAA,EACJ,IAAI;AAAA,EACJ,IAAI;AAAA,EACJ,UAAU;AAAA,EACV,MAAM;AAAA,EACN,WAAW;AAAA,EACX,SAAS;AAAA,EACT,UAAU;AAAA,EACV,WAAW;AACb;AAEA,SAASC,EAAaC,GAA6C;AACjE,MAAKA;AACL,WAAIA,MAAU,SAAe,yBACzBA,MAAU,UAAgB,qCACvB,kBAAkBA,CAAK;AAChC;AA4BO,MAAMC,IAAaC,EAAyC,SACjE;AAAA,EACE,SAAAC,IAAU;AAAA,EACV,IAAAC;AAAA,EACA,OAAAJ;AAAA,EACA,OAAAK;AAAA,EACA,UAAAC,IAAW;AAAA,EACX,WAAAC,IAAY;AAAA,EACZ,WAAAC;AAAA,EACA,OAAAC;AAAA,EACA,UAAAC;AAAA,EACA,GAAGC;AACL,GACAC,GACA;AAGA,QAAMC,IAAkBV,MAAY,cAAc,aAAaA,GACzDW,IAAaV,KAAMN,EAAee,CAAe,GACjDE,IAAgBhB,EAAaC,CAAK;AAExC,SACE,gBAAAgB;AAAA,IAACF;AAAA,IAAA;AAAA,MACC,KAAAF;AAAA,MACA,WAAWK;AAAA,QACTC,EAAO;AAAA,QACPA,EAAOL,CAAe;AAAA,QACtBP,KAAYY,EAAO;AAAA,QACnBX,KAAaW,EAAO;AAAA,QACpBV;AAAA,MAAA;AAAA,MAEF,OACE;AAAA,QACE,GAAIO,KAAiB,EAAE,OAAOA,EAAA;AAAA,QAC9B,GAAIV,KAAS,EAAE,WAAWA,EAAA;AAAA,QAC1B,GAAGI;AAAA,MAAA;AAAA,MAGN,GAAGE;AAAA,MAEH,UAAAD;AAAA,IAAA;AAAA,EAAA;AAGP,CAAC;"}

package/dist/UserCard-BfHHfkDr.cjs

@@ -0,0 +1,2 @@
+"use strict";const t=require("react/jsx-runtime"),q=require("react"),p=require("clsx"),g=require("./Avatar-DrV_F7Ex.cjs"),C=require("./Button-CusxDmfq.cjs"),S=require("./Icon-BVULqOJD.cjs"),a=require("./Skeleton-DK0lAjS9.cjs"),d=require("./Typography-B6ASPrzT.cjs"),w=require("./ConfigProvider-ByLHqXpv.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-BfHHfkDr.cjs.map

package/dist/UserCard-BfHHfkDr.cjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"UserCard-BfHHfkDr.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 + fonts + button). 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. Drop it into\n * the `RootLayout` `sidebarFooter` (or anywhere) for a consistent signed-in-user block across apps,\n * instead of hand-rolling the markup each time. 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 + type; `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":"0bA+CaA,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-Bs8kuV2j.js

@@ -0,0 +1,78 @@
+import { jsxs as e, jsx as t } from "react/jsx-runtime";
+import { forwardRef as S } from "react";
+import { clsx as g } from "clsx";
+import { A as w } from "./Avatar-DXNPg23a.js";
+import { B as U } from "./Button-CWMNNiia.js";
+import { I as b } from "./Icon-DaTvzLBu.js";
+import { S as m } from "./Skeleton-_-uGax2j.js";
+import { T as d } from "./Typography-CJv5AnRP.js";
+import { a as I } from "./ConfigProvider-BbsI15b-.js";
+const N = "_card_1fykc_3", T = "_identity_1fykc_16", j = "_text_1fykc_20", A = "_sm_1fykc_33", B = "_lg_1fykc_37", o = {
+  card: N,
+  identity: T,
+  text: j,
+  sm: A,
+  lg: B
+}, J = S(function({
+  name: c,
+  email: a,
+  avatar: l,
+  icon: f = "User",
+  color: u = "primary",
+  size: s = "md",
+  onLogout: i,
+  logoutLabel: y,
+  children: _,
+  loading: r = !1,
+  className: p,
+  style: h,
+  ...v
+}, x) {
+  const n = I(), k = s === "lg" ? "lg" : s === "sm" ? "sm" : "md", C = s === "lg" ? "md" : "sm";
+  return /* @__PURE__ */ e(
+    "div",
+    {
+      ref: x,
+      className: g(o.card, o[s], p),
+      style: h,
+      "aria-busy": r || void 0,
+      ...v,
+      children: [
+        /* @__PURE__ */ e("div", { className: o.identity, children: [
+          /* @__PURE__ */ t(
+            w,
+            {
+              size: k,
+              name: c,
+              src: l,
+              icon: c ? void 0 : f,
+              color: u,
+              loading: r
+            }
+          ),
+          /* @__PURE__ */ e("div", { className: o.text, children: [
+            /* @__PURE__ */ t(d, { variant: "bodySmall", truncate: !0, children: r ? /* @__PURE__ */ t(m, { width: "60%" }) : c ?? n("userCard.welcome") }),
+            (r || a != null) && /* @__PURE__ */ t(d, { variant: "caption", color: "muted", truncate: !0, children: r ? /* @__PURE__ */ t(m, { width: "85%" }) : a })
+          ] })
+        ] }),
+        _,
+        i ? /* @__PURE__ */ t(
+          U,
+          {
+            variant: "filled",
+            color: "error",
+            size: C,
+            fullWidth: !0,
+            startIcon: /* @__PURE__ */ t(b, { name: "Logout2" }),
+            onClick: i,
+            children: y ?? n("userCard.signOut")
+          }
+        ) : null
+      ]
+    }
+  );
+});
+export {
+  J as U
+};
+//# sourceMappingURL=UserCard-Bs8kuV2j.js.map

package/dist/UserCard-Bs8kuV2j.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"UserCard-Bs8kuV2j.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 + fonts + button). 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. Drop it into\n * the `RootLayout` `sidebarFooter` (or anywhere) for a consistent signed-in-user block across apps,\n * instead of hand-rolling the markup each time. 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 + type; `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":";;;;;;;;;;;;;;;GA+CaA,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 RootLayoutHeader } from '../components';
+import { type ErrorBoundaryProps, type RootLayoutHeader } from '../components';
 /** The minimal user shape `AdminRoot` reads — apps pass their own richer type via the generic. */
 export interface AdminUser {
     name?: string;
@@ -24,13 +24,20 @@ export interface AdminRootProps<U extends AdminUser = AdminUser> {
      * unchanged — e.g. **`header.menu`** (`HeaderMenuItem[]`) adds items to the account menu above Sign out.
      */
     header?: RootLayoutHeader;
+    /**
+     * Wrap the page content in an `ErrorBoundary` (reset on navigation), so a crashing page shows an
+     * `ErrorState` inside the shell instead of a white screen. Default `true`; `false` opts out; an object
+     * configures it (e.g. `{ onError: Sentry.captureException }` or a custom `fallback`).
+     */
+    errorBoundary?: boolean | Omit<ErrorBoundaryProps, 'children' | 'resetKeys'>;
 }
 /**
  * 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
  * `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/>` (the inner `RootLayout` gets `toaster={false}`),
+ * and wraps the page in an `ErrorBoundary` that resets on navigation (`errorBoundary`, default on).
  *
  * `loginPath` is a plain string, cast loosely to the router's `to` type (the library can't know the
  * app's typed route tree). The generic `<U>` preserves the app's own user type through `getUser`.
@@ -41,4 +48,4 @@ export interface AdminRootProps<U extends AdminUser = AdminUser> {
  *   component: () => <AdminRoot<AuthUser> logo={<Logo />} getUser={getUser} onLogout={logout} />,
  * })
  */
-export declare const AdminRoot: <U extends AdminUser = AdminUser>({ logo, getUser, onLogout, authRouteId, loginPath, showUserCard, header, }: AdminRootProps<U>) => import("react/jsx-runtime").JSX.Element;
+export declare const AdminRoot: <U extends AdminUser = AdminUser>({ logo, getUser, onLogout, authRouteId, loginPath, showUserCard, header, errorBoundary, }: 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 RootLayoutHeader } from '../components';
+import { type ErrorBoundaryProps, type RootLayoutHeader } from '../components';
 /** The minimal user shape `AdminRoot` reads — apps pass their own richer type via the generic. */
 export interface AdminUser {
     name?: string;
@@ -24,13 +24,20 @@ export interface AdminRootProps<U extends AdminUser = AdminUser> {
      * unchanged — e.g. **`header.menu`** (`HeaderMenuItem[]`) adds items to the account menu above Sign out.
      */
     header?: RootLayoutHeader;
+    /**
+     * Wrap the page content in an `ErrorBoundary` (reset on navigation), so a crashing page shows an
+     * `ErrorState` inside the shell instead of a white screen. Default `true`; `false` opts out; an object
+     * configures it (e.g. `{ onError: Sentry.captureException }` or a custom `fallback`).
+     */
+    errorBoundary?: boolean | Omit<ErrorBoundaryProps, 'children' | 'resetKeys'>;
 }
 /**
  * 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
  * `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/>` (the inner `RootLayout` gets `toaster={false}`),
+ * and wraps the page in an `ErrorBoundary` that resets on navigation (`errorBoundary`, default on).
  *
  * `loginPath` is a plain string, cast loosely to the router's `to` type (the library can't know the
  * app's typed route tree). The generic `<U>` preserves the app's own user type through `getUser`.
@@ -41,4 +48,4 @@ export interface AdminRootProps<U extends AdminUser = AdminUser> {
  *   component: () => <AdminRoot<AuthUser> logo={<Logo />} getUser={getUser} onLogout={logout} />,
  * })
  */
-export declare const AdminRoot: <U extends AdminUser = AdminUser>({ logo, getUser, onLogout, authRouteId, loginPath, showUserCard, header, }: AdminRootProps<U>) => import("react/jsx-runtime").JSX.Element;
+export declare const AdminRoot: <U extends AdminUser = AdminUser>({ logo, getUser, onLogout, authRouteId, loginPath, showUserCard, header, errorBoundary, }: AdminRootProps<U>) => import("react/jsx-runtime").JSX.Element;

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-DeGgilkH.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-VFQuuII6.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-rNjfqj2Z.js";
+import { A as r, A as t } from "../../Alert-CJono1TJ.js";
 export {
   r as Alert,
   t as default

package/dist/components/AuthLayout/index.cjs

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

package/dist/components/AuthLayout/index.js

@@ -1,4 +1,4 @@
-import { A as o, A as u } from "../../AuthLayout-zAS3jlYc.js";
+import { A as o, A as u } from "../../AuthLayout-DOFYw_z5.js";
 export {
   o as AuthLayout,
   u as default

package/dist/components/Avatar/Avatar.d.cts

@@ -18,11 +18,17 @@ export interface AvatarProps extends Omit<HTMLAttributes<HTMLDivElement>, 'color
     shape?: AvatarShape;
     /** Theme palette token for the icon/initials background. Defaults to `accent`. */
     color?: ThemeColor;
+    /**
+     * Render a skeleton disc (same size / shape) instead of any content — while the user is still being
+     * fetched. An image avatar also shows the skeleton on its own until the photo has loaded. Defaults to `false`.
+     */
+    loading?: boolean;
 }
 /**
  * A user avatar that shows — in priority order — an image (`src`), an `icon`, explicit `children`
  * (e.g. initials `"D.S."`), initials derived from `name`, or a default user icon. If the image fails
- * to load it falls back automatically. The icon/initials background is tinted by `color` via the
+ * to load it falls back automatically; until it has loaded (and whenever `loading` is set) a `Skeleton`
+ * of the same size / shape stands in. The icon/initials background is tinted by `color` via the
  * shared `--tz-btn-rgb` / `--tz-btn-on` pattern. Token-only styling; pairs with `AvatarGroup`.
  */
 export declare const Avatar: import("react").ForwardRefExoticComponent<AvatarProps & import("react").RefAttributes<HTMLDivElement>>;

package/dist/components/Avatar/Avatar.d.ts

@@ -18,11 +18,17 @@ export interface AvatarProps extends Omit<HTMLAttributes<HTMLDivElement>, 'color
     shape?: AvatarShape;
     /** Theme palette token for the icon/initials background. Defaults to `accent`. */
     color?: ThemeColor;
+    /**
+     * Render a skeleton disc (same size / shape) instead of any content — while the user is still being
+     * fetched. An image avatar also shows the skeleton on its own until the photo has loaded. Defaults to `false`.
+     */
+    loading?: boolean;
 }
 /**
  * A user avatar that shows — in priority order — an image (`src`), an `icon`, explicit `children`
  * (e.g. initials `"D.S."`), initials derived from `name`, or a default user icon. If the image fails
- * to load it falls back automatically. The icon/initials background is tinted by `color` via the
+ * to load it falls back automatically; until it has loaded (and whenever `loading` is set) a `Skeleton`
+ * of the same size / shape stands in. The icon/initials background is tinted by `color` via the
  * shared `--tz-btn-rgb` / `--tz-btn-on` pattern. Token-only styling; pairs with `AvatarGroup`.
  */
 export declare const Avatar: import("react").ForwardRefExoticComponent<AvatarProps & import("react").RefAttributes<HTMLDivElement>>;

package/dist/components/Avatar/index.cjs

@@ -1,2 +1,2 @@
-"use strict";Object.defineProperties(exports,{__esModule:{value:!0},[Symbol.toStringTag]:{value:"Module"}});const r=require("../../Avatar-D_YivyqV.cjs"),a=require("../../AvatarGroup-Bnf_RSc9.cjs");exports.Avatar=r.Avatar;exports.default=r.Avatar;exports.AvatarGroup=a.AvatarGroup;
+"use strict";Object.defineProperties(exports,{__esModule:{value:!0},[Symbol.toStringTag]:{value:"Module"}});const r=require("../../Avatar-DrV_F7Ex.cjs"),a=require("../../AvatarGroup-CHesdo-M.cjs");exports.Avatar=r.Avatar;exports.default=r.Avatar;exports.AvatarGroup=a.AvatarGroup;
 //# sourceMappingURL=index.cjs.map

package/dist/components/Avatar/index.js

@@ -1,5 +1,5 @@
-import { A as o, A as t } from "../../Avatar-BGPGxry2.js";
-import { A as e } from "../../AvatarGroup-Difz4lLR.js";
+import { A as o, A as t } from "../../Avatar-DXNPg23a.js";
+import { A as e } from "../../AvatarGroup-CwlYqDCI.js";
 export {
   o as Avatar,
   e as AvatarGroup,

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-CGcpMlxm.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-DCEHxpSi.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-BJHKk0Sn.js";
+import { B as e, B as s } from "../../Breadcrumbs-XWU8tRvs.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-BZ_o-akc.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-CusxDmfq.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-obe6rono.js";
+import { B as o, B } from "../../Button-CWMNNiia.js";
 export {
   o as Button,
   B as default

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

@@ -26,6 +26,8 @@ export interface CardProps extends Omit<HTMLAttributes<HTMLDivElement>, 'title'
     defaultCollapsed?: boolean;
     /** Fires with the next collapsed state when the toggle is clicked. */
     onCollapsedChange?: (collapsed: boolean) => void;
+    /** Replace the body with skeleton lines while its data loads (header + footer stay). Defaults to `false`. */
+    loading?: boolean;
     /** Card body. */
     children?: ReactNode;
 }

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

@@ -26,6 +26,8 @@ export interface CardProps extends Omit<HTMLAttributes<HTMLDivElement>, 'title'
     defaultCollapsed?: boolean;
     /** Fires with the next collapsed state when the toggle is clicked. */
     onCollapsedChange?: (collapsed: boolean) => void;
+    /** Replace the body with skeleton lines while its data loads (header + footer stay). Defaults to `false`. */
+    loading?: boolean;
     /** Card body. */
     children?: ReactNode;
 }

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-KvvNlchc.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-CUUh4mlB.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-BRJV2JZE.js";
+import { C, C as d } from "../../Card-MxYfQTOY.js";
 export {
   C as Card,
   d as default

package/dist/components/Checkbox/index.cjs

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