@techzyapp/ui-library 1.0.0

package/dist/theme/ConfigProvider.d.ts

@@ -0,0 +1,362 @@
+import { type ReactNode } from 'react';
+import { type ThemePalette } from './applyTheme';
+import { type AppMessages, type AppTranslator, type MessageOverrides, type Translator } from '../i18n/messages';
+export type ThemeMode = 'light' | 'dark';
+export interface ThemeColors {
+    /** Light-mode palette. Override any subset of the theme colors — the rest use the library defaults. */
+    light?: Partial<ThemePalette>;
+    /** Dark-mode overrides, layered on the (merged) light palette + the library's dark defaults. */
+    dark?: Partial<ThemePalette>;
+}
+/** A content locale the app supports — a tab in `<TranslatedFields>`. */
+export interface LocaleConfig {
+    /** BCP-47 locale code, e.g. `'en-US'`. Namespaces the form field names and is the tab's fallback label. */
+    code: string;
+    /** Human-readable tab label. Falls back to `code`. */
+    label?: string;
+}
+/** Theme settings — color overrides + initial mode. Lives under `Config.theme`. */
+export interface ThemeConfig {
+    /** Theme color overrides. Omit entirely to use the library's built-in theme. */
+    colors?: ThemeColors;
+    /** Initial color mode. */
+    mode?: ThemeMode;
+    /**
+     * Default font family — the app-wide default the user's Settings choice overrides (persisted). One of
+     * the pre-imported presets (`Inter` / `Roboto` / `Lato`) or any Google Font family name. Defaults to
+     * `Inter`. A non-preset family is loaded on demand at runtime.
+     */
+    fontFamily?: string;
+}
+/**
+ * The configurable key / param **names** the library's components read — grouped under `Config.keys`
+ * so they live in one place. Each is overridable; omit one to use its built-in default. Grows over
+ * time (e.g. `page` / `size` for paginated tables ⇒ `?page=1&size=10`).
+ */
+export interface KeysConfig {
+    /**
+     * URL query param name a **top-level** `<Tabs>` syncs its active tab to (e.g. `'view'` ⇒ `?view=…`),
+     * unless that strip sets its own `queryKey` (or `queryKey={null}` to opt out). Defaults to `'tab'`.
+     */
+    tabQueryKey?: string;
+    /**
+     * URL query param name a **nested** `<Tabs>` (one rendered inside another tab's panel) syncs to, so it
+     * doesn't collide with the outer strip's `tabQueryKey` (e.g. `?tab=…&nestedTab=…`). Auto-applied by
+     * nesting depth; overridable per strip via `queryKey`. Defaults to `'nestedTab'`.
+     */
+    nestedTabQueryKey?: string;
+    /**
+     * URL query param name a `<Stepper queryKey>` (the bare/`true` form) syncs its active step to
+     * (**1-based**, e.g. `?step=2`); a string `queryKey` overrides it per stepper. Defaults to `'step'`.
+     * (The sync itself is **opt-in** — a stepper with no `queryKey` never touches the URL.)
+     */
+    stepQueryKey?: string;
+    /**
+     * Top-level namespace word for `<TranslatedFields>`' form names + the nested object — e.g.
+     * `'languages'` ⇒ `languages[en-US].title`. Defaults to `'translations'`.
+     */
+    translationsNamespace?: string;
+}
+/**
+ * How a `<Table>` builds its **server-request** params — the query it hands the consumer (as `params` /
+ * `query`) in `onChange`, so a server-mode fetch doesn't hand-map page/size/search/sort every time. This is
+ * the **backend transport** layer, distinct from `keys.*QueryKey` (the browser-URL sync, always page-based
+ * for shareable links). Set once in `config.table.query`, override per table via the `queryMapping` prop.
+ * Every field is optional; the defaults reproduce the browser-URL shape (`?page=1&size=10&search=…&sort=-key`).
+ */
+export interface TableQueryConfig {
+    /** Request param name for the page / offset. Defaults to `'page'` (e.g. `'skip'` for an offset API). */
+    pageParam?: string;
+    /** Request param name for the page size. Defaults to `'size'` (e.g. `'limit'`). */
+    sizeParam?: string;
+    /** Request param name for the search query (omitted when the search is empty). Defaults to `'search'` (e.g. `'q'`). */
+    searchParam?: string;
+    /**
+     * Request param name holding the sort **key**. Defaults to `'sort'` (e.g. `'sortBy'`). With
+     * `sortFormat: 'field'` this single param also carries the direction (`-key` = desc); with `'separate'`
+     * the direction goes to `sortOrderParam`.
+     */
+    sortParam?: string;
+    /**
+     * Pagination style. `'page'` (default) emits the **1-based page number** as-is (`page=2`); `'offset'`
+     * emits a **zero-based offset** `(page - 1) * size` instead (`skip=10`), for skip/offset APIs.
+     */
+    pagination?: 'page' | 'offset';
+    /**
+     * Sort encoding. `'field'` (default) is a single param with a `-` prefix for descending (`sort=-price`);
+     * `'separate'` splits into two params — the key in `sortParam` + the direction in `sortOrderParam`
+     * (`sortBy=price&order=desc`); `'suffix'` appends the direction value to the key in a single param
+     * (`sort=priceAsc` / `sort=priceDesc` with `ascValue: 'Asc'` / `descValue: 'Desc'`).
+     */
+    sortFormat?: 'field' | 'separate' | 'suffix';
+    /** Direction param name when `sortFormat: 'separate'`. Defaults to `'order'`. */
+    sortOrderParam?: string;
+    /**
+     * Value emitted for an ascending sort — the `sortOrderParam` value when `sortFormat: 'separate'`, or the
+     * suffix appended to the key when `sortFormat: 'suffix'`. Defaults to `'asc'`.
+     */
+    ascValue?: string;
+    /**
+     * Value emitted for a descending sort — the `sortOrderParam` value when `sortFormat: 'separate'`, or the
+     * suffix appended to the key when `sortFormat: 'suffix'`. Defaults to `'desc'`.
+     */
+    descValue?: string;
+    /**
+     * What to emit for the size param when the **"All"** rows-per-page choice is active. A `string`/`number`
+     * sets `size=<allValue>` (e.g. `0` for APIs where `limit=0` means "all"); omit it (default) to drop the
+     * size param entirely (many APIs treat a missing limit as unbounded).
+     */
+    allValue?: string | number;
+    /**
+     * How a **`multiSelect`** filter serializes into the request query: `'repeat'` (default — `cat=a&cat=b`),
+     * `'csv'` (`cat=a,b`), or `'indexed'` (`cat[0]=a&cat[1]=b`).
+     */
+    multiSelectFormat?: 'repeat' | 'csv' | 'indexed';
+    /**
+     * Suffix appended to a **range** filter's param for its lower / upper bound — e.g. `Min`/`Max` (default)
+     * → `priceMin`/`priceMax`; set `'_gte'`/`'_lte'`, `'[gte]'`/`'[lte]'`, `'From'`/`'To'`, … to match your API.
+     */
+    rangeMinSuffix?: string;
+    rangeMaxSuffix?: string;
+}
+/** `<Table>`-specific configuration. Grows over time; today just the server-request query mapping. */
+export interface TableConfig {
+    /** How `<Table>` builds its server-request params (emitted as `params` / `query` in `onChange`). */
+    query?: TableQueryConfig;
+}
+/** Signed-in user shown in the shell header avatar + its account menu (see `HeaderConfig`). */
+export interface HeaderUser {
+    /** Full name — shown as the menu's name line. */
+    name?: string;
+    /** Email shown under the name in the account menu. */
+    email?: string;
+    /** Avatar image URL (falls back to a user icon). */
+    avatar?: string;
+}
+/**
+ * `RootLayout` header configuration — the shell's top-bar controls. Set it once app-wide in
+ * `config.header`, or per shell via the `RootLayout` `header` prop (the prop wins, merged over config).
+ */
+export interface HeaderConfig {
+    /** Show the built-in light/dark theme toggle. Defaults to `true`. */
+    theme?: boolean;
+    /**
+     * Make the shell header **stick to the top on scroll** (fixed) instead of scrolling away (static).
+     * This is the app-wide default; the user can flip it in the **Settings** drawer and their choice is
+     * persisted (`localStorage['tz-header-sticky']`), overriding this. Defaults to `false` (static).
+     */
+    sticky?: boolean;
+    /** Show the browser-fullscreen toggle (auto-hides where the Fullscreen API is unavailable). Defaults to `false`. */
+    fullscreen?: boolean;
+    /** Show the **Settings** button (opens the right-side drawer to pick the per-mode `accent`). Defaults to `true`. */
+    settings?: boolean;
+    /** Show the nav search over the sidebar's pages (with suggestions). Defaults to `true`. */
+    search?: boolean;
+    /**
+     * Show the header **language switcher** (the `Global`-icon dropdown of `config.i18n.languages`).
+     * Defaults to `true`, but it only renders when more than one UI language is configured — so pass
+     * `false` to hide it even with several languages (the panel stays on its current/default language).
+     */
+    languages?: boolean;
+    /** Show the breadcrumb trail at the top of the content. Defaults to **`true`**. */
+    breadcrumbs?: boolean;
+    /** Render the automatic page-title `h2` (the active route's `staticData.name`). Defaults to `true`. */
+    pageTitle?: boolean;
+    /** When provided, an account `Avatar` appears; its menu has a **Sign out** item that calls this. */
+    onLogout?: () => void;
+    /** Signed-in user — shown in the header avatar and as a header block atop the account menu. */
+    user?: HeaderUser;
+}
+/**
+ * UI-language config for the admin panel's **own** static strings (labels, placeholders, aria-labels).
+ * Distinct from `locales` (which is content-translation locales for `<TranslatedFields>`). The library
+ * ships built-in translations (English + Georgian), so listing `languages` here is enough to get a
+ * localized panel — no per-app setup. Any language the library doesn't ship is supplied via `messages`.
+ */
+export interface I18nConfig {
+    /**
+     * Active UI language on first load (a locale code, e.g. `'ka-GE'`). Defaults to English if listed in
+     * `languages`, else the first `languages` entry, else `'en-US'`. The user's switcher choice (persisted)
+     * overrides it.
+     */
+    language?: string;
+    /**
+     * The UI languages the panel offers — drives the Settings language switcher. One entry = a fixed
+     * language (no switcher). Defaults to English only. (Reuses the `{ code, label }` shape.)
+     */
+    languages?: LocaleConfig[];
+    /**
+     * Extra / override message catalogs for the **library's own** strings, merged **over** the built-ins
+     * and keyed by language code or base language (`'ka-GE'` or `'ka'`). Use this to localize into a
+     * language the library doesn't ship, or to tweak a built-in string. Unset keys fall back to English.
+     */
+    messages?: MessageOverrides;
+    /**
+     * Catalogs for the **consuming app's own** UI strings — its section titles, labels, business copy —
+     * keyed by language code/base then by any string key the app picks. Read via **`useTranslations()`**,
+     * which binds to the active UI language, so the app's text switches together with the panel. Resolution
+     * per key: exact code → base language → English (`'en'`) → the key itself. This is the app's own copy;
+     * `messages` above is only for the library's built-in strings.
+     */
+    appMessages?: AppMessages;
+}
+/**
+ * App-level configuration passed to `<ConfigProvider config={…}>`. Groups theming under `theme`,
+ * the configurable key/param names under `keys`, and keeps the rest (`locales`, …) at the top — a
+ * single place to grow.
+ */
+export interface Config {
+    /** Theme settings (color overrides + initial mode). Omit entirely to use the built-in theme. */
+    theme?: ThemeConfig;
+    /** Content locales the app supports — drive `<TranslatedFields>`' tabs (one per locale). */
+    locales?: LocaleConfig[];
+    /** UI-language config for the panel's own strings (the library ships the translations). See `I18nConfig`. */
+    i18n?: I18nConfig;
+    /**
+     * Configurable key / query-param names the components read — e.g. the `<Tabs>` query keys
+     * (`tabQueryKey` / `nestedTabQueryKey`) and the `<TranslatedFields>` namespace
+     * (`translationsNamespace`). Grows over time (`page`, `size`, …).
+     */
+    keys?: KeysConfig;
+    /** `<Table>` config — today the server-request query mapping (`table.query`) shared by every table. */
+    table?: TableConfig;
+    /**
+     * `RootLayout` header config, app-wide — the shell top-bar toggles (`theme` / `fullscreen` /
+     * `search` / `breadcrumbs` / `pageTitle`) + the account (`onLogout` / `user`). A `RootLayout`
+     * `header` prop is merged over this (the prop wins), so a specific shell can override.
+     */
+    header?: HeaderConfig;
+}
+interface ThemeContextValue {
+    mode: ThemeMode;
+    setMode: (mode: ThemeMode) => void;
+    toggleMode: () => void;
+    /** The persisted accent-color overrides **per mode** (a hex, or `null` when using that mode's default). */
+    accentColors: Record<ThemeMode, string | null>;
+    /** The configured/default `accent` **per mode** (before any override) — the "no override" values. */
+    defaultAccentColors: Record<ThemeMode, string>;
+    /** Set (or clear with `null`) the accent override for `mode` (defaults to the current) — persists + re-applies. */
+    setAccentColor: (color: string | null, mode?: ThemeMode) => void;
+    locales: LocaleConfig[];
+    /** Resolved translations namespace (`config.keys.translationsNamespace` ?? the built-in default). */
+    translationsNamespace: string;
+    /** Resolved top-level tabs query key (`config.keys.tabQueryKey` ?? the built-in default). */
+    tabQueryKey: string;
+    /** Resolved nested tabs query key (`config.keys.nestedTabQueryKey` ?? the built-in default). */
+    nestedTabQueryKey: string;
+    /** Resolved stepper query key (`config.keys.stepQueryKey` ?? the built-in default). */
+    stepQueryKey: string;
+    /** The `<Table>` server-request query mapping (`config.table.query` ?? `{}`). Defaults applied by `buildTableQuery`. */
+    tableQuery: TableQueryConfig;
+    /** App-wide `RootLayout` header config (`config.header` ?? `{}`); the `RootLayout` prop merges over it. */
+    header: HeaderConfig;
+    /** Whether the shell header sticks to the top on scroll (fixed) vs scrolls away (static). Persisted. */
+    headerSticky: boolean;
+    /** Set + persist the header sticky/static preference (overrides `config.header.sticky`). */
+    setHeaderSticky: (sticky: boolean) => void;
+    /** The active font family (drives `--tz-font-family`). Persisted; seeded from `config.theme.fontFamily`. */
+    fontFamily: string;
+    /** Set + persist the font family (a preset or any Google Font name; loaded on demand). */
+    setFontFamily: (family: string) => void;
+    /** Active UI language code (drives `t`). Persisted; seeded from `config.i18n.language` (default English). */
+    language: string;
+    /** Set + persist the active UI language (must be one of `languages`). */
+    setLanguage: (code: string) => void;
+    /** The UI languages the panel offers (from `config.i18n.languages`, default English only). */
+    languages: LocaleConfig[];
+    /** Translator for the library's built-in strings, bound to the active `language`. */
+    t: Translator;
+    /** Translator for the **app's own** strings (`config.i18n.appMessages`), bound to the active `language`. */
+    appT: AppTranslator;
+}
+/** The default font family (matches the `--tz-font-family` token's primary family). */
+export declare const DEFAULT_FONT_FAMILY = "Inter";
+/** The built-in default URL query param name a **top-level** `<Tabs>` syncs to (no `queryKey`/config). */
+export declare const DEFAULT_TABS_QUERY_KEY = "tab";
+/** The built-in default URL query param name a **nested** `<Tabs>` syncs to (no `queryKey`/config). */
+export declare const DEFAULT_NESTED_TAB_QUERY_KEY = "nestedTab";
+/** The built-in default URL query param name a `<Stepper>` syncs to (no `queryKey`/config). */
+export declare const DEFAULT_STEP_QUERY_KEY = "step";
+export interface ConfigProviderProps {
+    /** App config — theme overrides, initial mode, locales. Omit for the built-in defaults (light mode). */
+    config?: Config;
+    children: ReactNode;
+}
+export declare function ConfigProvider({ config, children }: ConfigProviderProps): import("react/jsx-runtime").JSX.Element;
+export declare function useTheme(): ThemeContextValue;
+/**
+ * The content locales configured on `<ConfigProvider config={{ locales }}>`. Lenient — returns `[]`
+ * outside a provider (locales are optional), so `<TranslatedFields>` can also take a `locales` prop.
+ */
+export declare function useLocales(): LocaleConfig[];
+/**
+ * The translator for the library's built-in UI strings, bound to the active `config.i18n` language.
+ * **Lenient** — outside a provider it returns an English translator, so components render standalone
+ * (and in tests) with their default English labels. Use it for any built-in string:
+ * `t('select.noOptions')`.
+ */
+export declare function useT(): Translator;
+/**
+ * Translator for the **consuming app's own** strings — the catalogs passed to
+ * `<ConfigProvider config={{ i18n: { appMessages } }}>` — bound to the active UI language, so the app's
+ * copy switches together with the panel. Free-form string keys; per key it resolves exact code → base
+ * language → English (`'en'`) → the key itself, with `{name}` interpolation:
+ *
+ * ```tsx
+ * const t = useTranslations()
+ * <PageLayout title={t('customer-transactions.title')} />
+ * <p>{t('customer-transactions.count', { count: 128 })}</p>
+ * ```
+ *
+ * **Lenient** — outside a provider (or with no `appMessages`) it echoes the key back, so it's safe
+ * anywhere. Use `useT()` for the library's built-in strings; use this for your own.
+ */
+export declare function useTranslations(): AppTranslator;
+/**
+ * The active UI language + switcher data: `{ language, setLanguage, languages }`. Lenient outside a
+ * provider (English, single language, no-op setter) so it's safe to call anywhere.
+ */
+export declare function useLanguage(): {
+    language: string;
+    setLanguage: (code: string) => void;
+    languages: LocaleConfig[];
+};
+/**
+ * The translations namespace configured on `<ConfigProvider config={{ keys: { translationsNamespace } }}>`,
+ * resolved against the built-in default (`'translations'`). Lenient outside a provider. Use it to pass
+ * the same namespace to the helpers, e.g. `buildTranslations(codes, fields, useTranslationsNamespace())`.
+ */
+export declare function useTranslationsNamespace(): string;
+/**
+ * The default top-level tabs query key configured on `<ConfigProvider config={{ keys: { tabQueryKey } }}>`,
+ * resolved against the built-in default (`'tab'`). Lenient outside a provider. A top-level `<Tabs>` reads
+ * it as the fallback for an omitted `queryKey`, so every tab strip URL-syncs out of the box.
+ */
+export declare function useTabsQueryKey(): string;
+/**
+ * The default nested tabs query key configured on
+ * `<ConfigProvider config={{ keys: { nestedTabQueryKey } }}>`, resolved against the built-in default
+ * (`'nestedTab'`). Lenient outside a provider. A `<Tabs>` nested inside another tab's panel uses this
+ * (instead of `tabQueryKey`) so the two strips don't collide on the same URL param.
+ */
+export declare function useNestedTabQueryKey(): string;
+/**
+ * The default stepper query key configured on `<ConfigProvider config={{ keys: { stepQueryKey } }}>`,
+ * resolved against the built-in default (`'step'`). Lenient outside a provider. A `<Stepper queryKey>`
+ * (the bare/`true` opt-in form) reads it as the param name; a string `queryKey` overrides it.
+ */
+export declare function useStepQueryKey(): string;
+/**
+ * The `<Table>` server-request query mapping configured on `<ConfigProvider config={{ table: { query } }}>`
+ * (`{}` when unset / outside a provider). `<Table>` merges its own `queryMapping` prop over this, then feeds
+ * the result to `buildTableQuery`, which applies the field defaults — so an unconfigured table emits the
+ * default page-based `?page=…&size=…&search=…&sort=…` shape.
+ */
+export declare function useTableQueryConfig(): TableQueryConfig;
+/**
+ * The app-wide `RootLayout` header config set on `<ConfigProvider config={{ header }}>` (`{}` when
+ * unset / outside a provider). `RootLayout` merges its own `header` prop over this (the prop wins), so
+ * a specific shell can override the app-wide defaults.
+ */
+export declare function useHeaderConfig(): HeaderConfig;
+export {};

