@juo/blocks 1.0.0

package/dist/flows/MockWorkflowApiAdapter.d.ts

@@ -0,0 +1,13 @@
+import { WorkflowApiAdapter } from './WorkflowService';
+/**
+ * Creates a mock WorkflowApiAdapter that simulates the full workflow lifecycle.
+ *
+ * - `start()` begins a flow using predefined step sequences
+ * - `respond()` advances to the next step or completes the flow
+ * - `cancel()` cancels the flow
+ * - `getState()` returns the current state
+ *
+ * Useful for development/testing when Stream 4 (backend) is not yet implemented.
+ */
+export declare function createMockWorkflowApiAdapter(): WorkflowApiAdapter;
+//# sourceMappingURL=MockWorkflowApiAdapter.d.ts.map

package/dist/flows/MockWorkflowApiAdapter.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"MockWorkflowApiAdapter.d.ts","sourceRoot":"","sources":["../../src/flows/MockWorkflowApiAdapter.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EACV,kBAAkB,EAKnB,MAAM,mBAAmB,CAAC;AA4L3B;;;;;;;;;GASG;AACH,wBAAgB,4BAA4B,IAAI,kBAAkB,CA0GjE"}

package/dist/flows/WorkflowService.d.ts

@@ -0,0 +1,175 @@
+import { ReadonlySignal } from '@preact/signals-core';
+import { ThemeState } from '../theme-state';
+export declare const WorkflowServiceContext: {
+    __context__: {
+        state: ReadonlySignal<WorkflowState>;
+        /** True when the portal is running inside the Blocks Editor (editorMode dep
+         *  or ?trigger=... URL param). Consumers use this to suppress auto-start. */
+        isPreviewMode: boolean;
+        isActive: ReadonlySignal<boolean>;
+        isLoading: ReadonlySignal<boolean>;
+        isCompleted: ReadonlySignal<boolean>;
+        hasError: ReadonlySignal<boolean>;
+        canRespond: ReadonlySignal<boolean>;
+        currentInteraction: ReadonlySignal<PendingInteraction | null>;
+        currentStepInfo: ReadonlySignal<WorkflowStepInfo | null>;
+        startFlow(flowType: string, context: Record<string, unknown>, workflowId?: string): Promise<void>;
+        respond(responseType: string, responseData?: Record<string, unknown>): Promise<void>;
+        cancel(): Promise<void>;
+        reset(): void;
+        refresh(): Promise<void>;
+    };
+};
+/**
+ * Mirrors `PendingInteraction` from `@juo/workflows-core`.
+ * Inlined here to avoid a cross-package dependency from blocks -> workflow-core.
+ */
+export interface PendingInteraction {
+    /** Unique per interaction instance (idempotency/stale-response protection) */
+    interactionId: string;
+    stepId: string;
+    actionType: string;
+    actionBehavior: "input";
+    actionConfig: Record<string, unknown>;
+    availableResponses: Array<{
+        type: string;
+        label: string;
+    }>;
+    presentedAt: Date;
+    /** Optional relative timeout duration (milliseconds) */
+    timeoutMs?: number;
+}
+export interface WorkflowOutcome {
+    type: string;
+    message: string;
+}
+export interface WorkflowEndStep {
+    id: string;
+    category?: string;
+    label?: string;
+}
+export interface WorkflowCompletionData {
+    outcome?: WorkflowOutcome;
+    endStep?: WorkflowEndStep;
+}
+export type WorkflowStatus = "idle" | "loading" | "active" | "completed" | "error";
+export interface WorkflowState {
+    status: WorkflowStatus;
+    flowType: string | null;
+    workflowId: string | null;
+    workflowVersion: number | null;
+    runId: string | null;
+    runVersion: number | null;
+    currentStepId: string | null;
+    currentInteraction: PendingInteraction | null;
+    error: string | null;
+    result: Record<string, unknown> | null;
+    /** Parameters passed to startFlow (e.g. { layout: 'modal' | 'sidebar' }) */
+    flowParams: Record<string, unknown> | null;
+    /** Accumulated resources invalidated by actions across all responses in this flow. */
+    invalidatedResources: string[];
+    /** Describes the primary action taken when the workflow completes.
+     *  Used to show a confirmation toast (e.g. "Your subscription has been cancelled"). */
+    outcome: WorkflowOutcome | null;
+    /** Persisted completion metadata: outcome and the End node reached. */
+    completionData: WorkflowCompletionData | null;
+    dryRun: boolean | null;
+}
+/** Available steps metadata (for rendering and editor) */
+export interface WorkflowStepInfo {
+    interactionId: string;
+    stepId: string;
+    actionType: string;
+    actionConfig: Record<string, unknown>;
+    availableResponses: Array<{
+        type: string;
+        label: string;
+    }>;
+}
+/**
+ * Lightweight step definition (no per-instance interactionId).
+ * Used by `interactiveSteps` to describe the full set of input steps
+ * in a workflow so the root block can pre-populate all slots and presets.
+ */
+export interface WorkflowStepDefinition {
+    stepId: string;
+    actionType: string;
+    actionConfig: Record<string, unknown>;
+    availableResponses: Array<{
+        type: string;
+        label: string;
+    }>;
+}
+export type WorkflowStartResponse = {
+    status: "no_workflow";
+} | {
+    status: "completed_silently";
+    invalidatedResources?: string[];
+    outcome?: WorkflowOutcome;
+    completionData?: WorkflowCompletionData;
+} | WorkflowRunState;
+export interface WorkflowRunState {
+    workflowId: string;
+    workflowVersion: number;
+    runId: string;
+    runVersion: number;
+    status: "running" | "waiting_interaction" | "completed" | "failed" | "cancelled";
+    pendingInteraction?: PendingInteraction;
+    /** All interactive (input) steps in this workflow, in order.
+     *  Provided on start() so the client can pre-populate all root block slots and editor presets. */
+    interactiveSteps?: WorkflowStepDefinition[];
+    result?: Record<string, unknown>;
+    error?: {
+        message: string;
+        code?: string;
+    };
+    /** Resources invalidated by actions executed during this response (e.g. ["subscription"]). */
+    invalidatedResources?: string[];
+    outcome?: WorkflowOutcome;
+    completionData?: WorkflowCompletionData;
+}
+/**
+ * API adapter interface for WorkflowService.
+ * Allows different implementations (real API, mocked, etc.)
+ */
+export interface WorkflowApiAdapter {
+    start(flowType: string, context: Record<string, unknown>, workflowId?: string, dryRun?: boolean): Promise<WorkflowStartResponse>;
+    respond(runId: string, interactionId: string, responseType: string, responseData?: Record<string, unknown>, expectedRunVersion?: number, eventId?: string): Promise<WorkflowRunState>;
+    getState(runId: string): Promise<WorkflowRunState>;
+    cancel(runId: string): Promise<WorkflowRunState>;
+}
+/**
+ * Create a real API adapter for the Customer API.
+ */
+export declare function createWorkflowApiAdapter(sdk: {
+    get: any;
+    post: any;
+}): WorkflowApiAdapter;
+export interface WorkflowServiceDependencies {
+    /** API adapter for communicating with backend */
+    api: WorkflowApiAdapter;
+    /** ThemeState context for resolving the started workflow */
+    themeState: ThemeState;
+    /** Shop currency code (e.g. "USD", "EUR"). Injected into actionConfig for blocks that display monetary values. */
+    shopCurrencyCode?: string;
+}
+export declare function createWorkflowService(deps: WorkflowServiceDependencies): {
+    state: ReadonlySignal<WorkflowState>;
+    /** True when the portal is running inside the Blocks Editor (editorMode dep
+     *  or ?trigger=... URL param). Consumers use this to suppress auto-start. */
+    isPreviewMode: boolean;
+    isActive: ReadonlySignal<boolean>;
+    isLoading: ReadonlySignal<boolean>;
+    isCompleted: ReadonlySignal<boolean>;
+    hasError: ReadonlySignal<boolean>;
+    canRespond: ReadonlySignal<boolean>;
+    currentInteraction: ReadonlySignal<PendingInteraction | null>;
+    currentStepInfo: ReadonlySignal<WorkflowStepInfo | null>;
+    startFlow(flowType: string, context: Record<string, unknown>, workflowId?: string): Promise<void>;
+    respond(responseType: string, responseData?: Record<string, unknown>): Promise<void>;
+    cancel(): Promise<void>;
+    reset(): void;
+    refresh(): Promise<void>;
+};
+export type WorkflowService = ReturnType<typeof createWorkflowService>;
+//# sourceMappingURL=WorkflowService.d.ts.map

