velocious 1.0.449 → 1.0.451

package/build/testing/browser-frontend-model-event-hook-scenarios.js

@@ -12,13 +12,13 @@ import wait from "awaitery/build/wait.js"
 
 /**
  * FrontendModelResourceConfig type.
-  @typedef {import("../frontend-models/base.js").FrontendModelResourceConfig} FrontendModelResourceConfig */
+ * @typedef {import("../frontend-models/base.js").FrontendModelResourceConfig} FrontendModelResourceConfig */
 /**
  * Defines this typedef.
-  @typedef {{id: string, model: FrontendModelBase}} FrontendModelHookTestCreateUpdatePayload */
+ * @typedef {{id: string, model: FrontendModelBase}} FrontendModelHookTestCreateUpdatePayload */
 /**
  * Defines this typedef.
-  @typedef {{id: string}} FrontendModelHookTestDestroyPayload */
+ * @typedef {{id: string}} FrontendModelHookTestDestroyPayload */
 /**
  * FakeSubscriptions type.
  * @typedef {object} FakeSubscriptions
@@ -251,7 +251,7 @@ async function classLifecycleScenario() {
   const eventModel = buildFakeModel("1", buildFakeSubscriptions())
   /**
    * Received events.
-    @type {Array<FrontendModelHookTestCreateUpdatePayload | FrontendModelHookTestDestroyPayload>} */
+   * @type {Array<FrontendModelHookTestCreateUpdatePayload | FrontendModelHookTestDestroyPayload>} */
   const receivedEvents = []
   let connectedCount = 0
 
