@servicetitan/anvil2 3.14.0 → 3.15.0

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

@@ -1,272 +1,96 @@
 import { ComponentPropsWithoutRef } from 'react';
 import { LayoutUtilProps } from '../../types';
 /**
- * Props for the Stepper component
- * @extends ComponentPropsWithoutRef<"div">
+ * @extends Omit<ComponentPropsWithoutRef<"div">, "onAnimationStart" | "onDragStart" | "onDragEnd" | "onDrag" | "onChange">
  * @extends LayoutUtilProps
  */
 export type StepperProps = Omit<ComponentPropsWithoutRef<"div">, "onAnimationStart" | "onDragStart" | "onDragEnd" | "onDrag" | "onChange"> & LayoutUtilProps & {
     /**
-     * Default step to start on (0-based index).
-     * To start in the completed state (showing FinalPanel with all steps marked complete),
-     * set this to the total number of steps (e.g. `items.length`).
-     * @default undefined
+     * Uncontrolled 0-based start. Defaults to `0`. When this is `>=` the
+     * registered step count after steps mount, the wizard starts completed
+     * on `Stepper.FinalPanel`.
      */
     defaultIndex?: number;
     /**
-     * Allows users to navigate to previous steps.
-     * @default undefined
+     * Lets users click and arrow-key to the current step and earlier ones.
+     * Later steps stay inert. Does not affect Next/Prev. Defaults to `false`.
      */
     allowNavigateToPrevStep?: boolean;
     /**
-     * Returns current step data when step changes.
-     * @param data Object containing currentStepId and currentStepIndex
-     * @param data.currentStepId ID given to Stepper.Panel, or "final-panel"
-     * @param data.currentStepIndex Index of current step, or undefined on final panel
+     * Fires when the visible panel id or completed state changes.
+     * `currentStepId` is that panel's `id`, or `"final-panel"`.
+     * `currentStepIndex` is omitted on the final panel.
      */
     onChange?: (data: {
         currentStepId: string | "final-panel";
         currentStepIndex?: number;
     }) => void;
-    /**
-     * Called when all steps are completed.
-     */
+    /** Fires when Next succeeds on the last step. */
     onComplete?: () => void;
 };
 /**
- * Stepper component for creating multi-step workflows and forms.
- *
- * Features:
- * - Multi-step navigation with visual progress indicators
- * - Keyboard navigation support with arrow keys
- * - Optional navigation to previous steps
- * - Smooth animations and transitions
- * - Accessible with proper ARIA roles and attributes
- * - Customizable step labels and content
- * - Completion state handling
- * - Layout utilities for positioning and spacing
- * - Motion animations for step transitions
- * - Context-based state management
+ * Linear wizard built on {@link StepperBase}. Current step is uncontrolled.
+ * Next/Prev drive progress; steps stay display-only unless
+ * `allowNavigateToPrevStep` reopens earlier ones.
  *
  * @example
- * <Stepper defaultIndex={0} allowNavigateToPrevStep>
+ * <Stepper allowNavigateToPrevStep>
  *   <Stepper.List>
- *     <Stepper.Step controls="step1">Step 1</Stepper.Step>
- *     <Stepper.Step controls="step2">Step 2</Stepper.Step>
- *     <Stepper.Step controls="step3">Step 3</Stepper.Step>
+ *     <Stepper.Step controls="step1">One</Stepper.Step>
+ *     <Stepper.Step controls="step2">Two</Stepper.Step>
  *   </Stepper.List>
- *
- *   <Stepper.Panel id="step1">
- *     <h2>Step 1 Content</h2>
- *     <p>This is the first step content.</p>
- *   </Stepper.Panel>
- *
- *   <Stepper.Panel id="step2">
- *     <h2>Step 2 Content</h2>
- *     <p>This is the second step content.</p>
- *   </Stepper.Panel>
- *
- *   <Stepper.Panel id="step3">
- *     <h2>Step 3 Content</h2>
- *     <p>This is the final step content.</p>
- *   </Stepper.Panel>
- *
- *   <Stepper.FinalPanel>
- *     <h2>Completed!</h2>
- *     <p>All steps have been completed successfully.</p>
- *   </Stepper.FinalPanel>
- *
+ *   <Stepper.Panel id="step1">First</Stepper.Panel>
+ *   <Stepper.Panel id="step2">Second</Stepper.Panel>
+ *   <Stepper.FinalPanel>Done</Stepper.FinalPanel>
  *   <Stepper.PrevButton />
  *   <Stepper.NextButton />
  * </Stepper>
  */
 export declare const Stepper: import('react').ForwardRefExoticComponent<Omit<Omit<import('react').DetailedHTMLProps<import('react').HTMLAttributes<HTMLDivElement>, HTMLDivElement>, "ref">, "onChange" | "onDrag" | "onDragEnd" | "onDragStart" | "onAnimationStart"> & LayoutUtilProps & {
     /**
-     * Default step to start on (0-based index).
-     * To start in the completed state (showing FinalPanel with all steps marked complete),
-     * set this to the total number of steps (e.g. `items.length`).
-     * @default undefined
+     * Uncontrolled 0-based start. Defaults to `0`. When this is `>=` the
+     * registered step count after steps mount, the wizard starts completed
+     * on `Stepper.FinalPanel`.
      */
     defaultIndex?: number;
     /**
-     * Allows users to navigate to previous steps.
-     * @default undefined
+     * Lets users click and arrow-key to the current step and earlier ones.
+     * Later steps stay inert. Does not affect Next/Prev. Defaults to `false`.
      */
     allowNavigateToPrevStep?: boolean;
     /**
-     * Returns current step data when step changes.
-     * @param data Object containing currentStepId and currentStepIndex
-     * @param data.currentStepId ID given to Stepper.Panel, or "final-panel"
-     * @param data.currentStepIndex Index of current step, or undefined on final panel
+     * Fires when the visible panel id or completed state changes.
+     * `currentStepId` is that panel's `id`, or `"final-panel"`.
+     * `currentStepIndex` is omitted on the final panel.
      */
     onChange?: (data: {
         currentStepId: string | "final-panel";
         currentStepIndex?: number;
     }) => void;
-    /**
-     * Called when all steps are completed.
-     */
+    /** Fires when Next succeeds on the last step. */
     onComplete?: () => void;
 } & import('react').RefAttributes<HTMLDivElement>> & {
-    /**
-     * Individual step component for the Stepper.
-     *
-     * Features:
-     * - Visual progress indicator with animated bar
-     * - Check icon for completed steps
-     * - Keyboard navigation support
-     * - Accessible with proper ARIA attributes
-     * - Click handling for step navigation
-     * - Visual states for current, completed, and future steps
-     * - Responsive design with mobile-friendly layout
-     * - Focus management for keyboard users
-     * - Custom styling support
-     *
-     * @example
-     * <Stepper.Step controls="step1">
-     *   Personal Information
-     * </Stepper.Step>
-     *
-     * @example
-     * <Stepper.Step
-     *   controls="step2"
-     *   onClick={(e, index) => console.log(`Clicked step ${index}`)}
-     * >
-     *   Contact Details
-     * </Stepper.Step>
-     */
+    /** Progress marker for one step in the track. */
     Step: import('react').ForwardRefExoticComponent<Omit<Omit<import('react').DetailedHTMLProps<import('react').ButtonHTMLAttributes<HTMLButtonElement>, HTMLButtonElement>, "ref">, "onClick" | "disabled"> & {
         controls: string;
         onClick?: (e: import('react').MouseEvent<HTMLButtonElement>, index?: number) => void;
     } & import('react').RefAttributes<HTMLButtonElement>>;
-    /**
-     * Container component for organizing and displaying stepper steps.
-     *
-     * Features:
-     * - Groups multiple stepper steps together
-     * - Displays current step label
-     * - Responsive design with mobile-friendly layout
-     * - Accessible with proper ARIA roles
-     * - Automatic step organization
-     * - Visual step indicators
-     * - Context-based current step display
-     * - Flexible layout with CSS Grid/Flexbox
-     * - Container queries for responsive behavior
-     *
-     * @example
-     * <Stepper.List>
-     *   <Stepper.Step controls="step1">Step 1</Stepper.Step>
-     *   <Stepper.Step controls="step2">Step 2</Stepper.Step>
-     *   <Stepper.Step controls="step3">Step 3</Stepper.Step>
-     * </Stepper.List>
-     */
+    /** Track of `Stepper.Step` children plus the compact current label. */
     List: import('react').ForwardRefExoticComponent<Omit<import('react').DetailedHTMLProps<import('react').HTMLAttributes<HTMLDivElement>, HTMLDivElement>, "ref"> & import('react').RefAttributes<HTMLDivElement>>;
-    /**
-     * Content panel component for displaying step content in the Stepper.
-     *
-     * Features:
-     * - Displays content for the current step only
-     * - Smooth fade-in/fade-out animations
-     * - Automatic overflow handling with scroll support
-     * - Accessible with proper ARIA roles
-     * - Layout utilities for positioning and spacing
-     * - Motion animations for smooth transitions
-     * - Focus management for keyboard navigation
-     * - Responsive design with flexible layout
-     * - Context-based visibility control
-     *
-     * @example
-     * <Stepper.Panel id="step1">
-     *   <h2>Personal Information</h2>
-     *   <form>
-     *     <label htmlFor="name">Name:</label>
-     *     <input id="name" type="text" />
-     *   </form>
-     * </Stepper.Panel>
-     */
+    /** Body shown while its paired step is current and the wizard is incomplete. */
     Panel: import('react').ForwardRefExoticComponent<Omit<Omit<import('react').DetailedHTMLProps<import('react').HTMLAttributes<HTMLDivElement>, HTMLDivElement>, "ref">, "onDrag" | "onDragEnd" | "onDragStart" | "onAnimationStart"> & LayoutUtilProps & {
         id: string;
     } & import('react').RefAttributes<HTMLDivElement>>;
-    /**
-     * Next button component for navigating to the next step in the Stepper.
-     *
-     * Features:
-     * - Automatically advances to the next step
-     * - Changes label to "Complete" on the final step
-     * - Supports async validation with Promise return
-     * - Prevents navigation when validation fails
-     * - Hides when all steps are completed
-     * - Accessible with proper button semantics
-     * - Customizable appearance and styling
-     * - Integration with stepper context
-     * - Automatic completion handling
-     *
-     * @example
-     * <Stepper.NextButton
-     *   nextLabel="Continue"
-     *   completeLabel="Finish"
-     * />
-     *
-     * @example
-     * <Stepper.NextButton
-     *   onClick={async (e) => {
-     *     const isValid = await validateForm();
-     *     return isValid;
-     *   }}
-     *   appearance="primary"
-     * />
-     */
+    /** Advances; last step uses `completeLabel` and calls `onComplete`. */
     NextButton: import('react').ForwardRefExoticComponent<Omit<import('..').ButtonProps, "children"> & {
         nextLabel?: string;
         completeLabel?: string;
         onClick?: (e: import('react').MouseEvent<HTMLButtonElement>) => void | boolean | Promise<boolean>;
     } & import('../..').DataTrackingId & import('react').RefAttributes<HTMLButtonElement>>;
-    /**
-     * Previous button component for navigating to the previous step in the Stepper.
-     *
-     * Features:
-     * - Navigates to the previous step when available
-     * - Hides when on the first step
-     * - Restores navigation when returning from completion
-     * - Accessible with proper button semantics
-     * - Customizable label and styling
-     * - Integration with stepper context
-     * - Automatic focus management
-     * - Support for completion state handling
-     *
-     * @example
-     * <Stepper.PrevButton label="Go Back" />
-     *
-     * @example
-     * <Stepper.PrevButton
-     *   label="Previous Step"
-     *   appearance="secondary"
-     *   onClick={(e) => console.log('Going back')}
-     * />
-     */
+    /** Goes back one step, or leaves the completed FinalPanel. Hidden on the first step. */
     PrevButton: import('react').ForwardRefExoticComponent<Omit<import('..').ButtonProps, "children"> & {
         label?: string;
     } & import('../..').DataTrackingId & import('react').RefAttributes<HTMLButtonElement>>;
-    /**
-     * Final panel component displayed when all stepper steps are completed.
-     *
-     * Features:
-     * - Displays only when all steps are completed
-     * - Smooth fade-in animation on completion
-     * - Automatic overflow handling with scroll support
-     * - Accessible with proper ARIA roles
-     * - Layout utilities for positioning and spacing
-     * - Motion animations for smooth transitions
-     * - Focus management for keyboard navigation
-     * - Responsive design with flexible layout
-     * - Context-based visibility control
-     *
-     * @example
-     * <Stepper.FinalPanel>
-     *   <h2>Congratulations!</h2>
-     *   <p>You have successfully completed all steps.</p>
-     *   <Button onClick={handleSubmit}>Submit</Button>
-     * </Stepper.FinalPanel>
-     */
+    /** Shown after the last Next completes, or when `defaultIndex` starts completed. */
     FinalPanel: import('react').ForwardRefExoticComponent<Omit<Omit<import('react').DetailedHTMLProps<import('react').HTMLAttributes<HTMLDivElement>, HTMLDivElement>, "ref">, "onDrag" | "onDragEnd" | "onDragStart" | "onAnimationStart"> & LayoutUtilProps & import('react').RefAttributes<HTMLDivElement>>;
 };

