@lionweb/class-core 0.6.13-beta.0

package/dist/linking.d.ts

@@ -0,0 +1,20 @@
+import { Id, Link } from "@lionweb/core";
+import { INodeBase } from "./index.js";
+/**
+ * A tuple type for (data concerning) link and annotation values that are involved with deserialization and deep-duplication
+ *  — more specifically: nodes that have to be installed on other (deserialized/deep-duplicated) nodes in specific features (or as annotations).
+ *
+ * The elements are:
+ *
+ * 1. `parent` — the {@link INodeBase} instance to install on.
+ * 2. `feature` — the {@link Link link} feature to install on, or `null` to indicate that it's an annotation.
+ * 3. `nodesIds` — are the IDs of the nodes to install.
+ * 4. *optional* `originalReferenceTargets` — are the original reference targets of a {@link Reference reference} feature.
+ *  This element is only present when the feature is a {@link Reference reference} feature.
+ *  The `nodesIds` and `originalReferenceTargets` match up per index.
+ *
+ * Note: **DON'T** export this types from the package,
+ * as these are only used to align the deserializer and deep-cloner.
+ */
+export type NodesToInstall = [container: INodeBase, feature: Link | null, nodesIds: Id[], originalReferenceTargets?: INodeBase[]];
+//# sourceMappingURL=linking.d.ts.map

package/dist/linking.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"linking.d.ts","sourceRoot":"","sources":["../src/linking.ts"],"names":[],"mappings":"AAiBA,OAAO,EAAC,EAAE,EAAE,IAAI,EAAC,MAAM,eAAe,CAAC;AACvC,OAAO,EAAC,SAAS,EAAC,MAAM,YAAY,CAAC;AAGrC;;;;;;;;;;;;;;;GAeG;AACH,MAAM,MAAM,cAAc,GAAG,CAAE,SAAS,EAAE,SAAS,EAAE,OAAO,EAAE,IAAI,GAAG,IAAI,EAAE,QAAQ,EAAE,EAAE,EAAE,EAAE,wBAAwB,CAAC,EAAE,SAAS,EAAE,CAAE,CAAC"}

package/dist/linking.js

@@ -0,0 +1,18 @@
+// Copyright 2025 TRUMPF Laser SE and other contributors
+//
+// Licensed under the Apache License, Version 2.0 (the "License")
+// you may not use this file except in compliance with the License.
+// You may obtain a copy of the License at
+//
+//     http://www.apache.org/licenses/LICENSE-2.0
+//
+// Unless required by applicable law or agreed to in writing, software
+// distributed under the License is distributed on an "AS IS" BASIS,
+// WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+// See the License for the specific language governing permissions and
+// limitations under the License.
+//
+// SPDX-FileCopyrightText: 2025 TRUMPF Laser SE and other contributors
+// SPDX-License-Identifier: Apache-2.0
+export {};
+//# sourceMappingURL=linking.js.map

package/dist/linking.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"linking.js","sourceRoot":"","sources":["../src/linking.ts"],"names":[],"mappings":"AAAA,wDAAwD;AACxD,EAAE;AACF,iEAAiE;AACjE,mEAAmE;AACnE,0CAA0C;AAC1C,EAAE;AACF,iDAAiD;AACjD,EAAE;AACF,sEAAsE;AACtE,oEAAoE;AACpE,2EAA2E;AAC3E,sEAAsE;AACtE,iCAAiC;AACjC,EAAE;AACF,sEAAsE;AACtE,sCAAsC"}

package/dist/lionCore_builtins.g.d.ts

@@ -0,0 +1,35 @@
+import { Concept, EnumerationLiteral, Interface, Language, PrimitiveType, Property } from "@lionweb/core";
+import { DeltaHandler, ILanguageBase, INodeBase, NodeBase, NodeBaseFactory } from "./index.js";
+export declare class LionCore_builtinsBase implements ILanguageBase {
+    private readonly _language;
+    get language(): Language;
+    readonly _String: PrimitiveType;
+    get String(): PrimitiveType;
+    readonly _Boolean: PrimitiveType;
+    get Boolean(): PrimitiveType;
+    readonly _Integer: PrimitiveType;
+    get Integer(): PrimitiveType;
+    readonly _JSON: PrimitiveType;
+    get JSON(): PrimitiveType;
+    readonly _Node: Concept;
+    get Node(): Concept;
+    readonly _INamed: Interface;
+    get INamed(): Interface;
+    private readonly _INamed_name;
+    get INamed_name(): Property;
+    private _wiredUp;
+    private ensureWiredUp;
+    factory(_handleDelta?: DeltaHandler): NodeBaseFactory;
+    enumLiteralFrom<EnumType>(enumerationLiteral: EnumerationLiteral): EnumType;
+    static readonly INSTANCE: LionCore_builtinsBase;
+}
+export type String = string;
+export type Boolean = boolean;
+export type Integer = number;
+export type JSON = unknown;
+export declare abstract class Node extends NodeBase {
+}
+export interface INamed extends INodeBase {
+    name: string;
+}
+//# sourceMappingURL=lionCore_builtins.g.d.ts.map

