@ember-data/store 5.6.0-alpha.1 → 5.6.0-alpha.12

package/unstable-preview-types/index.d.ts

@@ -1,229 +1,7 @@
-/// <reference path="./types.d.ts" />
 /// <reference path="./configure.d.ts" />
 /// <reference path="./-private.d.ts" />
-/// <reference path="./-types/overview.d.ts" />
-/// <reference path="./-types/q/store.d.ts" />
-/// <reference path="./-types/q/identifier.d.ts" />
-/// <reference path="./-types/q/promise-proxies.d.ts" />
-/// <reference path="./-types/q/schema-service.d.ts" />
-/// <reference path="./-types/q/record-instance.d.ts" />
-/// <reference path="./-types/q/record-data-json-api.d.ts" />
-/// <reference path="./-types/q/cache-capabilities-manager.d.ts" />
-/// <reference path="./-types/q/ds-model.d.ts" />
-/// <reference path="./-private/store-service.d.ts" />
-/// <reference path="./-private/store-service.type-test.d.ts" />
-/// <reference path="./-private/document.d.ts" />
-/// <reference path="./-private/caches/cache-utils.d.ts" />
-/// <reference path="./-private/caches/resource-utils.d.ts" />
-/// <reference path="./-private/caches/instance-cache.d.ts" />
-/// <reference path="./-private/caches/identifier-cache.d.ts" />
-/// <reference path="./-private/legacy-model-support/shim-model-class.d.ts" />
-/// <reference path="./-private/legacy-model-support/record-reference.d.ts" />
-/// <reference path="./-private/managers/notification-manager.d.ts" />
-/// <reference path="./-private/managers/record-array-manager.d.ts" />
-/// <reference path="./-private/managers/cache-capabilities-manager.d.ts" />
-/// <reference path="./-private/managers/cache-manager.d.ts" />
-/// <reference path="./-private/new-core-tmp/request-state.d.ts" />
-/// <reference path="./-private/new-core-tmp/promise-state.d.ts" />
-/// <reference path="./-private/new-core-tmp/reactivity/internal.d.ts" />
-/// <reference path="./-private/new-core-tmp/reactivity/signal.d.ts" />
-/// <reference path="./-private/new-core-tmp/reactivity/configure.d.ts" />
-/// <reference path="./-private/debug/utils.d.ts" />
-/// <reference path="./-private/network/request-cache.d.ts" />
-/// <reference path="./-private/cache-handler/utils.d.ts" />
-/// <reference path="./-private/cache-handler/types.d.ts" />
-/// <reference path="./-private/cache-handler/handler.d.ts" />
-/// <reference path="./-private/utils/normalize-model-name.d.ts" />
-/// <reference path="./-private/utils/uuid-polyfill.d.ts" />
-/// <reference path="./-private/utils/construct-resource.d.ts" />
-/// <reference path="./-private/utils/is-non-empty-string.d.ts" />
-/// <reference path="./-private/utils/coerce-id.d.ts" />
-/// <reference path="./-private/record-arrays/identifier-array.d.ts" />
-/// <reference path="./-private/record-arrays/many-array.d.ts" />
-/// <reference path="./-private/record-arrays/native-proxy-type-fix.d.ts" />
+/// <reference path="./types.d.ts" />
 declare module '@ember-data/store' {
-  /**
-   * <p align="center">
-   *   <img
-   *     class="project-logo"
-   *     src="https://raw.githubusercontent.com/emberjs/data/4612c9354e4c54d53327ec2cf21955075ce21294/ember-data-logo-light.svg#gh-light-mode-only"
-   *     alt="EmberData Store"
-   *     width="240px"
-   *     title="EmberData Store"
-   *     />
-   * </p>
-   *
-   * This package provides [*Ember***Data**](https://github.com/emberjs/data/)'s `Store` class.
-   *
-   * A [Store](https://api.emberjs.com/ember-data/release/classes/Store) coordinates interaction between your application, a [Cache](https://api.emberjs.com/ember-data/release/classes/%3CInterface%3E%20Cache),
-   * and sources of data (such as your API or a local persistence layer) accessed via a [RequestManager](https://github.com/emberjs/data/tree/main/packages/request).
-   *
-   * Optionally, a Store can be configured to hydrate the response data into rich presentation classes.
-   *
-   * ## Installation
-   *
-   * If you have installed `ember-data` then you already have this package installed.
-   * Otherwise you can install it using your javascript package manager of choice.
-   * For instance with [pnpm](https://pnpm.io/)
-   *
-   * ```
-   * pnpm add @ember-data/store
-   * ```
-   *
-   * After installing you will want to configure your first `Store`. Read more below
-   * for how to create and configure stores for your application.
-   *
-   *
-   * ## 🔨 Creating A Store
-   *
-   * To use a `Store` we will need to do few things: add a [Cache](https://api.emberjs.com/ember-data/release/classes/%3CInterface%3E%20Cache)
-   * to store data **in-memory**, add a [Handler](https://api.emberjs.com/ember-data/release/classes/%3CInterface%3E%20Cache) to fetch data from a source,
-   * and implement `instantiateRecord` to tell the store how to display the data for individual resources.
-   *
-   * > **Note**
-   * > If you are using the package `ember-data` then a JSON:API cache, RequestManager, LegacyNetworkHandler,
-   * > and `instantiateRecord` are configured for you by default.
-   *
-   * ### Configuring A Cache
-   *
-   * To start, let's install a [JSON:API](https://jsonapi.org/) cache. If your app uses `GraphQL` or `REST` other
-   * caches may better fit your data. You can author your own cache by creating one that
-   * conforms to the [spec](https://api.emberjs.com/ember-data/release/classes/%3CInterface%3E%20Cache).
-   *
-   * The package `@ember-data/json-api` provides a [JSON:API](https://jsonapi.org/) cache we can use.
-   * After installing it, we can configure the store to use this cache.
-   *
-   * ```js
-   * import Store from '@ember-data/store';
-   * import Cache from '@ember-data/json-api';
-   *
-   * class extends Store {
-   *   createCache(storeWrapper) {
-   *     return new Cache(storeWrapper);
-   *   }
-   * }
-   * ```
-   *
-   * Now that we have a `cache` let's setup something to handle fetching
-   * and saving data via our API.
-   *
-   * > **Note**
-   * > The `ember-data` package automatically includes and configures
-   * > the `@ember-data/json-api` cache for you.
-   *
-   * ### Handling Requests
-   *
-   * When *Ember***Data** needs to fetch or save data it will pass that request to your application's `RequestManager` for fulfillment. How this fulfillment occurs (in-memory, device storage, via single or multiple API requests, etc.) is then up to the registered request handlers.
-   *
-   * To start, let's install the `RequestManager` from `@ember-data/request` and the basic `Fetch` handler from ``@ember-data/request/fetch`.
-   *
-   * > **Note**
-   * > If your app uses `GraphQL`, `REST` or different conventions for `JSON:API` than your cache expects, other handlers may better fit your data. You can author your own handler by creating one that conforms to the [handler interface](https://github.com/emberjs/data/tree/main/packages/request#handling-requests).
-   *
-   * ```ts
-   * import Store from '@ember-data/store';
-   * import RequestManager from '@ember-data/request';
-   * import Fetch from '@ember-data/request/fetch';
-   *
-   * export default class extends Store {
-   *   requestManager = new RequestManager()
-   *    .use([Fetch]);
-   * }
-   * ```
-   *
-   * **Using RequestManager as a Service**
-   *
-   * Alternatively if you have configured the `RequestManager` to be a service you may re-use it.
-   *
-   * *app/services/request.js*
-   * ```ts
-   * import RequestManager from '@ember-data/request';
-   * import Fetch from '@ember-data/request/fetch';
-   *
-   * export default class extends RequestManager {
-   *   constructor(createArgs) {
-   *     super(createArgs);
-   *     this.use([Fetch]);
-   *   }
-   * }
-   * ```
-   *
-   * *app/services/store.js*
-   * ```ts
-   * import Store from '@ember-data/store';
-   * import { service } from '@ember/service';
-   *
-   * export default class extends Store {
-   *   @service('request') requestManager
-   * }
-   * ```
-   *
-   *
-   * ### Presenting Data from the Cache
-   *
-   * Now that we have a source and a cache for our data, we need to configure how
-   * the Store delivers that data back to our application. We do this via the hook
-   * [instantiateRecord](https://api.emberjs.com/ember-data/release/classes/Store/methods/instantiateRecord%20(hook)?anchor=instantiateRecord%20(hook)),
-   * which allows us to transform the data for a resource before handing it to the application.
-   *
-   * A naive way to present the data would be to return it as JSON. Typically instead
-   * this hook will be used to add reactivity and make each unique resource a singleton,
-   * ensuring that if the cache updates our presented data will reflect the new state.
-   *
-   * Below is an example of using the hooks `instantiateRecord` and a `teardownRecord`
-   * to provide minimal read-only reactive state for simple resources.
-   *
-   * ```ts
-   * import Store, { recordIdentifierFor } from '@ember-data/store';
-   * import { TrackedObject } from 'tracked-built-ins';
-   *
-   * class extends Store {
-   *   instantiateRecord(identifier) {
-   *     const { cache, notifications } = this;
-   *
-   *     // create a TrackedObject with our attributes, id and type
-   *     const record = new TrackedObject(Object.assign({}, cache.peek(identifier)));
-   *     record.type = identifier.type;
-   *     record.id = identifier.id;
-   *
-   *     notifications.subscribe(identifier, (_, change) => {
-   *       if (change === 'attributes') {
-   *         Object.assign(record, cache.peek(identifier));
-   *       }
-   *     });
-   *
-   *     return record;
-   *   }
-   * }
-   * ```
-   *
-   * Because `instantiateRecord` is opaque to the nature of the record, an implementation
-   * can be anything from a fairly simple object to a robust proxy that intelligently links
-   * together associated records through relationships.
-   *
-   * This also enables creating a record that separates `edit` flows from `create` flows
-   * entirely. A record class might choose to implement a `checkout`method that gives access
-   * to an editable instance while the primary record continues to be read-only and reflect
-   * only persisted (non-mutated) state.
-   *
-   * Typically you will choose an existing record implementation such as `@ember-data/model`
-   * for your application.
-   *
-   * Because of the boundaries around instantiation and the cache, record implementations
-   * should be capable of interop both with each other and with any `Cache`. Due to this,
-   * if needed an application can utilize multiple record implementations and multiple cache
-   * implementations either to support enhanced features for only a subset of records or to
-   * be able to incrementally migrate from one record/cache to another record or cache.
-   *
-   * > **Note**
-   * > The `ember-data` package automatically includes the `@ember-data/model`
-   * > package and configures it for you.
-   *
-   * @module @ember-data/store
-   * @main @ember-data/store
-   */
-  export { Store as default, type StoreRequestContext, CacheHandler, type Document, type CachePolicy, type StoreRequestInput, recordIdentifierFor, storeFor, } from '@ember-data/store/-private';
-  export type { DocumentCacheOperation, CacheOperation, NotificationType, } from '@ember-data/store/-private/managers/notification-manager';
-  export { setIdentifierGenerationMethod, setIdentifierUpdateMethod, setIdentifierForgetMethod, setIdentifierResetMethod, setKeyInfoForResource, } from '@ember-data/store/-private/caches/identifier-cache';
+  export { Store as default, type StoreRequestContext, CacheHandler, type Document, type CachePolicy, type StoreRequestInput, recordIdentifierFor, storeFor, type DocumentCacheOperation, type CacheOperation, type NotificationType, setIdentifierGenerationMethod, setIdentifierUpdateMethod, setIdentifierForgetMethod, setIdentifierResetMethod, setKeyInfoForResource, } from '@warp-drive/core';
 }
 //# sourceMappingURL=index.d.ts.map

