@geoit/ui 0.0.4 → 0.0.6

package/ai/catalog.json

@@ -1,14 +1,14 @@
 {
   "package": "@geoit/ui",
   "import": "@geoit/ui",
-  "version": "0.0.4",
-  "generatedAt": "2026-07-27T01:57:41.109Z",
+  "version": "0.0.6",
+  "generatedAt": "2026-09-03T03:52:29.749Z",
   "styles": [
     "@geoit/ui/src/lib/styles/design-tokens.scss",
     "@geoit/ui/src/lib/styles/theme.scss"
   ],
   "tokens": {
-    "radius": "var(--geo-radius) /* 6px */",
+    "radius": "var(--geo-radius) /* 8px — scale: sm 6 / md 10 / lg 12 / xl 14 */",
     "primary": "var(--geo-color-primary-default)",
     "docs": "node_modules/@geoit/ui/src/lib/styles/design-tokens.scss"
   },
@@ -72,7 +72,7 @@
           "name": "visible",
           "type": "boolean",
           "default": "true",
-          "note": ""
+          "note": "Two-way `model()` (supports banana binding)."
         },
         {
           "name": "showIcon",
@@ -84,7 +84,7 @@
       "outputs": [
         {
           "name": "closed",
-          "type": "EventEmitter<void>",
+          "type": "OutputEmitterRef<void>",
           "note": ""
         }
       ],
@@ -152,7 +152,7 @@
       "outputs": [
         {
           "name": "clicked",
-          "type": "EventEmitter<MouseEvent>",
+          "type": "OutputEmitterRef<MouseEvent>",
           "note": ""
         }
       ],
@@ -251,8 +251,8 @@
         },
         {
           "name": "icon",
-          "type": "string",
-          "default": "",
+          "type": "string | undefined",
+          "default": "undefined",
           "note": ""
         },
         {
@@ -313,7 +313,7 @@
       "outputs": [
         {
           "name": "clicked",
-          "type": "EventEmitter<MouseEvent>",
+          "type": "OutputEmitterRef<MouseEvent>",
           "note": ""
         }
       ],
@@ -336,6 +336,104 @@
         "geo-confirm-modal"
       ]
     },
+    {
+      "name": "GeoChartComponent",
+      "selector": "geo-chart",
+      "category": "data",
+      "summary": "Bar / donut chart for dashboard statistics (ApexCharts).",
+      "whenToUse": "KPI breakdowns on dashboard pages.",
+      "doNotUseWhen": "Maps / spatial — use geo-map; single KPI — use geo-stat-card.",
+      "howTo": "Biểu đồ bar/donut cho dashboard. [data] = { label, value, color? }[]; (segmentClick) khi click lát.",
+      "tips": [
+        "Màu ưu tiên CSS var(--geo-color-*).",
+        "KPI đơn → geo-stat-card; ghép sẵn → geo-dashboard."
+      ],
+      "binding": "none",
+      "cva": false,
+      "path": "projects/geo-ui/src/lib/figma/geo-chart/geo-chart.component.ts",
+      "doc": "ai/components/geo-chart.md",
+      "inputs": [
+        {
+          "name": "type",
+          "type": "'bar' | 'donut'",
+          "default": "'bar'",
+          "note": ""
+        },
+        {
+          "name": "title",
+          "type": "string",
+          "default": "''",
+          "note": ""
+        },
+        {
+          "name": "data",
+          "type": "GeoChartDatum[]",
+          "default": "[]",
+          "note": ""
+        },
+        {
+          "name": "height",
+          "type": "number",
+          "default": "260",
+          "note": ""
+        },
+        {
+          "name": "showLegend",
+          "type": "boolean",
+          "default": "true",
+          "note": ""
+        },
+        {
+          "name": "showSort",
+          "type": "boolean",
+          "default": "false",
+          "note": ""
+        },
+        {
+          "name": "sort",
+          "type": "'none' | 'asc' | 'desc'",
+          "default": "'desc'",
+          "note": "Two-way `model()` (supports banana binding)."
+        },
+        {
+          "name": "emptyText",
+          "type": "string",
+          "default": "'Chưa có dữ liệu thống kê.'",
+          "note": ""
+        },
+        {
+          "name": "unit",
+          "type": "string",
+          "default": "''",
+          "note": ""
+        }
+      ],
+      "outputs": [
+        {
+          "name": "segmentClick",
+          "type": "OutputEmitterRef<GeoChartSegmentClick>",
+          "note": ""
+        },
+        {
+          "name": "sortChange",
+          "type": "OutputEmitterRef<'none' | 'asc' | 'desc'>",
+          "note": ""
+        }
+      ],
+      "examples": [
+        {
+          "title": "Bar",
+          "lang": "html",
+          "code": "<geo-chart type=\"bar\" title=\"Theo xã\" [data]=\"wardData\" [height]=\"280\"></geo-chart>"
+        }
+      ],
+      "example": "<geo-chart type=\"bar\" title=\"Theo xã\" [data]=\"wardData\" [height]=\"280\"></geo-chart>",
+      "related": [
+        "geo-stat-card",
+        "geo-dashboard",
+        "geo-empty-state"
+      ]
+    },
     {
       "name": "GeoCheckboxComponent",
       "selector": "geo-checkbox",
@@ -364,7 +462,7 @@
           "name": "checked",
           "type": "boolean",
           "default": "false",
-          "note": ""
+          "note": "Two-way: `[(checked)]`. — Two-way `model()` (supports banana binding)."
         },
         {
           "name": "disabled",
@@ -379,13 +477,7 @@
           "note": ""
         }
       ],
-      "outputs": [
-        {
-          "name": "checkedChange",
-          "type": "EventEmitter<boolean>",
-          "note": ""
-        }
-      ],
+      "outputs": [],
       "examples": [
         {
           "title": "Basic",
@@ -442,15 +534,15 @@
         },
         {
           "name": "storageKey",
-          "type": "string",
-          "default": "",
+          "type": "string | undefined",
+          "default": "undefined",
           "note": "Lưu trạng thái ẩn/hiện cột theo session khi người dùng áp dụng"
         }
       ],
       "outputs": [
         {
           "name": "apply",
-          "type": "EventEmitter<GeoColumnPickerApplyPayload>",
+          "type": "OutputEmitterRef<GeoColumnPickerApplyPayload>",
           "note": ""
         }
       ],
@@ -494,7 +586,7 @@
           "name": "visible",
           "type": "boolean",
           "default": "false",
-          "note": ""
+          "note": "Two-way `model()` (supports banana binding)."
         },
         {
           "name": "title",
@@ -558,19 +650,14 @@
         }
       ],
       "outputs": [
-        {
-          "name": "visibleChange",
-          "type": "EventEmitter<boolean>",
-          "note": ""
-        },
         {
           "name": "confirm",
-          "type": "EventEmitter<void>",
+          "type": "OutputEmitterRef<void>",
           "note": ""
         },
         {
           "name": "cancel",
-          "type": "EventEmitter<void>",
+          "type": "OutputEmitterRef<void>",
           "note": ""
         }
       ],
@@ -593,6 +680,108 @@
         "geo-toast"
       ]
     },
+    {
+      "name": "GeoDashboardComponent",
+      "selector": "geo-dashboard",
+      "category": "layout",
+      "summary": "Composed dashboard: period, KPI cards, ward/mismatch charts.",
+      "whenToUse": "TCQH overview pages (thống kê nhanh).",
+      "doNotUseWhen": "Custom layouts — compose geo-stat-card + geo-chart yourself.",
+      "howTo": "Dashboard ghép sẵn: stats + biểu đồ xã + lệch kỳ. [(period)] điều khiển kỳ thống kê.",
+      "tips": [
+        "Tự layout → geo-stat-card + geo-chart."
+      ],
+      "binding": "none",
+      "cva": false,
+      "path": "projects/geo-ui/src/lib/figma/geo-dashboard/geo-dashboard.component.ts",
+      "doc": "ai/components/geo-dashboard.md",
+      "inputs": [
+        {
+          "name": "title",
+          "type": "string",
+          "default": "'Dashboard thống kê'",
+          "note": ""
+        },
+        {
+          "name": "breadcrumb",
+          "type": "GeoBreadcrumbItem[]",
+          "default": "[ { label: 'Trang chủ', link: '/' }, { label: 'Dashboard' }, ]",
+          "note": ""
+        },
+        {
+          "name": "stats",
+          "type": "GeoStatCardItem[]",
+          "default": "[]",
+          "note": ""
+        },
+        {
+          "name": "wardChartTitle",
+          "type": "string",
+          "default": "'Diện tích quy hoạch theo phường/xã'",
+          "note": ""
+        },
+        {
+          "name": "wardData",
+          "type": "GeoChartDatum[]",
+          "default": "[]",
+          "note": ""
+        },
+        {
+          "name": "mismatchChartTitle",
+          "type": "string",
+          "default": "'Tỷ lệ thửa quy hoạch khác mục đích hiện trạng'",
+          "note": ""
+        },
+        {
+          "name": "mismatchData",
+          "type": "GeoChartDatum[]",
+          "default": "[]",
+          "note": ""
+        },
+        {
+          "name": "wardUnit",
+          "type": "string",
+          "default": "'ha'",
+          "note": ""
+        },
+        {
+          "name": "period",
+          "type": "GeoDateRangeValue",
+          "default": "null",
+          "note": "Two-way `model()` (supports banana binding)."
+        }
+      ],
+      "outputs": [
+        {
+          "name": "periodChange",
+          "type": "OutputEmitterRef<GeoDateRangeValue>",
+          "note": ""
+        },
+        {
+          "name": "mismatchSegmentClick",
+          "type": "OutputEmitterRef<GeoChartSegmentClick>",
+          "note": ""
+        },
+        {
+          "name": "wardSegmentClick",
+          "type": "OutputEmitterRef<GeoChartSegmentClick>",
+          "note": ""
+        }
+      ],
+      "examples": [
+        {
+          "title": "Basic",
+          "lang": "html",
+          "code": "<geo-dashboard [stats]=\"stats\" [wardData]=\"wards\" [mismatchData]=\"mismatch\" [(period)]=\"period\"></geo-dashboard>"
+        }
+      ],
+      "example": "<geo-dashboard [stats]=\"stats\" [wardData]=\"wards\" [mismatchData]=\"mismatch\" [(period)]=\"period\"></geo-dashboard>",
+      "related": [
+        "geo-stat-card",
+        "geo-chart",
+        "geo-page-header"
+      ]
+    },
     {
       "name": "GeoDatePickerComponent",
       "selector": "geo-date-picker",
@@ -691,21 +880,21 @@
         },
         {
           "name": "width",
-          "type": "number | string",
-          "default": "",
+          "type": "number | string | undefined",
+          "default": "undefined",
           "note": ""
         },
         {
           "name": "disabledDate",
-          "type": "(current: Date)",
-          "default": "> boolean",
+          "type": "((current: Date) => boolean) | undefined",
+          "default": "undefined",
           "note": ""
         }
       ],
       "outputs": [
         {
           "name": "valueChange",
-          "type": "EventEmitter<Date | null>",
+          "type": "OutputEmitterRef<Date | null>",
           "note": ""
         }
       ],
@@ -814,14 +1003,14 @@
         },
         {
           "name": "width",
-          "type": "number | string",
-          "default": "",
+          "type": "number | string | undefined",
+          "default": "undefined",
           "note": ""
         },
         {
           "name": "disabledDate",
-          "type": "(current: Date)",
-          "default": "> boolean",
+          "type": "((current: Date) => boolean) | undefined",
+          "default": "undefined",
           "note": ""
         },
         {
@@ -834,7 +1023,7 @@
       "outputs": [
         {
           "name": "valueChange",
-          "type": "EventEmitter<[Date, Date] | null>",
+          "type": "OutputEmitterRef<[Date, Date] | null>",
           "note": ""
         }
       ],
@@ -856,6 +1045,159 @@
         "geo-table-filter"
       ]
     },
+    {
+      "name": "GeoEmptyStateComponent",
+      "selector": "geo-empty-state",
+      "category": "feedback",
+      "summary": "Empty region placeholder (icon + title + optional action).",
+      "whenToUse": "No data / no results areas inside pages or cards.",
+      "doNotUseWhen": "Inline form validation — use field errorMessage / geo-alert.",
+      "howTo": "",
+      "tips": [],
+      "binding": "none",
+      "cva": false,
+      "path": "projects/geo-ui/src/lib/figma/geo-empty-state/geo-empty-state.component.ts",
+      "doc": "ai/components/geo-empty-state.md",
+      "inputs": [
+        {
+          "name": "title",
+          "type": "string",
+          "default": "'Không có dữ liệu'",
+          "note": ""
+        },
+        {
+          "name": "description",
+          "type": "string",
+          "default": "''",
+          "note": ""
+        },
+        {
+          "name": "icon",
+          "type": "string",
+          "default": "'inbox'",
+          "note": ""
+        },
+        {
+          "name": "actionLabel",
+          "type": "string",
+          "default": "''",
+          "note": ""
+        }
+      ],
+      "outputs": [
+        {
+          "name": "actionClick",
+          "type": "OutputEmitterRef<void>",
+          "note": ""
+        }
+      ],
+      "examples": [
+        {
+          "title": "Example",
+          "lang": "html",
+          "code": "<geo-empty-state title=\"Chưa có dữ liệu\" description=\"Thử đổi bộ lọc.\"></geo-empty-state>"
+        }
+      ],
+      "example": "<geo-empty-state title=\"Chưa có dữ liệu\" description=\"Thử đổi bộ lọc.\"></geo-empty-state>",
+      "related": []
+    },
+    {
+      "name": "GeoFeedbackFormComponent",
+      "selector": "geo-feedback-form",
+      "category": "forms",
+      "summary": "Citizen feedback / phản ánh form with validation.",
+      "whenToUse": "Public feedback submission pages.",
+      "doNotUseWhen": "Admin feedback inbox — use geo-list-page + geo-table.",
+      "howTo": "",
+      "tips": [],
+      "binding": "none",
+      "cva": false,
+      "path": "projects/geo-ui/src/lib/figma/geo-feedback-form/geo-feedback-form.component.ts",
+      "doc": "ai/components/geo-feedback-form.md",
+      "inputs": [
+        {
+          "name": "title",
+          "type": "string",
+          "default": "'Gửi phản ánh, kiến nghị'",
+          "note": ""
+        },
+        {
+          "name": "description",
+          "type": "string",
+          "default": "'Nội dung sẽ được chuyển tới cán bộ xử lý. Vui lòng mô tả rõ vấn đề và vị trí (nếu có).'",
+          "note": "Mô tả ngắn dưới tiêu đề — giúp người dân hiểu quy trình xử lý."
+        },
+        {
+          "name": "maxLength",
+          "type": "number",
+          "default": "1000",
+          "note": ""
+        },
+        {
+          "name": "loading",
+          "type": "boolean",
+          "default": "false",
+          "note": ""
+        },
+        {
+          "name": "showCancel",
+          "type": "boolean",
+          "default": "true",
+          "note": "Ẩn nút Hủy khi form dùng trên trang riêng (không phải dialog)."
+        },
+        {
+          "name": "fill",
+          "type": "boolean",
+          "default": "false",
+          "note": "Form chiếm hết chiều rộng/cao vùng chứa (trang full content)."
+        },
+        {
+          "name": "submitLabel",
+          "type": "string",
+          "default": "'Gửi phản ánh'",
+          "note": ""
+        },
+        {
+          "name": "cancelLabel",
+          "type": "string",
+          "default": "'Hủy'",
+          "note": ""
+        },
+        {
+          "name": "senderName",
+          "type": "string",
+          "default": "''",
+          "note": "Two-way `model()` (supports banana binding)."
+        },
+        {
+          "name": "content",
+          "type": "string",
+          "default": "''",
+          "note": "Two-way `model()` (supports banana binding)."
+        }
+      ],
+      "outputs": [
+        {
+          "name": "submittedFeedback",
+          "type": "OutputEmitterRef<GeoFeedbackPayload>",
+          "note": ""
+        },
+        {
+          "name": "cancelled",
+          "type": "OutputEmitterRef<void>",
+          "note": ""
+        }
+      ],
+      "examples": [
+        {
+          "title": "Example",
+          "lang": "html",
+          "code": "<geo-feedback-form (submittedFeedback)=\"send($event)\"></geo-feedback-form>"
+        }
+      ],
+      "example": "<geo-feedback-form (submittedFeedback)=\"send($event)\"></geo-feedback-form>",
+      "related": []
+    },
     {
       "name": "GeoFilePickerComponent",
       "selector": "geo-file-picker",
@@ -936,8 +1278,8 @@
         },
         {
           "name": "width",
-          "type": "number | string",
-          "default": "",
+          "type": "number | string | undefined",
+          "default": "undefined",
           "note": ""
         },
         {
@@ -950,7 +1292,7 @@
       "outputs": [
         {
           "name": "fileChange",
-          "type": "EventEmitter<File | File[] | null>",
+          "type": "OutputEmitterRef<File | File[] | null>",
           "note": ""
         }
       ],
@@ -973,6 +1315,79 @@
         "geo-input"
       ]
     },
