@homebound/beam 3.105.2 → 3.106.0

package/dist/index.d.cts

@@ -10283,6 +10283,7 @@ type StepperTabProps = {
     /** Whether this step's content has been completed. */
     completed: boolean;
     onClick: (value: string) => void;
+    /** Tab isn't clickable. */
     disabled?: boolean;
     /** Collapses the tab down to its colored bottom border only, hiding the label — for the mobile view */
     collapsed?: boolean;
@@ -10303,8 +10304,8 @@ type WorkflowActionsProps = {
     completeLabel: "Create" | "Save";
     /** Called when the completion button is clicked. */
     onComplete: (e: PressEvent) => void | Promise<void>;
-    /** Disables whichever of Continue/Complete is currently shown, e.g. while the active step is invalid. */
-    primaryDisabled?: boolean;
+    /** Continue/Complete is disabled. A ReactNode is shown in Beam's tooltip. */
+    primaryDisabled?: boolean | ReactNode;
     /** When true, Continue/Complete use the `ai` button variant instead of `primary`. */
     aiMode?: boolean;
     isFirstStep?: boolean;
@@ -10680,8 +10681,8 @@ type PageHeaderLayoutProps<V extends string, X> = {
 declare function PageHeaderLayout<V extends string, X extends Only<TabsContentXss, X>>(props: PageHeaderLayoutProps<V, X>): JSX.Element;
 
 type FocusedFormLayoutProps = Pick<BaseHeaderProps, "title" | "documentTitleSuffix" | "breadcrumbs"> & Pick<WorkflowActionsProps, "onCancel" | "completeLabel" | "onComplete" | "onSaveAndExit"> & {
-    /** Gates the Create/Save CTA. */
-    isValid: boolean;
+    /** Create/Save is disabled. A ReactNode is shown in Beam's tooltip. */
+    primaryDisabled?: WorkflowActionsProps["primaryDisabled"];
     /** Read on Cancel / leave — a callback so flipping dirty does not re-render. */
     isDirty?: () => boolean;
     /** Full-bleed AI wash on the body and the `ai` Create/Save variant. Pair with body `aiMode` (e.g. FormSectionLayout). */
@@ -10697,15 +10698,15 @@ type FocusedFormLayoutProps = Pick<BaseHeaderProps, "title" | "documentTitleSuff
 declare function FocusedFormLayout(props: FocusedFormLayoutProps): JSX.Element;
 
 /**
- * A `StepperLayout` step: a `StepperTabsStep` (minus `value`, which is derived from `label`) plus
- * page content. Stepper chrome marks prior steps complete via current-step index; `isValid` only
- * gates the Continue/Complete CTA for the active step.
+ * A `StepperLayout` step: `StepperTabsStep` (minus `value`) plus page content.
  */
-type StepperLayoutStep = Omit<StepperTabsStep, "value"> & {
+type StepperLayoutStep = Omit<StepperTabsStep, "value" | "disabled"> & {
     /** Rendered as the page body while this is the active step. */
     content: ReactNode;
-    /** Gates Continue/Complete for the active step (form validity) */
-    isValid: boolean;
+    /** Tab isn't clickable. */
+    disabled?: boolean;
+    /** Continue/Complete is disabled. A ReactNode is shown in Beam's tooltip. */
+    primaryDisabled?: boolean | ReactNode;
 };
 type StepperLayoutProps = Pick<BaseHeaderProps, "title" | "documentTitleSuffix" | "breadcrumbs"> & Pick<WorkflowActionsProps, "onCancel" | "completeLabel" | "onComplete" | "onSaveAndExit"> & {
     /** The workflow's steps; the active step's `content` is the body, and it drives the header's tab strip. */

package/dist/index.d.ts

@@ -10283,6 +10283,7 @@ type StepperTabProps = {
     /** Whether this step's content has been completed. */
     completed: boolean;
     onClick: (value: string) => void;
+    /** Tab isn't clickable. */
     disabled?: boolean;
     /** Collapses the tab down to its colored bottom border only, hiding the label — for the mobile view */
     collapsed?: boolean;
@@ -10303,8 +10304,8 @@ type WorkflowActionsProps = {
     completeLabel: "Create" | "Save";
     /** Called when the completion button is clicked. */
     onComplete: (e: PressEvent) => void | Promise<void>;
-    /** Disables whichever of Continue/Complete is currently shown, e.g. while the active step is invalid. */
-    primaryDisabled?: boolean;
+    /** Continue/Complete is disabled. A ReactNode is shown in Beam's tooltip. */
+    primaryDisabled?: boolean | ReactNode;
     /** When true, Continue/Complete use the `ai` button variant instead of `primary`. */
     aiMode?: boolean;
     isFirstStep?: boolean;
@@ -10680,8 +10681,8 @@ type PageHeaderLayoutProps<V extends string, X> = {
 declare function PageHeaderLayout<V extends string, X extends Only<TabsContentXss, X>>(props: PageHeaderLayoutProps<V, X>): JSX.Element;
 
 type FocusedFormLayoutProps = Pick<BaseHeaderProps, "title" | "documentTitleSuffix" | "breadcrumbs"> & Pick<WorkflowActionsProps, "onCancel" | "completeLabel" | "onComplete" | "onSaveAndExit"> & {
-    /** Gates the Create/Save CTA. */
-    isValid: boolean;
+    /** Create/Save is disabled. A ReactNode is shown in Beam's tooltip. */
+    primaryDisabled?: WorkflowActionsProps["primaryDisabled"];
     /** Read on Cancel / leave — a callback so flipping dirty does not re-render. */
     isDirty?: () => boolean;
     /** Full-bleed AI wash on the body and the `ai` Create/Save variant. Pair with body `aiMode` (e.g. FormSectionLayout). */
@@ -10697,15 +10698,15 @@ type FocusedFormLayoutProps = Pick<BaseHeaderProps, "title" | "documentTitleSuff
 declare function FocusedFormLayout(props: FocusedFormLayoutProps): JSX.Element;
 
 /**
- * A `StepperLayout` step: a `StepperTabsStep` (minus `value`, which is derived from `label`) plus
- * page content. Stepper chrome marks prior steps complete via current-step index; `isValid` only
- * gates the Continue/Complete CTA for the active step.
+ * A `StepperLayout` step: `StepperTabsStep` (minus `value`) plus page content.
  */
-type StepperLayoutStep = Omit<StepperTabsStep, "value"> & {
+type StepperLayoutStep = Omit<StepperTabsStep, "value" | "disabled"> & {
     /** Rendered as the page body while this is the active step. */
     content: ReactNode;
-    /** Gates Continue/Complete for the active step (form validity) */
-    isValid: boolean;
+    /** Tab isn't clickable. */
+    disabled?: boolean;
+    /** Continue/Complete is disabled. A ReactNode is shown in Beam's tooltip. */
+    primaryDisabled?: boolean | ReactNode;
 };
 type StepperLayoutProps = Pick<BaseHeaderProps, "title" | "documentTitleSuffix" | "breadcrumbs"> & Pick<WorkflowActionsProps, "onCancel" | "completeLabel" | "onComplete" | "onSaveAndExit"> & {
     /** The workflow's steps; the active step's `content` is the body, and it drives the header's tab strip. */

package/dist/index.js

@@ -28647,7 +28647,17 @@ function WorkflowPageLayout(props) {
 // src/layouts/Workflow/FocusedFormLayout.tsx
 import { jsx as jsx240 } from "react/jsx-runtime";
 function FocusedFormLayout(props) {
-  const { onCancel, completeLabel, onComplete, onSaveAndExit, isValid, isDirty, aiMode, children, ...headerProps } = props;
+  const {
+    onCancel,
+    completeLabel,
+    onComplete,
+    onSaveAndExit,
+    primaryDisabled,
+    isDirty,
+    aiMode,
+    children,
+    ...headerProps
+  } = props;
   const tid = useTestIds(props, "focusedFormLayout");
   return /* @__PURE__ */ jsx240(
     WorkflowPageLayout,
@@ -28660,7 +28670,7 @@ function FocusedFormLayout(props) {
       onSaveAndExit,
       completeLabel,
       onComplete,
-      primaryDisabled: !isValid,
+      primaryDisabled,
       children
     }
   );
@@ -28696,7 +28706,7 @@ function StepperLayout(props) {
       onSaveAndExit,
       completeLabel,
       onComplete,
-      primaryDisabled: !activeStep?.isValid,
+      primaryDisabled: activeStep?.primaryDisabled,
       onContinue: async () => {
         const onContinue = activeStep?.onContinue;
         if (onContinue) {