@agilewallaby/c4-model 0.0.1

package/README.md

@@ -0,0 +1,11 @@
+# c4-model
+
+This library was generated with [Nx](https://nx.dev).
+
+## Building
+
+Run `nx build c4-model` to build the library.
+
+## Running unit tests
+
+Run `nx test c4-model` to execute the unit tests via [Jest](https://jestjs.io).

package/package.json

@@ -0,0 +1,13 @@
+{
+  "name": "@agilewallaby/c4-model",
+  "version": "0.0.1",
+  "publishConfig": {
+    "access": "public"
+  },
+  "dependencies": {
+    "tslib": "^2.3.0"
+  },
+  "type": "commonjs",
+  "main": "./src/index.js",
+  "typings": "./src/index.d.ts"
+}

package/src/index.d.ts

@@ -0,0 +1 @@
+export * from './lib/model';

package/src/index.js

@@ -0,0 +1,5 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+const tslib_1 = require("tslib");
+tslib_1.__exportStar(require("./lib/model"), exports);
+//# sourceMappingURL=index.js.map

package/src/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../../libs/c4-model/src/index.ts"],"names":[],"mappings":";;;AAAA,sDAA4B"}

package/src/lib/component.d.ts

@@ -0,0 +1,12 @@
+import { Element, Reference, Relationship, RelationshipTarget, TechnologyDefinition } from "./core";
+export interface ComponentDefinition extends TechnologyDefinition {
+}
+export declare class Component extends Element {
+    readonly name: string;
+    private _relationships;
+    constructor(name: string, definition?: ComponentDefinition);
+    uses(otherElement: RelationshipTarget, definition?: TechnologyDefinition): void;
+    get relationships(): ReadonlyArray<Relationship>;
+}
+export declare class ReferencedComponent extends Reference<undefined> {
+}

package/src/lib/component.js

@@ -0,0 +1,23 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.ReferencedComponent = exports.Component = void 0;
+const core_1 = require("./core");
+class Component extends core_1.Element {
+    constructor(name, definition) {
+        super(name, ["Component"], definition);
+        this.name = name;
+        this._relationships = [];
+    }
+    uses(otherElement, definition) {
+        const relationship = new core_1.Relationship(this, otherElement, definition);
+        this._relationships.push(relationship);
+    }
+    get relationships() {
+        return this._relationships;
+    }
+}
+exports.Component = Component;
+class ReferencedComponent extends core_1.Reference {
+}
+exports.ReferencedComponent = ReferencedComponent;
+//# sourceMappingURL=component.js.map

package/src/lib/component.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"component.js","sourceRoot":"","sources":["../../../../../libs/c4-model/src/lib/component.ts"],"names":[],"mappings":";;;AAAA,iCAAmG;AAKnG,MAAa,SAAU,SAAQ,cAAO;IAIpC,YAAqC,IAAY,EAAE,UAAgC;QACjF,KAAK,CAAC,IAAI,EAAE,CAAC,WAAW,CAAC,EAAE,UAAU,CAAC,CAAA;QADH,SAAI,GAAJ,IAAI,CAAQ;QAFzC,mBAAc,GAAmB,EAAE,CAAA;IAI3C,CAAC;IAEM,IAAI,CAAC,YAAgC,EAAE,UAAiC;QAC7E,MAAM,YAAY,GAAG,IAAI,mBAAY,CAAC,IAAI,EAAE,YAAY,EAAE,UAAU,CAAC,CAAA;QACrE,IAAI,CAAC,cAAc,CAAC,IAAI,CAAC,YAAY,CAAC,CAAA;IACxC,CAAC;IAED,IAAW,aAAa;QACtB,OAAO,IAAI,CAAC,cAAc,CAAA;IAC5B,CAAC;CACF;AAhBD,8BAgBC;AAED,MAAa,mBAAoB,SAAQ,gBAAoB;CAC5D;AADD,kDACC"}

package/src/lib/container.d.ts

@@ -0,0 +1,16 @@
+import { Element, Reference, Relationship, RelationshipTarget, TechnologyDefinition } from "./core";
+import { Component, ComponentDefinition, ReferencedComponent } from "./component";
+export interface ContainerDefinition extends TechnologyDefinition {
+}
+export declare class Container extends Element {
+    readonly name: string;
+    private _relationships;
+    private _components;
+    constructor(name: string, definition?: ContainerDefinition);
+    uses(otherElement: RelationshipTarget, definition?: TechnologyDefinition): void;
+    get relationships(): ReadonlyArray<Relationship>;
+    defineComponent(name: string, definition?: ComponentDefinition): Component;
+}
+export declare class ReferencedContainer extends Reference<Component> {
+    referenceComponent(name: string): ReferencedComponent;
+}

package/src/lib/container.js

@@ -0,0 +1,37 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.ReferencedContainer = exports.Container = void 0;
+const core_1 = require("./core");
+const component_1 = require("./component");
+class Container extends core_1.Element {
+    constructor(name, definition) {
+        super(name, ["Container"], definition);
+        this.name = name;
+        this._relationships = [];
+        this._components = new Map();
+    }
+    uses(otherElement, definition) {
+        const relationship = new core_1.Relationship(this, otherElement, definition);
+        this._relationships.push(relationship);
+    }
+    get relationships() {
+        return this._relationships;
+    }
+    defineComponent(name, definition) {
+        if (this._components.has(name)) {
+            throw Error(`A Component named '${name}' is defined elsewhere in this Container. A Component can be defined only once, but can be referenced multiple times.`);
+        }
+        const component = new component_1.Component(name, definition);
+        this._components.set(name, component);
+        return component;
+    }
+}
+exports.Container = Container;
+class ReferencedContainer extends core_1.Reference {
+    referenceComponent(name) {
+        const componentReference = this.referenceChild(name, (name) => new component_1.ReferencedComponent(name));
+        return componentReference;
+    }
+}
+exports.ReferencedContainer = ReferencedContainer;
+//# sourceMappingURL=container.js.map

package/src/lib/container.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"container.js","sourceRoot":"","sources":["../../../../../libs/c4-model/src/lib/container.ts"],"names":[],"mappings":";;;AAAA,iCAAmG;AACnG,2CAAiF;AAKjF,MAAa,SAAU,SAAQ,cAAO;IAKpC,YAAqC,IAAY,EAAE,UAAgC;QACjF,KAAK,CAAC,IAAI,EAAE,CAAC,WAAW,CAAC,EAAE,UAAU,CAAC,CAAA;QADH,SAAI,GAAJ,IAAI,CAAQ;QAHzC,mBAAc,GAAmB,EAAE,CAAA;QACnC,gBAAW,GAAG,IAAI,GAAG,EAAqB,CAAC;IAInD,CAAC;IAEM,IAAI,CAAC,YAAgC,EAAE,UAAiC;QAC7E,MAAM,YAAY,GAAG,IAAI,mBAAY,CAAC,IAAI,EAAE,YAAY,EAAE,UAAU,CAAC,CAAA;QACrE,IAAI,CAAC,cAAc,CAAC,IAAI,CAAC,YAAY,CAAC,CAAA;IACxC,CAAC;IAED,IAAW,aAAa;QACtB,OAAO,IAAI,CAAC,cAAc,CAAA;IAC5B,CAAC;IAEM,eAAe,CAAC,IAAY,EAAE,UAAgC;QACnE,IAAI,IAAI,CAAC,WAAW,CAAC,GAAG,CAAC,IAAI,CAAC,EAAE;YAC9B,MAAM,KAAK,CAAC,sBAAsB,IAAI,uHAAuH,CAAC,CAAA;SAC/J;QAED,MAAM,SAAS,GAAG,IAAI,qBAAS,CAAC,IAAI,EAAE,UAAU,CAAC,CAAA;QAEjD,IAAI,CAAC,WAAW,CAAC,GAAG,CAAC,IAAI,EAAE,SAAS,CAAC,CAAC;QAEtC,OAAO,SAAS,CAAA;IAClB,CAAC;CACF;AA7BD,8BA6BC;AAED,MAAa,mBAAoB,SAAQ,gBAAoB;IACpD,kBAAkB,CAAC,IAAY;QACpC,MAAM,kBAAkB,GAAG,IAAI,CAAC,cAAc,CAAC,IAAI,EAAE,CAAC,IAAY,EAAE,EAAE,CAAC,IAAI,+BAAmB,CAAC,IAAI,CAAC,CAAC,CAAA;QACrG,OAAO,kBAAyC,CAAA;IAClD,CAAC;CACF;AALD,kDAKC"}

