@cadenza.io/service 2.18.3 → 2.19.0

package/dist/vue/index.js

@@ -0,0 +1,187 @@
+"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/vue/index.ts
+var vue_exports = {};
+__export(vue_exports, {
+  createCadenzaVueRuntime: () => createCadenzaVueRuntime,
+  useCadenzaProjectionSelector: () => useCadenzaProjectionSelector,
+  useCadenzaProjectionState: () => useCadenzaProjectionState,
+  useCadenzaRuntime: () => useCadenzaRuntime,
+  useCadenzaRuntimeReady: () => useCadenzaRuntimeReady,
+  useCadenzaRuntimeState: () => useCadenzaRuntimeState
+});
+module.exports = __toCommonJS(vue_exports);
+var import_vue = require("vue");
+
+// 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/vue/index.ts
+var DEFAULT_SELECTOR_EQUALITY = Object.is;
+var CADENZA_VUE_RUNTIME_KEY = /* @__PURE__ */ Symbol("CadenzaVueRuntime");
+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_vue.inject)(CADENZA_VUE_RUNTIME_KEY, null);
+  if (!runtime) {
+    throw new Error(
+      "Cadenza Vue runtime is not installed. Call app.use(runtime) before using Cadenza Vue composables."
+    );
+  }
+  return runtime;
+}
+function createCadenzaVueRuntime(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);
+  const snapshotRef = (0, import_vue.shallowRef)(
+    createProjectionRuntimeSnapshot(
+      runtime.getRuntimeState(),
+      initialProjectionState
+    )
+  );
+  const unsubscribe = runtime.subscribe((runtimeState) => {
+    snapshotRef.value = createProjectionRuntimeSnapshot(
+      runtimeState,
+      initialProjectionState
+    );
+  });
+  let disposed = false;
+  const runtimeCommands = commands ? commands({
+    cadenza,
+    runtime
+  }) : {};
+  const runtimeObject = {
+    actor: runtime.actor,
+    actorHandle: runtime,
+    waitUntilReady: runtime.waitUntilReady,
+    inquire: runtime.inquire,
+    getRuntimeState: runtime.getRuntimeState,
+    subscribe: runtime.subscribe,
+    snapshot: (0, import_vue.readonly)(snapshotRef),
+    projectionState: (0, import_vue.computed)(
+      () => snapshotRef.value.projectionState
+    ),
+    ready: (0, import_vue.computed)(() => snapshotRef.value.ready),
+    commands: runtimeCommands,
+    install(app) {
+      app.provide(CADENZA_VUE_RUNTIME_KEY, runtimeObject);
+      app.config.globalProperties.$cadenzaRuntime = runtimeObject;
+    },
+    dispose() {
+      if (disposed) {
+        return;
+      }
+      disposed = true;
+      unsubscribe();
+    }
+  };
+  return (0, import_vue.markRaw)(runtimeObject);
+}
+function useCadenzaRuntime() {
+  return getRequiredRuntime();
+}
+function useCadenzaRuntimeState() {
+  return getRequiredRuntime().snapshot;
+}
+function useCadenzaProjectionState() {
+  return getRequiredRuntime().projectionState;
+}
+function useCadenzaProjectionSelector(selector, isEqual = DEFAULT_SELECTOR_EQUALITY) {
+  const projectionState = useCadenzaProjectionState();
+  const selectedRef = (0, import_vue.shallowRef)(
+    selector(projectionState.value)
+  );
+  (0, import_vue.watch)(
+    projectionState,
+    (nextProjectionState) => {
+      const nextSelected = selector(nextProjectionState);
+      if (isEqual(selectedRef.value, nextSelected)) {
+        return;
+      }
+      selectedRef.value = nextSelected;
+    },
+    {
+      flush: "sync"
+    }
+  );
+  return (0, import_vue.readonly)(selectedRef);
+}
+function useCadenzaRuntimeReady() {
+  return getRequiredRuntime().ready;
+}
+// Annotate the CommonJS export names for ESM import in node:
+0 && (module.exports = {
+  createCadenzaVueRuntime,
+  useCadenzaProjectionSelector,
+  useCadenzaProjectionState,
+  useCadenzaRuntime,
+  useCadenzaRuntimeReady,
+  useCadenzaRuntimeState
+});
+//# sourceMappingURL=index.js.map

