@mapvx/web-js 1.0.0

package/dist/es/domain/models/fitOptions.d.ts

@@ -0,0 +1,175 @@
+import { type PointLike } from "maplibre-gl";
+import { type CameraAnimation, type MapCamera } from "./mapCamera";
+/**
+ * Options interface to select when making a fitBounds call on a map
+ * Combines camera configuration with animation options for smooth transitions
+ * @group Map
+ */
+export type FitOptions = MapCamera & CameraAnimation & {
+    /**
+     * Value in which the center of the fit will be moved
+     * Allows adjusting the center point of the fitted bounds
+     */
+    offset?: PointLike;
+    /**
+     * Set padding (in pixels) to be added at the edges of the canvas
+     * Provides space around the fitted bounds to prevent elements from being cut off
+     */
+    padding?: PaddingOptions;
+    /**
+     * Max zoom allowed when trying to make a fitBounds call
+     * Prevents the map from zooming in too far when fitting bounds
+     */
+    maxZoom?: number;
+    /**
+     * Callback function executed when the fit animation completes
+     * Called after the camera has finished moving to the new position
+     *
+     * @example
+     * ```typescript
+     * map.fitCoordinates(coords, {
+     *   onComplete: () => {
+     *     console.log('Fit animation completed');
+     *   }
+     * });
+     * ```
+     */
+    onComplete?: () => void;
+};
+/**
+ * Represents a padding value that can be:
+ * - A number (interpreted as pixels)
+ * - A string with a unit: "10%", "5vh", "5vw", "100px"
+ *
+ * Supported units:
+ * - `px` - Pixels (default if number)
+ * - `%` - Percentage of the map container dimension (width for left/right, height for top/bottom)
+ * - `vh` - Percentage of viewport height
+ * - `vw` - Percentage of viewport width
+ *
+ * @example
+ * ```typescript
+ * // All equivalent to 50 pixels
+ * padding: { top: 50 }
+ * padding: { top: "50px" }
+ *
+ * // Percentage of container
+ * padding: { left: "30%" }  // 30% of container width
+ * padding: { top: "20%" }   // 20% of container height
+ *
+ * // Viewport units
+ * padding: { top: "10vh" }  // 10% of viewport height
+ * padding: { left: "15vw" } // 15% of viewport width
+ * ```
+ *
+ * @group Map
+ */
+export type PaddingValue = number | string;
+/**
+ * Interface defining padding options for fitBounds operations.
+ * All fields are optional - only specify the edges you need padding for.
+ * Unspecified edges default to 0.
+ *
+ * @example
+ * ```typescript
+ * // Only pad left and top (for a modal in the top-left corner)
+ * map.fitCoordinates(coords, {
+ *   padding: {
+ *     left: "30%",   // 30% of container width
+ *     top: "40%"     // 40% of container height
+ *   }
+ * });
+ *
+ * // Mixed units
+ * map.fitCoordinates(coords, {
+ *   padding: {
+ *     top: 100,      // 100 pixels
+ *     left: "25%",   // 25% of container width
+ *     bottom: "5vh"  // 5% of viewport height
+ *   }
+ * });
+ * ```
+ *
+ * @group Map
+ */
+export interface PaddingOptions {
+    /**
+     * Padding for the bottom edge of the viewport.
+     * Can be a number (pixels) or string with unit (%, vh, vw, px).
+     */
+    bottom?: PaddingValue;
+    /**
+     * Padding for the left edge of the viewport.
+     * Can be a number (pixels) or string with unit (%, vh, vw, px).
+     */
+    left?: PaddingValue;
+    /**
+     * Padding for the right edge of the viewport.
+     * Can be a number (pixels) or string with unit (%, vh, vw, px).
+     */
+    right?: PaddingValue;
+    /**
+     * Padding for the top edge of the viewport.
+     * Can be a number (pixels) or string with unit (%, vh, vw, px).
+     */
+    top?: PaddingValue;
+}
+/**
+ * Options for floor update operations
+ * @group Map
+ */
+export interface FloorUpdateOptions {
+    /**
+     * Callback function executed when the floor update completes
+     * Called after all floor filters and markers have been updated
+     *
+     * @example
+     * ```typescript
+     * map.updateFloor('floor-1', {
+     *   onComplete: () => {
+     *     console.log('Floor update completed');
+     *   }
+     * });
+     * ```
+     */
+    onComplete?: () => void;
+}
+/**
+ * Options for zoom level operations
+ * @group Map
+ */
+export interface ZoomOptions {
+    /**
+     * Callback function executed when the zoom change completes
+     *
+     * @example
+     * ```typescript
+     * map.setMinZoom(10, {
+     *   onComplete: () => {
+     *     console.log('Min zoom set');
+     *   }
+     * });
+     * ```
+     */
+    onComplete?: () => void;
+}
+/**
+ * Options for bounds operations
+ * @group Map
+ */
+export interface BoundsOptions {
+    /**
+     * Callback function executed when the bounds change completes
+     *
+     * @example
+     * ```typescript
+     * map.setMaxBounds(coordinates, {
+     *   onComplete: () => {
+     *     console.log('Bounds set');
+     *   }
+     * });
+     * ```
+     */
+    onComplete?: () => void;
+}
+//# sourceMappingURL=fitOptions.d.ts.map

