@mohou/ui 1.0.20

package/src/components/toggle-group.tsx

@@ -0,0 +1,92 @@
+
+import * as React from 'react'
+import { Toggle as TogglePrimitive } from '@base-ui/react/toggle'
+import { ToggleGroup as ToggleGroupPrimitive } from '@base-ui/react/toggle-group'
+import { type VariantProps } from 'class-variance-authority'
+
+import { cn } from '@mohou/ui/lib/utils'
+import { toggleVariants } from '@mohou/ui/components/toggle'
+
+const ToggleGroupContext = React.createContext<
+  VariantProps<typeof toggleVariants> & {
+    spacing?: number
+    orientation?: 'horizontal' | 'vertical'
+  }
+>({
+  size: 'default',
+  variant: 'default',
+  spacing: 2,
+  orientation: 'horizontal',
+})
+
+/**
+ * @family Form
+ * @when Multiple independent on/off buttons; exclusive selection → `Tabs`/`ButtonGroup`.
+ */
+function ToggleGroup({
+  className,
+  variant,
+  size,
+  spacing = 2,
+  orientation = 'horizontal',
+  children,
+  ...props
+}: ToggleGroupPrimitive.Props &
+  VariantProps<typeof toggleVariants> & {
+    spacing?: number
+    orientation?: 'horizontal' | 'vertical'
+  }) {
+  return (
+    <ToggleGroupPrimitive
+      data-slot="toggle-group"
+      data-variant={variant}
+      data-size={size}
+      data-spacing={spacing}
+      data-orientation={orientation}
+      style={{ '--gap': spacing } as React.CSSProperties}
+      className={cn(
+        'group/toggle-group flex w-fit flex-row items-center gap-[--spacing(var(--gap))] rounded-lg data-[size=sm]:rounded-[min(var(--radius-md),10px)] data-vertical:flex-col data-vertical:items-stretch',
+        className,
+      )}
+      {...props}
+    >
+      <ToggleGroupContext.Provider
+        value={{ variant, size, spacing, orientation }}
+      >
+        {children}
+      </ToggleGroupContext.Provider>
+    </ToggleGroupPrimitive>
+  )
+}
+
+function ToggleGroupItem({
+  className,
+  children,
+  variant = 'default',
+  size = 'default',
+  ...props
+}: TogglePrimitive.Props & VariantProps<typeof toggleVariants>) {
+  const context = React.useContext(ToggleGroupContext)
+
+  return (
+    <TogglePrimitive
+      data-slot="toggle-group-item"
+      data-variant={context.variant || variant}
+      data-size={context.size || size}
+      data-spacing={context.spacing}
+      className={cn(
+        'shrink-0 group-data-[spacing=0]/toggle-group:rounded-none group-data-[spacing=0]/toggle-group:px-2 focus:z-10 focus-visible:z-10 group-data-[spacing=0]/toggle-group:has-data-[icon=inline-end]:pr-1.5 group-data-[spacing=0]/toggle-group:has-data-[icon=inline-start]:pl-1.5 group-data-horizontal/toggle-group:data-[spacing=0]:first:rounded-l-lg group-data-vertical/toggle-group:data-[spacing=0]:first:rounded-t-lg group-data-horizontal/toggle-group:data-[spacing=0]:last:rounded-r-lg group-data-vertical/toggle-group:data-[spacing=0]:last:rounded-b-lg group-data-horizontal/toggle-group:data-[spacing=0]:data-[variant=outline]:border-l-0 group-data-vertical/toggle-group:data-[spacing=0]:data-[variant=outline]:border-t-0 group-data-horizontal/toggle-group:data-[spacing=0]:data-[variant=outline]:first:border-l group-data-vertical/toggle-group:data-[spacing=0]:data-[variant=outline]:first:border-t',
+        toggleVariants({
+          variant: context.variant || variant,
+          size: context.size || size,
+        }),
+        className,
+      )}
+      {...props}
+    >
+      {children}
+    </TogglePrimitive>
+  )
+}
+
+export { ToggleGroup, ToggleGroupItem }

package/src/components/toggle.tsx

