@specverse/engine-realize 3.5.3

package/libs/instance-factories/applications/generic-app.yaml

@@ -0,0 +1,52 @@
+name: GenericApp
+version: "1.0.0"
+category: application
+description: "Generic application entry point that adapts to framework choice"
+
+metadata:
+  author: "SpecVerse Team"
+  license: "MIT"
+  tags: [application, entry-point, generic]
+
+compatibility:
+  specverse: "^3.3.0"
+  node: ">=18.0.0"
+
+capabilities:
+  provides:
+    - "app.entrypoint"
+    - "app.main"
+  requires:
+    - "api.rest"  # Needs HTTP framework
+
+technology:
+  runtime: "node"
+  language: "typescript"
+
+codeTemplates:
+  main:
+    engine: typescript
+    generator: "libs/instance-factories/applications/templates/generic/main-generator.ts"
+    outputPattern: "{backendDir}/src/main.ts"
+
+  backendPackageJson:
+    engine: typescript
+    generator: "libs/instance-factories/applications/templates/generic/backend-package-json-generator.ts"
+    outputPattern: "{backendDir}/package.json"
+
+  backendTsconfig:
+    engine: typescript
+    generator: "libs/instance-factories/applications/templates/generic/backend-tsconfig-generator.ts"
+    outputPattern: "{backendDir}/tsconfig.json"
+
+  backendEnv:
+    engine: typescript
+    generator: "libs/instance-factories/applications/templates/generic/backend-env-generator.ts"
+    outputPattern: "{backendDir}/.env"
+
+configuration:
+  outputStructure: "monorepo"
+  backendDir: "backend"
+
+  defaultPort: 3000
+  defaultHost: "0.0.0.0"

package/libs/instance-factories/applications/react-app.yaml