package/dist/src/components/Stepper/StepperFinalPanel.d.ts

@@ -1,30 +1,9 @@
 import { ComponentPropsWithoutRef } from 'react';
 import { LayoutUtilProps } from '../../types';
 /**
- * Props for the StepperFinalPanel component
- * @extends ComponentPropsWithoutRef<"div">
+ * @extends Omit<ComponentPropsWithoutRef<"div">, "onAnimationStart" | "onDragStart" | "onDragEnd" | "onDrag">
  * @extends LayoutUtilProps
  */
 export type StepperFinalPanelProps = Omit<ComponentPropsWithoutRef<"div">, "onAnimationStart" | "onDragStart" | "onDragEnd" | "onDrag"> & LayoutUtilProps;
-/**
- * Final panel component displayed when all stepper steps are completed.
- *
- * Features:
- * - Displays only when all steps are completed
- * - Smooth fade-in animation on completion
- * - Automatic overflow handling with scroll support
- * - Accessible with proper ARIA roles
- * - Layout utilities for positioning and spacing
- * - Motion animations for smooth transitions
- * - Focus management for keyboard navigation
- * - Responsive design with flexible layout
- * - Context-based visibility control
- *
- * @example
- * <Stepper.FinalPanel>
- *   <h2>Congratulations!</h2>
- *   <p>You have successfully completed all steps.</p>
- *   <Button onClick={handleSubmit}>Submit</Button>
- * </Stepper.FinalPanel>
- */
+/** Shown after the last Next completes, or when `defaultIndex` starts completed. */
 export declare const StepperFinalPanel: import('react').ForwardRefExoticComponent<Omit<Omit<import('react').DetailedHTMLProps<import('react').HTMLAttributes<HTMLDivElement>, HTMLDivElement>, "ref">, "onDrag" | "onDragEnd" | "onDragStart" | "onAnimationStart"> & LayoutUtilProps & import('react').RefAttributes<HTMLDivElement>>;

