@techzyapp/ui-library 1.0.0

package/dist/components/Table/tableFilter.d.ts

@@ -0,0 +1,65 @@
+import type { TableQueryConfig } from '../../theme';
+import type { SelectOption } from '../Select';
+/** Which control + matching logic a filter uses. */
+export type TableFilterType = 'text' | 'number' | 'numberRange' | 'numberRangeSlider' | 'select' | 'multiSelect' | 'boolean' | 'date' | 'dateRange' | 'time' | 'timeRange' | 'dateTime' | 'dateTimeRange';
+/** The value a single filter holds — shape depends on its `type` (see each control). `null` / empty = off. */
+export type TableFilterValue = string | number | boolean | string[] | [number | null, number | null] | [string, string] | null;
+/** A declarative filter definition — like a column, but for the filter panel. */
+export interface TableFilter {
+    /** Field key on the row — the local accessor + the key in the emitted filter state. */
+    key: string;
+    /** Label shown in the filter panel. */
+    label: string;
+    /** The filter's control + matching logic. */
+    type: TableFilterType;
+    /** Options for `select` / `multiSelect`. */
+    options?: SelectOption[];
+    /** Placeholder for the input(s). */
+    placeholder?: string;
+    /**
+     * Param name this filter serializes to in the **server-request** query (`state.query`). Defaults to
+     * `key`. Set it to rename or bake in an operator — e.g. `'name_like'`, `'q'`, `'status'`. Range filters
+     * append the `rangeMin/MaxSuffix` to this.
+     */
+    queryKey?: string;
+    /** `numberRange` slider bounds + step (defaults `0` / `100` / `1`) — set to match the column's data range. */
+    min?: number;
+    max?: number;
+    step?: number;
+    /**
+     * Labels for a `boolean` filter's three radios (defaults `Any` / `Yes` / `No`) — e.g.
+     * `{ any: 'All', yes: 'In stock', no: 'Sold out' }`.
+     */
+    booleanLabels?: {
+        any?: string;
+        yes?: string;
+        no?: string;
+    };
+}
+/** The active filter values, keyed by filter `key`. */
+export type TableFilterState = Record<string, TableFilterValue>;
+/** Whether a filter value is "set" (should actually filter) — an empty string / array / all-null range is off. */
+export declare function isFilterActive(type: TableFilterType, value: TableFilterValue | undefined): boolean;
+/** Number of filters currently set — drives the count badge on the Filters button. */
+export declare function activeFilterCount(filters: TableFilter[], state: TableFilterState): number;
+/**
+ * Filter rows client-side against the active filter values (local mode). A row is kept only when it matches
+ * **every** active filter (AND). Filters that aren't set are skipped, so an empty state returns all rows.
+ * Pure — no React, no mutation.
+ */
+export declare function applyFilters<T>(rows: T[], filters: TableFilter[], state: TableFilterState): T[];
+/**
+ * Serialize the active filters into **server-request** params (folded into `state.query` alongside
+ * page/size/search/sort). Each filter uses its `queryKey ?? key`; scalars emit `param=value`, a
+ * `multiSelect` emits repeated / CSV / indexed params (`multiSelectFormat`), and ranges emit two params
+ * `<param><rangeMinSuffix>` / `<param><rangeMaxSuffix>` (defaults `Min`/`Max`) — only for the set bound.
+ * Config-driven via the shared `TableQueryConfig`; inactive filters are skipped.
+ */
+export declare function buildFilterQuery(filters: TableFilter[], state: TableFilterState, mapping?: TableQueryConfig): URLSearchParams;
+/**
+ * Read the active filter values back out of URL / request params — the **inverse of `buildFilterQuery`** for
+ * the same `mapping` + filter defs (each filter's `queryKey ?? key`, the `multiSelectFormat`, the range
+ * suffixes). Used by `<Table>` to restore URL-synced filters on mount / Back-Forward. Only present params
+ * produce a value; the rest stay unset.
+ */
+export declare function parseFilterQuery(filters: TableFilter[], params: URLSearchParams, mapping?: TableQueryConfig): TableFilterState;

