@ac-kit/core 0.1.0

package/dist/object/merge-inplace.js

@@ -0,0 +1,107 @@
+import { isMap } from "../guards/is-map.js";
+import { isObject } from "../guards/is-object.js";
+import { isPojo } from "../guards/is-pojo.js";
+import { isSet } from "../guards/is-set.js";
+import { clone } from "./clone.js";
+import { MERGE_DEFAULT_OPTIONS, } from "./merge-options.js";
+function resolve_(options) {
+    return {
+        recursive: options?.recursive ?? MERGE_DEFAULT_OPTIONS.recursive,
+        cloneSource: options?.cloneSource ?? MERGE_DEFAULT_OPTIONS.cloneSource,
+        arrayMergeMode: options?.arrayMergeMode ?? MERGE_DEFAULT_OPTIONS.arrayMergeMode,
+    };
+}
+function fromSource_(value, options) {
+    return options.cloneSource ? clone(value, { recursive: true }) : value;
+}
+/** A nested pair recurses only when asked; otherwise the source value wins. */
+function nested_(target, source, options) {
+    return options.recursive
+        ? mergeInplace_(target, source, options)
+        : fromSource_(source, options);
+}
+export function mergeInplace(target, source, options) {
+    return mergeInplace_(target, source, resolve_(options));
+}
+/**
+ * Fold several sources into `target`, each merged over the one before it.
+ *
+ * Options are resolved once for the whole fold, where a chain of binary
+ * {@link mergeInplace} calls resolves them per step.
+ *
+ * @param target Value to merge into; modified when it is mergeable
+ * @param sources Values to merge, lowest priority first
+ * @param options Merge options
+ * @returns `target` where it could be merged into, otherwise the last value
+ *   that replaced it
+ */
+export function mergeAllInplace(target, sources, options) {
+    const resolved = resolve_(options);
+    let result = target;
+    for (let index = 0; index < sources.length; index++) {
+        result = mergeInplace_(result, sources[index], resolved);
+    }
+    return result;
+}
+function mergeInplace_(target, source, options) {
+    if (isObject(target) && isObject(source)) {
+        if (isPojo(target) && isPojo(source)) {
+            mergePojoInplace_(target, source, options);
+            return target;
+        }
+        if (isMap(target) && isMap(source)) {
+            mergeMapInplace_(target, source, options);
+            return target;
+        }
+        if (isSet(target) && isSet(source)) {
+            mergeSetInplace_(target, source, options);
+            return target;
+        }
+    }
+    else if (Array.isArray(target) && Array.isArray(source)) {
+        mergeArrayInplace_(target, source, options);
+        return target;
+    }
+    return fromSource_(source, options);
+}
+function mergePojoInplace_(target, source, options) {
+    for (const key in source) {
+        target[key] = nested_(target[key], source[key], options);
+    }
+}
+function mergeSetInplace_(target, source, options) {
+    for (const value of source) {
+        if (!target.has(value)) {
+            target.add(fromSource_(value, options));
+        }
+    }
+}
+function mergeMapInplace_(target, source, options) {
+    for (const [key, value] of source) {
+        target.set(key, nested_(target.get(key), value, options));
+    }
+}
+function mergeArrayInplace_(target, source, options) {
+    switch (options.arrayMergeMode) {
+        case "spread":
+            for (const value of source) {
+                target.push(fromSource_(value, options));
+            }
+            break;
+        case "merge":
+            for (const [index, sourceValue] of source.entries()) {
+                target[index] =
+                    target[index] === undefined
+                        ? fromSource_(sourceValue, options)
+                        : nested_(target[index], sourceValue, options);
+            }
+            break;
+        default:
+            target.length = 0;
+            for (const value of source) {
+                target.push(fromSource_(value, options));
+            }
+            break;
+    }
+}
+//# sourceMappingURL=merge-inplace.js.map

package/dist/object/merge-inplace.js.map

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

package/dist/object/merge-options.d.ts

