@putkoff/abstract-utilities 1.0.31 → 1.0.34

package/dist/esm/index.js

@@ -2068,7 +2068,6 @@ function exponential(i, k) {
     return i * (10 ** (k));
 }
 
-// Time
 const SECOND = 1;
 const ZEPTOSECOND = exponential(SECOND, -21);
 const ATTOSECOND = exponential(SECOND, -18);
@@ -2092,66 +2091,147 @@ const SECONDS_PER_DAY = DAY;
 const PI = Math.PI;
 const PI2 = 2 * PI;
 // Distance
-const M_IN_KM = 1000;
-const M_IN_MI = 1609.34;
-const M_IN_FT = 0.3048;
-const KM_IN_M = 1 / M_IN_KM;
-const MI_IN_M = 1 / M_IN_MI;
-const FT_IN_M = 1 / M_IN_FT;
+const METERS_PER_KM = 1000;
+const METERS_PER_MILE = 1609.34;
+const METERS_PER_FOOT = 0.3048;
+const KMS_PER_METER = 1 / METERS_PER_KM;
+const MILES_PER_METER = 1 / METERS_PER_MILE;
+const FEET_PER_METER = 1 / METERS_PER_FOOT;
 const MIN_IN_S = 1 / MINUTE;
 const HOUR_IN_S = 1 / HOUR;
 const DAY_IN_S = 1 / DAY;
 const YEAR_IN_S = 1 / YEAR;
 const MONTH_IN_S = 1 / MONTH;
-const MiPerH_TO_MPerS = M_IN_MI * HOUR_IN_S;
+const MiPerH_TO_MPerS = METERS_PER_MILE * HOUR_IN_S;
 const MPerS_TO_MiPerH = 1 / MiPerH_TO_MPerS;
 
