@memoarchitect/tools 0.6.7 → 0.8.7

package/packages/tools/lib/server/mutation-domain.d.ts

@@ -0,0 +1,22 @@
+/** Which store an action is allowed to write. */
+export type MutationDomain = 'semantic' | 'layout' | 'neither';
+/** Payload keys that only ever describe presentation. */
+export declare const LAYOUT_ONLY_FIELDS: readonly string[];
+export declare function mutationDomain(messageType: string): MutationDomain;
+/** A mutation carrying data from a domain it is not allowed to write. */
+export declare class MixedMutationDomainError extends Error {
+    readonly messageType: string;
+    readonly offendingFields: readonly string[];
+    constructor(messageType: string, offendingFields: readonly string[]);
+}
+/**
+ * Refuse a semantic mutation that also carries layout data.
+ *
+ * The check runs on the payload rather than trusting the caller, because the
+ * mixture arrives from a client: a properties panel that happened to spread a
+ * node object into its save request would otherwise write a canvas position
+ * into `.sysml` as an ordinary attribute, and nothing downstream would tell it
+ * apart from a modelled one.
+ */
+export declare function assertSingleDomainMutation(messageType: string, payload: unknown): void;
+//# sourceMappingURL=mutation-domain.d.ts.map

package/packages/tools/lib/server/mutation-domain.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"mutation-domain.d.ts","sourceRoot":"","sources":["../../src/server/mutation-domain.ts"],"names":[],"mappings":"AAsBA,iDAAiD;AACjD,MAAM,MAAM,cAAc,GAAG,UAAU,GAAG,QAAQ,GAAG,SAAS,CAAC;AAE/D,yDAAyD;AACzD,eAAO,MAAM,kBAAkB,EAAE,SAAS,MAAM,EAE/C,CAAC;AA0BF,wBAAgB,cAAc,CAAC,WAAW,EAAE,MAAM,GAAG,cAAc,CAElE;AAED,yEAAyE;AACzE,qBAAa,wBAAyB,SAAQ,KAAK;IACnC,QAAQ,CAAC,WAAW,EAAE,MAAM;IAAE,QAAQ,CAAC,eAAe,EAAE,SAAS,MAAM,EAAE;gBAAhE,WAAW,EAAE,MAAM,EAAW,eAAe,EAAE,SAAS,MAAM,EAAE;CAQxF;AAED;;;;;;;;GAQG;AACH,wBAAgB,0BAA0B,CAAC,WAAW,EAAE,MAAM,EAAE,OAAO,EAAE,OAAO,GAAG,IAAI,CAStF"}

package/packages/tools/lib/server/mutation-domain.js