@@ -0,0 +1,23 @@
+import type { Simplify, UnionToIntersection } from "type-fest";
+export type MergeArrayMode = "replace" | "spread" | "merge";
+export type MergeOptions = {
+    /**
+     * Whether to merge nested values recursively, rather than letting the
+     * source's value replace the target's. Defaults to `false`.
+     *
+     * Recursing costs the whole tree rather than the top-level key count.
+     */
+    recursive?: boolean;
+    cloneSource?: boolean;
+    arrayMergeMode?: MergeArrayMode;
+};
+export declare const MERGE_DEFAULT_OPTIONS: Required<MergeOptions>;
+/**
+ * What folding `TSources` yields.
+ *
+ * An intersection, which is right while the sources' keys are disjoint or agree
+ * on a type. Where they disagree the last source wins at runtime, so a caller
+ * in that position states the result type itself.
+ */
+export type MergedSources<TSources extends readonly unknown[]> = Simplify<UnionToIntersection<TSources[number]>>;
+//# sourceMappingURL=merge-options.d.ts.map

package/dist/object/merge-options.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"merge-options.d.ts","sourceRoot":"","sources":["../../src/object/merge-options.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,QAAQ,EAAE,mBAAmB,EAAE,MAAM,WAAW,CAAC;AAE/D,MAAM,MAAM,cAAc,GAAG,SAAS,GAAG,QAAQ,GAAG,OAAO,CAAC;AAE5D,MAAM,MAAM,YAAY,GAAG;IAC1B;;;;;OAKG;IACH,SAAS,CAAC,EAAE,OAAO,CAAC;IAEpB,WAAW,CAAC,EAAE,OAAO,CAAC;IAEtB,cAAc,CAAC,EAAE,cAAc,CAAC;CAChC,CAAC;AAEF,eAAO,MAAM,qBAAqB,EAAE,QAAQ,CAAC,YAAY,CAIxD,CAAC;AAEF;;;;;;GAMG;AACH,MAAM,MAAM,aAAa,CAAC,QAAQ,SAAS,SAAS,OAAO,EAAE,IAAI,QAAQ,CACxE,mBAAmB,CAAC,QAAQ,CAAC,MAAM,CAAC,CAAC,CACrC,CAAC"}

package/dist/object/merge-options.js

@@ -0,0 +1,6 @@
+export const MERGE_DEFAULT_OPTIONS = {
+    recursive: false,
+    cloneSource: false,
+    arrayMergeMode: "replace",
+};
+//# sourceMappingURL=merge-options.js.map

package/dist/object/merge-options.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"merge-options.js","sourceRoot":"","sources":["../../src/object/merge-options.ts"],"names":[],"mappings":"AAkBA,MAAM,CAAC,MAAM,qBAAqB,GAA2B;IAC5D,SAAS,EAAE,KAAK;IAChB,WAAW,EAAE,KAAK;IAClB,cAAc,EAAE,SAAS;CACzB,CAAC"}

package/dist/object/merge.d.ts

@@ -0,0 +1,32 @@
+import type { Merge, MergeDeep } from "type-fest";
+import { type MergedSources, type MergeOptions } from "./merge-options.js";
+/**
+ * Merge two values into a new one.
+ *
+ * Shallow by default: a key present in both takes the source's value whole.
+ * With `recursive`, two mergeable values are merged instead — see
+ * {@link MergeOptions["recursive"]} for what that costs.
+ *
+ * @param target Value to merge into
+ * @param source Value to merge from
+ * @param options Merge options
+ * @returns The merged value; `target` is not modified
+ */
+export declare function merge<T, U, R extends Merge<T, U>>(target: T, source: U, options?: MergeOptions & {
+    recursive?: false;
+}): R;
+export declare function merge<T, U, R extends MergeDeep<T, U>>(target: T, source: U, options: MergeOptions & {
+    recursive: true;
+}): R;
+/**
+ * Fold several sources into one value, each merged over the one before it.
+ *
+ * Options are resolved once for the whole fold, where a chain of binary
+ * {@link merge} calls resolves them per step.
+ *
+ * @param sources Values to merge, lowest priority first
+ * @param options Merge options
+ * @returns A new value; no source is modified
+ */
+export declare function mergeAll<TSources extends readonly unknown[]>(sources: TSources, options?: MergeOptions): MergedSources<TSources>;
+//# sourceMappingURL=merge.d.ts.map

