moduler-v6

Proyecto para desarrollo modular basado en JS, CSS y HTML.

Índice

• moduler-v6
  • Índice
  • Instalación
  • Requisitos
  • Composición
  • Usos
  • Documentación complementaria

Instalación

git clone https://github.com/allnulled/moduler-v6.git .
npm install

Requisitos

• Utiliza los módulos node_modules especificados en el package.json#devDependencies.
• No utiliza ningún módulo node_modules en producción, por lo que el package.json#dependencies está vacío.

Composición

En el proyecto se incluyen 3 ficheros distribuibles:

• dist/moduler-v6.dist.js
  • para modulación en runtime
  • el más ligero y versátil
  • pensado para soporte cross-environment (browser y node.js)
  • incluye un parser-factory
• dist/compiler-v6.dist.js
  • para modulación en devtime
  • pensado para node.js con require y no import/export
  • incluye a moduler-v6.dist.js
• dist/dev-binary-v6.dist.js
  • para automatizar el devtime
  • como herramientas de soporte para el devtime
  • pensado para node.js con require y no import/export
  • incluye a moduler-v6.dist.js y a compiler-v6.dist.js

Usos

• Para modular mediante ficheros código js, css o md
• Para modulación en compilation-time: el CompilerV6
  • Tienes $compiler.inject.source
  • Tienes $compiler.inject.string
  • Tienes /*@injects:"./file.{js,css,md}"*/
• Para modulación en runtime: el ModulerV6
  • Tienes $moduler.import
  • Tienes $moduler.export
  • Tienes /*@requires:"./file.{js,css,md}"*/
• Para modulación jerárquica: el DevBinaryV6
  • Tienes la propagación del evento touch del DevBinaryV6
  • Compila los *.entry.{js,css,md} que encuentre en directorios superiores

Documentación complementaria

• Fundamentos de ModulerV6 y CompilerV6
  • Se explican las firmas básicas de modulación:
    • $compiler.inject.source
    • $compiler.inject.string
    • /*@injects:"./file.js"*/
    • $moduler.import
    • $moduler.export
    • /*@requires:"./file.js"*/
• Guía de modulación con ModulerV6
  • Se explican los criterios típicos para determinar el tipo de modulación óptima
  • Se incluye algún ejemplo práctico pero de forma abstracta, no código
• Guía del loop de DevBinaryV6
  • Se explican los pasos que sigue el evento touch de (todas van al mismo sitio):
    • el comando devbin loop desde línea de consola
    • el método DevBinaryV6.prototype.shadowCommands.loop o DevBinaryV6.ShadowCommands.prototype.loop
    • siempre llaman a DevBinary.Utils.prototype.touchFile
• Guía de comandos de devbin
  • Se explica el uso de devbin por consola
  • Se explica la DevModulerV6/ShadowCommands API
  • Se explican los comandos sombra que lleva por defecto DevModulerV6
• Guía rápida del moduler-v6-starter
  • Se explica el desarrollo con moduler-v6-starter
    • Proyecto basado en devbin, ModulerV6, CompilerV6 y DevBinaryV6
  • Se explica el proyecto base generado con los comandos:
    • devbin new project --from $dir
    • devbin ensure core --from $dir