package/dist/vue/index.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../src/vue/index.ts","../../src/frontend/runtimeProjectionState.ts"],"sourcesContent":["import {\n  computed,\n  inject,\n  markRaw,\n  readonly,\n  shallowRef,\n  watch,\n  type App,\n  type ComputedRef,\n  type InjectionKey,\n  type ShallowRef,\n} from \"vue\";\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 CadenzaVueRuntimeState<\n  TProjectionState extends Record<string, any> = Record<string, any>,\n> extends ProjectionRuntimeSnapshot<TProjectionState> {}\n\nexport interface CadenzaVueRuntime<\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  snapshot: Readonly<ShallowRef<CadenzaVueRuntimeState<TProjectionState>>>;\n  projectionState: ComputedRef<TProjectionState>;\n  ready: ComputedRef<boolean>;\n  commands: TCommands;\n  install: (app: App) => void;\n  dispose: () => void;\n}\n\nexport interface CadenzaVueRuntimeOptions<\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\ntype EqualityComparator<TSelected> = (\n  previous: TSelected,\n  next: TSelected,\n) => boolean;\n\nconst DEFAULT_SELECTOR_EQUALITY = Object.is;\nconst CADENZA_VUE_RUNTIME_KEY: InjectionKey<CadenzaVueRuntime<any, any>> =\n  Symbol(\"CadenzaVueRuntime\");\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>(): CadenzaVueRuntime<TProjectionState, TCommands> {\n  const runtime = inject(CADENZA_VUE_RUNTIME_KEY, null);\n  if (!runtime) {\n    throw new Error(\n      \"Cadenza Vue runtime is not installed. Call app.use(runtime) before using Cadenza Vue composables.\",\n    );\n  }\n\n  return runtime as CadenzaVueRuntime<TProjectionState, TCommands>;\n}\n\nexport function createCadenzaVueRuntime<\n  TProjectionState extends Record<string, any>,\n  TCommands extends Record<string, any> = Record<string, never>,\n>(options: CadenzaVueRuntimeOptions<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  const snapshotRef = shallowRef<CadenzaVueRuntimeState<TProjectionState>>(\n    createProjectionRuntimeSnapshot(\n      runtime.getRuntimeState(),\n      initialProjectionState,\n    ),\n  );\n  const unsubscribe = runtime.subscribe((runtimeState) => {\n    snapshotRef.value = createProjectionRuntimeSnapshot(\n      runtimeState,\n      initialProjectionState,\n    );\n  });\n  let disposed = false;\n  const runtimeCommands = commands\n    ? commands({\n        cadenza,\n        runtime,\n      })\n    : ({} as TCommands);\n  const runtimeObject: CadenzaVueRuntime<TProjectionState, TCommands> = {\n    actor: runtime.actor,\n    actorHandle: runtime,\n    waitUntilReady: runtime.waitUntilReady,\n    inquire: runtime.inquire,\n    getRuntimeState: runtime.getRuntimeState,\n    subscribe: runtime.subscribe,\n    snapshot: readonly(snapshotRef) as Readonly<\n      ShallowRef<CadenzaVueRuntimeState<TProjectionState>>\n    >,\n    projectionState: computed(\n      () => snapshotRef.value.projectionState as TProjectionState,\n    ),\n    ready: computed(() => snapshotRef.value.ready),\n    commands: runtimeCommands,\n    install(app: App) {\n      app.provide(CADENZA_VUE_RUNTIME_KEY, runtimeObject);\n      app.config.globalProperties.$cadenzaRuntime = runtimeObject;\n    },\n    dispose() {\n      if (disposed) {\n        return;\n      }\n\n      disposed = true;\n      unsubscribe();\n    },\n  };\n\n  return markRaw(runtimeObject) as CadenzaVueRuntime<TProjectionState, TCommands>;\n}\n\nexport function useCadenzaRuntime<\n  TRuntime extends CadenzaVueRuntime<any, any> = CadenzaVueRuntime<any, any>,\n>(): TRuntime {\n  return getRequiredRuntime<any, any>() as TRuntime;\n}\n\nexport function useCadenzaRuntimeState<\n  TProjectionState extends Record<string, any> = Record<string, any>,\n>(): Readonly<ShallowRef<CadenzaVueRuntimeState<TProjectionState>>> {\n  return getRequiredRuntime<TProjectionState, Record<string, any>>().snapshot;\n}\n\nexport function useCadenzaProjectionState<\n  TProjectionState extends Record<string, any> = Record<string, any>,\n>(): ComputedRef<TProjectionState> {\n  return getRequiredRuntime<TProjectionState, Record<string, any>>()\n    .projectionState as ComputedRef<TProjectionState>;\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): Readonly<ShallowRef<TSelected>> {\n  const projectionState = useCadenzaProjectionState<TProjectionState>();\n  const selectedRef = shallowRef<TSelected>(\n    selector(projectionState.value as TProjectionState),\n  );\n\n  watch(\n    projectionState,\n    (nextProjectionState) => {\n      const nextSelected = selector(nextProjectionState as TProjectionState);\n      if (isEqual(selectedRef.value, nextSelected)) {\n        return;\n      }\n\n      selectedRef.value = nextSelected;\n    },\n    {\n      flush: \"sync\",\n    },\n  );\n\n  return readonly(selectedRef) as Readonly<ShallowRef<TSelected>>;\n}\n\nexport function useCadenzaRuntimeReady(): ComputedRef<boolean> {\n  return getRequiredRuntime<Record<string, any>, Record<string, any>>().ready;\n}\n\nexport type { BrowserRuntimeProjectionBinding };\n\ndeclare module \"vue\" {\n  interface ComponentCustomProperties {\n    $cadenzaRuntime: CadenzaVueRuntime<any, any>;\n  }\n}\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/vue/index.mjs