@@ -0,0 +1,186 @@
+name: ReactApp
+version: "1.0.0"
+category: view
+description: "Complete React application scaffolding with Vite, Router, and TypeScript"
+
+metadata:
+  author: "SpecVerse Team"
+  license: "MIT"
+  tags: [react, vite, spa, frontend, application]
+
+compatibility:
+  specverse: "^3.3.0"
+  node: ">=18.0.0"
+
+capabilities:
+  provides:
+    - "app.frontend"
+    - "ui.scaffolding"
+    - "ui.router"
+  requires:
+    - "ui.components"  # Needs React components to be generated
+
+technology:
+  runtime: "browser"
+  language: "typescript"
+  framework: "react"
+  bundler: "vite"
+  router: "react-router"
+  version: "^18.2.0"
+
+dependencies:
+  runtime:
+    - name: "react"
+      version: "^18.2.0"
+    - name: "react-dom"
+      version: "^18.2.0"
+    - name: "react-router-dom"
+      version: "^6.18.0"
+    - name: "@tanstack/react-query"
+      version: "^5.0.0"
+
+  dev:
+    - name: "@types/react"
+      version: "^18.2.0"
+    - name: "@types/react-dom"
+      version: "^18.2.0"
+    - name: "typescript"
+      version: "^5.2.0"
+    - name: "vite"
+      version: "^5.0.0"
+    - name: "@vitejs/plugin-react"
+      version: "^4.2.0"
+
+codeTemplates:
+  index-html:
+    engine: typescript
+    generator: "libs/instance-factories/applications/templates/react/index-html-generator.ts"
+    outputPattern: "{frontendDir}/index.html"
+
+  app-tsx:
+    engine: typescript
+    generator: "libs/instance-factories/applications/templates/react/app-tsx-generator.ts"
+    outputPattern: "{frontendDir}/src/App.tsx"
+
+  main-tsx:
+    engine: typescript
+    generator: "libs/instance-factories/applications/templates/react/main-tsx-generator.ts"
+    outputPattern: "{frontendDir}/src/main.tsx"
+
+  vite-config:
+    engine: typescript
+    generator: "libs/instance-factories/applications/templates/react/vite-config-generator.ts"
+    outputPattern: "{frontendDir}/vite.config.ts"
+
+  tsconfig:
+    engine: typescript
+    generator: "libs/instance-factories/applications/templates/react/tsconfig-generator.ts"
+    outputPattern: "{frontendDir}/tsconfig.json"
+
+  package-json:
+    engine: typescript
+    generator: "libs/instance-factories/applications/templates/react/package-json-generator.ts"
+    outputPattern: "{frontendDir}/package.json"
+
+  index-css:
+    engine: typescript
+    generator: "libs/instance-factories/applications/templates/react/index-css-generator.ts"
+    outputPattern: "{frontendDir}/src/index.css"
+
+  gitignore:
+    engine: typescript
+    generator: "libs/instance-factories/applications/templates/react/gitignore-generator.ts"
+    outputPattern: "{frontendDir}/.gitignore"
+
+  env-example:
+    engine: typescript
+    generator: "libs/instance-factories/applications/templates/react/env-example-generator.ts"
+    outputPattern: "{frontendDir}/.env.example"
+
+  api-client:
+    engine: typescript
+    generator: "libs/instance-factories/applications/templates/react/api-client-generator.ts"
+    outputPattern: "{frontendDir}/src/lib/apiClient.ts"
+
+  pattern-adapter:
+    engine: typescript
+    generator: "libs/instance-factories/applications/templates/react/pattern-adapter-generator.ts"
+    outputPattern: "{frontendDir}/src/lib/react-pattern-adapter.tsx"
+
+  tailwind-adapter:
+    engine: typescript
+    generator: "libs/instance-factories/applications/templates/react/tailwind-adapter-wrapper-generator.ts"
+    outputPattern: "{frontendDir}/src/lib/tailwind-adapter-generator.ts"
+
+  view-form:
+    engine: typescript
+    generator: "libs/instance-factories/applications/templates/react/view-form-generator.ts"
+    outputPattern: "{frontendDir}/src/components/views/FormView.tsx"
+
+  view-list:
+    engine: typescript
+    generator: "libs/instance-factories/applications/templates/react/view-list-generator.ts"
+    outputPattern: "{frontendDir}/src/components/views/ListView.tsx"
+
+  view-detail:
+    engine: typescript
+    generator: "libs/instance-factories/applications/templates/react/view-detail-generator.ts"
+    outputPattern: "{frontendDir}/src/components/views/DetailView.tsx"
+
+  view-dashboard:
+    engine: typescript
+    generator: "libs/instance-factories/applications/templates/react/view-dashboard-generator.ts"
+    outputPattern: "{frontendDir}/src/components/views/DashboardView.tsx"
+
+  view-router:
+    engine: typescript
+    generator: "libs/instance-factories/applications/templates/react/view-router-generator.ts"
+    outputPattern: "{frontendDir}/src/components/views/StandardViewRouter.tsx"
+
+  field-helpers:
+    engine: typescript
+    generator: "libs/instance-factories/applications/templates/react/field-helpers-generator.ts"
+    outputPattern: "{frontendDir}/src/utils/field-helpers.ts"
+
+  relationship-field:
+    engine: typescript
+    generator: "libs/instance-factories/applications/templates/react/relationship-field-generator.ts"
+    outputPattern: "{frontendDir}/src/components/fields/RelationshipField.tsx"
+
+  use-api-hooks:
+    engine: typescript
+    generator: "libs/instance-factories/applications/templates/react/use-api-hooks-generator.ts"
+    outputPattern: "{frontendDir}/src/hooks/useApi.ts"
+
+  api-types:
+    engine: typescript
+    generator: "libs/instance-factories/applications/templates/react/api-types-generator.ts"
+    outputPattern: "{frontendDir}/src/types/api.ts"
+
+configuration:
+  projectStructure: "monorepo"
+  frontendDir: "frontend"
+  backendDir: "backend"
+
+  vite:
+    port: 5173
+    host: "localhost"
+    proxy:
+      "/api": "http://localhost:3000"
+
+  routing:
+    library: "react-router"
+    version: "^6.18.0"
+    basename: "/"
+
+requirements:
+  dependencies:
+    npm:
+      devDependencies:
+        "@vitejs/plugin-react": "^4.2.0"
+        "vite": "^5.0.0"
+
+  scripts:
+    "dev:frontend": "cd frontend && vite"
+    "build:frontend": "cd frontend && vite build"
+    "preview:frontend": "cd frontend && vite preview"

package/libs/instance-factories/applications/templates/generic/backend-env-generator.ts

@@ -0,0 +1,31 @@
+/**
+ * Backend .env Generator
+ *
+ * Generates .env file for backend workspace
+ */
+
+import type { TemplateContext } from '@specverse/engine-realize';
+
+export default function generateBackendEnv(context: TemplateContext): string {
+  const { spec } = context;
+
+  const projectName = (spec.metadata?.component || 'app')
+    .toLowerCase()
+    .replace(/\s+/g, '-');
+
+  const dbName = `spv_${projectName}_dev`;
+  const dbUser = process.env.USER || 'postgres';
+
+  return `# Backend Environment Configuration
+# Database
+DATABASE_URL="postgresql://${dbUser}:@localhost:5432/${dbName}"
+
+# API Configuration
+PORT=3000
+HOST=0.0.0.0
+NODE_ENV=development
+
+# CORS
+CORS_ORIGINS="http://localhost:5173"
+`;
+}

