@cda/adapter-xma 0.4.3 → 0.6.0

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

@@ -0,0 +1,109 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.buildSemanticRelationships = buildSemanticRelationships;
+const xml_writer_js_1 = require("../infrastructure/xml-writer.js");
+const assert_js_1 = require("../infrastructure/assert.js");
+const relationship_mapping_js_1 = require("../mapping/relationship-mapping.js");
+const generic_relationship_mapping_js_1 = require("../mapping/generic-relationship-mapping.js");
+function getOrCreateScheme(schemeBuilds, tag) {
+    let build = schemeBuilds.get(tag);
+    if (!build) {
+        build = { tag, collections: new Map(), relations: [] };
+        schemeBuilds.set(tag, build);
+    }
+    return build;
+}
+/**
+ * Builds the semantic `<ArchiMate:{RelationshipType} from="..." to="..."/>`
+ * elements for every `ArchiRelationship` that resolves either to a confirmed
+ * exact-triple mapping or a confirmed generic form. Every relation — exact
+ * or generic — is appended to its **source element's own scheme's**
+ * `Relations` collection (falling back to the root-level container only
+ * when the source has no scheme, i.e. a Junction/OrJunction). Confirmed
+ * against the agile-manifesto fixture by cross-referencing three generic-form
+ * relations' `from` ids against their defining element: an
+ * `ElementElementAssociation` sourced from an `ApplicationComponent` sits in
+ * `ApplicationScheme`'s `Relations`; a `GroupingElementComposition` sourced
+ * from a `Grouping` sits in `CompositeScheme`'s; an `InfluenceRelation`
+ * sourced from a `Junction` sits in the root's. Everything unmapped is
+ * diagnosed, never guessed — see `mapping/relationship-mapping.ts` and
+ * `mapping/generic-relationship-mapping.ts`.
+ */
+function buildSemanticRelationships(model, ids, elementIndex, relationshipIndex, mappedElements, schemeBuilds, diagnostics) {
+    const mappedRelationships = new Map();
+    const rootRelationsXml = [];
+    for (const rel of model.relationships) {
+        const sourceEl = elementIndex.get(rel.sourceId);
+        const targetEl = elementIndex.get(rel.targetId);
+        if (!sourceEl || !targetEl) {
+            const endpointIsRelationship = (!sourceEl && relationshipIndex.has(rel.sourceId)) || (!targetEl && relationshipIndex.has(rel.targetId));
+            diagnostics.error({
+                code: endpointIsRelationship ? 'unsupported-relationship-endpoint' : 'dangling-relationship-reference',
+                message: endpointIsRelationship
+                    ? `Relationship "${rel.type}" (${rel.id}) has another relationship as an endpoint — relationship-to-relationship endpoints are not supported in XMA v0.1.`
+                    : `Relationship "${rel.type}" (${rel.id}) references a source/target id not found among the model's elements.`,
+                entityId: rel.id,
+                entityType: 'ArchiRelationship',
+            });
+            continue;
+        }
+        if (!mappedElements.has(sourceEl.id) || !mappedElements.has(targetEl.id)) {
+            // The endpoint element itself already produced an unsupported-element-type
+            // diagnostic; this is the knock-on effect on the relationship.
+            diagnostics.error({
+                code: 'unsupported-relationship-endpoint-type',
+                message: `Relationship "${rel.type}" (${rel.id}) has an endpoint whose element type has no XMA mapping.`,
+                entityId: rel.id,
+                entityType: 'ArchiRelationship',
+            });
+            continue;
+        }
+        const exactMapping = (0, relationship_mapping_js_1.lookupRelationshipMapping)(rel.type, sourceEl.type, targetEl.type);
+        const genericMapping = exactMapping ? undefined : (0, generic_relationship_mapping_js_1.lookupGenericRelationshipMapping)(rel.type, sourceEl.type, targetEl.type);
+        const mapping = exactMapping ?? genericMapping;
+        if (!mapping) {
+            diagnostics.error({
+                code: 'unsupported-relationship',
+                message: `Relationship "${rel.type}" from ${sourceEl.type} to ${targetEl.type} has no confirmed XMA mapping.`,
+                entityId: rel.id,
+                entityType: 'ArchiRelationship',
+            });
+            continue;
+        }
+        if (rel.properties.length > 0) {
+            diagnostics.warning({
+                code: 'unsupported-properties',
+                message: `Relationship "${rel.name ?? rel.id}" has ${rel.properties.length} propert${rel.properties.length === 1 ? 'y' : 'ies'} not represented in XMA v0.1.`,
+                entityId: rel.id,
+                entityType: 'ArchiRelationship',
+            });
+        }
+        if (rel.profiles.length > 0) {
+            diagnostics.warning({
+                code: 'unsupported-profile',
+                message: `Relationship "${rel.name ?? rel.id}" references ${rel.profiles.length} profile(s)/specialization(s) not represented in XMA v0.1.`,
+                entityId: rel.id,
+                entityType: 'ArchiRelationship',
+            });
+        }
+        mappedRelationships.set(rel.id, mapping);
+        const xmaId = ids.idFor(rel.id);
+        const relationXml = (0, xml_writer_js_1.element)(`ArchiMate:${mapping.xmaType}`, [
+            ['id', String(xmaId)],
+            ['from', String(ids.idFor(sourceEl.id))],
+            ['to', String(ids.idFor(targetEl.id))],
+        ]);
+        const schemeTag = exactMapping
+            ? exactMapping.scheme
+            : (0, assert_js_1.assertDefined)(mappedElements.get(sourceEl.id), `no mapping for source element "${sourceEl.id}" (checked present earlier in this same function)`).scheme;
+        if (schemeTag === 'root') {
+            rootRelationsXml.push(relationXml);
+        }
+        else {
+            const scheme = getOrCreateScheme(schemeBuilds, schemeTag);
+            scheme.relations.push(relationXml);
+        }
+    }
+    return { mappedRelationships, rootRelationsXml };
+}
+//# sourceMappingURL=relationship-writer.js.map

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

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

