@flowsterix/core 0.1.0

package/dist/state.d.ts

@@ -0,0 +1,15 @@
+import type { EventBus } from './events';
+import type { StorageAdapter } from './storage';
+import type { FlowAnalyticsHandlers, FlowDefinition, FlowEvents, FlowStore, VersionMismatchInfo } from './types';
+export interface FlowStoreOptions<TContent = unknown> {
+    storageAdapter?: StorageAdapter;
+    storageKey?: string;
+    eventBus?: EventBus<FlowEvents<TContent>>;
+    now?: () => number;
+    persistOnChange?: boolean;
+    analytics?: FlowAnalyticsHandlers<TContent>;
+    /** Callback when a version mismatch is detected and resolved */
+    onVersionMismatch?: (info: VersionMismatchInfo) => void;
+}
+export declare const createFlowStore: <TContent>(definition: FlowDefinition<TContent>, flowOptions?: FlowStoreOptions<TContent>) => FlowStore<TContent>;
+//# sourceMappingURL=state.d.ts.map

package/dist/state.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"state.d.ts","sourceRoot":"","sources":["../src/state.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,UAAU,CAAA;AAExC,OAAO,KAAK,EAAE,cAAc,EAAmB,MAAM,WAAW,CAAA;AAEhE,OAAO,KAAK,EACV,qBAAqB,EAErB,cAAc,EAEd,UAAU,EAEV,SAAS,EAQT,mBAAmB,EACpB,MAAM,SAAS,CAAA;AAQhB,MAAM,WAAW,gBAAgB,CAAC,QAAQ,GAAG,OAAO;IAClD,cAAc,CAAC,EAAE,cAAc,CAAA;IAC/B,UAAU,CAAC,EAAE,MAAM,CAAA;IACnB,QAAQ,CAAC,EAAE,QAAQ,CAAC,UAAU,CAAC,QAAQ,CAAC,CAAC,CAAA;IACzC,GAAG,CAAC,EAAE,MAAM,MAAM,CAAA;IAClB,eAAe,CAAC,EAAE,OAAO,CAAA;IACzB,SAAS,CAAC,EAAE,qBAAqB,CAAC,QAAQ,CAAC,CAAA;IAC3C,gEAAgE;IAChE,iBAAiB,CAAC,EAAE,CAAC,IAAI,EAAE,mBAAmB,KAAK,IAAI,CAAA;CACxD;AA0GD,eAAO,MAAM,eAAe,GAAI,QAAQ,EACtC,YAAY,cAAc,CAAC,QAAQ,CAAC,EACpC,cAAa,gBAAgB,CAAC,QAAQ,CAAM,KAC3C,SAAS,CAAC,QAAQ,CAqiBpB,CAAA"}

package/dist/storage.d.ts

@@ -0,0 +1,51 @@
+export interface StorageSnapshot<TValue = unknown> {
+    /** Version stored as "major.minor" string */
+    version: string;
+    value: TValue;
+    updatedAt: number;
+}
+export interface StorageAdapter {
+    get: (key: string) => StorageSnapshot | null | Promise<StorageSnapshot | null>;
+    set: (key: string, value: StorageSnapshot) => void | Promise<void>;
+    remove: (key: string) => void | Promise<void>;
+    subscribe?: (listener: () => void) => () => void;
+}
+export declare const resolveMaybePromise: <TValue>(value: TValue | Promise<TValue>) => Promise<TValue>;
+export declare class MemoryStorageAdapter implements StorageAdapter {
+    private readonly store;
+    private readonly listeners;
+    get: StorageAdapter['get'];
+    set: StorageAdapter['set'];
+    remove: StorageAdapter['remove'];
+    subscribe: NonNullable<StorageAdapter['subscribe']>;
+    private emit;
+}
+export declare const createLocalStorageAdapter: (storage?: Storage | null) => StorageAdapter;
+export interface ApiStorageAdapterOptions {
+    /** Base URL for the storage API (e.g., '/api/tour-state' or 'https://api.example.com/tours') */
+    baseUrl: string;
+    /** Function to get headers for each request (e.g., for auth tokens) */
+    getHeaders?: () => Promise<HeadersInit> | HeadersInit;
+    /** Custom fetch implementation (defaults to global fetch) */
+    fetch?: typeof fetch;
+}
+/**
+ * Creates a storage adapter that persists tour state via HTTP API.
+ *
+ * Expects the API to implement:
+ * - GET /{key} → returns StorageSnapshot JSON or 404
+ * - PUT /{key} → accepts StorageSnapshot JSON body
+ * - DELETE /{key} → removes the snapshot
+ *
+ * @example
+ * ```ts
+ * const storageAdapter = createApiStorageAdapter({
+ *   baseUrl: '/api/tour-state',
+ *   getHeaders: () => ({ Authorization: `Bearer ${getToken()}` }),
+ * })
+ *
+ * <TourProvider flows={flows} storageAdapter={storageAdapter}>
+ * ```
+ */
+export declare function createApiStorageAdapter(options: ApiStorageAdapterOptions): StorageAdapter;
+//# sourceMappingURL=storage.d.ts.map

