@gesslar/toolkit 5.4.0 → 5.5.0

package/package.json

@@ -5,7 +5,7 @@
     "name": "gesslar",
     "url": "https://gesslar.dev"
   },
-  "version": "5.4.0",
+  "version": "5.5.0",
   "license": "0BSD",
   "homepage": "https://github.com/gesslar/toolkit#readme",
   "repository": {
@@ -77,7 +77,6 @@
   },
   "dependencies": {
     "@gesslar/colours": "^1.0.0",
-    "ajv": "^8.20.0",
     "json5": "^2.2.3",
     "supports-color": "^10.2.2",
     "yaml": "^2.9.0"
@@ -85,9 +84,9 @@
   "devDependencies": {
     "@gesslar/uglier": "^2.4.1",
     "@rollup/plugin-node-resolve": "^16.0.3",
-    "eslint": "^10.3.0",
-    "happy-dom": "^20.9.0",
-    "rollup": "^4.60.3",
+    "eslint": "^10.4.1",
+    "happy-dom": "^20.10.2",
+    "rollup": "^4.61.1",
     "typescript": "^6.0.3"
   }
 }

package/src/browser/lib/Collection.js

@@ -7,10 +7,10 @@
  */
 
 import Data from "./Data.js"
-import Valid from "./Valid.js"
 import Sass from "./Sass.js"
-import Util from "./Util.js"
 import TypeSpec from "./TypeSpec.js"
+import Util from "./Util.js"
+import Valid from "./Valid.js"
 
 /**
  * Utility class for collection operations.

package/src/node/lib/Glog.js

@@ -12,6 +12,7 @@
  */
 
 import {createRequire} from "node:module"
+import {stripVTControlCharacters} from "node:util"
 
 import c from "@gesslar/colours"
 
@@ -19,6 +20,26 @@ import Data from "../../browser/lib/Data.js"
 import Term from "./Term.js"
 import Util from "../../browser/lib/Util.js"
 
