@cda/adapter-xma 0.4.3 → 0.6.0

package/dist/cjs/serializer/view-writer.js

@@ -0,0 +1,239 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.buildView = buildView;
+const xml_writer_js_1 = require("../infrastructure/xml-writer.js");
+const profile_values_js_1 = require("./profile-values.js");
+const geometry_js_1 = require("../geometry/geometry.js");
+/**
+ * Builds one `AllView`'s `ViewGraphics` (Notes/Groups) and `RefObjects`
+ * (the three-layer view-reference indirection — see module docs on
+ * `graphical-writer.ts`). Also validates every diagram object/note/connection
+ * in the view, since geometry and view membership are model-wide
+ * preservation guarantees, not just node drawing concerns. Nested diagram
+ * objects (a `parentId` or non-empty `childrenIds`) are valid here — see
+ * `graphical-writer.ts`'s recursive node building for how nesting is drawn.
+ */
+function buildView(model, view, ids, refIds, mappedElements, mappedRelationships, diagnostics, language) {
+    const viewGraphicsXml = [];
+    const viewEdgesXml = [];
+    const refObjectsXml = [];
+    const validElementNodeObjectIds = new Set();
+    const validGroupObjectIds = new Set();
+    const validNoteIds = new Set();
+    const validViewReferenceObjectIds = new Set();
+    const viewEdgeSemanticIds = new Map();
+    const viewIds = new Set(model.views.map((v) => v.id));
+    const diagramObjectById = new Map(model.diagramObjects.map((o) => [o.id, o]));
+    /**
+     * Resolves the semantic XMA id a diagram object (or note) uses for its
+     * *own* node's `mm_semanticObject` — confirmed (across an
+     * element-backed/Group/Note/DiagramModelReference mix, in two independent
+     * fixtures) to be exactly the value an `ArchiMate:ViewEdge`'s `from`/`to`
+     * references for that same object. `undefined` when the id isn't a
+     * validated, drawable object/note in this view.
+     */
+    function resolveObjectSemanticId(objectOrNoteId) {
+        if (validElementNodeObjectIds.has(objectOrNoteId)) {
+            const archimateElementId = diagramObjectById.get(objectOrNoteId)?.archimateElementId;
+            return archimateElementId ? refIds.get(archimateElementId) : undefined;
+        }
+        if (validGroupObjectIds.has(objectOrNoteId) || validNoteIds.has(objectOrNoteId)) {
+            return ids.get(objectOrNoteId);
+        }
+        if (validViewReferenceObjectIds.has(objectOrNoteId)) {
+            const referencedModelId = diagramObjectById.get(objectOrNoteId)?.referencedModelId;
+            return referencedModelId ? refIds.get(referencedModelId) : undefined;
+        }
+        return undefined;
+    }
+    for (const obj of model.diagramObjects) {
+        if (obj.viewId !== view.id) {
+            continue;
+        }
+        if (obj.referencedModelId !== null) {
+            // Corrected finding: an earlier version of this comment claimed "no
+            // trace whatsoever" of a DiagramModelReference in the real XMA export,
+            // based on grepping for Archi's own string id — which can never match
+            // anything, since XMA never reuses Archi's ids (see id-allocator.ts).
+            // That verification method was broken, not the underlying claim.
+            // Re-verified directly against agile-manifesto.xma: both
+            // DiagramModelReference objects there ARE drawn, as an
+            // `mm_concept="AllView"`/`mm_graphicType="3"` node whose
+            // `mm_semanticObject` resolves — via an `ArchiMate:AllViewRef`, the
+            // same Ref-layer indirection used for every other element/relationship
+            // — to the *referenced view's own* `ArchiMate:AllView` id (no new
+            // semantic concept is minted for the reference itself). See
+            // `graphical-writer.ts`'s `buildViewReferenceNode`.
+            //
+            // This only resolves when the reference targets another `ArchiView` in
+            // *this* model. `referencedModelId` can also point at a Sketch/Canvas
+            // view (per `archi-semantic-core`'s docs on the field) — archi-mate has
+            // no XMA representation at all, so that case remains genuinely
+            // unsupported.
+            if (!(0, geometry_js_1.hasCompleteBounds)(obj.bounds)) {
+                diagnostics.error({
+                    code: 'missing-bounds',
+                    message: `Diagram object "${obj.id}" has incomplete geometry (x/y/width/height) and cannot be positioned in XMA.`,
+                    entityId: obj.id,
+                    entityType: 'ArchiDiagramObject',
+                });
+                continue;
+            }
+            if (!viewIds.has(obj.referencedModelId)) {
+                diagnostics.warning({
+                    code: 'unsupported-diagram-model-reference',
+                    message: `Diagram object "${obj.id}" references a view/model ("${obj.referencedModelId}") not among this model's own ArchiMate views (e.g. a Sketch/Canvas) — not representable in XMA and was omitted.`,
+                    entityId: obj.id,
+                    entityType: 'ArchiDiagramObject',
+                });
+                continue;
+            }
+            if (!refIds.has(obj.referencedModelId)) {
+                const refId = refIds.idFor(obj.referencedModelId);
+                refObjectsXml.push((0, xml_writer_js_1.element)('ArchiMate:AllViewRef', [
+                    ['id', String(refId)],
+                    ['to', String(ids.idFor(obj.referencedModelId))],
+                ]));
+            }
+            validViewReferenceObjectIds.add(obj.id);
+            continue;
+        }
+        if (obj.archimateElementId === null) {
+            if (obj.xsiType !== 'archimate:Group') {
+                diagnostics.error({
+                    code: 'unsupported-diagram-object',
+                    message: `Diagram object "${obj.id}" (${obj.xsiType}) has no backing semantic element and is not a recognized Group — not supported in XMA v0.1.`,
+                    entityId: obj.id,
+                    entityType: 'ArchiDiagramObject',
+                });
+                continue;
+            }
+            if (!(0, geometry_js_1.hasCompleteBounds)(obj.bounds)) {
+                diagnostics.error({
+                    code: 'missing-bounds',
+                    message: `Group "${obj.id}" has incomplete geometry (x/y/width/height) and cannot be positioned in XMA.`,
+                    entityId: obj.id,
+                    entityType: 'ArchiDiagramObject',
+                });
+                continue;
+            }
+            const groupXmaId = ids.idFor(obj.id);
+            viewGraphicsXml.push((0, xml_writer_js_1.element)('ArchiMate:ViewGraphic', [['id', String(groupXmaId)]], [
+                (0, profile_values_js_1.buildProfileValues)(language, obj.name ?? '', obj.documentation),
+            ]));
+            validGroupObjectIds.add(obj.id);
+            continue;
+        }
+        // Element-backed diagram object.
+        if (!(0, geometry_js_1.hasCompleteBounds)(obj.bounds)) {
+            diagnostics.error({
+                code: 'missing-bounds',
+                message: `Diagram object "${obj.id}" has incomplete geometry (x/y/width/height) and cannot be positioned in XMA.`,
+                entityId: obj.id,
+                entityType: 'ArchiDiagramObject',
+            });
+            continue;
+        }
+        const mapping = mappedElements.get(obj.archimateElementId);
+        if (!mapping) {
+            // The backing element already produced an unsupported-element-type diagnostic.
+            continue;
+        }
+        if (!refIds.has(obj.archimateElementId)) {
+            const refId = refIds.idFor(obj.archimateElementId);
+            refObjectsXml.push((0, xml_writer_js_1.element)(`ArchiMate:${mapping.xmaType}Ref`, [
+                ['id', String(refId)],
+                ['to', String(ids.idFor(obj.archimateElementId))],
+            ]));
+        }
+        validElementNodeObjectIds.add(obj.id);
+    }
+    for (const note of model.notes) {
+        if (note.viewId !== view.id) {
+            continue;
+        }
+        if (note.parentId !== null) {
+            // Unlike nested ArchiDiagramObjects (supported — see graphical-writer.ts's
+            // buildNodeTree), a nested Note has no fixture evidence: only one instance
+            // exists across all four fixtures, not enough to confirm its representation.
+            diagnostics.error({
+                code: 'unsupported-nested-diagram-object',
+                message: `Note "${note.id}" is nested inside another diagram object — not supported in XMA v0.1.`,
+                entityId: note.id,
+                entityType: 'ArchiNote',
+            });
+            continue;
+        }
+        if (!(0, geometry_js_1.hasCompleteBounds)(note.bounds)) {
+            diagnostics.error({
+                code: 'missing-bounds',
+                message: `Note "${note.id}" has incomplete geometry (x/y/width/height) and cannot be positioned in XMA.`,
+                entityId: note.id,
+                entityType: 'ArchiNote',
+            });
+            continue;
+        }
+        const noteXmaId = ids.idFor(note.id);
+        viewGraphicsXml.push((0, xml_writer_js_1.element)('ArchiMate:ViewGraphic', [['id', String(noteXmaId)]], [(0, profile_values_js_1.buildProfileValues)(language, note.content ?? '')]));
+        validNoteIds.add(note.id);
+    }
+    for (const connection of model.diagramConnections) {
+        if (connection.viewId !== view.id) {
+            continue;
+        }
+        if (connection.archimateRelationshipId === null) {
+            // A purely-visual connection (no underlying ArchiMate relationship).
+            // Confirmed against two independent real instances — agile-manifesto
+            // (between two DiagramModelReferences) and sabsa (between a
+            // Note/Group and a BusinessRole element) — that Archi represents
+            // this as an ArchiMate:ViewEdge, whose from/to are exactly each
+            // endpoint's own semantic id (the same value already used as that
+            // endpoint's own node's mm_semanticObject — see
+            // resolveObjectSemanticId above). Falls back to the pre-existing
+            // diagnostic when either endpoint isn't itself a drawable object —
+            // that remains a genuinely unsupported case, not guessed either way.
+            const fromSemanticId = resolveObjectSemanticId(connection.sourceId);
+            const toSemanticId = resolveObjectSemanticId(connection.targetId);
+            if (fromSemanticId === undefined || toSemanticId === undefined) {
+                diagnostics.error({
+                    code: 'unsupported-connection-no-relationship',
+                    message: `Connection "${connection.id}" has no underlying semantic relationship (a purely visual connector) and at least one endpoint is not a drawable object — not supported in XMA v0.1.`,
+                    entityId: connection.id,
+                    entityType: 'ArchiDiagramConnection',
+                });
+                continue;
+            }
+            const viewEdgeId = ids.idFor(connection.id);
+            viewEdgesXml.push((0, xml_writer_js_1.element)('ArchiMate:ViewEdge', [
+                ['id', String(viewEdgeId)],
+                ['from', String(fromSemanticId)],
+                ['to', String(toSemanticId)],
+            ]));
+            viewEdgeSemanticIds.set(connection.id, viewEdgeId);
+            continue;
+        }
+        const mapping = mappedRelationships.get(connection.archimateRelationshipId);
+        if (!mapping) {
+            // The underlying relationship already produced its own diagnostic.
+            continue;
+        }
+        if (!refIds.has(connection.archimateRelationshipId)) {
+            const refId = refIds.idFor(connection.archimateRelationshipId);
+            refObjectsXml.push((0, xml_writer_js_1.element)(`ArchiMate:${mapping.xmaType}Ref`, [
+                ['id', String(refId)],
+                ['to', String(ids.idFor(connection.archimateRelationshipId))],
+            ]));
+        }
+    }
+    return {
+        viewGraphicsXml,
+        viewEdgesXml,
+        refObjectsXml,
+        validElementNodeObjectIds,
+        validGroupObjectIds,
+        validNoteIds,
+        validViewReferenceObjectIds,
+        viewEdgeSemanticIds,
+    };
+}
+//# sourceMappingURL=view-writer.js.map

