proxy-facades 1.0.0

package/dev_generateEsRuntimeBehaviourCheckerCode.ts

@@ -0,0 +1,85 @@
+// ****  See the function common.ts#checkEsRuntimeBehaviour ***
+
+// Array:
+outputExpecterCode(["a"], (v) => v.at(0))
+outputExpecterCode(["a", "b", "c"], (v) => v.concat("d","e","f"));
+outputExpecterCode(["a", "b", "c"], (v) => v.map(x => read(x)));
+outputExpecterCode(["a", "b", "c"], (v) => v.forEach(x => read(x)));
+outputExpecterCode(["a", "b", "c"], (v) => v.join(","));
+//outputExpecterCode(["a", "b", "c"], (v) => v.keys());
+//outputExpecterCode(["a", "b", "c"], (v) => v.values());
+outputExpecterCode(["a", "b", "c","d"], (v) => v.slice(1,3));
+outputExpecterCode(["a", "b", "c"], (v) => v.some( x => x ==="a"));
+outputExpecterCode(["a", "b", "c"], (v) => v.filter(x => x === "a"));
+outputExpecterCode(["a", "b", "c"], (v) => v.find(x => x === "a"));
+//outputExpecterCode(["a", "b", "c"], (v) => v.entries());
+outputExpecterCode(["a", "b", "c"], (v) => v.every(x => x ==="a"));
+outputExpecterCode(["a", "b", "c"], (v) => v.findIndex(x => x ==="a"));
+outputExpecterCode(["a", "b", "c"], (v) => v.includes("b",1));
+outputExpecterCode(["a", "b", "c"], (v) => v.indexOf("b", 1));
+outputExpecterCode(["a","b","c"], (v) => v[Symbol.iterator]().next());
+outputExpecterCode(["a", "b", "b"], (v) => v.lastIndexOf("b", 1));
+outputExpecterCode(["a", "b", "b"], (v) => v.reduce((p, c ) => p + c));
+outputExpecterCode(["a", "b", "b"], (v) => v.reduceRight((p, c) => p + c));
+outputExpecterCode(["a", "b", "b"], (v) => v.toLocaleString());
+outputExpecterCode(["a", "b", "b"], (v) => v.toString());
+outputExpecterCode(["a", "b", "c"], (v) => v.unshift("_a","_b"));
+outputExpecterCode(["a", "b", "c","d"], v => v.splice(1,2, "newB", "newC", "newX"))
+outputExpecterCode(["a", "b", "c","d"], v => v.copyWithin(3, 1,3))
+outputExpecterCode(["a", "b", "c","d"], v => v.reverse());
+
+// Iterator
+console.log("if([].values().forEach) { // Runtime supports these iterator functions like forEach, filter, .... ")
+outputExpecterCode(() => ["a", "b", "c"][Symbol.iterator](), it => it.forEach(x => x))
+outputExpecterCode(() => ["a", "b", "c"][Symbol.iterator](), it => it.filter(x => x === "b"))
+outputExpecterCode(() => ["a", "b", "c"][Symbol.iterator](), it => it.take(2));
+outputExpecterCode(() => ["a", "b", "c"][Symbol.iterator](), it => it.toArray());
+console.log("}")
+
+// Set:
+//outputExpecterCode(new Set<string>(["a","b","c"]), v => v.forEach(i => read(i))) // TypeError: Method Set.prototype.forEach called on incompatible receiver #<Set>
+//outputExpecterCode(new Set<string>(["a","b","c"]), v => v.intersection(new Set<string>(["b","c","e"]))) // TypeError: Method Set.prototype.intersection called on incompatible receiver #<Set>
+
+
+
+/**
+ *
+ */
+function outputExpecterCode<T extends object>(orig: T | (() => T), fn: (proxy: T) =>  void ) {
+    let origJS = JSON.stringify(orig);
+    if(typeof orig === "function") {
+        origJS = orig.toString().replace(/\s+/g," ").replace(/^\(\)=>/,"").toString()
+        orig = orig();
+    }
+    const usedFields = new Set<string | symbol>();
+    const proxy = new Proxy(orig, {
+        get(target: T, p: string | symbol, receiver: any): any {
+            usedFields.add(p)
+
+            if(p === "next") {
+                //@ts-ignore
+                return (...args: unknown[]) => target.next(...args); // .next() method must run on target, not on proxy
+            }
+
+            //@ts-ignore
+            return target[p];
+        }
+    })
+    read(fn(proxy));
+    console.log(`expectUsingMethodsOrFields(${origJS}, ${fnToString(fn)}, [${[...usedFields.values()].map(f => typeof f === "string"?`"${f}"`:`${f.toString().replace(/(^Symbol\()|(\)$)/g,"")}`). join(",")}])`)
+
+    function fnToString(fn: (...args: any[]) => unknown) {
+        return fn.toString().replace(/\s+/g," ").toString();
+    }
+}
+
+/**
+ * Just do something the runtime can't optimize away
+ * @param value
+ */
+function read(value: any) {
+    if( ("" + value) == "blaaxyxzzzsdf" ) {
+        throw new Error("should never get here")
+    }
+}
+

