@stachelock/ui 0.2.14 → 0.3.1

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

@@ -1,9 +1,45 @@
 import { CalendarDay, Month } from '../utils/calendar';
 
+/**
+ * Calendar view modes
+ * - day: Single day view
+ * - week: Week view (7 days)
+ * - month: Full month calendar grid
+ * - year: Year overview with months
+ */
 export type CalendarMode = 'day' | 'week' | 'month' | 'year';
+/**
+ * Calendar composable for date navigation and view management
+ *
+ * @param initialMode - Starting view mode (default: 'month')
+ * @returns Reactive calendar state and navigation methods
+ *
+ * @example
+ * ```vue
+ * <script setup>
+ * import { useCalendar } from '@stachelock/ui'
+ *
+ * const { mode, currentDate, days, prev, next } = useCalendar()
+ * </script>
+ *
+ * <template>
+ *   <div>
+ *     <button @click="prev">Previous</button>
+ *     <span>{{ currentDate.toLocaleDateString() }}</span>
+ *     <button @click="next">Next</button>
+ *   </div>
+ *   <div v-for="day in days" :key="day.date">
+ *     {{ day.day }}
+ *   </div>
+ * </template>
+ * ```
+ */
 export declare function useCalendar(initialMode?: CalendarMode): {
+    /** Current view mode (day/week/month/year) */
     mode: import('vue').Ref<CalendarMode, CalendarMode>;
+    /** Current reference date for the calendar */
     currentDate: import('vue').Ref<Date, Date>;
+    /** Array of calendar days for current view */
     days: import('vue').Ref<{
         id?: string | number | undefined;
         date: string;
@@ -16,22 +52,26 @@ export declare function useCalendar(initialMode?: CalendarMode): {
             date: string;
             time: string;
             datetime: string;
-            location: string;
+            location?: string | undefined;
             href?: string | undefined;
             startTime?: {
                 dateTime: string;
-                timeZone: string;
-                shortTimeZone: string;
+                timeZone?: string | undefined;
+                shortTimeZone?: string | undefined;
             } | undefined;
             endTime?: {
                 dateTime: string;
-                timeZone: string;
-                shortTimeZone: string;
+                timeZone?: string | undefined;
+                shortTimeZone?: string | undefined;
             } | undefined;
             geocodeResult?: {
                 [x: string]: any;
                 thumbnailUrl?: string | undefined;
             } | undefined;
+            ratePlanCode?: string | undefined;
+            ratePlanColor?: string | undefined;
+            ratePlanName?: string | undefined;
+            isAllDay?: boolean | undefined;
         }[] | undefined;
         shortDay?: string | undefined;
         longDay?: string | undefined;
@@ -48,27 +88,32 @@ export declare function useCalendar(initialMode?: CalendarMode): {
             date: string;
             time: string;
             datetime: string;
-            location: string;
+            location?: string | undefined;
             href?: string | undefined;
             startTime?: {
                 dateTime: string;
-                timeZone: string;
-                shortTimeZone: string;
+                timeZone?: string | undefined;
+                shortTimeZone?: string | undefined;
             } | undefined;
             endTime?: {
                 dateTime: string;
-                timeZone: string;
-                shortTimeZone: string;
+                timeZone?: string | undefined;
+                shortTimeZone?: string | undefined;
             } | undefined;
             geocodeResult?: {
                 [x: string]: any;
                 thumbnailUrl?: string | undefined;
             } | undefined;
+            ratePlanCode?: string | undefined;
+            ratePlanColor?: string | undefined;
+            ratePlanName?: string | undefined;
+            isAllDay?: boolean | undefined;
         }[] | undefined;
         shortDay?: string | undefined;
         longDay?: string | undefined;
         day?: number | undefined;
     }[]>;
+    /** Array of months (only populated in year view) */
     months: import('vue').Ref<{
         name: string;
         days: {
@@ -83,22 +128,26 @@ export declare function useCalendar(initialMode?: CalendarMode): {
                 date: string;
                 time: string;
                 datetime: string;
-                location: string;
+                location?: string | undefined;
                 href?: string | undefined;
                 startTime?: {
                     dateTime: string;
-                    timeZone: string;
-                    shortTimeZone: string;
+                    timeZone?: string | undefined;
+                    shortTimeZone?: string | undefined;
                 } | undefined;
                 endTime?: {
                     dateTime: string;
-                    timeZone: string;
-                    shortTimeZone: string;
+                    timeZone?: string | undefined;
+                    shortTimeZone?: string | undefined;
                 } | undefined;
                 geocodeResult?: {
                     [x: string]: any;
                     thumbnailUrl?: string | undefined;
                 } | undefined;
+                ratePlanCode?: string | undefined;
+                ratePlanColor?: string | undefined;
+                ratePlanName?: string | undefined;
+                isAllDay?: boolean | undefined;
             }[] | undefined;
             shortDay?: string | undefined;
             longDay?: string | undefined;
@@ -118,29 +167,36 @@ export declare function useCalendar(initialMode?: CalendarMode): {
                 date: string;
                 time: string;
                 datetime: string;
-                location: string;
+                location?: string | undefined;
                 href?: string | undefined;
                 startTime?: {
                     dateTime: string;
-                    timeZone: string;
-                    shortTimeZone: string;
+                    timeZone?: string | undefined;
+                    shortTimeZone?: string | undefined;
                 } | undefined;
                 endTime?: {
                     dateTime: string;
-                    timeZone: string;
-                    shortTimeZone: string;
+                    timeZone?: string | undefined;
+                    shortTimeZone?: string | undefined;
                 } | undefined;
                 geocodeResult?: {
                     [x: string]: any;
                     thumbnailUrl?: string | undefined;
                 } | undefined;
+                ratePlanCode?: string | undefined;
+                ratePlanColor?: string | undefined;
+                ratePlanName?: string | undefined;
+                isAllDay?: boolean | undefined;
             }[] | undefined;
             shortDay?: string | undefined;
             longDay?: string | undefined;
             day?: number | undefined;
         }[];
     }[]>;
+    /** Navigate to previous time period */
     prev: () => void;
+    /** Navigate to next time period */
     next: () => void;
 };
