@techzyapp/ui-library 1.0.0

package/dist/components/ColorPicker/ColorPickerPanel.d.ts

@@ -0,0 +1,20 @@
+/** A pleasant default palette shown as quick-pick swatches. */
+export declare const DEFAULT_SWATCHES: string[];
+export interface ColorPickerPanelProps {
+    /** Current color — a CSS color string (`#rrggbb`, `rgba(...)`, or `''` when unset). */
+    value: string;
+    /** Fires with the next color: `#rrggbb` when opaque, `rgba(r, g, b, a)` when translucent, `''` when cleared. */
+    onChange: (color: string) => void;
+    /** Quick-pick swatches. Defaults to a curated palette. */
+    swatches?: string[];
+    /** Show the leading "no color" swatch that clears the value. Defaults to `true`. */
+    clearable?: boolean;
+}
+/**
+ * The color-picking surface — a saturation/value square, hue + alpha sliders, a color input and
+ * quick-pick swatches. Controlled by a single color `string` (`value` / `onChange`), so it drops into
+ * any popover. Working state is kept as HSV + alpha (hue survives dragging at grey/black), re-derived
+ * from `value` only on external changes. Used by `ColorPicker` (the field) and the `RichTextEditor`
+ * text-color control. Token-styled except the spectrum gradients + alpha checkerboard (literal colors).
+ */
+export declare function ColorPickerPanel({ value, onChange, swatches, clearable, }: ColorPickerPanelProps): import("react/jsx-runtime").JSX.Element;

package/dist/components/ColorPicker/colorUtils.d.cts

@@ -0,0 +1,44 @@
+/** Color math for the ColorPicker: hex ⇄ rgb ⇄ hsv, plus hex validation. All internal, no deps. */
+export interface HSV {
+    /** Hue 0–360 */
+    h: number;
+    /** Saturation 0–1 */
+    s: number;
+    /** Value/brightness 0–1 */
+    v: number;
+}
+export interface RGB {
+    r: number;
+    g: number;
+    b: number;
+}
+export interface RGBA extends RGB {
+    /** Alpha 0–1 */
+    a: number;
+}
+export declare const clamp01: (n: number) => number;
+/** Normalizes any `#rgb`/`#rrggbb` (with or without `#`) to a lowercase `#rrggbb`, or `null` if invalid. */
+export declare function normalizeHex(input: string): string | null;
+/** True for a complete `#rrggbb` (or `#rgb`) color. */
+export declare const isValidHex: (input: string) => boolean;
+export declare function hexToRgb(hex: string): RGB;
+export declare function rgbToHex({ r, g, b }: RGB): string;
+/** RGB (0–255) → HSV. */
+export declare function rgbToHsv({ r, g, b }: RGB): HSV;
+/** HSV → RGB (0–255). */
+export declare function hsvToRgb({ h, s, v }: HSV): RGB;
+export declare const hexToHsv: (hex: string) => HSV;
+export declare const hsvToHex: (hsv: HSV) => string;
+/** A readable text/handle color (near-black or white) for sitting on top of a given hex fill. */
+export declare function contrastOn(hex: string): string;
+/**
+ * Parses any CSS color the picker understands — `#rgb` / `#rgba` / `#rrggbb` / `#rrggbbaa` hex (with
+ * or without `#`), or `rgb()` / `rgba()` (alpha as `0–1` or a `%`) — to `{ r, g, b, a }` (`a` is
+ * `0–1`), or `null` when it doesn't match.
+ */
+export declare function parseColor(input: string): RGBA | null;
+/**
+ * Formats `{ r, g, b, a }` back to a CSS string: `#rrggbb` when fully opaque (`a >= 1`), else
+ * `rgba(r, g, b, a)` with alpha rounded to 2 decimals.
+ */
+export declare function formatColor({ r, g, b, a }: RGBA): string;

package/dist/components/ColorPicker/colorUtils.d.ts

