@harnessio/ui 1.3.7 → 1.3.8

package/dist/components.d.ts

@@ -692,6 +692,12 @@ export declare interface CardData extends Omit<CardRootProps, 'title' | 'childre
     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;
@@ -1825,6 +1831,12 @@ export declare interface DrawerResult {
     data?: Record<string, unknown>;
 }
 
+declare interface DrawerState {
+    id: string;
+    props?: Record<string, unknown>;
+    resolve: (result: DrawerResult) => void;
+}
+
 export declare type DrawerStepProps = {
     value: string;
     title: ReactNode;
@@ -1984,6 +1996,27 @@ export declare interface DualPaneStepperRootProps {
 
 export declare type EditViewTypeValue = 'edit' | 'preview';
 
+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;
+}
+
 export declare const EntityFormLayout: {
     Header: ({ children, className }: {
         children: ReactNode;
@@ -2257,6 +2290,16 @@ export declare interface FlowCardContext<TState = Record<string, unknown>> {
 
 export declare type FlowConfig = GroupedFlowConfig | FlatFlowConfig;
 
+export 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 }: CardActionProps): JSX_2.Element;
@@ -3307,6 +3350,19 @@ export declare type InfoToastParamsType = {
 
 export declare type InfoToastSeverity = 'Critical' | 'High' | 'Medium' | 'Low';
 
+/**
+ * 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
@@ -5314,7 +5370,7 @@ export 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;
 
 export declare interface SinglePaneStepperRootProps {
     flow: FlowConfig;
@@ -5356,6 +5412,11 @@ export 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;
 }
 
 export declare const Skeleton: {
@@ -6576,6 +6637,8 @@ export declare interface UseCopyButtonProps {
     color?: IconV2Color;
 }
 
+export declare function useEngineContext(): EngineContextValue;
+
 export declare function useFlowCard<TState = Record<string, unknown>>(): FlowCardContext<TState>;
 
 export declare const useFormattedTime: (timestamp?: string | number | null, live?: boolean) => {

package/dist/components.js

@@ -1,7 +1,7 @@
 import { A as e, B as t, k as o, E as r, L as i, r as n, c as l, S as p, s as b, t as c, d as g } from "./index-vAhKHYxB.js";
-import { bQ as m, I as d, k as S, A as T, v as C, w as F, p as I, q as h, bn as D, J as y, bz as L, ae as V, cg as P, Z as A, W as B, bt as M, ao as f, aW as w, aX as x, aZ as v, aY as k, ca as E, ab as G, ac as N, bc as R, B as W, r as H, G as _, an as U, am as O, C as z, _ as K, ai as j, bk as q, g as X, c9 as J, aE as Q, aF as Y, bw as Z, au as $, R as aa, Q as sa, bq as ea, bx as ta, by as oa, aQ as ra, D as ia, j as na, cm as la, br as pa, b_ as ba, $ as ca, bb as ga, ag as ua, f as ma, aj as da, ch as Sa, af as Ta, aI as Ca, aH as Fa, aJ as Ia, aG as ha, ba as Da, bm as ya, a8 as La, bZ as Va, a3 as Pa, a5 as Aa, a4 as Ba, aD as Ma, al as fa, bR as wa, H as xa, F as va, bi as ka, ar as Ea, aa as Ga, ci as Na, Y as Ra, a0 as Wa, bU as Ha, bV as _a, bT as Ua, a1 as Oa, l as za, L as Ka, M as ja, aq as qa, cj as Xa, t as Ja, a2 as Qa, a_ as Ya, a7 as Za, az as $a, ay as as, aM as ss, bs as es, N as ts, aV as os, n as rs, bX as is, cf as ns, P as ls, cl as ps, V as bs, c5 as cs, m as gs, aU as us, at as ms, b6 as ds, b5 as Ss, a$ as Ts, b4 as Cs, b0 as Fs, b1 as Is, b2 as hs, b3 as Ds, ad as ys, b7 as Ls, bl as Vs, bd as Ps, c4 as As, aS as Bs, aR as Ms, cd as fs, c1 as ws, E as xs, bY as vs, x as ks, ce as Es, a9 as Gs, aT as Ns, ax as Rs, b as Ws, bL as Hs, bE as _s, cb as Us, aO as Os, cc as zs, z as Ks, bp as js, S as qs, K as Xs, O as Js, aw as Qs, bo as Ys, c as Zs, aN as $s, bH as ae, bC as se, d as ee, ck as te, bI as oe, bJ as re, av as ie, a as ne, bv as le, T as pe, bj as be, bW as ce, a6 as ge, bO as ue, bg as me, bf as de, bh as Se, c8 as Te, as as Ce, b9 as Fe, bM as Ie, U as he, bB as De, bA as ye, bN as Le, bD as Ve, o as Pe, X as Ae, h as Be, ak as Me, aB as fe, c2 as we, aA as xe, aC as ve, ap as ke, bP as Ee, c0 as Ge, c3 as Ne, cp as Re, cr as We, co as He, cq as _e, bS as Ue, c6 as Oe, aL as ze, aK as Ke, b$ as je, bK as qe, bG as Xe, bF as Je, e as Qe, s as Ye, bu as Ze, c7 as $e, ah as at, cn as st, be as et, b8 as tt, y as ot, u as rt, aP as it } from "./index-Ci0lYeZK.js";
-import { B as lt, x as pt, I as bt, y as ct, r as gt, z as ut, T as mt, v as dt, h as St, E as Tt, F as Ct, w as Ft } from "./button-CYgwQtjJ.js";
-import { L as ht, T as Dt, b as yt, d as Lt, e as Vt, f as Pt, t as At } from "./toggle-group-D7M_epHz.js";
+import { bS as m, K as d, m as S, A as T, w as C, x as F, q as I, r as h, bp as D, O as y, bB as L, ag as V, ci as P, $ as A, Y as B, bv as M, aq as f, aY as w, aZ as x, a$ as v, a_ as E, cc as k, ad as G, ae as N, be as R, E as W, t as H, J as _, ap as U, ao as O, C as z, a0 as K, ak as j, bm as q, g as X, cb as J, aG as Q, aH as Y, by as Z, aw as $, W as aa, V as sa, bs as ea, bz as ta, bA as oa, aS as ra, D as ia, j as na, co as la, bt as pa, c0 as ba, a1 as ca, bd as ga, ai as ua, f as ma, al as da, cj as Sa, ah as Ta, aK as Ca, aJ as Fa, aL as Ia, aI as ha, F as Da, bc as ya, bo as La, aa as Va, b$ as Pa, a5 as Aa, a7 as Ba, a6 as Ma, aF as fa, an as wa, bT as xa, H as va, I as Ea, bk as ka, at as Ga, ac as Na, ck as Ra, _ as Wa, a2 as Ha, bW as _a, bX as Ua, bV as Oa, a3 as za, l as Ka, L as ja, M as qa, as as Xa, cl as Ja, v as Qa, a4 as Ya, b0 as Za, a9 as $a, aB as as, aA as ss, aO as es, bu as ts, N as os, aX as rs, n as is, bZ as ns, ch as ls, P as ps, cn as bs, X as cs, c7 as gs, o as us, aW as ms, av as ds, b8 as Ss, b7 as Ts, b1 as Cs, b6 as Fs, b2 as Is, b3 as hs, b4 as Ds, b5 as ys, af as Ls, b9 as Vs, bn as Ps, bf as As, c6 as Bs, aU as Ms, aT as fs, cf as ws, c3 as xs, G as vs, b_ as Es, y as ks, cg as Gs, ab as Ns, aV as Rs, az as Ws, b as Hs, bN as _s, bG as Us, cd as Os, aQ as zs, ce as Ks, B as js, br as qs, S as Xs, Q as Js, R as Qs, ay as Ys, bq as Zs, c as $s, aP as ae, bJ as se, bE as ee, d as te, cm as oe, bK as re, bL as ie, ax as ne, a as le, bx as pe, T as be, bl as ce, bY as ge, a8 as ue, bQ as me, bi as de, bh as Se, bj as Te, ca as Ce, au as Fe, bb as Ie, bO as he, U as De, bD as ye, bC as Le, bP as Ve, bF as Pe, p as Ae, Z as Be, h as Me, am as fe, aD as we, c4 as xe, aC as ve, aE as Ee, ar as ke, bR as Ge, c2 as Ne, c5 as Re, cr as We, ct as He, cq as _e, cs as Ue, bU as Oe, c8 as ze, aN as Ke, aM as je, c1 as qe, bM as Xe, bI as Je, bH as Qe, e as Ye, s as Ze, bw as $e, c9 as at, aj as st, u as et, cp as tt, bg as ot, ba as rt, z as it, k as nt, aR as lt } from "./index-CekmEi-h.js";
+import { B as bt, x as ct, I as gt, y as ut, r as mt, z as dt, T as St, v as Tt, h as Ct, E as Ft, F as It, w as ht } from "./button-CYgwQtjJ.js";
+import { L as yt, T as Lt, b as Vt, d as Pt, e as At, f as Bt, t as Mt } from "./toggle-group-D7M_epHz.js";
 export {
   m as AccentColor,
   d as Accordion,
@@ -14,7 +14,7 @@ export {
   h as AvatarWithTooltip,
   D as BranchTag,
   y as Breadcrumb,
-  lt as Button,
+  bt as Button,
   L as ButtonGroup,
   t as ButtonLayout,
   V as Calendar,
@@ -26,8 +26,8 @@ export {
   w as Chat,
   x as ChatDiffViewer,
   v as ChatEmptyPreviewWrapper,
-  k as ChatPreviewWrapper,
-  E as ChatV2,
+  E as ChatPreviewWrapper,
+  k as ChatV2,
   G as Checkbox,
   N as CheckboxTree,
   R as CollapseButton,
@@ -70,177 +70,179 @@ export {
   Fa as FilterField,
   Ia as FilterFieldTypes,
   ha as FilterSelect,
-  Da as Folder,
-  ya as ForkTag,
-  La as FormCaption,
-  Va as FormInput,
-  Pa as FormSeparator,
-  Aa as FormWrapper,
-  Ba as FormWrapperContext,
-  Ma as Gauge,
-  fa as GitCommitDialog,
-  wa as GrayColor,
-  xa as HarnessLogo,
-  va as HighlightText,
-  pt as IconNameMapV2,
-  bt as IconV2,
-  ct as IconV2DisplayName,
+  Da as FlowEngineProvider,
+  ya as Folder,
+  La as ForkTag,
+  Va as FormCaption,
+  Pa as FormInput,
+  Aa as FormSeparator,
+  Ba as FormWrapper,
+  Ma as FormWrapperContext,
+  fa as Gauge,
+  wa as GitCommitDialog,
+  xa as GrayColor,
+  va as HarnessLogo,
+  Ea as HighlightText,
+  ct as IconNameMapV2,
+  gt as IconV2,
+  ut as IconV2DisplayName,
   ka as IconWithTooltip,
-  gt as Illustration,
-  ut as IllustrationsNameMap,
-  Ea as ImageCarousel,
-  Ga as Input,
-  Na as InputCaption,
-  Ra as InputOTP,
-  Wa as Label,
-  Ha as Language,
-  _a as LanguageCode,
-  Ua as LanguageDialog,
-  ht as Layout,
-  Oa as Legend,
+  mt as Illustration,
+  dt as IllustrationsNameMap,
+  Ga as ImageCarousel,
+  Na as Input,
+  Ra as InputCaption,
+  Wa as InputOTP,
+  Ha as Label,
+  _a as Language,
+  Ua as LanguageCode,
+  Oa as LanguageDialog,
+  yt as Layout,
+  za as Legend,
   i as Link,
-  za as ListActions,
+  Ka as ListActions,
   n as LogoNameMapV2,
-  Ka as LogoSymbol,
+  ja as LogoSymbol,
   l as LogoV2,
-  ja as ManageNavigation,
-  qa as MarkdownViewer,
-  Xa as MentionTextarea,
-  Ja as MenuGroupTypes,
-  Qa as Message,
-  Ya as MessageBubble,
-  Za as MessageTheme,
-  $a as Meter,
-  as as MeterState,
-  ss as MoreActionsTooltip,
-  es as MultiSelect,
-  ts as NoData,
-  os as NoProblemsFound,
-  rs as NodeGroup,
-  is as NumberInput,
-  ns as Page,
-  ls as Pagination,
-  ps as ParentStepProvider,
-  bs as PathBreadcrumbs,
-  cs as PermissionIdentifier,
-  gs as Popover,
-  us as Problems,
-  ms as Progress,
-  ds as PromptInput,
-  Ss as PromptInputButton,
-  Ts as PromptInputRoot,
-  Cs as PromptInputSubmit,
-  Fs as PromptInputTags,
-  Is as PromptInputTextarea,
-  hs as PromptInputToolbar,
-  Ds as PromptInputTools,
-  ys as Radio,
-  Ls as Reasoning,
-  Vs as ResetTag,
-  Ps as Resizable,
-  As as ResourceType,
-  Bs as SIDEBAR_MAX_WIDTH,
-  Ms as SIDEBAR_MIN_WIDTH,
-  fs as SandboxLayout,
-  ws as ScopeTag,
+  qa as ManageNavigation,
+  Xa as MarkdownViewer,
+  Ja as MentionTextarea,
+  Qa as MenuGroupTypes,
+  Ya as Message,
+  Za as MessageBubble,
+  $a as MessageTheme,
+  as as Meter,
+  ss as MeterState,
+  es as MoreActionsTooltip,
+  ts as MultiSelect,
+  os as NoData,
+  rs as NoProblemsFound,
+  is as NodeGroup,
+  ns as NumberInput,
+  ls as Page,
+  ps as Pagination,
+  bs as ParentStepProvider,
+  cs as PathBreadcrumbs,
+  gs as PermissionIdentifier,
+  us as Popover,
+  ms as Problems,
+  ds as Progress,
+  Ss as PromptInput,
+  Ts as PromptInputButton,
+  Cs as PromptInputRoot,
+  Fs as PromptInputSubmit,
+  Is as PromptInputTags,
+  hs as PromptInputTextarea,
+  Ds as PromptInputToolbar,
+  ys as PromptInputTools,
+  Ls as Radio,
+  Vs as Reasoning,
+  Ps as ResetTag,
+  As as Resizable,
+  Bs as ResourceType,
+  Ms as SIDEBAR_MAX_WIDTH,
+  fs as SIDEBAR_MIN_WIDTH,
+  ws as SandboxLayout,
+  xs as ScopeTag,
   p as ScrollArea,
-  xs as SearchFiles,
-  vs as SearchInput,
+  vs as SearchFiles,
+  Es as SearchInput,
   ks as SearchProvider,
-  Es as SearchableDropdown,
-  Gs as Select,
-  Ns as Separator,
-  Rs as SeveritySlider,
-  Ws as Sheet,
-  Hs as Shimmer,
-  _s as Shortcut,
-  Us as SideNav,
-  Os as Sidebar,
-  zs as SidebarLayout,
-  Ks as SidebarSearch,
-  js as SimpleSort,
-  qs as SinglePaneStepper,
-  Xs as Skeleton,
-  Js as SkeletonFileExplorer,
-  Qs as Slider,
-  Ys as Sort,
-  Zs as Spacer,
-  $s as SplitButton,
-  ae as StackedList,
-  se as StatsPanel,
-  ee as StatusBadge,
-  te as Stepper,
-  oe as StickyListSection,
-  re as StudioCard,
-  ie as Switch,
-  ne as SymbolNameMap,
-  le as Table,
-  pe as Tabs,
-  be as Tag,
-  Dt as Text,
-  ce as TextInput,
-  ge as Textarea,
-  ue as ThemeDialog,
-  me as TimeAgoCard,
-  de as TimeAgoContent,
-  Se as TimeInput,
-  Te as Toaster,
-  yt as Toggle,
-  Lt as ToggleGroup,
-  mt as Tooltip,
-  dt as TooltipProvider,
-  Ce as Topbar,
-  Fe as Tree,
-  Ie as TypingAnimation,
-  he as UserMenuKeys,
-  De as ViewOnly,
-  ye as ViewOnlyItem,
-  Le as WaterfallProgress,
-  Ve as Widgets,
-  Pe as avatarVariants,
-  St as buttonVariants,
-  Ae as cardVariants,
-  Be as counterBadgeVariants,
-  Me as createGitCommitSchema,
-  fe as deriveGaugeStatusLevel,
-  we as determineScope,
-  xe as formatGaugeValue,
-  ve as getGaugeDescriptor,
+  Gs as SearchableDropdown,
+  Ns as Select,
+  Rs as Separator,
+  Ws as SeveritySlider,
+  Hs as Sheet,
+  _s as Shimmer,
+  Us as Shortcut,
+  Os as SideNav,
+  zs as Sidebar,
+  Ks as SidebarLayout,
+  js as SidebarSearch,
+  qs as SimpleSort,
+  Xs as SinglePaneStepper,
+  Js as Skeleton,
+  Qs as SkeletonFileExplorer,
+  Ys as Slider,
+  Zs as Sort,
+  $s as Spacer,
+  ae as SplitButton,
+  se as StackedList,
+  ee as StatsPanel,
+  te as StatusBadge,
+  oe as Stepper,
+  re as StickyListSection,
+  ie as StudioCard,
+  ne as Switch,
+  le as SymbolNameMap,
+  pe as Table,
+  be as Tabs,
+  ce as Tag,
+  Lt as Text,
+  ge as TextInput,
+  ue as Textarea,
+  me as ThemeDialog,
+  de as TimeAgoCard,
+  Se as TimeAgoContent,
+  Te as TimeInput,
+  Ce as Toaster,
+  Vt as Toggle,
+  Pt as ToggleGroup,
+  St as Tooltip,
+  Tt as TooltipProvider,
+  Fe as Topbar,
+  Ie as Tree,
+  he as TypingAnimation,
+  De as UserMenuKeys,
+  ye as ViewOnly,
+  Le as ViewOnlyItem,
+  Ve as WaterfallProgress,
+  Pe as Widgets,
+  Ae as avatarVariants,
+  Ct as buttonVariants,
+  Be as cardVariants,
+  Me as counterBadgeVariants,
+  fe as createGitCommitSchema,
+  we as deriveGaugeStatusLevel,
+  xe as determineScope,
+  ve as formatGaugeValue,
+  Ee as getGaugeDescriptor,
   ke as getIsMarkdown,
-  Ee as getModeColorContrastFromFullTheme,
-  Ge as getScopeType,
-  Ne as getScopedPath,
-  Tt as iconColorVariants,
-  Ct as iconVariants,
-  Re as isFlatFlowConfig,
-  We as isFlatStepConfig,
-  He as isGroupedFlowConfig,
-  _e as isGroupedStepConfig,
-  Ue as languages,
+  Ge as getModeColorContrastFromFullTheme,
+  Ne as getScopeType,
+  Re as getScopedPath,
+  Ft as iconColorVariants,
+  It as iconVariants,
+  We as isFlatFlowConfig,
+  He as isFlatStepConfig,
+  _e as isGroupedFlowConfig,
+  Ue as isGroupedStepConfig,
+  Oe as languages,
   b as linkVariants,
   c as logoVariants,
-  Oe as rbacTooltip,
-  ze as renderFilterSelectAddIconLabel,
-  Ke as renderFilterSelectLabel,
-  je as scopeTypeToIconMap,
-  qe as shimmerVariants,
-  Xe as stackedListItemVariants,
-  Je as stackedListVariants,
-  Qe as statusBadgeVariants,
-  Ye as symbolVariants,
-  Ze as tableVariants,
-  Vt as textVariants,
-  $e as toast,
-  Pt as toggleVariants,
-  At as typographyVariantConfig,
-  at as useCopyButton,
-  st as useFlowCard,
-  et as useFormattedTime,
-  tt as useReasoning,
+  ze as rbacTooltip,
+  Ke as renderFilterSelectAddIconLabel,
+  je as renderFilterSelectLabel,
+  qe as scopeTypeToIconMap,
+  Xe as shimmerVariants,
+  Je as stackedListItemVariants,
+  Qe as stackedListVariants,
+  Ye as statusBadgeVariants,
+  Ze as symbolVariants,
+  $e as tableVariants,
+  At as textVariants,
+  at as toast,
+  Bt as toggleVariants,
+  Mt as typographyVariantConfig,
+  st as useCopyButton,
+  et as useEngineContext,
+  tt as useFlowCard,
+  ot as useFormattedTime,
+  rt as useReasoning,
   g as useScrollArea,
-  ot as useSearch,
-  rt as useSearchableDropdownKeyboardNavigation,
-  it as useSidebar,
-  Ft as withTooltip
+  it as useSearch,
+  nt as useSearchableDropdownKeyboardNavigation,
+  lt as useSidebar,
+  ht as withTooltip
 };
 //# sourceMappingURL=components.js.map