package/dist/cjs/serializer/rtf.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"rtf.d.ts","sourceRoot":"","sources":["../../../src/serializer/rtf.ts"],"names":[],"mappings":"AAiDA;;;;;;GAMG;AACH,wBAAgB,aAAa,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,CAElD"}

package/dist/cjs/serializer/rtf.js

@@ -0,0 +1,67 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.toRtfDocument = toRtfDocument;
+/**
+ * Deterministic, dependency-free RTF encoding for Archi `documentation`
+ * text, used as the `doc` profile value's content.
+ *
+ * RTF control characters (`\\`, `{`, `}`) are escaped, line breaks become
+ * `\par`, and every non-ASCII / control code unit is escaped as a signed
+ * `\uN?` Unicode destination (RTF 1.5+, one fallback byte per `\uc1`) rather
+ * than interpolated raw — this keeps the output valid RTF regardless of
+ * source locale (Spanish, accented Latin text, etc.) without guessing a
+ * target ANSI code page.
+ */
+/**
+ * Iterates by UTF-16 code unit (not by Unicode code point) deliberately: a
+ * character outside the Basic Multilingual Plane (e.g. an emoji) is stored
+ * in JS strings as a surrogate pair, and this naturally emits it as two
+ * consecutive `\uN?` escapes, one per surrogate half — the standard,
+ * widely-implemented RTF technique for supplementary-plane characters
+ * (RTF's own `\u` model is itself UTF-16-code-unit-based). This is not
+ * splitting one character across two escapes by accident; recombining a
+ * code point first and emitting one escape would be the non-standard
+ * choice. No fixture contains an astral character in documentation text to
+ * confirm this against directly, but the signed-16-bit conversion below is
+ * applied uniformly and correctly regardless of whether a given code unit
+ * happens to be a surrogate half.
+ */
+function escapeRtfBody(text) {
+    const normalized = text.replace(/\r\n/g, '\n').replace(/\r/g, '\n');
+    const out = [];
+    for (let i = 0; i < normalized.length; i += 1) {
+        const ch = normalized[i];
+        const code = normalized.charCodeAt(i);
+        if (ch === '\n') {
+            out.push('\\par\n');
+        }
+        else if (ch === '\\') {
+            out.push('\\\\');
+        }
+        else if (ch === '{') {
+            out.push('\\{');
+        }
+        else if (ch === '}') {
+            out.push('\\}');
+        }
+        else if (code >= 0x20 && code <= 0x7e) {
+            out.push(ch);
+        }
+        else {
+            const signed = code > 0x7fff ? code - 0x10000 : code;
+            out.push(`\\u${signed}?`);
+        }
+    }
+    return out.join('');
+}
+/**
+ * Wraps escaped documentation text into an RTF document, matching the exact
+ * minimal shape confirmed by both reference fixtures: `{\rtf1 <text>}`, with
+ * no additional header control words — the reference tool emits nothing
+ * beyond that, and RTF 1.5+'s `\uN` Unicode escapes are valid on their own
+ * (the per-`\u` fallback byte count defaults to 1 with no `\ucN` present).
+ */
+function toRtfDocument(text) {
+    return `{\\rtf1 ${escapeRtfBody(text)}}`;
+}
+//# sourceMappingURL=rtf.js.map

