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

package/dist/unpkg/dev/store/-private.js

@@ -1,3 +1,3 @@
-import { C as setRecordIdentifier, D as isRequestKey, E as fieldValueIdentity, F as coerceId, I as ensureStringId, L as log, O as isResourceKey, P as normalizeModelName, R as logGroup, S as recordIdentifierFor, T as assertPrivateCapabilities, _ as isPrivateStore, b as StoreMap, f as createLegacyManyArray, g as assertPrivateStore, h as Store, m as CacheHandler, p as constructResource, v as RecordArrayManager, w as storeFor, x as _clearCaches, y as fastPush } from "../src-FSk0Z_Lp.js";
+import { C as setRecordIdentifier, D as isRequestKey, E as fieldValueIdentity, F as coerceId, I as ensureStringId, L as log, O as isResourceKey, P as normalizeModelName, R as logGroup, S as recordIdentifierFor, T as assertPrivateCapabilities, _ as isPrivateStore, b as StoreMap, f as createLegacyManyArray, g as assertPrivateStore, h as Store, m as CacheHandler, p as constructResource, v as RecordArrayManager, w as storeFor, x as _clearCaches, y as fastPush } from "../src-DqRXbeNO.js";
 
 export { CacheHandler, RecordArrayManager, Store, StoreMap, _clearCaches, normalizeModelName as _deprecatingNormalize, assertPrivateCapabilities, assertPrivateStore, coerceId, constructResource, createLegacyManyArray, ensureStringId, fastPush, fieldValueIdentity, isPrivateStore, isRequestKey, isResourceKey, log, logGroup, recordIdentifierFor, setRecordIdentifier, storeFor };

package/dist/unpkg/dev/types/-private.js

@@ -1,6 +1,6 @@
 //#region src/types/-private.ts
 const name = "@warp-drive-mirror/core";
-const version = "5.10.0-alpha.13";
+const version = "5.10.0-alpha.15";
 const GlobalRef = globalThis;
 const UniversalCache = GlobalRef.__warpDrive_universalCache = GlobalRef.__warpDrive_universalCache ?? {};
 GlobalRef[name] = GlobalRef[name] ?? { __version: version };

package/dist/unpkg/dev/types/runtime.js