package/dist/object/merge.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"merge.d.ts","sourceRoot":"","sources":["../../src/object/merge.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,KAAK,EAAE,SAAS,EAAE,MAAM,WAAW,CAAC;AAOlD,OAAO,EAEN,KAAK,aAAa,EAClB,KAAK,YAAY,EACjB,MAAM,oBAAoB,CAAC;AA4B5B;;;;;;;;;;;GAWG;AACH,wBAAgB,KAAK,CAAC,CAAC,EAAE,CAAC,EAAE,CAAC,SAAS,KAAK,CAAC,CAAC,EAAE,CAAC,CAAC,EAChD,MAAM,EAAE,CAAC,EACT,MAAM,EAAE,CAAC,EACT,OAAO,CAAC,EAAE,YAAY,GAAG;IAAE,SAAS,CAAC,EAAE,KAAK,CAAA;CAAE,GAC5C,CAAC,CAAC;AACL,wBAAgB,KAAK,CAAC,CAAC,EAAE,CAAC,EAAE,CAAC,SAAS,SAAS,CAAC,CAAC,EAAE,CAAC,CAAC,EACpD,MAAM,EAAE,CAAC,EACT,MAAM,EAAE,CAAC,EACT,OAAO,EAAE,YAAY,GAAG;IAAE,SAAS,EAAE,IAAI,CAAA;CAAE,GACzC,CAAC,CAAC;AASL;;;;;;;;;GASG;AACH,wBAAgB,QAAQ,CAAC,QAAQ,SAAS,SAAS,OAAO,EAAE,EAC3D,OAAO,EAAE,QAAQ,EACjB,OAAO,CAAC,EAAE,YAAY,GACpB,aAAa,CAAC,QAAQ,CAAC,CASzB"}

package/dist/object/merge.js

