wabachi 0.1.0

package/dist/architecture/canon/constraints.js

@@ -0,0 +1,116 @@
+import { createObjectId } from "./identity.js";
+/** The deliberately small set of declarative architecture constraints. */
+export const CONSTRAINT_KINDS = [
+    "may-depend-on",
+    "must-not-depend-on",
+    "may-call",
+    "must-go-through",
+    "single-authority",
+];
+function assertRecord(input, label) {
+    if (input === null || typeof input !== "object" || Array.isArray(input)) {
+        throw new TypeError(`${label} must be an object`);
+    }
+}
+function readObjectId(record, field, label) {
+    const value = record[field];
+    if (typeof value !== "string") {
+        throw new TypeError(`${label} ${field} must be a string`);
+    }
+    return createObjectId(value);
+}
+function isConstraintKind(value) {
+    return typeof value === "string" && CONSTRAINT_KINDS.includes(value);
+}
+function compareIds(left, right) {
+    if (left < right)
+        return -1;
+    if (left > right)
+        return 1;
+    return 0;
+}
+function compareConstraints(left, right) {
+    const kindOrder = compareIds(left.kind, right.kind);
+    if (kindOrder !== 0)
+        return kindOrder;
+    switch (left.kind) {
+        case "single-authority":
+            return compareIds(left.concern, right.concern);
+        case "must-go-through": {
+            const rightConstraint = right;
+            return (compareIds(left.source, rightConstraint.source) ||
+                compareIds(left.target, rightConstraint.target) ||
+                compareIds(left.through, rightConstraint.through));
+        }
+        default: {
+            const rightConstraint = right;
+            return compareIds(left.source, rightConstraint.source) || compareIds(left.target, rightConstraint.target);
+        }
+    }
+}
+function constraintKey(constraint) {
+    switch (constraint.kind) {
+        case "single-authority":
+            return `${constraint.kind}\u0000${constraint.concern}`;
+        case "must-go-through":
+            return `${constraint.kind}\u0000${constraint.source}\u0000${constraint.target}\u0000${constraint.through}`;
+        default:
+            return `${constraint.kind}\u0000${constraint.source}\u0000${constraint.target}`;
+    }
+}
+/** Create one typed, stable-ID constraint declaration without evaluating it. */
+export function createConstraint(input) {
+    assertRecord(input, "constraint");
+    if (!isConstraintKind(input.kind)) {
+        throw new TypeError(`constraint kind is unsupported: ${String(input.kind)}`);
+    }
+    switch (input.kind) {
+        case "may-depend-on":
+            return Object.freeze({
+                kind: input.kind,
+                source: readObjectId(input, "source", "may-depend-on constraint"),
+                target: readObjectId(input, "target", "may-depend-on constraint"),
+            });
+        case "must-not-depend-on":
+            return Object.freeze({
+                kind: input.kind,
+                source: readObjectId(input, "source", "must-not-depend-on constraint"),
+                target: readObjectId(input, "target", "must-not-depend-on constraint"),
+            });
+        case "may-call":
+            return Object.freeze({
+                kind: input.kind,
+                source: readObjectId(input, "source", "may-call constraint"),
+                target: readObjectId(input, "target", "may-call constraint"),
+            });
+        case "must-go-through":
+            return Object.freeze({
+                kind: input.kind,
+                source: readObjectId(input, "source", "must-go-through constraint"),
+                target: readObjectId(input, "target", "must-go-through constraint"),
+                through: readObjectId(input, "through", "must-go-through constraint"),
+            });
+        case "single-authority":
+            return Object.freeze({
+                kind: input.kind,
+                concern: readObjectId(input, "concern", "single-authority constraint"),
+            });
+    }
+}
+/** Normalize declarative constraints into a frozen, deterministic set. */
+export function createConstraints(inputs) {
+    if (!Array.isArray(inputs)) {
+        throw new TypeError("constraints must be an array");
+    }
+    const constraints = inputs.map(createConstraint).sort(compareConstraints);
+    const seen = new Set();
+    for (const constraint of constraints) {
+        const key = constraintKey(constraint);
+        if (seen.has(key)) {
+            throw new Error(`duplicate constraint: ${key.replaceAll("\u0000", " -> ")}`);
+        }
+        seen.add(key);
+    }
+    return Object.freeze(constraints);
+}
+//# sourceMappingURL=constraints.js.map

