[{"data":1,"prerenderedAt":-1},["ShallowReactive",2],{"project-158":3},{"id":4,"name":5,"fullName":6,"owner":7,"repo":5,"description":8,"homepage":9,"htmlUrl":9,"language":10,"languages":9,"totalLinesOfCode":9,"stars":11,"forks":12,"watchers":13,"openIssues":13,"contributorsCount":14,"subscribersCount":14,"size":14,"stars1d":14,"stars7d":14,"stars30d":15,"stars90d":14,"forks30d":14,"starsTrendScore":14,"compositeScore":16,"rankGlobal":9,"rankLanguage":9,"license":9,"archived":17,"fork":17,"defaultBranch":18,"hasWiki":19,"hasPages":17,"topics":20,"createdAt":9,"pushedAt":9,"updatedAt":21,"readmeContent":22,"aiSummary":23,"trendingCount":14,"starSnapshotCount":14,"syncStatus":24,"lastSyncTime":25,"discoverSource":26},158,"kui-lang","yova03\u002Fkui-lang","yova03","KUI academic Markdown compiler with native PDF rendering.",null,"TypeScript",149,14,1,0,4,3.53,false,"main",true,[],"2026-06-12 02:00:09","# KUI\n\nKUI es un lenguaje de documentos inspirado en Markdown para escribir trabajos academicos, informes tecnicos y documentos estructurados con salida PDF nativa, sin depender de LaTeX para compilar el PDF final.\n\nEl proyecto incluye parser, AST semantico, validaciones, plantillas, renderer PDF con PDFKit, exportacion LaTeX opcional y una UI local para inspeccionar el flujo completo del compilador.\n\n## Que ofrece\n\n- Sintaxis legible basada en archivos `.kui`.\n- Metadatos simples sin `---`, con YAML avanzado opcional cuando haga falta.\n- Validacion de referencias, citas, assets, campos requeridos y estructura.\n- Renderer PDF nativo para generar documentos desde Node.js.\n- Exportacion `.tex` opcional para interoperabilidad.\n- Plantillas integradas para articulos, tesis e informes genericos.\n- Interfaz local para revisar fuente, AST, simbolos, diagnosticos y PDF generado.\n\n## Requisitos\n\n- Node.js 20 o superior.\n- npm.\n\n## Instalacion\n\n```bash\nnpm install\nnpm run build\n```\n\n## Uso rapido\n\n```bash\nnpm run dev -- check examples\u002Fpaper.kui\nnpm run dev -- pdf examples\u002Fpaper.kui\nnpm run dev -- doctor\n```\n\nLos PDF generados se guardan en `build\u002F`.\n\nPara un tutorial completo de v0.1, revisa [docs\u002FQUICKSTART.md](docs\u002FQUICKSTART.md). La galeria visual de ejemplos reproducibles vive en [docs\u002FGALLERY.md](docs\u002FGALLERY.md). El alcance cerrado del MVP local esta documentado en [docs\u002FMVP-CLOSURE.md](docs\u002FMVP-CLOSURE.md).\n\n## CLI\n\nDurante desarrollo puedes usar:\n\n```bash\nnpm run dev -- new mi-documento --template paper-APA\nnpm run dev -- new mi-tesis --template tesis-unsaac\nnpm run dev -- check main.kui\nnpm run dev -- assets check main.kui\nnpm run dev -- pdf main.kui\nnpm run dev -- build main.kui\nnpm run dev -- watch main.kui\nnpm run dev -- templates\nnpm run dev -- export main.kui --format tex\nnpm run gallery\n```\n\n`new` rechaza plantillas desconocidas y muestra la lista disponible con una sugerencia cercana cuando el id parece un typo.\n\n`check` valida todo por defecto. Para revisar solo un frente:\n\n```bash\nnpm run dev -- check main.kui --refs\nnpm run dev -- check main.kui --bib\nnpm run dev -- check main.kui --assets\nnpm run dev -- check main.kui --tables\nnpm run dev -- check main.kui --accessibility\n```\n\nLos diagnosticos de `check` sugieren coincidencias cercanas para plantillas, labels de referencias cruzadas y claves bibliograficas cuando detectan typos comunes.\n\nDespues de compilar el proyecto, el binario queda disponible desde `dist\u002Fsrc\u002Fcli\u002Findex.js`.\n\n`watch` recompila cuando cambian el archivo principal, includes, referencias declaradas en `refs:`\u002F`bib:`, assets locales existentes y `kui.toml` cuando se trabaja desde un proyecto. En proyectos modulares, las figuras escritas dentro de un include se observan respecto a la carpeta de ese include.\n\n## UI local\n\n```bash\nnpm run ui -- --port 4321\n```\n\nLuego abre:\n\n```text\nhttp:\u002F\u002Flocalhost:4321\u002F\n```\n\nLa UI permite inspeccionar ejemplos, frontmatter, AST, simbolos, diagnosticos y el PDF resultante.\n\n## Ejemplo minimo\n\n```kui\ntitulo: Documento KUI\nautor: Equipo KUI\nfecha: 2026\nidioma: es\nplantilla: paper-APA\nreferencias: .\u002Freferencias.kref\n\nresumen Este documento demuestra una estructura minima en KUI.\n\nindice\n\n# Introduccion {#sec:intro}\n\nKUI compila documentos estructurados a PDF nativo.\n\nbibliografia\n```\n\nSi no declaras `plantilla`, KUI usa `paper-APA`. Si no declaras `titulo`, lo toma del primer `# Titulo`.\n\n## Referencias KUIRef\n\nKUI acepta `refs:` con archivos `.kref`, un formato YAML simple para reemplazar `.bib` en el flujo nativo:\n\n```yaml\ngarcia2020:\n  type: article\n  title: Wari en Cusco\n  author:\n    - Ana García\n  year: 2020\n  journal: Revista Andina\n```\n\n`.bib` sigue soportado para compatibilidad con BibTeX\u002FZotero, pero los ejemplos nativos usan `.kref`.\n\n## Imágenes simples\n\nAdemás de Markdown (`![caption](ruta)`), KUI acepta un comando corto:\n\n```kui\nLa figura @fig:kui-compiler-pipeline muestra el flujo completo.\n\nimagen kui-compiler-pipeline | Flujo del compilador KUI\n```\n\nKUI busca imagenes por nombre junto al `.kui`, en `figuras\u002F` y en `assets\u002F`. El label se genera automaticamente desde el nombre del archivo: `fig:kui-compiler-pipeline`.\n\nPara revisar solo rutas, formatos y cache de figuras:\n\n```bash\nnpm run dev -- assets check main.kui\n```\n\nEl comando prepara `build\u002Fcache\u002Fassets\u002F` para recursos locales soportados, descarga URLs remotas cuando puede y reporta assets faltantes o no soportados. Si una URL remota fue cacheada, el renderer PDF usa ese archivo local en la siguiente compilacion; si luego falla la red, KUI reutiliza el cache existente. Tambien inspecciona dimensiones y DPI declarados por PNG\u002FJPG\u002FWEBP; si una imagen declara menos de 300 dpi, muestra un warning. En el MVP nativo se renderizan PNG, JPG, JPEG y WEBP; SVG\u002FPDF quedan como post-MVP o requieren conversion previa.\n\nSi compilas un PDF con una imagen remota sin cache previo, el diagnostico de renderizado indica ejecutar `kui assets check` antes de `kui pdf`.\n\n## Comandos faciles\n\nLos casos comunes no necesitan bloques ni llaves:\n\n```kui\ngrafico Permanencia | Ciclo 1=98.6 | Ciclo 2=96.1\n\ntabla Resultados\nCampo; Valor; Estado\nCasos; 120; Activo\nRiesgo; Alto; Revisar\n\nformula rho = n \u002F V\n\nnota Esta es una observacion dentro de una caja.\n\nkpis Indicadores | PDF nativo=Listo | Tablas=Medidas | Graficos=Directos\n\ncuadrado Texto | azul | fondo=amarillo | grande | sombra\n```\n\n## Tesis modular UNSAAC\n\nLa plantilla `tesis-unsaac` genera una estructura multiarchivo inspirada en LaTeX: un `main.kui` como punto de entrada y capítulos separados en `contenido\u002F`.\n\n```bash\nnpm run dev -- new mi-tesis --template tesis-unsaac\nnpm run dev -- pdf mi-tesis\u002Fmain.kui\n```\n\nDentro de una carpeta KUI con `kui.toml`, el archivo `main` se detecta automáticamente:\n\n```bash\ncd mi-tesis\nkui pdf\n```\n\nEstructura generada:\n\n```text\nmi-tesis\u002F\n├── main.kui\n├── kui.toml\n├── contenido\u002F\n│   ├── presentacion.kui\n│   ├── dedicatoria.kui\n│   ├── agradecimiento.kui\n│   ├── resumen.kui\n│   ├── abstract.kui\n│   ├── introduccion.kui\n│   ├── cap1_planteamiento_del_problema.kui\n│   ├── cap2_marco_teorico.kui\n│   ├── cap3_metodologia.kui\n│   ├── cap4_resultados.kui\n│   ├── discusiones.kui\n│   ├── conclusiones.kui\n│   ├── recomendaciones.kui\n│   └── anexo.kui\n├── figuras\u002F\n├── planos\u002F\n└── referencias.kref\n```\n\n`main.kui` usa `incluir` para ensamblar todo el documento antes de compilar. `include` tambien funciona como alias compatible:\n\n```kui\nincluir contenido\u002Fcap1_planteamiento_del_problema.kui\nincluir contenido\u002Fcap2_marco_teorico.kui\nincluir contenido\u002Fcap3_metodologia.kui\nincluir contenido\u002Fcap4_resultados.kui\n```\n\nAsí se conserva la organización por capítulos de LaTeX, pero con sintaxis KUI optimizada para humanos e IA.\n\n`kui.toml` define el punto de entrada del proyecto:\n\n```toml\nmain = \"main.kui\"\ntemplate = \"tesis-unsaac\"\nbuildDir = \"build\"\n```\n\n## Plantillas incluidas\n\n- `paper-IEEE`: articulo academico estilo IEEE.\n- `paper-APA`: articulo academico estilo APA.\n- `tesis-unsaac`: plantilla base para tesis.\n- `informe-operativo`: informe tecnico u operativo generico.\n- `brochure-visual`: pieza editorial o comercial con portada visual.\n- `plano-tecnico`: plano UTM con grilla y coordenadas.\n- `carta-institucional`: comunicacion institucional sobria.\n- `article-digital-economy`: articulo academico de economia digital.\n\n## Estructura\n\n```text\nsrc\u002Fcore       AST, diagnosticos y modelo de proyecto\nsrc\u002Fparser     parser KUI y normalizacion de aliases\nsrc\u002Fsemantic   validadores y tablas de simbolos\nsrc\u002Fpdf        renderer PDF nativo\nsrc\u002Flatex      exportador LaTeX opcional\nsrc\u002Ftemplates  registro de plantillas\nsrc\u002Fcli        interfaz de linea de comandos\nsrc\u002Fui         UI local del compilador\ndocs           documentacion tecnica\nexamples       archivos KUI de ejemplo\ntests          pruebas automatizadas\n```\n\n## Scripts\n\n```bash\nnpm run check    # verificacion TypeScript sin emitir archivos\nnpm test         # pruebas automatizadas\nnpm run build    # compila a dist\u002F\nnpm run gallery  # compila demos visuales y genera previews\nnpm run clean    # limpia dist\u002F y build\u002F\n```\n\n## Limites del MVP v0.x\n\nKUI v0.x consolida el flujo publico principal: `.kui -> AST -> validacion -> PDF nativo`.\nLa exportacion LaTeX existe solo para interoperabilidad (`kui export --format tex`) y no es dependencia del PDF principal.\n\nQuedan fuera del MVP inmediato:\n\n- Extension VS Code\u002FLSP y reconocimiento en GitHub Linguist.\n- Import avanzado desde `.tex`, `.docx` e `.ipynb`.\n- Backends HTML, EPUB y DOCX.\n- PDF\u002FA, PDF\u002FUA, firma digital y validacion SUNEDU automatica.\n- Motor tipografico Rust v1.0; el renderer actual usa PDFKit como motor nativo v0.x.\n\n## Licencia\n\nMIT\n","KUI 是一种面向学术和技术文档编写的语言，支持将基于 Markdown 的文件直接编译为PDF。它使用TypeScript编写，具备语义AST解析、验证机制以及内置模板等功能，并通过PDFKit实现原生PDF渲染。此外，KUI还提供了可选的LaTeX导出功能以增强互操作性，同时配备了一个本地用户界面来帮助开发者审查整个编译流程。此项目特别适合需要创建结构化且格式规范的学术论文、技术报告等场景，在不需要依赖复杂的LaTeX环境的情况下即可生成高质量的专业文档。",2,"2026-06-11 02:31:08","CREATED_QUERY"]