package/dist/es/domain/models/fitOptions.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"fitOptions.d.ts","sourceRoot":"","sources":["../../../../src/domain/models/fitOptions.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,KAAK,SAAS,EAAE,MAAM,aAAa,CAAA;AAC5C,OAAO,EAAE,KAAK,eAAe,EAAE,KAAK,SAAS,EAAE,MAAM,aAAa,CAAA;AAElE;;;;GAIG;AACH,MAAM,MAAM,UAAU,GAAG,SAAS,GAChC,eAAe,GAAG;IAChB;;;OAGG;IACH,MAAM,CAAC,EAAE,SAAS,CAAA;IAElB;;;OAGG;IACH,OAAO,CAAC,EAAE,cAAc,CAAA;IAExB;;;OAGG;IACH,OAAO,CAAC,EAAE,MAAM,CAAA;IAEhB;;;;;;;;;;;;OAYG;IACH,UAAU,CAAC,EAAE,MAAM,IAAI,CAAA;CACxB,CAAA;AAEH;;;;;;;;;;;;;;;;;;;;;;;;;;;GA2BG;AACH,MAAM,MAAM,YAAY,GAAG,MAAM,GAAG,MAAM,CAAA;AAE1C;;;;;;;;;;;;;;;;;;;;;;;;;;GA0BG;AACH,MAAM,WAAW,cAAc;IAC7B;;;OAGG;IACH,MAAM,CAAC,EAAE,YAAY,CAAA;IAErB;;;OAGG;IACH,IAAI,CAAC,EAAE,YAAY,CAAA;IAEnB;;;OAGG;IACH,KAAK,CAAC,EAAE,YAAY,CAAA;IAEpB;;;OAGG;IACH,GAAG,CAAC,EAAE,YAAY,CAAA;CACnB;AAED;;;GAGG;AACH,MAAM,WAAW,kBAAkB;IACjC;;;;;;;;;;;;OAYG;IACH,UAAU,CAAC,EAAE,MAAM,IAAI,CAAA;CACxB;AAED;;;GAGG;AACH,MAAM,WAAW,WAAW;IAC1B;;;;;;;;;;;OAWG;IACH,UAAU,CAAC,EAAE,MAAM,IAAI,CAAA;CACxB;AAED;;;GAGG;AACH,MAAM,WAAW,aAAa;IAC5B;;;;;;;;;;;OAWG;IACH,UAAU,CAAC,EAAE,MAAM,IAAI,CAAA;CACxB"}

package/dist/es/domain/models/fitOptions.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=fitOptions.js.map

package/dist/es/domain/models/fitOptions.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"fitOptions.js","sourceRoot":"","sources":["../../../../src/domain/models/fitOptions.ts"],"names":[],"mappings":""}

package/dist/es/domain/models/innerFloors.d.ts

@@ -0,0 +1,42 @@
+/**
+ * Model parameters of each floor for locations
+ * Represents the configuration and properties of individual floors within a building
+ * @group Places & Locations
+ */
+export interface InnerFloor {
+    /**
+     * Unique identifier for the floor
+     */
+    key: string;
+    /**
+     * Numerical index representing the floor's position in the building
+     * Lower numbers typically represent lower floors
+     */
+    index: number;
+    /**
+     * Floor level number (can be negative for basement floors)
+     */
+    level: number;
+    /**
+     * Full name of the floor (e.g., "Ground Floor", "First Floor")
+     */
+    name: string;
+    /**
+     * Abbreviated name of the floor (e.g., "G", "1F", "B1")
+     */
+    shortName?: string;
+    /**
+     * Indicates if this is the default floor to display when entering the building
+     */
+    defaultFloor: boolean;
+    /**
+     * Reference to the base floor identifier (used for relative positioning)
+     */
+    baseFloor?: string;
+    /**
+     * Indicates if this floor can be reached using GPS positioning
+     * Useful for outdoor areas or floors with GPS accessibility
+     */
+    reachableFromGPS?: boolean;
+}
+//# sourceMappingURL=innerFloors.d.ts.map