package/dist/storage.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"storage.d.ts","sourceRoot":"","sources":["../src/storage.ts"],"names":[],"mappings":"AAAA,MAAM,WAAW,eAAe,CAAC,MAAM,GAAG,OAAO;IAC/C,6CAA6C;IAC7C,OAAO,EAAE,MAAM,CAAA;IACf,KAAK,EAAE,MAAM,CAAA;IACb,SAAS,EAAE,MAAM,CAAA;CAClB;AAED,MAAM,WAAW,cAAc;IAC7B,GAAG,EAAE,CAAC,GAAG,EAAE,MAAM,KAAK,eAAe,GAAG,IAAI,GAAG,OAAO,CAAC,eAAe,GAAG,IAAI,CAAC,CAAA;IAC9E,GAAG,EAAE,CAAC,GAAG,EAAE,MAAM,EAAE,KAAK,EAAE,eAAe,KAAK,IAAI,GAAG,OAAO,CAAC,IAAI,CAAC,CAAA;IAClE,MAAM,EAAE,CAAC,GAAG,EAAE,MAAM,KAAK,IAAI,GAAG,OAAO,CAAC,IAAI,CAAC,CAAA;IAC7C,SAAS,CAAC,EAAE,CAAC,QAAQ,EAAE,MAAM,IAAI,KAAK,MAAM,IAAI,CAAA;CACjD;AAED,eAAO,MAAM,mBAAmB,GAAU,MAAM,EAC9C,OAAO,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC,KAC9B,OAAO,CAAC,MAAM,CAAgB,CAAA;AAEjC,qBAAa,oBAAqB,YAAW,cAAc;IACzD,OAAO,CAAC,QAAQ,CAAC,KAAK,CAAqC;IAC3D,OAAO,CAAC,QAAQ,CAAC,SAAS,CAAwB;IAElD,GAAG,EAAE,cAAc,CAAC,KAAK,CAAC,CAEzB;IAED,GAAG,EAAE,cAAc,CAAC,KAAK,CAAC,CAGzB;IAED,MAAM,EAAE,cAAc,CAAC,QAAQ,CAAC,CAG/B;IAED,SAAS,EAAE,WAAW,CAAC,cAAc,CAAC,WAAW,CAAC,CAAC,CAGlD;IAED,OAAO,CAAC,IAAI;CAKb;AAmBD,eAAO,MAAM,yBAAyB,GACpC,UAAS,OAAO,GAAG,IAAwB,KAC1C,cA+CF,CAAA;AAcD,MAAM,WAAW,wBAAwB;IACvC,gGAAgG;IAChG,OAAO,EAAE,MAAM,CAAA;IACf,uEAAuE;IACvE,UAAU,CAAC,EAAE,MAAM,OAAO,CAAC,WAAW,CAAC,GAAG,WAAW,CAAA;IACrD,6DAA6D;IAC7D,KAAK,CAAC,EAAE,OAAO,KAAK,CAAA;CACrB;AAED;;;;;;;;;;;;;;;;;GAiBG;AACH,wBAAgB,uBAAuB,CACrC,OAAO,EAAE,wBAAwB,GAChC,cAAc,CAmEhB"}

package/dist/types.d.ts

