@vireocodedev/ui 0.2.0 → 0.2.1

package/dist/capabilities/forms/components/forms/VireoFormSwitchField/VireoFormSwitchField.js

@@ -0,0 +1,154 @@
+import { jsx as _jsx, jsxs as _jsxs } from "react/jsx-runtime";
+import { useVireoFormContext } from "../../../../../capabilities/forms/contexts/VireoFormContext/VireoFormContext.js";
+import { useVireoFieldContext } from "../../../../../capabilities/forms/contexts/VireoFormHookContexts/VireoFormHookContexts.js";
+import { formatFirstVireoFormError, shouldDisplayVireoFormError } from "../../../../../capabilities/forms/utils/vireoFormErrors.js";
+import { joinClassNames, mergeSx, resolveSlotProps } from "../../../../../core/public.js";
+import { unstable_composeClasses as composeClasses } from "@mui/material";
+import { useThemeProps } from "@mui/material/styles";
+import { useForkRef } from "@mui/material/utils";
+import { useStore } from "@tanstack/react-form";
+import React from "react";
+import { getVireoFormSwitchFieldUtilityClass } from "./VireoFormSwitchField.classes.js";
+import { VIREO_FORM_SWITCH_FIELD_NAME } from "./VireoFormSwitchField.identity.js";
+import { VireoFormSwitchFieldFormControlLabel, VireoFormSwitchFieldFormHelperText, VireoFormSwitchFieldLabel, VireoFormSwitchFieldRoot, VireoFormSwitchFieldSwitch, } from "./VireoFormSwitchField.styled.js";
+function useUtilityClasses(ownerState, classes) {
+    return composeClasses({
+        root: [
+            "root",
+            ownerState.checked && "checked",
+            ownerState.dirty && "dirty",
+            ownerState.touched && "touched",
+            ownerState.invalid && "invalid",
+            ownerState.errorVisible && "errorVisible",
+            ownerState.validating && "validating",
+            ownerState.submitting && "submitting",
+            ownerState.disabled && "disabled",
+        ],
+        formControlLabel: ["formControlLabel"],
+        switch: ["switch"],
+        label: ["label"],
+        formHelperText: ["formHelperText"],
+    }, getVireoFormSwitchFieldUtilityClass, classes);
+}
+function isAriaInvalid(value) {
+    return value === true || value === "true";
+}
+function joinIds(...ids) {
+    const joined = ids.filter(Boolean).join(" ");
+    return joined || undefined;
+}
+function assignRef(ref, value) {
+    if (typeof ref === "function")
+        ref(value);
+    else if (ref)
+        ref.current = value;
+}
+/**
+ * Binds a labelled MUI Switch to the current TanStack Form boolean field and shared validation policy.
+ *
+ * Consumers render it as `field.SwitchField`; the raw runtime remains internal to the forms capability.
+ */
+export const VireoFormSwitchField = React.forwardRef(function VireoFormSwitchField(inProps, forwardedRef) {
+    const props = useThemeProps({ props: inProps, name: VIREO_FORM_SWITCH_FIELD_NAME });
+    const { className, classes: classesProp, disabled = false, error = false, errorDisplay: errorDisplayProp, formatError: formatErrorProp, fullWidth = true, helperText = " ", inputRef, label, labelPlacement = "end", onBlur, onChange, required = false, slotProps = {}, slots = {}, style, sx, ...other } = props;
+    const field = useVireoFieldContext();
+    const formContext = useVireoFormContext();
+    const generatedHelperTextId = React.useId();
+    const fieldState = useStore(field.store, current => ({
+        dirty: current.meta.isDirty,
+        errors: current.meta.errors,
+        invalid: !current.meta.isValid,
+        touched: current.meta.isTouched,
+        validating: current.meta.isValidating,
+        value: current.value,
+    }));
+    const submitting = useStore(field.form.store, current => current.isSubmitting);
+    const errorDisplay = errorDisplayProp ?? formContext.errorDisplay;
+    const errorVisible = fieldState.invalid &&
+        shouldDisplayVireoFormError(errorDisplay, {
+            submissionAttempts: formContext.submissionAttempts,
+            touched: fieldState.touched,
+        });
+    const formattedError = errorVisible
+        ? formatFirstVireoFormError(fieldState.errors, formatErrorProp ?? formContext.formatError)
+        : undefined;
+    const ownerState = {
+        checked: fieldState.value === true,
+        dirty: fieldState.dirty,
+        disabled,
+        errorVisible,
+        invalid: fieldState.invalid,
+        submitting,
+        touched: fieldState.touched,
+        validating: fieldState.validating,
+    };
+    const classes = useUtilityClasses(ownerState, classesProp);
+    const resolvedRootSlotProps = resolveSlotProps(slotProps.root, ownerState);
+    const { className: rootSlotClassName, ref: rootSlotRef, style: rootSlotStyle, sx: rootSlotSx, ...rootSlotOther } = resolvedRootSlotProps;
+    const resolvedFormControlLabelSlotProps = resolveSlotProps(slotProps.formControlLabel, ownerState);
+    const { className: formControlLabelSlotClassName, onChange: formControlLabelSlotOnChange, ...formControlLabelSlotOther } = resolvedFormControlLabelSlotProps;
+    const resolvedSwitchSlotProps = resolveSlotProps(slotProps.switch, ownerState);
+    const { className: switchSlotClassName, inputProps: switchSlotInputProps, inputRef: switchSlotInputRef, slotProps: switchMuiSlotProps, onBlur: switchSlotOnBlur, onChange: switchSlotOnChange, ...switchSlotOther } = resolvedSwitchSlotProps;
+    const resolvedLabelSlotProps = resolveSlotProps(slotProps.label, ownerState);
+    const { className: labelSlotClassName, ...labelSlotOther } = resolvedLabelSlotProps;
+    const resolvedFormHelperTextSlotProps = resolveSlotProps(slotProps.formHelperText, ownerState);
+    const { className: formHelperTextSlotClassName, id: formHelperTextSlotId, ...formHelperTextSlotOther } = resolvedFormHelperTextSlotProps;
+    const rootRef = useForkRef(forwardedRef, rootSlotRef);
+    const nativeInputRef = useForkRef(inputRef, switchSlotInputRef);
+    const effectiveError = error || fieldState.invalid;
+    const effectiveHelperText = errorVisible ? formattedError : helperText;
+    const formHelperTextId = formHelperTextSlotId ?? generatedHelperTextId;
+    const inputDescribedBy = joinIds(switchSlotInputProps?.["aria-describedby"], effectiveHelperText !== undefined ? formHelperTextId : undefined);
+    const handleChange = (event, checked) => {
+        const restoreCheckedValue = () => {
+            const input = event.currentTarget;
+            queueMicrotask(() => {
+                input.checked = ownerState.checked;
+            });
+        };
+        formControlLabelSlotOnChange?.(event, checked);
+        if (event.defaultPrevented) {
+            restoreCheckedValue();
+            return;
+        }
+        switchSlotOnChange?.(event, checked);
+        if (event.defaultPrevented) {
+            restoreCheckedValue();
+            return;
+        }
+        onChange?.(event, checked);
+        if (event.defaultPrevented) {
+            restoreCheckedValue();
+            return;
+        }
+        field.handleChange(checked);
+    };
+    const handleBlur = event => {
+        switchSlotOnBlur?.(event);
+        if (event.defaultPrevented)
+            return;
+        onBlur?.(event);
+        if (event.defaultPrevented)
+            return;
+        field.handleBlur();
+    };
+    return (_jsxs(VireoFormSwitchFieldRoot, { ...other, ...rootSlotOther, as: slots.root, ref: rootRef, ownerState: ownerState, className: joinClassNames(classes.root, className, rootSlotClassName), disabled: disabled, error: effectiveError, fullWidth: fullWidth, required: required, style: { ...style, ...rootSlotStyle }, sx: mergeSx(sx, rootSlotSx), children: [_jsx(VireoFormSwitchFieldFormControlLabel, { ...formControlLabelSlotOther, as: slots.formControlLabel, ownerState: ownerState, className: joinClassNames(classes.formControlLabel, formControlLabelSlotClassName), control: _jsx(VireoFormSwitchFieldSwitch, { ...switchSlotOther, as: slots.switch, ownerState: ownerState, checked: ownerState.checked, className: joinClassNames(classes.switch, switchSlotClassName), disabled: disabled, slotProps: {
+                        ...switchMuiSlotProps,
+                        input: muiOwnerState => {
+                            const muiInputProps = typeof switchMuiSlotProps?.input === "function"
+                                ? switchMuiSlotProps.input(muiOwnerState)
+                                : switchMuiSlotProps?.input;
+                            return {
+                                ...muiInputProps,
+                                ...switchSlotInputProps,
+                                "aria-describedby": inputDescribedBy,
+                                "aria-invalid": effectiveError || isAriaInvalid(switchSlotInputProps?.["aria-invalid"]) || undefined,
+                                ref: (node) => {
+                                    assignRef(muiInputProps?.ref, node);
+                                    assignRef(nativeInputRef, node);
+                                },
+                            };
+                        },
+                    }, name: field.name, onBlur: handleBlur, onChange: handleChange, required: required }), disabled: disabled, disableTypography: true, label: _jsx(VireoFormSwitchFieldLabel, { ...labelSlotOther, as: slots.label, ownerState: ownerState, className: joinClassNames(classes.label, labelSlotClassName), component: "span", children: label }), labelPlacement: labelPlacement, onChange: undefined, required: required }), effectiveHelperText !== undefined && (_jsx(VireoFormSwitchFieldFormHelperText, { ...formHelperTextSlotOther, as: slots.formHelperText, id: formHelperTextId, ownerState: ownerState, className: joinClassNames(classes.formHelperText, formHelperTextSlotClassName), children: effectiveHelperText }))] }));
+});
+VireoFormSwitchField.displayName = VIREO_FORM_SWITCH_FIELD_NAME;