package/dist/theme/applyTheme.d.cts

@@ -0,0 +1,28 @@
+export interface ThemePalette {
+    primary: string;
+    /**
+     * A free theme color (near-white by default) selectable via the `color` prop — it is **no longer**
+     * the component surface (elevated panels use `--tz-color-surface`).
+     */
+    secondary: string;
+    /**
+     * The rear-most page background — the `<body>` fill + the shell canvas that the floating panels sit
+     * on; nothing else uses it. Built-in defaults: a soft off-white in light mode, a near-black in dark mode.
+     */
+    background: string;
+    /**
+     * The elevated **panel surface** — cards, sidebar, inputs/forms, dropdowns, modals (the panels that
+     * float over `--tz-color-background`). Built-in defaults: white in light mode, a touch lighter than
+     * the canvas in dark mode. Configurable per mode like any theme color.
+     */
+    surface: string;
+    /** The single accent color — the default tint for controls (`Button`, `IconButton`, …). */
+    accent: string;
+    success: string;
+    error: string;
+    info: string;
+    warning: string;
+}
+/** Names of the theme palette tokens (maps to `--tz-color-<name>`). */
+export type ThemeColor = keyof ThemePalette;
+export declare function applyTheme(theme: Partial<ThemePalette>, target?: HTMLElement): void;