@@ -0,0 +1,289 @@
+import type { EventBus } from './events';
+export type FlowStatus = 'idle' | 'running' | 'paused' | 'completed' | 'cancelled';
+export type FlowCancelReason = 'skipped' | 'keyboard';
+/**
+ * Semantic version for flow definitions.
+ * - major: Increment for breaking changes (steps restructured, removed, IDs changed)
+ * - minor: Increment for additive/cosmetic changes (content tweaks, new optional steps)
+ */
+export interface FlowVersion {
+    major: number;
+    minor: number;
+}
+export interface FlowState {
+    status: FlowStatus;
+    stepIndex: number;
+    /** Serialized version stored as "major.minor" string for stable storage */
+    version: string;
+    /** Step ID at time of storage, used for migration matching */
+    stepId?: string;
+    updatedAt: number;
+    cancelReason?: FlowCancelReason;
+}
+export type StepDirection = 'forward' | 'backward' | 'none';
+export type StepEnterReason = 'start' | 'resume' | 'advance' | 'back' | 'jump';
+export type StepExitReason = 'advance' | 'back' | 'pause' | 'cancel' | 'complete' | 'unknown';
+export type StepCompleteReason = 'advance' | 'flowComplete';
+export interface StepTransitionPayload<TContent = unknown> {
+    flow: FlowDefinition<TContent>;
+    state: FlowState;
+    currentStep: Step<TContent> | null;
+    currentStepIndex: number;
+    previousStep: Step<TContent> | null;
+    previousStepIndex: number;
+    direction: StepDirection;
+}
+export interface StepEnterEvent<TContent = unknown> extends StepTransitionPayload<TContent> {
+    currentStep: Step<TContent>;
+    reason: StepEnterReason;
+}
+export interface StepExitEvent<TContent = unknown> extends StepTransitionPayload<TContent> {
+    previousStep: Step<TContent>;
+    reason: StepExitReason;
+}
+export interface StepCompleteEvent<TContent = unknown> extends StepTransitionPayload<TContent> {
+    previousStep: Step<TContent>;
+    reason: StepCompleteReason;
+}
+export type StepPlacement = 'auto' | 'top' | 'bottom' | 'left' | 'right' | 'auto-start' | 'auto-end' | 'top-start' | 'top-end' | 'bottom-start' | 'bottom-end' | 'left-start' | 'left-end' | 'right-start' | 'right-end';
+export type StepMask = 'hole' | 'none' | {
+    padding?: number;
+    radius?: number;
+};
+export type HiddenTargetFallbackMode = 'screen' | 'skip';
+export type ScrollMarginConfig = number | {
+    top?: number;
+    bottom?: number;
+    left?: number;
+    right?: number;
+};
+export type StepScrollMode = 'preserve' | 'start' | 'center';
+export interface StepTargetBehavior {
+    hidden?: HiddenTargetFallbackMode;
+    hiddenDelayMs?: number;
+    scrollMargin?: ScrollMarginConfig;
+    scrollMode?: StepScrollMode;
+}
+export type StepTarget = 'screen' | {
+    selector?: string;
+    getNode?: () => Element | null;
+    description?: string;
+};
+export type StepControlState = 'auto' | 'hidden' | 'disabled';
+export interface StepControls {
+    back?: StepControlState;
+    next?: StepControlState;
+}
+export interface StepWaitForSubscribeContext<TContent = unknown> extends StepHookContext<TContent> {
+    notify: (next?: boolean) => void;
+}
+export type StepWaitForPredicate<TContent = unknown> = (ctx: StepHookContext<TContent>) => boolean | Promise<boolean>;
+export type StepWaitForSubscribe<TContent = unknown> = (ctx: StepWaitForSubscribeContext<TContent>) => void | (() => void);
+export interface StepWaitFor<TContent = unknown> {
+    selector?: string;
+    timeout?: number;
+    predicate?: StepWaitForPredicate<TContent>;
+    pollMs?: number;
+    subscribe?: StepWaitForSubscribe<TContent>;
+}
+export interface AdvancePredicateContext<TContent = unknown> {
+    flow: FlowDefinition<TContent>;
+    state: FlowState;
+    step: Step<TContent>;
+}
+interface AdvanceRuleBase {
+    lockBack?: boolean;
+}
+export type AdvanceRule<TContent = unknown> = ({
+    type: 'manual';
+} & AdvanceRuleBase) | ({
+    type: 'event';
+    event: string;
+    on?: 'target' | string;
+} & AdvanceRuleBase) | ({
+    type: 'predicate';
+    check: (ctx: AdvancePredicateContext<TContent>) => boolean;
+    pollMs?: number;
+    timeoutMs?: number;
+} & AdvanceRuleBase) | ({
+    type: 'delay';
+    ms: number;
+} & AdvanceRuleBase) | ({
+    type: 'route';
+    to?: string | RegExp;
+} & AdvanceRuleBase);
+export interface StepHookContext<TContent = unknown> {
+    flow: FlowDefinition<TContent>;
+    state: FlowState;
+    step: Step<TContent>;
+}
+export type StepHook<TContent = unknown> = (ctx: StepHookContext<TContent>) => void | Promise<void>;
+export interface Step<TContent = unknown> {
+    id: string;
+    target: StepTarget;
+    route?: string | RegExp;
+    placement?: StepPlacement;
+    mask?: StepMask;
+    targetBehavior?: StepTargetBehavior;
+    content: TContent;
+    advance?: Array<AdvanceRule<TContent>>;
+    waitFor?: StepWaitFor<TContent>;
+    onEnter?: StepHook<TContent>;
+    onResume?: StepHook<TContent>;
+    onExit?: StepHook<TContent>;
+    controls?: StepControls;
+}
+export type BackdropInteractionMode = 'block' | 'passthrough';
+export interface FlowHudPopoverOptions {
+    offset?: number;
+    role?: string;
+    ariaLabel?: string;
+    ariaDescribedBy?: string;
+    ariaModal?: boolean;
+    width?: number | string;
+    maxWidth?: number | string;
+}
+export interface FlowHudBackdropOptions {
+    interaction?: BackdropInteractionMode;
+}
+export interface FlowHudBehaviorOptions {
+    lockBodyScroll?: boolean;
+}
+export type FlowHudRenderMode = 'default' | 'none';
+export interface FlowHudTokenOverrides {
+    [key: string]: unknown;
+}
+export type ResumeStrategy = 'chain' | 'current';
+export interface FlowHudOptions {
+    render?: FlowHudRenderMode;
+    popover?: FlowHudPopoverOptions;
+    tokens?: FlowHudTokenOverrides;
+    backdrop?: FlowHudBackdropOptions;
+    behavior?: FlowHudBehaviorOptions;
+}
+/**
+ * Result of comparing two flow versions.
+ * - 'same': Versions match exactly
+ * - 'minor': Only minor version differs (non-breaking)
+ * - 'major': Major version differs (breaking change)
+ */
+export type VersionCompareResult = 'same' | 'minor' | 'major';
+/**
+ * Action taken after version mismatch detection.
+ */
+export type VersionMismatchAction = 'continued' | 'migrated' | 'reset';
+/**
+ * Context provided to migration functions.
+ */
+export interface MigrationContext<TContent = unknown> {
+    oldState: FlowState;
+    oldVersion: FlowVersion;
+    newVersion: FlowVersion;
+    /** Map of step ID to new index in current definition */
+    stepIdMap: Map<string, number>;
+    /** Current flow definition */
+    definition: FlowDefinition<TContent>;
+}
+/**
+ * Migration function type. Return new state or null to trigger reset.
+ */
+export type FlowMigrateFn<TContent = unknown> = (ctx: MigrationContext<TContent>) => FlowState | null;
+/**
+ * Information about a version mismatch event.
+ */
+export interface VersionMismatchInfo {
+    flowId: string;
+    oldVersion: FlowVersion;
+    newVersion: FlowVersion;
+    action: VersionMismatchAction;
+    /** Step ID that was resolved to (if continued/migrated) */
+    resolvedStepId?: string;
+    /** Step index that was resolved to (if continued/migrated) */
+    resolvedStepIndex?: number;
+}
+export interface FlowDefinition<TContent = unknown> {
+    id: string;
+    version: FlowVersion;
+    steps: Array<Step<TContent>>;
+    hud?: FlowHudOptions;
+    resumeStrategy?: ResumeStrategy;
+    autoStart?: boolean;
+    metadata?: Record<string, unknown>;
+    /** Optional migration function for handling version upgrades */
+    migrate?: FlowMigrateFn<TContent>;
+}
+export type FlowErrorCode = 'async.schedule_failed' | 'storage.persist_failed' | 'storage.remove_failed' | 'storage.hydrate_failed' | 'flow.step_not_found' | 'flow.store_destroyed' | 'flow.migration_failed';
+export interface FlowErrorEvent<TContent = unknown> {
+    flow: FlowDefinition<TContent>;
+    state: FlowState;
+    code: FlowErrorCode;
+    error?: unknown;
+    meta?: Record<string, unknown>;
+}
+export interface FlowEvents<TContent = unknown> extends Record<string, unknown> {
+    flowStart: {
+        flow: FlowDefinition<TContent>;
+        state: FlowState;
+    };
+    flowResume: {
+        flow: FlowDefinition<TContent>;
+        state: FlowState;
+    };
+    flowPause: {
+        flow: FlowDefinition<TContent>;
+        state: FlowState;
+    };
+    flowCancel: {
+        flow: FlowDefinition<TContent>;
+        state: FlowState;
+        reason?: FlowCancelReason;
+    };
+    flowComplete: {
+        flow: FlowDefinition<TContent>;
+        state: FlowState;
+    };
+    stepChange: {
+        flow: FlowDefinition<TContent>;
+        state: FlowState;
+        step: Step<TContent> | null;
+        previousStep: Step<TContent> | null;
+    };
+    stateChange: {
+        flow: FlowDefinition<TContent>;
+        state: FlowState;
+    };
+    stepEnter: StepEnterEvent<TContent>;
+    stepExit: StepExitEvent<TContent>;
+    stepComplete: StepCompleteEvent<TContent>;
+    flowError: FlowErrorEvent<TContent>;
+    versionMismatch: VersionMismatchInfo & {
+        flow: FlowDefinition<TContent>;
+    };
+}
+type AnalyticsHandlerName<TName extends string> = `on${Capitalize<TName>}`;
+export type FlowAnalyticsHandlers<TContent = unknown> = {
+    [TKey in Extract<keyof FlowEvents<TContent>, string> as AnalyticsHandlerName<TKey>]?: (payload: FlowEvents<TContent>[TKey]) => void;
+};
+export interface StartFlowOptions {
+    fromStepId?: string;
+    fromStepIndex?: number;
+    resume?: boolean;
+    resumeStrategy?: ResumeStrategy;
+}
+export interface FlowStore<TContent = unknown> {
+    readonly definition: FlowDefinition<TContent>;
+    readonly events: EventBus<FlowEvents<TContent>>;
+    getState: () => FlowState;
+    start: (options?: StartFlowOptions) => FlowState;
+    next: () => FlowState;
+    back: () => FlowState;
+    goToStep: (step: number | string) => FlowState;
+    pause: () => FlowState;
+    resume: () => FlowState;
+    cancel: (reason?: FlowCancelReason) => FlowState;
+    complete: () => FlowState;
+    subscribe: (listener: (state: FlowState) => void) => () => void;
+    destroy: () => void;
+}
+export {};
+//# sourceMappingURL=types.d.ts.map

