@aws/address-form-sdk-js 1.4.1 → 1.6.0

package/dist/lib/components/AddressForm/index.d.ts

@@ -1,7 +1,6 @@
 import { AutocompleteFilterPlaceType, Address } from '@aws-sdk/client-geo-places';
 import { Config } from '../../types/config.ts';
 import { MapProps, MapStyle } from '../Map';
-import { MapMarkerProps } from '../MapMarker/index.tsx';
 import { TypeaheadProps } from '../Typeahead';
 import { TypeaheadAPIName } from '../Typeahead/use-typeahead-query.ts';
 import { FormFieldID } from './form-field.ts';
@@ -44,6 +43,10 @@ export interface AddressFormProps {
     language?: string;
     politicalView?: string;
 }
-export declare function AddressForm({ fields, typeahead, map, politicalView, language, className, onSubmit, }: AddressFormProps): import("react/jsx-runtime").JSX.Element;
-export type AddressFormMapProps = MapProps & MapMarkerProps;
-export declare const AddressFormMap: ({ adjustablePosition, markerPosition, onSaveMarkerPosition, ...mapProps }: AddressFormMapProps) => import("react/jsx-runtime").JSX.Element;
+export declare function AddressForm({ fields, typeahead, map, politicalView, language, className, onSubmit, }: AddressFormProps): import("react").JSX.Element;
+export interface AddressFormMapProps extends MapProps {
+    adjustablePosition?: boolean;
+    markerPosition?: [number, number];
+    onSaveMarkerPosition?: (position: [number, number]) => void;
+}
+export declare const AddressFormMap: ({ adjustablePosition, markerPosition, onSaveMarkerPosition, onMove, ...mapProps }: AddressFormMapProps) => import("react").JSX.Element;

package/dist/lib/components/AddressFormReact/AddressForm.d.ts

@@ -1,9 +1,10 @@
-import { Address, AutocompleteFilterPlaceType, GetPlaceIntendedUse } from '@aws-sdk/client-geo-places';
+import { Address, AutocompleteFilterPlaceType, GeoPlacesClient, GetPlaceIntendedUse } from '@aws-sdk/client-geo-places';
 import { ComponentProps, FunctionComponent, ReactNode } from 'react';
 import { AddressFormAddressFieldProps } from './AddressFormAddressField';
 import { AddressFormCountryFieldProps } from './AddressFormCountryField';
 import { AddressFormMapProps } from './AddressFormMap';
 import { AddressFormTextFieldProps } from './AddressFormTextField';
