@cda/adapter-xma 0.4.3 → 0.6.0

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 Continuous-Driven Architecture
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -59,9 +59,9 @@ unconfirmed relationship, more than one view, a diagram object missing
 width/height, ...) it throws `XmaSerializationError` carrying a structured
 diagnostic for every problem found, rather than silently dropping content or
 fabricating an approximate result. Lower-severity findings (`warning`) don't
-block serialization — e.g. an explicit font-size override, or a
-`DiagramModelReference` that gets omitted the same way Archi's own XMA
-export omits it.
+block serialization — e.g. an explicit fill-opacity (`alpha`) override, or a
+`DiagramModelReference` pointing outside this model's own ArchiMate views
+(e.g. a Sketch/Canvas), which has no XMA representation.
 
 To preview what is and isn't supported without throwing:
 
@@ -145,16 +145,46 @@ extrapolated beyond that evidence.
   when its value is `0`, per the ArchiMate Exchange Format convention. Not
   treated as incomplete geometry; JS's null-coerces-to-0 arithmetic applies
   the default when scaling/centering. See `src/geometry/geometry.ts`.
-- `DiagramModelReference` ("insert view as reference") nodes are recognized
-  and omitted with a `warning` diagnostic, not a blocking error — confirmed
-  against the agile-manifesto fixture, whose real XMA export contains no
-  trace whatsoever of such a node or its connections. See
-  `src/serializer/view-writer.ts`.
+- `DiagramModelReference` ("insert view as reference") nodes, when they
+  point at another ArchiMate view within the same model — drawn as an
+  `mm_concept="AllView"`/`mm_graphicType="3"` node whose semantic object
+  resolves, via an `ArchiMate:AllViewRef`, to the *referenced view's own*
+  `ArchiMate:AllView` (no new semantic concept is minted for the reference
+  itself). Confirmed byte-for-byte against both instances in the
+  agile-manifesto fixture, including their fixed fill/line color. A
+  reference to something outside this model's own views (e.g. a
+  Sketch/Canvas) has no XMA representation and is reported as a `warning`,
+  not a blocking error. See `src/serializer/view-writer.ts` and
+  `graphical-writer.ts`'s `buildViewReferenceNode`.
+- **A purely-visual connection between two drawable objects (no underlying
+  ArchiMate relationship)** — represented as an `ArchiMate:ViewEdge`
+  (semantic layer) and an `mm_concept="ViewEdge"` `MM_DirectedRel`
+  (graphical layer). Confirmed against two independent real instances in
+  two different fixtures — agile-manifesto (between two
+  `DiagramModelReference`s) and sabsa (between a Note/Group and a
+  `BusinessRole` element) — that the `ViewEdge`'s `from`/`to` are exactly
+  each endpoint's own semantic id, the same value already used as that
+  endpoint's own node's `mm_semanticObject`. Requires
+  `@cda/archi-semantic-core >=0.4.3`, which stopped silently dropping a
+  `sourceConnection` with no `xsi:type` (some of these connections have
+  none); with an older parser version the connection simply never reaches
+  this library's input, so nothing breaks, the improvement just doesn't
+  apply. See `view-writer.ts`'s `resolveObjectSemanticId`.
 - A configurable output language, applied consistently — never inferred
   from element names.
 - Direct, lossless mapping of explicit Archi `fillColor`/`lineColor`
   (hex → RGB) and `fontName` overrides, where the source field maps onto
-  the exact same structural XMA slot.
+  the exact same structural XMA slot — including a connection's own
+  `lineColor` override, applied to its `MM_DirectedRel` the same way.
+- An explicit font-size override, via the confirmed `floor(pt) * 20`
+  formula (two independent data points in the agile-manifesto fixture:
+  11.25pt → `mm_fontSize="220"`, 14.25pt → `"280"`).
+- **Multiple views sharing an element or relationship** each get their own
+  independent `RefObjects` entry — confirmed against the 38-view sabsa
+  fixture (840 `Ref` elements for 735 distinct semantic targets: a ref id
+  is never reused across two views). An earlier version deduplicated these
+  globally, which silently dropped `RefObjects` entries for every view
+  after the first that referenced an already-seen element.
 
 ### Not yet guaranteed
 