+    {
+      "name": "GeoForgotPasswordComponent",
+      "selector": "geo-forgot-password",
+      "category": "forms",
+      "summary": "Forgot-password form (email + submit / back to login).",
+      "whenToUse": "Password reset entry page.",
+      "doNotUseWhen": "Inside login card — navigate to a dedicated route.",
+      "howTo": "",
+      "tips": [],
+      "binding": "none",
+      "cva": false,
+      "path": "projects/geo-ui/src/lib/figma/geo-forgot-password/geo-forgot-password.component.ts",
+      "doc": "ai/components/geo-forgot-password.md",
+      "inputs": [
+        {
+          "name": "title",
+          "type": "string",
+          "default": "'Quên mật khẩu'",
+          "note": ""
+        },
+        {
+          "name": "subtitle",
+          "type": "string",
+          "default": "'Nhập email đã đăng ký để nhận mật khẩu mới.'",
+          "note": ""
+        },
+        {
+          "name": "loading",
+          "type": "boolean",
+          "default": "false",
+          "note": ""
+        },
+        {
+          "name": "errorMessage",
+          "type": "string",
+          "default": "''",
+          "note": ""
+        },
+        {
+          "name": "successMessage",
+          "type": "string",
+          "default": "''",
+          "note": ""
+        },
+        {
+          "name": "email",
+          "type": "string",
+          "default": "''",
+          "note": "Two-way `model()` (supports banana binding)."
+        }
+      ],
+      "outputs": [
+        {
+          "name": "submitEmail",
+          "type": "OutputEmitterRef<string>",
+          "note": ""
+        },
+        {
+          "name": "backToLogin",
+          "type": "OutputEmitterRef<void>",
+          "note": ""
+        }
+      ],
+      "examples": [
+        {
+          "title": "Example",
+          "lang": "html",
+          "code": "<geo-forgot-password\n  (submitEmail)=\"reset($event)\"\n  (backToLogin)=\"goLogin()\"\n></geo-forgot-password>"
+        }
+      ],
+      "example": "<geo-forgot-password\n  (submitEmail)=\"reset($event)\"\n  (backToLogin)=\"goLogin()\"\n></geo-forgot-password>",
+      "related": []
+    },
     {
       "name": "GeoFormModalComponent",
       "selector": "geo-form-modal",
@@ -995,7 +1410,7 @@
           "name": "open",
           "type": "boolean",
           "default": "false",
-          "note": "Tương đương `open` (antd) / `nzVisible` (ng-zorro)."
+          "note": "Tương đương `open` (antd) / `nzVisible` (ng-zorro). — Two-way `model()` (supports banana binding)."
         },
         {
           "name": "title",
@@ -1023,8 +1438,8 @@
         },
         {
           "name": "cancelIcon",
-          "type": "string",
-          "default": "",
+          "type": "string | undefined",
+          "default": "undefined",
           "note": "Icon nút cancel (vd. `left` cho Quay lại)."
         },
         {
@@ -1035,8 +1450,8 @@
         },
         {
           "name": "okIcon",
-          "type": "string",
-          "default": "",
+          "type": "string | undefined",
+          "default": "undefined",
           "note": "Icon nút OK (vd. `right` cho Tiếp theo)."
         },
         {
@@ -1137,34 +1552,29 @@
         }
       ],
       "outputs": [
-        {
-          "name": "openChange",
-          "type": "EventEmitter<boolean>",
-          "note": ""
-        },
         {
           "name": "ok",
-          "type": "EventEmitter<void>",
+          "type": "OutputEmitterRef<void>",
           "note": ""
         },
         {
           "name": "secondaryOk",
-          "type": "EventEmitter<void>",
+          "type": "OutputEmitterRef<void>",
           "note": ""
         },
         {
           "name": "cancel",
-          "type": "EventEmitter<void>",
+          "type": "OutputEmitterRef<void>",
           "note": ""
         },
         {
           "name": "afterOpen",
-          "type": "EventEmitter<void>",
+          "type": "OutputEmitterRef<void>",
           "note": ""
         },
         {
           "name": "afterClose",
-          "type": "EventEmitter<void>",
+          "type": "OutputEmitterRef<void>",
           "note": ""
         }
       ],
@@ -1209,7 +1619,7 @@
       "inputs": [
         {
           "name": "type",
-          "type": "",
+          "type": "string",
           "default": "",
           "note": "Tên icon Ant Design (vd. `close`, `search`, `appstore`)."
         },
@@ -1233,8 +1643,8 @@
         },
         {
           "name": "color",
-          "type": "string",
-          "default": "",
+          "type": "string | undefined",
+          "default": "undefined",
           "note": "CSS color — ưu tiên design token, vd. `var(--geo-color-primary-default)`"
         }
       ],
