versacompiler 2.6.0 → 2.6.2

package/README.md

@@ -3,15 +3,16 @@
 [![License: MIT](https://img.shields.io/badge/License-MIT-yellow.svg)](https://opensource.org/licenses/MIT)
 [![TypeScript](https://img.shields.io/badge/TypeScript-007ACC?style=flat&logo=typescript&logoColor=white)](https://www.typescriptlang.org/)
 [![Vue.js](https://img.shields.io/badge/Vue.js-35495E?style=flat&logo=vuedotjs&logoColor=4FC08D)](https://vuejs.org/)
+[![Version](https://img.shields.io/badge/version-2.6.2-blue.svg)](https://github.com/kriollo/versaCompiler/releases/tag/v2.6.2)
 
-> **🎯 Compilador rápido y eficiente para Vue.js, TypeScript y JavaScript con Hot Module Replacement (HMR) integrado.**
+> **🎯 Compilador rápido y eficiente para Vue.js, TypeScript y JavaScript con Hot Module Replacement (HMR) completo.**
 
 **VersaCompiler** es una herramienta de compilación diseñada para proyectos Vue 3 con soporte completo para TypeScript, JavaScript y todas las funcionalidades modernas que necesitas para desarrollo web.
 
 ## 🌟 Características Principales
 
 - ⚡ **Compilación ultra-rápida** - Workers paralelos y cache inteligente
-- 🔥 **HMR Automático (como Vite)** - Detección inteligente sin configuración manual, igual que Vite y esbuild
+- 🔥 **HMR Completo (como Vite)** - Vue SFCs, librerías JS/TS y propagación en cascada sin recarga de página
 - 🧩 **Soporte completo para Vue 3** - SFC, Composition API, script setup
 - 📝 **TypeScript avanzado** - Language Service, decorators, validación de tipos
 - 🔍 **Sistema de linting dual** - ESLint + OxLint con auto-fix
@@ -125,25 +126,37 @@ versacompiler --typeCheck --file src/types.ts
 
 ### 🔧 Archivo de configuración
 
-Crea un archivo `versacompile.config.ts` en la raíz de tu proyecto:
+Crea un archivo `versacompile.config.ts` en la raíz de tu proyecto usando `defineConfig` para autocompletado TypeScript:
 
 ```typescript
-// Archivo de configuración de VersaCompiler
-export default {
-    tsconfig: './tsconfig.json',
-    compilerOptions: {
-        sourceRoot: './src',
+import { defineConfig } from 'versacompiler/config';
+
+export default defineConfig({
+    root: './src',
+    build: {
         outDir: './dist',
-        pathsAlias: {
-            '@/*': ['src/*'],
-            'P@/*': ['public/*'],
+        bundlers: [
+            {
+                name: 'appLoader',
+                fileInput: './public/module/appLoader.js',
+                fileOutput: './public/module/appLoader.prod.js',
+            },
+        ],
+    },
+    resolve: {
+        alias: {
+            '@': 'src',
+            'P@': 'public',
         },
     },
-    proxyConfig: {
+    server: {
         proxyUrl: '',
         assetsOmit: true,
+        watch: {
+            additional: ['./app/templates/**/*.twig'],
+        },
     },
-    aditionalWatch: ['./app/templates/**/*.twig'],
+    tsconfig: './tsconfig.json',
     tailwindConfig: {
         bin: './node_modules/.bin/tailwindcss',
         input: './src/css/input.css',
@@ -165,62 +178,60 @@ export default {
             paths: ['src/'],
         },
     ],
-    bundlers: [
-        {
-            name: 'appLoader',
-            fileInput: './public/module/appLoader.js',
-            fileOutput: './public/module/appLoader.prod.js',
-        },
-    ],
-};
+    typeCheckOptions: {
+        maxWorkers: 2,
+    },
+});
 ```
 
 ### 📝 Opciones de configuración
 
-#### `compilerOptions`
+#### `root` _(requerido)_
 
-- `sourceRoot`: Directorio de archivos fuente (por defecto: `'./src'`)
-- `outDir`: Directorio de salida (por defecto: `'./dist'`)
-- `pathsAlias`: Aliases para imports (ej: `'@/*': ['src/*']`)
+- Directorio raíz de los archivos fuente (ej: `'./src'`)
 
-#### `proxyConfig`
+#### `build` _(requerido)_
 
-- `proxyUrl`: URL del proxy para desarrollo
-- `assetsOmit`: Omitir assets en el proxy
+- `outDir`: Directorio de salida de los archivos compilados (ej: `'./dist'`)
+- `bundlers`: Array de entradas de bundling post-compilación (opcional, `false` para deshabilitar)
+    - `name`: Nombre del bundle
+    - `fileInput`: Archivo de entrada
+    - `fileOutput`: Archivo de salida
+
+#### `resolve`
+
+- `alias`: Mapa de alias de imports. La clave es el prefijo del alias y el valor es la ruta que reemplaza (ej: `{ '@': 'src', 'P@': 'public' }`)
+
+#### `server`
+
+- `proxyUrl`: URL del proxy para desarrollo (ej: `'http://localhost:8000'`)
+- `assetsOmit`: Omitir assets estáticos del proxy (`true`/`false`)
+- `watch.additional`: Globs adicionales a vigilar que disparan recarga completa (ej: plantillas Twig, HTML)
+
+#### `tsconfig`
+
+- Ruta al `tsconfig.json` del proyecto (ej: `'./tsconfig.json'`)
 
 #### `tailwindConfig`
 
 - `bin`: Ruta al binario de TailwindCSS
-- `input`: Archivo CSS de entrada
-- `output`: Archivo CSS de salida
+- `input`: Archivo CSS de entrada con directivas Tailwind
+- `output`: Archivo CSS de salida compilado
+- Usar `false` para deshabilitar completamente
 
 #### `linter`
 
-Array de configuraciones de linters avanzadas:
+Array de configuraciones de linters. Usar `false` para deshabilitar todos:
 
 - `name`: Nombre del linter (`'eslint'` o `'oxlint'`)
 - `bin`: Ruta al binario del linter
 - `configFile`: Archivo de configuración del linter
-- `fix`: Auto-fix de errores detectados
-- `paths`: Rutas específicas a analizar
-- `eslintConfig`: Configuración específica de ESLint
-    - `cache`: Habilitar cache de ESLint
-    - `maxWarnings`: Máximo número de warnings
-    - `quiet`: Mostrar solo errores
-    - `formats`: Formatos de salida (`'json'`, `'stylish'`, `'compact'`)
-- `oxlintConfig`: Configuración específica de OxLint
-    - `rules`: Reglas personalizadas
-    - `plugins`: Plugins de OxLint
-    - `deny`: Reglas a denegar
-    - `allow`: Reglas a permitir
-
-#### `bundlers`
-
-Array de configuraciones de bundling:
-
-- `name`: Nombre del bundle
-- `fileInput`: Archivo de entrada
-- `fileOutput`: Archivo de salida
+- `fix`: Auto-fix de errores detectados (`true`/`false`)
+- `paths`: Rutas específicas a analizar (ej: `['src/']`)
+
+#### `typeCheckOptions`
+
+- `maxWorkers`: Máximo número de worker threads para verificación de tipos (por defecto: depende del número de CPUs)
 
 ## 🎯 Ejemplos de Uso
 
@@ -514,12 +525,17 @@ cat tsconfig.json | grep -A 10 "paths"
 
 ```typescript
 // Verificar configuración en versacompile.config.ts
-export default {
-    proxyConfig: {
+import { defineConfig } from 'versacompiler/config';
+
+export default defineConfig({
+    root: './src',
+    build: { outDir: './dist' },
+    resolve: { alias: { '@': 'src' } },
+    server: {
         proxyUrl: '', // Vacío si no usas proxy backend
         assetsOmit: true,
     },
-};
+});
 ```
 
 ```bash

package/dist/compiler/compile.js

@@ -1653,6 +1653,11 @@ function extractLocalImports(code) {
  * Solo se llama cuando env.isPROD !== 'true' y la salida es un archivo .js.
  */
 function injectHmrShim(code) {
+    // Los scripts CLI con shebang no se ejecutan en browser: omitir el shim HMR
+    // para evitar que el shebang quede desplazado y cause SyntaxError en Node.js
+    if (code.startsWith('#!')) {
+        return code;
+    }
     const localImports = extractLocalImports(code);
     // Detecta si es un Vue SFC (el compilador Vue inyecta 'data-versa-hmr-component')
     const isVueComponent = code.includes('data-versa-hmr-component');

package/dist/config.d.ts

@@ -0,0 +1 @@
+export { defineConfig, type BundlerEntry, type LinterConfig, type VersaConfig, } from './servicios/versacompile.config.types';

package/dist/main.js

@@ -1,15 +1,3 @@
-/* VersaCompiler HMR shim [dev] */
-if (typeof window !== 'undefined' && window.__versaHMR) {
-  (() => {
-    const _id = new URL(import.meta.url).pathname;
-    import.meta.hot = {
-      accept(cb) { window.__versaHMR.accept(_id, typeof cb === 'function' ? cb : () => {}); },
-      invalidate() { window.__versaHMR._invalidate?.(_id); },
-      dispose(cb) { window.__versaHMR._onDispose?.(_id, cb); },
-      get data() { return window.__versaHMR._getHotData?.(_id) ?? {}; },
-    };
-  })();
-}
 #!/usr/bin/env node
 import * as path from 'node:path';
 import * as processModule from 'node:process';

package/dist/servicios/versacompile.config.types.d.ts

@@ -0,0 +1,44 @@
+export type LinterConfig = {
+    name: string;
+    bin: string;
+    configFile: string;
+    fix?: boolean;
+    paths?: string[];
+};
+export type BundlerEntry = {
+    name: string;
+    fileInput: string;
+    fileOutput: string;
+};
+export type VersaConfig = {
+    root: string;
+    build: {
+        outDir: string;
+        bundlers?: BundlerEntry[] | false;
+    };
+    resolve: {
+        alias: Record<string, string | string[]>;
+    };
+    server?: {
+        proxyUrl?: string;
+        assetsOmit?: boolean;
+        watch?: {
+            additional?: string[];
+        };
+    };
+    watch?: {
+        additional?: string[];
+    };
+    plugins?: unknown[];
+    tsconfig?: string;
+    tailwindConfig?: {
+        bin: string;
+        input: string;
+        output: string;
+    } | false;
+    linter?: LinterConfig[] | false;
+    typeCheckOptions?: {
+        maxWorkers?: number;
+    };
+};
+export declare const defineConfig: (config: VersaConfig) => VersaConfig;

package/package.json

@@ -1,6 +1,6 @@
 {
     "name": "versacompiler",
-    "version": "2.6.0",
+    "version": "2.6.2",
     "description": "Una herramienta para compilar y minificar archivos .vue, .js y .ts para proyectos de Vue 3 con soporte para TypeScript.",
     "keywords": [
         "compiler",