@codyswann/lisa 4.17.19 → 4.19.0

package/dist/cli/ui-config-write-document.d.ts

@@ -0,0 +1,53 @@
+import { type JsonObject, type JsonValue } from "../sync/json-path.js";
+/** Minimum source image needed for one surgical render. */
+export interface ConfigDocumentSource {
+    /** Fixed public filename used only in safe diagnostics. */
+    readonly filename: string;
+    /** Strict UTF-8 JSON source. */
+    readonly text: string;
+    /** Semantic source document paired with the text. */
+    readonly document: JsonObject;
+}
+/** Fully checked textual and semantic prospective document. */
+export interface RenderedConfigDocument {
+    /** Surgical strict-JSON text ready for atomic persistence. */
+    readonly text: string;
+    /** Reparsing result proven structurally equal to the requested edits. */
+    readonly document: JsonObject;
+    /** Whether any owner set or non-owner cleanup changed the source. */
+    readonly changed: boolean;
+}
+/**
+ * Parse one strict, unambiguous object document.
+ *
+ * `JSON.parse` deliberately accepts duplicate object properties using
+ * last-value-wins semantics, while a positional syntax-tree lookup can select
+ * an earlier occurrence. Rejecting duplicates prevents those two views from
+ * claiming a successful write to different semantic documents.
+ * @param text - Strict JSON source or rendered candidate
+ * @param filename - Safe fixed filename used in diagnostics
+ * @returns Parsed JSON object with exactly one value per property
+ */
+export declare function parseConfigDocument(text: string, filename: string): JsonObject;
+/**
+ * Parse strict JSON while refusing recursively duplicated property names.
+ *
+ * This remains separate from the object-document contract because HTTP input
+ * must reject ambiguity before payload shape validation, while preserving the
+ * existing shape-specific 400 responses for valid arrays and scalars.
+ * @param text - Strict JSON source from a bounded, fatal UTF-8 decode
+ * @param filename - Safe fixed label used in diagnostics
+ * @returns Parsed JSON value with exactly one value per object property
+ */
+export declare function parseUnambiguousJson(text: string, filename: string): unknown;
+/**
+ * Apply owner sets after non-owner removals and prove both representations
+ * agree. Ordering is significant for overlapping ancestor/descendant inputs.
+ * @param source - Strict source image to edit
+ * @param removals - Routed owner paths removed from this non-owner document
+ * @param changes - Routed values owned by this document
+ * @param exactRemovals - Exact property paths whose segments may contain dots
+ * @returns Reparsing-verified prospective document and surgical text
+ */
+export declare function renderConfigChanges(source: ConfigDocumentSource, removals: readonly string[], changes: Readonly<Record<string, JsonValue>>, exactRemovals?: readonly (readonly string[])[]): RenderedConfigDocument;
+//# sourceMappingURL=ui-config-write-document.d.ts.map

package/dist/cli/ui-config-write-document.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ui-config-write-document.d.ts","sourceRoot":"","sources":["../../src/cli/ui-config-write-document.ts"],"names":[],"mappings":"AAQA,OAAO,EAIL,KAAK,UAAU,EACf,KAAK,SAAS,EACf,MAAM,sBAAsB,CAAC;AAM9B,2DAA2D;AAC3D,MAAM,WAAW,oBAAoB;IACnC,2DAA2D;IAC3D,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAC;IAC1B,gCAAgC;IAChC,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,qDAAqD;IACrD,QAAQ,CAAC,QAAQ,EAAE,UAAU,CAAC;CAC/B;AAED,+DAA+D;AAC/D,MAAM,WAAW,sBAAsB;IACrC,8DAA8D;IAC9D,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,yEAAyE;IACzE,QAAQ,CAAC,QAAQ,EAAE,UAAU,CAAC;IAC9B,qEAAqE;IACrE,QAAQ,CAAC,OAAO,EAAE,OAAO,CAAC;CAC3B;AASD;;;;;;;;;;GAUG;AACH,wBAAgB,mBAAmB,CACjC,IAAI,EAAE,MAAM,EACZ,QAAQ,EAAE,MAAM,GACf,UAAU,CAMZ;AAED;;;;;;;;;GASG;AACH,wBAAgB,oBAAoB,CAAC,IAAI,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,GAAG,OAAO,CAU5E;AAED;;;;;;;;GAQG;AACH,wBAAgB,mBAAmB,CACjC,MAAM,EAAE,oBAAoB,EAC5B,QAAQ,EAAE,SAAS,MAAM,EAAE,EAC3B,OAAO,EAAE,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,SAAS,CAAC,CAAC,EAC5C,aAAa,GAAE,SAAS,CAAC,SAAS,MAAM,EAAE,CAAC,EAAO,GACjD,sBAAsB,CAiCxB"}