@@ -1312,84 +1722,2245 @@
           "note": ""
         },
         {
-          "name": "error",
-          "type": "boolean",
-          "default": "false",
-          "note": ""
-        },
+          "name": "error",
+          "type": "boolean",
+          "default": "false",
+          "note": ""
+        },
+        {
+          "name": "errorMessage",
+          "type": "string",
+          "default": "''",
+          "note": ""
+        },
+        {
+          "name": "maxlength",
+          "type": "number | undefined",
+          "default": "undefined",
+          "note": ""
+        },
+        {
+          "name": "prefixIcon",
+          "type": "string | undefined",
+          "default": "undefined",
+          "note": ""
+        },
+        {
+          "name": "suffixIcon",
+          "type": "string | undefined",
+          "default": "undefined",
+          "note": ""
+        },
+        {
+          "name": "allowClear",
+          "type": "boolean",
+          "default": "false",
+          "note": ""
+        },
+        {
+          "name": "block",
+          "type": "boolean",
+          "default": "false",
+          "note": ""
+        },
+        {
+          "name": "width",
+          "type": "number | string | undefined",
+          "default": "undefined",
+          "note": ""
+        }
+      ],
+      "outputs": [
+        {
+          "name": "valueChange",
+          "type": "OutputEmitterRef<string>",
+          "note": ""
+        },
+        {
+          "name": "enterPressed",
+          "type": "OutputEmitterRef<void>",
+          "note": ""
+        }
+      ],
+      "examples": [
+        {
+          "title": "Basic",
+          "lang": "html",
+          "code": "<geo-input label=\"Họ tên\" [required]=\"true\" [block]=\"true\" [(ngModel)]=\"name\"></geo-input>"
+        },
+        {
+          "title": "Full options",
+          "lang": "html",
+          "code": "<geo-input\n  label=\"Mã hồ sơ\"\n  placeholder=\"Nhập mã hồ sơ\"\n  type=\"text\"\n  prefixIcon=\"search\"\n  [allowClear]=\"true\"\n  [required]=\"true\"\n  [block]=\"true\"\n  [maxlength]=\"50\"\n  [error]=\"codeError\"\n  errorMessage=\"Mã không được để trống\"\n  [(ngModel)]=\"code\"\n  (enterPressed)=\"onSearch()\"\n  (valueChange)=\"onCode($event)\"\n></geo-input>"
+        }
+      ],
+      "example": "<geo-input label=\"Họ tên\" [required]=\"true\" [block]=\"true\" [(ngModel)]=\"name\"></geo-input>",
+      "related": [
+        "geo-textarea",
+        "geo-select",
+        "geo-form-modal"
+      ]
+    },
+    {
+      "name": "GeoLayoutComponent",
+      "selector": "geo-layout",
+      "category": "layout",
+      "summary": "App shell composing sidebar + header + content + footer.",
+      "whenToUse": "Host application chrome mirroring layout/feature MainLayout.",
+      "doNotUseWhen": "In-page wizards — use geo-step-form-layout; dialogs — use geo-form-modal.",
+      "howTo": "",
+      "tips": [],
+      "binding": "none",
+      "cva": false,
+      "path": "projects/geo-ui/src/lib/figma/geo-layout/geo-layout.component.ts",
+      "doc": "ai/components/geo-layout.md",
+      "inputs": [
+        {
+          "name": "menuItems",
+          "type": "GeoLayoutMenuItem[]",
+          "default": "[]",
+          "note": ""
+        },
+        {
+          "name": "brandTitle",
+          "type": "string",
+          "default": "'iLIS'",
+          "note": ""
+        },
+        {
+          "name": "logoSrc",
+          "type": "string",
+          "default": "''",
+          "note": ""
+        },
+        {
+          "name": "logoAlt",
+          "type": "string",
+          "default": "'Logo'",
+          "note": ""
+        },
+        {
+          "name": "sidebarBackgroundSrc",
+          "type": "string",
+          "default": "''",
+          "note": ""
+        },
+        {
+          "name": "breadcrumbs",
+          "type": "GeoBreadcrumbItem[]",
+          "default": "[]",
+          "note": ""
+        },
+        {
+          "name": "fallbackBreadcrumb",
+          "type": "string",
+          "default": "'Hệ thống thông tin đất đai - VNPT iLIS'",
+          "note": ""
+        },
+        {
+          "name": "expanded",
+          "type": "boolean",
+          "default": "true",
+          "note": "Two-way `model()` (supports banana binding)."
+        },
+        {
+          "name": "isMobile",
+          "type": "boolean",
+          "default": "false",
+          "note": ""
+        },
+        {
+          "name": "mobileMenuOpen",
+          "type": "boolean",
+          "default": "false",
+          "note": "Two-way `model()` (supports banana binding)."
+        },
+        {
+          "name": "selectedKey",
+          "type": "string | null",
+          "default": "null",
+          "note": "Two-way `model()` (supports banana binding)."
+        },
+        {
+          "name": "siderWidth",
+          "type": "number | string",
+          "default": "280",
+          "note": ""
+        },
+        {
+          "name": "siderCollapsedWidth",
+          "type": "number | string",
+          "default": "80",
+          "note": ""
+        },
+        {
+          "name": "showDefaultActions",
+          "type": "boolean",
+          "default": "true",
+          "note": ""
+        },
+        {
+          "name": "showFooter",
+          "type": "boolean",
+          "default": "true",
+          "note": ""
+        },
+        {
+          "name": "footerText",
+          "type": "string",
+          "default": "'© VNPT | Hệ thống thông tin đất đai iLIS'",
+          "note": ""
+        },
+        {
+          "name": "user",
+          "type": "GeoLayoutUserInfo",
+          "default": "GEO_LAYOUT_DEFAULT_USER",
+          "note": ""
+        },
+        {
+          "name": "notifications",
+          "type": "GeoLayoutNotificationItem[]",
+          "default": "GEO_LAYOUT_DEFAULT_NOTIFICATIONS",
+          "note": ""
+        },
+        {
+          "name": "subsystems",
+          "type": "GeoLayoutSubsystemItem[]",
+          "default": "GEO_LAYOUT_DEFAULT_SUBSYSTEMS",
+          "note": ""
+        },
+        {
+          "name": "userMenuItems",
+          "type": "GeoLayoutUserMenuItem[]",
+          "default": "GEO_LAYOUT_DEFAULT_USER_MENU",
+          "note": ""
+        }
+      ],
+      "outputs": [
+        {
+          "name": "menuSelect",
+          "type": "OutputEmitterRef<GeoLayoutMenuItem>",
+          "note": ""
+        },
+        {
+          "name": "sidebarToggle",
+          "type": "OutputEmitterRef<void>",
+          "note": ""
+        },
+        {
+          "name": "notificationClick",
+          "type": "OutputEmitterRef<GeoLayoutNotificationItem>",
+          "note": ""
+        },
+        {
+          "name": "subsystemClick",
+          "type": "OutputEmitterRef<GeoLayoutSubsystemItem>",
+          "note": ""
+        },
+        {
+          "name": "userMenuClick",
+          "type": "OutputEmitterRef<GeoLayoutUserMenuItem>",
+          "note": ""
+        },
+        {
+          "name": "logout",
+          "type": "OutputEmitterRef<void>",
+          "note": ""
+        }
+      ],
+      "examples": [
+        {
+          "title": "Example",
+          "lang": "html",
+          "code": "<geo-layout\n  [menuItems]=\"menu\"\n  [(expanded)]=\"expanded\"\n  [breadcrumbs]=\"crumbs\"\n  [(selectedKey)]=\"active\"\n  [user]=\"{ name: 'vnpt', email: 'vnpt@vnpt.vn' }\"\n  (menuSelect)=\"onNav($event)\"\n  (logout)=\"onLogout()\"\n>\n  <router-outlet />\n</geo-layout>"
+        }
+      ],
+      "example": "<geo-layout\n  [menuItems]=\"menu\"\n  [(expanded)]=\"expanded\"\n  [breadcrumbs]=\"crumbs\"\n  [(selectedKey)]=\"active\"\n  [user]=\"{ name: 'vnpt', email: 'vnpt@vnpt.vn' }\"\n  (menuSelect)=\"onNav($event)\"\n  (logout)=\"onLogout()\"\n>\n  <router-outlet />\n</geo-layout>",
+      "related": []
+    },
+    {
+      "name": "GeoLayoutFooterComponent",
+      "selector": "geo-layout-footer",
+      "category": "layout",
+      "summary": "Minimal layout footer with copyright text + content slot.",
+      "whenToUse": "Bottom chrome inside geo-layout or custom shells.",
+      "doNotUseWhen": "Marketing page footers with heavy links/nav.",
+      "howTo": "",
+      "tips": [],
+      "binding": "none",
+      "cva": false,
+      "path": "projects/geo-ui/src/lib/figma/geo-layout/footer/geo-layout-footer.component.ts",
+      "doc": "ai/components/geo-layout-footer.md",
+      "inputs": [
+        {
+          "name": "text",
+          "type": "string",
+          "default": "'© VNPT | Hệ thống thông tin đất đai iLIS'",
+          "note": "Copyright / status text. Empty = use default."
+        }
+      ],
+      "outputs": [],
+      "examples": [
+        {
+          "title": "Example",
+          "lang": "html",
+          "code": "<geo-layout-footer text=\"© VNPT | iLIS\"></geo-layout-footer>"
+        }
+      ],
+      "example": "<geo-layout-footer text=\"© VNPT | iLIS\"></geo-layout-footer>",
+      "related": []
+    },
+    {
+      "name": "GeoLayoutHeaderComponent",
+      "selector": "geo-layout-header",
+      "category": "layout",
+      "summary": "Soft top bar: toggle + breadcrumb + user/notification actions.",
+      "whenToUse": "Standalone top bar, or inside geo-layout.",
+      "doNotUseWhen": "Full app chrome — use geo-layout.",
+      "howTo": "",
+      "tips": [],
+      "binding": "none",
+      "cva": false,
+      "path": "projects/geo-ui/src/lib/figma/geo-layout/header/geo-layout-header.component.ts",
+      "doc": "ai/components/geo-layout-header.md",
+      "inputs": [
+        {
+          "name": "breadcrumbs",
+          "type": "GeoBreadcrumbItem[]",
+          "default": "[]",
+          "note": ""
+        },
+        {
+          "name": "fallbackBreadcrumb",
+          "type": "string",
+          "default": "'Hệ thống thông tin đất đai - VNPT iLIS'",
+          "note": ""
+        },
+        {
+          "name": "expanded",
+          "type": "boolean",
+          "default": "true",
+          "note": ""
+        },
+        {
+          "name": "isMobile",
+          "type": "boolean",
+          "default": "false",
+          "note": ""
+        },
+        {
+          "name": "mobileMenuOpen",
+          "type": "boolean",
+          "default": "false",
+          "note": ""
+        },
+        {
+          "name": "showDefaultActions",
+          "type": "boolean",
+          "default": "true",
+          "note": ""
+        },
+        {
+          "name": "user",
+          "type": "GeoLayoutUserInfo",
+          "default": "GEO_LAYOUT_DEFAULT_USER",
+          "note": ""
+        },
+        {
+          "name": "notifications",
+          "type": "GeoLayoutNotificationItem[]",
+          "default": "GEO_LAYOUT_DEFAULT_NOTIFICATIONS",
+          "note": ""
+        },
+        {
+          "name": "subsystems",
+          "type": "GeoLayoutSubsystemItem[]",
+          "default": "GEO_LAYOUT_DEFAULT_SUBSYSTEMS",
+          "note": ""
+        },
+        {
+          "name": "userMenuItems",
+          "type": "GeoLayoutUserMenuItem[]",
+          "default": "GEO_LAYOUT_DEFAULT_USER_MENU",
+          "note": ""
+        }
+      ],
+      "outputs": [
+        {
+          "name": "sidebarToggle",
+          "type": "OutputEmitterRef<void>",
+          "note": ""
+        },
+        {
+          "name": "notificationClick",
+          "type": "OutputEmitterRef<GeoLayoutNotificationItem>",
+          "note": ""
+        },
+        {
+          "name": "subsystemClick",
+          "type": "OutputEmitterRef<GeoLayoutSubsystemItem>",
+          "note": ""
+        },
+        {
+          "name": "userMenuClick",
+          "type": "OutputEmitterRef<GeoLayoutUserMenuItem>",
+          "note": ""
+        },
+        {
+          "name": "logout",
+          "type": "OutputEmitterRef<void>",
+          "note": ""
+        }
+      ],
+      "examples": [
+        {
+          "title": "Example",
+          "lang": "html",
+          "code": "<geo-layout-header\n  [breadcrumbs]=\"crumbs\"\n  [user]=\"{ name: 'vnpt', email: 'vnpt@vnpt.vn' }\"\n  (sidebarToggle)=\"toggle()\"\n></geo-layout-header>"
+        }
+      ],
+      "example": "<geo-layout-header\n  [breadcrumbs]=\"crumbs\"\n  [user]=\"{ name: 'vnpt', email: 'vnpt@vnpt.vn' }\"\n  (sidebarToggle)=\"toggle()\"\n></geo-layout-header>",
+      "related": []
+    },
+    {
+      "name": "GeoLayoutHeaderActionsComponent",
+      "selector": "geo-layout-header-actions",
+      "category": "layout",
+      "summary": "Header actions: notification/subsystem icons + user chip with popovers.",
+      "whenToUse": "Standalone header toolbar, or default actions inside geo-layout-header.",
+      "doNotUseWhen": "Full app chrome — prefer wrapping with geo-layout.",
+      "howTo": "",
+      "tips": [],
+      "binding": "none",
+      "cva": false,
+      "path": "projects/geo-ui/src/lib/figma/geo-layout/header-actions/geo-layout-header-actions.component.ts",
+      "doc": "ai/components/geo-layout-header-actions.md",
+      "inputs": [
+        {
+          "name": "user",
+          "type": "GeoLayoutUserInfo",
+          "default": "GEO_LAYOUT_DEFAULT_USER",
+          "note": ""
+        },
+        {
+          "name": "notifications",
+          "type": "GeoLayoutNotificationItem[]",
+          "default": "GEO_LAYOUT_DEFAULT_NOTIFICATIONS",
+          "note": ""
+        },
+        {
+          "name": "subsystems",
+          "type": "GeoLayoutSubsystemItem[]",
+          "default": "GEO_LAYOUT_DEFAULT_SUBSYSTEMS",
+          "note": ""
+        },
+        {
+          "name": "userMenuItems",
+          "type": "GeoLayoutUserMenuItem[]",
+          "default": "GEO_LAYOUT_DEFAULT_USER_MENU",
+          "note": ""
+        },
+        {
+          "name": "compact",
+          "type": "boolean",
+          "default": "false",
+          "note": "Ẩn tên/email trên chip (mobile)."
+        }
+      ],
+      "outputs": [
+        {
+          "name": "notificationClick",
+          "type": "OutputEmitterRef<GeoLayoutNotificationItem>",
+          "note": ""
+        },
+        {
+          "name": "subsystemClick",
+          "type": "OutputEmitterRef<GeoLayoutSubsystemItem>",
+          "note": ""
+        },
+        {
+          "name": "userMenuClick",
+          "type": "OutputEmitterRef<GeoLayoutUserMenuItem>",
+          "note": ""
+        },
+        {
+          "name": "logout",
+          "type": "OutputEmitterRef<void>",
+          "note": ""
+        }
+      ],
+      "examples": [
+        {
+          "title": "Example",
+          "lang": "html",
+          "code": "<geo-layout-header-actions\n  [user]=\"{ name: 'vnpt', email: 'vnpt@vnpt.vn' }\"\n  (logout)=\"onLogout()\"\n></geo-layout-header-actions>"
+        }
+      ],
+      "example": "<geo-layout-header-actions\n  [user]=\"{ name: 'vnpt', email: 'vnpt@vnpt.vn' }\"\n  (logout)=\"onLogout()\"\n></geo-layout-header-actions>",
+      "related": []
+    },
+    {
+      "name": "GeoLayoutSidebarComponent",
+      "selector": "geo-layout-sidebar",
+      "category": "layout",
+      "summary": "White sidebar: brand + recursive menu (collapse / mobile drawer).",
+      "whenToUse": "Standalone nav rail, or inside geo-layout.",
+      "doNotUseWhen": "Full app chrome — use geo-layout.",
+      "howTo": "",
+      "tips": [],
+      "binding": "none",
+      "cva": false,
+      "path": "projects/geo-ui/src/lib/figma/geo-layout/sidebar/geo-layout-sidebar.component.ts",
+      "doc": "ai/components/geo-layout-sidebar.md",
+      "inputs": [
+        {
+          "name": "menuItems",
+          "type": "GeoLayoutMenuItem[]",
+          "default": "[]",
+          "note": ""
+        },
+        {
+          "name": "brandTitle",
+          "type": "string",
+          "default": "'iLIS'",
+          "note": ""
+        },
+        {
+          "name": "logoSrc",
+          "type": "string",
+          "default": "''",
+          "note": ""
+        },
+        {
+          "name": "logoAlt",
+          "type": "string",
+          "default": "'Logo'",
+          "note": ""
+        },
+        {
+          "name": "sidebarBackgroundSrc",
+          "type": "string",
+          "default": "''",
+          "note": ""
+        },
+        {
+          "name": "selectedKey",
+          "type": "string | null",
+          "default": "null",
+          "note": "Two-way `model()` (supports banana binding)."
+        },
+        {
+          "name": "collapsed",
+          "type": "boolean",
+          "default": "false",
+          "note": ""
+        },
+        {
+          "name": "isMobile",
+          "type": "boolean",
+          "default": "false",
+          "note": ""
+        },
+        {
+          "name": "mobileOpen",
+          "type": "boolean",
+          "default": "false",
+          "note": ""
+        },
+        {
+          "name": "width",
+          "type": "GeoLayoutSiderWidth",
+          "default": "280",
+          "note": ""
+        },
+        {
+          "name": "collapsedWidth",
+          "type": "GeoLayoutSiderWidth",
+          "default": "80",
+          "note": ""
+        }
+      ],
+      "outputs": [
+        {
+          "name": "menuSelect",
+          "type": "OutputEmitterRef<GeoLayoutMenuItem>",
+          "note": ""
+        }
+      ],
+      "examples": [
+        {
+          "title": "Example",
+          "lang": "html",
+          "code": "<geo-layout-sidebar\n  [menuItems]=\"menu\"\n  [(selectedKey)]=\"active\"\n  [collapsed]=\"false\"\n></geo-layout-sidebar>"
+        }
+      ],
+      "example": "<geo-layout-sidebar\n  [menuItems]=\"menu\"\n  [(selectedKey)]=\"active\"\n  [collapsed]=\"false\"\n></geo-layout-sidebar>",
+      "related": []
+    },
+    {
+      "name": "GeoListPageComponent",
+      "selector": "geo-list-page",
+      "category": "layout",
+      "summary": "List page chrome: title + breadcrumb shell for admin CRUD screens.",
+      "whenToUse": "Wrap table toolbars on admin list pages.",
+      "doNotUseWhen": "Map portals — use geo-map-shell; dashboards — use geo-dashboard.",
+      "howTo": "",
+      "tips": [],
+      "binding": "none",
+      "cva": false,
+      "path": "projects/geo-ui/src/lib/figma/geo-list-page/geo-list-page.component.ts",
+      "doc": "ai/components/geo-list-page.md",
+      "inputs": [
+        {
+          "name": "title",
+          "type": "string",
+          "default": "''",
+          "note": ""
+        },
+        {
+          "name": "breadcrumb",
+          "type": "GeoBreadcrumbItem[]",
+          "default": "[]",
+          "note": ""
+        },
+        {
+          "name": "uppercase",
+          "type": "boolean",
+          "default": "true",
+          "note": ""
+        }
+      ],
+      "outputs": [],
+      "examples": [
+        {
+          "title": "Example",
+          "lang": "html",
+          "code": "<geo-list-page title=\"Quản lý người dùng\" [breadcrumb]=\"crumbs\">\n  <geo-table-toolbar ...></geo-table-toolbar>\n  <geo-table ...></geo-table>\n</geo-list-page>"
+        }
+      ],
+      "example": "<geo-list-page title=\"Quản lý người dùng\" [breadcrumb]=\"crumbs\">\n  <geo-table-toolbar ...></geo-table-toolbar>\n  <geo-table ...></geo-table>\n</geo-list-page>",
+      "related": []
+    },
+    {
+      "name": "GeoLoginComponent",
+      "selector": "geo-login",
+      "category": "forms",
+      "summary": "Login form (username, password, captcha, remember).",
+      "whenToUse": "Specialist / admin login page.",
+      "doNotUseWhen": "SSO-only flows without local credentials.",
+      "howTo": "Form đăng nhập: username/password/captcha/remember. (submitLogin) payload; (forgotPassword) điều hướng quên mật khẩu.",
+      "tips": [
+        "Cần FormsModule + styles tokens.",
+        "Ghép geo-forgot-password trên route riêng."
+      ],
+      "binding": "none",
+      "cva": false,
+      "path": "projects/geo-ui/src/lib/figma/geo-login/geo-login.component.ts",
+      "doc": "ai/components/geo-login.md",
+      "inputs": [
+        {
+          "name": "title",
+          "type": "string",
+          "default": "'Đăng nhập hệ thống'",
+          "note": ""
+        },
+        {
+          "name": "subtitle",
+          "type": "string",
+          "default": "'Cổng tra cứu thông tin đất đai'",
+          "note": ""
+        },
+        {
+          "name": "captchaHint",
+          "type": "string",
+          "default": "'Nhập mã kiểm tra hiển thị bên cạnh'",
+          "note": ""
+        },
+        {
+          "name": "loading",
+          "type": "boolean",
+          "default": "false",
+          "note": ""
+        },
+        {
+          "name": "errorMessage",
+          "type": "string",
+          "default": "''",
+          "note": ""
+        },
+        {
+          "name": "showForgotPassword",
+          "type": "boolean",
+          "default": "true",
+          "note": ""
+        },
+        {
+          "name": "username",
+          "type": "string",
+          "default": "''",
+          "note": "Two-way `model()` (supports banana binding)."
+        },
+        {
+          "name": "password",
+          "type": "string",
+          "default": "''",
+          "note": "Two-way `model()` (supports banana binding)."
+        },
+        {
+          "name": "captcha",
+          "type": "string",
+          "default": "''",
+          "note": "Two-way `model()` (supports banana binding)."
+        },
+        {
+          "name": "remember",
+          "type": "boolean",
+          "default": "false",
+          "note": "Two-way `model()` (supports banana binding)."
+        }
+      ],
+      "outputs": [
+        {
+          "name": "submitLogin",
+          "type": "OutputEmitterRef<GeoLoginPayload>",
+          "note": ""
+        },
+        {
+          "name": "forgotPassword",
+          "type": "OutputEmitterRef<void>",
+          "note": ""
+        }
+      ],
+      "examples": [
+        {
+          "title": "Basic",
+          "lang": "html",
+          "code": "<geo-login (submitLogin)=\"login($event)\" (forgotPassword)=\"goForgot()\"></geo-login>"
+        }
+      ],
+      "example": "<geo-login (submitLogin)=\"login($event)\" (forgotPassword)=\"goForgot()\"></geo-login>",
+      "related": [
+        "geo-forgot-password",
+        "geo-input",
+        "geo-button"
+      ]
+    },
+    {
+      "name": "GeoMapComponent",
+      "selector": "geo-map",
+      "category": "map",
+      "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": "Full portal chrome — prefer geo-map-shell; non-map charts — use geo-chart.",
+      "howTo": "Host OpenLayers thuần. (mapReady) nhận GeoMapController để zoom/fit/addLayer. Layers typed (osm/xyz/wms/wmts/geojson). Projections tùy chỉnh qua [projections] — không invent VN-2000.",
+      "tips": [
+        "Portal đầy đủ → geo-map-shell.",
+        "showZoomControl=false khi dùng geo-map-zoom riêng.",
+        "Peers: ol, proj4."
+      ],
+      "binding": "none",
+      "cva": false,
+      "path": "projects/geo-ui/src/lib/figma/geo-map/geo-map.component.ts",
+      "doc": "ai/components/geo-map.md",
+      "inputs": [
+        {
+          "name": "center",
+          "type": "number[]",
+          "default": "[...GEO_MAP_DEFAULT_CENTER]",
+          "note": "Map center in view projection (default Web Mercator Đà Lạt area)."
+        },
+        {
+          "name": "zoom",
+          "type": "",
+          "default": "GEO_MAP_DEFAULT_ZOOM",
+          "note": ""
+        },
+        {
+          "name": "minZoom",
+          "type": "",
+          "default": "GEO_MAP_DEFAULT_MIN_ZOOM",
+          "note": ""
+        },
+        {
+          "name": "maxZoom",
+          "type": "",
+          "default": "GEO_MAP_DEFAULT_MAX_ZOOM",
+          "note": ""
+        },
+        {
+          "name": "viewProjection",
+          "type": "",
+          "default": "GEO_MAP_DEFAULT_VIEW_PROJECTION",
+          "note": ""
+        },
+        {
+          "name": "basemap",
+          "type": "'osm' | { type: 'xyz'",
+          "default": "'osm'",
+          "note": ""
+        },
+        {
+          "name": "layers",
+          "type": "(| GeoMapOsmLayerConfig | GeoMapXyzLayerConfig | GeoMapWmsLayerConfig | GeoMapWmtsLayerConfig | G…",
+          "default": "[]",
+          "note": ""
+        },
+        {
+          "name": "height",
+          "type": "",
+          "default": "GEO_MAP_DEFAULT_HEIGHT",
+          "note": ""
+        },
+        {
+          "name": "registerProjections",
+          "type": "boolean",
+          "default": "true",
+          "note": "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."
+        },
+        {
+          "name": "projections",
+          "type": "ProjectionConfig[]",
+          "default": "[]",
+          "note": "Custom CRS definitions (e.g. local VN-2000 from environment)."
+        },
+        {
+          "name": "showMousePosition",
+          "type": "boolean",
+          "default": "false",
+          "note": ""
+        },
+        {
+          "name": "mousePositionProjection",
+          "type": "string",
+          "default": "'EPSG:4326'",
+          "note": ""
+        },
+        {
+          "name": "showZoomControl",
+          "type": "boolean",
+          "default": "true",
+          "note": "When false, hide built-in OL zoom control (prefer `geo-map-zoom`)."
+        }
+      ],
+      "outputs": [
+        {
+          "name": "mapReady",
+          "type": "OutputEmitterRef<GeoMapController>",
+          "note": ""
+        },
+        {
+          "name": "mapClick",
+          "type": "OutputEmitterRef<GeoMapClickEvent>",
+          "note": ""
+        },
+        {
+          "name": "viewChange",
+          "type": "OutputEmitterRef<GeoMapViewChangeEvent>",
+          "note": ""
+        },
+        {
+          "name": "initError",
+          "type": "OutputEmitterRef<string>",
+          "note": ""
+        }
+      ],
+      "examples": [
+        {
+          "title": "Basic",
+          "lang": "html",
+          "code": "<geo-map height=\"480px\" basemap=\"osm\" [center]=\"[108.45, 11.94]\" [zoom]=\"12\" (mapReady)=\"ctrl = $event\"></geo-map>"
+        }
+      ],
+      "example": "<geo-map height=\"480px\" basemap=\"osm\" [center]=\"[108.45, 11.94]\" [zoom]=\"12\" (mapReady)=\"ctrl = $event\"></geo-map>",
+      "related": [
+        "geo-map-shell",
+        "geo-map-zoom",
+        "geo-map-toolbar"
+      ]
+    },
+    {
+      "name": "GeoMapAdminFilterComponent",
+      "selector": "geo-map-admin-filter",
+      "category": "map",
+      "summary": "Administrative unit tree filter (ĐVHC) for map extent.",
+      "whenToUse": "Filter map by tỉnh/huyện/xã; included in geo-map-shell.",
+      "doNotUseWhen": "Generic trees outside map — use geo-tree.",
+      "howTo": "",
+      "tips": [],
+      "binding": "none",
+      "cva": false,
+      "path": "projects/geo-ui/src/lib/figma/geo-map/chrome/geo-map-admin-filter/geo-map-admin-filter.component.ts",
+      "doc": "ai/components/geo-map-admin-filter.md",
+      "inputs": [
+        {
+          "name": "open",
+          "type": "boolean",
+          "default": "false",
+          "note": "Two-way `model()` (supports banana binding)."
+        },
+        {
+          "name": "title",
+          "type": "string",
+          "default": "'Đơn vị hành chính'",
+          "note": ""
+        },
+        {
+          "name": "nodes",
+          "type": "GeoTreeNode[]",
+          "default": "[]",
+          "note": ""
+        },
+        {
+          "name": "checkedKeys",
+          "type": "Array<string | number>",
+          "default": "[]",
+          "note": "Two-way `model()` (supports banana binding)."
+        },
+        {
+          "name": "expandedKeys",
+          "type": "Array<string | number>",
+          "default": "[]",
+          "note": "Two-way `model()` (supports banana binding)."
+        }
+      ],
+      "outputs": [
+        {
+          "name": "apply",
+          "type": "OutputEmitterRef<Array<string | number>>",
+          "note": ""
+        },
+        {
+          "name": "reset",
+          "type": "OutputEmitterRef<void>",
+          "note": ""
+        },
+        {
+          "name": "fitProvince",
+          "type": "OutputEmitterRef<void>",
+          "note": ""
+        },
+        {
+          "name": "closed",
+          "type": "OutputEmitterRef<void>",
+          "note": ""
+        },
+        {
+          "name": "selectionChange",
+          "type": "OutputEmitterRef<Array<string | number>>",
+          "note": ""
+        }
+      ],
+      "examples": [
+        {
+          "title": "Example",
+          "lang": "html",
+          "code": "<geo-map-admin-filter\n  [(open)]=\"adminOpen\"\n  [nodes]=\"adminNodes\"\n  [(checkedKeys)]=\"checked\"\n  (apply)=\"applyAdmin($event)\"\n></geo-map-admin-filter>"
+        }
+      ],
+      "example": "<geo-map-admin-filter\n  [(open)]=\"adminOpen\"\n  [nodes]=\"adminNodes\"\n  [(checkedKeys)]=\"checked\"\n  (apply)=\"applyAdmin($event)\"\n></geo-map-admin-filter>",
+      "related": []
+    },
+    {
+      "name": "GeoMapBasemapSwitcherComponent",
+      "selector": "geo-map-basemap-switcher",
+      "category": "map",
+      "summary": "Basemap preview chip (e.g. street ↔ satellite).",
+      "whenToUse": "Bottom-right basemap toggle; included in geo-map-shell.",
+      "doNotUseWhen": "Programmatic basemap only — set geo-map [basemap] / shell basemapId.",
+      "howTo": "",
+      "tips": [],
+      "binding": "none",
+      "cva": false,
+      "path": "projects/geo-ui/src/lib/figma/geo-map/chrome/geo-map-basemap-switcher/geo-map-basemap-switcher.component.ts",
+      "doc": "ai/components/geo-map-basemap-switcher.md",
+      "inputs": [
+        {
+          "name": "options",
+          "type": "GeoMapBasemapOption[]",
+          "default": "GEO_MAP_DEFAULT_BASEMAP_OPTIONS",
+          "note": "Exactly two options (street + satellite). Extra items are ignored."
+        },
+        {
+          "name": "selectedId",
+          "type": "string",
+          "default": "'osm'",
+          "note": "Two-way `model()` (supports banana binding)."
+        },
+        {
+          "name": "label",
+          "type": "string",
+          "default": "'Lớp bản đồ'",
+          "note": "Caption on the thumbnail card (design: «Lớp bản đồ»)."
+        },
+        {
+          "name": "tooltip",
+          "type": "string",
+          "default": "'Đổi lớp bản đồ nền'",
+          "note": ""
+        }
+      ],
+      "outputs": [
+        {
+          "name": "basemapChange",
+          "type": "OutputEmitterRef<GeoMapBasemap>",
+          "note": ""
+        }
+      ],
+      "examples": [
+        {
+          "title": "Example",
+          "lang": "html",
+          "code": "<geo-map-basemap-switcher\n  [options]=\"basemapOptions\"\n  [(selectedId)]=\"basemapId\"\n  (basemapChange)=\"onBasemap($event)\"\n></geo-map-basemap-switcher>"
+        }
+      ],
+      "example": "<geo-map-basemap-switcher\n  [options]=\"basemapOptions\"\n  [(selectedId)]=\"basemapId\"\n  (basemapChange)=\"onBasemap($event)\"\n></geo-map-basemap-switcher>",
+      "related": []
+    },
+    {
+      "name": "GeoMapHelpComponent",
+      "selector": "geo-map-help",
+      "category": "map",
+      "summary": "Map help / hướng dẫn popover with sections.",
+      "whenToUse": "Help affordance on map chrome.",
+      "doNotUseWhen": "App-wide help pages — use normal content pages.",
+      "howTo": "",
+      "tips": [],
+      "binding": "none",
+      "cva": false,
+      "path": "projects/geo-ui/src/lib/figma/geo-map/chrome/geo-map-help/geo-map-help.component.ts",
+      "doc": "ai/components/geo-map-help.md",
+      "inputs": [
+        {
+          "name": "open",
+          "type": "boolean",
+          "default": "false",
+          "note": "Two-way `model()` (supports banana binding)."
+        },
+        {
+          "name": "title",
+          "type": "string",
+          "default": "'Hướng dẫn sử dụng'",
+          "note": ""
+        },
+        {
+          "name": "sections",
+          "type": "GeoMapHelpSection[]",
+          "default": "GEO_MAP_DEFAULT_HELP_SECTIONS",
+          "note": ""
+        }
+      ],
+      "outputs": [],
+      "examples": [
+        {
+          "title": "Example",
+          "lang": "html",
+          "code": "<geo-map-help [(open)]=\"helpOpen\" [sections]=\"helpSections\"></geo-map-help>"
+        }
+      ],
+      "example": "<geo-map-help [(open)]=\"helpOpen\" [sections]=\"helpSections\"></geo-map-help>",
+      "related": []
+    },
+    {
+      "name": "GeoMapLayerCardComponent",
+      "selector": "geo-map-layer-card",
+      "category": "map",
+      "summary": "Basemap / layer preview card (thumbnail + title).",
+      "whenToUse": "Layer pickers and basemap grids.",
+      "doNotUseWhen": "Full layer management — use geo-map-layer-panel.",
+      "howTo": "",
+      "tips": [],
+      "binding": "none",
+      "cva": false,
+      "path": "projects/geo-ui/src/lib/figma/geo-map/chrome/geo-map-layer-card/geo-map-layer-card.component.ts",
+      "doc": "ai/components/geo-map-layer-card.md",
+      "inputs": [
+        {
+          "name": "title",
+          "type": "string",
+          "default": "'Lớp bản đồ'",
+          "note": ""
+        },
+        {
+          "name": "previewUrl",
+          "type": "string | undefined",
+          "default": "undefined",
+          "note": ""
+        }
+      ],
+      "outputs": [
+        {
+          "name": "clicked",
+          "type": "OutputEmitterRef<void>",
+          "note": ""
+        }
+      ],
+      "examples": [
+        {
+          "title": "Example",
+          "lang": "html",
+          "code": "<geo-map-layer-card title=\"Đường phố\" [previewUrl]=\"url\" (clicked)=\"select()\"></geo-map-layer-card>"
+        }
+      ],
+      "example": "<geo-map-layer-card title=\"Đường phố\" [previewUrl]=\"url\" (clicked)=\"select()\"></geo-map-layer-card>",
+      "related": []
+    },
+    {
+      "name": "GeoMapLayerPanelComponent",
+      "selector": "geo-map-layer-panel",
+      "category": "map",
+      "summary": "Layer list with visibility / opacity / group selection.",
+      "whenToUse": "Standalone layer manager or inside geo-map-layers-drawer.",
+      "doNotUseWhen": "Single opacity control — use geo-map-opacity.",
+      "howTo": "",
+      "tips": [],
+      "binding": "none",
+      "cva": false,
+      "path": "projects/geo-ui/src/lib/figma/geo-map/chrome/geo-map-layer-panel/geo-map-layer-panel.component.ts",
+      "doc": "ai/components/geo-map-layer-panel.md",
+      "inputs": [
+        {
+          "name": "controller",
+          "type": "GeoMapController | null",
+          "default": "null",
+          "note": ""
+        },
+        {
+          "name": "title",
+          "type": "string",
+          "default": "'Lớp bản đồ'",
+          "note": ""
+        },
+        {
+          "name": "embedded",
+          "type": "boolean",
+          "default": "false",
+          "note": "When true, hide the panel's own header (host popover provides title)."
+        },
+        {
+          "name": "layers",
+          "type": "GeoMapLayerConfig[]",
+          "default": "[]",
+          "note": "Two-way `model()` (supports banana binding)."
+        }
+      ],
+      "outputs": [
+        {
+          "name": "layersChange",
+          "type": "OutputEmitterRef<GeoMapLayerConfig[]>",
+          "note": ""
+        }
+      ],
+      "examples": [
+        {
+          "title": "Example",
+          "lang": "html",
+          "code": "<geo-map-layer-panel [layers]=\"layers\" [controller]=\"ctrl\" [embedded]=\"true\"></geo-map-layer-panel>"
+        }
+      ],
+      "example": "<geo-map-layer-panel [layers]=\"layers\" [controller]=\"ctrl\" [embedded]=\"true\"></geo-map-layer-panel>",
+      "related": []
+    },
+    {
+      "name": "GeoMapLayersDrawerComponent",
+      "selector": "geo-map-layers-drawer",
+      "category": "map",
+      "summary": "Popover/drawer hosting the layer panel (“Lớp bản đồ”).",
+      "whenToUse": "Portal layer UI; included in geo-map-shell.",
+      "doNotUseWhen": "Always-visible side panel — embed geo-map-layer-panel directly.",
+      "howTo": "",
+      "tips": [],
+      "binding": "none",
+      "cva": false,
+      "path": "projects/geo-ui/src/lib/figma/geo-map/chrome/geo-map-layers-drawer/geo-map-layers-drawer.component.ts",
+      "doc": "ai/components/geo-map-layers-drawer.md",
+      "inputs": [
+        {
+          "name": "controller",
+          "type": "GeoMapController | null",
+          "default": "null",
+          "note": ""
+        },
+        {
+          "name": "open",
+          "type": "boolean",
+          "default": "false",
+          "note": "Two-way `model()` (supports banana binding)."
+        },
+        {
+          "name": "title",
+          "type": "string",
+          "default": "'Lớp bản đồ'",
+          "note": ""
+        },
+        {
+          "name": "legendItems",
+          "type": "GeoMapLegendItem[]",
+          "default": "[]",
+          "note": ""
+        },
+        {
+          "name": "showOpacity",
+          "type": "boolean",
+          "default": "false",
+          "note": "Kept for API compat — opacity is per-layer in the new panel."
+        },
+        {
+          "name": "showLegend",
+          "type": "boolean",
+          "default": "false",
+          "note": "Kept for API compat — legend lives outside this popover."
+        },
+        {
+          "name": "layers",
+          "type": "GeoMapLayerConfig[]",
+          "default": "[]",
+          "note": "Two-way `model()` (supports banana binding)."
+        }
+      ],
+      "outputs": [
+        {
+          "name": "closed",
+          "type": "OutputEmitterRef<void>",
+          "note": ""
+        }
+      ],
+      "examples": [
+        {
+          "title": "Example",
+          "lang": "html",
+          "code": "<geo-map-layers-drawer [(open)]=\"layersOpen\" [layers]=\"layers\" [controller]=\"ctrl\"></geo-map-layers-drawer>"
+        }
+      ],
+      "example": "<geo-map-layers-drawer [(open)]=\"layersOpen\" [layers]=\"layers\" [controller]=\"ctrl\"></geo-map-layers-drawer>",
+      "related": []
+    },
+    {
+      "name": "GeoMapLegendComponent",
+      "selector": "geo-map-legend",
+      "category": "map",
+      "summary": "Map legend popover / panel with color swatches.",
+      "whenToUse": "Show thematic legend; geo-map-shell includes this.",
+      "doNotUseWhen": "Non-map legends in dashboards — use static markup / geo-status-tag.",
+      "howTo": "",
+      "tips": [],
+      "binding": "none",
+      "cva": false,
+      "path": "projects/geo-ui/src/lib/figma/geo-map/chrome/geo-map-legend/geo-map-legend.component.ts",
+      "doc": "ai/components/geo-map-legend.md",
+      "inputs": [
+        {
+          "name": "title",
+          "type": "string",
+          "default": "'Chú giải'",
+          "note": ""
+        },
+        {
+          "name": "items",
+          "type": "GeoMapLegendItem[]",
+          "default": "[]",
+          "note": ""
+        },
+        {
+          "name": "open",
+          "type": "boolean",
+          "default": "false",
+          "note": "Two-way `model()` (supports banana binding)."
+        }
+      ],
+      "outputs": [
+        {
+          "name": "closed",
+          "type": "OutputEmitterRef<void>",
+          "note": ""
+        }
+      ],
+      "examples": [
+        {
+          "title": "Example",
+          "lang": "html",
+          "code": "<geo-map-legend [(open)]=\"legendOpen\" [items]=\"legendItems\"></geo-map-legend>"
+        }
+      ],
+      "example": "<geo-map-legend [(open)]=\"legendOpen\" [items]=\"legendItems\"></geo-map-legend>",
+      "related": []
+    },
+    {
+      "name": "GeoMapLocateComponent",
+      "selector": "geo-map-locate",
+      "category": "map",
+      "summary": "Geolocation button (browser GPS) for the map view.",
+      "whenToUse": "Locate-me control on custom map chrome.",
+      "doNotUseWhen": "Inside geo-map-shell (already wired) unless building a custom shell.",
+      "howTo": "",
+      "tips": [],
+      "binding": "none",
+      "cva": false,
+      "path": "projects/geo-ui/src/lib/figma/geo-map/chrome/geo-map-locate/geo-map-locate.component.ts",
+      "doc": "ai/components/geo-map-locate.md",
+      "inputs": [
+        {
+          "name": "controller",
+          "type": "GeoMapController | null",
+          "default": "null",
+          "note": ""
+        },
+        {
+          "name": "label",
+          "type": "string",
+          "default": "'Vị trí của tôi'",
+          "note": ""
+        }
+      ],
+      "outputs": [
+        {
+          "name": "located",
+          "type": "OutputEmitterRef<[number, number]>",
+          "note": ""
+        },
+        {
+          "name": "denied",
+          "type": "OutputEmitterRef<void>",
+          "note": ""
+        },
+        {
+          "name": "locateError",
+          "type": "OutputEmitterRef<{ reason: GeoMapLocateErrorReason; message?: string; }>",
+          "note": ""
+        }
+      ],
+      "examples": [
+        {
+          "title": "Example",
+          "lang": "html",
+          "code": "<geo-map-locate [controller]=\"ctrl\" (denied)=\"onDenied()\"></geo-map-locate>"
+        }
+      ],
+      "example": "<geo-map-locate [controller]=\"ctrl\" (denied)=\"onDenied()\"></geo-map-locate>",
+      "related": []
+    },
+    {
+      "name": "GeoMapLocationChipComponent",
+      "selector": "geo-map-location-chip",
+      "category": "map",
+      "summary": "Location breadcrumb chip shown on the map (ward / province).",
+      "whenToUse": "Show current admin context on map chrome.",
+      "doNotUseWhen": "Page breadcrumb — use geo-breadcrumb.",
+      "howTo": "",
+      "tips": [],
+      "binding": "none",
+      "cva": false,
+      "path": "projects/geo-ui/src/lib/figma/geo-map/chrome/geo-map-location-chip/geo-map-location-chip.component.ts",
+      "doc": "ai/components/geo-map-location-chip.md",
+      "inputs": [
+        {
+          "name": "label",
+          "type": "string",
+          "default": "''",
+          "note": ""
+        },
+        {
+          "name": "icon",
+          "type": "string",
+          "default": "'environment'",
+          "note": ""
+        }
+      ],
+      "outputs": [],
+      "examples": [
+        {
+          "title": "Example",
+          "lang": "html",
+          "code": "<geo-map-location-chip label=\"Phường 1 — TP Đà Lạt, Lâm Đồng\"></geo-map-location-chip>"
+        }
+      ],
+      "example": "<geo-map-location-chip label=\"Phường 1 — TP Đà Lạt, Lâm Đồng\"></geo-map-location-chip>",
+      "related": []
+    },
+    {
+      "name": "GeoMapMeasureComponent",
+      "selector": "geo-map-measure",
+      "category": "map",
+      "summary": "Distance / area measure interaction on the map.",
+      "whenToUse": "Measure tool mode; usually driven by toolbar via geo-map-shell.",
+      "doNotUseWhen": "Static length labels without interaction.",
+      "howTo": "",
+      "tips": [],
+      "binding": "none",
+      "cva": false,
+      "path": "projects/geo-ui/src/lib/figma/geo-map/chrome/geo-map-measure/geo-map-measure.component.ts",
+      "doc": "ai/components/geo-map-measure.md",
+      "inputs": [
+        {
+          "name": "controller",
+          "type": "GeoMapController | null",
+          "default": "null",
+          "note": ""
+        },
+        {
+          "name": "mode",
+          "type": "GeoMapMeasureMode",
+          "default": "'none'",
+          "note": "Two-way `model()` (supports banana binding)."
+        },
+        {
+          "name": "showResult",
+          "type": "boolean",
+          "default": "true",
+          "note": ""
+        }
+      ],
+      "outputs": [
+        {
+          "name": "measureChange",
+          "type": "OutputEmitterRef<GeoMapMeasureResult | null>",
+          "note": ""
+        }
+      ],
+      "examples": [
+        {
+          "title": "Example",
+          "lang": "html",
+          "code": "<geo-map-measure [controller]=\"ctrl\" [(mode)]=\"measureMode\"></geo-map-measure>"
+        }
+      ],
+      "example": "<geo-map-measure [controller]=\"ctrl\" [(mode)]=\"measureMode\"></geo-map-measure>",
+      "related": []
+    },
+    {
+      "name": "GeoMapOpacityComponent",
+      "selector": "geo-map-opacity",
+      "category": "map",
+      "summary": "Layer opacity slider bound to a map layer id.",
+      "whenToUse": "Adjust overlay transparency in custom layer UI.",
+      "doNotUseWhen": "Full layer list — use geo-map-layer-panel / layers drawer.",
+      "howTo": "",
+      "tips": [],
+      "binding": "none",
+      "cva": false,
+      "path": "projects/geo-ui/src/lib/figma/geo-map/chrome/geo-map-opacity/geo-map-opacity.component.ts",
+      "doc": "ai/components/geo-map-opacity.md",
+      "inputs": [
+        {
+          "name": "controller",
+          "type": "GeoMapController | null",
+          "default": "null",
+          "note": ""
+        },
+        {
+          "name": "title",
+          "type": "string",
+          "default": "'Độ trong suốt'",
+          "note": ""
+        },
+        {
+          "name": "layerId",
+          "type": "string | null",
+          "default": "null",
+          "note": "Two-way `model()` (supports banana binding)."
+        },
+        {
+          "name": "opacity",
+          "type": "number",
+          "default": "100",
+          "note": "Opacity percent 0–100. — Two-way `model()` (supports banana binding)."
+        },
+        {
+          "name": "variant",
+          "type": "'panel' | 'compact'",
+          "default": "'panel'",
+          "note": ""
+        },
+        {
+          "name": "applyToFirstLayer",
+          "type": "boolean",
+          "default": "true",
+          "note": "When compact and no layerId, apply to first non-basemap overlay."
+        }
+      ],
+      "outputs": [],
+      "examples": [
+        {
+          "title": "Example",
+          "lang": "html",
+          "code": "<geo-map-opacity [controller]=\"ctrl\" layerId=\"demo-qhsdd-2020\" [(opacity)]=\"opacity\"></geo-map-opacity>"
+        }
+      ],
+      "example": "<geo-map-opacity [controller]=\"ctrl\" layerId=\"demo-qhsdd-2020\" [(opacity)]=\"opacity\"></geo-map-opacity>",
+      "related": []
+    },
+    {
+      "name": "GeoMapParcelPopupComponent",
+      "selector": "geo-map-parcel-popup",
+      "category": "map",
+      "summary": "Parcel detail popup (citizen / specialist audience).",
+      "whenToUse": "Show thửa detail after search or map click.",
+      "doNotUseWhen": "Full detail page — navigate to a route instead.",
+      "howTo": "",
+      "tips": [],
+      "binding": "none",
+      "cva": false,
+      "path": "projects/geo-ui/src/lib/figma/geo-map/chrome/geo-map-parcel-popup/geo-map-parcel-popup.component.ts",
+      "doc": "ai/components/geo-map-parcel-popup.md",
+      "inputs": [
+        {
+          "name": "open",
+          "type": "boolean",
+          "default": "false",
+          "note": "Two-way `model()` (supports banana binding)."
+        },
+        {
+          "name": "title",
+          "type": "string",
+          "default": "'Thông tin thửa đất'",
+          "note": ""
+        },
+        {
+          "name": "parcel",
+          "type": "GeoMapParcelDetail | null",
+          "default": "null",
+          "note": ""
+        },
+        {
+          "name": "audience",
+          "type": "GeoMapParcelAudience",
+          "default": "'citizen'",
+          "note": ""
+        },
+        {
+          "name": "showExport",
+          "type": "boolean",
+          "default": "false",
+          "note": "Giữ tương thích API cũ; footer xuất file không còn trong layout thiết kế."
+        }
+      ],
+      "outputs": [
+        {
+          "name": "closed",
+          "type": "OutputEmitterRef<void>",
+          "note": ""
+        },
+        {
+          "name": "back",
+          "type": "OutputEmitterRef<void>",
+          "note": ""
+        },
+        {
+          "name": "exportClick",
+          "type": "OutputEmitterRef<GeoMapParcelDetail>",
+          "note": ""
+        },
+        {
+          "name": "diagramClick",
+          "type": "OutputEmitterRef<GeoMapParcelDetail>",
+          "note": ""
+        }
+      ],
+      "examples": [
+        {
+          "title": "Example",
+          "lang": "html",
+          "code": "<geo-map-parcel-popup\n  [(open)]=\"parcelOpen\"\n  [parcel]=\"selected\"\n  audience=\"citizen\"\n  (exportClick)=\"exportPdf($event)\"\n></geo-map-parcel-popup>"
+        }
+      ],
+      "example": "<geo-map-parcel-popup\n  [(open)]=\"parcelOpen\"\n  [parcel]=\"selected\"\n  audience=\"citizen\"\n  (exportClick)=\"exportPdf($event)\"\n></geo-map-parcel-popup>",
+      "related": []
+    },
+    {
+      "name": "GeoMapSearchComponent",
+      "selector": "geo-map-search",
+      "category": "map",
+      "summary": "Map search panel (owner / certificate / parcel / address / coordinates).",
+      "whenToUse": "Tra cứu thửa on portal; prefer via geo-map-shell.",
+      "doNotUseWhen": "Global app search unrelated to map.",
+      "howTo": "",
+      "tips": [],
+      "binding": "none",
+      "cva": false,
+      "path": "projects/geo-ui/src/lib/figma/geo-map/chrome/geo-map-search/geo-map-search.component.ts",
+      "doc": "ai/components/geo-map-search.md",
+      "inputs": [
+        {
+          "name": "open",
+          "type": "boolean",
+          "default": "false",
+          "note": "Two-way `model()` (supports banana binding)."
+        },
+        {
+          "name": "title",
+          "type": "string",
+          "default": "'Tra cứu thông tin quy hoạch theo'",
+          "note": ""
+        },
+        {
+          "name": "mode",
+          "type": "GeoMapSearchMode",
+          "default": "'parcel'",
+          "note": "Two-way `model()` (supports banana binding)."
+        },
+        {
+          "name": "results",
+          "type": "GeoMapSearchResultItem[]",
+          "default": "[]",
+          "note": ""
+        },
+        {
+          "name": "loading",
+          "type": "boolean",
+          "default": "false",
+          "note": ""
+        },
+        {
+          "name": "pageIndex",
+          "type": "number",
+          "default": "1",
+          "note": "Two-way `model()` (supports banana binding)."
+        },
+        {
+          "name": "pageSize",
+          "type": "number",
+          "default": "5",
+          "note": "Two-way `model()` (supports banana binding)."
+        },
+        {
+          "name": "total",
+          "type": "number",
+          "default": "0",
+          "note": ""
+        },
+        {
+          "name": "emptyText",
+          "type": "string",
+          "default": "'Chưa có kết quả tra cứu.'",
+          "note": ""
+        }
+      ],
+      "outputs": [
+        {
+          "name": "search",
+          "type": "OutputEmitterRef<GeoMapSearchQuery>",
+          "note": ""
+        },
+        {
+          "name": "reset",
+          "type": "OutputEmitterRef<void>",
+          "note": ""
+        },
+        {
+          "name": "resultSelect",
+          "type": "OutputEmitterRef<GeoMapSearchResultItem>",
+          "note": ""
+        },
+        {
+          "name": "closed",
+          "type": "OutputEmitterRef<void>",
+          "note": ""
+        }
+      ],
+      "examples": [
+        {
+          "title": "Example",
+          "lang": "html",
+          "code": "<geo-map-search\n  [(open)]=\"searchOpen\"\n  mode=\"parcel\"\n  [results]=\"results\"\n  (search)=\"runSearch($event)\"\n  (resultSelect)=\"onSelect($event)\"\n></geo-map-search>"
+        }
+      ],
+      "example": "<geo-map-search\n  [(open)]=\"searchOpen\"\n  mode=\"parcel\"\n  [results]=\"results\"\n  (search)=\"runSearch($event)\"\n  (resultSelect)=\"onSelect($event)\"\n></geo-map-search>",
+      "related": []
+    },
+    {
+      "name": "GeoMapShellComponent",
+      "selector": "geo-map-shell",
+      "category": "map",
+      "summary": "Full map portal chrome: search, ĐVHC, layers, legend, measure, basemap, parcel popup.",
+      "whenToUse": "Public / specialist map portal pages (tra cứu quy hoạch). Prefer this over composing chrome by hand.",
+      "doNotUseWhen": "Bare map embed without UI chrome — use geo-map only.",
+      "howTo": "Shell portal tra cứu: gắn height + layers API; tắt demoSearch trên production. Lắng nghe (search)/(resultSelect)/(parcelExport). Models [(searchOpen)], [(layersOpen)], … để điều khiển panel từ ngoài.",
+      "tips": [
+        "Ưu tiên geo-map-shell thay vì tự ghép chrome.",
+        "Peers bắt buộc: ol, proj4.",
+        "demoSearch=true chỉ cho Storybook/demo — production phải false + API thật.",
+        "parcelAudience: citizen | specialist.",
+        "Đọc geo-map.md cho layer types / projections."
+      ],
+      "binding": "none",
+      "cva": false,
+      "path": "projects/geo-ui/src/lib/figma/geo-map/chrome/geo-map-shell/geo-map-shell.component.ts",
+      "doc": "ai/components/geo-map-shell.md",
+      "inputs": [
+        {
+          "name": "center",
+          "type": "number[]",
+          "default": "[...GEO_MAP_DEFAULT_CENTER]",
+          "note": ""
+        },
+        {
+          "name": "zoom",
+          "type": "",
+          "default": "GEO_MAP_DEFAULT_ZOOM",
+          "note": ""
+        },
+        {
+          "name": "height",
+          "type": "string",
+          "default": "'560px'",
+          "note": ""
+        },
+        {
+          "name": "showMousePosition",
+          "type": "boolean",
+          "default": "false",
+          "note": ""
+        },
+        {
+          "name": "basemapOptions",
+          "type": "GeoMapBasemapOption[]",
+          "default": "GEO_MAP_DEFAULT_BASEMAP_OPTIONS",
+          "note": ""
+        },
+        {
+          "name": "toolbarActions",
+          "type": "GeoMapToolbarAction[]",
+          "default": "GEO_MAP_DEFAULT_TOOLBAR_ACTIONS",
+          "note": ""
+        },
+        {
+          "name": "layers",
+          "type": "GeoMapLayerConfig[]",
+          "default": "[]",
+          "note": "Extra overlays merged after demo thematic + traffic."
+        },
+        {
+          "name": "legendItems",
+          "type": "GeoMapLegendItem[]",
+          "default": "GEO_MAP_DEMO_LEGEND_ITEMS",
+          "note": ""
+        },
+        {
+          "name": "showNav",
+          "type": "boolean",
+          "default": "true",
+          "note": ""
+        },
+        {
+          "name": "includeDemoLayers",
+          "type": "boolean",
+          "default": "true",
+          "note": ""
+        },
+        {
+          "name": "adminNodes",
+          "type": "GeoTreeNode[]",
+          "default": "GEO_MAP_DEMO_ADMIN_NODES",
+          "note": ""
+        },
+        {
+          "name": "locationLabel",
+          "type": "string",
+          "default": "'Phường 1 — TP Đà Lạt, Lâm Đồng'",
+          "note": ""
+        },
+        {
+          "name": "parcelAudience",
+          "type": "GeoMapParcelAudience",
+          "default": "'citizen'",
+          "note": ""
+        },
+        {
+          "name": "provinceExtent",
+          "type": "readonly [number, number, number, number]",
+          "default": "GEO_MAP_DEFAULT_PROVINCE_EXTENT_4326",
+          "note": ""
+        },
+        {
+          "name": "demoSearch",
+          "type": "boolean",
+          "default": "true",
+          "note": "When true, shell seeds mock search results (Storybook / demos)."
+        },
+        {
+          "name": "homeMode",
+          "type": "'location' | 'emit'",
+          "default": "'location'",
+          "note": "`location` — Home opens ĐVHC filter (default). `emit` — Home only emits `actionClick` (e.g. portal navigates to login/dashboard)."
+        },
+        {
+          "name": "basemapId",
+          "type": "string",
+          "default": "'osm'",
+          "note": "Two-way `model()` (supports banana binding)."
+        },
+        {
+          "name": "measureMode",
+          "type": "GeoMapMeasureMode",
+          "default": "'none'",
+          "note": "Two-way `model()` (supports banana binding)."
+        },
+        {
+          "name": "checkedMap",
+          "type": "Record<string, boolean>",
+          "default": "",
+          "note": "Two-way `model()` (supports banana binding)."
+        },
+        {
+          "name": "layersOpen",
+          "type": "boolean",
+          "default": "false",
+          "note": "Two-way `model()` (supports banana binding)."
+        },
+        {
+          "name": "legendOpen",
+          "type": "boolean",
+          "default": "false",
+          "note": "Two-way `model()` (supports banana binding)."
+        },
+        {
+          "name": "helpOpen",
+          "type": "boolean",
+          "default": "false",
+          "note": "Two-way `model()` (supports banana binding)."
+        },
+        {
+          "name": "swipeActive",
+          "type": "boolean",
+          "default": "false",
+          "note": "Two-way `model()` (supports banana binding)."
+        },
+        {
+          "name": "searchOpen",
+          "type": "boolean",
+          "default": "false",
+          "note": "Two-way `model()` (supports banana binding)."
+        },
+        {
+          "name": "adminFilterOpen",
+          "type": "boolean",
+          "default": "false",
+          "note": "Two-way `model()` (supports banana binding)."
+        },
+        {
+          "name": "parcelOpen",
+          "type": "boolean",
+          "default": "false",
+          "note": "Two-way `model()` (supports banana binding)."
+        },
+        {
+          "name": "managedLayers",
+          "type": "GeoMapLayerConfig[]",
+          "default": "[]",
+          "note": "Two-way `model()` (supports banana binding)."
+        },
+        {
+          "name": "searchResults",
+          "type": "GeoMapSearchResultItem[]",
+          "default": "[]",
+          "note": "Two-way `model()` (supports banana binding)."
+        },
+        {
+          "name": "selectedParcel",
+          "type": "GeoMapParcelDetail | null",
+          "default": "null",
+          "note": "Two-way `model()` (supports banana binding)."
+        },
+        {
+          "name": "adminCheckedKeys",
+          "type": "Array<string | number>",
+          "default": "[]",
+          "note": "Two-way `model()` (supports banana binding)."
+        },
+        {
+          "name": "adminExpandedKeys",
+          "type": "Array<string | number>",
+          "default": "['lam-dong']",
+          "note": "Two-way `model()` (supports banana binding)."
+        }
+      ],
+      "outputs": [
+        {
+          "name": "mapReady",
+          "type": "OutputEmitterRef<GeoMapController>",
+          "note": ""
+        },
+        {
+          "name": "mapClick",
+          "type": "OutputEmitterRef<GeoMapClickEvent>",
+          "note": ""
+        },
+        {
+          "name": "locateDenied",
+          "type": "OutputEmitterRef<void>",
+          "note": ""
+        },
+        {
+          "name": "actionClick",
+          "type": "OutputEmitterRef<GeoMapToolbarAction>",
+          "note": ""
+        },
+        {
+          "name": "search",
+          "type": "OutputEmitterRef<GeoMapSearchQuery>",
+          "note": ""
+        },
+        {
+          "name": "searchReset",
+          "type": "OutputEmitterRef<void>",
+          "note": ""
+        },
+        {
+          "name": "resultSelect",
+          "type": "OutputEmitterRef<GeoMapSearchResultItem>",
+          "note": ""
+        },
+        {
+          "name": "parcelExport",
+          "type": "OutputEmitterRef<GeoMapParcelDetail>",
+          "note": ""
+        },
+        {
+          "name": "adminApply",
+          "type": "OutputEmitterRef<Array<string | number>>",
+          "note": ""
+        }
+      ],
+      "examples": [
+        {
+          "title": "Basic portal",
+          "lang": "html",
+          "code": "<geo-map-shell\n  height=\"640px\"\n  [demoSearch]=\"false\"\n  parcelAudience=\"citizen\"\n  [layers]=\"layers\"\n  (mapReady)=\"ctrl = $event\"\n  (search)=\"onSearch($event)\"\n></geo-map-shell>"
+        },
+        {
+          "title": "Open search panel",
+          "lang": "html",
+          "code": "<geo-map-shell\n  height=\"640px\"\n  [demoSearch]=\"false\"\n  [(searchOpen)]=\"searchOpen\"\n  [(searchResults)]=\"results\"\n  (search)=\"runQuery($event)\"\n  (resultSelect)=\"onResult($event)\"\n></geo-map-shell>"
+        }
+      ],
+      "example": "<geo-map-shell\n  height=\"640px\"\n  [demoSearch]=\"false\"\n  parcelAudience=\"citizen\"\n  [layers]=\"layers\"\n  (mapReady)=\"ctrl = $event\"\n  (search)=\"onSearch($event)\"\n></geo-map-shell>",
+      "related": [
+        "geo-map",
+        "geo-map-search",
+        "geo-map-toolbar",
+        "geo-map-layers-drawer"
+      ]
+    },
+    {
+      "name": "GeoMapSnapshotComponent",
+      "selector": "geo-map-snapshot",
+      "category": "map",
+      "summary": "Capture current map canvas to image / download.",
+      "whenToUse": "Export screenshot control on map chrome.",
+      "doNotUseWhen": "Server-side tile export pipelines.",
+      "howTo": "",
+      "tips": [],
+      "binding": "none",
+      "cva": false,
+      "path": "projects/geo-ui/src/lib/figma/geo-map/chrome/geo-map-snapshot/geo-map-snapshot.component.ts",
+      "doc": "ai/components/geo-map-snapshot.md",
+      "inputs": [
+        {
+          "name": "controller",
+          "type": "GeoMapController | null",
+          "default": "null",
+          "note": ""
+        },
+        {
+          "name": "label",
+          "type": "string",
+          "default": "'Chụp ảnh bản đồ'",
+          "note": ""
+        },
+        {
+          "name": "filename",
+          "type": "string",
+          "default": "'ban-do.png'",
+          "note": ""
+        }
+      ],
+      "outputs": [
+        {
+          "name": "captured",
+          "type": "OutputEmitterRef<void>",
+          "note": ""
+        },
+        {
+          "name": "captureError",
+          "type": "OutputEmitterRef<unknown>",
+          "note": ""
+        }
+      ],
+      "examples": [
+        {
+          "title": "Example",
+          "lang": "html",
+          "code": "<geo-map-snapshot [controller]=\"ctrl\" (captured)=\"onShot($event)\"></geo-map-snapshot>"
+        }
+      ],
+      "example": "<geo-map-snapshot [controller]=\"ctrl\" (captured)=\"onShot($event)\"></geo-map-snapshot>",
+      "related": []
+    },
+    {
+      "name": "GeoMapSwipeComponent",
+      "selector": "geo-map-swipe",
+      "category": "map",
+      "summary": "Swipe compare control between two map layers.",
+      "whenToUse": "Before/after planning vs current-use comparison.",
+      "doNotUseWhen": "Simple opacity blend — use geo-map-opacity.",
+      "howTo": "",
+      "tips": [],
+      "binding": "none",
+      "cva": false,
+      "path": "projects/geo-ui/src/lib/figma/geo-map/chrome/geo-map-swipe/geo-map-swipe.component.ts",
+      "doc": "ai/components/geo-map-swipe.md",
+      "inputs": [
+        {
+          "name": "controller",
+          "type": "GeoMapController | null",
+          "default": "null",
+          "note": ""
+        },
+        {
+          "name": "active",
+          "type": "boolean",
+          "default": "false",
+          "note": "When true, swipe mode is on. — Two-way `model()` (supports banana binding)."
+        },
+        {
+          "name": "position",
+          "type": "number",
+          "default": "50",
+          "note": "0–100, left portion shows clipped overlay. — Two-way `model()` (supports banana binding)."
+        },
+        {
+          "name": "layerId",
+          "type": "string | null",
+          "default": "null",
+          "note": "Optional explicit overlay layer id; defaults to top visible non-basemap."
+        }
+      ],
+      "outputs": [],
+      "examples": [
+        {
+          "title": "Example",
+          "lang": "html",
+          "code": "<geo-map-swipe [controller]=\"ctrl\" [(active)]=\"swipeOn\" layerId=\"demo-qhsdd-2020\"></geo-map-swipe>"
+        }
+      ],
+      "example": "<geo-map-swipe [controller]=\"ctrl\" [(active)]=\"swipeOn\" layerId=\"demo-qhsdd-2020\"></geo-map-swipe>",
+      "related": []
+    },
+    {
+      "name": "GeoMapToolbarComponent",
+      "selector": "geo-map-toolbar",
+      "category": "map",
+      "summary": "Vertical map tool strip (search, pan, measure, layers, …).",
+      "whenToUse": "Custom map layouts; usually included inside geo-map-shell.",
+      "doNotUseWhen": "Full portal — use geo-map-shell.",
+      "howTo": "",
+      "tips": [],
+      "binding": "none",
+      "cva": false,
+      "path": "projects/geo-ui/src/lib/figma/geo-map/chrome/geo-map-toolbar/geo-map-toolbar.component.ts",
+      "doc": "ai/components/geo-map-toolbar.md",
+      "inputs": [
+        {
+          "name": "controller",
+          "type": "GeoMapController | null",
+          "default": "null",
+          "note": ""
+        },
+        {
+          "name": "actions",
+          "type": "GeoMapToolbarAction[]",
+          "default": "[]",
+          "note": "When empty, uses built-in portal action set."
+        },
+        {
+          "name": "compact",
+          "type": "boolean",
+          "default": "false",
+          "note": ""
+        },
+        {
+          "name": "checkedMap",
+          "type": "Record<string, boolean>",
+          "default": "",
+          "note": "Two-way checked map keyed by action id (for checkbox-style actions). — Two-way `model()` (supports banana binding)."
+        }
+      ],
+      "outputs": [
+        {
+          "name": "actionClick",
+          "type": "OutputEmitterRef<GeoMapToolbarAction>",
+          "note": ""
+        },
+        {
+          "name": "actionToggle",
+          "type": "OutputEmitterRef<{ action: GeoMapToolbarAction; checked: boolean; }>",
+          "note": ""
+        }
+      ],
+      "examples": [
+        {
+          "title": "Example",
+          "lang": "html",
+          "code": "<geo-map-toolbar\n  [controller]=\"ctrl\"\n  [actions]=\"actions\"\n  [(checkedMap)]=\"checked\"\n  (actionClick)=\"onTool($event)\"\n></geo-map-toolbar>"
+        }
+      ],
+      "example": "<geo-map-toolbar\n  [controller]=\"ctrl\"\n  [actions]=\"actions\"\n  [(checkedMap)]=\"checked\"\n  (actionClick)=\"onTool($event)\"\n></geo-map-toolbar>",
+      "related": []
+    },
+    {
+      "name": "GeoMapZoomComponent",
+      "selector": "geo-map-zoom",
+      "category": "map",
+      "summary": "Zoom +/- and optional province / home navigation control.",
+      "whenToUse": "Custom map chrome; geo-map-shell embeds this.",
+      "doNotUseWhen": "Relying on OpenLayers built-in zoom alone is fine for bare geo-map.",
+      "howTo": "",
+      "tips": [],
+      "binding": "none",
+      "cva": false,
+      "path": "projects/geo-ui/src/lib/figma/geo-map/chrome/geo-map-zoom/geo-map-zoom.component.ts",
+      "doc": "ai/components/geo-map-zoom.md",
+      "inputs": [
+        {
+          "name": "controller",
+          "type": "GeoMapController | null",
+          "default": "null",
+          "note": ""
+        },
+        {
+          "name": "showNav",
+          "type": "boolean",
+          "default": "true",
+          "note": "Show prev / next zoom + fullscreen + box zoom (UC-15)."
+        },
+        {
+          "name": "showFitProvince",
+          "type": "boolean",
+          "default": "true",
+          "note": "Show “xem toàn tỉnh” (TCQH.14 GD5) — fit province extent, not fullscreen."
+        },
+        {
+          "name": "provinceExtent",
+          "type": "readonly [number, number, number, number] | null",
+          "default": "null",
+          "note": "Province extent in EPSG:4326. Defaults to Lâm Đồng placeholder when omitted."
+        },
+        {
+          "name": "fullscreenTarget",
+          "type": "HTMLElement | null",
+          "default": "null",
+          "note": "Element to put in Fullscreen API. Defaults to closest `.geo-map-shell`, then the OL map target."
+        }
+      ],
+      "outputs": [],
+      "examples": [
         {
-          "name": "errorMessage",
+          "title": "Example",
+          "lang": "html",
+          "code": "<geo-map-zoom [controller]=\"ctrl\" [showNav]=\"true\"></geo-map-zoom>"
+        }
+      ],
+      "example": "<geo-map-zoom [controller]=\"ctrl\" [showNav]=\"true\"></geo-map-zoom>",
+      "related": []
+    },
+    {
+      "name": "GeoOverlapResultComponent",
+      "selector": "geo-overlap-result",
+      "category": "data",
+      "summary": "Overlap analysis result list (planning type, area, percent).",
+      "whenToUse": "Show giao cắt quy hoạch vs hiện trạng results.",
+      "doNotUseWhen": "Generic tables — use geo-table.",
+      "howTo": "",
+      "tips": [],
+      "binding": "none",
+      "cva": false,
+      "path": "projects/geo-ui/src/lib/figma/geo-overlap-result/geo-overlap-result.component.ts",
+      "doc": "ai/components/geo-overlap-result.md",
+      "inputs": [
+        {
+          "name": "title",
           "type": "string",
-          "default": "''",
+          "default": "'Kết quả phân tích chồng lấn'",
           "note": ""
         },
         {
-          "name": "maxlength",
-          "type": "number",
-          "default": "",
+          "name": "rows",
+          "type": "GeoOverlapResultRow[]",
+          "default": "[]",
           "note": ""
         },
         {
-          "name": "prefixIcon",
+          "name": "areaUnit",
           "type": "string",
-          "default": "",
+          "default": "'m²'",
           "note": ""
         },
         {
-          "name": "suffixIcon",
+          "name": "emptyText",
           "type": "string",
-          "default": "",
-          "note": ""
-        },
-        {
-          "name": "allowClear",
-          "type": "boolean",
-          "default": "false",
+          "default": "'Chưa có kết quả phân tích.'",
           "note": ""
-        },
+        }
+      ],
+      "outputs": [
         {
-          "name": "block",
-          "type": "boolean",
-          "default": "false",
+          "name": "rowClick",
+          "type": "OutputEmitterRef<GeoOverlapResultRow>",
           "note": ""
-        },
+        }
+      ],
+      "examples": [
         {
-          "name": "width",
-          "type": "number | string",
-          "default": "",
-          "note": ""
+          "title": "Example",
+          "lang": "html",
+          "code": "<geo-overlap-result [rows]=\"rows\" (rowClick)=\"focus($event)\"></geo-overlap-result>"
         }
       ],
