{
  "$schema": "https://ui.shadcn.com/schema/registry-item.json",
  "name": "ds-location-picker",
  "description": "Address autocomplete picker with async search callback — decoupled from any geocoding API.",
  "dependencies": [
    "class-variance-authority",
    "lucide-react"
  ],
  "registryDependencies": [
    "@lema-ds/skeleton",
    "@lema-ds/popover",
    "@lema-ds/command",
    "@lema-ds/badge",
    "@lema-ds/button",
    "@lema-ds/ui-i18n",
    "@lema-ds/ds-locale-provider"
  ],
  "files": [
    {
      "path": "components/ds/ds-location-picker.tsx",
      "content": "\"use client\"\n\nimport * as React from \"react\"\nimport { Check, Loader2, MapPin, X } from \"lucide-react\"\nimport { cva } from \"class-variance-authority\"\nimport { cn } from \"@/lib/utils\"\nimport { Skeleton } from \"@/components/ui/skeleton\"\nimport {\n  Popover,\n  PopoverContent,\n  PopoverTrigger,\n} from \"@/components/ui/popover\"\nimport {\n  Command,\n  CommandEmpty,\n  CommandGroup,\n  CommandInput,\n  CommandItem,\n  CommandList,\n} from \"@/components/ui/command\"\nimport { Badge } from \"@/components/ui/badge\"\nimport { Button } from \"@/components/ui/button\"\nimport type { UILocale } from \"@/lib/ui-i18n\"\nimport { useUILocale } from \"@/components/ui/ds-locale-provider\"\n\n// ── Types ──────────────────────────────────────────────────────────────────\n\nexport interface LocationSuggestion {\n  id: string\n  label: string\n  description?: string\n  lat?: number\n  lng?: number\n  /** Additional metadata (city, state, country, etc.) */\n  meta?: Record<string, string>\n}\n\nexport interface LocationPickerProps extends Omit<\n  React.HTMLAttributes<HTMLDivElement>,\n  \"onChange\"\n> {\n  value?: LocationSuggestion | null\n  onChange?: (value: LocationSuggestion | null) => void\n  /**\n   * Async search function — called with the query string.\n   * Should return a list of suggestions.\n   * Connect any API here: Google Places, Mapbox, ViaCEP, etc.\n   */\n  onSearch?: (query: string) => Promise<LocationSuggestion[]>\n  placeholder?: string\n  searchPlaceholder?: string\n  disabled?: boolean\n  loading?: boolean\n  clearable?: boolean\n  locale?: UILocale\n}\n\n// ── Variants ───────────────────────────────────────────────────────────────\n\nexport const locationPickerContainerVariants = cva(\"relative w-full\", {\n  variants: {},\n})\n\nexport const locationPickerTriggerVariants = cva(\n  [\n    \"flex h-9 w-full items-center gap-2 rounded-lg border border-input bg-background px-3 py-2\",\n    \"text-sm text-foreground ring-offset-background\",\n    \"has-[:focus-visible]:ring-2 has-[:focus-visible]:ring-ring has-[:focus-visible]:ring-offset-2\",\n    \"disabled:cursor-not-allowed disabled:opacity-50\",\n  ].join(\" \"),\n  {\n    variants: {},\n  }\n)\n\n// ── LocationPicker ─────────────────────────────────────────────────────────\n\nexport function LocationPicker({\n  value,\n  onChange,\n  onSearch,\n  placeholder = \"Select location…\",\n  searchPlaceholder = \"Search address…\",\n  disabled = false,\n  loading = false,\n  clearable = true,\n  locale: localeProp,\n  className,\n  ...props\n}: LocationPickerProps) {\n  const locale = useUILocale(localeProp)\n  void locale\n  const [open, setOpen] = React.useState(false)\n  const [query, setQuery] = React.useState(\"\")\n  const [suggestions, setSuggestions] = React.useState<LocationSuggestion[]>([])\n  const [searching, setSearching] = React.useState(false)\n  const debounceRef = React.useRef<ReturnType<typeof setTimeout> | null>(null)\n\n  const handleSearch = React.useCallback(\n    (q: string) => {\n      setQuery(q)\n      if (!onSearch) return\n      if (debounceRef.current) clearTimeout(debounceRef.current)\n      if (!q.trim()) {\n        setSuggestions([])\n        return\n      }\n      setSearching(true)\n      debounceRef.current = setTimeout(async () => {\n        try {\n          const results = await onSearch(q)\n          setSuggestions(results)\n        } catch {\n          setSuggestions([])\n        } finally {\n          setSearching(false)\n        }\n      }, 300)\n    },\n    [onSearch]\n  )\n\n  const handleSelect = (suggestion: LocationSuggestion) => {\n    onChange?.(suggestion)\n    setOpen(false)\n    setQuery(\"\")\n    setSuggestions([])\n  }\n\n  const handleClear = (e: React.MouseEvent) => {\n    e.stopPropagation()\n    onChange?.(null)\n  }\n\n  // ── Loading ─────────────────────────────────────────────────────────────\n\n  if (loading) {\n    return <Skeleton className={cn(\"h-9 w-full rounded-lg\", className)} />\n  }\n\n  return (\n    <div\n      className={cn(locationPickerContainerVariants(), className)}\n      {...props}\n    >\n      <Popover open={open} onOpenChange={setOpen}>\n        <div\n          className={cn(\n            locationPickerTriggerVariants(),\n            disabled && \"pointer-events-none\"\n          )}\n        >\n          <PopoverTrigger asChild>\n            <div\n              className=\"flex min-w-0 flex-1 cursor-pointer items-center gap-2 outline-none\"\n              role=\"button\"\n              aria-expanded={open}\n              aria-haspopup=\"dialog\"\n              aria-label={placeholder}\n              tabIndex={disabled ? -1 : 0}\n              onKeyDown={(e) => {\n                if (e.key === \"Enter\" || e.key === \" \") {\n                  e.preventDefault()\n                  if (!disabled) setOpen(true)\n                }\n              }}\n            >\n              <MapPin className=\"size-4 shrink-0 text-muted-foreground\" />\n              {value ? (\n                <div className=\"flex flex-1 items-center gap-2 overflow-hidden\">\n                  <span className=\"flex-1 truncate text-foreground\">\n                    {value.label}\n                  </span>\n                  {value.description && (\n                    <span className=\"shrink-0 truncate text-xs text-muted-foreground\">\n                      {value.description}\n                    </span>\n                  )}\n                </div>\n              ) : (\n                <span className=\"flex-1 text-muted-foreground\">\n                  {placeholder}\n                </span>\n              )}\n            </div>\n          </PopoverTrigger>\n          {clearable && value && (\n            <Button\n              variant=\"ghost\"\n              size=\"icon\"\n              className=\"size-5 shrink-0\"\n              onClick={handleClear}\n              aria-label=\"Clear location\"\n            >\n              <X className=\"size-3\" />\n            </Button>\n          )}\n        </div>\n        <PopoverContent\n          className=\"w-full min-w-72 p-0\"\n          align=\"start\"\n          side=\"bottom\"\n        >\n          <Command shouldFilter={false}>\n            <CommandInput\n              placeholder={searchPlaceholder}\n              value={query}\n              onValueChange={handleSearch}\n            />\n            <CommandList>\n              {searching && (\n                <div className=\"flex items-center gap-2 px-4 py-2 text-sm text-muted-foreground\">\n                  <Loader2 className=\"size-3.5 animate-spin\" />\n                  Searching…\n                </div>\n              )}\n              {!searching && query && suggestions.length === 0 && (\n                <CommandEmpty>\n                  {onSearch ? \"No results found.\" : \"Start typing to search.\"}\n                </CommandEmpty>\n              )}\n              {!searching && suggestions.length > 0 && (\n                <CommandGroup>\n                  {suggestions.map((s) => (\n                    <CommandItem\n                      key={s.id}\n                      value={s.id}\n                      onSelect={() => handleSelect(s)}\n                      className=\"flex items-start gap-3 py-2\"\n                    >\n                      <MapPin className=\"mt-0.5 size-4 shrink-0 text-muted-foreground\" />\n                      <div className=\"flex flex-col gap-0.5 overflow-hidden\">\n                        <span className=\"truncate text-sm font-medium\">\n                          {s.label}\n                        </span>\n                        {s.description && (\n                          <span className=\"truncate text-xs text-muted-foreground\">\n                            {s.description}\n                          </span>\n                        )}\n                        {s.meta && (\n                          <div className=\"flex flex-wrap gap-1 pt-0.5\">\n                            {Object.entries(s.meta).map(([k, v]) => (\n                              <Badge\n                                key={k}\n                                variant=\"secondary\"\n                                className=\"px-1 py-0 text-xs\"\n                              >\n                                {v}\n                              </Badge>\n                            ))}\n                          </div>\n                        )}\n                      </div>\n                      {value?.id === s.id && (\n                        <Check className=\"ml-auto size-4 shrink-0 text-primary\" />\n                      )}\n                    </CommandItem>\n                  ))}\n                </CommandGroup>\n              )}\n              {!query && !searching && !value && (\n                <div className=\"px-4 py-6 text-center text-sm text-muted-foreground\">\n                  Type an address to search\n                </div>\n              )}\n            </CommandList>\n          </Command>\n        </PopoverContent>\n      </Popover>\n\n      {/* Selected meta badges */}\n      {value?.meta && (\n        <div className=\"mt-1.5 flex flex-wrap gap-1\">\n          {Object.entries(value.meta).map(([k, v]) => (\n            <Badge key={k} variant=\"outline\" className=\"text-xs\">\n              {k}: {v}\n            </Badge>\n          ))}\n        </div>\n      )}\n    </div>\n  )\n}\n",
      "type": "registry:ui"
    }
  ],
  "type": "registry:ui"
}
