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

package/dist/ui/filter/inputs/shared.d.ts

@@ -0,0 +1,79 @@
+import { ReactNode } from 'react';
+import { FilterValue } from '../../../model/index.js';
+import { ControlChromeProps } from '../../kit/variants.js';
+/** What every value control is given: the value in force, and where to put it. */
+export interface ValueProps {
+    value: FilterValue;
+    onChange(value: FilterValue): void;
+    label: string;
+    disabled?: boolean;
+    /**
+     * Whether the condition holding this value is refused.
+     *
+     * The pill draws itself invalid from its own `data-invalid`, which is a
+     * border and nothing else: a reader who never sees the border hears a
+     * perfectly ordinary control. Every control a value is typed or picked in
+     * carries the mark, because the value is one answer however many boxes it
+     * takes to say — a range is refused for being inverted, not for either end.
+     */
+    invalid?: boolean;
+    /** What a form outside a condition says of the control; see `ControlAria`. */
+    control?: ControlAria;
+}
+/**
+ * What a form that is not a condition — a declared action's — says of a
+ * control besides its name: the id a visible label points at, the hint it
+ * is described by, and that it must be filled.
+ */
+export interface ControlAria {
+    /** The control's id, for a visible `<label htmlFor>` to point at. */
+    id?: string;
+    /** Ids of the hints the control is described by (`aria-describedby`). */
+    describedBy?: string;
+    /** It must be filled (`aria-required`). */
+    required?: boolean;
+}
+/**
+ * One of a short, fixed list of answers.
+ *
+ * Inside a condition pill, which is where all but one of these stand, the
+ * pill is the field and the select draws no chrome of its own (D12). The
+ * one outside is the group block's and/or, which has nothing around it to
+ * be that edge and asks for it back with `chrome="box"`.
+ */
+export declare function ChoiceValue({ label, disabled, invalid, value, items, placeholder, chrome, control, onChange, }: ControlChromeProps & {
+    label: string;
+    disabled?: boolean;
+    invalid?: boolean;
+    control?: ControlAria;
+    /** `null` shows the placeholder: nothing has been chosen yet. */
+    value: string | null;
+    items: {
+        label: string;
+        value: string;
+    }[];
+    placeholder?: string;
+    onChange(value: string): void;
+}): import('react').JSX.Element;
+/**
+ * The two ends of a range, with the word that joins them between.
+ *
+ * Two boxes side by side are two answers; a range is one, and nothing on the
+ * row said so — «金额 介于 100 ———— 5,000» read as two numbers the user had
+ * been asked for separately. The separator is the same one the applied bar
+ * prints between the ends of a range (`label.filter.range-join`), so the
+ * condition is punctuated the same way wherever it is read. It is
+ * `aria-hidden`: each box is already named for the end it holds
+ * (`label.filter.range-from` / `range-to`), and a reader that also spoke the
+ * tilde would hear punctuation in the middle of a form.
+ *
+ * Both ends are `flex-1` against it, so they share whatever the pill has left
+ * and neither is the one that gives.
+ */
+export declare function RangeRow({ from, to }: {
+    from: ReactNode;
+    to: ReactNode;
+}): import('react').JSX.Element;
+/** Only scalars are shown as text; an object value has its own editor. */
+export declare function scalarText(value: unknown): string;
+//# sourceMappingURL=shared.d.ts.map

package/dist/ui/filter/inputs/shared.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"shared.d.ts","sourceRoot":"","sources":["../../../../src/ui/filter/inputs/shared.tsx"],"names":[],"mappings":"AAaA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,OAAO,CAAC;AACvC,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,yBAAyB,CAAC;AAS3D,OAAO,EAEL,KAAK,kBAAkB,EACxB,MAAM,uBAAuB,CAAC;AAE/B,kFAAkF;AAClF,MAAM,WAAW,UAAU;IACzB,KAAK,EAAE,WAAW,CAAC;IACnB,QAAQ,CAAC,KAAK,EAAE,WAAW,GAAG,IAAI,CAAC;IACnC,KAAK,EAAE,MAAM,CAAC;IACd,QAAQ,CAAC,EAAE,OAAO,CAAC;IACnB;;;;;;;;OAQG;IACH,OAAO,CAAC,EAAE,OAAO,CAAC;IAClB,8EAA8E;IAC9E,OAAO,CAAC,EAAE,WAAW,CAAC;CACvB;AAED;;;;GAIG;AACH,MAAM,WAAW,WAAW;IAC1B,qEAAqE;IACrE,EAAE,CAAC,EAAE,MAAM,CAAC;IACZ,yEAAyE;IACzE,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,2CAA2C;IAC3C,QAAQ,CAAC,EAAE,OAAO,CAAC;CACpB;AAED;;;;;;;GAOG;AACH,wBAAgB,WAAW,CAAC,EAC1B,KAAK,EACL,QAAQ,EACR,OAAO,EACP,KAAK,EACL,KAAK,EACL,WAAW,EACX,MAAM,EACN,OAAO,EACP,QAAQ,GACT,EAAE,kBAAkB,GAAG;IACtB,KAAK,EAAE,MAAM,CAAC;IACd,QAAQ,CAAC,EAAE,OAAO,CAAC;IACnB,OAAO,CAAC,EAAE,OAAO,CAAC;IAClB,OAAO,CAAC,EAAE,WAAW,CAAC;IACtB,iEAAiE;IACjE,KAAK,EAAE,MAAM,GAAG,IAAI,CAAC;IACrB,KAAK,EAAE;QAAE,KAAK,EAAE,MAAM,CAAC;QAAC,KAAK,EAAE,MAAM,CAAA;KAAE,EAAE,CAAC;IAC1C,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,QAAQ,CAAC,KAAK,EAAE,MAAM,GAAG,IAAI,CAAC;CAC/B,+BAiCA;AAED;;;;;;;;;;;;;;GAcG;AACH,wBAAgB,QAAQ,CAAC,EAAE,IAAI,EAAE,EAAE,EAAE,EAAE;IAAE,IAAI,EAAE,SAAS,CAAC;IAAC,EAAE,EAAE,SAAS,CAAA;CAAE,+BAcxE;AAED,0EAA0E;AAC1E,wBAAgB,UAAU,CAAC,KAAK,EAAE,OAAO,GAAG,MAAM,CAWjD"}

