@squadbase/vantage 0.6.2-dev1.5aae04e → 0.6.2-dev1.81c1bbe

package/dist/components/index.d.ts

@@ -4,6 +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-U0cQl069.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-U0cQl069.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';
@@ -87,248 +89,6 @@ interface PageShellContentProps extends HTMLAttributes<HTMLDivElement> {
 }
 declare const PageShellContent: React.ForwardRefExoticComponent<PageShellContentProps & React.RefAttributes<HTMLDivElement>>;
 
-/**
- * Locale-aware number formatting shared by KPI cards, tables and charts. All
- * shortening is delegated to `Intl.NumberFormat` (`notation: "compact"`); this
- * module never hard-codes unit thresholds or unit strings.
- *
- * | `format`                                   | input        | ja-JP output   |
- * |--------------------------------------------|--------------|----------------|
- * | `"compact"` (default)                      | `48_200_000` | `4,820万`      |
- * | `"number"`                                 | `1234.567`   | `1,234.57`     |
- * | `"currency"` (JPY, compact)                | `48_200_000` | `¥4,820万`     |
- * | `{ type: "currency", notation: "standard" }` | `48_200_000` | `¥48,200,000`  |
- * | `{ type: "currency", currency: "USD" }`    | `1234.5`     | `$1,234.5`     |
- * | `"percent"` — pass a **ratio**             | `0.124`      | `12.4%`        |
- * | `{ type: "percent", digits: 0 }`           | `0.124`      | `12%`          |
- * | `"multiple"`                               | `1.5`        | `1.5×`         |
- * | `{ type: "number", unit: "件" }`           | `48_210`     | `48,210件`     |
- * | `{ type: "compact", unit: "人" }`          | `12_345`     | `1.2万人`      |
- * | `"duration"` — pass **seconds**            | `12_000`     | `3時間20分`    |
- * | `{ type: "duration", durationUnit: "minute" }` | `2160`   | `1.5日`        |
- *
- * - `percent` takes a ratio (0.124 → 12.4%). Passing 12.4 renders 1,240%. The fraction
- *   digits are **fixed**, never trimmed (`PERCENT_DIGITS` = 1: 0.14 → "14.0%", never "14%"
- *   beside "11.9%"). Pass `digits` in the format to share another count across cards.
- * - A minus sign is always U+2212 (`MINUS_SIGN`, "−1,234" / "−5.0%"), never the hyphen-minus.
- * - `currency` defaults to JPY and to compact notation (万・億 in ja); pass
- *   `notation: "standard"` for every digit (tables, invoices). In ja-JP the yen
- *   sign is the half-width `¥`.
- * - `unit` is a counter appended right after the number, with no space
- *   ("48,210件", "1.2万人"), for `number` / `compact` / `currency`. It is
- *   ignored for `percent` and `duration`, and for `multiple` it replaces the
- *   default `×` ("2.7倍"). Do not write it into a `valueFormatter` by hand.
- * - Charts take the same `format` a KpiCard takes (`format="currency"`).
- *   `toValueFormatter(format)` turns it into a function for places that need
- *   one (a `valueFormatter`, table cells).
- * - Missing values (null / undefined / NaN) render as `—` (`EMPTY_VALUE`).
- * - Dates go through `formatDate` (`Intl.DateTimeFormat`): `"date"` → `2026/10/20`,
- *   `"datetime"` → `2026/10/20 14:30`, `"year-month"` → `2026年10月`, `"month"` → `10月`,
- *   `"year"` → `2026年`.
- * - A period goes through `formatDateRange`: `2026/9/23〜10/20` (same year drops the end year),
- *   `2025/12/20〜2026/1/18` across years; month and day are not zero-padded.
- */
-/**
- * The kind of number a value is. Pick by what the number means, not by how
- * long it is: `currency` for money, `percent` for a ratio, `multiple` for a
- * factor ("1.5×"), `duration` for a length of time ("3時間20分"), `number` for
- * exact counts in tables, `compact` (default) for large headline counts (万・億).
- */
-type FormatKind = "number" | "compact" | "currency" | "percent" | "multiple" | "duration";
-/** The unit a `duration` value is measured in. */
-type DurationUnit = "second" | "minute" | "hour" | "day";
-/**
- * How to display a number: a `FormatKind` alone, or an object for digits,
- * currency, notation and a counter. The same value is accepted by KpiCard,
- * Delta, the charts (`format`) and `formatValue`.
- *
- * @example
- * "currency"                                   // ¥4,820万
- * { type: "currency", notation: "standard" }   // ¥48,200,000
- * { type: "percent", digits: 1 }               // 2.0%
- * { type: "number", unit: "件" }               // 48,210件
- */
-type ValueFormat = FormatKind | {
-    type: FormatKind;
-    /** Fixed number of fraction digits. */
-    digits?: number;
-    /** ISO 4217 code for `currency`. Default `"JPY"`. */
-    currency?: string;
-    /** `currency` only: `"compact"` (default, 万・億) or `"standard"` (every digit). */
-    notation?: "compact" | "standard";
-    /** Counter appended after the number, e.g. `"件"`, `"人"`. Ignored for `percent` and `duration`. For `multiple` it replaces the default `×` (`"倍"` → `2.7倍`). */
-    unit?: string;
-    /** 値をこの数で割ってから整形する。例: `divisor: 100`（セント → ドル）。0 と非有限は無視。 */
-    divisor?: number;
-    /** `duration` only: the unit the value is in. Default `"second"`. Reads as "45秒" / "12分" / "3時間20分" / "1.5日" (`digits` sets the fraction digits of days). */
-    durationUnit?: DurationUnit;
-};
-/** Locale used when none is passed. Every function here takes a `locale` to override it. */
-declare const DEFAULT_LOCALE = "ja-JP";
-/** Shown in place of a missing value (null / undefined / NaN). */
-declare const EMPTY_VALUE = "\u2014";
-/** The minus sign every formatter writes (U+2212), so a negative never mixes with a hyphen-minus. */
-declare const MINUS_SIGN = "\u2212";
-/** Extra options for `formatValue`. */
-interface FormatValueOptions {
-    /** `"auto"` (default) signs negatives only; `"exceptZero"` also writes `+` on positives (for differences). */
-    signDisplay?: "auto" | "exceptZero";
-    /** Round to this many significant digits (e.g. 3 for an estimate: 79,653,985 → 7,970万). */
-    significantDigits?: number;
-}
-/**
- * The kind of a format, whether it was given as a string or an object. Use it
- * to branch on the meaning of a metric (e.g. a `percent` metric compares in
- * points) without unpacking `ValueFormat` yourself.
- *
- * @param format - The format as a KpiCard / chart takes it. `undefined` means the default.
- * @returns The `FormatKind`; `"compact"` when `format` is omitted.
- *
- * @example
- * formatKind("percent")                                // "percent"
- * formatKind({ type: "currency", notation: "standard" }) // "currency"
- * formatKind(undefined)                                // "compact"
- */
-declare function formatKind(format: ValueFormat | undefined): FormatKind;
-/**
- * Format a number for display — KPI values, table cells, chart labels and
- * sentences built from data (titles, summaries). See the table at the top of
- * this module.
- *
- * @param value - The number. `null` / `undefined` / `NaN` render as `—`.
- *   For `percent`, a ratio (0.124 means 12.4%).
- * @param format - How to display it. Default `"compact"`.
- * @param locale - BCP 47 locale. Default `"ja-JP"`.
- * @param options - `signDisplay` and `significantDigits` (rounding for estimates).
- * @returns The display string. In ja-JP the yen sign is the half-width `¥`.
- *
- * @example
- * formatValue(48_200_000, "currency")                              // "¥4,820万"
- * formatValue(48_200_000, { type: "currency", notation: "standard" }) // "¥48,200,000"
- * formatValue(0.021, "percent")                                    // "2.1%"
- * formatValue(0.124, "percent", "ja-JP", { signDisplay: "exceptZero" }) // "+12.4%"
- * formatValue(79_653_985, "currency", "ja-JP", { significantDigits: 3 }) // "¥7,970万"
- * formatValue(48_210, { type: "number", unit: "件" })              // "48,210件"
- * formatValue(1.5, "multiple")                                     // "1.5×"
- * formatValue(null)                                                // "—"
- */
-declare function formatValue(value: number | null | undefined, format?: ValueFormat, locale?: string, options?: FormatValueOptions): string;
-/**
- * Like `formatValue`, but always signed (except zero) — for a difference
- * between two values ("+¥530万", "−120件"). Use `formatPoints` instead for a
- * difference between two rates.
- *
- * @param value - The difference (current − previous). Missing values render as `—`.
- * @param format - Format of the metric itself. Default `"compact"`.
- * @param locale - BCP 47 locale. Default `"ja-JP"`.
- * @returns The signed display string; zero has no sign.
- *
- * @example
- * formatDelta(5_300_000, "currency")                 // "+¥530万"
- * formatDelta(-120, { type: "number", unit: "件" })  // "−120件"
- * formatDelta(0.031, "percent")                      // "+3.1%"
- * formatDelta(0, "currency")                         // "¥0"
- */
-declare function formatDelta(value: number | null | undefined, format?: ValueFormat, locale?: string): string;
-/**
- * A difference between two rates in percentage points, always signed:
- * `formatPoints(0.021 - 0.026)` → `"−0.5pt"`. Use it instead of a relative
- * change for rate metrics (churn, conversion), where "−19.2%" reads as a drop
- * of nineteen points. `signDisplay: "never"` drops the sign ("あと 0.5pt").
- *
- * @param difference - The difference of two **ratios** (0.021 − 0.026). Missing values render as `—`.
- * @param locale - BCP 47 locale. Default `"ja-JP"`.
- * @param options - `digits`: fixed fraction digits (default `PERCENT_DIGITS` = 1, so "0.0pt" / "+0.5pt"); `signDisplay`:
- *   `"exceptZero"` (default) or `"never"` when the sentence already says the direction.
- * @returns The difference in points with the `pt` suffix.
- *
- * @example
- * formatPoints(0.021 - 0.026)                                   // "−0.5pt"
- * formatPoints(0.031 - 0.026)                                   // "+0.5pt"
- * formatPoints(0.02 - 0.015, "ja-JP", { signDisplay: "never" }) // "0.5pt"（「目標まであと 0.5pt」）
- */
-declare function formatPoints(difference: number | null | undefined, locale?: string, options?: {
-    digits?: number;
-    signDisplay?: "exceptZero" | "never";
-}): string;
-/**
- * Binds a format and locale into a single-argument formatter, for a chart
- * `valueFormatter` or a table cell: `valueFormatter={toValueFormatter("currency")}`.
- * Prefer passing `format` to the chart directly; this is for APIs that only
- * take a function.
- *
- * @param format - How to display each value. Default `"compact"`.
- * @param locale - BCP 47 locale. Default `"ja-JP"`.
- * @returns `(value) => string`, rendering missing values as `—`.
- *
- * @example
- * const yen = toValueFormatter("currency")
- * yen(48_200_000) // "¥4,820万"
- * yen(null)       // "—"
- * const count = toValueFormatter({ type: "number", unit: "件" })
- * count(48_210)   // "48,210件"（表のセル）
- */
-declare function toValueFormatter(format?: ValueFormat, locale?: string): (value: number | null | undefined) => string;
-/**
- * 日付の書式。何を表す日付かで選ぶ: 日単位は `"date"`、時刻まで要るなら `"datetime"`、
- * 月次の集計は `"year-month"`（年をまたぐ軸）か `"month"`（同じ年の中の軸）、年次は `"year"`。
- */
-type DateStyle = "date" | "datetime" | "month" | "year-month" | "year";
-/** `formatDate` の追加オプション。 */
-interface FormatDateOptions {
-    /**
-     * IANA のタイムゾーン名（例: `"Asia/Tokyo"`）。既定は実行環境のタイムゾーン。
-     * サーバーとブラウザで描画が食い違う（SSR）なら固定する。日付だけの文字列（`"2026-10-20"`）には効かず、常にその暦日のまま出す。
-     */
-    timeZone?: string;
-}
-/**
- * 日付を表示用の文字列にする。表のセル・タイトル・文に埋める日付に使い、`toLocaleString` や手組みの
- * `getMonth() + 1` は使わない。
- *
- * @param value - `Date`、エポックミリ秒、または日付文字列（`"2026-10-20"`、ISO 8601）。`null` / `undefined` / 解釈できない値は `—`。
- * @param style - 何を表す日付か。既定 `"date"`。
- * @param locale - BCP 47 ロケール。既定 `"ja-JP"`。
- * @param options - `timeZone`。
- * @returns 表示文字列。
- *
- * @example
- * formatDate("2026-10-20")                         // "2026/10/20"
- * formatDate(new Date("2026-10-20T05:30:00Z"), "datetime", "ja-JP", { timeZone: "Asia/Tokyo" }) // "2026/10/20 14:30"
- * formatDate("2026-10-01", "year-month")           // "2026年10月"
- * formatDate("2026-10-01", "month")                // "10月"
- * formatDate(null)                                 // "—"
- */
-declare function formatDate(value: Date | string | number | null | undefined, style?: DateStyle, locale?: string, options?: FormatDateOptions): string;
-/** `formatDateRange` のオプション。 */
-interface FormatDateRangeOptions extends FormatDateOptions {
-    /** BCP 47 ロケール。既定 `"ja-JP"`。 */
-    locale?: string;
-}
-/**
- * 期間を「2026/9/23〜10/20」の形にする。同じ年なら終了側の年を省き、年をまたぐときは両方に付ける。
- * 月日はゼロ詰めしない。区切りは日本語で「〜」、それ以外のロケールでは「 – 」。始まりと終わりが同じ日なら 1 日だけ出す。
- *
- * @param start - 期間の最初の日（`Date`、エポックミリ秒、日付文字列）。`"2026-09-23"` のような日付だけの文字列はその暦日のまま出す。
- * @param end - 期間の最後の日。
- * @param options - `locale` と `timeZone`。
- * @returns 表示文字列。どちらかが解釈できなければ `—`。
- *
- * @example
- * formatDateRange("2026-09-23", "2026-10-20")  // "2026/9/23〜10/20"
- * formatDateRange("2025-12-20", "2026-01-18")  // "2025/12/20〜2026/1/18"
- */
-declare function formatDateRange(start: Date | string | number | null | undefined, end: Date | string | number | null | undefined, options?: FormatDateRangeOptions): string;
-/**
- * 文中の ISO の年月・日付（`2023-04`、`2026-10-20`）を `formatDate` の書式に置き換える。期間や出典の注記のように、
- * 利用者が文字列で渡す文に日付が混ざるときの表示用（`"2023-04 以降"` → `"2023年4月 以降"`）。日付でない数字は触らない。
- *
- * @param text - 日付を含みうる文。
- * @param locale - BCP 47 ロケール。既定 `"ja-JP"`。
- * @returns ISO の年月は `"year-month"`、年月日は `"date"` で整形した文。
- */
-declare function formatDatesInText(text: string, locale?: string): string;
-
 /**
  * Shared data shapes for the composite dashboard components. Kept in one place
  * so filters, metrics and date pickers agree on the same vocabulary.
@@ -2532,4 +2292,4 @@ 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_LOCALE, 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, type DateStyle, Delta, type DeltaDirection, type DeltaProps, type DeltaSentiment, DonutChart, type DonutChartOptions, type DonutChartProps, type DonutVariant, EChart, type EChartProps, EMPTY_VALUE, 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 FormatDateOptions, type FormatKind, type FormatValueOptions, type FunnelStep, FunnelSteps, type FunnelStepsProps, Heatmap, type HeatmapProps, type HistoryGrain, KpiCard, type KpiCardProps, type KpiCardSource, type KpiPeriod, Legend, type LegendProps, LineChart, type LineChartProps, MINUS_SIGN, 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, type ValueFormat, type ValueFormatter, WaterfallChart, type WaterfallChartProps, type WaterfallMode, comparisonBaseline, comparisonLabel, computeComparison, computeTargetProgress, defaultChangeDisplay, defaultPresets, deltaVariants, detectRecord, fillKpiTemplate, flattenOptions, formatChange, formatChangeAmount, formatDate, formatDateRange, formatDatesInText, formatDelta, formatKind, formatPoints, formatRelativeTime, formatValue, funnelStepsVariants, inferPeriodGrain, isGroupedOptions, metricValueVariants, pageShellSummaryCardVariants, tableToCsv, toCsv, toValueFormatter, toneForValue, useDataTable, useResolvedChartColors, useSampleMark };
+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 };

package/dist/components/index.js

@@ -1,5 +1,8 @@
-export { AppShell, AreaChart, BarChart, BarList, COMPARISON_LABELS, CategoryBar, ChartFrame, DEFAULT_LOCALE, DEFAULT_SAMPLE_LABEL, DELTA_NOT_COMPARABLE, DashboardCard, DashboardCardAction, DashboardCardContent, DashboardCardDescription, DashboardCardFooter, DashboardCardHeader, DashboardCardPreset, DashboardCardSkeleton, DashboardCardTitle, DataTable, DataTableColumnVisibility, DataTableContent, DataTableExport, DataTablePagination, DataTablePreset, DataTableToolbar, DateRangePicker, Delta, DonutChart, EChart, EMPTY_VALUE, FilterBar, FilterBarActiveChips, FilterBarClearButton, FilterBarMultiSelect, FilterBarPreset, FilterBarSelect, FunnelSteps, Heatmap, KpiCard, Legend, LineChart, MINUS_SIGN, MetricUnit, MetricValue, MultiSelect, PageShell, PageShellActions, PageShellContent, PageShellDescription, PageShellHeader, PageShellHeaderEnd, PageShellHeading, PageShellMeta, PageShellSummary, PageShellSummaryCard, PageShellTitle, Placeholder, ProgressCircle, RECORD_MIN_POINTS, SampleBadge, SampleClaim, SampleData, ScatterChart, SearchableSelect, SectionHeader, SegmentedControl, Sparkline, StatusBadge, Tracker, TrendIndicator, UpdatedAt, WaterfallChart, comparisonBaseline, comparisonLabel, computeComparison, computeTargetProgress, defaultChangeDisplay, defaultPresets, deltaVariants, detectRecord, fillKpiTemplate, flattenOptions, formatChange, formatChangeAmount, formatDate, formatDateRange, formatDatesInText, formatDelta, formatKind, formatPoints, formatRelativeTime, formatValue, funnelStepsVariants, inferPeriodGrain, isGroupedOptions, metricValueVariants, pageShellSummaryCardVariants, tableToCsv, toCsv, toValueFormatter, toneForValue, useDataTable, useResolvedChartColors, useSampleMark } from '../chunk-HKSVYMYJ.js';
-import '../chunk-XPQSTZUU.js';
+export { AppShell, AreaChart, BarChart, BarList, COMPARISON_LABELS, CategoryBar, ChartFrame, DEFAULT_SAMPLE_LABEL, DELTA_NOT_COMPARABLE, DashboardCard, DashboardCardAction, DashboardCardContent, DashboardCardDescription, DashboardCardFooter, DashboardCardHeader, DashboardCardPreset, DashboardCardSkeleton, DashboardCardTitle, DataTable, DataTableColumnVisibility, DataTableContent, DataTableExport, DataTablePagination, DataTablePreset, DataTableToolbar, DateRangePicker, Delta, DonutChart, FilterBar, FilterBarActiveChips, FilterBarClearButton, FilterBarMultiSelect, FilterBarPreset, FilterBarSelect, FunnelSteps, Heatmap, KpiCard, Legend, LineChart, MetricUnit, MetricValue, MultiSelect, PageShell, PageShellActions, PageShellContent, PageShellDescription, PageShellHeader, PageShellHeaderEnd, PageShellHeading, PageShellMeta, PageShellSummary, PageShellSummaryCard, PageShellTitle, Placeholder, ProgressCircle, RECORD_MIN_POINTS, SampleBadge, SampleClaim, SampleData, ScatterChart, SearchableSelect, SectionHeader, SegmentedControl, StatusBadge, Tracker, TrendIndicator, UpdatedAt, WaterfallChart, comparisonBaseline, comparisonLabel, computeComparison, computeTargetProgress, defaultChangeDisplay, defaultPresets, deltaVariants, detectRecord, fillKpiTemplate, flattenOptions, formatChange, formatChangeAmount, formatRelativeTime, funnelStepsVariants, inferPeriodGrain, isGroupedOptions, metricValueVariants, pageShellSummaryCardVariants, tableToCsv, toCsv, toneForValue, useDataTable, useSampleMark } from '../chunk-RU6WKEOG.js';
+export { EChart, useResolvedChartColors } from '../chunk-JXFCSF3K.js';
+export { Sparkline } from '../chunk-2IAPIOPS.js';
+export { DEFAULT_LOCALE, EMPTY_VALUE, MINUS_SIGN, formatDate, formatDateRange, formatDatesInText, formatDelta, formatKind, formatPoints, formatValue, toValueFormatter } from '../chunk-57GHR5LN.js';
+import '../chunk-7S52M2SL.js';
 import '../chunk-PDOBHMUQ.js';
 import '../chunk-U736PVHY.js';
 //# sourceMappingURL=index.js.map

package/dist/doc/index.d.ts

@@ -1,5 +1,6 @@
 import * as React from 'react';
-import { HTMLAttributes } from 'react';
+import { HTMLAttributes, ReactNode } from 'react';
+import { V as ValueFormat } from '../format-U0cQl069.js';
 
 /**
  * Per-document token overrides. Anything left out falls through to `--doc-*`
@@ -40,4 +41,195 @@ interface DocumentProps extends HTMLAttributes<HTMLElement> {
  */
 declare const Document: React.ForwardRefExoticComponent<DocumentProps & React.RefAttributes<HTMLElement>>;
 
