openprompt-lang 0.3.0

package/bin/cli.js

@@ -0,0 +1,110 @@
+#!/usr/bin/env node
+
+import { Command } from "commander";
+import chalk from "chalk";
+import { readFileSync, existsSync } from "fs";
+import { join, dirname } from "path";
+import { fileURLToPath } from "url";
+import { createRequire } from "module";
+
+const __dirname = dirname(fileURLToPath(import.meta.url));
+const require = createRequire(import.meta.url);
+const pkg = JSON.parse(readFileSync(join(__dirname, "..", "package.json"), "utf-8"));
+
+const program = new Command();
+
+program
+  .name("openPrompt-Lang")
+  .description(chalk.cyan("Framework de anotaciones para desarrollo asistido por IA"))
+  .version(pkg.version);
+
+program
+  .command("init")
+  .description("Inicializar proyecto con estructura PromptLang")
+  .option("--name <name>", "Nombre del proyecto")
+  .option("--describe <text>", "Descripción del proyecto para sugerencia IA")
+  .option("--existing", "Configurar en proyecto existente (solo archivos de configuración)")
+  .action(async (options) => {
+    const { init } = await import("../src/commands/init.js");
+    await init(options);
+  });
+
+program
+  .command("figma")
+  .description("Generar prompt para diseño en Figma con convenciones React + Tailwind")
+  .action(async () => {
+    const { figma } = await import("../src/commands/figma.js");
+    await figma();
+  });
+
+program
+  .command("context")
+  .description("Extraer contexto del proyecto para la IA")
+  .option("--output <file>", "Archivo de salida", "contexto.md")
+  .option("--scope <module>", "Filtrar por módulo (@scope)")
+  .option("--no-ai", "No incluir anotaciones PromptLang en el output")
+  .action(async (options) => {
+    const { context } = await import("../src/commands/context.js");
+    await context(options);
+  });
+
+program
+  .command("validate")
+  .description("Ejecutar pipeline de validación y verificar anotaciones")
+  .option("--fix", "Auto-corregir errores cuando sea posible")
+  .action(async (options) => {
+    const { validate } = await import("../src/commands/validate.js");
+    await validate(options);
+  });
+
+program
+  .command("suggest")
+  .description("IA sugiere estructura/stack según descripción del proyecto")
+  .argument("<description>", "Descripción del proyecto")
+  .action(async (description) => {
+    const { suggest } = await import("../src/commands/suggest.js");
+    await suggest(description);
+  });
+
+const component = program
+  .command("component")
+  .description("Gestionar biblioteca de componentes reutilizables");
+
+component
+  .command("list")
+  .description("Listar componentes disponibles")
+  .option("--library <path>", "Ruta a la biblioteca de componentes")
+  .action(async (options) => {
+    const { componentList } = await import("../src/commands/component.js");
+    await componentList(options);
+  });
+
+component
+  .command("add <name>")
+  .description("Agregar componente de la biblioteca al proyecto")
+  .option("--library <path>", "Ruta a la biblioteca de componentes")
+  .action(async (name, options) => {
+    const { componentAdd } = await import("../src/commands/component.js");
+    await componentAdd(name, options);
+  });
+
+component
+  .command("init")
+  .description("Inicializar una biblioteca de componentes")
+  .option("--library <path>", "Ruta donde crear la biblioteca")
+  .option("--name <name>", "Nombre de la biblioteca")
+  .action(async (options) => {
+    const { componentInit } = await import("../src/commands/component.js");
+    await componentInit(options);
+  });
+
+component
+  .command("manifest")
+  .description("Mostrar el manifiesto de la biblioteca de componentes")
+  .option("--library <path>", "Ruta a la biblioteca de componentes")
+  .action(async (options) => {
+    const { componentManifest } = await import("../src/commands/component.js");
+    await componentManifest(options);
+  });
+
+program.parse(process.argv);

package/bin/lint.js

