@harnessio/ui 1.3.5 → 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
@@ -4587,6 +4645,7 @@ declare const LogoNameMapV2: {
     git: FunctionComponent<SVGProps<SVGSVGElement>>;
     gitea: FunctionComponent<SVGProps<SVGSVGElement>>;
     'github-action': FunctionComponent<SVGProps<SVGSVGElement>>;
+    'github-copilot': FunctionComponent<SVGProps<SVGSVGElement>>;
     github: FunctionComponent<SVGProps<SVGSVGElement>>;
     gitlab: FunctionComponent<SVGProps<SVGSVGElement>>;
     gitleaks: FunctionComponent<SVGProps<SVGSVGElement>>;
@@ -6894,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;
@@ -6936,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: {
@@ -7505,6 +7569,7 @@ declare const SymbolNameMap: {
     git: FunctionComponent<SVGProps<SVGSVGElement>>;
     gitea: FunctionComponent<SVGProps<SVGSVGElement>>;
     'github-action': FunctionComponent<SVGProps<SVGSVGElement>>;
+    'github-copilot': FunctionComponent<SVGProps<SVGSVGElement>>;
     github: FunctionComponent<SVGProps<SVGSVGElement>>;
     gitlab: FunctionComponent<SVGProps<SVGSVGElement>>;
     gitleaks: FunctionComponent<SVGProps<SVGSVGElement>>;
@@ -8445,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,6 +1,6 @@
 import { i as s } from "./index-CdF49wK7.js";
-import { i as e } from "./index-Bu5LDmmA.js";
-import { i as a } from "./index-0ZqzQJGx.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";
 import { i as l } from "./index-Bvis3lzj.js";

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "@harnessio/ui",
   "description": "Harness Canary UI component library",
-  "version": "1.3.5",
+  "version": "1.3.8",
   "private": false,
   "type": "module",
   "main": "./dist/index.js",
@@ -123,8 +123,8 @@
     "yaml": "^2.7.0",
     "zod": "^4.0.0",
     "@harnessio/core-design-system": "0.0.1",
-    "@harnessio/pipeline-graph": "1.9.7",
-    "@harnessio/yaml-editor": "0.26.1"
+    "@harnessio/yaml-editor": "0.26.1",
+    "@harnessio/pipeline-graph": "1.9.7"
   },
   "peerDependencies": {
     "react": "^17.0.2",