@intentic/sandbox-contract 1.311.0 → 1.313.0

package/dist/documents/conversions.js

@@ -0,0 +1,213 @@
+export const isJsonObject = (value) => typeof value === "object" && value !== null && !Array.isArray(value);
+const glimpse = (value) => {
+    const spelled = String(JSON.stringify(value));
+    return spelled.length > 80 ? `${spelled.slice(0, 77)}…` : spelled;
+};
+const renamedKey = (target, from, to) => Object.fromEntries(Object.entries(target).map(([key, value]) => [key === from ? to : key, value]));
+const withoutKey = (target, key) => Object.fromEntries(Object.entries(target).filter(([name]) => name !== key));
+export const rename = (from, to) => ({
+    kind: "rename",
+    describe: `renames ${from} to ${to}`,
+    from,
+    to,
+});
+export const drop = (key) => ({ kind: "drop", describe: `drops ${key}`, key });
+export const retype = (key, guard, convert, describe = `converts ${key} to its new form`) => ({ kind: "retype", describe, key, guard, convert });
+export const mapValue = (key, mapping) => {
+    const cyclic = Object.values(mapping).filter((mapped) => typeof mapped === "string" && Object.hasOwn(mapping, mapped));
+    if (cyclic.length > 0) {
+        throw new Error(`mapValue(${key}) maps onto its own keys (${cyclic.join(", ")}), so it would not settle`);
+    }
+    return { kind: "mapValue", describe: `converts ${key} from its old values`, key, mapping };
+};
+export const pinDefault = (key, value) => ({
+    kind: "pinDefault",
+    describe: `keeps the earlier default for ${key}`,
+    key,
+    value,
+});
+export const transform = (describe, applies, convert) => ({ kind: "transform", describe, applies, convert });
+export const fold = (describe, shape) => ({ kind: "fold", describe, from: shape.from, into: shape.into, applies: shape.applies, convert: shape.convert });
+export const dropAll = (keys) => keys.map((key) => drop(key));
+export const nested = (path, history, entries) => history.map((conversion) => at(conversion.kind === "retireEntries" || entries !== true ? path : `${path}.*`, conversion));
+export const retireEntries = (describe, isRetired) => ({
+    kind: "retireEntries",
+    describe,
+    isRetired,
+});
+export const at = (path, inner) => ({
+    kind: "at",
+    describe: `${inner.describe} under ${path}`,
+    path,
+    inner,
+});
+const applyToObject = (conversion, target, where, report) => {
+    switch (conversion.kind) {
+        case "rename": {
+            if (!Object.hasOwn(target, conversion.from)) {
+                return target;
+            }
+            if (!Object.hasOwn(target, conversion.to)) {
+                report({ conversion: conversion.describe, at: where });
+                return renamedKey(target, conversion.from, conversion.to);
+            }
+            if (JSON.stringify(target[conversion.from]) === JSON.stringify(target[conversion.to])) {
+                return withoutKey(target, conversion.from);
+            }
+            report({ conversion: conversion.describe, at: where, detail: `kept ${conversion.to}; ${conversion.from} held ${glimpse(target[conversion.from])}` });
+            return withoutKey(target, conversion.from);
+        }
+        case "drop": {
+            if (!Object.hasOwn(target, conversion.key)) {
+                return target;
+            }
+            report({ conversion: conversion.describe, at: where, detail: `it held ${glimpse(target[conversion.key])}` });
+            return withoutKey(target, conversion.key);
+        }
+        case "retype": {
+            const value = target[conversion.key];
+            if (!Object.hasOwn(target, conversion.key) || !conversion.guard(value)) {
+                return target;
+            }
+            report({ conversion: conversion.describe, at: where });
+            return { ...target, [conversion.key]: conversion.convert(value) };
+        }
+        case "mapValue": {
+            const value = target[conversion.key];
+            if (typeof value !== "string" || !Object.hasOwn(conversion.mapping, value)) {
+                return target;
+            }
+            report({ conversion: conversion.describe, at: where, detail: `${glimpse(value)} became ${glimpse(conversion.mapping[value])}` });
+            return { ...target, [conversion.key]: conversion.mapping[value] };
+        }
+        case "pinDefault": {
+            if (Object.hasOwn(target, conversion.key)) {
+                return target;
+            }
+            report({ conversion: conversion.describe, at: where });
+            return { ...target, [conversion.key]: conversion.value };
+        }
+        case "transform": {
+            if (!conversion.applies(target)) {
+                return target;
+            }
+            report({ conversion: conversion.describe, at: where });
+            return conversion.convert(target);
+        }
+        case "fold":
+            return applyFold(conversion, target, where, report);
+        case "retireEntries":
+            return target;
+        case "at":
+            return applyAt(conversion.inner, conversion.path.split("."), target, where, report);
+    }
+};
+const applyFold = (conversion, target, where, report) => {
+    if (!conversion.applies(target)) {
+        return target;
+    }
+    const folded = new Set(conversion.from);
+    const fields = Object.fromEntries(Object.entries(target).filter(([key]) => folded.has(key)));
+    const entries = Object.entries(target);
+    const first = entries.findIndex(([key]) => folded.has(key));
+    const kept = entries.filter(([key]) => !folded.has(key) && key !== conversion.into);
+    kept.splice(first === -1 ? kept.length : Math.min(first, kept.length), 0, [conversion.into, conversion.convert(fields, target)]);
+    report({ conversion: conversion.describe, at: where });
+    return Object.fromEntries(kept);
+};
+const retireFrom = (conversion, container, where, report) => {
+    const retired = (entry, place) => {
+        if (!conversion.isRetired(entry)) {
+            return false;
+        }
+        report({ conversion: conversion.describe, at: place, detail: glimpse(entry) });
+        return true;
+    };
+    if (Array.isArray(container)) {
+        const kept = container.filter((entry, index) => !retired(entry, joinWhere(where, `[${index}]`)));
+        return kept.length === container.length ? container : kept;
+    }
+    if (!isJsonObject(container)) {
+        return container;
+    }
+    const kept = Object.entries(container).filter(([key, entry]) => !retired(entry, joinWhere(where, key)));
+    return kept.length === Object.keys(container).length ? container : Object.fromEntries(kept);
+};
+const joinWhere = (where, segment) => (segment.startsWith("[") || where === "" ? `${where}${segment}` : `${where}.${segment}`);
+const applyToEach = (visit, container, where) => {
+    if (Array.isArray(container)) {
+        const next = container.map((value, index) => visit(value, joinWhere(where, `[${index}]`)));
+        return next.some((value, index) => value !== container[index]) ? next : container;
+    }
+    if (!isJsonObject(container)) {
+        return container;
+    }
+    const entries = Object.entries(container);
+    const next = entries.map(([key, value]) => [key, visit(value, joinWhere(where, key))]);
+    return next.some(([, value], index) => value !== entries[index]?.[1]) ? Object.fromEntries(next) : container;
+};
+const applyAt = (inner, segments, value, where, report) => {
+    const [head, ...rest] = segments;
+    if (head === undefined) {
+        if (inner.kind === "retireEntries") {
+            return retireFrom(inner, value, where, report);
+        }
+        return isJsonObject(value) ? applyToObject(inner, value, where, report) : value;
+    }
+    if (head === "*") {
+        return applyToEach((element, elementWhere) => applyAt(inner, rest, element, elementWhere, report), value, where);
+    }
+    if (!isJsonObject(value) || !Object.hasOwn(value, head)) {
+        return value;
+    }
+    const child = value[head];
+    const next = applyAt(inner, rest, child, joinWhere(where, head), report);
+    return next === child ? value : { ...value, [head]: next };
+};
+const applyOne = (conversion, granularity, value, report) => {
+    if (conversion.kind === "retireEntries" && granularity !== "object") {
+        return retireFrom(conversion, value, "", report);
+    }
+    if (granularity === "object") {
+        return isJsonObject(value) ? applyToObject(conversion, value, "", report) : value;
+    }
+    const container = granularity === "entries" ? Array.isArray(value) : isJsonObject(value);
+    return container ? applyToEach((entry, where) => (isJsonObject(entry) ? applyToObject(conversion, entry, where, report) : entry), value, "") : value;
+};
+export class ConversionError extends Error {
+    conversion;
+    constructor(conversion, cause) {
+        super(`conversion "${conversion}" failed: ${cause instanceof Error ? cause.message : String(cause)}`, { cause });
+        this.name = "ConversionError";
+        this.conversion = conversion;
+    }
+}
+const applyAll = (conversions, granularity, raw, report) => {
+    let value = raw;
+    for (const conversion of conversions) {
+        try {
+            value = applyOne(conversion, granularity, value, report);
+        }
+        catch (error) {
+            throw new ConversionError(conversion.describe, error);
+        }
+    }
+    return value;
+};
+export const convertDocument = (conversions, granularity, raw, checkSettles = false) => {
+    if (conversions.length === 0) {
+        return { value: raw, changes: [] };
+    }
+    const changes = [];
+    const value = applyAll(conversions, granularity, raw, (change) => changes.push(change));
+    if (checkSettles && changes.length > 0) {
+        const again = [];
+        const settled = applyAll(conversions, granularity, value, (change) => again.push(change));
+        if (settled !== value || again.length > 0) {
+            throw new ConversionError(again[0]?.conversion ?? "unknown", new Error("it changed its own output, so it would run on every read"));
+        }
+    }
+    return { value, changes };
+};
+export const describeConversions = (conversions) => conversions.map((conversion) => conversion.describe);
+//# sourceMappingURL=conversions.js.map