package/src/lib/core.d.ts

@@ -0,0 +1,38 @@
+import { Component, ReferencedComponent } from "./component";
+import { Container, ReferencedContainer } from "./container";
+import { ReferencedSoftwareSystem, SoftwareSystem } from "./softwareSystem";
+import { Person } from "./person";
+export interface Definition {
+    description?: string;
+    tags?: string[];
+}
+export interface TechnologyDefinition extends Definition {
+    technology?: string;
+}
+export declare abstract class Element {
+    readonly name: string;
+    readonly description?: string;
+    readonly tags: ReadonlyArray<string>;
+    constructor(name: string, defaultTags?: string[], definition?: Definition);
+}
+export declare abstract class TechnicalElement extends Element {
+    readonly technology?: string;
+    constructor(name: string, defaultTags?: string[], definition?: TechnologyDefinition);
+}
+export declare class Relationship {
+    readonly source: Element;
+    readonly destination: Element | Reference<SoftwareSystem | Container | Component>;
+    readonly description?: string;
+    readonly tags: ReadonlyArray<string>;
+    readonly technology?: string;
+    constructor(source: Element, destination: Element | Reference<SoftwareSystem | Container | Component>, definition?: TechnologyDefinition);
+}
+export declare class Reference<T> {
+    readonly name: string;
+    private readonly _references;
+    constructor(name: string);
+    protected referenceChild(name: string, createChild: (childName: string) => Reference<T>): Reference<T>;
+    get references(): ReadonlyArray<Reference<T>>;
+    getChildElements(path?: string): ReadonlyArray<string>;
+}
+export type RelationshipTarget = Person | SoftwareSystem | ReferencedSoftwareSystem | Container | ReferencedContainer | Component | ReferencedComponent;