package/dist/architecture/canon/constraints.js.map

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

package/dist/architecture/canon/decisions.d.ts

@@ -0,0 +1,62 @@
+declare const DECISION_STATUSES: readonly ["proposed", "accepted", "rejected", "superseded"];
+declare const DECISION_TYPES: readonly ["architecture", "constraint", "policy"];
+export type DecisionStatus = (typeof DECISION_STATUSES)[number];
+export type DecisionType = (typeof DECISION_TYPES)[number];
+export interface ArchitectureReferenceInput {
+    readonly id: string;
+    readonly label: string;
+    readonly uri: string;
+    readonly description?: string;
+}
+export interface ArchitectureReference {
+    readonly id: string;
+    readonly label: string;
+    readonly uri: string;
+    readonly description?: string;
+}
+export interface ArchitectureDecisionInput {
+    readonly id: string;
+    readonly title: string;
+    readonly status: DecisionStatus;
+    readonly type: DecisionType;
+    readonly rationale: string;
+    readonly targetIds?: readonly string[];
+    readonly referenceIds?: readonly string[];
+    readonly supersedes?: readonly string[];
+}
+export interface ArchitectureDecision {
+    readonly id: string;
+    readonly title: string;
+    readonly status: DecisionStatus;
+    readonly type: DecisionType;
+    readonly rationale: string;
+    /** Canon IDs are intentionally opaque until complete-document validation. */
+    readonly targetIds: readonly string[];
+    readonly referenceIds: readonly string[];
+    readonly supersedes: readonly string[];
+}
+export interface ArchitectureReferenceAttachmentInput {
+    /** The target may be a canonical object or a document ID. Its existence is not checked here. */
+    readonly targetId: string;
+    readonly referenceIds: readonly string[];
+}
+export interface ArchitectureReferenceAttachment {
+    readonly targetId: string;
+    readonly referenceIds: readonly string[];
+}
+export interface ArchitectureDecisionsInput {
+    readonly decisions?: readonly ArchitectureDecisionInput[];
+    readonly references?: readonly ArchitectureReferenceInput[];
+    readonly referenceAttachments?: readonly ArchitectureReferenceAttachmentInput[];
+}
+export interface ArchitectureDecisions {
+    readonly decisions: readonly ArchitectureDecision[];
+    readonly references: readonly ArchitectureReference[];
+    readonly referenceAttachments: readonly ArchitectureReferenceAttachment[];
+}
+/**
+ * Creates deterministic governance metadata for architecture decisions.
+ * Target IDs are normalized but deliberately not resolved against a canon document.
+ */
+export declare function createArchitectureDecisions(input?: ArchitectureDecisionsInput): ArchitectureDecisions;
+export {};

package/dist/architecture/canon/decisions.js