package/dist/types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../src/types.ts"],"names":[],"mappings":"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"}

package/dist/validation.d.ts

@@ -0,0 +1,90 @@
+import { z } from 'zod';
+import type { FlowDefinition } from './types';
+export declare const flowDefinitionSchema: z.ZodObject<{
+    id: z.ZodString;
+    version: z.ZodObject<{
+        major: z.ZodNumber;
+        minor: z.ZodNumber;
+    }, z.core.$strip>;
+    steps: z.ZodArray<z.ZodObject<{
+        id: z.ZodString;
+        target: z.ZodUnion<readonly [z.ZodLiteral<"screen">, z.ZodObject<{
+            selector: z.ZodOptional<z.ZodString>;
+            getNode: z.ZodOptional<z.ZodCustom<() => Element | null, () => Element | null>>;
+            description: z.ZodOptional<z.ZodString>;
+        }, z.core.$strip>]>;
+        route: z.ZodOptional<z.ZodUnion<readonly [z.ZodString, z.ZodCustom<RegExp, RegExp>]>>;
+        placement: z.ZodOptional<z.ZodUnion<readonly [z.ZodLiteral<"auto">, z.ZodLiteral<"top">, z.ZodLiteral<"bottom">, z.ZodLiteral<"left">, z.ZodLiteral<"right">, z.ZodLiteral<"auto-start">, z.ZodLiteral<"auto-end">, z.ZodLiteral<"top-start">, z.ZodLiteral<"top-end">, z.ZodLiteral<"bottom-start">, z.ZodLiteral<"bottom-end">, z.ZodLiteral<"left-start">, z.ZodLiteral<"left-end">, z.ZodLiteral<"right-start">, z.ZodLiteral<"right-end">]>>;
+        mask: z.ZodOptional<z.ZodUnion<readonly [z.ZodLiteral<"hole">, z.ZodLiteral<"none">, z.ZodObject<{
+            padding: z.ZodOptional<z.ZodNumber>;
+            radius: z.ZodOptional<z.ZodNumber>;
+        }, z.core.$strip>]>>;
+        targetBehavior: z.ZodOptional<z.ZodObject<{
+            hidden: z.ZodOptional<z.ZodUnion<readonly [z.ZodLiteral<"screen">, z.ZodLiteral<"skip">]>>;
+            hiddenDelayMs: z.ZodOptional<z.ZodNumber>;
+            scrollMargin: z.ZodOptional<z.ZodUnion<readonly [z.ZodNumber, z.ZodObject<{
+                top: z.ZodOptional<z.ZodNumber>;
+                bottom: z.ZodOptional<z.ZodNumber>;
+                left: z.ZodOptional<z.ZodNumber>;
+                right: z.ZodOptional<z.ZodNumber>;
+            }, z.core.$strict>]>>;
+            scrollMode: z.ZodOptional<z.ZodUnion<readonly [z.ZodLiteral<"preserve">, z.ZodLiteral<"start">, z.ZodLiteral<"center">]>>;
+        }, z.core.$strip>>;
+        content: z.ZodAny;
+        advance: z.ZodOptional<z.ZodArray<z.ZodUnion<readonly [z.ZodObject<{
+            type: z.ZodLiteral<"manual">;
+        }, z.core.$strip>, z.ZodObject<{
+            type: z.ZodLiteral<"event">;
+            event: z.ZodString;
+            on: z.ZodOptional<z.ZodUnion<readonly [z.ZodLiteral<"target">, z.ZodString]>>;
+        }, z.core.$strip>, z.ZodObject<{
+            type: z.ZodLiteral<"predicate">;
+            pollMs: z.ZodOptional<z.ZodNumber>;
+            timeoutMs: z.ZodOptional<z.ZodNumber>;
+            check: z.ZodCustom<(ctx: unknown) => boolean | Promise<boolean>, (ctx: unknown) => boolean | Promise<boolean>>;
+        }, z.core.$strip>, z.ZodObject<{
+            type: z.ZodLiteral<"delay">;
+            ms: z.ZodNumber;
+        }, z.core.$strip>, z.ZodObject<{
+            type: z.ZodLiteral<"route">;
+            to: z.ZodOptional<z.ZodUnion<readonly [z.ZodString, z.ZodCustom<RegExp, RegExp>]>>;
+        }, z.core.$strip>]>>>;
+        waitFor: z.ZodOptional<z.ZodObject<{
+            selector: z.ZodOptional<z.ZodOptional<z.ZodString>>;
+            timeout: z.ZodOptional<z.ZodOptional<z.ZodNumber>>;
+            predicate: z.ZodOptional<z.ZodOptional<z.ZodCustom<(ctx: unknown) => boolean | Promise<boolean>, (ctx: unknown) => boolean | Promise<boolean>>>>;
+            pollMs: z.ZodOptional<z.ZodOptional<z.ZodNumber>>;
+            subscribe: z.ZodOptional<z.ZodOptional<z.ZodCustom<(ctx: unknown) => unknown, (ctx: unknown) => unknown>>>;
+        }, z.core.$strip>>;
+        onResume: z.ZodOptional<z.ZodCustom<(...args: Array<unknown>) => unknown, (...args: Array<unknown>) => unknown>>;
+        onEnter: z.ZodOptional<z.ZodCustom<(...args: Array<unknown>) => unknown, (...args: Array<unknown>) => unknown>>;
+        onExit: z.ZodOptional<z.ZodCustom<(...args: Array<unknown>) => unknown, (...args: Array<unknown>) => unknown>>;
+        controls: z.ZodOptional<z.ZodObject<{
+            back: z.ZodOptional<z.ZodUnion<readonly [z.ZodLiteral<"auto">, z.ZodLiteral<"hidden">, z.ZodLiteral<"disabled">]>>;
+            next: z.ZodOptional<z.ZodUnion<readonly [z.ZodLiteral<"auto">, z.ZodLiteral<"hidden">, z.ZodLiteral<"disabled">]>>;
+        }, z.core.$strip>>;
+    }, z.core.$strip>>;
+    hud: z.ZodOptional<z.ZodObject<{
+        render: z.ZodOptional<z.ZodUnion<readonly [z.ZodLiteral<"default">, z.ZodLiteral<"none">]>>;
+        popover: z.ZodOptional<z.ZodObject<{
+            offset: z.ZodOptional<z.ZodNumber>;
+            role: z.ZodOptional<z.ZodString>;
+            ariaLabel: z.ZodOptional<z.ZodString>;
+            ariaDescribedBy: z.ZodOptional<z.ZodString>;
+            ariaModal: z.ZodOptional<z.ZodBoolean>;
+        }, z.core.$strip>>;
+        backdrop: z.ZodOptional<z.ZodObject<{
+            interaction: z.ZodOptional<z.ZodUnion<readonly [z.ZodLiteral<"block">, z.ZodLiteral<"passthrough">]>>;
+        }, z.core.$strip>>;
+        behavior: z.ZodOptional<z.ZodObject<{
+            lockBodyScroll: z.ZodOptional<z.ZodBoolean>;
+        }, z.core.$strip>>;
+        tokens: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodAny>>;
+    }, z.core.$strip>>;
+    resumeStrategy: z.ZodOptional<z.ZodUnion<readonly [z.ZodLiteral<"chain">, z.ZodLiteral<"current">]>>;
+    autoStart: z.ZodOptional<z.ZodBoolean>;
+    metadata: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodAny>>;
+    migrate: z.ZodOptional<z.ZodCustom<(...args: Array<unknown>) => unknown, (...args: Array<unknown>) => unknown>>;
+}, z.core.$strip>;
+export declare const validateFlowDefinition: <TContent>(definition: FlowDefinition<TContent>) => FlowDefinition<TContent>;
+//# sourceMappingURL=validation.d.ts.map

