blogger-hbs 0.0.0 → 0.0.2

package/LICENSE.md

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026-present Deo Kumar <https://github.com/kumardeo>
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -0,0 +1,36 @@
+# blogger-hbs
+
+Build Blogger themes from Handlebars templates, with bundled scripts and styles.
+
+> [!WARNING]
+> `blogger-hbs` is experimental. Its API, options and output can change in any release, without a major version bump, and it can have bugs. Pin an exact version and check the output before relying on it.
+
+- Split a theme into templates with `{{import "./header.hbs"}}`, data with `{{import "./data.json"}}`.
+- Import scripts and styles, bundled with [Rsbuild](https://rsbuild.rs) and inlined: `{{import "./main.ts"}}`.
+- Every template is validated as XML, and the rendered theme is validated and formatted as Blogger saves it.
+- Compile plugins provide partials and data, runtime plugins provide helpers.
+
+## Usage
+
+```sh
+pnpm add -D blogger-hbs
+```
+
+```ts
+// blogger-hbs.config.ts
+import { defineConfig } from 'blogger-hbs';
+
+export default defineConfig({
+	entry: 'src/index.hbs',
+	alias: { '~': 'src' },
+	context: {},
+});
+```
+
+```sh
+blogger-hbs          # build to dist/theme.xml
+blogger-hbs --watch  # build again on changes
+blogger-hbs --help   # all the options
+```
+
+The same is available from JavaScript with `compileTemplate`, `watchTemplate` and `renderTemplate`.

package/bin/blogger-hbs.js

@@ -0,0 +1,2 @@
+#!/usr/bin/env node
+import '../dist/cli/index.js';

package/dist/_virtual/_rolldown/runtime.js

@@ -0,0 +1,13 @@
+//#region \0rolldown/runtime.js
+var __defProp = Object.defineProperty;
+var __exportAll = (all, no_symbols) => {
+	let target = {};
+	for (var name in all) __defProp(target, name, {
+		get: all[name],
+		enumerable: true
+	});
+	if (!no_symbols) __defProp(target, Symbol.toStringTag, { value: "Module" });
+	return target;
+};
+//#endregion
+export { __exportAll };

package/dist/cli/index.d.ts

@@ -0,0 +1 @@
+export {}

package/dist/cli/index.js

@@ -0,0 +1,315 @@
+import { CompileError } from "../compiler/errors.js";
+import { didYouMean } from "../utils/suggest.js";
+import { COMPILE_OPTION_KEYS, assertCompileOptions, assertDirectories, assertEntry, resolvePaths } from "../compiler/options.js";
+import { formatXml, validateXml } from "../xml/format.js";
+import "../xml/index.js";
+import { compileTemplate } from "../compiler/compile.js";
+import { watchTemplate } from "../compiler/watch.js";
+import "../compiler/index.js";
+import { loadConfig } from "../config.js";
+import { renderTemplate } from "../runtime/render.js";
+import "../runtime/index.js";
+import * as path from "node:path";
+import * as fs from "node:fs/promises";
+import { createRequire } from "node:module";
+import { watch } from "node:fs";
+import { styleText } from "node:util";
+import { cac } from "cac";
+//#region src/cli/index.ts
+const { version } = createRequire(import.meta.url)("../../package.json");
+const log = {
+	success: (message) => console.log(`${styleText("green", "✓")} ${message}`),
+	info: (message) => console.log(`${styleText("cyan", "●")} ${message}`),
+	error: (error) => console.error(`${styleText("red", "✗")} ${formatError(error)}`)
+};
+const cli = cac("blogger-hbs");
+cli.command("[root]", "Compile the template and render it").alias("build").option("-c, --config <file>", "Path of the config file").option("--entry <file>", "Entry template, relative to the root").option("-o, --out-dir <dir>", "Output directory, relative to the root").option("--context <file>", "JSON file with the context to render with").option("-w, --watch", "Build again when a file changes").option("--no-clean", "Keep the files in the output directory").option("--no-validate", "Do not validate the rendered template as XML, nor format it (templates are always validated when compiling)").option("--no-format", "Do not format the rendered template").example("blogger-hbs").example("blogger-hbs --watch").example("blogger-hbs ./theme --entry src/index.hbs --context context.json").action(async (rootArg, rawFlags) => {
+	const text = (value) => value === void 0 ? void 0 : String(value);
+	const root = text(rootArg);
+	const flags = {
+		...rawFlags,
+		config: text(rawFlags.config),
+		entry: text(rawFlags.entry),
+		outDir: text(rawFlags.outDir),
+		context: text(rawFlags.context)
+	};
+	if (flags.watch) await watchBuild(root, flags);
+	else await build(root, flags);
+});
+cli.help();
+cli.version(version);
+try {
+	cli.parse(process.argv, { run: false });
+	await cli.runMatchedCommand();
+} catch (error) {
+	log.error(describeCliError(error));
+	process.exitCode = 1;
+}
+/** Adds a suggestion and a pointer to `--help` to the errors of the arguments. */
+function describeCliError(error) {
+	if (!(error instanceof Error) || error.name !== "CACError") return error;
+	const flags = [...cli.commands, cli.globalCommand].flatMap((command) => command.options.flatMap((option) => option.rawName.match(/--[\w-]+/g) ?? []));
+	const unknown = /^Unknown option `(.+)`$/.exec(error.message)?.[1];
+	const hint = unknown ? didYouMean(unknown, flags, "`") : "";
+	return /* @__PURE__ */ new Error(`${error.message}${hint}\n  Run 'blogger-hbs --help' to see the available options`);
+}
+async function setup(root, flags) {
+	const cwd = process.cwd();
+	const rootFlag = root === void 0 ? void 0 : path.resolve(cwd, root);
+	if (rootFlag !== void 0 && !await isDirectory(rootFlag)) throw new CompileError(await exists(rootFlag) ? `Root '${root}' is not a directory` : `Root directory '${root}' does not exist`);
+	const loaded = await loadConfig({
+		cwd: rootFlag ?? cwd,
+		configFile: flags.config && path.resolve(cwd, flags.config),
+		watch: flags.watch
+	});
+	const { config } = loaded;
+	const resolvedRoot = rootFlag ?? config.root ?? cwd;
+	const output = config.output ?? {};
+	const options = {};
+	for (const key of COMPILE_OPTION_KEYS) if (key in config) Object.assign(options, { [key]: config[key] });
+	options.root = resolvedRoot;
+	options.entry = flags.entry ?? config.entry;
+	assertCompileOptions(options);
+	await assertDirectories(options);
+	const outDir = path.resolve(resolvedRoot, flags.outDir ?? output.dir ?? "dist");
+	const clean = flags.clean === false ? false : output.clean ?? true;
+	if (clean) assertCleanable(outDir, options);
+	return {
+		options,
+		loaded,
+		outDir,
+		moduleFile: output.module ?? "compiled.js",
+		templateFile: output.template ?? "theme.xml",
+		validate: flags.validate === false ? false : output.validate ?? true,
+		format: flags.format === false ? false : output.format ?? true,
+		clean,
+		context: flags.context ? await readContext(path.resolve(cwd, flags.context), flags.context) : config.context ?? {},
+		publicDir: await resolvePublicDir(resolvedRoot, config.publicDir, outDir)
+	};
+}
+/** The public directory, `public` when it exists unless set otherwise. */
+async function resolvePublicDir(root, value, outDir) {
+	if (value === false) return;
+	const directory = path.resolve(root, value ?? "public");
+	const shown = path.relative(process.cwd(), directory) || ".";
+	if (!await isDirectory(directory)) {
+		if (value === void 0) return;
+		throw new CompileError(await exists(directory) ? `Public directory '${shown}' is not a directory` : `Public directory '${shown}' does not exist, set 'publicDir: false' to not copy anything`);
+	}
+	if (isInside(outDir, directory) || isInside(directory, outDir)) throw new CompileError(`Public directory '${shown}' and output directory '${path.relative(process.cwd(), outDir) || "."}' overlap, they must be separate`);
+	return directory;
+}
+/** Copies the public directory into the output directory. */
+async function copyPublic({ publicDir, outDir, moduleFile, templateFile }) {
+	if (publicDir === void 0) return;
+	for (const name of await fs.readdir(publicDir)) if (name === moduleFile || name === templateFile) throw new CompileError(`'${name}' in the public directory has the same name as the ${name === moduleFile ? "compiled module" : "rendered template"} and would be overwritten, rename it or set 'output.${name === moduleFile ? "module" : "template"}'`);
+	await fs.cp(publicDir, outDir, {
+		recursive: true,
+		force: true
+	});
+}
+/**
+* Cleaning removes everything in the output directory, which must not hold the
+* project: the root, the working directory, the templates or an alias target.
+*/
+function assertCleanable(outDir, options) {
+	const { root, entry } = resolvePaths(options);
+	const shown = path.relative(process.cwd(), outDir) || ".";
+	const kept = [
+		[root, "the root"],
+		[process.cwd(), "the working directory"],
+		[path.dirname(entry), "the entry template"],
+		...Object.entries(options.alias ?? {}).map(([name, target]) => [path.resolve(root, target), `the target of the alias '${name}'`])
+	];
+	for (const [directory, what] of kept) if (isInside(directory, outDir)) throw new CompileError(`Refusing to clean the output directory '${shown}', it contains ${what}. Use another output directory, or --no-clean / 'output.clean: false' to keep its files`);
+}
+async function readContext(file, shown) {
+	let text;
+	try {
+		text = await fs.readFile(file, "utf-8");
+	} catch (cause) {
+		if (cause.code === "ENOENT") throw new CompileError(`Context file '${shown}' not found`);
+		throw new CompileError(`Failed to read the context file '${shown}'`, { cause });
+	}
+	try {
+		return JSON.parse(text);
+	} catch (cause) {
+		throw new CompileError(`Context file '${shown}' is not valid JSON: ${cause.message}`);
+	}
+}
+/** Whether `child` is `parent` or inside of it. */
+function isInside(child, parent) {
+	const relative = path.relative(parent, child);
+	return relative === "" || !relative.startsWith("..") && !path.isAbsolute(relative);
+}
+async function exists(file) {
+	return fs.stat(file).then(() => true, () => false);
+}
+async function isDirectory(file) {
+	return fs.stat(file).then((stats) => stats.isDirectory(), () => false);
+}
+async function build(root, flags) {
+	const current = await setup(root, flags);
+	await assertEntry(current.options);
+	await prepareOutDir(current);
+	await copyPublic(current);
+	const start = performance.now();
+	const compiled = await compileTemplate(current.options);
+	log.success(`Compiled in ${elapsed(start)}`);
+	await write(current, compiled);
+}
+/** Watches the template and restarts when the config file changes. */
+async function watchBuild(root, flags) {
+	let current = await setup(root, flags);
+	await prepareOutDir(current);
+	let watcher;
+	let watchers = [];
+	let restarting = false;
+	const start = async () => {
+		let begin = performance.now();
+		let first = true;
+		try {
+			await copyPublic(current);
+		} catch (error) {
+			log.error(error);
+		}
+		watcher = await watchTemplate({
+			...current.options,
+			onStart() {
+				begin = performance.now();
+			},
+			async onCompile(compiled) {
+				log.success(`${first ? "Compiled" : "Rebuilt"} in ${elapsed(begin)}`);
+				first = false;
+				await write(current, compiled);
+			},
+			onError: log.error
+		});
+		for (const file of current.loaded.dependencies) try {
+			const configWatcher = watch(file, () => {
+				if (!restarting) {
+					restarting = true;
+					restart().finally(() => {
+						restarting = false;
+					});
+				}
+			});
+			configWatcher.on("error", () => configWatcher.close());
+			watchers.push(configWatcher);
+		} catch {}
+		if (current.publicDir !== void 0) watchers.push(watchPublic(current));
+	};
+	const stopWatchers = () => {
+		for (const fileWatcher of watchers) fileWatcher.close();
+		watchers = [];
+	};
+	const restart = async () => {
+		log.info(`Config changed, restarting ${styleText("dim", path.relative(process.cwd(), current.loaded.file ?? ""))}`);
+		stopWatchers();
+		await watcher?.close();
+		try {
+			current = await setup(root, flags);
+		} catch (error) {
+			log.error(error);
+		}
+		await start();
+	};
+	await start();
+	log.info(`Watching for changes ${styleText("dim", "(press Ctrl+C to stop)")}`);
+	const stop = async () => {
+		stopWatchers();
+		await watcher?.close();
+		process.exit(0);
+	};
+	process.once("SIGINT", stop);
+	process.once("SIGTERM", stop);
+}
+/** Copies the public directory again when something in it changes. */
+function watchPublic(current) {
+	const publicDir = current.publicDir;
+	const changed = /* @__PURE__ */ new Set();
+	let timer;
+	const sync = async () => {
+		const names = [...changed];
+		changed.clear();
+		try {
+			for (const name of names) if (!await exists(path.join(publicDir, name))) await fs.rm(path.join(current.outDir, name), {
+				recursive: true,
+				force: true
+			});
+			await copyPublic(current);
+			log.success(`Copied ${styleText("dim", path.relative(process.cwd(), publicDir))}`);
+		} catch (error) {
+			log.error(error);
+		}
+	};
+	const publicWatcher = watch(publicDir, { recursive: true }, (_event, name) => {
+		if (name) changed.add(name);
+		clearTimeout(timer);
+		timer = setTimeout(sync, 50);
+	});
+	publicWatcher.on("error", () => publicWatcher.close());
+	publicWatcher.on("close", () => clearTimeout(timer));
+	return publicWatcher;
+}
+async function prepareOutDir({ outDir, clean }) {
+	if (clean) await fs.rm(outDir, {
+		recursive: true,
+		force: true
+	});
+	await fs.mkdir(outDir, { recursive: true });
+}
+/**
+* Writes the compiled module and the rendered template, validated and
+* formatted after rendering when enabled.
+*/
+async function write(current, compiled) {
+	const { outDir, moduleFile, templateFile, context, loaded } = current;
+	if (moduleFile) await fs.writeFile(path.join(outDir, moduleFile), compiled.source);
+	if (!templateFile) return;
+	const file = path.join(outDir, templateFile);
+	const shown = path.relative(process.cwd(), file);
+	let start = performance.now();
+	const rendered = renderTemplate({
+		...compiled,
+		context,
+		plugins: loaded.config.runtimePlugins
+	});
+	log.success(`Rendered in ${elapsed(start)}`);
+	start = performance.now();
+	let output;
+	try {
+		output = finalizeXml(current, rendered);
+	} catch (error) {
+		await fs.writeFile(file, rendered);
+		throw new CompileError(`The rendered template ${shown} is not valid XML: ${error.message}`);
+	}
+	if (current.validate) log.success(`${current.format ? "Formatted" : "Validated"} in ${elapsed(start)}`);
+	await fs.writeFile(file, output);
+	log.success(`Written ${styleText("dim", shown)}`);
+}
+/** Validates and formats the rendered template, as enabled. */
+function finalizeXml({ validate, format }, xml) {
+	if (!validate) return xml;
+	if (!format) {
+		validateXml(xml);
+		return xml;
+	}
+	return formatXml(xml);
+}
+function elapsed(start) {
+	return styleText("yellow", `${Math.round(performance.now() - start)}ms`);
+}
+/** The message of the error and of everything that caused it. */
+function formatError(error) {
+	const lines = [];
+	let current = error;
+	while (current !== void 0) {
+		lines.push(current instanceof Error ? `${lines.length === 0 ? "" : "Caused by: "}${current.message}` : String(current));
+		current = current instanceof Error ? current.cause : void 0;
+	}
+	return lines.join("\n  ");
+}
+//#endregion
+
+//# sourceMappingURL=index.js.map

package/dist/cli/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","names":[],"sources":["../../src/cli/index.ts"],"sourcesContent":["import { type FSWatcher, watch } from 'node:fs';\nimport * as fs from 'node:fs/promises';\nimport { createRequire } from 'node:module';\nimport * as path from 'node:path';\nimport { styleText } from 'node:util';\nimport { cac } from 'cac';\nimport {\n\ttype CompiledTemplate,\n\tCompileError,\n\ttype CompileTemplateOptions,\n\tcompileTemplate,\n\ttype TemplateWatcher,\n\twatchTemplate,\n} from '../compiler';\nimport {\n\tassertCompileOptions,\n\tassertDirectories,\n\tassertEntry,\n\tCOMPILE_OPTION_KEYS,\n\tresolvePaths,\n} from '../compiler/options';\nimport { type LoadedConfig, loadConfig } from '../config';\nimport { renderTemplate } from '../runtime';\nimport { didYouMean } from '../utils/suggest';\nimport { formatXml, validateXml } from '../xml';\n\nconst { version } = createRequire(import.meta.url)('../../package.json') as {\n\tversion: string;\n};\n\ninterface BuildFlags {\n\tconfig?: string;\n\tentry?: string;\n\toutDir?: string;\n\tcontext?: string;\n\twatch?: boolean;\n\tclean?: boolean;\n\tvalidate?: boolean;\n\tformat?: boolean;\n}\n\n/** Everything a build needs, from the config file and the flags. */\ninterface BuildSetup {\n\toptions: CompileTemplateOptions;\n\tloaded: LoadedConfig;\n\toutDir: string;\n\tmoduleFile: string | false;\n\ttemplateFile: string | false;\n\tclean: boolean;\n\tcontext: unknown;\n\t/** Whether the rendered template is validated. */\n\tvalidate: boolean;\n\t/** Whether the rendered template is formatted, only when it is validated. */\n\tformat: boolean;\n\t/** Absolute path of the public directory, undefined when nothing is copied. */\n\tpublicDir?: string;\n}\n\nconst log = {\n\tsuccess: (message: string) =>\n\t\tconsole.log(`${styleText('green', '✓')} ${message}`),\n\tinfo: (message: string) =>\n\t\tconsole.log(`${styleText('cyan', '●')} ${message}`),\n\terror: (error: unknown) =>\n\t\tconsole.error(`${styleText('red', '✗')} ${formatError(error)}`),\n};\n\nconst cli = cac('blogger-hbs');\n\ncli\n\t.command('[root]', 'Compile the template and render it')\n\t.alias('build')\n\t.option('-c, --config <file>', 'Path of the config file')\n\t.option('--entry <file>', 'Entry template, relative to the root')\n\t.option('-o, --out-dir <dir>', 'Output directory, relative to the root')\n\t.option('--context <file>', 'JSON file with the context to render with')\n\t.option('-w, --watch', 'Build again when a file changes')\n\t.option('--no-clean', 'Keep the files in the output directory')\n\t.option(\n\t\t'--no-validate',\n\t\t'Do not validate the rendered template as XML, nor format it (templates are always validated when compiling)',\n\t)\n\t.option('--no-format', 'Do not format the rendered template')\n\t.example('blogger-hbs')\n\t.example('blogger-hbs --watch')\n\t.example('blogger-hbs ./theme --entry src/index.hbs --context context.json')\n\t.action(async (rootArg: unknown, rawFlags: BuildFlags) => {\n\t\t// cac turns values that look like numbers into numbers, `-o 2024`\n\t\tconst text = (value: unknown) =>\n\t\t\tvalue === undefined ? undefined : String(value);\n\t\tconst root = text(rootArg);\n\t\tconst flags: BuildFlags = {\n\t\t\t...rawFlags,\n\t\t\tconfig: text(rawFlags.config),\n\t\t\tentry: text(rawFlags.entry),\n\t\t\toutDir: text(rawFlags.outDir),\n\t\t\tcontext: text(rawFlags.context),\n\t\t};\n\n\t\tif (flags.watch) {\n\t\t\tawait watchBuild(root, flags);\n\t\t} else {\n\t\t\tawait build(root, flags);\n\t\t}\n\t});\n\ncli.help();\ncli.version(version);\n\ntry {\n\tcli.parse(process.argv, { run: false });\n\tawait cli.runMatchedCommand();\n} catch (error) {\n\tlog.error(describeCliError(error));\n\tprocess.exitCode = 1;\n}\n\n/** Adds a suggestion and a pointer to `--help` to the errors of the arguments. */\nfunction describeCliError(error: unknown): unknown {\n\tif (!(error instanceof Error) || error.name !== 'CACError') {\n\t\treturn error;\n\t}\n\n\tconst flags = [...cli.commands, cli.globalCommand].flatMap((command) =>\n\t\tcommand.options.flatMap(\n\t\t\t(option) => option.rawName.match(/--[\\w-]+/g) ?? [],\n\t\t),\n\t);\n\tconst unknown = /^Unknown option `(.+)`$/.exec(error.message)?.[1];\n\tconst hint = unknown ? didYouMean(unknown, flags, '`') : '';\n\n\treturn new Error(\n\t\t`${error.message}${hint}\\n  Run 'blogger-hbs --help' to see the available options`,\n\t);\n}\n\nasync function setup(\n\troot: string | undefined,\n\tflags: BuildFlags,\n): Promise<BuildSetup> {\n\tconst cwd = process.cwd();\n\tconst rootFlag = root === undefined ? undefined : path.resolve(cwd, root);\n\n\t// the config is looked for in the root, which has to exist for that\n\tif (rootFlag !== undefined && !(await isDirectory(rootFlag))) {\n\t\tthrow new CompileError(\n\t\t\t(await exists(rootFlag))\n\t\t\t\t? `Root '${root}' is not a directory`\n\t\t\t\t: `Root directory '${root}' does not exist`,\n\t\t);\n\t}\n\n\tconst loaded = await loadConfig({\n\t\tcwd: rootFlag ?? cwd,\n\t\tconfigFile: flags.config && path.resolve(cwd, flags.config),\n\t\twatch: flags.watch,\n\t});\n\tconst { config } = loaded;\n\n\tconst resolvedRoot = rootFlag ?? config.root ?? cwd;\n\tconst output = config.output ?? {};\n\n\t// the config has more than the compile options\n\tconst options: CompileTemplateOptions = {};\n\tfor (const key of COMPILE_OPTION_KEYS) {\n\t\tif (key in config) {\n\t\t\tObject.assign(options, { [key]: config[key as keyof typeof config] });\n\t\t}\n\t}\n\toptions.root = resolvedRoot;\n\toptions.entry = flags.entry ?? config.entry;\n\n\tassertCompileOptions(options);\n\tawait assertDirectories(options);\n\n\tconst outDir = path.resolve(\n\t\tresolvedRoot,\n\t\tflags.outDir ?? output.dir ?? 'dist',\n\t);\n\tconst clean = flags.clean === false ? false : (output.clean ?? true);\n\tif (clean) {\n\t\tassertCleanable(outDir, options);\n\t}\n\n\treturn {\n\t\toptions,\n\t\tloaded,\n\t\toutDir,\n\t\tmoduleFile: output.module ?? 'compiled.js',\n\t\ttemplateFile: output.template ?? 'theme.xml',\n\t\tvalidate: flags.validate === false ? false : (output.validate ?? true),\n\t\tformat: flags.format === false ? false : (output.format ?? true),\n\t\tclean,\n\t\tcontext: flags.context\n\t\t\t? await readContext(path.resolve(cwd, flags.context), flags.context)\n\t\t\t: (config.context ?? {}),\n\t\tpublicDir: await resolvePublicDir(resolvedRoot, config.publicDir, outDir),\n\t};\n}\n\n/** The public directory, `public` when it exists unless set otherwise. */\nasync function resolvePublicDir(\n\troot: string,\n\tvalue: string | false | undefined,\n\toutDir: string,\n): Promise<string | undefined> {\n\tif (value === false) {\n\t\treturn;\n\t}\n\n\tconst directory = path.resolve(root, value ?? 'public');\n\tconst shown = path.relative(process.cwd(), directory) || '.';\n\n\tif (!(await isDirectory(directory))) {\n\t\tif (value === undefined) {\n\t\t\treturn;\n\t\t}\n\t\tthrow new CompileError(\n\t\t\t(await exists(directory))\n\t\t\t\t? `Public directory '${shown}' is not a directory`\n\t\t\t\t: `Public directory '${shown}' does not exist, set 'publicDir: false' to not copy anything`,\n\t\t);\n\t}\n\n\tif (isInside(outDir, directory) || isInside(directory, outDir)) {\n\t\tthrow new CompileError(\n\t\t\t`Public directory '${shown}' and output directory '${path.relative(process.cwd(), outDir) || '.'}' overlap, they must be separate`,\n\t\t);\n\t}\n\n\treturn directory;\n}\n\n/** Copies the public directory into the output directory. */\nasync function copyPublic({\n\tpublicDir,\n\toutDir,\n\tmoduleFile,\n\ttemplateFile,\n}: BuildSetup): Promise<void> {\n\tif (publicDir === undefined) {\n\t\treturn;\n\t}\n\n\tfor (const name of await fs.readdir(publicDir)) {\n\t\tif (name === moduleFile || name === templateFile) {\n\t\t\tthrow new CompileError(\n\t\t\t\t`'${name}' in the public directory has the same name as the ${name === moduleFile ? 'compiled module' : 'rendered template'} and would be overwritten, rename it or set 'output.${name === moduleFile ? 'module' : 'template'}'`,\n\t\t\t);\n\t\t}\n\t}\n\n\tawait fs.cp(publicDir, outDir, { recursive: true, force: true });\n}\n\n/**\n * Cleaning removes everything in the output directory, which must not hold the\n * project: the root, the working directory, the templates or an alias target.\n */\nfunction assertCleanable(outDir: string, options: CompileTemplateOptions) {\n\tconst { root, entry } = resolvePaths(options);\n\tconst shown = path.relative(process.cwd(), outDir) || '.';\n\tconst kept: [string, string][] = [\n\t\t[root, 'the root'],\n\t\t[process.cwd(), 'the working directory'],\n\t\t[path.dirname(entry), 'the entry template'],\n\t\t...Object.entries(options.alias ?? {}).map(\n\t\t\t([name, target]): [string, string] => [\n\t\t\t\tpath.resolve(root, target),\n\t\t\t\t`the target of the alias '${name}'`,\n\t\t\t],\n\t\t),\n\t];\n\n\tfor (const [directory, what] of kept) {\n\t\tif (isInside(directory, outDir)) {\n\t\t\tthrow new CompileError(\n\t\t\t\t`Refusing to clean the output directory '${shown}', it contains ${what}. Use another output directory, or --no-clean / 'output.clean: false' to keep its files`,\n\t\t\t);\n\t\t}\n\t}\n}\n\nasync function readContext(file: string, shown: string): Promise<unknown> {\n\tlet text: string;\n\ttry {\n\t\ttext = await fs.readFile(file, 'utf-8');\n\t} catch (cause) {\n\t\tif ((cause as NodeJS.ErrnoException).code === 'ENOENT') {\n\t\t\tthrow new CompileError(`Context file '${shown}' not found`);\n\t\t}\n\t\tthrow new CompileError(`Failed to read the context file '${shown}'`, {\n\t\t\tcause,\n\t\t});\n\t}\n\n\ttry {\n\t\treturn JSON.parse(text);\n\t} catch (cause) {\n\t\tthrow new CompileError(\n\t\t\t`Context file '${shown}' is not valid JSON: ${(cause as Error).message}`,\n\t\t);\n\t}\n}\n\n/** Whether `child` is `parent` or inside of it. */\nfunction isInside(child: string, parent: string): boolean {\n\tconst relative = path.relative(parent, child);\n\treturn (\n\t\trelative === '' ||\n\t\t(!relative.startsWith('..') && !path.isAbsolute(relative))\n\t);\n}\n\nasync function exists(file: string): Promise<boolean> {\n\treturn fs.stat(file).then(\n\t\t() => true,\n\t\t() => false,\n\t);\n}\n\nasync function isDirectory(file: string): Promise<boolean> {\n\treturn fs.stat(file).then(\n\t\t(stats) => stats.isDirectory(),\n\t\t() => false,\n\t);\n}\n\nasync function build(root: string | undefined, flags: BuildFlags) {\n\tconst current = await setup(root, flags);\n\t// nothing is written when there is nothing to build, the watcher waits\n\t// for the entry instead\n\tawait assertEntry(current.options);\n\tawait prepareOutDir(current);\n\tawait copyPublic(current);\n\n\tconst start = performance.now();\n\tconst compiled = await compileTemplate(current.options);\n\tlog.success(`Compiled in ${elapsed(start)}`);\n\n\tawait write(current, compiled);\n}\n\n/** Watches the template and restarts when the config file changes. */\nasync function watchBuild(root: string | undefined, flags: BuildFlags) {\n\tlet current = await setup(root, flags);\n\tawait prepareOutDir(current);\n\n\tlet watcher: TemplateWatcher | undefined;\n\tlet watchers: FSWatcher[] = [];\n\tlet restarting = false;\n\n\tconst start = async () => {\n\t\tlet begin = performance.now();\n\t\tlet first = true;\n\n\t\ttry {\n\t\t\tawait copyPublic(current);\n\t\t} catch (error) {\n\t\t\tlog.error(error);\n\t\t}\n\n\t\twatcher = await watchTemplate({\n\t\t\t...current.options,\n\t\t\tonStart() {\n\t\t\t\tbegin = performance.now();\n\t\t\t},\n\t\t\tasync onCompile(compiled) {\n\t\t\t\tlog.success(`${first ? 'Compiled' : 'Rebuilt'} in ${elapsed(begin)}`);\n\t\t\t\tfirst = false;\n\t\t\t\tawait write(current, compiled);\n\t\t\t},\n\t\t\tonError: log.error,\n\t\t});\n\n\t\tfor (const file of current.loaded.dependencies) {\n\t\t\ttry {\n\t\t\t\tconst configWatcher = watch(file, () => {\n\t\t\t\t\t// saving fires more than once, a restart is enough\n\t\t\t\t\tif (!restarting) {\n\t\t\t\t\t\trestarting = true;\n\t\t\t\t\t\trestart().finally(() => {\n\t\t\t\t\t\t\trestarting = false;\n\t\t\t\t\t\t});\n\t\t\t\t\t}\n\t\t\t\t});\n\t\t\t\tconfigWatcher.on('error', () => configWatcher.close());\n\t\t\t\twatchers.push(configWatcher);\n\t\t\t} catch {\n\t\t\t\t// a dependency that can not be watched does not restart\n\t\t\t}\n\t\t}\n\n\t\tif (current.publicDir !== undefined) {\n\t\t\twatchers.push(watchPublic(current));\n\t\t}\n\t};\n\n\tconst stopWatchers = () => {\n\t\tfor (const fileWatcher of watchers) {\n\t\t\tfileWatcher.close();\n\t\t}\n\t\twatchers = [];\n\t};\n\n\tconst restart = async () => {\n\t\tlog.info(\n\t\t\t`Config changed, restarting ${styleText('dim', path.relative(process.cwd(), current.loaded.file ?? ''))}`,\n\t\t);\n\t\tstopWatchers();\n\t\tawait watcher?.close();\n\t\ttry {\n\t\t\tcurrent = await setup(root, flags);\n\t\t} catch (error) {\n\t\t\tlog.error(error);\n\t\t}\n\t\tawait start();\n\t};\n\n\tawait start();\n\tlog.info(\n\t\t`Watching for changes ${styleText('dim', '(press Ctrl+C to stop)')}`,\n\t);\n\n\tconst stop = async () => {\n\t\tstopWatchers();\n\t\tawait watcher?.close();\n\t\tprocess.exit(0);\n\t};\n\tprocess.once('SIGINT', stop);\n\tprocess.once('SIGTERM', stop);\n}\n\n/** Copies the public directory again when something in it changes. */\nfunction watchPublic(current: BuildSetup): FSWatcher {\n\tconst publicDir = current.publicDir as string;\n\tconst changed = new Set<string>();\n\tlet timer: NodeJS.Timeout | undefined;\n\n\tconst sync = async () => {\n\t\tconst names = [...changed];\n\t\tchanged.clear();\n\t\ttry {\n\t\t\t// what was deleted from the public directory goes from the output too\n\t\t\tfor (const name of names) {\n\t\t\t\tif (!(await exists(path.join(publicDir, name)))) {\n\t\t\t\t\tawait fs.rm(path.join(current.outDir, name), {\n\t\t\t\t\t\trecursive: true,\n\t\t\t\t\t\tforce: true,\n\t\t\t\t\t});\n\t\t\t\t}\n\t\t\t}\n\t\t\tawait copyPublic(current);\n\t\t\tlog.success(\n\t\t\t\t`Copied ${styleText('dim', path.relative(process.cwd(), publicDir))}`,\n\t\t\t);\n\t\t} catch (error) {\n\t\t\tlog.error(error);\n\t\t}\n\t};\n\n\tconst publicWatcher = watch(\n\t\tpublicDir,\n\t\t{ recursive: true },\n\t\t(_event, name) => {\n\t\t\tif (name) {\n\t\t\t\tchanged.add(name);\n\t\t\t}\n\t\t\tclearTimeout(timer);\n\t\t\ttimer = setTimeout(sync, 50);\n\t\t},\n\t);\n\tpublicWatcher.on('error', () => publicWatcher.close());\n\tpublicWatcher.on('close', () => clearTimeout(timer));\n\treturn publicWatcher;\n}\n\nasync function prepareOutDir({ outDir, clean }: BuildSetup) {\n\tif (clean) {\n\t\tawait fs.rm(outDir, { recursive: true, force: true });\n\t}\n\tawait fs.mkdir(outDir, { recursive: true });\n}\n\n/**\n * Writes the compiled module and the rendered template, validated and\n * formatted after rendering when enabled.\n */\nasync function write(current: BuildSetup, compiled: CompiledTemplate) {\n\tconst { outDir, moduleFile, templateFile, context, loaded } = current;\n\n\tif (moduleFile) {\n\t\tawait fs.writeFile(path.join(outDir, moduleFile), compiled.source);\n\t}\n\tif (!templateFile) {\n\t\treturn;\n\t}\n\n\tconst file = path.join(outDir, templateFile);\n\tconst shown = path.relative(process.cwd(), file);\n\n\tlet start = performance.now();\n\tconst rendered = renderTemplate({\n\t\t...compiled,\n\t\tcontext,\n\t\tplugins: loaded.config.runtimePlugins,\n\t});\n\tlog.success(`Rendered in ${elapsed(start)}`);\n\n\tstart = performance.now();\n\tlet output: string;\n\ttry {\n\t\toutput = finalizeXml(current, rendered);\n\t} catch (error) {\n\t\t// written anyway, to look at where it is invalid\n\t\tawait fs.writeFile(file, rendered);\n\t\tthrow new CompileError(\n\t\t\t`The rendered template ${shown} is not valid XML: ${(error as Error).message}`,\n\t\t);\n\t}\n\tif (current.validate) {\n\t\tlog.success(\n\t\t\t`${current.format ? 'Formatted' : 'Validated'} in ${elapsed(start)}`,\n\t\t);\n\t}\n\n\tawait fs.writeFile(file, output);\n\tlog.success(`Written ${styleText('dim', shown)}`);\n}\n\n/** Validates and formats the rendered template, as enabled. */\nfunction finalizeXml({ validate, format }: BuildSetup, xml: string): string {\n\tif (!validate) {\n\t\treturn xml;\n\t}\n\tif (!format) {\n\t\tvalidateXml(xml);\n\t\treturn xml;\n\t}\n\treturn formatXml(xml);\n}\n\nfunction elapsed(start: number): string {\n\treturn styleText('yellow', `${Math.round(performance.now() - start)}ms`);\n}\n\n/** The message of the error and of everything that caused it. */\nfunction formatError(error: unknown): string {\n\tconst lines: string[] = [];\n\tlet current: unknown = error;\n\n\twhile (current !== undefined) {\n\t\tlines.push(\n\t\t\tcurrent instanceof Error\n\t\t\t\t? `${lines.length === 0 ? '' : 'Caused by: '}${current.message}`\n\t\t\t\t: String(current),\n\t\t);\n\t\tcurrent = current instanceof Error ? current.cause : undefined;\n\t}\n\n\treturn lines.join('\\n  ');\n}\n"],"mappings":"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"}

package/dist/compiler/ast/hash.d.ts

@@ -0,0 +1,5 @@
+import { BlockStatement, MustacheStatement, SubExpression } from "./types.js";
+//#region src/compiler/ast/hash.d.ts
+export declare function setHashString(node: MustacheStatement | BlockStatement | SubExpression, key: string, value: string): void;
+//#endregion
+//# sourceMappingURL=hash.d.ts.map

package/dist/compiler/ast/hash.js

@@ -0,0 +1,24 @@
+//#region src/compiler/ast/hash.ts
+function setHashString(node, key, value) {
+	const { loc } = node;
+	node.hash ??= {
+		type: "Hash",
+		pairs: [],
+		loc
+	};
+	node.hash.pairs.push({
+		type: "HashPair",
+		key,
+		value: {
+			type: "StringLiteral",
+			value,
+			original: value,
+			loc
+		},
+		loc
+	});
+}
+//#endregion
+export { setHashString };
+
+//# sourceMappingURL=hash.js.map

package/dist/compiler/ast/hash.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"hash.js","names":[],"sources":["../../../src/compiler/ast/hash.ts"],"sourcesContent":["import type { BlockStatement, MustacheStatement, SubExpression } from './types';\n\nexport function setHashString(\n\tnode: MustacheStatement | BlockStatement | SubExpression,\n\tkey: string,\n\tvalue: string,\n): void {\n\tconst { loc } = node;\n\tnode.hash ??= { type: 'Hash', pairs: [], loc };\n\tnode.hash.pairs.push({\n\t\ttype: 'HashPair',\n\t\tkey,\n\t\tvalue: { type: 'StringLiteral', value, original: value, loc },\n\t\tloc,\n\t});\n}\n"],"mappings":";AAEA,SAAgB,cACf,MACA,KACA,OACO;CACP,MAAM,EAAE,QAAQ;CAChB,KAAK,SAAS;EAAE,MAAM;EAAQ,OAAO,CAAC;EAAG;CAAI;CAC7C,KAAK,KAAK,MAAM,KAAK;EACpB,MAAM;EACN;EACA,OAAO;GAAE,MAAM;GAAiB;GAAO,UAAU;GAAO;EAAI;EAC5D;CACD,CAAC;AACF"}

package/dist/compiler/ast/imports.d.ts

@@ -0,0 +1,25 @@
+import { BlockStatement, MustacheStatement, Node, PathExpression, SubExpression } from "./types.js";
+//#region src/compiler/ast/imports.d.ts
+interface Location {
+  start: [number, number];
+  end: [number, number];
+  node: ImportNode;
+}
+export interface ValidImport extends Location {
+  valid: true;
+  specifier: string;
+  dependsOn: string[];
+  hashKeys: string[];
+}
+export interface InvalidImport extends Location {
+  valid: false;
+  reason: string;
+}
+export type Import = ValidImport | InvalidImport;
+export declare function extractImports(node: Node): Import[];
+export type ImportNode = (MustacheStatement | BlockStatement | SubExpression) & {
+  path: PathExpression;
+};
+export declare function isImportNode(node: Node): node is ImportNode;
+//#endregion
+//# sourceMappingURL=imports.d.ts.map

package/dist/compiler/ast/imports.js

@@ -0,0 +1,144 @@
+import { ATTRIBUTE_NAME_REGEX } from "../../constants.js";
+import { walk } from "./walk.js";
+//#region src/compiler/ast/imports.ts
+const ASSET_KEYS = /* @__PURE__ */ new Set(["script", "style"]);
+const ASSET_ATTRIBUTE_REGEX = /^(?:script|style):(.+)$/s;
+/** Options rendering only the script or the styles of an import, raw without a tag. */
+const FLAG_KEYS = /* @__PURE__ */ new Map([
+	["script:raw", {
+		tag: "script",
+		raw: true
+	}],
+	["style:raw", {
+		tag: "style",
+		raw: true
+	}],
+	["script:only", {
+		tag: "script",
+		raw: false
+	}],
+	["style:only", {
+		tag: "style",
+		raw: false
+	}]
+]);
+function extractImports(node) {
+	const imports = [];
+	for (const importNode of extractImportNodes(node)) {
+		const { params, loc, hash } = importNode;
+		const location = {
+			start: [loc.start.line, loc.start.column],
+			end: [loc.end.line, loc.end.column],
+			node: importNode
+		};
+		const invalid = (reason) => {
+			imports.push({
+				...location,
+				valid: false,
+				reason
+			});
+		};
+		if (params.length === 0) {
+			invalid("'import' expects a string literal argument");
+			continue;
+		}
+		if (params.length > 1) {
+			invalid("'import' accepts only one argument");
+			continue;
+		}
+		const specifier = params[0];
+		if (specifier.type !== "StringLiteral") {
+			invalid("First argument to 'import' must be a string literal");
+			continue;
+		}
+		let dependsOn = [];
+		const hashKeys = [];
+		const seenKeys = /* @__PURE__ */ new Set();
+		let reason;
+		for (const { key, value } of hash?.pairs || []) {
+			if (seenKeys.has(key)) {
+				reason = `'import' option '${key}' was specified more than once`;
+				break;
+			}
+			seenKeys.add(key);
+			if (key === "depends-on") {
+				if (value.type !== "StringLiteral") {
+					reason = "'import' 'depends-on' must be a string literal";
+					break;
+				}
+				dependsOn = value.value.split(",").map((item) => item.trim()).filter(Boolean);
+				if (dependsOn.length === 0) {
+					reason = "'import' 'depends-on' must list at least one script or style";
+					break;
+				}
+				continue;
+			}
+			if (FLAG_KEYS.has(key)) {
+				if (!isFlagValue(value)) {
+					reason = `'import' option '${key}' must be true, 'true' or '', got: ${describeValue(value)}`;
+					break;
+				}
+				hashKeys.push(key);
+				continue;
+			}
+			if (ASSET_KEYS.has(key) || isAssetAttribute(key)) {
+				hashKeys.push(key);
+				continue;
+			}
+			reason = `'import' received an invalid option '${key}'`;
+			break;
+		}
+		const flag = hashKeys.find((key) => FLAG_KEYS.has(key));
+		const mode = flag === void 0 ? void 0 : FLAG_KEYS.get(flag);
+		if (reason === void 0 && flag !== void 0 && mode !== void 0) {
+			const omitted = mode.tag === "script" ? "style" : "script";
+			const conflict = hashKeys.find((key) => key !== flag && (mode.raw || FLAG_KEYS.has(key) || key === omitted || key.startsWith(`${omitted}:`)));
+			if (conflict !== void 0) reason = `'import' option '${flag}' cannot be combined with '${conflict}'`;
+		}
+		if (reason !== void 0) {
+			invalid(reason);
+			continue;
+		}
+		imports.push({
+			...location,
+			valid: true,
+			specifier: specifier.value,
+			dependsOn,
+			hashKeys
+		});
+	}
+	return imports;
+}
+function extractImportNodes(node) {
+	const nodes = [];
+	walk(node, (node) => {
+		if (isImportNode(node)) nodes.push(node);
+	});
+	return nodes;
+}
+function isImportNode(node) {
+	return (node.type === "MustacheStatement" || node.type === "BlockStatement" || node.type === "SubExpression") && node.path.type === "PathExpression" && node.path.parts.length === 1 && node.path.parts[0] === "import";
+}
+/** `script:raw` / `style:raw` / `script:only` / `style:only` take `true`, `'true'` or an empty string. */
+function isFlagValue(value) {
+	return value.type === "BooleanLiteral" && value.value || value.type === "StringLiteral" && (value.value === "true" || value.value === "");
+}
+function describeValue(value) {
+	switch (value.type) {
+		case "StringLiteral": return `'${value.value}'`;
+		case "BooleanLiteral":
+		case "NumberLiteral": return String(value.value);
+		case "NullLiteral": return "null";
+		case "UndefinedLiteral": return "undefined";
+		case "PathExpression": return `variable '${value.original}'`;
+		case "SubExpression": return `subexpression '${value.path.original}'`;
+	}
+}
+function isAssetAttribute(key) {
+	const name = ASSET_ATTRIBUTE_REGEX.exec(key)?.[1];
+	return name !== void 0 && ATTRIBUTE_NAME_REGEX.test(name);
+}
+//#endregion
+export { extractImports, isImportNode };
+
+//# sourceMappingURL=imports.js.map