omni-rest 0.4.8 → 0.5.0

package/.cursor/rules/omni-rest.mdc

@@ -0,0 +1,15 @@
+---
+description: Omni Rest repository instructions for Cursor and other compatible agents.
+---
+
+# Omni Rest
+
+Use [AI/PROJECT_INTELLIGENCE.md](../../AI/PROJECT_INTELLIGENCE.md) as the source of truth.
+
+## Rules
+
+- Read the runtime files before editing.
+- Keep changes aligned with existing package boundaries.
+- Do not assume the README is current if source files disagree.
+- Preserve public exports unless the user asks for a breaking change.
+- Add or update tests for behavior changes.

package/.kiro/agent-guide.md

@@ -0,0 +1,16 @@
+# Omni Rest Agent Guide
+
+Use [AI/PROJECT_INTELLIGENCE.md](../AI/PROJECT_INTELLIGENCE.md) before working in this repo.
+
+## Summary
+
+- This repo is a Prisma-to-REST toolkit with adapters and generators.
+- Runtime source lives in `src/`.
+- Frontend generation lives in `src/frontend/`.
+- `omni-rest-client/` is the companion frontend generator package.
+
+## Working Notes
+
+- Trust source files over docs when they disagree.
+- Keep changes small and localized.
+- Validate runtime changes with tests where possible.

package/.kiro/specs/frontend-enhancements.md

