@stachelock/ui 0.5.5 → 0.6.2

package/dist/src/components/maps/UiInfoWindow.d.ts

@@ -329,6 +329,7 @@ declare const _default: __VLS_WithTemplateSlots<import('vue').DefineComponent<im
     "onUpdate:visible"?: ((value: boolean) => any) | undefined;
 }>, {
     error: string | null;
+    title: string;
     data: Record<string, any>;
     details: {
         /**
@@ -371,7 +372,6 @@ declare const _default: __VLS_WithTemplateSlots<import('vue').DefineComponent<im
          */
         type?: "link" | "text" | "email" | "phone" | "address" | undefined;
     }[] | undefined;
-    title: string;
     loading: boolean;
     visible: boolean;
     closeOnEscape: boolean;
@@ -419,10 +419,10 @@ declare const _default: __VLS_WithTemplateSlots<import('vue').DefineComponent<im
     imageUrl: string;
     content: string;
     subtitle: string;
+    closeOnBackdrop: boolean;
     loadingText: string;
     showRetry: boolean;
     showAvatar: boolean;
-    closeOnBackdrop: boolean;
 }, {}, {}, {}, string, import('vue').ComponentProvideOptions, true, {}, any>, {
     title?(_: {}): any;
     subtitle?(_: {}): any;

package/dist/src/components/maps/UiMap.d.ts

@@ -658,8 +658,8 @@ declare const _default: __VLS_WithTemplateSlots<import('vue').DefineComponent<im
 }>> & Readonly<{
     [x: `on${Capitalize<any>}`]: ((...args: any[] | unknown[]) => any) | undefined;
 }>, {
-    center: LatLngLiteral;
     id: string;
+    center: LatLngLiteral;
     width: string;
     theme: MapTheme;
     heading: number;
@@ -669,8 +669,8 @@ declare const _default: __VLS_WithTemplateSlots<import('vue').DefineComponent<im
     styles: MapStyles;
     containerClass: string;
     zoom: number;
-    loadingText: string;
     apiKey: string;
+    loadingText: string;
     clickableIcons: boolean;
     disableDefaultUi: boolean;
     disableDoubleClickZoom: boolean;

package/dist/src/components/maps/UiMapAll.d.ts

@@ -529,9 +529,9 @@ declare const _default: __VLS_WithTemplateSlots<import('vue').DefineComponent<im
     }) => any) | undefined;
     "onUpdate:visible-markers"?: ((markers: MapMarker<unknown>[]) => any) | undefined;
 }>, {
+    items: MapMarker<unknown>[] | Record<string, unknown>[];
     center: LatLngLiteral;
     width: string;
-    items: MapMarker<unknown>[] | Record<string, unknown>[];
     theme: MapTheme;
     height: string;
     zoom: number;
@@ -573,8 +573,8 @@ declare const _default: __VLS_WithTemplateSlots<import('vue').DefineComponent<im
         $: import('vue').ComponentInternalInstance;
         $data: {};
         $props: Partial<{
-            center: LatLngLiteral;
             id: string;
+            center: LatLngLiteral;
             width: string;
             theme: MapTheme;
             heading: number;
@@ -584,8 +584,8 @@ declare const _default: __VLS_WithTemplateSlots<import('vue').DefineComponent<im
             styles: import('../../utils/mapThemes').MapStyles;
             containerClass: string;
             zoom: number;
-            loadingText: string;
             apiKey: string;
+            loadingText: string;
             clickableIcons: boolean;
             disableDefaultUi: boolean;
             disableDoubleClickZoom: boolean;
@@ -628,8 +628,8 @@ declare const _default: __VLS_WithTemplateSlots<import('vue').DefineComponent<im
             readonly draggable: boolean;
             readonly height: string;
             readonly containerClass: string;
-            readonly loadingText: string;
             readonly apiKey: string;
+            readonly loadingText: string;
             readonly clickableIcons: boolean;
             readonly disableDefaultUi: boolean;
             readonly disableDoubleClickZoom: boolean;
@@ -665,7 +665,7 @@ declare const _default: __VLS_WithTemplateSlots<import('vue').DefineComponent<im
                 strictBounds?: boolean | undefined;
             } | undefined;
             readonly mapStyle?: Record<string, any> | undefined;
-        } & import('vue').VNodeProps & import('vue').AllowedComponentProps & import('vue').ComponentCustomProps, "center" | "id" | "width" | "theme" | "heading" | "maxZoom" | "draggable" | "height" | "styles" | "containerClass" | "zoom" | "loadingText" | "apiKey" | "clickableIcons" | "disableDefaultUi" | "disableDoubleClickZoom" | "fullscreenControl" | "gestureHandling" | "keyboardShortcuts" | "mapTypeControl" | "mapTypeId" | "minZoom" | "restriction" | "rotateControl" | "scaleControl" | "scrollwheel" | "streetViewControl" | "tilt" | "zoomControl" | "showRetry" | "autoTheme" | "lightTheme" | "darkTheme" | "mapClass" | "mapStyle" | "hideLoadingState" | "hideErrorState" | "showAddressUnavailable" | "addressUnavailableMessage" | "showCustomControls" | "showDefaultZoomControls" | "controlsPosition">;
+        } & import('vue').VNodeProps & import('vue').AllowedComponentProps & import('vue').ComponentCustomProps, "id" | "center" | "width" | "theme" | "heading" | "maxZoom" | "draggable" | "height" | "styles" | "containerClass" | "zoom" | "apiKey" | "loadingText" | "clickableIcons" | "disableDefaultUi" | "disableDoubleClickZoom" | "fullscreenControl" | "gestureHandling" | "keyboardShortcuts" | "mapTypeControl" | "mapTypeId" | "minZoom" | "restriction" | "rotateControl" | "scaleControl" | "scrollwheel" | "streetViewControl" | "tilt" | "zoomControl" | "showRetry" | "autoTheme" | "lightTheme" | "darkTheme" | "mapClass" | "mapStyle" | "hideLoadingState" | "hideErrorState" | "showAddressUnavailable" | "addressUnavailableMessage" | "showCustomControls" | "showDefaultZoomControls" | "controlsPosition">;
         $attrs: {
             [x: string]: unknown;
         };
