@orz/ui 0.0.0-stage → 0.0.0

package/dist/lib/clipboard.js

@@ -0,0 +1,19 @@
+import { toast } from "sonner";
+/**
+ * Copy and say so. The success message names what was copied — the caller
+ * knows that; the failure one does not, because every failure here is the
+ * same one: no clipboard to write to. Resolves to whether the copy worked,
+ * so a caller can offer a fallback such as selecting the text.
+ */
+export async function copyToClipboard(text, ok) {
+    try {
+        await navigator.clipboard.writeText(text);
+        toast.success(ok);
+        return true;
+    }
+    catch {
+        toast.error("Clipboard is unavailable in this browser");
+        return false;
+    }
+}
+//# sourceMappingURL=clipboard.js.map

package/dist/lib/clipboard.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"clipboard.js","sourceRoot":"","sources":["../../src/lib/clipboard.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,KAAK,EAAE,MAAM,QAAQ,CAAC;AAE/B;;;;;GAKG;AACH,MAAM,CAAC,KAAK,UAAU,eAAe,CACnC,IAAY,EACZ,EAAU;IAEV,IAAI,CAAC;QACH,MAAM,SAAS,CAAC,SAAS,CAAC,SAAS,CAAC,IAAI,CAAC,CAAC;QAC1C,KAAK,CAAC,OAAO,CAAC,EAAE,CAAC,CAAC;QAClB,OAAO,IAAI,CAAC;IACd,CAAC;IAAC,MAAM,CAAC;QACP,KAAK,CAAC,KAAK,CAAC,0CAA0C,CAAC,CAAC;QACxD,OAAO,KAAK,CAAC;IACf,CAAC;AACH,CAAC"}

package/dist/lib/color.d.ts

@@ -0,0 +1,40 @@
+export type ColorFormat = "oklch" | "hex" | "rgb" | "hsl";
+export type Gamut = "srgb" | "p3" | "out";
+/** l 0–1, c ≥ 0, h in degrees [0, 360) — 0 when the colour has no hue — alpha 0–1. */
+export interface Oklch {
+    l: number;
+    c: number;
+    h: number;
+    alpha: number;
+}
+export interface ParsedColor {
+    color: Oklch;
+    /** The syntax the text was written in, when it is one of the four; null otherwise. */
+    format: ColorFormat | null;
+}
+/** Any CSS colour culori parses; null for anything else, including the empty string. */
+export declare function parseColor(text: string): ParsedColor | null;
+export declare function gamutOf(color: Oklch): Gamut;
+/** A display gamut a surface can be bounded by. */
+export type DisplayGamut = Exclude<Gamut, "out">;
+/**
+ * The largest chroma at lightness `l` and hue `h` (degrees) that is inside `gamut`, by bisection.
+ * It is 0 when `l <= 0` or `l >= 1`.
+ */
+export declare function maxChroma(l: number, h: number, gamut: DisplayGamut): number;
+/** CSS Color 4 gamut mapping into sRGB; lightness and hue kept, alpha kept. */
+export declare function mapToSrgb(color: Oklch): Oklch;
+/**
+ * The tokens' style: `oklch(0.577 0.245 27.325)`, `oklch(1 0 0 / 10%)`, `#18a46c`, `#18a46c80`,
+ * `rgb(34 197 94 / 50%)`, `hsl(330 81% 60%)`. hex, rgb and hsl are mapped into sRGB first.
+ * `alpha: false` omits alpha whatever the colour's alpha is. Default `alpha: true`.
+ */
+export declare function formatColor(color: Oklch, format: ColorFormat, options?: {
+    alpha?: boolean;
+}): string;
+/**
+ * WCAG 2 ratio, 1–21. A translucent foreground is composited over the background first; the
+ * background's alpha is ignored.
+ */
+export declare function contrastRatio(foreground: Oklch, background: Oklch): number;
+//# sourceMappingURL=color.d.ts.map