package/dist/flows/WorkflowService.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"WorkflowService.d.ts","sourceRoot":"","sources":["../../src/flows/WorkflowService.ts"],"names":[],"mappings":"AAAA,OAAO,EAAoB,KAAK,cAAc,EAAE,MAAM,sBAAsB,CAAC;AAG7E,OAAO,EAAE,UAAU,EAAE,MAAM,gBAAgB,CAAC;AAS5C,eAAO,MAAM,sBAAsB;;eAijBd,cAAc,CAAC,aAAa,CAAC;QAE9C;qFAC6E;;;;;;;;;4BAcjE,MAAM,WACP,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,eACnB,MAAM,GAClB,OAAO,CAAC,IAAI,CAAC;8BAwDA,MAAM,iBACL,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GACrC,OAAO,CAAC,IAAI,CAAC;kBAuBA,OAAO,CAAC,IAAI,CAAC;iBA4CpB,IAAI;mBAoBI,OAAO,CAAC,IAAI,CAAC;;CArtBmB,CAAC;AAMtD;;;GAGG;AACH,MAAM,WAAW,kBAAkB;IACjC,8EAA8E;IAC9E,aAAa,EAAE,MAAM,CAAC;IACtB,MAAM,EAAE,MAAM,CAAC;IACf,UAAU,EAAE,MAAM,CAAC;IACnB,cAAc,EAAE,OAAO,CAAC;IACxB,YAAY,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IACtC,kBAAkB,EAAE,KAAK,CAAC;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,KAAK,EAAE,MAAM,CAAA;KAAE,CAAC,CAAC;IAC3D,WAAW,EAAE,IAAI,CAAC;IAClB,wDAAwD;IACxD,SAAS,CAAC,EAAE,MAAM,CAAC;CACpB;AAED,MAAM,WAAW,eAAe;IAC9B,IAAI,EAAE,MAAM,CAAC;IACb,OAAO,EAAE,MAAM,CAAC;CACjB;AAED,MAAM,WAAW,eAAe;IAC9B,EAAE,EAAE,MAAM,CAAC;IACX,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,KAAK,CAAC,EAAE,MAAM,CAAC;CAChB;AAED,MAAM,WAAW,sBAAsB;IACrC,OAAO,CAAC,EAAE,eAAe,CAAC;IAC1B,OAAO,CAAC,EAAE,eAAe,CAAC;CAC3B;AAED,MAAM,MAAM,cAAc,GACtB,MAAM,GACN,SAAS,GACT,QAAQ,GACR,WAAW,GACX,OAAO,CAAC;AAEZ,MAAM,WAAW,aAAa;IAC5B,MAAM,EAAE,cAAc,CAAC;IACvB,QAAQ,EAAE,MAAM,GAAG,IAAI,CAAC;IACxB,UAAU,EAAE,MAAM,GAAG,IAAI,CAAC;IAC1B,eAAe,EAAE,MAAM,GAAG,IAAI,CAAC;IAC/B,KAAK,EAAE,MAAM,GAAG,IAAI,CAAC;IACrB,UAAU,EAAE,MAAM,GAAG,IAAI,CAAC;IAC1B,aAAa,EAAE,MAAM,GAAG,IAAI,CAAC;IAC7B,kBAAkB,EAAE,kBAAkB,GAAG,IAAI,CAAC;IAC9C,KAAK,EAAE,MAAM,GAAG,IAAI,CAAC;IACrB,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,IAAI,CAAC;IACvC,4EAA4E;IAC5E,UAAU,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,IAAI,CAAC;IAC3C,sFAAsF;IACtF,oBAAoB,EAAE,MAAM,EAAE,CAAC;IAC/B;2FACuF;IACvF,OAAO,EAAE,eAAe,GAAG,IAAI,CAAC;IAChC,uEAAuE;IACvE,cAAc,EAAE,sBAAsB,GAAG,IAAI,CAAC;IAC9C,MAAM,EAAE,OAAO,GAAG,IAAI,CAAC;CACxB;AAED,0DAA0D;AAC1D,MAAM,WAAW,gBAAgB;IAC/B,aAAa,EAAE,MAAM,CAAC;IACtB,MAAM,EAAE,MAAM,CAAC;IACf,UAAU,EAAE,MAAM,CAAC;IACnB,YAAY,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IACtC,kBAAkB,EAAE,KAAK,CAAC;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,KAAK,EAAE,MAAM,CAAA;KAAE,CAAC,CAAC;CAC5D;AAED;;;;GAIG;AACH,MAAM,WAAW,sBAAsB;IACrC,MAAM,EAAE,MAAM,CAAC;IACf,UAAU,EAAE,MAAM,CAAC;IACnB,YAAY,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IACtC,kBAAkB,EAAE,KAAK,CAAC;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,KAAK,EAAE,MAAM,CAAA;KAAE,CAAC,CAAC;CAC5D;AAED,MAAM,MAAM,qBAAqB,GAC7B;IAAE,MAAM,EAAE,aAAa,CAAA;CAAE,GACzB;IACE,MAAM,EAAE,oBAAoB,CAAC;IAC7B,oBAAoB,CAAC,EAAE,MAAM,EAAE,CAAC;IAChC,OAAO,CAAC,EAAE,eAAe,CAAC;IAC1B,cAAc,CAAC,EAAE,sBAAsB,CAAC;CACzC,GACD,gBAAgB,CAAC;AAErB,MAAM,WAAW,gBAAgB;IAC/B,UAAU,EAAE,MAAM,CAAC;IACnB,eAAe,EAAE,MAAM,CAAC;IACxB,KAAK,EAAE,MAAM,CAAC;IACd,UAAU,EAAE,MAAM,CAAC;IACnB,MAAM,EACF,SAAS,GACT,qBAAqB,GACrB,WAAW,GACX,QAAQ,GACR,WAAW,CAAC;IAChB,kBAAkB,CAAC,EAAE,kBAAkB,CAAC;IACxC;sGACkG;IAClG,gBAAgB,CAAC,EAAE,sBAAsB,EAAE,CAAC;IAC5C,MAAM,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IACjC,KAAK,CAAC,EAAE;QAAE,OAAO,EAAE,MAAM,CAAC;QAAC,IAAI,CAAC,EAAE,MAAM,CAAA;KAAE,CAAC;IAC3C,8FAA8F;IAC9F,oBAAoB,CAAC,EAAE,MAAM,EAAE,CAAC;IAChC,OAAO,CAAC,EAAE,eAAe,CAAC;IAC1B,cAAc,CAAC,EAAE,sBAAsB,CAAC;CACzC;AAMD;;;GAGG;AACH,MAAM,WAAW,kBAAkB;IACjC,KAAK,CACH,QAAQ,EAAE,MAAM,EAChB,OAAO,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAChC,UAAU,CAAC,EAAE,MAAM,EACnB,MAAM,CAAC,EAAE,OAAO,GACf,OAAO,CAAC,qBAAqB,CAAC,CAAC;IAClC,OAAO,CACL,KAAK,EAAE,MAAM,EACb,aAAa,EAAE,MAAM,EACrB,YAAY,EAAE,MAAM,EACpB,YAAY,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EACtC,kBAAkB,CAAC,EAAE,MAAM,EAC3B,OAAO,CAAC,EAAE,MAAM,GACf,OAAO,CAAC,gBAAgB,CAAC,CAAC;IAC7B,QAAQ,CAAC,KAAK,EAAE,MAAM,GAAG,OAAO,CAAC,gBAAgB,CAAC,CAAC;IACnD,MAAM,CAAC,KAAK,EAAE,MAAM,GAAG,OAAO,CAAC,gBAAgB,CAAC,CAAC;CAClD;AAED;;GAEG;AACH,wBAAgB,wBAAwB,CAAC,GAAG,EAAE;IAC5C,GAAG,EAAE,GAAG,CAAC;IACT,IAAI,EAAE,GAAG,CAAC;CACX,GAAG,kBAAkB,CAgDrB;AAMD,MAAM,WAAW,2BAA2B;IAC1C,iDAAiD;IACjD,GAAG,EAAE,kBAAkB,CAAC;IACxB,4DAA4D;IAC5D,UAAU,EAAE,UAAU,CAAC;IACvB,kHAAkH;IAClH,gBAAgB,CAAC,EAAE,MAAM,CAAC;CAC3B;AAMD,wBAAgB,qBAAqB,CAAC,IAAI,EAAE,2BAA2B;WAiVlD,cAAc,CAAC,aAAa,CAAC;IAE9C;iFAC6E;;;;;;;;;wBAcjE,MAAM,WACP,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,eACnB,MAAM,GAClB,OAAO,CAAC,IAAI,CAAC;0BAwDA,MAAM,iBACL,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GACrC,OAAO,CAAC,IAAI,CAAC;cAuBA,OAAO,CAAC,IAAI,CAAC;aA4CpB,IAAI;eAoBI,OAAO,CAAC,IAAI,CAAC;EAsBjC;AAED,MAAM,MAAM,eAAe,GAAG,UAAU,CAAC,OAAO,qBAAqB,CAAC,CAAC"}