@@ -0,0 +1,105 @@
+import { isMap } from "../guards/is-map.js";
+import { isObject } from "../guards/is-object.js";
+import { isPojo } from "../guards/is-pojo.js";
+import { isSet } from "../guards/is-set.js";
+import { clone } from "./clone.js";
+import { MERGE_DEFAULT_OPTIONS, } from "./merge-options.js";
+function resolve_(options) {
+    return {
+        recursive: options?.recursive ?? MERGE_DEFAULT_OPTIONS.recursive,
+        cloneSource: options?.cloneSource ?? MERGE_DEFAULT_OPTIONS.cloneSource,
+        arrayMergeMode: options?.arrayMergeMode ?? MERGE_DEFAULT_OPTIONS.arrayMergeMode,
+    };
+}
+function fromSource_(value, options) {
+    return options.cloneSource ? clone(value, { recursive: true }) : value;
+}
+/** A nested pair recurses only when asked; otherwise the source value wins. */
+function nested_(target, source, options) {
+    return options.recursive
+        ? merge_(target, source, options)
+        : fromSource_(source, options);
+}
+export function merge(target, source, options) {
+    return merge_(target, source, resolve_(options));
+}
+/**
+ * Fold several sources into one value, each merged over the one before it.
+ *
+ * Options are resolved once for the whole fold, where a chain of binary
+ * {@link merge} calls resolves them per step.
+ *
+ * @param sources Values to merge, lowest priority first
+ * @param options Merge options
+ * @returns A new value; no source is modified
+ */
+export function mergeAll(sources, options) {
+    const resolved = resolve_(options);
+    let result = {};
+    for (let index = 0; index < sources.length; index++) {
+        result = merge_(result, sources[index], resolved);
+    }
+    return result;
+}
+function merge_(target, source, options) {
+    if (isObject(target) && isObject(source)) {
+        if (isPojo(target) && isPojo(source)) {
+            return mergePojo_(target, source, options);
+        }
+        if (isMap(target) && isMap(source)) {
+            return mergeMap_(target, source, options);
+        }
+        if (isSet(target) && isSet(source)) {
+            return mergeSet_(target, source, options);
+        }
+    }
+    else if (Array.isArray(target) && Array.isArray(source)) {
+        return mergeArray_(target, source, options);
+    }
+    return fromSource_(source, options);
+}
+function mergePojo_(target, source, options) {
+    const output = { ...target };
+    for (const key in source) {
+        output[key] = nested_(target[key], source[key], options);
+    }
+    return output;
+}
+function mergeSet_(target, source, options) {
+    const output = new Set(target);
+    for (const value of source) {
+        if (!output.has(value)) {
+            output.add(fromSource_(value, options));
+        }
+    }
+    return output;
+}
+function mergeMap_(target, source, options) {
+    const output = new Map(target);
+    for (const [key, value] of source) {
+        output.set(key, nested_(target.get(key), value, options));
+    }
+    return output;
+}
+function mergeArray_(target, source, options) {
+    if (options.arrayMergeMode === "spread") {
+        return [...target, ...fromSource_(source, options)];
+    }
+    if (options.arrayMergeMode === "merge") {
+        const output = target.slice();
+        for (const [index, sourceValue] of source.entries()) {
+            output[index] =
+                target[index] === undefined
+                    ? fromSource_(sourceValue, options)
+                    : nested_(target[index], sourceValue, options);
+        }
+        // Anything the source did not reach is copied, so the result shares no
+        // reference with the target it was built from.
+        for (let index = source.length; index < target.length; index++) {
+            output[index] = clone(target[index], { recursive: true });
+        }
+        return output;
+    }
+    return fromSource_(source, options);
+}
+//# sourceMappingURL=merge.js.map

package/dist/object/merge.js.map

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

package/dist/object/set-at-path.d.ts

@@ -0,0 +1,14 @@
+import { PropertyPath } from "./get-at-path.js";
+/**
+ * Mutates `root` by setting the value at `path`.
+ *
+ * Creates intermediate plain objects or arrays as needed based on the type of
+ * the next key (`number` → array, `string` → object). Existing `null` or
+ * `undefined` intermediates are replaced.
+ *
+ * @param root The root object/array to mutate
+ * @param path The path to traverse
+ * @param value The value to set at the path
+ */
+export declare function setAtPath(root: Record<string, unknown> | unknown[], path: PropertyPath, value: unknown): void;
+//# sourceMappingURL=set-at-path.d.ts.map

package/dist/object/set-at-path.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"set-at-path.d.ts","sourceRoot":"","sources":["../../src/object/set-at-path.ts"],"names":[],"mappings":"AAGA,OAAO,EAAE,YAAY,EAAE,MAAM,kBAAkB,CAAC;AAEhD;;;;;;;;;;GAUG;AACH,wBAAgB,SAAS,CACxB,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,OAAO,EAAE,EACzC,IAAI,EAAE,YAAY,EAClB,KAAK,EAAE,OAAO,GACZ,IAAI,CAyCN"}

package/dist/object/set-at-path.js

