@vireocodedev/ui 0.2.0 → 0.2.1

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

@@ -0,0 +1,197 @@
+import type { VireoFormErrorDisplay, VireoFormErrorFormatter } from "../../../../../capabilities/forms/components/forms/VireoForm/VireoForm.types.js";
+import type { VireoDataAttributeValue, VireoThemeComponent } from "../../../../../core/public.js";
+import type { AutocompleteProps, Box, Button, Checkbox, Chip, CircularProgress, FormHelperText, IconButton, InputLabel, ListSubheader, Paper, Popper, TextField, TextFieldProps } from "@mui/material";
+import type { CreateSlotsAndSlotProps, SlotProps } from "@mui/material/utils";
+import type React from "react";
+import type { VireoFormFreeSoloAutocompleteMultipleFieldClasses, VireoFormFreeSoloAutocompleteMultipleFieldClassKey } from "./VireoFormFreeSoloAutocompleteMultipleField.classes.js";
+import type { VIREO_FORM_FREE_SOLO_AUTOCOMPLETE_MULTIPLE_FIELD_NAME } from "./VireoFormFreeSoloAutocompleteMultipleField.identity.js";
+export type VireoFormFreeSoloAutocompleteMultipleFieldInputChangeReason = "input" | "reset" | "clear" | "blur" | "selectOption" | "removeOption";
+export type VireoFormFreeSoloAutocompleteMultipleFieldSelection<TOption> = {
+    value: string;
+    label: string;
+    custom: boolean;
+    option: TOption | null;
+};
+export type VireoFormFreeSoloAutocompleteMultipleFieldValueChangeDetails<TOption> = {
+    reason: "selectOption";
+    option: TOption;
+    value: string;
+} | {
+    reason: "createOption";
+    value: string;
+} | {
+    reason: "removeOption";
+    option: TOption | null;
+    value: string;
+} | {
+    reason: "clear";
+    previousValues: string[];
+};
+export type VireoFormFreeSoloAutocompleteMultipleFieldRenderOptionState = {
+    inputValue: string;
+    selected: boolean;
+    disabled: boolean;
+    index: number;
+};
+export type VireoFormFreeSoloAutocompleteMultipleFieldFilterState = {
+    inputValue: string;
+};
+export type VireoFormFreeSoloAutocompleteMultipleFieldRenderSelectedOptionsParams<TOption> = {
+    selections: readonly VireoFormFreeSoloAutocompleteMultipleFieldSelection<TOption>[];
+    displayedSelections: readonly VireoFormFreeSoloAutocompleteMultipleFieldSelection<TOption>[];
+    hiddenCount: number;
+    maxDisplayedOptions: number;
+    getRemoveButtonProps: (value: string) => {
+        "aria-label": string;
+        disabled: boolean;
+        onClick: React.MouseEventHandler<HTMLButtonElement>;
+    };
+};
+export type VireoFormFreeSoloAutocompleteMultipleFieldOwnerState = {
+    dirty: boolean;
+    disabled: boolean;
+    error: boolean;
+    focused: boolean;
+    hasInputValue: boolean;
+    hasValue: boolean;
+    loading: boolean;
+    open: boolean;
+    readOnly: boolean;
+    required: boolean;
+    submitting: boolean;
+    touched: boolean;
+    validating: boolean;
+    atSelectionLimit: boolean;
+    hasHiddenOptions: boolean;
+};
+export interface VireoFormFreeSoloAutocompleteMultipleFieldSlotPropsOverrides {
+    [key: `data-${string}`]: VireoDataAttributeValue;
+}
+export type VireoFormFreeSoloAutocompleteMultipleFieldSlots = {
+    root: React.ElementType;
+    textField: React.ElementType;
+    inputLabel: React.ElementType;
+    input: React.ElementType;
+    htmlInput: React.ElementType;
+    loadingIndicator: React.ElementType;
+    clearButton: React.ElementType;
+    clearIcon: React.ElementType;
+    popupButton: React.ElementType;
+    popupIcon: React.ElementType;
+    formHelperText: React.ElementType;
+    popper: React.ElementType;
+    paper: React.ElementType;
+    loadingText: React.ElementType;
+    noOptionsText: React.ElementType;
+    listbox: React.ElementType;
+    option: React.ElementType;
+    group: React.ElementType;
+    groupLabel: React.ElementType;
+    groupList: React.ElementType;
+    selectedOptions: React.ElementType;
+    selectedOption: React.ElementType;
+    selectedOptionDeleteIcon: React.ElementType;
+    hiddenOptionsButton: React.ElementType;
+    optionCheckbox: React.ElementType;
+};
+type CommonSlotProps<T extends React.ElementType> = SlotProps<T, VireoFormFreeSoloAutocompleteMultipleFieldSlotPropsOverrides, VireoFormFreeSoloAutocompleteMultipleFieldOwnerState>;
+export type VireoFormFreeSoloAutocompleteMultipleFieldSlotsAndSlotProps = CreateSlotsAndSlotProps<VireoFormFreeSoloAutocompleteMultipleFieldSlots, {
+    root: CommonSlotProps<typeof Box>;
+    textField: CommonSlotProps<typeof TextField>;
+    inputLabel: CommonSlotProps<typeof InputLabel>;
+    input: CommonSlotProps<"div">;
+    htmlInput: CommonSlotProps<"input">;
+    loadingIndicator: CommonSlotProps<typeof CircularProgress>;
+    clearButton: CommonSlotProps<typeof IconButton>;
+    clearIcon: CommonSlotProps<"svg">;
+    popupButton: CommonSlotProps<typeof IconButton>;
+    popupIcon: CommonSlotProps<"svg">;
+    formHelperText: CommonSlotProps<typeof FormHelperText>;
+    popper: CommonSlotProps<typeof Popper>;
+    paper: CommonSlotProps<typeof Paper>;
+    loadingText: CommonSlotProps<"div">;
+    noOptionsText: CommonSlotProps<"div">;
+    listbox: CommonSlotProps<"ul">;
+    option: CommonSlotProps<"li">;
+    group: CommonSlotProps<"li">;
+    groupLabel: CommonSlotProps<typeof ListSubheader>;
+    groupList: CommonSlotProps<"ul">;
+    selectedOptions: CommonSlotProps<"div">;
+    selectedOption: CommonSlotProps<typeof Chip>;
+    selectedOptionDeleteIcon: CommonSlotProps<"svg">;
+    hiddenOptionsButton: CommonSlotProps<typeof Button>;
+    optionCheckbox: CommonSlotProps<typeof Checkbox>;
+}>;
+type OwnedAutocompleteProp = "ChipProps" | "clearIcon" | "defaultValue" | "disabled" | "disableClearable" | "filterOptions" | "freeSolo" | "getLimitTagsText" | "getOptionDisabled" | "getOptionKey" | "getOptionLabel" | "groupBy" | "inputValue" | "isOptionEqualToValue" | "limitTags" | "loading" | "loadingText" | "multiple" | "noOptionsText" | "onBlur" | "onChange" | "onClose" | "onHighlightChange" | "onInputChange" | "onOpen" | "open" | "options" | "readOnly" | "renderGroup" | "renderInput" | "renderOption" | "renderTags" | "renderValue" | "slotProps" | "slots" | "value";
+export type VireoFormFreeSoloAutocompleteMultipleFieldInheritedProps<TOption> = Omit<AutocompleteProps<TOption, true, false, true>, OwnedAutocompleteProp>;
+type FilterContract<TOption> = {
+    filterMode?: "client";
+    filterOptions?: (options: readonly TOption[], state: VireoFormFreeSoloAutocompleteMultipleFieldFilterState) => readonly TOption[];
+} | {
+    filterMode: "server";
+    filterOptions?: never;
+};
+export type VireoFormFreeSoloAutocompleteMultipleFieldOwnProps<TOption> = VireoFormFreeSoloAutocompleteMultipleFieldSlotsAndSlotProps & FilterContract<TOption> & {
+    label: React.ReactNode;
+    options: readonly TOption[];
+    getOptionValue: (option: TOption) => string;
+    getOptionLabel: (option: TOption) => string;
+    getOptionDisabled?: (option: TOption) => boolean;
+    renderOption?: (option: TOption, state: VireoFormFreeSoloAutocompleteMultipleFieldRenderOptionState) => React.ReactNode;
+    createOptionLabel?: (value: string) => React.ReactNode;
+    normalizeValue?: (value: string) => string;
+    isValueEqual?: (left: string, right: string) => boolean;
+    commitOnBlur?: boolean;
+    groupBy?: (option: TOption) => string;
+    renderGroupLabel?: (group: string) => React.ReactNode;
+    renderSelectedOptions?: (params: VireoFormFreeSoloAutocompleteMultipleFieldRenderSelectedOptionsParams<TOption>) => React.ReactNode;
+    maxDisplayedOptions?: number;
+    maxSelectedOptions?: number;
+    getHiddenOptionsText?: (count: number) => React.ReactNode;
+    getHiddenOptionsLabel?: (count: number) => string;
+    getRemoveOptionLabel?: (selection: VireoFormFreeSoloAutocompleteMultipleFieldSelection<TOption>) => string;
+    hideOptionCheckbox?: boolean;
+    removeOnBackspace?: boolean;
+    classes?: Partial<VireoFormFreeSoloAutocompleteMultipleFieldClasses>;
+    disabled?: boolean;
+    readOnly?: boolean;
+    required?: boolean;
+    error?: boolean;
+    errorDisplay?: VireoFormErrorDisplay;
+    formatError?: VireoFormErrorFormatter;
+    /** Defaults to a reserved line; pass `null` to remove it. @default ' ' */
+    helperText?: React.ReactNode;
+    fullWidth?: boolean;
+    placeholder?: string;
+    variant?: TextFieldProps["variant"];
+    size?: TextFieldProps["size"];
+    color?: TextFieldProps["color"];
+    margin?: TextFieldProps["margin"];
+    inputRef?: React.Ref<HTMLInputElement>;
+    inputValue?: string;
+    defaultInputValue?: string;
+    onBlur?: React.FocusEventHandler<HTMLInputElement>;
+    onInputValueChange?: (value: string, reason: VireoFormFreeSoloAutocompleteMultipleFieldInputChangeReason) => void;
+    onValueChange?: (value: string[], details: VireoFormFreeSoloAutocompleteMultipleFieldValueChangeDetails<TOption>) => void;
+    loading?: boolean;
+    loadingText?: React.ReactNode;
+    noOptionsText?: React.ReactNode;
+    disableClearable?: boolean;
+    clearOnEscape?: boolean;
+    clearLabel?: string;
+    openLabel?: string;
+    closeLabel?: string;
+    open?: boolean;
+    defaultOpen?: boolean;
+    onOpen?: () => void;
+    onClose?: NonNullable<AutocompleteProps<TOption, true, false, true>["onClose"]>;
+    clearIcon?: React.ReactNode;
+    popupIcon?: React.ReactNode;
+};
+export type VireoFormFreeSoloAutocompleteMultipleFieldProps<TOption = string> = VireoFormFreeSoloAutocompleteMultipleFieldOwnProps<TOption> & VireoFormFreeSoloAutocompleteMultipleFieldInheritedProps<TOption>;
+declare module "@mui/material/styles" {
+    interface Components<Theme = unknown> {
+        [VIREO_FORM_FREE_SOLO_AUTOCOMPLETE_MULTIPLE_FIELD_NAME]?: VireoThemeComponent<VireoFormFreeSoloAutocompleteMultipleFieldProps, VireoFormFreeSoloAutocompleteMultipleFieldClassKey, VireoFormFreeSoloAutocompleteMultipleFieldOwnerState, Theme>;
+    }
+}
+export {};

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

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

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

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

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

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

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

