@synnaxlabs/x 0.42.1 → 0.43.0

package/src/spatial/bounds/bounds.ts

@@ -15,37 +15,117 @@ export { type Bounds, bounds };
 
 export type Crude<T extends numeric.Value = number> = CrudeBounds<T>;
 
-export interface Construct {
+/** Options for the `construct` function. */
+interface ConstructOptions {
   /**
-   * Constructs a bounds object from the given crude bounds.
+   * If true (default), automatically swaps the lower and upper bounds if the lower bound
+   * is greater than the upper bound. This ensures the resulting bounds are valid.
+   *
+   * @example
+   * // With makeValid: true (default)
+   * construct(10, 0) // => { lower: 0, upper: 10 }
    *
-   * @param bounds - The crude bounds to construct. Can either be a strict bounds object
-   * with a 'lower' and 'upper' property or an array of length 2. If the bounds are
-   * invalid i.e., the lower bound is greater than the upper bound, the bounds are
-   * swapped.
+   * @example
+   * // With makeValid: false
+   * construct(10, 0, { makeValid: false }) // => { lower: 10, upper: 0 }
    */
-  <T extends numeric.Value = number>(bounds: Crude<T>): Bounds<T>;
+  makeValid?: boolean;
+}
 
+export interface Construct {
   /**
-   * Constructs a bounds object from the given lower and upper bounds.
-   * @param lower - The lower bound of the new bounds object.
-   * @param upper - The upper bound of the new bounds object.
+   * Constructs a bounds object from various input formats. The function supports multiple
+   * overloads to handle different input types:
+   *
+   * 1. From a crude bounds object or array:
+   * ```typescript
+   * construct({ lower: 0, upper: 10 }) // => { lower: 0, upper: 10 }
+   * construct([0, 10]) // => { lower: 0, upper: 10 }
+   * ```
+   *
+   * 2. From separate lower and upper values:
+   * ```typescript
+   * construct(0, 10) // => { lower: 0, upper: 10 }
+   * construct(10) // => { lower: 0, upper: 10 }
+   * ```
+   *
+   * The function supports both number and bigint types through the generic parameter T.
+   * By default, T is number.
+   *
+   * Options:
+   * - makeValid: If true (default), swaps lower and upper bounds if lower > upper
+   *
+   * @param bounds - The input bounds to construct from. Can be:
+   *   - A bounds object with lower and upper properties
+   *   - An array of length 2 [lower, upper]
+   *   - A single number/bigint (treated as upper bound, with lower = 0)
+   *   - Two numbers/bigints (lower and upper bounds)
+   * @param options - Optional configuration for bounds construction
+   * @returns A bounds object with lower and upper properties
+   *
+   * @example
+   * // From bounds object
+   * construct({ lower: 0, upper: 10 })
+   * // => { lower: 0, upper: 10 }
    *
-   * If only one argument is provided, it is assumed to be the upper bound and the lower
-   * bound is set to 0.
+   * @example
+   * // From array
+   * construct([0, 10])
+   * // => { lower: 0, upper: 10 }
    *
-   * If the lower bound is greater than the upper bound, the bounds are swapped.
+   * @example
+   * // From separate values
+   * construct(0, 10)
+   * // => { lower: 0, upper: 10 }
+   *
+   * @example
+   * // Single value (upper bound only)
+   * construct(10)
+   * // => { lower: 0, upper: 10 }
+   *
+   * @example
+   * // With bigint
+   * construct(0n, 10n)
+   * // => { lower: 0n, upper: 10n }
+   *
+   * @example
+   * // Invalid bounds (lower > upper)
+   * construct(10, 0)
+   * // => { lower: 0, upper: 10 } (bounds are swapped)
    */
-  <T extends numeric.Value = number>(lower: T, upper?: T): Bounds<T>;
+  <T extends numeric.Value = number>(
+    bounds: Crude<T>,
+    options?: ConstructOptions,
+  ): Bounds<T>;
 
-  <T extends numeric.Value = number>(lower: T | Crude, upper?: T): Bounds<T>;
+  /**
+   * Constructs a bounds object from separate lower and upper values.
+   *
+   * @param lower - The lower bound value
+   * @param upper - The upper bound value. If omitted, lower is used as the upper bound
+   * and 0 is used as the lower bound
+   * @returns A bounds object with lower and upper properties
+   */
+  <T extends numeric.Value = number>(lower: T, upper?: T | ConstructOptions): Bounds<T>;
+
+  <T extends numeric.Value = number>(
+    lower: T | Crude,
+    upper?: T | ConstructOptions,
+    options?: ConstructOptions,
+  ): Bounds<T>;
 }
 
 export const construct = <T extends numeric.Value>(
   lower: T | Crude<T>,
-  upper?: T,
+  upper?: T | ConstructOptions,
+  options?: ConstructOptions,
 ): Bounds<T> => {
   const b: Bounds<T> = {} as const as Bounds<T>;
+  if (typeof upper === "object") {
+    options = upper;
+    upper = undefined;
+  }
+  options = { makeValid: true, ...options };
   if (typeof lower === "number" || typeof lower === "bigint")
     if (upper != null) {
       b.lower = lower;
@@ -57,8 +137,11 @@ export const construct = <T extends numeric.Value>(
   else if (Array.isArray(lower)) {
     if (lower.length !== 2) throw new Error("bounds: expected array of length 2");
     [b.lower, b.upper] = lower;
-  } else return makeValid(lower);
-  return makeValid(b);
+  } else {
+    b.lower = lower.lower;
+    b.upper = lower.upper;
+  }
+  return options?.makeValid ? makeValid<T>(b) : b;
 };
 
 /** A lower and upper bound of 0. */

package/src/spatial/box/box.ts

@@ -7,7 +7,7 @@
 // License, use of this software will be governed by the Apache License, Version 2.0,
 // included in the file licenses/APL.txt.
 
-import { z } from "zod";
+import { z } from "zod/v4";
 
 import type * as bounds from "@/spatial/bounds/bounds";
 import type * as dimensions from "@/spatial/dimensions/dimensions";

package/src/spatial/dimensions/dimensions.ts

@@ -7,11 +7,11 @@
 // License, use of this software will be governed by the Apache License, Version 2.0,
 // included in the file licenses/APL.txt.
 
-import { z } from "zod";
+import { z } from "zod/v4";
 
-import { type Dimensions, dimensions, numberCouple,xy } from "@/spatial/base";
+import { type Dimensions, dimensions, numberCouple, xy } from "@/spatial/base";
 
-export { type Dimensions,dimensions };
+export { type Dimensions, dimensions };
 
 export const signed = z.object({ signedWidth: z.number(), signedHeight: z.number() });
 export const crude = z.union([dimensions, signed, xy, numberCouple]);

package/src/spatial/location/location.ts

@@ -7,7 +7,7 @@
 // License, use of this software will be governed by the Apache License, Version 2.0,
 // included in the file licenses/APL.txt.
 
-import { z } from "zod";
+import { z } from "zod/v4";
 
 import { caseconv } from "@/caseconv";
 import {

package/src/spatial/scale/scale.ts

@@ -7,7 +7,7 @@
 // License, use of this software will be governed by the Apache License, Version 2.0,
 // included in the file licenses/APL.txt.
 
-import { z } from "zod";
+import { z } from "zod/v4";
 
 import { clamp } from "@/clamp/clamp";
 import { type numeric } from "@/numeric";

package/src/spatial/xy/xy.ts

@@ -7,7 +7,7 @@
 // License, use of this software will be governed by the Apache License, Version 2.0,
 // included in the file licenses/APL.txt.
 
-import { z } from "zod";
+import { z } from "zod/v4";
 
 import {
   type ClientXY,

package/src/status/index.ts

@@ -0,0 +1,10 @@
+// Copyright 2025 Synnax Labs, Inc.
+//
+// Use of this software is governed by the Business Source License included in the file
+// licenses/BSL.txt.
+//
+// As of the Change Date specified in that file, in accordance with the Business Source
+// License, use of this software will be governed by the Apache License, Version 2.0,
+// included in the file licenses/APL.txt.
+
+export * as status from "@/status/types";

package/src/status/types.ts

@@ -0,0 +1,22 @@
+// Copyright 2025 Synnax Labs, Inc.
+//
+// Use of this software is governed by the Business Source License included in the file
+// licenses/BSL.txt.
+//
+// As of the Change Date specified in that file, in accordance with the Business Source
+// License, use of this software will be governed by the Apache License, Version 2.0,
+// included in the file licenses/APL.txt.
+
+import { z } from "zod/v4";
+
+export const variantZ = z.enum([
+  "success",
+  "info",
+  "warning",
+  "error",
+  "loading",
+  "disabled",
+]);
+
+// Represents one of the possible variants of a status message.
+export type Variant = z.infer<typeof variantZ>;

package/src/sync/index.ts

@@ -1 +1,10 @@
+// Copyright 2025 Synnax Labs, Inc.
+//
+// Use of this software is governed by the Business Source License included in the file
+// licenses/BSL.txt.
+//
+// As of the Change Date specified in that file, in accordance with the Business Source
+// License, use of this software will be governed by the Apache License, Version 2.0,
+// included in the file licenses/APL.txt.
+
 export * as sync from "@/sync/mutex";

package/src/sync/mutex.ts

@@ -1,12 +1,17 @@
+// Copyright 2025 Synnax Labs, Inc.
+//
+// Use of this software is governed by the Business Source License included in the file
+// licenses/BSL.txt.
+//
+// As of the Change Date specified in that file, in accordance with the Business Source
+// License, use of this software will be governed by the Apache License, Version 2.0,
+// included in the file licenses/APL.txt.
+
 import { Mutex as Core } from "async-mutex";
 
 export type Mutex<G> = G & Core;
 
 export class mutex<G> extends Core {
-  static new<G>(guard: G): Mutex<G> & G {
-    return new mutex(guard) as Mutex<G> & G;
-  }
-
   constructor(guard: G) {
     super();
     Object.assign(this, guard);

package/src/telem/gl.ts

@@ -7,7 +7,7 @@
 // License, use of this software will be governed by the Apache License, Version 2.0,
 // included in the file licenses/APL.txt.
 
-import { z } from "zod";
+import { z } from "zod/v4";
 
 export interface GLBufferController {
   createBuffer: () => WebGLBuffer | null;