@geoit/ui 0.0.2

package/AGENTS.md

@@ -0,0 +1,25 @@
+# GEO UI — Agent instructions (root)
+
+Package name: **`@geoit/ui`**
+
+Canonical AI docs live under **`ai/`**:
+
+| File | Purpose |
+|------|---------|
+| [`ai/AGENTS.md`](./ai/AGENTS.md) | Rules for agents |
+| [`ai/catalog.json`](./ai/catalog.json) | Machine-readable component catalog |
+| [`ai/components/`](./ai/components/) | One markdown file per `geo-*` component |
+| [`ai/recipes.md`](./ai/recipes.md) | Copy-paste UI recipes |
+| [`ai/README.md`](./ai/README.md) | Index |
+
+Regenerate component docs + catalog:
+
+```bash
+npm run ai:docs
+```
+
+Install in other projects:
+
+```bash
+npm install @geoit/ui
+```

package/README.md

@@ -0,0 +1,46 @@
+# geo-ui (@geoit/ui)
+
+Angular 18 + ng-zorro GEO design system.
+
+## Install
+
+```bash
+npm install @geoit/ui
+```
+
+## Styles (app once)
+
+```scss
+@import 'node_modules/@geoit/ui/src/lib/styles/design-tokens.scss';
+@import 'node_modules/@geoit/ui/src/lib/styles/theme.scss';
+```
+
+## AI / agent docs (shipped with this package)
+
+After install, docs live in `node_modules/@geoit/ui/ai/`:
+
+| Path | Purpose |
+|------|---------|
+| `node_modules/@geoit/ui/AGENTS.md` | Pointer + rules |
+| `node_modules/@geoit/ui/ai/AGENTS.md` | Full agent rules |
+| `node_modules/@geoit/ui/ai/catalog.json` | Machine-readable catalog |
+| `node_modules/@geoit/ui/ai/components/*.md` | Per-component docs |
+| `node_modules/@geoit/ui/ai/recipes.md` | Copy-paste recipes |
+
+### Consumer Cursor rule (recommended)
+
+Create `.cursor/rules/geo-ui.mdc` in your app:
+
+```md
+---
+description: Use @geoit/ui components
+alwaysApply: true
+---
+
+UI must use `@geoit/ui`. Before writing UI, read:
+- node_modules/@geoit/ui/ai/AGENTS.md
+- node_modules/@geoit/ui/ai/catalog.json
+- node_modules/@geoit/ui/ai/components/<selector>.md when needed
+```
+
+Or `@`-mention `node_modules/@geoit/ui/ai/catalog.json` in chat.

package/ai/AGENTS.md

@@ -0,0 +1,86 @@
+# GEO UI — Agent instructions
+
+Instructions for AI coding agents (Cursor, Copilot, etc.) when building UI with **geo-ui**.
+
+## Mandatory
+
+1. **Use `geo-*` components** from package `@geoit/ui` for all UI that has a match in the catalog.
+2. **Do not** invent parallel wrappers or raw `nz-button` / `nz-input` / `nz-modal` when a `geo-*` equivalent exists.
+3. **Do not hardcode** brand colors or border-radius. Use tokens:
+   - Colors: `var(--geo-color-*)` or `geoColorTokens` from `@geoit/ui`
+   - Radius: `var(--geo-radius)` (default **6px**)
+4. Before implementing a component, **read** `ai/components/<selector>.md` and/or `ai/catalog.json`.
+5. Prefer **copying examples** from those docs / Storybook over inventing new APIs.
+
+## Import pattern
+
+```ts
+import {
+  GeoButtonComponent,
+  GeoInputComponent,
+  GeoFormModalComponent,
+  GeoStepperComponent,
+} from '@geoit/ui';
+```
+
+Standalone consumers:
+
+```ts
+@Component({
+  standalone: true,
+  imports: [GeoButtonComponent, GeoInputComponent, FormsModule],
+})
+```
+
+## Styles (app once)
+
+```scss
+@import 'node_modules/@geoit/ui/src/lib/styles/design-tokens.scss';
+@import 'node_modules/@geoit/ui/src/lib/styles/theme.scss';
+```
+
+## Composition recipes
+
+See [`recipes.md`](./recipes.md) for:
+
+- Form modal + steps
+- Page: breadcrumb + page title
+- Table + toolbar + filter
+- Toast via service
+
+## Decision cheat-sheet
+
+| Need | Use |
+|------|-----|
+| CTA / actions | `geo-button` |
+| Text field | `geo-input` / `geo-textarea` |
+| Select | `geo-select` |
+| Exclusive options | `geo-radio` |
+| Checkbox | `geo-checkbox` |
+| Dialog form | `geo-form-modal` |
+| Confirm delete | `geo-confirm-modal` |
+| Multi-step in dialog | `geo-form-modal` + `geo-stepper` |
+| Multi-step full page | `geo-step-form-layout` |
+| Page heading | `geo-page-title` (+ `geo-breadcrumb`) |
+| Status pill | `geo-status-tag` |
+| Transient notice | `GeoToastService` / `geo-toast` |
+| Inline notice | `geo-alert` |
+| Upload drag-drop | `geo-upload` |
+| Compact file field | `geo-file-picker` |
+| Data grid | `geo-table` (+ toolbar/filter) |
+| Typography | `geo-typography` |
+
+## Anti-patterns
+
+- Hardcoded `#9A4828`, `border-radius: 8px`, etc.
+- Custom modal markup instead of `geo-form-modal`
+- Using Ant Design Steps instead of `geo-stepper`
+- Mixing Inter/system fonts inconsistently — use `--geo-font-family`
+
+## Catalog
+
+- Index: [`README.md`](./README.md)
+- Machine catalog: [`catalog.json`](./catalog.json)
+- Per component: [`components/`](./components/)
+
+Regenerate docs: `npm run ai:docs`

