@polyxd/core 0.3.0

package/dist/shortcuts.js

@@ -0,0 +1,59 @@
+/*
+ * Shortcut keys: how each is shown on Apple, shown elsewhere, written in aria-keyshortcuts, and
+ * what KeyboardEvent.key reports. Letters, digits and F-keys are derived. 'mod' is a modifier
+ * that resolves per platform, so it is handled in parseShortcut.
+ */
+export const SHORTCUT_KEYS = {
+    ctrl: ["⌃", "Ctrl", "Control", "ctrlKey"],
+    alt: ["⌥", "Alt", "Alt", "altKey"],
+    shift: ["⇧", "Shift", "Shift", "shiftKey"],
+    enter: ["↵", "Enter", "Enter", "enter"],
+    escape: ["⎋", "Esc", "Escape", "escape"],
+    space: ["Space", "Space", "Space", " "],
+    tab: ["⇥", "Tab", "Tab", "tab"],
+    backspace: ["⌫", "Backspace", "Backspace", "backspace"],
+    delete: ["⌦", "Del", "Delete", "delete"],
+    arrowup: ["↑", "↑", "ArrowUp", "arrowup"],
+    arrowdown: ["↓", "↓", "ArrowDown", "arrowdown"],
+    arrowleft: ["←", "←", "ArrowLeft", "arrowleft"],
+    arrowright: ["→", "→", "ArrowRight", "arrowright"],
+    home: ["Home", "Home", "Home", "home"],
+    end: ["End", "End", "End", "end"],
+    slash: ["/", "/", "/", "/"],
+    comma: [",", ",", ",", ","],
+    period: [".", ".", ".", "."],
+};
+export const MODIFIER_FLAGS = ["metaKey", "ctrlKey", "altKey", "shiftKey"];
+/** Splits "mod+shift+d" into what to show, what to announce, and what to match on keydown. */
+export function parseShortcut(shortcut, apple) {
+    const parts = shortcut.toLowerCase().split("+");
+    const key = parts.pop();
+    const hint = [];
+    const aria = [];
+    const flags = new Set();
+    for (const m of parts) {
+        const [a, o, name, flag] = m === "mod" ? (apple ? ["⌘", "Ctrl", "Meta", "metaKey"] : SHORTCUT_KEYS.ctrl) : SHORTCUT_KEYS[m];
+        hint.push(apple ? a : o);
+        aria.push(name);
+        flags.add(flag);
+    }
+    const named = SHORTCUT_KEYS[key];
+    hint.push(named ? (apple ? named[0] : named[1]) : key.toUpperCase());
+    aria.push(named ? named[2] : key.toUpperCase());
+    return { hint, aria: aria.join("+"), flags, key: named ? named[3] : key };
+}
+/**
+ * Whether a key event is this shortcut: the modifiers exactly, and the key by name, or by physical
+ * key for letters and digits (Alt on a Mac rewrites e.key to a symbol).
+ */
+export function shortcutMatches(s, e) {
+    if (!MODIFIER_FLAGS.every((f) => e[f] === s.flags.has(f)))
+        return false;
+    const physical = /^[a-z0-9]$/.test(s.key) && e.code.toLowerCase() === (/\d/.test(s.key) ? `digit${s.key}` : `key${s.key}`);
+    return e.key.toLowerCase() === s.key || physical;
+}
+/** Typing into a field must never fire an unmodified shortcut (shift alone still types). */
+export const unmodified = (s) => !s.flags.has("metaKey") && !s.flags.has("ctrlKey") && !s.flags.has("altKey");
+/** Whether a platform string names an Apple device, where 'mod' is ⌘. */
+export const isApplePlatform = (platform) => /mac|iphone|ipad|ipod/i.test(platform);
+//# sourceMappingURL=shortcuts.js.map

package/dist/shortcuts.js.map

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

package/dist/skeleton.d.ts

