@allxsmith/bestax-bulma 5.27.0 → 5.27.2

package/dist/esm/form/DateTimeInputBase.js

@@ -0,0 +1,333 @@
+/* @allxsmith/bestax-bulma — AI agents: see AGENTS.md in the package root, or https://bestax.io/llms.txt */
+import { jsx, jsxs } from 'react/jsx-runtime';
+import { forwardRef, useState, useMemo, useEffect, useRef, useId, useCallback } from 'react';
+import { usePrefixedClassNames, classNames } from '../helpers/classNames.js';
+import { useBulmaClasses } from '../helpers/useBulmaClasses.js';
+import { mergeLabels } from './_pickerInternals/pickerTypes.js';
+import { hourCycleFromFormat, DEFAULT_DATETIME_FORMAT, formatDateTime, parseDate, formatTime } from './_pickerInternals/formatters.js';
+import { floorMin, clampDate, setTimeOfDay, isWithin, isSameDay, FIRST_YEAR, makeDate } from './_pickerInternals/dateUtils.js';
+import { Calendar, CALENDAR_FOCUSED_CELL } from './_pickerInternals/Calendar.js';
+import { TimeWheels } from './_pickerInternals/TimeWheels.js';
+import { PickerPopover } from './_pickerInternals/PickerPopover.js';
+import { useNativeMobilePicker } from './_pickerInternals/useNativeMobilePicker.js';
+import { useSegmentedEntry } from './_pickerInternals/useSegmentedEntry.js';
+import { useControlLoading } from './controlLoading.js';
+import { Icon } from '../elements/Icon.js';
+import { getActiveElementInTree } from '../helpers/shadowDom.js';
+import { inertProps } from '../helpers/inertProps.js';
+
+// The year is padded to four digits, as `datetime-local` requires. HTML has
+// no such shape for a year before 1, so a date then is empty, as that input
+// would make it.
+const toIsoDateTime = (d, withSeconds) => {
+    if (d.getFullYear() < FIRST_YEAR)
+        return '';
+    const yyyy = String(d.getFullYear()).padStart(4, '0');
+    const mo = String(d.getMonth() + 1).padStart(2, '0');
+    const dd = String(d.getDate()).padStart(2, '0');
+    const hh = String(d.getHours()).padStart(2, '0');
+    const mm = String(d.getMinutes()).padStart(2, '0');
+    const ss = String(d.getSeconds()).padStart(2, '0');
+    return withSeconds
+        ? `${yyyy}-${mo}-${dd}T${hh}:${mm}:${ss}`
+        : `${yyyy}-${mo}-${dd}T${hh}:${mm}`;
+};
+const fromIsoDateTime = (s) => {
+    // The HTML datetime-local value may carry fractional seconds (the spec
+    // allows them and some engines normalize to `:ss.sss`); accept and drop.
+    // Its year is four or more digits, as `toIsoDateTime` writes one past 9999.
+    const m = /^(\d{4,})-(\d{2})-(\d{2})T(\d{2}):(\d{2})(?::(\d{2})(?:\.\d{1,3})?)?$/.exec(s);
+    if (!m)
+        return null;
+    const d = makeDate(Number(m[1]), Number(m[2]) - 1, Number(m[3]));
+    d.setHours(Number(m[4]), Number(m[5]), m[6] ? Number(m[6]) : 0, 0);
+    return d;
+};
+/**
+ * Raw DateTimeInput — combined input + calendar + time spinner without
+ * Field/Control wrapping. Use `DateTimeInput` for the convenience wrapper.
+ *
+ * @function
+ * @param {DateTimeInputBaseProps} props
+ * @returns {JSX.Element}
+ */
+const DateTimeInputBase = forwardRef((props, ref) => {
+    const { value: controlledValue, defaultValue, onChange, onOpen, onClose, min, max, disabled, readOnly, placeholder, format, parse, locale, inline = false, mobileNative = 'auto', editable = true, popover = true, openOnFocus = true, closeOnSelect = false, position = 'bottom-left', appendToBody = false, color, size, isRounded, shouldDisableDate, unselectableDates, firstDayOfWeek = 0, dayNames, monthNames, nearbyMonthDays = true, hourFormat = '24', enableSeconds = false, incrementHours = 1, 
+    // Step between visible wheel values; 1 gives the iOS-style every-minute wheel.
+    incrementMinutes = 1, incrementSeconds = 1, unselectableTimes, className, name, form, required, id, onFocus, onClick, onKeyDown, onBlur, iconLeftName: _iconLeftName, triggerIcon: triggerIconProp, triggerIconName = 'chevron-down', audioTick = false, haptics = false, labels, ...rest } = props;
+    // The launcher gives way to the loading spinner of a Control this sits in.
+    const controlLoading = useControlLoading();
+    const triggerIcon = triggerIconProp ?? !controlLoading;
+    const t = mergeLabels(labels);
+    // Platform-appropriate feedback routing for the time wheel: on iOS (no
+    // navigator.vibrate) the audio thunk fills in; on Android the real haptic
+    // fires and no audio is layered on. `audioTick` always wins.
+    const hasVibrate = typeof navigator !== 'undefined' && typeof navigator.vibrate === 'function';
+    const effectiveAudioTick = audioTick || (haptics && !hasVibrate);
+    const isControlled = controlledValue !== undefined;
+    const [internalValue, setInternalValue] = useState(defaultValue ?? null);
+    const value = isControlled ? (controlledValue ?? null) : internalValue;
+    // Nothing before year 1 is in range, as in HTML's date inputs.
+    const lowerBound = useMemo(() => floorMin(min), [min]);
+    const initialFocused = useMemo(() => clampDate(value ?? new Date(), lowerBound, max), 
+    // eslint-disable-next-line react-hooks/exhaustive-deps
+    []);
+    const [focusedDate, setFocusedDate] = useState(initialFocused);
+    // Re-clamp focusedDate when min/max change so the focused cell stays valid.
+    useEffect(() => {
+        setFocusedDate(prev => clampDate(prev, lowerBound, max));
+    }, [lowerBound, max]);
+    const defaultFormat = format ??
+        (hourFormat === '12'
+            ? enableSeconds
+                ? 'YYYY-MM-DD hh:mm:ss A'
+                : 'YYYY-MM-DD hh:mm A'
+            : enableSeconds
+                ? 'YYYY-MM-DD HH:mm:ss'
+                : DEFAULT_DATETIME_FORMAT);
+    // The displayed format is the source of truth for the hour cycle: an explicit
+    // 12-hour `format` must drive a 12-hour wheel + pill even when `hourFormat`
+    // was left at its default. Fall back to the raw prop only when the cycle
+    // can't be read from the format (an Intl-options object, or no hour token).
+    const effectiveHourFormat = hourCycleFromFormat(defaultFormat) ?? hourFormat;
+    const [open, setOpenState] = useState(false);
+    // The time wheels are collapsed by default (iOS-style); the user reveals
+    // them by clicking the time value in the footer.
+    const [timeOpen, setTimeOpen] = useState(false);
+    const [text, setText] = useState(value ? formatDateTime(value, defaultFormat, locale) : '');
+    const inputRef = useRef(null);
+    const containerRef = useRef(null);
+    // Snapshot of the value when the popover opens, so Reset can revert the
+    // edits made in this session (reverting to empty if it opened empty).
+    const valueAtOpenRef = useRef(null);
+    const reactId = useId();
+    const popoverId = id ? `${id}-popover` : `picker-${reactId}`;
+    const timeWheelsId = `${popoverId}-time`;
+    const { bulmaHelperClasses, rest: cleanRest } = useBulmaClasses(rest);
+    const { shouldUseNative, isSmallViewport } = useNativeMobilePicker({
+        force: mobileNative === 'auto' ? undefined : mobileNative,
+    });
+    const useNative = !inline && shouldUseNative;
+    const wheelItemHeight = isSmallViewport ? 40 : 32;
+    // Time-only format for the footer's "Time  5:07 PM" display.
+    const timeDisplayFormat = effectiveHourFormat === '12'
+        ? enableSeconds
+            ? 'h:mm:ss A'
+            : 'h:mm A'
+        : enableSeconds
+            ? 'HH:mm:ss'
+            : 'HH:mm';
+    const inputClass = usePrefixedClassNames('input', {
+        [`is-${color}`]: !!color,
+        [`is-${size}`]: !!size,
+        'is-rounded': isRounded,
+    });
+    const containerClass = usePrefixedClassNames('datetimeinput-container');
+    const triggerClass = usePrefixedClassNames('datetimeinput-trigger');
+    const panelClass = usePrefixedClassNames('datetimeinput');
+    const calendarWrapClass = usePrefixedClassNames('datetimeinput-calendar-wrap');
+    const timeOverlayClass = usePrefixedClassNames('datetimeinput-time-overlay');
+    const timeCardClass = usePrefixedClassNames('datetimeinput-time-card');
+    const footerClass = usePrefixedClassNames('datetimeinput-footer');
+    const footerTimeClass = usePrefixedClassNames('datetimeinput-footer-time');
+    const footerActionsClass = usePrefixedClassNames('datetimeinput-footer-actions');
+    const footerResetClass = usePrefixedClassNames('datetimeinput-footer-reset');
+    const footerDoneClass = usePrefixedClassNames('datetimeinput-footer-done');
+    const footerTimePillClass = usePrefixedClassNames('datetimeinput-footer-time-pill');
+    // What the latest request asked for, so a second request in the same event
+    // sees it before React renders. The callbacks fire here rather than in a
+    // state updater, which StrictMode calls twice, and after the state is set,
+    // so a request a callback makes is the one that lands last.
+    const requestedOpenRef = useRef(false);
+    const setOpen = useCallback((next) => {
+        if (requestedOpenRef.current === next)
+            return;
+        requestedOpenRef.current = next;
+        setOpenState(next);
+        if (next) {
+            valueAtOpenRef.current = value;
+            onOpen?.();
+        }
+        else {
+            onClose?.();
+        }
+    }, [onOpen, onClose, value]);
+    useEffect(() => {
+        setText(value ? formatDateTime(value, defaultFormat, locale) : '');
+    }, [value, defaultFormat, locale]);
+    // Collapse the time wheels whenever the popover closes.
+    useEffect(() => {
+        if (!open)
+            setTimeOpen(false);
+    }, [open]);
+    // The footer's Time button opens the wheels, and the hours wheel takes
+    // focus so the keys turn it straight away. The calendar they cover is
+    // inert meanwhile, so no tab stop, pointer or screen reader reaches a day
+    // behind them. Closing the wheels hands focus back to the button: focus
+    // in them would fall to the page as they unmount, and a pointer press
+    // outside them has already dropped it on the panel or the page. Focus the
+    // keys moved on to the footer, such as Reset, stays there.
+    const panelRef = useRef(null);
+    const timeButtonRef = useRef(null);
+    const timeOverlayRef = useRef(null);
+    useEffect(() => {
+        if (!timeOpen)
+            return;
+        timeOverlayRef.current
+            ?.querySelector('[role="spinbutton"]')
+            ?.focus();
+    }, [timeOpen]);
+    const closeTime = useCallback(() => {
+        const panel = panelRef.current;
+        const active = getActiveElementInTree(panel);
+        const movedOn = !!panel?.contains(active) && !timeOverlayRef.current?.contains(active);
+        if (!movedOn)
+            timeButtonRef.current?.focus();
+        setTimeOpen(false);
+    }, []);
+    const commitValue = useCallback((next) => {
+        if (!isControlled)
+            setInternalValue(next);
+        // Keep the calendar's focused cell tracking typed / parsed values.
+        if (next)
+            setFocusedDate(next);
+        onChange?.(next);
+    }, [isControlled, onChange]);
+    // A picked day takes the value's whole time of day, seconds and all, or
+    // midnight in an empty field. The day handed over by the keyboard is the
+    // calendar's focused date, which can carry the time of the clock it
+    // started from, so none of its time is kept.
+    const handleDateSelect = useCallback((d) => {
+        const merged = setTimeOfDay(d, {
+            hours: value?.getHours() ?? 0,
+            minutes: value?.getMinutes() ?? 0,
+            seconds: value?.getSeconds() ?? 0,
+            milliseconds: value?.getMilliseconds() ?? 0,
+        });
+        if (!isWithin(merged, lowerBound, max))
+            return;
+        commitValue(merged);
+        setFocusedDate(d);
+    }, [value, lowerBound, max, commitValue]);
+    // The wheels set the value's time. An empty field starts from the focused
+    // day, at the whole minute or second the wheels show.
+    const handleTimeChange = useCallback((parts) => {
+        const next = value
+            ? setTimeOfDay(value, parts)
+            : setTimeOfDay(focusedDate, {
+                ...parts,
+                seconds: parts.seconds ?? 0,
+                milliseconds: 0,
+            });
+        if (!isWithin(next, lowerBound, max))
+            return;
+        commitValue(next);
+    }, [value, focusedDate, lowerBound, max, commitValue]);
+    const tryParse = useCallback((s) => {
+        const trimmed = s.trim();
+        if (!trimmed)
+            return null;
+        if (parse)
+            return parse(trimmed);
+        const fmt = typeof defaultFormat === 'string' ? defaultFormat : undefined;
+        return parseDate(trimmed, fmt ?? DEFAULT_DATETIME_FORMAT);
+    }, [parse, defaultFormat, locale]);
+    // The Date the user edits when starting without a current value: now, at
+    // the whole minute, or the whole second with `enableSeconds`.
+    const makeBaseDate = useCallback(() => setTimeOfDay(new Date(), {
+        seconds: enableSeconds ? undefined : 0,
+        milliseconds: 0,
+    }), [enableSeconds]);
+    const inputReadOnlyAttr = !!readOnly || !editable;
+    const canOpen = !!popover && !disabled && !readOnly;
+    // Blocking predicate for manual entry, combining the calendar's
+    // disabled-day logic with the wheels' unselectable-times predicate. The
+    // candidate passed in carries the full date-time, so date predicates
+    // should use day-based checks.
+    const isBlocked = useMemo(() => {
+        if (!shouldDisableDate && !unselectableDates?.length && !unselectableTimes)
+            return undefined;
+        return (d) => !!shouldDisableDate?.(d) ||
+            !!unselectableDates?.some(u => isSameDay(u, d)) ||
+            !!unselectableTimes?.(d);
+    }, [shouldDisableDate, unselectableDates, unselectableTimes]);
+    const { inputHandlers } = useSegmentedEntry({
+        format: defaultFormat,
+        value,
+        commitValue,
+        formatFn: formatDateTime,
+        tryParse,
+        text,
+        setText,
+        makeBaseDate,
+        locale,
+        min: lowerBound,
+        max,
+        isBlocked,
+        disabled,
+        readOnly,
+        editable,
+        popover,
+        openOnFocus,
+        closeOnSelect,
+        isOpen: open,
+        setOpen,
+        inputRef,
+        containerRef,
+        onFocus,
+        onClick,
+        onKeyDown,
+        onBlur,
+    });
+    const combinedRef = useCallback((node) => {
+        inputRef.current =
+            node;
+        if (typeof ref === 'function')
+            ref(node);
+        else if (ref)
+            ref.current = node;
+    }, [ref]);
+    if (useNative) {
+        const nativeStep = enableSeconds ? incrementSeconds : incrementMinutes * 60;
+        return (jsx("input", { ...cleanRest, ref: combinedRef, type: "datetime-local", step: nativeStep, className: classNames(inputClass, bulmaHelperClasses, className), value: value ? toIsoDateTime(value, enableSeconds) : '', onChange: e => {
+                const parsed = e.target.value
+                    ? fromIsoDateTime(e.target.value)
+                    : null;
+                commitValue(parsed);
+            }, min: min ? toIsoDateTime(lowerBound, enableSeconds) : undefined, max: max ? toIsoDateTime(max, enableSeconds) : undefined, disabled: disabled, readOnly: readOnly, placeholder: placeholder, name: name, form: form, required: required, id: id }));
+    }
+    const spinnerValue = {
+        hours: value?.getHours() ?? 0,
+        minutes: value?.getMinutes() ?? 0,
+        seconds: enableSeconds ? (value?.getSeconds() ?? 0) : undefined,
+    };
+    const panel = (jsxs("div", { ref: panelRef, className: panelClass, onKeyDown: e => {
+            // First Escape collapses the floating time wheels; the popover's own
+            // Escape handler (which closes the whole panel) only sees the second.
+            if (timeOpen && e.key === 'Escape') {
+                e.stopPropagation();
+                closeTime();
+            }
+        }, children: [jsxs("div", { className: calendarWrapClass, children: [jsx("div", { ...inertProps(timeOpen), children: jsx(Calendar, { value: value, focusedDate: focusedDate, onSelect: handleDateSelect, onFocusedDateChange: setFocusedDate, min: min, max: max, shouldDisableDate: shouldDisableDate, unselectableDates: unselectableDates, firstDayOfWeek: firstDayOfWeek, locale: locale, dayNames: dayNames, monthNames: monthNames, nearbyMonthDays: nearbyMonthDays, color: color, size: size, id: `${popoverId}-cal`, autoFocusCell: open, labels: labels }) }), timeOpen && (jsx("div", { ref: timeOverlayRef, className: timeOverlayClass, onClick: e => {
+                            // Tap outside the wheel card (on the covered calendar area)
+                            // collapses the wheels without selecting a date, matching the
+                            // native behavior.
+                            if (e.target === e.currentTarget)
+                                closeTime();
+                        }, children: jsx("div", { className: timeCardClass, children: jsx(TimeWheels, { value: spinnerValue, onChange: handleTimeChange, hourFormat: effectiveHourFormat, enableSeconds: enableSeconds, incrementHours: incrementHours, incrementMinutes: incrementMinutes, incrementSeconds: incrementSeconds, unselectableTimes: unselectableTimes, color: color, size: size, disabled: disabled, id: timeWheelsId, labels: labels, itemHeight: wheelItemHeight, audioTick: effectiveAudioTick, 
+                                // Enter on a wheel commits the time, which the wheels already
+                                // did live, and closes: the popover, or inline, where there
+                                // is no popover, the wheels, as Escape does.
+                                onCommit: () => (inline ? closeTime() : setOpen(false)) }) }) }))] }), jsxs("div", { className: footerClass, children: [jsxs("button", { ref: timeButtonRef, type: "button", className: footerTimeClass, onClick: () => (timeOpen ? closeTime() : setTimeOpen(true)), "aria-expanded": timeOpen, "aria-controls": timeOpen ? timeWheelsId : undefined, disabled: disabled, children: [jsx("span", { children: t.time }), jsx("span", { className: footerTimePillClass, children: value ? formatTime(value, timeDisplayFormat, locale) : '—' })] }), jsxs("div", { className: footerActionsClass, children: [jsx("button", { type: "button", className: footerResetClass, onClick: () => commitValue(valueAtOpenRef.current), children: t.reset }), jsx("button", { type: "button", className: footerDoneClass, "aria-label": t.done, onClick: () => setOpen(false), children: jsx("svg", { width: "22", height: "22", viewBox: "0 0 22 22", "aria-hidden": "true", children: jsx("path", { d: "M5 11l4 4 8-8", fill: "none", stroke: "currentColor", strokeWidth: "2.5", strokeLinecap: "round", strokeLinejoin: "round" }) }) })] })] })] }));
+    if (inline) {
+        return (jsxs("div", { ...cleanRest, ref: containerRef, className: classNames(containerClass, bulmaHelperClasses, className), children: [panel, name && (jsx("input", { type: "hidden", name: name, form: form, value: value ? toIsoDateTime(value, enableSeconds) : '', required: required }))] }));
+    }
+    return (jsxs("div", { ref: containerRef, className: classNames(containerClass, bulmaHelperClasses, className), ...cleanRest, children: [jsx("input", { ref: combinedRef, type: "text", role: "combobox", "aria-haspopup": "dialog", "aria-expanded": open, "aria-controls": popoverId, autoComplete: "off", className: inputClass, value: text, placeholder: placeholder, disabled: disabled, readOnly: inputReadOnlyAttr, name: name, form: form, required: required, id: id, ...inputHandlers }), popover && triggerIcon && (jsx("button", { type: "button", className: triggerClass, onClick: () => {
+                    if (canOpen)
+                        setOpen(!open);
+                }, disabled: !canOpen, "aria-label": t.chooseDateTime, "aria-haspopup": "dialog", "aria-controls": popoverId, "aria-expanded": open, tabIndex: canOpen ? 0 : -1, children: jsx(Icon, { name: triggerIconName, size: size }) })), popover && (jsx(PickerPopover, { isOpen: open, onClose: () => setOpen(false), anchorRef: containerRef, position: position, appendToBody: appendToBody, ariaLabel: t.chooseDateTime, id: popoverId, restoreFocusRef: inputRef, initialFocusSelector: CALENDAR_FOCUSED_CELL, children: panel }))] }));
+});
+DateTimeInputBase.displayName = 'DateTimeInputBase';
+
+export { DateTimeInputBase };
+//# sourceMappingURL=DateTimeInputBase.js.map

