@ostack.tech/ui 0.1.0

package/dist/types/components/Root/Root.d.ts

@@ -0,0 +1,121 @@
+import * as React from "react";
+import { type LocalizationObject } from "../../locale";
+import { DocumentTitleProvider } from "../../providers/DocumentTitleProvider";
+import { ErrorReportingProvider } from "../../providers/ErrorReportingProvider";
+import { ErrorBoundary } from "../ErrorBoundary";
+import { type ToastSwipeDirection } from "../Toast";
+/** Properties of the ostack/UI root component. */
+export interface RootProps extends React.ComponentPropsWithoutRef<"div">, Pick<React.ComponentPropsWithoutRef<typeof ErrorReportingProvider>, "reportError" | "errorReportingUrl" | "errorReportingMethod" | "encodeErrorReport" | "encodedErrorReportMimeType" | "errorReportingOptions">, Pick<React.ComponentPropsWithoutRef<typeof DocumentTitleProvider>, "baseDocumentTitle"> {
+    /**
+     * Change the component to the HTML tag or custom component of the only child.
+     * This will merge the original component props with the props of the supplied
+     * element/component and change the underlying DOM node.
+     */
+    asChild?: boolean;
+    /**
+     * Custom prefix used to prefix all component classes, styles, _etc._
+     *
+     * This prefix should match the `$prefix` SCSS variable.
+     */
+    prefix?: string;
+    /**
+     * Whether error reporting should be enabled. By default, error reporting is
+     * enabled in production.
+     */
+    enableErrorReporting?: boolean;
+    /**
+     * Locale to use for the components.
+     *
+     * @default defaultLocale
+     */
+    locale?: LocalizationObject;
+    /**
+     * String which separates the breadcrumbs from the base document title.
+     *
+     * @default " | "
+     */
+    documentTitleBaseSeparator?: string;
+    /**
+     * String which separates the breadcrumbs of the document title.
+     *
+     * @default " ‹ "
+     */
+    documentTitleBreadcrumbsSeparator?: string;
+    /**
+     * Default container used by ostack/UI portals.
+     *
+     * @default document.body
+     */
+    portalsContainer?: Element | DocumentFragment | null;
+    /**
+     * The duration from when the pointer enters the trigger until the tooltip
+     * gets opened.
+     *
+     * @defaultValue 700
+     */
+    tooltipsDelayDuration?: number;
+    /**
+     * How much time a user has to enter another trigger without incurring a delay
+     * again.
+     *
+     * @defaultValue 300
+     */
+    tooltipsSkipDelayDuration?: number;
+    /**
+     * When set, trying to hover the content will result in the tooltip closing as
+     * the pointer leaves the trigger.
+     *
+     * @defaultValue false
+     */
+    disableTooltipsHoverableContent?: boolean;
+    /**
+     * A label for each toast. Used to help screen-reader users associate the
+     * interruption with a toast. By default, a translated version of the word
+     * “Notification” is used.
+     */
+    toastsLabel?: string;
+    /**
+     * Time in milliseconds that each toast should remain visible for.
+     *
+     * @defaultValue 5000
+     */
+    toastsDuration?: number;
+    /**
+     * Direction of pointer swipe that should close the toast.
+     *
+     * @defaultValue "right"
+     */
+    toastsSwipeDirection?: ToastSwipeDirection;
+    /**
+     * Distance in pixels that the swipe must pass before a close is triggered.
+     *
+     * @defaultValue 50
+     */
+    toastsSwipeThreshold?: number;
+    /**
+     * The keys to use as the keyboard shortcut that will move focus to the toast
+     * viewport.
+     *
+     * @defaultValue ["F8"]
+     */
+    toastViewportHotkey?: string[];
+    /**
+     * A label for the toast viewport to provide context for screen reader users
+     * when navigating page landmarks. The available `{hotkey}` placeholder will
+     * be automatically replaced. By default, a translated version of
+     * “Notifications ({hotkey})” is used.
+     */
+    toastViewportLabel?: string;
+    /** Properties to pass to the `ToastViewport` component. */
+    toastViewportProps?: React.ComponentPropsWithRef<"ol">;
+    /** Properties to pass to the `ErrorBoundary` component. */
+    errorBoundaryProps?: React.ComponentPropsWithRef<typeof ErrorBoundary>;
+}
+/**
+ * Root component that should wrap an ostack/UI application, exposing all
+ * ostack/UI providers and base styles.
+ *
+ * It further wraps the whole application in an error boundary with support for
+ * error reporting.
+ */
+export declare const Root: React.ForwardRefExoticComponent<RootProps & React.RefAttributes<HTMLDivElement>>;

