@warp-drive/legacy 5.8.0-alpha.3 → 5.8.0-alpha.30

package/dist/model.js

@@ -4,12 +4,11 @@ import { RecordStore } from '@warp-drive/core/types/symbols';
 import { i as isElementDescriptor, n as normalizeModelName } from "./util-Dul6TZts.js";
 import { macroCondition, getGlobalConfig } from '@embroider/macros';
 import { warn, deprecate } from '@ember/debug';
-import { assertPrivateStore, setRecordIdentifier, StoreMap } from '@warp-drive/core/store/-private';
-import { l as lookupLegacySupport } from "./errors-8kD2mSe_.js";
+import { assertPrivateStore } from '@warp-drive/core/store/-private';
+import { l as lookupLegacySupport } from "./errors-B9CDPh3R.js";
 import { singularize, dasherize } from '@warp-drive/utilities/string';
-import { l as getModelFactory } from "./schema-provider-DQu4Rjco.js";
-export { M as Model, b as buildSchema, M as default, m as restoreDeprecatedModelRequestBehaviors } from "./schema-provider-DQu4Rjco.js";
-import { setOwner, getOwner } from '@ember/application';
+export { M as Model, b as buildSchema, M as default, m as restoreDeprecatedModelRequestBehaviors } from "./schema-provider-BnVr_CnJ.js";
+export { i as instantiateRecord, m as modelFor, t as teardownRecord } from "./hooks-CQXyievu.js";
 function _attr(type, options) {
   if (typeof type === 'object') {
     options = type;
@@ -87,12 +86,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`,
+  WarpDrive 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 +168,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 +256,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:
@@ -340,7 +338,7 @@ function _belongsTo(type, options) {
 
   #### Sync vs Async Relationships
 
-  EmberData fulfills relationships using resource data available in
+  WarpDrive fulfills relationships using resource data available in
   the cache.
 
   Sync relationships point directly to the known related resources.
@@ -408,9 +406,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 +494,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:
@@ -580,7 +577,7 @@ function _hasMany(type, options) {
 
   #### Sync vs Async Relationships
 
-  EmberData fulfills relationships using resource data available in
+  WarpDrive fulfills relationships using resource data available in
   the cache.
 
   Sync relationships point directly to the known related resources.
@@ -648,9 +645,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>>(
@@ -668,72 +664,4 @@ function hasMany(type, options) {
   }
   return _hasMany(type, options);
 }
-function instantiateRecord(identifier, createRecordArgs) {
-  const type = identifier.type;
-
-  // TODO deprecate allowing unknown args setting
-  const createOptions = {
-    _createProps: createRecordArgs,
-    // TODO @deprecate consider deprecating accessing record properties during init which the below is necessary for
-    _secretInit: {
-      identifier,
-      store: this,
-      cb: secretInit
-    }
-  };
-
-  // ensure that `getOwner(this)` works inside a model instance
-  setOwner(createOptions, getOwner(this));
-  const factory = getModelFactory(this, type);
-  macroCondition(getGlobalConfig().WarpDrive.env.DEBUG) ? (test => {
-    if (!test) {
-      throw new Error(`No model was found for '${type}'`);
-    }
-  })(factory) : {};
-  return factory.class.create(createOptions);
-}
-function teardownRecord(record) {
-  macroCondition(getGlobalConfig().WarpDrive.env.DEBUG) ? (test => {
-    if (!test) {
-      throw new Error(`expected to receive an instance of Model from @ember-data/model. If using a custom model make sure you implement teardownRecord`);
-    }
-  })('destroy' in record) : {};
-  record.destroy();
-}
-function modelFor(modelName) {
-  assertPrivateStore(this);
-  macroCondition(getGlobalConfig().WarpDrive.env.DEBUG) ? (test => {
-    if (!test) {
-      throw new Error(`Attempted to call store.modelFor(), but the store instance has already been destroyed.`);
-    }
-  })(!this.isDestroyed && !this.isDestroying) : {};
-  macroCondition(getGlobalConfig().WarpDrive.env.DEBUG) ? (test => {
-    if (!test) {
-      throw new Error(`You need to pass a model name to the store's modelFor method`);
-    }
-  })(modelName) : {};
-  macroCondition(getGlobalConfig().WarpDrive.env.DEBUG) ? (test => {
-    if (!test) {
-      throw new Error(`Please pass a proper model name to the store's modelFor method`);
-    }
-  })(typeof modelName === 'string' && modelName.length) : {};
-  const type = normalizeModelName(modelName);
-  const maybeFactory = getModelFactory(this, type);
-  const klass = maybeFactory && maybeFactory.class ? maybeFactory.class : null;
-  const ignoreType = !klass || !klass.isModel || this._forceShim;
-  if (!ignoreType) {
-    return klass;
-  }
-  macroCondition(getGlobalConfig().WarpDrive.env.DEBUG) ? (test => {
-    if (!test) {
-      throw new Error(`No model was found for '${type}' and no schema handles the type`);
-    }
-  })(this.schema.hasResource({
-    type
-  })) : {};
-}
-function secretInit(record, identifier, store) {
-  setRecordIdentifier(record, identifier);
-  StoreMap.set(record, store);
-}
-export { attr, belongsTo, hasMany, instantiateRecord, modelFor, teardownRecord };
+export { attr, belongsTo, hasMany };