@@ -0,0 +1,22 @@
+/** The loading state for a surface that has not arrived yet: the shape it will take. */
+export type SkeletonShape = "list" | "form" | "detail" | "dashboard" | "dialog" | "compare";
+export type BlockKind = "title" | "line" | "small" | "field" | "button" | "square" | "circle" | "badge" | "value" | "chart";
+export type BlockSize = "short" | "medium" | "long" | "full";
+/** One placeholder block, or a group of them: rows, stacked lines, an action row, a list of pairs, cards. */
+export type SkeletonPart = {
+    block: BlockKind;
+    size?: BlockSize;
+} | {
+    group: "row" | "lines" | "actions" | "dl" | "cards" | "card";
+    parts: SkeletonPart[];
+};
+/** What each pattern's surface usually looks like, so the placeholder has the right silhouette. */
+export declare const PATTERN_SHAPE: Record<string, SkeletonShape>;
+/** An explicit shape wins; a pattern picks one; otherwise a record page. */
+export declare const skeletonShape: (pattern?: string, shape?: SkeletonShape) => SkeletonShape;
+/** The silhouettes, as data, so every renderer draws the same one. */
+export declare const SKELETON_SHAPES: Record<SkeletonShape, SkeletonPart[]>;
+/** The class each group takes, matching the stylesheet. */
+export declare const SKELETON_GROUP_CLASS: Record<string, string>;
+/** The status a skeleton announces. */
+export declare const skeletonStatus: (title?: string) => string;

package/dist/skeleton.js

@@ -0,0 +1,32 @@
+/** The loading state for a surface that has not arrived yet: the shape it will take. */
+/** What each pattern's surface usually looks like, so the placeholder has the right silhouette. */
+export const PATTERN_SHAPE = {
+    "multi-step-form": "form",
+    "filter-and-browse": "list",
+    "undo-over-confirm": "list",
+    "compare-and-choose": "compare",
+    "confirm-destructive": "dialog",
+    "review-and-submit": "detail",
+};
+/** An explicit shape wins; a pattern picks one; otherwise a record page. */
+export const skeletonShape = (pattern, shape) => shape ?? (pattern ? PATTERN_SHAPE[pattern] : undefined) ?? "detail";
+const block = (block, size) => ({ block, size });
+const group = (kind, parts) => ({ group: kind, parts });
+const times = (n, f) => Array.from({ length: n }, (_, i) => f(i));
+/** The silhouettes, as data, so every renderer draws the same one. */
+export const SKELETON_SHAPES = {
+    list: [block("field", "full"), ...times(5, (i) => group("row", [block("square"), group("lines", [block("line", i % 2 ? "medium" : "long"), block("small", "short")])]))],
+    form: [...times(4, (i) => group("lines", [block("small", "short"), block("field", i === 1 ? "medium" : "long")])), group("actions", [block("button"), block("button")])],
+    detail: [
+        group("row", [block("circle"), group("lines", [group("row", [block("line", "medium"), block("badge")]), block("small", "short")])]),
+        group("dl", times(6, (i) => group("row", [block("small", "short"), block("line", i % 3 === 2 ? "medium" : "long")]))),
+    ],
+    dashboard: [group("cards", times(3, () => group("card", [block("small", "short"), block("value", "medium")]))), block("chart", "full")],
+    dialog: [block("line", "long"), block("line", "medium"), group("actions", [block("button"), block("button")])],
+    compare: [group("cards", times(3, () => group("card", [block("line", "medium"), ...times(5, (i) => block("small", i % 2 ? "short" : "long"))])))],
+};
+/** The class each group takes, matching the stylesheet. */
+export const SKELETON_GROUP_CLASS = { row: "pxd-skeleton-row", lines: "pxd-skeleton-lines", actions: "pxd-skeleton-actions", dl: "pxd-skeleton-dl", cards: "pxd-skeleton-cards", card: "pxd-skeleton-card" };
+/** The status a skeleton announces. */
+export const skeletonStatus = (title) => (title ? `Preparing ${title}` : "Preparing");
+//# sourceMappingURL=skeleton.js.map

package/dist/skeleton.js.map

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

package/dist/split.d.ts

