htl-to-js 0.1.0

package/dist/transpiler/directives.d.ts

@@ -0,0 +1,42 @@
+export interface SetDecl {
+    name: string;
+    expr: string;
+    raw?: boolean;
+}
+export interface CallDescriptor {
+    fn: string;
+    params: Record<string, string>;
+}
+export interface Directives {
+    use: Record<string, string>;
+    useDefaults: Record<string, string>;
+    fileUse: Record<string, string>;
+    test: string | null;
+    repeat: {
+        varName: string;
+        listExpr: string;
+        listMode: boolean;
+    } | null;
+    element: string | null;
+    unwrap: string | null;
+    sets: SetDecl[];
+    text: string | null;
+    resource: string | null;
+    template: {
+        name: string;
+        params: string[];
+    } | null;
+    call: CallDescriptor | null;
+    include: string | null;
+    dynamicAttrs?: {
+        name: string;
+        expr: string;
+    }[];
+    spreadAttr?: string | null;
+    skip: Set<string>;
+}
+/**
+ * Parses all data-sly-* attributes from a node's attribute map and returns
+ * a structured descriptor used by the walker to generate JS code.
+ */
+export declare function parseDirectives(attrs: Record<string, string>, sourceDir?: string): Directives;

package/dist/transpiler/directives.js