package/dist/cjs/serializer/rtf.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"rtf.js","sourceRoot":"","sources":["../../../src/serializer/rtf.ts"],"names":[],"mappings":";;AAwDA,sCAEC;AA1DD;;;;;;;;;;GAUG;AACH;;;;;;;;;;;;;GAaG;AACH,SAAS,aAAa,CAAC,IAAY;IACjC,MAAM,UAAU,GAAG,IAAI,CAAC,OAAO,CAAC,OAAO,EAAE,IAAI,CAAC,CAAC,OAAO,CAAC,KAAK,EAAE,IAAI,CAAC,CAAC;IACpE,MAAM,GAAG,GAAa,EAAE,CAAC;IACzB,KAAK,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,GAAG,UAAU,CAAC,MAAM,EAAE,CAAC,IAAI,CAAC,EAAE,CAAC;QAC9C,MAAM,EAAE,GAAG,UAAU,CAAC,CAAC,CAAC,CAAC;QACzB,MAAM,IAAI,GAAG,UAAU,CAAC,UAAU,CAAC,CAAC,CAAC,CAAC;QACtC,IAAI,EAAE,KAAK,IAAI,EAAE,CAAC;YAChB,GAAG,CAAC,IAAI,CAAC,SAAS,CAAC,CAAC;QACtB,CAAC;aAAM,IAAI,EAAE,KAAK,IAAI,EAAE,CAAC;YACvB,GAAG,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC;QACnB,CAAC;aAAM,IAAI,EAAE,KAAK,GAAG,EAAE,CAAC;YACtB,GAAG,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;QAClB,CAAC;aAAM,IAAI,EAAE,KAAK,GAAG,EAAE,CAAC;YACtB,GAAG,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;QAClB,CAAC;aAAM,IAAI,IAAI,IAAI,IAAI,IAAI,IAAI,IAAI,IAAI,EAAE,CAAC;YACxC,GAAG,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;QACf,CAAC;aAAM,CAAC;YACN,MAAM,MAAM,GAAG,IAAI,GAAG,MAAM,CAAC,CAAC,CAAC,IAAI,GAAG,OAAO,CAAC,CAAC,CAAC,IAAI,CAAC;YACrD,GAAG,CAAC,IAAI,CAAC,MAAM,MAAM,GAAG,CAAC,CAAC;QAC5B,CAAC;IACH,CAAC;IACD,OAAO,GAAG,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;AACtB,CAAC;AAED;;;;;;GAMG;AACH,SAAgB,aAAa,CAAC,IAAY;IACxC,OAAO,WAAW,aAAa,CAAC,IAAI,CAAC,GAAG,CAAC;AAC3C,CAAC"}

package/dist/cjs/serializer/semantic-writer.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"semantic-writer.d.ts","sourceRoot":"","sources":["../../../src/serializer/semantic-writer.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,UAAU,EAAgB,MAAM,0BAA0B,CAAC;AACzE,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,iCAAiC,CAAC;AAElE,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,mCAAmC,CAAC;AACvE,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,+BAA+B,CAAC;AACzE,OAAO,EAAkD,KAAK,mBAAmB,EAAE,MAAM,+BAA+B,CAAC;AAGzH,MAAM,WAAW,WAAW;IAC1B,GAAG,EAAE,MAAM,CAAC;IACZ,uHAAuH;IACvH,WAAW,EAAE,GAAG,CAAC,MAAM,EAAE;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,QAAQ,EAAE,UAAU,EAAE,CAAA;KAAE,CAAC,CAAC;IACnE,8FAA8F;IAC9F,SAAS,EAAE,UAAU,EAAE,CAAC;CACzB;AAED,MAAM,WAAW,mBAAmB;IAClC,YAAY,EAAE,GAAG,CAAC,MAAM,EAAE,WAAW,CAAC,CAAC;IACvC,sHAAsH;IACtH,cAAc,EAAE,GAAG,CAAC,MAAM,EAAE,mBAAmB,CAAC,CAAC;IACjD;;;;;;OAMG;IACH,iBAAiB,EAAE,UAAU,EAAE,CAAC;CACjC;AAgGD;;;;;GAKG;AACH,wBAAgB,qBAAqB,CACnC,KAAK,EAAE,UAAU,EACjB,GAAG,EAAE,aAAa,EAClB,WAAW,EAAE,mBAAmB,EAChC,QAAQ,EAAE,MAAM,GACf,mBAAmB,CA6CrB;AAED;;;;;;;;;;;;;GAaG;AACH,wBAAgB,oBAAoB,CAAC,KAAK,EAAE,WAAW,EAAE,WAAW,EAAE,UAAU,GAAG,IAAI,EAAE,GAAG,EAAE,aAAa,GAAG,UAAU,EAAE,CAgBzH"}

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