@@ -0,0 +1,9 @@
+import { type VireoFormMultiStepSlotName } from "./VireoFormMultiStep.identity.js";
+/** Utility classes available to VireoFormMultiStep. */
+export type VireoFormMultiStepClasses = Record<VireoFormMultiStepSlotName, string>;
+/** Valid keys for VireoFormMultiStep utility classes and theme style overrides. */
+export type VireoFormMultiStepClassKey = keyof VireoFormMultiStepClasses;
+/** Returns the generated utility class name for a VireoFormMultiStep slot or state. */
+export declare function getVireoFormMultiStepUtilityClass(slot: string): string;
+/** Generated utility class names keyed by each public VireoFormMultiStep class key. */
+export declare const vireoFormMultiStepClasses: VireoFormMultiStepClasses;

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

@@ -0,0 +1,10 @@
+import { generateUtilityClass, generateUtilityClasses } from "@mui/material";
+import { VIREO_FORM_MULTI_STEP_NAME, VIREO_FORM_MULTI_STEP_SLOTS, } from "./VireoFormMultiStep.identity.js";
+/** Returns the generated utility class name for a VireoFormMultiStep slot or state. */
+export function getVireoFormMultiStepUtilityClass(slot) {
+    return generateUtilityClass(VIREO_FORM_MULTI_STEP_NAME, slot);
+}
+/** Generated utility class names keyed by each public VireoFormMultiStep class key. */
+export const vireoFormMultiStepClasses = generateUtilityClasses(VIREO_FORM_MULTI_STEP_NAME, [
+    ...VIREO_FORM_MULTI_STEP_SLOTS,
+]);

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

