@geoit/ui 0.0.2 → 0.0.5

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.

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

@@ -0,0 +1,75 @@
+# geo-map-locate
+
+> Complete usage reference for **GeoMapLocateComponent** (`@geoit/ui`)
+>
+> Read this file before using the component. Use **only** the Inputs/Outputs listed here.
+
+## Summary
+GeoMapLocateComponent
+
+## Import
+
+```ts
+import { GeoMapLocateComponent } from '@geoit/ui';
+```
+
+Add to the consuming standalone component:
+
+```ts
+imports: [GeoMapLocateComponent]
+```
+
+## Selector
+`geo-map-locate`
+
+## 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` | `'Vị trí của tôi'` | — |
+
+## Outputs
+
+| Output | Payload | Description |
+|--------|---------|-------------|
+| `located` | `OutputEmitterRef<[number, number]>` | — |
+| `denied` | `OutputEmitterRef<void>` | — |
+| `locateError` | `OutputEmitterRef<{ reason: GeoMapLocateErrorReason; message?: string; }>` | — |
+
+
+## Examples
+
+### Example
+
+```html
+<geo-map-locate></geo-map-locate>
+```
+
+## Package path
+`node_modules/@geoit/ui/ai/components/geo-map-locate.md`
+
+## Source
+`projects/geo-ui/src/lib/figma/geo-map/chrome/geo-map-locate/geo-map-locate.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-location-chip.md

@@ -0,0 +1,71 @@
+# geo-map-location-chip
+
+> Complete usage reference for **GeoMapLocationChipComponent** (`@geoit/ui`)
+>
+> Read this file before using the component. Use **only** the Inputs/Outputs listed here.
+
+## Summary
+GeoMapLocationChipComponent
+
+## Import
+
+```ts
+import { GeoMapLocationChipComponent } from '@geoit/ui';
+```
+
+Add to the consuming standalone component:
+
+```ts
+imports: [GeoMapLocationChipComponent]
+```
+
+## Selector
+`geo-map-location-chip`
+
+## 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` | `''` | — |
+| `icon` | `string` | `'environment'` | — |
+
+## Outputs
+
+_None_
+
+
+## Examples
+
+### Example
+
+```html
+<geo-map-location-chip></geo-map-location-chip>
+```
+
+## Package path
+`node_modules/@geoit/ui/ai/components/geo-map-location-chip.md`
+
+## Source
+`projects/geo-ui/src/lib/figma/geo-map/chrome/geo-map-location-chip/geo-map-location-chip.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-measure.md

@@ -0,0 +1,74 @@
+# geo-map-measure
+
+> Complete usage reference for **GeoMapMeasureComponent** (`@geoit/ui`)
+>
+> Read this file before using the component. Use **only** the Inputs/Outputs listed here.
+
+## Summary
+GeoMapMeasureComponent
+
+## Import
+
+```ts
+import { GeoMapMeasureComponent } from '@geoit/ui';
+```
+
+Add to the consuming standalone component:
+
+```ts
+imports: [GeoMapMeasureComponent]
+```
+
+## Selector
+`geo-map-measure`
+
+## 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` | — |
+| `mode` | `GeoMapMeasureMode` | `'none'` | Two-way `model()` (supports banana binding). |
+| `showResult` | `boolean` | `true` | — |
+
+## Outputs
+
+| Output | Payload | Description |
+|--------|---------|-------------|
+| `measureChange` | `OutputEmitterRef<GeoMapMeasureResult \| null>` | — |
+
+
+## Examples
+
+### Example
+
+```html
+<geo-map-measure></geo-map-measure>
+```
+
+## Package path
+`node_modules/@geoit/ui/ai/components/geo-map-measure.md`
+
+## Source
+`projects/geo-ui/src/lib/figma/geo-map/chrome/geo-map-measure/geo-map-measure.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-opacity.md

@@ -0,0 +1,75 @@
+# geo-map-opacity
+
+> Complete usage reference for **GeoMapOpacityComponent** (`@geoit/ui`)
+>
+> Read this file before using the component. Use **only** the Inputs/Outputs listed here.
+
+## Summary
+GeoMapOpacityComponent
+
+## Import
+
+```ts
+import { GeoMapOpacityComponent } from '@geoit/ui';
+```
+
+Add to the consuming standalone component:
+
+```ts
+imports: [GeoMapOpacityComponent]
+```
+
+## Selector
+`geo-map-opacity`
+
+## 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` | `'Độ trong suốt'` | — |
+| `layerId` | `string \| null` | `null` | Two-way `model()` (supports banana binding). |
+| `opacity` | `number` | `100` | Opacity percent 0–100. — Two-way `model()` (supports banana binding). |
+| `variant` | `'panel' \| 'compact'` | `'panel'` | — |
+| `applyToFirstLayer` | `boolean` | `true` | When compact and no layerId, apply to first non-basemap overlay. |
+
+## Outputs
+
+_None_
+
+
+## Examples
+
+### Example
+
+```html
+<geo-map-opacity></geo-map-opacity>
+```
+
+## Package path
+`node_modules/@geoit/ui/ai/components/geo-map-opacity.md`
+
+## Source
+`projects/geo-ui/src/lib/figma/geo-map/chrome/geo-map-opacity/geo-map-opacity.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.