@@ -173,19 +203,18 @@ extrapolated beyond that evidence.
 - A nested `ArchiNote` (as opposed to a nested `ArchiDiagramObject`, now
   supported) — only one instance exists across all four fixtures, not
   enough to confirm its representation.
-- Purely visual (non-semantic) connections not touching a
-  `DiagramModelReference` — no fixture evidence either way (the one
-  purely-visual connection found, between two `DiagramModelReference`
-  nodes, isn't even parsed as a diagram connection by
-  `@cda/archi-semantic-core`, since it lacks an `xsi:type`).
 - Profiles/specializations and arbitrary model properties.
-- Explicit font size, bold/italic, line width, font color, or connector
-  line color overrides (reported as diagnostics; the confirmed defaults are
-  used instead).
+- Explicit bold/italic, line width, font color, or fill opacity (`alpha`)
+  overrides (reported as diagnostics; the confirmed defaults are used
+  instead). `alpha` in particular has zero occurrences across all four
+  reference fixtures — no evidence to confirm a mapping, so it's diagnosed
+  like every other unconfirmed override rather than applied on a guess.
 - Manual connector anchor metadata (`mm_fromx`/`mm_fromy`/`mm_tox`/`mm_toy`)
-  — only one fixture exhibited these attributes, not enough evidence to
-  derive a general formula or confirm they're required for import. They are
-  deliberately omitted rather than guessed; see
+  — present on a minority of connections in three of the four fixtures
+  (5/93 in agile-manifesto, 1/3 in relaciones, 15/346 in sabsa; catalogo has
+  no connections at all), never on all of them. Not enough evidence to tell
+  what distinguishes an anchored connection from the rest or to derive a
+  general formula, so they're deliberately omitted rather than guessed; see
   `src/serializer/graphical-writer.ts`.
 
 ## Architecture
@@ -238,10 +267,15 @@ values are ever embedded).
 ```
 npm install
 npm run typecheck
+npm run lint
 npm run build
 npm test
 ```
 
+See [`CONTRIBUTING.md`](CONTRIBUTING.md) for this project's core rule
+(every mapping is evidence-backed, never guessed) and how to trace a
+change to fixture bytes.
+
 ## License
 
 MIT

package/dist/cjs/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/cjs/diagnostics/diagnostics.js

@@ -0,0 +1,23 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.DiagnosticCollector = void 0;
+/** Accumulates diagnostics during a single serialization pass. */
+class DiagnosticCollector {
+    constructor() {
+        this.items = [];
+    }
+    error(diagnostic) {
+        this.items.push({ ...diagnostic, severity: 'error' });
+    }
+    warning(diagnostic) {
+        this.items.push({ ...diagnostic, severity: 'warning' });
+    }
+    get all() {
+        return [...this.items];
+    }
+    get hasErrors() {
+        return this.items.some((d) => d.severity === 'error');
+    }
+}
+exports.DiagnosticCollector = DiagnosticCollector;
+//# sourceMappingURL=diagnostics.js.map

package/dist/cjs/diagnostics/diagnostics.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"diagnostics.js","sourceRoot":"","sources":["../../../src/diagnostics/diagnostics.ts"],"names":[],"mappings":";;;AAaA,kEAAkE;AAClE,MAAa,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;AAlBD,kDAkBC"}

package/dist/cjs/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/cjs/diagnostics/errors.js

@@ -0,0 +1,24 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.XmaSerializationError = void 0;
+/**
+ * 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.
+ */
+class XmaSerializationError extends Error {
+    constructor(diagnostics) {
+        const errorCount = diagnostics.filter((d) => d.severity === 'error').length;
+        super(`XMA serialization failed: ${errorCount} unsupported construct(s) would cause semantic or presentation loss. ` +
+            diagnostics
+                .filter((d) => d.severity === 'error')
+                .map((d) => `[${d.code}] ${d.message}`)
+                .join('; '));
+        this.name = 'XmaSerializationError';
+        this.diagnostics = diagnostics;
+    }
+}
+exports.XmaSerializationError = XmaSerializationError;
+//# sourceMappingURL=errors.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"errors.js","sourceRoot":"","sources":["../../../src/diagnostics/errors.ts"],"names":[],"mappings":";;;AAEA;;;;;;GAMG;AACH,MAAa,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;AAfD,sDAeC"}