@@ -0,0 +1,47 @@
+import { Toggle as TogglePrimitive } from '@base-ui/react/toggle'
+import { cva, type VariantProps } from 'class-variance-authority'
+
+import { cn } from '@mohou/ui/lib/utils'
+
+const toggleVariants = cva(
+  "group/toggle inline-flex items-center justify-center gap-1 rounded-lg text-sm font-medium whitespace-nowrap transition-all outline-none hover:bg-muted hover:text-foreground focus-visible:border-ring focus-visible:ring-[3px] focus-visible:ring-ring/50 disabled:pointer-events-none disabled:opacity-50 aria-invalid:border-destructive aria-invalid:ring-destructive/20 aria-pressed:bg-muted data-[state=on]:bg-muted dark:aria-invalid:ring-destructive/40 [&_svg]:pointer-events-none [&_svg]:shrink-0 [&_svg:not([class*='size-'])]:size-4",
+  {
+    variants: {
+      variant: {
+        default: 'bg-transparent',
+        outline: 'border border-input bg-transparent hover:bg-muted',
+      },
+      size: {
+        default:
+          'h-8 min-w-8 px-2.5 has-data-[icon=inline-end]:pr-2 has-data-[icon=inline-start]:pl-2',
+        sm: "h-7 min-w-7 rounded-[min(var(--radius-md),12px)] px-2.5 text-[0.8rem] has-data-[icon=inline-end]:pr-1.5 has-data-[icon=inline-start]:pl-1.5 [&_svg:not([class*='size-'])]:size-3.5",
+        lg: 'h-9 min-w-9 px-2.5 has-data-[icon=inline-end]:pr-2 has-data-[icon=inline-start]:pl-2',
+      },
+    },
+    defaultVariants: {
+      variant: 'default',
+      size: 'default',
+    },
+  },
+)
+
+/**
+ * @family Form
+ * @when Binary formatting switch (bold, filters on).
+ */
+function Toggle({
+  className,
+  variant = 'default',
+  size = 'default',
+  ...props
+}: TogglePrimitive.Props & VariantProps<typeof toggleVariants>) {
+  return (
+    <TogglePrimitive
+      data-slot="toggle"
+      className={cn(toggleVariants({ variant, size, className }))}
+      {...props}
+    />
+  )
+}
+
+export { Toggle, toggleVariants }

package/src/components/tooltip.tsx

