velocious 1.0.563 → 1.0.564

package/src/testing/test.js

@@ -7,6 +7,14 @@ import Expect from "./expect.js"
 import waitForEvent from "./wait-for-event.js"
 import {arrayContaining, objectContaining} from "./expect-utils.js"
 
+/**
+ * VelociousTestConfig type.
+ * @typedef {object} VelociousTestConfig
+ * @property {"failure" | "live"} consoleOutput - Console output mode.
+ * @property {string[]} excludeTags - Tags excluded by default.
+ * @property {number} defaultTimeoutSeconds - Default timeout in seconds.
+ * @property {number} failedConsoleOutputMaxLines - Maximum failed console lines to print inline.
+ */
 /**
  * Tests.
  * @type {import("./test-runner.js").TestsArgument} */
@@ -202,7 +210,6 @@ function afterAll(callback) {
   currentTest.afterAlls.push({callback})
 }
 
-
 /**
  * Runs describe.
  * @param {string} description - Description.
@@ -353,11 +360,3 @@ globalThis.testEvents = testEvents
 globalThis.configureTests = configureTests
 
 export {afterAll, afterEach, beforeAll, beforeEach, configureTests, describe, expect, fit, it, arrayContaining, objectContaining, testConfig, testEvents, tests, waitForEvent}
-/**
- * VelociousTestConfig type.
- * @typedef {object} VelociousTestConfig
- * @property {"failure" | "live"} consoleOutput - Console output mode.
- * @property {string[]} excludeTags - Tags excluded by default.
- * @property {number} defaultTimeoutSeconds - Default timeout in seconds.
- * @property {number} failedConsoleOutputMaxLines - Maximum failed console lines to print inline.
- */

package/src/utils/backtrace-cleaner.js

@@ -1,3 +1,11 @@
+/**
+ * ParsedStackFrame type.
+ * @typedef {object} ParsedStackFrame
+ * @property {string | undefined} methodName - Method/function name from the stack frame.
+ * @property {string} sourcePath - File or URL path from the stack frame.
+ * @property {number} lineNumber - Source line number.
+ * @property {number | undefined} columnNumber - Source column number.
+ */
 // @ts-check
 
 /**
@@ -9,15 +17,6 @@ function escapeRegExp(value) {
   return value.replace(/[.*+?^${}()|[\]\\]/g, "\\$&")
 }
 
-/**
- * ParsedStackFrame type.
- * @typedef {object} ParsedStackFrame
- * @property {string | undefined} methodName - Method/function name from the stack frame.
- * @property {string} sourcePath - File or URL path from the stack frame.
- * @property {number} lineNumber - Source line number.
- * @property {number | undefined} columnNumber - Source column number.
- */
-
 /**
  * Runs normalize path.
  * @param {string | undefined} value - Path or file URL.

package/src/utils/model-scope.js

@@ -1,7 +1,3 @@
-// @ts-check
-
-const MODEL_SCOPE_DESCRIPTOR_MARKER = "velociousModelScopeDescriptor"
-
 /**
  * ModelScopeDescriptor type.
  * @typedef {object} ModelScopeDescriptor
@@ -10,6 +6,9 @@ const MODEL_SCOPE_DESCRIPTOR_MARKER = "velociousModelScopeDescriptor"
  * @property {typeof import("../database/record/index.js").default | import("../frontend-models/base.js").FrontendModelClass} modelClass - Owning model class.
  * @property {Array<?>} scopeArgs - Scope arguments.
  */
+// @ts-check
+
+const MODEL_SCOPE_DESCRIPTOR_MARKER = "velociousModelScopeDescriptor"
 
 /**
  * Runs the defineModelScope helper.

package/src/utils/ransack.js

@@ -4,50 +4,24 @@ import * as inflection from "inflection"
 import {isPlainObject} from "is-plain-object"
 import {resolveFrontendModelClass} from "../frontend-models/model-registry.js"
 
-/** Error raised when a Ransack descriptor is malformed. */
-export class RansackQueryError extends Error {
-  /**
-   * Creates a Ransack query error.
-   * @param {string} message - Error message.
-   */
-  constructor(message) {
-    super(message)
-
-    this.name = "RansackQueryError"
-  }
-}
-
-/**
- * Builds a Ransack query error.
- * @param {string} message - Error message.
- * @returns {RansackQueryError} - Ransack query error.
- */
-function ransackQueryError(message) {
-  return new RansackQueryError(message)
-}
-
 /**
  * RansackPredicate type.
  * @typedef {"cont" | "end" | "eq" | "gt" | "gteq" | "in" | "lt" | "lteq" | "not_eq" | "not_in" | "null" | "start"} RansackPredicate
  */
-
 /**
  * RansackCombinator type.
  * @typedef {"and" | "or"} RansackCombinator
  */
-
 /**
  * RansackModelClass type.
  * @typedef {typeof import("../database/record/index.js").default | import("../frontend-models/base.js").FrontendModelClass} RansackModelClass
  */
-
 /**
  * RansackAttribute type.
  * @typedef {object} RansackAttribute
  * @property {string} attributeName - Resolved attribute name.
  * @property {string[]} path - Resolved relationship path.
  */
-
 /**
  * RansackCondition type.
  * @typedef {object} RansackCondition
@@ -56,7 +30,6 @@ function ransackQueryError(message) {
  * @property {RansackPredicate} predicate - Parsed Ransack predicate.
  * @property {?} value - Normalized value.
  */
-
 /**
  * RansackGroup type.
  * @typedef {object} RansackGroup
@@ -64,6 +37,33 @@ function ransackQueryError(message) {
  * @property {RansackCondition[]} conditions - Conditions in this group.
  * @property {RansackGroup[]} groupings - Nested groups.
  */
+/**
+ * RansackSort type.
+ * @typedef {object} RansackSort
+ * @property {string} attribute - Resolved attribute name.
+ * @property {"asc" | "desc"} direction - Sort direction.
+ */
+/** Error raised when a Ransack descriptor is malformed. */
+export class RansackQueryError extends Error {
+  /**
+   * Creates a Ransack query error.
+   * @param {string} message - Error message.
+   */
+  constructor(message) {
+    super(message)
+
+    this.name = "RansackQueryError"
+  }
+}
+
+/**
+ * Builds a Ransack query error.
+ * @param {string} message - Error message.
+ * @returns {RansackQueryError} - Ransack query error.
+ */
+function ransackQueryError(message) {
+  return new RansackQueryError(message)
+}
 
 const supportedPredicates = [
   "not_in",
@@ -803,13 +803,6 @@ function normalizeRansackArray(value) {
   return [value]
 }
 
-/**
- * RansackSort type.
- * @typedef {object} RansackSort
- * @property {string} attribute - Resolved attribute name.
- * @property {"asc" | "desc"} direction - Sort direction.
- */
-
 /**
  * Parses a ransack `s` sort string against model attributes.
  * @param {RansackModelClass} modelClass - Model class for attribute lookup.