package/src/lib/core.js

@@ -0,0 +1,56 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.Reference = exports.Relationship = exports.TechnicalElement = exports.Element = void 0;
+class Element {
+    constructor(name, defaultTags = [], definition) {
+        var _a;
+        this.name = name;
+        this.description = definition === null || definition === void 0 ? void 0 : definition.description;
+        this.tags = ((_a = definition === null || definition === void 0 ? void 0 : definition.tags) !== null && _a !== void 0 ? _a : []).concat(["Element"]).concat(defaultTags);
+    }
+}
+exports.Element = Element;
+class TechnicalElement extends Element {
+    constructor(name, defaultTags = [], definition) {
+        super(name, defaultTags, definition);
+        this.technology = definition === null || definition === void 0 ? void 0 : definition.technology;
+    }
+}
+exports.TechnicalElement = TechnicalElement;
+class Relationship {
+    constructor(source, destination, definition) {
+        var _a;
+        this.source = source;
+        this.destination = destination;
+        this.description = definition === null || definition === void 0 ? void 0 : definition.description;
+        this.technology = definition === null || definition === void 0 ? void 0 : definition.technology;
+        this.tags = ((_a = definition === null || definition === void 0 ? void 0 : definition.tags) !== null && _a !== void 0 ? _a : []).concat(["Relationship"]);
+    }
+}
+exports.Relationship = Relationship;
+class Reference {
+    constructor(name) {
+        this.name = name;
+        this._references = new Map();
+    }
+    referenceChild(name, createChild) {
+        let reference = this._references.get(name);
+        if (!reference) {
+            reference = createChild(name);
+            this._references.set(name, reference);
+        }
+        return reference;
+    }
+    get references() {
+        return Array.from(this._references.values());
+    }
+    getChildElements(path) {
+        const result = Array.from(this._references.values()).flatMap(reference => {
+            const currentPath = `${path ? path : '' + this.name}.${reference.name}`;
+            return [currentPath, ...reference.getChildElements(currentPath)];
+        });
+        return result;
+    }
+}
+exports.Reference = Reference;
+//# sourceMappingURL=core.js.map

