@otfdashkit/ui 0.1.1 → 0.1.3

package/src/forms/step-form.tsx

@@ -1,113 +1 @@
-import React, { createContext, useContext, useState } from 'react'
-import { Button } from '../primitives/button'
-import { cn } from '../utils/cn'
-
-interface StepFormContextValue {
-  currentStep: number
-  totalSteps: number
-  steps: string[]
-  next: () => void
-  prev: () => void
-  isFirst: boolean
-  isLast: boolean
-}
-
-const StepFormContext = createContext<StepFormContextValue | null>(null)
-
-function useStepForm() {
-  const ctx = useContext(StepFormContext)
-  if (!ctx) throw new Error('useStepForm must be used within StepForm')
-  return ctx
-}
-
-export interface StepFormProps {
-  steps: string[]
-  onSubmit: () => void
-  children: React.ReactNode
-  className?: string
-}
-
-export function StepForm({ steps, onSubmit, children, className }: StepFormProps) {
-  const [currentStep, setCurrentStep] = useState(0)
-  const totalSteps = steps.length
-
-  const ctx: StepFormContextValue = {
-    currentStep,
-    totalSteps,
-    steps,
-    next: () => setCurrentStep(s => Math.min(s + 1, totalSteps - 1)),
-    prev: () => setCurrentStep(s => Math.max(s - 1, 0)),
-    isFirst: currentStep === 0,
-    isLast: currentStep === totalSteps - 1,
-  }
-
-  const childArray = React.Children.toArray(children)
-  const currentChild = childArray[currentStep]
-
-  return (
-    <StepFormContext.Provider value={ctx}>
-      <div className={cn('flex flex-col gap-6', className)}>
-        <StepIndicator steps={steps} currentStep={currentStep} />
-        <div>{currentChild}</div>
-        <StepFormNavigation onSubmit={onSubmit} />
-      </div>
-    </StepFormContext.Provider>
-  )
-}
-
-function StepIndicator({ steps, currentStep }: { steps: string[]; currentStep: number }) {
-  return (
-    <div className="flex items-center gap-2">
-      {steps.map((label, i) => (
-        <React.Fragment key={i}>
-          {i > 0 && <div className={cn('h-px flex-1 bg-[hsl(var(--border))]', i <= currentStep && 'bg-[hsl(var(--primary))]')} />}
-          <div className="flex flex-col items-center gap-1">
-            <div className={cn(
-              'flex h-7 w-7 items-center justify-center rounded-full text-xs font-medium border transition-colors',
-              i < currentStep && 'bg-[hsl(var(--primary))] border-[hsl(var(--primary))] text-[hsl(var(--primary-foreground))]',
-              i === currentStep && 'border-[hsl(var(--primary))] text-[hsl(var(--primary))]',
-              i > currentStep && 'border-[hsl(var(--border))] text-[hsl(var(--muted-foreground))]'
-            )}>{i + 1}</div>
-            <span className="hidden text-[10px] text-[hsl(var(--muted-foreground))] sm:block">{label}</span>
-          </div>
-        </React.Fragment>
-      ))}
-    </div>
-  )
-}
-
-export interface StepFormStepProps {
-  title: string
-  description?: string
-  children: React.ReactNode
-}
-
-export function StepFormStep({ title, description, children }: StepFormStepProps) {
-  return (
-    <div className="flex flex-col gap-4">
-      <div>
-        <h3 className="text-base font-semibold text-[hsl(var(--foreground))]">{title}</h3>
-        {description && <p className="text-sm text-[hsl(var(--muted-foreground))]">{description}</p>}
-      </div>
-      {children}
-    </div>
-  )
-}
-
-export interface StepFormNavigationProps {
-  onSubmit?: () => void
-  submitLabel?: string
-}
-
-export function StepFormNavigation({ onSubmit, submitLabel = 'Submit' }: StepFormNavigationProps) {
-  const { prev, next, isFirst, isLast } = useStepForm()
-  return (
-    <div className="flex justify-between">
-      <Button type="button" variant="outline" onClick={prev} disabled={isFirst}>Previous</Button>
-      {isLast
-        ? <Button type="button" onClick={onSubmit}>{submitLabel}</Button>
-        : <Button type="button" onClick={next}>Next</Button>
-      }
-    </div>
-  )
-}
+export * from './StepForm'