package/dist/mjs/RecordedReadOnProxiedObjectExt.d.ts

@@ -0,0 +1,22 @@
+import { EventHook, RecordedReadOnProxiedObject } from "./common";
+/**
+ * Offers a more convenient method: getAffectingChangeHooks
+ */
+export declare abstract class RecordedReadOnProxiedObjectExt extends RecordedReadOnProxiedObject {
+    /**
+     * @param listener
+     * @param trackOriginal
+     */
+    onAfterChange(listener: () => void, trackOriginal?: boolean): void;
+    /**
+     *
+     */
+    offAfterChange(listener: () => void): void;
+    /**
+     *
+     * @param target The target for which... This method might be called for multiple targets from different watchedproxyfacade layers or at last layer for the original unproxied object
+     * @returns the sets where to add/remove listeners by the onChange/offChange methods
+     */
+    getAffectingChangeHooks(target: object): EventHook[];
+}
+//# sourceMappingURL=RecordedReadOnProxiedObjectExt.d.ts.map

package/dist/mjs/RecordedReadOnProxiedObjectExt.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"RecordedReadOnProxiedObjectExt.d.ts","sourceRoot":"","sources":["../../RecordedReadOnProxiedObjectExt.ts"],"names":[],"mappings":"AAAA,OAAO,EAAiB,SAAS,EAAE,2BAA2B,EAAC,MAAM,UAAU,CAAC;AAKhF;;GAEG;AACH,8BAAsB,8BAA+B,SAAQ,2BAA2B;IAEpF;;;OAGG;IACH,aAAa,CAAC,QAAQ,EAAE,MAAM,IAAI,EAAE,aAAa,UAAQ;IAUzD;;OAEG;IACH,cAAc,CAAC,QAAQ,EAAE,MAAM,IAAI;IAKnC;;;;OAIG;IACH,uBAAuB,CAAC,MAAM,EAAE,MAAM,GAAG,SAAS,EAAE;CAGvD"}

package/dist/mjs/RecordedReadOnProxiedObjectExt.js

@@ -0,0 +1,37 @@
+import { RecordedReadOnProxiedObject } from "./common";
+import { installChangeTracker } from "./origChangeTracking";
+import { isProxyForAFacade } from "./proxyFacade";
+/**
+ * Offers a more convenient method: getAffectingChangeHooks
+ */
+export class RecordedReadOnProxiedObjectExt extends RecordedReadOnProxiedObject {
+    /**
+     * @param listener
+     * @param trackOriginal
+     */
+    onAfterChange(listener, trackOriginal = false) {
+        this.getAffectingChangeHooks(this.proxyHandler.proxy).forEach(eventHook => eventHook.afterListeners.add(listener));
+        if (trackOriginal) {
+            if (!isProxyForAFacade(this.obj)) {
+                installChangeTracker(this.obj);
+            }
+            this.getAffectingChangeHooks(this.obj).forEach(eventHook => eventHook.afterListeners.add(listener));
+        }
+    }
+    /**
+     *
+     */
+    offAfterChange(listener) {
+        this.getAffectingChangeHooks(this.obj).forEach(eventHook => eventHook.afterListeners.delete(listener));
+        this.getAffectingChangeHooks(this.proxyHandler.proxy).forEach(eventHook => eventHook.afterListeners.delete(listener));
+    }
+    /**
+     *
+     * @param target The target for which... This method might be called for multiple targets from different watchedproxyfacade layers or at last layer for the original unproxied object
+     * @returns the sets where to add/remove listeners by the onChange/offChange methods
+     */
+    getAffectingChangeHooks(target) {
+        throw new Error("TODO");
+    }
+}
+//# sourceMappingURL=RecordedReadOnProxiedObjectExt.js.map