package/dist/theme/applyTheme.d.ts

@@ -0,0 +1,28 @@
+export interface ThemePalette {
+    primary: string;
+    /**
+     * A free theme color (near-white by default) selectable via the `color` prop — it is **no longer**
+     * the component surface (elevated panels use `--tz-color-surface`).
+     */
+    secondary: string;
+    /**
+     * The rear-most page background — the `<body>` fill + the shell canvas that the floating panels sit
+     * on; nothing else uses it. Built-in defaults: a soft off-white in light mode, a near-black in dark mode.
+     */
+    background: string;
+    /**
+     * The elevated **panel surface** — cards, sidebar, inputs/forms, dropdowns, modals (the panels that
+     * float over `--tz-color-background`). Built-in defaults: white in light mode, a touch lighter than
+     * the canvas in dark mode. Configurable per mode like any theme color.
+     */
+    surface: string;
+    /** The single accent color — the default tint for controls (`Button`, `IconButton`, …). */
+    accent: string;
+    success: string;
+    error: string;
+    info: string;
+    warning: string;
+}
+/** Names of the theme palette tokens (maps to `--tz-color-<name>`). */
+export type ThemeColor = keyof ThemePalette;
+export declare function applyTheme(theme: Partial<ThemePalette>, target?: HTMLElement): void;

package/dist/theme/index.d.cts

@@ -0,0 +1,5 @@
+export { applyTheme } from './applyTheme';
+export type { ThemePalette, ThemeColor } from './applyTheme';
+export { ConfigProvider, useTheme, useLocales, useTranslationsNamespace, useTabsQueryKey, useNestedTabQueryKey, useStepQueryKey, useTableQueryConfig, useHeaderConfig, useT, useTranslations, useLanguage, DEFAULT_TABS_QUERY_KEY, DEFAULT_NESTED_TAB_QUERY_KEY, DEFAULT_STEP_QUERY_KEY, DEFAULT_FONT_FAMILY, } from './ConfigProvider';
+export type { Config, ThemeConfig, ThemeColors, ThemeMode, ConfigProviderProps, LocaleConfig, KeysConfig, TableConfig, TableQueryConfig, HeaderConfig, HeaderUser, I18nConfig, } from './ConfigProvider';
+export type { Messages, MessageKey, MessageCatalog, MessageOverrides, Translator, AppMessages, AppTranslator, } from '../i18n/messages';

