@forthtilliath/ts-kit 0.6.0 → 0.7.0

package/README.md

@@ -46,6 +46,9 @@ import { chunk } from "@forthtilliath/ts-kit/array/chunk";
 - `rankByNameMatch(items, query, getName)` — ranks `items` by relevance to
   `query`: earlier match position first, then shorter name — for a
   search-as-you-type list.
+- `swapItems(items, i, j)` — copy of `items` with the elements at `i` and `j`
+  swapped (e.g. moving an item up/down) — a plain copy if either position is
+  out of bounds.
 
 ### `async`
 

package/dist/array/index.d.ts

@@ -3,4 +3,5 @@ export * from "./flattenDeep.js";
 export * from "./getMostRecentIds.js";
 export * from "./nextInCycle.js";
 export * from "./rankByNameMatch.js";
+export * from "./swapItems.js";
 //# sourceMappingURL=index.d.ts.map

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

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/array/index.ts"],"names":[],"mappings":"AAAA,cAAc,YAAY,CAAC;AAC3B,cAAc,kBAAkB,CAAC;AACjC,cAAc,uBAAuB,CAAC;AACtC,cAAc,kBAAkB,CAAC;AACjC,cAAc,sBAAsB,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/array/index.ts"],"names":[],"mappings":"AAAA,cAAc,YAAY,CAAC;AAC3B,cAAc,kBAAkB,CAAC;AACjC,cAAc,uBAAuB,CAAC;AACtC,cAAc,kBAAkB,CAAC;AACjC,cAAc,sBAAsB,CAAC;AACrC,cAAc,gBAAgB,CAAC"}

package/dist/array/index.js

@@ -3,3 +3,4 @@ export * from "./flattenDeep.js";
 export * from "./getMostRecentIds.js";
 export * from "./nextInCycle.js";
 export * from "./rankByNameMatch.js";
+export * from "./swapItems.js";

package/dist/array/swapItems.d.ts

@@ -0,0 +1,16 @@
+/**
+ * Returns a copy of `items` with the elements at positions `i` and `j`
+ * swapped (e.g. moving an item up or down in a reorderable list). Never
+ * mutates `items`, and stays sound under `noUncheckedIndexedAccess`.
+ *
+ * @param items - The array to copy.
+ * @param i - The position of the first element.
+ * @param j - The position of the second element.
+ * @returns A new array with both elements swapped, or a plain copy if either
+ * position is out of bounds.
+ * @example
+ * swapItems(["a", "b", "c"], 0, 2); // => ["c", "b", "a"]
+ * swapItems(["a", "b", "c"], 0, 5); // => ["a", "b", "c"]
+ */
+export declare function swapItems<T>(items: readonly T[], i: number, j: number): T[];
+//# sourceMappingURL=swapItems.d.ts.map

package/dist/array/swapItems.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"swapItems.d.ts","sourceRoot":"","sources":["../../src/array/swapItems.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;GAaG;AACH,wBAAgB,SAAS,CAAC,CAAC,EAAE,KAAK,EAAE,SAAS,CAAC,EAAE,EAAE,CAAC,EAAE,MAAM,EAAE,CAAC,EAAE,MAAM,GAAG,CAAC,EAAE,CAQ3E"}

package/dist/array/swapItems.js

@@ -0,0 +1,24 @@
+/**
+ * Returns a copy of `items` with the elements at positions `i` and `j`
+ * swapped (e.g. moving an item up or down in a reorderable list). Never
+ * mutates `items`, and stays sound under `noUncheckedIndexedAccess`.
+ *
+ * @param items - The array to copy.
+ * @param i - The position of the first element.
+ * @param j - The position of the second element.
+ * @returns A new array with both elements swapped, or a plain copy if either
+ * position is out of bounds.
+ * @example
+ * swapItems(["a", "b", "c"], 0, 2); // => ["c", "b", "a"]
+ * swapItems(["a", "b", "c"], 0, 5); // => ["a", "b", "c"]
+ */
+export function swapItems(items, i, j) {
+    const next = [...items];
+    const a = next[i];
+    const b = next[j];
+    if (a === undefined || b === undefined)
+        return next;
+    next[i] = b;
+    next[j] = a;
+    return next;
+}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@forthtilliath/ts-kit",
-  "version": "0.6.0",
+  "version": "0.7.0",
   "type": "module",
   "license": "MIT",
   "publishConfig": {
@@ -26,8 +26,8 @@
     "jsdom": "^29.1.1",
     "typescript": "^5.9.3",
     "vitest": "^4.1.10",
-    "@forthtilliath/eslint-config": "0.5.0",
-    "@forthtilliath/typescript-config": "0.0.0"
+    "@forthtilliath/typescript-config": "0.1.1",
+    "@forthtilliath/eslint-config": "0.7.0"
   },
   "scripts": {
     "dev": "tsc --watch -p tsconfig.build.json",