package/dist/lionCore_builtins.g.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"lionCore_builtins.g.d.ts","sourceRoot":"","sources":["../src/lionCore_builtins.g.ts"],"names":[],"mappings":"AA6BA,OAAO,EAEH,OAAO,EACP,kBAAkB,EAElB,SAAS,EACT,QAAQ,EACR,aAAa,EACb,QAAQ,EACX,MAAM,eAAe,CAAC;AAEvB,OAAO,EACH,YAAY,EACZ,aAAa,EACb,SAAS,EACT,QAAQ,EACR,eAAe,EAClB,MAAM,YAAY,CAAC;AAGpB,qBAAa,qBAAsB,YAAW,aAAa;IAEvD,OAAO,CAAC,QAAQ,CAAC,SAAS,CAAmG;IAC7H,IAAI,QAAQ,IAAI,QAAQ,CAGvB;IAED,SAAgB,OAAO,gBAAuG;IAC9H,IAAI,MAAM,IAAI,aAAa,CAG1B;IAED,SAAgB,QAAQ,gBAA0G;IAClI,IAAI,OAAO,IAAI,aAAa,CAG3B;IAED,SAAgB,QAAQ,gBAA0G;IAClI,IAAI,OAAO,IAAI,aAAa,CAG3B;IAED,SAAgB,KAAK,gBAAiG;IACtH,IAAI,IAAI,IAAI,aAAa,CAGxB;IAED,SAAgB,KAAK,UAAiG;IACtH,IAAI,IAAI,IAAI,OAAO,CAGlB;IAED,SAAgB,OAAO,YAAmG;IAC1H,IAAI,MAAM,IAAI,SAAS,CAGtB;IACD,OAAO,CAAC,QAAQ,CAAC,YAAY,CAAwG;IACrI,IAAI,WAAW,IAAI,QAAQ,CAG1B;IAED,OAAO,CAAC,QAAQ,CAAkB;IAClC,OAAO,CAAC,aAAa;IAUrB,OAAO,CAAC,YAAY,CAAC,EAAE,YAAY,GAAG,eAAe;IAOrD,eAAe,CAAC,QAAQ,EAAE,kBAAkB,EAAE,kBAAkB,GAAG,QAAQ;IAM3E,gBAAuB,QAAQ,wBAA+B;CACjE;AAGD,MAAM,MAAM,MAAM,GAAG,MAAM,CAAC;AAE5B,MAAM,MAAM,OAAO,GAAG,OAAO,CAAC;AAE9B,MAAM,MAAM,OAAO,GAAG,MAAM,CAAC;AAE7B,MAAM,MAAM,IAAI,GAAG,OAAO,CAAC;AAE3B,8BAAsB,IAAK,SAAQ,QAAQ;CAC1C;AAED,MAAM,WAAW,MAAO,SAAQ,SAAS;IACrC,IAAI,EAAE,MAAM,CAAC;CAChB"}

package/dist/lionCore_builtins.g.js

@@ -0,0 +1,96 @@
+// Copyright 2025 TRUMPF Laser SE and other contributors
+//
+// Licensed under the Apache License, Version 2.0 (the "License")
+// you may not use this file except in compliance with the License.
+// You may obtain a copy of the License at
+//
+//     http://www.apache.org/licenses/LICENSE-2.0
+//
+// Unless required by applicable law or agreed to in writing, software
+// distributed under the License is distributed on an "AS IS" BASIS,
+// WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+// See the License for the specific language governing permissions and
+// limitations under the License.
+//
+// SPDX-FileCopyrightText: 2025 TRUMPF Laser SE and other contributors
+// SPDX-License-Identifier: Apache-2.0
+// Warning: this file is generated!
+// Modifying it by hand is useless at best, and sabotage at worst.
+/*
+ * language's metadata:
+ *     name:    LionCore_builtins
+ *     version: 2023.1
+ *     key:     LionCore-builtins
+ *     id:      LionCore-builtins
+ */
+import { Concept, Interface, Language, PrimitiveType, Property } from "@lionweb/core";
+import { NodeBase } from "./index.js";
+export class LionCore_builtinsBase {
+    constructor() {
+        this._language = new Language("LionCore_builtins", "2023.1", "LionCore-builtins", "LionCore-builtins");
+        this._String = new PrimitiveType(this._language, "String", "LionCore-builtins-String", "LionCore-builtins-String");
+        this._Boolean = new PrimitiveType(this._language, "Boolean", "LionCore-builtins-Boolean", "LionCore-builtins-Boolean");
+        this._Integer = new PrimitiveType(this._language, "Integer", "LionCore-builtins-Integer", "LionCore-builtins-Integer");
+        this._JSON = new PrimitiveType(this._language, "JSON", "LionCore-builtins-JSON", "LionCore-builtins-JSON");
+        this._Node = new Concept(this._language, "Node", "LionCore-builtins-Node", "LionCore-builtins-Node", true);
+        this._INamed = new Interface(this._language, "INamed", "LionCore-builtins-INamed", "LionCore-builtins-INamed");
+        this._INamed_name = new Property(this._INamed, "name", "LionCore-builtins-INamed-name", "LionCore-builtins-INamed-name");
+        this._wiredUp = false;
+    }
+    get language() {
+        this.ensureWiredUp();
+        return this._language;
+    }
+    get String() {
+        this.ensureWiredUp();
+        return this._String;
+    }
+    get Boolean() {
+        this.ensureWiredUp();
+        return this._Boolean;
+    }
+    get Integer() {
+        this.ensureWiredUp();
+        return this._Integer;
+    }
+    get JSON() {
+        this.ensureWiredUp();
+        return this._JSON;
+    }
+    get Node() {
+        this.ensureWiredUp();
+        return this._Node;
+    }
+    get INamed() {
+        this.ensureWiredUp();
+        return this._INamed;
+    }
+    get INamed_name() {
+        this.ensureWiredUp();
+        return this._INamed_name;
+    }
+    ensureWiredUp() {
+        if (this._wiredUp) {
+            return;
+        }
+        this._language.havingEntities(this._String, this._Boolean, this._Integer, this._JSON, this._Node, this._INamed);
+        this._INamed.havingFeatures(this._INamed_name);
+        this._INamed_name.ofType(this._String);
+        this._wiredUp = true;
+    }
+    factory(_handleDelta) {
+        return (classifier, _id) => {
+            const { language } = classifier;
+            throw new Error(`can't instantiate ${classifier.name} (key=${classifier.key}): classifier is not known in language ${language.name} (key=${language.key}, version=${language.version})`);
+        };
+    }
+    enumLiteralFrom(enumerationLiteral) {
+        const { enumeration } = enumerationLiteral;
+        const { language } = enumeration;
+        throw new Error(`enumeration with key ${enumeration.key} is not known in language ${language.name} (key=${language.key}, version=${language.version})`);
+    }
+}
+LionCore_builtinsBase.INSTANCE = new LionCore_builtinsBase();
+export class Node extends NodeBase {
+}
+//# sourceMappingURL=lionCore_builtins.g.js.map

