@geoit/ui 0.0.4 → 0.0.5

package/ai/components/geo-slider.md

@@ -37,10 +37,10 @@ Thanh trượt số liên tục. Two-way [(value)] / (valueChange); min/max/step
 
 ## Binding
 
-**Not CVA.** Use two-way `value`:
+**`model()` two-way** on `value`:
 
 ```html
-<geo-slider [(value)]="n" (valueChange)="onChange($event)"></geo-slider>
+<geo-slider [(value)]="n"></geo-slider>
 ```
 
 ## Inputs
@@ -49,18 +49,16 @@ Every supported Input (do not invent others):
 
 | Input | Type | Default | Description |
 |-------|------|---------|-------------|
-| `value` | `number` | `0` | — |
+| `value` | `number` | `0` | Two-way `model()` (supports banana binding). |
 | `min` | `number` | `0` | — |
 | `max` | `number` | `100` | — |
 | `step` | `number` | `1` | — |
 | `disabled` | `boolean` | `false` | — |
-| `tipFormatter` | `(value: number)` | `> string` | — |
+| `tipFormatter` | `((value: number) => string) \| undefined` | `undefined` | — |
 
 ## Outputs
 
-| Output | Payload | Description |
-|--------|---------|-------------|
-| `valueChange` | `EventEmitter<number>` | — |
+_None_
 
 
 ## Examples

package/ai/components/geo-stat-card.md

