@squadbase/vantage 0.6.2-dev1.b332e5a → 0.6.2-dev1.d7c0911

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 `npm 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,232 @@
+// Copied by `vantage add ui multi-select`. This file is yours to edit.
+// Generated from @squadbase/squadkit registry/components/multi-select.tsx by `npm 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件" 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 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/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
+}
+
+/** 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 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}</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}を削除`}
+                      onRemove={() => onChange?.(value.filter((v) => v !== option.value))}
+                      iconClassName="size-3"
+                    />
+                  </Badge>
+                ))}
+                {overflowCount > 0 && (
+                  <Badge variant="secondary" className="shrink-0">
+                    +{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}
+            emptyText={emptyText}
+          />
+        </PopoverContent>
+      </Popover>
+    </div>
+  )
+})
+MultiSelect.displayName = "MultiSelect"

package/registry/ui/page-shell.tsx

@@ -0,0 +1,282 @@
+// Copied by `vantage add ui page-shell`. This file is yours to edit.
+// Generated from @squadbase/squadkit registry/components/page-shell.tsx by `npm run registry` (in Vantage, edit packages/squadkit, not registry/).
+"use client"
+
+/**
+ * PageShell — the standard page frame: a bordered header band (title,
+ * description, meta, actions), an optional summary card row, and the content
+ * area. Composed from parts so a page can use only what it needs.
+ */
+import { forwardRef, type HTMLAttributes, type ReactNode } from "react"
+import { cva, type VariantProps } from "class-variance-authority"
+
+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"
+
+export interface PageShellProps extends HTMLAttributes<HTMLDivElement> {}
+
+export const PageShell = forwardRef<HTMLDivElement, PageShellProps>(
+  ({ className, ...props }, ref) => (
+    <div ref={ref} data-slot="page-shell" className={cn("flex flex-col", className)} {...props} />
+  ),
+)
+PageShell.displayName = "PageShell"
+
+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"]
+  /** `"relative"` (default) or `"absolute-first"` ("16:41 更新（23 分前）") for pages where "now" matters. */
+  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. */
+  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 }
+  /** The page's overall state (an alert, a status badge). Shown on the third row; no row when absent. */
+  status?: ReactNode
+}
+
+/**
+ * A wrapping flex row, not a two-column grid: when the heading cannot keep its
+ * 20rem basis next to `PageShellHeaderEnd`, the end block drops below it. A
+ * `1fr auto` grid would instead hand the heading whatever the end block leaves,
+ * and a CJK title — breakable between any two characters — collapses into a
+ * one-character column.
+ *
+ * The meta props (`updatedAt`, `source`, `period`, `status`) fix the order every
+ * page head shares: title and update time (right end) → source / period chips →
+ * overall status → summary cards. Empty rows are not drawn. Rows are placed with
+ * flex `order`, so they land before `PageShellSummary` whatever the child order.
+ */
+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 hasChips = Boolean(source) || (periodText !== undefined && periodText !== EMPTY_VALUE)
+    const hasStatus = status !== undefined && status !== null && status !== false && status !== ""
+    return (
+      <div
+        ref={ref}
+        data-slot="page-shell-header"
+        className={cn("flex flex-wrap items-start gap-x-4 gap-y-6 px-6 py-12", className)}
+        {...props}
+      >
+        {children}
+        {updatedAt !== undefined && updatedAt !== null ? (
+          <div data-slot="page-shell-updated-at" className="ml-auto max-w-full shrink-0 text-right">
+            <UpdatedAt at={updatedAt} variant={updatedAtVariant} timeZone={timeZone} />
+          </div>
+        ) : null}
+        {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>
+            ) : null}
+            {periodText && periodText !== EMPTY_VALUE ? (
+              <Badge variant="outline" className="tabular-nums">
+                {periodText}
+              </Badge>
+            ) : null}
+          </div>
+        ) : null}
+        {hasStatus ? (
+          <div data-slot="page-shell-status" className="order-2 min-w-0 basis-full">
+            {status}
+          </div>
+        ) : null}
+      </div>
+    )
+  },
+)
+PageShellHeader.displayName = "PageShellHeader"
+
+export interface PageShellHeadingProps extends HTMLAttributes<HTMLDivElement> {}
+
+export const PageShellHeading = forwardRef<HTMLDivElement, PageShellHeadingProps>(
+  ({ className, ...props }, ref) => (
+    <div
+      ref={ref}
+      data-slot="page-shell-heading"
+      className={cn("min-w-0 grow basis-80", className)}
+      {...props}
+    />
+  ),
+)
+PageShellHeading.displayName = "PageShellHeading"
+
+export interface PageShellTitleProps extends HTMLAttributes<HTMLHeadingElement> {}
+
+export const PageShellTitle = forwardRef<HTMLHeadingElement, PageShellTitleProps>(
+  ({ className, ...props }, ref) => (
+    <h1
+      ref={ref}
+      data-slot="page-shell-title"
+      className={cn("text-2xl font-bold tracking-tight text-foreground", className)}
+      {...props}
+    />
+  ),
+)
+PageShellTitle.displayName = "PageShellTitle"
+
+export interface PageShellDescriptionProps extends HTMLAttributes<HTMLParagraphElement> {}
+
+export const PageShellDescription = forwardRef<HTMLParagraphElement, PageShellDescriptionProps>(
+  ({ className, ...props }, ref) => (
+    <p
+      ref={ref}
+      data-slot="page-shell-description"
+      className={cn("mt-1 text-sm text-muted-foreground", className)}
+      {...props}
+    />
+  ),
+)
+PageShellDescription.displayName = "PageShellDescription"
+
+export interface PageShellHeaderEndProps extends HTMLAttributes<HTMLDivElement> {}
+
+export const PageShellHeaderEnd = forwardRef<HTMLDivElement, PageShellHeaderEndProps>(
+  ({ className, ...props }, ref) => (
+    <div
+      ref={ref}
+      data-slot="page-shell-header-end"
+      className={cn("flex max-w-full shrink-0 flex-col flex-wrap items-end gap-2", className)}
+      {...props}
+    />
+  ),
+)
+PageShellHeaderEnd.displayName = "PageShellHeaderEnd"
+
+export interface PageShellMetaProps extends HTMLAttributes<HTMLDivElement> {}
+
+export const PageShellMeta = forwardRef<HTMLDivElement, PageShellMetaProps>(
+  ({ className, ...props }, ref) => (
+    <div
+      ref={ref}
+      data-slot="page-shell-meta"
+      className={cn("text-sm text-muted-foreground", className)}
+      {...props}
+    />
+  ),
+)
+PageShellMeta.displayName = "PageShellMeta"
+
+export interface PageShellActionsProps extends HTMLAttributes<HTMLDivElement> {}
+
+export const PageShellActions = forwardRef<HTMLDivElement, PageShellActionsProps>(
+  ({ className, ...props }, ref) => (
+    <div
+      ref={ref}
+      data-slot="page-shell-actions"
+      className={cn("flex items-center gap-2", className)}
+      {...props}
+    />
+  ),
+)
+PageShellActions.displayName = "PageShellActions"
+
+export interface PageShellSummaryProps extends HTMLAttributes<HTMLDivElement> {}
+
+export const PageShellSummary = forwardRef<HTMLDivElement, PageShellSummaryProps>(
+  ({ className, ...props }, ref) => (
+    <div
+      ref={ref}
+      data-slot="page-shell-summary"
+      className={cn(
+        "order-3 grid basis-full grid-cols-1 gap-3 md:grid-cols-2 lg:grid-cols-3 xl:grid-cols-4",
+        className,
+      )}
+      {...props}
+    />
+  ),
+)
+PageShellSummary.displayName = "PageShellSummary"
+
+/**
+ * Accent tints come from theme tokens, never Tailwind palette colours: the
+ * semantic tones (`--positive` / `--negative` / `--warning` / `--info` /
+ * `--neutral` and their `*-subtle`) and, for hues with no status meaning,
+ * `--chart-4` / `--chart-5`. The colour-named accents are kept for compatibility
+ * and map to the nearest tone. Each set is a literal string — Tailwind only
+ * 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",
+  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
+
+export const pageShellSummaryCardVariants = cva(
+  "relative flex items-start gap-3 rounded-lg border bg-background px-4 py-3 text-sm [&>svg]:mt-0.5 [&>svg]:size-4 [&>svg]:shrink-0",
+  {
+    variants: {
+      accent: {
+        default: "text-card-foreground",
+        accent:
+          "border-[var(--chart-1)]/30 bg-linear-to-r from-[var(--chart-1)]/5 to-[var(--chart-1)]/5 [&>svg]:text-[var(--chart-1)]",
+        amber: summaryCardTones.warning,
+        blue: summaryCardTones.info,
+        emerald: summaryCardTones.positive,
+        red: summaryCardTones.negative,
+        violet: summaryCardTones.violet,
+        orange: summaryCardTones.warning,
+        cyan: summaryCardTones.info,
+        slate: summaryCardTones.neutral,
+        green: summaryCardTones.positive,
+        teal: summaryCardTones.positive,
+        sky: summaryCardTones.info,
+        indigo: summaryCardTones.info,
+        purple: summaryCardTones.violet,
+        pink: summaryCardTones.pink,
+        rose: summaryCardTones.negative,
+        yellow: summaryCardTones.warning,
+        lime: summaryCardTones.positive,
+        gray: summaryCardTones.neutral,
+        zinc: summaryCardTones.neutral,
+        neutral: summaryCardTones.neutral,
+        stone: summaryCardTones.neutral,
+        fuchsia: summaryCardTones.violet,
+      },
+    },
+    defaultVariants: {
+      accent: "default",
+    },
+  },
+)
+
+export interface PageShellSummaryCardProps
+  extends HTMLAttributes<HTMLDivElement>,
+    VariantProps<typeof pageShellSummaryCardVariants> {}
+
+export const PageShellSummaryCard = forwardRef<HTMLDivElement, PageShellSummaryCardProps>(
+  ({ className, accent, ...props }, ref) => (
+    <div
+      ref={ref}
+      data-slot="page-shell-summary-card"
+      className={cn(pageShellSummaryCardVariants({ accent }), className)}
+      {...props}
+    />
+  ),
+)
+PageShellSummaryCard.displayName = "PageShellSummaryCard"
+
+export interface PageShellContentProps extends HTMLAttributes<HTMLDivElement> {}
+
+export const PageShellContent = forwardRef<HTMLDivElement, PageShellContentProps>(
+  ({ className, ...props }, ref) => (
+    <div
+      ref={ref}
+      data-slot="page-shell-content"
+      className={cn("flex-1 p-6", className)}
+      {...props}
+    />
+  ),
+)
+PageShellContent.displayName = "PageShellContent"