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

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

@@ -0,0 +1,14 @@
+import { CartesianPlan } from './cartesianPlan.js';
+import { ChartTheme } from './theme.js';
+/**
+ * A cartesian chart's tooltip: every series drawn at the category under the
+ * pointer, its number whole and in its column's format, a filled-in 0 said
+ * to be one, a 100% stack's share beside the value — and on a time axis how
+ * each number moved from the bucket before (「+12.3%」), with the footnote
+ * saying what it is measured against (D33 Q59: no second query, only the
+ * rows already drawn; `bucketChange` says where there is a change to tell).
+ * A derived line's number follows the series', named as computed (D33
+ * batch B).
+ */
+export declare function cartesianTooltip(plan: CartesianPlan, theme: ChartTheme): object;
+//# sourceMappingURL=cartesianTooltip.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"cartesianTooltip.d.ts","sourceRoot":"","sources":["../../../src/ui/charts/cartesianTooltip.ts"],"names":[],"mappings":"AAeA,OAAO,KAAK,EAAE,aAAa,EAAe,MAAM,oBAAoB,CAAC;AACrE,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,YAAY,CAAC;AAG7C;;;;;;;;;GASG;AACH,wBAAgB,gBAAgB,CAC9B,IAAI,EAAE,aAAa,EACnB,KAAK,EAAE,UAAU,GAChB,MAAM,CAoGR"}

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

@@ -0,0 +1,60 @@
+import { CartesianPlan } from './cartesianPlan.js';
+import { ChartTheme } from './theme.js';
+/**
+ * Past this many categories an upright cartesian chart can be zoomed: a
+ * slider under the plot, and — where the host allows gestures — a pinch or
+ * Ctrl + wheel over it. Two months of days fit a plot side by side; a year
+ * of them is a smear of 365 marks whose ticks name every fortnight, and the
+ * reader who wants last week had to narrow the range and run again. The
+ * same count past which a line stops dotting every point (`DOTS_UP_TO`).
+ */
+export declare const ZOOM_FROM = 60;
+/**
+ * Past this many points a bar or scatter series is drawn in the library's
+ * large mode — one path for all the marks rather than an element each —
+ * and writes no value labels, which could not be read there anyway.
+ * Measured on the SVG renderer (docs/design/analysis-echarts.md 2.4): a
+ * thousand bars an element each is where a redraw starts to be felt.
+ */
+export declare const LARGE_FROM = 1000;
+/** The room the slider takes under the plot: itself and a line of air. */
+export declare const SLIDER_ROOM: number;
+/**
+ * Which part of the categories is on screen, in percent of the whole — as
+ * the library reports a zoom. Transient: never saved with the view (Q51),
+ * and gone when the result changes.
+ */
+export interface ZoomWindow {
+    start: number;
+    end: number;
+}
+/** Whether a chart of this plan is zoomable: upright, and long enough. */
+export declare function zooms(plan: CartesianPlan): boolean;
+/**
+ * How many categories a window shows, of `count`: all of them without one.
+ */
+export declare function visibleCount(count: number, window?: ZoomWindow): number;
+/**
+ * The zoom a long category axis carries, or nothing for a short one.
+ *
+ * Always a slider under the plot: it is the one control that reads the same
+ * on a phone, in a dashboard panel and in a workbench, and it pans as well
+ * as narrows. With `gestures` also the library's `inside` zoom, narrowed to
+ * what does not take the page's own gestures away:
+ *
+ * - **the wheel only with Ctrl held** (a trackpad's pinch arrives as one):
+ *   a plain wheel over a chart scrolls the page, as it does over any
+ *   picture. `EChart` keeps a plain wheel from reaching the library at all,
+ *   because its roam handler swallows every wheel over the grid before
+ *   asking whether the zoom wanted it;
+ * - **no drag to pan**, and nothing held back on a drag: a finger that lands
+ *   on the chart still scrolls the page on a phone — the slider pans;
+ * - **a two-finger pinch** on a touch screen, which the page does not scroll
+ *   by.
+ *
+ * A dashboard and a read-only embedding pass no gestures: a board is read
+ * by scrolling past many charts, and a page hosting an embedded one is the
+ * host's to scroll (docs/design/analysis-echarts.md 2.2).
+ */
+export declare function zoomOption(plan: CartesianPlan, theme: ChartTheme, gestures: boolean): object[] | undefined;
+//# sourceMappingURL=cartesianZoom.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"cartesianZoom.d.ts","sourceRoot":"","sources":["../../../src/ui/charts/cartesianZoom.ts"],"names":[],"mappings":"AAaA,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,oBAAoB,CAAC;AACxD,OAAO,EAAY,KAAK,UAAU,EAAE,MAAM,YAAY,CAAC;AAEvD;;;;;;;GAOG;AACH,eAAO,MAAM,SAAS,KAAK,CAAC;AAS5B;;;;;;GAMG;AACH,eAAO,MAAM,UAAU,OAAO,CAAC;AAK/B,0EAA0E;AAC1E,eAAO,MAAM,WAAW,QAAqB,CAAC;AAE9C;;;;GAIG;AACH,MAAM,WAAW,UAAU;IACzB,KAAK,EAAE,MAAM,CAAC;IACd,GAAG,EAAE,MAAM,CAAC;CACb;AAED,0EAA0E;AAC1E,wBAAgB,KAAK,CAAC,IAAI,EAAE,aAAa,GAAG,OAAO,CAElD;AAED;;GAEG;AACH,wBAAgB,YAAY,CAAC,KAAK,EAAE,MAAM,EAAE,MAAM,CAAC,EAAE,UAAU,GAAG,MAAM,CAIvE;AAED;;;;;;;;;;;;;;;;;;;;;GAqBG;AACH,wBAAgB,UAAU,CACxB,IAAI,EAAE,aAAa,EACnB,KAAK,EAAE,UAAU,EACjB,QAAQ,EAAE,OAAO,GAChB,MAAM,EAAE,GAAG,SAAS,CAmDtB"}

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