package/dist/flows/__tests__/WorkflowService.test.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=WorkflowService.test.d.ts.map

package/dist/flows/__tests__/WorkflowService.test.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"WorkflowService.test.d.ts","sourceRoot":"","sources":["../../../src/flows/__tests__/WorkflowService.test.ts"],"names":[],"mappings":""}

package/dist/flows/__tests__/defaults.test.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=defaults.test.d.ts.map

package/dist/flows/__tests__/defaults.test.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"defaults.test.d.ts","sourceRoot":"","sources":["../../../src/flows/__tests__/defaults.test.ts"],"names":[],"mappings":""}

package/dist/flows/__tests__/juo-workflow.test.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=juo-workflow.test.d.ts.map

package/dist/flows/__tests__/juo-workflow.test.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"juo-workflow.test.d.ts","sourceRoot":"","sources":["../../../src/flows/__tests__/juo-workflow.test.ts"],"names":[],"mappings":""}

package/dist/flows/__tests__/overlay-behavior.test.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=overlay-behavior.test.d.ts.map

package/dist/flows/__tests__/overlay-behavior.test.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"overlay-behavior.test.d.ts","sourceRoot":"","sources":["../../../src/flows/__tests__/overlay-behavior.test.ts"],"names":[],"mappings":""}

package/dist/flows/__tests__/theme-state-surfaces.test.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=theme-state-surfaces.test.d.ts.map

