waterplane 0.0.1 → 0.1.6

package/node_modules/@waterplane/shared/dist/queue/queuewords.js

@@ -0,0 +1,55 @@
+// Cut from queue.ts (move only): why nothing is sending
+// The one door stays `./queue.js`; this slice imports its siblings directly, never the barrel.
+import { SERIAL_WAIT_TEXT } from "./queueserial.js";
+/** The sentence for one block reason. Wording lives here so every surface that
+ *  explains a stuck queue says the same thing. */
+export function blockedReasonText(r) {
+    switch (r) {
+        case "budget": return "paused — the account is past your usage budget; it resumes when the window resets";
+        // "the repo's work items" was the retired name for rows in the shared
+        // per-repo conversation, which no longer exists — the same words, and the
+        // same fix, as `intent.ts`'s `GONE_SESSION`. Two copies of a sentence are
+        // two chances for one of them to keep saying the old thing.
+        case "sessionBudget": return "held — this session is over its own budget; raise or clear it to send";
+        case "sessionGone": return "that session is gone — aim it at another session or at the repo's backlog";
+        case "gate": return "queued — auto-send is off, tap Send now";
+        case "backoff": return "a send just failed — retrying in a moment";
+        case "held": return "held until the agent finishes this turn";
+        case "serial": return SERIAL_WAIT_TEXT;
+        case "pendingCreate": return "waiting for its session to open";
+        case "lane": return "another message for that session is going out first";
+        case "inflight": return "a delivery for that session is already in flight";
+    }
+}
+/**
+ * Why did nothing go out? — in one sentence, for a flush that sent zero.
+ *
+ * The bug this replaces: every caller of `flushOutbox()` treated a zero return
+ * as proof the link was down, and said "still offline — staying queued" over a
+ * header chip reading `open · 100.64.0.5`. The link was one of at least seven
+ * possible answers and usually not the right one.
+ *
+ * Precedence is by what the user can DO about it, not by queue order: the gate
+ * is a switch one tap away, a backoff clears itself, and the rest are facts
+ * about a session. `null` = nothing is stuck (nothing queued, or something did
+ * go out), so the caller stays silent rather than inventing reassurance.
+ */
+export function queueIdleReason(blocked, opts) {
+    if (!opts.online)
+        return "still offline — staying queued";
+    if (!opts.queued || !blocked.length)
+        return null;
+    // `budget` outranks everything but the user's own switch: it is the only
+    // reason here that is about the ACCOUNT rather than about one lane's position,
+    // so when it is true it is the answer for every row at once.
+    // `sessionGone` sits above the three self-resolving waits: it is the only
+    // reason here that never clears on its own.
+    const order = ["gate", "budget", "sessionBudget", "sessionGone", "backoff", "serial", "held", "pendingCreate", "lane", "inflight"];
+    // `serialText` is the caller's NAMED serial sentence (`serialWaitText`), when
+    // it could say who holds the repo; the generic line otherwise.
+    for (const r of order)
+        if (blocked.some((b) => b.reason === r))
+            return r === "serial" && opts.serialText ? opts.serialText : blockedReasonText(r);
+    return null;
+}
+//# sourceMappingURL=queuewords.js.map