package/dist/documents/conversions.js.map

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

package/dist/documents/index.d.ts

@@ -0,0 +1,4 @@
+export * from "./conversions.js";
+export * from "./passthrough.js";
+export * from "./read.js";
+//# sourceMappingURL=index.d.ts.map

package/dist/documents/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/documents/index.ts"],"names":[],"mappings":"AAIA,cAAc,kBAAkB,CAAC;AACjC,cAAc,kBAAkB,CAAC;AACjC,cAAc,WAAW,CAAC"}

package/dist/documents/index.js

@@ -0,0 +1,4 @@
+export * from "./conversions.js";
+export * from "./passthrough.js";
+export * from "./read.js";
+//# sourceMappingURL=index.js.map

package/dist/documents/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/documents/index.ts"],"names":[],"mappings":"AAIA,cAAc,kBAAkB,CAAC;AACjC,cAAc,kBAAkB,CAAC;AACjC,cAAc,WAAW,CAAC"}

package/dist/documents/passthrough.d.ts

@@ -0,0 +1,13 @@
+export type IdKeys = readonly string[];
+export declare const carryUnknown: (raw: unknown, parsed: unknown, updated: unknown, idKeys?: IdKeys) => unknown;
+export interface EntryRead<E> {
+    readonly entries: E[];
+    readonly aligned: readonly unknown[];
+    readonly quarantined: readonly {
+        readonly index: number;
+        readonly entry: unknown;
+    }[];
+}
+export declare const readEntries: <E>(raw: readonly unknown[], parseEntry: (entry: unknown) => E | undefined) => EntryRead<E>;
+export declare const reemitQuarantined: (updated: readonly unknown[], quarantined: EntryRead<unknown>["quarantined"], idKeys?: IdKeys) => readonly unknown[];
+//# sourceMappingURL=passthrough.d.ts.map