@@ -0,0 +1,72 @@
+
+import { Tooltip as TooltipPrimitive } from '@base-ui/react/tooltip'
+
+import { cn } from '@mohou/ui/lib/utils'
+
+function TooltipProvider({
+  delay = 0,
+  ...props
+}: TooltipPrimitive.Provider.Props) {
+  return (
+    <TooltipPrimitive.Provider
+      data-slot="tooltip-provider"
+      delay={delay}
+      {...props}
+    />
+  )
+}
+
+/**
+ * Hover/focus hint on an icon or truncated label.
+ * @when Explaining an icon-only button. Never put an action in it.
+ * @example
+ * <Tooltip><TooltipTrigger asChild><Button size="icon" aria-label="刷新"><Icon.RefreshCw /></Button></TooltipTrigger><TooltipContent>刷新</TooltipContent></Tooltip>
+ * @family Surface
+ */
+function Tooltip({ ...props }: TooltipPrimitive.Root.Props) {
+  return <TooltipPrimitive.Root data-slot="tooltip" {...props} />
+}
+
+function TooltipTrigger({ ...props }: TooltipPrimitive.Trigger.Props) {
+  return <TooltipPrimitive.Trigger data-slot="tooltip-trigger" {...props} />
+}
+
+function TooltipContent({
+  className,
+  side = 'top',
+  sideOffset = 4,
+  align = 'center',
+  alignOffset = 0,
+  children,
+  ...props
+}: TooltipPrimitive.Popup.Props &
+  Pick<
+    TooltipPrimitive.Positioner.Props,
+    'align' | 'alignOffset' | 'side' | 'sideOffset'
+  >) {
+  return (
+    <TooltipPrimitive.Portal>
+      <TooltipPrimitive.Positioner
+        align={align}
+        alignOffset={alignOffset}
+        side={side}
+        sideOffset={sideOffset}
+        className="isolate z-50"
+      >
+        <TooltipPrimitive.Popup
+          data-slot="tooltip-content"
+          className={cn(
+            'z-50 inline-flex w-fit max-w-xs origin-(--transform-origin) items-center gap-1.5 rounded-md bg-foreground px-3 py-1.5 text-xs text-background has-data-[slot=kbd]:pr-1.5 data-[side=bottom]:slide-in-from-top-2 data-[side=inline-end]:slide-in-from-left-2 data-[side=inline-start]:slide-in-from-right-2 data-[side=left]:slide-in-from-right-2 data-[side=right]:slide-in-from-left-2 data-[side=top]:slide-in-from-bottom-2 **:data-[slot=kbd]:relative **:data-[slot=kbd]:isolate **:data-[slot=kbd]:z-50 **:data-[slot=kbd]:rounded-sm data-[state=delayed-open]:animate-in data-[state=delayed-open]:fade-in-0 data-[state=delayed-open]:zoom-in-95 data-open:animate-in data-open:fade-in-0 data-open:zoom-in-95 data-closed:animate-out data-closed:fade-out-0 data-closed:zoom-out-95',
+            className,
+          )}
+          {...props}
+        >
+          {children}
+          <TooltipPrimitive.Arrow className="z-50 size-2.5 translate-y-[calc(-50%-2px)] rotate-45 rounded-[2px] bg-foreground fill-foreground data-[side=bottom]:top-1 data-[side=inline-end]:top-1/2! data-[side=inline-end]:-left-1 data-[side=inline-end]:-translate-y-1/2 data-[side=inline-start]:top-1/2! data-[side=inline-start]:-right-1 data-[side=inline-start]:-translate-y-1/2 data-[side=left]:top-1/2! data-[side=left]:-right-1 data-[side=left]:-translate-y-1/2 data-[side=right]:top-1/2! data-[side=right]:-left-1 data-[side=right]:-translate-y-1/2 data-[side=top]:-bottom-2.5" />
+        </TooltipPrimitive.Popup>
+      </TooltipPrimitive.Positioner>
+    </TooltipPrimitive.Portal>
+  )
+}
+
+export { Tooltip, TooltipTrigger, TooltipContent, TooltipProvider }

package/src/composites/autocomplete.tsx

@@ -0,0 +1,61 @@
+
+import * as React from 'react'
+
+import { Input } from '@mohou/ui/components/input'
+
+/**
+ * Text input with filtered suggestions.
+ * @when Free text allowed but known values should be suggested. Strict pick-list → `Select`.
+ * @example
+ * <Autocomplete options={["main", "develop"]} onChange={(v) => set(v)} />
+ * @family Form
+ */
+export function Autocomplete({
+  value,
+  onChange,
+  options,
+  placeholder,
+}: {
+  value?: string
+  onChange?: (value: string) => void
+  options: string[]
+  placeholder?: string
+}) {
+  const [open, setOpen] = React.useState(false)
+  const filtered = options.filter(option =>
+    option.toLowerCase().includes((value ?? '').toLowerCase()),
+  )
+  return (
+    <div className="relative" data-testid="autocomplete">
+      <Input
+        value={value ?? ''}
+        placeholder={placeholder}
+        onChange={(event) => {
+          onChange?.(event.target.value)
+          setOpen(true)
+        }}
+        onFocus={() => setOpen(true)}
+        onBlur={() => window.setTimeout(() => setOpen(false), 120)}
+      />
+      {open && filtered.length > 0 ? (
+        <ul className="absolute z-50 mt-1 max-h-48 w-full overflow-auto rounded-lg border bg-card p-1 shadow-md">
+          {filtered.slice(0, 20).map(option => (
+            <li key={option}>
+              <button
+                type="button"
+                className="w-full rounded-md px-2 py-1.5 text-left text-sm hover:bg-muted"
+                onMouseDown={event => event.preventDefault()}
+                onClick={() => {
+                  onChange?.(option)
+                  setOpen(false)
+                }}
+              >
+                {option}
+              </button>
+            </li>
+          ))}
+        </ul>
+      ) : null}
+    </div>
+  )
+}

