{
  "$schema": "https://ui.shadcn.com/schema/registry-item.json",
  "name": "ds-counter",
  "title": "Counter",
  "description": "A precision numeric input with button controls, direct keyboard entry support, and inputProps passthrough for native HTML attributes.",
  "dependencies": [
    "lucide-react",
    "class-variance-authority"
  ],
  "registryDependencies": [
    "@lema-ds/skeleton",
    "@lema-ds/ui-i18n",
    "@lema-ds/button",
    "@lema-ds/ds-locale-provider"
  ],
  "files": [
    {
      "path": "components/ds/ds-counter.tsx",
      "content": "\"use client\"\n\nimport * as React from \"react\"\nimport { Plus, Minus } from \"lucide-react\"\nimport { cva, type VariantProps } from \"class-variance-authority\"\nimport type { HTMLAttributes } from \"react\"\nimport { cn } from \"@/lib/utils\"\nimport { UI_I18N, type UILocale } from \"@/lib/ui-i18n\"\nimport { useUILocale } from \"@/components/ui/ds-locale-provider\"\nimport { Button } from \"@/components/ui/button\"\nimport { Skeleton } from \"@/components/ui/skeleton\"\n\n// ── Types ──────────────────────────────────────────────────────────────────\n\nexport interface CounterProps\n  extends\n    Omit<HTMLAttributes<HTMLDivElement>, \"onChange\">,\n    VariantProps<typeof counterVariants> {\n  value?: number\n  defaultValue?: number\n  min?: number\n  max?: number\n  step?: number\n  loading?: boolean\n  disabled?: boolean\n  label?: string\n  maxWidth?: string | number\n  onChange?: (value: number) => void\n  onBlur?: (e: React.FocusEvent<HTMLInputElement>) => void\n  onKeyDown?: (e: React.KeyboardEvent<HTMLInputElement>) => void\n  id?: string\n  locale?: UILocale\n  inputProps?: Omit<\n    React.ComponentProps<\"input\">,\n    | \"type\"\n    | \"value\"\n    | \"defaultValue\"\n    | \"onChange\"\n    | \"min\"\n    | \"max\"\n    | \"step\"\n    | \"onBlur\"\n    | \"onKeyDown\"\n    | \"id\"\n    | \"disabled\"\n    | \"ref\"\n    | \"className\"\n  >\n}\n\n// ── Variants ───────────────────────────────────────────────────────────────\n\nexport const counterVariants = cva(\n  \"flex w-full min-w-0 items-center rounded-lg border bg-background transition-all focus-within:ring-2 focus-within:ring-ring\",\n  {\n    variants: {\n      size: {\n        sm: \"h-8 gap-1 px-1\",\n        md: \"h-10 gap-2 px-1\",\n        lg: \"h-12 gap-3 px-2\",\n      },\n      variant: {\n        default: \"border-input shadow-sm\",\n        ghost: \"border-transparent bg-muted/50 hover:bg-muted\",\n        outline: \"border-primary/20 bg-transparent\",\n      },\n      disabled: {\n        true: \"pointer-events-none opacity-50 grayscale\",\n        false: \"\",\n      },\n    },\n    defaultVariants: {\n      size: \"md\",\n      variant: \"default\",\n      disabled: false,\n    },\n  }\n)\n\nexport const counterInputVariants = cva(\n  \"min-w-0 flex-1 [appearance:textfield] border-none bg-transparent p-0 text-center text-sm font-semibold tabular-nums outline-none [&::-webkit-inner-spin-button]:appearance-none [&::-webkit-outer-spin-button]:appearance-none\",\n  {\n    variants: {\n      size: {\n        sm: \"min-w-8 text-xs\",\n        md: \"min-w-12 text-sm\",\n        lg: \"min-w-14 text-base\",\n      },\n    },\n    defaultVariants: { size: \"md\" },\n  }\n)\n\nexport type CounterVariants = VariantProps<typeof counterVariants>\n\n// ── Counter ────────────────────────────────────────────────────────────────\n\nexport const Counter = React.forwardRef<HTMLInputElement, CounterProps>(\n  (\n    {\n      value: controlledValue,\n      defaultValue = 0,\n      min = -Infinity,\n      max = Infinity,\n      step = 1,\n      size = \"md\",\n      variant = \"default\",\n      loading = false,\n      disabled = false,\n      locale: localeProp,\n      label,\n      maxWidth,\n      onChange,\n      onBlur,\n      onKeyDown,\n      inputProps,\n      className,\n      style,\n      ...props\n    },\n    ref\n  ) => {\n    const locale = useUILocale(localeProp)\n    const generatedId = React.useId()\n    const inputId = props.id ?? generatedId\n\n    const clamp = React.useCallback(\n      (val: number) => {\n        if (isNaN(val)) return defaultValue\n        return Math.min(Math.max(val, min), max)\n      },\n      [min, max, defaultValue]\n    )\n\n    const [internalValue, setInternalValue] = React.useState<number>(() =>\n      clamp(defaultValue)\n    )\n    const isControlled = controlledValue !== undefined\n    const currentNumber = isControlled ? (controlledValue ?? 0) : internalValue\n\n    const handleUpdate = React.useCallback(\n      (nextVal: number) => {\n        const clamped = clamp(nextVal)\n        if (!isControlled) setInternalValue(clamped)\n        onChange?.(clamped)\n      },\n      [clamp, isControlled, onChange]\n    )\n\n    const increment = () => handleUpdate(currentNumber + step)\n    const decrement = () => handleUpdate(currentNumber - step)\n\n    const handleInputChange = (e: React.ChangeEvent<HTMLInputElement>) => {\n      const val = parseFloat(e.target.value)\n      if (!isNaN(val)) {\n        handleUpdate(val)\n      } else if (e.target.value === \"\") {\n        if (!isControlled) setInternalValue(NaN)\n      }\n    }\n\n    const handleInputBlur = (e: React.FocusEvent<HTMLInputElement>) => {\n      const val = parseFloat(e.target.value)\n      handleUpdate(isNaN(val) ? defaultValue : val)\n      onBlur?.(e)\n    }\n\n    const handleInputKeyDown = (e: React.KeyboardEvent<HTMLInputElement>) => {\n      if (e.key === \"ArrowUp\") {\n        e.preventDefault()\n        increment()\n      } else if (e.key === \"ArrowDown\") {\n        e.preventDefault()\n        decrement()\n      }\n      onKeyDown?.(e)\n    }\n\n    if (loading) {\n      return (\n        <Skeleton\n          className={cn(\n            \"w-full rounded-lg\",\n            size === \"sm\" ? \"h-8\" : size === \"lg\" ? \"h-12\" : \"h-10\",\n            className\n          )}\n          style={{ maxWidth, ...style }}\n        />\n      )\n    }\n\n    return (\n      <div\n        className={cn(counterVariants({ size, variant, disabled, className }))}\n        style={{ maxWidth, ...style }}\n        role=\"group\"\n        aria-label={label || UI_I18N[locale].counter.groupLabel}\n        data-slot=\"counter\"\n      >\n        <Button\n          variant=\"ghost\"\n          size={size === \"sm\" ? \"icon-xs\" : size === \"lg\" ? \"icon\" : \"icon-sm\"}\n          type=\"button\"\n          onClick={decrement}\n          disabled={disabled || currentNumber <= min}\n          aria-label={UI_I18N[locale].counter.decrease}\n          data-slot=\"counter-decrement\"\n          className=\"rounded-md hover:bg-accent disabled:opacity-30\"\n        >\n          <Minus className=\"size-4 shrink-0 transition-transform active:scale-75\" />\n        </Button>\n\n        <input\n          {...inputProps}\n          {...props}\n          ref={ref}\n          id={inputId}\n          type=\"number\"\n          data-slot=\"counter-input\"\n          value={isNaN(currentNumber) ? \"\" : currentNumber}\n          onChange={handleInputChange}\n          onBlur={handleInputBlur}\n          onKeyDown={handleInputKeyDown}\n          min={min}\n          max={max}\n          step={step}\n          disabled={disabled}\n          autoComplete=\"off\"\n          aria-label={label || UI_I18N[locale].counter.groupLabel}\n          className={cn(counterInputVariants({ size }))}\n        />\n\n        <Button\n          variant=\"ghost\"\n          size={size === \"sm\" ? \"icon-xs\" : size === \"lg\" ? \"icon\" : \"icon-sm\"}\n          type=\"button\"\n          onClick={increment}\n          disabled={disabled || currentNumber >= max}\n          aria-label={UI_I18N[locale].counter.increase}\n          data-slot=\"counter-increment\"\n          className=\"rounded-md hover:bg-accent disabled:opacity-30\"\n        >\n          <Plus className=\"size-4 shrink-0 transition-transform active:scale-75\" />\n        </Button>\n      </div>\n    )\n  }\n)\n\nCounter.displayName = \"Counter\"\n",
      "type": "registry:ui"
    }
  ],
  "type": "registry:ui"
}
