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

package/registry/ui/skeleton.tsx

@@ -0,0 +1,17 @@
+// Copied by `vantage add ui skeleton`. This file is yours to edit.
+// Generated from @squadbase/squadkit registry/ui/skeleton.tsx by `pnpm run registry` (in Vantage, edit packages/squadkit, not registry/).
+"use client"
+
+import { cn } from "@squadbase/vantage/ui"
+
+function Skeleton({ className, ...props }: React.ComponentProps<"div">) {
+  return (
+    <div
+      data-slot="skeleton"
+      className={cn("animate-pulse motion-reduce:animate-none rounded-md bg-muted", className)}
+      {...props}
+    />
+  )
+}
+
+export { Skeleton }

package/registry/ui/slider.tsx

@@ -0,0 +1,56 @@
+// Copied by `vantage add ui slider`. This file is yours to edit.
+// Generated from @squadbase/squadkit registry/ui/slider.tsx by `pnpm run registry` (in Vantage, edit packages/squadkit, not registry/).
+"use client"
+
+import { Slider as SliderPrimitive } from "@base-ui/react/slider"
+
+import { cn } from "@squadbase/vantage/ui"
+
+function Slider({
+  className,
+  defaultValue,
+  value,
+  min = 0,
+  max = 100,
+  ...props
+}: SliderPrimitive.Root.Props) {
+  const _values = Array.isArray(value)
+    ? value
+    : Array.isArray(defaultValue)
+      ? defaultValue
+      : [min, max]
+
+  return (
+    <SliderPrimitive.Root
+      className={cn("data-horizontal:w-full data-vertical:h-full", className)}
+      data-slot="slider"
+      defaultValue={defaultValue}
+      value={value}
+      min={min}
+      max={max}
+      thumbAlignment="edge"
+      {...props}
+    >
+      <SliderPrimitive.Control className="relative flex w-full touch-none items-center select-none data-disabled:opacity-50 data-vertical:h-full data-vertical:min-h-40 data-vertical:w-auto data-vertical:flex-col">
+        <SliderPrimitive.Track
+          data-slot="slider-track"
+          className="relative grow overflow-hidden rounded-full bg-muted select-none data-horizontal:h-1 data-horizontal:w-full data-vertical:h-full data-vertical:w-1"
+        >
+          <SliderPrimitive.Indicator
+            data-slot="slider-range"
+            className="bg-primary select-none data-horizontal:h-full data-vertical:w-full"
+          />
+        </SliderPrimitive.Track>
+        {Array.from({ length: _values.length }, (_, index) => (
+          <SliderPrimitive.Thumb
+            data-slot="slider-thumb"
+            key={index}
+            className="relative block size-3 shrink-0 rounded-full border border-ring bg-background ring-ring/50 transition-[color,box-shadow] select-none after:absolute after:-inset-2 hover:ring-3 focus-visible:ring-3 focus-visible:outline-hidden active:ring-3 disabled:pointer-events-none disabled:opacity-50"
+          />
+        ))}
+      </SliderPrimitive.Control>
+    </SliderPrimitive.Root>
+  )
+}
+
+export { Slider }

package/registry/ui/sparkline.tsx