@@ -0,0 +1,44 @@
+/** Color math for the ColorPicker: hex ⇄ rgb ⇄ hsv, plus hex validation. All internal, no deps. */
+export interface HSV {
+    /** Hue 0–360 */
+    h: number;
+    /** Saturation 0–1 */
+    s: number;
+    /** Value/brightness 0–1 */
+    v: number;
+}
+export interface RGB {
+    r: number;
+    g: number;
+    b: number;
+}
+export interface RGBA extends RGB {
+    /** Alpha 0–1 */
+    a: number;
+}
+export declare const clamp01: (n: number) => number;
+/** Normalizes any `#rgb`/`#rrggbb` (with or without `#`) to a lowercase `#rrggbb`, or `null` if invalid. */
+export declare function normalizeHex(input: string): string | null;
+/** True for a complete `#rrggbb` (or `#rgb`) color. */
+export declare const isValidHex: (input: string) => boolean;
+export declare function hexToRgb(hex: string): RGB;
+export declare function rgbToHex({ r, g, b }: RGB): string;
+/** RGB (0–255) → HSV. */
+export declare function rgbToHsv({ r, g, b }: RGB): HSV;
+/** HSV → RGB (0–255). */
+export declare function hsvToRgb({ h, s, v }: HSV): RGB;
+export declare const hexToHsv: (hex: string) => HSV;
+export declare const hsvToHex: (hsv: HSV) => string;
+/** A readable text/handle color (near-black or white) for sitting on top of a given hex fill. */
+export declare function contrastOn(hex: string): string;
+/**
+ * Parses any CSS color the picker understands — `#rgb` / `#rgba` / `#rrggbb` / `#rrggbbaa` hex (with
+ * or without `#`), or `rgb()` / `rgba()` (alpha as `0–1` or a `%`) — to `{ r, g, b, a }` (`a` is
+ * `0–1`), or `null` when it doesn't match.
+ */
+export declare function parseColor(input: string): RGBA | null;
+/**
+ * Formats `{ r, g, b, a }` back to a CSS string: `#rrggbb` when fully opaque (`a >= 1`), else
+ * `rgba(r, g, b, a)` with alpha rounded to 2 decimals.
+ */
+export declare function formatColor({ r, g, b, a }: RGBA): string;

package/dist/components/ColorPicker/index.cjs

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

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

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

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

@@ -0,0 +1,2 @@
+export { ColorPicker, ColorPicker as default } from './ColorPicker';
+export type { ColorPickerProps, ColorPickerSize } from './ColorPicker';

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

@@ -0,0 +1,2 @@
+export { ColorPicker, ColorPicker as default } from './ColorPicker';
+export type { ColorPickerProps, ColorPickerSize } from './ColorPicker';

package/dist/components/ColorPicker/index.js

@@ -0,0 +1,6 @@
+import { C as a, C as e } from "../../ColorPicker-2udt1ORM.js";
+export {
+  a as ColorPicker,
+  e as default
+};
+//# sourceMappingURL=index.js.map

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

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

package/dist/components/DatePicker/Calendar.d.cts

@@ -0,0 +1,29 @@
+import { type Dayjs } from './dateUtils';
+export interface CalendarProps {
+    /** Currently selected date (UTC dayjs) or null. */
+    value: Dayjs | null;
+    /** The month currently shown (UTC dayjs). */
+    month: Dayjs;
+    /** Change the shown month. */
+    onMonthChange: (month: Dayjs) => void;
+    /** Commit a selected date as an ISO `'YYYY-MM-DD'` string. */
+    onSelect: (iso: string) => void;
+    min: Dayjs | null;
+    max: Dayjs | null;
+    disabledDate?: (iso: string) => boolean;
+    /** 0 = Sunday … 6 = Saturday. */
+    weekStartsOn: number;
+    /** Focus the active cell on mount (when the popover opens). */
+    autoFocus?: boolean;
+    /** Id of the element labelling the grid. */
+    labelId?: string;
+}
+/**
+ * The calendar grid used by the date components. Three views — a `role="grid"` **day** view with full
+ * keyboard navigation (Arrows move days, Home/End the week, PageUp/Down the month, Shift+PageUp/Down
+ * the year, Enter/Space to select), plus separate **month** and **year** picker views reached from the
+ * header (the month and year labels are independently clickable). Picking a year advances to the month
+ * view; picking a month returns to the day view. The year view lists every year in range and scrolls.
+ * Controlled: the consumer owns `value` + `month`; `onSelect`/`onMonthChange` lift changes up.
+ */
+export declare function Calendar({ value, month, onMonthChange, onSelect, min, max, disabledDate, weekStartsOn, autoFocus, labelId, }: CalendarProps): import("react/jsx-runtime").JSX.Element;

package/dist/components/DatePicker/Calendar.d.ts