@@ -0,0 +1,170 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.buildSemanticElements = buildSemanticElements;
+exports.renderSchemeChildren = renderSchemeChildren;
+const xml_writer_js_1 = require("../infrastructure/xml-writer.js");
+const element_mapping_js_1 = require("../mapping/element-mapping.js");
+const profile_values_js_1 = require("./profile-values.js");
+/**
+ * `ArchiElement.type` is always the literal string `"Junction"` for both
+ * AND and OR junctions — the And/Or distinction lives in the separate
+ * `junctionType` field. Confirmed directly in both fixtures: XMA has two
+ * distinct element tags for this, `Junction` (AND) and `OrJunction` (OR),
+ * each living in the root `Connectors` container. This resolves the XMA tag
+ * for a Junction element; unlike every other type, it can't be a static
+ * `ELEMENT_MAPPINGS` table entry keyed by `archiType` alone.
+ */
+function junctionXmaType(el) {
+    return el.junctionType === 'Or' ? 'OrJunction' : 'Junction';
+}
+/**
+ * `archi-semantic-core` already defaults an unrecognized native junction
+ * `type` attribute to `'And'` rather than guessing (see its `junctionType`
+ * doc comment) — but it also preserves the original value verbatim in
+ * `rawJunctionType` specifically so a downstream consumer can tell "really
+ * absent/empty, the documented default" apart from "an unrecognized value
+ * that got silently defaulted". This reports the latter as a warning
+ * instead of drawing an `And` Junction with no indication anything was
+ * guessed.
+ */
+function reportUnrecognizedJunctionType(el, diagnostics) {
+    if (el.junctionType !== 'And')
+        return;
+    const raw = el.rawJunctionType ?? '';
+    if (raw === '' || raw === 'or')
+        return;
+    diagnostics.warning({
+        code: 'unrecognized-junction-type',
+        message: `Junction "${el.name ?? el.id}" has an unrecognized native type value ("${raw}") — treated as AND (Archi's documented default for an unrecognized value), not necessarily what was intended.`,
+        entityId: el.id,
+        entityType: 'ArchiElement',
+    });
+}
+/**
+ * A `Junction`'s own `category`/`hasIcon` are never read: `graphical-writer`
+ * draws Junctions via a dedicated, colorless node form (confirmed in both
+ * fixtures — no `MM_Color`/`MM_Colors`, `mm_graphicType="3"` instead of the
+ * usual `"5"`) before ever consulting `CATEGORY_FILL_COLOR`. `category`
+ * still needs *some* valid value to satisfy `ElementMappingEntry`'s type;
+ * `'Grouping'` is used as an inert placeholder, not a claim about Junction's
+ * real presentation category.
+ */
+function junctionMappingEntry(el) {
+    const xmaType = junctionXmaType(el);
+    return {
+        archiType: 'Junction',
+        xmaType,
+        scheme: 'root',
+        collectionTag: 'Connectors',
+        collectionName: 'connectors',
+        category: 'Grouping',
+        hasIcon: false,
+    };
+}
+function getOrCreateScheme(schemeBuilds, tag) {
+    let build = schemeBuilds.get(tag);
+    if (!build) {
+        build = { tag, collections: new Map(), relations: [] };
+        schemeBuilds.set(tag, build);
+    }
+    return build;
+}
+function reportUnsupportedElement(element, diagnostics) {
+    diagnostics.error({
+        code: 'unsupported-element-type',
+        message: `Archi element type "${element.type}" has no confirmed XMA mapping and would be silently lost.`,
+        entityId: element.id,
+        entityType: 'ArchiElement',
+    });
+}
+function reportAncillaryLossWarnings(el, diagnostics) {
+    if (el.properties.length > 0) {
+        diagnostics.warning({
+            code: 'unsupported-properties',
+            message: `Element "${el.name ?? el.id}" has ${el.properties.length} propert${el.properties.length === 1 ? 'y' : 'ies'} not represented in XMA v0.1.`,
+            entityId: el.id,
+            entityType: 'ArchiElement',
+        });
+    }
+    if (el.profiles.length > 0) {
+        diagnostics.warning({
+            code: 'unsupported-profile',
+            message: `Element "${el.name ?? el.id}" references ${el.profiles.length} profile(s)/specialization(s) not represented in XMA v0.1.`,
+            entityId: el.id,
+            entityType: 'ArchiElement',
+        });
+    }
+}
+/**
+ * Builds the per-scheme element collections (`<ArchiMate:BusinessActors>`
+ * etc.) for every `ArchiElement` in the model, regardless of whether it
+ * appears in the (single supported) view — semantic elements are model-wide,
+ * not view-scoped.
+ */
+function buildSemanticElements(model, ids, diagnostics, language) {
+    const schemeBuilds = new Map();
+    const mappedElements = new Map();
+    const rootConnectorsXml = [];
+    for (const el of model.elements) {
+        if (el.type === 'Junction') {
+            const mapping = junctionMappingEntry(el);
+            mappedElements.set(el.id, mapping);
+            reportAncillaryLossWarnings(el, diagnostics);
+            reportUnrecognizedJunctionType(el, diagnostics);
+            const xmaId = ids.idFor(el.id);
+            rootConnectorsXml.push((0, xml_writer_js_1.element)(`ArchiMate:${mapping.xmaType}`, [['id', String(xmaId)]], [
+                (0, profile_values_js_1.buildProfileValues)(language, el.name ?? '', el.documentation),
+            ]));
+            continue;
+        }
+        const mapping = (0, element_mapping_js_1.lookupElementMapping)(el.type);
+        if (!mapping) {
+            reportUnsupportedElement(el, diagnostics);
+            continue;
+        }
+        mappedElements.set(el.id, mapping);
+        reportAncillaryLossWarnings(el, diagnostics);
+        const scheme = getOrCreateScheme(schemeBuilds, mapping.scheme);
+        let collection = scheme.collections.get(mapping.collectionTag);
+        if (!collection) {
+            collection = { name: mapping.collectionName, children: [] };
+            scheme.collections.set(mapping.collectionTag, collection);
+        }
+        const xmaId = ids.idFor(el.id);
+        const concept = (0, xml_writer_js_1.element)(`ArchiMate:${mapping.xmaType}`, [['id', String(xmaId)]], [(0, profile_values_js_1.buildProfileValues)(language, el.name ?? '', el.documentation)]);
+        collection.children.push(concept);
+    }
+    return { schemeBuilds, mappedElements, rootConnectorsXml };
+}
+/**
+ * Renders a `SchemeBuild`'s children (an optional `nm` profile, then each
+ * populated collection in confirmed order, then `Relations` last) — the
+ * caller wraps these in the actual `<ArchiMate:{schemeTag} id="...">`
+ * element, since only the caller (`document-writer`) knows the scheme's
+ * allocated id.
+ *
+ * Every collection element (including `Relations`) carries its own `id` —
+ * confirmed against the real fixture (e.g. `ApplicationComponents id="222"`,
+ * `Relations id="72"`), unlike a bare element concept which doesn't need one
+ * beyond its own. Previously omitted here; Enterprise Studio rejected the
+ * resulting document outright ("could not generate the object: unknown
+ * type") rather than merely losing content.
+ */
+function renderSchemeChildren(build, nameProfile, ids) {
+    const children = [];
+    if (nameProfile) {
+        children.push(nameProfile);
+    }
+    for (const { tag, name } of (0, element_mapping_js_1.getSchemeCollectionOrder)(build.tag)) {
+        const collection = build.collections.get(tag);
+        if (!collection || collection.children.length === 0) {
+            continue;
+        }
+        children.push((0, xml_writer_js_1.element)(`ArchiMate:${tag}`, [['name', name], ['id', String(ids.fresh())]], collection.children));
+    }
+    if (build.relations.length > 0) {
+        children.push((0, xml_writer_js_1.element)('ArchiMate:Relations', [['name', 'relations'], ['id', String(ids.fresh())]], build.relations));
+    }
+    return children;
+}
+//# sourceMappingURL=semantic-writer.js.map

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

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

