@geoit/ui 0.0.2 → 0.0.5

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

@@ -0,0 +1,53 @@
+import { OnDestroy } from '@angular/core';
+import { GeoMapController } from './geo-map.controller';
+import type { GeoMapBasemapInput, GeoMapClickEvent, GeoMapLayerConfig, GeoMapViewChangeEvent, ProjectionConfig } from './geo-map.types';
+import * as i0 from "@angular/core";
+/**
+ * OpenLayers map host with basemap, typed layers, and GeoMapController.
+ *
+ * @summary OpenLayers map host with basemap, typed layers, and GeoMapController.
+ * @whenToUse Any map viewport (portal quy hoạch, tra cứu thửa). Peers: ol, proj4.
+ * @doNotUseWhen Non-map charting — use dashboard libs.
+ */
+export declare class GeoMapComponent implements OnDestroy {
+    private readonly mapService;
+    private readonly layerService;
+    private readonly projectionService;
+    private readonly viewport;
+    /** Map center in view projection (default Web Mercator Đà Lạt area). */
+    readonly center: import("@angular/core").InputSignal<number[]>;
+    readonly zoom: import("@angular/core").InputSignal<number>;
+    readonly minZoom: import("@angular/core").InputSignal<number>;
+    readonly maxZoom: import("@angular/core").InputSignal<number>;
+    readonly viewProjection: import("@angular/core").InputSignal<string>;
+    readonly basemap: import("@angular/core").InputSignal<GeoMapBasemapInput>;
+    readonly layers: import("@angular/core").InputSignal<GeoMapLayerConfig[]>;
+    readonly height: import("@angular/core").InputSignal<string>;
+    /**
+     * When true, custom projections listed in `projections` are registered before map create.
+     * Built-in EPSG:4326 / EPSG:3857 never need registration.
+     * VN-2000 definitions must be supplied via `projections` — never invented.
+     */
+    readonly registerProjections: import("@angular/core").InputSignal<boolean>;
+    /** Custom CRS definitions (e.g. local VN-2000 from environment). */
+    readonly projections: import("@angular/core").InputSignal<ProjectionConfig[]>;
+    readonly showMousePosition: import("@angular/core").InputSignal<boolean>;
+    readonly mousePositionProjection: import("@angular/core").InputSignal<string>;
+    /** When false, hide built-in OL zoom control (prefer `geo-map-zoom`). */
+    readonly showZoomControl: import("@angular/core").InputSignal<boolean>;
+    readonly mapReady: import("@angular/core").OutputEmitterRef<GeoMapController>;
+    readonly mapClick: import("@angular/core").OutputEmitterRef<GeoMapClickEvent>;
+    readonly viewChange: import("@angular/core").OutputEmitterRef<GeoMapViewChangeEvent>;
+    readonly initError: import("@angular/core").OutputEmitterRef<string>;
+    private controller;
+    private unsubscribers;
+    private initAttempted;
+    private lastSyncedCenterKey;
+    private lastSyncedZoom;
+    private lastSyncedLayersRef;
+    constructor();
+    ngOnDestroy(): void;
+    private bootstrapMap;
+    static ɵfac: i0.ɵɵFactoryDeclaration<GeoMapComponent, never>;
+    static ɵcmp: i0.ɵɵComponentDeclaration<GeoMapComponent, "geo-map", never, { "center": { "alias": "center"; "required": false; "isSignal": true; }; "zoom": { "alias": "zoom"; "required": false; "isSignal": true; }; "minZoom": { "alias": "minZoom"; "required": false; "isSignal": true; }; "maxZoom": { "alias": "maxZoom"; "required": false; "isSignal": true; }; "viewProjection": { "alias": "viewProjection"; "required": false; "isSignal": true; }; "basemap": { "alias": "basemap"; "required": false; "isSignal": true; }; "layers": { "alias": "layers"; "required": false; "isSignal": true; }; "height": { "alias": "height"; "required": false; "isSignal": true; }; "registerProjections": { "alias": "registerProjections"; "required": false; "isSignal": true; }; "projections": { "alias": "projections"; "required": false; "isSignal": true; }; "showMousePosition": { "alias": "showMousePosition"; "required": false; "isSignal": true; }; "mousePositionProjection": { "alias": "mousePositionProjection"; "required": false; "isSignal": true; }; "showZoomControl": { "alias": "showZoomControl"; "required": false; "isSignal": true; }; }, { "mapReady": "mapReady"; "mapClick": "mapClick"; "viewChange": "viewChange"; "initError": "initError"; }, never, never, true, never>;
+}

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