package/dist/capabilities/forms/components/forms/VireoFormSwitchField/VireoFormSwitchField.styled.d.ts

@@ -0,0 +1,10 @@
+import { type StyledSlotComponent } from "../../../../../core/public.js";
+import { type FormControlLabelProps, type FormControlProps, type FormHelperTextProps, type SwitchProps, type TypographyProps } from "@mui/material";
+import { type VireoFormSwitchFieldOwnerState } from "./VireoFormSwitchField.types.js";
+type VireoFormSwitchFieldStyledSlotComponent<TProps extends object> = StyledSlotComponent<TProps, VireoFormSwitchFieldOwnerState>;
+export declare const VireoFormSwitchFieldRoot: VireoFormSwitchFieldStyledSlotComponent<FormControlProps>;
+export declare const VireoFormSwitchFieldFormControlLabel: VireoFormSwitchFieldStyledSlotComponent<FormControlLabelProps>;
+export declare const VireoFormSwitchFieldSwitch: VireoFormSwitchFieldStyledSlotComponent<SwitchProps>;
+export declare const VireoFormSwitchFieldLabel: VireoFormSwitchFieldStyledSlotComponent<TypographyProps>;
+export declare const VireoFormSwitchFieldFormHelperText: VireoFormSwitchFieldStyledSlotComponent<FormHelperTextProps>;
+export {};