package/dist/cjs/serializer/serialize-xma.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"serialize-xma.d.ts","sourceRoot":"","sources":["../../../src/serializer/serialize-xma.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,0BAA0B,CAAC;AAG3D,OAAO,EAAuB,KAAK,aAAa,EAAE,MAAM,+BAA+B,CAAC;AAQxF,MAAM,WAAW,mBAAmB;IAClC,2IAA2I;IAC3I,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,iJAAiJ;IACjJ,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,6IAA6I;IAC7I,SAAS,CAAC,EAAE,MAAM,CAAC;CACpB;AA6GD;;;;;;;;;;GAUG;AACH,wBAAgB,YAAY,CAAC,KAAK,EAAE,UAAU,EAAE,OAAO,CAAC,EAAE,mBAAmB,GAAG,MAAM,CAMrF;AAED;;;;GAIG;AACH,wBAAgB,iBAAiB,CAAC,KAAK,EAAE,UAAU,EAAE,OAAO,CAAC,EAAE,mBAAmB,GAAG,aAAa,EAAE,CAEnG"}

package/dist/cjs/serializer/serialize-xma.js

@@ -0,0 +1,113 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.serializeXma = serializeXma;
+exports.inspectXmaSupport = inspectXmaSupport;
+const xml_writer_js_1 = require("../infrastructure/xml-writer.js");
+const id_allocator_js_1 = require("../infrastructure/id-allocator.js");
+const diagnostics_js_1 = require("../diagnostics/diagnostics.js");
+const errors_js_1 = require("../diagnostics/errors.js");
+const semantic_writer_js_1 = require("./semantic-writer.js");
+const relationship_writer_js_1 = require("./relationship-writer.js");
+const view_writer_js_1 = require("./view-writer.js");
+const graphical_writer_js_1 = require("./graphical-writer.js");
+const document_writer_js_1 = require("./document-writer.js");
+const DEFAULT_PACKAGE_NAME = 'CDA XMA Package';
+const REQUIRED_MODEL_ARRAY_FIELDS = [
+    'elements',
+    'relationships',
+    'views',
+    'diagramObjects',
+    'diagramConnections',
+    'notes',
+    'folders',
+];
+/**
+ * `ArchiModel`'s shape is only enforced by TypeScript at compile time. A
+ * caller passing `null`/`undefined`, or an object missing a collection,
+ * would otherwise hit the first `.map()`/`.filter()` deep inside a writer
+ * and get a raw `Cannot read properties of undefined` — not an actionable
+ * error for a public library API. This is a caller-contract violation, not
+ * a "construct XMA can't represent" diagnostic, so it throws directly
+ * instead of going through `DiagnosticCollector`/`XmaSerializationError`.
+ */
+function assertValidModelShape(model) {
+    if (typeof model !== 'object' || model === null) {
+        throw new TypeError(`serializeXma: expected an ArchiModel object, got ${model === null ? 'null' : typeof model}.`);
+    }
+    if (typeof model.metadata !== 'object' || model.metadata === null) {
+        throw new TypeError('serializeXma: model.metadata is missing or invalid — expected an ArchiModel.');
+    }
+    for (const field of REQUIRED_MODEL_ARRAY_FIELDS) {
+        if (!Array.isArray(model[field])) {
+            throw new TypeError(`serializeXma: model.${field} is missing or not an array — expected an ArchiModel.`);
+        }
+    }
+}
+function planXmaDocument(model, options) {
+    assertValidModelShape(model);
+    const diagnostics = new diagnostics_js_1.DiagnosticCollector();
+    const language = options?.language ?? 'en';
+    const modelName = options?.modelName ?? model.metadata.name;
+    const packageName = options?.packageName ?? DEFAULT_PACKAGE_NAME;
+    const allocator = new id_allocator_js_1.XmaIdAllocator();
+    const ids = new id_allocator_js_1.XmaIdRegistry(allocator);
+    const { schemeBuilds, mappedElements, rootConnectorsXml } = (0, semantic_writer_js_1.buildSemanticElements)(model, ids, diagnostics, language);
+    const elementIndex = new Map(model.elements.map((e) => [e.id, e]));
+    const relationshipIndex = new Map(model.relationships.map((r) => [r.id, r]));
+    const { mappedRelationships, rootRelationsXml } = (0, relationship_writer_js_1.buildSemanticRelationships)(model, ids, elementIndex, relationshipIndex, mappedElements, schemeBuilds, diagnostics);
+    const builtViews = model.views.map((view) => {
+        // A fresh RefObjects registry per view — confirmed against the sabsa
+        // fixture (38 views): each `AllView`'s `RefObjects` is self-contained,
+        // so an element referenced from multiple views gets its own ref id in
+        // each one (840 total Ref elements for 735 distinct semantic targets in
+        // sabsa.xma, never a ref id reused across two views). A shared registry
+        // would leave every view after the first missing Ref entries for
+        // elements first seen in an earlier view.
+        const refIds = new id_allocator_js_1.XmaIdRegistry(allocator);
+        const viewResult = (0, view_writer_js_1.buildView)(model, view, ids, refIds, mappedElements, mappedRelationships, diagnostics, language);
+        const { diagramXml } = (0, graphical_writer_js_1.buildGraphicalModule)(model, view, ids, refIds, allocator, mappedElements, mappedRelationships, viewResult, diagnostics);
+        return { view, viewResult, graphicalDiagramXml: diagramXml };
+    });
+    if (diagnostics.hasErrors) {
+        return { diagnostics: diagnostics.all, documentXml: null };
+    }
+    const documentXml = (0, document_writer_js_1.buildXmaDocument)({
+        modelName,
+        packageName,
+        language,
+        ids,
+        schemeBuilds,
+        folders: model.folders,
+        views: builtViews,
+        rootConnectorsXml,
+        rootRelationsXml,
+    });
+    return { diagnostics: diagnostics.all, documentXml };
+}
+/**
+ * Serializes an `ArchiModel` (from `@cda/archi-semantic-core`) into an XMA
+ * document string.
+ *
+ * Strict by default: if any construct in the model would be silently lost
+ * (an unsupported element/relationship type, a second view, incomplete
+ * geometry, ...) this throws `XmaSerializationError` carrying the full
+ * structured diagnostic list, rather than producing an approximate or
+ * partial XMA document. Use `inspectXmaSupport` to preview what would be
+ * unsupported without throwing.
+ */
+function serializeXma(model, options) {
+    const { diagnostics, documentXml } = planXmaDocument(model, options);
+    if (documentXml === null) {
+        throw new errors_js_1.XmaSerializationError(diagnostics);
+    }
+    return (0, xml_writer_js_1.renderXmlDocument)(documentXml);
+}
+/**
+ * Non-mutating diagnostic pass: reports every construct in `model` that
+ * `serializeXma` would refuse to convert, without throwing and without
+ * requiring the model to be fully convertible.
+ */
+function inspectXmaSupport(model, options) {
+    return planXmaDocument(model, options).diagnostics;
+}
+//# sourceMappingURL=serialize-xma.js.map

