@lionweb/ts-utils 0.6.13-beta.5 → 0.7.0-beta.0

package/CHANGELOG.md

@@ -1,4 +1,6 @@
 # Changelog
 
-## 0.6.13
+## 0.7.0
+
+Initial creation and publication of this package, as an extraction and de-duplication from `@lionweb/core`, `@lionweb/utilities`, `@lionweb/class-core`, and `@lionweb/validation`.
 

package/README.md

@@ -12,9 +12,8 @@ An NPM package that can be added to a Node.js/NPM codebase as follows:
 ```shell
 $ npm add @lionweb/ts-utils
 ```
-It contains:
 
-* Utilities ...
+It contains general TypeScript utilities, e.g. for working with maps and such.
 
 
 ## Development

package/dist/index.d.ts

@@ -4,6 +4,7 @@ export * from "./graphs.js";
 export * from "./map-helpers.js";
 export * from "./nested-map.js";
 export * from "./recursion.js";
-export * from "./sorting.js";
+export * from "./string-sorting.js";
 export * from "./string-mapping.js";
+export * from "./toposort.js";
 //# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,cAAc,oBAAoB,CAAA;AAClC,cAAc,aAAa,CAAA;AAC3B,cAAc,aAAa,CAAA;AAC3B,cAAc,kBAAkB,CAAA;AAChC,cAAc,iBAAiB,CAAA;AAC/B,cAAc,gBAAgB,CAAA;AAC9B,cAAc,cAAc,CAAA;AAC5B,cAAc,qBAAqB,CAAA"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,cAAc,oBAAoB,CAAA;AAClC,cAAc,aAAa,CAAA;AAC3B,cAAc,aAAa,CAAA;AAC3B,cAAc,kBAAkB,CAAA;AAChC,cAAc,iBAAiB,CAAA;AAC/B,cAAc,gBAAgB,CAAA;AAC9B,cAAc,qBAAqB,CAAA;AACnC,cAAc,qBAAqB,CAAA;AACnC,cAAc,eAAe,CAAA"}

package/dist/index.js

@@ -4,6 +4,7 @@ export * from "./graphs.js";
 export * from "./map-helpers.js";
 export * from "./nested-map.js";
 export * from "./recursion.js";
-export * from "./sorting.js";
+export * from "./string-sorting.js";
 export * from "./string-mapping.js";
+export * from "./toposort.js";
 //# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,cAAc,oBAAoB,CAAA;AAClC,cAAc,aAAa,CAAA;AAC3B,cAAc,aAAa,CAAA;AAC3B,cAAc,kBAAkB,CAAA;AAChC,cAAc,iBAAiB,CAAA;AAC/B,cAAc,gBAAgB,CAAA;AAC9B,cAAc,cAAc,CAAA;AAC5B,cAAc,qBAAqB,CAAA"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,cAAc,oBAAoB,CAAA;AAClC,cAAc,aAAa,CAAA;AAC3B,cAAc,aAAa,CAAA;AAC3B,cAAc,kBAAkB,CAAA;AAChC,cAAc,iBAAiB,CAAA;AAC/B,cAAc,gBAAgB,CAAA;AAC9B,cAAc,qBAAqB,CAAA;AACnC,cAAc,qBAAqB,CAAA;AACnC,cAAc,eAAe,CAAA"}

package/dist/string-sorting.d.ts

@@ -0,0 +1,8 @@
+/**
+ * Various functional utilities for sorting things.
+ */
+export declare const sortByStringKey: <T>(ts: T[], keyFunc: (t: T) => string) => T[];
+export type StringSorter = (strings: string[]) => string[];
+export declare const sortedStrings: StringSorter;
+export declare const sortedStringsByUppercase: StringSorter;
+//# sourceMappingURL=string-sorting.d.ts.map

package/dist/string-sorting.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"string-sorting.d.ts","sourceRoot":"","sources":["../src/string-sorting.ts"],"names":[],"mappings":"AAAA;;GAEG;AAWH,eAAO,MAAM,eAAe,kCAAmC,MAAM,QAC5B,CAAA;AAGzC,MAAM,MAAM,YAAY,GAAG,CAAC,OAAO,EAAE,MAAM,EAAE,KAAK,MAAM,EAAE,CAAA;AAQ1D,eAAO,MAAM,aAAa,cAAkC,CAAA;AAE5D,eAAO,MAAM,wBAAwB,cAAgD,CAAA"}

package/dist/string-sorting.js

