@techzyapp/ui-library 1.0.0

package/dist/components/FileUploader/FileUploader.d.ts

@@ -0,0 +1,144 @@
+import { type HTMLAttributes, type ReactNode } from 'react';
+import { type Accept } from 'react-dropzone';
+import { type LocaleConfig } from '../../theme';
+/**
+ * A single file entry. A freshly-picked file carries its binary in `file`; an already-uploaded one
+ * (a backend response, edit mode) carries only its URL in `source` — then `file` is absent.
+ */
+export interface FileUploaderItem {
+    /** The picked binary — present for a newly-selected file, absent for an already-uploaded one. */
+    file?: File;
+    /** Server URL of an already-uploaded file (edit mode); `''` for a fresh pick. */
+    source?: string;
+    /** Position in the list (0-based) — kept in sync with the visual order on every change. */
+    sortIndex: number;
+    /**
+     * Optional alt text, edited per card via the `allowAltText` modal. **Per-locale by default** —
+     * `Record<localeCode, string>` (e.g. `{ 'en-US': 'A red car', 'ka-GE': '…' }`); with
+     * **`localizedAltText={false}`** it's a single **`string`**. Absent until something is typed.
+     */
+    altText?: Record<string, string> | string;
+}
+/** Single mode → one item (or `null`); `multiple` mode → an array. */
+export type FileUploaderValue = FileUploaderItem | FileUploaderItem[] | null;
+export interface FileUploaderProps extends Omit<HTMLAttributes<HTMLDivElement>, 'onChange' | 'defaultValue'> {
+    /** Accept more than one file — the value becomes an array. Defaults to `false`. */
+    multiple?: boolean;
+    /** Allow dropping files onto the dropzone (drag from the OS). Defaults to `true`. */
+    allowDrop?: boolean;
+    /** Allow drag + keyboard reordering of the rows (only meaningful with `multiple`). Defaults to `true`. */
+    allowReorder?: boolean;
+    /** Show a download button on each item (downloads the File / source). Defaults to `true`. */
+    allowDownload?: boolean;
+    /**
+     * Show a per-card **preview** (Eye) button — opens a fullscreen lightbox of the image / video. Defaults
+     * to `true`. Only rendered for **image + video** items (a PDF / doc has nothing to preview).
+     */
+    allowPreview?: boolean;
+    /**
+     * Show a per-card **edit** button that opens a modal for editing the item's `altText`. Defaults to
+     * `true` — pass `false` to hide it. The modal renders one input per content locale (a tab strip when
+     * there are several), so the edited value lands in `item.altText` keyed by locale code (or a single
+     * string with `localizedAltText={false}`).
+     */
+    allowAltText?: boolean;
+    /**
+     * Locales for the `allowAltText` editor (one input/tab each). Defaults to the app's `ConfigProvider`
+     * locales (`useLocales()`); pass this to override — mirrors `<TranslatedFields locales>`. Ignored when
+     * `localizedAltText` is `false`.
+     */
+    altTextLocales?: LocaleConfig[];
+    /**
+     * Whether the `allowAltText` editor is **per-locale**. Defaults to `true` — `altText` is a
+     * `Record<localeCode, string>` with one input/tab per locale. Pass **`false`** for a single plain input
+     * (no locales), so `altText` is just a **`string`**.
+     */
+    localizedAltText?: boolean;
+    /**
+     * Allow the same file to be added more than once. By default (`false`) a pick that matches an
+     * already-present item by content (a File by name + size + last-modified, a source by URL) is skipped
+     * and a notice is shown. Only meaningful with `multiple` (single mode replaces, so it can't stack).
+     */
+    allowDuplicates?: boolean;
+    /** Disables the whole control — no adding, removing, reordering, or downloading; dimmed + inert. */
+    disabled?: boolean;
+    /**
+     * Accepted file types (react-dropzone's format: a MIME type → file-extensions map) — restricts the file
+     * picker and rejects non-matching picks/drops (a rejection raises a `toast.error`). E.g. `{ 'image/*': [] }`
+     * or `{ 'image/*': [], 'application/pdf': ['.pdf'] }`. Omit to accept any type.
+     */
+    accept?: Accept;
+    /** Maximum number of files (only meaningful with `multiple`). Picks beyond it are rejected with a notice. */
+    maxFiles?: number;
+    /**
+     * Maximum size per file — a bytes `number`, or a human string like `"5MB"` / `"500KB"`. A picked file
+     * over the limit is **rejected** (not added) and raises a **`toast.error`** (so a `<Toaster>` — mounted
+     * by `RootLayout` by default — must be present to see it). A file supplied via `value`/`defaultValue`
+     * that exceeds the limit is still rendered but flagged in an error state (red ring + `"Exceeds … limit"`).
+     */
+    maxFileSize?: number | string;
+    /** Where a newly added file lands in the list (`multiple` only): `'start'` (top) or `'end'` (bottom). Defaults to `'end'`. */
+    itemInsertLocation?: 'start' | 'end';
+    /** Controlled value — one item (or `null`) when single, an array when `multiple`. */
+    value?: FileUploaderValue;
+    /** Initial value for uncontrolled use. */
+    defaultValue?: FileUploaderValue;
+    /** Fires with the next value whenever files are added, removed, or reordered. */
+    onChange?: (value: FileUploaderValue) => void;
+    /** Label rendered above the control. */
+    label?: ReactNode;
+    /** Marks the field invalid: red dropzone border + the `helperText` in the error color. */
+    error?: boolean;
+    /** Helper / validation text under the control. Adopts the error color while `error`. */
+    helperText?: ReactNode;
+    /** Adds a red asterisk after the label. */
+    required?: boolean;
+    /** Stretches the control to fill its container width. Defaults to `true`. */
+    fullWidth?: boolean;
+    /**
+     * Binds the field to a surrounding `<Form>` — the form value is the item / array, validated with e.g.
+     * `z.array(fileItemSchema).min(1)`. Reads the raw `form.values[name]` and writes via `setValue`;
+     * error/touched come from the form, and the form's scroll-to-error can focus the field.
+     */
+    name?: string;
+}
+/** Human-readable byte size, e.g. `2.4 MB`. (Exported for unit tests; not part of the public surface.) */
+export declare const formatBytes: (bytes: number) => string;
+/** Coerce a `maxFileSize` (a bytes number, or a human string like `"5MB"` / `"500 KB"`) to bytes. */
+export declare const toBytes: (size: number | string) => number | undefined;
+/**
+ * A content-identity key for de-duplication. The same file picked twice arrives as two distinct `File`
+ * objects (so a `WeakMap`/reference check can't catch it), but its name + size + last-modified match.
+ */
+export declare const fileKey: (file: File) => string;
+/** The dedup key for an existing item — a File by its content, an already-uploaded one by its URL. */
+export declare const itemKey: (item: FileUploaderItem) => string;
+/** Display name — the File's name or the last path segment of a source URL. */
+export declare const labelOf: (item: FileUploaderItem) => string;
+/**
+ * Whether an item is an image — the only kind that gets the **crop** + **alt-text** editors (a video / PDF
+ * / doc has nothing to crop or describe). A File is judged by its MIME `type`; a source URL by a known
+ * image extension or a `data:image/…` URI, defaulting to `true` when it carries no recognizable extension
+ * (the image-first assumption — e.g. extensionless CDN URLs).
+ */
+export declare const isImageItem: (item: FileUploaderItem) => boolean;
+/** Whether an item is a video — rendered as a playable `<video controls>` preview instead of an `<img>`. */
+export declare const isVideoItem: (item: FileUploaderItem) => boolean;
+/**
+ * Split a name into the part that may truncate and a short trailing extension that should always stay
+ * visible — so a long name middle-ellipses as `name….ext` instead of overflowing or losing the type.
+ */
+export declare const splitName: (name: string) => {
+    base: string;
+    ext: string;
+};
+/**
+ * A small, clean file field that **collects** files for the consumer to upload on save — it never
+ * uploads itself. New picks carry their binary in `file`; already-uploaded files arrive with a
+ * `source` URL. A soft dropzone panel sits above a grid of image cards (thumbnail/file-icon + name +
+ * size, with overlaid remove + download buttons). `allowDrop` enables drag-from-OS (via
+ * `react-dropzone`); `allowReorder` enables drag + keyboard reordering (via `@dnd-kit`); cards animate
+ * in/out (via `@formkit/auto-animate`). Controlled (`value` + `onChange`) or uncontrolled
+ * (`defaultValue`); binds to a `<Form>` by `name`. The forwarded ref points at the root.
+ */
+export declare const FileUploader: import("react").ForwardRefExoticComponent<FileUploaderProps & import("react").RefAttributes<HTMLDivElement>>;