package/dist/types/components/Root/RootContext.d.ts

@@ -0,0 +1,8 @@
+import * as React from "react";
+/** Root context. */
+export declare const RootContext: React.Context<boolean>;
+/**
+ * Hook exposing whether a component is being rendered within the `Root`
+ * component.
+ */
+export declare function useIsInRoot(): boolean;

package/dist/types/components/Root/index.d.ts

@@ -0,0 +1,2 @@
+export * from "./Root.tsx";
+export * from "./RootContext.ts";

package/dist/types/components/Select/Option.d.ts

@@ -0,0 +1,13 @@
+import * as React from "react";
+import { CommandMenuItem } from "../CommandMenu";
+/** Properties of the option component. */
+export interface OptionProps extends Omit<React.ComponentPropsWithoutRef<typeof CommandMenuItem>, "value" | "asLink" | "onSelect" | "selected" | "icon" | "target" | "href"> {
+    /**
+     * A unique value for this item. If no value is provided, it will be inferred
+     * from `children` or the rendered `textContent`. If your `textContent`
+     * changes between renders, you must provide a stable, unique `value`.
+     */
+    value?: string | number;
+}
+/** An option which can be selected in a `Select`. */
+export declare const Option: React.NamedExoticComponent<OptionProps & React.RefAttributes<HTMLDivElement>>;

package/dist/types/components/Select/OptionsGroup.d.ts

@@ -0,0 +1,7 @@
+import * as React from "react";
+import { CommandMenuGroup } from "../CommandMenu";
+/** Properties of the options group component. */
+export interface OptionsGroupProps extends React.ComponentPropsWithoutRef<typeof CommandMenuGroup> {
+}
+/** Component used to group options within a `Select`. */
+export declare const OptionsGroup: React.ForwardRefExoticComponent<OptionsGroupProps & React.RefAttributes<HTMLDivElement>>;

package/dist/types/components/Select/Select.d.ts