package/dist/cjs/serializer/serialize-xma.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"serialize-xma.js","sourceRoot":"","sources":["../../../src/serializer/serialize-xma.ts"],"names":[],"mappings":";;AA0IA,oCAMC;AAOD,8CAEC;AAxJD,mEAAqF;AACrF,uEAAkF;AAClF,kEAAwF;AACxF,wDAAiE;AACjE,6DAA6D;AAC7D,qEAAsE;AACtE,qDAA6C;AAC7C,+DAA6D;AAC7D,6DAAwE;AAWxE,MAAM,oBAAoB,GAAG,iBAAiB,CAAC;AAE/C,MAAM,2BAA2B,GAAG;IAClC,UAAU;IACV,eAAe;IACf,OAAO;IACP,gBAAgB;IAChB,oBAAoB;IACpB,OAAO;IACP,SAAS;CACD,CAAC;AAEX;;;;;;;;GAQG;AACH,SAAS,qBAAqB,CAAC,KAAiB;IAC9C,IAAI,OAAO,KAAK,KAAK,QAAQ,IAAI,KAAK,KAAK,IAAI,EAAE,CAAC;QAChD,MAAM,IAAI,SAAS,CAAC,oDAAoD,KAAK,KAAK,IAAI,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,OAAO,KAAK,GAAG,CAAC,CAAC;IACrH,CAAC;IACD,IAAI,OAAO,KAAK,CAAC,QAAQ,KAAK,QAAQ,IAAI,KAAK,CAAC,QAAQ,KAAK,IAAI,EAAE,CAAC;QAClE,MAAM,IAAI,SAAS,CAAC,8EAA8E,CAAC,CAAC;IACtG,CAAC;IACD,KAAK,MAAM,KAAK,IAAI,2BAA2B,EAAE,CAAC;QAChD,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,KAAK,CAAC,KAAK,CAAC,CAAC,EAAE,CAAC;YACjC,MAAM,IAAI,SAAS,CAAC,uBAAuB,KAAK,uDAAuD,CAAC,CAAC;QAC3G,CAAC;IACH,CAAC;AACH,CAAC;AAOD,SAAS,eAAe,CAAC,KAAiB,EAAE,OAA6B;IACvE,qBAAqB,CAAC,KAAK,CAAC,CAAC;IAC7B,MAAM,WAAW,GAAG,IAAI,oCAAmB,EAAE,CAAC;IAC9C,MAAM,QAAQ,GAAG,OAAO,EAAE,QAAQ,IAAI,IAAI,CAAC;IAC3C,MAAM,SAAS,GAAG,OAAO,EAAE,SAAS,IAAI,KAAK,CAAC,QAAQ,CAAC,IAAI,CAAC;IAC5D,MAAM,WAAW,GAAG,OAAO,EAAE,WAAW,IAAI,oBAAoB,CAAC;IAEjE,MAAM,SAAS,GAAG,IAAI,gCAAc,EAAE,CAAC;IACvC,MAAM,GAAG,GAAG,IAAI,+BAAa,CAAC,SAAS,CAAC,CAAC;IAEzC,MAAM,EAAE,YAAY,EAAE,cAAc,EAAE,iBAAiB,EAAE,GAAG,IAAA,0CAAqB,EAAC,KAAK,EAAE,GAAG,EAAE,WAAW,EAAE,QAAQ,CAAC,CAAC;IAErH,MAAM,YAAY,GAAG,IAAI,GAAG,CAAC,KAAK,CAAC,QAAQ,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,CAAC,CAAC;IACnE,MAAM,iBAAiB,GAAG,IAAI,GAAG,CAAC,KAAK,CAAC,aAAa,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,CAAC,CAAC;IAC7E,MAAM,EAAE,mBAAmB,EAAE,gBAAgB,EAAE,GAAG,IAAA,mDAA0B,EAC1E,KAAK,EACL,GAAG,EACH,YAAY,EACZ,iBAAiB,EACjB,cAAc,EACd,YAAY,EACZ,WAAW,CACZ,CAAC;IAEF,MAAM,UAAU,GAAgB,KAAK,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC,IAAI,EAAE,EAAE;QACvD,qEAAqE;QACrE,uEAAuE;QACvE,sEAAsE;QACtE,wEAAwE;QACxE,wEAAwE;QACxE,iEAAiE;QACjE,0CAA0C;QAC1C,MAAM,MAAM,GAAG,IAAI,+BAAa,CAAC,SAAS,CAAC,CAAC;QAC5C,MAAM,UAAU,GAAG,IAAA,0BAAS,EAAC,KAAK,EAAE,IAAI,EAAE,GAAG,EAAE,MAAM,EAAE,cAAc,EAAE,mBAAmB,EAAE,WAAW,EAAE,QAAQ,CAAC,CAAC;QACnH,MAAM,EAAE,UAAU,EAAE,GAAG,IAAA,0CAAoB,EACzC,KAAK,EACL,IAAI,EACJ,GAAG,EACH,MAAM,EACN,SAAS,EACT,cAAc,EACd,mBAAmB,EACnB,UAAU,EACV,WAAW,CACZ,CAAC;QACF,OAAO,EAAE,IAAI,EAAE,UAAU,EAAE,mBAAmB,EAAE,UAAU,EAAE,CAAC;IAC/D,CAAC,CAAC,CAAC;IAEH,IAAI,WAAW,CAAC,SAAS,EAAE,CAAC;QAC1B,OAAO,EAAE,WAAW,EAAE,WAAW,CAAC,GAAG,EAAE,WAAW,EAAE,IAAI,EAAE,CAAC;IAC7D,CAAC;IAED,MAAM,WAAW,GAAG,IAAA,qCAAgB,EAAC;QACnC,SAAS;QACT,WAAW;QACX,QAAQ;QACR,GAAG;QACH,YAAY;QACZ,OAAO,EAAE,KAAK,CAAC,OAAO;QACtB,KAAK,EAAE,UAAU;QACjB,iBAAiB;QACjB,gBAAgB;KACjB,CAAC,CAAC;IAEH,OAAO,EAAE,WAAW,EAAE,WAAW,CAAC,GAAG,EAAE,WAAW,EAAE,CAAC;AACvD,CAAC;AAED;;;;;;;;;;GAUG;AACH,SAAgB,YAAY,CAAC,KAAiB,EAAE,OAA6B;IAC3E,MAAM,EAAE,WAAW,EAAE,WAAW,EAAE,GAAG,eAAe,CAAC,KAAK,EAAE,OAAO,CAAC,CAAC;IACrE,IAAI,WAAW,KAAK,IAAI,EAAE,CAAC;QACzB,MAAM,IAAI,iCAAqB,CAAC,WAAW,CAAC,CAAC;IAC/C,CAAC;IACD,OAAO,IAAA,iCAAiB,EAAC,WAAW,CAAC,CAAC;AACxC,CAAC;AAED;;;;GAIG;AACH,SAAgB,iBAAiB,CAAC,KAAiB,EAAE,OAA6B;IAChF,OAAO,eAAe,CAAC,KAAK,EAAE,OAAO,CAAC,CAAC,WAAW,CAAC;AACrD,CAAC"}