package/node_modules/@waterplane/shared/dist/queue/queuewords.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"queuewords.js","sourceRoot":"","sources":["../../src/queue/queuewords.ts"],"names":[],"mappings":"AAAA,wDAAwD;AACxD,+FAA+F;AAG/F,OAAO,EAAE,gBAAgB,EAAE,MAAM,kBAAkB,CAAC;AAEpD;kDACkD;AAClD,MAAM,UAAU,iBAAiB,CAAC,CAAkB;IAClD,QAAQ,CAAC,EAAE,CAAC;QACV,KAAK,QAAQ,CAAC,CAAC,OAAO,mFAAmF,CAAC;QAC1G,sEAAsE;QACtE,0EAA0E;QAC1E,0EAA0E;QAC1E,4DAA4D;QAC5D,KAAK,eAAe,CAAC,CAAC,OAAO,uEAAuE,CAAC;QACrG,KAAK,aAAa,CAAC,CAAC,OAAO,2EAA2E,CAAC;QACvG,KAAK,MAAM,CAAC,CAAC,OAAO,yCAAyC,CAAC;QAC9D,KAAK,SAAS,CAAC,CAAC,OAAO,2CAA2C,CAAC;QACnE,KAAK,MAAM,CAAC,CAAC,OAAO,yCAAyC,CAAC;QAC9D,KAAK,QAAQ,CAAC,CAAC,OAAO,gBAAgB,CAAC;QACvC,KAAK,eAAe,CAAC,CAAC,OAAO,iCAAiC,CAAC;QAC/D,KAAK,MAAM,CAAC,CAAC,OAAO,qDAAqD,CAAC;QAC1E,KAAK,UAAU,CAAC,CAAC,OAAO,kDAAkD,CAAC;IAC7E,CAAC;AACH,CAAC;AAED;;;;;;;;;;;;GAYG;AACH,MAAM,UAAU,eAAe,CAC7B,OAAgC,EAChC,IAA8D;IAE9D,IAAI,CAAC,IAAI,CAAC,MAAM;QAAE,OAAO,gCAAgC,CAAC;IAC1D,IAAI,CAAC,IAAI,CAAC,MAAM,IAAI,CAAC,OAAO,CAAC,MAAM;QAAE,OAAO,IAAI,CAAC;IACjD,yEAAyE;IACzE,+EAA+E;IAC/E,6DAA6D;IAC7D,0EAA0E;IAC1E,4CAA4C;IAC5C,MAAM,KAAK,GAAsB,CAAC,MAAM,EAAE,QAAQ,EAAE,eAAe,EAAE,aAAa,EAAE,SAAS,EAAE,QAAQ,EAAE,MAAM,EAAE,eAAe,EAAE,MAAM,EAAE,UAAU,CAAC,CAAC;IACtJ,8EAA8E;IAC9E,+DAA+D;IAC/D,KAAK,MAAM,CAAC,IAAI,KAAK;QAAE,IAAI,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,MAAM,KAAK,CAAC,CAAC;YAAE,OAAO,CAAC,KAAK,QAAQ,IAAI,IAAI,CAAC,UAAU,CAAC,CAAC,CAAC,IAAI,CAAC,UAAU,CAAC,CAAC,CAAC,iBAAiB,CAAC,CAAC,CAAC,CAAC;IAClJ,OAAO,IAAI,CAAC;AACd,CAAC"}

package/node_modules/@waterplane/shared/dist/queue.d.ts

@@ -0,0 +1,13 @@
+export type { SendStatus, SendMode, SendQueueEntry, } from "./queue/queueentry.js";
+export { RETRY_BACKOFF_MS, RETRY_BACKOFF_MAX_MS, retryDelay, MIN_TRY_MS, RETRY_ROUND_MS, RETRY_ROUND_MAX_MS, roundDelay, uploadAttemptWasted, } from "./queue/queueretry.js";
+export { adoptReferencedUploads, danglingUploadRefs, answerInsertAt, } from "./queue/queueuploads.js";
+export { laneBusy, sessionWall, } from "./queue/queuelane.js";
+export type { LaneSessionState, SessionWall, } from "./queue/queuelane.js";
+export { selectSendable, } from "./queue/queueplan.js";
+export type { SelectSendableOpts, SendBlockReason, BlockedEntry, SendPlan, } from "./queue/queueplan.js";
+export { bindPendingSession, ownedPendingCreates, applyRelease, } from "./queue/queuebind.js";
+export { serialGroup, SERIAL_STARTUP_MS, busySerialGroups, sendEligible, serialHolders, serialLead, serialWaitText, SERIAL_WAIT_TEXT, } from "./queue/queueserial.js";
+export type { SerialSessionState, SerialWatch, SerialHolder, } from "./queue/queueserial.js";
+export { blockedReasonText, queueIdleReason, } from "./queue/queuewords.js";
+export { laneEntries, canRetarget, retargetEntry, moveInLane, } from "./queue/queueretarget.js";
+export type { RetargetableEntry, } from "./queue/queueretarget.js";

package/node_modules/@waterplane/shared/dist/queue.js

