openprompt-lang 0.3.0

package/src/utils/config.js

@@ -0,0 +1,60 @@
+import { readFileSync, existsSync } from "fs";
+import { join } from "path";
+
+const CONFIG_FILE = "prompt-lang.json";
+
+export function loadConfig(dir = process.cwd()) {
+  const configPath = join(dir, CONFIG_FILE);
+  if (!existsSync(configPath)) {
+    return getDefaultConfig();
+  }
+  try {
+    const raw = readFileSync(configPath, "utf-8");
+    return { ...getDefaultConfig(), ...JSON.parse(raw) };
+  } catch {
+    console.warn("⚠️  Error leyendo prompt-lang.json. Usando defaults.");
+    return getDefaultConfig();
+  }
+}
+
+export function getDefaultConfig() {
+  return {
+    name: "mi-proyecto",
+    version: "0.1.0",
+    stack: {
+      base: ["react", "typescript", "vite", "tailwind"],
+      extensions: [],
+    },
+    profile: "senior",
+    pipeline: {
+      "pre-commit": ["lint", "typecheck"],
+      scripts: {},
+    },
+    annotations: {
+      enabled: true,
+      strict: true,
+    },
+    docs: {
+      commits: true,
+      logs: true,
+      backlog: true,
+    },
+    extractor: {
+      ignore: [".env", "*.local", "dist"],
+      output: "contexto.md",
+    },
+  };
+}
+
+export function detectStack(dir = process.cwd()) {
+  const has = (file) => existsSync(join(dir, file));
+  return {
+    react: has("package.json") && existsSync(join(dir, "src", "App.tsx")),
+    vite: has("vite.config.ts"),
+    tailwind: has("tailwind.config.ts") || has("tailwind.config.js"),
+    ionic: has("ionic.config.json"),
+    tauri: has("src-tauri"),
+    supabase: has("supabase") || has("supabase-config.ts"),
+    typescript: has("tsconfig.json"),
+  };
+}

package/vscode-extension/README.md