package/dist/src/components/Stepper/StepperList.d.ts

@@ -1,28 +1,7 @@
 import { ComponentPropsWithoutRef } from 'react';
 /**
- * Props for the StepperList component
  * @extends ComponentPropsWithoutRef<"div">
  */
 export type StepperListProps = ComponentPropsWithoutRef<"div">;
-/**
- * Container component for organizing and displaying stepper steps.
- *
- * Features:
- * - Groups multiple stepper steps together
- * - Displays current step label
- * - Responsive design with mobile-friendly layout
- * - Accessible with proper ARIA roles
- * - Automatic step organization
- * - Visual step indicators
- * - Context-based current step display
- * - Flexible layout with CSS Grid/Flexbox
- * - Container queries for responsive behavior
- *
- * @example
- * <Stepper.List>
- *   <Stepper.Step controls="step1">Step 1</Stepper.Step>
- *   <Stepper.Step controls="step2">Step 2</Stepper.Step>
- *   <Stepper.Step controls="step3">Step 3</Stepper.Step>
- * </Stepper.List>
- */
+/** Track of `Stepper.Step` children plus the compact current label. */
 export declare const StepperList: import('react').ForwardRefExoticComponent<Omit<import('react').DetailedHTMLProps<import('react').HTMLAttributes<HTMLDivElement>, HTMLDivElement>, "ref"> & import('react').RefAttributes<HTMLDivElement>>;

