@putkoff/abstract-utilities 1.0.4 → 1.0.19

package/dist/esm/index.js

@@ -1,8 +1,4 @@
 export { useCallback, useEffect, useRef, useState } from 'react';
-import path$1 from 'path';
-import * as fs from 'node:fs';
-import * as fsp from 'node:fs/promises';
-import * as path from 'node:path';
 import { jsx, jsxs } from 'react/jsx-runtime';
 
 function getSafeDocument() {
@@ -324,6 +320,25 @@ typeof SuppressedError === "function" ? SuppressedError : function (error, suppr
 };
 
 // src/functions/read_utils/src/read_utils.ts
+let fs = null;
+let path$1 = null;
+function getFsModules() {
+    return __awaiter(this, void 0, void 0, function* () {
+        var _a;
+        if (!fs && !path$1 && 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$1 = (new Function("return require('path')"))();
+            }
+            catch (_b) {
+                fs = null;
+                path$1 = null;
+            }
+        }
+        return { fs, path: path$1 };
+    });
+}
 /**
  * Reads a JSON file, either via Node’s fs (if available)
  * or via window.fetch in the browser. Never throws — returns
@@ -331,37 +346,36 @@ typeof SuppressedError === "function" ? SuppressedError : function (error, suppr
  */
 function readJsonFile(relativeOrAbsolutePath) {
     return __awaiter(this, void 0, void 0, function* () {
-        // 1) Try Node.js fs
-        if (typeof process !== 'undefined' &&
-            process.versions != null &&
-            process.versions.node) {
+        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 = yield import('fs');
-                const path = yield import('path');
-                const filePath = path.isAbsolute(relativeOrAbsolutePath)
-                    ? relativeOrAbsolutePath
-                    : path.resolve(process.cwd(), relativeOrAbsolutePath);
-                const text = yield fs.promises.readFile(filePath, 'utf8');
-                return JSON.parse(text);
+                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 (_a) {
-                // swallow and fall back to browser
+            catch (_b) {
+                // swallow and fall back
             }
         }
         // 2) Try browser fetch
-        const fetchFn = safeGlobalProp('fetch');
-        if (typeof fetchFn !== 'function') {
+        const fetchFn = safeGlobalProp("fetch");
+        if (typeof fetchFn !== "function") {
             return null;
         }
-        // Resolve URL against document.baseURI if possible
         let url = relativeOrAbsolutePath;
-        const baseURI = safeGlobalProp('document', 'baseURI');
+        const baseURI = safeGlobalProp("document", "baseURI");
         if (baseURI) {
             try {
                 url = new URL(relativeOrAbsolutePath, baseURI).href;
             }
-            catch (_b) {
-                // keep url as-is
+            catch (_c) {
+                /* keep url as-is */
             }
         }
         try {
@@ -370,7 +384,7 @@ function readJsonFile(relativeOrAbsolutePath) {
                 return null;
             return (yield res.json());
         }
-        catch (_c) {
+        catch (_d) {
             return null;
         }
     });
@@ -557,87 +571,8 @@ function fetchIndexHtmlContainer(filename_1) {
     });
 }
 
-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 getDefaultExportFromCjs (x) {
+	return x && x.__esModule && Object.prototype.hasOwnProperty.call(x, 'default') ? x['default'] : x;
 }
 
 function assertPath(path) {
@@ -1142,6 +1077,91 @@ posix.posix = posix;
 
 var pathBrowserify = posix;
 
+var path = /*@__PURE__*/getDefaultExportFromCjs(pathBrowserify);
+
+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.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.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 getSubstring(obj, maxLength = null, minLength = null) {
     const objLength = obj.length;
     const effectiveMaxLength = maxLength !== null && maxLength !== void 0 ? maxLength : objLength; // Use nullish coalescing for clarity
@@ -1561,7 +1581,7 @@ function normalizeCategories(categories, opts) {
 }
 function extOf(input) {
     // Behaves like pathlib.Path(...).suffix.lower(): last extension only; lowercased.
-    let ext = path.extname(input || "");
+    let ext = pathBrowserify.extname(input || "");
     if (!ext && input && input.startsWith(".")) {
         // user passed ".jpg" directly
         ext = input;
@@ -1638,7 +1658,7 @@ function getAllFileTypesSync(directory, categories, opts) {
     const base = directory;
     let stat;
     try {
-        stat = fs.statSync(base);
+        stat = undefined(base);
     }
     catch (_a) {
         return [];
@@ -1649,14 +1669,14 @@ function getAllFileTypesSync(directory, categories, opts) {
     const wanted = unionExts(cats);
     const results = [];
     function walkSync(dir) {
-        const entries = fs.readdirSync(dir, { withFileTypes: true });
+        const entries = undefined(dir, { withFileTypes: true });
         for (const ent of entries) {
-            const full = path.join(dir, ent.name);
+            const full = pathBrowserify.join(dir, ent.name);
             if (ent.isDirectory()) {
                 walkSync(full);
             }
             else if (ent.isFile()) {
-                const ext = path.extname(ent.name).toLowerCase();
+                const ext = pathBrowserify.extname(ent.name).toLowerCase();
                 if (wanted.has(ext))
                     results.push(full);
             }
@@ -1673,7 +1693,7 @@ function getAllFileTypes(directory, categories, opts) {
     return __awaiter(this, void 0, void 0, function* () {
         let stat;
         try {
-            stat = yield fsp.stat(directory);
+            stat = yield undefined(directory);
         }
         catch (_a) {
             return [];
@@ -1685,14 +1705,14 @@ function getAllFileTypes(directory, categories, opts) {
         const results = [];
         function walkAsync(dir) {
             return __awaiter(this, void 0, void 0, function* () {
-                const entries = yield fsp.readdir(dir, { withFileTypes: true });
+                const entries = yield undefined(dir, { withFileTypes: true });
                 for (const ent of entries) {
-                    const full = path.join(dir, ent.name);
+                    const full = pathBrowserify.join(dir, ent.name);
                     if (ent.isDirectory()) {
                         yield walkAsync(full);
                     }
                     else if (ent.isFile()) {
-                        const ext = path.extname(ent.name).toLowerCase();
+                        const ext = pathBrowserify.extname(ent.name).toLowerCase();
                         if (wanted.has(ext))
                             results.push(full);
                     }