One kit. Every Versable screen.

import { listToMap, getHumanReadableNumber, truncateMiddle, getRelativeTime } from "@versable-git/toolkit";
const rows = [{ id: "x", n: 1 }, { id: "y", n: 2 }];
// Build an id-lookup map from a list (the default key)
listToMap(rows);
// { x: { id: "x", n: 1 }, y: { id: "y", n: 2 } }
// Key by any other field on the row
listToMap(rows, "n");
// { 1: { id: "x", n: 1 }, 2: { id: "y", n: 2 } }
// Shape each value with a transform, not just the key
listToMap(rows, "id", (r) => r.n);
// { x: 1, y: 2 }
// Compact a raw count for a stat tile or a table cell
getHumanReadableNumber(1500);
// "1.5K"
getHumanReadableNumber(2340000);
// "2.3M"
// Keep a long filename recognizable at a fixed width
truncateMiddle("a-very-long-generated-filename-from-the-pipeline.csv", 24);
// "a-very-long...peline.csv"
// "5 minutes ago", not a raw timestamp
const fiveMinutesAgo = new Date(Date.now() - 5 * 60 * 1000);
getRelativeTime(fiveMinutesAgo);
// "5 minutes ago"

import { applyOps, createUrlSyncAdapter } from "@versable-git/qsync";
const base = new URLSearchParams("a=1&b=2");
// Delete a key by writing null
applyOps(base, new Map([["a", null]]));
// "b=2" (base itself is untouched: applyOps returns a copy)
// Add a brand-new key
applyOps(base, new Map([["c", "3"]]));
// "a=1&b=2&c=3"
// Delete and add in the same batch
applyOps(base, new Map([["a", null], ["c", "3"]]));
// "b=2&c=3"
// createUrlSyncAdapter owns the batching: writes made in the same
// tick coalesce into ONE commit, never one per write
const adapter = createUrlSyncAdapter({
  read: () => "sort=name",
  commit: (next) => console.log("commit:", next.toString()),
});
adapter.write("dir", "asc");
adapter.write("dir", "desc"); // last write to a key wins
adapter.read("dir");
// "desc" (a read before the flush still sees the pending value)
await Promise.resolve(); // one microtask later, the batch flushes
// commit: "sort=name&dir=desc", a single commit call, not two