+export default useCalendar;
 //# sourceMappingURL=useCalendar.d.ts.map

package/dist/src/composables/useCalendar.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"useCalendar.d.ts","sourceRoot":"","sources":["../../../src/composables/useCalendar.ts"],"names":[],"mappings":"AACA,OAAO,EAAyD,KAAK,WAAW,EAAE,KAAK,KAAK,EAAE,MAAM,kBAAkB,CAAC;AAEvH,MAAM,MAAM,YAAY,GAAG,KAAK,GAAG,MAAM,GAAG,OAAO,GAAG,MAAM,CAAC;AAE7D,wBAAgB,WAAW,CAAC,WAAW,GAAE,YAAsB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;EAqC9D"}
+{"version":3,"file":"useCalendar.d.ts","sourceRoot":"","sources":["../../../src/composables/useCalendar.ts"],"names":[],"mappings":"AA0BA,OAAO,EAAyD,KAAK,WAAW,EAAE,KAAK,KAAK,EAAE,MAAM,kBAAkB,CAAC;AAEvH;;;;;;GAMG;AACH,MAAM,MAAM,YAAY,GAAG,KAAK,GAAG,MAAM,GAAG,OAAO,GAAG,MAAM,CAAC;AAE7D;;;;;;;;;;;;;;;;;;;;;;;;;GAyBG;AACH,wBAAgB,WAAW,CAAC,WAAW,GAAE,YAAsB;IAqC3D,8CAA8C;;IAE9C,8CAA8C;;IAE9C,8CAA8C;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;IAE9C,oDAAoD;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;IAEpD,uCAAuC;;IAEvC,mCAAmC;;EAGtC;AAED,eAAe,WAAW,CAAC"}

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