@@ -0,0 +1,4 @@
+import React from "react";
+import { type VireoFormMultiStepProps } from "./VireoFormMultiStep.types.js";
+/** Provides the rendering, locale, registration, and focus boundary for a bound Vireo multi-step form. */
+export declare const VireoFormMultiStep: React.ForwardRefExoticComponent<Omit<VireoFormMultiStepProps, "ref"> & React.RefAttributes<HTMLDivElement>>;

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

@@ -0,0 +1,6 @@
+/** Stable component name shared by every VireoFormMultiStep integration point. */
+export declare const VIREO_FORM_MULTI_STEP_NAME = "VireoFormMultiStep";
+/** Canonical public slots exposed by VireoFormMultiStep, in rendered DOM order. */
+export declare const VIREO_FORM_MULTI_STEP_SLOTS: readonly ["root"];
+/** Public slot names exposed by VireoFormMultiStep. */
+export type VireoFormMultiStepSlotName = (typeof VIREO_FORM_MULTI_STEP_SLOTS)[number];

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

@@ -0,0 +1,4 @@
+/** Stable component name shared by every VireoFormMultiStep integration point. */
+export const VIREO_FORM_MULTI_STEP_NAME = "VireoFormMultiStep";
+/** Canonical public slots exposed by VireoFormMultiStep, in rendered DOM order. */
+export const VIREO_FORM_MULTI_STEP_SLOTS = ["root"];

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