package/dist/mjs/RecordedReadOnProxiedObjectExt.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"RecordedReadOnProxiedObjectExt.js","sourceRoot":"","sources":["../../RecordedReadOnProxiedObjectExt.ts"],"names":[],"mappings":"AAAA,OAAO,EAA4B,2BAA2B,EAAC,MAAM,UAAU,CAAC;AAChF,OAAO,EAAC,oBAAoB,EAAC,MAAM,sBAAsB,CAAC;AAC1D,OAAO,EAAC,iBAAiB,EAAC,MAAM,eAAe,CAAC;AAGhD;;GAEG;AACH,MAAM,OAAgB,8BAA+B,SAAQ,2BAA2B;IAEpF;;;OAGG;IACH,aAAa,CAAC,QAAoB,EAAE,aAAa,GAAG,KAAK;QACrD,IAAI,CAAC,uBAAuB,CAAC,IAAI,CAAC,YAAY,CAAC,KAAK,CAAC,CAAC,OAAO,CAAC,SAAS,CAAC,EAAE,CAAC,SAAS,CAAC,cAAc,CAAC,GAAG,CAAC,QAAQ,CAAC,CAAC,CAAC;QACnH,IAAI,aAAa,EAAE,CAAC;YAChB,IAAG,CAAC,iBAAiB,CAAC,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC;gBAC9B,oBAAoB,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;YACnC,CAAC;YACD,IAAI,CAAC,uBAAuB,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC,OAAO,CAAC,SAAS,CAAC,EAAE,CAAC,SAAS,CAAC,cAAc,CAAC,GAAG,CAAC,QAAQ,CAAC,CAAC,CAAC;QACxG,CAAC;IACL,CAAC;IAED;;OAEG;IACH,cAAc,CAAC,QAAoB;QAC/B,IAAI,CAAC,uBAAuB,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC,OAAO,CAAC,SAAS,CAAC,EAAE,CAAC,SAAS,CAAC,cAAc,CAAC,MAAM,CAAC,QAAQ,CAAC,CAAC,CAAC;QACvG,IAAI,CAAC,uBAAuB,CAAC,IAAI,CAAC,YAAY,CAAC,KAAK,CAAC,CAAC,OAAO,CAAC,SAAS,CAAC,EAAE,CAAC,SAAS,CAAC,cAAc,CAAC,MAAM,CAAC,QAAQ,CAAC,CAAC,CAAC;IAC1H,CAAC;IAED;;;;OAIG;IACH,uBAAuB,CAAC,MAAc;QAClC,MAAM,IAAI,KAAK,CAAC,MAAM,CAAC,CAAA;IAC3B,CAAC;CACJ"}

package/dist/mjs/Util.d.ts

@@ -0,0 +1,85 @@
+import { Clazz } from "./common";
+export declare function throwError(e: string | Error): void;
+export declare function reThrowWithHint(e: unknown, hint: string): void;
+export declare function isObject(value: unknown): value is object;
+/**
+ * A Map<K, Set<V>>. But automatically add a new Set if needed
+ */
+export declare class MapSet<K, V> {
+    map: Map<K, Set<V>>;
+    add(key: K, value: V): void;
+    delete(key: K, value: V): void;
+    get(key: K): Set<V> | undefined;
+    /**
+     * @param key
+     * @return the set for the specified key (an empty one will be created if needed) on which you should call `add` or `delete` **immediately**, so no empty set is left there consuming memory.
+     * It is automatically cleaned up after the last delete
+     */
+    get4use(key: K): Set<V>;
+}
+/**
+ * This Map does not return empty values, so there's always a default value created
+ */
+export declare abstract class DefaultMap<K, V> extends Map<K, V> {
+    abstract createDefaultValue(): V;
+    get(key: K): V;
+}
+/**
+ *
+ * @param createDefaultValueFn
+ * @returns a Map that creates and inserts a default value when that value does not exist. So the #get method always returns something.
+ */
+export declare function newDefaultMap<K, V>(createDefaultValueFn: () => V): DefaultMap<K, V>;
+/**
+ * A WeakMap<K, Set<V>>. But automatically add a new Set if needed
+ */
+export declare class WeakMapSet<K, V> extends MapSet<K, V> {
+    map: WeakMap<K, Set<V>>;
+}
+export declare function arraysAreEqualsByPredicateFn<A, B>(a: A[], b: B[], equalsFn: (a: A, b: B) => boolean): boolean;
+export type PromiseState<T> = {
+    state: "pending";
+    promise: Promise<T>;
+} | {
+    state: "resolved";
+    resolvedValue: T;
+} | {
+    state: "rejected";
+    rejectReason: any;
+};
+type VisitReplaceContext = {
+    /**
+     * Not safely escaped. Should be used for diag only !
+     */
+    diagnosis_path?: string;
+    parentObject?: object;
+    key?: unknown;
+};
+/**
+ * Usage:
+ *  <pre><code>
+ *  const result = visitReplace(target, (value, visitChilds, context) => {
+ *      return value === 'needle' ? 'replaced' : visitChilds(value, context)
+ *  });
+ *  </code></pre>
+ *
+ * @param value
+ * @param visitor
+ * @param trackPath whether to pass on the context object. This hurts performance because the path is concatted every time, so use it only when needed. Setting this to "onError" re-executes the visitprelace with the concetxt when an error was thrown
+ */
+export declare function visitReplace<O>(value: O, visitor: (value: unknown, visitChilds: (value: unknown, context: VisitReplaceContext) => unknown, context: VisitReplaceContext) => unknown, trackPath?: boolean | "onError"): O;
+/**
+ * Just do something the runtime can't optimize away
+ * @param value
+ */
+export declare function read(value: any): void;
+export declare function arraysAreShallowlyEqual(a: unknown[], b: unknown[]): boolean;
+/**
+ * Like arraysAreShallowlyEqual but this time for an array of entries (tuple of 2 values) like from Map#entries()
+ * @param a
+ * @param b
+ */
+export declare function arraysWithEntriesAreShallowlyEqual(a: Array<[unknown, unknown]>, b: Array<[unknown, unknown]>): boolean;
+export declare function classIsSubclassOf(clazz: Clazz, superClass: Clazz): boolean;
+export {};
+//# sourceMappingURL=Util.d.ts.map

