@gesslar/toolkit 1.5.0 → 1.6.0

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@gesslar/toolkit",
-  "version": "1.5.0",
+  "version": "1.6.0",
   "description": "Get in, bitches, we're going toolkitting.",
   "main": "./src/index.js",
   "type": "module",
@@ -31,7 +31,7 @@
     "node": ">=20"
   },
   "scripts": {
-    "types:build": "tsc -p tsconfig.types.json",
+    "types:build": "node -e \"require('fs').rmSync('src/types',{recursive:true,force:true});\" && tsc -p tsconfig.types.json",
     "prepublishOnly": "npm run types:build",
     "lint": "eslint src/",
     "lint:fix": "eslint src/ --fix",

package/src/browser/lib/Data.js

@@ -27,7 +27,6 @@ export default class Data {
     "Undefined",
 
     // Object Categories from typeof
-    "AsyncFunction",
     "Function",
     "Object",
   ])
@@ -41,7 +40,6 @@ export default class Data {
   static constructors = Object.freeze([
   // Object Constructors
     "Array",
-    "AsyncFunction",
     "Date",
     "Error",
     "Float32Array",
@@ -192,11 +190,6 @@ export default class Data {
     if(type === "object")
       return value.constructor.name
 
-    if(type === "function") {
-      if(value.constructor.name === "AsyncFunction")
-        return "AsyncFunction"
-    }
-
     const [first, ...rest] = Array.from(type)
 
     return `${first?.toLocaleUpperCase() ?? ""}${rest.join("")}`

package/src/browser/lib/Disposer.js

@@ -6,8 +6,6 @@ import Valid from "./Valid.js"
  */
 export class Disposer {
   #disposers = []
-  #disposed = false
-  #noop = () => {}
 
   /**
    * Registers a disposer callback to be executed when disposed.
@@ -21,13 +19,6 @@ export class Disposer {
    */
   register(...disposers) {
     const normalized = this.#normalizeDisposers(disposers)
-
-    if(this.#disposed) {
-      return normalized.length === 1
-        ? this.#noop
-        : normalized.map(() => this.#noop)
-    }
-
     const unregisters = normalized.map(
       disposer => this.#registerDisposer(disposer)
     )
@@ -36,7 +27,7 @@ export class Disposer {
   }
 
   #registerDisposer(disposer) {
-    if(this.#disposed || typeof disposer !== "function")
+    if(typeof disposer !== "function")
       return () => {}
 
     this.#disposers.push(disposer)
@@ -50,11 +41,6 @@ export class Disposer {
    * @returns {void}
    */
   dispose() {
-    if(this.#disposed)
-      return
-
-    this.#disposed = true
-
     const errors = []
     this.#disposers.toReversed().forEach(disposer => {
       try {
@@ -81,15 +67,6 @@ export class Disposer {
     return normalized
   }
 
-  /**
-   * Whether disposal has run.
-   *
-   * @returns {boolean} True when dispose() has already been called.
-   */
-  get disposed() {
-    return this.#disposed
-  }
-
   /**
    * Read-only list of registered disposers.
    *

package/src/browser/lib/Util.js

@@ -1,7 +1,6 @@
-import Collection from "./Collection.js"
-import Data from "./Data.js"
 import Sass from "./Sass.js"
 import Valid from "./Valid.js"
+import Collection from "./Collection.js"
 
 /**
  * Utility class providing common helper functions for string manipulation,
@@ -255,13 +254,4 @@ export default class Util {
         .join("")
       , flags?.join(""))
   }
-
-  static disasyncify(func) {
-    Valid.type(func, "Function|AsyncFunction")
-
-    if(Data.isType(func, "Function"))
-      return func
-
-    return (async(...arg) => await func(...arg))()
-  }
 }

package/src/types/browser/lib/Data.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"Data.d.ts","sourceRoot":"","sources":["../../../browser/lib/Data.js"],"names":[],"mappings":"AAUA;IACA;;;;;OAKG;IACD,mBAFQ,KAAK,CAAC,MAAM,CAAC,CAiBnB;IAEF;;;;;OAKG;IACH,qBAFU,KAAK,CAAC,MAAM,CAAC,CAoBrB;IAEF;;;;;;;OAOG;IACH,kBAFU,KAAK,CAAC,MAAM,CAAC,CAKrB;IAEF;;;;;OAKG;IACH,uBAFU,KAAK,CAAC,MAAM,CAAC,CAE6C;IAEpE;;;;;;OAMG;IACH,4BAJW,MAAM,UACN,MAAM,GACJ,MAAM,CAIlB;IAED;;;;;;OAMG;IACH,6BAJW,MAAM,WACN,MAAM,GACJ,MAAM,CAIlB;IAED;;;;;;;OAOG;IACH,2BAJW,MAAM,WACN,MAAM,GACJ,KAAK,CAAC,MAAM,CAAC,CAIzB;IAED;;;;;;;OAOG;IACH,qBALW,OAAO,QACP,MAAM,GAAC,QAAQ,YACf,MAAM,GACJ,OAAO,CAQnB;IAED;;;;;OAKG;IACH,yBAHW,MAAM,GACJ,OAAO,CASnB;IAED;;;;;;;;OAQG;IACH,yBAJW,OAAO,QACP,MAAM,GACJ,OAAO,CAwBnB;IAED;;;;;OAKG;IACH,qBAHW,OAAO,GACL,MAAM,CAmBlB;IAED;;;;;OAKG;IACH,wBAHW,OAAO,GACL,OAAO,CAInB;IAED;;;;;;;;OAQG;IACH,sBALW,OAAO,oBACP,OAAO,GAEL,OAAO,CA2BnB;IAED;;;;;OAKG;IACH,6BAHW,MAAM,GACJ,MAAM,CAmBlB;IAED;;;;;;;OAOG;IACH,6BAJW,MAAM,QACN,KAAK,CAAC,MAAM,CAAC,GACX,MAAM,CAiBlB;IAED;;;;;;;OAOG;IACH,2BAJW,MAAM,QACN,KAAK,CAAC,MAAM,CAAC,SACb,OAAO,QAMjB;IAED;;;;;OAKG;IACH,+BAHc,MAAM,EAAA,GACP,MAAM,CAqBlB;IAED;;;;;;;OAOG;IACH,wBAJW,KAAK,CAAC,OAAO,CAAC,aACd,CAAC,KAAK,EAAE,OAAO,KAAK,OAAO,CAAC,OAAO,CAAC,GAClC,OAAO,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,CAMnC;IAED;;;;;;;OAOG;IACH,kBALW,MAAM,OACN,MAAM,OACN,MAAM,GACJ,MAAM,CAIlB;IAED;;;;;;;OAOG;IACH,oBALW,MAAM,OACN,MAAM,OACN,MAAM,GACJ,OAAO,CAInB;IAED;;;;;;;;;;;;;;;;;;;OAmBG;IACH,4BAbW,OAAO,GACL,OAAO,CA+BnB;IAED;;;;;;;;;;;;;;;OAeG;IACH,uBAXW,OAAO,GACL,OAAO,CAgBnB;CACF;qBAnboB,eAAe"}
+{"version":3,"file":"Data.d.ts","sourceRoot":"","sources":["../../../browser/lib/Data.js"],"names":[],"mappings":"AAUA;IACA;;;;;OAKG;IACD,mBAFQ,KAAK,CAAC,MAAM,CAAC,CAgBnB;IAEF;;;;;OAKG;IACH,qBAFU,KAAK,CAAC,MAAM,CAAC,CAmBrB;IAEF;;;;;;;OAOG;IACH,kBAFU,KAAK,CAAC,MAAM,CAAC,CAKrB;IAEF;;;;;OAKG;IACH,uBAFU,KAAK,CAAC,MAAM,CAAC,CAE6C;IAEpE;;;;;;OAMG;IACH,4BAJW,MAAM,UACN,MAAM,GACJ,MAAM,CAIlB;IAED;;;;;;OAMG;IACH,6BAJW,MAAM,WACN,MAAM,GACJ,MAAM,CAIlB;IAED;;;;;;;OAOG;IACH,2BAJW,MAAM,WACN,MAAM,GACJ,KAAK,CAAC,MAAM,CAAC,CAIzB;IAED;;;;;;;OAOG;IACH,qBALW,OAAO,QACP,MAAM,GAAC,QAAQ,YACf,MAAM,GACJ,OAAO,CAQnB;IAED;;;;;OAKG;IACH,yBAHW,MAAM,GACJ,OAAO,CASnB;IAED;;;;;;;;OAQG;IACH,yBAJW,OAAO,QACP,MAAM,GACJ,OAAO,CAwBnB;IAED;;;;;OAKG;IACH,qBAHW,OAAO,GACL,MAAM,CAclB;IAED;;;;;OAKG;IACH,wBAHW,OAAO,GACL,OAAO,CAInB;IAED;;;;;;;;OAQG;IACH,sBALW,OAAO,oBACP,OAAO,GAEL,OAAO,CA2BnB;IAED;;;;;OAKG;IACH,6BAHW,MAAM,GACJ,MAAM,CAmBlB;IAED;;;;;;;OAOG;IACH,6BAJW,MAAM,QACN,KAAK,CAAC,MAAM,CAAC,GACX,MAAM,CAiBlB;IAED;;;;;;;OAOG;IACH,2BAJW,MAAM,QACN,KAAK,CAAC,MAAM,CAAC,SACb,OAAO,QAMjB;IAED;;;;;OAKG;IACH,+BAHc,MAAM,EAAA,GACP,MAAM,CAqBlB;IAED;;;;;;;OAOG;IACH,wBAJW,KAAK,CAAC,OAAO,CAAC,aACd,CAAC,KAAK,EAAE,OAAO,KAAK,OAAO,CAAC,OAAO,CAAC,GAClC,OAAO,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,CAMnC;IAED;;;;;;;OAOG;IACH,kBALW,MAAM,OACN,MAAM,OACN,MAAM,GACJ,MAAM,CAIlB;IAED;;;;;;;OAOG;IACH,oBALW,MAAM,OACN,MAAM,OACN,MAAM,GACJ,OAAO,CAInB;IAED;;;;;;;;;;;;;;;;;;;OAmBG;IACH,4BAbW,OAAO,GACL,OAAO,CA+BnB;IAED;;;;;;;;;;;;;;;OAeG;IACH,uBAXW,OAAO,GACL,OAAO,CAgBnB;CACF;qBA5aoB,eAAe"}

package/src/types/browser/lib/Disposer.d.ts

@@ -20,12 +20,6 @@ export class Disposer {
      * @returns {void}
      */
     dispose(): void;
-    /**
-     * Whether disposal has run.
-     *
-     * @returns {boolean} True when dispose() has already been called.
-     */
-    get disposed(): boolean;
     /**
      * Read-only list of registered disposers.
      *

package/src/types/browser/lib/Disposer.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"Disposer.d.ts","sourceRoot":"","sources":["../../../browser/lib/Disposer.js"],"names":[],"mappings":"AAEA;;;GAGG;AACH;IAKE;;;;;;;;;OASG;IACH,uBAHW,CAAG,CAAC,MAAM,IAAI,CAAC,GAAC,KAAK,CAAC,MAAM,IAAI,CAAC,GAAA,GAC/B,CAAC,MAAM,IAAI,CAAC,GAAC,KAAK,CAAC,MAAM,IAAI,CAAC,CAgB1C;IAWD;;;;OAIG;IACH,WAFa,IAAI,CAoBhB;IAcD;;;;OAIG;IACH,gBAFa,OAAO,CAInB;IAED;;;;OAIG;IACH,iBAFa,KAAK,CAAC,MAAM,IAAI,CAAC,CAI7B;;CAQF"}
+{"version":3,"file":"Disposer.d.ts","sourceRoot":"","sources":["../../../browser/lib/Disposer.js"],"names":[],"mappings":"AAEA;;;GAGG;AACH;IAGE;;;;;;;;;OASG;IACH,uBAHW,CAAG,CAAC,MAAM,IAAI,CAAC,GAAC,KAAK,CAAC,MAAM,IAAI,CAAC,GAAA,GAC/B,CAAC,MAAM,IAAI,CAAC,GAAC,KAAK,CAAC,MAAM,IAAI,CAAC,CAS1C;IAWD;;;;OAIG;IACH,WAFa,IAAI,CAehB;IAcD;;;;OAIG;IACH,iBAFa,KAAK,CAAC,MAAM,IAAI,CAAC,CAI7B;;CAQF"}

package/src/types/browser/lib/Util.d.ts

@@ -125,6 +125,5 @@ export default class Util {
      */
     static findClosestMatch(input: string, allowedValues: Array<string>, threshold?: number): string;
     static regexify(input: any, trim?: boolean, flags?: any[]): RegExp;
-    static disasyncify(func: any): any;
 }
 //# sourceMappingURL=Util.d.ts.map

package/src/types/browser/lib/Util.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"Util.d.ts","sourceRoot":"","sources":["../../../browser/lib/Util.js"],"names":[],"mappings":"AAKA;;;GAGG;AACH;IACE;;;;;OAKG;IACH,wBAHW,MAAM,GACJ,MAAM,CAYlB;IAED;;;;;;OAMG;IACH,YAJa,CAAC,MACH,MAAM,OAAO,CAAC,CAAC,CAAC,GACd,OAAO,CAAC;QAAC,MAAM,EAAE,CAAC,CAAC;QAAC,IAAI,EAAE,MAAM,CAAA;KAAC,CAAC,CAQ9C;IAED;;;;;;;OAOG;IACH,4BAJW,MAAM,GAAC,MAAM,UACb,MAAM,GACJ,MAAM,CAWlB;IAED;;;;;;;OAOG;IACH,6BAJW,MAAM,GAAC,MAAM,UACb,MAAM,GACJ,MAAM,CAalB;IAED;;;;;;OAMG;IACH,0BAHW,KAAK,CAAC,OAAO,CAAC,OAAO,CAAC,CAAC,GACrB,OAAO,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,CAInC;IAED;;;;;;OAMG;IACH,2BAHW,KAAK,CAAC,OAAO,CAAC,OAAO,CAAC,CAAC,GACrB,OAAO,CAAC,KAAK,CAAC,MAAM,CAAC,CAAC,CAIlC;IAED;;;;;OAKG;IACH,2BAHW,KAAK,CAAC,MAAM,CAAC,GACX,OAAO,CAInB;IAED;;;;;OAKG;IACH,kCAHW,KAAK,CAAC,MAAM,CAAC,GACX,KAAK,CAAC,MAAM,CAAC,CAIzB;IAED;;;;;OAKG;IACH,iCAHW,KAAK,CAAC,MAAM,CAAC,GACX,KAAK,CAAC,OAAO,CAAC,CAI1B;IAED;;;;;;OAMG;IACH,gCAJW,MAAM,YACN,KAAK,CAAC,MAAM,CAAC,QAKvB;IAED;;;;;OAKG;IACH,mCAHW,KAAK,CAAC,MAAM,CAAC,GACX,KAAK,CAAC,MAAM,CAAC,CAIzB;IAED;;;;;OAKG;IACH,+BAHW,KAAK,CAAC,MAAM,CAAC,GACX,KAAK,CAAC,OAAO,CAAC,CAI1B;IAED;;;;;;OAMG;IACH,sBAHW,KAAK,CAAC,OAAO,CAAC,OAAO,CAAC,CAAC,GACrB,OAAO,CAAC,OAAO,CAAC,CAI5B;IAED;;;;;;OAMG;IACH,8BAJW,MAAM,KACN,MAAM,GACJ,MAAM,CAsBlB;IAED;;;;;;;;OAQG;IACH,+BALW,MAAM,iBACN,KAAK,CAAC,MAAM,CAAC,cACb,MAAM,GACJ,MAAM,CAwBlB;IAED,mEAiBC;IAED,mCAOC;CACF"}
+{"version":3,"file":"Util.d.ts","sourceRoot":"","sources":["../../../browser/lib/Util.js"],"names":[],"mappings":"AAIA;;;GAGG;AACH;IACE;;;;;OAKG;IACH,wBAHW,MAAM,GACJ,MAAM,CAYlB;IAED;;;;;;OAMG;IACH,YAJa,CAAC,MACH,MAAM,OAAO,CAAC,CAAC,CAAC,GACd,OAAO,CAAC;QAAC,MAAM,EAAE,CAAC,CAAC;QAAC,IAAI,EAAE,MAAM,CAAA;KAAC,CAAC,CAQ9C;IAED;;;;;;;OAOG;IACH,4BAJW,MAAM,GAAC,MAAM,UACb,MAAM,GACJ,MAAM,CAWlB;IAED;;;;;;;OAOG;IACH,6BAJW,MAAM,GAAC,MAAM,UACb,MAAM,GACJ,MAAM,CAalB;IAED;;;;;;OAMG;IACH,0BAHW,KAAK,CAAC,OAAO,CAAC,OAAO,CAAC,CAAC,GACrB,OAAO,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,CAInC;IAED;;;;;;OAMG;IACH,2BAHW,KAAK,CAAC,OAAO,CAAC,OAAO,CAAC,CAAC,GACrB,OAAO,CAAC,KAAK,CAAC,MAAM,CAAC,CAAC,CAIlC;IAED;;;;;OAKG;IACH,2BAHW,KAAK,CAAC,MAAM,CAAC,GACX,OAAO,CAInB;IAED;;;;;OAKG;IACH,kCAHW,KAAK,CAAC,MAAM,CAAC,GACX,KAAK,CAAC,MAAM,CAAC,CAIzB;IAED;;;;;OAKG;IACH,iCAHW,KAAK,CAAC,MAAM,CAAC,GACX,KAAK,CAAC,OAAO,CAAC,CAI1B;IAED;;;;;;OAMG;IACH,gCAJW,MAAM,YACN,KAAK,CAAC,MAAM,CAAC,QAKvB;IAED;;;;;OAKG;IACH,mCAHW,KAAK,CAAC,MAAM,CAAC,GACX,KAAK,CAAC,MAAM,CAAC,CAIzB;IAED;;;;;OAKG;IACH,+BAHW,KAAK,CAAC,MAAM,CAAC,GACX,KAAK,CAAC,OAAO,CAAC,CAI1B;IAED;;;;;;OAMG;IACH,sBAHW,KAAK,CAAC,OAAO,CAAC,OAAO,CAAC,CAAC,GACrB,OAAO,CAAC,OAAO,CAAC,CAI5B;IAED;;;;;;OAMG;IACH,8BAJW,MAAM,KACN,MAAM,GACJ,MAAM,CAsBlB;IAED;;;;;;;;OAQG;IACH,+BALW,MAAM,iBACN,KAAK,CAAC,MAAM,CAAC,cACb,MAAM,GACJ,MAAM,CAwBlB;IAED,mEAiBC;CACF"}

package/src/browser/lib/Hook.js

@@ -1,82 +0,0 @@
-import Sass from "./Sass.js"
-import Valid from "./Valid.js"
-
-class PipeClass {
-  name = "Pipe"
-
-  #lastResult
-  #it = 0
-
-  constructor(func) {
-    Valid.type(func, "Function|AsyncFunction|Promise")
-
-    this.#processStart(func)
-  }
-
-  static source(func) {
-    return new this(func)
-  }
-
-  async then(func) {
-    if(++this.it > 2)
-      throw new Error("hi")
-
-    console.log("then", this.#lastResult, "func", func)
-
-    this.#lastResult =
-      this.#lastResult.then(prev => this.#resolve(func, prev))
-
-    return this
-    /*
-
-    this.#processThen(func)
-
-    return this
-    */
-  }
-
-  get value() {
-    return this.#processResult()
-  }
-
-  #processStart(func) {
-    console.log("start", func)
-
-    this.#lastResult = Promise.resolve(this.#resolve(func))
-  }
-
-  #processThen(func) {
-    if(++this.#it > 2)
-      throw new Error("hi")
-
-    this.#lastResult = this.#lastResult.then(prev => this.#resolve(func, prev))
-  }
-
-  #processResult() {
-    const result = this.#lastResult
-    this.#lastResult = undefined
-
-    return result
-  }
-
-  #resolve = (val, prev) => typeof val === "function" ? val(prev) : val
-}
-
-export default new Proxy(PipeClass, {
-  apply(target, _, argumentsList) {
-    return target.source(...argumentsList)
-  },
-
-  construct(..._) {
-    throw new Sass("This class may not be instantiated in this manner.")
-  },
-
-  get(target, prop) {
-    // Hide 'source' method from public API
-    if(prop === "source") {
-      return undefined
-    }
-
-    return Reflect.get(target, prop)
-  }
-})

package/src/browser/lib/test.js

@@ -1,25 +0,0 @@
-import {setTimeout as timeout} from "node:timers/promises"
-import Pipe from "./Hook.js"
-import Disposer from "./Disposer.js"
-
-const step1 = () => 1
-const step2 = num => num+1
-const step3 = num => num+1
-const step4 = async num => {
-  console.log("Waiting for",num,typeof num)
-  await timeout(5_000)
-
-  return num + 1
-}
-const step5 = num => num+1
-const step6 = num => num+1
-
-const result = await Pipe(step1)
-  .then(step2)
-  .then(step3)
-  .then(step4)
-  .then(step5)
-  .then(step6)
-  .result
-
-console.log("result", result)

package/src/browser/lib/test2.js

@@ -1,46 +0,0 @@
-import {setTimeout as timeout} from "node:timers/promises"
-
-const step1 = () => 1
-const step2 = num => num+1
-const step3 = num => num+1
-const step4 = async num => {
-  console.log("Waiting for",num,typeof num)
-  await timeout(5_000)
-
-  return num + 1
-}
-const step5 = num => num+1
-const step6 = num => num+1
-
-function Pipe(initialPromise) {
-  console.log("start", initialPromise)
-
-  const resolve = (val, prev) =>
-    typeof val === "function" ? val(prev) : val
-
-  let chain = Promise.resolve(resolve(initialPromise))
-
-  return {
-    then(promiseOrFn) {
-      console.log("then", chain, "func", promiseOrFn)
-
-      chain = chain.then(prev => resolve(promiseOrFn, prev))
-
-      return this
-    },
-
-    get result() {
-      return chain
-    }
-  }
-}
-
-const result = await Pipe(step1)
-  .then(step2)
-  .then(step3)
-  .then(step4)
-  .then(step5)
-  .then(step6)
-  .result
-
-console.log("result", result)

package/src/types/Cache.d.ts

@@ -1,30 +0,0 @@
-// Implementation: ../lib/Cache.js
-import FileObject from './FileObject.js'
-
-/**
- * File system cache for theme compilation data with automatic invalidation.
- * Provides intelligent caching of parsed JSON5/YAML files with mtime-based
- * cache invalidation to optimize parallel theme compilation performance.
- *
- * The cache eliminates redundant file reads and parsing when multiple themes
- * import the same dependency files, while ensuring data freshness through
- * modification time checking.
- */
-declare class Cache {
-  /**
-   * Loads and caches parsed file data with automatic invalidation based on
-   * modification time.
-   *
-   * Implements a sophisticated caching strategy that checks file modification
-   * times to determine whether cached data is still valid, ensuring data
-   * freshness while optimizing performance for repeated file access during
-   * parallel theme compilation.
-   *
-   * @param fileObject - The file object to load and cache
-   * @returns The parsed file data (JSON5 or YAML)
-   * @throws If the file cannot be found or accessed
-   */
-  loadCachedData(fileObject: FileObject): Promise<unknown>
-}
-
-export default Cache

package/src/types/Collection.d.ts

@@ -1,321 +0,0 @@
-// Implementation: ../lib/Collection.js
-// Type definitions for Collection utilities
-
-/**
- * Collection utility functions for evaluating and manipulating arrays, objects, sets, and maps.
- * Provides functional programming patterns for collection processing with consistent error handling.
- */
-export default class Collection {
-  /**
-   * Evaluates an array with a predicate function, returning the first truthy result.
-   *
-   * @param collection - The array to evaluate
-   * @param predicate - Function called for each element: (element, index, array) => result
-   * @param forward - Whether to iterate forward (true) or backward (false). Default: true
-   * @returns The first truthy result from the predicate, or undefined if none found
-   *
-   * @throws {Sass} If collection is not an Array or predicate is not a Function
-   *
-   * @example
-   * ```typescript
-   * import { Collection } from '@gesslar/toolkit'
-   *
-   * const numbers = [1, 2, 3, 4, 5]
-   * const result = Collection.evalArray(numbers, (n, i) => n > 3 ? n * 2 : null)
-   * console.log(result) // 8 (first element > 3, doubled)
-   * ```
-   */
-  static evalArray<T, R>(
-    collection: T[],
-    predicate: (element: T, index: number, array: T[]) => R | null | undefined,
-    forward?: boolean
-  ): R | undefined
-
-  /**
-   * Evaluates an object with a predicate function, returning the first truthy result.
-   *
-   * @param collection - The object to evaluate
-   * @param predicate - Function called for each property: (value, key, object) => result
-   * @returns The first truthy result from the predicate, or undefined if none found
-   *
-   * @throws {Sass} If collection is not an Object or predicate is not a Function
-   *
-   * @example
-   * ```typescript
-   * import { Collection } from '@gesslar/toolkit'
-   *
-   * const obj = {a: 1, b: 2, c: 3}
-   * const result = Collection.evalObject(obj, (value, key) => value > 2 ? `${key}:${value}` : null)
-   * console.log(result) // "c:3"
-   * ```
-   */
-  static evalObject<T, R>(
-    collection: Record<string, T>,
-    predicate: (value: T, key: string, object: Record<string, T>) => R | null | undefined
-  ): R | undefined
-
-  /**
-   * Evaluates a Set with a predicate function, returning the first truthy result.
-   *
-   * @param collection - The Set to evaluate
-   * @param predicate - Function called for each element: (element, set) => result
-   * @returns The first truthy result from the predicate, or undefined if none found
-   *
-   * @throws {Sass} If collection is not a Set or predicate is not a Function
-   *
-   * @example
-   * ```typescript
-   * import { Collection } from '@gesslar/toolkit'
-   *
-   * const set = new Set([1, 2, 3, 4, 5])
-   * const result = Collection.evalSet(set, (n, s) => n > 3 ? n * 2 : null)
-   * console.log(result) // 8
-   * ```
-   */
-  static evalSet<T, R>(
-    collection: Set<T>,
-    predicate: (element: T, set: Set<T>) => R | null | undefined
-  ): R | undefined
-
-  /**
-   * Evaluates a Map with a predicate function, returning the first truthy result.
-   *
-   * @param collection - The Map to evaluate
-   * @param predicate - Function called for each entry: (value, key, map) => result
-   * @param forward - Whether to iterate forward (true) or backward (false). Default: true
-   * @returns The first truthy result from the predicate, or undefined if none found
-   *
-   * @throws {Sass} If collection is not a Map or predicate is not a Function
-   *
-   * @example
-   * ```typescript
-   * import { Collection } from '@gesslar/toolkit'
-   *
-   * const map = new Map([['a', 1], ['b', 2], ['c', 3]])
-   * const result = Collection.evalMap(map, (value, key) => value > 2 ? `${key}:${value}` : null)
-   * console.log(result) // "c:3"
-   * ```
-   */
-  static evalMap<K, V, R>(
-    collection: Map<K, V>,
-    predicate: (value: V, key: K, map: Map<K, V>) => R | null | undefined,
-    forward?: boolean
-  ): R | undefined
-
-  /**
-   * Zips two arrays together into an array of pairs.
-   *
-   * @param array1 - The first array
-   * @param array2 - The second array
-   * @returns Array of [element1, element2] pairs, length of shorter input array
-   *
-   * @example
-   * ```typescript
-   * import { Collection } from '@gesslar/toolkit'
-   *
-   * const result = Collection.zip([1, 2, 3], ['a', 'b', 'c'])
-   * console.log(result) // [[1, 'a'], [2, 'b'], [3, 'c']]
-   * ```
-   */
-  static zip<T, U>(array1: T[], array2: U[]): [T, U][]
-
-  /**
-   * Unzips an array of arrays into separate arrays.
-   *
-   * @param array - Array of arrays to unzip
-   * @returns Array of separate arrays, one for each position
-   *
-   * @example
-   * ```typescript
-   * import { Collection } from '@gesslar/toolkit'
-   *
-   * const zipped = [[1, 'a'], [2, 'b'], [3, 'c']]
-   * const result = Collection.unzip(zipped)
-   * console.log(result) // [[1, 2, 3], ['a', 'b', 'c']]
-   * ```
-   */
-  static unzip<T>(array: T[][]): T[][]
-
-  /**
-   * Maps an array through an async function, executing operations sequentially.
-   *
-   * Unlike Promise.all(array.map(fn)), this executes each async operation
-   * one at a time, maintaining order and preventing overwhelming external resources.
-   *
-   * @param array - The array to map over
-   * @param asyncFn - Async function called for each element: (element) => Promise<result>
-   * @returns Promise resolving to array of mapped results
-   *
-   * @throws {Sass} If array is not an Array or asyncFn is not a Function
-   *
-   * @example
-   * ```typescript
-   * import { Collection } from '@gesslar/toolkit'
-   *
-   * // Sequential API calls (won't overwhelm server)
-   * const urls = ['url1', 'url2', 'url3']
-   * const responses = await Collection.asyncMap(urls, async (url) => {
-   *   return await fetch(url).then(r => r.json())
-   * })
-   * console.log(responses) // [data1, data2, data3]
-   *
-   * // Works with sync functions too
-   * const numbers = [1, 2, 3]
-   * const doubled = await Collection.asyncMap(numbers, async (n) => n * 2)
-   * console.log(doubled) // [2, 4, 6]
-   * ```
-   */
-  static asyncMap<T, R>(array: T[], asyncFn: (element: T) => Promise<R> | R): Promise<R[]>
-
-  /** Check if all elements in an array are of a specified type or all the same type */
-  static isArrayUniform(arr: Array<unknown>, type?: string): boolean
-
-  /** Remove duplicate elements from an array, returning a new array with unique values */
-  static isArrayUnique<T>(arr: Array<T>): Array<T>
-
-  /** Get the intersection of two arrays */
-  static intersection<T>(arr1: Array<T>, arr2: Array<T>): Array<T>
-
-  /** Check if two arrays have any elements in common */
-  static intersects<T>(arr1: Array<T>, arr2: Array<T>): boolean
-
-  /** Pad an array to a specified length */
-  static arrayPad<T>(arr: Array<T>, length: number, value: T, position?: number): Array<T>
-
-  /** Filter an array asynchronously */
-  static asyncFilter<T>(arr: Array<T>, predicate: (item: T) => Promise<boolean>): Promise<Array<T>>
-
-  /** Clone an object */
-  static cloneObject<T extends Record<string, any>>(obj: T, freeze?: boolean): T
-
-  /** Check if an object is empty */
-  static isObjectEmpty(obj: Record<string, any>): boolean
-
-  /** Ensure a nested path of objects exists */
-  static assureObjectPath(obj: Record<string, any>, keys: Array<string>): Record<string, any>
-
-  /** Set a value in a nested object structure */
-  static setNestedValue(obj: Record<string, any>, keys: Array<string>, value: unknown): void
-
-  /** Deeply merge objects */
-  static mergeObject<T extends Record<string, any>>(...sources: Array<T>): T
-
-  /** Recursively freeze an object */
-  static deepFreezeObject<T>(obj: T): T
-
-  /** Map an object using a transformer function */
-  static mapObject<T extends Record<string, any>, R>(
-    original: T,
-    transformer: (key: string, value: any) => R | Promise<R>,
-    mutate?: boolean
-  ): Promise<Record<string, R>>
-
-  /** Allocate an object from a source array and spec */
-  static allocateObject(
-    source: Array<unknown>,
-    spec:
-      | Array<unknown>
-      | ((source: Array<unknown>) => Promise<Array<unknown>> | Array<unknown>)
-  ): Promise<Record<string, unknown>>
-
-  /**
-   * Flattens one level of an array of plain objects, transposing values so each
-   * key maps to the collected values from every object.
-   *
-   * Accepts either a simple array of objects or an array that mixes objects and
-   * nested object arrays (one level deep). Nested arrays are flattened before
-   * transposition.
-   *
-   * @param input - Array of plain objects (optionally containing nested arrays)
-   * @returns Object with keys mapped to arrays of values from all input objects
-   *
-   * @throws {Sass} If input is not an Array or if any element is not a plain object after flattening
-   *
-   * @example
-   * ```typescript
-   * import { Collection } from '@gesslar/toolkit'
-   *
-   * const objects = [
-   *   [{ name: 'Alice', age: 25 }],
-   *   { name: 'Bob', age: 30 }
-   * ]
-   *
-   * const result = Collection.flattenObjectArray(objects)
-   * // result: { name: ['Alice', 'Bob'], age: [25, 30] }
-   * ```
-   */
-  static flattenObjectArray(
-    input: Array<Record<string, unknown> | Array<Record<string, unknown>>>
-  ): Record<string, Array<unknown>>
-
-  /**
-   * Transposes an array of plain objects into an object of arrays, keyed by the
-   * original object keys.
-   *
-   * @param objects - Array of plain objects to transpose
-   * @returns Object with keys mapped to arrays of values from the input objects
-   *
-   * @throws {Sass} If objects is not an Array or if any element is not a plain object
-   */
-  static transposeObjects(objects: Array<Record<string, unknown>>): Record<string, Array<unknown>>
-
-  /**
-   * Trims falsy values from both ends of an array.
-   *
-   * @param arr - The array to trim
-   * @param except - Array of values to exclude from trimming (default: [])
-   * @returns The trimmed array (modified in place)
-   *
-   * @throws {Sass} If arr or except is not an Array
-   *
-   * @example
-   * ```typescript
-   * import { Collection } from '@gesslar/toolkit'
-   *
-   * const arr = [null, 0, 1, 2, "", undefined]
-   * Collection.trimArray(arr)
-   * console.log(arr) // [1, 2]
-   * ```
-   */
-  static trimArray<T>(arr: Array<T>, except?: Array<T>): Array<T>
-
-  /**
-   * Trims falsy values from the right end of an array.
-   *
-   * @param arr - The array to trim
-   * @param except - Array of values to exclude from trimming (default: [])
-   * @returns The trimmed array (modified in place)
-   *
-   * @throws {Sass} If arr or except is not an Array
-   *
-   * @example
-   * ```typescript
-   * import { Collection } from '@gesslar/toolkit'
-   *
-   * const arr = [1, "", undefined]
-   * Collection.trimArrayRight(arr)
-   * console.log(arr) // [1]
-   * ```
-   */
-  static trimArrayRight<T>(arr: Array<T>, except?: Array<T>): Array<T>
-
-  /**
-   * Trims falsy values from the left end of an array.
-   *
-   * @param arr - The array to trim
-   * @param except - Array of values to exclude from trimming (default: [])
-   * @returns The trimmed array (modified in place)
-   *
-   * @throws {Sass} If arr or except is not an Array
-   *
-   * @example
-   * ```typescript
-   * import { Collection } from '@gesslar/toolkit'
-   *
-   * const arr = [null, undefined, "value"]
-   * Collection.trimArrayLeft(arr)
-   * console.log(arr) // ["value"]
-   * ```
-   */
-  static trimArrayLeft<T>(arr: Array<T>, except?: Array<T>): Array<T>
-}