zkit-ui 1.0.0

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

@@ -0,0 +1,5 @@
+import * as React from 'react';
+import type { DatePickerProps } from './types';
+export type { DatePickerChangePayload, DatePickerColumn, DatePickerColumnHeaderContext, DatePickerConfirmPayload, DatePickerDisableContext, DatePickerDraftChangePayload, DatePickerHandle, DatePickerInput, DatePickerLabelFormat, DatePickerOption, DatePickerParts, DatePickerPrecision, DatePickerProps, DatePickerRenderContext, DatePickerSelection, DatePickerValue, } from './types';
+export declare const DatePicker: React.ForwardRefExoticComponent<DatePickerProps & React.RefAttributes<import("../Picker").PickerHandle>>;
+//# sourceMappingURL=index.d.ts.map

package/dist/ui/DatePicker/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/ui/DatePicker/index.tsx"],"names":[],"mappings":"AAAA,OAAO,KAAK,KAAK,MAAM,OAAO,CAAC;AAuB/B,OAAO,KAAK,EAKV,eAAe,EAEhB,MAAM,SAAS,CAAC;AAEjB,YAAY,EACV,uBAAuB,EACvB,gBAAgB,EAChB,6BAA6B,EAC7B,wBAAwB,EACxB,wBAAwB,EACxB,4BAA4B,EAC5B,gBAAgB,EAChB,eAAe,EACf,qBAAqB,EACrB,gBAAgB,EAChB,eAAe,EACf,mBAAmB,EACnB,eAAe,EACf,uBAAuB,EACvB,mBAAmB,EACnB,eAAe,GAChB,MAAM,SAAS,CAAC;AAmDjB,eAAO,MAAM,UAAU,0GAkMrB,CAAC"}

package/dist/ui/DatePicker/index.js