@@ -0,0 +1,192 @@
+import { normalizeIdentityId } from "./identity.js";
+const DECISION_STATUSES = ["proposed", "accepted", "rejected", "superseded"];
+const DECISION_TYPES = ["architecture", "constraint", "policy"];
+function normalizeText(value, label, allowEmpty = false) {
+    if (typeof value !== "string") {
+        throw new TypeError(`${label} must be a string`);
+    }
+    const normalized = value.normalize("NFC");
+    if ((!allowEmpty && normalized.trim().length === 0) || /[\p{Cc}\p{Cf}\p{Cs}]/u.test(normalized)) {
+        throw new TypeError(`${label} is malformed`);
+    }
+    return normalized;
+}
+function normalizeCanonId(value, label) {
+    if (typeof value !== "string") {
+        throw new TypeError(`${label} must be a string`);
+    }
+    try {
+        return normalizeIdentityId(value);
+    }
+    catch {
+        throw new TypeError(`${label} is malformed`);
+    }
+}
+function compareCanonical(left, right) {
+    if (left < right)
+        return -1;
+    if (left > right)
+        return 1;
+    return 0;
+}
+function sortStrings(values) {
+    return [...values].sort(compareCanonical);
+}
+function uniqueSortedIds(values, label) {
+    const normalized = values.map((value) => normalizeCanonId(value, label));
+    const result = sortStrings(normalized);
+    for (let index = 1; index < result.length; index += 1) {
+        if (result[index] === result[index - 1]) {
+            throw new Error(`duplicate ${label}: ${result[index]}`);
+        }
+    }
+    return Object.freeze(result);
+}
+function assertRecord(value, label) {
+    if (value === null || typeof value !== "object" || Array.isArray(value)) {
+        throw new TypeError(`${label} must be an object`);
+    }
+}
+function assertStringArray(value, label) {
+    if (!Array.isArray(value)) {
+        throw new TypeError(`${label} must be an array`);
+    }
+}
+function normalizeStatus(value) {
+    if (typeof value !== "string" || !DECISION_STATUSES.includes(value)) {
+        throw new TypeError(`decision status must be one of: ${DECISION_STATUSES.join(", ")}`);
+    }
+    return value;
+}
+function normalizeType(value) {
+    if (typeof value !== "string" || !DECISION_TYPES.includes(value)) {
+        throw new TypeError(`decision type must be one of: ${DECISION_TYPES.join(", ")}`);
+    }
+    return value;
+}
+function normalizeReference(input) {
+    assertRecord(input, "reference");
+    const description = input.description === undefined ? undefined : normalizeText(input.description, "reference description", true);
+    return Object.freeze({
+        id: normalizeCanonId(input.id, "reference id"),
+        label: normalizeText(input.label, "reference label"),
+        uri: normalizeText(input.uri, "reference uri"),
+        ...(description === undefined ? {} : { description }),
+    });
+}
+function normalizeDecision(input) {
+    assertRecord(input, "decision");
+    const targets = input.targetIds === undefined ? [] : input.targetIds;
+    const references = input.referenceIds === undefined ? [] : input.referenceIds;
+    const supersedes = input.supersedes === undefined ? [] : input.supersedes;
+    assertStringArray(targets, "decision targetIds");
+    assertStringArray(references, "decision referenceIds");
+    assertStringArray(supersedes, "decision supersedes");
+    return Object.freeze({
+        id: normalizeCanonId(input.id, "decision id"),
+        title: normalizeText(input.title, "decision title"),
+        status: normalizeStatus(input.status),
+        type: normalizeType(input.type),
+        rationale: normalizeText(input.rationale, "decision rationale"),
+        targetIds: uniqueSortedIds(targets, "decision target id"),
+        referenceIds: uniqueSortedIds(references, "decision reference id"),
+        supersedes: uniqueSortedIds(supersedes, "superseded decision id"),
+    });
+}
+function normalizeAttachment(input) {
+    assertRecord(input, "reference attachment");
+    const references = input.referenceIds;
+    assertStringArray(references, "reference attachment referenceIds");
+    return Object.freeze({
+        targetId: normalizeCanonId(input.targetId, "reference attachment target id"),
+        referenceIds: uniqueSortedIds(references, "reference attachment reference id"),
+    });
+}
+function assertUniqueIds(records, label) {
+    const seen = new Set();
+    for (const record of records) {
+        if (seen.has(record.id)) {
+            throw new Error(`duplicate ${label}: ${record.id}`);
+        }
+        seen.add(record.id);
+    }
+}
+function assertKnownReferences(decisions, references, attachments) {
+    const referenceIds = new Set(references.map((reference) => reference.id));
+    for (const decision of decisions) {
+        for (const referenceId of decision.referenceIds) {
+            if (!referenceIds.has(referenceId)) {
+                throw new Error(`decision ${decision.id} references unknown reference: ${referenceId}`);
+            }
+        }
+    }
+    for (const attachment of attachments) {
+        for (const referenceId of attachment.referenceIds) {
+            if (!referenceIds.has(referenceId)) {
+                throw new Error(`reference attachment for ${attachment.targetId} references unknown reference: ${referenceId}`);
+            }
+        }
+    }
+}
+function assertAcyclicSupersession(decisions) {
+    const decisionIds = new Set(decisions.map((decision) => decision.id));
+    const graph = new Map(decisions.map((decision) => [decision.id, decision.supersedes]));
+    for (const decision of decisions) {
+        for (const supersededId of decision.supersedes) {
+            if (!decisionIds.has(supersededId)) {
+                throw new Error(`decision ${decision.id} supersedes unknown decision: ${supersededId}`);
+            }
+        }
+    }
+    const visiting = new Set();
+    const visited = new Set();
+    const visit = (decisionId) => {
+        if (visiting.has(decisionId)) {
+            throw new Error(`decision supersession cycle includes: ${decisionId}`);
+        }
+        if (visited.has(decisionId))
+            return;
+        visiting.add(decisionId);
+        for (const supersededId of graph.get(decisionId) ?? [])
+            visit(supersededId);
+        visiting.delete(decisionId);
+        visited.add(decisionId);
+    };
+    for (const decision of decisions)
+        visit(decision.id);
+}
+/**
+ * Creates deterministic governance metadata for architecture decisions.
+ * Target IDs are normalized but deliberately not resolved against a canon document.
+ */
+export function createArchitectureDecisions(input = {}) {
+    assertRecord(input, "architecture decisions");
+    const rawDecisions = input.decisions === undefined ? [] : input.decisions;
+    const rawReferences = input.references === undefined ? [] : input.references;
+    const rawAttachments = input.referenceAttachments === undefined ? [] : input.referenceAttachments;
+    assertStringArray(rawDecisions, "decisions");
+    assertStringArray(rawReferences, "references");
+    assertStringArray(rawAttachments, "referenceAttachments");
+    const decisions = [...rawDecisions].map(normalizeDecision).sort((left, right) => compareCanonical(left.id, right.id));
+    const references = [...rawReferences]
+        .map(normalizeReference)
+        .sort((left, right) => compareCanonical(left.id, right.id));
+    const referenceAttachments = [...rawAttachments]
+        .map(normalizeAttachment)
+        .sort((left, right) => compareCanonical(left.targetId, right.targetId));
+    assertUniqueIds(decisions, "decision id");
+    assertUniqueIds(references, "reference id");
+    for (let index = 1; index < referenceAttachments.length; index += 1) {
+        if (referenceAttachments[index].targetId === referenceAttachments[index - 1].targetId) {
+            throw new Error(`duplicate reference attachment target id: ${referenceAttachments[index].targetId}`);
+        }
+    }
+    assertKnownReferences(decisions, references, referenceAttachments);
+    assertAcyclicSupersession(decisions);
+    return Object.freeze({
+        decisions: Object.freeze(decisions),
+        references: Object.freeze(references),
+        referenceAttachments: Object.freeze(referenceAttachments),
+    });
+}
+//# sourceMappingURL=decisions.js.map