package/unstable-preview-types/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAmLG;AACH,OAAO,EACL,KAAK,IAAI,OAAO,EAChB,KAAK,mBAAmB,EACxB,YAAY,EACZ,KAAK,QAAQ,EACb,KAAK,WAAW,EAChB,KAAK,iBAAiB,EACtB,mBAAmB,EACnB,QAAQ,GACT,MAAM,YAAY,CAAC;AAEpB,YAAY,EACV,sBAAsB,EACtB,cAAc,EACd,gBAAgB,GACjB,MAAM,0CAA0C,CAAC;AAElD,OAAO,EACL,6BAA6B,EAC7B,yBAAyB,EACzB,yBAAyB,EACzB,wBAAwB,EACxB,qBAAqB,GACtB,MAAM,oCAAoC,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AA2LA,OAAO,EACL,KAAK,IAAI,OAAO,EAChB,KAAK,mBAAmB,EACxB,YAAY,EACZ,KAAK,QAAQ,EACb,KAAK,WAAW,EAChB,KAAK,iBAAiB,EACtB,mBAAmB,EACnB,QAAQ,EACR,KAAK,sBAAsB,EAC3B,KAAK,cAAc,EACnB,KAAK,gBAAgB,EACrB,6BAA6B,EAC7B,yBAAyB,EACzB,yBAAyB,EACzB,wBAAwB,EACxB,qBAAqB,GACtB,MAAM,kBAAkB,CAAC"}

