@geoit/ui 0.0.4 → 0.0.5

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

@@ -0,0 +1,72 @@
+# geo-list-page
+
+> Complete usage reference for **GeoListPageComponent** (`@geoit/ui`)
+>
+> Read this file before using the component. Use **only** the Inputs/Outputs listed here.
+
+## Summary
+GeoListPageComponent
+
+## Import
+
+```ts
+import { GeoListPageComponent } from '@geoit/ui';
+```
+
+Add to the consuming standalone component:
+
+```ts
+imports: [GeoListPageComponent]
+```
+
+## Selector
+`geo-list-page`
+
+## 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 |
+|-------|------|---------|-------------|
+| `title` | `string` | `''` | — |
+| `breadcrumb` | `GeoBreadcrumbItem[]` | `[]` | — |
+| `uppercase` | `boolean` | `true` | — |
+
+## Outputs
+
+_None_
+
+
+## Examples
+
+### Example
+
+```html
+<geo-list-page></geo-list-page>
+```
+
+## Package path
+`node_modules/@geoit/ui/ai/components/geo-list-page.md`
+
+## Source
+`projects/geo-ui/src/lib/figma/geo-list-page/geo-list-page.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-login.md

@@ -0,0 +1,94 @@
+# geo-login
+
+> Complete usage reference for **GeoLoginComponent** (`@geoit/ui`)
+>
+> Read this file before using the component. Use **only** the Inputs/Outputs listed here.
+
+## Summary
+GeoLoginComponent
+
+## Import
+
+```ts
+import { GeoLoginComponent } from '@geoit/ui';
+```
+
+Add to the consuming standalone component:
+
+```ts
+imports: [GeoLoginComponent]
+```
+
+## Selector
+`geo-login`
+
+## 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 |
+|-------|------|---------|-------------|
+| `title` | `string` | `'Đăng nhập hệ thống'` | — |
+| `subtitle` | `string` | `'Cổng tra cứu thông tin đất đai'` | — |
+| `captchaHint` | `string` | `'Nhập mã kiểm tra hiển thị bên cạnh'` | — |
+| `loading` | `boolean` | `false` | — |
+| `errorMessage` | `string` | `''` | — |
+| `showForgotPassword` | `boolean` | `true` | — |
+| `username` | `string` | `''` | Two-way `model()` (supports banana binding). |
+| `password` | `string` | `''` | Two-way `model()` (supports banana binding). |
+| `captcha` | `string` | `''` | Two-way `model()` (supports banana binding). |
+| `remember` | `boolean` | `false` | Two-way `model()` (supports banana binding). |
+
+## Outputs
+
+| Output | Payload | Description |
+|--------|---------|-------------|
+| `submitLogin` | `OutputEmitterRef<GeoLoginPayload>` | — |
+| `forgotPassword` | `OutputEmitterRef<void>` | — |
+
+## Related types
+
+From `figma/geo-login/geo-login.types.ts`:
+
+```ts
+export interface GeoLoginPayload {
+  username: string;
+  password: string;
+  captcha: string;
+  remember: boolean;
+}
+```
+
+## Examples
+
+### Example
+
+```html
+<geo-login></geo-login>
+```
+
+## Package path
+`node_modules/@geoit/ui/ai/components/geo-login.md`
+
+## Source
+`projects/geo-ui/src/lib/figma/geo-login/geo-login.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