package/dist/architecture/canon/decisions.js.map

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

package/dist/architecture/canon/deployment.d.ts

@@ -0,0 +1,89 @@
+import { type ObjectId } from "./identity.js";
+declare const runtimeEnvironmentIdBrand: unique symbol;
+declare const deploymentNodeIdBrand: unique symbol;
+declare const deploymentInstanceIdBrand: unique symbol;
+declare const infrastructureReferenceIdBrand: unique symbol;
+/** An identity in the deployment namespace, not an architecture object identity. */
+export type RuntimeEnvironmentId = string & {
+    readonly [runtimeEnvironmentIdBrand]: never;
+};
+export type DeploymentNodeId = string & {
+    readonly [deploymentNodeIdBrand]: never;
+};
+export type DeploymentInstanceId = string & {
+    readonly [deploymentInstanceIdBrand]: never;
+};
+export type InfrastructureReferenceId = string & {
+    readonly [infrastructureReferenceIdBrand]: never;
+};
+export interface RuntimeEnvironmentInput {
+    readonly id: string;
+    readonly displayName?: string;
+}
+export interface RuntimeEnvironment {
+    readonly kind: "runtime-environment";
+    readonly id: RuntimeEnvironmentId;
+    readonly displayName?: string;
+}
+export interface DeploymentNodeInput {
+    readonly id: string;
+    readonly environmentId: string;
+    readonly displayName?: string;
+}
+export interface DeploymentNode {
+    readonly kind: "deployment-node";
+    readonly id: DeploymentNodeId;
+    readonly environmentId: RuntimeEnvironmentId;
+    readonly displayName?: string;
+}
+export interface DeploymentInstanceInput {
+    readonly id: string;
+    readonly nodeId: string;
+    readonly displayName?: string;
+}
+export interface DeploymentInstance {
+    readonly kind: "deployment-instance";
+    readonly id: DeploymentInstanceId;
+    readonly nodeId: DeploymentNodeId;
+    readonly displayName?: string;
+}
+export interface InfrastructureReferenceInput {
+    readonly id: string;
+    readonly reference: string;
+}
+export interface InfrastructureReference {
+    readonly kind: "infrastructure-reference";
+    readonly id: InfrastructureReferenceId;
+    /** An opaque declaration; resolving or provisioning it is out of scope. */
+    readonly reference: string;
+}
+export interface DeploymentMappingInput {
+    readonly softwareElementId: string;
+    readonly deploymentInstanceId: string;
+}
+export interface DeploymentMapping {
+    readonly kind: "deployment-mapping";
+    readonly softwareElementId: ObjectId;
+    readonly deploymentInstanceId: DeploymentInstanceId;
+}
+export interface DeploymentTopologyInput {
+    readonly runtimeEnvironments?: readonly RuntimeEnvironmentInput[];
+    readonly deploymentNodes?: readonly DeploymentNodeInput[];
+    readonly deploymentInstances?: readonly DeploymentInstanceInput[];
+    readonly infrastructureReferences?: readonly InfrastructureReferenceInput[];
+    readonly mappings?: readonly DeploymentMappingInput[];
+}
+export interface DeploymentTopology {
+    readonly runtimeEnvironments: readonly RuntimeEnvironment[];
+    readonly deploymentNodes: readonly DeploymentNode[];
+    readonly deploymentInstances: readonly DeploymentInstance[];
+    readonly infrastructureReferences: readonly InfrastructureReference[];
+    readonly mappings: readonly DeploymentMapping[];
+}
+export declare function createRuntimeEnvironment(input: RuntimeEnvironmentInput): RuntimeEnvironment;
+export declare function createDeploymentNode(input: DeploymentNodeInput): DeploymentNode;
+export declare function createDeploymentInstance(input: DeploymentInstanceInput): DeploymentInstance;
+export declare function createInfrastructureReference(input: InfrastructureReferenceInput): InfrastructureReference;
+export declare function createDeploymentMapping(input: DeploymentMappingInput): DeploymentMapping;
+export declare function createDeploymentTopology(input: DeploymentTopologyInput): DeploymentTopology;
+export {};

