@warp-drive/legacy 5.8.0-alpha.4 → 5.8.0-alpha.6

package/README.md

@@ -19,7 +19,7 @@
 [![Docs](./logos/docs-badge.svg)](https://docs.warp-drive.io)
 [![EmberJS Discord Community Server](https://img.shields.io/badge/EmberJS-grey?logo=discord&logoColor=FFC474)](https://discord.gg/zT3asNS
 )
-[![WarpDrive Discord Server](https://img.shields.io/badge/WarpDrive-grey?logo=discord&logoColor=FFC474)](https://discord.gg/n8BptgFzNt
+[![WarpDrive Discord Server](https://img.shields.io/badge/WarpDrive-grey?logo=discord&logoColor=FFC474)](https://discord.gg/PHBbnWJx5S
 )
 
 

package/declarations/adapter/json-api.d.ts

@@ -8,13 +8,11 @@ import { RESTAdapter } from "./rest.js";
 /**
 ## Overview
 
-<blockquote style="margin: 1em; padding: .1em 1em .1em 1em; border-left: solid 1em #E34C32; background: #e0e0e0;">
-<p>
-⚠️ <strong>This is LEGACY documentation</strong> for a feature that is no longer encouraged to be used.
+:::danger
+⚠️ **This is LEGACY documentation** for a feature that is no longer encouraged to be used.
 If starting a new app or thinking of implementing a new adapter, consider writing a
-<a href="/ember-data/release/classes/%3CInterface%3E%20Handler">Handler</a> instead to be used with the <a href="https://github.com/warp-drive-data/warp-drive/tree/main/packages/request#readme">RequestManager</a>
-</p>
-</blockquote>
+{@link Handler} instead to be used with the {@link RequestManager}
+:::
 
 The `JSONAPIAdapter` is an adapter whichtransforms the store's
 requests into HTTP requests that follow the [JSON API format](http://jsonapi.org/format/).

package/declarations/adapter/rest.d.ts

@@ -31,13 +31,11 @@ export type RequestData = {
 };
 declare const AdapterWithBuildURLMixin: Readonly<typeof Adapter> & (new (owner?: Owner) => Adapter) & Mixin;
 /**
-* <blockquote style="margin: 1em; padding: .1em 1em .1em 1em; border-left: solid 1em #E34C32; background: #e0e0e0;">
-<p>
-⚠️ <strong>This is LEGACY documentation</strong> for a feature that is no longer encouraged to be used.
+* :::danger
+⚠️ **This is LEGACY documentation** for a feature that is no longer encouraged to be used.
 If starting a new app or thinking of implementing a new adapter, consider writing a
-<a href="/ember-data/release/classes/%3CInterface%3E%20Handler">Handler</a> instead to be used with the <a href="https://github.com/warp-drive-data/warp-drive/tree/main/packages/request#readme">RequestManager</a>
-</p>
-</blockquote>
+{@link Handler} instead to be used with the {@link RequestManager}
+:::
 
 The REST adapter allows your store to communicate with an HTTP server by
 transmitting JSON via XHR.
@@ -406,8 +404,7 @@ declare class RESTAdapter extends AdapterWithBuildURLMixin {
 	Some APIs require HTTP headers, e.g. to provide an API
 	key. Arbitrary headers can be set as key/value pairs on the
 	`RESTAdapter`'s `headers` object and Ember Data will send them
-	along with each ajax request. For dynamic headers see [headers
-	customization](/ember-data/release/classes/RESTAdapter).
+	along with each ajax request..
 	
 	```js [app/adapters/application.js]
 	import { RESTAdapter } from '@warp-drive/legacy/adapter/rest';

package/declarations/adapter.d.ts

@@ -1,13 +1,11 @@
 /**
 * ## Overview
 *
-* <blockquote style="margin: 1em; padding: .1em 1em .1em 1em; border-left: solid 1em #E34C32; background: #e0e0e0;">
-* <p>
-*   ⚠️ <strong>This is LEGACY documentation</strong> for a feature that is no longer encouraged to be used.
+* :::danger
+*   ⚠️ **This is LEGACY documentation** for a feature that is no longer encouraged to be used.
 *   If starting a new app or thinking of implementing a new adapter, consider writing a
-*   <a href="/ember-data/release/classes/%3CInterface%3E%20Handler">Handler</a> instead to be used with the <a href="https://github.com/warp-drive-data/warp-drive/tree/main/packages/request#readme">RequestManager</a>
-* </p>
-* </blockquote>
+*   {@link Handler} instead to be used with the {@link RequestManager}
+* ::::
 *
 * In order to properly fetch and update data, @warp-drive/legacy
 * needs to understand how to connect to your API.

package/declarations/compat/legacy-network-handler/minimum-adapter-interface.d.ts

@@ -7,13 +7,11 @@ import type { SnapshotRecordArray } from "./snapshot-record-array.js";
 type Group = Snapshot[];
 export type AdapterPayload = Record<string, unknown> | unknown[];
 /**
-* <blockquote style="margin: 1em; padding: .1em 1em .1em 1em; border-left: solid 1em #E34C32; background: #e0e0e0;">
-<p>
-⚠️ <strong>This is LEGACY documentation</strong> for a feature that is no longer encouraged to be used.
+* :::danger
+⚠️ **This is LEGACY documentation** for a feature that is no longer encouraged to be used.
 If starting a new app or thinking of implementing a new adapter, consider writing a
-<a href="/ember-data/release/classes/%3CInterface%3E%20Handler">Handler</a> instead to be used with the <a href="https://github.com/warp-drive-data/warp-drive/tree/main/packages/request#readme">RequestManager</a>
-</p>
-</blockquote>
+{@link Handler} instead to be used with the {@link RequestManager}
+:::
 
 The following documentation describes the methods an
 adapter should implement with descriptions around when an

package/declarations/compat/legacy-network-handler/minimum-serializer-interface.d.ts

@@ -9,13 +9,11 @@ export type SerializerOptions = {
 };
 export type RequestType = "findRecord" | "queryRecord" | "findAll" | "findBelongsTo" | "findHasMany" | "findMany" | "query" | "createRecord" | "deleteRecord" | "updateRecord";
 /**
-* <blockquote style="margin: 1em; padding: .1em 1em .1em 1em; border-left: solid 1em #E34C32; background: #e0e0e0;">
-<p>
-⚠️ <strong>This is LEGACY documentation</strong> for a feature that is no longer encouraged to be used.
+* :::danger
+⚠️ **This is LEGACY documentation** for a feature that is no longer encouraged to be used.
 If starting a new app or thinking of implementing a new adapter, consider writing a
-<a href="/ember-data/release/classes/%3CInterface%3E%20Handler">Handler</a> instead to be used with the <a href="https://github.com/warp-drive-data/warp-drive/tree/main/packages/request#readme">RequestManager</a>
-</p>
-</blockquote>
+{@link Handler} instead to be used with the {@link RequestManager}
+:::
 
 The following documentation describes the methods an application
 serializer should implement with descriptions around when an

package/declarations/compat.d.ts

@@ -32,8 +32,7 @@ for an `application` adapter (the default adapter for
 your entire application).
 
 @public
-@param {String} modelName
-@return {Adapter}
+@param modelName
 */
 export declare function adapterFor(this: Store, modelName: string): MinimumAdapterInterface;
 export declare function adapterFor(this: Store, modelName: string, _allowMissing: true): MinimumAdapterInterface | undefined;
@@ -50,8 +49,7 @@ If a serializer cannot be found on the adapter, it will fall back
 to an instance of `JSONSerializer`.
 
 @public
-@param {String} modelName the record to serialize
-@return {Serializer}
+@param modelName the record to serialize
 */
 export declare function serializerFor(this: Store, modelName: string): MinimumSerializerInterface | null;
 /**
@@ -125,8 +123,8 @@ store.pushPayload('post', pushData); // Will use the post serializer
 ```
 
 @public
-@param {String} modelName Optionally, a model type used to determine which serializer will be used
-@param {Object} inputPayload
+@param modelName Optionally, a model type used to determine which serializer will be used
+@param inputPayload
 */
 export declare function pushPayload(this: Store, modelName: string, inputPayload: ObjectValue): void;
 export declare function serializeRecord(this: Store, record: unknown, options?: SerializerOptions): unknown;

package/declarations/model/-private/attr.d.ts

@@ -75,12 +75,12 @@ export type OptionsFromInstance<T> = TypeFromInstance<T> extends never ? never :
 */
 export type DataDecorator = (target: object, key: string, desc?: DecoratorPropertyDescriptor) => void;
 /**
-`attr` defines an attribute on a [Model](/ember-data/release/classes/Model).
+`attr` defines an attribute on a {@link Model}.
 By default, attributes are passed through as-is, however you can specify an
 optional type to have the value automatically transformed.
 EmberData ships with four basic transform types: `string`, `number`,
 `boolean` and `date`. You can define your own transforms by subclassing
-[Transform](/ember-data/release/classes/Transform).
+{@link Transform}.
 
 Note that you cannot use `attr` to define an attribute of `id`.
 
@@ -157,9 +157,8 @@ return new this();
 ```
 
 @public
-@param {String|Object} type the attribute type
-@param {Object} options a hash of options
-@return {Attribute}
+@param type the attribute type
+@param options a hash of options
 */
 export declare function attr(): DataDecorator;
 export declare function attr<T>(type: TypeFromInstance<T>): DataDecorator;

package/declarations/model/-private/belongs-to.d.ts

@@ -15,7 +15,7 @@ export type NoNull<T> = Exclude<T, null>;
 export type RelationshipDecorator<T> = <This>(target: This, key: string, desc?: PropertyDescriptor) => void;
 /**
 `belongsTo` is used to define One-To-One and One-To-Many, and One-To-None
-relationships on a [Model](/ember-data/release/classes/Model).
+relationships on a {@link Model}.
 
 `belongsTo` takes a configuration hash as a second parameter, currently
 supported options are:
@@ -165,9 +165,8 @@ must be declared as polymorphic, and the `as` option must be used to declare the
 type each record satisfies on both sides.
 
 @public
-@param {String} type (optional) the name of the related resource
-@param {Object} options (optional) a hash of options
-@return {PropertyDescriptor} relationship
+@param type the name of the related resource
+@param options a hash of options
 */
 export declare function belongsTo(): never;
 export declare function belongsTo(type: string): never;

package/declarations/model/-private/has-many.d.ts

@@ -2,7 +2,7 @@ import type { TypeFromInstance } from "@warp-drive/core/types/record";
 import type { NoNull, RelationshipDecorator, RelationshipOptions } from "./belongs-to.js";
 /**
 `hasMany` is used to define Many-To-One and Many-To-Many, and Many-To-None
-relationships on a [Model](/ember-data/release/classes/Model).
+relationships on a {@link Model}.
 
 `hasMany` takes a configuration hash as a second parameter, currently
 supported options are:
@@ -153,9 +153,8 @@ must be declared as polymorphic, and the `as` option must be used to declare the
 type each record satisfies on both sides.
 
 @public
-@param {String} type (optional) the name of the related resource
-@param {Object} options (optional) a hash of options
-@return {PropertyDescriptor} relationship
+@param type the name of the related resource
+@param options a hash of options
 */
 export declare function hasMany(): never;
 export declare function hasMany(type: string): never;

package/declarations/model/-private/hooks.d.ts

@@ -2,7 +2,7 @@ import { type Store } from "@warp-drive/core/store/-private";
 import type { ResourceKey } from "@warp-drive/core/types/identifier";
 import type { TypeFromInstance } from "@warp-drive/core/types/record";
 import type { Model } from "./model.js";
-export declare function instantiateRecord(this: Store, identifier: ResourceKey, createRecordArgs: {
+export declare function instantiateRecord(this: Store, identifier: ResourceKey, createRecordArgs?: {
 	[key: string]: unknown;
 }): Model;
 export declare function teardownRecord(record: Model): void;

package/declarations/model/migration-support.d.ts

@@ -207,8 +207,6 @@ export interface DelegatingSchemaService {
 	doesTypeExist?(type: string): boolean;
 }
 export declare class DelegatingSchemaService implements SchemaService {
-	_preferred: SchemaService;
-	_secondary: SchemaService;
 	constructor(store: Store, schema: SchemaService);
 	isDelegated(resource: ResourceKey | {
 		type: string;
@@ -252,4 +250,8 @@ export declare class DelegatingSchemaService implements SchemaService {
 	CAUTION_MEGA_DANGER_ZONE_objectExtensions(field: ExtensibleField, resolvedType: string | null): null | ProcessedExtension["features"];
 	CAUTION_MEGA_DANGER_ZONE_arrayExtensions(field: ExtensibleField): null | ProcessedExtension["features"];
 }
+export interface PrivateDelegatingSchemaService extends DelegatingSchemaService {
+	_preferred: SchemaService;
+	_secondary: SchemaService;
+}
 export {};

package/declarations/serializer/-private/embedded-records-mixin.d.ts

@@ -85,11 +85,6 @@ instances must have an `id` property to be used with Ember Data.
 are. Please read the docs for the methods this mixin provides, in case you need
 to modify it to fit your specific needs.**
 
-For example, review the docs for each method of this mixin:
-* [normalize](/ember-data/release/classes/EmbeddedRecordsMixin/methods/normalize?anchor=normalize)
-* [serializeBelongsTo](/ember-data/release/classes/EmbeddedRecordsMixin/methods/serializeBelongsTo?anchor=serializeBelongsTo)
-* [serializeHasMany](/ember-data/release/classes/EmbeddedRecordsMixin/methods/serializeHasMany?anchor=serializeHasMany)
-
 @class EmbeddedRecordsMixin
 @public
 */

package/declarations/serializer/-private/transforms/boolean.d.ts

@@ -5,8 +5,8 @@ export interface BooleanTransform {
 /**
 The `BooleanTransform` class is used to serialize and deserialize
 boolean attributes on Ember Data record objects. This transform is
-used when `boolean` is passed as the type parameter to the
-[attr](/ember-data/release/functions/@ember-data%2Fmodel/attr) function.
+used when `'boolean'` is passed as the type parameter to the
+{@link attr}function.
 
 Usage
 

package/declarations/serializer/-private/transforms/date.d.ts

@@ -5,8 +5,8 @@ export interface DateTransform {
 /**
 The `DateTransform` class is used to serialize and deserialize
 date attributes on Ember Data record objects. This transform is used
-when `date` is passed as the type parameter to the
-[attr](/ember-data/release/functions/@ember-data%2Fmodel/attr) function. It uses the [`ISO 8601`](https://en.wikipedia.org/wiki/ISO_8601)
+when `'date'` is passed as the type parameter to the
+{@link attr} function. It uses the [`ISO 8601`](https://en.wikipedia.org/wiki/ISO_8601)
 standard.
 
 ```js [app/models/score.js]

package/declarations/serializer/-private/transforms/number.d.ts

@@ -6,7 +6,7 @@ export interface NumberTransform {
 The `NumberTransform` class is used to serialize and deserialize
 numeric attributes on Ember Data record objects. This transform is
 used when `number` is passed as the type parameter to the
-[attr](/ember-data/release/functions/@ember-data%2Fmodel/attr) function.
+{@link attr} function.
 
 Usage
 

package/declarations/serializer/-private/transforms/string.d.ts

@@ -6,7 +6,7 @@ export interface StringTransform {
 The `StringTransform` class is used to serialize and deserialize
 string attributes on Ember Data record objects. This transform is
 used when `string` is passed as the type parameter to the
-[attr](/ember-data/release/functions/@ember-data%2Fmodel/attr) function.
+{@link attr} function.
 
 Usage
 

package/declarations/serializer/json-api.d.ts

@@ -1,11 +1,9 @@
 /**
-* <blockquote style="margin: 1em; padding: .1em 1em .1em 1em; border-left: solid 1em #E34C32; background: #e0e0e0;">
-<p>
+* :::danger
 ⚠️ <strong>This is LEGACY documentation</strong> for a feature that is no longer encouraged to be used.
 If starting a new app or thinking of implementing a new adapter, consider writing a
-<a href="/ember-data/release/classes/%3CInterface%3E%20Handler">Handler</a> instead to be used with the <a href="https://github.com/warp-drive-data/warp-drive/tree/main/packages/request#readme">RequestManager</a>
-</p>
-</blockquote>
+{@link Handler} instead to be used with the {@link RequestManager}
+:::
 
 In EmberData a Serializer is used to serialize and deserialize
 records when they are transferred in and out of an external source.

package/declarations/serializer/json.d.ts

@@ -1,11 +1,9 @@
 /**
-* <blockquote style="margin: 1em; padding: .1em 1em .1em 1em; border-left: solid 1em #E34C32; background: #e0e0e0;">
-<p>
-⚠️ <strong>This is LEGACY documentation</strong> for a feature that is no longer encouraged to be used.
+* :::danger
+⚠️ **This is LEGACY documentation** for a feature that is no longer encouraged to be used.
 If starting a new app or thinking of implementing a new adapter, consider writing a
-<a href="/ember-data/release/classes/%3CInterface%3E%20Handler">Handler</a> instead to be used with the <a href="https://github.com/warp-drive-data/warp-drive/tree/main/packages/request#readme">RequestManager</a>
-</p>
-</blockquote>
+{@link Handler} instead to be used with the {@link RequestManager}
+:::
 
 In EmberData a Serializer is used to serialize and deserialize
 records when they are transferred in and out of an external source.

package/declarations/serializer/rest.d.ts

@@ -1,11 +1,9 @@
 /**
-* <blockquote style="margin: 1em; padding: .1em 1em .1em 1em; border-left: solid 1em #E34C32; background: #e0e0e0;">
-<p>
-⚠️ <strong>This is LEGACY documentation</strong> for a feature that is no longer encouraged to be used.
+* :::danger
+⚠️ **This is LEGACY documentation** for a feature that is no longer encouraged to be used.
 If starting a new app or thinking of implementing a new adapter, consider writing a
-<a href="/ember-data/release/classes/%3CInterface%3E%20Handler">Handler</a> instead to be used with the <a href="https://github.com/warp-drive-data/warp-drive/tree/main/packages/request#readme">RequestManager</a>
-</p>
-</blockquote>
+{@link Handler} instead to be used with the {@link RequestManager}
+:::
 
 Normally, applications will use the `RESTSerializer` by implementing
 the `normalize` method.

package/declarations/serializer.d.ts

@@ -1,13 +1,11 @@
 /**
 ## Overview
 
-<blockquote style="margin: 1em; padding: .1em 1em .1em 1em; border-left: solid 1em #E34C32; background: #e0e0e0;">
-<p>
-⚠️ <strong>This is LEGACY documentation</strong> for a feature that is no longer encouraged to be used.
+:::danger
+⚠️ **This is LEGACY documentation** for a feature that is no longer encouraged to be used.
 If starting a new app or thinking of implementing a new serializer, consider writing a
-<a href="/ember-data/release/classes/%3CInterface%3E%20Handler">Handler</a> instead to be used with the <a href="https://github.com/warp-drive-data/warp-drive/tree/main/packages/request#readme">RequestManager</a>
-</p>
-</blockquote>
+{@link Handler} instead to be used with the {@link RequestManager}
+:::
 
 In order to properly manage and present your data, WarpDrive
 needs to understand the structure of data it receives.

package/dist/adapter/error.js

@@ -3,17 +3,16 @@ import { macroCondition, getGlobalConfig } from '@embroider/macros';
 
 /* eslint-disable @typescript-eslint/no-unsafe-assignment */
 /* eslint-disable @typescript-eslint/no-unsafe-member-access */
+// eslint-disable-next-line @typescript-eslint/no-unused-vars
 
 /**
   ## Overview
 
-  <blockquote style="margin: 1em; padding: .1em 1em .1em 1em; border-left: solid 1em #E34C32; background: #e0e0e0;">
-  <p>
-    ⚠️ <strong>This is LEGACY documentation</strong> for a feature that is no longer encouraged to be used.
+  :::danger
+    ⚠️ **This is LEGACY documentation** for a feature that is no longer encouraged to be used.
     If starting a new app or thinking of implementing a new adapter, consider writing a
-    <a href="/ember-data/release/classes/%3CInterface%3E%20Handler">Handler</a> instead to be used with the <a href="https://github.com/warp-drive-data/warp-drive/tree/main/packages/request#readme">RequestManager</a>
-  </p>
-  </blockquote>
+    {@link Handler} instead to be used with the {@link RequestManager}
+  :::
 
   An `AdapterError` is used by an adapter to signal that an error occurred
   during a request to an external API. It indicates a generic error, and

package/dist/adapter/json-api.js

@@ -3,6 +3,9 @@ import '@ember/debug';
 import { macroCondition, getGlobalConfig } from '@embroider/macros';
 import { b as serializeIntoHash } from "../serialize-into-hash-CS0MIv4F.js";
 import { RESTAdapter } from './rest.js';
+
+// eslint-disable-next-line @typescript-eslint/no-unused-vars
+
 class JSONAPIAdapter extends RESTAdapter {
   _defaultContentType = 'application/vnd.api+json';
 

package/dist/adapter/rest.js

@@ -14,13 +14,11 @@ import { d as decorateMethodV2 } from "../runtime-BPCpkOf1-BKOwiRJp.js";
 const AdapterWithBuildURLMixin = Adapter.extend(BuildURLMixin);
 
 /**
- * <blockquote style="margin: 1em; padding: .1em 1em .1em 1em; border-left: solid 1em #E34C32; background: #e0e0e0;">
-  <p>
-    ⚠️ <strong>This is LEGACY documentation</strong> for a feature that is no longer encouraged to be used.
+ * :::danger
+    ⚠️ **This is LEGACY documentation** for a feature that is no longer encouraged to be used.
     If starting a new app or thinking of implementing a new adapter, consider writing a
-    <a href="/ember-data/release/classes/%3CInterface%3E%20Handler">Handler</a> instead to be used with the <a href="https://github.com/warp-drive-data/warp-drive/tree/main/packages/request#readme">RequestManager</a>
-  </p>
-  </blockquote>
+    {@link Handler} instead to be used with the {@link RequestManager}
+  :::
 
   The REST adapter allows your store to communicate with an HTTP server by
   transmitting JSON via XHR.
@@ -392,8 +390,7 @@ class RESTAdapter extends AdapterWithBuildURLMixin {
     Some APIs require HTTP headers, e.g. to provide an API
     key. Arbitrary headers can be set as key/value pairs on the
     `RESTAdapter`'s `headers` object and Ember Data will send them
-    along with each ajax request. For dynamic headers see [headers
-    customization](/ember-data/release/classes/RESTAdapter).
+    along with each ajax request..
      ```js [app/adapters/application.js]
     import { RESTAdapter } from '@warp-drive/legacy/adapter/rest';
      export default class ApplicationAdapter extends RESTAdapter {

package/dist/adapter.js

@@ -496,13 +496,11 @@ const BuildURLMixin = Mixin.create(mixinProps);
 /**
  * ## Overview
  *
- * <blockquote style="margin: 1em; padding: .1em 1em .1em 1em; border-left: solid 1em #E34C32; background: #e0e0e0;">
- * <p>
- *   ⚠️ <strong>This is LEGACY documentation</strong> for a feature that is no longer encouraged to be used.
+ * :::danger
+ *   ⚠️ **This is LEGACY documentation** for a feature that is no longer encouraged to be used.
  *   If starting a new app or thinking of implementing a new adapter, consider writing a
- *   <a href="/ember-data/release/classes/%3CInterface%3E%20Handler">Handler</a> instead to be used with the <a href="https://github.com/warp-drive-data/warp-drive/tree/main/packages/request#readme">RequestManager</a>
- * </p>
- * </blockquote>
+ *   {@link Handler} instead to be used with the {@link RequestManager}
+ * ::::
  *
  * In order to properly fetch and update data, @warp-drive/legacy
  * needs to understand how to connect to your API.

package/dist/compat.js

@@ -737,18 +737,17 @@ function queryRecord(context) {
 }
 
 /**
-    Returns an instance of the adapter for a given type. For
-    example, `adapterFor('person')` will return an instance of
-    the adapter located at `app/adapters/person.js`
+  Returns an instance of the adapter for a given type. For
+  example, `adapterFor('person')` will return an instance of
+  the adapter located at `app/adapters/person.js`
 
-    If no `person` adapter is found, this method will look
-    for an `application` adapter (the default adapter for
-    your entire application).
+  If no `person` adapter is found, this method will look
+  for an `application` adapter (the default adapter for
+  your entire application).
 
-    @public
-    @param {String} modelName
-    @return {Adapter}
-  */
+  @public
+  @param modelName
+*/
 
 function adapterFor(modelName, _allowMissing) {
   macroCondition(getGlobalConfig().WarpDrive.env.DEBUG) ? (test => {
@@ -799,20 +798,19 @@ function adapterFor(modelName, _allowMissing) {
 }
 
 /**
-    Returns an instance of the serializer for a given type. For
-    example, `serializerFor('person')` will return an instance of
-    `App.PersonSerializer`.
+  Returns an instance of the serializer for a given type. For
+  example, `serializerFor('person')` will return an instance of
+  `App.PersonSerializer`.
 
-    If no `App.PersonSerializer` is found, this method will look
-    for an `App.ApplicationSerializer` (the default serializer for
-    your entire application).
+  If no `App.PersonSerializer` is found, this method will look
+  for an `App.ApplicationSerializer` (the default serializer for
+  your entire application).
 
-    If a serializer cannot be found on the adapter, it will fall back
-    to an instance of `JSONSerializer`.
+  If a serializer cannot be found on the adapter, it will fall back
+  to an instance of `JSONSerializer`.
 
-    @public
-    @param {String} modelName the record to serialize
-    @return {Serializer}
+  @public
+  @param modelName the record to serialize
   */
 function serializerFor(modelName) {
   macroCondition(getGlobalConfig().WarpDrive.env.DEBUG) ? (test => {
@@ -859,23 +857,23 @@ function serializerFor(modelName) {
 }
 
 /**
-    `normalize` converts a json payload into the normalized form that
-    [push](../methods/push?anchor=push) expects.
+  `normalize` converts a json payload into the normalized form that
+  [push](../methods/push?anchor=push) expects.
 
-    Example
+  Example
 
-    ```js
-    socket.on('message', function(message) {
-      let modelName = message.model;
-      let data = message.data;
-      store.push(store.normalize(modelName, data));
-    });
-    ```
+  ```js
+  socket.on('message', function(message) {
+    let modelName = message.model;
+    let data = message.data;
+    store.push(store.normalize(modelName, data));
+  });
+  ```
 
-    @public
-    @param modelName The name of the model type for this payload
-    @return The normalized payload
-  */
+  @public
+  @param modelName The name of the model type for this payload
+  @return The normalized payload
+*/
 // TODO @runspired @deprecate users should call normalize on the associated serializer directly
 function normalize(modelName, payload) {
   macroCondition(getGlobalConfig().WarpDrive.env.DEBUG) ? (test => {
@@ -956,8 +954,8 @@ function normalize(modelName, payload) {
     ```
 
     @public
-    @param {String} modelName Optionally, a model type used to determine which serializer will be used
-    @param {Object} inputPayload
+    @param modelName Optionally, a model type used to determine which serializer will be used
+    @param inputPayload
   */
 // TODO @runspired @deprecate pushPayload in favor of looking up the serializer
 function pushPayload(modelName, inputPayload) {

package/dist/{json-DziiodPf.js → json-LVAukAjN.js}

@@ -25,13 +25,11 @@ const SOURCE_POINTER_PRIMARY_REGEXP = /^\/?data/;
 const PRIMARY_ATTRIBUTE_KEY = 'base';
 
 /**
- * <blockquote style="margin: 1em; padding: .1em 1em .1em 1em; border-left: solid 1em #E34C32; background: #e0e0e0;">
-  <p>
-    ⚠️ <strong>This is LEGACY documentation</strong> for a feature that is no longer encouraged to be used.
+ * :::danger
+    ⚠️ **This is LEGACY documentation** for a feature that is no longer encouraged to be used.
     If starting a new app or thinking of implementing a new adapter, consider writing a
-    <a href="/ember-data/release/classes/%3CInterface%3E%20Handler">Handler</a> instead to be used with the <a href="https://github.com/warp-drive-data/warp-drive/tree/main/packages/request#readme">RequestManager</a>
-  </p>
-  </blockquote>
+    {@link Handler} instead to be used with the {@link RequestManager}
+  :::
 
   In EmberData a Serializer is used to serialize and deserialize
   records when they are transferred in and out of an external source.

package/dist/model/migration-support.js

@@ -417,7 +417,9 @@ function registerDerivations(schema) {
  */
 
 class DelegatingSchemaService {
+  /** @internal */
   _preferred;
+  /** @internal */
   _secondary;
   constructor(store, schema) {
     this._preferred = schema;

package/dist/model.js

@@ -87,12 +87,12 @@ function _attr(type, options) {
  */
 
 /**
-  `attr` defines an attribute on a [Model](/ember-data/release/classes/Model).
+  `attr` defines an attribute on a {@link Model}.
   By default, attributes are passed through as-is, however you can specify an
   optional type to have the value automatically transformed.
   EmberData ships with four basic transform types: `string`, `number`,
   `boolean` and `date`. You can define your own transforms by subclassing
-  [Transform](/ember-data/release/classes/Transform).
+  {@link Transform}.
 
   Note that you cannot use `attr` to define an attribute of `id`.
 
@@ -169,9 +169,8 @@ function _attr(type, options) {
   ```
 
   @public
-  @param {String|Object} type the attribute type
-  @param {Object} options a hash of options
-  @return {Attribute}
+  @param type the attribute type
+  @param options a hash of options
 */
 
 // see note on DataDecorator for why void
@@ -258,7 +257,7 @@ function _belongsTo(type, options) {
 
 /**
   `belongsTo` is used to define One-To-One and One-To-Many, and One-To-None
-  relationships on a [Model](/ember-data/release/classes/Model).
+  relationships on a {@link Model}.
 
   `belongsTo` takes a configuration hash as a second parameter, currently
   supported options are:
@@ -408,9 +407,8 @@ function _belongsTo(type, options) {
   type each record satisfies on both sides.
 
   @public
-  @param {String} type (optional) the name of the related resource
-  @param {Object} options (optional) a hash of options
-  @return {PropertyDescriptor} relationship
+  @param type the name of the related resource
+  @param options a hash of options
 */
 
 // export function belongsTo<K extends Promise<unknown>, T extends Awaited<K> = Awaited<K>>(
@@ -497,7 +495,7 @@ function _hasMany(type, options) {
 
 /**
   `hasMany` is used to define Many-To-One and Many-To-Many, and Many-To-None
-  relationships on a [Model](/ember-data/release/classes/Model).
+  relationships on a {@link Model}.
 
   `hasMany` takes a configuration hash as a second parameter, currently
   supported options are:
@@ -648,9 +646,8 @@ function _hasMany(type, options) {
   type each record satisfies on both sides.
 
   @public
-  @param {String} type (optional) the name of the related resource
-  @param {Object} options (optional) a hash of options
-  @return {PropertyDescriptor} relationship
+  @param type the name of the related resource
+  @param options a hash of options
 */
 
 // export function hasMany<K extends Promise<unknown>, T extends Awaited<K> = Awaited<K>>(
@@ -673,7 +670,7 @@ function instantiateRecord(identifier, createRecordArgs) {
 
   // TODO deprecate allowing unknown args setting
   const createOptions = {
-    _createProps: createRecordArgs,
+    _createProps: createRecordArgs ?? {},
     // TODO @deprecate consider deprecating accessing record properties during init which the below is necessary for
     _secretInit: {
       identifier,

package/dist/serializer/json-api.js

@@ -1,6 +1,6 @@
 import { warn } from '@ember/debug';
 import { dasherize, pluralize, singularize } from '@warp-drive/utilities/string';
-import { J as JSONSerializer } from "../json-DziiodPf.js";
+import { J as JSONSerializer } from "../json-LVAukAjN.js";
 import { macroCondition, getGlobalConfig } from '@embroider/macros';
 
 /* eslint-disable @typescript-eslint/no-unsafe-return */

package/dist/serializer/json.js

@@ -2,5 +2,5 @@ import '@ember/application';
 import '@ember/debug';
 import '@warp-drive/utilities/string';
 import '../serializer.js';
-export { J as JSONSerializer } from "../json-DziiodPf.js";
+export { J as JSONSerializer } from "../json-LVAukAjN.js";
 import '@embroider/macros';

package/dist/serializer/rest.js

@@ -1,6 +1,6 @@
 import { warn } from '@ember/debug';
 import { camelize, dasherize, singularize } from '@warp-drive/utilities/string';
-import { J as JSONSerializer, c as coerceId } from "../json-DziiodPf.js";
+import { J as JSONSerializer, c as coerceId } from "../json-LVAukAjN.js";
 import { macroCondition, getGlobalConfig } from '@embroider/macros';
 import Mixin from '@ember/object/mixin';
 
@@ -96,11 +96,6 @@ import Mixin from '@ember/object/mixin';
   are. Please read the docs for the methods this mixin provides, in case you need
   to modify it to fit your specific needs.**
 
-  For example, review the docs for each method of this mixin:
-  * [normalize](/ember-data/release/classes/EmbeddedRecordsMixin/methods/normalize?anchor=normalize)
-  * [serializeBelongsTo](/ember-data/release/classes/EmbeddedRecordsMixin/methods/serializeBelongsTo?anchor=serializeBelongsTo)
-  * [serializeHasMany](/ember-data/release/classes/EmbeddedRecordsMixin/methods/serializeHasMany?anchor=serializeHasMany)
-
   @class EmbeddedRecordsMixin
   @public
 */
@@ -583,13 +578,11 @@ function makeArray(value) {
 }
 
 /**
- * <blockquote style="margin: 1em; padding: .1em 1em .1em 1em; border-left: solid 1em #E34C32; background: #e0e0e0;">
-  <p>
-    ⚠️ <strong>This is LEGACY documentation</strong> for a feature that is no longer encouraged to be used.
+ * :::danger
+    ⚠️ **This is LEGACY documentation** for a feature that is no longer encouraged to be used.
     If starting a new app or thinking of implementing a new adapter, consider writing a
-    <a href="/ember-data/release/classes/%3CInterface%3E%20Handler">Handler</a> instead to be used with the <a href="https://github.com/warp-drive-data/warp-drive/tree/main/packages/request#readme">RequestManager</a>
-  </p>
-  </blockquote>
+    {@link Handler} instead to be used with the {@link RequestManager}
+  :::
 
   Normally, applications will use the `RESTSerializer` by implementing
   the `normalize` method.

package/dist/serializer/transform.js

@@ -79,11 +79,13 @@ import EmberObject from '@ember/object';
  */
 const Transform = EmberObject;
 
+// eslint-disable-next-line @typescript-eslint/no-unused-vars
+
 /**
   The `BooleanTransform` class is used to serialize and deserialize
   boolean attributes on Ember Data record objects. This transform is
-  used when `boolean` is passed as the type parameter to the
-  [attr](/ember-data/release/functions/@ember-data%2Fmodel/attr) function.
+  used when `'boolean'` is passed as the type parameter to the
+  {@link attr}function.
 
   Usage
 
@@ -139,11 +141,13 @@ class BooleanTransform {
   }
 }
 
+// eslint-disable-next-line @typescript-eslint/no-unused-vars
+
 /**
  The `DateTransform` class is used to serialize and deserialize
  date attributes on Ember Data record objects. This transform is used
- when `date` is passed as the type parameter to the
- [attr](/ember-data/release/functions/@ember-data%2Fmodel/attr) function. It uses the [`ISO 8601`](https://en.wikipedia.org/wiki/ISO_8601)
+ when `'date'` is passed as the type parameter to the
+ {@link attr} function. It uses the [`ISO 8601`](https://en.wikipedia.org/wiki/ISO_8601)
  standard.
 
  ```js [app/models/score.js]
@@ -190,6 +194,9 @@ class DateTransform {
     return new this();
   }
 }
+
+// eslint-disable-next-line @typescript-eslint/no-unused-vars
+
 function isNumber(value) {
   return value === value && value !== Infinity && value !== -Infinity;
 }
@@ -197,7 +204,7 @@ function isNumber(value) {
   The `NumberTransform` class is used to serialize and deserialize
   numeric attributes on Ember Data record objects. This transform is
   used when `number` is passed as the type parameter to the
-  [attr](/ember-data/release/functions/@ember-data%2Fmodel/attr) function.
+  {@link attr} function.
 
   Usage
 
@@ -235,11 +242,13 @@ class NumberTransform {
   }
 }
 
+// eslint-disable-next-line @typescript-eslint/no-unused-vars
+
 /**
   The `StringTransform` class is used to serialize and deserialize
   string attributes on Ember Data record objects. This transform is
   used when `string` is passed as the type parameter to the
-  [attr](/ember-data/release/functions/@ember-data%2Fmodel/attr) function.
+  {@link attr} function.
 
   Usage
 

package/dist/serializer.js

@@ -5,13 +5,11 @@ import { a as decorateFieldV2, i as initializeDeferredDecorator } from "./runtim
 /**
   ## Overview
 
-  <blockquote style="margin: 1em; padding: .1em 1em .1em 1em; border-left: solid 1em #E34C32; background: #e0e0e0;">
-  <p>
-    ⚠️ <strong>This is LEGACY documentation</strong> for a feature that is no longer encouraged to be used.
+  :::danger
+    ⚠️ **This is LEGACY documentation** for a feature that is no longer encouraged to be used.
     If starting a new app or thinking of implementing a new serializer, consider writing a
-    <a href="/ember-data/release/classes/%3CInterface%3E%20Handler">Handler</a> instead to be used with the <a href="https://github.com/warp-drive-data/warp-drive/tree/main/packages/request#readme">RequestManager</a>
-  </p>
-  </blockquote>
+    {@link Handler} instead to be used with the {@link RequestManager}
+  :::
 
   In order to properly manage and present your data, WarpDrive
   needs to understand the structure of data it receives.
@@ -109,7 +107,6 @@ import { a as decorateFieldV2, i as initializeDeferredDecorator } from "./runtim
 
   @module
 */
-
 const service = s.service ?? s.inject;
 
 /**

package/dist/store.js

@@ -524,6 +524,9 @@ function restoreDeprecatedStoreBehaviors(StoreKlass) {
     });
     return promise.then(document => document.content);
   };
+
+  // do not put a ts-expect-error here, because typedoc will fail to
+  // build due to this error only occurring when references are in use in the editor
   StoreKlass.prototype.getReference = function (resource, id) {
     macroCondition(getGlobalConfig().WarpDrive.env.DEBUG) ? (test => {
       if (!test) {

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@warp-drive/legacy",
-  "version": "5.8.0-alpha.4",
+  "version": "5.8.0-alpha.6",
   "description": "Decommissioned Packages for WarpDrive | Things your app might still want to maintain use of for a little longer.",
   "keywords": [
     "ember-addon"
@@ -32,8 +32,8 @@
     }
   },
   "peerDependencies": {
-    "@warp-drive/core": "5.8.0-alpha.4",
-    "@warp-drive/utilities": "5.8.0-alpha.4"
+    "@warp-drive/core": "5.8.0-alpha.6",
+    "@warp-drive/utilities": "5.8.0-alpha.6"
   },
   "dependencies": {
     "@embroider/macros": "^1.18.1"
@@ -43,9 +43,9 @@
     "@babel/plugin-transform-typescript": "^7.28.0",
     "@babel/preset-typescript": "^7.27.1",
     "@types/jquery": "^3.5.33",
-    "@warp-drive/internal-config": "5.8.0-alpha.4",
-    "@warp-drive/core": "5.8.0-alpha.4",
-    "@warp-drive/utilities": "5.8.0-alpha.4",
+    "@warp-drive/internal-config": "5.8.0-alpha.6",
+    "@warp-drive/core": "5.8.0-alpha.6",
+    "@warp-drive/utilities": "5.8.0-alpha.6",
     "ember-source": "~6.6.0",
     "decorator-transforms": "^2.3.0",
     "expect-type": "^1.2.2",