@ahoo-wang/wow-view-engine 9.2.0-rc.0

package/dist/ui/record/sticky.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"sticky.d.ts","sourceRoot":"","sources":["../../../src/ui/record/sticky.ts"],"names":[],"mappings":"AAcA,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,OAAO,CAAC;AAE3C;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA6BG;AAEH,oDAAoD;AACpD,MAAM,MAAM,OAAO,GAAG,MAAM,GAAG,OAAO,CAAC;AA2FvC;;;;;;GAMG;AACH,MAAM,WAAW,OAAO;IACtB,IAAI,EAAE,MAAM,CAAC;IACb;;;OAGG;IACH,KAAK,CAAC,EAAE,MAAM,CAAC;IACf;;;;OAIG;IACH,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB;;;;OAIG;IACH,IAAI,EAAE,OAAO,CAAC;CACf;AAED;;;;;;;;;;;GAWG;AACH,MAAM,WAAW,QAAQ;IACvB,IAAI,EAAE,OAAO,CAAC;IACd,wEAAwE;IACxE,IAAI,EAAE,OAAO,CAAC;CACf;AAED;;;;GAIG;AACH,MAAM,MAAM,SAAS,GAAG,OAAO,GAAG,QAAQ,CAAC;AAE3C,qDAAqD;AACrD,MAAM,WAAW,eAAe;IAC9B,SAAS,EAAE,MAAM,CAAC;IAClB,KAAK,CAAC,EAAE,aAAa,CAAC;IACtB,UAAU,CAAC,EAAE,OAAO,CAAC;IACrB,eAAe,CAAC,EAAE,EAAE,CAAC;IACrB,gBAAgB,CAAC,EAAE,MAAM,CAAC;CAC3B;AAED,4EAA4E;AAC5E,MAAM,WAAW,WAAW;IAC1B,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,KAAK,CAAC,EAAE,aAAa,CAAC;CACvB;AAED;;;;;;;;;GASG;AACH,wBAAgB,UAAU,CACxB,GAAG,EAAE,SAAS,GAAG,SAAS,EAC1B,OAAO,GAAE,WAAgB,GACxB,eAAe,CASjB;AAED;;;;;;;;;GASG;AACH,wBAAgB,UAAU,CACxB,GAAG,EAAE,SAAS,GAAG,SAAS,EAC1B,OAAO,GAAE,WAAgB,GACxB,eAAe,CAIjB;AAED;;;;;;;;;;;;GAYG;AACH,eAAO,MAAM,SAAS,6BAA6B,CAAC;AAEpD;;;;;;;;;;;;;;;;;;GAkBG;AACH,eAAO,MAAM,IAAI;;;CAGP,CAAC;AAEX;;;;;GAKG;AACH,eAAO,MAAM,QAAQ;;;CAGX,CAAC;AAEX,oEAAoE;AACpE,MAAM,WAAW,eAAe;IAC9B,SAAS,EAAE,MAAM,CAAC;IAClB,aAAa,EAAE,KAAK,GAAG,QAAQ,CAAC;CACjC;AAED;;;;;;;;;GASG;AACH,wBAAgB,UAAU,CAAC,EAAE,EAAE,KAAK,GAAG,QAAQ,GAAG,eAAe,CAShE;AAED;;;;;;;GAOG;AACH,MAAM,WAAW,eAAe;IAC9B,SAAS,EAAE,MAAM,CAAC;IAClB;;;;;OAKG;IACH,cAAc,CAAC,EAAE,EAAE,CAAC;CACrB;AAED;;;;;;;;;;;;;;;;;GAiBG;AACH,wBAAgB,UAAU,CAAC,OAAO,EAAE,OAAO,GAAG,eAAe,CAW5D;AAED;;;;;;GAMG;AACH,wBAAgB,MAAM,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM,CAE5C"}

package/dist/ui/record/summaryText.d.ts

@@ -0,0 +1,10 @@
+import { SummaryCell } from '../../record/index.js';
+import { DisplayContext } from '../kit/display.js';
+import { MessageFormatters } from '../kit/MessagesProvider.js';
+/**
+ * How one summary reads: under its column, in a card, and named by the
+ * summary row when its column is out of view — one path, so the three never
+ * disagree.
+ */
+export declare function summaryText(cell: SummaryCell, messages: MessageFormatters, display: DisplayContext): string;
+//# sourceMappingURL=summaryText.d.ts.map

