@geoit/ui 0.0.8 → 0.1.1

package/ai/AGENTS.md

@@ -95,6 +95,7 @@ Standalone consumers:
 |------------|---------|
 | `geo-input`, `geo-textarea`, `geo-select`, `geo-radio`, `geo-date-picker`, `geo-date-range-picker`, `geo-file-picker` | **CVA** → `[(ngModel)]` or reactive forms |
 | `geo-checkbox` | `[(checked)]` (not CVA) |
+| `geo-switch` | `[(checked)]` (not CVA, same as `geo-checkbox`) |
 | `geo-slider` | `[(value)]` (`model()`) |
 | Overlays (`geo-form-modal`, search panels, …) | often `[(open)]` / `[(visible)]` |
 
@@ -120,6 +121,7 @@ See [`recipes.md`](./recipes.md) for copy-paste screens:
 | Select | `geo-select` |
 | Exclusive options | `geo-radio` |
 | Checkbox | `geo-checkbox` |
+| Toggle on/off | `geo-switch` |
 | Date / date range | `geo-date-picker` / `geo-date-range-picker` |
 | Dialog form | `geo-form-modal` |
 | Confirm delete | `geo-confirm-modal` |
@@ -134,6 +136,8 @@ See [`recipes.md`](./recipes.md) for copy-paste screens:
 | Overlap analysis | `geo-overlap-result` |
 | Empty region | `geo-empty-state` |
 | Status pill | `geo-status-tag` |
+| Collapsible sections | `geo-accordion` |
+| Read-only entity detail | `geo-detail-view` |
 | Transient notice | `GeoToastService` / `geo-toast` |
 | Inline notice | `geo-alert` |
 | Upload drag-drop | `geo-upload` |

package/ai/README.md

@@ -6,6 +6,7 @@ Agent rules: [`AGENTS.md`](./AGENTS.md) · Recipes: [`recipes.md`](./recipes.md)
 
 | Selector | Category | Summary | Doc |
 |----------|----------|---------|-----|
+| `geo-accordion` | navigation | Collapsible panel group (nz-collapse); content via ng-template uiPanel. | [geo-accordion.md](./components/geo-accordion.md) |
 | `geo-alert` | feedback | Inline alert banner (success/error/warning/info). | [geo-alert.md](./components/geo-alert.md) |
 | `geo-back-button` | navigation | Back navigation control (history or custom click). | [geo-back-button.md](./components/geo-back-button.md) |
 | `geo-breadcrumb` | navigation | Breadcrumb trail; last item active (primary). | [geo-breadcrumb.md](./components/geo-breadcrumb.md) |
@@ -17,6 +18,7 @@ Agent rules: [`AGENTS.md`](./AGENTS.md) · Recipes: [`recipes.md`](./recipes.md)
 | `geo-dashboard` | layout | Composed dashboard: period, KPI cards, ward/mismatch charts. | [geo-dashboard.md](./components/geo-dashboard.md) |
 | `geo-date-picker` | forms | Single date (optional time) picker. | [geo-date-picker.md](./components/geo-date-picker.md) |
 | `geo-date-range-picker` | forms | Start–end date range picker. | [geo-date-range-picker.md](./components/geo-date-range-picker.md) |
+| `geo-detail-view` | display | Read-only key/value grid (nz-descriptions); value tùy biến qua ng-template uiDetailItem. | [geo-detail-view.md](./components/geo-detail-view.md) |
 | `geo-empty-state` | feedback | Empty region placeholder (icon + title + optional action). | [geo-empty-state.md](./components/geo-empty-state.md) |
 | `geo-feedback-form` | forms | Citizen feedback / phản ánh form with validation. | [geo-feedback-form.md](./components/geo-feedback-form.md) |
 | `geo-file-picker` | forms | Compact file input for forms (button + filename). | [geo-file-picker.md](./components/geo-file-picker.md) |
@@ -62,6 +64,7 @@ Agent rules: [`AGENTS.md`](./AGENTS.md) · Recipes: [`recipes.md`](./recipes.md)
 | `geo-status-tag` | display | Pill status tag with optional dot (success/error/warning/info/teal/…). | [geo-status-tag.md](./components/geo-status-tag.md) |
 | `geo-step-form-layout` | layout | Full-page multi-step form: vertical stepper + content card + footer actions. | [geo-step-form-layout.md](./components/geo-step-form-layout.md) |
 | `geo-stepper` | navigation | Steps indicator (horizontal default). Active=primary, completed=success+check. | [geo-stepper.md](./components/geo-stepper.md) |
