@nml-lang/compiler-ts 2.2.0

package/dist/index.d.ts

@@ -0,0 +1,38 @@
+/**
+ * @nml/compiler-ts — public API
+ *
+ * Exports the CompilerAdapter interface so consumers (CLI, Vite plugin,
+ * Cloudflare Worker, MCP server) always program against the interface,
+ * never a concrete class. A future @nml/compiler-wasm package will export
+ * a WasmCompiler satisfying the same interface.
+ */
+import { buildAst, renderVariables, NMLParserError, findComponentRootNode, parseLineRaw, isTruthy, postProcessConditionalsPass } from "./parser.js";
+import { generateHtml, type RenderOptions } from "./renderer.js";
+import type { ASTNode, ComponentMap, GlobalStyles } from "./parser.js";
+export interface CompilerAdapter {
+    /**
+     * Compile a raw NML string to an HTML string.
+     * Returns a Promise — async to support @include directives that read
+     * files from the filesystem, Cloudflare R2, D1, or in-memory stores.
+     *
+     * @param input   - Raw NML source
+     * @param context - Optional template variable context
+     * @param options - Optional components, global styles, readFile, basePath
+     */
+    render(input: string, context?: Record<string, unknown>, options?: CompileOptions): Promise<string>;
+}
+export interface CompileOptions {
+    components?: ComponentMap;
+    globalStyles?: GlobalStyles;
+    /** Async function to read included files. Required when NML uses @include. */
+    readFile?: (path: string) => Promise<string>;
+    /** Absolute path of the NML file being rendered — resolves relative @include paths. */
+    basePath?: string;
+}
+export declare const nmlCompiler: CompilerAdapter;
+export { buildAst, generateHtml, renderVariables, NMLParserError, findComponentRootNode, parseLineRaw, isTruthy, postProcessConditionalsPass };
+export type { RenderOptions };
+export type { ASTNode, ComponentMap, GlobalStyles };
+export { NMLLexerError } from "./lexer.js";
+export type { SourceLocation, Token, TokenKind } from "./lexer.js";
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH,OAAO,EAAE,QAAQ,EAAE,eAAe,EAAE,cAAc,EAAE,qBAAqB,EAAE,YAAY,EAAE,QAAQ,EAAE,2BAA2B,EAAE,MAAM,aAAa,CAAC;AACpJ,OAAO,EAAE,YAAY,EAAE,KAAK,aAAa,EAAE,MAAM,eAAe,CAAC;AACjE,OAAO,KAAK,EAAE,OAAO,EAAE,YAAY,EAAE,YAAY,EAAE,MAAM,aAAa,CAAC;AAMvE,MAAM,WAAW,eAAe;IAC9B;;;;;;;;OAQG;IACH,MAAM,CACJ,KAAK,EAAE,MAAM,EACb,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EACjC,OAAO,CAAC,EAAE,cAAc,GACvB,OAAO,CAAC,MAAM,CAAC,CAAC;CACpB;AAED,MAAM,WAAW,cAAc;IAC7B,UAAU,CAAC,EAAE,YAAY,CAAC;IAC1B,YAAY,CAAC,EAAE,YAAY,CAAC;IAC5B,8EAA8E;IAC9E,QAAQ,CAAC,EAAE,CAAC,IAAI,EAAE,MAAM,KAAK,OAAO,CAAC,MAAM,CAAC,CAAC;IAC7C,uFAAuF;IACvF,QAAQ,CAAC,EAAE,MAAM,CAAC;CACnB;AAgED,eAAO,MAAM,WAAW,EAAE,eAAkC,CAAC;AAM7D,OAAO,EAAE,QAAQ,EAAE,YAAY,EAAE,eAAe,EAAE,cAAc,EAAE,qBAAqB,EAAE,YAAY,EAAE,QAAQ,EAAE,2BAA2B,EAAE,CAAC;AAC/I,YAAY,EAAE,aAAa,EAAE,CAAC;AAC9B,YAAY,EAAE,OAAO,EAAE,YAAY,EAAE,YAAY,EAAE,CAAC;AACpD,OAAO,EAAE,aAAa,EAAE,MAAM,YAAY,CAAC;AAC3C,YAAY,EAAE,cAAc,EAAE,KAAK,EAAE,SAAS,EAAE,MAAM,YAAY,CAAC"}