@@ -0,0 +1,29 @@
+import { jsx as _jsx } from "react/jsx-runtime";
+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 React from "react";
+import { VireoMultiStepContext } from "../../../../../capabilities/forms/contexts/VireoMultiStepContext/VireoMultiStepContext.js";
+import { defaultVireoFormMultiStepLocaleText } from "../../../../../capabilities/forms/types/vireoMultiStep.types.js";
+import { getVireoFormMultiStepUtilityClass } from "./VireoFormMultiStep.classes.js";
+import { VIREO_FORM_MULTI_STEP_NAME } from "./VireoFormMultiStep.identity.js";
+import { VireoFormMultiStepRoot } from "./VireoFormMultiStep.styled.js";
+function useUtilityClasses(_ownerState, classes) {
+    return composeClasses({
+        root: ["root"],
+    }, getVireoFormMultiStepUtilityClass, classes);
+}
+/** Provides the rendering, locale, registration, and focus boundary for a bound Vireo multi-step form. */
+export const VireoFormMultiStep = React.forwardRef(function VireoFormMultiStep(inProps, forwardedRef) {
+    const props = useThemeProps({ props: inProps, name: VIREO_FORM_MULTI_STEP_NAME });
+    const { children, className, classes: classesProp, controller, keepMounted = false, localeText, slotProps = {}, slots = {}, style, sx, ...other } = props;
+    const ownerState = { keepMounted };
+    const classes = useUtilityClasses(ownerState, classesProp);
+    const resolvedRootSlotProps = resolveSlotProps(slotProps.root, ownerState);
+    const { className: rootSlotClassName, ref: rootSlotRef, style: rootSlotStyle, sx: rootSlotSx, ...rootSlotOther } = resolvedRootSlotProps;
+    const rootRef = useForkRef(forwardedRef, rootSlotRef);
+    const resolvedLocaleText = React.useMemo(() => ({ ...defaultVireoFormMultiStepLocaleText, ...localeText }), [localeText]);
+    return (_jsx(VireoMultiStepContext.Provider, { value: { controller, keepMounted, localeText: resolvedLocaleText }, children: _jsx(VireoFormMultiStepRoot, { ...other, ...rootSlotOther, as: slots.root ?? "div", ref: rootRef, ownerState: ownerState, className: joinClassNames(classes.root, className, rootSlotClassName), style: { ...style, ...rootSlotStyle }, sx: mergeSx(sx, rootSlotSx), children: children }) }));
+});
+VireoFormMultiStep.displayName = VIREO_FORM_MULTI_STEP_NAME;

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

@@ -0,0 +1,6 @@
+import { type StyledSlotComponent } from "../../../../../core/public.js";
+import { type BoxProps } from "@mui/material";
+import { type VireoFormMultiStepOwnerState } from "./VireoFormMultiStep.types.js";
+type VireoFormMultiStepStyledSlotComponent<TProps extends object> = StyledSlotComponent<TProps, VireoFormMultiStepOwnerState>;
+export declare const VireoFormMultiStepRoot: VireoFormMultiStepStyledSlotComponent<BoxProps>;
+export {};

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

@@ -0,0 +1,15 @@
+import { Box } from "@mui/material";
+import { styled } from "@mui/material/styles";
+import { VIREO_FORM_MULTI_STEP_NAME } from "./VireoFormMultiStep.identity.js";
+export const VireoFormMultiStepRoot = styled(Box, {
+    name: VIREO_FORM_MULTI_STEP_NAME,
+    slot: "Root",
+    overridesResolver: (_props, styles) => styles.root,
+})({
+    display: "flex",
+    flexDirection: "column",
+    gap: 24,
+    minWidth: 0,
+    width: "100%",
+    containerType: "inline-size",
+});

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

