@geoit/ui 0.0.5 → 0.0.7

package/ai/components/geo-chart.md

@@ -5,7 +5,7 @@
 > Read this file before using the component. Use **only** the Inputs/Outputs listed here.
 
 ## Summary
-GeoChartComponent
+Bar / donut chart for dashboard statistics (ApexCharts).
 
 ## Import
 
@@ -23,14 +23,17 @@ imports: [GeoChartComponent]
 `geo-chart`
 
 ## Category
-`other`
+`data`
 
 ## When to use
-—
+KPI breakdowns on dashboard pages.
 
 ## Do not use when
-—
+Maps / spatial — use geo-map; single KPI — use geo-stat-card.
 
+## How to use
+
+Biểu đồ bar/donut cho dashboard. [data] = { label, value, color? }[]; (segmentClick) khi click lát.
 
 ## Binding
 
@@ -84,12 +87,21 @@ export type GeoChartSort = 'none' | 'asc' | 'desc';
 
 ## Examples
 
-### Example
+### Bar
 
 ```html
-<geo-chart></geo-chart>
+<geo-chart type="bar" title="Theo xã" [data]="wardData" [height]="280"></geo-chart>
 ```
 
+## Tips
+
+- Màu ưu tiên CSS var(--geo-color-*).
+- KPI đơn → geo-stat-card; ghép sẵn → geo-dashboard.
+## Related components
+
+- [`geo-stat-card`](./geo-stat-card.md)
+- [`geo-dashboard`](./geo-dashboard.md)
+- [`geo-empty-state`](./geo-empty-state.md)
 ## Package path
 `node_modules/@geoit/ui/ai/components/geo-chart.md`
 

package/ai/components/geo-dashboard.md

@@ -5,7 +5,7 @@
 > Read this file before using the component. Use **only** the Inputs/Outputs listed here.
 
 ## Summary
-GeoDashboardComponent
+Composed dashboard: period, KPI cards, ward/mismatch charts.
 
 ## Import
 
@@ -23,14 +23,17 @@ imports: [GeoDashboardComponent]
 `geo-dashboard`
 
 ## Category
-`other`
+`layout`
 
 ## When to use
-—
+TCQH overview pages (thống kê nhanh).
 
 ## Do not use when
-—
+Custom layouts — compose geo-stat-card + geo-chart yourself.
 
+## How to use
+
+Dashboard ghép sẵn: stats + biểu đồ xã + lệch kỳ. [(period)] điều khiển kỳ thống kê.
 
 ## Binding
 