@@ -0,0 +1,87 @@
+// ─── One action, one domain ─────────────────────────────────────────────────
+//
+// A MEMO project keeps two kinds of state, and they are not the same kind of
+// fact:
+//
+//   semantic — what the model says. Lives in `.sysml`, reviewed, diffed,
+//              versioned, and read by every tool that reads SysML.
+//   layout   — where a symbol sits on a canvas. Lives in a `.viewlayout`
+//              sidecar, and says nothing about the model.
+//
+// The rule this module enforces is that **no single action writes both**.
+// Moving a symbol must produce no `.sysml` diff, and editing a declaration must
+// leave the sidecar alone. The reason is reviewability: once a drag can change
+// source, a semantic diff can no longer be read as a semantic change, and once
+// a semantic edit can move symbols, a layout diff stops being noise you can
+// safely ignore.
+//
+// Keeping it as a check rather than a convention means a new handler cannot
+// quietly reintroduce the mixture: an unclassified mutation is a failure, not a
+// default.
+// ─────────────────────────────────────────────────────────────────────────────
+/** Payload keys that only ever describe presentation. */
+export const LAYOUT_ONLY_FIELDS = [
+    'layout', 'position', 'nodes', 'edges', 'canvas', 'annotations',
+];
+/**
+ * The domain a server message writes.
+ *
+ * Deliberately explicit rather than pattern-matched on the message name: a
+ * message whose domain nobody decided is the one that ends up writing both.
+ */
+const MUTATION_DOMAINS = {
+    'element:create': 'semantic',
+    'element:update': 'semantic',
+    'element:delete': 'semantic',
+    'element:remap-kinds': 'semantic',
+    'relationship:create': 'semantic',
+    'relationship:delete': 'semantic',
+    'diagram:source:save': 'semantic',
+    'methodology:source:save': 'semantic',
+    'csv:import': 'semantic',
+    'diagram:layout:update': 'layout',
+    // User diagrams are a sidecar too — a saved view is presentation state, and
+    // creating one has never written SysML.
+    'diagram:create': 'layout',
+    'diagram:update': 'layout',
+    'diagram:delete': 'layout',
+};
+export function mutationDomain(messageType) {
+    return MUTATION_DOMAINS[messageType] ?? 'neither';
+}
+/** A mutation carrying data from a domain it is not allowed to write. */
+export class MixedMutationDomainError extends Error {
+    messageType;
+    offendingFields;
+    constructor(messageType, offendingFields) {
+        super(`"${messageType}" is a ${mutationDomain(messageType)} mutation but carries layout data `
+            + `(${offendingFields.join(', ')}). Layout changes go to the view sidecar and semantic `
+            + 'changes go to SysML source; one action never writes both.');
+        this.messageType = messageType;
+        this.offendingFields = offendingFields;
+        this.name = 'MixedMutationDomainError';
+    }
+}
+/**
+ * Refuse a semantic mutation that also carries layout data.
+ *
+ * The check runs on the payload rather than trusting the caller, because the
+ * mixture arrives from a client: a properties panel that happened to spread a
+ * node object into its save request would otherwise write a canvas position
+ * into `.sysml` as an ordinary attribute, and nothing downstream would tell it
+ * apart from a modelled one.
+ */
+export function assertSingleDomainMutation(messageType, payload) {
+    if (mutationDomain(messageType) !== 'semantic')
+        return;
+    if (!payload || typeof payload !== 'object')
+        return;
+    const record = payload;
+    const offending = LAYOUT_ONLY_FIELDS.filter(field => record[field] !== undefined);
+    // Attributes are modelled data and are written to source by definition, so
+    // a modelled attribute *named* `position` is legitimate; only top-level
+    // payload fields are presentation.
+    if (offending.length > 0)
+        throw new MixedMutationDomainError(messageType, offending);
+}
+//# sourceMappingURL=mutation-domain.js.map