package/dist/esm/form/DateTimeInputBase.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"DateTimeInputBase.js","sources":["../../../src/form/DateTimeInputBase.tsx"],"sourcesContent":["import React, {\n  forwardRef,\n  useCallback,\n  useEffect,\n  useId,\n  useMemo,\n  useRef,\n  useState,\n} from 'react';\nimport { classNames, usePrefixedClassNames } from '../helpers/classNames';\nimport { useBulmaClasses, BulmaClassesProps } from '../helpers/useBulmaClasses';\nimport {\n  PickerPosition,\n  HourFormat,\n  DayOfWeek,\n  PickerLabels,\n  mergeLabels,\n} from './_pickerInternals/pickerTypes';\nimport {\n  formatDateTime,\n  formatTime,\n  hourCycleFromFormat,\n  parseDate,\n  DateFormatOption,\n  DEFAULT_DATETIME_FORMAT,\n} from './_pickerInternals/formatters';\nimport {\n  isWithin,\n  setTimeOfDay,\n  clampDate,\n  FIRST_YEAR,\n  floorMin,\n  isSameDay,\n  makeDate,\n} from './_pickerInternals/dateUtils';\nimport { Calendar, CALENDAR_FOCUSED_CELL } from './_pickerInternals/Calendar';\nimport { TimeWheels } from './_pickerInternals/TimeWheels';\nimport { PickerPopover } from './_pickerInternals/PickerPopover';\nimport { useNativeMobilePicker } from './_pickerInternals/useNativeMobilePicker';\nimport { useSegmentedEntry } from './_pickerInternals/useSegmentedEntry';\nimport { useControlLoading } from './controlLoading';\nimport { Icon } from '../elements/Icon';\nimport { getActiveElementInTree } from '../helpers/shadowDom';\nimport { inertProps } from '../helpers/inertProps';\n\n// The year is padded to four digits, as `datetime-local` requires. HTML has\n// no such shape for a year before 1, so a date then is empty, as that input\n// would make it.\nconst toIsoDateTime = (d: Date, withSeconds: boolean): string => {\n  if (d.getFullYear() < FIRST_YEAR) return '';\n  const yyyy = String(d.getFullYear()).padStart(4, '0');\n  const mo = String(d.getMonth() + 1).padStart(2, '0');\n  const dd = String(d.getDate()).padStart(2, '0');\n  const hh = String(d.getHours()).padStart(2, '0');\n  const mm = String(d.getMinutes()).padStart(2, '0');\n  const ss = String(d.getSeconds()).padStart(2, '0');\n  return withSeconds\n    ? `${yyyy}-${mo}-${dd}T${hh}:${mm}:${ss}`\n    : `${yyyy}-${mo}-${dd}T${hh}:${mm}`;\n};\n\nconst fromIsoDateTime = (s: string): Date | null => {\n  // The HTML datetime-local value may carry fractional seconds (the spec\n  // allows them and some engines normalize to `:ss.sss`); accept and drop.\n  // Its year is four or more digits, as `toIsoDateTime` writes one past 9999.\n  const m =\n    /^(\\d{4,})-(\\d{2})-(\\d{2})T(\\d{2}):(\\d{2})(?::(\\d{2})(?:\\.\\d{1,3})?)?$/.exec(\n      s\n    );\n  if (!m) return null;\n  const d = makeDate(Number(m[1]), Number(m[2]) - 1, Number(m[3]));\n  d.setHours(Number(m[4]), Number(m[5]), m[6] ? Number(m[6]) : 0, 0);\n  return d;\n};\n\n/**\n * Props for the raw DateTimeInput base. Use the higher-level `DateTimeInput`\n * for Field/Control composition. Combines the prop set of `DateInputBaseProps`\n * and `TimeInputBaseProps`.\n */\nexport interface DateTimeInputBaseProps\n  extends\n    Omit<\n      React.InputHTMLAttributes<HTMLInputElement>,\n      | 'value'\n      | 'defaultValue'\n      | 'onChange'\n      | 'size'\n      | 'color'\n      | 'min'\n      | 'max'\n      | 'type'\n      | 'popover'\n    >,\n    Omit<BulmaClassesProps, 'color'> {\n  /** Controlled selected date-time. */\n  value?: Date | null;\n  /** Initial value for uncontrolled usage. */\n  defaultValue?: Date | null;\n  /**\n   * Fired when either the date or time portion changes. Picking a day keeps\n   * the value's whole time of day, down to seconds and milliseconds the field\n   * doesn't show, and `min` and `max` judge the picked day at that time. An\n   * empty field's day is picked at midnight.\n   */\n  onChange?: (d: Date | null) => void;\n  /** Fired when the popover opens. */\n  onOpen?: () => void;\n  /** Fired when the popover closes. */\n  onClose?: () => void;\n  /**\n   * Lower bound for the combined date-time. A `min` before year 1 is raised\n   * to midnight on 1 January of year 1, where the range starts without one\n   * too: HTML's datetime-local input holds no earlier year, so the calendar,\n   * the time wheels and typing stop there.\n   */\n  min?: Date;\n  /** Upper bound for the combined date-time. */\n  max?: Date;\n  /** Disable the input. */\n  disabled?: boolean;\n  /** Read-only input. */\n  readOnly?: boolean;\n  /** Placeholder text. */\n  placeholder?: string;\n  /**\n   * Token format string or `Intl.DateTimeFormat` options. Default `'YYYY-MM-DD HH:mm'`.\n   * @defaultValue 'YYYY-MM-DD HH:mm'\n   */\n  format?: DateFormatOption;\n  /**\n   * Custom parser. Enter and leaving the field call it only if the user\n   * changed the text, so focus passing through commits nothing and the value\n   * keeps what the format leaves out, such as seconds.\n   */\n  parse?: (s: string) => Date | null;\n  /** BCP-47 locale tag. */\n  locale?: string;\n  /** Render the panel inline (no popover). */\n  inline?: boolean;\n  /** Use `<input type=\"datetime-local\">` on coarse-pointer devices. */\n  mobileNative?: boolean | 'auto';\n  /** Allow segmented keyboard typing (type the date-time directly across all segments). `false` makes the field picker-only. */\n  editable?: boolean;\n  /** Whether the calendar + time popover exists. `false` makes the field input-only (segmented typing with no popover). Default `true`. */\n  popover?: boolean;\n  /**\n   * Open the popover on focus. Default `true`. Focus that a closing popover\n   * hands back to the input leaves it closed. Dismissing it commits nothing:\n   * an empty field stays empty, and leaving afterwards commits only what was\n   * typed since. With it off, the launcher or Alt+ArrowDown opens it.\n   */\n  openOnFocus?: boolean;\n  /** Off by default — users typically tweak both halves before committing. */\n  closeOnSelect?: boolean;\n  /** Popover anchor position. */\n  position?: PickerPosition;\n  /** Render the popover into `document.body` via portal. */\n  appendToBody?: boolean;\n  /**\n   * Bulma color modifier for the input, also carried by the calendar and the\n   * time wheels, where it colors the selected date and the selection band.\n   * Today's date and the calendar's keyboard focus ring take the color's\n   * `-on-scheme` variant, which Bulma adjusts to contrast with the background,\n   * so pale colors stay readable. A focused wheel's ring is\n   * drawn inside the band in the color's `-invert`, like the selected value,\n   * so it shows on the fill. Unset, they use their\n   * `--bulma-dateinput-*` and `--bulma-timeinput-wheel-*` variables, which\n   * follow `primary` by default. The footer's time pill and Done button do not\n   * follow `color`.\n   */\n  color?: 'primary' | 'link' | 'info' | 'success' | 'warning' | 'danger';\n  /** Size variant. */\n  size?: 'small' | 'medium' | 'large';\n  /** Rounded input corners. */\n  isRounded?: boolean;\n  // date subset\n  /** Disable specific dates. Blocked dates are also rejected during manual typing (the predicate receives the full candidate date-time — prefer day-based checks). */\n  shouldDisableDate?: (d: Date) => boolean;\n  /** Convenience array of disabled dates, matched by calendar day; also rejected by manual typing. */\n  unselectableDates?: Date[];\n  /** Day the calendar week starts on. */\n  firstDayOfWeek?: DayOfWeek;\n  /** Override the 7 day-name labels. */\n  dayNames?: string[];\n  /** Override the 12 month-name labels. */\n  monthNames?: string[];\n  /** Show dimmed dates from adjacent months. */\n  nearbyMonthDays?: boolean;\n  // time subset\n  /** Time format. */\n  hourFormat?: HourFormat;\n  /** Show seconds column. Note: iOS Safari's native datetime-local picker UI does not include a seconds wheel; pass `mobileNative={false}` if you need one on iOS. */\n  enableSeconds?: boolean;\n  /** Hour step. */\n  incrementHours?: number;\n  /** Step between minute-wheel values (`1` = every minute, iOS-style). */\n  incrementMinutes?: number;\n  /** Step between second-wheel values (only with `enableSeconds`). */\n  incrementSeconds?: number;\n  /** Block specific times. Blocked times are also rejected during manual typing. */\n  unselectableTimes?: (d: Date) => boolean;\n  /** Decorative left icon glyph for the wrapping `Control` (shown by default). Set `''` to hide. */\n  iconLeftName?: string;\n  /**\n   * Show a clickable launcher button on the right that toggles the popover.\n   * Hidden by default while a `Control` it sits in shows its `isLoading`\n   * spinner, which shares that right edge.\n   * @defaultValue true\n   */\n  triggerIcon?: boolean;\n  /** Glyph for the right launcher button. */\n  triggerIconName?: string;\n  /** Play a short audible tick on each time-wheel crossing. Default `false`. */\n  audioTick?: boolean;\n  /** Auto-route tactile feedback per wheel tick (vibrate on Android, audio thunk on iOS). Default `false`. */\n  haptics?: boolean;\n  /** Optional translatable string overrides. */\n  labels?: PickerLabels;\n}\n\n/**\n * Raw DateTimeInput — combined input + calendar + time spinner without\n * Field/Control wrapping. Use `DateTimeInput` for the convenience wrapper.\n *\n * @function\n * @param {DateTimeInputBaseProps} props\n * @returns {JSX.Element}\n */\nexport const DateTimeInputBase = forwardRef<\n  HTMLInputElement,\n  DateTimeInputBaseProps\n>((props, ref) => {\n  const {\n    value: controlledValue,\n    defaultValue,\n    onChange,\n    onOpen,\n    onClose,\n    min,\n    max,\n    disabled,\n    readOnly,\n    placeholder,\n    format,\n    parse,\n    locale,\n    inline = false,\n    mobileNative = 'auto',\n    editable = true,\n    popover = true,\n    openOnFocus = true,\n    closeOnSelect = false,\n    position = 'bottom-left',\n    appendToBody = false,\n    color,\n    size,\n    isRounded,\n    shouldDisableDate,\n    unselectableDates,\n    firstDayOfWeek = 0,\n    dayNames,\n    monthNames,\n    nearbyMonthDays = true,\n    hourFormat = '24',\n    enableSeconds = false,\n    incrementHours = 1,\n    // Step between visible wheel values; 1 gives the iOS-style every-minute wheel.\n    incrementMinutes = 1,\n    incrementSeconds = 1,\n    unselectableTimes,\n    className,\n    name,\n    form,\n    required,\n    id,\n    onFocus,\n    onClick,\n    onKeyDown,\n    onBlur,\n    iconLeftName: _iconLeftName,\n    triggerIcon: triggerIconProp,\n    triggerIconName = 'chevron-down',\n    audioTick = false,\n    haptics = false,\n    labels,\n    ...rest\n  } = props;\n  // The launcher gives way to the loading spinner of a Control this sits in.\n  const controlLoading = useControlLoading();\n  const triggerIcon = triggerIconProp ?? !controlLoading;\n  const t = mergeLabels(labels);\n\n  // Platform-appropriate feedback routing for the time wheel: on iOS (no\n  // navigator.vibrate) the audio thunk fills in; on Android the real haptic\n  // fires and no audio is layered on. `audioTick` always wins.\n  const hasVibrate =\n    typeof navigator !== 'undefined' && typeof navigator.vibrate === 'function';\n  const effectiveAudioTick = audioTick || (haptics && !hasVibrate);\n\n  const isControlled = controlledValue !== undefined;\n  const [internalValue, setInternalValue] = useState<Date | null>(\n    defaultValue ?? null\n  );\n  const value = isControlled ? (controlledValue ?? null) : internalValue;\n\n  // Nothing before year 1 is in range, as in HTML's date inputs.\n  const lowerBound = useMemo(() => floorMin(min), [min]);\n\n  const initialFocused = useMemo(\n    () => clampDate(value ?? new Date(), lowerBound, max),\n    // eslint-disable-next-line react-hooks/exhaustive-deps\n    []\n  );\n  const [focusedDate, setFocusedDate] = useState<Date>(initialFocused);\n  // Re-clamp focusedDate when min/max change so the focused cell stays valid.\n  useEffect(() => {\n    setFocusedDate(prev => clampDate(prev, lowerBound, max));\n  }, [lowerBound, max]);\n\n  const defaultFormat: DateFormatOption =\n    format ??\n    (hourFormat === '12'\n      ? enableSeconds\n        ? 'YYYY-MM-DD hh:mm:ss A'\n        : 'YYYY-MM-DD hh:mm A'\n      : enableSeconds\n        ? 'YYYY-MM-DD HH:mm:ss'\n        : DEFAULT_DATETIME_FORMAT);\n\n  // The displayed format is the source of truth for the hour cycle: an explicit\n  // 12-hour `format` must drive a 12-hour wheel + pill even when `hourFormat`\n  // was left at its default. Fall back to the raw prop only when the cycle\n  // can't be read from the format (an Intl-options object, or no hour token).\n  const effectiveHourFormat = hourCycleFromFormat(defaultFormat) ?? hourFormat;\n\n  const [open, setOpenState] = useState(false);\n  // The time wheels are collapsed by default (iOS-style); the user reveals\n  // them by clicking the time value in the footer.\n  const [timeOpen, setTimeOpen] = useState(false);\n  const [text, setText] = useState<string>(\n    value ? formatDateTime(value, defaultFormat, locale) : ''\n  );\n\n  const inputRef = useRef<HTMLInputElement>(null);\n  const containerRef = useRef<HTMLDivElement>(null);\n  // Snapshot of the value when the popover opens, so Reset can revert the\n  // edits made in this session (reverting to empty if it opened empty).\n  const valueAtOpenRef = useRef<Date | null>(null);\n  const reactId = useId();\n  const popoverId = id ? `${id}-popover` : `picker-${reactId}`;\n  const timeWheelsId = `${popoverId}-time`;\n\n  const { bulmaHelperClasses, rest: cleanRest } = useBulmaClasses(rest);\n\n  const { shouldUseNative, isSmallViewport } = useNativeMobilePicker({\n    force: mobileNative === 'auto' ? undefined : mobileNative,\n  });\n  const useNative = !inline && shouldUseNative;\n  const wheelItemHeight = isSmallViewport ? 40 : 32;\n\n  // Time-only format for the footer's \"Time  5:07 PM\" display.\n  const timeDisplayFormat =\n    effectiveHourFormat === '12'\n      ? enableSeconds\n        ? 'h:mm:ss A'\n        : 'h:mm A'\n      : enableSeconds\n        ? 'HH:mm:ss'\n        : 'HH:mm';\n\n  const inputClass = usePrefixedClassNames('input', {\n    [`is-${color}`]: !!color,\n    [`is-${size}`]: !!size,\n    'is-rounded': isRounded,\n  });\n  const containerClass = usePrefixedClassNames('datetimeinput-container');\n  const triggerClass = usePrefixedClassNames('datetimeinput-trigger');\n  const panelClass = usePrefixedClassNames('datetimeinput');\n  const calendarWrapClass = usePrefixedClassNames(\n    'datetimeinput-calendar-wrap'\n  );\n  const timeOverlayClass = usePrefixedClassNames('datetimeinput-time-overlay');\n  const timeCardClass = usePrefixedClassNames('datetimeinput-time-card');\n  const footerClass = usePrefixedClassNames('datetimeinput-footer');\n  const footerTimeClass = usePrefixedClassNames('datetimeinput-footer-time');\n  const footerActionsClass = usePrefixedClassNames(\n    'datetimeinput-footer-actions'\n  );\n  const footerResetClass = usePrefixedClassNames('datetimeinput-footer-reset');\n  const footerDoneClass = usePrefixedClassNames('datetimeinput-footer-done');\n  const footerTimePillClass = usePrefixedClassNames(\n    'datetimeinput-footer-time-pill'\n  );\n\n  // What the latest request asked for, so a second request in the same event\n  // sees it before React renders. The callbacks fire here rather than in a\n  // state updater, which StrictMode calls twice, and after the state is set,\n  // so a request a callback makes is the one that lands last.\n  const requestedOpenRef = useRef(false);\n  const setOpen = useCallback(\n    (next: boolean) => {\n      if (requestedOpenRef.current === next) return;\n      requestedOpenRef.current = next;\n      setOpenState(next);\n      if (next) {\n        valueAtOpenRef.current = value;\n        onOpen?.();\n      } else {\n        onClose?.();\n      }\n    },\n    [onOpen, onClose, value]\n  );\n\n  useEffect(() => {\n    setText(value ? formatDateTime(value, defaultFormat, locale) : '');\n  }, [value, defaultFormat, locale]);\n\n  // Collapse the time wheels whenever the popover closes.\n  useEffect(() => {\n    if (!open) setTimeOpen(false);\n  }, [open]);\n\n  // The footer's Time button opens the wheels, and the hours wheel takes\n  // focus so the keys turn it straight away. The calendar they cover is\n  // inert meanwhile, so no tab stop, pointer or screen reader reaches a day\n  // behind them. Closing the wheels hands focus back to the button: focus\n  // in them would fall to the page as they unmount, and a pointer press\n  // outside them has already dropped it on the panel or the page. Focus the\n  // keys moved on to the footer, such as Reset, stays there.\n  const panelRef = useRef<HTMLDivElement>(null);\n  const timeButtonRef = useRef<HTMLButtonElement>(null);\n  const timeOverlayRef = useRef<HTMLDivElement>(null);\n  useEffect(() => {\n    if (!timeOpen) return;\n    timeOverlayRef.current\n      ?.querySelector<HTMLElement>('[role=\"spinbutton\"]')\n      ?.focus();\n  }, [timeOpen]);\n  const closeTime = useCallback(() => {\n    const panel = panelRef.current;\n    const active = getActiveElementInTree(panel);\n    const movedOn =\n      !!panel?.contains(active) && !timeOverlayRef.current?.contains(active);\n    if (!movedOn) timeButtonRef.current?.focus();\n    setTimeOpen(false);\n  }, []);\n\n  const commitValue = useCallback(\n    (next: Date | null) => {\n      if (!isControlled) setInternalValue(next);\n      // Keep the calendar's focused cell tracking typed / parsed values.\n      if (next) setFocusedDate(next);\n      onChange?.(next);\n    },\n    [isControlled, onChange]\n  );\n\n  // A picked day takes the value's whole time of day, seconds and all, or\n  // midnight in an empty field. The day handed over by the keyboard is the\n  // calendar's focused date, which can carry the time of the clock it\n  // started from, so none of its time is kept.\n  const handleDateSelect = useCallback(\n    (d: Date) => {\n      const merged = setTimeOfDay(d, {\n        hours: value?.getHours() ?? 0,\n        minutes: value?.getMinutes() ?? 0,\n        seconds: value?.getSeconds() ?? 0,\n        milliseconds: value?.getMilliseconds() ?? 0,\n      });\n      if (!isWithin(merged, lowerBound, max)) return;\n      commitValue(merged);\n      setFocusedDate(d);\n    },\n    [value, lowerBound, max, commitValue]\n  );\n\n  // The wheels set the value's time. An empty field starts from the focused\n  // day, at the whole minute or second the wheels show.\n  const handleTimeChange = useCallback(\n    (parts: { hours: number; minutes: number; seconds?: number }) => {\n      const next = value\n        ? setTimeOfDay(value, parts)\n        : setTimeOfDay(focusedDate, {\n            ...parts,\n            seconds: parts.seconds ?? 0,\n            milliseconds: 0,\n          });\n      if (!isWithin(next, lowerBound, max)) return;\n      commitValue(next);\n    },\n    [value, focusedDate, lowerBound, max, commitValue]\n  );\n\n  const tryParse = useCallback(\n    (s: string): Date | null => {\n      const trimmed = s.trim();\n      if (!trimmed) return null;\n      if (parse) return parse(trimmed);\n      const fmt = typeof defaultFormat === 'string' ? defaultFormat : undefined;\n      return parseDate(trimmed, fmt ?? DEFAULT_DATETIME_FORMAT, locale);\n    },\n    [parse, defaultFormat, locale]\n  );\n\n  // The Date the user edits when starting without a current value: now, at\n  // the whole minute, or the whole second with `enableSeconds`.\n  const makeBaseDate = useCallback(\n    (): Date =>\n      setTimeOfDay(new Date(), {\n        seconds: enableSeconds ? undefined : 0,\n        milliseconds: 0,\n      }),\n    [enableSeconds]\n  );\n\n  const inputReadOnlyAttr = !!readOnly || !editable;\n  const canOpen = !!popover && !disabled && !readOnly;\n\n  // Blocking predicate for manual entry, combining the calendar's\n  // disabled-day logic with the wheels' unselectable-times predicate. The\n  // candidate passed in carries the full date-time, so date predicates\n  // should use day-based checks.\n  const isBlocked = useMemo(() => {\n    if (!shouldDisableDate && !unselectableDates?.length && !unselectableTimes)\n      return undefined;\n    return (d: Date) =>\n      !!shouldDisableDate?.(d) ||\n      !!unselectableDates?.some(u => isSameDay(u, d)) ||\n      !!unselectableTimes?.(d);\n  }, [shouldDisableDate, unselectableDates, unselectableTimes]);\n\n  const { inputHandlers } = useSegmentedEntry({\n    format: defaultFormat,\n    value,\n    commitValue,\n    formatFn: formatDateTime,\n    tryParse,\n    text,\n    setText,\n    makeBaseDate,\n    locale,\n    min: lowerBound,\n    max,\n    isBlocked,\n    disabled,\n    readOnly,\n    editable,\n    popover,\n    openOnFocus,\n    closeOnSelect,\n    isOpen: open,\n    setOpen,\n    inputRef,\n    containerRef,\n    onFocus,\n    onClick,\n    onKeyDown,\n    onBlur,\n  });\n\n  const combinedRef = useCallback(\n    (node: HTMLInputElement | null) => {\n      (inputRef as React.MutableRefObject<HTMLInputElement | null>).current =\n        node;\n      if (typeof ref === 'function') ref(node);\n      else if (ref)\n        (ref as React.MutableRefObject<HTMLInputElement | null>).current = node;\n    },\n    [ref]\n  );\n\n  if (useNative) {\n    const nativeStep = enableSeconds ? incrementSeconds : incrementMinutes * 60;\n    return (\n      <input\n        {...cleanRest}\n        ref={combinedRef}\n        type=\"datetime-local\"\n        step={nativeStep}\n        className={classNames(inputClass, bulmaHelperClasses, className)}\n        value={value ? toIsoDateTime(value, enableSeconds) : ''}\n        onChange={e => {\n          const parsed = e.target.value\n            ? fromIsoDateTime(e.target.value)\n            : null;\n          commitValue(parsed);\n        }}\n        min={min ? toIsoDateTime(lowerBound, enableSeconds) : undefined}\n        max={max ? toIsoDateTime(max, enableSeconds) : undefined}\n        disabled={disabled}\n        readOnly={readOnly}\n        placeholder={placeholder}\n        name={name}\n        form={form}\n        required={required}\n        id={id}\n      />\n    );\n  }\n\n  const spinnerValue = {\n    hours: value?.getHours() ?? 0,\n    minutes: value?.getMinutes() ?? 0,\n    seconds: enableSeconds ? (value?.getSeconds() ?? 0) : undefined,\n  };\n\n  const panel = (\n    <div\n      ref={panelRef}\n      className={panelClass}\n      onKeyDown={e => {\n        // First Escape collapses the floating time wheels; the popover's own\n        // Escape handler (which closes the whole panel) only sees the second.\n        if (timeOpen && e.key === 'Escape') {\n          e.stopPropagation();\n          closeTime();\n        }\n      }}\n    >\n      <div className={calendarWrapClass}>\n        <div {...inertProps(timeOpen)}>\n          <Calendar\n            value={value}\n            focusedDate={focusedDate}\n            onSelect={handleDateSelect}\n            onFocusedDateChange={setFocusedDate}\n            min={min}\n            max={max}\n            shouldDisableDate={shouldDisableDate}\n            unselectableDates={unselectableDates}\n            firstDayOfWeek={firstDayOfWeek}\n            locale={locale}\n            dayNames={dayNames}\n            monthNames={monthNames}\n            nearbyMonthDays={nearbyMonthDays}\n            color={color}\n            size={size}\n            id={`${popoverId}-cal`}\n            autoFocusCell={open}\n            labels={labels}\n          />\n        </div>\n        {timeOpen && (\n          <div\n            ref={timeOverlayRef}\n            className={timeOverlayClass}\n            onClick={e => {\n              // Tap outside the wheel card (on the covered calendar area)\n              // collapses the wheels without selecting a date, matching the\n              // native behavior.\n              if (e.target === e.currentTarget) closeTime();\n            }}\n          >\n            <div className={timeCardClass}>\n              <TimeWheels\n                value={spinnerValue}\n                onChange={handleTimeChange}\n                hourFormat={effectiveHourFormat}\n                enableSeconds={enableSeconds}\n                incrementHours={incrementHours}\n                incrementMinutes={incrementMinutes}\n                incrementSeconds={incrementSeconds}\n                unselectableTimes={unselectableTimes}\n                color={color}\n                size={size}\n                disabled={disabled}\n                id={timeWheelsId}\n                labels={labels}\n                itemHeight={wheelItemHeight}\n                audioTick={effectiveAudioTick}\n                // Enter on a wheel commits the time, which the wheels already\n                // did live, and closes: the popover, or inline, where there\n                // is no popover, the wheels, as Escape does.\n                onCommit={() => (inline ? closeTime() : setOpen(false))}\n              />\n            </div>\n          </div>\n        )}\n      </div>\n      <div className={footerClass}>\n        <button\n          ref={timeButtonRef}\n          type=\"button\"\n          className={footerTimeClass}\n          onClick={() => (timeOpen ? closeTime() : setTimeOpen(true))}\n          aria-expanded={timeOpen}\n          // The wheels exist only while open, so only then is there an\n          // element for the button to name.\n          aria-controls={timeOpen ? timeWheelsId : undefined}\n          disabled={disabled}\n        >\n          <span>{t.time}</span>\n          <span className={footerTimePillClass}>\n            {value ? formatTime(value, timeDisplayFormat, locale) : '—'}\n          </span>\n        </button>\n        <div className={footerActionsClass}>\n          <button\n            type=\"button\"\n            className={footerResetClass}\n            onClick={() => commitValue(valueAtOpenRef.current)}\n          >\n            {t.reset}\n          </button>\n          <button\n            type=\"button\"\n            className={footerDoneClass}\n            aria-label={t.done}\n            onClick={() => setOpen(false)}\n          >\n            <svg width=\"22\" height=\"22\" viewBox=\"0 0 22 22\" aria-hidden=\"true\">\n              <path\n                d=\"M5 11l4 4 8-8\"\n                fill=\"none\"\n                stroke=\"currentColor\"\n                strokeWidth=\"2.5\"\n                strokeLinecap=\"round\"\n                strokeLinejoin=\"round\"\n              />\n            </svg>\n          </button>\n        </div>\n      </div>\n    </div>\n  );\n\n  if (inline) {\n    return (\n      <div\n        {...cleanRest}\n        ref={containerRef}\n        className={classNames(containerClass, bulmaHelperClasses, className)}\n      >\n        {panel}\n        {name && (\n          <input\n            type=\"hidden\"\n            name={name}\n            form={form}\n            value={value ? toIsoDateTime(value, enableSeconds) : ''}\n            required={required}\n          />\n        )}\n      </div>\n    );\n  }\n\n  return (\n    <div\n      ref={containerRef}\n      className={classNames(containerClass, bulmaHelperClasses, className)}\n      {...cleanRest}\n    >\n      <input\n        ref={combinedRef}\n        type=\"text\"\n        role=\"combobox\"\n        aria-haspopup=\"dialog\"\n        aria-expanded={open}\n        aria-controls={popoverId}\n        autoComplete=\"off\"\n        className={inputClass}\n        value={text}\n        placeholder={placeholder}\n        disabled={disabled}\n        readOnly={inputReadOnlyAttr}\n        name={name}\n        form={form}\n        required={required}\n        id={id}\n        {...inputHandlers}\n      />\n      {popover && triggerIcon && (\n        <button\n          type=\"button\"\n          className={triggerClass}\n          onClick={() => {\n            if (canOpen) setOpen(!open);\n          }}\n          disabled={!canOpen}\n          aria-label={t.chooseDateTime}\n          aria-haspopup=\"dialog\"\n          aria-controls={popoverId}\n          aria-expanded={open}\n          tabIndex={canOpen ? 0 : -1}\n        >\n          <Icon name={triggerIconName} size={size} />\n        </button>\n      )}\n      {popover && (\n        <PickerPopover\n          isOpen={open}\n          onClose={() => setOpen(false)}\n          anchorRef={containerRef}\n          position={position}\n          appendToBody={appendToBody}\n          ariaLabel={t.chooseDateTime}\n          id={popoverId}\n          restoreFocusRef={inputRef}\n          initialFocusSelector={CALENDAR_FOCUSED_CELL}\n        >\n          {panel}\n        </PickerPopover>\n      )}\n    </div>\n  );\n});\n\nDateTimeInputBase.displayName = 'DateTimeInputBase';\n\nexport default DateTimeInputBase;\n"],"names":["_jsx","_jsxs"],"mappings":"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"}

