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

package/dist/ui/charts/optionMerge.d.ts

@@ -0,0 +1,10 @@
+import { EChartsCoreOption } from 'echarts/core';
+/**
+ * `over` laid onto `base`, object by object, and a list of objects — the
+ * series — item by item, as the library merges an option handed to a
+ * drawing it already holds: a pie's radius adjusted on a resize and the
+ * same adjustment folded into a new drawing land alike. Anything else
+ * replaces, a list of numbers included.
+ */
+export declare function merged(base: EChartsCoreOption, over: EChartsCoreOption): EChartsCoreOption;
+//# sourceMappingURL=optionMerge.d.ts.map

package/dist/ui/charts/optionMerge.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"optionMerge.d.ts","sourceRoot":"","sources":["../../../src/ui/charts/optionMerge.ts"],"names":[],"mappings":"AAaA,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,cAAc,CAAC;AAEtD;;;;;;GAMG;AACH,wBAAgB,MAAM,CACpB,IAAI,EAAE,iBAAiB,EACvB,IAAI,EAAE,iBAAiB,GACtB,iBAAiB,CAoBnB"}

package/dist/ui/charts/palette.d.ts

@@ -0,0 +1,43 @@
+import { ChartSpec, FieldTone } from '../../model/index.js';
+/**
+ * The slot at `index`. Past the last one it starts again — a pie folds its
+ * tail before it gets there (`shapeChart`), so only a series split more
+ * ways than the palette has colours still arrives here and repeats one.
+ */
+export declare function color(index: number): string;
+/**
+ * The colour of a pie's merged "Other": a neutral, not a slot. It is not a
+ * category — nobody can pick it or pin a colour to it — and a hue would say
+ * it is one; the grey reads as "the rest" beside the slots the categories
+ * wear. It is the muted ink every surface already carries, so a theme that
+ * restyles its greys restyles this one with them.
+ */
+export declare const OTHER_COLOR = "var(--muted-foreground)";
+/**
+ * The colour the spec pinned for the first of `keys` that names one, and the
+ * slot otherwise. A key is a series or category as the kernel labels it, never
+ * an internal one: the kernel tags a pivot's key by type, so a spec could
+ * not name it if it tried. Nor is it the text shown, an enum's label or a bucket's day:
+ * that follows the language and the definition's wording, and a saved key must
+ * not.
+ *
+ * A spec may reach here unvalidated — the stories pass one straight in — and
+ * its value reaches the drawing and the legend, so the kernel's predicate
+ * decides again here rather than being trusted to have run.
+ */
+export declare function colorOf(spec: ChartSpec | undefined, index: number, ...keys: string[]): string;
+/** The colour the spec pinned for the first of `keys` that names one. */
+export declare function pinnedColor(spec: ChartSpec | undefined, ...keys: string[]): string | undefined;
+/** The role colour a tone paints with; `undefined` for none or neutral. */
+export declare function toneColor(tone: FieldTone | undefined): string | undefined;
+/**
+ * The tone colour each of a chart's categories wears — a pie's slice, a
+ * split series, a stream — in their order: its tone's (`toneColor`) where it
+ * is the only one of them wearing it, nothing otherwise. A chart is read by
+ * telling its categories apart, and two categories sharing a tone would be
+ * one colour, so each of those takes its slot instead, as a category with
+ * no tone does. The tone is what the badge of the same value is tinted
+ * with, so 「不可恢复」 is red in the table, the pie and the bars alike.
+ */
+export declare function heldTones(tones: readonly (FieldTone | undefined)[]): (string | undefined)[];
+//# sourceMappingURL=palette.d.ts.map

package/dist/ui/charts/palette.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"palette.d.ts","sourceRoot":"","sources":["../../../src/ui/charts/palette.ts"],"names":[],"mappings":"AAcA,OAAO,EAEL,KAAK,SAAS,EACd,KAAK,SAAS,EACf,MAAM,sBAAsB,CAAC;AAa9B;;;;GAIG;AACH,wBAAgB,KAAK,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM,CAE3C;AAED;;;;;;GAMG;AACH,eAAO,MAAM,WAAW,4BAA4B,CAAC;AAErD;;;;;;;;;;;GAWG;AACH,wBAAgB,OAAO,CACrB,IAAI,EAAE,SAAS,GAAG,SAAS,EAC3B,KAAK,EAAE,MAAM,EACb,GAAG,IAAI,EAAE,MAAM,EAAE,GAChB,MAAM,CAER;AAED,yEAAyE;AACzE,wBAAgB,WAAW,CACzB,IAAI,EAAE,SAAS,GAAG,SAAS,EAC3B,GAAG,IAAI,EAAE,MAAM,EAAE,GAChB,MAAM,GAAG,SAAS,CAMpB;AAgBD,2EAA2E;AAC3E,wBAAgB,SAAS,CAAC,IAAI,EAAE,SAAS,GAAG,SAAS,GAAG,MAAM,GAAG,SAAS,CAIzE;AAED;;;;;;;;GAQG;AACH,wBAAgB,SAAS,CACvB,KAAK,EAAE,SAAS,CAAC,SAAS,GAAG,SAAS,CAAC,EAAE,GACxC,CAAC,MAAM,GAAG,SAAS,CAAC,EAAE,CAOxB"}

package/dist/ui/charts/patterns.d.ts

@@ -0,0 +1,29 @@
+import { EChartsCoreOption } from 'echarts/core';
+/**
+ * Whether the reader's system asks for more contrast
+ * (`prefers-contrast: more`), read live — the default for drawing patterns
+ * over a chart's colours (decal, docs/design/decisions.md D33 Q57).
+ *
+ * The palette's light slots — cyan, yellow, magenta — stand at under 3:1
+ * against a card (docs/design/ui/analysis.md); a reader who asked their
+ * system for more contrast gets a pattern on each series as well as its
+ * colour, so two marks side by side are told apart by more than hue. A host
+ * pins it either way with `--fve-chart-patterns: on | off` (`ChartTheme`);
+ * it is the host's and the reader's, never the view's, and nothing about it
+ * is saved (D30 Q41). Where the platform cannot say, no patterns.
+ */
+export declare function usePatterns(): boolean;
+/**
+ * `option` with the library's decal patterns on every series: its aria
+ * component with the patterns and nothing else. Its generated description
+ * stays off — the drawing is one image named by `readChart`, and the
+ * numbers are the reading table's (D21) — so the patterns are the only thing
+ * it adds. They are drawn from each series' own colour; no colour is added.
+ */
+export declare function withPatterns(option: EChartsCoreOption): EChartsCoreOption;
+/**
+ * The host's pin, as `--fve-chart-patterns` reads: `on` or `off` pins it,
+ * anything else — unset, `auto` — follows the reader's system.
+ */
+export declare function patternsPinned(value: string): boolean | undefined;
+//# sourceMappingURL=patterns.d.ts.map