package/dist/cjs/serializer/view-writer.js.map

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

package/dist/esm/diagnostics/diagnostics.d.ts

@@ -0,0 +1,20 @@
+export type XmaDiagnosticSeverity = 'error' | 'warning';
+export interface XmaDiagnostic {
+    /** Stable machine-readable code, e.g. "unsupported-element-type". */
+    code: string;
+    severity: XmaDiagnosticSeverity;
+    message: string;
+    /** Id of the offending source entity (Archi element/relationship/view/diagram id), when applicable. */
+    entityId?: string;
+    /** Kind of the offending source entity, e.g. "ArchiElement", "ArchiRelationship". */
+    entityType?: string;
+}
+/** Accumulates diagnostics during a single serialization pass. */
+export declare class DiagnosticCollector {
+    private readonly items;
+    error(diagnostic: Omit<XmaDiagnostic, 'severity'>): void;
+    warning(diagnostic: Omit<XmaDiagnostic, 'severity'>): void;
+    get all(): XmaDiagnostic[];
+    get hasErrors(): boolean;
+}
+//# sourceMappingURL=diagnostics.d.ts.map

package/dist/esm/diagnostics/diagnostics.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"diagnostics.d.ts","sourceRoot":"","sources":["../../../src/diagnostics/diagnostics.ts"],"names":[],"mappings":"AAAA,MAAM,MAAM,qBAAqB,GAAG,OAAO,GAAG,SAAS,CAAC;AAExD,MAAM,WAAW,aAAa;IAC5B,qEAAqE;IACrE,IAAI,EAAE,MAAM,CAAC;IACb,QAAQ,EAAE,qBAAqB,CAAC;IAChC,OAAO,EAAE,MAAM,CAAC;IAChB,uGAAuG;IACvG,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,qFAAqF;IACrF,UAAU,CAAC,EAAE,MAAM,CAAC;CACrB;AAED,kEAAkE;AAClE,qBAAa,mBAAmB;IAC9B,OAAO,CAAC,QAAQ,CAAC,KAAK,CAAuB;IAE7C,KAAK,CAAC,UAAU,EAAE,IAAI,CAAC,aAAa,EAAE,UAAU,CAAC,GAAG,IAAI;IAIxD,OAAO,CAAC,UAAU,EAAE,IAAI,CAAC,aAAa,EAAE,UAAU,CAAC,GAAG,IAAI;IAI1D,IAAI,GAAG,IAAI,aAAa,EAAE,CAEzB;IAED,IAAI,SAAS,IAAI,OAAO,CAEvB;CACF"}