@@ -0,0 +1,74 @@
+/**
+ * @module composables/useEventSegments
+ * @description Utilities for handling multi-day events in calendar views
+ *
+ * Provides helpers for:
+ * - Determining event segment types (single, start, middle, end)
+ * - Generating consistent CSS classes for multi-day event bars
+ * - Calculating event lanes for non-overlapping display
+ *
+ * @example
+ * ```typescript
+ * import { useEventSegments } from '@stachelock/ui'
+ *
+ * const { getSegment, barClass, calculateEventLanes } = useEventSegments()
+ *
+ * // Get segment type for a day
+ * const segment = getSegment('2024-03-15', event)
+ * // Returns: 'single' | 'start' | 'middle' | 'end' | 'none'
+ *
+ * // Get CSS classes for rendering
+ * const classes = barClass('2024-03-15', event)
+ * ```
+ */
+export type CalendarEventLike = {
+    id?: string | number;
+    name?: string;
+    /** Preferred structure with explicit start/end times */
+    startTime?: {
+        dateTime?: string;
+    };
+    endTime?: {
+        dateTime?: string;
+    };
+    /** Legacy fallback: single datetime */
+    datetime?: string;
+    /** Optional color for rate-plan or category styling */
+    ratePlanColor?: string;
+    ratePlanCode?: string;
+    ratePlanName?: string;
+};
+export type EventSegment = 'none' | 'single' | 'start' | 'middle' | 'end';
+/**
+ * Calculate event lanes (vertical positions) for consistent rendering across multi-day events.
+ * Returns a map from eventId to its lane number for a given set of days.
+ *
+ * @param days Array of "YYYY-MM-DD" keys (e.g., 42 for a 6-week month view)
+ * @param events Array of events to position
+ * @returns Map from event ID to lane number
+ */
+export declare const calculateEventLanes: (days: string[], events: CalendarEventLike[]) => Map<string | number, number>;
+/**
+ * Hook providing utilities for multi-day event segment handling
+ */
+export declare const useEventSegments: () => {
+    /** Determine segment type for a day/event pair */
+    getSegment: (dayKey: string, event: CalendarEventLike) => EventSegment;
+    /** Whether to show event label for this segment */
+    shouldShowLabel: (segment: EventSegment) => boolean;
+    /** CSS classes for full-height event bar */
+    barClass: (dayKey: string, event: CalendarEventLike) => string;
+    /** CSS classes for compact event bar */
+    barClassCompact: (dayKey: string, event: CalendarEventLike) => string;
+    /** Calculate lane assignments for events */
+    calculateEventLanes: (days: string[], events: CalendarEventLike[]) => Map<string | number, number>;
+    /** Check if event spans multiple days */
+    isMultiDayEvent: (event: CalendarEventLike) => boolean;
+    /** Get event start ISO string */
+    getEventStartIso: (event: CalendarEventLike) => string | undefined;
+    /** Get event end ISO string */
+    getEventEndIso: (event: CalendarEventLike) => string | undefined;
+};
+export type UseEventSegments = ReturnType<typeof useEventSegments>;
+export default useEventSegments;
+//# sourceMappingURL=useEventSegments.d.ts.map

package/dist/src/composables/useEventSegments.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"useEventSegments.d.ts","sourceRoot":"","sources":["../../../src/composables/useEventSegments.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;GAsBG;AAEH,MAAM,MAAM,iBAAiB,GAAG;IAC9B,EAAE,CAAC,EAAE,MAAM,GAAG,MAAM,CAAC;IACrB,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,wDAAwD;IACxD,SAAS,CAAC,EAAE;QAAE,QAAQ,CAAC,EAAE,MAAM,CAAA;KAAE,CAAC;IAClC,OAAO,CAAC,EAAE;QAAE,QAAQ,CAAC,EAAE,MAAM,CAAA;KAAE,CAAC;IAChC,uCAAuC;IACvC,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,uDAAuD;IACvD,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,YAAY,CAAC,EAAE,MAAM,CAAC;CACvB,CAAC;AAEF,MAAM,MAAM,YAAY,GAAG,MAAM,GAAG,QAAQ,GAAG,OAAO,GAAG,QAAQ,GAAG,KAAK,CAAC;AAoD1E;;;;;;;GAOG;AACH,eAAO,MAAM,mBAAmB,SACxB,MAAM,EAAE,UACN,iBAAiB,EAAE,KAC1B,IAAI,MAAM,GAAG,MAAM,EAAE,MAAM,CA6C7B,CAAC;AAEF;;GAEG;AACH,eAAO,MAAM,gBAAgB;IA+FzB,kDAAkD;yBAzFxB,MAAM,SAAS,iBAAiB,KAAG,YAAY;IA2FzE,mDAAmD;+BA5EnB,YAAY,KAAG,OAAO;IA8EtD,4CAA4C;uBAvEpB,MAAM,SAAS,iBAAiB,KAAG,MAAM;IAyEjE,wCAAwC;8BAhDT,MAAM,SAAS,iBAAiB,KAAG,MAAM;IAkDxE,4CAA4C;gCA3JxC,MAAM,EAAE,UACN,iBAAiB,EAAE,KAC1B,IAAI,MAAM,GAAG,MAAM,EAAE,MAAM,CAAC;IA2J3B,yCAAyC;6BA3BX,iBAAiB,KAAG,OAAO;IA6BzD,iCAAiC;8BA7MT,iBAAiB,KAAG,MAAM,GAAG,SAAS;IA+M9D,+BAA+B;4BA5MT,iBAAiB,KAAG,MAAM,GAAG,SAAS;CA+M/D,CAAC;AAEF,MAAM,MAAM,gBAAgB,GAAG,UAAU,CAAC,OAAO,gBAAgB,CAAC,CAAC;AAEnE,eAAe,gBAAgB,CAAC"}

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