package/dist/ui/charts/patterns.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"patterns.d.ts","sourceRoot":"","sources":["../../../src/ui/charts/patterns.ts"],"names":[],"mappings":"AAaA,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,cAAc,CAAC;AAGtD;;;;;;;;;;;;GAYG;AACH,wBAAgB,WAAW,IAAI,OAAO,CAErC;AAqBD;;;;;;GAMG;AACH,wBAAgB,YAAY,CAAC,MAAM,EAAE,iBAAiB,GAAG,iBAAiB,CAKzE;AAED;;;GAGG;AACH,wBAAgB,cAAc,CAAC,KAAK,EAAE,MAAM,GAAG,OAAO,GAAG,SAAS,CAGjE"}

package/dist/ui/charts/periodSpan.d.ts

@@ -0,0 +1,11 @@
+import { MetricPeriod } from '../../analysis/index.js';
+import { MessageFormatters } from '../kit/MessagesProvider.js';
+/**
+ * The part of a period a trend card's dates hold (`MetricPeriod.span`), as
+ * the card names it over its number: one day as that day
+ * (「2026年9月21日」), days of one month as 「2026年9月15日–21日」, of one
+ * year as 「2026年8月25日–9月5日」, and any other two moments as both
+ * written out — with the time where an end falls inside a day.
+ */
+export declare function spanName(span: NonNullable<MetricPeriod['span']>, locale: string | undefined, messages: MessageFormatters): string;
+//# sourceMappingURL=periodSpan.d.ts.map

package/dist/ui/charts/periodSpan.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"periodSpan.d.ts","sourceRoot":"","sources":["../../../src/ui/charts/periodSpan.ts"],"names":[],"mappings":"AAaA,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,yBAAyB,CAAC;AAC5D,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,4BAA4B,CAAC;AA8BpE;;;;;;GAMG;AACH,wBAAgB,QAAQ,CACtB,IAAI,EAAE,WAAW,CAAC,YAAY,CAAC,MAAM,CAAC,CAAC,EACvC,MAAM,EAAE,MAAM,GAAG,SAAS,EAC1B,QAAQ,EAAE,iBAAiB,GAC1B,MAAM,CA+CR"}

package/dist/ui/charts/pieOption.d.ts

@@ -0,0 +1,107 @@
+import { EChartsCoreOption } from 'echarts/core';
+import { PieData } from '../../analysis/index.js';
+import { ChartSpec } from '../../model/index.js';
+import { SeriesName, ToneOf, ValueLabel } from './family.js';
+import { ChartTheme } from './theme.js';
+/** What a pie reads besides its slices. */
+export interface PieContext {
+    spec?: ChartSpec;
+    label: ValueLabel;
+    /**
+     * What a slice is called (`useSeriesName`): 「新客：是」 for a pie by a
+     * yes/no field; left out, its category as its column reads it.
+     */
+    seriesName?: SeriesName;
+    /** The tone a category's option gives it (`useToneOf`). */
+    toneOf?: ToneOf;
+    locale?: string;
+    /** The merged remainder's name, 「其他」. */
+    other: string;
+    /** The word under a donut's total, 「合计」. */
+    total: string;
+    /** Whether the measured column adds up, so a donut may write its whole. */
+    adds: boolean;
+    animate: boolean;
+    pickable: boolean;
+}
+/** One slice as every part of the pie names it. */
+export interface DrawnSlice {
+    key: string;
+    name: string;
+    value: number;
+    /** Its part of the whole, or nothing: a negative value has no share. */
+    share?: number;
+    /**
+     * A CSS colour: the one pinned, the category's tone, its slot, or the
+     * grey of 「其他」.
+     */
+    color: string;
+}
+/**
+ * The smallest share written on its slice. A sliver's label would crowd its
+ * neighbours; its share is in the tooltip, the legend and the reading table.
+ */
+export declare const LABELLED_SHARE = 0.03;
+/**
+ * The slices with their names, shares and colours.
+ *
+ * A pie is shares of a whole (audit P0-10), and the whole is the slices
+ * drawn: a metric that went negative has no share to give, so it gives
+ * none and takes none. A slice is coloured by its category through
+ * `groupKeyText` — the spelling a split series is keyed by, so one key
+ * colours a category in either chart; the merged remainder is no category
+ * anyone could colour, so it is the neutral whatever the spec says.
+ *
+ * A category whose option names a tone wears the tone's role colour
+ * (`toneColor`) — 「不可恢复」 red, 「已成功」 green, as their badges are —
+ * unless the analyst pinned another. Two categories sharing a tone would
+ * then be one colour, and a pie is read by telling its slices apart, so a
+ * tone paints only the one category that holds it; the others take their
+ * slots, as a category without a tone does.
+ */
+export declare function drawnSlices(data: PieData, { spec, label, other, seriesName, toneOf, }: Pick<PieContext, 'spec' | 'label' | 'other' | 'seriesName' | 'toneOf'>): DrawnSlice[];
+/**
+ * What each slice writes outside itself, in the slices' order; `''` for a
+ * slice that writes nothing. A slice of 3% or more says its share, and with
+ * `labels: true` its value, short, before it.
+ */
+export declare function pieCaptions(data: PieData, context: Pick<PieContext, 'spec' | 'label' | 'locale' | 'other' | 'seriesName'>): string[];
+/**
+ * How far a pie gives way to make room for its labels: to seven tenths of
+ * its full size. Smaller, the picture is spent on words the legend already
+ * holds.
+ */
+export declare const LABEL_ROOM_SHRINK = 0.7;
+/**
+ * What the plot's size changes about a pie: whether its labels are written,
+ * and how big it is to make room for them (audit P0-6).
+ *
+ * A label outside a slice needs the room from the pie's edge to the plot's:
+ * the leader line, then the words. Where there is not enough the library
+ * cut the number — 47.7% came out 「4」, 28.3% 「28....」, and a 「4」 is a
+ * number, worse than none. So a label is written whole or not at all: the
+ * pie gives way first, down to `LABEL_ROOM_SHRINK` of its size, so the
+ * widest label fits even beside the pie's widest point; past that no slice
+ * writes its label, and the legend, which carries every share, and the
+ * tooltip say them — as Metabase leaves out an outer label it cannot fit.
+ * Measured against the widest point, so a label the library slides along
+ * the rim to clear its neighbour still fits.
+ */
+export declare function pieFit(captions: readonly string[], width: number, height: number, 
+/** How wide a line of text is, at the chart's text size. */
+measure: (text: string) => number, donut: boolean, 
+/** The chart's type: a label is measured a step under its text. */
+text?: Pick<ChartTheme['text'], 'size' | 'labelSize'>): EChartsCoreOption;
+/**
+ * A pie or a donut as the library draws it.
+ *
+ * Each slice of 3% or more says its share outside itself, on a leader line
+ * (`pieCaptions`), and a label that would land on another is left out
+ * rather than drawn over it. A label is never cut short: whether the plot
+ * has room for them is `pieFit`'s to say. A donut writes its whole in the
+ * hole — when the measure adds up, since the total of some averages is not
+ * a number anyone asked for. The tooltip is the slice's value, whole, and
+ * its share.
+ */
+export declare function pieOption(data: PieData, context: PieContext, theme: ChartTheme): EChartsCoreOption;
+//# sourceMappingURL=pieOption.d.ts.map