package/src/lib/core.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"core.js","sourceRoot":"","sources":["../../../../../libs/c4-model/src/lib/core.ts"],"names":[],"mappings":";;;AAcA,MAAsB,OAAO;IAI3B,YAA4B,IAAY,EAAE,cAAwB,EAAE,EAAE,UAAuB;;QAAjE,SAAI,GAAJ,IAAI,CAAQ;QACtC,IAAI,CAAC,WAAW,GAAG,UAAU,aAAV,UAAU,uBAAV,UAAU,CAAE,WAAW,CAAA;QAC1C,IAAI,CAAC,IAAI,GAAG,CAAC,MAAA,UAAU,aAAV,UAAU,uBAAV,UAAU,CAAE,IAAI,mCAAI,EAAE,CAAC,CAAC,MAAM,CAAC,CAAC,SAAS,CAAC,CAAC,CAAC,MAAM,CAAC,WAAW,CAAC,CAAA;IAC9E,CAAC;CACF;AARD,0BAQC;AAED,MAAsB,gBAAiB,SAAQ,OAAO;IAGpD,YAAY,IAAY,EAAE,cAAwB,EAAE,EAAE,UAAiC;QACrF,KAAK,CAAC,IAAI,EAAE,WAAW,EAAE,UAAU,CAAC,CAAA;QACpC,IAAI,CAAC,UAAU,GAAG,UAAU,aAAV,UAAU,uBAAV,UAAU,CAAE,UAAU,CAAA;IAC1C,CAAC;CACF;AAPD,4CAOC;AAED,MAAa,YAAY;IAKvB,YAA4B,MAAe,EAAkB,WAAwE,EAAE,UAAiC;;QAA5I,WAAM,GAAN,MAAM,CAAS;QAAkB,gBAAW,GAAX,WAAW,CAA6D;QACnI,IAAI,CAAC,WAAW,GAAG,UAAU,aAAV,UAAU,uBAAV,UAAU,CAAE,WAAW,CAAA;QAC1C,IAAI,CAAC,UAAU,GAAG,UAAU,aAAV,UAAU,uBAAV,UAAU,CAAE,UAAU,CAAA;QACxC,IAAI,CAAC,IAAI,GAAG,CAAC,MAAA,UAAU,aAAV,UAAU,uBAAV,UAAU,CAAE,IAAI,mCAAI,EAAE,CAAC,CAAC,MAAM,CAAC,CAAC,cAAc,CAAC,CAAC,CAAA;IAC/D,CAAC;CACF;AAVD,oCAUC;AAED,MAAa,SAAS;IAGpB,YAA4B,IAAY;QAAZ,SAAI,GAAJ,IAAI,CAAQ;QAFvB,gBAAW,GAAG,IAAI,GAAG,EAAwB,CAAA;IAG9D,CAAC;IAES,cAAc,CAAC,IAAY,EAAE,WAAgD;QACrF,IAAI,SAAS,GAAG,IAAI,CAAC,WAAW,CAAC,GAAG,CAAC,IAAI,CAAC,CAAA;QAC1C,IAAI,CAAC,SAAS,EAAE;YACd,SAAS,GAAG,WAAW,CAAC,IAAI,CAAC,CAAA;YAC7B,IAAI,CAAC,WAAW,CAAC,GAAG,CAAC,IAAI,EAAE,SAAS,CAAC,CAAA;SACtC;QACD,OAAO,SAAS,CAAA;IAClB,CAAC;IAED,IAAW,UAAU;QACnB,OAAO,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,WAAW,CAAC,MAAM,EAAE,CAAC,CAAA;IAC9C,CAAC;IAEM,gBAAgB,CAAC,IAAa;QACnC,MAAM,MAAM,GAAG,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,WAAW,CAAC,MAAM,EAAE,CAAC,CAAC,OAAO,CAAC,SAAS,CAAC,EAAE;YACvE,MAAM,WAAW,GAAG,GAAG,IAAI,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,GAAG,IAAI,CAAC,IAAI,IAAI,SAAS,CAAC,IAAI,EAAE,CAAA;YACvE,OAAO,CAAC,WAAW,EAAE,GAAG,SAAS,CAAC,gBAAgB,CAAC,WAAW,CAAC,CAAC,CAAA;QAClE,CAAC,CAAC,CAAA;QACF,OAAO,MAAM,CAAA;IACf,CAAC;CACF;AA1BD,8BA0BC"}