package/dist/components/FileUploader/FileUploaderEditDialog.d.cts

@@ -0,0 +1,34 @@
+import 'react-image-crop/dist/ReactCrop.css';
+import { type LocaleConfig } from '../../theme';
+/** What a dialog hands back on Save: the alt-text draft (alt-text mode) or a cropped File (crop mode). */
+export interface EditDialogResult {
+    /** Alt-text values keyed by locale code (or the single `''` key in non-localized mode). */
+    draft?: Record<string, string>;
+    /** A freshly-cropped File (native-resolution, lossless). */
+    croppedFile?: File;
+}
+export interface FileUploaderEditDialogProps {
+    /** Which editor to show — the **crop** stage or the **alt text** fields (each is its own modal). */
+    mode: 'crop' | 'altText';
+    /** Display name (modal description + the cropped File's name). */
+    name: string;
+    /** Image URL for crop mode (object URL for a File, or the source URL). */
+    imageUrl: string | null;
+    /** MIME type for the cropped output — keeps the original (PNG ⇒ lossless). */
+    mimeType: string;
+    /** Locales for the alt-text editor (one field each); a single `{ code: '' }` ⇒ one plain field. */
+    editLocales: LocaleConfig[];
+    /** The alt-text draft to seed from the item's current value. */
+    initialDraft: Record<string, string>;
+    /** Close without saving. */
+    onClose: () => void;
+    /** Commit the result (alt-text draft or cropped File). */
+    onSave: (result: EditDialogResult) => void;
+}
+/**
+ * The FileUploader per-item edit modal. Two separate modes (each opened from its own card button):
+ * **`crop`** — a draggable selection over the image, exported at the image's native resolution (lossless,
+ * dimensions shown live); **`altText`** — one `TextField` per locale (stacked, no tabs). Built on the
+ * library's `Modal` + `TextField` and **`react-image-crop`** (an optional peer). Internal — not exported.
+ */
+export declare function FileUploaderEditDialog({ mode, name, imageUrl, mimeType, editLocales, initialDraft, onClose, onSave, }: FileUploaderEditDialogProps): import("react/jsx-runtime").JSX.Element;