+| `geo-switch` | forms | On/off toggle (nz-switch) with optional trailing label; bind with [(checked)] (not CVA). | [geo-switch.md](./components/geo-switch.md) |
 | `geo-table` | data | Data table with pagination, selection, row actions, mobile card mode. | [geo-table.md](./components/geo-table.md) |
 | `geo-table-filter` | data | Table filter bar with search + advanced filters. | [geo-table-filter.md](./components/geo-table-filter.md) |
 | `geo-table-pagination` | data | Table-specific pagination footer (range label + size). | [geo-table-pagination.md](./components/geo-table-pagination.md) |
@@ -73,6 +76,6 @@ Agent rules: [`AGENTS.md`](./AGENTS.md) · Recipes: [`recipes.md`](./recipes.md)
 | `geo-typography` | display | Text with GEO type scale (h1–tiny) and semantic colors. | [geo-typography.md](./components/geo-typography.md) |
 | `geo-upload` | forms | Drag-drop upload zone with progress list. | [geo-upload.md](./components/geo-upload.md) |
 
-Generated: 2026-09-04T09:54:08.856Z
+Generated: 2026-09-11T02:34:24.165Z
 
 Regenerate: `npm run ai:docs`

package/ai/catalog.json

@@ -1,8 +1,8 @@
 {
   "package": "@geoit/ui",
   "import": "@geoit/ui",
-  "version": "0.0.8",
-  "generatedAt": "2026-09-04T09:54:08.856Z",
+  "version": "0.1.1",
+  "generatedAt": "2026-09-11T02:34:24.165Z",
   "styles": [
     "@geoit/ui/src/lib/styles/design-tokens.scss",
     "@geoit/ui/src/lib/styles/theme.scss"
@@ -26,6 +26,68 @@
     "Import from @geoit/ui (scoped package)."
   ],
   "components": [
+    {
+      "name": "GeoAccordionComponent",
+      "selector": "geo-accordion",
+      "category": "navigation",
+      "summary": "Collapsible panel group (nz-collapse); content via ng-template uiPanel.",
+      "whenToUse": "Các khối nội dung có thể thu gọn/mở rộng trên cùng một trang (FAQ, nhóm trường form dài).",
+      "doNotUseWhen": "Điều hướng giữa các section ngang hàng luôn hiển thị — use geo-tabs.",
+      "howTo": "",
+      "tips": [],
+      "binding": "none",
+      "cva": false,
+      "path": "projects/geo-ui/src/lib/figma/geo-accordion/geo-accordion.component.ts",
+      "doc": "ai/components/geo-accordion.md",
+      "inputs": [
+        {
+          "name": "items",
+          "type": "GeoAccordionItem[]",
+          "default": "[]",
+          "note": ""
+        },
+        {
+          "name": "accordion",
+          "type": "boolean",
+          "default": "false",
+          "note": "`true` → chỉ 1 panel mở tại một thời điểm (maps to `nzAccordion`)."
+        },
+        {
+          "name": "bordered",
+          "type": "boolean",
+          "default": "true",
+          "note": ""
+        },
+        {
+          "name": "ghost",
+          "type": "boolean",
+          "default": "false",
+          "note": ""
+        },
+        {
+          "name": "activeKeys",
+          "type": "string[]",
+          "default": "[]",
+          "note": "Two-way `model()` (supports banana binding)."
+        }
+      ],
+      "outputs": [
+        {
+          "name": "panelChange",
+          "type": "OutputEmitterRef<{ key: string; active: boolean }>",
+          "note": ""
+        }
+      ],
+      "examples": [
+        {
+          "title": "Example",
+          "lang": "html",
+          "code": "<geo-accordion [items]=\"[{ key: 'a', title: 'Panel A' }, { key: 'b', title: 'Panel B' }]\" [(activeKeys)]=\"keys\">\n  <ng-template uiPanel=\"a\">Content A</ng-template>\n  <ng-template uiPanel=\"b\">Content B</ng-template>\n</geo-accordion>"
+        }
+      ],
+      "example": "<geo-accordion [items]=\"[{ key: 'a', title: 'Panel A' }, { key: 'b', title: 'Panel B' }]\" [(activeKeys)]=\"keys\">\n  <ng-template uiPanel=\"a\">Content A</ng-template>\n  <ng-template uiPanel=\"b\">Content B</ng-template>\n</geo-accordion>",
+      "related": []
+    },
     {
       "name": "GeoAlertComponent",
       "selector": "geo-alert",
@@ -1045,6 +1107,68 @@
         "geo-table-filter"
       ]
     },
+    {
+      "name": "GeoDetailViewComponent",
+      "selector": "geo-detail-view",
+      "category": "display",
+      "summary": "Read-only key/value grid (nz-descriptions); value tùy biến qua ng-template uiDetailItem.",
+      "whenToUse": "Trang/khối xem chi tiết hồ sơ, thửa đất, người dùng… (không chỉnh sửa).",
+      "doNotUseWhen": "Cần nhập liệu — use geo-input/geo-select trong form.",
+      "howTo": "",
+      "tips": [],
+      "binding": "none",
+      "cva": false,
+      "path": "projects/geo-ui/src/lib/figma/geo-detail-view/geo-detail-view.component.ts",
+      "doc": "ai/components/geo-detail-view.md",
+      "inputs": [
+        {
+          "name": "title",
+          "type": "string",
+          "default": "''",
+          "note": ""
+        },
+        {
+          "name": "items",
+          "type": "GeoDetailViewItem[]",
+          "default": "[]",
+          "note": ""
+        },
+        {
+          "name": "column",
+          "type": "number",
+          "default": "2",
+          "note": ""
+        },
+        {
+          "name": "bordered",
+          "type": "boolean",
+          "default": "true",
+          "note": ""
+        },
+        {
+          "name": "layout",
+          "type": "'horizontal' | 'vertical'",
+          "default": "'horizontal'",
+          "note": ""
+        },
+        {
+          "name": "size",
+          "type": "'default' | 'small'",
+          "default": "'default'",
+          "note": ""
+        }
+      ],
+      "outputs": [],
+      "examples": [
+        {
+          "title": "Example",
+          "lang": "html",
+          "code": "<geo-detail-view title=\"Thông tin thửa đất\" [items]=\"[{ key: 'code', label: 'Mã thửa', value: 'A-123' }, { key: 'status', label: 'Trạng thái' }]\" [column]=\"2\">\n  <ng-template uiDetailItem=\"status\"><geo-status-tag status=\"active\"></geo-status-tag></ng-template>\n</geo-detail-view>"
+        }
+      ],
+      "example": "<geo-detail-view title=\"Thông tin thửa đất\" [items]=\"[{ key: 'code', label: 'Mã thửa', value: 'A-123' }, { key: 'status', label: 'Trạng thái' }]\" [column]=\"2\">\n  <ng-template uiDetailItem=\"status\"><geo-status-tag status=\"active\"></geo-status-tag></ng-template>\n</geo-detail-view>",
+      "related": []
+    },
     {
       "name": "GeoEmptyStateComponent",
       "selector": "geo-empty-state",
@@ -2610,12 +2734,6 @@
           "default": "[]",
           "note": ""
         },
-        {
-          "name": "selectionMode",
-          "type": "'single' | 'multi'",
-          "default": "'multi'",
-          "note": "`single` — chọn đúng 1 xã/phường (BR-06-03); `multi` — checkbox nhiều cấp (mặc định)."
-        },
         {
           "name": "checkedKeys",
           "type": "Array<string | number>",
@@ -2966,12 +3084,6 @@
           "default": "[]",
           "note": ""
         },
-        {
-          "name": "catalogMissing",
-          "type": "boolean",
-          "default": "false",
-          "note": "True khi danh mục chú giải không tải được (`ERR_MAP_LEGEND_CATALOG_MISSING`)."
-        },
         {
           "name": "open",
           "type": "boolean",
@@ -3446,6 +3558,12 @@
           "default": "GEO_MAP_DEMO_LEGEND_ITEMS",
           "note": ""
         },
+        {
+          "name": "legendCatalogMissing",
+          "type": "boolean",
+          "default": "false",
+          "note": "Host app sets true when the legend catalog (loại đất/ký hiệu/màu) failed to load."
+        },
         {
           "name": "showNav",
           "type": "boolean",
@@ -3464,30 +3582,12 @@
           "default": "GEO_MAP_DEMO_ADMIN_NODES",
           "note": ""
         },
-        {
-          "name": "adminSelectionMode",
-          "type": "'single' | 'multi'",
-          "default": "'multi'",
-          "note": "`single` — chọn đúng 1 xã/phường (BR-06-03); `multi` — checkbox nhiều cấp (mặc định)."
-        },
         {
           "name": "locationLabel",
           "type": "string",
           "default": "'Phường 1 — TP Đà Lạt, Lâm Đồng'",
           "note": ""
         },
-        {
-          "name": "measureDisclaimer",
-          "type": "string | null",
-          "default": "'Giá trị tham khảo trên bản đồ, không có giá trị pháp lý. Diện tích pháp lý của thửa đất lấy theo hồ sơ địa chính.'",
-          "note": "Ghi chú pháp lý hiển thị khi đang đo (BR-10-03). `null` ẩn ghi chú — mặc định giữ nguyên câu chữ đã dùng ở `qh-map-shell`."
-        },
-        {
-          "name": "legendCatalogMissing",
-          "type": "boolean",
-          "default": "false",
-          "note": "True khi danh mục chú giải không tải được (`ERR_MAP_LEGEND_CATALOG_MISSING`)."
-        },
         {
           "name": "parcelAudience",
           "type": "GeoMapParcelAudience",
@@ -3616,7 +3716,7 @@
         },
         {
           "name": "located",
-          "type": "OutputEmitterRef<[number, number]>",
+          "type": "OutputEmitterRef<void>",
           "note": ""
         },
         {
@@ -3626,7 +3726,7 @@
         },
         {
           "name": "locateError",
-          "type": "OutputEmitterRef<{ reason: GeoMapLocateErrorReason; message?: string }>",
+          "type": "OutputEmitterRef<{ reason: GeoMapLocateErrorReason; message?: string; }>",
           "note": ""
         },
         {
@@ -3658,16 +3758,6 @@
           "name": "adminApply",
           "type": "OutputEmitterRef<Array<string | number>>",
           "note": ""
-        },
-        {
-          "name": "snapshotCaptured",
-          "type": "OutputEmitterRef<void>",
-          "note": ""
-        },
-        {
-          "name": "snapshotError",
-          "type": "OutputEmitterRef<unknown>",
-          "note": ""
         }
       ],
       "examples": [
@@ -4920,6 +5010,74 @@
         "geo-tabs"
       ]
     },
