@geoit/ui 0.1.0 → 0.2.0

package/lib/figma/geo-map/chrome/geo-map-locate/geo-map-locate.util.d.ts

@@ -0,0 +1,16 @@
+import { GeoMapController } from '../../geo-map.controller';
+import type { GeoMapLocateErrorReason } from '../../geo-map.types';
+export interface GeoMapLocateCallbacks {
+    onLocated?: (lonLat: [number, number]) => void;
+    onDenied?: () => void;
+    onError?: (error: {
+        reason: GeoMapLocateErrorReason;
+        message?: string;
+    }) => void;
+}
+/**
+ * Shared browser-geolocation trigger — centers `ctrl` on the user and reports the outcome.
+ * Used by both `geo-map-locate` (standalone button) and `geo-map-shell`'s built-in locate
+ * toolbar action so the two never drift on error-reason mapping.
+ */
+export declare function runGeoMapLocate(ctrl: GeoMapController, callbacks: GeoMapLocateCallbacks): void;

package/lib/figma/geo-map/chrome/geo-map-shell/geo-map-shell.component.d.ts

@@ -1,6 +1,6 @@
 import { GeoMapController } from '../../geo-map.controller';
 import type { GeoTreeNode } from '../../../geo-tree/geo-tree.types';
-import type { GeoMapBasemap, GeoMapBasemapOption, GeoMapClickEvent, GeoMapLayerConfig, GeoMapLegendItem, GeoMapMeasureMode, GeoMapParcelAudience, GeoMapParcelDetail, GeoMapSearchQuery, GeoMapSearchResultItem, GeoMapToolbarAction } from '../../geo-map.types';
+import type { GeoMapBasemap, GeoMapBasemapOption, GeoMapClickEvent, GeoMapLayerConfig, GeoMapLegendItem, GeoMapLocateErrorReason, GeoMapMeasureMode, GeoMapParcelAudience, GeoMapParcelDetail, GeoMapSearchQuery, GeoMapSearchResultItem, GeoMapToolbarAction } from '../../geo-map.types';
 import * as i0 from "@angular/core";
 /**
  * Map viewport + portal chrome (toolbar, layers drawer, legend, help, swipe, …).
@@ -22,6 +22,8 @@ export declare class GeoMapShellComponent {
     /** Extra overlays merged after demo thematic + traffic. */
     readonly layers: import("@angular/core").InputSignal<GeoMapLayerConfig[]>;
     readonly legendItems: import("@angular/core").InputSignal<GeoMapLegendItem[]>;
+    /** Host app sets true when the legend catalog (loại đất/ký hiệu/màu) failed to load. */
+    readonly legendCatalogMissing: import("@angular/core").InputSignal<boolean>;
     readonly showNav: import("@angular/core").InputSignal<boolean>;
     readonly includeDemoLayers: import("@angular/core").InputSignal<boolean>;
     readonly adminNodes: import("@angular/core").InputSignal<GeoTreeNode[]>;