package/dist/cjs/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/cjs/geometry/bendpoints.js

@@ -0,0 +1,51 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.resolveBendpoint = resolveBendpoint;
+const geometry_js_1 = require("./geometry.js");
+const AGREEMENT_EPSILON = 0.01;
+/**
+ * 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.
+ */
+function resolveBendpoint(bendpoint, sourceBounds, targetBounds) {
+    // 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;
+    }
+    const sourceCenter = (0, geometry_js_1.centerOf)(sourceBounds);
+    const targetCenter = (0, geometry_js_1.centerOf)(targetBounds);
+    const fromSource = hasSourceOffset
+        ? { x: sourceCenter.x + bendpoint.startX, y: sourceCenter.y + bendpoint.startY }
+        : null;
+    const fromTarget = hasTargetOffset
+        ? { x: targetCenter.x + bendpoint.endX, y: targetCenter.y + bendpoint.endY }
+        : null;
+    if (fromSource && fromTarget) {
+        const deltaX = Math.abs(fromSource.x - fromTarget.x);
+        const deltaY = Math.abs(fromSource.y - fromTarget.y);
+        if (deltaX > AGREEMENT_EPSILON || deltaY > AGREEMENT_EPSILON) {
+            return { point: fromSource, agreement: 'both', mismatch: { fromSource, fromTarget } };
+        }
+        return { point: fromSource, agreement: 'both' };
+    }
+    if (fromSource) {
+        return { point: fromSource, agreement: 'source-only' };
+    }
+    return { point: fromTarget, agreement: 'target-only' };
+}
+//# sourceMappingURL=bendpoints.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"bendpoints.js","sourceRoot":"","sources":["../../../src/geometry/bendpoints.ts"],"names":[],"mappings":";;AAgCA,4CAwCC;AAvED,+CAAyC;AAEzC,MAAM,iBAAiB,GAAG,IAAI,CAAC;AAe/B;;;;;;;;;;;;;GAaG;AACH,SAAgB,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,IAAA,sBAAQ,EAAC,YAAY,CAAC,CAAC;IAC5C,MAAM,YAAY,GAAG,IAAA,sBAAQ,EAAC,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/cjs/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/cjs/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/cjs/geometry/geometry.js