package/dist/mjs/Util.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"Util.d.ts","sourceRoot":"","sources":["../../Util.ts"],"names":[],"mappings":"AAAA,OAAO,EAAC,KAAK,EAAC,MAAM,UAAU,CAAC;AAE/B,wBAAgB,UAAU,CAAC,CAAC,EAAE,MAAM,GAAG,KAAK,QAK3C;AAED,wBAAgB,eAAe,CAAC,CAAC,EAAE,OAAO,EAAE,IAAI,EAAE,MAAM,QAUvD;AAED,wBAAgB,QAAQ,CAAC,KAAK,EAAE,OAAO,mBAEtC;AAED;;GAEG;AACH,qBAAa,MAAM,CAAC,CAAC,EAAE,CAAC;IACpB,GAAG,iBAAuB;IAE1B,GAAG,CAAC,GAAG,EAAE,CAAC,EAAE,KAAK,EAAE,CAAC;IASpB,MAAM,CAAC,GAAG,EAAE,CAAC,EAAE,KAAK,EAAE,CAAC;IAUvB,GAAG,CAAC,GAAG,EAAE,CAAC;IAIV;;;;OAIG;IACH,OAAO,CAAC,GAAG,EAAE,CAAC;CAuBjB;AAED;;GAEG;AACH,8BAAsB,UAAU,CAAC,CAAC,EAAE,CAAC,CAAE,SAAQ,GAAG,CAAC,CAAC,EAAC,CAAC,CAAC;IACnD,QAAQ,CAAC,kBAAkB,IAAI,CAAC;IAEhC,GAAG,CAAC,GAAG,EAAE,CAAC,GAAG,CAAC;CAQjB;AAED;;;;GAIG;AACH,wBAAgB,aAAa,CAAC,CAAC,EAAC,CAAC,EAAE,oBAAoB,EAAE,MAAM,CAAC,GAAG,UAAU,CAAC,CAAC,EAAE,CAAC,CAAC,CAMlF;AAED;;GAEG;AACH,qBAAa,UAAU,CAAC,CAAC,EAAE,CAAC,CAAE,SAAQ,MAAM,CAAC,CAAC,EAAE,CAAC,CAAC;IAE9C,GAAG,qBAA4B;CAClC;AAED,wBAAgB,4BAA4B,CAAC,CAAC,EAAE,CAAC,EAAE,CAAC,EAAE,CAAC,EAAE,EAAE,CAAC,EAAE,CAAC,EAAE,EAAE,QAAQ,EAAE,CAAC,CAAC,EAAE,CAAC,EAAC,CAAC,EAAE,CAAC,KAAK,OAAO,WAUlG;AACD,MAAM,MAAM,YAAY,CAAC,CAAC,IAAI;IAAC,KAAK,EAAE,SAAS,CAAC;IAAC,OAAO,EAAE,OAAO,CAAC,CAAC,CAAC,CAAA;CAAC,GAAG;IAAC,KAAK,EAAE,UAAU,CAAC;IAAC,aAAa,EAAE,CAAC,CAAA;CAAC,GAAG;IAAC,KAAK,EAAE,UAAU,CAAC;IAAC,YAAY,EAAE,GAAG,CAAA;CAAC,CAAC;AAGvJ,KAAK,mBAAmB,GAAG;IACvB;;OAEG;IACH,cAAc,CAAC,EAAE,MAAM,CAAA;IAEvB,YAAY,CAAC,EAAE,MAAM,CAAA;IACrB,GAAG,CAAC,EAAE,OAAO,CAAA;CAChB,CAAA;AASD;;;;;;;;;;;GAWG;AACH,wBAAgB,YAAY,CAAC,CAAC,EAAE,KAAK,EAAE,CAAC,EAAE,OAAO,EAAE,CAAC,KAAK,EAAE,OAAO,EAAE,WAAW,EAAE,CAAC,KAAK,EAAE,OAAO,EAAE,OAAO,EAAE,mBAAmB,KAAK,OAAO,EAAE,OAAO,EAAE,mBAAmB,KAAK,OAAO,EAAG,SAAS,GAAE,OAAO,GAAG,SAAiB,GAAG,CAAC,CAqChO;AAED;;;GAGG;AACH,wBAAgB,IAAI,CAAC,KAAK,EAAE,GAAG,QAI9B;AAED,wBAAgB,uBAAuB,CAAC,CAAC,EAAE,OAAO,EAAE,EAAE,CAAC,EAAE,OAAO,EAAE,WAUjE;AAED;;;;GAIG;AACH,wBAAgB,kCAAkC,CAAC,CAAC,EAAE,KAAK,CAAC,CAAC,OAAO,EAAE,OAAO,CAAC,CAAC,EAAE,CAAC,EAAE,KAAK,CAAC,CAAC,OAAO,EAAE,OAAO,CAAC,CAAC,WAa5G;AAGD,wBAAgB,iBAAiB,CAAC,KAAK,EAAE,KAAK,EAAE,UAAU,EAAE,KAAK,WAOhE"}