@@ -0,0 +1,243 @@
+# Frontend Generator Enhancements
+
+## Overview
+Enhance the frontend generator to provide better UX and Next.js App Router support with automatic page generation and menu data.
+
+## 1. Interactive Multi-Select Improvements
+
+### Current State
+- Users type numbers: "1,3,5" or "all"
+- Not intuitive, requires reading list and typing
+
+### Proposed Enhancement
+- Add `inquirer` or `prompts` package for better CLI UX
+- Arrow keys to navigate, spacebar to select/deselect
+- Visual checkboxes showing selected state
+- "Select all" / "Deselect all" shortcuts
+
+### Implementation
+```typescript
+import prompts from 'prompts';
+
+async function multiSelect(prompt: string, items: string[]): Promise<number[]> {
+  const choices = items.map((item, i) => ({ title: item, value: i, selected: true }));
+  const response = await prompts({
+    type: 'multiselect',
+    name: 'indices',
+    message: prompt,
+    choices,
+    hint: '- Space to select. Return to submit'
+  });
+  return response.indices || [];
+}
+```
+
+## 2. Smart Directory Detection
+
+### Current State
+- Always outputs to `src/` or `app/` (Next.js without src)
+- Doesn't detect if project uses `src/` structure
+
+### Proposed Logic
+```typescript
+function detectProjectStructure(frontendDir: string) {
+  const hasSrc = fs.existsSync(path.join(frontendDir, 'src'));
+  const hasApp = fs.existsSync(path.join(frontendDir, 'app'));
+  const hasSrcApp = fs.existsSync(path.join(frontendDir, 'src', 'app'));
+  
+  return {
+    usesSrc: hasSrc,
+    usesAppRouter: hasApp || hasSrcApp,
+    basePath: hasSrc ? 'src' : '.',
+  };
+}
+```
+
+### Output Structure
+
+#### Next.js App Router (with src/)
+```
+src/
+├── app/
+│   └── (autogenerated-omni)/
+│       ├── users/
+│       │   └── page.tsx          # User management page
+│       ├── products/
+│       │   └── page.tsx          # Product management page
+│       └── layout.tsx             # Shared layout (optional)
+├── components/
+│   ├── data-table.tsx
+│   ├── form-generator.tsx
+│   ├── user/
+│   │   ├── UserColumns.tsx
+│   │   ├── UserTable.tsx
+│   │   └── UserForm.tsx
+│   └── product/
+│       ├── ProductColumns.tsx
+│       ├── ProductTable.tsx
+│       └── ProductForm.tsx
+├── hooks/
+│   ├── useUser.ts
+│   └── useProduct.ts
+└── lib/
+    └── menu-data.ts               # Generated menu structure
+```
+
+#### Next.js App Router (without src/)
+```
+app/
+└── (autogenerated-omni)/
+    ├── users/
+    │   └── page.tsx
+    └── products/
+        └── page.tsx
+components/
+hooks/
+lib/
+└── menu-data.ts
+```
+
+#### Vite/React (with src/)
+```
+src/
+├── components/
+├── hooks/
+└── lib/
+    └── menu-data.ts
+```
+
+## 3. Next.js Page Generation
+
+### Page Template
+```typescript
+// app/(autogenerated-omni)/users/page.tsx
+'use client'
+
+import { UserTable } from '@/components/user/UserTable'
+
+export default function UsersPage() {
+  return (
+    <div className="container mx-auto py-10">
+      <h1 className="text-3xl font-bold mb-6">Users</h1>
+      <UserTable />
+    </div>
+  )
+}
+```
+
+### Route Group Benefits
+- `(autogenerated-omni)` doesn't appear in URL
+- Easy to identify generated pages
+- Can share layout across all generated pages
+- Can be easily deleted/regenerated
+
+## 4. Menu Data Generation
+
+### File: `lib/menu-data.ts` or `src/lib/menu-data.ts`
+
+```typescript
+/**
+ * Auto-generated menu data for omni-rest CRUD pages
+ * Generated by omni-rest — do not edit manually.
+ */
+
+export interface MenuItem {
+  label: string;
+  href: string;
+  icon?: string;
+}
+
+export const omniRestMenuItems: MenuItem[] = [
+  {
+    label: 'Users',
+    href: '/users',
+  },
+  {
+    label: 'Products',
+    href: '/products',
+  },
+  {
+    label: 'Orders',
+    href: '/orders',
+  },
+  // ... more items
+];
+
+// Grouped by category (if we detect relationships)
+export const omniRestMenuGroups = {
+  'User Management': [
+    { label: 'Users', href: '/users' },
+    { label: 'Roles', href: '/roles' },
+  ],
+  'E-commerce': [
+    { label: 'Products', href: '/products' },
+    { label: 'Orders', href: '/orders' },
+    { label: 'Categories', href: '/categories' },
+  ],
+};
+```
+
+### Usage in Sidebar
+```typescript
+import { omniRestMenuItems } from '@/lib/menu-data'
+
+export function Sidebar() {
+  return (
+    <nav>
+      {omniRestMenuItems.map(item => (
+        <Link key={item.href} href={item.href}>
+          {item.label}
+        </Link>
+      ))}
+    </nav>
+  )
+}
+```
+
+## 5. Implementation Plan
+
+### Phase 1: Directory Detection (v0.2.8)
+- [x] Detect `src/` usage
+- [ ] Detect App Router vs Pages Router
+- [ ] Update `resolveOutputDir` logic
+- [ ] Add tests for directory detection
+
+### Phase 2: Next.js Page Generation (v0.2.9)
+- [ ] Generate page.tsx files in App Router
+- [ ] Use route groups `(autogenerated-omni)`
+- [ ] Generate shared layout if needed
+- [ ] Add proper imports with path aliases
+
+### Phase 3: Menu Data Generation (v0.2.10)
+- [ ] Generate `menu-data.ts` file
+- [ ] Include all generated routes
+- [ ] Add TypeScript types
+- [ ] Document usage in README
+
+### Phase 4: Better Interactive UX (v0.3.0)
+- [ ] Add `prompts` dependency
+- [ ] Implement arrow-key multi-select
+- [ ] Add visual feedback
+- [ ] Update documentation
+
+## 6. Configuration Options
+
+Add new CLI flags:
+```bash
+npx omni-rest generate:frontend \
+  --autopilot \
+  --generate-pages        # Generate Next.js pages (default: true for Next.js)
+  --generate-menu         # Generate menu-data.ts (default: true)
+  --route-group <name>    # Custom route group name (default: autogenerated-omni)
+```
+
+## 7. Breaking Changes
+
+None - all enhancements are additive and backward compatible.
+
+## 8. Documentation Updates
+
+- Update CLI docs with new flags
+- Add Next.js App Router guide
+- Add menu integration examples
+- Add migration guide for existing projects

package/.kiro/specs/frontend-generator/.config.kiro

@@ -0,0 +1 @@
+{"specId": "79688110-a99e-4d68-9638-a75d66f00592", "workflowType": "requirements-first", "specType": "feature"}