package/dist/capabilities/forms/components/forms/VireoFormSwitchField/VireoFormSwitchField.styled.js

@@ -0,0 +1,38 @@
+import { FormControl, FormControlLabel, FormHelperText, Switch, Typography, } from "@mui/material";
+import { styled } from "@mui/material/styles";
+import { VIREO_FORM_SWITCH_FIELD_NAME } from "./VireoFormSwitchField.identity.js";
+export const VireoFormSwitchFieldRoot = styled(FormControl, {
+    name: VIREO_FORM_SWITCH_FIELD_NAME,
+    slot: "Root",
+    overridesResolver: (props, styles) => [
+        styles.root,
+        props.ownerState.checked && styles.checked,
+        props.ownerState.dirty && styles.dirty,
+        props.ownerState.touched && styles.touched,
+        props.ownerState.invalid && styles.invalid,
+        props.ownerState.errorVisible && styles.errorVisible,
+        props.ownerState.validating && styles.validating,
+        props.ownerState.submitting && styles.submitting,
+        props.ownerState.disabled && styles.disabled,
+    ],
+})({});
+export const VireoFormSwitchFieldFormControlLabel = styled(FormControlLabel, {
+    name: VIREO_FORM_SWITCH_FIELD_NAME,
+    slot: "FormControlLabel",
+    overridesResolver: (_props, styles) => styles.formControlLabel,
+})({});
+export const VireoFormSwitchFieldSwitch = styled(Switch, {
+    name: VIREO_FORM_SWITCH_FIELD_NAME,
+    slot: "Switch",
+    overridesResolver: (_props, styles) => styles.switch,
+})({});
+export const VireoFormSwitchFieldLabel = styled(Typography, {
+    name: VIREO_FORM_SWITCH_FIELD_NAME,
+    slot: "Label",
+    overridesResolver: (_props, styles) => styles.label,
+})({});
+export const VireoFormSwitchFieldFormHelperText = styled(FormHelperText, {
+    name: VIREO_FORM_SWITCH_FIELD_NAME,
+    slot: "FormHelperText",
+    overridesResolver: (_props, styles) => styles.formHelperText,
+})({});