package/dist/index.js

@@ -0,0 +1,70 @@
+/**
+ * @nml/compiler-ts — public API
+ *
+ * Exports the CompilerAdapter interface so consumers (CLI, Vite plugin,
+ * Cloudflare Worker, MCP server) always program against the interface,
+ * never a concrete class. A future @nml/compiler-wasm package will export
+ * a WasmCompiler satisfying the same interface.
+ */
+import { buildAst, renderVariables, NMLParserError, findComponentRootNode, parseLineRaw, isTruthy, postProcessConditionalsPass } from "./parser.js";
+import { generateHtml } from "./renderer.js";
+// ---------------------------------------------------------------------------
+// Default TypeScript engine
+// ---------------------------------------------------------------------------
+class TSCompiler {
+    async render(input, context = {}, options = {}) {
+        const components = options.components ?? {};
+        const globalStyles = options.globalStyles ?? {};
+        const renderOpts = {
+            readFile: options.readFile,
+            basePath: options.basePath,
+        };
+        const ast = buildAst(input, { components, globalStyles });
+        let html = await generateHtml(ast, 0, context, renderOpts);
+        // Inject scoped styles if any are present
+        if (Object.keys(globalStyles).length > 0) {
+            const usedScopeIds = collectScopeIds(ast);
+            const usedStyles = [];
+            for (const sid of usedScopeIds) {
+                if (sid in globalStyles) {
+                    usedStyles.push(globalStyles[sid]);
+                }
+            }
+            if (usedStyles.length > 0) {
+                const styleTag = `<style data-nml-scoped-styles>\n${usedStyles.join("\n")}\n</style>`;
+                if (html.includes("</head>")) {
+                    html = html.replace("</head>", `${styleTag}\n</head>`);
+                }
+                else {
+                    html = styleTag + "\n" + html;
+                }
+            }
+        }
+        return html;
+    }
+}
+function collectScopeIds(nodes) {
+    const ids = new Set();
+    function walk(items) {
+        for (const n of items) {
+            for (const k of Object.keys(n.attributes)) {
+                if (k.startsWith("nml-c-"))
+                    ids.add(k);
+            }
+            if (n.children.length > 0)
+                walk(n.children);
+        }
+    }
+    walk(nodes);
+    return ids;
+}
+// ---------------------------------------------------------------------------
+// Singleton default export — V8-optimised TS engine
+// ---------------------------------------------------------------------------
+export const nmlCompiler = new TSCompiler();
+// ---------------------------------------------------------------------------
+// Re-exports for advanced consumers
+// ---------------------------------------------------------------------------
+export { buildAst, generateHtml, renderVariables, NMLParserError, findComponentRootNode, parseLineRaw, isTruthy, postProcessConditionalsPass };
+export { NMLLexerError } from "./lexer.js";
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"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"}

package/dist/lexer.d.ts

@@ -0,0 +1,30 @@
+/**
+ * NML Lexer
+ * Tokenizes raw NML source text into a stream of typed tokens,
+ * each carrying precise source location (line, column) for error
+ * reporting and Vite overlay / MCP diagnostics.
+ */
+export interface SourceLocation {
+    line: number;
+    column: number;
+}
+export type TokenKind = "INDENT" | "ELEMENT" | "ATTR_CHAIN" | "MULTILINE_START" | "MULTILINE_LINE" | "COMMENT" | "BLANK" | "EOF";
+export interface Token {
+    kind: TokenKind;
+    value: string;
+    loc: SourceLocation;
+    /** For INDENT tokens: indentation level (0-based, each level = 4 spaces) */
+    level?: number;
+}
+/**
+ * Tokenize NML source into a flat array of line-level tokens.
+ * Each "line" of NML produces at most one primary token; multiline
+ * blocks consume multiple raw lines and emit MULTILINE_LINE tokens
+ * for each.
+ */
+export declare function tokenize(source: string): Token[];
+export declare class NMLLexerError extends Error {
+    loc: SourceLocation;
+    constructor(message: string, loc: SourceLocation);
+}
+//# sourceMappingURL=lexer.d.ts.map

