@squadbase/vantage 0.7.0 → 0.7.1-dev1.0d13f9a

package/dist/components/index.d.ts

@@ -4,8 +4,8 @@ import { HTMLAttributes, ReactNode, ComponentType, ElementType, Ref, ReactElemen
 import { VariantProps } from 'class-variance-authority';
 import { EChartsOption } from 'echarts';
 export { EChartsOption } from 'echarts';
-import { V as ValueFormat, a as DateStyle } from '../format-DihQkL1N.js';
-export { D as DEFAULT_LOCALE, E as EMPTY_VALUE, F as FormatDateOptions, b as FormatKind, c as FormatValueOptions, M as MINUS_SIGN, f as formatDate, d as formatDateRange, e as formatDatesInText, g as formatDelta, h as formatKind, i as formatPoints, j as formatValue, t as toValueFormatter } from '../format-DihQkL1N.js';
+import { V as ValueFormat, a as DateStyle } from '../format-D34piCei.js';
+export { D as DEFAULT_LOCALE, E as EMPTY_VALUE, F as FormatDateOptions, b as FormatKind, c as FormatValueOptions, M as MINUS_SIGN, f as formatDate, d as formatDateRange, e as formatDatesInText, g as formatDelta, h as formatKind, i as formatPoints, j as formatValue, t as toValueFormatter } from '../format-D34piCei.js';
 import { RowData, ColumnDef, SortingState, OnChangeFn, ColumnFiltersState, PaginationState, RowSelectionState, VisibilityState, TableMeta, Table } from '@tanstack/react-table';
 export { ColumnDef, ColumnFiltersState, PaginationState, RowSelectionState, SortingState, VisibilityState } from '@tanstack/react-table';
 export { DateRange as RdpDateRange } from 'react-day-picker';
@@ -25,7 +25,11 @@ interface UpdatedAtProps {
 }
 declare const UpdatedAt: React.ForwardRefExoticComponent<UpdatedAtProps & React.RefAttributes<HTMLTimeElement>>;
 
-interface PageShellProps extends HTMLAttributes<HTMLDivElement> {
+interface PageShellProps extends Omit<HTMLAttributes<HTMLDivElement>, "title"> {
+    /** The page heading. When given, the header (title and `description`) and the content area are drawn for you; `children` go in the content area. */
+    title?: string;
+    /** One line under the title. Used only with `title`. */
+    description?: string;
 }
 declare const PageShell: React.ForwardRefExoticComponent<PageShellProps & React.RefAttributes<HTMLDivElement>>;
 interface PageShellHeaderProps extends HTMLAttributes<HTMLDivElement> {
@@ -46,6 +50,8 @@ interface PageShellHeaderProps extends HTMLAttributes<HTMLDivElement> {
     status?: ReactNode;
 }
 /**
+ * PageShellHeader — the page header band (title and update time, source / period, overall status); inside `PageShell` without `title`, with the title in `PageShellHeading`.
+ *
  * A wrapping flex row, not a two-column grid: when the heading cannot keep its
  * 20rem basis next to `PageShellHeaderEnd`, the end block drops below it. A
  * `1fr auto` grid would instead hand the heading whatever the end block leaves,
@@ -449,13 +455,16 @@ declare function DashboardCardSkeleton({ className }: DashboardCardSkeletonProps
 interface DashboardCardPresetProps extends Omit<HTMLAttributes<HTMLDivElement>, "title">, Pick<DashboardCardProps, "subgrid" | "size"> {
     title?: ReactNode;
     description?: ReactNode;
+    /** One headline number or status at the right end of the header ("212 tasks", a `StatusBadge`). Put the number in `<span className="font-medium text-foreground">`. */
+    headline?: ReactNode;
     actions?: ReactNode;
+    /** One line at the bottom of the card: a summary fact on the left, an action or hint on the right. */
     footer?: ReactNode;
     headerClassName?: string;
     contentClassName?: string;
     footerClassName?: string;
 }
-declare function DashboardCardPreset({ title, description, actions, footer, children, headerClassName, contentClassName, footerClassName, className, subgrid, ...props }: DashboardCardPresetProps): React.JSX.Element;
+declare function DashboardCardPreset({ title, description, headline, actions, footer, children, headerClassName, contentClassName, footerClassName, className, subgrid, ...props }: DashboardCardPresetProps): React.JSX.Element;
 
 interface EChartProps {
     /**
@@ -869,7 +878,7 @@ declare const AreaChart: (<T extends Record<string, unknown>>(props: AreaChartPr
  * (`index`) and the series keys (`categories`) instead of an ECharts option.
  * Grouped, stacked or 100%-stacked; vertical or horizontal bars. Colours are the
  * `--chart-1..5` tokens in fixed order (more than 5 series fold into「その他」)
- * and follow light/dark. The value axis always starts at 0. A horizontal bar chart of one
+ * and follow light/dark. The value axis always reaches 0 (negative values add a solid zero line on their own). A horizontal bar chart of one
  * series (`barOptions.layout: "vertical"`) is a light tint by default, like BarList; `barOptions.highlight`
  * names the one bar the page is about, drawn in the full colour.
  * Renders inside `ChartFrame` (title, summary, loading skeleton, empty state).
@@ -1220,6 +1229,43 @@ interface WaterfallChartProps<T extends Record<string, unknown> = Record<string,
     /** 見出しが無いときのプロット領域の読み上げ名。省略時は「<金額の列>のウォーターフォールチャート」。 */
     ariaLabel?: string;
 }
+type WaterfallKind = "total" | "increase" | "decrease" | "flat" | "gap";
+interface WaterfallStep {
+    name: string;
+    kind: WaterfallKind;
+    /** A step's signed change, a total's value. `null` for a gap. */
+    value: number | null;
+    /** The running total before this step (a total starts at 0). */
+    start: number;
+    /** The running total after this step. */
+    end: number;
+    row: Record<string, unknown>;
+}
+/** What `mode="delta"` leaves out of the bars: the opening / closing totals and the net change of the moves. */
+interface WaterfallDeltaEnds {
+    /** The first total row when it comes before every move (its value, `null` when the row carries none). */
+    opening: {
+        name: string;
+        value: number | null;
+    } | null;
+    /** The last total row when it comes after every move; a missing value is the opening plus the net change. */
+    closing: {
+        name: string;
+        value: number | null;
+    } | null;
+    /** The sum of every move (the cumulative change at the last step). */
+    net: number;
+}
+interface WaterfallStack {
+    /** The transparent base under each bar (0 when the bar starts at the axis or crosses it). */
+    base: number[];
+    /** The part of each bar above 0. */
+    pos: number[];
+    /** The part of each bar below 0 (≤ 0). */
+    neg: number[];
+    /** Which series carries the step's value label. */
+    labelOn: ("pos" | "neg")[];
+}
 /** Generic over the row type, so `index` / `categories` keys are checked against `data`. */
 declare const WaterfallChart: (<T extends Record<string, unknown>>(props: WaterfallChartProps<T> & {
     ref?: Ref<HTMLDivElement>;
@@ -1325,6 +1371,25 @@ interface ScatterChartProps<T extends Record<string, unknown> = Record<string, u
     /** 見出しが無いときのプロット領域の読み上げ名。省略時は「<y の列>×<x の列>の散布図」。 */
     ariaLabel?: string;
 }
+interface ScatterPoint {
+    x: number;
+    y: number;
+    /** `null` when there is no size column or the cell is missing. */
+    size: number | null;
+    /** The point's name (`index` column), or `""`. */
+    name: string;
+    /** The series value from the `series` column, or `""`. */
+    series: string;
+    /** The `labelKey` text printed beside the dot (`""` / absent without a `labelKey` column). */
+    label?: string;
+    row: Record<string, unknown>;
+}
+interface ScatterSeries {
+    /** The series name (the `series` value, or「その他」for the folded series). `""` without a `series` column. */
+    name: string;
+    isOther: boolean;
+    points: ScatterPoint[];
+}
 /** Generic over the row type, so `x` / `y` / `size` / `index` / `series` keys are checked against `data`. */
 declare const ScatterChart: (<T extends Record<string, unknown>>(props: ScatterChartProps<T> & {
     ref?: Ref<HTMLDivElement>;
@@ -1341,6 +1406,10 @@ interface LegendProps {
     labels?: Record<string, string>;
     /** 並べ方。`"horizontal"`(既定。折り返す横並び)か `"vertical"`(縦並び)。 */
     layout?: "horizontal" | "vertical";
+    /** 隠している系列名(`onHiddenChange` と対)。グラフに渡す `categories` からこの系列を外す。色は凡例の全 `categories` で決まるので、外しても残りの色は変わらない。 */
+    hidden?: string[];
+    /** 渡すと凡例のチップが押せるボタンになり、押すたびに系列を隠す・戻す(キーボードで操作でき、隠れたチップは薄くなる)。新しい `hidden` が渡される。 */
+    onHiddenChange?: (hidden: string[]) => void;
     /** 凡例の読み上げ名。省略時は「凡例」。 */
     ariaLabel?: string;
     className?: string;
@@ -1367,12 +1436,15 @@ interface ChartFrameProps extends Omit<HTMLAttributes<HTMLElement>, "title" | "c
     /** 見出しが無いときのプロット領域のラベル。 */
     ariaLabel?: string;
     /**
-     * プロット領域の役割。既定 `"img"`(canvas のグラフ)。行がボタンやリンクになる
+     * プロットの役割。既定 `"img"`(canvas のグラフ。`role="img"` と名前・要約は
+     * `EChart` が canvas にだけ付け、操作ボタンは画像の外に置く)。行がボタンやリンクになる
      * HTML のグラフ(BarList・FunnelSteps)は `"group"` にして、中身を読ませる。
      */
     plotRole?: "img" | "group";
     /** 値の表。画面には出さず(`sr-only`)、スクリーンリーダー向けに図の中に置く。`chartDataTable` で作る。 */
     dataTable?: ChartDataTable;
+    /** プロットの下に常に出す小さな注記(近似値である旨など)。読み込み中・空のときも出す。 */
+    footnote?: string;
     /** プロット(チャート本体)。読み込み中・空のときは描かない。 */
     children?: ReactNode;
 }
@@ -1446,7 +1518,7 @@ declare const FunnelSteps: (<T extends object = FunnelStep>(props: FunnelStepsPr
  */
 
 /** Columns of `T` that hold numbers (null / undefined allowed for gaps); untyped rows keep every key. */
-type NumericColumn<T> = {
+type NumericColumn$2<T> = {
     [K in keyof T]-?: unknown extends T[K] ? K : T[K] extends number | bigint | null | undefined ? K : never;
 }[keyof T] & string;
 interface HeatmapProps<T extends Record<string, unknown> = Record<string, unknown>> extends ChartRootAttributes {
@@ -1457,7 +1529,7 @@ interface HeatmapProps<T extends Record<string, unknown> = Record<string, unknow
     /** 縦軸(行)に使う列名。例 `"weekday"`・`"cohort"`。先頭の行が一番上。 */
     y: keyof T & string;
     /** マスの濃さを決める数値の列名。null・欠損・数値でない値のマスは塗らない(0 とは別。ツールチップとデータ表は「—」)。 */
-    value: NumericColumn<T>;
+    value: NumericColumn$2<T>;
     /** 横軸の並び順(と表示するマス)。省略時は `data` の出現順。ここに無い x の行は描かない。 */
     xLabels?: string[];
     /** 縦軸の並び順(と表示するマス)。省略時は `data` の出現順。ここに無い y の行は描かない。 */
@@ -1499,7 +1571,7 @@ interface HeatmapProps<T extends Record<string, unknown> = Record<string, unknow
      * ツールチップとデータ表に添える列(同じ行の別の数値)。例 `["breached"]` →「月曜 9時台 電話 12件・SLA 未達 2件」の「SLA 未達 2件」。
      * 列名の表示は `labels`、値は `format`(単位つきの書式なら同じ単位)で出る。
      */
-    details?: NumericColumn<T>[];
+    details?: NumericColumn$2<T>[];
     /**
      * この列が真(`true` / 0 でない数)の行のマスに、注意色(`--negative`)の枠を付ける。
      * 例 SLA 未達が集中したマス。色だけでなく枠の太さでも区別でき、ツールチップに「要注意」と出る。
@@ -1525,6 +1597,16 @@ interface HeatmapProps<T extends Record<string, unknown> = Record<string, unknow
     /** スクリーンリーダー向けのラベル。省略時は `<yの列>×<xの列>のヒートマップ`。 */
     ariaLabel?: string;
 }
+interface HeatmapCell {
+    /** Index into `xs`. */
+    xi: number;
+    /** Index into `ys`. */
+    yi: number;
+    /** `null` for a gap. */
+    value: number | null;
+    flagged: boolean;
+    row: Record<string, unknown> | null;
+}
 /** Generic over the row type, so `x` / `y` / `value` keys are checked against `data`. */
 declare const Heatmap: (<T extends Record<string, unknown>>(props: HeatmapProps<T> & {
     ref?: Ref<HTMLDivElement>;
@@ -1532,6 +1614,616 @@ declare const Heatmap: (<T extends Record<string, unknown>>(props: HeatmapProps<
     displayName?: string;
 };
 
+/**
+ * PairedChart — 量(棒)と率・単価(線)を、同じ期間軸の上下 2 段で見せる型付きグラフ（`DashboardCardPreset` の中に置く）。
+ * 二重 Y 軸は持たない: 上段が棒の値軸、下段が線の値軸で、横軸(期間)とツールチップの位置は
+ * 1 つの ECharts の中で揃っている(ホバーすると同じ期間の棒と線の値が 1 枚のツールチップに出る)。
+ * 段ごとに `format`(件数・金額・%)を持ち、率を分子・分母から計算することはしない(呼び元が値を渡す)。
+ * 棒は 0 起点。色は `--chart-1..5` を固定順(棒 → 線の順に続く)で使い、ライト/ダークに追従する。
+ * `ChartFrame` の中に描く(見出し・要約・読み込み中・空表示)。
+ */
+
+/** 1 段ぶんの設定。 */
+interface PairedPanel<T extends Record<string, unknown> = Record<string, unknown>> {
+    /** この段に描く系列の列。 */
+    categories: NumericKeys<T>[];
+    /** 系列の色。省略時は `--chart-1..5` を固定順(上段の続きから下段)。 */
+    colors?: ChartColors<T>;
+    /** 値の書式(件数 `number`・金額 `currency`・率 `percent` など)。`percent` は比率(0.124 → 12.4%)を渡す。 */
+    format?: ValueFormat;
+    /** `format` で足りないときの自前の書式。 */
+    valueFormatter?: ValueFormatter;
+    /** 値軸の見出し(「売上」「客単価」など)。 */
+    yAxisLabel?: string;
+    /** 値軸の上限。データが超えるときは軸を広げる。 */
+    maxValue?: number;
+}
+interface PairedChartProps<T extends Record<string, unknown> = Record<string, unknown>> extends Pick<ChartCommonProps<T>, "data" | "index" | "labels" | "title" | "summary" | "isLoading" | "emptyState" | "chartOptions" | "actions" | "fileName" | "className" | "ariaLabel"> {
+    /** 上段。量を棒で。`type` は BarChart と同じ(`stacked` で積み上げ)。 */
+    bars: PairedPanel<T> & {
+        type?: CartesianStackType;
+    };
+    /** 下段。率・単価を線で。`fitToData` で値軸をデータに合わせる(率が狭い幅で動くとき)。 */
+    line: PairedPanel<T> & {
+        fitToData?: boolean;
+        minValue?: number;
+    };
+    /** 全体の高さ(px)。既定 400。 */
+    height?: number;
+    /** 上段:下段の高さの比。既定 `[3, 2]`。 */
+    heightRatio?: [number, number];
+    /** 値軸ラベルの幅(px)。2 段の左端を揃える。既定 64。 */
+    yAxisWidth?: number;
+    showLegend?: boolean;
+    showTooltip?: boolean;
+}
+/** Generic over the row type, so `index` / `categories` / `colors` keys are checked against `data`. */
+declare const PairedChart: (<T extends Record<string, unknown>>(props: PairedChartProps<T> & {
+    ref?: Ref<HTMLDivElement>;
+}) => ReactElement) & {
+    displayName?: string;
+};
+
+interface BoxStats {
+    /** 数えた値の個数。 */
+    count: number;
+    /** 最小・最大(外れ値を含む)。 */
+    min: number;
+    max: number;
+    q1: number;
+    median: number;
+    q3: number;
+    /** ひげの下端・上端: 柵(Q1−k×IQR / Q3+k×IQR)の内側にある最小・最大の実測値。 */
+    whiskerLow: number;
+    whiskerHigh: number;
+    /** 柵の外側の値(昇順)。 */
+    outliers: number[];
+}
+
+interface HistogramThreshold {
+    /** 線を引く値(例 SLA の 3 日)。 */
+    value: number;
+    /** 線の名前(例「SLA」)。ツールチップ・要約・データ表の注記に出る。 */
+    label?: string;
+}
+interface HistogramChartProps extends Omit<ChartCommonProps, "data" | "index" | "categories" | "colors" | "labels" | "summary"> {
+    /** 生の値の配列。number か数値文字列。null・数にならない値は数えない。 */
+    values: unknown[];
+    /** 階級の幅。省略すると値の範囲から区切りのよい幅(1・2・2.5・5 × 10^n)を選ぶ。 */
+    binWidth?: number;
+    /** 階級の始まり。省略は幅の倍数に切り下げた最小値。 */
+    start?: number;
+    /** 上限。この値以上は 1 つの「<上限>以上」階級にまとめる。省略するとまとめない。 */
+    max?: number;
+    /** しきい値の線(任意)。階級の途中にも引ける。 */
+    threshold?: HistogramThreshold;
+    /** 件数の単位。既定は日本語のページで「件」、それ以外は単位なし。 */
+    countUnit?: string;
+    /** 横軸の値の名前(データ表の先頭列)。既定「値」。例「解決日数」 */
+    valueLabel?: string;
+    /** 1 文要約(自由文)。`"auto"` なら件数・最頻の階級・しきい値超えの割合を組む。省略時は要約なし。 */
+    summary?: string | "auto";
+    /** ホバー時のツールチップを出す。既定 `true`。 */
+    showTooltip?: boolean;
+}
+declare const HistogramChart: React.ForwardRefExoticComponent<HistogramChartProps & React.RefAttributes<HTMLDivElement>>;
+
+interface BoxPlotGroup {
+    /** 箱の名前(横軸)。 */
+    name: string;
+    /** 生の値の配列。number か数値文字列。null・数にならない値は数えない。 */
+    values: unknown[];
+}
+interface BoxPlotChartProps extends Omit<ChartCommonProps, "data" | "index" | "categories" | "colors" | "labels" | "summary"> {
+    /** 群ごとの値。並びがそのまま左から右の順。 */
+    groups: BoxPlotGroup[];
+    /** ひげの長さ(四分位範囲の何倍までを外れ値にしないか)。既定 1.5。 */
+    whisker?: number;
+    /** 値(縦軸)の名前。ツールチップとデータ表に出る。既定「値」。例「残業時間」 */
+    valueLabel?: string;
+    /** 1 文要約(自由文)。`"auto"` なら中央値が最大・最小の群と外れ値の数を組む。省略時は要約なし。 */
+    summary?: string | "auto";
+    /** ホバー時のツールチップを出す。既定 `true`。 */
+    showTooltip?: boolean;
+}
+interface BoxPlotEntry {
+    name: string;
+    stats: BoxStats | null;
+}
+declare const BoxPlotChart: React.ForwardRefExoticComponent<BoxPlotChartProps & React.RefAttributes<HTMLDivElement>>;
+
+type AttentionKind = "overdue" | "risk" | "dueSoon" | "stale";
+type DateInput = Date | string | null | undefined;
+interface AttentionJudgement {
+    kind: AttentionKind;
+    /**
+     * overdue: 期日を過ぎた日数（1 以上）／ dueSoon: 期日までの日数（0 = 当日）／
+     * stale: 最終の動きからの日数／ risk: 0。
+     */
+    days: number;
+}
+interface AttentionListProps<T> {
+    rows: T[];
+    /** 基準日（`"2026-10-23"` か Date）。 */
+    asOf: Date | string;
+    /** 期日の何日前から「期限間近」にするか。既定 7。 */
+    dueSoonDays?: number;
+    /** この日数動きがなければ「滞留」。未指定なら滞留は判定しない。 */
+    staleDays?: number;
+    /** 区分名の差し替え（例: `{ overdue: "入金遅れ" }`）。 */
+    labels?: Partial<Record<AttentionKind, string>>;
+    /** 行の ID。省略時は `idKey` の列、それも無ければ行の順番。 */
+    getRowId?: (row: T) => string;
+    /** 行の見出し（顧客名・案件名など）。省略時は `titleKey` の列、それも無ければ空。 */
+    getTitle?: (row: T) => ReactNode;
+    getDueDate?: (row: T) => DateInput;
+    getLastActivityAt?: (row: T) => DateInput;
+    /** リスクと判定する行。期日・滞留より先に出す。 */
+    isRisk?: (row: T) => boolean;
+    /** 行の ID の列名（JSON で書ける `getRowId`）。 */
+    idKey?: string;
+    /** 見出しの列名（JSON で書ける `getTitle`）。 */
+    titleKey?: string;
+    /** 期日の列名（JSON で書ける `getDueDate`）。値は `"2026-10-23"` 形式の日付か Date。 */
+    dueDateKey?: string;
+    /** 最後に動きがあった日の列名（JSON で書ける `getLastActivityAt`）。 */
+    lastActivityAtKey?: string;
+    /** リスクの列名（JSON で書ける `isRisk`）。値が真の行をリストにする。 */
+    riskKey?: string;
+    /** 次の一手の列名（JSON で書ける `getNextAction`）。値が空の行には添えない。 */
+    nextActionKey?: string;
+    /** 理由の文。省略すると区分と日数から作る。 */
+    getReason?: (row: T, judgement: AttentionJudgement) => ReactNode;
+    /** 次の一手。判定に当たる行に添える。 */
+    getNextAction?: (row: T, judgement: AttentionJudgement) => ReactNode;
+    /** 見出しの右に出す補足（金額・担当者など）。 */
+    getMeta?: (row: T) => ReactNode;
+    /** 行を押したとき。渡すと行が button になる。 */
+    onRowClick?: (row: T) => void;
+    /** 判定に当たらない行も末尾に出す。既定 false。 */
+    includeUnflagged?: boolean;
+    /** 該当なしのときの見出し・説明。 */
+    emptyTitle?: string;
+    emptyDescription?: string;
+    className?: string;
+}
+declare function AttentionList<T>({ rows, asOf, dueSoonDays, staleDays, labels, getRowId, getTitle, getDueDate, getLastActivityAt, isRisk, idKey, titleKey, dueDateKey, lastActivityAtKey, riskKey, nextActionKey, getReason, getNextAction, getMeta, onRowClick, includeUnflagged, emptyTitle, emptyDescription, className, ...rest }: AttentionListProps<T> & Omit<HTMLAttributes<HTMLUListElement>, keyof AttentionListProps<T>>): React.JSX.Element;
+declare namespace AttentionList {
+    var displayName: string;
+}
+
+/**
+ * ComboChart — bars, lines and areas on one category / time axis, with up to two value axes (left and right); use it only to migrate a Tableau dual-axis sheet, and use `PairedChart` for a new dashboard.
+ *
+ * It exists to reproduce a Tableau dual-axis sheet faithfully (a Pareto: sales as bars, the cumulative share as a
+ * line on the right). For a new dashboard prefer PairedChart, which stacks the two measures in panels over a
+ * shared axis instead of reading two scales off one plot.
+ *
+ * Each value axis starts at 0 (bars always do; a negative value extends the axis below it), carries its own format
+ * (`format` left, `rightFormat` right), and never repeats a tick label: the tick step widens until every label on
+ * the axis reads differently. Only the left axis draws grid lines. `referenceLines` draw dashed lines on either axis.
+ * Clicking a bar or a point calls `onSelect` with its row.
+ */
+
+type ComboSeriesType = "bar" | "line" | "area";
+type ComboAxis = "left" | "right";
+/** One measure of a ComboChart. */
+interface ComboSeries<K extends string = string> {
+    /** 値の列名。 */
+    key: K;
+    /** 描き方。`"bar"`(棒)・`"line"`(線)・`"area"`(面)。 */
+    type: ComboSeriesType;
+    /** どちらの値の軸で読むか。既定 `"left"`。`"right"` の系列が 1 つでもあると右軸を出す。 */
+    axis?: ComboAxis;
+    /** 凡例・ツールチップの表示名。省略時は `labels[key]`、無ければ列名。 */
+    label?: string;
+    /** 色。`"chart-1"`〜`"chart-5"` か意味色。省略時は系列の順にトークン色。 */
+    color?: ChartSeriesColor;
+}
+/** A dashed horizontal (vertical with `layout="vertical"`) line at a value of one axis. */
+interface ComboReferenceLine {
+    /** 線を引く値。 */
+    value: number;
+    /** どちらの軸の値か。既定 `"left"`。 */
+    axis?: ComboAxis;
+    /** 線のラベル。省略時は軸の書式で値を書く。 */
+    label?: string;
+}
+interface ComboChartProps<T extends Record<string, unknown> = Record<string, unknown>> extends ChartRootAttributes {
+    /** 行の配列。1 行 = カテゴリ軸の 1 つの値(集計済み)。 */
+    data: T[];
+    /** カテゴリ軸(横軸)の列名。例 `"month"`・`"product"`。行の順に並ぶ。 */
+    index: keyof T & string;
+    /** 描く系列。`{ key, type: "bar" | "line" | "area", axis?: "left" | "right", label? }` の配列。描く順(後ろほど手前)。 */
+    series: ComboSeries<keyof T & string>[];
+    /** 左軸(と左軸の系列のツールチップ・データ表)の書式。既定 `"compact"` 相当の短い表記。 */
+    format?: ValueFormat;
+    /** 右軸の書式。例 パレート図の累積比なら `"percent"`。省略時は `format`。 */
+    rightFormat?: ValueFormat;
+    /** 列名・カテゴリの値 → 表示名。 */
+    labels?: Record<string, string>;
+    /** 参照線(目標・平均など)。`{ value, axis?, label? }` の配列。 */
+    referenceLines?: ComboReferenceLine[];
+    /** 同じ軸の棒どうし・面どうしを積み上げる。既定 `false`(棒は横に並べる)。 */
+    stacked?: boolean;
+    /** `"vertical"` でカテゴリを縦軸に並べる(横棒)。左軸は下、右軸は上になる。既定 `"horizontal"`。 */
+    layout?: "horizontal" | "vertical";
+    /** 凡例を出す。既定 `true`(系列が 2 つ以上のとき)。 */
+    showLegend?: boolean;
+    /** ホバーでツールチップを出す。既定 `true`。 */
+    showTooltip?: boolean;
+    /** 棒・点のクリック。その行を受け取る(フィルターの操作に使う)。 */
+    onSelect?: (row: T) => void;
+    /** グラフの見出し。 */
+    title?: string;
+    /** グラフが言っていることの 1 文要約。 */
+    summary?: string;
+    /** 読み込み中。最終形と同じ高さのスケルトンを出す。 */
+    isLoading?: boolean;
+    /** `data` が空のときの表示。 */
+    emptyState?: ChartEmptyState;
+    /** プロット領域の高さ(px)。既定 288。 */
+    height?: number;
+    /** 生成した EChartsOption に最後に深くマージする逃げ道。 */
+    chartOptions?: EChartsOption;
+    /** グラフ右上に PNG 保存/コピーのボタンを出す。 */
+    actions?: boolean | ChartActionsOptions;
+    /** PNG 保存時のファイル名(拡張子つき)。 */
+    fileName?: string;
+    className?: string;
+    /** スクリーンリーダー向けのラベル。 */
+    ariaLabel?: string;
+}
+/** Generic over the row type, so `index` and the series keys are checked against `data`. */
+declare const ComboChart: (<T extends Record<string, unknown>>(props: ComboChartProps<T> & {
+    ref?: Ref<HTMLDivElement>;
+}) => ReactElement) & {
+    displayName?: string;
+};
+
+/**
+ * 等間隔の 1 系列に対する指数平滑法(ETS、誤差は加法)の予測。依存なしの純関数で、同じ入力には同じ出力を返す(乱数を使わない)。
+ *
+ * - モデルは トレンド(なし / 加法)× 季節(なし / 加法 / 乗法)。乗法トレンドは扱わず、加法トレンドとして当てはめる
+ *   (`model.trend` には実際に当てはめた `"additive"` が入る)。乗法トレンドの予測区間は閉じた式が無く、決定的に出せないため。
+ * - 平滑化係数(α・β・γ)と初期の水準・傾きは、1 期先予測の残差平方和の最小化(誤差が加法なので最尤と同じ)を
+ *   Nelder–Mead で解く。範囲は 0 < α < 1、0 < β < α、0 < γ < 1 − α。初期の季節成分は古典的分解(最初の数季節の移動平均)で決める。
+ * - `"auto"` は当てはめられる組み合わせをすべて当て、AICc が最小のものを選ぶ(Tableau も最大 8 モデルから AIC で選ぶ)。
+ * - 予測区間は ETS(A,·,·) の分散の式(Hyndman ほか 2008 / fpp の表)で、点予測 ± z·σ·√(分散の倍率)。σ は残差から。
+ *   乗法の季節は閉じた式が無いので、2 期先以降の項に季節指数の 2 乗を掛ける近似にしている。
+ * - Tableau はパラメータの推定方法を公開していないため、同じモデルを選んでも値は一致しない(近似値として扱う)。
+ */
+/** トレンド・季節の指定。`"auto"` は当てはめられる候補から AICc で選ぶ。 */
+type ForecastComponent = "none" | "additive" | "multiplicative" | "auto";
+interface ForecastOptions {
+    /** トレンド。既定 `"auto"`。`"multiplicative"` は加法トレンドとして当てはめる。 */
+    trend?: ForecastComponent;
+    /** 季節。既定 `"auto"`。`seasonLength` が 1 以下か、点が 2 季節分に満たないときは季節なしに落とす。 */
+    season?: ForecastComponent;
+    /** 1 季節の期数(月次 12・四半期 4・曜日 7)。省略か 1 で季節なし。 */
+    seasonLength?: number;
+    /**
+     * 予測する期数。既定は季節ありなら 1 季節分(`seasonLength`)、なければ当てはめた点の 4 分の 1(1〜12 期)。
+     * 末尾の除外期(`ignoreLast` と末尾の欠損)はこれとは別に予測する。
+     */
+    horizon?: number;
+    /** 予測区間の信頼水準(0〜1)。既定 0.95。 */
+    confidence?: number;
+    /** 末尾から除外する期数(締まっていない期)。当てはめに使わず、予測する側に回す。既定 0。 */
+    ignoreLast?: number;
+}
+
+/**
+ * ForecastChart — a time-series line chart that continues each series with an exponential-smoothing forecast (dashed line and shaded prediction interval) computed from `data` at render time; place it inside `DashboardCardPreset`, and use it to migrate a Tableau forecast sheet.
+ *
+ * Pass the rows, the date column (`x`), the value column (`y`) and optionally a column that splits the rows into
+ * series (`series`, e.g. a segment). Rows that fall in the same period and series are summed. The forecast is
+ * recomputed on every change of the inputs (never stored or fetched) with the model family in `forecast`
+ * (trend / season, `"auto"` picks the lowest AICc), so it is an approximation: a fixed note under the plot always
+ * says so (name the source tool with `forecastSource`; `forecastNote` only adds to it). A series with too few points draws its actuals only.
+ */
+
+/** 予測の 1 期の長さ。未来の日付を進める単位。 */
+type ForecastPeriod = "day" | "week" | "month" | "quarter" | "year";
+interface ForecastChartProps<T extends Record<string, unknown> = Record<string, unknown>> extends Omit<ChartCommonProps<T>, "index" | "categories" | "colors"> {
+    /** 日付の列名。ISO の日付・年月(`"2026-01"`)・年・`Date` を受ける。 */
+    x: keyof T & string;
+    /** 値の列名。number か数値文字列。 */
+    y: keyof T & string;
+    /** 系列に分ける列名(セグメントなど)。省略時は 1 系列。6 つ以上は合計の大きい 5 つ +「その他」にまとめる。 */
+    series?: keyof T & string;
+    /** 1 期の長さ。省略時は日付の間隔から推定する。同じ期に入る行は合計する。 */
+    period?: ForecastPeriod;
+    /**
+     * 予測の設定(トレンド・季節・季節の長さ・期数・信頼水準・末尾の除外期)。`seasonLength` を省略すると `period` から
+     * 決める(月 12・四半期 4・週 52・日 7・年は季節なし)。例: `forecast={{ trend: "additive", season: "additive", horizon: 12 }}`
+     */
+    forecast?: ForecastOptions;
+    /** 凡例・ツールチップ・境目の縦線に出す予測の呼び名。既定は表示言語の「予測」/ "Forecast"。 */
+    forecastLabel?: string;
+    /**
+     * 予測の元になったツール（`"Tableau"` など）。プロットの下の注記に「〈ツール〉の予測値とは一致しない」と名前で出す。
+     * 注記そのもの（近似であること）は部品が必ず出し、置き換えられない。
+     */
+    forecastSource?: string;
+    /** 注記のあとに足す補足（集計の範囲など）。近似の注記を置き換えるものではない。 */
+    forecastNote?: string;
+    /** 系列色。配列は系列の順、record は系列名ごと。省略時はトークン順。 */
+    colors?: ChartColors;
+    /** 凡例・ツールチップを出す。既定 `true`。 */
+    showLegend?: boolean;
+    showTooltip?: boolean;
+    /** 値軸の目盛り線を出す。既定 `true`。 */
+    showGridLines?: boolean;
+    showXAxis?: boolean;
+    showYAxis?: boolean;
+    /** y 軸ラベルの幅(px)。 */
+    yAxisWidth?: number;
+    /** 値軸の下限・上限(データ・予測区間がはみ出すときは軸を広げる)。 */
+    minValue?: number;
+    maxValue?: number;
+    /** 値軸を 0 からではなくデータに合わせる。既定 `false`。 */
+    fitToData?: boolean;
+    xAxisLabel?: string;
+    yAxisLabel?: string;
+}
+/** Generic over the row type, so `x` / `y` / `series` are checked against `data`. */
+declare const ForecastChart: (<T extends Record<string, unknown>>(props: ForecastChartProps<T> & {
+    ref?: Ref<HTMLDivElement>;
+}) => ReactElement) & {
+    displayName?: string;
+};
+
+/** The maps the parts draw. */
+type GeoMapName = "japan" | "us" | "world";
+
+/**
+ * FilledMap — a choropleth: each region (Japanese prefecture, US state or country) shaded by a number. Pass rows,
+ * the column naming the region and the number to shade by instead of an ECharts option.
+ *
+ * Regions are matched by name or code, in Japanese or English: 「東京都」「東京」「Tokyo」「JP-13」「13」,
+ * 「California」「CA」「US-CA」, 「Japan」「JPN」「JP」 (case, width and accents don't matter: "Ōita" = "Oita").
+ * `map="auto"` (default) picks the map whose regions the most rows name. A row that names no region is not drawn;
+ * it is listed in the screen-reader table instead.
+ *
+ * Shading is a single-colour ramp of one theme colour (`tone`, `--chart-1` by default) like Heatmap: the lowest
+ * value is the tone mixed 20% into the surface, the highest the tone itself, never a rainbow. A region with no row
+ * (or a null value) is grey. `selected` dims the other regions; clicking a region calls `onSelect` (a filter action).
+ * The boundaries (Natural Earth, public domain) load on demand, so the part shows its skeleton for a moment the first time.
+ */
+
+/** Columns of `T` that hold numbers (null / undefined allowed for gaps); untyped rows keep every key. */
+type NumericColumn$1<T> = {
+    [K in keyof T]-?: unknown extends T[K] ? K : T[K] extends number | bigint | null | undefined ? K : never;
+}[keyof T] & string;
+type FilledMapName = GeoMapName | "auto";
+interface FilledMapProps<T extends Record<string, unknown> = Record<string, unknown>> extends ChartRootAttributes {
+    /** 行の配列。1 行 = 1 地域。同じ地域が複数あれば後の行が勝つ。値は number か数値文字列。 */
+    data: T[];
+    /** 地域を表す列名。都道府県名(「東京都」「東京」「Tokyo」)・州名・国名か、コード(`JP-13`・`13`・`CA`・`US-CA`・`JPN`・`JP`)。 */
+    region: keyof T & string;
+    /** 塗りの濃さを決める数値の列名。null・欠損の地域は灰色(0 とは別)。 */
+    value: NumericColumn$1<T>;
+    /** 描く地図。`"japan"`(都道府県)・`"us"`(州)・`"world"`(国)。既定 `"auto"`(地域の列の値が最も多く当たる地図)。 */
+    map?: FilledMapName;
+    /** 列名・地域の値 → 表示名(ツールチップ・データ表)。例 `{ sales: "売上" }`。 */
+    labels?: Record<string, string>;
+    /** 数値の書式(`"number"` / `"currency"` / `"percent"` / `{ type: "number", unit: "件" }` など)。既定 `"number"`。 */
+    format?: ValueFormat;
+    /** 書式を関数で直接渡す逃げ道。`format` より優先する。 */
+    valueFormatter?: ValueFormatter;
+    /** 濃淡の色。`"chart-1"`〜`"chart-5"` か意味色。薄い → 濃いの単色(レインボーにしない)。既定 `"chart-1"`。 */
+    tone?: ChartSeriesColor;
+    /** 濃さの固定スケール。省略時はデータの最小〜最大。範囲外の値は端に丸める。 */
+    scale?: {
+        min?: number;
+        max?: number;
+    };
+    /** 凡例(薄い → 濃いの帯と両端の値)を出す。既定 `true`。 */
+    showLegend?: boolean;
+    /** ホバーでツールチップを出す。既定 `true`。 */
+    showTooltip?: boolean;
+    /** ツールチップとデータ表に添える列(同じ行の別の値)。数値は `format`、それ以外は文字のまま。 */
+    details?: (keyof T & string)[];
+    /** 選択中の地域(`region` 列の値。名前・コードのどの書き方でもよい)。渡すと、それ以外の地域を薄くする。 */
+    selected?: string[];
+    /** 地域のクリック。`region` 列の値と、その行を受け取る(フィルターの操作に使う)。データの無い地域では呼ばない。 */
+    onSelect?: (region: string, row: T) => void;
+    /** グラフの見出し。 */
+    title?: string;
+    /** グラフが言っていることの 1 文要約。`"auto"` で最大の地域から自動生成。 */
+    summary?: string | "auto";
+    /** 読み込み中。最終形と同じ高さのスケルトンを出す。 */
+    isLoading?: boolean;
+    /** `data` が空のときの表示。 */
+    emptyState?: ChartEmptyState;
+    /** プロット領域の高さ(px)。既定 288。 */
+    height?: number;
+    /** 生成した EChartsOption に最後に深くマージする逃げ道。 */
+    chartOptions?: EChartsOption;
+    /** グラフ右上に PNG 保存/コピーのボタンを出す。 */
+    actions?: boolean | ChartActionsOptions;
+    /** PNG 保存時のファイル名(拡張子つき)。 */
+    fileName?: string;
+    className?: string;
+    /** スクリーンリーダー向けのラベル。省略時は `<valueの列>の地図`。 */
+    ariaLabel?: string;
+}
+interface FilledMapRegion {
+    code: string;
+    /** The row's region value as written (what `onSelect` receives), or `null` without a row. */
+    key: string | null;
+    /** Display name: `labels[key]` when given, else the map's name in the page's language (「東京都」 for "13"). */
+    name: string;
+    value: number | null;
+    row: Record<string, unknown> | null;
+}
+/** Generic over the row type, so `region` / `value` keys are checked against `data`. */
+declare const FilledMap: (<T extends Record<string, unknown>>(props: FilledMapProps<T> & {
+    ref?: Ref<HTMLDivElement>;
+}) => ReactElement) & {
+    displayName?: string;
+};
+
+/**
+ * SymbolMap — points at latitude / longitude over a faint boundary basemap (Japan's prefectures, US states or the
+ * countries of the world). Pass rows and the two coordinate columns instead of an ECharts option.
+ *
+ * `size` scales each symbol's area by a number; `color` colours it by a number (a single-hue ramp of `tone`, like
+ * Heatmap) or by a category (`--chart-1..5` in order of appearance, the 6th category on as「その他」/ "Other").
+ * `basemap="auto"` (default) picks the smallest map holding every point. A row without usable coordinates is not
+ * drawn; it is listed in the screen-reader table instead. `selected` dims the other points; clicking a point calls
+ * `onSelect` (a filter action). The boundaries (Natural Earth, public domain) load on demand.
+ */
+
+type SymbolMapBasemap = GeoMapName | "auto";
+interface SymbolMapProps<T extends Record<string, unknown> = Record<string, unknown>> extends ChartRootAttributes {
+    /** 行の配列。1 行 = 1 点。 */
+    data: T[];
+    /** 緯度の列名(-90〜90。数値か数値文字列)。 */
+    latitude: keyof T & string;
+    /** 経度の列名(-180〜180。数値か数値文字列)。 */
+    longitude: keyof T & string;
+    /** 点の名前の列名(ツールチップ・データ表・`selected` の照合に使う)。 */
+    name?: keyof T & string;
+    /** 点の大きさ(面積)を決める数値の列名。省略時は同じ大きさ。 */
+    size?: keyof T & string;
+    /** 点の色を決める列名。数値なら `tone` の単色の濃淡、文字ならカテゴリ色(`--chart-1..5` の出現順、6 つ目以降は「その他」)。 */
+    color?: keyof T & string;
+    /** 背景の地図。`"japan"`・`"us"`・`"world"`。既定 `"auto"`(全部の点が入る最も狭い地図)。 */
+    basemap?: SymbolMapBasemap;
+    /** 列名 → 表示名(ツールチップ・凡例・データ表)。 */
+    labels?: Record<string, string>;
+    /** 数値の書式(`color` の数値と、`sizeFormat` が無いときの `size`)。既定 `"number"`。 */
+    format?: ValueFormat;
+    /** `size` の値の書式。省略時は `format`。 */
+    sizeFormat?: ValueFormat;
+    /** 数値の `color` の濃淡の色。`"chart-1"`〜`"chart-5"` か意味色。既定 `"chart-1"`。 */
+    tone?: ChartSeriesColor;
+    /** 凡例(数値の色なら濃淡の帯、カテゴリなら色の一覧)を出す。既定 `true`。 */
+    showLegend?: boolean;
+    /** ホバーでツールチップを出す。既定 `true`。 */
+    showTooltip?: boolean;
+    /** ツールチップとデータ表に添える列。 */
+    details?: (keyof T & string)[];
+    /** 選択中の点(`name` 列の値)。渡すと、それ以外の点を薄くする。 */
+    selected?: string[];
+    /** 点のクリック。その行を受け取る(フィルターの操作に使う)。 */
+    onSelect?: (row: T) => void;
+    /** グラフの見出し。 */
+    title?: string;
+    /** グラフが言っていることの 1 文要約。 */
+    summary?: string;
+    /** 読み込み中。最終形と同じ高さのスケルトンを出す。 */
+    isLoading?: boolean;
+    /** `data` が空のときの表示。 */
+    emptyState?: ChartEmptyState;
+    /** プロット領域の高さ(px)。既定 288。 */
+    height?: number;
+    /** 生成した EChartsOption に最後に深くマージする逃げ道。 */
+    chartOptions?: EChartsOption;
+    /** グラフ右上に PNG 保存/コピーのボタンを出す。 */
+    actions?: boolean | ChartActionsOptions;
+    /** PNG 保存時のファイル名(拡張子つき)。 */
+    fileName?: string;
+    className?: string;
+    /** スクリーンリーダー向けのラベル。 */
+    ariaLabel?: string;
+}
+interface SymbolMapPoint {
+    lon: number;
+    lat: number;
+    name: string | null;
+    size: number | null;
+    /** Numeric colour value (numeric `color`). */
+    shade: number | null;
+    /** Category (categorical `color`), as text. */
+    category: string | null;
+    row: Record<string, unknown>;
+}
+/** Generic over the row type, so the column keys are checked against `data`. */
+declare const SymbolMap: (<T extends Record<string, unknown>>(props: SymbolMapProps<T> & {
+    ref?: Ref<HTMLDivElement>;
+}) => ReactElement) & {
+    displayName?: string;
+};
+
+/**
+ * Treemap — parts of a whole as nested rectangles whose areas are the values.
+ * Pass rows, the leaf column (`index`),
+ * optionally a parent column (`group`, for two levels) and the number (`value`) instead of an ECharts option.
+ *
+ * Colour is categorical by `group` (or by `index` without one): `--chart-1..5` for the largest five, the rest the
+ * 「その他」grey. A numeric `color` column shades each tile on a single-hue ramp of `tone` instead (like Heatmap).
+ * Each tile carries its name and value when it fits. Values that are zero, negative or missing take no area; they
+ * stay in the screen-reader table. Clicking a tile calls `onSelect` with its row.
+ */
+
+/** Columns of `T` that hold numbers (null / undefined allowed for gaps); untyped rows keep every key. */
+type NumericColumn<T> = {
+    [K in keyof T]-?: unknown extends T[K] ? K : T[K] extends number | bigint | null | undefined ? K : never;
+}[keyof T] & string;
+interface TreemapProps<T extends Record<string, unknown> = Record<string, unknown>> extends ChartRootAttributes {
+    /** 行の配列。1 行 = 1 タイル(集計済みの値)。 */
+    data: T[];
+    /** タイル(葉)の名前の列名。例 `"product"`。 */
+    index: keyof T & string;
+    /** 親の列名(2 階層にする)。例 `"category"`。省略時は 1 階層。 */
+    group?: keyof T & string;
+    /** タイルの面積を決める数値の列名。0 以下・欠損の行は面積を持たない(データ表には残る)。 */
+    value: NumericColumn<T>;
+    /** タイルの色を決める数値の列名(`tone` の単色の濃淡)。省略時は `group`(無ければ `index`)ごとのカテゴリ色。 */
+    color?: NumericColumn<T>;
+    /** 列名・値 → 表示名(タイル・ツールチップ・凡例・データ表)。 */
+    labels?: Record<string, string>;
+    /** `value` の書式。既定 `"number"`。 */
+    format?: ValueFormat;
+    /** `color` の値の書式。省略時は `format`。 */
+    colorFormat?: ValueFormat;
+    /** 書式を関数で直接渡す逃げ道(`value`)。`format` より優先する。 */
+    valueFormatter?: ValueFormatter;
+    /** 数値の `color` の濃淡の色。既定 `"chart-1"`。 */
+    tone?: ChartSeriesColor;
+    /** 凡例(カテゴリ色なら色の一覧、数値の色なら濃淡の帯)を出す。既定 `true`(カテゴリ色は `group` があるときだけ)。 */
+    showLegend?: boolean;
+    /** ホバーでツールチップを出す。既定 `true`。 */
+    showTooltip?: boolean;
+    /** タイルのクリック。その行を受け取る(フィルターの操作に使う)。 */
+    onSelect?: (row: T) => void;
+    /** グラフの見出し。 */
+    title?: string;
+    /** グラフが言っていることの 1 文要約。`"auto"` で最大のタイルとその構成比。 */
+    summary?: string | "auto";
+    /** 読み込み中。最終形と同じ高さのスケルトンを出す。 */
+    isLoading?: boolean;
+    /** `data` が空のときの表示。 */
+    emptyState?: ChartEmptyState;
+    /** プロット領域の高さ(px)。既定 288。 */
+    height?: number;
+    /** 生成した EChartsOption に最後に深くマージする逃げ道。 */
+    chartOptions?: EChartsOption;
+    /** グラフ右上に PNG 保存/コピーのボタンを出す。 */
+    actions?: boolean | ChartActionsOptions;
+    /** PNG 保存時のファイル名(拡張子つき)。 */
+    fileName?: string;
+    className?: string;
+    /** スクリーンリーダー向けのラベル。 */
+    ariaLabel?: string;
+}
+interface TreemapLeaf {
+    name: string;
+    group: string | null;
+    value: number | null;
+    shade: number | null;
+    row: Record<string, unknown>;
+}
+/** Generic over the row type, so the column keys are checked against `data`. */
+declare const Treemap: (<T extends Record<string, unknown>>(props: TreemapProps<T> & {
+    ref?: Ref<HTMLDivElement>;
+}) => ReactElement) & {
+    displayName?: string;
+};
+
 type SparklineVariant = "line" | "bar";
 interface SparklineDataPoint {
     value: number;
@@ -1541,8 +2233,14 @@ interface SparklineProps extends SVGAttributes<SVGSVGElement> {
     data: SparklineDataPoint[];
     variant?: SparklineVariant;
     height?: number;
-    /** Tailwind text-colour class; drives both stroke and fill via `currentColor`. */
-    color?: string;
+    /**
+     * Line / bar colour: a theme series token (`"chart-1"`〜`"chart-5"`), a meaning colour
+     * (`"positive"` / `"negative"` / `"warning"` / `"neutral"` / `"info"`), or any CSS colour
+     * (`"#16a34a"`, `"var(--destructive)"`) — the same {@link ChartColor} the other charts take.
+     * Drives both stroke and fill via `currentColor`. Defaults to `"chart-1"`.
+     * Tailwind text-colour classes (`"text-primary"`) still work for compatibility; prefer the tokens above.
+     */
+    color?: ChartColor;
     area?: boolean;
     /** マウント時に線を引く / 棒を伸ばす。既定 `false`(`prefers-reduced-motion` では常に無効)。 */
     animate?: boolean;
@@ -1555,6 +2253,11 @@ interface SparklineProps extends SVGAttributes<SVGSVGElement> {
     "aria-label"?: string;
     className?: string;
 }
+type SparklinePointKind = "latest" | "max" | "min";
+interface SparklinePoint {
+    kind: SparklinePointKind;
+    index: number;
+}
 declare const Sparkline: React.ForwardRefExoticComponent<SparklineProps & React.RefAttributes<SVGSVGElement>>;
 
 declare module "@tanstack/react-table" {
@@ -1809,6 +2512,19 @@ declare function DataTable<TData, TValue>({ columns, data, enableSorting, sortin
 declare namespace DataTable {
     var displayName: string;
 }
+interface SparklineColumnOptions<TData> {
+    /** 列 ID（CSV・列の表示切り替えで使う）。 */
+    id: string;
+    /** 見出し。 */
+    header: string;
+    /**
+     * 行の数列を返す（古い順。例: 直近 8 週の売上）。null / undefined / 2 点未満の行は「—」。
+     * NaN などの有限でない値は取り除いてから数える。
+     */
+    values: (row: TData) => readonly (number | null | undefined)[] | null | undefined;
+    /** スクリーンリーダー向けの数値の書式（`meta.format` と同じ語彙）。既定は `"number"`。 */
+    format?: ValueFormat;
+}
 declare const DataTableToolbar: React.ForwardRefExoticComponent<DataTableToolbarProps & React.RefAttributes<HTMLDivElement>>;
 declare const DataTableContent: React.ForwardRefExoticComponent<DataTableContentProps & React.RefAttributes<HTMLDivElement>>;
 declare const DataTablePagination: React.ForwardRefExoticComponent<DataTablePaginationProps & React.RefAttributes<HTMLDivElement>>;
@@ -1852,6 +2568,41 @@ declare namespace DataTablePreset {
     var displayName: string;
 }
 
+interface PivotTableProps<T extends Record<string, unknown> = Record<string, unknown>> {
+    /** 集計済みの行の配列。1 行 = 1 マス(行の次元 × 列の次元の組)。同じ組が複数あれば後の行が勝つ(合計はしない)。 */
+    data: T[];
+    /** 行の次元の列名(左から入れ子)。例 `["region", "category"]`。空なら 1 行。 */
+    rows: (keyof T & string)[];
+    /** 列の次元の列名(上から入れ子)。例 `["year"]`。空なら列の見出しは値の名前だけ。 */
+    columns: (keyof T & string)[];
+    /** マスに出す数値の列名。2 つ以上なら列の次元ごとに小列に分かれる。 */
+    values: (keyof T & string)[];
+    /** 値ごとの書式。例 `{ sales: "currency", margin: "percent" }`。無い値は `"number"`。 */
+    formats?: Partial<Record<string, ValueFormat>>;
+    /** 列名・次元の値 → 表示名(見出しに反映)。 */
+    labels?: Record<string, string>;
+    /** 値でマスを塗る(ハイライト表)。`true` で全部の値(値ごとに最小〜最大)、値の列名でその値だけ。既定 `false`。 */
+    highlight?: boolean | string;
+    /** 塗りの色。`"chart-1"`〜`"chart-5"` か意味色。薄い → 濃いの単色。既定 `"chart-1"`。 */
+    tone?: ChartSeriesColor;
+    /** マスのクリック。そのマスの行を受け取る(フィルターの操作に使う)。値の無いマスでは呼ばない。 */
+    onSelect?: (row: T) => void;
+    /** 表の見出し。 */
+    title?: string;
+    /** 表が言っていることの 1 文要約。 */
+    summary?: string;
+    /** 読み込み中。スケルトンを出す。 */
+    isLoading?: boolean;
+    /** `data` が空のときの表示。 */
+    emptyState?: ChartEmptyState;
+    /** 表の箱の最大の高さ(px)。超えると箱の中で縦にスクロールし、見出しは上に残る。既定 480。 */
+    maxHeight?: number;
+    className?: string;
+    /** スクリーンリーダー向けのラベル。省略時は見出し。 */
+    ariaLabel?: string;
+}
+declare function PivotTable<T extends Record<string, unknown>>({ data, rows: rowDims, columns: colDims, values: valueKeys, formats, labels, highlight, tone, onSelect, title, summary, isLoading, emptyState, maxHeight, className, ariaLabel, }: PivotTableProps<T>): React.JSX.Element;
+
 interface FilterBarProps extends Omit<HTMLAttributes<HTMLDivElement>, "onChange"> {
     value: FilterValues;
     onChange: (values: FilterValues) => void;
@@ -1888,6 +2639,16 @@ declare function FilterBarMultiSelect({ filterKey, label, options, placeholder,
 declare namespace FilterBarMultiSelect {
     var displayName: string;
 }
+interface FilterBarAddFilterProps {
+    /** Conditions offered in the menu. Only `select` / `multi-select` entries with options are listed. */
+    filters: FilterConfig[];
+    className?: string;
+}
+/** A menu that lists the conditions; each opens a submenu of values to check. Checked values show as chips. */
+declare function FilterBarAddFilter({ filters, className }: FilterBarAddFilterProps): React.JSX.Element;
+declare namespace FilterBarAddFilter {
+    var displayName: string;
+}
 interface FilterBarActiveChipsProps {
     /** Filter configs used to resolve option labels. Without them, raw values show. */
     filters?: FilterConfig[];
@@ -1964,6 +2725,14 @@ interface DateRangePickerProps {
      * <DateRangePicker fiscalYearStartMonth={1} />
      */
     fiscalYearStartMonth?: number;
+    /**
+     * 比較期間。渡すと選択範囲から比較する範囲を計算し、トリガーに添える。
+     * `previous-period` は直前の同じ日数、`previous-year` は 1 年前の同じ日付。比較の日付は渡さない。
+     *
+     * @example
+     * <DateRangePicker comparison="previous-year" />
+     */
+    comparison?: "previous-period" | "previous-year";
     maxDate?: Date;
     minDate?: Date;
     placeholder?: string;
@@ -2269,6 +3038,58 @@ interface TrendIndicatorProps {
  */
 declare const TrendIndicator: React.ForwardRefExoticComponent<TrendIndicatorProps & React.RefAttributes<HTMLSpanElement>>;
 
+/**
+ * 状態の語彙の正本: status → ラベルと色調。StatusBadge の既定の表示と、Tracker の凡例など
+ * 同じ状態を語る他の場所が、同じ語を使うためにここから参照する。`label` は英語（フォールバック）で、
+ * ページの言語に合わせた語は `statusLabel(status, locale)` で引く。
+ */
+declare const STATUS_VOCABULARY: {
+    readonly success: {
+        readonly label: "Healthy";
+        readonly tone: "positive";
+    };
+    readonly partial: {
+        readonly label: "Partially failed";
+        readonly tone: "warning";
+    };
+    readonly failed: {
+        readonly label: "Failed";
+        readonly tone: "negative";
+    };
+    readonly delayed: {
+        readonly label: "Delayed";
+        readonly tone: "warning";
+    };
+    readonly running: {
+        readonly label: "Running";
+        readonly tone: "info";
+    };
+    readonly stopped: {
+        readonly label: "Stopped";
+        readonly tone: "neutral";
+    };
+    readonly active: {
+        readonly label: "Active";
+        readonly tone: "positive";
+    };
+    readonly inactive: {
+        readonly label: "Inactive";
+        readonly tone: "neutral";
+    };
+    readonly warning: {
+        readonly label: "Warning";
+        readonly tone: "warning";
+    };
+    readonly error: {
+        readonly label: "Error";
+        readonly tone: "negative";
+    };
+    readonly pending: {
+        readonly label: "Pending";
+        readonly tone: "info";
+    };
+};
+type StatusKey = keyof typeof STATUS_VOCABULARY;
 interface StatusBadgeProps {
     status: string;
     label?: string;
@@ -2316,4 +3137,20 @@ interface SampleDataProps {
 }
 declare function SampleData({ label, children }: SampleDataProps): React.JSX.Element;
 
-export { AppShell, type AppShellHeaderProps, type AppShellProps, type AppShellSidebarProps, AreaChart, type AreaChartProps, BarChart, type BarChartProps, BarList, type BarListItem, type BarListOptions, type BarListProps, type BarListSortOrder, COMPARISON_LABELS, CategoryBar, type CategoryBarMarker, type CategoryBarProps, type ChangeDisplay, type ChartActionsOptions, type ChartAnnotation, type ChartColor, type ChartColorToken, type ChartColors, type ChartCommonProps, type ChartComparison, type ChartEmptyState, type ChartEventPayload, type ChartForecast, type ChartForecastRow, ChartFrame, type ChartFrameProps, type ChartHighlight, type ChartRootAttributes, type ChartSeriesColor, type ChartSkeletonVariant, type ChartThreshold, type ChartTone, type Comparison, type ComparisonKind, type ComparisonOptions, type ComparisonResult, DEFAULT_SAMPLE_LABEL, DELTA_NOT_COMPARABLE, DashboardCard, DashboardCardAction, type DashboardCardActionProps, DashboardCardContent, type DashboardCardContentProps, DashboardCardDescription, type DashboardCardDescriptionProps, DashboardCardFooter, type DashboardCardFooterProps, DashboardCardHeader, type DashboardCardHeaderProps, DashboardCardPreset, type DashboardCardPresetProps, type DashboardCardProps, DashboardCardSkeleton, type DashboardCardSkeletonProps, DashboardCardTitle, type DashboardCardTitleProps, DataTable, DataTableColumnVisibility, type DataTableColumnVisibilityProps, DataTableContent, type DataTableContentProps, DataTableExport, type DataTableExportProps, DataTablePagination, type DataTablePaginationProps, DataTablePreset, type DataTablePresetProps, type DataTableProps, DataTableToolbar, type DataTableToolbarProps, type DateRange, DateRangePicker, type DateRangePickerProps, DateStyle, Delta, type DeltaDirection, type DeltaProps, type DeltaSentiment, DonutChart, type DonutChartOptions, type DonutChartProps, type DonutVariant, EChart, type EChartProps, FilterBar, FilterBarActiveChips, type FilterBarActiveChipsProps, FilterBarClearButton, type FilterBarClearButtonProps, FilterBarMultiSelect, type FilterBarMultiSelectProps, FilterBarPreset, type FilterBarPresetProps, type FilterBarProps, FilterBarSelect, type FilterBarSelectProps, type FilterConfig, type FilterOption, type FilterType, type FilterValues, type FunnelStep, FunnelSteps, type FunnelStepsProps, Heatmap, type HeatmapProps, type HistoryGrain, KpiCard, type KpiCardProps, type KpiCardSource, type KpiPeriod, Legend, type LegendProps, LineChart, type LineChartProps, type MetricItem, MetricUnit, type MetricUnitProps, MetricValue, type MetricValueProps, type MetricVariant, MultiSelect, type MultiSelectProps, type NavGroup, type NavItem, type NumericKeys, PageShell, PageShellActions, type PageShellActionsProps, PageShellContent, type PageShellContentProps, PageShellDescription, type PageShellDescriptionProps, PageShellHeader, PageShellHeaderEnd, type PageShellHeaderEndProps, type PageShellHeaderProps, PageShellHeading, type PageShellHeadingProps, PageShellMeta, type PageShellMetaProps, type PageShellProps, PageShellSummary, PageShellSummaryCard, type PageShellSummaryCardProps, type PageShellSummaryProps, PageShellTitle, type PageShellTitleProps, type PeriodGrain, Placeholder, type PlaceholderProps, type Polarity, type PresetItem, ProgressCircle, type ProgressCircleProps, RECORD_MIN_POINTS, type RecordInsight, SampleBadge, type SampleBadgeProps, SampleClaim, SampleData, type SampleDataProps, ScatterChart, type ScatterChartProps, type ScatterReferenceLine, SearchableSelect, type SearchableSelectProps, SectionHeader, type SectionHeaderProps, type SegmentOption, SegmentedControl, type SegmentedControlProps, type SelectOption, type SelectOptionGroup, type SelectOptions, Sparkline, type SparklineDataPoint, type SparklineProps, type SparklineVariant, StatusBadge, type StatusBadgeProps, type TargetProgress, Tracker, type TrackerBlock, type TrackerProps, type TrendDirection, TrendIndicator, type TrendIndicatorProps, UpdatedAt, type UpdatedAtProps, ValueFormat, type ValueFormatter, WaterfallChart, type WaterfallChartProps, type WaterfallMode, comparisonBaseline, comparisonLabel, computeComparison, computeTargetProgress, defaultChangeDisplay, defaultPresets, deltaVariants, detectRecord, fillKpiTemplate, flattenOptions, formatChange, formatChangeAmount, formatRelativeTime, funnelStepsVariants, inferPeriodGrain, isGroupedOptions, metricValueVariants, pageShellSummaryCardVariants, tableToCsv, toCsv, toneForValue, useDataTable, useResolvedChartColors, useSampleMark };
+interface DraftChartProps {
+    /** The proposed chart: one card (e.g. `DashboardCardPreset`), as it would sit in the page. */
+    children: ReactElement;
+}
+/**
+ * A chart proposed to the page that nobody has accepted yet. Accepting it removes the
+ * `<DraftChart>` tags and keeps the child; removing it deletes the whole element. Both are
+ * source edits made outside the framework — this component only decides what each build shows.
+ *
+ * - `vantage build` (published dashboards): renders nothing, so viewers never see a proposal.
+ * - `vantage dev` (the editor preview): renders the child faded under the page background, and
+ *   marks the child's root element with `data-sq-draft` so the editor can find it and draw its
+ *   own controls over it. The component itself draws no buttons or text.
+ */
+declare function DraftChart({ children }: DraftChartProps): React.JSX.Element | null;
+
+export { AppShell, type AppShellHeaderProps, type AppShellProps, type AppShellSidebarProps, AreaChart, type AreaChartProps, type AttentionKind, AttentionList, type AttentionListProps, BarChart, type BarChartProps, BarList, type BarListItem, type BarListOptions, type BarListProps, type BarListSortOrder, BoxPlotChart, type BoxPlotChartProps, type BoxPlotEntry, type BoxPlotGroup, COMPARISON_LABELS, CategoryBar, type CategoryBarMarker, type CategoryBarProps, type ChangeDisplay, type ChartActionsOptions, type ChartAnnotation, type ChartColor, type ChartColorToken, type ChartColors, type ChartCommonProps, type ChartComparison, type ChartEmptyState, type ChartEventPayload, type ChartForecast, type ChartForecastRow, ChartFrame, type ChartFrameProps, type ChartHighlight, type ChartRootAttributes, type ChartSeriesColor, type ChartSkeletonVariant, type ChartThreshold, type ChartTone, type ComboAxis, ComboChart, type ComboChartProps, type ComboReferenceLine, type ComboSeries, type ComboSeriesType, type Comparison, type ComparisonKind, type ComparisonOptions, type ComparisonResult, DEFAULT_SAMPLE_LABEL, DELTA_NOT_COMPARABLE, DashboardCard, DashboardCardAction, type DashboardCardActionProps, DashboardCardContent, type DashboardCardContentProps, DashboardCardDescription, type DashboardCardDescriptionProps, DashboardCardFooter, type DashboardCardFooterProps, DashboardCardHeader, type DashboardCardHeaderProps, DashboardCardPreset, type DashboardCardPresetProps, type DashboardCardProps, DashboardCardSkeleton, type DashboardCardSkeletonProps, DashboardCardTitle, type DashboardCardTitleProps, DataTable, DataTableColumnVisibility, type DataTableColumnVisibilityProps, DataTableContent, type DataTableContentProps, DataTableExport, type DataTableExportProps, DataTablePagination, type DataTablePaginationProps, DataTablePreset, type DataTablePresetProps, type DataTableProps, DataTableToolbar, type DataTableToolbarProps, type DateRange, DateRangePicker, type DateRangePickerProps, DateStyle, Delta, type DeltaDirection, type DeltaProps, type DeltaSentiment, DonutChart, type DonutChartOptions, type DonutChartProps, type DonutVariant, DraftChart, type DraftChartProps, EChart, type EChartProps, FilledMap, type FilledMapName, type FilledMapProps, type FilledMapRegion, FilterBar, FilterBarActiveChips, type FilterBarActiveChipsProps, FilterBarAddFilter, type FilterBarAddFilterProps, FilterBarClearButton, type FilterBarClearButtonProps, FilterBarMultiSelect, type FilterBarMultiSelectProps, FilterBarPreset, type FilterBarPresetProps, type FilterBarProps, FilterBarSelect, type FilterBarSelectProps, type FilterConfig, type FilterOption, type FilterType, type FilterValues, ForecastChart, type ForecastChartProps, type ForecastComponent, type ForecastOptions, type ForecastPeriod, type FunnelStep, FunnelSteps, type FunnelStepsProps, Heatmap, type HeatmapCell, type HeatmapProps, HistogramChart, type HistogramChartProps, type HistogramThreshold, type HistoryGrain, KpiCard, type KpiCardProps, type KpiCardSource, type KpiPeriod, Legend, type LegendProps, LineChart, type LineChartProps, type MetricItem, MetricUnit, type MetricUnitProps, MetricValue, type MetricValueProps, type MetricVariant, MultiSelect, type MultiSelectProps, type NavGroup, type NavItem, type NumericKeys, PageShell, PageShellActions, type PageShellActionsProps, PageShellContent, type PageShellContentProps, PageShellDescription, type PageShellDescriptionProps, PageShellHeader, PageShellHeaderEnd, type PageShellHeaderEndProps, type PageShellHeaderProps, PageShellHeading, type PageShellHeadingProps, PageShellMeta, type PageShellMetaProps, type PageShellProps, PageShellSummary, PageShellSummaryCard, type PageShellSummaryCardProps, type PageShellSummaryProps, PageShellTitle, type PageShellTitleProps, PairedChart, type PairedChartProps, type PairedPanel, type PeriodGrain, PivotTable, type PivotTableProps, Placeholder, type PlaceholderProps, type Polarity, type PresetItem, ProgressCircle, type ProgressCircleProps, RECORD_MIN_POINTS, type RecordInsight, SampleBadge, type SampleBadgeProps, SampleClaim, SampleData, type SampleDataProps, ScatterChart, type ScatterChartProps, type ScatterPoint, type ScatterReferenceLine, type ScatterSeries, SearchableSelect, type SearchableSelectProps, SectionHeader, type SectionHeaderProps, type SegmentOption, SegmentedControl, type SegmentedControlProps, type SelectOption, type SelectOptionGroup, type SelectOptions, Sparkline, type SparklineColumnOptions, type SparklineDataPoint, type SparklinePoint, type SparklinePointKind, type SparklineProps, type SparklineVariant, StatusBadge, type StatusBadgeProps, type StatusKey, SymbolMap, type SymbolMapBasemap, type SymbolMapPoint, type SymbolMapProps, type TargetProgress, Tracker, type TrackerBlock, type TrackerProps, Treemap, type TreemapLeaf, type TreemapProps, type TrendDirection, TrendIndicator, type TrendIndicatorProps, UpdatedAt, type UpdatedAtProps, ValueFormat, type ValueFormatter, WaterfallChart, type WaterfallChartProps, type WaterfallDeltaEnds, type WaterfallKind, type WaterfallMode, type WaterfallStack, type WaterfallStep, comparisonBaseline, comparisonLabel, computeComparison, computeTargetProgress, defaultChangeDisplay, defaultPresets, deltaVariants, detectRecord, fillKpiTemplate, flattenOptions, formatChange, formatChangeAmount, formatRelativeTime, funnelStepsVariants, inferPeriodGrain, isGroupedOptions, metricValueVariants, pageShellSummaryCardVariants, tableToCsv, toCsv, toneForValue, useDataTable, useResolvedChartColors, useSampleMark };