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

package/registry/ui/multi-select.tsx

@@ -4,7 +4,7 @@
 
 /**
  * MultiSelect — a multi-value combobox that shows the selection as removable
- * badges. Past `maxCount` badges the rest collapse into a "+N件" counter.
+ * badges. Past `maxCount` badges the rest collapse into a "+N more" (ja: "+N件") counter.
  * Pass `onSearch` to take filtering over yourself (server-side search).
  */
 import { forwardRef, useId, useMemo, useState } from "react"
@@ -14,11 +14,143 @@ import { cn } from "@squadbase/vantage/ui"
 import { Badge } from "@squadbase/vantage/ui"
 import { Popover, PopoverContent, PopoverTrigger } from "@squadbase/vantage/ui"
 import { flattenOptions, type SelectOptions } from "@squadbase/vantage/components"
+import { useSyncExternalStore } from "react"
 import type { KeyboardEvent, MouseEvent } from "react"
 import { CheckIcon, LoaderIcon, XIcon } from "lucide-react"
 import { Command, CommandEmpty, CommandGroup, CommandInput, CommandItem, CommandList } from "@squadbase/vantage/ui"
 import { isGroupedOptions, type SelectOption } 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/components/option-command.tsx (internal to @squadbase/vantage) ---------- */
 
 interface OptionCommandListProps {
@@ -136,6 +268,23 @@ export interface MultiSelectProps {
   className?: string
 }
 
+const TEXT = {
+  ja: {
+    placeholder: "選択してください",
+    search: "検索...",
+    empty: "見つかりませんでした",
+    remove: (label: string) => `${label}を削除`,
+    more: (count: number) => `+${count}件`,
+  },
+  en: {
+    placeholder: "Select options",
+    search: "Search...",
+    empty: "No results found.",
+    remove: (label: string) => `Remove ${label}`,
+    more: (count: number) => `+${count} more`,
+  },
+}
+
 /** Not given yet (a draft fills props in steps): render empty, keep the same value between renders. */
 const NO_OPTIONS: never[] = []
 const NO_VALUES: string[] = []
@@ -147,9 +296,9 @@ export const MultiSelect = forwardRef<HTMLDivElement, MultiSelectProps>(function
     onChange,
     onSearch,
     maxCount = 3,
-    placeholder = "選択してください",
-    searchPlaceholder = "検索...",
-    emptyText = "見つかりませんでした",
+    placeholder,
+    searchPlaceholder,
+    emptyText,
     isLoading = false,
     disabled = false,
     className,
@@ -158,6 +307,7 @@ export const MultiSelect = forwardRef<HTMLDivElement, MultiSelectProps>(function
 ) {
   const [open, setOpen] = useState(false)
   const listId = useId()
+  const t = TEXT[uiLanguage(useLocale())]
 
   const allOptions = useMemo(() => flattenOptions(options), [options])
   const selectedOptions = useMemo(
@@ -191,14 +341,14 @@ export const MultiSelect = forwardRef<HTMLDivElement, MultiSelectProps>(function
         >
           <span className="flex min-w-0 flex-1 flex-wrap items-center gap-1">
             {selectedOptions.length === 0 ? (
-              <span className="text-muted-foreground">{placeholder}</span>
+              <span className="text-muted-foreground">{placeholder ?? t.placeholder}</span>
             ) : (
               <>
                 {visibleBadges.map((option) => (
                   <Badge key={option.value} variant="secondary" className="shrink-0 gap-1 pr-1">
                     <span className="max-w-[120px] truncate">{option.label}</span>
                     <RemoveButton
-                      label={`${option.label}を削除`}
+                      label={t.remove(option.label)}
                       onRemove={() => onChange?.(value.filter((v) => v !== option.value))}
                       iconClassName="size-3"
                     />
@@ -206,7 +356,7 @@ export const MultiSelect = forwardRef<HTMLDivElement, MultiSelectProps>(function
                 ))}
                 {overflowCount > 0 && (
                   <Badge variant="secondary" className="shrink-0">
-                    +{overflowCount}件
+                    {t.more(overflowCount)}
                   </Badge>
                 )}
               </>
@@ -221,8 +371,8 @@ export const MultiSelect = forwardRef<HTMLDivElement, MultiSelectProps>(function
             onSelect={handleSelect}
             onSearch={onSearch}
             isLoading={isLoading}
-            searchPlaceholder={searchPlaceholder}
-            emptyText={emptyText}
+            searchPlaceholder={searchPlaceholder ?? t.search}
+            emptyText={emptyText ?? t.empty}
           />
         </PopoverContent>
       </Popover>

package/registry/ui/page-shell.tsx

@@ -14,6 +14,140 @@ import { formatDateRange, EMPTY_VALUE } from "@squadbase/vantage/components"
 import { cn } from "@squadbase/vantage/ui"
 import { Badge } from "@squadbase/vantage/ui"
 import { UpdatedAt, type UpdatedAtProps } 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 ---------- */
 
 export interface PageShellProps extends HTMLAttributes<HTMLDivElement> {}
 
@@ -24,6 +158,8 @@ export const PageShell = forwardRef<HTMLDivElement, PageShellProps>(
 )
 PageShell.displayName = "PageShell"
 
+const SOURCE_PREFIX = { ja: "出典：", en: "Source: " }
+
 export interface PageShellHeaderProps extends HTMLAttributes<HTMLDivElement> {
   /** When the data was last updated. Drawn by `UpdatedAt` at the right end of the title row. */
   updatedAt?: UpdatedAtProps["at"]
@@ -31,7 +167,7 @@ export 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?: { start: Date | string | number; end: Date | string | number }
@@ -53,7 +189,8 @@ export interface PageShellHeaderProps extends HTMLAttributes<HTMLDivElement> {
  */
 export const PageShellHeader = forwardRef<HTMLDivElement, PageShellHeaderProps>(
   ({ className, updatedAt, updatedAtVariant, timeZone, source, period, status, children, ...props }, ref) => {
-    const periodText = period ? formatDateRange(period.start, period.end, { timeZone }) : undefined
+    const locale = useLocale()
+    const periodText = period ? formatDateRange(period.start, period.end, { timeZone, locale }) : undefined
     const hasChips = Boolean(source) || (periodText !== undefined && periodText !== EMPTY_VALUE)
     const hasStatus = status !== undefined && status !== null && status !== false && status !== ""
     return (
@@ -72,12 +209,13 @@ export const PageShellHeader = forwardRef<HTMLDivElement, PageShellHeaderProps>(
         {hasChips ? (
           <div data-slot="page-shell-chips" className="order-1 flex basis-full flex-wrap gap-1.5">
             {source ? (
-              <Badge variant="outline" className="h-auto max-w-full whitespace-normal">
-                出典：{source}
+              <Badge variant="outline" className="h-auto max-w-full whitespace-normal text-muted-foreground">
+                {SOURCE_PREFIX[uiLanguage(locale)]}
+                {source}
               </Badge>
             ) : null}
             {periodText && periodText !== EMPTY_VALUE ? (
-              <Badge variant="outline" className="tabular-nums">
+              <Badge variant="outline" className="tabular-nums text-muted-foreground">
                 {periodText}
               </Badge>
             ) : null}
@@ -204,11 +342,11 @@ PageShellSummary.displayName = "PageShellSummary"
  * emits classes it can see literally in the source.
  */
 const summaryCardTones = {
-  positive: "border-positive/30 bg-positive-subtle [&>svg]:text-positive",
-  negative: "border-negative/30 bg-negative-subtle [&>svg]:text-negative",
-  warning: "border-warning/30 bg-warning-subtle [&>svg]:text-warning",
-  info: "border-info/30 bg-info-subtle [&>svg]:text-info",
-  neutral: "border-neutral/30 bg-neutral-subtle [&>svg]:text-neutral",
+  positive: "border-positive/20 dark:border-positive/25 bg-positive-subtle [&>svg]:text-positive",
+  negative: "border-negative/20 dark:border-negative/25 bg-negative-subtle [&>svg]:text-negative",
+  warning: "border-warning/20 dark:border-warning/25 bg-warning-subtle [&>svg]:text-warning",
+  info: "border-info/20 dark:border-info/25 bg-info-subtle [&>svg]:text-info",
+  neutral: "border-neutral/20 dark:border-neutral/25 bg-neutral-subtle [&>svg]:text-neutral",
   violet: "border-chart-4/30 bg-chart-4/5 [&>svg]:text-chart-4",
   pink: "border-chart-5/30 bg-chart-5/5 [&>svg]:text-chart-5",
 } as const