package/dist/esm/diagnostics/diagnostics.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"diagnostics.js","sourceRoot":"","sources":["../../../src/diagnostics/diagnostics.ts"],"names":[],"mappings":"AAaA,kEAAkE;AAClE,MAAM,OAAO,mBAAmB;IAAhC;QACmB,UAAK,GAAoB,EAAE,CAAC;IAiB/C,CAAC;IAfC,KAAK,CAAC,UAA2C;QAC/C,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC,EAAE,GAAG,UAAU,EAAE,QAAQ,EAAE,OAAO,EAAE,CAAC,CAAC;IACxD,CAAC;IAED,OAAO,CAAC,UAA2C;QACjD,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC,EAAE,GAAG,UAAU,EAAE,QAAQ,EAAE,SAAS,EAAE,CAAC,CAAC;IAC1D,CAAC;IAED,IAAI,GAAG;QACL,OAAO,CAAC,GAAG,IAAI,CAAC,KAAK,CAAC,CAAC;IACzB,CAAC;IAED,IAAI,SAAS;QACX,OAAO,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,QAAQ,KAAK,OAAO,CAAC,CAAC;IACxD,CAAC;CACF"}

package/dist/esm/diagnostics/errors.d.ts

@@ -0,0 +1,13 @@
+import type { XmaDiagnostic } from './diagnostics.js';
+/**
+ * Thrown by `serializeXma` whenever serializing would silently lose
+ * semantics or presentation intent. Carries the full structured diagnostic
+ * list (not just the first failure) so callers can report everything wrong
+ * in one pass — see `inspectXmaSupport` to obtain the same list without
+ * throwing.
+ */
+export declare class XmaSerializationError extends Error {
+    readonly diagnostics: XmaDiagnostic[];
+    constructor(diagnostics: XmaDiagnostic[]);
+}
+//# sourceMappingURL=errors.d.ts.map

package/dist/esm/diagnostics/errors.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"errors.d.ts","sourceRoot":"","sources":["../../../src/diagnostics/errors.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,kBAAkB,CAAC;AAEtD;;;;;;GAMG;AACH,qBAAa,qBAAsB,SAAQ,KAAK;IAC9C,QAAQ,CAAC,WAAW,EAAE,aAAa,EAAE,CAAC;gBAE1B,WAAW,EAAE,aAAa,EAAE;CAYzC"}

package/dist/esm/diagnostics/errors.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"errors.js","sourceRoot":"","sources":["../../../src/diagnostics/errors.ts"],"names":[],"mappings":"AAEA;;;;;;GAMG;AACH,MAAM,OAAO,qBAAsB,SAAQ,KAAK;IAG9C,YAAY,WAA4B;QACtC,MAAM,UAAU,GAAG,WAAW,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,QAAQ,KAAK,OAAO,CAAC,CAAC,MAAM,CAAC;QAC5E,KAAK,CACH,6BAA6B,UAAU,uEAAuE;YAC5G,WAAW;iBACR,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,QAAQ,KAAK,OAAO,CAAC;iBACrC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,IAAI,CAAC,CAAC,IAAI,KAAK,CAAC,CAAC,OAAO,EAAE,CAAC;iBACtC,IAAI,CAAC,IAAI,CAAC,CAChB,CAAC;QACF,IAAI,CAAC,IAAI,GAAG,uBAAuB,CAAC;QACpC,IAAI,CAAC,WAAW,GAAG,WAAW,CAAC;IACjC,CAAC;CACF"}

package/dist/esm/geometry/bendpoints.d.ts