@@ -0,0 +1,157 @@
+"use strict";
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __setModuleDefault = (this && this.__setModuleDefault) || (Object.create ? (function(o, v) {
+    Object.defineProperty(o, "default", { enumerable: true, value: v });
+}) : function(o, v) {
+    o["default"] = v;
+});
+var __importStar = (this && this.__importStar) || (function () {
+    var ownKeys = function(o) {
+        ownKeys = Object.getOwnPropertyNames || function (o) {
+            var ar = [];
+            for (var k in o) if (Object.prototype.hasOwnProperty.call(o, k)) ar[ar.length] = k;
+            return ar;
+        };
+        return ownKeys(o);
+    };
+    return function (mod) {
+        if (mod && mod.__esModule) return mod;
+        var result = {};
+        if (mod != null) for (var k = ownKeys(mod), i = 0; i < k.length; i++) if (k[i] !== "default") __createBinding(result, mod, k[i]);
+        __setModuleDefault(result, mod);
+        return result;
+    };
+})();
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.DatePicker = void 0;
+const jsx_runtime_1 = require("react/jsx-runtime");
+const React = __importStar(require("react"));
+const Text_1 = require("../Text");
+const Picker_1 = require("../Picker");
+const useI18n_1 = require("../../i18n/useI18n");
+const utils_1 = require("./utils");
+function createEmptyRenderContext(precision, pickerContext, placeholder) {
+    return {
+        value: null,
+        date: null,
+        precision,
+        parts: null,
+        values: [],
+        label: '',
+        labels: [],
+        items: [],
+        isComplete: false,
+        open: pickerContext.open,
+        close: pickerContext.close,
+        isOpen: pickerContext.isOpen,
+        disabled: pickerContext.disabled,
+        placeholder,
+    };
+}
+function createRenderContext(selection, precision, pickerContext, placeholder) {
+    if (!selection)
+        return createEmptyRenderContext(precision, pickerContext, placeholder);
+    return {
+        value: selection.value,
+        date: selection.date,
+        precision,
+        parts: selection.parts,
+        values: selection.values,
+        label: selection.label,
+        labels: selection.labels,
+        items: selection.items,
+        isComplete: selection.isComplete,
+        open: pickerContext.open,
+        close: pickerContext.close,
+        isOpen: pickerContext.isOpen,
+        disabled: pickerContext.disabled,
+        placeholder,
+    };
+}
+exports.DatePicker = React.forwardRef(function DatePicker({ value: valueProp, defaultValue = null, onChange, open, defaultOpen, onOpenChange, onDismissComplete, precision: precisionProp = 'day', min, max, defaultPickerValue, isDateDisabled, title, placeholder, cancelText, confirmText, emptyText, labelFormat, columnLabels, renderColumnHeader, lazyContent = true, sheetHeight = 'auto', disabled = false, onCancel, onConfirm, onDraftChange, children, }, ref) {
+    const { t } = (0, useI18n_1.useI18n)();
+    const precision = (0, utils_1.normalizePrecision)(precisionProp);
+    const placeholderText = placeholder !== null && placeholder !== void 0 ? placeholder : t('datePicker.placeholder');
+    const isValueControlled = valueProp !== undefined;
+    const [innerValue, setInnerValue] = React.useState(defaultValue);
+    const committedValue = isValueControlled ? valueProp : innerValue;
+    const bounds = React.useMemo(() => (0, utils_1.resolveDatePickerBounds)(min, max), [max, min]);
+    const options = React.useMemo(() => (0, utils_1.buildDatePickerOptions)({ bounds, precision, isDateDisabled }), [bounds, isDateDisabled, precision]);
+    const committedDate = React.useMemo(() => (0, utils_1.resolveCommittedDate)(committedValue, bounds, precision), [bounds, committedValue, precision]);
+    const pickerDate = React.useMemo(() => (0, utils_1.resolvePickerDate)(committedDate, defaultPickerValue, bounds, precision), [bounds, committedDate, defaultPickerValue, precision]);
+    const pickerValue = React.useMemo(() => (0, utils_1.pathFromDate)(pickerDate, precision), [pickerDate, precision]);
+    const committedSelection = React.useMemo(() => committedDate
+        ? (0, utils_1.createDatePickerSelectionFromDate)(committedDate, precision, options, labelFormat)
+        : null, [committedDate, labelFormat, options, precision]);
+    const resolveSelection = React.useCallback((selection) => (0, utils_1.createDatePickerSelection)(selection, precision, labelFormat, selection.label), [labelFormat, precision]);
+    const handlePickerChange = React.useCallback((_next, selection) => {
+        const nextSelection = resolveSelection(selection);
+        if (!nextSelection)
+            return;
+        if (!isValueControlled) {
+            setInnerValue(nextSelection.value);
+        }
+        onChange === null || onChange === void 0 ? void 0 : onChange(nextSelection.value, nextSelection);
+    }, [isValueControlled, onChange, resolveSelection]);
+    const handlePickerConfirm = React.useCallback((selection) => {
+        const nextSelection = resolveSelection(selection);
+        if (!nextSelection)
+            return;
+        onConfirm === null || onConfirm === void 0 ? void 0 : onConfirm(nextSelection);
+    }, [onConfirm, resolveSelection]);
+    const handlePickerDraftChange = React.useCallback((selection) => {
+        const nextSelection = resolveSelection(selection);
+        if (!nextSelection)
+            return;
+        onDraftChange === null || onDraftChange === void 0 ? void 0 : onDraftChange(nextSelection);
+    }, [onDraftChange, resolveSelection]);
+    const formatPickerLabel = React.useCallback((selection) => { var _a, _b; return (_b = (_a = (0, utils_1.createDatePickerSelection)(selection, precision, labelFormat)) === null || _a === void 0 ? void 0 : _a.label) !== null && _b !== void 0 ? _b : selection.label; }, [labelFormat, precision]);
+    const resolvedColumnLabels = React.useMemo(() => {
+        var _a, _b, _c;
+        return ({
+            year: (_a = columnLabels === null || columnLabels === void 0 ? void 0 : columnLabels.year) !== null && _a !== void 0 ? _a : t('datePicker.year'),
+            month: (_b = columnLabels === null || columnLabels === void 0 ? void 0 : columnLabels.month) !== null && _b !== void 0 ? _b : t('datePicker.month'),
+            day: (_c = columnLabels === null || columnLabels === void 0 ? void 0 : columnLabels.day) !== null && _c !== void 0 ? _c : t('datePicker.day'),
+        });
+    }, [columnLabels === null || columnLabels === void 0 ? void 0 : columnLabels.day, columnLabels === null || columnLabels === void 0 ? void 0 : columnLabels.month, columnLabels === null || columnLabels === void 0 ? void 0 : columnLabels.year, t]);
+    const handleRenderColumnHeader = React.useCallback((context) => {
+        const column = utils_1.DATE_PICKER_COLUMNS[context.columnIndex];
+        const selectedDate = (0, utils_1.dateFromOption)(context.selectedItem, precision);
+        const headerContext = {
+            column,
+            columnIndex: context.columnIndex,
+            columnCount: context.columnCount,
+            options: context.options,
+            selectedItem: context.selectedItem,
+            selectedValue: typeof context.selectedValue === 'number' ? context.selectedValue : undefined,
+            selectedLabel: context.selectedLabel,
+            selectedDate,
+            selectedParts: context.selectedItem
+                ? {
+                    year: context.selectedItem.year,
+                    month: context.selectedItem.month,
+                    day: context.selectedItem.day,
+                }
+                : undefined,
+        };
+        if (renderColumnHeader)
+            return renderColumnHeader(headerContext);
+        return ((0, jsx_runtime_1.jsx)(Text_1.Text, { variant: "label", size: "sm", weight: "semibold", tone: "muted", children: resolvedColumnLabels[column] }));
+    }, [precision, renderColumnHeader, resolvedColumnLabels]);
+    const pickerChildren = React.useMemo(() => {
+        if (typeof children !== 'function')
+            return children;
+        return (pickerContext) => children(createRenderContext(committedSelection, precision, pickerContext, placeholderText));
+    }, [children, committedSelection, placeholderText, precision]);
+    return ((0, jsx_runtime_1.jsx)(Picker_1.Picker, { ref: ref, options: options, value: pickerValue, onChange: handlePickerChange, valueMode: "path", open: open, defaultOpen: defaultOpen, onOpenChange: onOpenChange, onDismissComplete: onDismissComplete, title: title !== null && title !== void 0 ? title : t('datePicker.title'), placeholder: placeholderText, cancelText: cancelText, confirmText: confirmText, emptyText: emptyText, formatLabel: formatPickerLabel, renderColumnHeader: handleRenderColumnHeader, maxColumns: (0, utils_1.getColumnCount)(precision), lazyContent: lazyContent, sheetHeight: sheetHeight, disabled: disabled, onCancel: onCancel, onConfirm: handlePickerConfirm, onDraftChange: handlePickerDraftChange, children: pickerChildren }));
+});