package/dist/ui/record/summaryText.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"summaryText.d.ts","sourceRoot":"","sources":["../../../src/ui/record/summaryText.ts"],"names":[],"mappings":"AAaA,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,uBAAuB,CAAC;AAEzD,OAAO,EAAY,KAAK,cAAc,EAAE,MAAM,mBAAmB,CAAC;AAClE,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,4BAA4B,CAAC;AAEpE;;;;GAIG;AACH,wBAAgB,WAAW,CACzB,IAAI,EAAE,WAAW,EACjB,QAAQ,EAAE,iBAAiB,EAC3B,OAAO,EAAE,cAAc,GACtB,MAAM,CAwBR"}

package/dist/ui/record/useOffscreenColumns.d.ts

@@ -0,0 +1,36 @@
+import { RefObject } from 'react';
+import { OffscreenColumns } from './offscreenSummaries.js';
+/**
+ * What a summary reading in the footer is marked with: the field of the
+ * column it stands under. The observer watches these and nothing else.
+ */
+export declare const SUMMARY_READING = "data-summary-field";
+/**
+ * The box that scrolls the table sideways: its own port, or — where the
+ * table turns that off — whatever around it clips it, a board panel's body.
+ * `null` is the viewport.
+ */
+export declare function scrollRootOf(node: Element): Element | null;
+/**
+ * Which summarised columns lie outside the table's horizontal view (D51).
+ *
+ * One `IntersectionObserver`, rooted at the box that scrolls the table
+ * sideways, watches the summary readings in the footer; it is told about
+ * scrolling and resizing by the browser, so nothing here listens to either.
+ * The root is stretched without end vertically — the question is only
+ * sideways, and the band is held to the bottom of its port anyway — and
+ * pulled in at each end by the columns held there. A field is out of view
+ * when any of its readings is not whole in view.
+ *
+ * It is built again whenever the footer's cells may have changed — the rows,
+ * the columns or what is held — over the new cells and the held columns'
+ * new widths.
+ */
+export declare function useOffscreenColumns(footer: RefObject<HTMLElement | null>, rows: unknown, columns: unknown, pins: unknown): OffscreenColumns;
+/**
+ * Bring a column's summary into view: scroll the root sideways by as little
+ * as puts the cell between the held columns, which `scrollIntoView` cannot
+ * do — it knows nothing of what is pinned over the port's edges.
+ */
+export declare function revealCell(cell: HTMLElement): void;
+//# sourceMappingURL=useOffscreenColumns.d.ts.map

package/dist/ui/record/useOffscreenColumns.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"useOffscreenColumns.d.ts","sourceRoot":"","sources":["../../../src/ui/record/useOffscreenColumns.ts"],"names":[],"mappings":"AAaA,OAAO,EAAuB,KAAK,SAAS,EAAE,MAAM,OAAO,CAAC;AAC5D,OAAO,KAAK,EAAE,gBAAgB,EAAiB,MAAM,yBAAyB,CAAC;AAE/E;;;GAGG;AACH,eAAO,MAAM,eAAe,uBAAuB,CAAC;AAUpD;;;;GAIG;AACH,wBAAgB,YAAY,CAAC,IAAI,EAAE,OAAO,GAAG,OAAO,GAAG,IAAI,CAM1D;AAyCD;;;;;;;;;;;;;;GAcG;AACH,wBAAgB,mBAAmB,CACjC,MAAM,EAAE,SAAS,CAAC,WAAW,GAAG,IAAI,CAAC,EACrC,IAAI,EAAE,OAAO,EACb,OAAO,EAAE,OAAO,EAChB,IAAI,EAAE,OAAO,GACZ,gBAAgB,CA2ClB;AAED;;;;GAIG;AACH,wBAAgB,UAAU,CAAC,IAAI,EAAE,WAAW,GAAG,IAAI,CAmBlD"}

package/dist/ui/record/useSummaries.d.ts

@@ -0,0 +1,31 @@
+import { RecordColumnView, RecordPaging, RecordRow, SummaryRow } from '../../record/index.js';
+/**
+ * The two scopes, from the one the runtime executed.
+ *
+ * The totals row is the one that costs a query; the page row is the rows on
+ * screen added up, so it is derived here rather than asked for. When the
+ * totals query failed the runtime already fell back to the page, and that
+ * single row stands on its own — inventing the other one is exactly the
+ * mistake the scope labels exist to prevent.
+ *
+ * When the page holds every row the conditions match there is one scope, not
+ * two: the page row would repeat the totals under another name, and two
+ * identical rows ask the reader to find a difference that is not there. The
+ * totals row is the one kept, because it stays true when the result grows
+ * past a page (D26 Q40, the exception to D18 V's two rows).
+ */
+export declare function useSummaries(summaries: SummaryRow | null, rows: readonly RecordRow[], paging: RecordPaging | null): readonly SummaryRow[];
+/**
+ * Whether a table's summary band has anything to say under its columns.
+ *
+ * The band is the numbers under the columns they summarise, with the scope
+ * in a label beside them. A summary whose field is not a column on screen —
+ * the column taken out of the table since the summary was configured — has
+ * no cell to sit in, so a band of such summaries alone is a grey strip that
+ * reads 「全部」 and nothing else, and in a board panel it is one more row
+ * of height taken from the records. So there is no band unless at least one
+ * drawn column carries a summary. The cards keep theirs: they list each
+ * summary by its own label rather than under a column.
+ */
+export declare function summarisesColumns(summaries: SummaryRow | null, columns: readonly RecordColumnView[]): boolean;
+//# sourceMappingURL=useSummaries.d.ts.map