@@ -0,0 +1,53 @@
+/**
+ * Master and detail. Wide: two panes. Compact: the list, then the detail as a page with a Back
+ * control. The decisions live here so every renderer shows the same pane at the same width.
+ */
+import { type Scope } from "./data.ts";
+import type { Node } from "./document.ts";
+/** Below this surface width the detail replaces the list instead of sitting beside it. */
+export declare const SPLIT_COMPACT_PX = 640;
+/** The list's share of the width, by ratio, and how far a resizable handle may move it. */
+export declare const SHARE: Record<string, number>;
+export declare const SHARE_MIN = 20;
+export declare const SHARE_MAX = 80;
+export interface SplitState {
+    compact: boolean;
+    /** Back on compact shows the list again without dropping the selection. */
+    listShown: boolean;
+    share: number;
+}
+export type SplitAction = {
+    type: "measure";
+    width: number;
+} | {
+    type: "back";
+} | {
+    type: "selected";
+} | {
+    type: "share";
+    value: number;
+} | {
+    type: "key";
+    key: string;
+    shift?: boolean;
+};
+export declare const initialSplit: (ratio: string | undefined) => SplitState;
+export declare const clampShare: (v: number) => number;
+export declare function splitReducer(state: SplitState, action: SplitAction): SplitState;
+/** Which panes show: both when wide; on compact, the detail once something is selected, until Back. */
+export declare function splitPanes(state: SplitState, hasSelection: boolean): {
+    showList: boolean;
+    showDetail: boolean;
+};
+/** The value the primary selects an item by: its id when it has one, else its index (as Collection and Table do). */
+export declare const splitItemValue: (item: unknown, index: number, valuePath: string | undefined, data: unknown, pointer: string) => unknown;
+export interface SplitSelection {
+    has: boolean;
+    index: number;
+    /** The selected item's scope, so the detail's relative bindings read that item */
+    scope?: Scope;
+    /** The item's name, for the announcement: what the list shows as its title, else a name-like field */
+    name?: string;
+}
+/** What is selected in the primary, found the way the primary itself selects. */
+export declare function splitSelection(node: Node, byId: Map<string, Node>, data: unknown, scope: Scope): SplitSelection;

package/dist/split.js

@@ -0,0 +1,55 @@
+/**
+ * Master and detail. Wide: two panes. Compact: the list, then the detail as a page with a Back
+ * control. The decisions live here so every renderer shows the same pane at the same width.
+ */
+import { absolute, asList, childPointer, get, resolve } from "./data.js";
+/** Below this surface width the detail replaces the list instead of sitting beside it. */
+export const SPLIT_COMPACT_PX = 640;
+/** The list's share of the width, by ratio, and how far a resizable handle may move it. */
+export const SHARE = { narrow: 33.333, balanced: 50, wide: 66.667 };
+export const SHARE_MIN = 20;
+export const SHARE_MAX = 80;
+export const initialSplit = (ratio) => ({ compact: false, listShown: false, share: SHARE[ratio ?? "narrow"] ?? SHARE.narrow });
+export const clampShare = (v) => Math.min(SHARE_MAX, Math.max(SHARE_MIN, v));
+export function splitReducer(state, action) {
+    switch (action.type) {
+        case "measure":
+            return { ...state, compact: action.width < SPLIT_COMPACT_PX };
+        case "back":
+            return { ...state, listShown: true };
+        // A new selection shows its detail; on compact it takes the screen.
+        case "selected":
+            return { ...state, listShown: false };
+        case "share":
+            return { ...state, share: clampShare(action.value) };
+        case "key": {
+            const step = action.shift ? 10 : 5;
+            const next = action.key === "ArrowLeft" ? state.share - step : action.key === "ArrowRight" ? state.share + step : action.key === "Home" ? SHARE_MIN : action.key === "End" ? SHARE_MAX : undefined;
+            return next === undefined ? state : { ...state, share: clampShare(next) };
+        }
+    }
+}
+/** Which panes show: both when wide; on compact, the detail once something is selected, until Back. */
+export function splitPanes(state, hasSelection) {
+    const showDetail = !state.compact || (hasSelection && !state.listShown);
+    return { showList: !state.compact || !showDetail, showDetail };
+}
+/** The value the primary selects an item by: its id when it has one, else its index (as Collection and Table do). */
+export const splitItemValue = (item, index, valuePath, data, pointer) => valuePath ? get(data, absolute(valuePath, { pointer })) : item && typeof item === "object" && "id" in item ? item.id : index;
+/** What is selected in the primary, found the way the primary itself selects. */
+export function splitSelection(node, byId, data, scope) {
+    const selected = resolve(node.selected, data, scope);
+    const has = selected !== undefined && selected !== null && selected !== "";
+    const primary = byId.get(node.primary);
+    const listPath = primary?.component === "Table" ? primary.rows?.path : primary?.items?.path;
+    const pointer = typeof listPath === "string" ? absolute(listPath, scope) : undefined;
+    const items = pointer ? asList(get(data, pointer)) : [];
+    const index = pointer ? items.findIndex((item, i) => splitItemValue(item, i, primary?.rowValuePath, data, childPointer(pointer, i)) === selected) : -1;
+    const itemScope = pointer && index >= 0 ? { pointer: childPointer(pointer, index) } : undefined;
+    const template = primary?.items?.componentId ? byId.get(primary.items.componentId) : undefined;
+    const item = index >= 0 ? items[index] : undefined;
+    const titled = itemScope && template?.title !== undefined ? resolve(template.title, data, itemScope) : undefined;
+    const name = has ? String(titled ?? item?.name ?? item?.title ?? item?.label ?? selected) : undefined;
+    return { has, index, scope: itemScope, name };
+}
+//# sourceMappingURL=split.js.map