@@ -0,0 +1,51 @@
+import { isObject } from "../guards/is-object.js";
+/**
+ * Mutates `root` by setting the value at `path`.
+ *
+ * Creates intermediate plain objects or arrays as needed based on the type of
+ * the next key (`number` → array, `string` → object). Existing `null` or
+ * `undefined` intermediates are replaced.
+ *
+ * @param root The root object/array to mutate
+ * @param path The path to traverse
+ * @param value The value to set at the path
+ */
+export function setAtPath(root, path, value) {
+    if (path.length === 0) {
+        return;
+    }
+    let current = root;
+    for (let i = 0; i < path.length - 1; i++) {
+        const key = path[i];
+        const nextKey = path[i + 1];
+        if (Array.isArray(current)) {
+            const index = +key;
+            if (Number.isNaN(index)) {
+                return;
+            }
+            if (!isObject(current[index]) && !Array.isArray(current[index])) {
+                current[index] = typeof nextKey === "number" ? [] : {};
+            }
+            current = current[index];
+        }
+        else {
+            const obj = current;
+            if (!isObject(obj[key]) && !Array.isArray(obj[key])) {
+                obj[key] = typeof nextKey === "number" ? [] : {};
+            }
+            current = obj[key];
+        }
+    }
+    const lastKey = path[path.length - 1];
+    if (Array.isArray(current)) {
+        const lastIndex = +lastKey;
+        if (Number.isNaN(lastIndex)) {
+            return;
+        }
+        current[lastIndex] = value;
+    }
+    else {
+        current[lastKey] = value;
+    }
+}
+//# sourceMappingURL=set-at-path.js.map

package/dist/object/set-at-path.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"set-at-path.js","sourceRoot":"","sources":["../../src/object/set-at-path.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,QAAQ,EAAE,MAAM,wBAAwB,CAAC;AAGlD;;;;;;;;;;GAUG;AACH,MAAM,UAAU,SAAS,CACxB,IAAyC,EACzC,IAAkB,EAClB,KAAc;IAEd,IAAI,IAAI,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;QACvB,OAAO;IACR,CAAC;IAED,IAAI,OAAO,GAAY,IAAI,CAAC;IAE5B,KAAK,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,GAAG,IAAI,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC,EAAE,EAAE,CAAC;QAC1C,MAAM,GAAG,GAAG,IAAI,CAAC,CAAC,CAAE,CAAC;QACrB,MAAM,OAAO,GAAG,IAAI,CAAC,CAAC,GAAG,CAAC,CAAE,CAAC;QAE7B,IAAI,KAAK,CAAC,OAAO,CAAC,OAAO,CAAC,EAAE,CAAC;YAC5B,MAAM,KAAK,GAAG,CAAC,GAAG,CAAC;YACnB,IAAI,MAAM,CAAC,KAAK,CAAC,KAAK,CAAC,EAAE,CAAC;gBACzB,OAAO;YACR,CAAC;YAED,IAAI,CAAC,QAAQ,CAAC,OAAO,CAAC,KAAK,CAAC,CAAC,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,OAAO,CAAC,KAAK,CAAC,CAAC,EAAE,CAAC;gBACjE,OAAO,CAAC,KAAK,CAAC,GAAG,OAAO,OAAO,KAAK,QAAQ,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;YACxD,CAAC;YACD,OAAO,GAAG,OAAO,CAAC,KAAK,CAAC,CAAC;QAC1B,CAAC;aAAM,CAAC;YACP,MAAM,GAAG,GAAG,OAAwB,CAAC;YAErC,IAAI,CAAC,QAAQ,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC,EAAE,CAAC;gBACrD,GAAG,CAAC,GAAG,CAAC,GAAG,OAAO,OAAO,KAAK,QAAQ,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;YAClD,CAAC;YACD,OAAO,GAAG,GAAG,CAAC,GAAG,CAAC,CAAC;QACpB,CAAC;IACF,CAAC;IAED,MAAM,OAAO,GAAG,IAAI,CAAC,IAAI,CAAC,MAAM,GAAG,CAAC,CAAE,CAAC;IACvC,IAAI,KAAK,CAAC,OAAO,CAAC,OAAO,CAAC,EAAE,CAAC;QAC5B,MAAM,SAAS,GAAG,CAAC,OAAO,CAAC;QAC3B,IAAI,MAAM,CAAC,KAAK,CAAC,SAAS,CAAC,EAAE,CAAC;YAC7B,OAAO;QACR,CAAC;QACD,OAAO,CAAC,SAAS,CAAC,GAAG,KAAK,CAAC;IAC5B,CAAC;SAAM,CAAC;QACN,OAAyB,CAAC,OAAO,CAAC,GAAG,KAAK,CAAC;IAC7C,CAAC;AACF,CAAC"}