package/src/index.ts

@@ -13,6 +13,7 @@ export * from './primitives/button'
 export * from './primitives/calendar'
 export * from './primitives/card'
 export * from './primitives/carousel'
+export * from './primitives/cart-line-item'
 export * from './primitives/chart'
 export * from './primitives/checkbox'
 export * from './primitives/code-block'
@@ -23,7 +24,8 @@ export * from './primitives/context-menu'
 export * from './primitives/dialog'
 export * from './primitives/drawer'
 export * from './primitives/dropdown-menu'
-export * from './primitives/form'
+export * from './primitives/empty-cart'
+// export * from './primitives/form'  // conflicts with forms/form.tsx (Form, FormField, etc.)
 export * from './primitives/hover-card'
 export * from './primitives/input-otp'
 export * from './primitives/input'
@@ -34,8 +36,10 @@ export * from './primitives/menubar'
 export * from './primitives/navigation-menu'
 export * from './primitives/pagination'
 export * from './primitives/popover'
+export * from './primitives/price-tag'
 export * from './primitives/progress'
 export * from './primitives/qr-code'
+export * from './primitives/quantity-stepper'
 export * from './primitives/radio'
 export * from './primitives/rating'
 export * from './primitives/resizable'
@@ -55,11 +59,12 @@ export * from './primitives/texture-card'
 export * from './primitives/toggle-group'
 export * from './primitives/toggle'
 export * from './primitives/tooltip'
+export * from './primitives/variant-picker'
 
 // components
 export * from './components/banner'
 export * from './components/breadcrumb'
-export * from './components/command-item'
+export { CommandListItem } from './components/command-item'
 export * from './components/data-grid'
 export * from './components/data-table'
 export * from './components/empty-state'
@@ -132,6 +137,7 @@ export * from './forms/color-picker'
 export * from './forms/date-picker'
 export * from './forms/field'
 export * from './forms/file-upload'
+export * from './forms/floating-label-input'
 export * from './forms/form'
 export * from './forms/object-field'
 export * from './forms/password-input'
@@ -153,7 +159,9 @@ export * from './layouts/stack'
 export { PageLayout } from './layout/PageLayout'
 export type { PageHeaderProps } from './layout/PageLayout'
 export { PageContainer, PageMain } from './layout/PageContainer'
-export * from './nav'
+export type { CommandPaletteProps } from './nav/CommandPalette'
+export { CommandPaletteProvider, useCommandPalette, CommandPalette } from './nav/CommandPalette'
+export * from './nav/HotkeysProvider'
 export * from './feedback'
 export * from './text'
 export * from './backgrounds'

package/src/primitives/Button/Button.tsx

@@ -43,6 +43,24 @@ const buttonVariants = cva(
           'hover:border-border/60 hover:bg-accent',
           'active:shadow-none',
         ].join(' '),