@@ -0,0 +1,41 @@
+import type { VireoDataAttributeValue, VireoThemeComponent } from "../../../../../core/public.js";
+import type { BoxProps } from "@mui/material";
+import type { CreateSlotsAndSlotProps, SlotProps } from "@mui/material/utils";
+import type React from "react";
+import type { VireoFormMultiStepLocaleText } from "../../../../../capabilities/forms/types/vireoMultiStep.types.js";
+import { type VireoFormMultiStepClasses, type VireoFormMultiStepClassKey } from "./VireoFormMultiStep.classes.js";
+import type { VIREO_FORM_MULTI_STEP_NAME, VireoFormMultiStepSlotName } from "./VireoFormMultiStep.identity.js";
+export type VireoFormMultiStepOwnerState = {
+    keepMounted: boolean;
+};
+export interface VireoFormMultiStepRootSlotPropsOverrides {
+    [key: `data-${string}`]: VireoDataAttributeValue;
+}
+/** Replaceable semantic regions exposed by {@link VireoFormMultiStep}. */
+export type VireoFormMultiStepSlots = {
+    [TSlotName in VireoFormMultiStepSlotName]: React.ElementType;
+};
+/** Slot props exposed by {@link VireoFormMultiStep}. */
+export type VireoFormMultiStepSlotsAndSlotProps = CreateSlotsAndSlotProps<VireoFormMultiStepSlots, {
+    /** @default 'div' */
+    root: SlotProps<"div", VireoFormMultiStepRootSlotPropsOverrides, VireoFormMultiStepOwnerState>;
+}>;
+/** Props owned by {@link VireoFormMultiStep}. */
+export type VireoFormMultiStepOwnProps = VireoFormMultiStepSlotsAndSlotProps & {
+    children?: React.ReactNode;
+    /** Override or extend the utility classes applied to each slot. */
+    classes?: Partial<VireoFormMultiStepClasses>;
+    /** Keeps applicable inactive steps mounted with the native hidden attribute. @default false */
+    keepMounted?: boolean;
+    /** Overrides built-in English progress and navigation copy for this multi-step boundary. */
+    localeText?: Partial<VireoFormMultiStepLocaleText>;
+};
+/** Props VireoFormMultiStep inherits from its default root after excluding component-owned props. */
+export type VireoFormMultiStepInheritedProps = Omit<BoxProps<"div">, "children" | "component">;
+/** Props accepted by {@link VireoFormMultiStep}. */
+export type VireoFormMultiStepProps = VireoFormMultiStepOwnProps & VireoFormMultiStepInheritedProps;
+declare module "@mui/material/styles" {
+    interface Components<Theme = unknown> {
+        [VIREO_FORM_MULTI_STEP_NAME]?: VireoThemeComponent<VireoFormMultiStepProps, VireoFormMultiStepClassKey, VireoFormMultiStepOwnerState, Theme>;
+    }
+}

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

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

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

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

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

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

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

@@ -0,0 +1,9 @@
+import { type VireoFormNextStepButtonSlotName, type VireoFormNextStepButtonStateName } from "./VireoFormNextStepButton.identity.js";
+/** Utility classes available to VireoFormNextStepButton. */
+export type VireoFormNextStepButtonClasses = Record<VireoFormNextStepButtonSlotName | VireoFormNextStepButtonStateName, string>;
+/** Valid keys for VireoFormNextStepButton utility classes and theme style overrides. */
+export type VireoFormNextStepButtonClassKey = keyof VireoFormNextStepButtonClasses;
+/** Returns the generated utility class name for a VireoFormNextStepButton slot or state. */
+export declare function getVireoFormNextStepButtonUtilityClass(slot: string): string;
+/** Generated utility class names keyed by each public VireoFormNextStepButton class key. */
+export declare const vireoFormNextStepButtonClasses: VireoFormNextStepButtonClasses;

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

@@ -0,0 +1,8 @@
+import { generateUtilityClass, generateUtilityClasses } from "@mui/material";
+import { VIREO_FORM_NEXT_STEP_BUTTON_NAME, VIREO_FORM_NEXT_STEP_BUTTON_SLOTS, VIREO_FORM_NEXT_STEP_BUTTON_STATES, } from "./VireoFormNextStepButton.identity.js";
+/** Returns the generated utility class name for a VireoFormNextStepButton slot or state. */
+export function getVireoFormNextStepButtonUtilityClass(slot) {
+    return generateUtilityClass(VIREO_FORM_NEXT_STEP_BUTTON_NAME, slot);
+}
+/** Generated utility class names keyed by each public VireoFormNextStepButton class key. */
+export const vireoFormNextStepButtonClasses = generateUtilityClasses(VIREO_FORM_NEXT_STEP_BUTTON_NAME, [...VIREO_FORM_NEXT_STEP_BUTTON_SLOTS, ...VIREO_FORM_NEXT_STEP_BUTTON_STATES]);

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

@@ -0,0 +1,4 @@
+import React from "react";
+import type { VireoFormNextStepButtonProps } from "./VireoFormNextStepButton.types.js";
+/** Validates and advances the current step, then yields to the final submit action. */
+export declare const VireoFormNextStepButton: React.ForwardRefExoticComponent<Omit<VireoFormNextStepButtonProps, "ref"> & React.RefAttributes<HTMLButtonElement>>;

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