package/dist/flows/__tests__/theme-state-surfaces.test.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"theme-state-surfaces.test.d.ts","sourceRoot":"","sources":["../../../src/flows/__tests__/theme-state-surfaces.test.ts"],"names":[],"mappings":""}

package/dist/flows/defaults.d.ts

@@ -0,0 +1,15 @@
+import { Block } from '../block';
+/**
+ * Get default block for a flow step based on action type.
+ * Looks for a registered block with name `action:<actionType>`.
+ *
+ * Used by:
+ * - <juo-workflow> for rendering current step
+ * - BlocksWorkflowInitializer when no custom block is defined for a step
+ */
+export declare function getDefaultBlockForAction(actionType: string, actionConfig: Record<string, unknown>, blockId?: string): Block;
+/**
+ * Check if a default block exists for an action type.
+ */
+export declare function hasDefaultBlockForAction(actionType: string): boolean;
+//# sourceMappingURL=defaults.d.ts.map

package/dist/flows/defaults.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"defaults.d.ts","sourceRoot":"","sources":["../../src/flows/defaults.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,KAAK,EAAE,MAAM,UAAU,CAAC;AAEtC;;;;;;;GAOG;AACH,wBAAgB,wBAAwB,CACtC,UAAU,EAAE,MAAM,EAClB,YAAY,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EACrC,OAAO,CAAC,EAAE,MAAM,GACf,KAAK,CAcP;AAED;;GAEG;AACH,wBAAgB,wBAAwB,CAAC,UAAU,EAAE,MAAM,GAAG,OAAO,CAGpE"}