package/dist/validation.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"validation.d.ts","sourceRoot":"","sources":["../src/validation.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAA;AACvB,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,SAAS,CAAA;AA8M7C,eAAO,MAAM,oBAAoB;;;;;;;;;;qDArMT,OAAO,GAAG,IAAI,QAAd,OAAO,GAAG,IAAI;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;qCAyCZ,OAAO,KAAK,OAAO,GAAG,OAAO,CAAC,OAAO,CAAC,QAAtC,OAAO,KAAK,OAAO,GAAG,OAAO,CAAC,OAAO,CAAC;;;;;;;;;;;qEAmB5C,OAAO,KAAK,OAAO,GAAG,OAAO,CAAC,OAAO,CAAC,QAAtC,OAAO,KAAK,OAAO,GAAG,OAAO,CAAC,OAAO,CAAC;;qEAStC,OAAO,KAAK,OAAO,QAAnB,OAAO,KAAK,OAAO;;sDA2GvB,KAAK,CAAC,OAAO,CAAC,KAAK,OAAO,YAA1B,KAAK,CAAC,OAAO,CAAC,KAAK,OAAO;qDAK1B,KAAK,CAAC,OAAO,CAAC,KAAK,OAAO,YAA1B,KAAK,CAAC,OAAO,CAAC,KAAK,OAAO;oDAK1B,KAAK,CAAC,OAAO,CAAC,KAAK,OAAO,YAA1B,KAAK,CAAC,OAAO,CAAC,KAAK,OAAO;;;;;;;;;;;;;;;;;;;;;;;;;;iDAvDtB,KAAK,CAAC,OAAO,CAAC,KAAK,OAAO,YAA1B,KAAK,CAAC,OAAO,CAAC,KAAK,OAAO;iBA2E5C,CAAA;AAEF,eAAO,MAAM,sBAAsB,GAAI,QAAQ,EAC7C,YAAY,cAAc,CAAC,QAAQ,CAAC,KACnC,cAAc,CAAC,QAAQ,CAEzB,CAAA"}