package/dist/object/traverse.d.ts

@@ -0,0 +1,100 @@
+import type { TaggedUnion } from "type-fest";
+import { DefinedValue } from "../types/defined-value.js";
+import { type GetObjectKeysOptions, type ObjectKey } from "./get-object-keys.js";
+export declare const TraverseSkip: unique symbol;
+export declare const TraverseBreak: unique symbol;
+export declare const TraverseHalt: unique symbol;
+export declare const TraverseContinue: unique symbol;
+export type TraverseKey = TaggedUnion<"kind", {
+    array: {
+        index: number;
+    };
+    object: ObjectKey;
+    map: {
+        key: unknown;
+    };
+    "map-key": {
+        name: unknown;
+    };
+    set: {
+        value: unknown;
+    };
+}>;
+export type TraverseControl = typeof TraverseContinue | typeof TraverseSkip | typeof TraverseBreak | typeof TraverseHalt;
+export type TraverseVisitorContext = {
+    key: TraverseKey | null;
+    parent: DefinedValue | undefined;
+    parentPath: TraverseKey[] | null;
+    /**
+     * Replace the current value with a new value (including undefined) If called
+     * multiple times, the last call takes precedence
+     */
+    replace(value: unknown): void;
+    /**
+     * Remove the current value from its container If called multiple times, the
+     * last call takes precedence
+     */
+    remove(): void;
+};
+export type TraverseVisitor = (value: unknown, context: TraverseVisitorContext) => TraverseControl;
+export type TraverseCustomObjectsOption = false | Function[] | ((value: object) => boolean);
+export type TraverseOptions = GetObjectKeysOptions & {
+    /**
+     * Whether to call the visitor on primitive values (string, number, boolean,
+     * null, undefined, symbol, bigint)
+     *
+     * @default true
+     */
+    visitPrimitives?: boolean;
+    /**
+     * Whether to call the visitor on object values (arrays, maps, sets, plain
+     * objects, custom objects)
+     *
+     * @default true
+     */
+    visitObjects?: boolean;
+    /**
+     * Whether to traverse into array elements
+     *
+     * @default true
+     */
+    traverseArrays?: boolean;
+    /**
+     * Whether to traverse into Map keys and values
+     *
+     * @default true
+     */
+    traverseMaps?: boolean;
+    /**
+     * Whether to traverse into Map keys specifically Only applies when
+     * traverseMaps is true
+     *
+     * @default false
+     */
+    traverseMapKeys?: boolean;
+    /**
+     * Whether to traverse into Set values
+     *
+     * @default true
+     */
+    traverseSets?: boolean;
+    /**
+     * Whether to traverse into plain object (POJO) properties
+     *
+     * @default true
+     */
+    traversePlainObjects?: boolean;
+    /**
+     * Controls traversal into custom object (user-defined class instances)
+     * properties - false: Don't traverse custom objects (treat as opaque) -
+     * Constructor[]: Only traverse instances of these classes (or their
+     * descendants) - (value: object) => boolean: Custom predicate to determine
+     * traversability
+     *
+     * @default false
+     */
+    traverseCustomObjects?: TraverseCustomObjectsOption;
+};
+export declare const TRAVERSE_DEFAULT_OPTIONS: Required<TraverseOptions>;
+export declare function traverse(value: unknown, callback: TraverseVisitor, options?: TraverseOptions): unknown;
+//# sourceMappingURL=traverse.d.ts.map

