@cadenza.io/service 2.18.3 → 2.19.0

package/dist/browser/nuxt/index.js

@@ -0,0 +1,166 @@
+"use strict";
+var __defProp = Object.defineProperty;
+var __getOwnPropDesc = Object.getOwnPropertyDescriptor;
+var __getOwnPropNames = Object.getOwnPropertyNames;
+var __hasOwnProp = Object.prototype.hasOwnProperty;
+var __export = (target, all) => {
+  for (var name in all)
+    __defProp(target, name, { get: all[name], enumerable: true });
+};
+var __copyProps = (to, from, except, desc) => {
+  if (from && typeof from === "object" || typeof from === "function") {
+    for (let key of __getOwnPropNames(from))
+      if (!__hasOwnProp.call(to, key) && key !== except)
+        __defProp(to, key, { get: () => from[key], enumerable: !(desc = __getOwnPropDesc(from, key)) || desc.enumerable });
+  }
+  return to;
+};
+var __toCommonJS = (mod) => __copyProps(__defProp({}, "__esModule", { value: true }), mod);
+
+// src/nuxt/index.ts
+var nuxt_exports = {};
+__export(nuxt_exports, {
+  defineCadenzaNuxtRuntimePlugin: () => defineCadenzaNuxtRuntimePlugin,
+  useCadenzaProjectionState: () => useCadenzaProjectionState,
+  useCadenzaRuntime: () => useCadenzaRuntime,
+  useCadenzaRuntimeReady: () => useCadenzaRuntimeReady
+});
+module.exports = __toCommonJS(nuxt_exports);
+
+// src/frontend/runtimeProjectionState.ts
+function cloneProjectionState(value) {
+  if (Array.isArray(value)) {
+    return value.map((item) => cloneProjectionState(item));
+  }
+  if (value && typeof value === "object") {
+    return Object.fromEntries(
+      Object.entries(value).map(([key, nested]) => [
+        key,
+        cloneProjectionState(nested)
+      ])
+    );
+  }
+  return value;
+}
+function resolveInitialProjectionState(value) {
+  const resolved = typeof value === "function" ? value() : value;
+  return cloneProjectionState(resolved);
+}
+function createProjectionRuntimeSnapshot(runtimeState, initialProjectionState) {
+  return {
+    ready: runtimeState?.ready ?? false,
+    projectionState: runtimeState?.projectionState ?? resolveInitialProjectionState(initialProjectionState)
+  };
+}
+
+// src/nuxt/index.ts
+var DEFAULT_HYDRATION_STATE_KEY = "cadenza-hydration";
+var RUNTIME_PROJECTION_STATE_KEY = "__cadenza_runtime_projection_state__";
+var RUNTIME_HOLDER_KEY = "__CADENZA_NUXT_RUNTIME_HOLDER__";
+function getRuntimeHolder() {
+  const globalRecord = globalThis;
+  if (!globalRecord[RUNTIME_HOLDER_KEY]) {
+    globalRecord[RUNTIME_HOLDER_KEY] = {};
+  }
+  return globalRecord[RUNTIME_HOLDER_KEY];
+}
+function resolveBootstrapUrl(bootstrapUrl, runtimeConfig) {
+  return typeof bootstrapUrl === "function" ? bootstrapUrl(runtimeConfig) : bootstrapUrl;
+}
+function defineCadenzaNuxtRuntimePlugin(options) {
+  return () => {
+    const {
+      cadenza,
+      service,
+      bootstrapUrl,
+      hydrationStateKey,
+      initialProjectionState,
+      commands,
+      ...actorOptions
+    } = options;
+    const runtimeConfig = useRuntimeConfig();
+    const hydration = useState(
+      hydrationStateKey ?? DEFAULT_HYDRATION_STATE_KEY,
+      () => ({
+        initialInquiryResults: {}
+      })
+    );
+    const browserRuntimeOptions = {
+      ...actorOptions,
+      initialProjectionState,
+      service: {
+        ...service,
+        bootstrap: {
+          url: resolveBootstrapUrl(bootstrapUrl, runtimeConfig)
+        },
+        hydration: hydration.value
+      }
+    };
+    const projectionState = useState(
+      RUNTIME_PROJECTION_STATE_KEY,
+      () => createProjectionRuntimeSnapshot(void 0, initialProjectionState)
+    );
+    const holder = getRuntimeHolder();
+    if (!holder.runtime) {
+      holder.runtime = cadenza.createBrowserRuntimeActor(browserRuntimeOptions);
+    }
+    holder.unsubscribe?.();
+    holder.unsubscribe = holder.runtime.subscribe((runtimeState) => {
+      projectionState.value = createProjectionRuntimeSnapshot(
+        runtimeState,
+        initialProjectionState
+      );
+    });
+    projectionState.value = createProjectionRuntimeSnapshot(
+      holder.runtime.getRuntimeState(),
+      initialProjectionState
+    );
+    if (!holder.providedRuntime) {
+      const runtimeCommands = commands ? commands({
+        cadenza,
+        runtime: holder.runtime
+      }) : {};
+      holder.providedRuntime = {
+        actor: holder.runtime.actor,
+        actorHandle: holder.runtime,
+        waitUntilReady: holder.runtime.waitUntilReady,
+        inquire: holder.runtime.inquire,
+        getRuntimeState: holder.runtime.getRuntimeState,
+        subscribe: holder.runtime.subscribe,
+        commands: runtimeCommands
+      };
+    }
+    return {
+      provide: {
+        cadenzaRuntime: holder.providedRuntime
+      }
+    };
+  };
+}
+function useCadenzaRuntime() {
+  return useNuxtApp().$cadenzaRuntime;
+}
+function useCadenzaProjectionState() {
+  return useState(
+    RUNTIME_PROJECTION_STATE_KEY,
+    () => ({
+      ready: false,
+      projectionState: {}
+    })
+  );
+}
+function useCadenzaRuntimeReady() {
+  const readyState = {};
+  Object.defineProperty(readyState, "__v_isRef", {
+    value: true,
+    enumerable: false
+  });
+  Object.defineProperty(readyState, "value", {
+    get() {
+      return useCadenzaProjectionState().value.ready;
+    },
+    enumerable: true
+  });
+  return readyState;
+}
+//# sourceMappingURL=index.js.map