@@ -0,0 +1,140 @@
+import {
+  createProjectionRuntimeSnapshot
+} from "../chunk-DBCS4XXY.mjs";
+
+// src/vue/index.ts
+import {
+  computed,
+  inject,
+  markRaw,
+  readonly,
+  shallowRef,
+  watch
+} from "vue";
+var DEFAULT_SELECTOR_EQUALITY = Object.is;
+var CADENZA_VUE_RUNTIME_KEY = /* @__PURE__ */ Symbol("CadenzaVueRuntime");
+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 = inject(CADENZA_VUE_RUNTIME_KEY, null);
+  if (!runtime) {
+    throw new Error(
+      "Cadenza Vue runtime is not installed. Call app.use(runtime) before using Cadenza Vue composables."
+    );
+  }
+  return runtime;
+}
+function createCadenzaVueRuntime(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);
+  const snapshotRef = shallowRef(
+    createProjectionRuntimeSnapshot(
+      runtime.getRuntimeState(),
+      initialProjectionState
+    )
+  );
+  const unsubscribe = runtime.subscribe((runtimeState) => {
+    snapshotRef.value = createProjectionRuntimeSnapshot(
+      runtimeState,
+      initialProjectionState
+    );
+  });
+  let disposed = false;
+  const runtimeCommands = commands ? commands({
+    cadenza,
+    runtime
+  }) : {};
+  const runtimeObject = {
+    actor: runtime.actor,
+    actorHandle: runtime,
+    waitUntilReady: runtime.waitUntilReady,
+    inquire: runtime.inquire,
+    getRuntimeState: runtime.getRuntimeState,
+    subscribe: runtime.subscribe,
+    snapshot: readonly(snapshotRef),
+    projectionState: computed(
+      () => snapshotRef.value.projectionState
+    ),
+    ready: computed(() => snapshotRef.value.ready),
+    commands: runtimeCommands,
+    install(app) {
+      app.provide(CADENZA_VUE_RUNTIME_KEY, runtimeObject);
+      app.config.globalProperties.$cadenzaRuntime = runtimeObject;
+    },
+    dispose() {
+      if (disposed) {
+        return;
+      }
+      disposed = true;
+      unsubscribe();
+    }
+  };
+  return markRaw(runtimeObject);
+}
+function useCadenzaRuntime() {
+  return getRequiredRuntime();
+}
+function useCadenzaRuntimeState() {
+  return getRequiredRuntime().snapshot;
+}
+function useCadenzaProjectionState() {
+  return getRequiredRuntime().projectionState;
+}
+function useCadenzaProjectionSelector(selector, isEqual = DEFAULT_SELECTOR_EQUALITY) {
+  const projectionState = useCadenzaProjectionState();
+  const selectedRef = shallowRef(
+    selector(projectionState.value)
+  );
+  watch(
+    projectionState,
+    (nextProjectionState) => {
+      const nextSelected = selector(nextProjectionState);
+      if (isEqual(selectedRef.value, nextSelected)) {
+        return;
+      }
+      selectedRef.value = nextSelected;
+    },
+    {
+      flush: "sync"
+    }
+  );
+  return readonly(selectedRef);
+}
+function useCadenzaRuntimeReady() {
+  return getRequiredRuntime().ready;
+}
+export {
+  createCadenzaVueRuntime,
+  useCadenzaProjectionSelector,
+  useCadenzaProjectionState,
+  useCadenzaRuntime,
+  useCadenzaRuntimeReady,
+  useCadenzaRuntimeState
+};
+//# sourceMappingURL=index.mjs.map