package/dist/lionCore_builtins.g.js.map

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

package/dist/serializer.d.ts

@@ -0,0 +1,17 @@
+import { ExtractionFacade, Feature } from "@lionweb/core";
+import { INodeBase } from "./index.js";
+/**
+ * @return the value of the given {@link Feature feature} (2nd argument) on the given node (of type {@link INodeBase}; 1st argument).
+ * **Note** that this function is for internal use only!
+ */
+export declare const getFeatureValue: (node: INodeBase, feature: Feature) => unknown;
+/**
+ * An {@link ExtractionFacade} that works on/for {@link INodeBase}s specifically.
+ * **Note** that this function is for internal use only!
+ */
+export declare const nodeBaseReader: ExtractionFacade<INodeBase>;
+/**
+ * @return a serialization of the given nodes (of type {@link INodeBase}) as a {@link SerializationChunk}.
+ */
+export declare const serializeNodeBases: (nodes: INodeBase[]) => import("@lionweb/core").SerializationChunk;
+//# sourceMappingURL=serializer.d.ts.map

package/dist/serializer.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"serializer.d.ts","sourceRoot":"","sources":["../src/serializer.ts"],"names":[],"mappings":"AAiBA,OAAO,EAKH,gBAAgB,EAChB,OAAO,EAIV,MAAM,eAAe,CAAC;AAEvB,OAAO,EAAC,SAAS,EAAwB,MAAM,YAAY,CAAC;AAG5D;;;GAGG;AACH,eAAO,MAAM,eAAe,SAAU,SAAS,WAAW,OAAO,YAWhE,CAAC;AAEF;;;GAGG;AACH,eAAO,MAAM,cAAc,EAAE,gBAAgB,CAAC,SAAS,CAyBtD,CAAC;AAEF;;GAEG;AACH,eAAO,MAAM,kBAAkB,UAAW,SAAS,EAAE,+CACuB,CAAC"}

package/dist/serializer.js

@@ -0,0 +1,70 @@
+// Copyright 2025 TRUMPF Laser SE and other contributors
+//
+// Licensed under the Apache License, Version 2.0 (the "License")
+// you may not use this file except in compliance with the License.
+// You may obtain a copy of the License at
+//
+//     http://www.apache.org/licenses/LICENSE-2.0
+//
+// Unless required by applicable law or agreed to in writing, software
+// distributed under the License is distributed on an "AS IS" BASIS,
+// WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+// See the License for the specific language governing permissions and
+// limitations under the License.
+//
+// SPDX-FileCopyrightText: 2025 TRUMPF Laser SE and other contributors
+// SPDX-License-Identifier: Apache-2.0
+import { allSuperTypesOf, builtinClassifiers, builtinFeatures, Containment, Property, Reference, serializeNodes } from "@lionweb/core";
+import { LionCore_builtinsBase } from "./index.js";
+/**
+ * @return the value of the given {@link Feature feature} (2nd argument) on the given node (of type {@link INodeBase}; 1st argument).
+ * **Note** that this function is for internal use only!
+ */
+export const getFeatureValue = (node, feature) => {
+    if (feature instanceof Property) {
+        return node.getPropertyValueManager(feature).getDirectly();
+    }
+    if (feature instanceof Containment) {
+        return node.getContainmentValueManager(feature).getDirectly();
+    }
+    if (feature instanceof Reference) {
+        return node.getReferenceValueManager(feature).getDirectly();
+    }
+    throw new Error(`unhandled Feature sub type ${feature.constructor.name}`);
+};
+/**
+ * An {@link ExtractionFacade} that works on/for {@link INodeBase}s specifically.
+ * **Note** that this function is for internal use only!
+ */
+export const nodeBaseReader = {
+    classifierOf: (node) => node.classifier,
+    getFeatureValue,
+    enumerationLiteralFrom: (encoding, enumeration) => {
+        return enumeration.literals.find((literal) => literal.key === encoding);
+    },
+    resolveInfoFor: (node) => {
+        if ("name" in node) {
+            // evaluating `node.name` might cause an error through FeatureValueManager.throwOnReadOfUnset:
+            try {
+                const value = node.name;
+                return typeof value === "string" ? value : undefined;
+            }
+            catch (_) {
+                return undefined;
+            }
+        }
+        const allSupertypes = allSuperTypesOf(node.classifier);
+        if (allSupertypes.indexOf(builtinClassifiers.inamed) > -1) {
+            return node.getPropertyValueManager(builtinFeatures.inamed_name).getDirectly();
+        }
+        if (allSupertypes.indexOf(LionCore_builtinsBase.INSTANCE.INamed) > -1) {
+            return node.getPropertyValueManager(LionCore_builtinsBase.INSTANCE.INamed_name).getDirectly();
+        }
+        return undefined;
+    }
+};
+/**
+ * @return a serialization of the given nodes (of type {@link INodeBase}) as a {@link SerializationChunk}.
+ */
+export const serializeNodeBases = (nodes) => serializeNodes(nodes, nodeBaseReader, { serializeEmptyFeatures: false });
+//# sourceMappingURL=serializer.js.map