package/src/composites/cascader.tsx

@@ -0,0 +1,52 @@
+
+import { NativeSelect, NativeSelectOption } from '@mohou/ui/components/native-select'
+
+export type CascaderNode = { value: string; label: string; children?: CascaderNode[] }
+
+/**
+ * Multi-level drill-down picker.
+ * @when Hierarchical codes (region → site → line). Flat tree → `TreeView`.
+ * @example
+ * <Cascader options={[{ label: "华东", value: "cn", children: [{ label: "上海", value: "sha" }] }]} onChange={(v) => set(v)} />
+ * @family Form
+ */
+export function Cascader({
+  options,
+  value = [],
+  onChange,
+}: {
+  options: CascaderNode[]
+  value?: string[]
+  onChange?: (value: string[]) => void
+}) {
+  const columns: CascaderNode[][] = []
+  let level = options
+  columns.push(level)
+  for (const key of value) {
+    const next = level.find(node => node.value === key)?.children
+    if (!next?.length) break
+    columns.push(next)
+    level = next
+  }
+  return (
+    <div className="flex flex-wrap gap-2" data-testid="cascader">
+      {columns.map((nodes, index) => (
+        <NativeSelect
+          key={index}
+          value={value[index] ?? ''}
+          onChange={(event) => {
+            const next = event.target.value
+            onChange?.([...value.slice(0, index), next])
+          }}
+        >
+          <NativeSelectOption value="">Select</NativeSelectOption>
+          {nodes.map(node => (
+            <NativeSelectOption key={node.value} value={node.value}>
+              {node.label}
+            </NativeSelectOption>
+          ))}
+        </NativeSelect>
+      ))}
+    </div>
+  )
+}

package/src/composites/color-picker.tsx

@@ -0,0 +1,25 @@
+
+/**
+ * Swatch + hex colour input.
+ * @when Theme/label colour config. Never for secrets.
+ * @example
+ * <ColorPicker value={c} onChange={(v) => set(v)} />
+ * @family Form
+ */
+export function ColorPicker({
+  value = '#111111',
+  onChange,
+}: {
+  value?: string
+  onChange?: (value: string) => void
+}) {
+  return (
+    <input
+      data-testid="color-picker"
+      type="color"
+      value={value}
+      onChange={event => onChange?.(event.target.value)}
+      className="size-8 cursor-pointer rounded-md border bg-transparent p-0.5"
+    />
+  )
+}

package/src/composites/confirm-dialog.tsx

@@ -0,0 +1,62 @@
+
+import {
+  AlertDialog,
+  AlertDialogAction,
+  AlertDialogCancel,
+  AlertDialogContent,
+  AlertDialogDescription,
+  AlertDialogFooter,
+  AlertDialogHeader,
+  AlertDialogTitle,
+} from '@mohou/ui/components/alert-dialog'
+import { useLabels } from '@mohou/ui/i18n/context'
+
+/**
+ * Controlled yes/no dialog with loading-safe confirm.
+ * @when Any destructive action. Needs a form inside → compose `Dialog` yourself.
+ * @example
+ * <ConfirmDialog open={open} title="删除这条？" onConfirm={remove} onOpenChange={setOpen} />
+ * @family Surface
+ */
+export function ConfirmDialog({
+  open,
+  onOpenChange,
+  title,
+  description,
+  confirmLabel,
+  cancelLabel,
+  onConfirm,
+}: {
+  open: boolean
+  onOpenChange: (open: boolean) => void
+  title: string
+  description?: string
+  confirmLabel?: string
+  cancelLabel?: string
+  onConfirm: () => void
+}) {
+  const t = useLabels('confirmDialog')
+  return (
+    <AlertDialog open={open} onOpenChange={onOpenChange}>
+      <AlertDialogContent data-testid="confirm-dialog">
+        <AlertDialogHeader>
+          <AlertDialogTitle>{title}</AlertDialogTitle>
+          {description ? (
+            <AlertDialogDescription>{description}</AlertDialogDescription>
+          ) : null}
+        </AlertDialogHeader>
+        <AlertDialogFooter>
+          <AlertDialogCancel>{cancelLabel ?? t.cancel}</AlertDialogCancel>
+          <AlertDialogAction
+            onClick={() => {
+              onConfirm()
+              onOpenChange(false)
+            }}
+          >
+            {confirmLabel ?? t.confirm}
+          </AlertDialogAction>
+        </AlertDialogFooter>
+      </AlertDialogContent>
+    </AlertDialog>
+  )
+}