package/dist/flows/index.d.ts

@@ -0,0 +1,4 @@
+export { createWorkflowService, createWorkflowApiAdapter, WorkflowServiceContext, type PendingInteraction, type WorkflowService, type WorkflowApiAdapter, type WorkflowServiceDependencies, type WorkflowState, type WorkflowStatus, type WorkflowStepInfo, type WorkflowStepDefinition, type WorkflowStartResponse, type WorkflowRunState, type WorkflowOutcome, type WorkflowEndStep, type WorkflowCompletionData, } from './WorkflowService';
+export { getDefaultBlockForAction, hasDefaultBlockForAction, } from './defaults';
+export { createMockWorkflowApiAdapter } from './MockWorkflowApiAdapter';
+//# sourceMappingURL=index.d.ts.map

package/dist/flows/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/flows/index.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,qBAAqB,EACrB,wBAAwB,EACxB,sBAAsB,EACtB,KAAK,kBAAkB,EACvB,KAAK,eAAe,EACpB,KAAK,kBAAkB,EACvB,KAAK,2BAA2B,EAChC,KAAK,aAAa,EAClB,KAAK,cAAc,EACnB,KAAK,gBAAgB,EACrB,KAAK,sBAAsB,EAC3B,KAAK,qBAAqB,EAC1B,KAAK,gBAAgB,EACrB,KAAK,eAAe,EACpB,KAAK,eAAe,EACpB,KAAK,sBAAsB,GAC5B,MAAM,mBAAmB,CAAC;AAE3B,OAAO,EACL,wBAAwB,EACxB,wBAAwB,GACzB,MAAM,YAAY,CAAC;AAEpB,OAAO,EAAE,4BAA4B,EAAE,MAAM,0BAA0B,CAAC;AAGxE,OAAO,gBAAgB,CAAC"}