package/src/lib/model.d.ts

@@ -0,0 +1,16 @@
+import { ReferencedSoftwareSystem, SoftwareSystem, SoftwareSystemDefinition } from './softwareSystem';
+import { Person, PersonDefinition, ReferencedPerson } from './person';
+export declare class Model {
+    name: string;
+    constructor(name: string);
+    private softwareSystems;
+    private referencedSoftwareSystems;
+    private people;
+    private referencedPeople;
+    defineSoftwareSystem(name: string, definition?: SoftwareSystemDefinition): SoftwareSystem;
+    referenceSoftwareSystem(name: string): ReferencedSoftwareSystem;
+    definePerson(name: string, definition?: PersonDefinition): Person;
+    referencePerson(name: string): ReferencedPerson;
+    validate(): void;
+}
+export declare function buildModel(modelName: string, globPath?: string): Promise<Model>;

package/src/lib/model.js

@@ -0,0 +1,90 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.buildModel = exports.Model = void 0;
+const tslib_1 = require("tslib");
+const glob_1 = require("glob");
+const path_1 = require("path");
+const softwareSystem_1 = require("./softwareSystem");
+const person_1 = require("./person");
+class Model {
+    constructor(name) {
+        this.name = name;
+        this.softwareSystems = new Map();
+        this.referencedSoftwareSystems = new Map();
+        this.people = new Map();
+        this.referencedPeople = new Map();
+    }
+    defineSoftwareSystem(name, definition) {
+        if (this.softwareSystems.has(name)) {
+            throw Error(`A SoftwareSystem named '${name}' is defined elsewhere in this Model. A SoftwareSystem can be defined only once, but can be referenced multiple times.`);
+        }
+        const system = new softwareSystem_1.SoftwareSystem(name, definition);
+        this.softwareSystems.set(name, system);
+        return system;
+    }
+    referenceSoftwareSystem(name) {
+        let system = this.referencedSoftwareSystems.get(name);
+        if (!system) {
+            system = new softwareSystem_1.ReferencedSoftwareSystem(name);
+            this.referencedSoftwareSystems.set(name, system);
+        }
+        return system;
+    }
+    definePerson(name, definition) {
+        if (this.people.has(name)) {
+            throw Error(`A Person named '${name}' is defined elsewhere in this Model. A Person can be defined only once, but can be referenced multiple times.`);
+        }
+        const person = new person_1.Person(name, definition);
+        this.people.set(name, person);
+        return person;
+    }
+    referencePerson(name) {
+        let person = this.referencedPeople.get(name);
+        if (!person) {
+            person = new person_1.ReferencedPerson(name);
+            this.referencedPeople.set(name, person);
+        }
+        return person;
+    }
+    validate() {
+        const undefinedSoftwareSystems = Array.from(this.referencedSoftwareSystems.keys()).filter(name => !this.softwareSystems.has(name));
+        if (undefinedSoftwareSystems.length > 0) {
+            throw Error(`SoftwareSystems named '${undefinedSoftwareSystems.join("', '")}' are referenced but not defined.`);
+        }
+        const undefinedPeople = Array.from(this.referencedPeople.keys()).filter(name => !this.people.has(name));
+        if (undefinedPeople.length > 0) {
+            throw Error(`People named '${undefinedPeople.join("', '")}' are referenced but not defined.`);
+        }
+        const definedElements = Array.from(this.softwareSystems.values()).flatMap(system => system.getChildElements());
+        const referencedElements = Array.from(this.referencedSoftwareSystems.values()).flatMap(system => system.getChildElements());
+        const undefinedElements = referencedElements.filter(name => !definedElements.includes(name));
+        if (undefinedElements.length > 0) {
+            throw Error(`Elements named '${undefinedElements.join("', '")}' are referenced but not defined.`);
+        }
+    }
+}
+exports.Model = Model;
+function buildModel(modelName, globPath = 'c4.dsl.ts') {
+    return tslib_1.__awaiter(this, void 0, void 0, function* () {
+        const model = new Model(modelName);
+        const result = yield (0, glob_1.glob)(`**/${globPath}`, { cwd: __dirname });
+        if (result.length === 0) {
+            throw new Error(`No ${globPath} files found`);
+        }
+        for (const file of result) {
+            const moduleFile = (0, path_1.join)(__dirname, file);
+            console.log(`Accumulating model from ${moduleFile}`);
+            const module = yield Promise.resolve(`${moduleFile}`).then(s => require(s));
+            if (typeof module.buildModel === 'function') {
+                module.buildModel(model);
+            }
+            else {
+                console.log(`${file} does not contain the method 'buildModel'`);
+            }
+        }
+        model.validate();
+        return model;
+    });
+}
+exports.buildModel = buildModel;
+//# sourceMappingURL=model.js.map