@@ -0,0 +1,50 @@
+#!/usr/bin/env node
+
+import { readFileSync, existsSync } from "fs";
+import { join } from "path";
+import { loadConfig } from "../src/utils/config.js";
+import { lintFile } from "../src/utils/annotations.js";
+import chalk from "chalk";
+
+const targetFile = join(process.cwd(), process.argv[2] || "");
+
+if (!targetFile || !existsSync(targetFile)) {
+  console.log(chalk.red("❌ Archivo no encontrado"));
+  console.log("Uso: node bin/lint.js <archivo>");
+  process.exit(1);
+}
+
+const content = readFileSync(targetFile, "utf-8");
+const { annotations, errors, warnings } = lintFile(content);
+
+if (annotations.length === 0) {
+  console.log(chalk.cyan("📭 Sin anotaciones PromptLang en este archivo"));
+  process.exit(0);
+}
+
+console.log(chalk.cyan(`\n🔍 Anotaciones encontradas: ${annotations.length}\n`));
+
+for (const ann of annotations) {
+  const argsStr = ann.args.length
+    ? ann.args.map((a) => (a.key ? `${a.key}: ${a.value}` : a.value)).join(", ")
+    : "";
+  console.log(`  @${ann.name}${argsStr ? `(${argsStr})` : ""}`);
+}
+
+if (errors.length > 0) {
+  console.log(chalk.red(`\n❌ Errores (${errors.length}):\n`));
+  for (const err of errors) {
+    console.log(chalk.red(`  • ${err}`));
+  }
+}
+
+if (warnings.length > 0) {
+  console.log(chalk.yellow(`\n⚠️  Advertencias (${warnings.length}):\n`));
+  for (const warn of warnings) {
+    console.log(chalk.yellow(`  • ${warn}`));
+  }
+}
+
+if (errors.length === 0 && warnings.length === 0) {
+  console.log(chalk.green("\n✅ Todas las anotaciones válidas\n"));
+}

package/docs/COMMANDS.md