package/dist/src/components/Stepper/StepperNextButton.d.ts

@@ -2,72 +2,32 @@ import { MouseEvent } from 'react';
 import { ButtonProps } from '../Button';
 import { DataTrackingId } from '../../types';
 /**
- * Props for the StepperNextButton component
- * @extends ButtonProps
+ * @extends Omit<ButtonProps, "children">
+ * @extends DataTrackingId
  */
 export type StepperNextButtonProps = Omit<ButtonProps, "children"> & {
-    /**
-     * Label for the next button.
-     * @default "Next"
-     */
+    /** Label except on the last step. Defaults to `"Next"`. */
     nextLabel?: string;
-    /**
-     * Label for the complete button (shown on the last step).
-     * @default "Complete"
-     */
+    /** Label on the last step. Defaults to `"Complete"`. */
     completeLabel?: string;
     /**
-     * Called when the "Next" button is clicked.
-     * @param e MouseEvent<HTMLButtonElement>
-     * @returns If the function returns `false`, or a Promise that resolves to `false`, the next step will not be executed.
+     * Return `false` or a Promise that resolves to `false` to block advance.
+     * `void` or `true` proceeds. Last successful click completes.
      */
     onClick?: (e: MouseEvent<HTMLButtonElement>) => void | boolean | Promise<boolean>;
 } & DataTrackingId;
 /**
- * Next button component for navigating to the next step in the Stepper.
- *
- * Features:
- * - Automatically advances to the next step
- * - Changes label to "Complete" on the final step
- * - Supports async validation with Promise return
- * - Prevents navigation when validation fails
- * - Hides when all steps are completed
- * - Accessible with proper button semantics
- * - Customizable appearance and styling
- * - Integration with stepper context
- * - Automatic completion handling
- * - Automatic tracking ID generation for analytics
- *
- * @example
- * <Stepper.NextButton
- *   nextLabel="Continue"
- *   completeLabel="Finish"
- * />
- *
- * @example
- * <Stepper.NextButton
- *   onClick={async (e) => {
- *     const isValid = await validateForm();
- *     return isValid;
- *   }}
- *   appearance="primary"
- * />
+ * Advances the wizard. Hidden after completion. Last step shows
+ * `completeLabel` and fires `onComplete`. Appearance defaults to `primary`.
  */
 export declare const StepperNextButton: import('react').ForwardRefExoticComponent<Omit<ButtonProps, "children"> & {
-    /**
-     * Label for the next button.
-     * @default "Next"
-     */
+    /** Label except on the last step. Defaults to `"Next"`. */
     nextLabel?: string;
-    /**
-     * Label for the complete button (shown on the last step).
-     * @default "Complete"
-     */
+    /** Label on the last step. Defaults to `"Complete"`. */
     completeLabel?: string;
     /**
-     * Called when the "Next" button is clicked.
-     * @param e MouseEvent<HTMLButtonElement>
-     * @returns If the function returns `false`, or a Promise that resolves to `false`, the next step will not be executed.
+     * Return `false` or a Promise that resolves to `false` to block advance.
+     * `void` or `true` proceeds. Last successful click completes.
      */
     onClick?: (e: MouseEvent<HTMLButtonElement>) => void | boolean | Promise<boolean>;
 } & DataTrackingId & import('react').RefAttributes<HTMLButtonElement>>;

