velocious 1.0.449 → 1.0.450

package/src/frontend-models/clear-pending-debounced-callback.js

@@ -8,7 +8,7 @@
 export default function clearPendingDebouncedCallback(callback) {
   const callbackWithClear = /**
                              * Narrows the runtime value to the documented type.
-                              @type {{clear?: ?}} */ (callback)
+                             * @type {{clear?: ?}} */ (callback)
 
   if (typeof callbackWithClear.clear === "function") {
     callbackWithClear.clear()

package/src/frontend-models/event-hook-models.js

@@ -2,11 +2,11 @@
 
 /**
  * FrontendModelInstance type.
-  @typedef {import("./base.js").default} FrontendModelInstance */
+ * @typedef {import("./base.js").default} FrontendModelInstance */
 
 /**
  * Model dependency ids.
-  @type {WeakMap<FrontendModelInstance, number>} */
+ * @type {WeakMap<FrontendModelInstance, number>} */
 const modelDependencyIds = new WeakMap()
 let nextModelDependencyId = 1
 

package/src/frontend-models/outgoing-event-buffer.js

@@ -11,7 +11,7 @@ const MAX_BUFFERED_OUTGOING_EVENTS = 50
 
 /**
  * Buffer.
-  @type {BufferedOutgoingEvent[]} */
+ * @type {BufferedOutgoingEvent[]} */
 let buffer = []
 
 /**
@@ -37,7 +37,7 @@ export function drainBufferedOutgoingEvents() {
 
 /**
  * Runs the clearBufferedOutgoingEvents helper.
-  @returns {void} */
+ * @returns {void} */
 export function clearBufferedOutgoingEvents() {
   buffer = []
 }

package/src/frontend-models/preloader.js

@@ -24,15 +24,15 @@ export default class FrontendModelPreloader {
 
     const modelClass = /**
                         * Narrows the runtime value to the documented type.
-                         @type {import("./base.js").FrontendModelClass} */ (models[0].constructor)
+                        * @type {import("./base.js").FrontendModelClass} */ (models[0].constructor)
     const isQuery = Boolean(queryOrSpec) && typeof queryOrSpec === "object" && "_preload" in queryOrSpec
     const query = isQuery
       ? /**
          * Narrows the runtime value to the documented type.
-          @type {import("./query.js").default<import("./base.js").FrontendModelClass>} */ (queryOrSpec)
+         * @type {import("./query.js").default<import("./base.js").FrontendModelClass>} */ (queryOrSpec)
       : modelClass.preload(/**
                             * Narrows the runtime value to the documented type.
-                             @type {?} */ (queryOrSpec))
+                            * @type {?} */ (queryOrSpec))
 
     const topLevelRelationships = Object.keys(query._preload)
 
@@ -60,7 +60,7 @@ export default class FrontendModelPreloader {
 
     /**
      * Reloaded by id.
-      @type {Map<string, import("./base.js").default>} */
+     * @type {Map<string, import("./base.js").default>} */
     const reloadedById = new Map()
 
     for (const reloadedModel of reloaded) {
@@ -165,6 +165,6 @@ export default class FrontendModelPreloader {
     if (!subPreload || typeof subPreload !== "object") return null
     if (Object.keys(subPreload).length === 0) return null
 
-    return /** Narrows the runtime value to the documented type. @type {import("../database/query/index.js").NestedPreloadRecord} */ (subPreload)
+    return /** @type {import("../database/query/index.js").NestedPreloadRecord} */ (subPreload)
   }
 }

package/src/frontend-models/query.js

@@ -17,6 +17,10 @@ import isPlainObject from "../utils/plain-object.js"
  * FrontendModelTransportValue type.
  * @typedef {null | boolean | number | string | object} FrontendModelTransportValue
  */
+/**
+ * FrontendModelAttributeValue type.
+ * @typedef {import("./base.js").FrontendModelAttributeValue} FrontendModelAttributeValue
+ */
 /**
  * Defines this typedef.
  * @typedef {{attributeName: string, relationshipName: string, where?: Record<string, FrontendModelTransportValue>}} FrontendModelWithCountPayloadEntry
@@ -89,7 +93,7 @@ export function normalizePreload(preload) {
   if (Array.isArray(preload)) {
     /**
      * Normalized.
-      @type {import("../database/query/index.js").NestedPreloadRecord} */
+     * @type {import("../database/query/index.js").NestedPreloadRecord} */
     const normalized = {}
 
     for (const entry of preload) {
@@ -115,7 +119,7 @@ export function normalizePreload(preload) {
 
   /**
    * Normalized.
-    @type {import("../database/query/index.js").NestedPreloadRecord} */
+   * @type {import("../database/query/index.js").NestedPreloadRecord} */
   const normalized = {}
 
   for (const [relationshipName, relationshipPreload] of Object.entries(preload)) {
@@ -177,7 +181,7 @@ function normalizeWithCountFrontend(spec) {
     if (isPlainObject(value)) {
       const options = /**
                        * Narrows the runtime value to the documented type.
-                        @type {{relationship?: string, where?: Record<string, ?>}} */ (value)
+                       * @type {{relationship?: string, where?: Record<string, ?>}} */ (value)
       entries.push({
         attributeName: key,
         relationshipName: options.relationship || key,
@@ -228,7 +232,7 @@ function normalizeAbilitiesSpec(spec, rootModelClass) {
 
   /**
    * Entries.
-    @type {Array<{modelName: string, actions: string[]}>} */
+   * @type {Array<{modelName: string, actions: string[]}>} */
   const entries = []
 
   for (const [modelName, actions] of Object.entries(spec)) {
@@ -280,10 +284,10 @@ function mergePreloadRecord(targetPreload, incomingPreload) {
       mergePreloadRecord(
         /**
          * Narrows the runtime value to the documented type.
-          @type {import("../database/query/index.js").NestedPreloadRecord} */ (existingValue),
+         * @type {import("../database/query/index.js").NestedPreloadRecord} */ (existingValue),
         /**
          * Narrows the runtime value to the documented type.
-          @type {import("../database/query/index.js").NestedPreloadRecord} */ (incomingValue)
+         * @type {import("../database/query/index.js").NestedPreloadRecord} */ (incomingValue)
       )
       continue
     }
@@ -325,7 +329,7 @@ function normalizeSelect(select, rootModelName = null) {
 
   /**
    * Normalized.
-    @type {Record<string, string[]>} */
+   * @type {Record<string, string[]>} */
   const normalized = {}
 
   for (const [modelName, selection] of Object.entries(select)) {
@@ -378,14 +382,14 @@ export function normalizeSearchOperator(operator) {
   }
   const normalizedOperator = operatorAliases[/**
                                               * Narrows the runtime value to the documented type.
-                                               @type {"<" | "<=" | ">" | ">="} */ (operator)] || operator
+                                              * @type {"<" | "<=" | ">" | ">="} */ (operator)] || operator
   const supportedOperators = new Set(["eq", "like", "notEq", "gt", "gteq", "lt", "lteq"])
 
   if (!supportedOperators.has(normalizedOperator)) {
     throw new Error(`search operator must be one of: eq, like, notEq, gt, gteq, lt, lteq, >, >=, <, <= (got: ${operator})`)
   }
 
-  return /** Narrows the runtime value to the documented type. @type {"eq" | "like" | "notEq" | "gt" | "gteq" | "lt" | "lteq"} */ (normalizedOperator)
+  return /** @type {"eq" | "like" | "notEq" | "gt" | "gteq" | "lt" | "lteq"} */ (normalizedOperator)
 }
 
 /**
@@ -434,7 +438,7 @@ export function normalizeJoins(joins) {
   if (Array.isArray(joins)) {
     /**
      * Normalized.
-      @type {Record<string, ?>} */
+     * @type {Record<string, ?>} */
     const normalized = {}
 
     for (const joinEntry of joins) {
@@ -454,7 +458,7 @@ export function normalizeJoins(joins) {
 
   /**
    * Normalized.
-    @type {Record<string, ?>} */
+   * @type {Record<string, ?>} */
   const normalized = {}
 
   for (const [relationshipName, relationshipJoin] of Object.entries(joins)) {
@@ -627,7 +631,7 @@ function parseSortTuple(sortValue, path = []) {
 function normalizeSortObject(sortValue, path) {
   /**
    * Normalized sorts.
-    @type {FrontendModelSort[]} */
+   * @type {FrontendModelSort[]} */
   const normalizedSorts = []
 
   for (const [sortKey, sortEntry] of Object.entries(sortValue)) {
@@ -702,7 +706,7 @@ export function normalizeSort(sort) {
   if (Array.isArray(sort)) {
     /**
      * Normalized.
-      @type {FrontendModelSort[]} */
+     * @type {FrontendModelSort[]} */
     const normalized = []
 
     for (const sortEntry of sort) {
@@ -784,7 +788,7 @@ function columnPathDescriptor(value) {
 function normalizeColumnProjectionObject(value, path, parseString, label) {
   /**
    * Normalized.
-    @type {T[]} */
+   * @type {T[]} */
   const normalized = []
 
   for (const [projectionKey, projectionEntry] of Object.entries(value)) {
@@ -846,7 +850,7 @@ export function normalizeGroup(group) {
   if (Array.isArray(group)) {
     /**
      * Normalized.
-      @type {FrontendModelGroup[]} */
+     * @type {FrontendModelGroup[]} */
     const normalized = []
 
     for (const groupEntry of group) {
@@ -922,7 +926,7 @@ export function normalizePluck(pluck) {
   if (Array.isArray(pluck)) {
     /**
      * Normalized.
-      @type {FrontendModelPluck[]} */
+     * @type {FrontendModelPluck[]} */
     const normalized = []
 
     for (const pluckEntry of pluck) {
@@ -961,7 +965,7 @@ export function normalizePluck(pluck) {
 function frontendModelResourceAttributes(modelClass) {
   const resourceConfig = /**
                           * Narrows the runtime value to the documented type.
-                           @type {Record<string, ?>} */ (modelClass.resourceConfig())
+                          * @type {Record<string, ?>} */ (modelClass.resourceConfig())
   const attributes = resourceConfig.attributes
 
   if (Array.isArray(attributes)) {
@@ -1080,19 +1084,19 @@ function reverseSortDirection(direction) {
 export default class FrontendModelQuery {
   /**
    * Ransack.
-    @type {Record<string, ?>[]} */
+   * @type {Record<string, ?>[]} */
   _ransack = []
   /**
    * Searches.
-    @type {FrontendModelSearch[]} */
+   * @type {FrontendModelSearch[]} */
   _searches = []
   /**
    * Sort.
-    @type {FrontendModelSort[]} */
+   * @type {FrontendModelSort[]} */
   _sort = []
   /**
    * Group.
-    @type {FrontendModelGroup[]} */
+   * @type {FrontendModelGroup[]} */
   _group = []
 
   /**
@@ -1109,11 +1113,11 @@ export default class FrontendModelQuery {
     this._searches = []
     /**
      * Narrows the runtime value to the documented type.
-      @type {Record<string, string[]>} */
+     * @type {Record<string, string[]>} */
     this._select = {}
     /**
      * Narrows the runtime value to the documented type.
-      @type {Record<string, string[]>} */
+     * @type {Record<string, string[]>} */
     this._selectsExtra = {}
     this._sort = []
     this._group = []
@@ -1124,11 +1128,11 @@ export default class FrontendModelQuery {
     this._perPage = null
     /**
      * Narrows the runtime value to the documented type.
-      @type {Array<{attributeName: string, relationshipName: string, where?: Record<string, ?>}>} */
+     * @type {Array<{attributeName: string, relationshipName: string, where?: Record<string, ?>}>} */
     this._withCount = []
     /**
      * Narrows the runtime value to the documented type.
-      @type {Array<string | Record<string, ?>>} */
+     * @type {Array<string | Record<string, ?>>} */
     this._queryData = []
     /**
      * Per-record ability spec. Normalized to a list of
@@ -1231,7 +1235,7 @@ export default class FrontendModelQuery {
 
     this._queryData.push(/**
                           * Narrows the runtime value to the documented type.
-                           @type {?} */ (spec))
+                          * @type {?} */ (spec))
 
     return this
   }
@@ -1268,7 +1272,7 @@ export default class FrontendModelQuery {
 
     const scopedQuery = /**
                          * Narrows the runtime value to the documented type.
-                          @type {this | void} */ (scopeDescriptor.callback({
+                         * @type {this | void} */ (scopeDescriptor.callback({
       driver: null,
       modelClass: this.modelClass,
       query: this,
@@ -1312,7 +1316,7 @@ export default class FrontendModelQuery {
     const rootModelName = this.modelClass.getModelName()
     const selectMap = /**
                        * Narrows the runtime value to the documented type.
-                        @type {Record<string, string[]>} */ (this._select)
+                       * @type {Record<string, string[]>} */ (this._select)
     const existingRootAttributes = selectMap[rootModelName]
 
     if (!existingRootAttributes) {
@@ -1520,7 +1524,7 @@ export default class FrontendModelQuery {
   clone() {
     const newQuery = /**
                       * Narrows the runtime value to the documented type.
-                       @type {FrontendModelQuery<T>} */ (new FrontendModelQuery({
+                      * @type {FrontendModelQuery<T>} */ (new FrontendModelQuery({
       modelClass: this.modelClass,
       preload: normalizePreload(this._preload)
     }))
@@ -1763,7 +1767,7 @@ export default class FrontendModelQuery {
   paginationPayload() {
     /**
      * Payload.
-      @type {Record<string, ?>} */
+     * @type {Record<string, ?>} */
     const payload = {}
 
     if (this._limit !== null) payload.limit = this._limit
@@ -1782,7 +1786,7 @@ export default class FrontendModelQuery {
   assertEventQuerySupported() {
     /**
      * Unsupported options.
-      @type {string[]} */
+     * @type {string[]} */
     const unsupportedOptions = []
 
     if (this._sort.length > 0) unsupportedOptions.push("sort")
@@ -1872,7 +1876,7 @@ export default class FrontendModelQuery {
     const modelsData = Array.isArray(response.models) ? response.models : []
     /**
      * Models.
-      @type {InstanceType<T>[]} */
+     * @type {InstanceType<T>[]} */
     const models = modelsData.map((model) => this.modelClass.instantiateFromResponse(model))
 
     // Share a single cohort reference across every sibling so auto-batch-preload
@@ -1881,7 +1885,7 @@ export default class FrontendModelQuery {
     for (const model of models) {
       /**
        * Narrows the runtime value to the documented type.
-        @type {?} */ (model)._loadCohort = models
+       * @type {?} */ (model)._loadCohort = models
     }
 
     return models
@@ -2094,7 +2098,9 @@ export default class FrontendModelQuery {
 
     if (model) return model
 
-    return /** Narrows the runtime value to the documented type. @type {InstanceType<T>} */ (new this.modelClass(normalizedConditions))
+    const ModelClass = /** @type {new (attributes?: Record<string, FrontendModelAttributeValue>) => InstanceType<T>} */ (/** @type {unknown} */ (this.modelClass))
+
+    return new ModelClass(/** @type {Record<string, FrontendModelAttributeValue>} */ (normalizedConditions))
   }
 
   /**
@@ -2109,9 +2115,8 @@ export default class FrontendModelQuery {
 
     if (model) return model
 
-    const newModel = /**
-                      * Narrows the runtime value to the documented type.
-                       @type {InstanceType<T>} */ (new this.modelClass(normalizedConditions))
+    const ModelClass = /** @type {new (attributes?: Record<string, FrontendModelAttributeValue>) => InstanceType<T>} */ (/** @type {unknown} */ (this.modelClass))
+    const newModel = new ModelClass(/** @type {Record<string, FrontendModelAttributeValue>} */ (normalizedConditions))
 
     if (callback) {
       await callback(newModel)
@@ -2226,7 +2231,7 @@ function frontendModelEventQuery(modelClass, options = {}) {
 
   const optionsObject = /**
                          * Narrows the runtime value to the documented type.
-                          @type {FrontendModelEventOptionsObject} */ (options)
+                         * @type {FrontendModelEventOptionsObject} */ (options)
   const query = frontendModelEventQueryFromOptionsObject(modelClass, optionsObject)
 
   applyFrontendModelProjectionOptions(query, optionsObject)

package/src/frontend-models/resource-definition.js

@@ -61,7 +61,7 @@ export function frontendModelResourceConfigurationFromDefinition(resourceDefinit
 function normalizeFrontendModelResourceConfiguration(resourceConfiguration) {
   const restArgs = /**
                     * Narrows the runtime value to the documented type.
-                     @type {Record<string, ?>} */ ({...resourceConfiguration})
+                    * @type {Record<string, ?>} */ ({...resourceConfiguration})
 
   for (const key of [
     "abilities",
@@ -120,7 +120,7 @@ function normalizeFrontendModelResourceAbilities(abilities) {
 
   /**
    * Normalized.
-    @type {Record<string, string>} */
+   * @type {Record<string, string>} */
   const normalized = {}
 
   if (abilities.includes("create")) normalized.create = "create"
@@ -206,7 +206,7 @@ function normalizeFrontendModelBuiltInCommands({commandDefaults, commandsConfig,
 
   /**
    * Normalized commands.
-    @type {Record<string, string>} */
+   * @type {Record<string, string>} */
   const normalizedCommands = {}
 
   for (const commandType of commandsConfig) {
@@ -244,7 +244,7 @@ function normalizeFrontendModelCustomCommands({commandsConfig, modelName}) {
 
   /**
    * Normalized commands.
-    @type {Record<string, string>} */
+   * @type {Record<string, string>} */
   const normalizedCommands = {}
 
   for (const methodName of commandsConfig) {
@@ -302,12 +302,12 @@ export function frontendModelActionForCommand({commandName, modelName, resourceD
       commandName: configuredCommandName,
       commandType: /**
                     * Narrows the runtime value to the documented type.
-                     @type {"attach" | "create" | "destroy" | "download" | "find" | "index" | "update" | "url"} */ (action),
+                    * @type {"attach" | "create" | "destroy" | "download" | "find" | "index" | "update" | "url"} */ (action),
       modelName
     })
 
     if (commandName === validatedCommandName) {
-      return /** Narrows the runtime value to the documented type. @type {"attach" | "create" | "destroy" | "download" | "find" | "index" | "update" | "url"} */ (action)
+      return /** @type {"attach" | "create" | "destroy" | "download" | "find" | "index" | "update" | "url"} */ (action)
     }
   }
 

package/src/frontend-models/transport-serialization.js

@@ -139,7 +139,7 @@ export function isBackendModelInstance(value) {
 
   const candidate = /**
                      * Narrows the runtime value to the documented type.
-                      @type {Record<string, ?>} */ (value)
+                     * @type {Record<string, ?>} */ (value)
 
   return (
     typeof candidate.attributes === "function"
@@ -195,12 +195,12 @@ function serializeFrontendModelTransportValueInternal(value, seenModels) {
 
     /**
      * Serialized model.
-      @type {Record<string, ?>} */
+     * @type {Record<string, ?>} */
     const serializedModel = {
       [TYPE_KEY]: TYPE_FRONTEND_MODEL,
       attributes: /**
                    * Narrows the runtime value to the documented type.
-                    @type {Record<string, ?>} */ (serializeFrontendModelTransportValueInternal(modelAttributes, seenModels)),
+                   * @type {Record<string, ?>} */ (serializeFrontendModelTransportValueInternal(modelAttributes, seenModels)),
       modelName
     }
 
@@ -212,7 +212,7 @@ function serializeFrontendModelTransportValueInternal(value, seenModels) {
 
     /**
      * Preloaded relationships.
-      @type {Record<string, ?>} */
+     * @type {Record<string, ?>} */
     const preloadedRelationships = {}
     const relationshipsMap = value.getModelClass().getRelationshipsMap()
 
@@ -241,7 +241,7 @@ function serializeFrontendModelTransportValueInternal(value, seenModels) {
   if (isPlainObject(value)) {
     /**
      * Serialized.
-      @type {Record<string, ?>} */
+     * @type {Record<string, ?>} */
     const serialized = {}
 
     for (const [key, nestedValue] of Object.entries(value)) {
@@ -262,11 +262,11 @@ function serializeFrontendModelTransportValueInternal(value, seenModels) {
 function deserializeFrontendModelMarker(marker) {
   const attributes = /**
                       * Narrows the runtime value to the documented type.
-                       @type {Record<string, ?>} */ (deserializeFrontendModelTransportValue(marker.attributes))
+                      * @type {Record<string, ?>} */ (deserializeFrontendModelTransportValue(marker.attributes))
   const preloadedRelationships = isPlainObject(marker.preloadedRelationships)
     ? /**
        * Narrows the runtime value to the documented type.
-        @type {Record<string, ?>} */ (deserializeFrontendModelTransportValue(marker.preloadedRelationships))
+       * @type {Record<string, ?>} */ (deserializeFrontendModelTransportValue(marker.preloadedRelationships))
     : {}
   const modelClass = resolveFrontendModelClass(marker.modelName)
 
@@ -320,7 +320,7 @@ export function deserializeFrontendModelTransportValue(value) {
   if (isDateMarker(value)) {
     const dateValue = /**
                        * Narrows the runtime value to the documented type.
-                        @type {{value: string}} */ (value).value
+                       * @type {{value: string}} */ (value).value
 
     return new Date(dateValue)
   }
@@ -328,7 +328,7 @@ export function deserializeFrontendModelTransportValue(value) {
   if (isBigIntMarker(value)) {
     const bigintValue = /**
                          * Narrows the runtime value to the documented type.
-                          @type {{value: string}} */ (value).value
+                         * @type {{value: string}} */ (value).value
 
     return BigInt(bigintValue)
   }
@@ -336,7 +336,7 @@ export function deserializeFrontendModelTransportValue(value) {
   if (isNonFiniteNumberMarker(value)) {
     const numberValue = /**
                          * Narrows the runtime value to the documented type.
-                          @type {{value: string}} */ (value).value
+                         * @type {{value: string}} */ (value).value
 
     if (numberValue === NUMBER_NAN) return Number.NaN
     if (numberValue === NUMBER_POSITIVE_INFINITY) return Number.POSITIVE_INFINITY
@@ -355,7 +355,7 @@ export function deserializeFrontendModelTransportValue(value) {
   if (isPlainObject(value)) {
     /**
      * Deserialized.
-      @type {Record<string, ?>} */
+     * @type {Record<string, ?>} */
     const deserialized = {}
 
     for (const [key, nestedValue] of Object.entries(value)) {

package/src/frontend-models/use-destroyed-event.js

@@ -9,25 +9,25 @@ import useModelClassEvent from "./use-model-class-event.js"
 
 /**
  * FrontendModelClass type.
-  @typedef {import("./base.js").FrontendModelClass} FrontendModelClass */
+ * @typedef {import("./base.js").FrontendModelClass} FrontendModelClass */
 /**
  * FrontendModelInstance type.
-  @typedef {import("./base.js").default} FrontendModelInstance */
+ * @typedef {import("./base.js").default} FrontendModelInstance */
 /**
  * FrontendModelClassDestroyEventPayload type.
-  @typedef {import("./use-model-class-event.js").FrontendModelDestroyEventPayload} FrontendModelClassDestroyEventPayload */
+ * @typedef {import("./use-model-class-event.js").FrontendModelDestroyEventPayload} FrontendModelClassDestroyEventPayload */
 /**
  * Defines this typedef.
-  @typedef {{id: string}} FrontendModelInstanceDestroyEventPayload */
+ * @typedef {{id: string}} FrontendModelInstanceDestroyEventPayload */
 /**
  * FrontendModelDestroyEventPayload type.
-  @typedef {FrontendModelClassDestroyEventPayload | FrontendModelInstanceDestroyEventPayload} FrontendModelDestroyEventPayload */
+ * @typedef {FrontendModelClassDestroyEventPayload | FrontendModelInstanceDestroyEventPayload} FrontendModelDestroyEventPayload */
 /**
  * UseDestroyedEventOptions type.
-  @typedef {import("./use-model-class-event.js").UseModelClassEventOptions} UseDestroyedEventOptions */
+ * @typedef {import("./use-model-class-event.js").UseModelClassEventOptions} UseDestroyedEventOptions */
 /**
  * FrontendModelDestroyEventCallback type.
-  @typedef {(payload: FrontendModelDestroyEventPayload) => void} FrontendModelDestroyEventCallback */
+ * @typedef {(payload: FrontendModelDestroyEventPayload) => void} FrontendModelDestroyEventCallback */
 
 /**
  * Runs assert no unknown options.
@@ -94,7 +94,7 @@ function useInstanceDestroyedEvent(modelOrModels, callback, options) {
   const eventCallback = useMemo(() => {
     const wrappedCallback = (/**
                               * Narrows the runtime value to the documented type.
-                               @type {FrontendModelInstanceDestroyEventPayload} */ payload) => {
+                              * @type {FrontendModelInstanceDestroyEventPayload} */ payload) => {
       if (activeRef.current) callbackRef.current(payload)
     }
 
@@ -113,11 +113,11 @@ function useInstanceDestroyedEvent(modelOrModels, callback, options) {
     let closed = false
     /**
      * Unsubscribe callbacks.
-      @type {Array<() => void>} */
+     * @type {Array<() => void>} */
     const unsubscribeCallbacks = []
     const subscriptionCallback = (/**
                                    * Narrows the runtime value to the documented type.
-                                    @type {FrontendModelInstanceDestroyEventPayload} */ payload) => {
+                                   * @type {FrontendModelInstanceDestroyEventPayload} */ payload) => {
       if (!closed) eventCallback(payload)
     }
 

package/src/frontend-models/use-model-class-event.js

@@ -7,28 +7,28 @@ import clearPendingDebouncedCallback from "./clear-pending-debounced-callback.js
 
 /**
  * FrontendModelClass type.
-  @typedef {import("./base.js").FrontendModelClass} FrontendModelClass */
+ * @typedef {import("./base.js").FrontendModelClass} FrontendModelClass */
 /**
  * FrontendModelInstance type.
-  @typedef {InstanceType<FrontendModelClass>} FrontendModelInstance */
+ * @typedef {InstanceType<FrontendModelClass>} FrontendModelInstance */
 /**
  * FrontendModelClassEventName type.
-  @typedef {"create" | "update" | "destroy"} FrontendModelClassEventName */
+ * @typedef {"create" | "update" | "destroy"} FrontendModelClassEventName */
 /**
  * Defines this typedef.
-  @typedef {{id: string, model: FrontendModelInstance}} FrontendModelCreateUpdateEventPayload */
+ * @typedef {{id: string, model: FrontendModelInstance}} FrontendModelCreateUpdateEventPayload */
 /**
  * Defines this typedef.
-  @typedef {{id: string}} FrontendModelDestroyEventPayload */
+ * @typedef {{id: string}} FrontendModelDestroyEventPayload */
 /**
  * FrontendModelClassEventPayload type.
-  @typedef {FrontendModelCreateUpdateEventPayload | FrontendModelDestroyEventPayload} FrontendModelClassEventPayload */
+ * @typedef {FrontendModelCreateUpdateEventPayload | FrontendModelDestroyEventPayload} FrontendModelClassEventPayload */
 /**
  * FrontendModelClassEventCallback type.
-  @typedef {(payload: FrontendModelClassEventPayload) => void} FrontendModelClassEventCallback */
+ * @typedef {(payload: FrontendModelClassEventPayload) => void} FrontendModelClassEventCallback */
 /**
  * Defines this typedef.
-  @typedef {{active?: boolean, debounce?: boolean | number, onConnected?: () => void} & import("./query.js").FrontendModelEventOptionsObject} UseModelClassEventOptions */
+ * @typedef {{active?: boolean, debounce?: boolean | number, onConnected?: () => void} & import("./query.js").FrontendModelEventOptionsObject} UseModelClassEventOptions */
 
 /**
  * Runs assert no unknown options.
@@ -113,7 +113,7 @@ export default function useModelClassEvent(modelClass, eventOrEvents, callback,
   const eventCallback = useMemo(() => {
     const wrappedCallback = (/**
                               * Narrows the runtime value to the documented type.
-                               @type {FrontendModelClassEventPayload} */ payload) => {
+                              * @type {FrontendModelClassEventPayload} */ payload) => {
       if (activeRef.current) callbackRef.current(payload)
     }
 
@@ -129,11 +129,11 @@ export default function useModelClassEvent(modelClass, eventOrEvents, callback,
     let closed = false
     /**
      * Unsubscribe callbacks.
-      @type {Array<() => void>} */
+     * @type {Array<() => void>} */
     const unsubscribeCallbacks = []
     const subscriptionCallback = (/**
                                    * Narrows the runtime value to the documented type.
-                                    @type {FrontendModelClassEventPayload} */ payload) => {
+                                   * @type {FrontendModelClassEventPayload} */ payload) => {
       if (!closed) eventCallback(payload)
     }