@@ -0,0 +1,8 @@
+/** Stable component name shared by every VireoFormNextStepButton integration point. */
+export declare const VIREO_FORM_NEXT_STEP_BUTTON_NAME = "VireoFormNextStepButton";
+/** Canonical public slots exposed by VireoFormNextStepButton, in rendered DOM order. */
+export declare const VIREO_FORM_NEXT_STEP_BUTTON_SLOTS: readonly ["root", "loadingIndicator"];
+/** Public slot names exposed by VireoFormNextStepButton. */
+export type VireoFormNextStepButtonSlotName = (typeof VIREO_FORM_NEXT_STEP_BUTTON_SLOTS)[number];
+export declare const VIREO_FORM_NEXT_STEP_BUTTON_STATES: readonly ["disabled", "loading", "lastStep"];
+export type VireoFormNextStepButtonStateName = (typeof VIREO_FORM_NEXT_STEP_BUTTON_STATES)[number];

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

@@ -0,0 +1,5 @@
+/** Stable component name shared by every VireoFormNextStepButton integration point. */
+export const VIREO_FORM_NEXT_STEP_BUTTON_NAME = "VireoFormNextStepButton";
+/** Canonical public slots exposed by VireoFormNextStepButton, in rendered DOM order. */
+export const VIREO_FORM_NEXT_STEP_BUTTON_SLOTS = ["root", "loadingIndicator"];
+export const VIREO_FORM_NEXT_STEP_BUTTON_STATES = ["disabled", "loading", "lastStep"];

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

@@ -0,0 +1,50 @@
+import { jsx as _jsx } from "react/jsx-runtime";
+import { useVireoMultiStepContext } from "../../../../../capabilities/forms/contexts/VireoMultiStepContext/VireoMultiStepContext.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 React from "react";
+import { getVireoFormNextStepButtonUtilityClass, } from "./VireoFormNextStepButton.classes.js";
+import { VIREO_FORM_NEXT_STEP_BUTTON_NAME, } from "./VireoFormNextStepButton.identity.js";
+import { VireoFormNextStepButtonLoadingIndicator, VireoFormNextStepButtonRoot } from "./VireoFormNextStepButton.styled.js";
+function useUtilityClasses(ownerState, classes) {
+    return composeClasses({
+        root: [
+            "root",
+            ownerState.disabled && "disabled",
+            ownerState.loading && "loading",
+            ownerState.lastStep && "lastStep",
+        ],
+        loadingIndicator: ["loadingIndicator"],
+    }, getVireoFormNextStepButtonUtilityClass, classes);
+}
+/** Validates and advances the current step, then yields to the final submit action. */
+export const VireoFormNextStepButton = React.forwardRef(function VireoFormNextStepButton(inProps, forwardedRef) {
+    const props = useThemeProps({ props: inProps, name: VIREO_FORM_NEXT_STEP_BUTTON_NAME });
+    const { children, className, classes: classesProp, disabled = false, loading = false, slotProps = {}, slots = {}, style, sx, variant = "contained", visibility = "auto", ...other } = props;
+    const { controller, localeText } = useVireoMultiStepContext();
+    const state = React.useSyncExternalStore(controller.subscribe, controller.getSnapshot, controller.getSnapshot);
+    const ownerState = {
+        disabled: disabled || state.isStepTransitioning || (state.isLastStep && visibility === "always"),
+        lastStep: state.isLastStep,
+        loading: loading === true || state.isStepTransitioning,
+        visibility,
+    };
+    const classes = useUtilityClasses(ownerState, classesProp);
+    const resolvedRootSlotProps = resolveSlotProps(slotProps.root, ownerState);
+    const resolvedLoadingSlotProps = resolveSlotProps(slotProps.loadingIndicator, ownerState);
+    const { className: rootSlotClassName, component: _component, disabled: _disabled, href: _href, loading: _loading, loadingIndicator: _indicator, ref: rootSlotRef, style: rootSlotStyle, sx: rootSlotSx, ...rootSlotOther } = resolvedRootSlotProps;
+    const { className: loadingClassName, ...loadingOther } = resolvedLoadingSlotProps;
+    void _component;
+    void _disabled;
+    void _href;
+    void _loading;
+    void _indicator;
+    const rootRef = useForkRef(forwardedRef, rootSlotRef);
+    const LoadingIndicator = slots.loadingIndicator ?? VireoFormNextStepButtonLoadingIndicator;
+    if (state.isLastStep && visibility === "auto")
+        return null;
+    return (_jsx(VireoFormNextStepButtonRoot, { ...other, ...rootSlotOther, as: slots.root, ref: rootRef, ownerState: ownerState, "aria-busy": ownerState.loading || undefined, className: joinClassNames(classes.root, className, rootSlotClassName), disabled: ownerState.disabled, loading: ownerState.loading, loadingIndicator: _jsx(LoadingIndicator, { ...loadingOther, ownerState: ownerState, size: 16, className: joinClassNames(classes.loadingIndicator, loadingClassName) }), style: { ...style, ...rootSlotStyle }, sx: mergeSx(sx, rootSlotSx), type: "submit", variant: variant, children: children ?? localeText.nextButton }));
+});
+VireoFormNextStepButton.displayName = VIREO_FORM_NEXT_STEP_BUTTON_NAME;

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

