@putkoff/abstract-utilities 1.0.102 → 1.0.113

package/dist/types/functions/env_utils/src/window_utils.js

@@ -0,0 +1,47 @@
+import { BASE_URL, DEV_PREFIX } from './../imports';
+export function get_window() {
+    try {
+        if (typeof window !== 'undefined') {
+            return window;
+        }
+    }
+    catch (err) {
+        alert(err);
+    }
+    return null;
+}
+export function get_window_location() {
+    try {
+        const Window = get_window();
+        if (!Window) {
+            return BASE_URL;
+        }
+        return Window.location;
+    }
+    catch (err) {
+        alert(err);
+    }
+    return null;
+}
+export function get_window_pathname() {
+    try {
+        const Window = get_window();
+        if (!Window) {
+            return DEV_PREFIX;
+        }
+        return Window.location.pathname;
+    }
+    catch (err) {
+        alert(err);
+    }
+    return null;
+}
+export function get_window_parts() {
+    try {
+        return get_window_location();
+    }
+    catch (err) {
+        alert(err);
+    }
+    return null;
+}

package/dist/types/functions/fetch_utils/imports.d.ts

@@ -1,2 +1,2 @@
-export { readJsonFile, getConfigContent } from './../read_utils';
-export type { LogoutButtonProps, FetchVariables, UrlKey } from './../../types';
+export { readJsonFile, getConfigContent } from './../read_utils/index.js';
+export type { LogoutButtonProps, FetchVariables, UrlKey } from './../../types/index.js';

package/dist/types/functions/fetch_utils/imports.js

@@ -0,0 +1 @@
+export { readJsonFile, getConfigContent } from './../read_utils';

package/dist/types/functions/fetch_utils/index.d.ts

@@ -1 +1 @@
-export * from './src';
+export * from './src/index.js';

package/dist/types/functions/fetch_utils/index.js

@@ -0,0 +1 @@
+export * from './src';

package/dist/types/functions/fetch_utils/src/fetch_utils.js

@@ -0,0 +1,70 @@
+var __awaiter = (this && this.__awaiter) || function (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());
+    });
+};
+import { getResult } from './utils';
+export 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();
+        // 1) auto-detect absolute URLs
+        const isAbsolute = typeof endpoint === "string" && /^https?:\/\//i.test(endpoint);
+        // 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;
+    });
+}
+// Constructs HTML directory path
+export function getHtmlDirectory(directory, filename) {
+    return `${directory}/${filename}.html`;
+}
+// Fetches HTML content
+export 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();
+    });
+}
+// Fetches and injects HTML content into container
+export 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;
+        }
+        else {
+            console.warn(`⚠️ No container found for: #${container}`);
+        }
+    });
+}

package/dist/types/functions/fetch_utils/src/index.d.ts

@@ -1,3 +1,3 @@
-export * from './fetch_utils';
-export * from './utils';
-export * from './url_utils';
+export * from './fetch_utils.js';
+export * from './utils.js';
+export * from './url_utils.js';

package/dist/types/functions/fetch_utils/src/index.js

@@ -0,0 +1,3 @@
+export * from './fetch_utils';
+export * from './utils';
+export * from './url_utils';

package/dist/types/functions/fetch_utils/src/url_utils.js

@@ -0,0 +1,86 @@
+import path from 'path';
+export 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.
+ */
+export 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.
+ */
+export 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.
+ */
+export 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.
+ */
+export 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;
+}
+export function urljoin(...parts) {
+    return urlJoin(...parts);
+}

package/dist/types/functions/fetch_utils/src/utils.d.ts

@@ -1,4 +1,4 @@
-import { FetchVariables } from './../imports';
+import { FetchVariables } from './../imports.js';
 /**
  * Unwraps nested { result } fields until you hit a non-object or no more "result" keys.
  */

package/dist/types/functions/fetch_utils/src/utils.js

