🚀 VML — Vlang Markup Language

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! ⚡️

✨ Features

🔹 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.

📦 Installation

Via VPM (Recommended)

v install siguici.vml

Via Git

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

As a project dependency

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

⚡ Example

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)

🛠 API Usage Overview

Method	Description
`builder.element(name, attrs, contents...)`	Create a standard element
`builder.component(name, props, slots)`	Render a reusable component
`builder.document(root, doctype)`	Render a full document
`builder.text(value, params)`	Render text with optional translation
`builder.add_translation(phrase, locale, translation)`	Add global translation
`builder.translate(phrase)`	Get translated phrase

💡 Philosophy

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.

🤝 Contributing

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

📄 License

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.