@rxova/journey-react 0.7.0 → 1.0.0-rc.2

package/README.md

@@ -1,226 +1,157 @@
 # @rxova/journey-react
 
-Typed React bindings for Rxova Journey.
+Typed React bindings for multi-step UI flows.
+
+<p>
+  <a href="https://www.npmjs.com/package/@rxova/journey-react">
+    <img src="https://img.shields.io/npm/v/@rxova/journey-react?color=0f8f6a" alt="npm" />
+  </a>
+  <img src="https://img.shields.io/badge/1.33%20kB-brotli-0f8f6a" alt="size" />
+  <img src="https://img.shields.io/badge/React%2018+-black" alt="React 18+" />
+  <img src="https://img.shields.io/badge/TypeScript-strict-3178C6?logo=typescript&logoColor=white" alt="TypeScript" />
+</p>
+
+`@rxova/journey-react` is approaching a `1.0.0-rc` contract freeze. The key runtime rule is unchanged:
+one `createJourney(...)` call creates one machine instance immediately, and the returned hooks/components stay bound to that instance.
 
 ## Install
 
 ```bash
-pnpm add @rxova/journey-react
-yarn add @rxova/journey-react
-npm i @rxova/journey-react
-bun add @rxova/journey-react
+npm i @rxova/journey-react @rxova/journey-core
 ```
 
-Works in Bun-based SPAs as long as your app runtime supports React 18+.
-
-## API Style
-
-`@rxova/journey-react` is bindings-first:
-
-- `createJourneyBindings(journey)` returns a typed bundle that contains:
-  - `Provider`
-  - `StepRenderer`
-  - `useJourneyApi`
-  - `useJourneyEvent`
-  - `useJourneySelector`
-  - `useJourneySnapshot`
-  - `useJourneyMachine`
-
-No per-hook generic arguments are needed at callsites.
+Use the root entry for server-safe imports. When a Next.js App Router client boundary should be explicit,
+import from `@rxova/journey-react/client`.
 
 ## Quickstart
 
 ```tsx
-import React from "react";
-import { createJourneyBindings, type JourneyReactDefinition } from "@rxova/journey-react";
+import { createJourney, type JourneyViews } from "@rxova/journey-react";
+import type { JourneyDefinition } from "@rxova/journey-core";
 
 type StepId = "start" | "review";
-type Ctx = { name: string };
-
-let bindings: ReturnType<typeof createJourneyBindings<Ctx, StepId>>;
-
-const Start = () => {
-  const api = bindings.useJourneyApi();
-  return <button onClick={() => void api.goToNextStep()}>Next</button>;
-};
-
-const Review = () => {
-  const api = bindings.useJourneyApi();
-  return <button onClick={() => void api.completeJourney()}>Submit</button>;
-};
+type Context = { name: string };
 
-const journey: JourneyReactDefinition<Ctx, StepId> = {
+const definition: JourneyDefinition<Context, StepId> = {
   initial: "start",
   context: { name: "" },
-  steps: {
-    start: { component: Start },
-    review: { component: Review }
-  },
-  transitions: [
-    { from: "start", event: "goToNextStep", to: "review" },
-    { from: "review", event: "completeJourney" }
-  ]
+  steps: { start: {}, review: {} },
+  transitions: {
+    start: { goToNextStep: [{ to: "review" }] },
+    review: { completeJourney: true }
+  }
 };
 
-bindings = createJourneyBindings(journey);
-
-export const App = () => {
-  const Provider = bindings.Provider;
-  const StepRenderer = bindings.StepRenderer;
+const signup = createJourney(definition);
 
+const Start = () => {
+  const api = signup.useJourneyApi();
+  const snap = signup.useJourneySnapshot();
   return (
-    <Provider>
-      <StepRenderer />
-    </Provider>
+    <div>
+      <p>Hello, {snap.context.name || "stranger"}</p>
+      <button onClick={() => void api.goToNextStep()}>Next</button>
+    </div>
   );
 };
-```
-
-## Split Files Pattern (Hooks In Steps)
-
-If step components live in separate files and call Journey hooks, export bindings as `let`:
-
-```tsx
-// journey-bindings.ts
-import { createJourneyBindings, type JourneyReactDefinition } from "@rxova/journey-react";
-import { Start, Review } from "./steps";
-
-type StepId = "start" | "review";
-type Ctx = { name: string };
-
-export let bindings: ReturnType<typeof createJourneyBindings<Ctx, StepId>>;
 
-const journey: JourneyReactDefinition<Ctx, StepId> = {
-  initial: "start",
-  context: { name: "" },
-  steps: {
-    start: { component: Start },
-    review: { component: Review }
-  },
-  transitions: [
-    { from: "start", event: "goToNextStep", to: "review" },
-    { from: "review", event: "completeJourney" }
-  ]
+const Review = () => {
+  const api = signup.useJourneyApi();
+  return <button onClick={() => void api.completeJourney()}>Submit</button>;
 };
 
-bindings = createJourneyBindings(journey);
+const views: JourneyViews<StepId> = { start: Start, review: Review };
+
+export const App = () => (
+  <signup.JourneyProvider views={views}>
+    <signup.StepRenderer />
+  </signup.JourneyProvider>
+);
 ```
 
 ## Hooks
 
-- `useJourneySnapshot()` subscribes to the machine and rerenders on changes.
-- `useJourneyEvent(listener)` subscribes to typed lifecycle events.
-- `useJourneySelector(selector, equalityFn?)` subscribes to a selected slice and rerenders only when that selected value changes.
-- `useJourneyApi()` returns typed commands.
-- `useJourneyMachine()` returns the underlying core machine instance.
-
-## Journey API Helpers
+`createJourney()` returns a runtime with bound hooks:
 
-From `bindings.useJourneyApi()`:
+- **`useJourneySnapshot()`** — full snapshot: `currentStepId`, `context`, `history`, `status`, `async`
+- **`useJourneyApi()`** — runtime commands: `startJourney`, `goToNextStep`, `goToPreviousStep`, `completeJourney`, `send`, etc.
+- **`useStepApi(stepId)`** — step-scoped command surface with `send(...)` narrowed to custom events handled by that step or `global`
+- **`useJourneyComputed()`** — derived state: `mode`, `activeStepId`, `isLoading`, `isFirstStep`, `isLastStep`
+- **`useJourneySelector(selector, eq?)`** — subscribe to a slice of the snapshot
+- **`useJourneyEvent(listener)`** — stream lifecycle events for analytics
 
-- `goToNextStep`
-- `terminateJourney`
-- `completeJourney`
-- `send`
-- `goToPreviousStep(steps?)`
-- `goToLastVisitedStep()`
-- `updateContext`
-- `updateStepMetadata`
-- `clearStepError`, `resetJourney`
-
-Imperative jump is available through `send`:
+## Navigation
 
 ```ts
-await api.send({ type: "goToStepById", stepId: "review" });
+const api = signup.useJourneyApi();
+
+await api.startJourney();
+await api.goToNextStep();
+await api.goToPreviousStep();
+await api.goToLastVisitedStep();
+await api.completeJourney();
+await api.terminateJourney();
+await api.goToStepById("review");
+
+api.updateContext((ctx) => ({ ...ctx, name: "Ada" }));
+api.resetJourney();
 ```
 
-`send()` and convenience helpers resolve with `result.error` on guard/effect failure instead of rejecting, so `void api.goToNextStep()` will not create an unhandled rejection if transition logic fails.
-
-`updateContext()` is immediate, but it follows core async timing rules: it does not retroactively change a transition already in `evaluating-when` or `running-effect`, and a running effect can later commit over that update. If the change must affect the current transition, apply it before `send(...)` or await the transition first.
-
-## Provider Behavior
+Transition failures resolve through `result.error` instead of rejecting, so `void api.goToNextStep()` is safe from unhandled promise rejections.
 
-- `<Provider />` creates an internal core machine from the bound journey.
-- `<Provider journey={...} />` lets you pass a different journey definition at runtime.
-- Internal machine is preserved across `journey` and `persistence` prop changes by default.
-- Set `resetOnJourneyChange` to rebuild internal machine when `journey` identity changes.
-- Set `resetOnPersistenceChange` to rebuild internal machine when `persistence` identity changes.
-- `<Provider machine={externalMachine} />` uses your machine directly.
-- `persistence` applies only when Provider owns the internal machine.
-- Internal Provider-owned machines default to completing on `goToNextStep()` when the current step declares no next transition.
-- Set `completeOnNoNextStep={false}` to opt out.
-- `onStart(event)` wraps `machine.subscribeStart(...)`.
-- `onComplete(event)` wraps `machine.subscribeComplete(...)`.
-- `onTerminate(event)` wraps `machine.subscribeTerminate(...)`.
-- All three callback props work with internal and external machines.
-- `onStart` replays startup on mount, matching core `journey.start` behavior.
-- `onComplete` and `onTerminate` fire only for emitted terminal lifecycle events.
+For step components, `useStepApi(stepId)` returns the same commands but narrows `send(...)` to custom events handled by that step or by `global` transitions:
 
 ```tsx
-<bindings.Provider
-  journey={dynamicJourney}
-  resetOnJourneyChange
-  onStart={() => console.log("started!")}
->
-  <bindings.StepRenderer />
-</bindings.Provider>
+const api = signup.useStepApi("start");
+void api.send({ type: "submit" });
 ```
 
-## Async and Error UI
+## Custom Step Renderer
 
-Core async state is exposed via snapshot:
+`StepRenderer` is a convenience — it just looks up the current step's view from the `views` record and renders it. You can build your own if you need transitions, animations, or a different rendering strategy:
 
 ```tsx
-const api = bindings.useJourneyApi();
-const snapshot = bindings.useJourneySnapshot();
-
-if (snapshot.async.isLoading) return <p>Working...</p>;
-
-const currentAsync = snapshot.async.byStep[snapshot.currentStepId];
-if (currentAsync.phase === "error") {
-  return (
-    <div>
-      <p>Something failed.</p>
-      <button onClick={() => api.clearStepError()}>Dismiss</button>
-    </div>
-  );
-}
+const MyStepRenderer = () => {
+  const { currentStepId } = signup.useJourneySnapshot();
+  const View = views[currentStepId];
+  if (!View) return <p>Unknown step</p>;
+  return <View />;
+};
 ```
 
