@warp-drive-mirror/core 5.10.0-alpha.13 → 5.10.0-alpha.14

package/dist/{-private-BpyvBYFj.js → -private-Y-13dsHO.js}

@@ -1,5 +1,5 @@
 import { getOrSetGlobal, peekTransient, setTransient } from "./types/-private.js";
-import { f as setPromiseResult, o as DOMError, u as getPromiseResult } from "./request-MiwUbGdT.js";
+import { f as setPromiseResult, o as DOMError, u as getPromiseResult } from "./request-DUGpwUhf.js";
 import { getGlobalConfig, macroCondition } from "@embroider/macros";
 
 //#region src/signals/reactivity/configure.ts
@@ -16,10 +16,12 @@ const OBJECT_SIGNAL = getOrSetGlobal("#{}", Symbol("#{}"));
 * The hooks which MUST be configured in order to use reactive arrays,
 * resources and documents with framework specfic signals or TC39 signals.
 *
-* Support for multiple frameworks simultaneously can be done via
-* this abstraction by returning multiple signals from the `createSignal`
-* method, and consuming the correct one via the correct framework via
-* the `consumeSignal` and `notifySignal` methods.
+* To support multiple frameworks on the same page, import
+* `@warp-drive-mirror/alien-signals/install` before each framework's `install` entry
+* point. Its hooks implement {@link SignalHooks.register}, so each framework's
+* hooks, passed to {@link registerSignals}, are added to its signals graph
+* instead of replacing it, and its memos stay up to date for every framework.
+* See [Using Ember and React on the Same Page](/guides/the-manual/cookbook/multiple-frameworks-on-one-page.md).
 *
 * Unlike many signals implementations, WarpDrive does not wrap values as
 * signals directly, but instead uses signals to alert the reactive layer
@@ -56,8 +58,9 @@ const OBJECT_SIGNAL = getOrSetGlobal("#{}", Symbol("#{}"));
 * @public
 */
 /**
-* Configures the signals implementation to use. Supports multiple
-* implementations simultaneously.
+* Configures the signals implementation to use, replacing any configured
+* before. To add a framework's hooks alongside those of other frameworks, use
+* {@link registerSignals} instead.
 *
 * See {@link HooksOptions} for the options passed to the provided function
 * when called.
@@ -75,6 +78,33 @@ function setupSignals(buildConfig) {
 	setTransient("signalHooks", hooks);
 }
 /**
+* Adds the hooks built by `buildConfig` to the configured signals implementation if it composes
+* other implementations, such as `@warp-drive-mirror/alien-signals`, and otherwise configures them with
+* {@link setupSignals}.
+*
+* A framework's `install` entry point calls this rather than `setupSignals`, so that importing
+* `@warp-drive-mirror/alien-signals/install` first lets every framework on the page share its signals
+* and memos.
+*
+* @example
+* ```ts
+* import { registerSignals } from '@warp-drive-mirror/core/configure';
+*
+* registerSignals(buildSignalConfig);
+* ```
+*
+* @summary Registers signal hooks with the configured composing implementation, or configures
+* them with `setupSignals` when there is none.
+* @since 5.10.0
+* @public
+* @param buildConfig - a function that takes options and returns a configuration object
+*/
+function registerSignals(buildConfig) {
+	const signalHooks = peekTransient("signalHooks");
+	if (signalHooks?.register) signalHooks.register(buildConfig);
+	else setupSignals(buildConfig);
+}
+/**
 * Internal method for consuming the configured `createSignal` hook
 *
 * @private
@@ -3890,5 +3920,5 @@ function getPromiseState(promise) {
 }
 
 //#endregion
-export { ARRAY_SIGNAL as A, createInternalMemo as C, notifyInternalSignal as D, makeInitializer as E, setupSignals as M, waitFor as N, peekInternalSignal as O, willSyncFlushWatchers as P, consumeInternalSignal as S, getOrCreateInternalSignal as T, entangleSignal as _, getPaginationState as a, signal as b, getPaginationCache as c, getRequestState as d, createSignalDescriptor as f, entangleInitiallyStaleSignal as g, defineSignal as h, getPaginationLinks as i, OBJECT_SIGNAL as j, withSignalStore as k, DISPOSE as l, defineNonEnumerableSignal as m, createPaginationLinksSubscription as n, clearPaginationCache as o, defineGate as p, createPaginationSubscription as r, defaultPageHints as s, getPromiseState as t, createRequestSubscription as u, gate as v, createInternalSignal as w, Signals as x, memoized as y };
-//# sourceMappingURL=-private-BpyvBYFj.js.map
+export { ARRAY_SIGNAL as A, createInternalMemo as C, notifyInternalSignal as D, makeInitializer as E, willSyncFlushWatchers as F, registerSignals as M, setupSignals as N, peekInternalSignal as O, waitFor as P, consumeInternalSignal as S, getOrCreateInternalSignal as T, entangleSignal as _, getPaginationState as a, signal as b, getPaginationCache as c, getRequestState as d, createSignalDescriptor as f, entangleInitiallyStaleSignal as g, defineSignal as h, getPaginationLinks as i, OBJECT_SIGNAL as j, withSignalStore as k, DISPOSE as l, defineNonEnumerableSignal as m, createPaginationLinksSubscription as n, clearPaginationCache as o, defineGate as p, createPaginationSubscription as r, defaultPageHints as s, getPromiseState as t, createRequestSubscription as u, gate as v, createInternalSignal as w, Signals as x, memoized as y };
+//# sourceMappingURL=-private-Y-13dsHO.js.map