@lionweb/delta-protocol-common 0.7.0-beta.21

package/CHANGELOG.md

@@ -0,0 +1,6 @@
+# Changelog
+
+## 0.7.0
+
+Initial creation and publication of this package.
+

package/README.md

@@ -0,0 +1,33 @@
+# The `delta-protocol-common` package
+
+[![license](https://img.shields.io/badge/License-Apache%202.0-green.svg?style=flat)
+](./LICENSE)
+
+An NPM package that can be added to a Node.js/NPM codebase as follows:
+
+```shell
+$ npm add @lionweb/delta-protocol-common
+```
+
+It contains the (production part of the) implementation of the delta protocol in TypeScript that’s not tied to any specific message transport protocol.
+We’d typically use WebSockets for this, but browser and Node.js have slightly different implementations, so we chose to split the parts of the implementation that are message transport protocol-specific into separate packages.
+This package therefore contains “common” stuff used by the downstream `delta-protocol-*` packages.
+
+
+
+
+## Repository
+
+The TypeScript implementation of a repository that complies with the LionWeb delta protocol – in the form of the `LionWebRepository` class – in this package is ***entirely incomplete***.
+It mainly serves as a way to be able to run and test the TypeScript implementation of the LionWeb client, at least to the extent that a client can send queries and commands and get responses that are somewhat plausible.
+The C# implementation *is* complete and should be used for actual use.
+
+
+## Development
+
+Build this package from source as follows:
+
+```shell
+npm run build
+```
+

package/dist/index.d.ts

@@ -0,0 +1,5 @@
+export * from "./logging/index.js";
+export * from "./payload/index.js";
+export * from "./translators/index.js";
+export * from "./utils/index.js";
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAiBA,cAAc,oBAAoB,CAAA;AAClC,cAAc,oBAAoB,CAAA;AAClC,cAAc,wBAAwB,CAAA;AACtC,cAAc,kBAAkB,CAAA"}

package/dist/index.js

@@ -0,0 +1,21 @@
+// 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 * from "./logging/index.js";
+export * from "./payload/index.js";
+export * from "./translators/index.js";
+export * from "./utils/index.js";
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.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,cAAc,oBAAoB,CAAA;AAClC,cAAc,oBAAoB,CAAA;AAClC,cAAc,wBAAwB,CAAA;AACtC,cAAc,kBAAkB,CAAA"}

package/dist/logging/ansi.d.ts

@@ -0,0 +1,44 @@
+declare const colors: {
+    readonly black: 30;
+    readonly red: 31;
+    readonly green: 32;
+    readonly yellow: 33;
+    readonly blue: 34;
+    readonly magenta: 35;
+    readonly cyan: 36;
+    readonly white: 37;
+    readonly default: 39;
+};
+declare const styles: {
+    readonly default: 0;
+    readonly bold: 1;
+    readonly italic: 3;
+};
+export declare const ansi: {
+    colors: {
+        readonly black: 30;
+        readonly red: 31;
+        readonly green: 32;
+        readonly yellow: 33;
+        readonly blue: 34;
+        readonly magenta: 35;
+        readonly cyan: 36;
+        readonly white: 37;
+        readonly default: 39;
+    };
+    styles: {
+        readonly default: 0;
+        readonly bold: 1;
+        readonly italic: 3;
+    };
+    withColorAndStyleApplied: (color: keyof typeof colors, style: keyof typeof styles) => (text: string) => string;
+    clientInfo: (text: string) => string;
+    clientWarning: (text: string) => string;
+    repositoryInfo: (text: string) => string;
+    repositoryWarning: (text: string) => string;
+    genericError: (text: string) => string;
+    genericWarning: (text: string) => string;
+    colorSchemeExplanationString: string;
+};
+export {};
+//# sourceMappingURL=ansi.d.ts.map

package/dist/logging/ansi.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ansi.d.ts","sourceRoot":"","sources":["../../src/logging/ansi.ts"],"names":[],"mappings":"AAiBA,QAAA,MAAM,MAAM;;;;;;;;;;CAUF,CAAA;AAEV,QAAA,MAAM,MAAM;;;;CAIF,CAAA;AAiBV,eAAO,MAAM,IAAI;;;;;;;;;;;;;;;;;sCAdwB,MAAM,OAAO,MAAM,SAAS,MAAM,OAAO,MAAM,MACnF,MAAM,MAAM;uBAAN,MAAM;0BAAN,MAAM;2BAAN,MAAM;8BAAN,MAAM;yBAAN,MAAM;2BAAN,MAAM;;CAwBhB,CAAA"}

package/dist/logging/ansi.js

@@ -0,0 +1,53 @@
+// 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
+const colors = {
+    black: 30,
+    red: 31,
+    green: 32,
+    yellow: 33,
+    blue: 34,
+    magenta: 35,
+    cyan: 36,
+    white: 37,
+    default: 39
+};
+const styles = {
+    default: 0,
+    bold: 1,
+    italic: 3
+};
+const withColorAndStyleApplied = (color, style) => (text) => `\x1b[${style === "default" ? "" : `${styles[style]}`}${color === "default" ? "" : `;${colors[color]}m`}${text}\x1b[0m`;
+const clientInfo = withColorAndStyleApplied("magenta", "bold");
+const clientWarning = withColorAndStyleApplied("magenta", "italic");
+const repositoryInfo = withColorAndStyleApplied("cyan", "bold");
+const repositoryWarning = withColorAndStyleApplied("cyan", "italic");
+const genericError = withColorAndStyleApplied("red", "bold");
+const genericWarning = withColorAndStyleApplied("red", "italic");
+const colorSchemeExplanationString = `${withColorAndStyleApplied("magenta", "default")("magenta=client")}, ${withColorAndStyleApplied("cyan", "default")("cyan=repository")}`;
+export const ansi = {
+    colors,
+    styles,
+    withColorAndStyleApplied,
+    clientInfo,
+    clientWarning,
+    repositoryInfo,
+    repositoryWarning,
+    genericError,
+    genericWarning,
+    colorSchemeExplanationString
+};
+//# sourceMappingURL=ansi.js.map

package/dist/logging/ansi.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"ansi.js","sourceRoot":"","sources":["../../src/logging/ansi.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,MAAM,MAAM,GAAG;IACX,KAAK,EAAE,EAAE;IACT,GAAG,EAAE,EAAE;IACP,KAAK,EAAE,EAAE;IACT,MAAM,EAAE,EAAE;IACV,IAAI,EAAE,EAAE;IACR,OAAO,EAAE,EAAE;IACX,IAAI,EAAE,EAAE;IACR,KAAK,EAAE,EAAE;IACT,OAAO,EAAE,EAAE;CACL,CAAA;AAEV,MAAM,MAAM,GAAG;IACX,OAAO,EAAE,CAAC;IACV,IAAI,EAAE,CAAC;IACP,MAAM,EAAE,CAAC;CACH,CAAA;AAGV,MAAM,wBAAwB,GAAG,CAAC,KAA0B,EAAE,KAA0B,EAAE,EAAE,CACxF,CAAC,IAAY,EAAE,EAAE,CACb,QAAQ,KAAK,KAAK,SAAS,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,GAAG,MAAM,CAAC,KAAK,CAAC,EAAE,GAAG,KAAK,KAAK,SAAS,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,IAAI,MAAM,CAAC,KAAK,CAAC,GAAG,GAAG,IAAI,SAAS,CAAA;AAG/H,MAAM,UAAU,GAAG,wBAAwB,CAAC,SAAS,EAAE,MAAM,CAAC,CAAA;AAC9D,MAAM,aAAa,GAAG,wBAAwB,CAAC,SAAS,EAAE,QAAQ,CAAC,CAAA;AACnE,MAAM,cAAc,GAAG,wBAAwB,CAAC,MAAM,EAAE,MAAM,CAAC,CAAA;AAC/D,MAAM,iBAAiB,GAAG,wBAAwB,CAAC,MAAM,EAAE,QAAQ,CAAC,CAAA;AACpE,MAAM,YAAY,GAAG,wBAAwB,CAAC,KAAK,EAAE,MAAM,CAAC,CAAA;AAC5D,MAAM,cAAc,GAAG,wBAAwB,CAAC,KAAK,EAAE,QAAQ,CAAC,CAAA;AAEhE,MAAM,4BAA4B,GAAG,GAAG,wBAAwB,CAAC,SAAS,EAAE,SAAS,CAAC,CAAC,gBAAgB,CAAC,KAAK,wBAAwB,CAAC,MAAM,EAAE,SAAS,CAAC,CAAC,iBAAiB,CAAC,EAAE,CAAA;AAE7K,MAAM,CAAC,MAAM,IAAI,GAAG;IAChB,MAAM;IACN,MAAM;IACN,wBAAwB;IACxB,UAAU;IACV,aAAa;IACb,cAAc;IACd,iBAAiB;IACjB,YAAY;IACZ,cAAc;IACd,4BAA4B;CAC/B,CAAA"}

package/dist/logging/index.d.ts

@@ -0,0 +1,4 @@
+export { ansi } from "./ansi.js";
+export * from "./semantic-logging.js";
+export * from "./textual-logging.js";
+//# sourceMappingURL=index.d.ts.map

package/dist/logging/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/logging/index.ts"],"names":[],"mappings":"AAiBA,OAAO,EAAE,IAAI,EAAE,MAAM,WAAW,CAAA;AAChC,cAAc,uBAAuB,CAAA;AACrC,cAAc,sBAAsB,CAAA"}

package/dist/logging/index.js

@@ -0,0 +1,20 @@
+// 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 { ansi } from "./ansi.js";
+export * from "./semantic-logging.js";
+export * from "./textual-logging.js";
+//# sourceMappingURL=index.js.map

package/dist/logging/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/logging/index.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,EAAE,IAAI,EAAE,MAAM,WAAW,CAAA;AAChC,cAAc,uBAAuB,CAAA;AACrC,cAAc,sBAAsB,CAAA"}

package/dist/logging/semantic-logging.d.ts

@@ -0,0 +1,55 @@
+import { SerializedDelta } from "@lionweb/class-core";
+import { LionWebId } from "@lionweb/json";
+import { Event } from "../payload/event-types.js";
+export interface ISemanticLogItem {
+    asText(): string;
+}
+export type SemanticLogger = (semanticLogItem: ISemanticLogItem) => void;
+export declare const semanticNoOpLogger: SemanticLogger;
+export declare const semanticLoggerFunctionFrom: (optionalSemanticLogger?: SemanticLogger) => SemanticLogger;
+export declare const semanticConsoleLogger: (semanticLogItem: ISemanticLogItem) => void;
+export declare class DeltaOccurredOnClient implements ISemanticLogItem {
+    readonly clientId: LionWebId;
+    readonly serializedDelta: SerializedDelta;
+    constructor(clientId: LionWebId, serializedDelta: SerializedDelta);
+    asText: () => string;
+}
+export declare class ClientSentMessage<TMessageForRepository> implements ISemanticLogItem {
+    readonly clientId: LionWebId;
+    readonly message: TMessageForRepository;
+    constructor(clientId: LionWebId, message: TMessageForRepository);
+    asText: () => string;
+}
+export declare class ClientReceivedMessage<TMessageForClient> implements ISemanticLogItem {
+    readonly clientId: LionWebId;
+    readonly message: TMessageForClient;
+    constructor(clientId: LionWebId, message: TMessageForClient);
+    asText: () => string;
+}
+export declare class ClientAppliedEvent implements ISemanticLogItem {
+    readonly clientId: LionWebId;
+    readonly event: Event;
+    constructor(clientId: LionWebId, event: Event);
+    asText: () => string;
+}
+export declare class ClientDidNotApplyEventFromOwnCommand implements ISemanticLogItem {
+    readonly clientId: LionWebId;
+    readonly originatingCommandId: LionWebId;
+    constructor(clientId: LionWebId, originatingCommandId: LionWebId);
+    asText: () => string;
+}
+export declare class ClientHadProblem implements ISemanticLogItem {
+    readonly clientId: LionWebId;
+    readonly message: string;
+    constructor(clientId: LionWebId, message: string);
+    asText: () => string;
+}
+export declare class RepositoryReceivedMessage<TClientMetadata, TIncomingMessage> implements ISemanticLogItem {
+    readonly knownMetadata: Partial<TClientMetadata>;
+    readonly message: TIncomingMessage;
+    constructor(knownMetadata: Partial<TClientMetadata>, message: TIncomingMessage);
+    asText: () => string;
+}
+export declare const semanticLogItemsToConsole: (semanticLogItems: ISemanticLogItem[]) => void;
+export declare const semanticLogItemStorer: () => [semanticLogger: SemanticLogger, semanticLogItems: ISemanticLogItem[]];
+//# sourceMappingURL=semantic-logging.d.ts.map

package/dist/logging/semantic-logging.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"semantic-logging.d.ts","sourceRoot":"","sources":["../../src/logging/semantic-logging.ts"],"names":[],"mappings":"AAiBA,OAAO,EAAE,eAAe,EAAE,MAAM,qBAAqB,CAAA;AACrD,OAAO,EAAE,SAAS,EAAE,MAAM,eAAe,CAAA;AAMzC,OAAO,EAAE,KAAK,EAAE,MAAM,2BAA2B,CAAA;AAGjD,MAAM,WAAW,gBAAgB;IAC7B,MAAM,IAAI,MAAM,CAAA;CACnB;AAGD,MAAM,MAAM,cAAc,GAAG,CAAC,eAAe,EAAE,gBAAgB,KAAK,IAAI,CAAA;AAExE,eAAO,MAAM,kBAAkB,EAAE,cAA0B,CAAA;AAE3D,eAAO,MAAM,0BAA0B,GAAI,yBAAyB,cAAc,mBAClC,CAAA;AAEhD,eAAO,MAAM,qBAAqB,GAAI,iBAAiB,gBAAgB,SAEtE,CAAA;AAGD,qBAAa,qBAAsB,YAAW,gBAAgB;aAC9B,QAAQ,EAAE,SAAS;aAAkB,eAAe,EAAE,eAAe;gBAArE,QAAQ,EAAE,SAAS,EAAkB,eAAe,EAAE,eAAe;IACjG,MAAM,eAAqH;CAC9H;AAED,qBAAa,iBAAiB,CAAC,qBAAqB,CAAE,YAAW,gBAAgB;aACjD,QAAQ,EAAE,SAAS;aAAkB,OAAO,EAAE,qBAAqB;gBAAnE,QAAQ,EAAE,SAAS,EAAkB,OAAO,EAAE,qBAAqB;IAC/F,MAAM,eAAwG;CACjH;AAED,qBAAa,qBAAqB,CAAC,iBAAiB,CAAE,YAAW,gBAAgB;aACjD,QAAQ,EAAE,SAAS;aAAkB,OAAO,EAAE,iBAAiB;gBAA/D,QAAQ,EAAE,SAAS,EAAkB,OAAO,EAAE,iBAAiB;IAC3F,MAAM,eAA4G;CACrH;AAED,qBAAa,kBAAmB,YAAW,gBAAgB;aAC3B,QAAQ,EAAE,SAAS;aAAkB,KAAK,EAAE,KAAK;gBAAjD,QAAQ,EAAE,SAAS,EAAkB,KAAK,EAAE,KAAK;IAC7E,MAAM,eAAsI;CAC/I;AAED,qBAAa,oCAAqC,YAAW,gBAAgB;aAC7C,QAAQ,EAAE,SAAS;aAAkB,oBAAoB,EAAE,SAAS;gBAApE,QAAQ,EAAE,SAAS,EAAkB,oBAAoB,EAAE,SAAS;IAChG,MAAM,eAAuL;CAChM;AAED,qBAAa,gBAAiB,YAAW,gBAAgB;aACzB,QAAQ,EAAE,SAAS;aAAkB,OAAO,EAAE,MAAM;gBAApD,QAAQ,EAAE,SAAS,EAAkB,OAAO,EAAE,MAAM;IAChF,MAAM,eAAkF;CAC3F;AAED,qBAAa,yBAAyB,CAAC,eAAe,EAAE,gBAAgB,CAAE,YAAW,gBAAgB;aACrE,aAAa,EAAE,OAAO,CAAC,eAAe,CAAC;aAAkB,OAAO,EAAE,gBAAgB;gBAAlF,aAAa,EAAE,OAAO,CAAC,eAAe,CAAC,EAAkB,OAAO,EAAE,gBAAgB;IAC9G,MAAM,eAA4N;CACrO;AAGD,eAAO,MAAM,yBAAyB,GAAI,kBAAkB,gBAAgB,EAAE,SAI7E,CAAA;AAED,eAAO,MAAM,qBAAqB,QAAO,CAAC,cAAc,EAAE,cAAc,EAAE,gBAAgB,EAAE,gBAAgB,EAAE,CAQ7G,CAAA"}

