@js-template-engine/core

The template engine core. Processes components defined as plain, typed data into working HTML, CSS, and JavaScript — no extensions required — and delegates to framework extensions for other targets.

import { process } from '@js-template-engine/core';
import { defineTemplate } from '@js-template-engine/types';

const template = defineTemplate({
  type: 'component',
  name: 'Button',
  children: [
    {
      type: 'element',
      tag: 'button',
      attributes: { class: ['button'], type: 'button' },
      events: [{ name: 'click', handler: 'handleClick' }],
      children: [{ type: 'text', content: 'Save' }],
    },
  ],
});

const result = process(template);
// result.files → [{ path: 'Button.html', content: '...' }]

HTML output

HTML output is a static rendering: a zero-dependency preview and the semantic baseline for every framework target. Dynamic concepts render as static previews — expressions become {{ expression }} placeholders, conditionals render every branch between <!-- if --> comments, iterations render their children once between <!-- for --> comments, and slots render their fallback content.

Output strategies

Styles and scripts share one strategy vocabulary, configured independently through options.styling and options.scripting:

| Strategy | Styles | Scripts | |---|---|---| | inline | style="..." attributes | onclick="..." attributes | | in-file (default) | a <style> block | a <script> block | | separate-file | Button.css + link | Button.js + script tag |

Validation

process() validates the template first and throws a TemplateError carrying a node path (such as children[2].conditions[0]) on the first structural violation. validateTemplate is exported for standalone use.

Extensions

Extensions are passed directly — no registry, no string-key lookup:

process(template, { extensions: [react(), bem()] });

Framework extensions implement the FrameworkExtension interface exported from this package and take over rendering entirely; the core stays free of framework knowledge.