@@ -0,0 +1,33 @@
+import type { Point, Rect } from './geometry.js';
+export type BendpointAgreement = 'both' | 'source-only' | 'target-only';
+export interface BendpointResolution {
+    /** Resolved absolute point, in Archi (pre-scale) coordinate space. */
+    point: Point;
+    agreement: BendpointAgreement;
+    /** Present only when both source- and target-relative forms were available but disagreed materially. */
+    mismatch?: {
+        fromSource: Point;
+        fromTarget: Point;
+    };
+}
+/**
+ * Resolves a single Archi bendpoint (stored as offsets from the source and
+ * target diagram-object centers) to an absolute point in Archi coordinate
+ * space.
+ *
+ * Confirmed fixture: source bounds x=48,y=180,w=120,h=55 (center 108,207),
+ * target bounds x=204,y=276,w=120,h=55 (center 264,303), bendpoint
+ * startX=-12,startY=93,endX=-168,endY=-3 resolves to absolute (96, 300) via
+ * either offset.
+ *
+ * When both offsets are present, they are cross-checked against each other;
+ * a material disagreement is reported via `mismatch` rather than silently
+ * resolved, so the caller can surface a diagnostic instead of guessing.
+ */
+export declare function resolveBendpoint(bendpoint: {
+    startX: number | null;
+    startY: number | null;
+    endX: number | null;
+    endY: number | null;
+}, sourceBounds: Rect, targetBounds: Rect): BendpointResolution | null;
+//# sourceMappingURL=bendpoints.d.ts.map

package/dist/esm/geometry/bendpoints.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"bendpoints.d.ts","sourceRoot":"","sources":["../../../src/geometry/bendpoints.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,KAAK,EAAE,IAAI,EAAE,MAAM,eAAe,CAAC;AAKjD,MAAM,MAAM,kBAAkB,GAAG,MAAM,GAAG,aAAa,GAAG,aAAa,CAAC;AAExE,MAAM,WAAW,mBAAmB;IAClC,sEAAsE;IACtE,KAAK,EAAE,KAAK,CAAC;IACb,SAAS,EAAE,kBAAkB,CAAC;IAC9B,wGAAwG;IACxG,QAAQ,CAAC,EAAE;QACT,UAAU,EAAE,KAAK,CAAC;QAClB,UAAU,EAAE,KAAK,CAAC;KACnB,CAAC;CACH;AAED;;;;;;;;;;;;;GAaG;AACH,wBAAgB,gBAAgB,CAC9B,SAAS,EAAE;IAAE,MAAM,EAAE,MAAM,GAAG,IAAI,CAAC;IAAC,MAAM,EAAE,MAAM,GAAG,IAAI,CAAC;IAAC,IAAI,EAAE,MAAM,GAAG,IAAI,CAAC;IAAC,IAAI,EAAE,MAAM,GAAG,IAAI,CAAA;CAAE,EACrG,YAAY,EAAE,IAAI,EAClB,YAAY,EAAE,IAAI,GACjB,mBAAmB,GAAG,IAAI,CAoC5B"}

package/dist/{geometry → esm/geometry}/bendpoints.js