package/dist/cli/ui-config-write-document.js

@@ -0,0 +1,212 @@
+/**
+ * Strict, ambiguity-free surgical editing for UI config documents.
+ *
+ * Strict parsing and the prospective semantic edit stay paired here so the
+ * source-relative planner can be checked by reparsing before publication.
+ * @module cli/ui-config-write-document
+ */
+import { applyEdits, parseTree } from "jsonc-parser";
+import { getAtPropertyPath, isJsonObject, jsonEquals, } from "../sync/json-path.js";
+import { planConfigTextEdits, } from "./ui-config-write-patch-plan.js";
+/**
+ * Parse one strict, unambiguous object document.
+ *
+ * `JSON.parse` deliberately accepts duplicate object properties using
+ * last-value-wins semantics, while a positional syntax-tree lookup can select
+ * an earlier occurrence. Rejecting duplicates prevents those two views from
+ * claiming a successful write to different semantic documents.
+ * @param text - Strict JSON source or rendered candidate
+ * @param filename - Safe fixed filename used in diagnostics
+ * @returns Parsed JSON object with exactly one value per property
+ */
+export function parseConfigDocument(text, filename) {
+    const parsed = parseUnambiguousJson(text, filename);
+    if (!isJsonObject(parsed)) {
+        throw new Error(`${filename} must contain a JSON object`);
+    }
+    return parsed;
+}
+/**
+ * Parse strict JSON while refusing recursively duplicated property names.
+ *
+ * This remains separate from the object-document contract because HTTP input
+ * must reject ambiguity before payload shape validation, while preserving the
+ * existing shape-specific 400 responses for valid arrays and scalars.
+ * @param text - Strict JSON source from a bounded, fatal UTF-8 decode
+ * @param filename - Safe fixed label used in diagnostics
+ * @returns Parsed JSON value with exactly one value per object property
+ */
+export function parseUnambiguousJson(text, filename) {
+    const parsed = JSON.parse(text);
+    const tree = parseTree(text, [], {
+        allowTrailingComma: false,
+        disallowComments: true,
+    });
+    if (tree === undefined || hasDuplicateObjectKey(tree)) {
+        throw new Error(`${filename} contains duplicate object keys`);
+    }
+    return parsed;
+}
+/**
+ * Apply owner sets after non-owner removals and prove both representations
+ * agree. Ordering is significant for overlapping ancestor/descendant inputs.
+ * @param source - Strict source image to edit
+ * @param removals - Routed owner paths removed from this non-owner document
+ * @param changes - Routed values owned by this document
+ * @param exactRemovals - Exact property paths whose segments may contain dots
+ * @returns Reparsing-verified prospective document and surgical text
+ */
+export function renderConfigChanges(source, removals, changes, exactRemovals = []) {
+    const edits = [
+        ...removals.map(key => ({ kind: "remove", path: key.split(".") })),
+        ...exactRemovals.map(path => ({ kind: "remove", path })),
+        ...Object.entries(changes).map(([key, value]) => ({ kind: "set", path: key.split("."), value })),
+    ];
+    const prospective = edits.reduce((state, edit) => applySemanticEdit(state, edit), {
+        document: source.document,
+        changed: false,
+        touched: [],
+    });
+    if (!prospective.changed) {
+        return { text: source.text, document: source.document, changed: false };
+    }
+    const tree = requireConfigTree(source.text, source.filename);
+    const textEdits = planConfigTextEdits(source.text, tree, source.document, prospective.document, prospective.touched);
+    const renderedText = applyEdits(source.text, [...textEdits]);
+    const reparsed = parseConfigDocument(renderedText, source.filename);
+    if (!jsonEquals(reparsed, prospective.document)) {
+        throw new Error(`${source.filename} surgical edit was ambiguous`);
+    }
+    return { text: renderedText, document: reparsed, changed: true };
+}
+/**
+ * Detect ambiguity recursively because a changed path may sit below a duplicate
+ * ancestor even when its own final property appears only once.
+ * @param node - Strict JSON syntax tree node
+ * @returns Whether any object contains the same property more than once
+ */
+function hasDuplicateObjectKey(node) {
+    if (node.type === "object") {
+        const keys = (node.children ?? [])
+            .map(property => property.children?.[0]?.value)
+            .filter((key) => typeof key === "string");
+        if (new Set(keys).size !== keys.length) {
+            return true;
+        }
+    }
+    return (node.children ?? []).some(hasDuplicateObjectKey);
+}
+/**
+ * Apply one edit to the prospective object before planning source ranges.
+ * @param state - Semantic result accumulated from earlier ordered edits
+ * @param edit - Owner set or non-owner removal
+ * @returns Prospective state plus only the edits that changed semantics
+ */
+function applySemanticEdit(state, edit) {
+    if (edit.kind === "remove") {
+        assertRemovalPathIsReachable(state.document, edit.path);
+    }
+    const current = getAtPropertyPath(state.document, edit.path);
+    if ((edit.kind === "remove" && current === undefined) ||
+        (edit.kind === "set" && jsonEquals(current, edit.value))) {
+        return state;
+    }
+    return {
+        document: edit.kind === "remove"
+            ? removeAtPropertyPath(state.document, edit.path)
+            : setAtPropertyPath(state.document, edit.path, edit.value),
+        changed: true,
+        touched: [...state.touched, edit],
+    };
+}
+/**
+ * Reparse the already validated source into the positional tree used for edits.
+ * @param text - Original strict JSON bytes decoded as text
+ * @param filename - Safe fixed filename used in diagnostics
+ * @returns Root object node whose offsets all refer to the original text
+ */
+function requireConfigTree(text, filename) {
+    const tree = parseTree(text, [], {
+        allowTrailingComma: false,
+        disallowComments: true,
+    });
+    if (tree?.type !== "object") {
+        throw new Error(`${filename} must contain a JSON object`);
+    }
+    return tree;
+}
+/**
+ * Refuse descendant cleanup when a scalar or array ancestor shadows its owner.
+ * Deleting that ancestor would also delete data outside the routed path, while
+ * treating the cleanup as a no-op would leave overlay precedence unchanged.
+ * @param root - Non-owner document being reconciled
+ * @param propertyPath - Exact routed owner path that must become absent here
+ */
+function assertRemovalPathIsReachable(root, propertyPath) {
+    const ancestors = propertyPath.slice(0, -1);
+    assertObjectAncestors(root, ancestors);
+}
+/**
+ * Walk only present ancestors: an absent branch cannot shadow anything, while
+ * every present branch must remain an object for exact descendant removal.
+ * @param node - Present object at the current path depth
+ * @param segments - Remaining ancestor segments before the routed leaf
+ */
+function assertObjectAncestors(node, segments) {
+    const [head, ...rest] = segments;
+    if (head === undefined)
+        return;
+    const child = node[head];
+    if (child === undefined)
+        return;
+    if (!isJsonObject(child)) {
+        throw new Error("Config owner cleanup is blocked by a non-object ancestor");
+    }
+    assertObjectAncestors(child, rest);
+}
+/**
+ * Remove exactly one property path while retaining every ancestor and sibling.
+ * @param root - Prospective object to copy
+ * @param propertyPath - Exact path being removed from the non-owner document
+ * @returns Object without that path and with unrelated siblings intact
+ */
+function removeAtPropertyPath(root, propertyPath) {
+    const [head, ...rest] = propertyPath;
+    if (head === undefined) {
+        throw new Error("Config root removal is not writable");
+    }
+    if (rest.length === 0) {
+        const { [head]: _removed, ...remaining } = root;
+        return remaining;
+    }
+    const child = root[head];
+    if (!isJsonObject(child)) {
+        return root;
+    }
+    return { ...root, [head]: removeAtPropertyPath(child, rest) };
+}
+/**
+ * Immutably set an exact property path, creating missing object ancestors.
+ * @param root - Object to copy
+ * @param propertyPath - Exact decoded property names
+ * @param value - JSON value to write
+ * @returns Updated object
+ */
+function setAtPropertyPath(root, propertyPath, value) {
+    const [head, ...rest] = propertyPath;
+    if (head === undefined) {
+        if (!isJsonObject(value)) {
+            throw new Error("Config root replacement requires an object value");
+        }
+        return value;
+    }
+    if (rest.length === 0) {
+        return { ...root, [head]: value };
+    }
+    const child = root[head];
+    return {
+        ...root,
+        [head]: setAtPropertyPath(isJsonObject(child) ? child : {}, rest, value),
+    };
+}
+//# sourceMappingURL=ui-config-write-document.js.map