package/dist/mjs/Util.js

@@ -0,0 +1,223 @@
+export function throwError(e) {
+    if (e !== null && e instanceof Error) {
+        throw e;
+    }
+    throw new Error(e);
+}
+export function reThrowWithHint(e, hint) {
+    try {
+        if (e instanceof Error) {
+            // Add hint to error:
+            e.message += `\n${hint}`;
+        }
+    }
+    catch (x) {
+    }
+    throw e;
+}
+export function isObject(value) {
+    return value !== null && typeof value === "object";
+}
+/**
+ * A Map<K, Set<V>>. But automatically add a new Set if needed
+ */
+export class MapSet {
+    constructor() {
+        this.map = new Map();
+    }
+    add(key, value) {
+        let set = this.map.get(key);
+        if (set === undefined) {
+            set = new Set();
+            this.map.set(key, set);
+        }
+        set.add(value);
+    }
+    delete(key, value) {
+        let set = this.map.get(key);
+        if (set !== undefined) {
+            set.delete(value);
+            if (set.size === 0) {
+                this.map.delete(key); // Clean up
+            }
+        }
+    }
+    get(key) {
+        return this.map.get(key);
+    }
+    /**
+     * @param key
+     * @return the set for the specified key (an empty one will be created if needed) on which you should call `add` or `delete` **immediately**, so no empty set is left there consuming memory.
+     * It is automatically cleaned up after the last delete
+     */
+    get4use(key) {
+        const thisMapSet = this;
+        let set = this.map.get(key);
+        if (set === undefined) {
+            set = new class extends Set {
+                delete(value) {
+                    const result = super.delete(value);
+                    if (this.size === 0) {
+                        thisMapSet.map.delete(key); // Clean up
+                    }
+                    return result;
+                }
+                add(value) {
+                    if (thisMapSet.map.get(key) !== this) {
+                        throw new Error("This set is invalid. You must add/delete immediately after calling get4modify");
+                    }
+                    return super.add(value);
+                }
+            };
+            this.map.set(key, set);
+        }
+        return set;
+    }
+}
+/**
+ * This Map does not return empty values, so there's always a default value created
+ */
+export class DefaultMap extends Map {
+    get(key) {
+        let result = super.get(key);
+        if (result === undefined) {
+            result = this.createDefaultValue();
+            this.set(key, result);
+        }
+        return result;
+    }
+}
+/**
+ *
+ * @param createDefaultValueFn
+ * @returns a Map that creates and inserts a default value when that value does not exist. So the #get method always returns something.
+ */
+export function newDefaultMap(createDefaultValueFn) {
+    return new class extends DefaultMap {
+        createDefaultValue() {
+            return createDefaultValueFn();
+        }
+    }();
+}
+/**
+ * A WeakMap<K, Set<V>>. But automatically add a new Set if needed
+ */
+export class WeakMapSet extends MapSet {
+    constructor() {
+        super(...arguments);
+        //@ts-ignore
+        this.map = new WeakMap();
+    }
+}
+export function arraysAreEqualsByPredicateFn(a, b, equalsFn) {
+    if (a.length !== b.length) {
+        return false;
+    }
+    for (const k in a) {
+        if (!equalsFn(a[k], b[k])) {
+            return false;
+        }
+    }
+    return true;
+}
+function diagnosis_jsonPath(key) {
+    if (!Number.isNaN(Number(key))) {
+        return `[${key}]`;
+    }
+    return `.${key}`;
+}
+/**
+ * Usage:
+ *  <pre><code>
+ *  const result = visitReplace(target, (value, visitChilds, context) => {
+ *      return value === 'needle' ? 'replaced' : visitChilds(value, context)
+ *  });
+ *  </code></pre>
+ *
+ * @param value
+ * @param visitor
+ * @param trackPath whether to pass on the context object. This hurts performance because the path is concatted every time, so use it only when needed. Setting this to "onError" re-executes the visitprelace with the concetxt when an error was thrown
+ */
+export function visitReplace(value, visitor, trackPath = false) {
+    const visisitedObjects = new Set();
+    function visitChilds(value, context) {
+        if (value === null) {
+            return value;
+        }
+        else if (typeof value === "object") {
+            const obj = value;
+            if (visisitedObjects.has(obj)) {
+                return value; // don't iterate again
+            }
+            visisitedObjects.add(obj);
+            for (let k in obj) {
+                const keyInParent = k;
+                const childValue = obj[keyInParent];
+                let newValue = visitor(childValue, visitChilds, Object.assign(Object.assign({}, context), { parentObject: value, key: keyInParent, diagnosis_path: (context.diagnosis_path !== undefined ? `${context.diagnosis_path}${diagnosis_jsonPath(keyInParent)}` : undefined) }));
+                if (newValue !== childValue) { // Only if childValue really has changed. We don't want to interfer with setting a readonly property and trigger a proxy
+                    // @ts-ignore
+                    obj[keyInParent] = newValue;
+                }
+            }
+        }
+        return value;
+    }
+    if (trackPath === "onError") {
+        try {
+            return visitor(value, visitChilds, {}); // Fast try without context
+        }
+        catch (e) {
+            return visitReplace(value, visitor, true); // Try again with context
+        }
+    }
+    return visitor(value, visitChilds, { diagnosis_path: trackPath ? "" : undefined });
+}
+/**
+ * Just do something the runtime can't optimize away
+ * @param value
+ */
+export function read(value) {
+    if (("" + value) == "blaaxyxzzzsdf") {
+        throw new Error("should never get here");
+    }
+}
+export function arraysAreShallowlyEqual(a, b) {
+    if (a.length !== b.length) {
+        return false;
+    }
+    for (let i = 0; i < a.length; i++) {
+        if (a[i] !== b[i]) {
+            return false;
+        }
+    }
+    return true;
+}
+/**
+ * Like arraysAreShallowlyEqual but this time for an array of entries (tuple of 2 values) like from Map#entries()
+ * @param a
+ * @param b
+ */
+export function arraysWithEntriesAreShallowlyEqual(a, b) {
+    if (a.length !== b.length) {
+        return false;
+    }
+    for (let i = 0; i < a.length; i++) {
+        if (a[i][0] !== b[i][0]) {
+            return false;
+        }
+        if (a[i][1] !== b[i][1]) {
+            return false;
+        }
+    }
+    return true;
+}
+export function classIsSubclassOf(clazz, superClass) {
+    var _a, _b;
+    do {
+        if (clazz === superClass) {
+            return true;
+        }
+    } while ((clazz = (_b = (_a = clazz.prototype) === null || _a === void 0 ? void 0 : _a.prototype) === null || _b === void 0 ? void 0 : _b.constructor) !== undefined);
+    return false;
+}
+//# sourceMappingURL=Util.js.map