package/dist/ui/filter/inputs/suggested.d.ts

@@ -0,0 +1,29 @@
+import { ValueCandidateSource } from '../../../runtime/index.js';
+import { ValueProps } from './shared.js';
+/**
+ * A text value typed, or picked from the values the data holds.
+ *
+ * The field's values come from its `ValueCandidateSource` — the records
+ * counted by value, the most frequent first — and each is listed with how
+ * many records hold it, so the choice is made knowing what it will find.
+ * The list is a help and not a fence: what is typed stays a value whether or
+ * not the list holds it, because the list is the most frequent values and
+ * not necessarily all of them, and the one wanted may be rare.
+ *
+ * - **One value** (`EQ`, `NE`): the box holds the value itself, as a plain
+ *   text box does — every keystroke is the value, Apply takes it — and the
+ *   list under it offers what to type instead. Picking one writes it.
+ * - **Several** (`IN`, `NOT_IN`): a chip per value, as `ValueChips` draws
+ *   them; the list holds the field's values, and what is typed is offered
+ *   after them to be added as it is. Leaving the box adds what was typed, for
+ *   `ValueChips`'s reason: reaching for Apply must not throw it away.
+ *
+ * Nothing is asked for until the list opens (`useValueCandidates`); what is
+ * typed narrows what is already listed at once, and the answer for it
+ * follows once typing pauses.
+ */
+export declare function SuggestedValue({ multiple, source, ...props }: ValueProps & {
+    multiple: boolean;
+    source: ValueCandidateSource;
+}): import('react').JSX.Element;
+//# sourceMappingURL=suggested.d.ts.map

package/dist/ui/filter/inputs/suggested.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"suggested.d.ts","sourceRoot":"","sources":["../../../../src/ui/filter/inputs/suggested.tsx"],"names":[],"mappings":"AAiBA,OAAO,KAAK,EAAE,oBAAoB,EAAE,MAAM,2BAA2B,CAAC;AAqBtE,OAAO,EAAc,KAAK,UAAU,EAAE,MAAM,aAAa,CAAC;AAE1D;;;;;;;;;;;;;;;;;;;;;GAqBG;AACH,wBAAgB,cAAc,CAAC,EAC7B,QAAQ,EACR,MAAM,EACN,GAAG,KAAK,EACT,EAAE,UAAU,GAAG;IAAE,QAAQ,EAAE,OAAO,CAAC;IAAC,MAAM,EAAE,oBAAoB,CAAA;CAAE,+BAMlE"}

package/dist/ui/filter/inputs/text.d.ts

@@ -0,0 +1,8 @@
+import { ValueProps } from './shared.js';
+/** Typed text, as one value or as a list of them. */
+export declare function TextValue({ value, onChange, label, disabled, invalid, multiple, placeholder, control, }: ValueProps & {
+    multiple: boolean;
+    /** What the empty box says instead of 「未设置」: a board's search, 「搜索…」. */
+    placeholder?: string;
+}): import('react').JSX.Element;
+//# sourceMappingURL=text.d.ts.map

package/dist/ui/filter/inputs/text.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"text.d.ts","sourceRoot":"","sources":["../../../../src/ui/filter/inputs/text.tsx"],"names":[],"mappings":"AAgBA,OAAO,EAAc,KAAK,UAAU,EAAE,MAAM,aAAa,CAAC;AAE1D,qDAAqD;AACrD,wBAAgB,SAAS,CAAC,EACxB,KAAK,EACL,QAAQ,EACR,KAAK,EACL,QAAQ,EACR,OAAO,EACP,QAAQ,EACR,WAAW,EACX,OAAO,GACR,EAAE,UAAU,GAAG;IACd,QAAQ,EAAE,OAAO,CAAC;IAClB,yEAAyE;IACzE,WAAW,CAAC,EAAE,MAAM,CAAC;CACtB,+BAoCA"}

package/dist/ui/filter/inputs/time.d.ts

@@ -0,0 +1,29 @@
+/**
+ * The clock half of the calendar (用户 2026-09-25): a date is a whole day
+ * until a time is asked for. Folded, it says 「整天」 and offers
+ * 「+ 指定时刻」; open, one field a bound — 「起始时刻」 and 「截止时刻」 on a
+ * range — each typed as hours and minutes, each cleared back to the whole
+ * day by its ×, and 「移除时刻」 clears both and folds it again.
+ *
+ * It used to be a native `<input type="time">` a bound, with seconds: a
+ * clock nobody asked to the second, in the browser's own dark dropdown
+ * rather than the surface's look, and open on every date field whether a
+ * time was wanted or not. What an empty time means is the hint under it
+ * either way — the day itself, read as an interval.
+ */
+export declare function TimeOfDay({ range, disabled, from, to, onFrom, onTo, }: {
+    range: boolean;
+    disabled?: boolean;
+    /** Each bound's day (`''` while none is picked) and its time of day. */
+    from: {
+        day: string;
+        time: string;
+    };
+    to: {
+        day: string;
+        time: string;
+    };
+    onFrom(time: string): void;
+    onTo(time: string): void;
+}): import('react').JSX.Element;
+//# sourceMappingURL=time.d.ts.map