@@ -1,14 +1,24 @@
 import { ObjectSchema } from 'yup';
 
+/**
+ * State for an individual form field
+ */
 export interface FormField {
     value: string;
     error: string | null;
     touched: boolean;
     valid: boolean;
 }
+/**
+ * Complete form state object
+ * Keys are field names, values are FormField objects
+ */
 export interface FormState {
     [key: string]: FormField;
 }
+/**
+ * Configuration options for useFormValidation
+ */
 export interface UseFormValidationOptions {
     /**
      * Validation schema (Yup schema object)
@@ -27,6 +37,42 @@ export interface UseFormValidationOptions {
      */
     validateOnBlur?: boolean;
 }
+/**
+ * Form validation composable
+ *
+ * @param options - Configuration options
+ * @returns Form state, computed values, and validation methods
+ *
+ * @example
+ * ```vue
+ * <script setup>
+ * import { useFormValidation } from '@stachelock/ui'
+ * import * as yup from 'yup'
+ *
+ * const schema = yup.object({
+ *   name: yup.string().required('Name is required'),
+ *   email: yup.string().email('Invalid email').required()
+ * })
+ *
+ * const { getFieldProps, handleSubmit, errors, isValid } = useFormValidation({
+ *   schema,
+ *   initialValues: { name: '', email: '' }
+ * })
+ * </script>
+ *
+ * <template>
+ *   <form @submit.prevent="handleSubmit(onSubmit)">
+ *     <input v-bind="getFieldProps('name')" />
+ *     <span v-if="errors.name">{{ errors.name }}</span>
+ *
+ *     <input v-bind="getFieldProps('email')" />
+ *     <span v-if="errors.email">{{ errors.email }}</span>
+ *
+ *     <button :disabled="!isValid">Submit</button>
+ *   </form>
+ * </template>
+ * ```
+ */
 export declare function useFormValidation(options?: UseFormValidationOptions): {
     formState: FormState;
     isSubmitting: import('vue').ComputedRef<boolean>;
@@ -49,4 +95,5 @@ export declare function useFormValidation(options?: UseFormValidationOptions): {
     handleSubmit: (submitHandler: (values: Record<string, string>) => Promise<void> | void) => Promise<void>;
     resetForm: () => void;
 };
+export default useFormValidation;
 //# sourceMappingURL=useFormValidation.d.ts.map

package/dist/src/composables/useFormValidation.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"useFormValidation.d.ts","sourceRoot":"","sources":["../../../src/composables/useFormValidation.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,KAAK,CAAC;AAGxC,MAAM,WAAW,SAAS;IACxB,KAAK,EAAE,MAAM,CAAC;IACd,KAAK,EAAE,MAAM,GAAG,IAAI,CAAC;IACrB,OAAO,EAAE,OAAO,CAAC;IACjB,KAAK,EAAE,OAAO,CAAC;CAChB;AAED,MAAM,WAAW,SAAS;IACxB,CAAC,GAAG,EAAE,MAAM,GAAG,SAAS,CAAC;CAC1B;AAED,MAAM,WAAW,wBAAwB;IACvC;;OAEG;IACH,MAAM,CAAC,EAAE,YAAY,CAAC,GAAG,CAAC,CAAC;IAC3B;;OAEG;IACH,aAAa,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IACvC;;OAEG;IACH,gBAAgB,CAAC,EAAE,OAAO,CAAC;IAC3B;;OAEG;IACH,cAAc,CAAC,EAAE,OAAO,CAAC;CAC1B;AAED,wBAAgB,iBAAiB,CAAC,OAAO,GAAE,wBAA6B;;;;;;;;;0BA+EnC,MAAM,SAAS,MAAM;4BAYnB,MAAM;0BAYd,MAAM;;;2CAML,MAAM;;;0BApFD,MAAM,SAAS,MAAM,KAAG,QAAQ,MAAM,GAAG,IAAI,CAAC;wBAelD,QAAQ,OAAO,CAAC;2CA2EK,OAAO,MAAM,EAAE,MAAM,CAAC,KAAK,QAAQ,IAAI,CAAC,GAAG,IAAI;;EAyFpG"}
+{"version":3,"file":"useFormValidation.d.ts","sourceRoot":"","sources":["../../../src/composables/useFormValidation.ts"],"names":[],"mappings":"AAkCA,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,KAAK,CAAC;AAGxC;;GAEG;AACH,MAAM,WAAW,SAAS;IACxB,KAAK,EAAE,MAAM,CAAC;IACd,KAAK,EAAE,MAAM,GAAG,IAAI,CAAC;IACrB,OAAO,EAAE,OAAO,CAAC;IACjB,KAAK,EAAE,OAAO,CAAC;CAChB;AAED;;;GAGG;AACH,MAAM,WAAW,SAAS;IACxB,CAAC,GAAG,EAAE,MAAM,GAAG,SAAS,CAAC;CAC1B;AAED;;GAEG;AACH,MAAM,WAAW,wBAAwB;IACvC;;OAEG;IACH,MAAM,CAAC,EAAE,YAAY,CAAC,GAAG,CAAC,CAAC;IAC3B;;OAEG;IACH,aAAa,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IACvC;;OAEG;IACH,gBAAgB,CAAC,EAAE,OAAO,CAAC;IAC3B;;OAEG;IACH,cAAc,CAAC,EAAE,OAAO,CAAC;CAC1B;AAED;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAmCG;AACH,wBAAgB,iBAAiB,CAAC,OAAO,GAAE,wBAA6B;;;;;;;;;0BA+EnC,MAAM,SAAS,MAAM;4BAYnB,MAAM;0BAYd,MAAM;;;2CAML,MAAM;;;0BApFD,MAAM,SAAS,MAAM,KAAG,QAAQ,MAAM,GAAG,IAAI,CAAC;wBAelD,QAAQ,OAAO,CAAC;2CA2EK,OAAO,MAAM,EAAE,MAAM,CAAC,KAAK,QAAQ,IAAI,CAAC,GAAG,IAAI;;EAyFpG;AAED,eAAe,iBAAiB,CAAC"}

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

@@ -0,0 +1,93 @@
+import { Ref, ComputedRef } from 'vue';
+import { LatLngLiteral, LatLngBoundsLiteral, MapMarker, MapCluster, MapLoadingState, MapTheme, ClusteringOptions, CoordinateExtractor } from '../types/maps';
+import { MapStyles } from '../utils/mapThemes';
+
+/**
+ * Configuration for useMap composable
+ */
+export interface UseMapOptions {
+    /** Google Maps API key (optional if provided via plugin) */
+    apiKey?: string;
+    /** API version (default: 'weekly') */
+    version?: string;
+    /** Libraries to load */
+    libraries?: ('places' | 'geometry' | 'drawing' | 'visualization' | 'maps' | 'marker')[];
+    /** Initial map theme */
+    theme?: MapTheme;
+    /** Auto-switch theme based on dark mode */
+    autoTheme?: boolean;
+    /** Light mode theme when autoTheme is enabled */
+    lightTheme?: MapTheme;
+    /** Dark mode theme when autoTheme is enabled */
+    darkTheme?: MapTheme;
+    /** Custom styles (overrides theme) */
+    customStyles?: MapStyles;
+    /** Enable marker clustering */
+    clustering?: ClusteringOptions;
+    /** Default center */
+    defaultCenter?: LatLngLiteral;
+    /** Default zoom */
+    defaultZoom?: number;
+}
+/**
+ * Return type for useMap composable
+ */
+export interface UseMapReturn {
+    isApiLoading: Ref<boolean>;
+    isApiReady: Ref<boolean>;
+    apiError: Ref<string | null>;
+    apiPromise: Ref<Promise<typeof google> | null>;
+    loadingState: ComputedRef<MapLoadingState>;
+    currentTheme: Ref<MapTheme>;
+    mapStyles: ComputedRef<MapStyles | undefined>;
+    setTheme: (theme: MapTheme) => void;
+    mapRef: Ref<google.maps.Map | null>;
+    setMap: (map: google.maps.Map) => void;
+    center: Ref<LatLngLiteral>;
+    zoom: Ref<number>;
+    bounds: Ref<LatLngBoundsLiteral | null>;
+    markers: Ref<MapMarker[]>;
+    visibleMarkers: ComputedRef<MapMarker[]>;
+    addMarker: (marker: MapMarker) => void;
+    removeMarker: (id: string | number) => void;
+    updateMarker: (id: string | number, updates: Partial<MapMarker>) => void;
+    clearMarkers: () => void;
+    setMarkers: (newMarkers: MapMarker[]) => void;
+    clusters: Ref<MapCluster[]>;
+    shouldShowClusters: ComputedRef<boolean>;
+    processMarkers: (zoom: number, bounds?: LatLngBoundsLiteral) => void;
+    getClusterColor: (size: number) => string;
+    initializeApi: () => Promise<typeof google>;
+    panTo: (position: LatLngLiteral) => void;
+    setZoom: (level: number) => void;
+    fitBounds: (bounds: LatLngBoundsLiteral, padding?: number) => void;
+    fitToMarkers: (padding?: number) => void;
+    extractCoordinates: <T extends Record<string, unknown>>(data: T) => LatLngLiteral | null;
+    markersFromData: <T extends Record<string, unknown>>(data: T[], extractor?: CoordinateExtractor<T>, idField?: keyof T) => MapMarker<T>[];
+}
+/**
+ * useMap composable for Google Maps integration
+ *
+ * @example
+ * ```vue
+ * <script setup>
+ * import { useMap } from '@stachelock/ui';
+ *
+ * const {
+ *   isApiReady,
+ *   mapStyles,
+ *   markers,
+ *   initializeApi
+ * } = useMap({
+ *   autoTheme: true,
+ *   clustering: { enabled: true }
+ * });
+ *
+ * onMounted(() => initializeApi());
+ * </script>
+ * ```
+ */
+export declare function useMap(options?: UseMapOptions): UseMapReturn;
+export { isValidCoordinate } from '../types/maps';
+export default useMap;
+//# sourceMappingURL=useMap.d.ts.map

package/dist/src/composables/useMap.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"useMap.d.ts","sourceRoot":"","sources":["../../../src/composables/useMap.ts"],"names":[],"mappings":"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"}

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