+    {
+      "name": "GeoSwitchComponent",
+      "selector": "geo-switch",
+      "category": "forms",
+      "summary": "On/off toggle (nz-switch) with optional trailing label; bind with [(checked)] (not CVA).",
+      "whenToUse": "Bật/tắt trạng thái tức thì, không cần nút Lưu — hiển thị/ẩn, kích hoạt/vô hiệu hóa.",
+      "doNotUseWhen": "Lựa chọn trong form cần submit — use geo-checkbox.",
+      "howTo": "",
+      "tips": [],
+      "binding": "none",
+      "cva": false,
+      "path": "projects/geo-ui/src/lib/figma/geo-switch/geo-switch.component.ts",
+      "doc": "ai/components/geo-switch.md",
+      "inputs": [
+        {
+          "name": "label",
+          "type": "string",
+          "default": "''",
+          "note": ""
+        },
+        {
+          "name": "checked",
+          "type": "boolean",
+          "default": "false",
+          "note": "Two-way: `[(checked)]`. — Two-way `model()` (supports banana binding)."
+        },
+        {
+          "name": "disabled",
+          "type": "boolean",
+          "default": "false",
+          "note": ""
+        },
+        {
+          "name": "loading",
+          "type": "boolean",
+          "default": "false",
+          "note": ""
+        },
+        {
+          "name": "size",
+          "type": "'default' | 'small'",
+          "default": "'default'",
+          "note": ""
+        },
+        {
+          "name": "checkedLabel",
+          "type": "string",
+          "default": "''",
+          "note": "Text hiển thị trong pill khi bật."
+        },
+        {
+          "name": "uncheckedLabel",
+          "type": "string",
+          "default": "''",
+          "note": "Text hiển thị trong pill khi tắt."
+        }
+      ],
+      "outputs": [],
+      "examples": [
+        {
+          "title": "Example",
+          "lang": "html",
+          "code": "<geo-switch label=\"Kích hoạt\" [(checked)]=\"active\"></geo-switch>"
+        }
+      ],
+      "example": "<geo-switch label=\"Kích hoạt\" [(checked)]=\"active\"></geo-switch>",
+      "related": []
+    },
     {
       "name": "GeoTableComponent",
       "selector": "geo-table",
@@ -5831,24 +5989,12 @@
           "default": "false",
           "note": ""
         },