package/packages/tools/lib/server/mutation-domain.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"mutation-domain.js","sourceRoot":"","sources":["../../src/server/mutation-domain.ts"],"names":[],"mappings":"AAAA,+EAA+E;AAC/E,EAAE;AACF,6EAA6E;AAC7E,QAAQ;AACR,EAAE;AACF,yEAAyE;AACzE,mEAAmE;AACnE,yEAAyE;AACzE,0DAA0D;AAC1D,EAAE;AACF,0EAA0E;AAC1E,gFAAgF;AAChF,+EAA+E;AAC/E,+EAA+E;AAC/E,4EAA4E;AAC5E,iBAAiB;AACjB,EAAE;AACF,4EAA4E;AAC5E,gFAAgF;AAChF,WAAW;AACX,gFAAgF;AAKhF,yDAAyD;AACzD,MAAM,CAAC,MAAM,kBAAkB,GAAsB;IACjD,QAAQ,EAAE,UAAU,EAAE,OAAO,EAAE,OAAO,EAAE,QAAQ,EAAE,aAAa;CAClE,CAAC;AAEF;;;;;GAKG;AACH,MAAM,gBAAgB,GAAmC;IACrD,gBAAgB,EAAE,UAAU;IAC5B,gBAAgB,EAAE,UAAU;IAC5B,gBAAgB,EAAE,UAAU;IAC5B,qBAAqB,EAAE,UAAU;IACjC,qBAAqB,EAAE,UAAU;IACjC,qBAAqB,EAAE,UAAU;IACjC,qBAAqB,EAAE,UAAU;IACjC,yBAAyB,EAAE,UAAU;IACrC,YAAY,EAAE,UAAU;IACxB,uBAAuB,EAAE,QAAQ;IACjC,4EAA4E;IAC5E,wCAAwC;IACxC,gBAAgB,EAAE,QAAQ;IAC1B,gBAAgB,EAAE,QAAQ;IAC1B,gBAAgB,EAAE,QAAQ;CAC7B,CAAC;AAEF,MAAM,UAAU,cAAc,CAAC,WAAmB;IAC9C,OAAO,gBAAgB,CAAC,WAAW,CAAC,IAAI,SAAS,CAAC;AACtD,CAAC;AAED,yEAAyE;AACzE,MAAM,OAAO,wBAAyB,SAAQ,KAAK;IAC1B;IAA8B;IAAnD,YAAqB,WAAmB,EAAW,eAAkC;QACjF,KAAK,CACD,IAAI,WAAW,UAAU,cAAc,CAAC,WAAW,CAAC,oCAAoC;cACtF,IAAI,eAAe,CAAC,IAAI,CAAC,IAAI,CAAC,wDAAwD;cACtF,2DAA2D,CAChE,CAAC;QALe,gBAAW,GAAX,WAAW,CAAQ;QAAW,oBAAe,GAAf,eAAe,CAAmB;QAMjF,IAAI,CAAC,IAAI,GAAG,0BAA0B,CAAC;IAC3C,CAAC;CACJ;AAED;;;;;;;;GAQG;AACH,MAAM,UAAU,0BAA0B,CAAC,WAAmB,EAAE,OAAgB;IAC5E,IAAI,cAAc,CAAC,WAAW,CAAC,KAAK,UAAU;QAAE,OAAO;IACvD,IAAI,CAAC,OAAO,IAAI,OAAO,OAAO,KAAK,QAAQ;QAAE,OAAO;IACpD,MAAM,MAAM,GAAG,OAAkC,CAAC;IAClD,MAAM,SAAS,GAAG,kBAAkB,CAAC,MAAM,CAAC,KAAK,CAAC,EAAE,CAAC,MAAM,CAAC,KAAK,CAAC,KAAK,SAAS,CAAC,CAAC;IAClF,2EAA2E;IAC3E,wEAAwE;IACxE,mCAAmC;IACnC,IAAI,SAAS,CAAC,MAAM,GAAG,CAAC;QAAE,MAAM,IAAI,wBAAwB,CAAC,WAAW,EAAE,SAAS,CAAC,CAAC;AACzF,CAAC"}

package/packages/tools/lib/server/package-source.d.ts

@@ -0,0 +1,26 @@
+/** One level of body indentation, matching the layout the generator emits. */
+export declare const INDENT = "    ";
+/** A package declaration located in one file's source text. */
+export interface LocatedPackage {
+    qualifiedName: string;
+    name: string;
+    /** Offset of the declaration's first character. */
+    start: number;
+    /** Offset just past the declaration's closing brace. */
+    end: number;
+    /** Offset just past the body's opening brace. */
+    bodyStart: number;
+    /** Offset of the body's closing brace. */
+    bodyEnd: number;
+}
+/** Every package declared in one file's source, with its qualified name. */
+export declare function locatePackages(source: string): Promise<LocatedPackage[]>;
+/** Insert text as the last member of a package body, indented one level in. */
+export declare function insertIntoBody(source: string, target: LocatedPackage, text: string): string;
+/** Replace a range, re-indenting the replacement to the line it starts on. */
+export declare function spliceIndented(source: string, start: number, end: number, replacement: string): string;
+/** Remove a range together with the blank line it would otherwise leave behind. */
+export declare function removeLine(source: string, start: number, end: number): string;
+/** Strip the common leading whitespace from every line of a block. */
+export declare function dedent(text: string): string;
+//# sourceMappingURL=package-source.d.ts.map