package/dist/lib/color.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"color.d.ts","sourceRoot":"","sources":["../../src/lib/color.ts"],"names":[],"mappings":"AA6BA,MAAM,MAAM,WAAW,GAAG,OAAO,GAAG,KAAK,GAAG,KAAK,GAAG,KAAK,CAAC;AAC1D,MAAM,MAAM,KAAK,GAAG,MAAM,GAAG,IAAI,GAAG,KAAK,CAAC;AAE1C,sFAAsF;AACtF,MAAM,WAAW,KAAK;IACpB,CAAC,EAAE,MAAM,CAAC;IACV,CAAC,EAAE,MAAM,CAAC;IACV,CAAC,EAAE,MAAM,CAAC;IACV,KAAK,EAAE,MAAM,CAAC;CACf;AAED,MAAM,WAAW,WAAW;IAC1B,KAAK,EAAE,KAAK,CAAC;IACb,sFAAsF;IACtF,MAAM,EAAE,WAAW,GAAG,IAAI,CAAC;CAC5B;AAyCD,wFAAwF;AACxF,wBAAgB,UAAU,CAAC,IAAI,EAAE,MAAM,GAAG,WAAW,GAAG,IAAI,CAqB3D;AAUD,wBAAgB,OAAO,CAAC,KAAK,EAAE,KAAK,GAAG,KAAK,CAK3C;AAED,mDAAmD;AACnD,MAAM,MAAM,YAAY,GAAG,OAAO,CAAC,KAAK,EAAE,KAAK,CAAC,CAAC;AAEjD;;;GAGG;AACH,wBAAgB,SAAS,CAAC,CAAC,EAAE,MAAM,EAAE,CAAC,EAAE,MAAM,EAAE,KAAK,EAAE,YAAY,GAAG,MAAM,CAa3E;AAED,+EAA+E;AAC/E,wBAAgB,SAAS,CAAC,KAAK,EAAE,KAAK,GAAG,KAAK,CAQ7C;AAgBD;;;;GAIG;AACH,wBAAgB,WAAW,CACzB,KAAK,EAAE,KAAK,EACZ,MAAM,EAAE,WAAW,EACnB,OAAO,CAAC,EAAE;IAAE,KAAK,CAAC,EAAE,OAAO,CAAA;CAAE,GAC5B,MAAM,CA8BR;AAED;;;GAGG;AACH,wBAAgB,aAAa,CAAC,UAAU,EAAE,KAAK,EAAE,UAAU,EAAE,KAAK,GAAG,MAAM,CAU1E"}

package/dist/lib/color.js