@@ -0,0 +1,73 @@
+import type { GeoMapBasemapOption, GeoMapLayerConfig, GeoMapLegendItem, GeoMapParcelDetail, GeoMapToolbarAction, GeoMapXyzLayerConfig } from './geo-map.types';
+import type { GeoTreeNode } from '../geo-tree/geo-tree.types';
+/** Built-in CRS codes available without custom proj4 registration. */
+export declare const GEO_MAP_BUILTIN_PROJECTIONS: readonly ["EPSG:4326", "EPSG:3857"];
+/**
+ * Default view — Web Mercator around Đà Lạt (Lâm Đồng).
+ * Center is already in EPSG:3857 (do not treat as lon/lat).
+ */
+export declare const GEO_MAP_DEFAULT_CENTER: readonly [number, number];
+export declare const GEO_MAP_DEFAULT_ZOOM = 11;
+export declare const GEO_MAP_DEFAULT_MIN_ZOOM = 2;
+export declare const GEO_MAP_DEFAULT_MAX_ZOOM = 20;
+export declare const GEO_MAP_DEFAULT_VIEW_PROJECTION = "EPSG:3857";
+export declare const GEO_MAP_DEFAULT_HEIGHT = "480px";
+/** Internal layer id reserved for the `basemap` input shortcut. */
+export declare const GEO_MAP_BASEMAP_LAYER_ID = "__geo_basemap";
+/** Internal vector layers reserved for selection / measure / highlight. */
+export declare const GEO_MAP_SELECTION_LAYER_ID = "__geo_selection";
+export declare const GEO_MAP_MEASURE_LAYER_ID = "__geo_measure";
+export declare const GEO_MAP_HIGHLIGHT_LAYER_ID = "__geo_highlight";
+/**
+ * Default province extent (Lâm Đồng approx, EPSG:4326) for “xem toàn tỉnh” (TCQH.14 GD5).
+ * Host apps should override with authoritative boundary extent from API.
+ */
+export declare const GEO_MAP_DEFAULT_PROVINCE_EXTENT_4326: readonly [
+    number,
+    number,
+    number,
+    number
+];
+/** Optional traffic / roads reference overlay (not a planning layer). */
+export declare const GEO_MAP_TRAFFIC_LAYER_ID = "__geo_traffic";
+export declare const GEO_MAP_ESRI_IMAGERY_URL = "https://server.arcgisonline.com/ArcGIS/rest/services/World_Imagery/MapServer/tile/{z}/{y}/{x}";
+export declare const GEO_MAP_ESRI_STREETS_URL = "https://server.arcgisonline.com/ArcGIS/rest/services/World_Street_Map/MapServer/tile/{z}/{y}/{x}";
+export declare const GEO_MAP_ESRI_TRANSPORT_URL = "https://server.arcgisonline.com/ArcGIS/rest/services/Reference/World_Transportation/MapServer/tile/{z}/{y}/{x}";
+/** Default basemap picker options (đường phố / vệ tinh). */
+export declare const GEO_MAP_DEFAULT_BASEMAP_OPTIONS: GeoMapBasemapOption[];
+/** Transportation reference overlay — toggle independently of basemap. */
+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[];
+/**
+ * Demo thematic overlays for Storybook (offline-friendly GeoJSON).
+ * Groups match portal layers popover: QHSDD · địa chính · hiện trạng.
+ */
+export declare const GEO_MAP_DEMO_THEMATIC_LAYERS: GeoMapLayerConfig[];
+/**
+ * Sample legend — placeholder colors until Thông tư 09/2024 palette is complete (Q13–Q15).
+ * Do not treat as legally authoritative.
+ */
+export declare const GEO_MAP_DEMO_LEGEND_ITEMS: GeoMapLegendItem[];
+export declare const GEO_MAP_DEFAULT_HELP_SECTIONS: Array<{
+    title: string;
+    body: string;
+}>;
+/** Demo admin tree (xã) for Storybook — replace via API in production. */
+export declare const GEO_MAP_DEMO_ADMIN_NODES: GeoTreeNode[];
+/** Demo parcel detail for Storybook search/popup (TCQH.12). */
+export declare const GEO_MAP_DEMO_PARCEL_DETAIL: GeoMapParcelDetail;
+/**
+ * Placeholder endpoints — replace via environment / API.
+ * Do not hard-code production domains here.
+ */
+export declare const GEO_MAP_ENV_PLACEHOLDERS: {
+    readonly wmsUrl: "https://{MAP_API_HOST}/geoserver/wms";
+    readonly xyzSatelliteUrl: "https://{TILE_HOST}/satellite/{z}/{x}/{y}.png";
+    readonly geojsonParcelUrl: "https://{MAP_API_HOST}/api/v1/parcels.geojson";
+};
+/**
+ * Example multi-layer stack for land-use planning demos / Storybook.
+ * URLs are placeholders; WMS/XYZ tiles will fail until env is wired.
+ */
+export declare const GEO_MAP_DEFAULT_PLANNING_LAYERS: GeoMapLayerConfig[];

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