-      "outputs": [
+      "example": "<geo-overlap-result [rows]=\"rows\" (rowClick)=\"focus($event)\"></geo-overlap-result>",
+      "related": []
+    },
+    {
+      "name": "GeoPageHeaderComponent",
+      "selector": "geo-page-header",
+      "category": "display",
+      "summary": "Compact page header block (title + optional actions slot).",
+      "whenToUse": "Section headers on dashboard / list pages.",
+      "doNotUseWhen": "Full page title under breadcrumb — prefer geo-page-title.",
+      "howTo": "",
+      "tips": [],
+      "binding": "none",
+      "cva": false,
+      "path": "projects/geo-ui/src/lib/figma/geo-page-header/geo-page-header.component.ts",
+      "doc": "ai/components/geo-page-header.md",
+      "inputs": [
         {
-          "name": "valueChange",
-          "type": "EventEmitter<string>",
+          "name": "title",
+          "type": "string",
+          "default": "''",
           "note": ""
         },
         {
-          "name": "enterPressed",
-          "type": "EventEmitter<void>",
+          "name": "breadcrumb",
+          "type": "GeoBreadcrumbItem[]",
+          "default": "[]",
+          "note": ""
+        },
+        {
+          "name": "uppercase",
+          "type": "boolean",
+          "default": "true",
           "note": ""
         }
       ],
+      "outputs": [],
       "examples": [
         {
-          "title": "Basic",
-          "lang": "html",
-          "code": "<geo-input label=\"Họ tên\" [required]=\"true\" [block]=\"true\" [(ngModel)]=\"name\"></geo-input>"
-        },
-        {
-          "title": "Full options",
+          "title": "Example",
           "lang": "html",
-          "code": "<geo-input\n  label=\"Mã hồ sơ\"\n  placeholder=\"Nhập mã hồ sơ\"\n  type=\"text\"\n  prefixIcon=\"search\"\n  [allowClear]=\"true\"\n  [required]=\"true\"\n  [block]=\"true\"\n  [maxlength]=\"50\"\n  [error]=\"codeError\"\n  errorMessage=\"Mã không được để trống\"\n  [(ngModel)]=\"code\"\n  (enterPressed)=\"onSearch()\"\n  (valueChange)=\"onCode($event)\"\n></geo-input>"
+          "code": "<geo-page-header title=\"Thống kê nhanh\"></geo-page-header>"
         }
       ],
-      "example": "<geo-input label=\"Họ tên\" [required]=\"true\" [block]=\"true\" [(ngModel)]=\"name\"></geo-input>",
-      "related": [
-        "geo-textarea",
-        "geo-select",
-        "geo-form-modal"
-      ]
+      "example": "<geo-page-header title=\"Thống kê nhanh\"></geo-page-header>",
+      "related": []
     },
     {
       "name": "GeoPageTitleComponent",
@@ -1482,13 +4053,13 @@
           "name": "pageIndex",
           "type": "number",
           "default": "1",
-          "note": ""
+          "note": "Two-way `model()` (supports banana binding)."
         },
         {
           "name": "pageSize",
           "type": "number",
           "default": "10",
-          "note": ""
+          "note": "Two-way `model()` (supports banana binding)."
         },
         {
           "name": "total",
@@ -1527,18 +4098,7 @@
           "note": ""
         }
       ],