package/dist/ui/record/useSummaries.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"useSummaries.d.ts","sourceRoot":"","sources":["../../../src/ui/record/useSummaries.ts"],"names":[],"mappings":"AAcA,OAAO,EAEL,KAAK,gBAAgB,EACrB,KAAK,YAAY,EACjB,KAAK,SAAS,EACd,KAAK,UAAU,EAChB,MAAM,uBAAuB,CAAC;AAiB/B;;;;;;;;;;;;;;GAcG;AACH,wBAAgB,YAAY,CAC1B,SAAS,EAAE,UAAU,GAAG,IAAI,EAC5B,IAAI,EAAE,SAAS,SAAS,EAAE,EAC1B,MAAM,EAAE,YAAY,GAAG,IAAI,GAC1B,SAAS,UAAU,EAAE,CAOvB;AAED;;;;;;;;;;;GAWG;AACH,wBAAgB,iBAAiB,CAC/B,SAAS,EAAE,UAAU,GAAG,IAAI,EAC5B,OAAO,EAAE,SAAS,gBAAgB,EAAE,GACnC,OAAO,CAIT"}

package/dist/ui/sort/SortSettings.d.ts

@@ -0,0 +1,47 @@
+import { ReactElement } from 'react';
+import { FieldDefinition, FieldGroupDefinition, RecordSort } from '../../model/index.js';
+import { DetachedPopover } from '../kit/toolbar.js';
+/**
+ * What the editor needs of whoever owns the sort: the record table, or the
+ * analysis editor with its aliases standing in for fields.
+ */
+export interface SortOwner {
+    sort: RecordSort[];
+    setSort(sort: RecordSort[]): void;
+    maxSortFields: number;
+}
+export interface SortSettingsProps {
+    table: SortOwner;
+    /** The fields the definition offers; only sortable ones are listed. */
+    fields: readonly FieldDefinition[];
+    /** The picker groups of the definition the fields come from. */
+    fieldGroups?: readonly FieldGroupDefinition[];
+    /**
+     * What is being ordered, which decides the words (the 2026-09-23 audit,
+     * P2-3). `'records'` — the record toolbar — orders rows by fields, and
+     * the unsorted button says 「排序」 because nothing else names it.
+     * `'groups'` — the analysis tray — orders an answer's groups by its
+     * dimensions and metrics, and the control sits under its own 「排序」
+     * title: the button then says the state, 「未排序」, rather than the
+     * title again, and the editor speaks of dimensions and metrics.
+     */
+    of?: 'records' | 'groups';
+    /**
+     * The control that opens it, where the toolbar's is not on screen: the
+     * error strip's worded button for a config that will not run (as
+     * `ColumnSettings`' `trigger`). Left out, the toolbar's own button.
+     */
+    trigger?: ReactElement<Record<string, unknown>>;
+    /** One half of it, as `ColumnSettings`' `detached`. */
+    detached?: DetachedPopover;
+}
+/**
+ * What the rows are ordered by, said on the button and edited behind it.
+ *
+ * The header's own toggle orders by one column at a time and cannot say
+ * which of several comes first. This does both: the button reads the sort
+ * back in words, and the editor behind it shows each field with its
+ * direction and its place in the priority.
+ */
+export declare function SortSettings({ table, fields, fieldGroups, of, trigger, detached, }: SortSettingsProps): import('react').JSX.Element | null;
+//# sourceMappingURL=SortSettings.d.ts.map