@@ -0,0 +1,49 @@
+import type OlMap from 'ol/Map';
+import type { Coordinate } from 'ol/coordinate';
+import type Feature from 'ol/Feature';
+import type Geometry from 'ol/geom/Geometry';
+import type { GeoMapBasemapInput, GeoMapHighlightOptions, GeoMapLayerConfig, GeoMapLayerRuntimeState } from './geo-map.types';
+import type { CreatedMapLayer } from './services/geo-map-layer.service';
+import type { GeoMapService } from './services/geo-map.service';
+import type { GeoMapLayerService } from './services/geo-map-layer.service';
+/**
+ * Public façade emitted via `mapReady`. Keeps OpenLayers Map out of templates
+ * while allowing host features to drive view / layers.
+ */
+export declare class GeoMapController {
+    private readonly mapService;
+    private readonly layerService;
+    constructor(mapService: GeoMapService, layerService: GeoMapLayerService);
+    getMap(): OlMap | null;
+    setCenter(center: Coordinate, zoom?: number): void;
+    setZoom(zoom: number): void;
+    getZoom(): number | undefined;
+    zoomIn(): void;
+    zoomOut(): void;
+    setBasemap(basemap: GeoMapBasemapInput): void;
+    fitExtent(extent: [number, number, number, number], options?: {
+        padding?: number[];
+        maxZoom?: number;
+        duration?: number;
+    }): void;
+    fitLonLatExtent(extent4326: [number, number, number, number], options?: {
+        padding?: number[];
+        maxZoom?: number;
+        duration?: number;
+    }): void;
+    /** Fit province / toàn tỉnh (TCQH.14 GD5) — not browser fullscreen. */
+    fitProvince(extent4326?: readonly [number, number, number, number], options?: {
+        padding?: number[];
+        maxZoom?: number;
+        duration?: number;
+    }): void;
+    setHighlightFromGeoJson(data: object, options?: GeoMapHighlightOptions): void;
+    setHighlightFeatures(features: Feature<Geometry>[], options?: GeoMapHighlightOptions): void;
+    clearHighlight(): void;
+    updateSize(): void;
+    syncLayers(configs: GeoMapLayerConfig[]): void;
+    setLayerVisibility(layerId: string, visible: boolean): void;
+    setLayerOpacity(layerId: string, opacity: number): void;
+    getLayers(): CreatedMapLayer[];
+    getLayerRuntimeStates(): GeoMapLayerRuntimeState[];
+}

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

