Paquete NPM

El transpilador oficial de EsHTML está disponible como paquete NPM para integrar en tus proyectos Node.js.

Instalación

Instala el paquete html-es usando npm o tu gestor de paquetes preferido:

# Usando npm

npm install html-es

# Usando yarn

yarn add html-es

# Usando pnpm

pnpm add html-es

Uso Básico

Importa el transpilador y úsalo para convertir código EsHTML a HTML:

import { EsHTMLTranspiler } from 'html-es';

const transpiler = new EsHTMLTranspiler();

// Código EsHTML
const eshtml = `
<artículo>
  <título>Mi Primera Página</título>
  <sección clase="contenido">
    <e1>¡Hola Mundo!</e1>
    <p>Este es un ejemplo de EsHTML</p>
    <botón deshabilitado>Enviar</botón>
  </sección>
</artículo>
`;

// Transpilar a HTML estándar
const html = transpiler.transpile(eshtml);
console.log(html);

Resultado:

<article>
  <title>Mi Primera Página</title>
  <section class="contenido">
    <h1>¡Hola Mundo!</h1>
    <p>Este es un ejemplo de EsHTML</p>
    <button disabled>Enviar</button>
  </section>
</article>

Referencia de API

EsHTMLTranspiler

Clase principal del transpilador que convierte código EsHTML a HTML estándar.

const transpiler = new EsHTMLTranspiler();

transpile()

Transpila código EsHTML a HTML estándar.

transpiler.transpile(source: string, options?: TranspileOptions): string

Parámetros:

source (string) - El código EsHTML a transpilar
options (TranspileOptions, opcional) - Opciones de configuración

Retorna:

string - El código HTML estándar resultante

Opciones de Configuración

El objeto TranspileOptions permite personalizar el comportamiento del transpilador:

interface TranspileOptions {
  strictMode?: boolean;      // Lanza errores ante sintaxis inválida
  ignoreWarnings?: boolean;  // Ignora advertencias no críticas
}

strictMode

Cuando está habilitado, el transpilador lanzará errores ante cualquier sintaxis inválida. Útil durante el desarrollo para detectar problemas tempranamente.

const html = transpiler.transpile(eshtml, { strictMode: true });

ignoreWarnings

Suprime advertencias no críticas durante la transpilación. Recomendado para producción.

const html = transpiler.transpile(eshtml, { ignoreWarnings: true });

Casos de Uso

Scripts de Build

Integra el transpilador en tu proceso de compilación para convertir archivos .eshtml a .html automáticamente.

Aplicaciones Educativas

Crea herramientas de aprendizaje que permitan a estudiantes escribir HTML en español y ver el resultado.

APIs y Servicios Web

Implementa endpoints que acepten EsHTML y devuelvan HTML estándar para aplicaciones web.

Generadores de Sitios Estáticos

Extiende herramientas como 11ty o Next.js para soportar archivos EsHTML en tu flujo de trabajo.

Ver en NPM Repositorio GitHub

Herramientas Extensión VSCode