package/dist/components/FileUploader/FileUploaderEditDialog.d.ts

@@ -0,0 +1,34 @@
+import 'react-image-crop/dist/ReactCrop.css';
+import { type LocaleConfig } from '../../theme';
+/** What a dialog hands back on Save: the alt-text draft (alt-text mode) or a cropped File (crop mode). */
+export interface EditDialogResult {
+    /** Alt-text values keyed by locale code (or the single `''` key in non-localized mode). */
+    draft?: Record<string, string>;
+    /** A freshly-cropped File (native-resolution, lossless). */
+    croppedFile?: File;
+}
+export interface FileUploaderEditDialogProps {
+    /** Which editor to show — the **crop** stage or the **alt text** fields (each is its own modal). */
+    mode: 'crop' | 'altText';
+    /** Display name (modal description + the cropped File's name). */
+    name: string;
+    /** Image URL for crop mode (object URL for a File, or the source URL). */
+    imageUrl: string | null;
+    /** MIME type for the cropped output — keeps the original (PNG ⇒ lossless). */
+    mimeType: string;
+    /** Locales for the alt-text editor (one field each); a single `{ code: '' }` ⇒ one plain field. */
+    editLocales: LocaleConfig[];
+    /** The alt-text draft to seed from the item's current value. */
+    initialDraft: Record<string, string>;
+    /** Close without saving. */
+    onClose: () => void;
+    /** Commit the result (alt-text draft or cropped File). */
+    onSave: (result: EditDialogResult) => void;
+}
+/**
+ * The FileUploader per-item edit modal. Two separate modes (each opened from its own card button):
+ * **`crop`** — a draggable selection over the image, exported at the image's native resolution (lossless,
+ * dimensions shown live); **`altText`** — one `TextField` per locale (stacked, no tabs). Built on the
+ * library's `Modal` + `TextField` and **`react-image-crop`** (an optional peer). Internal — not exported.
+ */
+export declare function FileUploaderEditDialog({ mode, name, imageUrl, mimeType, editLocales, initialDraft, onClose, onSave, }: FileUploaderEditDialogProps): import("react/jsx-runtime").JSX.Element;