package/dist/documents/passthrough.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"passthrough.d.ts","sourceRoot":"","sources":["../../src/documents/passthrough.ts"],"names":[],"mappings":"AAgBA,MAAM,MAAM,MAAM,GAAG,SAAS,MAAM,EAAE,CAAC;AAuEvC,eAAO,MAAM,YAAY,QAAS,OAAO,UAAU,OAAO,WAAW,OAAO,WAAU,MAAM,KAAqB,OAQhH,CAAC;AAIF,MAAM,WAAW,SAAS,CAAC,CAAC;IACxB,QAAQ,CAAC,OAAO,EAAE,CAAC,EAAE,CAAC;IACtB,QAAQ,CAAC,OAAO,EAAE,SAAS,OAAO,EAAE,CAAC;IACrC,QAAQ,CAAC,WAAW,EAAE,SAAS;QAAE,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;QAAC,QAAQ,CAAC,KAAK,EAAE,OAAO,CAAA;KAAE,EAAE,CAAC;CACxF;AAED,eAAO,MAAM,WAAW,GAAI,CAAC,OAAO,SAAS,OAAO,EAAE,cAAc,CAAC,KAAK,EAAE,OAAO,KAAK,CAAC,GAAG,SAAS,KAAG,SAAS,CAAC,CAAC,CAclH,CAAC;AAIF,eAAO,MAAM,iBAAiB,YACjB,SAAS,OAAO,EAAE,eACd,SAAS,CAAC,OAAO,CAAC,CAAC,aAAa,CAAC,WACtC,MAAM,KACf,SAAS,OAAO,EAWlB,CAAC"}

