@techzyapp/ui-library 1.0.0

package/dist/form/useForm.d.ts

@@ -0,0 +1,81 @@
+import { type ChangeEvent, type Dispatch, type FocusEvent, type SetStateAction, type SyntheticEvent } from 'react';
+import type { TypeOf, ZodType } from 'zod';
+/**
+ * When validation errors start showing for a field:
+ * - `blurThenLive` (default) — after the field is blurred (or the form is submitted), then live on every change.
+ * - `change` — from the very first keystroke.
+ * - `submit` — only after a submit attempt.
+ */
+export type FormValidationMode = 'blurThenLive' | 'change' | 'submit';
+export interface UseFormOptions<S extends ZodType> {
+    /** Zod schema describing the whole form. Field names match the schema's top-level keys. */
+    schema: S;
+    /** Initial values — the controlled source of truth for every field. */
+    defaultValues: TypeOf<S>;
+    /**
+     * Called with the parsed (schema-validated) values when a submit passes validation. The second
+     * argument carries helpers — e.g. `reset` to clear the form on success: `(values, { reset }) => {…}`.
+     */
+    onSubmit?: (values: TypeOf<S>, helpers: FormHelpers<TypeOf<S>>) => void | Promise<void>;
+    /** When errors begin to show per field. Defaults to `blurThenLive`. */
+    mode?: FormValidationMode;
+    /**
+     * On a failed submit, smooth-scroll to (and focus) the first invalid field — the one that sits
+     * **highest** on the page. Needs the submit event's form element (works with `<Form>` or any
+     * `<form onSubmit={form.handleSubmit}>`). Defaults to `true`.
+     */
+    scrollToError?: boolean;
+}
+/** Helpers handed to `onSubmit` (Formik-style), so you can clear or tweak the form on success. */
+export interface FormHelpers<Values> {
+    /** Reset to `defaultValues` (or the given values), clearing touched/submitted state. */
+    reset: (next?: Values) => void;
+    /** Set one field's value. */
+    setValue: <K extends keyof Values & string>(name: K, value: Values[K]) => void;
+    /** Replace all values. */
+    setValues: Dispatch<SetStateAction<Values>>;
+}
+/** Props returned by `field(name)` — spread directly onto a `<TextField />`. */
+export interface FieldProps {
+    name: string;
+    value: string;
+    onChange: (event: ChangeEvent<HTMLInputElement>) => void;
+    onBlur: (event: FocusEvent<HTMLInputElement>) => void;
+    error: boolean;
+    helperText?: string;
+}
+/** Everything `useForm` returns — also the value carried by `<Form>`'s context. */
+export interface FormApi<Values> {
+    /** Current form values. */
+    values: Values;
+    /** `{ field: firstErrorMessage }` for every invalid field (regardless of visibility). */
+    errors: Record<string, string>;
+    /** Which fields have been blurred. */
+    touched: Record<string, boolean>;
+    /** True when the whole form passes the schema. */
+    isValid: boolean;
+    /** True once a submit has been attempted. */
+    isSubmitted: boolean;
+    /** Number of submit attempts (increments on every `handleSubmit`) — watch it to react to each submit. */
+    submitCount: number;
+    /** True while an async `onSubmit` is in flight. */
+    isSubmitting: boolean;
+    /** Spread onto a `<TextField />` (or let `<Form>` + a `name` prop wire it for you). */
+    field: (name: keyof Values & string) => FieldProps;
+    /** Imperatively set one field's value. */
+    setValue: <K extends keyof Values & string>(name: K, value: Values[K]) => void;
+    /** Replace all values. */
+    setValues: Dispatch<SetStateAction<Values>>;
+    /** Reset to `defaultValues` (or the given values) and clear touched/submitted state. */
+    reset: (next?: Values) => void;
+    /** Form `onSubmit` handler — validates, then calls `onSubmit` with parsed values when valid. */
+    handleSubmit: (event?: SyntheticEvent) => void;
+}
+/**
+ * A tiny, Zod-powered form helper — the dependency-light alternative to bundling Formik in
+ * every app. Give it a schema and initial values; spread `field(name)` onto a `<TextField />`
+ * and it wires up `value`/`onChange`/`onBlur` and surfaces the field's validation error as
+ * `error` + `helperText`. Validation follows `mode` (default: validate on blur, then live).
+ * `handleSubmit` validates the whole form and calls `onSubmit` with the parsed values only when valid.
+ */
+export declare function useForm<S extends ZodType>({ schema, defaultValues, onSubmit, mode, scrollToError, }: UseFormOptions<S>): FormApi<TypeOf<S>>;

package/dist/formContext-B7ln1Miy.js

@@ -0,0 +1,10 @@
+import { useContext as t, createContext as o } from "react";
+const e = o(null);
+function r() {
+  return t(e);
+}
+export {
+  e as F,
+  r as u
+};
+//# sourceMappingURL=formContext-B7ln1Miy.js.map

package/dist/formContext-B7ln1Miy.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"formContext-B7ln1Miy.js","sources":["../src/form/formContext.ts"],"sourcesContent":["import { createContext, useContext } from 'react'\nimport type { FormApi } from './useForm'\n\n/** The nearest `<Form>`'s form instance, or `null` when not inside one. */\nexport const FormContext = createContext<FormApi<Record<string, unknown>> | null>(null)\n\n/**\n * Reads the surrounding `<Form>`'s form instance (or `null`). Components like `TextField` use this\n * to auto-bind by `name` — you rarely call it directly.\n */\nexport function useFormContext(): FormApi<Record<string, unknown>> | null {\n  return useContext(FormContext)\n}\n"],"names":["FormContext","createContext","useFormContext","useContext"],"mappings":";AAIO,MAAMA,IAAcC,EAAuD,IAAI;AAM/E,SAASC,IAA0D;AACxE,SAAOC,EAAWH,CAAW;AAC/B;"}