@@ -0,0 +1,117 @@
+import * as React from "react";
+import { CommandMenu } from "../CommandMenu";
+import { type IconButton } from "../IconButton";
+import { type Input } from "../Input";
+import { PopoverContent, PopoverTrigger } from "../Popover";
+import { type Tag } from "../Tag";
+/** Base properties of the select component. */
+export interface SelectPropsBase<T extends string | number | readonly string[] = string | number | readonly string[]> extends React.ComponentPropsWithoutRef<typeof PopoverTrigger>, Pick<React.ComponentPropsWithoutRef<typeof Input>, "name" | "required" | "variant" | "status" | "code" | "readOnly" | "loading" | "align" | "startAdornment" | "endAdornment" | "showClearButton" | "onBlurToOutside" | "rootProps" | "codeProps" | "containerProps" | "clearButtonProps" | "spinnerProps">, Pick<React.ComponentPropsWithoutRef<typeof CommandMenu>, "searchPlaceholder" | "searchValue" | "onSearchValueChange"> {
+    /**
+     * Whether multiple options can be selected. If not set, at most one option
+     * can be selected at a time.
+     *
+     * @default false
+     */
+    multiple?: boolean;
+    /** Default select value. */
+    defaultValue?: T;
+    /** Select value. */
+    value?: T;
+    /**
+     * Function called whenever the value of the select changes.
+     *
+     * @param value Select value. An array of values when `multiple` is set.
+     */
+    onValueChange?: (value: Exclude<T, number>) => void;
+    /**
+     * Default (uncontrolled) open state of the popover.
+     *
+     * @default false
+     */
+    defaultOpen?: boolean;
+    /**
+     * Controlled open state of the popover. Should be used together with
+     * `onOpenChange`.
+     */
+    open?: boolean;
+    /** Function called whenever the menu's open state changes. */
+    onOpenChange?: (open: boolean) => void;
+    /** Select's placeholder. */
+    placeholder?: React.ReactNode;
+    /** Accessible label for the list of options. Not shown visibly. */
+    optionsLabel?: string;
+    /**
+     * Whether the options are loading.
+     *
+     * @default false
+     */
+    loadingOptions?: boolean;
+    /** Accessible label for the loading of options. Not shown visibly. */
+    loadingOptionsLabel?: string;
+    /** Estimated progress of loading the list of options. */
+    loadingOptionsProgress?: number;
+    /** Message to display when no options were found. */
+    emptyMessage?: React.ReactNode;
+    /**
+     * When `multiple` is set, this property controls the maximum width the
+     * content of a value tag representing a selected option can reach. By
+     * default, selected value tags have no width limit.
+     */
+    valueTagMaxWidth?: React.CSSProperties["maxWidth"];
+    /** Properties to pass to the element holding the whole value or placeholder. */
+    valueProps?: React.ComponentPropsWithRef<"div">;
+    /** Properties to pass to each `Tag` holding a value, when `multiple` is set. */
+    valueTagProps?: Omit<React.ComponentPropsWithoutRef<typeof Tag>, "defaultOpen" | "open" | "onOpenChange" | "color" | "showCloseButton">;
+    /** Properties to pass to the arrow `Icon` component. */
+    arrowProps?: Omit<React.ComponentPropsWithRef<typeof IconButton>, "icon" | "label">;
+    /** Properties to pass to the `Popover` component. */
+    popoverProps?: React.ComponentPropsWithRef<typeof PopoverContent>;
+    /** Options to pass to the `CommandMenu` component. */
+    commandMenuProps?: Omit<React.ComponentPropsWithRef<typeof CommandMenu>, "defaultValue" | "value" | "onValueChange" | "iconPlacement" | "searchPlaceholder" | "searchValue" | "onSearchValueChange" | "listLabel" | "loading" | "loadingLabel" | "loadingProgress" | "emptyMessage">;
+}
+/** Properties of the select component with `multiple` not set. */
+export interface SelectSingleProps extends SelectPropsBase<string | number> {
+    multiple?: false;
+}
+/** Properties of the select component with `multiple` set. */
+export interface SelectMultipleProps extends SelectPropsBase<string[]> {
+    multiple: true;
+}
+/** Properties of the select component. */
+export type SelectProps = SelectSingleProps | SelectMultipleProps;
+/**
+ * Control which displays a menu of options for the user to pick from. Provides
+ * an alternative to the browser's [`<select>`
+ * element](https://developer.mozilla.org/en-US/docs/Web/HTML/Reference/Elements/select)
+ * via the “combobox” pattern, allowing users to search for options. It is built
+ * on top of the `Input`, `Popover`, and `CommandMenu` components.
+ *
+ * It supports the selection of more than one option by setting the `multiple`
+ * property.
+ *
+ * For accessibility purposes, select components are usually included within a
+ * `Field` together with a `Label` and optionally `HelperText` and/or
+ * `Feedback`.
+ *
+ * It composes the following subcomponents:
+ *
+ * - `OptionsGroup`: Groups options under an optional label.
+ * - `Option`: An option that can be selected.
+ *
+ * Example usage:
+ *
+ * ```tsx
+ * import { Option, Select } from "@ostack.tech/ui";
+ *
+ * function FavoriteFruit() {
+ *   return (
+ *     <Select placeholder="Select your favourite fruit…">
+ *       <Option value="apple">Apple</Option>
+ *       <Option value="banana">Banana</Option>
+ *       <Option value="cherry">Cherry</Option>
+ *     </Select>
+ *   );
+ * }
+ * ```
+ */
+export declare const Select: React.ForwardRefExoticComponent<SelectProps & React.RefAttributes<HTMLButtonElement>>;

package/dist/types/components/Select/SelectContext.d.ts