package/dist/ui/DatePicker/types.d.ts

@@ -0,0 +1,99 @@
+import type * as React from 'react';
+import type { Dayjs } from 'dayjs';
+import type { PickerHandle, PickerOption } from '../Picker';
+export type DatePickerHandle = PickerHandle;
+export type DatePickerPrecision = 'year' | 'month' | 'day';
+export type DatePickerColumn = DatePickerPrecision;
+export type DatePickerValue = string;
+export type DatePickerInput = DatePickerValue | Date | Dayjs;
+export type DatePickerParts = {
+    year: number;
+    month?: number;
+    day?: number;
+};
+export type DatePickerDisableContext = {
+    precision: DatePickerPrecision;
+    column: DatePickerColumn;
+    parts: DatePickerParts;
+};
+export type DatePickerOption = PickerOption<number> & {
+    column: DatePickerColumn;
+    year: number;
+    month?: number;
+    day?: number;
+    children?: DatePickerOption[];
+};
+export type DatePickerSelection = {
+    value: DatePickerValue;
+    date: Dayjs;
+    precision: DatePickerPrecision;
+    parts: DatePickerParts;
+    values: number[];
+    label: string;
+    labels: string[];
+    items: DatePickerOption[];
+    columns: DatePickerOption[][];
+    indices: number[];
+    isComplete: boolean;
+};
+export type DatePickerChangePayload = DatePickerSelection;
+export type DatePickerConfirmPayload = DatePickerSelection;
+export type DatePickerDraftChangePayload = DatePickerSelection;
+export type DatePickerRenderContext = {
+    value: DatePickerValue | null;
+    date: Dayjs | null;
+    precision: DatePickerPrecision;
+    parts: DatePickerParts | null;
+    values: number[];
+    label: string;
+    labels: string[];
+    items: DatePickerOption[];
+    isComplete: boolean;
+    open: () => void;
+    close: () => void;
+    isOpen: boolean;
+    disabled: boolean;
+    placeholder: string;
+};
+export type DatePickerColumnHeaderContext = {
+    column: DatePickerColumn;
+    columnIndex: number;
+    columnCount: number;
+    options: DatePickerOption[];
+    selectedItem?: DatePickerOption;
+    selectedValue?: number;
+    selectedLabel?: string;
+    selectedDate?: Dayjs;
+    selectedParts?: DatePickerParts;
+};
+export type DatePickerLabelFormat = string | ((selection: DatePickerSelection) => string);
+export type DatePickerProps = {
+    value?: DatePickerValue | null;
+    defaultValue?: DatePickerValue | null;
+    onChange?: (value: DatePickerValue, payload: DatePickerChangePayload) => void;
+    open?: boolean;
+    defaultOpen?: boolean;
+    onOpenChange?: (open: boolean) => void;
+    onDismissComplete?: () => void;
+    precision?: DatePickerPrecision;
+    min?: DatePickerInput;
+    max?: DatePickerInput;
+    defaultPickerValue?: DatePickerInput;
+    isDateDisabled?: (date: Dayjs, context: DatePickerDisableContext) => boolean;
+    title?: string;
+    placeholder?: string;
+    cancelText?: string;
+    confirmText?: string;
+    emptyText?: string;
+    labelFormat?: DatePickerLabelFormat;
+    columnLabels?: Partial<Record<DatePickerColumn, string>>;
+    renderColumnHeader?: (context: DatePickerColumnHeaderContext) => React.ReactNode;
+    lazyContent?: boolean;
+    sheetHeight?: number | 'auto';
+    disabled?: boolean;
+    onCancel?: () => void;
+    onConfirm?: (payload: DatePickerConfirmPayload) => void;
+    onDraftChange?: (payload: DatePickerDraftChangePayload) => void;
+    children?: React.ReactNode | ((context: DatePickerRenderContext) => React.ReactNode);
+};
+//# sourceMappingURL=types.d.ts.map