package/dist/formContext-bTWrqdEV.cjs

@@ -0,0 +1,2 @@
+"use strict";const t=require("react"),e=t.createContext(null);function o(){return t.useContext(e)}exports.FormContext=e;exports.useFormContext=o;
+//# sourceMappingURL=formContext-bTWrqdEV.cjs.map

package/dist/formContext-bTWrqdEV.cjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"formContext-bTWrqdEV.cjs","sources":["../src/form/formContext.ts"],"sourcesContent":["import { createContext, useContext } from 'react'\nimport type { FormApi } from './useForm'\n\n/** The nearest `<Form>`'s form instance, or `null` when not inside one. */\nexport const FormContext = createContext<FormApi<Record<string, unknown>> | null>(null)\n\n/**\n * Reads the surrounding `<Form>`'s form instance (or `null`). Components like `TextField` use this\n * to auto-bind by `name` — you rarely call it directly.\n */\nexport function useFormContext(): FormApi<Record<string, unknown>> | null {\n  return useContext(FormContext)\n}\n"],"names":["FormContext","createContext","useFormContext","useContext"],"mappings":"sCAIaA,EAAcC,EAAAA,cAAuD,IAAI,EAM/E,SAASC,GAA0D,CACxE,OAAOC,EAAAA,WAAWH,CAAW,CAC/B"}

package/dist/helpers/access.d.cts

@@ -0,0 +1,11 @@
+/** Set the current user's accessKeys (call after login / getUser; pass `[]` on logout). */
+export declare function setAccessKeys(next: string[]): void;
+/** The current user's accessKeys (non-reactive read; safe outside React). */
+export declare function getAccessKeys(): string[];
+/**
+ * OR semantics: a route with no `roles` (omitted/empty) is public; otherwise the user needs at
+ * least one matching key. Works outside React — used by route `beforeLoad` guards.
+ */
+export declare function hasAccess(roles?: string[]): boolean;
+/** Reactive read for components — re-renders the subscriber when the keys change (login/logout). */
+export declare function useAccessKeys(): string[];

package/dist/helpers/access.d.ts

@@ -0,0 +1,11 @@
+/** Set the current user's accessKeys (call after login / getUser; pass `[]` on logout). */
+export declare function setAccessKeys(next: string[]): void;
+/** The current user's accessKeys (non-reactive read; safe outside React). */
+export declare function getAccessKeys(): string[];
+/**
+ * OR semantics: a route with no `roles` (omitted/empty) is public; otherwise the user needs at
+ * least one matching key. Works outside React — used by route `beforeLoad` guards.
+ */
+export declare function hasAccess(roles?: string[]): boolean;
+/** Reactive read for components — re-renders the subscriber when the keys change (login/logout). */
+export declare function useAccessKeys(): string[];

package/dist/helpers/table.d.cts

@@ -0,0 +1,41 @@
+import type { TableQueryConfig } from '../theme';
+/** The `<Table>` state a server request is built from — a structural subset of `TableChangeState`. */
+export interface TableQueryState {
+    /** 1-based page number. */
+    page: number;
+    /** Rows per page (the "All" choice is a sentinel larger than any real dataset). */
+    size: number;
+    /** Current search query (empty string when none). */
+    search: string;
+    /** Active sort, or `null`. */
+    sort: {
+        key: string;
+        direction: 'asc' | 'desc';
+    } | null;
+}
+/**
+ * Build the server-request params for a table's `{ page, size, search, sort }` state, applying a
+ * `TableQueryConfig` mapping (defaults reproduce `?page=1&size=10&search=…&sort=-key`):
+ * - **pagination** — `'page'` emits the 1-based page; `'offset'` emits `(page - 1) * size` under the
+ *   `pageParam` name (e.g. `skip`).
+ * - **size** — the page size. When the **"All"** sentinel is active there's no meaningful page, so the
+ *   **page/offset param is dropped entirely** and only the size param is emitted — and only when
+ *   `allValue` is set (e.g. `limit=0` = all); with no `allValue`, "All" emits no page and no size.
+ * - **search** — omitted when empty.
+ * - **sort** — `'field'` emits a single `-`-prefixed param (`sort=-price`); `'separate'` emits the key in
+ *   `sortParam` + the direction (`ascValue`/`descValue`) in `sortOrderParam` (`sortBy=price&order=desc`);
+ *   `'suffix'` appends the direction value to the key in one param (`sort=priceAsc` / `sort=priceDesc`).
+ */
+export declare function buildTableQuery(state: TableQueryState, mapping?: TableQueryConfig): URLSearchParams;
+/**
+ * Read a `{ page, size, search, sort }` state back out of URL / request params — the **inverse of
+ * `buildTableQuery`** for the same `mapping`. `page` / `size` are `null` when absent (the caller falls back
+ * to its defaults). Used by `<Table>` to restore its URL-synced state on mount / Back-Forward, so the
+ * address bar and the request share one shape.
+ */
+export declare function parseTableQuery(params: URLSearchParams, mapping?: TableQueryConfig): {
+    page: number | null;
+    size: number | null;
+    search: string;
+    sort: TableQueryState['sort'];
+};

package/dist/helpers/table.d.ts