package/dist/browser/nuxt/index.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../../src/nuxt/index.ts","../../../src/frontend/runtimeProjectionState.ts"],"sourcesContent":["import type CadenzaService from \"../Cadenza\";\nimport type {\n  BrowserRuntimeActorHandle,\n  BrowserRuntimeActorOptions,\n  BrowserRuntimeServiceOptions,\n  BrowserRuntimeProjectionBinding,\n} from \"../frontend/createBrowserRuntimeActor\";\nimport {\n  createProjectionRuntimeSnapshot,\n  type ProjectionRuntimeSnapshot,\n} from \"../frontend/runtimeProjectionState\";\nimport type { HydrationOptions } from \"../utils/bootstrap\";\n\ntype StateLike<T> = {\n  value: T;\n};\n\ntype ComputedLike<T> = {\n  readonly value: T;\n};\n\ntype RefLike<T> = {\n  readonly value: T;\n  readonly __v_isRef: true;\n};\n\ntype NuxtPluginSetup = () => { provide?: Record<string, unknown> } | void;\n\ndeclare function useState<T>(key: string, init: () => T): StateLike<T>;\ndeclare function useRuntimeConfig(): Record<string, any>;\ndeclare function useNuxtApp(): Record<string, any>;\n\nexport interface CadenzaNuxtRuntimeState<\n  TProjectionState extends Record<string, any> = Record<string, any>,\n> extends ProjectionRuntimeSnapshot<TProjectionState> {}\n\nexport interface CadenzaNuxtRuntime<\n  TProjectionState extends Record<string, any> = Record<string, any>,\n  TCommands extends Record<string, any> = Record<string, never>,\n> {\n  actor: BrowserRuntimeActorHandle<TProjectionState>[\"actor\"];\n  actorHandle: BrowserRuntimeActorHandle<TProjectionState>;\n  waitUntilReady: BrowserRuntimeActorHandle<TProjectionState>[\"waitUntilReady\"];\n  inquire: BrowserRuntimeActorHandle<TProjectionState>[\"inquire\"];\n  getRuntimeState: BrowserRuntimeActorHandle<TProjectionState>[\"getRuntimeState\"];\n  subscribe: BrowserRuntimeActorHandle<TProjectionState>[\"subscribe\"];\n  commands: TCommands;\n}\n\nexport interface CadenzaNuxtRuntimeOptions<\n  TProjectionState extends Record<string, any> = Record<string, any>,\n  TCommands extends Record<string, any> = Record<string, never>,\n> extends Omit<\n    BrowserRuntimeActorOptions<TProjectionState>,\n    \"service\" | \"initialProjectionState\"\n  > {\n  cadenza: typeof CadenzaService;\n  service: Omit<BrowserRuntimeServiceOptions, \"bootstrap\" | \"hydration\">;\n  bootstrapUrl: string | ((config: Record<string, any>) => string);\n  hydrationStateKey?: string;\n  initialProjectionState: TProjectionState | (() => TProjectionState);\n  commands?: (context: {\n    cadenza: typeof CadenzaService;\n    runtime: BrowserRuntimeActorHandle<TProjectionState>;\n  }) => TCommands;\n}\n\ntype NuxtRuntimeHolder<\n  TProjectionState extends Record<string, any> = Record<string, any>,\n  TCommands extends Record<string, any> = Record<string, never>,\n> = {\n  runtime?: BrowserRuntimeActorHandle<TProjectionState>;\n  unsubscribe?: () => void;\n  providedRuntime?: CadenzaNuxtRuntime<TProjectionState, TCommands>;\n};\n\nconst DEFAULT_HYDRATION_STATE_KEY = \"cadenza-hydration\";\nconst RUNTIME_PROJECTION_STATE_KEY = \"__cadenza_runtime_projection_state__\";\nconst RUNTIME_HOLDER_KEY = \"__CADENZA_NUXT_RUNTIME_HOLDER__\";\n\nfunction getRuntimeHolder<\n  TProjectionState extends Record<string, any>,\n  TCommands extends Record<string, any>,\n>(): NuxtRuntimeHolder<TProjectionState, TCommands> {\n  const globalRecord = globalThis as Record<string, unknown>;\n  if (!globalRecord[RUNTIME_HOLDER_KEY]) {\n    globalRecord[RUNTIME_HOLDER_KEY] = {};\n  }\n\n  return globalRecord[RUNTIME_HOLDER_KEY] as NuxtRuntimeHolder<\n    TProjectionState,\n    TCommands\n  >;\n}\n\nfunction resolveBootstrapUrl(\n  bootstrapUrl: string | ((config: Record<string, any>) => string),\n  runtimeConfig: Record<string, any>,\n): string {\n  return typeof bootstrapUrl === \"function\"\n    ? bootstrapUrl(runtimeConfig)\n    : bootstrapUrl;\n}\n\nexport function defineCadenzaNuxtRuntimePlugin<\n  TProjectionState extends Record<string, any>,\n  TCommands extends Record<string, any> = Record<string, never>,\n>(options: CadenzaNuxtRuntimeOptions<TProjectionState, TCommands>): NuxtPluginSetup {\n  return () => {\n    const {\n      cadenza,\n      service,\n      bootstrapUrl,\n      hydrationStateKey,\n      initialProjectionState,\n      commands,\n      ...actorOptions\n    } = options;\n    const runtimeConfig = useRuntimeConfig();\n    const hydration = useState<HydrationOptions>(\n      hydrationStateKey ?? DEFAULT_HYDRATION_STATE_KEY,\n      () => ({\n        initialInquiryResults: {},\n      }),\n    );\n    const browserRuntimeOptions: BrowserRuntimeActorOptions<TProjectionState> = {\n      ...actorOptions,\n      initialProjectionState,\n      service: {\n        ...service,\n        bootstrap: {\n          url: resolveBootstrapUrl(bootstrapUrl, runtimeConfig),\n        },\n        hydration: hydration.value,\n      },\n    };\n    const projectionState = useState<CadenzaNuxtRuntimeState<TProjectionState>>(\n      RUNTIME_PROJECTION_STATE_KEY,\n      () => createProjectionRuntimeSnapshot(undefined, initialProjectionState),\n    );\n    const holder = getRuntimeHolder<TProjectionState, TCommands>();\n\n    if (!holder.runtime) {\n      holder.runtime = cadenza.createBrowserRuntimeActor(browserRuntimeOptions);\n    }\n\n    holder.unsubscribe?.();\n    holder.unsubscribe = holder.runtime.subscribe((runtimeState) => {\n      projectionState.value = createProjectionRuntimeSnapshot(\n        runtimeState,\n        initialProjectionState,\n      );\n    });\n    projectionState.value = createProjectionRuntimeSnapshot(\n      holder.runtime.getRuntimeState(),\n      initialProjectionState,\n    );\n\n    if (!holder.providedRuntime) {\n      const runtimeCommands = commands\n        ? commands({\n            cadenza,\n            runtime: holder.runtime,\n          })\n        : ({} as TCommands);\n\n      holder.providedRuntime = {\n        actor: holder.runtime.actor,\n        actorHandle: holder.runtime,\n        waitUntilReady: holder.runtime.waitUntilReady,\n        inquire: holder.runtime.inquire,\n        getRuntimeState: holder.runtime.getRuntimeState,\n        subscribe: holder.runtime.subscribe,\n        commands: runtimeCommands,\n      };\n    }\n\n    return {\n      provide: {\n        cadenzaRuntime: holder.providedRuntime,\n      },\n    };\n  };\n}\n\nexport function useCadenzaRuntime<\n  TRuntime extends CadenzaNuxtRuntime<any, any> = CadenzaNuxtRuntime<any, any>,\n>(): TRuntime {\n  return (useNuxtApp() as { $cadenzaRuntime: TRuntime }).$cadenzaRuntime;\n}\n\nexport function useCadenzaProjectionState<\n  TProjectionState extends Record<string, any> = Record<string, any>,\n>(): StateLike<CadenzaNuxtRuntimeState<TProjectionState>> {\n  return useState<CadenzaNuxtRuntimeState<TProjectionState>>(\n    RUNTIME_PROJECTION_STATE_KEY,\n    () => ({\n      ready: false,\n      projectionState: {} as TProjectionState,\n    }),\n  );\n}\n\nexport function useCadenzaRuntimeReady(): ComputedLike<boolean> {\n  const readyState = {} as RefLike<boolean>;\n  Object.defineProperty(readyState, \"__v_isRef\", {\n    value: true,\n    enumerable: false,\n  });\n  Object.defineProperty(readyState, \"value\", {\n    get() {\n      return useCadenzaProjectionState().value.ready;\n    },\n    enumerable: true,\n  });\n  return readyState;\n}\n\nexport type { BrowserRuntimeProjectionBinding };\n","import type { BrowserRuntimeActorRuntimeState } from \"./createBrowserRuntimeActor\";\n\nexport interface ProjectionRuntimeSnapshot<\n  TProjectionState extends Record<string, any> = Record<string, any>,\n> {\n  ready: boolean;\n  projectionState: TProjectionState;\n}\n\nexport function cloneProjectionState<TProjectionState>(\n  value: TProjectionState,\n): TProjectionState {\n  if (Array.isArray(value)) {\n    return value.map((item) => cloneProjectionState(item)) as TProjectionState;\n  }\n\n  if (value && typeof value === \"object\") {\n    return Object.fromEntries(\n      Object.entries(value as Record<string, unknown>).map(([key, nested]) => [\n        key,\n        cloneProjectionState(nested),\n      ]),\n    ) as TProjectionState;\n  }\n\n  return value;\n}\n\nexport function resolveInitialProjectionState<\n  TProjectionState extends Record<string, any>,\n>(value: TProjectionState | (() => TProjectionState)): TProjectionState {\n  const resolved =\n    typeof value === \"function\"\n      ? (value as () => TProjectionState)()\n      : value;\n  return cloneProjectionState(resolved);\n}\n\nexport function createProjectionRuntimeSnapshot<\n  TProjectionState extends Record<string, any>,\n>(\n  runtimeState: BrowserRuntimeActorRuntimeState<TProjectionState> | undefined,\n  initialProjectionState: TProjectionState | (() => TProjectionState),\n): ProjectionRuntimeSnapshot<TProjectionState> {\n  return {\n    ready: runtimeState?.ready ?? false,\n    projectionState:\n      runtimeState?.projectionState ??\n      resolveInitialProjectionState(initialProjectionState),\n  };\n}\n"],"mappings":"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","names":[]}