package/dist/cli/ui-config-write-document.js.map

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

package/dist/cli/ui-config-write-patch-plan.d.ts

@@ -0,0 +1,30 @@
+/**
+ * @file ui-config-write-patch-plan.ts
+ * @description Deterministic non-overlapping patch planning for UI config JSON.
+ * @module cli/ui-config-write-patch-plan
+ */
+import { type Edit as JsonTextEdit, type Node as JsonNode } from "jsonc-parser";
+import { type JsonObject, type JsonValue } from "../sync/json-path.js";
+/** One requested semantic mutation in endpoint order. */
+export type ConfigDocumentEdit = {
+    readonly kind: "remove";
+    readonly path: readonly string[];
+} | {
+    readonly kind: "set";
+    readonly path: readonly string[];
+    readonly value: JsonValue;
+};
+/**
+ * Plan every changed path against one immutable original syntax tree.
+ *
+ * Missing descendants collapse to the first absent/non-object branch, so a
+ * formatter never needs to borrow and replace an unrelated sibling for context.
+ * @param text - Original strict JSON text
+ * @param tree - Original syntax tree whose offsets refer to `text`
+ * @param source - Original semantic document
+ * @param prospective - Final semantic document after ordered edits
+ * @param touched - Ordered edits that changed semantics
+ * @returns Deterministic non-overlapping original-offset text edits
+ */
+export declare function planConfigTextEdits(text: string, tree: JsonNode, source: JsonObject, prospective: JsonObject, touched: readonly ConfigDocumentEdit[]): readonly JsonTextEdit[];
+//# sourceMappingURL=ui-config-write-patch-plan.d.ts.map