@@ -0,0 +1,13 @@
+/**
+ * Various functional utilities for sorting things.
+ */
+const stringCompare = (l, r) => l === r ? 0 : (l > r ? 1 : -1);
+const stringyCompare = (keyFunc) => (l, r) => stringCompare(keyFunc(l), keyFunc(r));
+export const sortByStringKey = (ts, keyFunc) => [...ts].sort(stringyCompare(keyFunc));
+const sortedStringsWith = (strMap) => (strings) => {
+    strings.sort((l, r) => strMap(l).localeCompare(strMap(r)));
+    return strings;
+};
+export const sortedStrings = sortedStringsWith((str) => str);
+export const sortedStringsByUppercase = sortedStringsWith((str) => str.toUpperCase());
+//# sourceMappingURL=string-sorting.js.map

package/dist/string-sorting.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"string-sorting.js","sourceRoot":"","sources":["../src/string-sorting.ts"],"names":[],"mappings":"AAAA;;GAEG;AAKH,MAAM,aAAa,GAAqB,CAAC,CAAC,EAAE,CAAC,EAAU,EAAE,CACrD,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAA;AAElC,MAAM,cAAc,GAAG,CAAI,OAAyB,EAAe,EAAE,CACjE,CAAC,CAAI,EAAE,CAAI,EAAE,EAAE,CAAC,aAAa,CAAC,OAAO,CAAC,CAAC,CAAC,EAAE,OAAO,CAAC,CAAC,CAAC,CAAC,CAAA;AAEzD,MAAM,CAAC,MAAM,eAAe,GAAG,CAAI,EAAO,EAAE,OAAyB,EAAE,EAAE,CACrE,CAAC,GAAG,EAAE,CAAC,CAAC,IAAI,CAAC,cAAc,CAAC,OAAO,CAAC,CAAC,CAAA;AAKzC,MAAM,iBAAiB,GAAG,CAAC,MAA+B,EAAgB,EAAE,CACxE,CAAC,OAAO,EAAE,EAAE;IACR,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC,EAAE,EAAE,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC,aAAa,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC,CAAC,CAAA;IAC1D,OAAO,OAAO,CAAA;AAClB,CAAC,CAAA;AAEL,MAAM,CAAC,MAAM,aAAa,GAAG,iBAAiB,CAAC,CAAC,GAAG,EAAE,EAAE,CAAC,GAAG,CAAC,CAAA;AAE5D,MAAM,CAAC,MAAM,wBAAwB,GAAG,iBAAiB,CAAC,CAAC,GAAG,EAAE,EAAE,CAAC,GAAG,CAAC,WAAW,EAAE,CAAC,CAAA"}

package/dist/toposort.d.ts

@@ -0,0 +1,6 @@
+/**
+ * Computes the topological order of the transitive closure of the graph with the given vertices and edges given by the edge function,
+ * or returns {@code false} if there's a cycle.
+ */
+export declare const dependencyOrderOf: <T>(vertices: T[], edgesOf: (vertex: T) => T[]) => false | T[];
+//# sourceMappingURL=toposort.d.ts.map

package/dist/toposort.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"toposort.d.ts","sourceRoot":"","sources":["../src/toposort.ts"],"names":[],"mappings":"AAiBA;;;GAGG;AACH,eAAO,MAAM,iBAAiB,gEA0B7B,CAAA"}

package/dist/toposort.js

@@ -0,0 +1,41 @@
+// 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
+/**
+ * Computes the topological order of the transitive closure of the graph with the given vertices and edges given by the edge function,
+ * or returns {@code false} if there's a cycle.
+ */
+export const dependencyOrderOf = (vertices, edgesOf) => {
+    const ordered = [];
+    const visit = (current, chain) => {
+        if (ordered.indexOf(current) > -1) {
+            return false;
+        }
+        if (chain.indexOf(current) > -1) {
+            return true;
+        }
+        const extendedChain = [...chain, current];
+        const hasCycle = edgesOf(current).some((edge) => visit(edge, extendedChain));
+        ordered.push(current);
+        if (hasCycle) {
+            console.dir(ordered);
+        }
+        return hasCycle;
+    };
+    const hasCycle = vertices.some((vertex) => visit(vertex, []));
+    return hasCycle ? false : ordered;
+};
+//# sourceMappingURL=toposort.js.map

