@welshman/lib 0.0.31 → 0.0.33

package/README.md

@@ -1,11 +1,13 @@
 # @welshman/lib [![version](https://badgen.net/npm/v/@welshman/lib)](https://npmjs.com/package/@welshman/lib)
 
-Some general-purpose utilities used elsewhere in @welshman.
+Some general-purpose utilities for use in @welshman apps.
 
-- `Deferred` is just a promise with `resolve` and `reject` methods.
-- `Emitter` extends EventEmitter to support `emitter.on('*', ...)`.
-- `Fluent` is a wrapper around arrays with chained methods that modify and copy the underlying array.
-- `LRUCache` is an implementation of an LRU cache.
-- `Worker` is an implementation of an asynchronous queue.
-- `Tools` is a collection of general-purpose utility functions.
-- `Store` is an implementation of svelte-like subscribable stores with extra features.
+Includes:
+
+- LRU cache implementation
+- Worker for throttling work to avoid locking up the UI
+- URL normalization (taken from normalize-url)
+- A global `ctx` variable which can be used for global configuration
+- CustomPromise, which provides an error type, and `defer` utility
+- Ramda-like utilities, but without auto-currying
+- Utils for throttling, working with nil, json, fetch, deep equals, etc.

package/build/src/Context.cjs

@@ -1,7 +1,24 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.setContext = exports.ctx = void 0;
+/**
+ * A global context variable for configuring libraries and applications.
+ *
+ * In your application, you'll want to add something like the following to your types.d.ts:
+ * type MyContext = {
+ *   x: number
+ * }
+ *
+ * declare module "@welshman/lib" {
+ *   interface Context {
+ *     net: MyContext
+ *   }
+ * }
+ */
 exports.ctx = {};
+/**
+ * Adds data to ctx.
+ */
 const setContext = (newCtx) => Object.assign(exports.ctx, newCtx);
 exports.setContext = setContext;
 //# sourceMappingURL=Context.cjs.map

package/build/src/Context.cjs.map

@@ -1 +1 @@
-{"version":3,"file":"Context.cjs","sourceRoot":"","sources":["../../src/Context.ts"],"names":[],"mappings":";;;AAEa,QAAA,GAAG,GAAY,EAAE,CAAA;AAEvB,MAAM,UAAU,GAAG,CAAC,MAAe,EAAE,EAAE,CAAC,MAAM,CAAC,MAAM,CAAC,WAAG,EAAE,MAAM,CAAC,CAAA;AAA5D,QAAA,UAAU,cAAkD"}
+{"version":3,"file":"Context.cjs","sourceRoot":"","sources":["../../src/Context.ts"],"names":[],"mappings":";;;AAEA;;;;;;;;;;;;;GAaG;AACU,QAAA,GAAG,GAAY,EAAE,CAAA;AAE9B;;GAEG;AACI,MAAM,UAAU,GAAG,CAAC,MAAe,EAAE,EAAE,CAAC,MAAM,CAAC,MAAM,CAAC,WAAG,EAAE,MAAM,CAAC,CAAA;AAA5D,QAAA,UAAU,cAAkD"}

package/build/src/Context.d.ts

@@ -1,3 +1,20 @@
 import type { Context } from '@welshman/lib';
+/**
+ * A global context variable for configuring libraries and applications.
+ *
+ * In your application, you'll want to add something like the following to your types.d.ts:
+ * type MyContext = {
+ *   x: number
+ * }
+ *
+ * declare module "@welshman/lib" {
+ *   interface Context {
+ *     net: MyContext
+ *   }
+ * }
+ */
 export declare const ctx: Context;
+/**
+ * Adds data to ctx.
+ */
 export declare const setContext: (newCtx: Context) => Context;

package/build/src/Context.mjs

@@ -1,3 +1,20 @@
+/**
+ * A global context variable for configuring libraries and applications.
+ *
+ * In your application, you'll want to add something like the following to your types.d.ts:
+ * type MyContext = {
+ *   x: number
+ * }
+ *
+ * declare module "@welshman/lib" {
+ *   interface Context {
+ *     net: MyContext
+ *   }
+ * }
+ */
 export const ctx = {};
+/**
+ * Adds data to ctx.
+ */
 export const setContext = (newCtx) => Object.assign(ctx, newCtx);
 //# sourceMappingURL=Context.mjs.map

package/build/src/Context.mjs.map