@@ -0,0 +1,106 @@
+import { ChartTheme } from './theme.js';
+/** What a chart of one mark per category tells the frame around it. */
+export interface CategoryFrameInput {
+    theme: ChartTheme;
+    animate: boolean;
+    /** The names along the bottom, one a mark, in the order drawn. */
+    categories: readonly string[];
+    /** The category axis's title, as its column is titled. */
+    categoryTitle: string | undefined;
+    /** The value axis's title, as its column is titled. */
+    valueTitle: string | undefined;
+    /** A value axis tick, written short. */
+    valueTick: (value: number) => string;
+    /**
+     * Whether the value axis is read against itself rather than from 0 — a
+     * spread, a price — and then keeps no line or ticks of its own. A
+     * waterfall's axis stands on 0, where its total does.
+     */
+    scaled: boolean;
+    /** The room under the plot; a waterfall's writes a fall's value there. */
+    bottom?: number;
+}
+/**
+ * The frame of a chart that draws one mark per category against a value
+ * axis — a box, a candle, a waterfall's step: the grid, the category axis
+ * along the bottom with its names cut for it, the value axis at the left
+ * titled at its head (`sideTitle`), and the tooltip's frame, one mark at a
+ * time. The three built it apiece, key for key (2026-09-27 quality
+ * review); the marks, the tooltip's words and the series are each one's own.
+ */
+export declare function categoryFrame({ theme, animate, categories, categoryTitle, valueTitle, valueTick, scaled, bottom, }: CategoryFrameInput): {
+    animation: boolean;
+    animationDuration: number;
+    textStyle: {
+        fontFamily: string;
+        fontSize: number;
+    };
+    grid: {
+        left: number;
+        right: number;
+        top: number;
+        bottom: number;
+        outerBoundsMode: string;
+        outerBoundsContain: string;
+    };
+    xAxis: {
+        type: string;
+        data: string[];
+        name: string | undefined;
+        nameLocation: string;
+        nameGap: number;
+        nameMoveOverlap: boolean;
+        nameTextStyle: {
+            color: string;
+            fontWeight: number;
+        };
+        axisTick: {
+            show: boolean;
+        };
+        axisLine: {
+            lineStyle: {
+                color: string;
+                width: number;
+            };
+        };
+        axisLabel: {
+            color: string;
+            hideOverlap: boolean;
+            formatter: (name: string) => string;
+        };
+    };
+    yAxis: {
+        axisLabel: {
+            color: string;
+            hideOverlap: boolean;
+            formatter: (value: number) => string;
+        };
+        splitLine: {
+            lineStyle: {
+                color: string;
+                width: number;
+            };
+        };
+        axisLine?: {
+            show: boolean;
+        } | undefined;
+        axisTick?: {
+            show: boolean;
+        } | undefined;
+        scale?: boolean | undefined;
+        type: string;
+    };
+    tooltip: {
+        trigger: string;
+        confine: boolean;
+        backgroundColor: string;
+        borderWidth: number;
+        padding: number;
+        extraCssText: string;
+        textStyle: {
+            fontFamily: string;
+            fontSize: number;
+        };
+    };
+};
+//# sourceMappingURL=categoryFrame.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"categoryFrame.d.ts","sourceRoot":"","sources":["../../../src/ui/charts/categoryFrame.ts"],"names":[],"mappings":"AAcA,OAAO,EAAa,KAAK,UAAU,EAAE,MAAM,YAAY,CAAC;AAGxD,uEAAuE;AACvE,MAAM,WAAW,kBAAkB;IACjC,KAAK,EAAE,UAAU,CAAC;IAClB,OAAO,EAAE,OAAO,CAAC;IACjB,kEAAkE;IAClE,UAAU,EAAE,SAAS,MAAM,EAAE,CAAC;IAC9B,0DAA0D;IAC1D,aAAa,EAAE,MAAM,GAAG,SAAS,CAAC;IAClC,uDAAuD;IACvD,UAAU,EAAE,MAAM,GAAG,SAAS,CAAC;IAC/B,wCAAwC;IACxC,SAAS,EAAE,CAAC,KAAK,EAAE,MAAM,KAAK,MAAM,CAAC;IACrC;;;;OAIG;IACH,MAAM,EAAE,OAAO,CAAC;IAChB,0EAA0E;IAC1E,MAAM,CAAC,EAAE,MAAM,CAAC;CACjB;AAED;;;;;;;GAOG;AACH,wBAAgB,aAAa,CAAC,EAC5B,KAAK,EACL,OAAO,EACP,UAAU,EACV,aAAa,EACb,UAAU,EACV,SAAS,EACT,MAAM,EACN,MAAU,GACX,EAAE,kBAAkB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;8BA2BK,MAAM;;;;;;;+BAvDX,MAAM,KAAK,MAAM;;;;;;;;;;;;;;;;;;;;;;;;;;;;;EA6ErC"}

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