package/dist/es/domain/models/innerFloors.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"innerFloors.d.ts","sourceRoot":"","sources":["../../../../src/domain/models/innerFloors.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AACH,MAAM,WAAW,UAAU;IACzB;;OAEG;IACH,GAAG,EAAE,MAAM,CAAA;IAEX;;;OAGG;IACH,KAAK,EAAE,MAAM,CAAA;IAEb;;OAEG;IACH,KAAK,EAAE,MAAM,CAAA;IAEb;;OAEG;IACH,IAAI,EAAE,MAAM,CAAA;IAEZ;;OAEG;IACH,SAAS,CAAC,EAAE,MAAM,CAAA;IAElB;;OAEG;IACH,YAAY,EAAE,OAAO,CAAA;IAErB;;OAEG;IACH,SAAS,CAAC,EAAE,MAAM,CAAA;IAElB;;;OAGG;IACH,gBAAgB,CAAC,EAAE,OAAO,CAAA;CAC3B"}

package/dist/es/domain/models/innerFloors.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=innerFloors.js.map

package/dist/es/domain/models/innerFloors.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"innerFloors.js","sourceRoot":"","sources":["../../../../src/domain/models/innerFloors.ts"],"names":[],"mappings":""}

package/dist/es/domain/models/institution.d.ts

@@ -0,0 +1,64 @@
+import { type InstitutionResponse } from "../../interfaces/institutionResponse";
+import { type Property } from "./property";
+/**
+ * MapVX Institution object, is a custom object containing data of conglomerate of places (enterprise or subdivision).
+ * Represents a collection of related places that form a larger organizational unit.
+ *
+ * @example
+ * ```typescript
+ * const institution = new Institution(institutionResponse);
+ * console.log(institution.title); // "Shopping Mall"
+ * console.log(institution.hasPlaces); // true
+ * ```
+ *
+ * @group Places & Locations
+ */
+export declare class Institution {
+    /**
+     * Unique identifier for the institution in MapVX system
+     */
+    mapvxId: string;
+    /**
+     * Title or name of the institution
+     */
+    title: string;
+    /**
+     * Detailed description of the institution (optional)
+     */
+    description?: string;
+    /**
+     * Country where the institution is located
+     */
+    country: string;
+    /**
+     * Category or type of the institution
+     */
+    category: string;
+    /**
+     * Flag indicating if the institution contains places
+     */
+    hasPlaces: boolean;
+    /**
+     * List of properties associated with the institution
+     * @see {@link Property} for property structure
+     */
+    properties?: Property[];
+    /**
+     * URL of the institution's icon or logo
+     */
+    icon?: string;
+    /**
+     * Creates a new instance of an Institution object with the rawInstitution arguments.
+     *
+     * @param rawInstitution - JSON configuration parameters for the institution from API response
+     * @returns A new instance of Institution
+     *
+     * @example
+     * ```typescript
+     * const institutionResponse = await fetchInstitutionData(institutionId);
+     * const institution = new Institution(institutionResponse);
+     * ```
+     */
+    constructor(rawInstitution: InstitutionResponse);
+}
+//# sourceMappingURL=institution.d.ts.map

package/dist/es/domain/models/institution.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"institution.d.ts","sourceRoot":"","sources":["../../../../src/domain/models/institution.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,KAAK,mBAAmB,EAAE,MAAM,sCAAsC,CAAA;AAC/E,OAAO,EAAiB,KAAK,QAAQ,EAAE,MAAM,YAAY,CAAA;AAEzD;;;;;;;;;;;;GAYG;AACH,qBAAa,WAAW;IACtB;;OAEG;IACI,OAAO,EAAE,MAAM,CAAA;IAEtB;;OAEG;IACI,KAAK,EAAE,MAAM,CAAA;IAEpB;;OAEG;IACI,WAAW,CAAC,EAAE,MAAM,CAAA;IAE3B;;OAEG;IACI,OAAO,EAAE,MAAM,CAAA;IAEtB;;OAEG;IACI,QAAQ,EAAE,MAAM,CAAA;IAEvB;;OAEG;IACI,SAAS,EAAE,OAAO,CAAA;IAEzB;;;OAGG;IACI,UAAU,CAAC,EAAE,QAAQ,EAAE,CAAA;IAE9B;;OAEG;IACH,IAAI,CAAC,EAAE,MAAM,CAAA;IAEb;;;;;;;;;;;OAWG;gBACS,cAAc,EAAE,mBAAmB;CAUhD"}