package/dist/ui/sort/SortSettings.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"SortSettings.d.ts","sourceRoot":"","sources":["../../../src/ui/sort/SortSettings.tsx"],"names":[],"mappings":"AAaA,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,OAAO,CAAC;AAU1C,OAAO,KAAK,EACV,eAAe,EACf,oBAAoB,EACpB,UAAU,EAEX,MAAM,sBAAsB,CAAC;AAwC9B,OAAO,EAAe,KAAK,eAAe,EAAE,MAAM,mBAAmB,CAAC;AAyDtE;;;GAGG;AACH,MAAM,WAAW,SAAS;IACxB,IAAI,EAAE,UAAU,EAAE,CAAC;IACnB,OAAO,CAAC,IAAI,EAAE,UAAU,EAAE,GAAG,IAAI,CAAC;IAClC,aAAa,EAAE,MAAM,CAAC;CACvB;AAED,MAAM,WAAW,iBAAiB;IAChC,KAAK,EAAE,SAAS,CAAC;IACjB,uEAAuE;IACvE,MAAM,EAAE,SAAS,eAAe,EAAE,CAAC;IACnC,gEAAgE;IAChE,WAAW,CAAC,EAAE,SAAS,oBAAoB,EAAE,CAAC;IAC9C;;;;;;;;OAQG;IACH,EAAE,CAAC,EAAE,SAAS,GAAG,QAAQ,CAAC;IAC1B;;;;OAIG;IACH,OAAO,CAAC,EAAE,YAAY,CAAC,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC,CAAC;IAChD,uDAAuD;IACvD,QAAQ,CAAC,EAAE,eAAe,CAAC;CAC5B;AAoBD;;;;;;;GAOG;AACH,wBAAgB,YAAY,CAAC,EAC3B,KAAK,EACL,MAAM,EACN,WAAW,EACX,EAAc,EACd,OAAO,EACP,QAAQ,GACT,EAAE,iBAAiB,sCA2NnB"}

package/dist/ui/sort/drag.d.ts

@@ -0,0 +1,53 @@
+import { RecordSort } from '../../model/index.js';
+import { DragWordingKeys } from '../kit/dragWording.js';
+import { DropOperation } from '../kit/dragDrop.js';
+import { MessageFormatters } from '../kit/MessagesProvider.js';
+/** The two places one drop is between, as positions in the sort. */
+export interface SortDrop {
+    from: number;
+    to: number;
+}
+/** The library's id for the entry at this place. */
+export declare function sortEntryId(index: number): string;
+/** The place an id names, or null when it names nothing this list drew. */
+export declare function sortEntryIndex(id: string): number | null;
+/**
+ * The move this drop is, or null.
+ *
+ * Whether there was a drop at all is the one guard every list here shares
+ * ({@link dropped}) — a drag that was given up is not a drop, and neither is
+ * one that ended on the entry it started from: both would spend an `edit` and
+ * an `apply` — a query and a revision — to put the rows back in the order they
+ * are already in. What is added on top is that the two ids have to name places
+ * in this list.
+ */
+export declare function sortDrop(operation: DropOperation, canceled: boolean | undefined): SortDrop | null;
+/**
+ * The whole sort after one entry moves, or null when the move changes
+ * nothing — an end of the list, a place that is not in it, a drop on the
+ * entry it started from.
+ *
+ * The answer is the whole order rather than a pair of indexes because that
+ * is what `setSort` takes: which field comes first is one write, the same
+ * write that flips a direction or drops an entry, and reordering is not a
+ * different kind of edit from those.
+ */
+export declare function reorderSort(sort: readonly RecordSort[], from: number, to: number): RecordSort[] | null;
+/** Where this list's drag sentences live in the catalogue. */
+export declare const SORT_DRAG_WORDING: DragWordingKeys;
+/**
+ * What a screen reader hears while a sort entry is being carried: the shared
+ * wording of a drag ({@link dragAccessibility}) said in this editor's own
+ * words, with the ids the library is holding turned back into the field
+ * labels on screen.
+ */
+export declare function sortDragAccessibility(messages: MessageFormatters, labelFor: (id: string) => string): {
+    screenReaderInstructions: {
+        draggable: string;
+    };
+    announcements: {
+        dragstart: (event: import('../kit/dragAnnounce.js').DragAnnouncement) => string | undefined;
+        dragend: (event: import('../kit/dragAnnounce.js').DragAnnouncement) => string | undefined;
+    };
+};
+//# sourceMappingURL=drag.d.ts.map