package/dist/split.js.map

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

package/dist/steps.d.ts

@@ -0,0 +1,32 @@
+/** The Steps state machines: a wizard's current step, and a task list's open task. */
+export interface StepsState {
+    index: number;
+    total: number;
+}
+export type StepsAction = {
+    type: "back";
+} | {
+    type: "next";
+} | {
+    type: "go";
+    index: number;
+};
+/** Moves within the steps; never past either end. */
+export declare function stepsReducer(state: StepsState, action: StepsAction): StepsState;
+/** Where a wizard starts: the bound step when the document binds one, else the first. */
+export declare const initialStep: (bound: unknown, total: number) => StepsState;
+export declare const isLastStep: (s: StepsState) => boolean;
+/** What the wizard says above the steps. */
+export declare const stepsProgress: (s: StepsState) => string;
+/** Task statuses (GOV.UK task list) and the tone each is shown in. */
+export declare const TASK_STATUS: Record<string, {
+    label: string;
+    tone: string;
+}>;
+export declare const taskStatus: (status: string | undefined) => {
+    label: string;
+    tone: string;
+};
+/** A task opens in place; opening another closes it; opening it again closes it. */
+export declare const tasklistReducer: (open: string | null, key: string) => string | null;
+export declare const tasklistProgress: (done: number, total: number) => string;

package/dist/steps.js

@@ -0,0 +1,24 @@
+/** The Steps state machines: a wizard's current step, and a task list's open task. */
+const clamp = (i, total) => Math.max(0, Math.min(total - 1, i));
+/** Moves within the steps; never past either end. */
+export function stepsReducer(state, action) {
+    const index = action.type === "back" ? state.index - 1 : action.type === "next" ? state.index + 1 : action.index;
+    return { ...state, index: clamp(index, state.total) };
+}
+/** Where a wizard starts: the bound step when the document binds one, else the first. */
+export const initialStep = (bound, total) => ({ index: typeof bound === "number" ? clamp(bound, total) : 0, total });
+export const isLastStep = (s) => s.index === s.total - 1;
+/** What the wizard says above the steps. */
+export const stepsProgress = (s) => `Step ${s.index + 1} of ${s.total}`;
+/** Task statuses (GOV.UK task list) and the tone each is shown in. */
+export const TASK_STATUS = {
+    todo: { label: "Not started", tone: "neutral" },
+    inProgress: { label: "In progress", tone: "info" },
+    done: { label: "Completed", tone: "success" },
+    blocked: { label: "Cannot start yet", tone: "neutral" },
+};
+export const taskStatus = (status) => TASK_STATUS[status ?? "todo"] ?? TASK_STATUS.todo;
+/** A task opens in place; opening another closes it; opening it again closes it. */
+export const tasklistReducer = (open, key) => (open === key ? null : key);
+export const tasklistProgress = (done, total) => `${done} of ${total} tasks completed`;
+//# sourceMappingURL=steps.js.map