-// Conversion helpers
-const toMeters = (v, unit) => {
-    switch (unit) {
-        case 'km': return v * M_IN_KM;
-        case 'mi': return v * M_IN_MI;
-        case 'ft': return v * M_IN_FT;
-        default: return v; // meters
-    }
+// conversions.ts
+/*───────────────────────────────────────────────────────────────
+  🧭 CANONICAL MAPPINGS
+───────────────────────────────────────────────────────────────*/
+const DIST_ALIASES = {
+    m: "m", meter: "m", meters: "m",
+    km: "km", kms: "km", kilometer: "km", kilometers: "km",
+    mi: "mi", mile: "mi", miles: "mi",
+    ft: "ft", f: "ft", foot: "ft", feet: "ft",
 };
-const toSeconds = (v, unit) => {
-    switch (unit) {
-        case 'min': return v * MINUTE;
-        case 'h': return v * HOUR;
-        case 'day': return v * DAY;
-        default: return v;
-    }
+const TIME_ALIASES = {
+    s: "s", sec: "s", second: "s", seconds: "s",
+    min: "min", m: "min", minute: "min", minutes: "min",
+    h: "h", hr: "h", hour: "h", hours: "h",
+    day: "day", d: "day", days: "day",
 };
-const fromMeters = (d, unit) => {
-    switch (unit) {
-        case 'km': return d / M_IN_KM;
-        case 'mi': return d / M_IN_MI;
-        case 'ft': return d / M_IN_FT;
-        default: return d; // meters
-    }
+const DIST_FACTORS = {
+    m: 1,
+    km: METERS_PER_KM,
+    mi: METERS_PER_MILE,
+    ft: METERS_PER_FOOT,
 };
-const velocityToMs = (value, unit) => {
-    switch (unit) {
-        case 'km/s': return value * M_IN_KM;
-        case 'mph': return value * MiPerH_TO_MPerS; // 1 mph = 0.44704 m/s
-        case 'ft/s': return value * M_IN_FT; // 1 ft/s = 0.3048 m/s
-        default: return value; // m/s
-    }
+const TIME_FACTORS = {
+    s: 1,
+    min: MINUTE,
+    h: HOUR,
+    day: DAY,
 };
-const velocityFromMs = (value, unit) => {
-    switch (unit) {
-        case 'km/s': return value * KM_IN_M;
-        case 'mph': return value * MPerS_TO_MiPerH;
-        case 'ft/s': return value * FT_IN_M;
-        default: return value;
-    }
+/*───────────────────────────────────────────────────────────────
+  🔍 CANONICALIZATION HELPERS
+───────────────────────────────────────────────────────────────*/
+function canonDist(u) {
+    const key = (u !== null && u !== void 0 ? u : "m").toString().toLowerCase();
+    const canon = DIST_ALIASES[key];
+    if (!canon)
+        throw new Error(`Unknown distance unit: ${u}`);
+    return canon;
+}
+function canonTime(u) {
+    const key = (u !== null && u !== void 0 ? u : "s").toString().toLowerCase();
+    const canon = TIME_ALIASES[key];
+    if (!canon)
+        throw new Error(`Unknown time unit: ${u}`);
+    return canon;
+}
+/*───────────────────────────────────────────────────────────────
+  ⚖️ NORMALIZATION HELPERS
+───────────────────────────────────────────────────────────────*/
+function distanceToMeters(d, unit) {
+    const u = canonDist(unit);
+    return safeMultiply(d, DIST_FACTORS[u]);
+}
+function metersToDistance(v, unit) {
+    const u = canonDist(unit);
+    return safeDivide(v, DIST_FACTORS[u]);
+}
+function timeToSeconds(t, unit) {
+    const u = canonTime(unit);
+    return safeMultiply(t, TIME_FACTORS[u]);
+}
+function secondsToTime(v, unit) {
+    const u = canonTime(unit);
+    return safeDivide(v, TIME_FACTORS[u]);
+}
+/*───────────────────────────────────────────────────────────────
+  🚀 SPEED CONVERSIONS (normalize / unnormalize)
+───────────────────────────────────────────────────────────────*/
+function speedToMps(v, distUnit, timeUnit) {
+    const du = canonDist(distUnit);
+    const tu = canonTime(timeUnit);
+    return v * (DIST_FACTORS[du] / TIME_FACTORS[tu]);
+}
+function mpsToSpeed(vMps, distUnit, timeUnit) {
+    const du = canonDist(distUnit);
+    const tu = canonTime(timeUnit);
+    return vMps * (TIME_FACTORS[tu] / DIST_FACTORS[du]);
+}
+/*───────────────────────────────────────────────────────────────
+  🎯 UNIVERSAL CONVERTERS
+───────────────────────────────────────────────────────────────*/
+function convertDistance({ d, fromDist, toDist, vOnly = true, }) {
+    const m = distanceToMeters(d, fromDist);
+    const D = canonDist(toDist !== null && toDist !== void 0 ? toDist : "m");
+    const out = metersToDistance(m, D);
+    return vOnly ? out : { d: out, D };
+}
+function convertTime({ t, fromTime, toTime, vOnly = true, }) {
+    const sec = timeToSeconds(t, fromTime);
+    const T = canonTime(toTime !== null && toTime !== void 0 ? toTime : "s");
+    const out = secondsToTime(sec, T);
+    return vOnly ? out : { t: out, T };
+}
+function convertSpeed({ v, fromDist, fromTime, toDist, toTime, vOnly = true, }) {
+    const mps = speedToMps(v, fromDist, fromTime);
+    const d = canonDist(toDist !== null && toDist !== void 0 ? toDist : "m");
+    const t = canonTime(toTime !== null && toTime !== void 0 ? toTime : "s");
+    const out = mpsToSpeed(mps, d, t);
+    return vOnly ? out : { v: out, d, t };
+}
+const DistanceConverter = {
+    normalize: distanceToMeters,
+    unnormalize: metersToDistance,
+};
+const TimeConverter = {
+    normalize: timeToSeconds,
+    unnormalize: secondsToTime,
 };
-const fromMps = (v, dist_unit, time_unit) => {
-    const dist_conv = toMeters(1, dist_unit);
-    const time_conv = toSeconds(1, time_unit);
-    return v * (time_conv / dist_conv);
+const SpeedConverter = {
+    normalize: (v, [du, tu]) => speedToMps(v, du, tu),
+    unnormalize: (v, [du, tu]) => mpsToSpeed(v, du, tu),
 };
+/*───────────────────────────────────────────────────────────────
+  🧩 COMPATIBILITY WRAPPERS (legacy aliases)
+───────────────────────────────────────────────────────────────*/
+const toMeters = distanceToMeters;
+const fromMeters = metersToDistance;
+const toSeconds = timeToSeconds;
+const fromSeconds = secondsToTime;
+const velocityToMs = (value, unit) => speedToMps(value, unit, "s");
+const velocityFromMs = (value, unit) => mpsToSpeed(value, unit, "s");
+/** Non-canonical helper for arbitrary rate conversion, e.g. ft/day → m/s */
+const fromMps = (v, dist_unit, time_unit) => mpsToSpeed(v, dist_unit, time_unit);
+/*───────────────────────────────────────────────────────────────
+  📊 UTILITIES
+───────────────────────────────────────────────────────────────*/
+const isFiniteNum = (x) => Number.isFinite(x);
+const fmt = (n, digits = 2) => isFiniteNum(n) ? n.toFixed(digits) : "N/A";
 
 function Button(_a) {
     var { children, color = 'gray', variant = 'default', className = '' } = _a, rest = __rest(_a, ["children", "color", "variant", "className"]);
@@ -2296,5 +2376,5 @@ function get_keyword_string(keywords) {
     return allString;
 }
 
-export { API_PREFIX, ATTOSECOND, BASE_URL, Button, CENTISECOND, Checkbox, DAY, DAY_IN_S, DECISECOND, DEV_PREFIX, DOMAIN_NAME, FEMTOSECOND, FT_IN_M, HOUR, HOUR_IN_S, Input, KM_IN_M, MEDIA_TYPES, MICROSECOND, MILISECOND, MIME_TYPES, MINUTE, MIN_IN_S, MI_IN_M, MONTH, MONTH_IN_S, MPerS_TO_MiPerH, M_IN_FT, M_IN_KM, M_IN_MI, MiPerH_TO_MPerS, NANOSECOND, PI, PI2, PICOSECOND, PROD_PREFIX, PROTOCOL, SECOND, SECONDS_PER_DAY, SECONDS_PER_HOUR, SECONDS_PER_MINUTE, SUB_DIR, Spinner, YEAR, YEAR_IN_S, ZEPTOSECOND, alertit, assureArray, assureList, assureNumber, assureString, assure_array, assure_list, assure_number, assure_string, callStorage, callWindowMethod, capitalize, capitalize_str, checkResponse, cleanArray, cleanText, confirmType, confirm_type, create_list_string, currentUsername, currentUsernames, decodeJwt, eatAll, eatEnd, eatInner, eatOuter, ensureArray, ensureList, ensureNumber, ensureString, ensure_array, ensure_list, ensure_number, ensure_string, exponential, fetchIndexHtml, fetchIndexHtmlContainer, fetchIt, formatNumber, fromMeters, fromMps, 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, isLoggedIn, isMediaType, isNum, isStrInString, isTokenExpired, isType, is_media_type, loadConfig, make_path, make_sanitized_path, normalizeUrl, parseResult, path_to_url, processKeywords, readJsonFile, removeToken, requireToken, roundPercentage, safeDivide, safeGlobalProp, safeMultiply, safeNums, safeStorage, sanitizeFilename, stripPrefixes, toMeters, toSeconds, truncateString, tryParse, urlJoin, url_to_path, velocityFromMs, velocityToMs };
+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 };
 //# sourceMappingURL=index.js.map