package/dist/ui/sort/drag.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"drag.d.ts","sourceRoot":"","sources":["../../../src/ui/sort/drag.ts"],"names":[],"mappings":"AAaA;;;;;;;;GAQG;AAEH,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,sBAAsB,CAAC;AAEvD,OAAO,EAAe,KAAK,eAAe,EAAE,MAAM,uBAAuB,CAAC;AAC1E,OAAO,EAAW,KAAK,aAAa,EAAE,MAAM,oBAAoB,CAAC;AACjE,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,4BAA4B,CAAC;AAEpE,oEAAoE;AACpE,MAAM,WAAW,QAAQ;IACvB,IAAI,EAAE,MAAM,CAAC;IACb,EAAE,EAAE,MAAM,CAAC;CACZ;AAaD,oDAAoD;AACpD,wBAAgB,WAAW,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM,CAEjD;AAED,2EAA2E;AAC3E,wBAAgB,cAAc,CAAC,EAAE,EAAE,MAAM,GAAG,MAAM,GAAG,IAAI,CAIxD;AAED;;;;;;;;;GASG;AACH,wBAAgB,QAAQ,CACtB,SAAS,EAAE,aAAa,EACxB,QAAQ,EAAE,OAAO,GAAG,SAAS,GAC5B,QAAQ,GAAG,IAAI,CAOjB;AAED;;;;;;;;;GASG;AACH,wBAAgB,WAAW,CACzB,IAAI,EAAE,SAAS,UAAU,EAAE,EAC3B,IAAI,EAAE,MAAM,EACZ,EAAE,EAAE,MAAM,GACT,UAAU,EAAE,GAAG,IAAI,CAMrB;AAED,8DAA8D;AAC9D,eAAO,MAAM,iBAAiB,EAAE,eAI/B,CAAC;AAEF;;;;;GAKG;AACH,wBAAgB,qBAAqB,CACnC,QAAQ,EAAE,iBAAiB,EAC3B,QAAQ,EAAE,CAAC,EAAE,EAAE,MAAM,KAAK,MAAM;;;;;;;;EAGjC"}

package/dist/ui/theme/brandDocs.d.ts

@@ -0,0 +1,15 @@
+import { TokenDoc } from './tokenDocs.js';
+export declare const BRAND_BOUND_DOCS: {
+    readonly 'brand-l-min': TokenDoc;
+    readonly 'brand-l-max': TokenDoc;
+    readonly 'brand-c-max': TokenDoc;
+    readonly 'brand-ring-l-min': TokenDoc;
+    readonly 'brand-ring-l-max': TokenDoc;
+    readonly 'brand-primary-fill-l-min': TokenDoc;
+    readonly 'brand-primary-fill-l-max': TokenDoc;
+    readonly 'brand-accent-lc': TokenDoc;
+    readonly 'brand-sidebar-accent-lc': TokenDoc;
+    readonly 'brand-row-selected-lc': TokenDoc;
+    readonly 'brand-chart-1-lc': TokenDoc;
+};
+//# sourceMappingURL=brandDocs.d.ts.map

package/dist/ui/theme/brandDocs.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"brandDocs.d.ts","sourceRoot":"","sources":["../../../src/ui/theme/brandDocs.ts"],"names":[],"mappings":"AAaA,OAAO,KAAK,EAAE,QAAQ,EAAS,MAAM,gBAAgB,CAAC;AAatD,eAAO,MAAM,gBAAgB;;;;;;;;;;;;CAyDgB,CAAC"}

package/dist/ui/theme/densityDocs.d.ts

@@ -0,0 +1,9 @@
+import { TokenDoc } from './tokenDocs.js';
+export declare const DENSITY_LENGTH_DOCS: {
+    readonly 'table-header-height': TokenDoc;
+    readonly 'table-cell-padding-block': TokenDoc;
+    readonly 'table-cell-padding-inline': TokenDoc;
+    readonly 'sidebar-item-height': TokenDoc;
+    readonly 'panel-padding': TokenDoc;
+};
+//# sourceMappingURL=densityDocs.d.ts.map

package/dist/ui/theme/densityDocs.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"densityDocs.d.ts","sourceRoot":"","sources":["../../../src/ui/theme/densityDocs.ts"],"names":[],"mappings":"AAaA,OAAO,KAAK,EAAE,QAAQ,EAAS,MAAM,gBAAgB,CAAC;AAqBtD,eAAO,MAAM,mBAAmB;;;;;;CAoCa,CAAC"}

package/dist/ui/theme/pairs.d.ts

