sparkdesign 0.4.8 → 0.4.9

package/cli/registry/basic/accordion.tsx

@@ -0,0 +1,79 @@
+"use client"
+
+import * as React from "react"
+import * as AccordionPrimitive from "@radix-ui/react-accordion"
+
+import { cn } from "@/lib/utils"
+import { ArrowDownSLine } from "./icons-inline"
+
+const Accordion = AccordionPrimitive.Root
+
+const AccordionItem = React.forwardRef<
+  React.ElementRef<typeof AccordionPrimitive.Item>,
+  React.ComponentPropsWithoutRef<typeof AccordionPrimitive.Item>
+>(({ className, ...props }, ref) => (
+  <AccordionPrimitive.Item
+    ref={ref}
+    data-slot="accordion-item"
+    className={cn("border-b border-border-tertiary last:border-b-0", className)}
+    {...props}
+  />
+))
+AccordionItem.displayName = "AccordionItem"
+
+const AccordionTrigger = React.forwardRef<
+  React.ElementRef<typeof AccordionPrimitive.Trigger>,
+  React.ComponentPropsWithoutRef<typeof AccordionPrimitive.Trigger> & {
+    chevronIcon?: React.ReactNode
+  }
+>(({ className, children, chevronIcon, ...props }, ref) => (
+  <AccordionPrimitive.Header className="flex">
+    <AccordionPrimitive.Trigger
+      ref={ref}
+      data-slot="accordion-trigger"
+      className={cn(
+        "group flex flex-1 items-center justify-between gap-2 py-4 text-left text-sm font-medium text-text transition-all outline-none hover:text-text-secondary",
+        "focus-visible:ring-2 focus-visible:ring-primary-border focus-visible:ring-offset-2 focus-visible:ring-offset-bg-base",
+        "disabled:pointer-events-none disabled:opacity-50",
+        className
+      )}
+      {...props}
+    >
+      {children}
+      <span
+        className="inline-flex shrink-0 transition-transform duration-200 group-data-[state=open]:rotate-180"
+        aria-hidden
+      >
+        {chevronIcon ?? <ArrowDownSLine className="size-4 text-text-secondary" />}
+      </span>
+    </AccordionPrimitive.Trigger>
+  </AccordionPrimitive.Header>
+))
+AccordionTrigger.displayName = "AccordionTrigger"
+
+const AccordionContent = React.forwardRef<
+  React.ElementRef<typeof AccordionPrimitive.Content>,
+  React.ComponentPropsWithoutRef<typeof AccordionPrimitive.Content>
+>(({ className, children, ...props }, ref) => (
+  <AccordionPrimitive.Content
+    ref={ref}
+    data-slot="accordion-content"
+    className={cn(
+      "overflow-hidden text-sm text-text-secondary data-[state=closed]:animate-accordion-up data-[state=open]:animate-accordion-down",
+      className
+    )}
+    {...props}
+  >
+    <div className="pb-4 pt-0">{children}</div>
+  </AccordionPrimitive.Content>
+))
+AccordionContent.displayName = "AccordionContent"
+
+export type AccordionProps = React.ComponentPropsWithoutRef<typeof AccordionPrimitive.Root>
+export type AccordionItemProps = React.ComponentPropsWithoutRef<typeof AccordionPrimitive.Item>
+export type AccordionTriggerProps = React.ComponentPropsWithoutRef<typeof AccordionPrimitive.Trigger> & {
+  chevronIcon?: React.ReactNode
+}
+export type AccordionContentProps = React.ComponentPropsWithoutRef<typeof AccordionPrimitive.Content>
+
+export { Accordion, AccordionItem, AccordionTrigger, AccordionContent }

package/cli/registry/basic/badge.tsx

