npm - velocious - Versions diffs - 1.0.577 → 1.0.579 - Mend

velocious 1.0.577 → 1.0.579

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.

Files changed (1676) hide show

package/src/testing/expect.js CHANGED Viewed

@@ -14,7 +14,7 @@ import {
 export default class Expect extends BaseExpect {
   /**
    * Runs constructor.
-   * @param {?} object - Object.
+   * @param {ReturnType<typeof JSON.parse>} object - Object.
    */
   constructor(object) {
     super()
@@ -28,7 +28,7 @@ export default class Expect extends BaseExpect {
   /**
    * Runs and change.
-   * @param {function(): Promise<number>} changeCallback - Change callback.
+   * @param {() => Promise<number>} changeCallback - Change callback.
    * @returns {ExpectToChange} - The and change.
    */
   andChange(changeCallback) {
@@ -47,7 +47,7 @@ export default class Expect extends BaseExpect {
   /**
    * Runs to be.
-   * @param {?} result - Result.
+   * @param {ReturnType<typeof JSON.parse>} result - Result.
    * @returns {void} - No return value.
    */
   toBe(result) {
@@ -261,7 +261,7 @@ export default class Expect extends BaseExpect {
   /**
    * Runs to be instance of.
-   * @param {new (...args: Array<?>) => ?} klass - Class constructor to check against (e.g. a built-in like Error).
+   * @param {new (...args: Array<ReturnType<typeof JSON.parse>>) => ReturnType<typeof JSON.parse>} klass - Class constructor to check against (e.g. a built-in like Error).
    * @returns {void} - No return value.
    */
   toBeInstanceOf(klass) {
@@ -324,7 +324,7 @@ export default class Expect extends BaseExpect {
   /**
    * Runs to change.
-   * @param {function(): Promise<number>} changeCallback - Change callback.
+   * @param {() => Promise<number>} changeCallback - Change callback.
    * @returns {ExpectToChange} - The change.
    */
   toChange(changeCallback) {
@@ -339,7 +339,7 @@ export default class Expect extends BaseExpect {
   /**
    * Runs to contain.
-   * @param {?} valueToContain - Value to contain.
+   * @param {ReturnType<typeof JSON.parse>} valueToContain - Value to contain.
    * @returns {void} - No return value.
    */
   toContain(valueToContain) {
@@ -382,7 +382,7 @@ export default class Expect extends BaseExpect {
   /**
    * Runs to contain equal.
-   * @param {?} valueToContain - Value to contain.
+   * @param {ReturnType<typeof JSON.parse>} valueToContain - Value to contain.
    * @returns {void} - No return value.
    */
   toContainEqual(valueToContain) {
@@ -407,7 +407,7 @@ export default class Expect extends BaseExpect {
   /**
    * Runs to include.
-   * @param {?} valueToInclude - Value to include.
+   * @param {ReturnType<typeof JSON.parse>} valueToInclude - Value to include.
    * @returns {void} - No return value.
    */
   toInclude(valueToInclude) {
@@ -416,7 +416,7 @@ export default class Expect extends BaseExpect {
   /**
    * Runs to equal.
-   * @param {?} result - Result.
+   * @param {ReturnType<typeof JSON.parse>} result - Result.
    * @returns {void} - No return value.
    */
   toEqual(result) {
@@ -454,7 +454,7 @@ export default class Expect extends BaseExpect {
     }
     if (isObjectContaining(result)) {
-      const expectedValue = /** @type {?} */ (result).value
+      const expectedValue = /** @type {ReturnType<typeof JSON.parse>} */ (result).value
       const {matches, differences} = matchObject(this._object, expectedValue)
       const objectPrint = formatValue(this._object)
       const expectedPrint = formatValue(expectedValue)
@@ -473,7 +473,7 @@ export default class Expect extends BaseExpect {
     }
     if (isArrayContaining(result)) {
-      const expectedValue = /** @type {Array<?>} */ (/** @type {?} */ (result).value)
+      const expectedValue = /** @type {Array<ReturnType<typeof JSON.parse>>} */ (/** @type {ReturnType<typeof JSON.parse>} */ (result).value)
       const {matches, differences} = matchArrayContaining(this._object, expectedValue)
       const objectPrint = formatValue(this._object)
       const expectedPrint = formatValue(expectedValue)
@@ -569,7 +569,7 @@ export default class Expect extends BaseExpect {
   /**
    * Runs to match object.
-   * @param {Record<string, ?> | Array<?>} expected - Expected partial object.
+   * @param {Record<string, ReturnType<typeof JSON.parse>> | Array<ReturnType<typeof JSON.parse>>} expected - Expected partial object.
    * @returns {void} - No return value.
    */
   toMatchObject(expected) {
@@ -640,7 +640,7 @@ export default class Expect extends BaseExpect {
   /**
    * Runs to throw.
-   * @param {string|RegExp|Error|((new (...args: Array<?>) => Error))} [expected] - Expected error.
+   * @param {string|RegExp|Error|((new (...args: Array<ReturnType<typeof JSON.parse>>) => Error))} [expected] - Expected error.
    * @returns {Promise<void>} - Resolves when complete.
    */
   async toThrow(expected) {
@@ -705,7 +705,7 @@ export default class Expect extends BaseExpect {
   /**
    * Runs execute.
-   * @returns {Promise<?>} - Resolves with the execute.
+   * @returns {Promise<ReturnType<typeof JSON.parse>>} - Resolves with the execute.
    */
   async execute() {
     for (const expectation of this.expectations) {
@@ -731,7 +731,7 @@ export default class Expect extends BaseExpect {
   /**
    * Runs to have attributes.
-   * @param {Record<string, ?>} result - Result.
+   * @param {Record<string, ReturnType<typeof JSON.parse>>} result - Result.
    * @returns {void} - No return value.
    */
   toHaveAttributes(result) {
@@ -739,16 +739,16 @@ export default class Expect extends BaseExpect {
     /**
      * Differences.
-     * @type {Record<string, Array<?>>} */
+     * @type {Record<string, Array<ReturnType<typeof JSON.parse>>>} */
     const differences = {}
-    const objectAsRecord = /** @type {Record<string, ?>} */ (this._object)
+    const objectAsRecord = /** @type {Record<string, ReturnType<typeof JSON.parse>>} */ (this._object)
     for (const key in result) {
       const value = result[key]
       if (!(key in objectAsRecord)) throw new Error(`${this._object.constructor.name} doesn't respond to ${key}`)
-      const objectValue = /** @type {() => ?} */ (objectAsRecord[key])()
+      const objectValue = /** @type {() => ReturnType<typeof JSON.parse>} */ (objectAsRecord[key])()
       if (value != objectValue) {
         differences[key] = [value, objectValue]

package/src/testing/factory/association-declaration.js CHANGED Viewed

@@ -15,7 +15,7 @@ export default class AssociationDeclaration {
    * @param {string} args.name - Relationship name on the owning model.
    * @param {string} [args.factory] - Factory name to run. Defaults to the relationship name.
    * @param {string[]} [args.traits] - Traits passed to the association factory.
-   * @param {Record<string, ?>} [args.overrides] - Overrides passed to the association factory.
+   * @param {Record<string, ReturnType<typeof JSON.parse>>} [args.overrides] - Overrides passed to the association factory.
    * @param {"build" | "create" | undefined} [args.strategy] - Explicit strategy override.
    */
   constructor({name, factory, traits = [], overrides = {}, strategy}) {
@@ -39,7 +39,7 @@ export default class AssociationDeclaration {
     /** @type {string[]} - Traits passed to the association factory. */
     this.traits = traits
-    /** @type {Record<string, ?>} - Overrides passed to the association factory. */
+    /** @type {Record<string, ReturnType<typeof JSON.parse>>} - Overrides passed to the association factory. */
     this.overrides = overrides
     /** @type {"build" | "create" | undefined} - Explicit strategy override. */

package/src/testing/factory/declarations.js CHANGED Viewed

@@ -7,7 +7,7 @@
  * @property {"attribute"} kind - Discriminant.
  * @property {string} name - Attribute name.
  * @property {boolean} isTransient - Whether the value is transient (never assigned/returned).
- * @property {?} value - Literal value or lazy `(context) => value` function.
+ * @property {ReturnType<typeof JSON.parse>} value - Literal value or lazy `(context) => value` function.
  */
 /**
@@ -16,7 +16,7 @@
  * @typedef {object} CallbackDeclaration
  * @property {"callback"} kind - Discriminant.
  * @property {string} event - One of the supported callback events.
- * @property {(args: {record: ?, context: ?, strategy: string}) => (void | Promise<void>)} fn - Callback body.
+ * @property {(args: {record: ReturnType<typeof JSON.parse>, context: ReturnType<typeof JSON.parse>, strategy: string}) => (void | Promise<void>)} fn - Callback body.
  */
 /**
@@ -31,14 +31,14 @@
  * A custom-constructor declaration.
  * @typedef {object} InitializeWithDeclaration
  * @property {"initializeWith"} kind - Discriminant.
- * @property {(args: {attributes: Record<string, ?>, context: ?, get: (name: string) => ?}) => (? | Promise<?>)} fn - Constructor body.
+ * @property {(args: {attributes: Record<string, ReturnType<typeof JSON.parse>>, context: ReturnType<typeof JSON.parse>, get: (name: string) => ReturnType<typeof JSON.parse>}) => (ReturnType<typeof JSON.parse> | Promise<ReturnType<typeof JSON.parse>>)} fn - Constructor body.
  */
 /**
  * A custom-persistence declaration.
  * @typedef {object} ToCreateDeclaration
  * @property {"toCreate"} kind - Discriminant.
- * @property {(args: {record: ?, context: ?}) => (void | Promise<void>)} fn - Persistence body.
+ * @property {(args: {record: ReturnType<typeof JSON.parse>, context: ReturnType<typeof JSON.parse>}) => (void | Promise<void>)} fn - Persistence body.
  */
 /**
@@ -56,7 +56,7 @@
 /**
  * Creates a literal/lazy attribute declaration.
  * @param {string} name - Attribute name.
- * @param {?} value - Literal value or lazy function.
+ * @param {ReturnType<typeof JSON.parse>} value - Literal value or lazy function.
  * @param {boolean} isTransient - Whether the declaration is transient.
  * @returns {AttributeDeclaration} - The frozen declaration.
  */

package/src/testing/factory/definition-builder.js CHANGED Viewed

@@ -52,13 +52,13 @@ function assertName(name, what) {
  * leading strings are traits and a trailing plain object supplies factory/strategy
  * plus overrides.
  * @param {string} name - Relationship name.
- * @param {Array<?>} args - Remaining arguments.
+ * @param {Array<ReturnType<typeof JSON.parse>>} args - Remaining arguments.
  * @returns {AssociationDeclaration} - The declaration.
  */
 function buildAssociationDeclaration(name, args) {
   /** @type {string[]} */
   const traits = []
-  /** @type {Record<string, ?>} */
+  /** @type {Record<string, ReturnType<typeof JSON.parse>>} */
   let options = {}
   for (const arg of args) {
@@ -79,7 +79,7 @@ function buildAssociationDeclaration(name, args) {
 /**
  * Parses the polymorphic `sequence(name, ...)` argument forms into a Sequence.
  * @param {string} name - Sequence name.
- * @param {Array<?>} args - Remaining arguments (initial/options and/or formatter).
+ * @param {Array<ReturnType<typeof JSON.parse>>} args - Remaining arguments (initial/options and/or formatter).
  * @returns {Sequence} - The constructed sequence.
  */
 function buildSequence(name, args) {
@@ -121,7 +121,7 @@ class DeclarationCollector {
   /**
    * Records a literal/lazy attribute.
    * @param {string} name - Attribute name.
-   * @param {?} value - Literal value or lazy function.
+   * @param {ReturnType<typeof JSON.parse>} value - Literal value or lazy function.
    * @returns {void}
    */
   attribute(name, value) {
@@ -132,7 +132,7 @@ class DeclarationCollector {
   /**
    * Records a transient attribute.
    * @param {string} name - Transient name.
-   * @param {?} value - Literal value or lazy function.
+   * @param {ReturnType<typeof JSON.parse>} value - Literal value or lazy function.
    * @returns {void}
    */
   transient(name, value) {
@@ -143,7 +143,7 @@ class DeclarationCollector {
   /**
    * Records an association.
    * @param {string} name - Relationship name.
-   * @param {Array<?>} args - Traits and/or an options object.
+   * @param {Array<ReturnType<typeof JSON.parse>>} args - Traits and/or an options object.
    * @returns {void}
    */
   association(name, ...args) {
@@ -213,13 +213,13 @@ function compileTrait(name, callback) {
   const collector = new DeclarationCollector()
   const builder = {
-    attribute: (/** @type {string} */ attrName, /** @type {?} */ value) => collector.attribute(attrName, value),
-    transient: (/** @type {string} */ attrName, /** @type {?} */ value) => collector.transient(attrName, value),
-    association: (/** @type {string} */ assocName, /** @type {Array<?>} */ ...args) => collector.association(assocName, ...args),
-    before: (/** @type {string} */ phase, /** @type {?} */ fn) => collector.before(phase, fn),
-    after: (/** @type {string} */ phase, /** @type {?} */ fn) => collector.after(phase, fn),
-    initializeWith: (/** @type {?} */ fn) => collector.initializeWith(fn),
-    toCreate: (/** @type {?} */ fn) => collector.toCreate(fn),
+    attribute: (/** @type {string} */ attrName, /** @type {ReturnType<typeof JSON.parse>} */ value) => collector.attribute(attrName, value),
+    transient: (/** @type {string} */ attrName, /** @type {ReturnType<typeof JSON.parse>} */ value) => collector.transient(attrName, value),
+    association: (/** @type {string} */ assocName, /** @type {Array<ReturnType<typeof JSON.parse>>} */ ...args) => collector.association(assocName, ...args),
+    before: (/** @type {string} */ phase, /** @type {ReturnType<typeof JSON.parse>} */ fn) => collector.before(phase, fn),
+    after: (/** @type {string} */ phase, /** @type {ReturnType<typeof JSON.parse>} */ fn) => collector.after(phase, fn),
+    initializeWith: (/** @type {ReturnType<typeof JSON.parse>} */ fn) => collector.initializeWith(fn),
+    toCreate: (/** @type {ReturnType<typeof JSON.parse>} */ fn) => collector.toCreate(fn),
     skipCreate: () => collector.skipCreate(),
     trait: (/** @type {string} */ includeName) => {
       assertName(includeName, "Trait include")
@@ -284,14 +284,14 @@ export default class DefinitionSession {
       factory: (/** @type {string} */ name, /** @type {(builder: object) => void} */ cb) => this._modifyFactory(name, cb),
       trait: (/** @type {string} */ name, /** @type {(builder: object) => void} */ cb) =>
         this.registry._registerGlobalTrait(compileTrait(name, cb)),
-      sequence: (/** @type {string} */ name, /** @type {Array<?>} */ ...args) =>
+      sequence: (/** @type {string} */ name, /** @type {Array<ReturnType<typeof JSON.parse>>} */ ...args) =>
         this.registry._registerSequence(buildSequence(name, args), null),
-      before: (/** @type {string} */ phase, /** @type {?} */ fn) =>
+      before: (/** @type {string} */ phase, /** @type {ReturnType<typeof JSON.parse>} */ fn) =>
         this.registry._addGlobalDeclaration(callbackDeclaration(eventNameFor("before", phase), fn)),
-      after: (/** @type {string} */ phase, /** @type {?} */ fn) =>
+      after: (/** @type {string} */ phase, /** @type {ReturnType<typeof JSON.parse>} */ fn) =>
         this.registry._addGlobalDeclaration(callbackDeclaration(eventNameFor("after", phase), fn)),
-      initializeWith: (/** @type {?} */ fn) => this.registry._addGlobalDeclaration(initializeWithDeclaration(fn)),
-      toCreate: (/** @type {?} */ fn) => this.registry._addGlobalDeclaration(toCreateDeclaration(fn)),
+      initializeWith: (/** @type {ReturnType<typeof JSON.parse>} */ fn) => this.registry._addGlobalDeclaration(initializeWithDeclaration(fn)),
+      toCreate: (/** @type {ReturnType<typeof JSON.parse>} */ fn) => this.registry._addGlobalDeclaration(toCreateDeclaration(fn)),
       skipCreate: () => this.registry._addGlobalDeclaration(skipCreateDeclaration())
     }
   }
@@ -312,7 +312,7 @@ export default class DefinitionSession {
     }
     const collector = new DeclarationCollector()
-    /** @type {Array<{name: string, modelOrOptions: ?, cb: ?}>} */
+    /** @type {Array<{name: string, modelOrOptions: ReturnType<typeof JSON.parse>, cb: ReturnType<typeof JSON.parse>}>} */
     const nestedFactories = []
     const localTraits = new Map(existing.localTraits)
     /** @type {Sequence[]} */
@@ -348,18 +348,18 @@ export default class DefinitionSession {
    */
   _rootBuilder() {
     return {
-      factory: (/** @type {string} */ name, /** @type {?} */ modelOrOptions, /** @type {?} */ cb) =>
+      factory: (/** @type {string} */ name, /** @type {ReturnType<typeof JSON.parse>} */ modelOrOptions, /** @type {ReturnType<typeof JSON.parse>} */ cb) =>
         this._defineFactory(name, modelOrOptions, cb, null),
       trait: (/** @type {string} */ name, /** @type {(builder: object) => void} */ cb) =>
         this.registry._registerGlobalTrait(compileTrait(name, cb)),
-      sequence: (/** @type {string} */ name, /** @type {Array<?>} */ ...args) =>
+      sequence: (/** @type {string} */ name, /** @type {Array<ReturnType<typeof JSON.parse>>} */ ...args) =>
         this.registry._registerSequence(buildSequence(name, args), null),
-      before: (/** @type {string} */ phase, /** @type {?} */ fn) =>
+      before: (/** @type {string} */ phase, /** @type {ReturnType<typeof JSON.parse>} */ fn) =>
         this.registry._addGlobalDeclaration(callbackDeclaration(eventNameFor("before", phase), fn)),
-      after: (/** @type {string} */ phase, /** @type {?} */ fn) =>
+      after: (/** @type {string} */ phase, /** @type {ReturnType<typeof JSON.parse>} */ fn) =>
         this.registry._addGlobalDeclaration(callbackDeclaration(eventNameFor("after", phase), fn)),
-      initializeWith: (/** @type {?} */ fn) => this.registry._addGlobalDeclaration(initializeWithDeclaration(fn)),
-      toCreate: (/** @type {?} */ fn) => this.registry._addGlobalDeclaration(toCreateDeclaration(fn)),
+      initializeWith: (/** @type {ReturnType<typeof JSON.parse>} */ fn) => this.registry._addGlobalDeclaration(initializeWithDeclaration(fn)),
+      toCreate: (/** @type {ReturnType<typeof JSON.parse>} */ fn) => this.registry._addGlobalDeclaration(toCreateDeclaration(fn)),
       skipCreate: () => this.registry._addGlobalDeclaration(skipCreateDeclaration())
     }
   }
@@ -368,8 +368,8 @@ export default class DefinitionSession {
    * Compiles and registers a factory (and its nested children/local traits/scoped
    * sequences).
    * @param {string} name - Factory name.
-   * @param {?} modelOrOptions - Model class or options object.
-   * @param {?} cb - Factory builder callback.
+   * @param {ReturnType<typeof JSON.parse>} modelOrOptions - Model class or options object.
+   * @param {ReturnType<typeof JSON.parse>} cb - Factory builder callback.
    * @param {string | null} inheritedParent - Parent name for nested factories.
    * @returns {void}
    */
@@ -378,7 +378,7 @@ export default class DefinitionSession {
     let modelClass = null
     let builderCallback = cb
-    /** @type {Record<string, ?>} */
+    /** @type {Record<string, ReturnType<typeof JSON.parse>>} */
     let options = {}
     if (typeof cb === "function") {
@@ -411,7 +411,7 @@ export default class DefinitionSession {
     const baseTraits = Array.isArray(options.traits) ? options.traits : []
     const collector = new DeclarationCollector()
-    /** @type {Array<{name: string, modelOrOptions: ?, cb: ?}>} */
+    /** @type {Array<{name: string, modelOrOptions: ReturnType<typeof JSON.parse>, cb: ReturnType<typeof JSON.parse>}>} */
     const nestedFactories = []
     /** @type {Map<string, TraitDefinition>} */
     const localTraits = new Map()
@@ -439,22 +439,22 @@ export default class DefinitionSession {
   /**
    * Builds the factory builder object.
    * @param {DeclarationCollector} collector - Declaration collector.
-   * @param {Array<{name: string, modelOrOptions: ?, cb: ?}>} nestedFactories - Nested factory sink.
+   * @param {Array<{name: string, modelOrOptions: ReturnType<typeof JSON.parse>, cb: ReturnType<typeof JSON.parse>}>} nestedFactories - Nested factory sink.
    * @param {Map<string, TraitDefinition>} localTraits - Local trait sink.
    * @param {Sequence[]} scopedSequences - Scoped sequence sink.
    * @returns {object} - Factory builder.
    */
   _factoryBuilder(collector, nestedFactories, localTraits, scopedSequences) {
     return {
-      attribute: (/** @type {string} */ attrName, /** @type {?} */ value) => collector.attribute(attrName, value),
-      transient: (/** @type {string} */ attrName, /** @type {?} */ value) => collector.transient(attrName, value),
-      association: (/** @type {string} */ assocName, /** @type {Array<?>} */ ...args) => collector.association(assocName, ...args),
-      before: (/** @type {string} */ phase, /** @type {?} */ fn) => collector.before(phase, fn),
-      after: (/** @type {string} */ phase, /** @type {?} */ fn) => collector.after(phase, fn),
-      initializeWith: (/** @type {?} */ fn) => collector.initializeWith(fn),
-      toCreate: (/** @type {?} */ fn) => collector.toCreate(fn),
+      attribute: (/** @type {string} */ attrName, /** @type {ReturnType<typeof JSON.parse>} */ value) => collector.attribute(attrName, value),
+      transient: (/** @type {string} */ attrName, /** @type {ReturnType<typeof JSON.parse>} */ value) => collector.transient(attrName, value),
+      association: (/** @type {string} */ assocName, /** @type {Array<ReturnType<typeof JSON.parse>>} */ ...args) => collector.association(assocName, ...args),
+      before: (/** @type {string} */ phase, /** @type {ReturnType<typeof JSON.parse>} */ fn) => collector.before(phase, fn),
+      after: (/** @type {string} */ phase, /** @type {ReturnType<typeof JSON.parse>} */ fn) => collector.after(phase, fn),
+      initializeWith: (/** @type {ReturnType<typeof JSON.parse>} */ fn) => collector.initializeWith(fn),
+      toCreate: (/** @type {ReturnType<typeof JSON.parse>} */ fn) => collector.toCreate(fn),
       skipCreate: () => collector.skipCreate(),
-      sequence: (/** @type {string} */ seqName, /** @type {Array<?>} */ ...args) => scopedSequences.push(buildSequence(seqName, args)),
+      sequence: (/** @type {string} */ seqName, /** @type {Array<ReturnType<typeof JSON.parse>>} */ ...args) => scopedSequences.push(buildSequence(seqName, args)),
       trait: (/** @type {string} */ traitName, /** @type {((builder: object) => void) | undefined} */ traitCb) => {
         if (typeof traitCb === "function") {
           const compiled = compileTrait(traitName, traitCb)
@@ -469,7 +469,7 @@ export default class DefinitionSession {
           collector.declarations.push(traitIncludeDeclaration(traitName))
         }
       },
-      factory: (/** @type {string} */ childName, /** @type {?} */ childModelOrOptions, /** @type {?} */ childCb) =>
+      factory: (/** @type {string} */ childName, /** @type {ReturnType<typeof JSON.parse>} */ childModelOrOptions, /** @type {ReturnType<typeof JSON.parse>} */ childCb) =>
         nestedFactories.push({name: childName, modelOrOptions: childModelOrOptions, cb: childCb})
     }
   }

package/src/testing/factory/evaluation-context.js CHANGED Viewed

@@ -27,7 +27,7 @@ export default class EvaluationContext {
     /** @type {"attributesFor" | "build" | "create"} - Active strategy. */
     this.strategy = strategy
-    /** @type {Map<string, ?>} - Per-run memoized values / in-flight promises. */
+    /** @type {Map<string, ReturnType<typeof JSON.parse>>} - Per-run memoized values / in-flight promises. */
     this._memo = new Map()
   }
@@ -35,7 +35,7 @@ export default class EvaluationContext {
    * Builds the named evaluator context handed to lazy values and callbacks for a
    * given dependency path.
    * @param {string[]} path - Current resolution path (for cycle detection).
-   * @returns {{get: (name: string) => Promise<?>, generate: (name: string) => Promise<?>, association: (factory: string, ...args: Array<?>) => Promise<?>}} - The evaluator context.
+   * @returns {{get: (name: string) => Promise<ReturnType<typeof JSON.parse>>, generate: (name: string) => Promise<ReturnType<typeof JSON.parse>>, association: (factory: string, ...args: Array<ReturnType<typeof JSON.parse>>) => Promise<ReturnType<typeof JSON.parse>>}} - The evaluator context.
    */
   contextFor(path) {
     return {
@@ -49,7 +49,7 @@ export default class EvaluationContext {
    * Resolves an attribute/transient/association by name, memoizing the result.
    * @param {string} name - Name to resolve.
    * @param {string[]} path - Current resolution path.
-   * @returns {Promise<?>} - The resolved value.
+   * @returns {Promise<ReturnType<typeof JSON.parse>>} - The resolved value.
    */
   _get(name, path) {
     if (path.includes(name)) {
@@ -76,7 +76,7 @@ export default class EvaluationContext {
    * Evaluates a resolved slot, honouring lazy functions and overrides.
    * @param {import("./factory-runner.js").Slot} slot - Slot to evaluate.
    * @param {string[]} childPath - Path including this slot's name.
-   * @returns {Promise<?>} - The evaluated value.
+   * @returns {Promise<ReturnType<typeof JSON.parse>>} - The evaluated value.
    */
   async _evaluateSlot(slot, childPath) {
     if (slot.slotKind === "association") {
@@ -94,7 +94,7 @@ export default class EvaluationContext {
    * Resolves a declared/overridden association slot. An explicit object/null
    * override suppresses nested factory execution and is returned verbatim.
    * @param {import("./factory-runner.js").Slot} slot - Association slot.
-   * @returns {Promise<?>} - The associated record (or override value).
+   * @returns {Promise<ReturnType<typeof JSON.parse>>} - The associated record (or override value).
    */
   async _resolveAssociationSlot(slot) {
     if (slot.isOverride) return slot.value
@@ -115,16 +115,16 @@ export default class EvaluationContext {
   /**
    * Runs an explicitly-invoked association from a lazy value's `association(...)`.
    * @param {string} factoryName - Factory to run.
-   * @param {Array<?>} args - Traits and/or an overrides object.
+   * @param {Array<ReturnType<typeof JSON.parse>>} args - Traits and/or an overrides object.
    * @param {string[]} _path - Current resolution path (unused; associations open a fresh run).
-   * @returns {Promise<?>} - The associated record, or null under attributesFor.
+   * @returns {Promise<ReturnType<typeof JSON.parse>>} - The associated record, or null under attributesFor.
    */
   _explicitAssociation(factoryName, args, _path) {
     if (this.strategy === "attributesFor") return Promise.resolve(null)
     /** @type {string[]} */
     const traits = []
-    /** @type {Record<string, ?>} */
+    /** @type {Record<string, ReturnType<typeof JSON.parse>>} */
     let overrides = {}
     for (const arg of args) {
@@ -141,10 +141,10 @@ export default class EvaluationContext {
    * Resolves every plain attribute slot (used by attributesFor). Transients and
    * associations are omitted, though transients may still be evaluated on demand
    * as dependencies.
-   * @returns {Promise<Record<string, ?>>} - The resolved attributes.
+   * @returns {Promise<Record<string, ReturnType<typeof JSON.parse>>>} - The resolved attributes.
    */
   async resolveAttributes() {
-    /** @type {Record<string, ?>} */
+    /** @type {Record<string, ReturnType<typeof JSON.parse>>} */
     const attributes = {}
     for (const [name, slot] of this.plan.resolved) {
@@ -158,10 +158,10 @@ export default class EvaluationContext {
   /**
    * Resolves every transient before callbacks that expose them as plain properties.
-   * @returns {Promise<Record<string, ?>>} - Evaluated transient values.
+   * @returns {Promise<Record<string, ReturnType<typeof JSON.parse>>>} - Evaluated transient values.
    */
   async resolveTransients() {
-    /** @type {Record<string, ?>} */
+    /** @type {Record<string, ReturnType<typeof JSON.parse>>} */
     const transients = {}
     for (const [name, slot] of this.plan.resolved) {
@@ -174,14 +174,14 @@ export default class EvaluationContext {
   /**
    * Resolves everything needed to construct a record: public attributes,
    * transients, and associated records.
-   * @returns {Promise<{publicAttributes: Record<string, ?>, transients: Record<string, ?>, associations: Array<{name: string, record: ?}>}>} - Resolved construction inputs.
+   * @returns {Promise<{publicAttributes: Record<string, ReturnType<typeof JSON.parse>>, transients: Record<string, ReturnType<typeof JSON.parse>>, associations: Array<{name: string, record: ReturnType<typeof JSON.parse>}>}>} - Resolved construction inputs.
    */
   async resolveForConstruction() {
-    /** @type {Record<string, ?>} */
+    /** @type {Record<string, ReturnType<typeof JSON.parse>>} */
     const publicAttributes = {}
-    /** @type {Record<string, ?>} */
+    /** @type {Record<string, ReturnType<typeof JSON.parse>>} */
     const transients = {}
-    /** @type {Array<{name: string, record: ?}>} */
+    /** @type {Array<{name: string, record: ReturnType<typeof JSON.parse>}>} */
     const associations = []
     for (const [name, slot] of this.plan.resolved) {

package/src/testing/factory/factory-definition.js CHANGED Viewed

@@ -11,7 +11,7 @@ export default class FactoryDefinition {
    * Builds a factory definition.
    * @param {object} args - Options.
    * @param {string} args.name - Factory name.
-   * @param {(new (attributes?: Record<string, ?>) => ?) | null} args.modelClass - Model class, or null to inherit from a parent.
+   * @param {(new (attributes?: Record<string, ReturnType<typeof JSON.parse>>) => ReturnType<typeof JSON.parse>) | null} args.modelClass - Model class, or null to inherit from a parent.
    * @param {string | null} args.parentName - Parent factory name, or null.
    * @param {string[]} args.aliases - Alias names that reference this same definition.
    * @param {import("./declarations.js").Declaration[]} args.declarations - Ordered own declarations.
@@ -21,7 +21,7 @@ export default class FactoryDefinition {
     /** @type {string} - Factory name. */
     this.name = name
-    /** @type {(new (attributes?: Record<string, ?>) => ?) | null} - Model class or null. */
+    /** @type {(new (attributes?: Record<string, ReturnType<typeof JSON.parse>>) => ReturnType<typeof JSON.parse>) | null} - Model class or null. */
     this.modelClass = modelClass
     /** @type {string | null} - Parent factory name or null. */