package/src/composites/copyable.tsx

@@ -0,0 +1,44 @@
+
+import * as React from 'react'
+import { Check, Copy } from 'lucide-react'
+
+import { Button } from '@mohou/ui/components/button'
+import {
+  InputGroup,
+  InputGroupAddon,
+  InputGroupInput,
+} from '@mohou/ui/components/input-group'
+import { useLabels } from '@mohou/ui/i18n/context'
+import { writeClipboard } from '@mohou/ui/lib/clipboard'
+
+/**
+ * Inline text with a copy button.
+ * @when IDs, hashes, URLs, tokens the user pastes elsewhere.
+ * @example
+ * <Copyable value="i_1724918400" />
+ * @family Discovery & inspect
+ */
+export function Copyable({ value }: { value: string }) {
+  const t = useLabels('copyable')
+  const [copied, setCopied] = React.useState(false)
+  return (
+    <InputGroup data-testid="copyable">
+      <InputGroupInput readOnly value={value} />
+      <InputGroupAddon align="inline-end">
+        <Button
+          variant="ghost"
+          size="icon-xs"
+          type="button"
+          aria-label={t.copy}
+          onClick={async () => {
+            if (!(await writeClipboard(value))) return
+            setCopied(true)
+            window.setTimeout(() => setCopied(false), 1200)
+          }}
+        >
+          {copied ? <Check /> : <Copy />}
+        </Button>
+      </InputGroupAddon>
+    </InputGroup>
+  )
+}

package/src/composites/currency-input.tsx

@@ -0,0 +1,37 @@
+
+import {
+  InputGroup,
+  InputGroupAddon,
+  InputGroupInput,
+  InputGroupText,
+} from '@mohou/ui/components/input-group'
+
+/**
+ * Amount input with grouping + currency prefix.
+ * @when Money fields; keeps the raw string out of your state.
+ * @example
+ * <CurrencyInput currency="CNY" onChange={(v) => set(v)} />
+ * @family Form
+ */
+export function CurrencyInput({
+  value,
+  onChange,
+  currency = '¥',
+}: {
+  value?: string
+  onChange?: (value: string) => void
+  currency?: string
+}) {
+  return (
+    <InputGroup className="w-40" data-testid="currency-input">
+      <InputGroupAddon>
+        <InputGroupText>{currency}</InputGroupText>
+      </InputGroupAddon>
+      <InputGroupInput
+        inputMode="decimal"
+        value={value ?? ''}
+        onChange={event => onChange?.(event.target.value.replace(/[^\d.]/g, ''))}
+      />
+    </InputGroup>
+  )
+}

package/src/composites/date-chrome.tsx

