openprompt-lang 0.3.0 → 0.4.0

package/docs/langs/vue-nuxt.md

@@ -0,0 +1,36 @@
+# PromptLang para Vue Nuxt 3
+
+## Tags Adaptados
+
+| Tag PromptLang | Equivalente Vue | Descripción |
+|---|---|---|
+| `@kind(component)` | `defineComponent` | Componente SFC |
+| `@kind(composable)` | `composables/` | Función composable Vue |
+| `@kind(page)` | `pages/` | Página Nuxt |
+| `@kind(server)` | `server/api/` | API endpoint Nuxt |
+| `@kind(store)` | `defineStore` (Pinia) | Estado global |
+| `@kind(middleware)` | `middleware/` | Middleware Nuxt |
+
+## Contratos
+
+```vue
+<!-- @kind(composable) -->
+<!-- @contract(in: userId: string -> out: User | null @error: string) -->
+<!-- @limit(lines: 80) -->
+<script setup lang="ts">
+export function useUser(userId: MaybeRef<string>) { ... }
+</script>
+
+<!-- @kind(page) -->
+<!-- @compose(UserList, UserForm) -->
+<template>
+  <UserList />
+  <UserForm />
+</template>
+```
+
+## Scaffolding Generado
+- `composables/useUser.ts` (lógica reactiva)
+- `pages/users/index.vue` (listado)
+- `server/api/users.get.ts` (API endpoint)
+- `stores/user.ts` (Pinia store)

package/package.json