package/dist/version.d.ts

@@ -0,0 +1,41 @@
+import type { FlowDefinition, FlowState, FlowVersion, VersionCompareResult, VersionMismatchAction } from './types';
+/**
+ * Serializes FlowVersion to string format "major.minor" for storage.
+ */
+export declare const serializeVersion: (version: FlowVersion) => string;
+/**
+ * Parses version string back to FlowVersion object.
+ * Used for reading stored versions from storage.
+ */
+export declare const parseVersion: (versionStr: string) => FlowVersion;
+/**
+ * Compares two versions and returns the type of difference.
+ */
+export declare const compareVersions: (stored: FlowVersion, current: FlowVersion) => VersionCompareResult;
+/**
+ * Builds a map of step ID to index for the given flow definition.
+ */
+export declare const buildStepIdMap: <TContent>(definition: FlowDefinition<TContent>) => Map<string, number>;
+export interface VersionMigrationResult {
+    state: FlowState;
+    action: VersionMismatchAction;
+}
+/**
+ * Handles version mismatch by attempting migration or reset.
+ *
+ * Strategy:
+ * - 'same': Return stored state unchanged
+ * - 'minor': Try to match by stepId, fallback to stepIndex
+ * - 'major': Call migrate() if present, else reset
+ *
+ * For terminal states (completed/cancelled), preserve status regardless of version.
+ */
+export declare const handleVersionMismatch: <TContent>(params: {
+    storedState: FlowState;
+    storedVersion: FlowVersion;
+    definition: FlowDefinition<TContent>;
+    currentVersion: FlowVersion;
+    stepIdMap: Map<string, number>;
+    now: () => number;
+}) => VersionMigrationResult;
+//# sourceMappingURL=version.d.ts.map

