@lynx-js/genui 0.0.1-rc.0 → 0.0.1

package/a2ui/dist/catalog/DateTimeInput/catalog.json

@@ -0,0 +1,165 @@
+{
+  "DateTimeInput": {
+    "properties": {
+      "value": {
+        "oneOf": [
+          {
+            "type": "string"
+          },
+          {
+            "type": "object",
+            "properties": {
+              "path": {
+                "type": "string"
+              }
+            },
+            "required": [
+              "path"
+            ],
+            "additionalProperties": false
+          }
+        ],
+        "description": "The current date/time value. Typically bound to a data path."
+      },
+      "label": {
+        "oneOf": [
+          {
+            "type": "string"
+          },
+          {
+            "type": "object",
+            "properties": {
+              "path": {
+                "type": "string"
+              }
+            },
+            "required": [
+              "path"
+            ],
+            "additionalProperties": false
+          },
+          {
+            "type": "object",
+            "properties": {
+              "call": {
+                "type": "string"
+              },
+              "args": {
+                "type": "object",
+                "additionalProperties": true
+              },
+              "returnType": {
+                "type": "string",
+                "enum": [
+                  "string",
+                  "number",
+                  "boolean",
+                  "object",
+                  "array",
+                  "any",
+                  "void"
+                ]
+              }
+            },
+            "required": [
+              "call",
+              "args"
+            ],
+            "additionalProperties": false
+          }
+        ],
+        "description": "The text label for the input field."
+      },
+      "enableDate": {
+        "type": "boolean",
+        "description": "Whether to show the date picker."
+      },
+      "enableTime": {
+        "type": "boolean",
+        "description": "Whether to show the time picker."
+      },
+      "outputFormat": {
+        "type": "string",
+        "description": "Format string for the output value. Supports YYYY, MM, DD, HH, and mm."
+      },
+      "min": {
+        "type": "string",
+        "description": "Minimum allowed date/time value."
+      },
+      "max": {
+        "type": "string",
+        "description": "Maximum allowed date/time value."
+      },
+      "checks": {
+        "type": "array",
+        "items": {
+          "type": "object",
+          "properties": {
+            "condition": {
+              "oneOf": [
+                {
+                  "type": "boolean"
+                },
+                {
+                  "type": "object",
+                  "properties": {
+                    "path": {
+                      "type": "string"
+                    }
+                  },
+                  "required": [
+                    "path"
+                  ],
+                  "additionalProperties": false
+                },
+                {
+                  "type": "object",
+                  "properties": {
+                    "call": {
+                      "type": "string"
+                    },
+                    "args": {
+                      "type": "object",
+                      "additionalProperties": true
+                    },
+                    "returnType": {
+                      "type": "string",
+                      "enum": [
+                        "string",
+                        "number",
+                        "boolean",
+                        "object",
+                        "array",
+                        "any",
+                        "void"
+                      ]
+                    }
+                  },
+                  "required": [
+                    "call",
+                    "args"
+                  ],
+                  "additionalProperties": false
+                }
+              ],
+              "description": "The condition that indicates whether the check passes."
+            },
+            "message": {
+              "type": "string",
+              "description": "The error message to display if the check fails."
+            }
+          },
+          "required": [
+            "condition",
+            "message"
+          ],
+          "additionalProperties": false
+        },
+        "description": "A list of checks to perform."
+      }
+    },
+    "required": [
+      "value"
+    ]
+  }
+}

package/a2ui/dist/catalog/DateTimeInput/index.d.ts

