@kirill.konshin/core 0.0.1

package/.ctirc

@@ -0,0 +1,11 @@
+{
+  "addNewline": true,
+  "fileExcludePatterns": [
+    "*.stories.*",
+    "*.test.*",
+    "*.fixture.*"
+  ],
+  "verbose": false,
+  "withoutBackupFile": true,
+  "withoutComment": true
+}

package/.turbo/turbo-build.log

@@ -0,0 +1,26 @@
+vite v7.0.6 building SSR bundle for production...
+create succeeded: /home/runner/work/utils/utils/packages/core/src
+transforming...
+✓ 10 modules transformed.
+rendering chunks...
+
+[vite:dts] Start generate declaration files...
+src/workerUtils.ts:22:64 - error TS2322: Type 'null' is not assignable to type 'boolean'.
+
+22     return transferrable.some((t) => obj instanceof t) ? obj : null;
+                                                                  ~~~~
+
+dist/errors.js       0.33 kB │ map:  0.90 kB
+dist/mutex.js        0.40 kB │ map:  1.18 kB
+dist/ls.js           0.44 kB │ map:  1.05 kB
+dist/files.js        0.84 kB │ map:  1.89 kB
+dist/index.js        0.92 kB │ map:  0.10 kB
+dist/workerUtils.js  0.97 kB │ map:  1.82 kB
+dist/measure.js      1.44 kB │ map:  4.08 kB
+dist/cache.js        2.92 kB │ map: 10.21 kB
+dist/worker.js       7.06 kB │ map: 16.69 kB
+dist/wrpc.js         8.73 kB │ map: 20.98 kB
+[vite:dts] Declaration files built in 1945ms.
+
+✓ built in 2.75s
+Updated package.json with exports

package/.turbo/turbo-test.log