@@ -0,0 +1,177 @@
+import { converter, modeHsl, modeHsv, modeLrgb, modeOklab, modeOklch, modeP3, modeRgb, parse, useMode as registerMode, toGamut, wcagContrast, } from "culori/fn";
+registerMode(modeRgb);
+registerMode(modeLrgb);
+registerMode(modeOklab);
+registerMode(modeOklch);
+registerMode(modeP3);
+registerMode(modeHsl);
+registerMode(modeHsv);
+const toOklch = converter("oklch");
+const toRgb = converter("rgb");
+const toP3 = converter("p3");
+const toHsl = converter("hsl");
+const toSrgbGamut = toGamut("rgb", "oklch");
+function formatOf(text) {
+    if (text.startsWith("#"))
+        return "hex";
+    if (text.startsWith("rgb(") || text.startsWith("rgba("))
+        return "rgb";
+    if (text.startsWith("hsl(") || text.startsWith("hsla("))
+        return "hsl";
+    if (text.startsWith("oklch("))
+        return "oklch";
+    return null;
+}
+const unit = (v) => Math.min(1, Math.max(0, v));
+function wrapHue(h) {
+    const wrapped = h % 360;
+    return wrapped < 0 ? wrapped + 360 : wrapped;
+}
+function fromCulori(color) {
+    return {
+        l: unit(color.l ?? 0),
+        c: color.c ?? 0,
+        h: color.h === undefined || Number.isNaN(color.h) ? 0 : wrapHue(color.h),
+        alpha: color.alpha ?? 1,
+    };
+}
+function toCulori(color) {
+    return {
+        mode: "oklch",
+        l: color.l,
+        c: color.c,
+        h: color.h,
+        alpha: color.alpha,
+    };
+}
+/** Any CSS colour culori parses; null for anything else, including the empty string. */
+export function parseColor(text) {
+    // CSS colour syntax is case-insensitive, culori's parser is not.
+    const trimmed = text.trim().toLowerCase();
+    if (trimmed === "")
+        return null;
+    const parsed = parse(trimmed);
+    if (parsed === undefined)
+        return null;
+    const format = formatOf(trimmed);
+    // CSS clamps rgb() channels and hsl() saturation and lightness when it parses them, culori
+    // does not: unclamped, rgb(300 0 0) is a colour outside sRGB that maps back as salmon, not red.
+    // color(srgb …) also parses to rgb, and CSS leaves that unclamped.
+    let source = parsed;
+    if (format === "rgb" && parsed.mode === "rgb")
+        source = {
+            ...parsed,
+            r: unit(parsed.r),
+            g: unit(parsed.g),
+            b: unit(parsed.b),
+        };
+    else if (format === "hsl" && parsed.mode === "hsl")
+        source = { ...parsed, s: unit(parsed.s), l: unit(parsed.l) };
+    return { color: fromCulori(toOklch(source)), format };
+}
+// Converting a colour sitting exactly on the gamut's edge — every hex value — out of oklch and back
+// lands a hair outside [0, 1]; without the slack, #ffffff would read as outside sRGB.
+const EDGE = 1e-6;
+function inUnitCube(color) {
+    return [color.r, color.g, color.b].every((v) => v >= -EDGE && v <= 1 + EDGE);
+}
+export function gamutOf(color) {
+    const culori = toCulori(color);
+    if (inUnitCube(toRgb(culori)))
+        return "srgb";
+    if (inUnitCube(toP3(culori)))
+        return "p3";
+    return "out";
+}
+/**
+ * The largest chroma at lightness `l` and hue `h` (degrees) that is inside `gamut`, by bisection.
+ * It is 0 when `l <= 0` or `l >= 1`.
+ */
+export function maxChroma(l, h, gamut) {
+    if (!(l > 0 && l < 1))
+        return 0;
+    const pixel = { mode: "oklch", l, c: 0, h };
+    const convert = gamut === "p3" ? () => toP3(pixel) : () => toRgb(pixel);
+    // The in-gamut part of a chroma ray is one interval [0, Cmax], so bisection finds its end.
+    let lo = 0;
+    let hi = 0.5;
+    for (let k = 0; k < 24; k++) {
+        pixel.c = (lo + hi) / 2;
+        if (inUnitCube(convert()))
+            lo = pixel.c;
+        else
+            hi = pixel.c;
+    }
+    return lo;
+}
+/** CSS Color 4 gamut mapping into sRGB; lightness and hue kept, alpha kept. */
+export function mapToSrgb(color) {
+    if (gamutOf(color) === "srgb")
+        return color;
+    const mapped = fromCulori(toOklch(toSrgbGamut(toCulori(color))));
+    return {
+        ...mapped,
+        h: mapped.c < 1e-4 ? color.h : mapped.h,
+        alpha: color.alpha,
+    };
+}
+/** Rounds to `digits` decimals and prints without trailing zeros or a trailing `.`. */
+function num(value, digits) {
+    const rounded = Number(value.toFixed(digits));
+    return String(Object.is(rounded, -0) ? 0 : rounded);
+}
+const byte = (v) => Math.round(unit(v) * 255);
+const hex2 = (v) => v.toString(16).padStart(2, "0");
+function srgbOf(color) {
+    const rgb = toRgb(toCulori(mapToSrgb(color)));
+    return { r: unit(rgb.r), g: unit(rgb.g), b: unit(rgb.b) };
+}
+/**
+ * The tokens' style: `oklch(0.577 0.245 27.325)`, `oklch(1 0 0 / 10%)`, `#18a46c`, `#18a46c80`,
+ * `rgb(34 197 94 / 50%)`, `hsl(330 81% 60%)`. hex, rgb and hsl are mapped into sRGB first.
+ * `alpha: false` omits alpha whatever the colour's alpha is. Default `alpha: true`.
+ */
+export function formatColor(color, format, options) {
+    const withAlpha = options?.alpha ?? true;
+    const percent = num(unit(color.alpha) * 100, 1);
+    const alphaSuffix = withAlpha && percent !== "100" ? ` / ${percent}%` : "";
+    switch (format) {
+        case "oklch": {
+            const h = num(color.h, 3);
+            return `oklch(${num(color.l, 3)} ${num(color.c, 3)} ${h === "360" ? "0" : h}${alphaSuffix})`;
+        }
+        case "hex": {
+            const { r, g, b } = srgbOf(color);
+            const a = byte(color.alpha);
+            return `#${hex2(byte(r))}${hex2(byte(g))}${hex2(byte(b))}${withAlpha && a < 255 ? hex2(a) : ""}`;
+        }
+        case "rgb": {
+            const { r, g, b } = srgbOf(color);
+            return `rgb(${byte(r)} ${byte(g)} ${byte(b)}${alphaSuffix})`;
+        }
+        case "hsl": {
+            // Unquantised, a grey's channels differ in the last bits and hsl's saturation divides that
+            // noise by nearly zero: white came out as `hsl(300 Infinity% 100%)`.
+            const q = (v) => Math.round(v * 1e9) / 1e9;
+            const { r, g, b } = srgbOf(color);
+            const hsl = toHsl({ mode: "rgb", r: q(r), g: q(g), b: q(b) });
+            const grey = hsl.s === 0 || !Number.isFinite(hsl.s);
+            const h = num(grey || hsl.h === undefined ? 0 : hsl.h, 1);
+            const s = grey ? 0 : hsl.s;
+            return `hsl(${h === "360" ? "0" : h} ${num(s * 100, 1)}% ${num(hsl.l * 100, 1)}%${alphaSuffix})`;
+        }
+    }
+}
+/**
+ * WCAG 2 ratio, 1–21. A translucent foreground is composited over the background first; the
+ * background's alpha is ignored.
+ */
+export function contrastRatio(foreground, background) {
+    const fg = srgbOf(foreground);
+    const bg = srgbOf(background);
+    const a = unit(foreground.alpha);
+    // Source-over in gamma-encoded sRGB, which is what a browser paints.
+    const mix = (f, b) => f * a + b * (1 - a);
+    return wcagContrast({ mode: "rgb", r: mix(fg.r, bg.r), g: mix(fg.g, bg.g), b: mix(fg.b, bg.b) }, { mode: "rgb", ...bg });
+}
+//# sourceMappingURL=color.js.map