@@ -0,0 +1,224 @@
+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';
+/** Layer load lifecycle for panel / chrome. */
+export type GeoMapLayerStatus = 'idle' | 'loading' | 'ready' | 'error';
+export interface ProjectionConfig {
+    code: string;
+    /** Full proj4 definition string. Must be supplied by env/API — never invent VN-2000 params. */
+    definition: string;
+    extent?: [number, number, number, number];
+    units?: string;
+}
+export interface GeoMapLayerBase {
+    id: string;
+    title: string;
+    visible?: boolean;
+    /** 0–1 */
+    opacity?: number;
+    zIndex?: number;
+    minZoom?: number;
+    maxZoom?: number;
+    /** Treat as basemap (only one active at a time). */
+    basemap?: boolean;
+    /** Group key for layer panel sections (`base-map`, `qhsdd`, …). */
+    group?: string;
+    /** Display title for the group accordion (falls back to group key). */
+    groupLabel?: string;
+    /** Selection UX within the group: radio (`single`) or checkbox (`multi`). */
+    groupSelection?: 'single' | 'multi';
+    /** Eligible for identify / GetFeatureInfo. */
+    queryable?: boolean;
+    legendUrl?: string;
+    projection?: string;
+    metadata?: Record<string, unknown>;
+}
+export interface GeoMapOsmLayerConfig extends GeoMapLayerBase {
+    type: 'osm';
+}
+export interface GeoMapXyzLayerConfig extends GeoMapLayerBase {
+    type: 'xyz';
+    url: string;
+    attributions?: string | string[];
+    maxZoom?: number;
+    crossOrigin?: string | null;
+}
+export interface GeoMapWmsLayerConfig extends GeoMapLayerBase {
+    type: 'wms';
+    url: string;
+    params: Record<string, string | number | boolean>;
+    serverType?: 'geoserver' | 'mapserver' | 'qgis' | 'carmentaserver';
+    crossOrigin?: string | null;
+    /** Optional WMS layer name when not only in `params.LAYERS`. */
+    layerName?: string;
+}
+export interface GeoMapWmtsLayerConfig extends GeoMapLayerBase {
+    type: 'wmts';
+    url: string;
+    layer: string;
+    matrixSet: string;
+    format?: string;
+    style?: string;
+    projection?: string;
+    crossOrigin?: string | null;
+}
+export interface GeoMapGeoJsonLayerConfig extends GeoMapLayerBase {
+    type: 'geojson';
+    /** Inline GeoJSON object or URL string. */
+    data: object | string;
+    dataProjection?: string;
+    featureProjection?: string;
+}
+export interface GeoMapVectorLayerConfig extends GeoMapLayerBase {
+    type: 'vector';
+    /** Pre-built OL features (app-owned). */
+    features?: Feature<Geometry>[];
+}
+export type GeoMapLayerConfig = GeoMapOsmLayerConfig | GeoMapXyzLayerConfig | GeoMapWmsLayerConfig | GeoMapWmtsLayerConfig | GeoMapGeoJsonLayerConfig | GeoMapVectorLayerConfig;
+export type GeoMapBasemapInput = 'osm' | {
+    type: 'xyz';
+    url: string;
+    attributions?: string | string[];
+    maxZoom?: number;
+    title?: string;
+};
+/** Alias used by basemap switcher output. */
+export type GeoMapBasemap = GeoMapBasemapInput;
+export interface GeoMapBasemapOption {
+    id: string;
+    label: string;
+    basemap: GeoMapBasemap;
+    previewUrl?: string;
+}
+export type GeoMapLocateErrorReason = 'unsupported' | 'denied' | 'unavailable' | 'timeout' | 'unknown';
+export interface GeoMapClickEvent {
+    /** Coordinate in view projection. */
+    coordinate: number[];
+    /** Lon/lat (EPSG:4326) as [longitude, latitude]. */
+    lonLat: [number, number];
+    pixel: [number, number];
+    originalEvent: UIEvent;
+}
+export interface GeoMapViewChangeEvent {
+    center: number[];
+    zoom: number;
+    resolution: number;
+    rotation: number;
+}
+export interface GeoMapLayerVisibilityChange {
+    layerId: string;
+    visible: boolean;
+}
+export interface GeoMapLayerOpacityChange {
+    layerId: string;
+    opacity: number;
+}
+export interface GeoMapLayerRuntimeState {
+    id: string;
+    status: GeoMapLayerStatus;
+    errorMessage?: string;
+}
+export interface GeoMapCoordinate {
+    /** [x, y] or [longitude, latitude] in `projection`. */
+    coordinates: [number, number];
+    projection: string;
+}
+export interface MapInitOptions {
+    target: HTMLElement;
+    center: number[];
+    zoom: number;
+    minZoom: number;
+    maxZoom: number;
+    viewProjection: string;
+}
+export interface GeoMapLegendItem {
+    label: string;
+    /** Optional land-use code (e.g. ONT, SKC). */
+    code?: string;
+    /** CSS color for swatch — prefer design tokens when possible. */
+    color?: string;
+    swatchUrl?: string;
+}
+export type GeoMapMeasureMode = 'none' | 'distance' | 'area';
+export interface GeoMapMeasureResult {
+    mode: Exclude<GeoMapMeasureMode, 'none'>;
+    /** Raw value in meters (distance) or m² (area). */
+    value: number;
+    /** Human-readable label (m/km or m²/ha). */
+    label: string;
+    geometry: Geometry | null;
+}
+export interface GeoMapToolbarAction {
+    id: string;
+    label?: string;
+    /** ng-zorro / geo-icon type (fallback when `iconSrc` is omitted). */
+    icon?: string;
+    /** Exported Figma / static asset URL (prefer over `icon`). */
+    iconSrc?: string;
+    active?: boolean;
+    checked?: boolean;
+    disabled?: boolean;
+    iconOnly?: boolean;
+    tooltip?: string;
+    /** Filled primary control (e.g. Home). */
+    variant?: 'default' | 'primary';
+}
+/** Search modes for portal tra cứu (TCQH.7–11). */
+export type GeoMapSearchMode = 'owner' | 'certificate' | 'coordinates' | 'address' | 'parcel';
+export interface GeoMapSearchQuery {
+    mode: GeoMapSearchMode;
+    /** Field values keyed by mode-specific input ids. */
+    values: Record<string, string>;
+}
+export interface GeoMapSearchResultItem {
+    id: string;
+    title: string;
+    subtitle?: string;
+    /** Lon/lat center for pan (EPSG:4326). */
+    center4326?: [number, number];
+    /** Lon/lat extent for fit (EPSG:4326). */
+    extent4326?: [number, number, number, number];
+    /** Optional GeoJSON Feature / FeatureCollection for map highlight. */
+    geojson?: object;
+    /** Detail payload for `geo-map-parcel-popup`. */
+    parcel?: GeoMapParcelDetail;
+}
+/** Audience controls which parcel fields are shown (TCQH.12). */
+export type GeoMapParcelAudience = 'citizen' | 'specialist';
+export interface GeoMapParcelDetail {
+    /** Mã thửa đất (hiển thị ở Thông tin chung). */
+    parcelCode?: string;
+    parcelNumber?: string;
+    sheetNumber?: string;
+    ward?: string;
+    province?: string;
+    area?: string;
+    legalArea?: string;
+    landUse?: string;
+    address?: string;
+    useForm?: string;
+    registrationStatus?: string;
+    /** Chuyên viên / mở rộng. */
+    shapeInfo?: string;
+    planningInfo?: string;
+    /** Giá đất — mặc định UI hiện «Đang cập nhật» nếu trống. */
+    landPrice?: string;
+    /** URL ảnh sơ đồ thửa (tuỳ chọn). */
+    diagramUrl?: string;
+    /** Extra rows when host needs more fields. */
+    extraFields?: Array<{
+        label: string;
+        value: string;
+    }>;
+}
+export interface GeoMapHighlightOptions {
+    dataProjection?: string;
+    /** Fit view to highlight extent (default true when features exist). */
+    fit?: boolean;
+    fitOptions?: {
+        padding?: number[];
+        maxZoom?: number;
+        duration?: number;
+    };
+}

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