@@ -0,0 +1,31 @@
+# openPrompt-Lang — VS Code Extension
+
+Syntax highlighting, snippets y detección de anotaciones PromptLang en tiempo real.
+
+## Features
+
+- **Syntax highlighting**: `@kind`, `@props`, `@contract`, `@use` y todos los tags PromptLang se resaltan en comentarios de TypeScript/JavaScript
+- **Snippets**: prefijos `@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
+
+## Installation
+
+```bash
+# Desde el código fuente
+cd vscode-extension
+npm install -g @vscode/vsce
+vsce package
+code --install-extension openprompt-lang-*.vsix
+```
+
+O copia la carpeta `vscode-extension/` a `~/.vscode/extensions/`.
+
+## Usage
+
+Escribe `@kind-` en cualquier archivo `.ts` o `.tsx` y selecciona un snippet del autocompletado. Los tags se resaltarán automáticamente en los comentarios.

package/vscode-extension/language-configuration.json

@@ -0,0 +1,7 @@
+{
+  "comments": {
+    "lineComment": "//",
+    "blockComment": ["/*", "*/"]
+  },
+  "brackets": [["{", "}"]]
+}

package/vscode-extension/package.json

@@ -0,0 +1,62 @@
+{
+  "name": "openprompt-lang",
+  "displayName": "openPrompt-Lang",
+  "description": "Syntax highlighting, snippets y validación en vivo para anotaciones PromptLang",
+  "version": "0.3.0",
+  "publisher": "openprompt-lang",
+  "license": "MIT",
+  "engines": {
+    "vscode": "^1.85.0"
+  },
+  "categories": [
+    "Programming Languages",
+    "Snippets",
+    "Formatters"
+  ],
+  "keywords": [
+    "prompt-lang",
+    "openprompt",
+    "annotations",
+    "ai",
+    "react"
+  ],
+  "icon": "icon.png",
+  "contributes": {
+    "languages": [
+      {
+        "id": "promptlang",
+        "aliases": ["PromptLang", "promptlang"],
+        "configuration": "./language-configuration.json"
+      }
+    ],
+    "grammars": [
+      {
+        "language": "promptlang",
+        "scopeName": "source.promptlang",
+        "path": "./syntaxes/promptlang.tmGrammar.json",
+        "embeddedLanguages": {
+          "source.ts": "typescript",
+          "source.tsx": "typescriptreact"
+        }
+      },
+      {
+        "scopeName": "markup.promptlang.comments",
+        "path": "./syntaxes/annotations.tmGrammar.json",
+        "injectTo": ["source.ts", "source.tsx", "source.js", "source.jsx"],
+        "embeddedLanguages": {
+          "meta.annotation.promptlang": "promptlang"
+        }
+      }
+    ],
+    "snippets": [
+      {
+        "language": "typescript",
+        "path": "./snippets/promptlang.json"
+      },
+      {
+        "language": "typescriptreact",
+        "path": "./snippets/promptlang.json"
+      }
+    ]
+  }
+}

package/vscode-extension/snippets/promptlang.json

@@ -0,0 +1,105 @@
+{
+  "PromptLang: Add @kind hook": {
+    "prefix": "@kind-hook",
+    "body": [
+      "// @use(kind, contract, limit, deps)",
+      "// @kind(hook)",
+      "// @limit(lines: 60)",
+      "// @contract(in: ${1:input} -> out: ${2:output} @error: ${3:Error})",
+      "// @deps(@external: [${4:react}])",
+      "",
+      "export function use${5:Name}(${1:input}: ${6:string}) {",
+      "  return ${2:output}",
+      "}"
+    ],
+    "description": "Add annotations for a custom hook"
+  },
+  "PromptLang: Add @kind component": {
+    "prefix": "@kind-component",
+    "body": [
+      "// @use(kind, props, state, limit, pattern)",
+      "// @kind(component)",
+      "// @props({ ${1:prop}: \"${2:string}\" })",
+      "// @state(idle${3:, loading, error})",
+      "// @limit(lines: 80)",
+      "// @pattern(composition)",
+      "",
+      "interface ${TM_FILENAME_BASE/(.*)/${1:/pascalcase}/}Props {",
+      "  ${1:prop}: ${2:string}",
+      "}",
+      "",
+      "export function ${TM_FILENAME_BASE}(${4:{ ${1:prop} }: ${TM_FILENAME_BASE/(.*)/${1:/pascalcase}/}Props}) {",
+      "  return <div>{${1:prop}}</div>",
+      "}"
+    ],
+    "description": "Add annotations for a UI component"
+  },
+  "PromptLang: Add @kind service": {
+    "prefix": "@kind-service",
+    "body": [
+      "// @use(kind, contract, limit, deps, platform)",
+      "// @kind(service)",
+      "// @limit(lines: 100)",
+      "// @contract(in: ${1:input} -> out: ${2:output} @error: ${3:Error})",
+      "// @deps(@external: [${4:supabase}])",
+      "// @platform(web)",
+      "",
+      "export async function ${1:fetchData}() {",
+      "  // ...",
+      "}"
+    ],
+    "description": "Add annotations for a service"
+  },
+  "PromptLang: Add @kind page": {
+    "prefix": "@kind-page",
+    "body": [
+      "// @use(kind, compose, limit, state, deps)",
+      "// @kind(page)",
+      "// @compose(${1:ComponentA}, ${2:ComponentB})",
+      "// @state(loading, empty, error, success)",
+      "// @limit(lines: 150)",
+      "",
+      "export function ${TM_FILENAME_BASE}() {",
+      "  return <div>${TM_FILENAME_BASE}</div>",
+      "}"
+    ],
+    "description": "Add annotations for a page"
+  },
+  "PromptLang: Add @kind store": {
+    "prefix": "@kind-store",
+    "body": [
+      "// @use(kind, limit, deps, scope, meta)",
+      "// @kind(store)",
+      "// @limit(lines: 60)",
+      "// @deps(@external: [zustand])",
+      "// @scope(module: ${1:app}, affects: [], breaking: false)",
+      "",
+      "import { create } from \"zustand\"",
+      "",
+      "interface ${TM_FILENAME_BASE/(.*)/${1:/pascalcase}/}State {",
+      "  ${2:value}: ${3:string}",
+      "  set${2:/pascalcase}: (v: ${3:string}) => void",
+      "}",
+      "",
+      "export const use${TM_FILENAME_BASE/(.*)/${1:/pascalcase}/}Store = create<${TM_FILENAME_BASE/(.*)/${1:/pascalcase}/}State>(set => ({",
+      "  ${2:value}: \"\",",
+      "  set${2:/pascalcase}: (${2:value}) => set({ ${2:value} }),",
+      "}))"
+    ],
+    "description": "Add annotations for a Zustand store"
+  },
+  "PromptLang: Add @use header": {
+    "prefix": "@use-header",
+    "body": [
+      "// @use(kind${1:, contract, props, state, limit, deps, compose, platform, scope})"
+    ],
+    "description": "Add @use declaration header"
+  },
+  "PromptLang: Add @props with TS syntax": {
+    "prefix": "@props-ts",
+    "body": [
+      "// @props({ ${1:propName}: \"${2:string}\"${3:, \"${4:optProp?}\": \"${5:number}\"} })"
+    ],
+    "description": "Add @props with TypeScript-like syntax"
+  }
+}

package/vscode-extension/syntaxes/annotations.tmGrammar.json

@@ -0,0 +1,39 @@
+{
+  "$schema": "https://raw.githubusercontent.com/martinring/tmlanguage/master/tmlanguage.json",
+  "name": "PromptLang Annotations",
+  "scopeName": "markup.promptlang.comments",
+  "injectionSelector": "L:comment.line.double-slash -comment, L:comment.block -comment",
+  "patterns": [
+    {
+      "name": "meta.annotation.promptlang",
+      "match": "(@use|@kind|@contract|@props|@state|@limit|@compose|@deps|@platform|@scope|@test|@meta|@forbidden|@pattern|@error)(\\()",
+      "captures": {
+        "1": { "name": "entity.name.tag.promptlang" },
+        "2": { "name": "punctuation.definition.group.promptlang" }
+      }
+    },
+    {
+      "name": "meta.annotation.promptlang.arg",
+      "match": "(\\w+)(\\s*)(:)(\\s*)(\\[?[^\\],)]+\\]?)",
+      "captures": {
+        "1": { "name": "variable.parameter.promptlang" },
+        "3": { "name": "punctuation.separator.promptlang" },
+        "5": { "name": "string.unquoted.promptlang" }
+      }
+    },
+    {
+      "name": "meta.annotation.promptlang.separator",
+      "match": "(->)",
+      "captures": {
+        "1": { "name": "keyword.operator.arrow.promptlang" }
+      }
+    },
+    {
+      "name": "meta.annotation.promptlang.value",
+      "match": "((?:\\w+|\\.\\.\\.))",
+      "captures": {
+        "1": { "name": "support.type.promptlang" }
+      }
+    }
+  ]
+}

package/vscode-extension/syntaxes/promptlang.tmGrammar.json

@@ -0,0 +1,14 @@
+{
+  "$schema": "https://raw.githubusercontent.com/martinring/tmlanguage/master/tmlanguage.json",
+  "name": "PromptLang",
+  "scopeName": "source.promptlang",
+  "patterns": [
+    {
+      "name": "meta.annotation.promptlang.bare",
+      "match": "@(\\w+)\\b",
+      "captures": {
+        "1": { "name": "entity.name.tag.promptlang" }
+      }
+    }
+  ]
+}