@@ -0,0 +1,102 @@
+var __awaiter = (this && this.__awaiter) || function (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());
+    });
+};
+/**
+ * Unwraps nested { result } fields until you hit a non-object or no more "result" keys.
+ */
+export function getResult(obj) {
+    let current = obj;
+    while (current &&
+        typeof current === "object" &&
+        Object.prototype.hasOwnProperty.call(current, "result")) {
+        current = current.result;
+    }
+    return current;
+}
+// Determines HTTP method, defaults to GET or POST based on body
+export function getMethod(method = null, body = null) {
+    const validMethods = ['GET', 'POST', 'PUT', 'PATCH', 'PULL'];
+    method = (method || '').toUpperCase();
+    if (!validMethods.includes(method)) {
+        method = body ? 'POST' : 'GET';
+    }
+    return method;
+}
+// Gets headers, skips JSON headers when body is FormData
+export function getHeaders(headers = {}, method = null, body = null) {
+    const result = Object.assign({}, 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 : '') &&
+        !result['Content-Type']) {
+        result['Content-Type'] = 'application/json';
+    }
+    return result;
+}
+// Prepares request body, serializes to JSON for non-GET requests
+export function getBody(body = null, method = null) {
+    method = getMethod(method, body);
+    if (method === 'GET') {
+        return undefined;
+    }
+    if (body) {
+        try {
+            return JSON.stringify(body);
+        }
+        catch (err) {
+            return body;
+        }
+    }
+    return undefined;
+}
+// Prepares fetch variables, passes FormData intact
+export function getFetchVars(headers = null, method = null, body = null) {
+    method = getMethod(method, body);
+    headers = getHeaders(headers || {}, method, body);
+    // only JSON-stringify non-FormData bodies
+    if (!(body instanceof FormData)) {
+        body = getBody(body, method);
+    }
+    return { method, headers, body };
+}
+/*
+ * parseResult no longer needs to worry about JSON vs HTML redirect errors;
+ * all 401/403 have already been handled above.
+ */
+export 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();
+    });
+}
+/**
+ * Intercept 401/403 and force a clean redirect to login
+ * without ever showing an alert.
+ */
+export function checkResponse(res) {
+    if (res.status === 401 || res.status === 403) {
+        // 1) clear out the stale token
+        localStorage.removeItem("token");
+        // 2) replace history so "back" doesn’t re-trigger the protected route
+        window.history.replaceState({}, "", "/secure-files");
+        // 3) short-circuit all further fetch logic
+        throw new Error("SessionExpired");
+    }
+    return res;
+}

package/dist/types/functions/index.d.ts

@@ -1,17 +1,17 @@
-export * from './auth_utils';
-export * from './constants_utils';
-export * from './env_utils';
-export * from './fetch_utils';
-export * from './path_utils';
-export * from './rndm_utils';
-export * from './string_utils';
-export * from './math_utils';
-export * from './type_utils';
-export * from './config_utils';
-export * from './read_utils';
-export * from './safe_utils';
-export * from './read_utils';
-export * from './variable_utils';
-export * from './size_utils';
-export * from './print_utils';
-export * from './inspect_utils';
+export * from './auth_utils/index.js';
+export * from './constants_utils/index.js';
+export * from './env_utils/index.js';
+export * from './fetch_utils/index.js';
+export * from './path_utils/index.js';
+export * from './rndm_utils/index.js';
+export * from './string_utils/index.js';
+export * from './math_utils/index.js';
+export * from './type_utils/index.js';
+export * from './config_utils/index.js';
+export * from './read_utils/index.js';
+export * from './safe_utils/index.js';
+export * from './read_utils/index.js';
+export * from './variable_utils/index.js';
+export * from './size_utils/index.js';
+export * from './print_utils/index.js';
+export * from './inspect_utils/index.js';

package/dist/types/functions/index.js

@@ -0,0 +1,17 @@
+export * from './auth_utils';
+export * from './constants_utils';
+export * from './env_utils';
+export * from './fetch_utils';
+export * from './path_utils';
+export * from './rndm_utils';
+export * from './string_utils';
+export * from './math_utils';
+export * from './type_utils';
+export * from './config_utils';
+export * from './read_utils';
+export * from './safe_utils';
+export * from './read_utils';
+export * from './variable_utils';
+export * from './size_utils';
+export * from './print_utils';
+export * from './inspect_utils';

package/dist/types/functions/inspect_utils/imports.js

@@ -0,0 +1 @@
+export { inspect } from "util";

package/dist/types/functions/inspect_utils/index.d.ts

@@ -1,2 +1,2 @@
-export * from './src';
-export * from './imports';
+export * from './src/index.js';
+export * from './imports.js';

package/dist/types/functions/inspect_utils/index.js

@@ -0,0 +1,2 @@
+export * from './src';
+export * from './imports';

package/dist/types/functions/inspect_utils/src/caller_utils.js