-      "outputs": [
-        {
-          "name": "pageIndexChange",
-          "type": "EventEmitter<number>",
-          "note": ""
-        },
-        {
-          "name": "pageSizeChange",
-          "type": "EventEmitter<number>",
-          "note": ""
-        }
-      ],
+      "outputs": [],
       "examples": [
         {
           "title": "Basic",
@@ -1645,7 +4205,7 @@
       "outputs": [
         {
           "name": "valueChange",
-          "type": "EventEmitter<string | number | null>",
+          "type": "OutputEmitterRef<string | number | null>",
           "note": ""
         }
       ],
@@ -1701,12 +4261,12 @@
       "outputs": [
         {
           "name": "edit",
-          "type": "EventEmitter<void>",
-          "note": "Action ưu tiên hiển thị khi có > 2 thao tác (mặc định: edit) */   @Input() primaryActionKey = 'edit';   @Output() actionClick = new EventEmitter<string>();   /** @deprecated Dùng `actionClick` với key `edit`"
+          "type": "OutputEmitterRef<void>",
+          "note": "Action ưu tiên hiển thị khi có > 2 thao tác (mặc định: edit) */   readonly primaryActionKey = input('edit');   readonly actionClick = output<string>();   /** @deprecated Dùng `actionClick` với key `edit`"
         },
         {
           "name": "more",
-          "type": "EventEmitter<void>",
+          "type": "OutputEmitterRef<void>",
           "note": "@deprecated Dùng `actionClick` với key `more`"
         }
       ],
@@ -1821,15 +4381,15 @@
         },
         {
           "name": "width",
-          "type": "number | string",
-          "default": "",
+          "type": "number | string | undefined",
+          "default": "undefined",
           "note": ""
         }
       ],
       "outputs": [
         {
           "name": "valueChange",
-          "type": "EventEmitter<string | number | Array<string | number> | null>",
+          "type": "OutputEmitterRef<string | number | Array<string | number> | null>",
           "note": ""
         }
       ],