@@ -15,8 +15,12 @@ const AGREEMENT_EPSILON = 0.01;
  * resolved, so the caller can surface a diagnostic instead of guessing.
  */
 export function resolveBendpoint(bendpoint, sourceBounds, targetBounds) {
-    const hasSourceOffset = bendpoint.startX !== null && bendpoint.startY !== null;
-    const hasTargetOffset = bendpoint.endX !== null && bendpoint.endY !== null;
+    // A NaN/Infinity offset (e.g. from an upstream parser's failed arithmetic)
+    // is treated as absent rather than propagated into a nonsensical resolved
+    // point — this falls through to the existing "neither offset usable"
+    // diagnostic below instead of silently producing invalid geometry.
+    const hasSourceOffset = Number.isFinite(bendpoint.startX) && Number.isFinite(bendpoint.startY);
+    const hasTargetOffset = Number.isFinite(bendpoint.endX) && Number.isFinite(bendpoint.endY);
     if (!hasSourceOffset && !hasTargetOffset) {
         return null;
     }

package/dist/esm/geometry/bendpoints.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"bendpoints.js","sourceRoot":"","sources":["../../../src/geometry/bendpoints.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,QAAQ,EAAE,MAAM,eAAe,CAAC;AAEzC,MAAM,iBAAiB,GAAG,IAAI,CAAC;AAe/B;;;;;;;;;;;;;GAaG;AACH,MAAM,UAAU,gBAAgB,CAC9B,SAAqG,EACrG,YAAkB,EAClB,YAAkB;IAElB,2EAA2E;IAC3E,0EAA0E;IAC1E,qEAAqE;IACrE,mEAAmE;IACnE,MAAM,eAAe,GAAG,MAAM,CAAC,QAAQ,CAAC,SAAS,CAAC,MAAM,CAAC,IAAI,MAAM,CAAC,QAAQ,CAAC,SAAS,CAAC,MAAM,CAAC,CAAC;IAC/F,MAAM,eAAe,GAAG,MAAM,CAAC,QAAQ,CAAC,SAAS,CAAC,IAAI,CAAC,IAAI,MAAM,CAAC,QAAQ,CAAC,SAAS,CAAC,IAAI,CAAC,CAAC;IAE3F,IAAI,CAAC,eAAe,IAAI,CAAC,eAAe,EAAE,CAAC;QACzC,OAAO,IAAI,CAAC;IACd,CAAC;IAED,MAAM,YAAY,GAAG,QAAQ,CAAC,YAAY,CAAC,CAAC;IAC5C,MAAM,YAAY,GAAG,QAAQ,CAAC,YAAY,CAAC,CAAC;IAE5C,MAAM,UAAU,GAAiB,eAAe;QAC9C,CAAC,CAAC,EAAE,CAAC,EAAE,YAAY,CAAC,CAAC,GAAI,SAAS,CAAC,MAAiB,EAAE,CAAC,EAAE,YAAY,CAAC,CAAC,GAAI,SAAS,CAAC,MAAiB,EAAE;QACxG,CAAC,CAAC,IAAI,CAAC;IACT,MAAM,UAAU,GAAiB,eAAe;QAC9C,CAAC,CAAC,EAAE,CAAC,EAAE,YAAY,CAAC,CAAC,GAAI,SAAS,CAAC,IAAe,EAAE,CAAC,EAAE,YAAY,CAAC,CAAC,GAAI,SAAS,CAAC,IAAe,EAAE;QACpG,CAAC,CAAC,IAAI,CAAC;IAET,IAAI,UAAU,IAAI,UAAU,EAAE,CAAC;QAC7B,MAAM,MAAM,GAAG,IAAI,CAAC,GAAG,CAAC,UAAU,CAAC,CAAC,GAAG,UAAU,CAAC,CAAC,CAAC,CAAC;QACrD,MAAM,MAAM,GAAG,IAAI,CAAC,GAAG,CAAC,UAAU,CAAC,CAAC,GAAG,UAAU,CAAC,CAAC,CAAC,CAAC;QACrD,IAAI,MAAM,GAAG,iBAAiB,IAAI,MAAM,GAAG,iBAAiB,EAAE,CAAC;YAC7D,OAAO,EAAE,KAAK,EAAE,UAAU,EAAE,SAAS,EAAE,MAAM,EAAE,QAAQ,EAAE,EAAE,UAAU,EAAE,UAAU,EAAE,EAAE,CAAC;QACxF,CAAC;QACD,OAAO,EAAE,KAAK,EAAE,UAAU,EAAE,SAAS,EAAE,MAAM,EAAE,CAAC;IAClD,CAAC;IAED,IAAI,UAAU,EAAE,CAAC;QACf,OAAO,EAAE,KAAK,EAAE,UAAU,EAAE,SAAS,EAAE,aAAa,EAAE,CAAC;IACzD,CAAC;IAED,OAAO,EAAE,KAAK,EAAE,UAAmB,EAAE,SAAS,EAAE,aAAa,EAAE,CAAC;AAClE,CAAC"}

package/dist/esm/geometry/geometry.d.ts

@@ -0,0 +1,75 @@
+/**
+ * Confirmed across all catalogue shapes and the relationship fixture: XMA
+ * geometry is Archi geometry uniformly scaled by 3 (x, y, width, height,
+ * and bendpoint coordinates alike).
+ */
+export declare const XMA_SCALE = 3;
+export interface Rect {
+    x: number;
+    y: number;
+    width: number;
+    height: number;
+}
+export declare function scaleValue(archiValue: number): number;
+export declare function scaleRect(bounds: Rect): Rect;
+export interface Point {
+    x: number;
+    y: number;
+}
+export declare function scalePoint(point: Point): Point;
+/**
+ * Rect center, floored to a whole pixel — confirmed against the proven
+ * bendpoint fixture: a 55px-tall shape's center is Archi's own `180 + 55/2`
+ * truncated to `207`, not `207.5`. Using the exact fraction here would
+ * throw off every bendpoint resolved against an odd-height/width shape.
+ */
+export declare function centerOf(bounds: Rect): Point;
+interface NullableBounds {
+    x: number | null;
+    y: number | null;
+    width: number | null;
+    height: number | null;
+}
+/**
+ * A bounds with confirmed `width`/`height`, but `x`/`y` still possibly
+ * `null` (Archi's own convention for "this coordinate is 0" — see
+ * `hasCompleteBounds`). Deliberately distinct from `Rect`: unlike the old
+ * `bounds is Rect` guard, this doesn't claim `x`/`y` are numbers when they
+ * might not be, so a caller can't reach for `bounds.x` arithmetic without
+ * going through `toRect` first and getting the null-to-0 substitution
+ * explicitly, instead of relying on it happening implicitly via JS
+ * coercion behind an unchecked cast.
+ */
+export interface CompleteBounds {
+    x: number | null;
+    y: number | null;
+    width: number;
+    height: number;
+}
+/**
+ * Type guard: true when a bounds has usable width/height (`x`/`y` may
+ * still be `null` — see `CompleteBounds`).
+ *
+ * `width`/`height` must be set — there is no fixture evidence of Archi ever
+ * omitting either. `x`/`y` are allowed to be `null`: confirmed across all
+ * four fixtures (three omitted-`x` cases in sabsa, one omitted-`y` case in
+ * agile-manifesto — always alone, never alongside a missing `width`/
+ * `height`) that Archi omits a bounds coordinate specifically when its value
+ * is `0`, per the ArchiMate Exchange Format convention. Use `toRect` to
+ * apply that default explicitly before doing numeric work with `x`/`y`.
+ *
+ * Every non-null field must also be a finite number: a `NaN`/`Infinity`
+ * value (e.g. from an upstream parser's failed arithmetic on garbled
+ * geometry text) would otherwise pass this check and flow silently into the
+ * rendered XML as a literal `"NaN"`/`"Infinity"` attribute — invalid output
+ * produced with no diagnostic. Treating it as incomplete instead routes it
+ * through the same `missing-bounds` diagnostic as an actually-missing value.
+ */
+export declare function hasCompleteBounds(bounds: NullableBounds | null): bounds is CompleteBounds;
+/**
+ * Applies Archi's "omitted coordinate means 0" convention explicitly (see
+ * `hasCompleteBounds`), turning a `CompleteBounds` into a real `Rect`.
+ */
+export declare function toRect(bounds: CompleteBounds): Rect;
+export {};
+//# sourceMappingURL=geometry.d.ts.map

package/dist/esm/geometry/geometry.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"geometry.d.ts","sourceRoot":"","sources":["../../../src/geometry/geometry.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AACH,eAAO,MAAM,SAAS,IAAI,CAAC;AAE3B,MAAM,WAAW,IAAI;IACnB,CAAC,EAAE,MAAM,CAAC;IACV,CAAC,EAAE,MAAM,CAAC;IACV,KAAK,EAAE,MAAM,CAAC;IACd,MAAM,EAAE,MAAM,CAAC;CAChB;AAED,wBAAgB,UAAU,CAAC,UAAU,EAAE,MAAM,GAAG,MAAM,CAErD;AAED,wBAAgB,SAAS,CAAC,MAAM,EAAE,IAAI,GAAG,IAAI,CAO5C;AAED,MAAM,WAAW,KAAK;IACpB,CAAC,EAAE,MAAM,CAAC;IACV,CAAC,EAAE,MAAM,CAAC;CACX;AAED,wBAAgB,UAAU,CAAC,KAAK,EAAE,KAAK,GAAG,KAAK,CAE9C;AAED;;;;;GAKG;AACH,wBAAgB,QAAQ,CAAC,MAAM,EAAE,IAAI,GAAG,KAAK,CAK5C;AAED,UAAU,cAAc;IACtB,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IACjB,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IACjB,KAAK,EAAE,MAAM,GAAG,IAAI,CAAC;IACrB,MAAM,EAAE,MAAM,GAAG,IAAI,CAAC;CACvB;AAED;;;;;;;;;GASG;AACH,MAAM,WAAW,cAAc;IAC7B,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IACjB,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IACjB,KAAK,EAAE,MAAM,CAAC;IACd,MAAM,EAAE,MAAM,CAAC;CAChB;AAED;;;;;;;;;;;;;;;;;;GAkBG;AACH,wBAAgB,iBAAiB,CAAC,MAAM,EAAE,cAAc,GAAG,IAAI,GAAG,MAAM,IAAI,cAAc,CAMzF;AAED;;;GAGG;AACH,wBAAgB,MAAM,CAAC,MAAM,EAAE,cAAc,GAAG,IAAI,CAEnD"}

package/dist/{geometry → esm/geometry}/geometry.js

@@ -31,19 +31,38 @@ export function centerOf(bounds) {
     };
 }
 /**
- * Type guard: true when a bounds is usable as a `Rect`.
+ * Type guard: true when a bounds has usable width/height (`x`/`y` may
+ * still be `null` — see `CompleteBounds`).
  *
  * `width`/`height` must be set — there is no fixture evidence of Archi ever
  * omitting either. `x`/`y` are allowed to be `null`: confirmed across all
  * four fixtures (three omitted-`x` cases in sabsa, one omitted-`y` case in
  * agile-manifesto — always alone, never alongside a missing `width`/
  * `height`) that Archi omits a bounds coordinate specifically when its value
- * is `0`, per the ArchiMate Exchange Format convention. Downstream numeric
- * use of `bounds.x`/`bounds.y` (scaling, center-of) relies on JS's
- * null-coerces-to-0 arithmetic to apply that default — no explicit
- * substitution needed here.
+ * is `0`, per the ArchiMate Exchange Format convention. Use `toRect` to
+ * apply that default explicitly before doing numeric work with `x`/`y`.
+ *
+ * Every non-null field must also be a finite number: a `NaN`/`Infinity`
+ * value (e.g. from an upstream parser's failed arithmetic on garbled
+ * geometry text) would otherwise pass this check and flow silently into the
+ * rendered XML as a literal `"NaN"`/`"Infinity"` attribute — invalid output
+ * produced with no diagnostic. Treating it as incomplete instead routes it
+ * through the same `missing-bounds` diagnostic as an actually-missing value.
  */
 export function hasCompleteBounds(bounds) {
-    return bounds !== null && bounds.width !== null && bounds.height !== null;
+    if (bounds === null)
+        return false;
+    for (const value of [bounds.x, bounds.y, bounds.width, bounds.height]) {
+        if (value !== null && !Number.isFinite(value))
+            return false;
+    }
+    return bounds.width !== null && bounds.height !== null;
+}
+/**
+ * Applies Archi's "omitted coordinate means 0" convention explicitly (see
+ * `hasCompleteBounds`), turning a `CompleteBounds` into a real `Rect`.
+ */
+export function toRect(bounds) {
+    return { x: bounds.x ?? 0, y: bounds.y ?? 0, width: bounds.width, height: bounds.height };
 }
 //# sourceMappingURL=geometry.js.map

