@vuu-ui/vuu-ui-controls 4.0.0-alpha.2 → 4.0.0-alpha.20

package/src/time-input/useTimeInput.js

@@ -1,75 +1,85 @@
-import { isValidTimeString } from "@vuu-ui/vuu-utils";
-import { useCallback, useMemo, useRef } from "react";
+import { isValidTimeString, isValidTimeStringMillis } from "@vuu-ui/vuu-utils";
+import { useCallback, useRef } from "react";
 import { MaskedInput } from "./MaskedInput.js";
 const isDigit = (char)=>1 === char.length && /[0-9]/.test(char);
-const useTimeInput = ({ defaultValue, onChange, onCommit, value })=>{
+const useTimeInput = ({ defaultValue, milliseconds = false, onChange, onCommit: onCommitProp, value })=>{
+    const onCommit = onCommitProp;
     const mousedDownRef = useRef(false);
+    const onChangeRef = useRef(onChange);
+    onChangeRef.current = onChange;
     const maskedInputRef = useRef(void 0);
-    useMemo(()=>{
-        if (void 0 === maskedInputRef.current) {
-            maskedInputRef.current = new MaskedInput(defaultValue, null);
-            maskedInputRef.current.on("change", (e)=>{
-                onChange?.(e);
-            });
-        }
-        if (value && value !== maskedInputRef.current.value) maskedInputRef.current.value = value;
+    if (void 0 === maskedInputRef.current || maskedInputRef.current.milliseconds !== milliseconds) {
+        maskedInputRef.current = new MaskedInput(value ?? maskedInputRef.current?.value ?? defaultValue, null, {
+            milliseconds
+        });
+        maskedInputRef.current.on("change", (e)=>{
+            onChangeRef.current?.(e);
+        });
+    }
+    const maskedInput = maskedInputRef.current;
+    if (void 0 !== value) maskedInput.value = value;
+    const setInputEl = useCallback((el)=>{
+        maskedInput.input = el;
     }, [
-        defaultValue,
-        onChange,
-        value
+        maskedInput
     ]);
-    const setInputEl = useCallback((el)=>{
-        if (el && maskedInputRef.current) maskedInputRef.current.input = el;
-    }, []);
-    const back = useRef(false);
-    const commitValue = useCallback((evt, value)=>{
-        if (isValidTimeString(value)) onCommit(evt, value, "text-input");
-        else if ("hh:mm:ss" === value) console.log("no value set");
-        else console.log("value is not valid");
+    const commitValue = useCallback((evt)=>{
+        if ("" !== evt.currentTarget.value) {
+            const { value } = maskedInput;
+            if (milliseconds ? isValidTimeStringMillis(value) : isValidTimeString(value)) onCommit(evt, value, "text-input");
+        }
     }, [
+        maskedInput,
+        milliseconds,
         onCommit
     ]);
     const handleKeyDown = useCallback((e)=>{
-        const { current: maskedInput } = maskedInputRef;
-        if (maskedInput) {
-            if ("Backspace" === e.key) {
-                maskedInput.backspace();
-                back.current = true;
-            } else if (isDigit(e.key)) maskedInput.update(e.key);
-            else if ("ArrowLeft" === e.key) maskedInput.moveFocus("left");
-            else if ("ArrowRight" === e.key) maskedInput.moveFocus("right");
-            else if ("ArrowUp" === e.key) maskedInput.incrementValue();
-            else if ("ArrowDown" === e.key) maskedInput.decrementValue();
-            else if ("v" === e.key && e.metaKey) return;
-            else if ("Tab" === e.key) return;
-            else if ("Enter" === e.key) commitValue(e, maskedInput.value);
-        }
+        if (e.ctrlKey || e.metaKey || e.altKey || "Tab" === e.key) return;
+        if ("Backspace" === e.key) maskedInput.backspace();
+        else if (isDigit(e.key)) maskedInput.update(e.key);
+        else if ("ArrowLeft" === e.key) maskedInput.moveFocus("left");
+        else if ("ArrowRight" === e.key) maskedInput.moveFocus("right");
+        else if ("ArrowUp" === e.key) maskedInput.incrementValue();
+        else if ("ArrowDown" === e.key) maskedInput.decrementValue();
+        else if ("Home" === e.key) maskedInput.selectFirst();
+        else if ("End" === e.key) maskedInput.selectLast();
+        else if ("Enter" === e.key) commitValue(e);
+        else if ("Escape" === e.key) return;
         e.preventDefault();
     }, [
-        commitValue
+        commitValue,
+        maskedInput
     ]);
     const handleDoubleClick = useCallback(()=>{
-        maskedInputRef.current?.doubleClick();
-    }, []);
+        maskedInput.doubleClick();
+    }, [
+        maskedInput
+    ]);
     const handlePaste = useCallback((e)=>{
-        const value = e.clipboardData.getData("text");
-        if (isValidTimeString(value)) maskedInputRef.current?.pasteValue(value);
-    }, []);
+        e.preventDefault();
+        maskedInput.pasteValue(e.clipboardData.getData("text"));
+    }, [
+        maskedInput
+    ]);
     const handleFocus = useCallback(()=>{
         if (mousedDownRef.current) mousedDownRef.current = false;
-        else maskedInputRef.current?.focus();
-    }, []);
+        else maskedInput.focus();
+    }, [
+        maskedInput
+    ]);
     const handleMouseDown = useCallback(()=>{
         mousedDownRef.current = true;
     }, []);
     const handleMouseUp = useCallback((e)=>{
         e.preventDefault();
-        maskedInputRef.current?.click();
-    }, []);
+        maskedInput.click();
+    }, [
+        maskedInput
+    ]);
     return {
         inputRef: setInputEl,
         eventHandlers: {
-            onBlur: maskedInputRef.current?.blur,
+            onBlur: maskedInput.blur,
             onDoubleClick: handleDoubleClick,
             onFocus: handleFocus,
             onKeyDown: handleKeyDown,

package/src/vuu-date-picker/VuuDatePicker.js

@@ -1,84 +1,78 @@
-import { createElement, useCallback, useRef, useState } from "react";
-import { getLocalTimeZone, isSameDay, isSameMonth, isSameYear } from "@internationalized/date";
+import { createElement, useCallback, useMemo, useRef, useState } from "react";
+import { EpochTimestamp, fromDateTimeFields } from "@vuu-ui/vuu-utils";
+import { CalendarDate } from "@internationalized/date";
 import clsx from "clsx";
 import { DatePicker } from "../date-picker/index.js";
 const classBase = "VuuDatePicker";
-const isSameDate = (d1, d2)=>void 0 !== d2 && isSameDay(d1, d2) && isSameMonth(d1, d2) && isSameYear(d1, d2);
 const datePattern = /^\d{1,2} [a-z]{3} \d{4}$/i;
-const isValidDate = (value)=>void 0 !== value && value?.match(datePattern) !== null && !Number.isNaN(new Date(value).getDay());
-const localTimeZone = getLocalTimeZone();
-const toEpochMillis = (date, timezone = getLocalTimeZone())=>date.toDate(timezone).getTime();
-const getDates = (selectedDate)=>{
-    if (selectedDate) return {
-        datePickerKey: "controlled",
-        defaultDate: void 0,
-        selectedDate
-    };
-    return {
-        datePickerKey: "uncontrolled",
-        defaultDate: void 0,
-        selectedDate
-    };
+const isValidDate = (value)=>void 0 !== value && null !== value.match(datePattern) && !Number.isNaN(new Date(value).getDay());
+const isSameDate = (d1, d2)=>void 0 !== d2 && 0 === d1.compare(d2);
+const toCalendarDateInTimeZone = (value, timeZone)=>{
+    const timestamp = value instanceof EpochTimestamp ? value : EpochTimestamp.fromWire(value, "epochMillis");
+    if (timestamp) {
+        const { year, month, day } = timestamp.getFields(timeZone);
+        return new CalendarDate(year, month, day);
+    }
 };
-const VuuDatePicker = ({ className, onSelectionChange, selectedDate: selectedDateProp, onCommit, preserveFocusOnSelect, ...props })=>{
-    const [open, _setOpen] = useState(false);
-    const valueRef = useRef("");
+const startOfDateInTimeZone = (date, timeZone)=>fromDateTimeFields({
+        year: date.year,
+        month: date.month,
+        day: date.day,
+        hour: 0,
+        minute: 0,
+        second: 0,
+        millisecond: 0
+    }, timeZone);
+const VuuDatePicker = ({ className, onSelectionChange, onCommit, preserveFocusOnSelect, selectedDate: selectedDateProp, timeZone, value, ...props })=>{
+    const [open, setOpen] = useState(false);
+    const inputValueRef = useRef("");
     const datePickerRef = useRef(null);
-    const dateState = useRef(getDates(selectedDateProp));
-    const setOpen = (o)=>{
-        console.log(`setOpen ${o}`);
-        _setOpen(o);
-    };
+    const controlledDate = useMemo(()=>selectedDateProp ?? toCalendarDateInTimeZone(value, timeZone), [
+        selectedDateProp,
+        timeZone,
+        value
+    ]);
+    const [selectedDate, setSelectedDate] = useState(controlledDate);
+    const controlledDateRef = useRef(controlledDate);
+    if (void 0 !== controlledDate && (void 0 === controlledDateRef.current || 0 !== controlledDate.compare(controlledDateRef.current))) {
+        controlledDateRef.current = controlledDate;
+        if (!isSameDate(controlledDate, selectedDate)) setSelectedDate(controlledDate);
+    }
     const commitDateChange = useCallback((e, date)=>{
         onSelectionChange?.(e, date);
         setOpen(false);
-        onCommit?.(e, toEpochMillis(date, localTimeZone));
+        onCommit?.(e, startOfDateInTimeZone(date, timeZone));
         if (preserveFocusOnSelect) requestAnimationFrame(()=>{
             datePickerRef.current?.querySelector("input")?.focus();
         });
     }, [
         onCommit,
         onSelectionChange,
-        preserveFocusOnSelect
+        preserveFocusOnSelect,
+        timeZone
     ]);
     const handleSelectionChange = useCallback((e, date)=>{
-        const { selectedDate } = dateState.current;
-        if (date) {
-            if (void 0 === selectedDate) {
-                dateState.current = getDates(date);
-                commitDateChange(e, date);
-            } else if (!isSameDate(date, selectedDate)) {
-                dateState.current.selectedDate = date;
-                commitDateChange(e, date);
-            }
+        if (date && !isSameDate(date, selectedDate)) {
+            setSelectedDate(date);
+            commitDateChange(e, date);
         }
     }, [
-        commitDateChange
+        commitDateChange,
+        selectedDate
     ]);
-    const handleChange = (evt, value = "")=>{
-        console.log("handleChange", {
-            evt,
-            value
-        });
-        valueRef.current = value;
-        console.log(`is '${value}' a valid date ? ${isValidDate(value)}`);
+    const handleChange = (_evt, value = "")=>{
+        inputValueRef.current = value;
     };
     const handleKeyDown = (e)=>{
         if ("ArrowDown" === e.key) setOpen(true);
     };
     const handleKeyDownCapture = (e)=>{
-        if ("Enter" === e.key) if (isValidDate(valueRef.current)) console.log(`committayaface (${valueRef.current})`);
-        else {
-            console.log(`nice try cowboy, but '${valueRef.current}' is nota valid date`);
-            e.stopPropagation();
-        }
+        if ("Enter" === e.key && "" !== inputValueRef.current && !isValidDate(inputValueRef.current)) e.stopPropagation();
     };
-    const { datePickerKey, defaultDate, selectedDate } = dateState.current;
     return /*#__PURE__*/ createElement(DatePicker, {
         ...props,
         className: clsx(classBase, className),
-        defaultSelectedDate: defaultDate,
-        key: datePickerKey,
+        key: selectedDate ? "controlled" : "uncontrolled",
         open: open,
         onChange: handleChange,
         onKeyDown: handleKeyDown,

package/src/vuu-time-picker/VuuTimePicker.js

@@ -5,7 +5,7 @@ import clsx from "clsx";
 import { TimeInput } from "../time-input/TimeInput.js";
 import VuuTimePicker from "./VuuTimePicker.css";
 const classBase = "vuuTimePicker";
-const VuuTimePicker_VuuTimePicker = ({ className, defaultValue, onChange, onCommit, value, ...htmlAttributes })=>{
+const VuuTimePicker_VuuTimePicker = ({ className, defaultValue, milliseconds, onChange, onCommit, value, ...htmlAttributes })=>{
     const targetWindow = useWindow();
     useComponentCssInjection({
         testId: "vuu-time-picker",
@@ -16,10 +16,11 @@ const VuuTimePicker_VuuTimePicker = ({ className, defaultValue, onChange, onComm
         ...htmlAttributes,
         className: clsx(classBase, className),
         children: /*#__PURE__*/ jsx(TimeInput, {
-            defaultValue: defaultValue,
-            onChange: onChange,
-            onCommit: onCommit,
-            value: value
+            defaultValue,
+            milliseconds,
+            onChange,
+            onCommit,
+            value
         })
     });
 };

package/types/index.d.ts

@@ -13,9 +13,8 @@ export { HoverOverlay } from "./hover-overlay/HoverOverlay";
 export * from "./icon-button";
 export * from "./instrument-picker";
 export { ItemPicker, type ItemPickerProps } from "./item-picker/ItemPicker";
-export { type ItemDescriptor, type CreateCustomItemProps, } from "./item-picker/useItemPicker";
+export type { ItemDescriptor, SelectedItemsChangeHandler as SelectedItemChangeHandler } from "./item-picker/useItemPicker";
 export * from "./measured-container";
-export { ModalProvider, useModal } from "./modal-provider/ModalProvider";
 export * from "./overflow-container";
 export * from "./price-ticker";
 export { Prompt, type PromptProps } from "./prompt/Prompt";
@@ -24,10 +23,10 @@ export * from "./split-button";
 export * from "./table-search";
 export * from "./tabs-next";
 export * from "./tabstrip";
-export { TimeInput, type TimeInputProps } from "./time-input/TimeInput";
+export { TimeInput, type TimeInputMillisecondsProps, type TimeInputProps, type TimeInputSecondsProps, } from "./time-input/TimeInput";
 export * from "./toolbar";
 export * from "./utils";
 export * from "./vuu-date-picker";
 export * from "./vuu-input";
-export { VuuTimePicker, type VuuTimePickerProps, } from "./vuu-time-picker/VuuTimePicker";
+export { VuuTimePicker, type VuuTimePickerMillisecondsProps, type VuuTimePickerProps, type VuuTimePickerSecondsProps, } from "./vuu-time-picker/VuuTimePicker";
 export * from "./vuu-typeahead-input";

package/types/item-picker/ItemPicker.d.ts

@@ -1,16 +1,34 @@
-import { ListBoxProps } from "@salt-ds/core";
-import { ItemTypeName } from "@vuu-ui/vuu-utils";
-import { HTMLAttributes } from "react";
-import { CreateCustomItemProps, ItemDescriptor, ItemPickerHookProps } from "./useItemPicker";
+import { type ListBoxProps, type OptionProps } from "@salt-ds/core";
+import { type ItemTypeName } from "@vuu-ui/vuu-utils";
+import { type ComponentType, type HTMLAttributes, type MouseEventHandler } from "react";
+import { type ItemDescriptor, type ItemPickerHookProps } from "./useItemPicker";
 export declare const classBaseListItem = "vuuItemPickerListItem";
+export type ItemPickerLayout = 'v-available-selected' | 'v-selected-available';
 export interface ItemPickerProps extends ItemPickerHookProps, HTMLAttributes<HTMLDivElement>, Pick<ListBoxProps<ItemDescriptor>, "selected" | "onSelectionChange"> {
-    itemTypeName: ItemTypeName;
-    /** Render the search control as a form. Set false when the picker is nested in a form. */
+    AvailableListItem?: ComponentType<AvailableListItemProps>;
+    SelectedListItem?: ComponentType<SelectedListItemProps>;
+    itemTypeName?: ItemTypeName;
+    /**
+     * Display order of SelectedItems List / AvailableItems List
+     */
+    layout?: ItemPickerLayout;
     searchForm?: boolean;
-    createCustomItemProps?: CreateCustomItemProps;
+}
+interface SelectedListItemProps extends OptionProps {
+    index: number;
+    item: ItemDescriptor;
+    onRemove: MouseEventHandler<HTMLButtonElement>;
+    searchPattern?: Lowercase<string>;
+}
+interface AvailableListItemProps extends OptionProps {
+    index: number;
+    item: ItemDescriptor;
+    onAdd: MouseEventHandler<HTMLButtonElement>;
+    searchPattern?: Lowercase<string>;
 }
 /** Generic controlled component that displays items in a 'picker' that are available to search, select, reorder or deselect.
  * As input props, all available items, currently selected items, search text and callback functions for changes in selected items and search text
  * must be supplied by the client.
  */
 export declare const ItemPicker: import("react").ForwardRefExoticComponent<ItemPickerProps & import("react").RefAttributes<HTMLDivElement>>;
+export {};

package/types/item-picker/useItemPicker.d.ts

@@ -1,4 +1,5 @@
-import { FormEventHandler, MouseEventHandler } from "react";
+import { type ChangeEventHandler, type MouseEventHandler } from "react";
+export type SelectedItemsChangeHandler = (newSelectedItems: readonly ItemDescriptor[]) => void;
 /** This is a public description of an Item that can be displayed in the ItemPicker component, defining all the
  * mandatory and option attributes that can be defined by the client. */
 export interface ItemDescriptor {
@@ -11,15 +12,11 @@ export interface ItemDescriptor {
     /** Optional string to define groups of items for client reference, not currently used for rendering */
     group?: string;
 }
-export interface CreateCustomItemProps {
-    buttonLabel: string;
-    onClickCreateCustomItem: MouseEventHandler<HTMLButtonElement>;
-}
 export interface ItemPickerHookProps {
     allItems: ItemDescriptor[];
     selectedItems: ItemDescriptor[];
     maxSelections?: number;
-    onSelectedItemsChange: (newSelectedItems: ItemDescriptor[]) => void;
+    onSelectedItemsChange: SelectedItemsChangeHandler;
 }
 export declare const getItemLabel: (item: ItemDescriptor) => string;
 export declare const useItemPicker: ({ allItems, selectedItems, maxSelections, onSelectedItemsChange, }: ItemPickerHookProps) => {
@@ -28,7 +25,7 @@ export declare const useItemPicker: ({ allItems, selectedItems, maxSelections, o
     selectedItemsFiltered: readonly ItemDescriptor[];
     availableItemsFiltered: ItemDescriptor[];
     searchText: string;
-    onChangeSearchInput: FormEventHandler;
+    onChangeSearchInput: ChangeEventHandler;
     onAddItemToSelectedList: MouseEventHandler<HTMLButtonElement>;
     onRemoveItemFromSelectedList: MouseEventHandler<HTMLButtonElement>;
     onReorderSelectedItems: (orderedItemNames: string[]) => void;

package/types/modal-provider/ModalProvider.d.ts

@@ -4,7 +4,7 @@ export type ShowDialog = (dialogContent: ReactElement, title: string, dialogActi
 export type ShowPrompt = (promptContent: ReactElement, promptProps: PromptProps) => void;
 export declare const ModalProvider: ({ children }: {
     children: ReactNode;
-}) => import("react").JSX.Element;
+}) => import("react/jsx-runtime").JSX.Element;
 export declare const useModal: () => {
     showDialog: ShowDialog;
     closeDialog: () => void;

package/types/time-input/MaskedInput.d.ts

@@ -1,13 +1,32 @@
-import { EventEmitter, TimeString, TimeUnit } from "@vuu-ui/vuu-utils";
+import { EventEmitter, TimeString, TimeStringMillis, TimeUnit } from "@vuu-ui/vuu-utils";
 import { ChangeEventHandler } from "react";
 export type Digit = "0" | "1" | "2" | "3" | "4" | "5" | "6" | "7" | "8" | "9";
+export type TimeValue = TimeString | TimeStringMillis;
+export declare const invalidClassName = "vuuTimeInput-invalid";
+export interface MaskedInputOptions {
+    /**
+     * When true, value includes milliseconds, hh:mm:ss.SSS
+     */
+    milliseconds?: boolean;
+}
 export type MaskedInputEvents = {
     change: ChangeEventHandler<HTMLInputElement>;
 };
 export declare class MaskedInput extends EventEmitter<MaskedInputEvents> {
     #private;
-    constructor(defaultValue: TimeString | undefined, inputEl?: HTMLInputElement | null);
-    set input(el: HTMLInputElement);
+    constructor(defaultValue: TimeValue | undefined, inputEl?: HTMLInputElement | null, { milliseconds }?: MaskedInputOptions);
+    get milliseconds(): boolean;
+    private get zeroValue();
+    /**
+     * Length of the formatted value, hh:mm:ss or hh:mm:ss.SSS
+     */
+    get length(): 8 | 12;
+    private normalise;
+    /**
+     * Attach (or re-attach) the input element. Re-attaching the same element
+     * is a no-op, attaching a different element detaches the previous one.
+     */
+    set input(el: HTMLInputElement | null);
     /**
      * The change event is fired programatically. This will only be handled
      * by a native event handler ( not a React handler). We handle this event
@@ -21,25 +40,56 @@ export declare class MaskedInput extends EventEmitter<MaskedInputEvents> {
     set selectionStart(value: number);
     get selectionEnd(): number;
     set selectionEnd(value: number);
+    private nextUnit;
+    private previousUnit;
+    private get firstUnit();
+    private get lastUnit();
     private setValue;
-    private setUnitValue;
     private getUnitValue;
-    get value(): TimeString;
+    private setUnitValue;
+    private setInvalid;
+    get value(): TimeValue;
     /**
-     * Setting the value this way invokes 'controlled' mode
+     * Setting the value this way invokes 'controlled' mode. Value
+     * will be normalised to the configured precision.
      */
-    set value(value: TimeString);
+    set value(value: TimeValue);
     clear(unit: TimeUnit): void;
-    select(unit: TimeUnit, halfUnit?: boolean): void;
+    /**
+     * Select a unit. If digitIndex > 0, only the digits of the unit
+     * not yet entered are selected.
+     */
+    select(unit: TimeUnit, digitIndex?: number): void;
     removeSelection(): void;
     restoreSelection(): void;
-    advanceSelection(): void;
+    selectFirst(): void;
+    selectLast(): void;
     moveFocus(direction: "left" | "right"): void;
-    pasteValue(value: TimeString): void;
+    /**
+     * Replace the entire value, e.g. from a paste. Values with or without
+     * milliseconds are accepted and converted to the configured precision.
+     * Invalid values are ignored. Returns true if value was accepted.
+     */
+    pasteValue(value: string): boolean;
     private getUnitAtCursorPos;
+    private get activeUnit();
     incrementValue(): void;
     decrementValue(): void;
+    /**
+     * If a full unit is selected, it is cleared and selection moves to the
+     * previous unit. If we are midway through entering a unit, the unit is
+     * cleared and remains selected.
+     */
     backspace(): void;
+    /**
+     * Typing the first digit of a unit sets the unit to that digit followed
+     * by zeros, e.g '1' => '10' and selection moves to the next digit. If
+     * the digit cannot be the first digit of a valid unit, e.g '3' for hours,
+     * the unit is zero padded, e.g '03', and selection advances to the next unit.
+     * Typing the last digit completes the unit and selection advances to the
+     * next unit. A digit which would produce an invalid value is rejected and
+     * the input is marked as invalid.
+     */
     update(key: Digit): void;
     private getSelection;
     click(): void;

package/types/time-input/TimeInput.d.ts

@@ -1,5 +1,6 @@
 import { HTMLAttributes } from "react";
-import { TimeInputHookProps } from "./useTimeInput";
-export interface TimeInputProps extends TimeInputHookProps, Omit<HTMLAttributes<HTMLInputElement>, "defaultValue" | "onChange" | "value">, Partial<Pick<HTMLInputElement, "placeholder">> {
-}
+import { TimeInputHookProps, TimeInputMillisecondsProps, TimeInputSecondsProps } from "./useTimeInput";
+type TimeInputHtmlAttributes = Omit<HTMLAttributes<HTMLInputElement>, "defaultValue" | "onChange" | "value"> & Partial<Pick<HTMLInputElement, "placeholder">>;
+export type { TimeInputMillisecondsProps, TimeInputSecondsProps };
+export type TimeInputProps = TimeInputHookProps & TimeInputHtmlAttributes;
 export declare const TimeInput: import("react").ForwardRefExoticComponent<TimeInputProps & import("react").RefAttributes<HTMLInputElement>>;

package/types/time-input/useTimeInput.d.ts

@@ -1,16 +1,34 @@
-import { type CommitHandler, DateStringISO, type TimeString } from "@vuu-ui/vuu-utils";
+import { type CommitHandler, DateStringISO, type TimeString, type TimeStringMillis } from "@vuu-ui/vuu-utils";
 import { ChangeEventHandler, ClipboardEventHandler, FocusEventHandler, KeyboardEventHandler, MouseEventHandler, RefCallback } from "react";
-export interface TimeInputHookProps {
+interface TimeInputCommonProps {
     date?: Date | DateStringISO;
-    defaultValue?: TimeString;
     onChange?: ChangeEventHandler<HTMLInputElement>;
+}
+export interface TimeInputSecondsProps extends TimeInputCommonProps {
+    defaultValue?: TimeString;
+    /**
+     * When true, time is entered and displayed with millisecond
+     * precision, hh:mm:ss.SSS
+     */
+    milliseconds?: false;
     onCommit: CommitHandler<HTMLInputElement, TimeString>;
     value?: TimeString;
 }
-export declare const useTimeInput: ({ defaultValue, onChange, onCommit, value, }: TimeInputHookProps) => {
+export interface TimeInputMillisecondsProps extends TimeInputCommonProps {
+    defaultValue?: TimeStringMillis;
+    /**
+     * When true, time is entered and displayed with millisecond
+     * precision, hh:mm:ss.SSS
+     */
+    milliseconds: true;
+    onCommit: CommitHandler<HTMLInputElement, TimeStringMillis>;
+    value?: TimeStringMillis;
+}
+export type TimeInputHookProps = TimeInputSecondsProps | TimeInputMillisecondsProps;
+export declare const useTimeInput: ({ defaultValue, milliseconds, onChange, onCommit: onCommitProp, value, }: TimeInputHookProps) => {
     inputRef: RefCallback<HTMLInputElement>;
     eventHandlers: {
-        onBlur: (() => void) | undefined;
+        onBlur: () => void;
         onDoubleClick: () => void;
         onFocus: FocusEventHandler<HTMLInputElement>;
         onKeyDown: KeyboardEventHandler<HTMLInputElement>;
@@ -19,3 +37,4 @@ export declare const useTimeInput: ({ defaultValue, onChange, onCommit, value, }
         onPaste: ClipboardEventHandler<HTMLInputElement>;
     };
 };
+export {};

package/types/vuu-date-picker/VuuDatePicker.d.ts

@@ -1,7 +1,23 @@
-import { CommitHandler } from "@vuu-ui/vuu-utils";
+import { type CommitHandler, EpochTimestamp, type TimeZoneSpec } from "@vuu-ui/vuu-utils";
 import { SingleSelectionValueType } from "../calendar";
 import { DatePickerProps } from "../date-picker";
-export declare const VuuDatePicker: ({ className, onSelectionChange, selectedDate: selectedDateProp, onCommit, preserveFocusOnSelect, ...props }: Omit<DatePickerProps<SingleSelectionValueType>, "defaultSelectedDate"> & {
+export interface VuuDatePickerProps extends Omit<DatePickerProps<SingleSelectionValueType>, "defaultSelectedDate" | "onChange"> {
+    /**
+     * Invoked when user selects a date from the calendar, or enters a valid date and
+     * presses Enter. Value is epoch millis at the start of the selected day, in timeZone.
+     */
     onCommit?: CommitHandler<HTMLElement, number>;
     preserveFocusOnSelect?: boolean;
-}) => import("react").JSX.Element;
+    /**
+     * The time zone used to convert between epoch values and calendar dates.
+     * Defaults to the application default time zone (see setDefaultTimeZone).
+     */
+    timeZone?: TimeZoneSpec;
+    /**
+     * An epoch value (millis as number, or millis/nanos as EpochTimestamp). An
+     * alternative to selectedDate, when the date is derived from a timestamp. The
+     * calendar date is determined in timeZone.
+     */
+    value?: EpochTimestamp | number;
+}
+export declare const VuuDatePicker: ({ className, onSelectionChange, onCommit, preserveFocusOnSelect, selectedDate: selectedDateProp, timeZone, value, ...props }: VuuDatePickerProps) => import("react").JSX.Element;

package/types/vuu-time-picker/VuuTimePicker.d.ts

@@ -1,7 +1,9 @@
-import { CommitHandler, TimeString } from "@vuu-ui/vuu-utils";
 import { HTMLAttributes } from "react";
-import { TimeInputProps } from "../time-input/TimeInput";
-export interface VuuTimePickerProps extends Pick<TimeInputProps, "defaultValue" | "onChange" | "value">, Omit<HTMLAttributes<HTMLDivElement>, "defaultValue" | "onChange" | "value"> {
-    onCommit: CommitHandler<HTMLInputElement, TimeString>;
-}
-export declare const VuuTimePicker: ({ className, defaultValue, onChange, onCommit, value, ...htmlAttributes }: VuuTimePickerProps) => import("react").JSX.Element;
+import { TimeInputMillisecondsProps, TimeInputSecondsProps } from "../time-input/TimeInput";
+type VuuTimePickerHtmlAttributes = Omit<HTMLAttributes<HTMLDivElement>, "defaultValue" | "onChange" | "value">;
+type TimePickerInputProps = "defaultValue" | "milliseconds" | "onChange" | "onCommit" | "value";
+export type VuuTimePickerSecondsProps = Pick<TimeInputSecondsProps, TimePickerInputProps> & VuuTimePickerHtmlAttributes;
+export type VuuTimePickerMillisecondsProps = Pick<TimeInputMillisecondsProps, TimePickerInputProps> & VuuTimePickerHtmlAttributes;
+export type VuuTimePickerProps = VuuTimePickerSecondsProps | VuuTimePickerMillisecondsProps;
+export declare const VuuTimePicker: ({ className, defaultValue, milliseconds, onChange, onCommit, value, ...htmlAttributes }: VuuTimePickerProps) => import("react").JSX.Element;
+export {};