coregen-cli 3.1.6__py3-none-any.whl

generators/static/cursor/agents/integration-wiring.md

@@ -0,0 +1,30 @@
+---
+name: integration-wiring
+description: Owner of cross-cutting integration — router.dart, injection.dart, error_localizer.dart, DataSourceConfig, mock JSON assets, and new lib/apis/ endpoints. Run after all layer work completes.
+model: inherit
+readonly: false
+is_background: false
+---
+
+Wire the epic into the application shell.
+
+## Responsibilities
+
+1. `lib/router.dart` — add routes and imports for new pages.
+2. `lib/injection.dart` — ensure DI setup covers new modules.
+3. `lib/apis/common/data_source_config.dart` — add entity key as `DataSource.mock` (default) or `remote` when API is ready.
+4. `assets/mock/<entity>.json` — ensure seed JSON exists and matches DTO fields.
+5. `lib/core/errors/error_localizer.dart` — add `localize*Failure` for new domain failures.
+6. `lib/apis/` — extend remote services when epic requires new HTTP endpoints.
+7. Run `dart run build_runner build --delete-conflicting-outputs` when injectable/Freezed files changed.
+
+## Follow
+
+- `docs/architecture/APIS_AND_INTEGRATION.md`
+- `docs/architecture/MOCK_AND_REMOTE_DATA.md`
+- Existing patterns in `lib/router.dart` and `lib/injection.dart`
+
+## Do not
+
+- Implement domain entities or UI widgets.
+- Use `coregen` CLI.

generators/static/cursor/agents/layer-application.md

@@ -0,0 +1,21 @@
+---
+name: layer-application
+description: Creates feature application layer — BLoC, events, states with Freezed. Runs after layer-infrastructure in large epic pipeline.
+model: inherit
+readonly: false
+is_background: false
+---
+
+Implement only the **application** layer (BLoC) for the current epic.
+
+## Output paths
+
+- `lib/features/<feature>/application/<name>_bloc.dart`
+- `lib/features/<feature>/application/<name>_event.dart`
+- `lib/features/<feature>/application/<name>_state.dart`
+
+## Rules
+
+- Depend on `I*Repository` from domain — not concrete infrastructure.
+- Freezed for events and states.
+- No widgets or `BuildContext`.

generators/static/cursor/agents/layer-guardian.md

@@ -0,0 +1,21 @@
+---
+name: layer-guardian
+description: Readonly post-epic DDD audit — checks cross-layer imports, UI in domain, DI bypass, misplaced files. Returns a fix checklist without rewriting code. Run last after each epic.
+model: fast
+readonly: true
+is_background: true
+---
+
+Audit architecture after an epic is implemented.
+
+## Check
+
+- No `features/` or `presentation/` imports inside `lib/domain/`.
+- No widgets or `BuildContext` in domain or application layers.
+- Presentation does not import concrete `*_repository.dart` from infrastructure (use interfaces).
+- New files are under correct folders per `docs/architecture/DDD_LAYERS.md`.
+- No `coregen` CLI was required — code follows templates.
+
+## Output
+
+Return a markdown checklist: pass/fail per rule, file paths for violations, suggested fixes. Do not edit files (readonly).

generators/static/cursor/agents/layer-infrastructure.md

@@ -0,0 +1,31 @@
+---
+name: layer-infrastructure
+description: Creates domain infrastructure — DTO, service interface, mock/remote services, mapper, repository implementation. Runs after layer-model in large epic pipeline.
+model: inherit
+readonly: false
+is_background: false
+---
+
+Implement only the **domain infrastructure** layer for the current epic.
+
+Read `docs/architecture/MOCK_AND_REMOTE_DATA.md` first.
+
+## Output paths
+
+- `lib/domain/<entity>/infrastructure/<entity>_dto.dart`
+- `lib/domain/<entity>/infrastructure/i_<entity>_service.dart`
+- `lib/domain/<entity>/infrastructure/<entity>_remote_service.dart`
+- `lib/domain/<entity>/infrastructure/mock_<entity>_service.dart`
+- `lib/domain/<entity>/infrastructure/<entity>_service_module.dart`
+- `lib/domain/<entity>/infrastructure/<entity>_mapper.dart`
+- `lib/domain/<entity>/infrastructure/<entity>_repository.dart`
+- `assets/mock/<entity>.json` — **required** seed data
+
+## Rules
+
+- Implement interfaces from `model/i_<entity>_repository.dart`.
+- Repository injects `I<Entity>Service` only.
+- Mock service reads `assets/mock/<entity>.json`; create/update JSON with 2–3 realistic rows matching the DTO.
+- Register entity in `DataSourceConfig.entities` as `DataSource.mock` unless remote is explicitly required.
+- Use `@injectable` on repository implementation.
+- Run after model layer exists. Do not create presentation or BLoC files.