package/dist/ui/filter/inputs/time.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"time.d.ts","sourceRoot":"","sources":["../../../../src/ui/filter/inputs/time.tsx"],"names":[],"mappings":"AA0CA;;;;;;;;;;;;GAYG;AACH,wBAAgB,SAAS,CAAC,EACxB,KAAK,EACL,QAAQ,EACR,IAAI,EACJ,EAAE,EACF,MAAM,EACN,IAAI,GACL,EAAE;IACD,KAAK,EAAE,OAAO,CAAC;IACf,QAAQ,CAAC,EAAE,OAAO,CAAC;IACnB,wEAAwE;IACxE,IAAI,EAAE;QAAE,GAAG,EAAE,MAAM,CAAC;QAAC,IAAI,EAAE,MAAM,CAAA;KAAE,CAAC;IACpC,EAAE,EAAE;QAAE,GAAG,EAAE,MAAM,CAAC;QAAC,IAAI,EAAE,MAAM,CAAA;KAAE,CAAC;IAClC,MAAM,CAAC,IAAI,EAAE,MAAM,GAAG,IAAI,CAAC;IAC3B,IAAI,CAAC,IAAI,EAAE,MAAM,GAAG,IAAI,CAAC;CAC1B,+BA0GA"}

package/dist/ui/filter/inputs/timeOfDay.d.ts

@@ -0,0 +1,38 @@
+/**
+ * A time of day as its two typed segments, to the minute (用户 2026-09-25
+ * 定「精确到分」): `null` for a segment nothing is typed in.
+ */
+export interface TimeSegments {
+    hour: number | null;
+    minute: number | null;
+}
+/** The largest value each segment takes: 00–23 and 00–59. */
+export declare const SEGMENT_MAX: {
+    readonly hour: 23;
+    readonly minute: 59;
+};
+/**
+ * A stored time of day — `HH:mm`, or `HH:mm:ss` as this control used to
+ * write it and a host's own config may hold — as its two segments; the
+ * seconds are not shown, and are gone once the time is written again.
+ * Nothing, or anything else, is two blank segments: the whole day.
+ */
+export declare function parseTime(text: string): TimeSegments;
+/**
+ * A typed segment held inside its range, a whole number: what a box that
+ * says 00–23 can mean by 25, or by -1, or by 7.5. `null` stays `null`.
+ */
+export declare function clampSegment(value: number | null, segment: keyof typeof SEGMENT_MAX): number | null;
+/**
+ * The time as stored: `HH:mm`, a segment left blank beside a typed one
+ * standing at 00 — 「9 点」 is 09:00 — and `''` when neither is typed, which
+ * is the whole day.
+ */
+export declare function writeTime({ hour, minute }: TimeSegments): string;
+/**
+ * Whether the text typed in the hour box is a whole hour already, so the
+ * keyboard moves on to the minutes: two digits, or one no hour starts with
+ * a second digit after (3–9).
+ */
+export declare function hourIsComplete(text: string): boolean;
+//# sourceMappingURL=timeOfDay.d.ts.map

package/dist/ui/filter/inputs/timeOfDay.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"timeOfDay.d.ts","sourceRoot":"","sources":["../../../../src/ui/filter/inputs/timeOfDay.ts"],"names":[],"mappings":"AAaA;;;GAGG;AACH,MAAM,WAAW,YAAY;IAC3B,IAAI,EAAE,MAAM,GAAG,IAAI,CAAC;IACpB,MAAM,EAAE,MAAM,GAAG,IAAI,CAAC;CACvB;AAED,6DAA6D;AAC7D,eAAO,MAAM,WAAW;;;CAAoC,CAAC;AAI7D;;;;;GAKG;AACH,wBAAgB,SAAS,CAAC,IAAI,EAAE,MAAM,GAAG,YAAY,CAQpD;AAED;;;GAGG;AACH,wBAAgB,YAAY,CAC1B,KAAK,EAAE,MAAM,GAAG,IAAI,EACpB,OAAO,EAAE,MAAM,OAAO,WAAW,GAChC,MAAM,GAAG,IAAI,CAGf;AAED;;;;GAIG;AACH,wBAAgB,SAAS,CAAC,EAAE,IAAI,EAAE,MAAM,EAAE,EAAE,YAAY,GAAG,MAAM,CAGhE;AAED;;;;GAIG;AACH,wBAAgB,cAAc,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAEpD"}

package/dist/ui/filter/inputs/unsupported.d.ts