@@ -0,0 +1,41 @@
+import type { TableQueryConfig } from '../theme';
+/** The `<Table>` state a server request is built from — a structural subset of `TableChangeState`. */
+export interface TableQueryState {
+    /** 1-based page number. */
+    page: number;
+    /** Rows per page (the "All" choice is a sentinel larger than any real dataset). */
+    size: number;
+    /** Current search query (empty string when none). */
+    search: string;
+    /** Active sort, or `null`. */
+    sort: {
+        key: string;
+        direction: 'asc' | 'desc';
+    } | null;
+}
+/**
+ * Build the server-request params for a table's `{ page, size, search, sort }` state, applying a
+ * `TableQueryConfig` mapping (defaults reproduce `?page=1&size=10&search=…&sort=-key`):
+ * - **pagination** — `'page'` emits the 1-based page; `'offset'` emits `(page - 1) * size` under the
+ *   `pageParam` name (e.g. `skip`).
+ * - **size** — the page size. When the **"All"** sentinel is active there's no meaningful page, so the
+ *   **page/offset param is dropped entirely** and only the size param is emitted — and only when
+ *   `allValue` is set (e.g. `limit=0` = all); with no `allValue`, "All" emits no page and no size.
+ * - **search** — omitted when empty.
+ * - **sort** — `'field'` emits a single `-`-prefixed param (`sort=-price`); `'separate'` emits the key in
+ *   `sortParam` + the direction (`ascValue`/`descValue`) in `sortOrderParam` (`sortBy=price&order=desc`);
+ *   `'suffix'` appends the direction value to the key in one param (`sort=priceAsc` / `sort=priceDesc`).
+ */
+export declare function buildTableQuery(state: TableQueryState, mapping?: TableQueryConfig): URLSearchParams;
+/**
+ * Read a `{ page, size, search, sort }` state back out of URL / request params — the **inverse of
+ * `buildTableQuery`** for the same `mapping`. `page` / `size` are `null` when absent (the caller falls back
+ * to its defaults). Used by `<Table>` to restore its URL-synced state on mount / Back-Forward, so the
+ * address bar and the request share one shape.
+ */
+export declare function parseTableQuery(params: URLSearchParams, mapping?: TableQueryConfig): {
+    page: number | null;
+    size: number | null;
+    search: string;
+    sort: TableQueryState['sort'];
+};

package/dist/helpers/translations.d.cts

@@ -0,0 +1,63 @@
+import type { LocaleConfig } from '../theme';
+/**
+ * Translation form helpers — framework-agnostic glue between `<TranslatedFields>`' **flat** field
+ * names (`translations[en-US].title` — the `FormData` shape) and the **nested** JSON shape
+ * (`{ translations: { 'en-US': { title } } }`). Public from `sava-test/helpers`.
+ */
+/** The default top-level namespace for the translation field names + the nested object. */
+export declare const DEFAULT_TRANSLATIONS_NAMESPACE = "translations";
+/**
+ * Builds a field's form name: `<namespace>[<locale>].<field>` (e.g. `translations[en-US].title`) —
+ * the flat, bracketed key that maps cleanly to `FormData`. `namespace` defaults to `'translations'`.
+ */
+export declare const buildTranslationName: (locale: string, field: string, namespace?: string) => string;
+/**
+ * Expands a per-field map into the flat, locale-namespaced record `<TranslatedFields>` submits — use
+ * it to build a `<Form>`'s `defaultValues` **and** (with Zod field schemas as the values) the schema
+ * shape. Pass the same `namespace` you give the component if you changed it.
+ *
+ * ```ts
+ * const locales = ['en-US', 'ka-GE']
+ * const fields = { title: '', description: '', shortDescription: '' }
+ * const defaultValues = buildTranslations(locales, fields)
+ * //   { 'translations[en-US].title': '', …, 'translations[ka-GE].shortDescription': '' }
+ * const schema = z.object(
+ *   buildTranslations(locales, { title: z.string().min(1), description: z.string(), shortDescription: z.string() }),
+ * )
+ * ```
+ */
+export declare function buildTranslations<T>(locales: ReadonlyArray<string | LocaleConfig>, fields: Record<string, T>, namespace?: string): Record<string, T>;
+/**
+ * Flat form values → the **nested** JSON shape. Translation keys (`translations[en-US].title`) fold
+ * into `{ [namespace]: { [locale]: { [field]: value } } }`; every other key stays top-level. Use it at
+ * the submit boundary when you POST JSON (rather than `FormData`):
+ *
+ * ```ts
+ * await api.post('/news', nestTranslations(form.values))
+ * //   { email: 1, translations: { 'en-US': { title: '…' }, 'ka-GE': { title: '…' } } }
+ * ```
+ */
+export declare function nestTranslations(flat: Record<string, unknown>, namespace?: string): Record<string, unknown>;
+/**
+ * The inverse of `nestTranslations`: a **nested** object (e.g. a backend response) → the flat values a
+ * `<Form>` / `<TranslatedFields>` expects. Feed the result as `defaultValues` (or into `reset`):
+ *
+ * ```ts
+ * const form = useForm({ schema, defaultValues: flattenTranslations(response) })
+ * //   { email: 1, 'translations[en-US].title': '…', 'translations[ka-GE].title': '…' }
+ * ```
+ */
+export declare function flattenTranslations(nested: Record<string, unknown>, namespace?: string): Record<string, unknown>;
+/**
+ * Serialize flat form values into a `FormData` for a `multipart/form-data` POST. The flat translation
+ * keys map straight through (`translations[en-US].title`); arrays become indexed keys (`tags[0]`,
+ * `tags[1]`) with nullish items skipped so indices stay contiguous; `Blob`/`File` values are appended
+ * as-is; a `Date` becomes an ISO string; only **plain** objects recurse (a class instance like a dayjs
+ * object is stringified, not exploded into `$d`/`$y` keys); `null`/`undefined` are skipped; everything
+ * else is stringified.
+ *
+ * ```ts
+ * await fetch('/news', { method: 'POST', body: toFormData(form.values) })
+ * ```
+ */
+export declare function toFormData(values: Record<string, unknown>): FormData;

package/dist/helpers/translations.d.ts