@@ -0,0 +1,28 @@
+export function getLastCaller(skip = ["debugPrint"]) {
+    var _a;
+    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 = (_a = match[1]) !== null && _a !== void 0 ? _a : "anonymous";
+        if (skip.includes(functionName))
+            continue;
+        return {
+            functionName,
+            file: match[2],
+            line: Number(match[3]),
+            column: Number(match[4]),
+        };
+    }
+    return null;
+}

package/dist/types/functions/inspect_utils/src/index.d.ts

@@ -1 +1 @@
-export * from './caller_utils';
+export * from './caller_utils.js';

package/dist/types/functions/inspect_utils/src/index.js

@@ -0,0 +1 @@
+export * from './caller_utils';

package/dist/types/functions/math_utils/bigint_utils.js

@@ -0,0 +1,36 @@
+// src/functions/typeUtils/numUtils.ts
+import { getLogString } from '@putkoff/abstract-logger';
+const FILE_LOCATION = 'src/functions/typeUtils/numUtils.ts';
+/**
+ * Recursively traverse the object and convert BigInts to numbers or strings.
+ *
+ * @param {object|array} obj - The object to traverse
+ * @param {boolean} convertToNumber - Whether to convert BigInt to Number (default is true)
+ * @returns {object|array} - The transformed object
+ */
+export function convertBigInts(obj, convertToNumber = true) {
+    if (obj === null || obj === undefined)
+        return obj;
+    try {
+        if (typeof obj === 'bigint') {
+            return convertToNumber ? Number(obj) : obj.toString();
+        }
+        if (typeof obj === 'object') {
+            if (Array.isArray(obj)) {
+                return obj.map((item) => convertBigInts(item, convertToNumber));
+            }
+            return Object.fromEntries(Object.entries(obj).map(([key, value]) => [key, convertBigInts(value, convertToNumber)]));
+        }
+    }
+    catch (error) {
+        getLogString({
+            message: 'Error converting BigInt',
+            logType: 'warn',
+            details: error.message,
+            function_name: 'convertBigInts',
+            file_location: FILE_LOCATION
+        });
+        return obj;
+    }
+    return obj;
+}

package/dist/types/functions/math_utils/constants.js

@@ -0,0 +1,37 @@
+import { exponential } from './safe_math';
+export const SECOND = 1;
+export const ZEPTOSECOND = exponential(SECOND, -21);
+export const ATTOSECOND = exponential(SECOND, -18);
+export const FEMTOSECOND = exponential(SECOND, -15);
+export const PICOSECOND = exponential(SECOND, -12);
+export const NANOSECOND = exponential(SECOND, -9);
+export const MICROSECOND = exponential(SECOND, -6);
+export const MILISECOND = exponential(SECOND, -3);
+export const CENTISECOND = exponential(SECOND, -2);
+export const DECISECOND = exponential(SECOND, -1);
+export const MINUTE = 60 * SECOND;
+export const HOUR = 60 * MINUTE;
+export const DAY = 24 * HOUR;
+export const YEAR = 365 * DAY;
+export const MONTH = YEAR / 12;
+// Derived: explicit names
+export const SECONDS_PER_MINUTE = MINUTE;
+export const SECONDS_PER_HOUR = HOUR;
+export const SECONDS_PER_DAY = DAY;
+//math
+export const PI = Math.PI;
+export const PI2 = 2 * PI;
+// Distance
+export const METERS_PER_KM = 1000;
+export const METERS_PER_MILE = 1609.34;
+export const METERS_PER_FOOT = 0.3048;
+export const KMS_PER_METER = 1 / METERS_PER_KM;
+export const MILES_PER_METER = 1 / METERS_PER_MILE;
+export const FEET_PER_METER = 1 / METERS_PER_FOOT;
+export const MIN_IN_S = 1 / MINUTE;
+export const HOUR_IN_S = 1 / HOUR;
+export const DAY_IN_S = 1 / DAY;
+export const YEAR_IN_S = 1 / YEAR;
+export const MONTH_IN_S = 1 / MONTH;
+export const MiPerH_TO_MPerS = METERS_PER_MILE * HOUR_IN_S;
+export const MPerS_TO_MiPerH = 1 / MiPerH_TO_MPerS;

package/dist/types/functions/math_utils/conversions.d.ts