package/packages/tools/lib/server/package-source.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"package-source.d.ts","sourceRoot":"","sources":["../../src/server/package-source.ts"],"names":[],"mappings":"AAWA,8EAA8E;AAC9E,eAAO,MAAM,MAAM,SAAS,CAAC;AAE7B,+DAA+D;AAC/D,MAAM,WAAW,cAAc;IAC3B,aAAa,EAAE,MAAM,CAAC;IACtB,IAAI,EAAE,MAAM,CAAC;IACb,mDAAmD;IACnD,KAAK,EAAE,MAAM,CAAC;IACd,wDAAwD;IACxD,GAAG,EAAE,MAAM,CAAC;IACZ,iDAAiD;IACjD,SAAS,EAAE,MAAM,CAAC;IAClB,0CAA0C;IAC1C,OAAO,EAAE,MAAM,CAAC;CACnB;AAED,4EAA4E;AAC5E,wBAAsB,cAAc,CAAC,MAAM,EAAE,MAAM,GAAG,OAAO,CAAC,cAAc,EAAE,CAAC,CAyB9E;AAED,+EAA+E;AAC/E,wBAAgB,cAAc,CAAC,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,cAAc,EAAE,IAAI,EAAE,MAAM,GAAG,MAAM,CAU3F;AAED,8EAA8E;AAC9E,wBAAgB,cAAc,CAAC,MAAM,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,EAAE,GAAG,EAAE,MAAM,EAAE,WAAW,EAAE,MAAM,GAAG,MAAM,CAMtG;AAED,mFAAmF;AACnF,wBAAgB,UAAU,CAAC,MAAM,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,EAAE,GAAG,EAAE,MAAM,GAAG,MAAM,CAQ7E;AAED,sEAAsE;AACtE,wBAAgB,MAAM,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,CAM3C"}

package/packages/tools/lib/server/package-source.js

@@ -0,0 +1,81 @@
+// ─── Locating packages in source text ────────────────────────────────────────
+//
+// Shared by the element persistor and the package writer, because "put this
+// declaration in that package" is one question with one answer whichever of
+// them is asking. A package is found by parsing, never by matching its name in
+// the file text: a comment mentioning the name is not a declaration, and two
+// packages can differ only in their nesting.
+// ─────────────────────────────────────────────────────────────────────────────
+import { parseText } from '../model/parser-utils.js';
+/** One level of body indentation, matching the layout the generator emits. */
+export const INDENT = '    ';
+/** Every package declared in one file's source, with its qualified name. */
+export async function locatePackages(source) {
+    if (!source.trim())
+        return [];
+    const { document, errors } = await parseText(source);
+    if (errors.length > 0)
+        return [];
+    const found = [];
+    const visit = (node, parent) => {
+        for (const member of node.members ?? []) {
+            if (member.$type !== 'PackageDeclaration')
+                continue;
+            const qualifiedName = parent ? `${parent}::${member.name}` : member.name;
+            const cst = member.$cstNode;
+            if (cst) {
+                const start = cst.offset;
+                const end = cst.offset + cst.length;
+                const bodyStart = source.indexOf('{', start);
+                const bodyEnd = source.lastIndexOf('}', end - 1);
+                if (bodyStart !== -1 && bodyEnd > bodyStart) {
+                    found.push({ qualifiedName, name: member.name, start, end, bodyStart: bodyStart + 1, bodyEnd });
+                }
+            }
+            visit(member, qualifiedName);
+        }
+    };
+    visit(document.parseResult.value, '');
+    return found;
+}
+/** Insert text as the last member of a package body, indented one level in. */
+export function insertIntoBody(source, target, text) {
+    const lineStart = source.lastIndexOf('\n', target.start - 1) + 1;
+    const lead = source.slice(lineStart, target.start);
+    const indent = (/^[ \t]*$/.test(lead) ? lead : '') + INDENT;
+    const body = text.replace(/\s+$/, '').split('\n')
+        .map(line => (line ? indent + line : line)).join('\n');
+    const before = source.slice(0, target.bodyEnd).replace(/[ \t]*$/, '');
+    const separator = before.endsWith('\n') ? '' : '\n';
+    const closingIndent = indent.slice(0, -INDENT.length);
+    return `${before}${separator}${body}\n${closingIndent}${source.slice(target.bodyEnd)}`;
+}
+/** Replace a range, re-indenting the replacement to the line it starts on. */
+export function spliceIndented(source, start, end, replacement) {
+    const lineStart = source.lastIndexOf('\n', start - 1) + 1;
+    const lead = source.slice(lineStart, start);
+    const indent = /^[ \t]*$/.test(lead) ? lead : '';
+    const body = replacement.split('\n').map((line, i) => (i === 0 || !line ? line : indent + line)).join('\n');
+    return source.slice(0, start) + body + source.slice(end);
+}
+/** Remove a range together with the blank line it would otherwise leave behind. */
+export function removeLine(source, start, end) {
+    const lineStart = source.lastIndexOf('\n', start - 1) + 1;
+    const leadingIsBlank = /^[ \t]*$/.test(source.slice(lineStart, start));
+    const from = leadingIsBlank ? lineStart : start;
+    let to = end;
+    while (to < source.length && (source[to] === ' ' || source[to] === '\t'))
+        to += 1;
+    if (source[to] === '\n')
+        to += 1;
+    return source.slice(0, from) + source.slice(to);
+}
+/** Strip the common leading whitespace from every line of a block. */
+export function dedent(text) {
+    const lines = text.split('\n');
+    const indents = lines.slice(1).filter(line => line.trim())
+        .map(line => line.match(/^[ \t]*/)?.[0].length ?? 0);
+    const common = indents.length > 0 ? Math.min(...indents) : 0;
+    return lines.map((line, i) => (i === 0 ? line : line.slice(common))).join('\n');
+}
+//# sourceMappingURL=package-source.js.map