package/dist/lib/color.js.map

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

package/dist/lib/scroll-map.d.ts

@@ -0,0 +1,20 @@
+export declare const MAX_SPACER_PX = 15000000;
+export interface ScrollGeometry {
+    rowHeight: number;
+    viewportHeight: number;
+    /** Whole rows the viewport shows; a fractional remainder stays empty. */
+    viewportRows: number;
+    spacerHeight: number;
+    /** `scrollTop` maps linearly onto rows instead of one row per row height. */
+    scaled: boolean;
+    /** The largest top row: the last row then sits on the viewport's last whole row. */
+    maxTopRow: number;
+}
+/** Whole rows in `viewportHeight`, at least one. */
+export declare function rowsInViewport(viewportHeight: number, rowHeight: number): number;
+export declare function scrollGeometry(totalRows: number, rowHeight: number, viewportHeight: number): ScrollGeometry;
+export declare function topRowFromScroll(scrollTop: number, g: ScrollGeometry): number;
+export declare function scrollFromTopRow(topRow: number, g: ScrollGeometry): number;
+/** The top row is always whole: the view steps by rows, never shows half of one. */
+export declare function clampTopRow(topRow: number, g: ScrollGeometry): number;
+//# sourceMappingURL=scroll-map.d.ts.map

package/dist/lib/scroll-map.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"scroll-map.d.ts","sourceRoot":"","sources":["../../src/lib/scroll-map.ts"],"names":[],"mappings":"AAEA,eAAO,MAAM,aAAa,WAAa,CAAC;AAExC,MAAM,WAAW,cAAc;IAC7B,SAAS,EAAE,MAAM,CAAC;IAClB,cAAc,EAAE,MAAM,CAAC;IACvB,yEAAyE;IACzE,YAAY,EAAE,MAAM,CAAC;IACrB,YAAY,EAAE,MAAM,CAAC;IACrB,6EAA6E;IAC7E,MAAM,EAAE,OAAO,CAAC;IAChB,oFAAoF;IACpF,SAAS,EAAE,MAAM,CAAC;CACnB;AAED,oDAAoD;AACpD,wBAAgB,cAAc,CAAC,cAAc,EAAE,MAAM,EAAE,SAAS,EAAE,MAAM,UAIvE;AAED,wBAAgB,cAAc,CAC5B,SAAS,EAAE,MAAM,EACjB,SAAS,EAAE,MAAM,EACjB,cAAc,EAAE,MAAM,GACrB,cAAc,CAehB;AAMD,wBAAgB,gBAAgB,CAAC,SAAS,EAAE,MAAM,EAAE,CAAC,EAAE,cAAc,GAAG,MAAM,CAK7E;AAED,wBAAgB,gBAAgB,CAAC,MAAM,EAAE,MAAM,EAAE,CAAC,EAAE,cAAc,GAAG,MAAM,CAI1E;AAED,oFAAoF;AACpF,wBAAgB,WAAW,CAAC,MAAM,EAAE,MAAM,EAAE,CAAC,EAAE,cAAc,GAAG,MAAM,CAErE"}

package/dist/lib/scroll-map.js