@@ -1360,8 +1360,8 @@ declare const _default: __VLS_WithTemplateSlots<import('vue').DefineComponent<im
         } & {
             [x: string]: any;
         }, string, {
-            center: LatLngLiteral;
             id: string;
+            center: LatLngLiteral;
             width: string;
             theme: MapTheme;
             heading: number;
@@ -1371,8 +1371,8 @@ declare const _default: __VLS_WithTemplateSlots<import('vue').DefineComponent<im
             styles: import('../../utils/mapThemes').MapStyles;
             containerClass: string;
             zoom: number;
-            loadingText: string;
             apiKey: string;
+            loadingText: string;
             clickableIcons: boolean;
             disableDefaultUi: boolean;
             disableDoubleClickZoom: boolean;
@@ -1426,8 +1426,8 @@ declare const _default: __VLS_WithTemplateSlots<import('vue').DefineComponent<im
         $nextTick: typeof import('vue').nextTick;
         $watch<T extends string | ((...args: any) => any)>(source: T, cb: T extends (...args: any) => infer R ? (args_0: R, args_1: R, args_2: import('@vue/reactivity').OnCleanup) => any : (args_0: any, args_1: any, args_2: import('@vue/reactivity').OnCleanup) => any, options?: import('vue').WatchOptions<boolean> | undefined): import('vue').WatchStopHandle;
     } & Readonly<{
-        center: LatLngLiteral;
         id: string;
+        center: LatLngLiteral;
         width: string;
         theme: MapTheme;
         heading: number;
@@ -1437,8 +1437,8 @@ declare const _default: __VLS_WithTemplateSlots<import('vue').DefineComponent<im
         styles: import('../../utils/mapThemes').MapStyles;
         containerClass: string;
         zoom: number;
-        loadingText: string;
         apiKey: string;
+        loadingText: string;
         clickableIcons: boolean;
         disableDefaultUi: boolean;
         disableDoubleClickZoom: boolean;
@@ -1645,7 +1645,7 @@ declare const _default: __VLS_WithTemplateSlots<import('vue').DefineComponent<im
         };
     }>> & Readonly<{
         [x: `on${Capitalize<any>}`]: ((...args: any[] | unknown[]) => any) | undefined;
-    }>, "reset" | "fitBounds" | "getBounds" | "getCenter" | "getZoom" | "panBy" | "panTo" | "setCenter" | "setZoom" | "getMap" | "fitToMarkers" | "addMarker" | "removeMarker" | "updateMarker" | "clearMarkers" | "getMarkers" | "getVisibleMarkers" | ("center" | "id" | "width" | "theme" | "heading" | "maxZoom" | "draggable" | "height" | "styles" | "containerClass" | "zoom" | "loadingText" | "apiKey" | "clickableIcons" | "disableDefaultUi" | "disableDoubleClickZoom" | "fullscreenControl" | "gestureHandling" | "keyboardShortcuts" | "mapTypeControl" | "mapTypeId" | "minZoom" | "restriction" | "rotateControl" | "scaleControl" | "scrollwheel" | "streetViewControl" | "tilt" | "zoomControl" | "showRetry" | "autoTheme" | "lightTheme" | "darkTheme" | "mapClass" | "mapStyle" | "hideLoadingState" | "hideErrorState" | "showAddressUnavailable" | "addressUnavailableMessage" | "showCustomControls" | "showDefaultZoomControls" | "controlsPosition")> & import('vue').ShallowUnwrapRef<{
+    }>, "reset" | "fitBounds" | "getBounds" | "getCenter" | "getZoom" | "panBy" | "panTo" | "setCenter" | "setZoom" | "getMap" | "fitToMarkers" | "addMarker" | "removeMarker" | "updateMarker" | "clearMarkers" | "getMarkers" | "getVisibleMarkers" | ("id" | "center" | "width" | "theme" | "heading" | "maxZoom" | "draggable" | "height" | "styles" | "containerClass" | "zoom" | "apiKey" | "loadingText" | "clickableIcons" | "disableDefaultUi" | "disableDoubleClickZoom" | "fullscreenControl" | "gestureHandling" | "keyboardShortcuts" | "mapTypeControl" | "mapTypeId" | "minZoom" | "restriction" | "rotateControl" | "scaleControl" | "scrollwheel" | "streetViewControl" | "tilt" | "zoomControl" | "showRetry" | "autoTheme" | "lightTheme" | "darkTheme" | "mapClass" | "mapStyle" | "hideLoadingState" | "hideErrorState" | "showAddressUnavailable" | "addressUnavailableMessage" | "showCustomControls" | "showDefaultZoomControls" | "controlsPosition")> & import('vue').ShallowUnwrapRef<{
         getMap(): google.maps.Map | null;
         panTo(position: LatLngLiteral): void;
         panBy(x: number, y: number): void; /** Data loading state */

package/dist/src/components/maps/UiMapMarker.d.ts

@@ -197,11 +197,11 @@ declare const _default: __VLS_WithTemplateSlots<import('vue').DefineComponent<im
         marker: MapMarker<unknown>;
     }) => any) | undefined;
 }>, {
+    id: string | number;
     label: string | MapMarkerLabel;
     icon: MapMarkerIcon;
-    id: string | number;
-    data: Record<string, any>;
     title: string;
+    data: Record<string, any>;
     color: string;
     animation: "DROP" | "BOUNCE";
     size: "sm" | "md" | "lg";

package/dist/src/components/modals/BaseModal.d.ts

@@ -108,9 +108,9 @@ declare const _default: __VLS_WithTemplateSlots<import('vue').DefineComponent<im
     cancelText: string;
     confirmText: string;
     confirmTheme: Theme;
+    showCloseButton: boolean;
     showFooter: boolean;
     closeOnBackdrop: boolean;
-    showCloseButton: boolean;
 }, {}, {}, {}, string, import('vue').ComponentProvideOptions, true, {}, any>, {
     icon?(_: {}): any;
     header?(_: {}): any;

package/dist/src/components/profiles/BentoProfileLayout.d.ts

@@ -0,0 +1,9 @@
+import { ProfileData, ProfilePreviewConfig } from '../../types/profiles';
+interface Props {
+    profile: ProfileData;
+    config?: ProfilePreviewConfig;
+}
+declare const _default: import('vue').DefineComponent<Props, {}, {}, {}, {}, import('vue').ComponentOptionsMixin, import('vue').ComponentOptionsMixin, {}, string, import('vue').PublicProps, Readonly<Props> & Readonly<{}>, {
+    config: ProfilePreviewConfig;
+}, {}, {}, {}, string, import('vue').ComponentProvideOptions, false, {}, HTMLDivElement>;
+export default _default;

package/dist/src/components/profiles/ProfileCard.d.ts

@@ -0,0 +1,30 @@
+import { Component } from 'vue';
+interface Props {
+    /** Card header title */
+    title?: string;
+    /** Icon component for header */
+    icon?: Component;
+    /** Animation delay index */
+    animationIndex?: number;
+    /** Delay per animation index in ms */
+    animationDelay?: number;
+    /** Remove default padding */
+    noPadding?: boolean;
+    /** Enable animation */
+    animationEnabled?: boolean;
+}
+declare const _default: __VLS_WithTemplateSlots<import('vue').DefineComponent<Props, {}, {}, {}, {}, import('vue').ComponentOptionsMixin, import('vue').ComponentOptionsMixin, {}, string, import('vue').PublicProps, Readonly<Props> & Readonly<{}>, {
+    animationDelay: number;
+    noPadding: boolean;
+    animationIndex: number;
+    animationEnabled: boolean;
+}, {}, {}, {}, string, import('vue').ComponentProvideOptions, false, {}, HTMLDivElement>, {
+    header?(_: {}): any;
+    default?(_: {}): any;
+}>;
+export default _default;
+type __VLS_WithTemplateSlots<T, S> = T & {
+    new (): {
+        $slots: S;
+    };
+};

package/dist/src/components/profiles/ProfileContactCard.d.ts

@@ -0,0 +1,12 @@
+interface Props {
+    email?: string;
+    phone?: string;
+    website?: string;
+    animationIndex?: number;
+    animationEnabled?: boolean;
+}
+declare const _default: import('vue').DefineComponent<Props, {}, {}, {}, {}, import('vue').ComponentOptionsMixin, import('vue').ComponentOptionsMixin, {}, string, import('vue').PublicProps, Readonly<Props> & Readonly<{}>, {
+    animationIndex: number;
+    animationEnabled: boolean;
+}, {}, {}, {}, string, import('vue').ComponentProvideOptions, false, {}, HTMLDivElement>;
+export default _default;

package/dist/src/components/profiles/ProfileHeaderCard.d.ts

@@ -0,0 +1,20 @@
+import { ProfileImage } from '../../types/profiles';
+interface Props {
+    /** Display name */
+    name: string;
+    /** User's nickname */
+    nickname?: string;
+    /** Avatar image URL or Cloudinary asset object */
+    image?: string | ProfileImage;
+    /** User status */
+    status?: 'active' | 'inactive' | string;
+    /** Animation delay index */
+    animationIndex?: number;
+    /** Enable animation */
+    animationEnabled?: boolean;
+}
+declare const _default: import('vue').DefineComponent<Props, {}, {}, {}, {}, import('vue').ComponentOptionsMixin, import('vue').ComponentOptionsMixin, {}, string, import('vue').PublicProps, Readonly<Props> & Readonly<{}>, {
+    animationIndex: number;
+    animationEnabled: boolean;
+}, {}, {}, {}, string, import('vue').ComponentProvideOptions, false, {}, HTMLDivElement>;
+export default _default;

package/dist/src/components/profiles/ProfileLocationCard.d.ts

@@ -0,0 +1,17 @@
+import { AddressInfo } from '../../types/profiles';
+interface Props {
+    address?: AddressInfo | AddressInfo[];
+    latLng?: {
+        lat: number;
+        lng: number;
+    };
+    showMap?: boolean;
+    animationIndex?: number;
+    animationEnabled?: boolean;
+}
+declare const _default: import('vue').DefineComponent<Props, {}, {}, {}, {}, import('vue').ComponentOptionsMixin, import('vue').ComponentOptionsMixin, {}, string, import('vue').PublicProps, Readonly<Props> & Readonly<{}>, {
+    animationIndex: number;
+    animationEnabled: boolean;
+    showMap: boolean;
+}, {}, {}, {}, string, import('vue').ComponentProvideOptions, false, {}, HTMLDivElement>;
+export default _default;

package/dist/src/components/profiles/ProfileOrganizationsCard.d.ts

@@ -0,0 +1,11 @@
+import { OrganizationItem } from '../../types/profiles';
+interface Props {
+    organizations?: OrganizationItem[];
+    animationIndex?: number;
+    animationEnabled?: boolean;
+}
+declare const _default: import('vue').DefineComponent<Props, {}, {}, {}, {}, import('vue').ComponentOptionsMixin, import('vue').ComponentOptionsMixin, {}, string, import('vue').PublicProps, Readonly<Props> & Readonly<{}>, {
+    animationIndex: number;
+    animationEnabled: boolean;
+}, {}, {}, {}, string, import('vue').ComponentProvideOptions, false, {}, HTMLDivElement>;
+export default _default;

package/dist/src/components/profiles/ProfilePersonalCard.d.ts

@@ -0,0 +1,10 @@
+interface Props {
+    birthday?: Date | string | null;
+    animationIndex?: number;
+    animationEnabled?: boolean;
+}
+declare const _default: import('vue').DefineComponent<Props, {}, {}, {}, {}, import('vue').ComponentOptionsMixin, import('vue').ComponentOptionsMixin, {}, string, import('vue').PublicProps, Readonly<Props> & Readonly<{}>, {
+    animationIndex: number;
+    animationEnabled: boolean;
+}, {}, {}, {}, string, import('vue').ComponentProvideOptions, false, {}, HTMLDivElement>;
+export default _default;

package/dist/src/components/profiles/ProfileProfessionalCard.d.ts

@@ -0,0 +1,11 @@
+import { ProfessionalInfo } from '../../types/profiles';
+interface Props {
+    professional?: ProfessionalInfo;
+    animationIndex?: number;
+    animationEnabled?: boolean;
+}
+declare const _default: import('vue').DefineComponent<Props, {}, {}, {}, {}, import('vue').ComponentOptionsMixin, import('vue').ComponentOptionsMixin, {}, string, import('vue').PublicProps, Readonly<Props> & Readonly<{}>, {
+    animationIndex: number;
+    animationEnabled: boolean;
+}, {}, {}, {}, string, import('vue').ComponentProvideOptions, false, {}, HTMLDivElement>;
+export default _default;

package/dist/src/components/profiles/ProfileRelatedNamesCard.d.ts

@@ -0,0 +1,11 @@
+import { RelatedNameItem } from '../../types/profiles';
+interface Props {
+    relatedNames?: RelatedNameItem[];
+    animationIndex?: number;
+    animationEnabled?: boolean;
+}
+declare const _default: import('vue').DefineComponent<Props, {}, {}, {}, {}, import('vue').ComponentOptionsMixin, import('vue').ComponentOptionsMixin, {}, string, import('vue').PublicProps, Readonly<Props> & Readonly<{}>, {
+    animationIndex: number;
+    animationEnabled: boolean;
+}, {}, {}, {}, string, import('vue').ComponentProvideOptions, false, {}, HTMLDivElement>;
+export default _default;

package/dist/src/components/profiles/index.d.ts

@@ -0,0 +1,9 @@
+export { default as BentoProfileLayout } from './BentoProfileLayout';
+export { default as ProfileCard } from './ProfileCard';
+export { default as ProfileContactCard } from './ProfileContactCard';
+export { default as ProfileHeaderCard } from './ProfileHeaderCard';
+export { default as ProfileLocationCard } from './ProfileLocationCard';
+export { default as ProfileOrganizationsCard } from './ProfileOrganizationsCard';
+export { default as ProfilePersonalCard } from './ProfilePersonalCard';
+export { default as ProfileProfessionalCard } from './ProfileProfessionalCard';
+export { default as ProfileRelatedNamesCard } from './ProfileRelatedNamesCard';

package/dist/src/composables/index.d.ts

@@ -1,4 +1,5 @@
 export * from './useCalendar';
+export * from './useCollectionEditor';
 export * from './useEventSegments';
 export * from './useFormValidation';
 export * from './useMap';

package/dist/src/composables/useCollectionEditor.d.ts

@@ -0,0 +1,64 @@
+import { Ref, ComputedRef } from 'vue';
+import { CollectionItem, CollectionButtonAttributes } from '../types/collection-editor';
+export { CollectionItemStatus } from '../types/collection-editor';
+export interface CollectionEditorOptions<T extends CollectionItem> {
+    /** Initial items */
+    initialItems?: T[];
+    /** Empty form values template */
+    emptyFormValues: T;
+    /** Transform item before adding to list (explode) */
+    explodeItem?: (item: T) => T;
+    /** Transform item before emitting (implode) */
+    implodeItem?: (item: T) => T;
+    /** Status enum values */
+    statusEnum?: {
+        New: string;
+        Pending: string;
+        Saved: string;
+    };
+}
+export interface CollectionEditorReturn<T extends CollectionItem> {
+    /** Current items in the collection */
+    items: Ref<T[]>;
+    /** Currently active/selected item for editing */
+    activeItem: Ref<T | null>;
+    /** Current form values */
+    formValues: Ref<T>;
+    /** Reference to the form component */
+    formRef: Ref<any>;
+    /** Button attributes for add/save/delete */
+    buttonAttributes: ComputedRef<CollectionButtonAttributes>;
+    /** Whether delete confirmation modal should show */
+    showDeleteConfirm: Ref<boolean>;
+    /** Whether form is dirty */
+    isDirty: ComputedRef<boolean>;
+    /** Add a new item */
+    addItem: () => void;
+    /** Update current item */
+    updateItem: (values: Partial<T>) => void;
+    /** Delete current item */
+    deleteItem: () => void;
+    /** Select an item for editing */
+    selectItem: (item: T) => void;
+    /** Clear selection */
+    clearSelection: () => void;
+    /** Handle button click (add, save, delete) */
+    handleButtonClick: (action: 'add' | 'save' | 'delete') => void;
+    /** Handle form submit */
+    handleFormSubmit: (values: T) => void;
+    /** Handle form update */
+    handleFormUpdate: (values: Partial<T>) => void;
+    /** Confirm delete action */
+    confirmDelete: () => void;
+    /** Cancel delete action */
+    cancelDelete: () => void;
+    /** Reset form to empty state */
+    resetForm: () => void;
+    /** Get all items for saving */
+    getItems: () => T[];
+}
+/**
+ * Create a collection editor composable instance
+ */
+export declare function useCollectionEditor<T extends CollectionItem>(options: CollectionEditorOptions<T>, emit: (event: string, ...args: any[]) => void): CollectionEditorReturn<T>;
+export default useCollectionEditor;

package/dist/src/composables/useNotifications.d.ts

@@ -530,11 +530,11 @@ export declare function useNotifications(): {
         readonly cardOffsetY?: number | undefined;
         readonly zIndex?: number | undefined;
         readonly id: string;
+        readonly position: NotificationPosition;
         readonly title: string;
         readonly message: string;
         readonly theme: NotificationTheme;
         readonly timeout: number;
-        readonly position: NotificationPosition;
         readonly autoClose: boolean;
         readonly variant: NotificationVariant;
         readonly priority: NotificationPriority;
@@ -895,11 +895,11 @@ export declare function useNotifications(): {
         readonly cardOffsetY?: number | undefined;
         readonly zIndex?: number | undefined;
         readonly id: string;
+        readonly position: NotificationPosition;
         readonly title: string;
         readonly message: string;
         readonly theme: NotificationTheme;
         readonly timeout: number;
-        readonly position: NotificationPosition;
         readonly autoClose: boolean;
         readonly variant: NotificationVariant;
         readonly priority: NotificationPriority;
@@ -1050,11 +1050,11 @@ export declare function useNotifications(): {
         cardOffsetY?: number | undefined;
         zIndex?: number | undefined;
         id: string;
+        position: NotificationPosition;
         title: string;
         message: string;
         theme: NotificationTheme;
         timeout: number;
-        position: NotificationPosition;
         autoClose: boolean;
         variant: NotificationVariant;
         priority: NotificationPriority;
@@ -1205,11 +1205,11 @@ export declare function useNotifications(): {
         cardOffsetY?: number | undefined;
         zIndex?: number | undefined;
         id: string;
+        position: NotificationPosition;
         title: string;
         message: string;
         theme: NotificationTheme;
         timeout: number;
-        position: NotificationPosition;
         autoClose: boolean;
         variant: NotificationVariant;
         priority: NotificationPriority;

package/dist/src/plugin/configure.d.ts

@@ -20,10 +20,12 @@ export interface CloudinaryOptions {
 export interface GoogleMapsOptions {
     /** Your Google Maps API key */
     apiKey: string;
+    /** Optional separate API key for Static Maps (thumbnails) */
+    staticMapsApiKey?: string;
     /** Map version (optional, defaults to 'weekly') */
     version?: string;
     /** Additional libraries to load (places, geometry, etc.) */
-    libraries?: ('places' | 'geometry' | 'drawing' | 'visualization')[];
+    libraries?: ('places' | 'geometry' | 'drawing' | 'visualization' | 'maps')[];
     /** Default map center coordinates */
     defaultCenter?: {
         lat: number;

package/dist/src/services/geocoding.service.d.ts

@@ -0,0 +1,68 @@
+import { GeocodeResult, PlaceSuggestion, GeocodingConfig } from '../types/address';
+/**
+ * Configure the geocoding service with Google Maps API credentials
+ * Must be called before using any geocoding functions
+ */
+export declare function configureGeocoding(config: GeocodingConfig): void;
+/**
+ * Get the current geocoding configuration
+ */
+export declare function getGeocodingConfig(): GeocodingConfig | null;
+/**
+ * Check if geocoding service is configured
+ */
+export declare function isGeocodingConfigured(): boolean;
+/**
+ * Check if Google Maps API is loaded and ready
+ */
+export declare function isGeocodingReady(): boolean;
+/**
+ * Load the Google Maps API with Places library
+ * Returns a promise that resolves when the API is ready
+ */
+export declare function loadGoogleMapsAPI(): Promise<void>;
+/**
+ * Clear the geocode cache
+ */
+export declare function clearGeocodeCache(): void;
+/**
+ * Geocode by Google Place ID (from autocomplete selection)
+ */
+export declare function geocodeByPlaceId(placeId: string): Promise<GeocodeResult>;
+/**
+ * Check if a string looks like a valid address worth geocoding
+ * Helps avoid unnecessary API calls for incomplete input
+ */
+export declare function isGeocodeWorthyAddress(value: string): boolean;
+/**
+ * Geocode by address string (for manual address entry)
+ */
+export declare function geocodeByAddress(address: string): Promise<GeocodeResult>;
+/**
+ * Fetch place suggestions for autocomplete
+ * Uses the new AutocompleteSuggestion API (recommended as of March 2025)
+ */
+export declare function fetchPlaceSuggestions(query: string, options?: {
+    includedPrimaryTypes?: string[];
+    includedRegionCodes?: string[];
+}): Promise<PlaceSuggestion[]>;
+/**
+ * Extract individual address fields from geocode result
+ */
+export declare function extractAddressFields(geocodeResult: GeocodeResult | null): {
+    street: string;
+    city: string;
+    state: string;
+    zipcode: string;
+    country: string;
+};
+/**
+ * Build a full address string from individual fields for geocoding
+ */
+export declare function buildAddressString(fields: {
+    street?: string;
+    city?: string;
+    state?: string;
+    zipcode?: string;
+    country?: string;
+}): string;

package/dist/src/services/index.d.ts

@@ -0,0 +1 @@
+export * from './geocoding.service';