package/dist/serializer.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"serializer.js","sourceRoot":"","sources":["../src/serializer.ts"],"names":[],"mappings":"AAAA,wDAAwD;AACxD,EAAE;AACF,iEAAiE;AACjE,mEAAmE;AACnE,0CAA0C;AAC1C,EAAE;AACF,iDAAiD;AACjD,EAAE;AACF,sEAAsE;AACtE,oEAAoE;AACpE,2EAA2E;AAC3E,sEAAsE;AACtE,iCAAiC;AACjC,EAAE;AACF,sEAAsE;AACtE,sCAAsC;AAEtC,OAAO,EACH,eAAe,EACf,kBAAkB,EAClB,eAAe,EACf,WAAW,EAGX,QAAQ,EACR,SAAS,EACT,cAAc,EACjB,MAAM,eAAe,CAAC;AAEvB,OAAO,EAAY,qBAAqB,EAAC,MAAM,YAAY,CAAC;AAG5D;;;GAGG;AACH,MAAM,CAAC,MAAM,eAAe,GAAG,CAAC,IAAe,EAAE,OAAgB,EAAE,EAAE;IACjE,IAAI,OAAO,YAAY,QAAQ,EAAE,CAAC;QAC9B,OAAO,IAAI,CAAC,uBAAuB,CAAC,OAAO,CAAC,CAAC,WAAW,EAAE,CAAC;IAC/D,CAAC;IACD,IAAI,OAAO,YAAY,WAAW,EAAE,CAAC;QACjC,OAAO,IAAI,CAAC,0BAA0B,CAAC,OAAO,CAAC,CAAC,WAAW,EAAE,CAAC;IAClE,CAAC;IACD,IAAI,OAAO,YAAY,SAAS,EAAE,CAAC;QAC/B,OAAO,IAAI,CAAC,wBAAwB,CAAC,OAAO,CAAC,CAAC,WAAW,EAAE,CAAC;IAChE,CAAC;IACD,MAAM,IAAI,KAAK,CAAC,8BAA8B,OAAO,CAAC,WAAW,CAAC,IAAI,EAAE,CAAC,CAAA;AAC7E,CAAC,CAAC;AAEF;;;GAGG;AACH,MAAM,CAAC,MAAM,cAAc,GAAgC;IACvD,YAAY,EAAE,CAAC,IAAI,EAAE,EAAE,CAAC,IAAI,CAAC,UAAU;IACvC,eAAe;IACf,sBAAsB,EAAE,CAAC,QAAQ,EAAE,WAAW,EAAE,EAAE;QAC9C,OAAO,WAAW,CAAC,QAAQ,CAAC,IAAI,CAAC,CAAC,OAAO,EAAE,EAAE,CAAC,OAAO,CAAC,GAAG,KAAK,QAAQ,CAAE,CAAC;IAC7E,CAAC;IACD,cAAc,EAAE,CAAC,IAAe,EAAE,EAAE;QAChC,IAAI,MAAM,IAAI,IAAI,EAAE,CAAC;YACjB,8FAA8F;YAC9F,IAAI,CAAC;gBACD,MAAM,KAAK,GAAG,IAAI,CAAC,IAAI,CAAC;gBACxB,OAAO,OAAO,KAAK,KAAK,QAAQ,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,SAAS,CAAC;YACzD,CAAC;YAAC,OAAO,CAAC,EAAE,CAAC;gBACT,OAAO,SAAS,CAAC;YACrB,CAAC;QACL,CAAC;QACD,MAAM,aAAa,GAAG,eAAe,CAAC,IAAI,CAAC,UAAU,CAAC,CAAC;QACvD,IAAI,aAAa,CAAC,OAAO,CAAC,kBAAkB,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC,EAAE,CAAC;YACxD,OAAO,IAAI,CAAC,uBAAuB,CAAC,eAAe,CAAC,WAAW,CAAC,CAAC,WAAW,EAA0B,CAAC;QAC3G,CAAC;QACD,IAAI,aAAa,CAAC,OAAO,CAAC,qBAAqB,CAAC,QAAQ,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC,EAAE,CAAC;YACpE,OAAO,IAAI,CAAC,uBAAuB,CAAC,qBAAqB,CAAC,QAAQ,CAAC,WAAW,CAAC,CAAC,WAAW,EAA0B,CAAC;QAC1H,CAAC;QACD,OAAO,SAAS,CAAC;IACrB,CAAC;CACJ,CAAC;AAEF;;GAEG;AACH,MAAM,CAAC,MAAM,kBAAkB,GAAG,CAAC,KAAkB,EAAE,EAAE,CACrD,cAAc,CAAC,KAAK,EAAE,cAAc,EAAE,EAAE,sBAAsB,EAAE,KAAK,EAAE,CAAC,CAAC"}

