places-autocomplete-svelte 2.2.21 → 2.2.22

package/README.md

@@ -2,7 +2,7 @@
 
 [![npm version](https://badge.fury.io/js/places-autocomplete-svelte.svg)](https://badge.fury.io/js/places-autocomplete-svelte)
 [![License: MIT](https://img.shields.io/badge/License-MIT-yellow.svg)](https://opensource.org/licenses/MIT)
-[![Google Maps Platform Awards 2025](https://img.shields.io/badge/Google%20Maps%20Platform-Awards%202025%20Winner-4285F4?style=flat&logo=google-maps&logoColor=white)](https://developers.google.com/maps)
+[![Google Maps Platform Awards 2025](https://img.shields.io/badge/Google%20Maps%20Platform-Awards%202025%20Winner-4285F4?style=flat&logo=google-maps&logoColor=white)](https://mapsplatform.google.com/awards/)
 
 A flexible, accessible, and secure [Svelte](https://kit.svelte.dev) component leveraging the [Google Maps Places Autocomplete API (New)](https://developers.google.com/maps/documentation/javascript/place-autocomplete-overview). **Winner of the Google Maps Platform Awards 2025**, recognising excellence in Google Maps Platform development.
 
@@ -74,7 +74,7 @@ Explore live examples showcasing different features and use cases:
 
 ### 🏆 Google Maps Platform Awards 2025 Winner
 <p align="left">
-  <a href="https://developers.google.com/maps">
+  <a href="https://mapsplatform.google.com/awards/">
     <img src="badge.svg" alt="Google Maps Platform Awards 2025 Winner" width="200">
   </a>
 </p>
@@ -267,6 +267,9 @@ Get a reference to the component instance using `bind:this` to call its methods
 <button onclick={() => autocompleteComponent?.setRequestParams({ region: 'FR', language: 'fr' })}>
     Switch to French
 </button>
+<button onclick={() => autocompleteComponent?.setOptions({ placeholder: 'Search locations...', debounce: 300 })}>
+    Update Options
+</button>
 ```
 
 | Method | Signature | Description |
@@ -277,6 +280,8 @@ Get a reference to the component instance using `bind:this` to call its methods
 | `setRequestParams(params)` | `(params: Partial<RequestParams>) => void` | Dynamically updates request parameters. Useful for changing search criteria (region, language, location bias, etc.). Parameters are merged with existing ones. |
 | `setFetchFields(fields)` | `(fields: string[]) => void` | Dynamically updates the Place Data Fields to fetch when a place is selected. |
 | `getFetchFields()` | `() => string[]` | Returns the current array of Place Data Fields that will be requested. |
+| `setOptions(options)` | `(options: Partial<ComponentOptions>) => void` | Dynamically updates the component's configuration options. Merges the provided options with existing settings. |
+| `getOptions()` | `() => ComponentOptions` | Returns the current validated options used by the component. Useful for inspecting configuration settings. |
 
 ## Options
 
@@ -387,7 +392,7 @@ This component is fully written in TypeScript with comprehensive type definition
 
 **Component:**
 ```typescript
-import PlaceAutocomplete from 'places-autocomplete-svelte';
+import { PlaceAutocomplete } from 'places-autocomplete-svelte';
 ```
 
 **Types and Interfaces:**

package/dist/PlaceAutocomplete.svelte

@@ -73,9 +73,9 @@
 	/**
 	 * Create validated derived values that react to prop changes
 	 */
-	const validatedOptions = $derived(validateOptions(options));
-	const validatedFetchFields = $derived(validateFetchFields(fetchFields));
-	const validatedRequestParams = $derived(validateRequestParams(requestParams));
+	let validatedOptions = $derived(validateOptions(options));
+	let validatedFetchFields = $derived(validateFetchFields(fetchFields));
+	let validatedRequestParams = $derived(validateRequestParams(requestParams));
 
 	/**
 	 * Local variables
@@ -164,7 +164,7 @@
 	 * @returns {RequestParams} The current request parameters object.
 	 */
 	export function getRequestParams() {
-		return request;
+		return validatedRequestParams;
 	}
 
 	/**
@@ -187,7 +187,7 @@
 	 * });
 	 */
 	export function setRequestParams(params: Partial<typeof requestParams>) {
-		requestParams = { ...requestParams, ...params };
+		validatedRequestParams = validateRequestParams({ ...requestParams, ...params });
 	}
 
 	/**
@@ -200,7 +200,7 @@
 	 * autocompleteComponent.setFetchFields(['displayName', 'types', 'location']);
 	 */
 	export function setFetchFields(fields: string[]) {
-		fetchFields = fields;
+		validatedFetchFields = validateFetchFields(fields);
 	}
 
 	/**
@@ -212,9 +212,40 @@
 	 * console.log('Current fields:', fields);
 	 */
 	export function getFetchFields(): string[] {
-		return fetchFields;
+		return validatedFetchFields;
 	}
 
+	/**
+	 * Dynamically updates the component's configuration options.
+	 * Merges the provided options with existing settings.
+	 * @public
+	 * @param options - Partial options object to update component behavior and appearance.
+	 * @example
+	 * // Update options to change placeholder and enable distance display
+	 * autocompleteComponent.setOptions({
+	 *   placeholder: 'Enter a location',
+	 *   showDistance: true
+	 * });
+	 */
+	export function setOptions(options: typeof validatedOptions){
+		validatedOptions = validateOptions(options);
+	}	
+
+
+	/**
+	 * Returns the current validated options used by the component.
+	 * Useful for inspecting configuration settings.
+	 * @public
+	 * @returns {typeof validatedOptions} The current validated options object.
+	 * @example
+	 * const options = autocompleteComponent.getOptions();
+	 * console.log('Current options:', options);
+	 */
+	export function getOptions(): typeof validatedOptions {
+		return validatedOptions;
+	}
+
+
 	/**
 	 * Extracts a specific address component from the place response.
 	 * @private
@@ -317,10 +348,10 @@
 
 	/**
 	 * Debounced version of makeAcRequest that delays API calls to reduce request frequency.
-	 * The debounce delay is reactive and updates when the options.debounce value changes.
+	 * The debounce delay is reactive and updates when the validatedOptions.debounce value changes.
 	 * @private
 	 */
-	const debouncedMakeAcRequest = $derived(debounce(makeAcRequest, options?.debounce ?? 100));
+	const debouncedMakeAcRequest = $derived(debounce(makeAcRequest, validatedOptions?.debounce ?? 100));
 
 	/**
 	 * Handles the selection of an autocomplete suggestion.
@@ -388,7 +419,7 @@
 			// If the parent has already finished, this resolves immediately.
 			// If the parent is still loading, this will wait.
 			if (typeof gmaps !== 'undefined' && gmaps) {
-				await gmaps?.initializationPromise;
+				await gmaps?.initialisationPromise;
 			} else {
 				// Check if the API key is provided
 				if (PUBLIC_GOOGLE_MAPS_API_KEY === '' || !PUBLIC_GOOGLE_MAPS_API_KEY) {

package/dist/PlaceAutocomplete.svelte.d.ts

@@ -2,10 +2,12 @@ import type { Props } from './interfaces.js';
 declare const PlaceAutocomplete: import("svelte").Component<Props, {
     clear: () => void;
     focus: () => void;
-    getRequestParams: () => any;
+    getRequestParams: () => import("./interfaces.js").RequestParams;
     setRequestParams: (params: Partial<import("./interfaces.js").RequestParams>) => void;
     setFetchFields: (fields: string[]) => void;
     getFetchFields: () => string[];
+    setOptions: (options: import("./interfaces.js").ComponentOptions) => void;
+    getOptions: () => import("./interfaces.js").ComponentOptions;
 }, "onResponse" | "onError">;
 type PlaceAutocomplete = ReturnType<typeof PlaceAutocomplete>;
 export default PlaceAutocomplete;

package/package.json

@@ -1,7 +1,7 @@
 {
 	"name": "places-autocomplete-svelte",
 	"license": "MIT",
-	"version": "2.2.21",
+	"version": "2.2.22",
 	"description": "A flexible, accessible, and secure Svelte component leveraging the Google Maps Places Autocomplete API (New). Winner of the Google Maps Platform Awards 2025, recognising excellence in Google Maps Platform development.",
 	"keywords": [
 		"svelte",