package/src/lib/model.js.map

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

package/src/lib/person.d.ts

@@ -0,0 +1,9 @@
+import { Definition, Element, Reference } from './core';
+export interface PersonDefinition extends Definition {
+}
+export declare class Person extends Element {
+    readonly name: string;
+    constructor(name: string, definition?: PersonDefinition);
+}
+export declare class ReferencedPerson extends Reference<undefined> {
+}

package/src/lib/person.js

@@ -0,0 +1,15 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.ReferencedPerson = exports.Person = void 0;
+const core_1 = require("./core");
+class Person extends core_1.Element {
+    constructor(name, definition) {
+        super(name, ["Person"], definition);
+        this.name = name;
+    }
+}
+exports.Person = Person;
+class ReferencedPerson extends core_1.Reference {
+}
+exports.ReferencedPerson = ReferencedPerson;
+//# sourceMappingURL=person.js.map

package/src/lib/person.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"person.js","sourceRoot":"","sources":["../../../../../libs/c4-model/src/lib/person.ts"],"names":[],"mappings":";;;AAAA,iCAAuD;AAKvD,MAAa,MAAO,SAAQ,cAAO;IACjC,YAAqC,IAAY,EAAE,UAA6B;QAC9E,KAAK,CAAC,IAAI,EAAE,CAAC,QAAQ,CAAC,EAAE,UAAU,CAAC,CAAA;QADA,SAAI,GAAJ,IAAI,CAAQ;IAEjD,CAAC;CACF;AAJD,wBAIC;AAED,MAAa,gBAAiB,SAAQ,gBAAoB;CACzD;AADD,4CACC"}

package/src/lib/softwareSystem.d.ts