package/dist/{serializer → cjs/serializer}/view-writer.d.ts

@@ -6,6 +6,8 @@ import type { ElementMappingEntry } from '../mapping/element-mapping.js';
 import type { ResolvedRelationshipMapping } from './relationship-writer.js';
 export interface ViewBuildResult {
     viewGraphicsXml: XmlElement[];
+    /** `<ArchiMate:ViewEdge>` elements for this view's purely-visual connections — see the connection loop below. */
+    viewEdgesXml: XmlElement[];
     refObjectsXml: XmlElement[];
     /** Ids of diagram objects that passed validation and should be drawn (element-backed nodes only). */
     validElementNodeObjectIds: Set<string>;
@@ -13,6 +15,10 @@ export interface ViewBuildResult {
     validGroupObjectIds: Set<string>;
     /** Ids of notes that passed validation and should be drawn. */
     validNoteIds: Set<string>;
+    /** Ids of DiagramModelReference objects that passed validation and should be drawn. */
+    validViewReferenceObjectIds: Set<string>;
+    /** Archi connection id -> its ArchiMate:ViewEdge's own semantic XMA id, for graphical-writer's mm_semanticObject. */
+    viewEdgeSemanticIds: Map<string, number>;
 }
 /**
  * Builds one `AllView`'s `ViewGraphics` (Notes/Groups) and `RefObjects`

package/dist/cjs/serializer/view-writer.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"view-writer.d.ts","sourceRoot":"","sources":["../../../src/serializer/view-writer.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,UAAU,EAAE,SAAS,EAAE,MAAM,0BAA0B,CAAC;AACtE,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,iCAAiC,CAAC;AAElE,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,mCAAmC,CAAC;AACvE,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,+BAA+B,CAAC;AACzE,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,+BAA+B,CAAC;AACzE,OAAO,KAAK,EAAE,2BAA2B,EAAE,MAAM,0BAA0B,CAAC;AAI5E,MAAM,WAAW,eAAe;IAC9B,eAAe,EAAE,UAAU,EAAE,CAAC;IAC9B,iHAAiH;IACjH,YAAY,EAAE,UAAU,EAAE,CAAC;IAC3B,aAAa,EAAE,UAAU,EAAE,CAAC;IAC5B,qGAAqG;IACrG,yBAAyB,EAAE,GAAG,CAAC,MAAM,CAAC,CAAC;IACvC,+EAA+E;IAC/E,mBAAmB,EAAE,GAAG,CAAC,MAAM,CAAC,CAAC;IACjC,+DAA+D;IAC/D,YAAY,EAAE,GAAG,CAAC,MAAM,CAAC,CAAC;IAC1B,uFAAuF;IACvF,2BAA2B,EAAE,GAAG,CAAC,MAAM,CAAC,CAAC;IACzC,qHAAqH;IACrH,mBAAmB,EAAE,GAAG,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;CAC1C;AAED;;;;;;;;GAQG;AACH,wBAAgB,SAAS,CACvB,KAAK,EAAE,UAAU,EACjB,IAAI,EAAE,SAAS,EACf,GAAG,EAAE,aAAa,EAClB,MAAM,EAAE,aAAa,EACrB,cAAc,EAAE,WAAW,CAAC,MAAM,EAAE,mBAAmB,CAAC,EACxD,mBAAmB,EAAE,WAAW,CAAC,MAAM,EAAE,2BAA2B,CAAC,EACrE,WAAW,EAAE,mBAAmB,EAChC,QAAQ,EAAE,MAAM,GACf,eAAe,CAiPjB"}