@@ -1857,7 +4417,7 @@
       "selector": "geo-slider",
       "category": "forms",
       "summary": "Numeric range slider.",
-      "whenToUse": "Continuous numeric value in a range.",
+      "whenToUse": "Continuous numeric value in a range (opacity, percent).",
       "doNotUseWhen": "Discrete small sets — use select/radio.",
       "howTo": "Thanh trượt số liên tục. Two-way [(value)] / (valueChange); min/max/step; tipFormatter tùy chỉnh tooltip.",
       "tips": [
@@ -1874,7 +4434,7 @@
           "name": "value",
           "type": "number",
           "default": "0",
-          "note": ""
+          "note": "Two-way `model()` (supports banana binding)."
         },
         {
           "name": "min",
@@ -1902,18 +4462,12 @@
         },
         {
           "name": "tipFormatter",
-          "type": "(value: number)",
-          "default": "> string",
-          "note": ""
-        }
-      ],
-      "outputs": [
-        {
-          "name": "valueChange",
-          "type": "EventEmitter<number>",
+          "type": "((value: number) => string) | undefined",
+          "default": "undefined",
           "note": ""
         }
       ],
+      "outputs": [],
       "examples": [
         {
           "title": "Basic",
@@ -1932,6 +4486,98 @@
         "geo-select"
       ]
     },