package/dist/logging/semantic-logging.js

@@ -0,0 +1,88 @@
+// 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 { asMinimalJsonString } from "@lionweb/ts-utils";
+import { ansi } from "./ansi.js";
+const { clientInfo, clientWarning, repositoryInfo, withColorAndStyleApplied } = ansi;
+export const semanticNoOpLogger = (_) => { };
+export const semanticLoggerFunctionFrom = (optionalSemanticLogger) => optionalSemanticLogger ?? semanticNoOpLogger;
+export const semanticConsoleLogger = (semanticLogItem) => {
+    console.log(semanticLogItem.asText());
+};
+export class DeltaOccurredOnClient {
+    constructor(clientId, serializedDelta) {
+        this.clientId = clientId;
+        this.serializedDelta = serializedDelta;
+        this.asText = () => `${clientInfo(`delta occurred on client "${this.clientId}"`)}: ${asMinimalJsonString(this.serializedDelta)}`;
+    }
+}
+export class ClientSentMessage {
+    constructor(clientId, message) {
+        this.clientId = clientId;
+        this.message = message;
+        this.asText = () => `${clientInfo(`client "${this.clientId}" sent message`)}: ${asMinimalJsonString(this.message)}`;
+    }
+}
+export class ClientReceivedMessage {
+    constructor(clientId, message) {
+        this.clientId = clientId;
+        this.message = message;
+        this.asText = () => `${clientInfo(`client "${this.clientId}" received message`)}: ${asMinimalJsonString(this.message)}`;
+    }
+}
+export class ClientAppliedEvent {
+    constructor(clientId, event) {
+        this.clientId = clientId;
+        this.event = event;
+        this.asText = () => `${clientInfo(`client "${this.clientId}" applied (the delta from) the following event`)}: ${asMinimalJsonString(this.event)}`;
+    }
+}
+export class ClientDidNotApplyEventFromOwnCommand {
+    constructor(clientId, originatingCommandId) {
+        this.clientId = clientId;
+        this.originatingCommandId = originatingCommandId;
+        this.asText = () => clientWarning(`client "${this.clientId}" didn't apply (the delta from) an event because it's the result of a command (with ID="${this.originatingCommandId}") it sent itself`);
+    }
+}
+export class ClientHadProblem {
+    constructor(clientId, message) {
+        this.clientId = clientId;
+        this.message = message;
+        this.asText = () => clientWarning(`client "${this.clientId}" had a problem: ${this.message}`);
+    }
+}
+export class RepositoryReceivedMessage {
+    constructor(knownMetadata, message) {
+        this.knownMetadata = knownMetadata;
+        this.message = message;
+        this.asText = () => `${repositoryInfo(`repository received message`)} ${withColorAndStyleApplied("magenta", "default")(`(client's known metadata: ${asMinimalJsonString(this.knownMetadata)})`)}: ${asMinimalJsonString(this.message)}`;
+    }
+}
+export const semanticLogItemsToConsole = (semanticLogItems) => {
+    semanticLogItems.forEach((logItem) => {
+        console.log(logItem.asText());
+    });
+};
+export const semanticLogItemStorer = () => {
+    const items = [];
+    return [
+        (semanticLogItem) => {
+            items.push(semanticLogItem);
+        },
+        items
+    ];
+};
+//# sourceMappingURL=semantic-logging.js.map

package/dist/logging/semantic-logging.js.map

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

package/dist/logging/textual-logging.d.ts

@@ -0,0 +1,22 @@
+export type TextualLogger = (message: string, error?: boolean) => void;
+/**
+ * A {@link TextualLogger textual logger} that simply logs to the console.
+ */
+export declare const simpleConsoleLogger: TextualLogger;
+/**
+ * A {@link TextualLogger textual logger} that does nothing.
+ */
+export declare const noOpTextualLogger: TextualLogger;
+/**
+ * @return a {@link TextualLogger textual logger} which is either the given one, or the noOpTextualLogger.
+ */
+export declare const textualLoggerFunctionFrom: (optionalLogger?: TextualLogger) => TextualLogger;
+/**
+ * Prefixes all messages passed to the given {@link TextualLogger textual logger} with the given prefix.
+ */
+export declare const prefixedWith: (logger: TextualLogger, prefix: string) => TextualLogger;
+/**
+ * A {@link TextualLogger textual logger} that logs to the console, also showing the time elapsed since the creation of it.
+ */
+export declare const timedConsoleLogger: (unit: "ns" | "\u00B5s" | "ms" | "s") => TextualLogger;
+//# sourceMappingURL=textual-logging.d.ts.map

package/dist/logging/textual-logging.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"textual-logging.d.ts","sourceRoot":"","sources":["../../src/logging/textual-logging.ts"],"names":[],"mappings":"AAiBA,MAAM,MAAM,aAAa,GAAG,CAAC,OAAO,EAAE,MAAM,EAAE,KAAK,CAAC,EAAE,OAAO,KAAK,IAAI,CAAA;AAEtE;;GAEG;AACH,eAAO,MAAM,mBAAmB,EAAE,aAEjC,CAAA;AAED;;GAEG;AACH,eAAO,MAAM,iBAAiB,EAAE,aAA6B,CAAA;AAE7D;;GAEG;AACH,eAAO,MAAM,yBAAyB,GAAI,iBAAiB,aAAa,KAAG,aACpC,CAAA;AAEvC;;GAEG;AACH,eAAO,MAAM,YAAY,GAAI,QAAQ,aAAa,EAAE,QAAQ,MAAM,KAAG,aACT,CAAA;AAU5D;;GAEG;AACH,eAAO,MAAM,kBAAkB,GAAI,MAAM,IAAI,GAAG,SAAI,GAAG,IAAI,GAAG,GAAG,KAAG,aASnE,CAAA"}