@@ -0,0 +1,33 @@
+import { FieldKindId } from '../../../model/index.js';
+/**
+ * A value no control can hold: what the config stores, and why nothing here
+ * can edit it.
+ *
+ * Two situations arrive at the same place, and from where the user sits they
+ * are one situation. A field's kind may be missing from the
+ * `FieldKindRegistry` — a definition shipped one release and a saved view
+ * still asks by it — and then there are no operators to offer and no value
+ * shape to draw. Or a registered kind may ask for an `EditorDescriptor.input`
+ * outside the closed union, which is the same absence one step further in.
+ * Either way the honest answer is the stored value, said once, with the
+ * reason beside it; the text box that used to stand here invited an edit that
+ * would have written a shape nobody could read back.
+ *
+ * It is read-only and not `disabled`: a disabled control is one that could be
+ * used later, and this one could not. `validateFilter` refuses the condition
+ * in the same breath (`filter.kind.unregistered`, `filter.kind.unknown-editor`)
+ * so Apply does not run a tree the kernel cannot compile, and the pill around
+ * this wears the error border every other refused condition wears.
+ *
+ * An `Alert` is what the shadcn rules would draw for a reason like this, and
+ * it is declined here on purpose: this sits inside a condition pill, which is
+ * already a bordered block in the destructive tone, and an alert inside it
+ * would be a second frame and a second border around one sentence.
+ */
+export declare function UnsupportedValue({ kind, value, className, }: {
+    /** The kind whose editor is missing; the sentence names it. */
+    kind: FieldKindId;
+    value: unknown;
+    className?: string;
+}): import('react').JSX.Element;
+//# sourceMappingURL=unsupported.d.ts.map

package/dist/ui/filter/inputs/unsupported.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"unsupported.d.ts","sourceRoot":"","sources":["../../../../src/ui/filter/inputs/unsupported.tsx"],"names":[],"mappings":"AAcA,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,yBAAyB,CAAC;AAG3D;;;;;;;;;;;;;;;;;;;;;;;;GAwBG;AACH,wBAAgB,gBAAgB,CAAC,EAC/B,IAAI,EACJ,KAAK,EACL,SAAS,GACV,EAAE;IACD,+DAA+D;IAC/D,IAAI,EAAE,WAAW,CAAC;IAClB,KAAK,EAAE,OAAO,CAAC;IACf,SAAS,CAAC,EAAE,MAAM,CAAC;CACpB,+BAqBA"}

package/dist/ui/index.d.ts