+/**
+ * Apply `@gesslar/colours` formatting, then defer to Term for colour support.
+ *
+ * The colour template must always be evaluated so that `@gesslar/colours`
+ * format tokens (e.g. `{F019}`) are resolved out of the text. When Term reports
+ * that the terminal lacks colour support, the resulting ANSI escape sequences
+ * are stripped so only plain text remains.
+ *
+ * @param {Array<string>} strings - Template strings.
+ * @param {...unknown} values - Template values.
+ * @returns {string} Formatted text, with ANSI stripped when colour is unsupported.
+ */
+function paint(strings, ...values) {
+  const formatted = c(strings, ...values)
+
+  return Term.hasColor
+    ? formatted
+    : stripVTControlCharacters(formatted)
+}
+
 // Auto-detect VS Code extension environment
 let vscodeApi = null
 try {
@@ -40,7 +61,7 @@ try {
  * @property {string} success - Colour code for success messages
  * @property {string} reset - Colour reset code
  */
-export const loggerColours = {
+const loggerColours = {
   debug: [
     "{F019}", // Debug level 0: Dark blue
     "{F027}", // Debug level 1: Medium blue
@@ -65,7 +86,7 @@ export const loggerColours = {
  * @property {string} error - Symbol for error messages
  * @property {string} success - Symbol for success messages
  */
-export const logSymbols = {
+const logSymbols = {
   debug: "?",
   info: "i",
   warn: "!",
@@ -547,13 +568,13 @@ class Glog {
       const colourCode = colours[level][debugLevel] || colours[level][0]
 
       return useStrings
-        ? c`${namePrefix}${colourCode}${tag}{/}: ${message}`
-        : c`${namePrefix}${colourCode}${tag}{/} ${message}`
+        ? paint`${namePrefix}${colourCode}${tag}{/}: ${message}`
+        : paint`${namePrefix}${colourCode}${tag}{/} ${message}`
     }
 
     return useStrings
-      ? c`${namePrefix}${colours[level]}${tag}{/}: ${message}`
-      : c`${namePrefix}${colours[level]}${tag}{/} ${message}`
+      ? paint`${namePrefix}${colours[level]}${tag}{/}: ${message}`
+      : paint`${namePrefix}${colours[level]}${tag}{/} ${message}`
   }
 
   /**
@@ -707,7 +728,7 @@ class Glog {
    * @example logger.colourize`{success}Operation completed{/} in {bold}${time}ms{/}`
    */
   colourize(strings, ...values) {
-    const message = c(strings, ...values)
+    const message = paint(strings, ...values)
     const name = this.#name || Glog.name || "Log"
 
     Term.log(`[${name}] ${message}`)
@@ -720,7 +741,7 @@ class Glog {
    * @param {...unknown} values - Template values
    */
   static colourize(strings, ...values) {
-    const message = c(strings, ...values)
+    const message = paint(strings, ...values)
     const name = this.name || "Log"
 
     Term.log(`[${name}] ${message}`)
@@ -750,8 +771,8 @@ class Glog {
     const tag = useStrings ? "Success" : symbols.success
     const colourCode = colours.success || "{F046}"
     const formatted = useStrings
-      ? c`[${name}] ${colourCode}${tag}{/}: ${message}`
-      : c`[${name}] ${colourCode}${tag}{/} ${message}`
+      ? paint`[${name}] ${colourCode}${tag}{/}: ${message}`
+      : paint`[${name}] ${colourCode}${tag}{/} ${message}`
 
     Term.log(formatted, ...args)
   }
@@ -789,8 +810,8 @@ class Glog {
     const tag = useStrings ? "Debug" : symbols.debug
     const colourCode = colours.debug[level] || colours.debug[0]
     const label = useStrings
-      ? c`[${name}] ${colourCode}${tag}{/}: ${message}`
-      : c`[${name}] ${colourCode}${tag}{/} ${message}`
+      ? paint`[${name}] ${colourCode}${tag}{/}: ${message}`
+      : paint`[${name}] ${colourCode}${tag}{/} ${message}`
 
     Term.group(label)
   }
@@ -807,8 +828,8 @@ class Glog {
     const symbols = this.symbols || logSymbols
     const tag = useStrings ? "Info" : symbols.info
     const label = useStrings
-      ? c`[${name}] ${colours.info}${tag}{/}: ${message}`
-      : c`[${name}] ${colours.info}${tag}{/} ${message}`
+      ? paint`[${name}] ${colours.info}${tag}{/}: ${message}`
+      : paint`[${name}] ${colours.info}${tag}{/} ${message}`
 
     Term.group(label)
   }
@@ -824,8 +845,8 @@ class Glog {
     const symbols = this.symbols || logSymbols
     const tag = useStrings ? "Success" : symbols.success
     const label = useStrings
-      ? c`[${name}] {success}${tag}{/}: ${message}`
-      : c`[${name}] {success}${tag}{/} ${message}`
+      ? paint`[${name}] {success}${tag}{/}: ${message}`
+      : paint`[${name}] {success}${tag}{/} ${message}`
 
     Term.group(label)
   }
@@ -883,8 +904,8 @@ class Glog {
     const tag = useStrings ? "Success" : symbols.success
     const namePrefix = showName ? `[${name}] ` : ""
     const label = useStrings
-      ? c`${namePrefix}{success}${tag}{/}: ${message}`
-      : c`${namePrefix}{success}${tag}{/} ${message}`
+      ? paint`${namePrefix}{success}${tag}{/}: ${message}`
+      : paint`${namePrefix}{success}${tag}{/} ${message}`
 
     Term.group(label)
   }
@@ -912,7 +933,7 @@ class Glog {
     }
 
     if(label) {
-      Term.log(c`[${this.#name || Glog.name || "Log"}] {info}Table{/}: ${label}`)
+      Term.log(paint`[${this.#name || Glog.name || "Log"}] {info}Table{/}: ${label}`)
     }
 
     Term.table(data, tableOptions)
@@ -941,7 +962,7 @@ class Glog {
     }
 
     if(label) {
-      Term.log(c`[${this.name || "Log"}] {info}Table{/}: ${label}`)
+      Term.log(paint`[${this.name || "Log"}] {info}Table{/}: ${label}`)
     }
 
     Term.table(data, tableOptions)

package/src/node/lib/Watcher.js

@@ -1,4 +1,4 @@
-import {watch} from "node:fs/promises"
+import {realpath, watch} from "node:fs/promises"
 import Valid from "./Valid.js"
 import Data from "./Data.js"
 import Time from "../../browser/lib/Time.js"
@@ -52,7 +52,8 @@ export default class Watcher {
     this.#abortController = new AbortController()
 
     for(const target of targets) {
-      const watcher = watch(target.url, {
+      const watchPath = await realpath(target.path).catch(() => target.path)
+      const watcher = watch(watchPath, {
         recursive: target.isDirectory ? recursive : false,
         persistent,
         signal: this.#abortController.signal,

package/types/node/lib/Glog.d.ts

@@ -1,26 +1,3 @@
-/**
- * Default colour configuration for logger output using @gesslar/colours format
- *
- * @type {object}
- * @property {string[]} debug - Array of 5 colour codes for debug levels 0-4
- * @property {string} info - Colour code for info messages
- * @property {string} warn - Colour code for warning messages
- * @property {string} error - Colour code for error messages
- * @property {string} success - Colour code for success messages
- * @property {string} reset - Colour reset code
- */
-export const loggerColours: object;
-/**
- * Symbol characters used for log level tags when colours are disabled or tagsAsStrings is false
- *
- * @type {object}
- * @property {string} debug - Symbol for debug messages
- * @property {string} info - Symbol for info messages
- * @property {string} warn - Symbol for warning messages
- * @property {string} error - Symbol for error messages
- * @property {string} success - Symbol for success messages
- */
-export const logSymbols: object;
 declare const _default: typeof Glog;
 export default _default;
 declare class Glog {

package/types/node/lib/Glog.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"Glog.d.ts","sourceRoot":"","sources":["../../../src/node/lib/Glog.js"],"names":[],"mappings":"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"}
+{"version":3,"file":"Glog.d.ts","sourceRoot":"","sources":["../../../src/node/lib/Glog.js"],"names":[],"mappings":"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"}

package/types/node/lib/Watcher.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"Watcher.d.ts","sourceRoot":"","sources":["../../../src/node/lib/Watcher.js"],"names":[],"mappings":"AAKA;;;GAGG;AAEH;;;GAGE;AAEF;IAIE;;;;;;;;;;;;OAYG;IACH,eATW,UAAU,GAAC,eAAe,GAAC,KAAK,CAAE,CAAC,UAAU,GAAC,eAAe,CAAC,CAAC,8DAEvE;QAA8D,QAAQ,EAA9D,CAAC,MAAM,EAAE,UAAU,GAAC,eAAe,KAAK,IAAI;QAC3B,UAAU,GAA3B,MAAM;QACY,UAAU,GAA5B,OAAO;QACW,SAAS,GAA3B,OAAO;QACU,QAAQ,GAAzB,MAAM;KACd,GAAU,OAAO,CAAC,SAAS,CAAC,CA6E9B;IAED;;OAEG;IACH,qBAIC;;CACF;4BA/G0B,iBAAiB;iCACZ,sBAAsB"}
+{"version":3,"file":"Watcher.d.ts","sourceRoot":"","sources":["../../../src/node/lib/Watcher.js"],"names":[],"mappings":"AAKA;;;GAGG;AAEH;;;GAGE;AAEF;IAIE;;;;;;;;;;;;OAYG;IACH,eATW,UAAU,GAAC,eAAe,GAAC,KAAK,CAAE,CAAC,UAAU,GAAC,eAAe,CAAC,CAAC,8DAEvE;QAA8D,QAAQ,EAA9D,CAAC,MAAM,EAAE,UAAU,GAAC,eAAe,KAAK,IAAI;QAC3B,UAAU,GAA3B,MAAM;QACY,UAAU,GAA5B,OAAO;QACW,SAAS,GAA3B,OAAO;QACU,QAAQ,GAAzB,MAAM;KACd,GAAU,OAAO,CAAC,SAAS,CAAC,CA8E9B;IAED;;OAEG;IACH,qBAIC;;CACF;4BAhH0B,iBAAiB;iCACZ,sBAAsB"}

package/vendor/toolkit.esm.js

@@ -1,4 +1,4 @@
-// @gesslar/toolkit v5.4.0 - ES module bundle
+// @gesslar/toolkit v5.5.0 - ES module bundle
 /**
  * @file Tantrum.js
  *

package/vendor/toolkit.umd.js

@@ -1,4 +1,4 @@
-// @gesslar/toolkit v5.4.0 - UMD bundle
+// @gesslar/toolkit v5.5.0 - UMD bundle
 (function (global, factory) {
   typeof exports === 'object' && typeof module !== 'undefined' ? factory(exports) :
   typeof define === 'function' && define.amd ? define(['exports'], factory) :

package/src/browser/lib/OObject.js

@@ -1,196 +0,0 @@
-import Data from "./Data.js"
-import Valid from "./Valid.js"
-
-/**
- * @typedef {object} OObjectArrayInfo
- * @property {Array<string>} path - The path array to the array element
- * @property {string} flatPath - The dot-separated path to the array element
- * @property {number} index - The index of the element in the array
- */
-
-/**
- * @typedef {object} OObjectEntry
- * @property {string} key - The property key
- * @property {any} value - The property value
- * @property {string} valueString - String representation of the value
- * @property {Array<string>} path - The path array to this property
- * @property {string} flatPath - The dot-separated path to this property
- * @property {OObjectArrayInfo} [array] - Array information if this entry is from an array
- */
-
-/**
- * @typedef {Record<string, any> | Array<any>} OObjectSource
- */
-
-export default class OObject {
-  /** @type {Array<OObjectEntry>} */
-  #data = []
-
-  /**
-   * Constructs an OObject with optional initial data.
-   *
-   * @param {Array<OObjectEntry>} oobject
-   */
-  constructor(oobject=[]) {
-    this.#data = oobject
-  }
-
-  /**
-   * Creates an OObject from a source object or array
-   *
-   * @param {OObjectSource} source - The source object or array to decompose
-   * @returns {OObject} A new OObject instance
-   */
-  static from(source) {
-    Valid.type(source, "Object|Array")
-
-    return new this(this.#decomposeObject(source))
-  }
-
-  /**
-   * Decomposes a nested object into flat entries with path information.
-   * Recursively processes objects and arrays to create a flat structure for
-   * evaluation.
-   *
-   * @param {Record<string, any>} work - The object to decompose
-   * @param {Array<string>} objectPath - Current path array for nested properties
-   * @returns {Array<OObjectEntry>} Array of decomposed object entries with path information
-   */
-  static #decomposeObject(work, objectPath=[]) {
-    Valid.type(work, "Object|Array")
-    Valid.type(objectPath, "Array")
-
-    const result = []
-
-    for(const key in work) {
-      const currPath = [...objectPath, key]
-      const item = work[key]
-
-      if(Data.isPlainObject(item)) {
-        result.push(...this.#decomposeObject(work[key], currPath))
-      } else if(Array.isArray(work[key])) {
-        work[key].forEach((item, index) => {
-          const path = [...currPath, String(index+1)]
-
-          if(Data.isPlainObject(item)) {
-            result.push(...this.#decomposeObject(item, path))
-          } else {
-            result.push({
-              key,
-              value: item,
-              valueString: String(item),
-              path,
-              flatPath: path.join("."),
-              array: {
-                path: path.slice(0, -1),
-                flatPath: path.slice(0, -1).join("."),
-                index
-              }
-            })
-          }
-        })
-      } else {
-        result.push({key, value: item, valueString: String(item), path: currPath, flatPath: currPath.join(".")})
-      }
-    }
-
-    return result
-  }
-
-  /**
-   * Gets the internal data array
-   *
-   * @returns {Array<object>} The decomposed object entries
-   */
-  get data() {
-    return this.#data
-  }
-
-  /**
-   * Finds the first entry matching a flat path or predicate
-   *
-   * @param {string|((entry: OObjectEntry, index: number, array: Array<OObjectEntry>) => boolean)} pathOrPredicate - Flat path string or predicate function
-   * @returns {OObjectEntry|undefined} The matching entry or undefined
-   */
-  find(pathOrPredicate) {
-    if(typeof pathOrPredicate === "string") {
-      return this.#data.find(entry => entry.flatPath === pathOrPredicate)
-    }
-
-    Valid.type(pathOrPredicate, "function")
-
-    return this.#data.find(pathOrPredicate)
-  }
-
-  /**
-   * Finds all entries matching a flat path or predicate
-   *
-   * @param {string|((entry: OObjectEntry, index: number, array: Array<OObjectEntry>) => boolean)} pathOrPredicate - Flat path string or predicate function
-   * @returns {Array<object>} Array of matching entries
-   */
-  findAll(pathOrPredicate) {
-    if(typeof pathOrPredicate === "string") {
-      return this.#data.filter(entry => entry.flatPath === pathOrPredicate)
-    }
-
-    Valid.type(pathOrPredicate, "function")
-
-    return this.#data.filter(pathOrPredicate)
-  }
-
-  /**
-   * Returns an iterator over all entries in order
-   *
-   * @returns {Iterator<object>} Iterator of decomposed entries
-   */
-  entries() {
-    return this.#data[Symbol.iterator]()
-  }
-
-  /**
-   * Executes a callback for each entry in order
-   *
-   * @param {(entry: OObjectEntry, index: number, array: Array<OObjectEntry>) => void} callback - Function to call for each entry
-   * @returns {void}
-   */
-  forEach(callback) {
-    Valid.type(callback, "function")
-
-    this.#data.forEach(callback)
-  }
-
-  /**
-   * Ensures a path exists in the data, optionally setting a value
-   *
-   * @param {string} flatPath - The dot-separated path to ensure
-   * @param {*} value - Optional value to set (defaults to undefined)
-   * @returns {object} The entry at the path
-   */
-  assurePath(flatPath, value=undefined) {
-    Valid.type(flatPath, "string")
-
-    let entry = this.find(flatPath)
-
-    if(!entry) {
-      const path = flatPath.split(".")
-      const key = path[path.length - 1]
-
-      /** @type {OObjectEntry} */
-      const newEntry = {
-        key,
-        value,
-        valueString: String(value),
-        path,
-        flatPath
-      }
-
-      this.#data.push(newEntry)
-      entry = newEntry
-    } else if(value !== undefined) {
-      entry.value = value
-      entry.valueString = String(value)
-    }
-
-    return entry
-  }
-}

package/src/node/lib/Logger.js

@@ -1,185 +0,0 @@
-/*
-  For formatting console info, see:
-  https://nodejs.org/docs/latest-v22.x/api/util.html#utilformatformat-args
-
-  * %s: String will be used to convert all values except BigInt, Object and -0.
-        BigInt values will be represented with an n and Objects that have no
-        user defined toString function are inspected using util.inspect() with
-        options { depth: 0, colors: false, compact: 3 }.
-  * %d: Number will be used to convert all values except BigInt and Symbol.
-  * %i: parseInt(value, 10) is used for all values except BigInt and Symbol.
-  * %f: parseFloat(value) is used for all values except Symbol.
-  * %j: JSON. Replaced with the string '[Circular]' if the argument contains
-        circular references.
-  * %o: Object. A string representation of an object with generic JavaScript
-        object formatting. Similar to util.inspect() with options { showHidden:
-        true, showProxy: true }. This will show the full object including non-
-        enumerable properties and proxies.
-  * %O: Object. A string representation of an object with generic JavaScript
-        object formatting. Similar to util.inspect() without options. This will
-        show the full object not including non-enumerable properties and
-        proxies.
-  * %%: single percent sign ('%'). This does not consume an argument.
-
-*/
-
-import ErrorStackParser from "error-stack-parser"
-import console from "node:console"
-import {Environment} from "./Core.js"
-import {FileObject, Util} from "../../../types/node/index.js"
-
-export const loggerColours = {
-  debug: [
-    "\x1b[38;5;19m", // Debug level 0: Dark blue
-    "\x1b[38;5;27m", // Debug level 1: Medium blue
-    "\x1b[38;5;33m", // Debug level 2: Light blue
-    "\x1b[38;5;39m", // Debug level 3: Teal
-    "\x1b[38;5;44m", // Debug level 4: Blue-tinted cyan
-  ],
-  info: "\x1b[38;5;36m",    // Medium Spring Green
-  warn: "\x1b[38;5;214m",   // Orange1
-  error: "\x1b[38;5;196m",  // Red1
-  reset: "\x1b[0m", // Reset
-}
-
-/**
- * Logger class
- *
- * Log levels:
- * - debug: Debugging information
- *   - Debug levels
- *     - 0: No/critical debug information, not error level, but, should be
- *          logged
- *     - 1: Basic debug information, startup, shutdown, etc
- *     - 2: Intermediate debug information, discovery, starting to get more
- *         detailed
- *     - 3: Detailed debug information, parsing, processing, etc
- *     - 4: Very detailed debug information, nerd mode!
- * - warn: Warning information
- * - info: Informational information
- * - error: Error information
- */
-
-export default class Logger {
-  #name = null
-  #debugLevel = 0
-
-  constructor(options) {
-    this.#name = "BeDoc"
-    if(options) {
-      this.setOptions(options)
-      if(options.env === Environment.EXTENSION) {
-        const vscode = import("vscode")
-
-        this.vscodeError = vscode.window.showErrorMessage
-        this.vscodeWarn = vscode.window.showWarningMessage
-        this.vscodeInfo = vscode.window.showInformationMessage
-      }
-    }
-  }
-
-  get name() {
-    return this.#name
-  }
-
-  get debugLevel() {
-    return this.#debugLevel
-  }
-
-  get options() {
-    return {
-      name: this.#name,
-      debugLevel: this.#debugLevel,
-    }
-  }
-
-  setOptions(options) {
-    this.#name = options.name ?? this.#name
-    this.#debugLevel = options.debugLevel
-  }
-
-  #compose(level, message, debugLevel = 0) {
-    const tag = Util.capitalize(level)
-
-    if(level === "debug")
-      return `[${this.#name}] ${loggerColours[level][debugLevel]}${tag}${loggerColours.reset}: ${message}`
-
-    return `[${this.#name}] ${loggerColours[level]}${tag}${loggerColours.reset}: ${message}`
-  }
-
-  lastStackLine(error = new Error(), stepsRemoved = 3) {
-    const stack = ErrorStackParser.parse(error)
-
-    return stack[stepsRemoved]
-  }
-
-  extractFileFunction(level = 0) {
-    const frame = this.lastStackLine()
-    const {
-      functionName: func,
-      fileName: file,
-      lineNumber: line,
-      columnNumber: col,
-    } = frame
-
-    const tempFile = new FileObject(file)
-    const {module, uri} = tempFile
-
-    let functionName = func ?? "anonymous"
-
-    if(functionName.startsWith("#"))
-      functionName = `${module}.${functionName}`
-
-    const methodName = /\[as \w+\]$/.test(functionName)
-      ? /\[as (\w+)\]/.exec(functionName)[1]
-      : null
-
-    if(methodName) {
-      functionName = functionName.replace(/\[as \w+\]$/, "")
-      functionName = `${functionName}{${methodName}}`
-    }
-
-    if(/^async /.test(functionName))
-      functionName = functionName.replace(/^async /, "(async)")
-
-    let result = functionName
-
-    if(level >= 2)
-      result = `${result}:${line}:${col}`
-
-    if(level >= 3)
-      result = `${uri} ${result}`
-
-    return result
-  }
-
-  newDebug(tag) {
-    return function(message, level, ...arg) {
-      tag = this.extractFileFunction(this.#debugLevel)
-      this.debug(`[${tag}] ${message}`, level, ...arg)
-    }.bind(this)
-  }
-
-  debug(message, level = 0, ...arg) {
-    if(level <= (this.debugLevel ?? 4))
-      console.debug(this.#compose("debug", message, level), ...arg)
-  }
-
-  warn(message, ...arg) {
-    console.warn(this.#compose("warn", message), ...arg)
-    this.vscodeWarn?.(JSON.stringify(message))
-  }
-
-  info(message, ...arg) {
-    console.info(this.#compose("info", message), ...arg)
-    this.vscodeInfo?.(JSON.stringify(message))
-  }
-
-  error(message, ...arg) {
-    console.error(this.#compose("error", message), ...arg)
-    this.vscodeError?.(JSON.stringify(message))
-  }
-}
-
-// NOTE: This is an artifact file kept for reference during Glog development.
-// Not exported from toolkit. Has broken imports to ./Core.js (actions package).

package/types/browser/lib/OObject.d.ts

@@ -1,127 +0,0 @@
-/**
- * @typedef {object} OObjectArrayInfo
- * @property {Array<string>} path - The path array to the array element
- * @property {string} flatPath - The dot-separated path to the array element
- * @property {number} index - The index of the element in the array
- */
-/**
- * @typedef {object} OObjectEntry
- * @property {string} key - The property key
- * @property {any} value - The property value
- * @property {string} valueString - String representation of the value
- * @property {Array<string>} path - The path array to this property
- * @property {string} flatPath - The dot-separated path to this property
- * @property {OObjectArrayInfo} [array] - Array information if this entry is from an array
- */
-/**
- * @typedef {Record<string, any> | Array<any>} OObjectSource
- */
-export default class OObject {
-    /**
-     * Creates an OObject from a source object or array
-     *
-     * @param {OObjectSource} source - The source object or array to decompose
-     * @returns {OObject} A new OObject instance
-     */
-    static from(source: OObjectSource): OObject;
-    /**
-     * Decomposes a nested object into flat entries with path information.
-     * Recursively processes objects and arrays to create a flat structure for
-     * evaluation.
-     *
-     * @param {Record<string, any>} work - The object to decompose
-     * @param {Array<string>} objectPath - Current path array for nested properties
-     * @returns {Array<OObjectEntry>} Array of decomposed object entries with path information
-     */
-    static #decomposeObject(work: Record<string, any>, objectPath?: Array<string>): Array<OObjectEntry>;
-    /**
-     * Constructs an OObject with optional initial data.
-     *
-     * @param {Array<OObjectEntry>} oobject
-     */
-    constructor(oobject?: Array<OObjectEntry>);
-    /**
-     * Gets the internal data array
-     *
-     * @returns {Array<object>} The decomposed object entries
-     */
-    get data(): Array<object>;
-    /**
-     * Finds the first entry matching a flat path or predicate
-     *
-     * @param {string|((entry: OObjectEntry, index: number, array: Array<OObjectEntry>) => boolean)} pathOrPredicate - Flat path string or predicate function
-     * @returns {OObjectEntry|undefined} The matching entry or undefined
-     */
-    find(pathOrPredicate: string | ((entry: OObjectEntry, index: number, array: Array<OObjectEntry>) => boolean)): OObjectEntry | undefined;
-    /**
-     * Finds all entries matching a flat path or predicate
-     *
-     * @param {string|((entry: OObjectEntry, index: number, array: Array<OObjectEntry>) => boolean)} pathOrPredicate - Flat path string or predicate function
-     * @returns {Array<object>} Array of matching entries
-     */
-    findAll(pathOrPredicate: string | ((entry: OObjectEntry, index: number, array: Array<OObjectEntry>) => boolean)): Array<object>;
-    /**
-     * Returns an iterator over all entries in order
-     *
-     * @returns {Iterator<object>} Iterator of decomposed entries
-     */
-    entries(): Iterator<object>;
-    /**
-     * Executes a callback for each entry in order
-     *
-     * @param {(entry: OObjectEntry, index: number, array: Array<OObjectEntry>) => void} callback - Function to call for each entry
-     * @returns {void}
-     */
-    forEach(callback: (entry: OObjectEntry, index: number, array: Array<OObjectEntry>) => void): void;
-    /**
-     * Ensures a path exists in the data, optionally setting a value
-     *
-     * @param {string} flatPath - The dot-separated path to ensure
-     * @param {*} value - Optional value to set (defaults to undefined)
-     * @returns {object} The entry at the path
-     */
-    assurePath(flatPath: string, value?: any): object;
-    #private;
-}
-export type OObjectArrayInfo = {
-    /**
-     * - The path array to the array element
-     */
-    path: Array<string>;
-    /**
-     * - The dot-separated path to the array element
-     */
-    flatPath: string;
-    /**
-     * - The index of the element in the array
-     */
-    index: number;
-};
-export type OObjectEntry = {
-    /**
-     * - The property key
-     */
-    key: string;
-    /**
-     * - The property value
-     */
-    value: any;
-    /**
-     * - String representation of the value
-     */
-    valueString: string;
-    /**
-     * - The path array to this property
-     */
-    path: Array<string>;
-    /**
-     * - The dot-separated path to this property
-     */
-    flatPath: string;
-    /**
-     * - Array information if this entry is from an array
-     */
-    array?: OObjectArrayInfo;
-};
-export type OObjectSource = Record<string, any> | Array<any>;
-//# sourceMappingURL=OObject.d.ts.map

package/types/browser/lib/OObject.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"OObject.d.ts","sourceRoot":"","sources":["../../../src/browser/lib/OObject.js"],"names":[],"mappings":"AAGA;;;;;GAKG;AAEH;;;;;;;;GAQG;AAEH;;GAEG;AAEH;IAaE;;;;;OAKG;IACH,oBAHW,aAAa,GACX,OAAO,CAMnB;IAED;;;;;;;;OAQG;IACH,8BAJW,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,eACnB,KAAK,CAAC,MAAM,CAAC,GACX,KAAK,CAAC,YAAY,CAAC,CAyC/B;IArED;;;;OAIG;IACH,sBAFW,KAAK,CAAC,YAAY,CAAC,EAI7B;IAgED;;;;OAIG;IACH,YAFa,KAAK,CAAC,MAAM,CAAC,CAIzB;IAED;;;;;OAKG;IACH,sBAHW,MAAM,GAAC,CAAC,CAAC,KAAK,EAAE,YAAY,EAAE,KAAK,EAAE,MAAM,EAAE,KAAK,EAAE,KAAK,CAAC,YAAY,CAAC,KAAK,OAAO,CAAC,GAClF,YAAY,GAAC,SAAS,CAUlC;IAED;;;;;OAKG;IACH,yBAHW,MAAM,GAAC,CAAC,CAAC,KAAK,EAAE,YAAY,EAAE,KAAK,EAAE,MAAM,EAAE,KAAK,EAAE,KAAK,CAAC,YAAY,CAAC,KAAK,OAAO,CAAC,GAClF,KAAK,CAAC,MAAM,CAAC,CAUzB;IAED;;;;OAIG;IACH,WAFa,QAAQ,CAAC,MAAM,CAAC,CAI5B;IAED;;;;;OAKG;IACH,kBAHW,CAAC,KAAK,EAAE,YAAY,EAAE,KAAK,EAAE,MAAM,EAAE,KAAK,EAAE,KAAK,CAAC,YAAY,CAAC,KAAK,IAAI,GACtE,IAAI,CAMhB;IAED;;;;;;OAMG;IACH,qBAJW,MAAM,UACN,GAAC,GACC,MAAM,CA4BlB;;CACF;;;;;UA9La,KAAK,CAAC,MAAM,CAAC;;;;cACb,MAAM;;;;WACN,MAAM;;;;;;SAKN,MAAM;;;;WACN,GAAG;;;;iBACH,MAAM;;;;UACN,KAAK,CAAC,MAAM,CAAC;;;;cACb,MAAM;;;;YACN,gBAAgB;;4BAIjB,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,GAAG,KAAK,CAAC,GAAG,CAAC"}

package/types/node/lib/Logger.d.ts

@@ -1,46 +0,0 @@
-export namespace loggerColours {
-    let debug: string[];
-    let info: string;
-    let warn: string;
-    let error: string;
-    let reset: string;
-}
-/**
- * Logger class
- *
- * Log levels:
- * - debug: Debugging information
- *   - Debug levels
- *     - 0: No/critical debug information, not error level, but, should be
- *          logged
- *     - 1: Basic debug information, startup, shutdown, etc
- *     - 2: Intermediate debug information, discovery, starting to get more
- *         detailed
- *     - 3: Detailed debug information, parsing, processing, etc
- *     - 4: Very detailed debug information, nerd mode!
- * - warn: Warning information
- * - info: Informational information
- * - error: Error information
- */
-export default class Logger {
-    constructor(options: any);
-    vscodeError: any;
-    vscodeWarn: any;
-    vscodeInfo: any;
-    get name(): any;
-    get debugLevel(): number;
-    get options(): {
-        name: any;
-        debugLevel: number;
-    };
-    setOptions(options: any): void;
-    lastStackLine(error?: Error, stepsRemoved?: number): any;
-    extractFileFunction(level?: number): any;
-    newDebug(tag: any): any;
-    debug(message: any, level?: number, ...arg: any[]): void;
-    warn(message: any, ...arg: any[]): void;
-    info(message: any, ...arg: any[]): void;
-    error(message: any, ...arg: any[]): void;
-    #private;
-}
-//# sourceMappingURL=Logger.d.ts.map

package/types/node/lib/Logger.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"Logger.d.ts","sourceRoot":"","sources":["../../../src/node/lib/Logger.js"],"names":[],"mappings":";;;;;;;AA4CA;;;;;;;;;;;;;;;;GAgBG;AAEH;IAIE,0BAYC;IALK,iBAAiD;IACjD,gBAAkD;IAClD,gBAAsD;IAK5D,gBAEC;IAED,yBAEC;IAED;;;MAKC;IAED,+BAGC;IAWD,yDAIC;IAED,yCAsCC;IAED,wBAKC;IAED,yDAGC;IAED,wCAGC;IAED,wCAGC;IAED,yCAGC;;CACF"}