package/dist/capabilities/forms/components/forms/VireoFormSwitchField/VireoFormSwitchField.types.d.ts

@@ -0,0 +1,93 @@
+import type { VireoFormErrorDisplay, VireoFormErrorFormatter } from "../../../../../capabilities/forms/components/forms/VireoForm/VireoForm.types.js";
+import type { VireoDataAttributeValue, VireoThemeComponent } from "../../../../../core/public.js";
+import type { FormControl, FormControlLabel, FormControlLabelProps, FormControlProps, FormHelperText, Switch, SwitchProps, Typography } from "@mui/material";
+import type { CreateSlotsAndSlotProps, SlotProps } from "@mui/material/utils";
+import type React from "react";
+import { type VireoFormSwitchFieldClasses, type VireoFormSwitchFieldClassKey } from "./VireoFormSwitchField.classes.js";
+import type { VIREO_FORM_SWITCH_FIELD_NAME } from "./VireoFormSwitchField.identity.js";
+export type VireoFormSwitchFieldOwnerState = {
+    checked: boolean;
+    dirty: boolean;
+    disabled: boolean;
+    errorVisible: boolean;
+    invalid: boolean;
+    submitting: boolean;
+    touched: boolean;
+    validating: boolean;
+};
+export interface VireoFormSwitchFieldRootSlotPropsOverrides {
+    [key: `data-${string}`]: VireoDataAttributeValue;
+}
+export interface VireoFormSwitchFieldFormControlLabelSlotPropsOverrides {
+    [key: `data-${string}`]: VireoDataAttributeValue;
+}
+export interface VireoFormSwitchFieldSwitchSlotPropsOverrides {
+    [key: `data-${string}`]: VireoDataAttributeValue;
+    /** Compatibility alias merged into MUI's native `input` slot. */
+    inputProps?: React.InputHTMLAttributes<HTMLInputElement>;
+    /** Compatibility alias forwarded to MUI's native `input` slot. */
+    inputRef?: React.Ref<HTMLInputElement>;
+}
+export interface VireoFormSwitchFieldLabelSlotPropsOverrides {
+    [key: `data-${string}`]: VireoDataAttributeValue;
+}
+export interface VireoFormSwitchFieldFormHelperTextSlotPropsOverrides {
+    [key: `data-${string}`]: VireoDataAttributeValue;
+}
+/** Replaceable semantic regions exposed by the bound form switch field. */
+export type VireoFormSwitchFieldSlots = {
+    root: React.ElementType;
+    formControlLabel: React.ElementType;
+    switch: React.ElementType;
+    label: React.ElementType;
+    formHelperText: React.ElementType;
+};
+/** Slot props exposed by the bound form switch field. */
+export type VireoFormSwitchFieldSlotsAndSlotProps = CreateSlotsAndSlotProps<VireoFormSwitchFieldSlots, {
+    /** @default FormControl */
+    root: SlotProps<typeof FormControl, VireoFormSwitchFieldRootSlotPropsOverrides, VireoFormSwitchFieldOwnerState>;
+    /** @default FormControlLabel */
+    formControlLabel: SlotProps<typeof FormControlLabel, VireoFormSwitchFieldFormControlLabelSlotPropsOverrides, VireoFormSwitchFieldOwnerState>;
+    /** @default Switch */
+    switch: SlotProps<typeof Switch, VireoFormSwitchFieldSwitchSlotPropsOverrides, VireoFormSwitchFieldOwnerState>;
+    /** @default Typography */
+    label: SlotProps<typeof Typography, VireoFormSwitchFieldLabelSlotPropsOverrides, VireoFormSwitchFieldOwnerState>;
+    /** @default FormHelperText */
+    formHelperText: SlotProps<typeof FormHelperText, VireoFormSwitchFieldFormHelperTextSlotPropsOverrides, VireoFormSwitchFieldOwnerState>;
+}>;
+type VireoFormSwitchFieldComponentOwnedProp = "children" | "classes" | "component" | "disabled" | "error" | "fullWidth" | "onBlur" | "onChange" | "required" | "slotProps" | "slots";
+/** Props VireoFormSwitchField inherits from its default root after excluding component-owned props. */
+export type VireoFormSwitchFieldInheritedProps = Omit<FormControlProps, VireoFormSwitchFieldComponentOwnedProp>;
+/** Props owned by the bound form switch field. The field name and checked value remain owned by `form.Field`. */
+export type VireoFormSwitchFieldOwnProps = VireoFormSwitchFieldSlotsAndSlotProps & {
+    /** Override or extend the utility classes applied to each slot and state. */
+    classes?: Partial<VireoFormSwitchFieldClasses>;
+    disabled?: boolean;
+    /** Adds an error presentation state without suppressing validation errors. */
+    error?: boolean;
+    /** Overrides the enclosing form's error-display policy for this field. */
+    errorDisplay?: VireoFormErrorDisplay;
+    /** Overrides the enclosing form's validation-error formatter for this field. */
+    formatError?: VireoFormErrorFormatter;
+    /** @default true */
+    fullWidth?: boolean;
+    /** Shown when no visible validation error takes precedence. Defaults to a reserved line; pass `null` to remove it. @default ' ' */
+    helperText?: React.ReactNode;
+    /** Ref forwarded to the native checkbox input. */
+    inputRef?: React.Ref<HTMLInputElement>;
+    /** Visible accessible label rendered beside the switch. */
+    label: React.ReactNode;
+    /** @default 'end' */
+    labelPlacement?: FormControlLabelProps["labelPlacement"];
+    onBlur?: NonNullable<SwitchProps["onBlur"]>;
+    onChange?: NonNullable<SwitchProps["onChange"]>;
+    required?: boolean;
+};
+/** Props accepted by `field.SwitchField`. */
+export type VireoFormSwitchFieldProps = VireoFormSwitchFieldOwnProps & VireoFormSwitchFieldInheritedProps;
+declare module "@mui/material/styles" {
+    interface Components<Theme = unknown> {
+        [VIREO_FORM_SWITCH_FIELD_NAME]?: VireoThemeComponent<VireoFormSwitchFieldProps, VireoFormSwitchFieldClassKey, VireoFormSwitchFieldOwnerState, Theme>;
+    }
+}
+export {};

