sparkdesign 0.4.8 → 0.4.10

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
 }

package/cli/registry/basic/popover.tsx

@@ -14,6 +14,8 @@ export interface PopoverContentProps
   /** When provided (e.g. from ThemeStyleProvider), used for portal wrapper */
   dataStyle?: string
   dataTheme?: string
+  /** Popover internal padding; keep default to avoid breaking existing usages */
+  contentPadding?: 'default' | 'compact' | 'none'
 }
 
 const PopoverContent = React.forwardRef<
@@ -21,7 +23,16 @@ const PopoverContent = React.forwardRef<
   PopoverContentProps
 >(
   (
-    { className, align = 'center', sideOffset = 4, children, dataStyle, dataTheme, ...props },
+    {
+      className,
+      align = 'center',
+      sideOffset = 4,
+      contentPadding = 'default',
+      children,
+      dataStyle,
+      dataTheme,
+      ...props
+    },
     ref,
   ) => {
     const fromDoc = getThemeFromDocument()
@@ -34,10 +45,16 @@ const PopoverContent = React.forwardRef<
         <div style={{ display: 'contents' }} {...dataProps}>
           <PopoverPrimitive.Content
             ref={ref}
+            data-slot="popover-content"
             align={align}
             sideOffset={sideOffset}
             className={cn(
-              'z-50 w-72 rounded-lg border border-border-tertiary bg-bg-container p-4 text-sm text-text shadow-md outline-none',
+              'z-50 w-72 rounded-lg border border-border-tertiary bg-bg-container text-sm text-text shadow-md outline-none',
+              contentPadding === 'none'
+                ? 'p-0'
+                : contentPadding === 'compact'
+                  ? 'p-1'
+                  : 'p-4',
               className,
             )}
             {...props}

package/cli/registry/basic/rating.tsx

@@ -0,0 +1,161 @@
+import * as React from 'react'
+import { cva, type VariantProps } from 'class-variance-authority'
+
+import { cn } from '@/lib/utils'
+
+const ratingVariants = cva('inline-flex items-center gap-1', {
+  variants: {
+    size: {
+      sm: '[--rating-size:1rem]',
+      md: '[--rating-size:1.25rem]',
+      lg: '[--rating-size:1.5rem]',
+    },
+  },
+  defaultVariants: {
+    size: 'md',
+  },
+})
+
+type RatingPrecision = 1 | 0.5
+
+export interface RatingProps
+  extends Omit<React.HTMLAttributes<HTMLDivElement>, 'onChange'>,
+    VariantProps<typeof ratingVariants> {
+  value?: number
+  defaultValue?: number
+  onValueChange?: (value: number) => void
+  max?: number
+  precision?: RatingPrecision
+  readOnly?: boolean
+  disabled?: boolean
+  showValue?: boolean
+  label?: string
+}
+
+function clampRating(value: number, max: number, precision: RatingPrecision) {
+  const normalized = Math.max(0, Math.min(max, value))
+  return Math.round(normalized / precision) * precision
+}
+
+function RatingStar({ className }: { className?: string }) {
+  return (
+    <svg
+      aria-hidden="true"
+      viewBox="0 0 20 20"
+      className={cn('size-[var(--rating-size)]', className)}
+    >
+      <path d="M10 1.7l2.3 4.7 5.2.8-3.8 3.7.9 5.2-4.6-2.5-4.6 2.5.9-5.2-3.8-3.7 5.2-.8L10 1.7z" />
+    </svg>
+  )
+}
+
+const Rating = React.forwardRef<HTMLDivElement, RatingProps>(
+  (
+    {
+      className,
+      size,
+      value,
+      defaultValue = 0,
+      onValueChange,
+      max = 5,
+      precision = 1,
+      readOnly = false,
+      disabled = false,
+      showValue = false,
+      label = 'Rating',
+      ...props
+    },
+    ref
+  ) => {
+    const [internalValue, setInternalValue] = React.useState(defaultValue)
+    const currentValue = clampRating(value ?? internalValue, max, precision)
+    const interactive = !readOnly && !disabled
+
+    const commitValue = (nextValue: number) => {
+      const next = clampRating(nextValue, max, precision)
+      if (value == null) setInternalValue(next)
+      onValueChange?.(next)
+    }
+
+    return (
+      <div
+        ref={ref}
+        role={interactive ? 'radiogroup' : 'img'}
+        aria-label={label}
+        aria-disabled={disabled || undefined}
+        aria-readonly={readOnly || undefined}
+        aria-valuenow={!interactive ? currentValue : undefined}
+        aria-valuemax={!interactive ? max : undefined}
+        data-slot="rating"
+        data-disabled={disabled || undefined}
+        className={cn(
+          ratingVariants({ size }),
+          disabled && 'cursor-not-allowed opacity-50',
+          className
+        )}
+        {...props}
+      >
+        {Array.from({ length: max }, (_, index) => {
+          const starValue = index + 1
+          const fillRatio = Math.max(0, Math.min(1, currentValue - index))
+          const halfValue = starValue - 0.5
+          return (
+            <span
+              key={starValue}
+              className="relative inline-flex size-[var(--rating-size)] shrink-0 text-border-tertiary"
+            >
+              <RatingStar className="fill-current" />
+              <span
+                aria-hidden="true"
+                className="absolute inset-0 overflow-hidden text-warning"
+                style={{ width: `${fillRatio * 100}%` }}
+              >
+                <RatingStar className="fill-current" />
+              </span>
+              {interactive ? (
+                precision === 0.5 ? (
+                  <span className="absolute inset-0 grid grid-cols-2">
+                    <button
+                      type="button"
+                      role="radio"
+                      aria-label={`${halfValue} of ${max}`}
+                      aria-checked={currentValue === halfValue}
+                      className="cursor-pointer focus:outline-none focus-visible:ring-2 focus-visible:ring-primary-border"
+                      onClick={() => commitValue(halfValue)}
+                    />
+                    <button
+                      type="button"
+                      role="radio"
+                      aria-label={`${starValue} of ${max}`}
+                      aria-checked={currentValue === starValue}
+                      className="cursor-pointer focus:outline-none focus-visible:ring-2 focus-visible:ring-primary-border"
+                      onClick={() => commitValue(starValue)}
+                    />
+                  </span>
+                ) : (
+                  <button
+                    type="button"
+                    role="radio"
+                    aria-label={`${starValue} of ${max}`}
+                    aria-checked={currentValue === starValue}
+                    className="absolute inset-0 cursor-pointer focus:outline-none focus-visible:ring-2 focus-visible:ring-primary-border"
+                    onClick={() => commitValue(starValue)}
+                  />
+                )
+              ) : null}
+            </span>
+          )
+        })}
+        {showValue ? (
+          <span className="ml-1 text-sm font-medium text-text-secondary">
+            {currentValue.toFixed(precision === 0.5 && currentValue % 1 ? 1 : 0)}
+          </span>
+        ) : null}
+      </div>
+    )
+  }
+)
+Rating.displayName = 'Rating'
+
+export { Rating, ratingVariants }
+export type { RatingPrecision }