package/ai/README.md

@@ -0,0 +1,44 @@
+# GEO UI — AI component index
+
+Machine-readable catalog: [`catalog.json`](./catalog.json)
+
+Agent rules: [`AGENTS.md`](./AGENTS.md) · Recipes: [`recipes.md`](./recipes.md)
+
+| Selector | Category | Summary | Doc |
+|----------|----------|---------|-----|
+| `geo-alert` | feedback | Inline alert banner (success/error/warning/info). | [geo-alert.md](./components/geo-alert.md) |
+| `geo-back-button` | navigation | Back navigation control (history or custom click). | [geo-back-button.md](./components/geo-back-button.md) |
+| `geo-breadcrumb` | navigation | Breadcrumb trail; last item active (primary). | [geo-breadcrumb.md](./components/geo-breadcrumb.md) |
+| `geo-button` | actions | Primary action button with brand/semantic colors and icons. | [geo-button.md](./components/geo-button.md) |
+| `geo-checkbox` | forms | Checkbox with label; supports CVA / ngModel. | [geo-checkbox.md](./components/geo-checkbox.md) |
+| `geo-column-picker` | data | Column visibility picker for tables (optional persistence). | [geo-column-picker.md](./components/geo-column-picker.md) |
+| `geo-confirm-modal` | overlay | Confirm / danger dialog (destroy actions). | [geo-confirm-modal.md](./components/geo-confirm-modal.md) |
+| `geo-date-picker` | forms | Single date (optional time) picker. | [geo-date-picker.md](./components/geo-date-picker.md) |
+| `geo-date-range-picker` | forms | Start–end date range picker. | [geo-date-range-picker.md](./components/geo-date-range-picker.md) |
+| `geo-file-picker` | forms | Compact file input for forms (button + filename). | [geo-file-picker.md](./components/geo-file-picker.md) |
+| `geo-form-modal` | overlay | Form modal: fixed header/footer, scrollable body via ng-content. | [geo-form-modal.md](./components/geo-form-modal.md) |
+| `geo-icon` | display | Ant Design icon wrapper with GEO size/color tokens. | [geo-icon.md](./components/geo-icon.md) |
+| `geo-input` | forms | Text input with label, validation, icons; CVA/ngModel. | [geo-input.md](./components/geo-input.md) |
+| `geo-page-title` | display | Page title (uppercase) with short primary accent underline; uses geo-typography. | [geo-page-title.md](./components/geo-page-title.md) |
+| `geo-pagination` | navigation | Standalone pagination control. | [geo-pagination.md](./components/geo-pagination.md) |
+| `geo-radio` | forms | Radio group (horizontal/vertical or button style). | [geo-radio.md](./components/geo-radio.md) |
+| `geo-row-actions` | data | Row action icons/menu (edit, more, custom). | [geo-row-actions.md](./components/geo-row-actions.md) |
+| `geo-select` | forms | Select / multi-select dropdown. | [geo-select.md](./components/geo-select.md) |
+| `geo-slider` | forms | Numeric range slider. | [geo-slider.md](./components/geo-slider.md) |
+| `geo-status-tag` | display | Pill status tag with optional dot (success/error/warning/info/teal/…). | [geo-status-tag.md](./components/geo-status-tag.md) |
+| `geo-step-form-layout` | layout | Full-page multi-step form: vertical stepper + content card + footer actions. | [geo-step-form-layout.md](./components/geo-step-form-layout.md) |
+| `geo-stepper` | navigation | Steps indicator (horizontal default). Active=primary, completed=success+check. | [geo-stepper.md](./components/geo-stepper.md) |
+| `geo-table` | data | Data table with pagination, selection, row actions, mobile card mode. | [geo-table.md](./components/geo-table.md) |
+| `geo-table-filter` | data | Table filter bar with search + advanced filters. | [geo-table-filter.md](./components/geo-table-filter.md) |
+| `geo-table-pagination` | data | Table-specific pagination footer (range label + size). | [geo-table-pagination.md](./components/geo-table-pagination.md) |
+| `geo-table-toolbar` | data | Table toolbar: result count, delete/export/add, column toggle. | [geo-table-toolbar.md](./components/geo-table-toolbar.md) |
+| `geo-tabs` | navigation | Tab set with brand ink bar; content via ng-template uiTab. | [geo-tabs.md](./components/geo-tabs.md) |
+| `geo-textarea` | forms | Multi-line text field with label/validation. | [geo-textarea.md](./components/geo-textarea.md) |
+| `geo-toast` | feedback | Toast UI; prefer GeoToastService for app-wide notifications. | [geo-toast.md](./components/geo-toast.md) |
+| `geo-tree` | data | Tree view with checkable / expandable nodes. | [geo-tree.md](./components/geo-tree.md) |
+| `geo-typography` | display | Text with GEO type scale (h1–tiny) and semantic colors. | [geo-typography.md](./components/geo-typography.md) |
+| `geo-upload` | forms | Drag-drop upload zone with progress list. | [geo-upload.md](./components/geo-upload.md) |
+
+Generated: 2026-07-27T01:27:04.549Z
+
+Regenerate: `npm run ai:docs`