@@ -72,12 +75,20 @@ export interface GeoDashboardPeriodChange {
 
 ## Examples
 
-### Example
+### Basic
 
 ```html
-<geo-dashboard></geo-dashboard>
+<geo-dashboard [stats]="stats" [wardData]="wards" [mismatchData]="mismatch" [(period)]="period"></geo-dashboard>
 ```
 
+## Tips
+
+- Tự layout → geo-stat-card + geo-chart.
+## Related components
+
+- [`geo-stat-card`](./geo-stat-card.md)
+- [`geo-chart`](./geo-chart.md)
+- [`geo-page-header`](./geo-page-header.md)
 ## Package path
 `node_modules/@geoit/ui/ai/components/geo-dashboard.md`
 

package/ai/components/geo-empty-state.md

@@ -5,7 +5,7 @@
 > Read this file before using the component. Use **only** the Inputs/Outputs listed here.
 
 ## Summary
-GeoEmptyStateComponent
+Empty region placeholder (icon + title + optional action).
 
 ## Import
 
@@ -23,13 +23,13 @@ imports: [GeoEmptyStateComponent]
 `geo-empty-state`
 
 ## Category
-`other`
+`feedback`
 
 ## When to use
-—
+No data / no results areas inside pages or cards.
 
 ## Do not use when
-—
+Inline form validation — use field errorMessage / geo-alert.
 
 
 ## Binding
@@ -59,7 +59,7 @@ Every supported Input (do not invent others):
 ### Example
 
 ```html
-<geo-empty-state></geo-empty-state>
+<geo-empty-state title="Chưa có dữ liệu" description="Thử đổi bộ lọc."></geo-empty-state>
 ```
 
 ## Package path

package/ai/components/geo-feedback-form.md

@@ -5,7 +5,7 @@
 > Read this file before using the component. Use **only** the Inputs/Outputs listed here.
 
 ## Summary
-GeoFeedbackFormComponent
+Citizen feedback / phản ánh form with validation.
 
 ## Import
 
@@ -23,13 +23,13 @@ imports: [GeoFeedbackFormComponent]
 `geo-feedback-form`
 
 ## Category
-`other`
+`forms`
 
 ## When to use
-—
+Public feedback submission pages.
 
 ## Do not use when
-—
+Admin feedback inbox — use geo-list-page + geo-table.
 
 
 ## Binding
@@ -81,7 +81,7 @@ export interface GeoFeedbackReplyPayload {
 ### Example
 
 ```html
-<geo-feedback-form></geo-feedback-form>
+<geo-feedback-form (submittedFeedback)="send($event)"></geo-feedback-form>
 ```
 
 ## Package path

package/ai/components/geo-forgot-password.md

@@ -5,7 +5,7 @@
 > Read this file before using the component. Use **only** the Inputs/Outputs listed here.
 
 ## Summary
-GeoForgotPasswordComponent
+Forgot-password form (email + submit / back to login).
 
 ## Import
 
@@ -23,13 +23,13 @@ imports: [GeoForgotPasswordComponent]
 `geo-forgot-password`
 
 ## Category
-`other`
+`forms`
 
 ## When to use
-—
+Password reset entry page.
 
 ## Do not use when
-—
+Inside login card — navigate to a dedicated route.
 
 
 ## Binding
@@ -62,7 +62,10 @@ Every supported Input (do not invent others):
 ### Example
 
 ```html
-<geo-forgot-password></geo-forgot-password>
+<geo-forgot-password
+  (submitEmail)="reset($event)"
+  (backToLogin)="goLogin()"
+></geo-forgot-password>
 ```
 
 ## Package path

package/ai/components/geo-list-page.md

@@ -5,7 +5,7 @@
 > Read this file before using the component. Use **only** the Inputs/Outputs listed here.
 
 ## Summary
-GeoListPageComponent
+List page chrome: title + breadcrumb shell for admin CRUD screens.
 
 ## Import
 
@@ -23,13 +23,13 @@ imports: [GeoListPageComponent]
 `geo-list-page`
 
 ## Category
-`other`
+`layout`
 
 ## When to use
-—
+Wrap table toolbars on admin list pages.
 
 ## Do not use when
-—
+Map portals — use geo-map-shell; dashboards — use geo-dashboard.
 
 
 ## Binding
@@ -56,7 +56,10 @@ _None_
 ### Example
 
 ```html
-<geo-list-page></geo-list-page>
+<geo-list-page title="Quản lý người dùng" [breadcrumb]="crumbs">
+  <geo-table-toolbar ...></geo-table-toolbar>
+  <geo-table ...></geo-table>
+</geo-list-page>
 ```
 
 ## Package path

package/ai/components/geo-login.md

@@ -5,7 +5,7 @@
 > Read this file before using the component. Use **only** the Inputs/Outputs listed here.
 
 ## Summary
-GeoLoginComponent
+Login form (username, password, captcha, remember).
 
 ## Import
 
@@ -23,14 +23,17 @@ imports: [GeoLoginComponent]
 `geo-login`
 
 ## Category
-`other`
+`forms`
 
 ## When to use
-—
+Specialist / admin login page.
 
 ## Do not use when
-—
+SSO-only flows without local credentials.
 
+## How to use
+
+Form đăng nhập: username/password/captcha/remember. (submitLogin) payload; (forgotPassword) điều hướng quên mật khẩu.
 
 ## Binding
 
@@ -75,12 +78,21 @@ export interface GeoLoginPayload {
 
 ## Examples
 
-### Example
+### Basic
 
 ```html
-<geo-login></geo-login>
+<geo-login (submitLogin)="login($event)" (forgotPassword)="goForgot()"></geo-login>
 ```
 
+## Tips
+
+- Cần FormsModule + styles tokens.
+- Ghép geo-forgot-password trên route riêng.
+## Related components
+
+- [`geo-forgot-password`](./geo-forgot-password.md)
+- [`geo-input`](./geo-input.md)
+- [`geo-button`](./geo-button.md)
 ## Package path
 `node_modules/@geoit/ui/ai/components/geo-login.md`
 

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

@@ -5,7 +5,7 @@
 > Read this file before using the component. Use **only** the Inputs/Outputs listed here.
 
 ## Summary
-GeoMapAdminFilterComponent
+Administrative unit tree filter (ĐVHC) for map extent.
 
 ## Import
 
@@ -23,13 +23,13 @@ imports: [GeoMapAdminFilterComponent]
 `geo-map-admin-filter`
 
 ## Category
-`other`
+`map`
 
 ## When to use
-—
+Filter map by tỉnh/huyện/xã; included in geo-map-shell.
 
 ## Do not use when
-—
+Generic trees outside map — use geo-tree.
 
 
 ## Binding
@@ -45,6 +45,7 @@ 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). |
 
@@ -64,7 +65,12 @@ Every supported Input (do not invent others):
 ### Example
 
 ```html
-<geo-map-admin-filter></geo-map-admin-filter>
+<geo-map-admin-filter
+  [(open)]="adminOpen"
+  [nodes]="adminNodes"
+  [(checkedKeys)]="checked"
+  (apply)="applyAdmin($event)"
+></geo-map-admin-filter>
 ```
 
 ## Package path

package/ai/components/geo-map-basemap-switcher.md

@@ -5,7 +5,7 @@
 > Read this file before using the component. Use **only** the Inputs/Outputs listed here.
 
 ## Summary
-GeoMapBasemapSwitcherComponent
+Basemap preview chip (e.g. street ↔ satellite).
 
 ## Import
 
@@ -23,13 +23,13 @@ imports: [GeoMapBasemapSwitcherComponent]
 `geo-map-basemap-switcher`
 
 ## Category
-`other`
+`map`
 
 ## When to use
-—
+Bottom-right basemap toggle; included in geo-map-shell.
 
 ## Do not use when
-—
+Programmatic basemap only — set geo-map [basemap] / shell basemapId.
 
 
 ## Binding
@@ -59,7 +59,11 @@ Every supported Input (do not invent others):
 ### Example
 
 ```html
-<geo-map-basemap-switcher></geo-map-basemap-switcher>
+<geo-map-basemap-switcher
+  [options]="basemapOptions"
+  [(selectedId)]="basemapId"
+  (basemapChange)="onBasemap($event)"
+></geo-map-basemap-switcher>
 ```
 
 ## Package path

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

@@ -5,7 +5,7 @@
 > Read this file before using the component. Use **only** the Inputs/Outputs listed here.
 
 ## Summary
-GeoMapHelpComponent
+Map help / hướng dẫn popover with sections.
 
 ## Import
 
@@ -23,13 +23,13 @@ imports: [GeoMapHelpComponent]
 `geo-map-help`
 
 ## Category
-`other`
+`map`
 
 ## When to use
-—
+Help affordance on map chrome.
 
 ## Do not use when
-—
+App-wide help pages — use normal content pages.
 
 
 ## Binding
@@ -56,7 +56,7 @@ _None_
 ### Example
 
 ```html
-<geo-map-help></geo-map-help>
+<geo-map-help [(open)]="helpOpen" [sections]="helpSections"></geo-map-help>
 ```
 
 ## Package path

package/ai/components/geo-map-layer-card.md

@@ -5,7 +5,7 @@
 > Read this file before using the component. Use **only** the Inputs/Outputs listed here.
 
 ## Summary
-GeoMapLayerCardComponent
+Basemap / layer preview card (thumbnail + title).
 
 ## Import
 
@@ -23,13 +23,13 @@ imports: [GeoMapLayerCardComponent]
 `geo-map-layer-card`
 
 ## Category
-`other`
+`map`
 
 ## When to use
-—
+Layer pickers and basemap grids.
 
 ## Do not use when
-—
+Full layer management — use geo-map-layer-panel.
 
 
 ## Binding
@@ -57,7 +57,7 @@ Every supported Input (do not invent others):
 ### Example
 
 ```html
-<geo-map-layer-card></geo-map-layer-card>
+<geo-map-layer-card title="Đường phố" [previewUrl]="url" (clicked)="select()"></geo-map-layer-card>
 ```
 
 ## Package path

package/ai/components/geo-map-layer-panel.md

@@ -5,7 +5,7 @@
 > Read this file before using the component. Use **only** the Inputs/Outputs listed here.
 
 ## Summary
-GeoMapLayerPanelComponent
+Layer list with visibility / opacity / group selection.
 
 ## Import
 
@@ -23,13 +23,13 @@ imports: [GeoMapLayerPanelComponent]
 `geo-map-layer-panel`
 
 ## Category
-`other`
+`map`
 
 ## When to use
-—
+Standalone layer manager or inside geo-map-layers-drawer.
 
 ## Do not use when
-—
+Single opacity control — use geo-map-opacity.
 
 
 ## Binding
@@ -59,7 +59,7 @@ Every supported Input (do not invent others):
 ### Example
 
 ```html
-<geo-map-layer-panel></geo-map-layer-panel>
+<geo-map-layer-panel [layers]="layers" [controller]="ctrl" [embedded]="true"></geo-map-layer-panel>
 ```
 
 ## Package path

package/ai/components/geo-map-layers-drawer.md

@@ -5,7 +5,7 @@
 > Read this file before using the component. Use **only** the Inputs/Outputs listed here.
 
 ## Summary
-GeoMapLayersDrawerComponent
+Popover/drawer hosting the layer panel (“Lớp bản đồ”).
 
 ## Import
 
@@ -23,13 +23,13 @@ imports: [GeoMapLayersDrawerComponent]
 `geo-map-layers-drawer`
 
 ## Category
-`other`
+`map`
 
 ## When to use
-—
+Portal layer UI; included in geo-map-shell.
 
 ## Do not use when
-—
+Always-visible side panel — embed geo-map-layer-panel directly.
 
 
 ## Binding
@@ -62,7 +62,7 @@ Every supported Input (do not invent others):
 ### Example
 
 ```html
-<geo-map-layers-drawer></geo-map-layers-drawer>
+<geo-map-layers-drawer [(open)]="layersOpen" [layers]="layers" [controller]="ctrl"></geo-map-layers-drawer>
 ```
 
 ## Package path

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

@@ -5,7 +5,7 @@
 > Read this file before using the component. Use **only** the Inputs/Outputs listed here.
 
 ## Summary
-GeoMapLegendComponent
+Map legend popover / panel with color swatches.
 
 ## Import
 
@@ -23,13 +23,13 @@ imports: [GeoMapLegendComponent]
 `geo-map-legend`
 
 ## Category
-`other`
+`map`
 
 ## When to use
-—
+Show thematic legend; geo-map-shell includes this.
 
 ## Do not use when
-—
+Non-map legends in dashboards — use static markup / geo-status-tag.
 
 
 ## Binding
@@ -44,6 +44,7 @@ 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
@@ -58,7 +59,7 @@ Every supported Input (do not invent others):
 ### Example
 
 ```html
-<geo-map-legend></geo-map-legend>
+<geo-map-legend [(open)]="legendOpen" [items]="legendItems"></geo-map-legend>
 ```
 
 ## Package path

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

@@ -5,7 +5,7 @@
 > Read this file before using the component. Use **only** the Inputs/Outputs listed here.
 
 ## Summary
-GeoMapLocateComponent
+Geolocation button (browser GPS) for the map view.
 
 ## Import
 
@@ -23,13 +23,13 @@ imports: [GeoMapLocateComponent]
 `geo-map-locate`
 
 ## Category
-`other`
+`map`
 
 ## When to use
-—
+Locate-me control on custom map chrome.
 
 ## Do not use when
-—
+Inside geo-map-shell (already wired) unless building a custom shell.
 
 
 ## Binding
@@ -59,7 +59,7 @@ Every supported Input (do not invent others):
 ### Example
 
 ```html
-<geo-map-locate></geo-map-locate>
+<geo-map-locate [controller]="ctrl" (denied)="onDenied()"></geo-map-locate>
 ```
 
 ## Package path

package/ai/components/geo-map-location-chip.md

@@ -5,7 +5,7 @@
 > Read this file before using the component. Use **only** the Inputs/Outputs listed here.
 
 ## Summary
-GeoMapLocationChipComponent
+Location breadcrumb chip shown on the map (ward / province).
 
 ## Import
 
@@ -23,13 +23,13 @@ imports: [GeoMapLocationChipComponent]
 `geo-map-location-chip`
 
 ## Category
-`other`
+`map`
 
 ## When to use
-—
+Show current admin context on map chrome.
 
 ## Do not use when
-—
+Page breadcrumb — use geo-breadcrumb.
 
 
 ## Binding
@@ -55,7 +55,7 @@ _None_
 ### Example
 
 ```html
-<geo-map-location-chip></geo-map-location-chip>
+<geo-map-location-chip label="Phường 1 — TP Đà Lạt, Lâm Đồng"></geo-map-location-chip>
 ```
 
 ## Package path

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

@@ -5,7 +5,7 @@
 > Read this file before using the component. Use **only** the Inputs/Outputs listed here.
 
 ## Summary
-GeoMapMeasureComponent
+Distance / area measure interaction on the map.
 
 ## Import
 
@@ -23,13 +23,13 @@ imports: [GeoMapMeasureComponent]
 `geo-map-measure`
 
 ## Category
-`other`
+`map`
 
 ## When to use
-—
+Measure tool mode; usually driven by toolbar via geo-map-shell.
 
 ## Do not use when
-—
+Static length labels without interaction.
 
 
 ## Binding
@@ -58,7 +58,7 @@ Every supported Input (do not invent others):
 ### Example
 
 ```html
-<geo-map-measure></geo-map-measure>
+<geo-map-measure [controller]="ctrl" [(mode)]="measureMode"></geo-map-measure>
 ```
 
 ## Package path