package/dist/textualizer.d.ts

@@ -0,0 +1,7 @@
+import { INodeBase } from "./base-types.js";
+/**
+ * @return a function that renders the roots of a given forest of {@link INodeBase nodes} in a textual tree-representation.
+ * @param identificationFor a function that renders an identification for the given {@link INodeBase node} — typically its name or its ID.
+ */
+export declare const asTreeTextWith: (identificationFor: (node: INodeBase) => string) => (nodes: INodeBase[]) => string;
+//# sourceMappingURL=textualizer.d.ts.map

package/dist/textualizer.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"textualizer.d.ts","sourceRoot":"","sources":["../src/textualizer.ts"],"names":[],"mappings":"AAoBA,OAAO,EAAC,SAAS,EAAC,MAAM,iBAAiB,CAAC;AAyB1C;;;GAGG;AACH,eAAO,MAAM,cAAc,6BAA8B,SAAS,KAAK,MAAM,aAAY,SAAS,EAAE,KAAK,MAqDxG,CAAA"}

package/dist/textualizer.js

@@ -0,0 +1,82 @@
+// Copyright 2025 TRUMPF Laser SE and other contributors
+//
+// Licensed under the Apache License, Version 2.0 (the "License")
+// you may not use this file except in compliance with the License.
+// You may obtain a copy of the License at
+//
+//     http://www.apache.org/licenses/LICENSE-2.0
+//
+// Unless required by applicable law or agreed to in writing, software
+// distributed under the License is distributed on an "AS IS" BASIS,
+// WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+// See the License for the specific language governing permissions and
+// limitations under the License.
+//
+// SPDX-FileCopyrightText: 2025 TRUMPF Laser SE and other contributors
+// SPDX-License-Identifier: Apache-2.0
+import { asString, indentWith } from "littoral-templates";
+import { allFeaturesOf, Containment, Property, Reference, unresolved } from "@lionweb/core";
+import { LionCore_builtinsBase } from "./lionCore_builtins.g.js";
+const indent = indentWith("    ")(1);
+const prependWith = (template, prefix) => prefix + asString(template);
+const asINodeBases = (value) => {
+    const isINodeBase = (value) => !(value === unresolved || value === undefined);
+    if (Array.isArray(value)) {
+        return value
+            .filter((subValue) => isINodeBase(subValue))
+            .map((subValue) => subValue);
+    }
+    return isINodeBase(value) ? [value] : [];
+};
+/**
+ * @return a function that renders the roots of a given forest of {@link INodeBase nodes} in a textual tree-representation.
+ * @param identificationFor a function that renders an identification for the given {@link INodeBase node} — typically its name or its ID.
+ */
+export const asTreeTextWith = (identificationFor) => {
+    const asText = (node) => {
+        const featureValueAsText = (feature) => {
+            if (feature instanceof Property) {
+                const valueManager = node.getPropertyValueManager(feature);
+                const displayValue = (() => {
+                    if (!valueManager.isSet()) {
+                        return `$<not set>`;
+                    }
+                    const value = valueManager.getDirectly();
+                    if (feature.type === LionCore_builtinsBase.INSTANCE.String) {
+                        return `"${value}"`;
+                    }
+                    return value;
+                })();
+                return `${feature.name} = ${displayValue}`;
+            }
+            if (feature instanceof Containment) {
+                const valueManager = node.getContainmentValueManager(feature);
+                const children = asINodeBases(valueManager.getDirectly());
+                return [
+                    `${feature.name}:${children.length === 0 ? " <nothing>" : ""}`,
+                    indent(children.map(asText))
+                ];
+            }
+            if (feature instanceof Reference) {
+                const valueManager = node.getReferenceValueManager(feature);
+                const references = asINodeBases(valueManager.getDirectly());
+                return [
+                    `${feature.name} -> ${references.length === 0 ? "<none>" : references.map(identificationFor).join(", ")}`
+                ];
+            }
+            return `!!! can't handle feature ${feature.name} (of meta type ${feature.metaType()})`;
+        };
+        const annotationAsText = (annotation) => prependWith(asText(annotation), "@ ");
+        return [
+            `${node.classifier.name} (id: ${node.id})`,
+            indent([
+                allFeaturesOf(node.classifier).map(featureValueAsText),
+                node.annotations.map(annotationAsText)
+            ])
+        ];
+    };
+    return (nodes) => asString(nodes
+        .filter((node) => node.parent === undefined) // root nodes
+        .map(asText));
+};
+//# sourceMappingURL=textualizer.js.map