@@ -0,0 +1,63 @@
+import type { LocaleConfig } from '../theme';
+/**
+ * Translation form helpers — framework-agnostic glue between `<TranslatedFields>`' **flat** field
+ * names (`translations[en-US].title` — the `FormData` shape) and the **nested** JSON shape
+ * (`{ translations: { 'en-US': { title } } }`). Public from `sava-test/helpers`.
+ */
+/** The default top-level namespace for the translation field names + the nested object. */
+export declare const DEFAULT_TRANSLATIONS_NAMESPACE = "translations";
+/**
+ * Builds a field's form name: `<namespace>[<locale>].<field>` (e.g. `translations[en-US].title`) —
+ * the flat, bracketed key that maps cleanly to `FormData`. `namespace` defaults to `'translations'`.
+ */
+export declare const buildTranslationName: (locale: string, field: string, namespace?: string) => string;
+/**
+ * Expands a per-field map into the flat, locale-namespaced record `<TranslatedFields>` submits — use
+ * it to build a `<Form>`'s `defaultValues` **and** (with Zod field schemas as the values) the schema
+ * shape. Pass the same `namespace` you give the component if you changed it.
+ *
+ * ```ts
+ * const locales = ['en-US', 'ka-GE']
+ * const fields = { title: '', description: '', shortDescription: '' }
+ * const defaultValues = buildTranslations(locales, fields)
+ * //   { 'translations[en-US].title': '', …, 'translations[ka-GE].shortDescription': '' }
+ * const schema = z.object(
+ *   buildTranslations(locales, { title: z.string().min(1), description: z.string(), shortDescription: z.string() }),
+ * )
+ * ```
+ */
+export declare function buildTranslations<T>(locales: ReadonlyArray<string | LocaleConfig>, fields: Record<string, T>, namespace?: string): Record<string, T>;
+/**
+ * Flat form values → the **nested** JSON shape. Translation keys (`translations[en-US].title`) fold
+ * into `{ [namespace]: { [locale]: { [field]: value } } }`; every other key stays top-level. Use it at
+ * the submit boundary when you POST JSON (rather than `FormData`):
+ *
+ * ```ts
+ * await api.post('/news', nestTranslations(form.values))
+ * //   { email: 1, translations: { 'en-US': { title: '…' }, 'ka-GE': { title: '…' } } }
+ * ```
+ */
+export declare function nestTranslations(flat: Record<string, unknown>, namespace?: string): Record<string, unknown>;
+/**
+ * The inverse of `nestTranslations`: a **nested** object (e.g. a backend response) → the flat values a
+ * `<Form>` / `<TranslatedFields>` expects. Feed the result as `defaultValues` (or into `reset`):
+ *
+ * ```ts
+ * const form = useForm({ schema, defaultValues: flattenTranslations(response) })
+ * //   { email: 1, 'translations[en-US].title': '…', 'translations[ka-GE].title': '…' }
+ * ```
+ */
+export declare function flattenTranslations(nested: Record<string, unknown>, namespace?: string): Record<string, unknown>;
+/**
+ * Serialize flat form values into a `FormData` for a `multipart/form-data` POST. The flat translation
+ * keys map straight through (`translations[en-US].title`); arrays become indexed keys (`tags[0]`,
+ * `tags[1]`) with nullish items skipped so indices stay contiguous; `Blob`/`File` values are appended
+ * as-is; a `Date` becomes an ISO string; only **plain** objects recurse (a class instance like a dayjs
+ * object is stringified, not exploded into `$d`/`$y` keys); `null`/`undefined` are skipped; everything
+ * else is stringified.
+ *
+ * ```ts
+ * await fetch('/news', { method: 'POST', body: toFormData(form.values) })
+ * ```
+ */
+export declare function toFormData(values: Record<string, unknown>): FormData;

package/dist/hooks/index.d.cts

@@ -0,0 +1,4 @@
+export { useDisclosure } from './useDisclosure';
+export type { UseDisclosureReturn } from './useDisclosure';
+export { useLockBodyScroll } from './useLockBodyScroll';
+export { useMediaQuery } from './useMediaQuery';

package/dist/hooks/index.d.ts

@@ -0,0 +1,4 @@
+export { useDisclosure } from './useDisclosure';
+export type { UseDisclosureReturn } from './useDisclosure';
+export { useLockBodyScroll } from './useLockBodyScroll';
+export { useMediaQuery } from './useMediaQuery';

package/dist/hooks/useDisclosure.d.cts

@@ -0,0 +1,7 @@
+export interface UseDisclosureReturn {
+    isOpen: boolean;
+    open: () => void;
+    close: () => void;
+    toggle: () => void;
+}
+export declare function useDisclosure(initial?: boolean): UseDisclosureReturn;

package/dist/hooks/useDisclosure.d.ts

@@ -0,0 +1,7 @@
+export interface UseDisclosureReturn {
+    isOpen: boolean;
+    open: () => void;
+    close: () => void;
+    toggle: () => void;
+}
+export declare function useDisclosure(initial?: boolean): UseDisclosureReturn;

package/dist/hooks/useFloatingPanel.d.cts

