@polyxd/core 0.3.0

package/dist/chart.d.ts

@@ -0,0 +1,41 @@
+/** Chart geometry: the same numbers whichever renderer draws the SVG. */
+export declare const CHART_W = 600;
+export declare const CHART_H = 240;
+export declare const CHART_PAD: {
+    top: number;
+    right: number;
+    bottom: number;
+    left: number;
+};
+export declare const MARKERS: readonly ["circle", "square", "diamond", "triangle", "circle", "square"];
+export declare const seriesColor: (i: number) => string;
+export declare function niceMax(v: number): number;
+/** Short axis labels: dates as "Apr" (or "3 Apr"), everything else as text. */
+export declare function axisLabel(v: unknown, type: string | undefined, locale: string): string;
+export interface Rect {
+    x: number;
+    y: number;
+    w: number;
+    h: number;
+}
+/** Squarified treemap: tiles laid in rows along the shorter side, keeping them near square. */
+export declare function treemap(values: number[], w: number, h: number): (Rect | null)[];
+/** The vertical scale of a bar or line chart: its floor, ceiling and three ticks. */
+export declare function verticalScale(all: number[], trend: boolean): {
+    lo: number;
+    max: number;
+    ticks: number[];
+};
+/** A marker's SVG: its element and attributes, by kind. */
+export declare function markerShape(kind: string, x: number, y: number): {
+    tag: "rect" | "path" | "circle";
+    attrs: Record<string, number | string>;
+};
+/** Stacked flows from each x value (left) into each series (right): where every band starts. */
+export declare function flowLayout(values: number[][], seriesCount: number, h: number): {
+    leftY: number[];
+    rightY: number[];
+    leftTotals: number[];
+    rightTotals: number[];
+    scale: number;
+};

package/dist/chart.js

