@squadbase/vantage 0.6.2-dev1.54bde93 → 0.6.2-dev1.5c79ef5

package/dist/{chunk-PDOBHMUQ.js → chunk-ROHNXP7J.js}

@@ -2,6 +2,7 @@ import { cn } from './chunk-U736PVHY.js';
 import { Button as Button$1 } from '@base-ui/react/button';
 import { cva } from 'class-variance-authority';
 import { jsx } from 'react/jsx-runtime';
+import { useSyncExternalStore } from 'react';
 
 // @squadbase/vantage — generated build. Do not edit.
 var buttonVariants = cva(
@@ -49,6 +50,74 @@ function Button({
   );
 }
 
-export { Button, buttonVariants };
-//# sourceMappingURL=chunk-PDOBHMUQ.js.map
-//# sourceMappingURL=chunk-PDOBHMUQ.js.map
+// ../squadkit/registry/lib/locale.ts
+var FALLBACK_LOCALE = "en-US";
+function uiLanguage(locale) {
+  return typeof locale === "string" && locale.trim().toLowerCase().startsWith("ja") ? "ja" : "en";
+}
+function normalizeLocale(tag) {
+  const value = tag?.trim();
+  if (!value) return FALLBACK_LOCALE;
+  try {
+    return Intl.getCanonicalLocales(value)[0] ?? FALLBACK_LOCALE;
+  } catch {
+    return FALLBACK_LOCALE;
+  }
+}
+function documentLocale() {
+  if (typeof document === "undefined") return FALLBACK_LOCALE;
+  return normalizeLocale(document.documentElement?.getAttribute("lang"));
+}
+function resolveLocale(locale) {
+  return locale || documentLocale();
+}
+function defaultCurrency(locale) {
+  return uiLanguage(resolveLocale(locale)) === "ja" ? "JPY" : "USD";
+}
+function defaultFiscalYearStartMonth(locale) {
+  return uiLanguage(resolveLocale(locale)) === "ja" ? 4 : 1;
+}
+var SUNDAY_FIRST = /* @__PURE__ */ new Set(["en", "en-US", "en-CA"]);
+function weekStartsOn(locale) {
+  const tag = normalizeLocale(resolveLocale(locale));
+  if (uiLanguage(tag) === "ja") return 1;
+  try {
+    const info = new Intl.Locale(tag);
+    const firstDay = info.getWeekInfo?.().firstDay ?? info.weekInfo?.firstDay;
+    if (typeof firstDay === "number" && firstDay >= 1 && firstDay <= 7) return firstDay % 7;
+  } catch {
+  }
+  return SUNDAY_FIRST.has(tag) ? 0 : 1;
+}
+var listeners = /* @__PURE__ */ new Set();
+var observer = null;
+function subscribe(onChange) {
+  if (typeof document === "undefined" || typeof MutationObserver === "undefined") return () => {
+  };
+  listeners.add(onChange);
+  if (!observer) {
+    observer = new MutationObserver(() => {
+      for (const listener of [...listeners]) listener();
+    });
+    observer.observe(document.documentElement, { attributes: true, attributeFilter: ["lang"] });
+  }
+  return () => {
+    listeners.delete(onChange);
+    if (listeners.size === 0 && observer) {
+      observer.disconnect();
+      observer = null;
+    }
+  };
+}
+var serverLocale = () => FALLBACK_LOCALE;
+function useDocumentLocale() {
+  return useSyncExternalStore(subscribe, documentLocale, serverLocale);
+}
+function useLocale(locale) {
+  const page = useDocumentLocale();
+  return locale || page;
+}
+
+export { Button, FALLBACK_LOCALE, buttonVariants, defaultCurrency, defaultFiscalYearStartMonth, resolveLocale, uiLanguage, useLocale, weekStartsOn };
+//# sourceMappingURL=chunk-ROHNXP7J.js.map
+//# sourceMappingURL=chunk-ROHNXP7J.js.map

package/dist/chunk-ROHNXP7J.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../squadkit/registry/ui/button.tsx","../../squadkit/registry/lib/locale.ts","../../squadkit/registry/hooks/use-locale.ts"],"names":["ButtonPrimitive"],"mappings":"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","file":"chunk-ROHNXP7J.js","sourcesContent":["\"use client\"\n\nimport { Button as ButtonPrimitive } from \"@base-ui/react/button\"\nimport { cva, type VariantProps } from \"class-variance-authority\"\n\nimport { cn } from \"../lib/utils\"\n\nconst buttonVariants = cva(\n  \"group/button inline-flex shrink-0 items-center justify-center rounded-lg border border-transparent bg-clip-padding text-sm font-medium whitespace-nowrap transition-all outline-none select-none focus-visible:border-ring focus-visible:ring-3 focus-visible:ring-ring/50 active:not-aria-[haspopup]:translate-y-px disabled:pointer-events-none disabled:opacity-50 aria-invalid:border-destructive aria-invalid:ring-3 aria-invalid:ring-destructive/20 dark:aria-invalid:border-destructive/50 dark:aria-invalid:ring-destructive/40 [&_svg]:pointer-events-none [&_svg]:shrink-0 [&_svg:not([class*='size-'])]:size-4\",\n  {\n    variants: {\n      variant: {\n        default: \"bg-primary text-primary-foreground hover:bg-primary/80\",\n        outline:\n          \"border-border bg-background hover:bg-muted hover:text-foreground aria-expanded:bg-muted aria-expanded:text-foreground dark:border-input dark:bg-input/30 dark:hover:bg-input/50\",\n        secondary:\n          \"bg-secondary text-secondary-foreground hover:bg-[color-mix(in_oklch,var(--secondary),var(--foreground)_5%)] aria-expanded:bg-secondary aria-expanded:text-secondary-foreground\",\n        ghost:\n          \"hover:bg-muted hover:text-foreground aria-expanded:bg-muted aria-expanded:text-foreground dark:hover:bg-muted/50\",\n        destructive:\n          \"bg-destructive/10 text-destructive hover:bg-destructive/20 focus-visible:border-destructive/40 focus-visible:ring-destructive/20 dark:bg-destructive/20 dark:hover:bg-destructive/30 dark:focus-visible:ring-destructive/40\",\n        link: \"text-primary underline-offset-4 hover:underline\",\n      },\n      size: {\n        default:\n          \"h-8 gap-1.5 px-2.5 has-data-[icon=inline-end]:pr-2 has-data-[icon=inline-start]:pl-2\",\n        xs: \"h-6 gap-1 rounded-[min(var(--radius-md),10px)] px-2 text-xs in-data-[slot=button-group]:rounded-lg has-data-[icon=inline-end]:pr-1.5 has-data-[icon=inline-start]:pl-1.5 [&_svg:not([class*='size-'])]:size-3\",\n        sm: \"h-7 gap-1 rounded-[min(var(--radius-md),12px)] px-2.5 text-[0.8rem] in-data-[slot=button-group]:rounded-lg has-data-[icon=inline-end]:pr-1.5 has-data-[icon=inline-start]:pl-1.5 [&_svg:not([class*='size-'])]:size-3.5\",\n        lg: \"h-9 gap-1.5 px-2.5 has-data-[icon=inline-end]:pr-2 has-data-[icon=inline-start]:pl-2\",\n        icon: \"size-8\",\n        \"icon-xs\":\n          \"size-6 rounded-[min(var(--radius-md),10px)] in-data-[slot=button-group]:rounded-lg [&_svg:not([class*='size-'])]:size-3\",\n        \"icon-sm\":\n          \"size-7 rounded-[min(var(--radius-md),12px)] in-data-[slot=button-group]:rounded-lg\",\n        \"icon-lg\": \"size-9\",\n      },\n    },\n    defaultVariants: {\n      variant: \"default\",\n      size: \"default\",\n    },\n  }\n)\n\nfunction Button({\n  className,\n  variant = \"default\",\n  size = \"default\",\n  ...props\n}: ButtonPrimitive.Props & VariantProps<typeof buttonVariants>) {\n  return (\n    <ButtonPrimitive\n      data-slot=\"button\"\n      className={cn(buttonVariants({ variant, size, className }))}\n      {...props}\n    />\n  )\n}\n\nexport { Button, buttonVariants }\n","/**\n * The display language of the parts and the defaults that follow it.\n *\n * The language comes from `<html lang>`: a tag starting with `ja` reads Japanese, anything else English.\n * Without a usable `lang` (missing, invalid, or no `document` — SSR, Node) the locale is `FALLBACK_LOCALE`\n * (`en-US`). A `locale` passed explicitly (a prop, an argument) always wins.\n *\n * Parts read the locale through `useLocale` (`hooks/use-locale`) and pass it down; the pure helpers here\n * and in `format` / `comparison` / `chart-*` take it as an argument and fall back to `documentLocale()`.\n */\n\n/** The language of the built-in wording: Japanese or English. */\nexport type UiLanguage = \"ja\" | \"en\"\n\n/** The locale used when `<html lang>` gives none (and on the server). */\nexport const FALLBACK_LOCALE = \"en-US\"\n\n/** `\"ja\"` when `locale` starts with `ja` (`ja`, `ja-JP`), else `\"en\"`. A missing locale is `\"en\"`. */\nexport function uiLanguage(locale: string | null | undefined): UiLanguage {\n  return typeof locale === \"string\" && locale.trim().toLowerCase().startsWith(\"ja\") ? \"ja\" : \"en\"\n}\n\n/** A BCP 47 tag in its canonical form (`en-gb` → `en-GB`), or `FALLBACK_LOCALE` when it is empty or invalid. */\nexport function normalizeLocale(tag: string | null | undefined): string {\n  const value = tag?.trim()\n  if (!value) return FALLBACK_LOCALE\n  try {\n    return Intl.getCanonicalLocales(value)[0] ?? FALLBACK_LOCALE\n  } catch {\n    return FALLBACK_LOCALE\n  }\n}\n\n/**\n * The locale of the page: `document.documentElement.lang`, canonicalized. `FALLBACK_LOCALE` when it is empty or\n * invalid, or there is no `document`. Parts read it through `useLocale`, never while rendering.\n */\nexport function documentLocale(): string {\n  if (typeof document === \"undefined\") return FALLBACK_LOCALE\n  return normalizeLocale(document.documentElement?.getAttribute(\"lang\"))\n}\n\n/** `locale` when given, else the page's locale (`documentLocale()`). */\nexport function resolveLocale(locale?: string | null): string {\n  return locale || documentLocale()\n}\n\n/** Picks the wording table of the locale's language. */\nexport function pickLocale<T>(table: { ja: T; en: T }, locale?: string | null): T {\n  return table[uiLanguage(resolveLocale(locale))]\n}\n\n/** The currency `format=\"currency\"` uses without a `currency`: JPY for Japanese, USD otherwise. */\nexport function defaultCurrency(locale?: string | null): string {\n  return uiLanguage(resolveLocale(locale)) === \"ja\" ? \"JPY\" : \"USD\"\n}\n\n/** The month a fiscal year starts in (1–12) when none is given: April for Japanese, January otherwise. */\nexport function defaultFiscalYearStartMonth(locale?: string | null): number {\n  return uiLanguage(resolveLocale(locale)) === \"ja\" ? 4 : 1\n}\n\n/** A day of the week, 0 = Sunday … 6 = Saturday (the `Date#getDay` / date-fns numbering). */\nexport type WeekDay = 0 | 1 | 2 | 3 | 4 | 5 | 6\n\n/** Locales whose week starts on Sunday when the runtime has no week data. */\nconst SUNDAY_FIRST = new Set([\"en\", \"en-US\", \"en-CA\"])\n\n/**\n * The first day of the week: Monday for Japanese; otherwise the locale's convention from `Intl.Locale`\n * (`en-US` Sunday, `en-GB` Monday). Without week data in the runtime: Sunday for `en` / `en-US` / `en-CA`,\n * Monday for the rest.\n */\nexport function weekStartsOn(locale?: string | null): WeekDay {\n  const tag = normalizeLocale(resolveLocale(locale))\n  if (uiLanguage(tag) === \"ja\") return 1\n  try {\n    const info = new Intl.Locale(tag) as Intl.Locale & {\n      getWeekInfo?: () => { firstDay: number }\n      weekInfo?: { firstDay: number }\n    }\n    const firstDay = info.getWeekInfo?.().firstDay ?? info.weekInfo?.firstDay\n    if (typeof firstDay === \"number\" && firstDay >= 1 && firstDay <= 7) return (firstDay % 7) as WeekDay\n  } catch {\n    // Fall through to the table below.\n  }\n  return SUNDAY_FIRST.has(tag) ? 0 : 1\n}\n","import { useSyncExternalStore } from \"react\"\n\nimport { documentLocale, FALLBACK_LOCALE } from \"../lib/locale\"\n\nconst listeners = new Set<() => void>()\nlet observer: MutationObserver | null = null\n\n/** One observer on `<html lang>` for every subscribed part. */\nfunction subscribe(onChange: () => void): () => void {\n  if (typeof document === \"undefined\" || typeof MutationObserver === \"undefined\") return () => {}\n  listeners.add(onChange)\n  if (!observer) {\n    observer = new MutationObserver(() => {\n      for (const listener of [...listeners]) listener()\n    })\n    observer.observe(document.documentElement, { attributes: true, attributeFilter: [\"lang\"] })\n  }\n  return () => {\n    listeners.delete(onChange)\n    if (listeners.size === 0 && observer) {\n      observer.disconnect()\n      observer = null\n    }\n  }\n}\n\nconst serverLocale = () => FALLBACK_LOCALE\n\n/**\n * The page's locale (`<html lang>`), following changes made while the page runs. On the server and during\n * hydration it is `FALLBACK_LOCALE` (`en-US`), so the markup matches; it switches right after.\n */\nexport function useDocumentLocale(): string {\n  return useSyncExternalStore(subscribe, documentLocale, serverLocale)\n}\n\n/** The locale a part renders in: its `locale` prop when given, else the page's (`useDocumentLocale`). */\nexport function useLocale(locale?: string | null): string {\n  const page = useDocumentLocale()\n  return locale || page\n}\n"]}