@@ -0,0 +1,7 @@
+import { type StyledSlotComponent } from "../../../../../core/public.js";
+import { type ButtonProps, type CircularProgressProps } from "@mui/material";
+import { type VireoFormNextStepButtonOwnerState } from "./VireoFormNextStepButton.types.js";
+type VireoFormNextStepButtonStyledSlotComponent<TProps extends object> = StyledSlotComponent<TProps, VireoFormNextStepButtonOwnerState>;
+export declare const VireoFormNextStepButtonRoot: VireoFormNextStepButtonStyledSlotComponent<ButtonProps>;
+export declare const VireoFormNextStepButtonLoadingIndicator: VireoFormNextStepButtonStyledSlotComponent<CircularProgressProps>;
+export {};

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

@@ -0,0 +1,18 @@
+import { Button, CircularProgress } from "@mui/material";
+import { styled } from "@mui/material/styles";
+import { VIREO_FORM_NEXT_STEP_BUTTON_NAME } from "./VireoFormNextStepButton.identity.js";
+export const VireoFormNextStepButtonRoot = styled(Button, {
+    name: VIREO_FORM_NEXT_STEP_BUTTON_NAME,
+    slot: "Root",
+    overridesResolver: ({ ownerState }, styles) => [
+        styles.root,
+        ownerState.disabled && styles.disabled,
+        ownerState.loading && styles.loading,
+        ownerState.lastStep && styles.lastStep,
+    ],
+})({});
+export const VireoFormNextStepButtonLoadingIndicator = styled(CircularProgress, {
+    name: VIREO_FORM_NEXT_STEP_BUTTON_NAME,
+    slot: "LoadingIndicator",
+    overridesResolver: (_props, styles) => styles.loadingIndicator,
+})({ color: "inherit" });

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

@@ -0,0 +1,42 @@
+import type { VireoDataAttributeValue, VireoThemeComponent } from "../../../../../core/public.js";
+import type { Button, ButtonProps, CircularProgress } from "@mui/material";
+import type { CreateSlotsAndSlotProps, SlotProps } from "@mui/material/utils";
+import type React from "react";
+import type { VireoFormNextStepButtonClasses, VireoFormNextStepButtonClassKey } from "./VireoFormNextStepButton.classes.js";
+import type { VIREO_FORM_NEXT_STEP_BUTTON_NAME, VireoFormNextStepButtonSlotName } from "./VireoFormNextStepButton.identity.js";
+export type VireoFormNextStepButtonOwnerState = {
+    disabled: boolean;
+    lastStep: boolean;
+    loading: boolean;
+    visibility: "auto" | "always";
+};
+export interface VireoFormNextStepButtonRootSlotPropsOverrides {
+    [key: `data-${string}`]: VireoDataAttributeValue;
+}
+export interface VireoFormNextStepButtonLoadingIndicatorSlotPropsOverrides {
+    [key: `data-${string}`]: VireoDataAttributeValue;
+}
+export type VireoFormNextStepButtonSlots = {
+    [T in VireoFormNextStepButtonSlotName]: React.ElementType;
+};
+export type VireoFormNextStepButtonSlotsAndSlotProps = CreateSlotsAndSlotProps<VireoFormNextStepButtonSlots, {
+    /** @default Button */
+    root: SlotProps<typeof Button, VireoFormNextStepButtonRootSlotPropsOverrides, VireoFormNextStepButtonOwnerState>;
+    /** @default CircularProgress */
+    loadingIndicator: SlotProps<typeof CircularProgress, VireoFormNextStepButtonLoadingIndicatorSlotPropsOverrides, VireoFormNextStepButtonOwnerState>;
+}>;
+export type VireoFormNextStepButtonOwnProps = VireoFormNextStepButtonSlotsAndSlotProps & {
+    children?: React.ReactNode;
+    classes?: Partial<VireoFormNextStepButtonClasses>;
+    /** Adds a consumer-owned loading condition to step validation. @default false */
+    loading?: boolean | null;
+    /** Hides the next action on the final step or leaves it disabled. @default 'auto' */
+    visibility?: "auto" | "always";
+};
+export type VireoFormNextStepButtonInheritedProps = Omit<ButtonProps, "component" | "href" | "loading" | "loadingIndicator" | "type">;
+export type VireoFormNextStepButtonProps = VireoFormNextStepButtonOwnProps & VireoFormNextStepButtonInheritedProps;
+declare module "@mui/material/styles" {
+    interface Components<Theme = unknown> {
+        [VIREO_FORM_NEXT_STEP_BUTTON_NAME]?: VireoThemeComponent<VireoFormNextStepButtonProps, VireoFormNextStepButtonClassKey, VireoFormNextStepButtonOwnerState, Theme>;
+    }
+}

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

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

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

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

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

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

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