package/dist/components/Tabs/Tabs.d.cts

@@ -0,0 +1,80 @@
+import { type CSSProperties, type ReactNode } from 'react';
+import { type ThemeColor } from '../../theme';
+import { type IconName } from '../../icons/names';
+export type TabsVariant = 'underline' | 'pill';
+export type TabsSize = 'sm' | 'md' | 'lg';
+export type TabsOrientation = 'horizontal' | 'vertical';
+export interface TabItem {
+    /** Unique value — also what's written to the URL query and passed to `onChange`. */
+    value: string;
+    /** Tab label. */
+    label?: ReactNode;
+    /** Accessible name — required for an icon-only tab (no visible `label`); falls back to `value`. */
+    ariaLabel?: string;
+    /** Leading icon — a known `IconName` or any node. */
+    icon?: IconName | ReactNode;
+    /** Disables the tab (not selectable; skipped by keyboard nav). */
+    disabled?: boolean;
+    /** Marks the tab invalid — shows a small **red** dot (e.g. its section failed validation). No full-tab tint. */
+    error?: boolean;
+    /** Small dot indicator in the tab color (e.g. unread / notification). `error` shows a red one instead. */
+    dot?: boolean;
+    /** Count / text indicator (rendered with `Badge`); wins over `dot`. */
+    badge?: number | string;
+    /** Panel content rendered below (or beside) the strip while this tab is active. Optional. */
+    content?: ReactNode;
+}
+export interface TabsProps {
+    /** The tabs. */
+    items: TabItem[];
+    /** Controlled active value. */
+    value?: string;
+    /**
+     * Initial active value (uncontrolled). Falls back to the URL query (when URL sync is active and the
+     * param is present) and otherwise the first enabled tab.
+     */
+    defaultValue?: string;
+    /** Fires with the next active value. */
+    onChange?: (value: string) => void;
+    /**
+     * URL query param name to sync the active tab to (e.g. `'tab'` → `?tab=general`), so a page refresh
+     * restores it. **Defaults to the configured `keys.tabQueryKey` (else `'tab'`)** at the top level, and
+     * `keys.nestedTabQueryKey` (else `'nestedTab'`) for a strip **nested** inside another tab's panel — so
+     * the two don't collide (auto-applied by nesting depth). Every tab strip URL-syncs out of the box.
+     * Pass **`null`** to opt out (state only). For 3+ nesting levels, set distinct keys explicitly.
+     */
+    queryKey?: string | null;
+    /**
+     * Push a history entry on each tab change, so the browser **Back** button returns to the previous
+     * tab. Defaults to `false` — tab changes **replace** the URL, so Back leaves the page instead of
+     * stepping through tabs (and `popstate` still restores a tab when one is in the query).
+     */
+    pushHistory?: boolean;
+    /** Visual style. Defaults to `'underline'`. */
+    variant?: TabsVariant;
+    /** Preset size. Defaults to `'md'`. */
+    size?: TabsSize;
+    /** Theme palette token tinting the active tab. Defaults to `'primary'`. */
+    color?: ThemeColor;
+    /** Strip direction. Defaults to `'horizontal'`. */
+    orientation?: TabsOrientation;
+    /** Stretch the tabs to fill the strip equally (horizontal only). */
+    fullWidth?: boolean;
+    /** Focus the active tab on mount (e.g. when the strip lives inside a popover that just opened). */
+    autoFocus?: boolean;
+    /** Accessible label for the tablist. */
+    'aria-label'?: string;
+    className?: string;
+    style?: CSSProperties;
+}
+/**
+ * A tab strip with optional panels. Data-driven via `items` (each: `label`, `icon`, `disabled`,
+ * `error`, `dot`/`badge` via `Badge`, optional `content`). Controlled (`value` + `onChange`) or
+ * uncontrolled (`defaultValue`). The active tab **syncs to the URL query by default** under
+ * **`queryKey`** (defaults to the configured `keys.tabQueryKey`, else `'tab'` — and `keys.nestedTabQueryKey`,
+ * else `'nestedTab'`, for a strip nested in another tab's panel: `?<queryKey>=<value>`) so a
+ * refresh restores it — pass **`queryKey={null}`** to opt out. Tab changes **replace** the URL by
+ * default (so Back doesn't step through tabs); pass **`pushHistory`** to make Back navigate tabs. Full
+ * keyboard support (Arrows / Home / End, roving tabindex) and `role="tablist"`/`tab`/`tabpanel` a11y.
+ */
+export declare const Tabs: import("react").ForwardRefExoticComponent<TabsProps & import("react").RefAttributes<HTMLDivElement>>;