package/dist/{chunk-6OTTGAPO.js → chunk-TRMHNMMZ.js}

@@ -1,9 +1,26 @@
-import { formatDelta } from './chunk-57GHR5LN.js';
+import { formatDelta } from './chunk-3RJEOP3J.js';
+import { useLocale, uiLanguage } from './chunk-ROHNXP7J.js';
 import { jsxs, Fragment, jsx } from 'react/jsx-runtime';
 
 // @squadbase/vantage — generated build. Do not edit.
 var MUTED = { color: "var(--doc-muted)" };
-function DeltaText({ value, format, betterWhen = "up", comparisonLabel }) {
+var TEXT = {
+  ja: {
+    up: "\u5897",
+    down: "\u6E1B",
+    flat: "\u6A2A\u3070\u3044",
+    label: (word, text, good) => `${word}\u3001${text}${good === void 0 ? "" : good ? "\u3001\u6539\u5584" : "\u3001\u60AA\u5316"}`
+  },
+  en: {
+    up: "Up",
+    down: "Down",
+    flat: "Flat",
+    label: (word, text, good) => `${word}, ${text}${good === void 0 ? "" : good ? ", improved" : ", worsened"}`
+  }
+};
+function DeltaText({ value, format, betterWhen = "up", comparisonLabel, locale: localeProp }) {
+  const locale = useLocale(localeProp);
+  const t = TEXT[uiLanguage(locale)];
   const label = comparisonLabel ? /* @__PURE__ */ jsxs("span", { style: MUTED, children: [
     comparisonLabel,
     " "
@@ -16,10 +33,10 @@ function DeltaText({ value, format, betterWhen = "up", comparisonLabel }) {
   }
   const dir = value > 0 ? "up" : value < 0 ? "down" : "flat";
   const mark = dir === "up" ? "\u25B2" : dir === "down" ? "\u25BC" : "\u2192";
-  const word = dir === "up" ? "\u5897" : dir === "down" ? "\u6E1B" : "\u6A2A\u3070\u3044";
+  const word = t[dir];
   const good = dir === "flat" ? void 0 : dir === "up" === (betterWhen === "up");
   const tone = good === void 0 ? void 0 : good ? "text-positive" : "text-negative";
-  const text = formatDelta(value, format);
+  const text = formatDelta(value, format, locale);
   return /* @__PURE__ */ jsxs(Fragment, { children: [
     label,
     /* @__PURE__ */ jsxs(
@@ -28,7 +45,7 @@ function DeltaText({ value, format, betterWhen = "up", comparisonLabel }) {
         "data-slot": "delta-text",
         className: tone,
         style: tone ? void 0 : MUTED,
-        "aria-label": `${word}\u3001${text}${good === void 0 ? "" : good ? "\u3001\u6539\u5584" : "\u3001\u60AA\u5316"}`,
+        "aria-label": t.label(word, text, good),
         children: [
           mark,
           " ",
@@ -40,5 +57,5 @@ function DeltaText({ value, format, betterWhen = "up", comparisonLabel }) {
 }
 
 export { DeltaText };
-//# sourceMappingURL=chunk-6OTTGAPO.js.map
-//# sourceMappingURL=chunk-6OTTGAPO.js.map
+//# sourceMappingURL=chunk-TRMHNMMZ.js.map
+//# sourceMappingURL=chunk-TRMHNMMZ.js.map

package/dist/chunk-TRMHNMMZ.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../squadkit/registry/blocks/delta-text/delta-text.tsx"],"names":[],"mappings":";;;;;AAgCA,IAAM,KAAA,GAAQ,EAAE,KAAA,EAAO,kBAAA,EAAmB;AAE1C,IAAM,IAAA,GAAO;AAAA,EACX,EAAA,EAAI;AAAA,IACF,EAAA,EAAI,QAAA;AAAA,IACJ,IAAA,EAAM,QAAA;AAAA,IACN,IAAA,EAAM,oBAAA;AAAA,IACN,KAAA,EAAO,CAAC,IAAA,EAAc,IAAA,EAAc,SAClC,CAAA,EAAG,IAAI,CAAA,MAAA,EAAI,IAAI,GAAG,IAAA,KAAS,MAAA,GAAY,EAAA,GAAK,IAAA,GAAO,uBAAQ,oBAAK,CAAA;AAAA,GACpE;AAAA,EACA,EAAA,EAAI;AAAA,IACF,EAAA,EAAI,IAAA;AAAA,IACJ,IAAA,EAAM,MAAA;AAAA,IACN,IAAA,EAAM,MAAA;AAAA,IACN,KAAA,EAAO,CAAC,IAAA,EAAc,IAAA,EAAc,SAClC,CAAA,EAAG,IAAI,CAAA,EAAA,EAAK,IAAI,GAAG,IAAA,KAAS,MAAA,GAAY,EAAA,GAAK,IAAA,GAAO,eAAe,YAAY,CAAA;AAAA;AAErF,CAAA;AAEO,SAAS,SAAA,CAAU,EAAE,KAAA,EAAO,MAAA,EAAQ,aAAa,IAAA,EAAM,eAAA,EAAiB,MAAA,EAAQ,UAAA,EAAW,EAAmB;AACnH,EAAA,MAAM,MAAA,GAAS,UAAU,UAAU,CAAA;AACnC,EAAA,MAAM,CAAA,GAAI,IAAA,CAAK,UAAA,CAAW,MAAM,CAAC,CAAA;AACjC,EAAA,MAAM,KAAA,GAAQ,eAAA,mBAAkB,IAAA,CAAC,MAAA,EAAA,EAAK,OAAO,KAAA,EAAQ,QAAA,EAAA;AAAA,IAAA,eAAA;AAAA,IAAgB;AAAA,GAAA,EAAC,CAAA,GAAU,IAAA;AAChF,EAAA,IAAI,UAAU,IAAA,EAAM;AAClB,IAAA,uBACE,IAAA,CAAA,QAAA,EAAA,EACG,QAAA,EAAA;AAAA,MAAA,KAAA;AAAA,0BACA,MAAA,EAAA,EAAK,WAAA,EAAU,YAAA,EAAa,KAAA,EAAO,OAAO,QAAA,EAAA,QAAA,EAE3C;AAAA,KAAA,EACF,CAAA;AAAA,EAEJ;AACA,EAAA,MAAM,MAAM,KAAA,GAAQ,CAAA,GAAI,IAAA,GAAO,KAAA,GAAQ,IAAI,MAAA,GAAS,MAAA;AACpD,EAAA,MAAM,OAAO,GAAA,KAAQ,IAAA,GAAO,QAAA,GAAM,GAAA,KAAQ,SAAS,QAAA,GAAM,QAAA;AACzD,EAAA,MAAM,IAAA,GAAO,EAAE,GAAG,CAAA;AAClB,EAAA,MAAM,OAAO,GAAA,KAAQ,MAAA,GAAS,MAAA,GAAa,GAAA,KAAQ,UAAW,UAAA,KAAe,IAAA,CAAA;AAC7E,EAAA,MAAM,IAAA,GAAO,IAAA,KAAS,MAAA,GAAY,MAAA,GAAY,OAAO,eAAA,GAAkB,eAAA;AACvE,EAAA,MAAM,IAAA,GAAO,WAAA,CAAY,KAAA,EAAO,MAAA,EAAQ,MAAM,CAAA;AAC9C,EAAA,uBACE,IAAA,CAAA,QAAA,EAAA,EACG,QAAA,EAAA;AAAA,IAAA,KAAA;AAAA,oBACD,IAAA;AAAA,MAAC,MAAA;AAAA,MAAA;AAAA,QACC,WAAA,EAAU,YAAA;AAAA,QACV,SAAA,EAAW,IAAA;AAAA,QACX,KAAA,EAAO,OAAO,MAAA,GAAY,KAAA;AAAA,QAC1B,YAAA,EAAY,CAAA,CAAE,KAAA,CAAM,IAAA,EAAM,MAAM,IAAI,CAAA;AAAA,QAEnC,QAAA,EAAA;AAAA,UAAA,IAAA;AAAA,UAAK,GAAA;AAAA,UAAE;AAAA;AAAA;AAAA;AACV,GAAA,EACF,CAAA;AAEJ","file":"chunk-TRMHNMMZ.js","sourcesContent":["\"use client\"\n\n/**\n * delta-text — a change as a bare inline `span`: mark + signed value (\"▲ +3.2%\"), so print and\n * colour-blind readers get the direction; colour only adds good / bad. It sets no text size, so it\n * takes the size of the line it sits in (doc blocks, slide text).\n *\n * - The direction comes from the sign of `value`; `betterWhen` (\"up\" by default; `\"down\"` for churn,\n *   cost) decides good / bad. Zero is \"→\" in the muted colour; `null` is \"—\".\n * - `value` is the change itself, formatted by `format` with an explicit sign.\n * - `comparisonLabel` (\"前月比\") is printed in front, muted.\n *\n * @example\n * import { DeltaText } from \"@/blocks/delta-text/delta-text\"\n * <DeltaText value={0.032} format=\"percent\" comparisonLabel=\"前月比\" />\n */\nimport { useLocale } from \"../../hooks/use-locale\"\nimport { formatDelta, type ValueFormat } from \"../../lib/format\"\nimport { uiLanguage } from \"../../lib/locale\"\n\nexport interface DeltaTextProps {\n  /** The change itself; its direction comes from the sign. `null` shows \"—\". */\n  value: number | null\n  format?: ValueFormat\n  /** Which way is good. Default `\"up\"`. */\n  betterWhen?: \"up\" | \"down\"\n  /** Name of the comparison, e.g. \"前月比\". Printed before the change; omit to print only the change. */\n  comparisonLabel?: string\n  /** Locale of the value and the screen-reader text. Default the page's (`<html lang>`). */\n  locale?: string\n}\n\nconst MUTED = { color: \"var(--doc-muted)\" } as const\n\nconst TEXT = {\n  ja: {\n    up: \"増\",\n    down: \"減\",\n    flat: \"横ばい\",\n    label: (word: string, text: string, good: boolean | undefined) =>\n      `${word}、${text}${good === undefined ? \"\" : good ? \"、改善\" : \"、悪化\"}`,\n  },\n  en: {\n    up: \"Up\",\n    down: \"Down\",\n    flat: \"Flat\",\n    label: (word: string, text: string, good: boolean | undefined) =>\n      `${word}, ${text}${good === undefined ? \"\" : good ? \", improved\" : \", worsened\"}`,\n  },\n}\n\nexport function DeltaText({ value, format, betterWhen = \"up\", comparisonLabel, locale: localeProp }: DeltaTextProps) {\n  const locale = useLocale(localeProp)\n  const t = TEXT[uiLanguage(locale)]\n  const label = comparisonLabel ? <span style={MUTED}>{comparisonLabel} </span> : null\n  if (value === null) {\n    return (\n      <>\n        {label}\n        <span data-slot=\"delta-text\" style={MUTED}>\n          —\n        </span>\n      </>\n    )\n  }\n  const dir = value > 0 ? \"up\" : value < 0 ? \"down\" : \"flat\"\n  const mark = dir === \"up\" ? \"▲\" : dir === \"down\" ? \"▼\" : \"→\"\n  const word = t[dir]\n  const good = dir === \"flat\" ? undefined : (dir === \"up\") === (betterWhen === \"up\")\n  const tone = good === undefined ? undefined : good ? \"text-positive\" : \"text-negative\"\n  const text = formatDelta(value, format, locale)\n  return (\n    <>\n      {label}\n      <span\n        data-slot=\"delta-text\"\n        className={tone}\n        style={tone ? undefined : MUTED}\n        aria-label={t.label(word, text, good)}\n      >\n        {mark} {text}\n      </span>\n    </>\n  )\n}\n\nexport default DeltaText\n"]}

package/dist/cli.js

@@ -50,15 +50,15 @@ ${pc.bold("Options")}
   -h, --help          Print this help
 `;
 var COMMANDS = {
-  dev: () => import('./dev-H4I2JL63.js').then((m) => m.dev),
-  build: () => import('./build-A23M4GCH.js').then((m) => m.build),
+  dev: () => import('./dev-O42JFQ64.js').then((m) => m.dev),
+  build: () => import('./build-U7GO26HR.js').then((m) => m.build),
   preview: () => import('./preview-T6CLSQVX.js').then((m) => m.preview),
-  check: () => import('./check-FBHT6W6J.js').then((m) => m.check),
+  check: () => import('./check-MRVAIHG5.js').then((m) => m.check),
   routes: () => import('./routes-PVKNT777.js').then((m) => m.routes),
   add: () => import('./add-4GHF2TX2.js').then((m) => m.add),
   docs: () => import('./docs-JVP4RPKT.js').then((m) => m.docs),
   search: () => import('./search-5LC4XPB5.js').then((m) => m.search),
-  doctor: () => import('./doctor-B2O3GJDU.js').then((m) => m.doctor),
+  doctor: () => import('./doctor-YD3XAAOT.js').then((m) => m.doctor),
   upgrade: () => import('./upgrade-6DT7ADRP.js').then((m) => m.upgrade)
 };
 var NO_ROOT_POSITIONAL = /* @__PURE__ */ new Set(["add", "docs", "search"]);

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-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 { 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';
@@ -35,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?: {
@@ -532,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,
@@ -575,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 {
@@ -605,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;
 /**
@@ -1761,7 +1770,7 @@ interface DataTableExportProps {
      * <DataTableExport scope="page" />
      */
     scope?: CsvScope;
-    /** ボタンの文言。既定 `"CSV を書き出す"`。 */
+    /** ボタンの文言。既定はページの言語で `"CSV を書き出す"`（英語は `"Export CSV"`）。 */
     children?: ReactNode;
     className?: string;
 }
@@ -1822,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;
@@ -1887,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;
 }
@@ -1908,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 {
     /**
@@ -1934,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} />
@@ -2071,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月 以降"). */
@@ -2097,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).
@@ -2199,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, 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 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;
@@ -2228,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;
@@ -2271,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;
 }
@@ -2285,12 +2305,12 @@ 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;
 }

package/dist/components/index.js

@@ -1,9 +1,9 @@
-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-QOXXOFGL.js';
-export { EChart, useResolvedChartColors } from '../chunk-JXFCSF3K.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-57GHR5LN.js';
-import '../chunk-7S52M2SL.js';
-import '../chunk-PDOBHMUQ.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-CvwBGJ95.d.ts → delta-text-CbrOaW83.d.ts}

@@ -1,5 +1,5 @@
 import * as React from 'react';
-import { V as ValueFormat } from './format-U0cQl069.js';
+import { V as ValueFormat } from './format-DihQkL1N.js';
 
 interface DeltaTextProps {
     /** The change itself; its direction comes from the sign. `null` shows "—". */
@@ -9,7 +9,9 @@ interface DeltaTextProps {
     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 }: DeltaTextProps): React.JSX.Element;
+declare function DeltaText({ value, format, betterWhen, comparisonLabel, locale: localeProp }: DeltaTextProps): React.JSX.Element;
 
 export { DeltaText as D, type DeltaTextProps as a };

package/dist/{dev-H4I2JL63.js → dev-O42JFQ64.js}

@@ -1,4 +1,4 @@
-import { runDiagnostics } from './chunk-5C2SEDPH.js';
+import { runDiagnostics } from './chunk-PJ4SPXHS.js';
 import './chunk-UWSQUHX6.js';
 import { vantagePlugin } from './chunk-SDJTTMLK.js';
 import './chunk-SHZM3EXB.js';
@@ -77,5 +77,5 @@ async function dev(root, args) {
 }
 
 export { dev };
-//# sourceMappingURL=dev-H4I2JL63.js.map
-//# sourceMappingURL=dev-H4I2JL63.js.map
+//# sourceMappingURL=dev-O42JFQ64.js.map
+//# sourceMappingURL=dev-O42JFQ64.js.map

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

@@ -1 +1 @@
-{"version":3,"sources":["../src/cli/dev.ts"],"names":[],"mappings":"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","file":"dev-H4I2JL63.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"]}

package/dist/doc/index.d.ts

@@ -1,7 +1,7 @@
 import * as React from 'react';
 import { HTMLAttributes, ReactNode } from 'react';
-import { V as ValueFormat } from '../format-U0cQl069.js';
-export { D as DeltaText, a as DeltaTextProps } from '../delta-text-CvwBGJ95.js';
+import { V as ValueFormat } from '../format-DihQkL1N.js';
+export { D as DeltaText, a as DeltaTextProps } from '../delta-text-CbrOaW83.js';
 
 /**
  * Per-document token overrides. Anything left out falls through to `--doc-*`
@@ -53,7 +53,7 @@ interface DocActionItem {
     priority?: DocActionPriority;
 }
 interface DocActionItemsProps {
-    /** Heading text. Default "推奨する対応". */
+    /** Heading text. Default "Recommended actions" (ja: "推奨する対応"). */
     title?: string;
     /** `2` directly under the document, `3` inside another section. Default 2. */
     headingLevel?: 2 | 3;
@@ -97,7 +97,7 @@ interface DocDataTableProps {
         text: string;
     }[];
     source?: string;
-    /** When the data was taken: a date only, e.g. "2026-10-03". "データ時点" is added here. */
+    /** When the data was taken: a date only, e.g. "2026-10-03". "Data as of" (ja: "データ時点") is added here. */
     asOf?: string;
 }
 declare function DocDataTable({ title, unit, columns, rows, total, highlightRows, footnotes, source, asOf }: DocDataTableProps): React.JSX.Element;
@@ -113,13 +113,13 @@ interface DocSummaryMetric {
         value: number;
         format?: ValueFormat;
     };
-    /** Name of the comparison, e.g. "前月比". Default "前期比". */
+    /** Name of the comparison, e.g. "前月比". Default "vs. prior period" (ja: "前期比"). */
     comparisonLabel?: string;
     /** Which way is good. Default `"up"`. */
     betterWhen?: "up" | "down";
 }
 interface DocExecutiveSummaryProps {
-    /** Heading text. Default "要旨". */
+    /** Heading text. Default "Executive summary" (ja: "要旨"). */
     title?: string;
     /** `2` directly under the document, `3` inside another section. Default 2. */
     headingLevel?: 2 | 3;
@@ -137,7 +137,7 @@ interface DocFigureProps {
     title: string;
     /** Unit or scale, e.g. "単位: 百万円". */
     unit?: string;
-    /** Figure number; shown as "図 N" in the caption. */
+    /** Figure number; shown as "Figure N" (ja: "図 N") in the caption. */
     number?: number;
     /** Where the data comes from. */
     source?: string;
@@ -161,7 +161,7 @@ interface DocFindingMetric {
         value: number;
         format?: ValueFormat;
     };
-    /** Name of the comparison, e.g. "前月比". Default "前期比". */
+    /** Name of the comparison, e.g. "前月比". Default "vs. prior period" (ja: "前期比"). */
     comparisonLabel?: string;
     /** Which way is good. Default `"up"`. */
     betterWhen?: "up" | "down";
@@ -173,7 +173,7 @@ interface DocFinding {
     metric?: DocFindingMetric;
 }
 interface DocKeyFindingsProps {
-    /** Heading text. Default "主要な発見". */
+    /** Heading text. Default "Key findings" (ja: "主要な発見"). */
     title?: string;
     /** `2` directly under the document, `3` inside another section. Default 2. */
     headingLevel?: 2 | 3;
@@ -193,7 +193,7 @@ interface DocScorecardMetric {
         value: number;
         format?: ValueFormat;
     };
-    /** Name of the comparison, e.g. "前年同期比". Default "前期比". */
+    /** Name of the comparison, e.g. "前年同期比". Default "vs. prior period" (ja: "前期比"). */
     comparisonLabel?: string;
     /** Which way is good. Default `"up"`. */
     betterWhen?: "up" | "down";
@@ -206,13 +206,13 @@ interface DocScorecardMetric {
     }[];
 }
 interface DocKpiScorecardProps {
-    /** Heading text. Default "主要指標". */
+    /** Heading text. Default "Key metrics" (ja: "主要指標"). */
     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. */
+    /** When the numbers were taken: a date only, e.g. "2026-10-03". "Data as of" (ja: "データ時点") is added here. */
     asOf?: string;
     source?: string;
 }
@@ -225,7 +225,7 @@ interface DocReportHeaderProps {
     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 "データ時点". */
+    /** When the data was taken: a date only, e.g. "2026-10-03". Shown under "Data as of" (ja: "データ時点"). */
     asOf?: string;
     author?: string;
     /** Where the numbers come from, e.g. "受注管理システム、会計システム". */
@@ -243,7 +243,7 @@ interface DocSource {
     asOf?: string;
 }
 interface DocNotesAndSourcesProps {
-    /** Heading text. Default "注記・出典". */
+    /** Heading text. Default "Notes and sources" (ja: "注記・出典"). */
     title?: string;
     /** `2` directly under the document, `3` inside another section. Default 2. */
     headingLevel?: 2 | 3;