@@ -0,0 +1,98 @@
+# geo-stat-card
+
+> Complete usage reference for **GeoStatCardComponent** (`@geoit/ui`)
+>
+> Read this file before using the component. Use **only** the Inputs/Outputs listed here.
+
+## Summary
+GeoStatCardComponent
+
+## Import
+
+```ts
+import { GeoStatCardComponent } from '@geoit/ui';
+```
+
+Add to the consuming standalone component:
+
+```ts
+imports: [GeoStatCardComponent]
+```
+
+## Selector
+`geo-stat-card`
+
+## Category
+`other`
+
+## When to use
+—
+
+## Do not use when
+—
+
+
+## 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 |
+|-------|------|---------|-------------|
+| `label` | `string` | `''` | — |
+| `value` | `string \| number` | `''` | — |
+| `unit` | `string` | `''` | — |
+| `icon` | `string` | `'bar-chart'` | — |
+| `hint` | `string` | `''` | — |
+| `clickable` | `boolean` | `false` | — |
+| `animate` | `boolean` | `true` | Count-up number animation. Honors `prefers-reduced-motion`. |
+| `animationDuration` | `number` | `1000` | Count-up duration in ms. |
+| `animationDelay` | `number` | `0` | Stagger delay before count-up starts (ms). |
+| `item` | `GeoStatCardItem \| null` | `null` | Convenience: bind a whole item object. |
+
+## Outputs
+
+| Output | Payload | Description |
+|--------|---------|-------------|
+| `clicked` | `OutputEmitterRef<void>` | — |
+
+## Related types
+
+From `figma/geo-stat-card/geo-stat-card.types.ts`:
+
+```ts
+export interface GeoStatCardItem {
+  id?: string;
+  label: string;
+  value: string | number;
+  /** Optional unit shown after value (e.g. m², thửa). */
+  unit?: string;
+  /** Ant Design icon name. */
+  icon?: string;
+  /** Optional helper / trend text. */
+  hint?: string;
+}
+```
+
+## Examples
+
+### Example
+
+```html
+<geo-stat-card></geo-stat-card>
+```
+
+## Package path
+`node_modules/@geoit/ui/ai/components/geo-stat-card.md`
+
+## Source
+`projects/geo-ui/src/lib/figma/geo-stat-card/geo-stat-card.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-status-tag.md

@@ -37,7 +37,7 @@ Tag trạng thái (dot + label). status preset success|primary|error|warning|inf
 
 ## Binding
 
-Standalone presentational / container component — drive via Inputs and Outputs (no `ngModel` unless documented).
+Standalone component — drive via Inputs (`input()` / `model()`) and Outputs (`output()`). Banana bindings work for any `model()` fields (e.g. `[(open)]`, `[(pageIndex)]`).
 
 ## Inputs
 
@@ -46,7 +46,7 @@ Every supported Input (do not invent others):
 | Input | Type | Default | Description |
 |-------|------|---------|-------------|
 | `status` | `GeoStatusPreset \| string` | `'success'` | Status preset or free-form string. Semantic: success \| primary \| error \| warning \| info \| teal \| neutral Legacy: completed \| cancelled \| in_progress \| adjusting |
-| `label` | `string` | — | Override label text. |
+| `label` | `string \| undefined` | `undefined` | Override label text. |
 | `showDot` | `boolean` | `true` | Show leading status dot (design default). |
 
 ## Outputs

package/ai/components/geo-step-form-layout.md

@@ -37,7 +37,7 @@ Wizard full-page: stepper dọc + card nội dung + footer Hủy/Trở lại/Lư
 
 ## Binding
 
-Standalone presentational / container component — drive via Inputs and Outputs (no `ngModel` unless documented).
+Standalone component — drive via Inputs (`input()` / `model()`) and Outputs (`output()`). Banana bindings work for any `model()` fields (e.g. `[(open)]`, `[(pageIndex)]`).
 
 ## Inputs
 
@@ -46,7 +46,7 @@ Every supported Input (do not invent others):
 | Input | Type | Default | Description |
 |-------|------|---------|-------------|
 | `steps` | `GeoStepperStep[]` | `[]` | — |
-| `activeIndex` | `number` | `0` | — |
+| `activeIndex` | `number` | `0` | Two-way `model()` (supports banana binding). |
 | `title` | `string` | `''` | — |
 | `clickableSteps` | `boolean` | `true` | — |
 | `showScrollButtons` | `boolean` | `true` | Hiện nút ↑/↓ góc phải card (chuyển bước). Mặc định `true`. |
@@ -67,12 +67,11 @@ Every supported Input (do not invent others):
 
 | Output | Payload | Description |
 |--------|---------|-------------|
-| `activeIndexChange` | `EventEmitter<number>` | — |
-| `stepSelect` | `EventEmitter<{ index: number; step: GeoStepperStep }>` | — |
-| `cancel` | `EventEmitter<void>` | — |
-| `previous` | `EventEmitter<void>` | — |
-| `save` | `EventEmitter<void>` | — |
-| `next` | `EventEmitter<void>` | — |
+| `stepSelect` | `OutputEmitterRef<{ index: number; step: GeoStepperStep }>` | — |
+| `cancel` | `OutputEmitterRef<void>` | — |
+| `previous` | `OutputEmitterRef<void>` | — |
+| `save` | `OutputEmitterRef<void>` | — |
+| `next` | `OutputEmitterRef<void>` | — |
 
 ## Related types
 

package/ai/components/geo-stepper.md

@@ -37,7 +37,7 @@ Chỉ báo bước. [steps] {key,label}[]; [activeIndex]; orientation horizontal
 
 ## Binding
 
-Standalone presentational / container component — drive via Inputs and Outputs (no `ngModel` unless documented).
+Standalone component — drive via Inputs (`input()` / `model()`) and Outputs (`output()`). Banana bindings work for any `model()` fields (e.g. `[(open)]`, `[(pageIndex)]`).
 
 ## Inputs
 
@@ -46,7 +46,7 @@ Every supported Input (do not invent others):
 | Input | Type | Default | Description |
 |-------|------|---------|-------------|
 | `steps` | `GeoStepperStep[]` | `[]` | — |
-| `activeIndex` | `number` | `0` | — |
+| `activeIndex` | `number` | `0` | Two-way `model()` (supports banana binding). |
 | `orientation` | `'vertical' \| 'horizontal'` | `'horizontal'` | Mặc định horizontal theo design form modal. |
 | `clickable` | `boolean` | `true` | Cho phép click để đổi bước. |
 
@@ -54,8 +54,7 @@ Every supported Input (do not invent others):
 
 | Output | Payload | Description |
 |--------|---------|-------------|
-| `activeIndexChange` | `EventEmitter<number>` | — |
-| `stepSelect` | `EventEmitter<{ index: number; step: GeoStepperStep }>` | — |
+| `stepSelect` | `OutputEmitterRef<{ index: number; step: GeoStepperStep }>` | — |
 
 ## Related types
 

package/ai/components/geo-table-filter.md

@@ -38,7 +38,7 @@ Thanh lọc bảng: ô tìm + bộ lọc nâng cao (ng-content). (search)/(reset
 
 ## Binding
 
-Standalone presentational / container component — drive via Inputs and Outputs (no `ngModel` unless documented).
+Standalone component — drive via Inputs (`input()` / `model()`) and Outputs (`output()`). Banana bindings work for any `model()` fields (e.g. `[(open)]`, `[(pageIndex)]`).
 
 ## Inputs
 
@@ -55,7 +55,7 @@ Every supported Input (do not invent others):
 | `searchLoading` | `boolean` | `false` | — |
 | `showAdvancedToggle` | `boolean` | `true` | Hiện nút mở/đóng slot `[advanced]`. |
 | `showReset` | `boolean` | `true` | — |
-| `advancedExpanded` | `boolean` | `false` | Mở panel field nâng cao (`[advanced]`). |
+| `advancedExpanded` | `boolean` | `false` | Mở panel field nâng cao (`[advanced]`). — Two-way `model()` (supports banana binding). |
 | `advancedFilterCount` | `number` | `0` | Số field advanced đang có giá trị — hiện badge trên nút expand. Parent tự tính (vd. `countFilledFilters(query, ADVANCED_KEYS)`). |
 | `filterToggleTitle` | `string` | `'Bộ lọc nâng cao'` | — |
 | `resetTitle` | `string` | `'Xóa bộ lọc'` | — |
@@ -64,9 +64,8 @@ Every supported Input (do not invent others):
 
 | Output | Payload | Description |
 |--------|---------|-------------|
-| `search` | `EventEmitter<void>` | — |
-| `reset` | `EventEmitter<void>` | — |
-| `advancedExpandedChange` | `EventEmitter<boolean>` | — |
+| `search` | `OutputEmitterRef<void>` | — |
+| `reset` | `OutputEmitterRef<void>` | — |
 
 
 ## Examples

package/ai/components/geo-table-pagination.md

@@ -37,7 +37,7 @@ Footer phân trang riêng cho bảng (nhãn khoảng + đổi page size). [pageI
 
 ## Binding
 
-Standalone presentational / container component — drive via Inputs and Outputs (no `ngModel` unless documented).
+Standalone component — drive via Inputs (`input()` / `model()`) and Outputs (`output()`). Banana bindings work for any `model()` fields (e.g. `[(open)]`, `[(pageIndex)]`).
 
 ## Inputs
 
@@ -45,8 +45,8 @@ Every supported Input (do not invent others):
 
 | Input | Type | Default | Description |
 |-------|------|---------|-------------|
-| `pageIndex` | `number` | `1` | — |
-| `pageSize` | `number` | `10` | — |
+| `pageIndex` | `number` | `1` | Two-way `model()` (supports banana binding). |
+| `pageSize` | `number` | `10` | Two-way `model()` (supports banana binding). |
 | `total` | `number` | `0` | — |
 | `pageSizeOptions` | `number[]` | `DEFAULT_UI_TABLE_PAGE_SIZE_OPTIONS` | — |
 | `showSizeChanger` | `boolean` | `true` | — |
@@ -56,10 +56,7 @@ Every supported Input (do not invent others):
 
 ## Outputs
 
-| Output | Payload | Description |
-|--------|---------|-------------|
-| `pageIndexChange` | `EventEmitter<number>` | — |
-| `pageSizeChange` | `EventEmitter<number>` | — |
+_None_
 
 
 ## Examples

package/ai/components/geo-table-toolbar.md

@@ -37,7 +37,7 @@ Toolbar danh sách: số kết quả, xóa/xuất/thêm, ẩn hiện cột. (add
 
 ## Binding
 
-Standalone presentational / container component — drive via Inputs and Outputs (no `ngModel` unless documented).
+Standalone component — drive via Inputs (`input()` / `model()`) and Outputs (`output()`). Banana bindings work for any `model()` fields (e.g. `[(open)]`, `[(pageIndex)]`).
 
 ## Inputs
 
@@ -54,17 +54,17 @@ Every supported Input (do not invent others):
 | `showAdd` | `boolean` | `true` | — |
 | `addLabel` | `string` | `'Thêm mới'` | — |
 | `columnItems` | `GeoColumnPickerItem[]` | `[]` | — |
-| `columnStorageKey` | `string` | — | Key lưu trạng thái ẩn/hiện cột trong sessionStorage |
+| `columnStorageKey` | `string \| undefined` | `undefined` | Key lưu trạng thái ẩn/hiện cột trong sessionStorage |
 
 ## Outputs
 
 | Output | Payload | Description |
 |--------|---------|-------------|
-| `deleteClick` | `EventEmitter<void>` | — |
-| `exportClick` | `EventEmitter<void>` | — |
-| `toggleColumns` | `EventEmitter<void>` | — |
-| `columnApply` | `EventEmitter<GeoColumnPickerApplyPayload>` | — |
-| `addClick` | `EventEmitter<void>` | — |
+| `deleteClick` | `OutputEmitterRef<void>` | — |
+| `exportClick` | `OutputEmitterRef<void>` | — |
+| `toggleColumns` | `OutputEmitterRef<void>` | — |
+| `columnApply` | `OutputEmitterRef<GeoColumnPickerApplyPayload>` | — |
+| `addClick` | `OutputEmitterRef<void>` | — |
 
 
 ## Examples

package/ai/components/geo-table.md

@@ -37,7 +37,7 @@ Bảng dữ liệu: [columns] GeoTableColumn[] + [data]. Hỗ trợ renderAs ind
 
 ## Binding
 
-Standalone presentational / container component — drive via Inputs and Outputs (no `ngModel` unless documented).
+Standalone component — drive via Inputs (`input()` / `model()`) and Outputs (`output()`). Banana bindings work for any `model()` fields (e.g. `[(open)]`, `[(pageIndex)]`).
 
 ## Inputs
 
@@ -56,42 +56,39 @@ Every supported Input (do not invent others):
 | `tableLayout` | `'auto' \| 'fixed'` | `'auto'` | — |
 | `showPagination` | `boolean` | `true` | — |
 | `frontPagination` | `boolean` | `true` | — |
-| `pageIndex` | `number` | `1` | — |
-| `pageSize` | `number` | `10` | — |
-| `total` | `number` | — | — |
+| `pageIndex` | `number` | `1` | Two-way `model()` (supports banana binding). |
+| `pageSize` | `number` | `10` | Two-way `model()` (supports banana binding). |
+| `total` | `number \| undefined` | `undefined` | — |
 | `pageSizeOptions` | `number[]` | `DEFAULT_UI_TABLE_PAGE_SIZE_OPTIONS` | — |
 | `showSizeChanger` | `boolean` | `false` | — |
 | `showQuickJumper` | `boolean` | `false` | — |
 | `hideOnSinglePage` | `boolean` | `false` | — |
 | `simplePagination` | `boolean` | `false` | — |
 | `paginationPosition` | `'top' \| 'bottom' \| 'both'` | `'bottom'` | — |
-| `scroll` | `{ x?: string; y?: string }` | `{}` | — |
-| `scrollY` | `string` | — | — |
+| `scroll` | `{ x?: string; y?: string }` | — | — |
+| `scrollY` | `string \| undefined` | `undefined` | — |
 | `autoScroll` | `boolean` | `false` | Tự bật scroll ngang theo tổng width cột. Khi có cột `fixed`, scroll.x luôn được tính (bắt buộc với nz-table fixed). |
-| `tableTitle` | `string` | — | — |
-| `footer` | `string` | — | — |
+| `tableTitle` | `string \| undefined` | `undefined` | — |
+| `footer` | `string \| undefined` | `undefined` | — |
 | `emptyText` | `string` | `'Không có dữ liệu'` | — |
 | `showTotalRange` | `boolean` | `false` | — |
 | `selectable` | `boolean` | `false` | — |
 | `rowKey` | `string` | `'id'` | — |
-| `selectedKeys` | `string[]` | `[]` | — |
-| `mobileTitleKey` | `string` | — | 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. |
+| `selectedKeys` | `string[]` | `[]` | Two-way `model()` (supports banana binding). |
+| `mobileTitleKey` | `string \| undefined` | `undefined` | 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. |
 | `mobileCardView` | `boolean` | `true` | Bật/tắt chuyển card trên mobile (mặc định bật). |
 
 ## Outputs
 
 | Output | Payload | Description |
 |--------|---------|-------------|
-| `rowClick` | `EventEmitter<Record<string, unknown>>` | — |
-| `rowEdit` | `EventEmitter<Record<string, unknown>>` | — |
-| `rowMore` | `EventEmitter<Record<string, unknown>>` | — |
-| `rowAction` | `EventEmitter<{ row: Record<string, unknown>; action: string }>` | — |
-| `pageIndexChange` | `EventEmitter<number>` | — |
-| `pageSizeChange` | `EventEmitter<number>` | — |
-| `queryParams` | `EventEmitter<NzTableQueryParams>` | — |
-| `currentPageDataChange` | `EventEmitter<readonly Record<string, unknown>[]>` | — |
-| `selectedKeysChange` | `EventEmitter<string[]>` | — |
-| `selectionChange` | `EventEmitter<Record<string, unknown>[]>` | — |
+| `rowClick` | `OutputEmitterRef<Record<string, unknown>>` | — |
+| `rowEdit` | `OutputEmitterRef<Record<string, unknown>>` | — |
+| `rowMore` | `OutputEmitterRef<Record<string, unknown>>` | — |
+| `rowAction` | `OutputEmitterRef<{ row: Record<string, unknown>; action: string }>` | — |
+| `queryParams` | `OutputEmitterRef<NzTableQueryParams>` | — |
+| `currentPageDataChange` | `OutputEmitterRef<readonly Record<string, unknown>[]>` | — |
+| `selectionChange` | `OutputEmitterRef<Record<string, unknown>[]>` | — |
 
 ## Related types
 

package/ai/components/geo-tabs.md

@@ -37,7 +37,7 @@ Tab ngang brand ink. [items] {key,title}[]; nội dung qua <ng-template uiTab="k
 
 ## Binding
 
-Standalone presentational / container component — drive via Inputs and Outputs (no `ngModel` unless documented).
+Standalone component — drive via Inputs (`input()` / `model()`) and Outputs (`output()`). Banana bindings work for any `model()` fields (e.g. `[(open)]`, `[(pageIndex)]`).
 
 ## Inputs
 
@@ -48,8 +48,8 @@ Every supported Input (do not invent others):
 | `items` | `GeoTabItem[]` | `[]` | — |
 | `type` | `'line' \| 'card'` | `'line'` | — |
 | `size` | `'default' \| 'large' \| 'small'` | `'default'` | — |
-| `selectedIndex` | `number` | `0` | — |
-| `selectedKey` | `string` | — | — |
+| `selectedIndex` | `number` | `0` | Two-way `model()` (supports banana binding). |
+| `selectedKey` | `string \| undefined` | `undefined` | Two-way `model()` (supports banana binding). |
 | `centered` | `boolean` | `false` | — |
 | `animated` | `boolean` | `true` | — |
 
@@ -57,9 +57,7 @@ Every supported Input (do not invent others):
 
 | Output | Payload | Description |
 |--------|---------|-------------|
-| `selectedIndexChange` | `EventEmitter<number>` | — |
-| `selectedKeyChange` | `EventEmitter<string>` | — |
-| `tabChange` | `EventEmitter<{ index: number; key: string }>` | — |
+| `tabChange` | `OutputEmitterRef<{ index: number; key: string }>` | — |
 
 ## Related types
 

package/ai/components/geo-textarea.md

@@ -48,6 +48,8 @@ Supports **ControlValueAccessor**.
 
 Also import `FormsModule` (template-driven) or `ReactiveFormsModule`.
 
+Library API uses Angular 18 `input()` / `output()` signals under the hood.
+
 ## Inputs
 
 Every supported Input (do not invent others):
@@ -61,14 +63,14 @@ Every supported Input (do not invent others):
 | `required` | `boolean` | `false` | — |
 | `error` | `boolean` | `false` | — |
 | `errorMessage` | `string` | `''` | — |
-| `maxlength` | `number` | — | — |
+| `maxlength` | `number \| undefined` | `undefined` | — |
 | `block` | `boolean` | `true` | — |
 
 ## Outputs
 
 | Output | Payload | Description |
 |--------|---------|-------------|
-| `valueChange` | `EventEmitter<string>` | — |
+| `valueChange` | `OutputEmitterRef<string>` | — |
 
 
 ## Examples

package/ai/components/geo-toast.md

@@ -38,7 +38,7 @@ Thông báo tạm thời. Ưu tiên inject GeoToastService (success/error/warnin
 
 ## Binding
 
-Standalone presentational / container component — drive via Inputs and Outputs (no `ngModel` unless documented).
+Standalone component — drive via Inputs (`input()` / `model()`) and Outputs (`output()`). Banana bindings work for any `model()` fields (e.g. `[(open)]`, `[(pageIndex)]`).
 
 ## Inputs
 
@@ -51,14 +51,14 @@ Every supported Input (do not invent others):
 | `message` | `string` | `''` | — |
 | `closable` | `boolean` | `true` | — |
 | `showIcon` | `boolean` | `true` | — |
-| `visible` | `boolean` | `true` | — |
-| `icon` | `string` | — | Override Ant Design icon type. |
+| `visible` | `boolean` | `true` | Two-way `model()` (supports banana binding). |
+| `icon` | `string \| undefined` | `undefined` | Override Ant Design icon type. |
 
 ## Outputs
 
 | Output | Payload | Description |
 |--------|---------|-------------|
-| `closed` | `EventEmitter<void>` | — |
+| `closed` | `OutputEmitterRef<void>` | — |
 
 ## Related types
 

package/ai/components/geo-tree.md

@@ -37,7 +37,7 @@ Cây phân cấp. [nodes] GeoTreeNode[]; bật checkable + [(checkedKeys)]; [(ex
 
 ## Binding
 
-Standalone presentational / container component — drive via Inputs and Outputs (no `ngModel` unless documented).
+Standalone component — drive via Inputs (`input()` / `model()`) and Outputs (`output()`). Banana bindings work for any `model()` fields (e.g. `[(open)]`, `[(pageIndex)]`).
 
 ## Inputs
 
@@ -47,8 +47,8 @@ Every supported Input (do not invent others):
 |-------|------|---------|-------------|
 | `nodes` | `GeoTreeNode[]` | `[]` | — |
 | `checkable` | `boolean` | `false` | — |
-| `checkedKeys` | `Array<string \| number>` | `[]` | — |
-| `expandedKeys` | `Array<string \| number>` | `[]` | — |
+| `checkedKeys` | `Array<string \| number>` | `[]` | Two-way `model()` (supports banana binding). |
+| `expandedKeys` | `Array<string \| number>` | `[]` | Two-way `model()` (supports banana binding). |
 | `showLine` | `boolean` | `false` | — |
 | `blockNode` | `boolean` | `false` | — |
 
@@ -56,9 +56,7 @@ Every supported Input (do not invent others):
 
 | Output | Payload | Description |
 |--------|---------|-------------|
-| `checkedKeysChange` | `EventEmitter<Array<string \| number>>` | — |
-| `expandedKeysChange` | `EventEmitter<Array<string \| number>>` | — |
-| `nodeClick` | `EventEmitter<NzFormatEmitEvent>` | — |
+| `nodeClick` | `OutputEmitterRef<NzFormatEmitEvent>` | — |
 
 ## Related types
 

package/ai/components/geo-typography.md

@@ -37,7 +37,7 @@ Text theo type scale GEO. variant h1–h4|subtitle|body|body-small|caption|…;
 
 ## Binding
 
-Standalone presentational / container component — drive via Inputs and Outputs (no `ngModel` unless documented).
+Standalone component — drive via Inputs (`input()` / `model()`) and Outputs (`output()`). Banana bindings work for any `model()` fields (e.g. `[(open)]`, `[(pageIndex)]`).
 
 ## Inputs
 

package/ai/components/geo-upload.md

@@ -37,7 +37,7 @@ Vùng kéo-thả upload + danh sách tiến độ. accept/maxSize; [(fileList)];
 
 ## Binding
 
-Standalone presentational / container component — drive via Inputs and Outputs (no `ngModel` unless documented).
+Standalone component — drive via Inputs (`input()` / `model()`) and Outputs (`output()`). Banana bindings work for any `model()` fields (e.g. `[(open)]`, `[(pageIndex)]`).
 
 ## Inputs
 
@@ -58,23 +58,22 @@ Every supported Input (do not invent others):
 | `titleSuffix` | `string` | `'để tải lên'` | — |
 | `listTitle` | `string` | `'Tập tin đính kèm'` | — |
 | `showListTitle` | `boolean` | `true` | — |
-| `fileList` | `GeoUploadFile[]` | `[]` | Controlled file list. |
-| `headers` | `{} \| ((file: NzUploadFile) => {} \| Observable<{}>)` | — | — |
-| `data` | `{} \| ((file: NzUploadFile) => {} \| Observable<{}>)` | — | — |
+| `fileList` | `GeoUploadFile[]` | `[]` | Controlled file list. — Two-way `model()` (supports banana binding). |
+| `headers` | `{} \| ((file: NzUploadFile) => {} \| Observable<{}>) \| undefined` | `undefined` | — |
+| `data` | `{} \| ((file: NzUploadFile) => {} \| Observable<{}>) \| undefined` | `undefined` | — |
 | `name` | `string` | `'file'` | — |
 | `withCredentials` | `boolean` | `false` | — |
 | `directory` | `boolean` | `false` | — |
-| `customRequest` | `(item: NzUploadXHRArgs) => Subscription` | — | Custom XHR — mặc định simulate progress khi không có `action`. |
-| `beforeUpload` | `( file: NzUploadFile, fileList: NzUploadFile[] )` | `> boolean \| Observable<boolean>` | — |
+| `customRequest` | `GeoUploadCustomRequest \| undefined` | `undefined` | Custom XHR — mặc định simulate progress khi không có `action`. |
+| `beforeUpload` | `((file: NzUploadFile, fileList: NzUploadFile[]) => boolean \| Observable<boolean>) \| undefined` | `undefined` | — |
 
 ## Outputs
 
 | Output | Payload | Description |
 |--------|---------|-------------|
-| `fileListChange` | `EventEmitter<GeoUploadFile[]>` | — |
-| `change` | `EventEmitter<NzUploadChangeParam>` | — |
-| `remove` | `EventEmitter<GeoUploadFile>` | — |
-| `reject` | `EventEmitter<{ file: File; reason: 'type' \| 'size' }>` | — |
+| `change` | `OutputEmitterRef<NzUploadChangeParam>` | — |
+| `remove` | `OutputEmitterRef<GeoUploadFile>` | — |
+| `reject` | `OutputEmitterRef<{ file: File; reason: 'type' \| 'size' }>` | — |
 
 ## Related types