@@ -0,0 +1,42 @@
+import type BaseLayer from 'ol/layer/Base';
+import type { GeoMapBasemapInput, GeoMapLayerConfig, GeoMapLayerRuntimeState } from '../geo-map.types';
+import * as i0 from "@angular/core";
+export interface CreatedMapLayer {
+    id: string;
+    config: GeoMapLayerConfig;
+    layer: BaseLayer;
+}
+/**
+ * Builds and incrementally patches OpenLayers layers from typed configs.
+ * Visibility / opacity updates must not recreate sources.
+ */
+export declare class GeoMapLayerService {
+    private readonly projection;
+    private readonly runtime;
+    getRuntimeState(layerId: string): GeoMapLayerRuntimeState | undefined;
+    getAllRuntimeStates(): GeoMapLayerRuntimeState[];
+    createFromBasemapInput(basemap: GeoMapBasemapInput): CreatedMapLayer;
+    createLayer(config: GeoMapLayerConfig): CreatedMapLayer;
+    /**
+     * Apply visibility/opacity/zIndex without recreating the OL layer.
+     * Returns true when structural fields changed and the layer should be recreated.
+     */
+    needsRecreate(previous: GeoMapLayerConfig, next: GeoMapLayerConfig): boolean;
+    patchLayer(layer: BaseLayer, config: GeoMapLayerConfig): void;
+    setVisible(layer: BaseLayer, visible: boolean): void;
+    setOpacity(layer: BaseLayer, opacity: number): void;
+    getLayerId(layer: BaseLayer): string | undefined;
+    isBasemap(layer: BaseLayer): boolean;
+    resolveBasemapExclusive(layers: CreatedMapLayer[], activeBasemapId: string): void;
+    private validateConfig;
+    private applyCommonOptions;
+    private wireSourceStatus;
+    private createOsmLayer;
+    private createXyzLayer;
+    private createWmsLayer;
+    private createWmtsLayer;
+    private createGeoJsonLayer;
+    private createVectorLayer;
+    static ɵfac: i0.ɵɵFactoryDeclaration<GeoMapLayerService, never>;
+    static ɵprov: i0.ɵɵInjectableDeclaration<GeoMapLayerService>;
+}

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