package/dist/esm/form/Field.js

@@ -0,0 +1,167 @@
+/* @allxsmith/bestax-bulma — AI agents: see AGENTS.md in the package root, or https://bestax.io/llms.txt */
+import { jsx, jsxs } from 'react/jsx-runtime';
+import React, { useId } from 'react';
+import { usePrefixedClassNames, classNames } from '../helpers/classNames.js';
+import { withSubComponents } from '../helpers/withSubComponents.js';
+import { useBulmaClasses } from '../helpers/useBulmaClasses.js';
+import { useFieldLabelFor, FieldProvider, FieldLabelIdProvider, FieldLabelElementIdProvider, FieldLabelForProvider } from './FormContext.js';
+import { Control } from './Control.js';
+
+/**
+ * FieldLabel component for rendering a Bulma field label.
+ *
+ * @function
+ * @param {FieldLabelProps} props - Props for the FieldLabel component.
+ * @returns {JSX.Element} The rendered field label.
+ *
+ * @example
+ * <FieldLabel size="normal">Name</FieldLabel>
+ */
+const FieldLabel = ({ size, textColor, bgColor, className, children, ...props }) => {
+    const { bulmaHelperClasses, rest } = useBulmaClasses({
+        color: textColor,
+        backgroundColor: bgColor,
+        ...props,
+    });
+    const mainClass = usePrefixedClassNames('field-label', {
+        [`is-${size}`]: !!size,
+    });
+    const fieldLabelClass = classNames(mainClass, bulmaHelperClasses, className);
+    // Spread ...props and ...rest so custom props like data-testid are included
+    return (jsx("div", { className: fieldLabelClass, ...props, ...rest, children: children }));
+};
+/**
+ * FieldBody component for rendering Bulma field body.
+ *
+ * @function
+ * @param {FieldBodyProps} props - Props for the FieldBody component.
+ * @returns {JSX.Element} The rendered field body.
+ *
+ * @example
+ * <FieldBody><input className="input" /></FieldBody>
+ */
+const FieldBody = ({ textColor, bgColor, className, children, ...props }) => {
+    const { bulmaHelperClasses, rest } = useBulmaClasses({
+        color: textColor,
+        backgroundColor: bgColor,
+        ...props,
+    });
+    const mainClass = usePrefixedClassNames('field-body');
+    const fieldBodyClass = classNames(mainClass, bulmaHelperClasses, className);
+    // Spread ...props and ...rest so custom props like data-testid are included
+    return (jsx("div", { className: fieldBodyClass, ...props, ...rest, children: children }));
+};
+/**
+ * The `Field` component is a Bulma-styled form field container.
+ *
+ * @function
+ * @param {FieldProps} props - Props for the Field component.
+ * @returns {JSX.Element} The rendered field container.
+ * @see {@link https://bulma.io/documentation/form/general/#field | Bulma Field documentation}
+ *
+ * @example
+ * // Labelled field — the label auto-associates with the composed base
+ * <Field label="Email">
+ *   <Control>
+ *     <InputBase type="email" />
+ *   </Control>
+ * </Field>
+ *
+ * @example
+ * // Horizontal field
+ * <Field horizontal label="Name">
+ *   <Control>
+ *     <InputBase />
+ *   </Control>
+ * </Field>
+ */
+const FieldComponent = ({ horizontal, grouped, hasAddons, narrow, label, labelSize, labelProps, textColor, color: _fieldColor, bgColor, className, children, ...props }) => {
+    const { bulmaHelperClasses, rest } = useBulmaClasses({
+        color: textColor,
+        backgroundColor: bgColor,
+        ...props,
+    });
+    const mainClass = usePrefixedClassNames('field', {
+        'is-horizontal': horizontal,
+        'has-addons': !!hasAddons,
+        'has-addons-centered': hasAddons === 'centered',
+        'has-addons-right': hasAddons === 'right',
+        'is-narrow': narrow,
+        'is-grouped': grouped === true ||
+            grouped === 'centered' ||
+            grouped === 'right' ||
+            grouped === 'multiline',
+        'is-grouped-centered': grouped === 'centered',
+        'is-grouped-right': grouped === 'right',
+        'is-grouped-multiline': grouped === 'multiline',
+    });
+    const fieldClass = classNames(mainClass, bulmaHelperClasses, className);
+    // Default labelSize to 'normal' when horizontal for proper baseline alignment
+    const effectiveLabelSize = labelSize ?? (horizontal ? 'normal' : undefined);
+    const labelClass = usePrefixedClassNames('label');
+    // Auto-associate the label with a single composed base control (#495): the
+    // label points at a generated id shared via context, which InputBase/
+    // SelectBase/TextAreaBase adopt when the user supplied no id of their own.
+    // Presence semantics on htmlFor — even an explicit `htmlFor: undefined`
+    // means the caller owns the association. Grouped/addons fields hold several
+    // controls, so no single association is generated for them.
+    const generatedId = useId();
+    const userWiredLabel = !!labelProps && 'htmlFor' in labelProps;
+    const targetId = label && !userWiredLabel && !grouped && !hasAddons
+        ? generatedId
+        : undefined;
+    // A group control (Radios, Checkboxes, Rate, DateRangeInput) cannot take
+    // that `for`, so it points `aria-labelledby` at the label itself (#939).
+    // The label gets an id whenever the association is on, unless the caller
+    // gave it one.
+    const labelId = labelProps?.id ?? (targetId ? `${targetId}-label` : undefined);
+    // What the rendered label's `for` points at, generated or the caller's, so
+    // a control can tell when a label wired by hand names it. An unlabeled
+    // Field passes on its parent's.
+    const inheritedLabelFor = useFieldLabelFor();
+    const labelFor = label
+        ? userWiredLabel
+            ? labelProps.htmlFor
+            : targetId
+        : inheritedLabelFor;
+    let renderedLabel = null;
+    if (label) {
+        if (horizontal) {
+            renderedLabel = (jsx(FieldLabel, { size: effectiveLabelSize, children: jsx("label", { htmlFor: targetId, ...labelProps, id: labelId, className: classNames(labelClass, labelProps?.className), style: labelProps?.style, children: label }) }));
+        }
+        else {
+            renderedLabel = (jsx("label", { htmlFor: targetId, ...labelProps, id: labelId, className: classNames(labelClass, labelProps?.className), style: { display: 'block', ...(labelProps?.style || {}) }, children: label }));
+        }
+    }
+    // If horizontal, wrap children in FieldBody (unless the user already provided
+    // a FieldBody — either as the single child, or as one element among siblings
+    // like <Field.Label/> + <Field.Body/>).
+    let content = children;
+    if (horizontal) {
+        const isFieldBody = (c) => React.isValidElement(c) &&
+            // @ts-expect-error displayName isn't on the public type
+            (c.type === FieldBody || c.type?.displayName === 'FieldBody');
+        const isFieldLabel = (c) => React.isValidElement(c) &&
+            // @ts-expect-error displayName isn't on the public type
+            (c.type === FieldLabel || c.type?.displayName === 'FieldLabel');
+        const childArray = React.Children.toArray(children);
+        const userProvidedStructure = childArray.some(c => isFieldBody(c) || isFieldLabel(c));
+        if (userProvidedStructure) {
+            content = children;
+        }
+        else {
+            content = jsx(FieldBody, { children: children });
+        }
+    }
+    return (jsx(FieldProvider, { value: true, children: jsx(FieldLabelIdProvider, { value: targetId, children: jsx(FieldLabelElementIdProvider, { value: targetId ? labelId : undefined, children: jsx(FieldLabelForProvider, { value: labelFor, children: jsxs("div", { className: fieldClass, ...rest, children: [renderedLabel, content] }) }) }) }) }));
+};
+FieldLabel.displayName = 'FieldLabel';
+FieldBody.displayName = 'FieldBody';
+const Field = withSubComponents(FieldComponent, {
+    Label: FieldLabel,
+    Body: FieldBody,
+    Control,
+}, 'Field');
+
+export { Field, FieldBody, FieldLabel };
+//# sourceMappingURL=Field.js.map