@@ -0,0 +1,43 @@
+import type { GenericComponentProps } from '../../store/types.js';
+import '../../../styles/catalog/DateTimeInput.css';
+/**
+ * @a2uiCatalog DateTimeInput
+ */
+export interface DateTimeInputProps extends GenericComponentProps {
+    /** The current date/time value. Typically bound to a data path. */
+    value: string | {
+        path: string;
+    };
+    /** The text label for the input field. */
+    label?: string | {
+        path: string;
+    } | {
+        call: string;
+        args: Record<string, unknown>;
+        returnType?: 'string' | 'number' | 'boolean' | 'array' | 'object' | 'any' | 'void';
+    };
+    /** Whether to show the date picker. */
+    enableDate?: boolean;
+    /** Whether to show the time picker. */
+    enableTime?: boolean;
+    /** Format string for the output value. Supports YYYY, MM, DD, HH, and mm. */
+    outputFormat?: string;
+    /** Minimum allowed date/time value. */
+    min?: string;
+    /** Maximum allowed date/time value. */
+    max?: string;
+    /** A list of checks to perform. */
+    checks?: Array<{
+        /** The condition that indicates whether the check passes. */
+        condition: boolean | {
+            path: string;
+        } | {
+            call: string;
+            args: Record<string, unknown>;
+            returnType?: 'string' | 'number' | 'boolean' | 'array' | 'object' | 'any' | 'void';
+        };
+        /** The error message to display if the check fails. */
+        message: string;
+    }>;
+}
+export declare function DateTimeInput(props: DateTimeInputProps): import('@lynx-js/react').ReactNode;

package/a2ui/dist/catalog/DateTimeInput/index.js

