@algenium/blocks 1.6.0 → 1.7.0-rc.1

package/dist/index.d.cts

@@ -681,6 +681,13 @@ declare function ChatSidebar({ currentUserId, config, labels, roleLabel, roomTyp
  * Debounces a value — useful for ZIP lookups and autocomplete queries.
  */
 declare function useDebouncedValue<T>(value: T, delayMs: number): T;
+/**
+ * Like {@link useDebouncedValue} but the returned value is `undefined` until
+ * the first `delayMs` has elapsed for the current `value`, and resets to
+ * `undefined` whenever `value` changes. Use for “only act after user pauses”
+ * (e.g. auto-submit / auto-validate) without firing on the initial tick.
+ */
+declare function useDebouncedValueStrict<T>(value: T, delayMs: number): T | undefined;
 
 declare const buttonVariants: (props?: ({
     variant?: "link" | "default" | "destructive" | "outline" | "secondary" | "ghost" | null | undefined;
@@ -815,8 +822,10 @@ interface USAddressInputLabels {
     state: string;
     zip: string;
     searchPlaceholder: string;
+    /** Kept for backward compatibility; manual validate button removed */
     uspsValidate: string;
     uspsValidating: string;
+    uspsVerified: string;
     uspsSuggested: string;
     uspsUseSuggestion: string;
     uspsKeepMine: string;
@@ -825,19 +834,16 @@ interface USAddressInputLabels {
     zipLookupFailed: string;
     placeLookupFailed: string;
     autocompleteUnavailable: string;
-    /** Optional copy for the autocomplete toggle header */
+    /** @deprecated Toggle removed; kept for consumer compatibility */
     autocompleteTitle?: string;
-    /** Optional copy under the autocomplete toggle title */
+    /** @deprecated Toggle removed; kept for consumer compatibility */
     autocompleteDescription?: string;
-    /** Optional placeholders for fields */
     streetPlaceholder?: string;
     street2Placeholder?: string;
     cityPlaceholder?: string;
     statePlaceholder?: string;
     zipPlaceholder?: string;
-    /** Shown next to street2 label (e.g. "(optional)") */
     street2OptionalHint?: string;
-    /** Fixed country line (US-only component) */
     countryLabel?: string;
 }
 interface AddressAutocompleteAdapter {
@@ -866,11 +872,9 @@ interface USAddressInputProps {
     largeText?: boolean;
     className?: string;
     onError?: (message: string) => void;
-    /** When false, hide the autocomplete on/off row (autocomplete still works if forced on externally — prefer leaving default true when adapter exists). */
-    showAutocompleteToggle?: boolean;
 }
-declare function USAddressInput({ value, onChange, lookupZip, validateAddress, autocomplete, labels, disabled, largeText, className, onError, showAutocompleteToggle, }: USAddressInputProps): react_jsx_runtime.JSX.Element;
+declare function USAddressInput({ value, onChange, lookupZip, validateAddress, autocomplete, labels, disabled, largeText, className, onError, }: USAddressInputProps): react_jsx_runtime.JSX.Element;
 
 declare function cn(...inputs: ClassValue[]): string;
 
-export { type AddressAutocompleteAdapter, AvatarEditor, AvatarEditorDialog, type AvatarEditorDialogProps, type AvatarEditorProps, BLOCKS_DATA_ENVIRONMENTS, type BlocksDataEnvironment, type BlocksLanguage, type BlocksNotification, Button, CalendarContext, type CalendarContextValue, type CalendarData, type CalendarEvent, CalendarSubscribeButton, type CalendarSubscribeButtonProps, CalendarView, type CalendarViewLabels, type CalendarViewMode, type CalendarViewProps, CalendarWidget, type CalendarWidgetLabels, type CalendarWidgetProps, CardInput, type CardInputLabels, type CardInputProps, type CardTokenResult, type ChatConversation, type ChatConversationRoom, type ChatMessageData, type ChatRoomConfig, ChatRoomView, type ChatRoomViewLabels, type ChatRoomViewProps, ChatSidebar, ChatSidebarContext, type ChatSidebarContextValue, type ChatSidebarLabels, type ChatSidebarProps, ChatSidebarProvider, type ChatSidebarProviderProps, type ChatSidebarView, Dialog, DialogClose, DialogContent, DialogDescription, DialogFooter, DialogHeader, DialogOverlay, DialogPortal, DialogTitle, DialogTrigger, Drawer, DrawerClose, DrawerContent, DrawerDescription, DrawerFooter, DrawerHeader, DrawerOverlay, DrawerPortal, DrawerTitle, DrawerTrigger, DropdownMenu, DropdownMenuCheckboxItem, DropdownMenuContent, DropdownMenuGroup, DropdownMenuItem, DropdownMenuLabel, DropdownMenuPortal, DropdownMenuRadioGroup, DropdownMenuRadioItem, DropdownMenuSeparator, DropdownMenuShortcut, DropdownMenuSub, DropdownMenuSubContent, DropdownMenuSubTrigger, DropdownMenuTrigger, EnvironmentBanner, type EnvironmentBannerLabels, type EnvironmentBannerProps, EnvironmentContext, type EnvironmentContextValue, EnvironmentDot, type EnvironmentDotProps, EnvironmentMiniBadge, type EnvironmentMiniBadgeProps, EnvironmentSwitcher, type EnvironmentSwitcherLabels, type EnvironmentSwitcherProps, EventDialog, type EventDialogLabels, type EventDialogProps, EventRsvpBadge, type EventRsvpBadgeProps, type Language, LanguageContext, type LanguageContextValue, LanguageSwitcher, type LanguageSwitcherLabels, type LanguageSwitcherProps, MiniCalendar, type MiniCalendarProps, type Notification, type NotificationType, NotificationsContext, type NotificationsContextValue, NotificationsWidget, type NotificationsWidgetProps, Popover, PopoverAnchor, PopoverContent, PopoverTrigger, ScrollArea, ScrollBar, Slider, ThemeSwitcher, type ThemeSwitcherLabels, type ThemeSwitcherProps, Toggle, Tooltip, TooltipContent, TooltipProvider, TooltipTrigger, USAddressInput, type USAddressInputLabels, type USAddressInputProps, type USAddressValue, UpcomingEvents, type UpcomingEventsProps, type UseChatRoomResult, buttonVariants, cn, defaultLanguages, getEnvironmentDotClass, getEnvironmentLabel, isBlocksDataEnvironment, toggleVariants, useCalendarContext, useChatRoom, useChatSidebar, useDebouncedValue, useEnvironmentContext, useLanguageContext, useNotificationsContext };
+export { type AddressAutocompleteAdapter, AvatarEditor, AvatarEditorDialog, type AvatarEditorDialogProps, type AvatarEditorProps, BLOCKS_DATA_ENVIRONMENTS, type BlocksDataEnvironment, type BlocksLanguage, type BlocksNotification, Button, CalendarContext, type CalendarContextValue, type CalendarData, type CalendarEvent, CalendarSubscribeButton, type CalendarSubscribeButtonProps, CalendarView, type CalendarViewLabels, type CalendarViewMode, type CalendarViewProps, CalendarWidget, type CalendarWidgetLabels, type CalendarWidgetProps, CardInput, type CardInputLabels, type CardInputProps, type CardTokenResult, type ChatConversation, type ChatConversationRoom, type ChatMessageData, type ChatRoomConfig, ChatRoomView, type ChatRoomViewLabels, type ChatRoomViewProps, ChatSidebar, ChatSidebarContext, type ChatSidebarContextValue, type ChatSidebarLabels, type ChatSidebarProps, ChatSidebarProvider, type ChatSidebarProviderProps, type ChatSidebarView, Dialog, DialogClose, DialogContent, DialogDescription, DialogFooter, DialogHeader, DialogOverlay, DialogPortal, DialogTitle, DialogTrigger, Drawer, DrawerClose, DrawerContent, DrawerDescription, DrawerFooter, DrawerHeader, DrawerOverlay, DrawerPortal, DrawerTitle, DrawerTrigger, DropdownMenu, DropdownMenuCheckboxItem, DropdownMenuContent, DropdownMenuGroup, DropdownMenuItem, DropdownMenuLabel, DropdownMenuPortal, DropdownMenuRadioGroup, DropdownMenuRadioItem, DropdownMenuSeparator, DropdownMenuShortcut, DropdownMenuSub, DropdownMenuSubContent, DropdownMenuSubTrigger, DropdownMenuTrigger, EnvironmentBanner, type EnvironmentBannerLabels, type EnvironmentBannerProps, EnvironmentContext, type EnvironmentContextValue, EnvironmentDot, type EnvironmentDotProps, EnvironmentMiniBadge, type EnvironmentMiniBadgeProps, EnvironmentSwitcher, type EnvironmentSwitcherLabels, type EnvironmentSwitcherProps, EventDialog, type EventDialogLabels, type EventDialogProps, EventRsvpBadge, type EventRsvpBadgeProps, type Language, LanguageContext, type LanguageContextValue, LanguageSwitcher, type LanguageSwitcherLabels, type LanguageSwitcherProps, MiniCalendar, type MiniCalendarProps, type Notification, type NotificationType, NotificationsContext, type NotificationsContextValue, NotificationsWidget, type NotificationsWidgetProps, Popover, PopoverAnchor, PopoverContent, PopoverTrigger, ScrollArea, ScrollBar, Slider, ThemeSwitcher, type ThemeSwitcherLabels, type ThemeSwitcherProps, Toggle, Tooltip, TooltipContent, TooltipProvider, TooltipTrigger, USAddressInput, type USAddressInputLabels, type USAddressInputProps, type USAddressValue, UpcomingEvents, type UpcomingEventsProps, type UseChatRoomResult, buttonVariants, cn, defaultLanguages, getEnvironmentDotClass, getEnvironmentLabel, isBlocksDataEnvironment, toggleVariants, useCalendarContext, useChatRoom, useChatSidebar, useDebouncedValue, useDebouncedValueStrict, useEnvironmentContext, useLanguageContext, useNotificationsContext };

package/dist/index.d.ts

@@ -681,6 +681,13 @@ declare function ChatSidebar({ currentUserId, config, labels, roleLabel, roomTyp
  * Debounces a value — useful for ZIP lookups and autocomplete queries.
  */
 declare function useDebouncedValue<T>(value: T, delayMs: number): T;
+/**
+ * Like {@link useDebouncedValue} but the returned value is `undefined` until
+ * the first `delayMs` has elapsed for the current `value`, and resets to
+ * `undefined` whenever `value` changes. Use for “only act after user pauses”
+ * (e.g. auto-submit / auto-validate) without firing on the initial tick.
+ */
+declare function useDebouncedValueStrict<T>(value: T, delayMs: number): T | undefined;
 
 declare const buttonVariants: (props?: ({
     variant?: "link" | "default" | "destructive" | "outline" | "secondary" | "ghost" | null | undefined;
@@ -815,8 +822,10 @@ interface USAddressInputLabels {
     state: string;
     zip: string;
     searchPlaceholder: string;
+    /** Kept for backward compatibility; manual validate button removed */
     uspsValidate: string;
     uspsValidating: string;
+    uspsVerified: string;
     uspsSuggested: string;
     uspsUseSuggestion: string;
     uspsKeepMine: string;
@@ -825,19 +834,16 @@ interface USAddressInputLabels {
     zipLookupFailed: string;
     placeLookupFailed: string;
     autocompleteUnavailable: string;
-    /** Optional copy for the autocomplete toggle header */
+    /** @deprecated Toggle removed; kept for consumer compatibility */
     autocompleteTitle?: string;
-    /** Optional copy under the autocomplete toggle title */
+    /** @deprecated Toggle removed; kept for consumer compatibility */
     autocompleteDescription?: string;
-    /** Optional placeholders for fields */
     streetPlaceholder?: string;
     street2Placeholder?: string;
     cityPlaceholder?: string;
     statePlaceholder?: string;
     zipPlaceholder?: string;
-    /** Shown next to street2 label (e.g. "(optional)") */
     street2OptionalHint?: string;
-    /** Fixed country line (US-only component) */
     countryLabel?: string;
 }
 interface AddressAutocompleteAdapter {
@@ -866,11 +872,9 @@ interface USAddressInputProps {
     largeText?: boolean;
     className?: string;
     onError?: (message: string) => void;
-    /** When false, hide the autocomplete on/off row (autocomplete still works if forced on externally — prefer leaving default true when adapter exists). */
-    showAutocompleteToggle?: boolean;
 }
-declare function USAddressInput({ value, onChange, lookupZip, validateAddress, autocomplete, labels, disabled, largeText, className, onError, showAutocompleteToggle, }: USAddressInputProps): react_jsx_runtime.JSX.Element;
+declare function USAddressInput({ value, onChange, lookupZip, validateAddress, autocomplete, labels, disabled, largeText, className, onError, }: USAddressInputProps): react_jsx_runtime.JSX.Element;
 
 declare function cn(...inputs: ClassValue[]): string;
 
-export { type AddressAutocompleteAdapter, AvatarEditor, AvatarEditorDialog, type AvatarEditorDialogProps, type AvatarEditorProps, BLOCKS_DATA_ENVIRONMENTS, type BlocksDataEnvironment, type BlocksLanguage, type BlocksNotification, Button, CalendarContext, type CalendarContextValue, type CalendarData, type CalendarEvent, CalendarSubscribeButton, type CalendarSubscribeButtonProps, CalendarView, type CalendarViewLabels, type CalendarViewMode, type CalendarViewProps, CalendarWidget, type CalendarWidgetLabels, type CalendarWidgetProps, CardInput, type CardInputLabels, type CardInputProps, type CardTokenResult, type ChatConversation, type ChatConversationRoom, type ChatMessageData, type ChatRoomConfig, ChatRoomView, type ChatRoomViewLabels, type ChatRoomViewProps, ChatSidebar, ChatSidebarContext, type ChatSidebarContextValue, type ChatSidebarLabels, type ChatSidebarProps, ChatSidebarProvider, type ChatSidebarProviderProps, type ChatSidebarView, Dialog, DialogClose, DialogContent, DialogDescription, DialogFooter, DialogHeader, DialogOverlay, DialogPortal, DialogTitle, DialogTrigger, Drawer, DrawerClose, DrawerContent, DrawerDescription, DrawerFooter, DrawerHeader, DrawerOverlay, DrawerPortal, DrawerTitle, DrawerTrigger, DropdownMenu, DropdownMenuCheckboxItem, DropdownMenuContent, DropdownMenuGroup, DropdownMenuItem, DropdownMenuLabel, DropdownMenuPortal, DropdownMenuRadioGroup, DropdownMenuRadioItem, DropdownMenuSeparator, DropdownMenuShortcut, DropdownMenuSub, DropdownMenuSubContent, DropdownMenuSubTrigger, DropdownMenuTrigger, EnvironmentBanner, type EnvironmentBannerLabels, type EnvironmentBannerProps, EnvironmentContext, type EnvironmentContextValue, EnvironmentDot, type EnvironmentDotProps, EnvironmentMiniBadge, type EnvironmentMiniBadgeProps, EnvironmentSwitcher, type EnvironmentSwitcherLabels, type EnvironmentSwitcherProps, EventDialog, type EventDialogLabels, type EventDialogProps, EventRsvpBadge, type EventRsvpBadgeProps, type Language, LanguageContext, type LanguageContextValue, LanguageSwitcher, type LanguageSwitcherLabels, type LanguageSwitcherProps, MiniCalendar, type MiniCalendarProps, type Notification, type NotificationType, NotificationsContext, type NotificationsContextValue, NotificationsWidget, type NotificationsWidgetProps, Popover, PopoverAnchor, PopoverContent, PopoverTrigger, ScrollArea, ScrollBar, Slider, ThemeSwitcher, type ThemeSwitcherLabels, type ThemeSwitcherProps, Toggle, Tooltip, TooltipContent, TooltipProvider, TooltipTrigger, USAddressInput, type USAddressInputLabels, type USAddressInputProps, type USAddressValue, UpcomingEvents, type UpcomingEventsProps, type UseChatRoomResult, buttonVariants, cn, defaultLanguages, getEnvironmentDotClass, getEnvironmentLabel, isBlocksDataEnvironment, toggleVariants, useCalendarContext, useChatRoom, useChatSidebar, useDebouncedValue, useEnvironmentContext, useLanguageContext, useNotificationsContext };
+export { type AddressAutocompleteAdapter, AvatarEditor, AvatarEditorDialog, type AvatarEditorDialogProps, type AvatarEditorProps, BLOCKS_DATA_ENVIRONMENTS, type BlocksDataEnvironment, type BlocksLanguage, type BlocksNotification, Button, CalendarContext, type CalendarContextValue, type CalendarData, type CalendarEvent, CalendarSubscribeButton, type CalendarSubscribeButtonProps, CalendarView, type CalendarViewLabels, type CalendarViewMode, type CalendarViewProps, CalendarWidget, type CalendarWidgetLabels, type CalendarWidgetProps, CardInput, type CardInputLabels, type CardInputProps, type CardTokenResult, type ChatConversation, type ChatConversationRoom, type ChatMessageData, type ChatRoomConfig, ChatRoomView, type ChatRoomViewLabels, type ChatRoomViewProps, ChatSidebar, ChatSidebarContext, type ChatSidebarContextValue, type ChatSidebarLabels, type ChatSidebarProps, ChatSidebarProvider, type ChatSidebarProviderProps, type ChatSidebarView, Dialog, DialogClose, DialogContent, DialogDescription, DialogFooter, DialogHeader, DialogOverlay, DialogPortal, DialogTitle, DialogTrigger, Drawer, DrawerClose, DrawerContent, DrawerDescription, DrawerFooter, DrawerHeader, DrawerOverlay, DrawerPortal, DrawerTitle, DrawerTrigger, DropdownMenu, DropdownMenuCheckboxItem, DropdownMenuContent, DropdownMenuGroup, DropdownMenuItem, DropdownMenuLabel, DropdownMenuPortal, DropdownMenuRadioGroup, DropdownMenuRadioItem, DropdownMenuSeparator, DropdownMenuShortcut, DropdownMenuSub, DropdownMenuSubContent, DropdownMenuSubTrigger, DropdownMenuTrigger, EnvironmentBanner, type EnvironmentBannerLabels, type EnvironmentBannerProps, EnvironmentContext, type EnvironmentContextValue, EnvironmentDot, type EnvironmentDotProps, EnvironmentMiniBadge, type EnvironmentMiniBadgeProps, EnvironmentSwitcher, type EnvironmentSwitcherLabels, type EnvironmentSwitcherProps, EventDialog, type EventDialogLabels, type EventDialogProps, EventRsvpBadge, type EventRsvpBadgeProps, type Language, LanguageContext, type LanguageContextValue, LanguageSwitcher, type LanguageSwitcherLabels, type LanguageSwitcherProps, MiniCalendar, type MiniCalendarProps, type Notification, type NotificationType, NotificationsContext, type NotificationsContextValue, NotificationsWidget, type NotificationsWidgetProps, Popover, PopoverAnchor, PopoverContent, PopoverTrigger, ScrollArea, ScrollBar, Slider, ThemeSwitcher, type ThemeSwitcherLabels, type ThemeSwitcherProps, Toggle, Tooltip, TooltipContent, TooltipProvider, TooltipTrigger, USAddressInput, type USAddressInputLabels, type USAddressInputProps, type USAddressValue, UpcomingEvents, type UpcomingEventsProps, type UseChatRoomResult, buttonVariants, cn, defaultLanguages, getEnvironmentDotClass, getEnvironmentLabel, isBlocksDataEnvironment, toggleVariants, useCalendarContext, useChatRoom, useChatSidebar, useDebouncedValue, useDebouncedValueStrict, useEnvironmentContext, useLanguageContext, useNotificationsContext };

package/dist/index.js

@@ -1,7 +1,7 @@
 import * as React2 from 'react';
 import { createContext, useContext, useState, useCallback, useEffect, useRef, useMemo, useId } from 'react';
 import { useTheme } from 'next-themes';
-import { CheckIcon, CircleIcon, ChevronRightIcon, Monitor, Sun, Moon, Languages, FlaskConical, X, Upload, Move, ZoomOut, ZoomIn, RotateCcw, RotateCw, Grid3X3, RefreshCw, XIcon, User, Pencil, Check, Loader2, Bell, CheckCheck, XCircle, AlertTriangle, CheckCircle, Info, Trash2, Clock, MapPin, Link, CalendarDays, ExternalLink, ChevronLeft, ChevronRight, Plus, HelpCircle, MessageSquare, Wifi, WifiOff, FileIcon, Download, Paperclip, Send, ArrowLeft, CreditCard, Search } from 'lucide-react';
+import { CheckIcon, CircleIcon, ChevronRightIcon, Monitor, Sun, Moon, Languages, FlaskConical, X, Upload, Move, ZoomOut, ZoomIn, RotateCcw, RotateCw, Grid3X3, RefreshCw, XIcon, User, Pencil, Check, Loader2, Bell, CheckCheck, XCircle, AlertTriangle, CheckCircle, Info, Trash2, Clock, MapPin, Link, CalendarDays, ExternalLink, ChevronLeft, ChevronRight, Plus, HelpCircle, MessageSquare, Wifi, WifiOff, FileIcon, Download, Paperclip, Send, ArrowLeft, CreditCard, Search, CheckCircle2 } from 'lucide-react';
 import { AnimatePresence, motion } from 'framer-motion';
 import * as DropdownMenuPrimitive from '@radix-ui/react-dropdown-menu';
 import { jsx, jsxs, Fragment } from 'react/jsx-runtime';
@@ -7331,6 +7331,15 @@ function useDebouncedValue(value, delayMs) {
   }, [value, delayMs]);
   return debounced;
 }
+function useDebouncedValueStrict(value, delayMs) {
+  const [debounced, setDebounced] = useState(void 0);
+  useEffect(() => {
+    setDebounced(void 0);
+    const id = window.setTimeout(() => setDebounced(value), delayMs);
+    return () => window.clearTimeout(id);
+  }, [value, delayMs]);
+  return debounced;
+}
 function onlyDigits(s, max) {
   return s.replace(/\D/g, "").slice(0, max);
 }
@@ -7614,6 +7623,20 @@ function parseInitial(value) {
     country: "US"
   };
 }
+function addressSig(a) {
+  return JSON.stringify({
+    street: a.street.trim(),
+    street2: (a.street2 ?? "").trim(),
+    city: a.city.trim(),
+    state: a.state.trim().toUpperCase(),
+    zip: a.zip.replace(/\D/g, "").slice(0, 5)
+  });
+}
+function isAddressComplete(a) {
+  const zip5 = a.zip.replace(/\D/g, "").slice(0, 5);
+  const st = a.state.trim();
+  return a.street.trim().length > 0 && a.city.trim().length > 0 && /^[A-Za-z]{2}$/.test(st) && zip5.length === 5;
+}
 var inputClassName2 = "flex h-9 w-full rounded-md border border-input bg-transparent px-3 py-1 text-base shadow-xs transition-[color,box-shadow] outline-none focus-visible:border-ring focus-visible:ring-ring/50 focus-visible:ring-[3px] disabled:cursor-not-allowed disabled:opacity-50 md:text-sm";
 function USAddressInput({
   value,
@@ -7625,10 +7648,8 @@ function USAddressInput({
   disabled = false,
   largeText = false,
   className,
-  onError,
-  showAutocompleteToggle = true
+  onError
 }) {
-  const [autocompleteEnabled, setAutocompleteEnabled] = useState(false);
   const [searchQuery, setSearchQuery] = useState("");
   const [showSuggestions, setShowSuggestions] = useState(false);
   const [suggestions, setSuggestions] = useState([]);
@@ -7644,6 +7665,7 @@ function USAddressInput({
   const [uspsSuggestion, setUspsSuggestion] = useState(
     null
   );
+  const [uspsVerifiedNoChange, setUspsVerifiedNoChange] = useState(false);
   const searchRef = useRef(null);
   const suggestionCache = useRef(/* @__PURE__ */ new Map());
   const warnedRef = useRef({
@@ -7652,9 +7674,13 @@ function USAddressInput({
     validate: false
   });
   const lastZipLookup = useRef("");
-  const debouncedSearch = useDebouncedValue(searchQuery, 300);
+  const addressRef = useRef(address);
+  addressRef.current = address;
+  const lastValidatedSigRef = useRef("");
+  const debouncedSearch = useDebouncedValue(searchQuery, 400);
   const zipDigits = address.zip.replace(/\D/g, "").slice(0, 5);
   const debouncedZip = useDebouncedValue(zipDigits, 400);
+  const debouncedAddressForValidate = useDebouncedValueStrict(address, 1200);
   const inputClass = largeText ? "text-base py-3" : "";
   const labelClass = largeText ? "text-base" : "text-sm";
   useEffect(() => {
@@ -7677,11 +7703,18 @@ function USAddressInput({
       return next;
     });
   };
+  useEffect(() => {
+    const sig = addressSig(addressRef.current);
+    if (sig !== lastValidatedSigRef.current) {
+      setUspsVerifiedNoChange(false);
+      setUspsSuggestion(null);
+    }
+  }, [address]);
   const allowAutocomplete = Boolean(autocomplete);
   const allowUspsValidation = Boolean(validateAddress);
   const allowZipLookup = Boolean(lookupZip);
   useEffect(() => {
-    if (!allowAutocomplete || !autocompleteEnabled || !autocomplete) return;
+    if (!allowAutocomplete || !autocomplete) return;
     const q = debouncedSearch.trim();
     if (q.length < 3) {
       setSuggestions([]);
@@ -7700,6 +7733,7 @@ function USAddressInput({
     const ctrl = new AbortController();
     setLoadingAutocomplete(true);
     autocomplete.search(q, sessionToken, ctrl.signal).then((list) => {
+      if (ctrl.signal.aborted) return;
       suggestionCache.current.set(cacheKey, list);
       setSuggestions(list);
       setShowSuggestions(list.length > 0);
@@ -7716,7 +7750,6 @@ function USAddressInput({
   }, [
     debouncedSearch,
     allowAutocomplete,
-    autocompleteEnabled,
     autocomplete,
     sessionToken,
     labels.autocompleteUnavailable,
@@ -7729,6 +7762,7 @@ function USAddressInput({
     const ctrl = new AbortController();
     setLoadingZip(true);
     lookupZip(debouncedZip, ctrl.signal).then((data) => {
+      if (ctrl.signal.aborted) return;
       lastZipLookup.current = debouncedZip;
       setAddress((prev) => {
         const cityEmpty = !prev.city.trim();
@@ -7755,6 +7789,52 @@ function USAddressInput({
     labels.zipLookupFailed,
     onError
   ]);
+  useEffect(() => {
+    if (!allowUspsValidation || !validateAddress || disabled) return;
+    if (debouncedAddressForValidate === void 0) return;
+    const addr = debouncedAddressForValidate;
+    if (!isAddressComplete(addr)) return;
+    const requestSig = addressSig(addr);
+    if (requestSig === lastValidatedSigRef.current) return;
+    const ctrl = new AbortController();
+    const timeoutId = window.setTimeout(() => ctrl.abort(), 8e3);
+    setLoadingValidate(true);
+    setUspsVerifiedNoChange(false);
+    setUspsSuggestion(null);
+    validateAddress(addr, ctrl.signal).then((result) => {
+      if (ctrl.signal.aborted) return;
+      if (addressSig(addressRef.current) !== requestSig) return;
+      lastValidatedSigRef.current = requestSig;
+      const std = result.standardized;
+      if (result.changed) {
+        setUspsSuggestion(std);
+        setUspsVerifiedNoChange(false);
+      } else {
+        setUspsSuggestion(null);
+        setUspsVerifiedNoChange(true);
+      }
+    }).catch(() => {
+      if (ctrl.signal.aborted) return;
+      if (!warnedRef.current.validate) {
+        onError?.(labels.uspsUnavailable);
+        warnedRef.current.validate = true;
+      }
+    }).finally(() => {
+      window.clearTimeout(timeoutId);
+      setLoadingValidate(false);
+    });
+    return () => {
+      window.clearTimeout(timeoutId);
+      ctrl.abort();
+    };
+  }, [
+    debouncedAddressForValidate,
+    allowUspsValidation,
+    validateAddress,
+    disabled,
+    labels.uspsUnavailable,
+    onError
+  ]);
   const handleSelectSuggestion = async (row) => {
     if (!autocomplete) return;
     try {
@@ -7771,72 +7851,27 @@ function USAddressInput({
       setShowSuggestions(false);
       setSearchQuery("");
       setUspsSuggestion(null);
+      lastValidatedSigRef.current = "";
+      setUspsVerifiedNoChange(false);
     } catch {
       onError?.(labels.placeLookupFailed);
     }
   };
-  const runUspsValidate = async () => {
-    if (!allowUspsValidation || !validateAddress || disabled) return;
-    setLoadingValidate(true);
-    setUspsSuggestion(null);
-    try {
-      const result = await validateAddress(address, AbortSignal.timeout(8e3));
-      const std = result.standardized;
-      if (result.changed) {
-        setUspsSuggestion(std);
-      }
-    } catch {
-      if (!warnedRef.current.validate) {
-        onError?.(labels.uspsUnavailable);
-        warnedRef.current.validate = true;
-      }
-    } finally {
-      setLoadingValidate(false);
-    }
-  };
   const applyUspsSuggestion = () => {
     if (!uspsSuggestion) return;
     setAddress(uspsSuggestion);
     onChange(uspsSuggestion);
     setUspsSuggestion(null);
+    lastValidatedSigRef.current = addressSig(uspsSuggestion);
+    setUspsVerifiedNoChange(true);
+  };
+  const dismissUspsSuggestion = () => {
+    setUspsSuggestion(null);
+    lastValidatedSigRef.current = addressSig(addressRef.current);
+    setUspsVerifiedNoChange(true);
   };
-  const showAutocompleteUi = allowAutocomplete && showAutocompleteToggle && autocompleteEnabled;
-  const toggleTitle = labels.autocompleteTitle ?? labels.searchPlaceholder;
   return /* @__PURE__ */ jsxs("div", { className: cn("space-y-4", className), children: [
-    allowAutocomplete && showAutocompleteToggle && /* @__PURE__ */ jsxs("div", { className: "flex items-center justify-between rounded-lg border bg-muted/50 p-3", children: [
-      /* @__PURE__ */ jsxs("div", { className: "flex items-center gap-2", children: [
-        /* @__PURE__ */ jsx(MapPin, { className: "h-4 w-4 text-muted-foreground" }),
-        /* @__PURE__ */ jsxs("div", { children: [
-          /* @__PURE__ */ jsx("p", { className: cn("font-medium", labelClass), children: toggleTitle }),
-          labels.autocompleteDescription ? /* @__PURE__ */ jsx("p", { className: "text-xs text-muted-foreground", children: labels.autocompleteDescription }) : null
-        ] })
-      ] }),
-      /* @__PURE__ */ jsx(
-        "button",
-        {
-          type: "button",
-          role: "switch",
-          "aria-checked": autocompleteEnabled,
-          disabled,
-          onClick: () => setAutocompleteEnabled((v) => !v),
-          className: cn(
-            "relative inline-flex h-6 w-11 shrink-0 cursor-pointer rounded-full border-2 border-transparent transition-colors",
-            autocompleteEnabled ? "bg-primary" : "bg-input",
-            disabled && "cursor-not-allowed opacity-50"
-          ),
-          children: /* @__PURE__ */ jsx(
-            "span",
-            {
-              className: cn(
-                "pointer-events-none block size-5 translate-x-0 rounded-full bg-background shadow-lg ring-0 transition-transform",
-                autocompleteEnabled && "translate-x-5"
-              )
-            }
-          )
-        }
-      )
-    ] }),
-    showAutocompleteUi && autocomplete && /* @__PURE__ */ jsxs("div", { ref: searchRef, className: "relative", children: [
+    allowAutocomplete && autocomplete && /* @__PURE__ */ jsxs("div", { ref: searchRef, className: "relative", children: [
       /* @__PURE__ */ jsxs("div", { className: "relative", children: [
         /* @__PURE__ */ jsx(Search, { className: "absolute left-3 top-1/2 h-4 w-4 -translate-y-1/2 text-muted-foreground" }),
         /* @__PURE__ */ jsx(
@@ -7846,7 +7881,8 @@ function USAddressInput({
             onChange: (e) => setSearchQuery(e.target.value),
             placeholder: labels.searchPlaceholder,
             disabled,
-            className: cn(inputClassName2, "pl-9 pr-9", inputClass)
+            className: cn(inputClassName2, "pl-9 pr-9", inputClass),
+            "aria-label": labels.searchPlaceholder
           }
         ),
         loadingAutocomplete && /* @__PURE__ */ jsx(Loader2, { className: "absolute right-10 top-1/2 h-4 w-4 -translate-y-1/2 animate-spin text-muted-foreground" }),
@@ -7874,29 +7910,6 @@ function USAddressInput({
         suggestion.placeId
       )) })
     ] }),
-    allowUspsValidation && uspsSuggestion && /* @__PURE__ */ jsxs("div", { className: "space-y-2 rounded-lg border border-amber-200 bg-amber-50 p-3 dark:border-amber-900 dark:bg-amber-950/30", children: [
-      /* @__PURE__ */ jsx("p", { className: "text-sm font-medium text-amber-900 dark:text-amber-100", children: labels.uspsSuggested }),
-      /* @__PURE__ */ jsx("p", { className: "text-xs text-muted-foreground", children: [
-        uspsSuggestion.street,
-        uspsSuggestion.street2,
-        uspsSuggestion.city,
-        uspsSuggestion.state,
-        uspsSuggestion.zip
-      ].filter(Boolean).join(", ") }),
-      /* @__PURE__ */ jsxs("div", { className: "flex flex-wrap gap-2", children: [
-        /* @__PURE__ */ jsx(Button, { type: "button", size: "sm", onClick: applyUspsSuggestion, children: labels.uspsUseSuggestion }),
-        /* @__PURE__ */ jsx(
-          Button,
-          {
-            type: "button",
-            size: "sm",
-            variant: "outline",
-            onClick: () => setUspsSuggestion(null),
-            children: labels.uspsKeepMine
-          }
-        )
-      ] })
-    ] }),
     /* @__PURE__ */ jsxs("div", { className: "grid gap-4", children: [
       /* @__PURE__ */ jsxs("div", { className: "space-y-1.5", children: [
         /* @__PURE__ */ jsx(
@@ -8044,26 +8057,50 @@ function USAddressInput({
             }
           )
         ] })
-      ] }),
-      allowUspsValidation && /* @__PURE__ */ jsx("div", { className: "flex items-center gap-2", children: /* @__PURE__ */ jsx(
-        Button,
+      ] })
+    ] }),
+    allowUspsValidation && /* @__PURE__ */ jsxs(Fragment, { children: [
+      /* @__PURE__ */ jsx(
+        "div",
         {
-          type: "button",
-          variant: "secondary",
-          size: "sm",
-          disabled: disabled || loadingValidate,
-          onClick: () => void runUspsValidate(),
-          className: "gap-2",
+          className: "flex min-h-7 items-center gap-2 text-xs text-muted-foreground",
+          "aria-live": "polite",
           children: loadingValidate ? /* @__PURE__ */ jsxs(Fragment, { children: [
-            /* @__PURE__ */ jsx(Loader2, { className: "h-4 w-4 animate-spin" }),
-            labels.uspsValidating
-          ] }) : labels.uspsValidate
+            /* @__PURE__ */ jsx(Loader2, { className: "h-3.5 w-3.5 shrink-0 animate-spin" }),
+            /* @__PURE__ */ jsx("span", { children: labels.uspsValidating })
+          ] }) : uspsVerifiedNoChange && !uspsSuggestion ? /* @__PURE__ */ jsxs(Fragment, { children: [
+            /* @__PURE__ */ jsx(CheckCircle2, { className: "h-3.5 w-3.5 shrink-0 text-emerald-600 dark:text-emerald-400" }),
+            /* @__PURE__ */ jsx("span", { children: labels.uspsVerified })
+          ] }) : /* @__PURE__ */ jsx("span", { className: "select-none opacity-0", "aria-hidden": true, children: "\xA0" })
         }
-      ) })
+      ),
+      uspsSuggestion ? /* @__PURE__ */ jsxs("div", { className: "space-y-2 rounded-lg border border-amber-200 bg-amber-50 p-3 dark:border-amber-900 dark:bg-amber-950/30", children: [
+        /* @__PURE__ */ jsx("p", { className: "text-sm font-medium text-amber-900 dark:text-amber-100", children: labels.uspsSuggested }),
+        /* @__PURE__ */ jsx("p", { className: "text-xs text-muted-foreground", children: [
+          uspsSuggestion.street,
+          uspsSuggestion.street2,
+          uspsSuggestion.city,
+          uspsSuggestion.state,
+          uspsSuggestion.zip
+        ].filter(Boolean).join(", ") }),
+        /* @__PURE__ */ jsxs("div", { className: "flex flex-wrap gap-2", children: [
+          /* @__PURE__ */ jsx(Button, { type: "button", size: "sm", onClick: applyUspsSuggestion, children: labels.uspsUseSuggestion }),
+          /* @__PURE__ */ jsx(
+            Button,
+            {
+              type: "button",
+              size: "sm",
+              variant: "outline",
+              onClick: dismissUspsSuggestion,
+              children: labels.uspsKeepMine
+            }
+          )
+        ] })
+      ] }) : null
     ] })
   ] });
 }
 
-export { AvatarEditor, AvatarEditorDialog, BLOCKS_DATA_ENVIRONMENTS, Button, CalendarContext, CalendarSubscribeButton, CalendarView, CalendarWidget, CardInput, ChatRoomView, ChatSidebar, ChatSidebarContext, ChatSidebarProvider, Dialog, DialogClose, DialogContent, DialogDescription, DialogFooter, DialogHeader, DialogOverlay, DialogPortal, DialogTitle, DialogTrigger, Drawer, DrawerClose, DrawerContent, DrawerDescription, DrawerFooter, DrawerHeader, DrawerOverlay, DrawerPortal, DrawerTitle, DrawerTrigger, DropdownMenu, DropdownMenuCheckboxItem, DropdownMenuContent, DropdownMenuGroup, DropdownMenuItem, DropdownMenuLabel, DropdownMenuPortal, DropdownMenuRadioGroup, DropdownMenuRadioItem, DropdownMenuSeparator, DropdownMenuShortcut, DropdownMenuSub, DropdownMenuSubContent, DropdownMenuSubTrigger, DropdownMenuTrigger, EnvironmentBanner, EnvironmentContext, EnvironmentDot, EnvironmentMiniBadge, EnvironmentSwitcher, EventDialog, EventRsvpBadge, LanguageContext, LanguageSwitcher, MiniCalendar, NotificationsContext, NotificationsWidget, Popover, PopoverAnchor, PopoverContent, PopoverTrigger, ScrollArea, ScrollBar, Slider, ThemeSwitcher, Toggle, Tooltip, TooltipContent, TooltipProvider, TooltipTrigger, USAddressInput, UpcomingEvents, buttonVariants, cn, defaultLanguages, getEnvironmentDotClass, getEnvironmentLabel, isBlocksDataEnvironment, toggleVariants, useCalendarContext, useChatRoom, useChatSidebar, useDebouncedValue, useEnvironmentContext, useLanguageContext, useNotificationsContext };
+export { AvatarEditor, AvatarEditorDialog, BLOCKS_DATA_ENVIRONMENTS, Button, CalendarContext, CalendarSubscribeButton, CalendarView, CalendarWidget, CardInput, ChatRoomView, ChatSidebar, ChatSidebarContext, ChatSidebarProvider, Dialog, DialogClose, DialogContent, DialogDescription, DialogFooter, DialogHeader, DialogOverlay, DialogPortal, DialogTitle, DialogTrigger, Drawer, DrawerClose, DrawerContent, DrawerDescription, DrawerFooter, DrawerHeader, DrawerOverlay, DrawerPortal, DrawerTitle, DrawerTrigger, DropdownMenu, DropdownMenuCheckboxItem, DropdownMenuContent, DropdownMenuGroup, DropdownMenuItem, DropdownMenuLabel, DropdownMenuPortal, DropdownMenuRadioGroup, DropdownMenuRadioItem, DropdownMenuSeparator, DropdownMenuShortcut, DropdownMenuSub, DropdownMenuSubContent, DropdownMenuSubTrigger, DropdownMenuTrigger, EnvironmentBanner, EnvironmentContext, EnvironmentDot, EnvironmentMiniBadge, EnvironmentSwitcher, EventDialog, EventRsvpBadge, LanguageContext, LanguageSwitcher, MiniCalendar, NotificationsContext, NotificationsWidget, Popover, PopoverAnchor, PopoverContent, PopoverTrigger, ScrollArea, ScrollBar, Slider, ThemeSwitcher, Toggle, Tooltip, TooltipContent, TooltipProvider, TooltipTrigger, USAddressInput, UpcomingEvents, buttonVariants, cn, defaultLanguages, getEnvironmentDotClass, getEnvironmentLabel, isBlocksDataEnvironment, toggleVariants, useCalendarContext, useChatRoom, useChatSidebar, useDebouncedValue, useDebouncedValueStrict, useEnvironmentContext, useLanguageContext, useNotificationsContext };
 //# sourceMappingURL=index.js.map
 //# sourceMappingURL=index.js.map