@mappedin/mappedin-js 6.0.1-beta.6 → 6.0.1-beta.7

package/lib/esm/index.d.ts

@@ -15,6 +15,7 @@
 //   ../mappedin-js/@packages/internal/quad-tree
 //   ../mappedin-js/@packages/internal/outdoor-context-v4
 //   ../mappedin-js/@packages/internal/geojson-navigator
+//   ../mappedin-js/minisearch
 //   ../mappedin-js/three/addons/loaders/GLTFLoader.js
 //   ../mappedin-js/@mapbox/point-geometry
 //   ../mappedin-js/@maplibre/maplibre-gl-style-spec
@@ -310,17 +311,20 @@ declare module '@mappedin/mappedin-js' {
     export type { Label, Marker, Path, Shape, CameraTransform, Model } from '@mappedin/mappedin-js/mappedin-js/src/map-view-objects';
     export type { Navigation, TNavigationOptions } from '@mappedin/mappedin-js/mappedin-js/src/navigation';
     export type { TSpaceType } from '@mappedin/mappedin-js/mappedin-js/src/map-data-objects';
-    export { Coordinate, Annotation, Connection, Door, Floor, MapObject, PointOfInterest, Space, Image, Hyperlink, Location, Category, Venue, } from '@mappedin/mappedin-js/mappedin-js/src/map-data-objects';
+    export { Coordinate, Annotation, Connection, Door, Floor, MapObject, PointOfInterest, Space, Image, Hyperlink, EnterpriseLocation, EnterpriseCategory, EnterpriseVenue, type Places, } from '@mappedin/mappedin-js/mappedin-js/src/map-data-objects';
     export type { Camera, Models, Labels, Markers, Paths, Exporter, Directions, Style, Shapes, Outdoor, } from '@mappedin/mappedin-js/mappedin-js/src/api-geojson';
+    export type { SearchResult, SearchResultItem, SearchResultEnterpriseCategory, SearchResultEnterpriseLocations, SearchResultPlaces, SearchOptions, Search, Suggestion, MatchInfo, } from '@mappedin/mappedin-js/mappedin-js/src/search';
 }
 
 declare module '@mappedin/mappedin-js/mappedin-js/src/map-data' {
-    import { PubSub } from '@packages/internal/common';
     import { Analytics } from '@mappedin/mappedin-js/mappedin-js/src/analytics';
+    import { PubSub } from '@packages/internal/common';
+    import type { TSearchOptions } from '@packages/internal/mvf-utils';
     import type { Connection, Door, Floor, MapDataInternal, Space, MapObject, PointOfInterest, Annotation, Coordinate } from '@mappedin/mappedin-js/mappedin-js/src/map-data-objects';
-    import type Category from '@mappedin/mappedin-js/mappedin-js/src/map-data-objects/category';
-    import type Location from '@mappedin/mappedin-js/mappedin-js/src/map-data-objects/location';
-    import type Venue from '@mappedin/mappedin-js/mappedin-js/src/map-data-objects/venue';
+    import type EnterpriseCategory from '@mappedin/mappedin-js/mappedin-js/src/map-data-objects/category';
+    import type EnterpriseLocation from '@mappedin/mappedin-js/mappedin-js/src/map-data-objects/location';
+    import type EnterpriseVenue from '@mappedin/mappedin-js/mappedin-js/src/map-data-objects/venue';
+    import { Search } from '@mappedin/mappedin-js/mappedin-js/src/search';
     /**
         * A WeakMap to associate {@link MapData} instances with their internal representation.
         * We need a way to get the internal data object from the API
@@ -340,12 +344,32 @@ declare module '@mappedin/mappedin-js/mappedin-js/src/map-data' {
     }> {
             #private;
             Analytics: Analytics;
+            /**
+                * Search API for MapData
+                *
+                * @example
+                * // Enable search
+                * const mapData = await getMapData({ search: { enabled: true } });
+                * // or
+                * await mapData.Search.enable();
+                *
+                * // Perform a search query
+                * const results = await mapData.Search.query('Coffee Shop');
+                * console.log(results.locations);
+                *
+                * // Get search suggestions
+                * const suggestions = await mapData.Search.suggest('Coff');
+                * console.log(suggestions);
+                */
+            Search: Search;
             /**
                 * Constructs a new instance of {@link MapData}.
                 *
                 * @internal
                 */
-            constructor(internal: MapDataInternal);
+            constructor(internal: MapDataInternal, { search }?: {
+                    search?: TSearchOptions;
+            });
             /**
                 * The name of the map.
                 *
@@ -364,10 +388,6 @@ declare module '@mappedin/mappedin-js/mappedin-js/src/map-data' {
                 * @returns {string} The organization ID of the map.
                 */
             get organizationId(): string;
-            /**
-                * @internal
-                */
-            get venue(): Venue | undefined;
             /**
                 * The token is used to fetch outdoor tiles.
                 *
@@ -426,13 +446,23 @@ declare module '@mappedin/mappedin-js/mappedin-js/src/map-data' {
                 */
             getByType(type: 'annotation'): Annotation[];
             /**
-                * @internal
+                * @returns The enterprise locations ({@link EnterpriseLocation}) on the map.
+                * @example
+                * const enterpriseLocations = mapData.getByType('enterprise-location');
                 */
-            getByType(type: 'location'): Location[];
+            getByType(type: 'enterprise-location'): EnterpriseLocation[];
             /**
-                * @internal
+                * @returns The enterprise categories ({@link EnterpriseCategory}) on the map.
+                * @example
+                * const enterpriseCategories = mapData.getByType('enterprise-category');
                 */
-            getByType(type: 'category'): Category[];
+            getByType(type: 'enterprise-category'): EnterpriseCategory[];
+            /**
+                * @returns The enterprise venue ({@link EnterpriseVenue}) on the map.
+                * @example
+                * const enterpriseVenue = mapData.getByType('enterprise-venue');
+                */
+            getByType(type: 'enterprise-venue'): EnterpriseVenue;
             /**
                 * Retrieves a specific map feature by its type and ID.
                 *
@@ -449,8 +479,8 @@ declare module '@mappedin/mappedin-js/mappedin-js/src/map-data' {
             getById(type: 'object', id: string): MapObject | undefined;
             getById(type: 'point-of-interest', id: string): PointOfInterest | undefined;
             getById(type: 'annotation', id: string): Annotation | undefined;
-            getById(type: 'location', id: string): Location | undefined;
-            getById(type: 'category', id: string): Category | undefined;
+            getById(type: 'enterprise-location', id: string): EnterpriseLocation | undefined;
+            getById(type: 'enterprise-category', id: string): EnterpriseCategory | undefined;
             getById(type: string, id: string): object | undefined;
             /**
                 * @internal
@@ -592,13 +622,13 @@ declare module '@mappedin/mappedin-js/mappedin-js/src/map-data-objects' {
     import Annotation from '@mappedin/mappedin-js/mappedin-js/src/map-data-objects/annotation';
     import Hyperlink from '@mappedin/mappedin-js/mappedin-js/src/map-data-objects/hyperlink';
     import Image from '@mappedin/mappedin-js/mappedin-js/src/map-data-objects/image';
-    import type { AnnotationCollection, ParsedMVF, Connection as MVFConnection, EntranceCollection, NodeCollection, ObstructionCollection, SpaceCollection, Map as MVFMap, EnterpriseLocation, EnterpriseCategory } from '@mappedin/mvf';
-    import type { MapDataObjects } from '@mappedin/mappedin-js/mappedin-js/src/map-data-objects/types';
-    import Location from '@mappedin/mappedin-js/mappedin-js/src/map-data-objects/location';
-    import Category from '@mappedin/mappedin-js/mappedin-js/src/map-data-objects/category';
-    import Venue from '@mappedin/mappedin-js/mappedin-js/src/map-data-objects/venue';
-    import { PubSub } from '@packages/internal/common';
+    import type { AnnotationCollection, ParsedMVF, Connection as MVFConnection, EntranceCollection, NodeCollection, ObstructionCollection, SpaceCollection, Map as MVFMap, EnterpriseLocation as MVFEnterpriseLocation, EnterpriseCategory as MVFEnterpriseCategory } from '@mappedin/mvf';
     import { AnalyticsInternal } from '@mappedin/mappedin-js/mappedin-js/src/analytics';
+    import EnterpriseLocation from '@mappedin/mappedin-js/mappedin-js/src/map-data-objects/location';
+    import EnterpriseCategory from '@mappedin/mappedin-js/mappedin-js/src/map-data-objects/category';
+    import EnterpriseVenue from '@mappedin/mappedin-js/mappedin-js/src/map-data-objects/venue';
+    import { PubSub } from '@packages/internal/common';
+    import type { Places } from '@mappedin/mappedin-js/mappedin-js/src/map-data-objects/types';
     /**
         * Internal class representing detailed map data.
         *
@@ -632,9 +662,9 @@ declare module '@mappedin/mappedin-js/mappedin-js/src/map-data-objects' {
                 * Represents a map of entrance IDs to obstruction IDs.
                 */
             readonly obstructionIdByEntranceId: Record<string, string>;
-            readonly venue?: Venue;
+            readonly venue?: EnterpriseVenue;
             doorsByNodeId: Record<string, Door>;
-            locationsBySpaceId: Record<string, EnterpriseLocation[]>;
+            locationsBySpaceId: Record<string, MVFEnterpriseLocation[]>;
             /**
                 * @internal
                 */
@@ -697,8 +727,8 @@ declare module '@mappedin/mappedin-js/mappedin-js/src/map-data-objects' {
                 * @returns {Annotation[]} An array of Annotation objects.
                 */
             get nodes(): Node[];
-            get locations(): Location[];
-            get categories(): Category[];
+            get locations(): EnterpriseLocation[];
+            get categories(): EnterpriseCategory[];
             /**
                 * Retrieves an object by its type and ID.
                 *
@@ -714,9 +744,9 @@ declare module '@mappedin/mappedin-js/mappedin-js/src/map-data-objects' {
             getById(type: 'object', id: string): MapObject | undefined;
             getById(type: 'point-of-interest', id: string): PointOfInterest | undefined;
             getById(type: 'annotation', id: string): Annotation | undefined;
-            getById(type: 'location', id: string): Location | undefined;
-            getById(type: 'category', id: string): Category | undefined;
-            getMapDataById(id: string): MapDataObjects | undefined;
+            getById(type: 'enterprise-location', id: string): EnterpriseLocation | undefined;
+            getById(type: 'enterprise-category', id: string): EnterpriseCategory | undefined;
+            getMapDataById(id: string): Places | undefined;
             /**
                 * Retrieves a feature by its type and ID from the Mappedin Venue Format (MVF) data.
                 *
@@ -743,14 +773,14 @@ declare module '@mappedin/mappedin-js/mappedin-js/src/map-data-objects' {
             languagePacks: {
                     [key: string]: {
                             location: {
-                                    [key: string]: Partial<EnterpriseLocation>;
+                                    [key: string]: Partial<MVFEnterpriseLocation>;
                             };
                             category: {
-                                    [key: string]: Partial<EnterpriseCategory>;
+                                    [key: string]: Partial<MVFEnterpriseCategory>;
                             };
                     };
             };
-            getPropTranslation(type: 'location' | 'category', prop: string, id: string, fallback: EnterpriseLocation[keyof EnterpriseLocation] | EnterpriseCategory[keyof EnterpriseCategory]): unknown;
+            getPropTranslation(type: 'enterprise-location' | 'enterprise-category', prop: string, id: string, fallback: MVFEnterpriseLocation[keyof MVFEnterpriseLocation] | MVFEnterpriseCategory[keyof MVFEnterpriseCategory]): unknown;
             changeLanguage(languageCode: string): Promise<void>;
             /**
                 * Cleans up resources used by the instance.
@@ -759,9 +789,9 @@ declare module '@mappedin/mappedin-js/mappedin-js/src/map-data-objects' {
                 */
             destroy(): void;
     }
-    export { MapDataInternal, Space, Floor, Connection, MapObject, Door, Coordinate, PointOfInterest, Annotation, Hyperlink, Image, Location, Category, Venue, };
+    export { MapDataInternal, Space, Floor, Connection, MapObject, Door, Coordinate, PointOfInterest, Annotation, Hyperlink, Image, EnterpriseLocation, EnterpriseCategory, EnterpriseVenue, };
     export type { TSpaceType } from '@mappedin/mappedin-js/mappedin-js/src/map-data-objects/space';
-    export type { MapDataObjects };
+    export type { Places };
 }
 
 declare module '@mappedin/mappedin-js/mappedin-js/src/map-view' {
@@ -1996,29 +2026,35 @@ declare module '@mappedin/mappedin-js/mappedin-js/src/api-geojson' {
     export { Images } from '@mappedin/mappedin-js/mappedin-js/src/api-geojson/images';
 }
 
+declare module '@mappedin/mappedin-js/mappedin-js/src/search' {
+    export type { SearchResult, SearchResultItem, SearchOptions, Suggestion, SearchResultEnterpriseCategory, SearchResultEnterpriseLocations, SearchResultPlaces, MatchInfo, } from '@mappedin/mappedin-js/mappedin-js/src/search/internal';
+    export type { SearchState } from '@mappedin/mappedin-js/mappedin-js/src/search/external';
+    export { Search } from '@mappedin/mappedin-js/mappedin-js/src/search/external';
+}
+
 declare module '@mappedin/mappedin-js/mappedin-js/src/analytics' {
     export { Analytics, AnalyticsInternal } from '@mappedin/mappedin-js/mappedin-js/src/analytics/customer';
     export type { AnalyticsUpdateOptions } from '@mappedin/mappedin-js/mappedin-js/src/analytics/customer';
 }
 
 declare module '@mappedin/mappedin-js/mappedin-js/src/map-data-objects/category' {
-    import type { EnterpriseCategory } from '@mappedin/mvf';
-    import type { MapDataInternal, Location } from '@mappedin/mappedin-js/mappedin-js/src/map-data-objects';
+    import type { EnterpriseCategory as MVFEnterpriseCategory } from '@mappedin/mvf';
+    import type { MapDataInternal, EnterpriseLocation } from '@mappedin/mappedin-js/mappedin-js/src/map-data-objects';
     import BaseMapData from '@mappedin/mappedin-js/mappedin-js/src/map-data-objects/base-object';
     /**
-        * A Category is a collection of similar Locations.
+        * An EnterpriseCategory is a collection of similar EnterpriseLocations.
         *
         */
-    class Category extends BaseMapData implements Omit<EnterpriseCategory, 'children' | 'locations'> {
+    class EnterpriseCategory extends BaseMapData implements Omit<MVFEnterpriseCategory, 'children' | 'locations'> {
             #private;
             /**
                 * @internal
                 */
-            static readonly __type = "category";
+            static readonly __type = "enterprise-category";
             /**
                 * @internal
                 */
-            readonly __type = "category";
+            readonly __type = "enterprise-category";
             name: string;
             color?: string | undefined;
             externalId: string;
@@ -2027,24 +2063,24 @@ declare module '@mappedin/mappedin-js/mappedin-js/src/map-data-objects/category'
             iconFromDefaultList?: string | null | undefined;
             sortOrder: number;
             /**
-                * Checks if the provided instance is of type Category.
+                * Checks if the provided instance is of type EnterpriseCategory.
                 *
                 * @param instance The instance to check.
-                * @returns {boolean} True if the instance is a Category, false otherwise.
+                * @returns {boolean} True if the instance is a EnterpriseCategory, false otherwise.
                 */
-            static is(instance: object): instance is Category;
+            static is(instance: object): instance is EnterpriseCategory;
             /**
                 * @internal
                 */
             constructor(data: MapDataInternal, options: {
-                    mvfData: EnterpriseCategory;
+                    mvfData: MVFEnterpriseCategory;
             });
-            get children(): Category[];
-            get locations(): Location[];
+            get children(): EnterpriseCategory[];
+            get locations(): EnterpriseLocation[];
             /**
-                * Serializes the category data to JSON.
+                * Serializes the EnterpriseCategory data to JSON.
                 *
-                * @returns An object representing the category.
+                * @returns An object representing the EnterpriseCategory.
                 */
             toJSON(): {
                     id: string;
@@ -2057,29 +2093,29 @@ declare module '@mappedin/mappedin-js/mappedin-js/src/map-data-objects/category'
                 */
             destroy(): void;
     }
-    export default Category;
+    export default EnterpriseCategory;
 }
 
 declare module '@mappedin/mappedin-js/mappedin-js/src/map-data-objects/location' {
-    import type { EnterpriseLocation, LocationState, OperationHours, SiblingGroup } from '@mappedin/mvf';
+    import type { EnterpriseLocation as MVFEnterpriseLocation, LocationState, OperationHours, SiblingGroup } from '@mappedin/mvf';
     import type { Coordinate, MapDataInternal, Space } from '@mappedin/mappedin-js/mappedin-js/src/map-data-objects';
     import BaseMapData from '@mappedin/mappedin-js/mappedin-js/src/map-data-objects/base-object';
     import type Node from '@mappedin/mappedin-js/mappedin-js/src/map-data-objects/node';
     /**
-        * A class representing location data within the map.
+        * A class representing enterprise location data within the map.
         *
-        * A Location is something like a store, or a washroom on a map.
+        * An EnterpriseLocation is something like a store, or a washroom on a map.
         */
-    class Location extends BaseMapData implements Omit<EnterpriseLocation, 'polygons' | 'nodes' | 'links'> {
+    class EnterpriseLocation extends BaseMapData implements Omit<MVFEnterpriseLocation, 'polygons' | 'nodes' | 'links'> {
             #private;
             /**
                 * @internal
                 */
-            static readonly __type = "location";
+            static readonly __type = "enterprise-location";
             /**
                 * @internal
                 */
-            readonly __type = "location";
+            readonly __type = "enterprise-location";
             description?: string | undefined;
             name: string;
             amenity?: string | undefined;
@@ -2112,25 +2148,25 @@ declare module '@mappedin/mappedin-js/mappedin-js/src/map-data-objects/location'
             tags?: string[] | undefined;
             type: string;
             /**
-                * Checks if the provided instance is of type Location.
+                * Checks if the provided instance is of type EnterpriseLocation.
                 *
                 * @param instance The instance to check.
-                * @returns {boolean} True if the instance is a Location, false otherwise.
+                * @returns {boolean} True if the instance is a EnterpriseLocation, false otherwise.
                 */
-            static is(instance: object): instance is Location;
+            static is(instance: object): instance is EnterpriseLocation;
             /**
                 * @internal
                 */
             constructor(data: MapDataInternal, options: {
-                    mvfData: EnterpriseLocation;
+                    mvfData: MVFEnterpriseLocation;
             });
             get coordinates(): Coordinate[];
             get nodes(): Node[];
             get spaces(): Space[];
             /**
-                * Serializes the location data to JSON.
+                * Serializes the EnterpriseLocation data to JSON.
                 *
-                * @returns An object representing the location.
+                * @returns An object representing the EnterpriseLocation.
                 */
             toJSON(): {
                     id: string;
@@ -2143,26 +2179,26 @@ declare module '@mappedin/mappedin-js/mappedin-js/src/map-data-objects/location'
                 */
             destroy(): void;
     }
-    export default Location;
+    export default EnterpriseLocation;
 }
 
 declare module '@mappedin/mappedin-js/mappedin-js/src/map-data-objects/venue' {
-    import type { EnterpriseVenue, Language } from '@mappedin/mvf';
+    import type { EnterpriseVenue as MVFEnterpriseVenue, Language } from '@mappedin/mvf';
     import type { Hyperlink, MapDataInternal } from '@mappedin/mappedin-js/mappedin-js/src/map-data-objects';
     import BaseMapData from '@mappedin/mappedin-js/mappedin-js/src/map-data-objects/base-object';
     /**
-        * A Venue is a specific place (like a mall, office building, or stadium) with one or more Floors
+        * An EnterpriseVenue is a specific place (like a mall, office building, or stadium) with one or more Floors
         */
-    class Venue extends BaseMapData implements EnterpriseVenue {
+    class EnterpriseVenue extends BaseMapData implements MVFEnterpriseVenue {
             #private;
             /**
                 * @internal
                 */
-            static readonly __type = "venue";
+            static readonly __type = "enterprise-venue";
             /**
                 * @internal
                 */
-            readonly __type = "venue";
+            readonly __type = "enterprise-venue";
             countrycode?: string | undefined;
             externalId: string;
             defaultLanguage: Language;
@@ -2177,28 +2213,28 @@ declare module '@mappedin/mappedin-js/mappedin-js/src/map-data-objects/venue' {
             topLocations?: string[] | undefined;
             tzid?: string | undefined;
             /**
-                * Checks if the provided instance is of type Venue.
+                * Checks if the provided instance is of type EnterpriseVenue.
                 *
                 * @param instance The instance to check.
-                * @returns {boolean} True if the instance is a Venue, false otherwise.
+                * @returns {boolean} True if the instance is a EnterpriseVenue, false otherwise.
                 */
-            static is(instance: object): instance is Venue;
+            static is(instance: object): instance is EnterpriseVenue;
             /**
                 * @internal
                 */
             constructor(_data: MapDataInternal, options: {
-                    mvfData: EnterpriseVenue;
+                    mvfData: MVFEnterpriseVenue;
             });
             /**
-                * Gets the name of the venue.
+                * Gets the name of the EnterpriseVenue.
                 *
-                * @returns {string} The name of the venue.
+                * @returns {string} The name of the EnterpriseVenue.
                 */
             get name(): string;
             /**
-                * Serializes the venue data to JSON.
+                * Serializes the EnterpriseVenue data to JSON.
                 *
-                * @returns An object representing the venue.
+                * @returns An object representing the EnterpriseVenue.
                 */
             toJSON(): {
                     id: string;
@@ -2211,7 +2247,7 @@ declare module '@mappedin/mappedin-js/mappedin-js/src/map-data-objects/venue' {
                 */
             destroy(): void;
     }
-    export default Venue;
+    export default EnterpriseVenue;
 }
 
 declare module '@mappedin/mappedin-js/mappedin-js/src/api-geojson/stacked-maps/stacked-maps' {
@@ -2450,10 +2486,10 @@ declare module '@mappedin/mappedin-js/mappedin-js/src/map-data-objects/door' {
 declare module '@mappedin/mappedin-js/mappedin-js/src/map-data-objects/space' {
     import type { Image, SpaceCollection } from '@mappedin/mvf';
     import Coordinate from '@mappedin/mappedin-js/mappedin-js/src/map-data-objects/coordinate';
-    import type { Location, MapDataInternal } from '@mappedin/mappedin-js/mappedin-js/src/map-data-objects';
+    import type { EnterpriseLocation, MapDataInternal } from '@mappedin/mappedin-js/mappedin-js/src/map-data-objects';
     import type Floor from '@mappedin/mappedin-js/mappedin-js/src/map-data-objects/floor';
     import BaseMapData from '@mappedin/mappedin-js/mappedin-js/src/map-data-objects/base-object';
-    import Door from '@mappedin/mappedin-js/mappedin-js/src/map-data-objects/door';
+    import type Door from '@mappedin/mappedin-js/mappedin-js/src/map-data-objects/door';
     /**
         * Represents the various types of spaces that can be defined within a map.
         * - 'room': A standard room or enclosed area.
@@ -2511,7 +2547,7 @@ declare module '@mappedin/mappedin-js/mappedin-js/src/map-data-objects/space' {
             /**
                 * @internal
                 */
-            get locations(): Location[];
+            get locations(): EnterpriseLocation[];
             /**
                 * Gets the {@link Floor} object associated with the space.
                 *
@@ -3206,13 +3242,15 @@ declare module '@mappedin/mappedin-js/mappedin-js/src/map-data-objects/image' {
 declare module '@mappedin/mappedin-js/mappedin-js/src/map-data-objects/types' {
     import type Door from '@mappedin/mappedin-js/mappedin-js/src/map-data-objects/door';
     import type Floor from '@mappedin/mappedin-js/mappedin-js/src/map-data-objects/floor';
-    import type Node from '@mappedin/mappedin-js/mappedin-js/src/map-data-objects/node';
     import type Space from '@mappedin/mappedin-js/mappedin-js/src/map-data-objects/space';
     import type PointOfInterest from '@mappedin/mappedin-js/mappedin-js/src/map-data-objects/poi';
     import type Annotation from '@mappedin/mappedin-js/mappedin-js/src/map-data-objects/annotation';
     import type Connection from '@mappedin/mappedin-js/mappedin-js/src/map-data-objects/connection';
     import type MapObject from '@mappedin/mappedin-js/mappedin-js/src/map-data-objects/object';
-    export type MapDataObjects = Space | Floor | Node | Door | Connection | MapObject | PointOfInterest | Annotation;
+    /**
+      * Places are the main objects that can be searched for.
+      */
+    export type Places = Space | Floor | Door | Connection | MapObject | PointOfInterest | Annotation;
 }
 
 declare module '@mappedin/mappedin-js/mappedin-js/src' {
@@ -3498,8 +3536,9 @@ declare module '@mappedin/mappedin-js/mappedin-js/src' {
     export type { Label, Marker, Path, Shape, CameraTransform, Model } from '@mappedin/mappedin-js/mappedin-js/src/map-view-objects';
     export type { Navigation, TNavigationOptions } from '@mappedin/mappedin-js/mappedin-js/src/navigation';
     export type { TSpaceType } from '@mappedin/mappedin-js/mappedin-js/src/map-data-objects';
-    export { Coordinate, Annotation, Connection, Door, Floor, MapObject, PointOfInterest, Space, Image, Hyperlink, Location, Category, Venue, } from '@mappedin/mappedin-js/mappedin-js/src/map-data-objects';
+    export { Coordinate, Annotation, Connection, Door, Floor, MapObject, PointOfInterest, Space, Image, Hyperlink, EnterpriseLocation, EnterpriseCategory, EnterpriseVenue, type Places, } from '@mappedin/mappedin-js/mappedin-js/src/map-data-objects';
     export type { Camera, Models, Labels, Markers, Paths, Exporter, Directions, Style, Shapes, Outdoor, } from '@mappedin/mappedin-js/mappedin-js/src/api-geojson';
+    export type { SearchResult, SearchResultItem, SearchResultEnterpriseCategory, SearchResultEnterpriseLocations, SearchResultPlaces, SearchOptions, Search, Suggestion, MatchInfo, } from '@mappedin/mappedin-js/mappedin-js/src/search';
 }
 
 declare module '@mappedin/mappedin-js/mappedin-js/src/api-geojson/blue-dot/blue-dot' {
@@ -3730,10 +3769,18 @@ declare module '@mappedin/mappedin-js/geojson/src/components/marker' {
 }
 
 declare module '@mappedin/mappedin-js/geojson/src/components/path' {
-    import { type Mesh, type ShaderMaterial, type BufferGeometry, Vector3 } from 'three';
-    import type { Position } from '@mappedin/mappedin-js/geojson/src/types';
+    import { Vector3 } from 'three';
+    import type { Mesh, ShaderMaterial, BufferGeometry } from 'three';
+    import type { EntityId, Position } from '@mappedin/mappedin-js/geojson/src/types';
     import { Geometry3DObject3D } from '@mappedin/mappedin-js/geojson/src/entities/geometry3d';
     import type { FeatureCollection, Point } from 'geojson';
+    import type { GroupContainerState } from '@mappedin/mappedin-js/geojson/src/entities/group-container';
+    export type PathProperties = {
+            /**
+                * The parentId of the point. The point will be anchored to the altitude of this parent group container.
+                */
+            parentId?: EntityId<GroupContainerState> | string | null;
+    };
     /**
         * State representing a Path
         */
@@ -3805,7 +3852,7 @@ declare module '@mappedin/mappedin-js/geojson/src/components/path' {
             material?: ShaderMaterial;
             geometry?: BufferGeometry;
             outline?: Mesh;
-            feature: FeatureCollection<Point>;
+            feature: FeatureCollection<Point, PathProperties>;
             options: AddPathOptions;
             nearRadius: number;
             farRadius: number;
@@ -3814,8 +3861,12 @@ declare module '@mappedin/mappedin-js/geojson/src/components/path' {
             altitudeAdjustment: number;
             displayArrowsOnPath: boolean;
             animateArrowsOnPath: boolean;
+            /**
+                * If the path is vertical it will be rebuilt whenever altitudeDirty = true. This will be set during the first render of the path.
+                */
+            isVertical: boolean;
             dirty: boolean;
-            constructor(feature: FeatureCollection<Point, any>, options?: AddPathOptions);
+            constructor(feature: FeatureCollection<Point, PathProperties>, options?: AddPathOptions);
             setColor(): void;
             setOpacity(): void;
             set completeFraction(value: number);
@@ -5190,6 +5241,7 @@ declare module '@mappedin/mappedin-js/geojson/src/renderer' {
     import './utils/object-this-polyfill';
     import { Vector3, Raycaster, Camera as ThreeCamera } from 'three';
     import type { GroupContainerState } from '@mappedin/mappedin-js/geojson/src/entities/group-container';
+    import { GroupContainerObject3D } from '@mappedin/mappedin-js/geojson/src/entities/group-container';
     import { PubSub } from '@mappedin/mappedin-js/packages/common/pubsub';
     import { CollisionSystem } from '@mappedin/mappedin-js/geojson/src/systems/collisions/system';
     import { InteractionSystem } from '@mappedin/mappedin-js/geojson/src/systems/interactions';
@@ -5207,7 +5259,7 @@ declare module '@mappedin/mappedin-js/geojson/src/renderer' {
     import { TwoDVisibilitySystem } from '@mappedin/mappedin-js/geojson/src/systems/2d-visibility/system';
     import { RenderSystem } from '@mappedin/mappedin-js/geojson/src/systems/render/system';
     import type { Position as GeoJsonPosition, FeatureCollection, LineString, MultiPolygon, Polygon, Point, Feature } from 'geojson';
-    import type { AddPathOptions, PathState } from '@mappedin/mappedin-js/geojson/src/components/path';
+    import type { AddPathOptions, PathProperties, PathState } from '@mappedin/mappedin-js/geojson/src/components/path';
     import { StackSystem } from '@mappedin/mappedin-js/geojson/src/systems/stack/system';
     import { CameraSystem } from '@mappedin/mappedin-js/geojson/src/systems/camera';
     import { DOMDrawSystem } from '@mappedin/mappedin-js/geojson/src/systems/dom-draw/system';
@@ -5320,6 +5372,7 @@ declare module '@mappedin/mappedin-js/geojson/src/renderer' {
                     id: string;
                     type: string;
             };
+            getParentContainer: (parent?: EntityId<GroupContainerState> | string | number | null, defaultToScene?: boolean) => GroupContainerObject3D | undefined;
             /**
                 * Add a custom THREE.js entity to the map. The geometry is placed at the GeoJSON coordinate and includes a `setup` and `update` methods.
                 * Setup is called when the first time the geometry visible, and update is called every render frame.
@@ -5348,21 +5401,13 @@ declare module '@mappedin/mappedin-js/geojson/src/renderer' {
             /**
                 * Add a Path along a set of GeoJSON coordinates that can be animated.
                 */
-            addPath(geometry: FeatureCollection<Point, any>, options?: AddPathOptions, parent?: EntityId<GroupContainerState> | string | null): EntityId<PathState>;
+            addPath(geometry: FeatureCollection<Point, PathProperties>, options?: AddPathOptions, parent?: EntityId<GroupContainerState> | string | null): EntityId<PathState>;
             /**
                 * Updates the watermark on the map.
                 *
                 * @param options {WatermarkOptions}
                 */
             updateWatermark(options: Omit<WatermarkOptions, 'onClick'>): void;
-            /**
-                * @deprecated
-                * @TODO: remove this method and do this in setstate instead
-                */
-            updateStackState(container: EntityId<GroupContainerState> | string | number, opts: {
-                    expandedFactor?: number;
-                    activeId?: string;
-            }): void;
             /**
                 * Remove an entity from the renderer and release associated resources.
                 */
@@ -6908,6 +6953,339 @@ declare module '@mappedin/mappedin-js/mappedin-js/src/api-geojson/images' {
     export {};
 }
 
+declare module '@mappedin/mappedin-js/mappedin-js/src/search/internal' {
+    import type { SearchResult as MiniSearchResult, Suggestion, MatchInfo } from 'minisearch';
+    import type { EnterpriseLocation, EnterpriseCategory, Places } from '@mappedin/mappedin-js/mappedin-js/src/map-data-objects';
+    import type MapData from '@mappedin/mappedin-js/mappedin-js/src/map-data';
+    import { z } from 'zod';
+    export class InternalSearch {
+            constructor(mapData: MapData);
+            /**
+                * Populates the search indexes with the map data.
+                * @returns A promise that resolves when the indexes are populated.
+                */
+            populate(): Promise<any[]>;
+            search(term: string, options?: SearchOptions): Promise<SearchResult>;
+            suggest(term: string, options?: SuggestOptions): Promise<Suggestion[]>;
+    }
+    export type SearchResultItem<T extends Places | EnterpriseLocation | EnterpriseCategory> = {
+            type: T['__type'];
+            match: MiniSearchResult['match'];
+            score: number;
+            item: T;
+    };
+    /**
+        * @interface
+        */
+    export type SearchResultEnterpriseCategory = SearchResultItem<EnterpriseCategory>;
+    /**
+        * @interface
+        */
+    export type SearchResultEnterpriseLocations = SearchResultItem<EnterpriseLocation>;
+    /**
+        * @interface
+        */
+    export type SearchResultPlaces = SearchResultItem<Places>;
+    /**
+        * Search results
+        */
+    export type SearchResult = {
+            /**
+                * Places search results
+                */
+            places: SearchResultPlaces[];
+            /**
+                * Enterprise Locations search results
+                */
+            enterpriseLocations?: SearchResultEnterpriseLocations[];
+            /**
+                * Enterprise Categories search results
+                */
+            enterpriseCategories?: SearchResultEnterpriseCategory[];
+    };
+    export function removeAccents(it: string): string;
+    const searchOptionsSchema: z.ZodObject<{
+            /**
+                * Options for searching places.
+                * @property {Object} [fields] - Fields to search in places.
+                * @property {boolean} [name] - Whether to search in the name field of places.
+                * @property {boolean} [description] - Whether to search in the description field of places.
+                * @property {number} [limit] - Maximum number of place results to return.
+                */
+            places: z.ZodOptional<z.ZodObject<{
+                    /**
+                        * Fields to search in places.
+                        * @property {boolean} [name] - Whether to search in the name field of places.
+                        * @property {boolean} [description] - Whether to search in the description field of places.
+                        */
+                    fields: z.ZodOptional<z.ZodObject<{
+                            /** Enable searching by place name */
+                            name: z.ZodOptional<z.ZodBoolean>;
+                            /** Enable searching by place description */
+                            description: z.ZodOptional<z.ZodBoolean>;
+                    }, "strip", z.ZodTypeAny, {
+                            name?: boolean | undefined;
+                            description?: boolean | undefined;
+                    }, {
+                            name?: boolean | undefined;
+                            description?: boolean | undefined;
+                    }>>;
+                    /** Maximum number of place results to return */
+                    limit: z.ZodOptional<z.ZodNumber>;
+            }, "strip", z.ZodTypeAny, {
+                    limit?: number | undefined;
+                    fields?: {
+                            name?: boolean | undefined;
+                            description?: boolean | undefined;
+                    } | undefined;
+            }, {
+                    limit?: number | undefined;
+                    fields?: {
+                            name?: boolean | undefined;
+                            description?: boolean | undefined;
+                    } | undefined;
+            }>>;
+            /**
+                * Options for searching categories.
+                * @property {Object} [fields] - Fields to search in categories.
+                * @property {boolean} [name] - Whether to search in the name field of categories.
+                * @property {boolean} [description] - Whether to search in the description field of categories.
+                * @property {boolean} ['locations.name'] - Whether to search in the locations' names of categories.
+                * @property {number} [limit] - Maximum number of category results to return.
+                */
+            enterpriseCategories: z.ZodOptional<z.ZodObject<{
+                    /**
+                        * Fields to search in categories.
+                        * @property {boolean} [name] - Whether to search in the name field of categories.
+                        * @property {boolean} [description] - Whether to search in the description field of categories.
+                        * @property {boolean} ['locations.name'] - Whether to search in the locations' names of categories.
+                        */
+                    fields: z.ZodOptional<z.ZodObject<{
+                            /** Enable searching by category name */
+                            name: z.ZodOptional<z.ZodBoolean>;
+                            /** Enable searching by category description */
+                            description: z.ZodOptional<z.ZodBoolean>;
+                            /** Enable searching by names of locations within the category */
+                            'locations.name': z.ZodOptional<z.ZodBoolean>;
+                    }, "strip", z.ZodTypeAny, {
+                            name?: boolean | undefined;
+                            description?: boolean | undefined;
+                            'locations.name'?: boolean | undefined;
+                    }, {
+                            name?: boolean | undefined;
+                            description?: boolean | undefined;
+                            'locations.name'?: boolean | undefined;
+                    }>>;
+                    /** Maximum number of category results to return */
+                    limit: z.ZodOptional<z.ZodNumber>;
+            }, "strip", z.ZodTypeAny, {
+                    limit?: number | undefined;
+                    fields?: {
+                            name?: boolean | undefined;
+                            description?: boolean | undefined;
+                            'locations.name'?: boolean | undefined;
+                    } | undefined;
+            }, {
+                    limit?: number | undefined;
+                    fields?: {
+                            name?: boolean | undefined;
+                            description?: boolean | undefined;
+                            'locations.name'?: boolean | undefined;
+                    } | undefined;
+            }>>;
+            /**
+                * Options for searching locations.
+                * @property {Object} [fields] - Fields to search in locations.
+                * @property {boolean} [name] - Whether to search in the name field of locations.
+                * @property {boolean} [tags] - Whether to search in the tags field of locations.
+                * @property {boolean} [description] - Whether to search in the description field of locations.
+                * @property {number} [limit] - Maximum number of location results to return.
+                */
+            enterpriseLocations: z.ZodOptional<z.ZodObject<{
+                    /**
+                        * Fields to search in locations.
+                        * @property {boolean} [name] - Whether to search in the name field of locations.
+                        * @property {boolean} [tags] - Whether to search in the tags field of locations.
+                        * @property {boolean} [description] - Whether to search in the description field of locations.
+                        */
+                    fields: z.ZodOptional<z.ZodObject<{
+                            /** Enable searching by location name */
+                            name: z.ZodOptional<z.ZodBoolean>;
+                            /** Enable searching by location tags */
+                            tags: z.ZodOptional<z.ZodBoolean>;
+                            /** Enable searching by location description */
+                            description: z.ZodOptional<z.ZodBoolean>;
+                    }, "strip", z.ZodTypeAny, {
+                            name?: boolean | undefined;
+                            description?: boolean | undefined;
+                            tags?: boolean | undefined;
+                    }, {
+                            name?: boolean | undefined;
+                            description?: boolean | undefined;
+                            tags?: boolean | undefined;
+                    }>>;
+                    /** Maximum number of location results to return */
+                    limit: z.ZodOptional<z.ZodNumber>;
+            }, "strip", z.ZodTypeAny, {
+                    limit?: number | undefined;
+                    fields?: {
+                            name?: boolean | undefined;
+                            description?: boolean | undefined;
+                            tags?: boolean | undefined;
+                    } | undefined;
+            }, {
+                    limit?: number | undefined;
+                    fields?: {
+                            name?: boolean | undefined;
+                            description?: boolean | undefined;
+                            tags?: boolean | undefined;
+                    } | undefined;
+            }>>;
+    }, "strip", z.ZodTypeAny, {
+            enterpriseLocations?: {
+                    limit?: number | undefined;
+                    fields?: {
+                            name?: boolean | undefined;
+                            description?: boolean | undefined;
+                            tags?: boolean | undefined;
+                    } | undefined;
+            } | undefined;
+            enterpriseCategories?: {
+                    limit?: number | undefined;
+                    fields?: {
+                            name?: boolean | undefined;
+                            description?: boolean | undefined;
+                            'locations.name'?: boolean | undefined;
+                    } | undefined;
+            } | undefined;
+            places?: {
+                    limit?: number | undefined;
+                    fields?: {
+                            name?: boolean | undefined;
+                            description?: boolean | undefined;
+                    } | undefined;
+            } | undefined;
+    }, {
+            enterpriseLocations?: {
+                    limit?: number | undefined;
+                    fields?: {
+                            name?: boolean | undefined;
+                            description?: boolean | undefined;
+                            tags?: boolean | undefined;
+                    } | undefined;
+            } | undefined;
+            enterpriseCategories?: {
+                    limit?: number | undefined;
+                    fields?: {
+                            name?: boolean | undefined;
+                            description?: boolean | undefined;
+                            'locations.name'?: boolean | undefined;
+                    } | undefined;
+            } | undefined;
+            places?: {
+                    limit?: number | undefined;
+                    fields?: {
+                            name?: boolean | undefined;
+                            description?: boolean | undefined;
+                    } | undefined;
+            } | undefined;
+    }>;
+    const suggestOptionsSchema: z.ZodObject<{
+            /**
+                * Options for searching places.
+                * @property {boolean} [enabled] - Whether to search in places.
+                */
+            places: z.ZodOptional<z.ZodObject<{
+                    /** Enable searching by place name */
+                    enabled: z.ZodOptional<z.ZodBoolean>;
+            }, "strip", z.ZodTypeAny, {
+                    enabled?: boolean | undefined;
+            }, {
+                    enabled?: boolean | undefined;
+            }>>;
+            /**
+                * Options for searching locations.
+                * @property {boolean} [enabled] - Whether to search in locations.
+                */
+            enterpriseLocations: z.ZodOptional<z.ZodObject<{
+                    /** Enable searching by location name */
+                    enabled: z.ZodOptional<z.ZodBoolean>;
+            }, "strip", z.ZodTypeAny, {
+                    enabled?: boolean | undefined;
+            }, {
+                    enabled?: boolean | undefined;
+            }>>;
+    }, "strip", z.ZodTypeAny, {
+            enterpriseLocations?: {
+                    enabled?: boolean | undefined;
+            } | undefined;
+            places?: {
+                    enabled?: boolean | undefined;
+            } | undefined;
+    }, {
+            enterpriseLocations?: {
+                    enabled?: boolean | undefined;
+            } | undefined;
+            places?: {
+                    enabled?: boolean | undefined;
+            } | undefined;
+    }>;
+    export type SearchOptions = z.infer<typeof searchOptionsSchema>;
+    export type SuggestOptions = z.infer<typeof suggestOptionsSchema>;
+    export { Suggestion, MatchInfo };
+}
+
+declare module '@mappedin/mappedin-js/mappedin-js/src/search/external' {
+    import type MapData from '@mappedin/mappedin-js/mappedin-js/src/map-data';
+    import type { InternalSearch, SearchOptions, SuggestOptions } from '@mappedin/mappedin-js/mappedin-js/src/search/internal';
+    import type { MapDataInternal } from '@mappedin/mappedin-js/mappedin-js/src/map-data-objects';
+    export class Search {
+            #private;
+            /**
+                * Whether the search is enabled.
+                * @default false
+                */
+            enabled: boolean;
+            constructor(mapData: MapData, mapDataInternal: MapDataInternal, { enabled }?: {
+                    enabled?: boolean;
+            });
+            /**
+                * Searches for places, locations, and categories.
+                * @param term - The search term.
+                * @param options - The search options.
+                * @returns The search results.
+                * @example
+                * ```ts
+                * const results = await search.query('Coffee Shop');
+                * console.log(results.locations);
+                * ```
+                */
+            query(term: string, options?: SearchOptions): ReturnType<typeof InternalSearch.prototype.search>;
+            /**
+                * Suggests the names of places, locations, and categories.
+                * @param term - The search term.
+                * @param options - The suggest options.
+                * @returns The search suggestions.
+                * @example
+                * ```ts
+                * const suggestions = await search.suggest('Coffee');
+                * console.log(suggestions);
+                * ```
+                */
+            suggest(term: string, options?: SuggestOptions): Promise<import("minisearch").Suggestion[]>;
+            /**
+                * Enables the search.
+                */
+            enable(): Promise<void>;
+    }
+    export type SearchState = {
+            /**
+                * Whether the search is enabled.
+                */
+            enabled: boolean;
+    };
+}
+
 declare module '@mappedin/mappedin-js/mappedin-js/src/analytics/customer' {
     /**
         * Valid track-analytics API contexts. These should match the expected values of that endpoint or the requests will fail.
@@ -8293,7 +8671,7 @@ declare module '@mappedin/mappedin-js/geojson/src/entities/utils' {
     export function updateGroupTexture(entity: Geometry3D | Geometry2D | GeometryGroupObject3D | GroupContainerObject3D, update?: Pick<GeometryGroupStyleComponent, 'texture' | 'topTexture'>): void;
     export function updateIndividualGeometryTexture(entity: Geometry3D, update?: Pick<StyleComponent, 'texture' | 'topTexture'>): boolean;
     export function updateIndividualGeometryOpacity(entity: Geometry3D, update?: number): boolean;
-    export function updateAltitude(entity: Geometry3D | Geometry2D | GeometryGroupObject3D | GroupContainerObject3D, update?: number): void;
+    export function updateAltitude(entity: Geometry3D | Geometry2D | GeometryGroupObject3D | GroupContainerObject3D, update?: number): boolean;
     export function updateOutline(entity: Geometry3DTypes, update?: boolean): boolean;
 }
 
@@ -16876,8 +17254,10 @@ declare module '@mappedin/mappedin-js/geojson/src/systems/path/system' {
     export class PathSystem extends PubSub<{
         'animate:path': undefined;
     }> {
+        altitudeDirty: boolean;
         convertTo3DMapPosition: RendererCore['convertTo3DMapPosition'];
-        constructor(rendererState: RendererState, convertTo3DMapPosition: RendererCore['convertTo3DMapPosition']);
+        getParentContainer: RendererCore['getParentContainer'];
+        constructor(rendererState: RendererState, convertTo3DMapPosition: RendererCore['convertTo3DMapPosition'], getParentContainer: RendererCore['getParentContainer']);
         update(minZoomAltitude: number, maxZoomAltitude: number, currentZoomAltitude: number): void;
     }
 }