@@ -0,0 +1,32 @@
+import type { ProjectionConfig } from '../geo-map.types';
+import * as i0 from "@angular/core";
+export declare class GeoMapProjectionError extends Error {
+    constructor(message: string);
+}
+/**
+ * Central proj4 / OpenLayers projection registration and transforms.
+ * Keep all CRS logic here — components must not call proj4 directly.
+ */
+export declare class GeoMapProjectionService {
+    private readonly registeredCodes;
+    isRegistered(code: string): boolean;
+    /**
+     * Register a custom CRS (e.g. local VN-2000). Definition must come from config/API.
+     */
+    registerProjection(config: ProjectionConfig): void;
+    ensureRegistered(code: string): void;
+    /**
+     * Transform a coordinate. Order is always [x, y] / [longitude, latitude].
+     */
+    transformCoordinate(coordinate: [number, number] | number[], fromProjection: string, toProjection: string): [number, number];
+    transformExtent(extent: [number, number, number, number], fromProjection: string, toProjection: string): [number, number, number, number];
+    /**
+     * Normalize user input: trim, upper-case EPSG codes, reject non-finite numbers.
+     */
+    normalizeCoordinate(value: unknown, options?: {
+        label?: string;
+    }): [number, number];
+    normalizeCode(code: string): string;
+    static ɵfac: i0.ɵɵFactoryDeclaration<GeoMapProjectionService, never>;
+    static ɵprov: i0.ɵɵInjectableDeclaration<GeoMapProjectionService>;
+}

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

