@squadbase/vantage 0.6.2-dev1.54bde93 → 0.6.2-dev1.56da87f

package/registry/ui/echart.tsx

@@ -58,9 +58,141 @@ import { Check, Copy, Download } from "lucide-react"
 import { cn } from "@squadbase/vantage/ui"
 import { Button } from "@squadbase/vantage/ui"
 import type { ChartActionsOptions } from "@squadbase/vantage/components"
+import { useSyncExternalStore } from "react"
 import { createContext, type ForwardedRef, type RefObject } from "react"
 import type { ChartTone } from "@squadbase/vantage/components"
 
+/* ---------- inlined from @squadbase/squadkit registry/lib/locale.ts (internal to @squadbase/vantage) ---------- */
+
+/**
+ * The display language of the parts and the defaults that follow it.
+ *
+ * The language comes from `<html lang>`: a tag starting with `ja` reads Japanese, anything else English.
+ * Without a usable `lang` (missing, invalid, or no `document` — SSR, Node) the locale is `FALLBACK_LOCALE`
+ * (`en-US`). A `locale` passed explicitly (a prop, an argument) always wins.
+ *
+ * Parts read the locale through `useLocale` (`hooks/use-locale`) and pass it down; the pure helpers here
+ * and in `format` / `comparison` / `chart-*` take it as an argument and fall back to `documentLocale()`.
+ */
+
+/** The language of the built-in wording: Japanese or English. */
+type UiLanguage = "ja" | "en"
+
+/** The locale used when `<html lang>` gives none (and on the server). */
+const FALLBACK_LOCALE = "en-US"
+
+/** `"ja"` when `locale` starts with `ja` (`ja`, `ja-JP`), else `"en"`. A missing locale is `"en"`. */
+function uiLanguage(locale: string | null | undefined): UiLanguage {
+  return typeof locale === "string" && locale.trim().toLowerCase().startsWith("ja") ? "ja" : "en"
+}
+
+/** A BCP 47 tag in its canonical form (`en-gb` → `en-GB`), or `FALLBACK_LOCALE` when it is empty or invalid. */
+function normalizeLocale(tag: string | null | undefined): string {
+  const value = tag?.trim()
+  if (!value) return FALLBACK_LOCALE
+  try {
+    return Intl.getCanonicalLocales(value)[0] ?? FALLBACK_LOCALE
+  } catch {
+    return FALLBACK_LOCALE
+  }
+}
+
+/**
+ * The locale of the page: `document.documentElement.lang`, canonicalized. `FALLBACK_LOCALE` when it is empty or
+ * invalid, or there is no `document`. Parts read it through `useLocale`, never while rendering.
+ */
+function documentLocale(): string {
+  if (typeof document === "undefined") return FALLBACK_LOCALE
+  return normalizeLocale(document.documentElement?.getAttribute("lang"))
+}
+
+/** `locale` when given, else the page's locale (`documentLocale()`). */
+function resolveLocale(locale?: string | null): string {
+  return locale || documentLocale()
+}
+
+/** Picks the wording table of the locale's language. */
+function pickLocale<T>(table: { ja: T; en: T }, locale?: string | null): T {
+  return table[uiLanguage(resolveLocale(locale))]
+}
+
+/** The currency `format="currency"` uses without a `currency`: JPY for Japanese, USD otherwise. */
+function defaultCurrency(locale?: string | null): string {
+  return uiLanguage(resolveLocale(locale)) === "ja" ? "JPY" : "USD"
+}
+
+/** The month a fiscal year starts in (1–12) when none is given: April for Japanese, January otherwise. */
+function defaultFiscalYearStartMonth(locale?: string | null): number {
+  return uiLanguage(resolveLocale(locale)) === "ja" ? 4 : 1
+}
+
+/** A day of the week, 0 = Sunday … 6 = Saturday (the `Date#getDay` / date-fns numbering). */
+type WeekDay = 0 | 1 | 2 | 3 | 4 | 5 | 6
+
+/** Locales whose week starts on Sunday when the runtime has no week data. */
+const SUNDAY_FIRST = new Set(["en", "en-US", "en-CA"])
+
+/**
+ * The first day of the week: Monday for Japanese; otherwise the locale's convention from `Intl.Locale`
+ * (`en-US` Sunday, `en-GB` Monday). Without week data in the runtime: Sunday for `en` / `en-US` / `en-CA`,
+ * Monday for the rest.
+ */
+function weekStartsOn(locale?: string | null): WeekDay {
+  const tag = normalizeLocale(resolveLocale(locale))
+  if (uiLanguage(tag) === "ja") return 1
+  try {
+    const info = new Intl.Locale(tag) as Intl.Locale & {
+      getWeekInfo?: () => { firstDay: number }
+      weekInfo?: { firstDay: number }
+    }
+    const firstDay = info.getWeekInfo?.().firstDay ?? info.weekInfo?.firstDay
+    if (typeof firstDay === "number" && firstDay >= 1 && firstDay <= 7) return (firstDay % 7) as WeekDay
+  } catch {
+    // Fall through to the table below.
+  }
+  return SUNDAY_FIRST.has(tag) ? 0 : 1
+}
+
+/* ---------- inlined from @squadbase/squadkit registry/hooks/use-locale.ts (internal to @squadbase/vantage) ---------- */
+
+const listeners = new Set<() => void>()
+let observer: MutationObserver | null = null
+
+/** One observer on `<html lang>` for every subscribed part. */
+function subscribe(onChange: () => void): () => void {
+  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
+    }
+  }
+}
+
+const serverLocale = () => FALLBACK_LOCALE
+
+/**
+ * The page's locale (`<html lang>`), following changes made while the page runs. On the server and during
+ * hydration it is `FALLBACK_LOCALE` (`en-US`), so the markup matches; it switches right after.
+ */
+function useDocumentLocale(): string {
+  return useSyncExternalStore(subscribe, documentLocale, serverLocale)
+}
+
+/** The locale a part renders in: its `locale` prop when given, else the page's (`useDocumentLocale`). */
+function useLocale(locale?: string | null): string {
+  const page = useDocumentLocale()
+  return locale || page
+}
+
 /* ---------- inlined from @squadbase/squadkit registry/lib/chart-theme.ts (internal to @squadbase/vantage) ---------- */
 
 /**
@@ -594,11 +726,16 @@ export function chartExportHeaderLayout(
   return { lines, height: HEADER_PAD_TOP + lines.length * HEADER_LINE_HEIGHT + gap + HEADER_PAD_BOTTOM }
 }
 
+const TEXT = {
+  ja: { chart: "チャート", copied: "コピーしました", copy: "PNG をクリップボードにコピー", download: "PNG をダウンロード" },
+  en: { chart: "Chart", copied: "Copied", copy: "Copy PNG to clipboard", download: "Download PNG" },
+}
+
 function loadImage(src: string): Promise<HTMLImageElement> {
   return new Promise((resolve, reject) => {
     const image = new Image()
     image.onload = () => resolve(image)
-    image.onerror = () => reject(new Error("PNG の読み込みに失敗しました"))
+    image.onerror = () => reject(new Error("Couldn't load the PNG"))
     image.src = src
   })
 }
@@ -854,6 +991,7 @@ export const EChart = forwardRef<HTMLDivElement, EChartProps>(function EChart(
   const containerRef = useRef<HTMLDivElement | null>(null)
   const [instance, setInstance] = useState<ECharts | null>(null)
   const [copied, setCopied] = useState(false)
+  const t = TEXT[uiLanguage(useLocale())]
   const tokens = useChartTokens(containerRef)
   const reducedMotion = usePrefersReducedMotion()
   // What the current instance last received, to pick the merge mode of the next update.
@@ -1005,7 +1143,7 @@ export const EChart = forwardRef<HTMLDivElement, EChartProps>(function EChart(
         data-slot="echart-canvas"
         className="h-full w-full"
         role={inFrame ? undefined : "img"}
-        aria-label={inFrame ? undefined : (ariaLabel ?? "チャート")}
+        aria-label={inFrame ? undefined : (ariaLabel ?? t.chart)}
       />
       {actions && (
         <div
@@ -1017,7 +1155,7 @@ export const EChart = forwardRef<HTMLDivElement, EChartProps>(function EChart(
             variant="ghost"
             size="icon-sm"
             onClick={handleCopy}
-            aria-label={copied ? "コピーしました" : "PNG をクリップボードにコピー"}
+            aria-label={copied ? t.copied : t.copy}
           >
             {copied ? <Check className="size-4" /> : <Copy className="size-4" />}
           </Button>
@@ -1026,7 +1164,7 @@ export const EChart = forwardRef<HTMLDivElement, EChartProps>(function EChart(
             variant="ghost"
             size="icon-sm"
             onClick={handleDownload}
-            aria-label="PNG をダウンロード"
+            aria-label={t.download}
           >
             <Download className="size-4" />
           </Button>

package/registry/ui/filter-bar.tsx

@@ -24,6 +24,140 @@ import { Checkbox } from "@squadbase/vantage/ui"
 import { Popover, PopoverContent, PopoverTrigger } from "@squadbase/vantage/ui"
 import { Select, SelectContent, SelectItem, SelectTrigger, SelectValue } from "@squadbase/vantage/ui"
 import type { FilterConfig, FilterOption, FilterValues } from "@squadbase/vantage/components"
+import { useSyncExternalStore } from "react"
+
+/* ---------- inlined from @squadbase/squadkit registry/lib/locale.ts (internal to @squadbase/vantage) ---------- */
+
+/**
+ * The display language of the parts and the defaults that follow it.
+ *
+ * The language comes from `<html lang>`: a tag starting with `ja` reads Japanese, anything else English.
+ * Without a usable `lang` (missing, invalid, or no `document` — SSR, Node) the locale is `FALLBACK_LOCALE`
+ * (`en-US`). A `locale` passed explicitly (a prop, an argument) always wins.
+ *
+ * Parts read the locale through `useLocale` (`hooks/use-locale`) and pass it down; the pure helpers here
+ * and in `format` / `comparison` / `chart-*` take it as an argument and fall back to `documentLocale()`.
+ */
+
+/** The language of the built-in wording: Japanese or English. */
+type UiLanguage = "ja" | "en"
+
+/** The locale used when `<html lang>` gives none (and on the server). */
+const FALLBACK_LOCALE = "en-US"
+
+/** `"ja"` when `locale` starts with `ja` (`ja`, `ja-JP`), else `"en"`. A missing locale is `"en"`. */
+function uiLanguage(locale: string | null | undefined): UiLanguage {
+  return typeof locale === "string" && locale.trim().toLowerCase().startsWith("ja") ? "ja" : "en"
+}
+
+/** A BCP 47 tag in its canonical form (`en-gb` → `en-GB`), or `FALLBACK_LOCALE` when it is empty or invalid. */
+function normalizeLocale(tag: string | null | undefined): string {
+  const value = tag?.trim()
+  if (!value) return FALLBACK_LOCALE
+  try {
+    return Intl.getCanonicalLocales(value)[0] ?? FALLBACK_LOCALE
+  } catch {
+    return FALLBACK_LOCALE
+  }
+}
+
+/**
+ * The locale of the page: `document.documentElement.lang`, canonicalized. `FALLBACK_LOCALE` when it is empty or
+ * invalid, or there is no `document`. Parts read it through `useLocale`, never while rendering.
+ */
+function documentLocale(): string {
+  if (typeof document === "undefined") return FALLBACK_LOCALE
+  return normalizeLocale(document.documentElement?.getAttribute("lang"))
+}
+
+/** `locale` when given, else the page's locale (`documentLocale()`). */
+function resolveLocale(locale?: string | null): string {
+  return locale || documentLocale()
+}
+
+/** Picks the wording table of the locale's language. */
+function pickLocale<T>(table: { ja: T; en: T }, locale?: string | null): T {
+  return table[uiLanguage(resolveLocale(locale))]
+}
+
+/** The currency `format="currency"` uses without a `currency`: JPY for Japanese, USD otherwise. */
+function defaultCurrency(locale?: string | null): string {
+  return uiLanguage(resolveLocale(locale)) === "ja" ? "JPY" : "USD"
+}
+
+/** The month a fiscal year starts in (1–12) when none is given: April for Japanese, January otherwise. */
+function defaultFiscalYearStartMonth(locale?: string | null): number {
+  return uiLanguage(resolveLocale(locale)) === "ja" ? 4 : 1
+}
+
+/** A day of the week, 0 = Sunday … 6 = Saturday (the `Date#getDay` / date-fns numbering). */
+type WeekDay = 0 | 1 | 2 | 3 | 4 | 5 | 6
+
+/** Locales whose week starts on Sunday when the runtime has no week data. */
+const SUNDAY_FIRST = new Set(["en", "en-US", "en-CA"])
+
+/**
+ * The first day of the week: Monday for Japanese; otherwise the locale's convention from `Intl.Locale`
+ * (`en-US` Sunday, `en-GB` Monday). Without week data in the runtime: Sunday for `en` / `en-US` / `en-CA`,
+ * Monday for the rest.
+ */
+function weekStartsOn(locale?: string | null): WeekDay {
+  const tag = normalizeLocale(resolveLocale(locale))
+  if (uiLanguage(tag) === "ja") return 1
+  try {
+    const info = new Intl.Locale(tag) as Intl.Locale & {
+      getWeekInfo?: () => { firstDay: number }
+      weekInfo?: { firstDay: number }
+    }
+    const firstDay = info.getWeekInfo?.().firstDay ?? info.weekInfo?.firstDay
+    if (typeof firstDay === "number" && firstDay >= 1 && firstDay <= 7) return (firstDay % 7) as WeekDay
+  } catch {
+    // Fall through to the table below.
+  }
+  return SUNDAY_FIRST.has(tag) ? 0 : 1
+}
+
+/* ---------- inlined from @squadbase/squadkit registry/hooks/use-locale.ts (internal to @squadbase/vantage) ---------- */
+
+const listeners = new Set<() => void>()
+let observer: MutationObserver | null = null
+
+/** One observer on `<html lang>` for every subscribed part. */
+function subscribe(onChange: () => void): () => void {
+  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
+    }
+  }
+}
+
+const serverLocale = () => FALLBACK_LOCALE
+
+/**
+ * The page's locale (`<html lang>`), following changes made while the page runs. On the server and during
+ * hydration it is `FALLBACK_LOCALE` (`en-US`), so the markup matches; it switches right after.
+ */
+function useDocumentLocale(): string {
+  return useSyncExternalStore(subscribe, documentLocale, serverLocale)
+}
+
+/** The locale a part renders in: its `locale` prop when given, else the page's (`useDocumentLocale`). */
+function useLocale(locale?: string | null): string {
+  const page = useDocumentLocale()
+  return locale || page
+}
+
+/* ---------- end of inlined code ---------- */
 
 /* --------------------------------------------------------------- context */
 