package/dist/src/components/Stepper/StepperPanel.d.ts

@@ -1,52 +1,21 @@
 import { ComponentPropsWithoutRef } from 'react';
 import { LayoutUtilProps } from '../../types';
 /**
- * Props for the StepperPanel component
- * @extends ComponentPropsWithoutRef<"div">
+ * @extends Omit<ComponentPropsWithoutRef<"div">, "onAnimationStart" | "onDragStart" | "onDragEnd" | "onDrag">
  * @extends LayoutUtilProps
  */
 export type StepperPanelProps = Omit<ComponentPropsWithoutRef<"div">, "onAnimationStart" | "onDragStart" | "onDragEnd" | "onDrag"> & LayoutUtilProps & {
     /**
-     * Unique identifier for the panel.
-     * Must match the controls prop of the corresponding Stepper.Step.
+     * Must match the paired `Stepper.Step` `controls`. Only the current
+     * incomplete panel renders.
      */
     id: string;
 };
-/**
- * Content panel component for displaying step content in the Stepper.
- *
- * Features:
- * - Displays content for the current step only
- * - Smooth fade-in/fade-out animations
- * - Automatic overflow handling with scroll support
- * - Accessible with proper ARIA roles
- * - Layout utilities for positioning and spacing
- * - Motion animations for smooth transitions
- * - Focus management for keyboard navigation
- * - Responsive design with flexible layout
- * - Context-based visibility control
- *
- * @example
- * <Stepper.Panel id="step1">
- *   <h2>Personal Information</h2>
- *   <form>
- *     <label htmlFor="name">Name:</label>
- *     <input id="name" type="text" />
- *   </form>
- * </Stepper.Panel>
- *
- * @example
- * <Stepper.Panel id="step2" className="custom-panel">
- *   <div className="step-content">
- *     <h2>Contact Details</h2>
- *     <p>Please provide your contact information.</p>
- *   </div>
- * </Stepper.Panel>
- */
+/** Body shown while its paired step is current and the wizard is incomplete. */
 export declare const StepperPanel: import('react').ForwardRefExoticComponent<Omit<Omit<import('react').DetailedHTMLProps<import('react').HTMLAttributes<HTMLDivElement>, HTMLDivElement>, "ref">, "onDrag" | "onDragEnd" | "onDragStart" | "onAnimationStart"> & LayoutUtilProps & {
     /**
-     * Unique identifier for the panel.
-     * Must match the controls prop of the corresponding Stepper.Step.
+     * Must match the paired `Stepper.Step` `controls`. Only the current
+     * incomplete panel renders.
      */
     id: string;
 } & import('react').RefAttributes<HTMLDivElement>>;

