@squadbase/vantage 0.6.2 → 0.7.0-stg.18ca87d

package/registry/ui/metric-value.tsx

@@ -0,0 +1,62 @@
+// Copied by `vantage add ui metric-value`. This file is yours to edit.
+// Generated from @squadbase/squadkit registry/components/metric-value.tsx by `pnpm run registry` (in Vantage, edit packages/squadkit, not registry/).
+"use client"
+
+/**
+ * MetricValue / MetricUnit — the large number in a dashboard tile and its
+ * trailing unit, sized as a pair so the unit stays subordinate at every size.
+ *
+ * @deprecated KPI の数字は KpiCard を使う。KpiCard は書式（`format`、単位は
+ * `{ type: "number", unit: "社" }`）・比較ラベル・増減を値から計算するので、
+ * 手書きの数字と TrendIndicator の組み合わせのように食い違わない。
+ */
+import { forwardRef, type HTMLAttributes } from "react"
+import { cva, type VariantProps } from "class-variance-authority"
+
+import { cn } from "@squadbase/vantage/ui"
+
+export const metricValueVariants = cva("font-medium tracking-tight", {
+  variants: {
+    size: {
+      sm: "text-base",
+      md: "text-2xl",
+      lg: "text-3xl",
+      xl: "text-4xl",
+    },
+  },
+  defaultVariants: {
+    size: "md",
+  },
+})
+
+export interface MetricValueProps
+  extends HTMLAttributes<HTMLDivElement>,
+    VariantProps<typeof metricValueVariants> {}
+
+/** @deprecated KPI の数字は KpiCard を使う。 */
+export const MetricValue = forwardRef<HTMLDivElement, MetricValueProps>(
+  ({ className, size, ...props }, ref) => (
+    <div
+      ref={ref}
+      data-slot="metric-value"
+      className={cn("my-4", metricValueVariants({ size }), className)}
+      {...props}
+    />
+  ),
+)
+MetricValue.displayName = "MetricValue"
+
+export interface MetricUnitProps extends HTMLAttributes<HTMLSpanElement> {}
+
+/** @deprecated KPI の単位は KpiCard の `format`（`{ type: "number", unit: "社" }`）で付ける。 */
+export const MetricUnit = forwardRef<HTMLSpanElement, MetricUnitProps>(
+  ({ className, ...props }, ref) => (
+    <span
+      ref={ref}
+      data-slot="metric-unit"
+      className={cn("text-sm font-normal text-muted-foreground", className)}
+      {...props}
+    />
+  ),
+)
+MetricUnit.displayName = "MetricUnit"

package/registry/ui/multi-select.tsx