package/dist/components/FileUploader/FileUploaderPreview.d.cts

@@ -0,0 +1,23 @@
+export interface FileUploaderPreviewProps {
+    /** The media URL (a File's object URL or a source URL). */
+    url: string;
+    /** Render a `<video controls>` instead of an `<img>`. */
+    isVideo: boolean;
+    /**
+     * The image is an SVG — a vector has no reliable pixel size (a viewBox-only icon shows tiny, a sizeless
+     * one collapses to nothing), so when set the image is given a floored box (`min-*` + `object-fit:
+     * contain`): a small SVG scales up to a visible minimum while a larger one keeps its real size.
+     */
+    isSvg?: boolean;
+    /** Accessible name / image alt. */
+    name: string;
+    /** Dismiss the overlay. */
+    onClose: () => void;
+}
+/**
+ * A fullscreen media lightbox for the FileUploader — a dark backdrop with the image (or a `<video>` with
+ * controls) centered. Built on the shared `<Overlay>` (portal to `<body>`, scroll-lock, fade-in, backdrop
+ * / Escape dismissal); a darker scrim (`dim={0.85}`) than a Modal since media reads over black. Opened
+ * from a card's **Eye** button (image + video items only). Internal — not exported.
+ */
+export declare function FileUploaderPreview({ url, isVideo, isSvg, name, onClose, }: FileUploaderPreviewProps): import("react/jsx-runtime").JSX.Element;

package/dist/components/FileUploader/FileUploaderPreview.d.ts

@@ -0,0 +1,23 @@
+export interface FileUploaderPreviewProps {
+    /** The media URL (a File's object URL or a source URL). */
+    url: string;
+    /** Render a `<video controls>` instead of an `<img>`. */
+    isVideo: boolean;
+    /**
+     * The image is an SVG — a vector has no reliable pixel size (a viewBox-only icon shows tiny, a sizeless
+     * one collapses to nothing), so when set the image is given a floored box (`min-*` + `object-fit:
+     * contain`): a small SVG scales up to a visible minimum while a larger one keeps its real size.
+     */
+    isSvg?: boolean;
+    /** Accessible name / image alt. */
+    name: string;
+    /** Dismiss the overlay. */
+    onClose: () => void;
+}
+/**
+ * A fullscreen media lightbox for the FileUploader — a dark backdrop with the image (or a `<video>` with
+ * controls) centered. Built on the shared `<Overlay>` (portal to `<body>`, scroll-lock, fade-in, backdrop
+ * / Escape dismissal); a darker scrim (`dim={0.85}`) than a Modal since media reads over black. Opened
+ * from a card's **Eye** button (image + video items only). Internal — not exported.
+ */
+export declare function FileUploaderPreview({ url, isVideo, isSvg, name, onClose, }: FileUploaderPreviewProps): import("react/jsx-runtime").JSX.Element;

package/dist/components/FileUploader/index.cjs

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

package/dist/components/FileUploader/index.cjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.cjs","sources":[],"sourcesContent":[],"names":[],"mappings":""}

package/dist/components/FileUploader/index.d.cts

@@ -0,0 +1,2 @@
+export { FileUploader, FileUploader as default } from './FileUploader';
+export type { FileUploaderProps, FileUploaderItem, FileUploaderValue } from './FileUploader';

package/dist/components/FileUploader/index.d.ts

@@ -0,0 +1,2 @@
+export { FileUploader, FileUploader as default } from './FileUploader';
+export type { FileUploaderProps, FileUploaderItem, FileUploaderValue } from './FileUploader';

package/dist/components/FileUploader/index.js

@@ -0,0 +1,6 @@
+import { F as l, F as o } from "../../FileUploader-VtmmwUFE.js";
+export {
+  l as FileUploader,
+  o as default
+};
+//# sourceMappingURL=index.js.map

package/dist/components/FileUploader/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sources":[],"sourcesContent":[],"names":[],"mappings":";"}

package/dist/components/Flag/Flag.d.cts