package/dist/cli/ui-config-write-patch-plan.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ui-config-write-patch-plan.d.ts","sourceRoot":"","sources":["../../src/cli/ui-config-write-patch-plan.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AACH,OAAO,EAEL,KAAK,IAAI,IAAI,YAAY,EACzB,KAAK,IAAI,IAAI,QAAQ,EACtB,MAAM,cAAc,CAAC;AACtB,OAAO,EAGL,KAAK,UAAU,EACf,KAAK,SAAS,EACf,MAAM,sBAAsB,CAAC;AAQ9B,yDAAyD;AACzD,MAAM,MAAM,kBAAkB,GAC1B;IAAE,QAAQ,CAAC,IAAI,EAAE,QAAQ,CAAC;IAAC,QAAQ,CAAC,IAAI,EAAE,SAAS,MAAM,EAAE,CAAA;CAAE,GAC7D;IACE,QAAQ,CAAC,IAAI,EAAE,KAAK,CAAC;IACrB,QAAQ,CAAC,IAAI,EAAE,SAAS,MAAM,EAAE,CAAC;IACjC,QAAQ,CAAC,KAAK,EAAE,SAAS,CAAC;CAC3B,CAAC;AAEN;;;;;;;;;;;GAWG;AACH,wBAAgB,mBAAmB,CACjC,IAAI,EAAE,MAAM,EACZ,IAAI,EAAE,QAAQ,EACd,MAAM,EAAE,UAAU,EAClB,WAAW,EAAE,UAAU,EACvB,OAAO,EAAE,SAAS,kBAAkB,EAAE,GACrC,SAAS,YAAY,EAAE,CAazB"}

package/dist/cli/ui-config-write-patch-plan.js