@@ -0,0 +1,36 @@
+import { AnalysisColumnView } from '../../analysis/index.js';
+import { AnalysisDateUnit } from '../../model/index.js';
+import { DisplayContext } from '../kit/display.js';
+/**
+ * The ticks of a time axis, written short: 「9月1日」 and `Sep 1` rather than
+ * 「2026年9月1日」 under every bar.
+ *
+ * A date bucket reads whole in a table cell, a tooltip and the reading
+ * table (`displayValue`), where it stands alone. On an axis it stands in a
+ * row of its neighbours, which already say the year: the year on each of
+ * thirty ticks is thirty times the same word, and it is what slanted the
+ * names 45° and ate 70–90px under the plot (2026-09-23 audit P1-1). So, as
+ * Metabase writes a time axis, the unit's own part is written — the day, the
+ * month, the quarter, the time of day — and what it sits in only where it
+ * changes: the year on the first tick and where a new year begins; for
+ * hours and minutes, the day as well.
+ *
+ * Read in the same zone and language `displayValue` reads the bucket in —
+ * the zone the group cut it in, else the surface's; a wall-clock key at
+ * UTC, which prints it as written — so the short tick and the whole date in
+ * the tooltip name the same day.
+ */
+export type DateTicks = (alias: string | undefined, values: readonly unknown[]) => (string | undefined)[] | undefined;
+/**
+ * The short ticks of the axis an alias is drawn along, or `undefined` when
+ * its column is not a date bucket; within them, `undefined` where a key is
+ * no time, which the axis then writes as its column reads it.
+ */
+export declare function useDateTicks(columns: readonly AnalysisColumnView[] | undefined): DateTicks;
+/**
+ * Each bucket key as its tick, the larger part written only where it
+ * changes from the tick before (the first tick has none before it). A year
+ * is already one word, so a year axis is left as its column reads it.
+ */
+export declare function shortDateTicks(values: readonly unknown[], unit: AnalysisDateUnit, { locale, timeZone }: DisplayContext): (string | undefined)[] | undefined;
+//# sourceMappingURL=dateTicks.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"dateTicks.d.ts","sourceRoot":"","sources":["../../../src/ui/charts/dateTicks.ts"],"names":[],"mappings":"AAcA,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,yBAAyB,CAAC;AAElE,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,sBAAsB,CAAC;AAC7D,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,mBAAmB,CAAC;AAGxD;;;;;;;;;;;;;;;;;;GAkBG;AACH,MAAM,MAAM,SAAS,GAAG,CACtB,KAAK,EAAE,MAAM,GAAG,SAAS,EACzB,MAAM,EAAE,SAAS,OAAO,EAAE,KACvB,CAAC,MAAM,GAAG,SAAS,CAAC,EAAE,GAAG,SAAS,CAAC;AAExC;;;;GAIG;AACH,wBAAgB,YAAY,CAC1B,OAAO,EAAE,SAAS,kBAAkB,EAAE,GAAG,SAAS,GACjD,SAAS,CAgBX;AAED;;;;GAIG;AACH,wBAAgB,cAAc,CAC5B,MAAM,EAAE,SAAS,OAAO,EAAE,EAC1B,IAAI,EAAE,gBAAgB,EACtB,EAAE,MAAM,EAAE,QAAQ,EAAE,EAAE,cAAc,GACnC,CAAC,MAAM,GAAG,SAAS,CAAC,EAAE,GAAG,SAAS,CAgBpC"}

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