package/dist/version.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"version.d.ts","sourceRoot":"","sources":["../src/version.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EACV,cAAc,EACd,SAAS,EACT,WAAW,EAEX,oBAAoB,EACpB,qBAAqB,EACtB,MAAM,SAAS,CAAA;AAEhB;;GAEG;AACH,eAAO,MAAM,gBAAgB,GAAI,SAAS,WAAW,KAAG,MACnB,CAAA;AAErC;;;GAGG;AACH,eAAO,MAAM,YAAY,GAAI,YAAY,MAAM,KAAG,WAYjD,CAAA;AAED;;GAEG;AACH,eAAO,MAAM,eAAe,GAC1B,QAAQ,WAAW,EACnB,SAAS,WAAW,KACnB,oBAQF,CAAA;AAED;;GAEG;AACH,eAAO,MAAM,cAAc,GAAI,QAAQ,EACrC,YAAY,cAAc,CAAC,QAAQ,CAAC,KACnC,GAAG,CAAC,MAAM,EAAE,MAAM,CAMpB,CAAA;AAED,MAAM,WAAW,sBAAsB;IACrC,KAAK,EAAE,SAAS,CAAA;IAChB,MAAM,EAAE,qBAAqB,CAAA;CAC9B;AAED;;;;;;;;;GASG;AACH,eAAO,MAAM,qBAAqB,GAAI,QAAQ,EAAE,QAAQ;IACtD,WAAW,EAAE,SAAS,CAAA;IACtB,aAAa,EAAE,WAAW,CAAA;IAC1B,UAAU,EAAE,cAAc,CAAC,QAAQ,CAAC,CAAA;IACpC,cAAc,EAAE,WAAW,CAAA;IAC3B,SAAS,EAAE,GAAG,CAAC,MAAM,EAAE,MAAM,CAAC,CAAA;IAC9B,GAAG,EAAE,MAAM,MAAM,CAAA;CAClB,KAAG,sBA4FH,CAAA"}

package/package.json

@@ -0,0 +1,42 @@
+{
+  "name": "@flowsterix/core",
+  "version": "0.1.0",
+  "description": "Core engine for Flowsterix - guided tours and onboarding flows",
+  "license": "MIT",
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/kvngrf/flowsterix.git",
+    "directory": "packages/core"
+  },
+  "keywords": [
+    "tour",
+    "onboarding",
+    "walkthrough",
+    "guide",
+    "flow"
+  ],
+  "type": "module",
+  "sideEffects": false,
+  "main": "dist/index.cjs",
+  "module": "dist/index.mjs",
+  "types": "./dist/index.d.ts",
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "import": "./dist/index.mjs",
+      "require": "./dist/index.cjs",
+      "default": "./dist/index.mjs"
+    }
+  },
+  "files": [
+    "dist"
+  ],
+  "dependencies": {
+    "zod": "^4.1.11"
+  },
+  "scripts": {
+    "build": "tsup --config tsup.config.ts && tsc --build tsconfig.json --force",
+    "lint": "eslint src --ext .ts",
+    "test": "vitest run"
+  }
+}