package/dist/es/domain/models/institution.js

@@ -0,0 +1,40 @@
+import { PropertyUtils } from "./property";
+/**
+ * MapVX Institution object, is a custom object containing data of conglomerate of places (enterprise or subdivision).
+ * Represents a collection of related places that form a larger organizational unit.
+ *
+ * @example
+ * ```typescript
+ * const institution = new Institution(institutionResponse);
+ * console.log(institution.title); // "Shopping Mall"
+ * console.log(institution.hasPlaces); // true
+ * ```
+ *
+ * @group Places & Locations
+ */
+export class Institution {
+    /**
+     * Creates a new instance of an Institution object with the rawInstitution arguments.
+     *
+     * @param rawInstitution - JSON configuration parameters for the institution from API response
+     * @returns A new instance of Institution
+     *
+     * @example
+     * ```typescript
+     * const institutionResponse = await fetchInstitutionData(institutionId);
+     * const institution = new Institution(institutionResponse);
+     * ```
+     */
+    constructor(rawInstitution) {
+        var _a;
+        this.mapvxId = rawInstitution.id;
+        this.country = rawInstitution.country;
+        this.title = rawInstitution.title;
+        this.category = rawInstitution.category;
+        this.icon = rawInstitution.icon;
+        this.description = rawInstitution.description;
+        this.hasPlaces = rawInstitution.hasPlaces;
+        this.properties = PropertyUtils.parseProperties((_a = rawInstitution.properties) !== null && _a !== void 0 ? _a : []);
+    }
+}
+//# sourceMappingURL=institution.js.map

package/dist/es/domain/models/institution.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"institution.js","sourceRoot":"","sources":["../../../../src/domain/models/institution.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,aAAa,EAAiB,MAAM,YAAY,CAAA;AAEzD;;;;;;;;;;;;GAYG;AACH,MAAM,OAAO,WAAW;IA0CtB;;;;;;;;;;;OAWG;IACH,YAAY,cAAmC;;QAC7C,IAAI,CAAC,OAAO,GAAG,cAAc,CAAC,EAAE,CAAA;QAChC,IAAI,CAAC,OAAO,GAAG,cAAc,CAAC,OAAO,CAAA;QACrC,IAAI,CAAC,KAAK,GAAG,cAAc,CAAC,KAAK,CAAA;QACjC,IAAI,CAAC,QAAQ,GAAG,cAAc,CAAC,QAAQ,CAAA;QACvC,IAAI,CAAC,IAAI,GAAG,cAAc,CAAC,IAAI,CAAA;QAC/B,IAAI,CAAC,WAAW,GAAG,cAAc,CAAC,WAAW,CAAA;QAC7C,IAAI,CAAC,SAAS,GAAG,cAAc,CAAC,SAAS,CAAA;QACzC,IAAI,CAAC,UAAU,GAAG,aAAa,CAAC,eAAe,CAAC,MAAA,cAAc,CAAC,UAAU,mCAAI,EAAE,CAAC,CAAA;IAClF,CAAC;CACF"}

package/dist/es/domain/models/latLng.d.ts

@@ -0,0 +1,14 @@
+/**
+ * basic latitude and longitude model
+ * @group Places & Locations
+ */
+export interface LatLng {
+    lat: number;
+    lng: number;
+}
+/**
+ * Represents the callback function for the position.
+ * @group Utils
+ */
+export type PositionCallback = (latLng: GeolocationPosition) => void;
+//# sourceMappingURL=latLng.d.ts.map

package/dist/es/domain/models/latLng.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"latLng.d.ts","sourceRoot":"","sources":["../../../../src/domain/models/latLng.ts"],"names":[],"mappings":"AAAA;;;GAGG;AACH,MAAM,WAAW,MAAM;IACrB,GAAG,EAAE,MAAM,CAAA;IACX,GAAG,EAAE,MAAM,CAAA;CACZ;AAED;;;GAGG;AACH,MAAM,MAAM,gBAAgB,GAAG,CAAC,MAAM,EAAE,mBAAmB,KAAK,IAAI,CAAA"}