package/dist/esm/geometry/geometry.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"geometry.js","sourceRoot":"","sources":["../../../src/geometry/geometry.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AACH,MAAM,CAAC,MAAM,SAAS,GAAG,CAAC,CAAC;AAS3B,MAAM,UAAU,UAAU,CAAC,UAAkB;IAC3C,OAAO,UAAU,GAAG,SAAS,CAAC;AAChC,CAAC;AAED,MAAM,UAAU,SAAS,CAAC,MAAY;IACpC,OAAO;QACL,CAAC,EAAE,UAAU,CAAC,MAAM,CAAC,CAAC,CAAC;QACvB,CAAC,EAAE,UAAU,CAAC,MAAM,CAAC,CAAC,CAAC;QACvB,KAAK,EAAE,UAAU,CAAC,MAAM,CAAC,KAAK,CAAC;QAC/B,MAAM,EAAE,UAAU,CAAC,MAAM,CAAC,MAAM,CAAC;KAClC,CAAC;AACJ,CAAC;AAOD,MAAM,UAAU,UAAU,CAAC,KAAY;IACrC,OAAO,EAAE,CAAC,EAAE,UAAU,CAAC,KAAK,CAAC,CAAC,CAAC,EAAE,CAAC,EAAE,UAAU,CAAC,KAAK,CAAC,CAAC,CAAC,EAAE,CAAC;AAC5D,CAAC;AAED;;;;;GAKG;AACH,MAAM,UAAU,QAAQ,CAAC,MAAY;IACnC,OAAO;QACL,CAAC,EAAE,IAAI,CAAC,KAAK,CAAC,MAAM,CAAC,CAAC,GAAG,MAAM,CAAC,KAAK,GAAG,CAAC,CAAC;QAC1C,CAAC,EAAE,IAAI,CAAC,KAAK,CAAC,MAAM,CAAC,CAAC,GAAG,MAAM,CAAC,MAAM,GAAG,CAAC,CAAC;KAC5C,CAAC;AACJ,CAAC;AA0BD;;;;;;;;;;;;;;;;;;GAkBG;AACH,MAAM,UAAU,iBAAiB,CAAC,MAA6B;IAC7D,IAAI,MAAM,KAAK,IAAI;QAAE,OAAO,KAAK,CAAC;IAClC,KAAK,MAAM,KAAK,IAAI,CAAC,MAAM,CAAC,CAAC,EAAE,MAAM,CAAC,CAAC,EAAE,MAAM,CAAC,KAAK,EAAE,MAAM,CAAC,MAAM,CAAC,EAAE,CAAC;QACtE,IAAI,KAAK,KAAK,IAAI,IAAI,CAAC,MAAM,CAAC,QAAQ,CAAC,KAAK,CAAC;YAAE,OAAO,KAAK,CAAC;IAC9D,CAAC;IACD,OAAO,MAAM,CAAC,KAAK,KAAK,IAAI,IAAI,MAAM,CAAC,MAAM,KAAK,IAAI,CAAC;AACzD,CAAC;AAED;;;GAGG;AACH,MAAM,UAAU,MAAM,CAAC,MAAsB;IAC3C,OAAO,EAAE,CAAC,EAAE,MAAM,CAAC,CAAC,IAAI,CAAC,EAAE,CAAC,EAAE,MAAM,CAAC,CAAC,IAAI,CAAC,EAAE,KAAK,EAAE,MAAM,CAAC,KAAK,EAAE,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,CAAC;AAC5F,CAAC"}