@@ -0,0 +1,106 @@
+/** Chart geometry: the same numbers whichever renderer draws the SVG. */
+export const CHART_W = 600;
+export const CHART_H = 240;
+export const CHART_PAD = { top: 16, right: 16, bottom: 32, left: 56 };
+export const MARKERS = ["circle", "square", "diamond", "triangle", "circle", "square"];
+export const seriesColor = (i) => `var(--pxd-color-data-categorical-${(i % 6) + 1})`;
+export function niceMax(v) {
+    if (v <= 0)
+        return 1;
+    const p = 10 ** Math.floor(Math.log10(v));
+    return Math.ceil(v / p) * p;
+}
+/** Short axis labels: dates as "Apr" (or "3 Apr"), everything else as text. */
+export function axisLabel(v, type, locale) {
+    if (type === "date" || type === "datetime") {
+        const d = new Date(String(v));
+        if (!Number.isNaN(d.getTime())) {
+            const opts = d.getUTCDate() === 1 ? { month: "short", timeZone: "UTC" } : { month: "short", day: "numeric", timeZone: "UTC" };
+            return new Intl.DateTimeFormat(locale, opts).format(d);
+        }
+    }
+    return String(v ?? "").slice(0, 12);
+}
+/** Squarified treemap: tiles laid in rows along the shorter side, keeping them near square. */
+export function treemap(values, w, h) {
+    const total = values.reduce((a, v) => a + v, 0);
+    const rects = values.map(() => null);
+    if (total <= 0)
+        return rects;
+    const order = values.map((_, i) => i).filter((i) => values[i] > 0).sort((a, c) => values[c] - values[a]);
+    const area = (i) => (values[i] / total) * w * h;
+    let x = 0;
+    let y = 0;
+    let cw = w;
+    let ch = h;
+    let i = 0;
+    while (i < order.length && cw > 0 && ch > 0) {
+        const vertical = cw >= ch;
+        const side = vertical ? ch : cw;
+        let row = [];
+        let rowArea = 0;
+        let best = Infinity;
+        while (i < order.length) {
+            const trial = [...row, order[i]];
+            const trialArea = rowArea + area(order[i]);
+            const thickness = trialArea / side;
+            const worst = Math.max(...trial.map((j) => {
+                const len = area(j) / thickness;
+                return Math.max(len / thickness, thickness / len);
+            }));
+            if (worst > best && row.length)
+                break;
+            row = trial;
+            rowArea = trialArea;
+            best = worst;
+            i++;
+        }
+        const thickness = rowArea / side;
+        let off = 0;
+        for (const j of row) {
+            const len = area(j) / thickness;
+            rects[j] = vertical ? { x, y: y + off, w: thickness, h: len } : { x: x + off, y, w: len, h: thickness };
+            off += len;
+        }
+        if (vertical)
+            (x += thickness), (cw -= thickness);
+        else
+            (y += thickness), (ch -= thickness);
+    }
+    return rects;
+}
+/** The vertical scale of a bar or line chart: its floor, ceiling and three ticks. */
+export function verticalScale(all, trend) {
+    const max = niceMax(Math.max(0, ...all));
+    const min = trend ? Math.min(0, ...all) : 0;
+    const trendMin = trend && all.length ? Math.max(min, Math.min(...all) - (Math.max(...all) - Math.min(...all)) * 0.2) : min;
+    const lo = trend ? Math.floor(trendMin) : 0;
+    return { lo, max, ticks: [0, 0.5, 1].map((t) => lo + (max - lo) * t) };
+}
+/** A marker's SVG: its element and attributes, by kind. */
+export function markerShape(kind, x, y) {
+    if (kind === "square")
+        return { tag: "rect", attrs: { x: x - 4, y: y - 4, width: 8, height: 8 } };
+    if (kind === "diamond")
+        return { tag: "path", attrs: { d: `M${x} ${y - 5}L${x + 5} ${y}L${x} ${y + 5}L${x - 5} ${y}Z` } };
+    if (kind === "triangle")
+        return { tag: "path", attrs: { d: `M${x} ${y - 5}L${x + 5} ${y + 4}L${x - 5} ${y + 4}Z` } };
+    return { tag: "circle", attrs: { cx: x, cy: y, r: 4 } };
+}
+/** Stacked flows from each x value (left) into each series (right): where every band starts. */
+export function flowLayout(values, seriesCount, h) {
+    const leftTotals = values.map((row) => row.reduce((a, v) => a + v, 0));
+    const rightTotals = Array.from({ length: seriesCount }, (_, si) => values.reduce((a, row) => a + row[si], 0));
+    const total = leftTotals.reduce((a, v) => a + v, 0) || 1;
+    const gap = 6;
+    const usable = h - gap * (Math.max(values.length, seriesCount) - 1);
+    const scale = usable / total;
+    const leftY = [];
+    const rightY = [];
+    let yy = 0;
+    leftTotals.forEach((t) => (leftY.push(yy), (yy += t * scale + gap)));
+    yy = 0;
+    rightTotals.forEach((t) => (rightY.push(yy), (yy += t * scale + gap)));
+    return { leftY, rightY, leftTotals, rightTotals, scale };
+}
+//# sourceMappingURL=chart.js.map

package/dist/chart.js.map

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

package/dist/choice.d.ts

@@ -0,0 +1,35 @@
+/**
+ * Choice picks its control from the options' number and shape (the Choice rendering rules):
+ * people or things with faces → a picker (recent row, then a list); a few short options → chips
+ * (a segmented control); otherwise radios or checkboxes, searchable past 10. Every renderer
+ * makes the same call here, so a document reads the same whichever draws it.
+ */
+import type { Option } from "./options.ts";
+export type ChoiceControl = "chips" | "people" | "list";
+export interface ChoicePlan {
+    control: ChoiceControl;
+    multiple: boolean;
+    /** Past this many options a filter field sits above them */
+    searchable: boolean;
+    withFaces: boolean;
+}
+/** Chips hold this many short options at most; more become a list. */
+export declare const CHIPS_MAX = 6;
+/** The longest label a chip can carry. */
+export declare const CHIP_LABEL_MAX = 24;
+/** Past this many options the list gets a filter; with faces the threshold is the chips' limit. */
+export declare const SEARCHABLE_PAST = 10;
+export declare function planChoice(options: Option[], mode: string | undefined): ChoicePlan;
+/** Values compare by their JSON: 1 and "1" are different options, {a:1} equals {a:1}. */
+export declare const optionKey: (v: unknown) => string;
+export declare const matchesQuery: (o: Option, query: string) => boolean;
+/** People or places: recent ones as a row of faces, everyone else as a list. A search shows matches only. */
+export declare function partitionRecent(options: Option[], query: string): {
+    recent: Option[];
+    rest: Option[];
+};
+/** A multiple choice's next selection after one option is toggled. */
+export declare function toggleSelection(selected: unknown, value: unknown): unknown[];
+export declare const isSelected: (selected: unknown, value: unknown) => boolean;
+/** The placeholder for the filter field: by name for people, by text otherwise. */
+export declare const searchPlaceholder: (withFaces: boolean) => string;