@@ -0,0 +1,230 @@
+// Copied by `vantage add ui sparkline`. This file is yours to edit.
+// Generated from @squadbase/squadkit registry/charts/sparkline.tsx by `pnpm run registry` (in Vantage, edit packages/squadkit, not registry/).
+"use client"
+
+/**
+ * Sparkline — an inline trend micro-chart. Deliberately *not* an `EChart`: a
+ * sparkline sits inside table cells and KPI tiles by the dozen, where one
+ * ECharts instance per cell would be wasteful. This renders a single stateless
+ * `<svg>` instead, so hundreds of them stay cheap.
+ */
+import { forwardRef, useEffect, useState, type SVGAttributes } from "react"
+
+import { cn } from "@squadbase/vantage/ui"
+import type { ChartHighlight } from "@squadbase/vantage/components"
+
+export type SparklineVariant = "line" | "bar"
+
+export interface SparklineDataPoint {
+  value: number
+  label?: string
+}
+
+export interface SparklineProps extends SVGAttributes<SVGSVGElement> {
+  data: SparklineDataPoint[]
+  variant?: SparklineVariant
+  height?: number
+  /** Tailwind text-colour class; drives both stroke and fill via `currentColor`. */
+  color?: string
+  area?: boolean
+  /** マウント時に線を引く / 棒を伸ばす。既定 `false`(`prefers-reduced-motion` では常に無効)。 */
+  animate?: boolean
+  /**
+   * 点の強調(Tufte 流)。`"auto"` は最新・最大・最小の 3 点だけに小さな点を打つ
+   * (最新は系列の色、最大・最小は muted)。`"latest"` は最新の 1 点だけ、`"none"` は線だけ。`variant="line"` のときだけ効く。既定 `"auto"`。
+   */
+  highlight?: ChartHighlight | "latest"
+  /** 指定すると `role="img"` で読み上げ対象にする。省略時は装飾として `aria-hidden`。 */
+  "aria-label"?: string
+  className?: string
+}
+
+const VB_WIDTH = 100
+
+/** Map raw values onto SVG y-coordinates (inverted, padded). */
+function normalizeData(values: number[], height: number, vPad = 2): number[] {
+  const min = Math.min(...values)
+  const max = Math.max(...values)
+  const range = max - min
+  const drawHeight = height - vPad * 2
+  if (range === 0) return values.map(() => vPad + drawHeight / 2)
+  return values.map((v) => height - vPad - ((v - min) / range) * drawHeight)
+}
+
+function buildLinePath(ys: number[]): string {
+  if (ys.length === 0) return ""
+  const step = ys.length > 1 ? VB_WIDTH / (ys.length - 1) : 0
+  return ys
+    .map((y, i) => `${i === 0 ? "M" : "L"}${(i * step).toFixed(2)},${y.toFixed(2)}`)
+    .join(" ")
+}
+
+function buildAreaPath(ys: number[], height: number): string {
+  if (ys.length === 0) return ""
+  const step = ys.length > 1 ? VB_WIDTH / (ys.length - 1) : 0
+  const lastX = ((ys.length - 1) * step).toFixed(2)
+  return `${buildLinePath(ys)} L${lastX},${height} L0,${height} Z`
+}
+
+export type SparklinePointKind = "latest" | "max" | "min"
+
+export interface SparklinePoint {
+  kind: SparklinePointKind
+  index: number
+}
+
+/**
+ * The points a Tufte-style sparkline marks: the latest, the max and the min.
+ * A point that is both latest and max/min is drawn once, as `latest`; a flat
+ * series marks only the latest. Ties pick the most recent occurrence.
+ */
+export function sparklineHighlightPoints(values: number[]): SparklinePoint[] {
+  if (values.length === 0) return []
+  const last = values.length - 1
+  const points: SparklinePoint[] = [{ kind: "latest", index: last }]
+  let maxI = 0
+  let minI = 0
+  let max = values[0] as number
+  let min = max
+  values.forEach((v, i) => {
+    if (v >= max) [max, maxI] = [v, i]
+    if (v <= min) [min, minI] = [v, i]
+  })
+  const latest = values[last] as number
+  if (max === min) return points
+  if (max !== latest) points.push({ kind: "max", index: maxI })
+  if (min !== latest) points.push({ kind: "min", index: minI })
+  return points
+}
+
+interface BarRect {
+  x: number
+  y: number
+  w: number
+  h: number
+}
+
+function buildBarRects(ys: number[], height: number, gap = 1): BarRect[] {
+  const barW = Math.max(1, VB_WIDTH / ys.length - gap)
+  return ys.map((y, i) => ({ x: i * (barW + gap), y, w: barW, h: height - y }))
+}
+
+/** Rows not given yet (a draft fills props in steps): draw the empty state, keep the same array between renders. */
+const NO_ROWS: never[] = []
+
+export const Sparkline = forwardRef<SVGSVGElement, SparklineProps>(function Sparkline(
+  {
+    data = NO_ROWS,
+    variant = "line",
+    height = 40,
+    color = "text-chart-1",
+    area = false,
+    animate = false,
+    highlight = "auto",
+    "aria-label": ariaLabel,
+    className,
+    ...props
+  },
+  ref,
+) {
+  const [mounted, setMounted] = useState(false)
+
+  useEffect(() => {
+    if (animate) setMounted(true)
+  }, [animate])
+
+  if (data.length === 0) return null
+
+  const values = data.map((d) => d.value)
+  const ys = normalizeData(values, height)
+  const step = ys.length > 1 ? VB_WIDTH / (ys.length - 1) : 0
+  const points =
+    variant !== "line"
+      ? []
+      : highlight === "auto"
+        ? sparklineHighlightPoints(values)
+        : highlight === "latest"
+          ? [{ kind: "latest" as const, index: values.length - 1 }]
+          : []
+
+  return (
+    <svg
+      ref={ref}
+      data-slot="sparkline"
+      viewBox={`0 0 ${VB_WIDTH} ${height}`}
+      preserveAspectRatio="none"
+      width="100%"
+      height={height}
+      role={ariaLabel ? "img" : undefined}
+      aria-label={ariaLabel}
+      aria-hidden={ariaLabel ? undefined : true}
+      className={cn("overflow-visible", className)}
+      {...props}
+    >
+      {variant === "line" && (
+        <>
+          {area && (
+            <path
+              d={buildAreaPath(ys, height)}
+              strokeWidth={0}
+              className={cn("fill-current opacity-15", color)}
+            />
+          )}
+          <path
+            d={buildLinePath(ys)}
+            fill="none"
+            strokeWidth={1.5}
+            strokeLinecap="round"
+            strokeLinejoin="round"
+            vectorEffect="non-scaling-stroke"
+            pathLength={animate ? 1 : undefined}
+            strokeDasharray={animate ? 1 : undefined}
+            strokeDashoffset={animate ? (mounted ? 0 : 1) : undefined}
+            className={cn("stroke-current", animate && "motion-reduce:transition-none!", color)}
+            style={animate ? { transition: "stroke-dashoffset 0.6s ease-in-out" } : undefined}
+          />
+          {/* A zero-length round-capped stroke with a non-scaling width stays a
+              circle even though the viewBox stretches (`preserveAspectRatio="none"`). */}
+          {points.map((p) => {
+            const x = (p.index * step).toFixed(2)
+            const y = (ys[p.index] ?? 0).toFixed(2)
+            return (
+              <path
+                key={p.kind}
+                data-slot="sparkline-point"
+                data-point={p.kind}
+                d={`M${x},${y} L${x},${y}`}
+                fill="none"
+                strokeWidth={p.kind === "latest" ? 5 : 4}
+                strokeLinecap="round"
+                vectorEffect="non-scaling-stroke"
+                className={cn("stroke-current", p.kind === "latest" ? color : "text-muted-foreground")}
+              />
+            )
+          })}
+        </>
+      )}
+
+      {variant === "bar" &&
+        buildBarRects(ys, height).map((rect, i) => (
+          <rect
+            key={i}
+            x={rect.x}
+            y={animate ? (mounted ? rect.y : height) : rect.y}
+            width={rect.w}
+            height={animate ? (mounted ? rect.h : 0) : rect.h}
+            rx={0.5}
+            className={cn("fill-current", animate && "motion-reduce:transition-none!", color)}
+            style={
+              animate
+                ? {
+                    transition: `height 0.4s ease-out ${i * 0.02}s, y 0.4s ease-out ${i * 0.02}s`,
+                  }
+                : undefined
+            }
+          />
+        ))}
+    </svg>
+  )
+})
+Sparkline.displayName = "Sparkline"

