@graview/core 0.1.0

package/dist/theme/contrast.js

@@ -0,0 +1,172 @@
+import { TEXT_PAIRS } from "./types.js";
+const HEX = /^#([0-9a-f]{3,8})$/i;
+const FUNC = /(rgba?|hsla?)\(([^)]+)\)/gi;
+function fromHex(hex) {
+    const match = HEX.exec(hex.trim());
+    if (!match)
+        return null;
+    let body = match[1];
+    if (body.length === 3 || body.length === 4) {
+        body = [...body].map((c) => c + c).join("");
+    }
+    if (body.length !== 6 && body.length !== 8)
+        return null;
+    const int = Number.parseInt(body.slice(0, 6), 16);
+    const alpha = body.length === 8 ? Number.parseInt(body.slice(6, 8), 16) / 255 : 1;
+    return { r: (int >> 16) & 255, g: (int >> 8) & 255, b: int & 255, a: alpha };
+}
+function fromFunction(text) {
+    const name = text.slice(0, text.indexOf("(")).toLowerCase();
+    const parts = text
+        .slice(text.indexOf("(") + 1, text.lastIndexOf(")"))
+        .split(/[,\s/]+/)
+        .filter(Boolean);
+    const numbers = parts.map((part) => part.endsWith("%") ? Number.parseFloat(part) / 100 : Number.parseFloat(part));
+    if (numbers.some(Number.isNaN))
+        return null;
+    if (name.startsWith("rgb")) {
+        const [r, g, b, a] = numbers;
+        if (r === undefined || g === undefined || b === undefined)
+            return null;
+        return { r, g, b, a: a ?? 1 };
+    }
+    const [h, s, l, a] = numbers;
+    if (h === undefined || s === undefined || l === undefined)
+        return null;
+    return { ...hslToRgb(h, s > 1 ? s / 100 : s, l > 1 ? l / 100 : l), a: a ?? 1 };
+}
+/** sRGB back to HSL, so a colour can be moved in lightness and stay itself. */
+export function rgbToHsl(colour) {
+    const r = colour.r / 255;
+    const g = colour.g / 255;
+    const b = colour.b / 255;
+    const max = Math.max(r, g, b);
+    const min = Math.min(r, g, b);
+    const l = (max + min) / 2;
+    if (max === min)
+        return { h: 0, s: 0, l };
+    const d = max - min;
+    const s = d / (1 - Math.abs(2 * l - 1));
+    const h = max === r
+        ? 60 * (((g - b) / d) % 6)
+        : max === g
+            ? 60 * ((b - r) / d + 2)
+            : 60 * ((r - g) / d + 4);
+    return { h: (h + 360) % 360, s, l };
+}
+export function hsl(h, s, l) {
+    return { ...hslToRgb(h, s, l), a: 1 };
+}
+function hslToRgb(h, s, l) {
+    const c = (1 - Math.abs(2 * l - 1)) * s;
+    const hp = (((h % 360) + 360) % 360) / 60;
+    const x = c * (1 - Math.abs((hp % 2) - 1));
+    const [r, g, b] = hp < 1
+        ? [c, x, 0]
+        : hp < 2
+            ? [x, c, 0]
+            : hp < 3
+                ? [0, c, x]
+                : hp < 4
+                    ? [0, x, c]
+                    : hp < 5
+                        ? [x, 0, c]
+                        : [c, 0, x];
+    const m = l - c / 2;
+    return {
+        r: Math.round((r + m) * 255),
+        g: Math.round((g + m) * 255),
+        b: Math.round((b + m) * 255),
+    };
+}
+/**
+ * Every colour a token value mentions.
+ *
+ * A gradient is not one colour and pretending otherwise is how a check passes
+ * on a value it never looked at. `bar` and `float` are gradients in both
+ * built-in schemes; a pair drawn on one owes its contrast against the WORST
+ * stop, because that is where the text will be at some point along it.
+ */
+export function coloursIn(value) {
+    const found = [];
+    for (const token of value.matchAll(FUNC)) {
+        const parsed = fromFunction(token[0]);
+        if (parsed)
+            found.push(parsed);
+    }
+    for (const token of value.matchAll(/#[0-9a-fA-F]{3,8}\b/g)) {
+        const parsed = fromHex(token[0]);
+        if (parsed)
+            found.push(parsed);
+    }
+    return found;
+}
+/** One colour laid over another, straight alpha. */
+export function composite(over, under) {
+    const a = over.a + under.a * (1 - over.a);
+    if (a === 0)
+        return { r: 0, g: 0, b: 0, a: 0 };
+    const mix = (x, y) => (x * over.a + y * under.a * (1 - over.a)) / a;
+    return { r: mix(over.r, under.r), g: mix(over.g, under.g), b: mix(over.b, under.b), a };
+}
+function channel(value) {
+    const c = value / 255;
+    return c <= 0.03928 ? c / 12.92 : ((c + 0.055) / 1.055) ** 2.4;
+}
+export function luminance(colour) {
+    return (0.2126 * channel(colour.r) + 0.7152 * channel(colour.g) + 0.0722 * channel(colour.b));
+}
+/** WCAG 2.1 contrast ratio, 1 to 21. */
+export function contrast(a, b) {
+    const [x, y] = [luminance(a), luminance(b)].sort((m, n) => n - m);
+    return (x + 0.05) / (y + 0.05);
+}
+/**
+ * Every text pair in a palette, measured.
+ *
+ * Returns the failures AND the unreadable values. A token this cannot parse
+ * is reported rather than skipped: silently passing a value nobody looked at
+ * is exactly the failure mode a contrast check exists to prevent.
+ */
+export function checkContrast(tokens) {
+    const findings = [];
+    for (const pair of TEXT_PAIRS) {
+        const inkValue = String(tokens[pair.ink]);
+        const onValue = String(tokens[pair.on]);
+        const inks = coloursIn(inkValue);
+        const grounds = coloursIn(onValue);
+        if (inks.length === 0 || grounds.length === 0) {
+            findings.push({
+                ink: pair.ink,
+                on: pair.on,
+                where: pair.where,
+                ratio: 0,
+                requires: pair.requires,
+                unreadable: inks.length === 0 ? inkValue : onValue,
+            });
+            continue;
+        }
+        const backdrop = pair.over ? coloursIn(String(tokens[pair.over]))[0] : undefined;
+        const opaque = backdrop ?? { r: 255, g: 255, b: 255, a: 1 };
+        // The worst stop of a gradient and the worst ink of a multi-stop value:
+        // text has to be legible everywhere it lands, not on average.
+        let worst = Number.POSITIVE_INFINITY;
+        for (const ground of grounds) {
+            const solidGround = composite(ground, opaque);
+            for (const ink of inks) {
+                worst = Math.min(worst, contrast(composite(ink, solidGround), solidGround));
+            }
+        }
+        if (worst + 0.005 < pair.requires) {
+            findings.push({
+                ink: pair.ink,
+                on: pair.on,
+                where: pair.where,
+                ratio: Math.round(worst * 100) / 100,
+                requires: pair.requires,
+            });
+        }
+    }
+    return findings;
+}
+//# sourceMappingURL=contrast.js.map

package/dist/theme/contrast.js.map

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

package/dist/theme/derive.d.ts

@@ -0,0 +1,81 @@
+import { checkContrast } from "./contrast.js";
+import type { Scheme, ThemeTokens } from "./types.js";
+/**
+ * A brand hands over one accent colour. What can be made of it, and what
+ * cannot.
+ *
+ * The two schemes here are not inversions of each other — dark loses
+ * luminance, light loses contrast and gains haze — so "derive the other one"
+ * is not a colour operation. What an accent CAN determine is everything
+ * keyed to it: its dim companion, its glow, the lit edge, the wash. What it
+ * cannot determine is the ground family (warm paper or cool slate is a
+ * decision, not a consequence), the ink that has to clear AA against that
+ * ground, and the warning colour, which must stay distinguishable from the
+ * accent rather than derived from it.
+ *
+ * So this derives what it can from a neutral base and REFUSES, naming what
+ * else is needed, when the accent cannot carry a role it is being asked to.
+ * A brand that gets a coherent pair of schemes and one that gets a clear
+ * refusal are both better served than one that gets a quietly unreadable
+ * interface.
+ */
+export interface AccentBrandOptions {
+    /** The one colour a brand always has. Hex, rgb() or hsl(). */
+    readonly accent: string;
+    /**
+     * Text drawn ON the accent — a filled button. Derived as black or white
+     * when absent, which works for most accents and is checked either way.
+     */
+    readonly accentInk?: {
+        readonly dark?: string;
+        readonly light?: string;
+    };
+    /** The neutral pair to build on. Supply the framework's own when absent. */
+    readonly base: Readonly<Record<Scheme, ThemeTokens>>;
+    /** Kept away from the accent on purpose; derived only if it stays distinct. */
+    readonly warn?: {
+        readonly dark?: string;
+        readonly light?: string;
+    };
+}
+export interface DerivedBrand {
+    readonly ok: true;
+    readonly schemes: Readonly<Record<Scheme, ThemeTokens>>;
+}
+export interface RefusedBrand {
+    readonly ok: false;
+    /** What the brand has to supply, in the words of the thing that needs it. */
+    readonly missing: readonly string[];
+    readonly why: string;
+}
+/**
+ * Builds a coherent pair of schemes around one accent, or says what is
+ * missing.
+ */
+export declare function brandFromAccent(options: AccentBrandOptions): DerivedBrand | RefusedBrand;
+/** Every contrast failure in a pair of schemes, named by scheme. */
+export declare function checkBrandContrast(schemes: Readonly<Record<Scheme, ThemeTokens>>): readonly (ReturnType<typeof checkContrast>[number] & {
+    scheme: Scheme;
+})[];
+/**
+ * Stable hue per kind — THE thread of kind identity across every surface:
+ * chip dots, legend swatches, district roofs, the focus tag, a page's
+ * kind mark. A brand that declares a kind's hue (`accents`) wins over the
+ * hash. Lives beside the brand because the brand is what overrides it.
+ *
+ * IN DEGREES, 0–360, which is what a hue is in CSS, in every design tool,
+ * and in `brand.accents` itself — the checker already validates an accent as
+ * "a number 0–360". It used to divide by 360 on the way out, because every
+ * consumer in this repository wanted a fraction, and the name said nothing
+ * about that. So an app author read the name, wrote
+ * `hsl(${hueFor(kind)} 58% 50%)`, which is valid CSS that renders, and got a
+ * hue between 0 and 1 for every kind — which is red. A map with four
+ * surfaces came out four shades of the same pink. Nothing failed: not tsc,
+ * not graview check, not a test. It was only wrong to look at, and only if
+ * you knew what it should have looked like.
+ *
+ * The consumers divide now, where dividing is a local detail rather than a
+ * surprise in a public name.
+ */
+export declare function hueFor(kind: string, accents?: Readonly<Record<string, number>>): number;
+//# sourceMappingURL=derive.d.ts.map

package/dist/theme/derive.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"derive.d.ts","sourceRoot":"","sources":["../../src/theme/derive.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,aAAa,EAOd,MAAM,eAAe,CAAC;AACvB,OAAO,KAAK,EAAE,MAAM,EAAE,WAAW,EAAE,MAAM,YAAY,CAAC;AAEtD;;;;;;;;;;;;;;;;;;GAkBG;AACH,MAAM,WAAW,kBAAkB;IACjC,8DAA8D;IAC9D,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;IACxB;;;OAGG;IACH,QAAQ,CAAC,SAAS,CAAC,EAAE;QAAE,QAAQ,CAAC,IAAI,CAAC,EAAE,MAAM,CAAC;QAAC,QAAQ,CAAC,KAAK,CAAC,EAAE,MAAM,CAAA;KAAE,CAAC;IACzE,4EAA4E;IAC5E,QAAQ,CAAC,IAAI,EAAE,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,WAAW,CAAC,CAAC,CAAC;IACrD,+EAA+E;IAC/E,QAAQ,CAAC,IAAI,CAAC,EAAE;QAAE,QAAQ,CAAC,IAAI,CAAC,EAAE,MAAM,CAAC;QAAC,QAAQ,CAAC,KAAK,CAAC,EAAE,MAAM,CAAA;KAAE,CAAC;CACrE;AAED,MAAM,WAAW,YAAY;IAC3B,QAAQ,CAAC,EAAE,EAAE,IAAI,CAAC;IAClB,QAAQ,CAAC,OAAO,EAAE,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,WAAW,CAAC,CAAC,CAAC;CACzD;AAED,MAAM,WAAW,YAAY;IAC3B,QAAQ,CAAC,EAAE,EAAE,KAAK,CAAC;IACnB,6EAA6E;IAC7E,QAAQ,CAAC,OAAO,EAAE,SAAS,MAAM,EAAE,CAAC;IACpC,QAAQ,CAAC,GAAG,EAAE,MAAM,CAAC;CACtB;AAQD;;;GAGG;AACH,wBAAgB,eAAe,CAAC,OAAO,EAAE,kBAAkB,GAAG,YAAY,GAAG,YAAY,CAmGxF;AAqDD,oEAAoE;AACpE,wBAAgB,kBAAkB,CAChC,OAAO,EAAE,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,WAAW,CAAC,CAAC,GAC7C,SAAS,CAAC,UAAU,CAAC,OAAO,aAAa,CAAC,CAAC,MAAM,CAAC,GAAG;IAAE,MAAM,EAAE,MAAM,CAAA;CAAE,CAAC,EAAE,CAI5E;AAGD;;;;;;;;;;;;;;;;;;;GAmBG;AACH,wBAAgB,MAAM,CAAC,IAAI,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC,GAAG,MAAM,CASvF"}

package/dist/theme/derive.js

@@ -0,0 +1,171 @@
+import { checkContrast, coloursIn, composite, contrast, hsl, rgbToHsl, } from "./contrast.js";
+const rgba = (colour, alpha) => `rgba(${Math.round(colour.r)}, ${Math.round(colour.g)}, ${Math.round(colour.b)}, ${alpha})`;
+const BLACK = { r: 0, g: 0, b: 0, a: 1 };
+const WHITE = { r: 255, g: 255, b: 255, a: 1 };
+/**
+ * Builds a coherent pair of schemes around one accent, or says what is
+ * missing.
+ */
+export function brandFromAccent(options) {
+    const accent = coloursIn(options.accent)[0];
+    if (!accent) {
+        return {
+            ok: false,
+            missing: ["accent"],
+            why: `"${options.accent}" is not a colour this can read. Use a hex, rgb() or hsl() value.`,
+        };
+    }
+    const schemes = {};
+    const missing = new Set();
+    const reasons = [];
+    const base = rgbToHsl(accent);
+    for (const scheme of ["dark", "light"]) {
+        const neutral = options.base[scheme];
+        const ground = coloursIn(neutral.ground)[0] ?? (scheme === "dark" ? BLACK : WHITE);
+        const panel = composite(coloursIn(neutral.panel)[0] ?? WHITE, ground);
+        /*
+         * The accent is used as TEXT, and no single colour can be text in both
+         * schemes.
+         *
+         * 4.5:1 on white needs a lightness under about 0.18; 4.5:1 on a dark
+         * panel needs one over about 0.24. Those do not overlap, which is why
+         * "the brand's accent" is one hue with two lightnesses rather than one
+         * colour — and why a framework that simply took the hex would have
+         * shipped an unreadable label in one scheme or the other.
+         *
+         * So the hue and the saturation are the brand's; the lightness is moved
+         * as little as it takes. If it has to move further than this, the colour
+         * has stopped being recognisably theirs and the honest answer is to ask.
+         */
+        const readable = nearestReadable(base, panel, scheme, 4.5);
+        if (!readable) {
+            missing.add(`accent (${scheme})`);
+            reasons.push(`no lightness of this hue clears 4.5:1 as text on the ${scheme} panel, so ${scheme} needs an accent of its own`);
+        }
+        else if (Math.abs(readable.l - base.l) > MAX_SHIFT) {
+            missing.add(`accent (${scheme})`);
+            reasons.push(`reaching 4.5:1 on the ${scheme} panel would move the accent's lightness by ${Math.round(Math.abs(readable.l - base.l) * 100)} points, which is far enough that it stops being the same colour — supply one for ${scheme}`);
+        }
+        const tone = readable ?? base;
+        const shown = hsl(tone.h, tone.s, tone.l);
+        const chosenInk = options.accentInk?.[scheme] ??
+            (contrast(WHITE, shown) >= contrast(BLACK, shown) ? "#ffffff" : "#000000");
+        const inkOnAccent = contrast(coloursIn(chosenInk)[0] ?? WHITE, shown);
+        if (inkOnAccent + 0.005 < 4.5) {
+            missing.add(`accentInk (${scheme})`);
+            reasons.push(`neither black nor white clears 4.5:1 on the accent (best ${inkOnAccent.toFixed(2)}:1), so text on a filled button has to be given`);
+        }
+        schemes[scheme] = {
+            ...neutral,
+            accent: rgba(shown, 1),
+            accentDim: rgba(shown, scheme === "dark" ? 0.35 : 0.22),
+            accentInk: chosenInk,
+            glow: rgba(shown, scheme === "dark" ? 0.28 : 0.1),
+            /*
+             * A lit edge is not text, and it still owes 3:1: a panel outline nobody
+             * can see is a panel with no edge. The aesthetic alpha is a preference,
+             * so it gives way to the alpha that can actually be seen.
+             */
+            edgeBright: rgba(shown, visibleAlpha(shown, panel, scheme === "dark" ? 0.55 : 0.42, 3)),
+            wash: scheme === "dark"
+                ? `radial-gradient(120% 80% at 50% -10%, var(--graview-glow) 0%, transparent 60%), radial-gradient(90% 60% at 12% 108%, ${rgba(shown, 0.1)} 0%, transparent 62%)`
+                : `radial-gradient(120% 80% at 50% -20%, rgba(255,255,255,0.9) 0%, transparent 58%), radial-gradient(80% 60% at 92% 104%, ${rgba(shown, 0.06)} 0%, transparent 60%)`,
+            ...(options.warn?.[scheme] ? { warn: options.warn[scheme] } : {}),
+        };
+        /*
+         * A warning colour must not be mistakable for the accent. Two roles that
+         * look alike is a worse failure than an ugly pair, because one of them
+         * means "something is broken".
+         */
+        const warn = coloursIn(schemes[scheme].warn)[0];
+        if (warn && hueGap(rgbToHsl(warn).h, tone.h) < 25) {
+            missing.add(`warn (${scheme})`);
+            reasons.push(`the warning colour shares the accent's hue in ${scheme}, so "something is broken" looks like "this is selected"`);
+        }
+    }
+    if (missing.size > 0) {
+        return { ok: false, missing: [...missing].sort(), why: reasons.join("; ") };
+    }
+    return { ok: true, schemes };
+}
+/**
+ * The smallest alpha at which a colour laid on a ground clears a ratio, or
+ * the preferred one if that is already enough.
+ *
+ * Searched rather than solved because compositing then luminance is not
+ * invertible in closed form, and a hundred steps is cheap for something that
+ * runs once per theme.
+ */
+function visibleAlpha(colour, ground, preferred, ratio) {
+    for (let step = Math.round(preferred * 100); step <= 100; step++) {
+        const alpha = step / 100;
+        if (contrast(composite({ ...colour, a: alpha }, ground), ground) >= ratio)
+            return alpha;
+    }
+    return 1;
+}
+/** How far apart two hues are on the wheel, 0–180. */
+function hueGap(a, b) {
+    const gap = Math.abs(a - b) % 360;
+    return gap > 180 ? 360 - gap : gap;
+}
+/** As much lightness as a brand's colour may be moved and still be theirs. */
+const MAX_SHIFT = 0.3;
+/**
+ * The lightness nearest the brand's own that clears the ratio on this ground.
+ *
+ * Searched from the original outwards rather than from an end, so a colour
+ * that already works is left exactly alone and one that does not is moved the
+ * smallest distance that helps. Dark schemes are searched upward first and
+ * light ones downward, since that is the direction that will win.
+ */
+function nearestReadable(base, ground, scheme, ratio) {
+    const up = scheme === "dark";
+    for (let step = 0; step <= 100; step++) {
+        const first = up ? base.l + step / 100 : base.l - step / 100;
+        const second = up ? base.l - step / 100 : base.l + step / 100;
+        for (const l of [first, second]) {
+            if (l < 0 || l > 1)
+                continue;
+            if (contrast(hsl(base.h, base.s, l), ground) >= ratio)
+                return { ...base, l };
+        }
+    }
+    return null;
+}
+/** Every contrast failure in a pair of schemes, named by scheme. */
+export function checkBrandContrast(schemes) {
+    return ["dark", "light"].flatMap((scheme) => checkContrast(schemes[scheme]).map((finding) => ({ ...finding, scheme })));
+}
+/**
+ * Stable hue per kind — THE thread of kind identity across every surface:
+ * chip dots, legend swatches, district roofs, the focus tag, a page's
+ * kind mark. A brand that declares a kind's hue (`accents`) wins over the
+ * hash. Lives beside the brand because the brand is what overrides it.
+ *
+ * IN DEGREES, 0–360, which is what a hue is in CSS, in every design tool,
+ * and in `brand.accents` itself — the checker already validates an accent as
+ * "a number 0–360". It used to divide by 360 on the way out, because every
+ * consumer in this repository wanted a fraction, and the name said nothing
+ * about that. So an app author read the name, wrote
+ * `hsl(${hueFor(kind)} 58% 50%)`, which is valid CSS that renders, and got a
+ * hue between 0 and 1 for every kind — which is red. A map with four
+ * surfaces came out four shades of the same pink. Nothing failed: not tsc,
+ * not graview check, not a test. It was only wrong to look at, and only if
+ * you knew what it should have looked like.
+ *
+ * The consumers divide now, where dividing is a local detail rather than a
+ * surprise in a public name.
+ */
+export function hueFor(kind, accents) {
+    const declared = accents?.[kind];
+    if (declared !== undefined)
+        return ((declared % 360) + 360) % 360;
+    let h = 2166136261;
+    for (let i = 0; i < kind.length; i++) {
+        h ^= kind.charCodeAt(i);
+        h = Math.imul(h, 16777619);
+    }
+    return (h >>> 0) % 360;
+}
+//# sourceMappingURL=derive.js.map

package/dist/theme/derive.js.map

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

package/dist/theme/kit.d.ts

@@ -0,0 +1,106 @@
+import { type Rgba } from "./contrast.js";
+import type { ThemeTokens } from "./types.js";
+/** How a connector travels between its two ends. */
+export type ConnectorRoute = "curve" | "straight" | "orthogonal";
+export type KitStrokePattern = "solid" | "dashed" | "dotted" | "double" | "tapered";
+export type KitEndCap = "none" | "arrow" | "dot" | "bar";
+export interface ConnectorKit {
+    /** The path's shape. One strategy per name; adding one is one case. */
+    readonly route: ConnectorRoute;
+    /** Drawn at all. An edge kind a brand keeps quiet is still selectable from the inspector. */
+    readonly visible: boolean;
+    /** An explicit CSS colour; absent, the kind's own hue. */
+    readonly colour?: string;
+    readonly pattern?: KitStrokePattern;
+    readonly width?: number;
+    readonly cap?: KitEndCap;
+    readonly opacity?: number;
+}
+export interface Kit {
+    readonly connectors: {
+        /** Every edge kind, unless `byEdge` says otherwise. */
+        readonly all: ConnectorKit;
+        /** Per edge kind: colour, visibility, pattern — whatever this kind wants differently. */
+        readonly byEdge: Readonly<Record<string, Partial<ConnectorKit>>>;
+    };
+    /** The words over a neighbourhood: the edge's own reading. */
+    readonly captions: {
+        readonly visible: boolean;
+    };
+    /** The fine square measure under the scene on the ground. */
+    readonly grid: {
+        readonly visible: boolean;
+        readonly size: number;
+    };
+    /** The isometric lattice the ground becomes from altitude. */
+    readonly lattice: {
+        readonly visible: boolean;
+        readonly size: number;
+    };
+    /** The kind's name astride a focused card. */
+    readonly tags: {
+        readonly visible: boolean;
+    };
+    /**
+     * How loud a connector is when it is not the one being looked at.
+     *
+     * `rest` is what an unlit line keeps while NOTHING is lit — the quiet
+     * weight every relation in the picture carries at once. `dim` is what it
+     * keeps while something else IS lit: 0 vanishes, 1 does not recede. They
+     * are two different questions, and one number could not answer both —
+     * a resting opacity low enough to be calm made a selection's own lines
+     * barely brighter than the crowd, and one high enough to show the crowd
+     * left twenty lines shouting over the two a person had just chosen.
+     */
+    readonly emphasis: {
+        readonly rest: number;
+        readonly dim: number;
+    };
+    /** The glyph a broken rule leaves on what it names. */
+    readonly marks: {
+        readonly flag: string;
+    };
+}
+/** A brand's say: any part of the kit, the rest as shipped. */
+export interface KitOverrides {
+    readonly connectors?: {
+        readonly all?: Partial<ConnectorKit>;
+        readonly byEdge?: Readonly<Record<string, Partial<ConnectorKit>>>;
+    };
+    readonly captions?: Partial<Kit["captions"]>;
+    readonly grid?: Partial<Kit["grid"]>;
+    readonly lattice?: Partial<Kit["lattice"]>;
+    readonly tags?: Partial<Kit["tags"]>;
+    readonly emphasis?: Partial<Kit["emphasis"]>;
+    readonly marks?: Partial<Kit["marks"]>;
+}
+export declare const DEFAULT_KIT: Kit;
+/** The kit as this brand wants it, every entry present. */
+export declare function resolveKit(overrides?: KitOverrides): Kit;
+/** One edge kind's connector, `all` under `byEdge`. */
+export declare function connectorKitFor(kit: Kit, edgeKind: string): ConnectorKit;
+/**
+ * The kit as custom properties, so the theme's rules read it and a host can
+ * override one entry without forking a component. Booleans become the CSS
+ * that carries them — a display, a multiplier — so no rule needs a script.
+ */
+export declare function kitVariables(kit: Kit): string;
+export interface KitContrastFinding {
+    readonly edgeKind: string | "*";
+    readonly colour: string;
+    readonly ratio: number;
+    readonly requires: number;
+    readonly unreadable?: string;
+    /** Which ground it failed on: the scene's own, or the deeper one under a district. */
+    readonly ground?: "ground" | "deep ground";
+}
+/**
+ * A connector's colour must be told from the ground it crosses: 3:1, the
+ * floor for graphics, on both the ground and the deeper ground the
+ * altitude view uses. Only explicit colours are judged — a kind's own hue
+ * is the theme's to keep readable.
+ */
+export declare function checkKitContrast(kit: Kit, tokens: ThemeTokens): readonly KitContrastFinding[];
+/** The kind's own hue (degrees) as the theme paints a connector, for callers that want the same colour elsewhere. */
+export declare function connectorHueColour(hue: number): Rgba;
+//# sourceMappingURL=kit.d.ts.map

package/dist/theme/kit.d.ts.map

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

package/dist/theme/kit.js

@@ -0,0 +1,84 @@
+import { coloursIn, contrast, hsl } from "./contrast.js";
+export const DEFAULT_KIT = {
+    connectors: { all: { route: "curve", visible: true }, byEdge: {} },
+    captions: { visible: true },
+    grid: { visible: true, size: 64 },
+    lattice: { visible: true, size: 46 },
+    tags: { visible: true },
+    emphasis: { rest: 0.34, dim: 0.12 },
+    marks: { flag: "⚠" },
+};
+/** The kit as this brand wants it, every entry present. */
+export function resolveKit(overrides) {
+    if (!overrides)
+        return DEFAULT_KIT;
+    return {
+        connectors: {
+            all: { ...DEFAULT_KIT.connectors.all, ...(overrides.connectors?.all ?? {}) },
+            byEdge: { ...DEFAULT_KIT.connectors.byEdge, ...(overrides.connectors?.byEdge ?? {}) },
+        },
+        captions: { ...DEFAULT_KIT.captions, ...(overrides.captions ?? {}) },
+        grid: { ...DEFAULT_KIT.grid, ...(overrides.grid ?? {}) },
+        lattice: { ...DEFAULT_KIT.lattice, ...(overrides.lattice ?? {}) },
+        tags: { ...DEFAULT_KIT.tags, ...(overrides.tags ?? {}) },
+        emphasis: { ...DEFAULT_KIT.emphasis, ...(overrides.emphasis ?? {}) },
+        marks: { ...DEFAULT_KIT.marks, ...(overrides.marks ?? {}) },
+    };
+}
+/** One edge kind's connector, `all` under `byEdge`. */
+export function connectorKitFor(kit, edgeKind) {
+    return { ...kit.connectors.all, ...(kit.connectors.byEdge[edgeKind] ?? {}) };
+}
+/**
+ * The kit as custom properties, so the theme's rules read it and a host can
+ * override one entry without forking a component. Booleans become the CSS
+ * that carries them — a display, a multiplier — so no rule needs a script.
+ */
+export function kitVariables(kit) {
+    return [
+        `  --graview-kit-grid: ${kit.grid.visible ? 1 : 0};`,
+        `  --graview-kit-grid-size: ${kit.grid.size}px;`,
+        `  --graview-kit-lattice: ${kit.lattice.visible ? 1 : 0};`,
+        `  --graview-kit-lattice-size: ${kit.lattice.size}px;`,
+        `  --graview-kit-tags: ${kit.tags.visible ? "inline-flex" : "none"};`,
+        `  --graview-kit-captions: ${kit.captions.visible ? "block" : "none"};`,
+        `  --graview-kit-rest: ${kit.emphasis.rest};`,
+        `  --graview-kit-dim: ${kit.emphasis.dim};`,
+        `  --graview-kit-flag: "${kit.marks.flag.replace(/"/g, "'")}";`,
+    ].join("\n");
+}
+/**
+ * A connector's colour must be told from the ground it crosses: 3:1, the
+ * floor for graphics, on both the ground and the deeper ground the
+ * altitude view uses. Only explicit colours are judged — a kind's own hue
+ * is the theme's to keep readable.
+ */
+export function checkKitContrast(kit, tokens) {
+    const findings = [];
+    const grounds = [["ground", tokens.ground], ["deep ground", tokens.groundDeep]]
+        .map(([name, value]) => ({ name, colour: coloursIn(value)[0] }))
+        .filter((one) => one.colour !== undefined);
+    const judge = (edgeKind, colour) => {
+        if (!colour)
+            return;
+        const ink = coloursIn(colour)[0];
+        if (!ink) {
+            findings.push({ edgeKind, colour, ratio: 0, requires: 3, unreadable: colour });
+            return;
+        }
+        for (const ground of grounds) {
+            const ratio = Math.round(contrast(ink, ground.colour) * 100) / 100;
+            if (ratio < 3)
+                findings.push({ edgeKind, colour, ratio, requires: 3, ground: ground.name });
+        }
+    };
+    judge("*", kit.connectors.all.colour);
+    for (const [edgeKind, connector] of Object.entries(kit.connectors.byEdge))
+        judge(edgeKind, connector.colour);
+    return findings;
+}
+/** The kind's own hue (degrees) as the theme paints a connector, for callers that want the same colour elsewhere. */
+export function connectorHueColour(hue) {
+    return hsl(hue, 55, 62);
+}
+//# sourceMappingURL=kit.js.map