package/dist/logging/textual-logging.js

@@ -0,0 +1,54 @@
+// 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
+/**
+ * A {@link TextualLogger textual logger} that simply logs to the console.
+ */
+export const simpleConsoleLogger = (message, isError) => {
+    (isError ? console.error : console.log)(message);
+};
+/**
+ * A {@link TextualLogger textual logger} that does nothing.
+ */
+export const noOpTextualLogger = (_, __) => { };
+/**
+ * @return a {@link TextualLogger textual logger} which is either the given one, or the noOpTextualLogger.
+ */
+export const textualLoggerFunctionFrom = (optionalLogger) => optionalLogger ?? noOpTextualLogger;
+/**
+ * Prefixes all messages passed to the given {@link TextualLogger textual logger} with the given prefix.
+ */
+export const prefixedWith = (logger, prefix) => (message, error) => logger(`${prefix}${message}`, error);
+const unit2divider = {
+    "ns": 1n,
+    "µs": 1000n,
+    "ms": 1000000n,
+    "s": 1000000000n
+};
+/**
+ * A {@link TextualLogger textual logger} that logs to the console, also showing the time elapsed since the creation of it.
+ */
+export const timedConsoleLogger = (unit) => {
+    if (!(unit in unit2divider)) {
+        throw new Error(`unknown time unit: "${unit}"`);
+    }
+    const divider = unit2divider[unit];
+    const start = process.hrtime.bigint();
+    return (message, isError) => {
+        (isError ? console.error : console.log)(`{${((process.hrtime.bigint() - start) / divider).toLocaleString()}${unit}} ${message}`);
+    };
+};
+//# sourceMappingURL=textual-logging.js.map

