@harnessio/ui 1.3.7 → 1.3.8

package/dist/index.d.ts

@@ -704,6 +704,12 @@ declare interface CardData extends Omit<CardRootProps, 'title' | 'children'> {
     gripPosition?: 'inside' | 'outside';
 }
 
+declare interface CardEntry {
+    stepId: string;
+    status: CardStatus;
+    stateSnapshot: Record<string, unknown>;
+}
+
 declare interface CardImageProps extends ImgHTMLAttributes<HTMLImageElement> {
     width?: number | string;
     height?: number | string;
@@ -1244,6 +1250,8 @@ declare namespace components {
         SinglePaneStepper,
         SinglePaneStepperRootProps,
         FlowStepperCardProps as SinglePaneStepperCardProps,
+        FlowEngineProvider,
+        useEngineContext,
         AlertRootProps,
         AlertDescriptionProps,
         AlertTitleProps,
@@ -2481,6 +2489,12 @@ declare interface DrawerResult {
     data?: Record<string, unknown>;
 }
 
+declare interface DrawerState {
+    id: string;
+    props?: Record<string, unknown>;
+    resolve: (result: DrawerResult) => void;
+}
+
 declare type DrawerStepProps = {
     value: string;
     title: ReactNode;
@@ -2654,6 +2668,27 @@ declare const encodePath: (path: string) => string;
 
 declare const encodeResourcePath: (resourcePath?: string) => string;
 
+declare interface EngineContextValue {
+    flow: FlowConfig;
+    state: Record<string, unknown>;
+    cardHistory: CardEntry[];
+    activeStepId: string;
+    predictedPath: string[];
+    drawerState: DrawerState | null;
+    pendingReactivation: string | null;
+    complete: (stepId: string, statePatch?: Record<string, unknown>, nextStepId?: string) => void;
+    error: (stepId: string, nextStepId?: string) => void;
+    skip: (stepId: string, nextStepId?: string) => void;
+    openDrawer: (id: string, props?: Record<string, unknown>) => Promise<DrawerResult>;
+    closeDrawer: (result: DrawerResult) => void;
+    requestReactivation: (stepId: string) => void;
+    confirmReactivation: () => void;
+    cancelReactivation: () => void;
+    scrollToCard: (stepId: string) => void;
+    registerScrollToCard: (fn: (stepId: string) => void) => void;
+    disableAutoScroll: boolean;
+}
+
 declare const EntityFormLayout: {
     Header: ({ children, className }: {
         children: ReactNode;
@@ -2947,6 +2982,16 @@ declare interface FlowCardContext<TState = Record<string, unknown>> {
 
 declare type FlowConfig = GroupedFlowConfig | FlatFlowConfig;
 
+declare function FlowEngineProvider({ flow, onComplete, disableAutoScroll, initialEngineState, children }: FlowEngineProviderProps): JSX_2.Element;
+
+declare interface FlowEngineProviderProps {
+    flow: FlowConfig;
+    onComplete?: (state: Record<string, unknown>) => void;
+    disableAutoScroll?: boolean;
+    initialEngineState?: InitialEngineState;
+    children: ReactNode;
+}
+
 declare function FlowStepperCard({ title, description, blockedMessage, children, className }: FlowStepperCardProps): JSX_2.Element;
 
 declare function FlowStepperCardAction({ variant, message, actionLabel, onAction, secondaryLabel, onSecondary }: FlowStepperCardActionProps): JSX_2.Element;
@@ -4186,6 +4231,19 @@ declare type InfoToastSeverity = 'Critical' | 'High' | 'Medium' | 'Low';
 
 declare const INITIAL_ZOOM_LEVEL = 1;
 
+/**
+ * A serialized snapshot of engine state that a host app can pass to `FlowEngineProvider` (or
+ * `SinglePaneStepper.Root`) to resume a flow instead of starting at `flow.initialStep`.
+ *
+ * Canary does not persist this itself — the host app is responsible for storage/validation and
+ * only passes an already-valid snapshot. An unusable snapshot (empty `cardHistory`, or any
+ * `stepId` not present in the current `flow.steps`) is treated as omitted.
+ */
+declare interface InitialEngineState {
+    state: Record<string, unknown>;
+    cardHistory: CardEntry[];
+}
+
 /**
  * A form input component with support for labels, captions, and error messages.
  * @example
@@ -6895,7 +6953,7 @@ declare const SinglePaneStepper: {
     CardAction: typeof FlowStepperCardAction;
 };
 
-declare function SinglePaneStepperRoot({ flow, onComplete, disableAutoScroll, ...props }: SinglePaneStepperRootProps): JSX_2.Element;
+declare function SinglePaneStepperRoot({ flow, onComplete, disableAutoScroll, initialEngineState, children, ...props }: SinglePaneStepperRootProps): JSX_2.Element;
 
 declare interface SinglePaneStepperRootProps {
     flow: FlowConfig;
@@ -6937,6 +6995,11 @@ declare interface SinglePaneStepperRootProps {
     className?: string;
     /** Inline-style escape hatch alongside `className`, for consumers that need computed values. */
     style?: CSSProperties;
+    /** Rendered after the visual content, inside `FlowEngineProvider` — for context-only consumers
+     *  (e.g. a persist bridge) that need engine access without affecting layout. */
+    children?: ReactNode;
+    /** Seeds the engine's state and card history on mount, restoring a previously persisted run. */
+    initialEngineState?: InitialEngineState;
 }
 
 declare const Skeleton: {
@@ -8447,6 +8510,8 @@ declare interface UseDragAndDropProps<T> {
     onReorder?: (items: T[]) => void;
 }
 
+declare function useEngineContext(): EngineContextValue;
+
 declare function useEventListener<K extends keyof HTMLElementEventMap>(type: K, listener: (this: HTMLElement, ev: HTMLElementEventMap[K]) => unknown, element?: HTMLElement, options?: boolean | AddEventListenerOptions, parametersCheck?: () => boolean): void;
 
 declare const useExitConfirm: () => ExitConfirmContextType;

package/dist/index.js

@@ -1,5 +1,5 @@
 import { i as s } from "./index-CdF49wK7.js";
-import { i as e } from "./index-Ci0lYeZK.js";
+import { i as e } from "./index-CekmEi-h.js";
 import { i as a } from "./index-D_eFtVWM.js";
 import { i as m } from "./index-C4bDY5-3.js";
 import { i as f } from "./index-DchZrYRY.js";

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "@harnessio/ui",
   "description": "Harness Canary UI component library",
-  "version": "1.3.7",
+  "version": "1.3.8",
   "private": false,
   "type": "module",
   "main": "./dist/index.js",