package/dist/browser/nuxt/index.mjs

@@ -0,0 +1,121 @@
+import {
+  createProjectionRuntimeSnapshot
+} from "../chunk-4XOTT2KM.mjs";
+
+// src/nuxt/index.ts
+var DEFAULT_HYDRATION_STATE_KEY = "cadenza-hydration";
+var RUNTIME_PROJECTION_STATE_KEY = "__cadenza_runtime_projection_state__";
+var RUNTIME_HOLDER_KEY = "__CADENZA_NUXT_RUNTIME_HOLDER__";
+function getRuntimeHolder() {
+  const globalRecord = globalThis;
+  if (!globalRecord[RUNTIME_HOLDER_KEY]) {
+    globalRecord[RUNTIME_HOLDER_KEY] = {};
+  }
+  return globalRecord[RUNTIME_HOLDER_KEY];
+}
+function resolveBootstrapUrl(bootstrapUrl, runtimeConfig) {
+  return typeof bootstrapUrl === "function" ? bootstrapUrl(runtimeConfig) : bootstrapUrl;
+}
+function defineCadenzaNuxtRuntimePlugin(options) {
+  return () => {
+    const {
+      cadenza,
+      service,
+      bootstrapUrl,
+      hydrationStateKey,
+      initialProjectionState,
+      commands,
+      ...actorOptions
+    } = options;
+    const runtimeConfig = useRuntimeConfig();
+    const hydration = useState(
+      hydrationStateKey ?? DEFAULT_HYDRATION_STATE_KEY,
+      () => ({
+        initialInquiryResults: {}
+      })
+    );
+    const browserRuntimeOptions = {
+      ...actorOptions,
+      initialProjectionState,
+      service: {
+        ...service,
+        bootstrap: {
+          url: resolveBootstrapUrl(bootstrapUrl, runtimeConfig)
+        },
+        hydration: hydration.value
+      }
+    };
+    const projectionState = useState(
+      RUNTIME_PROJECTION_STATE_KEY,
+      () => createProjectionRuntimeSnapshot(void 0, initialProjectionState)
+    );
+    const holder = getRuntimeHolder();
+    if (!holder.runtime) {
+      holder.runtime = cadenza.createBrowserRuntimeActor(browserRuntimeOptions);
+    }
+    holder.unsubscribe?.();
+    holder.unsubscribe = holder.runtime.subscribe((runtimeState) => {
+      projectionState.value = createProjectionRuntimeSnapshot(
+        runtimeState,
+        initialProjectionState
+      );
+    });
+    projectionState.value = createProjectionRuntimeSnapshot(
+      holder.runtime.getRuntimeState(),
+      initialProjectionState
+    );
+    if (!holder.providedRuntime) {
+      const runtimeCommands = commands ? commands({
+        cadenza,
+        runtime: holder.runtime
+      }) : {};
+      holder.providedRuntime = {
+        actor: holder.runtime.actor,
+        actorHandle: holder.runtime,
+        waitUntilReady: holder.runtime.waitUntilReady,
+        inquire: holder.runtime.inquire,
+        getRuntimeState: holder.runtime.getRuntimeState,
+        subscribe: holder.runtime.subscribe,
+        commands: runtimeCommands
+      };
+    }
+    return {
+      provide: {
+        cadenzaRuntime: holder.providedRuntime
+      }
+    };
+  };
+}
+function useCadenzaRuntime() {
+  return useNuxtApp().$cadenzaRuntime;
+}
+function useCadenzaProjectionState() {
+  return useState(
+    RUNTIME_PROJECTION_STATE_KEY,
+    () => ({
+      ready: false,
+      projectionState: {}
+    })
+  );
+}
+function useCadenzaRuntimeReady() {
+  const readyState = {};
+  Object.defineProperty(readyState, "__v_isRef", {
+    value: true,
+    enumerable: false
+  });
+  Object.defineProperty(readyState, "value", {
+    get() {
+      return useCadenzaProjectionState().value.ready;
+    },
+    enumerable: true
+  });
+  return readyState;
+}
+export {
+  defineCadenzaNuxtRuntimePlugin,
+  useCadenzaProjectionState,
+  useCadenzaRuntime,
+  useCadenzaRuntimeReady
+};
+//# sourceMappingURL=index.mjs.map