@@ -0,0 +1,29 @@
+import { type Dayjs } from './dateUtils';
+export interface CalendarProps {
+    /** Currently selected date (UTC dayjs) or null. */
+    value: Dayjs | null;
+    /** The month currently shown (UTC dayjs). */
+    month: Dayjs;
+    /** Change the shown month. */
+    onMonthChange: (month: Dayjs) => void;
+    /** Commit a selected date as an ISO `'YYYY-MM-DD'` string. */
+    onSelect: (iso: string) => void;
+    min: Dayjs | null;
+    max: Dayjs | null;
+    disabledDate?: (iso: string) => boolean;
+    /** 0 = Sunday … 6 = Saturday. */
+    weekStartsOn: number;
+    /** Focus the active cell on mount (when the popover opens). */
+    autoFocus?: boolean;
+    /** Id of the element labelling the grid. */
+    labelId?: string;
+}
+/**
+ * The calendar grid used by the date components. Three views — a `role="grid"` **day** view with full
+ * keyboard navigation (Arrows move days, Home/End the week, PageUp/Down the month, Shift+PageUp/Down
+ * the year, Enter/Space to select), plus separate **month** and **year** picker views reached from the
+ * header (the month and year labels are independently clickable). Picking a year advances to the month
+ * view; picking a month returns to the day view. The year view lists every year in range and scrolls.
+ * Controlled: the consumer owns `value` + `month`; `onSelect`/`onMonthChange` lift changes up.
+ */
+export declare function Calendar({ value, month, onMonthChange, onSelect, min, max, disabledDate, weekStartsOn, autoFocus, labelId, }: CalendarProps): import("react/jsx-runtime").JSX.Element;

package/dist/components/DatePicker/DatePicker.d.cts

@@ -0,0 +1,66 @@
+import { type CSSProperties, type ReactNode } from 'react';
+export type DatePickerSize = 'sm' | 'md' | 'lg';
+export interface DatePickerProps {
+    /** Label rendered above the field. */
+    label?: ReactNode;
+    /** Preset size — control height, font and calendar density. */
+    size?: DatePickerSize;
+    /** Marks the field invalid: red border/ring + the `helperText` 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. */
+    disabled?: boolean;
+    /** Controlled value — a date string in `valueFormat` (default ISO datetime; `''` = empty). */
+    value?: string;
+    /** Initial value for uncontrolled use (in `valueFormat`). */
+    defaultValue?: string;
+    /** Fires with the next date in `valueFormat` (`''` when cleared). */
+    onChange?: (value: string) => void;
+    /** Display + typed-input format (dayjs tokens; should be numeric for the typed mask). Defaults to `'DD/MM/YYYY'`. */
+    format?: string;
+    /**
+     * Wire format of `value`/`defaultValue`/`onChange` (dayjs tokens), decoupled from the displayed
+     * `format`. Defaults to the ISO datetime `'YYYY-MM-DDTHH:mm:ss'`. Incoming values are parsed
+     * **leniently** (this format, then any ISO-8601 string — so a backend datetime like
+     * `'2026-06-10T09:35:49.6134342'` is accepted), while `onChange` emits in exactly this format at the
+     * **start of the UTC day** (e.g. `'2026-06-10T00:00:00'`). Pass `'YYYY-MM-DD'` for a plain date.
+     */
+    valueFormat?: string;
+    /** Placeholder shown when empty. Defaults to the lowercased `format` (e.g. `"dd/mm/yyyy"`). */
+    placeholder?: string;
+    /** Earliest selectable date (ISO `'YYYY-MM-DD'`). */
+    min?: string;
+    /** Latest selectable date (ISO `'YYYY-MM-DD'`). */
+    max?: string;
+    /** Disables specific dates — receives each day as an ISO `'YYYY-MM-DD'` string. */
+    disabledDate?: (date: string) => boolean;
+    /** First day of the week: 0 = Sunday … 6 = Saturday. Defaults to `1` (Monday). */
+    weekStartsOn?: number;
+    /** Shows a clear (×) button when a date is set. Defaults to `true`. */
+    clearable?: boolean;
+    /** Form field name — auto-binds to a surrounding `<Form>` (value is the ISO date string). */
+    name?: string;
+    /** Id for the input (label association). */
+    id?: string;
+    className?: string;
+    style?: CSSProperties;
+}
+/**
+ * A date field with a typed, masked input **and** a calendar popover. The input accepts typing in
+ * `format` (default `DD/MM/YYYY`, masked) and parses strictly; the calendar icon opens a
+ * `Dropdown`-style popover (portaled, flips, scroll-locked — shared via `useFloatingPanel`) with a
+ * keyboard-navigable month grid + year picker. All calendar math runs in **UTC** so the date never
+ * drifts with the viewer's timezone; the value is a string in `valueFormat` (default ISO datetime
+ * `'YYYY-MM-DDTHH:mm:ss'`) — incoming values are parsed leniently (a richer backend datetime is
+ * accepted) and emitted at the start of the UTC day. Supports `min`/`max`, `disabledDate`,
+ * `weekStartsOn`, and
+ * `clearable`. Controlled (`value` + `onChange`) or
+ * uncontrolled (`defaultValue`), and binds to a surrounding `<Form>` by `name` (validate with e.g.
+ * `z.string().min(1, 'Required')`). Token-only styling. Requires the `dayjs` peer dependency.
+ */
+export declare const DatePicker: import("react").ForwardRefExoticComponent<DatePickerProps & import("react").RefAttributes<HTMLInputElement>>;