package/dist/choice.js

@@ -0,0 +1,32 @@
+/** Chips hold this many short options at most; more become a list. */
+export const CHIPS_MAX = 6;
+/** The longest label a chip can carry. */
+export const CHIP_LABEL_MAX = 24;
+/** Past this many options the list gets a filter; with faces the threshold is the chips' limit. */
+export const SEARCHABLE_PAST = 10;
+export function planChoice(options, mode) {
+    const withFaces = options.some((o) => o.avatar !== undefined);
+    const searchable = options.length > SEARCHABLE_PAST || (withFaces && options.length > CHIPS_MAX);
+    const chips = !withFaces && options.length <= CHIPS_MAX && options.every((o) => o.label.length <= CHIP_LABEL_MAX && !o.description);
+    return { control: chips ? "chips" : withFaces ? "people" : "list", multiple: mode === "multiple", searchable, withFaces };
+}
+/** Values compare by their JSON: 1 and "1" are different options, {a:1} equals {a:1}. */
+export const optionKey = (v) => JSON.stringify(v);
+export const matchesQuery = (o, query) => !query || `${o.label} ${o.description ?? ""}`.toLowerCase().includes(query.toLowerCase());
+/** People or places: recent ones as a row of faces, everyone else as a list. A search shows matches only. */
+export function partitionRecent(options, query) {
+    return { recent: query ? [] : options.filter((o) => o.recent), rest: options.filter((o) => (query ? matchesQuery(o, query) : !o.recent)) };
+}
+/** A multiple choice's next selection after one option is toggled. */
+export function toggleSelection(selected, value) {
+    const cur = Array.isArray(selected) ? selected : [];
+    const k = optionKey(value);
+    return cur.some((x) => optionKey(x) === k) ? cur.filter((x) => optionKey(x) !== k) : [...cur, value];
+}
+export const isSelected = (selected, value) => {
+    const k = optionKey(value);
+    return Array.isArray(selected) ? selected.some((x) => optionKey(x) === k) : selected !== null && selected !== undefined && optionKey(selected) === k;
+};
+/** The placeholder for the filter field: by name for people, by text otherwise. */
+export const searchPlaceholder = (withFaces) => (withFaces ? "Search by name" : "Filter options");
+//# sourceMappingURL=choice.js.map

package/dist/choice.js.map

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

package/dist/collection.d.ts

@@ -0,0 +1,54 @@
+/** Collection decisions: item values, people's order, the calendar's month. */
+import type { Node } from "./document.ts";
+/** Stable value used for selecting an item: its id when present, else its index. */
+export declare const collectionItemValue: (item: unknown, index: number) => unknown;
+/** Grid for visual items (a Card with media), list otherwise, unless the document says which. */
+export declare function collectionLayout(node: Node, template: Node | undefined): {
+    grid: boolean;
+    timeline: boolean;
+    carousel: boolean;
+    calendar: boolean;
+};
+/** Items in the order people put them ('order' holds item values); unknown values keep host order at the end. */
+export declare function orderedIndices(values: unknown[], order: unknown): number[];
+/** Moves one position to another; the new order as item values. */
+export declare function moveItem(indices: number[], values: unknown[], from: number, to: number): unknown[] | undefined;
+/** ISO date → UTC parts, or undefined when it isn't one. */
+export declare function dateParts(v: unknown): {
+    y: number;
+    m: number;
+    d: number;
+} | undefined;
+export interface CalendarMonth {
+    y: number;
+    m: number;
+    monthName: string;
+    weekdays: string[];
+    /** Rows of seven: a day of the month, or null outside it */
+    weeks: (number | null)[][];
+}
+/** The month shown starts at the first dated item (or today). */
+export declare const monthToShow: (chosen: {
+    y: number;
+    m: number;
+} | null, first: {
+    y: number;
+    m: number;
+} | undefined, today?: Date) => {
+    y: number;
+    m: number;
+};
+export declare function shiftMonth(shown: {
+    y: number;
+    m: number;
+}, by: number): {
+    y: number;
+    m: number;
+};
+/** The grid of one month; weeks start on Monday (2024-01-01 was one). */
+export declare function calendarMonth(shown: {
+    y: number;
+    m: number;
+}, locale: string): CalendarMonth;
+/** Which slide is in view: the one whose left edge is nearest the scroll position. */
+export declare function nearestSlide(offsets: number[], scrollLeft: number): number;