package/dist/components/Tabs/Tabs.d.ts

@@ -0,0 +1,80 @@
+import { type CSSProperties, type ReactNode } from 'react';
+import { type ThemeColor } from '../../theme';
+import { type IconName } from '../../icons/names';
+export type TabsVariant = 'underline' | 'pill';
+export type TabsSize = 'sm' | 'md' | 'lg';
+export type TabsOrientation = 'horizontal' | 'vertical';
+export interface TabItem {
+    /** Unique value — also what's written to the URL query and passed to `onChange`. */
+    value: string;
+    /** Tab label. */
+    label?: ReactNode;
+    /** Accessible name — required for an icon-only tab (no visible `label`); falls back to `value`. */
+    ariaLabel?: string;
+    /** Leading icon — a known `IconName` or any node. */
+    icon?: IconName | ReactNode;
+    /** Disables the tab (not selectable; skipped by keyboard nav). */
+    disabled?: boolean;
+    /** Marks the tab invalid — shows a small **red** dot (e.g. its section failed validation). No full-tab tint. */
+    error?: boolean;
+    /** Small dot indicator in the tab color (e.g. unread / notification). `error` shows a red one instead. */
+    dot?: boolean;
+    /** Count / text indicator (rendered with `Badge`); wins over `dot`. */
+    badge?: number | string;
+    /** Panel content rendered below (or beside) the strip while this tab is active. Optional. */
+    content?: ReactNode;
+}
+export interface TabsProps {
+    /** The tabs. */
+    items: TabItem[];
+    /** Controlled active value. */
+    value?: string;
+    /**
+     * Initial active value (uncontrolled). Falls back to the URL query (when URL sync is active and the
+     * param is present) and otherwise the first enabled tab.
+     */
+    defaultValue?: string;
+    /** Fires with the next active value. */
+    onChange?: (value: string) => void;
+    /**
+     * URL query param name to sync the active tab to (e.g. `'tab'` → `?tab=general`), so a page refresh
+     * restores it. **Defaults to the configured `keys.tabQueryKey` (else `'tab'`)** at the top level, and
+     * `keys.nestedTabQueryKey` (else `'nestedTab'`) for a strip **nested** inside another tab's panel — so
+     * the two don't collide (auto-applied by nesting depth). Every tab strip URL-syncs out of the box.
+     * Pass **`null`** to opt out (state only). For 3+ nesting levels, set distinct keys explicitly.
+     */
+    queryKey?: string | null;
+    /**
+     * Push a history entry on each tab change, so the browser **Back** button returns to the previous
+     * tab. Defaults to `false` — tab changes **replace** the URL, so Back leaves the page instead of
+     * stepping through tabs (and `popstate` still restores a tab when one is in the query).
+     */
+    pushHistory?: boolean;
+    /** Visual style. Defaults to `'underline'`. */
+    variant?: TabsVariant;
+    /** Preset size. Defaults to `'md'`. */
+    size?: TabsSize;
+    /** Theme palette token tinting the active tab. Defaults to `'primary'`. */
+    color?: ThemeColor;
+    /** Strip direction. Defaults to `'horizontal'`. */
+    orientation?: TabsOrientation;
+    /** Stretch the tabs to fill the strip equally (horizontal only). */
+    fullWidth?: boolean;
+    /** Focus the active tab on mount (e.g. when the strip lives inside a popover that just opened). */
+    autoFocus?: boolean;
+    /** Accessible label for the tablist. */
+    'aria-label'?: string;
+    className?: string;
+    style?: CSSProperties;
+}
+/**
+ * A tab strip with optional panels. Data-driven via `items` (each: `label`, `icon`, `disabled`,
+ * `error`, `dot`/`badge` via `Badge`, optional `content`). Controlled (`value` + `onChange`) or
+ * uncontrolled (`defaultValue`). The active tab **syncs to the URL query by default** under
+ * **`queryKey`** (defaults to the configured `keys.tabQueryKey`, else `'tab'` — and `keys.nestedTabQueryKey`,
+ * else `'nestedTab'`, for a strip nested in another tab's panel: `?<queryKey>=<value>`) so a
+ * refresh restores it — pass **`queryKey={null}`** to opt out. Tab changes **replace** the URL by
+ * default (so Back doesn't step through tabs); pass **`pushHistory`** to make Back navigate tabs. Full
+ * keyboard support (Arrows / Home / End, roving tabindex) and `role="tablist"`/`tab`/`tabpanel` a11y.
+ */
+export declare const Tabs: import("react").ForwardRefExoticComponent<TabsProps & import("react").RefAttributes<HTMLDivElement>>;