package/dist/documents/passthrough.js

@@ -0,0 +1,101 @@
+import { isJsonObject } from "./conversions.js";
+const DISCRIMINATORS = ["kind", "type"];
+const sameArm = (parsed, updated) => DISCRIMINATORS.every((key) => typeof parsed[key] !== "string" || parsed[key] === updated[key]);
+const DEFAULT_ID_KEYS = ["id"];
+const carryObject = (raw, parsed, updated, idKeys) => {
+    if (!sameArm(parsed, updated)) {
+        return updated;
+    }
+    let result;
+    for (const [key, value] of Object.entries(raw)) {
+        if (!Object.hasOwn(updated, key)) {
+            if (!Object.hasOwn(parsed, key)) {
+                result ??= { ...updated };
+                result[key] = value;
+            }
+            continue;
+        }
+        if (Object.hasOwn(parsed, key)) {
+            const carried = carryUnknown(value, parsed[key], updated[key], idKeys);
+            if (carried !== updated[key]) {
+                result ??= { ...updated };
+                result[key] = carried;
+            }
+        }
+    }
+    return result ?? updated;
+};
+const idOf = (value, idKeys) => {
+    if (!isJsonObject(value)) {
+        return undefined;
+    }
+    const id = idKeys.map((key) => value[key]).find((candidate) => typeof candidate === "string");
+    return typeof id === "string" ? id : undefined;
+};
+const carryArray = (raw, parsed, updated, idKeys) => {
+    if (raw.length !== parsed.length) {
+        return updated;
+    }
+    const rawOfParsed = new Map();
+    const indexOfId = new Map();
+    parsed.forEach((element, index) => {
+        if (typeof element === "object" && element !== null) {
+            rawOfParsed.set(element, raw[index]);
+        }
+        const id = idOf(element, idKeys);
+        if (id !== undefined) {
+            indexOfId.set(id, index);
+        }
+    });
+    let result;
+    updated.forEach((element, index) => {
+        const byId = indexOfId.get(idOf(element, idKeys) ?? "");
+        const [source, before] = rawOfParsed.has(element) ? [rawOfParsed.get(element), element] : byId === undefined ? [undefined, undefined] : [raw[byId], parsed[byId]];
+        if (source === undefined) {
+            return;
+        }
+        const carried = carryUnknown(source, before, element, idKeys);
+        if (carried !== element) {
+            result ??= [...updated];
+            result[index] = carried;
+        }
+    });
+    return result ?? updated;
+};
+export const carryUnknown = (raw, parsed, updated, idKeys = DEFAULT_ID_KEYS) => {
+    if (isJsonObject(raw) && isJsonObject(parsed) && isJsonObject(updated)) {
+        return carryObject(raw, parsed, updated, idKeys);
+    }
+    if (Array.isArray(raw) && Array.isArray(parsed) && Array.isArray(updated)) {
+        return carryArray(raw, parsed, updated, idKeys);
+    }
+    return updated;
+};
+export const readEntries = (raw, parseEntry) => {
+    const entries = [];
+    const aligned = [];
+    const quarantined = [];
+    raw.forEach((entry, index) => {
+        const parsed = parseEntry(entry);
+        if (parsed === undefined) {
+            quarantined.push({ index, entry });
+            return;
+        }
+        entries.push(parsed);
+        aligned.push(entry);
+    });
+    return { entries, aligned, quarantined };
+};
+export const reemitQuarantined = (updated, quarantined, idKeys = DEFAULT_ID_KEYS) => {
+    const written = new Set(updated.map((entry) => idOf(entry, idKeys)).filter((id) => id !== undefined));
+    const kept = quarantined.filter(({ entry }) => !written.has(idOf(entry, idKeys) ?? "\u0000"));
+    if (kept.length === 0) {
+        return updated;
+    }
+    const result = [...updated];
+    for (const { index, entry } of kept) {
+        result.splice(Math.min(index, result.length), 0, entry);
+    }
+    return result;
+};
+//# sourceMappingURL=passthrough.js.map