package/dist/src/components/Stepper/StepperPrevButton.d.ts

@@ -1,44 +1,18 @@
 import { DataTrackingId } from '../../types';
 import { ButtonProps } from '../Button';
 /**
- * Props for the StepperPrevButton component
- * @extends ButtonProps
+ * @extends Omit<ButtonProps, "children">
+ * @extends DataTrackingId
  */
 export type StepperPrevButtonProps = Omit<ButtonProps, "children"> & {
-    /**
-     * Label for the previous button.
-     * @default "Previous"
-     */
+    /** Button text. Defaults to `"Previous"`. */
     label?: string;
 } & DataTrackingId;
 /**
- * Previous button component for navigating to the previous step in the Stepper.
- *
- * Features:
- * - Navigates to the previous step when available
- * - Hides when on the first step
- * - Restores navigation when returning from completion
- * - Accessible with proper button semantics
- * - Customizable label and styling
- * - Integration with stepper context
- * - Automatic focus management
- * - Support for completion state handling
- * - Automatic tracking ID generation for analytics
- *
- * @example
- * <Stepper.PrevButton label="Go Back" />
- *
- * @example
- * <Stepper.PrevButton
- *   label="Previous Step"
- *   appearance="secondary"
- *   onClick={(e) => console.log('Going back')}
- * />
+ * Goes back one step. Hidden on the first step. From FinalPanel, restores
+ * the last step instead of decrementing.
  */
 export declare const StepperPrevButton: import('react').ForwardRefExoticComponent<Omit<ButtonProps, "children"> & {
-    /**
-     * Label for the previous button.
-     * @default "Previous"
-     */
+    /** Button text. Defaults to `"Previous"`. */
     label?: string;
 } & DataTrackingId & import('react').RefAttributes<HTMLButtonElement>>;