@@ -0,0 +1,45 @@
+import { type RefObject } from 'react';
+/** Geometry computed for a floating panel anchored to a trigger. */
+export interface FloatingPanelPosition {
+    top: number;
+    left: number;
+    width: number;
+    side: 'top' | 'bottom';
+    maxHeight: number;
+}
+export interface UseFloatingPanelOptions {
+    /** Whether the panel is open. */
+    open: boolean;
+    /** Ref to the anchor/trigger element. */
+    triggerRef: RefObject<HTMLElement | null>;
+    /**
+     * Horizontal alignment to the trigger: `start` (panel's left edge at the trigger's left — grows
+     * right, the default) or `end` (panel's right edge at the trigger's right — grows left).
+     */
+    align?: 'start' | 'end';
+    /**
+     * Dismiss request. Outside-pointerdown passes whether focus was parked inside the panel (so the
+     * consumer can restore focus to the trigger); Escape passes `true`.
+     */
+    onClose: (refocus: boolean) => void;
+}
+export interface UseFloatingPanelResult {
+    /** Attach to the portaled panel element. */
+    popoverRef: RefObject<HTMLDivElement | null>;
+    /** Computed geometry (null until first measured). */
+    position: FloatingPanelPosition | null;
+    /** Enter-animation flag (rAF-driven once open). */
+    visible: boolean;
+    /** Force a re-measure (rarely needed — scroll/resize/ResizeObserver already drive it). */
+    reposition: () => void;
+}
+/**
+ * Shared floating-panel plumbing — a `<body>`-portaled panel that opens below its trigger (flips above
+ * only when it would overflow), exposes the trigger width (for select-like matching), clamps to the
+ * viewport, re-positions on scroll/resize (+ `ResizeObserver`), locks page scroll while open, and
+ * dismisses on outside-pointerdown / `Escape`. The consumer owns the trigger ref, the `open` state, and
+ * the `onClose` cleanup; this hook owns the panel ref, geometry, the enter-animation flag, and the
+ * listeners. Wrapped by the internal `FloatingPanel` component, which every popover in the library
+ * (`Select` / `MultiSelect`, the date/time pickers, `ColorPicker`) renders. Internal (not public).
+ */
+export declare function useFloatingPanel({ open, triggerRef, align, onClose, }: UseFloatingPanelOptions): UseFloatingPanelResult;

package/dist/hooks/useFloatingPanel.d.ts

@@ -0,0 +1,45 @@
+import { type RefObject } from 'react';
+/** Geometry computed for a floating panel anchored to a trigger. */
+export interface FloatingPanelPosition {
+    top: number;
+    left: number;
+    width: number;
+    side: 'top' | 'bottom';
+    maxHeight: number;
+}
+export interface UseFloatingPanelOptions {
+    /** Whether the panel is open. */
+    open: boolean;
+    /** Ref to the anchor/trigger element. */
+    triggerRef: RefObject<HTMLElement | null>;
+    /**
+     * Horizontal alignment to the trigger: `start` (panel's left edge at the trigger's left — grows
+     * right, the default) or `end` (panel's right edge at the trigger's right — grows left).
+     */
+    align?: 'start' | 'end';
+    /**
+     * Dismiss request. Outside-pointerdown passes whether focus was parked inside the panel (so the
+     * consumer can restore focus to the trigger); Escape passes `true`.
+     */
+    onClose: (refocus: boolean) => void;
+}
+export interface UseFloatingPanelResult {
+    /** Attach to the portaled panel element. */
+    popoverRef: RefObject<HTMLDivElement | null>;
+    /** Computed geometry (null until first measured). */
+    position: FloatingPanelPosition | null;
+    /** Enter-animation flag (rAF-driven once open). */
+    visible: boolean;
+    /** Force a re-measure (rarely needed — scroll/resize/ResizeObserver already drive it). */
+    reposition: () => void;
+}
+/**
+ * Shared floating-panel plumbing — a `<body>`-portaled panel that opens below its trigger (flips above
+ * only when it would overflow), exposes the trigger width (for select-like matching), clamps to the
+ * viewport, re-positions on scroll/resize (+ `ResizeObserver`), locks page scroll while open, and
+ * dismisses on outside-pointerdown / `Escape`. The consumer owns the trigger ref, the `open` state, and
+ * the `onClose` cleanup; this hook owns the panel ref, geometry, the enter-animation flag, and the
+ * listeners. Wrapped by the internal `FloatingPanel` component, which every popover in the library
+ * (`Select` / `MultiSelect`, the date/time pickers, `ColorPicker`) renders. Internal (not public).
+ */
+export declare function useFloatingPanel({ open, triggerRef, align, onClose, }: UseFloatingPanelOptions): UseFloatingPanelResult;

package/dist/hooks/useLockBodyScroll.d.cts

@@ -0,0 +1,7 @@
+/**
+ * Locks scrolling on `document.body` while `locked` is true (e.g. an open menu / modal / drawer).
+ * Compensates for the removed scrollbar by **adding** to the body's `padding-right` so the page doesn't
+ * shift, and restores the previous inline styles when unlocked. **Ref-counted** — nested locks are safe
+ * to release in any order; the page unlocks only when the last one releases. SSR-safe.
+ */
+export declare function useLockBodyScroll(locked: boolean): void;

package/dist/hooks/useLockBodyScroll.d.ts

@@ -0,0 +1,7 @@
+/**
+ * Locks scrolling on `document.body` while `locked` is true (e.g. an open menu / modal / drawer).
+ * Compensates for the removed scrollbar by **adding** to the body's `padding-right` so the page doesn't
+ * shift, and restores the previous inline styles when unlocked. **Ref-counted** — nested locks are safe
+ * to release in any order; the page unlocks only when the last one releases. SSR-safe.
+ */
+export declare function useLockBodyScroll(locked: boolean): void;

package/dist/hooks/useMediaQuery.d.cts

@@ -0,0 +1,13 @@
+/**
+ * Subscribe to a CSS media query and get whether it currently matches, re-rendering when it flips.
+ * Built on `useSyncExternalStore`, so on the client the first render already has the correct value
+ * (no flash), and it's **SSR-safe** — returns `false` on the server / where `matchMedia` is
+ * unavailable. Use this instead of hand-rolling `window.matchMedia` + effects in a component.
+ *
+ * @param query - a media query string, e.g. `'(max-width: 640px)'` or `'(prefers-color-scheme: dark)'`.
+ * @returns `true` while the query matches.
+ *
+ * @example
+ * const isNarrow = useMediaQuery('(max-width: 640px)')
+ */
+export declare function useMediaQuery(query: string): boolean;