@@ -0,0 +1,151 @@
+/**
+ * @file ui-config-write-patch-plan.ts
+ * @description Deterministic non-overlapping patch planning for UI config JSON.
+ * @module cli/ui-config-write-patch-plan
+ */
+import { findNodeAtLocation, } from "jsonc-parser";
+import { getAtPropertyPath, isJsonObject, } from "../sync/json-path.js";
+import { planObjectPatchEdits, serializeConfigValue, } from "./ui-config-write-property-edits.js";
+/**
+ * Plan every changed path against one immutable original syntax tree.
+ *
+ * Missing descendants collapse to the first absent/non-object branch, so a
+ * formatter never needs to borrow and replace an unrelated sibling for context.
+ * @param text - Original strict JSON text
+ * @param tree - Original syntax tree whose offsets refer to `text`
+ * @param source - Original semantic document
+ * @param prospective - Final semantic document after ordered edits
+ * @param touched - Ordered edits that changed semantics
+ * @returns Deterministic non-overlapping original-offset text edits
+ */
+export function planConfigTextEdits(text, tree, source, prospective, touched) {
+    const patches = collapseConfigPatches(source, prospective, touched);
+    const planned = patches.reduce((plan, patch) => planConfigPatch(tree, plan, patch), {
+        replacements: [],
+        groups: [],
+    });
+    return [
+        ...planned.replacements,
+        ...planned.groups.flatMap(group => planObjectPatchEdits(text, tree, group)),
+    ];
+}
+/**
+ * Collapse overlapping changes to the shallowest original source property.
+ * @param source - Original semantic document
+ * @param prospective - Final semantic document after ordered edits
+ * @param touched - Ordered edits that actually changed semantics
+ * @returns Stable property patches with no ancestor/descendant overlap
+ */
+function collapseConfigPatches(source, prospective, touched) {
+    const candidates = touched.map((edit, order) => {
+        const requestedPath = edit.path;
+        const path = edit.kind === "remove"
+            ? requestedPath
+            : findSetPatchPath(source, requestedPath);
+        return { path, value: getAtPropertyPath(prospective, path), order };
+    });
+    const collapsed = [...candidates]
+        .sort((left, right) => left.path.length - right.path.length || left.order - right.order)
+        .reduce((patches, candidate) => {
+        return patches.some(patch => isPathPrefix(patch.path, candidate.path))
+            ? patches
+            : [...patches, candidate];
+    }, []);
+    return [...collapsed].sort((left, right) => left.order - right.order);
+}
+/**
+ * Find the shallowest property whose replacement can express a set operation.
+ * @param node - Original value at the current path depth
+ * @param segments - Remaining requested dot-path segments
+ * @param prefix - Original path already proven to contain objects
+ * @returns Existing leaf or first missing/non-object branch to replace
+ */
+function findSetPatchPath(node, segments, prefix = []) {
+    const [head, ...rest] = segments;
+    if (head === undefined)
+        return prefix;
+    const path = [...prefix, head];
+    if (rest.length === 0)
+        return path;
+    const child = node[head];
+    return isJsonObject(child) ? findSetPatchPath(child, rest, path) : path;
+}
+/**
+ * Compare dot paths without joining them into ambiguous strings.
+ * @param prefix - Candidate ancestor path
+ * @param candidate - Candidate descendant path
+ * @returns Whether every prefix segment matches the candidate
+ */
+function isPathPrefix(prefix, candidate) {
+    return (prefix.length <= candidate.length &&
+        prefix.every((segment, index) => candidate[index] === segment));
+}
+/**
+ * Plan one patch as an existing value replacement or grouped child mutation.
+ * @param tree - Original strict-JSON syntax tree
+ * @param plan - Replacements and object groups accumulated so far
+ * @param plan.replacements - Existing-value edits accumulated so far
+ * @param plan.groups - Direct object-child mutations accumulated so far
+ * @param patch - Collapsed semantic patch
+ * @returns Plan including this patch
+ */
+function planConfigPatch(tree, plan, patch) {
+    const valueNode = findNodeAtLocation(tree, [...patch.path]);
+    if (valueNode !== undefined && patch.value !== undefined) {
+        return {
+            ...plan,
+            replacements: [
+                ...plan.replacements,
+                {
+                    offset: valueNode.offset,
+                    length: valueNode.length,
+                    content: serializeConfigValue(patch.value),
+                },
+            ],
+        };
+    }
+    const parentPath = patch.path.slice(0, -1);
+    const key = patch.path.at(-1);
+    if (key === undefined) {
+        throw new Error("Config root replacement is not writable");
+    }
+    return {
+        ...plan,
+        groups: addObjectPatch(plan.groups, parentPath, key, patch, valueNode !== undefined),
+    };
+}
+/**
+ * Add one insertion or removal to an immutable parent-object group.
+ * @param groups - Groups accumulated for earlier patches
+ * @param parentPath - Original object that owns the direct property
+ * @param key - Direct property name
+ * @param patch - Final insertion value and stable request order
+ * @param removesExisting - Whether the original tree contains this property
+ * @returns Groups including this mutation
+ */
+function addObjectPatch(groups, parentPath, key, patch, removesExisting) {
+    const existing = groups.find(group => pathsEqual(group.parentPath, parentPath));
+    const next = {
+        parentPath,
+        removals: removesExisting
+            ? [...(existing?.removals ?? []), key]
+            : (existing?.removals ?? []),
+        insertions: removesExisting
+            ? (existing?.insertions ?? [])
+            : [...(existing?.insertions ?? []), patch],
+    };
+    return existing === undefined
+        ? [...groups, next]
+        : groups.map(group => pathsEqual(group.parentPath, parentPath) ? next : group);
+}
+/**
+ * Compare two syntax-tree paths exactly.
+ * @param left - First path
+ * @param right - Second path
+ * @returns Whether both contain the same segments in the same order
+ */
+function pathsEqual(left, right) {
+    return (left.length === right.length &&
+        left.every((segment, index) => right[index] === segment));
+}
+//# sourceMappingURL=ui-config-write-patch-plan.js.map