package/dist/ui/charts/pieOption.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"pieOption.d.ts","sourceRoot":"","sources":["../../../src/ui/charts/pieOption.ts"],"names":[],"mappings":"AAaA,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,cAAc,CAAC;AACtD,OAAO,EAGL,KAAK,OAAO,EACb,MAAM,yBAAyB,CAAC;AACjC,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,sBAAsB,CAAC;AAEtD,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,EAAE,UAAU,EAAE,MAAM,aAAa,CAAC;AAElE,OAAO,EAIL,KAAK,UAAU,EAChB,MAAM,YAAY,CAAC;AAGpB,2CAA2C;AAC3C,MAAM,WAAW,UAAU;IACzB,IAAI,CAAC,EAAE,SAAS,CAAC;IACjB,KAAK,EAAE,UAAU,CAAC;IAClB;;;OAGG;IACH,UAAU,CAAC,EAAE,UAAU,CAAC;IACxB,2DAA2D;IAC3D,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,yCAAyC;IACzC,KAAK,EAAE,MAAM,CAAC;IACd,4CAA4C;IAC5C,KAAK,EAAE,MAAM,CAAC;IACd,2EAA2E;IAC3E,IAAI,EAAE,OAAO,CAAC;IACd,OAAO,EAAE,OAAO,CAAC;IACjB,QAAQ,EAAE,OAAO,CAAC;CACnB;AAED,mDAAmD;AACnD,MAAM,WAAW,UAAU;IACzB,GAAG,EAAE,MAAM,CAAC;IACZ,IAAI,EAAE,MAAM,CAAC;IACb,KAAK,EAAE,MAAM,CAAC;IACd,wEAAwE;IACxE,KAAK,CAAC,EAAE,MAAM,CAAC;IACf;;;OAGG;IACH,KAAK,EAAE,MAAM,CAAC;CACf;AAED;;;GAGG;AACH,eAAO,MAAM,cAAc,OAAO,CAAC;AAEnC;;;;;;;;;;;;;;;;GAgBG;AACH,wBAAgB,WAAW,CACzB,IAAI,EAAE,OAAO,EACb,EACE,IAAI,EACJ,KAAK,EACL,KAAK,EACL,UAAkB,EAClB,MAAM,GACP,EAAE,IAAI,CAAC,UAAU,EAAE,MAAM,GAAG,OAAO,GAAG,OAAO,GAAG,YAAY,GAAG,QAAQ,CAAC,GACxE,UAAU,EAAE,CAuBd;AAUD;;;;GAIG;AACH,wBAAgB,WAAW,CACzB,IAAI,EAAE,OAAO,EACb,OAAO,EAAE,IAAI,CACX,UAAU,EACV,MAAM,GAAG,OAAO,GAAG,QAAQ,GAAG,OAAO,GAAG,YAAY,CACrD,GACA,MAAM,EAAE,CAUV;AAYD;;;;GAIG;AACH,eAAO,MAAM,iBAAiB,MAAM,CAAC;AAErC;;;;;;;;;;;;;;GAcG;AACH,wBAAgB,MAAM,CACpB,QAAQ,EAAE,SAAS,MAAM,EAAE,EAC3B,KAAK,EAAE,MAAM,EACb,MAAM,EAAE,MAAM;AACd,4DAA4D;AAC5D,OAAO,EAAE,CAAC,IAAI,EAAE,MAAM,KAAK,MAAM,EACjC,KAAK,EAAE,OAAO;AACd,mEAAmE;AACnE,IAAI,GAAE,IAAI,CAAC,UAAU,CAAC,MAAM,CAAC,EAAE,MAAM,GAAG,WAAW,CAAuB,GACzE,iBAAiB,CAqBnB;AAED;;;;;;;;;;GAUG;AACH,wBAAgB,SAAS,CACvB,IAAI,EAAE,OAAO,EACb,OAAO,EAAE,UAAU,EACnB,KAAK,EAAE,UAAU,GAChB,iBAAiB,CAsHnB"}

package/dist/ui/charts/print.d.ts

@@ -0,0 +1,16 @@
+/**
+ * Whether the page is being printed (themes.md 4.6).
+ *
+ * The stylesheet prints every surface in the light half of its preset, with
+ * the chart patterns on (`styles.css`, `@media print`), but a chart is drawn
+ * by script, in the colours it read off the stylesheet when it was drawn —
+ * no media query reaches the drawing. So a chart reads its theme again when
+ * printing starts, and once more when it ends: the browser answers the
+ * `print` query while it lays the page out for paper, and the chart library
+ * draws synchronously, before the page is captured.
+ *
+ * Where the platform cannot say (no `matchMedia`, a server render), nothing
+ * is being printed.
+ */
+export declare function usePrinting(): boolean;
+//# sourceMappingURL=print.d.ts.map

package/dist/ui/charts/print.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"print.d.ts","sourceRoot":"","sources":["../../../src/ui/charts/print.ts"],"names":[],"mappings":"AAeA;;;;;;;;;;;;;GAaG;AACH,wBAAgB,WAAW,IAAI,OAAO,CAErC"}

package/dist/ui/charts/profileOption.d.ts

