@geoit/ui 0.0.6 → 0.0.8

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

@@ -32,6 +32,15 @@ export declare class GeoChartComponent {
         percent: number;
     }[]>;
     colorOf(item: GeoChartDatum, index: number): string;
+    /**
+     * `@for` track dùng qua method thay vì `item.id ?? item.label` trực tiếp trong template —
+     * Angular linker (18.2.14) sinh sai scope biến tạm cho track expression chứa `??` khi bị
+     * hoist lên module scope, gây `ReferenceError: tmp_x_0 is not defined` lúc chạy.
+     */
+    trackDatum(item: GeoChartDatum): string;
+    trackSegment(seg: {
+        datum: GeoChartDatum;
+    }): string;
     barWidth(value: number): string;
     setSort(next: GeoChartSort): void;
     onSegment(datum: GeoChartDatum, index: number): void;

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

@@ -11,6 +11,8 @@ export declare class GeoMapAdminFilterComponent {
     readonly open: import("@angular/core").ModelSignal<boolean>;
     readonly title: import("@angular/core").InputSignal<string>;
     readonly nodes: import("@angular/core").InputSignal<GeoTreeNode[]>;
+    /** `single` — chọn đúng 1 xã/phường (BR-06-03); `multi` — checkbox nhiều cấp (mặc định). */
+    readonly selectionMode: import("@angular/core").InputSignal<"multi" | "single">;
     readonly checkedKeys: import("@angular/core").ModelSignal<(string | number)[]>;
     readonly expandedKeys: import("@angular/core").ModelSignal<(string | number)[]>;
     readonly apply: import("@angular/core").OutputEmitterRef<(string | number)[]>;
@@ -24,5 +26,5 @@ export declare class GeoMapAdminFilterComponent {
     onFitProvince(): void;
     close(): void;
     static ɵfac: i0.ɵɵFactoryDeclaration<GeoMapAdminFilterComponent, never>;
-    static ɵcmp: i0.ɵɵComponentDeclaration<GeoMapAdminFilterComponent, "geo-map-admin-filter", never, { "open": { "alias": "open"; "required": false; "isSignal": true; }; "title": { "alias": "title"; "required": false; "isSignal": true; }; "nodes": { "alias": "nodes"; "required": false; "isSignal": true; }; "checkedKeys": { "alias": "checkedKeys"; "required": false; "isSignal": true; }; "expandedKeys": { "alias": "expandedKeys"; "required": false; "isSignal": true; }; }, { "open": "openChange"; "checkedKeys": "checkedKeysChange"; "expandedKeys": "expandedKeysChange"; "apply": "apply"; "reset": "reset"; "fitProvince": "fitProvince"; "closed": "closed"; "selectionChange": "selectionChange"; }, never, never, true, never>;
+    static ɵcmp: i0.ɵɵComponentDeclaration<GeoMapAdminFilterComponent, "geo-map-admin-filter", never, { "open": { "alias": "open"; "required": false; "isSignal": true; }; "title": { "alias": "title"; "required": false; "isSignal": true; }; "nodes": { "alias": "nodes"; "required": false; "isSignal": true; }; "selectionMode": { "alias": "selectionMode"; "required": false; "isSignal": true; }; "checkedKeys": { "alias": "checkedKeys"; "required": false; "isSignal": true; }; "expandedKeys": { "alias": "expandedKeys"; "required": false; "isSignal": true; }; }, { "open": "openChange"; "checkedKeys": "checkedKeysChange"; "expandedKeys": "expandedKeysChange"; "apply": "apply"; "reset": "reset"; "fitProvince": "fitProvince"; "closed": "closed"; "selectionChange": "selectionChange"; }, never, never, true, never>;
 }

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

@@ -10,9 +10,11 @@ import * as i0 from "@angular/core";
 export declare class GeoMapLegendComponent {
     readonly title: import("@angular/core").InputSignal<string>;
     readonly items: import("@angular/core").InputSignal<GeoMapLegendItem[]>;
+    /** True khi danh mục chú giải không tải được (`ERR_MAP_LEGEND_CATALOG_MISSING`). */
+    readonly catalogMissing: import("@angular/core").InputSignal<boolean>;
     readonly open: import("@angular/core").ModelSignal<boolean>;
     readonly closed: import("@angular/core").OutputEmitterRef<void>;
     onClose(): void;
     static ɵfac: i0.ɵɵFactoryDeclaration<GeoMapLegendComponent, never>;
-    static ɵcmp: i0.ɵɵComponentDeclaration<GeoMapLegendComponent, "geo-map-legend", never, { "title": { "alias": "title"; "required": false; "isSignal": true; }; "items": { "alias": "items"; "required": false; "isSignal": true; }; "open": { "alias": "open"; "required": false; "isSignal": true; }; }, { "open": "openChange"; "closed": "closed"; }, never, never, true, never>;
+    static ɵcmp: i0.ɵɵComponentDeclaration<GeoMapLegendComponent, "geo-map-legend", never, { "title": { "alias": "title"; "required": false; "isSignal": true; }; "items": { "alias": "items"; "required": false; "isSignal": true; }; "catalogMissing": { "alias": "catalogMissing"; "required": false; "isSignal": true; }; "open": { "alias": "open"; "required": false; "isSignal": true; }; }, { "open": "openChange"; "closed": "closed"; }, never, never, true, never>;
 }

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, …).
@@ -13,6 +13,7 @@ export declare class GeoMapShellComponent {
     private readonly destroyRef;
     private readonly snapshotRef;
     private readonly zoomRef;
+    private readonly locateRef;
     readonly center: import("@angular/core").InputSignal<number[]>;
     readonly zoom: import("@angular/core").InputSignal<number>;
     readonly height: import("@angular/core").InputSignal<string>;
@@ -25,7 +26,16 @@ export declare class GeoMapShellComponent {
     readonly showNav: import("@angular/core").InputSignal<boolean>;
     readonly includeDemoLayers: import("@angular/core").InputSignal<boolean>;
     readonly adminNodes: import("@angular/core").InputSignal<GeoTreeNode[]>;
+    /** `single` — chọn đúng 1 xã/phường (BR-06-03); `multi` — checkbox nhiều cấp (mặc định). */
+    readonly adminSelectionMode: import("@angular/core").InputSignal<"multi" | "single">;
     readonly locationLabel: import("@angular/core").InputSignal<string>;
+    /**
+     * Ghi chú pháp lý hiển thị khi đang đo (BR-10-03). `null` ẩn ghi chú —
+     * mặc định giữ nguyên câu chữ đã dùng ở `qh-map-shell`.
+     */
+    readonly measureDisclaimer: import("@angular/core").InputSignal<string | null>;
+    /** True khi danh mục chú giải không tải được (`ERR_MAP_LEGEND_CATALOG_MISSING`). */
+    readonly legendCatalogMissing: import("@angular/core").InputSignal<boolean>;
     readonly parcelAudience: import("@angular/core").InputSignal<GeoMapParcelAudience>;
     readonly provinceExtent: import("@angular/core").InputSignal<readonly [number, number, number, number]>;
     /** When true, shell seeds mock search results (Storybook / demos). */
@@ -52,13 +62,20 @@ 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<[number, number]>;
     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>;
     readonly resultSelect: import("@angular/core").OutputEmitterRef<GeoMapSearchResultItem>;
     readonly parcelExport: import("@angular/core").OutputEmitterRef<GeoMapParcelDetail>;
     readonly adminApply: import("@angular/core").OutputEmitterRef<(string | number)[]>;
+    readonly snapshotCaptured: import("@angular/core").OutputEmitterRef<void>;
+    readonly snapshotError: import("@angular/core").OutputEmitterRef<unknown>;
     readonly controller: import("@angular/core").WritableSignal<GeoMapController | null>;
     /** Active map pointer tool (`none` = default arrow cursor). */
     readonly toolMode: import("@angular/core").WritableSignal<"area" | "none" | "distance" | "pan">;
@@ -99,5 +116,5 @@ export declare class GeoMapShellComponent {
     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; }; "showNav": { "alias": "showNav"; "required": false; "isSignal": true; }; "includeDemoLayers": { "alias": "includeDemoLayers"; "required": false; "isSignal": true; }; "adminNodes": { "alias": "adminNodes"; "required": false; "isSignal": true; }; "adminSelectionMode": { "alias": "adminSelectionMode"; "required": false; "isSignal": true; }; "locationLabel": { "alias": "locationLabel"; "required": false; "isSignal": true; }; "measureDisclaimer": { "alias": "measureDisclaimer"; "required": false; "isSignal": true; }; "legendCatalogMissing": { "alias": "legendCatalogMissing"; "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"; "snapshotCaptured": "snapshotCaptured"; "snapshotError": "snapshotError"; }, 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[];
+/**
+ * Toolbar action cho định vị (UC-14) — KHÔNG có trong `GEO_MAP_DEFAULT_TOOLBAR_ACTIONS` để
+ * không đổi giao diện các consumer hiện có (M02/M07). Ghép thêm khi cần:
+ * `toolbarActions: [...GEO_MAP_DEFAULT_TOOLBAR_ACTIONS, GEO_MAP_LOCATE_TOOLBAR_ACTION]`.
+ */
+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-tree/geo-tree.component.d.ts

@@ -8,11 +8,15 @@ import * as i0 from "@angular/core";
 export declare class GeoTreeComponent {
     readonly nodes: import("@angular/core").InputSignal<GeoTreeNode[]>;
     readonly checkable: import("@angular/core").InputSignal<boolean>;
+    /** `single` — click chọn đúng 1 node (BR-06-03); `multi` — giữ hành vi checkbox hiện có. */
+    readonly selectionMode: import("@angular/core").InputSignal<"multi" | "single">;
     readonly checkedKeys: import("@angular/core").ModelSignal<(string | number)[]>;
+    readonly selectedKeys: import("@angular/core").ModelSignal<(string | number)[]>;
     readonly expandedKeys: import("@angular/core").ModelSignal<(string | number)[]>;
     readonly showLine: import("@angular/core").InputSignal<boolean>;
     readonly blockNode: import("@angular/core").InputSignal<boolean>;
     readonly nodeClick: import("@angular/core").OutputEmitterRef<NzFormatEmitEvent>;
+    onNodeClick(event: NzFormatEmitEvent): void;
     static ɵfac: i0.ɵɵFactoryDeclaration<GeoTreeComponent, never>;
-    static ɵcmp: i0.ɵɵComponentDeclaration<GeoTreeComponent, "geo-tree", never, { "nodes": { "alias": "nodes"; "required": false; "isSignal": true; }; "checkable": { "alias": "checkable"; "required": false; "isSignal": true; }; "checkedKeys": { "alias": "checkedKeys"; "required": false; "isSignal": true; }; "expandedKeys": { "alias": "expandedKeys"; "required": false; "isSignal": true; }; "showLine": { "alias": "showLine"; "required": false; "isSignal": true; }; "blockNode": { "alias": "blockNode"; "required": false; "isSignal": true; }; }, { "checkedKeys": "checkedKeysChange"; "expandedKeys": "expandedKeysChange"; "nodeClick": "nodeClick"; }, never, never, true, never>;
+    static ɵcmp: i0.ɵɵComponentDeclaration<GeoTreeComponent, "geo-tree", never, { "nodes": { "alias": "nodes"; "required": false; "isSignal": true; }; "checkable": { "alias": "checkable"; "required": false; "isSignal": true; }; "selectionMode": { "alias": "selectionMode"; "required": false; "isSignal": true; }; "checkedKeys": { "alias": "checkedKeys"; "required": false; "isSignal": true; }; "selectedKeys": { "alias": "selectedKeys"; "required": false; "isSignal": true; }; "expandedKeys": { "alias": "expandedKeys"; "required": false; "isSignal": true; }; "showLine": { "alias": "showLine"; "required": false; "isSignal": true; }; "blockNode": { "alias": "blockNode"; "required": false; "isSignal": true; }; }, { "checkedKeys": "checkedKeysChange"; "selectedKeys": "selectedKeysChange"; "expandedKeys": "expandedKeysChange"; "nodeClick": "nodeClick"; }, never, never, true, never>;
 }

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@geoit/ui",
-  "version": "0.0.6",
+  "version": "0.0.8",
   "description": "GEO UI — Angular 18 + ng-zorro design system components",
   "peerDependencies": {
     "@angular/animations": "^18.2.0",