package/dist/documents/passthrough.js.map

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

package/dist/documents/read.d.ts

@@ -0,0 +1,24 @@
+import type { ManifestProblem } from "../schemas/system.js";
+import { type Conversion, type Granularity } from "./conversions.js";
+import { type IdKeys } from "./passthrough.js";
+export interface DocumentShape {
+    readonly history: readonly Conversion[];
+    readonly granularity: Granularity;
+}
+type Report = (problem: ManifestProblem) => void;
+export type DocumentParse<T> = {
+    readonly kind: "whole";
+    readonly parse: (raw: unknown, report: Report) => T | undefined;
+} | {
+    readonly kind: "entries";
+    readonly entry: (raw: unknown, report: Report) => (T extends readonly (infer E)[] ? E : never) | undefined;
+    readonly idKeys?: IdKeys;
+};
+export interface DocumentRead<T> {
+    readonly value: T | undefined;
+    readonly carry: (updated: T) => unknown;
+    readonly problems: readonly ManifestProblem[];
+}
+export declare const readDocument: <T>(text: string, shape: DocumentShape, how: DocumentParse<T>, checkSettles?: boolean) => DocumentRead<T>;
+export {};
+//# sourceMappingURL=read.d.ts.map

package/dist/documents/read.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"read.d.ts","sourceRoot":"","sources":["../../src/documents/read.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,sBAAsB,CAAC;AAC5D,OAAO,EAAE,KAAK,UAAU,EAAmB,KAAK,WAAW,EAAE,MAAM,kBAAkB,CAAC;AACtF,OAAO,EAAgB,KAAK,MAAM,EAAqB,MAAM,kBAAkB,CAAC;AAQhF,MAAM,WAAW,aAAa;IAC1B,QAAQ,CAAC,OAAO,EAAE,SAAS,UAAU,EAAE,CAAC;IACxC,QAAQ,CAAC,WAAW,EAAE,WAAW,CAAC;CACrC;AAED,KAAK,MAAM,GAAG,CAAC,OAAO,EAAE,eAAe,KAAK,IAAI,CAAC;AAEjD,MAAM,MAAM,aAAa,CAAC,CAAC,IAErB;IAAE,QAAQ,CAAC,IAAI,EAAE,OAAO,CAAC;IAAC,QAAQ,CAAC,KAAK,EAAE,CAAC,GAAG,EAAE,OAAO,EAAE,MAAM,EAAE,MAAM,KAAK,CAAC,GAAG,SAAS,CAAA;CAAE,GAI3F;IACI,QAAQ,CAAC,IAAI,EAAE,SAAS,CAAC;IACzB,QAAQ,CAAC,KAAK,EAAE,CAAC,GAAG,EAAE,OAAO,EAAE,MAAM,EAAE,MAAM,KAAK,CAAC,CAAC,SAAS,SAAS,CAAC,MAAM,CAAC,CAAC,EAAE,GAAG,CAAC,GAAG,KAAK,CAAC,GAAG,SAAS,CAAC;IAC3G,QAAQ,CAAC,MAAM,CAAC,EAAE,MAAM,CAAC;CAC5B,CAAC;AAER,MAAM,WAAW,YAAY,CAAC,CAAC;IAE3B,QAAQ,CAAC,KAAK,EAAE,CAAC,GAAG,SAAS,CAAC;IAE9B,QAAQ,CAAC,KAAK,EAAE,CAAC,OAAO,EAAE,CAAC,KAAK,OAAO,CAAC;IACxC,QAAQ,CAAC,QAAQ,EAAE,SAAS,eAAe,EAAE,CAAC;CACjD;AAWD,eAAO,MAAM,YAAY,GAAI,CAAC,QAAQ,MAAM,SAAS,aAAa,OAAO,aAAa,CAAC,CAAC,CAAC,6BAAyB,YAAY,CAAC,CAAC,CAmE/H,CAAC"}