@@ -0,0 +1,20 @@
+import { Definition, Element, Reference, Relationship, RelationshipTarget, TechnologyDefinition } from './core';
+import { Container, ContainerDefinition, ReferencedContainer } from './container';
+export interface SoftwareSystemDefinition extends Definition {
+}
+export interface SoftwareSystemReference {
+    name: string;
+}
+export declare class SoftwareSystem extends Element {
+    readonly name: string;
+    private _relationships;
+    private _containers;
+    constructor(name: string, definition?: SoftwareSystemDefinition);
+    uses(otherElement: RelationshipTarget, definition?: TechnologyDefinition): void;
+    get relationships(): ReadonlyArray<Relationship>;
+    defineContainer(name: string, definition?: ContainerDefinition): Container;
+    getChildElements(): ReadonlyArray<string>;
+}
+export declare class ReferencedSoftwareSystem extends Reference<Container> {
+    referenceContainer(name: string): ReferencedContainer;
+}

package/src/lib/softwareSystem.js

@@ -0,0 +1,41 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.ReferencedSoftwareSystem = exports.SoftwareSystem = void 0;
+const core_1 = require("./core");
+const container_1 = require("./container");
+class SoftwareSystem extends core_1.Element {
+    constructor(name, definition) {
+        super(name, ["Software System"], definition);
+        this.name = name;
+        this._relationships = [];
+        this._containers = new Map();
+    }
+    uses(otherElement, definition) {
+        const relationship = new core_1.Relationship(this, otherElement, definition);
+        this._relationships.push(relationship);
+    }
+    get relationships() {
+        return this._relationships;
+    }
+    defineContainer(name, definition) {
+        if (this._containers.has(name)) {
+            throw Error(`A Container named '${name}' is defined elsewhere in this SoftwareSystem. A Container can be defined only once, but can be referenced multiple times.`);
+        }
+        const container = new container_1.Container(name, definition);
+        this._containers.set(name, container);
+        return container;
+    }
+    getChildElements() {
+        const result = Array.from(this._containers.values()).map(container => `${this.name}.${container.name}`);
+        return result;
+    }
+}
+exports.SoftwareSystem = SoftwareSystem;
+class ReferencedSoftwareSystem extends core_1.Reference {
+    referenceContainer(name) {
+        const containerReference = this.referenceChild(name, (name) => new container_1.ReferencedContainer(name));
+        return containerReference;
+    }
+}
+exports.ReferencedSoftwareSystem = ReferencedSoftwareSystem;
+//# sourceMappingURL=softwareSystem.js.map