package/dist/capabilities/forms/components/forms/VireoFormSwitchField/VireoFormSwitchField.types.js

@@ -0,0 +1 @@
+export {};

package/dist/capabilities/forms/components/forms/VireoFormSwitchField/index.d.ts

@@ -0,0 +1,3 @@
+export * from "./VireoFormSwitchField.js";
+export * from "./VireoFormSwitchField.classes.js";
+export * from "./VireoFormSwitchField.types.js";

package/dist/capabilities/forms/components/forms/VireoFormSwitchField/index.js

@@ -0,0 +1,3 @@
+export * from "./VireoFormSwitchField.js";
+export * from "./VireoFormSwitchField.classes.js";
+export * from "./VireoFormSwitchField.types.js";

package/dist/capabilities/forms/components/forms/VireoFormTemporalField/VireoFormTemporalField.classes.d.ts

@@ -0,0 +1,9 @@
+import { type VireoFormTemporalFieldSlotName } from "./VireoFormTemporalField.identity.js";
+/** Utility classes available to VireoFormTemporalField. */
+export type VireoFormTemporalFieldClasses = Record<VireoFormTemporalFieldSlotName | "dirty" | "touched" | "invalid" | "errorVisible" | "validating" | "submitting" | "disabled" | "readOnly" | "hasValue", string>;
+/** Valid keys for VireoFormTemporalField utility classes and theme style overrides. */
+export type VireoFormTemporalFieldClassKey = keyof VireoFormTemporalFieldClasses;
+/** Returns the generated utility class name for a VireoFormTemporalField slot or state. */
+export declare function getVireoFormTemporalFieldUtilityClass(slot: string): string;
+/** Generated utility class names keyed by each public VireoFormTemporalField class key. */
+export declare const vireoFormTemporalFieldClasses: VireoFormTemporalFieldClasses;