@@ -0,0 +1,156 @@
+
+import * as React from 'react'
+import { addMonths, addYears, format, setMonth, setYear } from 'date-fns'
+import { ArrowDown, ArrowUp } from 'lucide-react'
+
+import { Button } from '@mohou/ui/components/button'
+import { useDateLocale, useLabels } from '@mohou/ui/i18n/context'
+import { cn } from '@mohou/ui/lib/utils'
+
+function Stepper({
+  onUp,
+  onDown,
+}: {
+  onUp: () => void
+  onDown: () => void
+}) {
+  return (
+    <div className="flex items-center">
+      <Button type="button" variant="ghost" size="icon-xs" aria-label="Previous" onClick={onUp}>
+        <ArrowUp className="size-3.5" />
+      </Button>
+      <Button type="button" variant="ghost" size="icon-xs" aria-label="Next" onClick={onDown}>
+        <ArrowDown className="size-3.5" />
+      </Button>
+    </div>
+  )
+}
+
+function decadeOf(year: number) {
+  return Math.floor(year / 12) * 12
+}
+
+export function DateChrome({
+  month,
+  onMonthChange,
+  onToday,
+  children,
+}: {
+  month: Date
+  onMonthChange: (month: Date) => void
+  onToday?: () => void
+  children: React.ReactNode
+}) {
+  const dateLocale = useDateLocale()
+  const common = useLabels('common')
+  const year = month.getFullYear()
+  const [yearPane, setYearPane] = React.useState(false)
+  const [decadeStart, setDecadeStart] = React.useState(() => decadeOf(year))
+
+  React.useEffect(() => {
+    if (year < decadeStart || year >= decadeStart + 12) {
+      setDecadeStart(decadeOf(year))
+    }
+  }, [year, decadeStart])
+
+  return (
+    <div className="flex" data-testid="date-chrome">
+      <div className="flex min-w-[252px] flex-col p-3">
+        <div className="mb-2 flex items-center justify-between gap-2">
+          <div className="text-sm font-semibold">{format(month, 'yyyy MMMM', { locale: dateLocale })}</div>
+          <Stepper
+            onUp={() => onMonthChange(addMonths(month, -1))}
+            onDown={() => onMonthChange(addMonths(month, 1))}
+          />
+        </div>
+        {children}
+      </div>
+      <div className="bg-border w-px" />
+      <div className="flex w-[220px] flex-col p-3">
+        <div className="mb-3 flex items-center justify-between">
+          <button
+            type="button"
+            data-testid="date-chrome-year"
+            className="hover:bg-muted rounded-md px-1.5 py-0.5 text-sm font-semibold"
+            onClick={() => setYearPane(open => !open)}
+          >
+            {yearPane ? `${decadeStart}–${decadeStart + 11}` : year}
+          </button>
+          <Stepper
+            onUp={() => {
+              if (yearPane) setDecadeStart(start => start - 12)
+              else onMonthChange(addYears(month, -1))
+            }}
+            onDown={() => {
+              if (yearPane) setDecadeStart(start => start + 12)
+              else onMonthChange(addYears(month, 1))
+            }}
+          />
+        </div>
+        {yearPane ? (
+          <div className="grid grid-cols-4 gap-x-1 gap-y-2">
+            {Array.from({ length: 12 }, (_, index) => {
+              const item = decadeStart + index
+              const active = item === year
+              return (
+                <button
+                  key={item}
+                  type="button"
+                  data-testid={`date-chrome-year-${item}`}
+                  className={cn(
+                    'rounded-md py-1.5 text-sm',
+                    active
+                      ? 'bg-primary/15 font-medium text-foreground'
+                      : 'text-muted-foreground hover:bg-muted hover:text-foreground'
+                  )}
+                  onClick={() => {
+                    onMonthChange(setYear(month, item))
+                    setYearPane(false)
+                  }}
+                >
+                  {item}
+                </button>
+              )
+            })}
+          </div>
+        ) : (
+          <div className="grid grid-cols-4 gap-x-1 gap-y-2">
+            {Array.from({ length: 12 }, (_, index) => {
+              const active = month.getMonth() === index
+              return (
+                <button
+                  key={index}
+                  type="button"
+                  data-testid={`date-chrome-month-${index}`}
+                  className={cn(
+                    'rounded-md py-1.5 text-sm',
+                    active
+                      ? 'bg-primary/15 font-medium text-foreground'
+                      : 'text-muted-foreground hover:bg-muted hover:text-foreground'
+                  )}
+                  onClick={() => onMonthChange(setMonth(month, index))}
+                >
+                  {format(new Date(year, index, 1), 'LLL', { locale: dateLocale })}
+                </button>
+              )
+            })}
+          </div>
+        )}
+        <Button
+          type="button"
+          variant="ghost"
+          size="sm"
+          className="mt-auto self-end"
+          data-testid="date-chrome-today"
+          onClick={() => {
+            setYearPane(false)
+            onMonthChange(new Date())
+            onToday?.()
+          }}
+        >
+          {common.today}
+        </Button>
+      </div>
+    </div>
+  )
+}