@@ -0,0 +1,147 @@
+import { jsx as _jsx, jsxs as _jsxs } from "@lynx-js/react/jsx-runtime";
+// Copyright 2026 The Lynx Authors. All rights reserved.
+// Licensed under the Apache License Version 2.0 that can be found in the
+// LICENSE file in the root directory of this source tree.
+import { DialogBackdrop, DialogContent, DialogRoot, DialogView, } from '@lynx-js/lynx-ui';
+import { useEffect, useState } from '@lynx-js/react';
+import { addMonths, buildDateTimeMonthPage, dateTimePartsToDate, formatDateTimeInputValue, getDateTimeDialogTitle, getDateTimeInputPlaceholder, getDefaultDateTimeParts, getWeekdayLabels, incrementDateTimePart, isDateTimeAfterMax, isDateTimeBeforeMin, normalizeDateTimeInputLabel, normalizeDateTimeInputMode, normalizeDateTimeInputValue, startOfMonth, withDate, } from './utils.js';
+import { useChecks } from '../../react/useChecks.js';
+import '../../../styles/catalog/DateTimeInput.css';
+const MONTH_LABELS = [
+    'January',
+    'February',
+    'March',
+    'April',
+    'May',
+    'June',
+    'July',
+    'August',
+    'September',
+    'October',
+    'November',
+    'December',
+];
+function formatMonthCaption(month) {
+    return `${MONTH_LABELS[month.getMonth()]} ${month.getFullYear()}`;
+}
+function joinClassNames(values) {
+    return values.filter(Boolean).join(' ');
+}
+function getPartsKey(parts) {
+    return parts
+        ? formatDateTimeInputValue(parts, 'YYYY-MM-DD HH:mm', { enableDate: true, enableTime: true })
+        : '';
+}
+export function DateTimeInput(props) {
+    const { dataContextPath, id, label, max, min, outputFormat, setValue, surface, } = props;
+    const mode = normalizeDateTimeInputMode(props.enableDate, props.enableTime);
+    const valueParts = normalizeDateTimeInputValue(props.value);
+    const minParts = normalizeDateTimeInputValue(min);
+    const maxParts = normalizeDateTimeInputValue(max);
+    const valueKey = getPartsKey(valueParts);
+    const initialParts = valueParts ?? getDefaultDateTimeParts();
+    const [open, setOpen] = useState(false);
+    const [draftParts, setDraftParts] = useState(initialParts);
+    const [visibleMonth, setVisibleMonth] = useState(startOfMonth(dateTimePartsToDate(initialParts)));
+    const checks = props.checks;
+    const { ok, firstFailureMessage } = useChecks({
+        checks,
+        componentId: id ?? '',
+        surface,
+        dataContextPath,
+    });
+    useEffect(() => {
+        if (open)
+            return undefined;
+        const nextParts = valueParts ?? getDefaultDateTimeParts();
+        setDraftParts(nextParts);
+        setVisibleMonth(startOfMonth(dateTimePartsToDate(nextParts)));
+        return undefined;
+    }, [open, valueKey]);
+    const minDate = minParts ? dateTimePartsToDate(minParts) : null;
+    const maxDate = maxParts ? dateTimePartsToDate(maxParts) : null;
+    const draftDate = dateTimePartsToDate(draftParts);
+    const monthPage = buildDateTimeMonthPage({
+        month: visibleMonth,
+        selectedDate: draftDate,
+        today: new Date(),
+        minDate,
+        maxDate,
+    });
+    const weekdayLabels = getWeekdayLabels();
+    const draftOutOfRange = isDateTimeBeforeMin(draftParts, minParts)
+        || isDateTimeAfterMax(draftParts, maxParts);
+    const currentOutOfRange = valueParts
+        ? isDateTimeBeforeMin(valueParts, minParts)
+            || isDateTimeAfterMax(valueParts, maxParts)
+        : false;
+    const invalid = !ok || currentOutOfRange;
+    const labelText = normalizeDateTimeInputLabel(label);
+    const displayValue = valueParts
+        ? formatDateTimeInputValue(valueParts, outputFormat, mode)
+        : getDateTimeInputPlaceholder(mode);
+    const handleOpen = () => {
+        const nextParts = valueParts ?? draftParts ?? getDefaultDateTimeParts();
+        setDraftParts(nextParts);
+        setVisibleMonth(startOfMonth(dateTimePartsToDate(nextParts)));
+        setOpen(true);
+    };
+    const handleCancel = () => {
+        setOpen(false);
+    };
+    const handleConfirm = () => {
+        if (draftOutOfRange)
+            return;
+        setValue?.('value', formatDateTimeInputValue(draftParts, outputFormat, mode));
+        setOpen(false);
+    };
+    const handlePreviousMonth = () => {
+        setVisibleMonth(addMonths(visibleMonth, -1));
+    };
+    const handleNextMonth = () => {
+        setVisibleMonth(addMonths(visibleMonth, 1));
+    };
+    const handleTimeStep = (part, delta) => {
+        setDraftParts((current) => incrementDateTimePart(current, part, delta));
+    };
+    const rootClassName = joinClassNames([
+        'datetime-input',
+        invalid && 'datetime-input-invalid',
+    ]);
+    return (_jsxs("view", { className: rootClassName, children: [labelText
+                ? _jsx("text", { className: 'datetime-input-label', children: labelText })
+                : null, _jsxs("view", { className: joinClassNames([
+                    'datetime-input-control',
+                    !valueParts && 'datetime-input-control-placeholder',
+                ]), bindtap: handleOpen, "event-through": false, children: [_jsx("text", { className: 'datetime-input-value', children: displayValue }), _jsx("text", { className: 'datetime-input-icon', children: "calendar_today" })] }), invalid && firstFailureMessage
+                ? _jsx("text", { className: 'datetime-input-error', children: firstFailureMessage })
+                : null, currentOutOfRange
+                ? _jsx("text", { className: 'datetime-input-error', children: "Date is out of range" })
+                : null, _jsx(DialogRoot, { show: open, onShowChange: (nextOpen) => {
+                    setOpen(nextOpen);
+                }, children: _jsxs(DialogView, { className: 'datetime-dialog-view', overlayLevel: 4, children: [_jsx(DialogBackdrop, { className: 'datetime-dialog-backdrop', clickToClose: true, transition: true }), _jsxs(DialogContent, { className: 'datetime-dialog-content', transition: true, children: [_jsxs("view", { className: 'datetime-dialog-header', children: [_jsx("text", { className: 'datetime-dialog-title', children: getDateTimeDialogTitle(labelText, mode) }), _jsx("view", { className: 'datetime-dialog-close', bindtap: handleCancel, "event-through": false, children: _jsx("text", { className: 'datetime-dialog-close-icon', children: "close" }) })] }), mode.enableDate
+                                    ? (_jsxs("view", { className: 'datetime-calendar', children: [_jsxs("view", { className: 'datetime-calendar-header', children: [_jsx("view", { className: 'datetime-calendar-nav', bindtap: handlePreviousMonth, "event-through": false, children: _jsx("text", { className: 'datetime-calendar-nav-icon', children: "chevron_left" }) }), _jsx("text", { className: 'datetime-calendar-caption', children: formatMonthCaption(visibleMonth) }), _jsx("view", { className: 'datetime-calendar-nav', bindtap: handleNextMonth, "event-through": false, children: _jsx("text", { className: 'datetime-calendar-nav-icon', children: "chevron_right" }) })] }), _jsx("view", { className: 'datetime-weekdays', children: weekdayLabels.map((weekday, weekdayIndex) => (_jsx("view", { className: 'datetime-weekday', children: _jsx("text", { className: 'datetime-weekday-text', children: weekday }) }, weekdayIndex))) }), _jsx("view", { className: 'datetime-month', children: monthPage.days.map((day, dayIndex) => (_jsx("view", { className: joinClassNames([
+                                                        'datetime-day',
+                                                        day.outside && 'datetime-day-outside',
+                                                        day.selected && 'datetime-day-selected',
+                                                        day.today && 'datetime-day-today',
+                                                        day.disabled && 'datetime-day-disabled',
+                                                    ]), bindtap: () => {
+                                                        if (day.disabled)
+                                                            return;
+                                                        setDraftParts((current) => withDate(current, day.date));
+                                                        if (day.outside) {
+                                                            setVisibleMonth(startOfMonth(day.date));
+                                                        }
+                                                    }, "event-through": false, children: _jsx("text", { className: 'datetime-day-text', children: String(day.day) }) }, dayIndex))) })] }))
+                                    : null, mode.enableTime
+                                    ? (_jsxs("view", { className: 'datetime-time', children: [_jsx("text", { className: 'datetime-time-label', children: "Time" }), _jsxs("view", { className: 'datetime-time-fields', children: [_jsxs("view", { className: 'datetime-time-field', children: [_jsx("view", { className: 'datetime-time-stepper', bindtap: () => handleTimeStep('hour', 1), "event-through": false, children: _jsx("text", { className: 'datetime-time-stepper-icon', children: "expand_less" }) }), _jsx("text", { className: 'datetime-time-value', children: String(draftParts.hour).padStart(2, '0') }), _jsx("view", { className: 'datetime-time-stepper', bindtap: () => handleTimeStep('hour', -1), "event-through": false, children: _jsx("text", { className: 'datetime-time-stepper-icon', children: "expand_more" }) })] }), _jsx("text", { className: 'datetime-time-separator', children: ":" }), _jsxs("view", { className: 'datetime-time-field', children: [_jsx("view", { className: 'datetime-time-stepper', bindtap: () => handleTimeStep('minute', 1), "event-through": false, children: _jsx("text", { className: 'datetime-time-stepper-icon', children: "expand_less" }) }), _jsx("text", { className: 'datetime-time-value', children: String(draftParts.minute).padStart(2, '0') }), _jsx("view", { className: 'datetime-time-stepper', bindtap: () => handleTimeStep('minute', -1), "event-through": false, children: _jsx("text", { className: 'datetime-time-stepper-icon', children: "expand_more" }) })] })] })] }))
+                                    : null, draftOutOfRange
+                                    ? (_jsx("text", { className: 'datetime-dialog-error', children: "Date is out of range" }))
+                                    : null, _jsxs("view", { className: 'datetime-dialog-actions', children: [_jsx("view", { className: 'datetime-dialog-button datetime-dialog-button-secondary', bindtap: handleCancel, "event-through": false, children: _jsx("text", { className: 'datetime-dialog-button-text-secondary', children: "Cancel" }) }), _jsx("view", { className: joinClassNames([
+                                                'datetime-dialog-button',
+                                                'datetime-dialog-button-primary',
+                                                draftOutOfRange && 'datetime-dialog-button-disabled',
+                                            ]), bindtap: handleConfirm, "event-through": false, children: _jsx("text", { className: 'datetime-dialog-button-text-primary', children: "Done" }) })] })] })] }) })] }, id));
+}
+//# sourceMappingURL=index.js.map

