@cadenza.io/service 2.18.2 → 2.19.0

package/dist/react/index.js

@@ -0,0 +1,188 @@
+"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);
+}
+// Annotate the CommonJS export names for ESM import in node:
+0 && (module.exports = {
+  CadenzaRuntimeProvider,
+  createCadenzaReactRuntime,
+  useCadenzaProjectionSelector,
+  useCadenzaProjectionState,
+  useCadenzaRuntime,
+  useCadenzaRuntimeReady
+});
+//# sourceMappingURL=index.js.map

package/dist/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/react/index.mjs

@@ -0,0 +1,140 @@
+import {
+  createProjectionRuntimeSnapshot
+} from "../chunk-DBCS4XXY.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

package/dist/react/index.mjs.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../src/react/index.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"],"mappings":"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","names":[]}

package/dist/runtimeProjectionState-CitON2P3.d.mts

@@ -0,0 +1,6 @@
+interface ProjectionRuntimeSnapshot<TProjectionState extends Record<string, any> = Record<string, any>> {
+    ready: boolean;
+    projectionState: TProjectionState;
+}
+
+export type { ProjectionRuntimeSnapshot as P };

package/dist/runtimeProjectionState-CitON2P3.d.ts

@@ -0,0 +1,6 @@
+interface ProjectionRuntimeSnapshot<TProjectionState extends Record<string, any> = Record<string, any>> {
+    ready: boolean;
+    projectionState: TProjectionState;
+}
+
+export type { ProjectionRuntimeSnapshot as P };

package/dist/vue/index.d.mts

@@ -0,0 +1,48 @@
+import { ShallowRef, ComputedRef, App } from 'vue';
+import { i as BrowserRuntimeActorHandle, j as BrowserRuntimeActorOptions, C as CadenzaService, m as BrowserRuntimeServiceOptions, H as HydrationOptions } from '../Cadenza-DCMs7q97.mjs';
+export { l as BrowserRuntimeProjectionBinding } from '../Cadenza-DCMs7q97.mjs';
+import { P as ProjectionRuntimeSnapshot } from '../runtimeProjectionState-CitON2P3.mjs';
+import '@cadenza.io/core';
+
+interface CadenzaVueRuntimeState<TProjectionState extends Record<string, any> = Record<string, any>> extends ProjectionRuntimeSnapshot<TProjectionState> {
+}
+interface CadenzaVueRuntime<TProjectionState extends Record<string, any> = Record<string, any>, TCommands extends Record<string, any> = Record<string, never>> {
+    actor: BrowserRuntimeActorHandle<TProjectionState>["actor"];
+    actorHandle: BrowserRuntimeActorHandle<TProjectionState>;
+    waitUntilReady: BrowserRuntimeActorHandle<TProjectionState>["waitUntilReady"];
+    inquire: BrowserRuntimeActorHandle<TProjectionState>["inquire"];
+    getRuntimeState: BrowserRuntimeActorHandle<TProjectionState>["getRuntimeState"];
+    subscribe: BrowserRuntimeActorHandle<TProjectionState>["subscribe"];
+    snapshot: Readonly<ShallowRef<CadenzaVueRuntimeState<TProjectionState>>>;
+    projectionState: ComputedRef<TProjectionState>;
+    ready: ComputedRef<boolean>;
+    commands: TCommands;
+    install: (app: App) => void;
+    dispose: () => void;
+}
+interface CadenzaVueRuntimeOptions<TProjectionState extends Record<string, any> = Record<string, any>, TCommands extends Record<string, any> = Record<string, never>> extends Omit<BrowserRuntimeActorOptions<TProjectionState>, "service" | "initialProjectionState"> {
+    cadenza: typeof CadenzaService;
+    service: Omit<BrowserRuntimeServiceOptions, "bootstrap" | "hydration">;
+    bootstrapUrl: string | (() => string);
+    hydration?: HydrationOptions | (() => HydrationOptions);
+    initialProjectionState: TProjectionState | (() => TProjectionState);
+    commands?: (context: {
+        cadenza: typeof CadenzaService;
+        runtime: BrowserRuntimeActorHandle<TProjectionState>;
+    }) => TCommands;
+}
+type EqualityComparator<TSelected> = (previous: TSelected, next: TSelected) => boolean;
+declare function createCadenzaVueRuntime<TProjectionState extends Record<string, any>, TCommands extends Record<string, any> = Record<string, never>>(options: CadenzaVueRuntimeOptions<TProjectionState, TCommands>): CadenzaVueRuntime<TProjectionState, TCommands>;
+declare function useCadenzaRuntime<TRuntime extends CadenzaVueRuntime<any, any> = CadenzaVueRuntime<any, any>>(): TRuntime;
+declare function useCadenzaRuntimeState<TProjectionState extends Record<string, any> = Record<string, any>>(): Readonly<ShallowRef<CadenzaVueRuntimeState<TProjectionState>>>;
+declare function useCadenzaProjectionState<TProjectionState extends Record<string, any> = Record<string, any>>(): ComputedRef<TProjectionState>;
+declare function useCadenzaProjectionSelector<TProjectionState extends Record<string, any> = Record<string, any>, TSelected = TProjectionState>(selector: (state: TProjectionState) => TSelected, isEqual?: EqualityComparator<TSelected>): Readonly<ShallowRef<TSelected>>;
+declare function useCadenzaRuntimeReady(): ComputedRef<boolean>;
+
+declare module "vue" {
+    interface ComponentCustomProperties {
+        $cadenzaRuntime: CadenzaVueRuntime<any, any>;
+    }
+}
+
+export { type CadenzaVueRuntime, type CadenzaVueRuntimeOptions, type CadenzaVueRuntimeState, createCadenzaVueRuntime, useCadenzaProjectionSelector, useCadenzaProjectionState, useCadenzaRuntime, useCadenzaRuntimeReady, useCadenzaRuntimeState };