package/libs/instance-factories/applications/templates/generic/backend-package-json-generator.ts

@@ -0,0 +1,80 @@
+/**
+ * Backend Package.json Generator
+ *
+ * Generates package.json for backend workspace in monorepo
+ */
+
+import type { TemplateContext } from '@specverse/engine-realize';
+
+export default function generateBackendPackageJson(context: TemplateContext): string {
+  const { spec } = context;
+
+  const pkg = {
+    name: `${(spec.metadata?.component || 'app').toLowerCase().replace(/\s+/g, '-')}-backend`,
+    version: spec.metadata?.version || '1.0.0',
+    description: `Backend API for ${spec.metadata?.component || 'application'}`,
+    private: true,
+    type: 'module',
+
+    scripts: {
+      // Development
+      'dev': 'tsx watch src/main.ts',
+      'dev:debug': 'tsx watch --inspect src/main.ts',
+
+      // Build
+      'build': 'tsc',
+      'build:watch': 'tsc --watch',
+
+      // Production
+      'start': 'node dist/main.js',
+
+      // Database
+      'db:setup': 'prisma generate && prisma db push',
+      'db:generate': 'prisma generate',
+      'db:push': 'prisma db push',
+      'db:migrate': 'prisma migrate dev',
+      'db:studio': 'prisma studio',
+      'db:seed': 'tsx prisma/seed.ts',
+
+      // Testing
+      'test': 'vitest run --passWithNoTests',
+      'test:watch': 'vitest watch',
+      'test:coverage': 'vitest --coverage',
+
+      // Linting
+      'lint': 'eslint src --ext .ts',
+      'lint:fix': 'eslint src --ext .ts --fix',
+
+      // Type checking
+      'typecheck': 'tsc --noEmit'
+    },
+
+    dependencies: {
+      '@prisma/client': '^5.7.0',
+      'fastify': '^4.25.0',
+      '@fastify/cors': '^8.4.0',
+      '@fastify/helmet': '^11.1.1',
+      '@fastify/rate-limit': '^9.1.0',
+      'zod': '^3.22.0',
+      'dotenv': '^16.3.0'
+    },
+
+    devDependencies: {
+      'typescript': '^5.3.0',
+      '@types/node': '^20.10.0',
+      'tsx': '^4.7.0',
+      'prisma': '^5.7.0',
+      'vitest': '^1.0.0',
+      '@vitest/coverage-v8': '^1.0.0',
+      'eslint': '^8.55.0',
+      '@typescript-eslint/eslint-plugin': '^6.15.0',
+      '@typescript-eslint/parser': '^6.15.0'
+    },
+
+    engines: {
+      node: '>=18.0.0'
+    }
+  };
+
+  return JSON.stringify(pkg, null, 2);
+}

package/libs/instance-factories/applications/templates/generic/backend-tsconfig-generator.ts

@@ -0,0 +1,69 @@
+/**
+ * Backend tsconfig.json Generator
+ *
+ * Generates TypeScript configuration for backend workspace
+ */
+
+import type { TemplateContext } from '@specverse/engine-realize';
+
+export default function generateBackendTsConfig(context: TemplateContext): string {
+  const config = {
+    compilerOptions: {
+      // Target and Module
+      target: 'ES2022',
+      module: 'ESNext',
+      lib: ['ES2022'],
+      moduleResolution: 'node',
+
+      // Output
+      outDir: './dist',
+      rootDir: './src',
+
+      // Strict Type Checking
+      strict: true,
+      noImplicitAny: true,
+      strictNullChecks: true,
+      strictFunctionTypes: true,
+      strictBindCallApply: true,
+      strictPropertyInitialization: true,
+      noImplicitThis: true,
+      alwaysStrict: true,
+
+      // Additional Checks
+      noUnusedLocals: true,
+      noUnusedParameters: true,
+      noImplicitReturns: true,
+      noFallthroughCasesInSwitch: true,
+      noUncheckedIndexedAccess: true,
+
+      // Module Resolution
+      esModuleInterop: true,
+      allowSyntheticDefaultImports: true,
+      resolveJsonModule: true,
+      isolatedModules: true,
+
+      // Source Maps
+      sourceMap: true,
+      declaration: true,
+      declarationMap: true,
+
+      // Skip lib check for faster builds
+      skipLibCheck: true,
+
+      // Emit
+      removeComments: false,
+      importHelpers: true,
+
+      // Experimental
+      experimentalDecorators: true,
+      emitDecoratorMetadata: true,
+
+      // Types
+      types: ['node']
+    },
+    include: ['src/**/*'],
+    exclude: ['node_modules', 'dist', '**/*.test.ts', '**/*.spec.ts']
+  };
+
+  return JSON.stringify(config, null, 2);
+}