@@ -0,0 +1,47 @@
+import { EChartsCoreOption } from 'echarts/core';
+import { ParallelData, RadarData } from '../../analysis/index.js';
+import { ChartSpec, RecordData } from '../../model/index.js';
+import { ColumnTitle, SeriesName, ValueLabel } from './family.js';
+import { ChartTheme } from './theme.js';
+/** What a radar or parallel axes read besides their profiles. */
+export interface ProfileContext {
+    spec?: ChartSpec;
+    label: ValueLabel;
+    column: ColumnTitle;
+    seriesName?: SeriesName;
+    animate: boolean;
+    pickable: boolean;
+    /** The group a press set the board's filter to (D22 I): the rest faint. */
+    highlight?: (row: RecordData) => boolean;
+}
+/** One drawn shape or line: its group, name and colour. */
+export interface DrawnProfile {
+    row: RecordData;
+    key: string;
+    name: string;
+    color: string;
+}
+/**
+ * Every shape or line in the order drawn, each with the group it stands
+ * for, its name as the legend says it and its colour: a slot of its own up
+ * to the palette's size, the spec's pinned colour first; past it, parallel
+ * axes' lines wear the first slot alone, since a line is read by where it
+ * runs and the tooltip names it.
+ */
+export declare function drawnProfiles(data: RadarData | ParallelData, { spec, label, seriesName, }: Pick<ProfileContext, 'spec' | 'label' | 'seriesName'>): DrawnProfile[];
+/**
+ * A radar as the library draws it: an axis per metric going round, each
+ * titled by its column and on its own scale from 0 to a round number past
+ * its largest value, the web in the border's colour; a closed shape per
+ * group in its slot, faintly filled so every outline reads through the
+ * others.
+ */
+export declare function radarOption(data: RadarData, context: ProfileContext, theme: ChartTheme): EChartsCoreOption;
+/**
+ * Parallel axes as the library draws them: an upright axis per metric,
+ * titled by its column and on its own scale, and a line per group across
+ * them — a slot each up to the palette's size, one colour past it, faint
+ * enough that where the lines crowd reads as crowding.
+ */
+export declare function parallelOption(data: ParallelData, context: ProfileContext, theme: ChartTheme): EChartsCoreOption;
+//# sourceMappingURL=profileOption.d.ts.map

package/dist/ui/charts/profileOption.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"profileOption.d.ts","sourceRoot":"","sources":["../../../src/ui/charts/profileOption.ts"],"names":[],"mappings":"AAaA,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,cAAc,CAAC;AACtD,OAAO,KAAK,EAAE,YAAY,EAAE,SAAS,EAAE,MAAM,yBAAyB,CAAC;AAEvE,OAAO,EAAqB,KAAK,SAAS,EAAE,MAAM,sBAAsB,CAAC;AACzE,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,sBAAsB,CAAC;AACvD,OAAO,KAAK,EAAE,WAAW,EAAE,UAAU,EAAE,UAAU,EAAE,MAAM,aAAa,CAAC;AAIvE,OAAO,EAAc,KAAK,UAAU,EAAa,MAAM,YAAY,CAAC;AAGpE,iEAAiE;AACjE,MAAM,WAAW,cAAc;IAC7B,IAAI,CAAC,EAAE,SAAS,CAAC;IACjB,KAAK,EAAE,UAAU,CAAC;IAClB,MAAM,EAAE,WAAW,CAAC;IACpB,UAAU,CAAC,EAAE,UAAU,CAAC;IACxB,OAAO,EAAE,OAAO,CAAC;IACjB,QAAQ,EAAE,OAAO,CAAC;IAClB,2EAA2E;IAC3E,SAAS,CAAC,EAAE,CAAC,GAAG,EAAE,UAAU,KAAK,OAAO,CAAC;CAC1C;AAED,2DAA2D;AAC3D,MAAM,WAAW,YAAY;IAC3B,GAAG,EAAE,UAAU,CAAC;IAChB,GAAG,EAAE,MAAM,CAAC;IACZ,IAAI,EAAE,MAAM,CAAC;IACb,KAAK,EAAE,MAAM,CAAC;CACf;AAED;;;;;;GAMG;AACH,wBAAgB,aAAa,CAC3B,IAAI,EAAE,SAAS,GAAG,YAAY,EAC9B,EACE,IAAI,EACJ,KAAK,EACL,UAAU,GACX,EAAE,IAAI,CAAC,cAAc,EAAE,MAAM,GAAG,OAAO,GAAG,YAAY,CAAC,GACvD,YAAY,EAAE,CAahB;AAqDD;;;;;;GAMG;AACH,wBAAgB,WAAW,CACzB,IAAI,EAAE,SAAS,EACf,OAAO,EAAE,cAAc,EACvB,KAAK,EAAE,UAAU,GAChB,iBAAiB,CAgEnB;AAKD;;;;;GAKG;AACH,wBAAgB,cAAc,CAC5B,IAAI,EAAE,YAAY,EAClB,OAAO,EAAE,cAAc,EACvB,KAAK,EAAE,UAAU,GAChB,iBAAiB,CA2EnB"}

package/dist/ui/charts/reading.d.ts

@@ -0,0 +1,66 @@
+import { ChartData } from '../../analysis/index.js';
+import { ChartSpec, ChartType, ValueFormat } from '../../model/index.js';
+import { MessageFormatters } from '../kit/MessagesProvider.js';
+import { FilledNote, SeriesName, ValueLabel } from './family.js';
+/**
+ * A chart as text: a name for the drawing and the same numbers it draws,
+ * laid out as a table.
+ *
+ * The drawing is one image with a name (`role="img"`), so nothing inside the
+ * `<svg>` reaches a screen reader — which is the whole point, since what was
+ * inside it was axis ticks and an empty `<title>`. This carries the answer
+ * instead, and it is built from `ChartData`, the very projection the marks
+ * are drawn from, so the two cannot drift: a value on screen with no row
+ * here would mean a family drew something the kernel did not shape.
+ */
+export interface ChartReading {
+    /** What is drawn, in one line; the drawing's accessible name. */
+    name: string;
+    /**
+     * The drawing in one sentence, said after its name (`chartSentence`):
+     * how many groups, the highest and the lowest. Absent where there is no
+     * number to say; a metric card's is its sparkline's, since its face says
+     * the headline in words.
+     */
+    sentence?: string;
+    /** The readable table's column headers. */
+    header: readonly string[];
+    /** One row per drawn datum, every cell already text. */
+    rows: readonly (readonly string[])[];
+}
+/** What a reading needs besides the data: wording and the two labellers. */
+export interface ReadingContext {
+    messages: MessageFormatters;
+    /** A value as its column shows it, category and measure alike. */
+    label: ValueLabel;
+    /** An alias as its column is titled, or the alias itself. */
+    column: (alias: string | undefined) => string | undefined;
+    /**
+     * A series or a slice standing for one group value, as the legend names
+     * it (`useSeriesName`); left out, the value as its column reads it.
+     */
+    seriesName?: SeriesName;
+    /** The surface's language, for a number an axis format prints. */
+    locale: string | undefined;
+    /**
+     * A value the chart filled in, as the tooltip says it (`useFilledNote`):
+     * the table says the same 「0（这一天没有记录）」 the tooltip does.
+     */
+    filled?: FilledNote;
+}
+export declare function readChart(data: ChartData, spec: ChartSpec | undefined, ctx: ReadingContext): ChartReading;
+/**
+ * `{type}: {measures} by {category}`, and without the tail when nothing
+ * names a category — a metric card is one number, not one number per
+ * anything. With neither, the family's own name is still better than the
+ * `role="application"` and the empty `<title>` this replaced.
+ */
+export declare function nameOf(ctx: ReadingContext, type: ChartType, measures: readonly (string | undefined)[], category?: string): string;
+/**
+ * A measured number, read as its own column reads it — the reading table and
+ * the marks beside it are the same numbers, so they are the same text. An
+ * axis that pinned a `ValueFormat` still wins: that is an instruction about
+ * this axis, and a ratio drawn as 25% must not be read out as 0.25.
+ */
+export declare function number(value: number | null | undefined, ctx: ReadingContext, format?: ValueFormat, alias?: string): string;
+//# sourceMappingURL=reading.d.ts.map