package/dist/flows/juo-workflow.d.ts

@@ -0,0 +1,48 @@
+/**
+ * <juo-workflow> web component
+ *
+ * Renders the current workflow step by:
+ * 1. Subscribing to WorkflowServiceContext
+ * 2. Watching state (status + currentStepInfo) changes
+ * 3. For active/loading state with a step: renders <juo-extension-root surface="overlay" name="<stepId>">
+ *    - The step is kept mounted during `loading` so button processing state is preserved
+ *      while the respond API call is in flight.
+ *    - The DOM is only replaced when the step ID actually changes.
+ * 4. For all other states: clears content
+ *    - `completed`: unloads content; the portal handles teardown
+ *    - `error`: dispatches a `juo-workflow-error` CustomEvent for the portal to handle
+ *
+ * The `name` attribute on juo-extension-root corresponds to the current step ID.
+ * The `surface="overlay"` attribute selects ThemeStateContext.overlay blocks.
+ * Block resolution (default vs custom) is handled by BlocksWorkflowInitializer
+ * which updates ThemeStateContext.overlay with the appropriate blocks.
+ *
+ * Usage:
+ * <juo-workflow></juo-workflow>
+ *
+ * Must be placed inside an element where WorkflowServiceContext is provided.
+ *
+ * The `blockWrapper` property accepts an optional function:
+ *   (rendered: HTMLElement) => HTMLElement
+ * When provided, it is called to wrap each rendered block element.
+ * This allows the parent (e.g. WorkflowOverlay) to inject a sidebar/modal container
+ * inside the block wrapper, producing:
+ *   juo-editor-block-wrapper -> [blockWrapper result] -> actual block
+ */
+export declare class JuoWorkflowElement extends HTMLElement {
+    private workflowService;
+    private unsubscribeContext;
+    private unsubscribeEffect;
+    /** Tracks which step is currently mounted to avoid unnecessary DOM teardown. */
+    private renderedStepId;
+    /**
+     * Optional function to wrap rendered content (step blocks).
+     * Must be set before workflow becomes active for correct behavior.
+     */
+    blockWrapper: ((rendered: HTMLElement) => HTMLElement) | null;
+    connectedCallback(): void;
+    disconnectedCallback(): void;
+    private setupSubscription;
+    private render;
+}
+//# sourceMappingURL=juo-workflow.d.ts.map

package/dist/flows/juo-workflow.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"juo-workflow.d.ts","sourceRoot":"","sources":["../../src/flows/juo-workflow.ts"],"names":[],"mappings":"AASA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA8BG;AACH,qBAAa,kBAAmB,SAAQ,WAAW;IACjD,OAAO,CAAC,eAAe,CAAgC;IACvD,OAAO,CAAC,kBAAkB,CAA6B;IACvD,OAAO,CAAC,iBAAiB,CAA6B;IACtD,gFAAgF;IAChF,OAAO,CAAC,cAAc,CAAuB;IAE7C;;;OAGG;IACI,YAAY,EAAE,CAAC,CAAC,QAAQ,EAAE,WAAW,KAAK,WAAW,CAAC,GAAG,IAAI,CAAQ;IAE5E,iBAAiB;IAYjB,oBAAoB;IAQpB,OAAO,CAAC,iBAAiB;IAsBzB,OAAO,CAAC,MAAM;CAkCf"}