-export { Document, type DocumentProps, type DocumentTheme };
+type DocActionPriority = "high" | "medium" | "low";
+interface DocActionItem {
+    action: ReactNode;
+    owner?: string;
+    /** Due date as written, e.g. "2026-11-15" or "11 月末". */
+    due?: string;
+    /** What we expect to change, e.g. "解約率 −0.5pt". */
+    impact?: string;
+    priority?: DocActionPriority;
+}
+interface DocActionItemsProps {
+    /** Heading text. Default "推奨する対応". */
+    title?: string;
+    /** `2` directly under the document, `3` inside another section. Default 2. */
+    headingLevel?: 2 | 3;
+    items: DocActionItem[];
+    variant?: "table" | "asks";
+}
+declare function DocActionItems({ title, headingLevel, items, variant }: DocActionItemsProps): React.JSX.Element;
+
+type DocCalloutKind = "note" | "insight" | "warning" | "decision";
+interface DocCalloutProps {
+    kind?: DocCalloutKind;
+    /** Heading of the box, one short line. Default: the kind's word. */
+    title?: string;
+    children: ReactNode;
+}
+declare function DocCallout({ kind, title, children }: DocCalloutProps): React.JSX.Element;
+
+type DocTableCell = string | number | null | undefined;
+type DocTableRow = Record<string, DocTableCell>;
+interface DocTableColumn {
+    key: string;
+    label: string;
+    /** Format of a numeric column. Without it, numbers use a plain thousands format. */
+    format?: ValueFormat;
+    /** Default: right for a column of numbers, left otherwise. */
+    align?: "left" | "right" | "center";
+}
+interface DocDataTableProps {
+    /** Table title, as a caption above the table. */
+    title?: string;
+    /** Unit or scale, e.g. "単位: 百万円". */
+    unit?: string;
+    columns: DocTableColumn[];
+    rows: DocTableRow[];
+    /** The total row, keyed like `rows`. */
+    total?: DocTableRow;
+    /** Row indexes to set in semibold. */
+    highlightRows?: number[];
+    footnotes?: {
+        mark: string;
+        text: string;
+    }[];
+    source?: string;
+    /** When the data was taken: a date only, e.g. "2026-10-03". "データ時点" is added here. */
+    asOf?: string;
+}
+declare function DocDataTable({ title, unit, columns, rows, total, highlightRows, footnotes, source, asOf }: DocDataTableProps): React.JSX.Element;
+
+interface DocSummaryMetric {
+    label: string;
+    value: number | null;
+    format?: ValueFormat;
+    /** Overrides the shown value (e.g. "約 5,400 万円"). */
+    display?: string;
+    /** The change from the comparison; direction comes from its sign. Omit for no comparison. */
+    delta?: {
+        value: number;
+        format?: ValueFormat;
+    };
+    /** Name of the comparison, e.g. "前月比". Default "前期比". */
+    comparisonLabel?: string;
+    /** Which way is good. Default `"up"`. */
+    betterWhen?: "up" | "down";
+}
+interface DocExecutiveSummaryProps {
+    /** Heading text. Default "要旨". */
+    title?: string;
+    /** `2` directly under the document, `3` inside another section. Default 2. */
+    headingLevel?: 2 | 3;
+    /** The verdict in one sentence. */
+    conclusion: ReactNode;
+    /** 3–5 supporting points, most important first. */
+    points: ReactNode[];
+    /** Up to 3 headline numbers; any beyond are ignored. */
+    metrics?: DocSummaryMetric[];
+}
+declare function DocExecutiveSummary({ title, headingLevel, conclusion, points, metrics, }: DocExecutiveSummaryProps): React.JSX.Element;
+
+interface DocFigureProps {
+    /** The finding, as a sentence. */
+    title: string;
+    /** Unit or scale, e.g. "単位: 百万円". */
+    unit?: string;
+    /** Figure number; shown as "図 N" in the caption. */
+    number?: number;
+    /** Where the data comes from. */
+    source?: string;
+    /** When the data was taken: a date only, e.g. "2026-10-03". */
+    asOf?: string;
+    /** Footnotes, one per line. */
+    notes?: string[];
+    /** The chart. */
+    children: ReactNode;
+}
+declare function DocFigure({ title, unit, number, source, asOf, notes, children }: DocFigureProps): React.JSX.Element;
+
+interface DocFindingMetric {
+    label: string;
+    value: number | null;
+    format?: ValueFormat;
+    /** Overrides the shown value. */
+    display?: string;
+    /** The change from the comparison; direction comes from its sign. */
+    delta?: {
+        value: number;
+        format?: ValueFormat;
+    };
+    /** Name of the comparison, e.g. "前月比". Default "前期比". */
+    comparisonLabel?: string;
+    /** Which way is good. Default `"up"`. */
+    betterWhen?: "up" | "down";
+}
+interface DocFinding {
+    /** The conclusion, as a sentence. */
+    headline: string;
+    evidence: ReactNode;
+    metric?: DocFindingMetric;
+}
+interface DocKeyFindingsProps {
+    /** Heading text. Default "主要な発見". */
+    title?: string;
+    /** `2` directly under the document, `3` inside another section. Default 2. */
+    headingLevel?: 2 | 3;
+    /** 3–5 findings, most important first. */
+    findings: DocFinding[];
+}
+declare function DocKeyFindings({ title, headingLevel, findings }: DocKeyFindingsProps): React.JSX.Element;
+
+interface DocScorecardMetric {
+    label: string;
+    value: number | null;
+    format?: ValueFormat;
+    /** Overrides the shown value. */
+    display?: string;
+    /** The change from the comparison; direction comes from its sign. */
+    delta?: {
+        value: number;
+        format?: ValueFormat;
+    };
+    /** Name of the comparison, e.g. "前年同期比". Default "前期比". */
+    comparisonLabel?: string;
+    /** Which way is good. Default `"up"`. */
+    betterWhen?: "up" | "down";
+    /** The target for the period, in the same `format` as `value`. */
+    target?: number;
+    /** One series over time, oldest first; the last one is the current value. */
+    trend?: {
+        x: string;
+        y: number;
+    }[];
+}
+interface DocKpiScorecardProps {
+    /** Heading text. Default "主要指標". */
+    title?: string;
+    /** `2` directly under the document, `3` inside another section. Default 2. */
+    headingLevel?: 2 | 3;
+    metrics: DocScorecardMetric[];
+    variant?: "table" | "grid";
+    /** When the numbers were taken: a date only, e.g. "2026-10-03". "データ時点" is added here. */
+    asOf?: string;
+    source?: string;
+}
+declare function DocKpiScorecard({ title, headingLevel, metrics, variant, asOf, source, }: DocKpiScorecardProps): React.JSX.Element;
+
+interface DocReportHeaderProps {
+    /** The document title (h1). State the subject and the period, not a slogan. */
+    title: string;
+    /** One line under the title, e.g. who the report is for. */
+    subtitle?: ReactNode;
+    /** The period the numbers cover, e.g. "2026 年 9 月" or "2026-07-01 〜 2026-09-30". */
+    period?: string;
+    /** When the data was taken: a date only, e.g. "2026-10-03". Shown under "データ時点". */
+    asOf?: string;
+    author?: string;
+    /** Where the numbers come from, e.g. "受注管理システム、会計システム". */
+    source?: string;
+}
+declare function DocReportHeader({ title, subtitle, period, asOf, author, source }: DocReportHeaderProps): React.JSX.Element;
+
+export { type DocActionItem, DocActionItems, type DocActionItemsProps, type DocActionPriority, DocCallout, type DocCalloutKind, type DocCalloutProps, DocDataTable, type DocDataTableProps, DocExecutiveSummary, type DocExecutiveSummaryProps, DocFigure, type DocFigureProps, type DocFinding, type DocFindingMetric, DocKeyFindings, type DocKeyFindingsProps, DocKpiScorecard, type DocKpiScorecardProps, DocReportHeader, type DocReportHeaderProps, type DocScorecardMetric, type DocSummaryMetric, type DocTableCell, type DocTableColumn, type DocTableRow, Document, type DocumentProps, type DocumentTheme };