package/dist/vue/index.d.ts

@@ -0,0 +1,48 @@
+import { ShallowRef, ComputedRef, App } from 'vue';
+import { i as BrowserRuntimeActorHandle, j as BrowserRuntimeActorOptions, C as CadenzaService, m as BrowserRuntimeServiceOptions, H as HydrationOptions } from '../Cadenza-DCMs7q97.js';
+export { l as BrowserRuntimeProjectionBinding } from '../Cadenza-DCMs7q97.js';
+import { P as ProjectionRuntimeSnapshot } from '../runtimeProjectionState-CitON2P3.js';
+import '@cadenza.io/core';
+
+interface CadenzaVueRuntimeState<TProjectionState extends Record<string, any> = Record<string, any>> extends ProjectionRuntimeSnapshot<TProjectionState> {
+}
+interface CadenzaVueRuntime<TProjectionState extends Record<string, any> = Record<string, any>, TCommands extends Record<string, any> = Record<string, never>> {
+    actor: BrowserRuntimeActorHandle<TProjectionState>["actor"];
+    actorHandle: BrowserRuntimeActorHandle<TProjectionState>;
+    waitUntilReady: BrowserRuntimeActorHandle<TProjectionState>["waitUntilReady"];
+    inquire: BrowserRuntimeActorHandle<TProjectionState>["inquire"];
+    getRuntimeState: BrowserRuntimeActorHandle<TProjectionState>["getRuntimeState"];
+    subscribe: BrowserRuntimeActorHandle<TProjectionState>["subscribe"];
+    snapshot: Readonly<ShallowRef<CadenzaVueRuntimeState<TProjectionState>>>;
+    projectionState: ComputedRef<TProjectionState>;
+    ready: ComputedRef<boolean>;
+    commands: TCommands;
+    install: (app: App) => void;
+    dispose: () => void;
+}
+interface CadenzaVueRuntimeOptions<TProjectionState extends Record<string, any> = Record<string, any>, TCommands extends Record<string, any> = Record<string, never>> extends Omit<BrowserRuntimeActorOptions<TProjectionState>, "service" | "initialProjectionState"> {
+    cadenza: typeof CadenzaService;
+    service: Omit<BrowserRuntimeServiceOptions, "bootstrap" | "hydration">;
+    bootstrapUrl: string | (() => string);
+    hydration?: HydrationOptions | (() => HydrationOptions);
+    initialProjectionState: TProjectionState | (() => TProjectionState);
+    commands?: (context: {
+        cadenza: typeof CadenzaService;
+        runtime: BrowserRuntimeActorHandle<TProjectionState>;
+    }) => TCommands;
+}
+type EqualityComparator<TSelected> = (previous: TSelected, next: TSelected) => boolean;
+declare function createCadenzaVueRuntime<TProjectionState extends Record<string, any>, TCommands extends Record<string, any> = Record<string, never>>(options: CadenzaVueRuntimeOptions<TProjectionState, TCommands>): CadenzaVueRuntime<TProjectionState, TCommands>;
+declare function useCadenzaRuntime<TRuntime extends CadenzaVueRuntime<any, any> = CadenzaVueRuntime<any, any>>(): TRuntime;
+declare function useCadenzaRuntimeState<TProjectionState extends Record<string, any> = Record<string, any>>(): Readonly<ShallowRef<CadenzaVueRuntimeState<TProjectionState>>>;
+declare function useCadenzaProjectionState<TProjectionState extends Record<string, any> = Record<string, any>>(): ComputedRef<TProjectionState>;
+declare function useCadenzaProjectionSelector<TProjectionState extends Record<string, any> = Record<string, any>, TSelected = TProjectionState>(selector: (state: TProjectionState) => TSelected, isEqual?: EqualityComparator<TSelected>): Readonly<ShallowRef<TSelected>>;
+declare function useCadenzaRuntimeReady(): ComputedRef<boolean>;
+
+declare module "vue" {
+    interface ComponentCustomProperties {
+        $cadenzaRuntime: CadenzaVueRuntime<any, any>;
+    }
+}
+
+export { type CadenzaVueRuntime, type CadenzaVueRuntimeOptions, type CadenzaVueRuntimeState, createCadenzaVueRuntime, useCadenzaProjectionSelector, useCadenzaProjectionState, useCadenzaRuntime, useCadenzaRuntimeReady, useCadenzaRuntimeState };