package/dist/ui/charts/reading.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"reading.d.ts","sourceRoot":"","sources":["../../../src/ui/charts/reading.ts"],"names":[],"mappings":"AAaA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,yBAAyB,CAAC;AACzD,OAAO,KAAK,EAAE,SAAS,EAAE,SAAS,EAAE,WAAW,EAAE,MAAM,sBAAsB,CAAC;AAC9E,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,4BAA4B,CAAC;AAGpE,OAAO,EAAE,KAAK,UAAU,EAAE,KAAK,UAAU,EAAE,KAAK,UAAU,EAAE,MAAM,aAAa,CAAC;AAkBhF;;;;;;;;;;GAUG;AACH,MAAM,WAAW,YAAY;IAC3B,iEAAiE;IACjE,IAAI,EAAE,MAAM,CAAC;IACb;;;;;OAKG;IACH,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,2CAA2C;IAC3C,MAAM,EAAE,SAAS,MAAM,EAAE,CAAC;IAC1B,wDAAwD;IACxD,IAAI,EAAE,SAAS,CAAC,SAAS,MAAM,EAAE,CAAC,EAAE,CAAC;CACtC;AAED,4EAA4E;AAC5E,MAAM,WAAW,cAAc;IAC7B,QAAQ,EAAE,iBAAiB,CAAC;IAC5B,kEAAkE;IAClE,KAAK,EAAE,UAAU,CAAC;IAClB,6DAA6D;IAC7D,MAAM,EAAE,CAAC,KAAK,EAAE,MAAM,GAAG,SAAS,KAAK,MAAM,GAAG,SAAS,CAAC;IAC1D;;;OAGG;IACH,UAAU,CAAC,EAAE,UAAU,CAAC;IACxB,kEAAkE;IAClE,MAAM,EAAE,MAAM,GAAG,SAAS,CAAC;IAC3B;;;OAGG;IACH,MAAM,CAAC,EAAE,UAAU,CAAC;CACrB;AAYD,wBAAgB,SAAS,CACvB,IAAI,EAAE,SAAS,EACf,IAAI,EAAE,SAAS,GAAG,SAAS,EAC3B,GAAG,EAAE,cAAc,GAClB,YAAY,CAId;AA+CD;;;;;GAKG;AACH,wBAAgB,MAAM,CACpB,GAAG,EAAE,cAAc,EACnB,IAAI,EAAE,SAAS,EACf,QAAQ,EAAE,SAAS,CAAC,MAAM,GAAG,SAAS,CAAC,EAAE,EACzC,QAAQ,CAAC,EAAE,MAAM,GAChB,MAAM,CAaR;AAED;;;;;GAKG;AACH,wBAAgB,MAAM,CACpB,KAAK,EAAE,MAAM,GAAG,IAAI,GAAG,SAAS,EAChC,GAAG,EAAE,cAAc,EACnB,MAAM,CAAC,EAAE,WAAW,EACpB,KAAK,CAAC,EAAE,MAAM,GACb,MAAM,CAMR"}

package/dist/ui/charts/readingStatistics.d.ts

@@ -0,0 +1,58 @@
+import { ChartData } from '../../analysis/index.js';
+import { ChartSpec } from '../../model/index.js';
+import { ChartReading, ReadingContext } from './reading.js';
+/**
+ * A boxplot's boxes, in the order drawn: each group's five numbers, each
+ * column headed by its metric — 「实付的第 25 百分位」, not a 「下四分位」
+ * the metric may not be; a percentile's header carries its 「≈」.
+ */
+export declare function readBoxplot(data: Extract<ChartData, {
+    type: 'boxplot';
+}>, spec: ChartSpec | undefined, ctx: ReadingContext): ChartReading;
+/**
+ * A candlestick's candles, earliest first: each period's opening value,
+ * highest, lowest and closing value, each column headed by its metric, and
+ * which way the period went in words — the colour is not the only sign.
+ */
+export declare function readCandlestick(data: Extract<ChartData, {
+    type: 'candlestick';
+}>, spec: ChartSpec | undefined, ctx: ReadingContext): ChartReading;
+/**
+ * A gauge's number, and what only the dial knows: the target, how much of
+ * it is reached, and the scale's two ends.
+ */
+export declare function readGauge(data: Extract<ChartData, {
+    type: 'gauge';
+}>, spec: ChartSpec | undefined, ctx: ReadingContext): ChartReading;
+/**
+ * A radar's shapes or parallel axes' lines, in the order drawn: each
+ * group's number on every axis, each column headed by its metric.
+ */
+export declare function readProfiles(data: Extract<ChartData, {
+    type: 'radar' | 'parallel';
+}>, spec: ChartSpec | undefined, ctx: ReadingContext): ChartReading;
+/**
+ * A sunburst's or a tree's innermost parts, in the order drawn: every
+ * level's value, the number and its share of the whole — the rows the
+ * table layout has, each under its parents.
+ */
+export declare function readHierarchy(data: Extract<ChartData, {
+    type: 'sunburst' | 'tree';
+}>, spec: ChartSpec | undefined, ctx: ReadingContext): ChartReading;
+/** A sankey's bands, largest first: where from, where to, how much. */
+export declare function readFlow(data: Extract<ChartData, {
+    type: 'sankey';
+}>, spec: ChartSpec | undefined, ctx: ReadingContext): ChartReading;
+/** A calendar's days, earliest first: the day and its number. */
+export declare function readCalendar(data: Extract<ChartData, {
+    type: 'calendar';
+}>, spec: ChartSpec | undefined, ctx: ReadingContext): ChartReading;
+/** A theme river's buckets, earliest first: every stream's number at each. */
+export declare function readThemeRiver(data: Extract<ChartData, {
+    type: 'themeRiver';
+}>, spec: ChartSpec | undefined, ctx: ReadingContext): ChartReading;
+/** A map's measured regions, largest first: the region and its number. */
+export declare function readMap(data: Extract<ChartData, {
+    type: 'map';
+}>, spec: ChartSpec | undefined, ctx: ReadingContext): ChartReading;
+//# sourceMappingURL=readingStatistics.d.ts.map