package/dist/textualizer.js.map

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

package/dist/value-managers/annotations.d.ts

@@ -0,0 +1,33 @@
+import { INodeBase } from "../base-types.js";
+import { ValueManager } from "./base.js";
+/**
+ * A value manager for annotations.
+ * Annotations (of any type) are simply contained by a parent (which is an {@link INodeBase}),
+ * not in the context of a(ny) {@link Feature feature}.
+ */
+export declare class AnnotationsValueManager extends ValueManager {
+    constructor(container: INodeBase);
+    private readonly annotations;
+    get(): INodeBase[];
+    addDirectly(newAnnotation: INodeBase): void;
+    add(newAnnotation: INodeBase): void;
+    /**
+     * @return `false` if the given `newAnnotation` wasn't contained before,
+     *  otherwise an array tuple with the old – i.e.: previous – parent of the inserted annotation, and the index it was contained at.
+     */
+    insertAtIndexDirectly(newAnnotation: INodeBase, index: number): false | [oldParent: INodeBase, oldIndex: number];
+    insertAtIndex(newAnnotation: INodeBase, index: number): void;
+    /**
+     * @return the moved annotation, or `undefined` if the indices coincide.
+     */
+    moveDirectly(oldIndex: number, newIndex: number): INodeBase | undefined;
+    move(oldIndex: number, newIndex: number): void;
+    /**
+     * @return the replaced annotation.
+     */
+    replaceAtIndexDirectly(newAnnotation: INodeBase, index: number): INodeBase;
+    replaceAtIndex(newAnnotation: INodeBase, index: number): void;
+    removeDirectly(annotationToRemove: INodeBase): number;
+    remove(annotationToRemove: INodeBase): void;
+}
+//# sourceMappingURL=annotations.d.ts.map

package/dist/value-managers/annotations.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"annotations.d.ts","sourceRoot":"","sources":["../../src/value-managers/annotations.ts"],"names":[],"mappings":"AAmBA,OAAO,EAAC,SAAS,EAAmB,MAAM,kBAAkB,CAAC;AAC7D,OAAO,EAAa,YAAY,EAAC,MAAM,WAAW,CAAC;AAUnD;;;;GAIG;AACH,qBAAa,uBAAwB,SAAQ,YAAY;gBAEzC,SAAS,EAAE,SAAS;IAIhC,OAAO,CAAC,QAAQ,CAAC,WAAW,CAAkD;IAE9E,GAAG,IAAI,SAAS,EAAE;IAIV,WAAW,CAAC,aAAa,EAAE,SAAS;IAKpC,GAAG,CAAC,aAAa,EAAE,SAAS;IAIpC;;;OAGG;IACK,qBAAqB,CAAC,aAAa,EAAE,SAAS,EAAE,KAAK,EAAE,MAAM,GAAG,KAAK,GAAG,CAAC,SAAS,EAAE,SAAS,EAAE,QAAQ,EAAE,MAAM,CAAC;IAchH,aAAa,CAAC,aAAa,EAAE,SAAS,EAAE,KAAK,EAAE,MAAM;IAS7D;;OAEG;IACK,YAAY,CAAC,QAAQ,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,GAAG,SAAS,GAAG,SAAS;IAWvE,IAAI,CAAC,QAAQ,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM;IAO/C;;OAEG;IACK,sBAAsB,CAAC,aAAa,EAAE,SAAS,EAAE,KAAK,EAAE,MAAM,GAAG,SAAS;IAS1E,cAAc,CAAC,aAAa,EAAE,SAAS,EAAE,KAAK,EAAE,MAAM;IAKtD,cAAc,CAAC,kBAAkB,EAAE,SAAS,GAAG,MAAM;IASrD,MAAM,CAAC,kBAAkB,EAAE,SAAS;CAO/C"}

package/dist/value-managers/annotations.js