@@ -0,0 +1,49 @@
+import * as React from "react"
+import { Slot } from "@radix-ui/react-slot"
+import { cva, type VariantProps } from "class-variance-authority"
+
+import { cn } from "@/lib/utils"
+
+const badgeVariants = cva(
+  "inline-flex items-center justify-center gap-1 rounded-md border px-2 py-0.5 text-xs font-medium whitespace-nowrap transition-colors focus:outline-none focus-visible:ring-2 focus-visible:ring-primary-border focus-visible:ring-offset-2 focus-visible:ring-offset-bg-base [&>svg]:size-3 [&>svg]:pointer-events-none",
+  {
+    variants: {
+      variant: {
+        default: "border-transparent bg-primary text-text-on-primary hover:bg-primary-hover",
+        secondary: "border-transparent bg-fill-secondary text-text hover:bg-fill",
+        destructive: "border-transparent bg-error text-text-on-primary hover:bg-error-hover",
+        outline: "border-border-tertiary bg-transparent text-text",
+      },
+    },
+    defaultVariants: {
+      variant: "default",
+    },
+  }
+)
+
+function Badge({
+  className,
+  variant,
+  asChild = false,
+  ...props
+}: React.ComponentProps<"span"> &
+  VariantProps<typeof badgeVariants> & {
+    asChild?: boolean
+  }) {
+  const Comp = asChild ? Slot : "span"
+
+  return (
+    <Comp
+      data-slot="badge"
+      className={cn(badgeVariants({ variant }), className)}
+      {...props}
+    />
+  )
+}
+
+export type BadgeProps = React.ComponentProps<"span"> &
+  VariantProps<typeof badgeVariants> & {
+    asChild?: boolean
+  }
+
+export { Badge, badgeVariants }

package/cli/registry/basic/button.tsx

@@ -2,11 +2,10 @@ import { forwardRef } from 'react'
 import type { ButtonHTMLAttributes, ReactNode } from 'react'
 import { Slot } from 'radix-ui'
 import { cva, type VariantProps } from 'class-variance-authority'