@@ -52,7 +54,12 @@ export declare class GeoMapShellComponent {
     readonly adminExpandedKeys: import("@angular/core").ModelSignal<(string | number)[]>;
     readonly mapReady: import("@angular/core").OutputEmitterRef<GeoMapController>;
     readonly mapClick: import("@angular/core").OutputEmitterRef<GeoMapClickEvent>;
+    readonly located: import("@angular/core").OutputEmitterRef<void>;
     readonly locateDenied: import("@angular/core").OutputEmitterRef<void>;
+    readonly locateError: import("@angular/core").OutputEmitterRef<{
+        reason: GeoMapLocateErrorReason;
+        message?: string;
+    }>;
     readonly actionClick: import("@angular/core").OutputEmitterRef<GeoMapToolbarAction>;
     readonly search: import("@angular/core").OutputEmitterRef<GeoMapSearchQuery>;
     readonly searchReset: import("@angular/core").OutputEmitterRef<void>;
@@ -93,11 +100,13 @@ export declare class GeoMapShellComponent {
     private enterPanMode;
     private exitToolMode;
     private applyPanCursor;
+    /** Backing action for the `locate` toolbar entry (`GEO_MAP_LOCATE_TOOLBAR_ACTION`). */
+    private triggerLocate;
     private setMapCursor;
     private bindPanCursor;
     private unbindPanCursor;
     private buildDemoSearchResults;
     private ensureSwipeOverlayVisible;
     static ɵfac: i0.ɵɵFactoryDeclaration<GeoMapShellComponent, never>;
-    static ɵcmp: i0.ɵɵComponentDeclaration<GeoMapShellComponent, "geo-map-shell", never, { "center": { "alias": "center"; "required": false; "isSignal": true; }; "zoom": { "alias": "zoom"; "required": false; "isSignal": true; }; "height": { "alias": "height"; "required": false; "isSignal": true; }; "showMousePosition": { "alias": "showMousePosition"; "required": false; "isSignal": true; }; "basemapOptions": { "alias": "basemapOptions"; "required": false; "isSignal": true; }; "toolbarActions": { "alias": "toolbarActions"; "required": false; "isSignal": true; }; "layers": { "alias": "layers"; "required": false; "isSignal": true; }; "legendItems": { "alias": "legendItems"; "required": false; "isSignal": true; }; "showNav": { "alias": "showNav"; "required": false; "isSignal": true; }; "includeDemoLayers": { "alias": "includeDemoLayers"; "required": false; "isSignal": true; }; "adminNodes": { "alias": "adminNodes"; "required": false; "isSignal": true; }; "locationLabel": { "alias": "locationLabel"; "required": false; "isSignal": true; }; "parcelAudience": { "alias": "parcelAudience"; "required": false; "isSignal": true; }; "provinceExtent": { "alias": "provinceExtent"; "required": false; "isSignal": true; }; "demoSearch": { "alias": "demoSearch"; "required": false; "isSignal": true; }; "homeMode": { "alias": "homeMode"; "required": false; "isSignal": true; }; "basemapId": { "alias": "basemapId"; "required": false; "isSignal": true; }; "measureMode": { "alias": "measureMode"; "required": false; "isSignal": true; }; "checkedMap": { "alias": "checkedMap"; "required": false; "isSignal": true; }; "layersOpen": { "alias": "layersOpen"; "required": false; "isSignal": true; }; "legendOpen": { "alias": "legendOpen"; "required": false; "isSignal": true; }; "helpOpen": { "alias": "helpOpen"; "required": false; "isSignal": true; }; "swipeActive": { "alias": "swipeActive"; "required": false; "isSignal": true; }; "searchOpen": { "alias": "searchOpen"; "required": false; "isSignal": true; }; "adminFilterOpen": { "alias": "adminFilterOpen"; "required": false; "isSignal": true; }; "parcelOpen": { "alias": "parcelOpen"; "required": false; "isSignal": true; }; "managedLayers": { "alias": "managedLayers"; "required": false; "isSignal": true; }; "searchResults": { "alias": "searchResults"; "required": false; "isSignal": true; }; "selectedParcel": { "alias": "selectedParcel"; "required": false; "isSignal": true; }; "adminCheckedKeys": { "alias": "adminCheckedKeys"; "required": false; "isSignal": true; }; "adminExpandedKeys": { "alias": "adminExpandedKeys"; "required": false; "isSignal": true; }; }, { "basemapId": "basemapIdChange"; "measureMode": "measureModeChange"; "checkedMap": "checkedMapChange"; "layersOpen": "layersOpenChange"; "legendOpen": "legendOpenChange"; "helpOpen": "helpOpenChange"; "swipeActive": "swipeActiveChange"; "searchOpen": "searchOpenChange"; "adminFilterOpen": "adminFilterOpenChange"; "parcelOpen": "parcelOpenChange"; "managedLayers": "managedLayersChange"; "searchResults": "searchResultsChange"; "selectedParcel": "selectedParcelChange"; "adminCheckedKeys": "adminCheckedKeysChange"; "adminExpandedKeys": "adminExpandedKeysChange"; "mapReady": "mapReady"; "mapClick": "mapClick"; "locateDenied": "locateDenied"; "actionClick": "actionClick"; "search": "search"; "searchReset": "searchReset"; "resultSelect": "resultSelect"; "parcelExport": "parcelExport"; "adminApply": "adminApply"; }, never, ["[geoMapShellTopRight]"], true, never>;
+    static ɵcmp: i0.ɵɵComponentDeclaration<GeoMapShellComponent, "geo-map-shell", never, { "center": { "alias": "center"; "required": false; "isSignal": true; }; "zoom": { "alias": "zoom"; "required": false; "isSignal": true; }; "height": { "alias": "height"; "required": false; "isSignal": true; }; "showMousePosition": { "alias": "showMousePosition"; "required": false; "isSignal": true; }; "basemapOptions": { "alias": "basemapOptions"; "required": false; "isSignal": true; }; "toolbarActions": { "alias": "toolbarActions"; "required": false; "isSignal": true; }; "layers": { "alias": "layers"; "required": false; "isSignal": true; }; "legendItems": { "alias": "legendItems"; "required": false; "isSignal": true; }; "legendCatalogMissing": { "alias": "legendCatalogMissing"; "required": false; "isSignal": true; }; "showNav": { "alias": "showNav"; "required": false; "isSignal": true; }; "includeDemoLayers": { "alias": "includeDemoLayers"; "required": false; "isSignal": true; }; "adminNodes": { "alias": "adminNodes"; "required": false; "isSignal": true; }; "locationLabel": { "alias": "locationLabel"; "required": false; "isSignal": true; }; "parcelAudience": { "alias": "parcelAudience"; "required": false; "isSignal": true; }; "provinceExtent": { "alias": "provinceExtent"; "required": false; "isSignal": true; }; "demoSearch": { "alias": "demoSearch"; "required": false; "isSignal": true; }; "homeMode": { "alias": "homeMode"; "required": false; "isSignal": true; }; "basemapId": { "alias": "basemapId"; "required": false; "isSignal": true; }; "measureMode": { "alias": "measureMode"; "required": false; "isSignal": true; }; "checkedMap": { "alias": "checkedMap"; "required": false; "isSignal": true; }; "layersOpen": { "alias": "layersOpen"; "required": false; "isSignal": true; }; "legendOpen": { "alias": "legendOpen"; "required": false; "isSignal": true; }; "helpOpen": { "alias": "helpOpen"; "required": false; "isSignal": true; }; "swipeActive": { "alias": "swipeActive"; "required": false; "isSignal": true; }; "searchOpen": { "alias": "searchOpen"; "required": false; "isSignal": true; }; "adminFilterOpen": { "alias": "adminFilterOpen"; "required": false; "isSignal": true; }; "parcelOpen": { "alias": "parcelOpen"; "required": false; "isSignal": true; }; "managedLayers": { "alias": "managedLayers"; "required": false; "isSignal": true; }; "searchResults": { "alias": "searchResults"; "required": false; "isSignal": true; }; "selectedParcel": { "alias": "selectedParcel"; "required": false; "isSignal": true; }; "adminCheckedKeys": { "alias": "adminCheckedKeys"; "required": false; "isSignal": true; }; "adminExpandedKeys": { "alias": "adminExpandedKeys"; "required": false; "isSignal": true; }; }, { "basemapId": "basemapIdChange"; "measureMode": "measureModeChange"; "checkedMap": "checkedMapChange"; "layersOpen": "layersOpenChange"; "legendOpen": "legendOpenChange"; "helpOpen": "helpOpenChange"; "swipeActive": "swipeActiveChange"; "searchOpen": "searchOpenChange"; "adminFilterOpen": "adminFilterOpenChange"; "parcelOpen": "parcelOpenChange"; "managedLayers": "managedLayersChange"; "searchResults": "searchResultsChange"; "selectedParcel": "selectedParcelChange"; "adminCheckedKeys": "adminCheckedKeysChange"; "adminExpandedKeys": "adminExpandedKeysChange"; "mapReady": "mapReady"; "mapClick": "mapClick"; "located": "located"; "locateDenied": "locateDenied"; "locateError": "locateError"; "actionClick": "actionClick"; "search": "search"; "searchReset": "searchReset"; "resultSelect": "resultSelect"; "parcelExport": "parcelExport"; "adminApply": "adminApply"; }, never, ["[geoMapShellTopRight]"], true, never>;
 }

package/lib/figma/geo-map/geo-map.constants.d.ts

@@ -39,6 +39,12 @@ export declare const GEO_MAP_DEFAULT_BASEMAP_OPTIONS: GeoMapBasemapOption[];
 export declare const GEO_MAP_TRAFFIC_OVERLAY: GeoMapXyzLayerConfig;
 /** Built-in toolbar actions — Figma map chrome (Dat Dai Lam Dong 2026). */
 export declare const GEO_MAP_DEFAULT_TOOLBAR_ACTIONS: GeoMapToolbarAction[];
+/**
+ * Built-in "Vị trí của tôi" toolbar action — pair with `id: 'locate'` handling that
+ * `geo-map-shell` already resolves internally (geolocate + emit `located`/`locateError`).
+ * Not included in `GEO_MAP_DEFAULT_TOOLBAR_ACTIONS`; host apps opt in explicitly.
+ */
+export declare const GEO_MAP_LOCATE_TOOLBAR_ACTION: GeoMapToolbarAction;
 /**
  * Demo thematic overlays for Storybook (offline-friendly GeoJSON).
  * Groups match portal layers popover: QHSDD · địa chính · hiện trạng.

package/lib/figma/geo-map/geo-map.types.d.ts

@@ -1,7 +1,7 @@
 import type Feature from 'ol/Feature';
 import type Geometry from 'ol/geom/Geometry';
 /** Supported map layer source kinds. */
-export type GeoMapLayerType = 'osm' | 'xyz' | 'wms' | 'wmts' | 'vector' | 'geojson';
+export type GeoMapLayerType = 'osm' | 'xyz' | 'wms' | 'wmts' | 'vector' | 'geojson' | 'mapbox-style';
 /** Layer load lifecycle for panel / chrome. */
 export type GeoMapLayerStatus = 'idle' | 'loading' | 'ready' | 'error';
 export interface ProjectionConfig {
@@ -75,13 +75,31 @@ export interface GeoMapVectorLayerConfig extends GeoMapLayerBase {
     /** Pre-built OL features (app-owned). */
     features?: Feature<Geometry>[];
 }
-export type GeoMapLayerConfig = GeoMapOsmLayerConfig | GeoMapXyzLayerConfig | GeoMapWmsLayerConfig | GeoMapWmtsLayerConfig | GeoMapGeoJsonLayerConfig | GeoMapVectorLayerConfig;
+/**
+ * Vector basemap driven by a Mapbox/MapLibre style document, applied via `ol-mapbox-style`.
+ * One of `styleJson`/`styleUrl` is required. `transformRequest` is forwarded verbatim to
+ * `ol-mapbox-style` — the library never inspects or stores it, so host-app auth headers
+ * (e.g. an API key) stay owned by the app, not the library.
+ */
+export interface GeoMapMapboxStyleLayerConfig extends GeoMapLayerBase {
+    type: 'mapbox-style';
+    styleJson?: Record<string, unknown>;
+    styleUrl?: string;
+    transformRequest?: (url: string, resourceType: string) => Request | void;
+}
+export type GeoMapLayerConfig = GeoMapOsmLayerConfig | GeoMapXyzLayerConfig | GeoMapWmsLayerConfig | GeoMapWmtsLayerConfig | GeoMapGeoJsonLayerConfig | GeoMapVectorLayerConfig | GeoMapMapboxStyleLayerConfig;
 export type GeoMapBasemapInput = 'osm' | {
     type: 'xyz';
     url: string;
     attributions?: string | string[];
     maxZoom?: number;
     title?: string;
+} | {
+    type: 'mapbox-style';
+    styleJson?: Record<string, unknown>;
+    styleUrl?: string;
+    title?: string;
+    transformRequest?: (url: string, resourceType: string) => Request | void;
 };
 /** Alias used by basemap switcher output. */
 export type GeoMapBasemap = GeoMapBasemapInput;

package/lib/figma/geo-map/services/geo-map-layer.service.d.ts

@@ -37,6 +37,7 @@ export declare class GeoMapLayerService {
     private createWmtsLayer;
     private createGeoJsonLayer;
     private createVectorLayer;
+    private createMapboxStyleLayer;
     static ɵfac: i0.ɵɵFactoryDeclaration<GeoMapLayerService, never>;
     static ɵprov: i0.ɵɵInjectableDeclaration<GeoMapLayerService>;
 }

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@geoit/ui",
-  "version": "0.1.0",
+  "version": "0.2.0",
   "description": "GEO UI — Angular 18 + ng-zorro design system components",
   "peerDependencies": {
     "@angular/animations": "^18.2.0",
@@ -11,6 +11,7 @@
     "@ant-design/icons-angular": "^18.0.0",
     "ng-zorro-antd": "^18.2.0",
     "ol": "^10.0.0",
+    "ol-mapbox-style": "^13.4.3",
     "proj4": "^2.11.0"
   },
   "dependencies": {