@@ -0,0 +1,46 @@
+// Firefox caps an element's height near 17.9M px, Chromium and WebKit near
+// 33.5M; staying under both keeps the spacer exact wherever it fits.
+export const MAX_SPACER_PX = 15_000_000;
+/** Whole rows in `viewportHeight`, at least one. */
+export function rowsInViewport(viewportHeight, rowHeight) {
+    // clientHeight is rounded to whole pixels, so a viewport sized to exactly
+    // n rows of a fractional row height can measure up to half a pixel short.
+    return Math.max(1, Math.floor((viewportHeight + 0.5) / rowHeight));
+}
+export function scrollGeometry(totalRows, rowHeight, viewportHeight) {
+    const viewportRows = rowsInViewport(viewportHeight, rowHeight);
+    const maxTopRow = Math.max(0, totalRows - viewportRows);
+    // Scrolling the full extent walks the top row from 0 to maxTopRow, one row
+    // height per row; the rows themselves stay pinned to the viewport.
+    const contentHeight = maxTopRow * rowHeight + viewportHeight;
+    const scaled = contentHeight > MAX_SPACER_PX;
+    return {
+        rowHeight,
+        viewportHeight,
+        viewportRows,
+        spacerHeight: scaled ? MAX_SPACER_PX : contentHeight,
+        scaled,
+        maxTopRow,
+    };
+}
+function maxScroll(g) {
+    return Math.max(0, g.spacerHeight - g.viewportHeight);
+}
+export function topRowFromScroll(scrollTop, g) {
+    const range = maxScroll(g);
+    const top = Math.min(Math.max(0, scrollTop), range);
+    if (!g.scaled)
+        return clampTopRow(top / g.rowHeight, g);
+    return range > 0 ? clampTopRow((top / range) * g.maxTopRow, g) : 0;
+}
+export function scrollFromTopRow(topRow, g) {
+    const row = clampTopRow(topRow, g);
+    if (!g.scaled)
+        return row * g.rowHeight;
+    return g.maxTopRow > 0 ? (row / g.maxTopRow) * maxScroll(g) : 0;
+}
+/** The top row is always whole: the view steps by rows, never shows half of one. */
+export function clampTopRow(topRow, g) {
+    return Math.min(Math.max(0, Math.round(topRow)), g.maxTopRow);
+}
+//# sourceMappingURL=scroll-map.js.map

package/dist/lib/scroll-map.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"scroll-map.js","sourceRoot":"","sources":["../../src/lib/scroll-map.ts"],"names":[],"mappings":"AAAA,2EAA2E;AAC3E,qEAAqE;AACrE,MAAM,CAAC,MAAM,aAAa,GAAG,UAAU,CAAC;AAcxC,oDAAoD;AACpD,MAAM,UAAU,cAAc,CAAC,cAAsB,EAAE,SAAiB;IACtE,0EAA0E;IAC1E,0EAA0E;IAC1E,OAAO,IAAI,CAAC,GAAG,CAAC,CAAC,EAAE,IAAI,CAAC,KAAK,CAAC,CAAC,cAAc,GAAG,GAAG,CAAC,GAAG,SAAS,CAAC,CAAC,CAAC;AACrE,CAAC;AAED,MAAM,UAAU,cAAc,CAC5B,SAAiB,EACjB,SAAiB,EACjB,cAAsB;IAEtB,MAAM,YAAY,GAAG,cAAc,CAAC,cAAc,EAAE,SAAS,CAAC,CAAC;IAC/D,MAAM,SAAS,GAAG,IAAI,CAAC,GAAG,CAAC,CAAC,EAAE,SAAS,GAAG,YAAY,CAAC,CAAC;IACxD,2EAA2E;IAC3E,mEAAmE;IACnE,MAAM,aAAa,GAAG,SAAS,GAAG,SAAS,GAAG,cAAc,CAAC;IAC7D,MAAM,MAAM,GAAG,aAAa,GAAG,aAAa,CAAC;IAC7C,OAAO;QACL,SAAS;QACT,cAAc;QACd,YAAY;QACZ,YAAY,EAAE,MAAM,CAAC,CAAC,CAAC,aAAa,CAAC,CAAC,CAAC,aAAa;QACpD,MAAM;QACN,SAAS;KACV,CAAC;AACJ,CAAC;AAED,SAAS,SAAS,CAAC,CAAiB;IAClC,OAAO,IAAI,CAAC,GAAG,CAAC,CAAC,EAAE,CAAC,CAAC,YAAY,GAAG,CAAC,CAAC,cAAc,CAAC,CAAC;AACxD,CAAC;AAED,MAAM,UAAU,gBAAgB,CAAC,SAAiB,EAAE,CAAiB;IACnE,MAAM,KAAK,GAAG,SAAS,CAAC,CAAC,CAAC,CAAC;IAC3B,MAAM,GAAG,GAAG,IAAI,CAAC,GAAG,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC,EAAE,SAAS,CAAC,EAAE,KAAK,CAAC,CAAC;IACpD,IAAI,CAAC,CAAC,CAAC,MAAM;QAAE,OAAO,WAAW,CAAC,GAAG,GAAG,CAAC,CAAC,SAAS,EAAE,CAAC,CAAC,CAAC;IACxD,OAAO,KAAK,GAAG,CAAC,CAAC,CAAC,CAAC,WAAW,CAAC,CAAC,GAAG,GAAG,KAAK,CAAC,GAAG,CAAC,CAAC,SAAS,EAAE,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC;AACrE,CAAC;AAED,MAAM,UAAU,gBAAgB,CAAC,MAAc,EAAE,CAAiB;IAChE,MAAM,GAAG,GAAG,WAAW,CAAC,MAAM,EAAE,CAAC,CAAC,CAAC;IACnC,IAAI,CAAC,CAAC,CAAC,MAAM;QAAE,OAAO,GAAG,GAAG,CAAC,CAAC,SAAS,CAAC;IACxC,OAAO,CAAC,CAAC,SAAS,GAAG,CAAC,CAAC,CAAC,CAAC,CAAC,GAAG,GAAG,CAAC,CAAC,SAAS,CAAC,GAAG,SAAS,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC;AAClE,CAAC;AAED,oFAAoF;AACpF,MAAM,UAAU,WAAW,CAAC,MAAc,EAAE,CAAiB;IAC3D,OAAO,IAAI,CAAC,GAAG,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC,EAAE,IAAI,CAAC,KAAK,CAAC,MAAM,CAAC,CAAC,EAAE,CAAC,CAAC,SAAS,CAAC,CAAC;AAChE,CAAC"}