@@ -0,0 +1,99 @@
+import OlMap from 'ol/Map';
+import type { Coordinate } from 'ol/coordinate';
+import type Feature from 'ol/Feature';
+import type Geometry from 'ol/geom/Geometry';
+import type { GeoMapBasemapInput, GeoMapClickEvent, GeoMapHighlightOptions, GeoMapLayerConfig, GeoMapViewChangeEvent, MapInitOptions } from '../geo-map.types';
+import { CreatedMapLayer } from './geo-map-layer.service';
+import * as i0 from "@angular/core";
+export interface GeoMapCreateOptions extends MapInitOptions {
+    basemap?: GeoMapBasemapInput;
+    layers?: GeoMapLayerConfig[];
+    /** Show OL MousePosition control (raw; UI chrome may wrap later). */
+    showMousePosition?: boolean;
+    mousePositionProjection?: string;
+    /** When false, hide built-in OL zoom (use `geo-map-zoom` instead). */
+    showZoomControl?: boolean;
+}
+/**
+ * Owns a single OpenLayers Map instance for the providing component injector.
+ * Do not put Map/Layer objects into Angular template state.
+ */
+export declare class GeoMapService {
+    private readonly layerService;
+    private readonly projection;
+    private map;
+    private managedLayers;
+    private listenerKeys;
+    private resizeObserver;
+    private resizeCleanup;
+    private activeBasemapId;
+    private highlightLayer;
+    private highlightSource;
+    getMap(): OlMap | null;
+    isInitialized(): boolean;
+    init(options: GeoMapCreateOptions): OlMap;
+    /**
+     * Sync layer stack with configs. Preserves OL layers when only visibility/opacity change.
+     */
+    syncLayers(configs: GeoMapLayerConfig[], options?: {
+        replaceBasemapShortcut?: boolean;
+    }): void;
+    setLayerVisibility(layerId: string, visible: boolean): void;
+    setLayerOpacity(layerId: string, opacity: number): void;
+    getManagedLayers(): CreatedMapLayer[];
+    setCenter(center: Coordinate, zoom?: number): void;
+    setZoom(zoom: number): void;
+    getZoom(): number | undefined;
+    zoomBy(delta: number): void;
+    /** Replace the shortcut basemap layer (`GEO_MAP_BASEMAP_LAYER_ID`). */
+    setBasemap(basemap: GeoMapBasemapInput): void;
+    fitExtent(extent: [number, number, number, number], options?: {
+        padding?: number[];
+        maxZoom?: number;
+        duration?: number;
+    }): void;
+    /** Fit lon/lat extent (EPSG:4326) after transforming to the active view projection. */
+    fitLonLatExtent(extent4326: [number, number, number, number], options?: {
+        padding?: number[];
+        maxZoom?: number;
+        duration?: number;
+    }): void;
+    /**
+     * Fit the default (or provided) province extent — TCQH.14 “xem toàn tỉnh”.
+     * Distinct from browser fullscreen (TCQH.15).
+     */
+    fitProvince(extent4326?: readonly [number, number, number, number], options?: {
+        padding?: number[];
+        maxZoom?: number;
+        duration?: number;
+    }): void;
+    /**
+     * Highlight search / select results (TCQH.7–12). Pass GeoJSON Feature or FeatureCollection.
+     */
+    setHighlightFromGeoJson(data: object, options?: GeoMapHighlightOptions): void;
+    setHighlightFeatures(features: Feature<Geometry>[], options?: GeoMapHighlightOptions): void;
+    clearHighlight(): void;
+    updateSize(): void;
+    onClick(handler: (event: GeoMapClickEvent) => void): () => void;
+    /**
+     * Emit after the view settles (`moveend`), not on every resolution tick —
+     * continuous emitters flood Storybook Actions / host bindings and cause UI flicker.
+     */
+    onViewChange(handler: (event: GeoMapViewChangeEvent) => void): () => void;
+    /**
+     * Tear down map, listeners, and resize observer. Safe to call multiple times.
+     */
+    destroy(): void;
+    private ensureHighlightLayer;
+    private createHighlightStyle;
+    /** Inline SVG map pin for clicked / selected points. */
+    private createPinIconDataUri;
+    /** Resolve a design token for OpenLayers canvas styles. */
+    private cssColor;
+    private withAlpha;
+    private addManagedLayer;
+    private enforceSingleBasemap;
+    private observeResize;
+    static ɵfac: i0.ɵɵFactoryDeclaration<GeoMapService, never>;
+    static ɵprov: i0.ɵɵInjectableDeclaration<GeoMapService>;
+}

package/lib/figma/geo-map/utils/geo-map-fullscreen-overlay.util.d.ts

@@ -0,0 +1,13 @@
+import type { OverlayContainer } from '@angular/cdk/overlay';
+/**
+ * CDK / ng-zorro overlays (drawer, dropdown, tooltip, modal) mount under
+ * `.cdk-overlay-container` on `document.body`. While an ancestor is in
+ * Fullscreen API mode, only its descendants are painted — so overlays on
+ * `body` become invisible / untouchable.
+ *
+ * Call on `fullscreenchange` to move the overlay container into the
+ * fullscreen element, then restore to `body` when exiting.
+ */
+export declare function syncOverlayContainerToFullscreen(overlayContainer: OverlayContainer, scopeRoot?: HTMLElement | null): void;
+/** Always put the CDK overlay host back on `document.body`. */
+export declare function restoreOverlayContainerToBody(overlayContainer: OverlayContainer): void;