package/dist/components/DatePicker/DatePicker.d.ts

@@ -0,0 +1,66 @@
+import { type CSSProperties, type ReactNode } from 'react';
+export type DatePickerSize = 'sm' | 'md' | 'lg';
+export interface DatePickerProps {
+    /** Label rendered above the field. */
+    label?: ReactNode;
+    /** Preset size — control height, font and calendar density. */
+    size?: DatePickerSize;
+    /** Marks the field invalid: red border/ring + the `helperText` 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. */
+    disabled?: boolean;
+    /** Controlled value — a date string in `valueFormat` (default ISO datetime; `''` = empty). */
+    value?: string;
+    /** Initial value for uncontrolled use (in `valueFormat`). */
+    defaultValue?: string;
+    /** Fires with the next date in `valueFormat` (`''` when cleared). */
+    onChange?: (value: string) => void;
+    /** Display + typed-input format (dayjs tokens; should be numeric for the typed mask). Defaults to `'DD/MM/YYYY'`. */
+    format?: string;
+    /**
+     * Wire format of `value`/`defaultValue`/`onChange` (dayjs tokens), decoupled from the displayed
+     * `format`. Defaults to the ISO datetime `'YYYY-MM-DDTHH:mm:ss'`. Incoming values are parsed
+     * **leniently** (this format, then any ISO-8601 string — so a backend datetime like
+     * `'2026-06-10T09:35:49.6134342'` is accepted), while `onChange` emits in exactly this format at the
+     * **start of the UTC day** (e.g. `'2026-06-10T00:00:00'`). Pass `'YYYY-MM-DD'` for a plain date.
+     */
+    valueFormat?: string;
+    /** Placeholder shown when empty. Defaults to the lowercased `format` (e.g. `"dd/mm/yyyy"`). */
+    placeholder?: string;
+    /** Earliest selectable date (ISO `'YYYY-MM-DD'`). */
+    min?: string;
+    /** Latest selectable date (ISO `'YYYY-MM-DD'`). */
+    max?: string;
+    /** Disables specific dates — receives each day as an ISO `'YYYY-MM-DD'` string. */
+    disabledDate?: (date: string) => boolean;
+    /** First day of the week: 0 = Sunday … 6 = Saturday. Defaults to `1` (Monday). */
+    weekStartsOn?: number;
+    /** Shows a clear (×) button when a date is set. Defaults to `true`. */
+    clearable?: boolean;
+    /** Form field name — auto-binds to a surrounding `<Form>` (value is the ISO date string). */
+    name?: string;
+    /** Id for the input (label association). */
+    id?: string;
+    className?: string;
+    style?: CSSProperties;
+}
+/**
+ * A date field with a typed, masked input **and** a calendar popover. The input accepts typing in
+ * `format` (default `DD/MM/YYYY`, masked) and parses strictly; the calendar icon opens a
+ * `Dropdown`-style popover (portaled, flips, scroll-locked — shared via `useFloatingPanel`) with a
+ * keyboard-navigable month grid + year picker. All calendar math runs in **UTC** so the date never
+ * drifts with the viewer's timezone; the value is a string in `valueFormat` (default ISO datetime
+ * `'YYYY-MM-DDTHH:mm:ss'`) — incoming values are parsed leniently (a richer backend datetime is
+ * accepted) and emitted at the start of the UTC day. Supports `min`/`max`, `disabledDate`,
+ * `weekStartsOn`, and
+ * `clearable`. Controlled (`value` + `onChange`) or
+ * uncontrolled (`defaultValue`), and binds to a surrounding `<Form>` by `name` (validate with e.g.
+ * `z.string().min(1, 'Required')`). Token-only styling. Requires the `dayjs` peer dependency.
+ */
+export declare const DatePicker: import("react").ForwardRefExoticComponent<DatePickerProps & import("react").RefAttributes<HTMLInputElement>>;

