@aapicoits/powermap-web-sdk 1.2.3 → 1.2.4

package/README.md

@@ -148,7 +148,8 @@ When creating a `new PowerMap(options)`, the following options are available:
 | `center` | `[lng, lat]` | `[100, 13]` | No | The initial center point of the map. |
 | `zoom` | `number` | `14` | No | Total zoom level (0-22). |
 | `baseUrl` | `string` | - | No | Optional proxy URL (e.g., `/api/proxy`). If set, the SDK will route all API requests through this URL. |
-| `maptilerKey` | `string` | - | No | Your MapTiler API Key. Required if you intend to use high-resolution satellite layers. |
+| `style` | `string` | `'th'` | No | Initial map style theme (`'th'`, `'en'`, `'dark'`, `'gray'`, `'satellite'`, or custom URL). |
+| `maptilerKey` | `string` | - | No | Optional MapTiler API Key (legacy fallback). |
 | `previewOnly` | `boolean` | `false` | No | If **true**, the map will be non-interactive (no zoom, pan, rotate, or pitch). Perfect for static map previews. |
 
 ### Core Instance Methods
@@ -160,7 +161,7 @@ These methods are available on the `PowerMap` instance to manage the map state a
 | `on(event, cb)` | `string, function` | Subscribe to any map event (see Section 9). |
 | `off(event, cb)` | `string, function` | Unsubscribe from a previously registered event. |
 | `setMode(mode, opts)` | `string, Object` | Switch between `'standard'` and `'indoor'` modes. |
-| `setStyle(name)` | `string` | Change the map style (e.g., `'th'`, `'dark'`). |
+| `setStyle(name)` | `string` | Change the map style (e.g., `'th'`, `'en'`, `'dark'`, `'gray'`, `'satellite'`). |
 | `setNavigationControl(opts)` | `boolean\|Object` | Enable/disable or customize zoom/compass controls. |
 | `setFullscreenControl(opts)` | `boolean\|Object` | Enable/disable fullscreen control. |
 | `debug()` | - | Access the Debug Manager for telemetry and performance tools. |
@@ -552,8 +553,8 @@ map.hideLayer('pm-road-vt');
 await map.toggleLayer('pm-road-vt');
 ```
 
-> [!IMPORTANT]
-> **Satellite Layer**: High-resolution satellite imagery (`pm-maptiler-satellite-layer`) requires a `maptilerKey` provided in the initial `PowerMap` configuration.
+> [!TIP]
+> **Satellite Layer**: High-resolution satellite imagery is natively supported by PowerMap (`pm-satellite-layer`). You can enable it as a basemap via `map.setStyle('satellite')` or as an overlay layer via `map.layers.show('pm-satellite-layer')` (or `map.showLayer('satellite')`). It uses your standard `mapApiKey`.
 
 ---
 

package/dist/index.d.ts

@@ -19,8 +19,8 @@ export interface PowerMapOptions {
   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;
+  /** Map style name: 'th' | 'en' | 'dark' | 'gray' | 'satellite' or a custom style URL */
+  style?: 'th' | 'en' | 'dark' | 'gray' | 'satellite' | string;
   /** API Key for map tiles */
   mapApiKey: string;
   /** Authentication credentials for services */
@@ -337,7 +337,7 @@ export declare class PowerMap {
   onError(callback: (error: Error) => void): this;
 
   // --- Map Style & Mode ---
-  setStyle(name: 'th' | 'en' | 'dark' | 'gray' | string): this;
+  setStyle(name: 'th' | 'en' | 'dark' | 'gray' | 'satellite' | string): this;
   setMode(mode: PowerMapMode, options?: SetModeOptions): this;
 
   // --- Controls ---