package/dist/components/Tabs/index.cjs

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

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

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

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

@@ -0,0 +1,2 @@
+export { Tabs, Tabs as default } from './Tabs';
+export type { TabsProps, TabItem, TabsVariant, TabsSize, TabsOrientation } from './Tabs';

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

@@ -0,0 +1,2 @@
+export { Tabs, Tabs as default } from './Tabs';
+export type { TabsProps, TabItem, TabsVariant, TabsSize, TabsOrientation } from './Tabs';

package/dist/components/Tabs/index.js

@@ -0,0 +1,6 @@
+import { T, T as e } from "../../Tabs--DDM-zKe.js";
+export {
+  T as Tabs,
+  e as default
+};
+//# sourceMappingURL=index.js.map

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

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

package/dist/components/TagsField/TagsField.d.cts

@@ -0,0 +1,47 @@
+import { type InputHTMLAttributes, type ReactNode } from 'react';
+import { type ThemeColor } from '../../theme';
+export type TagsFieldSize = 'sm' | 'md' | 'lg';
+export interface TagsFieldProps extends Omit<InputHTMLAttributes<HTMLInputElement>, 'size' | 'color' | 'value' | 'defaultValue' | 'onChange'> {
+    /** Label rendered above the field. */
+    label?: ReactNode;
+    /** Preset size — control height, font and chips. */
+    size?: TagsFieldSize;
+    /** Marks the field invalid: red border/focus ring and the `helperText` shown in the error color. */
+    error?: boolean;
+    /** Helper / validation text under the field. Adopts the error color while `error`. */
+    helperText?: ReactNode;
+    /** Adds a red asterisk after the label. */
+    required?: boolean;
+    /** Stretches the field to fill its container width. Defaults to `true`. */
+    fullWidth?: boolean;
+    /** Disables the field (no typing, no add/remove). */
+    disabled?: boolean;
+    /** Controlled value — a `string[]` or a `separator`-joined `string` (e.g. `"react;typescript"`). */
+    value?: string[] | string;
+    /** Initial value for uncontrolled use (`string[]` or a joined `string`). */
+    defaultValue?: string[] | string;
+    /** Fires with the next tags, mirroring the input shape: a `string[]`, or a joined `string` when the value is a string. */
+    onChange?: (value: string[] | string) => void;
+    /** Character/string that splits typed & pasted input and joins the value when it's a string. Defaults to `,`. */
+    separator?: string;
+    /** Theme palette token tinting the tag chips. Defaults to `primary`. */
+    color?: ThemeColor;
+    /** Allow the same tag more than once. Off by default (duplicates are ignored). */
+    allowDuplicates?: boolean;
+    /** Placeholder shown in the input while there are no tags. */
+    placeholder?: string;
+    /** Icon for the add button. Defaults to an `Add` icon. */
+    addIcon?: ReactNode;
+    /** Accessible label for the add button. Defaults to `"Add tag"`. */
+    addLabel?: string;
+}
+/**
+ * A tags / token input. Type a value and press **Enter**, the **add button**, or the `separator`
+ * key to commit it as a tag; remove a tag via its chip's delete button (or Backspace on the empty
+ * input). The **`separator`** (default `,`) also splits pasted text, so pasting `"react;typescript"`
+ * (with `separator=";"`) adds both at once. The value accepts — and `onChange` mirrors — **either a
+ * `string[]` or a `separator`-joined `string`**, so it binds to a `<Form>` schema of either shape.
+ * Shares TextField's chrome (label, helper/error, sizes, `<Form>` binding by `name` for validation).
+ * Controlled (`value` + `onChange`) or uncontrolled (`defaultValue`). Token-only styling.
+ */
+export declare const TagsField: import("react").ForwardRefExoticComponent<TagsFieldProps & import("react").RefAttributes<HTMLInputElement>>;