package/dist/components/DatePicker/dateUtils.d.cts

@@ -0,0 +1,86 @@
+/**
+ * Date math for the date components, on top of dayjs (an optional peer dep). All calendar math runs
+ * in **UTC** (via the `utc` plugin) so a calendar date never drifts with the viewer's timezone; the
+ * public value is a plain ISO date string `'YYYY-MM-DD'`. Typed input is parsed strictly against a
+ * display `format` (via the `customParseFormat` plugin).
+ */
+import { type Dayjs } from 'dayjs';
+export type { Dayjs };
+/** The canonical value format (timezone-agnostic calendar date). */
+export declare const ISO = "YYYY-MM-DD";
+/** Parse an ISO `'YYYY-MM-DD'` value (UTC-anchored) into a dayjs, or `null` if empty/invalid. */
+export declare function parseISO(value?: string | null): Dayjs | null;
+/** Parse a user-typed string strictly against a display `format` (UTC), or `null`. */
+export declare function parseInput(text: string, format: string): Dayjs | null;
+export declare const toISO: (d: Dayjs) => string;
+/**
+ * Parse an incoming **value** leniently (UTC): the declared `valueFormat` first (strict), then any
+ * ISO-8601 string — so a richer backend datetime such as `'2026-06-10T09:35:49.6134342'` is still
+ * accepted (dayjs caps the fractional seconds at milliseconds). Returns `null` when empty/unparseable.
+ */
+export declare function parseValue(value: string | null | undefined, valueFormat: string): Dayjs | null;
+/**
+ * Format a date to the I/O `valueFormat`, anchored to the **start of its UTC day** — a date picker
+ * carries no time-of-day, so the emitted time is `00:00:00` (e.g. `valueFormat='YYYY-MM-DDTHH:mm:ss'`
+ * → `'2026-06-10T00:00:00'`).
+ */
+export declare const formatValue: (d: Dayjs, valueFormat: string) => string;
+/** The viewer's local calendar date, anchored to UTC midnight for stable, drift-free math. */
+export declare const today: () => Dayjs;
+/**
+ * Convert a real UTC instant into a UTC-mode dayjs that **holds the viewer's local wall-clock** — so the
+ * UTC-internal calendar/time machinery renders the viewer's local time while the stored value stays UTC
+ * (the "store UTC, show local" pattern, used by `DateTimePicker`/`TimePicker`). Returns `null` for null.
+ */
+export declare function utcToLocalWall(instant: Dayjs | null): Dayjs | null;
+/** Inverse of {@link utcToLocalWall}: a local-wall dayjs → the real UTC instant (for emitting). */
+export declare function localWallToUtc(localWall: Dayjs): Dayjs;
+/**
+ * Parse an incoming **time-of-day** value leniently (UTC): the declared `valueFormat` first (strict),
+ * then a numeric time anchored to a fixed date (so `'09:35:49.6134342'` is accepted, ms-capped), then
+ * any ISO-8601 datetime (its time is used). Only the time-of-day matters; the date part is ignored by
+ * `TimePicker`. Returns `null` when empty/unparseable.
+ */
+export declare function parseTime(value: string | null | undefined, valueFormat: string): Dayjs | null;
+/** Inclusive numeric range `[start, end]` stepped by `step` — for the time-picker columns. A
+ *  non-positive `step` returns `[]` rather than looping forever. */
+export declare function range(start: number, end: number, step?: number): number[];
+/** Zero-pads a number to two digits (`9` → `'09'`) for time-column display. */
+export declare const pad2: (n: number) => string;
+/**
+ * Build an input mask from a date/time format: numeric tokens (`D M Y H h m s`) → `9` (digit slots),
+ * the **uppercase** meridiem token `A` → `AA` and the **lowercase** `a` → `aa` (two letter slots for
+ * `AM`/`PM`, matching dayjs's case-sensitive strict parse), everything else literal.
+ * `'DD/MM/YYYY'` → `'99/99/9999'`; `'DD/MM/YYYY hh:mm A'` → `'99/99/9999 99:99 AA'`.
+ */
+export declare const maskFromFormat: (format: string) => string;
+/**
+ * Applies a mask to raw input: `9` = digit, `A` = letter forced upper-case, `a` = letter forced
+ * lower-case (so a typed meridiem matches the format's case for dayjs), everything else a literal.
+ */
+export declare function applyMask(raw: string, mask: string): string;
+/** True when `d` falls outside `[min, max]` or is rejected by `disabledDate`. */
+export declare function isDisabled(d: Dayjs, min: Dayjs | null, max: Dayjs | null, disabledDate?: (iso: string) => boolean): boolean;
+/** A single cell in the month grid. */
+export interface CalendarDay {
+    date: Dayjs;
+    iso: string;
+    /** Belongs to the month being displayed (vs. a leading/trailing day from an adjacent month). */
+    inMonth: boolean;
+    isToday: boolean;
+}
+/**
+ * Builds a fixed 6×7 (42-cell) grid for the month containing `monthDate`, with weeks starting on
+ * `weekStartsOn` (0 = Sunday … 6 = Saturday). Fixed height avoids layout shift between months.
+ */
+export declare function buildMonthGrid(monthDate: Dayjs, weekStartsOn: number): CalendarDay[];
+/** Short weekday header labels, ordered from `weekStartsOn`. */
+export declare function weekdayLabels(weekStartsOn: number): string[];
+/** Full month names (`'January'…'December'`), index 0–11, for the month-picker view. */
+export declare function monthLabels(): string[];
+/**
+ * The list of selectable years for the (scrollable) year-picker view: bounded by `min`/`max` when
+ * given, otherwise ±100 around `viewYear`. Always widened to include `viewYear` so the roving focus
+ * has a cell to land on.
+ */
+export declare function yearList(min: Dayjs | null, max: Dayjs | null, viewYear: number): number[];