@@ -0,0 +1,80 @@
+# geo-map-admin-filter
+
+> Complete usage reference for **GeoMapAdminFilterComponent** (`@geoit/ui`)
+>
+> Read this file before using the component. Use **only** the Inputs/Outputs listed here.
+
+## Summary
+GeoMapAdminFilterComponent
+
+## Import
+
+```ts
+import { GeoMapAdminFilterComponent } from '@geoit/ui';
+```
+
+Add to the consuming standalone component:
+
+```ts
+imports: [GeoMapAdminFilterComponent]
+```
+
+## Selector
+`geo-map-admin-filter`
+
+## 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 |
+|-------|------|---------|-------------|
+| `open` | `boolean` | `false` | Two-way `model()` (supports banana binding). |
+| `title` | `string` | `'Đơn vị hành chính'` | — |
+| `nodes` | `GeoTreeNode[]` | `[]` | — |
+| `checkedKeys` | `Array<string \| number>` | `[]` | Two-way `model()` (supports banana binding). |
+| `expandedKeys` | `Array<string \| number>` | `[]` | Two-way `model()` (supports banana binding). |
+
+## Outputs
+
+| Output | Payload | Description |
+|--------|---------|-------------|
+| `apply` | `OutputEmitterRef<Array<string \| number>>` | — |
+| `reset` | `OutputEmitterRef<void>` | — |
+| `fitProvince` | `OutputEmitterRef<void>` | — |
+| `closed` | `OutputEmitterRef<void>` | — |
+| `selectionChange` | `OutputEmitterRef<Array<string \| number>>` | — |
+
+
+## Examples
+
+### Example
+
+```html
+<geo-map-admin-filter></geo-map-admin-filter>
+```
+
+## Package path
+`node_modules/@geoit/ui/ai/components/geo-map-admin-filter.md`
+
+## Source
+`projects/geo-ui/src/lib/figma/geo-map/chrome/geo-map-admin-filter/geo-map-admin-filter.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-basemap-switcher.md

@@ -0,0 +1,75 @@
+# geo-map-basemap-switcher
+
+> Complete usage reference for **GeoMapBasemapSwitcherComponent** (`@geoit/ui`)
+>
+> Read this file before using the component. Use **only** the Inputs/Outputs listed here.
+
+## Summary
+GeoMapBasemapSwitcherComponent
+
+## Import
+
+```ts
+import { GeoMapBasemapSwitcherComponent } from '@geoit/ui';
+```
+
+Add to the consuming standalone component:
+
+```ts
+imports: [GeoMapBasemapSwitcherComponent]
+```
+
+## Selector
+`geo-map-basemap-switcher`
+
+## 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 |
+|-------|------|---------|-------------|
+| `options` | `GeoMapBasemapOption[]` | `GEO_MAP_DEFAULT_BASEMAP_OPTIONS` | Exactly two options (street + satellite). Extra items are ignored. |
+| `selectedId` | `string` | `'osm'` | Two-way `model()` (supports banana binding). |
+| `label` | `string` | `'Lớp bản đồ'` | Caption on the thumbnail card (design: «Lớp bản đồ»). |
+| `tooltip` | `string` | `'Đổi lớp bản đồ nền'` | — |
+
+## Outputs
+
+| Output | Payload | Description |
+|--------|---------|-------------|
+| `basemapChange` | `OutputEmitterRef<GeoMapBasemap>` | — |
+
+
+## Examples
+
+### Example
+
+```html
+<geo-map-basemap-switcher></geo-map-basemap-switcher>
+```
+
+## Package path
+`node_modules/@geoit/ui/ai/components/geo-map-basemap-switcher.md`
+
+## Source
+`projects/geo-ui/src/lib/figma/geo-map/chrome/geo-map-basemap-switcher/geo-map-basemap-switcher.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-help.md

@@ -0,0 +1,72 @@
+# geo-map-help
+
+> Complete usage reference for **GeoMapHelpComponent** (`@geoit/ui`)
+>
+> Read this file before using the component. Use **only** the Inputs/Outputs listed here.
+
+## Summary
+GeoMapHelpComponent
+
+## Import
+
+```ts
+import { GeoMapHelpComponent } from '@geoit/ui';
+```
+
+Add to the consuming standalone component:
+
+```ts
+imports: [GeoMapHelpComponent]
+```
+
+## Selector
+`geo-map-help`
+
+## 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 |
+|-------|------|---------|-------------|
+| `open` | `boolean` | `false` | Two-way `model()` (supports banana binding). |
+| `title` | `string` | `'Hướng dẫn sử dụng'` | — |
+| `sections` | `GeoMapHelpSection[]` | `GEO_MAP_DEFAULT_HELP_SECTIONS` | — |
+
+## Outputs
+
+_None_
+
+
+## Examples
+
+### Example
+
+```html
+<geo-map-help></geo-map-help>
+```
+
+## Package path
+`node_modules/@geoit/ui/ai/components/geo-map-help.md`
+
+## Source
+`projects/geo-ui/src/lib/figma/geo-map/chrome/geo-map-help/geo-map-help.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-layer-card.md

@@ -0,0 +1,73 @@
+# geo-map-layer-card
+
+> Complete usage reference for **GeoMapLayerCardComponent** (`@geoit/ui`)
+>
+> Read this file before using the component. Use **only** the Inputs/Outputs listed here.
+
+## Summary
+GeoMapLayerCardComponent
+
+## Import
+
+```ts
+import { GeoMapLayerCardComponent } from '@geoit/ui';
+```
+
+Add to the consuming standalone component:
+
+```ts
+imports: [GeoMapLayerCardComponent]
+```
+
+## Selector
+`geo-map-layer-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 |
+|-------|------|---------|-------------|
+| `title` | `string` | `'Lớp bản đồ'` | — |
+| `previewUrl` | `string \| undefined` | `undefined` | — |
+
+## Outputs
+
+| Output | Payload | Description |
+|--------|---------|-------------|
+| `clicked` | `OutputEmitterRef<void>` | — |
+
+
+## Examples
+
+### Example
+
+```html
+<geo-map-layer-card></geo-map-layer-card>
+```
+
+## Package path
+`node_modules/@geoit/ui/ai/components/geo-map-layer-card.md`
+
+## Source
+`projects/geo-ui/src/lib/figma/geo-map/chrome/geo-map-layer-card/geo-map-layer-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-map-layer-panel.md

@@ -0,0 +1,75 @@
+# geo-map-layer-panel
+
+> Complete usage reference for **GeoMapLayerPanelComponent** (`@geoit/ui`)
+>
+> Read this file before using the component. Use **only** the Inputs/Outputs listed here.
+
+## Summary
+GeoMapLayerPanelComponent
+
+## Import
+
+```ts
+import { GeoMapLayerPanelComponent } from '@geoit/ui';
+```
+
+Add to the consuming standalone component:
+
+```ts
+imports: [GeoMapLayerPanelComponent]
+```
+
+## Selector
+`geo-map-layer-panel`
+
+## 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 |
+|-------|------|---------|-------------|
+| `controller` | `GeoMapController \| null` | `null` | — |
+| `title` | `string` | `'Lớp bản đồ'` | — |
+| `embedded` | `boolean` | `false` | When true, hide the panel's own header (host popover provides title). |
+| `layers` | `GeoMapLayerConfig[]` | `[]` | Two-way `model()` (supports banana binding). |
+
+## Outputs
+
+| Output | Payload | Description |
+|--------|---------|-------------|
+| `layersChange` | `OutputEmitterRef<GeoMapLayerConfig[]>` | — |
+
+
+## Examples
+
+### Example
+
+```html
+<geo-map-layer-panel></geo-map-layer-panel>
+```
+
+## Package path
+`node_modules/@geoit/ui/ai/components/geo-map-layer-panel.md`
+
+## Source
+`projects/geo-ui/src/lib/figma/geo-map/chrome/geo-map-layer-panel/geo-map-layer-panel.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-layers-drawer.md