@@ -0,0 +1,103 @@
+create succeeded: /home/runner/work/utils/utils/packages/core/src
+
+ RUN  v3.2.4 /home/runner/work/utils/utils/packages/core
+      Coverage enabled with v8
+
+stderr | src/wrpc.test.ts
+Using an object as a third argument is deprecated. Vitest 4 will throw an error if the third argument is not a timeout number. Please use the second argument for options. See more at https://vitest.dev/guide/migration
+
+stdout | src/cache.test.ts > TransformerMap > key transform
+CLEAR cache test
+
+stdout | src/wrpc.test.ts > WRPC > for await ... of return yield
+DATA 1
+
+stdout | src/wrpc.test.ts > WRPC > for await ... of return yield
+DATA 2
+
+stdout | src/wrpc.test.ts > WRPC > for await ... of return yield
+DATA 3
+
+stdout | src/wrpc.test.ts > WRPC > for await ... of return yield
+DATA { value: 1, done: false }
+
+stdout | src/wrpc.test.ts > WRPC > for await ... of return yield
+DATA { value: 2, done: false }
+
+stdout | src/wrpc.test.ts > WRPC > for await ... of return yield
+DATA { value: 3, done: false }
+
+ ✓ src/cache.test.ts (4 tests) 13ms
+stdout | src/wrpc.test.ts > WRPC > for await ... of return yield
+DATA { value: undefined, done: true }
+
+ ✓ src/worker.test.ts (8 tests) 13ms
+stdout | src/wrpc.test.ts > WRPC > for await ... of separate return & yield
+DATA { progress: 0 }
+
+stdout | src/wrpc.test.ts > WRPC > for await ... of separate return & yield
+DATA { progress: 0.5 }
+
+stdout | src/wrpc.test.ts > WRPC > for await ... of separate return & yield
+DATA { progress: 1, aborted: false }
+
+stdout | src/wrpc.test.ts > WRPC > do ... while
+DATA { value: { progress: 0 }, done: false }
+
+stdout | src/wrpc.test.ts > WRPC > do ... while
+DATA { value: { progress: 0.5 }, done: false }
+
+stdout | src/wrpc.test.ts > WRPC > do ... while
+DATA { value: { progress: 1, aborted: false }, done: false }
+
+stdout | src/wrpc.test.ts > WRPC > do ... while
+DATA { value: 'foo', done: true }
+
+stdout | src/wrpc.test.ts > WRPC > break
+DATA { progress: 0 }
+
+stdout | src/wrpc.test.ts > WRPC > abort
+DATA { progress: 0 }
+
+ ✓ src/wrpc.test.ts (13 tests | 1 skipped) 719ms
+   ✓ WRPC > stop  503ms
+Failed to convert coverage for file:///home/runner/work/utils/utils/packages/core/src/wrpc.ts.
+ TypeError: Cannot read properties of undefined (reading 'endCol')
+    at range.sliceRange (file:///home/runner/work/utils/utils/node_modules/@vitest/coverage-v8/dist/provider.js:556:55)
+    at CovSource.offsetToOriginalRelative (file:///home/runner/work/utils/utils/node_modules/@vitest/coverage-v8/dist/provider.js:1987:20)
+    at V8ToIstanbul._maybeRemapStartColEndCol (file:///home/runner/work/utils/utils/node_modules/@vitest/coverage-v8/dist/provider.js:2396:93)
+    at file:///home/runner/work/utils/utils/node_modules/@vitest/coverage-v8/dist/provider.js:2305:61
+    at Array.forEach (<anonymous>)
+    at file:///home/runner/work/utils/utils/node_modules/@vitest/coverage-v8/dist/provider.js:2303:21
+    at Array.forEach (<anonymous>)
+    at V8ToIstanbul.applyCoverage (file:///home/runner/work/utils/utils/node_modules/@vitest/coverage-v8/dist/provider.js:2302:13)
+    at V8CoverageProvider.v8ToIstanbul (file:///home/runner/work/utils/utils/node_modules/@vitest/coverage-v8/dist/provider.js:2732:14)
+    at async file:///home/runner/work/utils/utils/node_modules/@vitest/coverage-v8/dist/provider.js:2825:23
+
+ Test Files  3 passed (3)
+      Tests  24 passed | 1 skipped (25)
+   Start at  01:30:13
+   Duration  1.33s (transform 220ms, setup 0ms, collect 329ms, tests 746ms, environment 1ms, prepare 444ms)
+
+ % Coverage report from v8
+------------------|---------|----------|---------|---------|--------------------
+File              | % Stmts | % Branch | % Funcs | % Lines | Uncovered Line #s  
+------------------|---------|----------|---------|---------|--------------------
+All files         |   73.18 |    88.88 |   77.77 |   73.18 |                    
+ demo             |       0 |        0 |       0 |       0 |                    
+  worker-demo.ts  |       0 |        0 |       0 |       0 | 1-73               
+ src              |   78.07 |    89.51 |   79.03 |   78.07 |                    
+  cache.ts        |   81.25 |    89.65 |   56.25 |   81.25 | ...200-201,224-225 
+  errors.ts       |       0 |      100 |     100 |       0 | 2-17               
+  files.ts        |       0 |        0 |       0 |       0 | 1-29               
+  index.ts        |       0 |        0 |       0 |       0 | 1-9                
+  ls.ts           |       0 |        0 |       0 |       0 | 1-15               
+  measure.ts      |       0 |        0 |       0 |       0 | 1-109              
+  mutex.ts        |       0 |      100 |     100 |       0 | 3-22               
+  worker.ts       |     100 |    98.71 |     100 |     100 | 57                 
+  workerUtils.ts  |     100 |       75 |     100 |     100 | 17,22,26,29        
+  wrpc.fixture.ts |   81.81 |    78.57 |      75 |   81.81 | 70,73-76,95-99     
+  wrpc.ts         |     100 |      100 |     100 |     100 |                    
+------------------|---------|----------|---------|---------|--------------------
+Updated package.json with exports
+Updated package.json with exports

package/README.md

@@ -0,0 +1,91 @@
+# WRPC
+
+TODO
+
+- [ ] Add to readme https://stackoverflow.com/questions/77727664/how-to-get-returned-value-from-async-generator-when-using-for-await
+- [ ] Value passed to next are ignored https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/AsyncGenerator/next#sending_values_to_the_generator
+
+```mermaid
+sequenceDiagram
+    box Main
+    participant Code
+    participant Caller
+    end
+    box Worker
+    participant Worker
+    participant Resolver
+    end
+
+    %% autonumber
+
+    Code->>Caller: caller.generator(payload)
+
+    Caller-->>Code: iterator & promise
+
+    Code->>Code: Start main CONSUMER loop
+
+    Code->>Caller: iterator[Symbol]()
+
+    Caller->>Caller: Start replica GENERATOR loop
+
+    Code->>Caller: iterator.next()
+
+    Caller->>Worker: postMessage(payload)
+
+    Worker->>Resolver: resolver(payload)
+
+    Resolver-->>Worker: iterator
+
+    Worker->>Worker: Start replica CONSUMER loop
+
+    Worker->>Resolver: iterator[Symbol]()
+
+    Resolver->>Resolver: Start GENERATOR loop
+
+    rect rgb(232, 244, 248)
+
+        loop Synchronized iteration
+            Worker->>+Resolver: iterator.next(payload)
+
+            Resolver-->>-Worker: yield value
+
+            Worker-->>Caller: postMessage(value, done=false)
+
+            Note over Worker: Wait for ACK or ABORT
+
+            Caller-->>Code: yield value
+
+            Code->>Caller: iterator.next(nextPayload)
+
+            Caller->>Worker: postMessage(ack, nextPayload)
+        end
+
+    end
+
+    break Break or AbortSignal (maybe)
+        Code-->>Code: Loop exits
+        Code->>Caller: signal.abort()
+
+        Caller-->>Caller: Loop exits
+
+        Caller->>Worker: postMessage(abort)
+
+        Worker-->>Worker: Loop exits via Break
+
+        Resolver-->>Resolver: Loop exits
+    end
+
+    opt Occurs on Error
+        Resolver-->>Worker: throw Error
+
+        Worker-->>Caller: postMessage(error, done=true)
+
+        Caller-->>Code: throw Error
+    end
+
+    Resolver-->>Worker: return value
+
+    Worker-->>Caller: postMessage(value, done=true)
+
+    Caller-->>Code: return value
+```

package/demo/worker-demo.ts

@@ -0,0 +1,73 @@
+import { RespondersBase, WorkerDialog } from '../src';
+
+class Responders extends RespondersBase<Responders> {
+    encode = this.create(
+        'encode',
+        async (
+            { file, abort = false }: { file: File; abort: boolean }, // should have all possible combinations for strong typing
+            encodeContext,
+        ) => {
+            // send within same message
+            encodeContext.send({ progress: 0 }); // ✅ Valid
+            encodeContext.send({ junk: 'xxx' }); // ❌ Bad & should be red
+
+            // listen same message
+            encodeContext.listen(({ abort }) => {
+                if (abort) alert('Aborted'); // ✅ Valid
+            });
+
+            // send same message as received
+            encodeContext.send({ junk: 'xxx' }); // ❌ Bad & should be red
+            encodeContext.send({ progress: 0.5 }); //  ✅ Valid
+
+            // send or listen different message
+            encodeContext.withMessage('decode').listen(() => {}); // ✅ Valid
+            encodeContext.withMessage('decode').send({ file: null }); // ✅ Valid
+            encodeContext.withMessage('decode').send({ junk: 'xxx' }); // ❌ Bad & should be red
+            encodeContext.withMessage('junk'); // ❌ Bad & should be red
+
+            return { bitmap: await createImageBitmap(file), progress: 1.0 }; // should have all possible combinations for strong typing
+        },
+    );
+
+    // another responder for demo purposes
+    decode = this.create('decode', async ({ bitmap }) => {
+        return { file: new File([], 'test') };
+    });
+}
+
+export const workerDialog = new WorkerDialog(self, new Responders(), 'Worker');
+
+/////
+
+// import type { workerDialog } from './worker';
+
+const mainDialog = new WorkerDialog(self, {} as typeof workerDialog.responders, 'Main');
+
+mainDialog
+    .withMessage('encode')
+    .fetch(
+        {
+            file: new File([], 'test'), // ✅ Valid
+            junk: 'xxx', // ❌ Bad & should be red
+        },
+        (encodeContext) => {
+            // Listen same message, partial data update
+            encodeContext.listen((data) => {
+                console.log(data.progress); // ✅ Valid
+                console.log(data.junk); // ❌ Bad & should be red
+            });
+
+            // Listen or send other message
+            encodeContext.withMessage('decode').listen((data, decodeContext) => {});
+            encodeContext.withMessage('decode').send({ bitmap: null }); // ✅ Valid
+            encodeContext.withMessage('decode').send({ junk: 'xxx' }); // ❌❌❌ Bad & should be red, broken
+
+            // Send abort
+            encodeContext.send({ abort: true }); // ✅ Valid
+        },
+    )
+    .then((result) => {
+        console.log(result.bitmap); // ✅ Valid
+        console.log(result.junk); // ❌ Bad & should be red
+    });

package/dist/cache.d.ts

@@ -0,0 +1,119 @@
+export type MaybePromise<T> = T | Promise<T>;
+export declare const shallowCompare: (prev: any, next: any) => boolean;
+export declare const equal: (prev: any, next: any) => boolean;
+export declare const ANY: unique symbol;
+export declare function createTracker<Dep = any>(whenDifferent: (next: Dep, prev?: Dep) => any, shallow?: boolean): (dependency: Dep) => Dep | false;
+/**
+ * https://github.com/futpib/deep-weak-map
+ * https://github.com/fregante/many-keys-map
+ * https://github.com/fregante/many-keys-weakmap
+ * https://github.com/sindresorhus/memoize?tab=readme-ov-file#example-multiple-non-serializable-arguments
+ *
+ * ```ts
+ * const memoized = memo(
+ *   (file, options, ...args) => { ... },
+ *   {
+ *     key: (file, options, ...args) => [file, JSON.stringify(options), ...args],
+ *     invalidate: (bitmap) => !bitmap.width,
+ *     dispose: (bitmap) => bitmap.close(),
+ *   }
+ * );
+ * ```
+ */
+export declare function memo<Key extends any[], Val, SerializedKey extends any[] = Key>(fn: (...args: Key) => MaybePromise<Val>, { key, invalidate, dispose, }?: {
+    key?: (...key: Key) => SerializedKey;
+    invalidate?: (prev: Val, ...key: SerializedKey) => boolean;
+    dispose?: (prev: Val, ...key: SerializedKey) => void;
+}): {
+    (...args: Key): Promise<{
+        value?: Val;
+        hit: boolean;
+    }>;
+    clear: (...condition: Key | any[]) => void;
+    size: () => number;
+};
+/**
+ * Allows to memoize values by key and invalidate them based on the previous value.
+ *
+ * This makes possible to implement various one-off and subsequent transformations.
+ *
+ * 1. `write`: Transform value BEFORE writing to cache, called only once if cache IS NOT present or IS NOT valid
+ * 2. `read`: Transform value AFTER it's read from cache, always called if cache IS valid, keep in mind this transform is applied on top of BEFORE
+ *
+ * Both should return same type or null.
+ *
+ * If `newValue` is null, old is returned, and no cache is set.
+ *
+ * ```ts
+ * class InputCache extends TypedCache<string, ImageBitmap> {
+ *     dispose(bitmap: ImageBitmap, key: string) {
+ *         bitmap.close();
+ *     }
+ * }
+ *
+ * const cache = new InputCache('input');
+ *
+ * // Cache provided OffscreenCanvas by name and create context once per canvas
+ *
+ * class CanvasCache extends TypedCache<string, OffscreenCanvas> {
+ *     protected write(key: string, canvas: OffscreenCanvas): OffscreenCanvas {
+ *         const canvas = newValue.getContext('2d');
+ *         canvas.ctx = canvas;
+ *         return canvas;
+ *     }
+ * }
+ *
+ * // Transfer control to offscreen canvas and track removal of original
+ * // When called again, always return null, because canvas is handed to worker, and never returned to main
+ *
+ * class CanvasCache extends TypedCache<HTMLCanvasElement, OffscreenCanvas> {
+ *
+ *     protected write(canvas: HTMLCanvasElement): OffscreenCanvas {
+ *         canvas.addEventListener(
+ *             'remove',
+ *             function listener() {
+ *                 console.log('Removing canvas from cache', key);
+ *                 this.delete(canvas);
+ *                 key.removeEventListener('remove', listener);
+ *             },
+ *         );
+ *         return canvas.transferControlToOffscreen();
+ *     }
+ *
+ *     protected read() {
+ *         return null;
+ *     }
+ * }
+ *
+ * // Create bitmap from file and check if was used, return null if used
+ * // Since bitmaps are also cached in worker, used bitmaps are not sent
+ *
+ * class BitmapCache extends TypedCache<File, ImageBitmap, File> {
+ *     protected async write(file: File): Promise<ImageBitmap> {
+ *         return await createImageBitmap(file);
+ *     }
+ *
+ *     protected read(bitmap: ImageBitmap): Promise<ImageBitmap> | ImageBitmap {
+ *         if (!bitmap.width) return null;
+ *         return bitmap;
+ *     }
+ * }
+ *
+ * ```
+ */
+export declare abstract class TransformerMap<Key, Val = Key> extends Map<Key, Val> {
+    protected readonly name: string;
+    constructor(name: string);
+    protected write(key: Key, newValue?: Val, oldValue?: Val): MaybePromise<Val>;
+    protected read(oldValue: Val, key: Key): MaybePromise<Val>;
+    delete(key: Key): boolean;
+    /**
+     * Do something with the value and key before removing it from cache
+     * For example, close a file or a bitmap
+     */
+    protected dispose(value: Val, key: Key): void;
+    clear(): void;
+    set(key: Key, value: Val): this;
+    memo(key: Key, newValue?: Val): Promise<Val>;
+}
+//# sourceMappingURL=cache.d.ts.map

package/dist/cache.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"cache.d.ts","sourceRoot":"","sources":["../src/cache.ts"],"names":[],"mappings":"AAEA,MAAM,MAAM,YAAY,CAAC,CAAC,IAAI,CAAC,GAAG,OAAO,CAAC,CAAC,CAAC,CAAC;AAE7C,eAAO,MAAM,cAAc,GAAI,MAAM,GAAG,EAAE,MAAM,GAAG,KAAG,OACuD,CAAC;AAE9G,eAAO,MAAM,KAAK,GAAI,MAAM,GAAG,EAAE,MAAM,GAAG,KAAG,OAAwB,CAAC;AAGtE,eAAO,MAAM,GAAG,EAAE,OAAO,MAAoB,CAAC;AAE9C,wBAAgB,aAAa,CAAC,GAAG,GAAG,GAAG,EAAE,aAAa,EAAE,CAAC,IAAI,EAAE,GAAG,EAAE,IAAI,CAAC,EAAE,GAAG,KAAK,GAAG,EAAE,OAAO,UAAQ,IAK3E,YAAY,GAAG,KAAG,GAAG,GAAG,KAAK,CAgBxD;AAED;;;;;;;;;;;;;;;;GAgBG;AACH,wBAAgB,IAAI,CAAC,GAAG,SAAS,GAAG,EAAE,EAAE,GAAG,EAAE,aAAa,SAAS,GAAG,EAAE,GAAG,GAAG,EAC1E,EAAE,EAAE,CAAC,GAAG,IAAI,EAAE,GAAG,KAAK,YAAY,CAAC,GAAG,CAAC,EACvC,EACI,GAAgD,EAChD,UAAU,EACV,OAAO,GACV,GAAE;IACC,GAAG,CAAC,EAAE,CAAC,GAAG,GAAG,EAAE,GAAG,KAAK,aAAa,CAAC;IACrC,UAAU,CAAC,EAAE,CAAC,IAAI,EAAE,GAAG,EAAE,GAAG,GAAG,EAAE,aAAa,KAAK,OAAO,CAAC;IAC3D,OAAO,CAAC,EAAE,CAAC,IAAI,EAAE,GAAG,EAAE,GAAG,GAAG,EAAE,aAAa,KAAK,IAAI,CAAC;CACnD,GACP;IACC,CAAC,GAAG,IAAI,EAAE,GAAG,GAAG,OAAO,CAAC;QACpB,KAAK,CAAC,EAAE,GAAG,CAAC;QACZ,GAAG,EAAE,OAAO,CAAC;KAChB,CAAC,CAAC;IACH,KAAK,EAAE,CAAC,GAAG,SAAS,EAAE,GAAG,GAAG,GAAG,EAAE,KAAK,IAAI,CAAC;IAC3C,IAAI,EAAE,MAAM,MAAM,CAAC;CACtB,CA+CA;AAED;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAoEG;AACH,8BAAsB,cAAc,CAAC,GAAG,EAAE,GAAG,GAAG,GAAG,CAAE,SAAQ,GAAG,CAAC,GAAG,EAAE,GAAG,CAAC;IAC1D,SAAS,CAAC,QAAQ,CAAC,IAAI,EAAE,MAAM;gBAAZ,IAAI,EAAE,MAAM;IAK3C,SAAS,CAAC,KAAK,CAAC,GAAG,EAAE,GAAG,EAAE,QAAQ,CAAC,EAAE,GAAG,EAAE,QAAQ,CAAC,EAAE,GAAG,GAAG,YAAY,CAAC,GAAG,CAAC;IAI5E,SAAS,CAAC,IAAI,CAAC,QAAQ,EAAE,GAAG,EAAE,GAAG,EAAE,GAAG,GAAG,YAAY,CAAC,GAAG,CAAC;IAI1D,MAAM,CAAC,GAAG,EAAE,GAAG,GAAG,OAAO;IAQzB;;;OAGG;IACH,SAAS,CAAC,OAAO,CAAC,KAAK,EAAE,GAAG,EAAE,GAAG,EAAE,GAAG,GAAG,IAAI;IAE7C,KAAK,IAAI,IAAI;IAMb,GAAG,CAAC,GAAG,EAAE,GAAG,EAAE,KAAK,EAAE,GAAG,GAAG,IAAI;IAIzB,IAAI,CAAC,GAAG,EAAE,GAAG,EAAE,QAAQ,CAAC,EAAE,GAAG,GAAG,OAAO,CAAC,GAAG,CAAC;CAkBrD"}

package/dist/cache.js

@@ -0,0 +1,106 @@
+import ManyKeysMap from "many-keys-map";
+const shallowCompare = (prev, next) => Array.from(/* @__PURE__ */ new Set([...Object.keys(prev), ...Object.keys(next)])).every((key) => prev[key] === next[key]);
+const equal = (prev, next) => prev === next;
+const UNUSED = Symbol("UNUSED");
+const ANY = Symbol("*");
+function createTracker(whenDifferent, shallow = false) {
+  let lastDependency = UNUSED;
+  const comparator = shallow ? shallowCompare : equal;
+  return function tracker(dependency) {
+    if (lastDependency !== UNUSED && comparator(lastDependency, dependency)) {
+      return false;
+    }
+    const res = whenDifferent(dependency, lastDependency === UNUSED ? void 0 : lastDependency) || true;
+    lastDependency = dependency;
+    return res;
+  };
+}
+function memo(fn, {
+  key = (...k) => k,
+  invalidate,
+  dispose
+} = {}) {
+  const map = new ManyKeysMap();
+  const clear = (...condition) => {
+    if (!condition?.length) {
+      map.forEach((value, serializedKey) => {
+        dispose?.(value, ...serializedKey);
+      });
+      map.clear();
+      return;
+    }
+    const keyToClear = key(...condition);
+    map.forEach((value, serializedKey) => {
+      if (!serializedKey.every((kk, i) => keyToClear[i] === ANY || kk === keyToClear[i])) return;
+      dispose?.(value, ...serializedKey);
+      map.delete(serializedKey);
+    });
+  };
+  const size = () => map.size;
+  async function memoized(...args) {
+    const k = key(...args);
+    const has = map.has(k);
+    const old = map.get(k);
+    if (has && !invalidate?.(old, ...k)) {
+      return { value: map.get(k), hit: true };
+    }
+    const value = await fn(...args);
+    map.set(k, value);
+    return { hit: false, value };
+  }
+  memoized.clear = clear;
+  memoized.size = size;
+  return memoized;
+}
+class TransformerMap extends Map {
+  constructor(name) {
+    super();
+    this.name = name;
+  }
+  write(key, newValue, oldValue) {
+    return newValue;
+  }
+  read(oldValue, key) {
+    return oldValue;
+  }
+  delete(key) {
+    const val = this.get(key);
+    const has = typeof val !== "undefined";
+    if (has) this.dispose(val, key);
+    super.delete(key);
+    return has;
+  }
+  /**
+   * Do something with the value and key before removing it from cache
+   * For example, close a file or a bitmap
+   */
+  dispose(value, key) {
+  }
+  clear() {
+    console.log("CLEAR cache", this.name);
+    this.forEach(this.dispose);
+    super.clear();
+  }
+  set(key, value) {
+    throw new Error("Use memo() method instead");
+  }
+  async memo(key, newValue) {
+    const oldValue = this.get(key);
+    if (!!oldValue && (!newValue || newValue === oldValue)) {
+      return this.read?.(oldValue, key);
+    }
+    if (this.has(key)) this.delete(key);
+    const value = await this.write(key, newValue, oldValue);
+    super.set(key, value);
+    return value;
+  }
+}
+export {
+  ANY,
+  TransformerMap,
+  createTracker,
+  equal,
+  memo,
+  shallowCompare
+};
+//# sourceMappingURL=cache.js.map

package/dist/cache.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"cache.js","sources":["../src/cache.ts"],"sourcesContent":["import ManyKeysMap from 'many-keys-map';\n\nexport type MaybePromise<T> = T | Promise<T>;\n\nexport const shallowCompare = (prev: any, next: any): boolean =>\n    Array.from(new Set([...Object.keys(prev), ...Object.keys(next)])).every((key) => prev[key] === next[key]);\n\nexport const equal = (prev: any, next: any): boolean => prev === next;\n\nconst UNUSED = Symbol('UNUSED');\nexport const ANY: unique symbol = Symbol('*');\n\nexport function createTracker<Dep = any>(whenDifferent: (next: Dep, prev?: Dep) => any, shallow = false) {\n    let lastDependency: Dep = UNUSED as any;\n\n    const comparator = shallow ? shallowCompare : equal;\n\n    return function tracker(dependency: Dep): Dep | false {\n        // console.log('Tracker', lastDependency, dependency);\n\n        if (lastDependency !== UNUSED && comparator(lastDependency, dependency)) {\n            // console.log('RETAINED cache', { lastDependency, dependency });\n            return false;\n        }\n\n        // console.log('INVALIDATED cache', {lastDependency, dependency});\n\n        const res = whenDifferent(dependency, lastDependency === UNUSED ? undefined : lastDependency) || true;\n\n        lastDependency = dependency;\n\n        return res;\n    };\n}\n\n/**\n * https://github.com/futpib/deep-weak-map\n * https://github.com/fregante/many-keys-map\n * https://github.com/fregante/many-keys-weakmap\n * https://github.com/sindresorhus/memoize?tab=readme-ov-file#example-multiple-non-serializable-arguments\n *\n * ```ts\n * const memoized = memo(\n *   (file, options, ...args) => { ... },\n *   {\n *     key: (file, options, ...args) => [file, JSON.stringify(options), ...args],\n *     invalidate: (bitmap) => !bitmap.width,\n *     dispose: (bitmap) => bitmap.close(),\n *   }\n * );\n * ```\n */\nexport function memo<Key extends any[], Val, SerializedKey extends any[] = Key>(\n    fn: (...args: Key) => MaybePromise<Val>,\n    {\n        key = (...k: Key) => k as never as SerializedKey,\n        invalidate,\n        dispose,\n    }: {\n        key?: (...key: Key) => SerializedKey;\n        invalidate?: (prev: Val, ...key: SerializedKey) => boolean;\n        dispose?: (prev: Val, ...key: SerializedKey) => void;\n    } = {},\n): {\n    (...args: Key): Promise<{\n        value?: Val;\n        hit: boolean;\n    }>;\n    clear: (...condition: Key | any[]) => void;\n    size: () => number;\n} {\n    const map = new ManyKeysMap<SerializedKey, Val>();\n\n    //TODO Extend ManyKeysMap\n    const clear = (...condition: Key | any[]) => {\n        if (!condition?.length) {\n            map.forEach((value, serializedKey) => {\n                dispose?.(value, ...serializedKey);\n            });\n            map.clear();\n            return;\n        }\n\n        const keyToClear = key(...(condition as any));\n\n        map.forEach((value, serializedKey) => {\n            if (!serializedKey.every((kk, i) => keyToClear[i] === ANY || kk === keyToClear[i])) return;\n            dispose?.(value, ...serializedKey);\n            map.delete(serializedKey);\n        });\n    };\n\n    const size = () => map.size;\n\n    async function memoized(...args: Key) {\n        const k = key(...args);\n\n        const has = map.has(k);\n        const old = map.get(k);\n\n        if (has && !invalidate?.(old as never as Val, ...k)) {\n            return { value: map.get(k), hit: true };\n        }\n\n        const value = await fn(...args);\n\n        map.set(k, value);\n\n        return { hit: false, value };\n    }\n\n    memoized.clear = clear;\n    memoized.size = size;\n\n    //TODO return mimic-function(memorized, fn);\n\n    return memoized;\n}\n\n/**\n * Allows to memoize values by key and invalidate them based on the previous value.\n *\n * This makes possible to implement various one-off and subsequent transformations.\n *\n * 1. `write`: Transform value BEFORE writing to cache, called only once if cache IS NOT present or IS NOT valid\n * 2. `read`: Transform value AFTER it's read from cache, always called if cache IS valid, keep in mind this transform is applied on top of BEFORE\n *\n * Both should return same type or null.\n *\n * If `newValue` is null, old is returned, and no cache is set.\n *\n * ```ts\n * class InputCache extends TypedCache<string, ImageBitmap> {\n *     dispose(bitmap: ImageBitmap, key: string) {\n *         bitmap.close();\n *     }\n * }\n *\n * const cache = new InputCache('input');\n *\n * // Cache provided OffscreenCanvas by name and create context once per canvas\n *\n * class CanvasCache extends TypedCache<string, OffscreenCanvas> {\n *     protected write(key: string, canvas: OffscreenCanvas): OffscreenCanvas {\n *         const canvas = newValue.getContext('2d');\n *         canvas.ctx = canvas;\n *         return canvas;\n *     }\n * }\n *\n * // Transfer control to offscreen canvas and track removal of original\n * // When called again, always return null, because canvas is handed to worker, and never returned to main\n *\n * class CanvasCache extends TypedCache<HTMLCanvasElement, OffscreenCanvas> {\n *\n *     protected write(canvas: HTMLCanvasElement): OffscreenCanvas {\n *         canvas.addEventListener(\n *             'remove',\n *             function listener() {\n *                 console.log('Removing canvas from cache', key);\n *                 this.delete(canvas);\n *                 key.removeEventListener('remove', listener);\n *             },\n *         );\n *         return canvas.transferControlToOffscreen();\n *     }\n *\n *     protected read() {\n *         return null;\n *     }\n * }\n *\n * // Create bitmap from file and check if was used, return null if used\n * // Since bitmaps are also cached in worker, used bitmaps are not sent\n *\n * class BitmapCache extends TypedCache<File, ImageBitmap, File> {\n *     protected async write(file: File): Promise<ImageBitmap> {\n *         return await createImageBitmap(file);\n *     }\n *\n *     protected read(bitmap: ImageBitmap): Promise<ImageBitmap> | ImageBitmap {\n *         if (!bitmap.width) return null;\n *         return bitmap;\n *     }\n * }\n *\n * ```\n */\nexport abstract class TransformerMap<Key, Val = Key> extends Map<Key, Val> {\n    constructor(protected readonly name: string) {\n        // console.warn('CREATE cache', name);\n        super();\n    }\n\n    protected write(key: Key, newValue?: Val, oldValue?: Val): MaybePromise<Val> {\n        return newValue as Val;\n    }\n\n    protected read(oldValue: Val, key: Key): MaybePromise<Val> {\n        return oldValue;\n    }\n\n    delete(key: Key): boolean {\n        const val = this.get(key);\n        const has = typeof val !== 'undefined';\n        if (has) this.dispose(val, key);\n        super.delete(key);\n        return has;\n    }\n\n    /**\n     * Do something with the value and key before removing it from cache\n     * For example, close a file or a bitmap\n     */\n    protected dispose(value: Val, key: Key): void {}\n\n    clear(): void {\n        console.log('CLEAR cache', this.name);\n        this.forEach(this.dispose);\n        super.clear();\n    }\n\n    set(key: Key, value: Val): this {\n        throw new Error('Use memo() method instead');\n    }\n\n    async memo(key: Key, newValue?: Val): Promise<Val> {\n        const oldValue = this.get(key);\n\n        if (!!oldValue && (!newValue || newValue === oldValue)) {\n            // console.log('FROM cache', this.name, key, 'old value', oldValue);\n            return this.read?.(oldValue, key);\n        }\n\n        if (this.has(key)) this.delete(key);\n\n        const value = await this.write(key, newValue, oldValue);\n\n        super.set(key, value);\n\n        // console.log('INVALIDATED KEY cache', this.name, key, 'has', has, 'invalidate', invalidate, 'new value', value);\n\n        return value;\n    }\n}\n"],"names":[],"mappings":"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"}

package/dist/cache.test.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=cache.test.d.ts.map

package/dist/cache.test.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"cache.test.d.ts","sourceRoot":"","sources":["../src/cache.test.ts"],"names":[],"mappings":""}

package/dist/errors.d.ts

@@ -0,0 +1,2 @@
+export declare function catchErrors<T, E extends Error = Error>(promise: Promise<T>, errors?: E[]): Promise<any[] | (T | undefined)[]>;
+//# sourceMappingURL=errors.d.ts.map

package/dist/errors.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"errors.d.ts","sourceRoot":"","sources":["../src/errors.ts"],"names":[],"mappings":"AACA,wBAAgB,WAAW,CAAC,CAAC,EAAE,CAAC,SAAS,KAAK,GAAG,KAAK,EAClD,OAAO,EAAE,OAAO,CAAC,CAAC,CAAC,EACnB,MAAM,CAAC,EAAE,CAAC,EAAE,GACb,OAAO,CAAC,GAAG,EAAE,GAAG,CAAC,CAAC,GAAG,SAAS,CAAC,EAAE,CAAC,CAYpC"}

package/dist/errors.js

@@ -0,0 +1,15 @@
+function catchErrors(promise, errors) {
+  return promise.then((data) => [void 0, data]).catch((error) => {
+    if (!errors?.length) {
+      return [error];
+    }
+    if (errors.some((e) => e instanceof error)) {
+      return [error];
+    }
+    throw error;
+  });
+}
+export {
+  catchErrors
+};
+//# sourceMappingURL=errors.js.map

package/dist/errors.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"errors.js","sources":["../src/errors.ts"],"sourcesContent":["// @see https://www.youtube.com/watch?v=AdmGHwvgaVs\nexport function catchErrors<T, E extends Error = Error>(\n    promise: Promise<T>,\n    errors?: E[],\n): Promise<any[] | (T | undefined)[]> {\n    return promise\n        .then((data) => [undefined, data])\n        .catch((error) => {\n            if (!errors?.length) {\n                return [error];\n            }\n            if (errors.some((e) => e instanceof error)) {\n                return [error];\n            }\n            throw error;\n        });\n}\n"],"names":[],"mappings":"AACO,SAAS,YACZ,SACA,QACkC;AAClC,SAAO,QACF,KAAK,CAAC,SAAS,CAAC,QAAW,IAAI,CAAC,EAChC,MAAM,CAAC,UAAU;AACd,QAAI,CAAC,QAAQ,QAAQ;AACjB,aAAO,CAAC,KAAK;AAAA,IACjB;AACA,QAAI,OAAO,KAAK,CAAC,MAAM,aAAa,KAAK,GAAG;AACxC,aAAO,CAAC,KAAK;AAAA,IACjB;AACA,UAAM;AAAA,EACV,CAAC;AACT;"}