package/dist/esm/index.d.ts

@@ -0,0 +1,5 @@
+export { serializeXma, inspectXmaSupport } from './serializer/serialize-xma.js';
+export type { XmaSerializeOptions } from './serializer/serialize-xma.js';
+export { XmaSerializationError } from './diagnostics/errors.js';
+export type { XmaDiagnostic, XmaDiagnosticSeverity } from './diagnostics/diagnostics.js';
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,YAAY,EAAE,iBAAiB,EAAE,MAAM,+BAA+B,CAAC;AAChF,YAAY,EAAE,mBAAmB,EAAE,MAAM,+BAA+B,CAAC;AACzE,OAAO,EAAE,qBAAqB,EAAE,MAAM,yBAAyB,CAAC;AAChE,YAAY,EAAE,aAAa,EAAE,qBAAqB,EAAE,MAAM,8BAA8B,CAAC"}

package/dist/esm/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,YAAY,EAAE,iBAAiB,EAAE,MAAM,+BAA+B,CAAC;AAEhF,OAAO,EAAE,qBAAqB,EAAE,MAAM,yBAAyB,CAAC"}

package/dist/esm/infrastructure/assert.d.ts

@@ -0,0 +1,10 @@
+/**
+ * Asserts an internal cross-module invariant (e.g. "view-writer always
+ * registers this id before graphical-writer reads it back") instead of
+ * silently trusting it via a `!` non-null assertion. If the invariant is
+ * ever violated by a future refactor, this throws a clear, specific error
+ * instead of letting `undefined` flow into the rendered XML as the literal
+ * string `"undefined"`.
+ */
+export declare function assertDefined<T>(value: T | undefined, message: string): T;
+//# sourceMappingURL=assert.d.ts.map

package/dist/esm/infrastructure/assert.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"assert.d.ts","sourceRoot":"","sources":["../../../src/infrastructure/assert.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AACH,wBAAgB,aAAa,CAAC,CAAC,EAAE,KAAK,EAAE,CAAC,GAAG,SAAS,EAAE,OAAO,EAAE,MAAM,GAAG,CAAC,CAKzE"}

package/dist/esm/infrastructure/assert.js

@@ -0,0 +1,15 @@
+/**
+ * Asserts an internal cross-module invariant (e.g. "view-writer always
+ * registers this id before graphical-writer reads it back") instead of
+ * silently trusting it via a `!` non-null assertion. If the invariant is
+ * ever violated by a future refactor, this throws a clear, specific error
+ * instead of letting `undefined` flow into the rendered XML as the literal
+ * string `"undefined"`.
+ */
+export function assertDefined(value, message) {
+    if (value === undefined) {
+        throw new Error(`Internal invariant violation: ${message}`);
+    }
+    return value;
+}
+//# sourceMappingURL=assert.js.map

package/dist/esm/infrastructure/assert.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"assert.js","sourceRoot":"","sources":["../../../src/infrastructure/assert.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AACH,MAAM,UAAU,aAAa,CAAI,KAAoB,EAAE,OAAe;IACpE,IAAI,KAAK,KAAK,SAAS,EAAE,CAAC;QACxB,MAAM,IAAI,KAAK,CAAC,iCAAiC,OAAO,EAAE,CAAC,CAAC;IAC9D,CAAC;IACD,OAAO,KAAK,CAAC;AACf,CAAC"}

package/dist/esm/infrastructure/id-allocator.d.ts

@@ -0,0 +1,34 @@
+/**
+ * Deterministic numeric XMA id allocator.
+ *
+ * XMA reference documents use small sequential integer ids. We do not (and
+ * cannot) reproduce Archi's string ids — instead we hand out ids in strictly
+ * increasing order, starting from 1, driven entirely by serializer traversal
+ * order. As long as the traversal order over a given `ArchiModel` is stable
+ * (it is: every `ArchiModel` collection preserves source document order),
+ * the same input always yields the same ids.
+ *
+ * Never uses Math.random(), Date.now(), or any other non-deterministic or
+ * environment-specific source.
+ */
+export declare class XmaIdAllocator {
+    private counter;
+    next(): number;
+}
+/**
+ * A registry mapping arbitrary string keys (Archi ids, or synthetic
+ * composite keys) to allocated XMA numeric ids, with reference-consistent
+ * reuse: asking for the same key twice returns the same id.
+ */
+export declare class XmaIdRegistry {
+    private readonly allocator;
+    private readonly ids;
+    constructor(allocator: XmaIdAllocator);
+    /** Allocates (or returns the previously allocated) id for `key`. */
+    idFor(key: string): number;
+    /** Allocates a fresh id not tied to any lookup key (e.g. structural scaffolding elements). */
+    fresh(): number;
+    has(key: string): boolean;
+    get(key: string): number | undefined;
+}
+//# sourceMappingURL=id-allocator.d.ts.map