@@ -0,0 +1,229 @@
+# openPrompt-Lang — Comandos CLI
+
+> **Versión:** 0.1.0
+
+---
+
+## Instalación
+
+```bash
+npm install -g openprompt-lang
+# o
+npx openprompt-lang <comando>
+```
+
+---
+
+## Comandos
+
+### `init` — Inicializar proyecto
+
+Crea la estructura base del proyecto con configuración openPrompt-Lang, incluyendo un `package.json` con scripts descriptivos.
+
+```bash
+npx openPrompt-Lang init [--name nombre] [--describe "descripción"]
+```
+
+**Opciones:**
+- `--name <nombre>` — Nombre del proyecto (default: mi-proyecto)
+- `--describe <texto>` — Descripción para sugerencia de stack vía IA
+
+**Ejemplo interactivo:**
+```bash
+npx openPrompt-Lang init
+# ? Project name: mi-app
+# ? Use AI to suggest stack? Yes
+# → Crea: package.json (scripts descriptivos), prompt-lang.json, AGENTS.md, docs/, scripts/, estructura src/
+```
+
+**Scripts descriptivos generados:**
+
+| Script | Comando real | Propósito |
+|---|---|---|
+| `dev:start` | `vite` | Iniciar servidor de desarrollo |
+| `dev:preview` | `vite preview` | Vista previa del build |
+| `build:prod` | `vite build` | Build para producción |
+| `build:analyze` | `vite build --analyze` | Build con análisis de bundle |
+| `lint:check` | `eslint src --ext .ts,.tsx` | Verificar lint |
+| `lint:fix` | `eslint src --ext .ts,.tsx --fix` | Auto-corregir lint |
+| `type:check` | `tsc --noEmit` | Verificar tipos TypeScript |
+| `quality:doctor` | `npx react-doctor check ./src` | Auditoría React |
+| `test:unit` | `vitest run` | Ejecutar tests unitarios |
+| `test:watch` | `vitest` | Tests en modo watch |
+| `test:coverage` | `vitest run --coverage` | Tests con cobertura |
+| `validate:all` | lint + typecheck + doctor + test | Pipeline completo
+
+### `context` — Extraer contexto para IA
+
+Genera un archivo markdown con todo el código del proyecto para dar contexto a la IA.
+
+```bash
+npx openPrompt-Lang context [--output contexto.md] [--scope auth]
+```
+
+**Opciones:**
+- `--output <archivo>` — Archivo de salida (default: contexto.md)
+- `--scope <módulo>` — Filtrar por módulo (@scope)
+- `--no-ai` — No incluir anotaciones PromptLang
+
+### `figma` — Generar prompt para Figma
+
+Genera un prompt listo para copiar-pegar en herramientas de diseño Figma.
+
+```bash
+npx openPrompt-Lang figma
+# ? Tipo: Dashboard SaaS
+# ? Pantallas: Login, Dashboard, Products
+# ? Mobile-first: Yes
+# → docs/PROMPTS/figma-prompt.md
+```
+
+### `validate` — Validar proyecto
+
+Ejecuta el pipeline de validación y verifica anotaciones PromptLang.
+
+```bash
+npx openPrompt-Lang validate [--fix]
+```
+
+**Opciones:**
+- `--fix` — Auto-corregir errores cuando sea posible
+
+### `suggest` — Sugerir stack y estructura
+
+Analiza una descripción y sugiere stack, módulos y prioridades.
+
+```bash
+npx openPrompt-Lang suggest "App de inventario con acceso mobile y dashboard"
+```
+
+### `component` — Gestionar biblioteca de componentes
+
+Gestiona componentes reutilizables desde una biblioteca externa.
+
+```bash
+# Inicializar una biblioteca de componentes
+npx openPrompt-Lang component init --library ./diseno-componentes
+
+# Listar componentes disponibles (proyecto + biblioteca)
+npx openPrompt-Lang component list
+
+# Agregar un componente de la biblioteca al proyecto
+npx openPrompt-Lang component add ConfirmModal
+
+# Ver el manifiesto de la biblioteca
+npx openPrompt-Lang component manifest
+
+# Usar --library si no está configurado en prompt-lang.json
+npx openPrompt-Lang component list --library ./diseno-componentes
+```
+
+**Estructura de la biblioteca:**
+
+```
+diseno-componentes/
+├── componentes.json      ← Manifiesto con nombre, versión, lista de componentes
+├── ui/
+│   ├── Button.tsx        ← Botón con variantes (primary, danger, ghost)
+│   ├── ConfirmModal.tsx  ← Modal centrado para acciones destructivas
+│   ├── Input.tsx         ← Input con label y error
+│   └── index.ts          ← Barrel export
+└── layouts/              ← Layouts reutilizables
+```
+
+**Configuración en prompt-lang.json:**
+```json
+{
+  "components": {
+    "source": "src/components/ui",
+    "library": "./diseno-componentes"
+  }
+}
+```
+
+---
+
+## Configuración (prompt-lang.json)
+
+```json
+{
+  "name": "mi-app",
+  "version": "0.1.0",
+  "stack": {
+    "base": ["react", "typescript", "vite", "tailwind"],
+    "extensions": ["supabase"]
+  },
+  "profile": "senior",
+  "pipeline": {
+    "pre-commit": ["lint", "typecheck", "doctor", "test"],
+    "scripts": {
+      "lint:check": "eslint src --ext .ts,.tsx",
+      "type:check": "tsc --noEmit",
+      "quality:doctor": "npx react-doctor check ./src",
+      "test:unit": "vitest run"
+    }
+  },
+  "annotations": { "enabled": true, "strict": false },
+  "docs": { "commits": true, "logs": true, "backlog": true },
+  "extractor": {
+    "ignore": [".env", "*.local", "dist"],
+    "output": "contexto.md"
+  }
+}
+```
+
+---
+
+## Pipeline de Validación
+
+```bash
+npx openPrompt-Lang validate
+# → 1. Verifica estructura del proyecto
+# → 2. Valida prompt-lang.json y AGENTS.md
+# → 3. Analiza anotaciones PromptLang en archivos
+# → 4. Ejecuta pipeline configurado (lint:check → type:check → quality:doctor → test:unit)
+# → 5. Reporta resumen
+```
+
+---
+
+## Linting de Anotaciones (por archivo)
+
+```bash
+npx openPrompt-Lang lint src/hooks/useAuth.ts
+# → Muestra anotaciones encontradas
+# → Reporta errores y warnings
+```
+
+---
+
+## Variables de Entorno
+
+| Variable | Propósito |
+|---|---|---|
+| `OPENAI_API_KEY` | API key de OpenAI para sugerencias IA |
+| `OPENPROMPT_API_KEY` | API key alternativa para openPrompt-Lang |
+
+---
+
+## VS Code Extension
+
+El paquete incluye una extensión para VS Code en `vscode-extension/`:
+
+- **Syntax highlighting**: todos los tags PromptLang (`@kind`, `@props`, `@contract`, etc.) se resaltan en comentarios de TypeScript/JavaScript
+- **Snippets**: prefijo `@kind-` para insertar estructuras completas:
+  - `@kind-hook` → hook con `@contract`
+  - `@kind-component` → componente con `@props`
+  - `@kind-service` → servicio con `@contract` + `@platform`
+  - `@kind-page` → página con `@compose`
+  - `@kind-store` → store Zustand
+  - `@use-header` → declaración `@use()`
+  - `@props-ts` → props con sintaxis tipo TypeScript
+- **Instalación**:
+  ```bash
+  # Desde el proyecto
+  code --install-extension vscode-extension/
+
+  # O empaquetar como .vsix
+  cd vscode-extension && npx @vscode/vsce package && code --install-extension *.vsix
+  ```