+    {
+      "name": "GeoStatCardComponent",
+      "selector": "geo-stat-card",
+      "category": "data",
+      "summary": "KPI stat card (label, value, optional delta / icon).",
+      "whenToUse": "Dashboard summary tiles.",
+      "doNotUseWhen": "Detailed tables — use geo-table.",
+      "howTo": "",
+      "tips": [],
+      "binding": "none",
+      "cva": false,
+      "path": "projects/geo-ui/src/lib/figma/geo-stat-card/geo-stat-card.component.ts",
+      "doc": "ai/components/geo-stat-card.md",
+      "inputs": [
+        {
+          "name": "label",
+          "type": "string",
+          "default": "''",
+          "note": ""
+        },
+        {
+          "name": "value",
+          "type": "string | number",
+          "default": "''",
+          "note": ""
+        },
+        {
+          "name": "unit",
+          "type": "string",
+          "default": "''",
+          "note": ""
+        },
+        {
+          "name": "icon",
+          "type": "string",
+          "default": "'bar-chart'",
+          "note": ""
+        },
+        {
+          "name": "hint",
+          "type": "string",
+          "default": "''",
+          "note": ""
+        },
+        {
+          "name": "clickable",
+          "type": "boolean",
+          "default": "false",
+          "note": ""
+        },
+        {
+          "name": "animate",
+          "type": "boolean",
+          "default": "true",
+          "note": "Count-up number animation. Honors `prefers-reduced-motion`."
+        },
+        {
+          "name": "animationDuration",
+          "type": "number",
+          "default": "1000",
+          "note": "Count-up duration in ms."
+        },
+        {
+          "name": "animationDelay",
+          "type": "number",
+          "default": "0",
+          "note": "Stagger delay before count-up starts (ms)."
+        },
+        {
+          "name": "item",
+          "type": "GeoStatCardItem | null",
+          "default": "null",
+          "note": "Convenience: bind a whole item object."
+        }
+      ],
+      "outputs": [
+        {
+          "name": "clicked",
+          "type": "OutputEmitterRef<void>",
+          "note": ""
+        }
+      ],
+      "examples": [
+        {
+          "title": "Example",
+          "lang": "html",
+          "code": "<geo-stat-card label=\"Tổng thửa\" [value]=\"12450\" unit=\"thửa\"></geo-stat-card>"
+        }
+      ],
+      "example": "<geo-stat-card label=\"Tổng thửa\" [value]=\"12450\" unit=\"thửa\"></geo-stat-card>",
+      "related": []
+    },
     {
       "name": "GeoStatusTagComponent",
       "selector": "geo-status-tag",
@@ -1958,8 +4604,8 @@
         },
         {
           "name": "label",
-          "type": "string",
-          "default": "",
+          "type": "string | undefined",
+          "default": "undefined",
           "note": "Override label text."
         },
         {
@@ -2016,7 +4662,7 @@
           "name": "activeIndex",
           "type": "number",
           "default": "0",
-          "note": ""
+          "note": "Two-way `model()` (supports banana binding)."
         },
         {
           "name": "title",
@@ -2110,34 +4756,29 @@
         }
       ],
       "outputs": [
-        {
-          "name": "activeIndexChange",
-          "type": "EventEmitter<number>",
-          "note": ""
-        },
         {
           "name": "stepSelect",
-          "type": "EventEmitter<{ index: number; step: GeoStepperStep }>",
+          "type": "OutputEmitterRef<{ index: number; step: GeoStepperStep }>",
           "note": ""
         },
         {
           "name": "cancel",
-          "type": "EventEmitter<void>",
+          "type": "OutputEmitterRef<void>",
           "note": ""
         },
         {
           "name": "previous",
-          "type": "EventEmitter<void>",
+          "type": "OutputEmitterRef<void>",
           "note": ""
         },
         {
           "name": "save",
-          "type": "EventEmitter<void>",
+          "type": "OutputEmitterRef<void>",
           "note": ""
         },
         {
           "name": "next",
-          "type": "EventEmitter<void>",
+          "type": "OutputEmitterRef<void>",
           "note": ""
         }
       ],