package/src/lib/softwareSystem.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"softwareSystem.js","sourceRoot":"","sources":["../../../../../libs/c4-model/src/lib/softwareSystem.ts"],"names":[],"mappings":";;;AAAA,iCAA+G;AAC/G,2CAAiF;AASjF,MAAa,cAAe,SAAQ,cAAO;IAKzC,YAAqC,IAAY,EAAE,UAAqC;QACtF,KAAK,CAAC,IAAI,EAAE,CAAC,iBAAiB,CAAC,EAAE,UAAU,CAAC,CAAA;QADT,SAAI,GAAJ,IAAI,CAAQ;QAHzC,mBAAc,GAAmB,EAAE,CAAA;QACnC,gBAAW,GAAG,IAAI,GAAG,EAAqB,CAAC;IAInD,CAAC;IAEM,IAAI,CAAC,YAAgC,EAAE,UAAiC;QAC7E,MAAM,YAAY,GAAG,IAAI,mBAAY,CAAC,IAAI,EAAE,YAAY,EAAE,UAAU,CAAC,CAAA;QACrE,IAAI,CAAC,cAAc,CAAC,IAAI,CAAC,YAAY,CAAC,CAAA;IACxC,CAAC;IAED,IAAW,aAAa;QACtB,OAAO,IAAI,CAAC,cAAc,CAAA;IAC5B,CAAC;IAEM,eAAe,CAAC,IAAY,EAAE,UAAgC;QACnE,IAAI,IAAI,CAAC,WAAW,CAAC,GAAG,CAAC,IAAI,CAAC,EAAE;YAC9B,MAAM,KAAK,CAAC,sBAAsB,IAAI,4HAA4H,CAAC,CAAA;SACpK;QAED,MAAM,SAAS,GAAG,IAAI,qBAAS,CAAC,IAAI,EAAE,UAAU,CAAC,CAAA;QAEjD,IAAI,CAAC,WAAW,CAAC,GAAG,CAAC,IAAI,EAAE,SAAS,CAAC,CAAC;QAEtC,OAAO,SAAS,CAAA;IAClB,CAAC;IAEM,gBAAgB;QACrB,MAAM,MAAM,GAAG,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,WAAW,CAAC,MAAM,EAAE,CAAC,CAAC,GAAG,CAAC,SAAS,CAAC,EAAE,CAAC,GAAG,IAAI,CAAC,IAAI,IAAI,SAAS,CAAC,IAAI,EAAE,CAAC,CAAA;QACvG,OAAO,MAAM,CAAA;IACf,CAAC;CACF;AAlCD,wCAkCC;AAED,MAAa,wBAAyB,SAAQ,gBAAoB;IAEzD,kBAAkB,CAAC,IAAY;QACpC,MAAM,kBAAkB,GAAG,IAAI,CAAC,cAAc,CAAC,IAAI,EAAE,CAAC,IAAY,EAAE,EAAE,CAAC,IAAI,+BAAmB,CAAC,IAAI,CAAC,CAAC,CAAA;QACrG,OAAO,kBAAyC,CAAA;IAClD,CAAC;CACF;AAND,4DAMC"}

package/src/lib/tests/system1/c4.dsl.d.ts

@@ -0,0 +1,2 @@
+import { Model } from "../../model";
+export declare function buildModel(model: Model): void;

package/src/lib/tests/system1/c4.dsl.js

@@ -0,0 +1,9 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.buildModel = void 0;
+function buildModel(model) {
+    model.definePerson('person1');
+    model.referenceSoftwareSystem('softwareSystem1');
+}
+exports.buildModel = buildModel;
+//# sourceMappingURL=c4.dsl.js.map

package/src/lib/tests/system1/c4.dsl.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"c4.dsl.js","sourceRoot":"","sources":["../../../../../../../libs/c4-model/src/lib/tests/system1/c4.dsl.ts"],"names":[],"mappings":";;;AAEA,SAAgB,UAAU,CAAC,KAAY;IACrC,KAAK,CAAC,YAAY,CAAC,SAAS,CAAC,CAAA;IAC7B,KAAK,CAAC,uBAAuB,CAAC,iBAAiB,CAAC,CAAA;AAClD,CAAC;AAHD,gCAGC"}

package/src/lib/tests/system2/c4.dsl.d.ts

@@ -0,0 +1,2 @@
+import { Model } from "../../model";
+export declare function buildModel(model: Model): void;

package/src/lib/tests/system2/c4.dsl.js

@@ -0,0 +1,9 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.buildModel = void 0;
+function buildModel(model) {
+    model.referencePerson('person1');
+    model.defineSoftwareSystem('softwareSystem1');
+}
+exports.buildModel = buildModel;
+//# sourceMappingURL=c4.dsl.js.map

package/src/lib/tests/system2/c4.dsl.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"c4.dsl.js","sourceRoot":"","sources":["../../../../../../../libs/c4-model/src/lib/tests/system2/c4.dsl.ts"],"names":[],"mappings":";;;AAEA,SAAgB,UAAU,CAAC,KAAY;IACrC,KAAK,CAAC,eAAe,CAAC,SAAS,CAAC,CAAA;IAChC,KAAK,CAAC,oBAAoB,CAAC,iBAAiB,CAAC,CAAA;AAC/C,CAAC;AAHD,gCAGC"}