@@ -0,0 +1,14 @@
+import { type HTMLAttributes } from 'react';
+export interface FlagProps extends HTMLAttributes<HTMLSpanElement> {
+    /** UI-language code (e.g. `'ka-GE'`); the flag is matched by base language via `flagFor`. */
+    code: string;
+    /** Flag height in px (width follows the 4:3 flag ratio). Defaults to `16`. */
+    size?: number;
+}
+/**
+ * A small rounded country/language flag, rendered from the library's built-in flag registry
+ * (`flagFor(code)`, matched by base language). The SVG is library-shipped (trusted), so it's injected as
+ * markup; the component renders **nothing** when the language has no shipped flag. Used by the shell's
+ * header language switcher, but public for any language UI.
+ */
+export declare const Flag: import("react").ForwardRefExoticComponent<FlagProps & import("react").RefAttributes<HTMLSpanElement>>;

package/dist/components/Flag/Flag.d.ts

@@ -0,0 +1,14 @@
+import { type HTMLAttributes } from 'react';
+export interface FlagProps extends HTMLAttributes<HTMLSpanElement> {
+    /** UI-language code (e.g. `'ka-GE'`); the flag is matched by base language via `flagFor`. */
+    code: string;
+    /** Flag height in px (width follows the 4:3 flag ratio). Defaults to `16`. */
+    size?: number;
+}
+/**
+ * A small rounded country/language flag, rendered from the library's built-in flag registry
+ * (`flagFor(code)`, matched by base language). The SVG is library-shipped (trusted), so it's injected as
+ * markup; the component renders **nothing** when the language has no shipped flag. Used by the shell's
+ * header language switcher, but public for any language UI.
+ */
+export declare const Flag: import("react").ForwardRefExoticComponent<FlagProps & import("react").RefAttributes<HTMLSpanElement>>;

package/dist/components/Flag/index.cjs

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

package/dist/components/Flag/index.cjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.cjs","sources":[],"sourcesContent":[],"names":[],"mappings":""}

package/dist/components/Flag/index.d.cts

@@ -0,0 +1,2 @@
+export { Flag, Flag as default } from './Flag';
+export type { FlagProps } from './Flag';

package/dist/components/Flag/index.d.ts

@@ -0,0 +1,2 @@
+export { Flag, Flag as default } from './Flag';
+export type { FlagProps } from './Flag';

package/dist/components/Flag/index.js

@@ -0,0 +1,6 @@
+import { F as e, F as f } from "../../Flag-BWCX6oSR.js";
+export {
+  e as Flag,
+  f as default
+};
+//# sourceMappingURL=index.js.map

package/dist/components/Flag/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sources":[],"sourcesContent":[],"names":[],"mappings":";"}

package/dist/components/Flex/Col.d.cts

@@ -0,0 +1,8 @@
+import { type FlexProps } from './Flex';
+export interface ColProps extends Omit<FlexProps, 'direction'> {
+}
+/**
+ * A vertical flex column. `Flex` with `direction="column"` (children stretch to full width by
+ * default) — set `gap`/`align`/`justify`/`padding` via props.
+ */
+export declare const Col: import("react").ForwardRefExoticComponent<ColProps & import("react").RefAttributes<HTMLDivElement>>;

package/dist/components/Flex/Col.d.ts

@@ -0,0 +1,8 @@
+import { type FlexProps } from './Flex';
+export interface ColProps extends Omit<FlexProps, 'direction'> {
+}
+/**
+ * A vertical flex column. `Flex` with `direction="column"` (children stretch to full width by
+ * default) — set `gap`/`align`/`justify`/`padding` via props.
+ */
+export declare const Col: import("react").ForwardRefExoticComponent<ColProps & import("react").RefAttributes<HTMLDivElement>>;

package/dist/components/Flex/Flex.d.cts