-## Devtools Bridge
-
-Use `useJourneyMachine()` and attach the devtools bridge from an effect:
+## Plugins
 
 ```tsx
-import React from "react";
-import { attachJourneyDevtools } from "@rxova/journey-devtools-bridge";
-
-const JourneyDevtoolsBridge = () => {
-  const machine = bindings.useJourneyMachine();
+import { createPersistencePlugin } from "@rxova/journey-core/persistence";
 
-  React.useEffect(() => {
-    return attachJourneyDevtools(machine, { label: "Signup" });
-  }, [machine]);
-
-  return null;
-};
+const signup = createJourney(definition, {
+  plugins: [createPersistencePlugin({ key: "signup", version: 1 })],
+  defaultTimeoutMs: 30_000
+});
 ```
 
-## Transition Ergonomics
+## Runtime Ownership
 
-`@rxova/journey-react` re-exports core transition builders:
+Each `createJourney()` call creates one machine instance. The returned hooks are permanently bound to it.
 
-```ts
-import { createTransitions, tx } from "@rxova/journey-react";
+- Rendering multiple providers from the same runtime shares one journey state
+- `JourneyProvider` auto-starts an `idled` runtime, but does not dispose it by default
+- Provider-free flows can start manually through `useJourneyApi().startJourney()` or `machine.startJourney()`
+- Provider-owned startup failures are reported through `onError(error, { phase: "start" })`
+- Set `disposeOnUnmount` when a provider fully owns a component-scoped runtime
+- Independent instances require separate `createJourney()` calls
+- `createJourneyFactory()` returns a typed helper for producing fresh runtimes from the same definition/options pair and is the preferred path when request-scoped or boundary-scoped isolation matters
+- `dispose()` tears down subscriptions when the runtime is no longer needed
 
-const transitions = createTransitions(
-  tx.from("start").on("goToNextStep").to("review"),
-  tx.from("review").toComplete()
-);
-```
+## Documentation
+
+- [Pre-1.0 Migration](https://rxova.org/docs/core/pre-1-0-migration)
+- [Stability Contract](https://rxova.org/docs/core/stability)
+- [React Quickstart](https://rxova.org/docs/react/quickstart)
+- [Provider and Hooks](https://rxova.org/docs/react/provider-and-hooks)
+- [Patterns](https://rxova.org/docs/react/patterns)
+- [Core Docs](https://rxova.org/docs/core/getting-started)
 
-## SSR and RSC Notes
+## License
 
-- This package is a client entry (`"use client"`).
-- In React Server Components environments, call bindings/hooks from client components.
-- Server-side rendering is supported (Provider + StepRenderer render safely on the server).
+MIT

package/dist/client.cjs

@@ -0,0 +1,2 @@
+"use strict";"use client";var w=Object.create;var x=Object.defineProperty;var k=Object.getOwnPropertyDescriptor;var F=Object.getOwnPropertyNames;var H=Object.getPrototypeOf,D=Object.prototype.hasOwnProperty;var j=(n,r)=>{for(var s in r)x(n,s,{get:r[s],enumerable:!0})},M=(n,r,s,y)=>{if(r&&typeof r=="object"||typeof r=="function")for(let c of F(r))!D.call(n,c)&&c!==s&&x(n,c,{get:()=>r[c],enumerable:!(y=k(r,c))||y.enumerable});return n};var E=(n,r,s)=>(s=n!=null?w(H(n)):{},M(r||!n||!n.__esModule?x(s,"default",{value:n,enumerable:!0}):s,n)),A=n=>M(x({},"__esModule",{value:!0}),n);var B={};j(B,{createJourney:()=>b,createJourneyFactory:()=>I});module.exports=A(B);var C=require("@rxova/journey-core");var d=E(require("react"),1),l=require("react/jsx-runtime"),m=typeof window>"u"?d.default.useEffect:d.default.useLayoutEffect,L=(n,r,s)=>{if(s){s(n,r);return}console.error(`JourneyProvider ${r.phase} failed.`,n)},h=(n,r)=>{let s=d.default.createContext(null),y=(a="hook")=>{let e=d.default.useContext(s);if(!e)throw new Error(`${a} must be used within JourneyProvider.`);return e},c=({runtimeMachine:a,onError:e,disposeOnUnmount:t})=>{let o=d.default.useRef(e),u=d.default.useRef(null);o.current=e,m(()=>{u.current!==null&&(globalThis.clearTimeout(u.current),u.current=null)});let J=d.default.useCallback(i=>i.status,[a]),S=d.default.useCallback(i=>a.subscribeSelector(J,()=>{i()}),[a,J]),v=d.default.useCallback(()=>a.getSnapshot().status,[a]),T=d.default.useSyncExternalStore(S,v,v);return m(()=>{T==="idled"&&a.startJourney().catch(i=>{L(i,{phase:"start"},o.current)})},[a,T]),m(()=>{if(t)return()=>{u.current=globalThis.setTimeout(()=>{u.current=null,a.dispose()},0)}},[a,t]),null};return{JourneyProvider:({views:a,onError:e,disposeOnUnmount:t=!1,children:o})=>{let u=n;return(0,l.jsxs)(s.Provider,{value:a,children:[o,(0,l.jsx)(c,{runtimeMachine:u,onError:e,disposeOnUnmount:t})]})},StepRenderer:({fallback:a=null})=>{let e=r(J=>J.currentStepId),o=y("StepRenderer")[e];if(!o)return(0,l.jsx)(l.Fragment,{children:a});let u=o;return(0,l.jsx)(d.default.Fragment,{children:(0,l.jsx)(u,{})},e)}}};var p=E(require("react"),1),q=typeof window>"u"?p.default.useEffect:p.default.useLayoutEffect,P=n=>{let r=()=>{let e=n,t=p.default.useCallback(()=>e.getSnapshot(),[e]),o=p.default.useCallback(u=>e.subscribe(u),[e]);return p.default.useSyncExternalStore(o,t,t)},s=()=>{let e=r(),t=n;return p.default.useMemo(()=>t.getComputed(),[t,e])},y=(e,t)=>{let o=n,u=t??Object.is,J=p.default.useRef(null),S=p.default.useCallback(()=>{let T=o.getSnapshot(),i=J.current;if(i&&Object.is(i.machine,o)&&Object.is(i.selector,e)&&Object.is(i.isEqual,u)&&Object.is(i.snapshot,T))return i.selected;let f=e(T);return i&&Object.is(i.machine,o)&&Object.is(i.selector,e)&&Object.is(i.isEqual,u)&&u(i.selected,f)?(J.current={machine:o,snapshot:T,selected:i.selected,selector:e,isEqual:u},i.selected):(J.current={machine:o,snapshot:T,selected:f,selector:e,isEqual:u},f)},[o,u,e]),v=p.default.useCallback(T=>o.subscribeSelector(e,()=>{T()},u),[o,u,e]);return p.default.useSyncExternalStore(v,S,S)},c=e=>{let t=n,o=p.default.useRef(e);o.current=e,q(()=>t.subscribeEvent(u=>{o.current(u)}),[t])};return{useJourneySnapshot:r,useJourneyComputed:s,useJourneySelector:y,useJourneyApi:()=>{let e=n;return p.default.useMemo(()=>({startJourney:e.startJourney,send:e.send,goToNextStep:e.goToNextStep,goToStepById:e.goToStepById,terminateJourney:e.terminateJourney,completeJourney:e.completeJourney,goToPreviousStep:e.goToPreviousStep,goToLastVisitedStep:e.goToLastVisitedStep,clearStepError:e.clearStepError,updateContext:e.updateContext,getStepMeta:e.getStepMeta,resetJourney:()=>e.resetJourney()}),[e])},useStepApi:e=>{let t=n;return p.default.useMemo(()=>({startJourney:t.startJourney,send:t.send,goToNextStep:t.goToNextStep,goToStepById:t.goToStepById,terminateJourney:t.terminateJourney,completeJourney:t.completeJourney,goToPreviousStep:t.goToPreviousStep,goToLastVisitedStep:t.goToLastVisitedStep,clearStepError:t.clearStepError,updateContext:t.updateContext,getStepMeta:t.getStepMeta,resetJourney:()=>t.resetJourney()}),[t])},useJourneyEvent:c,useJourneyStepLifecycle:(e,t)=>{c(o=>{o.type==="step.enter"&&o.stepId===e?t.onEnter?.({context:n.getSnapshot().context}):o.type==="step.exit"&&o.stepId===e&&t.onLeave?.({context:n.getSnapshot().context})})}}};var R=(n,r)=>{let y=(0,C.createJourneyMachine)(n,r),c=P(y),g=h(y,c.useJourneySelector);return{machine:y,dispose:()=>y.dispose(),...c,...g}};function b(n,r){return R(n,r)}function I(n,r){let s=n;return()=>R(s,r)}0&&(module.exports={createJourney,createJourneyFactory});
+//# sourceMappingURL=client.cjs.map

package/dist/client.cjs.map

@@ -0,0 +1,7 @@
+{
+  "version": 3,
+  "sources": ["../src/client.ts", "../src/createJourney.tsx", "../src/provider.tsx", "../src/runtime-hooks.tsx"],
+  "sourcesContent": ["\"use client\";\n\nexport * from \"./index\";\n", "/* eslint-disable no-redeclare */\nimport { createJourneyMachine } from \"@rxova/journey-core\";\nimport type {\n  JourneyDefinition,\n  JourneyJsonObject,\n  JourneyMachineOptions,\n  JourneyMachinePlugin,\n  JourneyMachineWithPlugins\n} from \"@rxova/journey-core\";\nimport { createJourneyProviderArtifacts } from \"./provider\";\nimport { createJourneyHooks } from \"./runtime-hooks\";\nimport type {\n  JourneyRuntime,\n  JourneyRuntimeFactoryFromDefinition,\n  JourneyRuntimeFromDefinition,\n  JourneyRuntimeFactory\n} from \"./types\";\n\ntype JourneyOptionsInput<TPlugins extends readonly JourneyMachinePlugin[]> = JourneyMachineOptions<\n  TPlugins extends [] ? readonly JourneyMachinePlugin[] : TPlugins\n>;\n\nconst createJourneyMachineRuntime = <\n  TContext extends JourneyJsonObject,\n  TStepId extends string,\n  TEventMap extends Record<string, unknown> = Record<never, never>,\n  TStepMeta = unknown,\n  THandlers extends Record<string, unknown> = Record<never, never>,\n  TPlugins extends readonly JourneyMachinePlugin[] = []\n>(\n  definition: JourneyDefinition<TContext, TStepId, TEventMap, TStepMeta, THandlers>,\n  options?: JourneyOptionsInput<TPlugins>\n): JourneyRuntime<TContext, TStepId, TEventMap, TStepMeta, TPlugins, THandlers> => {\n  const machineOptions = options as JourneyMachineOptions<TPlugins> | undefined;\n  const machine = createJourneyMachine<\n    TContext,\n    TStepId,\n    TEventMap,\n    TStepMeta,\n    THandlers,\n    TPlugins\n  >(definition, machineOptions) as JourneyMachineWithPlugins<\n    TContext,\n    TStepId,\n    TEventMap,\n    TStepMeta,\n    THandlers,\n    TPlugins\n  >;\n  const hooks = createJourneyHooks<TContext, TStepId, TEventMap, TStepMeta, THandlers, TPlugins>(\n    machine\n  );\n  const providerArtifacts = createJourneyProviderArtifacts<\n    TContext,\n    TStepId,\n    TEventMap,\n    TStepMeta,\n    THandlers,\n    TPlugins\n  >(machine, hooks.useJourneySelector);\n\n  return {\n    machine,\n    dispose: () => machine.dispose(),\n    ...hooks,\n    ...providerArtifacts\n  };\n};\n\n/**\n * Creates a journey machine and returns React hooks/components bound to that machine.\n * Hooks work without a provider; `JourneyProvider` is only required for `StepRenderer`.\n */\nexport function createJourney<TDefinition, TPlugins extends readonly JourneyMachinePlugin[] = []>(\n  definition: TDefinition,\n  options?: JourneyOptionsInput<TPlugins>\n): JourneyRuntimeFromDefinition<TDefinition, TPlugins>;\nexport function createJourney<\n  TContext extends JourneyJsonObject,\n  TStepId extends string,\n  TEventMap extends Record<string, unknown> = Record<never, never>,\n  TStepMeta = unknown,\n  THandlers extends Record<string, unknown> = Record<never, never>,\n  TPlugins extends readonly JourneyMachinePlugin[] = []\n>(\n  definition: JourneyDefinition<TContext, TStepId, TEventMap, TStepMeta, THandlers>,\n  options?: JourneyOptionsInput<TPlugins>\n): JourneyRuntime<TContext, TStepId, TEventMap, TStepMeta, TPlugins, THandlers> {\n  return createJourneyMachineRuntime(definition, options);\n}\n\n/**\n * Creates a typed factory for producing fresh React-bound journey runtimes.\n * Use this when a component or route boundary needs independent instances\n * from the same definition/options pair.\n */\nexport function createJourneyFactory<\n  TDefinition,\n  TPlugins extends readonly JourneyMachinePlugin[] = []\n>(\n  definition: TDefinition,\n  options?: JourneyOptionsInput<TPlugins>\n): JourneyRuntimeFactoryFromDefinition<TDefinition, TPlugins>;\nexport function createJourneyFactory<\n  TContext extends JourneyJsonObject,\n  TStepId extends string,\n  TEventMap extends Record<string, unknown> = Record<never, never>,\n  TStepMeta = unknown,\n  THandlers extends Record<string, unknown> = Record<never, never>,\n  TPlugins extends readonly JourneyMachinePlugin[] = []\n>(\n  definition: JourneyDefinition<TContext, TStepId, TEventMap, TStepMeta, THandlers>,\n  options?: JourneyOptionsInput<TPlugins>\n): JourneyRuntimeFactory<TContext, TStepId, TEventMap, TStepMeta, TPlugins, THandlers> {\n  const runtimeDefinition = definition as JourneyDefinition<\n    TContext,\n    TStepId,\n    TEventMap,\n    TStepMeta,\n    THandlers\n  >;\n\n  return () =>\n    createJourneyMachineRuntime(\n      runtimeDefinition,\n      options as JourneyOptionsInput<TPlugins> | undefined\n    );\n}\n", "import React from \"react\";\n\nimport type {\n  JourneyEqualityFn,\n  JourneyJsonObject,\n  JourneySelector,\n  JourneyMachineWithPlugins,\n  JourneyMachinePlugin\n} from \"@rxova/journey-core\";\nimport type { JourneyProviderErrorContext, JourneyProviderProps, JourneyViews } from \"./types\";\n\nconst useSafeLayoutEffect = typeof window === \"undefined\" ? React.useEffect : React.useLayoutEffect;\n\nconst reportProviderError = (\n  error: unknown,\n  context: JourneyProviderErrorContext,\n  listener?: ((error: unknown, context: JourneyProviderErrorContext) => void) | undefined\n) => {\n  if (listener) {\n    listener(error, context);\n    return;\n  }\n\n  console.error(`JourneyProvider ${context.phase} failed.`, error);\n};\n\nexport const createJourneyProviderArtifacts = <\n  TContext extends JourneyJsonObject,\n  TStepId extends string,\n  TEventMap extends Record<string, unknown> = Record<never, never>,\n  TStepMeta = unknown,\n  THandlers extends Record<string, unknown> = Record<never, never>,\n  TPlugins extends readonly JourneyMachinePlugin[] = []\n>(\n  machine: JourneyMachineWithPlugins<TContext, TStepId, TEventMap, TStepMeta, THandlers, TPlugins>,\n  useJourneySelector: <TSelected>(\n    selector: JourneySelector<TContext, TStepId, TSelected>,\n    equalityFn?: JourneyEqualityFn<TSelected>\n  ) => TSelected\n) => {\n  const ViewsContext = React.createContext<JourneyViews<TStepId> | null>(null);\n\n  const useJourneyViews = (hookName = \"hook\") => {\n    const views = React.useContext(ViewsContext);\n    if (!views) {\n      throw new Error(`${hookName} must be used within JourneyProvider.`);\n    }\n    return views;\n  };\n\n  const ProviderController = ({\n    runtimeMachine,\n    onError,\n    disposeOnUnmount\n  }: {\n    runtimeMachine: typeof machine;\n    onError: JourneyProviderProps<TStepId>[\"onError\"] | undefined;\n    disposeOnUnmount: boolean;\n  }) => {\n    const onErrorRef = React.useRef(onError);\n    const scheduledDisposeRef = React.useRef<ReturnType<typeof globalThis.setTimeout> | null>(null);\n    onErrorRef.current = onError;\n\n    useSafeLayoutEffect(() => {\n      if (scheduledDisposeRef.current === null) {\n        return;\n      }\n\n      globalThis.clearTimeout(scheduledDisposeRef.current);\n      scheduledDisposeRef.current = null;\n    });\n\n    const selectStatus = React.useCallback(\n      (snapshot: ReturnType<typeof runtimeMachine.getSnapshot>) => snapshot.status,\n      [runtimeMachine]\n    );\n    const subscribeToStatus = React.useCallback(\n      (onStoreChange: () => void) =>\n        runtimeMachine.subscribeSelector(selectStatus, () => {\n          onStoreChange();\n        }),\n      [runtimeMachine, selectStatus]\n    );\n    const getStatus = React.useCallback(\n      () => runtimeMachine.getSnapshot().status,\n      [runtimeMachine]\n    );\n    const status = React.useSyncExternalStore(subscribeToStatus, getStatus, getStatus);\n\n    useSafeLayoutEffect(() => {\n      if (status === \"idled\") {\n        void runtimeMachine.startJourney().catch((error) => {\n          reportProviderError(error, { phase: \"start\" }, onErrorRef.current);\n        });\n      }\n    }, [runtimeMachine, status]);\n\n    useSafeLayoutEffect(() => {\n      if (!disposeOnUnmount) {\n        return;\n      }\n\n      return () => {\n        scheduledDisposeRef.current = globalThis.setTimeout(() => {\n          scheduledDisposeRef.current = null;\n          runtimeMachine.dispose();\n        }, 0);\n      };\n    }, [runtimeMachine, disposeOnUnmount]);\n\n    return null;\n  };\n\n  const JourneyProvider = ({\n    views,\n    onError,\n    disposeOnUnmount = false,\n    children\n  }: JourneyProviderProps<TStepId>) => {\n    const runtimeMachine = machine;\n\n    return (\n      <ViewsContext.Provider value={views}>\n        {children}\n        <ProviderController\n          runtimeMachine={runtimeMachine}\n          onError={onError}\n          disposeOnUnmount={disposeOnUnmount}\n        />\n      </ViewsContext.Provider>\n    );\n  };\n\n  const StepRenderer = ({ fallback = null }: { fallback?: React.ReactNode }) => {\n    const currentStepId = useJourneySelector((snapshot) => snapshot.currentStepId);\n    const views = useJourneyViews(\"StepRenderer\");\n    const StepComponent = views[currentStepId];\n\n    if (!StepComponent) {\n      return <>{fallback}</>;\n    }\n\n    const StepView = StepComponent as React.ComponentType;\n\n    return (\n      <React.Fragment key={currentStepId}>\n        <StepView />\n      </React.Fragment>\n    );\n  };\n\n  return {\n    JourneyProvider,\n    StepRenderer\n  };\n};\n", "import React from \"react\";\n\nimport type {\n  JourneyBuilderCustomEventKey,\n  JourneyComputed,\n  JourneyEqualityFn,\n  JourneyJsonObject,\n  JourneyMachinePlugin,\n  JourneyMachineWithPlugins,\n  JourneyObservationEvent,\n  JourneySelector,\n  JourneySnapshot\n} from \"@rxova/journey-core\";\nimport type { JourneyApi, StepScopedJourneyApi } from \"./types\";\n\ntype SelectorCache<TContext extends JourneyJsonObject, TStepId extends string, TSelected> = {\n  machine: unknown;\n  snapshot: JourneySnapshot<TContext, TStepId>;\n  selected: TSelected;\n  selector: unknown;\n  isEqual: JourneyEqualityFn<TSelected>;\n};\n\nconst useSafeLayoutEffect = typeof window === \"undefined\" ? React.useEffect : React.useLayoutEffect;\n\nexport const createJourneyHooks = <\n  TContext extends JourneyJsonObject,\n  TStepId extends string,\n  TEventMap extends Record<string, unknown> = Record<never, never>,\n  TStepMeta = unknown,\n  THandlers extends Record<string, unknown> = Record<never, never>,\n  TPlugins extends readonly JourneyMachinePlugin[] = [],\n  TStepHandledCustomEventMap extends Record<TStepId, JourneyBuilderCustomEventKey<TEventMap>> =\n    Record<TStepId, never>,\n  TGlobalHandledCustomEventType extends JourneyBuilderCustomEventKey<TEventMap> = never\n>(\n  machine: JourneyMachineWithPlugins<TContext, TStepId, TEventMap, TStepMeta, THandlers, TPlugins>\n) => {\n  const useJourneySnapshot = (): JourneySnapshot<TContext, TStepId> => {\n    const runtimeMachine = machine;\n    const getSnapshot = React.useCallback(() => runtimeMachine.getSnapshot(), [runtimeMachine]);\n    const subscribe = React.useCallback(\n      (onStoreChange: () => void) => runtimeMachine.subscribe(onStoreChange),\n      [runtimeMachine]\n    );\n\n    return React.useSyncExternalStore(subscribe, getSnapshot, getSnapshot);\n  };\n\n  const useJourneyComputed = (): JourneyComputed<TStepId> => {\n    const snapshot = useJourneySnapshot();\n    const runtimeMachine = machine;\n    return React.useMemo(() => {\n      void snapshot;\n      return runtimeMachine.getComputed();\n    }, [runtimeMachine, snapshot]);\n  };\n\n  const useJourneySelector = <TSelected,>(\n    selector: JourneySelector<TContext, TStepId, TSelected>,\n    equalityFn?: JourneyEqualityFn<TSelected>\n  ): TSelected => {\n    const runtimeMachine = machine;\n    const isEqual = equalityFn ?? Object.is;\n    const cacheRef = React.useRef<SelectorCache<TContext, TStepId, TSelected> | null>(null);\n\n    const getSelectedSnapshot = React.useCallback(() => {\n      const nextSnapshot = runtimeMachine.getSnapshot();\n      const cached = cacheRef.current;\n\n      if (\n        cached &&\n        Object.is(cached.machine, runtimeMachine) &&\n        Object.is(cached.selector, selector) &&\n        Object.is(cached.isEqual, isEqual) &&\n        Object.is(cached.snapshot, nextSnapshot)\n      ) {\n        return cached.selected;\n      }\n\n      const nextSelected = selector(nextSnapshot);\n\n      if (\n        cached &&\n        Object.is(cached.machine, runtimeMachine) &&\n        Object.is(cached.selector, selector) &&\n        Object.is(cached.isEqual, isEqual) &&\n        isEqual(cached.selected, nextSelected)\n      ) {\n        cacheRef.current = {\n          machine: runtimeMachine,\n          snapshot: nextSnapshot,\n          selected: cached.selected,\n          selector,\n          isEqual\n        };\n        return cached.selected;\n      }\n\n      cacheRef.current = {\n        machine: runtimeMachine,\n        snapshot: nextSnapshot,\n        selected: nextSelected,\n        selector,\n        isEqual\n      };\n      return nextSelected;\n    }, [runtimeMachine, isEqual, selector]);\n\n    const subscribeToSelectedSnapshot = React.useCallback(\n      (onStoreChange: () => void) =>\n        runtimeMachine.subscribeSelector(\n          selector,\n          () => {\n            onStoreChange();\n          },\n          isEqual\n        ),\n      [runtimeMachine, isEqual, selector]\n    );\n\n    return React.useSyncExternalStore(\n      subscribeToSelectedSnapshot,\n      getSelectedSnapshot,\n      getSelectedSnapshot\n    );\n  };\n\n  const useJourneyEvent = (\n    listener: (event: JourneyObservationEvent<TStepId, TEventMap>) => void\n  ): void => {\n    const runtimeMachine = machine;\n    const listenerRef = React.useRef(listener);\n    listenerRef.current = listener;\n\n    useSafeLayoutEffect(() => {\n      return runtimeMachine.subscribeEvent((event) => {\n        listenerRef.current(event);\n      });\n    }, [runtimeMachine]);\n  };\n\n  const useJourneyStepLifecycle = (\n    stepId: TStepId,\n    callbacks: {\n      onEnter?: (args: { context: TContext }) => void;\n      onLeave?: (args: { context: TContext }) => void;\n    }\n  ): void => {\n    useJourneyEvent((event) => {\n      if (event.type === \"step.enter\" && event.stepId === stepId) {\n        callbacks.onEnter?.({ context: machine.getSnapshot().context });\n      } else if (event.type === \"step.exit\" && event.stepId === stepId) {\n        callbacks.onLeave?.({ context: machine.getSnapshot().context });\n      }\n    });\n  };\n\n  const useJourneyApi = (): JourneyApi<TContext, TStepId, TEventMap, TStepMeta> => {\n    const runtimeMachine = machine;\n    return React.useMemo(\n      () => ({\n        startJourney: runtimeMachine.startJourney,\n        send: runtimeMachine.send,\n        goToNextStep: runtimeMachine.goToNextStep,\n        goToStepById: runtimeMachine.goToStepById,\n        terminateJourney: runtimeMachine.terminateJourney,\n        completeJourney: runtimeMachine.completeJourney,\n        goToPreviousStep: runtimeMachine.goToPreviousStep,\n        goToLastVisitedStep: runtimeMachine.goToLastVisitedStep,\n        clearStepError: runtimeMachine.clearStepError,\n        updateContext: runtimeMachine.updateContext,\n        getStepMeta: runtimeMachine.getStepMeta,\n        resetJourney: () => runtimeMachine.resetJourney()\n      }),\n      [runtimeMachine]\n    );\n  };\n\n  const useStepApi = <TStepKey extends TStepId>(\n    stepId: TStepKey\n  ): StepScopedJourneyApi<\n    TContext,\n    TStepId,\n    TEventMap,\n    Extract<\n      TStepHandledCustomEventMap[TStepKey] | TGlobalHandledCustomEventType,\n      keyof TEventMap & string\n    >,\n    TStepMeta\n  > => {\n    const runtimeMachine = machine;\n    void stepId;\n    return React.useMemo(\n      () => ({\n        startJourney: runtimeMachine.startJourney,\n        send: runtimeMachine.send,\n        goToNextStep: runtimeMachine.goToNextStep,\n        goToStepById: runtimeMachine.goToStepById,\n        terminateJourney: runtimeMachine.terminateJourney,\n        completeJourney: runtimeMachine.completeJourney,\n        goToPreviousStep: runtimeMachine.goToPreviousStep,\n        goToLastVisitedStep: runtimeMachine.goToLastVisitedStep,\n        clearStepError: runtimeMachine.clearStepError,\n        updateContext: runtimeMachine.updateContext,\n        getStepMeta: runtimeMachine.getStepMeta,\n        resetJourney: () => runtimeMachine.resetJourney()\n      }),\n      [runtimeMachine]\n    ) as StepScopedJourneyApi<\n      TContext,\n      TStepId,\n      TEventMap,\n      Extract<\n        TStepHandledCustomEventMap[TStepKey] | TGlobalHandledCustomEventType,\n        keyof TEventMap & string\n      >,\n      TStepMeta\n    >;\n  };\n\n  return {\n    useJourneySnapshot,\n    useJourneyComputed,\n    useJourneySelector,\n    useJourneyApi,\n    useStepApi,\n    useJourneyEvent,\n    useJourneyStepLifecycle\n  };\n};\n"],
+  "mappings": "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",
+  "names": ["client_exports", "__export", "createJourney", "createJourneyFactory", "__toCommonJS", "import_journey_core", "import_react", "import_jsx_runtime", "useSafeLayoutEffect", "React", "reportProviderError", "error", "context", "listener", "createJourneyProviderArtifacts", "machine", "useJourneySelector", "ViewsContext", "useJourneyViews", "hookName", "views", "ProviderController", "runtimeMachine", "onError", "disposeOnUnmount", "onErrorRef", "scheduledDisposeRef", "selectStatus", "snapshot", "subscribeToStatus", "onStoreChange", "getStatus", "status", "children", "fallback", "currentStepId", "StepComponent", "StepView", "import_react", "useSafeLayoutEffect", "React", "createJourneyHooks", "machine", "useJourneySnapshot", "runtimeMachine", "getSnapshot", "subscribe", "onStoreChange", "useJourneyComputed", "snapshot", "useJourneySelector", "selector", "equalityFn", "isEqual", "cacheRef", "getSelectedSnapshot", "nextSnapshot", "cached", "nextSelected", "subscribeToSelectedSnapshot", "useJourneyEvent", "listener", "listenerRef", "event", "stepId", "callbacks", "createJourneyMachineRuntime", "definition", "options", "machine", "hooks", "createJourneyHooks", "providerArtifacts", "createJourneyProviderArtifacts", "createJourney", "createJourneyFactory", "runtimeDefinition"]
+}

package/dist/client.d.cts

@@ -0,0 +1 @@
+export * from "./index";

package/dist/client.d.ts

@@ -0,0 +1 @@
+export * from "./index";

package/dist/client.js

@@ -0,0 +1,2 @@
+"use client";import{createJourneyMachine as I}from"@rxova/journey-core";import p from"react";import{Fragment as R,jsx as v,jsxs as C}from"react/jsx-runtime";var f=typeof window>"u"?p.useEffect:p.useLayoutEffect,P=(r,i,c)=>{if(c){c(r,i);return}console.error(`JourneyProvider ${i.phase} failed.`,r)},m=(r,i)=>{let c=p.createContext(null),y=(s="hook")=>{let e=p.useContext(c);if(!e)throw new Error(`${s} must be used within JourneyProvider.`);return e},l=({runtimeMachine:s,onError:e,disposeOnUnmount:n})=>{let t=p.useRef(e),o=p.useRef(null);t.current=e,f(()=>{o.current!==null&&(globalThis.clearTimeout(o.current),o.current=null)});let T=p.useCallback(u=>u.status,[s]),J=p.useCallback(u=>s.subscribeSelector(T,()=>{u()}),[s,T]),S=p.useCallback(()=>s.getSnapshot().status,[s]),d=p.useSyncExternalStore(J,S,S);return f(()=>{d==="idled"&&s.startJourney().catch(u=>{P(u,{phase:"start"},t.current)})},[s,d]),f(()=>{if(n)return()=>{o.current=globalThis.setTimeout(()=>{o.current=null,s.dispose()},0)}},[s,n]),null};return{JourneyProvider:({views:s,onError:e,disposeOnUnmount:n=!1,children:t})=>{let o=r;return C(c.Provider,{value:s,children:[t,v(l,{runtimeMachine:o,onError:e,disposeOnUnmount:n})]})},StepRenderer:({fallback:s=null})=>{let e=i(T=>T.currentStepId),t=y("StepRenderer")[e];if(!t)return v(R,{children:s});let o=t;return v(p.Fragment,{children:v(o,{})},e)}}};import a from"react";var b=typeof window>"u"?a.useEffect:a.useLayoutEffect,M=r=>{let i=()=>{let e=r,n=a.useCallback(()=>e.getSnapshot(),[e]),t=a.useCallback(o=>e.subscribe(o),[e]);return a.useSyncExternalStore(t,n,n)},c=()=>{let e=i(),n=r;return a.useMemo(()=>n.getComputed(),[n,e])},y=(e,n)=>{let t=r,o=n??Object.is,T=a.useRef(null),J=a.useCallback(()=>{let d=t.getSnapshot(),u=T.current;if(u&&Object.is(u.machine,t)&&Object.is(u.selector,e)&&Object.is(u.isEqual,o)&&Object.is(u.snapshot,d))return u.selected;let g=e(d);return u&&Object.is(u.machine,t)&&Object.is(u.selector,e)&&Object.is(u.isEqual,o)&&o(u.selected,g)?(T.current={machine:t,snapshot:d,selected:u.selected,selector:e,isEqual:o},u.selected):(T.current={machine:t,snapshot:d,selected:g,selector:e,isEqual:o},g)},[t,o,e]),S=a.useCallback(d=>t.subscribeSelector(e,()=>{d()},o),[t,o,e]);return a.useSyncExternalStore(S,J,J)},l=e=>{let n=r,t=a.useRef(e);t.current=e,b(()=>n.subscribeEvent(o=>{t.current(o)}),[n])};return{useJourneySnapshot:i,useJourneyComputed:c,useJourneySelector:y,useJourneyApi:()=>{let e=r;return a.useMemo(()=>({startJourney:e.startJourney,send:e.send,goToNextStep:e.goToNextStep,goToStepById:e.goToStepById,terminateJourney:e.terminateJourney,completeJourney:e.completeJourney,goToPreviousStep:e.goToPreviousStep,goToLastVisitedStep:e.goToLastVisitedStep,clearStepError:e.clearStepError,updateContext:e.updateContext,getStepMeta:e.getStepMeta,resetJourney:()=>e.resetJourney()}),[e])},useStepApi:e=>{let n=r;return a.useMemo(()=>({startJourney:n.startJourney,send:n.send,goToNextStep:n.goToNextStep,goToStepById:n.goToStepById,terminateJourney:n.terminateJourney,completeJourney:n.completeJourney,goToPreviousStep:n.goToPreviousStep,goToLastVisitedStep:n.goToLastVisitedStep,clearStepError:n.clearStepError,updateContext:n.updateContext,getStepMeta:n.getStepMeta,resetJourney:()=>n.resetJourney()}),[n])},useJourneyEvent:l,useJourneyStepLifecycle:(e,n)=>{l(t=>{t.type==="step.enter"&&t.stepId===e?n.onEnter?.({context:r.getSnapshot().context}):t.type==="step.exit"&&t.stepId===e&&n.onLeave?.({context:r.getSnapshot().context})})}}};var E=(r,i)=>{let y=I(r,i),l=M(y),x=m(y,l.useJourneySelector);return{machine:y,dispose:()=>y.dispose(),...l,...x}};function O(r,i){return E(r,i)}function w(r,i){let c=r;return()=>E(c,i)}export{O as createJourney,w as createJourneyFactory};
+//# sourceMappingURL=client.js.map

package/dist/client.js.map

@@ -0,0 +1,7 @@
+{
+  "version": 3,
+  "sources": ["../src/createJourney.tsx", "../src/provider.tsx", "../src/runtime-hooks.tsx"],
+  "sourcesContent": ["/* eslint-disable no-redeclare */\nimport { createJourneyMachine } from \"@rxova/journey-core\";\nimport type {\n  JourneyDefinition,\n  JourneyJsonObject,\n  JourneyMachineOptions,\n  JourneyMachinePlugin,\n  JourneyMachineWithPlugins\n} from \"@rxova/journey-core\";\nimport { createJourneyProviderArtifacts } from \"./provider\";\nimport { createJourneyHooks } from \"./runtime-hooks\";\nimport type {\n  JourneyRuntime,\n  JourneyRuntimeFactoryFromDefinition,\n  JourneyRuntimeFromDefinition,\n  JourneyRuntimeFactory\n} from \"./types\";\n\ntype JourneyOptionsInput<TPlugins extends readonly JourneyMachinePlugin[]> = JourneyMachineOptions<\n  TPlugins extends [] ? readonly JourneyMachinePlugin[] : TPlugins\n>;\n\nconst createJourneyMachineRuntime = <\n  TContext extends JourneyJsonObject,\n  TStepId extends string,\n  TEventMap extends Record<string, unknown> = Record<never, never>,\n  TStepMeta = unknown,\n  THandlers extends Record<string, unknown> = Record<never, never>,\n  TPlugins extends readonly JourneyMachinePlugin[] = []\n>(\n  definition: JourneyDefinition<TContext, TStepId, TEventMap, TStepMeta, THandlers>,\n  options?: JourneyOptionsInput<TPlugins>\n): JourneyRuntime<TContext, TStepId, TEventMap, TStepMeta, TPlugins, THandlers> => {\n  const machineOptions = options as JourneyMachineOptions<TPlugins> | undefined;\n  const machine = createJourneyMachine<\n    TContext,\n    TStepId,\n    TEventMap,\n    TStepMeta,\n    THandlers,\n    TPlugins\n  >(definition, machineOptions) as JourneyMachineWithPlugins<\n    TContext,\n    TStepId,\n    TEventMap,\n    TStepMeta,\n    THandlers,\n    TPlugins\n  >;\n  const hooks = createJourneyHooks<TContext, TStepId, TEventMap, TStepMeta, THandlers, TPlugins>(\n    machine\n  );\n  const providerArtifacts = createJourneyProviderArtifacts<\n    TContext,\n    TStepId,\n    TEventMap,\n    TStepMeta,\n    THandlers,\n    TPlugins\n  >(machine, hooks.useJourneySelector);\n\n  return {\n    machine,\n    dispose: () => machine.dispose(),\n    ...hooks,\n    ...providerArtifacts\n  };\n};\n\n/**\n * Creates a journey machine and returns React hooks/components bound to that machine.\n * Hooks work without a provider; `JourneyProvider` is only required for `StepRenderer`.\n */\nexport function createJourney<TDefinition, TPlugins extends readonly JourneyMachinePlugin[] = []>(\n  definition: TDefinition,\n  options?: JourneyOptionsInput<TPlugins>\n): JourneyRuntimeFromDefinition<TDefinition, TPlugins>;\nexport function createJourney<\n  TContext extends JourneyJsonObject,\n  TStepId extends string,\n  TEventMap extends Record<string, unknown> = Record<never, never>,\n  TStepMeta = unknown,\n  THandlers extends Record<string, unknown> = Record<never, never>,\n  TPlugins extends readonly JourneyMachinePlugin[] = []\n>(\n  definition: JourneyDefinition<TContext, TStepId, TEventMap, TStepMeta, THandlers>,\n  options?: JourneyOptionsInput<TPlugins>\n): JourneyRuntime<TContext, TStepId, TEventMap, TStepMeta, TPlugins, THandlers> {\n  return createJourneyMachineRuntime(definition, options);\n}\n\n/**\n * Creates a typed factory for producing fresh React-bound journey runtimes.\n * Use this when a component or route boundary needs independent instances\n * from the same definition/options pair.\n */\nexport function createJourneyFactory<\n  TDefinition,\n  TPlugins extends readonly JourneyMachinePlugin[] = []\n>(\n  definition: TDefinition,\n  options?: JourneyOptionsInput<TPlugins>\n): JourneyRuntimeFactoryFromDefinition<TDefinition, TPlugins>;\nexport function createJourneyFactory<\n  TContext extends JourneyJsonObject,\n  TStepId extends string,\n  TEventMap extends Record<string, unknown> = Record<never, never>,\n  TStepMeta = unknown,\n  THandlers extends Record<string, unknown> = Record<never, never>,\n  TPlugins extends readonly JourneyMachinePlugin[] = []\n>(\n  definition: JourneyDefinition<TContext, TStepId, TEventMap, TStepMeta, THandlers>,\n  options?: JourneyOptionsInput<TPlugins>\n): JourneyRuntimeFactory<TContext, TStepId, TEventMap, TStepMeta, TPlugins, THandlers> {\n  const runtimeDefinition = definition as JourneyDefinition<\n    TContext,\n    TStepId,\n    TEventMap,\n    TStepMeta,\n    THandlers\n  >;\n\n  return () =>\n    createJourneyMachineRuntime(\n      runtimeDefinition,\n      options as JourneyOptionsInput<TPlugins> | undefined\n    );\n}\n", "import React from \"react\";\n\nimport type {\n  JourneyEqualityFn,\n  JourneyJsonObject,\n  JourneySelector,\n  JourneyMachineWithPlugins,\n  JourneyMachinePlugin\n} from \"@rxova/journey-core\";\nimport type { JourneyProviderErrorContext, JourneyProviderProps, JourneyViews } from \"./types\";\n\nconst useSafeLayoutEffect = typeof window === \"undefined\" ? React.useEffect : React.useLayoutEffect;\n\nconst reportProviderError = (\n  error: unknown,\n  context: JourneyProviderErrorContext,\n  listener?: ((error: unknown, context: JourneyProviderErrorContext) => void) | undefined\n) => {\n  if (listener) {\n    listener(error, context);\n    return;\n  }\n\n  console.error(`JourneyProvider ${context.phase} failed.`, error);\n};\n\nexport const createJourneyProviderArtifacts = <\n  TContext extends JourneyJsonObject,\n  TStepId extends string,\n  TEventMap extends Record<string, unknown> = Record<never, never>,\n  TStepMeta = unknown,\n  THandlers extends Record<string, unknown> = Record<never, never>,\n  TPlugins extends readonly JourneyMachinePlugin[] = []\n>(\n  machine: JourneyMachineWithPlugins<TContext, TStepId, TEventMap, TStepMeta, THandlers, TPlugins>,\n  useJourneySelector: <TSelected>(\n    selector: JourneySelector<TContext, TStepId, TSelected>,\n    equalityFn?: JourneyEqualityFn<TSelected>\n  ) => TSelected\n) => {\n  const ViewsContext = React.createContext<JourneyViews<TStepId> | null>(null);\n\n  const useJourneyViews = (hookName = \"hook\") => {\n    const views = React.useContext(ViewsContext);\n    if (!views) {\n      throw new Error(`${hookName} must be used within JourneyProvider.`);\n    }\n    return views;\n  };\n\n  const ProviderController = ({\n    runtimeMachine,\n    onError,\n    disposeOnUnmount\n  }: {\n    runtimeMachine: typeof machine;\n    onError: JourneyProviderProps<TStepId>[\"onError\"] | undefined;\n    disposeOnUnmount: boolean;\n  }) => {\n    const onErrorRef = React.useRef(onError);\n    const scheduledDisposeRef = React.useRef<ReturnType<typeof globalThis.setTimeout> | null>(null);\n    onErrorRef.current = onError;\n\n    useSafeLayoutEffect(() => {\n      if (scheduledDisposeRef.current === null) {\n        return;\n      }\n\n      globalThis.clearTimeout(scheduledDisposeRef.current);\n      scheduledDisposeRef.current = null;\n    });\n\n    const selectStatus = React.useCallback(\n      (snapshot: ReturnType<typeof runtimeMachine.getSnapshot>) => snapshot.status,\n      [runtimeMachine]\n    );\n    const subscribeToStatus = React.useCallback(\n      (onStoreChange: () => void) =>\n        runtimeMachine.subscribeSelector(selectStatus, () => {\n          onStoreChange();\n        }),\n      [runtimeMachine, selectStatus]\n    );\n    const getStatus = React.useCallback(\n      () => runtimeMachine.getSnapshot().status,\n      [runtimeMachine]\n    );\n    const status = React.useSyncExternalStore(subscribeToStatus, getStatus, getStatus);\n\n    useSafeLayoutEffect(() => {\n      if (status === \"idled\") {\n        void runtimeMachine.startJourney().catch((error) => {\n          reportProviderError(error, { phase: \"start\" }, onErrorRef.current);\n        });\n      }\n    }, [runtimeMachine, status]);\n\n    useSafeLayoutEffect(() => {\n      if (!disposeOnUnmount) {\n        return;\n      }\n\n      return () => {\n        scheduledDisposeRef.current = globalThis.setTimeout(() => {\n          scheduledDisposeRef.current = null;\n          runtimeMachine.dispose();\n        }, 0);\n      };\n    }, [runtimeMachine, disposeOnUnmount]);\n\n    return null;\n  };\n\n  const JourneyProvider = ({\n    views,\n    onError,\n    disposeOnUnmount = false,\n    children\n  }: JourneyProviderProps<TStepId>) => {\n    const runtimeMachine = machine;\n\n    return (\n      <ViewsContext.Provider value={views}>\n        {children}\n        <ProviderController\n          runtimeMachine={runtimeMachine}\n          onError={onError}\n          disposeOnUnmount={disposeOnUnmount}\n        />\n      </ViewsContext.Provider>\n    );\n  };\n\n  const StepRenderer = ({ fallback = null }: { fallback?: React.ReactNode }) => {\n    const currentStepId = useJourneySelector((snapshot) => snapshot.currentStepId);\n    const views = useJourneyViews(\"StepRenderer\");\n    const StepComponent = views[currentStepId];\n\n    if (!StepComponent) {\n      return <>{fallback}</>;\n    }\n\n    const StepView = StepComponent as React.ComponentType;\n\n    return (\n      <React.Fragment key={currentStepId}>\n        <StepView />\n      </React.Fragment>\n    );\n  };\n\n  return {\n    JourneyProvider,\n    StepRenderer\n  };\n};\n", "import React from \"react\";\n\nimport type {\n  JourneyBuilderCustomEventKey,\n  JourneyComputed,\n  JourneyEqualityFn,\n  JourneyJsonObject,\n  JourneyMachinePlugin,\n  JourneyMachineWithPlugins,\n  JourneyObservationEvent,\n  JourneySelector,\n  JourneySnapshot\n} from \"@rxova/journey-core\";\nimport type { JourneyApi, StepScopedJourneyApi } from \"./types\";\n\ntype SelectorCache<TContext extends JourneyJsonObject, TStepId extends string, TSelected> = {\n  machine: unknown;\n  snapshot: JourneySnapshot<TContext, TStepId>;\n  selected: TSelected;\n  selector: unknown;\n  isEqual: JourneyEqualityFn<TSelected>;\n};\n\nconst useSafeLayoutEffect = typeof window === \"undefined\" ? React.useEffect : React.useLayoutEffect;\n\nexport const createJourneyHooks = <\n  TContext extends JourneyJsonObject,\n  TStepId extends string,\n  TEventMap extends Record<string, unknown> = Record<never, never>,\n  TStepMeta = unknown,\n  THandlers extends Record<string, unknown> = Record<never, never>,\n  TPlugins extends readonly JourneyMachinePlugin[] = [],\n  TStepHandledCustomEventMap extends Record<TStepId, JourneyBuilderCustomEventKey<TEventMap>> =\n    Record<TStepId, never>,\n  TGlobalHandledCustomEventType extends JourneyBuilderCustomEventKey<TEventMap> = never\n>(\n  machine: JourneyMachineWithPlugins<TContext, TStepId, TEventMap, TStepMeta, THandlers, TPlugins>\n) => {\n  const useJourneySnapshot = (): JourneySnapshot<TContext, TStepId> => {\n    const runtimeMachine = machine;\n    const getSnapshot = React.useCallback(() => runtimeMachine.getSnapshot(), [runtimeMachine]);\n    const subscribe = React.useCallback(\n      (onStoreChange: () => void) => runtimeMachine.subscribe(onStoreChange),\n      [runtimeMachine]\n    );\n\n    return React.useSyncExternalStore(subscribe, getSnapshot, getSnapshot);\n  };\n\n  const useJourneyComputed = (): JourneyComputed<TStepId> => {\n    const snapshot = useJourneySnapshot();\n    const runtimeMachine = machine;\n    return React.useMemo(() => {\n      void snapshot;\n      return runtimeMachine.getComputed();\n    }, [runtimeMachine, snapshot]);\n  };\n\n  const useJourneySelector = <TSelected,>(\n    selector: JourneySelector<TContext, TStepId, TSelected>,\n    equalityFn?: JourneyEqualityFn<TSelected>\n  ): TSelected => {\n    const runtimeMachine = machine;\n    const isEqual = equalityFn ?? Object.is;\n    const cacheRef = React.useRef<SelectorCache<TContext, TStepId, TSelected> | null>(null);\n\n    const getSelectedSnapshot = React.useCallback(() => {\n      const nextSnapshot = runtimeMachine.getSnapshot();\n      const cached = cacheRef.current;\n\n      if (\n        cached &&\n        Object.is(cached.machine, runtimeMachine) &&\n        Object.is(cached.selector, selector) &&\n        Object.is(cached.isEqual, isEqual) &&\n        Object.is(cached.snapshot, nextSnapshot)\n      ) {\n        return cached.selected;\n      }\n\n      const nextSelected = selector(nextSnapshot);\n\n      if (\n        cached &&\n        Object.is(cached.machine, runtimeMachine) &&\n        Object.is(cached.selector, selector) &&\n        Object.is(cached.isEqual, isEqual) &&\n        isEqual(cached.selected, nextSelected)\n      ) {\n        cacheRef.current = {\n          machine: runtimeMachine,\n          snapshot: nextSnapshot,\n          selected: cached.selected,\n          selector,\n          isEqual\n        };\n        return cached.selected;\n      }\n\n      cacheRef.current = {\n        machine: runtimeMachine,\n        snapshot: nextSnapshot,\n        selected: nextSelected,\n        selector,\n        isEqual\n      };\n      return nextSelected;\n    }, [runtimeMachine, isEqual, selector]);\n\n    const subscribeToSelectedSnapshot = React.useCallback(\n      (onStoreChange: () => void) =>\n        runtimeMachine.subscribeSelector(\n          selector,\n          () => {\n            onStoreChange();\n          },\n          isEqual\n        ),\n      [runtimeMachine, isEqual, selector]\n    );\n\n    return React.useSyncExternalStore(\n      subscribeToSelectedSnapshot,\n      getSelectedSnapshot,\n      getSelectedSnapshot\n    );\n  };\n\n  const useJourneyEvent = (\n    listener: (event: JourneyObservationEvent<TStepId, TEventMap>) => void\n  ): void => {\n    const runtimeMachine = machine;\n    const listenerRef = React.useRef(listener);\n    listenerRef.current = listener;\n\n    useSafeLayoutEffect(() => {\n      return runtimeMachine.subscribeEvent((event) => {\n        listenerRef.current(event);\n      });\n    }, [runtimeMachine]);\n  };\n\n  const useJourneyStepLifecycle = (\n    stepId: TStepId,\n    callbacks: {\n      onEnter?: (args: { context: TContext }) => void;\n      onLeave?: (args: { context: TContext }) => void;\n    }\n  ): void => {\n    useJourneyEvent((event) => {\n      if (event.type === \"step.enter\" && event.stepId === stepId) {\n        callbacks.onEnter?.({ context: machine.getSnapshot().context });\n      } else if (event.type === \"step.exit\" && event.stepId === stepId) {\n        callbacks.onLeave?.({ context: machine.getSnapshot().context });\n      }\n    });\n  };\n\n  const useJourneyApi = (): JourneyApi<TContext, TStepId, TEventMap, TStepMeta> => {\n    const runtimeMachine = machine;\n    return React.useMemo(\n      () => ({\n        startJourney: runtimeMachine.startJourney,\n        send: runtimeMachine.send,\n        goToNextStep: runtimeMachine.goToNextStep,\n        goToStepById: runtimeMachine.goToStepById,\n        terminateJourney: runtimeMachine.terminateJourney,\n        completeJourney: runtimeMachine.completeJourney,\n        goToPreviousStep: runtimeMachine.goToPreviousStep,\n        goToLastVisitedStep: runtimeMachine.goToLastVisitedStep,\n        clearStepError: runtimeMachine.clearStepError,\n        updateContext: runtimeMachine.updateContext,\n        getStepMeta: runtimeMachine.getStepMeta,\n        resetJourney: () => runtimeMachine.resetJourney()\n      }),\n      [runtimeMachine]\n    );\n  };\n\n  const useStepApi = <TStepKey extends TStepId>(\n    stepId: TStepKey\n  ): StepScopedJourneyApi<\n    TContext,\n    TStepId,\n    TEventMap,\n    Extract<\n      TStepHandledCustomEventMap[TStepKey] | TGlobalHandledCustomEventType,\n      keyof TEventMap & string\n    >,\n    TStepMeta\n  > => {\n    const runtimeMachine = machine;\n    void stepId;\n    return React.useMemo(\n      () => ({\n        startJourney: runtimeMachine.startJourney,\n        send: runtimeMachine.send,\n        goToNextStep: runtimeMachine.goToNextStep,\n        goToStepById: runtimeMachine.goToStepById,\n        terminateJourney: runtimeMachine.terminateJourney,\n        completeJourney: runtimeMachine.completeJourney,\n        goToPreviousStep: runtimeMachine.goToPreviousStep,\n        goToLastVisitedStep: runtimeMachine.goToLastVisitedStep,\n        clearStepError: runtimeMachine.clearStepError,\n        updateContext: runtimeMachine.updateContext,\n        getStepMeta: runtimeMachine.getStepMeta,\n        resetJourney: () => runtimeMachine.resetJourney()\n      }),\n      [runtimeMachine]\n    ) as StepScopedJourneyApi<\n      TContext,\n      TStepId,\n      TEventMap,\n      Extract<\n        TStepHandledCustomEventMap[TStepKey] | TGlobalHandledCustomEventType,\n        keyof TEventMap & string\n      >,\n      TStepMeta\n    >;\n  };\n\n  return {\n    useJourneySnapshot,\n    useJourneyComputed,\n    useJourneySelector,\n    useJourneyApi,\n    useStepApi,\n    useJourneyEvent,\n    useJourneyStepLifecycle\n  };\n};\n"],
+  "mappings": "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",
+  "names": ["createJourneyMachine", "React", "Fragment", "jsx", "jsxs", "useSafeLayoutEffect", "reportProviderError", "error", "context", "listener", "createJourneyProviderArtifacts", "machine", "useJourneySelector", "ViewsContext", "useJourneyViews", "hookName", "views", "ProviderController", "runtimeMachine", "onError", "disposeOnUnmount", "onErrorRef", "scheduledDisposeRef", "selectStatus", "snapshot", "subscribeToStatus", "onStoreChange", "getStatus", "status", "children", "fallback", "currentStepId", "StepComponent", "StepView", "React", "useSafeLayoutEffect", "createJourneyHooks", "machine", "useJourneySnapshot", "runtimeMachine", "getSnapshot", "subscribe", "onStoreChange", "useJourneyComputed", "snapshot", "useJourneySelector", "selector", "equalityFn", "isEqual", "cacheRef", "getSelectedSnapshot", "nextSnapshot", "cached", "nextSelected", "subscribeToSelectedSnapshot", "useJourneyEvent", "listener", "listenerRef", "event", "stepId", "callbacks", "createJourneyMachineRuntime", "definition", "options", "machine", "createJourneyMachine", "hooks", "createJourneyHooks", "providerArtifacts", "createJourneyProviderArtifacts", "createJourney", "createJourneyFactory", "runtimeDefinition"]
+}

package/dist/createJourney.d.cts

@@ -0,0 +1,15 @@
+import type { JourneyMachineOptions, JourneyMachinePlugin } from "@rxova/journey-core";
+import type { JourneyRuntimeFactoryFromDefinition, JourneyRuntimeFromDefinition } from "./types";
+type JourneyOptionsInput<TPlugins extends readonly JourneyMachinePlugin[]> = JourneyMachineOptions<TPlugins extends [] ? readonly JourneyMachinePlugin[] : TPlugins>;
+/**
+ * Creates a journey machine and returns React hooks/components bound to that machine.
+ * Hooks work without a provider; `JourneyProvider` is only required for `StepRenderer`.
+ */
+export declare function createJourney<TDefinition, TPlugins extends readonly JourneyMachinePlugin[] = []>(definition: TDefinition, options?: JourneyOptionsInput<TPlugins>): JourneyRuntimeFromDefinition<TDefinition, TPlugins>;
+/**
+ * Creates a typed factory for producing fresh React-bound journey runtimes.
+ * Use this when a component or route boundary needs independent instances
+ * from the same definition/options pair.
+ */
+export declare function createJourneyFactory<TDefinition, TPlugins extends readonly JourneyMachinePlugin[] = []>(definition: TDefinition, options?: JourneyOptionsInput<TPlugins>): JourneyRuntimeFactoryFromDefinition<TDefinition, TPlugins>;
+export {};

package/dist/createJourney.d.ts

@@ -0,0 +1,15 @@
+import type { JourneyMachineOptions, JourneyMachinePlugin } from "@rxova/journey-core";
+import type { JourneyRuntimeFactoryFromDefinition, JourneyRuntimeFromDefinition } from "./types";
+type JourneyOptionsInput<TPlugins extends readonly JourneyMachinePlugin[]> = JourneyMachineOptions<TPlugins extends [] ? readonly JourneyMachinePlugin[] : TPlugins>;
+/**
+ * Creates a journey machine and returns React hooks/components bound to that machine.
+ * Hooks work without a provider; `JourneyProvider` is only required for `StepRenderer`.
+ */
+export declare function createJourney<TDefinition, TPlugins extends readonly JourneyMachinePlugin[] = []>(definition: TDefinition, options?: JourneyOptionsInput<TPlugins>): JourneyRuntimeFromDefinition<TDefinition, TPlugins>;
+/**
+ * Creates a typed factory for producing fresh React-bound journey runtimes.
+ * Use this when a component or route boundary needs independent instances
+ * from the same definition/options pair.
+ */
+export declare function createJourneyFactory<TDefinition, TPlugins extends readonly JourneyMachinePlugin[] = []>(definition: TDefinition, options?: JourneyOptionsInput<TPlugins>): JourneyRuntimeFactoryFromDefinition<TDefinition, TPlugins>;
+export {};

package/dist/index.cjs

@@ -1,2 +1,2 @@
-"use strict";"use client";var ne=Object.create;var P=Object.defineProperty;var oe=Object.getOwnPropertyDescriptor;var re=Object.getOwnPropertyNames;var ae=Object.getPrototypeOf,ue=Object.prototype.hasOwnProperty;var se=(o,e)=>{for(var t in e)P(o,t,{get:e[t],enumerable:!0})},_=(o,e,t,r)=>{if(e&&typeof e=="object"||typeof e=="function")for(let n of re(e))!ue.call(o,n)&&n!==t&&P(o,n,{get:()=>e[n],enumerable:!(r=oe(e,n))||r.enumerable});return o};var E=(o,e,t)=>(t=o!=null?ne(ae(o)):{},_(e||!o||!o.__esModule?P(t,"default",{value:o,enumerable:!0}):t,o)),de=o=>_(P({},"__esModule",{value:!0}),o);var Te={};se(Te,{JOURNEY_ASYNC_PHASE:()=>p.JOURNEY_ASYNC_PHASE,JOURNEY_EVENT:()=>p.JOURNEY_EVENT,JOURNEY_STATUS:()=>p.JOURNEY_STATUS,JOURNEY_WILDCARD:()=>p.JOURNEY_WILDCARD,createJourneyBindings:()=>Z,createTransitions:()=>p.createTransitions,tx:()=>p.tx});module.exports=de(Te);var F=E(require("react"),1);var d=E(require("react"),1),w=require("@rxova/journey-core"),H=require("react/jsx-runtime"),pe=typeof window>"u"?d.default.useEffect:d.default.useLayoutEffect,O=({JourneyContext:o,boundJourney:e})=>({journey:r,machine:n,persistence:a,completeOnNoNextStep:u,resetOnJourneyChange:J=!1,resetOnPersistenceChange:T=!1,onStart:s,onComplete:y,onTerminate:i,children:N})=>{let v=r??e,S=d.default.useRef(null),x=d.default.useRef(v),I=d.default.useRef(a),g=d.default.useRef(u),j=d.default.useRef(s),A=d.default.useRef(y),q=d.default.useRef(i),[,ee]=d.default.useReducer(c=>c+1,0),h=s!==void 0,b=y!==void 0,k=i!==void 0;if(j.current=s,A.current=y,q.current=i,!n&&!S.current){let c=a!==void 0||u!==void 0?{...a!==void 0?{persistence:a}:{},...u!==void 0?{completeOnNoNextStep:u}:{}}:void 0;S.current=(0,w.createJourneyMachine)(v,c),x.current=v,I.current=a,g.current=u}let B=!n&&J&&x.current!==v,D=!n&&T&&I.current!==a,L=!n&&g.current!==u;pe(()=>{if(n||!B&&!D&&!L)return;let c=S.current,U=a!==void 0||u!==void 0?{...a!==void 0?{persistence:a}:{},...u!==void 0?{completeOnNoNextStep:u}:{}}:void 0,f=(0,w.createJourneyMachine)(v,U);S.current=f,x.current=v,I.current=a,g.current=u,c&&c!==f&&c.dispose(),ee()},[u,v,n,a,B,D,L]);let l=n??S.current,Y=n?v:x.current,te=d.default.useMemo(()=>({machine:l,journey:Y}),[l,Y]);return d.default.useEffect(()=>{if(!h&&!b&&!k)return;let c=h?l.subscribeStart(m=>{j.current?.(m)}):void 0,U=b?l.subscribeComplete(m=>{A.current?.(m)}):void 0,f=k?l.subscribeTerminate(m=>{q.current?.(m)}):void 0;return()=>{c?.(),U?.(),f?.()}},[h,b,k,l]),d.default.useEffect(()=>()=>{n||!S.current||(S.current.dispose(),S.current=null)},[n]),(0,H.jsx)(o.Provider,{value:te,children:N})};var M=require("react/jsx-runtime"),W=({useJourneySnapshot:o,useJourneyStore:e})=>({fallback:r=null})=>{let n=o(),{journey:a}=e("StepRenderer"),u=a.steps[n.currentStepId]?.component;return u?(0,M.jsx)(u,{},n.currentStepId):(0,M.jsx)(M.Fragment,{children:r})};var $=E(require("react"),1),z=o=>()=>{let{machine:e}=o("useJourneyApi");return $.default.useMemo(()=>({send:async t=>e.send(t),goToNextStep:async()=>e.goToNextStep(),terminateJourney:async t=>e.terminateJourney(t),completeJourney:async t=>e.completeJourney(t),goToPreviousStep:async t=>e.goToPreviousStep(t),goToLastVisitedStep:async()=>e.goToLastVisitedStep(),clearStepError:t=>{e.clearStepError(t)},updateContext:t=>{e.updateContext(t)},updateStepMetadata:(t,r)=>{e.updateStepMetadata(t,r)},resetJourney:()=>{e.resetMachine()}}),[e])};var V=E(require("react"),1),G=o=>e=>{let{machine:t}=o("useJourneyEvent"),r=V.default.useRef(e);r.current=e,V.default.useEffect(()=>t.subscribeEvent(n=>{r.current(n)}),[t])};var K=o=>()=>o("useJourneyMachine").machine;var C=E(require("react"),1),Q=o=>(e,t)=>{let{machine:r}=o("useJourneySelector"),n=t??Object.is,a=C.default.useRef(null),u=C.default.useCallback(()=>{let T=r.getSnapshot(),s=a.current;if(s&&s.selector===e&&s.isEqual===n&&Object.is(s.snapshot,T))return s.selected;let y=e(T);return s&&s.selector===e&&s.isEqual===n&&s.isEqual(s.selected,y)?(a.current={snapshot:T,selected:s.selected,selector:e,isEqual:n},s.selected):(a.current={snapshot:T,selected:y,selector:e,isEqual:n},y)},[r,e,n]),J=C.default.useCallback(T=>r.subscribeSelector(e,()=>{T()},n),[r,e,n]);return C.default.useSyncExternalStore(J,u,u)};var R=E(require("react"),1),X=o=>()=>{let{machine:e}=o("useJourneySnapshot"),t=R.default.useCallback(()=>e.getSnapshot(),[e]),r=R.default.useCallback(n=>e.subscribe(n),[e]);return R.default.useSyncExternalStore(r,t,t)};var Z=o=>{let e=F.default.createContext(null),t=(y="hook")=>{let i=F.default.useContext(e);if(!i)throw new Error(`${y} must be used within bindings.Provider.`);return i},r=X(t),n=Q(t),a=K(t),u=G(t),J=z(t),T=O({JourneyContext:e,boundJourney:o}),s=W({useJourneySnapshot:r,useJourneyStore:t});return{Provider:T,StepRenderer:s,useJourneyApi:J,useJourneyEvent:u,useJourneyMachine:a,useJourneySelector:n,useJourneySnapshot:r}};var p=require("@rxova/journey-core");0&&(module.exports={JOURNEY_ASYNC_PHASE,JOURNEY_EVENT,JOURNEY_STATUS,JOURNEY_WILDCARD,createJourneyBindings,createTransitions,tx});
+"use strict";var w=Object.create;var x=Object.defineProperty;var k=Object.getOwnPropertyDescriptor;var F=Object.getOwnPropertyNames;var H=Object.getPrototypeOf,D=Object.prototype.hasOwnProperty;var j=(n,r)=>{for(var s in r)x(n,s,{get:r[s],enumerable:!0})},M=(n,r,s,y)=>{if(r&&typeof r=="object"||typeof r=="function")for(let c of F(r))!D.call(n,c)&&c!==s&&x(n,c,{get:()=>r[c],enumerable:!(y=k(r,c))||y.enumerable});return n};var E=(n,r,s)=>(s=n!=null?w(H(n)):{},M(r||!n||!n.__esModule?x(s,"default",{value:n,enumerable:!0}):s,n)),A=n=>M(x({},"__esModule",{value:!0}),n);var B={};j(B,{createJourney:()=>b,createJourneyFactory:()=>I});module.exports=A(B);var C=require("@rxova/journey-core");var d=E(require("react"),1),l=require("react/jsx-runtime"),m=typeof window>"u"?d.default.useEffect:d.default.useLayoutEffect,L=(n,r,s)=>{if(s){s(n,r);return}console.error(`JourneyProvider ${r.phase} failed.`,n)},h=(n,r)=>{let s=d.default.createContext(null),y=(a="hook")=>{let e=d.default.useContext(s);if(!e)throw new Error(`${a} must be used within JourneyProvider.`);return e},c=({runtimeMachine:a,onError:e,disposeOnUnmount:t})=>{let o=d.default.useRef(e),u=d.default.useRef(null);o.current=e,m(()=>{u.current!==null&&(globalThis.clearTimeout(u.current),u.current=null)});let J=d.default.useCallback(i=>i.status,[a]),S=d.default.useCallback(i=>a.subscribeSelector(J,()=>{i()}),[a,J]),v=d.default.useCallback(()=>a.getSnapshot().status,[a]),T=d.default.useSyncExternalStore(S,v,v);return m(()=>{T==="idled"&&a.startJourney().catch(i=>{L(i,{phase:"start"},o.current)})},[a,T]),m(()=>{if(t)return()=>{u.current=globalThis.setTimeout(()=>{u.current=null,a.dispose()},0)}},[a,t]),null};return{JourneyProvider:({views:a,onError:e,disposeOnUnmount:t=!1,children:o})=>{let u=n;return(0,l.jsxs)(s.Provider,{value:a,children:[o,(0,l.jsx)(c,{runtimeMachine:u,onError:e,disposeOnUnmount:t})]})},StepRenderer:({fallback:a=null})=>{let e=r(J=>J.currentStepId),o=y("StepRenderer")[e];if(!o)return(0,l.jsx)(l.Fragment,{children:a});let u=o;return(0,l.jsx)(d.default.Fragment,{children:(0,l.jsx)(u,{})},e)}}};var p=E(require("react"),1),q=typeof window>"u"?p.default.useEffect:p.default.useLayoutEffect,P=n=>{let r=()=>{let e=n,t=p.default.useCallback(()=>e.getSnapshot(),[e]),o=p.default.useCallback(u=>e.subscribe(u),[e]);return p.default.useSyncExternalStore(o,t,t)},s=()=>{let e=r(),t=n;return p.default.useMemo(()=>t.getComputed(),[t,e])},y=(e,t)=>{let o=n,u=t??Object.is,J=p.default.useRef(null),S=p.default.useCallback(()=>{let T=o.getSnapshot(),i=J.current;if(i&&Object.is(i.machine,o)&&Object.is(i.selector,e)&&Object.is(i.isEqual,u)&&Object.is(i.snapshot,T))return i.selected;let f=e(T);return i&&Object.is(i.machine,o)&&Object.is(i.selector,e)&&Object.is(i.isEqual,u)&&u(i.selected,f)?(J.current={machine:o,snapshot:T,selected:i.selected,selector:e,isEqual:u},i.selected):(J.current={machine:o,snapshot:T,selected:f,selector:e,isEqual:u},f)},[o,u,e]),v=p.default.useCallback(T=>o.subscribeSelector(e,()=>{T()},u),[o,u,e]);return p.default.useSyncExternalStore(v,S,S)},c=e=>{let t=n,o=p.default.useRef(e);o.current=e,q(()=>t.subscribeEvent(u=>{o.current(u)}),[t])};return{useJourneySnapshot:r,useJourneyComputed:s,useJourneySelector:y,useJourneyApi:()=>{let e=n;return p.default.useMemo(()=>({startJourney:e.startJourney,send:e.send,goToNextStep:e.goToNextStep,goToStepById:e.goToStepById,terminateJourney:e.terminateJourney,completeJourney:e.completeJourney,goToPreviousStep:e.goToPreviousStep,goToLastVisitedStep:e.goToLastVisitedStep,clearStepError:e.clearStepError,updateContext:e.updateContext,getStepMeta:e.getStepMeta,resetJourney:()=>e.resetJourney()}),[e])},useStepApi:e=>{let t=n;return p.default.useMemo(()=>({startJourney:t.startJourney,send:t.send,goToNextStep:t.goToNextStep,goToStepById:t.goToStepById,terminateJourney:t.terminateJourney,completeJourney:t.completeJourney,goToPreviousStep:t.goToPreviousStep,goToLastVisitedStep:t.goToLastVisitedStep,clearStepError:t.clearStepError,updateContext:t.updateContext,getStepMeta:t.getStepMeta,resetJourney:()=>t.resetJourney()}),[t])},useJourneyEvent:c,useJourneyStepLifecycle:(e,t)=>{c(o=>{o.type==="step.enter"&&o.stepId===e?t.onEnter?.({context:n.getSnapshot().context}):o.type==="step.exit"&&o.stepId===e&&t.onLeave?.({context:n.getSnapshot().context})})}}};var R=(n,r)=>{let y=(0,C.createJourneyMachine)(n,r),c=P(y),g=h(y,c.useJourneySelector);return{machine:y,dispose:()=>y.dispose(),...c,...g}};function b(n,r){return R(n,r)}function I(n,r){let s=n;return()=>R(s,r)}0&&(module.exports={createJourney,createJourneyFactory});
 //# sourceMappingURL=index.cjs.map