@weborigami/async-tree 0.0.68 → 0.0.70

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@weborigami/async-tree",
-  "version": "0.0.68",
+  "version": "0.0.70",
   "description": "Asynchronous tree drivers based on standard JavaScript classes",
   "type": "module",
   "main": "./main.js",
@@ -11,7 +11,7 @@
     "typescript": "5.6.2"
   },
   "dependencies": {
-    "@weborigami/types": "0.0.68"
+    "@weborigami/types": "0.0.70"
   },
   "scripts": {
     "test": "node --test --test-reporter=spec",

package/src/utilities.d.ts

@@ -11,6 +11,7 @@ export function isStringLike(obj: any): obj is StringLike;
 export function isUnpackable(obj): obj is { unpack: () => any };
 export function keysFromPath(path: string): string[];
 export const naturalOrder: (a: string, b: string) => number;
+export function pathFromKeys(keys: string[]): string;
 export function pipeline(start: any, ...functions: Function[]): Promise<any>;
 export function setParent(child: any, parent: AsyncTree): void;
 export function toPlainValue(object: any): Promise<any>;

package/src/utilities.js

@@ -210,6 +210,19 @@ export const naturalOrder = new Intl.Collator(undefined, {
   numeric: true,
 }).compare;
 
+/**
+ * Return a slash-separated path for the given keys.
+ *
+ * This takes care to avoid adding consecutive slashes if they keys themselves
+ * already have trailing slashes.
+ *
+ * @param {string[]} keys
+ */
+export function pathFromKeys(keys) {
+  const normalized = keys.map((key) => trailingSlash.remove(key));
+  return normalized.join("/");
+}
+
 /**
  * Apply a series of functions to a value, passing the result of each function
  * to the next one.

package/test/utilities.test.js

@@ -55,6 +55,12 @@ describe("utilities", () => {
     assert.deepEqual(strings, ["file1", "file9", "file10"]);
   });
 
+  test("pathFromKeys() returns a slash-separated path from keys", () => {
+    assert.equal(utilities.pathFromKeys([]), "");
+    assert.equal(utilities.pathFromKeys(["a", "b", "c"]), "a/b/c");
+    assert.equal(utilities.pathFromKeys(["a/", "b/", "c"]), "a/b/c");
+  });
+
   test("pipeline applies a series of functions to a value", async () => {
     const addOne = (n) => n + 1;
     const double = (n) => n * 2;