@@ -1,3 +1,6 @@
+/**
+ * Configuration options for useModal
+ */
 export interface UseModalOptions {
     /**
      * Whether to close modal when clicking outside
@@ -24,13 +27,50 @@ export interface UseModalOptions {
      */
     preventBodyScroll?: boolean;
 }
-export declare function useModal(modelValue?: any, emit?: any, options?: UseModalOptions): {
-    isOpen: import('vue').ComputedRef<any>;
+/**
+ * Modal state management composable
+ *
+ * @param modelValue - Optional v-model value for two-way binding
+ * @param emit - Optional emit function for v-model updates
+ * @param options - Configuration options
+ * @returns Modal state and control methods
+ *
+ * @example
+ * ```vue
+ * <script setup>
+ * import { useModal } from '@stachelock/ui'
+ *
+ * const { isOpen, open, close, modalRef } = useModal(undefined, undefined, {
+ *   closeOnEscape: true,
+ *   trapFocus: true
+ * })
+ * </script>
+ *
+ * <template>
+ *   <button @click="open">Open Modal</button>
+ *
+ *   <div v-if="isOpen" ref="modalRef" role="dialog" aria-modal="true">
+ *     <h2>Modal Content</h2>
+ *     <button @click="close">Close</button>
+ *   </div>
+ * </template>
+ * ```
+ */
+export declare function useModal(modelValue?: boolean, emit?: (event: 'update:modelValue', value: boolean) => void, options?: UseModalOptions): {
+    /** Whether the modal is currently open (computed) */
+    isOpen: import('vue').ComputedRef<boolean>;
+    /** Ref to attach to the modal container element */
     modalRef: import('vue').Ref<HTMLElement | null, HTMLElement | null>;
+    /** Open the modal */
     open: () => void;
+    /** Close the modal */
     close: () => void;
+    /** Toggle modal open/closed state */
     toggle: () => void;
+    /** Cleanup function to remove event listeners (call on unmount) */
     cleanup: () => void;
+    /** Get all focusable elements within the modal */
     getFocusableElements: () => HTMLElement[];
 };
+export default useModal;
 //# sourceMappingURL=useModal.d.ts.map

package/dist/src/composables/useModal.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"useModal.d.ts","sourceRoot":"","sources":["../../../src/composables/useModal.ts"],"names":[],"mappings":"AAGA,MAAM,WAAW,eAAe;IAC9B;;OAEG;IACH,mBAAmB,CAAC,EAAE,OAAO,CAAC;IAC9B;;OAEG;IACH,aAAa,CAAC,EAAE,OAAO,CAAC;IACxB;;OAEG;IACH,SAAS,CAAC,EAAE,OAAO,CAAC;IACpB;;OAEG;IACH,MAAM,CAAC,EAAE,MAAM,IAAI,CAAC;IACpB;;OAEG;IACH,OAAO,CAAC,EAAE,MAAM,IAAI,CAAC;IACrB;;OAEG;IACH,iBAAiB,CAAC,EAAE,OAAO,CAAC;CAC7B;AAED,wBAAgB,QAAQ,CACtB,UAAU,CAAC,EAAE,GAAG,EAChB,IAAI,CAAC,EAAE,GAAG,EACV,OAAO,GAAE,eAAoB;;;;;;;gCAqBI,WAAW,EAAE;EA8J/C"}
+{"version":3,"file":"useModal.d.ts","sourceRoot":"","sources":["../../../src/composables/useModal.ts"],"names":[],"mappings":"AAkCA;;GAEG;AACH,MAAM,WAAW,eAAe;IAC9B;;OAEG;IACH,mBAAmB,CAAC,EAAE,OAAO,CAAC;IAC9B;;OAEG;IACH,aAAa,CAAC,EAAE,OAAO,CAAC;IACxB;;OAEG;IACH,SAAS,CAAC,EAAE,OAAO,CAAC;IACpB;;OAEG;IACH,MAAM,CAAC,EAAE,MAAM,IAAI,CAAC;IACpB;;OAEG;IACH,OAAO,CAAC,EAAE,MAAM,IAAI,CAAC;IACrB;;OAEG;IACH,iBAAiB,CAAC,EAAE,OAAO,CAAC;CAC7B;AAED;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA4BG;AACH,wBAAgB,QAAQ,CACtB,UAAU,CAAC,EAAE,OAAO,EACpB,IAAI,CAAC,EAAE,CAAC,KAAK,EAAE,mBAAmB,EAAE,KAAK,EAAE,OAAO,KAAK,IAAI,EAC3D,OAAO,GAAE,eAAoB;IAwK3B,qDAAqD;;IAErD,mDAAmD;;IAInD,qBAAqB;;IAErB,sBAAsB;;IAEtB,qCAAqC;;IAErC,mEAAmE;;IAInE,kDAAkD;gCAlKnB,WAAW,EAAE;EAqK/C;AAED,eAAe,QAAQ,CAAC"}

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