package/docs/COMMITS/INDEX.md

@@ -0,0 +1,11 @@
+# Índice de Commits
+
+| Fecha | Versión | Descripción |
+|---|---|---|
+| 2026-05-14 | v0.1.0 | feat: reescribir parser de anotaciones, agregar tests, documentación y scaffolding |
+| 2026-05-14 | v0.1.0 | feat: agregar modo --existing para proyectos ya iniciados |
+| 2026-05-14 | v0.1.0 | docs: expandir README con directorio de anotaciones, tutoriales y referencia |
+| 2026-05-14 | v0.2.0 | feat: strict por defecto, validación stack, convenciones DB, 7 templates PROMPTS |
+| 2026-05-14 | v0.3.0 | feat: versionado SemVer, sistema de componentes, preparar npm publish |
+| 2026-05-15 | v0.3.0 | fix: eliminar dependencia glob no usada |
+| 2026-05-15 | v0.3.0 | fix: parser paréntesis anidados, @props TS-like, @state(error) condicional, VS Code extension |

package/docs/COMMITS/v0.1.0-existing.md

@@ -0,0 +1,31 @@
+## [v0.1.0] - 2026-05-14
+
+### Commit: feat(init): agregar modo --existing para proyectos ya iniciados
+**Hash:** 6f80759b2f3a23c8d1423346d57bc1c0b9a641b8
+**Fecha:** 2026-05-14
+**Módulo:** init
+**Versión:** v0.1.0
+
+#### Cambios realizados
+- Se creó modo `--existing` en `init`: detecta stack real del proyecto, configura solo archivos necesarios sin scaffolding
+- Se agregó `DESCRIPTIVE_SCRIPTS` como constante compartida para reutilizar en ambos modos
+- Se registró flag `--existing` en `bin/cli.js`
+- En modo existing: crea `prompt-lang.json` con stack detectado, `AGENTS.md` contextual
+- Pregunta interactiva: agregar scripts descriptivos al `package.json` existente (merge sin sobreescribir)
+- Pregunta interactiva: crear `docs/BACKLOG`, `docs/COMMITS`, `docs/LOGS`
+- Salta archivos que ya existen (no sobreescribe)
+
+#### Archivos modificados
+- `src/commands/init.js` (+171/-15 líneas)
+- `bin/cli.js` (+1 línea)
+
+#### Criterios de aceptación cumplidos
+- [x] `openPrompt-Lang init --existing` desde proyecto existente configura solo prompt-lang.json + AGENTS.md
+- [x] Stack detectado automáticamente (React, Vite, Tailwind, etc.)
+- [x] Scripts descriptivos se mergean sin romper scripts existentes
+- [x] Docs opcionales (backlog, commits, logs)
+- [x] `openPrompt-Lang init --name x` sin cambios (modo nuevo proyecto)
+
+#### Notas
+- Uso: `cd mi-proyecto && openPrompt-Lang init --existing`
+- No requiere `--name` porque detecta nombre desde package.json