package/dist/collection.js

@@ -0,0 +1,61 @@
+/** Stable value used for selecting an item: its id when present, else its index. */
+export const collectionItemValue = (item, index) => (item && typeof item === "object" && "id" in item ? item.id : index);
+/** Grid for visual items (a Card with media), list otherwise, unless the document says which. */
+export function collectionLayout(node, template) {
+    const layout = node.layout ?? "auto";
+    return { grid: layout === "grid" || (layout === "auto" && template?.component === "Card" && !!template.media), timeline: layout === "timeline", carousel: layout === "carousel", calendar: layout === "calendar" };
+}
+/** Items in the order people put them ('order' holds item values); unknown values keep host order at the end. */
+export function orderedIndices(values, order) {
+    const indices = values.map((_, i) => i);
+    if (!Array.isArray(order))
+        return indices;
+    const rank = (i) => {
+        const r = order.indexOf(values[i]);
+        return r < 0 ? order.length + i : r;
+    };
+    return indices.sort((a, c) => rank(a) - rank(c));
+}
+/** Moves one position to another; the new order as item values. */
+export function moveItem(indices, values, from, to) {
+    if (to < 0 || to >= indices.length || from === to)
+        return undefined;
+    const next = [...indices];
+    next.splice(to, 0, ...next.splice(from, 1));
+    return next.map((i) => values[i]);
+}
+/** ISO date → UTC parts, or undefined when it isn't one. */
+export function dateParts(v) {
+    if (v === null || v === undefined || v === "")
+        return undefined;
+    const d = new Date(String(v));
+    return Number.isNaN(d.getTime()) ? undefined : { y: d.getUTCFullYear(), m: d.getUTCMonth(), d: d.getUTCDate() };
+}
+/** The month shown starts at the first dated item (or today). */
+export const monthToShow = (chosen, first, today = new Date()) => chosen ?? (first ? { y: first.y, m: first.m } : { y: today.getUTCFullYear(), m: today.getUTCMonth() });
+export function shiftMonth(shown, by) {
+    const d = new Date(Date.UTC(shown.y, shown.m + by, 1));
+    return { y: d.getUTCFullYear(), m: d.getUTCMonth() };
+}
+/** The grid of one month; weeks start on Monday (2024-01-01 was one). */
+export function calendarMonth(shown, locale) {
+    const monthName = new Intl.DateTimeFormat(locale, { month: "long", year: "numeric", timeZone: "UTC" }).format(new Date(Date.UTC(shown.y, shown.m, 1)));
+    const weekdays = Array.from({ length: 7 }, (_, i) => new Intl.DateTimeFormat(locale, { weekday: "short", timeZone: "UTC" }).format(new Date(Date.UTC(2024, 0, 1 + i))));
+    const firstDay = (new Date(Date.UTC(shown.y, shown.m, 1)).getUTCDay() + 6) % 7;
+    const days = new Date(Date.UTC(shown.y, shown.m + 1, 0)).getUTCDate();
+    const cells = [...Array(firstDay).fill(null), ...Array.from({ length: days }, (_, i) => i + 1)];
+    while (cells.length % 7)
+        cells.push(null);
+    const weeks = Array.from({ length: cells.length / 7 }, (_, w) => cells.slice(w * 7, w * 7 + 7));
+    return { ...shown, monthName, weekdays, weeks };
+}
+/** Which slide is in view: the one whose left edge is nearest the scroll position. */
+export function nearestSlide(offsets, scrollLeft) {
+    let best = 0;
+    offsets.forEach((o, i) => {
+        if (Math.abs(o - scrollLeft) < Math.abs(offsets[best] - scrollLeft))
+            best = i;
+    });
+    return best;
+}
+//# sourceMappingURL=collection.js.map