package/dist/files.d.ts

@@ -0,0 +1,4 @@
+export declare const downloadFile: (file: File) => Promise<void>;
+export declare const createFile: (text: any, filename?: string, type?: string) => Promise<File>;
+export declare const openFile: () => Promise<string>;
+//# sourceMappingURL=files.d.ts.map

package/dist/files.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"files.d.ts","sourceRoot":"","sources":["../src/files.ts"],"names":[],"mappings":"AAAA,eAAO,MAAM,YAAY,GAAU,MAAM,IAAI,KAAG,OAAO,CAAC,IAAI,CAM3D,CAAC;AAEF,eAAO,MAAM,UAAU,GAAU,MAAM,GAAG,EAAE,iBAAsB,EAAE,aAAyB,KAAG,OAAO,CAAC,IAAI,CAE3G,CAAC;AAEF,eAAO,MAAM,QAAQ,QAAO,OAAO,CAAC,MAAM,CAgBpC,CAAC"}

package/dist/files.js

@@ -0,0 +1,28 @@
+const downloadFile = async (file) => {
+  const { saveAs } = require("file-saver");
+  return saveAs(file, file.name);
+};
+const createFile = async (text, filename = "file.json", type = "application/json") => {
+  return new File([new Blob([text], { type })], filename);
+};
+const openFile = () => new Promise((res, rej) => {
+  const input = document.createElement("input");
+  input.type = "file";
+  input.addEventListener("change", function readFile(e) {
+    input.removeEventListener("change", readFile);
+    const [file] = e.target.files;
+    if (!file) return;
+    const reader = new FileReader();
+    reader.onload = (e2) => res(e2.target?.result);
+    reader.onerror = rej;
+    reader.onabort = rej;
+    reader.readAsText(file);
+  });
+  input.click();
+});
+export {
+  createFile,
+  downloadFile,
+  openFile
+};
+//# sourceMappingURL=files.js.map