package/dist/theme/index.d.ts

@@ -0,0 +1,5 @@
+export { applyTheme } from './applyTheme';
+export type { ThemePalette, ThemeColor } from './applyTheme';
+export { ConfigProvider, useTheme, useLocales, useTranslationsNamespace, useTabsQueryKey, useNestedTabQueryKey, useStepQueryKey, useTableQueryConfig, useHeaderConfig, useT, useTranslations, useLanguage, DEFAULT_TABS_QUERY_KEY, DEFAULT_NESTED_TAB_QUERY_KEY, DEFAULT_STEP_QUERY_KEY, DEFAULT_FONT_FAMILY, } from './ConfigProvider';
+export type { Config, ThemeConfig, ThemeColors, ThemeMode, ConfigProviderProps, LocaleConfig, KeysConfig, TableConfig, TableQueryConfig, HeaderConfig, HeaderUser, I18nConfig, } from './ConfigProvider';
+export type { Messages, MessageKey, MessageCatalog, MessageOverrides, Translator, AppMessages, AppTranslator, } from '../i18n/messages';

package/dist/toastStore-B4Tk2Xk7.cjs

@@ -0,0 +1,2 @@
+"use strict";let t=[],T=0;const d=new Set,c=()=>{for(const s of d)s()},m=s=>(d.add(s),()=>{d.delete(s)}),b=()=>t,o=(s,e,n)=>{const a=(n==null?void 0:n.id)??`tz-toast-${++T}`,r=t.findIndex(i=>i.id===a),l={...r>=0?t[r]:void 0,...n,id:a,message:s,color:e,open:!0};return t=r>=0?t.map((i,u)=>u===r?l:i):[...t,l],c(),a},f=s=>{t=t.map(e=>e.id===s?{...e,open:!1}:e),c()},g=s=>{t=t.filter(e=>e.id!==s),c()},v=Object.assign((s,e)=>o(s,"info",e),{success:(s,e)=>o(s,"success",e),error:(s,e)=>o(s,"error",e),warning:(s,e)=>o(s,"warning",e),info:(s,e)=>o(s,"info",e),dismiss:s=>{s==null?(t=t.map(e=>({...e,open:!1})),c()):f(s)}});exports.closeToast=f;exports.getToasts=b;exports.removeToast=g;exports.subscribeToasts=m;exports.toast=v;
+//# sourceMappingURL=toastStore-B4Tk2Xk7.cjs.map

package/dist/toastStore-B4Tk2Xk7.cjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"toastStore-B4Tk2Xk7.cjs","sources":["../src/components/Toast/toastStore.ts"],"sourcesContent":["import type { ReactNode } from 'react'\nimport type { ThemeColor } from '../../theme'\nimport type { IconName } from '../../icons/names'\nimport type { AlertVariant } from '../Alert'\n\n/** Where the `Toaster` stacks toasts. */\nexport type ToastPosition =\n  | 'top-left'\n  | 'top-center'\n  | 'top-right'\n  | 'bottom-left'\n  | 'bottom-center'\n  | 'bottom-right'\n\nexport interface ToastOptions {\n  /** Auto-dismiss delay in ms; `Infinity` keeps it open until dismissed. Defaults to the `Toaster`'s `duration`. */\n  duration?: number\n  /** Alert tint style. Defaults to `contained` (solid fill). */\n  variant?: AlertVariant\n  /** Leading icon — an `IconName`, a node, or `false` to hide it. Defaults to the semantic icon for the color. */\n  icon?: IconName | ReactNode | false\n  /** Trailing action (e.g. an `UNDO` button). */\n  action?: ReactNode\n  /** Explicit id — reuse it to update an existing toast or to target `toast.dismiss(id)`. Auto-generated otherwise. */\n  id?: string\n}\n\n/** A live toast in the store (internal). `open` flips to `false` to drive the exit animation before removal. */\nexport interface ToastRecord extends ToastOptions {\n  id: string\n  message: ReactNode\n  color: ThemeColor\n  open: boolean\n}\n\nlet toasts: ToastRecord[] = []\nlet seq = 0\nconst listeners = new Set<() => void>()\n\nconst emit = () => {\n  for (const listener of listeners) listener()\n}\n\n/** Subscribe to store changes (used by `Toaster` via `useSyncExternalStore`). */\nexport const subscribeToasts = (listener: () => void): (() => void) => {\n  listeners.add(listener)\n  return () => {\n    listeners.delete(listener)\n  }\n}\n\n/** The current toasts — a stable reference between changes (snapshot for `useSyncExternalStore`). */\nexport const getToasts = (): ToastRecord[] => toasts\n\nconst upsert = (message: ReactNode, color: ThemeColor, options?: ToastOptions): string => {\n  const id = options?.id ?? `tz-toast-${++seq}`\n  const index = toasts.findIndex((t) => t.id === id)\n  // on update-by-id, merge over the existing record so fields omitted this call (action, a sticky\n  // duration, …) are preserved rather than silently reset to defaults\n  const prev = index >= 0 ? toasts[index] : undefined\n  const record: ToastRecord = { ...prev, ...options, id, message, color, open: true }\n  toasts = index >= 0 ? toasts.map((t, i) => (i === index ? record : t)) : [...toasts, record]\n  emit()\n  return id\n}\n\n/** Mark a toast as closing — drives its exit animation; the `Toaster` removes it afterwards. */\nexport const closeToast = (id: string): void => {\n  toasts = toasts.map((t) => (t.id === id ? { ...t, open: false } : t))\n  emit()\n}\n\n/** Remove a toast outright (called by the `Toaster` once its exit animation finishes). */\nexport const removeToast = (id: string): void => {\n  toasts = toasts.filter((t) => t.id !== id)\n  emit()\n}\n\n/** Imperative toast API — callable from anywhere (event handlers, async code, outside React). */\nexport interface ToastApi {\n  /** Show a neutral (info) toast. Returns the toast id. */\n  (message: ReactNode, options?: ToastOptions): string\n  success: (message: ReactNode, options?: ToastOptions) => string\n  error: (message: ReactNode, options?: ToastOptions) => string\n  warning: (message: ReactNode, options?: ToastOptions) => string\n  info: (message: ReactNode, options?: ToastOptions) => string\n  /** Dismiss a toast by id, or all toasts when called with no argument. */\n  dismiss: (id?: string) => void\n}\n\nexport const toast: ToastApi = Object.assign(\n  (message: ReactNode, options?: ToastOptions) => upsert(message, 'info', options),\n  {\n    success: (message: ReactNode, options?: ToastOptions) => upsert(message, 'success', options),\n    error: (message: ReactNode, options?: ToastOptions) => upsert(message, 'error', options),\n    warning: (message: ReactNode, options?: ToastOptions) => upsert(message, 'warning', options),\n    info: (message: ReactNode, options?: ToastOptions) => upsert(message, 'info', options),\n    dismiss: (id?: string) => {\n      if (id == null) {\n        toasts = toasts.map((t) => ({ ...t, open: false }))\n        emit()\n      } else {\n        closeToast(id)\n      }\n    },\n  },\n)\n"],"names":["toasts","seq","listeners","emit","listener","subscribeToasts","getToasts","upsert","message","color","options","id","index","t","record","i","closeToast","removeToast","toast"],"mappings":"aAmCA,IAAIA,EAAwB,CAAA,EACxBC,EAAM,EACV,MAAMC,MAAgB,IAEhBC,EAAO,IAAM,CACjB,UAAWC,KAAYF,EAAWE,EAAA,CACpC,EAGaC,EAAmBD,IAC9BF,EAAU,IAAIE,CAAQ,EACf,IAAM,CACXF,EAAU,OAAOE,CAAQ,CAC3B,GAIWE,EAAY,IAAqBN,EAExCO,EAAS,CAACC,EAAoBC,EAAmBC,IAAmC,CACxF,MAAMC,GAAKD,GAAA,YAAAA,EAAS,KAAM,YAAY,EAAET,CAAG,GACrCW,EAAQZ,EAAO,UAAWa,GAAMA,EAAE,KAAOF,CAAE,EAI3CG,EAAsB,CAAE,GADjBF,GAAS,EAAIZ,EAAOY,CAAK,EAAI,OACH,GAAGF,EAAS,GAAAC,EAAI,QAAAH,EAAS,MAAAC,EAAO,KAAM,EAAA,EAC7E,OAAAT,EAASY,GAAS,EAAIZ,EAAO,IAAI,CAACa,EAAGE,IAAOA,IAAMH,EAAQE,EAASD,CAAE,EAAI,CAAC,GAAGb,EAAQc,CAAM,EAC3FX,EAAA,EACOQ,CACT,EAGaK,EAAcL,GAAqB,CAC9CX,EAASA,EAAO,IAAKa,GAAOA,EAAE,KAAOF,EAAK,CAAE,GAAGE,EAAG,KAAM,EAAA,EAAUA,CAAE,EACpEV,EAAA,CACF,EAGac,EAAeN,GAAqB,CAC/CX,EAASA,EAAO,OAAQa,GAAMA,EAAE,KAAOF,CAAE,EACzCR,EAAA,CACF,EAcae,EAAkB,OAAO,OACpC,CAACV,EAAoBE,IAA2BH,EAAOC,EAAS,OAAQE,CAAO,EAC/E,CACE,QAAS,CAACF,EAAoBE,IAA2BH,EAAOC,EAAS,UAAWE,CAAO,EAC3F,MAAO,CAACF,EAAoBE,IAA2BH,EAAOC,EAAS,QAASE,CAAO,EACvF,QAAS,CAACF,EAAoBE,IAA2BH,EAAOC,EAAS,UAAWE,CAAO,EAC3F,KAAM,CAACF,EAAoBE,IAA2BH,EAAOC,EAAS,OAAQE,CAAO,EACrF,QAAUC,GAAgB,CACpBA,GAAM,MACRX,EAASA,EAAO,IAAKa,IAAO,CAAE,GAAGA,EAAG,KAAM,EAAA,EAAQ,EAClDV,EAAA,GAEAa,EAAWL,CAAE,CAEjB,CAAA,CAEJ"}