package/dist/collection.js.map

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

package/dist/color.d.ts

@@ -0,0 +1,20 @@
+/** Colour text a ColorInput reads and writes: hex, rgb()/rgba() and hsl()/hsla(). */
+export type ColorFormat = "hex" | "rgb" | "hsl";
+export interface RGBA {
+    r: number;
+    g: number;
+    b: number;
+    a: number;
+}
+export declare const clamp: (n: number, lo: number, hi: number) => number;
+export declare function hslToRgb(h: number, s: number, l: number): [number, number, number];
+export declare function rgbToHsl(r: number, g: number, b: number): [number, number, number];
+/** Parse CSS hex, rgb()/rgba() and hsl()/hsla() text; null when it isn't a colour yet. */
+export declare function parseColor(text: unknown): RGBA | null;
+/** Write a colour as CSS text in the requested format; alpha appears only when allowed and below 1. */
+export declare function formatColor(c: RGBA, format: ColorFormat, alpha: boolean): string;
+/** The six-digit hex a native colour picker takes. */
+export declare const toHex6: (c: RGBA | null) => string;
+/** Whether two colours are the same to the eye (by channel, not by text: '#FFF' is 'rgb(255, 255, 255)'). */
+export declare const sameColor: (a: RGBA | null, c: RGBA | null, alpha: boolean) => boolean;
+export declare const colorPlaceholder: (format: ColorFormat) => string;

package/dist/color.js