package/dist/browser/nuxt/index.mjs.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../../src/nuxt/index.ts"],"sourcesContent":["import type CadenzaService from \"../Cadenza\";\nimport type {\n  BrowserRuntimeActorHandle,\n  BrowserRuntimeActorOptions,\n  BrowserRuntimeServiceOptions,\n  BrowserRuntimeProjectionBinding,\n} from \"../frontend/createBrowserRuntimeActor\";\nimport {\n  createProjectionRuntimeSnapshot,\n  type ProjectionRuntimeSnapshot,\n} from \"../frontend/runtimeProjectionState\";\nimport type { HydrationOptions } from \"../utils/bootstrap\";\n\ntype StateLike<T> = {\n  value: T;\n};\n\ntype ComputedLike<T> = {\n  readonly value: T;\n};\n\ntype RefLike<T> = {\n  readonly value: T;\n  readonly __v_isRef: true;\n};\n\ntype NuxtPluginSetup = () => { provide?: Record<string, unknown> } | void;\n\ndeclare function useState<T>(key: string, init: () => T): StateLike<T>;\ndeclare function useRuntimeConfig(): Record<string, any>;\ndeclare function useNuxtApp(): Record<string, any>;\n\nexport interface CadenzaNuxtRuntimeState<\n  TProjectionState extends Record<string, any> = Record<string, any>,\n> extends ProjectionRuntimeSnapshot<TProjectionState> {}\n\nexport interface CadenzaNuxtRuntime<\n  TProjectionState extends Record<string, any> = Record<string, any>,\n  TCommands extends Record<string, any> = Record<string, never>,\n> {\n  actor: BrowserRuntimeActorHandle<TProjectionState>[\"actor\"];\n  actorHandle: BrowserRuntimeActorHandle<TProjectionState>;\n  waitUntilReady: BrowserRuntimeActorHandle<TProjectionState>[\"waitUntilReady\"];\n  inquire: BrowserRuntimeActorHandle<TProjectionState>[\"inquire\"];\n  getRuntimeState: BrowserRuntimeActorHandle<TProjectionState>[\"getRuntimeState\"];\n  subscribe: BrowserRuntimeActorHandle<TProjectionState>[\"subscribe\"];\n  commands: TCommands;\n}\n\nexport interface CadenzaNuxtRuntimeOptions<\n  TProjectionState extends Record<string, any> = Record<string, any>,\n  TCommands extends Record<string, any> = Record<string, never>,\n> extends Omit<\n    BrowserRuntimeActorOptions<TProjectionState>,\n    \"service\" | \"initialProjectionState\"\n  > {\n  cadenza: typeof CadenzaService;\n  service: Omit<BrowserRuntimeServiceOptions, \"bootstrap\" | \"hydration\">;\n  bootstrapUrl: string | ((config: Record<string, any>) => string);\n  hydrationStateKey?: string;\n  initialProjectionState: TProjectionState | (() => TProjectionState);\n  commands?: (context: {\n    cadenza: typeof CadenzaService;\n    runtime: BrowserRuntimeActorHandle<TProjectionState>;\n  }) => TCommands;\n}\n\ntype NuxtRuntimeHolder<\n  TProjectionState extends Record<string, any> = Record<string, any>,\n  TCommands extends Record<string, any> = Record<string, never>,\n> = {\n  runtime?: BrowserRuntimeActorHandle<TProjectionState>;\n  unsubscribe?: () => void;\n  providedRuntime?: CadenzaNuxtRuntime<TProjectionState, TCommands>;\n};\n\nconst DEFAULT_HYDRATION_STATE_KEY = \"cadenza-hydration\";\nconst RUNTIME_PROJECTION_STATE_KEY = \"__cadenza_runtime_projection_state__\";\nconst RUNTIME_HOLDER_KEY = \"__CADENZA_NUXT_RUNTIME_HOLDER__\";\n\nfunction getRuntimeHolder<\n  TProjectionState extends Record<string, any>,\n  TCommands extends Record<string, any>,\n>(): NuxtRuntimeHolder<TProjectionState, TCommands> {\n  const globalRecord = globalThis as Record<string, unknown>;\n  if (!globalRecord[RUNTIME_HOLDER_KEY]) {\n    globalRecord[RUNTIME_HOLDER_KEY] = {};\n  }\n\n  return globalRecord[RUNTIME_HOLDER_KEY] as NuxtRuntimeHolder<\n    TProjectionState,\n    TCommands\n  >;\n}\n\nfunction resolveBootstrapUrl(\n  bootstrapUrl: string | ((config: Record<string, any>) => string),\n  runtimeConfig: Record<string, any>,\n): string {\n  return typeof bootstrapUrl === \"function\"\n    ? bootstrapUrl(runtimeConfig)\n    : bootstrapUrl;\n}\n\nexport function defineCadenzaNuxtRuntimePlugin<\n  TProjectionState extends Record<string, any>,\n  TCommands extends Record<string, any> = Record<string, never>,\n>(options: CadenzaNuxtRuntimeOptions<TProjectionState, TCommands>): NuxtPluginSetup {\n  return () => {\n    const {\n      cadenza,\n      service,\n      bootstrapUrl,\n      hydrationStateKey,\n      initialProjectionState,\n      commands,\n      ...actorOptions\n    } = options;\n    const runtimeConfig = useRuntimeConfig();\n    const hydration = useState<HydrationOptions>(\n      hydrationStateKey ?? DEFAULT_HYDRATION_STATE_KEY,\n      () => ({\n        initialInquiryResults: {},\n      }),\n    );\n    const browserRuntimeOptions: BrowserRuntimeActorOptions<TProjectionState> = {\n      ...actorOptions,\n      initialProjectionState,\n      service: {\n        ...service,\n        bootstrap: {\n          url: resolveBootstrapUrl(bootstrapUrl, runtimeConfig),\n        },\n        hydration: hydration.value,\n      },\n    };\n    const projectionState = useState<CadenzaNuxtRuntimeState<TProjectionState>>(\n      RUNTIME_PROJECTION_STATE_KEY,\n      () => createProjectionRuntimeSnapshot(undefined, initialProjectionState),\n    );\n    const holder = getRuntimeHolder<TProjectionState, TCommands>();\n\n    if (!holder.runtime) {\n      holder.runtime = cadenza.createBrowserRuntimeActor(browserRuntimeOptions);\n    }\n\n    holder.unsubscribe?.();\n    holder.unsubscribe = holder.runtime.subscribe((runtimeState) => {\n      projectionState.value = createProjectionRuntimeSnapshot(\n        runtimeState,\n        initialProjectionState,\n      );\n    });\n    projectionState.value = createProjectionRuntimeSnapshot(\n      holder.runtime.getRuntimeState(),\n      initialProjectionState,\n    );\n\n    if (!holder.providedRuntime) {\n      const runtimeCommands = commands\n        ? commands({\n            cadenza,\n            runtime: holder.runtime,\n          })\n        : ({} as TCommands);\n\n      holder.providedRuntime = {\n        actor: holder.runtime.actor,\n        actorHandle: holder.runtime,\n        waitUntilReady: holder.runtime.waitUntilReady,\n        inquire: holder.runtime.inquire,\n        getRuntimeState: holder.runtime.getRuntimeState,\n        subscribe: holder.runtime.subscribe,\n        commands: runtimeCommands,\n      };\n    }\n\n    return {\n      provide: {\n        cadenzaRuntime: holder.providedRuntime,\n      },\n    };\n  };\n}\n\nexport function useCadenzaRuntime<\n  TRuntime extends CadenzaNuxtRuntime<any, any> = CadenzaNuxtRuntime<any, any>,\n>(): TRuntime {\n  return (useNuxtApp() as { $cadenzaRuntime: TRuntime }).$cadenzaRuntime;\n}\n\nexport function useCadenzaProjectionState<\n  TProjectionState extends Record<string, any> = Record<string, any>,\n>(): StateLike<CadenzaNuxtRuntimeState<TProjectionState>> {\n  return useState<CadenzaNuxtRuntimeState<TProjectionState>>(\n    RUNTIME_PROJECTION_STATE_KEY,\n    () => ({\n      ready: false,\n      projectionState: {} as TProjectionState,\n    }),\n  );\n}\n\nexport function useCadenzaRuntimeReady(): ComputedLike<boolean> {\n  const readyState = {} as RefLike<boolean>;\n  Object.defineProperty(readyState, \"__v_isRef\", {\n    value: true,\n    enumerable: false,\n  });\n  Object.defineProperty(readyState, \"value\", {\n    get() {\n      return useCadenzaProjectionState().value.ready;\n    },\n    enumerable: true,\n  });\n  return readyState;\n}\n\nexport type { BrowserRuntimeProjectionBinding };\n"],"mappings":";;;;;AA4EA,IAAM,8BAA8B;AACpC,IAAM,+BAA+B;AACrC,IAAM,qBAAqB;AAE3B,SAAS,mBAG2C;AAClD,QAAM,eAAe;AACrB,MAAI,CAAC,aAAa,kBAAkB,GAAG;AACrC,iBAAa,kBAAkB,IAAI,CAAC;AAAA,EACtC;AAEA,SAAO,aAAa,kBAAkB;AAIxC;AAEA,SAAS,oBACP,cACA,eACQ;AACR,SAAO,OAAO,iBAAiB,aAC3B,aAAa,aAAa,IAC1B;AACN;AAEO,SAAS,+BAGd,SAAkF;AAClF,SAAO,MAAM;AACX,UAAM;AAAA,MACJ;AAAA,MACA;AAAA,MACA;AAAA,MACA;AAAA,MACA;AAAA,MACA;AAAA,MACA,GAAG;AAAA,IACL,IAAI;AACJ,UAAM,gBAAgB,iBAAiB;AACvC,UAAM,YAAY;AAAA,MAChB,qBAAqB;AAAA,MACrB,OAAO;AAAA,QACL,uBAAuB,CAAC;AAAA,MAC1B;AAAA,IACF;AACA,UAAM,wBAAsE;AAAA,MAC1E,GAAG;AAAA,MACH;AAAA,MACA,SAAS;AAAA,QACP,GAAG;AAAA,QACH,WAAW;AAAA,UACT,KAAK,oBAAoB,cAAc,aAAa;AAAA,QACtD;AAAA,QACA,WAAW,UAAU;AAAA,MACvB;AAAA,IACF;AACA,UAAM,kBAAkB;AAAA,MACtB;AAAA,MACA,MAAM,gCAAgC,QAAW,sBAAsB;AAAA,IACzE;AACA,UAAM,SAAS,iBAA8C;AAE7D,QAAI,CAAC,OAAO,SAAS;AACnB,aAAO,UAAU,QAAQ,0BAA0B,qBAAqB;AAAA,IAC1E;AAEA,WAAO,cAAc;AACrB,WAAO,cAAc,OAAO,QAAQ,UAAU,CAAC,iBAAiB;AAC9D,sBAAgB,QAAQ;AAAA,QACtB;AAAA,QACA;AAAA,MACF;AAAA,IACF,CAAC;AACD,oBAAgB,QAAQ;AAAA,MACtB,OAAO,QAAQ,gBAAgB;AAAA,MAC/B;AAAA,IACF;AAEA,QAAI,CAAC,OAAO,iBAAiB;AAC3B,YAAM,kBAAkB,WACpB,SAAS;AAAA,QACP;AAAA,QACA,SAAS,OAAO;AAAA,MAClB,CAAC,IACA,CAAC;AAEN,aAAO,kBAAkB;AAAA,QACvB,OAAO,OAAO,QAAQ;AAAA,QACtB,aAAa,OAAO;AAAA,QACpB,gBAAgB,OAAO,QAAQ;AAAA,QAC/B,SAAS,OAAO,QAAQ;AAAA,QACxB,iBAAiB,OAAO,QAAQ;AAAA,QAChC,WAAW,OAAO,QAAQ;AAAA,QAC1B,UAAU;AAAA,MACZ;AAAA,IACF;AAEA,WAAO;AAAA,MACL,SAAS;AAAA,QACP,gBAAgB,OAAO;AAAA,MACzB;AAAA,IACF;AAAA,EACF;AACF;AAEO,SAAS,oBAEF;AACZ,SAAQ,WAAW,EAAoC;AACzD;AAEO,SAAS,4BAE0C;AACxD,SAAO;AAAA,IACL;AAAA,IACA,OAAO;AAAA,MACL,OAAO;AAAA,MACP,iBAAiB,CAAC;AAAA,IACpB;AAAA,EACF;AACF;AAEO,SAAS,yBAAgD;AAC9D,QAAM,aAAa,CAAC;AACpB,SAAO,eAAe,YAAY,aAAa;AAAA,IAC7C,OAAO;AAAA,IACP,YAAY;AAAA,EACd,CAAC;AACD,SAAO,eAAe,YAAY,SAAS;AAAA,IACzC,MAAM;AACJ,aAAO,0BAA0B,EAAE,MAAM;AAAA,IAC3C;AAAA,IACA,YAAY;AAAA,EACd,CAAC;AACD,SAAO;AACT;","names":[]}

