@choksheak/ts-utils 0.3.4 → 0.3.5

package/localStore.mjs

@@ -35,201 +35,203 @@ function validateStoredObject(obj) {
   }
   return obj;
 }
-var LocalStore = class {
-  constructor(storeName, options) {
-    this.storeName = storeName;
-    this.keyPrefix = storeName + ":";
-    this.defaultExpiryMs = options?.defaultExpiryMs ? durationOrMsToMs(options.defaultExpiryMs) : LocalStoreConfig.expiryMs;
-    this.gcIntervalMs = options?.gcIntervalMs ? durationOrMsToMs(options.gcIntervalMs) : LocalStoreConfig.gcIntervalMs;
-    this.gcMsStorageKey = `__localStore:lastGcMs:${storeName}`;
-  }
-  /**
-   * The prefix string for the local storage key which identifies items
-   * belonging to this namespace.
-   */
-  keyPrefix;
-  /** Local storage key name for the last GC completed timestamp. */
-  gcMsStorageKey;
-  defaultExpiryMs;
-  gcIntervalMs;
-  /** Set a value in the store. */
-  set(key, value, expiryDeltaMs = this.defaultExpiryMs) {
-    const nowMs = Date.now();
-    const obj = {
-      value,
-      storedMs: nowMs,
-      expiryMs: nowMs + durationOrMsToMs(expiryDeltaMs)
-    };
-    localStorage.setItem(this.keyPrefix + key, JSON.stringify(obj));
-    this.gc();
-    return value;
-  }
-  /** Delete one or multiple keys. */
-  delete(key) {
-    if (typeof key === "string") {
-      localStorage.removeItem(this.keyPrefix + key);
-    } else {
-      for (const k of key) {
-        localStorage.removeItem(this.keyPrefix + k);
+function createLocalStore(storeName, options) {
+  const keyPrefix = storeName + ":";
+  const defaultExpiryMs = options?.defaultExpiryMs ? durationOrMsToMs(options.defaultExpiryMs) : LocalStoreConfig.expiryMs;
+  const gcIntervalMs = options?.gcIntervalMs ? durationOrMsToMs(options.gcIntervalMs) : LocalStoreConfig.gcIntervalMs;
+  const gcMsStorageKey = `__localStore:lastGcMs:${storeName}`;
+  const obj = {
+    /** Input name for the store. */
+    storeName,
+    /**
+     * The prefix string for the local storage key which identifies items
+     * belonging to this namespace.
+     */
+    keyPrefix,
+    /** Default expiry to use if not specified in set(). */
+    defaultExpiryMs,
+    /** Time interval for when GC's occur. */
+    gcIntervalMs,
+    /** Local storage key name for the last GC completed timestamp. */
+    gcMsStorageKey,
+    /** Set a value in the store. */
+    set(key, value, expiryDeltaMs) {
+      const nowMs = Date.now();
+      const stored = {
+        value,
+        storedMs: nowMs,
+        expiryMs: nowMs + durationOrMsToMs(expiryDeltaMs ?? defaultExpiryMs)
+      };
+      localStorage.setItem(keyPrefix + key, JSON.stringify(stored));
+      obj.gc();
+      return value;
+    },
+    /** Delete one or multiple keys. */
+    delete(key) {
+      if (typeof key === "string") {
+        localStorage.removeItem(keyPrefix + key);
+      } else {
+        for (const k of key) {
+          localStorage.removeItem(keyPrefix + k);
+        }
       }
-    }
-  }
-  /** Mainly used to get the expiration timestamp of an object. */
-  getStoredObject(key) {
-    const k = this.keyPrefix + key;
-    const stored = localStorage.getItem(k);
-    if (!stored) {
-      return void 0;
-    }
-    try {
-      const parsed = JSON.parse(stored);
-      const obj = validateStoredObject(parsed);
-      if (!obj) {
-        this.delete(k);
-        this.gc();
+    },
+    /** Mainly used to get the expiration timestamp of an object. */
+    getStoredObject(key) {
+      const k = keyPrefix + key;
+      const stored = localStorage.getItem(k);
+      if (!stored) {
         return void 0;
       }
-      return obj;
-    } catch (e) {
-      console.error(`Invalid local value: ${k}=${stored}:`, e);
-      this.delete(k);
-      this.gc();
-      return void 0;
-    }
-  }
-  /** Get a value by key, or undefined if it does not exist. */
-  get(key) {
-    const obj = this.getStoredObject(key);
-    return obj?.value;
-  }
-  /** Generic way to iterate through all entries. */
-  forEach(callback) {
-    for (const k of Object.keys(localStorage)) {
-      if (!k.startsWith(this.keyPrefix)) continue;
-      const key = k.slice(this.keyPrefix.length);
-      const obj = this.getStoredObject(key);
-      if (!obj) continue;
-      callback(key, obj.value, obj.expiryMs, obj.storedMs);
-    }
-  }
-  /**
-   * Returns the number of items in the store. Note that getting the size
-   * requires iterating through the entire store because the items could expire
-   * at any time, and hence the size is a dynamic number.
-   */
-  size() {
-    let count = 0;
-    this.forEach(() => {
-      count++;
-    });
-    return count;
-  }
-  /** Remove all items from the store. */
-  clear() {
-    for (const key of Object.keys(localStorage)) {
-      if (key.startsWith(this.keyPrefix)) {
-        localStorage.removeItem(key);
+      try {
+        const parsed = JSON.parse(stored);
+        const valid = validateStoredObject(parsed);
+        if (!valid) {
+          obj.delete(k);
+          obj.gc();
+          return void 0;
+        }
+        return valid;
+      } catch (e) {
+        console.error(`Invalid local value: ${k}=${stored}:`, e);
+        obj.delete(k);
+        obj.gc();
+        return void 0;
       }
-    }
-  }
-  /**
-   * Returns all items as map of key to value, mainly used for debugging dumps.
-   * The type T is applied to all values, even though they might not be of type
-   * T (in the case when you store different data types in the same store).
-   */
-  asMap() {
-    const map = /* @__PURE__ */ new Map();
-    this.forEach((key, value, expiryMs, storedMs) => {
-      map.set(key, { value, expiryMs, storedMs });
-    });
-    return map;
-  }
-  /** Returns the ms timestamp for the last GC (garbage collection). */
-  get lastGcMs() {
-    const lastGcMsStr = globalThis.localStorage.getItem(this.gcMsStorageKey);
-    if (!lastGcMsStr) return 0;
-    const ms = Number(lastGcMsStr);
-    return isNaN(ms) ? 0 : ms;
-  }
-  /** Set the ms timestamp for the last GC (garbage collection). */
-  set lastGcMs(ms) {
-    globalThis.localStorage.setItem(this.gcMsStorageKey, String(ms));
-  }
-  /** Perform garbage-collection if due, else do nothing. */
-  gc() {
-    const lastGcMs = this.lastGcMs;
-    if (!lastGcMs) {
-      this.lastGcMs = Date.now();
-      return;
-    }
-    if (Date.now() < lastGcMs + this.gcIntervalMs) {
-      return;
-    }
-    this.gcNow();
-  }
-  /**
-   * Perform garbage collection immediately without checking whether we are
-   * due for the next GC or not.
-   */
-  gcNow() {
-    console.log(`Starting localStore GC on ${this.storeName}`);
-    this.lastGcMs = Date.now();
-    let count = 0;
-    this.forEach((key, value, expiryMs) => {
-      if (Date.now() >= expiryMs) {
-        this.delete(key);
+    },
+    /** Get a value by key, or undefined if it does not exist. */
+    get(key) {
+      const stored = obj.getStoredObject(key);
+      return stored?.value;
+    },
+    /** Generic way to iterate through all entries. */
+    forEach(callback) {
+      for (const k of Object.keys(localStorage)) {
+        if (!k.startsWith(keyPrefix)) continue;
+        const key = k.slice(keyPrefix.length);
+        const stored = obj.getStoredObject(key);
+        if (!stored) continue;
+        callback(key, stored.value, stored.expiryMs, stored.storedMs);
+      }
+    },
+    /**
+     * Returns the number of items in the store. Note that getting the size
+     * requires iterating through the entire store because the items could expire
+     * at any time, and hence the size is a dynamic number.
+     */
+    size() {
+      let count = 0;
+      obj.forEach(() => {
         count++;
+      });
+      return count;
+    },
+    /** Remove all items from the store. */
+    clear() {
+      for (const key of Object.keys(localStorage)) {
+        if (key.startsWith(keyPrefix)) {
+          localStorage.removeItem(key);
+        }
       }
-    });
-    console.log(
-      `Finished localStore GC on ${this.storeName} - deleted ${count} keys`
-    );
-    this.lastGcMs = Date.now();
-  }
-  /** Returns `this` casted into a StorageAdapter<T>. */
-  asStorageAdapter() {
-    return this;
-  }
-};
-var localStore = new LocalStore(LocalStoreConfig.storeName);
-var LocalStoreItem = class {
-  constructor(key, defaultExpiryMs = LocalStoreConfig.expiryMs, store = localStore) {
-    this.key = key;
-    this.store = store;
-    this.defaultExpiryMs = defaultExpiryMs && durationOrMsToMs(defaultExpiryMs);
-  }
-  defaultExpiryMs;
-  /** Set a value in the store. */
-  set(value, expiryDeltaMs = this.defaultExpiryMs) {
-    this.store.set(this.key, value, expiryDeltaMs);
-  }
-  /**
-   * Example usage:
-   *
-   *   const { value, storedMs, expiryMs, storedMs } =
-   *     await myLocalItem.getStoredObject();
-   */
-  getStoredObject() {
-    return this.store.getStoredObject(this.key);
-  }
-  /** Get a value by key, or undefined if it does not exist. */
-  get() {
-    return this.store.get(this.key);
-  }
-  /** Delete this key from the store. */
-  delete() {
-    this.store.delete(this.key);
-  }
-};
+    },
+    /**
+     * Returns all items as map of key to value, mainly used for debugging dumps.
+     * The type T is applied to all values, even though they might not be of type
+     * T (in the case when you store different data types in the same store).
+     */
+    asMap() {
+      const map = /* @__PURE__ */ new Map();
+      obj.forEach(
+        (key, value, expiryMs, storedMs) => {
+          map.set(key, { value, expiryMs, storedMs });
+        }
+      );
+      return map;
+    },
+    /** Returns the ms timestamp for the last GC (garbage collection). */
+    getLastGcMs() {
+      const lastGcMsStr = localStorage.getItem(gcMsStorageKey);
+      if (!lastGcMsStr) return 0;
+      const ms = Number(lastGcMsStr);
+      return isNaN(ms) ? 0 : ms;
+    },
+    /** Set the ms timestamp for the last GC (garbage collection). */
+    setLastGcMs(ms) {
+      localStorage.setItem(gcMsStorageKey, String(ms));
+    },
+    /** Perform garbage-collection if due, else do nothing. */
+    gc() {
+      const lastGcMs = obj.getLastGcMs();
+      if (!lastGcMs) {
+        obj.setLastGcMs(Date.now());
+        return;
+      }
+      if (Date.now() < lastGcMs + gcIntervalMs) {
+        return;
+      }
+      obj.gcNow();
+    },
+    /**
+     * Perform garbage collection immediately without checking whether we are
+     * due for the next GC or not.
+     */
+    gcNow() {
+      console.log(`Starting localStore GC on ${storeName}`);
+      obj.setLastGcMs(Date.now());
+      let count = 0;
+      obj.forEach((key, value, expiryMs) => {
+        if (Date.now() >= expiryMs) {
+          obj.delete(key);
+          count++;
+        }
+      });
+      console.log(
+        `Finished localStore GC on ${storeName} - deleted ${count} keys`
+      );
+      obj.setLastGcMs(Date.now());
+    },
+    /** Returns `this` casted into a StorageAdapter<T>. */
+    asStorageAdapter() {
+      return obj;
+    }
+  };
+  return obj;
+}
+var localStore = createLocalStore(LocalStoreConfig.storeName);
 function localStoreItem(key, expiryMs, store = localStore) {
-  expiryMs = expiryMs && durationOrMsToMs(expiryMs);
-  return new LocalStoreItem(key, expiryMs, store);
+  const defaultExpiryMs = expiryMs && durationOrMsToMs(expiryMs);
+  const obj = {
+    key,
+    defaultExpiryMs,
+    store,
+    /** Set a value in the store. */
+    set(value, expiryDeltaMs) {
+      store.set(key, value, expiryDeltaMs ?? defaultExpiryMs);
+    },
+    /**
+     * Example usage:
+     *
+     *   const { value, storedMs, expiryMs, storedMs } =
+     *     await myLocalItem.getStoredObject();
+     */
+    getStoredObject() {
+      return store.getStoredObject(key);
+    },
+    /** Get a value by key, or undefined if it does not exist. */
+    get() {
+      return store.get(key);
+    },
+    /** Delete this key from the store. */
+    delete() {
+      store.delete(key);
+    }
+  };
+  return obj;
 }
 export {
-  LocalStore,
   LocalStoreConfig,
-  LocalStoreItem,
   configureLocalStore,
+  createLocalStore,
   localStore,
   localStoreItem
 };

package/mean.cjs

@@ -25,15 +25,15 @@ __export(mean_exports, {
 module.exports = __toCommonJS(mean_exports);
 
 // src/asNumber.ts
-function asNumber(u) {
+function asNumber(u, defaultValue = 0) {
   if (typeof u === "number") {
-    return isFinite(u) ? u : 0;
+    return isFinite(u) ? u : defaultValue;
   }
   u = Number(u);
   if (typeof u === "number" && isFinite(u)) {
     return u;
   }
-  return 0;
+  return defaultValue;
 }
 
 // src/sum.ts

package/mean.min.cjs

@@ -1,2 +1,2 @@
-"use strict";var o=Object.defineProperty;var f=Object.getOwnPropertyDescriptor;var b=Object.getOwnPropertyNames;var p=Object.prototype.hasOwnProperty;var c=(n,r)=>{for(var e in r)o(n,e,{get:r[e],enumerable:!0})},k=(n,r,e,u)=>{if(r&&typeof r=="object"||typeof r=="function")for(let t of b(r))!p.call(n,t)&&t!==e&&o(n,t,{get:()=>r[t],enumerable:!(u=f(r,t))||u.enumerable});return n};var s=n=>k(o({},"__esModule",{value:!0}),n);var a={};c(a,{mean:()=>w});module.exports=s(a);function m(n){return typeof n=="number"?isFinite(n)?n:0:(n=Number(n),typeof n=="number"&&isFinite(n)?n:0)}function i(n){return n.reduce((r,e)=>r+m(e),0)}function w(n){return n.length>0?i(n)/n.length:0}0&&(module.exports={mean});
+"use strict";var o=Object.defineProperty;var f=Object.getOwnPropertyDescriptor;var b=Object.getOwnPropertyNames;var p=Object.prototype.hasOwnProperty;var c=(n,r)=>{for(var e in r)o(n,e,{get:r[e],enumerable:!0})},k=(n,r,e,m)=>{if(r&&typeof r=="object"||typeof r=="function")for(let t of b(r))!p.call(n,t)&&t!==e&&o(n,t,{get:()=>r[t],enumerable:!(m=f(r,t))||m.enumerable});return n};var s=n=>k(o({},"__esModule",{value:!0}),n);var x={};c(x,{mean:()=>w});module.exports=s(x);function u(n,r=0){return typeof n=="number"?isFinite(n)?n:r:(n=Number(n),typeof n=="number"&&isFinite(n)?n:r)}function i(n){return n.reduce((r,e)=>r+u(e),0)}function w(n){return n.length>0?i(n)/n.length:0}0&&(module.exports={mean});
 //# sourceMappingURL=mean.min.cjs.map

package/mean.min.cjs.map

@@ -1 +1 @@
-{"version":3,"sources":["../src/mean.ts","../src/asNumber.ts","../src/sum.ts"],"sourcesContent":["import { sum } from \"./sum\";\n\n/**\n * Compute the mean (average) of all the numbers in the given array.\n * Non-numbers will be coerced into numbers if possible.\n */\nexport function mean(numbers: unknown[]): number {\n  return numbers.length > 0 ? sum(numbers) / numbers.length : 0;\n}\n","/**\n * Coerce `u` into a number if possible, otherwise just return 0.\n */\nexport function asNumber(u: unknown): number {\n  // If u is a valid number, return it.\n  if (typeof u === \"number\") {\n    return isFinite(u) ? u : 0;\n  }\n\n  // Try to make into a number if not already a number.\n  u = Number(u);\n\n  // If u is a valid number, return it.\n  if (typeof u === \"number\" && isFinite(u)) {\n    return u;\n  }\n\n  // Return 0 for everything else. This is usually ok if want to just ignore\n  // all other noise.\n  return 0;\n}\n","import { asNumber } from \"./asNumber\";\n\n/**\n * Add all the numbers together in the given array.\n * Non-numbers will be coerced into numbers if possible.\n */\nexport function sum(numbers: unknown[]): number {\n  return numbers.reduce((accumulated: number, current: unknown) => {\n    return accumulated + asNumber(current);\n  }, 0);\n}\n"],"mappings":"yaAAA,IAAAA,EAAA,GAAAC,EAAAD,EAAA,UAAAE,IAAA,eAAAC,EAAAH,GCGO,SAASI,EAASC,EAAoB,CAE3C,OAAI,OAAOA,GAAM,SACR,SAASA,CAAC,EAAIA,EAAI,GAI3BA,EAAI,OAAOA,CAAC,EAGR,OAAOA,GAAM,UAAY,SAASA,CAAC,EAC9BA,EAKF,EACT,CCdO,SAASC,EAAIC,EAA4B,CAC9C,OAAOA,EAAQ,OAAO,CAACC,EAAqBC,IACnCD,EAAcE,EAASD,CAAO,EACpC,CAAC,CACN,CFJO,SAASE,EAAKC,EAA4B,CAC/C,OAAOA,EAAQ,OAAS,EAAIC,EAAID,CAAO,EAAIA,EAAQ,OAAS,CAC9D","names":["mean_exports","__export","mean","__toCommonJS","asNumber","u","sum","numbers","accumulated","current","asNumber","mean","numbers","sum"]}
+{"version":3,"sources":["../src/mean.ts","../src/asNumber.ts","../src/sum.ts"],"sourcesContent":["import { sum } from \"./sum\";\n\n/**\n * Compute the mean (average) of all the numbers in the given array.\n * Non-numbers will be coerced into numbers if possible.\n */\nexport function mean(numbers: unknown[]): number {\n  return numbers.length > 0 ? sum(numbers) / numbers.length : 0;\n}\n","/**\n * Coerce `u` into a number if possible, otherwise just return 0.\n */\nexport function asNumber(u: unknown, defaultValue = 0): number {\n  // If u is a valid number, return it.\n  if (typeof u === \"number\") {\n    return isFinite(u) ? u : defaultValue;\n  }\n\n  // Try to make into a number if not already a number.\n  u = Number(u);\n\n  // If u is a valid number, return it.\n  if (typeof u === \"number\" && isFinite(u)) {\n    return u;\n  }\n\n  // Return `defaultValue` for everything else. This is usually ok if want to\n  // just ignore all other noise.\n  return defaultValue;\n}\n","import { asNumber } from \"./asNumber\";\n\n/**\n * Add all the numbers together in the given array.\n * Non-numbers will be coerced into numbers if possible.\n */\nexport function sum(numbers: unknown[]): number {\n  return numbers.reduce((accumulated: number, current: unknown) => {\n    return accumulated + asNumber(current);\n  }, 0);\n}\n"],"mappings":"yaAAA,IAAAA,EAAA,GAAAC,EAAAD,EAAA,UAAAE,IAAA,eAAAC,EAAAH,GCGO,SAASI,EAASC,EAAYC,EAAe,EAAW,CAE7D,OAAI,OAAOD,GAAM,SACR,SAASA,CAAC,EAAIA,EAAIC,GAI3BD,EAAI,OAAOA,CAAC,EAGR,OAAOA,GAAM,UAAY,SAASA,CAAC,EAC9BA,EAKFC,EACT,CCdO,SAASC,EAAIC,EAA4B,CAC9C,OAAOA,EAAQ,OAAO,CAACC,EAAqBC,IACnCD,EAAcE,EAASD,CAAO,EACpC,CAAC,CACN,CFJO,SAASE,EAAKC,EAA4B,CAC/C,OAAOA,EAAQ,OAAS,EAAIC,EAAID,CAAO,EAAIA,EAAQ,OAAS,CAC9D","names":["mean_exports","__export","mean","__toCommonJS","asNumber","u","defaultValue","sum","numbers","accumulated","current","asNumber","mean","numbers","sum"]}

package/mean.min.mjs

@@ -1,2 +1,2 @@
-function r(n){return typeof n=="number"?isFinite(n)?n:0:(n=Number(n),typeof n=="number"&&isFinite(n)?n:0)}function e(n){return n.reduce((t,o)=>t+r(o),0)}function b(n){return n.length>0?e(n)/n.length:0}export{b as mean};
+function e(n,r=0){return typeof n=="number"?isFinite(n)?n:r:(n=Number(n),typeof n=="number"&&isFinite(n)?n:r)}function t(n){return n.reduce((r,o)=>r+e(o),0)}function b(n){return n.length>0?t(n)/n.length:0}export{b as mean};
 //# sourceMappingURL=mean.min.mjs.map

package/mean.min.mjs.map

@@ -1 +1 @@
-{"version":3,"sources":["../src/asNumber.ts","../src/sum.ts","../src/mean.ts"],"sourcesContent":["/**\n * Coerce `u` into a number if possible, otherwise just return 0.\n */\nexport function asNumber(u: unknown): number {\n  // If u is a valid number, return it.\n  if (typeof u === \"number\") {\n    return isFinite(u) ? u : 0;\n  }\n\n  // Try to make into a number if not already a number.\n  u = Number(u);\n\n  // If u is a valid number, return it.\n  if (typeof u === \"number\" && isFinite(u)) {\n    return u;\n  }\n\n  // Return 0 for everything else. This is usually ok if want to just ignore\n  // all other noise.\n  return 0;\n}\n","import { asNumber } from \"./asNumber\";\n\n/**\n * Add all the numbers together in the given array.\n * Non-numbers will be coerced into numbers if possible.\n */\nexport function sum(numbers: unknown[]): number {\n  return numbers.reduce((accumulated: number, current: unknown) => {\n    return accumulated + asNumber(current);\n  }, 0);\n}\n","import { sum } from \"./sum\";\n\n/**\n * Compute the mean (average) of all the numbers in the given array.\n * Non-numbers will be coerced into numbers if possible.\n */\nexport function mean(numbers: unknown[]): number {\n  return numbers.length > 0 ? sum(numbers) / numbers.length : 0;\n}\n"],"mappings":"AAGO,SAASA,EAASC,EAAoB,CAE3C,OAAI,OAAOA,GAAM,SACR,SAASA,CAAC,EAAIA,EAAI,GAI3BA,EAAI,OAAOA,CAAC,EAGR,OAAOA,GAAM,UAAY,SAASA,CAAC,EAC9BA,EAKF,EACT,CCdO,SAASC,EAAIC,EAA4B,CAC9C,OAAOA,EAAQ,OAAO,CAACC,EAAqBC,IACnCD,EAAcE,EAASD,CAAO,EACpC,CAAC,CACN,CCJO,SAASE,EAAKC,EAA4B,CAC/C,OAAOA,EAAQ,OAAS,EAAIC,EAAID,CAAO,EAAIA,EAAQ,OAAS,CAC9D","names":["asNumber","u","sum","numbers","accumulated","current","asNumber","mean","numbers","sum"]}
+{"version":3,"sources":["../src/asNumber.ts","../src/sum.ts","../src/mean.ts"],"sourcesContent":["/**\n * Coerce `u` into a number if possible, otherwise just return 0.\n */\nexport function asNumber(u: unknown, defaultValue = 0): number {\n  // If u is a valid number, return it.\n  if (typeof u === \"number\") {\n    return isFinite(u) ? u : defaultValue;\n  }\n\n  // Try to make into a number if not already a number.\n  u = Number(u);\n\n  // If u is a valid number, return it.\n  if (typeof u === \"number\" && isFinite(u)) {\n    return u;\n  }\n\n  // Return `defaultValue` for everything else. This is usually ok if want to\n  // just ignore all other noise.\n  return defaultValue;\n}\n","import { asNumber } from \"./asNumber\";\n\n/**\n * Add all the numbers together in the given array.\n * Non-numbers will be coerced into numbers if possible.\n */\nexport function sum(numbers: unknown[]): number {\n  return numbers.reduce((accumulated: number, current: unknown) => {\n    return accumulated + asNumber(current);\n  }, 0);\n}\n","import { sum } from \"./sum\";\n\n/**\n * Compute the mean (average) of all the numbers in the given array.\n * Non-numbers will be coerced into numbers if possible.\n */\nexport function mean(numbers: unknown[]): number {\n  return numbers.length > 0 ? sum(numbers) / numbers.length : 0;\n}\n"],"mappings":"AAGO,SAASA,EAASC,EAAYC,EAAe,EAAW,CAE7D,OAAI,OAAOD,GAAM,SACR,SAASA,CAAC,EAAIA,EAAIC,GAI3BD,EAAI,OAAOA,CAAC,EAGR,OAAOA,GAAM,UAAY,SAASA,CAAC,EAC9BA,EAKFC,EACT,CCdO,SAASC,EAAIC,EAA4B,CAC9C,OAAOA,EAAQ,OAAO,CAACC,EAAqBC,IACnCD,EAAcE,EAASD,CAAO,EACpC,CAAC,CACN,CCJO,SAASE,EAAKC,EAA4B,CAC/C,OAAOA,EAAQ,OAAS,EAAIC,EAAID,CAAO,EAAIA,EAAQ,OAAS,CAC9D","names":["asNumber","u","defaultValue","sum","numbers","accumulated","current","asNumber","mean","numbers","sum"]}

package/mean.mjs

@@ -1,13 +1,13 @@
 // src/asNumber.ts
-function asNumber(u) {
+function asNumber(u, defaultValue = 0) {
   if (typeof u === "number") {
-    return isFinite(u) ? u : 0;
+    return isFinite(u) ? u : defaultValue;
   }
   u = Number(u);
   if (typeof u === "number" && isFinite(u)) {
     return u;
   }
-  return 0;
+  return defaultValue;
 }
 
 // src/sum.ts

package/median.cjs

@@ -25,15 +25,15 @@ __export(median_exports, {
 module.exports = __toCommonJS(median_exports);
 
 // src/asNumber.ts
-function asNumber(u) {
+function asNumber(u, defaultValue = 0) {
   if (typeof u === "number") {
-    return isFinite(u) ? u : 0;
+    return isFinite(u) ? u : defaultValue;
   }
   u = Number(u);
   if (typeof u === "number" && isFinite(u)) {
     return u;
   }
-  return 0;
+  return defaultValue;
 }
 
 // src/median.ts
@@ -41,7 +41,7 @@ function median(numbers) {
   if (numbers.length === 0) {
     return 0;
   }
-  const sorted = numbers.map(asNumber).slice().sort();
+  const sorted = numbers.map(asNumber).slice().sort((a, b) => a - b);
   const middleIndex = Math.floor(sorted.length / 2);
   if (sorted.length % 2 === 1) {
     return sorted[middleIndex];

package/median.min.cjs

@@ -1,2 +1,2 @@
-"use strict";var i=Object.defineProperty;var u=Object.getOwnPropertyDescriptor;var f=Object.getOwnPropertyNames;var s=Object.prototype.hasOwnProperty;var l=(n,e)=>{for(var r in e)i(n,r,{get:e[r],enumerable:!0})},a=(n,e,r,o)=>{if(e&&typeof e=="object"||typeof e=="function")for(let t of f(e))!s.call(n,t)&&t!==r&&i(n,t,{get:()=>e[t],enumerable:!(o=u(e,t))||o.enumerable});return n};var c=n=>a(i({},"__esModule",{value:!0}),n);var p={};l(p,{median:()=>b});module.exports=c(p);function m(n){return typeof n=="number"?isFinite(n)?n:0:(n=Number(n),typeof n=="number"&&isFinite(n)?n:0)}function b(n){if(n.length===0)return 0;let e=n.map(m).slice().sort(),r=Math.floor(e.length/2);if(e.length%2===1)return e[r];let o=e[r-1],t=e[r];return(o+t)/2}0&&(module.exports={median});
+"use strict";var i=Object.defineProperty;var u=Object.getOwnPropertyDescriptor;var c=Object.getOwnPropertyNames;var b=Object.prototype.hasOwnProperty;var l=(n,e)=>{for(var r in e)i(n,r,{get:e[r],enumerable:!0})},p=(n,e,r,o)=>{if(e&&typeof e=="object"||typeof e=="function")for(let t of c(e))!b.call(n,t)&&t!==r&&i(n,t,{get:()=>e[t],enumerable:!(o=u(e,t))||o.enumerable});return n};var a=n=>p(i({},"__esModule",{value:!0}),n);var h={};l(h,{median:()=>d});module.exports=a(h);function m(n,e=0){return typeof n=="number"?isFinite(n)?n:e:(n=Number(n),typeof n=="number"&&isFinite(n)?n:e)}function d(n){if(n.length===0)return 0;let e=n.map(m).slice().sort((s,f)=>s-f),r=Math.floor(e.length/2);if(e.length%2===1)return e[r];let o=e[r-1],t=e[r];return(o+t)/2}0&&(module.exports={median});
 //# sourceMappingURL=median.min.cjs.map

package/median.min.cjs.map

@@ -1 +1 @@
-{"version":3,"sources":["../src/median.ts","../src/asNumber.ts"],"sourcesContent":["import { asNumber } from \"./asNumber\";\n\n/**\n * Compute the median (middle number) of all the numbers in the given array.\n * Non-numbers will be coerced into numbers if possible.\n */\nexport function median(numbers: unknown[]): number {\n  if (numbers.length === 0) {\n    return 0;\n  }\n\n  // Create a copy with slice() to avoid mutating the original array.\n  const sorted = numbers.map(asNumber).slice().sort();\n\n  const middleIndex = Math.floor(sorted.length / 2);\n\n  // Is odd length -> return middle number.\n  if (sorted.length % 2 === 1) {\n    return sorted[middleIndex];\n  }\n\n  // Is even length -> return mean of middle 2 numbers.\n  const value1 = sorted[middleIndex - 1];\n  const value2 = sorted[middleIndex];\n  return (value1 + value2) / 2;\n}\n","/**\n * Coerce `u` into a number if possible, otherwise just return 0.\n */\nexport function asNumber(u: unknown): number {\n  // If u is a valid number, return it.\n  if (typeof u === \"number\") {\n    return isFinite(u) ? u : 0;\n  }\n\n  // Try to make into a number if not already a number.\n  u = Number(u);\n\n  // If u is a valid number, return it.\n  if (typeof u === \"number\" && isFinite(u)) {\n    return u;\n  }\n\n  // Return 0 for everything else. This is usually ok if want to just ignore\n  // all other noise.\n  return 0;\n}\n"],"mappings":"yaAAA,IAAAA,EAAA,GAAAC,EAAAD,EAAA,YAAAE,IAAA,eAAAC,EAAAH,GCGO,SAASI,EAASC,EAAoB,CAE3C,OAAI,OAAOA,GAAM,SACR,SAASA,CAAC,EAAIA,EAAI,GAI3BA,EAAI,OAAOA,CAAC,EAGR,OAAOA,GAAM,UAAY,SAASA,CAAC,EAC9BA,EAKF,EACT,CDdO,SAASC,EAAOC,EAA4B,CACjD,GAAIA,EAAQ,SAAW,EACrB,MAAO,GAIT,IAAMC,EAASD,EAAQ,IAAIE,CAAQ,EAAE,MAAM,EAAE,KAAK,EAE5CC,EAAc,KAAK,MAAMF,EAAO,OAAS,CAAC,EAGhD,GAAIA,EAAO,OAAS,IAAM,EACxB,OAAOA,EAAOE,CAAW,EAI3B,IAAMC,EAASH,EAAOE,EAAc,CAAC,EAC/BE,EAASJ,EAAOE,CAAW,EACjC,OAAQC,EAASC,GAAU,CAC7B","names":["median_exports","__export","median","__toCommonJS","asNumber","u","median","numbers","sorted","asNumber","middleIndex","value1","value2"]}
+{"version":3,"sources":["../src/median.ts","../src/asNumber.ts"],"sourcesContent":["import { asNumber } from \"./asNumber\";\n\n/**\n * Compute the median (middle number) of all the numbers in the given array.\n * Non-numbers will be coerced into numbers if possible.\n */\nexport function median(numbers: unknown[]): number {\n  if (numbers.length === 0) {\n    return 0;\n  }\n\n  // Create a copy with slice() to avoid mutating the original array.\n  const sorted = numbers\n    .map(asNumber)\n    .slice()\n    .sort((a, b) => a - b);\n\n  const middleIndex = Math.floor(sorted.length / 2);\n\n  // Is odd length -> return middle number.\n  if (sorted.length % 2 === 1) {\n    return sorted[middleIndex];\n  }\n\n  // Is even length -> return mean of middle 2 numbers.\n  const value1 = sorted[middleIndex - 1];\n  const value2 = sorted[middleIndex];\n  return (value1 + value2) / 2;\n}\n","/**\n * Coerce `u` into a number if possible, otherwise just return 0.\n */\nexport function asNumber(u: unknown, defaultValue = 0): number {\n  // If u is a valid number, return it.\n  if (typeof u === \"number\") {\n    return isFinite(u) ? u : defaultValue;\n  }\n\n  // Try to make into a number if not already a number.\n  u = Number(u);\n\n  // If u is a valid number, return it.\n  if (typeof u === \"number\" && isFinite(u)) {\n    return u;\n  }\n\n  // Return `defaultValue` for everything else. This is usually ok if want to\n  // just ignore all other noise.\n  return defaultValue;\n}\n"],"mappings":"yaAAA,IAAAA,EAAA,GAAAC,EAAAD,EAAA,YAAAE,IAAA,eAAAC,EAAAH,GCGO,SAASI,EAASC,EAAYC,EAAe,EAAW,CAE7D,OAAI,OAAOD,GAAM,SACR,SAASA,CAAC,EAAIA,EAAIC,GAI3BD,EAAI,OAAOA,CAAC,EAGR,OAAOA,GAAM,UAAY,SAASA,CAAC,EAC9BA,EAKFC,EACT,CDdO,SAASC,EAAOC,EAA4B,CACjD,GAAIA,EAAQ,SAAW,EACrB,MAAO,GAIT,IAAMC,EAASD,EACZ,IAAIE,CAAQ,EACZ,MAAM,EACN,KAAK,CAACC,EAAGC,IAAMD,EAAIC,CAAC,EAEjBC,EAAc,KAAK,MAAMJ,EAAO,OAAS,CAAC,EAGhD,GAAIA,EAAO,OAAS,IAAM,EACxB,OAAOA,EAAOI,CAAW,EAI3B,IAAMC,EAASL,EAAOI,EAAc,CAAC,EAC/BE,EAASN,EAAOI,CAAW,EACjC,OAAQC,EAASC,GAAU,CAC7B","names":["median_exports","__export","median","__toCommonJS","asNumber","u","defaultValue","median","numbers","sorted","asNumber","a","b","middleIndex","value1","value2"]}

package/median.min.mjs

@@ -1,2 +1,2 @@
-function t(n){return typeof n=="number"?isFinite(n)?n:0:(n=Number(n),typeof n=="number"&&isFinite(n)?n:0)}function f(n){if(n.length===0)return 0;let e=n.map(t).slice().sort(),r=Math.floor(e.length/2);if(e.length%2===1)return e[r];let o=e[r-1],i=e[r];return(o+i)/2}export{f as median};
+function t(n,e=0){return typeof n=="number"?isFinite(n)?n:e:(n=Number(n),typeof n=="number"&&isFinite(n)?n:e)}function c(n){if(n.length===0)return 0;let e=n.map(t).slice().sort((m,s)=>m-s),r=Math.floor(e.length/2);if(e.length%2===1)return e[r];let o=e[r-1],i=e[r];return(o+i)/2}export{c as median};
 //# sourceMappingURL=median.min.mjs.map

package/median.min.mjs.map

@@ -1 +1 @@
-{"version":3,"sources":["../src/asNumber.ts","../src/median.ts"],"sourcesContent":["/**\n * Coerce `u` into a number if possible, otherwise just return 0.\n */\nexport function asNumber(u: unknown): number {\n  // If u is a valid number, return it.\n  if (typeof u === \"number\") {\n    return isFinite(u) ? u : 0;\n  }\n\n  // Try to make into a number if not already a number.\n  u = Number(u);\n\n  // If u is a valid number, return it.\n  if (typeof u === \"number\" && isFinite(u)) {\n    return u;\n  }\n\n  // Return 0 for everything else. This is usually ok if want to just ignore\n  // all other noise.\n  return 0;\n}\n","import { asNumber } from \"./asNumber\";\n\n/**\n * Compute the median (middle number) of all the numbers in the given array.\n * Non-numbers will be coerced into numbers if possible.\n */\nexport function median(numbers: unknown[]): number {\n  if (numbers.length === 0) {\n    return 0;\n  }\n\n  // Create a copy with slice() to avoid mutating the original array.\n  const sorted = numbers.map(asNumber).slice().sort();\n\n  const middleIndex = Math.floor(sorted.length / 2);\n\n  // Is odd length -> return middle number.\n  if (sorted.length % 2 === 1) {\n    return sorted[middleIndex];\n  }\n\n  // Is even length -> return mean of middle 2 numbers.\n  const value1 = sorted[middleIndex - 1];\n  const value2 = sorted[middleIndex];\n  return (value1 + value2) / 2;\n}\n"],"mappings":"AAGO,SAASA,EAASC,EAAoB,CAE3C,OAAI,OAAOA,GAAM,SACR,SAASA,CAAC,EAAIA,EAAI,GAI3BA,EAAI,OAAOA,CAAC,EAGR,OAAOA,GAAM,UAAY,SAASA,CAAC,EAC9BA,EAKF,EACT,CCdO,SAASC,EAAOC,EAA4B,CACjD,GAAIA,EAAQ,SAAW,EACrB,MAAO,GAIT,IAAMC,EAASD,EAAQ,IAAIE,CAAQ,EAAE,MAAM,EAAE,KAAK,EAE5CC,EAAc,KAAK,MAAMF,EAAO,OAAS,CAAC,EAGhD,GAAIA,EAAO,OAAS,IAAM,EACxB,OAAOA,EAAOE,CAAW,EAI3B,IAAMC,EAASH,EAAOE,EAAc,CAAC,EAC/BE,EAASJ,EAAOE,CAAW,EACjC,OAAQC,EAASC,GAAU,CAC7B","names":["asNumber","u","median","numbers","sorted","asNumber","middleIndex","value1","value2"]}
+{"version":3,"sources":["../src/asNumber.ts","../src/median.ts"],"sourcesContent":["/**\n * Coerce `u` into a number if possible, otherwise just return 0.\n */\nexport function asNumber(u: unknown, defaultValue = 0): number {\n  // If u is a valid number, return it.\n  if (typeof u === \"number\") {\n    return isFinite(u) ? u : defaultValue;\n  }\n\n  // Try to make into a number if not already a number.\n  u = Number(u);\n\n  // If u is a valid number, return it.\n  if (typeof u === \"number\" && isFinite(u)) {\n    return u;\n  }\n\n  // Return `defaultValue` for everything else. This is usually ok if want to\n  // just ignore all other noise.\n  return defaultValue;\n}\n","import { asNumber } from \"./asNumber\";\n\n/**\n * Compute the median (middle number) of all the numbers in the given array.\n * Non-numbers will be coerced into numbers if possible.\n */\nexport function median(numbers: unknown[]): number {\n  if (numbers.length === 0) {\n    return 0;\n  }\n\n  // Create a copy with slice() to avoid mutating the original array.\n  const sorted = numbers\n    .map(asNumber)\n    .slice()\n    .sort((a, b) => a - b);\n\n  const middleIndex = Math.floor(sorted.length / 2);\n\n  // Is odd length -> return middle number.\n  if (sorted.length % 2 === 1) {\n    return sorted[middleIndex];\n  }\n\n  // Is even length -> return mean of middle 2 numbers.\n  const value1 = sorted[middleIndex - 1];\n  const value2 = sorted[middleIndex];\n  return (value1 + value2) / 2;\n}\n"],"mappings":"AAGO,SAASA,EAASC,EAAYC,EAAe,EAAW,CAE7D,OAAI,OAAOD,GAAM,SACR,SAASA,CAAC,EAAIA,EAAIC,GAI3BD,EAAI,OAAOA,CAAC,EAGR,OAAOA,GAAM,UAAY,SAASA,CAAC,EAC9BA,EAKFC,EACT,CCdO,SAASC,EAAOC,EAA4B,CACjD,GAAIA,EAAQ,SAAW,EACrB,MAAO,GAIT,IAAMC,EAASD,EACZ,IAAIE,CAAQ,EACZ,MAAM,EACN,KAAK,CAACC,EAAGC,IAAMD,EAAIC,CAAC,EAEjBC,EAAc,KAAK,MAAMJ,EAAO,OAAS,CAAC,EAGhD,GAAIA,EAAO,OAAS,IAAM,EACxB,OAAOA,EAAOI,CAAW,EAI3B,IAAMC,EAASL,EAAOI,EAAc,CAAC,EAC/BE,EAASN,EAAOI,CAAW,EACjC,OAAQC,EAASC,GAAU,CAC7B","names":["asNumber","u","defaultValue","median","numbers","sorted","asNumber","a","b","middleIndex","value1","value2"]}

package/median.mjs

@@ -1,13 +1,13 @@
 // src/asNumber.ts
-function asNumber(u) {
+function asNumber(u, defaultValue = 0) {
   if (typeof u === "number") {
-    return isFinite(u) ? u : 0;
+    return isFinite(u) ? u : defaultValue;
   }
   u = Number(u);
   if (typeof u === "number" && isFinite(u)) {
     return u;
   }
-  return 0;
+  return defaultValue;
 }
 
 // src/median.ts
@@ -15,7 +15,7 @@ function median(numbers) {
   if (numbers.length === 0) {
     return 0;
   }
-  const sorted = numbers.map(asNumber).slice().sort();
+  const sorted = numbers.map(asNumber).slice().sort((a, b) => a - b);
   const middleIndex = Math.floor(sorted.length / 2);
   if (sorted.length % 2 === 1) {
     return sorted[middleIndex];

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "@choksheak/ts-utils",
   "license": "The Unlicense",
-  "version": "0.3.4",
+  "version": "0.3.5",
   "description": "Random Typescript utilities with support for full tree-shaking",
   "private": false,
   "sideEffects": false,
@@ -14,7 +14,7 @@
     "test:watch": "vitest",
     "ci": "npm run lint && npm run tsc && npm run build && npm run test",
     "ls": "lint-staged",
-    "docs": "rm -rf docs && typedoc `find src -name '*.ts' ! -name '*.test.ts'` --out docs --name 'Chok’s Typescript Utilities'",
+    "docs": "typedoc",
     "clean": "rm -rf dist",
     "build": "tsup src/*",
     "gen-types": "tsc --emitDeclarationOnly --declaration",
@@ -333,32 +333,6 @@
         "default": "./safeBtoa.cjs"
       }
     },
-    "./safeParseFloat": {
-      "types": "./safeParseFloat.d.ts",
-      "import": {
-        "production": "./safeParseFloat.min.mjs",
-        "development": "./safeParseFloat.mjs",
-        "default": "./safeParseFloat.mjs"
-      },
-      "require": {
-        "production": "./safeParseFloat.min.cjs",
-        "development": "./safeParseFloat.cjs",
-        "default": "./safeParseFloat.cjs"
-      }
-    },
-    "./safeParseInt": {
-      "types": "./safeParseInt.d.ts",
-      "import": {
-        "production": "./safeParseInt.min.mjs",
-        "development": "./safeParseInt.mjs",
-        "default": "./safeParseInt.mjs"
-      },
-      "require": {
-        "production": "./safeParseInt.min.cjs",
-        "development": "./safeParseInt.cjs",
-        "default": "./safeParseInt.cjs"
-      }
-    },
     "./sha256": {
       "types": "./sha256.d.ts",
       "import": {
@@ -510,12 +484,6 @@
       "safeBtoa": [
         "./safeBtoa.d.ts"
       ],
-      "safeParseFloat": [
-        "./safeParseFloat.d.ts"
-      ],
-      "safeParseInt": [
-        "./safeParseInt.d.ts"
-      ],
       "sha256": [
         "./sha256.d.ts"
       ],

package/safeBtoa.d.mts

@@ -1,5 +1,12 @@
 /**
  * Base 64 encode the given input string, but safely.
+ *
+ * Why using btoa() directly might not always work:
+ * btoa() expects a "binary string" where each character is represented by a
+ * single byte (0-255). Modern JavaScript strings, however, are encoded in
+ * UTF-16 and can contain characters that require more than one byte (i.e.,
+ * characters outside the Latin-1 range, such as those with code points greater
+ * than 255).
  */
 declare function safeBtoa(input: string): string;