package/dist/lexer.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"lexer.d.ts","sourceRoot":"","sources":["../src/lexer.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,MAAM,WAAW,cAAc;IAC7B,IAAI,EAAE,MAAM,CAAC;IACb,MAAM,EAAE,MAAM,CAAC;CAChB;AAED,MAAM,MAAM,SAAS,GACjB,QAAQ,GACR,SAAS,GACT,YAAY,GACZ,iBAAiB,GACjB,gBAAgB,GAChB,SAAS,GACT,OAAO,GACP,KAAK,CAAC;AAEV,MAAM,WAAW,KAAK;IACpB,IAAI,EAAE,SAAS,CAAC;IAChB,KAAK,EAAE,MAAM,CAAC;IACd,GAAG,EAAE,cAAc,CAAC;IACpB,4EAA4E;IAC5E,KAAK,CAAC,EAAE,MAAM,CAAC;CAChB;AAID;;;;;GAKG;AACH,wBAAgB,QAAQ,CAAC,MAAM,EAAE,MAAM,GAAG,KAAK,EAAE,CA8GhD;AA8BD,qBAAa,aAAc,SAAQ,KAAK;IACtC,GAAG,EAAE,cAAc,CAAC;gBACR,OAAO,EAAE,MAAM,EAAE,GAAG,EAAE,cAAc;CAKjD"}

package/dist/lexer.js

@@ -0,0 +1,132 @@
+/**
+ * NML Lexer
+ * Tokenizes raw NML source text into a stream of typed tokens,
+ * each carrying precise source location (line, column) for error
+ * reporting and Vite overlay / MCP diagnostics.
+ */
+const INDENT_WIDTH = 4;
+/**
+ * Tokenize NML source into a flat array of line-level tokens.
+ * Each "line" of NML produces at most one primary token; multiline
+ * blocks consume multiple raw lines and emit MULTILINE_LINE tokens
+ * for each.
+ */
+export function tokenize(source) {
+    const tokens = [];
+    const rawLines = source.split("\n");
+    let lineIdx = 0; // 0-based index into rawLines
+    while (lineIdx < rawLines.length) {
+        const rawLine = rawLines[lineIdx];
+        const currentLine = lineIdx + 1; // 1-based
+        const stripped = rawLine.trimEnd();
+        // Blank line
+        if (stripped.trim() === "") {
+            tokens.push({ kind: "BLANK", value: "", loc: { line: currentLine, column: 0 } });
+            lineIdx++;
+            continue;
+        }
+        // Comment
+        if (stripped.trimStart().startsWith("//")) {
+            const col = stripped.length - stripped.trimStart().length;
+            tokens.push({ kind: "COMMENT", value: stripped.trimStart(), loc: { line: currentLine, column: col } });
+            lineIdx++;
+            continue;
+        }
+        // Validate and measure indentation
+        const leadingSpaces = stripped.length - stripped.trimStart().length;
+        if (stripped.startsWith("\t")) {
+            throw new NMLLexerError(`Indentation error on line ${currentLine}: Please use 4 spaces for indentation, not tabs.`, { line: currentLine, column: 0 });
+        }
+        if (leadingSpaces % INDENT_WIDTH !== 0) {
+            throw new NMLLexerError(`Indentation error on line ${currentLine}: Non-standard indentation. Use 4 spaces per level.`, { line: currentLine, column: 0 });
+        }
+        const level = leadingSpaces / INDENT_WIDTH;
+        const content = stripped.trimStart();
+        // Check if this line is a multiline trigger (ends with ':' outside quotes)
+        const isMultilineTrigger = isLineMultilineTrigger(content);
+        // Emit INDENT + ELEMENT token for this line
+        tokens.push({
+            kind: "INDENT",
+            value: "",
+            level,
+            loc: { line: currentLine, column: 0 },
+        });
+        tokens.push({
+            kind: isMultilineTrigger ? "MULTILINE_START" : "ELEMENT",
+            value: content,
+            loc: { line: currentLine, column: leadingSpaces },
+        });
+        lineIdx++;
+        // If multiline, consume subsequent indented lines
+        if (isMultilineTrigger) {
+            const blockStartLevel = level + 1;
+            const blockStartCol = blockStartLevel * INDENT_WIDTH;
+            while (lineIdx < rawLines.length) {
+                const mlRaw = rawLines[lineIdx];
+                const mlLine = lineIdx + 1;
+                const mlStripped = mlRaw.trimEnd();
+                // Blank lines are part of the block
+                if (mlStripped.trim() === "") {
+                    tokens.push({ kind: "MULTILINE_LINE", value: "", loc: { line: mlLine, column: 0 } });
+                    lineIdx++;
+                    continue;
+                }
+                const mlSpaces = mlStripped.length - mlStripped.trimStart().length;
+                // Block ends when indentation returns to block level or less
+                if (mlSpaces < blockStartCol) {
+                    break;
+                }
+                // Validate indentation within block
+                if (mlSpaces % INDENT_WIDTH !== 0) {
+                    throw new NMLLexerError(`Indentation error on line ${mlLine}: Non-standard indentation. Use 4 spaces per level.`, { line: mlLine, column: 0 });
+                }
+                // Relative indent (strip the block-start indentation)
+                const relativeIndent = " ".repeat(mlSpaces - blockStartCol);
+                const mlContent = relativeIndent + mlStripped.trimStart();
+                tokens.push({
+                    kind: "MULTILINE_LINE",
+                    value: mlContent,
+                    loc: { line: mlLine, column: mlSpaces },
+                });
+                lineIdx++;
+            }
+        }
+    }
+    tokens.push({ kind: "EOF", value: "", loc: { line: rawLines.length + 1, column: 0 } });
+    return tokens;
+}
+/**
+ * Returns true if the NML line (already stripped of indent) ends with ':'
+ * outside of any quoted string — indicating a multiline content block.
+ */
+function isLineMultilineTrigger(content) {
+    let inQuote = false;
+    let quoteChar = "";
+    let i = 0;
+    // Strip trailing whitespace before checking
+    const trimmed = content.trimEnd();
+    while (i < trimmed.length) {
+        const ch = trimmed[i];
+        if (inQuote) {
+            if (ch === quoteChar)
+                inQuote = false;
+        }
+        else {
+            if (ch === '"' || ch === "'") {
+                inQuote = true;
+                quoteChar = ch;
+            }
+        }
+        i++;
+    }
+    return !inQuote && trimmed.endsWith(":");
+}
+export class NMLLexerError extends Error {
+    loc;
+    constructor(message, loc) {
+        super(message);
+        this.name = "NMLLexerError";
+        this.loc = loc;
+    }
+}
+//# sourceMappingURL=lexer.js.map

