@aapicoits/powermap-web-sdk 1.0.0 → 1.0.1

package/dist/index.d.ts

@@ -0,0 +1,226 @@
+// ============================================================
+// PowerMap Web SDK — TypeScript Declaration File
+// Auto-generated from src/index.js JSDoc
+// ============================================================
+
+export interface PowerMapAuthOptions {
+  clientId: string;
+  clientSecret: string;
+}
+
+export interface PowerMapOptions {
+  /** The HTML element ID or element reference to mount the map into */
+  container: string | HTMLElement;
+  /** Initial map center as [longitude, latitude] */
+  center?: [number, number];
+  /** Initial zoom level */
+  zoom?: number;
+  /** Minimum zoom level */
+  minZoom?: number;
+  /** Maximum zoom level */
+  maxZoom?: number;
+  /** Map style name: 'th' | 'en' | 'dark' | 'gray' or a custom style URL */
+  style?: 'th' | 'en' | 'dark' | 'gray' | string;
+  /** API Key for map tiles */
+  mapApiKey: string;
+  /** Authentication credentials for services */
+  auth: PowerMapAuthOptions;
+  /** Disable all map interactions (zoom, pan, rotate) — preview mode */
+  previewOnly?: boolean;
+}
+
+export interface MarkerOptions {
+  /** [longitude, latitude] */
+  position: [number, number];
+  /** Marker type */
+  type?: 'start' | 'destination' | 'waypoint' | string;
+  /** Custom image URL */
+  iconUrl?: string;
+  /** Custom hex color for pinpoint marker (e.g. '#ff4444') */
+  color?: string;
+  /** FontAwesome icon class (e.g. 'fas fa-car') */
+  icon?: string;
+  /** Enable marker dragging */
+  draggable?: boolean;
+  /** HTML content or structured popup object */
+  popupContent?: string | { title?: string; body?: string; tag?: string; footer?: string };
+  /** Unique identifier for the marker */
+  id?: string;
+}
+
+export interface MarkerInstance {
+  id: string;
+  position: [number, number];
+  remove(): void;
+  setLngLat(lngLat: [number, number]): this;
+  getLngLat(): { lng: number; lat: number };
+  [key: string]: unknown;
+}
+
+export interface RouteOptions {
+  start: [number, number];
+  destination: [number, number];
+  waypoints?: [number, number][];
+  optimize?: boolean;
+  [key: string]: unknown;
+}
+
+export interface RouteStep {
+  distance: number;
+  distanceStr: string;
+  duration: number;
+  durationStr: string;
+  instruction?: string;
+  [key: string]: unknown;
+}
+
+export interface RouteDetails {
+  distance: number;
+  distanceStr: string;
+  duration: number;
+  durationStr: string;
+  steps: RouteStep[];
+}
+
+export interface RouteSummary {
+  distanceStr: string;
+  durationStr: string;
+}
+
+export interface SearchResult {
+  id: string;
+  name: string;
+  address?: string;
+  position: [number, number];
+  [key: string]: unknown;
+}
+
+export interface SearchOptions {
+  location?: [number, number];
+  lang?: string;
+  [key: string]: unknown;
+}
+
+export interface FlyToOptions {
+  center?: [number, number];
+  zoom?: number;
+  pitch?: number;
+  bearing?: number;
+  speed?: number;
+  curve?: number;
+  [key: string]: unknown;
+}
+
+export interface FitBoundsOptions {
+  padding?: number | { top: number; bottom: number; left: number; right: number };
+  maxZoom?: number;
+  [key: string]: unknown;
+}
+
+export type PowerMapEventName =
+  | 'mapLoaded'
+  | 'mapClick'
+  | 'mapLongClick'
+  | 'markerClick'
+  | 'markerDrag'
+  | 'markerDragEnd'
+  | 'poiClick'
+  | 'routeCalculated'
+  | 'modeChanged'
+  | 'error'
+  | string;
+
+export type PowerMapMode = 'standard' | 'indoor';
+
+export interface SetModeOptions {
+  buildingId?: string;
+  floorId?: string;
+  center?: [number, number];
+  [key: string]: unknown;
+}
+
+/**
+ * PowerMap SDK Main Class
+ *
+ * Provides a high-level API for map rendering, markers, routing,
+ * indoor navigation, and vehicle simulation.
+ *
+ * @example
+ * const map = new PowerMap({
+ *   container: 'map',
+ *   mapApiKey: 'YOUR_KEY',
+ *   auth: { clientId: '...', clientSecret: '...' }
+ * })
+ * .on('mapLoaded', () => console.log('Ready!'))
+ * .setStyle('dark');
+ */
+export declare class PowerMap {
+  constructor(options: PowerMapOptions);
+
+  // --- Events ---
+  on(event: PowerMapEventName, callback: (...args: unknown[]) => void): this;
+  off(event: PowerMapEventName, callback: (...args: unknown[]) => void): this;
+  onMapLoaded(callback: (data: { map: PowerMap }) => void): this;
+  onClick(callback: (event: unknown) => void): this;
+  onMapLongClick(callback: (event: unknown) => void): this;
+  onMarkerClick(callback: (data: { marker: MarkerInstance; originalEvent: unknown; options: unknown }) => void): this;
+  onPoiClick(callback: (data: { feature: unknown; lngLat: unknown; point: unknown }) => void): this;
+  onMarkerDrag(callback: (data: { marker: MarkerInstance; lngLat: [number, number] }) => void): this;
+  onMarkerDragEnd(callback: (data: { marker: MarkerInstance; lngLat: [number, number] }) => void): this;
+  onRouteCalculated(callback: (route: unknown) => void): this;
+  onError(callback: (error: Error) => void): this;
+
+  // --- Map Style & Mode ---
+  setStyle(name: 'th' | 'en' | 'dark' | 'gray' | string): this;
+  setMode(mode: PowerMapMode, options?: SetModeOptions): this;
+
+  // --- Controls ---
+  setNavigationControl(options: boolean | object): this;
+  setFullscreenControl(options: boolean | object): this;
+
+  // --- Camera ---
+  flyTo(options: FlyToOptions): this;
+  easeTo(options: FlyToOptions): this;
+  fitBounds(bounds: [[number, number], [number, number]], options?: FitBoundsOptions): this;
+  jumpTo(options: FlyToOptions): this;
+  setPitch(pitch: number, animate?: boolean): this;
+  setBearing(bearing: number, animate?: boolean): this;
+  zoomIn(): this;
+  zoomOut(): this;
+  rotateLeft(): this;
+  rotateRight(): this;
+  getCenter(): { lng: number; lat: number };
+  getZoom(): number;
+  getPitch(): number;
+  getBearing(): number;
+
+  // --- Markers ---
+  addMarker(options: MarkerOptions): MarkerInstance;
+  getMarker(id: string): MarkerInstance | null;
+  removeMarker(markerOrId: MarkerInstance | string): this;
+  updatePopup(marker: MarkerInstance, content: string | object): this;
+  clearMarkers(): this;
+
+  // --- Routing ---
+  addRoute(options: RouteOptions): Promise<unknown>;
+  clearRoutes(): this;
+  getRouteDetails(): RouteDetails | null;
+  getRouteSummary(): RouteSummary | null;
+  formatDistance(meters: number): string;
+  formatDuration(seconds: number): string;
+
+  // --- Search ---
+  search(query: string, options?: SearchOptions): Promise<SearchResult[]>;
+
+  // --- Layers ---
+  showLayer(layerId: string): Promise<this>;
+  hideLayer(layerId: string): this;
+  toggleLayer(layerId: string): Promise<this>;
+
+  // --- Managers (advanced access) ---
+  readonly layers: unknown;
+  readonly geometry: unknown;
+  readonly indoor: unknown;
+  readonly editor: unknown;
+  debug(): unknown;
+}

package/package.json

@@ -1,14 +1,17 @@
 {
+  "//": "@powermap/web-sdk",
   "name": "@aapicoits/powermap-web-sdk",
-  "version": "1.0.0",
+  "version": "1.0.1",
   "type": "module",
   "files": [
     "dist"
   ],
   "main": "./dist/powermap-web-sdk.umd.cjs",
   "module": "./dist/powermap-web-sdk.js",
+  "types": "./dist/index.d.ts",
   "exports": {
     ".": {
+      "types": "./dist/index.d.ts",
       "import": "./dist/powermap-web-sdk.js",
       "require": "./dist/powermap-web-sdk.umd.cjs"
     },
@@ -28,6 +31,7 @@
     "three": "^0.162.0"
   },
   "devDependencies": {
-    "vite": "^5.1.4"
+    "vite": "^5.1.4",
+    "vite-plugin-dts": "^5.0.0"
   }
 }