@@ -0,0 +1,123 @@
+/**
+ * The `/ui` entry: the default look, built on shadcn/ui with Base UI
+ * primitives. A component reads what it draws in one of two ways: a pure
+ * kernel reading (`filter`, `record`, `analysis`, `dashboard` — functions of
+ * a definition and a config, public from the root entry) it may call
+ * directly, and a stateful judgement — anything that reads an open runtime,
+ * a write in flight or a command's outcome — it takes from a controller in
+ * `/react`. So replacing one is a matter of writing different markup against
+ * the same controllers and the same kernel functions.
+ *
+ * Styles ship separately as `@ahoo-wang/wow-view-engine/styles.css`.
+ */
+export { type AlertTone, LineAlert, type LineAlertProps, TONE_ICON, type LineAlertFrame, } from './kit/alerts.js';
+export { AnalysisChart, type AnalysisChartProps, } from './analysis/AnalysisChart.js';
+export { registerChartMap, type ChartMapGeoJson, type ChartMapSource, } from './charts/maps.js';
+export { AnalysisTable, type AnalysisTableProps, } from './analysis/AnalysisTable.js';
+export { AppliedBar, type AppliedBarProps } from './filter/AppliedBar.js';
+export { ColumnSettings, type ColumnSettingsProps, } from './columns/ColumnSettings.js';
+export { PanelGridItem, type PanelGridItemProps, PanelHandle, type PanelHandleProps, PanelOrder, type PanelOrderProps, PanelResizeHandle, type PanelResizeHandleProps, } from './dashboard/DashboardArrange.js';
+export { DashboardGrid, type DashboardGridProps, } from './dashboard/DashboardGrid.js';
+export { DashboardPanel, type DashboardPanelProps, type PanelHeadingLevel, } from './dashboard/DashboardPanel.js';
+export { ContentPanel, type ContentPanelProps, HeadingPanel, type HeadingPanelProps, ImagePanel, type ImagePanelProps, LinksPanel, type LinksPanelProps, MarkdownPanel, type MarkdownPanelProps, } from './dashboard/DashboardPanels.js';
+export { type DashboardEditExtensions, DashboardEditExtensionsContext, type NewPanelSpot, useDashboardEditExtensions, } from './dashboard/extensions.js';
+export { DashboardWorkbench, type DashboardWorkbenchProps, } from './DashboardWorkbench.js';
+export { DashboardTabs, type DashboardTabsProps, } from './dashboard/DashboardTabs.js';
+export { type DashboardExtensionsOptions, useDashboardExtensions, } from './dashboard/building.js';
+export { type NewAnalysis, NewAnalysisDialog, type NewAnalysisDialogProps, } from './dashboard/NewAnalysisDialog.js';
+export { PresentationDialog, type PresentationDialogProps, } from './dashboard/PresentationDialog.js';
+/**
+ * How this package reads one value, so a host that renders a cell itself can
+ * fall back to it instead of reimplementing it.
+ *
+ * `renderCell` is the smallest change a host can make to a record view, and
+ * the smallest one has to be the cheapest: a host that overrides one column
+ * must not lose the reading of the rest. These three are what the table and
+ * the cards themselves call, and they promise exactly what the default cell
+ * shows — enum labels from the definition's own options, times on the
+ * surface's clock and in its language, numbers in the field's
+ * `numberFormat`, booleans in the wording in force.
+ *
+ * `cellValue` is the node a cell draws (badges, a guarded link, a paragraph);
+ * `cellText` is the same reading as one line of text, for a CSV, a copied
+ * selection or a `title`; `displayValue` is the kind's own reading alone,
+ * `undefined` where the kind has nothing to add and the caller's rendering
+ * stands; `tableTime` is a time as a table cell writes it — to the minute,
+ * the year only outside the current one — whose whole reading is
+ * `displayValue`'s. The two context arguments come from `useViewMessages` and
+ * `useSurfaceDisplay`, so a host reads them off the surface it is inside
+ * rather than passing a language around. The last one is the `CellSurface`
+ * it is drawing on — `'table'`, `'card'` or `'detail'` — which decides how
+ * many lines a value may take, and that a table's time is short.
+ *
+ * The vendored shadcn primitives underneath are deliberately *not* public:
+ * what is promised here is the reading of a value, not the markup around it.
+ */
+export { cellValue, type CellField, type CellSurface } from './record/cells.js';
+export { cellText, displayValue, tableTime, type DisplayContext, type DisplayField, type ElementField, type ElementTitleField, } from './kit/display.js';
+export { fileName } from './kit/download.js';
+export { EditorBand, type EditorBandProps, EditorBandToggle, type EditorBandToggleProps, EditorFold, type EditorFoldProps, } from './workbench/EditorBand.js';
+export { EmbeddedDashboard, type EmbeddedDashboardProps, } from './EmbeddedDashboard.js';
+export type { BoardFilterModes, DashboardFilterMode, } from './dashboard/filterModes.js';
+export { EmbeddedView, type EmbeddedViewProps } from './EmbeddedView.js';
+export type { EmbedBaseProps, EmbedInteraction, EmbedSize, } from './embed/options.js';
+export { ExportButton, ExportDialog, type ExportDialogProps, type ExportOffer, type ExportWindowProps, } from './kit/ExportDialog.js';
+export { FilterPanel, type FilterPanelProps } from './filter/FilterPanel.js';
+export { type MessageKey, type MessageOverrides, type ViewMessages, formatIssue, formatIssues, formatMessage, } from './kit/messages.js';
+export { en } from './messages/en.js';
+export { zhCN } from './messages/zh-CN.js';
+export { keptKey, type MessageFormatters, MessagesProvider, type MessagesProviderProps, type Say, useSaidText, useSay, useViewMessages, } from './kit/MessagesProvider.js';
+export { FilterValueEditor, type FilterValueEditorProps, } from './filter/FilterValueEditor.js';
+export { NumberInput } from './filter/inputs/number.js';
+export type { ControlAria } from './filter/inputs/shared.js';
+export { AUDIENCE_ICON, KIND_ICON, SYSTEM_ICON, SurfaceKind, kindIssue, kindWord, useKindIssue, useKindWord, } from './kit/kinds.js';
+export { LeaveDialog, type LeaveDialogProps } from './workbench/LeaveGuard.js';
+export { RecordCards, type RecordCardsProps } from './record/RecordCards.js';
+export { RecordPagination, type RecordPaginationProps, } from './record/RecordPagination.js';
+export { type RecordCell, RecordTable, type RecordTableProps, } from './record/RecordTable.js';
+export { type DataViewKind, DataWorkbench, type DataWorkbenchProps, } from './DataWorkbench.js';
+export type { WorkbenchFeatures } from './kit/features.js';
+export { RenderBoundary, type RenderBoundaryName, type RenderBoundaryProps, type RenderFailure, type RenderFailureHandler, RenderSlot, } from './kit/RenderBoundary.js';
+export { BUILT_IN_PRESETS, type BuiltInPreset, type ViewDensity, type ViewPreset, } from './kit/presets.js';
+export type { FveToken, TokenName } from './theme/tokens.js';
+export { RefreshControl, type RefreshControlProps, } from './workbench/RefreshControl.js';
+export { ResultToolbar, type ResultToolbarProps, } from './workbench/ResultToolbar.js';
+export { RowActions, type RowActionsProps } from './record/RowActions.js';
+export { SaveActions, type SaveActionsProps, SharedSaveConfirm, UnsavedMark, } from './workbench/SaveActions.js';
+export { type SaveAsCommands, SaveAsDialog, type SaveAsDialogProps, } from './workbench/SaveAsDialog.js';
+export { type SortOwner, SortSettings, type SortSettingsProps, } from './sort/SortSettings.js';
+export { ErrorStrip, type ErrorStripProps, type IssueStripProps, NoteStrip, QueryStrip, type QueryStripProps, StatusStrip, type StatusStripProps, WarningStrip, dedupeIssues, } from './kit/StatusStrip.js';
+export { ViewExpandExit, ViewExpandToggle, type ViewExpandToggleProps, type ViewExpansion, useViewExpansion, } from './kit/ViewExpansion.js';
+export { RevertDialog, type RevertDialogProps, ViewHeader, type ViewHeaderProps, type ViewHeaderState, type HeadingLevel, } from './workbench/ViewHeader.js';
+export { ViewList, type ViewListProps } from './workbench/ViewList.js';
+export { ViewSwitcher, type ViewSwitcherProps, } from './workbench/ViewSwitcher.js';
+export { ViewManager, type ViewManagerProps } from './manage/ViewManager.js';
+export { ViewHost, type ViewHostProps } from './ViewHost.js';
+export { useEngine } from './workbench/ViewEngineProvider.js';
+export { type ColorMode, type ColorModeControl, type HostColorMode, useColorMode, } from './colorMode.js';
+export { useViewNavigation, type ViewNavigationItem, type ViewNavigationView, } from './viewNavigation.js';
+export { bind, type ViewBinding, type ViewBindingOptions, } from './workbench/bindings.js';
+export type { RoutedTarget, ViewDestination, ViewLocation, ViewRoute, ViewRouteOf, ViewRouteState, ViewRouter, } from '../runtime/routes.js';
+export { ViewSurface, type ViewSurfaceProps, type ViewTheme, useSurfaceAttributes, useSurfaceDisplay, useSurfaceFont, useSurfaceHostTokens, useSurfaceTheme, useSurfaceTokens, } from './kit/ViewSurface.js';
+export { type WorkbenchLandmark, WorkbenchShell, type WorkbenchShellProps, } from './workbench/WorkbenchShell.js';
+export { type RenderParts, type WorkbenchParts } from './workbench/parts.js';
+export { type RecordDetailOptions, RecordParts, type RecordPartsProps, type RecordViewProps, } from './workbench/RecordParts.js';
+export type { ExportedFile } from './record/exportOffer.js';
+export { type AnalysisHost, AnalysisParts, type AnalysisPartsProps, } from './workbench/AnalysisParts.js';
+export { type NewViewCommand, NewViewControl, NewViewItem, } from './workbench/NewView.js';
+export { type ViewWriteCallbacks, WriteOutcome, type WriteOutcomeProps, } from './workbench/WriteOutcome.js';
+export type { ChartImageSlot } from './charts/image.js';
+export type { ControlChromeProps } from './kit/variants.js';
+export type { DetachedDialog, DetachedPopover, PopoverHandle, DialogHandle, } from './kit/toolbar.js';
+export type { EmptyWayOut } from './record/emptyWayOut.js';
+export type { FinalFocus } from './kit/focus.js';
+export type { HandleMove } from './kit/DragHandle.js';
+export type { HeaderSorting } from './analysis/headerSort.js';
+export type { OnPick } from './charts/family.js';
+export type { PanelCommands, ViewingCommands, EditingCommands, } from './dashboard/commands.js';
+export type { PanelPress } from './dashboard/press.js';
+export type { RecordPanelHost } from './dashboard/PanelBodies.js';
+export type { ReleasedPins } from './record/pinCap.js';
+export type { SelectionContext } from './record/SelectionBar.js';
+export type { PickAnchor } from './kit/anchor.js';
+//# sourceMappingURL=index.d.ts.map