+import { CenterBounds } from '../../utils/bounds';
 export interface AddressFormData {
     placeId?: string;
     addressLineOne?: string;
@@ -17,8 +18,9 @@ export interface AddressFormData {
     addressDetails?: Address;
 }
 export interface AddressFormProps extends AddressFormContentProps {
-    apiKey: string;
+    apiKey?: string;
     region: string;
+    client?: GeoPlacesClient;
     language?: string;
     politicalView?: string;
     showCurrentCountryResultsOnly?: boolean;
@@ -26,6 +28,7 @@ export interface AddressFormProps extends AddressFormContentProps {
     placeTypes?: AutocompleteFilterPlaceType[];
     initialMapCenter?: [number, number];
     initialMapZoom?: number;
+    centerBounds?: CenterBounds;
 }
 interface ChildComponents {
     AddressField: FunctionComponent<AddressFormAddressFieldProps>;

package/dist/lib/components/AddressFormReact/AddressFormAddressField.d.ts

@@ -8,4 +8,4 @@ export interface AddressFormAddressFieldProps {
     placeholder?: string;
     className?: string;
 }
-export declare const AddressFormAddressField: import('react').MemoExoticComponent<({ name, label, className, showCurrentLocation, apiName, placeholder }: AddressFormAddressFieldProps) => import("react/jsx-runtime").JSX.Element>;
+export declare const AddressFormAddressField: import('react').MemoExoticComponent<({ name, label, className, showCurrentLocation, apiName, placeholder }: AddressFormAddressFieldProps) => import("react").JSX.Element>;

package/dist/lib/components/AddressFormReact/AddressFormContext.d.ts

@@ -1,13 +1,14 @@
 import { AutocompleteFilterPlaceType } from '@aws-sdk/client-geo-places';
 import { AddressFormData } from './AddressForm';
 import { TypeaheadAPIName } from '../Typeahead/use-typeahead-query';
+import { CenterBounds } from '../../utils/bounds';
 export interface MapViewState {
     longitude: number;
     latitude: number;
     zoom: number;
 }
 export interface AddressFormContextType {
-    apiKey: string;
+    apiKey?: string;
     region: string;
     data: AddressFormData;
     setData: (data: AddressFormData) => void;
@@ -19,6 +20,8 @@ export interface AddressFormContextType {
     showCurrentCountryResultsOnly?: boolean;
     allowedCountries?: string[];
     placeTypes?: AutocompleteFilterPlaceType[];
+    centerBounds?: CenterBounds;
+    isAdjustedPositionOutOfBounds?: boolean;
     isAutofill: boolean;
     setIsAutofill: (isAutofill: boolean) => void;
     typeaheadApiName: TypeaheadAPIName | null;

package/dist/lib/components/AddressFormReact/AddressFormCountryField.d.ts

@@ -5,4 +5,4 @@ export interface AddressFormCountryFieldProps {
     label: string;
     placeholder?: string;
 }
-export declare const AddressFormCountryField: import('react').MemoExoticComponent<({ name, className, label, placeholder }: AddressFormCountryFieldProps) => import("react/jsx-runtime").JSX.Element>;
+export declare const AddressFormCountryField: import('react').MemoExoticComponent<({ name, className, label, placeholder }: AddressFormCountryFieldProps) => import("react").JSX.Element>;

package/dist/lib/components/AddressFormReact/AddressFormProvider.d.ts

@@ -1,7 +1,8 @@
 import { AutocompleteFilterPlaceType, GeoPlacesClient } from '@aws-sdk/client-geo-places';
 import { FunctionComponent, PropsWithChildren } from 'react';
+import { CenterBounds } from '../../utils/bounds';
 export interface AddressFormProps extends PropsWithChildren {
-    apiKey: string;
+    apiKey?: string;
     region: string;
     language?: string;
     politicalView?: string;
@@ -11,5 +12,6 @@ export interface AddressFormProps extends PropsWithChildren {
     client?: GeoPlacesClient;
     initialMapCenter?: [number, number];
     initialMapZoom?: number;
+    centerBounds?: CenterBounds;
 }
 export declare const AddressFormProvider: FunctionComponent<AddressFormProps>;

package/dist/lib/components/AddressFormReact/AddressFormTextField.d.ts

@@ -5,4 +5,4 @@ export interface AddressFormTextFieldProps {
     label: string;
     placeholder?: string;
 }
-export declare const AddressFormTextField: import('react').MemoExoticComponent<({ name, className, label, placeholder }: AddressFormTextFieldProps) => import("react/jsx-runtime").JSX.Element>;
+export declare const AddressFormTextField: import('react').MemoExoticComponent<({ name, className, label, placeholder }: AddressFormTextFieldProps) => import("react").JSX.Element>;

package/dist/lib/components/AddressFormReact/SubmitButton.d.ts

@@ -0,0 +1,2 @@
+import { ComponentProps, FunctionComponent } from 'react';
+export declare const SubmitButton: FunctionComponent<ComponentProps<"button">>;

package/dist/lib/components/AddressFormReact/render.d.ts

@@ -1,5 +1,6 @@
 import { AutocompleteFilterPlaceType } from '@aws-sdk/client-geo-places';
 import { SubmitHandler } from './AddressForm';
+import { CenterBounds } from '../../utils/bounds';
 export interface RenderParams {
     root: string;
     apiKey: string;
@@ -12,5 +13,6 @@ export interface RenderParams {
     onSubmit?: SubmitHandler;
     initialMapCenter?: [number, number];
     initialMapZoom?: number;
+    centerBounds?: CenterBounds;
 }
 export declare const render: ({ root: selector, ...formProps }: RenderParams) => void;

package/dist/lib/components/{MapMarker/AdjustButton → AdjustButton}/index.d.ts

@@ -1,3 +1,3 @@
 import { FunctionComponent } from 'react';
-import { ButtonProps } from '../../Button';
+import { ButtonProps } from '../Button';
 export declare const AdjustButton: FunctionComponent<Omit<ButtonProps, "variant">>;

package/dist/lib/components/AmazonLocationProvider/index.d.ts

@@ -1,9 +1,9 @@
 import { PropsWithChildren } from 'react';
 import { GeoPlacesClient } from '@aws-sdk/client-geo-places';
 type AmazonLocationProviderProps = PropsWithChildren & {
-    apiKey: string;
+    apiKey?: string;
     region: string;
     client?: GeoPlacesClient;
 };
-export declare function AmazonLocationProvider({ apiKey, region, children, client }: AmazonLocationProviderProps): import("react/jsx-runtime").JSX.Element;
+export declare function AmazonLocationProvider({ apiKey, region, children, client }: AmazonLocationProviderProps): import("react").JSX.Element;
 export {};

package/dist/lib/components/Button/index.d.ts

@@ -4,4 +4,4 @@ export interface ButtonProps extends React.ButtonHTMLAttributes<HTMLButtonElemen
     disabled?: boolean;
     size?: "small" | "medium" | "large";
 }
-export declare function Button({ children, className, variant, size, disabled, ...restProps }: ButtonProps): import("react/jsx-runtime").JSX.Element;
+export declare function Button({ children, className, variant, size, disabled, ...restProps }: ButtonProps): import("react").JSX.Element;

package/dist/lib/components/CountrySelect/index.d.ts

@@ -14,5 +14,5 @@ interface MultiCountrySelectProps extends BaseCountrySelectProps {
     onChange: (value: string[]) => void;
 }
 export type CountrySelectProps = (SingleCountrySelectProps | MultiCountrySelectProps) & Omit<InputProps, "value" | "onChange" | "id">;
-export declare const CountrySelect: ({ id, value, onChange, allowedCountries: defaultAllowedCountries, multiple, ...inputProps }: CountrySelectProps) => import("react/jsx-runtime").JSX.Element;
+export declare const CountrySelect: ({ id, value, onChange, allowedCountries: defaultAllowedCountries, multiple, ...inputProps }: CountrySelectProps) => import("react").JSX.Element;
 export {};

package/dist/lib/components/Flex/index.d.ts

@@ -4,4 +4,4 @@ export interface FlexProps extends ComponentProps<"div"> {
     gap?: number | string;
     flex?: boolean;
 }
-export declare function Flex({ direction, gap, children, className, flex, ...rest }: FlexProps): import("react/jsx-runtime").JSX.Element;
+export declare function Flex({ direction, gap, children, className, flex, ...rest }: FlexProps): import("react").JSX.Element;

package/dist/lib/components/FormField/index.d.ts

@@ -4,4 +4,4 @@ export interface FormFieldProps {
     children: React.ReactNode;
     className?: string;
 }
-export declare function FormField({ id, label, children, className }: FormFieldProps): import("react/jsx-runtime").JSX.Element;
+export declare function FormField({ id, label, children, className }: FormFieldProps): import("react").JSX.Element;

package/dist/lib/components/Input/index.d.ts

@@ -3,4 +3,4 @@ export interface InputProps extends React.InputHTMLAttributes<HTMLInputElement>
     disabled?: boolean;
     placeholder?: string;
 }
-export declare function Input({ className, placeholder, disabled, ...restProps }: InputProps): import("react/jsx-runtime").JSX.Element;
+export declare function Input({ className, placeholder, disabled, ...restProps }: InputProps): import("react").JSX.Element;

package/dist/lib/components/LocateButton/index.d.ts

@@ -1,8 +1,10 @@
 import { ComponentProps } from 'react';
 import { TypeaheadOutput } from '../Typeahead/index.tsx';
+import { CenterBounds } from '../../utils/bounds.ts';
 interface LocateButtonProps extends ComponentProps<"button"> {
     onLocate: (address: TypeaheadOutput) => void;
     className?: string;
+    queryBounds?: CenterBounds;
 }
-export declare function LocateButton({ onLocate, className, ...restProps }: LocateButtonProps): import("react/jsx-runtime").JSX.Element;
+export declare function LocateButton({ onLocate, className, queryBounds, ...restProps }: LocateButtonProps): import("react").JSX.Element;
 export {};

package/dist/lib/components/Map/index.d.ts

@@ -7,5 +7,10 @@ export interface MapProps extends Omit<MapLibreMapProps, "mapStyle"> {
     mapStyle: ExtendedMapStyle;
     politicalView?: string;
     showNavigationControl?: boolean;
+    /**
+     * Optional base URL for map tile requests. Overrides the default
+     * `https://maps.geo.{region}.amazonaws.com`. Used for custom or non-production endpoints.
+     */
+    mapsEndpointOverride?: string;
 }
-export declare function Map({ mapStyle: extendedMapStyle, politicalView, showNavigationControl, children, ...rest }: MapProps): import("react/jsx-runtime").JSX.Element;
+export declare function Map({ mapStyle: extendedMapStyle, politicalView, showNavigationControl, mapsEndpointOverride, children, ...rest }: MapProps): import("react").JSX.Element;

package/dist/lib/components/MapMarker/index.d.ts

@@ -2,7 +2,9 @@ import { ColorScheme } from '../Map/index.tsx';
 export interface MapMarkerProps {
     adjustablePosition?: boolean;
     markerPosition?: [number, number];
-    onSaveMarkerPosition?: (position: [number, number]) => void;
+    hasAdjustedPosition?: boolean;
+    isOutOfBounds?: boolean;
+    onReset?: () => void;
     colorScheme?: ColorScheme;
 }
-export declare function MapMarker({ adjustablePosition, markerPosition, onSaveMarkerPosition, colorScheme, }: MapMarkerProps): import("react/jsx-runtime").JSX.Element | undefined;
+export declare function MapMarker({ adjustablePosition, markerPosition, hasAdjustedPosition, isOutOfBounds, onReset, colorScheme, }: MapMarkerProps): import("react").JSX.Element | null;

package/dist/lib/components/Tooltip/index.d.ts

@@ -0,0 +1,7 @@
+import { PropsWithChildren } from 'react';
+interface TooltipProps {
+    text: string;
+    show?: boolean;
+}
+export declare function Tooltip({ text, show, children }: PropsWithChildren<TooltipProps>): import("react").JSX.Element;
+export {};

package/dist/lib/components/Typeahead/index.d.ts

@@ -1,5 +1,6 @@
 import { Address } from '@aws-sdk/client-geo-places';
 import { TypeaheadAPIInput, TypeaheadAPIName } from './use-typeahead-query.ts';
+import { CenterBounds } from '../../utils/bounds.ts';
 export interface TypeaheadOutput {
     placeId?: string;
     addressLineOneField?: string;
@@ -20,5 +21,6 @@ export interface TypeaheadProps {
     showCurrentLocation?: boolean;
     debounce?: number;
     skipNextQuery?: boolean;
+    queryBounds?: CenterBounds;
 }
-export declare const Typeahead: ({ apiName, ...props }: TypeaheadProps) => import("react/jsx-runtime").JSX.Element;
+export declare const Typeahead: ({ apiName, ...props }: TypeaheadProps) => import("react").JSX.Element;

package/dist/lib/components/Typeahead/use-typeahead-query.d.ts

@@ -11,4 +11,4 @@ export interface TypeaheadResultItem {
     title: string;
     placeId: string;
 }
-export declare const useTypeaheadQuery: ({ client, apiName, apiInput, enabled }: UseTypeaheadParams) => import('@tanstack/react-query').UseQueryResult<TypeaheadResultItem[], Error>;
+export declare const useTypeaheadQuery: ({ client, apiName, apiInput, enabled }: UseTypeaheadParams) => import('@tanstack/react-query').UseQueryResult<NoInfer<TypeaheadResultItem[]>, Error>;

package/dist/lib/context/amazon-location-context.d.ts

@@ -1,6 +1,6 @@
 import { GeoPlacesClient } from '@aws-sdk/client-geo-places';
 declare const AmazonLocationContext: import('react').Context<{
-    apiKey: string;
+    apiKey?: string;
     region: string;
     client: GeoPlacesClient;
 } | undefined>;

package/dist/lib/hooks/use-amazon-location-context.d.ts

@@ -1,5 +1,5 @@
 declare function useAmazonLocationContext(): {
-    apiKey: string;
+    apiKey?: string;
     region: string;
     client: import('@aws-sdk/client-geo-places').GeoPlacesClient;
 };

package/dist/lib/icons/Locate.d.ts

@@ -1 +1 @@
-export declare const Locate: () => import("react/jsx-runtime").JSX.Element;
+export declare const Locate: () => import("react").JSX.Element;

package/dist/lib/icons/Logo.d.ts

@@ -2,5 +2,5 @@ import { ComponentProps } from 'react';
 interface LogoProps extends ComponentProps<"a"> {
     mode: "Light" | "Dark";
 }
-export declare const Logo: ({ mode, ...rest }: LogoProps) => import("react/jsx-runtime").JSX.Element;
+export declare const Logo: ({ mode, ...rest }: LogoProps) => import("react").JSX.Element;
 export {};

package/dist/lib/stores/notificationStore.d.ts

@@ -1,4 +1,4 @@
-export type NotificationType = "error";
+export type NotificationType = "error" | "warning";
 export type Notification = {
     id: string;
     type: NotificationType;

package/dist/lib/test/utils.d.ts

@@ -1,3 +1,4 @@
 import { RenderOptions } from '@testing-library/react';
 import { ReactNode } from 'react';
-export declare function renderWithProvider(ui: ReactNode, options?: Omit<RenderOptions, "wrapper">): import('@testing-library/react').RenderResult<typeof import("@testing-library/dom/types/queries"), HTMLElement, HTMLElement>;
+export declare const renderWithProvider: (ui: ReactNode, options?: Omit<RenderOptions, "wrapper">) => import('@testing-library/react').RenderResult<typeof import("@testing-library/dom/types/queries"), HTMLElement, HTMLElement>;
+export declare const renderWithoutApiKey: (ui: ReactNode, options?: Omit<RenderOptions, "wrapper">) => import('@testing-library/react').RenderResult<typeof import("@testing-library/dom/types/queries"), HTMLElement, HTMLElement>;

package/dist/lib/utils/bounds.d.ts

@@ -0,0 +1,3 @@
+export type CenterBounds = [[number, number], [number, number]];
+export declare const clampCenterToBounds: (center: [number, number], bounds?: CenterBounds) => [number, number];
+export declare const isCenterWithinBounds: (center: [number, number], bounds?: CenterBounds) => boolean;

package/dist/lib/utils/position.d.ts

@@ -1 +1,2 @@
 export declare const positionToString: ([lng, lat]: number[]) => string;
+export declare const isSamePosition: (a: [number, number] | undefined, b: [number, number] | undefined) => boolean;