package/dist/steps.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"steps.js","sourceRoot":"","sources":["../src/steps.ts"],"names":[],"mappings":"AAAA,sFAAsF;AAStF,MAAM,KAAK,GAAG,CAAC,CAAS,EAAE,KAAa,EAAE,EAAE,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC,EAAE,IAAI,CAAC,GAAG,CAAC,KAAK,GAAG,CAAC,EAAE,CAAC,CAAC,CAAC,CAAC;AAEhF,qDAAqD;AACrD,MAAM,UAAU,YAAY,CAAC,KAAiB,EAAE,MAAmB;IACjE,MAAM,KAAK,GAAG,MAAM,CAAC,IAAI,KAAK,MAAM,CAAC,CAAC,CAAC,KAAK,CAAC,KAAK,GAAG,CAAC,CAAC,CAAC,CAAC,MAAM,CAAC,IAAI,KAAK,MAAM,CAAC,CAAC,CAAC,KAAK,CAAC,KAAK,GAAG,CAAC,CAAC,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC;IACjH,OAAO,EAAE,GAAG,KAAK,EAAE,KAAK,EAAE,KAAK,CAAC,KAAK,EAAE,KAAK,CAAC,KAAK,CAAC,EAAE,CAAC;AACxD,CAAC;AAED,yFAAyF;AACzF,MAAM,CAAC,MAAM,WAAW,GAAG,CAAC,KAAc,EAAE,KAAa,EAAc,EAAE,CAAC,CAAC,EAAE,KAAK,EAAE,OAAO,KAAK,KAAK,QAAQ,CAAC,CAAC,CAAC,KAAK,CAAC,KAAK,EAAE,KAAK,CAAC,CAAC,CAAC,CAAC,CAAC,EAAE,KAAK,EAAE,CAAC,CAAC;AAElJ,MAAM,CAAC,MAAM,UAAU,GAAG,CAAC,CAAa,EAAW,EAAE,CAAC,CAAC,CAAC,KAAK,KAAK,CAAC,CAAC,KAAK,GAAG,CAAC,CAAC;AAE9E,4CAA4C;AAC5C,MAAM,CAAC,MAAM,aAAa,GAAG,CAAC,CAAa,EAAU,EAAE,CAAC,QAAQ,CAAC,CAAC,KAAK,GAAG,CAAC,OAAO,CAAC,CAAC,KAAK,EAAE,CAAC;AAE5F,sEAAsE;AACtE,MAAM,CAAC,MAAM,WAAW,GAAoD;IAC1E,IAAI,EAAE,EAAE,KAAK,EAAE,aAAa,EAAE,IAAI,EAAE,SAAS,EAAE;IAC/C,UAAU,EAAE,EAAE,KAAK,EAAE,aAAa,EAAE,IAAI,EAAE,MAAM,EAAE;IAClD,IAAI,EAAE,EAAE,KAAK,EAAE,WAAW,EAAE,IAAI,EAAE,SAAS,EAAE;IAC7C,OAAO,EAAE,EAAE,KAAK,EAAE,kBAAkB,EAAE,IAAI,EAAE,SAAS,EAAE;CACxD,CAAC;AAEF,MAAM,CAAC,MAAM,UAAU,GAAG,CAAC,MAA0B,EAAmC,EAAE,CAAC,WAAW,CAAC,MAAM,IAAI,MAAM,CAAC,IAAI,WAAW,CAAC,IAAI,CAAC;AAE7I,oFAAoF;AACpF,MAAM,CAAC,MAAM,eAAe,GAAG,CAAC,IAAmB,EAAE,GAAW,EAAiB,EAAE,CAAC,CAAC,IAAI,KAAK,GAAG,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC;AAEhH,MAAM,CAAC,MAAM,gBAAgB,GAAG,CAAC,IAAY,EAAE,KAAa,EAAU,EAAE,CAAC,GAAG,IAAI,OAAO,KAAK,kBAAkB,CAAC"}

