react-deepwatch 1.0.0

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2024-present Boris Gingold
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/Util.d.ts

@@ -0,0 +1,66 @@
+import { RecordedRead } from "proxy-facades";
+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;
+}
+/**
+ * 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 recordedReadsArraysAreEqual(a: RecordedRead[], b: RecordedRead[]): boolean;
+export {};
+//# sourceMappingURL=Util.d.ts.map

package/Util.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"Util.d.ts","sourceRoot":"","sources":["Util.ts"],"names":[],"mappings":"AAAA,OAAO,EAAC,YAAY,EAAC,MAAM,eAAe,CAAC;AAE3C,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;CAGb;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;AAED,wBAAgB,2BAA2B,CAAC,CAAC,EAAE,YAAY,EAAE,EAAE,CAAC,EAAE,YAAY,EAAE,WAE/E"}

package/Util.js

@@ -0,0 +1,178 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.WeakMapSet = exports.MapSet = void 0;
+exports.throwError = throwError;
+exports.reThrowWithHint = reThrowWithHint;
+exports.isObject = isObject;
+exports.arraysAreEqualsByPredicateFn = arraysAreEqualsByPredicateFn;
+exports.visitReplace = visitReplace;
+exports.read = read;
+exports.arraysAreShallowlyEqual = arraysAreShallowlyEqual;
+exports.arraysWithEntriesAreShallowlyEqual = arraysWithEntriesAreShallowlyEqual;
+exports.recordedReadsArraysAreEqual = recordedReadsArraysAreEqual;
+function throwError(e) {
+    if (e !== null && e instanceof Error) {
+        throw e;
+    }
+    throw new Error(e);
+}
+function reThrowWithHint(e, hint) {
+    try {
+        if (e instanceof Error) {
+            // Add hint to error:
+            e.message += `\n${hint}`;
+        }
+    }
+    catch (x) {
+    }
+    throw e;
+}
+function isObject(value) {
+    return value !== null && typeof value === "object";
+}
+/**
+ * A Map<K, Set<V>>. But automatically add a new Set if needed
+ */
+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);
+    }
+}
+exports.MapSet = MapSet;
+/**
+ * A WeakMap<K, Set<V>>. But automatically add a new Set if needed
+ */
+class WeakMapSet extends MapSet {
+    constructor() {
+        super(...arguments);
+        //@ts-ignore
+        this.map = new WeakMap();
+    }
+}
+exports.WeakMapSet = WeakMapSet;
+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
+ */
+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
+ */
+function read(value) {
+    if (("" + value) == "blaaxyxzzzsdf") {
+        throw new Error("should never get here");
+    }
+}
+function arraysAreShallowlyEqual(a, b) {
+    if (a.length !== b.length) {
+        return false;
+    }
+    for (let i = 0; i < a.length; i++) {
+        if (a[i] !== b[i]) { // TODO add option for object instance equality
+            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
+ */
+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]) { // TODO add option for object instance equality
+            return false;
+        }
+        if (a[i][1] !== b[i][1]) { // TODO add option for object instance equality
+            return false;
+        }
+    }
+    return true;
+}
+function recordedReadsArraysAreEqual(a, b) {
+    return arraysAreEqualsByPredicateFn(a, b, (a, b) => a.equals(b));
+}
+//# sourceMappingURL=Util.js.map

package/Util.js.map

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

package/Util.ts