@@ -0,0 +1,32 @@
+import { type HTMLAttributes } from 'react';
+/** A space value: a `--tz-space-*` scale key, a raw number (px), or any CSS length string. */
+export type Spacing = 'xxs' | 'xs' | 'sm' | 'md' | 'lg' | 'xl' | 'xxl' | number | (string & {});
+export type FlexDirection = 'row' | 'column';
+export type FlexAlign = 'start' | 'center' | 'end' | 'stretch' | 'baseline';
+export type FlexJustify = 'start' | 'center' | 'end' | 'between' | 'around' | 'evenly';
+/** Resolve a `Spacing` to a CSS value — scale key → token, number → px, else passthrough. */
+export declare function space(value?: Spacing): string | undefined;
+export interface FlexProps extends HTMLAttributes<HTMLDivElement> {
+    /** Main axis. `row` (default) or `column`. */
+    direction?: FlexDirection;
+    /** Gap between children (token key, px number, or CSS value). */
+    gap?: Spacing;
+    /** `align-items`. */
+    align?: FlexAlign;
+    /** `justify-content`. */
+    justify?: FlexJustify;
+    /** Allow children to wrap onto multiple lines. */
+    wrap?: boolean;
+    /** Padding (token key, px number, or CSS value — e.g. `"24px 8px"`). */
+    padding?: Spacing;
+    /** Render as `inline-flex` instead of `flex`. */
+    inline?: boolean;
+    /** The box's own `flex-grow` (when this Flex is itself a flex child). `true` = `1`. */
+    grow?: boolean | number;
+}
+/**
+ * A flexbox layout primitive — set direction/gap/alignment/padding via props instead of inline styles.
+ * `Row` and `Col` are thin presets over it. Spacing accepts `--tz-space-*` keys (`"md"`), raw px
+ * numbers, or any CSS value; consumer `style` still merges last.
+ */
+export declare const Flex: import("react").ForwardRefExoticComponent<FlexProps & import("react").RefAttributes<HTMLDivElement>>;

package/dist/components/Flex/Flex.d.ts

@@ -0,0 +1,32 @@
+import { type HTMLAttributes } from 'react';
+/** A space value: a `--tz-space-*` scale key, a raw number (px), or any CSS length string. */
+export type Spacing = 'xxs' | 'xs' | 'sm' | 'md' | 'lg' | 'xl' | 'xxl' | number | (string & {});
+export type FlexDirection = 'row' | 'column';
+export type FlexAlign = 'start' | 'center' | 'end' | 'stretch' | 'baseline';
+export type FlexJustify = 'start' | 'center' | 'end' | 'between' | 'around' | 'evenly';
+/** Resolve a `Spacing` to a CSS value — scale key → token, number → px, else passthrough. */
+export declare function space(value?: Spacing): string | undefined;
+export interface FlexProps extends HTMLAttributes<HTMLDivElement> {
+    /** Main axis. `row` (default) or `column`. */
+    direction?: FlexDirection;
+    /** Gap between children (token key, px number, or CSS value). */
+    gap?: Spacing;
+    /** `align-items`. */
+    align?: FlexAlign;
+    /** `justify-content`. */
+    justify?: FlexJustify;
+    /** Allow children to wrap onto multiple lines. */
+    wrap?: boolean;
+    /** Padding (token key, px number, or CSS value — e.g. `"24px 8px"`). */
+    padding?: Spacing;
+    /** Render as `inline-flex` instead of `flex`. */
+    inline?: boolean;
+    /** The box's own `flex-grow` (when this Flex is itself a flex child). `true` = `1`. */
+    grow?: boolean | number;
+}
+/**
+ * A flexbox layout primitive — set direction/gap/alignment/padding via props instead of inline styles.
+ * `Row` and `Col` are thin presets over it. Spacing accepts `--tz-space-*` keys (`"md"`), raw px
+ * numbers, or any CSS value; consumer `style` still merges last.
+ */
+export declare const Flex: import("react").ForwardRefExoticComponent<FlexProps & import("react").RefAttributes<HTMLDivElement>>;

package/dist/components/Flex/Grid.d.cts