generators/static/cursor/agents/layer-model.md

@@ -0,0 +1,24 @@
+---
+name: layer-model
+description: Creates domain model layer files — entity, failure, repository interface, value objects, validators, and enums under lib/domain/. Use in large epic pipeline before layer-infrastructure.
+model: inherit
+readonly: false
+is_background: false
+---
+
+Implement only the **domain model** layer for the current epic.
+
+## Output paths
+
+- `lib/domain/<entity>/model/<entity>.dart`
+- `lib/domain/<entity>/model/<entity>_failure.dart`
+- `lib/domain/<entity>/model/i_<entity>_repository.dart`
+- `lib/domain/<entity>/model/value_objects.dart`
+- `lib/domain/<entity>/model/value_validators.dart`
+- `lib/domain/enums/<enum>.dart` when needed
+
+## Rules
+
+- Follow `docs/architecture/FILE_TEMPLATES.md`.
+- No infrastructure, no BLoC, no widgets.
+- Use Freezed for entities and failures where applicable.

generators/static/cursor/agents/layer-presentation.md

@@ -0,0 +1,33 @@
+---
+name: layer-presentation
+description: Creates presentation UI with CaravaggioUI and shared widgets from lib/widgets/common/. Handles feature pages, components, and lib/features/components/. Runs after layer-application.
+model: inherit
+readonly: false
+is_background: false
+---
+
+Implement only the **presentation** layer for the current epic.
+
+## Before coding
+
+Read both:
+
+1. `docs/architecture/WIDGETS_AND_CARAVAGGIO.md`
+2. `docs/architecture/CARAVAGGIO_COMPONENTS.md`
+
+Optional pattern reference: skill `/caravaggio-ui`.
+
+## Output paths
+
+- `lib/features/<feature>/presentation/<name>_page.dart` or `<name>_component.dart`
+- `lib/features/components/<name>/` for cross-feature reusable components
+- `lib/features/<feature>/presentation/widgets/` for feature-local widgets
+
+## Rules
+
+- **Pages:** `CustomScaffold` (not Material `Scaffold`). `showBackButton: false` only on Home/Splash/Login.
+- **Components:** no scaffold; parent provides `CustomScaffold` + `BlocProvider`.
+- Use CaravaggioUI components from the catalog where available.
+- Reuse `LoadingWidget`, `ErrorWidget`, `UnknownStateWidget` from `lib/widgets/common/`.
+- Use `BlocBuilder` with typed states and `ErrorLocalizer` for failures.
+- Do not modify `router.dart` — leave to `integration-wiring`.

generators/static/cursor/docs/architecture/APIS_AND_INTEGRATION.md.jinja