@@ -0,0 +1,190 @@
+import {RecordedRead} from "proxy-facades";
+
+export function throwError(e: string | Error) {
+    if(e !== null && e instanceof Error) {
+        throw e;
+    }
+    throw new Error(e);
+}
+
+export function reThrowWithHint(e: unknown, hint: string) {
+    try {
+        if(e instanceof Error) {
+            // Add hint to error:
+            e.message+= `\n${hint}`;
+        }
+    }
+    catch (x) {
+    }
+    throw e;
+}
+
+export function isObject(value: unknown) {
+    return value !== null && typeof value === "object";
+}
+
+/**
+ * A Map<K, Set<V>>. But automatically add a new Set if needed
+ */
+export class MapSet<K, V> {
+    map = new Map<K, Set<V>>()
+
+    add(key: K, value: V) {
+        let set = this.map.get(key);
+        if(set === undefined) {
+            set = new Set<V>();
+            this.map.set(key, set);
+        }
+        set.add(value);
+    }
+
+    delete(key: K, value: V) {
+        let set = this.map.get(key);
+        if(set !== undefined) {
+            set.delete(value);
+            if(set.size === 0) {
+                this.map.delete(key); // Clean up
+            }
+        }
+    }
+
+    get(key: K) {
+        return this.map.get(key);
+    }
+}
+
+/**
+ * A WeakMap<K, Set<V>>. But automatically add a new Set if needed
+ */
+export class WeakMapSet<K, V> extends MapSet<K, V> {
+    //@ts-ignore
+    map = new WeakMap<K, Set<V>>();
+}
+
+export function arraysAreEqualsByPredicateFn<A, B>(a: A[], b: B[], equalsFn: (a: A,b: B) => boolean) {
+    if(a.length !== b.length) {
+        return false;
+    }
+    for(const k in a) {
+        if(!equalsFn(a[k], b[k])) {
+            return false;
+        }
+    }
+    return true;
+}
+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
+}
+
+function diagnosis_jsonPath(key: unknown) {
+    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<O>(value: O, visitor: (value: unknown, visitChilds: (value: unknown, context: VisitReplaceContext) => unknown, context: VisitReplaceContext) => unknown , trackPath: boolean | "onError" = false): O {
+    const visisitedObjects = new Set<object>()
+
+    function visitChilds(value: unknown, context: VisitReplaceContext) {
+        if(value === null) {
+            return value;
+        }
+        else if(typeof value === "object") {
+            const obj = value as object;
+            if(visisitedObjects.has(obj)) {
+                return value; // don't iterate again
+            }
+            visisitedObjects.add(obj);
+
+            for (let k in obj) {
+                const keyInParent = k as keyof object;
+                const childValue = obj[keyInParent];
+                let newValue = visitor(childValue, visitChilds, {...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, {}) as O; // Fast try without context
+        }
+        catch (e) {
+            return visitReplace(value,  visitor, true); // Try again with context
+        }
+    }
+
+    return visitor(value, visitChilds,{diagnosis_path: trackPath?"":undefined}) as O;
+}
+
+/**
+ * Just do something the runtime can't optimize away
+ * @param value
+ */
+export function read(value: any) {
+    if( ("" + value) == "blaaxyxzzzsdf" ) {
+        throw new Error("should never get here")
+    }
+}
+
+export function arraysAreShallowlyEqual(a: unknown[], b: unknown[]) {
+    if(a.length !== b.length) {
+        return false;
+    }
+    for(let i = 0;i<a.length;i++) {
+        if(a[i] !== b[i]) { // TODO add option for object instance equality
+            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: Array<[unknown, unknown]>, b: Array<[unknown, unknown]>) {
+    if(a.length !== b.length) {
+        return false;
+    }
+    for(let i = 0;i<a.length;i++) {
+        if(a[i][0] !== b[i][0]) { // TODO add option for object instance equality
+            return false;
+        }
+        if(a[i][1] !== b[i][1]) { // TODO add option for object instance equality
+            return false;
+        }
+    }
+    return true;
+}
+
+export function recordedReadsArraysAreEqual(a: RecordedRead[], b: RecordedRead[]) {
+    return arraysAreEqualsByPredicateFn(a, b, (a, b) => a.equals(b));
+}

package/dist/mjs/Util.d.ts

@@ -0,0 +1,66 @@
+import { RecordedRead } from "proxy-facades";
+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;
+}
+/**
+ * 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 recordedReadsArraysAreEqual(a: RecordedRead[], b: RecordedRead[]): 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,YAAY,EAAC,MAAM,eAAe,CAAC;AAE3C,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;CAGb;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;AAED,wBAAgB,2BAA2B,CAAC,CAAC,EAAE,YAAY,EAAE,EAAE,CAAC,EAAE,YAAY,EAAE,WAE/E"}