@putkoff/abstract-utilities 1.0.47 → 1.0.52

package/dist/cjs/index.js

@@ -690,6 +690,9 @@ function url_to_path(urlStr, all_paths) {
     }
     return null;
 }
+function urljoin(...parts) {
+    return urlJoin(...parts);
+}
 
 function assertPath(path) {
   if (typeof path !== 'string') {
@@ -1193,39 +1196,126 @@ posix.posix = posix;
 
 var pathBrowserify = posix;
 
+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);
 }
-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 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 assureArray(obj) {
+    return ensure_list(obj);
+}
 
 function cleanText(input) {
     // Replace delimiters with spaces and split
@@ -1692,71 +1782,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];
     }
-    // Ensure str is a string
+    if (objs.includes(prefix)) {
+        return [str.slice(length), true];
+    }
+    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 {
@@ -1780,6 +1879,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.
@@ -1814,9 +1922,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)
@@ -1854,32 +1964,36 @@ function get_relative_path(basePath, targetPath) {
     }
 }
 /**
- * Join multiple path segments, normalizing leading/trailing slashes.
+ * Join multiple path segments — clean, predictable, bulletproof.
+ *
+ * Accepts ANYTHING that ensure_list can handle:
+ *   • 'a,b,c'
+ *   • ['a', 'b,c']
+ *   • 'a/b/c'
+ *   • '/a/', 'b//c'
+ *   • mixed arrays, comma strings, whatever
  *
- * Usage:
- *   make_path('/foo','bar','baz')
- *   make_path(['/foo','bar','baz'])
+ * 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
@@ -1893,7 +2007,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;
         }
@@ -1911,6 +2025,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.
@@ -2426,6 +2585,10 @@ exports.assure_array = assure_array;
 exports.assure_list = assure_list;
 exports.assure_number = assure_number;
 exports.assure_string = assure_string;
+exports.assurearray = assurearray;
+exports.assurelist = assurelist;
+exports.assurenumber = assurenumber;
+exports.assurestring = assurestring;
 exports.callStorage = callStorage;
 exports.callWindowMethod = callWindowMethod;
 exports.canonDist = canonDist;
@@ -2446,9 +2609,12 @@ exports.currentUsernames = currentUsernames;
 exports.decodeJwt = decodeJwt;
 exports.distanceToMeters = distanceToMeters;
 exports.eatAll = eatAll;
-exports.eatEnd = eatEnd;
+exports.eatElse = eatElse;
 exports.eatInner = eatInner;
 exports.eatOuter = eatOuter;
+exports.eatall = eatall;
+exports.eatinner = eatinner;
+exports.eatouter = eatouter;
 exports.ensureArray = ensureArray;
 exports.ensureList = ensureList;
 exports.ensureNumber = ensureNumber;
@@ -2457,6 +2623,10 @@ exports.ensure_array = ensure_array;
 exports.ensure_list = ensure_list;
 exports.ensure_number = ensure_number;
 exports.ensure_string = ensure_string;
+exports.ensurearray = ensurearray;
+exports.ensurelist = ensurelist;
+exports.ensurenumber = ensurenumber;
+exports.ensurestring = ensurestring;
 exports.exponential = exponential;
 exports.fetchIndexHtml = fetchIndexHtml;
 exports.fetchIndexHtmlContainer = fetchIndexHtmlContainer;
@@ -2485,6 +2655,7 @@ exports.getAlphaNum = getAlphaNum;
 exports.getAlphas = getAlphas;
 exports.getAuthorizationHeader = getAuthorizationHeader;
 exports.getBaseDir = getBaseDir;
+exports.getBasename = getBasename;
 exports.getBody = getBody;
 exports.getChar = getChar;
 exports.getCleanArray = getCleanArray;
@@ -2493,11 +2664,14 @@ exports.getConfig = getConfig;
 exports.getConfigContent = getConfigContent;
 exports.getConfigVar = getConfigVar;
 exports.getDbConfigsPath = getDbConfigsPath;
+exports.getDirname = getDirname;
 exports.getDistDir = getDistDir;
 exports.getDocumentProp = getDocumentProp;
 exports.getEnvDir = getEnvDir;
 exports.getEnvPath = getEnvPath;
+exports.getExtname = getExtname;
 exports.getFetchVars = getFetchVars;
+exports.getFilename = getFilename;
 exports.getFunctionsDir = getFunctionsDir;
 exports.getFunctionsUtilsDirectory = getFunctionsUtilsDirectory;
 exports.getHeaders = getHeaders;
@@ -2516,6 +2690,7 @@ exports.getSafeLocalStorage = getSafeLocalStorage;
 exports.getSafeWindow = getSafeWindow;
 exports.getSchemasDirPath = getSchemasDirPath;
 exports.getSchemasPath = getSchemasPath;
+exports.getSplitext = getSplitext;
 exports.getSrcDir = getSrcDir;
 exports.getSubstring = getSubstring;
 exports.getToken = getToken;
@@ -2539,6 +2714,11 @@ exports.get_window = get_window;
 exports.get_window_location = get_window_location;
 exports.get_window_parts = get_window_parts;
 exports.get_window_pathname = get_window_pathname;
+exports.getbasename = getbasename;
+exports.getdirname = getdirname;
+exports.getextname = getextname;
+exports.getfilename = getfilename;
+exports.getsplitext = getsplitext;
 exports.isFiniteNum = isFiniteNum;
 exports.isLoggedIn = isLoggedIn;
 exports.isMediaType = isMediaType;
@@ -2548,13 +2728,18 @@ exports.isTokenExpired = isTokenExpired;
 exports.isType = isType;
 exports.is_media_type = is_media_type;
 exports.loadConfig = loadConfig;
+exports.makePath = makePath;
 exports.make_path = make_path;
 exports.make_sanitized_path = make_sanitized_path;
+exports.makepath = makepath;
 exports.metersToDistance = metersToDistance;
 exports.mpsToSpeed = mpsToSpeed;
 exports.normalizeUrl = normalizeUrl;
 exports.parseResult = parseResult;
+exports.pathJoin = pathJoin;
+exports.path_join = path_join;
 exports.path_to_url = path_to_url;
+exports.pathjoin = pathjoin;
 exports.processKeywords = processKeywords;
 exports.readJsonFile = readJsonFile;
 exports.removeToken = removeToken;
@@ -2573,9 +2758,11 @@ exports.timeToSeconds = timeToSeconds;
 exports.toMeters = toMeters;
 exports.toSeconds = toSeconds;
 exports.truncateString = truncateString;
+exports.tryEatPrefix = tryEatPrefix;
 exports.tryParse = tryParse;
 exports.urlJoin = urlJoin;
 exports.url_to_path = url_to_path;
+exports.urljoin = urljoin;
 exports.velocityFromMs = velocityFromMs;
 exports.velocityToMs = velocityToMs;
 //# sourceMappingURL=index.js.map