package/dist/es/domain/models/latLng.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=latLng.js.map

package/dist/es/domain/models/latLng.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"latLng.js","sourceRoot":"","sources":["../../../../src/domain/models/latLng.ts"],"names":[],"mappings":""}

package/dist/es/domain/models/location.d.ts

@@ -0,0 +1,10 @@
+import { type LatLng } from "./latLng";
+/**
+ * Represents a location on the map.
+ * @group Places & Locations
+ */
+export interface MVXLocation extends LatLng {
+    floorId?: string;
+    placeId?: string;
+}
+//# sourceMappingURL=location.d.ts.map

package/dist/es/domain/models/location.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"location.d.ts","sourceRoot":"","sources":["../../../../src/domain/models/location.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,KAAK,MAAM,EAAE,MAAM,UAAU,CAAA;AAEtC;;;GAGG;AACH,MAAM,WAAW,WAAY,SAAQ,MAAM;IACzC,OAAO,CAAC,EAAE,MAAM,CAAA;IAChB,OAAO,CAAC,EAAE,MAAM,CAAA;CACjB"}

package/dist/es/domain/models/location.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=location.js.map

package/dist/es/domain/models/location.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"location.js","sourceRoot":"","sources":["../../../../src/domain/models/location.ts"],"names":[],"mappings":""}

package/dist/es/domain/models/loggeable.d.ts

@@ -0,0 +1,43 @@
+import { type LogArgument } from "rollbar";
+/**
+ * Represents the abstract class for the loggeable.
+ * @hidden
+ */
+export declare abstract class Loggeable {
+    /**
+     * The object to log the events and errors.
+     */
+    private readonly logger;
+    constructor();
+    /**
+     * Add values to identify the client.
+     * @param segmentation The pair values to use as segmentation.
+     * @returns The segmentation with the added values.
+     */
+    protected abstract prepareSegmentation(segmentation: Record<string, string>): Record<string, string>;
+    /**
+     * To log a event in this class.
+     * @param eventName The event name.
+     * @param eventSegmentation The pair key, value to segment this event count.
+     */
+    protected logEvent(eventName: string, eventSegmentation?: Record<string, string>): void;
+    /**
+     * To log a captured error in this class.
+     * @param error The captured error
+     * @param args The rest of the arguments.
+     */
+    protected logError(error: unknown, ...args: LogArgument[]): void;
+    /**
+     * To log a captured error as a warning.
+     * @param error The captured error
+     * @param args The rest of the arguments.
+     */
+    protected logWarning(error: unknown, ...args: LogArgument[]): void;
+    protected logDebug(...args: LogArgument[]): void;
+    /**
+     * Prints in console any number of given arguments, if and only if, app is running in debug mode.
+     * @param args An array of arguments to log
+     */
+    protected debugLog(...args: unknown[]): void;
+}
+//# sourceMappingURL=loggeable.d.ts.map

package/dist/es/domain/models/loggeable.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"loggeable.d.ts","sourceRoot":"","sources":["../../../../src/domain/models/loggeable.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,KAAK,WAAW,EAAE,MAAM,SAAS,CAAA;AAI1C;;;GAGG;AACH,8BAAsB,SAAS;IAC7B;;OAEG;IACH,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAQ;;IAM/B;;;;OAIG;IACH,SAAS,CAAC,QAAQ,CAAC,mBAAmB,CACpC,YAAY,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,GACnC,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC;IAEzB;;;;OAIG;IACH,SAAS,CAAC,QAAQ,CAAC,SAAS,EAAE,MAAM,EAAE,iBAAiB,GAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAM,GAAG,IAAI;IAI3F;;;;OAIG;IACH,SAAS,CAAC,QAAQ,CAAC,KAAK,EAAE,OAAO,EAAE,GAAG,IAAI,EAAE,WAAW,EAAE,GAAG,IAAI;IAKhE;;;;OAIG;IACH,SAAS,CAAC,UAAU,CAAC,KAAK,EAAE,OAAO,EAAE,GAAG,IAAI,EAAE,WAAW,EAAE,GAAG,IAAI;IAKlE,SAAS,CAAC,QAAQ,CAAC,GAAG,IAAI,EAAE,WAAW,EAAE,GAAG,IAAI;IAIhD;;;OAGG;IACH,SAAS,CAAC,QAAQ,CAAC,GAAG,IAAI,EAAE,OAAO,EAAE;CAGtC"}