package/dist/components/TagsField/TagsField.d.ts

@@ -0,0 +1,47 @@
+import { type InputHTMLAttributes, type ReactNode } from 'react';
+import { type ThemeColor } from '../../theme';
+export type TagsFieldSize = 'sm' | 'md' | 'lg';
+export interface TagsFieldProps extends Omit<InputHTMLAttributes<HTMLInputElement>, 'size' | 'color' | 'value' | 'defaultValue' | 'onChange'> {
+    /** Label rendered above the field. */
+    label?: ReactNode;
+    /** Preset size — control height, font and chips. */
+    size?: TagsFieldSize;
+    /** Marks the field invalid: red border/focus ring and the `helperText` shown in the error color. */
+    error?: boolean;
+    /** Helper / validation text under the field. Adopts the error color while `error`. */
+    helperText?: ReactNode;
+    /** Adds a red asterisk after the label. */
+    required?: boolean;
+    /** Stretches the field to fill its container width. Defaults to `true`. */
+    fullWidth?: boolean;
+    /** Disables the field (no typing, no add/remove). */
+    disabled?: boolean;
+    /** Controlled value — a `string[]` or a `separator`-joined `string` (e.g. `"react;typescript"`). */
+    value?: string[] | string;
+    /** Initial value for uncontrolled use (`string[]` or a joined `string`). */
+    defaultValue?: string[] | string;
+    /** Fires with the next tags, mirroring the input shape: a `string[]`, or a joined `string` when the value is a string. */
+    onChange?: (value: string[] | string) => void;
+    /** Character/string that splits typed & pasted input and joins the value when it's a string. Defaults to `,`. */
+    separator?: string;
+    /** Theme palette token tinting the tag chips. Defaults to `primary`. */
+    color?: ThemeColor;
+    /** Allow the same tag more than once. Off by default (duplicates are ignored). */
+    allowDuplicates?: boolean;
+    /** Placeholder shown in the input while there are no tags. */
+    placeholder?: string;
+    /** Icon for the add button. Defaults to an `Add` icon. */
+    addIcon?: ReactNode;
+    /** Accessible label for the add button. Defaults to `"Add tag"`. */
+    addLabel?: string;
+}
+/**
+ * A tags / token input. Type a value and press **Enter**, the **add button**, or the `separator`
+ * key to commit it as a tag; remove a tag via its chip's delete button (or Backspace on the empty
+ * input). The **`separator`** (default `,`) also splits pasted text, so pasting `"react;typescript"`
+ * (with `separator=";"`) adds both at once. The value accepts — and `onChange` mirrors — **either a
+ * `string[]` or a `separator`-joined `string`**, so it binds to a `<Form>` schema of either shape.
+ * Shares TextField's chrome (label, helper/error, sizes, `<Form>` binding by `name` for validation).
+ * Controlled (`value` + `onChange`) or uncontrolled (`defaultValue`). Token-only styling.
+ */
+export declare const TagsField: import("react").ForwardRefExoticComponent<TagsFieldProps & import("react").RefAttributes<HTMLInputElement>>;