@@ -0,0 +1,382 @@
+// Copied by `vantage add ui multi-select`. This file is yours to edit.
+// Generated from @squadbase/squadkit registry/components/multi-select.tsx by `pnpm run registry` (in Vantage, edit packages/squadkit, not registry/).
+"use client"
+
+/**
+ * MultiSelect — a multi-value combobox that shows the selection as removable
+ * 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"
+import { ChevronDownIcon } from "lucide-react"
+
+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 {
+  options: SelectOptions
+  /** Whether the given option value is currently selected (drives the check). */
+  isSelected: (value: string) => boolean
+  onSelect: (value: string) => void
+  /** Take filtering over yourself (server-side search); turns off built-in filter. */
+  onSearch?: (query: string) => void
+  isLoading: boolean
+  searchPlaceholder: string
+  emptyText: string
+}
+
+/** The searchable list body — flat or grouped, with loading and empty states. */
+function OptionCommandList({
+  options,
+  isSelected,
+  onSelect,
+  onSearch,
+  isLoading,
+  searchPlaceholder,
+  emptyText,
+}: OptionCommandListProps) {
+  const renderOptions = (items: SelectOption[]) =>
+    items.map((option) => (
+      <CommandItem
+        key={option.value}
+        value={option.value}
+        keywords={[option.label]}
+        disabled={option.disabled}
+        onSelect={onSelect}
+      >
+        {option.icon && <option.icon className="size-4 shrink-0" />}
+        <span className="flex-1 truncate">
+          {option.label}
+          {option.description && (
+            <span className="ml-2 text-xs text-muted-foreground">{option.description}</span>
+          )}
+        </span>
+        <CheckIcon
+          className={cn("size-4 shrink-0", isSelected(option.value) ? "opacity-100" : "opacity-0")}
+        />
+      </CommandItem>
+    ))
+
+  return (
+    <Command shouldFilter={!onSearch}>
+      <CommandInput placeholder={searchPlaceholder} onValueChange={onSearch} />
+      <CommandList>
+        {isLoading ? (
+          <div className="flex items-center justify-center py-6">
+            <LoaderIcon className="size-4 animate-spin text-muted-foreground" />
+          </div>
+        ) : (
+          <>
+            <CommandEmpty>{emptyText}</CommandEmpty>
+            {isGroupedOptions(options)
+              ? options.map((group) => (
+                  <CommandGroup key={group.label} heading={group.label}>
+                    {renderOptions(group.options)}
+                  </CommandGroup>
+                ))
+              : renderOptions(options)}
+          </>
+        )}
+      </CommandList>
+    </Command>
+  )
+}
+
+interface RemoveButtonProps {
+  label: string
+  /** Runs on click and on Enter/Space; propagation is stopped for you. */
+  onRemove: () => void
+  /** Override the X icon size (default `size-3.5`). */
+  iconClassName?: string
+}
+
+/** The keyboard-accessible ×-affordance inside a badge or trigger. */
+function RemoveButton({ label, onRemove, iconClassName }: RemoveButtonProps) {
+  const handle = (e: MouseEvent | KeyboardEvent) => {
+    e.stopPropagation()
+    onRemove()
+  }
+  return (
+    <span
+      role="button"
+      tabIndex={0}
+      aria-label={label}
+      className="rounded-sm opacity-50 hover:opacity-100 focus-visible:ring-1 focus-visible:ring-ring focus-visible:outline-none"
+      onClick={handle}
+      onKeyDown={(e) => {
+        if (e.key === "Enter" || e.key === " ") handle(e)
+      }}
+    >
+      <XIcon className={cn("size-3.5", iconClassName)} />
+    </span>
+  )
+}
+
+/* ---------- end of inlined code ---------- */
+
+export interface MultiSelectProps {
+  options: SelectOptions
+  value: string[]
+  onChange?: (value: string[]) => void
+  onSearch?: (query: string) => void
+  maxCount?: number
+  placeholder?: string
+  searchPlaceholder?: string
+  emptyText?: string
+  isLoading?: boolean
+  disabled?: boolean
+  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[] = []
+
+export const MultiSelect = forwardRef<HTMLDivElement, MultiSelectProps>(function MultiSelect(
+  {
+    options = NO_OPTIONS,
+    value = NO_VALUES,
+    onChange,
+    onSearch,
+    maxCount = 3,
+    placeholder,
+    searchPlaceholder,
+    emptyText,
+    isLoading = false,
+    disabled = false,
+    className,
+  },
+  ref,
+) {
+  const [open, setOpen] = useState(false)
+  const listId = useId()
+  const t = TEXT[uiLanguage(useLocale())]
+
+  const allOptions = useMemo(() => flattenOptions(options), [options])
+  const selectedOptions = useMemo(
+    () => allOptions.filter((opt) => value.includes(opt.value)),
+    [allOptions, value],
+  )
+
+  function handleSelect(selectedValue: string) {
+    if (value.includes(selectedValue)) {
+      onChange?.(value.filter((v) => v !== selectedValue))
+    } else {
+      onChange?.([...value, selectedValue])
+    }
+  }
+
+  const visibleBadges = selectedOptions.slice(0, maxCount)
+  const overflowCount = selectedOptions.length - maxCount
+
+  return (
+    <div ref={ref} data-slot="multi-select">
+      <Popover open={open} onOpenChange={setOpen}>
+        <PopoverTrigger
+          role="combobox"
+          aria-expanded={open}
+          aria-controls={listId}
+          disabled={disabled}
+          className={cn(
+            "inline-flex min-h-9 w-full items-center justify-between gap-2 rounded-md border bg-background px-3 py-1.5 text-sm shadow-xs transition-[color,background-color,border-color,box-shadow] outline-none hover:bg-accent hover:text-accent-foreground focus-visible:border-ring focus-visible:ring-[3px] focus-visible:ring-ring/50 disabled:pointer-events-none disabled:opacity-50 dark:border-input dark:bg-input/30 dark:hover:bg-input/50",
+            className,
+          )}
+        >
+          <span className="flex min-w-0 flex-1 flex-wrap items-center gap-1">
+            {selectedOptions.length === 0 ? (
+              <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={t.remove(option.label)}
+                      onRemove={() => onChange?.(value.filter((v) => v !== option.value))}
+                      iconClassName="size-3"
+                    />
+                  </Badge>
+                ))}
+                {overflowCount > 0 && (
+                  <Badge variant="secondary" className="shrink-0">
+                    {t.more(overflowCount)}
+                  </Badge>
+                )}
+              </>
+            )}
+          </span>
+          <ChevronDownIcon className="size-4 shrink-0 opacity-50" />
+        </PopoverTrigger>
+        <PopoverContent id={listId} className="w-(--anchor-width) p-0" align="start">
+          <OptionCommandList
+            options={options}
+            isSelected={(v) => value.includes(v)}
+            onSelect={handleSelect}
+            onSearch={onSearch}
+            isLoading={isLoading}
+            searchPlaceholder={searchPlaceholder ?? t.search}
+            emptyText={emptyText ?? t.empty}
+          />
+        </PopoverContent>
+      </Popover>
+    </div>
+  )
+})
+MultiSelect.displayName = "MultiSelect"