@@ -0,0 +1,28 @@
+import { type HTMLAttributes } from 'react';
+import { type FlexAlign, type Spacing } from './Flex';
+export interface GridProps extends HTMLAttributes<HTMLDivElement> {
+    /** Fixed column count (`repeat(n, minmax(0,1fr))`) or a raw `grid-template-columns` string. */
+    cols?: number | string;
+    /** Responsive columns: every cell at least this wide, auto-fitting to the width (overrides `cols`). */
+    minItemWidth?: Spacing;
+    /**
+     * With `minItemWidth`, use `auto-fill` instead of `auto-fit` — keeps empty tracks at the min width
+     * so a few items stay their natural size rather than stretching to fill the row. Defaults to `false`.
+     */
+    fill?: boolean;
+    /** Gap between cells (token key, px number, or CSS value). */
+    gap?: Spacing;
+    /** `align-items` for the cells. */
+    align?: FlexAlign;
+    /** Padding (token key, px number, or CSS value). */
+    padding?: Spacing;
+    /** Render as `inline-grid`. */
+    inline?: boolean;
+}
+/**
+ * A CSS-grid layout primitive — lay children out in columns via props. Use `cols` for a fixed count
+ * or `minItemWidth` for a responsive grid that auto-fits as many equal columns as fit (collapsing to
+ * one on narrow widths). Spacing accepts `--tz-space-*` keys, px numbers, or any CSS value; consumer
+ * `style` merges last.
+ */
+export declare const Grid: import("react").ForwardRefExoticComponent<GridProps & import("react").RefAttributes<HTMLDivElement>>;

package/dist/components/Flex/Grid.d.ts

@@ -0,0 +1,28 @@
+import { type HTMLAttributes } from 'react';
+import { type FlexAlign, type Spacing } from './Flex';
+export interface GridProps extends HTMLAttributes<HTMLDivElement> {
+    /** Fixed column count (`repeat(n, minmax(0,1fr))`) or a raw `grid-template-columns` string. */
+    cols?: number | string;
+    /** Responsive columns: every cell at least this wide, auto-fitting to the width (overrides `cols`). */
+    minItemWidth?: Spacing;
+    /**
+     * With `minItemWidth`, use `auto-fill` instead of `auto-fit` — keeps empty tracks at the min width
+     * so a few items stay their natural size rather than stretching to fill the row. Defaults to `false`.
+     */
+    fill?: boolean;
+    /** Gap between cells (token key, px number, or CSS value). */
+    gap?: Spacing;
+    /** `align-items` for the cells. */
+    align?: FlexAlign;
+    /** Padding (token key, px number, or CSS value). */
+    padding?: Spacing;
+    /** Render as `inline-grid`. */
+    inline?: boolean;
+}
+/**
+ * A CSS-grid layout primitive — lay children out in columns via props. Use `cols` for a fixed count
+ * or `minItemWidth` for a responsive grid that auto-fits as many equal columns as fit (collapsing to
+ * one on narrow widths). Spacing accepts `--tz-space-*` keys, px numbers, or any CSS value; consumer
+ * `style` merges last.
+ */
+export declare const Grid: import("react").ForwardRefExoticComponent<GridProps & import("react").RefAttributes<HTMLDivElement>>;

package/dist/components/Flex/Row.d.cts

@@ -0,0 +1,8 @@
+import { type FlexProps } from './Flex';
+export interface RowProps extends Omit<FlexProps, 'direction'> {
+}
+/**
+ * A horizontal flex row. `Flex` with `direction="row"` and `align="center"` by default — override
+ * `align`/`gap`/`justify`/`wrap`/`padding` via props.
+ */
+export declare const Row: import("react").ForwardRefExoticComponent<RowProps & import("react").RefAttributes<HTMLDivElement>>;

package/dist/components/Flex/Row.d.ts

@@ -0,0 +1,8 @@
+import { type FlexProps } from './Flex';
+export interface RowProps extends Omit<FlexProps, 'direction'> {
+}
+/**
+ * A horizontal flex row. `Flex` with `direction="row"` and `align="center"` by default — override
+ * `align`/`gap`/`justify`/`wrap`/`padding` via props.
+ */
+export declare const Row: import("react").ForwardRefExoticComponent<RowProps & import("react").RefAttributes<HTMLDivElement>>;

package/dist/components/Flex/index.cjs

@@ -0,0 +1,2 @@
+"use strict";Object.defineProperties(exports,{__esModule:{value:!0},[Symbol.toStringTag]:{value:"Module"}});const e=require("../../Flex-CqL3Ghda.cjs"),r=require("../../Col-R5mAy8T9.cjs"),l=require("../../Grid-Bw95bKkJ.cjs");exports.Flex=e.Flex;exports.default=e.Flex;exports.Col=r.Col;exports.Row=r.Row;exports.Grid=l.Grid;
+//# sourceMappingURL=index.cjs.map