-import { cn } from '@/lib/utils'
 import { Spinner } from './spinner'
 
 const buttonVariants = cva(
-  'inline-flex items-center justify-center gap-1.5 font-medium transition-[colors,transform] duration-200 active:scale-[0.98] focus:outline-none disabled:opacity-50 disabled:cursor-not-allowed cursor-pointer',
+  'inline-flex items-center justify-center gap-1.5 font-medium transition-[color,background-color,border-color,box-shadow,transform] duration-200 active:scale-[0.98] focus:outline-none disabled:opacity-50 disabled:cursor-not-allowed cursor-pointer',
   {
     variants: {
       variant: {
@@ -91,18 +90,24 @@ const Button = forwardRef<HTMLButtonElement, ButtonProps>(
         aria-busy={loading || undefined}
         {...props}
       >
-        {loading ? (
-          <Spinner className="shrink-0" />
-        ) : prefixIcon ? (
-          <span className="inline-flex shrink-0 items-center justify-center [&>*]:block [&>*]:leading-none">
-            {prefixIcon}
-          </span>
-        ) : null}
-        {children}
-        {suffixIcon && (
-          <span className="inline-flex shrink-0 items-center justify-center [&>*]:block [&>*]:leading-none">
-            {suffixIcon}
-          </span>
+        {asChild ? (
+          children
+        ) : (
+          <>
+            {loading ? (
+              <Spinner className="shrink-0" />
+            ) : prefixIcon ? (
+              <span className="inline-flex shrink-0 items-center justify-center [&>*]:block [&>*]:leading-none">
+                {prefixIcon}
+              </span>
+            ) : null}
+            {children}
+            {suffixIcon && (
+              <span className="inline-flex shrink-0 items-center justify-center [&>*]:block [&>*]:leading-none">
+                {suffixIcon}
+              </span>
+            )}
+          </>
         )}
       </Comp>
     )

package/cli/registry/basic/collapsible-card.tsx

@@ -1,4 +1,4 @@
-import { useState, useRef, useLayoutEffect, type ReactNode } from 'react'
+import { useState, useRef, useLayoutEffect, type KeyboardEvent, type ReactNode } from 'react'
 import { motion, AnimatePresence } from 'framer-motion'
 import { cn } from '@/lib/utils'
 import { MOTION_EXPAND } from '@/lib/motion'
@@ -89,6 +89,13 @@ export function CollapsibleCard({
     setTimeout(() => setIsAnimating(false), 300)
   }
 
+  const handleToggleKeyDown = (event: KeyboardEvent<HTMLDivElement>) => {
+    if (!collapsible) return
+    if (event.key !== 'Enter' && event.key !== ' ') return
+    event.preventDefault()
+    handleToggle()
+  }
+
   const showArrow = collapsible && (isHovered || headerIcon == null)
   const headerIconNode = showArrow
     ? <ArrowDownSLine className={cn('w-[var(--font-size-sm)] h-[var(--font-size-sm)] shrink-0 transition-transform duration-200 text-text-secondary', isExpanded ? 'rotate-0' : '-rotate-90')} />
@@ -123,7 +130,9 @@ export function CollapsibleCard({
         <div
           className={cn('flex flex-row items-center gap-2 flex-1 min-w-0', collapsible && 'cursor-pointer')}
           onClick={handleToggle}
+          onKeyDown={handleToggleKeyDown}
           role={collapsible ? 'button' : undefined}
+          tabIndex={collapsible ? 0 : undefined}
           aria-expanded={collapsible ? isExpanded : undefined}
         >
           <div className="w-[var(--font-size-sm)] h-[var(--font-size-sm)] flex items-center justify-center shrink-0 text-text-secondary [&>svg]:w-[var(--font-size-sm)] [&>svg]:h-[var(--font-size-sm)]">

package/cli/registry/basic/ellipsis-text.tsx

@@ -0,0 +1,151 @@
+import {
+  useCallback,
+  useEffect,
+  useRef,
+  useState,
+  forwardRef,
+  type ReactNode,
+  type CSSProperties,
+} from 'react'
+import { clsx } from 'clsx'
+import { Tooltip } from './tooltip'
+
+export interface EllipsisTextProps {
+  /** Text or inline content to display. */
+  children: ReactNode
+  /**
+   * Maximum visible lines before truncation.
+   * @default 1
+   */
+  lines?: number
+  /** Extra className for the text node. */
+  className?: string
+  /**
+   * Tooltip placement when overflow is detected.
+   * @default 'top'
+   */
+  placement?: 'top' | 'bottom' | 'left' | 'right'
+  /** Extra className for Tooltip content. */
+  tooltipClassName?: string
+  /** Custom tooltip content. Defaults to children. */
+  tooltipContent?: ReactNode
+  /**
+   * Disable tooltip even when content overflows.
+   * @default false
+   */
+  disabled?: boolean
+  /** Inline style for the text node. */
+  style?: CSSProperties
+  /**
+   * Rendered text element.
+   * @default 'span'
+   */
+  as?: 'span' | 'div' | 'p'
+}
+
+function setRef<T>(ref: React.Ref<T> | undefined, value: T | null) {
+  if (!ref) return
+  if (typeof ref === 'function') ref(value)
+  else (ref as React.MutableRefObject<T | null>).current = value
+}
+
+export const EllipsisText = forwardRef<HTMLElement, EllipsisTextProps>(
+  (
+    {
+      children,
+      lines = 1,
+      className = '',
+      placement = 'top',
+      tooltipClassName = '',
+      tooltipContent,
+      disabled = false,
+      style,
+      as: Component = 'span',
+    },
+    ref
+  ) => {
+    const textRef = useRef<HTMLElement>(null)
+    const [isOverflowing, setIsOverflowing] = useState(false)
+
+    const checkOverflow = useCallback(() => {
+      const el = textRef.current
+      if (!el) return
+      const overflowing =
+        lines === 1
+          ? el.scrollWidth > el.clientWidth
+          : el.scrollHeight > el.clientHeight
+      setIsOverflowing(overflowing)
+    }, [lines])
+
+    useEffect(() => {
+      const raf = requestAnimationFrame(() => checkOverflow())
+      const el = textRef.current
+      if (!el) return () => cancelAnimationFrame(raf)
+      const ro = new ResizeObserver(() => checkOverflow())
+      ro.observe(el)
+      window.addEventListener('resize', checkOverflow)
+      return () => {
+        cancelAnimationFrame(raf)
+        ro.disconnect()
+        window.removeEventListener('resize', checkOverflow)
+      }
+    }, [checkOverflow, children])
+
+    const ellipsisStyle: CSSProperties =
+      lines === 1
+        ? {
+            display: 'block',
+            overflow: 'hidden',
+            textOverflow: 'ellipsis',
+            whiteSpace: 'nowrap',
+            ...style,
+          }
+        : {
+            overflow: 'hidden',
+            display: '-webkit-box',
+            WebkitLineClamp: lines,
+            WebkitBoxOrient: 'vertical',
+            ...style,
+          }
+
+    const refCallback = useCallback(
+      (el: HTMLElement | null) => {
+        setRef(textRef, el)
+        setRef(ref, el)
+      },
+      [ref]
+    )
+
+    const triggerNode = (
+      <Component
+        ref={refCallback}
+        className={className}
+        style={ellipsisStyle}
+      >
+        {children}
+      </Component>
+    )
+
+    const useTooltip = isOverflowing && !disabled
+    if (useTooltip) {
+      return (
+        <Tooltip
+          content={tooltipContent ?? children}
+          side={placement}
+          contentClassName={clsx(tooltipClassName)}
+        >
+          <span
+            ref={refCallback}
+            className={className}
+            style={ellipsisStyle}
+          >
+            {children}
+          </span>
+        </Tooltip>
+      )
+    }
+    return triggerNode
+  }
+)
+
+EllipsisText.displayName = 'EllipsisText'

package/cli/registry/basic/form.tsx

@@ -0,0 +1,186 @@
+"use client"
+
+import * as React from "react"
+import * as LabelPrimitive from "@radix-ui/react-label"
+import { Slot } from "@radix-ui/react-slot"
+import {
+  Controller,
+  FormProvider,
+  useFormContext,
+  type ControllerProps,
+  type FieldPath,
+  type FieldValues,
+} from "react-hook-form"
+
+import { cn } from "@/lib/utils"
+import { Label } from "./label"
+
+const Form = FormProvider
+
+type FormFieldContextValue<
+  TFieldValues extends FieldValues = FieldValues,
+  TName extends FieldPath<TFieldValues> = FieldPath<TFieldValues>,
+> = {
+  name: TName
+}
+
+const FormFieldContext = React.createContext<FormFieldContextValue>(
+  {} as FormFieldContextValue
+)
+
+function FormField<
+  TFieldValues extends FieldValues = FieldValues,
+  TName extends FieldPath<TFieldValues> = FieldPath<TFieldValues>,
+>({ ...props }: ControllerProps<TFieldValues, TName>) {
+  return (
+    <FormFieldContext.Provider value={{ name: props.name }}>
+      <Controller {...props} />
+    </FormFieldContext.Provider>
+  )
+}
+
+type FormItemContextValue = {
+  id: string
+}
+
+const FormItemContext = React.createContext<FormItemContextValue>(
+  {} as FormItemContextValue
+)
+
+function useFormField() {
+  const fieldContext = React.useContext(FormFieldContext)
+  const itemContext = React.useContext(FormItemContext)
+  const { getFieldState, formState } = useFormContext()
+
+  if (!fieldContext.name) {
+    throw new Error("useFormField should be used within <FormField>")
+  }
+
+  const fieldState = getFieldState(fieldContext.name, formState)
+
+  const { id } = itemContext
+
+  return {
+    id,
+    name: fieldContext.name,
+    formItemId: `${id}-form-item`,
+    formDescriptionId: `${id}-form-item-description`,
+    formMessageId: `${id}-form-item-message`,
+    ...fieldState,
+  }
+}
+
+const FormItem = React.forwardRef<
+  HTMLDivElement,
+  React.HTMLAttributes<HTMLDivElement>
+>(({ className, ...props }, ref) => {
+  const id = React.useId()
+
+  return (
+    <FormItemContext.Provider value={{ id }}>
+      <div
+        ref={ref}
+        data-slot="form-item"
+        className={cn("space-y-2", className)}
+        {...props}
+      />
+    </FormItemContext.Provider>
+  )
+})
+FormItem.displayName = "FormItem"
+
+const FormLabel = React.forwardRef<
+  React.ElementRef<typeof LabelPrimitive.Root>,
+  React.ComponentPropsWithoutRef<typeof LabelPrimitive.Root>
+>(({ className, ...props }, ref) => {
+  const { error, formItemId } = useFormField()
+
+  return (
+    <Label
+      ref={ref}
+      data-slot="form-label"
+      data-error={!!error}
+      className={cn("data-[error=true]:text-error", className)}
+      htmlFor={formItemId}
+      {...props}
+    />
+  )
+})
+FormLabel.displayName = "FormLabel"
+
+const FormControl = React.forwardRef<
+  React.ElementRef<typeof Slot>,
+  React.ComponentPropsWithoutRef<typeof Slot>
+>(({ ...props }, ref) => {
+  const { error, formItemId, formDescriptionId, formMessageId } = useFormField()
+
+  return (
+    <Slot
+      ref={ref}
+      data-slot="form-control"
+      id={formItemId}
+      aria-describedby={
+        !error
+          ? `${formDescriptionId}`
+          : `${formDescriptionId} ${formMessageId}`
+      }
+      aria-invalid={!!error}
+      {...props}
+    />
+  )
+})
+FormControl.displayName = "FormControl"
+
+const FormDescription = React.forwardRef<
+  HTMLParagraphElement,
+  React.HTMLAttributes<HTMLParagraphElement>
+>(({ className, ...props }, ref) => {
+  const { formDescriptionId } = useFormField()
+
+  return (
+    <p
+      ref={ref}
+      id={formDescriptionId}
+      data-slot="form-description"
+      className={cn("text-sm text-text-tertiary", className)}
+      {...props}
+    />
+  )
+})
+FormDescription.displayName = "FormDescription"
+
+const FormMessage = React.forwardRef<
+  HTMLParagraphElement,
+  React.HTMLAttributes<HTMLParagraphElement>
+>(({ className, children, ...props }, ref) => {
+  const { error, formMessageId } = useFormField()
+  const body = error ? String(error?.message ?? "") : children
+
+  if (!body) {
+    return null
+  }
+
+  return (
+    <p
+      ref={ref}
+      id={formMessageId}
+      data-slot="form-message"
+      className={cn("text-sm font-medium text-error", className)}
+      {...props}
+    >
+      {body}
+    </p>
+  )
+})
+FormMessage.displayName = "FormMessage"
+
+export {
+  useFormField,
+  Form,
+  FormItem,
+  FormLabel,
+  FormControl,
+  FormDescription,
+  FormMessage,
+  FormField,
+}

package/cli/registry/basic/icon-button.tsx

@@ -5,7 +5,7 @@ import { cva, type VariantProps } from 'class-variance-authority'
 import { cn } from '@/lib/utils'
 
 const iconButtonVariants = cva(
-  'flex-none shrink-0 inline-flex items-center justify-center box-border transition-[colors,transform] duration-200 active:scale-[0.98] focus:outline-none disabled:opacity-50 disabled:cursor-not-allowed cursor-pointer [&>*]:flex [&>*]:items-center [&>*]:justify-center [&>*]:size-full [&>*]:[&>svg]:block [&>*]:[&>svg]:leading-none',
+  'flex-none shrink-0 inline-flex items-center justify-center box-border transition-[color,background-color,border-color,box-shadow,transform] duration-200 active:scale-[0.98] focus:outline-none disabled:opacity-50 disabled:cursor-not-allowed cursor-pointer [&>*]:flex [&>*]:items-center [&>*]:justify-center [&>*]:size-full [&>*]:[&>svg]:block [&>*]:[&>svg]:leading-none',
   {
     variants: {
       variant: {
@@ -34,9 +34,17 @@ const iconButtonVariants = cva(
   }
 )
 
-export interface IconButtonProps
-  extends ButtonHTMLAttributes<HTMLButtonElement>,
-    VariantProps<typeof iconButtonVariants> {
+type IconButtonAccessibleName =
+  | { 'aria-label': string; 'aria-labelledby'?: string; title?: string }
+  | { 'aria-label'?: string; 'aria-labelledby': string; title?: string }
+  | { 'aria-label'?: string; 'aria-labelledby'?: string; title: string }
+
+export type IconButtonProps = Omit<
+  ButtonHTMLAttributes<HTMLButtonElement>,
+  'aria-label' | 'aria-labelledby' | 'title'
+> &
+  VariantProps<typeof iconButtonVariants> &
+  IconButtonAccessibleName & {
   icon: ReactNode
   asChild?: boolean
 }