package/dist/components/DatePicker/dateUtils.d.ts

@@ -0,0 +1,86 @@
+/**
+ * Date math for the date components, on top of dayjs (an optional peer dep). All calendar math runs
+ * in **UTC** (via the `utc` plugin) so a calendar date never drifts with the viewer's timezone; the
+ * public value is a plain ISO date string `'YYYY-MM-DD'`. Typed input is parsed strictly against a
+ * display `format` (via the `customParseFormat` plugin).
+ */
+import { type Dayjs } from 'dayjs';
+export type { Dayjs };
+/** The canonical value format (timezone-agnostic calendar date). */
+export declare const ISO = "YYYY-MM-DD";
+/** Parse an ISO `'YYYY-MM-DD'` value (UTC-anchored) into a dayjs, or `null` if empty/invalid. */
+export declare function parseISO(value?: string | null): Dayjs | null;
+/** Parse a user-typed string strictly against a display `format` (UTC), or `null`. */
+export declare function parseInput(text: string, format: string): Dayjs | null;
+export declare const toISO: (d: Dayjs) => string;
+/**
+ * Parse an incoming **value** leniently (UTC): the declared `valueFormat` first (strict), then any
+ * ISO-8601 string — so a richer backend datetime such as `'2026-06-10T09:35:49.6134342'` is still
+ * accepted (dayjs caps the fractional seconds at milliseconds). Returns `null` when empty/unparseable.
+ */
+export declare function parseValue(value: string | null | undefined, valueFormat: string): Dayjs | null;
+/**
+ * Format a date to the I/O `valueFormat`, anchored to the **start of its UTC day** — a date picker
+ * carries no time-of-day, so the emitted time is `00:00:00` (e.g. `valueFormat='YYYY-MM-DDTHH:mm:ss'`
+ * → `'2026-06-10T00:00:00'`).
+ */
+export declare const formatValue: (d: Dayjs, valueFormat: string) => string;
+/** The viewer's local calendar date, anchored to UTC midnight for stable, drift-free math. */
+export declare const today: () => Dayjs;
+/**
+ * Convert a real UTC instant into a UTC-mode dayjs that **holds the viewer's local wall-clock** — so the
+ * UTC-internal calendar/time machinery renders the viewer's local time while the stored value stays UTC
+ * (the "store UTC, show local" pattern, used by `DateTimePicker`/`TimePicker`). Returns `null` for null.
+ */
+export declare function utcToLocalWall(instant: Dayjs | null): Dayjs | null;
+/** Inverse of {@link utcToLocalWall}: a local-wall dayjs → the real UTC instant (for emitting). */
+export declare function localWallToUtc(localWall: Dayjs): Dayjs;
+/**
+ * Parse an incoming **time-of-day** value leniently (UTC): the declared `valueFormat` first (strict),
+ * then a numeric time anchored to a fixed date (so `'09:35:49.6134342'` is accepted, ms-capped), then
+ * any ISO-8601 datetime (its time is used). Only the time-of-day matters; the date part is ignored by
+ * `TimePicker`. Returns `null` when empty/unparseable.
+ */
+export declare function parseTime(value: string | null | undefined, valueFormat: string): Dayjs | null;
+/** Inclusive numeric range `[start, end]` stepped by `step` — for the time-picker columns. A
+ *  non-positive `step` returns `[]` rather than looping forever. */
+export declare function range(start: number, end: number, step?: number): number[];
+/** Zero-pads a number to two digits (`9` → `'09'`) for time-column display. */
+export declare const pad2: (n: number) => string;
+/**
+ * Build an input mask from a date/time format: numeric tokens (`D M Y H h m s`) → `9` (digit slots),
+ * the **uppercase** meridiem token `A` → `AA` and the **lowercase** `a` → `aa` (two letter slots for
+ * `AM`/`PM`, matching dayjs's case-sensitive strict parse), everything else literal.
+ * `'DD/MM/YYYY'` → `'99/99/9999'`; `'DD/MM/YYYY hh:mm A'` → `'99/99/9999 99:99 AA'`.
+ */
+export declare const maskFromFormat: (format: string) => string;
+/**
+ * Applies a mask to raw input: `9` = digit, `A` = letter forced upper-case, `a` = letter forced
+ * lower-case (so a typed meridiem matches the format's case for dayjs), everything else a literal.
+ */
+export declare function applyMask(raw: string, mask: string): string;
+/** True when `d` falls outside `[min, max]` or is rejected by `disabledDate`. */
+export declare function isDisabled(d: Dayjs, min: Dayjs | null, max: Dayjs | null, disabledDate?: (iso: string) => boolean): boolean;
+/** A single cell in the month grid. */
+export interface CalendarDay {
+    date: Dayjs;
+    iso: string;
+    /** Belongs to the month being displayed (vs. a leading/trailing day from an adjacent month). */
+    inMonth: boolean;
+    isToday: boolean;
+}
+/**
+ * Builds a fixed 6×7 (42-cell) grid for the month containing `monthDate`, with weeks starting on
+ * `weekStartsOn` (0 = Sunday … 6 = Saturday). Fixed height avoids layout shift between months.
+ */
+export declare function buildMonthGrid(monthDate: Dayjs, weekStartsOn: number): CalendarDay[];
+/** Short weekday header labels, ordered from `weekStartsOn`. */
+export declare function weekdayLabels(weekStartsOn: number): string[];
+/** Full month names (`'January'…'December'`), index 0–11, for the month-picker view. */
+export declare function monthLabels(): string[];
+/**
+ * The list of selectable years for the (scrollable) year-picker view: bounded by `min`/`max` when
+ * given, otherwise ±100 around `viewYear`. Always widened to include `viewYear` so the roving focus
+ * has a cell to land on.
+ */
+export declare function yearList(min: Dayjs | null, max: Dayjs | null, viewYear: number): number[];