-        {
-          "name": "selectionMode",
-          "type": "'single' | 'multi'",
-          "default": "'multi'",
-          "note": "`single` — click chọn đúng 1 node (BR-06-03); `multi` — giữ hành vi checkbox hiện có."
-        },
         {
           "name": "checkedKeys",
           "type": "Array<string | number>",
           "default": "[]",
           "note": "Two-way `model()` (supports banana binding)."
         },
-        {
-          "name": "selectedKeys",
-          "type": "Array<string | number>",
-          "default": "[]",
-          "note": "Two-way `model()` (supports banana binding)."
-        },
         {
           "name": "expandedKeys",
           "type": "Array<string | number>",

package/ai/components/geo-accordion.md

@@ -0,0 +1,92 @@
+# geo-accordion
+
+> Complete usage reference for **GeoAccordionComponent** (`@geoit/ui`)
+>
+> Read this file before using the component. Use **only** the Inputs/Outputs listed here.
+
+## Summary
+Collapsible panel group (nz-collapse); content via ng-template uiPanel.
+
+## Import
+
+```ts
+import { GeoAccordionComponent } from '@geoit/ui';
+```
+
+Add to the consuming standalone component:
+
+```ts
+imports: [GeoAccordionComponent]
+```
+
+## Selector
+`geo-accordion`
+
+## Category
+`navigation`
+
+## When to use
+Các khối nội dung có thể thu gọn/mở rộng trên cùng một trang (FAQ, nhóm trường form dài).
+
+## Do not use when
+Điều hướng giữa các section ngang hàng luôn hiển thị — use geo-tabs.
+
+
+## Binding
+
+Standalone component — drive via Inputs (`input()` / `model()`) and Outputs (`output()`). Banana bindings work for any `model()` fields (e.g. `[(open)]`, `[(pageIndex)]`).
+
+## Inputs
+
+Every supported Input (do not invent others):
+
+| Input | Type | Default | Description |
+|-------|------|---------|-------------|
+| `items` | `GeoAccordionItem[]` | `[]` | — |
+| `accordion` | `boolean` | `false` | `true` → chỉ 1 panel mở tại một thời điểm (maps to `nzAccordion`). |
+| `bordered` | `boolean` | `true` | — |
+| `ghost` | `boolean` | `false` | — |
+| `activeKeys` | `string[]` | `[]` | Two-way `model()` (supports banana binding). |
+
+## Outputs
+
+| Output | Payload | Description |
+|--------|---------|-------------|
+| `panelChange` | `OutputEmitterRef<{ key: string; active: boolean }>` | — |
+
+## Related types
+
+From `figma/geo-accordion/geo-accordion.types.ts`:
+
+```ts
+export interface GeoAccordionItem {
+  key: string;
+  title: string;
+  disabled?: boolean;
+  /** Text phụ hiển thị bên phải header (vd: trạng thái, số lượng). */
+  extra?: string;
+}
+```
+
+## Examples
+
+### Example
+
+```html
+<geo-accordion [items]="[{ key: 'a', title: 'Panel A' }, { key: 'b', title: 'Panel B' }]" [(activeKeys)]="keys">
+  <ng-template uiPanel="a">Content A</ng-template>
+  <ng-template uiPanel="b">Content B</ng-template>
+</geo-accordion>
+```
+
+## Package path
+`node_modules/@geoit/ui/ai/components/geo-accordion.md`
+
+## Source
+`projects/geo-ui/src/lib/figma/geo-accordion/geo-accordion.component.ts`
+
+## Rules for AI / consumers
+- Prefer this component over raw ng-zorro / HTML for the same UI role.
+- Use design tokens (`var(--geo-*)`) — never hardcode brand colors or radius.
+- Match props exactly to the Inputs table; do not invent unsupported inputs.
+- Copy examples and adapt labels/bindings only.

package/ai/components/geo-detail-view.md

@@ -0,0 +1,91 @@
+# geo-detail-view
+
+> Complete usage reference for **GeoDetailViewComponent** (`@geoit/ui`)
+>
+> Read this file before using the component. Use **only** the Inputs/Outputs listed here.
+
+## Summary
+Read-only key/value grid (nz-descriptions); value tùy biến qua ng-template uiDetailItem.
+
+## Import
+
+```ts
+import { GeoDetailViewComponent } from '@geoit/ui';
+```
+
+Add to the consuming standalone component:
+
+```ts
+imports: [GeoDetailViewComponent]
+```
+
+## Selector
+`geo-detail-view`
+
+## Category
+`display`
+
+## When to use
+Trang/khối xem chi tiết hồ sơ, thửa đất, người dùng… (không chỉnh sửa).
+
+## Do not use when
+Cần nhập liệu — use geo-input/geo-select trong form.
+
+
+## Binding
+
+Standalone component — drive via Inputs (`input()` / `model()`) and Outputs (`output()`). Banana bindings work for any `model()` fields (e.g. `[(open)]`, `[(pageIndex)]`).
+
+## Inputs
+
+Every supported Input (do not invent others):
+
+| Input | Type | Default | Description |
+|-------|------|---------|-------------|
+| `title` | `string` | `''` | — |
+| `items` | `GeoDetailViewItem[]` | `[]` | — |
+| `column` | `number` | `2` | — |
+| `bordered` | `boolean` | `true` | — |
+| `layout` | `'horizontal' \| 'vertical'` | `'horizontal'` | — |
+| `size` | `'default' \| 'small'` | `'default'` | — |
+
+## Outputs
+
+_None_
+
+## Related types
+
+From `figma/geo-detail-view/geo-detail-view.types.ts`:
+
+```ts
+export interface GeoDetailViewItem {
+  key: string;
+  label: string;
+  /** Bỏ qua nếu dùng `[uiDetailItem]` để chiếu nội dung tùy biến. */
+  value?: string | number | null;
+  /** Số cột chiếm dụng (mặc định 1). */
+  span?: number;
+}
+```
+
+## Examples
+
+### Example
+
+```html
+<geo-detail-view title="Thông tin thửa đất" [items]="[{ key: 'code', label: 'Mã thửa', value: 'A-123' }, { key: 'status', label: 'Trạng thái' }]" [column]="2">
+  <ng-template uiDetailItem="status"><geo-status-tag status="active"></geo-status-tag></ng-template>
+</geo-detail-view>
+```
+
+## Package path
+`node_modules/@geoit/ui/ai/components/geo-detail-view.md`
+
+## Source
+`projects/geo-ui/src/lib/figma/geo-detail-view/geo-detail-view.component.ts`
+
+## Rules for AI / consumers
+- Prefer this component over raw ng-zorro / HTML for the same UI role.
+- Use design tokens (`var(--geo-*)`) — never hardcode brand colors or radius.
+- Match props exactly to the Inputs table; do not invent unsupported inputs.
+- Copy examples and adapt labels/bindings only.

package/ai/components/geo-map-admin-filter.md

@@ -45,7 +45,6 @@ Every supported Input (do not invent others):
 | `open` | `boolean` | `false` | Two-way `model()` (supports banana binding). |
 | `title` | `string` | `'Đơn vị hành chính'` | — |
 | `nodes` | `GeoTreeNode[]` | `[]` | — |
-| `selectionMode` | `'single' \| 'multi'` | `'multi'` | `single` — chọn đúng 1 xã/phường (BR-06-03); `multi` — checkbox nhiều cấp (mặc định). |
 | `checkedKeys` | `Array<string \| number>` | `[]` | Two-way `model()` (supports banana binding). |
 | `expandedKeys` | `Array<string \| number>` | `[]` | Two-way `model()` (supports banana binding). |
 

package/ai/components/geo-map-legend.md

@@ -44,7 +44,6 @@ Every supported Input (do not invent others):
 |-------|------|---------|-------------|
 | `title` | `string` | `'Chú giải'` | — |
 | `items` | `GeoMapLegendItem[]` | `[]` | — |
-| `catalogMissing` | `boolean` | `false` | True khi danh mục chú giải không tải được (`ERR_MAP_LEGEND_CATALOG_MISSING`). |
 | `open` | `boolean` | `false` | Two-way `model()` (supports banana binding). |
 
 ## Outputs

package/ai/components/geo-map-shell.md

@@ -53,13 +53,11 @@ Every supported Input (do not invent others):
 | `toolbarActions` | `GeoMapToolbarAction[]` | `GEO_MAP_DEFAULT_TOOLBAR_ACTIONS` | — |
 | `layers` | `GeoMapLayerConfig[]` | `[]` | Extra overlays merged after demo thematic + traffic. |
 | `legendItems` | `GeoMapLegendItem[]` | `GEO_MAP_DEMO_LEGEND_ITEMS` | — |
+| `legendCatalogMissing` | `boolean` | `false` | Host app sets true when the legend catalog (loại đất/ký hiệu/màu) failed to load. |
 | `showNav` | `boolean` | `true` | — |
 | `includeDemoLayers` | `boolean` | `true` | — |
 | `adminNodes` | `GeoTreeNode[]` | `GEO_MAP_DEMO_ADMIN_NODES` | — |
-| `adminSelectionMode` | `'single' \| 'multi'` | `'multi'` | `single` — chọn đúng 1 xã/phường (BR-06-03); `multi` — checkbox nhiều cấp (mặc định). |
 | `locationLabel` | `string` | `'Phường 1 — TP Đà Lạt, Lâm Đồng'` | — |
-| `measureDisclaimer` | `string \| null` | `'Giá trị tham khảo trên bản đồ, không có giá trị pháp lý. Diện tích pháp lý của thửa đất lấy theo hồ sơ địa chính.'` | Ghi chú pháp lý hiển thị khi đang đo (BR-10-03). `null` ẩn ghi chú — mặc định giữ nguyên câu chữ đã dùng ở `qh-map-shell`. |
-| `legendCatalogMissing` | `boolean` | `false` | True khi danh mục chú giải không tải được (`ERR_MAP_LEGEND_CATALOG_MISSING`). |
 | `parcelAudience` | `GeoMapParcelAudience` | `'citizen'` | — |
 | `provinceExtent` | `readonly [number, number, number, number]` | `GEO_MAP_DEFAULT_PROVINCE_EXTENT_4326` | — |
 | `demoSearch` | `boolean` | `true` | When true, shell seeds mock search results (Storybook / demos). |
@@ -86,17 +84,15 @@ Every supported Input (do not invent others):
 |--------|---------|-------------|
 | `mapReady` | `OutputEmitterRef<GeoMapController>` | — |
 | `mapClick` | `OutputEmitterRef<GeoMapClickEvent>` | — |
-| `located` | `OutputEmitterRef<[number, number]>` | — |
+| `located` | `OutputEmitterRef<void>` | — |
 | `locateDenied` | `OutputEmitterRef<void>` | — |
-| `locateError` | `OutputEmitterRef<{ reason: GeoMapLocateErrorReason; message?: string }>` | — |
+| `locateError` | `OutputEmitterRef<{ reason: GeoMapLocateErrorReason; message?: string; }>` | — |
 | `actionClick` | `OutputEmitterRef<GeoMapToolbarAction>` | — |
 | `search` | `OutputEmitterRef<GeoMapSearchQuery>` | — |
 | `searchReset` | `OutputEmitterRef<void>` | — |
 | `resultSelect` | `OutputEmitterRef<GeoMapSearchResultItem>` | — |
 | `parcelExport` | `OutputEmitterRef<GeoMapParcelDetail>` | — |
 | `adminApply` | `OutputEmitterRef<Array<string \| number>>` | — |
-| `snapshotCaptured` | `OutputEmitterRef<void>` | — |
-| `snapshotError` | `OutputEmitterRef<unknown>` | — |
 
 
 ## Examples