package/dist/ui/DatePicker/types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../../src/ui/DatePicker/types.ts"],"names":[],"mappings":"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"}

package/dist/ui/DatePicker/types.js

@@ -0,0 +1,2 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });

package/dist/ui/DatePicker/utils.d.ts

@@ -0,0 +1,32 @@
+import dayjs, { type Dayjs } from 'dayjs';
+import type { PickerSelection } from '../Picker';
+import type { DatePickerInput, DatePickerLabelFormat, DatePickerOption, DatePickerParts, DatePickerPrecision, DatePickerSelection, DatePickerValue, DatePickerProps } from './types';
+export declare const DATE_PICKER_COLUMNS: readonly ["year", "month", "day"];
+type DateBounds = {
+    min: Dayjs;
+    max: Dayjs;
+};
+type ParsedDate = {
+    date: Dayjs;
+    inputPrecision: DatePickerPrecision;
+};
+type BuildOptionsConfig = {
+    bounds: DateBounds;
+    precision: DatePickerPrecision;
+    isDateDisabled?: DatePickerProps['isDateDisabled'];
+};
+export declare function normalizePrecision(input: DatePickerPrecision | undefined): DatePickerPrecision;
+export declare function getColumnCount(precision: DatePickerPrecision): number;
+export declare function formatDatePickerValue(date: Dayjs, precision: DatePickerPrecision): DatePickerValue;
+export declare function toDatePickerParts(date: Dayjs, precision: DatePickerPrecision): DatePickerParts;
+export declare function pathFromDate(date: Dayjs, precision: DatePickerPrecision): number[];
+export declare function parseDatePickerInput(input: DatePickerInput | null | undefined, fieldName: string): ParsedDate | undefined;
+export declare function resolveDatePickerBounds(min: DatePickerInput | null | undefined, max: DatePickerInput | null | undefined): DateBounds;
+export declare function resolveCommittedDate(value: DatePickerValue | null | undefined, bounds: DateBounds, precision: DatePickerPrecision): dayjs.Dayjs | null;
+export declare function resolvePickerDate(committedDate: Dayjs | null, defaultPickerValue: DatePickerInput | null | undefined, bounds: DateBounds, precision: DatePickerPrecision): dayjs.Dayjs;
+export declare function buildDatePickerOptions(config: BuildOptionsConfig): DatePickerOption[];
+export declare function createDatePickerSelection(pickerSelection: PickerSelection<DatePickerOption>, precision: DatePickerPrecision, labelFormat?: DatePickerLabelFormat, labelOverride?: string): DatePickerSelection | null;
+export declare function createDatePickerSelectionFromDate(date: Dayjs, precision: DatePickerPrecision, options: DatePickerOption[], labelFormat?: DatePickerLabelFormat): DatePickerSelection;
+export declare function dateFromOption(option: DatePickerOption | undefined, precision: DatePickerPrecision): dayjs.Dayjs | undefined;
+export {};
+//# sourceMappingURL=utils.d.ts.map