package/dist/lexer.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"lexer.js","sourceRoot":"","sources":["../src/lexer.ts"],"names":[],"mappings":"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"}

package/dist/parser.d.ts

@@ -0,0 +1,55 @@
+/**
+ * NML Parser
+ * Ports nml_parse.py's build_ast, _expand_components_pass,
+ * _inject_slot, and related helpers to TypeScript.
+ *
+ * Every ASTNode carries loc: { line, column } sourced from the lexer.
+ */
+import { type SourceLocation } from "./lexer.js";
+export interface SourceLocation2 extends SourceLocation {
+}
+export interface ASTNode {
+    element: string;
+    attributes: Record<string, string | boolean | string[]>;
+    content: string;
+    children: ASTNode[];
+    multiline_trigger: boolean;
+    multiline_content: string[];
+    loc: SourceLocation;
+    /** Internal: node-level context override (props) */
+    __context__?: Record<string, unknown>;
+    /** Set by postProcessConditionalsPass on @if nodes: the else-branch children */
+    elseBranch?: ASTNode[];
+}
+export type ComponentMap = Record<string, ASTNode[]>;
+export type GlobalStyles = Record<string, string>;
+export declare class NMLParserError extends Error {
+    loc: SourceLocation;
+    constructor(message: string, loc?: SourceLocation);
+}
+export declare function parseLine(rawContent: string, loc: SourceLocation): ASTNode;
+/**
+ * The Python parser supports `h1("Hello")` as shorthand for content.
+ * In NML the element line is like `h1.class("blue", "Hello")` or `h1("Hello")`.
+ * We need to detect when the "attribute name" equals the element name
+ * and treat the value as content instead.
+ */
+export declare function parseLineRaw(rawLine: string, loc: SourceLocation): ASTNode;
+export declare function buildAst(source: string, options?: {
+    components?: ComponentMap;
+    globalStyles?: GlobalStyles;
+}): ASTNode[];
+export declare function findComponentRootNode(ast: ASTNode[]): ASTNode | null;
+export declare function isTruthy(val: unknown): boolean;
+export declare function renderVariables(template: string, context: Record<string, unknown>): string;
+/**
+ * Because NML is indentation-based, @else / @endif appear as SIBLINGS of @if
+ * in the parent array (not as children). This pass:
+ *   - Finds @if nodes at index i
+ *   - Looks ahead for @else at i+1 → moves its children into node.elseBranch
+ *   - Removes the @else and @endif siblings
+ *   - Removes @endeach siblings (children already captured by indentation)
+ *   - Recurses into every node's children array
+ */
+export declare function postProcessConditionalsPass(nodes: ASTNode[]): ASTNode[];
+//# sourceMappingURL=parser.d.ts.map