package/dist/surface.d.ts

@@ -0,0 +1,52 @@
+import { type Data, type Scope } from "./data.ts";
+import type { Action, ActionEvent, Node, UIDocument } from "./document.ts";
+import { type Format } from "./format.ts";
+export interface SurfaceOptions {
+    /** Host data. Defaults to document.data. */
+    data?: Data;
+    locale?: string;
+    /**
+     * Derived data: called after every input change with the new data and may return a replacement,
+     * so a receipt, a total or a filtered list can follow what the person types. Pure.
+     */
+    derive?: (data: Data) => Data | void;
+    /** Called for every capability action the user triggers. */
+    onAction?: (event: ActionEvent) => void;
+    /** Called with the new data whenever an input changes it. */
+    onDataChange?: (data: Data) => void;
+    /** Called for ui.dismiss (Cancel on a dialog, closing the surface). */
+    onDismiss?: () => void;
+}
+export interface Surface {
+    document: UIDocument;
+    byId: Map<string, Node>;
+    /** The current data; a new object after every change. */
+    readonly data: Data;
+    locale: string;
+    /** Writes an input's value at an absolute pointer, derives, and tells the host and the subscribers. */
+    setValue: (pointer: string, value: unknown) => void;
+    /** Replaces the data wholesale (a shell adopting the host's new copy). */
+    replaceData: (data: Data) => void;
+    dispatch: (action: Action | undefined, scope: Scope, source: string) => void;
+    /** Called after every change to the data; returns the unsubscribe. */
+    subscribe: (listener: (data: Data) => void) => () => void;
+    /** A literal or binding, resolved in a scope (the root scope by default). */
+    resolve: <T = unknown>(value: unknown, scope?: Scope) => T;
+    /** A literal or binding as text, formatted when a format is given. */
+    text: (value: unknown, format?: Format, scope?: Scope) => string;
+    /** The absolute pointer of a binding in a scope. */
+    pointer: (binding: {
+        path: string;
+    }, scope?: Scope) => string;
+    /** Writes a binding's value in a scope. */
+    write: (binding: {
+        path: string;
+    }, value: unknown, scope?: Scope) => void;
+    /** An action context with its bindings resolved in a scope. */
+    context: (context: Record<string, unknown> | undefined, scope?: Scope) => Record<string, unknown>;
+    /** Whether a node is visible in a scope: its `visible` binding, when it has one. */
+    visible: (node: Node, scope?: Scope) => boolean;
+}
+export declare function createSurface(document: UIDocument, options?: SurfaceOptions): Surface;
+/** Accessibility attributes from a node's `accessibility` block, plus which component rendered the element. */
+export declare function a11yAttributes(node: Node, resolveText: (v: unknown) => string | undefined): Record<string, unknown>;

package/dist/surface.js