package/dist/architecture/canon/deployment.js

@@ -0,0 +1,156 @@
+import { createObjectId, normalizeIdentityId } from "./identity.js";
+function assertRecord(input, label) {
+    if (input === null || typeof input !== "object" || Array.isArray(input)) {
+        throw new TypeError(`${label} must be an object`);
+    }
+}
+function normalizeDeploymentId(value, label) {
+    if (typeof value !== "string") {
+        throw new TypeError(`${label} must be a string`);
+    }
+    const normalized = normalizeIdentityId(value);
+    return normalized;
+}
+function normalizeDisplayName(value, label) {
+    if (value === undefined)
+        return undefined;
+    if (typeof value !== "string") {
+        throw new TypeError(`${label} must be a string`);
+    }
+    return value.normalize("NFC");
+}
+function readDisplayName(input, label) {
+    return normalizeDisplayName(input.displayName, `${label} displayName`);
+}
+function asRuntimeEnvironmentId(value) {
+    return normalizeDeploymentId(value, "runtime environment id");
+}
+function asDeploymentNodeId(value) {
+    return normalizeDeploymentId(value, "deployment node id");
+}
+function asDeploymentInstanceId(value) {
+    return normalizeDeploymentId(value, "deployment instance id");
+}
+function asInfrastructureReferenceId(value) {
+    return normalizeDeploymentId(value, "infrastructure reference id");
+}
+function compareOrdinal(left, right) {
+    if (left < right)
+        return -1;
+    if (left > right)
+        return 1;
+    return 0;
+}
+function sortById(records) {
+    return [...records].sort((left, right) => compareOrdinal(left.id, right.id));
+}
+function rejectDuplicateIds(records, label) {
+    const seen = new Set();
+    for (const record of records) {
+        if (seen.has(record.id)) {
+            throw new Error(`duplicate ${label} id: ${record.id}`);
+        }
+        seen.add(record.id);
+    }
+}
+function freezeArray(records) {
+    return Object.freeze([...records]);
+}
+export function createRuntimeEnvironment(input) {
+    assertRecord(input, "runtime environment");
+    const candidate = input;
+    const displayName = readDisplayName(input, "runtime environment");
+    const record = {
+        kind: "runtime-environment",
+        id: asRuntimeEnvironmentId(candidate.id),
+        ...(displayName === undefined ? {} : { displayName }),
+    };
+    return Object.freeze(record);
+}
+export function createDeploymentNode(input) {
+    assertRecord(input, "deployment node");
+    const candidate = input;
+    const displayName = readDisplayName(input, "deployment node");
+    const record = {
+        kind: "deployment-node",
+        id: asDeploymentNodeId(candidate.id),
+        environmentId: asRuntimeEnvironmentId(candidate.environmentId),
+        ...(displayName === undefined ? {} : { displayName }),
+    };
+    return Object.freeze(record);
+}
+export function createDeploymentInstance(input) {
+    assertRecord(input, "deployment instance");
+    const candidate = input;
+    const displayName = readDisplayName(input, "deployment instance");
+    const record = {
+        kind: "deployment-instance",
+        id: asDeploymentInstanceId(candidate.id),
+        nodeId: asDeploymentNodeId(candidate.nodeId),
+        ...(displayName === undefined ? {} : { displayName }),
+    };
+    return Object.freeze(record);
+}
+export function createInfrastructureReference(input) {
+    assertRecord(input, "infrastructure reference");
+    const candidate = input;
+    const reference = normalizeDeploymentId(candidate.reference, "infrastructure reference");
+    const record = {
+        kind: "infrastructure-reference",
+        id: asInfrastructureReferenceId(candidate.id),
+        reference,
+    };
+    return Object.freeze(record);
+}
+export function createDeploymentMapping(input) {
+    assertRecord(input, "deployment mapping");
+    const candidate = input;
+    const record = {
+        kind: "deployment-mapping",
+        softwareElementId: createObjectId(normalizeDeploymentId(candidate.softwareElementId, "software element id")),
+        deploymentInstanceId: asDeploymentInstanceId(candidate.deploymentInstanceId),
+    };
+    return Object.freeze(record);
+}
+function readRecords(value, label, create) {
+    if (value === undefined)
+        return [];
+    if (!Array.isArray(value)) {
+        throw new TypeError(`${label} must be an array`);
+    }
+    return value.map((record) => create(record));
+}
+export function createDeploymentTopology(input) {
+    assertRecord(input, "deployment topology");
+    const candidate = input;
+    const runtimeEnvironments = readRecords(candidate.runtimeEnvironments, "runtime environments", createRuntimeEnvironment);
+    const deploymentNodes = readRecords(candidate.deploymentNodes, "deployment nodes", createDeploymentNode);
+    const deploymentInstances = readRecords(candidate.deploymentInstances, "deployment instances", createDeploymentInstance);
+    const infrastructureReferences = readRecords(candidate.infrastructureReferences, "infrastructure references", createInfrastructureReference);
+    const mappings = readRecords(candidate.mappings, "deployment mappings", createDeploymentMapping);
+    rejectDuplicateIds(runtimeEnvironments, "runtime environment");
+    rejectDuplicateIds(deploymentNodes, "deployment node");
+    rejectDuplicateIds(deploymentInstances, "deployment instance");
+    rejectDuplicateIds(infrastructureReferences, "infrastructure reference");
+    const mappingKeys = new Set();
+    for (const mapping of mappings) {
+        const key = `${mapping.softwareElementId}\u0000${mapping.deploymentInstanceId}`;
+        if (mappingKeys.has(key)) {
+            throw new Error(`duplicate deployment mapping: ${mapping.softwareElementId} -> ${mapping.deploymentInstanceId}`);
+        }
+        mappingKeys.add(key);
+    }
+    return Object.freeze({
+        runtimeEnvironments: freezeArray(sortById(runtimeEnvironments)),
+        deploymentNodes: freezeArray(sortById(deploymentNodes)),
+        deploymentInstances: freezeArray(sortById(deploymentInstances)),
+        infrastructureReferences: freezeArray(sortById(infrastructureReferences)),
+        mappings: freezeArray([...mappings].sort((left, right) => {
+            const softwareOrder = compareOrdinal(left.softwareElementId, right.softwareElementId);
+            if (softwareOrder !== 0)
+                return softwareOrder;
+            return compareOrdinal(left.deploymentInstanceId, right.deploymentInstanceId);
+        })),
+    });
+}
+//# sourceMappingURL=deployment.js.map

package/dist/architecture/canon/deployment.js.map

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