package/dist/ui/DatePicker/utils.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"utils.d.ts","sourceRoot":"","sources":["../../../src/ui/DatePicker/utils.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,EAAE,KAAK,KAAK,EAAE,MAAM,OAAO,CAAC;AAE1C,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,WAAW,CAAC;AACjD,OAAO,KAAK,EAEV,eAAe,EACf,qBAAqB,EACrB,gBAAgB,EAChB,eAAe,EACf,mBAAmB,EACnB,mBAAmB,EACnB,eAAe,EACf,eAAe,EAChB,MAAM,SAAS,CAAC;AAIjB,eAAO,MAAM,mBAAmB,mCAA0E,CAAC;AAoB3G,KAAK,UAAU,GAAG;IAChB,GAAG,EAAE,KAAK,CAAC;IACX,GAAG,EAAE,KAAK,CAAC;CACZ,CAAC;AAEF,KAAK,UAAU,GAAG;IAChB,IAAI,EAAE,KAAK,CAAC;IACZ,cAAc,EAAE,mBAAmB,CAAC;CACrC,CAAC;AAEF,KAAK,kBAAkB,GAAG;IACxB,MAAM,EAAE,UAAU,CAAC;IACnB,SAAS,EAAE,mBAAmB,CAAC;IAC/B,cAAc,CAAC,EAAE,eAAe,CAAC,gBAAgB,CAAC,CAAC;CACpD,CAAC;AAUF,wBAAgB,kBAAkB,CAAC,KAAK,EAAE,mBAAmB,GAAG,SAAS,GAAG,mBAAmB,CAE9F;AAED,wBAAgB,cAAc,CAAC,SAAS,EAAE,mBAAmB,UAE5D;AAED,wBAAgB,qBAAqB,CAAC,IAAI,EAAE,KAAK,EAAE,SAAS,EAAE,mBAAmB,GAAG,eAAe,CAElG;AAED,wBAAgB,iBAAiB,CAAC,IAAI,EAAE,KAAK,EAAE,SAAS,EAAE,mBAAmB,GAAG,eAAe,CAI9F;AAED,wBAAgB,YAAY,CAAC,IAAI,EAAE,KAAK,EAAE,SAAS,EAAE,mBAAmB,GAAG,MAAM,EAAE,CAKlF;AAoCD,wBAAgB,oBAAoB,CAClC,KAAK,EAAE,eAAe,GAAG,IAAI,GAAG,SAAS,EACzC,SAAS,EAAE,MAAM,GAChB,UAAU,GAAG,SAAS,CAUxB;AAeD,wBAAgB,uBAAuB,CACrC,GAAG,EAAE,eAAe,GAAG,IAAI,GAAG,SAAS,EACvC,GAAG,EAAE,eAAe,GAAG,IAAI,GAAG,SAAS,GACtC,UAAU,CAWZ;AAQD,wBAAgB,oBAAoB,CAClC,KAAK,EAAE,eAAe,GAAG,IAAI,GAAG,SAAS,EACzC,MAAM,EAAE,UAAU,EAClB,SAAS,EAAE,mBAAmB,sBAK/B;AAED,wBAAgB,iBAAiB,CAC/B,aAAa,EAAE,KAAK,GAAG,IAAI,EAC3B,kBAAkB,EAAE,eAAe,GAAG,IAAI,GAAG,SAAS,EACtD,MAAM,EAAE,UAAU,EAClB,SAAS,EAAE,mBAAmB,eAO/B;AAmFD,wBAAgB,sBAAsB,CAAC,MAAM,EAAE,kBAAkB,sBAuBhE;AAuBD,wBAAgB,yBAAyB,CACvC,eAAe,EAAE,eAAe,CAAC,gBAAgB,CAAC,EAClD,SAAS,EAAE,mBAAmB,EAC9B,WAAW,CAAC,EAAE,qBAAqB,EACnC,aAAa,CAAC,EAAE,MAAM,GACrB,mBAAmB,GAAG,IAAI,CAuB5B;AAwBD,wBAAgB,iCAAiC,CAC/C,IAAI,EAAE,KAAK,EACX,SAAS,EAAE,mBAAmB,EAC9B,OAAO,EAAE,gBAAgB,EAAE,EAC3B,WAAW,CAAC,EAAE,qBAAqB,GAClC,mBAAmB,CAsBrB;AAED,wBAAgB,cAAc,CAAC,MAAM,EAAE,gBAAgB,GAAG,SAAS,EAAE,SAAS,EAAE,mBAAmB,2BAGlG"}

package/dist/ui/DatePicker/utils.js