@@ -0,0 +1,16 @@
+import { init as initChart } from 'echarts/core';
+/**
+ * The library's `init`, with every piece this package draws with registered
+ * before the first chart is made.
+ *
+ * The registration lives inside the one export the package calls rather than
+ * at the top of the module: the package declares no side effects but its
+ * stylesheet (`package.json` `sideEffects`), so a production build keeps this
+ * module's exports and drops a top-level call whose result nobody reads — the
+ * built chunk carried `init` and no painter, and the first chart threw
+ * 「lg[a] is not a constructor」 on the deployed Storybook (2026-09-23).
+ * `scripts/verify-package.mjs` draws a chart through the built chunk so the
+ * package cannot ship like that again.
+ */
+export declare function init(...args: Parameters<typeof initChart>): ReturnType<typeof initChart>;
+//# sourceMappingURL=echarts.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"echarts.d.ts","sourceRoot":"","sources":["../../../src/ui/charts/echarts.ts"],"names":[],"mappings":"AA2DA,OAAO,EAEL,IAAI,IAAI,SAAS,EAGlB,MAAM,cAAc,CAAC;AAOtB;;;;;;;;;;;;GAYG;AACH,wBAAgB,IAAI,CAClB,GAAG,IAAI,EAAE,UAAU,CAAC,OAAO,SAAS,CAAC,GACpC,UAAU,CAAC,OAAO,SAAS,CAAC,CA8B9B"}

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

@@ -0,0 +1,5 @@
+import { ChartMapGeoJson } from './maps.js';
+export declare function register(): void;
+/** A host's geography, under the name a chart spec draws it by. */
+export declare function registerGeoMap(name: string, geo: ChartMapGeoJson): void;
+//# sourceMappingURL=echartsGeo.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"echartsGeo.d.ts","sourceRoot":"","sources":["../../../src/ui/charts/echartsGeo.ts"],"names":[],"mappings":"AAuBA,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,WAAW,CAAC;AAEjD,wBAAgB,QAAQ,IAAI,IAAI,CAE/B;AAED,mEAAmE;AACnE,wBAAgB,cAAc,CAAC,IAAI,EAAE,MAAM,EAAE,GAAG,EAAE,eAAe,GAAG,IAAI,CAEvE"}

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

@@ -0,0 +1,2 @@
+export declare function register(): void;
+//# sourceMappingURL=echartsHierarchy.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"echartsHierarchy.d.ts","sourceRoot":"","sources":["../../../src/ui/charts/echartsHierarchy.ts"],"names":[],"mappings":"AAsBA,wBAAgB,QAAQ,IAAI,IAAI,CAE/B"}

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

@@ -0,0 +1,2 @@
+export declare function register(): void;
+//# sourceMappingURL=echartsStatistics.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"echartsStatistics.d.ts","sourceRoot":"","sources":["../../../src/ui/charts/echartsStatistics.ts"],"names":[],"mappings":"AAgCA,wBAAgB,QAAQ,IAAI,IAAI,CAW/B"}

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

@@ -0,0 +1,2 @@
+export declare function register(): void;
+//# sourceMappingURL=echartsTime.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"echartsTime.d.ts","sourceRoot":"","sources":["../../../src/ui/charts/echartsTime.ts"],"names":[],"mappings":"AAyBA,wBAAgB,QAAQ,IAAI,IAAI,CAE/B"}

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