package/lib/figma/geo-map/utils/geo-map-interactions.util.d.ts

@@ -0,0 +1,9 @@
+import type OlMap from 'ol/Map';
+/**
+ * Temporarily disables map navigation interactions that conflict with
+ * Draw / DragBox tools. Call `resume()` when the tool ends.
+ */
+export declare function pauseConflictingInteractions(map: OlMap, options?: {
+    dragPan?: boolean;
+    doubleClickZoom?: boolean;
+}): () => void;

package/lib/figma/geo-overlap-result/geo-overlap-result.component.d.ts

@@ -0,0 +1,18 @@
+import type { GeoOverlapResultRow } from './geo-overlap-result.types';
+import * as i0 from "@angular/core";
+/**
+ * Planning overlap analysis result table (TCQH.27).
+ *
+ * @summary Bảng kết quả phân tích chồng lấn quy hoạch (diện tích giao / %).
+ * @whenToUse Màn Phân tích chồng lấn — kết quả sau khi chạy phân tích.
+ * @doNotUseWhen Generic CRUD lists — use geo-table.
+ */
+export declare class GeoOverlapResultComponent {
+    readonly title: import("@angular/core").InputSignal<string>;
+    readonly rows: import("@angular/core").InputSignal<GeoOverlapResultRow[]>;
+    readonly areaUnit: import("@angular/core").InputSignal<string>;
+    readonly emptyText: import("@angular/core").InputSignal<string>;
+    readonly rowClick: import("@angular/core").OutputEmitterRef<GeoOverlapResultRow>;
+    static ɵfac: i0.ɵɵFactoryDeclaration<GeoOverlapResultComponent, never>;
+    static ɵcmp: i0.ɵɵComponentDeclaration<GeoOverlapResultComponent, "geo-overlap-result", never, { "title": { "alias": "title"; "required": false; "isSignal": true; }; "rows": { "alias": "rows"; "required": false; "isSignal": true; }; "areaUnit": { "alias": "areaUnit"; "required": false; "isSignal": true; }; "emptyText": { "alias": "emptyText"; "required": false; "isSignal": true; }; }, { "rowClick": "rowClick"; }, never, never, true, never>;
+}

package/lib/figma/geo-overlap-result/geo-overlap-result.types.d.ts

@@ -0,0 +1,7 @@
+export interface GeoOverlapResultRow {
+    id: string;
+    planningType: string;
+    intersectionArea: number | string;
+    percent: number | string;
+    color?: string;
+}

package/lib/figma/geo-page-header/geo-page-header.component.d.ts

@@ -0,0 +1,16 @@
+import type { GeoBreadcrumbItem } from '../geo-breadcrumb/geo-breadcrumb.types';
+import * as i0 from "@angular/core";
+/**
+ * List / admin page chrome: breadcrumb + title + action / filter slots.
+ *
+ * @summary Header trang danh sách / quản trị / thống kê.
+ * @whenToUse Đầu trang ngoài màn bản đồ (dashboard, QL người dùng, thống kê).
+ * @doNotUseWhen Map chrome — use geo-map-shell tools.
+ */
+export declare class GeoPageHeaderComponent {
+    readonly title: import("@angular/core").InputSignal<string>;
+    readonly breadcrumb: import("@angular/core").InputSignal<GeoBreadcrumbItem[]>;
+    readonly uppercase: import("@angular/core").InputSignal<boolean>;
+    static ɵfac: i0.ɵɵFactoryDeclaration<GeoPageHeaderComponent, never>;
+    static ɵcmp: i0.ɵɵComponentDeclaration<GeoPageHeaderComponent, "geo-page-header", never, { "title": { "alias": "title"; "required": false; "isSignal": true; }; "breadcrumb": { "alias": "breadcrumb"; "required": false; "isSignal": true; }; "uppercase": { "alias": "uppercase"; "required": false; "isSignal": true; }; }, {}, never, ["[geoPageActions]", "[geoPageFilters]"], true, never>;
+}