package/dist/logging/textual-logging.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"textual-logging.js","sourceRoot":"","sources":["../../src/logging/textual-logging.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;AAItC;;GAEG;AACH,MAAM,CAAC,MAAM,mBAAmB,GAAkB,CAAC,OAAO,EAAE,OAAO,EAAE,EAAE;IACnE,CAAC,OAAO,CAAC,CAAC,CAAC,OAAO,CAAC,KAAK,CAAC,CAAC,CAAC,OAAO,CAAC,GAAG,CAAC,CAAC,OAAO,CAAC,CAAA;AACpD,CAAC,CAAA;AAED;;GAEG;AACH,MAAM,CAAC,MAAM,iBAAiB,GAAkB,CAAC,CAAC,EAAE,EAAE,EAAE,EAAE,GAAE,CAAC,CAAA;AAE7D;;GAEG;AACH,MAAM,CAAC,MAAM,yBAAyB,GAAG,CAAC,cAA8B,EAAiB,EAAE,CACvF,cAAc,IAAI,iBAAiB,CAAA;AAEvC;;GAEG;AACH,MAAM,CAAC,MAAM,YAAY,GAAG,CAAC,MAAqB,EAAE,MAAc,EAAiB,EAAE,CACjF,CAAC,OAAO,EAAE,KAAK,EAAE,EAAE,CAAC,MAAM,CAAC,GAAG,MAAM,GAAG,OAAO,EAAE,EAAE,KAAK,CAAC,CAAA;AAG5D,MAAM,YAAY,GAA6B;IAC3C,IAAI,EAAE,EAAE;IACR,IAAI,EAAE,KAAK;IACX,IAAI,EAAE,QAAS;IACf,GAAG,EAAE,WAAa;CACZ,CAAA;AAEV;;GAEG;AACH,MAAM,CAAC,MAAM,kBAAkB,GAAG,CAAC,IAA8B,EAAiB,EAAE;IAChF,IAAI,CAAC,CAAC,IAAI,IAAI,YAAY,CAAC,EAAE,CAAC;QAC1B,MAAM,IAAI,KAAK,CAAC,uBAAuB,IAAI,GAAG,CAAC,CAAA;IACnD,CAAC;IACD,MAAM,OAAO,GAAG,YAAY,CAAC,IAAI,CAAC,CAAA;IAClC,MAAM,KAAK,GAAG,OAAO,CAAC,MAAM,CAAC,MAAM,EAAE,CAAA;IACrC,OAAO,CAAC,OAAO,EAAE,OAAO,EAAE,EAAE;QACxB,CAAC,OAAO,CAAC,CAAC,CAAC,OAAO,CAAC,KAAK,CAAC,CAAC,CAAC,OAAO,CAAC,GAAG,CAAC,CAAC,IAAI,CAAC,CAAC,OAAO,CAAC,MAAM,CAAC,MAAM,EAAE,GAAG,KAAK,CAAC,GAAC,OAAO,CAAC,CAAC,cAAc,EAAE,GAAG,IAAI,KAAK,OAAO,EAAE,CAAC,CAAA;IAClI,CAAC,CAAA;AACL,CAAC,CAAA"}