@@ -2188,7 +4829,7 @@
           "name": "activeIndex",
           "type": "number",
           "default": "0",
-          "note": ""
+          "note": "Two-way `model()` (supports banana binding)."
         },
         {
           "name": "orientation",
@@ -2204,14 +4845,9 @@
         }
       ],
       "outputs": [
-        {
-          "name": "activeIndexChange",
-          "type": "EventEmitter<number>",
-          "note": ""
-        },
         {
           "name": "stepSelect",
-          "type": "EventEmitter<{ index: number; step: GeoStepperStep }>",
+          "type": "OutputEmitterRef<{ index: number; step: GeoStepperStep }>",
           "note": ""
         }
       ],
@@ -2322,18 +4958,18 @@
           "name": "pageIndex",
           "type": "number",
           "default": "1",
-          "note": ""
+          "note": "Two-way `model()` (supports banana binding)."
         },
         {
           "name": "pageSize",
           "type": "number",
           "default": "10",
-          "note": ""
+          "note": "Two-way `model()` (supports banana binding)."
         },
         {
           "name": "total",
-          "type": "number",
-          "default": "",
+          "type": "number | undefined",
+          "default": "undefined",
           "note": ""
         },
         {
@@ -2375,13 +5011,13 @@
         {
           "name": "scroll",
           "type": "{ x?: string; y?: string }",
-          "default": "{}",
+          "default": "",
           "note": ""
         },
         {
           "name": "scrollY",
-          "type": "string",
-          "default": "",
+          "type": "string | undefined",
+          "default": "undefined",
           "note": ""
         },
         {
@@ -2392,14 +5028,14 @@
         },
         {
           "name": "tableTitle",
-          "type": "string",
-          "default": "",
+          "type": "string | undefined",
+          "default": "undefined",
           "note": ""
         },
         {
           "name": "footer",
-          "type": "string",
-          "default": "",
+          "type": "string | undefined",
+          "default": "undefined",
           "note": ""
         },
         {
@@ -2430,12 +5066,12 @@
           "name": "selectedKeys",
           "type": "string[]",
           "default": "[]",
-          "note": ""
+          "note": "Two-way `model()` (supports banana binding)."
         },
         {
           "name": "mobileTitleKey",
-          "type": "string",
-          "default": "",
+          "type": "string | undefined",
+          "default": "undefined",
           "note": "Mobile card: key cột làm tiêu đề. Ưu tiên hơn `column.mobileTitle`; nếu không set thì lấy cột dữ liệu đầu tiên."
         },
         {
@@ -2448,52 +5084,37 @@
       "outputs": [
         {
           "name": "rowClick",
-          "type": "EventEmitter<Record<string, unknown>>",
+          "type": "OutputEmitterRef<Record<string, unknown>>",
           "note": ""
         },
         {
           "name": "rowEdit",
-          "type": "EventEmitter<Record<string, unknown>>",
+          "type": "OutputEmitterRef<Record<string, unknown>>",
           "note": ""
         },
         {
           "name": "rowMore",
-          "type": "EventEmitter<Record<string, unknown>>",
+          "type": "OutputEmitterRef<Record<string, unknown>>",
           "note": ""
         },
         {
           "name": "rowAction",
-          "type": "EventEmitter<{ row: Record<string, unknown>; action: string }>",
-          "note": ""
-        },
-        {
-          "name": "pageIndexChange",
-          "type": "EventEmitter<number>",
-          "note": ""
-        },
-        {
-          "name": "pageSizeChange",
-          "type": "EventEmitter<number>",
+          "type": "OutputEmitterRef<{ row: Record<string, unknown>; action: string }>",
           "note": ""
         },
         {
           "name": "queryParams",
-          "type": "EventEmitter<NzTableQueryParams>",
+          "type": "OutputEmitterRef<NzTableQueryParams>",
           "note": ""
         },
         {
           "name": "currentPageDataChange",
-          "type": "EventEmitter<readonly Record<string, unknown>[]>",
-          "note": ""
-        },
-        {
-          "name": "selectedKeysChange",
-          "type": "EventEmitter<string[]>",
+          "type": "OutputEmitterRef<readonly Record<string, unknown>[]>",
           "note": ""
         },
         {
           "name": "selectionChange",
-          "type": "EventEmitter<Record<string, unknown>[]>",
+          "type": "OutputEmitterRef<Record<string, unknown>[]>",
           "note": ""
         }
       ],
@@ -2595,7 +5216,7 @@
           "name": "advancedExpanded",
           "type": "boolean",
           "default": "false",
-          "note": "Mở panel field nâng cao (`[advanced]`)."
+          "note": "Mở panel field nâng cao (`[advanced]`). — Two-way `model()` (supports banana binding)."
         },
         {
           "name": "advancedFilterCount",
@@ -2619,17 +5240,12 @@
       "outputs": [
         {
           "name": "search",
-          "type": "EventEmitter<void>",
+          "type": "OutputEmitterRef<void>",
           "note": ""
         },
         {
           "name": "reset",
-          "type": "EventEmitter<void>",
-          "note": ""
-        },
-        {
-          "name": "advancedExpandedChange",
-          "type": "EventEmitter<boolean>",
+          "type": "OutputEmitterRef<void>",
           "note": ""
         }
       ],
@@ -2676,13 +5292,13 @@
           "name": "pageIndex",
           "type": "number",
           "default": "1",
-          "note": ""
+          "note": "Two-way `model()` (supports banana binding)."
         },
         {
           "name": "pageSize",
           "type": "number",
           "default": "10",
-          "note": ""
+          "note": "Two-way `model()` (supports banana binding)."
         },
         {
           "name": "total",
@@ -2721,18 +5337,7 @@
           "note": ""
         }
       ],
-      "outputs": [
-        {
-          "name": "pageIndexChange",
-          "type": "EventEmitter<number>",
-          "note": ""
-        },
-        {
-          "name": "pageSizeChange",
-          "type": "EventEmitter<number>",
-          "note": ""
-        }
-      ],
+      "outputs": [],
       "examples": [
         {
           "title": "Basic",
@@ -2825,35 +5430,35 @@
         },
         {
           "name": "columnStorageKey",
-          "type": "string",
-          "default": "",
+          "type": "string | undefined",
+          "default": "undefined",
           "note": "Key lưu trạng thái ẩn/hiện cột trong sessionStorage"
         }
       ],
       "outputs": [
         {
           "name": "deleteClick",
-          "type": "EventEmitter<void>",
+          "type": "OutputEmitterRef<void>",
           "note": ""
         },
         {
           "name": "exportClick",
-          "type": "EventEmitter<void>",
+          "type": "OutputEmitterRef<void>",
           "note": ""
         },
         {
           "name": "toggleColumns",
-          "type": "EventEmitter<void>",
+          "type": "OutputEmitterRef<void>",
           "note": ""
         },
         {
           "name": "columnApply",
-          "type": "EventEmitter<GeoColumnPickerApplyPayload>",
+          "type": "OutputEmitterRef<GeoColumnPickerApplyPayload>",
           "note": ""
         },
         {
           "name": "addClick",
-          "type": "EventEmitter<void>",
+          "type": "OutputEmitterRef<void>",
           "note": ""
         }
       ],
@@ -2916,13 +5521,13 @@
           "name": "selectedIndex",
           "type": "number",
           "default": "0",
-          "note": ""
+          "note": "Two-way `model()` (supports banana binding)."
         },
         {
           "name": "selectedKey",
-          "type": "string",
-          "default": "",
-          "note": ""
+          "type": "string | undefined",
+          "default": "undefined",
+          "note": "Two-way `model()` (supports banana binding)."
         },
         {
           "name": "centered",
@@ -2938,19 +5543,9 @@
         }
       ],
       "outputs": [
-        {
-          "name": "selectedIndexChange",
-          "type": "EventEmitter<number>",
-          "note": ""
-        },
-        {
-          "name": "selectedKeyChange",
-          "type": "EventEmitter<string>",
-          "note": ""
-        },
         {
           "name": "tabChange",
-          "type": "EventEmitter<{ index: number; key: string }>",
+          "type": "OutputEmitterRef<{ index: number; key: string }>",
           "note": ""
         }
       ],
@@ -3034,8 +5629,8 @@
         },
         {
           "name": "maxlength",
-          "type": "number",
-          "default": "",
+          "type": "number | undefined",
+          "default": "undefined",
           "note": ""
         },
         {
@@ -3048,7 +5643,7 @@
       "outputs": [
         {
           "name": "valueChange",
-          "type": "EventEmitter<string>",
+          "type": "OutputEmitterRef<string>",
           "note": ""
         }
       ],
@@ -3122,19 +5717,19 @@
           "name": "visible",
           "type": "boolean",
           "default": "true",
-          "note": ""
+          "note": "Two-way `model()` (supports banana binding)."
         },
         {
           "name": "icon",
-          "type": "string",
-          "default": "",
+          "type": "string | undefined",
+          "default": "undefined",
           "note": "Override Ant Design icon type."
         }
       ],
       "outputs": [
         {
           "name": "closed",
-          "type": "EventEmitter<void>",
+          "type": "OutputEmitterRef<void>",
           "note": ""
         }
       ],
@@ -3190,13 +5785,13 @@
           "name": "checkedKeys",
           "type": "Array<string | number>",
           "default": "[]",
-          "note": ""
+          "note": "Two-way `model()` (supports banana binding)."
         },
         {
           "name": "expandedKeys",
           "type": "Array<string | number>",
           "default": "[]",
-          "note": ""
+          "note": "Two-way `model()` (supports banana binding)."
         },
         {
           "name": "showLine",
@@ -3212,19 +5807,9 @@
         }
       ],
       "outputs": [
-        {
-          "name": "checkedKeysChange",
-          "type": "EventEmitter<Array<string | number>>",
-          "note": ""
-        },
-        {
-          "name": "expandedKeysChange",
-          "type": "EventEmitter<Array<string | number>>",
-          "note": ""
-        },
         {
           "name": "nodeClick",
-          "type": "EventEmitter<NzFormatEmitEvent>",
+          "type": "OutputEmitterRef<NzFormatEmitEvent>",
           "note": ""
         }
       ],
@@ -3432,18 +6017,18 @@
           "name": "fileList",
           "type": "GeoUploadFile[]",
           "default": "[]",
-          "note": "Controlled file list."
+          "note": "Controlled file list. — Two-way `model()` (supports banana binding)."
         },
         {
           "name": "headers",
-          "type": "{} | ((file: NzUploadFile) => {} | Observable<{}>)",
-          "default": "",
+          "type": "{} | ((file: NzUploadFile) => {} | Observable<{}>) | undefined",
+          "default": "undefined",
           "note": ""
         },
         {
           "name": "data",
-          "type": "{} | ((file: NzUploadFile) => {} | Observable<{}>)",
-          "default": "",
+          "type": "{} | ((file: NzUploadFile) => {} | Observable<{}>) | undefined",
+          "default": "undefined",
           "note": ""
         },
         {
@@ -3466,36 +6051,31 @@
         },
         {
           "name": "customRequest",
-          "type": "(item: NzUploadXHRArgs) => Subscription",
-          "default": "",
+          "type": "GeoUploadCustomRequest | undefined",
+          "default": "undefined",
           "note": "Custom XHR — mặc định simulate progress khi không có `action`."
         },
         {
           "name": "beforeUpload",
-          "type": "( file: NzUploadFile, fileList: NzUploadFile[] )",
-          "default": "> boolean | Observable<boolean>",
+          "type": "((file: NzUploadFile, fileList: NzUploadFile[]) => boolean | Observable<boolean>) | undefined",
+          "default": "undefined",
           "note": ""
         }
       ],
       "outputs": [
-        {
-          "name": "fileListChange",
-          "type": "EventEmitter<GeoUploadFile[]>",
-          "note": ""
-        },
         {
           "name": "change",
-          "type": "EventEmitter<NzUploadChangeParam>",
+          "type": "OutputEmitterRef<NzUploadChangeParam>",
           "note": ""
         },
         {
           "name": "remove",
-          "type": "EventEmitter<GeoUploadFile>",
+          "type": "OutputEmitterRef<GeoUploadFile>",
           "note": ""
         },
         {
           "name": "reject",
-          "type": "EventEmitter<{ file: File; reason: 'type' | 'size' }>",
+          "type": "OutputEmitterRef<{ file: File; reason: 'type' | 'size' }>",
           "note": ""
         }
       ],