package/dist/capabilities/forms/components/forms/VireoFormTemporalField/VireoFormTemporalField.classes.js

@@ -0,0 +1,19 @@
+import { generateUtilityClass, generateUtilityClasses } from "@mui/material";
+import { VIREO_FORM_TEMPORAL_FIELD_NAME, VIREO_FORM_TEMPORAL_FIELD_SLOTS, } from "./VireoFormTemporalField.identity.js";
+/** Returns the generated utility class name for a VireoFormTemporalField slot or state. */
+export function getVireoFormTemporalFieldUtilityClass(slot) {
+    return generateUtilityClass(VIREO_FORM_TEMPORAL_FIELD_NAME, slot);
+}
+/** Generated utility class names keyed by each public VireoFormTemporalField class key. */
+export const vireoFormTemporalFieldClasses = generateUtilityClasses(VIREO_FORM_TEMPORAL_FIELD_NAME, [
+    ...VIREO_FORM_TEMPORAL_FIELD_SLOTS,
+    "dirty",
+    "touched",
+    "invalid",
+    "errorVisible",
+    "validating",
+    "submitting",
+    "disabled",
+    "readOnly",
+    "hasValue",
+]);

package/dist/capabilities/forms/components/forms/VireoFormTemporalField/VireoFormTemporalField.d.ts