@@ -0,0 +1,42 @@
+# APIs and integration — [[project_name]]
+
+## lib/apis/ structure
+
+| Path | Role |
+|------|------|
+| `apis/common/constants.dart` | `apiUrl`, headers |
+| `apis/common/data_source_config.dart` | Per-entity mock vs remote registry |
+| `apis/interceptors/` | Dio interceptors (auth, logging) |
+| `apis/core/` | Dio injectable module |
+
+**Mock data:** `assets/mock/<entity>.json` — see `docs/architecture/MOCK_AND_REMOTE_DATA.md`.
+
+## Mock vs remote
+
+Each domain entity has `I*Service` with **mock** (JSON assets) and **remote** (Retrofit) implementations. `DataSourceConfig.entities` selects which implementation DI provides. Default: **mock**.
+
+Read `docs/architecture/MOCK_AND_REMOTE_DATA.md` before adding entities or switching to remote.
+
+## When to add API code
+
+Add or extend `<entity>_remote_service.dart` when an epic needs HTTP endpoints. DTOs live in `lib/domain/<entity>/infrastructure/<entity>_dto.dart`. Repositories inject `I<Entity>Service`, never Retrofit directly.
+
+## Integration wiring (subagent: integration-wiring)
+
+After domain and feature layers exist:
+
+1. **router.dart** — import new page, add `GoRoute` with path and name consistent with existing routes.
+2. **injection.dart** — ensure `configureDependencies()` covers new `@injectable` classes and service modules.
+3. **data_source_config.dart** — register new entity as `DataSource.mock` (or `remote` when API ready).
+4. **assets/mock/** — create/update `<entity>.json` with sample data.
+5. **error_localizer.dart** — add `localize<Entity>Failure` method per new `*_failure.dart`.
+6. **build_runner** — run after Injectable/Freezed/Retrofit changes:
+   ```
+   dart run build_runner build --delete-conflicting-outputs
+   ```
+
+## Rules
+
+- No UI in `lib/apis/`.
+- Presentation never calls Retrofit directly — use repository from domain.
+- Remote entities require non-empty `Constants.apiUrl` (validated at startup).

generators/static/cursor/docs/architecture/CARAVAGGIO_COMPONENTS.md.jinja

@@ -0,0 +1,317 @@
+# CaravaggioUI component catalog — [[project_name]]
+
+Reference for `caravaggio_ui` **1.0.6**. Import:
+
+```dart
+import 'package:caravaggio_ui/caravaggio_ui.dart';
+```
+
+Initialize once in `main.dart` via `CaravaggioUI.initialize(...)`.
+
+For app-specific scaffold policy see `WIDGETS_AND_CARAVAGGIO.md`. Full API edge cases: [caravaggio_ui README](https://pub.dev/packages/caravaggio_ui).
+
+---
+
+## Design tokens
+
+| Token | Use |
+|-------|-----|
+| `AppColors` | Static palette (primary, secondary, shades) |
+| `AppSpacing` | Consistent spacing constants |
+| `AppRadius` | Border radius presets (`AppRadius.s`, `.m`, `.l`) |
+| `AppShadow` | Elevation shadows |
+| `CColors` | Runtime theme colors from `CaravaggioUI.initialize` |
+| `CGradient` | Background gradients (`CGradient.primaryLightToSecondaryLight`, etc.) |
+
+```dart
+padding: const EdgeInsets.all(AppSpacing.m),
+borderRadius: BorderRadius.circular(AppRadius.s),
+color: CColors.primaryColor,
+```
+
+---
+
+## Generics
+
+### CText
+
+Typography aligned with the design system. Factories: `display`, `headline`, `title`, `body`, `label` — each with optional `TextSize` (`small`, `medium`, `large`).
+
+```dart
+CText.title('Page title', size: TextSize.small),
+CText.body('Description', textAlign: TextAlign.center),
+CText.label('Submit'),
+```
+
+### CGradient
+
+Background gradients for scaffolds and containers.
+
+```dart
+backgroundGradient: CGradient.primaryLightToSecondaryLight,
+```
+
+---
+
+## Forms
+
+### CButton
+
+Elevated, outlined, text variants. Use `radius: AppRadius.s` for consistency.
+
+```dart
+CButton.elevated(
+  radius: AppRadius.s,
+  onPressed: () {},
+  child: CText.label('Save'),
+),
+CButton.outlined(onPressed: () {}, child: CText.label('Cancel')),
+```
+
+### CTextField
+
+Bordered text input with validation support.
+
+```dart
+CTextField.bordered(
+  decoration: CFieldDecoration(label: 'Email'),
+  onChanged: (value) {},
+),
+```
+
+### CAutocomplete
+
+Searchable dropdown with async suggestions.
+
+```dart
+CAutocomplete<String>(
+  decoration: CFieldDecoration(label: 'City'),
+  optionsBuilder: (query) => suggestions.where((s) => s.contains(query)),
+  onSelected: (value) {},
+),
+```
+
+### CDropdown
+
+Single-select dropdown with controller.
+
+```dart
+final controller = CDropdownController<String>();
+CDropdown<String>(
+  decoration: CFieldDecoration(label: 'Role'),
+  items: [CDropdownItemModel(value: 'a', label: 'Admin')],
+  controller: controller,
+),
+```
+
+### CCheckbox / CRadioGroup
+
+```dart
+CCheckbox(value: accepted, onChanged: (v) {}),
+CRadioGroup<String>(
+  values: items,
+  controller: radioController,
+  orientation: CRadioGroupOrientation.vertical,
+),
+```
+
+### CDatePicker / CTimePicker
+
+```dart
+CDatePicker(
+  decoration: CFieldDecoration(label: 'Date'),
+  onChanged: (date) {},
+),
+CTimePicker(
+  decoration: CFieldDecoration(label: 'Time'),
+  onChanged: (time) {},
+),
+```
+
+### CFieldDecoration
+
+Shared decoration for form fields (label, hint, error).
+
+---
+
+## Views — scaffold & layout
+
+### CScaffold (via CustomScaffold in this project)
+
+Design-system scaffold: gradient background, scroll-linked app bar, back pill, optional drawer.
+
+**In this project use `CustomScaffold`** from `lib/widgets/common/custom_scaffold.dart` for all routed pages.
+
+```dart
+CustomScaffold(
+  title: CText.title('Items', size: TextSize.small),
+  showBackButton: true, // false on Home, Splash, Login
+  action: IconButton(icon: Icon(Icons.add), onPressed: () {}),
+  bodyBuilder: (context, topPadding) => ListView(
+    padding: EdgeInsets.only(top: topPadding),
+    children: [...],
+  ),
+),
+```
+
+Key API: `body`, `bodyBuilder(context, topPadding)`, `title`, `action`, `leading`, `drawer`, `showBackButton`, `hideTitleOnScroll`, `scrollController`, `CustomScaffold.topPaddingOf(context)`.
+
+### CTile
+
+List/modal tile. Prefer `CTile.simple` for standard rows.
+
+```dart
+CTile.simple(
+  title: 'Item name',
+  description: 'Optional subtitle',
+  icon: Icons.folder_outlined,
+  trailing: Icon(Icons.chevron_right),
+  onTap: () {},
+),
+```
+
+### CTabs
+
+Pill tab bar with content panel.
+
+```dart
+CTabs(
+  tabs: const [
+    CTabItem(label: 'Overview', icon: Icons.dashboard_outlined),
+    CTabItem(label: 'Details', icon: Icons.info_outline),
+  ],
+  children: [OverviewTab(), DetailsTab()],
+),
+```
+
+### CCarousel
+
+Horizontal carousel for cards or images.
+
+```dart
+CCarousel(
+  itemCount: items.length,
+  itemBuilder: (context, index) => Card(child: ...),
+),
+```
+
+### CWrapper
+
+Card-style container with padding and optional title.
+
+```dart
+CWrapper(
+  title: CText.title('Section'),
+  child: ...,
+),
+```
+
+### CIconBadge / CTagChip
+
+```dart
+CIconBadge(icon: Icons.notifications, count: 3),
+CTagChip(label: 'Active', variant: CTagChipVariant.primary),
+```
+
+---
+
+## Views — dialogs & feedback
+
+### CPopup / showCPopup
+
+```dart
+showCPopup(
+  context: context,
+  title: 'Confirm',
+  message: 'Delete this item?',
+  actions: [
+    CPopupAction(label: 'Cancel', onPressed: () => Navigator.pop(context)),
+    CPopupAction(label: 'Delete', style: CPopupActionStyle.destructive, onPressed: onDelete),
+  ],
+),
+```
+
+### CModalBottomSheet / showCModalBottomSheet
+
+```dart
+showCModalBottomSheet(
+  context: context,
+  builder: (context) => YourSheetContent(),
+),
+```
+
+### CToast
+
+Requires `CToastScope` ancestor (typically in app root).
+
+```dart
+CToastScope.of(context).show('Saved successfully', variant: CToastVariant.success),
+```
+
+---
+
+## Indicators & data
+
+### CLoader
+
+Animated loading indicator (preferred over Material spinners).
+
+```dart
+CLoader.bouncing(),
+CLoader.orbit(color: CColors.primaryColor),
+```
+
+### Progress indicators
+
+Themed Material progress wrappers.
+
+```dart
+CCircularProgressIndicator.primary(),
+CLinearProgressIndicator.primary(),
+```
+
+### CCircularIndicator
+
+Radial gauge with optional label.
+
+```dart
+CCircularIndicator(value: 0.75, label: '75%'),
+```
+
+### CTable
+
+Structured data table.
+
+```dart
+CTable(
+  headers: [CTableHeader('Name'), CTableHeader('Status')],
+  rows: [
+    CTableRow(cells: [CTableCell.text('Item'), CTableCell.text('Active')]),
+  ],
+),
+```
+
+---
+
+## Quick mapping (Material → Caravaggio)
+
+| Avoid in presentation | Prefer |
+|-----------------------|--------|
+| `Scaffold` + `AppBar` on pages | `CustomScaffold` |
+| `CircularProgressIndicator` | `CLoader` or `CCircularProgressIndicator.primary()` |
+| `LinearProgressIndicator` | `CLinearProgressIndicator.primary()` |
+| `ListTile` | `CTile.simple` |
+| Raw `Text` for UI copy | `CText.*` |
+| Raw `ElevatedButton` | `CButton.elevated` |
+| Raw `TextField` | `CTextField.bordered` |
+
+---
+
+## App wrappers (generated)
+
+| Widget | Path | Role |
+|--------|------|------|
+| `CustomScaffold` | `lib/widgets/common/custom_scaffold.dart` | All routed pages |
+| `LoadingWidget` | `lib/widgets/common/loading_widget.dart` | BLoC loading states (`CLoader.bouncing`) |
+| `ErrorWidget` | `lib/widgets/common/error_widget.dart` | Localized errors (`CText.body`) |
+| `UnknownStateWidget` | `lib/widgets/common/unknown_state_widget.dart` | Unhandled BLoC states |

generators/static/cursor/docs/architecture/DDD_LAYERS.md.jinja

@@ -0,0 +1,32 @@
+# DDD layers — [[project_name]]
+
+## Allowed dependencies
+
+```
+presentation → application → domain (interfaces)
+infrastructure → domain (model)
+apis → domain (DTOs)
+core ← all layers (shared types, errors)
+```
+
+## Layer rules
+
+| Layer | Path | Contains | Must not contain |
+|-------|------|----------|------------------|
+| Domain model | `lib/domain/<e>/model/` | Entity, failure, `I*Repository`, VOs | Widgets, BLoC, Dio |
+| Domain infra | `lib/domain/<e>/infrastructure/` | DTO, `I*Service`, mock/remote services, mapper, repository impl | Widgets, BLoC |
+| Application | `lib/features/<f>/application/` | BLoC, events, states | Widgets |
+| Presentation | `lib/features/<f>/presentation/` | Pages, components | Direct infra imports |
+| APIs | `lib/apis/` | HTTP, interceptors, `DataSourceConfig` | UI |
+| Core | `lib/core/` | Shared errors, app shell | Feature-specific logic |
+
+## Anti-patterns
+
+- UI or `BuildContext` in `domain/`
+- Importing `*_repository.dart` (impl) from presentation — use `i_*_repository.dart`
+- Business logic in widgets — keep in BLoC
+- Skipping `error_localizer` when adding new `*_failure.dart`
+
+## Enums
+
+Place under `lib/domain/enums/<name>.dart`. Reference from entities and DTOs.

generators/static/cursor/docs/architecture/FILE_TEMPLATES.md.jinja

@@ -0,0 +1,76 @@
+# File templates — [[project_name]]
+
+## Domain entity `<entity>` (snake_case folder)
+
+### model/
+
+| File | Purpose |
+|------|---------|
+| `<entity>.dart` | Freezed entity |
+| `<entity>_failure.dart` | Freezed failure union |
+| `i_<entity>_repository.dart` | Repository interface (`Either<Failure, T>`) |
+| `value_objects.dart` | Value objects for fields |
+| `value_validators.dart` | Field validators |
+
+### infrastructure/
+
+| File | Purpose |
+|------|---------|
+| `<entity>_dto.dart` | JSON DTO |
+| `i_<entity>_service.dart` | Service interface |
+| `<entity>_remote_service.dart` | Retrofit REST client |
+| `mock_<entity>_service.dart` | Mock service (reads `assets/mock/<entity>.json`) |
+| `<entity>_service_module.dart` | DI binding mock vs remote |
+| `<entity>_mapper.dart` | DTO ↔ entity |
+| `<entity>_repository.dart` | `@Injectable` repository (injects `I*Service`) |
+
+### Mock assets
+
+| File | Purpose |
+|------|---------|
+| `assets/mock/<entity>.json` | Seed data (`{ "items": [...] }`) |
+
+{% if login %}
+### Auth infrastructure
+
+| File | Purpose |
+|------|---------|
+| `domain/auth/infrastructure/auth_facade.dart` | Remote auth skeleton |
+| `domain/auth/infrastructure/mock_auth_facade.dart` | Mock auth |
+| `domain/auth/infrastructure/auth_facade_module.dart` | DI for `IAuthFacade` |
+| `assets/mock/auth_user.json` | Mock user seed |
+{% endif %}
+
+## Feature `<feature>` with BLoC
+
+### application/
+
+| File | Purpose |
+|------|---------|
+| `<name>_bloc.dart` | BLoC |
+| `<name>_event.dart` | Freezed events |
+| `<name>_state.dart` | Freezed states |
+
+### presentation/
+
+| File | Purpose |
+|------|---------|
+| `<name>_page.dart` | Route page |
+| `<name>_component.dart` | Embeddable component |
+
+## Reusable component (`lib/features/components/<name>/`)
+
+Same `application/` + `presentation/` structure as a feature.
+
+## Enum
+
+`lib/domain/enums/<enum_snake>.dart` — PascalCase enum class.
+
+## Integration (after layers)
+
+- `lib/apis/common/data_source_config.dart` — per-entity mock/remote
+- `lib/router.dart` — GoRouter routes
+- `lib/injection.dart` — GetIt / injectable init
+- `lib/core/errors/error_localizer.dart` — user-facing failure messages
+
+See `docs/architecture/MOCK_AND_REMOTE_DATA.md` for mock JSON and switching to remote.