package/dist/components/TagsField/index.cjs

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

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

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

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

@@ -0,0 +1,2 @@
+export { TagsField, TagsField as default } from './TagsField';
+export type { TagsFieldProps, TagsFieldSize } from './TagsField';

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

@@ -0,0 +1,2 @@
+export { TagsField, TagsField as default } from './TagsField';
+export type { TagsFieldProps, TagsFieldSize } from './TagsField';

package/dist/components/TagsField/index.js

@@ -0,0 +1,6 @@
+import { T as s, T } from "../../TagsField-BTJcZS9P.js";
+export {
+  s as TagsField,
+  T as default
+};
+//# sourceMappingURL=index.js.map

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

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

package/dist/components/TextField/TextField.d.cts

@@ -0,0 +1,62 @@
+import { type InputHTMLAttributes, type MouseEvent, type ReactNode } from 'react';
+export type TextFieldSize = 'sm' | 'md' | 'lg';
+export type TextFieldAdornmentPosition = 'left' | 'right';
+/** Password-strength buckets surfaced by the `passwordStrength` meter. */
+export type PasswordStrength = 'weak' | 'medium' | 'strong';
+export interface TextFieldProps extends Omit<InputHTMLAttributes<HTMLInputElement>, 'size' | 'prefix'> {
+    /** Label rendered above the field. */
+    label?: ReactNode;
+    /** Preset size — drives the control height (`--tz-control-height-*`), font size and padding. */
+    size?: TextFieldSize;
+    /** Marks the field invalid: red border/focus ring and the `helperText` shown in the error color. */
+    error?: boolean;
+    /** Helper / validation text under the field. Adopts the error color while `error`. */
+    helperText?: ReactNode;
+    /** Adds a red asterisk after the label (visual hint only — combine with native `required` if needed). */
+    required?: boolean;
+    /** Stretches the field to fill its container width. Defaults to `true`. */
+    fullWidth?: boolean;
+    /**
+     * Content shown inside the field. A **string/number** renders as a muted prefix/suffix
+     * (e.g. `"https://"`, `"$"`, `"kg"`); any other node renders as an icon (typically an `<Icon />`)
+     * inside a square `IconButton` box.
+     */
+    adornment?: ReactNode;
+    /** Which side the adornment sits on. Defaults to `left`. */
+    adornmentPosition?: TextFieldAdornmentPosition;
+    /** Makes an icon adornment a clickable `IconButton` and fires this on click (ignored for string adornments). */
+    onAdornmentClick?: (event: MouseEvent<HTMLButtonElement>) => void;
+    /** Accessible label for the clickable icon adornment (used when `onAdornmentClick` is set). Defaults to `"Field action"`. */
+    adornmentLabel?: string;
+    /** Allowed-input filter: a change whose value fails this pattern is rejected (e.g. `/^\d*$/` for digits only). */
+    regex?: RegExp;
+    /** Input mask, e.g. `"(999) 999-9999"` (`9` digit · `a` letter · `*` alphanumeric · other chars literal). Emits the masked value. */
+    mask?: string;
+    /**
+     * For `type="password"`: show the built-in show/hide reveal toggle in the right adornment slot.
+     * Defaults to `true`. Set `false` to drop it (e.g. to use your own right adornment instead).
+     */
+    passwordToggle?: boolean;
+    /**
+     * Show a "Caps Lock is on" warning under the field while it's focused and Caps Lock is active.
+     * Detected from key events, so it appears once the user starts typing. Defaults to `false`.
+     */
+    capsLockWarning?: boolean;
+    /**
+     * Show a password-strength meter (segmented bar + label) under the field, derived from the current
+     * value. A UX hint only — not a security check. Defaults to `false` (best paired with `type="password"`).
+     */
+    passwordStrength?: boolean;
+}
+/**
+ * A labeled text input. Renders an optional label and helper/validation text, an
+ * error state (red border + helper), and an optional `adornment` on either side —
+ * a string prefix/suffix (e.g. `"https://"`) or an icon, which can be made
+ * interactive via `onAdornmentClick`. Supports an allowed-input `regex` filter and
+ * a formatting `mask`. Works controlled (`value` + `onChange`) or uncontrolled
+ * (`defaultValue`); when a `mask` is set, `onChange` emits the masked value. Passing
+ * `type="password"` automatically adds a show/hide reveal toggle in the right adornment
+ * slot. Inside a `<Form>`, a `name` prop auto-binds value/validation from the form (no need to
+ * spread `field()`). Styling comes entirely from `--tz-*` tokens.
+ */
+export declare const TextField: import("react").ForwardRefExoticComponent<TextFieldProps & import("react").RefAttributes<HTMLInputElement>>;