@@ -0,0 +1,170 @@
+import React from "react";
+import { type VireoFormTemporalFieldValue } from "./VireoFormTemporalField.types.js";
+/**
+ * Binds localized MUI date and time pickers to canonical timezone-free `string | null` TanStack Form values.
+ *
+ * Consumers render this component through `field.TemporalField`; the raw runtime is intentionally capability-bound.
+ */
+export declare const VireoFormTemporalField: React.ForwardRefExoticComponent<(Omit<import("./VireoFormTemporalField.types.js").VireoFormTemporalFieldSlotsAndSlotProps & {
+    classes?: Partial<import("./VireoFormTemporalField.classes.js").VireoFormTemporalFieldClasses>;
+    disabled?: boolean;
+    error?: boolean;
+    errorDisplay?: import("../VireoForm/index.js").VireoFormErrorDisplay;
+    formatError?: import("../VireoForm/index.js").VireoFormErrorFormatter;
+    fullWidth?: boolean;
+    helperText?: React.ReactNode;
+    inputRef?: React.Ref<HTMLInputElement>;
+    min?: string;
+    max?: string;
+    onBlur?: React.FocusEventHandler<HTMLDivElement>;
+    onValueChange?: (value: VireoFormTemporalFieldValue) => void;
+    referenceValue?: string;
+    readOnly?: boolean;
+    required?: boolean;
+    clearable?: boolean;
+    clearLabel?: string;
+    variant?: import("@mui/material").TextFieldProps["variant"];
+} & {
+    mode: "year";
+    openTo?: "year";
+    pickerProps?: import("./VireoFormTemporalField.types.js").VireoFormTemporalFieldDatePickerProps;
+    ampm?: never;
+    precision?: never;
+    minuteStep?: never;
+    secondStep?: never;
+} & import("./VireoFormTemporalField.types.js").VireoFormTemporalFieldInheritedProps, "ref"> | Omit<import("./VireoFormTemporalField.types.js").VireoFormTemporalFieldSlotsAndSlotProps & {
+    classes?: Partial<import("./VireoFormTemporalField.classes.js").VireoFormTemporalFieldClasses>;
+    disabled?: boolean;
+    error?: boolean;
+    errorDisplay?: import("../VireoForm/index.js").VireoFormErrorDisplay;
+    formatError?: import("../VireoForm/index.js").VireoFormErrorFormatter;
+    fullWidth?: boolean;
+    helperText?: React.ReactNode;
+    inputRef?: React.Ref<HTMLInputElement>;
+    min?: string;
+    max?: string;
+    onBlur?: React.FocusEventHandler<HTMLDivElement>;
+    onValueChange?: (value: VireoFormTemporalFieldValue) => void;
+    referenceValue?: string;
+    readOnly?: boolean;
+    required?: boolean;
+    clearable?: boolean;
+    clearLabel?: string;
+    variant?: import("@mui/material").TextFieldProps["variant"];
+} & {
+    mode: "month";
+    openTo?: "month";
+    pickerProps?: import("./VireoFormTemporalField.types.js").VireoFormTemporalFieldDatePickerProps;
+    ampm?: never;
+    precision?: never;
+    minuteStep?: never;
+    secondStep?: never;
+} & import("./VireoFormTemporalField.types.js").VireoFormTemporalFieldInheritedProps, "ref"> | Omit<import("./VireoFormTemporalField.types.js").VireoFormTemporalFieldSlotsAndSlotProps & {
+    classes?: Partial<import("./VireoFormTemporalField.classes.js").VireoFormTemporalFieldClasses>;
+    disabled?: boolean;
+    error?: boolean;
+    errorDisplay?: import("../VireoForm/index.js").VireoFormErrorDisplay;
+    formatError?: import("../VireoForm/index.js").VireoFormErrorFormatter;
+    fullWidth?: boolean;
+    helperText?: React.ReactNode;
+    inputRef?: React.Ref<HTMLInputElement>;
+    min?: string;
+    max?: string;
+    onBlur?: React.FocusEventHandler<HTMLDivElement>;
+    onValueChange?: (value: VireoFormTemporalFieldValue) => void;
+    referenceValue?: string;
+    readOnly?: boolean;
+    required?: boolean;
+    clearable?: boolean;
+    clearLabel?: string;
+    variant?: import("@mui/material").TextFieldProps["variant"];
+} & {
+    mode: "year-month";
+    openTo?: "year" | "month";
+    pickerProps?: import("./VireoFormTemporalField.types.js").VireoFormTemporalFieldDatePickerProps;
+    ampm?: never;
+    precision?: never;
+    minuteStep?: never;
+    secondStep?: never;
+} & import("./VireoFormTemporalField.types.js").VireoFormTemporalFieldInheritedProps, "ref"> | Omit<import("./VireoFormTemporalField.types.js").VireoFormTemporalFieldSlotsAndSlotProps & {
+    classes?: Partial<import("./VireoFormTemporalField.classes.js").VireoFormTemporalFieldClasses>;
+    disabled?: boolean;
+    error?: boolean;
+    errorDisplay?: import("../VireoForm/index.js").VireoFormErrorDisplay;
+    formatError?: import("../VireoForm/index.js").VireoFormErrorFormatter;
+    fullWidth?: boolean;
+    helperText?: React.ReactNode;
+    inputRef?: React.Ref<HTMLInputElement>;
+    min?: string;
+    max?: string;
+    onBlur?: React.FocusEventHandler<HTMLDivElement>;
+    onValueChange?: (value: VireoFormTemporalFieldValue) => void;
+    referenceValue?: string;
+    readOnly?: boolean;
+    required?: boolean;
+    clearable?: boolean;
+    clearLabel?: string;
+    variant?: import("@mui/material").TextFieldProps["variant"];
+} & {
+    mode: "date";
+    openTo?: "year" | "month" | "day";
+    pickerProps?: import("./VireoFormTemporalField.types.js").VireoFormTemporalFieldDatePickerProps;
+    ampm?: never;
+    precision?: never;
+    minuteStep?: never;
+    secondStep?: never;
+} & import("./VireoFormTemporalField.types.js").VireoFormTemporalFieldInheritedProps, "ref"> | Omit<import("./VireoFormTemporalField.types.js").VireoFormTemporalFieldSlotsAndSlotProps & {
+    classes?: Partial<import("./VireoFormTemporalField.classes.js").VireoFormTemporalFieldClasses>;
+    disabled?: boolean;
+    error?: boolean;
+    errorDisplay?: import("../VireoForm/index.js").VireoFormErrorDisplay;
+    formatError?: import("../VireoForm/index.js").VireoFormErrorFormatter;
+    fullWidth?: boolean;
+    helperText?: React.ReactNode;
+    inputRef?: React.Ref<HTMLInputElement>;
+    min?: string;
+    max?: string;
+    onBlur?: React.FocusEventHandler<HTMLDivElement>;
+    onValueChange?: (value: VireoFormTemporalFieldValue) => void;
+    referenceValue?: string;
+    readOnly?: boolean;
+    required?: boolean;
+    clearable?: boolean;
+    clearLabel?: string;
+    variant?: import("@mui/material").TextFieldProps["variant"];
+} & {
+    mode: "time";
+    openTo?: "hours" | "minutes" | "seconds";
+    pickerProps?: import("./VireoFormTemporalField.types.js").VireoFormTemporalFieldTimePickerProps;
+    ampm?: boolean;
+    precision?: import("./VireoFormTemporalField.types.js").VireoFormTemporalFieldPrecision;
+    minuteStep?: number;
+    secondStep?: number;
+} & import("./VireoFormTemporalField.types.js").VireoFormTemporalFieldInheritedProps, "ref"> | Omit<import("./VireoFormTemporalField.types.js").VireoFormTemporalFieldSlotsAndSlotProps & {
+    classes?: Partial<import("./VireoFormTemporalField.classes.js").VireoFormTemporalFieldClasses>;
+    disabled?: boolean;
+    error?: boolean;
+    errorDisplay?: import("../VireoForm/index.js").VireoFormErrorDisplay;
+    formatError?: import("../VireoForm/index.js").VireoFormErrorFormatter;
+    fullWidth?: boolean;
+    helperText?: React.ReactNode;
+    inputRef?: React.Ref<HTMLInputElement>;
+    min?: string;
+    max?: string;
+    onBlur?: React.FocusEventHandler<HTMLDivElement>;
+    onValueChange?: (value: VireoFormTemporalFieldValue) => void;
+    referenceValue?: string;
+    readOnly?: boolean;
+    required?: boolean;
+    clearable?: boolean;
+    clearLabel?: string;
+    variant?: import("@mui/material").TextFieldProps["variant"];
+} & {
+    mode: "date-time";
+    openTo?: "year" | "month" | "day" | "hours" | "minutes" | "seconds";
+    pickerProps?: import("./VireoFormTemporalField.types.js").VireoFormTemporalFieldDateTimePickerProps;
+    ampm?: boolean;
+    precision?: import("./VireoFormTemporalField.types.js").VireoFormTemporalFieldPrecision;
+    minuteStep?: number;
+    secondStep?: number;
+} & import("./VireoFormTemporalField.types.js").VireoFormTemporalFieldInheritedProps, "ref">) & React.RefAttributes<HTMLDivElement>>;

