@squadbase/vantage 0.6.2-dev1.9365dcd → 0.6.2-dev1.9d7130b

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-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 { 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';
@@ -33,7 +35,7 @@ interface PageShellHeaderProps extends HTMLAttributes<HTMLDivElement> {
     updatedAtVariant?: UpdatedAtProps["variant"];
     /** IANA time zone for the absolute time of `updatedAt`. Defaults to the runtime's zone. */
     timeZone?: string;
-    /** Where the data comes from. Shown as a chip "出典：○○" on the second row. */
+    /** Where the data comes from. Shown as a chip "Source: ○○" (ja: "出典：○○") on the second row. */
     source?: string;
     /** The period the data covers. Shown as a chip "2026/9/23〜10/20" on the second row. */
     period?: {
@@ -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.
@@ -772,9 +532,10 @@ declare const EChart: React.ForwardRefExoticComponent<EChartProps & React.RefAtt
  * the baseline is a non-zero number; small moves inside the neutral band read
  * as flat, and polarity decides whether up is good or bad.
  *
- * Labels follow Japanese business usage and come from the grain of the period:
- * a monthly KPI compares "前月比" / "前年同月比", a quarterly one "前四半期比" /
- * "前年同期比". Without a grain the label is the generic "前期比".
+ * Labels come from the grain of the period, in the locale's language (`<html lang>` unless a
+ * `locale` is passed): a monthly KPI compares "vs. prior month" / "vs. same month last year"
+ * (ja: "前月比" / "前年同月比"), a quarterly one "前四半期比" / "前年同期比" in ja. Without a
+ * grain the label is the generic "vs. prior period" (ja: "前期比").
  *
  * A running total of a period still in progress (年初来・月初来 = YTD / MTD) sets
  * `toDate: true`: a `prior-year` baseline is then the same stretch of the prior year,
@@ -815,18 +576,24 @@ type Comparison = (ComparisonBase & {
     /** The badge's full name: `"昨日比"` / `"先週の同じ曜日比"`. The previous-actual line drops one trailing "比" ("昨日 617"). */
     label: string;
 });
-/** Labels used when the grain is unknown. A `custom` comparison always brings its own `label`. */
+/**
+ * Labels used when the grain is unknown, in English (the fallback language). A `custom` comparison always brings
+ * its own `label`. The parts pick the language from `<html lang>` (`comparisonLabel`): ja reads "前期比" / "前年同期比" / "目標比".
+ */
 declare const COMPARISON_LABELS: Record<Exclude<ComparisonKind, "custom">, string>;
 /**
- * What the previous value is called: "前月" / "前年同月" / "目標"; with a `label`, that label minus one trailing "比" ("昨日比" → "昨日").
- * `toDate` (a running total such as YTD) turns a `prior-year` baseline into "前年同期" whatever the grain.
+ * What the previous value is called: "prior month" / "same month last year" / "target" (ja: "前月" / "前年同月" / "目標");
+ * with a `label`, that label minus its comparison word ("昨日比" → "昨日", "vs. yesterday" → "yesterday").
+ * `toDate` (a running total such as YTD) turns a `prior-year` baseline into "same period last year" (ja: "前年同期") whatever the grain.
+ * `locale` picks the language; default the page's (`<html lang>`).
  */
-declare function comparisonBaseline(vs: ComparisonKind, grain?: PeriodGrain, label?: string, toDate?: boolean): string;
+declare function comparisonBaseline(vs: ComparisonKind, grain?: PeriodGrain, label?: string, toDate?: boolean, locale?: string): string;
 /**
- * The comparison label: "前月比" for `("prior-period", "month")`, "前期比" without a grain; a given `label` as is.
- * A running total (`toDate`) against the prior year is "前年同期比", not "前年比".
+ * The comparison label: "vs. prior month" (ja: "前月比") for `("prior-period", "month")`, "vs. prior period" (ja: "前期比")
+ * without a grain; a given `label` as is. A running total (`toDate`) against the prior year is "vs. same period last year"
+ * (ja: "前年同期比"), not "vs. prior year" (ja: "前年比"). `locale` picks the language; default the page's (`<html lang>`).
  */
-declare function comparisonLabel(vs: ComparisonKind, grain?: PeriodGrain, label?: string, toDate?: boolean): string;
+declare function comparisonLabel(vs: ComparisonKind, grain?: PeriodGrain, label?: string, toDate?: boolean, locale?: string): string;
 type DeltaDirection = "up" | "down" | "flat" | "none";
 type DeltaSentiment = "positive" | "negative" | "neutral";
 interface ComparisonResult {
@@ -845,6 +612,8 @@ interface ComparisonOptions {
     polarity?: Polarity;
     /** Absolute ratio below which the change reads as flat (0.01 = 1%). Default 0.01. */
     neutralBand?: number;
+    /** Locale of the derived `label`. Default the page's (`<html lang>`). */
+    locale?: string;
 }
 declare function computeComparison(current: number | null | undefined, comparison: Comparison, options?: ComparisonOptions): ComparisonResult;
 /**
@@ -2001,7 +1770,7 @@ interface DataTableExportProps {
      * <DataTableExport scope="page" />
      */
     scope?: CsvScope;
-    /** ボタンの文言。既定 `"CSV を書き出す"`。 */
+    /** ボタンの文言。既定はページの言語で `"CSV を書き出す"`（英語は `"Export CSV"`）。 */
     children?: ReactNode;
     className?: string;
 }
@@ -2062,13 +1831,15 @@ declare function toCsv(header: string[], rows: CsvCell[][], options?: {
 }): string;
 /**
  * 表の現在の状態から CSV を作る。行は画面と同じ並べ替え・絞り込み後の順、列は表示中の列のみ。
+ * `"display"` の書式のロケールは `locale`（既定はページのロケール、`<html lang>`）。
  *
  * @example
  * const csv = tableToCsv(table, { values: "raw", scope: "page" })
  */
-declare function tableToCsv<TData>(table: Table<TData>, { values, scope }?: {
+declare function tableToCsv<TData>(table: Table<TData>, { values, scope, locale: localeArg }?: {
     values?: CsvValues;
     scope?: CsvScope;
+    locale?: string;
 }): string;
 /** toolbar に置く CSV 書き出しボタン。`useDataTable()` の table から画面と同じ順・同じ集合を書き出す。 */
 declare function DataTableExport({ fileName, values, scope, children, className, }: DataTableExportProps): React.JSX.Element;
@@ -2127,7 +1898,7 @@ declare namespace FilterBarActiveChips {
     var displayName: string;
 }
 interface FilterBarClearButtonProps {
-    /** Override the button label. Defaults to "クリア". */
+    /** Override the button label. Defaults to "Clear" (ja: "クリア"). */
     label?: string;
     className?: string;
 }
@@ -2148,7 +1919,11 @@ declare namespace FilterBarPreset {
     var displayName: string;
 }
 
-/** 既定のプリセット（英語・4 月始まり）。`locale` / `fiscalYearStartMonth` を変えるなら `createDatePresets` か DateRangePicker の同名 props。 */
+/**
+ * フォールバック（`en-US`：英語・1 月始まり・日曜始まり）のプリセット。DateRangePicker は `presets` を渡さなければ
+ * ページのロケールからプリセットを作るので、これを渡す必要はない。`locale` / `fiscalYearStartMonth` を変えるなら
+ * `createDatePresets` か DateRangePicker の同名 props。
+ */
 declare const defaultPresets: PresetItem[];
 interface DateRangePickerProps {
     /**
@@ -2174,16 +1949,16 @@ interface DateRangePickerProps {
     presets?: PresetItem[];
     showPresets?: boolean;
     /**
-     * プリセットのラベルとカレンダーの月名・曜日の言語。`ja*` なら日本語、それ以外は英語。既定 `"en-US"`（英語）。
-     * 他部品の既定は ja-JP だが、この部品は従来のプリセットが英語だったので既存の見た目を保つため英語を既定にしている。
+     * プリセットのラベル・日付の書式・カレンダーの月名と曜日・週の始まりのロケール。`ja*` なら日本語、それ以外は英語。
+     * 既定はページのロケール（`<html lang>`、無ければ `"en-US"`）。
      *
      * @example
      * <DateRangePicker locale="ja-JP" />
      */
     locale?: string;
     /**
-     * 年度の開始月（1-12）。「今年度」「前年度」と、年度基準の「今四半期」「前四半期」の区切りになる。既定 `4`（4 月始まり）。
-     * 範囲外・整数でない値は 4 として扱う。
+     * 年度の開始月（1-12）。「今年度」「前年度」と、年度基準の「今四半期」「前四半期」の区切りになる。
+     * 既定はロケールで決まる（ja は `4`、それ以外は `1`）。範囲外・整数でない値はその既定として扱う。
      *
      * @example
      * <DateRangePicker fiscalYearStartMonth={1} />
@@ -2311,8 +2086,9 @@ declare const RECORD_MIN_POINTS = 6;
 /**
  * The latest point is a record when it beats every earlier finite point:
  * strictly highest for higher-is-better, strictly lowest for lower-is-better.
+ * `locale` picks the language of `label` ("Highest in 12 months" / "過去 12 か月で最高"); default the page's (`<html lang>`).
  */
-declare function detectRecord(history: ReadonlyArray<number | null | undefined> | null | undefined, grain?: PeriodGrain, polarity?: Polarity): RecordInsight | null;
+declare function detectRecord(history: ReadonlyArray<number | null | undefined> | null | undefined, grain?: PeriodGrain, polarity?: Polarity, locale?: string): RecordInsight | null;
 
 interface KpiCardSource {
     /** Period the data covers (e.g. "2023-04 以降"). ISO year-months / dates in it are written by the card ("2023年4月 以降"). */
@@ -2337,11 +2113,11 @@ interface KpiCardProps extends Omit<ComponentProps<"div">, "children"> {
     value: number | null | undefined;
     /**
      * Value format, also used for previous / target / remaining. Default `"compact"`.
-     * `"currency"` is JPY in 万・億; `"percent"` takes a ratio (0.021 → 2.1%) and
+     * `"currency"` is JPY in 万・億 on a ja page (USD in K・M・B otherwise); `"percent"` takes a ratio (0.021 → 2.1%) and
      * switches the delta to points. See `formatValue` for the full table.
      */
     format?: ValueFormat;
-    /** Default `"ja-JP"`. */
+    /** Locale of the numbers and the built-in wording. Default: the page's (`<html lang>`, else `"en-US"`). */
     locale?: string;
     /**
      * What the value is compared against; drives the delta (tier 3) and previous line (tier 4).
@@ -2361,7 +2137,9 @@ interface KpiCardProps extends Omit<ComponentProps<"div">, "children"> {
     provisional?: boolean | {
         label?: string;
     };
-    /** Whether a rise is good. Default `"higher-is-better"`. `"neutral"` never colours the change and skips the target and record logic. */
+    /** Which direction is good: `"up"` (default) or `"down"` (churn, error rate). Wins over `polarity`. */
+    betterWhen?: "up" | "down";
+    /** @deprecated Older name of `betterWhen` (`"higher-is-better"` / `"lower-is-better"`). `"neutral"` (never colours the change, skips the target and record logic) is only reachable here. `betterWhen` wins if both are given. */
     polarity?: Polarity;
     /** `"relative"` ("+12.4%"), `"points"` ("-0.5pt") or `"difference"` ("+¥530万", in `format`). Default: points for a `percent` format, else relative. */
     change?: ChangeDisplay;
@@ -2374,7 +2152,7 @@ interface KpiCardProps extends Omit<ComponentProps<"div">, "children"> {
     /**
      * Target for the current period. Under the value it adds a 6px bar (actual, the pace
      * projection, a tick at the target) and one line "目標の 49%・このペースなら 98%"
-     * (the projection only while `period` is in progress). With `polarity="lower-is-better"`
+     * (the projection only while `period` is in progress). With `betterWhen="down"`
      * or a rate target (points) there is no bar: "目標 … まであと …" in the footer.
      */
     target?: number;
@@ -2437,7 +2215,7 @@ interface KpiCardProps extends Omit<ComponentProps<"div">, "children"> {
  */
 declare function fillKpiTemplate(template: string, values: Readonly<Record<string, string | null | undefined>>): string;
 declare function fillKpiTemplate(template: string, values: Readonly<Record<string, string | null | undefined>>, fallback: string | null): string | null;
-declare function KpiCard({ label, value, format, locale, comparison: comparisonProp, comparisons, provisional, polarity, change, neutralBand, showPrevious, summary, target, targetLabel, targetDisplay, period, history, historyGrain, showHistory, source, updatedAt, updatedAtDisplay, timeZone, now, isLoading, size, className, ...props }: KpiCardProps): React.JSX.Element;
+declare function KpiCard({ label, value, format, locale: localeProp, comparison: comparisonProp, comparisons, provisional, betterWhen, polarity: polarityProp, change, neutralBand, showPrevious, summary, target, targetLabel, targetDisplay, period, history, historyGrain, showHistory, source, updatedAt, updatedAtDisplay, timeZone, now, isLoading, size, className, ...props }: KpiCardProps): React.JSX.Element;
 
 declare const deltaVariants: (props?: ({
     variant?: "inline" | "badge" | null | undefined;
@@ -2448,7 +2226,9 @@ interface DeltaProps extends Omit<HTMLAttributes<HTMLSpanElement>, "children">,
     value: number | null | undefined;
     /** What the value is compared against. Required so the delta always carries its label. */
     comparison: Comparison;
-    /** Whether a rise is good. Default `"higher-is-better"`. */
+    /** Which direction is good: `"up"` (default) or `"down"` (churn, error rate). Wins over `polarity`. */
+    betterWhen?: "up" | "down";
+    /** @deprecated Older name of `betterWhen` (`"higher-is-better"` / `"lower-is-better"`); `"neutral"` is only reachable here. `betterWhen` wins if both are given. */
     polarity?: Polarity;
     /** Absolute ratio below which the change reads as flat (0.01 = 1%). Default 0.01. */
     neutralBand?: number;
@@ -2464,7 +2244,7 @@ interface DeltaProps extends Omit<HTMLAttributes<HTMLSpanElement>, "children">,
      * 同じカード群で桁がばらつかないよう、全部に同じ値を渡す。未指定は 1 桁（"+14.0%"）。`"points"` は未指定のとき `format.digits` に従う。
      */
     digits?: number;
-    /** Locale for the change. Default `"ja-JP"`. */
+    /** Locale for the change and its label. Default: the page's (`<html lang>`, else `"en-US"`). */
     locale?: string;
     /** Show the comparison label ("前月比") after the change. Default true. */
     showLabel?: boolean;
@@ -2507,7 +2287,11 @@ interface PlaceholderProps extends HTMLAttributes<HTMLSpanElement> {
 }
 declare const Placeholder: React.ForwardRefExoticComponent<PlaceholderProps & React.RefAttributes<HTMLSpanElement>>;
 
-declare const DEFAULT_SAMPLE_LABEL = "\u898B\u672C\u306E\u5024";
+/**
+ * The mark's wording in English (the fallback language). Without a `label`, the mark follows the page's
+ * language (`<html lang>`): ja reads「見本の値」.
+ */
+declare const DEFAULT_SAMPLE_LABEL: string;
 interface SampleState {
     label: string;
 }
@@ -2521,15 +2305,15 @@ declare function SampleClaim({ children }: {
     children?: ReactNode;
 }): React.JSX.Element;
 interface SampleBadgeProps extends HTMLAttributes<HTMLSpanElement> {
-    /** 印の文言。既定「見本の値」。 */
+    /** 印の文言。既定はページの言語で「見本の値」（英語は "Sample data"）。 */
     label?: string;
 }
 declare function SampleBadge({ label, className, ...props }: SampleBadgeProps): React.JSX.Element;
 interface SampleDataProps {
-    /** 印の文言。既定「見本の値」。 */
+    /** 印の文言。既定はページの言語で「見本の値」（英語は "Sample data"）。 */
     label?: string;
     children?: ReactNode;
 }
 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,6 +1,9 @@
-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';
-import '../chunk-PDOBHMUQ.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-77CISBMG.js';
+export { EChart, useResolvedChartColors } from '../chunk-EG4PX726.js';
+export { Sparkline } from '../chunk-2IAPIOPS.js';
+export { DEFAULT_LOCALE, EMPTY_VALUE, MINUS_SIGN, formatDate, formatDateRange, formatDatesInText, formatDelta, formatKind, formatPoints, formatValue, toValueFormatter } from '../chunk-3RJEOP3J.js';
+import '../chunk-QNOX7WLZ.js';
+import '../chunk-ROHNXP7J.js';
 import '../chunk-U736PVHY.js';
 //# sourceMappingURL=index.js.map
 //# sourceMappingURL=index.js.map

package/dist/delta-text-CbrOaW83.d.ts

@@ -0,0 +1,17 @@
+import * as React from 'react';
+import { V as ValueFormat } from './format-DihQkL1N.js';
+
+interface DeltaTextProps {
+    /** The change itself; its direction comes from the sign. `null` shows "—". */
+    value: number | null;
+    format?: ValueFormat;
+    /** Which way is good. Default `"up"`. */
+    betterWhen?: "up" | "down";
+    /** Name of the comparison, e.g. "前月比". Printed before the change; omit to print only the change. */
+    comparisonLabel?: string;
+    /** Locale of the value and the screen-reader text. Default the page's (`<html lang>`). */
+    locale?: string;
+}
+declare function DeltaText({ value, format, betterWhen, comparisonLabel, locale: localeProp }: DeltaTextProps): React.JSX.Element;
+
+export { DeltaText as D, type DeltaTextProps as a };

package/dist/{dev-4XEDTELV.js → dev-O42JFQ64.js}

@@ -1,8 +1,8 @@
-import { runDiagnostics } from './chunk-7DZGJQ3P.js';
-import './chunk-JKLLFVEU.js';
-import { vantagePlugin } from './chunk-2ICNHUG6.js';
-import './chunk-WAMZWZJB.js';
-import './chunk-CEXAQQ5W.js';
+import { runDiagnostics } from './chunk-PJ4SPXHS.js';
+import './chunk-UWSQUHX6.js';
+import { vantagePlugin } from './chunk-SDJTTMLK.js';
+import './chunk-SHZM3EXB.js';
+import './chunk-S5MDTHH7.js';
 import { scanProject, timedAsync } from './chunk-RNTDBX6S.js';
 import './chunk-46QI6GFC.js';
 import './chunk-B7LLBNLV.js';
@@ -77,5 +77,5 @@ async function dev(root, args) {
 }
 
 export { dev };
-//# sourceMappingURL=dev-4XEDTELV.js.map
-//# sourceMappingURL=dev-4XEDTELV.js.map
+//# sourceMappingURL=dev-O42JFQ64.js.map
+//# sourceMappingURL=dev-O42JFQ64.js.map

package/dist/{dev-4XEDTELV.js.map → dev-O42JFQ64.js.map}

@@ -1 +1 @@
-{"version":3,"sources":["../src/cli/dev.ts"],"names":[],"mappings":"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","file":"dev-4XEDTELV.js","sourcesContent":["import { createServer, loadEnv } from \"vite\"\nimport { runDiagnostics } from \"../core/diagnostics\"\nimport { timedAsync } from \"../core/profile\"\nimport { scanProject } from \"../core/scan\"\nimport { vantagePlugin } from \"../vite/index\"\nimport {\n  applyApiBaseUrlFlag,\n  log,\n  printDiagnostics,\n  reportPortInUse,\n  resolveDraftPreview,\n  resolveHmrOverlay,\n  resolveHostOptions,\n  resolvePortOptions,\n  type ParsedArgs,\n} from \"./util\"\n\n/** `vantage dev` — start the dev server with HMR and the optional API server. */\nexport async function dev(root: string, args: ParsedArgs): Promise<number> {\n  const model = scanProject(root)\n  const errors = runDiagnostics(root, model).filter((d) => d.severity === \"error\")\n  if (errors.length) {\n    printDiagnostics(errors)\n    log.error(\"Fix the errors above before starting the dev server.\")\n    return 1\n  }\n\n  const mode = \"development\"\n  applyApiBaseUrlFlag(args)\n  const env = { ...process.env, ...loadEnv(mode, root, \"\") }\n  const ports = resolvePortOptions(args.flags, 5173)\n  if (!ports.ok) {\n    log.error(ports.error)\n    return 1\n  }\n  const { port, strictPort } = ports\n  const hosts = resolveHostOptions(args.flags)\n  if (!hosts.ok) {\n    log.error(hosts.error)\n    return 1\n  }\n  const overlay = resolveHmrOverlay(args.flags)\n\n  const server = await timedAsync(\"vite:createServer\", () =>\n    createServer({\n      configFile: false,\n      root,\n      mode,\n      // The model was just scanned for diagnostics; hand it over so the plugin\n      // does not walk the project again.\n      plugins: [vantagePlugin({ root, env, model, draftPreview: resolveDraftPreview(args.flags) })],\n      // `host` / `allowedHosts` are only present when asked for, and `hmr` is\n      // left alone unless the overlay is being turned off, so Vite's own\n      // defaults (host, port, protocol) keep applying.\n      server: {\n        port,\n        strictPort,\n        ...hosts.options,\n        ...(overlay ? {} : { hmr: { overlay: false } }),\n      },\n      clearScreen: false,\n    }),\n  )\n\n  try {\n    await timedAsync(\"vite:listen\", () => server.listen())\n  } catch (err) {\n    await server.close().catch(() => {})\n    if (reportPortInUse(err, port, strictPort)) return 1\n    throw err\n  }\n  log.brand(\"dev server ready\")\n  server.printUrls()\n  if (model.hasServer) log.info(\"  \" + \"server/api enabled\")\n\n  const shutdown = async () => {\n    await server.close()\n    process.exit(0)\n  }\n  process.on(\"SIGINT\", shutdown)\n  process.on(\"SIGTERM\", shutdown)\n\n  // Keep the process alive; the listening server owns the lifecycle.\n  return new Promise<number>(() => {})\n}\n"]}
+{"version":3,"sources":["../src/cli/dev.ts"],"names":[],"mappings":"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","file":"dev-O42JFQ64.js","sourcesContent":["import { createServer, loadEnv } from \"vite\"\nimport { runDiagnostics } from \"../core/diagnostics\"\nimport { timedAsync } from \"../core/profile\"\nimport { scanProject } from \"../core/scan\"\nimport { vantagePlugin } from \"../vite/index\"\nimport {\n  applyApiBaseUrlFlag,\n  log,\n  printDiagnostics,\n  reportPortInUse,\n  resolveDraftPreview,\n  resolveHmrOverlay,\n  resolveHostOptions,\n  resolvePortOptions,\n  type ParsedArgs,\n} from \"./util\"\n\n/** `vantage dev` — start the dev server with HMR and the optional API server. */\nexport async function dev(root: string, args: ParsedArgs): Promise<number> {\n  const model = scanProject(root)\n  const errors = runDiagnostics(root, model).filter((d) => d.severity === \"error\")\n  if (errors.length) {\n    printDiagnostics(errors)\n    log.error(\"Fix the errors above before starting the dev server.\")\n    return 1\n  }\n\n  const mode = \"development\"\n  applyApiBaseUrlFlag(args)\n  const env = { ...process.env, ...loadEnv(mode, root, \"\") }\n  const ports = resolvePortOptions(args.flags, 5173)\n  if (!ports.ok) {\n    log.error(ports.error)\n    return 1\n  }\n  const { port, strictPort } = ports\n  const hosts = resolveHostOptions(args.flags)\n  if (!hosts.ok) {\n    log.error(hosts.error)\n    return 1\n  }\n  const overlay = resolveHmrOverlay(args.flags)\n\n  const server = await timedAsync(\"vite:createServer\", () =>\n    createServer({\n      configFile: false,\n      root,\n      mode,\n      // The model was just scanned for diagnostics; hand it over so the plugin\n      // does not walk the project again.\n      plugins: [vantagePlugin({ root, env, model, draftPreview: resolveDraftPreview(args.flags) })],\n      // `host` / `allowedHosts` are only present when asked for, and `hmr` is\n      // left alone unless the overlay is being turned off, so Vite's own\n      // defaults (host, port, protocol) keep applying.\n      server: {\n        port,\n        strictPort,\n        ...hosts.options,\n        ...(overlay ? {} : { hmr: { overlay: false } }),\n      },\n      clearScreen: false,\n    }),\n  )\n\n  try {\n    await timedAsync(\"vite:listen\", () => server.listen())\n  } catch (err) {\n    await server.close().catch(() => {})\n    if (reportPortInUse(err, port, strictPort)) return 1\n    throw err\n  }\n  log.brand(\"dev server ready\")\n  server.printUrls()\n  if (model.hasServer) log.info(\"  \" + \"server/api enabled\")\n\n  const shutdown = async () => {\n    await server.close()\n    process.exit(0)\n  }\n  process.on(\"SIGINT\", shutdown)\n  process.on(\"SIGTERM\", shutdown)\n\n  // Keep the process alive; the listening server owns the lifecycle.\n  return new Promise<number>(() => {})\n}\n"]}