package/dist/lib/text-metrics.d.ts

@@ -0,0 +1,33 @@
+/**
+ * Text geometry for middle-eliding renderers. Every one of them reads the
+ * same numbers from here, because a second copy of the canvas set-up would let
+ * their 1/1 and 3/3 tiers drift apart without either one changing.
+ *
+ * Nothing here knows what the measured element is for: the budget an element
+ * is measured against is the caller's, and that is the part renderers
+ * genuinely disagree on.
+ */
+export declare const pixels: (value: string) => number;
+/** Measure the actual rendered text nodes, including their clipped characters. */
+export declare function textWidth(element: Element, start?: number, end?: number): number;
+export type SegmentMetrics = {
+    /** Width of the complete original segment, measured in CSS pixels. */
+    full: number;
+    /** First character + native ellipsis + last character (or full if shorter). */
+    minimum: number;
+    /** The one trailing character the 1/1 tier keeps outside the clipped head. */
+    tailWidth: number;
+    /** Three characters each side, or `Infinity` where that saves nothing. */
+    threeWidth: number;
+    /** The three trailing characters the 3/3 tier keeps. */
+    tailThreeWidth: number;
+};
+/**
+ * What a middle-elision allocator needs about one elidable run, measured in
+ * the styles it is actually rendered in.
+ *
+ * Counted in code points rather than UTF-16 units, so an astral character is
+ * one glyph to keep rather than half of a broken pair.
+ */
+export declare function segmentMetrics(element: Element, text?: string): SegmentMetrics;
+//# sourceMappingURL=text-metrics.d.ts.map

package/dist/lib/text-metrics.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"text-metrics.d.ts","sourceRoot":"","sources":["../../src/lib/text-metrics.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAEH,eAAO,MAAM,MAAM,UAAW,MAAM,WAAkC,CAAC;AAEvE,kFAAkF;AAClF,wBAAgB,SAAS,CAAC,OAAO,EAAE,OAAO,EAAE,KAAK,SAAI,EAAE,GAAG,SAAW,GAAG,MAAM,CAiB7E;AA8BD,MAAM,MAAM,cAAc,GAAG;IAC3B,sEAAsE;IACtE,IAAI,EAAE,MAAM,CAAC;IACb,+EAA+E;IAC/E,OAAO,EAAE,MAAM,CAAC;IAChB,8EAA8E;IAC9E,SAAS,EAAE,MAAM,CAAC;IAClB,0EAA0E;IAC1E,UAAU,EAAE,MAAM,CAAC;IACnB,wDAAwD;IACxD,cAAc,EAAE,MAAM,CAAC;CACxB,CAAC;AAEF;;;;;;GAMG;AACH,wBAAgB,cAAc,CAC5B,OAAO,EAAE,OAAO,EAChB,IAAI,SAA4B,GAC/B,cAAc,CAyBhB"}

package/dist/lib/text-metrics.js