package/registry/ui/spinner.tsx

@@ -0,0 +1,14 @@
+// Copied by `vantage add ui spinner`. This file is yours to edit.
+// Generated from @squadbase/squadkit registry/ui/spinner.tsx by `pnpm run registry` (in Vantage, edit packages/squadkit, not registry/).
+"use client"
+
+import { cn } from "@squadbase/vantage/ui"
+import { Loader2Icon } from "lucide-react"
+
+function Spinner({ className, ...props }: React.ComponentProps<"svg">) {
+  return (
+    <Loader2Icon data-slot="spinner" role="status" aria-label="Loading" className={cn("size-4 animate-spin", className)} {...props} />
+  )
+}
+
+export { Spinner }

package/registry/ui/states.tsx

@@ -0,0 +1,247 @@
+// Copied by `vantage add ui states`. This file is yours to edit.
+// Generated from @squadbase/squadkit registry/ui/states.tsx by `pnpm run registry` (in Vantage, edit packages/squadkit, not registry/).
+"use client"
+
+/**
+ * Loading / Empty / ErrorState — the three non-data states of a panel, worded for
+ * business users. Defaults follow the page language (`<html lang>`: Japanese for `ja`, else
+ * English) and say what is happening, not why the system failed: keep raw errors
+ * ("upstream timeout after 30s") in `details`, which stays folded behind "Show details" (ja: "詳細を表示").
+ *
+ * @example
+ * import { ErrorState } from "@/components/ui/states"
+ * // Vantage: import { ErrorState } from "@squadbase/vantage/ui"
+ *
+ * <ErrorState
+ *   title="売上を読み込めませんでした"
+ *   message="データソースから時間内に応答がありませんでした。しばらくしてから再試行してください。"
+ *   details={error.message}
+ *   action={<Button variant="outline" onClick={retry}>再試行する</Button>}
+ * />
+ */
+import type { ReactNode } from "react"
+import { cn } from "@squadbase/vantage/ui"
+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 ---------- */
+
+const TEXT = {
+  ja: {
+    loading: "読み込んでいます…",
+    empty: "表示できるデータがありません",
+    errorTitle: "データを読み込めませんでした",
+    errorMessage: "時間をおいて再試行してください。解決しない場合は管理者にお問い合わせください。",
+    details: "詳細を表示",
+  },
+  en: {
+    loading: "Loading…",
+    empty: "No data to display",
+    errorTitle: "Couldn't load the data",
+    errorMessage: "Try again in a moment. If the problem continues, contact your administrator.",
+    details: "Show details",
+  },
+}
+
+const useText = () => TEXT[uiLanguage(useLocale())]
+
+export function Loading({ label, className }: { label?: string; className?: string }) {
+  const t = useText()
+  return (
+    <div className={cn("flex min-h-[30vh] items-center justify-center", className)} role="status" aria-live="polite">
+      <div className="flex items-center gap-3 text-sm text-muted-foreground">
+        <span className="h-4 w-4 animate-spin rounded-full border-2 border-current border-t-transparent" />
+        {label ?? t.loading}
+      </div>
+    </div>
+  )
+}
+
+export function Empty({
+  title,
+  description,
+  icon,
+  action,
+  className,
+}: {
+  title?: string
+  description?: string
+  icon?: ReactNode
+  action?: ReactNode
+  className?: string
+}) {
+  const t = useText()
+  return (
+    <div className={cn("flex flex-col items-center justify-center gap-2 p-10 text-center", className)}>
+      {icon ? <div className="text-3xl text-muted-foreground">{icon}</div> : null}
+      <p className="font-medium">{title ?? t.empty}</p>
+      {description ? <p className="max-w-sm text-sm text-muted-foreground">{description}</p> : null}
+      {action ? <div className="mt-2">{action}</div> : null}
+    </div>
+  )
+}
+
+export function ErrorState({
+  title,
+  message,
+  details,
+  action,
+  className,
+}: {
+  title?: string
+  /** What happened and what to do next, in plain words. */
+  message?: ReactNode
+  /** Technical detail (error message, status code), folded behind "Show details" (ja: "詳細を表示"). */
+  details?: ReactNode
+  action?: ReactNode
+  className?: string
+}) {
+  const t = useText()
+  const shownMessage = message === undefined ? t.errorMessage : message
+  return (
+    <div
+      className={cn("rounded-xl border border-destructive/30 bg-destructive/5 p-6", className)}
+      role="alert"
+    >
+      <p className="font-semibold text-destructive">{title ?? t.errorTitle}</p>
+      {shownMessage ? <p className="mt-1 text-sm text-muted-foreground">{shownMessage}</p> : null}
+      {details ? (
+        <details className="mt-2 text-xs text-muted-foreground">
+          <summary className="cursor-pointer select-none">{t.details}</summary>
+          <div className="mt-1 font-mono break-all">{details}</div>
+        </details>
+      ) : null}
+      {action ? <div className="mt-3">{action}</div> : null}
+    </div>
+  )
+}