package/dist/documents/read.js

@@ -0,0 +1,81 @@
+import { convertDocument } from "./conversions.js";
+import { carryUnknown, reemitQuarantined } from "./passthrough.js";
+const message = (error) => (error instanceof Error ? error.message : String(error));
+const unreadable = (reason, detail) => ({
+    value: undefined,
+    carry: (updated) => updated,
+    problems: [{ kind: "unreadable", reason, detail }],
+});
+export const readDocument = (text, shape, how, checkSettles = false) => {
+    let raw;
+    try {
+        raw = JSON.parse(text);
+    }
+    catch {
+        return unreadable("not-json", "the file is not valid JSON");
+    }
+    const problems = [];
+    const report = (problem) => problems.push(problem);
+    if (how.kind === "entries") {
+        if (!Array.isArray(raw)) {
+            return unreadable("rejected", "the file does not match what this build expects");
+        }
+        const perEntry = shape.granularity === "entries";
+        const entries = [];
+        const aligned = [];
+        const quarantined = [];
+        let whole = raw;
+        if (!perEntry && shape.history.length > 0) {
+            try {
+                const converted = convertDocument(shape.history, shape.granularity, raw, checkSettles).value;
+                whole = Array.isArray(converted) ? converted : [];
+            }
+            catch (error) {
+                return unreadable("conversion-failed", `a conversion to this build's shape failed (${message(error)})`);
+            }
+        }
+        whole.forEach((written, index) => {
+            let candidates;
+            try {
+                const value = perEntry ? convertDocument(shape.history, "entries", [written], checkSettles).value : [written];
+                candidates = Array.isArray(value) ? value : [value];
+            }
+            catch (error) {
+                quarantined.push({ index, entry: written });
+                report({
+                    kind: "invalidEntry",
+                    reason: "conversion-failed",
+                    detail: `entry ${index} could not be converted to this build's shape (${message(error)}); it is kept as written`,
+                });
+                return;
+            }
+            for (const candidate of candidates) {
+                const parsed = how.entry(candidate, report);
+                if (parsed === undefined) {
+                    quarantined.push({ index, entry: candidate });
+                    report({ kind: "invalidEntry", reason: "rejected", detail: `entry ${index} is not one this build can read; it is kept as written` });
+                    continue;
+                }
+                entries.push(parsed);
+                aligned.push(candidate);
+            }
+        });
+        return {
+            value: entries,
+            carry: (updated) => reemitQuarantined(carryUnknown(aligned, entries, updated, how.idKeys), quarantined, how.idKeys),
+            problems,
+        };
+    }
+    try {
+        raw = convertDocument(shape.history, shape.granularity, raw, checkSettles).value;
+    }
+    catch (error) {
+        return unreadable("conversion-failed", `a conversion to this build's shape failed (${message(error)})`);
+    }
+    const value = how.parse(raw, report);
+    if (value === undefined) {
+        return unreadable("rejected", "the file does not match what this build expects");
+    }
+    return { value, carry: (updated) => carryUnknown(raw, value, updated), problems };
+};
+//# sourceMappingURL=read.js.map