package/dist/ui/charts/readingStatistics.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"readingStatistics.d.ts","sourceRoot":"","sources":["../../../src/ui/charts/readingStatistics.ts"],"names":[],"mappings":"AAaA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,yBAAyB,CAAC;AACzD,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,sBAAsB,CAAC;AAKtD,OAAO,EAGL,KAAK,YAAY,EACjB,KAAK,cAAc,EACpB,MAAM,cAAc,CAAC;AAStB;;;;GAIG;AACH,wBAAgB,WAAW,CACzB,IAAI,EAAE,OAAO,CAAC,SAAS,EAAE;IAAE,IAAI,EAAE,SAAS,CAAA;CAAE,CAAC,EAC7C,IAAI,EAAE,SAAS,GAAG,SAAS,EAC3B,GAAG,EAAE,cAAc,GAClB,YAAY,CAmBd;AAED;;;;GAIG;AACH,wBAAgB,eAAe,CAC7B,IAAI,EAAE,OAAO,CAAC,SAAS,EAAE;IAAE,IAAI,EAAE,aAAa,CAAA;CAAE,CAAC,EACjD,IAAI,EAAE,SAAS,GAAG,SAAS,EAC3B,GAAG,EAAE,cAAc,GAClB,YAAY,CAuBd;AAED;;;GAGG;AACH,wBAAgB,SAAS,CACvB,IAAI,EAAE,OAAO,CAAC,SAAS,EAAE;IAAE,IAAI,EAAE,OAAO,CAAA;CAAE,CAAC,EAC3C,IAAI,EAAE,SAAS,GAAG,SAAS,EAC3B,GAAG,EAAE,cAAc,GAClB,YAAY,CA6Bd;AAED;;;GAGG;AACH,wBAAgB,YAAY,CAC1B,IAAI,EAAE,OAAO,CAAC,SAAS,EAAE;IAAE,IAAI,EAAE,OAAO,GAAG,UAAU,CAAA;CAAE,CAAC,EACxD,IAAI,EAAE,SAAS,GAAG,SAAS,EAC3B,GAAG,EAAE,cAAc,GAClB,YAAY,CA6Bd;AAED;;;;GAIG;AACH,wBAAgB,aAAa,CAC3B,IAAI,EAAE,OAAO,CAAC,SAAS,EAAE;IAAE,IAAI,EAAE,UAAU,GAAG,MAAM,CAAA;CAAE,CAAC,EACvD,IAAI,EAAE,SAAS,GAAG,SAAS,EAC3B,GAAG,EAAE,cAAc,GAClB,YAAY,CA8Bd;AAED,uEAAuE;AACvE,wBAAgB,QAAQ,CACtB,IAAI,EAAE,OAAO,CAAC,SAAS,EAAE;IAAE,IAAI,EAAE,QAAQ,CAAA;CAAE,CAAC,EAC5C,IAAI,EAAE,SAAS,GAAG,SAAS,EAC3B,GAAG,EAAE,cAAc,GAClB,YAAY,CAqBd;AAED,iEAAiE;AACjE,wBAAgB,YAAY,CAC1B,IAAI,EAAE,OAAO,CAAC,SAAS,EAAE;IAAE,IAAI,EAAE,UAAU,CAAA;CAAE,CAAC,EAC9C,IAAI,EAAE,SAAS,GAAG,SAAS,EAC3B,GAAG,EAAE,cAAc,GAClB,YAAY,CAed;AAED,8EAA8E;AAC9E,wBAAgB,cAAc,CAC5B,IAAI,EAAE,OAAO,CAAC,SAAS,EAAE;IAAE,IAAI,EAAE,YAAY,CAAA;CAAE,CAAC,EAChD,IAAI,EAAE,SAAS,GAAG,SAAS,EAC3B,GAAG,EAAE,cAAc,GAClB,YAAY,CA6Bd;AAED,0EAA0E;AAC1E,wBAAgB,OAAO,CACrB,IAAI,EAAE,OAAO,CAAC,SAAS,EAAE;IAAE,IAAI,EAAE,KAAK,CAAA;CAAE,CAAC,EACzC,IAAI,EAAE,SAAS,GAAG,SAAS,EAC3B,GAAG,EAAE,cAAc,GAClB,YAAY,CAcd"}

package/dist/ui/charts/scale.d.ts

@@ -0,0 +1,42 @@
+/** What one value axis has to reach: its marks, lines and whether it counts. */
+export interface AxisReach {
+    /** The lowest a mark or a line reaches; 0 or below, since bars start at 0. */
+    low: number;
+    /** The highest a mark or a line reaches; 0 or above. */
+    high: number;
+    /** Every number on it is whole: its steps are whole too (`allWhole`). */
+    whole: boolean;
+}
+/** An axis's scale: its two ends and the step between its ticks. */
+export interface NiceScale {
+    min: number;
+    max: number;
+    interval: number;
+}
+/**
+ * The smallest nice step of at least `wanted`: 1, 2, 2.5 or 5 times a power
+ * of ten — and, on an axis of whole numbers, a whole one of at least 1,
+ * since a count stepped by 0.5 writes its format's rounding as a second
+ * 「1」 (and 2.5 records is no number of anything).
+ */
+export declare function niceStep(wanted: number, whole: boolean): number;
+/**
+ * The scales of one plot's value axes — one or two — cut into the same
+ * number of steps, with zero on the same line.
+ *
+ * With two axes there is one set of gridlines, and the right axis's ticks
+ * have to stand on it: the library's `alignTicks` did that by stretching
+ * the follower into whatever step the leader's count gave it, and a count
+ * following an amount came out in halves (「0.5」「1.5」 records, found in
+ * the 2026-09-23 audit). Here every axis gets a nice step of its own and
+ * they share only the count — so each reads in round numbers, a count in
+ * whole ones, and the ticks line up by construction. Zero shares a line
+ * too: two sets of bars starting from two baselines would not be one chart.
+ *
+ * The count is the one that wastes the least of the plot on the worst of
+ * the axes, a count near five preferred. Owning the scale also lets the
+ * value labels be judged against the space a mark really gets
+ * (`cartesianFit`), which the library's own rounding would keep to itself.
+ */
+export declare function sharedScales(axes: readonly AxisReach[]): NiceScale[];
+//# sourceMappingURL=scale.d.ts.map