@@ -0,0 +1,9 @@
+import { type VireoFormNumberFieldSlotName, type VireoFormNumberFieldStateName } from "./VireoFormNumberField.identity.js";
+/** Utility classes available to VireoFormNumberField. */
+export type VireoFormNumberFieldClasses = Record<VireoFormNumberFieldSlotName | VireoFormNumberFieldStateName, string>;
+/** Valid keys for VireoFormNumberField utility classes and theme style overrides. */
+export type VireoFormNumberFieldClassKey = keyof VireoFormNumberFieldClasses;
+/** Returns the generated utility class name for a VireoFormNumberField slot or state. */
+export declare function getVireoFormNumberFieldUtilityClass(slot: string): string;
+/** Generated utility class names keyed by each public VireoFormNumberField class key. */
+export declare const vireoFormNumberFieldClasses: VireoFormNumberFieldClasses;

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

@@ -0,0 +1,8 @@
+import { generateUtilityClass, generateUtilityClasses } from "@mui/material";
+import { VIREO_FORM_NUMBER_FIELD_NAME, VIREO_FORM_NUMBER_FIELD_SLOTS, VIREO_FORM_NUMBER_FIELD_STATES, } from "./VireoFormNumberField.identity.js";
+/** Returns the generated utility class name for a VireoFormNumberField slot or state. */
+export function getVireoFormNumberFieldUtilityClass(slot) {
+    return generateUtilityClass(VIREO_FORM_NUMBER_FIELD_NAME, slot);
+}
+/** Generated utility class names keyed by each public VireoFormNumberField class key. */
+export const vireoFormNumberFieldClasses = generateUtilityClasses(VIREO_FORM_NUMBER_FIELD_NAME, [...VIREO_FORM_NUMBER_FIELD_SLOTS, ...VIREO_FORM_NUMBER_FIELD_STATES]);

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

@@ -0,0 +1,8 @@
+import React from "react";
+import { type VireoFormNumberFieldProps } from "./VireoFormNumberField.types.js";
+/**
+ * Binds MUI TextField anatomy to a `number | null` form value while preserving incomplete numeric editing text.
+ *
+ * Consumers render it as `field.NumberField`; the raw runtime remains internal to the forms capability.
+ */
+export declare const VireoFormNumberField: React.ForwardRefExoticComponent<Omit<VireoFormNumberFieldProps, "ref"> & React.RefAttributes<HTMLDivElement>>;

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

@@ -0,0 +1,10 @@
+/** Stable component name shared by every VireoFormNumberField integration point. */
+export declare const VIREO_FORM_NUMBER_FIELD_NAME = "VireoFormNumberField";
+/** Canonical public slots exposed by VireoFormNumberField, in rendered DOM order. */
+export declare const VIREO_FORM_NUMBER_FIELD_SLOTS: readonly ["root", "inputLabel", "input", "htmlInput", "formHelperText"];
+/** Canonical interaction and validation states exposed as utility classes. */
+export declare const VIREO_FORM_NUMBER_FIELD_STATES: readonly ["dirty", "touched", "invalid", "errorVisible", "validating", "submitting", "disabled", "readOnly"];
+/** Public slot names exposed by VireoFormNumberField. */
+export type VireoFormNumberFieldSlotName = (typeof VIREO_FORM_NUMBER_FIELD_SLOTS)[number];
+/** Public state names exposed by VireoFormNumberField. */
+export type VireoFormNumberFieldStateName = (typeof VIREO_FORM_NUMBER_FIELD_STATES)[number];

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

@@ -0,0 +1,21 @@
+/** Stable component name shared by every VireoFormNumberField integration point. */
+export const VIREO_FORM_NUMBER_FIELD_NAME = "VireoFormNumberField";
+/** Canonical public slots exposed by VireoFormNumberField, in rendered DOM order. */
+export const VIREO_FORM_NUMBER_FIELD_SLOTS = [
+    "root",
+    "inputLabel",
+    "input",
+    "htmlInput",
+    "formHelperText",
+];
+/** Canonical interaction and validation states exposed as utility classes. */
+export const VIREO_FORM_NUMBER_FIELD_STATES = [
+    "dirty",
+    "touched",
+    "invalid",
+    "errorVisible",
+    "validating",
+    "submitting",
+    "disabled",
+    "readOnly",
+];