@@ -0,0 +1,176 @@
+import { AnalysisColumnView } from '../../analysis/index.js';
+import { ChartSpec, FieldTone, FunnelStages, NumberFormat, RecordData } from '../../model/index.js';
+import { PickAnchor } from '../kit/anchor.js';
+import { MessageFormatters } from '../kit/MessagesProvider.js';
+import { DateTicks } from './dateTicks.js';
+/**
+ * A value as its column shows it, by the alias the chart read it from.
+ *
+ * It labels both halves of a chart: a category on an axis or in a legend, and
+ * a measured number on a tick, in a tooltip or on a bar. They go through one
+ * function on purpose — a table showing ¥1,234.00 beside a tooltip showing
+ * 1234 is two readings of one number, and only one of them is the column's.
+ */
+export type ValueLabel = (alias: string | undefined, value: unknown, 
+/**
+ * Written short, where room is scarce: a tick, a label over a bar. Only a
+ * number is shortened, and still in its column's format — 「¥1,110万」 in
+ * Chinese and `CN¥11.1M` in English (`compactFormat`); a tooltip, the
+ * reading table and the table layout keep the whole number. A `tick` is
+ * short too, with the digits it takes to be itself (`formatTick`).
+ */
+compact?: boolean | 'tick') => string;
+/** What `AnalysisChart` hands whichever family the data asked for. */
+/**
+ * Told which group of the result a mark stands for when it is pressed, and
+ * where — the mark's element, or the point pressed — so the follow-up menu
+ * opens against it. Left out, marks are not pressable.
+ */
+export type OnPick = (row: RecordData, anchor: PickAnchor, 
+/**
+ * Where the keyboard goes back to when the menu closes: the table row that
+ * was pressed. A mark is not focusable and leaves nothing to return to,
+ * and the anchor is no longer that row — it is the cell or the point the
+ * menu hangs from — so the two are said apart.
+ */
+origin?: HTMLElement, 
+/**
+ * The press is a span, not one group (D33 Q52): every bucket of a time
+ * axis from `row`'s through this one's — a brush along the axis, or a
+ * second row of the table picked with Shift. The follow-up menu reads the
+ * two as one range (`AnalysisResultController.followUp`).
+ */
+through?: RecordData) => void;
+export interface FamilyProps<D> {
+    data: D;
+    spec?: ChartSpec;
+    className?: string;
+    onPick?: OnPick;
+    label: ValueLabel;
+    /**
+     * A change in a column's own terms, signed (`useChangeAmount`); left
+     * out, the value as its column reads it, with its sign.
+     */
+    change?: ChangeAmount;
+    /** An alias as its column is titled; `undefined` when no column holds it. */
+    column: ColumnTitle;
+    /**
+     * The short ticks of a time axis (`useDateTicks`): an axis of dates
+     * writes 「9月1日」 with the year only where it changes. Left out, every
+     * tick reads as its column does.
+     */
+    dateTicks?: DateTicks;
+    /**
+     * What is drawn, in one line: the name of the `role="img"` every family's
+     * drawing is (`EChart`'s `chart-plot`). The metric card is the exception:
+     * its value is already text, so only its sparkline is a picture.
+     */
+    name: string;
+    /**
+     * Whether a column's numbers add up across groups — a count, a sum — so a
+     * whole written over them (a donut's centre) is a number at all: the
+     * total of some averages is not an average of anything.
+     */
+    adds?: (alias: string | undefined) => boolean;
+    /**
+     * The rows are the first groups of more (`AnalysisProjection.truncated` or
+     * `atLimit`): a family that draws shares of a whole says they are shares
+     * of the groups shown.
+     */
+    cutShort?: boolean;
+    /**
+     * The group a press set the board's filter to (D22 I): a family that can
+     * say which of its marks stands for a group draws the others faint
+     * (`faded`); left out, every mark as it is.
+     */
+    highlight?: (row: RecordData) => boolean;
+    /** A filled-in value as the tooltip says it (`useFilledNote`). */
+    filled?: FilledNote;
+    /**
+     * What a series or a slice standing for one group value is called
+     * (`useSeriesName`); left out, the value as its column reads it.
+     */
+    seriesName?: SeriesName;
+    /**
+     * The tone the definition gave a group value (`FieldOption.tone`,
+     * `useToneOf`): a family that colours by category paints a toned one in
+     * its role colour, as its badge is (`toneColor`).
+     */
+    toneOf?: ToneOf;
+    /**
+     * The series the reader switched off in the legend, by key — a family
+     * with a legend of series draws them nowhere else (`CartesianContext`).
+     */
+    hidden?: ReadonlySet<string>;
+    /** Switches a series off or back on; left out, the legend is text. */
+    onToggleSeries?: (key: string) => void;
+    /**
+     * Whether a long axis zooms by gesture as well as by its slider: a
+     * workbench's chart, not a dashboard panel's (`zoomOption`).
+     */
+    zoomGestures?: boolean;
+}
+export declare function useValueLabel(columns: readonly AnalysisColumnView[] | undefined): ValueLabel;
+/**
+ * What a series or a slice is called when it stands for one value of a
+ * dimension, where no header names the dimension beside it: the legend, the
+ * tooltip's row, the reading table's column. A value that names itself —
+ * 「华东」, 「2026年9月」 — reads as its column shows it (`label`); a yes or
+ * a no says nothing of *what* until its field is said with it, so a split
+ * by a yes/no field reads 「新客：是」 and 「新客：否」, not 「是」「否」.
+ */
+export type SeriesName = (alias: string | undefined, value: unknown) => string;
+export declare function useSeriesName(columns: readonly AnalysisColumnView[] | undefined, label: ValueLabel): SeriesName;
+/**
+ * A value the chart filled in rather than measured, as the tooltip and the
+ * reading table say it: 「0（这一天没有记录）」 on a day axis, the unit's own
+ * words on another — 这一周, 这个月 — and 「0（这一组没有记录）」 for a split
+ * combination along categories (decisions.md D23, Q14). `alias` is the axis
+ * the filled point stands on; `value` the number already written.
+ */
+export type FilledNote = (alias: string | undefined, value: string) => string;
+export declare function useFilledNote(columns: readonly AnalysisColumnView[] | undefined): FilledNote;
+/**
+ * A difference of two values of a column, signed, in the column's own terms
+ * — 「+¥1,230.00」, 「-12」 — but a percentage's in points: 发货及时率 from
+ * 80.0% to 65.6% fell 「-14.4 个百分点」, which beside the relative change
+ * 「-18.0%」 reads as a second measure, where 「-14.4%」 read as another
+ * version of the same number (R2-22).
+ */
+export type ChangeAmount = (alias: string | undefined, delta: number) => string;
+export declare function useChangeAmount(columns: readonly AnalysisColumnView[] | undefined, label: ValueLabel): ChangeAmount;
+/** A difference of two percentages, in points, signed. */
+export declare function pointsText(delta: number, format: NumberFormat | undefined, locale: string | undefined, messages: MessageFormatters): string;
+/** Whether a column's numbers add up across groups: a count or a sum. */
+export declare function useAdds(columns: readonly AnalysisColumnView[] | undefined): (alias: string | undefined) => boolean;
+/**
+ * An alias as its column is titled — 「金额的总和」 for a metric, the field
+ * for a group — and `undefined` when this result has no such column: a name
+ * that says "订单数 按 地区" is worth having, one that says "m0 按 g0" is not,
+ * so the caller decides what to do without a title rather than being handed
+ * the alias.
+ */
+export type ColumnTitle = (alias: string | undefined) => string | undefined;
+export declare function useColumnTitle(columns: readonly AnalysisColumnView[] | undefined): ColumnTitle;
+/**
+ * What one funnel stage is called, wherever the funnel is read — the drawing
+ * and the table under it say the same words.
+ *
+ * A stage taken from a dimension is one of that dimension's values and reads
+ * as its column shows it. A stage that is a metric wears the name the
+ * analyst gave it (`items[i].label`, typed on the options' data page); with
+ * none given the projection falls back to the metric's alias — which names
+ * the query and nothing a reader recognises — so the column's title stands
+ * in, exactly as every slot on the panel is named by its column.
+ */
+export declare function stageName(stages: FunnelStages | undefined, index: number, 
+/** The stage as the projection labelled it. */
+projected: string, label: ValueLabel, column: ColumnTitle): string;
+/** The tone a column's option gives a value; `undefined` when none does. */
+export type ToneOf = (alias: string | undefined, value: unknown) => FieldTone | undefined;
+/**
+ * The tones of the group columns' options, read as the badge reads them: the
+ * option whose value is the group's (`FieldOption.tone`).
+ */
+export declare function useToneOf(columns: readonly AnalysisColumnView[] | undefined): ToneOf;
+//# sourceMappingURL=family.d.ts.map

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

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

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