package/unstable-preview-types/types.d.ts

@@ -1,7 +1,4 @@
 declare module '@ember-data/store/types' {
-  export type { CacheCapabilitiesManager } from '@ember-data/store/-types/q/cache-capabilities-manager';
-  export type { ModelSchema } from '@ember-data/store/-types/q/ds-model';
-  export type { SchemaService } from '@ember-data/store/-types/q/schema-service';
-  export type { BaseFinderOptions, FindRecordOptions, LegacyResourceQuery, QueryOptions, FindAllOptions, } from '@ember-data/store/-types/q/store';
+  export type { CacheCapabilitiesManager, ModelSchema, SchemaService, BaseFinderOptions, FindRecordOptions, LegacyResourceQuery, QueryOptions, FindAllOptions, } from '@warp-drive/core/types';
 }
 //# sourceMappingURL=types.d.ts.map

package/unstable-preview-types/types.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../src/types.ts"],"names":[],"mappings":"AAAA,YAAY,EAAE,wBAAwB,EAAE,MAAM,uCAAuC,CAAC;AACtF,YAAY,EAAE,WAAW,EAAE,MAAM,qBAAqB,CAAC;AACvD,YAAY,EAAE,aAAa,EAAE,MAAM,2BAA2B,CAAC;AAC/D,YAAY,EACV,iBAAiB,EACjB,iBAAiB,EACjB,mBAAmB,EACnB,YAAY,EACZ,cAAc,GACf,MAAM,kBAAkB,CAAC"}
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../src/types.ts"],"names":[],"mappings":"AAAA,YAAY,EACV,wBAAwB,EACxB,WAAW,EACX,aAAa,EACb,iBAAiB,EACjB,iBAAiB,EACjB,mBAAmB,EACnB,YAAY,EACZ,cAAc,GACf,MAAM,wBAAwB,CAAC"}