package/dist/hooks/useMediaQuery.d.ts

@@ -0,0 +1,13 @@
+/**
+ * Subscribe to a CSS media query and get whether it currently matches, re-rendering when it flips.
+ * Built on `useSyncExternalStore`, so on the client the first render already has the correct value
+ * (no flash), and it's **SSR-safe** — returns `false` on the server / where `matchMedia` is
+ * unavailable. Use this instead of hand-rolling `window.matchMedia` + effects in a component.
+ *
+ * @param query - a media query string, e.g. `'(max-width: 640px)'` or `'(prefers-color-scheme: dark)'`.
+ * @returns `true` while the query matches.
+ *
+ * @example
+ * const isNarrow = useMediaQuery('(max-width: 640px)')
+ */
+export declare function useMediaQuery(query: string): boolean;

package/dist/i18n/locales/de.d.cts

@@ -0,0 +1,5 @@
+import type { MessageCatalog } from '../messages';
+/** German — translated from the English baseline (`en.ts`); omitted keys fall back to English. */
+export declare const DE_MESSAGES: MessageCatalog;
+/** Flag for the German UI language — rendered beside the language in the header switcher. */
+export declare const DE_FLAG = "<svg xmlns=\"http://www.w3.org/2000/svg\" viewBox=\"0 0 640 480\">\n  <path fill=\"#fc0\" d=\"M0 320h640v160H0z\"/>\n  <path fill=\"#000001\" d=\"M0 0h640v160H0z\"/>\n  <path fill=\"red\" d=\"M0 160h640v160H0z\"/>\n</svg>";

package/dist/i18n/locales/de.d.ts

@@ -0,0 +1,5 @@
+import type { MessageCatalog } from '../messages';
+/** German — translated from the English baseline (`en.ts`); omitted keys fall back to English. */
+export declare const DE_MESSAGES: MessageCatalog;
+/** Flag for the German UI language — rendered beside the language in the header switcher. */
+export declare const DE_FLAG = "<svg xmlns=\"http://www.w3.org/2000/svg\" viewBox=\"0 0 640 480\">\n  <path fill=\"#fc0\" d=\"M0 320h640v160H0z\"/>\n  <path fill=\"#000001\" d=\"M0 0h640v160H0z\"/>\n  <path fill=\"red\" d=\"M0 160h640v160H0z\"/>\n</svg>";

package/dist/i18n/locales/en.d.cts

@@ -0,0 +1,9 @@
+import type { Messages } from '../messages';
+/**
+ * English — the **complete** baseline every other language falls back to, per key. When you add a new
+ * key to the `Messages` interface (in `../messages`), fill it here first; the type makes this file the
+ * one catalog that must stay exhaustive (the others are `Partial` and fall back here).
+ */
+export declare const EN_MESSAGES: Messages;
+/** Flag for the English (US) UI language — rendered beside the language in the header switcher. */
+export declare const EN_FLAG = "<svg xmlns=\"http://www.w3.org/2000/svg\" viewBox=\"0 0 640 480\">\n  <path fill=\"#bd3d44\" d=\"M0 0h640v480H0\"/>\n  <path stroke=\"#fff\" stroke-width=\"37\" d=\"M0 55.3h640M0 129h640M0 203h640M0 277h640M0 351h640M0 425h640\"/>\n  <path fill=\"#192f5d\" d=\"M0 0h364.8v258.5H0\"/>\n  <marker id=\"us-a\" markerHeight=\"30\" markerWidth=\"30\">\n    <path fill=\"#fff\" d=\"m14 0 9 27L0 10h28L5 27z\"/>\n  </marker>\n  <path fill=\"none\" marker-mid=\"url(#us-a)\" d=\"m0 0 16 11h61 61 61 61 60L47 37h61 61 60 61L16 63h61 61 61 61 60L47 89h61 61 60 61L16 115h61 61 61 61 60L47 141h61 61 60 61L16 166h61 61 61 61 60L47 192h61 61 60 61L16 218h61 61 61 61 60z\"/>\n</svg>";

package/dist/i18n/locales/en.d.ts

@@ -0,0 +1,9 @@
+import type { Messages } from '../messages';
+/**
+ * English — the **complete** baseline every other language falls back to, per key. When you add a new
+ * key to the `Messages` interface (in `../messages`), fill it here first; the type makes this file the
+ * one catalog that must stay exhaustive (the others are `Partial` and fall back here).
+ */
+export declare const EN_MESSAGES: Messages;
+/** Flag for the English (US) UI language — rendered beside the language in the header switcher. */
+export declare const EN_FLAG = "<svg xmlns=\"http://www.w3.org/2000/svg\" viewBox=\"0 0 640 480\">\n  <path fill=\"#bd3d44\" d=\"M0 0h640v480H0\"/>\n  <path stroke=\"#fff\" stroke-width=\"37\" d=\"M0 55.3h640M0 129h640M0 203h640M0 277h640M0 351h640M0 425h640\"/>\n  <path fill=\"#192f5d\" d=\"M0 0h364.8v258.5H0\"/>\n  <marker id=\"us-a\" markerHeight=\"30\" markerWidth=\"30\">\n    <path fill=\"#fff\" d=\"m14 0 9 27L0 10h28L5 27z\"/>\n  </marker>\n  <path fill=\"none\" marker-mid=\"url(#us-a)\" d=\"m0 0 16 11h61 61 61 61 60L47 37h61 61 60 61L16 63h61 61 61 61 60L47 89h61 61 60 61L16 115h61 61 61 61 60L47 141h61 61 60 61L16 166h61 61 61 61 60L47 192h61 61 60 61L16 218h61 61 61 61 60z\"/>\n</svg>";