@@ -304,7 +304,7 @@ async function instanceLifecycleScenario() {
   const model = buildFakeModel("task-1", subscriptions)
   /**
    * Received events.
-    @type {Array<FrontendModelHookTestCreateUpdatePayload | FrontendModelHookTestDestroyPayload>} */
+   * @type {Array<FrontendModelHookTestCreateUpdatePayload | FrontendModelHookTestDestroyPayload>} */
   const receivedEvents = []
   let connectedCount = 0
 
@@ -411,7 +411,7 @@ async function debounceUnmountScenario() {
   const model = buildFakeModel("task-1", instanceSubscriptions)
   /**
    * Received events.
-    @type {Array<FrontendModelHookTestCreateUpdatePayload | FrontendModelHookTestDestroyPayload>} */
+   * @type {Array<FrontendModelHookTestCreateUpdatePayload | FrontendModelHookTestDestroyPayload>} */
   const receivedEvents = []
 
   /**
@@ -450,7 +450,7 @@ async function resubscribeInstanceScenario() {
   const secondModel = buildFakeModel("task-1", secondSubscriptions)
   /**
    * Received events.
-    @type {Array<FrontendModelHookTestCreateUpdatePayload | FrontendModelHookTestDestroyPayload>} */
+   * @type {Array<FrontendModelHookTestCreateUpdatePayload | FrontendModelHookTestDestroyPayload>} */
   const receivedEvents = []
 
   /**

package/build/testing/expect-utils.js

@@ -51,7 +51,7 @@ function isObjectLike(value) {
 function isArrayContaining(value) {
   return !!value && typeof value === "object" && (/**
                                                    * Narrows the runtime value to the documented type.
-                                                    @type {?} */ (value)).__velociousMatcher === "arrayContaining"
+                                                   * @type {?} */ (value)).__velociousMatcher === "arrayContaining"
 }
 
 /**
@@ -62,7 +62,7 @@ function isArrayContaining(value) {
 function isObjectContaining(value) {
   return !!value && typeof value === "object" && (/**
                                                    * Narrows the runtime value to the documented type.
-                                                    @type {?} */ (value)).__velociousMatcher === "objectContaining"
+                                                   * @type {?} */ (value)).__velociousMatcher === "objectContaining"
 }
 
 /**
@@ -108,16 +108,16 @@ function collectMatchDifferences(actual, expected, path, differences) {
   if (isObjectContaining(expected)) {
     collectMatchDifferences(actual, /**
                                      * Narrows the runtime value to the documented type.
-                                      @type {?} */ (expected).value, path, differences)
+                                     * @type {?} */ (expected).value, path, differences)
     return
   }
 
   if (isArrayContaining(expected)) {
     const {matches} = matchArrayContaining(actual, /**
                                                     * Narrows the runtime value to the documented type.
-                                                     @type {Array<?>} */ (/**
+                                                    * @type {Array<?>} */ (/**
                                                                            * Narrows the runtime value to the documented type.
-                                                                            @type {?} */ (expected).value))
+                                                                           * @type {?} */ (expected).value))
 
     if (!matches) {
       differences[path || "$"] = [expected, actual]
@@ -148,10 +148,10 @@ function collectMatchDifferences(actual, expected, path, differences) {
 
     const expectedObject = /**
                             * Narrows the runtime value to the documented type.
-                             @type {Record<string, ?>} */ (expected)
+                            * @type {Record<string, ?>} */ (expected)
     const actualObject = /**
                           * Narrows the runtime value to the documented type.
-                           @type {Record<string, ?>} */ (actual)
+                          * @type {Record<string, ?>} */ (actual)
 
     for (const key of Object.keys(expectedObject)) {
       const nextPath = path ? `${path}.${key}` : key
@@ -181,7 +181,7 @@ function collectMatchDifferences(actual, expected, path, differences) {
 function matchObject(actual, expected) {
   /**
    * Differences.
-    @type {Record<string, Array<?>>} */
+   * @type {Record<string, Array<?>>} */
   const differences = {}
 
   collectMatchDifferences(actual, expected, "", differences)
@@ -201,7 +201,7 @@ function matchObject(actual, expected) {
 function matchArrayContaining(actual, expected) {
   /**
    * Differences.
-    @type {Record<string, Array<?>>} */
+   * @type {Record<string, Array<?>>} */
   const differences = {}
 
   if (!Array.isArray(actual)) {
@@ -220,7 +220,7 @@ function matchArrayContaining(actual, expected) {
       if (isObjectContaining(expectedItem)) {
         const {matches} = matchObject(actual[i], /**
                                                   * Narrows the runtime value to the documented type.
-                                                   @type {?} */ (expectedItem).value)
+                                                  * @type {?} */ (expectedItem).value)
         if (matches) {
           matchedIndex = i
           break
@@ -231,7 +231,7 @@ function matchArrayContaining(actual, expected) {
       if (isArrayContaining(expectedItem)) {
         const {matches} = matchArrayContaining(actual[i], /**
                                                            * Narrows the runtime value to the documented type.
-                                                            @type {?} */ (expectedItem).value)
+                                                           * @type {?} */ (expectedItem).value)
         if (matches) {
           matchedIndex = i
           break

package/build/testing/expect.js

@@ -22,7 +22,7 @@ export default class Expect extends BaseExpect {
 
     /**
      * Narrows the runtime value to the documented type.
-      @type {Array<Expect | ExpectToChange>} */
+     * @type {Array<Expect | ExpectToChange>} */
     this.expectations = []
   }
 
@@ -456,7 +456,7 @@ export default class Expect extends BaseExpect {
     if (isObjectContaining(result)) {
       const expectedValue = /**
                              * Narrows the runtime value to the documented type.
-                              @type {?} */ (result).value
+                             * @type {?} */ (result).value
       const {matches, differences} = matchObject(this._object, expectedValue)
       const objectPrint = formatValue(this._object)
       const expectedPrint = formatValue(expectedValue)
@@ -477,9 +477,9 @@ export default class Expect extends BaseExpect {
     if (isArrayContaining(result)) {
       const expectedValue = /**
                              * Narrows the runtime value to the documented type.
-                              @type {Array<?>} */ (/**
+                             * @type {Array<?>} */ (/**
                                                     * Narrows the runtime value to the documented type.
-                                                     @type {?} */ (result).value)
+                                                    * @type {?} */ (result).value)
       const {matches, differences} = matchArrayContaining(this._object, expectedValue)
       const objectPrint = formatValue(this._object)
       const expectedPrint = formatValue(expectedValue)
@@ -745,11 +745,11 @@ export default class Expect extends BaseExpect {
 
     /**
      * Differences.
-      @type {Record<string, Array<?>>} */
+     * @type {Record<string, Array<?>>} */
     const differences = {}
     const objectAsRecord = /**
                             * Narrows the runtime value to the documented type.
-                             @type {Record<string, ?>} */ (this._object)
+                            * @type {Record<string, ?>} */ (this._object)
 
     for (const key in result) {
       const value = result[key]
@@ -758,7 +758,7 @@ export default class Expect extends BaseExpect {
 
       const objectValue = /**
                            * Narrows the runtime value to the documented type.
-                            @type {() => ?} */ (objectAsRecord[key])()
+                           * @type {() => ?} */ (objectAsRecord[key])()
 
       if (value != objectValue) {
         differences[key] = [value, objectValue]

package/build/testing/test-files-finder.js

@@ -39,42 +39,42 @@ export default class TestFilesFinder {
 
     /**
      * Narrows the runtime value to the documented type.
-      @type {string[]} */
+     * @type {string[]} */
     this.foundFiles = []
 
     /**
      * Narrows the runtime value to the documented type.
-      @type {Record<number, Promise<void>>} */
+     * @type {Record<number, Promise<void>>} */
     this.findingPromises = {}
 
     /**
      * Narrows the runtime value to the documented type.
-      @type {string[]} */
+     * @type {string[]} */
     this.testArgs = this.processArgs.filter((processArg, index) => index != 0)
 
     /**
      * Narrows the runtime value to the documented type.
-      @type {string[]} */
+     * @type {string[]} */
     this.directoryArgs = []
 
     /**
      * Narrows the runtime value to the documented type.
-      @type {string[]} */
+     * @type {string[]} */
     this.directoryFullPaths = []
 
     /**
      * Narrows the runtime value to the documented type.
-      @type {string[]} */
+     * @type {string[]} */
     this.fileArgs = []
 
     /**
      * Narrows the runtime value to the documented type.
-      @type {string[]} */
+     * @type {string[]} */
     this.explicitFiles = []
 
     /**
      * Narrows the runtime value to the documented type.
-      @type {Record<string, number[]>} */
+     * @type {Record<string, number[]>} */
     this.lineFiltersByFile = {}
 
     this._argsPrepared = false

package/build/testing/test-filter-parser.js

@@ -74,11 +74,11 @@ export function parseFilters(processArgs) {
 
   /**
    * Defines groups.
-    @type {number | undefined} */
+   * @type {number | undefined} */
   let groups
   /**
    * Defines groupNumber.
-    @type {number | undefined} */
+   * @type {number | undefined} */
   let groupNumber
 
   let inRestArgs = false

package/build/testing/test-runner.js

@@ -39,11 +39,11 @@ function runWithTimeout(promise, timeoutMs, testDescription) {
 
 /**
  * ConsoleMethodName type.
-  @typedef {"log" | "info" | "warn" | "error" | "debug"} ConsoleMethodName */
+ * @typedef {"log" | "info" | "warn" | "error" | "debug"} ConsoleMethodName */
 
 /**
  * Captured console methods.
-  @type {ConsoleMethodName[]} */
+ * @type {ConsoleMethodName[]} */
 const CAPTURED_CONSOLE_METHODS = ["log", "info", "warn", "error", "debug"]
 
 /**
@@ -149,12 +149,12 @@ function toFileSlug(value) {
 export default class TestRunner {
   /**
    * Narrows the runtime value to the documented type.
-    @type {ActiveAfterAllScopeEntry[]} */
+   * @type {ActiveAfterAllScopeEntry[]} */
   _activeAfterAllScopes
 
   /**
    * Narrows the runtime value to the documented type.
-    @type {FailedTestDetail[]} */
+   * @type {FailedTestDetail[]} */
   _failedTestDetails
 
   /**
@@ -343,7 +343,7 @@ export default class TestRunner {
   getExcludeTagSet() {
     /**
      * Config tags.
-      @type {string[]} */
+     * @type {string[]} */
     const configTags = Array.isArray(testConfig.excludeTags) ? testConfig.excludeTags : []
 
     return new Set([...this._excludeTags, ...configTags])
@@ -379,7 +379,7 @@ export default class TestRunner {
       const testData = tests.tests[testDescription]
       const testArgs = /**
                         * Narrows the runtime value to the documented type.
-                         @type {TestArgs} */ (Object.assign({}, testData.args))
+                        * @type {TestArgs} */ (Object.assign({}, testData.args))
       const includeByLine = lineMatchedInScope || this.matchesLineFilter(testData)
 
       if (this._onlyFocussed && !testArgs.focus) continue
@@ -719,7 +719,7 @@ export default class TestRunner {
 
     if (!shouldRunAnyTests) return
 
-    /** Scope entry. @type {ActiveAfterAllScopeEntry} */
+    /** @type {ActiveAfterAllScopeEntry} */
     const scopeEntry = {tests, afterAllsRun: false}
     this._activeAfterAllScopes.push(scopeEntry)
 
@@ -732,7 +732,7 @@ export default class TestRunner {
         const testData = tests.tests[testDescription]
         const testArgs = /**
                           * Narrows the runtime value to the documented type.
-                           @type {TestArgs} */ (Object.assign({}, testData.args))
+                          * @type {TestArgs} */ (Object.assign({}, testData.args))
         const includeByLine = scopeLineMatch || this.matchesLineFilter(testData)
 
         if (this._onlyFocussed && !testArgs.focus) continue
@@ -757,7 +757,7 @@ export default class TestRunner {
         let attemptNumber = 1
         /**
          * Attempt console outputs.
-          @type {AttemptConsoleOutput[]} */
+         * @type {AttemptConsoleOutput[]} */
         const attemptConsoleOutputs = []
 
         console.log(`${leftPadding}it ${testDescription}`)
@@ -766,15 +766,15 @@ export default class TestRunner {
           let shouldRetry = false
           /**
            * Defines caughtError.
-            @type {?} */
+           * @type {?} */
           let caughtError
           /**
            * Defines failedError.
-            @type {?} */
+           * @type {?} */
           let failedError
           /**
            * Defines lastError.
-            @type {?} */
+           * @type {?} */
           let lastError
           let willRetry = false
           const stopConsoleCapture = this.startConsoleCapture({
@@ -1120,17 +1120,17 @@ export default class TestRunner {
   startConsoleCapture({passthrough = false} = {}) {
     /**
      * Lines.
-      @type {string[]} */
+     * @type {string[]} */
     const lines = []
     /**
      * Console object.
-      @type {Record<ConsoleMethodName, (...args: Array<?>) => void>} */
+     * @type {Record<ConsoleMethodName, (...args: Array<?>) => void>} */
     const consoleObject = /**
                            * Narrows the runtime value to the documented type.
-                            @type {Record<ConsoleMethodName, (...args: Array<?>) => void>} */ (console)
+                           * @type {Record<ConsoleMethodName, (...args: Array<?>) => void>} */ (console)
     /**
      * Original console methods.
-      @type {Record<ConsoleMethodName, (...args: Array<?>) => void>} */
+     * @type {Record<ConsoleMethodName, (...args: Array<?>) => void>} */
     const originalConsoleMethods = {
       debug: consoleObject.debug.bind(console),
       error: consoleObject.error.bind(console),

package/build/testing/test-suite-splitter.js

@@ -140,7 +140,7 @@ export default class TestSuiteSplitter {
   distributeGreedily(sortedFiles) {
     /**
      * Buckets.
-      @type {GroupBucket[]} */
+     * @type {GroupBucket[]} */
     const buckets = []
 
     for (let i = 0; i < this._groups; i++) {

package/build/testing/test.js

@@ -8,25 +8,25 @@ import {arrayContaining, objectContaining} from "./expect-utils.js"
 
 /**
  * Tests.
-  @type {import("./test-runner.js").TestsArgument} */
+ * @type {import("./test-runner.js").TestsArgument} */
 const tests = {
   /**
    * Narrows the runtime value to the documented type.
-    @type {import("./test-runner.js").AfterBeforeEachCallbackObjectType[]} */
+   * @type {import("./test-runner.js").AfterBeforeEachCallbackObjectType[]} */
   afterEaches: [],
   /**
    * Narrows the runtime value to the documented type.
-    @type {import("./test-runner.js").BeforeAfterAllCallbackObjectType[]} */
+   * @type {import("./test-runner.js").BeforeAfterAllCallbackObjectType[]} */
   afterAlls: [],
   args: {},
 
   /**
    * Narrows the runtime value to the documented type.
-    @type {import("./test-runner.js").BeforeAfterAllCallbackObjectType[]} */
+   * @type {import("./test-runner.js").BeforeAfterAllCallbackObjectType[]} */
   beforeAlls: [],
   /**
    * Narrows the runtime value to the documented type.
-    @type {import("./test-runner.js").AfterBeforeEachCallbackObjectType[]} */
+   * @type {import("./test-runner.js").AfterBeforeEachCallbackObjectType[]} */
   beforeEaches: [],
   filePath: undefined,
   line: undefined,
@@ -99,7 +99,7 @@ function normalizeTags(tags) {
 
 /**
  * Test config.
-  @type {VelociousTestConfig} */
+ * @type {VelociousTestConfig} */
 const testConfig = {
   consoleOutput: "failure",
   failedConsoleOutputMaxLines: 200,
@@ -212,7 +212,7 @@ function afterAll(callback) {
 async function describe(description, arg1, arg2) {
   /**
    * Defines testArgs.
-    @type {Record<string, ?>} */
+   * @type {Record<string, ?>} */
   let testArgs, testFunction
 
   if (typeof arg2 == "function") {
@@ -278,23 +278,23 @@ function it(description, arg1, arg2) {
   const currentTest = currentPath[currentPath.length - 1]
   /**
    * Defines testArgs.
-    @type {Record<string, ?>} */
+   * @type {Record<string, ?>} */
   let testArgs
 
   /**
    * Defines testFunction.
-    @type {() => (void|Promise<void>)} */
+   * @type {() => (void|Promise<void>)} */
   let testFunction
 
   if (typeof arg1 == "function") {
     testFunction = /**
                     * Narrows the runtime value to the documented type.
-                     @type {() => (void|Promise<void>)} */ (arg1)
+                    * @type {() => (void|Promise<void>)} */ (arg1)
     testArgs = {}
   } else if (typeof arg2 == "function") {
     testFunction = /**
                     * Narrows the runtime value to the documented type.
-                     @type {() => (void|Promise<void>)} */ (arg2)
+                    * @type {() => (void|Promise<void>)} */ (arg2)
     testArgs = arg1
   } else {
     throw new Error(`Invalid arguments for it: ${description}, ${arg1}`)
@@ -322,23 +322,23 @@ function it(description, arg1, arg2) {
 function fit(description, arg1, arg2) {
   /**
    * Defines testArgs.
-    @type {Record<string, ?>} */
+   * @type {Record<string, ?>} */
   let testArgs
 
   /**
    * Defines testFunction.
-    @type {() => (void|Promise<void>)} */
+   * @type {() => (void|Promise<void>)} */
   let testFunction
 
   if (typeof arg1 == "function") {
     testFunction = /**
                     * Narrows the runtime value to the documented type.
-                     @type {() => (void|Promise<void>)} */ (arg1)
+                    * @type {() => (void|Promise<void>)} */ (arg1)
     testArgs = {focus: true}
   } else if (typeof arg2 == "function") {
     testFunction = /**
                     * Narrows the runtime value to the documented type.
-                     @type {() => (void|Promise<void>)} */ (arg2)
+                    * @type {() => (void|Promise<void>)} */ (arg2)
     testArgs = Object.assign({focus: true}, arg1)
   } else {
     throw new Error(`Invalid arguments for it: ${description}, ${arg1}`)

package/build/utils/backtrace-cleaner.js

@@ -107,7 +107,7 @@ function relativeApplicationPath(sourcePath, applicationDirectory) {
 export default class BacktraceCleaner {
   /**
    * Framework source directory.
-    @type {string | undefined} */
+   * @type {string | undefined} */
   frameworkSourceDirectory = undefined
 
   /**

package/build/utils/format-value.js

@@ -51,7 +51,7 @@ function minifiedStringify(value) {
 
     /**
      * Output.
-      @type {Record<string, ?>} */
+     * @type {Record<string, ?>} */
     const output = {}
 
     for (const key of Object.keys(current)) {

package/build/utils/model-scope.js

@@ -52,5 +52,5 @@ export function defineModelScope({callback, modelClass, startQuery}) {
 export function isModelScopeDescriptor(value) {
   return Boolean(value && typeof value === "object" && /**
                                                         * Narrows the runtime value to the documented type.
-                                                         @type {Record<string, ?>} */ (value)[MODEL_SCOPE_DESCRIPTOR_MARKER] === true)
+                                                        * @type {Record<string, ?>} */ (value)[MODEL_SCOPE_DESCRIPTOR_MARKER] === true)
 }