@@ -0,0 +1,138 @@
+/**
+ * The pairs the surface paints — ink on ground, edge on ground — and the
+ * line each owes: the half of the theme's registry that says what a preset
+ * is measured on (ui/theme.md「登记表：合同只有一个来源」).
+ *
+ * Two suites measure them, each in its own way: the jsdom one by arithmetic
+ * over the values the shipped stylesheets resolve to
+ * (`test/fixtures/presetPairs.ts`, every preset, mode and change
+ * convention), and the browser one by drawing a probe for each and reading
+ * what the cascade came to (Storybook's contrast matrix,
+ * `stories/view-engine/themeContrast.tsx`). Both expand this list and
+ * nothing else, so the two measure the same pairs by construction: before,
+ * each wrote its own, and a pair one of them left out — a preset's
+ * view-list headings at 4.44:1 — was caught by the other alone.
+ *
+ * Every pair is written as tokens and the opacity the call site gives them:
+ * a selected row is its role, `row-selected`, over the rows' `content`; a
+ * toned badge writes its token on a 10% wash of it (`ToneBadge`); the dark
+ * theme gives a control a `bg-input/30` fill. A role
+ * (ui/theme.md「角色：引擎自己的面」) is a ground of its own here, so a theme
+ * that parts it from the token it falls back to is measured on what it painted.
+ */
+/** What a pair is, and so which line it owes. */
+export type PairKind = 'text' | 'edge' | 'mark';
+/**
+ * The lines a preset holds, by kind: text at 4.5:1 (WCAG 1.4.3); the edge
+ * of a control and the focus indicator (1.4.11), and a mark or a fill that
+ * carries state, at 3:1. A preset may promise more (ui/theme.md「质量门」); the
+ * numbers live here, never in its CSS.
+ */
+export declare const LINES: Readonly<Record<PairKind, number>>;
+/**
+ * The least height, in CSS pixels, of something a reader presses (WCAG
+ * 2.5.8, the package's AA): what theme-check holds every length the
+ * registry marks `target` to, a host's and a preset's alike. The stylesheet
+ * does not floor them: the host owns what it writes, as it owns its
+ * colours' contrast, and theme-check is where it learns it fell short.
+ */
+export declare const TARGET_FLOOR = 24;
+/** A preset whose promise is higher than the package's, kind by kind. */
+export declare const PRESET_LINES: Readonly<Record<string, Partial<Record<PairKind, number>>>>;
+/** The lines one preset owes. */
+export declare function linesOf(preset: string): Record<PairKind, number>;
+/** One layer of paint: a token, at a Tailwind opacity modifier. */
+export interface Layer {
+    readonly token: string;
+    readonly alpha?: number;
+}
+/** What is measured on a ground. */
+export interface InkSpec {
+    readonly ink: string;
+    readonly kind: PairKind;
+    /** The ink at an opacity: the view list's headings at 70%. */
+    readonly alpha?: number;
+    /**
+     * The ink laid on a wash of itself at this opacity first: a toned badge,
+     * its token on 10% of it.
+     */
+    readonly wash?: number;
+    /**
+     * Painted in this mode alone: a call site that writes one ink in light
+     * and another under `dark:` (a tab's words).
+     */
+    readonly mode?: 'light' | 'dark';
+}
+/**
+ * A ground the surface paints, by what the surface calls it: its layers,
+ * bottom first, and what is measured on it.
+ */
+export interface Ground {
+    readonly name: string;
+    readonly layers: readonly Layer[];
+    readonly pairs: readonly InkSpec[];
+    /** Painted in dark alone: the `bg-input/30` a control wears there. */
+    readonly dark?: true;
+    /**
+     * Painted only where a theme sets this token: a filled control. The
+     * arithmetic measures it then; the browser draws it always, and where the
+     * token is unset the fill is nothing and what it measures is the ground
+     * under it, which another pair measures already.
+     */
+    readonly requires?: string;
+}
+/**
+ * What a map paints under its edges (`charts/mapOption.ts`): the land — an
+ * area with no number, the quiet grey at `LAND` — and the palest shade of
+ * the scale, the first slot at `PALEST`, each on the page and on a panel's
+ * card. Neither fill is held to a line of its own: the palest shade is 1.3:1
+ * off the ground by design (the scale starts near it), so no fill can stand
+ * 3:1 off both without reading as a number; the edge round each carries it.
+ * The map draws at these strengths (`mapOption` reads them from here).
+ */
+export declare const MAP_FILLS: {
+    readonly land: 0.08;
+    readonly palest: 0.2;
+};
+/** Every ground the surface paints and what it paints on each. */
+export declare const GROUNDS: readonly Ground[];
+/**
+ * A pair a preset is known to fall short on, owed by the batch that retunes
+ * it (ui/theme.md「质量门」). Both suites hold such a pair to still being
+ * short, so the entry goes the moment the batch lands; nothing else is
+ * excused, and a new shortfall is a failure.
+ */
+export interface PendingPair {
+    readonly preset: string;
+    readonly mode: 'light' | 'dark';
+    /** The pair's name, as `contrastPairs` files it. */
+    readonly pair: string;
+    /** The retuning batch that owes it. */
+    readonly batch: string;
+}
+/**
+ * None owed: the last, contrast's dark control wash on its header band, its
+ * selected row and its sidebar, was paid back by S11.
+ */
+export declare const PENDING: readonly PendingPair[];
+/** Whether one preset's pair in one mode is a known, owed shortfall. */
+export declare function isPending(preset: string, mode: 'light' | 'dark', pair: string): boolean;
+/** One pair, expanded: the ink and its ground as layers of tokens. */
+export interface ContrastPair {
+    /** How the pair reads, and the key its measurement is filed under. */
+    readonly name: string;
+    readonly kind: PairKind;
+    readonly ink: Layer;
+    /** Bottom first; a badge's wash is the last. */
+    readonly ground: readonly Layer[];
+    readonly requires?: string;
+}
+/**
+ * Every pair a list of grounds holds in one mode, in its order — the
+ * registry's own, or the same list read back from `dist/theme-tokens.json`
+ * (theme-check).
+ */
+export declare function expandPairs(grounds: readonly Ground[], mode: 'light' | 'dark'): ContrastPair[];
+/** Every pair a preset is measured on in one mode, in `GROUNDS`' order. */
+export declare function contrastPairs(mode: 'light' | 'dark'): ContrastPair[];
+//# sourceMappingURL=pairs.d.ts.map