@@ -0,0 +1,64 @@
+/**
+ * The headless surface: one document, its data, and the semantics every renderer shares, with no
+ * DOM and no framework. A renderer walks `byId` from `document.root`, reads values through
+ * `resolve` and `text`, writes inputs through `setValue`, sends actions through `dispatch`, and
+ * redraws on `subscribe`.
+ */
+import { dispatchAction } from "./actions.js";
+import { ROOT_SCOPE, absolute, resolve, resolveContext, set } from "./data.js";
+import { indexById } from "./document.js";
+import { formatValue, resolveFormat } from "./format.js";
+export function createSurface(document, options = {}) {
+    let data = options.data ?? document.data ?? {};
+    const listeners = new Set();
+    const locale = options.locale ?? "en-GB";
+    const notify = () => listeners.forEach((l) => l(data));
+    const surface = {
+        document,
+        byId: indexById(document),
+        get data() {
+            return data;
+        },
+        locale,
+        setValue(pointer, value) {
+            const written = set(data, pointer, value);
+            data = options.derive?.(written) ?? written;
+            options.onDataChange?.(data);
+            notify();
+        },
+        replaceData(next) {
+            data = next;
+            notify();
+        },
+        dispatch: (action, scope, source) => dispatchAction(action, scope, source, data, options),
+        subscribe(listener) {
+            listeners.add(listener);
+            return () => listeners.delete(listener);
+        },
+        resolve: (value, scope = ROOT_SCOPE) => resolve(value, data, scope),
+        text(value, format, scope = ROOT_SCOPE) {
+            const r = resolve(value, data, scope);
+            return format ? formatValue(r, resolveFormat(format, data, scope), locale) : r === undefined || r === null ? "" : String(r);
+        },
+        pointer: (binding, scope = ROOT_SCOPE) => absolute(binding.path, scope),
+        write: (binding, value, scope = ROOT_SCOPE) => surface.setValue(absolute(binding.path, scope), value),
+        context: (context, scope = ROOT_SCOPE) => resolveContext(context, data, scope),
+        visible: (node, scope = ROOT_SCOPE) => node.visible === undefined || resolve(node.visible, data, scope) !== false,
+    };
+    return surface;
+}
+/** Accessibility attributes from a node's `accessibility` block, plus which component rendered the element. */
+export function a11yAttributes(node, resolveText) {
+    const ids = { "data-pxd-id": node.id, "data-pxd-component": node.component };
+    const a = node.accessibility;
+    if (!a)
+        return ids;
+    return {
+        ...ids,
+        "aria-label": a.label !== undefined ? resolveText(a.label) : undefined,
+        "aria-description": a.description !== undefined ? resolveText(a.description) : undefined,
+        "aria-live": a.live,
+        "aria-hidden": a.hidden || undefined,
+    };
+}
+//# sourceMappingURL=surface.js.map

package/dist/surface.js.map

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

package/dist/table.d.ts

@@ -0,0 +1,34 @@
+/** Table decisions: when it stacks, which columns are numbers, what a stacked row shows, paging. */
+import { type Scope } from "./data.ts";
+import type { Node } from "./document.ts";
+/** Below this width a table becomes a list of rows. */
+export declare const TABLE_COMPACT_PX = 720;
+export declare const PAGE_SIZES: number[];
+export declare const isNumericColumn: (c: any) => boolean;
+/** A stacked row: the first column as its title, one status badge, and up to three details. */
+export declare function stackedColumns(columns: any[]): {
+    first: any;
+    status: any | undefined;
+    details: any[];
+};
+/** The value a row is selected and expanded by: rowValuePath, else the row's id, else its index. */
+export declare const rowValue: (node: Node, rows: unknown[], i: number, data: unknown, scope: Scope) => unknown;
+export declare const rowScopes: (pointer: string, rows: unknown[]) => Scope[];
+/** Toggles a value in a selection list. */
+export declare const toggleValue: (list: unknown[], v: unknown) => unknown[];
+/** Sorting a column again flips it; sorting another starts ascending. */
+export declare const nextSort: (key: string, column: string | undefined, direction: string | undefined) => "ascending" | "descending";
+/** How many cells a row has, for a detail row that spans them. */
+export declare const columnCount: (node: Node, expandable: boolean, selectable: boolean) => number;
+export interface PagingState {
+    index: number;
+    size: number;
+    total: number;
+    pages: number;
+    from: number;
+    to: number;
+    /** The sizes offered, always including the current one */
+    sizes: number[];
+}
+/** Rows per page, the range shown, and how many pages there are. */
+export declare function paging(index: unknown, size: unknown, total: unknown, rows: number): PagingState;

package/dist/table.js