package/docs/COMMITS/v0.1.0-inicial.md

@@ -0,0 +1,50 @@
+## [v0.1.0] - 2026-05-14
+
+### Commit: feat(core): reescribir parser de anotaciones, agregar tests, documentación y scaffolding
+**Hash:** 36d89bad34df06abc6aaab90fefbdf6513906668
+**Fecha:** 2026-05-14
+**Módulo:** core
+**Versión:** v0.1.0
+
+#### Cambios realizados
+- Se reescribió `parseArgs` en annotations.js con `splitRespectingBrackets` para manejar correctamente listas anidadas con corchetes
+- Se corrigió el parser multiline `/* */` para detectar bloques aunque la primera línea no contenga `@`
+- Se agregaron 65 tests con vitest (annotations + config) cubriendo parser, validador, edge cases
+- Se creó `docs/DEPENDENCIES.md` con todas las dependencias, versiones instaladas y propósito
+- Se copió `docs/FRAMEWORK.md` + `docs/referencia-metodologia/` (17 archivos de la metodología original)
+- Se expandió `init.js`: ahora genera `package.json` con 12 scripts descriptivos (`dev:start`, `build:prod`, `lint:check`, `type:check`, `quality:doctor`, `test:unit`, `validate:all`, etc.)
+- Se actualizó `scripts/validate.sh` para usar los nuevos nombres descriptivos
+- Se corrigió `package.json`: `devDependencies` duplicado eliminado (vitest unificado en ^4.1.6)
+- Se actualizó `AGENTS.md` generado para referenciar `validate:all` y `docs/FRAMEWORK.md`
+- Se reescribió `README.md` con instalación local, tabla de comandos y estructura del proyecto
+- Se expandió `docs/COMMANDS.md` con documentación de scripts descriptivos y config actualizada
+- Se configuró `npm prefix` a `~/.npm-global/` para instalación global sin root
+
+#### Archivos modificados
+- `src/utils/annotations.js` (+407/-136 líneas)
+- `src/commands/init.js` (+49/-11 líneas)
+- `README.md` (+79/-3 líneas)
+- `docs/COMMANDS.md` (+31/-13 líneas)
+- `package.json` (+11/-9 líneas)
+- `bin/cli.js` (sin cambios funcionales)
+
+#### Archivos nuevos
+- `tests/annotations.test.js` (~65 tests)
+- `tests/config.test.js`
+- `vitest.config.js`
+- `docs/DEPENDENCIES.md`
+- `docs/FRAMEWORK.md`
+- `docs/referencia-metodologia/` (17 archivos de metodología)
+- `docs/COMMITS/INDEX.md`
+- `package-lock.json`
+
+#### Criterios de aceptación cumplidos
+- [x] `parseArgs` maneja correctamente listas con corchetes: `@external: [supabase, zod]` no parte en comas internas
+- [x] Parser multiline detecta `/*` sin `@` en primera línea
+- [x] 65 tests pasan en vitest
+- [x] init genera `package.json` con scripts descriptivos y `validate.sh` actualizado
+- [x] Documentación completa en docs/ con dependencias, framework y metodología
+
+#### Notas
+- CLI instalable globalmente via `npm install -g ./openPrompt-Lang` con prefix de usuario
+- `openPrompt-Lang` aun no publicado en npm registry