package/dist/es/domain/models/loggeable.js

@@ -0,0 +1,48 @@
+import { Logger } from "../../logger/logger";
+import { convertToError } from "../../utils/error";
+/**
+ * Represents the abstract class for the loggeable.
+ * @hidden
+ */
+export class Loggeable {
+    constructor() {
+        this.logger = Logger.getInstance();
+    }
+    /**
+     * To log a event in this class.
+     * @param eventName The event name.
+     * @param eventSegmentation The pair key, value to segment this event count.
+     */
+    logEvent(eventName, eventSegmentation = {}) {
+        this.logger.logEvent(eventName, this.prepareSegmentation(eventSegmentation));
+    }
+    /**
+     * To log a captured error in this class.
+     * @param error The captured error
+     * @param args The rest of the arguments.
+     */
+    logError(error, ...args) {
+        const errorTyped = convertToError(error);
+        this.logger.logError(errorTyped, ...args);
+    }
+    /**
+     * To log a captured error as a warning.
+     * @param error The captured error
+     * @param args The rest of the arguments.
+     */
+    logWarning(error, ...args) {
+        const errorTyped = convertToError(error);
+        this.logger.logWarning(errorTyped, ...args);
+    }
+    logDebug(...args) {
+        this.logger.logDebug(...args);
+    }
+    /**
+     * Prints in console any number of given arguments, if and only if, app is running in debug mode.
+     * @param args An array of arguments to log
+     */
+    debugLog(...args) {
+        this.logger.debugLog(args);
+    }
+}
+//# sourceMappingURL=loggeable.js.map

package/dist/es/domain/models/loggeable.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"loggeable.js","sourceRoot":"","sources":["../../../../src/domain/models/loggeable.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,MAAM,EAAE,MAAM,qBAAqB,CAAA;AAC5C,OAAO,EAAE,cAAc,EAAE,MAAM,mBAAmB,CAAA;AAElD;;;GAGG;AACH,MAAM,OAAgB,SAAS;IAM7B;QACE,IAAI,CAAC,MAAM,GAAG,MAAM,CAAC,WAAW,EAAE,CAAA;IACpC,CAAC;IAWD;;;;OAIG;IACO,QAAQ,CAAC,SAAiB,EAAE,oBAA4C,EAAE;QAClF,IAAI,CAAC,MAAM,CAAC,QAAQ,CAAC,SAAS,EAAE,IAAI,CAAC,mBAAmB,CAAC,iBAAiB,CAAC,CAAC,CAAA;IAC9E,CAAC;IAED;;;;OAIG;IACO,QAAQ,CAAC,KAAc,EAAE,GAAG,IAAmB;QACvD,MAAM,UAAU,GAAG,cAAc,CAAC,KAAK,CAAC,CAAA;QACxC,IAAI,CAAC,MAAM,CAAC,QAAQ,CAAC,UAAU,EAAE,GAAG,IAAI,CAAC,CAAA;IAC3C,CAAC;IAED;;;;OAIG;IACO,UAAU,CAAC,KAAc,EAAE,GAAG,IAAmB;QACzD,MAAM,UAAU,GAAG,cAAc,CAAC,KAAK,CAAC,CAAA;QACxC,IAAI,CAAC,MAAM,CAAC,UAAU,CAAC,UAAU,EAAE,GAAG,IAAI,CAAC,CAAA;IAC7C,CAAC;IAES,QAAQ,CAAC,GAAG,IAAmB;QACvC,IAAI,CAAC,MAAM,CAAC,QAAQ,CAAC,GAAG,IAAI,CAAC,CAAA;IAC/B,CAAC;IAED;;;OAGG;IACO,QAAQ,CAAC,GAAG,IAAe;QACnC,IAAI,CAAC,MAAM,CAAC,QAAQ,CAAC,IAAI,CAAC,CAAA;IAC5B,CAAC;CACF"}

package/dist/es/domain/models/mapCamera.d.ts

