@putkoff/abstract-utilities 1.0.50 → 1.0.63

package/dist/esm/index.js

@@ -1,6 +1,3 @@
-export { useCallback, useEffect, useRef, useState } from 'react';
-import { jsx, jsxs } from 'react/jsx-runtime';
-
 function _mergeNamespaces(n, m) {
     m.forEach(function (e) {
         e && typeof e !== 'string' && !Array.isArray(e) && Object.keys(e).forEach(function (k) {
@@ -16,167 +13,6 @@ function _mergeNamespaces(n, m) {
     return Object.freeze(n);
 }
 
-function getSafeDocument() {
-    return typeof document !== 'undefined' ? document : undefined;
-}
-function getDocumentProp(...keys) {
-    let obj = getSafeDocument();
-    for (const k of keys) {
-        if (obj == null || typeof obj !== 'object')
-            return undefined;
-        obj = obj[k];
-    }
-    return obj;
-}
-
-/**
- * Safely walk `globalThis` (or window/document) by a chain of property names.
- * Returns `undefined` if any step is missing.
- */
-function safeGlobalProp(...path) {
-    let obj = globalThis;
-    for (const key of path) {
-        if (obj == null || typeof obj !== "object" || !(key in obj)) {
-            return undefined;
-        }
-        obj = obj[key];
-    }
-    return obj;
-}
-
-/**
- * Returns `window` if running in a browser, otherwise `undefined`.
- */
-function getSafeLocalStorage() {
-    if (typeof window === 'undefined')
-        return undefined;
-    try {
-        return window.localStorage;
-    }
-    catch (_a) {
-        return undefined; // e.g. Safari private-mode block
-    }
-}
-/**
- * Call a Storage method by name, silencing any errors or missing storage.
- *
- * @param method  One of the keys of the Storage interface: "getItem", "setItem", etc.
- * @param args    The arguments you’d normally pass to that method.
- * @returns       The method’s return value, or undefined if storage/method isn’t available.
- */
-function callStorage(method, ...args) {
-    const storage = getSafeLocalStorage();
-    if (!storage)
-        return undefined;
-    const fn = storage[method];
-    if (typeof fn !== 'function')
-        return undefined;
-    try {
-        // @ts-ignore – TS can’t infer that this is callable
-        return fn.apply(storage, args);
-    }
-    catch (_a) {
-        return undefined;
-    }
-}
-/**
- * Safely call storage methods (`localStorage` or `sessionStorage`) without blowing up.
- * Returns `undefined` on any error.
- */
-function safeStorage(storageName, method, ...args) {
-    try {
-        const store = safeGlobalProp(storageName);
-        if (!store || typeof store[method] !== "function")
-            return undefined;
-        // @ts-ignore
-        return store[method](...args);
-    }
-    catch (_a) {
-        return undefined;
-    }
-}
-
-/**
- * Returns the global window object if it exists, otherwise undefined.
- */
-function getSafeWindow() {
-    return typeof window !== 'undefined' ? window : undefined;
-}
-/**
- * Safely call a method on window by name.
- *
- * @param method  The Window method to call (e.g. "alert", "open", etc.).
- * @param args    Arguments to pass to that method.
- * @returns       The method’s return value, or undefined if
- *                 window/method isn’t available or throws.
- */
-function callWindowMethod(method, ...args) {
-    const w = getSafeWindow();
-    if (!w)
-        return undefined;
-    const fn = w[method];
-    if (typeof fn !== 'function')
-        return undefined;
-    try {
-        // cast to any so TS doesn’t complain about apply/invoke
-        return fn(...args);
-    }
-    catch (_a) {
-        return undefined;
-    }
-}
-/** implementation */
-function getWindowProp(...keys) {
-    let obj = getSafeWindow();
-    for (const k of keys) {
-        if (obj == null || typeof obj !== 'object')
-            return undefined;
-        obj = obj[k];
-    }
-    return obj;
-}
-function getWindowHost() {
-    return getWindowProp('location', 'host');
-}
-
-/**
-***Changes**:
-*- Updated import path for `InputProps` to `../../types/interfaces`.
-*
-*3. **Token Utilities** (`src/functions/auth/token_utils.ts`):
-*   Copy from `/var/www/abstractendeavors/my-login-app/src/functions/auth_utils/token_utils.ts`.
-*
-*/
-/** Read raw JWT from LocalStorage (or null if absent) */
-function getToken() {
-    return callStorage('getItem', 'token');
-}
-function isLoggedIn() {
-    const tok = getToken();
-    return !!tok && !isTokenExpired(tok !== null && tok !== void 0 ? tok : "");
-}
-/**
- * Add a Bearer Authorization header.
- * A shallow copy of headers is returned so callers can keep chaining.
- */
-function getAuthorizationHeader(headers = {}, token = null) {
-    token = token !== null && token !== void 0 ? token : getToken();
-    headers = headers || {};
-    if (token)
-        headers["Authorization"] = `Bearer ${token}`;
-    return Object.assign({}, headers);
-}
-/** Throw + redirect if there’s no valid token; otherwise return it. */
-function requireToken() {
-    const tok = getToken();
-    if (!tok || isTokenExpired(tok)) {
-        console.warn("→ No token or expired token, redirecting to login…");
-        localStorage.removeItem("token");
-        window.location.href = '/';
-        throw new Error("Redirecting to login…");
-    }
-    return tok;
-}
 /** True if token is structurally bad or its exp ≤ now. */
 function isTokenExpired(token) {
     try {
@@ -187,47 +23,6 @@ function isTokenExpired(token) {
         return true; // treat malformed token as expired
     }
 }
-/** Convenience wrapper: return username from the JWT (or null). */
-function currentUsername() {
-    const tok = getToken();
-    if (!tok)
-        return null;
-    try {
-        const { username } = decodeJwt(tok);
-        return username !== null && username !== void 0 ? username : null;
-    }
-    catch (_a) {
-        return null;
-    }
-}
-function currentUsernames() {
-    var _a;
-    const tok = getToken();
-    if (!tok)
-        return null;
-    try {
-        const parts = tok.split(".");
-        if (parts.length !== 3)
-            return null;
-        let b64 = parts[1].replace(/-/g, "+").replace(/_/g, "/");
-        b64 = b64.padEnd(Math.ceil(b64.length / 4) * 4, "=");
-        const jsonText = atob(b64);
-        const payload = JSON.parse(jsonText);
-        return (_a = payload.username) !== null && _a !== void 0 ? _a : null;
-    }
-    catch (_b) {
-        return null;
-    }
-}
-/** Remove the JWT from LocalStorage */
-function removeToken() {
-    try {
-        callStorage('removeItem', 'token');
-    }
-    catch (err) {
-        console.warn("Failed to remove token:", err);
-    }
-}
 /* ------------------------------------------------------------------ */
 /*  internals                                                         */
 /* ------------------------------------------------------------------ */
@@ -316,18 +111,6 @@ 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) {
@@ -343,100 +126,6 @@ typeof SuppressedError === "function" ? SuppressedError : function (error, suppr
     return e.name = "SuppressedError", e.error = error, e.suppressed = suppressed, e;
 };
 
-// src/functions/read_utils/src/read_utils.ts
-let fs = null;
-let path$2 = null;
-function getFsModules() {
-    return __awaiter(this, void 0, void 0, function* () {
-        var _a;
-        if (!fs && !path$2 && 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$2 = (new Function("return require('path')"))();
-            }
-            catch (_b) {
-                fs = null;
-                path$2 = null;
-            }
-        }
-        return { fs, path: path$2 };
-    });
-}
-/**
- * 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) {
-            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;
-        }
-    });
-}
-// 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;
-    });
-}
-
 /**
  * Unwraps nested { result } fields until you hit a non-object or no more "result" keys.
  */
@@ -461,18 +150,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);
-    // inject auth if missing
-    if (!result.Authorization) {
-        const token = getToken();
-        Object.assign(result, getAuthorizationHeader(result, token));
-    }
-    method = getMethod(method, body);
-    // if it’s a multipart FormData, let the browser set the boundary header
+    // let browser set boundary
     if (body instanceof FormData) {
         return result;
     }
-    // otherwise for POST/PUT/PATCH default to JSON
-    if (['POST', 'PUT', 'PATCH'].includes(method) && !result['Content-Type']) {
+    const upper = method === null || method === void 0 ? void 0 : method.toUpperCase();
+    if (['POST', 'PUT', 'PATCH'].includes(upper !== null && upper !== void 0 ? upper : '') &&
+        !result['Content-Type']) {
         result['Content-Type'] = 'application/json';
     }
     return result;
@@ -542,7 +226,7 @@ function fetchIt(endpoint_1) {
         // 2) choose the URL
         let url = endpoint;
         // 3) prepare headers & body
-        headers = Object.assign(Object.assign(Object.assign({}, (body instanceof FormData ? {} : { "Content-Type": "application/json" })), getAuthorizationHeader()), headers);
+        headers = Object.assign(Object.assign({}, (body instanceof FormData ? {} : { "Content-Type": "application/json" })), headers);
         const opts = {
             method,
             credentials: withCredentials ? "include" : "same-origin",
@@ -1101,11 +785,11 @@ posix.posix = posix;
 
 var pathBrowserify = posix;
 
-var path = /*@__PURE__*/getDefaultExportFromCjs(pathBrowserify);
+var path$1 = /*@__PURE__*/getDefaultExportFromCjs(pathBrowserify);
 
-var path$1 = /*#__PURE__*/_mergeNamespaces({
+var path$2 = /*#__PURE__*/_mergeNamespaces({
     __proto__: null,
-    default: path
+    default: path$1
 }, [pathBrowserify]);
 
 function urlJoin(...parts) {
@@ -1150,7 +834,7 @@ 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.isAbsolute(partial_path)) {
+    if (path$1.isAbsolute(partial_path)) {
         return partial_path;
     }
     return urlJoin(parent_dir, partial_path);
@@ -1165,7 +849,7 @@ function path_to_url(filePath, all_paths) {
     }
     for (const key in all_paths) {
         const mapping = all_paths[key];
-        const normalizedBase = path.normalize(mapping.path);
+        const normalizedBase = path$1.normalize(mapping.path);
         if (filePath.startsWith(normalizedBase)) {
             const relativePath = filePath.substring(normalizedBase.length);
             return urlJoin(mapping.url, relativePath.replace(/\\/g, '/'));
@@ -1190,40 +874,130 @@ function url_to_path(urlStr, all_paths) {
     }
     return null;
 }
+function urljoin(...parts) {
+    return urlJoin(...parts);
+}
+
+function split_outside_brackets(s) {
+    let depth = 0;
+    let start = 0;
+    const out = [];
+    for (let i = 0; i < s.length; i++) {
+        const c = s[i];
+        if (c === "[")
+            depth++;
+        else if (c === "]")
+            depth--;
+        // split only when NOT inside brackets
+        if (c === "," && depth === 0) {
+            out.push(s.slice(start, i));
+            start = i + 1;
+        }
+    }
+    out.push(s.slice(start));
+    return out;
+}
+function parse_nested_list(s) {
+    // strip outer brackets
+    const inner = s.slice(1, -1).trim();
+    const parts = split_outside_brackets(inner);
+    const result = [];
+    for (let p of parts) {
+        p = p.trim();
+        if (p.startsWith("[") && p.endsWith("]")) {
+            // recursively parse nested list
+            result.push(parse_nested_list(p));
+        }
+        else {
+            result.push(p);
+        }
+    }
+    return result;
+}
 
 function ensure_list(obj) {
-    const objArray = Array.isArray(obj) ? obj : [obj];
-    return objArray;
+    if (obj == null)
+        return [];
+    if (Array.isArray(obj)) {
+        return obj.flatMap(item => ensure_list(item));
+    }
+    const s = String(obj).trim();
+    if (s.startsWith("[") && s.endsWith("]")) {
+        return parse_nested_list(s);
+    }
+    return split_outside_brackets(s).map(x => x.trim());
 }
 // coerce any single value into a number (0 if it can't)
 function ensure_number(x) {
     const n = Number(x);
     return isNaN(n) ? 0 : n;
 }
-function ensure_array(input) {
-    if (typeof input === 'string') {
-        return [input];
-    }
-    if (Array.isArray(input)) {
-        return input.map(item => ensure_string(item));
-    }
-    return [];
+function ensure_string(obj) {
+    return String(obj);
+}
+function ensurelist(obj) {
+    return ensure_list(obj);
+}
+function assureList(obj) {
+    return ensure_list(obj);
+}
+function assure_list(obj) {
+    return ensure_list(obj);
+}
+function ensureList(obj) {
+    return ensure_list(obj);
+}
+function assurelist(obj) {
+    return ensure_list(obj);
+}
+function ensurenumber(x) {
+    return ensure_number(x);
+}
+function assureNumber(x) {
+    return ensure_number(x);
+}
+function ensureNumber(x) {
+    return ensure_number(x);
+}
+function assurenumber(x) {
+    return ensure_number(x);
+}
+function assure_number(x) {
+    return ensure_number(x);
+}
+function ensurestring(obj) {
+    return ensure_string(obj);
+}
+function ensureString(obj) {
+    return ensure_string(obj);
+}
+function assureString(obj) {
+    return ensure_string(obj);
+}
+function assurestring(obj) {
+    return ensure_string(obj);
+}
+function assure_string(obj) {
+    return ensure_string(obj);
+}
+function assurearray(obj) {
+    return ensure_list(obj);
+}
+function ensurearray(obj) {
+    return ensure_list(obj);
+}
+function ensure_array(obj) {
+    return ensure_list(obj);
+}
+function ensureArray(obj) {
+    return ensure_list(obj);
+}
+function assure_array(obj) {
+    return ensure_list(obj);
 }
-function ensure_string(obj) {
-    return String(obj);
+function assureArray(obj) {
+    return ensure_list(obj);
 }
-const assureList = ensure_list;
-const assureString = ensure_string;
-const assureNumber = ensure_number;
-const assureArray = ensure_array;
-const assure_list = ensure_list;
-const assure_string = ensure_string;
-const assure_number = ensure_number;
-const assure_array = ensure_array;
-const ensureList = ensure_list;
-const ensureString = ensure_string;
-const ensureNumber = ensure_number;
-const ensureArray = ensure_array;
 
 function cleanText(input) {
     // Replace delimiters with spaces and split
@@ -1582,7 +1356,7 @@ function getMimeType(pathOrExt) {
 }
 function getAllFileTypesSync(directory, categories, opts) {
     // 🧩 Skip entirely if fs isn't available
-    if (!fsp || !path$1)
+    if (!fsp || !path$2)
         return [];
     try {
         const stat = statSync(directory);
@@ -1615,7 +1389,7 @@ function getAllFileTypesSync(directory, categories, opts) {
 function getAllFileTypes(directory, categories, opts) {
     return __awaiter(this, void 0, void 0, function* () {
         // 🧩 Skip entirely if fsp isn't available
-        if (!fsp || !path$1)
+        if (!fsp || !path$2)
             return [];
         try {
             const stat$1 = yield stat(directory);
@@ -1720,71 +1494,80 @@ function stripPrefixes(str, bases = []) {
     }
     return str;
 }
-/**
- * Removes characters from the beginning of the string
- * if they are found in the list of characters.
- *
- * @param str - The input string.
- * @param listObjects - A string or an array of characters to remove.
- * @returns The modified string.
- */
-function eatInner(str, listObjects) {
-    if (!Array.isArray(listObjects)) {
-        listObjects = [listObjects];
+function tryEatPrefix(str, length, ...objs) {
+    str = String(str);
+    objs = ensure_list(objs);
+    const prefix = str.slice(0, length);
+    if (length < 0) {
+        const start = str.length + length;
+        const actualPrefix = str.slice(start);
+        return objs.includes(actualPrefix) ? [str.slice(0, start), true] : [str, false];
+    }
+    if (objs.includes(prefix)) {
+        return [str.slice(length), true];
     }
-    // Ensure str is a string
+    return [str, false];
+}
+/** Python-equivalent eatInner */
+function eatInner(str, listObjects) {
     str = String(str);
-    // Remove characters from the beginning while they are in listObjects
-    while (str.length > 0 && listObjects.includes(str[0])) {
+    const chars = Array.isArray(listObjects) ? listObjects : [listObjects];
+    // Keep removing from left while leftmost char is in the set
+    while (str.length > 0 && chars.includes(str[0])) {
         str = str.slice(1);
     }
     return str;
 }
-/**
- * Removes characters from the end of the string
- * if they are found in the list of characters.
- *
- * @param str - The input string.
- * @param listObjects - A string or an array of characters to remove.
- * @returns The modified string.
- */
+/** Python-equivalent eatOuter */
 function eatOuter(str, listObjects) {
-    if (!Array.isArray(listObjects)) {
-        listObjects = [listObjects];
-    }
-    // Ensure str is a string
     str = String(str);
-    // Remove characters from the end while they are in listObjects
-    while (str.length > 0 && listObjects.includes(str[str.length - 1])) {
+    const chars = Array.isArray(listObjects) ? listObjects : [listObjects];
+    if (!str || chars.length === 0)
+        return str;
+    for (let i = 0; i < str.length; i++) {
+        if (!str)
+            return str;
+        const last = str[str.length - 1];
+        if (!chars.includes(last)) {
+            return str;
+        }
         str = str.slice(0, -1);
     }
     return str;
 }
-/**
- * Removes characters from both the beginning and the end of the string
- * if they are found in the list of characters.
- *
- * @param str - The input string.
- * @param listObjects - A string or an array of characters to remove.
- * @returns The modified string.
- */
+/** Python-equivalent eatAll */
 function eatAll(str, listObjects) {
-    return eatOuter(eatInner(str, listObjects), listObjects);
-}
-function eatEnd(obj, endings = ['/']) {
-    let result = obj;
-    let modified = true;
-    while (modified) {
-        modified = false;
-        for (const ending of endings) {
-            if (result.endsWith(ending)) {
-                result = result.slice(0, -ending.length);
-                modified = true;
-                break;
-            }
+    str = String(str);
+    const chars = Array.isArray(listObjects) ? listObjects : [listObjects];
+    str = eatInner(str, chars);
+    str = eatOuter(str, chars);
+    return str;
+}
+// Plug in the actual version from your project
+function get_alpha_ints(opts) {
+    // REPLACE WITH YOUR REAL IMPLEMENTATION
+    return [];
+}
+/** Python-equivalent eatElse */
+function eatElse(stringObj, chars, ints = true, alpha = true, lower = true, capitalize = true, string = true, listObj = true) {
+    stringObj = String(stringObj);
+    const alphaInts = get_alpha_ints();
+    let ls = ensure_list(chars || []).concat(alphaInts);
+    while (true) {
+        if (!stringObj)
+            return stringObj;
+        const startOk = !ls.includes(stringObj[0]);
+        const endOk = !ls.includes(stringObj[stringObj.length - 1]);
+        const shouldEat = startOk || endOk;
+        if (!shouldEat)
+            return stringObj;
+        if (stringObj && startOk) {
+            stringObj = stringObj.length === 1 ? "" : stringObj.slice(1);
+        }
+        if (stringObj && endOk) {
+            stringObj = stringObj.length === 1 ? "" : stringObj.slice(0, -1);
         }
     }
-    return result;
 }
 function tryParse(obj) {
     try {
@@ -1808,6 +1591,15 @@ function create_list_string(array_obj) {
     }
     return string;
 }
+function eatall(str, listObjects) {
+    return eatAll(str, listObjects);
+}
+function eatinner(str, listObjects) {
+    return eatInner(str, listObjects);
+}
+function eatouter(str, listObjects) {
+    return eatOuter(str, listObjects);
+}
 
 /**
  * In the browser we already have a WHATWG URL constructor on window.
@@ -1842,9 +1634,11 @@ function get_basename(filePath) {
         return '';
     return pathBrowserify.basename(filePath);
 }
-function get_filename(file_path) {
-    const ext = pathBrowserify.extname(file_path);
-    return pathBrowserify.basename(file_path, ext);
+function get_filename(filePath) {
+    if (!filePath)
+        return '';
+    const ext = pathBrowserify.extname(filePath);
+    return pathBrowserify.basename(filePath, ext);
 }
 function get_extname(filePath) {
     if (!filePath)
@@ -1882,32 +1676,36 @@ function get_relative_path(basePath, targetPath) {
     }
 }
 /**
- * Join multiple path segments, normalizing leading/trailing slashes.
+ * Join multiple path segments — clean, predictable, bulletproof.
  *
- * Usage:
- *   make_path('/foo','bar','baz')
- *   make_path(['/foo','bar','baz'])
+ * Accepts ANYTHING that ensure_list can handle:
+ *   • 'a,b,c'
+ *   • ['a', 'b,c']
+ *   • 'a/b/c'
+ *   • '/a/', 'b//c'
+ *   • mixed arrays, comma strings, whatever
+ *
+ * Always returns a clean POSIX path string. Never a list.
  */
-function make_path(...paths) {
-    // If someone passed a single array, unwrap it:
-    const pathArray = (paths.length === 1 && Array.isArray(paths[0])
-        ? paths[0]
-        : paths);
-    let real_path = '';
-    for (let i = 0; i < pathArray.length; i++) {
-        let segment = pathArray[i];
-        if (i === 0) {
-            real_path = segment;
+function make_path(...parts) {
+    // Normalize incoming segments into a flat list
+    const segments = ensure_list(parts).map(x => String(x));
+    let out = "";
+    for (let i = 0; i < segments.length; i++) {
+        const seg = segments[i];
+        // Normalize a segment:
+        let cleaned = eatOuter(seg, "/"); // trim trailing slashes
+        if (!cleaned)
+            continue;
+        if (out === "") {
+            out = cleaned;
         }
         else {
-            // remove any leading slash on this segment
-            segment = segment.replace(/^\/+/, '');
-            // remove any trailing slash on the accumulator
-            real_path = real_path.replace(/\/+$/, '');
-            real_path = `${real_path}/${segment}`;
+            cleaned = eatInner(cleaned, "/"); // trim leading slashes
+            out = `${out}/${cleaned}`;
         }
     }
-    return real_path;
+    return out;
 }
 function sanitizeFilename(filename) {
     return filename
@@ -1921,7 +1719,7 @@ function sanitizeFilename(filename) {
 function make_sanitized_path(...paths) {
     let real_path = '';
     for (let i = 0; i < paths.length; i++) {
-        const sanitized = sanitizeFilename(eatInner(paths[i], ['/']));
+        const sanitized = sanitizeFilename(eatOuter(paths[i], '/'));
         if (i === 0) {
             real_path = sanitized;
         }
@@ -1939,6 +1737,51 @@ function normalizeUrl(base, p) {
     // collapse multiple “//” into one, but keep the “://” after protocol
     return `${cleanBase}/${cleanPath}`.replace(/([^:])\/{2,}/g, '$1/');
 }
+function pathjoin(...parts) {
+    return make_path(...parts);
+}
+function pathJoin(...parts) {
+    return make_path(...parts);
+}
+function makepath(...parts) {
+    return make_path(...parts);
+}
+function makePath(...parts) {
+    return make_path(...parts);
+}
+function path_join(...parts) {
+    return make_path(...parts);
+}
+function getSplitext(filePath) {
+    return get_splitext(filePath);
+}
+function getsplitext(filePath) {
+    return get_splitext(filePath);
+}
+function getextname(filePath) {
+    return get_extname(filePath);
+}
+function getExtname(filePath) {
+    return get_extname(filePath);
+}
+function getfilename(filePath) {
+    return get_filename(filePath);
+}
+function getFilename(filePath) {
+    return get_filename(filePath);
+}
+function getbasename(filePath) {
+    return get_basename(filePath);
+}
+function getBasename(filePath) {
+    return get_basename(filePath);
+}
+function getdirname(filePath) {
+    return get_dirname(filePath);
+}
+function getDirname(filePath) {
+    return get_dirname(filePath);
+}
 
 /**
  * Returns the absolute path of the current file.
@@ -2233,39 +2076,221 @@ const fromMps = (v, dist_unit, time_unit) => mpsToSpeed(v, dist_unit, time_unit)
 const isFiniteNum = (x) => Number.isFinite(x);
 const fmt = (n, digits = 2) => isFiniteNum(n) ? n.toFixed(digits) : "N/A";
 
-function Button(_a) {
-    var { children, color = 'gray', variant = 'default', className = '' } = _a, rest = __rest(_a, ["children", "color", "variant", "className"]);
-    const base = 'rounded px-3 py-1 text-sm font-medium focus:outline-none focus:ring-2 focus:ring-offset-2 transition-colors duration-150';
-    const variantStyles = {
-        default: '',
-        icon: 'p-1 bg-transparent hover:bg-gray-100',
-        primary: 'text-white',
-        secondary: '',
-    };
-    const palette = {
-        gray: variant === 'primary'
-            ? 'bg-gray-600 hover:bg-gray-700 focus:ring-gray-500'
-            : 'bg-gray-200 hover:bg-gray-300 focus:ring-gray-400',
-        green: 'bg-green-600 text-white hover:bg-green-700 focus:ring-green-500',
-        blue: variant === 'primary'
-            ? 'bg-blue-600 hover:bg-blue-700 focus:ring-blue-500'
-            : 'bg-blue-200 hover:bg-blue-300 focus:ring-blue-400',
-    };
-    return (jsx("button", Object.assign({ className: `${base} ${variantStyles[variant]} ${palette[color]} ${className}` }, rest, { children: children })));
+function getSafeDocument() {
+    return typeof document !== 'undefined' ? document : undefined;
+}
+function getDocumentProp(...keys) {
+    let obj = getSafeDocument();
+    for (const k of keys) {
+        if (obj == null || typeof obj !== 'object')
+            return undefined;
+        obj = obj[k];
+    }
+    return obj;
+}
+
+/**
+ * Safely walk `globalThis` (or window/document) by a chain of property names.
+ * Returns `undefined` if any step is missing.
+ */
+function safeGlobalProp(...path) {
+    let obj = globalThis;
+    for (const key of path) {
+        if (obj == null || typeof obj !== "object" || !(key in obj)) {
+            return undefined;
+        }
+        obj = obj[key];
+    }
+    return obj;
 }
 
-function Checkbox(_a) {
-    var { label } = _a, rest = __rest(_a, ["label"]);
-    return (jsxs("label", { className: 'flex items-center gap-2 mb-4', children: [jsx("input", Object.assign({ type: 'checkbox' }, rest)), jsx("span", { children: label })] }));
+/**
+ * Returns `window` if running in a browser, otherwise `undefined`.
+ */
+function getSafeLocalStorage() {
+    if (typeof window === 'undefined')
+        return undefined;
+    try {
+        return window.localStorage;
+    }
+    catch (_a) {
+        return undefined; // e.g. Safari private-mode block
+    }
+}
+/**
+ * Call a Storage method by name, silencing any errors or missing storage.
+ *
+ * @param method  One of the keys of the Storage interface: "getItem", "setItem", etc.
+ * @param args    The arguments you’d normally pass to that method.
+ * @returns       The method’s return value, or undefined if storage/method isn’t available.
+ */
+function callStorage(method, ...args) {
+    const storage = getSafeLocalStorage();
+    if (!storage)
+        return undefined;
+    const fn = storage[method];
+    if (typeof fn !== 'function')
+        return undefined;
+    try {
+        // @ts-ignore – TS can’t infer that this is callable
+        return fn.apply(storage, args);
+    }
+    catch (_a) {
+        return undefined;
+    }
+}
+/**
+ * Safely call storage methods (`localStorage` or `sessionStorage`) without blowing up.
+ * Returns `undefined` on any error.
+ */
+function safeStorage(storageName, method, ...args) {
+    try {
+        const store = safeGlobalProp(storageName);
+        if (!store || typeof store[method] !== "function")
+            return undefined;
+        // @ts-ignore
+        return store[method](...args);
+    }
+    catch (_a) {
+        return undefined;
+    }
 }
 
-function Input(_a) {
-    var { label, trailing } = _a, rest = __rest(_a, ["label", "trailing"]);
-    return (jsxs("label", { className: 'mb-4 block', children: [jsx("span", { className: 'block text-sm font-medium mb-1', children: label }), jsxs("div", { className: 'flex gap-2', children: [jsx("input", Object.assign({ className: 'flex-1 rounded border px-2 py-1 disabled:bg-gray-100' }, rest)), trailing] })] }));
+/**
+ * Returns the global window object if it exists, otherwise undefined.
+ */
+function getSafeWindow() {
+    return typeof window !== 'undefined' ? window : undefined;
+}
+/**
+ * Safely call a method on window by name.
+ *
+ * @param method  The Window method to call (e.g. "alert", "open", etc.).
+ * @param args    Arguments to pass to that method.
+ * @returns       The method’s return value, or undefined if
+ *                 window/method isn’t available or throws.
+ */
+function callWindowMethod(method, ...args) {
+    const w = getSafeWindow();
+    if (!w)
+        return undefined;
+    const fn = w[method];
+    if (typeof fn !== 'function')
+        return undefined;
+    try {
+        // cast to any so TS doesn’t complain about apply/invoke
+        return fn(...args);
+    }
+    catch (_a) {
+        return undefined;
+    }
+}
+/** implementation */
+function getWindowProp(...keys) {
+    let obj = getSafeWindow();
+    for (const k of keys) {
+        if (obj == null || typeof obj !== 'object')
+            return undefined;
+        obj = obj[k];
+    }
+    return obj;
+}
+function getWindowHost() {
+    return getWindowProp('location', 'host');
 }
 
-function Spinner() {
-    return (jsx("p", { className: 'animate-pulse', children: "Loading\u2026" }));
+// 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) {
+            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;
+        }
+    });
+}
+// 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;
+    });
 }
 
 // src/functions/config_utils/src/config_utils.ts
@@ -2376,5 +2401,5 @@ function get_keyword_string(keywords) {
     return allString;
 }
 
-export { API_PREFIX, ATTOSECOND, BASE_URL, Button, CENTISECOND, Checkbox, DAY, DAY_IN_S, DECISECOND, DEV_PREFIX, DIST_ALIASES, DIST_FACTORS, DOMAIN_NAME, DistanceConverter, FEET_PER_METER, FEMTOSECOND, HOUR, HOUR_IN_S, Input, 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, Spinner, TIME_ALIASES, TIME_FACTORS, TimeConverter, YEAR, YEAR_IN_S, ZEPTOSECOND, alertit, assureArray, assureList, assureNumber, assureString, assure_array, assure_list, assure_number, assure_string, callStorage, callWindowMethod, canonDist, canonTime, capitalize, capitalize_str, checkResponse, cleanArray, cleanText, confirmType, confirm_type, convertDistance, convertSpeed, convertTime, create_list_string, currentUsername, currentUsernames, decodeJwt, distanceToMeters, eatAll, eatEnd, eatInner, eatOuter, ensureArray, ensureList, ensureNumber, ensureString, ensure_array, ensure_list, ensure_number, ensure_string, exponential, fetchIndexHtml, fetchIndexHtmlContainer, fetchIt, fmt, formatNumber, fromMeters, fromMps, fromSeconds, geAuthsUtilsDirectory, geBackupsUtilsDirectory, geConstantsUtilsDirectory, geEnvUtilsDirectory, geFetchUtilsDirectory, geFileUtilsDirectory, gePathUtilsDirectory, geStaticDirectory, geStringUtilsDirectory, geTypeUtilsDirectory, get, getAbsDir, getAbsPath, getAllFileTypes, getAllFileTypesSync, getAlphaNum, getAlphas, getAuthorizationHeader, getBaseDir, getBody, getChar, getCleanArray, getComponentsUtilsDirectory, getConfig, getConfigContent, getConfigVar, getDbConfigsPath, getDistDir, getDocumentProp, getEnvDir, getEnvPath, getFetchVars, getFunctionsDir, getFunctionsUtilsDirectory, getHeaders, getHooksUtilsDirectory, getHtmlDirectory, getLibUtilsDirectory, getMediaExts, getMediaMap, getMethod, getMimeType, getNums, getPublicDir, getResult, getSafeDocument, getSafeLocalStorage, getSafeWindow, getSchemasDirPath, getSchemasPath, getSrcDir, getSubstring, getToken, 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, isFiniteNum, isLoggedIn, isMediaType, isNum, isStrInString, isTokenExpired, isType, is_media_type, loadConfig, make_path, make_sanitized_path, metersToDistance, mpsToSpeed, normalizeUrl, parseResult, path_to_url, processKeywords, readJsonFile, removeToken, requireToken, roundPercentage, safeDivide, safeGlobalProp, safeMultiply, safeNums, safeStorage, sanitizeFilename, secondsToTime, speedToMps, stripPrefixes, timeToSeconds, toMeters, toSeconds, truncateString, tryParse, urlJoin, url_to_path, velocityFromMs, velocityToMs };
+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, convertDistance, convertSpeed, convertTime, create_list_string, decodeJwt, distanceToMeters, eatAll, eatElse, eatInner, eatOuter, eatall, eatinner, eatouter, ensureArray, ensureList, ensureNumber, ensureString, ensure_array, ensure_list, ensure_number, ensure_string, ensurearray, ensurelist, ensurenumber, ensurestring, exponential, fetchIndexHtml, fetchIndexHtmlContainer, fetchIt, 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, 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, isTokenExpired, isType, is_media_type, loadConfig, makePath, make_path, make_sanitized_path, makepath, metersToDistance, mpsToSpeed, normalizeUrl, parseResult, pathJoin, path_join, path_to_url, pathjoin, processKeywords, readJsonFile, roundPercentage, safeDivide, safeGlobalProp, safeMultiply, safeNums, safeStorage, sanitizeFilename, secondsToTime, speedToMps, stripPrefixes, timeToSeconds, toMeters, toSeconds, truncateString, tryEatPrefix, tryParse, urlJoin, url_to_path, urljoin, velocityFromMs, velocityToMs };
 //# sourceMappingURL=index.js.map