@@ -0,0 +1,142 @@
+/**
+ * Theme options for notifications
+ */
+export type NotificationTheme = 'primary' | 'secondary' | 'dark' | 'light' | 'success' | 'warning' | 'danger' | 'ghost' | 'info';
+/**
+ * Position options for notifications
+ * - tr: top-right
+ * - tl: top-left
+ * - tc: top-center
+ * - br: bottom-right
+ * - bl: bottom-left
+ * - bc: bottom-center
+ */
+export type NotificationPosition = 'tr' | 'tl' | 'tc' | 'br' | 'bl' | 'bc';
+/**
+ * Parameters for creating a notification
+ */
+export interface NotificationParams {
+    /** Title of the notification */
+    title: string;
+    /** Optional detailed message */
+    message?: string;
+    /** Visual theme */
+    theme?: NotificationTheme;
+    /** Screen position */
+    position?: NotificationPosition;
+    /** Whether to auto-close after timeout */
+    autoClose?: boolean;
+    /** Timeout in milliseconds before auto-close */
+    timeout?: number;
+    /** Optional unique ID (auto-generated if not provided) */
+    id?: string;
+    /** Custom icon component */
+    icon?: any;
+}
+/**
+ * Internal notification state
+ */
+export interface NotificationState extends Required<Omit<NotificationParams, 'icon'>> {
+    /** Whether the notification is currently visible */
+    isOpen: boolean;
+    /** Creation timestamp */
+    createdAt: number;
+    /** Calculated Y offset for stacking */
+    yOffset: number;
+    /** Optional custom icon */
+    icon?: any;
+}
+/**
+ * Notification composable
+ *
+ * @returns Notification methods and reactive state
+ *
+ * @example
+ * ```vue
+ * <script setup>
+ * import { useNotifications } from '@stachelock/ui'
+ *
+ * const { showNotification } = useNotifications()
+ *
+ * const handleSave = async () => {
+ *   try {
+ *     await saveData()
+ *     showNotification({
+ *       title: 'Saved!',
+ *       theme: 'success'
+ *     })
+ *   } catch (error) {
+ *     showNotification({
+ *       title: 'Error',
+ *       message: error.message,
+ *       theme: 'danger'
+ *     })
+ *   }
+ * }
+ * </script>
+ * ```
+ */
+export declare function useNotifications(): {
+    notifications: Readonly<import('vue').Ref<readonly {
+        readonly isOpen: boolean;
+        readonly createdAt: number;
+        readonly yOffset: number;
+        readonly icon?: any;
+        readonly theme: NotificationTheme;
+        readonly title: string;
+        readonly timeout: number;
+        readonly position: NotificationPosition;
+        readonly id: string;
+        readonly message: string;
+        readonly autoClose: boolean;
+    }[], readonly {
+        readonly isOpen: boolean;
+        readonly createdAt: number;
+        readonly yOffset: number;
+        readonly icon?: any;
+        readonly theme: NotificationTheme;
+        readonly title: string;
+        readonly timeout: number;
+        readonly position: NotificationPosition;
+        readonly id: string;
+        readonly message: string;
+        readonly autoClose: boolean;
+    }[]>>;
+    activeNotifications: import('vue').ComputedRef<{
+        isOpen: boolean;
+        createdAt: number;
+        yOffset: number;
+        icon?: any;
+        theme: NotificationTheme;
+        title: string;
+        timeout: number;
+        position: NotificationPosition;
+        id: string;
+        message: string;
+        autoClose: boolean;
+    }[]>;
+    getNotificationsByPosition: (position: NotificationPosition) => import('vue').ComputedRef<{
+        isOpen: boolean;
+        createdAt: number;
+        yOffset: number;
+        icon?: any;
+        theme: NotificationTheme;
+        title: string;
+        timeout: number;
+        position: NotificationPosition;
+        id: string;
+        message: string;
+        autoClose: boolean;
+    }[]>;
+    showNotification: (params: NotificationParams) => string;
+    hideNotification: (target: NotificationState | {
+        id?: string;
+    }) => void;
+    clearAllNotifications: () => void;
+    success: (title: string, message?: string, options?: Partial<NotificationParams>) => string;
+    error: (title: string, message?: string, options?: Partial<NotificationParams>) => string;
+    warning: (title: string, message?: string, options?: Partial<NotificationParams>) => string;
+    info: (title: string, message?: string, options?: Partial<NotificationParams>) => string;
+};
+export default useNotifications;
+//# sourceMappingURL=useNotifications.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"useNotifications.d.ts","sourceRoot":"","sources":["../../../src/composables/useNotifications.ts"],"names":[],"mappings":"AAiCA;;GAEG;AACH,MAAM,MAAM,iBAAiB,GACzB,SAAS,GACT,WAAW,GACX,MAAM,GACN,OAAO,GACP,SAAS,GACT,SAAS,GACT,QAAQ,GACR,OAAO,GACP,MAAM,CAAC;AAEX;;;;;;;;GAQG;AACH,MAAM,MAAM,oBAAoB,GAAG,IAAI,GAAG,IAAI,GAAG,IAAI,GAAG,IAAI,GAAG,IAAI,GAAG,IAAI,CAAC;AAE3E;;GAEG;AACH,MAAM,WAAW,kBAAkB;IACjC,gCAAgC;IAChC,KAAK,EAAE,MAAM,CAAC;IACd,gCAAgC;IAChC,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,mBAAmB;IACnB,KAAK,CAAC,EAAE,iBAAiB,CAAC;IAC1B,sBAAsB;IACtB,QAAQ,CAAC,EAAE,oBAAoB,CAAC;IAChC,0CAA0C;IAC1C,SAAS,CAAC,EAAE,OAAO,CAAC;IACpB,gDAAgD;IAChD,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,0DAA0D;IAC1D,EAAE,CAAC,EAAE,MAAM,CAAC;IACZ,4BAA4B;IAC5B,IAAI,CAAC,EAAE,GAAG,CAAC;CACZ;AAED;;GAEG;AACH,MAAM,WAAW,iBAAkB,SAAQ,QAAQ,CAAC,IAAI,CAAC,kBAAkB,EAAE,MAAM,CAAC,CAAC;IACnF,oDAAoD;IACpD,MAAM,EAAE,OAAO,CAAC;IAChB,yBAAyB;IACzB,SAAS,EAAE,MAAM,CAAC;IAClB,uCAAuC;IACvC,OAAO,EAAE,MAAM,CAAC;IAChB,2BAA2B;IAC3B,IAAI,CAAC,EAAE,GAAG,CAAC;CACZ;AA8BD;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA6BG;AACH,wBAAgB,gBAAgB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;2CAwGgB,oBAAoB;;;;;;;;;;;;;+BAjGhC,kBAAkB,KAAG,MAAM;+BA0C3B,iBAAiB,GAAG;QAAE,EAAE,CAAC,EAAE,MAAM,CAAA;KAAE,KAAG,IAAI;iCA6B1C,IAAI;qBAgCd,MAAM,YAAY,MAAM,YAAY,QAAQ,kBAAkB,CAAC;mBAGjE,MAAM,YAAY,MAAM,YAAY,QAAQ,kBAAkB,CAAC;qBAG7D,MAAM,YAAY,MAAM,YAAY,QAAQ,kBAAkB,CAAC;kBAGlE,MAAM,YAAY,MAAM,YAAY,QAAQ,kBAAkB,CAAC;EAoBrF;AAED,eAAe,gBAAgB,CAAC"}