package/dist/cli/ui-config-write-patch-plan.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"ui-config-write-patch-plan.js","sourceRoot":"","sources":["../../src/cli/ui-config-write-patch-plan.ts"],"names":[],"mappings":"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"}

package/dist/cli/ui-config-write-persistence.d.ts

@@ -0,0 +1,19 @@
+import type { JsonObject, JsonValue } from "../sync/json-path.js";
+/** Changes already classified at the request boundary, before any file I/O. */
+export interface RoutedConfigChanges {
+    /** Registry-root or registry-descendant changes for committed governance. */
+    readonly committed: Readonly<Record<string, JsonValue>>;
+    /** Exact console-authorized changes for the gitignored developer overlay. */
+    readonly local: Readonly<Record<string, JsonValue>>;
+}
+/** Callback that enforces registry validators against the prospective config. */
+export type ValidateCommittedConfig = (config: JsonObject) => void;
+/**
+ * Persist one pre-classified request under the project write queue.
+ * @param destDir - Project root containing the two fixed config filenames
+ * @param changes - Changes split by committed versus local ownership
+ * @param validateCommitted - Registry validation applied before either write
+ * @returns Prospective committed config only; local values are never echoed
+ */
+export declare function persistRoutedConfigChanges(destDir: string, changes: RoutedConfigChanges, validateCommitted: ValidateCommittedConfig): Promise<JsonObject>;
+//# sourceMappingURL=ui-config-write-persistence.d.ts.map

package/dist/cli/ui-config-write-persistence.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ui-config-write-persistence.d.ts","sourceRoot":"","sources":["../../src/cli/ui-config-write-persistence.ts"],"names":[],"mappings":"AAyBA,OAAO,KAAK,EAAE,UAAU,EAAE,SAAS,EAAE,MAAM,sBAAsB,CAAC;AA0BlE,+EAA+E;AAC/E,MAAM,WAAW,mBAAmB;IAClC,6EAA6E;IAC7E,QAAQ,CAAC,SAAS,EAAE,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,SAAS,CAAC,CAAC,CAAC;IACxD,6EAA6E;IAC7E,QAAQ,CAAC,KAAK,EAAE,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,SAAS,CAAC,CAAC,CAAC;CACrD;AAoBD,iFAAiF;AACjF,MAAM,MAAM,uBAAuB,GAAG,CAAC,MAAM,EAAE,UAAU,KAAK,IAAI,CAAC;AAEnE;;;;;;GAMG;AACH,wBAAsB,0BAA0B,CAC9C,OAAO,EAAE,MAAM,EACf,OAAO,EAAE,mBAAmB,EAC5B,iBAAiB,EAAE,uBAAuB,GACzC,OAAO,CAAC,UAAU,CAAC,CAwCrB"}