package/packages/tools/lib/server/package-source.js.map

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

package/packages/tools/lib/server/package-writer.d.ts

@@ -0,0 +1,94 @@
+import { type IrIdentityIndex } from '../model/ir-identity.js';
+/**
+ * Why a package rename or delete is only a text edit.
+ *
+ * Said once here so every surface says the same thing, and phrased as what was
+ * *not* done: the edit succeeded, and the references it invalidated are the
+ * caller's to fix until the linker can do it.
+ */
+export declare const PACKAGE_EDIT_IS_TEXT_ONLY: string;
+export interface PackageWriteResult {
+    success: boolean;
+    /** Project-relative files this operation wrote. */
+    filePaths: string[];
+    /** Qualified name of the package the operation produced or acted on. */
+    qualifiedName?: string;
+    /** Advisory notes about a write that succeeded. */
+    warnings?: {
+        code: 'package-edit-is-text-only';
+        message: string;
+    }[];
+    error?: string;
+    /** Set when the failure was a stale element identity, so callers can say so. */
+    stale?: boolean;
+}
+/**
+ * Declare a new package.
+ *
+ * With a parent, the package is nested inside that declaration; without one it
+ * is appended at the file's top level. Nesting rather than minting a new file
+ * keeps the edit to a single range in a file the caller already named — the
+ * catalog's namespace-to-directory mirroring is a project layout decision, not
+ * something a right-click in a tree should quietly make.
+ */
+export declare function createPackage(cwd: string, request: {
+    file: string;
+    parent?: string;
+    name: string;
+}): Promise<PackageWriteResult>;
+/**
+ * Rename a package in place.
+ *
+ * Only the declared name token is replaced; members keep their positions, so
+ * the operation cannot reorder or reformat a file around them.
+ */
+export declare function renamePackage(cwd: string, request: {
+    file: string;
+    qualifiedName: string;
+    name: string;
+}): Promise<PackageWriteResult>;
+/**
+ * Re-parent a package: move its whole declaration under another package.
+ *
+ * The declaration is moved verbatim, so everything it declares moves with it —
+ * which is what makes this one operation rather than a move per member. Moving
+ * a package into itself or into its own descendant is refused: the result would
+ * be a namespace that contains the thing containing it.
+ */
+export declare function movePackage(cwd: string, request: {
+    file: string;
+    qualifiedName: string;
+    /** Absent means the file's top level. */
+    targetParent?: string;
+    targetFile: string;
+}): Promise<PackageWriteResult>;
+/**
+ * Remove a package declaration, keeping everything it declares.
+ *
+ * The members are lifted into the enclosing scope rather than deleted: emptying
+ * a container is a containment change, and silently deleting a subtree of the
+ * model because someone removed a folder would be the most expensive possible
+ * reading of that gesture.
+ */
+export declare function deletePackage(cwd: string, request: {
+    file: string;
+    qualifiedName: string;
+}): Promise<PackageWriteResult>;
+/**
+ * Move one element's declaration into another package.
+ *
+ * The declaration text is moved verbatim — this is a containment change, not a
+ * rewrite, so nothing the user authored inside the declaration is regenerated.
+ * The element is addressed by IR identity, exactly as an update is, so a move
+ * made against a stale revision fails loudly instead of cutting whatever now
+ * occupies that position.
+ */
+export declare function moveElementToPackage(cwd: string, request: {
+    elementId: string;
+    irIdentity: string;
+    sourceFile: string;
+    targetFile: string;
+    /** Absent means the file's top level. */
+    targetPackage?: string;
+}, index: IrIdentityIndex): Promise<PackageWriteResult>;
+//# sourceMappingURL=package-writer.d.ts.map