package/dist/parser.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"parser.d.ts","sourceRoot":"","sources":["../src/parser.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,OAAO,EAA2B,KAAK,cAAc,EAAE,MAAM,YAAY,CAAC;AAO1E,MAAM,WAAW,eAAgB,SAAQ,cAAc;CAAG;AAE1D,MAAM,WAAW,OAAO;IACtB,OAAO,EAAE,MAAM,CAAC;IAChB,UAAU,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,GAAG,OAAO,GAAG,MAAM,EAAE,CAAC,CAAC;IACxD,OAAO,EAAE,MAAM,CAAC;IAChB,QAAQ,EAAE,OAAO,EAAE,CAAC;IACpB,iBAAiB,EAAE,OAAO,CAAC;IAC3B,iBAAiB,EAAE,MAAM,EAAE,CAAC;IAC5B,GAAG,EAAE,cAAc,CAAC;IACpB,oDAAoD;IACpD,WAAW,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IACtC,gFAAgF;IAChF,UAAU,CAAC,EAAE,OAAO,EAAE,CAAC;CACxB;AAED,MAAM,MAAM,YAAY,GAAG,MAAM,CAAC,MAAM,EAAE,OAAO,EAAE,CAAC,CAAC;AACrD,MAAM,MAAM,YAAY,GAAG,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;AAElD,qBAAa,cAAe,SAAQ,KAAK;IACvC,GAAG,EAAE,cAAc,CAAC;gBACR,OAAO,EAAE,MAAM,EAAE,GAAG,GAAE,cAAuC;CAK1E;AAqCD,wBAAgB,SAAS,CAAC,UAAU,EAAE,MAAM,EAAE,GAAG,EAAE,cAAc,GAAG,OAAO,CAoH1E;AAoGD;;;;;GAKG;AACH,wBAAgB,YAAY,CAAC,OAAO,EAAE,MAAM,EAAE,GAAG,EAAE,cAAc,GAAG,OAAO,CAsE1E;AAMD,wBAAgB,QAAQ,CACtB,MAAM,EAAE,MAAM,EACd,OAAO,GAAE;IACP,UAAU,CAAC,EAAE,YAAY,CAAC;IAC1B,YAAY,CAAC,EAAE,YAAY,CAAC;CACxB,GACL,OAAO,EAAE,CA2HX;AAwMD,wBAAgB,qBAAqB,CAAC,GAAG,EAAE,OAAO,EAAE,GAAG,OAAO,GAAG,IAAI,CAOpE;AAiDD,wBAAgB,QAAQ,CAAC,GAAG,EAAE,OAAO,GAAG,OAAO,CAM9C;AA+BD,wBAAgB,eAAe,CAC7B,QAAQ,EAAE,MAAM,EAChB,OAAO,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAC/B,MAAM,CAmCR;AAuGD;;;;;;;;GAQG;AACH,wBAAgB,2BAA2B,CAAC,KAAK,EAAE,OAAO,EAAE,GAAG,OAAO,EAAE,CAmEvE"}