@techzyapp/ui-library 1.0.27 → 1.0.29

package/dist/components/OptionMenu/useOptionMenu.d.ts

@@ -0,0 +1,81 @@
+import { type KeyboardEvent, type RefObject } from 'react';
+import type { ReactNode } from 'react';
+import type { IconName } from '../../icons/names';
+/** A single selectable option — shared by `Select`, `MultiSelect` and `PhoneField`. */
+export interface SelectOption {
+    /** The value committed when this option is chosen. */
+    value: string;
+    /** Display + search text. */
+    label: string;
+    /** Greys out and blocks selecting this option. */
+    disabled?: boolean;
+    /** Leading icon — a known `IconName` (rendered as `<Icon>`) or any node. */
+    icon?: IconName | ReactNode;
+    /**
+     * Extra search terms matched alongside the label (case-insensitive, substring) — e.g. a currency's
+     * code (`'USD'`) or a country's calling code (`'995'`). Never shown.
+     */
+    keywords?: readonly string[];
+    /** Content on the right of the row, before the selected tick (e.g. a code or a count). */
+    trailing?: ReactNode;
+    /**
+     * Group heading. Options sharing a `group` are listed together under it (groups in order of first
+     * appearance, options keeping their order within a group); options without one stay ungrouped.
+     */
+    group?: string;
+}
+/**
+ * Stable-group the options: each group gathered at its first appearance, order kept within a group. A
+ * list with no `group` at all is returned untouched (the common case costs nothing).
+ */
+export declare function groupOptions<T extends SelectOption>(options: readonly T[]): readonly T[];
+export interface UseOptionMenuOptions {
+    /** Base for the listbox / option ids (`${idBase}-listbox`, `${idBase}-opt-${i}`). */
+    idBase: string;
+    options: readonly SelectOption[];
+    /** Whether an option is selected (drives the initial highlight when `highlightSelected`). */
+    isSelected: (option: SelectOption) => boolean;
+    /** Called when an option is picked (Enter / Space / click). */
+    onPick: (option: SelectOption) => void;
+    /** Close the menu after a pick (single-select) or keep it open (multi-select). Defaults to `true`. */
+    closeOnPick?: boolean;
+    /** On open, highlight the selected option (single-select) instead of the first. Defaults to `true`. */
+    highlightSelected?: boolean;
+    /** Show a search box that filters by label + keywords. */
+    searchable?: boolean;
+    /** The consumer filters `options` itself (server-side search) — skip the local filter. */
+    onSearchChange?: (query: string) => void;
+    disabled?: boolean;
+    /** The element focus returns to when the menu closes with `refocus` (the trigger / the input). */
+    focusRef: RefObject<HTMLElement | null>;
+    /** Runs on every close (e.g. mark a form field touched). */
+    onClose?: () => void;
+}
+/**
+ * The state + keyboard model behind every option popover (internal): open / close, the search query
+ * and its label + keywords filter, the highlighted row (skipping disabled ones), type-ahead when not
+ * searchable, and one `handleKeyDown` for the trigger and the search box — Arrow / Home / End move,
+ * Enter / Space pick, Escape closes (refocusing), Tab closes and moves on. Render it with `OptionMenu`.
+ */
+export declare function useOptionMenu({ idBase, options, isSelected, onPick, closeOnPick, highlightSelected, searchable, onSearchChange, disabled, focusRef, onClose, }: UseOptionMenuOptions): {
+    open: boolean;
+    openMenu: () => void;
+    closeMenu: (refocus: boolean) => void;
+    toggleMenu: () => void;
+    searchable: boolean;
+    searchQuery: string;
+    setSearchQuery: (query: string) => void;
+    filteredOptions: readonly SelectOption[];
+    highlightedIndex: number;
+    setHighlightedIndex: import("react").Dispatch<import("react").SetStateAction<number>>;
+    isSelected: (option: SelectOption) => boolean;
+    pick: (option: SelectOption | undefined) => void;
+    handleKeyDown: (event: KeyboardEvent) => void;
+    listboxId: string;
+    optionId: (index: number) => string;
+    activeId: string | undefined;
+    searchInputRef: RefObject<HTMLInputElement | null>;
+    popoverRef: RefObject<HTMLDivElement | null>;
+};
+/** Everything `useOptionMenu` returns — pass it to `<OptionMenu menu={…} />`. */
+export type OptionMenuState = ReturnType<typeof useOptionMenu>;