@@ -0,0 +1,18 @@
+import { CSSProperties } from 'react';
+import { MessageFormatters } from '../kit/MessagesProvider.js';
+import { LegendPlace } from './EChart.js';
+/**
+ * The chart frame's classes: the plot and its legend side by side or
+ * stacked, a hugged plot centred, a plot of a set height no longer stretched
+ * to the frame's ratio, and the states of the tooltip the library draws.
+ */
+export declare function frameClass(placed: LegendPlace | undefined, hugged: boolean, setHeight: boolean, className: string | undefined): string;
+/**
+ * What a pressable chart's tooltip adds under its rows, as strings the
+ * stylesheet writes after the tooltip's own content, so no family's tooltip
+ * has to know of them: a first tap's 「再点一下追问」 (`data-tap-armed`), and
+ * a pointer's 「点击追问」 where a press follows up (`data-press-hint`,
+ * R2-40) — with 「拖动框选一段」 where a drag brushes the axis.
+ */
+export declare function hintStyle(messages: Pick<MessageFormatters, 'label'>, pressable: boolean, pressHint: boolean, brushes: boolean): CSSProperties | undefined;
+//# sourceMappingURL=frameClass.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"frameClass.d.ts","sourceRoot":"","sources":["../../../src/ui/charts/frameClass.ts"],"names":[],"mappings":"AAaA,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,OAAO,CAAC;AAE3C,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,4BAA4B,CAAC;AACpE,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,aAAa,CAAC;AAE/C;;;;GAIG;AACH,wBAAgB,UAAU,CACxB,MAAM,EAAE,WAAW,GAAG,SAAS,EAC/B,MAAM,EAAE,OAAO,EACf,SAAS,EAAE,OAAO,EAClB,SAAS,EAAE,MAAM,GAAG,SAAS,UAiB9B;AAED;;;;;;GAMG;AACH,wBAAgB,SAAS,CACvB,QAAQ,EAAE,IAAI,CAAC,iBAAiB,EAAE,OAAO,CAAC,EAC1C,SAAS,EAAE,OAAO,EAClB,SAAS,EAAE,OAAO,EAClB,OAAO,EAAE,OAAO,GACf,aAAa,GAAG,SAAS,CAY3B"}

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