package/dist/components/TextField/TextField.d.ts

@@ -0,0 +1,62 @@
+import { type InputHTMLAttributes, type MouseEvent, type ReactNode } from 'react';
+export type TextFieldSize = 'sm' | 'md' | 'lg';
+export type TextFieldAdornmentPosition = 'left' | 'right';
+/** Password-strength buckets surfaced by the `passwordStrength` meter. */
+export type PasswordStrength = 'weak' | 'medium' | 'strong';
+export interface TextFieldProps extends Omit<InputHTMLAttributes<HTMLInputElement>, 'size' | 'prefix'> {
+    /** Label rendered above the field. */
+    label?: ReactNode;
+    /** Preset size — drives the control height (`--tz-control-height-*`), font size and padding. */
+    size?: TextFieldSize;
+    /** Marks the field invalid: red border/focus ring and the `helperText` shown in the error color. */
+    error?: boolean;
+    /** Helper / validation text under the field. Adopts the error color while `error`. */
+    helperText?: ReactNode;
+    /** Adds a red asterisk after the label (visual hint only — combine with native `required` if needed). */
+    required?: boolean;
+    /** Stretches the field to fill its container width. Defaults to `true`. */
+    fullWidth?: boolean;
+    /**
+     * Content shown inside the field. A **string/number** renders as a muted prefix/suffix
+     * (e.g. `"https://"`, `"$"`, `"kg"`); any other node renders as an icon (typically an `<Icon />`)
+     * inside a square `IconButton` box.
+     */
+    adornment?: ReactNode;
+    /** Which side the adornment sits on. Defaults to `left`. */
+    adornmentPosition?: TextFieldAdornmentPosition;
+    /** Makes an icon adornment a clickable `IconButton` and fires this on click (ignored for string adornments). */
+    onAdornmentClick?: (event: MouseEvent<HTMLButtonElement>) => void;
+    /** Accessible label for the clickable icon adornment (used when `onAdornmentClick` is set). Defaults to `"Field action"`. */
+    adornmentLabel?: string;
+    /** Allowed-input filter: a change whose value fails this pattern is rejected (e.g. `/^\d*$/` for digits only). */
+    regex?: RegExp;
+    /** Input mask, e.g. `"(999) 999-9999"` (`9` digit · `a` letter · `*` alphanumeric · other chars literal). Emits the masked value. */
+    mask?: string;
+    /**
+     * For `type="password"`: show the built-in show/hide reveal toggle in the right adornment slot.
+     * Defaults to `true`. Set `false` to drop it (e.g. to use your own right adornment instead).
+     */
+    passwordToggle?: boolean;
+    /**
+     * Show a "Caps Lock is on" warning under the field while it's focused and Caps Lock is active.
+     * Detected from key events, so it appears once the user starts typing. Defaults to `false`.
+     */
+    capsLockWarning?: boolean;
+    /**
+     * Show a password-strength meter (segmented bar + label) under the field, derived from the current
+     * value. A UX hint only — not a security check. Defaults to `false` (best paired with `type="password"`).
+     */
+    passwordStrength?: boolean;
+}
+/**
+ * A labeled text input. Renders an optional label and helper/validation text, an
+ * error state (red border + helper), and an optional `adornment` on either side —
+ * a string prefix/suffix (e.g. `"https://"`) or an icon, which can be made
+ * interactive via `onAdornmentClick`. Supports an allowed-input `regex` filter and
+ * a formatting `mask`. Works controlled (`value` + `onChange`) or uncontrolled
+ * (`defaultValue`); when a `mask` is set, `onChange` emits the masked value. Passing
+ * `type="password"` automatically adds a show/hide reveal toggle in the right adornment
+ * slot. Inside a `<Form>`, a `name` prop auto-binds value/validation from the form (no need to
+ * spread `field()`). Styling comes entirely from `--tz-*` tokens.
+ */
+export declare const TextField: import("react").ForwardRefExoticComponent<TextFieldProps & import("react").RefAttributes<HTMLInputElement>>;