package/packages/tools/lib/server/package-writer.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"package-writer.d.ts","sourceRoot":"","sources":["../../src/server/package-writer.ts"],"names":[],"mappings":"AA0BA,OAAO,EAIH,KAAK,eAAe,EACvB,MAAM,yBAAyB,CAAC;AAMjC;;;;;;GAMG;AACH,eAAO,MAAM,yBAAyB,QAGA,CAAC;AAEvC,MAAM,WAAW,kBAAkB;IAC/B,OAAO,EAAE,OAAO,CAAC;IACjB,mDAAmD;IACnD,SAAS,EAAE,MAAM,EAAE,CAAC;IACpB,wEAAwE;IACxE,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB,mDAAmD;IACnD,QAAQ,CAAC,EAAE;QAAE,IAAI,EAAE,2BAA2B,CAAC;QAAC,OAAO,EAAE,MAAM,CAAA;KAAE,EAAE,CAAC;IACpE,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,gFAAgF;IAChF,KAAK,CAAC,EAAE,OAAO,CAAC;CACnB;AAKD;;;;;;;;GAQG;AACH,wBAAsB,aAAa,CAC/B,GAAG,EAAE,MAAM,EACX,OAAO,EAAE;IAAE,IAAI,EAAE,MAAM,CAAC;IAAC,MAAM,CAAC,EAAE,MAAM,CAAC;IAAC,IAAI,EAAE,MAAM,CAAA;CAAE,GACzD,OAAO,CAAC,kBAAkB,CAAC,CA8B7B;AAED;;;;;GAKG;AACH,wBAAsB,aAAa,CAC/B,GAAG,EAAE,MAAM,EACX,OAAO,EAAE;IAAE,IAAI,EAAE,MAAM,CAAC;IAAC,aAAa,EAAE,MAAM,CAAC;IAAC,IAAI,EAAE,MAAM,CAAA;CAAE,GAC/D,OAAO,CAAC,kBAAkB,CAAC,CAqC7B;AAED;;;;;;;GAOG;AACH,wBAAsB,WAAW,CAC7B,GAAG,EAAE,MAAM,EACX,OAAO,EAAE;IACL,IAAI,EAAE,MAAM,CAAC;IACb,aAAa,EAAE,MAAM,CAAC;IACtB,yCAAyC;IACzC,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,UAAU,EAAE,MAAM,CAAC;CACtB,GACF,OAAO,CAAC,kBAAkB,CAAC,CA2D7B;AAED;;;;;;;GAOG;AACH,wBAAsB,aAAa,CAC/B,GAAG,EAAE,MAAM,EACX,OAAO,EAAE;IAAE,IAAI,EAAE,MAAM,CAAC;IAAC,aAAa,EAAE,MAAM,CAAA;CAAE,GACjD,OAAO,CAAC,kBAAkB,CAAC,CA8B7B;AAED;;;;;;;;GAQG;AACH,wBAAsB,oBAAoB,CACtC,GAAG,EAAE,MAAM,EACX,OAAO,EAAE;IACL,SAAS,EAAE,MAAM,CAAC;IAClB,UAAU,EAAE,MAAM,CAAC;IACnB,UAAU,EAAE,MAAM,CAAC;IACnB,UAAU,EAAE,MAAM,CAAC;IACnB,yCAAyC;IACzC,aAAa,CAAC,EAAE,MAAM,CAAC;CAC1B,EACD,KAAK,EAAE,eAAe,GACvB,OAAO,CAAC,kBAAkB,CAAC,CAyD7B"}