@@ -0,0 +1,89 @@
+/**
+ * Text geometry for middle-eliding renderers. Every one of them reads the
+ * same numbers from here, because a second copy of the canvas set-up would let
+ * their 1/1 and 3/3 tiers drift apart without either one changing.
+ *
+ * Nothing here knows what the measured element is for: the budget an element
+ * is measured against is the caller's, and that is the part renderers
+ * genuinely disagree on.
+ */
+export const pixels = (value) => Number.parseFloat(value) || 0;
+/** Measure the actual rendered text nodes, including their clipped characters. */
+export function textWidth(element, start = 0, end = Infinity) {
+    const walker = document.createTreeWalker(element, NodeFilter.SHOW_TEXT);
+    const range = document.createRange();
+    let offset = 0;
+    let width = 0;
+    for (let node = walker.nextNode(); node; node = walker.nextNode()) {
+        const length = node.textContent?.length ?? 0;
+        const from = Math.max(0, start - offset);
+        const to = Math.min(length, end - offset);
+        if (from < to) {
+            range.setStart(node, from);
+            range.setEnd(node, to);
+            for (const rect of range.getClientRects())
+                width += rect.width;
+        }
+        offset += length;
+    }
+    return width;
+}
+function segmentMeasurer(element, text) {
+    const style = getComputedStyle(element);
+    // A clipped DOM Range can report both the full text and an extra visual
+    // ellipsis fragment. Measuring the original substrings on canvas avoids
+    // counting that decoration and keeps 1/3 tail changes independent of layout.
+    // Canvas creates neither a DOM text copy nor a second selectable identity.
+    const context = document.createElement("canvas").getContext("2d");
+    if (context) {
+        context.font = style.font;
+        context.fontKerning = style.fontKerning;
+        context.fontStretch = style.fontStretch;
+        context.fontVariantCaps = style.fontVariantCaps;
+        context.textRendering = style.textRendering;
+        context.letterSpacing =
+            style.letterSpacing === "normal" ? "0px" : style.letterSpacing;
+        context.wordSpacing =
+            style.wordSpacing === "normal" ? "0px" : style.wordSpacing;
+    }
+    return {
+        width(start = 0, end = text.length) {
+            return context
+                ? context.measureText(text.slice(start, end)).width
+                : textWidth(element, start, end);
+        },
+        ellipsis: context?.measureText("…").width ?? pixels(style.fontSize),
+    };
+}
+/**
+ * What a middle-elision allocator needs about one elidable run, measured in
+ * the styles it is actually rendered in.
+ *
+ * Counted in code points rather than UTF-16 units, so an astral character is
+ * one glyph to keep rather than half of a broken pair.
+ */
+export function segmentMetrics(element, text = element.textContent ?? "") {
+    const chars = Array.from(text);
+    const first = chars[0]?.length ?? 0;
+    const last = chars.at(-1)?.length ?? 0;
+    const measured = segmentMeasurer(element, text);
+    const full = measured.width();
+    const ellipsis = measured.ellipsis;
+    const tailWidth = measured.width(text.length - last);
+    const headThree = chars.slice(0, 3).join("").length;
+    const tailThree = chars.slice(-3).join("").length;
+    return {
+        full,
+        minimum: chars.length < 3
+            ? full
+            : Math.min(full, measured.width(0, first) + ellipsis + tailWidth),
+        tailWidth,
+        threeWidth: chars.length > 6
+            ? measured.width(0, headThree) +
+                ellipsis +
+                measured.width(text.length - tailThree)
+            : Infinity,
+        tailThreeWidth: measured.width(text.length - tailThree),
+    };
+}
+//# sourceMappingURL=text-metrics.js.map

package/dist/lib/text-metrics.js.map

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

package/dist/lib/theme-file.d.ts