+        /** Shimmer — animated conic gradient sweep with a hover highlight.
+         *  Loud + premium; reserve for primary CTAs and pricing pages, not
+         *  for in-product UI (gets tiring fast). Cross-platform parity with
+         *  @otfdashkit/ui-native via the same `shimmer` variant key. */
+        shimmer: [
+          'relative isolate overflow-hidden',
+          'bg-primary text-primary-foreground',
+          'shadow-[0_1px_0_rgba(255,255,255,0.18)_inset,0_-1px_0_rgba(0,0,0,0.25)_inset]',
+          'hover:bg-primary/95',
+          // Continuous conic-gradient sweep behind the surface.
+          'before:absolute before:inset-[-1px] before:rounded-[inherit] before:-z-10',
+          'before:bg-[conic-gradient(from_0deg,transparent_0deg,transparent_70deg,rgba(255,255,255,0.55)_90deg,transparent_110deg,transparent_360deg)]',
+          'before:animate-[shimmer-rotate_2.6s_linear_infinite]',
+          // Diagonal gloss that sweeps on hover.
+          'after:absolute after:inset-0 after:rounded-[inherit] after:pointer-events-none',
+          'after:bg-[linear-gradient(115deg,transparent_30%,rgba(255,255,255,0.22)_50%,transparent_70%)]',
+          'after:translate-x-[-120%] hover:after:translate-x-[120%] after:transition-transform after:duration-[900ms] after:ease-out',
+        ].join(' '),
       },
       size: {
         sm:      'h-8 px-3 text-xs rounded-md',

package/src/primitives/cart-line-item.tsx

@@ -0,0 +1,81 @@
+import React from 'react'
+import { X } from 'lucide-react'
+import { cn } from '../utils/cn'
+import { Button } from './button'
+import { PriceTag } from './price-tag'
+import { QuantityStepper } from './quantity-stepper'
+
+export type CartLineItemProps = Omit<React.HTMLAttributes<HTMLDivElement>, 'onChange'> & {
+  /** Product thumbnail URL. */
+  image?: string
+  title: string
+  /** Variant summary line, e.g. "Whole bean · 250g". */
+  variant?: string
+  /** Unit price in minor units (cents). */
+  price: number
+  /** Optional compare-at unit price in minor units. */
+  compareAt?: number
+  currency?: string
+  quantity: number
+  onQuantityChange?: (qty: number) => void
+  onRemove?: () => void
+  minQuantity?: number
+  maxQuantity?: number
+}
+
+/** Cart row: thumbnail · title · variant · price · quantity stepper · remove. */
+export const CartLineItem = React.forwardRef<HTMLDivElement, CartLineItemProps>(
+  (
+    {
+      image,
+      title,
+      variant,
+      price,
+      compareAt,
+      currency = 'USD',
+      quantity,
+      onQuantityChange,
+      onRemove,
+      minQuantity = 1,
+      maxQuantity = 99,
+      className,
+      ...props
+    },
+    ref,
+  ) => {
+    return (
+      <div
+        ref={ref}
+        className={cn('flex items-center gap-4 rounded-lg border border-border bg-card p-3', className)}
+        {...props}
+      >
+        {image && <img src={image} alt="" className="h-16 w-16 flex-none rounded-md object-cover" />}
+        <div className="flex min-w-0 flex-1 flex-col gap-1">
+          <span className="truncate font-medium text-card-foreground">{title}</span>
+          {variant && <span className="truncate text-sm text-muted-foreground">{variant}</span>}
+          <PriceTag amount={price} compareAt={compareAt} currency={currency} size="sm" />
+        </div>
+        <QuantityStepper
+          value={quantity}
+          min={minQuantity}
+          max={maxQuantity}
+          onValueChange={onQuantityChange}
+          size="sm"
+        />
+        {onRemove && (
+          <Button
+            type="button"
+            variant="ghost"
+            size="icon"
+            className="h-8 w-8 text-muted-foreground hover:text-destructive"
+            onClick={onRemove}
+            aria-label={`Remove ${title}`}
+          >
+            <X className="h-4 w-4" />
+          </Button>
+        )}
+      </div>
+    )
+  },
+)
+CartLineItem.displayName = 'CartLineItem'

package/src/primitives/code-block.tsx

@@ -106,7 +106,7 @@ export const CodeBlock = React.forwardRef<HTMLDivElement, CodeBlockProps>(
     return (
       <div
         ref={(node) => {
-          containerRef.current = node
+          (containerRef as React.MutableRefObject<HTMLDivElement | null>).current = node
           if (typeof ref === 'function') ref(node)
           else if (ref) (ref as React.MutableRefObject<HTMLDivElement | null>).current = node
         }}

package/src/primitives/comparison.tsx

@@ -100,7 +100,7 @@ export const Comparison = React.forwardRef<HTMLDivElement, ComparisonProps>(
     return (
       <div
         ref={(node) => {
-          containerRef.current = node
+          (containerRef as React.MutableRefObject<HTMLDivElement | null>).current = node
           if (typeof ref === 'function') ref(node)
           else if (ref) (ref as React.MutableRefObject<HTMLDivElement | null>).current = node
         }}

package/src/primitives/empty-cart.tsx

@@ -0,0 +1,52 @@
+import React from 'react'
+import { ShoppingCart } from 'lucide-react'
+import { cn } from '../utils/cn'
+import { Button } from './button'
+
+export type EmptyCartProps = React.HTMLAttributes<HTMLDivElement> & {
+  title?: string
+  description?: string
+  /** CTA label — renders a button only when `onAction` is also provided. */
+  actionLabel?: string
+  onAction?: () => void
+  /** Override the default cart icon. */
+  icon?: React.ReactNode
+}
+
+/** Bespoke empty-cart state: soft icon chip, message, and a continue-shopping CTA. */
+export const EmptyCart = React.forwardRef<HTMLDivElement, EmptyCartProps>(
+  (
+    {
+      title = 'Your cart is empty',
+      description = 'Browse the catalog and add something you love.',
+      actionLabel = 'Continue shopping',
+      onAction,
+      icon,
+      className,
+      ...props
+    },
+    ref,
+  ) => {
+    return (
+      <div
+        ref={ref}
+        className={cn('flex flex-col items-center justify-center gap-4 px-6 py-12 text-center', className)}
+        {...props}
+      >
+        <div className="flex h-14 w-14 items-center justify-center rounded-full bg-[hsl(var(--muted))] text-[hsl(var(--muted-foreground))]">
+          {icon ?? <ShoppingCart className="h-6 w-6" strokeWidth={1.5} />}
+        </div>
+        <div className="flex flex-col gap-1">
+          <span className="text-base font-semibold text-foreground">{title}</span>
+          {description && <span className="max-w-xs text-sm text-muted-foreground">{description}</span>}
+        </div>
+        {actionLabel && onAction && (
+          <Button onClick={onAction} className="mt-1">
+            {actionLabel}
+          </Button>
+        )}
+      </div>
+    )
+  },
+)
+EmptyCart.displayName = 'EmptyCart'

package/src/primitives/price-tag.tsx

@@ -0,0 +1,62 @@
+import React from 'react'
+import { cn } from '../utils/cn'
+
+const SIZE = {
+  sm: { price: 'text-sm', compare: 'text-xs' },
+  md: { price: 'text-lg', compare: 'text-sm' },
+  lg: { price: 'text-2xl', compare: 'text-base' },
+} as const
+
+export type PriceTagProps = React.HTMLAttributes<HTMLSpanElement> & {
+  /** Price in minor units (e.g. cents). */
+  amount: number
+  /** Original/compare-at price in minor units — renders struck-through when greater than `amount`. */
+  compareAt?: number
+  /** ISO 4217 currency code. Default 'USD'. */
+  currency?: string
+  /** BCP-47 locale for formatting. Default 'en-US'. */
+  locale?: string
+  /** Size scale. Default 'md'. */
+  size?: keyof typeof SIZE
+  /** Show the "−N%" discount pill when on sale. Default true. */
+  showDiscount?: boolean
+}
+
+function formatMoney(minor: number, currency: string, locale: string) {
+  return new Intl.NumberFormat(locale, { style: 'currency', currency }).format(minor / 100)
+}
+
+/**
+ * Formatted currency price with an optional compare-at strikethrough and discount pill.
+ * Amounts are minor units (cents) so there's no float drift.
+ */
+export const PriceTag = React.forwardRef<HTMLSpanElement, PriceTagProps>(
+  (
+    { amount, compareAt, currency = 'USD', locale = 'en-US', size = 'md', showDiscount = true, className, ...props },
+    ref,
+  ) => {
+    const onSale = compareAt !== undefined && compareAt > amount
+    const pct = onSale ? Math.round((1 - amount / compareAt) * 100) : 0
+    const s = SIZE[size]
+    return (
+      <span ref={ref} className={cn('inline-flex items-baseline gap-2 font-sans tabular-nums', className)} {...props}>
+        <span className={cn('font-semibold tracking-tight text-foreground', s.price)}>
+          {formatMoney(amount, currency, locale)}
+        </span>
+        {onSale && (
+          <>
+            <span className={cn('text-muted-foreground line-through', s.compare)}>
+              {formatMoney(compareAt, currency, locale)}
+            </span>
+            {showDiscount && (
+              <span className="rounded-full bg-destructive/10 px-2 py-0.5 text-xs font-semibold text-destructive">
+                −{pct}%
+              </span>
+            )}
+          </>
+        )}
+      </span>
+    )
+  },
+)
+PriceTag.displayName = 'PriceTag'

package/src/primitives/qr-code.tsx

@@ -20,7 +20,11 @@ export type QrCodeProps = Omit<React.HTMLAttributes<HTMLDivElement>, 'children'>
     src: string
     height: number
     width: number
-    excavate?: boolean
+    excavate: boolean
+    x?: number
+    y?: number
+    opacity?: number
+    crossOrigin?: 'anonymous' | 'use-credentials' | ''
   }
 }
 

package/src/primitives/quantity-stepper.tsx

@@ -0,0 +1,92 @@
+import React from 'react'
+import { Minus, Plus } from 'lucide-react'
+import { cn } from '../utils/cn'
+import { Button } from './button'
+
+export type QuantityStepperProps = Omit<React.HTMLAttributes<HTMLDivElement>, 'onChange'> & {
+  /** Controlled quantity. */
+  value?: number
+  /** Uncontrolled initial quantity. Default 1. */
+  defaultValue?: number
+  /** Fires with the clamped next quantity. */
+  onValueChange?: (value: number) => void
+  /** Minimum (decrement disables here). Default 1. */
+  min?: number
+  /** Maximum (increment disables here). Default 99. */
+  max?: number
+  /** Increment/decrement step. Default 1. */
+  step?: number
+  /** Control size. Default 'md'. */
+  size?: 'sm' | 'md'
+  disabled?: boolean
+  'aria-label'?: string
+}
+
+/** Increment / decrement quantity control with min/max clamping. */
+export const QuantityStepper = React.forwardRef<HTMLDivElement, QuantityStepperProps>(
+  (
+    {
+      value: valueProp,
+      defaultValue = 1,
+      onValueChange,
+      min = 1,
+      max = 99,
+      step = 1,
+      size = 'md',
+      disabled = false,
+      className,
+      'aria-label': ariaLabel = 'Quantity',
+      ...props
+    },
+    ref,
+  ) => {
+    const isControlled = valueProp !== undefined
+    const [internal, setInternal] = React.useState(defaultValue)
+    const value = isControlled ? (valueProp as number) : internal
+    const commit = (next: number) => {
+      const clamped = Math.max(min, Math.min(max, next))
+      if (!isControlled) setInternal(clamped)
+      onValueChange?.(clamped)
+    }
+    const dim = size === 'sm' ? 'h-7 w-7' : 'h-9 w-9'
+    return (
+      <div
+        ref={ref}
+        role="group"
+        aria-label={ariaLabel}
+        className={cn('inline-flex items-center rounded-md border border-input', className)}
+        {...props}
+      >
+        <Button
+          type="button"
+          variant="ghost"
+          size="icon"
+          className={cn('rounded-r-none', dim)}
+          disabled={disabled || value <= min}
+          onClick={() => commit(value - step)}
+          aria-label="Decrease quantity"
+        >
+          <Minus className="h-4 w-4" />
+        </Button>
+        <span
+          aria-live="polite"
+          className={cn('select-none text-center text-sm font-medium tabular-nums', size === 'sm' ? 'min-w-7' : 'min-w-8')}
+        >
+          {value}
+        </span>
+        <Button
+          type="button"
+          variant="ghost"
+          size="icon"
+          className={cn('rounded-l-none', dim)}
+          disabled={disabled || value >= max}
+          onClick={() => commit(value + step)}
+          aria-label="Increase quantity"
+        >
+          <Plus className="h-4 w-4" />
+        </Button>
+      </div>
+    )
+  },
+)
+QuantityStepper.displayName = 'QuantityStepper'

package/src/primitives/variant-picker.tsx

@@ -0,0 +1,74 @@
+import React from 'react'
+import { cn } from '../utils/cn'
+
+export type VariantOption = {
+  value: string
+  label: string
+  /** Optional color swatch — a CSS color from your product data (not a design token). */
+  swatch?: string
+  disabled?: boolean
+}
+
+export type VariantPickerProps = Omit<React.HTMLAttributes<HTMLDivElement>, 'onChange'> & {
+  /** Group label, e.g. "Grind" or "Size". */
+  label?: string
+  options: VariantOption[]
+  /** Controlled selected value. */
+  value?: string
+  /** Uncontrolled initial value. */
+  defaultValue?: string
+  onValueChange?: (value: string) => void
+}
+
+/** Single-select product-option picker (grind, size, color) with selected + out-of-stock states. */
+export const VariantPicker = React.forwardRef<HTMLDivElement, VariantPickerProps>(
+  ({ label, options, value: valueProp, defaultValue, onValueChange, className, ...props }, ref) => {
+    const isControlled = valueProp !== undefined
+    const [internal, setInternal] = React.useState(defaultValue)
+    const value = isControlled ? valueProp : internal
+    const select = (v: string) => {
+      if (!isControlled) setInternal(v)
+      onValueChange?.(v)
+    }
+    return (
+      <div ref={ref} role="radiogroup" aria-label={label} className={cn('flex flex-col gap-2', className)} {...props}>
+        {label && (
+          <span className="text-xs font-semibold uppercase tracking-wide text-muted-foreground">{label}</span>
+        )}
+        <div className="flex flex-wrap gap-2">
+          {options.map((opt) => {
+            const selected = value === opt.value
+            return (
+              <button
+                key={opt.value}
+                type="button"
+                role="radio"
+                aria-checked={selected}
+                disabled={opt.disabled}
+                onClick={() => select(opt.value)}
+                className={cn(
+                  'inline-flex items-center gap-2 rounded-md border px-3 py-1.5 text-sm font-medium transition-colors',
+                  'focus-visible:outline-none focus-visible:ring-2 focus-visible:ring-ring focus-visible:ring-offset-2',
+                  selected
+                    ? 'border-primary bg-primary/10 text-[hsl(var(--primary))]'
+                    : 'border-border hover:bg-accent hover:text-accent-foreground',
+                  opt.disabled && 'cursor-not-allowed text-muted-foreground line-through opacity-50',
+                )}
+              >
+                {opt.swatch && (
+                  <span
+                    aria-hidden="true"
+                    className="h-4 w-4 rounded-full border border-border"
+                    style={{ backgroundColor: opt.swatch }}
+                  />
+                )}
+                {opt.label}
+              </button>
+            )
+          })}
+        </div>
+      </div>
+    )
+  },
+)
+VariantPicker.displayName = 'VariantPicker'

package/src/themes/base.css

@@ -23,3 +23,21 @@ h1, h2, h3, h4, h5, h6 {
   line-height: var(--line-height-heading, 1.2);
   font-weight: var(--font-weight-heading, 600);
 }
+
+/* ── Animations shipped with the SDK ────────────────────────────────────────
+   Consumers get these automatically by importing '@otfdashkit/ui/styles'.
+   Keep keyframe names unique to avoid collision with consumer-defined ones. */
+
+/* Conic-gradient shimmer rotation — used by Button variant="shimmer".
+   Animation: 360deg sweep, 2.6s linear, infinite. */
+@keyframes shimmer-rotate {
+  0%   { --shimmer-angle: 0deg;   transform: rotate(0deg); }
+  100% { --shimmer-angle: 360deg; transform: rotate(360deg); }
+}
+
+/* Concentric ripple expand — reserved for future use (RippleLoader, ping).
+   The existing motion/Ripple is click-triggered; this is for ambient pulses. */
+@keyframes pulse-ring {
+  0%   { transform: scale(0.4); opacity: 0.8; }
+  100% { transform: scale(1.6); opacity: 0; }
+}