package/dist/ui/index.d.ts.map

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

package/dist/ui/kit/Announcer.d.ts

@@ -0,0 +1,75 @@
+import { ReactNode } from 'react';
+export interface Announcer {
+    /**
+     * Say this, out loud, once. The same words again are said again: a
+     * second press that did what the first did is still a press to hear.
+     */
+    say(message: string): void;
+    /**
+     * The live region itself. It is handed back rather than rendered by the
+     * caller's own markup so that one call is one region: a surface cannot
+     * end up with two of them, and cannot end up with none. `null` from
+     * `useSurfaceAnnouncer` where the region is the surface's.
+     */
+    region: ReactNode;
+}
+/** A surface's own region, which can also be emptied. */
+export interface OwnAnnouncer extends Announcer {
+    /**
+     * Empty the region: what it last said is no longer so. A query that was
+     * 「running」 and failed is not still running, and a reader who reaches
+     * the region afterwards must not find that there (#3603).
+     */
+    clear(): void;
+}
+/**
+ * One live region for one surface, and the sentence to put in it.
+ *
+ * Four surfaces here move a row by a keyboard shortcut of their own — the
+ * column settings, the sort editor, the view manager and the visualization
+ * panel's series list — and the first three each had their own
+ * `role="status" aria-live="polite"` block, written out three times. The
+ * region is not the interesting part of any of them: the wording is
+ * (`dragWording.ts`, `dragAnnounce.ts`, and each list's own `drag.ts`),
+ * and the caller hands that over already formatted.
+ *
+ * Why there is a region at all, next to a drag library that owns one:
+ * `@dnd-kit`'s `Accessibility` plugin announces what the plugin itself
+ * drives — pick up, drop, cancel — and every one of those surfaces also
+ * offers a one-press arrow move that never reaches its `KeyboardSensor`. That move is
+ * what this says. **One per surface** is the rule the shared hook exists to
+ * keep: two polite regions on one screen are two voices reading over each
+ * other, and a reader is given no way to tell which answered the key.
+ *
+ * Each sentence is a node of its own inside the region, keyed by how many
+ * have been said: a reader announces what is added to a live region, and
+ * the same text set twice adds nothing.
+ *
+ * The `slot` is the region's `data-slot`, so a suite can still read back
+ * what a particular surface said.
+ */
+export declare function useAnnouncer(slot: string): OwnAnnouncer;
+/**
+ * Says a sentence derived from state once, when it changes, and empties the
+ * region when it turns to nothing — so the next sentence, even the one said
+ * last time, is said again rather than taken for one already heard (#3603).
+ * A re-render on any other account repeats nothing.
+ */
+export declare function useSentence(sentence: string | null, { say, clear }: Pick<OwnAnnouncer, 'say' | 'clear'>): void;
+/**
+ * Hands a surface's one voice to every part drawn inside it: a board's
+ * grid, its tabs, its filters and its building all say what they did
+ * through the board's region, not each through a region of its own.
+ */
+export declare function SurfaceAnnouncer({ say, children, }: {
+    say(message: string): void;
+    children: ReactNode;
+}): import('react').JSX.Element;
+/**
+ * The region of the surface this part is drawn inside, where one hands its
+ * voice down (`SurfaceAnnouncer`) — `region` is then `null`, there being
+ * nothing of the part's own to draw — or a region of its own, for a part a
+ * host draws by itself.
+ */
+export declare function useSurfaceAnnouncer(slot: string): Announcer;
+//# sourceMappingURL=Announcer.d.ts.map