@@ -0,0 +1,44 @@
+// Send-queue scheduling — the pure half of the phone's offline outbox.
+//
+// Lives in `shared` (not in `web`) for one reason: it is the rule that keeps
+// queued text from being mangled, and a rule that matters needs a test. The web
+// bundle has no node-runnable build, `shared/dist` does — so `e2e-queue.mjs`
+// pins the ordering guarantees here directly instead of trusting a comment.
+//
+// ONE SEND PER SESSION AT A TIME. The queue is flat and global, but a PTY
+// composer is not: two messages written to the same session back-to-back are
+// concatenated into a single line ("fix the testsadd a changelog"), and the two
+// submitting Returns that follow then submit the mush plus a stray blank. That
+// is what happens whenever more than one message is typed while the tunnel is
+// down and the reconnect flush drains the queue at once. So a session is a
+// LANE: at most one entry in flight, the next released only once the previous
+// one is acked and its Return has gone out. Different sessions still drain
+// concurrently — they are independent terminals.
+//
+// Order within a lane is array order, which is queue order: a message typed
+// second must never overtake the one typed first.
+//
+// WHAT THIS IS NOT, SINCE THE INTENT STORE.
+// This module used to own *when* deferred work ran. It no longer does. The
+// host holds a durable Intent for every piece of work that waits (`intent.ts`,
+// `host/intents/`), keeps the full text for ever, and re-asks one ladder
+// (`intentVerdict`) about it. What is left here is a TRANSPORT: lanes, the
+// order within one, and the retry contract that makes an ackId safe to re-send.
+//
+// The one deletion that matters is the CLOCK. There is no `ttlMs` any more,
+// and nothing in this file expires anything. "queued too long" was a sentence
+// about a thirty-minute timer told for a failure that was never about time,
+// and it is what shredded prompts somebody had spent an evening on. Safe to
+// delete because at-most-once moved off the ack ledger's 45 minutes and onto a
+// store row that lives as long as the work does: an entry that cannot reach
+// the host is not expired, it is *waiting*, and its row says `offline` —
+// honestly, for as long as that stays true.
+export { RETRY_BACKOFF_MS, RETRY_BACKOFF_MAX_MS, retryDelay, MIN_TRY_MS, RETRY_ROUND_MS, RETRY_ROUND_MAX_MS, roundDelay, uploadAttemptWasted, } from "./queue/queueretry.js";
+export { adoptReferencedUploads, danglingUploadRefs, answerInsertAt, } from "./queue/queueuploads.js";
+export { laneBusy, sessionWall, } from "./queue/queuelane.js";
+export { selectSendable, } from "./queue/queueplan.js";
+export { bindPendingSession, ownedPendingCreates, applyRelease, } from "./queue/queuebind.js";
+export { serialGroup, SERIAL_STARTUP_MS, busySerialGroups, sendEligible, serialHolders, serialLead, serialWaitText, SERIAL_WAIT_TEXT, } from "./queue/queueserial.js";
+export { blockedReasonText, queueIdleReason, } from "./queue/queuewords.js";
+export { laneEntries, canRetarget, retargetEntry, moveInLane, } from "./queue/queueretarget.js";
+//# sourceMappingURL=queue.js.map

