@geoit/ui 0.0.2 → 0.0.5

package/ai/components/geo-map-parcel-popup.md

@@ -0,0 +1,79 @@
+# geo-map-parcel-popup
+
+> Complete usage reference for **GeoMapParcelPopupComponent** (`@geoit/ui`)
+>
+> Read this file before using the component. Use **only** the Inputs/Outputs listed here.
+
+## Summary
+GeoMapParcelPopupComponent
+
+## Import
+
+```ts
+import { GeoMapParcelPopupComponent } from '@geoit/ui';
+```
+
+Add to the consuming standalone component:
+
+```ts
+imports: [GeoMapParcelPopupComponent]
+```
+
+## Selector
+`geo-map-parcel-popup`
+
+## 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` | `'Thông tin thửa đất'` | — |
+| `parcel` | `GeoMapParcelDetail \| null` | `null` | — |
+| `audience` | `GeoMapParcelAudience` | `'citizen'` | — |
+| `showExport` | `boolean` | `false` | Giữ tương thích API cũ; footer xuất file không còn trong layout thiết kế. |
+
+## Outputs
+
+| Output | Payload | Description |
+|--------|---------|-------------|
+| `closed` | `OutputEmitterRef<void>` | — |
+| `back` | `OutputEmitterRef<void>` | — |
+| `exportClick` | `OutputEmitterRef<GeoMapParcelDetail>` | — |
+| `diagramClick` | `OutputEmitterRef<GeoMapParcelDetail>` | — |
+
+
+## Examples
+
+### Example
+
+```html
+<geo-map-parcel-popup></geo-map-parcel-popup>
+```
+
+## Package path
+`node_modules/@geoit/ui/ai/components/geo-map-parcel-popup.md`
+
+## Source
+`projects/geo-ui/src/lib/figma/geo-map/chrome/geo-map-parcel-popup/geo-map-parcel-popup.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-search.md

@@ -0,0 +1,83 @@
+# geo-map-search
+
+> Complete usage reference for **GeoMapSearchComponent** (`@geoit/ui`)
+>
+> Read this file before using the component. Use **only** the Inputs/Outputs listed here.
+
+## Summary
+GeoMapSearchComponent
+
+## Import
+
+```ts
+import { GeoMapSearchComponent } from '@geoit/ui';
+```
+
+Add to the consuming standalone component:
+
+```ts
+imports: [GeoMapSearchComponent]
+```
+
+## Selector
+`geo-map-search`
+
+## 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` | `'Tra cứu thông tin quy hoạch theo'` | — |
+| `mode` | `GeoMapSearchMode` | `'parcel'` | Two-way `model()` (supports banana binding). |
+| `results` | `GeoMapSearchResultItem[]` | `[]` | — |
+| `loading` | `boolean` | `false` | — |
+| `pageIndex` | `number` | `1` | Two-way `model()` (supports banana binding). |
+| `pageSize` | `number` | `5` | Two-way `model()` (supports banana binding). |
+| `total` | `number` | `0` | — |
+| `emptyText` | `string` | `'Chưa có kết quả tra cứu.'` | — |
+
+## Outputs
+
+| Output | Payload | Description |
+|--------|---------|-------------|
+| `search` | `OutputEmitterRef<GeoMapSearchQuery>` | — |
+| `reset` | `OutputEmitterRef<void>` | — |
+| `resultSelect` | `OutputEmitterRef<GeoMapSearchResultItem>` | — |
+| `closed` | `OutputEmitterRef<void>` | — |
+
+
+## Examples
+
+### Example
+
+```html
+<geo-map-search></geo-map-search>
+```
+
+## Package path
+`node_modules/@geoit/ui/ai/components/geo-map-search.md`
+
+## Source
+`projects/geo-ui/src/lib/figma/geo-map/chrome/geo-map-search/geo-map-search.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-shell.md

@@ -0,0 +1,110 @@
+# geo-map-shell
+
+> Complete usage reference for **GeoMapShellComponent** (`@geoit/ui`)
+>
+> Read this file before using the component. Use **only** the Inputs/Outputs listed here.
+
+## Summary
+GeoMapShellComponent
+
+## Import
+
+```ts
+import { GeoMapShellComponent } from '@geoit/ui';
+```
+
+Add to the consuming standalone component:
+
+```ts
+imports: [GeoMapShellComponent]
+```
+
+## Selector
+`geo-map-shell`
+
+## 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 |
+|-------|------|---------|-------------|
+| `center` | `number[]` | `[...GEO_MAP_DEFAULT_CENTER]` | — |
+| `zoom` | — | `GEO_MAP_DEFAULT_ZOOM` | — |
+| `height` | `string` | `'560px'` | — |
+| `showMousePosition` | `boolean` | `false` | — |
+| `basemapOptions` | `GeoMapBasemapOption[]` | `GEO_MAP_DEFAULT_BASEMAP_OPTIONS` | — |
+| `toolbarActions` | `GeoMapToolbarAction[]` | `GEO_MAP_DEFAULT_TOOLBAR_ACTIONS` | — |
+| `layers` | `GeoMapLayerConfig[]` | `[]` | Extra overlays merged after demo thematic + traffic. |
+| `legendItems` | `GeoMapLegendItem[]` | `GEO_MAP_DEMO_LEGEND_ITEMS` | — |
+| `showNav` | `boolean` | `true` | — |
+| `includeDemoLayers` | `boolean` | `true` | — |
+| `adminNodes` | `GeoTreeNode[]` | `GEO_MAP_DEMO_ADMIN_NODES` | — |
+| `locationLabel` | `string` | `'Phường 1 — TP Đà Lạt, Lâm Đồng'` | — |
+| `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). |
+| `homeMode` | `'location' \| 'emit'` | `'location'` | `location` — Home opens ĐVHC filter (default). `emit` — Home only emits `actionClick` (e.g. portal navigates to login/dashboard). |
+| `basemapId` | `string` | `'osm'` | Two-way `model()` (supports banana binding). |
+| `measureMode` | `GeoMapMeasureMode` | `'none'` | Two-way `model()` (supports banana binding). |
+| `checkedMap` | `Record<string, boolean>` | — | Two-way `model()` (supports banana binding). |
+| `layersOpen` | `boolean` | `false` | Two-way `model()` (supports banana binding). |
+| `legendOpen` | `boolean` | `false` | Two-way `model()` (supports banana binding). |
+| `helpOpen` | `boolean` | `false` | Two-way `model()` (supports banana binding). |
+| `swipeActive` | `boolean` | `false` | Two-way `model()` (supports banana binding). |
+| `searchOpen` | `boolean` | `false` | Two-way `model()` (supports banana binding). |
+| `adminFilterOpen` | `boolean` | `false` | Two-way `model()` (supports banana binding). |
+| `parcelOpen` | `boolean` | `false` | Two-way `model()` (supports banana binding). |
+| `managedLayers` | `GeoMapLayerConfig[]` | `[]` | Two-way `model()` (supports banana binding). |
+| `searchResults` | `GeoMapSearchResultItem[]` | `[]` | Two-way `model()` (supports banana binding). |
+| `selectedParcel` | `GeoMapParcelDetail \| null` | `null` | Two-way `model()` (supports banana binding). |
+| `adminCheckedKeys` | `Array<string \| number>` | `[]` | Two-way `model()` (supports banana binding). |
+| `adminExpandedKeys` | `Array<string \| number>` | `['lam-dong']` | Two-way `model()` (supports banana binding). |
+
+## Outputs
+
+| Output | Payload | Description |
+|--------|---------|-------------|
+| `mapReady` | `OutputEmitterRef<GeoMapController>` | — |
+| `mapClick` | `OutputEmitterRef<GeoMapClickEvent>` | — |
+| `locateDenied` | `OutputEmitterRef<void>` | — |
+| `actionClick` | `OutputEmitterRef<GeoMapToolbarAction>` | — |
+| `search` | `OutputEmitterRef<GeoMapSearchQuery>` | — |
+| `searchReset` | `OutputEmitterRef<void>` | — |
+| `resultSelect` | `OutputEmitterRef<GeoMapSearchResultItem>` | — |
+| `parcelExport` | `OutputEmitterRef<GeoMapParcelDetail>` | — |
+| `adminApply` | `OutputEmitterRef<Array<string \| number>>` | — |
+
+
+## Examples
+
+### Example
+
+```html
+<geo-map-shell></geo-map-shell>
+```
+
+## Package path
+`node_modules/@geoit/ui/ai/components/geo-map-shell.md`
+
+## Source
+`projects/geo-ui/src/lib/figma/geo-map/chrome/geo-map-shell/geo-map-shell.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-snapshot.md

@@ -0,0 +1,75 @@
+# geo-map-snapshot
+
+> Complete usage reference for **GeoMapSnapshotComponent** (`@geoit/ui`)
+>
+> Read this file before using the component. Use **only** the Inputs/Outputs listed here.
+
+## Summary
+GeoMapSnapshotComponent
+
+## Import
+
+```ts
+import { GeoMapSnapshotComponent } from '@geoit/ui';
+```
+
+Add to the consuming standalone component:
+
+```ts
+imports: [GeoMapSnapshotComponent]
+```
+
+## Selector
+`geo-map-snapshot`
+
+## 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` | — |
+| `label` | `string` | `'Chụp ảnh bản đồ'` | — |
+| `filename` | `string` | `'ban-do.png'` | — |
+
+## Outputs
+
+| Output | Payload | Description |
+|--------|---------|-------------|
+| `captured` | `OutputEmitterRef<void>` | — |
+| `captureError` | `OutputEmitterRef<unknown>` | — |
+
+
+## Examples
+
+### Example
+
+```html
+<geo-map-snapshot></geo-map-snapshot>
+```
+
+## Package path
+`node_modules/@geoit/ui/ai/components/geo-map-snapshot.md`
+
+## Source
+`projects/geo-ui/src/lib/figma/geo-map/chrome/geo-map-snapshot/geo-map-snapshot.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-swipe.md

@@ -0,0 +1,73 @@
+# geo-map-swipe
+
+> Complete usage reference for **GeoMapSwipeComponent** (`@geoit/ui`)
+>
+> Read this file before using the component. Use **only** the Inputs/Outputs listed here.
+
+## Summary
+GeoMapSwipeComponent
+
+## Import
+
+```ts
+import { GeoMapSwipeComponent } from '@geoit/ui';
+```
+
+Add to the consuming standalone component:
+
+```ts
+imports: [GeoMapSwipeComponent]
+```
+
+## Selector
+`geo-map-swipe`
+
+## 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` | — |
+| `active` | `boolean` | `false` | When true, swipe mode is on. — Two-way `model()` (supports banana binding). |
+| `position` | `number` | `50` | 0–100, left portion shows clipped overlay. — Two-way `model()` (supports banana binding). |
+| `layerId` | `string \| null` | `null` | Optional explicit overlay layer id; defaults to top visible non-basemap. |
+
+## Outputs
+
+_None_
+
+
+## Examples
+
+### Example
+
+```html
+<geo-map-swipe></geo-map-swipe>
+```
+
+## Package path
+`node_modules/@geoit/ui/ai/components/geo-map-swipe.md`
+
+## Source
+`projects/geo-ui/src/lib/figma/geo-map/chrome/geo-map-swipe/geo-map-swipe.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-toolbar.md

@@ -0,0 +1,76 @@
+# geo-map-toolbar
+
+> Complete usage reference for **GeoMapToolbarComponent** (`@geoit/ui`)
+>
+> Read this file before using the component. Use **only** the Inputs/Outputs listed here.
+
+## Summary
+GeoMapToolbarComponent
+
+## Import
+
+```ts
+import { GeoMapToolbarComponent } from '@geoit/ui';
+```
+
+Add to the consuming standalone component:
+
+```ts
+imports: [GeoMapToolbarComponent]
+```
+
+## Selector
+`geo-map-toolbar`
+
+## 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` | — |
+| `actions` | `GeoMapToolbarAction[]` | `[]` | When empty, uses built-in portal action set. |
+| `compact` | `boolean` | `false` | — |
+| `checkedMap` | `Record<string, boolean>` | — | Two-way checked map keyed by action id (for checkbox-style actions). — Two-way `model()` (supports banana binding). |
+
+## Outputs
+
+| Output | Payload | Description |
+|--------|---------|-------------|
+| `actionClick` | `OutputEmitterRef<GeoMapToolbarAction>` | — |
+| `actionToggle` | `OutputEmitterRef<{ action: GeoMapToolbarAction; checked: boolean; }>` | — |
+
+
+## Examples
+
+### Example
+
+```html
+<geo-map-toolbar></geo-map-toolbar>
+```
+
+## Package path
+`node_modules/@geoit/ui/ai/components/geo-map-toolbar.md`
+
+## Source
+`projects/geo-ui/src/lib/figma/geo-map/chrome/geo-map-toolbar/geo-map-toolbar.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-zoom.md

@@ -0,0 +1,74 @@
+# geo-map-zoom
+
+> Complete usage reference for **GeoMapZoomComponent** (`@geoit/ui`)
+>
+> Read this file before using the component. Use **only** the Inputs/Outputs listed here.
+
+## Summary
+GeoMapZoomComponent
+
+## Import
+
+```ts
+import { GeoMapZoomComponent } from '@geoit/ui';
+```
+
+Add to the consuming standalone component:
+
+```ts
+imports: [GeoMapZoomComponent]
+```
+
+## Selector
+`geo-map-zoom`
+
+## 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` | — |
+| `showNav` | `boolean` | `true` | Show prev / next zoom + fullscreen + box zoom (UC-15). |
+| `showFitProvince` | `boolean` | `true` | Show “xem toàn tỉnh” (TCQH.14 GD5) — fit province extent, not fullscreen. |
+| `provinceExtent` | `readonly [number, number, number, number] \| null` | `null` | Province extent in EPSG:4326. Defaults to Lâm Đồng placeholder when omitted. |
+| `fullscreenTarget` | `HTMLElement \| null` | `null` | Element to put in Fullscreen API. Defaults to closest `.geo-map-shell`, then the OL map target. |
+
+## Outputs
+
+_None_
+
+
+## Examples
+
+### Example
+
+```html
+<geo-map-zoom></geo-map-zoom>
+```
+
+## Package path
+`node_modules/@geoit/ui/ai/components/geo-map-zoom.md`
+
+## Source
+`projects/geo-ui/src/lib/figma/geo-map/chrome/geo-map-zoom/geo-map-zoom.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.