@@ -0,0 +1,67 @@
+import { EChartsCoreOption } from 'echarts/core';
+import { FunnelData } from '../../analysis/index.js';
+import { DrawnStage, FunnelContext, FunnelWords } from './funnelOption.js';
+import { ChartTheme } from './theme.js';
+type Text = ChartTheme['text'];
+/**
+ * The most stages a standing funnel's plot is as tall as: some 560px at the
+ * page's text. More stages share that height.
+ */
+export declare const TALLEST_STAGES = 10;
+/** How long a standing stage is drawn at most, for the chart's text size. */
+export declare function stageLength(size: number): number;
+/**
+ * How tall a funnel's plot is: its stages at their longest, in `rem` so it
+ * follows the host's root size as the text does. The plot is sized by what
+ * it draws rather than by its width's aspect: five stages drew 761px tall
+ * at 16:9, each 121px, with the words far off to one side (2026-09-25). A
+ * funnel lying down has one band of stages and two rows of words under it.
+ */
+export declare function funnelPlotHeight(stages: number, horizontal: boolean): string;
+/** Where a funnel's parts land in a plot of one size. */
+export interface FunnelLayout {
+    /** The series' box, the unseen foot's room included. */
+    box: {
+        left: number;
+        top: number;
+        width: number;
+        height: number;
+    };
+    /** Each stage: its extent along the funnel, its widths, its words. */
+    stages: readonly {
+        start: number;
+        end: number;
+        /** Its width across at its start and at its end. */
+        from: number;
+        to: number;
+        words: 'inside' | 'outside';
+    }[];
+    /** The words' graphic elements, by the ids `funnelOption` made them with. */
+    elements: Record<string, unknown>[];
+}
+/**
+ * The funnel fitted to its plot, as the chart's `adapt`: each stage as long
+ * as the plot allows and never longer than `stageLength` — the stages
+ * centred in what is left, so a board's tall panel does not stretch five
+ * stages to a hand's width each — and the funnel as wide as the plot leaves
+ * beside its column of words, never wider than `FUNNEL_LINES` of text.
+ * A stage's words go inside it, on two lines or one, when they fit the
+ * narrower of its two edges; otherwise beside the funnel with a leader, the
+ * name cut with an ellipsis before any number is (the stage's tooltip says
+ * it whole). The drops stand in that column level with their seams.
+ *
+ * Lying down, the stages share the width, their words go inside or in a
+ * row under them, and the drops in a second row under their seams.
+ */
+export declare function funnelFit(data: FunnelData, context: Pick<FunnelContext, 'spec' | 'label' | 'column' | 'locale' | 'words'>): (width: number, height: number, window: unknown, text: Text) => EChartsCoreOption | undefined;
+/**
+ * `name` cut with an ellipsis until it and `rest` fit `room`: the numbers
+ * are never cut, the name gives way.
+ */
+export declare function fitName(name: string, rest: string, room: number, text: Text): string;
+/** A funnel standing up: the stages top to bottom, the words to the right. */
+export declare function standing(stages: readonly DrawnStage[], width: number, height: number, text: Text, words: FunnelWords): FunnelLayout;
+/** A funnel lying down: stages left to right, the words under them. */
+export declare function lyingDown(stages: readonly DrawnStage[], width: number, height: number, text: Text, words: FunnelWords): FunnelLayout;
+export {};
+//# sourceMappingURL=funnelFit.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"funnelFit.d.ts","sourceRoot":"","sources":["../../../src/ui/charts/funnelFit.ts"],"names":[],"mappings":"AAaA,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,cAAc,CAAC;AACtD,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,yBAAyB,CAAC;AAC1D,OAAO,EAKL,KAAK,UAAU,EACf,KAAK,aAAa,EAClB,KAAK,WAAW,EACjB,MAAM,mBAAmB,CAAC;AAE3B,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,YAAY,CAAC;AAE7C,KAAK,IAAI,GAAG,UAAU,CAAC,MAAM,CAAC,CAAC;AAI/B;;;GAGG;AACH,eAAO,MAAM,cAAc,KAAK,CAAC;AAgBjC,6EAA6E;AAC7E,wBAAgB,WAAW,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,CAEhD;AAED;;;;;;GAMG;AACH,wBAAgB,gBAAgB,CAAC,MAAM,EAAE,MAAM,EAAE,UAAU,EAAE,OAAO,GAAG,MAAM,CAY5E;AAED,yDAAyD;AACzD,MAAM,WAAW,YAAY;IAC3B,wDAAwD;IACxD,GAAG,EAAE;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,GAAG,EAAE,MAAM,CAAC;QAAC,KAAK,EAAE,MAAM,CAAC;QAAC,MAAM,EAAE,MAAM,CAAA;KAAE,CAAC;IAClE,sEAAsE;IACtE,MAAM,EAAE,SAAS;QACf,KAAK,EAAE,MAAM,CAAC;QACd,GAAG,EAAE,MAAM,CAAC;QACZ,oDAAoD;QACpD,IAAI,EAAE,MAAM,CAAC;QACb,EAAE,EAAE,MAAM,CAAC;QACX,KAAK,EAAE,QAAQ,GAAG,SAAS,CAAC;KAC7B,EAAE,CAAC;IACJ,6EAA6E;IAC7E,QAAQ,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAAE,CAAC;CACrC;AAED;;;;;;;;;;;;;GAaG;AACH,wBAAgB,SAAS,CACvB,IAAI,EAAE,UAAU,EAChB,OAAO,EAAE,IAAI,CACX,aAAa,EACb,MAAM,GAAG,OAAO,GAAG,QAAQ,GAAG,QAAQ,GAAG,OAAO,CACjD,GACA,CACD,KAAK,EAAE,MAAM,EACb,MAAM,EAAE,MAAM,EACd,MAAM,EAAE,OAAO,EACf,IAAI,EAAE,IAAI,KACP,iBAAiB,GAAG,SAAS,CAiBjC;AAKD;;;GAGG;AACH,wBAAgB,OAAO,CACrB,IAAI,EAAE,MAAM,EACZ,IAAI,EAAE,MAAM,EACZ,IAAI,EAAE,MAAM,EACZ,IAAI,EAAE,IAAI,GACT,MAAM,CAUR;AA4CD,8EAA8E;AAC9E,wBAAgB,QAAQ,CACtB,MAAM,EAAE,SAAS,UAAU,EAAE,EAC7B,KAAK,EAAE,MAAM,EACb,MAAM,EAAE,MAAM,EACd,IAAI,EAAE,IAAI,EACV,KAAK,EAAE,WAAW,GACjB,YAAY,CA6Jd;AAED,uEAAuE;AACvE,wBAAgB,SAAS,CACvB,MAAM,EAAE,SAAS,UAAU,EAAE,EAC7B,KAAK,EAAE,MAAM,EACb,MAAM,EAAE,MAAM,EACd,IAAI,EAAE,IAAI,EACV,KAAK,EAAE,WAAW,GACjB,YAAY,CA0Id"}