package/dist/configure-BfLLW6GY.js

@@ -1,161 +0,0 @@
-import { deprecate } from '@ember/debug';
-import { macroCondition, getGlobalConfig, dependencySatisfies, importSync } from '@embroider/macros';
-import { getOrSetGlobal, setTransient, peekTransient } from '@warp-drive/core-types/-private';
-const ARRAY_SIGNAL = getOrSetGlobal('#[]', Symbol('#[]'));
-const OBJECT_SIGNAL = getOrSetGlobal('#{}', Symbol('#{}'));
-
-/**
- * Requirements:
- *
- * Signal:
- *
- * - signal: a way of creating a reference that we can dirty when we desire to notify
- *         - @signal: a way of creating an accessor on an object that subscribes to a signal on access
- *                    and notifies the signal on set, or of upgrading a descriptor to be such an accessor
- *         - defineSignal: a way of creating a signal on an object
- *         - notifySignal: a way of notifying the underlying signal that it has been dirtied
- *         - peekSignal: a way of inspecting the signal without notifying it
- *
- *  - gate: a memoized getter function that re-runs when on access if its signal is dirty
- *          conceptually, a gate is a tightly coupled signal and memo
- *         - @gate: a way of creating a gate on an object or upgrading a descriptor with a getter
- *                  to be a gate
- *         - defineGate: a way of creating a gate on an object
- *         - notifySignal: a way of notifying the signal for a gate that it has been dirtied
- *
- * - memo:
- *        - @memo: a way of creating a memoized getter on an object or upgrading a descriptor with a getter
- *                 to be a memo
- *        - defineMemo: a way of creating a memo on an object
- *
- * - signalStore: storage bucket for signals associated to an object
- *        - withSignalStore: a way of pre-creating a signal store on an object
- *
- *
- * @internal
- */
-
-/**
- * An Opaque type that represents a framework specific or TC39 signal.
- *
- * It may be an array of signals or a single signal.
- *
- * @internal
- */
-
-/**
- * The hooks which MUST be configured in order to use this library,
- * either for 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.
- *
- * @typedoc
- */
-
-/**
- * The public API for configuring the signal hooks.
- *
- * @internal
- */
-function setupSignals(buildConfig) {
-  // We want to assert this but can't because too many package manager
-  // and bundler bugs exist that cause this to be called multiple times
-  // for what should be a single call.
-  // assert(`Cannot override configured signal hooks`, peekTransient('signalHooks') === null);
-  const hooks = buildConfig({
-    wellknown: {
-      Array: ARRAY_SIGNAL
-    }
-  });
-  setTransient('signalHooks', hooks);
-}
-
-/**
- * Internal method for consuming the configured `createSignal` hook
- *
- * @internal
- */
-function createSignal(obj, key) {
-  const signalHooks = peekTransient('signalHooks');
-  macroCondition(getGlobalConfig().WarpDrive.env.DEBUG) ? (test => {
-    if (!test) {
-      throw new Error(`Signal hooks not configured`);
-    }
-  })(signalHooks) : {};
-  return signalHooks.createSignal(obj, key);
-}
-
-/**
- * Internal method for consuming the configured `consumeSignal` hook
- *
- * @internal
- */
-function consumeSignal(signal) {
-  const signalHooks = peekTransient('signalHooks');
-  macroCondition(getGlobalConfig().WarpDrive.env.DEBUG) ? (test => {
-    if (!test) {
-      throw new Error(`Signal hooks not configured`);
-    }
-  })(signalHooks) : {};
-  return signalHooks.consumeSignal(signal);
-}
-
-/**
- * Internal method for consuming the configured `notifySignal` hook
- *
- * @internal
- */
-function notifySignal(signal) {
-  const signalHooks = peekTransient('signalHooks');
-  macroCondition(getGlobalConfig().WarpDrive.env.DEBUG) ? (test => {
-    if (!test) {
-      throw new Error(`Signal hooks not configured`);
-    }
-  })(signalHooks) : {};
-  return signalHooks.notifySignal(signal);
-}
-function createMemo(object, key, fn) {
-  const signalHooks = peekTransient('signalHooks');
-  macroCondition(getGlobalConfig().WarpDrive.env.DEBUG) ? (test => {
-    if (!test) {
-      throw new Error(`Signal hooks not configured`);
-    }
-  })(signalHooks) : {};
-  return signalHooks.createMemo(object, key, fn);
-}
-function willSyncFlushWatchers() {
-  const signalHooks = peekTransient('signalHooks');
-  macroCondition(getGlobalConfig().WarpDrive.env.DEBUG) ? (test => {
-    if (!test) {
-      throw new Error(`Signal hooks not configured`);
-    }
-  })(signalHooks) : {};
-  return signalHooks.willSyncFlushWatchers();
-}
-if (macroCondition(getGlobalConfig().WarpDrive.deprecations.DEPRECATE_TRACKING_PACKAGE)) {
-  let hasEmberDataTracking = false;
-  if (macroCondition(dependencySatisfies('@ember-data/tracking', '*'))) {
-    hasEmberDataTracking = true;
-    // @ts-expect-error
-    const {
-      buildSignalConfig
-    } = importSync('@ember-data/tracking');
-    // eslint-disable-next-line @typescript-eslint/no-unsafe-argument
-    setupSignals(buildSignalConfig);
-  }
-  const message = [`Using WarpDrive with EmberJS requires configuring it to use Ember's reactivity system.`, `Previously this was provided by installing the package '@ember-data/tracking', but this package is now deprecated.`, ``, `To resolve this deprecation, follow these steps:`, hasEmberDataTracking ? `- remove "@ember-data/tracking" and (if needed) "@ember-data-types/tracking" from your project in both your package.json and tsconfig.json` : false, `- add "@warp-drive/ember" to your project in both your package.json and tsconfig.json`, '- add the following import to your app.js file:', '', '\t```', `\timport '@warp-drive/ember/install';`, '\t```', ``, '- mark this deprecation as resolved in your project by adding the following to your WarpDrive config in ember-cli-build.js:', '', '\t```', '\tconst { setConfig } = await import("@warp-drive/build-config");', '\tsetConfig(app, __dirname, {', '\t  deprecations: {', '\t    DEPRECATE_TRACKING_PACKAGE: false,', '\t  },', '\t});', '\t```', ``, `For more information, see the Package Unification RFC: https://rfcs.emberjs.com/id/1075-warp-drive-package-unification/`].filter(l => l !== false).join('\n');
-  deprecate(message, false, {
-    id: 'warp-drive.deprecate-tracking-package',
-    until: '6.0.0',
-    for: 'warp-drive',
-    since: {
-      enabled: '5.3.4',
-      available: '4.13'
-    },
-    url: 'https://deprecations.emberjs.com/id/warp-drive.deprecate-tracking-package'
-  });
-}
-export { ARRAY_SIGNAL as A, OBJECT_SIGNAL as O, createSignal as a, consumeSignal as b, createMemo as c, notifySignal as n, setupSignals as s, willSyncFlushWatchers as w };