@@ -0,0 +1,109 @@
+import { type LatLng } from "./latLng";
+/**
+ * Model of configuration parameters for the change in map camera.
+ * Defines the target camera position and orientation for map transitions.
+ *
+ * @example
+ * ```typescript
+ * const cameraConfig: MapCamera = {
+ *   center: { lat: 40.7128, lng: -74.0060 },
+ *   zoom: 15,
+ *   bearing: 45,
+ *   pitch: 30
+ * };
+ * ```
+ *
+ * @group Map
+ */
+export interface MapCamera {
+    /**
+     * The desired center coordinates for the map view.
+     * @see {@link LatLng} for coordinate structure
+     *
+     * @example
+     * ```typescript
+     * center: { lat: 40.7128, lng: -74.0060 } // New York
+     * ```
+     */
+    center?: LatLng;
+    /**
+     * The desired zoom level for the map view.
+     * Higher values indicate more zoomed in view.
+     *
+     * @example
+     * ```typescript
+     * zoom: 15 // City level
+     * zoom: 10 // Country level
+     * ```
+     */
+    zoom?: number;
+    /**
+     * The desired bearing in degrees. The bearing is the compass direction that is "up".
+     * 0 degrees points north, 90 degrees points east, 180 degrees points south, 270 degrees points west.
+     *
+     * @example
+     * ```typescript
+     * bearing: 90  // East is up
+     * bearing: 180 // South is up
+     * bearing: 45  // Northeast is up
+     * ```
+     */
+    bearing?: number;
+    /**
+     * The desired pitch in degrees. The pitch is the angle of tilt from the plane of the map.
+     * Possible values range from 0 to 85 degrees.
+     * 0 degrees is flat (2D view), higher values create a 3D perspective.
+     *
+     * @example
+     * ```typescript
+     * pitch: 0   // Flat 2D view
+     * pitch: 30  // Slight 3D tilt
+     * pitch: 60  // Steep 3D perspective
+     * ```
+     */
+    pitch?: number;
+}
+/**
+ * The options to animate the update of the map camera.
+ * Controls how smoothly the camera transitions to its new position.
+ *
+ * @example
+ * ```typescript
+ * const animationOptions: CameraAnimation = {
+ *   animate: true,
+ *   duration: 2000 // 2 seconds
+ * };
+ * ```
+ *
+ * @group Map
+ */
+export interface CameraAnimation {
+    /**
+     * If false, no animation will occur and the camera will jump instantly to the new position.
+     * If omitted, defaults to `true`.
+     *
+     * @defaultValue `true`
+     *
+     * @example
+     * ```typescript
+     * animate: true  // Smooth transition
+     * animate: false // Instant jump
+     * ```
+     */
+    animate?: boolean;
+    /**
+     * The animation's duration, measured in milliseconds.
+     * Higher values create slower, more gradual transitions.
+     *
+     * @defaultValue `1000`
+     *
+     * @example
+     * ```typescript
+     * duration: 500  // Fast transition (0.5 seconds)
+     * duration: 2000 // Slow transition (2 seconds)
+     * duration: 1000 // Default transition (1 second)
+     * ```
+     */
+    duration?: number;
+}
+//# sourceMappingURL=mapCamera.d.ts.map

package/dist/es/domain/models/mapCamera.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"mapCamera.d.ts","sourceRoot":"","sources":["../../../../src/domain/models/mapCamera.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,KAAK,MAAM,EAAE,MAAM,UAAU,CAAA;AAEtC;;;;;;;;;;;;;;;GAeG;AACH,MAAM,WAAW,SAAS;IACxB;;;;;;;;OAQG;IACH,MAAM,CAAC,EAAE,MAAM,CAAA;IAEf;;;;;;;;;OASG;IACH,IAAI,CAAC,EAAE,MAAM,CAAA;IAEb;;;;;;;;;;OAUG;IACH,OAAO,CAAC,EAAE,MAAM,CAAA;IAEhB;;;;;;;;;;;OAWG;IACH,KAAK,CAAC,EAAE,MAAM,CAAA;CACf;AAED;;;;;;;;;;;;;GAaG;AACH,MAAM,WAAW,eAAe;IAC9B;;;;;;;;;;;OAWG;IACH,OAAO,CAAC,EAAE,OAAO,CAAA;IAEjB;;;;;;;;;;;;OAYG;IACH,QAAQ,CAAC,EAAE,MAAM,CAAA;CAClB"}

package/dist/es/domain/models/mapCamera.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=mapCamera.js.map

package/dist/es/domain/models/mapCamera.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"mapCamera.js","sourceRoot":"","sources":["../../../../src/domain/models/mapCamera.ts"],"names":[],"mappings":""}