@@ -0,0 +1,61 @@
+import * as React from "react";
+import { type AccentColor } from "../../utils/accent.ts";
+import { type ControlStatus } from "../../utils/control.ts";
+import { type SelectProps } from "./Select.tsx";
+/** Value of the select context. */
+export interface SelectContextValue {
+    registering?: boolean;
+    multiple: boolean;
+    value: string | string[];
+    setValue: React.Dispatch<React.SetStateAction<string | number | readonly string[]>>;
+    onOptionSelect: (value: string) => void;
+    status?: ControlStatus;
+    disabled?: boolean;
+    readOnly?: boolean;
+    valueTagProps?: SelectProps["valueTagProps"];
+    store: SelectStore;
+}
+/** State of an option. */
+export interface OptionState {
+    content: React.ReactNode;
+    color?: AccentColor;
+    disabled?: boolean;
+}
+/** State of the select. */
+export interface SelectState {
+    optionsContent: [Map<string, OptionState>];
+    actions: SelectActions;
+}
+export interface SelectActions {
+    getOptionState: (value: string) => OptionState | undefined;
+    registerOption: (value: string, state: OptionState) => void;
+    unregisterOption: (value: string) => void;
+}
+/** Select store. */
+export type SelectStore = ReturnType<typeof useCreateSelectContext>["store"];
+/** Select context. */
+export declare const SelectContext: React.Context<SelectContextValue | null>;
+/** Options to pass to the `useCreateSelectContext` hook. */
+export type UseCreateSelectContextOptions = Omit<SelectContextValue, "store">;
+/** Hook which creates the select context. */
+export declare function useCreateSelectContext({ multiple, value, setValue, onOptionSelect, status, disabled, readOnly, valueTagProps, }: UseCreateSelectContextOptions): {
+    multiple: boolean;
+    value: string | string[];
+    setValue: React.Dispatch<React.SetStateAction<string | number | readonly string[]>>;
+    onOptionSelect: (value: string) => void;
+    status: ControlStatus | undefined;
+    disabled: boolean | undefined;
+    readOnly: boolean | undefined;
+    valueTagProps: Omit<Omit<import("../Tag/Tag.tsx").TagProps & React.RefAttributes<HTMLSpanElement>, "ref">, "color" | "defaultOpen" | "open" | "onOpenChange" | "showCloseButton"> | undefined;
+    store: Omit<import("zustand").StoreApi<SelectState>, "subscribe"> & {
+        subscribe: {
+            (listener: (selectedState: SelectState, previousSelectedState: SelectState) => void): () => void;
+            <U>(selector: (state: SelectState) => U, listener: (selectedState: U, previousSelectedState: U) => void, options?: {
+                equalityFn?: ((a: U, b: U) => boolean) | undefined;
+                fireImmediately?: boolean;
+            } | undefined): () => void;
+        };
+    };
+};
+/** Hooks returning the select context value. */
+export declare function useSelectContext(): SelectContextValue;

package/dist/types/components/Select/SelectMultipleValue.d.ts

@@ -0,0 +1 @@
+export declare function SelectMultipleValue(): import("react/jsx-runtime").JSX.Element;

package/dist/types/components/Select/SelectSingleValue.d.ts

@@ -0,0 +1 @@
+export declare function SelectSingleValue(): import("react").ReactNode;

package/dist/types/components/Select/index.d.ts

@@ -0,0 +1,3 @@
+export * from "./Option.tsx";
+export * from "./OptionsGroup.tsx";
+export * from "./Select.tsx";

package/dist/types/components/Separator/Separator.d.ts

@@ -0,0 +1,7 @@
+import { Separator as SeparatorPrimitive } from "radix-ui";
+import * as React from "react";
+/** Properties of the separator component. */
+export interface SeparatorProps extends React.ComponentPropsWithoutRef<typeof SeparatorPrimitive.Root> {
+}
+/** Component that visually or semantically separates content. */
+export declare const Separator: React.ForwardRefExoticComponent<SeparatorProps & React.RefAttributes<HTMLDivElement>>;

package/dist/types/components/Separator/index.d.ts

@@ -0,0 +1 @@
+export * from "./Separator.tsx";

package/dist/types/components/Slot/Slot.d.ts

@@ -0,0 +1,7 @@
+import { Slot as SlotPrimitive } from "radix-ui";
+/**
+ * Component that merges its props onto its immediate child.
+ *
+ * Used to support components with an `asChild` property.
+ */
+export declare const Slot: import("react").ForwardRefExoticComponent<SlotPrimitive.SlotProps & import("react").RefAttributes<HTMLElement>>;

package/dist/types/components/Slot/Slottable.d.ts

@@ -0,0 +1,10 @@
+import type * as React from "react";
+/** Properties of the `Slottable` component. */
+export interface SlottableProps {
+    children?: React.ReactNode;
+}
+/**
+ * Component that can be used a child of `Slot`, where the content shall be
+ * rendered.
+ */
+export declare const Slottable: React.ComponentType<SlottableProps>;

package/dist/types/components/Slot/index.d.ts

@@ -0,0 +1,2 @@
+export * from "./Slot.tsx";
+export * from "./Slottable.tsx";

package/dist/types/components/Spinner/Spinner.d.ts