package/node_modules/@waterplane/shared/dist/queue.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"queue.js","sourceRoot":"","sources":["../src/queue.ts"],"names":[],"mappings":"AAAA,uEAAuE;AACvE,EAAE;AACF,6EAA6E;AAC7E,gFAAgF;AAChF,6EAA6E;AAC7E,4EAA4E;AAC5E,EAAE;AACF,0EAA0E;AAC1E,6EAA6E;AAC7E,gFAAgF;AAChF,+EAA+E;AAC/E,8EAA8E;AAC9E,2EAA2E;AAC3E,8EAA8E;AAC9E,2EAA2E;AAC3E,iDAAiD;AACjD,EAAE;AACF,4EAA4E;AAC5E,kDAAkD;AAClD,EAAE;AACF,4CAA4C;AAC5C,2EAA2E;AAC3E,+EAA+E;AAC/E,yEAAyE;AACzE,2EAA2E;AAC3E,gFAAgF;AAChF,EAAE;AACF,4EAA4E;AAC5E,8EAA8E;AAC9E,4EAA4E;AAC5E,4EAA4E;AAC5E,+EAA+E;AAC/E,4EAA4E;AAC5E,yEAAyE;AACzE,4CAA4C;AAU5C,OAAO,EACL,gBAAgB,EAChB,oBAAoB,EACpB,UAAU,EACV,UAAU,EACV,cAAc,EACd,kBAAkB,EAClB,UAAU,EACV,mBAAmB,GACpB,MAAM,uBAAuB,CAAC;AAC/B,OAAO,EACL,sBAAsB,EACtB,kBAAkB,EAClB,cAAc,GACf,MAAM,yBAAyB,CAAC;AACjC,OAAO,EACL,QAAQ,EACR,WAAW,GACZ,MAAM,sBAAsB,CAAC;AAK9B,OAAO,EACL,cAAc,GACf,MAAM,sBAAsB,CAAC;AAO9B,OAAO,EACL,kBAAkB,EAClB,mBAAmB,EACnB,YAAY,GACb,MAAM,sBAAsB,CAAC;AAC9B,OAAO,EACL,WAAW,EACX,iBAAiB,EACjB,gBAAgB,EAChB,YAAY,EAAE,aAAa,EAAE,UAAU,EAAE,cAAc,EAAE,gBAAgB,GAC1E,MAAM,wBAAwB,CAAC;AAKhC,OAAO,EACL,iBAAiB,EACjB,eAAe,GAChB,MAAM,uBAAuB,CAAC;AAC/B,OAAO,EACL,WAAW,EACX,WAAW,EACX,aAAa,EACb,UAAU,GACX,MAAM,0BAA0B,CAAC"}

package/node_modules/@waterplane/shared/dist/repocolor.d.ts