@@ -0,0 +1,207 @@
+"use strict";
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.parseDirectives = parseDirectives;
+const node_fs_1 = __importDefault(require("node:fs"));
+const node_path_1 = __importDefault(require("node:path"));
+const expr_1 = require("./expr");
+/**
+ * Resolves an HTL data-sly-use file path to a require()-ready relative path.
+ * AEM resolves paths relative to the component root, not the current file,
+ * so we walk up the directory tree until the file is found.
+ * Returns a './relative/path.html' string, or null if not resolvable locally.
+ */
+function resolveHtlPath(val, sourceDir) {
+    if (!val.endsWith('.html') || val.includes('${'))
+        return null;
+    if (val.startsWith('/')) {
+        let dir = sourceDir;
+        for (let i = 0; i < 10; i++) {
+            const jcrRoot = node_path_1.default.join(dir, 'jcr_root');
+            if (node_fs_1.default.existsSync(jcrRoot)) {
+                const candidate = node_path_1.default.join(jcrRoot, val);
+                if (node_fs_1.default.existsSync(candidate)) {
+                    const rel = node_path_1.default.relative(sourceDir, candidate).replaceAll('\\', '/');
+                    return rel.startsWith('.') ? rel : `./${rel}`;
+                }
+                return null;
+            }
+            dir = node_path_1.default.dirname(dir);
+        }
+        return null;
+    }
+    if (val.split('/').length > 2)
+        return null;
+    let dir = sourceDir;
+    for (let i = 0; i < 4; i++) {
+        const candidate = node_path_1.default.join(dir, val);
+        if (node_fs_1.default.existsSync(candidate)) {
+            const rel = node_path_1.default.relative(sourceDir, candidate).replaceAll('\\', '/');
+            return rel.startsWith('.') ? rel : `./${rel}`;
+        }
+        dir = node_path_1.default.dirname(dir);
+    }
+    return null;
+}
+function parseUseDefault(val) {
+    const atIdx = val.indexOf('@');
+    if (atIdx === -1)
+        return null;
+    const vals = [...val.slice(atIdx + 1).matchAll(/\w+\s*=\s*(\w+)/g)].map(m => m[1]);
+    return vals.length ? `{ ${vals.join(', ')} }` : null;
+}
+/**
+ * Parses all data-sly-* attributes from a node's attribute map and returns
+ * a structured descriptor used by the walker to generate JS code.
+ */
+function parseDirectives(attrs, sourceDir = '') {
+    const directives = {
+        use: {},
+        useDefaults: {},
+        fileUse: {},
+        test: null,
+        repeat: null,
+        element: null,
+        unwrap: null,
+        sets: [],
+        text: null,
+        resource: null,
+        template: null,
+        call: null,
+        include: null,
+        skip: new Set(),
+    };
+    for (const [key, val] of Object.entries(attrs)) {
+        const useMatch = /^data-sly-use\.(\w+)$/.exec(key);
+        if (useMatch) {
+            const name = useMatch[1];
+            const trimmed = val.trim();
+            const requirePath = sourceDir ? resolveHtlPath(trimmed, sourceDir) : null;
+            if (requirePath) {
+                directives.fileUse[name] = requirePath;
+            }
+            else {
+                directives.use[name] = val;
+                const def = parseUseDefault(trimmed);
+                if (def)
+                    directives.useDefaults[name] = def;
+            }
+            directives.skip.add(key);
+            continue;
+        }
+        if (key === 'data-sly-test') {
+            directives.test = (0, expr_1.convertExpr)(val);
+            directives.skip.add(key);
+            continue;
+        }
+        const testVarMatch = /^data-sly-test\.(\w+)$/.exec(key);
+        if (testVarMatch) {
+            const varName = testVarMatch[1];
+            directives.sets.push({ name: varName, expr: (0, expr_1.convertExpr)(val), raw: true });
+            directives.test = varName;
+            directives.skip.add(key);
+            continue;
+        }
+        const repeatMatch = /^data-sly-(?:repeat|list)\.(\w+)$/.exec(key);
+        if (repeatMatch) {
+            directives.repeat = { varName: repeatMatch[1], listExpr: (0, expr_1.convertExpr)(val), listMode: key.startsWith('data-sly-list.') };
+            directives.skip.add(key);
+            continue;
+        }
+        if (key === 'data-sly-list' || key === 'data-sly-repeat') {
+            directives.repeat = { varName: 'item', listExpr: (0, expr_1.convertExpr)(val), listMode: key === 'data-sly-list' };
+            directives.skip.add(key);
+            continue;
+        }
+        if (key === 'data-sly-element') {
+            directives.element = (0, expr_1.convertExpr)(val);
+            directives.skip.add(key);
+            continue;
+        }
+        if (key === 'data-sly-unwrap') {
+            directives.unwrap = val.trim() ? (0, expr_1.convertExpr)(val) : 'true';
+            directives.skip.add(key);
+            continue;
+        }
+        const setMatch = /^data-sly-set\.(\w+)$/.exec(key);
+        if (setMatch) {
+            const t = val.trim();
+            const isPureExpr = t.startsWith('${') && t.endsWith('}') && !t.slice(2, -1).includes('${');
+            directives.sets.push(isPureExpr
+                ? { name: setMatch[1], expr: (0, expr_1.convertExpr)(t), raw: true }
+                : { name: setMatch[1], expr: (0, expr_1.convertAttrValue)(val) });
+            directives.skip.add(key);
+            continue;
+        }
+        if (key === 'data-sly-text') {
+            directives.text = (0, expr_1.convertExpr)(val);
+            directives.skip.add(key);
+            continue;
+        }
+        if (key === 'data-sly-resource') {
+            let resource = (0, expr_1.convertExpr)(val);
+            if (!resource) {
+                const pathMatch = /@\s*path\s*=\s*([^,}@\s'"]+)/.exec(val);
+                if (pathMatch)
+                    resource = (0, expr_1.convertExpr)('${' + pathMatch[1] + '}');
+            }
+            directives.resource = resource;
+            directives.skip.add(key);
+            continue;
+        }
+        const templateMatch = /^data-sly-template\.(\w+)$/.exec(key);
+        if (templateMatch) {
+            const params = [...val.matchAll(/@\s*(\w+)/g)].map(m => m[1]);
+            directives.template = { name: templateMatch[1], params };
+            directives.skip.add(key);
+            continue;
+        }
+        const attrMatch = /^data-sly-attribute\.(.+)$/.exec(key);
+        if (attrMatch) {
+            const attrName = attrMatch[1];
+            directives.dynamicAttrs ??= [];
+            directives.dynamicAttrs.push({ name: attrName, expr: (0, expr_1.convertExpr)(val) });
+            directives.skip.add(key);
+            directives.skip.add(attrName);
+            continue;
+        }
+        if (key === 'data-sly-attribute') {
+            directives.spreadAttr = (0, expr_1.convertExpr)(val);
+            directives.skip.add(key);
+            continue;
+        }
+        if (key === 'data-sly-include') {
+            directives.include = val;
+            directives.skip.add(key);
+            continue;
+        }
+        if (key === 'data-sly-call') {
+            directives.call = parseCallExpr(val);
+            directives.skip.add(key);
+        }
+    }
+    return directives;
+}
+/**
+ * Parses a data-sly-call expression into a callable descriptor.
+ *
+ * Input:  "${template.default @ model=item, title=item.title}"
+ * Output: { fn: "template.default", params: { model: "item", title: "item.title" } }
+ */
+function parseCallExpr(raw) {
+    const inner = raw.trim().replace(/^\$\{([\s\S]+)\}$/, '$1').trim();
+    const atIdx = inner.indexOf('@');
+    const fn = (atIdx === -1 ? inner : inner.slice(0, atIdx)).trim();
+    const params = {};
+    if (atIdx !== -1) {
+        const optStr = inner.slice(atIdx + 1);
+        const valueRe = /(\w+)\s*=\s*((?:'(?:\\.|[^'\\])*'|"(?:\\.|[^"\\])*"|\$\{(?:[^{}]|\{[^{}]*\})*\}|\[[^\]]*\]|[^,}])+)/g; // NOSONAR -- inherent complexity of HTL value parsing
+        for (const m of optStr.matchAll(valueRe)) {
+            params[m[1].trim()] = (0, expr_1.convertExpr)(m[2].trim());
+        }
+    }
+    return { fn, params };
+}
+//# sourceMappingURL=directives.js.map

package/dist/transpiler/directives.js.map

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

package/dist/transpiler/expr.d.ts

@@ -0,0 +1,34 @@
+/**
+ * Converts a raw HTL expression (with or without ${}) to a JS expression string.
+ *
+ * Examples:
+ *   "${items.size > 0}"  →  "items.length > 0"
+ *   "'Text' @ i18n"         →  "'Text'"
+ *   "${model.title @ context='html'}" → "model.title"
+ */
+export declare function convertExpr(raw: string): string;
+interface ExprMatch {
+    index: number;
+    expr: string;
+    end: number;
+}
+/**
+ * Extracts all ${...} HTL expressions from a string, correctly handling
+ * any depth of nested braces (e.g. '{{url}}' or '{0}/{1}' placeholders).
+ */
+export declare function extractExprs(str: string): ExprMatch[];
+/**
+ * Converts all ${htlExpr} occurrences within an attribute value string,
+ * while escaping literal backticks and bare $ signs.
+ */
+export declare function convertAttrValue(value: string): string;
+/**
+ * Converts HTL expressions in text node content, escaping everything else
+ * for safe embedding in a JS template literal.
+ */
+export declare function convertTextContent(text: string): string;
+/**
+ * Escapes characters that would break a JS template literal.
+ */
+export declare function escapeLiteral(str: string): string;
+export {};

package/dist/transpiler/expr.js

@@ -0,0 +1,134 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.convertExpr = convertExpr;
+exports.extractExprs = extractExprs;
+exports.convertAttrValue = convertAttrValue;
+exports.convertTextContent = convertTextContent;
+exports.escapeLiteral = escapeLiteral;
+/**
+ * Converts a raw HTL expression (with or without ${}) to a JS expression string.
+ *
+ * Examples:
+ *   "${items.size > 0}"  →  "items.length > 0"
+ *   "'Text' @ i18n"         →  "'Text'"
+ *   "${model.title @ context='html'}" → "model.title"
+ */
+function convertExpr(raw) {
+    if (!raw?.trim())
+        return raw;
+    let inner = raw.trim();
+    if (inner.startsWith('${') && inner.endsWith('}')) {
+        inner = inner.slice(2, -1).trim();
+    }
+    const i18nMatch = /^\s*(['"])([^'"]*?)\1\s*@\s*(?:.*,\s*)?i18n\b/.exec(inner);
+    inner = inner.replace(// NOSONAR -- intentional single match (anchored at ^)
+    /^([\s\S]+?)\s*@\s*join\s*=\s*(?:'([^']*)'|"([^"]*)")/, (_, expr, sepSingle, sepDouble) => {
+        const sep = sepSingle ?? sepDouble;
+        return `(${expr.trim()}).join('${sep}')`;
+    });
+    inner = inner.replaceAll(/['"]([^'"]*)['"]\s*@\s*format=\[([^\]]*)\]/g, (_, tmpl, args) => {
+        const argList = args.split(',').map(a => a.trim());
+        const parts = tmpl.split(/\{(\d+)\}/);
+        return parts
+            .map((part, i) => (i % 2 === 1 ? argList[Number.parseInt(part)] || "''" : part ? `'${part}'` : null))
+            .filter(Boolean)
+            .join(' + ') || "''";
+    });
+    const arrays = [];
+    inner = inner.replaceAll(/\[[^\]]*\]/g, m => { arrays.push(m); return `__ARR${arrays.length - 1}__`; });
+    const OPT_VAL = String.raw `(?:'[^']*'|"[^"]*"|__ARR\d+__|(?:[^,@}'"\n]|'[^']*'|"[^"]*")+)`;
+    inner = inner
+        .replaceAll(new RegExp(String.raw `\s*@\s*[\w]+\s*=\s*${OPT_VAL}`, 'g'), '')
+        .replaceAll(new RegExp(String.raw `,\s*\w+\s*=\s*${OPT_VAL}`, 'g'), '')
+        .replaceAll(/,\s*\w+\b(?!\s*[=.(])/g, '')
+        .replaceAll(/\s*@\s*\w+\b/g, '')
+        .replaceAll(/\s*@\s*$/g, '')
+        .replaceAll(/\.size\b/g, '.length')
+        .replaceAll(/(\w+)\.jcr:(\w+)/g, "$1?.['jcr:$2']")
+        .trim();
+    arrays.forEach((arr, i) => { inner = inner.replace(`__ARR${i}__`, arr); });
+    inner = inner.replaceAll(/(\w|\])(?<!\?)\[/g, '$1?.[');
+    inner = inner.replaceAll(/(\w|\])\.([\w$])/g, (m, a, b) => /\d/.test(a) && /\d/.test(b) ? m : `${a}?.${b}`);
+    inner = inner.replaceAll(/(\S+)\s+in\s+(\S+)/g, (_, left, right) => {
+        return `(${right} && ${left} in ${right})`;
+    });
+    inner = inner.replaceAll(/(?<![?.])\b(class|for)\b/g, '_$1');
+    if (i18nMatch) {
+        const escapedKey = i18nMatch[2].replaceAll("'", String.raw `\'`);
+        inner = "_i18n?.['" + escapedKey + "'] ?? " + inner;
+    }
+    return inner;
+}
+/**
+ * Extracts all ${...} HTL expressions from a string, correctly handling
+ * any depth of nested braces (e.g. '{{url}}' or '{0}/{1}' placeholders).
+ */
+function extractExprs(str) {
+    const results = [];
+    let i = 0;
+    while (i < str.length) {
+        const start = str.indexOf('${', i);
+        if (start === -1)
+            break;
+        let depth = 0;
+        let j = start;
+        for (; j < str.length; j++) {
+            if (str[j] === '{')
+                depth++;
+            else if (str[j] === '}') {
+                depth--;
+                if (depth === 0)
+                    break;
+            }
+        }
+        if (depth === 0) {
+            results.push({ index: start, expr: str.slice(start + 2, j), end: j + 1 });
+        }
+        i = j + 1;
+    }
+    return results;
+}
+/**
+ * Converts all ${htlExpr} occurrences within an attribute value string,
+ * while escaping literal backticks and bare $ signs.
+ */
+function convertAttrValue(value) {
+    const parts = [];
+    let last = 0;
+    for (const { index, expr, end } of extractExprs(value)) {
+        if (index > last)
+            parts.push(escapeLiteral(value.slice(last, index)));
+        parts.push(`\${_htlAttr(${convertExpr(expr)})}`);
+        last = end;
+    }
+    if (last < value.length)
+        parts.push(escapeLiteral(value.slice(last)));
+    return parts.join('');
+}
+/**
+ * Converts HTL expressions in text node content, escaping everything else
+ * for safe embedding in a JS template literal.
+ */
+function convertTextContent(text) {
+    const parts = [];
+    let last = 0;
+    for (const { index, expr, end } of extractExprs(text)) {
+        if (index > last)
+            parts.push(escapeLiteral(text.slice(last, index)));
+        parts.push(`\${(${convertExpr(expr)}) ?? ''}`);
+        last = end;
+    }
+    if (last < text.length)
+        parts.push(escapeLiteral(text.slice(last)));
+    return parts.join('');
+}
+/**
+ * Escapes characters that would break a JS template literal.
+ */
+function escapeLiteral(str) {
+    return str
+        .replaceAll('\\', '\\\\')
+        .replaceAll('`', String.raw `\``)
+        .replaceAll(/\$(?!\{)/g, String.raw `\$`);
+}
+//# sourceMappingURL=expr.js.map

package/dist/transpiler/expr.js.map

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

package/dist/transpiler/index.d.ts

@@ -0,0 +1,15 @@
+interface TranspileOptions {
+    filename?: string;
+    omitAttrs?: RegExp[];
+    modelTransforms?: Record<string, Record<string, string>>;
+}
+/**
+ * Transpiles an HTL source string into a JavaScript module that exports
+ * a template function (or multiple named template functions).
+ *
+ * @param htlSource  - Raw HTL file content
+ * @param options
+ * @returns A valid CJS module source string
+ */
+export declare function transpile(htlSource: string, { filename, omitAttrs, modelTransforms }?: TranspileOptions): string;
+export {};