@@ -1 +1 @@
-{"version":3,"file":"Context.mjs","sourceRoot":"","sources":["../../src/Context.ts"],"names":[],"mappings":"AAEA,MAAM,CAAC,MAAM,GAAG,GAAY,EAAE,CAAA;AAE9B,MAAM,CAAC,MAAM,UAAU,GAAG,CAAC,MAAe,EAAE,EAAE,CAAC,MAAM,CAAC,MAAM,CAAC,GAAG,EAAE,MAAM,CAAC,CAAA"}
+{"version":3,"file":"Context.mjs","sourceRoot":"","sources":["../../src/Context.ts"],"names":[],"mappings":"AAEA;;;;;;;;;;;;;GAaG;AACH,MAAM,CAAC,MAAM,GAAG,GAAY,EAAE,CAAA;AAE9B;;GAEG;AACH,MAAM,CAAC,MAAM,UAAU,GAAG,CAAC,MAAe,EAAE,EAAE,CAAC,MAAM,CAAC,MAAM,CAAC,GAAG,EAAE,MAAM,CAAC,CAAA"}

package/build/src/Deferred.cjs

@@ -1,10 +1,19 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.defer = exports.makePromise = void 0;
+/**
+ * Creates a Promise with strongly typed error
+ * @param executor - Promise executor function
+ * @returns Promise with typed error
+ */
 function makePromise(executor) {
     return new Promise(executor);
 }
 exports.makePromise = makePromise;
