@cratis/components 3.6.1 → 4.1.0

package/dist/esm/Chat/topicsByActivity.js

@@ -1,11 +1,3 @@
-// Copyright (c) Cratis. All rights reserved.
-// Licensed under the MIT license. See LICENSE file in the project root for full license information.
-/**
- * When a topic last saw something happen. Data that traveled through JSON may carry dates as
- * strings, so the value is coerced rather than trusted to be a `Date`.
- * @param topic The topic to read.
- * @returns The time of last activity, the start time when nothing happened since, or the epoch when neither is known.
- */
 const lastActivityOf = (topic) => {
     const moment = topic.lastActivity ?? topic.started;
     if (moment === undefined)
@@ -13,12 +5,6 @@ const lastActivityOf = (topic) => {
     const time = moment instanceof Date ? moment.getTime() : new Date(moment).getTime();
     return Number.isNaN(time) ? 0 : time;
 };
-/**
- * The topics ordered by most recent activity first, so the conversation somebody is most likely
- * looking for sits on top. Non-mutating.
- * @param topics The topics in any order.
- * @returns A new array, most recently active first.
- */
 const topicsByActivity = (topics) => [...topics].sort((left, right) => lastActivityOf(right) - lastActivityOf(left));
 
 export { topicsByActivity };

package/dist/esm/Chat/topicsByActivity.js.map

@@ -1 +1 @@
-{"version":3,"file":"topicsByActivity.js","sources":["../../../Chat/topicsByActivity.ts"],"sourcesContent":[null],"names":[],"mappings":"AAAA;AACA;AAIA;;;;;AAKG;AACH,MAAM,cAAc,GAAG,CAAC,KAAgB,KAAY;IAChD,MAAM,MAAM,GAAG,KAAK,CAAC,YAAY,IAAI,KAAK,CAAC,OAAO;IAClD,IAAI,MAAM,KAAK,SAAS;AAAE,QAAA,OAAO,CAAC;IAClC,MAAM,IAAI,GAAG,MAAM,YAAY,IAAI,GAAG,MAAM,CAAC,OAAO,EAAE,GAAG,IAAI,IAAI,CAAC,MAAM,CAAC,CAAC,OAAO,EAAE;AACnF,IAAA,OAAO,MAAM,CAAC,KAAK,CAAC,IAAI,CAAC,GAAG,CAAC,GAAG,IAAI;AACxC,CAAC;AAED;;;;;AAKG;AACI,MAAM,gBAAgB,GAAG,CAA2B,MAAgB,KACvE,CAAC,GAAG,MAAM,CAAC,CAAC,IAAI,CAAC,CAAC,IAAI,EAAE,KAAK,KAAK,cAAc,CAAC,KAAK,CAAC,GAAG,cAAc,CAAC,IAAI,CAAC;;"}
+{"version":3,"file":"topicsByActivity.js","sources":["../../../Chat/topicsByActivity.ts"],"sourcesContent":[null],"names":[],"mappings":"AAWA,MAAM,cAAc,GAAG,CAAC,KAAgB,KAAY;IAChD,MAAM,MAAM,GAAG,KAAK,CAAC,YAAY,IAAI,KAAK,CAAC,OAAO;IAClD,IAAI,MAAM,KAAK,SAAS;AAAE,QAAA,OAAO,CAAC;IAClC,MAAM,IAAI,GAAG,MAAM,YAAY,IAAI,GAAG,MAAM,CAAC,OAAO,EAAE,GAAG,IAAI,IAAI,CAAC,MAAM,CAAC,CAAC,OAAO,EAAE;AACnF,IAAA,OAAO,MAAM,CAAC,KAAK,CAAC,IAAI,CAAC,GAAG,CAAC,GAAG,IAAI;AACxC,CAAC;AAQM,MAAM,gBAAgB,GAAG,CAA2B,MAAgB,KACvE,CAAC,GAAG,MAAM,CAAC,CAAC,IAAI,CAAC,CAAC,IAAI,EAAE,KAAK,KAAK,cAAc,CAAC,KAAK,CAAC,GAAG,cAAc,CAAC,IAAI,CAAC;;"}

package/dist/esm/CommandDialog/CommandDialog.d.ts

@@ -1,15 +1,53 @@
-import { type DialogProps } from '../Dialogs/Dialog';
+import { type DialogProps } from '../Dialogs/Dialog.js';
 import React from 'react';
 import { type CommandFormProps } from '@cratis/arc.react/commands';
-import { type BeforeExecuteCallback } from './applyBeforeExecute';
-export interface CommandDialogProps<TCommand extends object, TResponse = object> extends Omit<CommandFormProps<TCommand, TResponse>, 'children' | 'onBeforeExecute'>, Omit<DialogProps, 'children'> {
+import { type BeforeExecuteCallback } from './applyBeforeExecute.js';
+/**
+ * Props for {@link CommandDialog}. Combines the props of a `CommandForm`
+ * (`command`, `initialValues`, `onSuccess`, `onValidationFailure`, `onFailed`,
+ * `onBeforeExecute`, etc.) with the props of a {@link Dialog} (`title`,
+ * `buttons`, `width`, `pt`, `unstyled`, …).
+ *
+ * @typeParam TCommand - The command record type (must extend `object`).
+ * @typeParam TResponse - The response payload type returned by a successful command. Defaults to `object`.
+ */
+export interface CommandDialogProps<TCommand extends object, TResponse = object> extends Omit<CommandFormProps<TCommand, TResponse>, 'children' | 'onBeforeExecute'>, Omit<DialogProps, 'children' | 'isBusy'> {
+    /**
+     * A transformer invoked with the current command values immediately before
+     * the command executes on confirm. It **must return** the values to run with
+     * (mutated or not) — a callback that returns nothing does not execute the
+     * command with `undefined`; the current values are kept and a warning is
+     * logged. May be async.
+     *
+     * ⚠️ It runs **only on submit**, after the form has already been validated,
+     * so a value produced here can never satisfy required-field validation — the
+     * submit button stays disabled if a required value is only seeded here. Seed
+     * required values through `initialValues`; reserve `onBeforeExecute` for
+     * transforms that do not affect validity (for example a generated id).
+     */
     onBeforeExecute?: BeforeExecuteCallback<TCommand>;
+    /**
+     * Form fields and arbitrary content for the dialog body. Children that are
+     * `CommandFormField` instances are automatically wrapped so they bind to
+     * the command instance.
+     */
     children?: React.ReactNode;
 }
+/**
+ * A {@link Dialog} that hosts a Cratis Arc `CommandForm`, runs the bound
+ * command on confirm, and only closes when the command succeeds. This is
+ * the standard pattern for "user fills in a form, clicks OK, command runs
+ * server-side, dialog dismisses" — `CommandDialog` collapses about thirty
+ * lines of orchestration into the props on a single component.
+ *
+ * See {@link CommandDialogComponent} for full documentation.
+ *
+ * @typeParam TCommand - The command class (proxy generated from C# `[Command]`).
+ * @typeParam TResponse - The success payload type returned by the command's `Handle()` method on the backend.
+ */
 export declare const CommandDialog: {
     <TCommand extends object = object, TResponse = object>(props: CommandDialogProps<TCommand, TResponse>): React.JSX.Element;
     Column: ({ children }: {
         children: React.ReactNode;
     }) => React.JSX.Element;
 };
-//# sourceMappingURL=CommandDialog.d.ts.map

package/dist/esm/CommandDialog/CommandDialog.js

@@ -6,30 +6,33 @@ import { CommandForm, useCommandFormContext, useCommandInstance, CommandFormFiel
 import { applyBeforeExecute } from './applyBeforeExecute.js';
 import { markAsCommandFormColumn, isCommandFormField } from '../CommandForm/commandFormMarkers.js';
 
-const CommandDialogWrapper = ({ title, visible, width, style, contentStyle, resizable, buttons, initialFocus, okLabel, cancelLabel, yesLabel, noLabel, dismissable, closeAriaLabel, isValid, onClose, onConfirm, onCancel, onSuccess, onValidationFailure, onFailed, onBeforeExecute, className, pt, ptOptions, unstyled, children }) => {
-    const { setCommandValues, setCommandResult, isValid: isCommandFormValid } = useCommandFormContext();
+const CommandDialogWrapper = ({ title, visible, width, style, contentStyle, resizable, buttons, initialFocus, okLabel, cancelLabel, yesLabel, noLabel, dismissable, closeAriaLabel, isValid, onClose, onConfirm, onCancel, onSuccess, onValidationFailure, onFailed, onException, onUnauthorized, onBeforeExecute, className, pt, ptOptions, unstyled, children, }) => {
+    const { setCommandValues, setCommandResult, isValid: isCommandFormValid, } = useCommandFormContext();
     const commandInstance = useCommandInstance();
     const [isBusy, setIsBusy] = useState(false);
     const handleConfirm = async () => {
-        if (onBeforeExecute) {
-            const applied = applyBeforeExecute(onBeforeExecute, commandInstance);
-            setCommandValues(applied instanceof Promise ? await applied : applied);
-        }
         setIsBusy(true);
         let result;
         try {
+            if (onBeforeExecute) {
+                const applied = applyBeforeExecute(onBeforeExecute, commandInstance);
+                setCommandValues(applied instanceof Promise ? await applied : applied);
+            }
             result = await commandInstance.execute();
         }
         finally {
             setIsBusy(false);
         }
         if (!result.isSuccess) {
+            await onFailed?.(result);
+            if (result.hasExceptions) {
+                await onException?.(result.exceptionMessages, result.exceptionStackTrace);
+            }
+            if (!result.isAuthorized)
+                await onUnauthorized?.();
             if (!result.isValid) {
                 await onValidationFailure?.(result.validationResults);
             }
-            else {
-                await onFailed?.(result);
-            }
             setCommandResult(result);
             return false;
         }
@@ -50,140 +53,24 @@ const CommandDialogWrapper = ({ title, visible, width, style, contentStyle, resi
                 return child;
             const component = child.type;
             if (isCommandFormField(component)) {
-                return jsx(CommandFormFieldWrapper, { field: child });
+                return (jsx(CommandFormFieldWrapper, { field: child }));
             }
             const childProps = child.props;
             if (childProps.children != null) {
                 return React.cloneElement(child, {
-                    children: processChildren(childProps.children)
+                    children: processChildren(childProps.children),
                 });
             }
             return child;
         });
     };
     const processedChildren = processChildren(children);
-    const isDialogValid = (isValid !== false) && isCommandFormValid;
+    const isDialogValid = isValid !== false && isCommandFormValid;
     return (jsx(Dialog, { title: title, visible: visible, width: width, style: style, contentStyle: contentStyle, resizable: resizable, buttons: buttons, initialFocus: initialFocus, onClose: onClose, onConfirm: handleConfirm, onCancel: onCancel, okLabel: okLabel, cancelLabel: cancelLabel, yesLabel: yesLabel, noLabel: noLabel, dismissable: dismissable, closeAriaLabel: closeAriaLabel, isValid: isDialogValid, isBusy: isBusy, className: className, pt: pt, ptOptions: ptOptions, unstyled: unstyled, children: jsx("div", { style: { display: 'flex', flexDirection: 'column', width: '100%' }, children: processedChildren }) }));
 };
-/**
- * A {@link Dialog} that hosts a Cratis Arc `CommandForm`, runs the bound
- * command on confirm, and only closes when the command succeeds. This is
- * the standard pattern for "user fills in a form, clicks OK, command runs
- * server-side, dialog dismisses" — `CommandDialog` collapses about thirty
- * lines of orchestration into the props on a single component.
- *
- * ## Where `TCommand` comes from
- *
- * `TCommand` is an auto-generated TypeScript class produced by the Arc proxy
- * generator from a C# `[Command]` record. `dotnet build` writes a `.ts` file
- * per command with the right property types and a typed `execute()` method;
- * importing the class is all the connection-to-the-backend you need. The
- * class also exposes a `.use()` hook for direct (non-dialog) usage and a
- * `useWithChangeTracking()` variant.
- *
- * ## What happens on confirm
- *
- * 1. If `onBeforeExecute` is supplied, it transforms the command values.
- *    Used for generated IDs (`Guid.create()`) that the user did not type in.
- * 2. The command's `execute()` runs through Arc's command pipeline. The
- *    backend handler returns either a typed response (mapped to `TResponse`)
- *    or a `ValidationResult[]`.
- * 3. On `IsSuccess: true`, `onSuccess(response)` fires and the dialog closes
- *    through the dialog host context.
- * 4. On a validation failure, `onValidationFailure(errors)` fires and the
- *    form's per-field error display is updated. The dialog stays open.
- * 5. On a domain or transport failure, `onFailed(result)` fires. The dialog
- *    stays open and the `CommandResult` is set on the form context so the
- *    UI can surface the error to the user.
- *
- * Throughout, the dialog is in the `isBusy` state — every action button is
- * disabled and the confirm button shows a spinner.
- *
- * ## Destructive commands and initial focus
- *
- * The confirm button is focused when the dialog opens, and a focused native
- * button fires `click` from the `keydown` of `Enter`. A command whose form
- * has required fields is protected from a held or double-tapped `Enter` for
- * free, because `isCommandFormValid` keeps confirm disabled until something
- * is filled in. A command that takes **no** input — the typical "delete
- * this, permanently" command — has no such gate, so its confirm button is
- * armed the instant the dialog appears.
- *
- * Pass `initialFocus` (forwarded straight to {@link Dialog}) for those:
- *
- * ```tsx
- * <CommandDialog<DeletePerson>
- *     command={DeletePerson}
- *     title="Delete personal data?"
- *     okLabel="Delete"
- *     initialFocus={DialogInitialFocus.Cancel}
- *     onSuccess={() => closeDialog(DialogResult.Ok)}>
- *     This cannot be undone.
- * </CommandDialog>
- * ```
- *
- * Everything else — the footer, the close (X), `Escape`, and the confirm
- * wiring that runs the command — is untouched.
- *
- * ## Field binding
- *
- * Children that are `CommandFormField` instances (`InputTextField`,
- * `NumberField`, `DropdownField`, every `@cratis/components/CommandForm/fields`
- * widget) bind to a property on the command via the `value` accessor:
- *
- * ```tsx
- * <InputTextField value={c => c.name} title="Name" />
- * ```
- *
- * The accessor's argument is the command instance — TypeScript infers
- * `c.name` is a string and the field type-checks against that. Arbitrary
- * non-field children (custom layout, additional text, decorative elements)
- * are rendered as plain content.
- *
- * ## Typed dialog host usage
- *
- * Combine with `useDialog<CommandResult<TResponse>>()` from
- * `@cratis/arc.react/dialogs` to get a fully-typed result at the call site:
- *
- * ```tsx
- * import { useDialog, DialogResult } from '@cratis/arc.react/dialogs';
- * import { CommandDialog } from '@cratis/components/CommandDialog';
- * import { RegisterAuthor } from './RegisterAuthor';   // proxy from C#
- *
- * type RegisterAuthorResponse = { authorId: string };
- *
- * const RegisterAuthorDialog = () => {
- *     const { closeDialog } = useDialogContext<CommandResult<RegisterAuthorResponse>>();
- *     return (
- *         <CommandDialog<RegisterAuthor, RegisterAuthorResponse>
- *             command={RegisterAuthor}
- *             title="Register author"
- *             okLabel="Register"
- *             onSuccess={(response) => closeDialog(DialogResult.Ok)}
- *             onCancel={() => closeDialog(DialogResult.Cancelled)}>
- *             <InputTextField value={c => c.name}  title="Name" />
- *             <InputTextField value={c => c.email} title="Email" />
- *         </CommandDialog>
- *     );
- * };
- * ```
- *
- * ## What's special vs. raw Dialog + CommandForm
- *
- * - Confirm wiring (`onConfirm` → `commandInstance.execute()`) is handled
- *   internally; you only supply `onSuccess` / `onValidationFailure` / `onFailed`.
- * - The dialog's `isBusy` state tracks the in-flight command without manual
- *   `useState`.
- * - Field error propagation from `CommandResult.validationResults` to the
- *   form context is automatic.
- *
- * @typeParam TCommand - The command class (proxy generated from C# `[Command]`).
- * @typeParam TResponse - The success payload type returned by the command's `Handle()` method on the backend.
- * @param props - {@link CommandDialogProps}.
- */
 const CommandDialogComponent = (props) => {
     const { title, visible, width, style, contentStyle, resizable, buttons = DialogButtons.OkCancel, initialFocus, okLabel, cancelLabel, yesLabel, noLabel, dismissable, closeAriaLabel, isValid, onClose, onConfirm, onCancel, onBeforeExecute, className, pt, ptOptions, unstyled, children, ...commandFormProps } = props;
-    return (jsx(CommandForm, { ...commandFormProps, children: jsx(CommandDialogWrapper, { title: title, visible: visible, width: width, style: style, contentStyle: contentStyle, resizable: resizable, buttons: buttons, initialFocus: initialFocus, okLabel: okLabel, cancelLabel: cancelLabel, yesLabel: yesLabel, noLabel: noLabel, dismissable: dismissable, closeAriaLabel: closeAriaLabel, isValid: isValid, onClose: onClose, onConfirm: onConfirm, onCancel: onCancel, onSuccess: props.onSuccess, onValidationFailure: props.onValidationFailure, onFailed: props.onFailed, onBeforeExecute: onBeforeExecute, className: className, pt: pt, ptOptions: ptOptions, unstyled: unstyled, children: children }) }));
+    return (jsx(CommandForm, { ...commandFormProps, children: jsx(CommandDialogWrapper, { title: title, visible: visible, width: width, style: style, contentStyle: contentStyle, resizable: resizable, buttons: buttons, initialFocus: initialFocus, okLabel: okLabel, cancelLabel: cancelLabel, yesLabel: yesLabel, noLabel: noLabel, dismissable: dismissable, closeAriaLabel: closeAriaLabel, isValid: isValid, onClose: onClose, onConfirm: onConfirm, onCancel: onCancel, onSuccess: props.onSuccess, onValidationFailure: props.onValidationFailure, onFailed: props.onFailed, onException: props.onException, onUnauthorized: props.onUnauthorized, onBeforeExecute: onBeforeExecute, className: className, pt: pt, ptOptions: ptOptions, unstyled: unstyled, children: children }) }));
 };
 const CommandDialogColumnWrapper = ({ children }) => (jsx(CommandForm.Column, { children: children }));
 markAsCommandFormColumn(CommandDialogColumnWrapper);

package/dist/esm/CommandDialog/CommandDialog.js.map

@@ -1 +1 @@
-{"version":3,"file":"CommandDialog.js","sources":["../../../CommandDialog/CommandDialog.tsx"],"sourcesContent":[null],"names":["_jsx"],"mappings":"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"}
+{"version":3,"file":"CommandDialog.js","sources":["../../../CommandDialog/CommandDialog.tsx"],"sourcesContent":[null],"names":["_jsx"],"mappings":"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"}

package/dist/esm/CommandDialog/CommandStepper.d.ts

@@ -1,45 +1,151 @@
-import React from 'react';
-import type { StepperRootProps } from '@primereact/types/primitive/stepper';
+import React, { type ButtonHTMLAttributes, type HTMLAttributes } from 'react';
 import { type CommandFormProps } from '@cratis/arc.react/commands';
-import { type BeforeExecuteCallback } from './applyBeforeExecute';
+import { type BeforeExecuteCallback } from './applyBeforeExecute.js';
+import { type CommandStepperContentProps } from './CommandStepperContent.js';
+/**
+ * Event passed to {@link StepperCustomizationProps.onChangeStep} when the user
+ * navigates to a different step.
+ */
 export interface StepperChangeEvent {
+    /** Zero-based index of the step being navigated to. */
     index: number;
 }
+/** Orientation of a {@link CommandStepper} / {@link StepperCommandDialog}. */
 export type StepperOrientation = 'horizontal' | 'vertical';
+/** Where the step headers sit relative to the panels. */
 export type StepperHeaderPosition = 'top' | 'bottom';
+/**
+ * Stepper-specific customization surface exposed by {@link CommandStepper} and
+ * {@link StepperCommandDialog}. This is a Cratis-owned type — it no longer
+ * leaks renderer-specific stepper props — so the Cratis-owned Stepper
+ * can evolve underneath without changing the public API. Orientation, start/end
+ * content, and header position are implemented over stable Cratis parts.
+ */
+export interface StepperParts {
+    /** Stepper composition root. */
+    root?: HTMLAttributes<HTMLDivElement>;
+    /** Ordered step-header list. */
+    list?: HTMLAttributes<HTMLOListElement>;
+    /** One step list item and its state attributes. */
+    step?: HTMLAttributes<HTMLLIElement>;
+    /** Interactive step-header button. */
+    header?: ButtonHTMLAttributes<HTMLButtonElement>;
+    /** Step number/status indicator. */
+    number?: HTMLAttributes<HTMLSpanElement>;
+    /** Step title. */
+    title?: HTMLAttributes<HTMLSpanElement>;
+    /** Visual separator between steps. */
+    separator?: HTMLAttributes<HTMLSpanElement>;
+    /** Panels wrapper. */
+    panels?: HTMLAttributes<HTMLDivElement>;
+    /** Active step panel. */
+    panel?: HTMLAttributes<HTMLElement>;
+}
+/** Public layout, navigation, and stable-part customization shared by both steppers. */
 export interface StepperCustomizationProps {
+    /**
+     * Whether the wizard is linear. In linear mode the step headers are not
+     * directly clickable — the user advances through the Previous / Next
+     * buttons. Set to `false` to let the user jump between steps by clicking
+     * their headers. Defaults to `true`.
+     */
     linear?: boolean;
+    /** Lays the steps out horizontally (default) or stacked vertically. */
     orientation?: StepperOrientation;
+    /** Places the step-header row above (default) or below the panels. */
     headerPosition?: StepperHeaderPosition;
+    /** Content rendered before the stepper (e.g. a logo or title). */
     start?: React.ReactNode;
+    /** Content rendered after the stepper. */
     end?: React.ReactNode;
+    /** Invoked when the active step changes (via navigation or a header click). */
     onChangeStep?: (event: StepperChangeEvent) => void;
-    pt?: StepperRootProps['pt'];
-    ptOptions?: StepperRootProps['ptOptions'];
+    /** Cratis-owned per-part attributes for the stepper. */
+    pt?: StepperParts;
+    /**
+     * @deprecated Cratis parts always merge. Remove this renderer-era option.
+     */
+    ptOptions?: object;
+    /**
+     * @deprecated Components always uses consumer-owned CSS. Customize through `pt` and CSS instead.
+     */
     unstyled?: boolean;
 }
-export interface CommandStepperContentProps extends StepperCustomizationProps {
-    activeStep: number;
-    visitedSteps: Set<number>;
-    children?: React.ReactNode;
-    onActiveStepChange?: (stepIndex: number) => void;
-    onVisitedStepsChange?: (visitedSteps: Set<number>) => void;
-    onStepErrorsChange?: (stepErrors: boolean[]) => void;
-    getFieldError?: (fieldName: string) => unknown;
-    showNavigation?: boolean;
-    showSubmit?: boolean;
-    nextLabel?: string;
-    previousLabel?: string;
-    okLabel?: string;
-    isBusy?: boolean;
-    isSubmitting?: boolean;
-    isSubmitDisabled?: boolean;
-    onSubmit?: () => void | Promise<void>;
-}
+/** Props for a standalone stepper bound to one Arc command form. */
 export interface CommandStepperProps<TCommand extends object, TResponse = object> extends Omit<CommandFormProps<TCommand, TResponse>, 'children' | 'onBeforeExecute'>, Omit<CommandStepperContentProps, 'activeStep' | 'visitedSteps' | 'onActiveStepChange' | 'onVisitedStepsChange' | 'getFieldError' | 'isSubmitting' | 'isSubmitDisabled' | 'onSubmit'> {
+    /**
+     * A transformer invoked with the current command values immediately before
+     * the command executes on submit. It **must return** the values to run with
+     * (mutated or not) — a callback that returns nothing does not execute the
+     * command with `undefined`; the current values are kept and a warning is
+     * logged. May be async.
+     *
+     * ⚠️ It runs **only on submit**, after every step has already been validated,
+     * so a value produced here can never satisfy required-field validation. Seed
+     * required values through `initialValues`; reserve `onBeforeExecute` for
+     * transforms that do not affect validity (for example a generated id).
+     */
     onBeforeExecute?: BeforeExecuteCallback<TCommand>;
+    /** StepperPanel children defining each wizard step. */
     children?: React.ReactNode;
 }
-export declare const CommandStepperContent: ({ activeStep, visitedSteps, children, onActiveStepChange, onVisitedStepsChange, onStepErrorsChange, getFieldError, showNavigation, showSubmit, nextLabel, previousLabel, okLabel, isBusy, isSubmitting, isSubmitDisabled, onSubmit, linear, orientation, headerPosition, start, end, onChangeStep, pt, ptOptions, unstyled, }: CommandStepperContentProps) => React.JSX.Element;
+/**
+ * A multi-step wizard backed by a single Cratis Arc command — the embedded,
+ * non-modal counterpart of {@link StepperCommandDialog}. Renders directly
+ * inside a page region (a panel, a route, a wizard view) rather than inside
+ * a modal dialog. Use this when the wizard *is* the page; use
+ * {@link StepperCommandDialog} when the same wizard should appear over the
+ * current page in a modal.
+ *
+ * ## Mechanics
+ *
+ * - Wraps the Cratis-owned Stepper inside an Arc `CommandForm` so each
+ *   `<StepperPanel>` becomes a logical grouping of fields that all bind to
+ *   the same single command.
+ * - Provides a built-in Previous / Next / Submit footer. The Submit button
+ *   only appears on the last step and only when the form passes its
+ *   validity gate.
+ * - Steps with field errors are visually marked (red step indicator) so
+ *   the user can see at a glance which step needs attention — useful in
+ *   wizards long enough that a missed-required-field on page 1 would
+ *   otherwise be hidden behind page 4.
+ * - On final Submit, the bound command runs through Arc's command pipeline.
+ *   Failure paths (`onValidationFailure` / `onFailed`) keep the wizard
+ *   open and re-surface field errors automatically.
+ *
+ * ## What `TCommand` is
+ *
+ * `TCommand` is the auto-generated TypeScript class produced by the Arc
+ * proxy generator from a C# `[Command]` record. The wizard's UI is a
+ * presentation grouping of one command's fields — every panel binds to
+ * properties on the same single command instance.
+ *
+ * ## What's unique vs. {@link StepperCommandDialog}
+ *
+ * Mechanically identical, but lives inline on a page instead of inside a
+ * modal Dialog. There is no `dialogPt` / `dialogUnstyled` prop because
+ * there is no outer dialog — `pt` / `ptOptions` / `unstyled` target the
+ * Stepper directly.
+ *
+ * ```tsx
+ * import { CommandStepper, StepperPanel } from '@cratis/components/CommandDialog';
+ * import { RegisterAuthor } from './RegisterAuthor';   // proxy from C#
+ *
+ * export const RegisterAuthorPage = () => (
+ *     <CommandStepper<RegisterAuthor> command={RegisterAuthor}
+ *                                     onSuccess={() => navigate('/authors')}>
+ *         <StepperPanel header="Basics">
+ *             <InputTextField value={c => c.name} title="Name" />
+ *         </StepperPanel>
+ *         <StepperPanel header="Contact">
+ *             <InputTextField value={c => c.email} title="Email" />
+ *         </StepperPanel>
+ *     </CommandStepper>
+ * );
+ * ```
+ *
+ * @typeParam TCommand - The command class (proxy generated from C# `[Command]`).
+ * @typeParam TResponse - The success payload type returned by the command's `Handle()` method on the backend.
+ * @param props - {@link CommandStepperProps}.
+ */
 export declare const CommandStepper: <TCommand extends object = object, TResponse = object>(props: CommandStepperProps<TCommand, TResponse>) => React.JSX.Element;
-//# sourceMappingURL=CommandStepper.d.ts.map