package/dist/toastStore-Cx_JOKwS.js

@@ -0,0 +1,32 @@
+let t = [], u = 0;
+const d = /* @__PURE__ */ new Set(), c = () => {
+  for (const s of d) s();
+}, p = (s) => (d.add(s), () => {
+  d.delete(s);
+}), v = () => t, n = (s, e, o) => {
+  const a = (o == null ? void 0 : o.id) ?? `tz-toast-${++u}`, r = t.findIndex((i) => i.id === a), l = { ...r >= 0 ? t[r] : void 0, ...o, id: a, message: s, color: e, open: !0 };
+  return t = r >= 0 ? t.map((i, f) => f === r ? l : i) : [...t, l], c(), a;
+}, m = (s) => {
+  t = t.map((e) => e.id === s ? { ...e, open: !1 } : e), c();
+}, T = (s) => {
+  t = t.filter((e) => e.id !== s), c();
+}, b = Object.assign(
+  (s, e) => n(s, "info", e),
+  {
+    success: (s, e) => n(s, "success", e),
+    error: (s, e) => n(s, "error", e),
+    warning: (s, e) => n(s, "warning", e),
+    info: (s, e) => n(s, "info", e),
+    dismiss: (s) => {
+      s == null ? (t = t.map((e) => ({ ...e, open: !1 })), c()) : m(s);
+    }
+  }
+);
+export {
+  m as c,
+  v as g,
+  T as r,
+  p as s,
+  b as t
+};
+//# sourceMappingURL=toastStore-Cx_JOKwS.js.map