@@ -0,0 +1,78 @@
+# geo-map-layers-drawer
+
+> Complete usage reference for **GeoMapLayersDrawerComponent** (`@geoit/ui`)
+>
+> Read this file before using the component. Use **only** the Inputs/Outputs listed here.
+
+## Summary
+GeoMapLayersDrawerComponent
+
+## Import
+
+```ts
+import { GeoMapLayersDrawerComponent } from '@geoit/ui';
+```
+
+Add to the consuming standalone component:
+
+```ts
+imports: [GeoMapLayersDrawerComponent]
+```
+
+## Selector
+`geo-map-layers-drawer`
+
+## 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 |
+|-------|------|---------|-------------|
+| `controller` | `GeoMapController \| null` | `null` | — |
+| `open` | `boolean` | `false` | Two-way `model()` (supports banana binding). |
+| `title` | `string` | `'Lớp bản đồ'` | — |
+| `legendItems` | `GeoMapLegendItem[]` | `[]` | — |
+| `showOpacity` | `boolean` | `false` | Kept for API compat — opacity is per-layer in the new panel. |
+| `showLegend` | `boolean` | `false` | Kept for API compat — legend lives outside this popover. |
+| `layers` | `GeoMapLayerConfig[]` | `[]` | Two-way `model()` (supports banana binding). |
+
+## Outputs
+
+| Output | Payload | Description |
+|--------|---------|-------------|
+| `closed` | `OutputEmitterRef<void>` | — |
+
+
+## Examples
+
+### Example
+
+```html
+<geo-map-layers-drawer></geo-map-layers-drawer>
+```
+
+## Package path
+`node_modules/@geoit/ui/ai/components/geo-map-layers-drawer.md`
+
+## Source
+`projects/geo-ui/src/lib/figma/geo-map/chrome/geo-map-layers-drawer/geo-map-layers-drawer.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-legend.md

@@ -0,0 +1,74 @@
+# geo-map-legend
+
+> Complete usage reference for **GeoMapLegendComponent** (`@geoit/ui`)
+>
+> Read this file before using the component. Use **only** the Inputs/Outputs listed here.
+
+## Summary
+GeoMapLegendComponent
+
+## Import
+
+```ts
+import { GeoMapLegendComponent } from '@geoit/ui';
+```
+
+Add to the consuming standalone component:
+
+```ts
+imports: [GeoMapLegendComponent]
+```
+
+## Selector
+`geo-map-legend`
+
+## 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 |
+|-------|------|---------|-------------|
+| `title` | `string` | `'Chú giải'` | — |
+| `items` | `GeoMapLegendItem[]` | `[]` | — |
+| `open` | `boolean` | `false` | Two-way `model()` (supports banana binding). |
+
+## Outputs
+
+| Output | Payload | Description |
+|--------|---------|-------------|
+| `closed` | `OutputEmitterRef<void>` | — |
+
+
+## Examples
+
+### Example
+
+```html
+<geo-map-legend></geo-map-legend>
+```
+
+## Package path
+`node_modules/@geoit/ui/ai/components/geo-map-legend.md`
+
+## Source
+`projects/geo-ui/src/lib/figma/geo-map/chrome/geo-map-legend/geo-map-legend.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.