package/dist/ui/theme/pairs.d.ts.map

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

package/dist/ui/theme/stateDocs.d.ts

@@ -0,0 +1,149 @@
+import { TokenDoc, Words } from './tokenDocs.js';
+/**
+ * The README's words for the roles that mark a state — a highlighted item,
+ * a chosen one, the view on screen, a control under the pointer or pressed,
+ * an outline button under the pointer — and their links
+ * (ui/theme.md「角色：引擎自己的面」), beside `tokenDocs.ts` so that catalogue
+ * stays one screenful of files.
+ */
+/** A control that keeps its own value, unset: a fill, an edge, a hover. */
+export declare const OWN_CONTROL: Words;
+export declare const STATE_DOCS: {
+    readonly highlight: {
+        readonly role: {
+            readonly en: "The item a menu, a select or a combobox has under the keyboard or the pointer";
+            readonly zh: "菜单、选择框、组合框里键盘或指针所在的那一项";
+        };
+    };
+    readonly 'highlight-foreground': {
+        readonly role: {
+            readonly en: "The words on that item";
+            readonly zh: "那一项上的文字";
+        };
+    };
+    readonly 'highlight-link': TokenDoc;
+    readonly 'highlight-foreground-link': TokenDoc;
+    readonly 'item-selected': {
+        readonly role: {
+            readonly en: "The item a menu, a select or a combobox holds chosen";
+            readonly zh: "菜单、选择框、组合框里已选中的那一项";
+        };
+    };
+    readonly 'item-selected-foreground': {
+        readonly role: {
+            readonly en: "The words on that item";
+            readonly zh: "那一项上的文字";
+        };
+    };
+    readonly 'item-selected-weight': {
+        readonly role: {
+            readonly en: "The weight of those words";
+            readonly zh: "那些文字的字重";
+        };
+        readonly light: {
+            readonly en: "unset: the item's own";
+            readonly zh: "不设：那一项原样";
+        };
+    };
+    readonly 'item-selected-link': TokenDoc;
+    readonly 'nav-current': {
+        readonly role: {
+            readonly en: "The view on screen in the view list";
+            readonly zh: "视图列表里正在看的那一个";
+        };
+    };
+    readonly 'nav-current-foreground': {
+        readonly role: {
+            readonly en: "Its words";
+            readonly zh: "它的文字";
+        };
+    };
+    readonly 'nav-current-edge': {
+        readonly role: {
+            readonly en: "Its edge";
+            readonly zh: "它的边";
+        };
+    };
+    readonly 'nav-current-shadow': {
+        readonly role: {
+            readonly en: "Its lift off the column";
+            readonly zh: "它离开侧栏的浮起";
+        };
+    };
+    readonly 'nav-current-link': TokenDoc;
+    readonly 'nav-current-foreground-link': TokenDoc;
+    readonly 'control-hover': {
+        readonly role: {
+            readonly en: "A button or a toggle under the pointer";
+            readonly zh: "指针下的按钮或切换";
+        };
+        readonly light: Words;
+        readonly dark: Words;
+    };
+    readonly 'control-pressed': {
+        readonly role: {
+            readonly en: "A toggle pressed";
+            readonly zh: "按下的切换";
+        };
+        readonly light: {
+            readonly en: "unset: `muted`";
+            readonly zh: "不设：`muted`";
+        };
+        readonly dark: {
+            readonly en: "unset: `muted`";
+            readonly zh: "不设：`muted`";
+        };
+    };
+    readonly 'outline-hover-edge': {
+        readonly role: {
+            readonly en: "The edge of an outline button under the pointer";
+            readonly zh: "指针下的描边按钮的边";
+        };
+        readonly light: {
+            readonly en: "unset: `border`";
+            readonly zh: "不设：`border`";
+        };
+        readonly dark: {
+            readonly en: "unset: `input`";
+            readonly zh: "不设：`input`";
+        };
+    };
+    readonly 'outline-hover-foreground': {
+        readonly role: {
+            readonly en: "Its words";
+            readonly zh: "它的文字";
+        };
+    };
+    readonly 'outline-hover-edge-link': TokenDoc;
+    readonly 'outline-hover-foreground-link': TokenDoc;
+};
+/**
+ * The primary as a fill under words, which a highlighted item links to, and
+ * a selected row's mark that is not its colour (D76).
+ */
+export declare const MARK_DOCS: {
+    readonly 'primary-fill': {
+        readonly role: {
+            readonly en: "The primary as a filled area under words — a highlighted item linked to it; a preset gives a deeper step where the primary is too light to carry white words (dark)";
+            readonly zh: "主色作为承载文字的填色——链到它的高亮项；主色浅到托不住白字时（暗色）由预设给更深一档";
+        };
+    };
+    readonly 'primary-fill-foreground': {
+        readonly role: {
+            readonly en: "The words on that fill";
+            readonly zh: "那块填色上的文字";
+        };
+    };
+    readonly 'row-selected-mark': {
+        readonly role: {
+            readonly en: "A bar down a selected row's left edge: the selection said by more than its colour";
+            readonly zh: "选中行左边的一道色条：不只靠颜色说出选中";
+        };
+        readonly light: {
+            readonly en: "unset: none";
+            readonly zh: "不设：没有";
+        };
+    };
+    readonly 'row-selected-mark-link': TokenDoc;
+};
+//# sourceMappingURL=stateDocs.d.ts.map