package/dist/toastStore-Cx_JOKwS.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"toastStore-Cx_JOKwS.js","sources":["../src/components/Toast/toastStore.ts"],"sourcesContent":["import type { ReactNode } from 'react'\nimport type { ThemeColor } from '../../theme'\nimport type { IconName } from '../../icons/names'\nimport type { AlertVariant } from '../Alert'\n\n/** Where the `Toaster` stacks toasts. */\nexport type ToastPosition =\n  | 'top-left'\n  | 'top-center'\n  | 'top-right'\n  | 'bottom-left'\n  | 'bottom-center'\n  | 'bottom-right'\n\nexport interface ToastOptions {\n  /** Auto-dismiss delay in ms; `Infinity` keeps it open until dismissed. Defaults to the `Toaster`'s `duration`. */\n  duration?: number\n  /** Alert tint style. Defaults to `contained` (solid fill). */\n  variant?: AlertVariant\n  /** Leading icon — an `IconName`, a node, or `false` to hide it. Defaults to the semantic icon for the color. */\n  icon?: IconName | ReactNode | false\n  /** Trailing action (e.g. an `UNDO` button). */\n  action?: ReactNode\n  /** Explicit id — reuse it to update an existing toast or to target `toast.dismiss(id)`. Auto-generated otherwise. */\n  id?: string\n}\n\n/** A live toast in the store (internal). `open` flips to `false` to drive the exit animation before removal. */\nexport interface ToastRecord extends ToastOptions {\n  id: string\n  message: ReactNode\n  color: ThemeColor\n  open: boolean\n}\n\nlet toasts: ToastRecord[] = []\nlet seq = 0\nconst listeners = new Set<() => void>()\n\nconst emit = () => {\n  for (const listener of listeners) listener()\n}\n\n/** Subscribe to store changes (used by `Toaster` via `useSyncExternalStore`). */\nexport const subscribeToasts = (listener: () => void): (() => void) => {\n  listeners.add(listener)\n  return () => {\n    listeners.delete(listener)\n  }\n}\n\n/** The current toasts — a stable reference between changes (snapshot for `useSyncExternalStore`). */\nexport const getToasts = (): ToastRecord[] => toasts\n\nconst upsert = (message: ReactNode, color: ThemeColor, options?: ToastOptions): string => {\n  const id = options?.id ?? `tz-toast-${++seq}`\n  const index = toasts.findIndex((t) => t.id === id)\n  // on update-by-id, merge over the existing record so fields omitted this call (action, a sticky\n  // duration, …) are preserved rather than silently reset to defaults\n  const prev = index >= 0 ? toasts[index] : undefined\n  const record: ToastRecord = { ...prev, ...options, id, message, color, open: true }\n  toasts = index >= 0 ? toasts.map((t, i) => (i === index ? record : t)) : [...toasts, record]\n  emit()\n  return id\n}\n\n/** Mark a toast as closing — drives its exit animation; the `Toaster` removes it afterwards. */\nexport const closeToast = (id: string): void => {\n  toasts = toasts.map((t) => (t.id === id ? { ...t, open: false } : t))\n  emit()\n}\n\n/** Remove a toast outright (called by the `Toaster` once its exit animation finishes). */\nexport const removeToast = (id: string): void => {\n  toasts = toasts.filter((t) => t.id !== id)\n  emit()\n}\n\n/** Imperative toast API — callable from anywhere (event handlers, async code, outside React). */\nexport interface ToastApi {\n  /** Show a neutral (info) toast. Returns the toast id. */\n  (message: ReactNode, options?: ToastOptions): string\n  success: (message: ReactNode, options?: ToastOptions) => string\n  error: (message: ReactNode, options?: ToastOptions) => string\n  warning: (message: ReactNode, options?: ToastOptions) => string\n  info: (message: ReactNode, options?: ToastOptions) => string\n  /** Dismiss a toast by id, or all toasts when called with no argument. */\n  dismiss: (id?: string) => void\n}\n\nexport const toast: ToastApi = Object.assign(\n  (message: ReactNode, options?: ToastOptions) => upsert(message, 'info', options),\n  {\n    success: (message: ReactNode, options?: ToastOptions) => upsert(message, 'success', options),\n    error: (message: ReactNode, options?: ToastOptions) => upsert(message, 'error', options),\n    warning: (message: ReactNode, options?: ToastOptions) => upsert(message, 'warning', options),\n    info: (message: ReactNode, options?: ToastOptions) => upsert(message, 'info', options),\n    dismiss: (id?: string) => {\n      if (id == null) {\n        toasts = toasts.map((t) => ({ ...t, open: false }))\n        emit()\n      } else {\n        closeToast(id)\n      }\n    },\n  },\n)\n"],"names":["toasts","seq","listeners","emit","listener","subscribeToasts","getToasts","upsert","message","color","options","id","index","t","record","i","closeToast","removeToast","toast"],"mappings":"AAmCA,IAAIA,IAAwB,CAAA,GACxBC,IAAM;AACV,MAAMC,wBAAgB,IAAA,GAEhBC,IAAO,MAAM;AACjB,aAAWC,KAAYF,EAAW,CAAAE,EAAA;AACpC,GAGaC,IAAkB,CAACD,OAC9BF,EAAU,IAAIE,CAAQ,GACf,MAAM;AACX,EAAAF,EAAU,OAAOE,CAAQ;AAC3B,IAIWE,IAAY,MAAqBN,GAExCO,IAAS,CAACC,GAAoBC,GAAmBC,MAAmC;AACxF,QAAMC,KAAKD,KAAA,gBAAAA,EAAS,OAAM,YAAY,EAAET,CAAG,IACrCW,IAAQZ,EAAO,UAAU,CAACa,MAAMA,EAAE,OAAOF,CAAE,GAI3CG,IAAsB,EAAE,GADjBF,KAAS,IAAIZ,EAAOY,CAAK,IAAI,QACH,GAAGF,GAAS,IAAAC,GAAI,SAAAH,GAAS,OAAAC,GAAO,MAAM,GAAA;AAC7E,SAAAT,IAASY,KAAS,IAAIZ,EAAO,IAAI,CAACa,GAAGE,MAAOA,MAAMH,IAAQE,IAASD,CAAE,IAAI,CAAC,GAAGb,GAAQc,CAAM,GAC3FX,EAAA,GACOQ;AACT,GAGaK,IAAa,CAACL,MAAqB;AAC9C,EAAAX,IAASA,EAAO,IAAI,CAACa,MAAOA,EAAE,OAAOF,IAAK,EAAE,GAAGE,GAAG,MAAM,GAAA,IAAUA,CAAE,GACpEV,EAAA;AACF,GAGac,IAAc,CAACN,MAAqB;AAC/C,EAAAX,IAASA,EAAO,OAAO,CAACa,MAAMA,EAAE,OAAOF,CAAE,GACzCR,EAAA;AACF,GAcae,IAAkB,OAAO;AAAA,EACpC,CAACV,GAAoBE,MAA2BH,EAAOC,GAAS,QAAQE,CAAO;AAAA,EAC/E;AAAA,IACE,SAAS,CAACF,GAAoBE,MAA2BH,EAAOC,GAAS,WAAWE,CAAO;AAAA,IAC3F,OAAO,CAACF,GAAoBE,MAA2BH,EAAOC,GAAS,SAASE,CAAO;AAAA,IACvF,SAAS,CAACF,GAAoBE,MAA2BH,EAAOC,GAAS,WAAWE,CAAO;AAAA,IAC3F,MAAM,CAACF,GAAoBE,MAA2BH,EAAOC,GAAS,QAAQE,CAAO;AAAA,IACrF,SAAS,CAACC,MAAgB;AACxB,MAAIA,KAAM,QACRX,IAASA,EAAO,IAAI,CAACa,OAAO,EAAE,GAAGA,GAAG,MAAM,GAAA,EAAQ,GAClDV,EAAA,KAEAa,EAAWL,CAAE;AAAA,IAEjB;AAAA,EAAA;AAEJ;"}

package/dist/translations-CXEeeUDL.cjs

@@ -0,0 +1,2 @@
+"use strict";const c="translations",l=(e,r,o=c)=>`${o}[${e}].${r}`;function d(e,r,o=c){const n={};for(const t of e){const s=typeof t=="string"?t:t.code;for(const i of Object.keys(r))n[l(s,i,o)]=r[i]}return n}function b(e,r){const o=`${r}[`;if(!e.startsWith(o))return null;const n=e.indexOf("]",o.length);if(n===-1||e[n+1]!==".")return null;const t=e.slice(o.length,n),s=e.slice(n+2);return t&&s?{locale:t,field:s}:null}function p(e,r=c){var n;const o={};for(const[t,s]of Object.entries(e)){const i=b(t,r);if(i){const f=o[r]??(o[r]={});(f[n=i.locale]??(f[n]={}))[i.field]=s}else o[t]=s}return o}function u(e,r=c){const o={};for(const[n,t]of Object.entries(e))if(n===r&&t&&typeof t=="object"&&!Array.isArray(t)){for(const[s,i]of Object.entries(t))if(i&&typeof i=="object")for(const[f,a]of Object.entries(i))o[l(s,f,r)]=a}else o[n]=t;return o}function T(e){const r=new FormData,o=(n,t)=>{if(t!=null)if(t instanceof Blob)r.append(n,t);else if(t instanceof Date)r.append(n,t.toISOString());else if(Array.isArray(t))t.filter(s=>s!=null).forEach((s,i)=>o(`${n}[${i}]`,s));else if(typeof t=="object"){const s=Object.getPrototypeOf(t);if(s===Object.prototype||s===null)for(const[i,f]of Object.entries(t))o(`${n}[${i}]`,f);else r.append(n,String(t))}else r.append(n,String(t))};for(const[n,t]of Object.entries(e))o(n,t);return r}exports.DEFAULT_TRANSLATIONS_NAMESPACE=c;exports.buildTranslationName=l;exports.buildTranslations=d;exports.flattenTranslations=u;exports.nestTranslations=p;exports.toFormData=T;
+//# sourceMappingURL=translations-CXEeeUDL.cjs.map