package/dist/configure-BfLLW6GY.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"configure-BfLLW6GY.js","sources":["../src/-private/new-core-tmp/reactivity/configure.ts"],"sourcesContent":["import { deprecate } from '@ember/debug';\n\nimport { dependencySatisfies, importSync, macroCondition } from '@embroider/macros';\n\nimport { DEPRECATE_TRACKING_PACKAGE } from '@warp-drive/build-config/deprecations';\nimport { assert } from '@warp-drive/build-config/macros';\nimport { getOrSetGlobal, peekTransient, setTransient } from '@warp-drive/core-types/-private';\n\nexport const ARRAY_SIGNAL = getOrSetGlobal('#[]', Symbol('#[]'));\nexport const OBJECT_SIGNAL = getOrSetGlobal('#{}', Symbol('#{}'));\n\n/**\n * Requirements:\n *\n * Signal:\n *\n * - signal: a way of creating a reference that we can dirty when we desire to notify\n *         - @signal: a way of creating an accessor on an object that subscribes to a signal on access\n *                    and notifies the signal on set, or of upgrading a descriptor to be such an accessor\n *         - defineSignal: a way of creating a signal on an object\n *         - notifySignal: a way of notifying the underlying signal that it has been dirtied\n *         - peekSignal: a way of inspecting the signal without notifying it\n *\n *  - gate: a memoized getter function that re-runs when on access if its signal is dirty\n *          conceptually, a gate is a tightly coupled signal and memo\n *         - @gate: a way of creating a gate on an object or upgrading a descriptor with a getter\n *                  to be a gate\n *         - defineGate: a way of creating a gate on an object\n *         - notifySignal: a way of notifying the signal for a gate that it has been dirtied\n *\n * - memo:\n *        - @memo: a way of creating a memoized getter on an object or upgrading a descriptor with a getter\n *                 to be a memo\n *        - defineMemo: a way of creating a memo on an object\n *\n * - signalStore: storage bucket for signals associated to an object\n *        - withSignalStore: a way of pre-creating a signal store on an object\n *\n *\n * @internal\n */\n\n/**\n * An Opaque type that represents a framework specific or TC39 signal.\n *\n * It may be an array of signals or a single signal.\n *\n * @internal\n */\nexport type SignalRef = unknown;\n/**\n * The hooks which MUST be configured in order to use this library,\n * either for framework specfic signals or TC39 signals.\n *\n * Support for multiple frameworks simultaneously can be done via\n * this abstraction by returning multiple signals from the `createSignal`\n * method, and consuming the correct one via the correct framework via\n * the `consumeSignal` and `notifySignal` methods.\n *\n * @typedoc\n */\nexport interface SignalHooks<T = SignalRef> {\n  createSignal: (obj: object, key: string | symbol) => T;\n  consumeSignal: (signal: T) => void;\n  notifySignal: (signal: T) => void;\n  createMemo: <F>(obj: object, key: string | symbol, fn: () => F) => () => F;\n  willSyncFlushWatchers: () => boolean;\n}\n\nexport interface HooksOptions {\n  wellknown: {\n    Array: symbol | string;\n  };\n}\n\n/**\n * The public API for configuring the signal hooks.\n *\n * @internal\n */\nexport function setupSignals<T>(buildConfig: (options: HooksOptions) => SignalHooks<T>) {\n  // We want to assert this but can't because too many package manager\n  // and bundler bugs exist that cause this to be called multiple times\n  // for what should be a single call.\n  // assert(`Cannot override configured signal hooks`, peekTransient('signalHooks') === null);\n  const hooks = buildConfig({\n    wellknown: {\n      Array: ARRAY_SIGNAL,\n    },\n  });\n  setTransient('signalHooks', hooks);\n}\n\n/**\n * Internal method for consuming the configured `createSignal` hook\n *\n * @internal\n */\nexport function createSignal(obj: object, key: string | symbol): SignalRef {\n  const signalHooks: SignalHooks | null = peekTransient('signalHooks');\n  assert(`Signal hooks not configured`, signalHooks);\n  return signalHooks.createSignal(obj, key);\n}\n\n/**\n * Internal method for consuming the configured `consumeSignal` hook\n *\n * @internal\n */\nexport function consumeSignal(signal: SignalRef) {\n  const signalHooks: SignalHooks | null = peekTransient('signalHooks');\n\n  assert(`Signal hooks not configured`, signalHooks);\n  return signalHooks.consumeSignal(signal);\n}\n\n/**\n * Internal method for consuming the configured `notifySignal` hook\n *\n * @internal\n */\nexport function notifySignal(signal: SignalRef) {\n  const signalHooks: SignalHooks | null = peekTransient('signalHooks');\n  assert(`Signal hooks not configured`, signalHooks);\n  return signalHooks.notifySignal(signal);\n}\n\nexport function createMemo<T>(object: object, key: string | symbol, fn: () => T): () => T {\n  const signalHooks: SignalHooks | null = peekTransient('signalHooks');\n  assert(`Signal hooks not configured`, signalHooks);\n  return signalHooks.createMemo(object, key, fn);\n}\n\nexport function willSyncFlushWatchers(): boolean {\n  const signalHooks: SignalHooks | null = peekTransient('signalHooks');\n  assert(`Signal hooks not configured`, signalHooks);\n  return signalHooks.willSyncFlushWatchers();\n}\n\nif (DEPRECATE_TRACKING_PACKAGE) {\n  let hasEmberDataTracking = false;\n  if (macroCondition(dependencySatisfies('@ember-data/tracking', '*'))) {\n    hasEmberDataTracking = true;\n    // @ts-expect-error\n    const { buildSignalConfig } = importSync('@ember-data/tracking');\n    // eslint-disable-next-line @typescript-eslint/no-unsafe-argument\n    setupSignals(buildSignalConfig);\n  }\n\n  const message = [\n    `Using WarpDrive with EmberJS requires configuring it to use Ember's reactivity system.`,\n    `Previously this was provided by installing the package '@ember-data/tracking', but this package is now deprecated.`,\n    ``,\n    `To resolve this deprecation, follow these steps:`,\n    hasEmberDataTracking\n      ? `- remove \"@ember-data/tracking\" and (if needed) \"@ember-data-types/tracking\" from your project in both your package.json and tsconfig.json`\n      : false,\n    `- add \"@warp-drive/ember\" to your project in both your package.json and tsconfig.json`,\n    '- add the following import to your app.js file:',\n    '',\n    '\\t```',\n    `\\timport '@warp-drive/ember/install';`,\n    '\\t```',\n    ``,\n    '- mark this deprecation as resolved in your project by adding the following to your WarpDrive config in ember-cli-build.js:',\n    '',\n    '\\t```',\n    '\\tconst { setConfig } = await import(\"@warp-drive/build-config\");',\n    '\\tsetConfig(app, __dirname, {',\n    '\\t  deprecations: {',\n    '\\t    DEPRECATE_TRACKING_PACKAGE: false,',\n    '\\t  },',\n    '\\t});',\n    '\\t```',\n    ``,\n    `For more information, see the Package Unification RFC: https://rfcs.emberjs.com/id/1075-warp-drive-package-unification/`,\n  ]\n    .filter((l) => l !== false)\n    .join('\\n');\n\n  deprecate(message, false, {\n    id: 'warp-drive.deprecate-tracking-package',\n    until: '6.0.0',\n    for: 'warp-drive',\n    since: {\n      enabled: '5.3.4',\n      available: '4.13',\n    },\n    url: 'https://deprecations.emberjs.com/id/warp-drive.deprecate-tracking-package',\n  });\n}\n"],"names":["ARRAY_SIGNAL","getOrSetGlobal","Symbol","OBJECT_SIGNAL","setupSignals","buildConfig","hooks","wellknown","Array","setTransient","createSignal","obj","key","signalHooks","peekTransient","macroCondition","getGlobalConfig","WarpDrive","env","DEBUG","test","Error","consumeSignal","signal","notifySignal","createMemo","object","fn","willSyncFlushWatchers","deprecations","DEPRECATE_TRACKING_PACKAGE","hasEmberDataTracking","dependencySatisfies","buildSignalConfig","importSync","message","filter","l","join","deprecate","id","until","for","since","enabled","available","url"],"mappings":"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"}