@@ -0,0 +1,192 @@
+// Copyright 2025 TRUMPF Laser SE and other contributors
+//
+// Licensed under the Apache License, Version 2.0 (the "License")
+// you may not use this file except in compliance with the License.
+// You may obtain a copy of the License at
+//
+//     http://www.apache.org/licenses/LICENSE-2.0
+//
+// Unless required by applicable law or agreed to in writing, software
+// distributed under the License is distributed on an "AS IS" BASIS,
+// WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+// See the License for the specific language governing permissions and
+// limitations under the License.
+//
+// SPDX-FileCopyrightText: 2025 TRUMPF Laser SE and other contributors
+// SPDX-License-Identifier: Apache-2.0
+var __runInitializers = (this && this.__runInitializers) || function (thisArg, initializers, value) {
+    var useValue = arguments.length > 2;
+    for (var i = 0; i < initializers.length; i++) {
+        value = useValue ? initializers[i].call(thisArg, value) : initializers[i].call(thisArg);
+    }
+    return useValue ? value : void 0;
+};
+var __esDecorate = (this && this.__esDecorate) || function (ctor, descriptorIn, decorators, contextIn, initializers, extraInitializers) {
+    function accept(f) { if (f !== void 0 && typeof f !== "function") throw new TypeError("Function expected"); return f; }
+    var kind = contextIn.kind, key = kind === "getter" ? "get" : kind === "setter" ? "set" : "value";
+    var target = !descriptorIn && ctor ? contextIn["static"] ? ctor : ctor.prototype : null;
+    var descriptor = descriptorIn || (target ? Object.getOwnPropertyDescriptor(target, contextIn.name) : {});
+    var _, done = false;
+    for (var i = decorators.length - 1; i >= 0; i--) {
+        var context = {};
+        for (var p in contextIn) context[p] = p === "access" ? {} : contextIn[p];
+        for (var p in contextIn.access) context.access[p] = contextIn.access[p];
+        context.addInitializer = function (f) { if (done) throw new TypeError("Cannot add initializers after decoration has completed"); extraInitializers.push(accept(f || null)); };
+        var result = (0, decorators[i])(kind === "accessor" ? { get: descriptor.get, set: descriptor.set } : descriptor[key], context);
+        if (kind === "accessor") {
+            if (result === void 0) continue;
+            if (result === null || typeof result !== "object") throw new TypeError("Object expected");
+            if (_ = accept(result.get)) descriptor.get = _;
+            if (_ = accept(result.set)) descriptor.set = _;
+            if (_ = accept(result.init)) initializers.unshift(_);
+        }
+        else if (_ = accept(result)) {
+            if (kind === "field") initializers.unshift(_);
+            else descriptor[key] = _;
+        }
+    }
+    if (target) Object.defineProperty(target, contextIn.name, descriptor);
+    done = true;
+};
+import { action, observable } from "mobx";
+import { removeFromParent } from "../base-types.js";
+import { checkIndex, ValueManager } from "./base.js";
+import { AnnotationAddedDelta, AnnotationDeletedDelta, AnnotationMovedFromOtherParentDelta, AnnotationMovedInSameParentDelta, AnnotationReplacedDelta } from "../deltas/index.js";
+/**
+ * A value manager for annotations.
+ * Annotations (of any type) are simply contained by a parent (which is an {@link INodeBase}),
+ * not in the context of a(ny) {@link Feature feature}.
+ */
+let AnnotationsValueManager = (() => {
+    var _a;
+    let _classSuper = ValueManager;
+    let _instanceExtraInitializers = [];
+    let _addDirectly_decorators;
+    let _add_decorators;
+    let _insertAtIndexDirectly_decorators;
+    let _insertAtIndex_decorators;
+    let _moveDirectly_decorators;
+    let _move_decorators;
+    let _replaceAtIndexDirectly_decorators;
+    let _replaceAtIndex_decorators;
+    let _removeDirectly_decorators;
+    let _remove_decorators;
+    return _a = class AnnotationsValueManager extends _classSuper {
+            constructor(container) {
+                super(container);
+                this.annotations = (__runInitializers(this, _instanceExtraInitializers), observable.array([], { deep: false }));
+            }
+            get() {
+                return this.annotations.slice();
+            }
+            addDirectly(newAnnotation) {
+                this.annotations.push(newAnnotation);
+                newAnnotation.attachTo(this.container, null);
+            }
+            add(newAnnotation) {
+                this.insertAtIndex(newAnnotation, this.annotations.length);
+            }
+            /**
+             * @return `false` if the given `newAnnotation` wasn't contained before,
+             *  otherwise an array tuple with the old – i.e.: previous – parent of the inserted annotation, and the index it was contained at.
+             */
+            insertAtIndexDirectly(newAnnotation, index) {
+                checkIndex(index, this.annotations.length, true);
+                this.annotations.splice(index, 0, newAnnotation);
+                const oldParent = newAnnotation.parent;
+                if (oldParent === undefined) {
+                    newAnnotation.attachTo(this.container, null);
+                    return false;
+                }
+                else {
+                    const oldIndex = removeFromParent(oldParent, newAnnotation);
+                    newAnnotation.attachTo(this.container, null);
+                    return [oldParent, oldIndex];
+                }
+            }
+            insertAtIndex(newAnnotation, index) {
+                const oldParentage = this.insertAtIndexDirectly(newAnnotation, index);
+                if (oldParentage === false) {
+                    this.emitDelta(() => new AnnotationAddedDelta(this.container, index, newAnnotation));
+                }
+                else {
+                    this.emitDelta(() => new AnnotationMovedFromOtherParentDelta(oldParentage[0], oldParentage[1], this.container, index, newAnnotation));
+                }
+            }
+            /**
+             * @return the moved annotation, or `undefined` if the indices coincide.
+             */
+            moveDirectly(oldIndex, newIndex) {
+                checkIndex(oldIndex, this.annotations.length, false);
+                checkIndex(newIndex, this.annotations.length, false);
+                if (oldIndex !== newIndex) {
+                    const [annotation] = this.annotations.splice(oldIndex, 1);
+                    this.annotations.splice(newIndex, 0, annotation);
+                    return annotation;
+                }
+                return undefined;
+            }
+            move(oldIndex, newIndex) {
+                const annotation = this.moveDirectly(oldIndex, newIndex);
+                if (annotation !== undefined) {
+                    this.emitDelta(() => new AnnotationMovedInSameParentDelta(this.container, oldIndex, newIndex, annotation));
+                }
+            }
+            /**
+             * @return the replaced annotation.
+             */
+            replaceAtIndexDirectly(newAnnotation, index) {
+                checkIndex(index, this.annotations.length, false);
+                const replacedAnnotation = this.annotations[index];
+                this.annotations.splice(index, 1, newAnnotation);
+                replacedAnnotation.detach();
+                newAnnotation.attachTo(this.container, null);
+                return replacedAnnotation;
+            }
+            replaceAtIndex(newAnnotation, index) {
+                const replacedAnnotation = this.replaceAtIndexDirectly(newAnnotation, index);
+                this.emitDelta(() => new AnnotationReplacedDelta(this.container, index, replacedAnnotation, newAnnotation));
+            }
+            removeDirectly(annotationToRemove) {
+                const index = this.annotations.indexOf(annotationToRemove);
+                if (index > -1) {
+                    this.annotations.splice(index, 1);
+                }
+                annotationToRemove.detach();
+                return index;
+            }
+            remove(annotationToRemove) {
+                const removeIndex = this.removeDirectly(annotationToRemove);
+                if (removeIndex > -1) {
+                    this.emitDelta(() => new AnnotationDeletedDelta(this.container, removeIndex, annotationToRemove));
+                }
+            }
+        },
+        (() => {
+            const _metadata = typeof Symbol === "function" && Symbol.metadata ? Object.create(_classSuper[Symbol.metadata] ?? null) : void 0;
+            _addDirectly_decorators = [action];
+            _add_decorators = [action];
+            _insertAtIndexDirectly_decorators = [action];
+            _insertAtIndex_decorators = [action];
+            _moveDirectly_decorators = [action];
+            _move_decorators = [action];
+            _replaceAtIndexDirectly_decorators = [action];
+            _replaceAtIndex_decorators = [action];
+            _removeDirectly_decorators = [action];
+            _remove_decorators = [action];
+            __esDecorate(_a, null, _addDirectly_decorators, { kind: "method", name: "addDirectly", static: false, private: false, access: { has: obj => "addDirectly" in obj, get: obj => obj.addDirectly }, metadata: _metadata }, null, _instanceExtraInitializers);
+            __esDecorate(_a, null, _add_decorators, { kind: "method", name: "add", static: false, private: false, access: { has: obj => "add" in obj, get: obj => obj.add }, metadata: _metadata }, null, _instanceExtraInitializers);
+            __esDecorate(_a, null, _insertAtIndexDirectly_decorators, { kind: "method", name: "insertAtIndexDirectly", static: false, private: false, access: { has: obj => "insertAtIndexDirectly" in obj, get: obj => obj.insertAtIndexDirectly }, metadata: _metadata }, null, _instanceExtraInitializers);
+            __esDecorate(_a, null, _insertAtIndex_decorators, { kind: "method", name: "insertAtIndex", static: false, private: false, access: { has: obj => "insertAtIndex" in obj, get: obj => obj.insertAtIndex }, metadata: _metadata }, null, _instanceExtraInitializers);
+            __esDecorate(_a, null, _moveDirectly_decorators, { kind: "method", name: "moveDirectly", static: false, private: false, access: { has: obj => "moveDirectly" in obj, get: obj => obj.moveDirectly }, metadata: _metadata }, null, _instanceExtraInitializers);
+            __esDecorate(_a, null, _move_decorators, { kind: "method", name: "move", static: false, private: false, access: { has: obj => "move" in obj, get: obj => obj.move }, metadata: _metadata }, null, _instanceExtraInitializers);
+            __esDecorate(_a, null, _replaceAtIndexDirectly_decorators, { kind: "method", name: "replaceAtIndexDirectly", static: false, private: false, access: { has: obj => "replaceAtIndexDirectly" in obj, get: obj => obj.replaceAtIndexDirectly }, metadata: _metadata }, null, _instanceExtraInitializers);
+            __esDecorate(_a, null, _replaceAtIndex_decorators, { kind: "method", name: "replaceAtIndex", static: false, private: false, access: { has: obj => "replaceAtIndex" in obj, get: obj => obj.replaceAtIndex }, metadata: _metadata }, null, _instanceExtraInitializers);
+            __esDecorate(_a, null, _removeDirectly_decorators, { kind: "method", name: "removeDirectly", static: false, private: false, access: { has: obj => "removeDirectly" in obj, get: obj => obj.removeDirectly }, metadata: _metadata }, null, _instanceExtraInitializers);
+            __esDecorate(_a, null, _remove_decorators, { kind: "method", name: "remove", static: false, private: false, access: { has: obj => "remove" in obj, get: obj => obj.remove }, metadata: _metadata }, null, _instanceExtraInitializers);
+            if (_metadata) Object.defineProperty(_a, Symbol.metadata, { enumerable: true, configurable: true, writable: true, value: _metadata });
+        })(),
+        _a;
+})();
+export { AnnotationsValueManager };
+//# sourceMappingURL=annotations.js.map

package/dist/value-managers/annotations.js.map

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