package/dist/documents/read.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"read.js","sourceRoot":"","sources":["../../src/documents/read.ts"],"names":[],"mappings":"AACA,OAAO,EAAmB,eAAe,EAAoB,MAAM,kBAAkB,CAAC;AACtF,OAAO,EAAE,YAAY,EAAe,iBAAiB,EAAE,MAAM,kBAAkB,CAAC;AAmChF,MAAM,OAAO,GAAG,CAAC,KAAc,EAAU,EAAE,CAAC,CAAC,KAAK,YAAY,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC,CAAC;AAErG,MAAM,UAAU,GAAG,CAAI,MAA8C,EAAE,MAAc,EAAmB,EAAE,CAAC,CAAC;IACxG,KAAK,EAAE,SAAS;IAChB,KAAK,EAAE,CAAC,OAAO,EAAE,EAAE,CAAC,OAAO;IAC3B,QAAQ,EAAE,CAAC,EAAE,IAAI,EAAE,YAAY,EAAE,MAAM,EAAE,MAAM,EAAE,CAAC;CACrD,CAAC,CAAC;AAGH,MAAM,CAAC,MAAM,YAAY,GAAG,CAAI,IAAY,EAAE,KAAoB,EAAE,GAAqB,EAAE,YAAY,GAAG,KAAK,EAAmB,EAAE;IAChI,IAAI,GAAY,CAAC;IACjB,IAAI,CAAC;QACD,GAAG,GAAG,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC;IAC3B,CAAC;IAAC,MAAM,CAAC;QACL,OAAO,UAAU,CAAC,UAAU,EAAE,4BAA4B,CAAC,CAAC;IAChE,CAAC;IACD,MAAM,QAAQ,GAAsB,EAAE,CAAC;IACvC,MAAM,MAAM,GAAW,CAAC,OAAO,EAAE,EAAE,CAAC,QAAQ,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC;IAC3D,IAAI,GAAG,CAAC,IAAI,KAAK,SAAS,EAAE,CAAC;QACzB,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,GAAG,CAAC,EAAE,CAAC;YACtB,OAAO,UAAU,CAAC,UAAU,EAAE,iDAAiD,CAAC,CAAC;QACrF,CAAC;QACD,MAAM,QAAQ,GAAG,KAAK,CAAC,WAAW,KAAK,SAAS,CAAC;QACjD,MAAM,OAAO,GAAc,EAAE,CAAC;QAC9B,MAAM,OAAO,GAAc,EAAE,CAAC;QAC9B,MAAM,WAAW,GAAwC,EAAE,CAAC;QAC5D,IAAI,KAAK,GAAuB,GAAG,CAAC;QACpC,IAAI,CAAC,QAAQ,IAAI,KAAK,CAAC,OAAO,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;YACxC,IAAI,CAAC;gBACD,MAAM,SAAS,GAAG,eAAe,CAAC,KAAK,CAAC,OAAO,EAAE,KAAK,CAAC,WAAW,EAAE,GAAG,EAAE,YAAY,CAAC,CAAC,KAAK,CAAC;gBAC7F,KAAK,GAAG,KAAK,CAAC,OAAO,CAAC,SAAS,CAAC,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC,CAAC,EAAE,CAAC;YACtD,CAAC;YAAC,OAAO,KAAK,EAAE,CAAC;gBACb,OAAO,UAAU,CAAC,mBAAmB,EAAE,8CAA8C,OAAO,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC;YAC5G,CAAC;QACL,CAAC;QACD,KAAK,CAAC,OAAO,CAAC,CAAC,OAAO,EAAE,KAAK,EAAE,EAAE;YAC7B,IAAI,UAA8B,CAAC;YACnC,IAAI,CAAC;gBACD,MAAM,KAAK,GAAG,QAAQ,CAAC,CAAC,CAAC,eAAe,CAAC,KAAK,CAAC,OAAO,EAAE,SAAS,EAAE,CAAC,OAAO,CAAC,EAAE,YAAY,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,OAAO,CAAC,CAAC;gBAC9G,UAAU,GAAG,KAAK,CAAC,OAAO,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC;YACxD,CAAC;YAAC,OAAO,KAAK,EAAE,CAAC;gBACb,WAAW,CAAC,IAAI,CAAC,EAAE,KAAK,EAAE,KAAK,EAAE,OAAO,EAAE,CAAC,CAAC;gBAC5C,MAAM,CAAC;oBACH,IAAI,EAAE,cAAc;oBACpB,MAAM,EAAE,mBAAmB;oBAC3B,MAAM,EAAE,SAAS,KAAK,kDAAkD,OAAO,CAAC,KAAK,CAAC,0BAA0B;iBACnH,CAAC,CAAC;gBACH,OAAO;YACX,CAAC;YACD,KAAK,MAAM,SAAS,IAAI,UAAU,EAAE,CAAC;gBACjC,MAAM,MAAM,GAAG,GAAG,CAAC,KAAK,CAAC,SAAS,EAAE,MAAM,CAAC,CAAC;gBAC5C,IAAI,MAAM,KAAK,SAAS,EAAE,CAAC;oBACvB,WAAW,CAAC,IAAI,CAAC,EAAE,KAAK,EAAE,KAAK,EAAE,SAAS,EAAE,CAAC,CAAC;oBAC9C,MAAM,CAAC,EAAE,IAAI,EAAE,cAAc,EAAE,MAAM,EAAE,UAAU,EAAE,MAAM,EAAE,SAAS,KAAK,wDAAwD,EAAE,CAAC,CAAC;oBACrI,SAAS;gBACb,CAAC;gBACD,OAAO,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC;gBACrB,OAAO,CAAC,IAAI,CAAC,SAAS,CAAC,CAAC;YAC5B,CAAC;QACL,CAAC,CAAC,CAAC;QACH,OAAO;YACH,KAAK,EAAE,OAAY;YACnB,KAAK,EAAE,CAAC,OAAO,EAAE,EAAE,CAAC,iBAAiB,CAAC,YAAY,CAAC,OAAO,EAAE,OAAO,EAAE,OAAO,EAAE,GAAG,CAAC,MAAM,CAAuB,EAAE,WAAW,EAAE,GAAG,CAAC,MAAM,CAAC;YACzI,QAAQ;SACX,CAAC;IACN,CAAC;IACD,IAAI,CAAC;QACD,GAAG,GAAG,eAAe,CAAC,KAAK,CAAC,OAAO,EAAE,KAAK,CAAC,WAAW,EAAE,GAAG,EAAE,YAAY,CAAC,CAAC,KAAK,CAAC;IACrF,CAAC;IAAC,OAAO,KAAK,EAAE,CAAC;QACb,OAAO,UAAU,CAAC,mBAAmB,EAAE,8CAA8C,OAAO,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC;IAC5G,CAAC;IACD,MAAM,KAAK,GAAG,GAAG,CAAC,KAAK,CAAC,GAAG,EAAE,MAAM,CAAC,CAAC;IACrC,IAAI,KAAK,KAAK,SAAS,EAAE,CAAC;QACtB,OAAO,UAAU,CAAC,UAAU,EAAE,iDAAiD,CAAC,CAAC;IACrF,CAAC;IACD,OAAO,EAAE,KAAK,EAAE,KAAK,EAAE,CAAC,OAAO,EAAE,EAAE,CAAC,YAAY,CAAC,GAAG,EAAE,KAAK,EAAE,OAAO,CAAC,EAAE,QAAQ,EAAE,CAAC;AACtF,CAAC,CAAC"}