@@ -0,0 +1,105 @@
+/** Colour text a ColorInput reads and writes: hex, rgb()/rgba() and hsl()/hsla(). */
+export const clamp = (n, lo, hi) => Math.min(hi, Math.max(lo, n));
+const hex2 = (n) => clamp(Math.round(n), 0, 255).toString(16).padStart(2, "0");
+const parseAlpha = (t) => (t === undefined ? 1 : clamp(t.endsWith("%") ? parseFloat(t) / 100 : parseFloat(t), 0, 1));
+const channel = (t) => (t.endsWith("%") ? (parseFloat(t) / 100) * 255 : parseFloat(t));
+export function hslToRgb(h, s, l) {
+    const hh = (((h % 360) + 360) % 360) / 360;
+    if (s === 0)
+        return [l * 255, l * 255, l * 255];
+    const q = l < 0.5 ? l * (1 + s) : l + s - l * s;
+    const p = 2 * l - q;
+    const f = (t) => {
+        if (t < 0)
+            t += 1;
+        if (t > 1)
+            t -= 1;
+        if (t < 1 / 6)
+            return p + (q - p) * 6 * t;
+        if (t < 1 / 2)
+            return q;
+        if (t < 2 / 3)
+            return p + (q - p) * (2 / 3 - t) * 6;
+        return p;
+    };
+    return [f(hh + 1 / 3) * 255, f(hh) * 255, f(hh - 1 / 3) * 255];
+}
+export function rgbToHsl(r, g, b) {
+    const rr = r / 255;
+    const gg = g / 255;
+    const bb = b / 255;
+    const max = Math.max(rr, gg, bb);
+    const min = Math.min(rr, gg, bb);
+    const l = (max + min) / 2;
+    if (max === min)
+        return [0, 0, l];
+    const d = max - min;
+    const s = l > 0.5 ? d / (2 - max - min) : d / (max + min);
+    let h = max === rr ? (gg - bb) / d + (gg < bb ? 6 : 0) : max === gg ? (bb - rr) / d + 2 : (rr - gg) / d + 4;
+    h /= 6;
+    return [h * 360, s, l];
+}
+/** Parse CSS hex, rgb()/rgba() and hsl()/hsla() text; null when it isn't a colour yet. */
+export function parseColor(text) {
+    if (typeof text !== "string")
+        return null;
+    const t = text.trim();
+    const hex = /^#([0-9a-f]{3,8})$/i.exec(t);
+    if (hex) {
+        const h = hex[1];
+        if (h.length === 3 || h.length === 4) {
+            const [r, g, b, a] = h.split("").map((c) => parseInt(c + c, 16));
+            return { r, g, b, a: h.length === 4 ? a / 255 : 1 };
+        }
+        if (h.length === 6 || h.length === 8) {
+            const at = (i) => parseInt(h.slice(i, i + 2), 16);
+            return { r: at(0), g: at(2), b: at(4), a: h.length === 8 ? at(6) / 255 : 1 };
+        }
+        return null;
+    }
+    const fn = /^(rgba?|hsla?)\(\s*([^)]+?)\s*\)$/i.exec(t);
+    if (!fn)
+        return null;
+    const parts = fn[2].split(/\s*[,/]\s*|\s+/).filter(Boolean);
+    if (parts.length < 3 || parts.length > 4)
+        return null;
+    const a = parseAlpha(parts[3]);
+    if (Number.isNaN(a))
+        return null;
+    if (fn[1].toLowerCase().startsWith("rgb")) {
+        const [r, g, b] = parts.slice(0, 3).map(channel);
+        if ([r, g, b].some(Number.isNaN))
+            return null;
+        return { r: clamp(r, 0, 255), g: clamp(g, 0, 255), b: clamp(b, 0, 255), a };
+    }
+    const h = parseFloat(parts[0]);
+    const sat = parseFloat(parts[1]) / 100;
+    const light = parseFloat(parts[2]) / 100;
+    if ([h, sat, light].some(Number.isNaN))
+        return null;
+    const [r, g, b] = hslToRgb(h, clamp(sat, 0, 1), clamp(light, 0, 1));
+    return { r, g, b, a };
+}
+/** Write a colour as CSS text in the requested format; alpha appears only when allowed and below 1. */
+export function formatColor(c, format, alpha) {
+    const a = alpha ? Math.round(c.a * 100) / 100 : 1;
+    const r = Math.round(c.r);
+    const g = Math.round(c.g);
+    const b = Math.round(c.b);
+    if (format === "rgb")
+        return a < 1 ? `rgba(${r}, ${g}, ${b}, ${a})` : `rgb(${r}, ${g}, ${b})`;
+    if (format === "hsl") {
+        const [h, s, l] = rgbToHsl(r, g, b);
+        const hh = Math.round(h);
+        const ss = Math.round(s * 100);
+        const ll = Math.round(l * 100);
+        return a < 1 ? `hsla(${hh}, ${ss}%, ${ll}%, ${a})` : `hsl(${hh}, ${ss}%, ${ll}%)`;
+    }
+    return `#${hex2(r)}${hex2(g)}${hex2(b)}${a < 1 ? hex2(a * 255) : ""}`;
+}
+/** The six-digit hex a native colour picker takes. */
+export const toHex6 = (c) => (c ? `#${hex2(c.r)}${hex2(c.g)}${hex2(c.b)}` : "#000000");
+/** Whether two colours are the same to the eye (by channel, not by text: '#FFF' is 'rgb(255, 255, 255)'). */
+export const sameColor = (a, c, alpha) => Boolean(a && c && Math.round(a.r) === Math.round(c.r) && Math.round(a.g) === Math.round(c.g) && Math.round(a.b) === Math.round(c.b) && (!alpha || Math.abs(a.a - c.a) < 0.005));
+export const colorPlaceholder = (format) => (format === "hex" ? "#000000" : format === "rgb" ? "rgb(0, 0, 0)" : "hsl(0, 0%, 0%)");
+//# sourceMappingURL=color.js.map

package/dist/color.js.map

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

package/dist/comparison.d.ts

@@ -0,0 +1,21 @@
+/** Comparison decisions: the best item per attribute, attribute groups, and who comes first. */
+/** Best item per attribute, when the attribute says which direction is better and one item wins outright. */
+export declare function bestPerAttribute(attributes: any[], count: number, at: (path: string, i: number) => unknown): Map<string, number>;
+/** Attributes under their group headings, in first-seen order. */
+export declare function groupAttributes<T extends {
+    group?: unknown;
+}>(attributes: T[], text: (v: unknown) => string): {
+    label?: string;
+    attributes: T[];
+}[];
+/** The recommended item comes first, so it's read (and seen on phones) first. */
+export declare function recommendedFirst(titles: string[], recommended: string | undefined): number[];
+/** Items under their group headings (Navigation), in first-seen order. */
+export declare function groupItems<T extends {
+    group?: unknown;
+}>(items: T[], text: (v: unknown) => string): {
+    label?: string;
+    items: T[];
+}[];
+/** A navigation's accessible name by kind, when the document gives none. */
+export declare const navigationLabel: (kind: string) => string;