package/docs/COMMITS/v0.1.0-readme.md

@@ -0,0 +1,24 @@
+## [v0.1.0] - 2026-05-14
+
+### Commit: docs(readme): expandir con directorio de anotaciones, tutoriales y referencia completa
+**Hash:** 6223f76
+**Fecha:** 2026-05-14
+**Módulo:** docs
+**Versión:** v0.1.0
+
+#### Cambios realizados
+- Se reescribió README.md con catálogo completo de todos los tags PromptLang (@kind, @contract, @props, @limit, @deps, @platform, @scope, @state, @test, @meta, @forbidden, @compose, @pattern)
+- Tutorial "Empezar desde 0": init → Vite → anotar hook → validar → contexto IA
+- Tutorial "Refactorizar proyecto existente": --existing → anotar → validar → filtrar scope → IA
+- Matriz de validación cruzada kind×contract×props×state×compose
+- Configuración prompt-lang.json documentada campo por campo
+- Scripts descriptivos, estructura del proyecto, enlaces a documentación
+
+#### Archivos modificados
+- `README.md` (+467/-42 líneas)
+
+#### Criterios de aceptación cumplidos
+- [x] README incluye directorio completo de anotaciones con sintaxis y ejemplos
+- [x] README incluye tutorial práctico para empezar desde 0
+- [x] README incluye tutorial práctico para refactorizar existente
+- [x] README incluye validación cruzada, configuración y scripts descriptivos

package/docs/COMMITS/v0.2.0-strict-db-templates.md

@@ -0,0 +1,50 @@
+## [v0.2.0] - 2026-05-14
+
+### Commit: feat(strict, stack, docs): strict por defecto, validación stack, convenciones DB y 7 templates PROMPTS
+**Hash:** 3e02b788b5646cbb2bddec2606500afe4831e5dc
+**Fecha:** 2026-05-14
+**Módulo:** core + docs
+**Versión:** v0.2.0
+
+#### Cambios realizados
+- `config.js`: strict default cambiado de `false` a `true`
+- `annotations.js`: lintFile ahora acepta parámetro `strict` que eleva warnings a errores
+- `init.js`: ambos modos generan config con `strict: true`
+- `validate.js`: pasa `config.annotations.strict` a lintFile; agrega validación de coherencia stack (tauri en base sin extensions → error; @platform mobile/desktop sin stack correspondiente → warning)
+- `CONVENCIONES_DB.md`: 18 prácticas de base de datos priorizadas (RLS, keyset, índices, signed URLs, batch, errores por código, soft delete, etc.) con ejemplos correcto/incorrecto
+- `CONVENCIONES_DOCUMENTACION.md`: estándar de documentación para tablas DB (formato markdown + atributos + RLS + índices), diagramas Mermaid (árbol de componentes, secuencia de datos, ER), contratos RPC, integración con fases de la metodología
+- 7 nuevos templates PROMPTS (11-supabase-crud-service, 12-supabase-hook-usetable, 13-tauri-command-rust, 14-tauri-wrapper-typescript, 15-documentar-tabla-db, 16-diagrama-arquitectura, 17-documentar-api-rpc)
+- INDEX.md actualizado con +7 entradas y referencia a convenciones DB/documentación
+
+#### Archivos modificados
+- `src/utils/config.js` (+1/-1)
+- `src/utils/annotations.js` (+14/-6)
+- `src/commands/init.js` (+1/-1)
+- `src/commands/validate.js` (+38/-4)
+- `docs/.../PROMPTS/INDEX.md` (+10/-1)
+
+#### Archivos nuevos
+- `docs/.../CONVENCIONES_DB.md` (18 prácticas DB)
+- `docs/.../CONVENCIONES_DOCUMENTACION.md` (estándar documentación + diagramas)
+- `docs/.../PLANTILLAS/11-supabase-crud-service.md`
+- `docs/.../PLANTILLAS/12-supabase-hook-usetable.md`
+- `docs/.../PLANTILLAS/13-tauri-command-rust.md`
+- `docs/.../PLANTILLAS/14-tauri-wrapper-typescript.md`
+- `docs/.../PLANTILLAS/15-documentar-tabla-db.md`
+- `docs/.../PLANTILLAS/16-diagrama-arquitectura.md`
+- `docs/.../PLANTILLAS/17-documentar-api-rpc.md`
+
+#### Criterios de aceptación cumplidos
+- [x] strict=true por defecto en config y comandos init
+- [x] lintFile con strict eleva warnings a errores
+- [x] validate.js valida stack.base vs stack.extensions
+- [x] validate.js cruza @platform en código con stack configurado
+- [x] CONVENCIONES_DB.md con 18 prácticas + ejemplos correcto/incorrecto
+- [x] CONVENCIONES_DOCUMENTACION.md con formato tablas DB, Mermaid, RPC contracts
+- [x] 7 templates PROMPTS con reglas estrictas y anti-patrones integrando DB best practices
+- [x] 65 tests pasan
+
+#### Notas
+- Versión bump a v0.2.0 por cambios en comportamiento default (strict)
+- DB practices seleccionadas de las 50 priorizadas por impacto directo en React/Supabase
+- Documentación Mermaid lista para renderizar en GitHub