package/dist/{schema-provider-DQu4Rjco.js → schema-provider-BnVr_CnJ.js}

@@ -4,8 +4,8 @@ import EmberObject from '@ember/object';
 import { recordIdentifierFor, storeFor } from '@warp-drive/core';
 import { assertPrivateStore, notifyInternalSignal, peekInternalSignal, withSignalStore, recordIdentifierFor as recordIdentifierFor$1, gate, memoized, defineSignal, coerceId, entangleSignal, defineGate } from '@warp-drive/core/store/-private';
 import { RecordStore } from '@warp-drive/core/types/symbols';
-import { l as lookupLegacySupport, L as LEGACY_SUPPORT, E as Errors } from "./errors-8kD2mSe_.js";
-import { u as upgradeStore, F as FetchManager } from "./-private-8UmnAf9J.js";
+import { l as lookupLegacySupport, L as LEGACY_SUPPORT, E as Errors } from "./errors-B9CDPh3R.js";
+import { u as upgradeStore, F as FetchManager } from "./-private-B1pSSN52.js";
 import { macroCondition, getGlobalConfig } from '@embroider/macros';
 import { cacheFor } from '@ember/object/internals';
 import { Context } from '@warp-drive/core/reactive/-private';
@@ -254,7 +254,7 @@ function isInvalidError(error) {
 }
 
 /**
-Historically EmberData managed a state machine
+Historically WarpDrive managed a state machine
 for each record, the localState for which
 was reflected onto Model.
 
@@ -680,11 +680,6 @@ function computeOnce(target, propertyName, desc) {
   };
   return desc;
 }
-
-/**
- * @noInheritDoc
- */
-
 /**
  * Base class from which Models can be defined.
  *
@@ -727,7 +722,10 @@ function computeOnce(target, propertyName, desc) {
  * the class to use as the reactive object for data of resource
  * of that type.
  *
+ * @public
  * @noInheritDoc
+ * @hideconstructor
+ * @legacy
  */
 class Model extends EmberObject {
   /** @internal */
@@ -1255,7 +1253,7 @@ class Model extends EmberObject {
   /**
    Represents the model's class name as a string. This can be used to look up the model's class name through
    `Store`'s modelFor method.
-    `modelName` is generated for you by EmberData. It will be a lowercased, dasherized string.
+    `modelName` is generated for you by WarpDrive. It will be a lowercased, dasherized string.
    For example:
     ```javascript
    store.modelFor('post').modelName; // 'post'
@@ -2337,4 +2335,4 @@ function getModelFactory(store, type) {
   }
   return factory;
 }
-export { Model as M, RecordState as R, _save as _, save as a, buildSchema as b, _reload as c, reload as d, _destroyRecord as e, destroyRecord as f, deleteRecord as g, hasMany as h, changedAttributes as i, belongsTo as j, createSnapshot as k, getModelFactory as l, restoreDeprecatedModelRequestBehaviors as m, rollbackAttributes as r, serialize as s, unloadRecord as u };
+export { Model as M, RecordState as R, _save as _, save as a, buildSchema as b, _reload as c, reload as d, _destroyRecord as e, destroyRecord as f, getModelFactory as g, hasMany as h, deleteRecord as i, changedAttributes as j, belongsTo as k, createSnapshot as l, restoreDeprecatedModelRequestBehaviors as m, rollbackAttributes as r, serialize as s, unloadRecord as u };

package/dist/{serialize-into-hash-CS0MIv4F.js → serialize-into-hash-BnYvPex3.js}

@@ -1,7 +1,7 @@
 import { warn } from '@ember/debug';
 import { macroCondition, getGlobalConfig } from '@embroider/macros';
 import '@warp-drive/core/reactive/-private';
-import "./-private-8UmnAf9J.js";
+import "./-private-B1pSSN52.js";
 import '@warp-drive/core/store/-private';
 const newline = /\r?\n/;
 function parseResponseHeaders(headersString) {

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-BHxlccxF.js";
 import { macroCondition, getGlobalConfig } from '@embroider/macros';
 
 /* eslint-disable @typescript-eslint/no-unsafe-return */
@@ -10,8 +10,6 @@ import { macroCondition, getGlobalConfig } from '@embroider/macros';
 /* eslint-disable @typescript-eslint/no-unsafe-call */
 const JSONAPISerializer = JSONSerializer.extend({
   /**
-    @param {Object} documentHash
-    @return {Object}
     @private
   */
   _normalizeDocumentHelper(documentHash) {
@@ -41,8 +39,6 @@ const JSONAPISerializer = JSONSerializer.extend({
     return documentHash;
   },
   /**
-    @param {Object} relationshipDataHash
-    @return {Object}
     @private
   */
   _normalizeRelationshipDataHelper(relationshipDataHash) {
@@ -50,8 +46,6 @@ const JSONAPISerializer = JSONSerializer.extend({
     return relationshipDataHash;
   },
   /**
-    @param {Object} resourceHash
-    @return {Object}
     @private
   */
   _normalizeResourceHelper(resourceHash) {
@@ -88,21 +82,13 @@ const JSONAPISerializer = JSONSerializer.extend({
   /**
     Normalize some data and push it into the store.
      @public
-    @param {Store} store
-    @param {Object} payload
   */
   pushPayload(store, payload) {
     const normalizedPayload = this._normalizeDocumentHelper(payload);
     store.push(normalizedPayload);
   },
   /**
-    @param {Store} store
-    @param {Model} primaryModelClass
-    @param {Object} payload
-    @param {String|Number} id
-    @param {String} requestType
-    @param {Boolean} isSingle
-    @return {Object} JSON-API Document
+    @return A {json:api} Document
     @private
   */
   _normalizeResponse(store, primaryModelClass, payload, id, requestType, isSingle) {
@@ -144,8 +130,6 @@ const JSONAPISerializer = JSONSerializer.extend({
      Returns a relationship formatted as a JSON-API "relationship object".
       http://jsonapi.org/format/#document-resource-object-relationships
      @public
-     @param {Object} relationshipHash
-     @return {Object}
   */
   extractRelationship(relationshipHash) {
     if (Array.isArray(relationshipHash.data)) {
@@ -164,9 +148,6 @@ const JSONAPISerializer = JSONSerializer.extend({
      Returns the resource's relationships formatted as a JSON-API "relationships object".
       http://jsonapi.org/format/#document-resource-object-relationships
      @public
-     @param {Object} modelClass
-     @param {Object} resourceHash
-     @return {Object}
   */
   extractRelationships(modelClass, resourceHash) {
     const relationships = {};
@@ -191,9 +172,6 @@ const JSONAPISerializer = JSONSerializer.extend({
     return relationships;
   },
   /**
-    @param {Model} modelClass
-    @param {Object} resourceHash
-    @return {String}
     @private
   */
   _extractType(modelClass, resourceHash) {
@@ -205,8 +183,7 @@ const JSONAPISerializer = JSONSerializer.extend({
      For example the key `posts` would be converted to `post` and the
     key `studentAssesments` would be converted to `student-assesment`.
      @public
-    @param {String} key
-    @return {String} the model's modelName
+    @return the model's modelName
   */
   modelNameFromPayloadKey(key) {
     return dasherize(singularize(key));
@@ -216,8 +193,6 @@ const JSONAPISerializer = JSONSerializer.extend({
      For example `post` would be converted to `posts` and
     `student-assesment` would be converted to `student-assesments`.
      @public
-    @param {String} modelName
-    @return {String}
   */
   payloadKeyFromModelName(modelName) {
     return pluralize(modelName);
@@ -267,9 +242,7 @@ const JSONAPISerializer = JSONSerializer.extend({
     }
     ```
      @public
-    @param {String} key
-    @param {String} method
-    @return {String} normalized key
+    @return normalized key
   */
   keyForAttribute(key, method) {
     return dasherize(key);
@@ -292,10 +265,7 @@ const JSONAPISerializer = JSONSerializer.extend({
     }
     ```
     @public
-   @param {String} key
-   @param {String} typeClass
-   @param {String} method
-   @return {String} normalized key
+   @return the normalized key
   */
   keyForRelationship(key, typeClass, method) {
     return dasherize(key);
@@ -426,9 +396,6 @@ const JSONAPISerializer = JSONSerializer.extend({
     }
     ```
      @public
-    @param {Snapshot} snapshot
-    @param {Object} options
-    @return {Object} json
   */
   serialize(snapshot, options) {
     // @ts-expect-error untyped
@@ -467,6 +434,7 @@ const JSONAPISerializer = JSONSerializer.extend({
     // @ts-expect-error untyped
     if (this._canSerialize(name)) {
       const belongsTo = snapshot.belongsTo(name);
+      // @ts-expect-error not narrowed
       const belongsToIsNotNew = belongsTo && !belongsTo.isNew;
       if (belongsTo === null || belongsToIsNotNew) {
         json.relationships = json.relationships || {};
@@ -480,11 +448,13 @@ const JSONAPISerializer = JSONSerializer.extend({
         }
         let data = null;
         if (belongsTo) {
+          // @ts-expect-error not narrowed
           const payloadType = this.payloadKeyFromModelName(belongsTo.modelName);
 
           // @ts-expect-error untyped
           data = {
             type: payloadType,
+            // @ts-expect-error not narrowed
             id: belongsTo.id
           };
         }
@@ -512,13 +482,16 @@ const JSONAPISerializer = JSONSerializer.extend({
         }
 
         // only serialize has many relationships that are not new
+        // @ts-expect-error not narrowed
         const nonNewHasMany = hasMany.filter(item => !item.isNew);
         const data = new Array(nonNewHasMany.length);
         for (let i = 0; i < nonNewHasMany.length; i++) {
           const item = hasMany[i];
+          // @ts-expect-error not narrowed
           const payloadType = this.payloadKeyFromModelName(item.modelName);
           data[i] = {
             type: payloadType,
+            // @ts-expect-error not narrowed
             id: item.id
           };
         }

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-BHxlccxF.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-BHxlccxF.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.
@@ -20,14 +18,14 @@ import { a as decorateFieldV2, i as initializeDeferredDecorator } from "./runtim
   the format WarpDrive understands.
 
   Data received from an API response is **normalized** into
-  [JSON:API](https://jsonapi.org/) (the format used internally
+  [{json:api}](https://jsonapi.org/) (the format used internally
   by WarpDrive), while data sent to an API is **serialized**
   into the format the API expects.
 
   ### Implementing a Serializer
 
   There are only two required serializer methods, one for
-  normalizing data from the server API format into JSON:API, and
+  normalizing data from the server API format into {json:api}, and
   another for serializing records via `Snapshots` into the expected
   server API format.
 
@@ -73,7 +71,7 @@ import { a as decorateFieldV2, i as initializeDeferredDecorator } from "./runtim
   //   app/serializers/application.js
   ```
 
-  Most requests in @warp-drive/legacy are made with respect to a particular `type` (or `modelName`)
+  Most requests in `@warp-drive/legacy` are made with respect to a particular `type` (or `modelName`)
   (e.g., "get me the full collection of **books**" or "get me the **employee** whose id is 37"). We
   refer to this as the **primary** resource `type`.
 
@@ -109,7 +107,6 @@ import { a as decorateFieldV2, i as initializeDeferredDecorator } from "./runtim
 
   @module
 */
-
 const service = s.service ?? s.inject;
 
 /**
@@ -127,8 +124,7 @@ const service = s.service ?? s.inject;
 
     * `normalize()`
 
-  For an example implementation, see
-  [JSONSerializer](JSONSerializer), the included JSON serializer.
+  For an example implementation, see the included {@link JSONSerializer}.
 
   @class Serializer
   @public

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/logos/README.md

@@ -1,4 +1,4 @@
 # Autogeneration Notice
 
-This directory is maintained in the root of the monorepo and sync'd to public
-repositories by running `bun sync-logos`
+This directory is maintained in the root of the monorepo in `/logos/synced` and sync'd
+to public repositories by running `bun sync-logos`

package/logos/logo-yellow-slab.svg

@@ -0,0 +1 @@
+<svg xmlns="http://www.w3.org/2000/svg" width="1498" height="1047" fill="none" viewBox="0 0 1498 1047"><g filter="url(#a)"><path fill="url(#b)" d="M132 175.075C132 149.076 153.138 128 179.213 128H1318.23c26.08 0 47.22 21.076 47.22 47.075v688.85c0 25.999-21.14 47.075-47.22 47.075H179.213C153.138 911 132 889.924 132 863.925z"/><path fill="#201328" d="M1043.4 587.312c0-39.962 30.84-72.357 68.87-72.357h53.09c38.04 0 68.88-32.395 68.88-72.357v-92.651c0-39.962-30.84-72.358-68.88-72.358h-53.09c-38.01 0-68.82 32.351-68.87 72.275v92.734c0 39.962-30.83 72.357-68.869 72.357h-53.089c-38.036 0-68.871-32.395-68.871-72.357v-87.409c0-39.962-30.835-72.358-68.872-72.358h-51.654c-38.037 0-68.872 32.396-68.872 72.358v87.409c0 39.962-30.835 72.357-68.872 72.357h-53.088c-38.037 0-68.872-32.395-68.872-72.357v-92.652c0-39.961-30.835-72.357-68.872-72.357h-53.088c-38.037 0-68.872 32.396-68.872 72.357v92.652c0 39.962 30.835 72.357 68.872 72.357h53.088c38.037 0 68.872 32.395 68.872 72.357v101.741c0 39.962 30.835 72.358 68.872 72.358h53.088c38.037 0 68.872-32.396 68.872-72.358V587.312c0-39.962 30.835-72.357 68.872-72.357h51.654c38.037 0 68.872 32.395 68.872 72.357v101.741c0 39.962 30.835 72.358 68.871 72.358h53.089c38.039 0 68.869-32.396 68.869-72.358z"/></g><defs><linearGradient id="b" x1="748.724" x2="1167.5" y1="128" y2="1070.23" gradientUnits="userSpaceOnUse"><stop stop-color="#ffc474"/><stop offset="1" stop-color="#ff9809"/></linearGradient><filter id="a" width="1497.45" height="1047" x="0" y="0" color-interpolation-filters="sRGB" filterUnits="userSpaceOnUse"><feFlood flood-opacity="0" result="BackgroundImageFix"/><feColorMatrix in="SourceAlpha" result="hardAlpha" values="0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 127 0"/><feOffset dy="4"/><feGaussianBlur stdDeviation="66"/><feComposite in2="hardAlpha" operator="out"/><feColorMatrix values="0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0.1 0"/><feBlend in2="BackgroundImageFix" result="effect1_dropShadow_757_188"/><feColorMatrix in="SourceAlpha" result="hardAlpha" values="0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 127 0"/><feOffset dy="4"/><feGaussianBlur stdDeviation="18"/><feComposite in2="hardAlpha" operator="out"/><feColorMatrix values="0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0.25 0"/><feBlend in2="effect1_dropShadow_757_188" result="effect2_dropShadow_757_188"/><feColorMatrix in="SourceAlpha" result="hardAlpha" values="0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 127 0"/><feOffset dy="4"/><feGaussianBlur stdDeviation="2"/><feComposite in2="hardAlpha" operator="out"/><feColorMatrix values="0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0.25 0"/><feBlend in2="effect2_dropShadow_757_188" result="effect3_dropShadow_757_188"/><feBlend in="SourceGraphic" in2="effect3_dropShadow_757_188" result="shape"/></filter></defs></svg>

package/logos/word-mark-black.svg

@@ -0,0 +1 @@
+<svg xmlns="http://www.w3.org/2000/svg" width="2081" height="200" fill="none" viewBox="0 0 2081 200"><path fill="#000" d="M2064.89 185.359c-15.57 5.16-31.15 8.846-46.72 11.058q-23.22 3.456-47.55 3.456c-20.73 0-39.21-2.212-55.43-6.635q-24.18-6.773-40.77-19.49c-11.06-8.478-19.49-18.844-25.3-31.1-5.8-12.256-8.71-26.125-8.71-41.606 0-14.375 2.91-27.69 8.71-39.947 5.9-12.348 14.19-23.037 24.88-32.068 10.78-9.123 23.78-16.218 38.98-21.286C1928.19 2.58 1945.14 0 1963.85 0c17.23 0 32.99 2.35 47.27 7.05 14.38 4.607 26.68 11.472 36.91 20.595q15.48 13.684 23.91 33.727c5.71 13.361 8.57 28.75 8.57 46.167v12.716h-187.16a48.3 48.3 0 0 0 8.16 16.449c3.87 4.976 9.08 9.215 15.62 12.717 6.54 3.501 14.56 6.22 24.05 8.155 9.58 1.935 21.01 2.903 34.28 2.903 9.4 0 18.61-.553 27.64-1.659 9.04-1.198 17.47-2.719 25.3-4.562q11.745-2.902 21.15-6.358c6.36-2.304 11.47-4.607 15.34-6.911zm-35.38-102.7c-.47-4.7-1.89-9.538-4.29-14.514-2.3-5.069-5.99-9.63-11.06-13.685s-11.7-7.371-19.9-9.952q-12.3-4.008-30.69-4.008-17.28 0-29.85 4.285-12.585 4.284-21.15 10.643c-5.62 4.239-10 8.8-13.13 13.684-3.14 4.884-5.16 9.4-6.09 13.546zm-284.63 112.099h-59.71l-96.06-189.92h57.22l69.11 142.924 68.98-142.924h57.22zm-238.29 0V4.838h51.28v189.92zm-32.63-146.932c-1.38-.461-3.4-1.06-6.08-1.797q-3.87-1.245-9.12-2.35-5.25-1.244-11.61-2.073c-4.15-.553-8.43-.83-12.86-.83-9.21 0-17.83 1.152-25.84 3.456q-11.895 3.317-22.26 8.984a125.3 125.3 0 0 0-19.35 12.717c-5.9 4.7-11.33 9.537-16.31 14.514v114.311h-51.28V4.838h51.28v30.824c6.17-4.608 12.49-9.03 18.94-13.27a163 163 0 0 1 20.32-11.472c7.09-3.318 14.56-5.944 22.39-7.88 7.83-2.026 16.12-3.04 24.88-3.04 3.32 0 6.68.184 10.09.553 3.5.276 6.86.645 10.09 1.106 3.32.46 6.4.967 9.26 1.52s5.35 1.106 7.46 1.659zM1263.71 99.66c0 12.164-1.33 22.991-4 32.483-2.68 9.399-6.45 17.6-11.34 24.604-4.79 7.003-10.6 12.947-17.42 17.831q-10.08 7.325-22.53 11.749c-8.29 2.948-17.23 5.114-26.81 6.496q-14.37 1.935-30 1.935h-120.53V4.838h120.26c10.41 0 20.41.691 29.99 2.073 9.59 1.29 18.52 3.41 26.82 6.359 8.38 2.948 15.99 6.865 22.8 11.749 6.82 4.791 12.63 10.735 17.42 17.83 4.89 7.004 8.66 15.205 11.34 24.605 2.67 9.399 4 20.134 4 32.206m-51.69 0q0-13.685-3.6-23.775c-2.3-6.727-6.08-12.256-11.33-16.587-5.16-4.423-11.93-7.694-20.32-9.814-8.38-2.211-18.61-3.317-30.68-3.317h-63.73v107.262h63.73c12.07 0 22.3-1.06 30.68-3.179 8.39-2.212 15.16-5.529 20.32-9.952 5.25-4.515 9.03-10.137 11.33-16.864q3.6-10.09 3.6-23.774M986.574 63.169q0 14.237-4.699 25.157-4.562 10.92-14.514 18.383-9.952 7.464-25.71 11.335-15.62 3.732-37.735 3.732h-85.285v72.982h-17.278V4.838h102.563q22.116 0 37.735 3.87 15.758 3.732 25.71 11.058t14.514 18.246q4.7 10.92 4.699 25.157m-17.831 0q0-13.546-4.561-21.84-4.423-8.294-13.823-12.716-9.26-4.562-23.636-6.082-14.237-1.52-33.865-1.52h-74.227v84.593h74.227q7.602 0 16.172.138 8.709 0 17.14-.83 8.432-.967 16.034-3.179 7.74-2.349 13.546-7.05 5.945-4.699 9.399-12.301 3.594-7.602 3.594-19.213M766.455 19.49q-4.01-1.244-11.197-2.627-7.049-1.52-18.245-1.52-15.481 0-29.166 3.87-13.545 3.732-25.295 10.229a126.3 126.3 0 0 0-21.563 15.205q-9.951 8.57-17.969 18.245v131.866h-17.278V4.838h17.278V43.54a166 166 0 0 1 20.043-17.555q10.92-8.017 22.945-13.684a125.8 125.8 0 0 1 25.157-8.985Q724.435 0 738.533 0q4.839 0 8.708.276 3.87.14 7.05.553 3.317.277 6.22.691 2.902.416 5.944.968zm-220.33 175.268v-21.01q-9.952 5.39-22.669 9.952-12.579 4.562-26.677 7.879-13.96 3.318-28.751 5.114-14.79 1.797-29.027 1.797-18.522 0-33.312-3.317-14.652-3.318-24.881-9.814-10.228-6.635-15.757-16.31-5.529-9.814-5.529-22.669 0-12.717 6.358-22.393 6.497-9.813 18.384-17.001 11.887-7.326 28.612-12.302 16.864-5.115 37.598-8.57 20.733-3.594 44.784-5.806 24.19-2.349 50.867-3.87V61.925q0-8.846-3.318-15.62-3.317-6.772-9.261-11.749-5.943-5.115-13.96-8.431-8.017-3.456-17.416-5.53-9.262-2.074-19.628-2.902a219 219 0 0 0-20.596-.968q-13.96 0-25.433 1.383-11.473 1.381-21.425 3.87-9.952 2.35-19.075 5.529a563 563 0 0 0-18.384 6.773V14.099q19.213-5.114 40.915-8.846 21.839-3.87 46.305-3.87 20.733 0 38.703 3.593 17.969 3.456 31.238 11.196 13.27 7.74 20.872 20.043 7.603 12.164 7.603 29.718v128.825zm0-102.977q-45.2 2.489-77.268 7.05-31.929 4.561-52.248 11.196-20.32 6.634-29.857 15.481-9.399 8.846-9.399 20.042 0 9.123 4.561 16.173 4.7 7.049 13.408 11.887 8.708 4.7 21.148 7.188 12.44 2.349 27.922 2.349 9.123 0 18.798-.967a276 276 0 0 0 19.49-2.903 319 319 0 0 0 19.075-4.423q9.4-2.627 17.693-5.667t15.066-6.497q6.912-3.455 11.611-7.049zM180.245 4.838l67.73 176.098L318.193 4.838h19.213l-76.438 189.92h-25.71L168.634 23.222l-66.486 171.536h-25.71L0 4.838h19.213l70.218 176.098L157.023 4.838z"/></svg>

package/logos/word-mark-white.svg

@@ -0,0 +1 @@
+<svg xmlns="http://www.w3.org/2000/svg" width="2081" height="200" fill="none" viewBox="0 0 2081 200"><path fill="#fff" d="M2064.89 185.359c-15.57 5.16-31.15 8.846-46.72 11.058q-23.22 3.456-47.55 3.456c-20.73 0-39.21-2.212-55.43-6.635q-24.18-6.773-40.77-19.49c-11.06-8.478-19.49-18.844-25.3-31.1-5.8-12.256-8.71-26.125-8.71-41.606 0-14.375 2.91-27.69 8.71-39.947 5.9-12.348 14.19-23.037 24.88-32.068 10.78-9.123 23.78-16.218 38.98-21.286C1928.19 2.58 1945.14 0 1963.85 0c17.23 0 32.99 2.35 47.27 7.05 14.38 4.607 26.68 11.472 36.91 20.595q15.48 13.684 23.91 33.727c5.71 13.361 8.57 28.75 8.57 46.167v12.716h-187.16a48.3 48.3 0 0 0 8.16 16.449c3.87 4.976 9.08 9.215 15.62 12.717 6.54 3.501 14.56 6.22 24.05 8.155 9.58 1.935 21.01 2.903 34.28 2.903 9.4 0 18.61-.553 27.64-1.659 9.04-1.198 17.47-2.719 25.3-4.562q11.745-2.902 21.15-6.358c6.36-2.304 11.47-4.607 15.34-6.911zm-35.38-102.7c-.47-4.7-1.89-9.538-4.29-14.514-2.3-5.069-5.99-9.63-11.06-13.685s-11.7-7.371-19.9-9.952q-12.3-4.008-30.69-4.008-17.28 0-29.85 4.285-12.585 4.284-21.15 10.643c-5.62 4.239-10 8.8-13.13 13.684-3.14 4.884-5.16 9.4-6.09 13.546zm-284.63 112.099h-59.71l-96.06-189.92h57.22l69.11 142.924 68.98-142.924h57.22zm-238.29 0V4.838h51.28v189.92zm-32.63-146.932c-1.38-.461-3.4-1.06-6.08-1.797q-3.87-1.245-9.12-2.35-5.25-1.244-11.61-2.073c-4.15-.553-8.43-.83-12.86-.83-9.21 0-17.83 1.152-25.84 3.456q-11.895 3.317-22.26 8.984a125.3 125.3 0 0 0-19.35 12.717c-5.9 4.7-11.33 9.537-16.31 14.514v114.311h-51.28V4.838h51.28v30.824c6.17-4.608 12.49-9.03 18.94-13.27a163 163 0 0 1 20.32-11.472c7.09-3.318 14.56-5.944 22.39-7.88 7.83-2.026 16.12-3.04 24.88-3.04 3.32 0 6.68.184 10.09.553 3.5.276 6.86.645 10.09 1.106 3.32.46 6.4.967 9.26 1.52s5.35 1.106 7.46 1.659zM1263.71 99.66c0 12.164-1.33 22.991-4 32.483-2.68 9.399-6.45 17.6-11.34 24.604-4.79 7.003-10.6 12.947-17.42 17.831q-10.08 7.325-22.53 11.749c-8.29 2.948-17.23 5.114-26.81 6.496q-14.37 1.935-30 1.935h-120.53V4.838h120.26c10.41 0 20.41.691 29.99 2.073 9.59 1.29 18.52 3.41 26.82 6.359 8.38 2.948 15.99 6.865 22.8 11.749 6.82 4.791 12.63 10.735 17.42 17.83 4.89 7.004 8.66 15.205 11.34 24.605 2.67 9.399 4 20.134 4 32.206m-51.69 0q0-13.685-3.6-23.775c-2.3-6.727-6.08-12.256-11.33-16.587-5.16-4.423-11.93-7.694-20.32-9.814-8.38-2.211-18.61-3.317-30.68-3.317h-63.73v107.262h63.73c12.07 0 22.3-1.06 30.68-3.179 8.39-2.212 15.16-5.529 20.32-9.952 5.25-4.515 9.03-10.137 11.33-16.864q3.6-10.09 3.6-23.774M986.574 63.169q0 14.237-4.699 25.157-4.562 10.92-14.514 18.383-9.952 7.464-25.71 11.335-15.62 3.732-37.735 3.732h-85.285v72.982h-17.278V4.838h102.563q22.116 0 37.735 3.87 15.758 3.732 25.71 11.058t14.514 18.246q4.7 10.92 4.699 25.157m-17.831 0q0-13.546-4.561-21.84-4.423-8.294-13.823-12.716-9.26-4.562-23.636-6.082-14.237-1.52-33.865-1.52h-74.227v84.593h74.227q7.602 0 16.172.138 8.709 0 17.14-.83 8.432-.967 16.034-3.179 7.74-2.349 13.546-7.05 5.945-4.699 9.399-12.301 3.594-7.602 3.594-19.213M766.455 19.49q-4.01-1.244-11.197-2.627-7.049-1.52-18.245-1.52-15.481 0-29.166 3.87-13.545 3.732-25.295 10.229a126.3 126.3 0 0 0-21.563 15.205q-9.951 8.57-17.969 18.245v131.866h-17.278V4.838h17.278V43.54a166 166 0 0 1 20.043-17.555q10.92-8.017 22.945-13.684a125.8 125.8 0 0 1 25.157-8.985Q724.435 0 738.533 0q4.839 0 8.708.276 3.87.14 7.05.553 3.317.277 6.22.691 2.902.416 5.944.968zm-220.33 175.268v-21.01q-9.952 5.39-22.669 9.952-12.579 4.562-26.677 7.879-13.96 3.318-28.751 5.114-14.79 1.797-29.027 1.797-18.522 0-33.312-3.317-14.652-3.318-24.881-9.814-10.228-6.635-15.757-16.31-5.529-9.814-5.529-22.669 0-12.717 6.358-22.393 6.497-9.813 18.384-17.001 11.887-7.326 28.612-12.302 16.864-5.115 37.598-8.57 20.733-3.594 44.784-5.806 24.19-2.349 50.867-3.87V61.925q0-8.846-3.318-15.62-3.317-6.772-9.261-11.749-5.943-5.115-13.96-8.431-8.017-3.456-17.416-5.53-9.262-2.074-19.628-2.902a219 219 0 0 0-20.596-.968q-13.96 0-25.433 1.383-11.473 1.381-21.425 3.87-9.952 2.35-19.075 5.529a563 563 0 0 0-18.384 6.773V14.099q19.213-5.114 40.915-8.846 21.839-3.87 46.305-3.87 20.733 0 38.703 3.593 17.969 3.456 31.238 11.196 13.27 7.74 20.872 20.043 7.603 12.164 7.603 29.718v128.825zm0-102.977q-45.2 2.489-77.268 7.05-31.929 4.561-52.248 11.196-20.32 6.634-29.857 15.481-9.399 8.846-9.399 20.042 0 9.123 4.561 16.173 4.7 7.049 13.408 11.887 8.708 4.7 21.148 7.188 12.44 2.349 27.922 2.349 9.123 0 18.798-.967a276 276 0 0 0 19.49-2.903 319 319 0 0 0 19.075-4.423q9.4-2.627 17.693-5.667t15.066-6.497q6.912-3.455 11.611-7.049zM180.245 4.838l67.73 176.098L318.193 4.838h19.213l-76.438 189.92h-25.71L168.634 23.222l-66.486 171.536h-25.71L0 4.838h19.213l70.218 176.098L157.023 4.838z"/></svg>