package/dist/comparison.js

@@ -0,0 +1,51 @@
+/** Comparison decisions: the best item per attribute, attribute groups, and who comes first. */
+/** Best item per attribute, when the attribute says which direction is better and one item wins outright. */
+export function bestPerAttribute(attributes, count, at) {
+    const best = new Map();
+    for (const a of attributes) {
+        if (!a.better || a.better === "none")
+            continue;
+        const vals = Array.from({ length: count }, (_, i) => Number(at(a.path, i)));
+        const target = a.better === "higher" ? Math.max(...vals) : Math.min(...vals);
+        if (vals.filter((v) => v === target).length === 1)
+            best.set(a.key, vals.indexOf(target));
+    }
+    return best;
+}
+/** Attributes under their group headings, in first-seen order. */
+export function groupAttributes(attributes, text) {
+    const groups = [];
+    for (const a of attributes) {
+        const label = a.group !== undefined ? text(a.group) : undefined;
+        const g = groups.find((x) => x.label === label);
+        if (g)
+            g.attributes.push(a);
+        else
+            groups.push({ label, attributes: [a] });
+    }
+    return groups;
+}
+/** The recommended item comes first, so it's read (and seen on phones) first. */
+export function recommendedFirst(titles, recommended) {
+    const order = titles.map((_, i) => i);
+    const ri = order.findIndex((i) => titles[i] === recommended);
+    if (ri > 0)
+        order.unshift(...order.splice(ri, 1));
+    return order;
+}
+/** Items under their group headings (Navigation), in first-seen order. */
+export function groupItems(items, text) {
+    const groups = [];
+    for (const item of items) {
+        const g = item.group !== undefined ? text(item.group) : undefined;
+        const found = groups.find((x) => x.label === g);
+        if (found)
+            found.items.push(item);
+        else
+            groups.push({ label: g, items: [item] });
+    }
+    return groups;
+}
+/** A navigation's accessible name by kind, when the document gives none. */
+export const navigationLabel = (kind) => (kind === "breadcrumb" ? "Breadcrumb" : kind === "toc" ? "On this page" : "Main");
+//# sourceMappingURL=comparison.js.map

package/dist/comparison.js.map

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

package/dist/data.d.ts

@@ -0,0 +1,30 @@
+/** JSON Pointer helpers and binding resolution. Every binding resolves to an absolute pointer. */
+export type Data = Record<string, unknown>;
+/** Where relative paths resolve: the pointer of the current repeated item, or "" at top level. */
+export interface Scope {
+    pointer: string;
+}
+export declare const ROOT_SCOPE: Scope;
+export declare const isBinding: (v: unknown) => v is {
+    path: string;
+};
+/** Absolute pointer for a path: absolute paths stay; relative ones join the item scope. */
+export declare function absolute(path: string, scope: Scope): string;
+export declare function childPointer(pointer: string, key: string | number): string;
+export declare function get(data: unknown, pointer: string): unknown;
+/** Immutable set; creates intermediate objects (or arrays for numeric keys). */
+export declare function set(data: Data, pointer: string, value: unknown): Data;
+/**
+ * Host data as a list. A binding that a component repeats over should point at an array; when the
+ * host (or a generated document) points it somewhere else, the component shows nothing instead of
+ * throwing. The validator reports the mismatch.
+ */
+export declare const asList: (value: unknown) => unknown[];
+/** Resolves a literal-or-binding value. */
+export declare function resolve<T = unknown>(value: unknown, data: unknown, scope: Scope): T;
+/** Resolves every value in an action context. */
+export declare function resolveContext(context: Record<string, unknown> | undefined, data: unknown, scope: Scope): Record<string, unknown>;
+/** A value with bindings resolved wherever they sit in it (a Custom's props). */
+export declare function resolveDeep(value: unknown, data: unknown, scope: Scope): unknown;
+/** The scopes of a list binding's items, in order: what a repeated template renders in. */
+export declare function itemScopes(data: unknown, path: string, scope: Scope): Scope[];