package/dist/capabilities/forms/components/forms/VireoFormTemporalField/VireoFormTemporalField.identity.d.ts

@@ -0,0 +1,6 @@
+/** Stable component name shared by every VireoFormTemporalField integration point. */
+export declare const VIREO_FORM_TEMPORAL_FIELD_NAME = "VireoFormTemporalField";
+/** Canonical public slots exposed by VireoFormTemporalField, in rendered DOM order. */
+export declare const VIREO_FORM_TEMPORAL_FIELD_SLOTS: readonly ["root", "input", "htmlInput", "formHelperText", "openPickerButton", "openPickerIcon", "clearButton", "clearIcon"];
+/** Public slot names exposed by VireoFormTemporalField. */
+export type VireoFormTemporalFieldSlotName = (typeof VIREO_FORM_TEMPORAL_FIELD_SLOTS)[number];

package/dist/capabilities/forms/components/forms/VireoFormTemporalField/VireoFormTemporalField.identity.js

@@ -0,0 +1,13 @@
+/** Stable component name shared by every VireoFormTemporalField integration point. */
+export const VIREO_FORM_TEMPORAL_FIELD_NAME = "VireoFormTemporalField";
+/** Canonical public slots exposed by VireoFormTemporalField, in rendered DOM order. */
+export const VIREO_FORM_TEMPORAL_FIELD_SLOTS = [
+    "root",
+    "input",
+    "htmlInput",
+    "formHelperText",
+    "openPickerButton",
+    "openPickerIcon",
+    "clearButton",
+    "clearIcon",
+];