package/dist/i18n/locales/es.d.cts

@@ -0,0 +1,5 @@
+import type { MessageCatalog } from '../messages';
+/** Spanish — translated from the English baseline (`en.ts`); omitted keys fall back to English. */
+export declare const ES_MESSAGES: MessageCatalog;
+/** Flag for the Spanish UI language — rendered beside the language in the header switcher. */
+export declare const ES_FLAG = "<svg xmlns=\"http://www.w3.org/2000/svg\" viewBox=\"0 0 640 480\">\n  <path fill=\"#AA151B\" d=\"M0 0h640v480H0z\"/>\n  <path fill=\"#F1BF00\" d=\"M0 120h640v240H0z\"/>\n</svg>";

package/dist/i18n/locales/es.d.ts

@@ -0,0 +1,5 @@
+import type { MessageCatalog } from '../messages';
+/** Spanish — translated from the English baseline (`en.ts`); omitted keys fall back to English. */
+export declare const ES_MESSAGES: MessageCatalog;
+/** Flag for the Spanish UI language — rendered beside the language in the header switcher. */
+export declare const ES_FLAG = "<svg xmlns=\"http://www.w3.org/2000/svg\" viewBox=\"0 0 640 480\">\n  <path fill=\"#AA151B\" d=\"M0 0h640v480H0z\"/>\n  <path fill=\"#F1BF00\" d=\"M0 120h640v240H0z\"/>\n</svg>";

package/dist/i18n/locales/fr.d.cts

@@ -0,0 +1,5 @@
+import type { MessageCatalog } from '../messages';
+/** French — translated from the English baseline (`en.ts`); omitted keys fall back to English. */
+export declare const FR_MESSAGES: MessageCatalog;
+/** Flag for the French UI language — rendered beside the language in the header switcher. */
+export declare const FR_FLAG = "<svg xmlns=\"http://www.w3.org/2000/svg\" viewBox=\"0 0 640 480\">\n  <path fill=\"#000091\" d=\"M0 0h213.3v480H0z\"/>\n  <path fill=\"#fff\" d=\"M213.3 0h213.4v480H213.3z\"/>\n  <path fill=\"#e1000f\" d=\"M426.7 0H640v480H426.7z\"/>\n</svg>";

package/dist/i18n/locales/fr.d.ts

@@ -0,0 +1,5 @@
+import type { MessageCatalog } from '../messages';
+/** French — translated from the English baseline (`en.ts`); omitted keys fall back to English. */
+export declare const FR_MESSAGES: MessageCatalog;
+/** Flag for the French UI language — rendered beside the language in the header switcher. */
+export declare const FR_FLAG = "<svg xmlns=\"http://www.w3.org/2000/svg\" viewBox=\"0 0 640 480\">\n  <path fill=\"#000091\" d=\"M0 0h213.3v480H0z\"/>\n  <path fill=\"#fff\" d=\"M213.3 0h213.4v480H213.3z\"/>\n  <path fill=\"#e1000f\" d=\"M426.7 0H640v480H426.7z\"/>\n</svg>";

package/dist/i18n/locales/it.d.cts

@@ -0,0 +1,5 @@
+import type { MessageCatalog } from '../messages';
+/** Italian — translated from the English baseline (`en.ts`); omitted keys fall back to English. */
+export declare const IT_MESSAGES: MessageCatalog;
+/** Flag for the Italian UI language — rendered beside the language in the header switcher. */
+export declare const IT_FLAG = "<svg xmlns=\"http://www.w3.org/2000/svg\" viewBox=\"0 0 640 480\">\n  <g fill-rule=\"evenodd\" stroke-width=\"1pt\">\n    <path fill=\"#fff\" d=\"M0 0h640v480H0z\"/>\n    <path fill=\"#009246\" d=\"M0 0h213.3v480H0z\"/>\n    <path fill=\"#ce2b37\" d=\"M426.7 0H640v480H426.7z\"/>\n  </g>\n</svg>";

package/dist/i18n/locales/it.d.ts

@@ -0,0 +1,5 @@
+import type { MessageCatalog } from '../messages';
+/** Italian — translated from the English baseline (`en.ts`); omitted keys fall back to English. */
+export declare const IT_MESSAGES: MessageCatalog;
+/** Flag for the Italian UI language — rendered beside the language in the header switcher. */
+export declare const IT_FLAG = "<svg xmlns=\"http://www.w3.org/2000/svg\" viewBox=\"0 0 640 480\">\n  <g fill-rule=\"evenodd\" stroke-width=\"1pt\">\n    <path fill=\"#fff\" d=\"M0 0h640v480H0z\"/>\n    <path fill=\"#009246\" d=\"M0 0h213.3v480H0z\"/>\n    <path fill=\"#ce2b37\" d=\"M426.7 0H640v480H426.7z\"/>\n  </g>\n</svg>";

package/dist/i18n/locales/ka.d.cts