package/docs/COMMITS/v0.3.0-parser-fixes-vscode.md

@@ -0,0 +1,67 @@
+# v0.3.0 — Parser fixes, component library, VS Code extension, npm publish prep
+
+**Hash:** 539735e0c395a4c5c4c5c14c81685d163475fe37  
+**Fecha:** 2026-05-13  
+**Bump:** MINOR (nuevas features + fixes)
+
+## Resumen
+
+Versión enfocada en robustez del parser, sistema de componentes reutilizables y preparación para npm publish. Se corrigieron 3 bugs de validación que causaban falsos positivos.
+
+## Cambios
+
+### Bugfixes
+
+- **parseTags**: nuevo parser con depth-counting para paréntesis anidados.  
+  El regex `/\(([^)]*)\)/` se rompía con `@contract(in: X -> out: { count: number, fn: () => void } @error: never)` porque `[^)]*` paraba en el primer `)` interno.  
+  El nuevo parser manual cuenta profundidad de paréntesis.  
+  *Efecto colateral: `@error` ya no aparece como tag separado (no requiere `@use(error)`).*
+
+- **parseArgs**: fallback `parseTsObject` para `@props` con sintaxis TypeScript.  
+  Antes: `@props({ name: string })` → error "no es un JSON válido".  
+  Ahora: se intenta JSON.parse → falla → se parsea como `{ key: type, key?: type }`.
+
+- **validateAnnotations**: `@state(error)` ahora solo requiere `@contract` en `hook`/`service`.  
+  Antes: cualquier `@state(error)` sin `@contract` daba warning (falso positivo en component/page).
+
+### Nuevas features
+
+- **Sistema de biblioteca de componentes**:
+  - `component init` — crea biblioteca con Button, ConfirmModal, Input
+  - `component list` — lista componentes del proyecto + biblioteca
+  - `component add <name>` — copia componente al proyecto
+  - `component manifest` — muestra el manifiesto `componentes.json`
+  - Configurable en `prompt-lang.json` → `components.library`
+
+- **VS Code Extension** (`vscode-extension/`):
+  - TextMate grammar injection para highlighting en comentarios TS/JS
+  - 7 snippets con prefijo `@kind-` (hook, component, service, page, store, use-header, props-ts)
+  - Incluida en el paquete npm
+
+- **Versionado SemVer**: `docs/VERSIONING.md` con tabla de decisión MAJOR/MINOR/PATCH
+
+- **npm publish prep**:
+  - `package.json`: `type: module`, `main`, `prepublishOnly: npm test`
+  - `LICENSE` MIT
+  - `README`: instalación Windows (PowerShell), guía npm publish, tabla versionado
+
+## Archivos modificados (11)
+
+- `src/utils/annotations.js` — parseTags reescrito, parseTsObject añadido, @state(error) condicional
+- `tests/annotations.test.js` — 2 tests nuevos, 2 actualizados
+- `package.json` — type:module, files incluye vscode-extension, glob eliminado
+- `README.md` — Windows install, npm publish, @props JSON fix en ejemplos
+- `docs/COMMANDS.md` — VS Code Extension section
+- `docs/DEPENDENCIES.md` — glob eliminado
+- `.gitignore` — *.tgz añadido
+
+## Archivos nuevos (7)
+
+- `vscode-extension/` — package.json, README.md, language-configuration.json, snippets/promptlang.json, syntaxes/annotations.tmGrammar.json, syntaxes/promptlang.tmGrammar.json
+- `LICENSE` — MIT
+
+## Tests
+
+- 67 tests (2 nuevos, 65 existentes)
+- Todos pasan en 325ms
+- 0 vulnerabilities en npm audit

