@tetrascience-npm/tetrascience-react-ui 0.5.0-beta.65.1 → 0.5.0-beta.67.1

package/dist/index.d.ts

@@ -12,6 +12,7 @@ import { ColumnOrderState } from '@tanstack/react-table';
 import { Combobox as Combobox_2 } from '@base-ui/react';
 import { Command as Command_2 } from 'cmdk';
 import { ComponentProps } from 'react';
+import { ComponentPropsWithoutRef } from 'react';
 import { Context as Context_2 } from 'react';
 import { ContextMenu as ContextMenu_2 } from 'radix-ui';
 import { DayButton } from 'react-day-picker';
@@ -35,6 +36,7 @@ import { Locale } from 'react-day-picker';
 import { LucideIcon } from 'lucide-react';
 import { MemoExoticComponent } from 'react';
 import { Menubar as Menubar_2 } from 'radix-ui';
+import { MouseEvent as MouseEvent_2 } from 'react';
 import { NavigationMenu as NavigationMenu_2 } from 'radix-ui';
 import { OnChange } from '@monaco-editor/react';
 import { OTPInput } from 'input-otp';
@@ -2569,6 +2571,103 @@ export declare function PopoverTrigger({ ...props }: React_2.ComponentProps<type
 
 export declare function pos(row: number, col: number, columns: number): WellId;
 
+/**
+ * Runtime list of the visual states supported by ProcessFlow steps.
+ * Use this for controls, schemas, and forms that need to present the same status values the component understands.
+ */
+export declare const PROCESS_FLOW_STEP_STATUSES: readonly ["pending", "active", "completed", "error", "disabled"];
+
+export declare function ProcessFlow({ steps, connections, selectedStepId, onStepSelect, orientation, size, showDescriptions, className, style, "aria-label": ariaLabel, ...props }: ProcessFlowProps): JSX.Element | null;
+
+/** Connection between two steps in a branching/configurable flow. Linear flows derive connections automatically. */
+export declare interface ProcessFlowConnection {
+    id?: string;
+    from: string;
+    to: string;
+    status?: ProcessFlowStepStatus;
+    ariaLabel?: string;
+}
+
+/** Direction for linear process flows. Branching flows are configured with step positions and connections. */
+export declare type ProcessFlowOrientation = "horizontal" | "vertical";
+
+/**
+ * Presentational process flow.
+ *
+ * ProcessFlow is fully controlled by props. It visualizes parent-owned workflow state and emits user selection through
+ * onStepSelect. It intentionally does not own status transitions or fire completion/error side effects.
+ */
+export declare interface ProcessFlowProps extends Omit<ComponentPropsWithoutRef<"nav">, "onSelect"> {
+    /** Ordered list of steps to render. Each step controls its own visual status. */
+    steps: ProcessFlowStep[];
+    /** Optional explicit connections for branching/configurable flows. */
+    connections?: ProcessFlowConnection[];
+    /** Selected/viewed step id. This is separate from the active workflow status. */
+    selectedStepId?: string;
+    /** Called when a selectable step is clicked. Disabled and non-selectable steps do not call this. */
+    onStepSelect?: (step: ProcessFlowStep, details: ProcessFlowStepSelectDetails) => void;
+    orientation?: ProcessFlowOrientation;
+    size?: ProcessFlowSize;
+    /** Defaults to true. Set to false to hide step descriptions. */
+    showDescriptions?: boolean;
+}
+
+/** Visual density of the process flow. */
+export declare type ProcessFlowSize = "default" | "compact";
+
+/**
+ * Configurable step rendered by ProcessFlow.
+ *
+ * Keep workflow-specific behavior in the parent. A step config should describe what to render, not what to do when a
+ * workflow completes or errors.
+ */
+export declare interface ProcessFlowStep {
+    /** Stable identifier used for selection and connections. */
+    id: string;
+    /** Visible step label. */
+    label: ReactNode;
+    /** Optional secondary text shown under or beside the label. */
+    description?: ReactNode;
+    /** Parent-controlled visual state. Defaults to "pending". */
+    status?: ProcessFlowStepStatus;
+    /** Accessible label for selectable steps. */
+    ariaLabel?: string;
+    /** Forces the step into the disabled visual/non-interactive state. */
+    disabled?: boolean;
+    /** Set to false when the step should render as non-navigable even when onStepSelect is provided. */
+    selectable?: boolean;
+    /** Optional grid position for simple branching/configurable layouts. */
+    position?: ProcessFlowStepPosition;
+}
+
+export declare type ProcessFlowStepConfig = ProcessFlowStep;
+
+export declare interface ProcessFlowStepPosition {
+    /** Zero-based row used when rendering a simple branching/configurable flow. */
+    row?: number;
+    /** Zero-based column used when rendering a simple branching/configurable flow. */
+    column?: number;
+}
+
+export declare interface ProcessFlowStepSelectDetails {
+    /** Zero-based index of the selected step in the steps prop. */
+    stepIndex: number;
+    /** Current visual status of the selected step. */
+    status: ProcessFlowStepStatus;
+    nativeEvent: MouseEvent_2<HTMLButtonElement>;
+}
+
+/**
+ * Visual state for a ProcessFlow step.
+ *
+ * The parent application owns this state. ProcessFlow renders the provided status and does not run workflow side effects.
+ */
+export declare type ProcessFlowStepStatus = (typeof PROCESS_FLOW_STEP_STATUSES)[number];
+
+export declare type ProcessStep = ProcessFlowStep;
+
+export declare type ProcessStepStatus = ProcessFlowStepStatus;
+
 export declare const PromptInput: ({ className, accept, multiple, globalDrop, syncHiddenInput, maxFiles, maxFileSize, onError, onSubmit, children, ...props }: PromptInputProps) => JSX.Element;
 
 export declare const PromptInputActionAddAttachments: ({ label, ...props }: PromptInputActionAddAttachmentsProps) => JSX.Element;