package/dist/vue/index.mjs.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../src/vue/index.ts"],"sourcesContent":["import {\n  computed,\n  inject,\n  markRaw,\n  readonly,\n  shallowRef,\n  watch,\n  type App,\n  type ComputedRef,\n  type InjectionKey,\n  type ShallowRef,\n} from \"vue\";\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 CadenzaVueRuntimeState<\n  TProjectionState extends Record<string, any> = Record<string, any>,\n> extends ProjectionRuntimeSnapshot<TProjectionState> {}\n\nexport interface CadenzaVueRuntime<\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  snapshot: Readonly<ShallowRef<CadenzaVueRuntimeState<TProjectionState>>>;\n  projectionState: ComputedRef<TProjectionState>;\n  ready: ComputedRef<boolean>;\n  commands: TCommands;\n  install: (app: App) => void;\n  dispose: () => void;\n}\n\nexport interface CadenzaVueRuntimeOptions<\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\ntype EqualityComparator<TSelected> = (\n  previous: TSelected,\n  next: TSelected,\n) => boolean;\n\nconst DEFAULT_SELECTOR_EQUALITY = Object.is;\nconst CADENZA_VUE_RUNTIME_KEY: InjectionKey<CadenzaVueRuntime<any, any>> =\n  Symbol(\"CadenzaVueRuntime\");\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>(): CadenzaVueRuntime<TProjectionState, TCommands> {\n  const runtime = inject(CADENZA_VUE_RUNTIME_KEY, null);\n  if (!runtime) {\n    throw new Error(\n      \"Cadenza Vue runtime is not installed. Call app.use(runtime) before using Cadenza Vue composables.\",\n    );\n  }\n\n  return runtime as CadenzaVueRuntime<TProjectionState, TCommands>;\n}\n\nexport function createCadenzaVueRuntime<\n  TProjectionState extends Record<string, any>,\n  TCommands extends Record<string, any> = Record<string, never>,\n>(options: CadenzaVueRuntimeOptions<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  const snapshotRef = shallowRef<CadenzaVueRuntimeState<TProjectionState>>(\n    createProjectionRuntimeSnapshot(\n      runtime.getRuntimeState(),\n      initialProjectionState,\n    ),\n  );\n  const unsubscribe = runtime.subscribe((runtimeState) => {\n    snapshotRef.value = createProjectionRuntimeSnapshot(\n      runtimeState,\n      initialProjectionState,\n    );\n  });\n  let disposed = false;\n  const runtimeCommands = commands\n    ? commands({\n        cadenza,\n        runtime,\n      })\n    : ({} as TCommands);\n  const runtimeObject: CadenzaVueRuntime<TProjectionState, TCommands> = {\n    actor: runtime.actor,\n    actorHandle: runtime,\n    waitUntilReady: runtime.waitUntilReady,\n    inquire: runtime.inquire,\n    getRuntimeState: runtime.getRuntimeState,\n    subscribe: runtime.subscribe,\n    snapshot: readonly(snapshotRef) as Readonly<\n      ShallowRef<CadenzaVueRuntimeState<TProjectionState>>\n    >,\n    projectionState: computed(\n      () => snapshotRef.value.projectionState as TProjectionState,\n    ),\n    ready: computed(() => snapshotRef.value.ready),\n    commands: runtimeCommands,\n    install(app: App) {\n      app.provide(CADENZA_VUE_RUNTIME_KEY, runtimeObject);\n      app.config.globalProperties.$cadenzaRuntime = runtimeObject;\n    },\n    dispose() {\n      if (disposed) {\n        return;\n      }\n\n      disposed = true;\n      unsubscribe();\n    },\n  };\n\n  return markRaw(runtimeObject) as CadenzaVueRuntime<TProjectionState, TCommands>;\n}\n\nexport function useCadenzaRuntime<\n  TRuntime extends CadenzaVueRuntime<any, any> = CadenzaVueRuntime<any, any>,\n>(): TRuntime {\n  return getRequiredRuntime<any, any>() as TRuntime;\n}\n\nexport function useCadenzaRuntimeState<\n  TProjectionState extends Record<string, any> = Record<string, any>,\n>(): Readonly<ShallowRef<CadenzaVueRuntimeState<TProjectionState>>> {\n  return getRequiredRuntime<TProjectionState, Record<string, any>>().snapshot;\n}\n\nexport function useCadenzaProjectionState<\n  TProjectionState extends Record<string, any> = Record<string, any>,\n>(): ComputedRef<TProjectionState> {\n  return getRequiredRuntime<TProjectionState, Record<string, any>>()\n    .projectionState as ComputedRef<TProjectionState>;\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): Readonly<ShallowRef<TSelected>> {\n  const projectionState = useCadenzaProjectionState<TProjectionState>();\n  const selectedRef = shallowRef<TSelected>(\n    selector(projectionState.value as TProjectionState),\n  );\n\n  watch(\n    projectionState,\n    (nextProjectionState) => {\n      const nextSelected = selector(nextProjectionState as TProjectionState);\n      if (isEqual(selectedRef.value, nextSelected)) {\n        return;\n      }\n\n      selectedRef.value = nextSelected;\n    },\n    {\n      flush: \"sync\",\n    },\n  );\n\n  return readonly(selectedRef) as Readonly<ShallowRef<TSelected>>;\n}\n\nexport function useCadenzaRuntimeReady(): ComputedRef<boolean> {\n  return getRequiredRuntime<Record<string, any>, Record<string, any>>().ready;\n}\n\nexport type { BrowserRuntimeProjectionBinding };\n\ndeclare module \"vue\" {\n  interface ComponentCustomProperties {\n    $cadenzaRuntime: CadenzaVueRuntime<any, any>;\n  }\n}\n"],"mappings":"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","names":[]}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@cadenza.io/service",
-  "version": "2.18.3",
+  "version": "2.19.0",
   "description": "This is a lightweight framework for building seamless distributed asynchronous graphs and flows of tasks and signals.",
   "scripts": {
     "start": "node --loader ts-node/esm src/index.ts",
@@ -13,16 +13,63 @@
   "main": "dist/index.js",
   "module": "dist/index.mjs",
   "browser": "dist/browser/index.mjs",
-  "types": "dist/types/index.d.ts",
+  "types": "dist/index.d.ts",
   "exports": {
     ".": {
-      "types": "./dist/types/index.d.ts",
+      "types": "./dist/index.d.ts",
       "browser": {
         "import": "./dist/browser/index.mjs",
         "require": "./dist/browser/index.js"
       },
-      "require": "./dist/index.js",
-      "import": "./dist/index.mjs"
+      "require": {
+        "types": "./dist/index.d.ts",
+        "default": "./dist/index.js"
+      },
+      "import": {
+        "types": "./dist/index.d.mts",
+        "default": "./dist/index.mjs"
+      }
+    },
+    "./nuxt": {
+      "types": "./dist/nuxt/index.d.ts",
+      "require": {
+        "types": "./dist/nuxt/index.d.ts",
+        "default": "./dist/nuxt/index.js"
+      },
+      "import": {
+        "types": "./dist/nuxt/index.d.mts",
+        "default": "./dist/nuxt/index.mjs"
+      }
+    },
+    "./react": {
+      "types": "./dist/react/index.d.ts",
+      "browser": {
+        "import": "./dist/browser/react/index.mjs",
+        "require": "./dist/browser/react/index.js"
+      },
+      "require": {
+        "types": "./dist/react/index.d.ts",
+        "default": "./dist/react/index.js"
+      },
+      "import": {
+        "types": "./dist/react/index.d.mts",
+        "default": "./dist/react/index.mjs"
+      }
+    },
+    "./vue": {
+      "types": "./dist/vue/index.d.ts",
+      "browser": {
+        "import": "./dist/browser/vue/index.mjs",
+        "require": "./dist/browser/vue/index.js"
+      },
+      "require": {
+        "types": "./dist/vue/index.d.ts",
+        "default": "./dist/vue/index.js"
+      },
+      "import": {
+        "types": "./dist/vue/index.d.mts",
+        "default": "./dist/vue/index.mjs"
+      }
     }
   },
   "release": {
@@ -78,7 +125,12 @@
     "@types/express": "^5.0.3",
     "@types/lodash-es": "^4.17.12",
     "@types/node": "^24.0.1",
+    "@types/react": "^19.0.0",
+    "@types/react-test-renderer": "^19.0.0",
     "prettier": "3.6.2",
+    "react": "^19.0.0",
+    "react-test-renderer": "^19.0.0",
+    "vue": "^3.5.13",
     "semantic-release": "^24.2.3",
     "tsup": "^8.4.0",
     "tsx": "^4.20.2",
@@ -87,7 +139,7 @@
     "vitest": "^3.2.3"
   },
   "dependencies": {
-    "@cadenza.io/core": "^3.25.1",
+    "@cadenza.io/core": "^3.26.0",
     "@types/pg": "^8.15.4",
     "@types/uuid": "^10.0.0",
     "body-parser": "^2.2.0",
@@ -102,5 +154,9 @@
     "socket.io-client": "^4.8.1",
     "uuid": "^10.0.0",
     "xss": "^1.0.15"
+  },
+  "peerDependencies": {
+    "react": ">=18 <20",
+    "vue": ">=3 <4"
   }
 }