@@ -2,8 +2,12 @@ import { getOrSetUniversal } from "./-private.js";
 
 //#region src/types/runtime.ts
 /**
-* the shape of the runtime-configurable debug logging flags, see
-* {@link @warp-drive-mirror/core!build-config/debugging | the debugging flags}
+* The shape of the runtime-configurable debug logging flags: one boolean per
+* {@link @warp-drive-mirror/core!build-config/debugging | debugging flag}. Pass a
+* `Partial<LOG_CONFIG>` to {@link setLogging}.
+*
+* @summary The runtime debug logging flags, one boolean per debugging flag, as accepted by `setLogging`.
+* @public
 */
 const RuntimeConfig = getOrSetUniversal("WarpDriveRuntimeConfig", { debug: {} });
 function trySessionStorage() {
@@ -31,7 +35,7 @@ function getRuntimeConfig() {
 * Upserts the specified logging configuration into the runtime
 * config.
 *
-* globalThis.setWarpDriveLogging({ LOG_CACHE: true } });
+* globalThis.setWarpDriveLogging({ LOG_CACHE: true });
 *
 */
 function setLogging(config) {

package/dist/unpkg/dev/types/runtime.js.map

@@ -1 +1 @@
-{"version":3,"file":"runtime.js","names":["getOrSetUniversal","RuntimeConfig","debug","trySessionStorage","globalThis","sessionStorage","undefined","storage","settings","getItem","Object","assign","JSON","parse","getRuntimeConfig","setLogging","config","setItem","stringify","setIsMaybeMirage","value","mirage"],"sources":["../../../../src/types/runtime.ts"],"sourcesContent":["import type * as LOGGING from '@warp-drive-mirror/build-config/debugging';\n\nimport { getOrSetUniversal } from './-private.ts';\n\n/**\n * the shape of the runtime-configurable debug logging flags, see\n * {@link @warp-drive-mirror/core!build-config/debugging | the debugging flags}\n */\n\ntype LOG_CONFIG_KEY = keyof typeof LOGGING;\ntype LOG_CONFIG = { [key in LOG_CONFIG_KEY]: boolean };\n\nconst RuntimeConfig: {\n  /**\n   * the currently active logging configuration, see\n   * {@link @warp-drive-mirror/core!build-config/debugging | the debugging flags}\n   */\n  debug: Partial<LOG_CONFIG>;\n  /**\n   * whether requests should be treated as being served by Mirage,\n   * see {@link setIsMaybeMirage}\n   */\n  mirage?: boolean;\n} = getOrSetUniversal('WarpDriveRuntimeConfig', {\n  debug: {},\n});\n\nfunction trySessionStorage() {\n  // This works even when sessionStorage is not available.\n  // See https://github.com/warp-drive-data/warp-drive/issues/9784\n  try {\n    return globalThis.sessionStorage;\n  } catch {\n    return undefined;\n  }\n}\n\nconst storage = trySessionStorage();\nconst settings = storage?.getItem('WarpDriveRuntimeConfig');\nif (settings) {\n  Object.assign(RuntimeConfig, JSON.parse(settings));\n}\n\n/**\n * Returns the current WarpDrive runtime configuration.\n *\n * @example\n * ```ts\n * const { debug, mirage } = getRuntimeConfig();\n * ```\n */\nexport function getRuntimeConfig(): typeof RuntimeConfig {\n  return RuntimeConfig;\n}\n\n/**\n * Upserts the specified logging configuration into the runtime\n * config.\n *\n * globalThis.setWarpDriveLogging({ LOG_CACHE: true } });\n *\n */\nexport function setLogging(config: Partial<LOG_CONFIG>): void {\n  Object.assign(RuntimeConfig.debug, config);\n  storage?.setItem('WarpDriveRuntimeConfig', JSON.stringify(RuntimeConfig));\n}\n\n/**\n * Explicitly declares whether requests may be served by Mirage (or another\n * Pretender-based fetch mock) instead of a native `fetch` implementation.\n *\n * The `Fetch` request handler otherwise infers this via a heuristic (the\n * presence of `window.server.pretender`, or `window.fetch` appearing to be\n * patched), which can be wrong in either direction: some Mirage setups don't\n * expose `window.server`, while some unrelated tools (APM agents, browser\n * extensions) also patch `fetch`. Call this to override that heuristic:\n * `true` to force Mirage-compatible behavior on, `false` to force it off.\n *\n * globalThis.setWarpDriveIsMaybeMirage(true);\n *\n */\nexport function setIsMaybeMirage(value: boolean): void {\n  RuntimeConfig.mirage = value;\n  storage?.setItem('WarpDriveRuntimeConfig', JSON.stringify(RuntimeConfig));\n}\n"],"mappings":";;;;;;;AAYA,MAAMC,gBAWFD,kBAAkB,0BAA0B,EAC9CE,OAAO,CAAC,EACV,CAAC;AAED,SAASC,oBAAoB;CAG3B,IAAI;EACF,OAAOC,WAAWC;CACpB,QAAQ;EACN;CACF;AACF;AAEA,MAAME,UAAUJ,kBAAkB;AAClC,MAAMK,WAAWD,SAASE,QAAQ,wBAAwB;AAC1D,IAAID,UACFE,OAAOC,OAAOV,eAAeW,KAAKC,MAAML,QAAQ,CAAC;;;;;;;;;AAWnD,SAAgBM,mBAAyC;CACvD,OAAOb;AACT;;;;;;;;AASA,SAAgBc,WAAWC,QAAmC;CAC5DN,OAAOC,OAAOV,cAAcC,OAAOc,MAAM;CACzCT,SAASU,QAAQ,0BAA0BL,KAAKM,UAAUjB,aAAa,CAAC;AAC1E;;;;;;;;;;;;;;;AAgBA,SAAgBkB,iBAAiBC,OAAsB;CACrDnB,cAAcoB,SAASD;CACvBb,SAASU,QAAQ,0BAA0BL,KAAKM,UAAUjB,aAAa,CAAC;AAC1E"}
+{"version":3,"file":"runtime.js","names":["getOrSetUniversal","RuntimeConfig","debug","trySessionStorage","globalThis","sessionStorage","undefined","storage","settings","getItem","Object","assign","JSON","parse","getRuntimeConfig","setLogging","config","setItem","stringify","setIsMaybeMirage","value","mirage"],"sources":["../../../../src/types/runtime.ts"],"sourcesContent":["import type * as LOGGING from '@warp-drive-mirror/build-config/debugging';\n\nimport { getOrSetUniversal } from './-private.ts';\n\ntype LOG_CONFIG_KEY = keyof typeof LOGGING;\n\n/**\n * The shape of the runtime-configurable debug logging flags: one boolean per\n * {@link @warp-drive-mirror/core!build-config/debugging | debugging flag}. Pass a\n * `Partial<LOG_CONFIG>` to {@link setLogging}.\n *\n * @summary The runtime debug logging flags, one boolean per debugging flag, as accepted by `setLogging`.\n * @public\n */\nexport type LOG_CONFIG = { [key in LOG_CONFIG_KEY]: boolean };\n\nconst RuntimeConfig: {\n  /**\n   * the currently active logging configuration, see\n   * {@link @warp-drive-mirror/core!build-config/debugging | the debugging flags}\n   */\n  debug: Partial<LOG_CONFIG>;\n  /**\n   * whether requests should be treated as being served by Mirage,\n   * see {@link setIsMaybeMirage}\n   */\n  mirage?: boolean;\n} = getOrSetUniversal('WarpDriveRuntimeConfig', {\n  debug: {},\n});\n\nfunction trySessionStorage() {\n  // This works even when sessionStorage is not available.\n  // See https://github.com/warp-drive-data/warp-drive/issues/9784\n  try {\n    return globalThis.sessionStorage;\n  } catch {\n    return undefined;\n  }\n}\n\nconst storage = trySessionStorage();\nconst settings = storage?.getItem('WarpDriveRuntimeConfig');\nif (settings) {\n  Object.assign(RuntimeConfig, JSON.parse(settings));\n}\n\n/**\n * Returns the current WarpDrive runtime configuration.\n *\n * @example\n * ```ts\n * const { debug, mirage } = getRuntimeConfig();\n * ```\n */\nexport function getRuntimeConfig(): typeof RuntimeConfig {\n  return RuntimeConfig;\n}\n\n/**\n * Upserts the specified logging configuration into the runtime\n * config.\n *\n * globalThis.setWarpDriveLogging({ LOG_CACHE: true });\n *\n */\nexport function setLogging(config: Partial<LOG_CONFIG>): void {\n  Object.assign(RuntimeConfig.debug, config);\n  storage?.setItem('WarpDriveRuntimeConfig', JSON.stringify(RuntimeConfig));\n}\n\n/**\n * Explicitly declares whether requests may be served by Mirage (or another\n * Pretender-based fetch mock) instead of a native `fetch` implementation.\n *\n * The `Fetch` request handler otherwise infers this via a heuristic (the\n * presence of `window.server.pretender`, or `window.fetch` appearing to be\n * patched), which can be wrong in either direction: some Mirage setups don't\n * expose `window.server`, while some unrelated tools (APM agents, browser\n * extensions) also patch `fetch`. Call this to override that heuristic:\n * `true` to force Mirage-compatible behavior on, `false` to force it off.\n *\n * globalThis.setWarpDriveIsMaybeMirage(true);\n *\n */\nexport function setIsMaybeMirage(value: boolean): void {\n  RuntimeConfig.mirage = value;\n  storage?.setItem('WarpDriveRuntimeConfig', JSON.stringify(RuntimeConfig));\n}\n"],"mappings":";;;;;;;;;;;AAgBA,MAAMC,gBAWFD,kBAAkB,0BAA0B,EAC9CE,OAAO,CAAC,EACV,CAAC;AAED,SAASC,oBAAoB;CAG3B,IAAI;EACF,OAAOC,WAAWC;CACpB,QAAQ;EACN;CACF;AACF;AAEA,MAAME,UAAUJ,kBAAkB;AAClC,MAAMK,WAAWD,SAASE,QAAQ,wBAAwB;AAC1D,IAAID,UACFE,OAAOC,OAAOV,eAAeW,KAAKC,MAAML,QAAQ,CAAC;;;;;;;;;AAWnD,SAAgBM,mBAAyC;CACvD,OAAOb;AACT;;;;;;;;AASA,SAAgBc,WAAWC,QAAmC;CAC5DN,OAAOC,OAAOV,cAAcC,OAAOc,MAAM;CACzCT,SAASU,QAAQ,0BAA0BL,KAAKM,UAAUjB,aAAa,CAAC;AAC1E;;;;;;;;;;;;;;;AAgBA,SAAgBkB,iBAAiBC,OAAsB;CACrDnB,cAAcoB,SAASD;CACvBb,SAASU,QAAQ,0BAA0BL,KAAKM,UAAUjB,aAAa,CAAC;AAC1E"}

package/dist/unpkg/dev-deprecated/{-private-BH4O810v.js → -private-BoKjsWc1.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-Fe-vpe-u.js";
+import { f as setPromiseResult, o as DOMError, u as getPromiseResult } from "./request-BQUGZTOj.js";
 
 //#region src/signals/reactivity/configure.ts
 const ARRAY_SIGNAL = getOrSetGlobal("#[]", Symbol("#[]"));
@@ -15,10 +15,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
@@ -55,8 +57,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.
@@ -74,6 +77,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
@@ -3879,5 +3909,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-BH4O810v.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-BoKjsWc1.js.map