package/dist/components/DatePicker/index.cjs

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

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

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

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

@@ -0,0 +1,2 @@
+export { DatePicker, DatePicker as default } from './DatePicker';
+export type { DatePickerProps, DatePickerSize } from './DatePicker';

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

@@ -0,0 +1,2 @@
+export { DatePicker, DatePicker as default } from './DatePicker';
+export type { DatePickerProps, DatePickerSize } from './DatePicker';

package/dist/components/DatePicker/index.js

@@ -0,0 +1,6 @@
+import { D as r, D as t } from "../../DatePicker-WM9TC6L_.js";
+export {
+  r as DatePicker,
+  t as default
+};
+//# sourceMappingURL=index.js.map

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

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

package/dist/components/DateTimePicker/DateTimePicker.d.cts

@@ -0,0 +1,79 @@
+import { type CSSProperties, type ReactNode } from 'react';
+export type DateTimePickerSize = 'sm' | 'md' | 'lg';
+export interface DateTimePickerProps {
+    /** Label rendered above the field. */
+    label?: ReactNode;
+    /** Preset size — control height, font and calendar density. */
+    size?: DateTimePickerSize;
+    /** Marks the field invalid: red border/ring + the `helperText` 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. */
+    disabled?: boolean;
+    /** Controlled value — a datetime string in `valueFormat` (default ISO datetime; `''` = empty). */
+    value?: string;
+    /** Initial value for uncontrolled use (in `valueFormat`). */
+    defaultValue?: string;
+    /** Fires with the next datetime in `valueFormat` (`''` when cleared). */
+    onChange?: (value: string) => void;
+    /**
+     * Display + typed-input format (dayjs tokens). Defaults to `'DD/MM/YYYY HH:mm:ss'` (or `hh:mm:ss A`
+     * when `hour12`; the `:ss` is dropped when `showSeconds` is `false`).
+     */
+    format?: string;
+    /**
+     * Wire format of `value`/`defaultValue`/`onChange` (dayjs tokens), decoupled from the displayed
+     * `format`. Defaults to the ISO datetime `'YYYY-MM-DDTHH:mm:ss[Z]'` when `utc` (the `Z` marks the
+     * value as UTC, e.g. `'2026-06-10T09:35:00Z'`), or `'YYYY-MM-DDTHH:mm:ss'` (no `Z`) when `utc={false}`.
+     * Incoming values are parsed **leniently** (this format, then any ISO-8601 string — so a backend
+     * datetime like `'2026-06-10T09:35:49.6134342'` with or without `Z` is accepted).
+     */
+    valueFormat?: string;
+    /**
+     * Treat the value as **UTC** and display/edit in the viewer's **local** timezone (default `true`).
+     * Set `false` to disable timezone conversion entirely — the field shows and emits the value's exact
+     * wall-clock (what you pick is what's sent, no UTC shift).
+     */
+    utc?: boolean;
+    /** 12-hour clock (1–12 + AM/PM) instead of 24-hour (0–23). Defaults to `false`. */
+    hour12?: boolean;
+    /** Minute increment for the minutes column. Defaults to `1`. */
+    minuteStep?: number;
+    /** Show the seconds column + `:ss` in the default format. Defaults to `true`; pass `false` to hide seconds. */
+    showSeconds?: boolean;
+    /** Placeholder shown when empty. Defaults to the lowercased `format`. */
+    placeholder?: string;
+    /** Earliest selectable date (ISO date or datetime; day-level bound on the calendar). */
+    min?: string;
+    /** Latest selectable date (ISO date or datetime; day-level bound on the calendar). */
+    max?: string;
+    /** Disables specific dates — receives each day as an ISO `'YYYY-MM-DD'` string. */
+    disabledDate?: (date: string) => boolean;
+    /** First day of the week: 0 = Sunday … 6 = Saturday. Defaults to `1` (Monday). */
+    weekStartsOn?: number;
+    /** Shows a clear (×) button when a value is set. Defaults to `true`. */
+    clearable?: boolean;
+    /** Form field name — auto-binds to a surrounding `<Form>` (value is the datetime string). */
+    name?: string;
+    /** Id for the input (label association). */
+    id?: string;
+    className?: string;
+    style?: CSSProperties;
+}
+/**
+ * A datetime field with a typed, masked input **and** a popover combining the keyboard-navigable
+ * `Calendar` (date) with scrollable time columns (hour / minute / optional second + AM/PM in 12-hour
+ * mode). All math runs in **UTC** so the instant never drifts with the viewer's timezone; the value is a
+ * string in `valueFormat` (UTC ISO datetime with a `Z` by default, or no `Z` when `utc={false}`) — incoming values are parsed
+ * leniently (a richer backend datetime is accepted) and the chosen instant is emitted in that format.
+ * Picking a date keeps the time and vice-versa, and the popover stays open until you click away,
+ * press Escape, or hit Done. Supports `hour12`, `minuteStep`, `showSeconds`, `min`/`max`,
+ * `disabledDate`, `weekStartsOn`, and `clearable`. Controlled (`value` + `onChange`) or uncontrolled
+ * (`defaultValue`), and binds to a surrounding `<Form>` by `name`. Requires the `dayjs` peer dependency.
+ */
+export declare const DateTimePicker: import("react").ForwardRefExoticComponent<DateTimePickerProps & import("react").RefAttributes<HTMLInputElement>>;