package/dist/ui/charts/scale.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"scale.d.ts","sourceRoot":"","sources":["../../../src/ui/charts/scale.ts"],"names":[],"mappings":"AAaA,gFAAgF;AAChF,MAAM,WAAW,SAAS;IACxB,8EAA8E;IAC9E,GAAG,EAAE,MAAM,CAAC;IACZ,wDAAwD;IACxD,IAAI,EAAE,MAAM,CAAC;IACb,yEAAyE;IACzE,KAAK,EAAE,OAAO,CAAC;CAChB;AAED,oEAAoE;AACpE,MAAM,WAAW,SAAS;IACxB,GAAG,EAAE,MAAM,CAAC;IACZ,GAAG,EAAE,MAAM,CAAC;IACZ,QAAQ,EAAE,MAAM,CAAC;CAClB;AAeD;;;;;GAKG;AACH,wBAAgB,QAAQ,CAAC,MAAM,EAAE,MAAM,EAAE,KAAK,EAAE,OAAO,GAAG,MAAM,CAY/D;AAED;;;;;;;;;;;;;;;;;GAiBG;AACH,wBAAgB,YAAY,CAAC,IAAI,EAAE,SAAS,SAAS,EAAE,GAAG,SAAS,EAAE,CAgCpE"}

package/dist/ui/charts/scatterOption.d.ts

@@ -0,0 +1,44 @@
+import { EChartsCoreOption } from 'echarts/core';
+import { ScatterData } from '../../analysis/index.js';
+import { ChartSpec } from '../../model/index.js';
+import { ColumnTitle, ValueLabel } from './family.js';
+import { ChartTheme } from './theme.js';
+/** What a scatter reads besides its points. */
+export interface ScatterContext {
+    spec?: ChartSpec;
+    label: ValueLabel;
+    column: ColumnTitle;
+    /** What an axis is called when no column titles it: 「X 轴」, 「Y 轴」. */
+    fallback: {
+        x: string;
+        y: string;
+    };
+    animate: boolean;
+    pickable: boolean;
+    /** The surface's language, for an axis's pinned number format. */
+    locale?: string;
+}
+/**
+ * Up to this many points, each is named where it is drawn; past it, names
+ * would run into one another, and the tooltip names the one pointed at.
+ * A few points are a few named things — 「华东」 and 「华南」 — and a
+ * scatter that only says "a dot at (3, ¥1,200)" makes the reader hover each.
+ */
+export declare const NAMED_POINTS = 8;
+/**
+ * A scatter as the library draws it: two metrics per group, each axis
+ * titled as the table heads its column, its ticks read — shortly — as
+ * that column reads and whole where every value is, and a third metric,
+ * when there is one, as the points' size. The axes leave room past the
+ * extremes, so the point at the largest value is not cut in half by the
+ * plot's edge (the 2026-09-23 audit).
+ */
+export declare function scatterOption(data: ScatterData, context: ScatterContext, theme: ChartTheme): EChartsCoreOption;
+/**
+ * Whether a scatter's axis is stepped by powers of ten: the spec asks and
+ * every point's number on it is above zero (`logScaleFits`).
+ */
+export declare function scatterLogOn(data: ScatterData, spec: ChartSpec | undefined, which: 'x' | 'y'): boolean;
+/** The axes whose log scale the points refuse, drawn linear instead. */
+export declare function scatterLogRefused(data: ScatterData, spec: ChartSpec | undefined): ('x' | 'y')[];
+//# sourceMappingURL=scatterOption.d.ts.map

package/dist/ui/charts/scatterOption.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"scatterOption.d.ts","sourceRoot":"","sources":["../../../src/ui/charts/scatterOption.ts"],"names":[],"mappings":"AAaA,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,cAAc,CAAC;AACtD,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,yBAAyB,CAAC;AAC3D,OAAO,KAAK,EAAY,SAAS,EAAE,MAAM,sBAAsB,CAAC;AAGhE,OAAO,KAAK,EAAE,WAAW,EAAE,UAAU,EAAE,MAAM,aAAa,CAAC;AAE3D,OAAO,EAAc,KAAK,UAAU,EAAa,MAAM,YAAY,CAAC;AAGpE,+CAA+C;AAC/C,MAAM,WAAW,cAAc;IAC7B,IAAI,CAAC,EAAE,SAAS,CAAC;IACjB,KAAK,EAAE,UAAU,CAAC;IAClB,MAAM,EAAE,WAAW,CAAC;IACpB,qEAAqE;IACrE,QAAQ,EAAE;QAAE,CAAC,EAAE,MAAM,CAAC;QAAC,CAAC,EAAE,MAAM,CAAA;KAAE,CAAC;IACnC,OAAO,EAAE,OAAO,CAAC;IACjB,QAAQ,EAAE,OAAO,CAAC;IAClB,kEAAkE;IAClE,MAAM,CAAC,EAAE,MAAM,CAAC;CACjB;AAED;;;;;GAKG;AACH,eAAO,MAAM,YAAY,IAAI,CAAC;AAiB9B;;;;;;;GAOG;AACH,wBAAgB,aAAa,CAC3B,IAAI,EAAE,WAAW,EACjB,OAAO,EAAE,cAAc,EACvB,KAAK,EAAE,UAAU,GAChB,iBAAiB,CA+KnB;AAUD;;;GAGG;AACH,wBAAgB,YAAY,CAC1B,IAAI,EAAE,WAAW,EACjB,IAAI,EAAE,SAAS,GAAG,SAAS,EAC3B,KAAK,EAAE,GAAG,GAAG,GAAG,GACf,OAAO,CAKT;AAED,wEAAwE;AACxE,wBAAgB,iBAAiB,CAC/B,IAAI,EAAE,WAAW,EACjB,IAAI,EAAE,SAAS,GAAG,SAAS,GAC1B,CAAC,GAAG,GAAG,GAAG,CAAC,EAAE,CAMf"}

package/dist/ui/charts/sentence.d.ts

@@ -0,0 +1,19 @@
+import { ChartData } from '../../analysis/index.js';
+import { ChartSpec } from '../../model/index.js';
+import { ReadingContext } from './reading.js';
+/**
+ * A chart in one sentence, said after its name (analysis-echarts.md 2.3):
+ * what a sighted reader takes in at a glance before reading any number —
+ * how many groups, which is highest and which lowest, and over a time axis
+ * where it starts, where it ends and which way it went. 「共 12 组，最高 华东
+ * ¥1.2万，最低 西南 ¥980」. The table beside it (`ChartReadingTable`) has
+ * every number; this is the reading a screen reader hears first.
+ *
+ * Built from `ChartData`, as the table is, so it says what is drawn: a
+ * filled-in 0 is no measured group and is not the lowest, and 「其他」 is
+ * named as the chart names it. A metric card says its number in words on
+ * its own face, and its sentence is its sparkline's; a chart of no number
+ * has none.
+ */
+export declare function chartSentence(data: ChartData, spec: ChartSpec | undefined, ctx: ReadingContext): string | undefined;
+//# sourceMappingURL=sentence.d.ts.map