package/dist/components/Flex/index.cjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.cjs","sources":[],"sourcesContent":[],"names":[],"mappings":""}

package/dist/components/Flex/index.d.cts

@@ -0,0 +1,8 @@
+export { Flex, Flex as default } from './Flex';
+export type { FlexProps, FlexDirection, FlexAlign, FlexJustify, Spacing } from './Flex';
+export { Row } from './Row';
+export type { RowProps } from './Row';
+export { Col } from './Col';
+export type { ColProps } from './Col';
+export { Grid } from './Grid';
+export type { GridProps } from './Grid';

package/dist/components/Flex/index.d.ts

@@ -0,0 +1,8 @@
+export { Flex, Flex as default } from './Flex';
+export type { FlexProps, FlexDirection, FlexAlign, FlexJustify, Spacing } from './Flex';
+export { Row } from './Row';
+export type { RowProps } from './Row';
+export { Col } from './Col';
+export type { ColProps } from './Col';
+export { Grid } from './Grid';
+export type { GridProps } from './Grid';

package/dist/components/Flex/index.js

@@ -0,0 +1,11 @@
+import { F as a, F as e } from "../../Flex-Bj3mMF5A.js";
+import { C as f, R as t } from "../../Col-D2TfZKiM.js";
+import { G as l } from "../../Grid-CY-syhTX.js";
+export {
+  f as Col,
+  a as Flex,
+  l as Grid,
+  t as Row,
+  e as default
+};
+//# sourceMappingURL=index.js.map

package/dist/components/Flex/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sources":[],"sourcesContent":[],"names":[],"mappings":";;;"}

package/dist/components/FloatingPanel/FloatingPanel.d.cts

@@ -0,0 +1,39 @@
+import { type CSSProperties, type ReactNode, type RefObject } from 'react';
+export interface FloatingPanelProps {
+    /** Whether the panel is open — gates the portal and drives the enter animation. */
+    open: boolean;
+    /** Ref to the anchor/trigger element the panel is positioned against. */
+    triggerRef: RefObject<HTMLElement | null>;
+    /** Horizontal alignment to the trigger: `start` (default, grows right) or `end` (grows left). */
+    align?: 'start' | 'end';
+    /** Dismiss request: outside-pointerdown (arg = restore focus to the trigger?) or Escape (`true`). */
+    onClose: (refocus: boolean) => void;
+    /** `id` for the panel element — pair with the trigger's `aria-controls`. */
+    id?: string;
+    /** ARIA role for the panel element (e.g. `'dialog'`). Omit for a plain wrapper (e.g. around a listbox). */
+    role?: string;
+    /** Accessible label, paired with `role`. */
+    ariaLabel?: string;
+    /** Trap Tab focus inside the panel + mark it `aria-modal` (for modal dialogs like the date pickers). */
+    trapFocus?: boolean;
+    /** Constrain the panel to the trigger's width (select-like). */
+    matchTriggerWidth?: boolean;
+    /** Fixed panel width (px number or any CSS width). Wins over `matchTriggerWidth`. */
+    width?: number | string;
+    /** Class(es) for the panel element, merged after the shared chrome (layout overrides live here). */
+    className?: string;
+    /** Inline style merged onto the panel (e.g. a custom CSS var). */
+    style?: CSSProperties;
+    /** Panel content. */
+    children: ReactNode;
+}
+/**
+ * The shared floating popover used across the library — `Select` / `MultiSelect`, the date/time
+ * pickers, `ColorPicker`, and the public `Popover`. Wraps `useFloatingPanel` and renders a `<body>`-portaled, viewport-clamped
+ * panel that opens below its trigger (flips above only when it would overflow), locks page scroll while
+ * open, animates in (opacity + translate, keyed off `data-open`/`data-side`), and dismisses on
+ * outside-pointerdown / `Escape`. Optionally **traps Tab focus** (`trapFocus`, for modal dialogs — also
+ * sets `aria-modal`). The forwarded ref points at the panel element, so a consumer can still read it for
+ * blur/focus bookkeeping. Internal (not part of the public component surface).
+ */
+export declare const FloatingPanel: import("react").ForwardRefExoticComponent<FloatingPanelProps & import("react").RefAttributes<HTMLDivElement>>;