@warp-drive/legacy 5.10.0-alpha.12 → 5.10.0-alpha.13

package/dist/{unpkg/dev-deprecated/model-fragments-DSqu0ptR.js → model-fragments-ZM4k_mT3.js}

@@ -24,6 +24,8 @@ function withArrayDefaults(arrayName, primitiveType) {
 * Used as a helper to setup the relevant parts of a fragment schema
 * and add extensions etc.
 *
+* @summary Legacy ModelFragments migration helper that builds a `schema-object` field for a single `fragment:`
+* type with the `ember-object` and `fragment` extensions.
 * @param fragmentType The type of the fragment
 * @param fragmentName The optional name of the fragment. If not provided, it will default to the fragmentType.
 * @returns The schema for a fragment
@@ -43,6 +45,8 @@ function withFragmentDefaults(fragmentType, fragmentName) {
 * Used as a helper to setup the relevant parts of a fragment-array
 * schema and add extensions etc.
 *
+* @summary Legacy ModelFragments migration helper that builds a `schema-array` field of `fragment:` items,
+* defaulting to an empty array, with Ember and fragment-array extensions.
 * @param fragmentArrayType The type of the fragment-array
 * @param fragmentArrayName The name of the fragment-array
 * @returns The schema for a fragment-array
@@ -70,6 +74,8 @@ function withFragmentArrayDefaults(fragmentArrayType, fragmentArrayName) {
 * migrated from `Model`, applying the `ember-object` and `fragment` object
 * extensions and a default `@id` identity field.
 *
+* @summary Legacy ModelFragments migration helper that completes a legacy resource schema with an `id` identity,
+* `Model` defaults, and the `ember-object` and `fragment` extensions.
 * @param schema the partial legacy resource schema to complete
 * @returns the completed resource schema
 */
@@ -89,6 +95,9 @@ function withLegacy(schema) {
 /**
 * The features added to an array resource by {@link FragmentArrayExtension}, providing
 * a subset of the legacy `ModelFragments` fragment-array API for migrated resources.
+*
+* @summary Legacy `ModelFragments`-compatible array API, such as `addFragment`, `removeFragment`, and
+* `rollbackAttributes`, for reactive arrays migrated off fragments.
 */
 var FragmentArray = class {
 	static {
@@ -153,6 +162,9 @@ var FragmentArray = class {
 /**
 * A schema extension that adds the {@link FragmentArray} API to migrated
 * `ModelFragments` array resources.
+*
+* @summary Legacy schema extension named `fragment-array` that adds the `FragmentArray` API to reactive arrays
+* migrated from `ModelFragments`.
 */
 const FragmentArrayExtension = {
 	kind: "array",
@@ -165,6 +177,9 @@ const FragmentArrayExtension = {
 /**
 * The features added to an object resource by {@link FragmentExtension}, providing
 * a subset of the legacy `ModelFragments` fragment API for migrated resources.
+*
+* @summary Legacy `ModelFragments`-compatible object API, such as `hasDirtyAttributes`, `isFragment`, and
+* `rollbackAttributes`, for reactive objects migrated off fragments.
 */
 var Fragment = class {
 	static {
@@ -224,6 +239,9 @@ var Fragment = class {
 /**
 * A schema extension that adds the {@link Fragment} API to migrated
 * `ModelFragments` object resources.
+*
+* @summary Legacy schema extension named `fragment` that adds the `Fragment` API to reactive objects migrated from
+* `ModelFragments`.
 */
 const FragmentExtension = {
 	kind: "object",
@@ -237,6 +255,8 @@ const FragmentExtension = {
 * Registers the {@link FragmentExtension}/{@link FragmentArrayExtension} schema
 * extensions on the given `SchemaService`, enabling ModelFragments migration support.
 *
+* @summary Legacy setup function that registers the fragment and fragment-array schema extensions on a
+* `SchemaService` to support migrating off ModelFragments.
 * @public
 */
 function registerFragmentExtensions(schema) {
@@ -325,10 +345,12 @@ function fragmentsModelFor(modelName) {
 * type when ModelFragments support is enabled and no real `Model` subclass
 * is registered for that type.
 *
+* @summary Legacy `store.modelFor` fallback that returns a schema-backed `ShimModelClass` for a type when
+* ModelFragments support is on and no `Model` class exists.
 * @public
 */
 const modelFor = fragmentsModelFor;
 
 //#endregion
 export { FragmentExtension as a, withLegacy as c, withArrayDefaults as d, Fragment as i, withFragmentArrayDefaults as l, modelFor as n, FragmentArray as o, registerFragmentExtensions as r, FragmentArrayExtension as s, fragmentsModelFor as t, withFragmentDefaults as u };
-//# sourceMappingURL=model-fragments-DSqu0ptR.js.map
+//# sourceMappingURL=model-fragments-ZM4k_mT3.js.map

package/dist/model-fragments-ZM4k_mT3.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"model-fragments-ZM4k_mT3.js","names":["cached","tracked","Context","g","i","n","FragmentArray","prototype","isDestroying","isDestroyed","hasDirtyAttributes","array","context","path","resourceKey","store","record","peekRecord","root","at","changedAttributes","addFragment","fragment","addObject","createFragment","pushObject","removeFragment","index","indexOf","splice","rollbackAttributes","FragmentArrayExtension","kind","name","features","i","cached","tracked","Context","g","i","n","Fragment","prototype","isDestroying","isDestroyed","hasDirtyAttributes","path","resourceKey","store","record","peekRecord","root","at","changedAttributes","isFragment","$type","field","type","rollbackAttributes","oldValue","cache","getRemoteAttr","setAttr","FragmentExtension","kind","name","features","i","FragmentArrayExtension","FragmentExtension","registerFragmentExtensions","schema","CAUTION_MEGA_DANGER_ZONE_registerExtension","initialize","application","store","lookup","console","warn","name"],"sources":["../src/model-fragments/utilities/with-array-defaults.ts","../src/model-fragments/utilities/with-fragment-defaults.ts","../src/model-fragments/utilities/with-fragment-array-defaults.ts","../src/model-fragments/utilities/with-legacy.ts","../src/model-fragments/extensions/fragment-array.ts","../src/model-fragments/extensions/fragment.ts","../src/model-fragments/instance-initializers/fragment-extensions.ts","../src/model-fragments/hooks/model-for.ts"],"sourcesContent":["/**\n * Used as a helper to setup the relevant parts of an array\n * schema and add extensions etc.\n *\n * @summary Legacy ModelFragments migration helper that builds an `array` schema field preconfigured with the\n * `ember-object`, `ember-array-like`, and `fragment-array` extensions.\n * @param arrayName The name of the array\n * @param primitiveType The primitive type of items in the array (optional)\n * @returns The schema for an array\n */\nexport function withArrayDefaults<ArrayName extends string, PrimitiveType extends string>(\n  arrayName: ArrayName,\n  primitiveType?: PrimitiveType\n): PrimitiveType extends undefined\n  ? {\n      /**\n       * This field is an `'array'` schema field.\n       */\n      kind: 'array';\n      /**\n       * The name of the array field.\n       */\n      name: ArrayName;\n      /**\n       * The array's item type, `'array'` since no `primitiveType` was given.\n       */\n      type: 'array';\n      /**\n       * The schema options for this array field.\n       */\n      options: {\n        /**\n         * The registered array-schema extensions to apply to this array.\n         */\n        arrayExtensions: string[];\n      };\n    }\n  : {\n      /**\n       * This field is an `'array'` schema field.\n       */\n      kind: 'array';\n      /**\n       * The name of the array field.\n       */\n      name: ArrayName;\n      /**\n       * The array's item type, derived from `primitiveType`.\n       */\n      type: `array:${PrimitiveType}`;\n      /**\n       * The schema options for this array field.\n       */\n      options: {\n        /**\n         * The registered array-schema extensions to apply to this array.\n         */\n        arrayExtensions: string[];\n      };\n    };\n\nexport function withArrayDefaults<ArrayName extends string, PrimitiveType extends string>(\n  arrayName: ArrayName,\n  primitiveType?: PrimitiveType\n) {\n  const type = primitiveType ? (`array:${primitiveType}` as const) : ('array' as const);\n  return {\n    kind: 'array' as const,\n    name: arrayName,\n    type,\n    options: {\n      arrayExtensions: ['ember-object', 'ember-array-like', 'fragment-array'],\n    },\n  };\n}\n","/**\n * Used as a helper to setup the relevant parts of a fragment schema\n * and add extensions etc.\n *\n * @summary Legacy ModelFragments migration helper that builds a `schema-object` field for a single `fragment:`\n * type with the `ember-object` and `fragment` extensions.\n * @param fragmentType The type of the fragment\n * @param fragmentName The optional name of the fragment. If not provided, it will default to the fragmentType.\n * @returns The schema for a fragment\n */\nexport function withFragmentDefaults<FragmentType extends string, FragmentName extends string>(\n  fragmentType: FragmentType,\n  fragmentName?: FragmentName\n): {\n  /**\n   * This field is a `'schema-object'` field, a single fragment.\n   */\n  kind: 'schema-object';\n  /**\n   * The resource type of the fragment.\n   */\n  type: `fragment:${FragmentType}`;\n  /**\n   * The name of the fragment field.\n   */\n  name: FragmentType | FragmentName;\n  /**\n   * The schema options for this fragment field.\n   */\n  options: {\n    /**\n     * The registered object-schema extensions to apply to this fragment.\n     */\n    objectExtensions: string[];\n  };\n} {\n  return {\n    kind: 'schema-object' as const,\n    type: `fragment:${fragmentType}` as const,\n    name: fragmentName ?? fragmentType,\n    options: {\n      objectExtensions: ['ember-object', 'fragment'],\n    },\n  };\n}\n","import { pluralize, singularize } from '@warp-drive/utilities/string';\n\n/**\n * Used as a helper to setup the relevant parts of a fragment-array\n * schema and add extensions etc.\n *\n * @summary Legacy ModelFragments migration helper that builds a `schema-array` field of `fragment:` items,\n * defaulting to an empty array, with Ember and fragment-array extensions.\n * @param fragmentArrayType The type of the fragment-array\n * @param fragmentArrayName The name of the fragment-array\n * @returns The schema for a fragment-array\n */\nexport function withFragmentArrayDefaults<FragmentArrayType extends string, FragmentArrayName extends string>(\n  fragmentArrayType: FragmentArrayType,\n  fragmentArrayName?: FragmentArrayName\n): {\n  /**\n   * This field is a `'schema-array'` field, an array of fragments.\n   */\n  kind: 'schema-array';\n  /**\n   * The resource type of the fragments contained in this array.\n   */\n  type: `fragment:${string}`;\n  /**\n   * The name of the fragment-array field.\n   */\n  name: string;\n  /**\n   * The schema options for this fragment-array field.\n   */\n  options: {\n    /**\n     * The registered array-schema extensions to apply to this array.\n     */\n    arrayExtensions: string[];\n    /**\n     * Whether the array defaults to a non-null empty array when unset.\n     */\n    defaultValue: boolean;\n  };\n} {\n  return {\n    kind: 'schema-array' as const,\n    type: `fragment:${singularize(fragmentArrayType)}` as const,\n    name: fragmentArrayName ?? pluralize(fragmentArrayType),\n    options: {\n      arrayExtensions: ['ember-object', 'ember-array-like', 'fragment-array'],\n      defaultValue: true,\n    },\n  };\n}\n","import type { LegacyResourceSchema, ResourceSchema } from '@warp-drive/core/types/schema/fields';\nimport type { WithPartial } from '@warp-drive/core/types/utils';\n\nimport { withDefaults } from '../../model/migration-support';\n\n/**\n * Used as a helper to setup the relevant parts of a legacy resource schema\n * migrated from `Model`, applying the `ember-object` and `fragment` object\n * extensions and a default `@id` identity field.\n *\n * @summary Legacy ModelFragments migration helper that completes a legacy resource schema with an `id` identity,\n * `Model` defaults, and the `ember-object` and `fragment` extensions.\n * @param schema the partial legacy resource schema to complete\n * @returns the completed resource schema\n */\nexport function withLegacy(schema: WithPartial<LegacyResourceSchema, 'legacy' | 'identity'>): ResourceSchema {\n  return withDefaults({\n    ...schema,\n    identity: { kind: '@id', name: 'id' },\n    objectExtensions: ['ember-object', 'fragment'],\n  });\n}\n","import { cached, tracked } from '@glimmer/tracking';\n\nimport type { CAUTION_MEGA_DANGER_ZONE_Extension } from '@warp-drive/core/reactive';\nimport { Context, type ManagedArray } from '@warp-drive/core/reactive/-private';\n\nimport type Model from '../../model.ts';\nimport type { WithFragmentArray } from '../index.ts';\nimport type { Fragment } from './fragment.ts';\n\n/**\n * The features added to an array resource by {@link FragmentArrayExtension}, providing\n * a subset of the legacy `ModelFragments` fragment-array API for migrated resources.\n *\n * @summary Legacy `ModelFragments`-compatible array API, such as `addFragment`, `removeFragment`, and\n * `rollbackAttributes`, for reactive arrays migrated off fragments.\n */\nexport class FragmentArray<T extends Fragment> {\n  // We might want to check the parent values once we move this code to warp-drive.\n  /**\n   * Whether this fragment array is in the process of being destroyed.\n   */\n  @tracked isDestroying = false;\n  /**\n   * Whether this fragment array has been destroyed.\n   */\n  @tracked isDestroyed = false;\n\n  /**\n   * Whether this fragment array (or any of its members) has uncommitted changes.\n   */\n  @cached\n  get hasDirtyAttributes(): boolean {\n    const array = this as unknown as ManagedArray;\n    const context = array[Context];\n    const { path, resourceKey, store } = context;\n    const record = store.peekRecord(resourceKey) as Model;\n\n    if (record.hasDirtyAttributes && path) {\n      const root = path.at(0) as string;\n      return root in record.changedAttributes();\n    }\n\n    return false;\n  }\n\n  /**\n   * Adds an existing fragment to this array, if one was given.\n   */\n  addFragment(fragment?: T): Fragment[] | undefined {\n    if (!fragment) {\n      return;\n    }\n\n    return (this as unknown as WithFragmentArray<T>).addObject(fragment);\n  }\n\n  /**\n   * Appends a new fragment to the end of this array, if one was given.\n   */\n  createFragment(fragment?: T): Fragment | undefined {\n    if (!fragment) {\n      return;\n    }\n\n    return (this as unknown as WithFragmentArray<T>).pushObject(fragment);\n  }\n\n  /**\n   * Removes the given fragment from this array, if present.\n   */\n  removeFragment(fragment?: T): void {\n    if (!fragment) {\n      return;\n    }\n\n    const index = (this as unknown as WithFragmentArray<T>).indexOf(fragment);\n\n    if (index !== -1) {\n      (this as unknown as WithFragmentArray<T>).splice(index, 1);\n    }\n  }\n\n  /**\n   * Reverts each member fragment's attribute back to its last known remote value.\n   */\n  rollbackAttributes(): void {\n    for (const fragment of this as unknown as WithFragmentArray<T>) {\n      // @ts-expect-error TODO: fix these types\n      fragment?.rollbackAttributes?.();\n    }\n  }\n}\n\n/**\n * A schema extension that adds the {@link FragmentArray} API to migrated\n * `ModelFragments` array resources.\n *\n * @summary Legacy schema extension named `fragment-array` that adds the `FragmentArray` API to reactive arrays\n * migrated from `ModelFragments`.\n */\nexport const FragmentArrayExtension: {\n  /**\n   * This extension applies to `'array'` schemas.\n   */\n  kind: 'array';\n  /**\n   * The registered name of this extension.\n   */\n  name: 'fragment-array';\n  /**\n   * The features ({@link FragmentArray}) added by this extension.\n   */\n  features: typeof FragmentArray;\n} = {\n  kind: 'array' as const,\n  name: 'fragment-array' as const,\n  features: FragmentArray,\n} satisfies CAUTION_MEGA_DANGER_ZONE_Extension;\n\nexport default FragmentArrayExtension;\n","import { cached, tracked } from '@glimmer/tracking';\n\nimport type { CAUTION_MEGA_DANGER_ZONE_Extension } from '@warp-drive/core/reactive';\nimport type { PrivateReactiveResource } from '@warp-drive/core/reactive/-private';\nimport { Context } from '@warp-drive/core/reactive/-private';\nimport type { Value } from '@warp-drive/core/types/json/raw';\n\nimport type Model from '../../model.ts';\n\n/**\n * The features added to an object resource by {@link FragmentExtension}, providing\n * a subset of the legacy `ModelFragments` fragment API for migrated resources.\n *\n * @summary Legacy `ModelFragments`-compatible object API, such as `hasDirtyAttributes`, `isFragment`, and\n * `rollbackAttributes`, for reactive objects migrated off fragments.\n */\nexport class Fragment {\n  // We might want to check the parent values once we move this code to warp-drive.\n  /**\n   * Whether this fragment is in the process of being destroyed.\n   */\n  @tracked isDestroying = false;\n  /**\n   * Whether this fragment has been destroyed.\n   */\n  @tracked isDestroyed = false;\n\n  /**\n   * Whether this fragment (or the attribute it is rooted at) has uncommitted changes.\n   */\n  @cached\n  get hasDirtyAttributes(): boolean {\n    const { path, resourceKey, store } = (this as unknown as PrivateReactiveResource)[Context];\n    const record = store.peekRecord(resourceKey) as Model;\n\n    if (record.hasDirtyAttributes && path) {\n      const root = path.at(0) as string;\n      return root in record.changedAttributes();\n    }\n\n    return false;\n  }\n\n  /**\n   * Always `true`. Used to distinguish fragments from other resources.\n   */\n  get isFragment() {\n    return true;\n  }\n\n  /**\n   * The resource type of this fragment, if known.\n   */\n  get $type(): string | null | undefined {\n    const { field } = (this as unknown as PrivateReactiveResource)[Context];\n    return field?.type;\n  }\n\n  /**\n   * Reverts this fragment's attribute back to its last known remote value.\n   */\n  rollbackAttributes(this: PrivateReactiveResource): void {\n    const { path, resourceKey, store } = this[Context];\n\n    if (path) {\n      const oldValue = store.cache.getRemoteAttr(resourceKey, path) as Value;\n      store.cache.setAttr(resourceKey, path, oldValue);\n    }\n  }\n}\n\n/**\n * A schema extension that adds the {@link Fragment} API to migrated\n * `ModelFragments` object resources.\n *\n * @summary Legacy schema extension named `fragment` that adds the `Fragment` API to reactive objects migrated from\n * `ModelFragments`.\n */\nexport const FragmentExtension: {\n  /**\n   * This extension applies to `'object'` schemas.\n   */\n  kind: 'object';\n  /**\n   * The registered name of this extension.\n   */\n  name: 'fragment';\n  /**\n   * The features ({@link Fragment}) added by this extension.\n   */\n  features: typeof Fragment;\n} = {\n  kind: 'object' as const,\n  name: 'fragment' as const,\n  features: Fragment,\n} satisfies CAUTION_MEGA_DANGER_ZONE_Extension;\n\nexport default FragmentExtension;\n","import type ApplicationInstance from '@ember/application/instance';\n\nimport type { Store } from '@warp-drive/core';\nimport type { SchemaService } from '@warp-drive/core/types';\n\nimport FragmentArrayExtension from '../extensions/fragment-array.ts';\nimport FragmentExtension from '../extensions/fragment.ts';\n\n/**\n * Registers the {@link FragmentExtension}/{@link FragmentArrayExtension} schema\n * extensions on the given `SchemaService`, enabling ModelFragments migration support.\n *\n * @summary Legacy setup function that registers the fragment and fragment-array schema extensions on a\n * `SchemaService` to support migrating off ModelFragments.\n * @public\n */\nexport function registerFragmentExtensions(schema: SchemaService): void {\n  schema.CAUTION_MEGA_DANGER_ZONE_registerExtension?.(FragmentExtension);\n  schema.CAUTION_MEGA_DANGER_ZONE_registerExtension?.(FragmentArrayExtension);\n}\n\nexport function initialize(application: ApplicationInstance): void {\n  const store = application.lookup('service:store') as Store | undefined;\n\n  if (store) {\n    registerFragmentExtensions(store.schema);\n  } else {\n    // oxlint-disable-next-line no-console\n    console.warn(\n      'No store service was found, you will need to call `registerFragmentExtensions` manually in your app.'\n    );\n  }\n}\n\nexport default {\n  name: 'fragment-extensions',\n  // the cast is required for isolatedDeclarations to determine this default\n  // export's type without inference, even though it's a no-op for `tsc`'s checker\n  // oxlint-disable-next-line typescript/no-unnecessary-type-assertion\n  initialize: initialize as (application: ApplicationInstance) => void,\n};\n","import type { Store } from '@warp-drive/core';\nimport type { ModelSchema } from '@warp-drive/core/types';\nimport type { Value } from '@warp-drive/core/types/json/raw';\nimport type { TypedRecordInstance, TypeFromInstance } from '@warp-drive/core/types/record';\nimport type { LegacyAttributeField, LegacyRelationshipField } from '@warp-drive/core/types/schema/fields';\n\ntype KeyOrString<T> = keyof T & string extends never ? string : keyof T & string;\n\n// if modelFor turns out to be a bottleneck we should replace with a Map\n// and clear it during store teardown.\nconst AvailableShims = new WeakMap<Store, Record<string, ShimModelClass>>();\n\nexport function getShimClass<T>(\n  store: Store,\n  modelName: T extends TypedRecordInstance ? TypeFromInstance<T> : string\n): ShimModelClass<T> {\n  let shims = AvailableShims.get(store);\n\n  if (!shims) {\n    shims = Object.create(null) as Record<string, ShimModelClass>;\n    AvailableShims.set(store, shims);\n  }\n\n  let shim = shims[modelName];\n  if (shim === undefined) {\n    shim = shims[modelName] = new ShimModelClass<unknown>(store, modelName);\n  }\n\n  return shim;\n}\n\nconst AttributeKinds = ['field', 'attribute', 'object', 'array', 'schema-object', 'schema-array'] as const;\n\n// Mimics the static apis of @warp-drive/legacy/model\nexport class ShimModelClass<T = unknown> implements ModelSchema<T> {\n  declare __store: Store;\n  declare modelName: T extends TypedRecordInstance ? TypeFromInstance<T> : string;\n  constructor(store: Store, modelName: T extends TypedRecordInstance ? TypeFromInstance<T> : string) {\n    this.__store = store;\n    this.modelName = modelName;\n  }\n\n  get fields(): Map<KeyOrString<T>, 'attribute' | 'belongsTo' | 'hasMany'> {\n    const fields = new Map<KeyOrString<T>, 'attribute' | 'belongsTo' | 'hasMany'>();\n    const fieldSchemas = this.__store.schema.fields({ type: this.modelName });\n\n    fieldSchemas.forEach((schema, key) => {\n      // @ts-expect-error checking if a string is a valid string\n      if (AttributeKinds.includes(schema.kind)) {\n        fields.set(key as KeyOrString<T>, 'attribute');\n      } else if (schema.kind === 'belongsTo' || schema.kind === 'hasMany') {\n        fields.set(key as KeyOrString<T>, schema.kind);\n      }\n    });\n\n    return fields;\n  }\n\n  get attributes(): Map<KeyOrString<T>, LegacyAttributeField> {\n    const attrs = new Map<KeyOrString<T>, LegacyAttributeField>();\n    const fields = this.__store.schema.fields({ type: this.modelName });\n\n    fields.forEach((schema, key) => {\n      if (schema.kind === 'attribute') {\n        attrs.set(key as KeyOrString<T>, schema);\n        // @ts-expect-error checking if a string is a valid string\n      } else if (AttributeKinds.includes(schema.kind)) {\n        attrs.set(key as KeyOrString<T>, {\n          kind: 'attribute',\n          name: key,\n          type: null,\n          options: (schema.options ?? {}) as Record<string, Value>,\n        });\n      }\n    });\n\n    return attrs;\n  }\n\n  get relationshipsByName(): Map<KeyOrString<T>, LegacyRelationshipField> {\n    const rels = new Map<KeyOrString<T>, LegacyRelationshipField>();\n    const fields = this.__store.schema.fields({ type: this.modelName });\n\n    fields.forEach((schema, key) => {\n      if (schema.kind === 'belongsTo' || schema.kind === 'hasMany') {\n        rels.set(key as KeyOrString<T>, schema);\n      }\n    });\n\n    return rels;\n  }\n\n  eachAttribute<K extends KeyOrString<T>>(\n    callback: (key: K, attribute: LegacyAttributeField) => void,\n    binding?: T\n  ): void {\n    this.attributes.forEach((schema, key) => {\n      callback.call(binding, key as K, schema);\n    });\n  }\n\n  eachRelationship<K extends KeyOrString<T>>(\n    callback: (key: K, relationship: LegacyRelationshipField) => void,\n    binding?: T\n  ): void {\n    this.__store.schema.fields({ type: this.modelName }).forEach((schema, key) => {\n      if (schema.kind === 'belongsTo' || schema.kind === 'hasMany') {\n        callback.call(binding, key as K, schema);\n      }\n    });\n  }\n\n  eachTransformedAttribute<K extends KeyOrString<T>>(\n    callback: (key: K, type: string | null) => void,\n    binding?: T\n  ): void {\n    this.__store.schema.fields({ type: this.modelName }).forEach((schema, key) => {\n      if (schema.kind === 'attribute') {\n        const type = schema.type;\n        if (type) callback.call(binding, key as K, type);\n      }\n    });\n  }\n}\n\nexport function fragmentsModelFor<T extends TypedRecordInstance>(\n  this: Store,\n  modelName: T extends TypedRecordInstance ? TypeFromInstance<T> : string\n): ShimModelClass<T> {\n  return getShimClass(this, modelName);\n}\n\n/**\n * The `modelFor` fallback used to construct a `ShimModelClass` schema for a\n * type when ModelFragments support is enabled and no real `Model` subclass\n * is registered for that type.\n *\n * @summary Legacy `store.modelFor` fallback that returns a schema-backed `ShimModelClass` for a type when\n * ModelFragments support is on and no `Model` class exists.\n * @public\n */\nexport const modelFor: typeof fragmentsModelFor = fragmentsModelFor;\n"],"mappings":"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"}

package/dist/model-fragments.d.ts

@@ -1,4 +1,4 @@
-import { a as WithArrayLike, o as WithEmberObject } from "./extensions-DumNm4dA.js";
+import { a as WithArrayLike, o as WithEmberObject } from "./extensions-fwdnX9n4.js";
 import { Store } from "@warp-drive/core";
 import { PrivateReactiveResource } from "@warp-drive/core/reactive/-private";
 import { ModelSchema, SchemaService } from "@warp-drive/core/types";
@@ -11,6 +11,8 @@ import "@ember/application/instance";
  * Used as a helper to setup the relevant parts of an array
  * schema and add extensions etc.
  *
+ * @summary Legacy ModelFragments migration helper that builds an `array` schema field preconfigured with the
+ * `ember-object`, `ember-array-like`, and `fragment-array` extensions.
  * @param arrayName The name of the array
  * @param primitiveType The primitive type of items in the array (optional)
  * @returns The schema for an array
@@ -66,6 +68,8 @@ export declare function withArrayDefaults<ArrayName extends string, PrimitiveTyp
  * Used as a helper to setup the relevant parts of a fragment schema
  * and add extensions etc.
  *
+ * @summary Legacy ModelFragments migration helper that builds a `schema-object` field for a single `fragment:`
+ * type with the `ember-object` and `fragment` extensions.
  * @param fragmentType The type of the fragment
  * @param fragmentName The optional name of the fragment. If not provided, it will default to the fragmentType.
  * @returns The schema for a fragment
@@ -99,6 +103,8 @@ export declare function withFragmentDefaults<FragmentType extends string, Fragme
  * Used as a helper to setup the relevant parts of a fragment-array
  * schema and add extensions etc.
  *
+ * @summary Legacy ModelFragments migration helper that builds a `schema-array` field of `fragment:` items,
+ * defaulting to an empty array, with Ember and fragment-array extensions.
  * @param fragmentArrayType The type of the fragment-array
  * @param fragmentArrayName The name of the fragment-array
  * @returns The schema for a fragment-array
@@ -137,6 +143,8 @@ export declare function withFragmentArrayDefaults<FragmentArrayType extends stri
  * migrated from `Model`, applying the `ember-object` and `fragment` object
  * extensions and a default `@id` identity field.
  *
+ * @summary Legacy ModelFragments migration helper that completes a legacy resource schema with an `id` identity,
+ * `Model` defaults, and the `ember-object` and `fragment` extensions.
  * @param schema the partial legacy resource schema to complete
  * @returns the completed resource schema
  */
@@ -147,6 +155,8 @@ export declare function withLegacy(schema: WithPartial<LegacyResourceSchema, "le
  * Registers the {@link FragmentExtension}/{@link FragmentArrayExtension} schema
  * extensions on the given `SchemaService`, enabling ModelFragments migration support.
  *
+ * @summary Legacy setup function that registers the fragment and fragment-array schema extensions on a
+ * `SchemaService` to support migrating off ModelFragments.
  * @public
  */
 export declare function registerFragmentExtensions(schema: SchemaService): void;
@@ -170,6 +180,8 @@ declare function fragmentsModelFor<T extends TypedRecordInstance>(this: Store, m
  * type when ModelFragments support is enabled and no real `Model` subclass
  * is registered for that type.
  *
+ * @summary Legacy `store.modelFor` fallback that returns a schema-backed `ShimModelClass` for a type when
+ * ModelFragments support is on and no `Model` class exists.
  * @public
  */
 export declare const modelFor: typeof fragmentsModelFor;
@@ -178,6 +190,9 @@ export declare const modelFor: typeof fragmentsModelFor;
 /**
  * The features added to an object resource by {@link FragmentExtension}, providing
  * a subset of the legacy `ModelFragments` fragment API for migrated resources.
+ *
+ * @summary Legacy `ModelFragments`-compatible object API, such as `hasDirtyAttributes`, `isFragment`, and
+ * `rollbackAttributes`, for reactive objects migrated off fragments.
  */
 export declare class Fragment {
   /**
@@ -208,6 +223,9 @@ export declare class Fragment {
 /**
  * A schema extension that adds the {@link Fragment} API to migrated
  * `ModelFragments` object resources.
+ *
+ * @summary Legacy schema extension named `fragment` that adds the `Fragment` API to reactive objects migrated from
+ * `ModelFragments`.
  */
 export declare const FragmentExtension: {
   /**
@@ -228,6 +246,9 @@ export declare const FragmentExtension: {
 /**
  * The features added to an array resource by {@link FragmentArrayExtension}, providing
  * a subset of the legacy `ModelFragments` fragment-array API for migrated resources.
+ *
+ * @summary Legacy `ModelFragments`-compatible array API, such as `addFragment`, `removeFragment`, and
+ * `rollbackAttributes`, for reactive arrays migrated off fragments.
  */
 export declare class FragmentArray<T extends Fragment> {
   /**
@@ -262,6 +283,9 @@ export declare class FragmentArray<T extends Fragment> {
 /**
  * A schema extension that adds the {@link FragmentArray} API to migrated
  * `ModelFragments` array resources.
+ *
+ * @summary Legacy schema extension named `fragment-array` that adds the `FragmentArray` API to reactive arrays
+ * migrated from `ModelFragments`.
  */
 export declare const FragmentArrayExtension: {
   /**
@@ -282,11 +306,17 @@ export declare const FragmentArrayExtension: {
 /**
  * Adds the classic `EmberObject` API (via {@link WithEmberObject}) and the
  * {@link Fragment} API to the type of a migrated single-fragment resource.
+ *
+ * @summary Legacy type for a reactive object migrated from a `ModelFragments` fragment, adding the `EmberObject`
+ * and `Fragment` APIs to it.
  */
 type WithFragment<T> = T & WithEmberObject<T> & Fragment;
 /**
  * Adds Ember's classic array-like API (via {@link WithArrayLike}) and the
  * {@link FragmentArray} API to the type of a migrated fragment-array resource.
+ *
+ * @summary Legacy type for a reactive array migrated from a `ModelFragments` fragment array, adding Ember array
+ * methods and the `FragmentArray` API to it.
  */
 type WithFragmentArray<T extends Fragment> = T & WithArrayLike<T> & FragmentArray<T>;
 //#endregion

package/dist/model-fragments.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"model-fragments.d.ts","names":[],"sources":["../src/model-fragments/utilities/with-array-defaults.ts","../src/model-fragments/utilities/with-fragment-defaults.ts","../src/model-fragments/utilities/with-fragment-array-defaults.ts","../src/model-fragments/utilities/with-legacy.ts","../src/model-fragments/instance-initializers/fragment-extensions.ts","../src/model-fragments/hooks/model-for.ts","../src/model-fragments/extensions/fragment.ts","../src/model-fragments/extensions/fragment-array.ts","../src/model-fragments/index.ts"],"mappings":";;;;;;;;;;;;;;;;;wBAQgB,kBAAkB,0BAA0B,8BAC1D,WAAW,WACX,gBAAgB,gBACf;;;;EAKG;;;;EAIA,MAAM;;;;EAIN;;;;EAIA;;;;IAIE;;;;;;EAOF;;;;EAIA,MAAM;;;;EAIN,eAAe;;;;EAIf;;;;IAIE;;;;;;;;;;;;;wBC/CQ,qBAAqB,6BAA6B,6BAChE,cAAc,cACd,eAAe;;;;EAKf;;;;EAIA,kBAAkB;;;;EAIlB,MAAM,eAAe;;;;EAIrB;;;;IAIE;;;;;;;;;;;;;wBCrBY,0BAA0B,kCAAkC,kCAC1E,mBAAmB,mBACnB,oBAAoB;;;;EAKpB;;;;EAIA;;;;EAIA;;;;EAIA;;;;IAIE;;;;IAIA;;;;;;;;;;;;;wBCxBY,WAAW,QAAQ,YAAY,+CAA+C;;;;;;;;;wBCC9E,2BAA2B,QAAQ;;;KCR9C,YAAY,WAAW,0CAA0C;cA4BzD,eAAe,wBAAwB,YAAY;EAC9D,SAAiB;EACjB,WAAmB,UAAU,sBAAsB,iBAAiB;EACpE,YAAY,OAAO,OAAO,WAAW,UAAU,sBAAsB,iBAAiB;MAKlF,UAAU,IAAI,YAAY;MAgB1B,cAAc,IAAI,YAAY,IAAI;MAqBlC,uBAAuB,IAAI,YAAY,IAAI;EAa/C,cAAc,UAAU,YAAY,IAClC,WAAW,KAAK,GAAG,WAAW,+BAC9B,UAAU;EAOZ,iBAAiB,UAAU,YAAY,IACrC,WAAW,KAAK,GAAG,cAAc,kCACjC,UAAU;EASZ,yBAAyB,UAAU,YAAY,IAC7C,WAAW,KAAK,GAAG,8BACnB,UAAU;;iBAWE,kBAAkB,UAAU,qBAAA,MACpC,OACN,WAAW,UAAU,sBAAsB,iBAAiB,cAC3D,eAAe;;;;;;;;qBAWL,iBAAiB;;;;;;;qBC9HjB;;;;EAKX;;;;EAIA;;;;MAMI;;;;MAeA;;;;MAOA;;;;EAQJ,mBAAA,MAAyB;;;;;;qBAcd;;;;EAIX;;;;EAIA;;;;EAIA,iBAAiB;;;;;;;;qBCvEN,cAAc,UAAU;;;;EAKnC;;;;EAIA;;;;MAMI;;;;EAiBJ,YAAY,WAAW,IAAI;;;;EAW3B,eAAe,WAAW,IAAI;;;;EAW9B,eAAe,WAAW;;;;EAe1B;;;;;;qBAYW;;;;EAIX;;;;EAIA;;;;EAIA,iBAAiB;;;;;;;;KClGP,aAAa,KAAK,IAAI,gBAAgB,KAAK;;;;;KAK3C,kBAAkB,UAAU,YAAY,IAAI,cAAc,KAAK,cAAc"}
+{"version":3,"file":"model-fragments.d.ts","names":[],"sources":["../src/model-fragments/utilities/with-array-defaults.ts","../src/model-fragments/utilities/with-fragment-defaults.ts","../src/model-fragments/utilities/with-fragment-array-defaults.ts","../src/model-fragments/utilities/with-legacy.ts","../src/model-fragments/instance-initializers/fragment-extensions.ts","../src/model-fragments/hooks/model-for.ts","../src/model-fragments/extensions/fragment.ts","../src/model-fragments/extensions/fragment-array.ts","../src/model-fragments/index.ts"],"mappings":";;;;;;;;;;;;;;;;;;;wBAUgB,kBAAkB,0BAA0B,8BAC1D,WAAW,WACX,gBAAgB,gBACf;;;;EAKG;;;;EAIA,MAAM;;;;EAIN;;;;EAIA;;;;IAIE;;;;;;EAOF;;;;EAIA,MAAM;;;;EAIN,eAAe;;;;EAIf;;;;IAIE;;;;;;;;;;;;;;;wBC/CQ,qBAAqB,6BAA6B,6BAChE,cAAc,cACd,eAAe;;;;EAKf;;;;EAIA,kBAAkB;;;;EAIlB,MAAM,eAAe;;;;EAIrB;;;;IAIE;;;;;;;;;;;;;;;wBCrBY,0BAA0B,kCAAkC,kCAC1E,mBAAmB,mBACnB,oBAAoB;;;;EAKpB;;;;EAIA;;;;EAIA;;;;EAIA;;;;IAIE;;;;IAIA;;;;;;;;;;;;;;;wBCxBY,WAAW,QAAQ,YAAY,+CAA+C;;;;;;;;;;;wBCC9E,2BAA2B,QAAQ;;;KCV9C,YAAY,WAAW,0CAA0C;cA4BzD,eAAe,wBAAwB,YAAY;EAC9D,SAAiB;EACjB,WAAmB,UAAU,sBAAsB,iBAAiB;EACpE,YAAY,OAAO,OAAO,WAAW,UAAU,sBAAsB,iBAAiB;MAKlF,UAAU,IAAI,YAAY;MAgB1B,cAAc,IAAI,YAAY,IAAI;MAqBlC,uBAAuB,IAAI,YAAY,IAAI;EAa/C,cAAc,UAAU,YAAY,IAClC,WAAW,KAAK,GAAG,WAAW,+BAC9B,UAAU;EAOZ,iBAAiB,UAAU,YAAY,IACrC,WAAW,KAAK,GAAG,cAAc,kCACjC,UAAU;EASZ,yBAAyB,UAAU,YAAY,IAC7C,WAAW,KAAK,GAAG,8BACnB,UAAU;;iBAWE,kBAAkB,UAAU,qBAAA,MACpC,OACN,WAAW,UAAU,sBAAsB,iBAAiB,cAC3D,eAAe;;;;;;;;;;qBAaL,iBAAiB;;;;;;;;;;qBC7HjB;;;;EAKX;;;;EAIA;;;;MAMI;;;;MAeA;;;;MAOA;;;;EAQJ,mBAAA,MAAyB;;;;;;;;;qBAiBd;;;;EAIX;;;;EAIA;;;;EAIA,iBAAiB;;;;;;;;;;;qBC1EN,cAAc,UAAU;;;;EAKnC;;;;EAIA;;;;MAMI;;;;EAiBJ,YAAY,WAAW,IAAI;;;;EAW3B,eAAe,WAAW,IAAI;;;;EAW9B,eAAe,WAAW;;;;EAe1B;;;;;;;;;qBAeW;;;;EAIX;;;;EAIA;;;;EAIA,iBAAiB;;;;;;;;;;;KCrGP,aAAa,KAAK,IAAI,gBAAgB,KAAK;;;;;;;;KAQ3C,kBAAkB,UAAU,YAAY,IAAI,cAAc,KAAK,cAAc"}

package/dist/model-fragments.js

@@ -1,3 +1,3 @@
-import { a as FragmentExtension, c as withLegacy, d as withArrayDefaults, i as Fragment, l as withFragmentArrayDefaults, n as modelFor, o as FragmentArray, r as registerFragmentExtensions, s as FragmentArrayExtension, u as withFragmentDefaults } from "./model-fragments-DSqu0ptR.js";
+import { a as FragmentExtension, c as withLegacy, d as withArrayDefaults, i as Fragment, l as withFragmentArrayDefaults, n as modelFor, o as FragmentArray, r as registerFragmentExtensions, s as FragmentArrayExtension, u as withFragmentDefaults } from "./model-fragments-ZM4k_mT3.js";
 
 export { Fragment, FragmentArray, FragmentArrayExtension, FragmentExtension, modelFor, registerFragmentExtensions, withArrayDefaults, withFragmentArrayDefaults, withFragmentDefaults, withLegacy };

package/dist/model.d.ts

@@ -1,4 +1,4 @@
-import { S as belongsTo, b as RelationshipDecorator, m as PromiseBelongsTo, r as restoreDeprecatedModelRequestBehaviors, t as Model, v as PromiseManyArray, x as RelationshipOptions, y as NoNull } from "./model-62hn5_PD.js";
+import { S as belongsTo, b as RelationshipDecorator, m as PromiseBelongsTo, r as restoreDeprecatedModelRequestBehaviors, t as Model, v as PromiseManyArray, x as RelationshipOptions, y as NoNull } from "./model-BPVLf-rp.js";
 import { Store } from "@warp-drive/core";
 import { RelatedCollection as HasMany, RelatedCollection as ManyArray, Store as Store$1 } from "@warp-drive/core/store/-private";
 import { TransformName } from "@warp-drive/core/types/symbols";
@@ -182,6 +182,8 @@ return new this();
 }
 ```
 
+@summary Legacy `Model` decorator that declares an attribute field, optionally converted by a named transform and
+given a `defaultValue`.
 @public
 @param type the attribute type
 @param options a hash of options
@@ -347,6 +349,8 @@ Polymorphic to polymorphic relationships are supported. Both sides of the relati
 must be declared as polymorphic, and the `as` option must be used to declare the abstract
 type each record satisfies on both sides.
 
+@summary Legacy `Model` decorator that declares a to-many relationship to another resource type, configured with
+required `async` and `inverse` options.
 @public
 @param type the name of the related resource
 @param options a hash of options
@@ -362,6 +366,8 @@ export declare function hasMany(type: string, options: RelationshipOptions<unkno
  * this to your store's `instantiateRecord` method when configuring the
  * store to use `Model` for schema/record instantiation.
  *
+ * @summary Legacy store hook that creates a `Model` instance for a resource key using the `Model` class registered
+ * for its type.
  * @public
  */
 export declare function instantiateRecord(this: Store$1, identifier: ResourceKey$1, createRecordArgs?: {
@@ -372,6 +378,7 @@ export declare function instantiateRecord(this: Store$1, identifier: ResourceKey
  * to your store's `teardownRecord` method when configuring the store to
  * use `Model` for schema/record instantiation.
  *
+ * @summary Legacy store hook that destroys a `Model` instance when the store releases its record.
  * @public
  */
 export declare function teardownRecord(record: Model): void;
@@ -380,6 +387,8 @@ export declare function teardownRecord(record: Model): void;
  * as `store.modelFor(type)` when the store is configured to use `Model`.
  * Returns the `Model` subclass registered for the given type, if any.
  *
+ * @summary Legacy `store.modelFor` implementation that returns the `Model` class registered for a resource type, if
+ * there is one.
  * @public
  */
 export declare function modelFor<T>(type: TypeFromInstance<T>): typeof Model | void;
@@ -396,6 +405,8 @@ export declare function modelFor(type: string): typeof Model | void;
  * the result of this to your store's `createSchemaService` method when
  * configuring the store to use `Model` for schema information.
  *
+ * @summary Legacy factory for a schema service that reads resource schemas from an app's `Model` classes, returned from
+ * the store's `createSchemaService` hook.
  * @public
  */
 export declare function buildSchema(store: Store): SchemaService;

package/dist/model.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"model.d.ts","names":[],"sources":["../src/model/-private/util.ts","../src/model/-private/attr.ts","../src/model/-private/has-many.ts","../src/model/-private/hooks.ts","../src/model/-private/schema-provider.ts"],"mappings":";;;;;;;;;;;KAKY,+BAA+B;EAAuB;;;;;;;;;;;;;;;;;;;;;;;;;;;KC+BtD,YAAY,KAAK;;;;;;;;;;;EAW3B,eAAe,WAAW,iBAAiB,WAAW;;;;;;;;;;;;;;;;;;;;;EAsBtD;;KA8EG,uBAAuB,GAAG,KAAK;;;;;EAOlC,YAAY,OAAO,GAAG,iBAAiB;;;;;EAOvC,cAAc,OAAO,KAAK,iBAAiB;GAE1C,gBAAgB;;KAEP;GAAsB;;KAEtB,uBAAuB,GAAG,oBAClC,uBAAuB,WAAW,KAClC,uBAAuB,WAAW,KAClC,uBAAuB,YAAY,KACnC,uBAAuB,SAAS,KAChC,uBAAuB,GAAG,aAAa,KACvC,uBAAuB,GAAG,YAAY,KACtC,uBAAuB,kBAAkB,KACzC,uBAAuB,kBAAkB,KACzC,uBAAuB,mBAAmB,KAC1C,uBAAuB,GAAG,oBAAoB,KAC9C,uBAAuB,GAAG,mBAAmB;KAIrC,yBAAyB,KAAK;EAAY,iBAAiB;IACnE,WAAW;KAGH,mBAAiB,KAAK,UAAU,mBAAmB,SAAS;KAG5D,oBAAoB,KAC9B,mBAAiB,2BAEb,yBAAyB,2BAEvB,UAAU,uBAAuB,yBAAyB,IAAI,mBAAiB,MAC7E,WAAW,uBAAuB,WAAW,qBAAqB,YAAY,WAAW;;;;;;;KASvF,iBAAiB,gBAAgB,aAAa,OAAO;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;wBAwFjD,QAAQ;wBACR,KAAK,GAAG,MAAM,mBAAiB,KAAK;wBACpC,KAAK,eAAe;wBACpB,KAAK,SAAS,cAAc;wBAC5B,KAAK,GAAG,MAAM,mBAAiB,IAAI,UAAU,oBAAoB,KAAK;wBACtE,KAAK,cAAc,UAAU,uBAAuB;wBACpD,KAAK,gBAAgB,sBAAsB,OAAO;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;wBC9ClD;wBACA,QAAQ;wBACR,QAAQ,GACtB,MAAM,iBAAiB,OAAO,KAC9B,SAAS,oBAAoB,cAC5B,sBAAsB;wBAKT,QAAQ,cAAc,SAAS,wCAAwC;;;;;;;;;;wBClPvE,kBAAA,MACR,SACN,YAAY,eACZ;;IACC;;;;;;;;wBA+Ba,eAAe,QAAQ;;;;;;;;wBAevB,SAAS,GAAG,MAAM,iBAAiB,YAAY;;;;;;wBAM/C,SAAS,sBAAsB;;;;;;;;;;wBCqM/B,YAAY,OAAO,QAAQ"}
+{"version":3,"file":"model.d.ts","names":["TypeFromInstance","Store","ResourceKey"],"sources":["../src/model/-private/util.ts","../src/model/-private/attr.ts","../src/model/-private/has-many.ts","../src/model/-private/hooks.ts","../src/model/-private/schema-provider.ts"],"mappings":";;;;;;;;;;;KAKY,+BAA+B;EAAuB;;;;;;;;;;;;;;;;;;;;;;;;;;;KC+BtD,YAAY,KAAK;;;;;;;;;;;EAW3B,eAAe,WAAW,iBAAiB,WAAW;;;;;;;;;;;;;;;;;;;;;EAsBtD;;KA8EG,uBAAuB,GAAG,KAAK;;;;;EAOlC,YAAY,OAAO,GAAG,iBAAiB;;;;;EAOvC,cAAc,OAAO,KAAK,iBAAiB;GAE1C,gBAAgB;;KAEP;GAAsB;;KAEtB,uBAAuB,GAAG,oBAClC,uBAAuB,WAAW,KAClC,uBAAuB,WAAW,KAClC,uBAAuB,YAAY,KACnC,uBAAuB,SAAS,KAChC,uBAAuB,GAAG,aAAa,KACvC,uBAAuB,GAAG,YAAY,KACtC,uBAAuB,kBAAkB,KACzC,uBAAuB,kBAAkB,KACzC,uBAAuB,mBAAmB,KAC1C,uBAAuB,GAAG,oBAAoB,KAC9C,uBAAuB,GAAG,mBAAmB;KAIrC,yBAAyB,KAAK;EAAY,iBAAiB;IACnE,WAAW;KAGHA,mBAAiB,KAAK,UAAU,mBAAmB,SAAS;KAG5D,oBAAoB,KAC9BA,mBAAiB,2BAEb,yBAAyB,2BAEvB,UAAU,uBAAuB,yBAAyB,IAAIA,mBAAiB,MAC7E,WAAW,uBAAuB,WAAW,qBAAqB,YAAY,WAAW;;;;;;;KASvF,iBAAiB,gBAAgB,aAAa,OAAO;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;wBA0FjD,QAAQ;wBACR,KAAK,GAAG,MAAMA,mBAAiB,KAAK;wBACpC,KAAK,eAAe;wBACpB,KAAK,SAAS,cAAc;wBAC5B,KAAK,GAAG,MAAMA,mBAAiB,IAAI,UAAU,oBAAoB,KAAK;wBACtE,KAAK,cAAc,UAAU,uBAAuB;wBACpD,KAAK,gBAAgB,sBAAsB,OAAO;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;wBC9ClD;wBACA,QAAQ;wBACR,QAAQ,GACtB,MAAM,iBAAiB,OAAO,KAC9B,SAAS,oBAAoB,cAC5B,sBAAsB;wBAKT,QAAQ,cAAc,SAAS,wCAAwC;;;;;;;;;;;;wBClPvE,kBAAA,MACRC,SACN,YAAYC,eACZ;;IACC;;;;;;;;;wBAgCa,eAAe,QAAQ;;;;;;;;;;wBAiBvB,SAAS,GAAG,MAAM,iBAAiB,YAAY;;;;;;wBAM/C,SAAS,sBAAsB;;;;;;;;;;;;wBCkM/B,YAAY,OAAO,QAAQ"}

package/dist/model.js

@@ -1,4 +1,4 @@
-import { a as belongsTo, i as hasMany, n as modelFor, o as attr, r as teardownRecord, t as instantiateRecord } from "./model-C9l1mRs6.js";
-import { i as restoreDeprecatedModelRequestBehaviors, r as Model, t as buildSchema } from "./schema-provider-waPfuoKq.js";
+import { a as belongsTo, i as hasMany, n as modelFor, o as attr, r as teardownRecord, t as instantiateRecord } from "./model-DdlhdL9V.js";
+import { i as restoreDeprecatedModelRequestBehaviors, r as Model, t as buildSchema } from "./schema-provider-Dyjpau2P.js";
 
 export { Model, Model as default, attr, belongsTo, buildSchema, hasMany, instantiateRecord, modelFor, restoreDeprecatedModelRequestBehaviors, teardownRecord };

package/dist/{rest-0NhtexIq.d.ts → rest-ddU-K5eS.d.ts}

@@ -1,6 +1,6 @@
-import { _ as AdapterPayload, m as Snapshot, p as SnapshotRecordArray } from "./compat-BbNNmTM-.js";
-import { r as MixtBuildURLMixin, t as Adapter } from "./adapter-CARrK3-8.js";
-import { n as AdapterError } from "./error-CzkyXr1Q.js";
+import { _ as AdapterPayload, m as Snapshot, p as SnapshotRecordArray } from "./compat-BZlQ-5eI.js";
+import { r as MixtBuildURLMixin, t as Adapter } from "./adapter-D3A8ixjz.js";
+import { n as AdapterError } from "./error-Ba1cMaWG.js";
 import { Store } from "@warp-drive/core";
 import { HTTPMethod } from "@warp-drive/core/types/request";
 import Mixin from "@ember/object/mixin";
@@ -21,6 +21,9 @@ type Payload = Error | Record<string, unknown> | unknown[] | string | undefined;
 /**
  * The query params built by {@link RESTAdapter.buildQuery | buildQuery} for a
  * `findAll`/`findRecord` request.
+ *
+ * @summary Query params the legacy `RESTAdapter.buildQuery` adds to `findRecord` and `findAll` URLs, such as the
+ * `include` paths to sideload.
  */
 type QueryState = {
   /**
@@ -34,6 +37,9 @@ type QueryState = {
 };
 /**
  * The options passed to the native `fetch` API by {@link RESTAdapter._fetchRequest | _fetchRequest}.
+ *
+ * @summary `fetch` options plus `url`, `method`, and `type` that the legacy `RESTAdapter` builds for a request sent
+ * with the native `fetch` API.
  */
 interface FetchRequestInit extends RequestInit {
   /**
@@ -51,6 +57,9 @@ interface FetchRequestInit extends RequestInit {
 }
 /**
  * The options passed to jQuery's `$.ajax` by {@link RESTAdapter._ajaxRequest | _ajaxRequest}.
+ *
+ * @summary jQuery `$.ajax` settings plus `url`, `method`, and `type` that the legacy `RESTAdapter` builds when it
+ * sends a request through jQuery.
  */
 interface JQueryRequestInit extends JQueryAjaxSettings {
   /**
@@ -69,6 +78,9 @@ interface JQueryRequestInit extends JQueryAjaxSettings {
 /**
  * A minimal description of an in-flight request, used for building
  * error messages when a request fails.
+ *
+ * @summary The url and HTTP method of a legacy `RESTAdapter` request, used to build error messages when that request
+ * fails.
  */
 type RequestData = {
   /**
@@ -302,6 +314,8 @@ return {
 }
 ```
 
+@summary Legacy adapter that exchanges conventional REST-style JSON with an HTTP server, building URLs from model
+names and ids.
 @public
 */
 declare class RESTAdapter extends AdapterWithBuildURLMixin {
@@ -813,4 +827,4 @@ interface RESTAdapter extends MixtBuildURLMixin {}
 declare function fetchOptions(options: JQueryRequestInit & Partial<FetchRequestInit>, adapter: RESTAdapter): FetchRequestInit;
 //#endregion
 export { RequestData as a, RESTAdapter as i, JQueryRequestInit as n, fetchOptions as o, QueryState as r, FetchRequestInit as t };
-//# sourceMappingURL=rest-0NhtexIq.d.ts.map
+//# sourceMappingURL=rest-ddU-K5eS.d.ts.map

package/dist/rest-ddU-K5eS.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"rest-ddU-K5eS.d.ts","names":[],"sources":["../src/adapter/-private/fastboot-interface.ts","../src/adapter/rest.ts"],"mappings":"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"}

package/dist/{schema-provider-waPfuoKq.js → schema-provider-Dyjpau2P.js}

@@ -1,6 +1,6 @@
 import { n as FetchManager, t as upgradeStore } from "./-private-BE7RaJCw.js";
 import { n as normalizeModelName } from "./util-Bnx8nm-D.js";
-import { i as releaseLegacySupport, n as LEGACY_SUPPORT, r as lookupLegacySupport, t as Errors } from "./errors-BlrR6--x.js";
+import { i as releaseLegacySupport, n as LEGACY_SUPPORT, r as lookupLegacySupport, t as Errors } from "./errors-BI0Xugyo.js";
 import { n as decorateMethodV2 } from "./runtime--fcdnjmJ-DMTJ0Kb3.js";
 import { recordIdentifierFor, storeFor } from "@warp-drive/core";
 import { getOwner } from "@ember/application";
@@ -48,7 +48,7 @@ function reload(options = {}) {
 			id: "warp-drive:deprecate-legacy-request-methods",
 			until: "6.0",
 			for: "@warp-drive/core",
-			url: "https://docs.warp-drive.io/api/@warp-drive/core/build-config/deprecations/variables/ENABLE_LEGACY_REQUEST_METHODS",
+			url: "https://warp-drive.io/api/@warp-drive/core/build-config/deprecations/variables/ENABLE_LEGACY_REQUEST_METHODS",
 			since: {
 				enabled: "5.7",
 				available: "5.7"
@@ -98,7 +98,7 @@ function save(options) {
 			id: "warp-drive:deprecate-legacy-request-methods",
 			until: "6.0",
 			for: "@warp-drive/core",
-			url: "https://docs.warp-drive.io/api/@warp-drive/core/build-config/deprecations/variables/ENABLE_LEGACY_REQUEST_METHODS",
+			url: "https://warp-drive.io/api/@warp-drive/core/build-config/deprecations/variables/ENABLE_LEGACY_REQUEST_METHODS",
 			since: {
 				enabled: "5.7",
 				available: "5.7"
@@ -128,7 +128,7 @@ function destroyRecord(options) {
 			id: "warp-drive:deprecate-legacy-request-methods",
 			until: "6.0",
 			for: "@warp-drive/core",
-			url: "https://docs.warp-drive.io/api/@warp-drive/core/build-config/deprecations/variables/ENABLE_LEGACY_REQUEST_METHODS",
+			url: "https://warp-drive.io/api/@warp-drive/core/build-config/deprecations/variables/ENABLE_LEGACY_REQUEST_METHODS",
 			since: {
 				enabled: "5.7",
 				available: "5.7"
@@ -571,6 +571,8 @@ function computeOnce(target, propertyName, desc) {
 * the class to use as the reactive object for data of resource
 * of that type.
 *
+* @summary Legacy base class whose subclasses both define a resource type's schema with `attr`, `belongsTo` and
+* `hasMany` and serve as its reactive record.
 * @public
 * @noInheritDoc
 * @hideconstructor
@@ -1636,7 +1638,7 @@ defineGate(Model.prototype, "isReloading", {
 			id: "warp-drive:deprecate-legacy-request-methods",
 			until: "6.0",
 			for: "@warp-drive/core",
-			url: "https://docs.warp-drive.io/api/@warp-drive/core/build-config/deprecations/variables/ENABLE_LEGACY_REQUEST_METHODS",
+			url: "https://warp-drive.io/api/@warp-drive/core/build-config/deprecations/variables/ENABLE_LEGACY_REQUEST_METHODS",
 			since: {
 				enabled: "5.7",
 				available: "5.7"
@@ -1655,6 +1657,9 @@ defineGate(Model.prototype, "isReloading", {
 * `destroyRecord`, and `reload` onto the given `Model` subclass, for
 * apps that have not yet migrated off of the deprecated
 * `ENABLE_LEGACY_REQUEST_METHODS` behaviors.
+*
+* @summary Legacy opt-in that restores the pre-`RequestManager` `save`, `destroyRecord`, `reload`, and `isReloading`
+* onto a `Model` class without deprecation warnings.
 */
 function restoreDeprecatedModelRequestBehaviors(ModelKlass) {
 	ModelKlass.prototype.save = _save;
@@ -1898,6 +1903,8 @@ if (macroCondition(getGlobalConfig().WarpDrive.deprecations.ENABLE_LEGACY_SCHEMA
 * the result of this to your store's `createSchemaService` method when
 * configuring the store to use `Model` for schema information.
 *
+* @summary Legacy factory for a schema service that reads resource schemas from an app's `Model` classes, returned from
+* the store's `createSchemaService` hook.
 * @public
 */
 function buildSchema(store) {
@@ -1922,4 +1929,4 @@ function getModelFactory(store, type) {
 
 //#endregion
 export { save as _, RecordState as a, _save as c, createSnapshot as d, deleteRecord as f, rollbackAttributes as g, reload as h, restoreDeprecatedModelRequestBehaviors as i, belongsTo as l, hasMany as m, getModelFactory as n, _destroyRecord as o, destroyRecord as p, Model as r, _reload as s, buildSchema as t, changedAttributes as u, serialize as v, unloadRecord as y };
-//# sourceMappingURL=schema-provider-waPfuoKq.js.map
+//# sourceMappingURL=schema-provider-Dyjpau2P.js.map