@@ -0,0 +1,30 @@
+/** Table decisions: when it stacks, which columns are numbers, what a stacked row shows, paging. */
+import { absolute, childPointer, get } from "./data.js";
+/** Below this width a table becomes a list of rows. */
+export const TABLE_COMPACT_PX = 720;
+export const PAGE_SIZES = [10, 25, 50, 100];
+const NUMERIC = new Set(["number", "currency", "percent", "duration"]);
+export const isNumericColumn = (c) => c.align === "end" || (c.align !== "start" && (c.kind === "number" || c.kind === "currency" || NUMERIC.has(c.format?.type)));
+/** A stacked row: the first column as its title, one status badge, and up to three details. */
+export function stackedColumns(columns) {
+    const [first, ...rest] = columns;
+    return { first, status: rest.find((c) => c.kind === "status"), details: rest.filter((c) => c.kind !== "status").slice(0, 3) };
+}
+/** The value a row is selected and expanded by: rowValuePath, else the row's id, else its index. */
+export const rowValue = (node, rows, i, data, scope) => node.rowValuePath ? get(data, absolute(node.rowValuePath, scope)) : (rows[i]?.id ?? i);
+export const rowScopes = (pointer, rows) => rows.map((_, i) => ({ pointer: childPointer(pointer, i) }));
+/** Toggles a value in a selection list. */
+export const toggleValue = (list, v) => (list.includes(v) ? list.filter((x) => x !== v) : [...list, v]);
+/** Sorting a column again flips it; sorting another starts ascending. */
+export const nextSort = (key, column, direction) => (key === column && direction === "ascending" ? "descending" : "ascending");
+/** How many cells a row has, for a detail row that spans them. */
+export const columnCount = (node, expandable, selectable) => node.columns.length + (expandable ? 1 : 0) + (selectable ? 1 : 0) + (node.rowActions || node.rowAction ? 1 : 0);
+/** Rows per page, the range shown, and how many pages there are. */
+export function paging(index, size, total, rows) {
+    const i = typeof index === "number" ? index : 1;
+    const s = typeof size === "number" ? size : rows;
+    const t = typeof total === "number" ? total : rows;
+    const pages = Math.max(1, Math.ceil(t / (s || 1)));
+    return { index: i, size: s, total: t, pages, from: t === 0 ? 0 : (i - 1) * s + 1, to: Math.min(i * s, t), sizes: [...new Set([...PAGE_SIZES, s])].sort((a, c) => a - c) };
+}
+//# sourceMappingURL=table.js.map

package/dist/table.js.map

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

package/dist/tree.d.ts

@@ -0,0 +1,58 @@
+/** Tree: the open part of a hierarchy flattened into rows, and the moves between them. */
+import { type Scope } from "./data.ts";
+import type { Node } from "./document.ts";
+/** Beyond this many visible rows the tree renders only the rows in (and just around) its viewport. */
+export declare const VIRTUAL_LIMIT = 200;
+/** Rows rendered above and below the viewport so keyboard moves and quick scrolls don't flash blank. */
+export declare const OVERSCAN = 10;
+/** Type-ahead resets after this pause. */
+export declare const TYPEAHEAD_MS = 500;
+/** One visible row of the flattened tree. */
+export interface TreeRow {
+    /** Pointer to the node in host data; stable identity for keys and focus. */
+    key: string;
+    scope: Scope;
+    level: number;
+    setsize: number;
+    posinset: number;
+    label: string;
+    value: unknown;
+    detail: string | undefined;
+    hasChildren: boolean;
+    expanded: boolean;
+    /** Index of the parent row in the flat list, -1 at the top level. */
+    parent: number;
+}
+/** Flatten the open part of the hierarchy, depth first. Without an expanded set, the first level is open. */
+export declare function treeRows(node: Node, data: unknown, scope: Scope, expanded: Set<unknown> | null): {
+    rows: TreeRow[];
+    indexByKey: Map<string, number>;
+    topValues: unknown[];
+};
+/** Type-ahead: the next row whose label starts with what was typed; the same letter repeated cycles. */
+export declare function typeAheadTarget(rows: TreeRow[], from: number, buffer: string): number;
+/** What a key does in a tree (WAI-ARIA APG tree view): where focus goes, or what toggles. */
+export type TreeMove = {
+    focus: number;
+} | {
+    toggle: true;
+} | {
+    activate: true;
+} | {
+    select: true;
+} | {
+    expandSiblings: true;
+} | {
+    typeAhead: string;
+} | undefined;
+export declare function treeKey(rows: TreeRow[], index: number, e: {
+    key: string;
+    ctrlKey: boolean;
+    metaKey: boolean;
+    altKey: boolean;
+}): TreeMove;
+/** The window of rows to draw when virtualised. */
+export declare function visibleWindow(rowCount: number, scrollTop: number, rowHeight: number, viewportHeight: number): {
+    start: number;
+    end: number;
+};