@@ -0,0 +1,8 @@
+import type { MessageCatalog } from '../messages';
+/**
+ * Georgian — shipped built-in (the maintainer's language). A `MessageCatalog` (`Partial<Messages>`),
+ * so any key it omits falls back to English (`en.ts`) at resolve time.
+ */
+export declare const KA_MESSAGES: MessageCatalog;
+/** Flag for the Georgian UI language — rendered beside the language in the header switcher. */
+export declare const KA_FLAG = "<svg xmlns=\"http://www.w3.org/2000/svg\" viewBox=\"0 0 640 480\">\n  <path fill=\"#fff\" d=\"M0 0h640v480H0z\"/>\n  <path fill=\"red\" d=\"M272 0h96v480h-96z\"/>\n  <path fill=\"red\" d=\"M0 192h640v96H0z\"/>\n  <path fill=\"red\" fill-rule=\"evenodd\" d=\"M146.8 373.1c1-16.8 4-31.1 4-31.1s-9.8 1-14.8 1-14.8-1-14.8-1 3 14.3 4 31.2c-16.9-1-31.2-4-31.2-4s1 7.4 1 14.8-1 14.8-1 14.8 14.3-3 31.2-4c-1 16.9-4 31.2-4 31.2s7.4-1 14.8-1 14.8 1 14.8 1-3-14.3-4-31.2c16.9 1 31.2 4 31.2 4s-1-9.8-1-14.8 1-14.8 1-14.8-14.3 3-31.1 4zm368-288c1-16.8 4-31.1 4-31.1s-9.8 1-14.8 1-14.8-1-14.8-1 3 14.3 4 31.1c-16.9-1-31.2-3.9-31.2-3.9s1 7.4 1 14.8-1 14.8-1 14.8 14.3-3 31.2-4c-1 16.9-4 31.2-4 31.2s7.4-1 14.8-1 14.8 1 14.8 1-3-14.3-4-31.1c16.9 1 31.2 4 31.2 4s-1-10-1-14.9 1-14.8 1-14.8-14.3 3-31.2 4zm-368 0c1-16.8 4-31.1 4-31.1s-9.8 1-14.8 1-14.8-1-14.8-1 3 14.3 4 31.2c-16.9-1-31.2-4-31.2-4s1 7.4 1 14.8-1 14.8-1 14.8 14.3-3 31.2-4c-1 16.9-4 31.2-4 31.2s7.4-1 14.8-1 14.8 1 14.8 1-3-14.3-4-31.2c16.9 1 31.2 4 31.2 4s-1-9.8-1-14.8 1-14.8 1-14.8-14.3 3-31.1 4zm368 288c1-16.8 4-31.1 4-31.1s-9.8 1-14.8 1-14.8-1-14.8-1 3 14.3 4 31.2c-16.9-1-31.2-4-31.2-4s1 7.4 1 14.8-1 14.8-1 14.8 14.3-3 31.2-4c-1 16.9-4 31.2-4 31.2s7.4-1 14.8-1 14.8 1 14.8 1-3-14.3-4-31.2c16.9 1 31.2 4 31.2 4s-1-9.8-1-14.8 1-14.8 1-14.8-14.3 3-31.2 4z\"/>\n</svg>";

package/dist/i18n/locales/ka.d.ts

@@ -0,0 +1,8 @@
+import type { MessageCatalog } from '../messages';
+/**
+ * Georgian — shipped built-in (the maintainer's language). A `MessageCatalog` (`Partial<Messages>`),
+ * so any key it omits falls back to English (`en.ts`) at resolve time.
+ */
+export declare const KA_MESSAGES: MessageCatalog;
+/** Flag for the Georgian UI language — rendered beside the language in the header switcher. */
+export declare const KA_FLAG = "<svg xmlns=\"http://www.w3.org/2000/svg\" viewBox=\"0 0 640 480\">\n  <path fill=\"#fff\" d=\"M0 0h640v480H0z\"/>\n  <path fill=\"red\" d=\"M272 0h96v480h-96z\"/>\n  <path fill=\"red\" d=\"M0 192h640v96H0z\"/>\n  <path fill=\"red\" fill-rule=\"evenodd\" d=\"M146.8 373.1c1-16.8 4-31.1 4-31.1s-9.8 1-14.8 1-14.8-1-14.8-1 3 14.3 4 31.2c-16.9-1-31.2-4-31.2-4s1 7.4 1 14.8-1 14.8-1 14.8 14.3-3 31.2-4c-1 16.9-4 31.2-4 31.2s7.4-1 14.8-1 14.8 1 14.8 1-3-14.3-4-31.2c16.9 1 31.2 4 31.2 4s-1-9.8-1-14.8 1-14.8 1-14.8-14.3 3-31.1 4zm368-288c1-16.8 4-31.1 4-31.1s-9.8 1-14.8 1-14.8-1-14.8-1 3 14.3 4 31.1c-16.9-1-31.2-3.9-31.2-3.9s1 7.4 1 14.8-1 14.8-1 14.8 14.3-3 31.2-4c-1 16.9-4 31.2-4 31.2s7.4-1 14.8-1 14.8 1 14.8 1-3-14.3-4-31.1c16.9 1 31.2 4 31.2 4s-1-10-1-14.9 1-14.8 1-14.8-14.3 3-31.2 4zm-368 0c1-16.8 4-31.1 4-31.1s-9.8 1-14.8 1-14.8-1-14.8-1 3 14.3 4 31.2c-16.9-1-31.2-4-31.2-4s1 7.4 1 14.8-1 14.8-1 14.8 14.3-3 31.2-4c-1 16.9-4 31.2-4 31.2s7.4-1 14.8-1 14.8 1 14.8 1-3-14.3-4-31.2c16.9 1 31.2 4 31.2 4s-1-9.8-1-14.8 1-14.8 1-14.8-14.3 3-31.1 4zm368 288c1-16.8 4-31.1 4-31.1s-9.8 1-14.8 1-14.8-1-14.8-1 3 14.3 4 31.2c-16.9-1-31.2-4-31.2-4s1 7.4 1 14.8-1 14.8-1 14.8 14.3-3 31.2-4c-1 16.9-4 31.2-4 31.2s7.4-1 14.8-1 14.8 1 14.8 1-3-14.3-4-31.2c16.9 1 31.2 4 31.2 4s-1-9.8-1-14.8 1-14.8 1-14.8-14.3 3-31.2 4z\"/>\n</svg>";