package/dist/files.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"files.js","sources":["../src/files.ts"],"sourcesContent":["export const downloadFile = async (file: File): Promise<void> => {\n    //FIXME https://github.com/eligrey/FileSaver.js/issues/471\n    const { saveAs } = require('file-saver');\n\n    //FIXME https://github.com/eligrey/FileSaver.js/issues/731\n    return saveAs(file, file.name);\n};\n\nexport const createFile = async (text: any, filename = 'file.json', type = 'application/json'): Promise<File> => {\n    return new File([new Blob([text], { type })], filename);\n};\n\nexport const openFile = (): Promise<string> =>\n    new Promise((res, rej) => {\n        const input = document.createElement('input');\n        input.type = 'file';\n        input.addEventListener('change', function readFile(e) {\n            input.removeEventListener('change', readFile);\n            // @ts-expect-error file is always there\n            const [file] = e.target.files;\n            if (!file) return;\n            const reader = new FileReader();\n            reader.onload = (e) => res(e.target?.result as string);\n            reader.onerror = rej;\n            reader.onabort = rej;\n            reader.readAsText(file);\n        });\n        input.click();\n    });\n"],"names":["e"],"mappings":"AAAO,MAAM,eAAe,OAAO,SAA8B;AAE7D,QAAM,EAAE,OAAA,IAAW,QAAQ,YAAY;AAGvC,SAAO,OAAO,MAAM,KAAK,IAAI;AACjC;AAEO,MAAM,aAAa,OAAO,MAAW,WAAW,aAAa,OAAO,uBAAsC;AAC7G,SAAO,IAAI,KAAK,CAAC,IAAI,KAAK,CAAC,IAAI,GAAG,EAAE,KAAA,CAAM,CAAC,GAAG,QAAQ;AAC1D;AAEO,MAAM,WAAW,MACpB,IAAI,QAAQ,CAAC,KAAK,QAAQ;AACtB,QAAM,QAAQ,SAAS,cAAc,OAAO;AAC5C,QAAM,OAAO;AACb,QAAM,iBAAiB,UAAU,SAAS,SAAS,GAAG;AAClD,UAAM,oBAAoB,UAAU,QAAQ;AAE5C,UAAM,CAAC,IAAI,IAAI,EAAE,OAAO;AACxB,QAAI,CAAC,KAAM;AACX,UAAM,SAAS,IAAI,WAAA;AACnB,WAAO,SAAS,CAACA,OAAM,IAAIA,GAAE,QAAQ,MAAgB;AACrD,WAAO,UAAU;AACjB,WAAO,UAAU;AACjB,WAAO,WAAW,IAAI;AAAA,EAC1B,CAAC;AACD,QAAM,MAAA;AACV,CAAC;"}

package/dist/index.d.ts

@@ -0,0 +1,10 @@
+export * from './cache';
+export * from './errors';
+export * from './files';
+export * from './ls';
+export * from './measure';
+export * from './mutex';
+export * from './worker';
+export * from './workerUtils';
+export * from './wrpc';
+//# sourceMappingURL=index.d.ts.map