package/a2ui/dist/catalog/DateTimeInput/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/catalog/DateTimeInput/index.tsx"],"names":[],"mappings":"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"}

package/a2ui/dist/catalog/DateTimeInput/utils.d.ts

@@ -0,0 +1,53 @@
+export interface DateTimeParts {
+    year: number;
+    month: number;
+    day: number;
+    hour: number;
+    minute: number;
+}
+export interface DateTimeInputMode {
+    enableDate: boolean;
+    enableTime: boolean;
+}
+export interface DateTimeDayInfo {
+    date: Date;
+    dateKey: string;
+    day: number;
+    outside: boolean;
+    selected: boolean;
+    today: boolean;
+    disabled: boolean;
+}
+export interface DateTimeMonthPage {
+    month: Date;
+    monthKey: string;
+    days: DateTimeDayInfo[];
+}
+export interface BuildDateTimeMonthPageOptions {
+    month: Date;
+    selectedDate: Date | null;
+    today: Date;
+    minDate: Date | null;
+    maxDate: Date | null;
+    weekStartsOn?: number;
+}
+export declare function normalizeDateTimeInputValue(value: unknown): DateTimeParts | null;
+export declare function getDefaultDateTimeParts(now?: Date): DateTimeParts;
+export declare function dateTimePartsToDate(parts: DateTimeParts): Date;
+export declare function dateTimePartsToDateKey(parts: DateTimeParts): string;
+export declare function formatDateKey(date: Date): string;
+export declare function formatMonthKey(date: Date): string;
+export declare function startOfMonth(date: Date): Date;
+export declare function addMonths(date: Date, offset: number): Date;
+export declare function getWeekdayLabels(weekStartsOn?: number, labels?: string[]): string[];
+export declare function compareDateTimeParts(a: DateTimeParts, b: DateTimeParts): number;
+export declare function isDateTimeBeforeMin(value: DateTimeParts, min: DateTimeParts | null): boolean;
+export declare function isDateTimeAfterMax(value: DateTimeParts, max: DateTimeParts | null): boolean;
+export declare function buildDateTimeMonthPage({ month, selectedDate, today, minDate, maxDate, weekStartsOn, }: BuildDateTimeMonthPageOptions): DateTimeMonthPage;
+export declare function normalizeDateTimeInputMode(enableDate: unknown, enableTime: unknown): DateTimeInputMode;
+export declare function normalizeDateTimeInputLabel(value: unknown): string;
+export declare function formatDateTimeInputValue(parts: DateTimeParts, outputFormat: unknown, mode: DateTimeInputMode): string;
+export declare function getDateTimeInputPlaceholder(mode: DateTimeInputMode): string;
+export declare function getDateTimeDialogTitle(label: string, mode: DateTimeInputMode): string;
+export declare function withDate(parts: DateTimeParts, date: Date): DateTimeParts;
+export declare function incrementDateTimePart(parts: DateTimeParts, part: 'hour' | 'minute', delta: number): DateTimeParts;