package/dist/components/OtpField/index.cjs

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

package/dist/components/OtpField/index.js

@@ -1,4 +1,4 @@
-import { O as t, O } from "../../OtpField-CpQr_ZqL.js";
+import { O as t, O } from "../../OtpField-CMoJqcx1.js";
 export {
   t as OtpField,
   O as default

package/dist/components/PageLayout/index.cjs

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

package/dist/components/PageLayout/index.js

@@ -1,4 +1,4 @@
-import { P as o, P as t } from "../../PageLayout-CCcPCfJF.js";
+import { P as o, P as t } from "../../PageLayout-Ctr-IEzX.js";
 export {
   o as PageLayout,
   t as default

package/dist/components/PageNotFound/PageNotFound.d.cts

@@ -1,7 +1,7 @@
 import { type HTMLAttributes, type ReactNode } from 'react';
 import { type EmptyStateSize } from '../EmptyState';
 import type { IconName } from '../../icons/names';
-export interface PageNotFoundProps extends Omit<HTMLAttributes<HTMLDivElement>, 'title'> {
+export interface PageNotFoundProps extends Omit<HTMLAttributes<HTMLDivElement>, 'title' | 'color'> {
     /** Hero glyph — an `IconName`, any node, or `false` to hide it. Defaults to `SearchStatus`. */
     icon?: IconName | ReactNode | false;
     /** Heading. Defaults to the localized `notFound.title`. */

package/dist/components/PageNotFound/PageNotFound.d.ts

@@ -1,7 +1,7 @@
 import { type HTMLAttributes, type ReactNode } from 'react';
 import { type EmptyStateSize } from '../EmptyState';
 import type { IconName } from '../../icons/names';
-export interface PageNotFoundProps extends Omit<HTMLAttributes<HTMLDivElement>, 'title'> {
+export interface PageNotFoundProps extends Omit<HTMLAttributes<HTMLDivElement>, 'title' | 'color'> {
     /** Hero glyph — an `IconName`, any node, or `false` to hide it. Defaults to `SearchStatus`. */
     icon?: IconName | ReactNode | false;
     /** Heading. Defaults to the localized `notFound.title`. */

package/dist/components/PageNotFound/index.cjs

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

package/dist/components/PageNotFound/index.js

@@ -1,4 +1,4 @@
-import { P as e, P as t } from "../../PageNotFound-LWH2tU5E.js";
+import { P as e, P as t } from "../../PageNotFound-KKJTeaRF.js";
 export {
   e as PageNotFound,
   t as default

package/dist/components/Pagination/index.cjs

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

package/dist/components/Pagination/index.js

@@ -1,4 +1,4 @@
-import { P as t, P } from "../../Pagination-BwtbmITJ.js";
+import { P as t, P } from "../../Pagination-Oyms2ERd.js";
 export {
   t as Pagination,
   P as default

package/dist/components/PaletteField/index.cjs

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

package/dist/components/PaletteField/index.js

@@ -1,4 +1,4 @@
-import { P as t, P as l } from "../../PaletteField-CUyzLrny.js";
+import { P as t, P as l } from "../../PaletteField-BHzzzdou.js";
 export {
   t as PaletteField,
   l as default

package/dist/components/PhoneField/PhoneField.d.cts

@@ -0,0 +1,54 @@
+import { type InputHTMLAttributes, type ReactNode } from 'react';
+import { type PhoneCountry, type PhoneFormat } from './phone';
+export type PhoneFieldSize = 'sm' | 'md' | 'lg';
+/** Extra details handed to `onChange` alongside the E.164 value. */
+export interface PhoneFieldChangeMeta {
+    /** The number's country (ISO alpha-2). */
+    country: PhoneCountry;
+    /** The national significant number — digits only, no trunk `0`. */
+    national: string;
+    /** A complete, valid number for that country. */
+    valid: boolean;
+}
+export interface PhoneFieldProps extends Omit<InputHTMLAttributes<HTMLInputElement>, 'value' | 'defaultValue' | 'onChange' | 'type' | 'size' | 'color'> {
+    /** The number in **E.164** (`'+995555123456'`) — the only form the field emits. `''` when empty. */
+    value?: string;
+    /** Initial E.164 value for uncontrolled use. */
+    defaultValue?: string;
+    /** Fires with the E.164 value (`''` when cleared) and `{ country, national, valid }`. */
+    onChange?: (value: string, meta: PhoneFieldChangeMeta) => void;
+    /** The country to start with. Defaults to one derived from the UI language / browser locale. */
+    defaultCountry?: PhoneCountry;
+    /** Restrict the selectable countries (e.g. only where you operate). Defaults to all. */
+    countries?: readonly PhoneCountry[];
+    /** Countries pinned to the top of the list, in this order. */
+    preferredCountries?: readonly PhoneCountry[];
+    /**
+     * How the number reads while typing — `national` (default: `555 12 34 56`, the calling code lives in
+     * the country button) or `international` (`+995 555 12 34 56`). The value is E.164 either way.
+     */
+    format?: PhoneFormat;
+    /** Field label. */
+    label?: ReactNode;
+    /** Helper / validation text under the field. */
+    helperText?: ReactNode;
+    /** Error state (red border + helper). */
+    error?: boolean;
+    /** Shows a required asterisk. */
+    required?: boolean;
+    /** `sm` / `md` / `lg` — control height + type. Defaults to `md`. */
+    size?: PhoneFieldSize;
+    /** Stretch to the container. Defaults to `true`. */
+    fullWidth?: boolean;
+}
+/**
+ * A phone-number field: a **country button** (flag + `+code`, opening a searchable, localized country
+ * list) inside the input frame, and the number **formatted as you type** for that country. The value is
+ * always **E.164** (`'+995555123456'`) — one canonical form for the backend. Typing or pasting `+44…`
+ * switches the country by its calling code. `onChange(value, { country, national, valid })`; binds to a
+ * `<Form>` by `name` (the form value is the E.164 string — validate with `isValidPhone`). Country names
+ * come from `Intl.DisplayNames` in the active UI language; flags are emoji. Needs the optional peer
+ * **`libphonenumber-js`** (formatting, parsing, validation metadata), loaded lazily on first mount — until
+ * it's ready (or if it isn't installed) a disabled look-alike field renders. Reuses the `TextField` look.
+ */
+export declare const PhoneField: import("react").ForwardRefExoticComponent<PhoneFieldProps & import("react").RefAttributes<HTMLInputElement>>;

package/dist/components/PhoneField/PhoneField.d.ts

@@ -0,0 +1,54 @@
+import { type InputHTMLAttributes, type ReactNode } from 'react';
+import { type PhoneCountry, type PhoneFormat } from './phone';
+export type PhoneFieldSize = 'sm' | 'md' | 'lg';
+/** Extra details handed to `onChange` alongside the E.164 value. */
+export interface PhoneFieldChangeMeta {
+    /** The number's country (ISO alpha-2). */
+    country: PhoneCountry;
+    /** The national significant number — digits only, no trunk `0`. */
+    national: string;
+    /** A complete, valid number for that country. */
+    valid: boolean;
+}
+export interface PhoneFieldProps extends Omit<InputHTMLAttributes<HTMLInputElement>, 'value' | 'defaultValue' | 'onChange' | 'type' | 'size' | 'color'> {
+    /** The number in **E.164** (`'+995555123456'`) — the only form the field emits. `''` when empty. */
+    value?: string;
+    /** Initial E.164 value for uncontrolled use. */
+    defaultValue?: string;
+    /** Fires with the E.164 value (`''` when cleared) and `{ country, national, valid }`. */
+    onChange?: (value: string, meta: PhoneFieldChangeMeta) => void;
+    /** The country to start with. Defaults to one derived from the UI language / browser locale. */
+    defaultCountry?: PhoneCountry;
+    /** Restrict the selectable countries (e.g. only where you operate). Defaults to all. */
+    countries?: readonly PhoneCountry[];
+    /** Countries pinned to the top of the list, in this order. */
+    preferredCountries?: readonly PhoneCountry[];
+    /**
+     * How the number reads while typing — `national` (default: `555 12 34 56`, the calling code lives in
+     * the country button) or `international` (`+995 555 12 34 56`). The value is E.164 either way.
+     */
+    format?: PhoneFormat;
+    /** Field label. */
+    label?: ReactNode;
+    /** Helper / validation text under the field. */
+    helperText?: ReactNode;
+    /** Error state (red border + helper). */
+    error?: boolean;
+    /** Shows a required asterisk. */
+    required?: boolean;
+    /** `sm` / `md` / `lg` — control height + type. Defaults to `md`. */
+    size?: PhoneFieldSize;
+    /** Stretch to the container. Defaults to `true`. */
+    fullWidth?: boolean;
+}
+/**
+ * A phone-number field: a **country button** (flag + `+code`, opening a searchable, localized country
+ * list) inside the input frame, and the number **formatted as you type** for that country. The value is
+ * always **E.164** (`'+995555123456'`) — one canonical form for the backend. Typing or pasting `+44…`
+ * switches the country by its calling code. `onChange(value, { country, national, valid })`; binds to a
+ * `<Form>` by `name` (the form value is the E.164 string — validate with `isValidPhone`). Country names
+ * come from `Intl.DisplayNames` in the active UI language; flags are emoji. Needs the optional peer
+ * **`libphonenumber-js`** (formatting, parsing, validation metadata), loaded lazily on first mount — until
+ * it's ready (or if it isn't installed) a disabled look-alike field renders. Reuses the `TextField` look.
+ */
+export declare const PhoneField: import("react").ForwardRefExoticComponent<PhoneFieldProps & import("react").RefAttributes<HTMLInputElement>>;

package/dist/components/PhoneField/index.cjs

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

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

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

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

@@ -0,0 +1,4 @@
+export { PhoneField, PhoneField as default } from './PhoneField';
+export type { PhoneFieldProps, PhoneFieldSize, PhoneFieldChangeMeta } from './PhoneField';
+export { isValidPhone } from './phone';
+export type { PhoneCountry, PhoneFormat } from './phone';

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

@@ -0,0 +1,4 @@
+export { PhoneField, PhoneField as default } from './PhoneField';
+export type { PhoneFieldProps, PhoneFieldSize, PhoneFieldChangeMeta } from './PhoneField';
+export { isValidPhone } from './phone';
+export type { PhoneCountry, PhoneFormat } from './phone';

package/dist/components/PhoneField/index.js

@@ -0,0 +1,7 @@
+import { P as i, P as o, i as s } from "../../PhoneField-CBfmChPx.js";
+export {
+  i as PhoneField,
+  o as default,
+  s as isValidPhone
+};
+//# sourceMappingURL=index.js.map

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

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

package/dist/components/PhoneField/phone.d.cts

@@ -0,0 +1,50 @@
+import type * as PhoneLibModule from 'libphonenumber-js';
+import type { CountryCode } from 'libphonenumber-js';
+/**
+ * `libphonenumber-js` is an optional peer, loaded **lazily** (see `optionalPeer`) — never imported
+ * statically, so apps that don't install it still build + run when they import the barrel. PhoneField
+ * waits for it on mount; the helpers below run only once it's loaded (`lib()`).
+ */
+export declare const phonePeer: import("../../hooks/useOptionalPeer").OptionalPeer<typeof PhoneLibModule>;
+/** An ISO-3166 alpha-2 country code, as `libphonenumber-js` knows it (`'GE'`, `'US'`, …). */
+export type PhoneCountry = CountryCode;
+/** How the number is shown in the input while typing (the value is always E.164). */
+export type PhoneFormat = 'national' | 'international';
+/** Every country `libphonenumber-js` has metadata for (once loaded). */
+export declare function getPhoneCountries(): readonly PhoneCountry[];
+/** The country's calling code without the `+` — `'GE'` → `'995'`. */
+export declare const callingCodeOf: (country: PhoneCountry) => string;
+/**
+ * `true` for a complete, valid number (E.164 or any parseable international form). Use it in a schema:
+ * `phone: z.string().refine(isValidPhone, 'Enter a valid phone number')`. Needs `libphonenumber-js`
+ * loaded — it is once any PhoneField has mounted; before that it starts the load and returns `false`.
+ */
+export declare function isValidPhone(value: unknown): boolean;
+/** A flag emoji from the two regional-indicator letters — no image assets (Windows shows the letters). */
+export declare function flagEmoji(country: string): string;
+/** The country's name in `locale` via `Intl.DisplayNames` (no catalog to ship); falls back to the code. */
+export declare function countryName(country: string, locale: string): string;
+/** The default country: the locale's region → its language's usual country → the browser's region → US. */
+export declare function detectCountry(locale: string, allowed: readonly PhoneCountry[]): PhoneCountry;
+/** The result of reading what's in the input. */
+export interface PhoneReading {
+    /** The canonical value — `'+995555123456'`, or `''` when empty. */
+    e164: string;
+    /** The country the number belongs to (may switch when a `+code` is typed). */
+    country: PhoneCountry;
+    /** The national significant number — digits only, no trunk `0`. */
+    national: string;
+    /** A complete, valid number. */
+    valid: boolean;
+    /** What the input should show (formatted as you type). */
+    display: string;
+}
+/** Read raw input text → the canonical value + the formatted display, as the user types. */
+export declare function readPhoneInput(raw: string, country: PhoneCountry, format: PhoneFormat, allowed: readonly PhoneCountry[]): PhoneReading;
+/** Derive the country + display from an E.164 value (initial / external value changes). */
+export declare function phoneFromValue(value: string, fallback: PhoneCountry, format: PhoneFormat, allowed: readonly PhoneCountry[]): {
+    country: PhoneCountry;
+    display: string;
+};
+/** Caret index in `display` right after its `n`-th digit — keeps the caret put while reformatting. */
+export declare function caretAfterDigits(display: string, n: number): number;

package/dist/components/PhoneField/phone.d.ts

@@ -0,0 +1,50 @@
+import type * as PhoneLibModule from 'libphonenumber-js';
+import type { CountryCode } from 'libphonenumber-js';
+/**
+ * `libphonenumber-js` is an optional peer, loaded **lazily** (see `optionalPeer`) — never imported
+ * statically, so apps that don't install it still build + run when they import the barrel. PhoneField
+ * waits for it on mount; the helpers below run only once it's loaded (`lib()`).
+ */
+export declare const phonePeer: import("../../hooks/useOptionalPeer").OptionalPeer<typeof PhoneLibModule>;
+/** An ISO-3166 alpha-2 country code, as `libphonenumber-js` knows it (`'GE'`, `'US'`, …). */
+export type PhoneCountry = CountryCode;
+/** How the number is shown in the input while typing (the value is always E.164). */
+export type PhoneFormat = 'national' | 'international';
+/** Every country `libphonenumber-js` has metadata for (once loaded). */
+export declare function getPhoneCountries(): readonly PhoneCountry[];
+/** The country's calling code without the `+` — `'GE'` → `'995'`. */
+export declare const callingCodeOf: (country: PhoneCountry) => string;
+/**
+ * `true` for a complete, valid number (E.164 or any parseable international form). Use it in a schema:
+ * `phone: z.string().refine(isValidPhone, 'Enter a valid phone number')`. Needs `libphonenumber-js`
+ * loaded — it is once any PhoneField has mounted; before that it starts the load and returns `false`.
+ */
+export declare function isValidPhone(value: unknown): boolean;
+/** A flag emoji from the two regional-indicator letters — no image assets (Windows shows the letters). */
+export declare function flagEmoji(country: string): string;
+/** The country's name in `locale` via `Intl.DisplayNames` (no catalog to ship); falls back to the code. */
+export declare function countryName(country: string, locale: string): string;
+/** The default country: the locale's region → its language's usual country → the browser's region → US. */
+export declare function detectCountry(locale: string, allowed: readonly PhoneCountry[]): PhoneCountry;
+/** The result of reading what's in the input. */
+export interface PhoneReading {
+    /** The canonical value — `'+995555123456'`, or `''` when empty. */
+    e164: string;
+    /** The country the number belongs to (may switch when a `+code` is typed). */
+    country: PhoneCountry;
+    /** The national significant number — digits only, no trunk `0`. */
+    national: string;
+    /** A complete, valid number. */
+    valid: boolean;
+    /** What the input should show (formatted as you type). */
+    display: string;
+}
+/** Read raw input text → the canonical value + the formatted display, as the user types. */
+export declare function readPhoneInput(raw: string, country: PhoneCountry, format: PhoneFormat, allowed: readonly PhoneCountry[]): PhoneReading;
+/** Derive the country + display from an E.164 value (initial / external value changes). */
+export declare function phoneFromValue(value: string, fallback: PhoneCountry, format: PhoneFormat, allowed: readonly PhoneCountry[]): {
+    country: PhoneCountry;
+    display: string;
+};
+/** Caret index in `display` right after its `n`-th digit — keeps the caret put while reformatting. */
+export declare function caretAfterDigits(display: string, n: number): number;

package/dist/components/Popconfirm/Popconfirm.d.cts

@@ -0,0 +1,53 @@
+import { type CSSProperties, type ReactElement, type ReactNode } from 'react';
+import { type ThemeColor } from '../../theme';
+import { type IconName } from '../../icons/names';
+import type { PopoverAlign } from '../Popover';
+export interface PopconfirmProps {
+    /** The question — "Delete this item?". Labels the dialog. */
+    title: ReactNode;
+    /** Optional muted line under the title (the consequence). Describes the dialog. */
+    description?: ReactNode;
+    /**
+     * Runs on confirm. Return a Promise to keep the popover open with the confirm button **loading** until
+     * it settles — it closes on success and **stays open on rejection** (show your own toast).
+     */
+    onConfirm: () => unknown;
+    /** Runs on Cancel, `Escape` or an outside click. */
+    onCancel?: () => void;
+    /** Confirm button label. Defaults to the localized "Confirm". */
+    confirmLabel?: ReactNode;
+    /** Cancel button label. Defaults to the localized "Cancel". */
+    cancelLabel?: ReactNode;
+    /** Tints the confirm button and the icon. Defaults to `error` (a destructive action). */
+    color?: ThemeColor;
+    /** Leading icon — a known `IconName`, any node, or `false`. Defaults to `Danger` in the `color`. */
+    icon?: IconName | ReactNode | false;
+    /** Horizontal alignment to the trigger (`start` default, `end` for a trigger near the right edge). */
+    align?: PopoverAlign;
+    /** Controlled open state. */
+    open?: boolean;
+    /** Fires with the next open state. */
+    onOpenChange?: (open: boolean) => void;
+    /** Clicking the trigger does nothing (no popover). */
+    disabled?: boolean;
+    /** Panel width (px number or CSS width). Defaults to `300px`. */
+    width?: number | string;
+    /** Class on the floating panel. */
+    className?: string;
+    /** Style on the floating panel. */
+    style?: CSSProperties;
+    /** The trigger — usually a `Button` / `IconButton`. Cloned to wire the click + ARIA. */
+    children: ReactElement;
+}
+/**
+ * An **inline confirm** for quick, low-risk actions (a row's delete / archive) — a small anchored popover
+ * with a question, an optional description and **Cancel** / **Confirm**, where a `RemoveDialog` modal
+ * would be too heavy and a bare `onClick` too dangerous. Wraps its trigger (`children`), which it clones
+ * to toggle the panel. Built on the shared `FloatingPanel` (portaled, flips, clamps to the viewport,
+ * dismisses on outside click / `Escape` = cancel). A11y: `role="alertdialog"` labelled by the title and
+ * described by the description, focus trapped and **placed on Cancel** (never the destructive button —
+ * the `RemoveDialog` rule), focus returns to the trigger. An async `onConfirm` shows a loading confirm
+ * button (Cancel + dismiss locked meanwhile), closes on success, stays open on failure. The icon sits in a
+ * tinted box, the buttons (`sm`; confirm `contained` in `color`, default `error`) in a Card-style footer. Use `RemoveDialog` for high-risk, context-heavy deletes.
+ */
+export declare function Popconfirm({ title, description, onConfirm, onCancel, confirmLabel, cancelLabel, color, icon, align, open, onOpenChange, disabled, width, className, style, children, }: PopconfirmProps): import("react/jsx-runtime").JSX.Element;

package/dist/components/Popconfirm/Popconfirm.d.ts

@@ -0,0 +1,53 @@
+import { type CSSProperties, type ReactElement, type ReactNode } from 'react';
+import { type ThemeColor } from '../../theme';
+import { type IconName } from '../../icons/names';
+import type { PopoverAlign } from '../Popover';
+export interface PopconfirmProps {
+    /** The question — "Delete this item?". Labels the dialog. */
+    title: ReactNode;
+    /** Optional muted line under the title (the consequence). Describes the dialog. */
+    description?: ReactNode;
+    /**
+     * Runs on confirm. Return a Promise to keep the popover open with the confirm button **loading** until
+     * it settles — it closes on success and **stays open on rejection** (show your own toast).
+     */
+    onConfirm: () => unknown;
+    /** Runs on Cancel, `Escape` or an outside click. */
+    onCancel?: () => void;
+    /** Confirm button label. Defaults to the localized "Confirm". */
+    confirmLabel?: ReactNode;
+    /** Cancel button label. Defaults to the localized "Cancel". */
+    cancelLabel?: ReactNode;
+    /** Tints the confirm button and the icon. Defaults to `error` (a destructive action). */
+    color?: ThemeColor;
+    /** Leading icon — a known `IconName`, any node, or `false`. Defaults to `Danger` in the `color`. */
+    icon?: IconName | ReactNode | false;
+    /** Horizontal alignment to the trigger (`start` default, `end` for a trigger near the right edge). */
+    align?: PopoverAlign;
+    /** Controlled open state. */
+    open?: boolean;
+    /** Fires with the next open state. */
+    onOpenChange?: (open: boolean) => void;
+    /** Clicking the trigger does nothing (no popover). */
+    disabled?: boolean;
+    /** Panel width (px number or CSS width). Defaults to `300px`. */
+    width?: number | string;
+    /** Class on the floating panel. */
+    className?: string;
+    /** Style on the floating panel. */
+    style?: CSSProperties;
+    /** The trigger — usually a `Button` / `IconButton`. Cloned to wire the click + ARIA. */
+    children: ReactElement;
+}
+/**
+ * An **inline confirm** for quick, low-risk actions (a row's delete / archive) — a small anchored popover
+ * with a question, an optional description and **Cancel** / **Confirm**, where a `RemoveDialog` modal
+ * would be too heavy and a bare `onClick` too dangerous. Wraps its trigger (`children`), which it clones
+ * to toggle the panel. Built on the shared `FloatingPanel` (portaled, flips, clamps to the viewport,
+ * dismisses on outside click / `Escape` = cancel). A11y: `role="alertdialog"` labelled by the title and
+ * described by the description, focus trapped and **placed on Cancel** (never the destructive button —
+ * the `RemoveDialog` rule), focus returns to the trigger. An async `onConfirm` shows a loading confirm
+ * button (Cancel + dismiss locked meanwhile), closes on success, stays open on failure. The icon sits in a
+ * tinted box, the buttons (`sm`; confirm `contained` in `color`, default `error`) in a Card-style footer. Use `RemoveDialog` for high-risk, context-heavy deletes.
+ */
+export declare function Popconfirm({ title, description, onConfirm, onCancel, confirmLabel, cancelLabel, color, icon, align, open, onOpenChange, disabled, width, className, style, children, }: PopconfirmProps): import("react/jsx-runtime").JSX.Element;

package/dist/components/Popconfirm/index.cjs

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

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

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

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

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

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

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

package/dist/components/Popconfirm/index.js

@@ -0,0 +1,6 @@
+import { P as f, P as r } from "../../Popconfirm-BtGDhqrc.js";
+export {
+  f as Popconfirm,
+  r as default
+};
+//# sourceMappingURL=index.js.map

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

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

package/dist/components/Popover/index.cjs

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

package/dist/components/Popover/index.js

@@ -1,4 +1,4 @@
-import { P as e, P as r } from "../../Popover-CgIU4Rhg.js";
+import { P as e, P as r } from "../../Popover-B82Id9Ut.js";
 export {
   e as Popover,
   r as default

package/dist/components/Progress/Progress.d.cts

@@ -0,0 +1,50 @@
+import { type HTMLAttributes, type ReactNode } from 'react';
+import { type ThemeColor } from '../../theme';
+export type ProgressVariant = 'linear' | 'circular';
+export type ProgressSize = 'sm' | 'md' | 'lg';
+/** Percentages (0–100) at which the color switches automatically — quota UX. */
+export interface ProgressThresholds {
+    /** From this percentage on, the bar turns `warning`. */
+    warning?: number;
+    /** From this percentage on, the bar turns `error`. */
+    error?: number;
+}
+export interface ProgressProps extends Omit<HTMLAttributes<HTMLDivElement>, 'color'> {
+    /** Current value, `0`–`max`. Omit it for an **indeterminate** progress (a moving bar / spinning arc). */
+    value?: number;
+    /** The value that means "done". Defaults to `100`. */
+    max?: number;
+    /** `linear` (default) — a bar; `circular` — a ring. */
+    variant?: ProgressVariant;
+    /** Linear: bar thickness 4 / 6 / 8 px. Circular: ring 32 / 48 / 64 px. Defaults to `md`. */
+    size?: ProgressSize;
+    /** Theme color of the fill. Defaults to `accent`. */
+    color?: ThemeColor;
+    /** A caption — above the bar (left) for linear, under the ring for circular. Labels the progressbar. */
+    label?: ReactNode;
+    /**
+     * Show the value: `true` → the percentage ("42%"); a function → your own text, e.g.
+     * `(v, max) => `${v} GB of ${max} GB``. Linear: right of the caption; circular: inside the ring.
+     */
+    showValue?: boolean | ((value: number, max: number) => ReactNode);
+    /** A second, lighter bar behind the fill (buffered / pending amount), `0`–`max`. Linear only. */
+    buffer?: number;
+    /** Diagonal stripes on the fill. Linear only. */
+    striped?: boolean;
+    /** Animate the stripes (implies `striped`). Linear only. Off under `prefers-reduced-motion`. */
+    animated?: boolean;
+    /** Switch the color automatically by percentage (e.g. `{ warning: 80, error: 95 }` for a quota). */
+    thresholds?: ProgressThresholds;
+}
+/**
+ * A progress indicator — **linear** (a bar) or **circular** (a ring) — for uploads, wizard steps, quotas and
+ * background jobs. Determinate with `value` / `max`, or **indeterminate** without `value` (a moving bar / a
+ * spinning arc). An optional caption (`label`) and value readout (`showValue` — the percentage or your own
+ * formatter), a lighter `buffer` bar, `striped` / `animated` fills, and `thresholds` that turn the fill
+ * `warning` / `error` as it fills up. Tinted by `color` through the shared `--tz-btn-rgb` pattern; the track is
+ * `primary-shade200`, the bar is pill-rounded (so the global `square` shape flattens it). A11y:
+ * `role="progressbar"` with `aria-valuemin/max/now` + `aria-valuetext`, labelled by the caption (or a
+ * localized "Progress"); indeterminate drops `aria-valuenow` and sets `aria-busy`. Motion stops under
+ * `prefers-reduced-motion`. Token-only. `forwardRef` to the root `<div>`.
+ */
+export declare const Progress: import("react").ForwardRefExoticComponent<ProgressProps & import("react").RefAttributes<HTMLDivElement>>;