package/dist/esm/infrastructure/id-allocator.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"id-allocator.d.ts","sourceRoot":"","sources":["../../../src/infrastructure/id-allocator.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;GAYG;AACH,qBAAa,cAAc;IACzB,OAAO,CAAC,OAAO,CAAK;IAEpB,IAAI,IAAI,MAAM;CAIf;AAED;;;;GAIG;AACH,qBAAa,aAAa;IAGZ,OAAO,CAAC,QAAQ,CAAC,SAAS;IAFtC,OAAO,CAAC,QAAQ,CAAC,GAAG,CAA6B;gBAEpB,SAAS,EAAE,cAAc;IAEtD,oEAAoE;IACpE,KAAK,CAAC,GAAG,EAAE,MAAM,GAAG,MAAM;IAU1B,8FAA8F;IAC9F,KAAK,IAAI,MAAM;IAIf,GAAG,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO;IAIzB,GAAG,CAAC,GAAG,EAAE,MAAM,GAAG,MAAM,GAAG,SAAS;CAGrC"}

package/dist/esm/infrastructure/id-allocator.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"id-allocator.js","sourceRoot":"","sources":["../../../src/infrastructure/id-allocator.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;GAYG;AACH,MAAM,OAAO,cAAc;IAA3B;QACU,YAAO,GAAG,CAAC,CAAC;IAMtB,CAAC;IAJC,IAAI;QACF,IAAI,CAAC,OAAO,IAAI,CAAC,CAAC;QAClB,OAAO,IAAI,CAAC,OAAO,CAAC;IACtB,CAAC;CACF;AAED;;;;GAIG;AACH,MAAM,OAAO,aAAa;IAGxB,YAA6B,SAAyB;QAAzB,cAAS,GAAT,SAAS,CAAgB;QAFrC,QAAG,GAAG,IAAI,GAAG,EAAkB,CAAC;IAEQ,CAAC;IAE1D,oEAAoE;IACpE,KAAK,CAAC,GAAW;QACf,MAAM,QAAQ,GAAG,IAAI,CAAC,GAAG,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC;QACnC,IAAI,QAAQ,KAAK,SAAS,EAAE,CAAC;YAC3B,OAAO,QAAQ,CAAC;QAClB,CAAC;QACD,MAAM,EAAE,GAAG,IAAI,CAAC,SAAS,CAAC,IAAI,EAAE,CAAC;QACjC,IAAI,CAAC,GAAG,CAAC,GAAG,CAAC,GAAG,EAAE,EAAE,CAAC,CAAC;QACtB,OAAO,EAAE,CAAC;IACZ,CAAC;IAED,8FAA8F;IAC9F,KAAK;QACH,OAAO,IAAI,CAAC,SAAS,CAAC,IAAI,EAAE,CAAC;IAC/B,CAAC;IAED,GAAG,CAAC,GAAW;QACb,OAAO,IAAI,CAAC,GAAG,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC;IAC3B,CAAC;IAED,GAAG,CAAC,GAAW;QACb,OAAO,IAAI,CAAC,GAAG,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC;IAC3B,CAAC;CACF"}

package/dist/esm/infrastructure/xml-writer.d.ts

@@ -0,0 +1,20 @@
+/**
+ * Minimal typed XML element tree + deterministic serializer.
+ *
+ * Business logic builds `XmlElement` trees (attribute order and child order
+ * are explicit arrays, controlled entirely by the caller) and this module
+ * turns them into text. No implicit ordering, no host/timestamp-dependent
+ * output, no third-party XML dependency — keeps the runtime browser-safe.
+ */
+export interface XmlElement {
+    tag: string;
+    attrs?: Array<[string, string]>;
+    children?: XmlElement[];
+    /** Leaf text content. Mutually exclusive with `children` in practice. */
+    text?: string;
+}
+export declare function element(tag: string, attrs?: Array<[string, string]>, children?: XmlElement[]): XmlElement;
+export declare function textElement(tag: string, text: string, attrs?: Array<[string, string]>): XmlElement;
+/** Renders a root element to a complete, deterministic XML document string. */
+export declare function renderXmlDocument(root: XmlElement): string;
+//# sourceMappingURL=xml-writer.d.ts.map

package/dist/esm/infrastructure/xml-writer.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"xml-writer.d.ts","sourceRoot":"","sources":["../../../src/infrastructure/xml-writer.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH,MAAM,WAAW,UAAU;IACzB,GAAG,EAAE,MAAM,CAAC;IACZ,KAAK,CAAC,EAAE,KAAK,CAAC,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC,CAAC;IAChC,QAAQ,CAAC,EAAE,UAAU,EAAE,CAAC;IACxB,yEAAyE;IACzE,IAAI,CAAC,EAAE,MAAM,CAAC;CACf;AAED,wBAAgB,OAAO,CACrB,GAAG,EAAE,MAAM,EACX,KAAK,CAAC,EAAE,KAAK,CAAC,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC,EAC/B,QAAQ,CAAC,EAAE,UAAU,EAAE,GACtB,UAAU,CAEZ;AAED,wBAAgB,WAAW,CAAC,GAAG,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,EAAE,KAAK,CAAC,EAAE,KAAK,CAAC,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC,GAAG,UAAU,CAElG;AAuED,+EAA+E;AAC/E,wBAAgB,iBAAiB,CAAC,IAAI,EAAE,UAAU,GAAG,MAAM,CAI1D"}