@@ -1,27 +1,53 @@
 {
   "name": "openprompt-lang",
-  "version": "0.3.0",
+  "version": "0.4.0",
   "description": "PromptLang CLI — Framework de anotaciones para desarrollo asistido por IA",
   "type": "module",
   "main": "./bin/cli.js",
   "bin": {
-    "openPrompt-Lang": "./bin/cli.js"
+    "openPrompt-Lang": "./bin/cli.js",
+    "openprompt-create": "./bin/create.js"
   },
   "files": [
     "bin/",
     "src/",
     "schemas/",
     "docs/",
+    "scaffolds/",
     "vscode-extension/",
     "README.md",
     "LICENSE"
   ],
+  "exports": {
+    ".": "./bin/cli.js",
+    "./ts-plugin": {
+      "types": "./src/language-service/plugin.d.ts",
+      "require": "./src/language-service/plugin.cjs"
+    },
+    "./vite-plugin": "./src/vite-plugin/index.js",
+    "./ts-transformer": {
+      "require": "./src/ts-transformer/index.cjs"
+    }
+  },
   "scripts": {
     "start": "node bin/cli.js",
     "test": "vitest run",
     "test:watch": "vitest",
+    "lint": "eslint .",
+    "lint:fix": "eslint . --fix",
+    "format": "prettier --write .",
+    "format:check": "prettier --check .",
     "prepublishOnly": "npm test",
-    "postinstall": "node -e \"console.log('\\n📦 openPrompt-Lang instalado. Ejecuta: npx openPrompt-Lang init\\n')\""
+    "postinstall": "node -e \"console.log('\\n📦 openPrompt-Lang instalado. Ejecuta: npx openPrompt-Lang init\\n')\"",
+    "opencode:teach": "openprompt-lang teach",
+    "opencode:scaffold": "openprompt-lang scaffold folders react",
+    "opencode:validate": "openprompt-lang validate",
+    "opencode:analyze": "openprompt-lang analyze .",
+    "opencode:search": "openprompt-lang lang search",
+    "opencode:qa": "openprompt-lang qa-gen --lang react",
+    "opencode:context": "openprompt-lang context --output contexto.md",
+    "opencode:integrate": "openprompt-lang integrate --all",
+    "opencode:wizard": "openprompt-lang wizard"
   },
   "keywords": [
     "prompt-lang",
@@ -43,6 +69,8 @@
     "inquirer": "^9.3.0"
   },
   "devDependencies": {
+    "eslint": "^10.3.0",
+    "prettier": "^3.8.3",
     "vitest": "^4.1.6"
   },
   "repository": {

package/scaffolds/.cursorrules

@@ -0,0 +1,6 @@
+# openPrompt-Lang Rules for AI Assistants
+Always parse prompt-lang.json and use openPrompt syntax for all generated code.
+@openprompt prefix triggers MVP wizard: ask stack/features/deploy questions before generating.
+Priority: reuse existing templates from templates/ and errors from errors.json.
+Use @kind, @contract, @limit, @props annotations on all generated files.
+No any types. Strict linting. Validate before suggesting.

package/scaffolds/AGENTS.md

@@ -0,0 +1,27 @@
+# AGENTS.md — Contexto para IA
+
+## Stack
+- React 18 + TypeScript + Vite
+- Tailwind CSS
+- Zustand (estado global)
+
+## Convenciones
+- Un componente por archivo, máximo 120 líneas
+- Un hook por archivo, máximo 80 líneas
+- 100% Tailwind utility classes (sin CSS personalizado)
+- Barrel exports en cada carpeta (index.ts)
+- Commits: conventional commits + log en docs/COMMITS/
+- Framework: openPrompt-Lang (anotaciones @kind, @contract, @limit, etc.)
+
+## Perfil del desarrollador
+senior
+
+## Reglas críticas
+- NO usar any
+- NO superar límites de líneas sin refactorizar
+- Ejecutar `npm run validate:all` antes de cada commit
+- Las anotaciones PromptLang deben declarar @use() al inicio del archivo
+
+## Referencias
+- Framework: docs/FRAMEWORK.md
+- Sintaxis PromptLang: docs/SYNTAX.md

package/scaffolds/Dockerfile

@@ -0,0 +1,11 @@
+FROM node:20-alpine AS builder
+WORKDIR /app
+COPY package*.json ./
+RUN npm ci
+COPY . .
+RUN npm run build:prod
+
+FROM nginx:alpine
+COPY --from=builder /app/dist /usr/share/nginx/html
+EXPOSE 80
+CMD ["nginx", "-g", "daemon off;"]

package/scaffolds/capacitor.config.ts

@@ -0,0 +1,17 @@
+import { CapacitorConfig } from "@capacitor/cli"
+
+const config: CapacitorConfig = {
+  appId: "com.app.app",
+  appName: "App",
+  webDir: "dist",
+  server: {
+    androidScheme: "https",
+  },
+  plugins: {
+    SplashScreen: {
+      launchShowDuration: 2000,
+    },
+  },
+}
+
+export default config

package/scaffolds/netlify.toml

@@ -0,0 +1,8 @@
+[build]
+  command = "npm run build:prod"
+  publish = "dist"
+
+[[redirects]]
+  from = "/*"
+  to = "/index.html"
+  status = 200

package/scaffolds/prompt-lang.json

@@ -0,0 +1,15 @@
+{
+  "name": "mi-app",
+  "version": "0.1.0",
+  "lenguaje": "react",
+  "stack": {
+    "base": ["react", "typescript", "vite", "tailwind"]
+  },
+  "profile": "senior",
+  "annotations": { "enabled": true, "strict": true },
+  "docs": { "commits": true, "logs": true, "backlog": true },
+  "extractor": {
+    "ignore": [".env", "*.local", "dist", "node_modules"],
+    "output": "contexto.md"
+  }
+}

package/scaffolds/railway.json

@@ -0,0 +1,12 @@
+{
+  "$schema": "https://railway.app/railway.schema.json",
+  "build": {
+    "builder": "NIXPACKS",
+    "buildCommand": "npm run build:prod"
+  },
+  "deploy": {
+    "startCommand": "npm run dev:start",
+    "healthcheckPath": "/",
+    "restartPolicyType": "ON_FAILURE"
+  }
+}

package/scaffolds/tailwind.config.js

@@ -0,0 +1,8 @@
+/** @type {import('tailwindcss').Config} */
+export default {
+  content: ["./index.html", "./src/**/*.{js,ts,jsx,tsx}"],
+  theme: {
+    extend: {},
+  },
+  plugins: [],
+}

package/scaffolds/tauri.conf.json

@@ -0,0 +1,26 @@
+{
+  "$schema": "https://raw.githubusercontent.com/tauri-apps/tauri/dev/crates/tauri-config-schema/schema.json",
+  "productName": "App",
+  "version": "0.1.0",
+  "identifier": "com.app.app",
+  "build": {
+    "frontendDist": "../dist",
+    "devUrl": "http://localhost:5173",
+    "beforeBuildCommand": "npm run build:prod",
+    "beforeDevCommand": "npm run dev:start"
+  },
+  "app": {
+    "windows": [
+      {
+        "title": "App",
+        "width": 1200,
+        "height": 800,
+        "resizable": true,
+        "fullscreen": false
+      }
+    ],
+    "security": {
+      "csp": null
+    }
+  }
+}

package/schemas/language-module.json

@@ -0,0 +1,116 @@
+{
+  "$schema": "http://json-schema.org/draft-07/schema#",
+  "title": "openPrompt-Lang Language Module",
+  "description": "Schema for pluggable language modules",
+  "type": "object",
+  "required": ["id", "name", "version", "tags", "structure"],
+  "properties": {
+    "id": {
+      "type": "string",
+      "description": "Unique language identifier (e.g. 'react', 'vue', 'java-spring')"
+    },
+    "name": {
+      "type": "string",
+      "description": "Human-readable name (e.g. 'React + TypeScript')"
+    },
+    "version": {
+      "type": "string",
+      "pattern": "^\\d+\\.\\d+\\.\\d+$",
+      "description": "Module version (semver)"
+    },
+    "tags": {
+      "type": "object",
+      "description": "PromptLang tag mappings for this language",
+      "properties": {
+        "kind": {
+          "type": "object",
+          "description": "Available @kind values",
+          "additionalProperties": {
+            "type": "object",
+            "properties": {
+              "extends": { "type": "string" },
+              "limit": { "type": "number" },
+              "requires": { "type": "array", "items": { "type": "string" } },
+              "forbids": { "type": "array", "items": { "type": "string" } },
+              "suggests": { "type": "array", "items": { "type": "string" } },
+              "description": { "type": "string" }
+            }
+          }
+        },
+        "platforms": {
+          "type": "array",
+          "items": { "type": "string" }
+        },
+        "forbidden": {
+          "type": "array",
+          "items": { "type": "string" }
+        }
+      }
+    },
+    "structure": {
+      "type": "object",
+      "description": "Folder structure and scaffold config",
+      "required": ["folders"],
+      "properties": {
+        "folders": {
+          "type": "array",
+          "items": { "type": "string" }
+        },
+        "scaffolds": {
+          "type": "array",
+          "items": { "type": "string" }
+        },
+        "deps": {
+          "type": "object",
+          "description": "Dependency presets for this language",
+          "additionalProperties": {
+            "type": "object",
+            "properties": {
+              "prod": { "type": "array", "items": { "type": "string" } },
+              "dev": { "type": "array", "items": { "type": "string" } }
+            }
+          }
+        }
+      }
+    },
+    "projectTypes": {
+      "type": "object",
+      "description": "Available project types for this language",
+      "additionalProperties": {
+        "type": "object",
+        "properties": {
+          "name": { "type": "string" },
+          "ui": { "type": "boolean" },
+          "description": { "type": "string" }
+        }
+      }
+    },
+    "uiStyles": {
+      "type": "array",
+      "items": {
+        "type": "string"
+      },
+      "description": "Available UI style libraries"
+    },
+    "extensions": {
+      "type": "array",
+      "items": {
+        "type": "object",
+        "properties": {
+          "name": { "type": "string" },
+          "value": { "type": "string" },
+          "deps": {
+            "type": "array",
+            "items": { "type": "string" }
+          },
+          "description": { "type": "string" }
+        }
+      }
+    },
+    "annotationTags": {
+      "type": "array",
+      "items": { "type": "string" },
+      "description": "Custom @annotation tags specific to this language module"
+    }
+  }
+}

package/schemas/prompt-lang.json

@@ -13,6 +13,12 @@
       "pattern": "^\\d+\\.\\d+\\.\\d+$",
       "description": "Versión del proyecto (semver)"
     },
+    "lenguaje": {
+      "type": "string",
+      "enum": ["react", "vue", "angular", "node", "java", "csharp", "python", "unity", "rust"],
+      "default": "react",
+      "description": "Lenguaje/framework principal del proyecto"
+    },
     "stack": {
       "type": "object",
       "properties": {
@@ -20,7 +26,20 @@
           "type": "array",
           "items": {
             "type": "string",
-            "enum": ["react", "typescript", "vite", "tailwind", "vue", "angular"]
+            "enum": [
+              "react",
+              "typescript",
+              "vite",
+              "tailwind",
+              "vue",
+              "angular",
+              "nuxt",
+              "next",
+              "express",
+              "spring-boot",
+              "fastapi",
+              "dotnet"
+            ]
           },
           "description": "Stack base del proyecto"
         },
@@ -28,7 +47,18 @@
           "type": "array",
           "items": {
             "type": "string",
-            "enum": ["supabase", "ionic", "capacitor", "tauri", "firebase", "trpc", "next"]
+            "enum": [
+              "supabase",
+              "ionic",
+              "capacitor",
+              "tauri",
+              "firebase",
+              "trpc",
+              "next",
+              "prisma",
+              "stripe",
+              "webpay"
+            ]
           },
           "description": "Extensiones opcionales del stack"
         }
@@ -67,7 +97,12 @@
       "type": "object",
       "properties": {
         "enabled": { "type": "boolean", "default": true },
-        "strict": { "type": "boolean", "default": false }
+        "strict": { "type": "boolean", "default": false },
+        "customTags": {
+          "type": "array",
+          "items": { "type": "string" },
+          "description": "Additional @annotation tags beyond built-in ones"
+        }
       }
     },
     "docs": {

package/schemas/structures.json

@@ -0,0 +1,145 @@
+{
+  "react-vite": {
+    "name": "React Vite TypeScript",
+    "folders": [
+      "src/components/ui",
+      "src/components/layout",
+      "src/components/shared",
+      "src/features",
+      "src/hooks",
+      "src/services",
+      "src/store",
+      "src/types",
+      "src/utils",
+      "docs/COMMITS",
+      "docs/LOGS/ERRORES",
+      "docs/LOGS/ACTIVIDAD",
+      "docs/BACKLOG",
+      "docs/PROMPTS/PLANTILLAS",
+      "docs/PROMPTS/STACK",
+      "scripts"
+    ],
+    "scaffolds": ["prompt-lang.json", "AGENTS.md", ".gitignore", "tailwind.config.js"],
+    "deps": {
+      "base": {
+        "dev": ["typescript", "vite", "@vitejs/plugin-react", "tailwindcss", "@tailwindcss/vite"]
+      },
+      "supabase": { "prod": ["@supabase/supabase-js", "@supabase/ssr"] },
+      "stripe": { "prod": ["@stripe/react-stripe-js", "@stripe/stripe-js"] },
+      "ionic": {
+        "prod": ["@ionic/react", "@ionic/react-router", "@capacitor/core"],
+        "dev": ["@capacitor/cli"]
+      },
+      "tauri": { "dev": ["@tauri-apps/cli"] }
+    },
+    "default_scripts": {
+      "dev:start": "vite",
+      "dev:preview": "vite preview",
+      "build:prod": "vite build",
+      "build:analyze": "vite build --analyze",
+      "lint:check": "eslint src --ext .ts,.tsx",
+      "lint:fix": "eslint src --ext .ts,.tsx --fix",
+      "type:check": "tsc --noEmit",
+      "quality:doctor": "npx react-doctor check ./src",
+      "test:unit": "vitest run",
+      "test:watch": "vitest",
+      "test:coverage": "vitest run --coverage",
+      "validate:all": "npm run lint:check && npm run type:check && npm run quality:doctor && npm run test:unit"
+    }
+  },
+  "vue-nuxt": {
+    "name": "Vue Nuxt 3",
+    "folders": [
+      "composables",
+      "components/ui",
+      "components/layout",
+      "pages",
+      "server/api",
+      "server/utils",
+      "stores",
+      "types",
+      "docs/COMMITS",
+      "docs/LOGS/ERRORES",
+      "docs/BACKLOG"
+    ],
+    "scaffolds": ["prompt-lang.json", "AGENTS.md", ".gitignore"]
+  },
+  "angular": {
+    "name": "Angular Standalone",
+    "folders": [
+      "src/app/services",
+      "src/app/components/shared",
+      "src/app/pages",
+      "src/app/interfaces",
+      "src/app/guards",
+      "src/app/interceptors",
+      "projects",
+      "docs/COMMITS",
+      "docs/BACKLOG"
+    ],
+    "scaffolds": ["prompt-lang.json", "AGENTS.md", ".gitignore"]
+  },
+  "ionic": {
+    "name": "Ionic Capacitor",
+    "folders": [
+      "src/pages",
+      "src/components/ui",
+      "src/services",
+      "src/hooks",
+      "src/store",
+      "src/theme",
+      "android",
+      "ios",
+      "docs/COMMITS",
+      "docs/BACKLOG"
+    ],
+    "scaffolds": ["capacitor.config.ts", "prompt-lang.json", "AGENTS.md", ".gitignore"]
+  },
+  "node-express": {
+    "name": "Node Express API",
+    "folders": [
+      "src/routes",
+      "src/controllers",
+      "src/services",
+      "src/models",
+      "src/middleware",
+      "src/utils",
+      "src/validators",
+      "docs/COMMITS",
+      "docs/BACKLOG",
+      "scripts"
+    ],
+    "scaffolds": ["prompt-lang.json", "AGENTS.md", ".gitignore", "Dockerfile"]
+  },
+  "spring-boot": {
+    "name": "Spring Boot Microservice",
+    "folders": [
+      "src/main/java/com/app/controller",
+      "src/main/java/com/app/service",
+      "src/main/java/com/app/repository",
+      "src/main/java/com/app/model/entity",
+      "src/main/java/com/app/model/dto",
+      "src/main/java/com/app/config",
+      "src/main/java/com/app/exception",
+      "src/main/resources",
+      "src/test/java/com/app",
+      "docs/COMMITS",
+      "docs/BACKLOG"
+    ],
+    "scaffolds": ["prompt-lang.json", "AGENTS.md", ".gitignore", "Dockerfile"]
+  },
+  "python-fastapi": {
+    "name": "Python FastAPI",
+    "folders": [
+      "app/routes",
+      "app/services",
+      "app/models",
+      "app/schemas",
+      "app/core",
+      "tests",
+      "docs/COMMITS",
+      "docs/BACKLOG"
+    ],
+    "scaffolds": ["prompt-lang.json", "AGENTS.md", ".gitignore", "Dockerfile"]
+  }
+}