package/dist/ui/theme/stateDocs.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"stateDocs.d.ts","sourceRoot":"","sources":["../../../src/ui/theme/stateDocs.ts"],"names":[],"mappings":"AAaA,OAAO,KAAK,EAAE,QAAQ,EAAE,KAAK,EAAE,MAAM,gBAAgB,CAAC;AAEtD;;;;;;GAMG;AAEH,2EAA2E;AAC3E,eAAO,MAAM,WAAW,EAAE,KAGzB,CAAC;AAcF,eAAO,MAAM,UAAU;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;CA8EsB,CAAC;AAE9C;;;GAGG;AACH,eAAO,MAAM,SAAS;;;;;;;;;;;;;;;;;;;;;;;;CAkBuB,CAAC"}

package/dist/ui/theme/tokenDocs.d.ts

@@ -0,0 +1,25 @@
+import { TokenName } from './tokens.js';
+/** One phrase, in both of the READMEs' languages. */
+export interface Words {
+    readonly en: string;
+    readonly zh: string;
+}
+/**
+ * What the README says of one token: its role, and — where the built-in
+ * value is not a literal or another token the stylesheet names, so the
+ * table cannot read it off `styles.css` — how that default reads. A default
+ * given for light alone is the same in dark.
+ */
+export interface TokenDoc {
+    readonly role: Words;
+    readonly light?: Words;
+    readonly dark?: Words;
+}
+/**
+ * The words of the README's token tables, one entry per registered token —
+ * a catalogue beside `tokens.ts`, so the runtime that reads the registry
+ * does not carry them. The type makes it whole: a token without its words
+ * does not compile.
+ */
+export declare const TOKEN_DOCS: Readonly<Record<TokenName, TokenDoc>>;
+//# sourceMappingURL=tokenDocs.d.ts.map

package/dist/ui/theme/tokenDocs.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"tokenDocs.d.ts","sourceRoot":"","sources":["../../../src/ui/theme/tokenDocs.ts"],"names":[],"mappings":"AAgBA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,aAAa,CAAC;AAE7C,qDAAqD;AACrD,MAAM,WAAW,KAAK;IACpB,QAAQ,CAAC,EAAE,EAAE,MAAM,CAAC;IACpB,QAAQ,CAAC,EAAE,EAAE,MAAM,CAAC;CACrB;AAED;;;;;GAKG;AACH,MAAM,WAAW,QAAQ;IACvB,QAAQ,CAAC,IAAI,EAAE,KAAK,CAAC;IACrB,QAAQ,CAAC,KAAK,CAAC,EAAE,KAAK,CAAC;IACvB,QAAQ,CAAC,IAAI,CAAC,EAAE,KAAK,CAAC;CACvB;AAmCD;;;;;GAKG;AACH,eAAO,MAAM,UAAU,EAAE,QAAQ,CAAC,MAAM,CAAC,SAAS,EAAE,QAAQ,CAAC,CAyc5D,CAAC"}