package/a2ui/dist/catalog/DateTimeInput/utils.js

@@ -0,0 +1,248 @@
+// Copyright 2026 The Lynx Authors. All rights reserved.
+// Licensed under the Apache License Version 2.0 that can be found in the
+// LICENSE file in the root directory of this source tree.
+const DAYS_PER_WEEK = 7;
+const DATE_TIME_DAYS_PER_MONTH_PAGE = 42;
+const DEFAULT_WEEKDAY_LABELS = ['Su', 'Mo', 'Tu', 'We', 'Th', 'Fr', 'Sa'];
+function pad2(value) {
+    return value < 10 ? `0${value}` : `${value}`;
+}
+function pad4(value) {
+    if (value < 10)
+        return `000${value}`;
+    if (value < 100)
+        return `00${value}`;
+    if (value < 1000)
+        return `0${value}`;
+    return `${value}`;
+}
+function createLocalDate(year, month, day = 1, hour = 0, minute = 0) {
+    return new Date(year, month, day, hour, minute, 0, 0);
+}
+function isValidDate(value) {
+    return !Number.isNaN(value.getTime());
+}
+function daysInMonth(year, month) {
+    return createLocalDate(year, month, 0).getDate();
+}
+function isValidDatePart(year, month, day) {
+    return month >= 1
+        && month <= 12
+        && day >= 1
+        && day <= daysInMonth(year, month);
+}
+function isValidTimePart(hour, minute) {
+    return hour >= 0 && hour <= 23 && minute >= 0 && minute <= 59;
+}
+function partsFromDate(value) {
+    return {
+        year: value.getFullYear(),
+        month: value.getMonth() + 1,
+        day: value.getDate(),
+        hour: value.getHours(),
+        minute: value.getMinutes(),
+    };
+}
+function parseDateTimeString(value) {
+    const trimmed = value.trim();
+    if (!trimmed)
+        return null;
+    const dateTimeMatch = /^(\d{4})-(\d{2})-(\d{2})(?:[ T](\d{2}):(\d{2}))?$/
+        .exec(trimmed);
+    if (dateTimeMatch) {
+        const [, year, month, day, hour = '0', minute = '0'] = dateTimeMatch;
+        const yearValue = Number(year);
+        const monthValue = Number(month);
+        const dayValue = Number(day);
+        const hourValue = Number(hour);
+        const minuteValue = Number(minute);
+        if (!isValidDatePart(yearValue, monthValue, dayValue)
+            || !isValidTimePart(hourValue, minuteValue)) {
+            return null;
+        }
+        const date = createLocalDate(yearValue, monthValue - 1, dayValue, hourValue, minuteValue);
+        return isValidDate(date) ? partsFromDate(date) : null;
+    }
+    const timeMatch = /^(\d{2}):(\d{2})$/.exec(trimmed);
+    if (timeMatch) {
+        const today = new Date();
+        const [, hour, minute] = timeMatch;
+        const hourValue = Number(hour);
+        const minuteValue = Number(minute);
+        if (!isValidTimePart(hourValue, minuteValue))
+            return null;
+        const date = createLocalDate(today.getFullYear(), today.getMonth(), today.getDate(), hourValue, minuteValue);
+        return isValidDate(date) ? partsFromDate(date) : null;
+    }
+    const date = new Date(trimmed);
+    return isValidDate(date) ? partsFromDate(date) : null;
+}
+export function normalizeDateTimeInputValue(value) {
+    if (value instanceof Date) {
+        return isValidDate(value) ? partsFromDate(value) : null;
+    }
+    if (typeof value === 'number') {
+        const date = new Date(value);
+        return isValidDate(date) ? partsFromDate(date) : null;
+    }
+    if (typeof value === 'string') {
+        return parseDateTimeString(value);
+    }
+    return null;
+}
+export function getDefaultDateTimeParts(now = new Date()) {
+    return {
+        year: now.getFullYear(),
+        month: now.getMonth() + 1,
+        day: now.getDate(),
+        hour: now.getHours(),
+        minute: now.getMinutes(),
+    };
+}
+export function dateTimePartsToDate(parts) {
+    return createLocalDate(parts.year, parts.month - 1, parts.day, parts.hour, parts.minute);
+}
+export function dateTimePartsToDateKey(parts) {
+    return `${pad4(parts.year)}-${pad2(parts.month)}-${pad2(parts.day)}`;
+}
+export function formatDateKey(date) {
+    return [
+        pad4(date.getFullYear()),
+        pad2(date.getMonth() + 1),
+        pad2(date.getDate()),
+    ].join('-');
+}
+export function formatMonthKey(date) {
+    return `${pad4(date.getFullYear())}-${pad2(date.getMonth() + 1)}`;
+}
+export function startOfMonth(date) {
+    return createLocalDate(date.getFullYear(), date.getMonth(), 1);
+}
+export function addMonths(date, offset) {
+    return createLocalDate(date.getFullYear(), date.getMonth() + offset, 1);
+}
+export function getWeekdayLabels(weekStartsOn = 0, labels = DEFAULT_WEEKDAY_LABELS) {
+    const start = Math.max(0, Math.min(6, Math.floor(weekStartsOn)));
+    return Array.from({ length: DAYS_PER_WEEK }, (_, index) => {
+        const weekdayIndex = (start + index) % DAYS_PER_WEEK;
+        return labels[weekdayIndex] ?? DEFAULT_WEEKDAY_LABELS[weekdayIndex];
+    });
+}
+function compareDateOnly(a, b) {
+    const left = a.getFullYear() * 10000
+        + (a.getMonth() + 1) * 100
+        + a.getDate();
+    const right = b.getFullYear() * 10000
+        + (b.getMonth() + 1) * 100
+        + b.getDate();
+    return left - right;
+}
+export function compareDateTimeParts(a, b) {
+    const left = a.year * 100000000
+        + a.month * 1000000
+        + a.day * 10000
+        + a.hour * 100
+        + a.minute;
+    const right = b.year * 100000000
+        + b.month * 1000000
+        + b.day * 10000
+        + b.hour * 100
+        + b.minute;
+    return left - right;
+}
+export function isDateTimeBeforeMin(value, min) {
+    return min !== null && compareDateTimeParts(value, min) < 0;
+}
+export function isDateTimeAfterMax(value, max) {
+    return max !== null && compareDateTimeParts(value, max) > 0;
+}
+export function buildDateTimeMonthPage({ month, selectedDate, today, minDate, maxDate, weekStartsOn = 0, }) {
+    const monthStart = startOfMonth(month);
+    const normalizedWeekStart = Math.max(0, Math.min(6, Math.floor(weekStartsOn)));
+    const firstWeekdayOffset = (monthStart.getDay() - normalizedWeekStart + DAYS_PER_WEEK)
+        % DAYS_PER_WEEK;
+    const gridStart = createLocalDate(monthStart.getFullYear(), monthStart.getMonth(), 1 - firstWeekdayOffset);
+    const selectedDateKey = selectedDate ? formatDateKey(selectedDate) : null;
+    const todayKey = formatDateKey(today);
+    const days = Array.from({ length: DATE_TIME_DAYS_PER_MONTH_PAGE }, (_, index) => {
+        const date = createLocalDate(gridStart.getFullYear(), gridStart.getMonth(), gridStart.getDate() + index);
+        const dateKey = formatDateKey(date);
+        const outside = date.getMonth() !== monthStart.getMonth();
+        const disabled = (minDate !== null && compareDateOnly(date, minDate) < 0)
+            || (maxDate !== null && compareDateOnly(date, maxDate) > 0);
+        return {
+            date,
+            dateKey,
+            day: date.getDate(),
+            outside,
+            selected: dateKey === selectedDateKey,
+            today: dateKey === todayKey,
+            disabled,
+        };
+    });
+    return {
+        month: monthStart,
+        monthKey: formatMonthKey(monthStart),
+        days,
+    };
+}
+export function normalizeDateTimeInputMode(enableDate, enableTime) {
+    const date = enableDate !== false;
+    const time = enableTime !== false;
+    if (!date && !time) {
+        return { enableDate: true, enableTime: false };
+    }
+    return { enableDate: date, enableTime: time };
+}
+export function normalizeDateTimeInputLabel(value) {
+    if (typeof value === 'string'
+        || typeof value === 'number'
+        || typeof value === 'boolean') {
+        return String(value);
+    }
+    return '';
+}
+function getDefaultOutputFormat(mode) {
+    if (!mode.enableDate && mode.enableTime)
+        return 'HH:mm';
+    return 'YYYY-MM-DD';
+}
+export function formatDateTimeInputValue(parts, outputFormat, mode) {
+    const format = typeof outputFormat === 'string' && outputFormat.trim()
+        ? outputFormat
+        : getDefaultOutputFormat(mode);
+    return format
+        .replaceAll('YYYY', pad4(parts.year))
+        .replaceAll('MM', pad2(parts.month))
+        .replaceAll('DD', pad2(parts.day))
+        .replaceAll('HH', pad2(parts.hour))
+        .replaceAll('mm', pad2(parts.minute));
+}
+export function getDateTimeInputPlaceholder(mode) {
+    if (mode.enableDate && mode.enableTime)
+        return 'Select date and time';
+    if (mode.enableTime)
+        return 'Select time';
+    return 'Select date';
+}
+export function getDateTimeDialogTitle(label, mode) {
+    return label || getDateTimeInputPlaceholder(mode);
+}
+export function withDate(parts, date) {
+    return {
+        ...parts,
+        year: date.getFullYear(),
+        month: date.getMonth() + 1,
+        day: date.getDate(),
+    };
+}
+export function incrementDateTimePart(parts, part, delta) {
+    const limit = part === 'hour' ? 24 : 60;
+    const current = parts[part];
+    const next = ((current + delta) % limit + limit) % limit;
+    return {
+        ...parts,
+        [part]: next,
+    };
+}
+//# sourceMappingURL=utils.js.map