package/dist/browser/react/index.js

@@ -0,0 +1,179 @@
+"use strict";
+var __defProp = Object.defineProperty;
+var __getOwnPropDesc = Object.getOwnPropertyDescriptor;
+var __getOwnPropNames = Object.getOwnPropertyNames;
+var __hasOwnProp = Object.prototype.hasOwnProperty;
+var __export = (target, all) => {
+  for (var name in all)
+    __defProp(target, name, { get: all[name], enumerable: true });
+};
+var __copyProps = (to, from, except, desc) => {
+  if (from && typeof from === "object" || typeof from === "function") {
+    for (let key of __getOwnPropNames(from))
+      if (!__hasOwnProp.call(to, key) && key !== except)
+        __defProp(to, key, { get: () => from[key], enumerable: !(desc = __getOwnPropDesc(from, key)) || desc.enumerable });
+  }
+  return to;
+};
+var __toCommonJS = (mod) => __copyProps(__defProp({}, "__esModule", { value: true }), mod);
+
+// src/react/index.ts
+var react_exports = {};
+__export(react_exports, {
+  CadenzaRuntimeProvider: () => CadenzaRuntimeProvider,
+  createCadenzaReactRuntime: () => createCadenzaReactRuntime,
+  useCadenzaProjectionSelector: () => useCadenzaProjectionSelector,
+  useCadenzaProjectionState: () => useCadenzaProjectionState,
+  useCadenzaRuntime: () => useCadenzaRuntime,
+  useCadenzaRuntimeReady: () => useCadenzaRuntimeReady
+});
+module.exports = __toCommonJS(react_exports);
+var import_react = require("react");
+
+// src/frontend/runtimeProjectionState.ts
+function cloneProjectionState(value) {
+  if (Array.isArray(value)) {
+    return value.map((item) => cloneProjectionState(item));
+  }
+  if (value && typeof value === "object") {
+    return Object.fromEntries(
+      Object.entries(value).map(([key, nested]) => [
+        key,
+        cloneProjectionState(nested)
+      ])
+    );
+  }
+  return value;
+}
+function resolveInitialProjectionState(value) {
+  const resolved = typeof value === "function" ? value() : value;
+  return cloneProjectionState(resolved);
+}
+function createProjectionRuntimeSnapshot(runtimeState, initialProjectionState) {
+  return {
+    ready: runtimeState?.ready ?? false,
+    projectionState: runtimeState?.projectionState ?? resolveInitialProjectionState(initialProjectionState)
+  };
+}
+
+// src/react/index.ts
+var DEFAULT_SELECTOR_EQUALITY = Object.is;
+var CadenzaRuntimeContext = (0, import_react.createContext)(
+  null
+);
+function resolveBootstrapUrl(bootstrapUrl) {
+  return typeof bootstrapUrl === "function" ? bootstrapUrl() : bootstrapUrl;
+}
+function resolveHydrationOptions(hydration) {
+  if (!hydration) {
+    return void 0;
+  }
+  return typeof hydration === "function" ? hydration() : hydration;
+}
+function getRequiredRuntime() {
+  const runtime = (0, import_react.useContext)(CadenzaRuntimeContext);
+  if (!runtime) {
+    throw new Error(
+      "CadenzaRuntimeProvider is required before using React Cadenza runtime hooks."
+    );
+  }
+  return runtime;
+}
+function createCadenzaReactRuntime(options) {
+  const {
+    cadenza,
+    service,
+    bootstrapUrl,
+    hydration,
+    initialProjectionState,
+    commands,
+    ...actorOptions
+  } = options;
+  const browserRuntimeOptions = {
+    ...actorOptions,
+    initialProjectionState,
+    service: {
+      ...service,
+      bootstrap: {
+        url: resolveBootstrapUrl(bootstrapUrl)
+      },
+      hydration: resolveHydrationOptions(hydration)
+    }
+  };
+  const runtime = cadenza.createBrowserRuntimeActor(browserRuntimeOptions);
+  let snapshot = createProjectionRuntimeSnapshot(
+    runtime.getRuntimeState(),
+    initialProjectionState
+  );
+  const runtimeCommands = commands ? commands({
+    cadenza,
+    runtime
+  }) : {};
+  return {
+    actor: runtime.actor,
+    actorHandle: runtime,
+    waitUntilReady: runtime.waitUntilReady,
+    inquire: runtime.inquire,
+    getRuntimeState: runtime.getRuntimeState,
+    subscribe: (listener) => runtime.subscribe((runtimeState) => {
+      snapshot = createProjectionRuntimeSnapshot(
+        runtimeState,
+        initialProjectionState
+      );
+      listener(runtimeState);
+    }),
+    getSnapshot: () => snapshot,
+    commands: runtimeCommands
+  };
+}
+function CadenzaRuntimeProvider({ runtime, children }) {
+  return (0, import_react.createElement)(CadenzaRuntimeContext.Provider, {
+    value: runtime,
+    children
+  });
+}
+function useCadenzaRuntime() {
+  return getRequiredRuntime();
+}
+function useCadenzaProjectionState() {
+  const runtime = getRequiredRuntime();
+  return (0, import_react.useSyncExternalStore)(
+    runtime.subscribe,
+    runtime.getSnapshot,
+    runtime.getSnapshot
+  );
+}
+function useCadenzaSnapshotSelector(selector, isEqual = DEFAULT_SELECTOR_EQUALITY) {
+  const runtime = getRequiredRuntime();
+  const selectionCacheRef = (0, import_react.useRef)({
+    hasValue: false,
+    value: void 0
+  });
+  const getSelectedSnapshot = () => {
+    const nextValue = selector(runtime.getSnapshot());
+    const cached = selectionCacheRef.current;
+    if (cached.hasValue && isEqual(cached.value, nextValue)) {
+      return cached.value;
+    }
+    selectionCacheRef.current = {
+      hasValue: true,
+      value: nextValue
+    };
+    return nextValue;
+  };
+  return (0, import_react.useSyncExternalStore)(
+    runtime.subscribe,
+    getSelectedSnapshot,
+    getSelectedSnapshot
+  );
+}
+function useCadenzaProjectionSelector(selector, isEqual = DEFAULT_SELECTOR_EQUALITY) {
+  return useCadenzaSnapshotSelector(
+    (snapshot) => selector(snapshot.projectionState),
+    isEqual
+  );
+}
+function useCadenzaRuntimeReady() {
+  return useCadenzaSnapshotSelector((snapshot) => snapshot.ready);
+}
+//# sourceMappingURL=index.js.map