@@ -0,0 +1,47 @@
+import * as React from "react";
+import { type AccentColor } from "../../utils/accent.ts";
+/** Possible sizes of the spinner. */
+export type SpinnerSize = "3xs" | "2xs" | "xs" | "sm" | "md" | "lg" | "xl" | "2xl" | "3xl" | "4xl" | "5xl" | "6xl" | "7xl" | "8xl" | "9xl";
+/** Possible colours of the spinner. */
+export type SpinnerColor = AccentColor;
+/** Properties of the spinner component. */
+export interface SpinnerProps extends React.ComponentPropsWithoutRef<"span"> {
+    /**
+     * Change the component to the HTML tag or custom component of the only child.
+     * This will merge the original component props with the props of the supplied
+     * element/component and change the underlying DOM node.
+     */
+    asChild?: boolean;
+    /**
+     * Size of the spinner. By default, the spinner will be sized according to the
+     * current font size.
+     */
+    size?: SpinnerSize;
+    /**
+     * Colour of the spinner. By default, the spinner will have the current font's
+     * colour.
+     */
+    color?: SpinnerColor;
+    /**
+     * Optional accessible label for the spinner.
+     *
+     * When provided, a visually hidden label is added so that assistive
+     * technologies correctly announce it.
+     */
+    label?: string;
+}
+/**
+ * The spinner component provides a visual cue that an action is currently being
+ * processed.
+ *
+ * Example usage:
+ *
+ * ```tsx
+ * import { Spinner } from "@ostack.tech/ui";
+ *
+ * function Loading() {
+ *   return <Spinner />;
+ * }
+ * ```
+ */
+export declare const Spinner: React.ForwardRefExoticComponent<SpinnerProps & React.RefAttributes<HTMLSpanElement>>;

package/dist/types/components/Spinner/index.d.ts

@@ -0,0 +1 @@
+export * from "./Spinner.tsx";

package/dist/types/components/Stack/Stack.d.ts

@@ -0,0 +1,42 @@
+import * as React from "react";
+import { type Responsive } from "../../utils/useResponsiveValues.ts";
+/** Possible stack directions. */
+export type FlexDirection = "column" | "column-reverse" | "row" | "row-reverse";
+/** Properties of the stack component. */
+export interface StackProps extends React.ComponentPropsWithoutRef<"div"> {
+    /**
+     * Change the component to the HTML tag or custom component of the only child.
+     * This will merge the original component props with the props of the supplied
+     * element/component and change the underlying DOM node.
+     */
+    asChild?: boolean;
+    /**
+     * Direction of the stack.
+     *
+     * @default column
+     */
+    direction?: Responsive<FlexDirection>;
+    /**
+     * Spacing between items. When a number is provided, each unit corresponds to
+     * `var(--oui-space)`.
+     *
+     * @default 5
+     */
+    gap?: Responsive<number | string>;
+    /** Adds a divider between elements. */
+    divider?: React.ReactElement;
+    justifyContent?: Responsive<React.CSSProperties["justifyContent"]>;
+    alignItems?: Responsive<React.CSSProperties["alignItems"]>;
+    alignContent?: Responsive<React.CSSProperties["alignContent"]>;
+    wrap?: Responsive<React.CSSProperties["flexWrap"]>;
+}
+/**
+ * The Stack component manages the layout of immediate children along the
+ * vertical or horizontal axis with optional spacing and/or dividers between
+ * each child.
+ *
+ * It uses a flex display together with a variant of the [lobotomised
+ * owl](https://css-tricks.com/lobotomized-owls/) selector (`* + *`) for
+ * spacing.
+ */
+export declare const Stack: React.ForwardRefExoticComponent<StackProps & React.RefAttributes<HTMLDivElement>>;

package/dist/types/components/Stack/index.d.ts

@@ -0,0 +1 @@
+export * from "./Stack.tsx";

package/dist/types/components/Stepper/Step.d.ts

@@ -0,0 +1,17 @@
+import { Tabs as TabsPrimitive } from "radix-ui";
+import * as React from "react";
+import { type ControlStatus } from "../../utils/control.ts";
+import { Label } from "../Label";
+/** Properties of the step component. */
+export interface StepProps extends Omit<React.ComponentPropsWithoutRef<typeof TabsPrimitive.TabsTrigger>, "asChild" | "value"> {
+    /** Index of the step. */
+    index?: number;
+    /** Status of the step. */
+    status?: ControlStatus;
+    /** Properties to pass to the container element. */
+    containerProps?: React.ComponentPropsWithRef<"div">;
+    /** Properties to pass to the step's label component. */
+    labelProps?: Omit<React.ComponentPropsWithRef<typeof Label>, "htmlFor">;
+}
+/** Step trigger component. */
+export declare const Step: React.ForwardRefExoticComponent<StepProps & React.RefAttributes<HTMLButtonElement>>;

