Documentación de HoopLang

HoopLang es un lenguaje tipado para diseñar bordados como código: formas en milímetros reales, hilos con marca y código, primitivas de puntada y montaje en bastidor.

Leer el libro → Consultar la referencia Ir al Playground

HoopLang · Ejemplo rápido

design "Hola" {
  canvas: rect(size: (40mm, 40mm))
}

thread azul = #1f3a8a "Azul"

layer fondo {
  fill azul { shape: circle(center: (20mm, 20mm), r: 15mm) }
}

El libro de HoopLang #

Una guía progresiva desde el primer archivo hasta la prueba en máquina. No requiere experiencia previa programando ni digitalizando bordados.

Capítulo 00 Introducción Qué es HoopLang, cómo instalar hoop y cómo usar el playground. Capítulo 01 Hola, bordado El primer diseño, unidades tipadas, coordenadas y compilación a PES. Capítulo 02 Formas Rectángulos, círculos, polígonos, caminos Bézier, huecos y operaciones. Capítulo 03 Puntadas Relleno tatami, satín, corrido y triple; densidad, ángulo, subcapa y tela. Capítulo 04 Texto Fuentes del catálogo, alineación, arcos y texto que se encaja en una caja. Capítulo 05 Hilos y paletas Declaración de hilos, bibliotecas de marcas (Brother, Janome) e import. Capítulo 06 Capas y orden Capas, secuencias fijas (seq), contenedores (inside) y recorte knockout. Capítulo 07 Constantes y componentes Constantes (const), formas (shape), parámetros (param) y place. Capítulo 08 Repetir y decidir Bucles (for), listas, grillas (grid), condicionales (if), mod y len. Capítulo 09 El bastidor Archivos hoop, montaje de varios diseños y planchas de producción. Capítulo 10 De la pantalla a la máquina Formatos de máquina, estabilizadores y la primera prueba bordada.

Referencia del lenguaje #

Especificación exacta del lenguaje: gramática léxica, sistema de tipos, propiedades y rangos de cada primitiva, catálogos y todos los códigos de diagnóstico.

Referencia Estructura léxica Tokens, comentarios, identificadores Unicode, números con unidad y colores. Referencia Tipos Los 13 tipos estáticos, conversiones, igualdad y tabla de operadores. Referencia Expresiones Literales, listas, operadores, condicionales, miembros y funciones. Referencia Declaraciones Estructura del archivo, design, thread, const, shape, param y layer. Referencia Contenido de las capas y control Elementos de capa: seq, inside, for, if y colocación con place. Referencia Primitivas de bordado Reglas exactas, propiedades y rangos de fill, satin, run y triple. Referencia Texto La primitiva text: modos con height y box, arcos, estilos y fuentes. Referencia Bastidor Declaración hoop, área útil, posicionamiento y origen de máquina. Referencia Módulos Bibliotecas con import, resolución de rutas y componentes con param. Referencia Diagnósticos Catálogo completo de errores (E0xx) y advertencias (W0xx) con ejemplos. Referencia Herramientas CLI (hoop check, build, fmt), playground, API WASM y servidor LSP. Referencia Catálogos Tablas de telas, underlays, las 24 fuentes, bastidores y límites por formato.