@@ -1,4 +1,4 @@
-import type { CanonTime, CanonDist, DistanceUnit, TimeUnit, ConvertDistance, ConvertTime, ConvertSpeed, OutDist, OutTimeType, OutSpeedType } from './scaleInterfaces';
+import type { CanonTime, CanonDist, DistanceUnit, TimeUnit, ConvertDistance, ConvertTime, ConvertSpeed, OutDist, OutTimeType, OutSpeedType } from './scaleInterfaces.js';
 export declare const DIST_ALIASES: Record<string, CanonDist>;
 export declare const TIME_ALIASES: Record<string, CanonTime>;
 export declare const DIST_FACTORS: Record<CanonDist, number>;

package/dist/types/functions/math_utils/conversions.js

@@ -0,0 +1,129 @@
+// conversions.ts
+import { METERS_PER_KM, METERS_PER_MILE, METERS_PER_FOOT, MINUTE, HOUR, DAY, } from "./constants";
+import { safeMultiply, safeDivide } from "./safe_math";
+/*───────────────────────────────────────────────────────────────
+  🧭 CANONICAL MAPPINGS
+───────────────────────────────────────────────────────────────*/
+export 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",
+};
+export 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",
+};
+export const DIST_FACTORS = {
+    m: 1,
+    km: METERS_PER_KM,
+    mi: METERS_PER_MILE,
+    ft: METERS_PER_FOOT,
+};
+export const TIME_FACTORS = {
+    s: 1,
+    min: MINUTE,
+    h: HOUR,
+    day: DAY,
+};
+/*───────────────────────────────────────────────────────────────
+  🔍 CANONICALIZATION HELPERS
+───────────────────────────────────────────────────────────────*/
+export 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;
+}
+export 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
+───────────────────────────────────────────────────────────────*/
+export function distanceToMeters(d, unit) {
+    const u = canonDist(unit);
+    return safeMultiply(d, DIST_FACTORS[u]);
+}
+export function metersToDistance(v, unit) {
+    const u = canonDist(unit);
+    return safeDivide(v, DIST_FACTORS[u]);
+}
+export function timeToSeconds(t, unit) {
+    const u = canonTime(unit);
+    return safeMultiply(t, TIME_FACTORS[u]);
+}
+export function secondsToTime(v, unit) {
+    const u = canonTime(unit);
+    return safeDivide(v, TIME_FACTORS[u]);
+}
+/*───────────────────────────────────────────────────────────────
+  🚀 SPEED CONVERSIONS (normalize / unnormalize)
+───────────────────────────────────────────────────────────────*/
+export function speedToMps(v, distUnit, timeUnit) {
+    const du = canonDist(distUnit);
+    const tu = canonTime(timeUnit);
+    return v * (DIST_FACTORS[du] / TIME_FACTORS[tu]);
+}
+export function mpsToSpeed(vMps, distUnit, timeUnit) {
+    const du = canonDist(distUnit);
+    const tu = canonTime(timeUnit);
+    return vMps * (TIME_FACTORS[tu] / DIST_FACTORS[du]);
+}
+/*───────────────────────────────────────────────────────────────
+  🎯 UNIVERSAL CONVERTERS
+───────────────────────────────────────────────────────────────*/
+export 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 };
+}
+export 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 };
+}
+export 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 };
+}
+export const DistanceConverter = {
+    normalize: distanceToMeters,
+    unnormalize: metersToDistance,
+};
+export const TimeConverter = {
+    normalize: timeToSeconds,
+    unnormalize: secondsToTime,
+};
+export const SpeedConverter = {
+    normalize: (v, [du, tu]) => speedToMps(v, du, tu),
+    unnormalize: (v, [du, tu]) => mpsToSpeed(v, du, tu),
+};
+/*───────────────────────────────────────────────────────────────
+  🧩 COMPATIBILITY WRAPPERS (legacy aliases)
+───────────────────────────────────────────────────────────────*/
+export const toMeters = distanceToMeters;
+export const fromMeters = metersToDistance;
+export const toSeconds = timeToSeconds;
+export const fromSeconds = secondsToTime;
+export const velocityToMs = (value, unit) => speedToMps(value, unit, "s");
+export const velocityFromMs = (value, unit) => mpsToSpeed(value, unit, "s");
+/** Non-canonical helper for arbitrary rate conversion, e.g. ft/day → m/s */
+export const fromMps = (v, dist_unit, time_unit) => mpsToSpeed(v, dist_unit, time_unit);
+/*───────────────────────────────────────────────────────────────
+  📊 UTILITIES
+───────────────────────────────────────────────────────────────*/
+export const isFiniteNum = (x) => Number.isFinite(x);
+export const fmt = (n, digits = 2) => isFiniteNum(n) ? n.toFixed(digits) : "N/A";