package/dist/object/traverse.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"traverse.d.ts","sourceRoot":"","sources":["../../src/object/traverse.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAU,WAAW,EAAE,MAAM,WAAW,CAAC;AAKrD,OAAO,EAAE,YAAY,EAAE,MAAM,2BAA2B,CAAC;AAEzD,OAAO,EAEN,KAAK,oBAAoB,EACzB,KAAK,SAAS,EACd,MAAM,sBAAsB,CAAC;AAE9B,eAAO,MAAM,YAAY,eAAyB,CAAC;AACnD,eAAO,MAAM,aAAa,eAA0B,CAAC;AACrD,eAAO,MAAM,YAAY,eAAyB,CAAC;AACnD,eAAO,MAAM,gBAAgB,eAA6B,CAAC;AAE3D,MAAM,MAAM,WAAW,GAAG,WAAW,CACpC,MAAM,EACN;IACC,KAAK,EAAE;QAAE,KAAK,EAAE,MAAM,CAAA;KAAE,CAAC;IACzB,MAAM,EAAE,SAAS,CAAC;IAClB,GAAG,EAAE;QAAE,GAAG,EAAE,OAAO,CAAA;KAAE,CAAC;IACtB,SAAS,EAAE;QAAE,IAAI,EAAE,OAAO,CAAA;KAAE,CAAC;IAC7B,GAAG,EAAE;QAAE,KAAK,EAAE,OAAO,CAAA;KAAE,CAAC;CACxB,CACD,CAAC;AAEF,MAAM,MAAM,eAAe,GACxB,OAAO,gBAAgB,GACvB,OAAO,YAAY,GACnB,OAAO,aAAa,GACpB,OAAO,YAAY,CAAC;AAIvB,MAAM,MAAM,sBAAsB,GAAG;IACpC,GAAG,EAAE,WAAW,GAAG,IAAI,CAAC;IACxB,MAAM,EAAE,YAAY,GAAG,SAAS,CAAC;IACjC,UAAU,EAAE,WAAW,EAAE,GAAG,IAAI,CAAC;IAEjC;;;OAGG;IACH,OAAO,CAAC,KAAK,EAAE,OAAO,GAAG,IAAI,CAAC;IAE9B;;;OAGG;IACH,MAAM,IAAI,IAAI,CAAC;CACf,CAAC;AAEF,MAAM,MAAM,eAAe,GAAG,CAC7B,KAAK,EAAE,OAAO,EACd,OAAO,EAAE,sBAAsB,KAC3B,eAAe,CAAC;AAErB,MAAM,MAAM,2BAA2B,GACpC,KAAK,GACL,QAAQ,EAAE,GACV,CAAC,CAAC,KAAK,EAAE,MAAM,KAAK,OAAO,CAAC,CAAC;AAEhC,MAAM,MAAM,eAAe,GAAG,oBAAoB,GAAG;IACpD;;;;;OAKG;IACH,eAAe,CAAC,EAAE,OAAO,CAAC;IAE1B;;;;;OAKG;IACH,YAAY,CAAC,EAAE,OAAO,CAAC;IAEvB;;;;OAIG;IACH,cAAc,CAAC,EAAE,OAAO,CAAC;IAEzB;;;;OAIG;IACH,YAAY,CAAC,EAAE,OAAO,CAAC;IAEvB;;;;;OAKG;IACH,eAAe,CAAC,EAAE,OAAO,CAAC;IAE1B;;;;OAIG;IACH,YAAY,CAAC,EAAE,OAAO,CAAC;IAEvB;;;;OAIG;IACH,oBAAoB,CAAC,EAAE,OAAO,CAAC;IAE/B;;;;;;;;OAQG;IACH,qBAAqB,CAAC,EAAE,2BAA2B,CAAC;CACpD,CAAC;AAEF,eAAO,MAAM,wBAAwB,EAAE,QAAQ,CAAC,eAAe,CAa9D,CAAC;AAIF,wBAAgB,QAAQ,CACvB,KAAK,EAAE,OAAO,EACd,QAAQ,EAAE,eAAe,EACzB,OAAO,CAAC,EAAE,eAAe,GACvB,OAAO,CAqBT"}