@@ -38,6 +172,25 @@ interface FilterBarContextValue {
 
 const FilterBarContext = createContext<FilterBarContextValue | null>(null)
 
+const TEXT = {
+  ja: {
+    filters: "フィルター",
+    selected: (count: number) => ` (${count}件選択中)`,
+    remove: (filter: string, option: string) => `${filter}: ${option} を削除`,
+    clear: "クリア",
+    clearAll: "すべてのフィルターをクリア",
+  },
+  en: {
+    filters: "Filters",
+    selected: (count: number) => ` (${count} selected)`,
+    remove: (filter: string, option: string) => `Remove ${filter}: ${option}`,
+    clear: "Clear",
+    clearAll: "Clear all filters",
+  },
+}
+
+const useText = () => TEXT[uiLanguage(useLocale())]
+
 function useFilterBar(): FilterBarContextValue {
   const ctx = useContext(FilterBarContext)
   if (!ctx) throw new Error("useFilterBar must be used within <FilterBar>")
@@ -55,20 +208,23 @@ export interface FilterBarProps extends Omit<HTMLAttributes<HTMLDivElement>, "on
 }
 
 export const FilterBar = forwardRef<HTMLDivElement, FilterBarProps>(
-  ({ value, onChange, onClear, className, children, ...props }, ref) => (
-    <FilterBarContext.Provider value={{ value, onChange, onClear }}>
-      <div
-        ref={ref}
-        role="search"
-        aria-label="フィルター"
-        data-slot="filter-bar"
-        className={cn("flex flex-wrap items-center gap-2", className)}
-        {...props}
-      >
-        {children}
-      </div>
-    </FilterBarContext.Provider>
-  ),
+  ({ value, onChange, onClear, className, children, ...props }, ref) => {
+    const t = useText()
+    return (
+      <FilterBarContext.Provider value={{ value, onChange, onClear }}>
+        <div
+          ref={ref}
+          role="search"
+          aria-label={t.filters}
+          data-slot="filter-bar"
+          className={cn("flex flex-wrap items-center gap-2", className)}
+          {...props}
+        >
+          {children}
+        </div>
+      </FilterBarContext.Provider>
+    )
+  },
 )
 FilterBar.displayName = "FilterBar"
 
@@ -151,6 +307,7 @@ export function FilterBarMultiSelect({
   className,
 }: FilterBarMultiSelectProps) {
   const { value, onChange } = useFilterBar()
+  const t = useText()
   const selected = (value[filterKey] as string[] | undefined) ?? []
 
   const handleToggle = (option: string) => {
@@ -165,7 +322,7 @@ export function FilterBarMultiSelect({
     <Popover>
       <PopoverTrigger
         render={<Button variant="outline" size="sm" className={cn("h-8 gap-1", className)} />}
-        aria-label={`${placeholder ?? label}${selected.length > 0 ? ` (${selected.length}件選択中)` : ""}`}
+        aria-label={`${placeholder ?? label}${selected.length > 0 ? t.selected(selected.length) : ""}`}
         data-slot="filter-bar-multi-select"
       >
         {placeholder ?? label}
@@ -216,6 +373,7 @@ interface ActiveChip {
 
 export function FilterBarActiveChips({ filters, className }: FilterBarActiveChipsProps) {
   const { value, onChange } = useFilterBar()
+  const t = useText()
 
   const getActiveChips = (): ActiveChip[] => {
     const chips: ActiveChip[] = []
@@ -293,7 +451,7 @@ export function FilterBarActiveChips({ filters, className }: FilterBarActiveChip
             type="button"
             className="ml-0.5 rounded-full p-0.5 hover:bg-muted-foreground/20"
             onClick={() => handleRemoveFilter(chip.key, chip.optionValue)}
-            aria-label={`${chip.filterLabel}: ${chip.optionLabel} を削除`}
+            aria-label={t.remove(chip.filterLabel, chip.optionLabel)}
           >
             <X className="size-3" aria-hidden="true" />
           </button>
@@ -307,13 +465,14 @@ FilterBarActiveChips.displayName = "FilterBarActiveChips"
 /* ----------------------------------------------------------- clear button */
 
 export interface FilterBarClearButtonProps {
-  /** Override the button label. Defaults to "クリア". */
+  /** Override the button label. Defaults to "Clear" (ja: "クリア"). */
   label?: string
   className?: string
 }
 
-export function FilterBarClearButton({ label = "クリア", className }: FilterBarClearButtonProps) {
+export function FilterBarClearButton({ label, className }: FilterBarClearButtonProps) {
   const { value, onClear } = useFilterBar()
+  const t = useText()
   const hasActiveFilters = Object.values(value).some((v) =>
     Array.isArray(v) ? v.length > 0 : v !== undefined && v !== "",
   )
@@ -325,10 +484,10 @@ export function FilterBarClearButton({ label = "クリア", className }: FilterB
       size="sm"
       className={cn("h-7 px-2 text-xs", className)}
       onClick={onClear}
-      aria-label="すべてのフィルターをクリア"
+      aria-label={t.clearAll}
       data-slot="filter-bar-clear-button"
     >
-      {label}
+      {label ?? t.clear}
     </Button>
   )
 }