@@ -0,0 +1,316 @@
+"use strict";
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.DATE_PICKER_COLUMNS = void 0;
+exports.normalizePrecision = normalizePrecision;
+exports.getColumnCount = getColumnCount;
+exports.formatDatePickerValue = formatDatePickerValue;
+exports.toDatePickerParts = toDatePickerParts;
+exports.pathFromDate = pathFromDate;
+exports.parseDatePickerInput = parseDatePickerInput;
+exports.resolveDatePickerBounds = resolveDatePickerBounds;
+exports.resolveCommittedDate = resolveCommittedDate;
+exports.resolvePickerDate = resolvePickerDate;
+exports.buildDatePickerOptions = buildDatePickerOptions;
+exports.createDatePickerSelection = createDatePickerSelection;
+exports.createDatePickerSelectionFromDate = createDatePickerSelectionFromDate;
+exports.dateFromOption = dateFromOption;
+const dayjs_1 = __importDefault(require("dayjs"));
+const customParseFormat_1 = __importDefault(require("dayjs/plugin/customParseFormat"));
+dayjs_1.default.extend(customParseFormat_1.default);
+exports.DATE_PICKER_COLUMNS = ['year', 'month', 'day'];
+const DEFAULT_MIN = (0, dayjs_1.default)('1900-01-01', 'YYYY-MM-DD', true).startOf('day');
+const DEFAULT_MAX = (0, dayjs_1.default)('2100-12-31', 'YYYY-MM-DD', true).endOf('day');
+const VALUE_FORMAT = {
+    year: 'YYYY',
+    month: 'YYYY-MM',
+    day: 'YYYY-MM-DD',
+};
+const PARSE_FORMATS = {
+    year: 'YYYY',
+    month: ['YYYY-M', 'YYYY-MM'],
+    day: ['YYYY-M-D', 'YYYY-MM-DD'],
+};
+const PRECISION_COLUMN_COUNT = {
+    year: 1,
+    month: 2,
+    day: 3,
+};
+function pad2(n) {
+    return String(n).padStart(2, '0');
+}
+function isDatePickerPrecision(input) {
+    return input === 'year' || input === 'month' || input === 'day';
+}
+function normalizePrecision(input) {
+    return isDatePickerPrecision(input) ? input : 'day';
+}
+function getColumnCount(precision) {
+    return PRECISION_COLUMN_COUNT[precision];
+}
+function formatDatePickerValue(date, precision) {
+    return date.format(VALUE_FORMAT[precision]);
+}
+function toDatePickerParts(date, precision) {
+    if (precision === 'year')
+        return { year: date.year() };
+    if (precision === 'month')
+        return { year: date.year(), month: date.month() + 1 };
+    return { year: date.year(), month: date.month() + 1, day: date.date() };
+}
+function pathFromDate(date, precision) {
+    var _a, _b, _c;
+    const parts = toDatePickerParts(date, precision);
+    if (precision === 'year')
+        return [parts.year];
+    if (precision === 'month')
+        return [parts.year, (_a = parts.month) !== null && _a !== void 0 ? _a : 1];
+    return [parts.year, (_b = parts.month) !== null && _b !== void 0 ? _b : 1, (_c = parts.day) !== null && _c !== void 0 ? _c : 1];
+}
+function normalizeDateByPrecision(date, precision) {
+    if (precision === 'year')
+        return date.startOf('year');
+    if (precision === 'month')
+        return date.startOf('month');
+    return date.startOf('day');
+}
+function parseStringInput(input, fieldName) {
+    const value = input.trim();
+    if (!value)
+        return undefined;
+    const inputPrecision = /^\d{4}$/.test(value)
+        ? 'year'
+        : /^\d{4}-\d{1,2}$/.test(value)
+            ? 'month'
+            : /^\d{4}-\d{1,2}-\d{1,2}$/.test(value)
+                ? 'day'
+                : null;
+    if (!inputPrecision) {
+        throw new Error(`[zkit-ui][DatePicker] Invalid ${fieldName}: "${input}". Expected YYYY, YYYY-MM, or YYYY-MM-DD.`);
+    }
+    const format = PARSE_FORMATS[inputPrecision];
+    const date = (0, dayjs_1.default)(value, format, true);
+    if (!date.isValid()) {
+        throw new Error(`[zkit-ui][DatePicker] Invalid ${fieldName}: "${input}".`);
+    }
+    return { date, inputPrecision };
+}
+function parseDatePickerInput(input, fieldName) {
+    if (input == null)
+        return undefined;
+    if (typeof input === 'string')
+        return parseStringInput(input, fieldName);
+    const date = dayjs_1.default.isDayjs(input) ? input : (0, dayjs_1.default)(input);
+    if (!date.isValid()) {
+        throw new Error(`[zkit-ui][DatePicker] Invalid ${fieldName}.`);
+    }
+    return { date, inputPrecision: 'day' };
+}
+function resolveBoundary(input, kind) {
+    const parsed = parseDatePickerInput(input, kind);
+    if (!parsed)
+        return kind === 'min' ? DEFAULT_MIN : DEFAULT_MAX;
+    if (kind === 'min') {
+        return normalizeDateByPrecision(parsed.date, parsed.inputPrecision);
+    }
+    if (parsed.inputPrecision === 'year')
+        return parsed.date.endOf('year');
+    if (parsed.inputPrecision === 'month')
+        return parsed.date.endOf('month');
+    return parsed.date.endOf('day');
+}
+function resolveDatePickerBounds(min, max) {
+    const bounds = {
+        min: resolveBoundary(min, 'min'),
+        max: resolveBoundary(max, 'max'),
+    };
+    if (bounds.min.isAfter(bounds.max)) {
+        throw new Error('[zkit-ui][DatePicker] Invalid bounds: min is after max.');
+    }
+    return bounds;
+}
+function clampToBounds(date, bounds) {
+    if (date.isBefore(bounds.min))
+        return bounds.min;
+    if (date.isAfter(bounds.max))
+        return bounds.max;
+    return date;
+}
+function resolveCommittedDate(value, bounds, precision) {
+    const parsed = parseDatePickerInput(value, 'value');
+    if (!parsed)
+        return null;
+    return normalizeDateByPrecision(clampToBounds(parsed.date, bounds), precision);
+}
+function resolvePickerDate(committedDate, defaultPickerValue, bounds, precision) {
+    var _a;
+    if (committedDate)
+        return committedDate;
+    const parsed = parseDatePickerInput(defaultPickerValue, 'defaultPickerValue');
+    const seed = (_a = parsed === null || parsed === void 0 ? void 0 : parsed.date) !== null && _a !== void 0 ? _a : (0, dayjs_1.default)();
+    return normalizeDateByPrecision(clampToBounds(seed, bounds), precision);
+}
+function optionDate(parts) {
+    var _a, _b;
+    const month = (_a = parts.month) !== null && _a !== void 0 ? _a : 1;
+    const day = (_b = parts.day) !== null && _b !== void 0 ? _b : 1;
+    return (0, dayjs_1.default)(`${parts.year}-${pad2(month)}-${pad2(day)}`, 'YYYY-MM-DD', true).startOf('day');
+}
+function createOption(column, parts, disabled = false) {
+    var _a, _b;
+    const value = column === 'year' ? parts.year : column === 'month' ? (_a = parts.month) !== null && _a !== void 0 ? _a : 1 : (_b = parts.day) !== null && _b !== void 0 ? _b : 1;
+    return {
+        value,
+        label: column === 'year' ? String(value) : pad2(value),
+        disabled,
+        column,
+        year: parts.year,
+        month: parts.month,
+        day: parts.day,
+    };
+}
+function resolveDisabled(date, parts, column, precision, isDateDisabled) {
+    return !!(isDateDisabled === null || isDateDisabled === void 0 ? void 0 : isDateDisabled(date, { column, precision, parts }));
+}
+function buildDays(year, month, config) {
+    const { bounds, isDateDisabled, precision } = config;
+    const isMinMonth = year === bounds.min.year() && month === bounds.min.month() + 1;
+    const isMaxMonth = year === bounds.max.year() && month === bounds.max.month() + 1;
+    const monthStart = (0, dayjs_1.default)(`${year}-${pad2(month)}-01`, 'YYYY-MM-DD', true);
+    const dayMin = isMinMonth ? bounds.min.date() : 1;
+    const dayMax = isMaxMonth ? bounds.max.date() : monthStart.daysInMonth();
+    const days = [];
+    for (let day = dayMin; day <= dayMax; day += 1) {
+        const parts = { year, month, day };
+        days.push(createOption('day', parts, resolveDisabled(optionDate(parts), parts, 'day', precision, isDateDisabled)));
+    }
+    return days;
+}
+function buildMonths(year, config) {
+    const { bounds, isDateDisabled, precision } = config;
+    const isMinYear = year === bounds.min.year();
+    const isMaxYear = year === bounds.max.year();
+    const monthMin = isMinYear ? bounds.min.month() + 1 : 1;
+    const monthMax = isMaxYear ? bounds.max.month() + 1 : 12;
+    const months = [];
+    for (let month = monthMin; month <= monthMax; month += 1) {
+        const parts = { year, month };
+        const option = createOption('month', parts, precision === 'month'
+            ? resolveDisabled(optionDate(parts), parts, 'month', precision, isDateDisabled)
+            : false);
+        if (precision === 'day') {
+            option.children = buildDays(year, month, config);
+            option.disabled = option.children.length > 0 && option.children.every((child) => child.disabled);
+        }
+        months.push(option);
+    }
+    return months;
+}
+function buildDatePickerOptions(config) {
+    const { bounds, isDateDisabled, precision } = config;
+    const years = [];
+    for (let year = bounds.min.year(); year <= bounds.max.year(); year += 1) {
+        const parts = { year };
+        const option = createOption('year', parts, precision === 'year'
+            ? resolveDisabled(optionDate(parts), parts, 'year', precision, isDateDisabled)
+            : false);
+        if (precision !== 'year') {
+            option.children = buildMonths(year, config);
+            option.disabled = option.children.length > 0 && option.children.every((child) => child.disabled);
+        }
+        years.push(option);
+    }
+    return years;
+}
+function numberValues(values) {
+    return values.map((value) => Number(value)).filter((value) => Number.isFinite(value));
+}
+function dateFromPath(values, precision) {
+    const year = values[0];
+    if (!Number.isFinite(year))
+        return null;
+    const month = precision === 'year' ? 1 : values[1];
+    const day = precision === 'day' ? values[2] : 1;
+    if (!Number.isFinite(month) || !Number.isFinite(day))
+        return null;
+    const date = (0, dayjs_1.default)(`${year}-${pad2(month)}-${pad2(day)}`, 'YYYY-MM-DD', true);
+    return date.isValid() ? normalizeDateByPrecision(date, precision) : null;
+}
+function resolveSelectionLabel(selection, labelFormat) {
+    if (typeof labelFormat === 'function')
+        return labelFormat(selection);
+    if (typeof labelFormat === 'string' && labelFormat.trim())
+        return selection.date.format(labelFormat);
+    return selection.value;
+}
+function createDatePickerSelection(pickerSelection, precision, labelFormat, labelOverride) {
+    const values = numberValues(pickerSelection.values).slice(0, getColumnCount(precision));
+    const date = dateFromPath(values, precision);
+    if (!date)
+        return null;
+    const base = {
+        value: formatDatePickerValue(date, precision),
+        date,
+        precision,
+        parts: toDatePickerParts(date, precision),
+        values,
+        label: '',
+        labels: pickerSelection.labels.slice(0, getColumnCount(precision)),
+        items: pickerSelection.items.slice(0, getColumnCount(precision)),
+        columns: pickerSelection.columns.slice(0, getColumnCount(precision)),
+        indices: pickerSelection.indices.slice(0, getColumnCount(precision)),
+        isComplete: pickerSelection.isComplete,
+    };
+    return {
+        ...base,
+        label: labelOverride !== null && labelOverride !== void 0 ? labelOverride : resolveSelectionLabel(base, labelFormat),
+    };
+}
+function findOptionPath(options, values) {
+    const items = [];
+    const columns = [];
+    const indices = [];
+    let current = options;
+    for (const value of values) {
+        columns.push(current);
+        const index = current.findIndex((option) => option.value === value);
+        if (index < 0)
+            break;
+        const item = current[index];
+        if (!item)
+            break;
+        items.push(item);
+        indices.push(index);
+        current = Array.isArray(item.children) ? item.children : [];
+    }
+    return { items, columns, indices };
+}
+function createDatePickerSelectionFromDate(date, precision, options, labelFormat) {
+    const values = pathFromDate(date, precision);
+    const { items, columns, indices } = findOptionPath(options, values);
+    const labels = values.map((value, index) => (index === 0 ? String(value) : pad2(value)));
+    const base = {
+        value: formatDatePickerValue(date, precision),
+        date,
+        precision,
+        parts: toDatePickerParts(date, precision),
+        values,
+        label: '',
+        labels,
+        items,
+        columns,
+        indices,
+        isComplete: true,
+    };
+    return {
+        ...base,
+        label: resolveSelectionLabel(base, labelFormat),
+    };
+}
+function dateFromOption(option, precision) {
+    if (!option)
+        return undefined;
+    return normalizeDateByPrecision(optionDate(option), precision);
+}