package/dist/browser/react/index.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../../src/react/index.ts","../../../src/frontend/runtimeProjectionState.ts"],"sourcesContent":["import {\n  createContext,\n  createElement,\n  useContext,\n  useRef,\n  useSyncExternalStore,\n} from \"react\";\nimport type { ReactNode } from \"react\";\n\nimport type CadenzaService from \"../Cadenza\";\nimport type {\n  BrowserRuntimeActorHandle,\n  BrowserRuntimeActorOptions,\n  BrowserRuntimeProjectionBinding,\n  BrowserRuntimeServiceOptions,\n} from \"../frontend/createBrowserRuntimeActor\";\nimport {\n  createProjectionRuntimeSnapshot,\n  type ProjectionRuntimeSnapshot,\n} from \"../frontend/runtimeProjectionState\";\nimport type { HydrationOptions } from \"../utils/bootstrap\";\n\nexport interface CadenzaReactRuntimeState<\n  TProjectionState extends Record<string, any> = Record<string, any>,\n> extends ProjectionRuntimeSnapshot<TProjectionState> {}\n\nexport interface CadenzaReactRuntime<\n  TProjectionState extends Record<string, any> = Record<string, any>,\n  TCommands extends Record<string, any> = Record<string, never>,\n> {\n  actor: BrowserRuntimeActorHandle<TProjectionState>[\"actor\"];\n  actorHandle: BrowserRuntimeActorHandle<TProjectionState>;\n  waitUntilReady: BrowserRuntimeActorHandle<TProjectionState>[\"waitUntilReady\"];\n  inquire: BrowserRuntimeActorHandle<TProjectionState>[\"inquire\"];\n  getRuntimeState: BrowserRuntimeActorHandle<TProjectionState>[\"getRuntimeState\"];\n  subscribe: BrowserRuntimeActorHandle<TProjectionState>[\"subscribe\"];\n  getSnapshot: () => CadenzaReactRuntimeState<TProjectionState>;\n  commands: TCommands;\n}\n\nexport interface CadenzaReactRuntimeOptions<\n  TProjectionState extends Record<string, any> = Record<string, any>,\n  TCommands extends Record<string, any> = Record<string, never>,\n> extends Omit<\n    BrowserRuntimeActorOptions<TProjectionState>,\n    \"service\" | \"initialProjectionState\"\n  > {\n  cadenza: typeof CadenzaService;\n  service: Omit<BrowserRuntimeServiceOptions, \"bootstrap\" | \"hydration\">;\n  bootstrapUrl: string | (() => string);\n  hydration?: HydrationOptions | (() => HydrationOptions);\n  initialProjectionState: TProjectionState | (() => TProjectionState);\n  commands?: (context: {\n    cadenza: typeof CadenzaService;\n    runtime: BrowserRuntimeActorHandle<TProjectionState>;\n  }) => TCommands;\n}\n\nexport interface CadenzaRuntimeProviderProps<\n  TProjectionState extends Record<string, any> = Record<string, any>,\n  TCommands extends Record<string, any> = Record<string, never>,\n> {\n  runtime: CadenzaReactRuntime<TProjectionState, TCommands>;\n  children?: ReactNode;\n}\n\ntype EqualityComparator<TSelected> = (\n  previous: TSelected,\n  next: TSelected,\n) => boolean;\n\nconst DEFAULT_SELECTOR_EQUALITY = Object.is;\nconst CadenzaRuntimeContext = createContext<CadenzaReactRuntime<any, any> | null>(\n  null,\n);\n\nfunction resolveBootstrapUrl(bootstrapUrl: string | (() => string)): string {\n  return typeof bootstrapUrl === \"function\" ? bootstrapUrl() : bootstrapUrl;\n}\n\nfunction resolveHydrationOptions(\n  hydration: HydrationOptions | (() => HydrationOptions) | undefined,\n): HydrationOptions | undefined {\n  if (!hydration) {\n    return undefined;\n  }\n\n  return typeof hydration === \"function\"\n    ? (hydration as () => HydrationOptions)()\n    : hydration;\n}\n\nfunction getRequiredRuntime<\n  TProjectionState extends Record<string, any>,\n  TCommands extends Record<string, any>,\n>(): CadenzaReactRuntime<TProjectionState, TCommands> {\n  const runtime = useContext(CadenzaRuntimeContext);\n  if (!runtime) {\n    throw new Error(\n      \"CadenzaRuntimeProvider is required before using React Cadenza runtime hooks.\",\n    );\n  }\n\n  return runtime as CadenzaReactRuntime<TProjectionState, TCommands>;\n}\n\nexport function createCadenzaReactRuntime<\n  TProjectionState extends Record<string, any>,\n  TCommands extends Record<string, any> = Record<string, never>,\n>(options: CadenzaReactRuntimeOptions<TProjectionState, TCommands>) {\n  const {\n    cadenza,\n    service,\n    bootstrapUrl,\n    hydration,\n    initialProjectionState,\n    commands,\n    ...actorOptions\n  } = options;\n  const browserRuntimeOptions: BrowserRuntimeActorOptions<TProjectionState> = {\n    ...actorOptions,\n    initialProjectionState,\n    service: {\n      ...service,\n      bootstrap: {\n        url: resolveBootstrapUrl(bootstrapUrl),\n      },\n      hydration: resolveHydrationOptions(hydration),\n    },\n  };\n  const runtime = cadenza.createBrowserRuntimeActor(browserRuntimeOptions);\n  let snapshot = createProjectionRuntimeSnapshot(\n    runtime.getRuntimeState(),\n    initialProjectionState,\n  );\n  const runtimeCommands = commands\n    ? commands({\n        cadenza,\n        runtime,\n      })\n    : ({} as TCommands);\n\n  return {\n    actor: runtime.actor,\n    actorHandle: runtime,\n    waitUntilReady: runtime.waitUntilReady,\n    inquire: runtime.inquire,\n    getRuntimeState: runtime.getRuntimeState,\n    subscribe: (listener) =>\n      runtime.subscribe((runtimeState) => {\n        snapshot = createProjectionRuntimeSnapshot(\n          runtimeState,\n          initialProjectionState,\n        );\n        listener(runtimeState);\n      }),\n    getSnapshot: () => snapshot,\n    commands: runtimeCommands,\n  } satisfies CadenzaReactRuntime<TProjectionState, TCommands>;\n}\n\nexport function CadenzaRuntimeProvider<\n  TProjectionState extends Record<string, any>,\n  TCommands extends Record<string, any> = Record<string, never>,\n>({ runtime, children }: CadenzaRuntimeProviderProps<TProjectionState, TCommands>) {\n  return createElement(CadenzaRuntimeContext.Provider, {\n    value: runtime,\n    children,\n  });\n}\n\nexport function useCadenzaRuntime<\n  TRuntime extends CadenzaReactRuntime<any, any> = CadenzaReactRuntime<any, any>,\n>(): TRuntime {\n  return getRequiredRuntime<any, any>() as TRuntime;\n}\n\nexport function useCadenzaProjectionState<\n  TProjectionState extends Record<string, any> = Record<string, any>,\n>(): CadenzaReactRuntimeState<TProjectionState> {\n  const runtime = getRequiredRuntime<TProjectionState, Record<string, any>>();\n  return useSyncExternalStore(\n    runtime.subscribe,\n    runtime.getSnapshot,\n    runtime.getSnapshot,\n  );\n}\n\nfunction useCadenzaSnapshotSelector<\n  TProjectionState extends Record<string, any>,\n  TSelected,\n>(\n  selector: (snapshot: CadenzaReactRuntimeState<TProjectionState>) => TSelected,\n  isEqual: EqualityComparator<TSelected> = DEFAULT_SELECTOR_EQUALITY,\n): TSelected {\n  const runtime = getRequiredRuntime<TProjectionState, Record<string, any>>();\n  const selectionCacheRef = useRef<{\n    hasValue: boolean;\n    value: TSelected;\n  }>({\n    hasValue: false,\n    value: undefined as TSelected,\n  });\n\n  const getSelectedSnapshot = () => {\n    const nextValue = selector(runtime.getSnapshot());\n    const cached = selectionCacheRef.current;\n    if (cached.hasValue && isEqual(cached.value, nextValue)) {\n      return cached.value;\n    }\n\n    selectionCacheRef.current = {\n      hasValue: true,\n      value: nextValue,\n    };\n    return nextValue;\n  };\n\n  return useSyncExternalStore(\n    runtime.subscribe,\n    getSelectedSnapshot,\n    getSelectedSnapshot,\n  );\n}\n\nexport function useCadenzaProjectionSelector<\n  TProjectionState extends Record<string, any> = Record<string, any>,\n  TSelected = TProjectionState,\n>(\n  selector: (state: TProjectionState) => TSelected,\n  isEqual: EqualityComparator<TSelected> = DEFAULT_SELECTOR_EQUALITY,\n): TSelected {\n  return useCadenzaSnapshotSelector<TProjectionState, TSelected>(\n    (snapshot) => selector(snapshot.projectionState as TProjectionState),\n    isEqual,\n  );\n}\n\nexport function useCadenzaRuntimeReady(): boolean {\n  return useCadenzaSnapshotSelector((snapshot) => snapshot.ready);\n}\n\nexport type { BrowserRuntimeProjectionBinding };\n","import type { BrowserRuntimeActorRuntimeState } from \"./createBrowserRuntimeActor\";\n\nexport interface ProjectionRuntimeSnapshot<\n  TProjectionState extends Record<string, any> = Record<string, any>,\n> {\n  ready: boolean;\n  projectionState: TProjectionState;\n}\n\nexport function cloneProjectionState<TProjectionState>(\n  value: TProjectionState,\n): TProjectionState {\n  if (Array.isArray(value)) {\n    return value.map((item) => cloneProjectionState(item)) as TProjectionState;\n  }\n\n  if (value && typeof value === \"object\") {\n    return Object.fromEntries(\n      Object.entries(value as Record<string, unknown>).map(([key, nested]) => [\n        key,\n        cloneProjectionState(nested),\n      ]),\n    ) as TProjectionState;\n  }\n\n  return value;\n}\n\nexport function resolveInitialProjectionState<\n  TProjectionState extends Record<string, any>,\n>(value: TProjectionState | (() => TProjectionState)): TProjectionState {\n  const resolved =\n    typeof value === \"function\"\n      ? (value as () => TProjectionState)()\n      : value;\n  return cloneProjectionState(resolved);\n}\n\nexport function createProjectionRuntimeSnapshot<\n  TProjectionState extends Record<string, any>,\n>(\n  runtimeState: BrowserRuntimeActorRuntimeState<TProjectionState> | undefined,\n  initialProjectionState: TProjectionState | (() => TProjectionState),\n): ProjectionRuntimeSnapshot<TProjectionState> {\n  return {\n    ready: runtimeState?.ready ?? false,\n    projectionState:\n      runtimeState?.projectionState ??\n      resolveInitialProjectionState(initialProjectionState),\n  };\n}\n"],"mappings":"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","names":[]}

