VML is a lightweight, runtime HTML/XML builder for Vlang. It allows dynamic, functional construction of documents, elements, and components at runtime — no pre-compilation required! ⚡️

• 🔹 Elements (builder.element) Create standard HTML/XML tags dynamically with attributes and children.

  b.element('div', { 'class': 'container' }, b.text('Hello World!'))

• 🔹 Components (builder.component) Reusable building blocks with props and named slots.

  b.use('card', CardProps{ title: 'My Card', content: b.text('Card content') })

• 🔹 Documents (builder.document) Build entire HTML/XML documents with doctype, root node, and charset.

  b.document(root_node, .html)

• 🔹 Text & Translations (builder.text) Render text with optional translation support; global translations can be added dynamically.

  b.add_translation('Welcome', 'fr', 'Bienvenue')
  b.text('Welcome')

• 🔹 Directives (builder.directive) Apply behaviors or conditional logic to elements and components at runtime.

• 🔹 Functional & Runtime-first Chainable methods, minimal boilerplate, and fully runtime execution.

v install siguici.vml

mkdir -p ${V_MODULES:-$HOME/.vmodules}/siguici
git clone --depth=1 https://github.com/siguici/vml ${V_MODULES:-$HOME/.vmodules}/siguici/vml

Module {
  dependencies: ['siguici.vml']
}

import vml { Context, Props }
import veb { RawHtml }

struct HeaderProps {
  title: string
}

mut b := vml.builder()

b.add_translation('Hello World', 'fr', 'Bonjour le monde')

b.add('header', fn (ctx &Context, props props) {
  if props is HeaderProps {
    title := b.translate(props.title)
    return $tmpl('templates/header.html')
  }
  eprintln('Invalid props for header')
  return ''
})

html := b.document(
  b.element('html', {}, [
    b.element('body', {}, [
      b.use('header', HeaderProps{ title: 'Welcome' }),
    ])
  ]),
  .html
)

println(html)

• Runtime first: no compilation, everything is built programmatically.
• Fluent API: concise, chainable methods for faster development.
• Functional: encourages composable elements, components, and slots.
• Global translations: manage multilingual content seamlessly.

Not a template engine — VML focuses on functional runtime construction of HTML/XML with reusable components, slots, and translations.

Contributions, bug reports, and feature requests are warmly welcome! Feel free to open issues or pull requests.

Distributed under the MIT License. See LICENSE for details.

VML is not a template engine: it focuses on functional, runtime construction of HTML/XML with reusable components, slots, and translations.