package/dist/components/TextField/index.cjs

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

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

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

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

@@ -0,0 +1,2 @@
+export { TextField, TextField as default } from './TextField';
+export type { TextFieldProps, TextFieldSize, TextFieldAdornmentPosition, PasswordStrength, } from './TextField';

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

@@ -0,0 +1,2 @@
+export { TextField, TextField as default } from './TextField';
+export type { TextFieldProps, TextFieldSize, TextFieldAdornmentPosition, PasswordStrength, } from './TextField';

package/dist/components/TextField/index.js

@@ -0,0 +1,6 @@
+import { T as t, T } from "../../TextField-DMI1X09n.js";
+export {
+  t as TextField,
+  T as default
+};
+//# sourceMappingURL=index.js.map

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

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

package/dist/components/ThemeToggle/ThemeToggle.d.cts

@@ -0,0 +1,9 @@
+import { type IconButtonProps } from '../IconButton';
+/** Inherits `IconButton`'s look (variant, color, size); the icon and toggle behavior are built in. */
+export type ThemeToggleProps = Omit<IconButtonProps, 'children'>;
+/**
+ * A one-tap color-theme switch. Renders an `IconButton` showing the `Sun` icon
+ * in light mode and the `Moon` icon in dark mode, and flips `mode` on click.
+ * Styling comes from `IconButton`, so `variant`, `color` and `size` pass through.
+ */
+export declare const ThemeToggle: import("react").ForwardRefExoticComponent<ThemeToggleProps & import("react").RefAttributes<HTMLButtonElement>>;

package/dist/components/ThemeToggle/ThemeToggle.d.ts

@@ -0,0 +1,9 @@
+import { type IconButtonProps } from '../IconButton';
+/** Inherits `IconButton`'s look (variant, color, size); the icon and toggle behavior are built in. */
+export type ThemeToggleProps = Omit<IconButtonProps, 'children'>;
+/**
+ * A one-tap color-theme switch. Renders an `IconButton` showing the `Sun` icon
+ * in light mode and the `Moon` icon in dark mode, and flips `mode` on click.
+ * Styling comes from `IconButton`, so `variant`, `color` and `size` pass through.
+ */
+export declare const ThemeToggle: import("react").ForwardRefExoticComponent<ThemeToggleProps & import("react").RefAttributes<HTMLButtonElement>>;

package/dist/components/ThemeToggle/index.cjs

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

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

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

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

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

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

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

package/dist/components/ThemeToggle/index.js

@@ -0,0 +1,6 @@
+import { T as a, T as o } from "../../ThemeToggle-Deh9j8pm.js";
+export {
+  a as ThemeToggle,
+  o as default
+};
+//# sourceMappingURL=index.js.map

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

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