package/dist/browser/react/index.mjs

@@ -0,0 +1,140 @@
+import {
+  createProjectionRuntimeSnapshot
+} from "../chunk-4XOTT2KM.mjs";
+
+// src/react/index.ts
+import {
+  createContext,
+  createElement,
+  useContext,
+  useRef,
+  useSyncExternalStore
+} from "react";
+var DEFAULT_SELECTOR_EQUALITY = Object.is;
+var CadenzaRuntimeContext = createContext(
+  null
+);
+function resolveBootstrapUrl(bootstrapUrl) {
+  return typeof bootstrapUrl === "function" ? bootstrapUrl() : bootstrapUrl;
+}
+function resolveHydrationOptions(hydration) {
+  if (!hydration) {
+    return void 0;
+  }
+  return typeof hydration === "function" ? hydration() : hydration;
+}
+function getRequiredRuntime() {
+  const runtime = useContext(CadenzaRuntimeContext);
+  if (!runtime) {
+    throw new Error(
+      "CadenzaRuntimeProvider is required before using React Cadenza runtime hooks."
+    );
+  }
+  return runtime;
+}
+function createCadenzaReactRuntime(options) {
+  const {
+    cadenza,
+    service,
+    bootstrapUrl,
+    hydration,
+    initialProjectionState,
+    commands,
+    ...actorOptions
+  } = options;
+  const browserRuntimeOptions = {
+    ...actorOptions,
+    initialProjectionState,
+    service: {
+      ...service,
+      bootstrap: {
+        url: resolveBootstrapUrl(bootstrapUrl)
+      },
+      hydration: resolveHydrationOptions(hydration)
+    }
+  };
+  const runtime = cadenza.createBrowserRuntimeActor(browserRuntimeOptions);
+  let snapshot = createProjectionRuntimeSnapshot(
+    runtime.getRuntimeState(),
+    initialProjectionState
+  );
+  const runtimeCommands = commands ? commands({
+    cadenza,
+    runtime
+  }) : {};
+  return {
+    actor: runtime.actor,
+    actorHandle: runtime,
+    waitUntilReady: runtime.waitUntilReady,
+    inquire: runtime.inquire,
+    getRuntimeState: runtime.getRuntimeState,
+    subscribe: (listener) => runtime.subscribe((runtimeState) => {
+      snapshot = createProjectionRuntimeSnapshot(
+        runtimeState,
+        initialProjectionState
+      );
+      listener(runtimeState);
+    }),
+    getSnapshot: () => snapshot,
+    commands: runtimeCommands
+  };
+}
+function CadenzaRuntimeProvider({ runtime, children }) {
+  return createElement(CadenzaRuntimeContext.Provider, {
+    value: runtime,
+    children
+  });
+}
+function useCadenzaRuntime() {
+  return getRequiredRuntime();
+}
+function useCadenzaProjectionState() {
+  const runtime = getRequiredRuntime();
+  return useSyncExternalStore(
+    runtime.subscribe,
+    runtime.getSnapshot,
+    runtime.getSnapshot
+  );
+}
+function useCadenzaSnapshotSelector(selector, isEqual = DEFAULT_SELECTOR_EQUALITY) {
+  const runtime = getRequiredRuntime();
+  const selectionCacheRef = useRef({
+    hasValue: false,
+    value: void 0
+  });
+  const getSelectedSnapshot = () => {
+    const nextValue = selector(runtime.getSnapshot());
+    const cached = selectionCacheRef.current;
+    if (cached.hasValue && isEqual(cached.value, nextValue)) {
+      return cached.value;
+    }
+    selectionCacheRef.current = {
+      hasValue: true,
+      value: nextValue
+    };
+    return nextValue;
+  };
+  return useSyncExternalStore(
+    runtime.subscribe,
+    getSelectedSnapshot,
+    getSelectedSnapshot
+  );
+}
+function useCadenzaProjectionSelector(selector, isEqual = DEFAULT_SELECTOR_EQUALITY) {
+  return useCadenzaSnapshotSelector(
+    (snapshot) => selector(snapshot.projectionState),
+    isEqual
+  );
+}
+function useCadenzaRuntimeReady() {
+  return useCadenzaSnapshotSelector((snapshot) => snapshot.ready);
+}
+export {
+  CadenzaRuntimeProvider,
+  createCadenzaReactRuntime,
+  useCadenzaProjectionSelector,
+  useCadenzaProjectionState,
+  useCadenzaRuntime,
+  useCadenzaRuntimeReady
+};
+//# sourceMappingURL=index.mjs.map