package/dist/translations-CXEeeUDL.cjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"translations-CXEeeUDL.cjs","sources":["../src/helpers/translations.ts"],"sourcesContent":["import type { LocaleConfig } from '../theme'\n\n/**\n * Translation form helpers — framework-agnostic glue between `<TranslatedFields>`' **flat** field\n * names (`translations[en-US].title` — the `FormData` shape) and the **nested** JSON shape\n * (`{ translations: { 'en-US': { title } } }`). Public from `sava-test/helpers`.\n */\n\n/** The default top-level namespace for the translation field names + the nested object. */\nexport const DEFAULT_TRANSLATIONS_NAMESPACE = 'translations'\n\n/**\n * Builds a field's form name: `<namespace>[<locale>].<field>` (e.g. `translations[en-US].title`) —\n * the flat, bracketed key that maps cleanly to `FormData`. `namespace` defaults to `'translations'`.\n */\nexport const buildTranslationName = (\n  locale: string,\n  field: string,\n  namespace: string = DEFAULT_TRANSLATIONS_NAMESPACE,\n): string => `${namespace}[${locale}].${field}`\n\n/**\n * Expands a per-field map into the flat, locale-namespaced record `<TranslatedFields>` submits — use\n * it to build a `<Form>`'s `defaultValues` **and** (with Zod field schemas as the values) the schema\n * shape. Pass the same `namespace` you give the component if you changed it.\n *\n * ```ts\n * const locales = ['en-US', 'ka-GE']\n * const fields = { title: '', description: '', shortDescription: '' }\n * const defaultValues = buildTranslations(locales, fields)\n * //   { 'translations[en-US].title': '', …, 'translations[ka-GE].shortDescription': '' }\n * const schema = z.object(\n *   buildTranslations(locales, { title: z.string().min(1), description: z.string(), shortDescription: z.string() }),\n * )\n * ```\n */\nexport function buildTranslations<T>(\n  locales: ReadonlyArray<string | LocaleConfig>,\n  fields: Record<string, T>,\n  namespace: string = DEFAULT_TRANSLATIONS_NAMESPACE,\n): Record<string, T> {\n  const out: Record<string, T> = {}\n  for (const loc of locales) {\n    const code = typeof loc === 'string' ? loc : loc.code\n    for (const field of Object.keys(fields)) {\n      out[buildTranslationName(code, field, namespace)] = fields[field]\n    }\n  }\n  return out\n}\n\n/** Parse a flat translation key (`<namespace>[<locale>].<field>`) → `{ locale, field }`, or `null`. */\nfunction parseTranslationKey(\n  key: string,\n  namespace: string,\n): { locale: string; field: string } | null {\n  const open = `${namespace}[`\n  if (!key.startsWith(open)) return null\n  const close = key.indexOf(']', open.length)\n  if (close === -1 || key[close + 1] !== '.') return null\n  const locale = key.slice(open.length, close)\n  const field = key.slice(close + 2)\n  return locale && field ? { locale, field } : null\n}\n\n/**\n * Flat form values → the **nested** JSON shape. Translation keys (`translations[en-US].title`) fold\n * into `{ [namespace]: { [locale]: { [field]: value } } }`; every other key stays top-level. Use it at\n * the submit boundary when you POST JSON (rather than `FormData`):\n *\n * ```ts\n * await api.post('/news', nestTranslations(form.values))\n * //   { email: 1, translations: { 'en-US': { title: '…' }, 'ka-GE': { title: '…' } } }\n * ```\n */\nexport function nestTranslations(\n  flat: Record<string, unknown>,\n  namespace: string = DEFAULT_TRANSLATIONS_NAMESPACE,\n): Record<string, unknown> {\n  const out: Record<string, unknown> = {}\n  for (const [key, value] of Object.entries(flat)) {\n    const parsed = parseTranslationKey(key, namespace)\n    if (parsed) {\n      const bucket = (out[namespace] ??= {}) as Record<string, Record<string, unknown>>\n      ;(bucket[parsed.locale] ??= {})[parsed.field] = value\n    } else {\n      out[key] = value\n    }\n  }\n  return out\n}\n\n/**\n * The inverse of `nestTranslations`: a **nested** object (e.g. a backend response) → the flat values a\n * `<Form>` / `<TranslatedFields>` expects. Feed the result as `defaultValues` (or into `reset`):\n *\n * ```ts\n * const form = useForm({ schema, defaultValues: flattenTranslations(response) })\n * //   { email: 1, 'translations[en-US].title': '…', 'translations[ka-GE].title': '…' }\n * ```\n */\nexport function flattenTranslations(\n  nested: Record<string, unknown>,\n  namespace: string = DEFAULT_TRANSLATIONS_NAMESPACE,\n): Record<string, unknown> {\n  const out: Record<string, unknown> = {}\n  for (const [key, value] of Object.entries(nested)) {\n    if (key === namespace && value && typeof value === 'object' && !Array.isArray(value)) {\n      for (const [locale, fields] of Object.entries(value as Record<string, unknown>)) {\n        if (fields && typeof fields === 'object') {\n          for (const [field, v] of Object.entries(fields as Record<string, unknown>)) {\n            out[buildTranslationName(locale, field, namespace)] = v\n          }\n        }\n      }\n    } else {\n      out[key] = value\n    }\n  }\n  return out\n}\n\n/**\n * Serialize flat form values into a `FormData` for a `multipart/form-data` POST. The flat translation\n * keys map straight through (`translations[en-US].title`); arrays become indexed keys (`tags[0]`,\n * `tags[1]`) with nullish items skipped so indices stay contiguous; `Blob`/`File` values are appended\n * as-is; a `Date` becomes an ISO string; only **plain** objects recurse (a class instance like a dayjs\n * object is stringified, not exploded into `$d`/`$y` keys); `null`/`undefined` are skipped; everything\n * else is stringified.\n *\n * ```ts\n * await fetch('/news', { method: 'POST', body: toFormData(form.values) })\n * ```\n */\nexport function toFormData(values: Record<string, unknown>): FormData {\n  const fd = new FormData()\n  const append = (key: string, value: unknown): void => {\n    if (value === null || value === undefined) return\n    if (value instanceof Blob) {\n      fd.append(key, value)\n    } else if (value instanceof Date) {\n      fd.append(key, value.toISOString())\n    } else if (Array.isArray(value)) {\n      // drop nullish items so indices stay contiguous (gapped indices break strict parsers)\n      value\n        .filter((item) => item != null)\n        .forEach((item, index) => append(`${key}[${index}]`, item))\n    } else if (typeof value === 'object') {\n      const proto = Object.getPrototypeOf(value)\n      if (proto === Object.prototype || proto === null) {\n        for (const [k, v] of Object.entries(value as Record<string, unknown>))\n          append(`${key}[${k}]`, v)\n      } else {\n        fd.append(key, String(value)) // class instance (Date handled above) → stringify, don't explode keys\n      }\n    } else {\n      fd.append(key, String(value))\n    }\n  }\n  for (const [key, value] of Object.entries(values)) append(key, value)\n  return fd\n}\n"],"names":["DEFAULT_TRANSLATIONS_NAMESPACE","buildTranslationName","locale","field","namespace","buildTranslations","locales","fields","out","loc","code","parseTranslationKey","key","open","close","nestTranslations","flat","value","parsed","bucket","_a","flattenTranslations","nested","v","toFormData","values","fd","append","item","index","proto","k"],"mappings":"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"}

package/dist/translations-D15tFHM1.js

@@ -0,0 +1,74 @@
+const c = "translations", l = (r, s, n = c) => `${n}[${r}].${s}`;
+function p(r, s, n = c) {
+  const o = {};
+  for (const t of r) {
+    const e = typeof t == "string" ? t : t.code;
+    for (const f of Object.keys(s))
+      o[l(e, f, n)] = s[f];
+  }
+  return o;
+}
+function d(r, s) {
+  const n = `${s}[`;
+  if (!r.startsWith(n)) return null;
+  const o = r.indexOf("]", n.length);
+  if (o === -1 || r[o + 1] !== ".") return null;
+  const t = r.slice(n.length, o), e = r.slice(o + 2);
+  return t && e ? { locale: t, field: e } : null;
+}
+function b(r, s = c) {
+  var o;
+  const n = {};
+  for (const [t, e] of Object.entries(r)) {
+    const f = d(t, s);
+    if (f) {
+      const i = n[s] ?? (n[s] = {});
+      (i[o = f.locale] ?? (i[o] = {}))[f.field] = e;
+    } else
+      n[t] = e;
+  }
+  return n;
+}
+function O(r, s = c) {
+  const n = {};
+  for (const [o, t] of Object.entries(r))
+    if (o === s && t && typeof t == "object" && !Array.isArray(t)) {
+      for (const [e, f] of Object.entries(t))
+        if (f && typeof f == "object")
+          for (const [i, a] of Object.entries(f))
+            n[l(e, i, s)] = a;
+    } else
+      n[o] = t;
+  return n;
+}
+function j(r) {
+  const s = new FormData(), n = (o, t) => {
+    if (t != null)
+      if (t instanceof Blob)
+        s.append(o, t);
+      else if (t instanceof Date)
+        s.append(o, t.toISOString());
+      else if (Array.isArray(t))
+        t.filter((e) => e != null).forEach((e, f) => n(`${o}[${f}]`, e));
+      else if (typeof t == "object") {
+        const e = Object.getPrototypeOf(t);
+        if (e === Object.prototype || e === null)
+          for (const [f, i] of Object.entries(t))
+            n(`${o}[${f}]`, i);
+        else
+          s.append(o, String(t));
+      } else
+        s.append(o, String(t));
+  };
+  for (const [o, t] of Object.entries(r)) n(o, t);
+  return s;
+}
+export {
+  c as D,
+  p as a,
+  l as b,
+  O as f,
+  b as n,
+  j as t
+};
+//# sourceMappingURL=translations-D15tFHM1.js.map