@@ -0,0 +1,159 @@
+/**
+ * **What colour a repo is** — the ring the hue comes from, the hash that picks
+ * one, and the answer a person may pin over it.
+ *
+ * The colour is load-bearing rather than decorative: it is what tells the
+ * launcher's group headers apart mid-scroll, what the session rows carry as a
+ * left stripe, and — since the tab strip — what identifies a tab at ~85 px,
+ * where the label is one word and an ellipsis. So it is the one part of the
+ * palette a person is allowed to overrule, and the one that has to be picked
+ * rather than hashed.
+ *
+ * **Why a RING and not the whole circle.** The first version was
+ * `hash * 137.508 % 360` — a golden-angle spread, which spreads CONSECUTIVE
+ * inputs and does nothing at all for arbitrary ones: two repo names hash to two
+ * arbitrary numbers, and two arbitrary numbers land 3° apart about as often as
+ * they land 100° apart. Measured on this machine, `myapp` and one worktree came
+ * out 9° apart — two greens nobody could tell from each other in a strip 30 px
+ * tall. A palette of hues chosen to be SEPARATE removes that failure by
+ * construction: two repos are either the same colour or they are 28° apart, and
+ * "the same" is a state the UI can see and offer to fix, while "nearly the
+ * same" is one it cannot.
+ *
+ * **Only the HUE is a fact about the repo.** How light and how saturated that
+ * hue has to be is a fact about the THEME and lives in `styles.css`
+ * (`--repo-sat` / `--repo-lit`, swept over all 360 hues by `theme.test.mjs`).
+ * That split is what lets this module hand out a number, and what keeps a
+ * user-picked colour readable in both themes without them having to check.
+ *
+ * Everything here is pure and node-tested (`repocolor.test.mjs`): a colour that
+ * changes under you is worse than one you dislike, so the hash, the ring order
+ * and the override resolution are all pinned.
+ */
+/** One ring of hues a repo colour may be drawn from. */
+export interface RepoPalette {
+    /** Stored id. Never re-used for a different ring — that would re-colour every repo. */
+    id: string;
+    /** What the chips say. */
+    label: string;
+    /** One line on what this ring is FOR — the sheet prints it under the chips. */
+    note: string;
+    /**
+     * The hues, in degrees. ORDER IS THE ASSIGNMENT: `hash % hues.length` indexes
+     * this array, so inserting a hue in the middle re-colours every repo after
+     * it. Append, or make a new palette.
+     */
+    hues: number[];
+}
+/**
+ * The rings.
+ *
+ * `spectrum` is twelve hues at 28°–38° spacing — even round most of the circle
+ * and wider through the greens, where HSL's hue axis is perceptually
+ * compressed and 28° of it reads as one colour. Twelve because that is about
+ * as many identities as a person keeps apart at a glance, and because more of
+ * them means less space between them, which is the problem this exists to
+ * solve.
+ *
+ * `cool` and `warm` are for somebody who wants the whole app to sit in one half
+ * of the circle. They are SMALLER rings on purpose, and `warm` is smaller again
+ * (six): the warm half is the narrower one, and eight hues in it measured 18°
+ * apart — under the floor this module exists to hold.
+ *
+ * `cvd` is six hues that survive simulated protanopia, deuteranopia and
+ * tritanopia — no red/green pair anywhere in it, which is what costs it the
+ * other six. A hue GAP cannot say that (12° of hue and 40° of hue are the same
+ * colour to a deuteranope), so the ring is measured where the sat and lit it is
+ * drawn at are known: `web/theme.test.mjs`, beside the chart palettes, under
+ * the same CIEDE2000-after-simulation code.
+ */
+export declare const REPO_PALETTES: readonly RepoPalette[];
+/** The ring a device that has never been told anything uses. */
+export declare const DEFAULT_PALETTE = "spectrum";
+/** Palette by id, falling back to the default — an unknown id is an older or a
+ *  newer client's, never a reason to draw nothing. */
+export declare function paletteById(id: string | undefined): RepoPalette;
+/**
+ * What this device knows about repo colour: which ring, and every hue a person
+ * pinned by hand.
+ *
+ * `by` is keyed on the repo NAME rather than its id, because that is what every
+ * drawing site already has (`repoAccentStyle(t.repo)`) and because a repo
+ * re-cloned into another directory is the same repo to the person looking at
+ * it.
+ */
+export interface RepoColors {
+    palette: string;
+    /** name → hue in degrees. A hue a person CHOSE; never a cached hash. */
+    by: Record<string, number>;
+}
+export declare const NO_REPO_COLORS: RepoColors;
+/**
+ * Read the stored value, tolerating every shape it has ever had and every shape
+ * a hand-edit can produce. A junk entry is DROPPED, never drawn: the fallback
+ * is the hash, which is always available and always readable.
+ */
+export declare function cleanRepoColors(raw: unknown): RepoColors;
+/**
+ * The name hash. FNV-ish, and deliberately the same arithmetic `format.ts`'s
+ * `repoHue` shipped with — what changed is what the number is used FOR (an
+ * index into a ring, not an angle), so a repo keeps a stable identity across
+ * the change instead of every colour in the app moving at once.
+ */
+export declare function repoNameHash(name: string): number;
+/** The hue this ring gives that name with nobody having said otherwise. */
+export declare function autoHue(name: string, palette: RepoPalette): number;
+/** The hue a repo is drawn in: what a person pinned, else what the ring says. */
+export declare function repoHueIn(name: string, cfg: RepoColors): number;
+/** Is this repo's colour a person's answer, or the ring's? */
+export declare function isPinned(name: string, cfg: RepoColors): boolean;
+/** Pin a hue (or clear one with `null`), returning a NEW config. */
+export declare function setRepoColor(cfg: RepoColors, name: string, hue: number | null): RepoColors;
+/** Switch rings. Pinned answers SURVIVE — a person who picked a colour picked
+ *  that colour, not "slot 4 of whatever ring is current". */
+export declare function setPalette(cfg: RepoColors, id: string): RepoColors;
+/** Circular distance between two hues, in degrees (0–180). */
+export declare function hueGap(a: number, b: number): number;
+/**
+ * Repos that end up wearing the SAME colour, grouped.
+ *
+ * This is the one thing a ring cannot prevent and a person cannot be expected
+ * to notice from two screens away: with twelve hues and fourteen repos, two of
+ * them collide, and the collision is invisible until the two headers happen to
+ * be on screen together. Named, it becomes a thing the sheet can offer to fix.
+ *
+ * Groups of ONE are not returned — a colour worn by one repo is not a clash.
+ * `names` is taken in the caller's order and the groups come back in the order
+ * their first member appears, so the list does not shuffle between renders.
+ */
+export declare function repoColorClashes(names: readonly string[], cfg: RepoColors): string[][];
+/**
+ * The hue in this ring the fewest of these repos already wear, ties broken by
+ * ring order — what "give me a different colour" means when there is no
+ * different colour left unused.
+ *
+ * `except` is the repo being re-coloured: its own current hue must not count
+ * against the ring, or re-rolling a repo that is alone on its colour would keep
+ * suggesting the colour it already has.
+ */
+export declare function freeHue(names: readonly string[], cfg: RepoColors, except?: string): number;
+/**
+ * Give every one of these repos a colour of its own, as far as the ring allows.
+ *
+ * The rules, in order, because this OVERWRITES what people can see:
+ *
+ *  - **A pinned colour is never moved.** Somebody chose it; a tidy-up that
+ *    silently un-chooses it is the draft-clobber rule wearing a different hat.
+ *  - **A repo already alone on its hue keeps it**, pinned or not, so the tap
+ *    changes as little as possible and the repos you already recognise stay
+ *    recognisable.
+ *  - Everything left takes the least-used hue at the time it is reached, in the
+ *    caller's order — so the result is deterministic and the same list run
+ *    twice is a no-op the second time.
+ *
+ * With more repos than hues it does what the ring allows and no more: the
+ * remainder double up, which the caller still sees through `repoColorClashes`.
+ */
+export declare function spreadRepoColors(names: readonly string[], cfg: RepoColors): RepoColors;
+/** How many repos this ring can colour before two of them must share. */
+export declare const paletteSize: (id: string) => number;