@@ -0,0 +1,51 @@
+import { type AnyCustomTheme, type CustomTerminalTheme, type CustomTheme, type TerminalTheme } from "@orz/themes";
+export declare const THEME_FILE_FORMAT = "orz-themes";
+export declare const THEME_FILE_VERSION = 1;
+/** Text longer than this many characters is refused before parsing; the import panel also checks `File.size` against it before reading a file. */
+export declare const THEME_FILE_MAX_LENGTH = 1000000;
+/**
+ * The file for `customs` of both kinds, each in its kind's array, pretty-printed with two-space
+ * indent and a trailing newline. Ids and kinds are left out; every based side and based terminal
+ * carries `resolved`, computed against `themes` (UI and terminal-only lists together). A custom
+ * theme that composes to `null` is written without snapshots for the sides that cannot resolve.
+ */
+export declare function serializeThemeFile(customs: readonly AnyCustomTheme[], themes: readonly TerminalTheme[]): string;
+export type ImportStatus = "ok" | "renamed" | "adjusted" | "rejected";
+export interface ImportEntry {
+    /** The label as written in the file. */
+    sourceLabel: string;
+    /** The kind `theme` has, after any conversion. */
+    kind: "ui" | "terminal";
+    status: ImportStatus;
+    /**
+     * Present unless rejected: the theme to add, label de-duplicated, no id, no `resolved`. A UI
+     * theme carries no `kind`; a terminal theme carries `kind: "terminal"`.
+     */
+    theme?: Omit<CustomTheme, "id" | "kind"> | Omit<CustomTerminalTheme, "id">;
+    /** One sentence each, shown on the row: renames, repairs, or the rejection reason. */
+    messages: string[];
+}
+export type ParseResult = {
+    ok: false;
+    error: string;
+} | {
+    ok: true;
+    entries: ImportEntry[];
+};
+export interface ParseThemeFileOptions {
+    /** The store's slots. Default both true. */
+    slots?: {
+        ui: boolean;
+        terminal: boolean;
+    };
+}
+/**
+ * Parses and validates a theme file against this app's lists. `existingLabels` are the labels the
+ * new themes must not take (custom themes of both kinds, and the base themes of both slots);
+ * de-duplication also covers labels taken by earlier entries of the same file. Entries come out
+ * in file order, `themes` first, then `terminalThemes`. Never throws.
+ */
+export declare function parseThemeFile(text: string, themes: readonly TerminalTheme[], existingLabels: readonly string[], { slots }?: ParseThemeFileOptions): ParseResult;
+/** "X", or "X (n)" with the lowest n ≥ 2 that is free, compared case-insensitively. */
+export declare function uniqueLabel(label: string, taken: readonly string[]): string;
+//# sourceMappingURL=theme-file.d.ts.map

package/dist/lib/theme-file.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"theme-file.d.ts","sourceRoot":"","sources":["../../src/lib/theme-file.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,KAAK,cAAc,EAInB,KAAK,mBAAmB,EACxB,KAAK,WAAW,EAOhB,KAAK,aAAa,EAMnB,MAAM,aAAa,CAAC;AAGrB,eAAO,MAAM,iBAAiB,eAAe,CAAC;AAC9C,eAAO,MAAM,kBAAkB,IAAI,CAAC;AACpC,kJAAkJ;AAClJ,eAAO,MAAM,qBAAqB,UAAY,CAAC;AAmD/C;;;;;GAKG;AACH,wBAAgB,kBAAkB,CAChC,OAAO,EAAE,SAAS,cAAc,EAAE,EAClC,MAAM,EAAE,SAAS,aAAa,EAAE,GAC/B,MAAM,CA0BR;AAoDD,MAAM,MAAM,YAAY,GAAG,IAAI,GAAG,SAAS,GAAG,UAAU,GAAG,UAAU,CAAC;AAEtE,MAAM,WAAW,WAAW;IAC1B,wCAAwC;IACxC,WAAW,EAAE,MAAM,CAAC;IACpB,kDAAkD;IAClD,IAAI,EAAE,IAAI,GAAG,UAAU,CAAC;IACxB,MAAM,EAAE,YAAY,CAAC;IACrB;;;OAGG;IACH,KAAK,CAAC,EAAE,IAAI,CAAC,WAAW,EAAE,IAAI,GAAG,MAAM,CAAC,GAAG,IAAI,CAAC,mBAAmB,EAAE,IAAI,CAAC,CAAC;IAC3E,sFAAsF;IACtF,QAAQ,EAAE,MAAM,EAAE,CAAC;CACpB;AAED,MAAM,MAAM,WAAW,GACnB;IAAE,EAAE,EAAE,KAAK,CAAC;IAAC,KAAK,EAAE,MAAM,CAAA;CAAE,GAC5B;IAAE,EAAE,EAAE,IAAI,CAAC;IAAC,OAAO,EAAE,WAAW,EAAE,CAAA;CAAE,CAAC;AAqfzC,MAAM,WAAW,qBAAqB;IACpC,4CAA4C;IAC5C,KAAK,CAAC,EAAE;QAAE,EAAE,EAAE,OAAO,CAAC;QAAC,QAAQ,EAAE,OAAO,CAAA;KAAE,CAAC;CAC5C;AAED;;;;;GAKG;AACH,wBAAgB,cAAc,CAC5B,IAAI,EAAE,MAAM,EACZ,MAAM,EAAE,SAAS,aAAa,EAAE,EAChC,cAAc,EAAE,SAAS,MAAM,EAAE,EACjC,EAAE,KAAoC,EAAE,GAAE,qBAA0B,GACnE,WAAW,CAmCb;AAED,uFAAuF;AACvF,wBAAgB,WAAW,CAAC,KAAK,EAAE,MAAM,EAAE,KAAK,EAAE,SAAS,MAAM,EAAE,GAAG,MAAM,CAQ3E"}