package/dist/ui/kit/Announcer.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"Announcer.d.ts","sourceRoot":"","sources":["../../../src/ui/kit/Announcer.tsx"],"names":[],"mappings":"AAaA,OAAO,EAOL,KAAK,SAAS,EACf,MAAM,OAAO,CAAC;AAEf,MAAM,WAAW,SAAS;IACxB;;;OAGG;IACH,GAAG,CAAC,OAAO,EAAE,MAAM,GAAG,IAAI,CAAC;IAC3B;;;;;OAKG;IACH,MAAM,EAAE,SAAS,CAAC;CACnB;AAED,yDAAyD;AACzD,MAAM,WAAW,YAAa,SAAQ,SAAS;IAC7C;;;;OAIG;IACH,KAAK,IAAI,IAAI,CAAC;CACf;AAED;;;;;;;;;;;;;;;;;;;;;;;;;GAyBG;AACH,wBAAgB,YAAY,CAAC,IAAI,EAAE,MAAM,GAAG,YAAY,CA2BvD;AAED;;;;;GAKG;AACH,wBAAgB,WAAW,CACzB,QAAQ,EAAE,MAAM,GAAG,IAAI,EACvB,EAAE,GAAG,EAAE,KAAK,EAAE,EAAE,IAAI,CAAC,YAAY,EAAE,KAAK,GAAG,OAAO,CAAC,GAClD,IAAI,CAQN;AAKD;;;;GAIG;AACH,wBAAgB,gBAAgB,CAAC,EAC/B,GAAG,EACH,QAAQ,GACT,EAAE;IACD,GAAG,CAAC,OAAO,EAAE,MAAM,GAAG,IAAI,CAAC;IAC3B,QAAQ,EAAE,SAAS,CAAC;CACrB,+BAEA;AAED;;;;;GAKG;AACH,wBAAgB,mBAAmB,CAAC,IAAI,EAAE,MAAM,GAAG,SAAS,CAI3D"}

package/dist/ui/kit/CopyButton.d.ts

@@ -0,0 +1,31 @@
+export interface CopyButtonProps {
+    /**
+     * The text the clipboard is given — and the text the button is named
+     * after, so a reader hears which of a page full of these it has landed on.
+     * It is what the cell shows, not what the record holds: a copy that came
+     * back as thirteen digits where the screen said a date would be a second,
+     * quieter reading of the value.
+     */
+    value: string;
+    /** Layout only; the button's own look is `ghost` / `icon-xs`. */
+    className?: string;
+}
+/**
+ * A value's own copy button.
+ *
+ * There is no `Copy` in the registry, so this is the one wrapper over
+ * `IconButton` that pairs the clipboard with the two words it can come back
+ * with. Everything else about it is already decided elsewhere: `IconButton`
+ * gives it a name in one string said twice (tooltip and `aria-label`), and
+ * the catalogue gives the wording.
+ *
+ * **The outcome is said, not only shown.** The word appears on the control
+ * the user just pressed, and a screen reader does not re-read a button it is
+ * already sitting on; a live region mounted with the settled sentence is how
+ * `SaveActions` says the same kind of thing. It is mounted per outcome rather
+ * than kept empty on every row — `DashboardGrid` gives the reason: a dozen
+ * empty regions is a dozen things for a reader to walk past, and only the
+ * button that was pressed ever has anything to say.
+ */
+export declare function CopyButton({ value, className }: CopyButtonProps): import('react').JSX.Element;
+//# sourceMappingURL=CopyButton.d.ts.map

package/dist/ui/kit/CopyButton.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"CopyButton.d.ts","sourceRoot":"","sources":["../../../src/ui/kit/CopyButton.tsx"],"names":[],"mappings":"AA+DA,MAAM,WAAW,eAAe;IAC9B;;;;;;OAMG;IACH,KAAK,EAAE,MAAM,CAAC;IACd,iEAAiE;IACjE,SAAS,CAAC,EAAE,MAAM,CAAC;CACpB;AAED;;;;;;;;;;;;;;;;GAgBG;AACH,wBAAgB,UAAU,CAAC,EAAE,KAAK,EAAE,SAAS,EAAE,EAAE,eAAe,+BAuD/D"}

package/dist/ui/kit/DragHandle.d.ts