+/**
+ * Creates a Deferred promise
+ * @returns Promise with resolve/reject methods exposed
+ */
 const defer = () => {
     let resolve, reject;
     const p = makePromise((resolve_, reject_) => {

package/build/src/Deferred.cjs.map

@@ -1 +1 @@
-{"version":3,"file":"Deferred.cjs","sourceRoot":"","sources":["../../src/Deferred.ts"],"names":[],"mappings":";;;AAIA,SAAgB,WAAW,CACzB,QAGS;IAET,OAAO,IAAI,OAAO,CAAC,QAAQ,CAAwB,CAAA;AACrD,CAAC;AAPD,kCAOC;AAOM,MAAM,KAAK,GAAG,GAA6B,EAAE;IAClD,IAAI,OAAO,EAAE,MAAM,CAAA;IACnB,MAAM,CAAC,GAAG,WAAW,CAAC,CAAC,QAAQ,EAAE,OAAO,EAAE,EAAE;QAC1C,OAAO,GAAG,QAAQ,CAAA;QAClB,MAAM,GAAG,OAAO,CAAA;IAClB,CAAC,CAAC,CAAA;IAEF,OAAQ,MAAM,CAAC,MAAM,CAAC,CAAC,EAAE,EAAC,OAAO,EAAE,MAAM,EAAC,CAA+B,CAAA;AAC3E,CAAC,CAAA;AARY,QAAA,KAAK,SAQjB"}
+{"version":3,"file":"Deferred.cjs","sourceRoot":"","sources":["../../src/Deferred.ts"],"names":[],"mappings":";;;AAKA;;;;GAIG;AACH,SAAgB,WAAW,CACzB,QAGS;IAET,OAAO,IAAI,OAAO,CAAC,QAAQ,CAAwB,CAAA;AACrD,CAAC;AAPD,kCAOC;AAQD;;;GAGG;AACI,MAAM,KAAK,GAAG,GAA6B,EAAE;IAClD,IAAI,OAAO,EAAE,MAAM,CAAA;IACnB,MAAM,CAAC,GAAG,WAAW,CAAC,CAAC,QAAQ,EAAE,OAAO,EAAE,EAAE;QAC1C,OAAO,GAAG,QAAQ,CAAA;QAClB,MAAM,GAAG,OAAO,CAAA;IAClB,CAAC,CAAC,CAAA;IAEF,OAAQ,MAAM,CAAC,MAAM,CAAC,CAAC,EAAE,EAAC,OAAO,EAAE,MAAM,EAAC,CAA+B,CAAA;AAC3E,CAAC,CAAA;AARY,QAAA,KAAK,SAQjB"}

package/build/src/Deferred.d.ts

@@ -1,9 +1,20 @@
+/** Promise type with strongly typed error */
 export type CustomPromise<T, E> = Promise<T> & {
     __errorType: E;
 };
+/**
+ * Creates a Promise with strongly typed error
+ * @param executor - Promise executor function
+ * @returns Promise with typed error
+ */
 export declare function makePromise<T, E>(executor: (resolve: (value: T | PromiseLike<T>) => void, reject: (reason: E) => void) => void): CustomPromise<T, E>;
+/** Promise with exposed resolve/reject functions and typed error */
 export type Deferred<T, E = T> = CustomPromise<T, E> & {
     resolve: (arg: T) => void;
     reject: (arg: E) => void;
 };
+/**
+ * Creates a Deferred promise
+ * @returns Promise with resolve/reject methods exposed
+ */
 export declare const defer: <T, E = T>() => Deferred<T, E>;

package/build/src/Deferred.mjs

@@ -1,6 +1,15 @@
+/**
+ * Creates a Promise with strongly typed error
+ * @param executor - Promise executor function
+ * @returns Promise with typed error
+ */
 export function makePromise(executor) {
     return new Promise(executor);
 }
+/**
+ * Creates a Deferred promise
+ * @returns Promise with resolve/reject methods exposed
+ */
 export const defer = () => {
     let resolve, reject;
     const p = makePromise((resolve_, reject_) => {

package/build/src/Deferred.mjs.map

@@ -1 +1 @@
-{"version":3,"file":"Deferred.mjs","sourceRoot":"","sources":["../../src/Deferred.ts"],"names":[],"mappings":"AAIA,MAAM,UAAU,WAAW,CACzB,QAGS;IAET,OAAO,IAAI,OAAO,CAAC,QAAQ,CAAwB,CAAA;AACrD,CAAC;AAOD,MAAM,CAAC,MAAM,KAAK,GAAG,GAA6B,EAAE;IAClD,IAAI,OAAO,EAAE,MAAM,CAAA;IACnB,MAAM,CAAC,GAAG,WAAW,CAAC,CAAC,QAAQ,EAAE,OAAO,EAAE,EAAE;QAC1C,OAAO,GAAG,QAAQ,CAAA;QAClB,MAAM,GAAG,OAAO,CAAA;IAClB,CAAC,CAAC,CAAA;IAEF,OAAQ,MAAM,CAAC,MAAM,CAAC,CAAC,EAAE,EAAC,OAAO,EAAE,MAAM,EAAC,CAA+B,CAAA;AAC3E,CAAC,CAAA"}
+{"version":3,"file":"Deferred.mjs","sourceRoot":"","sources":["../../src/Deferred.ts"],"names":[],"mappings":"AAKA;;;;GAIG;AACH,MAAM,UAAU,WAAW,CACzB,QAGS;IAET,OAAO,IAAI,OAAO,CAAC,QAAQ,CAAwB,CAAA;AACrD,CAAC;AAQD;;;GAGG;AACH,MAAM,CAAC,MAAM,KAAK,GAAG,GAA6B,EAAE;IAClD,IAAI,OAAO,EAAE,MAAM,CAAA;IACnB,MAAM,CAAC,GAAG,WAAW,CAAC,CAAC,QAAQ,EAAE,OAAO,EAAE,EAAE;QAC1C,OAAO,GAAG,QAAQ,CAAA;QAClB,MAAM,GAAG,OAAO,CAAA;IAClB,CAAC,CAAC,CAAA;IAEF,OAAQ,MAAM,CAAC,MAAM,CAAC,CAAC,EAAE,EAAC,OAAO,EAAE,MAAM,EAAC,CAA+B,CAAA;AAC3E,CAAC,CAAA"}

package/build/src/Emitter.cjs

@@ -2,7 +2,16 @@
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.Emitter = void 0;
 const events_1 = require("events");
+/**
+ * Extended EventEmitter that also emits all events to '*' listeners
+ */
 class Emitter extends events_1.EventEmitter {
+    /**
+     * Emits an event to listeners and to '*' listeners
+     * @param type - Event type/name
+     * @param args - Arguments to pass to listeners
+     * @returns True if event had listeners
+     */
     emit(type, ...args) {
         const a = super.emit(type, ...args);
         const b = super.emit('*', type, ...args);

package/build/src/Emitter.cjs.map

@@ -1 +1 @@
-{"version":3,"file":"Emitter.cjs","sourceRoot":"","sources":["../../src/Emitter.ts"],"names":[],"mappings":";;;AAAA,mCAAmC;AAEnC,MAAa,OAAQ,SAAQ,qBAAY;IACvC,IAAI,CAAC,IAAY,EAAE,GAAG,IAAW;QAC/B,MAAM,CAAC,GAAG,KAAK,CAAC,IAAI,CAAC,IAAI,EAAE,GAAG,IAAI,CAAC,CAAA;QACnC,MAAM,CAAC,GAAG,KAAK,CAAC,IAAI,CAAC,GAAG,EAAE,IAAI,EAAE,GAAG,IAAI,CAAC,CAAA;QAExC,OAAO,CAAC,IAAI,CAAC,CAAA;IACf,CAAC;CACF;AAPD,0BAOC"}
+{"version":3,"file":"Emitter.cjs","sourceRoot":"","sources":["../../src/Emitter.ts"],"names":[],"mappings":";;;AAAA,mCAAmC;AAEnC;;GAEG;AACH,MAAa,OAAQ,SAAQ,qBAAY;IACvC;;;;;OAKG;IACH,IAAI,CAAC,IAAY,EAAE,GAAG,IAAW;QAC/B,MAAM,CAAC,GAAG,KAAK,CAAC,IAAI,CAAC,IAAI,EAAE,GAAG,IAAI,CAAC,CAAA;QACnC,MAAM,CAAC,GAAG,KAAK,CAAC,IAAI,CAAC,GAAG,EAAE,IAAI,EAAE,GAAG,IAAI,CAAC,CAAA;QAExC,OAAO,CAAC,IAAI,CAAC,CAAA;IACf,CAAC;CACF;AAbD,0BAaC"}

package/build/src/Emitter.d.ts

@@ -1,4 +1,13 @@
 import { EventEmitter } from 'events';
+/**
+ * Extended EventEmitter that also emits all events to '*' listeners
+ */
 export declare class Emitter extends EventEmitter {
+    /**
+     * Emits an event to listeners and to '*' listeners
+     * @param type - Event type/name
+     * @param args - Arguments to pass to listeners
+     * @returns True if event had listeners
+     */
     emit(type: string, ...args: any[]): boolean;
 }

package/build/src/Emitter.mjs

@@ -1,5 +1,14 @@
 import { EventEmitter } from 'events';
+/**
+ * Extended EventEmitter that also emits all events to '*' listeners
+ */
 export class Emitter extends EventEmitter {
+    /**
+     * Emits an event to listeners and to '*' listeners
+     * @param type - Event type/name
+     * @param args - Arguments to pass to listeners
+     * @returns True if event had listeners
+     */
     emit(type, ...args) {
         const a = super.emit(type, ...args);
         const b = super.emit('*', type, ...args);

package/build/src/Emitter.mjs.map

@@ -1 +1 @@
-{"version":3,"file":"Emitter.mjs","sourceRoot":"","sources":["../../src/Emitter.ts"],"names":[],"mappings":"OAAO,EAAC,YAAY,EAAC,MAAM,QAAQ;AAEnC,MAAM,OAAO,OAAQ,SAAQ,YAAY;IACvC,IAAI,CAAC,IAAY,EAAE,GAAG,IAAW;QAC/B,MAAM,CAAC,GAAG,KAAK,CAAC,IAAI,CAAC,IAAI,EAAE,GAAG,IAAI,CAAC,CAAA;QACnC,MAAM,CAAC,GAAG,KAAK,CAAC,IAAI,CAAC,GAAG,EAAE,IAAI,EAAE,GAAG,IAAI,CAAC,CAAA;QAExC,OAAO,CAAC,IAAI,CAAC,CAAA;IACf,CAAC;CACF"}
+{"version":3,"file":"Emitter.mjs","sourceRoot":"","sources":["../../src/Emitter.ts"],"names":[],"mappings":"OAAO,EAAC,YAAY,EAAC,MAAM,QAAQ;AAEnC;;GAEG;AACH,MAAM,OAAO,OAAQ,SAAQ,YAAY;IACvC;;;;;OAKG;IACH,IAAI,CAAC,IAAY,EAAE,GAAG,IAAW;QAC/B,MAAM,CAAC,GAAG,KAAK,CAAC,IAAI,CAAC,IAAI,EAAE,GAAG,IAAI,CAAC,CAAA;QACnC,MAAM,CAAC,GAAG,KAAK,CAAC,IAAI,CAAC,GAAG,EAAE,IAAI,EAAE,GAAG,IAAI,CAAC,CAAA;QAExC,OAAO,CAAC,IAAI,CAAC,CAAA;IACf,CAAC;CACF"}

package/build/src/LRUCache.cjs

@@ -1,6 +1,11 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.simpleCache = exports.cached = exports.LRUCache = void 0;
+/**
+ * Least Recently Used (LRU) cache implementation
+ * @template T - Type of cache keys
+ * @template U - Type of cache values
+ */
 class LRUCache {
     constructor(maxSize = Infinity) {
         this.maxSize = maxSize;
@@ -29,6 +34,12 @@ class LRUCache {
     }
 }
 exports.LRUCache = LRUCache;
+/**
+ * Creates a memoized function with LRU caching
+ * @template T - Cache key type
+ * @template V - Cache value type
+ * @template Args - Function argument types
+ */
 function cached({ maxSize, getKey, getValue, }) {
     const cache = new LRUCache(maxSize);
     const get = (...args) => {
@@ -44,6 +55,11 @@ function cached({ maxSize, getKey, getValue, }) {
     return get;
 }
 exports.cached = cached;
+/**
+ * Creates a simple memoized function with default settings
+ * @template V - Cache value type
+ * @template Args - Function argument types
+ */
 function simpleCache(getValue) {
     return cached({ maxSize: 10 ** 5, getKey: xs => xs.join(':'), getValue });
 }

package/build/src/LRUCache.cjs.map

@@ -1 +1 @@
-{"version":3,"file":"LRUCache.cjs","sourceRoot":"","sources":["../../src/LRUCache.ts"],"names":[],"mappings":";;;AAAA,MAAa,QAAQ;IAInB,YAAqB,UAAkB,QAAQ;QAA1B,YAAO,GAAP,OAAO,CAAmB;QAH/C,QAAG,GAAG,IAAI,GAAG,EAAQ,CAAA;QACrB,SAAI,GAAQ,EAAE,CAAA;IAEoC,CAAC;IAEnD,GAAG,CAAC,CAAI;QACN,OAAO,IAAI,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC,CAAC,CAAA;IACxB,CAAC;IAED,GAAG,CAAC,CAAI;QACN,MAAM,CAAC,GAAG,IAAI,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC,CAAC,CAAA;QAEzB,IAAI,CAAC,KAAK,SAAS,EAAE;YACnB,IAAI,CAAC,IAAI,CAAC,IAAI,CAAC,CAAM,CAAC,CAAA;YAEtB,IAAI,IAAI,CAAC,IAAI,CAAC,MAAM,GAAG,IAAI,CAAC,OAAO,GAAG,CAAC,EAAE;gBACvC,IAAI,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC,IAAI,CAAC,OAAO,CAAC,CAAA;aAChC;SACF;QAED,OAAO,CAAC,CAAA;IACV,CAAC;IAED,GAAG,CAAC,CAAI,EAAE,CAAI;QACZ,IAAI,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC,EAAE,CAAC,CAAC,CAAA;QAClB,IAAI,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC,CAAC,CAAA;QAEjB,IAAI,IAAI,CAAC,GAAG,CAAC,IAAI,GAAG,IAAI,CAAC,OAAO,EAAE;YAChC,IAAI,CAAC,GAAG,CAAC,MAAM,CAAC,IAAI,CAAC,IAAI,CAAC,KAAK,EAAO,CAAC,CAAA;SACxC;IACH,CAAC;CACF;AAhCD,4BAgCC;AAED,SAAgB,MAAM,CAA2B,EAC/C,OAAO,EACP,MAAM,EACN,QAAQ,GAKT;IACC,MAAM,KAAK,GAAG,IAAI,QAAQ,CAAO,OAAO,CAAC,CAAA;IAEzC,MAAM,GAAG,GAAG,CAAC,GAAG,IAAU,EAAE,EAAE;QAC5B,MAAM,CAAC,GAAG,MAAM,CAAC,IAAI,CAAC,CAAA;QAEtB,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE;YACjB,KAAK,CAAC,GAAG,CAAC,CAAC,EAAE,QAAQ,CAAC,IAAI,CAAC,CAAC,CAAA;SAC7B;QAED,OAAO,KAAK,CAAC,GAAG,CAAC,CAAC,CAAE,CAAA;IACtB,CAAC,CAAA;IAED,GAAG,CAAC,KAAK,GAAG,KAAK,CAAA;IACjB,GAAG,CAAC,MAAM,GAAG,MAAM,CAAA;IACnB,GAAG,CAAC,QAAQ,GAAG,QAAQ,CAAA;IAEvB,OAAO,GAAG,CAAA;AACZ,CAAC;AA1BD,wBA0BC;AAED,SAAgB,WAAW,CAAwB,QAA2B;IAC5E,OAAO,MAAM,CAAC,EAAC,OAAO,EAAE,EAAE,IAAE,CAAC,EAAE,MAAM,EAAE,EAAE,CAAC,EAAE,CAAC,EAAE,CAAC,IAAI,CAAC,GAAG,CAAC,EAAE,QAAQ,EAAC,CAAC,CAAA;AACvE,CAAC;AAFD,kCAEC"}
+{"version":3,"file":"LRUCache.cjs","sourceRoot":"","sources":["../../src/LRUCache.ts"],"names":[],"mappings":";;;AAAA;;;;GAIG;AACH,MAAa,QAAQ;IAInB,YAAqB,UAAkB,QAAQ;QAA1B,YAAO,GAAP,OAAO,CAAmB;QAH/C,QAAG,GAAG,IAAI,GAAG,EAAQ,CAAA;QACrB,SAAI,GAAQ,EAAE,CAAA;IAEoC,CAAC;IAEnD,GAAG,CAAC,CAAI;QACN,OAAO,IAAI,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC,CAAC,CAAA;IACxB,CAAC;IAED,GAAG,CAAC,CAAI;QACN,MAAM,CAAC,GAAG,IAAI,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC,CAAC,CAAA;QAEzB,IAAI,CAAC,KAAK,SAAS,EAAE;YACnB,IAAI,CAAC,IAAI,CAAC,IAAI,CAAC,CAAM,CAAC,CAAA;YAEtB,IAAI,IAAI,CAAC,IAAI,CAAC,MAAM,GAAG,IAAI,CAAC,OAAO,GAAG,CAAC,EAAE;gBACvC,IAAI,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC,IAAI,CAAC,OAAO,CAAC,CAAA;aAChC;SACF;QAED,OAAO,CAAC,CAAA;IACV,CAAC;IAED,GAAG,CAAC,CAAI,EAAE,CAAI;QACZ,IAAI,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC,EAAE,CAAC,CAAC,CAAA;QAClB,IAAI,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC,CAAC,CAAA;QAEjB,IAAI,IAAI,CAAC,GAAG,CAAC,IAAI,GAAG,IAAI,CAAC,OAAO,EAAE;YAChC,IAAI,CAAC,GAAG,CAAC,MAAM,CAAC,IAAI,CAAC,IAAI,CAAC,KAAK,EAAO,CAAC,CAAA;SACxC;IACH,CAAC;CACF;AAhCD,4BAgCC;AAED;;;;;GAKG;AACH,SAAgB,MAAM,CAA2B,EAC/C,OAAO,EACP,MAAM,EACN,QAAQ,GAKT;IACC,MAAM,KAAK,GAAG,IAAI,QAAQ,CAAO,OAAO,CAAC,CAAA;IAEzC,MAAM,GAAG,GAAG,CAAC,GAAG,IAAU,EAAE,EAAE;QAC5B,MAAM,CAAC,GAAG,MAAM,CAAC,IAAI,CAAC,CAAA;QAEtB,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE;YACjB,KAAK,CAAC,GAAG,CAAC,CAAC,EAAE,QAAQ,CAAC,IAAI,CAAC,CAAC,CAAA;SAC7B;QAED,OAAO,KAAK,CAAC,GAAG,CAAC,CAAC,CAAE,CAAA;IACtB,CAAC,CAAA;IAED,GAAG,CAAC,KAAK,GAAG,KAAK,CAAA;IACjB,GAAG,CAAC,MAAM,GAAG,MAAM,CAAA;IACnB,GAAG,CAAC,QAAQ,GAAG,QAAQ,CAAA;IAEvB,OAAO,GAAG,CAAA;AACZ,CAAC;AA1BD,wBA0BC;AAED;;;;GAIG;AACH,SAAgB,WAAW,CAAwB,QAA2B;IAC5E,OAAO,MAAM,CAAC,EAAC,OAAO,EAAE,EAAE,IAAE,CAAC,EAAE,MAAM,EAAE,EAAE,CAAC,EAAE,CAAC,EAAE,CAAC,IAAI,CAAC,GAAG,CAAC,EAAE,QAAQ,EAAC,CAAC,CAAA;AACvE,CAAC;AAFD,kCAEC"}

package/build/src/LRUCache.d.ts

@@ -1,3 +1,8 @@
+/**
+ * Least Recently Used (LRU) cache implementation
+ * @template T - Type of cache keys
+ * @template U - Type of cache values
+ */
 export declare class LRUCache<T, U> {
     readonly maxSize: number;
     map: Map<T, U>;
@@ -7,6 +12,12 @@ export declare class LRUCache<T, U> {
     get(k: T): U | undefined;
     set(k: T, v: U): void;
 }
+/**
+ * Creates a memoized function with LRU caching
+ * @template T - Cache key type
+ * @template V - Cache value type
+ * @template Args - Function argument types
+ */
 export declare function cached<T, V, Args extends any[]>({ maxSize, getKey, getValue, }: {
     maxSize: number;
     getKey: (args: Args) => T;
@@ -17,6 +28,11 @@ export declare function cached<T, V, Args extends any[]>({ maxSize, getKey, getV
     getKey: (args: Args) => T;
     getValue: (args: Args) => V;
 };
+/**
+ * Creates a simple memoized function with default settings
+ * @template V - Cache value type
+ * @template Args - Function argument types
+ */
 export declare function simpleCache<V, Args extends any[]>(getValue: (args: Args) => V): {
     (...args: Args): NonNullable<V>;
     cache: LRUCache<string, V>;

package/build/src/LRUCache.mjs

@@ -1,3 +1,8 @@
+/**
+ * Least Recently Used (LRU) cache implementation
+ * @template T - Type of cache keys
+ * @template U - Type of cache values
+ */
 export class LRUCache {
     constructor(maxSize = Infinity) {
         this.maxSize = maxSize;
@@ -25,6 +30,12 @@ export class LRUCache {
         }
     }
 }
+/**
+ * Creates a memoized function with LRU caching
+ * @template T - Cache key type
+ * @template V - Cache value type
+ * @template Args - Function argument types
+ */
 export function cached({ maxSize, getKey, getValue, }) {
     const cache = new LRUCache(maxSize);
     const get = (...args) => {
@@ -39,6 +50,11 @@ export function cached({ maxSize, getKey, getValue, }) {
     get.getValue = getValue;
     return get;
 }
+/**
+ * Creates a simple memoized function with default settings
+ * @template V - Cache value type
+ * @template Args - Function argument types
+ */
 export function simpleCache(getValue) {
     return cached({ maxSize: 10 ** 5, getKey: xs => xs.join(':'), getValue });
 }

package/build/src/LRUCache.mjs.map

@@ -1 +1 @@
-{"version":3,"file":"LRUCache.mjs","sourceRoot":"","sources":["../../src/LRUCache.ts"],"names":[],"mappings":"AAAA,MAAM,OAAO,QAAQ;IAInB,YAAqB,UAAkB,QAAQ;QAA1B,YAAO,GAAP,OAAO,CAAmB;QAH/C,QAAG,GAAG,IAAI,GAAG,EAAQ,CAAA;QACrB,SAAI,GAAQ,EAAE,CAAA;IAEoC,CAAC;IAEnD,GAAG,CAAC,CAAI;QACN,OAAO,IAAI,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC,CAAC,CAAA;IACxB,CAAC;IAED,GAAG,CAAC,CAAI;QACN,MAAM,CAAC,GAAG,IAAI,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC,CAAC,CAAA;QAEzB,IAAI,CAAC,KAAK,SAAS,EAAE;YACnB,IAAI,CAAC,IAAI,CAAC,IAAI,CAAC,CAAM,CAAC,CAAA;YAEtB,IAAI,IAAI,CAAC,IAAI,CAAC,MAAM,GAAG,IAAI,CAAC,OAAO,GAAG,CAAC,EAAE;gBACvC,IAAI,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC,IAAI,CAAC,OAAO,CAAC,CAAA;aAChC;SACF;QAED,OAAO,CAAC,CAAA;IACV,CAAC;IAED,GAAG,CAAC,CAAI,EAAE,CAAI;QACZ,IAAI,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC,EAAE,CAAC,CAAC,CAAA;QAClB,IAAI,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC,CAAC,CAAA;QAEjB,IAAI,IAAI,CAAC,GAAG,CAAC,IAAI,GAAG,IAAI,CAAC,OAAO,EAAE;YAChC,IAAI,CAAC,GAAG,CAAC,MAAM,CAAC,IAAI,CAAC,IAAI,CAAC,KAAK,EAAO,CAAC,CAAA;SACxC;IACH,CAAC;CACF;AAED,MAAM,UAAU,MAAM,CAA2B,EAC/C,OAAO,EACP,MAAM,EACN,QAAQ,GAKT;IACC,MAAM,KAAK,GAAG,IAAI,QAAQ,CAAO,OAAO,CAAC,CAAA;IAEzC,MAAM,GAAG,GAAG,CAAC,GAAG,IAAU,EAAE,EAAE;QAC5B,MAAM,CAAC,GAAG,MAAM,CAAC,IAAI,CAAC,CAAA;QAEtB,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE;YACjB,KAAK,CAAC,GAAG,CAAC,CAAC,EAAE,QAAQ,CAAC,IAAI,CAAC,CAAC,CAAA;SAC7B;QAED,OAAO,KAAK,CAAC,GAAG,CAAC,CAAC,CAAE,CAAA;IACtB,CAAC,CAAA;IAED,GAAG,CAAC,KAAK,GAAG,KAAK,CAAA;IACjB,GAAG,CAAC,MAAM,GAAG,MAAM,CAAA;IACnB,GAAG,CAAC,QAAQ,GAAG,QAAQ,CAAA;IAEvB,OAAO,GAAG,CAAA;AACZ,CAAC;AAED,MAAM,UAAU,WAAW,CAAwB,QAA2B;IAC5E,OAAO,MAAM,CAAC,EAAC,OAAO,EAAE,EAAE,IAAE,CAAC,EAAE,MAAM,EAAE,EAAE,CAAC,EAAE,CAAC,EAAE,CAAC,IAAI,CAAC,GAAG,CAAC,EAAE,QAAQ,EAAC,CAAC,CAAA;AACvE,CAAC"}
+{"version":3,"file":"LRUCache.mjs","sourceRoot":"","sources":["../../src/LRUCache.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AACH,MAAM,OAAO,QAAQ;IAInB,YAAqB,UAAkB,QAAQ;QAA1B,YAAO,GAAP,OAAO,CAAmB;QAH/C,QAAG,GAAG,IAAI,GAAG,EAAQ,CAAA;QACrB,SAAI,GAAQ,EAAE,CAAA;IAEoC,CAAC;IAEnD,GAAG,CAAC,CAAI;QACN,OAAO,IAAI,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC,CAAC,CAAA;IACxB,CAAC;IAED,GAAG,CAAC,CAAI;QACN,MAAM,CAAC,GAAG,IAAI,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC,CAAC,CAAA;QAEzB,IAAI,CAAC,KAAK,SAAS,EAAE;YACnB,IAAI,CAAC,IAAI,CAAC,IAAI,CAAC,CAAM,CAAC,CAAA;YAEtB,IAAI,IAAI,CAAC,IAAI,CAAC,MAAM,GAAG,IAAI,CAAC,OAAO,GAAG,CAAC,EAAE;gBACvC,IAAI,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC,IAAI,CAAC,OAAO,CAAC,CAAA;aAChC;SACF;QAED,OAAO,CAAC,CAAA;IACV,CAAC;IAED,GAAG,CAAC,CAAI,EAAE,CAAI;QACZ,IAAI,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC,EAAE,CAAC,CAAC,CAAA;QAClB,IAAI,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC,CAAC,CAAA;QAEjB,IAAI,IAAI,CAAC,GAAG,CAAC,IAAI,GAAG,IAAI,CAAC,OAAO,EAAE;YAChC,IAAI,CAAC,GAAG,CAAC,MAAM,CAAC,IAAI,CAAC,IAAI,CAAC,KAAK,EAAO,CAAC,CAAA;SACxC;IACH,CAAC;CACF;AAED;;;;;GAKG;AACH,MAAM,UAAU,MAAM,CAA2B,EAC/C,OAAO,EACP,MAAM,EACN,QAAQ,GAKT;IACC,MAAM,KAAK,GAAG,IAAI,QAAQ,CAAO,OAAO,CAAC,CAAA;IAEzC,MAAM,GAAG,GAAG,CAAC,GAAG,IAAU,EAAE,EAAE;QAC5B,MAAM,CAAC,GAAG,MAAM,CAAC,IAAI,CAAC,CAAA;QAEtB,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE;YACjB,KAAK,CAAC,GAAG,CAAC,CAAC,EAAE,QAAQ,CAAC,IAAI,CAAC,CAAC,CAAA;SAC7B;QAED,OAAO,KAAK,CAAC,GAAG,CAAC,CAAC,CAAE,CAAA;IACtB,CAAC,CAAA;IAED,GAAG,CAAC,KAAK,GAAG,KAAK,CAAA;IACjB,GAAG,CAAC,MAAM,GAAG,MAAM,CAAA;IACnB,GAAG,CAAC,QAAQ,GAAG,QAAQ,CAAA;IAEvB,OAAO,GAAG,CAAA;AACZ,CAAC;AAED;;;;GAIG;AACH,MAAM,UAAU,WAAW,CAAwB,QAA2B;IAC5E,OAAO,MAAM,CAAC,EAAC,OAAO,EAAE,EAAE,IAAE,CAAC,EAAE,MAAM,EAAE,EAAE,CAAC,EAAE,CAAC,EAAE,CAAC,IAAI,CAAC,GAAG,CAAC,EAAE,QAAQ,EAAC,CAAC,CAAA;AACvE,CAAC"}