package/docs/COMMITS/v0.3.0-versioning-component.md

@@ -0,0 +1,44 @@
+## [v0.3.0] - 2026-05-14
+
+### Commit: feat(versioning, component): agregar convención SemVer y sistema de biblioteca de componentes
+**Hash:** 110b1885b9e9f87834df110a8bc5dadfbe03a3b6
+**Fecha:** 2026-05-14
+**Módulo:** core + docs
+**Versión:** v0.3.0
+**Bump:** MINOR
+
+#### Cambios realizados
+- `VERSIONING.md`: convención completa de versionado SemVer (MAJOR/MINOR/PATCH), pre-release (alpha/beta/RC), tabla de decisión por tipo de commit, integración con commit log
+- `src/commands/component.js`: nuevo comando con 4 subcomandos (init, list, add, manifest)
+- `bin/cli.js`: registro del comando `component` con subcomandos
+- `init.js`: ambos modos generan config con sección `components.source` y `components.library`
+- Componentes por defecto en `component init`: Button (variants: primary/secondary/danger/ghost), ConfirmModal (modal centrado + teclado), Input (con label + error)
+- `docs/COMMANDS.md`: documentación del comando component
+- `README.md`: sección de sistema de componentes + referencia a VERSIONING.md
+- `docs/COMMITS/INDEX.md`: columna Bump agregada
+
+#### Archivos modificados
+- `bin/cli.js` (+30 líneas)
+- `src/commands/init.js` (+4/-2)
+- `docs/COMMANDS.md` (+25/-1)
+- `README.md` (+14/-4)
+- `docs/COMMITS/INDEX.md` (+2/-1)
+
+#### Archivos nuevos
+- `docs/VERSIONING.md` (convención SemVer completa)
+- `src/commands/component.js` (comando de componentes)
+- `docs/COMMITS/v0.3.0-versioning-component.md`
+
+#### Criterios de aceptación cumplidos
+- [x] VERSIONING.md define MAJOR/MINOR/PATCH, pre-release, y cuándo bump
+- [x] `openPrompt-Lang component init` crea biblioteca con Button, ConfirmModal, Input
+- [x] `openPrompt-Lang component list` muestra proyecto + biblioteca
+- [x] `openPrompt-Lang component add ConfirmModal` copia al proyecto
+- [x] `openPrompt-Lang component manifest` muestra el manifiesto
+- [x] Config components en prompt-lang.json en ambos modos init
+- [x] 65 tests pasan
+
+#### Notas
+- Versión bump a v0.3.0 por feat (nuevo comando component)
+- Los componentes incluyen UX patterns clave: ConfirmModal para acciones destructivas, variant danger en Button
+- La biblioteca se conecta vía `components.library` en prompt-lang.json