@@ -0,0 +1,84 @@
+/**
+ * One move a handle asks its list for: a place either way (an arrow key,
+ * or 「往前移一位」／「往后移一位」 in its menu), or either end of the list.
+ * The list turns it into a place of its own — some read where the row is
+ * *now* rather than where it was drawn (the view manager, whose moves land
+ * after a write).
+ */
+export type HandleMove = -1 | 1 | 'first' | 'last';
+/** The place a move asks for, in a list of `total` read from `index`. */
+export declare function moveTarget(move: HandleMove, index: number, total: number): number;
+export interface DragHandleProps {
+    /**
+     * The handle element the library holds — `handleRef` from `useSortable`,
+     * which is what makes this button the one place a row can be picked up
+     * from rather than the whole row.
+     */
+    ref?: (element: HTMLElement | null) => void;
+    /**
+     * What this handle carries, named: "Reorder 金额". Each list words it in
+     * its own catalogue key, because a handle in a column panel and a handle
+     * in the view manager move different things. The menu is named by it too.
+     */
+    label: string;
+    /**
+     * Where the row stands among the rows it can trade places with, from 0,
+     * and how many there are: which of the menu's places are there to go to.
+     */
+    index: number;
+    total: number;
+    /** True while the library is carrying this row, so the arrows are its. */
+    dragging?: boolean;
+    /**
+     * Off while this row has no order to change — a fixed column, a lone sort
+     * entry — or while it is busy with something else. Never a permission (D4):
+     * a list that cannot be reordered at all draws no handle in the first place.
+     */
+    disabled?: boolean;
+    /** The row's own sentence saying why the handle is off, when it is off. */
+    describedBy?: string;
+    /**
+     * How large the handle is drawn, matching the other buttons on its row:
+     * `icon-xs` (24px, WCAG 2.5.8's floor) in the lists of a popover or a
+     * panel, `icon-sm` (28px) in the manager and on a dashboard panel's
+     * header, whose other buttons are that size.
+     */
+    size?: 'icon-xs' | 'icon-sm';
+    /**
+     * The way the list runs, which is the pair of arrows that moves along it:
+     * up and down for the lists, left and right for a dashboard's tab bar and
+     * its filter bar.
+     */
+    axis?: 'vertical' | 'horizontal';
+    /** Moves the row, from the arrow keys on this handle or from its menu. */
+    onMove(move: HandleMove): void;
+}
+/**
+ * The handle a sortable row is carried by — the one way any list in this
+ * package is put in another order (「可排序的列表一律拖拽排序」, 2026-09-25).
+ *
+ * Every list used to write its own: three wrote this button out word for
+ * word, and the rest moved a row with a pair of 「上移」／「下移」 arrows
+ * beside it. One component now carries every one of them, which is what
+ * keeps them the same — the grip, its place at the row's start, its size,
+ * the keys it answers, what it says — and a list only names it, says why it
+ * is off, and says where the row landed. It is worked three ways:
+ *
+ * - **dragged** by a pointer (the library, through `handleRef`);
+ * - **arrow keys** move the row one place, and Space picks it up for the
+ *   library's own keyboard drag (the instructions on the handle,
+ *   `label.reorder.instructions`, say both);
+ * - **clicked** — a press that does not travel far enough to be a drag
+ *   (`sortableList`'s sensors) — opens a menu of the four places it can go:
+ *   to the start, one earlier, one later, to the end. That is the one-press
+ *   way to move a row for a pointer that cannot drag (WCAG 2.5.7): a head
+ *   pointer, a switch, a hand that shakes. A place the row cannot go is
+ *   there and off, so the menu reads the same on every row.
+ *
+ * **Silent while the row is in the air.** The tooltip would otherwise follow
+ * the pointer across the list it is meant to be dropping into, saying
+ * something the user is in the middle of doing. Keyboard focus still opens
+ * it, which is where the name earns its keep.
+ */
+export declare function DragHandle({ ref, label, index, total, dragging, disabled, describedBy, size, axis, onMove, }: DragHandleProps): import('react').JSX.Element;
+//# sourceMappingURL=DragHandle.d.ts.map

package/dist/ui/kit/DragHandle.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"DragHandle.d.ts","sourceRoot":"","sources":["../../../src/ui/kit/DragHandle.tsx"],"names":[],"mappings":"AAyBA;;;;;;GAMG;AACH,MAAM,MAAM,UAAU,GAAG,CAAC,CAAC,GAAG,CAAC,GAAG,OAAO,GAAG,MAAM,CAAC;AAEnD,yEAAyE;AACzE,wBAAgB,UAAU,CACxB,IAAI,EAAE,UAAU,EAChB,KAAK,EAAE,MAAM,EACb,KAAK,EAAE,MAAM,GACZ,MAAM,CAER;AA0BD,MAAM,WAAW,eAAe;IAC9B;;;;OAIG;IACH,GAAG,CAAC,EAAE,CAAC,OAAO,EAAE,WAAW,GAAG,IAAI,KAAK,IAAI,CAAC;IAC5C;;;;OAIG;IACH,KAAK,EAAE,MAAM,CAAC;IACd;;;OAGG;IACH,KAAK,EAAE,MAAM,CAAC;IACd,KAAK,EAAE,MAAM,CAAC;IACd,0EAA0E;IAC1E,QAAQ,CAAC,EAAE,OAAO,CAAC;IACnB;;;;OAIG;IACH,QAAQ,CAAC,EAAE,OAAO,CAAC;IACnB,2EAA2E;IAC3E,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB;;;;;OAKG;IACH,IAAI,CAAC,EAAE,SAAS,GAAG,SAAS,CAAC;IAC7B;;;;OAIG;IACH,IAAI,CAAC,EAAE,UAAU,GAAG,YAAY,CAAC;IACjC,0EAA0E;IAC1E,MAAM,CAAC,IAAI,EAAE,UAAU,GAAG,IAAI,CAAC;CAChC;AAED;;;;;;;;;;;;;;;;;;;;;;;;;;GA0BG;AACH,wBAAgB,UAAU,CAAC,EACzB,GAAG,EACH,KAAK,EACL,KAAK,EACL,KAAK,EACL,QAAQ,EACR,QAAQ,EACR,WAAW,EACX,IAAgB,EAChB,IAAiB,EACjB,MAAM,GACP,EAAE,eAAe,+BAsFjB"}