package/node_modules/@waterplane/shared/dist/repocolor.js

@@ -0,0 +1,261 @@
+/**
+ * **What colour a repo is** — the ring the hue comes from, the hash that picks
+ * one, and the answer a person may pin over it.
+ *
+ * The colour is load-bearing rather than decorative: it is what tells the
+ * launcher's group headers apart mid-scroll, what the session rows carry as a
+ * left stripe, and — since the tab strip — what identifies a tab at ~85 px,
+ * where the label is one word and an ellipsis. So it is the one part of the
+ * palette a person is allowed to overrule, and the one that has to be picked
+ * rather than hashed.
+ *
+ * **Why a RING and not the whole circle.** The first version was
+ * `hash * 137.508 % 360` — a golden-angle spread, which spreads CONSECUTIVE
+ * inputs and does nothing at all for arbitrary ones: two repo names hash to two
+ * arbitrary numbers, and two arbitrary numbers land 3° apart about as often as
+ * they land 100° apart. Measured on this machine, `myapp` and one worktree came
+ * out 9° apart — two greens nobody could tell from each other in a strip 30 px
+ * tall. A palette of hues chosen to be SEPARATE removes that failure by
+ * construction: two repos are either the same colour or they are 28° apart, and
+ * "the same" is a state the UI can see and offer to fix, while "nearly the
+ * same" is one it cannot.
+ *
+ * **Only the HUE is a fact about the repo.** How light and how saturated that
+ * hue has to be is a fact about the THEME and lives in `styles.css`
+ * (`--repo-sat` / `--repo-lit`, swept over all 360 hues by `theme.test.mjs`).
+ * That split is what lets this module hand out a number, and what keeps a
+ * user-picked colour readable in both themes without them having to check.
+ *
+ * Everything here is pure and node-tested (`repocolor.test.mjs`): a colour that
+ * changes under you is worse than one you dislike, so the hash, the ring order
+ * and the override resolution are all pinned.
+ */
+/**
+ * The rings.
+ *
+ * `spectrum` is twelve hues at 28°–38° spacing — even round most of the circle
+ * and wider through the greens, where HSL's hue axis is perceptually
+ * compressed and 28° of it reads as one colour. Twelve because that is about
+ * as many identities as a person keeps apart at a glance, and because more of
+ * them means less space between them, which is the problem this exists to
+ * solve.
+ *
+ * `cool` and `warm` are for somebody who wants the whole app to sit in one half
+ * of the circle. They are SMALLER rings on purpose, and `warm` is smaller again
+ * (six): the warm half is the narrower one, and eight hues in it measured 18°
+ * apart — under the floor this module exists to hold.
+ *
+ * `cvd` is six hues that survive simulated protanopia, deuteranopia and
+ * tritanopia — no red/green pair anywhere in it, which is what costs it the
+ * other six. A hue GAP cannot say that (12° of hue and 40° of hue are the same
+ * colour to a deuteranope), so the ring is measured where the sat and lit it is
+ * drawn at are known: `web/theme.test.mjs`, beside the chart palettes, under
+ * the same CIEDE2000-after-simulation code.
+ */
+export const REPO_PALETTES = [
+    {
+        id: "spectrum",
+        label: "Spectrum",
+        note: "Twelve hues round the whole circle, at least 28° apart.",
+        hues: [200, 228, 256, 284, 312, 340, 8, 36, 64, 92, 130, 168],
+    },
+    {
+        id: "cool",
+        label: "Cool",
+        note: "Green through violet — eight hues, nothing warmer than a jade.",
+        hues: [100, 128, 156, 184, 208, 232, 260, 288],
+    },
+    {
+        id: "warm",
+        label: "Warm",
+        note: "Magenta through amber — six hues, nothing colder than a gold.",
+        hues: [300, 330, 356, 20, 46, 76],
+    },
+    {
+        id: "cvd",
+        label: "Colour-blind safe",
+        note: "Six hues that survive simulated colour blindness — fewer colours, none confusable.",
+        hues: [204, 30, 178, 348, 60, 248],
+    },
+];
+/** The ring a device that has never been told anything uses. */
+export const DEFAULT_PALETTE = "spectrum";
+/** Palette by id, falling back to the default — an unknown id is an older or a
+ *  newer client's, never a reason to draw nothing. */
+export function paletteById(id) {
+    return REPO_PALETTES.find((p) => p.id === id) ?? REPO_PALETTES[0];
+}
+export const NO_REPO_COLORS = { palette: DEFAULT_PALETTE, by: {} };
+/** A hue as a number 0–359, or null for anything that is not one. */
+function cleanHue(v) {
+    if (typeof v !== "number" || !Number.isFinite(v))
+        return null;
+    const h = ((Math.round(v) % 360) + 360) % 360;
+    return h;
+}
+/**
+ * Read the stored value, tolerating every shape it has ever had and every shape
+ * a hand-edit can produce. A junk entry is DROPPED, never drawn: the fallback
+ * is the hash, which is always available and always readable.
+ */
+export function cleanRepoColors(raw) {
+    const src = (raw && typeof raw === "object" ? raw : {});
+    const palette = paletteById(typeof src.palette === "string" ? src.palette : undefined).id;
+    const by = {};
+    const rawBy = src.by && typeof src.by === "object" ? src.by : {};
+    for (const [name, v] of Object.entries(rawBy)) {
+        if (!name)
+            continue;
+        const h = cleanHue(v);
+        if (h != null)
+            by[name] = h;
+    }
+    return { palette, by };
+}
+/**
+ * The name hash. FNV-ish, and deliberately the same arithmetic `format.ts`'s
+ * `repoHue` shipped with — what changed is what the number is used FOR (an
+ * index into a ring, not an angle), so a repo keeps a stable identity across
+ * the change instead of every colour in the app moving at once.
+ */
+export function repoNameHash(name) {
+    let h = 0;
+    for (let i = 0; i < name.length; i++)
+        h = (h * 31 + name.charCodeAt(i)) >>> 0;
+    return h;
+}
+/** The hue this ring gives that name with nobody having said otherwise. */
+export function autoHue(name, palette) {
+    return palette.hues[repoNameHash(name) % palette.hues.length];
+}
+/** The hue a repo is drawn in: what a person pinned, else what the ring says. */
+export function repoHueIn(name, cfg) {
+    const pinned = cfg.by[name];
+    if (typeof pinned === "number")
+        return pinned;
+    return autoHue(name, paletteById(cfg.palette));
+}
+/** Is this repo's colour a person's answer, or the ring's? */
+export function isPinned(name, cfg) {
+    return typeof cfg.by[name] === "number";
+}
+/** Pin a hue (or clear one with `null`), returning a NEW config. */
+export function setRepoColor(cfg, name, hue) {
+    const by = { ...cfg.by };
+    if (hue == null)
+        delete by[name];
+    else {
+        const h = cleanHue(hue);
+        if (h == null)
+            return cfg;
+        by[name] = h;
+    }
+    return { ...cfg, by };
+}
+/** Switch rings. Pinned answers SURVIVE — a person who picked a colour picked
+ *  that colour, not "slot 4 of whatever ring is current". */
+export function setPalette(cfg, id) {
+    return { ...cfg, palette: paletteById(id).id };
+}
+/** Circular distance between two hues, in degrees (0–180). */
+export function hueGap(a, b) {
+    const d = Math.abs(((a - b) % 360 + 360) % 360);
+    return Math.min(d, 360 - d);
+}
+/**
+ * Repos that end up wearing the SAME colour, grouped.
+ *
+ * This is the one thing a ring cannot prevent and a person cannot be expected
+ * to notice from two screens away: with twelve hues and fourteen repos, two of
+ * them collide, and the collision is invisible until the two headers happen to
+ * be on screen together. Named, it becomes a thing the sheet can offer to fix.
+ *
+ * Groups of ONE are not returned — a colour worn by one repo is not a clash.
+ * `names` is taken in the caller's order and the groups come back in the order
+ * their first member appears, so the list does not shuffle between renders.
+ */
+export function repoColorClashes(names, cfg) {
+    const seen = new Map();
+    const order = [];
+    for (const n of names) {
+        const h = repoHueIn(n, cfg);
+        const g = seen.get(h);
+        if (g)
+            g.push(n);
+        else {
+            seen.set(h, [n]);
+            order.push(h);
+        }
+    }
+    return order.map((h) => seen.get(h)).filter((g) => g.length > 1);
+}
+/**
+ * The hue in this ring the fewest of these repos already wear, ties broken by
+ * ring order — what "give me a different colour" means when there is no
+ * different colour left unused.
+ *
+ * `except` is the repo being re-coloured: its own current hue must not count
+ * against the ring, or re-rolling a repo that is alone on its colour would keep
+ * suggesting the colour it already has.
+ */
+export function freeHue(names, cfg, except) {
+    const ring = paletteById(cfg.palette).hues;
+    const used = new Map();
+    for (const n of names) {
+        if (n === except)
+            continue;
+        const h = repoHueIn(n, cfg);
+        used.set(h, (used.get(h) ?? 0) + 1);
+    }
+    let best = ring[0], bestN = Infinity;
+    for (const h of ring) {
+        const n = used.get(h) ?? 0;
+        if (n < bestN) {
+            best = h;
+            bestN = n;
+        }
+    }
+    return best;
+}
+/**
+ * Give every one of these repos a colour of its own, as far as the ring allows.
+ *
+ * The rules, in order, because this OVERWRITES what people can see:
+ *
+ *  - **A pinned colour is never moved.** Somebody chose it; a tidy-up that
+ *    silently un-chooses it is the draft-clobber rule wearing a different hat.
+ *  - **A repo already alone on its hue keeps it**, pinned or not, so the tap
+ *    changes as little as possible and the repos you already recognise stay
+ *    recognisable.
+ *  - Everything left takes the least-used hue at the time it is reached, in the
+ *    caller's order — so the result is deterministic and the same list run
+ *    twice is a no-op the second time.
+ *
+ * With more repos than hues it does what the ring allows and no more: the
+ * remainder double up, which the caller still sees through `repoColorClashes`.
+ */
+export function spreadRepoColors(names, cfg) {
+    let out = cfg;
+    const count = new Map();
+    for (const n of names) {
+        const h = repoHueIn(n, out);
+        count.set(h, (count.get(h) ?? 0) + 1);
+    }
+    for (const n of names) {
+        if (isPinned(n, cfg))
+            continue;
+        const h = repoHueIn(n, out);
+        if ((count.get(h) ?? 0) <= 1)
+            continue;
+        const next = freeHue(names, out, n);
+        if (next === h)
+            continue;
+        count.set(h, (count.get(h) ?? 1) - 1);
+        count.set(next, (count.get(next) ?? 0) + 1);
+        out = setRepoColor(out, n, next);
+    }
+    return out;
+}
+/** How many repos this ring can colour before two of them must share. */
+export const paletteSize = (id) => paletteById(id).hues.length;
+//# sourceMappingURL=repocolor.js.map

package/node_modules/@waterplane/shared/dist/repocolor.js.map

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