package/dist/toposort.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"toposort.js","sourceRoot":"","sources":["../src/toposort.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;;;GAGG;AACH,MAAM,CAAC,MAAM,iBAAiB,GAAG,CAAI,QAAa,EAAE,OAA2B,EAAe,EAAE;IAC5F,MAAM,OAAO,GAAQ,EAAE,CAAA;IAEvB,MAAM,KAAK,GAAG,CAAC,OAAU,EAAE,KAAU,EAAE,EAAE;QACrC,IAAI,OAAO,CAAC,OAAO,CAAC,OAAO,CAAC,GAAG,CAAC,CAAC,EAAE,CAAC;YAChC,OAAO,KAAK,CAAA;QAChB,CAAC;QACD,IAAI,KAAK,CAAC,OAAO,CAAC,OAAO,CAAC,GAAG,CAAC,CAAC,EAAE,CAAC;YAC9B,OAAO,IAAI,CAAA;QACf,CAAC;QACD,MAAM,aAAa,GAAG,CAAE,GAAG,KAAK,EAAE,OAAO,CAAE,CAAA;QAC3C,MAAM,QAAQ,GAAG,OAAO,CAAC,OAAO,CAAC,CAAC,IAAI,CAClC,CAAC,IAAI,EAAE,EAAE,CAAC,KAAK,CAAC,IAAI,EAAE,aAAa,CAAC,CACvC,CAAA;QACD,OAAO,CAAC,IAAI,CAAC,OAAO,CAAC,CAAA;QACrB,IAAI,QAAQ,EAAE,CAAC;YACX,OAAO,CAAC,GAAG,CAAC,OAAO,CAAC,CAAA;QACxB,CAAC;QACD,OAAO,QAAQ,CAAA;IACnB,CAAC,CAAA;IAED,MAAM,QAAQ,GAAG,QAAQ,CAAC,IAAI,CAC1B,CAAC,MAAM,EAAE,EAAE,CAAC,KAAK,CAAC,MAAM,EAAE,EAAE,CAAC,CAChC,CAAA;IAED,OAAO,QAAQ,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,OAAO,CAAA;AACrC,CAAC,CAAA"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@lionweb/ts-utils",
-  "version": "0.6.13-beta.5",
+  "version": "0.7.0-beta.0",
   "description": "Utilities for LionWeb JSON",
   "main": "dist/index.js",
   "types": "dist/index.d.ts",
@@ -15,7 +15,7 @@
     "url": "https://github.com/LionWeb-io/lionweb-typescript/issues"
   },
   "scripts": {
-    "clean": "rm -rf dist/ lionweb-ts-utils-*.tgz",
+    "clean": "rm -rf dist/ node_modules/ lionweb-ts-utils-*.tgz",
     "build": "tsc",
     "lint": "eslint src",
     "pre-release-either": "npm run clean && npm install && npm run build",

package/dist/sorting.d.ts

@@ -1,7 +0,0 @@
-/**
- * Various functional utilities for sorting things.
- */
-export type Comparer<T> = (l: T, r: T) => number;
-export declare const stringyCompare: <T>(keyFunc: (t: T) => string) => Comparer<T>;
-export declare const sortByStringKey: <T>(ts: T[], keyFunc: (t: T) => string) => T[];
-//# sourceMappingURL=sorting.d.ts.map

package/dist/sorting.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"sorting.d.ts","sourceRoot":"","sources":["../src/sorting.ts"],"names":[],"mappings":"AAAA;;GAEG;AAGH,MAAM,MAAM,QAAQ,CAAC,CAAC,IAAI,CAAC,CAAC,EAAE,CAAC,EAAE,CAAC,EAAE,CAAC,KAAK,MAAM,CAAA;AAKhD,eAAO,MAAM,cAAc,yBAA0B,MAAM,gBACF,CAAA;AAEzD,eAAO,MAAM,eAAe,kCAAmC,MAAM,QAC5B,CAAA"}

package/dist/sorting.js

@@ -1,7 +0,0 @@
-/**
- * Various functional utilities for sorting things.
- */
-const stringCompare = (l, r) => l === r ? 0 : (l > r ? 1 : -1);
-export const stringyCompare = (keyFunc) => (l, r) => stringCompare(keyFunc(l), keyFunc(r));
-export const sortByStringKey = (ts, keyFunc) => [...ts].sort(stringyCompare(keyFunc));
-//# sourceMappingURL=sorting.js.map

package/dist/sorting.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"sorting.js","sourceRoot":"","sources":["../src/sorting.ts"],"names":[],"mappings":"AAAA;;GAEG;AAKH,MAAM,aAAa,GAAqB,CAAC,CAAC,EAAE,CAAC,EAAU,EAAE,CACrD,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAA;AAElC,MAAM,CAAC,MAAM,cAAc,GAAG,CAAI,OAAyB,EAAe,EAAE,CACxE,CAAC,CAAI,EAAE,CAAI,EAAE,EAAE,CAAC,aAAa,CAAC,OAAO,CAAC,CAAC,CAAC,EAAE,OAAO,CAAC,CAAC,CAAC,CAAC,CAAA;AAEzD,MAAM,CAAC,MAAM,eAAe,GAAG,CAAI,EAAO,EAAE,OAAyB,EAAE,EAAE,CACrE,CAAC,GAAG,EAAE,CAAC,CAAC,IAAI,CAAC,cAAc,CAAC,OAAO,CAAC,CAAC,CAAA"}