package/dist/types/components/Stepper/StepContent.d.ts

@@ -0,0 +1,9 @@
+import { Tabs as TabsPrimitive } from "radix-ui";
+import * as React from "react";
+/** Properties of the step content component. */
+export interface StepContentProps extends Omit<React.ComponentPropsWithoutRef<typeof TabsPrimitive.TabsContent>, "value"> {
+    /** Index of the step that corresponds to this content. */
+    index: number;
+}
+/** Step content component. */
+export declare const StepContent: React.ForwardRefExoticComponent<StepContentProps & React.RefAttributes<HTMLDivElement>>;

package/dist/types/components/Stepper/StepList.d.ts

@@ -0,0 +1,12 @@
+import { Tabs as TabsPrimitive } from "radix-ui";
+import * as React from "react";
+/** Properties of the step list component. */
+export interface StepListProps extends React.ComponentPropsWithoutRef<typeof TabsPrimitive.List> {
+}
+/**
+ * Component containing the list of steps.
+ *
+ * The `index` of each `Step` is automatically added when `Step`s are direct
+ * children of `StepList`.
+ */
+export declare const StepList: React.ForwardRefExoticComponent<StepListProps & React.RefAttributes<HTMLDivElement>>;

package/dist/types/components/Stepper/Stepper.d.ts

@@ -0,0 +1,59 @@
+import { Tabs as TabsPrimitive } from "radix-ui";
+import * as React from "react";
+/** Properties of the stepper component. */
+export interface StepperProps extends Omit<React.ComponentPropsWithoutRef<typeof TabsPrimitive.Root>, "defaultValue" | "value" | "onValueChange" | "orientation" | "dir" | "children"> {
+    /**
+     * Index of the default active step.
+     *
+     * @default 0
+     */
+    defaultActiveStep?: number;
+    /** Index of the active step. */
+    activeStep?: number;
+    /**
+     * Function called when the active step changes.
+     *
+     * @param newActiveStep Index of the new active step.
+     */
+    onActiveStepChange?: (newActiveStep: number) => void;
+    /** Reference to interact with the stepper's API. */
+    apiRef?: React.Ref<StepperApi | undefined>;
+    children?: React.ReactNode | ((api: StepperApi) => React.ReactNode);
+}
+export interface StepperApi {
+    /** Currently active step. */
+    activeStep: number;
+    /**
+     * Navigates to the provided step.
+     *
+     * @param step Step to go to.
+     */
+    goTo: (step: number) => void;
+    /** Navigates to the next step. */
+    next: () => void;
+    /** Navigates to the previous step. */
+    previous: () => void;
+}
+/**
+ * Component used to display progress through a sequence of numbered steps.
+ *
+ * It composes the following subcomponents:
+ *
+ * - `StepList`: Displays the `Step` in the sequence, helping users visualize
+ *   their progress and navigate between steps.
+ * - `StepComponent`: Displays the content relevant to each `Step`, ensuring users
+ *   see detailed information as they progress through the steps.
+ *
+ * The component leverages the `StepperApi` interface to manage navigation and
+ * active step tracking through the following props:
+ *
+ * - `activeStep`: Tracks the currently active step to synchronize navigation and
+ *   step content display.
+ * - `previous`: Enables moving to the previous step. Prevents navigation beyond
+ *   the first step by disabling the relevant button.
+ * - `next`: Allows progression to the next step. On the final step, disables
+ *   further navigation to maintain flow.
+ * - `goTo`: Provides direct access to a specific step. While not used in all
+ *   implementations, it adds flexibility for custom navigation flows.
+ */
+export declare const Stepper: React.ForwardRefExoticComponent<StepperProps & React.RefAttributes<HTMLDivElement>>;

package/dist/types/components/Stepper/StepperContext.d.ts

@@ -0,0 +1,9 @@
+import * as React from "react";
+/** Value of the stepper's context. */
+export interface StepperContextValue {
+    activeStep: number;
+}
+/** Stepper's context. */
+export declare const StepperContext: React.Context<StepperContextValue | null>;
+/** Hook exposing the stepper's context. */
+export declare function useStepperContext(): StepperContextValue;

package/dist/types/components/Stepper/index.d.ts

@@ -0,0 +1,4 @@
+export * from "./Step.tsx";
+export * from "./StepContent.tsx";
+export * from "./StepList.tsx";
+export * from "./Stepper.tsx";