package/dist/ui/charts/sentence.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"sentence.d.ts","sourceRoot":"","sources":["../../../src/ui/charts/sentence.ts"],"names":[],"mappings":"AAaA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,yBAAyB,CAAC;AACzD,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,sBAAsB,CAAC;AAItD,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,cAAc,CAAC;AAGnD;;;;;;;;;;;;;GAaG;AACH,wBAAgB,aAAa,CAC3B,IAAI,EAAE,SAAS,EACf,IAAI,EAAE,SAAS,GAAG,SAAS,EAC3B,GAAG,EAAE,cAAc,GAClB,MAAM,GAAG,SAAS,CAwMpB"}

package/dist/ui/charts/sentenceParts.d.ts

@@ -0,0 +1,36 @@
+import { ReadingContext } from './reading.js';
+/** One measured number of the chart, and what it is called. */
+export interface Named {
+    name: string;
+    value: number | null;
+    /** The column it prints as. */
+    alias?: string;
+}
+/** The highest and the lowest measured number; none without one. */
+export declare function highLow(items: readonly Named[]): {
+    high: Named & {
+        value: number;
+    };
+    low: Named & {
+        value: number;
+    };
+} | undefined;
+/** The two extremes as a sentence's parameters, each as its column prints. */
+export declare function said(ctx: ReadingContext, { high, low }: NonNullable<ReturnType<typeof highLow>>): {
+    high: string;
+    highValue: string;
+    low: string;
+    lowValue: string;
+};
+/**
+ * Which way a run of values went, read along all of them: the least-squares
+ * line through them, from where it starts to where it ends (`direction`).
+ * One outlying first or last period no longer decides it.
+ */
+export declare function fittedDirection(values: readonly number[]): 'up' | 'down' | 'flat';
+/**
+ * Which way a line went from its first point to its last: up or down past a
+ * twentieth of where it started, level otherwise.
+ */
+export declare function direction(from: number, to: number): 'up' | 'down' | 'flat';
+//# sourceMappingURL=sentenceParts.d.ts.map

package/dist/ui/charts/sentenceParts.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"sentenceParts.d.ts","sourceRoot":"","sources":["../../../src/ui/charts/sentenceParts.ts"],"names":[],"mappings":"AAaA,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,cAAc,CAAC;AAQnD,+DAA+D;AAC/D,MAAM,WAAW,KAAK;IACpB,IAAI,EAAE,MAAM,CAAC;IACb,KAAK,EAAE,MAAM,GAAG,IAAI,CAAC;IACrB,+BAA+B;IAC/B,KAAK,CAAC,EAAE,MAAM,CAAC;CAChB;AAED,oEAAoE;AACpE,wBAAgB,OAAO,CACrB,KAAK,EAAE,SAAS,KAAK,EAAE,GAErB;IAAE,IAAI,EAAE,KAAK,GAAG;QAAE,KAAK,EAAE,MAAM,CAAA;KAAE,CAAC;IAAC,GAAG,EAAE,KAAK,GAAG;QAAE,KAAK,EAAE,MAAM,CAAA;KAAE,CAAA;CAAE,GACnE,SAAS,CAUZ;AAED,8EAA8E;AAC9E,wBAAgB,IAAI,CAClB,GAAG,EAAE,cAAc,EACnB,EAAE,IAAI,EAAE,GAAG,EAAE,EAAE,WAAW,CAAC,UAAU,CAAC,OAAO,OAAO,CAAC,CAAC;;;;;EAQvD;AAED;;;;GAIG;AACH,wBAAgB,eAAe,CAC7B,MAAM,EAAE,SAAS,MAAM,EAAE,GACxB,IAAI,GAAG,MAAM,GAAG,MAAM,CAaxB;AAED;;;GAGG;AACH,wBAAgB,SAAS,CAAC,IAAI,EAAE,MAAM,EAAE,EAAE,EAAE,MAAM,GAAG,IAAI,GAAG,MAAM,GAAG,MAAM,CAK1E"}

package/dist/ui/charts/sizes.d.ts

@@ -0,0 +1,25 @@
+/**
+ * What a chart does with a new size of its plot: whatever must happen at
+ * once — the library created on the element — and, handed back, the drawing,
+ * which waits until every chart given a size in the same frame has done the
+ * first part.
+ */
+export type SizeHandler = (width: number, height: number) => (() => void) | undefined;
+/** A chart that threw being created or drawn, and what it threw. */
+export type SizeFailure = (error: unknown) => void;
+/**
+ * One `ResizeObserver` for every chart on the page, so the charts a frame
+ * sizes together — a board's panels, all of them once the library arrives —
+ * are all created before any is drawn.
+ *
+ * Creating a chart adds the library's pointer and wheel listeners, and
+ * drawing it reads the layout (its tooltip measures where the plot is).
+ * WebKit on Linux answers the first layout after a wheel or touch listener
+ * comes or goes by walking the whole page for the region those listeners
+ * cover, so a chart created and drawn before the next is created paid that
+ * walk once per chart: 24 charts on the theme gallery spent 5 s in one
+ * frame, ~200 ms each, and the walk grows with the page. Created first and
+ * drawn after, they pay it once.
+ */
+export declare function watchSize(element: Element, failed: SizeFailure | undefined, handler: SizeHandler): () => void;
+//# sourceMappingURL=sizes.d.ts.map

package/dist/ui/charts/sizes.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"sizes.d.ts","sourceRoot":"","sources":["../../../src/ui/charts/sizes.ts"],"names":[],"mappings":"AAaA;;;;;GAKG;AACH,MAAM,MAAM,WAAW,GAAG,CACxB,KAAK,EAAE,MAAM,EACb,MAAM,EAAE,MAAM,KACX,CAAC,MAAM,IAAI,CAAC,GAAG,SAAS,CAAC;AAE9B,oEAAoE;AACpE,MAAM,MAAM,WAAW,GAAG,CAAC,KAAK,EAAE,OAAO,KAAK,IAAI,CAAC;AAQnD;;;;;;;;;;;;;GAaG;AACH,wBAAgB,SAAS,CACvB,OAAO,EAAE,OAAO,EAChB,MAAM,EAAE,WAAW,GAAG,SAAS,EAC/B,OAAO,EAAE,WAAW,GACnB,MAAM,IAAI,CAsBZ"}