package/dist/mjs/Util.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"Util.js","sourceRoot":"","sources":["../../Util.ts"],"names":[],"mappings":"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"}

package/dist/mjs/class-trackers/Array.d.ts

@@ -0,0 +1,93 @@
+import { DualUseTracker, ForWatchedProxyHandler, IWatchedProxyHandler_common, ObjKey, RecordedRead } from "../common";
+import { WatchedProxyHandler } from "../watchedProxyFacade";
+import { RecordedReadOnProxiedObjectExt } from "../RecordedReadOnProxiedObjectExt";
+/**
+ * Listeners for one array.
+ * Note for specificity: There will be only one of the **change** events fired. The Recorded...Read.onChange handler will add the listeners to all possible candidates. It's this way around.
+ * {@link ObjectChangeHooks} are also subscribed on Arrays
+ */
+declare class ArrayChangeHooks {
+}
+export declare const changeHooksForArray: WeakMap<unknown[], ArrayChangeHooks>;
+export declare function getChangeHooksForArray(array: unknown[]): ArrayChangeHooks;
+/**
+ * Can be either used as a supervisor-class in a WatchedProxyHandler, or installed on the non-proxied object via Object.setPrototypeOf
+ * The "this" may be different in these cases.
+ */
+export declare class ArrayChangeTracker<T> extends Array<T> implements DualUseTracker<Array<T>> {
+    get _watchedProxyHandler(): IWatchedProxyHandler_common | undefined;
+    protected _withUnspecificChange<R>(changeFn: () => R): R;
+    pop(...args: any[]): T | undefined;
+    /**
+     * Will return the original object when this class is used as supervisor class in the WatchedProxyHandler
+     */
+    get _target(): Array<T>;
+    /**
+     * Pretend that this is an array
+     */
+    get ["constructor"](): ArrayConstructor;
+    shift(...args: any[]): T | undefined;
+    sort(...args: any[]): Array<T>;
+    fill(...args: any[]): Array<T>;
+}
+export declare class RecordedArrayValuesRead extends RecordedReadOnProxiedObjectExt {
+    values: unknown[];
+    protected get origObj(): unknown[];
+    constructor(values: unknown[]);
+    getAffectingChangeHooks(target: this["obj"]): import("../common").EventHook[];
+    equals(other: RecordedRead): boolean;
+    get isChanged(): boolean;
+}
+/**
+ * Patches methods / accessors
+ */
+export declare class ArrayReadTracker<T> extends Array<T> implements ForWatchedProxyHandler<Array<T>> {
+    get _watchedProxyHandler(): WatchedProxyHandler;
+    get _target(): Array<T>;
+    protected _fireAfterValuesRead(): void;
+    /**
+     * Pretend that this is an array
+     */
+    get ["constructor"](): ArrayConstructor;
+    values(): ArrayIterator<T>;
+    entries(): ArrayIterator<[number, T]>;
+    [Symbol.iterator](): ArrayIterator<T>;
+    get length(): number;
+    shift(...args: any[]): T | undefined;
+    /**
+     * Keep this method so it it treated as handled and not as making-unspecific-reads
+     * @param args
+     */
+    forEach(...args: any[]): void;
+    pop(...args: any[]): T | undefined;
+}
+export declare const config: {
+    clazz: ArrayConstructor;
+    readTracker: typeof ArrayReadTracker;
+    changeTracker: typeof ArrayChangeTracker;
+    /**
+     * Built-in Methods, which are using fields / calling methods on the proxy transparently/loyally, so those methods don't call/use internal stuff directly.
+     * Tested with, see dev_generateEsRuntimeBehaviourCheckerCode.ts
+     * May include read-only / reader methods
+     */
+    knownHighLevelMethods: Set<ObjKey>;
+    /**
+     * Non-high level. These fire `RecordedUnspecificRead`s then. So better implement them instead to fire i.e RecordedArrayValuesRead.
+     */
+    readOnlyMethods: Set<ObjKey>;
+    /**
+     * Non-high level. Same as above: better implement them
+     */
+    readOnlyFields: Set<ObjKey>;
+    /**
+     *
+     */
+    receiverMustBeNonProxied: boolean;
+    trackSettingObjectProperties: boolean;
+    worksForSubclasses: boolean;
+    trackTreads: boolean;
+    proxyUnhandledMethodResults: boolean;
+    getTrackerClasses(): import("../common").Clazz[];
+};
+export {};
+//# sourceMappingURL=Array.d.ts.map

