@putkoff/abstract-utilities 1.0.71 → 1.0.95

package/dist/esm/index.js

@@ -1,36 +1,29 @@
-import require$$0$2 from 'util';
+import path$1 from 'path';
+import * as fs from 'node:fs';
+import { readFileSync } from 'node:fs';
+import * as fsp from 'node:fs/promises';
+import * as path from 'node:path';
+import { isAbsolute, resolve } from 'node:path';
+import require$$0$2, { inspect } from 'util';
+export { inspect } from 'util';
 import require$$0$1 from 'os';
 import require$$0$3 from 'stream';
 import require$$0$4 from 'buffer';
 import require$$0$5 from 'events';
+import require$$0$6 from 'fs';
 import require$$3 from 'zlib';
 import require$$1 from 'tty';
 import require$$1$1 from 'string_decoder';
 import require$$0$7 from 'http';
 import require$$1$3 from 'https';
 
-function _mergeNamespaces(n, m) {
-    m.forEach(function (e) {
-        e && typeof e !== 'string' && !Array.isArray(e) && Object.keys(e).forEach(function (k) {
-            if (k !== 'default' && !(k in n)) {
-                var d = Object.getOwnPropertyDescriptor(e, k);
-                Object.defineProperty(n, k, d.get ? d : {
-                    enumerable: true,
-                    get: function () { return e[k]; }
-                });
-            }
-        });
-    });
-    return Object.freeze(n);
-}
-
 /** True if token is structurally bad or its exp ≤ now. */
 function isTokenExpired(token) {
     try {
         const payload = decodeJwt(token);
         return Date.now() / 1000 >= payload.exp;
     }
-    catch (_a) {
+    catch {
         return true; // treat malformed token as expired
     }
 }
@@ -105,50 +98,6 @@ function get_window_parts() {
     return null;
 }
 
-/******************************************************************************
-Copyright (c) Microsoft Corporation.
-
-Permission to use, copy, modify, and/or distribute this software for any
-purpose with or without fee is hereby granted.
-
-THE SOFTWARE IS PROVIDED "AS IS" AND THE AUTHOR DISCLAIMS ALL WARRANTIES WITH
-REGARD TO THIS SOFTWARE INCLUDING ALL IMPLIED WARRANTIES OF MERCHANTABILITY
-AND FITNESS. IN NO EVENT SHALL THE AUTHOR BE LIABLE FOR ANY SPECIAL, DIRECT,
-INDIRECT, OR CONSEQUENTIAL DAMAGES OR ANY DAMAGES WHATSOEVER RESULTING FROM
-LOSS OF USE, DATA OR PROFITS, WHETHER IN AN ACTION OF CONTRACT, NEGLIGENCE OR
-OTHER TORTIOUS ACTION, ARISING OUT OF OR IN CONNECTION WITH THE USE OR
-PERFORMANCE OF THIS SOFTWARE.
-***************************************************************************** */
-/* global Reflect, Promise, SuppressedError, Symbol, Iterator */
-
-
-function __rest(s, e) {
-    var t = {};
-    for (var p in s) if (Object.prototype.hasOwnProperty.call(s, p) && e.indexOf(p) < 0)
-        t[p] = s[p];
-    if (s != null && typeof Object.getOwnPropertySymbols === "function")
-        for (var i = 0, p = Object.getOwnPropertySymbols(s); i < p.length; i++) {
-            if (e.indexOf(p[i]) < 0 && Object.prototype.propertyIsEnumerable.call(s, p[i]))
-                t[p[i]] = s[p[i]];
-        }
-    return t;
-}
-
-function __awaiter(thisArg, _arguments, P, generator) {
-    function adopt(value) { return value instanceof P ? value : new P(function (resolve) { resolve(value); }); }
-    return new (P || (P = Promise))(function (resolve, reject) {
-        function fulfilled(value) { try { step(generator.next(value)); } catch (e) { reject(e); } }
-        function rejected(value) { try { step(generator["throw"](value)); } catch (e) { reject(e); } }
-        function step(result) { result.done ? resolve(result.value) : adopt(result.value).then(fulfilled, rejected); }
-        step((generator = generator.apply(thisArg, _arguments || [])).next());
-    });
-}
-
-typeof SuppressedError === "function" ? SuppressedError : function (error, suppressed, message) {
-    var e = new Error(message);
-    return e.name = "SuppressedError", e.error = error, e.suppressed = suppressed, e;
-};
-
 /**
  * Unwraps nested { result } fields until you hit a non-object or no more "result" keys.
  */
@@ -172,13 +121,13 @@ function getMethod(method = null, body = null) {
 }
 // Gets headers, skips JSON headers when body is FormData
 function getHeaders(headers = {}, method = null, body = null) {
-    const result = Object.assign({}, headers);
+    const result = { ...headers };
     // let browser set boundary
     if (body instanceof FormData) {
         return result;
     }
-    const upper = method === null || method === void 0 ? void 0 : method.toUpperCase();
-    if (['POST', 'PUT', 'PATCH'].includes(upper !== null && upper !== void 0 ? upper : '') &&
+    const upper = method?.toUpperCase();
+    if (['POST', 'PUT', 'PATCH'].includes(upper ?? '') &&
         !result['Content-Type']) {
         result['Content-Type'] = 'application/json';
     }
@@ -214,18 +163,16 @@ function getFetchVars(headers = null, method = null, body = null) {
  * parseResult no longer needs to worry about JSON vs HTML redirect errors;
  * all 401/403 have already been handled above.
  */
-function parseResult(res) {
-    return __awaiter(this, void 0, void 0, function* () {
-        // runs checkResponse first, will throw if session is expired
-        res = checkResponse(res);
-        if (!res.ok) {
-            // for any other non-401 errors, you can still surface them
-            const errorText = yield res.text();
-            throw new Error(errorText || res.statusText);
-        }
-        // now safely parse JSON
-        return res.json();
-    });
+async function parseResult(res) {
+    // runs checkResponse first, will throw if session is expired
+    res = checkResponse(res);
+    if (!res.ok) {
+        // for any other non-401 errors, you can still surface them
+        const errorText = await res.text();
+        throw new Error(errorText || res.statusText);
+    }
+    // now safely parse JSON
+    return res.json();
 }
 /**
  * Intercept 401/403 and force a clean redirect to login
@@ -243,77 +190,155 @@ function checkResponse(res) {
     return res;
 }
 
-function fetchIt(endpoint_1) {
-    return __awaiter(this, arguments, void 0, function* (endpoint, body = null, method = null, headers = null, blob = false, configUrl = false, withCredentials = true, returnJson = true, returnReult = true) {
-        method = (method || "GET").toUpperCase();
-        // 2) choose the URL
-        const url = endpoint;
-        // 3) prepare headers & body
-        headers = Object.assign(Object.assign({}, (body instanceof FormData ? {} : { "Content-Type": "application/json" })), headers);
-        const opts = {
-            method,
-            credentials: withCredentials ? "include" : "same-origin",
-            headers,
-            body: body instanceof FormData
-                ? body
-                : body != null && method !== "GET"
-                    ? JSON.stringify(body)
-                    : undefined,
-        };
-        console.debug("➡️ secureFetchIt →", url, opts);
-        const res = yield fetch(url, opts);
-        if (!res.ok) {
-            const err = yield res.text();
-            throw new Error(`HTTP ${res.status}: ${err}`);
-        }
-        if (blob)
-            return res.blob();
-        if (returnReult)
-            return getResult(res.json());
-        if (returnJson)
-            return res.json();
-        return res;
-    });
+async function fetchIt(endpoint, body = null, method = null, headers = null, blob = false, configUrl = false, withCredentials = true, returnJson = true, returnReult = true) {
+    method = (method || "GET").toUpperCase();
+    // 2) choose the URL
+    const url = endpoint;
+    // 3) prepare headers & body
+    headers = {
+        ...(body instanceof FormData ? {} : { "Content-Type": "application/json" }),
+        ...headers,
+    };
+    const opts = {
+        method,
+        credentials: withCredentials ? "include" : "same-origin",
+        headers,
+        body: body instanceof FormData
+            ? body
+            : body != null && method !== "GET"
+                ? JSON.stringify(body)
+                : undefined,
+    };
+    console.debug("➡️ secureFetchIt →", url, opts);
+    const res = await fetch(url, opts);
+    if (!res.ok) {
+        const err = await res.text();
+        throw new Error(`HTTP ${res.status}: ${err}`);
+    }
+    if (blob)
+        return res.blob();
+    if (returnReult)
+        return getResult(res.json());
+    if (returnJson)
+        return res.json();
+    return res;
 }
 // Constructs HTML directory path
 function getHtmlDirectory(directory, filename) {
     return `${directory}/${filename}.html`;
 }
 // Fetches HTML content
-function fetchIndexHtml(filename_1) {
-    return __awaiter(this, arguments, void 0, function* (filename, directory = 'sf_index', base = 'html') {
-        const url = `/${base}/${directory}/${filename}.html`;
-        const response = yield fetch(url);
-        return yield response.text();
-    });
+async function fetchIndexHtml(filename, directory = 'sf_index', base = 'html') {
+    const url = `/${base}/${directory}/${filename}.html`;
+    const response = await fetch(url);
+    return await response.text();
 }
 // Fetches and injects HTML content into container
-function fetchIndexHtmlContainer(filename_1) {
-    return __awaiter(this, arguments, void 0, function* (filename, doc = document, directory = 'html') {
-        const container = `${filename}-container`;
-        const html = yield fetchIndexHtml(filename, directory);
-        const el = doc.getElementById(container);
-        if (el) {
-            el.innerHTML = html;
-        }
+async function fetchIndexHtmlContainer(filename, doc = document, directory = 'html') {
+    const container = `${filename}-container`;
+    const html = await fetchIndexHtml(filename, directory);
+    const el = doc.getElementById(container);
+    if (el) {
+        el.innerHTML = html;
+    }
+    else {
+        console.warn(`⚠️ No container found for: #${container}`);
+    }
+}
+
+function urlJoin(...parts) {
+    const s = (parts.length === 1 && Array.isArray(parts[0]) ? parts[0] : parts);
+    let r = "";
+    for (let i = 0; i < s.length; i++) {
+        let d = (s[i] ?? "").toString();
+        if (!d)
+            continue;
+        if (i === 0)
+            r = d;
         else {
-            console.warn(`⚠️ No container found for: #${container}`);
+            d = d.replace(/^\/+/, "");
+            r = r.replace(/\/+$/, "");
+            r = `${r}/${d}`;
         }
-    });
+    }
+    return r;
 }
-
-function getDefaultExportFromCjs (x) {
-	return x && x.__esModule && Object.prototype.hasOwnProperty.call(x, 'default') ? x['default'] : x;
+/**
+ * Returns a full URL.
+ * If partial_url is already absolute (starts with http), it is returned as is.
+ * Otherwise, it is combined with the base URL.
+ */
+function get_full_url(partial_url, domain = null) {
+    if (typeof partial_url !== 'string') {
+        throw new Error('partial_url must be a string');
+    }
+    // If it already starts with http, assume it is absolute.
+    if (partial_url.startsWith('http')) {
+        return partial_url;
+    }
+    return urlJoin(domain, partial_url);
+}
+/**
+ * Returns a full file system path.
+ * If partial_path is already absolute, it is returned as is.
+ * Otherwise, it is joined with the base directory.
+ */
+function get_full_path(partial_path, parent_dir = null) {
+    if (typeof partial_path !== 'string') {
+        throw new Error('partial_path must be a string');
+    }
+    if (path$1.isAbsolute(partial_path)) {
+        return partial_path;
+    }
+    return urlJoin(parent_dir, partial_path);
+}
+/**
+ * Converts a local file system path into its corresponding URL.
+ * It checks against the known directories in all_paths and replaces the matching base.
+ */
+function path_to_url(filePath, all_paths) {
+    if (typeof filePath !== 'string') {
+        throw new Error('filePath must be a string');
+    }
+    for (const key in all_paths) {
+        const mapping = all_paths[key];
+        const normalizedBase = path$1.normalize(mapping.path);
+        if (filePath.startsWith(normalizedBase)) {
+            const relativePath = filePath.substring(normalizedBase.length);
+            return urlJoin(mapping.url, relativePath.replace(/\\/g, '/'));
+        }
+    }
+    return null;
+}
+/**
+ * Converts a URL into its corresponding local file system path.
+ * It checks against the known URL prefixes in all_paths and replaces the matching base.
+ */
+function url_to_path(urlStr, all_paths) {
+    if (typeof urlStr !== 'string') {
+        throw new Error('urlStr must be a string');
+    }
+    for (const key in all_paths) {
+        const mapping = all_paths[key];
+        if (urlStr.startsWith(mapping.url)) {
+            const relativeUrl = urlStr.substring(mapping.url.length);
+            return urlJoin(mapping.path, relativeUrl);
+        }
+    }
+    return null;
+}
+function urljoin(...parts) {
+    return urlJoin(...parts);
 }
 
-function assertPath$1(path) {
+function assertPath(path) {
   if (typeof path !== 'string') {
     throw new TypeError('Path must be a string. Received ' + JSON.stringify(path));
   }
 }
 
 // Resolves . and .. elements in a path with directory names
-function normalizeStringPosix$1(path, allowAboveRoot) {
+function normalizeStringPosix(path, allowAboveRoot) {
   var res = '';
   var lastSegmentLength = 0;
   var lastSlash = -1;
@@ -376,7 +401,7 @@ function normalizeStringPosix$1(path, allowAboveRoot) {
   return res;
 }
 
-function _format$1(sep, pathObject) {
+function _format(sep, pathObject) {
   var dir = pathObject.dir || pathObject.root;
   var base = pathObject.base || (pathObject.name || '') + (pathObject.ext || '');
   if (!dir) {
@@ -388,7 +413,7 @@ function _format$1(sep, pathObject) {
   return dir + sep + base;
 }
 
-var posix$1 = {
+var posix = {
   // path.resolve([from ...], to)
   resolve: function resolve() {
     var resolvedPath = '';
@@ -405,7 +430,7 @@ var posix$1 = {
         path = cwd;
       }
 
-      assertPath$1(path);
+      assertPath(path);
 
       // Skip empty entries
       if (path.length === 0) {
@@ -420,7 +445,7 @@ var posix$1 = {
     // handle relative paths to be safe (might happen when process.cwd() fails)
 
     // Normalize the path
-    resolvedPath = normalizeStringPosix$1(resolvedPath, !resolvedAbsolute);
+    resolvedPath = normalizeStringPosix(resolvedPath, !resolvedAbsolute);
 
     if (resolvedAbsolute) {
       if (resolvedPath.length > 0)
@@ -435,7 +460,7 @@ var posix$1 = {
   },
 
   normalize: function normalize(path) {
-    assertPath$1(path);
+    assertPath(path);
 
     if (path.length === 0) return '.';
 
@@ -443,7 +468,7 @@ var posix$1 = {
     var trailingSeparator = path.charCodeAt(path.length - 1) === 47 /*/*/;
 
     // Normalize the path
-    path = normalizeStringPosix$1(path, !isAbsolute);
+    path = normalizeStringPosix(path, !isAbsolute);
 
     if (path.length === 0 && !isAbsolute) path = '.';
     if (path.length > 0 && trailingSeparator) path += '/';
@@ -453,7 +478,7 @@ var posix$1 = {
   },
 
   isAbsolute: function isAbsolute(path) {
-    assertPath$1(path);
+    assertPath(path);
     return path.length > 0 && path.charCodeAt(0) === 47 /*/*/;
   },
 
@@ -463,7 +488,7 @@ var posix$1 = {
     var joined;
     for (var i = 0; i < arguments.length; ++i) {
       var arg = arguments[i];
-      assertPath$1(arg);
+      assertPath(arg);
       if (arg.length > 0) {
         if (joined === undefined)
           joined = arg;
@@ -473,17 +498,17 @@ var posix$1 = {
     }
     if (joined === undefined)
       return '.';
-    return posix$1.normalize(joined);
+    return posix.normalize(joined);
   },
 
   relative: function relative(from, to) {
-    assertPath$1(from);
-    assertPath$1(to);
+    assertPath(from);
+    assertPath(to);
 
     if (from === to) return '';
 
-    from = posix$1.resolve(from);
-    to = posix$1.resolve(to);
+    from = posix.resolve(from);
+    to = posix.resolve(to);
 
     if (from === to) return '';
 
@@ -571,7 +596,7 @@ var posix$1 = {
   },
 
   dirname: function dirname(path) {
-    assertPath$1(path);
+    assertPath(path);
     if (path.length === 0) return '.';
     var code = path.charCodeAt(0);
     var hasRoot = code === 47 /*/*/;
@@ -597,7 +622,7 @@ var posix$1 = {
 
   basename: function basename(path, ext) {
     if (ext !== undefined && typeof ext !== 'string') throw new TypeError('"ext" argument must be a string');
-    assertPath$1(path);
+    assertPath(path);
 
     var start = 0;
     var end = -1;
@@ -667,7 +692,7 @@ var posix$1 = {
   },
 
   extname: function extname(path) {
-    assertPath$1(path);
+    assertPath(path);
     var startDot = -1;
     var startPart = 0;
     var end = -1;
@@ -719,11 +744,11 @@ var posix$1 = {
     if (pathObject === null || typeof pathObject !== 'object') {
       throw new TypeError('The "pathObject" argument must be of type Object. Received type ' + typeof pathObject);
     }
-    return _format$1('/', pathObject);
+    return _format('/', pathObject);
   },
 
   parse: function parse(path) {
-    assertPath$1(path);
+    assertPath(path);
 
     var ret = { root: '', dir: '', base: '', ext: '', name: '' };
     if (path.length === 0) return ret;
@@ -804,102 +829,9 @@ var posix$1 = {
   posix: null
 };
 
-posix$1.posix = posix$1;
-
-var pathBrowserify$1 = posix$1;
-
-var path$1 = /*@__PURE__*/getDefaultExportFromCjs(pathBrowserify$1);
-
-var path$2 = /*#__PURE__*/_mergeNamespaces({
-    __proto__: null,
-    default: path$1
-}, [pathBrowserify$1]);
+posix.posix = posix;
 
-function urlJoin(...parts) {
-    var _a;
-    const s = (parts.length === 1 && Array.isArray(parts[0]) ? parts[0] : parts);
-    let r = "";
-    for (let i = 0; i < s.length; i++) {
-        let d = ((_a = s[i]) !== null && _a !== void 0 ? _a : "").toString();
-        if (!d)
-            continue;
-        if (i === 0)
-            r = d;
-        else {
-            d = d.replace(/^\/+/, "");
-            r = r.replace(/\/+$/, "");
-            r = `${r}/${d}`;
-        }
-    }
-    return r;
-}
-/**
- * Returns a full URL.
- * If partial_url is already absolute (starts with http), it is returned as is.
- * Otherwise, it is combined with the base URL.
- */
-function get_full_url(partial_url, domain = null) {
-    if (typeof partial_url !== 'string') {
-        throw new Error('partial_url must be a string');
-    }
-    // If it already starts with http, assume it is absolute.
-    if (partial_url.startsWith('http')) {
-        return partial_url;
-    }
-    return urlJoin(domain, partial_url);
-}
-/**
- * Returns a full file system path.
- * If partial_path is already absolute, it is returned as is.
- * Otherwise, it is joined with the base directory.
- */
-function get_full_path(partial_path, parent_dir = null) {
-    if (typeof partial_path !== 'string') {
-        throw new Error('partial_path must be a string');
-    }
-    if (path$1.isAbsolute(partial_path)) {
-        return partial_path;
-    }
-    return urlJoin(parent_dir, partial_path);
-}
-/**
- * Converts a local file system path into its corresponding URL.
- * It checks against the known directories in all_paths and replaces the matching base.
- */
-function path_to_url(filePath, all_paths) {
-    if (typeof filePath !== 'string') {
-        throw new Error('filePath must be a string');
-    }
-    for (const key in all_paths) {
-        const mapping = all_paths[key];
-        const normalizedBase = path$1.normalize(mapping.path);
-        if (filePath.startsWith(normalizedBase)) {
-            const relativePath = filePath.substring(normalizedBase.length);
-            return urlJoin(mapping.url, relativePath.replace(/\\/g, '/'));
-        }
-    }
-    return null;
-}
-/**
- * Converts a URL into its corresponding local file system path.
- * It checks against the known URL prefixes in all_paths and replaces the matching base.
- */
-function url_to_path(urlStr, all_paths) {
-    if (typeof urlStr !== 'string') {
-        throw new Error('urlStr must be a string');
-    }
-    for (const key in all_paths) {
-        const mapping = all_paths[key];
-        if (urlStr.startsWith(mapping.url)) {
-            const relativeUrl = urlStr.substring(mapping.url.length);
-            return urlJoin(mapping.path, relativeUrl);
-        }
-    }
-    return null;
-}
-function urljoin(...parts) {
-    return urlJoin(...parts);
-}
+var pathBrowserify = posix;
 
 function split_outside_brackets(s) {
     let depth = 0;
@@ -1054,7 +986,7 @@ function formatNumber(value) {
             return value;
         return US_DECIMAL_FORMATTER.format(num);
     }
-    catch (_a) {
+    catch {
         // if anything goes wrong, return the original
         return value;
     }
@@ -1095,7 +1027,7 @@ function findKeyValue(obj, keyToFind) {
     return undefined;
 }
 function omitKeys(obj, ...keys) {
-    const newObj = Object.assign({}, obj);
+    const newObj = { ...obj };
     keys.forEach(key => {
         delete newObj[key];
     });
@@ -1111,7 +1043,7 @@ function extractInsertData(insertValue) {
     // Example: Suppose you only need certain fields from the transaction
     // Modify this function based on your actual data structure
     if (insertValue && typeof insertValue === 'object') {
-        const { transaction } = insertValue, rest = __rest(insertValue, ["transaction"]); // Exclude 'transaction' property
+        const { transaction, ...rest } = insertValue; // Exclude 'transaction' property
         return rest;
     }
     return insertValue;
@@ -1181,36 +1113,7 @@ function getAlphas() {
     return 'abcdefghijklmnopqrstuvwxyz';
 }
 
-// shims/empty.js
-// Fake Node APIs for browser builds — every fn is a harmless noop.
-
-function statSync() {
-    throw new Error("fs.statSync is not available in browser");
-}
-function readdirSync() {
-    return [];
-}
-
-// For async fs/promises
-async function stat() {
-    throw new Error("fs.promises.stat is not available in browser");
-}
-async function readdir() {
-    return [];
-}
-
-// Export default empty object for wildcard imports
-var require$$0$6 = {};
-
-var fsp = /*#__PURE__*/Object.freeze({
-    __proto__: null,
-    default: require$$0$6,
-    readdir: readdir,
-    readdirSync: readdirSync,
-    stat: stat,
-    statSync: statSync
-});
-
+// mediaTypes.ts
 /** ---- Data: large but explicit, mirrors your Python mapping ---- */
 const MIME_TYPES = {
     image: {
@@ -1362,13 +1265,12 @@ function toCategorySet(categories) {
     return out.size ? out : new Set(allCats);
 }
 function normalizeCategories(categories, opts) {
-    var _a;
-    const selected = (_a = categories !== null && categories !== void 0 ? categories : opts === null || opts === void 0 ? void 0 : opts.media_types) !== null && _a !== void 0 ? _a : null;
+    const selected = categories ?? opts?.media_types ?? null;
     return toCategorySet(selected);
 }
 function extOf(input) {
     // Behaves like pathlib.Path(...).suffix.lower(): last extension only; lowercased.
-    let ext = pathBrowserify$1.extname(input || "");
+    let ext = path.extname(input || "");
     if (!ext && input && input.startsWith(".")) {
         // user passed ".jpg" directly
         ext = input;
@@ -1439,24 +1341,24 @@ function getMimeType(pathOrExt) {
 }
 function getAllFileTypesSync(directory, categories, opts) {
     // 🧩 Skip entirely if fs isn't available
-    if (!fsp || !path$2)
+    if (!fs || !path)
         return [];
     try {
-        const stat = statSync(directory);
+        const stat = fs.statSync(directory);
         if (!stat.isDirectory())
             return [];
         const cats = normalizeCategories(categories, opts);
         const wanted = unionExts(cats);
         const results = [];
         function walkSync(dir) {
-            const entries = readdirSync(dir, { withFileTypes: true });
+            const entries = fs.readdirSync(dir, { withFileTypes: true });
             for (const ent of entries) {
-                const full = pathBrowserify$1.join(dir, ent.name);
+                const full = path.join(dir, ent.name);
                 if (ent.isDirectory()) {
                     walkSync(full);
                 }
                 else if (ent.isFile()) {
-                    const ext = pathBrowserify$1.extname(ent.name).toLowerCase();
+                    const ext = path.extname(ent.name).toLowerCase();
                     if (wanted.has(ext))
                         results.push(full);
                 }
@@ -1465,45 +1367,41 @@ function getAllFileTypesSync(directory, categories, opts) {
         walkSync(directory);
         return results;
     }
-    catch (_a) {
+    catch {
         return [];
     }
 }
-function getAllFileTypes(directory, categories, opts) {
-    return __awaiter(this, void 0, void 0, function* () {
-        // 🧩 Skip entirely if fsp isn't available
-        if (!fsp || !path$2)
+async function getAllFileTypes(directory, categories, opts) {
+    // 🧩 Skip entirely if fsp isn't available
+    if (!fsp || !path)
+        return [];
+    try {
+        const stat = await fsp.stat(directory);
+        if (!stat.isDirectory())
             return [];
-        try {
-            const stat$1 = yield stat(directory);
-            if (!stat$1.isDirectory())
-                return [];
-            const cats = normalizeCategories(categories, opts);
-            const wanted = unionExts(cats);
-            const results = [];
-            function walkAsync(dir) {
-                return __awaiter(this, void 0, void 0, function* () {
-                    const entries = yield readdir(dir, { withFileTypes: true });
-                    for (const ent of entries) {
-                        const full = pathBrowserify$1.join(dir, ent.name);
-                        if (ent.isDirectory()) {
-                            yield walkAsync(full);
-                        }
-                        else if (ent.isFile()) {
-                            const ext = pathBrowserify$1.extname(ent.name).toLowerCase();
-                            if (wanted.has(ext))
-                                results.push(full);
-                        }
-                    }
-                });
+        const cats = normalizeCategories(categories, opts);
+        const wanted = unionExts(cats);
+        const results = [];
+        async function walkAsync(dir) {
+            const entries = await fsp.readdir(dir, { withFileTypes: true });
+            for (const ent of entries) {
+                const full = path.join(dir, ent.name);
+                if (ent.isDirectory()) {
+                    await walkAsync(full);
+                }
+                else if (ent.isFile()) {
+                    const ext = path.extname(ent.name).toLowerCase();
+                    if (wanted.has(ext))
+                        results.push(full);
+                }
             }
-            yield walkAsync(directory);
-            return results;
-        }
-        catch (_a) {
-            return [];
         }
-    });
+        await walkAsync(directory);
+        return results;
+    }
+    catch {
+        return [];
+    }
 }
 /** Optional convenience re-exports that mirror your Python names */
 const get_all_file_types = getAllFileTypes;
@@ -1521,10 +1419,9 @@ function getIfNone(obj, fallback) {
  * Merges non-null values from multiple dictionaries.
  */
 function mergeNotNullValues(dictA, dictB, dictC, dictD, dictE) {
-    var _a, _b, _c, _d;
     const result = {};
     for (const key of Object.keys(dictA)) {
-        result[key] = (_d = (_c = (_b = (_a = dictA[key]) !== null && _a !== void 0 ? _a : dictB === null || dictB === void 0 ? void 0 : dictB[key]) !== null && _b !== void 0 ? _b : dictC === null || dictC === void 0 ? void 0 : dictC[key]) !== null && _c !== void 0 ? _c : dictD === null || dictD === void 0 ? void 0 : dictD[key]) !== null && _d !== void 0 ? _d : dictE === null || dictE === void 0 ? void 0 : dictE[key];
+        result[key] = dictA[key] ?? dictB?.[key] ?? dictC?.[key] ?? dictD?.[key] ?? dictE?.[key];
     }
     return result;
 }
@@ -1537,8 +1434,8 @@ function emptyObjectToNull(value) {
 
 function getSubstring(obj, maxLength = null, minLength = null) {
     const objLength = obj.length;
-    const effectiveMaxLength = maxLength !== null && maxLength !== void 0 ? maxLength : objLength; // Use nullish coalescing for clarity
-    const effectiveMinLength = minLength !== null && minLength !== void 0 ? minLength : 0;
+    const effectiveMaxLength = maxLength ?? objLength; // Use nullish coalescing for clarity
+    const effectiveMinLength = minLength ?? 0;
     // Ensure bounds are valid
     const clampedMaxLength = Math.min(Math.max(effectiveMaxLength, 0), objLength);
     const clampedMinLength = Math.min(Math.max(effectiveMinLength, 0), objLength);
@@ -1746,7 +1643,7 @@ function fileURLToPath(fileUrl) {
         const u = new URL(fileUrl);
         return u.pathname;
     }
-    catch (_a) {
+    catch {
         // fallback: just strip file://
         return fileUrl.replace(/^file:\/\//, '');
     }
@@ -1758,30 +1655,30 @@ function getAbsolutePath() {
 function get_dirname(filePath) {
     if (!filePath)
         return '';
-    return pathBrowserify$1.dirname(filePath);
+    return pathBrowserify.dirname(filePath);
 }
 function get_basename(filePath) {
     if (!filePath)
         return '';
-    return pathBrowserify$1.basename(filePath);
+    return pathBrowserify.basename(filePath);
 }
 function get_filename(filePath) {
     if (!filePath)
         return '';
-    const ext = pathBrowserify$1.extname(filePath);
-    return pathBrowserify$1.basename(filePath, ext);
+    const ext = pathBrowserify.extname(filePath);
+    return pathBrowserify.basename(filePath, ext);
 }
 function get_extname(filePath) {
     if (!filePath)
         return '';
-    return pathBrowserify$1.extname(filePath);
+    return pathBrowserify.extname(filePath);
 }
 function get_splitext(filePath) {
     if (!filePath)
         return { filename: '', extname: '' };
-    const ext = pathBrowserify$1.extname(filePath);
+    const ext = pathBrowserify.extname(filePath);
     // Get the basename without the extension
-    const filename = pathBrowserify$1.basename(filePath, ext);
+    const filename = pathBrowserify.basename(filePath, ext);
     return { filename, ext };
 }
 /**
@@ -1795,9 +1692,9 @@ function get_splitext(filePath) {
 function get_relative_path(basePath, targetPath) {
     try {
         // Compute the relative path using Node's native path.relative
-        let rel = pathBrowserify$1.relative(basePath, targetPath);
+        let rel = pathBrowserify.relative(basePath, targetPath);
         // Normalize to POSIX-style slashes for consistency (especially on Windows)
-        rel = rel.split(pathBrowserify$1.sep).join('/');
+        rel = rel.split(pathBrowserify.sep).join('/');
         // Avoid empty string (happens if both paths are identical)
         return rel || '.';
     }
@@ -2006,7 +1903,7 @@ function alertit(obj = null) {
     try {
         msg = JSON.stringify(obj);
     }
-    catch (_a) {
+    catch {
         // If JSON.stringify fails (circular refs, etc.), fall back to a simple string
         msg = String(obj);
     }
@@ -2062,665 +1959,161 @@ const MINUTE = 60 * SECOND;
 const HOUR = 60 * MINUTE;
 const DAY = 24 * HOUR;
 const YEAR = 365 * DAY;
-const MONTH = YEAR / 12;
-// Derived: explicit names
-const SECONDS_PER_MINUTE = MINUTE;
-const SECONDS_PER_HOUR = HOUR;
-const SECONDS_PER_DAY = DAY;
-//math
-const PI = Math.PI;
-const PI2 = 2 * PI;
-// Distance
-const METERS_PER_KM = 1000;
-const METERS_PER_MILE = 1609.34;
-const METERS_PER_FOOT = 0.3048;
-const KMS_PER_METER = 1 / METERS_PER_KM;
-const MILES_PER_METER = 1 / METERS_PER_MILE;
-const FEET_PER_METER = 1 / METERS_PER_FOOT;
-const MIN_IN_S = 1 / MINUTE;
-const HOUR_IN_S = 1 / HOUR;
-const DAY_IN_S = 1 / DAY;
-const YEAR_IN_S = 1 / YEAR;
-const MONTH_IN_S = 1 / MONTH;
-const MiPerH_TO_MPerS = METERS_PER_MILE * HOUR_IN_S;
-const MPerS_TO_MiPerH = 1 / MiPerH_TO_MPerS;
-
-// conversions.ts
-/*───────────────────────────────────────────────────────────────
-  🧭 CANONICAL MAPPINGS
-───────────────────────────────────────────────────────────────*/
-const DIST_ALIASES = {
-    m: "m", meter: "m", meters: "m",
-    km: "km", kms: "km", kilometer: "km", kilometers: "km",
-    mi: "mi", mile: "mi", miles: "mi",
-    ft: "ft", f: "ft", foot: "ft", feet: "ft",
-};
-const TIME_ALIASES = {
-    s: "s", sec: "s", second: "s", seconds: "s",
-    min: "min", m: "min", minute: "min", minutes: "min",
-    h: "h", hr: "h", hour: "h", hours: "h",
-    day: "day", d: "day", days: "day",
-};
-const DIST_FACTORS = {
-    m: 1,
-    km: METERS_PER_KM,
-    mi: METERS_PER_MILE,
-    ft: METERS_PER_FOOT,
-};
-const TIME_FACTORS = {
-    s: 1,
-    min: MINUTE,
-    h: HOUR,
-    day: DAY,
-};
-/*───────────────────────────────────────────────────────────────
-  🔍 CANONICALIZATION HELPERS
-───────────────────────────────────────────────────────────────*/
-function canonDist(u) {
-    const key = (u !== null && u !== void 0 ? u : "m").toString().toLowerCase();
-    const canon = DIST_ALIASES[key];
-    if (!canon)
-        throw new Error(`Unknown distance unit: ${u}`);
-    return canon;
-}
-function canonTime(u) {
-    const key = (u !== null && u !== void 0 ? u : "s").toString().toLowerCase();
-    const canon = TIME_ALIASES[key];
-    if (!canon)
-        throw new Error(`Unknown time unit: ${u}`);
-    return canon;
-}
-/*───────────────────────────────────────────────────────────────
-  ⚖️ NORMALIZATION HELPERS
-───────────────────────────────────────────────────────────────*/
-function distanceToMeters(d, unit) {
-    const u = canonDist(unit);
-    return safeMultiply(d, DIST_FACTORS[u]);
-}
-function metersToDistance(v, unit) {
-    const u = canonDist(unit);
-    return safeDivide(v, DIST_FACTORS[u]);
-}
-function timeToSeconds(t, unit) {
-    const u = canonTime(unit);
-    return safeMultiply(t, TIME_FACTORS[u]);
-}
-function secondsToTime(v, unit) {
-    const u = canonTime(unit);
-    return safeDivide(v, TIME_FACTORS[u]);
-}
-/*───────────────────────────────────────────────────────────────
-  🚀 SPEED CONVERSIONS (normalize / unnormalize)
-───────────────────────────────────────────────────────────────*/
-function speedToMps(v, distUnit, timeUnit) {
-    const du = canonDist(distUnit);
-    const tu = canonTime(timeUnit);
-    return v * (DIST_FACTORS[du] / TIME_FACTORS[tu]);
-}
-function mpsToSpeed(vMps, distUnit, timeUnit) {
-    const du = canonDist(distUnit);
-    const tu = canonTime(timeUnit);
-    return vMps * (TIME_FACTORS[tu] / DIST_FACTORS[du]);
-}
-/*───────────────────────────────────────────────────────────────
-  🎯 UNIVERSAL CONVERTERS
-───────────────────────────────────────────────────────────────*/
-function convertDistance({ d, fromDist, toDist, vOnly = true, }) {
-    const m = distanceToMeters(d, fromDist);
-    const D = canonDist(toDist !== null && toDist !== void 0 ? toDist : "m");
-    const out = metersToDistance(m, D);
-    return vOnly ? out : { d: out, D };
-}
-function convertTime({ t, fromTime, toTime, vOnly = true, }) {
-    const sec = timeToSeconds(t, fromTime);
-    const T = canonTime(toTime !== null && toTime !== void 0 ? toTime : "s");
-    const out = secondsToTime(sec, T);
-    return vOnly ? out : { t: out, T };
-}
-function convertSpeed({ v, fromDist, fromTime, toDist, toTime, vOnly = true, }) {
-    const mps = speedToMps(v, fromDist, fromTime);
-    const d = canonDist(toDist !== null && toDist !== void 0 ? toDist : "m");
-    const t = canonTime(toTime !== null && toTime !== void 0 ? toTime : "s");
-    const out = mpsToSpeed(mps, d, t);
-    return vOnly ? out : { v: out, d, t };
-}
-const DistanceConverter = {
-    normalize: distanceToMeters,
-    unnormalize: metersToDistance,
-};
-const TimeConverter = {
-    normalize: timeToSeconds,
-    unnormalize: secondsToTime,
-};
-const SpeedConverter = {
-    normalize: (v, [du, tu]) => speedToMps(v, du, tu),
-    unnormalize: (v, [du, tu]) => mpsToSpeed(v, du, tu),
-};
-/*───────────────────────────────────────────────────────────────
-  🧩 COMPATIBILITY WRAPPERS (legacy aliases)
-───────────────────────────────────────────────────────────────*/
-const toMeters = distanceToMeters;
-const fromMeters = metersToDistance;
-const toSeconds = timeToSeconds;
-const fromSeconds = secondsToTime;
-const velocityToMs = (value, unit) => speedToMps(value, unit, "s");
-const velocityFromMs = (value, unit) => mpsToSpeed(value, unit, "s");
-/** Non-canonical helper for arbitrary rate conversion, e.g. ft/day → m/s */
-const fromMps = (v, dist_unit, time_unit) => mpsToSpeed(v, dist_unit, time_unit);
-/*───────────────────────────────────────────────────────────────
-  📊 UTILITIES
-───────────────────────────────────────────────────────────────*/
-const isFiniteNum = (x) => Number.isFinite(x);
-const fmt = (n, digits = 2) => isFiniteNum(n) ? n.toFixed(digits) : "N/A";
-
-// Function to check time interval
-function isTimeInterval(timeObj, interval) {
-    return (Date.now() / 1000 - timeObj) < (interval - 1);
-}
-
-function assertPath(path) {
-  if (typeof path !== 'string') {
-    throw new TypeError('Path must be a string. Received ' + JSON.stringify(path));
-  }
-}
-
-// Resolves . and .. elements in a path with directory names
-function normalizeStringPosix(path, allowAboveRoot) {
-  var res = '';
-  var lastSegmentLength = 0;
-  var lastSlash = -1;
-  var dots = 0;
-  var code;
-  for (var i = 0; i <= path.length; ++i) {
-    if (i < path.length)
-      code = path.charCodeAt(i);
-    else if (code === 47 /*/*/)
-      break;
-    else
-      code = 47 /*/*/;
-    if (code === 47 /*/*/) {
-      if (lastSlash === i - 1 || dots === 1) ; else if (lastSlash !== i - 1 && dots === 2) {
-        if (res.length < 2 || lastSegmentLength !== 2 || res.charCodeAt(res.length - 1) !== 46 /*.*/ || res.charCodeAt(res.length - 2) !== 46 /*.*/) {
-          if (res.length > 2) {
-            var lastSlashIndex = res.lastIndexOf('/');
-            if (lastSlashIndex !== res.length - 1) {
-              if (lastSlashIndex === -1) {
-                res = '';
-                lastSegmentLength = 0;
-              } else {
-                res = res.slice(0, lastSlashIndex);
-                lastSegmentLength = res.length - 1 - res.lastIndexOf('/');
-              }
-              lastSlash = i;
-              dots = 0;
-              continue;
-            }
-          } else if (res.length === 2 || res.length === 1) {
-            res = '';
-            lastSegmentLength = 0;
-            lastSlash = i;
-            dots = 0;
-            continue;
-          }
-        }
-        if (allowAboveRoot) {
-          if (res.length > 0)
-            res += '/..';
-          else
-            res = '..';
-          lastSegmentLength = 2;
-        }
-      } else {
-        if (res.length > 0)
-          res += '/' + path.slice(lastSlash + 1, i);
-        else
-          res = path.slice(lastSlash + 1, i);
-        lastSegmentLength = i - lastSlash - 1;
-      }
-      lastSlash = i;
-      dots = 0;
-    } else if (code === 46 /*.*/ && dots !== -1) {
-      ++dots;
-    } else {
-      dots = -1;
-    }
-  }
-  return res;
-}
-
-function _format(sep, pathObject) {
-  var dir = pathObject.dir || pathObject.root;
-  var base = pathObject.base || (pathObject.name || '') + (pathObject.ext || '');
-  if (!dir) {
-    return base;
-  }
-  if (dir === pathObject.root) {
-    return dir + base;
-  }
-  return dir + sep + base;
-}
-
-var posix = {
-  // path.resolve([from ...], to)
-  resolve: function resolve() {
-    var resolvedPath = '';
-    var resolvedAbsolute = false;
-    var cwd;
-
-    for (var i = arguments.length - 1; i >= -1 && !resolvedAbsolute; i--) {
-      var path;
-      if (i >= 0)
-        path = arguments[i];
-      else {
-        if (cwd === undefined)
-          cwd = process.cwd();
-        path = cwd;
-      }
-
-      assertPath(path);
-
-      // Skip empty entries
-      if (path.length === 0) {
-        continue;
-      }
-
-      resolvedPath = path + '/' + resolvedPath;
-      resolvedAbsolute = path.charCodeAt(0) === 47 /*/*/;
-    }
-
-    // At this point the path should be resolved to a full absolute path, but
-    // handle relative paths to be safe (might happen when process.cwd() fails)
-
-    // Normalize the path
-    resolvedPath = normalizeStringPosix(resolvedPath, !resolvedAbsolute);
-
-    if (resolvedAbsolute) {
-      if (resolvedPath.length > 0)
-        return '/' + resolvedPath;
-      else
-        return '/';
-    } else if (resolvedPath.length > 0) {
-      return resolvedPath;
-    } else {
-      return '.';
-    }
-  },
-
-  normalize: function normalize(path) {
-    assertPath(path);
-
-    if (path.length === 0) return '.';
-
-    var isAbsolute = path.charCodeAt(0) === 47 /*/*/;
-    var trailingSeparator = path.charCodeAt(path.length - 1) === 47 /*/*/;
-
-    // Normalize the path
-    path = normalizeStringPosix(path, !isAbsolute);
-
-    if (path.length === 0 && !isAbsolute) path = '.';
-    if (path.length > 0 && trailingSeparator) path += '/';
-
-    if (isAbsolute) return '/' + path;
-    return path;
-  },
-
-  isAbsolute: function isAbsolute(path) {
-    assertPath(path);
-    return path.length > 0 && path.charCodeAt(0) === 47 /*/*/;
-  },
-
-  join: function join() {
-    if (arguments.length === 0)
-      return '.';
-    var joined;
-    for (var i = 0; i < arguments.length; ++i) {
-      var arg = arguments[i];
-      assertPath(arg);
-      if (arg.length > 0) {
-        if (joined === undefined)
-          joined = arg;
-        else
-          joined += '/' + arg;
-      }
-    }
-    if (joined === undefined)
-      return '.';
-    return posix.normalize(joined);
-  },
-
-  relative: function relative(from, to) {
-    assertPath(from);
-    assertPath(to);
-
-    if (from === to) return '';
-
-    from = posix.resolve(from);
-    to = posix.resolve(to);
-
-    if (from === to) return '';
-
-    // Trim any leading backslashes
-    var fromStart = 1;
-    for (; fromStart < from.length; ++fromStart) {
-      if (from.charCodeAt(fromStart) !== 47 /*/*/)
-        break;
-    }
-    var fromEnd = from.length;
-    var fromLen = fromEnd - fromStart;
-
-    // Trim any leading backslashes
-    var toStart = 1;
-    for (; toStart < to.length; ++toStart) {
-      if (to.charCodeAt(toStart) !== 47 /*/*/)
-        break;
-    }
-    var toEnd = to.length;
-    var toLen = toEnd - toStart;
-
-    // Compare paths to find the longest common path from root
-    var length = fromLen < toLen ? fromLen : toLen;
-    var lastCommonSep = -1;
-    var i = 0;
-    for (; i <= length; ++i) {
-      if (i === length) {
-        if (toLen > length) {
-          if (to.charCodeAt(toStart + i) === 47 /*/*/) {
-            // We get here if `from` is the exact base path for `to`.
-            // For example: from='/foo/bar'; to='/foo/bar/baz'
-            return to.slice(toStart + i + 1);
-          } else if (i === 0) {
-            // We get here if `from` is the root
-            // For example: from='/'; to='/foo'
-            return to.slice(toStart + i);
-          }
-        } else if (fromLen > length) {
-          if (from.charCodeAt(fromStart + i) === 47 /*/*/) {
-            // We get here if `to` is the exact base path for `from`.
-            // For example: from='/foo/bar/baz'; to='/foo/bar'
-            lastCommonSep = i;
-          } else if (i === 0) {
-            // We get here if `to` is the root.
-            // For example: from='/foo'; to='/'
-            lastCommonSep = 0;
-          }
-        }
-        break;
-      }
-      var fromCode = from.charCodeAt(fromStart + i);
-      var toCode = to.charCodeAt(toStart + i);
-      if (fromCode !== toCode)
-        break;
-      else if (fromCode === 47 /*/*/)
-        lastCommonSep = i;
-    }
-
-    var out = '';
-    // Generate the relative path based on the path difference between `to`
-    // and `from`
-    for (i = fromStart + lastCommonSep + 1; i <= fromEnd; ++i) {
-      if (i === fromEnd || from.charCodeAt(i) === 47 /*/*/) {
-        if (out.length === 0)
-          out += '..';
-        else
-          out += '/..';
-      }
-    }
-
-    // Lastly, append the rest of the destination (`to`) path that comes after
-    // the common path parts
-    if (out.length > 0)
-      return out + to.slice(toStart + lastCommonSep);
-    else {
-      toStart += lastCommonSep;
-      if (to.charCodeAt(toStart) === 47 /*/*/)
-        ++toStart;
-      return to.slice(toStart);
-    }
-  },
-
-  _makeLong: function _makeLong(path) {
-    return path;
-  },
-
-  dirname: function dirname(path) {
-    assertPath(path);
-    if (path.length === 0) return '.';
-    var code = path.charCodeAt(0);
-    var hasRoot = code === 47 /*/*/;
-    var end = -1;
-    var matchedSlash = true;
-    for (var i = path.length - 1; i >= 1; --i) {
-      code = path.charCodeAt(i);
-      if (code === 47 /*/*/) {
-          if (!matchedSlash) {
-            end = i;
-            break;
-          }
-        } else {
-        // We saw the first non-path separator
-        matchedSlash = false;
-      }
-    }
-
-    if (end === -1) return hasRoot ? '/' : '.';
-    if (hasRoot && end === 1) return '//';
-    return path.slice(0, end);
-  },
-
-  basename: function basename(path, ext) {
-    if (ext !== undefined && typeof ext !== 'string') throw new TypeError('"ext" argument must be a string');
-    assertPath(path);
-
-    var start = 0;
-    var end = -1;
-    var matchedSlash = true;
-    var i;
-
-    if (ext !== undefined && ext.length > 0 && ext.length <= path.length) {
-      if (ext.length === path.length && ext === path) return '';
-      var extIdx = ext.length - 1;
-      var firstNonSlashEnd = -1;
-      for (i = path.length - 1; i >= 0; --i) {
-        var code = path.charCodeAt(i);
-        if (code === 47 /*/*/) {
-            // If we reached a path separator that was not part of a set of path
-            // separators at the end of the string, stop now
-            if (!matchedSlash) {
-              start = i + 1;
-              break;
-            }
-          } else {
-          if (firstNonSlashEnd === -1) {
-            // We saw the first non-path separator, remember this index in case
-            // we need it if the extension ends up not matching
-            matchedSlash = false;
-            firstNonSlashEnd = i + 1;
-          }
-          if (extIdx >= 0) {
-            // Try to match the explicit extension
-            if (code === ext.charCodeAt(extIdx)) {
-              if (--extIdx === -1) {
-                // We matched the extension, so mark this as the end of our path
-                // component
-                end = i;
-              }
-            } else {
-              // Extension does not match, so our result is the entire path
-              // component
-              extIdx = -1;
-              end = firstNonSlashEnd;
-            }
-          }
-        }
-      }
-
-      if (start === end) end = firstNonSlashEnd;else if (end === -1) end = path.length;
-      return path.slice(start, end);
-    } else {
-      for (i = path.length - 1; i >= 0; --i) {
-        if (path.charCodeAt(i) === 47 /*/*/) {
-            // If we reached a path separator that was not part of a set of path
-            // separators at the end of the string, stop now
-            if (!matchedSlash) {
-              start = i + 1;
-              break;
-            }
-          } else if (end === -1) {
-          // We saw the first non-path separator, mark this as the end of our
-          // path component
-          matchedSlash = false;
-          end = i + 1;
-        }
-      }
-
-      if (end === -1) return '';
-      return path.slice(start, end);
-    }
-  },
-
-  extname: function extname(path) {
-    assertPath(path);
-    var startDot = -1;
-    var startPart = 0;
-    var end = -1;
-    var matchedSlash = true;
-    // Track the state of characters (if any) we see before our first dot and
-    // after any path separator we find
-    var preDotState = 0;
-    for (var i = path.length - 1; i >= 0; --i) {
-      var code = path.charCodeAt(i);
-      if (code === 47 /*/*/) {
-          // If we reached a path separator that was not part of a set of path
-          // separators at the end of the string, stop now
-          if (!matchedSlash) {
-            startPart = i + 1;
-            break;
-          }
-          continue;
-        }
-      if (end === -1) {
-        // We saw the first non-path separator, mark this as the end of our
-        // extension
-        matchedSlash = false;
-        end = i + 1;
-      }
-      if (code === 46 /*.*/) {
-          // If this is our first dot, mark it as the start of our extension
-          if (startDot === -1)
-            startDot = i;
-          else if (preDotState !== 1)
-            preDotState = 1;
-      } else if (startDot !== -1) {
-        // We saw a non-dot and non-path separator before our dot, so we should
-        // have a good chance at having a non-empty extension
-        preDotState = -1;
-      }
-    }
-
-    if (startDot === -1 || end === -1 ||
-        // We saw a non-dot character immediately before the dot
-        preDotState === 0 ||
-        // The (right-most) trimmed path component is exactly '..'
-        preDotState === 1 && startDot === end - 1 && startDot === startPart + 1) {
-      return '';
-    }
-    return path.slice(startDot, end);
-  },
-
-  format: function format(pathObject) {
-    if (pathObject === null || typeof pathObject !== 'object') {
-      throw new TypeError('The "pathObject" argument must be of type Object. Received type ' + typeof pathObject);
-    }
-    return _format('/', pathObject);
-  },
-
-  parse: function parse(path) {
-    assertPath(path);
-
-    var ret = { root: '', dir: '', base: '', ext: '', name: '' };
-    if (path.length === 0) return ret;
-    var code = path.charCodeAt(0);
-    var isAbsolute = code === 47 /*/*/;
-    var start;
-    if (isAbsolute) {
-      ret.root = '/';
-      start = 1;
-    } else {
-      start = 0;
-    }
-    var startDot = -1;
-    var startPart = 0;
-    var end = -1;
-    var matchedSlash = true;
-    var i = path.length - 1;
-
-    // Track the state of characters (if any) we see before our first dot and
-    // after any path separator we find
-    var preDotState = 0;
-
-    // Get non-dir info
-    for (; i >= start; --i) {
-      code = path.charCodeAt(i);
-      if (code === 47 /*/*/) {
-          // If we reached a path separator that was not part of a set of path
-          // separators at the end of the string, stop now
-          if (!matchedSlash) {
-            startPart = i + 1;
-            break;
-          }
-          continue;
-        }
-      if (end === -1) {
-        // We saw the first non-path separator, mark this as the end of our
-        // extension
-        matchedSlash = false;
-        end = i + 1;
-      }
-      if (code === 46 /*.*/) {
-          // If this is our first dot, mark it as the start of our extension
-          if (startDot === -1) startDot = i;else if (preDotState !== 1) preDotState = 1;
-        } else if (startDot !== -1) {
-        // We saw a non-dot and non-path separator before our dot, so we should
-        // have a good chance at having a non-empty extension
-        preDotState = -1;
-      }
-    }
-
-    if (startDot === -1 || end === -1 ||
-    // We saw a non-dot character immediately before the dot
-    preDotState === 0 ||
-    // The (right-most) trimmed path component is exactly '..'
-    preDotState === 1 && startDot === end - 1 && startDot === startPart + 1) {
-      if (end !== -1) {
-        if (startPart === 0 && isAbsolute) ret.base = ret.name = path.slice(1, end);else ret.base = ret.name = path.slice(startPart, end);
-      }
-    } else {
-      if (startPart === 0 && isAbsolute) {
-        ret.name = path.slice(1, startDot);
-        ret.base = path.slice(1, end);
-      } else {
-        ret.name = path.slice(startPart, startDot);
-        ret.base = path.slice(startPart, end);
-      }
-      ret.ext = path.slice(startDot, end);
-    }
-
-    if (startPart > 0) ret.dir = path.slice(0, startPart - 1);else if (isAbsolute) ret.dir = '/';
-
-    return ret;
-  },
+const MONTH = YEAR / 12;
+// Derived: explicit names
+const SECONDS_PER_MINUTE = MINUTE;
+const SECONDS_PER_HOUR = HOUR;
+const SECONDS_PER_DAY = DAY;
+//math
+const PI = Math.PI;
+const PI2 = 2 * PI;
+// Distance
+const METERS_PER_KM = 1000;
+const METERS_PER_MILE = 1609.34;
+const METERS_PER_FOOT = 0.3048;
+const KMS_PER_METER = 1 / METERS_PER_KM;
+const MILES_PER_METER = 1 / METERS_PER_MILE;
+const FEET_PER_METER = 1 / METERS_PER_FOOT;
+const MIN_IN_S = 1 / MINUTE;
+const HOUR_IN_S = 1 / HOUR;
+const DAY_IN_S = 1 / DAY;
+const YEAR_IN_S = 1 / YEAR;
+const MONTH_IN_S = 1 / MONTH;
+const MiPerH_TO_MPerS = METERS_PER_MILE * HOUR_IN_S;
+const MPerS_TO_MiPerH = 1 / MiPerH_TO_MPerS;
 
-  sep: '/',
-  delimiter: ':',
-  win32: null,
-  posix: null
+// conversions.ts
+/*───────────────────────────────────────────────────────────────
+  🧭 CANONICAL MAPPINGS
+───────────────────────────────────────────────────────────────*/
+const DIST_ALIASES = {
+    m: "m", meter: "m", meters: "m",
+    km: "km", kms: "km", kilometer: "km", kilometers: "km",
+    mi: "mi", mile: "mi", miles: "mi",
+    ft: "ft", f: "ft", foot: "ft", feet: "ft",
 };
+const TIME_ALIASES = {
+    s: "s", sec: "s", second: "s", seconds: "s",
+    min: "min", m: "min", minute: "min", minutes: "min",
+    h: "h", hr: "h", hour: "h", hours: "h",
+    day: "day", d: "day", days: "day",
+};
+const DIST_FACTORS = {
+    m: 1,
+    km: METERS_PER_KM,
+    mi: METERS_PER_MILE,
+    ft: METERS_PER_FOOT,
+};
+const TIME_FACTORS = {
+    s: 1,
+    min: MINUTE,
+    h: HOUR,
+    day: DAY,
+};
+/*───────────────────────────────────────────────────────────────
+  🔍 CANONICALIZATION HELPERS
+───────────────────────────────────────────────────────────────*/
+function canonDist(u) {
+    const key = (u ?? "m").toString().toLowerCase();
+    const canon = DIST_ALIASES[key];
+    if (!canon)
+        throw new Error(`Unknown distance unit: ${u}`);
+    return canon;
+}
+function canonTime(u) {
+    const key = (u ?? "s").toString().toLowerCase();
+    const canon = TIME_ALIASES[key];
+    if (!canon)
+        throw new Error(`Unknown time unit: ${u}`);
+    return canon;
+}
+/*───────────────────────────────────────────────────────────────
+  ⚖️ NORMALIZATION HELPERS
+───────────────────────────────────────────────────────────────*/
+function distanceToMeters(d, unit) {
+    const u = canonDist(unit);
+    return safeMultiply(d, DIST_FACTORS[u]);
+}
+function metersToDistance(v, unit) {
+    const u = canonDist(unit);
+    return safeDivide(v, DIST_FACTORS[u]);
+}
+function timeToSeconds(t, unit) {
+    const u = canonTime(unit);
+    return safeMultiply(t, TIME_FACTORS[u]);
+}
+function secondsToTime(v, unit) {
+    const u = canonTime(unit);
+    return safeDivide(v, TIME_FACTORS[u]);
+}
+/*───────────────────────────────────────────────────────────────
+  🚀 SPEED CONVERSIONS (normalize / unnormalize)
+───────────────────────────────────────────────────────────────*/
+function speedToMps(v, distUnit, timeUnit) {
+    const du = canonDist(distUnit);
+    const tu = canonTime(timeUnit);
+    return v * (DIST_FACTORS[du] / TIME_FACTORS[tu]);
+}
+function mpsToSpeed(vMps, distUnit, timeUnit) {
+    const du = canonDist(distUnit);
+    const tu = canonTime(timeUnit);
+    return vMps * (TIME_FACTORS[tu] / DIST_FACTORS[du]);
+}
+/*───────────────────────────────────────────────────────────────
+  🎯 UNIVERSAL CONVERTERS
+───────────────────────────────────────────────────────────────*/
+function convertDistance({ d, fromDist, toDist, vOnly = true, }) {
+    const m = distanceToMeters(d, fromDist);
+    const D = canonDist(toDist ?? "m");
+    const out = metersToDistance(m, D);
+    return vOnly ? out : { d: out, D };
+}
+function convertTime({ t, fromTime, toTime, vOnly = true, }) {
+    const sec = timeToSeconds(t, fromTime);
+    const T = canonTime(toTime ?? "s");
+    const out = secondsToTime(sec, T);
+    return vOnly ? out : { t: out, T };
+}
+function convertSpeed({ v, fromDist, fromTime, toDist, toTime, vOnly = true, }) {
+    const mps = speedToMps(v, fromDist, fromTime);
+    const d = canonDist(toDist ?? "m");
+    const t = canonTime(toTime ?? "s");
+    const out = mpsToSpeed(mps, d, t);
+    return vOnly ? out : { v: out, d, t };
+}
+const DistanceConverter = {
+    normalize: distanceToMeters,
+    unnormalize: metersToDistance,
+};
+const TimeConverter = {
+    normalize: timeToSeconds,
+    unnormalize: secondsToTime,
+};
+const SpeedConverter = {
+    normalize: (v, [du, tu]) => speedToMps(v, du, tu),
+    unnormalize: (v, [du, tu]) => mpsToSpeed(v, du, tu),
+};
+/*───────────────────────────────────────────────────────────────
+  🧩 COMPATIBILITY WRAPPERS (legacy aliases)
+───────────────────────────────────────────────────────────────*/
+const toMeters = distanceToMeters;
+const fromMeters = metersToDistance;
+const toSeconds = timeToSeconds;
+const fromSeconds = secondsToTime;
+const velocityToMs = (value, unit) => speedToMps(value, unit, "s");
+const velocityFromMs = (value, unit) => mpsToSpeed(value, unit, "s");
+/** Non-canonical helper for arbitrary rate conversion, e.g. ft/day → m/s */
+const fromMps = (v, dist_unit, time_unit) => mpsToSpeed(v, dist_unit, time_unit);
+/*───────────────────────────────────────────────────────────────
+  📊 UTILITIES
+───────────────────────────────────────────────────────────────*/
+const isFiniteNum = (x) => Number.isFinite(x);
+const fmt = (n, digits = 2) => isFiniteNum(n) ? n.toFixed(digits) : "N/A";
 
-posix.posix = posix;
-
-var pathBrowserify = posix;
-
-var require$$1$2 = /*@__PURE__*/getDefaultExportFromCjs(pathBrowserify);
+// Function to check time interval
+function isTimeInterval(timeObj, interval) {
+    return (Date.now() / 1000 - timeObj) < (interval - 1);
+}
 
 var commonjsGlobal = typeof globalThis !== 'undefined' ? globalThis : typeof window !== 'undefined' ? window : typeof global !== 'undefined' ? global : typeof self !== 'undefined' ? self : {};
 
@@ -13577,7 +12970,7 @@ function requireFile () {
 	hasRequiredFile = 1;
 
 	const fs = require$$0$6;
-	const path = require$$1$2;
+	const path = path$1;
 	const asyncSeries = requireSeries();
 	const zlib = require$$3;
 	const { MESSAGE } = tripleBeam;
@@ -17278,7 +16671,7 @@ function resolveLogger(candidate) {
     return null;
 }
 /* ------------------------------------------------------------------ */
-/* UNIVERSAL getLogString (cannot crash)                               */
+/* IMPLEMENTATION                                                      */
 /* ------------------------------------------------------------------ */
 function getLogString(messageOrOptions, logType = null, details = null, function_name = null, file_location = null, consumerLogger = null) {
     // ---------------- Normalize inputs ----------------
@@ -17441,7 +16834,7 @@ function getSafeLocalStorage() {
     try {
         return window.localStorage;
     }
-    catch (_a) {
+    catch {
         return undefined; // e.g. Safari private-mode block
     }
 }
@@ -17462,7 +16855,7 @@ function callStorage(method, ...args) {
     try {
         return fn.apply(storage, args);
     }
-    catch (_a) {
+    catch {
         return undefined;
     }
 }
@@ -17477,7 +16870,7 @@ function safeStorage(storageName, method, ...args) {
             return undefined;
         return store[method](...args);
     }
-    catch (_a) {
+    catch {
         return undefined;
     }
 }
@@ -17507,7 +16900,7 @@ function callWindowMethod(method, ...args) {
         // cast to any so TS doesn’t complain about apply/invoke
         return fn(...args);
     }
-    catch (_a) {
+    catch {
         return undefined;
     }
 }
@@ -17525,172 +16918,132 @@ function getWindowHost() {
     return getWindowProp('location', 'host');
 }
 
-// src/functions/read_utils/src/read_utils.ts
-let fs = null;
-let path = null;
-function getFsModules() {
-    return __awaiter(this, void 0, void 0, function* () {
-        var _a;
-        if (!fs && !path && typeof process !== "undefined" && ((_a = process.versions) === null || _a === void 0 ? void 0 : _a.node)) {
-            try {
-                // prevent bundlers from resolving these at build time
-                fs = (new Function("return require('fs')"))();
-                path = (new Function("return require('path')"))();
-            }
-            catch (_b) {
-                fs = null;
-                path = null;
-            }
-        }
-        return { fs, path };
-    });
-}
-/**
- * Reads a JSON file, either via Node’s fs (if available)
- * or via window.fetch in the browser. Never throws — returns
- * the parsed object or null on any error.
- */
-function readJsonFile(relativeOrAbsolutePath) {
-    return __awaiter(this, void 0, void 0, function* () {
-        var _a;
-        // 1) Try Node.js fs (only at runtime, not bundled)
-        if (typeof process !== "undefined" && ((_a = process.versions) === null || _a === void 0 ? void 0 : _a.node)) {
-            try {
-                const { fs, path } = yield getFsModules();
-                if (fs && path) {
-                    const filePath = path.isAbsolute(relativeOrAbsolutePath)
-                        ? relativeOrAbsolutePath
-                        : path.resolve(process.cwd(), relativeOrAbsolutePath);
-                    const text = fs.readFileSync(filePath, "utf8");
-                    return JSON.parse(text);
-                }
-            }
-            catch (_b) {
-                // swallow and fall back
-            }
-        }
-        // 2) Try browser fetch
-        const fetchFn = safeGlobalProp("fetch");
-        if (typeof fetchFn !== "function") {
-            return null;
-        }
-        let url = relativeOrAbsolutePath;
-        const baseURI = safeGlobalProp("document", "baseURI");
-        if (baseURI) {
-            try {
-                url = new URL(relativeOrAbsolutePath, baseURI).href;
-            }
-            catch (_c) {
-                /* keep url as-is */
-            }
-        }
-        try {
-            const res = yield fetchFn(url);
-            if (!res.ok)
-                return null;
-            return (yield res.json());
-        }
-        catch (_d) {
+async function readJsonFileBrowser(url) {
+    const fetchFn = safeGlobalProp("fetch");
+    if (typeof fetchFn !== "function")
+        return null;
+    try {
+        const res = await fetchFn(url);
+        if (!res.ok)
             return null;
-        }
-    });
+        return (await res.json());
+    }
+    catch {
+        return null;
+    }
 }
-function getConfigContent() {
-    return __awaiter(this, void 0, void 0, function* () {
-        try {
-            // `readJsonFile` should throw if the file isn’t there or isn’t valid JSON
-            const cfg = yield readJsonFile('./config.json');
-            return cfg;
-        }
-        catch (_a) {
-            // swallow errors & return null so callers can detect “no config”
-            return null;
-        }
-    });
+
+var readJsonFile_browser = /*#__PURE__*/Object.freeze({
+    __proto__: null,
+    readJsonFileBrowser: readJsonFileBrowser
+});
+
+function readJsonFileNode(relativeOrAbsolutePath) {
+    try {
+        const filePath = isAbsolute(relativeOrAbsolutePath)
+            ? relativeOrAbsolutePath
+            : resolve(process.cwd(), relativeOrAbsolutePath);
+        return JSON.parse(readFileSync(filePath, "utf8"));
+    }
+    catch {
+        return null;
+    }
 }
-// 2) Pull a single key out of that object
-function getConfigVar() {
-    return __awaiter(this, arguments, void 0, function* (key = null) {
-        const cfg = yield getConfigContent();
-        if (cfg && typeof cfg === 'object' && key in cfg) {
-            return cfg[key];
-        }
-        return undefined;
-    });
+
+var readJsonFile_node = /*#__PURE__*/Object.freeze({
+    __proto__: null,
+    readJsonFileNode: readJsonFileNode
+});
+
+async function readJsonFile(relativeOrAbsolutePath) {
+    if (typeof process !== "undefined" && process.versions?.node) {
+        const mod = await Promise.resolve().then(function () { return readJsonFile_node; });
+        return mod.readJsonFileNode(relativeOrAbsolutePath);
+    }
+    else {
+        const mod = await Promise.resolve().then(function () { return readJsonFile_browser; });
+        return mod.readJsonFileBrowser(relativeOrAbsolutePath);
+    }
+}
+async function getConfigContent() {
+    try {
+        // `readJsonFile` should throw if the file isn’t there or isn’t valid JSON
+        const cfg = await readJsonFile('./config.json');
+        return cfg;
+    }
+    catch {
+        // swallow errors & return null so callers can detect “no config”
+        return null;
+    }
 }
 
 // src/functions/config_utils/src/config_utils.ts
 let _cachedConfig = null;
-function loadConfig() {
-    return __awaiter(this, arguments, void 0, function* (filePath = null) {
-        var _a, _b;
-        if (_cachedConfig) {
+async function loadConfig(filePath = null) {
+    if (_cachedConfig) {
+        return _cachedConfig;
+    }
+    // 1) figure out where config.json lives
+    let configUrl;
+    if (filePath) {
+        configUrl = filePath;
+    }
+    else if (typeof import.meta !== 'undefined' && typeof import.meta.url === 'string') {
+        // ES module: resolve relative to this file
+        try {
+            const mod = await (new Function("return import('./config.json').catch(() => ({}))"))();
+            _cachedConfig = mod.default ?? {};
             return _cachedConfig;
         }
-        // 1) figure out where config.json lives
-        let configUrl;
-        if (filePath) {
-            configUrl = filePath;
-        }
-        else if (typeof import.meta !== 'undefined' && typeof import.meta.url === 'string') {
-            // ES module: resolve relative to this file
-            try {
-                const mod = yield (new Function("return import('./config.json').catch(() => ({}))"))();
-                _cachedConfig = (_a = mod.default) !== null && _a !== void 0 ? _a : {};
-                return _cachedConfig;
-            }
-            catch (_c) {
-                configUrl = 'config.json';
-            }
+        catch {
+            configUrl = 'config.json';
         }
-        else {
-            // browser fallback
-            const baseURI = safeGlobalProp('document', 'baseURI');
-            try {
-                configUrl =
-                    typeof baseURI === 'string'
-                        ? new URL('config.json', baseURI).href
-                        : 'config.json';
-            }
-            catch (_d) {
-                configUrl = 'config.json';
-            }
+    }
+    else {
+        // browser fallback
+        const baseURI = safeGlobalProp('document', 'baseURI');
+        try {
+            configUrl =
+                typeof baseURI === 'string'
+                    ? new URL('config.json', baseURI).href
+                    : 'config.json';
         }
-        // 2) if we have a fetch, try HTTP(S)
-        const fetchFn = safeGlobalProp('fetch');
-        if (typeof fetchFn === 'function') {
-            try {
-                const res = yield fetchFn(configUrl);
-                if (res.ok) {
-                    const json = yield res.json();
-                    // cache & return
-                    _cachedConfig = (_b = json) !== null && _b !== void 0 ? _b : {};
-                    return _cachedConfig;
-                }
-            }
-            catch (_e) {
-                /* swallow */
-            }
+        catch {
+            configUrl = 'config.json';
         }
-        // 3) Node fallback: try reading from disk (requires your readJsonFile util)
+    }
+    // 2) if we have a fetch, try HTTP(S)
+    const fetchFn = safeGlobalProp('fetch');
+    if (typeof fetchFn === 'function') {
         try {
-            const disk = yield readJsonFile(configUrl);
-            _cachedConfig = disk !== null && disk !== void 0 ? disk : {};
-            return _cachedConfig;
+            const res = await fetchFn(configUrl);
+            if (res.ok) {
+                const json = await res.json();
+                // cache & return
+                _cachedConfig = json ?? {};
+                return _cachedConfig;
+            }
         }
-        catch (_f) {
+        catch {
             /* swallow */
         }
-        // 4) if all else fails, return an empty config
-        _cachedConfig = {};
+    }
+    // 3) Node fallback: try reading from disk (requires your readJsonFile util)
+    try {
+        const disk = await readJsonFile(configUrl);
+        _cachedConfig = disk ?? {};
         return _cachedConfig;
-    });
+    }
+    catch {
+        /* swallow */
+    }
+    // 4) if all else fails, return an empty config
+    _cachedConfig = {};
+    return _cachedConfig;
 }
-function getConfig(key) {
-    return __awaiter(this, void 0, void 0, function* () {
-        const cfg = yield loadConfig();
-        return key != null ? cfg[key] : cfg;
-    });
+async function getConfig(key) {
+    const cfg = await loadConfig();
+    return key != null ? cfg[key] : cfg;
 }
 
 /**
@@ -17772,5 +17125,48 @@ function dataSize(data) {
     return size / 1000; // Convert to kilobytes
 }
 
-export { API_PREFIX, ATTOSECOND, BASE_URL, CENTISECOND, DAY, DAY_IN_S, DECISECOND, DEV_PREFIX, DIST_ALIASES, DIST_FACTORS, DOMAIN_NAME, DistanceConverter, FEET_PER_METER, FEMTOSECOND, HOUR, HOUR_IN_S, KMS_PER_METER, MEDIA_TYPES, METERS_PER_FOOT, METERS_PER_KM, METERS_PER_MILE, MICROSECOND, MILES_PER_METER, MILISECOND, MIME_TYPES, MINUTE, MIN_IN_S, MONTH, MONTH_IN_S, MPerS_TO_MiPerH, MiPerH_TO_MPerS, NANOSECOND, PI, PI2, PICOSECOND, PROD_PREFIX, PROTOCOL, SECOND, SECONDS_PER_DAY, SECONDS_PER_HOUR, SECONDS_PER_MINUTE, SUB_DIR, SpeedConverter, TIME_ALIASES, TIME_FACTORS, TimeConverter, YEAR, YEAR_IN_S, ZEPTOSECOND, alertit, assureArray, assureList, assureNumber, assureString, assure_array, assure_list, assure_number, assure_string, assurearray, assurelist, assurenumber, assurestring, callStorage, callWindowMethod, canonDist, canonTime, capitalize, capitalize_str, checkResponse, cleanArray, cleanText, confirmType, confirm_type, convertBigInts, convertDistance, convertSpeed, convertTime, create_list_string, dataSize, dataSizeInMb, decodeJwt, distanceToMeters, eatAll, eatElse, eatInner, eatOuter, eatall, eatinner, eatouter, emptyObjectToNull, ends_in_quotes, ensureArray, ensureList, ensureNumber, ensureString, ensure_array, ensure_list, ensure_number, ensure_string, ensurearray, ensurelist, ensurenumber, ensurestring, exceedsMbLimit, exponential, extractInsertData, fetchIndexHtml, fetchIndexHtmlContainer, fetchIt, findKeyValue, fmt, formatNumber, fromMeters, fromMps, fromSeconds, geAuthsUtilsDirectory, geBackupsUtilsDirectory, geConstantsUtilsDirectory, geEnvUtilsDirectory, geFetchUtilsDirectory, geFileUtilsDirectory, gePathUtilsDirectory, geStaticDirectory, geStringUtilsDirectory, geTypeUtilsDirectory, get, getAbsDir, getAbsPath, getAllFileTypes, getAllFileTypesSync, getAlphaNum, getAlphas, getBaseDir, getBasename, getBody, getChar, getCleanArray, getComponentsUtilsDirectory, getConfig, getConfigContent, getConfigVar, getDbConfigsPath, getDirname, getDistDir, getDocumentProp, getEnvDir, getEnvPath, getExtname, getFetchVars, getFilename, getFunctionsDir, getFunctionsUtilsDirectory, getHeaders, getHooksUtilsDirectory, getHtmlDirectory, getIfNone, getJsonSizeInMb, getLibUtilsDirectory, getMediaExts, getMediaMap, getMethod, getMimeType, getNums, getPublicDir, getResult, getSafeDocument, getSafeLocalStorage, getSafeWindow, getSchemasDirPath, getSchemasPath, getSplitext, getSrcDir, getSubstring, getWindowHost, getWindowProp, get_all_file_types, get_basename, get_dirname, get_extname, get_filename, get_full_path, get_full_url, get_key_value, get_keyword_string, get_media_exts, get_media_map, get_mime_type, get_relative_path, get_splitext, get_window, get_window_location, get_window_parts, get_window_pathname, getbasename, getdirname, getextname, getfilename, getsplitext, isFiniteNum, isMediaType, isNum, isStrInString, isTimeInterval, isTokenExpired, isType, isZero, is_media_type, loadConfig, loadInnerJson, makePath, make_path, make_sanitized_path, makepath, mergeNotNullValues, metersToDistance, mpsToSpeed, normalizeUrl, omitKeys, parseResult, pathJoin, path_join, path_to_url, pathjoin, processKeywords, readJsonFile, roundPercentage, safeDivide, safeGlobalProp, safeJsonSizeInMb, safeMultiply, safeNums, safeStorage, sanitizeFilename, sanitizeString, secondsToTime, speedToMps, stripPrefixes, stripQuotes, timeToSeconds, toMeters, toSeconds, truncateString, tryEatPrefix, tryParse, urlJoin, url_to_path, urljoin, velocityFromMs, velocityToMs };
+function getLastCaller(skip = ["debugPrint"]) {
+    const stack = new Error().stack;
+    if (!stack)
+        return null;
+    const lines = stack
+        .split("\n")
+        .map(l => l.trim())
+        .slice(1); // drop "Error"
+    for (const line of lines) {
+        // Example:
+        // at processSingleAddress (/path/file.ts:142:7)
+        const match = line.match(/at (.+?) \((.+?):(\d+):(\d+)\)/) ||
+            line.match(/at (.+?):(\d+):(\d+)/);
+        if (!match)
+            continue;
+        const functionName = match[1] ?? "anonymous";
+        if (skip.includes(functionName))
+            continue;
+        return {
+            functionName,
+            file: match[2],
+            line: Number(match[3]),
+            column: Number(match[4]),
+        };
+    }
+    return null;
+}
+
+function debugPrint(value, label = null) {
+    const caller = getLastCaller();
+    const header = label ??
+        (caller
+            ? `${caller.functionName} @ ${caller.file}:${caller.line}`
+            : "object");
+    console.log(`\n🔍 ${header}`);
+    console.log(inspect(value, {
+        depth: null,
+        colors: true,
+        compact: false,
+        maxArrayLength: null,
+    }));
+}
+
+export { API_PREFIX, ATTOSECOND, BASE_URL, CENTISECOND, DAY, DAY_IN_S, DECISECOND, DEV_PREFIX, DIST_ALIASES, DIST_FACTORS, DOMAIN_NAME, DistanceConverter, FEET_PER_METER, FEMTOSECOND, HOUR, HOUR_IN_S, KMS_PER_METER, MEDIA_TYPES, METERS_PER_FOOT, METERS_PER_KM, METERS_PER_MILE, MICROSECOND, MILES_PER_METER, MILISECOND, MIME_TYPES, MINUTE, MIN_IN_S, MONTH, MONTH_IN_S, MPerS_TO_MiPerH, MiPerH_TO_MPerS, NANOSECOND, PI, PI2, PICOSECOND, PROD_PREFIX, PROTOCOL, SECOND, SECONDS_PER_DAY, SECONDS_PER_HOUR, SECONDS_PER_MINUTE, SUB_DIR, SpeedConverter, TIME_ALIASES, TIME_FACTORS, TimeConverter, YEAR, YEAR_IN_S, ZEPTOSECOND, alertit, assureArray, assureList, assureNumber, assureString, assure_array, assure_list, assure_number, assure_string, assurearray, assurelist, assurenumber, assurestring, callStorage, callWindowMethod, canonDist, canonTime, capitalize, capitalize_str, checkResponse, cleanArray, cleanText, confirmType, confirm_type, convertBigInts, convertDistance, convertSpeed, convertTime, create_list_string, dataSize, dataSizeInMb, debugPrint, decodeJwt, distanceToMeters, eatAll, eatElse, eatInner, eatOuter, eatall, eatinner, eatouter, emptyObjectToNull, ends_in_quotes, ensureArray, ensureList, ensureNumber, ensureString, ensure_array, ensure_list, ensure_number, ensure_string, ensurearray, ensurelist, ensurenumber, ensurestring, exceedsMbLimit, exponential, extractInsertData, fetchIndexHtml, fetchIndexHtmlContainer, fetchIt, findKeyValue, fmt, formatNumber, fromMeters, fromMps, fromSeconds, geAuthsUtilsDirectory, geBackupsUtilsDirectory, geConstantsUtilsDirectory, geEnvUtilsDirectory, geFetchUtilsDirectory, geFileUtilsDirectory, gePathUtilsDirectory, geStaticDirectory, geStringUtilsDirectory, geTypeUtilsDirectory, get, getAbsDir, getAbsPath, getAllFileTypes, getAllFileTypesSync, getAlphaNum, getAlphas, getBaseDir, getBasename, getBody, getChar, getCleanArray, getComponentsUtilsDirectory, getConfig, getConfigContent, getDbConfigsPath, getDirname, getDistDir, getDocumentProp, getEnvDir, getEnvPath, getExtname, getFetchVars, getFilename, getFunctionsDir, getFunctionsUtilsDirectory, getHeaders, getHooksUtilsDirectory, getHtmlDirectory, getIfNone, getJsonSizeInMb, getLastCaller, getLibUtilsDirectory, getMediaExts, getMediaMap, getMethod, getMimeType, getNums, getPublicDir, getResult, getSafeDocument, getSafeLocalStorage, getSafeWindow, getSchemasDirPath, getSchemasPath, getSplitext, getSrcDir, getSubstring, getWindowHost, getWindowProp, get_all_file_types, get_basename, get_dirname, get_extname, get_filename, get_full_path, get_full_url, get_key_value, get_keyword_string, get_media_exts, get_media_map, get_mime_type, get_relative_path, get_splitext, get_window, get_window_location, get_window_parts, get_window_pathname, getbasename, getdirname, getextname, getfilename, getsplitext, isFiniteNum, isMediaType, isNum, isStrInString, isTimeInterval, isTokenExpired, isType, isZero, is_media_type, loadConfig, loadInnerJson, makePath, make_path, make_sanitized_path, makepath, mergeNotNullValues, metersToDistance, mpsToSpeed, normalizeUrl, omitKeys, parseResult, pathJoin, path_join, path_to_url, pathjoin, processKeywords, readJsonFile, readJsonFileBrowser, readJsonFileNode, roundPercentage, safeDivide, safeGlobalProp, safeJsonSizeInMb, safeMultiply, safeNums, safeStorage, sanitizeFilename, sanitizeString, secondsToTime, speedToMps, stripPrefixes, stripQuotes, timeToSeconds, toMeters, toSeconds, truncateString, tryEatPrefix, tryParse, urlJoin, url_to_path, urljoin, velocityFromMs, velocityToMs };
 //# sourceMappingURL=index.js.map