@@ -0,0 +1,77 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.XMA_SCALE = void 0;
+exports.scaleValue = scaleValue;
+exports.scaleRect = scaleRect;
+exports.scalePoint = scalePoint;
+exports.centerOf = centerOf;
+exports.hasCompleteBounds = hasCompleteBounds;
+exports.toRect = toRect;
+/**
+ * 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).
+ */
+exports.XMA_SCALE = 3;
+function scaleValue(archiValue) {
+    return archiValue * exports.XMA_SCALE;
+}
+function scaleRect(bounds) {
+    return {
+        x: scaleValue(bounds.x),
+        y: scaleValue(bounds.y),
+        width: scaleValue(bounds.width),
+        height: scaleValue(bounds.height),
+    };
+}
+function scalePoint(point) {
+    return { x: scaleValue(point.x), y: scaleValue(point.y) };
+}
+/**
+ * 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.
+ */
+function centerOf(bounds) {
+    return {
+        x: Math.floor(bounds.x + bounds.width / 2),
+        y: Math.floor(bounds.y + bounds.height / 2),
+    };
+}
+/**
+ * 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.
+ */
+function hasCompleteBounds(bounds) {
+    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`.
+ */
+function toRect(bounds) {
+    return { x: bounds.x ?? 0, y: bounds.y ?? 0, width: bounds.width, height: bounds.height };
+}
+//# sourceMappingURL=geometry.js.map

package/dist/cjs/geometry/geometry.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"geometry.js","sourceRoot":"","sources":["../../../src/geometry/geometry.ts"],"names":[],"mappings":";;;AAcA,gCAEC;AAED,8BAOC;AAOD,gCAEC;AAQD,4BAKC;AA6CD,8CAMC;AAMD,wBAEC;AA1GD;;;;GAIG;AACU,QAAA,SAAS,GAAG,CAAC,CAAC;AAS3B,SAAgB,UAAU,CAAC,UAAkB;IAC3C,OAAO,UAAU,GAAG,iBAAS,CAAC;AAChC,CAAC;AAED,SAAgB,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,SAAgB,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,SAAgB,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,SAAgB,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,SAAgB,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/cjs/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/cjs/index.js

@@ -0,0 +1,9 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.XmaSerializationError = exports.inspectXmaSupport = exports.serializeXma = void 0;
+var serialize_xma_js_1 = require("./serializer/serialize-xma.js");
+Object.defineProperty(exports, "serializeXma", { enumerable: true, get: function () { return serialize_xma_js_1.serializeXma; } });
+Object.defineProperty(exports, "inspectXmaSupport", { enumerable: true, get: function () { return serialize_xma_js_1.inspectXmaSupport; } });
+var errors_js_1 = require("./diagnostics/errors.js");
+Object.defineProperty(exports, "XmaSerializationError", { enumerable: true, get: function () { return errors_js_1.XmaSerializationError; } });
+//# sourceMappingURL=index.js.map

package/dist/cjs/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/index.ts"],"names":[],"mappings":";;;AAAA,kEAAgF;AAAvE,gHAAA,YAAY,OAAA;AAAE,qHAAA,iBAAiB,OAAA;AAExC,qDAAgE;AAAvD,kHAAA,qBAAqB,OAAA"}

package/dist/cjs/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/cjs/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/cjs/infrastructure/assert.js

@@ -0,0 +1,18 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.assertDefined = assertDefined;
+/**
+ * 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"`.
+ */
+function assertDefined(value, message) {
+    if (value === undefined) {
+        throw new Error(`Internal invariant violation: ${message}`);
+    }
+    return value;
+}
+//# sourceMappingURL=assert.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"assert.js","sourceRoot":"","sources":["../../../src/infrastructure/assert.ts"],"names":[],"mappings":";;AAQA,sCAKC;AAbD;;;;;;;GAOG;AACH,SAAgB,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/cjs/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/cjs/infrastructure/id-allocator.js

@@ -0,0 +1,59 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.XmaIdRegistry = exports.XmaIdAllocator = void 0;
+/**
+ * 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.
+ */
+class XmaIdAllocator {
+    constructor() {
+        this.counter = 0;
+    }
+    next() {
+        this.counter += 1;
+        return this.counter;
+    }
+}
+exports.XmaIdAllocator = XmaIdAllocator;
+/**
+ * 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.
+ */
+class XmaIdRegistry {
+    constructor(allocator) {
+        this.allocator = allocator;
+        this.ids = new Map();
+    }
+    /** Allocates (or returns the previously allocated) id for `key`. */
+    idFor(key) {
+        const existing = this.ids.get(key);
+        if (existing !== undefined) {
+            return existing;
+        }
+        const id = this.allocator.next();
+        this.ids.set(key, id);
+        return id;
+    }
+    /** Allocates a fresh id not tied to any lookup key (e.g. structural scaffolding elements). */
+    fresh() {
+        return this.allocator.next();
+    }
+    has(key) {
+        return this.ids.has(key);
+    }
+    get(key) {
+        return this.ids.get(key);
+    }
+}
+exports.XmaIdRegistry = XmaIdRegistry;
+//# sourceMappingURL=id-allocator.js.map

package/dist/cjs/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,MAAa,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;AAPD,wCAOC;AAED;;;;GAIG;AACH,MAAa,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;AA5BD,sCA4BC"}

package/dist/cjs/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"}