package/dist/translations-D15tFHM1.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"translations-D15tFHM1.js","sources":["../src/helpers/translations.ts"],"sourcesContent":["import type { LocaleConfig } from '../theme'\n\n/**\n * Translation form helpers — framework-agnostic glue between `<TranslatedFields>`' **flat** field\n * names (`translations[en-US].title` — the `FormData` shape) and the **nested** JSON shape\n * (`{ translations: { 'en-US': { title } } }`). Public from `sava-test/helpers`.\n */\n\n/** The default top-level namespace for the translation field names + the nested object. */\nexport const DEFAULT_TRANSLATIONS_NAMESPACE = 'translations'\n\n/**\n * Builds a field's form name: `<namespace>[<locale>].<field>` (e.g. `translations[en-US].title`) —\n * the flat, bracketed key that maps cleanly to `FormData`. `namespace` defaults to `'translations'`.\n */\nexport const buildTranslationName = (\n  locale: string,\n  field: string,\n  namespace: string = DEFAULT_TRANSLATIONS_NAMESPACE,\n): string => `${namespace}[${locale}].${field}`\n\n/**\n * Expands a per-field map into the flat, locale-namespaced record `<TranslatedFields>` submits — use\n * it to build a `<Form>`'s `defaultValues` **and** (with Zod field schemas as the values) the schema\n * shape. Pass the same `namespace` you give the component if you changed it.\n *\n * ```ts\n * const locales = ['en-US', 'ka-GE']\n * const fields = { title: '', description: '', shortDescription: '' }\n * const defaultValues = buildTranslations(locales, fields)\n * //   { 'translations[en-US].title': '', …, 'translations[ka-GE].shortDescription': '' }\n * const schema = z.object(\n *   buildTranslations(locales, { title: z.string().min(1), description: z.string(), shortDescription: z.string() }),\n * )\n * ```\n */\nexport function buildTranslations<T>(\n  locales: ReadonlyArray<string | LocaleConfig>,\n  fields: Record<string, T>,\n  namespace: string = DEFAULT_TRANSLATIONS_NAMESPACE,\n): Record<string, T> {\n  const out: Record<string, T> = {}\n  for (const loc of locales) {\n    const code = typeof loc === 'string' ? loc : loc.code\n    for (const field of Object.keys(fields)) {\n      out[buildTranslationName(code, field, namespace)] = fields[field]\n    }\n  }\n  return out\n}\n\n/** Parse a flat translation key (`<namespace>[<locale>].<field>`) → `{ locale, field }`, or `null`. */\nfunction parseTranslationKey(\n  key: string,\n  namespace: string,\n): { locale: string; field: string } | null {\n  const open = `${namespace}[`\n  if (!key.startsWith(open)) return null\n  const close = key.indexOf(']', open.length)\n  if (close === -1 || key[close + 1] !== '.') return null\n  const locale = key.slice(open.length, close)\n  const field = key.slice(close + 2)\n  return locale && field ? { locale, field } : null\n}\n\n/**\n * Flat form values → the **nested** JSON shape. Translation keys (`translations[en-US].title`) fold\n * into `{ [namespace]: { [locale]: { [field]: value } } }`; every other key stays top-level. Use it at\n * the submit boundary when you POST JSON (rather than `FormData`):\n *\n * ```ts\n * await api.post('/news', nestTranslations(form.values))\n * //   { email: 1, translations: { 'en-US': { title: '…' }, 'ka-GE': { title: '…' } } }\n * ```\n */\nexport function nestTranslations(\n  flat: Record<string, unknown>,\n  namespace: string = DEFAULT_TRANSLATIONS_NAMESPACE,\n): Record<string, unknown> {\n  const out: Record<string, unknown> = {}\n  for (const [key, value] of Object.entries(flat)) {\n    const parsed = parseTranslationKey(key, namespace)\n    if (parsed) {\n      const bucket = (out[namespace] ??= {}) as Record<string, Record<string, unknown>>\n      ;(bucket[parsed.locale] ??= {})[parsed.field] = value\n    } else {\n      out[key] = value\n    }\n  }\n  return out\n}\n\n/**\n * The inverse of `nestTranslations`: a **nested** object (e.g. a backend response) → the flat values a\n * `<Form>` / `<TranslatedFields>` expects. Feed the result as `defaultValues` (or into `reset`):\n *\n * ```ts\n * const form = useForm({ schema, defaultValues: flattenTranslations(response) })\n * //   { email: 1, 'translations[en-US].title': '…', 'translations[ka-GE].title': '…' }\n * ```\n */\nexport function flattenTranslations(\n  nested: Record<string, unknown>,\n  namespace: string = DEFAULT_TRANSLATIONS_NAMESPACE,\n): Record<string, unknown> {\n  const out: Record<string, unknown> = {}\n  for (const [key, value] of Object.entries(nested)) {\n    if (key === namespace && value && typeof value === 'object' && !Array.isArray(value)) {\n      for (const [locale, fields] of Object.entries(value as Record<string, unknown>)) {\n        if (fields && typeof fields === 'object') {\n          for (const [field, v] of Object.entries(fields as Record<string, unknown>)) {\n            out[buildTranslationName(locale, field, namespace)] = v\n          }\n        }\n      }\n    } else {\n      out[key] = value\n    }\n  }\n  return out\n}\n\n/**\n * Serialize flat form values into a `FormData` for a `multipart/form-data` POST. The flat translation\n * keys map straight through (`translations[en-US].title`); arrays become indexed keys (`tags[0]`,\n * `tags[1]`) with nullish items skipped so indices stay contiguous; `Blob`/`File` values are appended\n * as-is; a `Date` becomes an ISO string; only **plain** objects recurse (a class instance like a dayjs\n * object is stringified, not exploded into `$d`/`$y` keys); `null`/`undefined` are skipped; everything\n * else is stringified.\n *\n * ```ts\n * await fetch('/news', { method: 'POST', body: toFormData(form.values) })\n * ```\n */\nexport function toFormData(values: Record<string, unknown>): FormData {\n  const fd = new FormData()\n  const append = (key: string, value: unknown): void => {\n    if (value === null || value === undefined) return\n    if (value instanceof Blob) {\n      fd.append(key, value)\n    } else if (value instanceof Date) {\n      fd.append(key, value.toISOString())\n    } else if (Array.isArray(value)) {\n      // drop nullish items so indices stay contiguous (gapped indices break strict parsers)\n      value\n        .filter((item) => item != null)\n        .forEach((item, index) => append(`${key}[${index}]`, item))\n    } else if (typeof value === 'object') {\n      const proto = Object.getPrototypeOf(value)\n      if (proto === Object.prototype || proto === null) {\n        for (const [k, v] of Object.entries(value as Record<string, unknown>))\n          append(`${key}[${k}]`, v)\n      } else {\n        fd.append(key, String(value)) // class instance (Date handled above) → stringify, don't explode keys\n      }\n    } else {\n      fd.append(key, String(value))\n    }\n  }\n  for (const [key, value] of Object.entries(values)) append(key, value)\n  return fd\n}\n"],"names":["DEFAULT_TRANSLATIONS_NAMESPACE","buildTranslationName","locale","field","namespace","buildTranslations","locales","fields","out","loc","code","parseTranslationKey","key","open","close","nestTranslations","flat","_a","value","parsed","bucket","flattenTranslations","nested","v","toFormData","values","fd","append","item","index","proto","k"],"mappings":"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"}