package/dist/mjs/class-trackers/Array.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"Array.d.ts","sourceRoot":"","sources":["../../../class-trackers/Array.ts"],"names":[],"mappings":"AAAA,OAAO,EAGH,cAAc,EACd,sBAAsB,EAAE,2BAA2B,EACnD,MAAM,EACN,YAAY,EAEf,MAAM,WAAW,CAAC;AAOnB,OAAO,EAAC,mBAAmB,EAAC,MAAM,uBAAuB,CAAC;AAC1D,OAAO,EAAC,8BAA8B,EAAC,MAAM,mCAAmC,CAAC;AAGjF;;;;GAIG;AACH,cAAM,gBAAgB;CAErB;AAED,eAAO,MAAM,mBAAmB,sCAA6C,CAAC;AAC9E,wBAAgB,sBAAsB,CAAC,KAAK,EAAE,OAAO,EAAE,oBAMtD;AAED;;;GAGG;AACH,qBAAa,kBAAkB,CAAC,CAAC,CAAE,SAAQ,KAAK,CAAC,CAAC,CAAE,YAAW,cAAc,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC;IAKnF,IAAI,oBAAoB,IAAI,2BAA2B,GAAG,SAAS,CAElE;IAED,SAAS,CAAC,qBAAqB,CAAC,CAAC,EAAE,QAAQ,EAAE,MAAM,CAAC,GAAG,CAAC;IAMxD,GAAG,CAAC,GAAG,IAAI,EAAE,GAAG,EAAE;IAIlB;;OAEG;IACH,IAAI,OAAO,IAAI,KAAK,CAAC,CAAC,CAAC,CAEtB;IAED;;OAEG;IACH,IAAI,CAAC,aAAa,CAAC,qBAElB;IAED,KAAK,CAAC,GAAG,IAAI,EAAE,GAAG,EAAE,GAAG,CAAC,GAAG,SAAS;IAKpC,IAAI,CAAC,GAAG,IAAI,EAAE,GAAG,EAAE,GAAG,KAAK,CAAC,CAAC,CAAC;IAM9B,IAAI,CAAC,GAAG,IAAI,EAAE,GAAG,EAAE,GAAG,KAAK,CAAC,CAAC,CAAC;CAIjC;AAED,qBAAa,uBAAwB,SAAQ,8BAA8B;IACvE,MAAM,EAAE,OAAO,EAAE,CAAC;IAElB,SAAS,KAAK,OAAO,IACE,OAAO,EAAE,CAC/B;gBAGW,MAAM,EAAE,OAAO,EAAE;IAK7B,uBAAuB,CAAC,MAAM,EAAE,IAAI,CAAC,KAAK,CAAC;IAQ3C,MAAM,CAAC,KAAK,EAAE,YAAY,GAAG,OAAO;IAQpC,IAAI,SAAS,IAAI,OAAO,CAEvB;CAGJ;AAED;;GAEG;AACH,qBAAa,gBAAgB,CAAC,CAAC,CAAE,SAAQ,KAAK,CAAC,CAAC,CAAE,YAAW,sBAAsB,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC;IACzF,IAAI,oBAAoB,IAAI,mBAAmB,CAE9C;IAED,IAAI,OAAO,IAAI,KAAK,CAAC,CAAC,CAAC,CAEtB;IAED,SAAS,CAAC,oBAAoB;IAK9B;;OAEG;IACH,IAAI,CAAC,aAAa,CAAC,qBAElB;IAED,MAAM,IAAI,aAAa,CAAC,CAAC,CAAC;IAM1B,OAAO,IAAI,aAAa,CAAC,CAAC,MAAM,EAAE,CAAC,CAAC,CAAC;IAMrC,CAAC,MAAM,CAAC,QAAQ,CAAC,IAAI,aAAa,CAAC,CAAC,CAAC;IAMrC,IAAI,MAAM,IAAI,MAAM,CAInB;IAGD,KAAK,CAAC,GAAG,IAAI,EAAE,GAAG,EAAE;IAcpB;;;OAGG;IACH,OAAO,CAAC,GAAG,IAAI,EAAE,GAAG,EAAE;IAOtB,GAAG,CAAC,GAAG,IAAI,EAAE,GAAG,EAAE,GAAG,CAAC,GAAG,SAAS;CAcrC;AAED,eAAO,MAAM,MAAM;;;;IAIf;;;;OAIG;2BAC+T,GAAG,CAAC,MAAM,CAAC;IAE7U;;OAEG;qBAC0J,GAAG,CAAC,MAAM,CAAC;IAExK;;OAEG;oBACqE,GAAG,CAAC,MAAM,CAAC;IAEnF;;OAEG;;;;;;;CAIN,CAAA"}