package/dist/src/components/Stepper/StepperStep.d.ts

@@ -1,58 +1,23 @@
 import { MouseEvent, ComponentPropsWithoutRef } from 'react';
 /**
- * Props for the StepperStep component
- * @extends ComponentPropsWithoutRef<"button">
+ * @extends Omit<ComponentPropsWithoutRef<"button">, "onClick" | "disabled">
  */
 export type StepperStepProps = Omit<ComponentPropsWithoutRef<"button">, "onClick" | "disabled"> & {
-    /**
-     * ID of the panel that this step is controlling.
-     * Must match the id prop of the corresponding Stepper.Panel.
-     */
+    /** Must match the paired `Stepper.Panel` `id`. */
     controls: string;
     /**
-     * Called when the step is clicked.
-     * @param e Mouse event object
-     * @param index Index of the step in the stepper
+     * Runs first and receives this step's 0-based index. Navigation still
+     * requires `allowNavigateToPrevStep` and a non-future step.
      */
     onClick?: (e: MouseEvent<HTMLButtonElement>, index?: number) => void;
 };
-/**
- * Individual step component for the Stepper.
- *
- * Features:
- * - Visual progress indicator with animated bar
- * - Check icon for completed steps
- * - Keyboard navigation support
- * - Accessible with proper ARIA attributes
- * - Click handling for step navigation
- * - Visual states for current, completed, and future steps
- * - Responsive design with mobile-friendly layout
- * - Focus management for keyboard users
- * - Custom styling support
- *
- * @example
- * <Stepper.Step controls="step1">
- *   Personal Information
- * </Stepper.Step>
- *
- * @example
- * <Stepper.Step
- *   controls="step2"
- *   onClick={(e, index) => console.log(`Clicked step ${index}`)}
- * >
- *   Contact Details
- * </Stepper.Step>
- */
+/** Progress marker for one step in the wizard track. */
 export declare const StepperStep: import('react').ForwardRefExoticComponent<Omit<Omit<import('react').DetailedHTMLProps<import('react').ButtonHTMLAttributes<HTMLButtonElement>, HTMLButtonElement>, "ref">, "onClick" | "disabled"> & {
-    /**
-     * ID of the panel that this step is controlling.
-     * Must match the id prop of the corresponding Stepper.Panel.
-     */
+    /** Must match the paired `Stepper.Panel` `id`. */
     controls: string;
     /**
-     * Called when the step is clicked.
-     * @param e Mouse event object
-     * @param index Index of the step in the stepper
+     * Runs first and receives this step's 0-based index. Navigation still
+     * requires `allowNavigateToPrevStep` and a non-future step.
      */
     onClick?: (e: MouseEvent<HTMLButtonElement>, index?: number) => void;
 } & import('react').RefAttributes<HTMLButtonElement>>;