blogger-hbs 0.0.2 → 0.0.4

package/README.md

@@ -34,3 +34,123 @@ blogger-hbs --help   # all the options
 ```
 
 The same is available from JavaScript with `compileTemplate`, `watchTemplate` and `renderTemplate`.
+
+## Rendering anywhere
+
+The build writes `dist/compiled.js`, an ES module that imports nothing: the templates, scripts, styles and the runtimes of the plugins are all in it. `blogger-hbs/runtime` renders it in any JavaScript runtime (Node.js, Deno, Bun, Cloudflare Workers, a browser) without the compiler or Node.js.
+
+```ts
+// a Cloudflare Worker
+import { createRenderer } from 'blogger-hbs/runtime';
+import * as theme from './dist/compiled.js';
+
+// set up once, render many times, each render on its own
+const renderer = createRenderer(theme);
+
+export default {
+	async fetch() {
+		const html = await renderer.render({ title: 'Blog' });
+		return new Response(html, { headers: { 'content-type': 'text/html' } });
+	},
+};
+```
+
+`createRenderer(theme, { plugins })` takes runtime plugins of the host rendering the theme, for example with data of the request in `prepare`. The helpers of the theme itself are in `compiled.js`, see [Helpers of the theme](#helpers-of-the-theme). `formatXml` and `validateXml` are in `blogger-hbs/runtime` as well. A compiled module is rendered by the version of `blogger-hbs` it is compiled with, `createRenderer` checks it.
+
+## Helpers of the theme
+
+Helpers are given by the runtime of a plugin, which is bundled into `compiled.js`: the theme renders with them wherever it is rendered. A plugin of the theme itself only needs a name and its runtime.
+
+```ts
+// blogger-hbs.config.ts
+export default defineConfig({
+	plugins: [{ name: 'theme', runtime: { entry: './src/runtime.ts' } }],
+});
+```
+
+```ts
+// src/runtime.ts
+import { defineRuntimePlugin } from 'blogger-hbs/runtime';
+
+export default defineRuntimePlugin((api) => ({
+	helpers: {
+		upper: (text: string) => text.toUpperCase(),
+	},
+}));
+```
+
+## Plugins
+
+A compile plugin provides partials (`{{> name.partial}}`) and data (`{{@name.value}}`) when compiling, and can come with a runtime half for rendering.
+
+```ts
+import { fileURLToPath } from 'node:url';
+import type { CompilePlugin } from 'blogger-hbs';
+
+export function myPlugin(options: { prefix: string }): CompilePlugin {
+	return {
+		name: 'my',
+		provide({ requests }, plugin) {
+			// every partial used, with where and how: `{{> my.badge size=16}}`
+			for (const { name, usages } of requests) {
+				for (const usage of usages) {
+					if ('color' in usage.hash) {
+						plugin.error(`'color' is not a prop of ${name}`, usage);
+					}
+				}
+			}
+			return Object.fromEntries(
+				requests.map(({ name }) => [name, `<span class='${name}'/>`]),
+			);
+		},
+		// bundled into compiled.js, it can not use Node.js modules
+		runtime: {
+			entry: fileURLToPath(new URL('./runtime.js', import.meta.url)),
+			options: { prefix: options.prefix },
+		},
+	};
+}
+```
+
+```ts
+// runtime.ts, published as runtime.js
+import { defineRuntimePlugin } from 'blogger-hbs/runtime';
+
+export default defineRuntimePlugin((api, options: { prefix: string }) => ({
+	helpers: {
+		greet: (name: string) =>
+			new api.SafeString(`${options.prefix} ${api.escapeExpression(name)}`),
+	},
+	// before every render, can be async, read as `{{@my.posts}}`
+	async prepare(context) {
+		return { posts: [] };
+	},
+	// after every render
+	transform: (html) => html,
+}));
+```
+
+| Hook | When |
+| --- | --- |
+| `buildStart(plugin)` | first, in every compilation, also each time when watching |
+| `preprocess(templates, plugin)` | with every template, their ASTs can be changed |
+| `provide({ partials, requests, templates }, plugin)` | with the partials used, again for those the provided ones use |
+| `finalize({ provided, missing, requests, available }, plugin)` | once, for partials that need all the others |
+| `data({ provided, available, templates }, plugin)` | once, the values are JSON |
+| `buildEnd(plugin, error?)` | last, when the templates are compiled |
+
+### Partials of a plugin
+
+A plugin `my` provides its main partial and any names separated by single dots:
+
+| In a template | Key provided |
+| --- | --- |
+| `{{> my}}`, `{{#> my}}...{{/my}}` | `.` |
+| `{{> my.badge}}` | `badge` |
+| `{{> my.badge.small}}` | `badge.small` |
+
+A name is checked as it is written, `{{> my.}}`, `{{> my..badge}}`, `{{> my.badge.}}` and `{{> my/badge}}` are errors where they are, and a theme can not define an inline partial with a name of a plugin, `{{#*inline "my.badge"}}`. Partials of no plugin are left to Handlebars.
+
+Every hook gets the plugin context: `root`, `entry`, `mode`, `watch`, `resolve(specifier, importer?)` with the aliases, `addWatchFile(file)`, `warn(message, loc?)` and `error(message, loc?)`. `enforce: 'pre'` or `'post'` runs a plugin before or after the others.
+
+The runtime halves of all the plugins are bundled together, a module they share (a dependency of two plugins) is in `compiled.js` once and is the same instance for both. The runtime half is set up with `api` (`SafeString`, `escapeExpression`, `createFrame`, `HelperError`) and the options, which are JSON. Its helpers also work with `renderTemplate`, `prepare` and `transform` need `createRenderer`.

package/dist/cli/index.js

@@ -2,13 +2,10 @@ 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 { createRenderer } from "../runtime/render.js";
 import * as path from "node:path";
 import * as fs from "node:fs/promises";
 import { createRequire } from "node:module";
@@ -20,6 +17,7 @@ const { version } = createRequire(import.meta.url)("../../package.json");
 const log = {
 	success: (message) => console.log(`${styleText("green", "✓")} ${message}`),
 	info: (message) => console.log(`${styleText("cyan", "●")} ${message}`),
+	warn: (message) => console.warn(`${styleText("yellow", "⚠")} ${message}`),
 	error: (error) => console.error(`${styleText("red", "✗")} ${formatError(error)}`)
 };
 const cli = cac("blogger-hbs");
@@ -69,6 +67,7 @@ async function setup(root, flags) {
 	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;
+	options.onWarn ??= log.warn;
 	assertCompileOptions(options);
 	await assertDirectories(options);
 	const outDir = path.resolve(resolvedRoot, flags.outDir ?? output.dir ?? "dist");
@@ -219,7 +218,7 @@ async function watchBuild(root, flags) {
 	const stop = async () => {
 		stopWatchers();
 		await watcher?.close();
-		process.exit(0);
+		setTimeout(() => process.exit(0), 3e3).unref();
 	};
 	process.once("SIGINT", stop);
 	process.once("SIGTERM", stop);
@@ -264,17 +263,13 @@ async function prepareOutDir({ outDir, clean }) {
 * formatted after rendering when enabled.
 */
 async function write(current, compiled) {
-	const { outDir, moduleFile, templateFile, context, loaded } = current;
+	const { outDir, moduleFile, templateFile, context } = 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
-	});
+	const rendered = await createRenderer(compiled).render(context);
 	log.success(`Rendered in ${elapsed(start)}`);
 	start = performance.now();
 	let output;

package/dist/cli/index.js.map

@@ -1 +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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"}
+{"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 { createRenderer } 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\twarn: (message: string) =>\n\t\tconsole.warn(`${styleText('yellow', '⚠')} ${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\toptions.onWarn ??= log.warn;\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\t// the process ends once nothing is left running: `process.exit` would skip\n\t\t// the cleanup of rspack's native bindings, which then warn about leaks,\n\t\t// so it is only a fallback for something left running, a plugin's timer\n\t\tsetTimeout(() => process.exit(0), 3000).unref();\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 } = 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\t// the same as anywhere else the compiled module is rendered\n\tlet start = performance.now();\n\tconst renderer = createRenderer(compiled);\n\tconst rendered = await renderer.render(context);\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/index.d.ts

@@ -1,6 +1,6 @@
 import { BlockStatement, BooleanLiteral, CommentStatement, ContentStatement, Decorator, DecoratorBlock, Expression, Hash, HashPair, Literal, MustacheStatement, Node, NullLiteral, NumberLiteral, PartialBlockStatement, PartialStatement, PathExpression, Position, Program, SourceLocation, Statement, StringLiteral, StripFlags, SubExpression, UndefinedLiteral } from "./types.js";
 import { setHashString } from "./hash.js";
 import { Import, ImportNode, InvalidImport, ValidImport, extractImports, isImportNode } from "./imports.js";
-import { findPartials } from "./partials.js";
+import { HashLiteral, InlinePartial, PartialUsageNode, findInlinePartials, findPartialUsages, findPartials } from "./partials.js";
 import { walk } from "./walk.js";
-export { BlockStatement, BooleanLiteral, CommentStatement, ContentStatement, Decorator, DecoratorBlock, Expression, Hash, HashPair, Import, ImportNode, InvalidImport, Literal, MustacheStatement, Node, NullLiteral, NumberLiteral, PartialBlockStatement, PartialStatement, PathExpression, Position, Program, SourceLocation, Statement, StringLiteral, StripFlags, SubExpression, UndefinedLiteral, ValidImport, extractImports, findPartials, isImportNode, setHashString, walk };
+export { BlockStatement, BooleanLiteral, CommentStatement, ContentStatement, Decorator, DecoratorBlock, Expression, Hash, HashLiteral, HashPair, Import, ImportNode, InlinePartial, InvalidImport, Literal, MustacheStatement, Node, NullLiteral, NumberLiteral, PartialBlockStatement, PartialStatement, PartialUsageNode, PathExpression, Position, Program, SourceLocation, Statement, StringLiteral, StripFlags, SubExpression, UndefinedLiteral, ValidImport, extractImports, findInlinePartials, findPartialUsages, findPartials, isImportNode, setHashString, walk };

package/dist/compiler/ast/index.js

@@ -1,5 +1,5 @@
 import { setHashString } from "./hash.js";
 import { walk } from "./walk.js";
 import { extractImports, isImportNode } from "./imports.js";
-import { findPartials } from "./partials.js";
-export { extractImports, findPartials, isImportNode, setHashString, walk };
+import { findInlinePartials, findPartialUsages, findPartials } from "./partials.js";
+export { extractImports, findInlinePartials, findPartialUsages, findPartials, isImportNode, setHashString, walk };

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

@@ -2,5 +2,36 @@ import { Program } from "./types.js";
 //#region src/compiler/ast/partials.d.ts
 /** Names of the partials used by name, `{{> name}}` and `{{#> name}}`. */
 export declare function findPartials(root: Program): string[];
+export type HashLiteral = string | number | boolean | null | undefined;
+export interface PartialUsageNode {
+  /** The name as Handlebars reads it. */
+  name: string;
+  /**
+   * The name as it is written, when the source is given, `name` otherwise:
+   * Handlebars reads `p.` and `p..a` as `p`, and `p.a.` as `p.a`.
+   */
+  raw: string;
+  /** 1-based, undefined when the node has no location, made by a plugin. */
+  line?: number;
+  /** 1-based. */
+  column?: number;
+  hash: Record<string, HashLiteral | {
+    expression: string;
+  }>;
+}
+/**
+ * Every use of a partial by name, in the order they are written. With the
+ * `source` of the template, as it was parsed, the names are as written.
+ */
+export declare function findPartialUsages(root: Program, source?: string): PartialUsageNode[];
+export interface InlinePartial {
+  name: string;
+  /** 1-based, undefined when the node has no location. */
+  line?: number;
+  /** 1-based. */
+  column?: number;
+}
+/** The partials defined in the template, `{{#*inline "name"}}`. */
+export declare function findInlinePartials(root: Program): InlinePartial[];
 //#endregion
 //# sourceMappingURL=partials.d.ts.map

package/dist/compiler/ast/partials.js

@@ -2,13 +2,91 @@ import { walk } from "./walk.js";
 //#region src/compiler/ast/partials.ts
 /** Names of the partials used by name, `{{> name}}` and `{{#> name}}`. */
 function findPartials(root) {
-	const names = /* @__PURE__ */ new Set();
+	return [...new Set(findPartialUsages(root).map(({ name }) => name))];
+}
+/**
+* Every use of a partial by name, in the order they are written. With the
+* `source` of the template, as it was parsed, the names are as written.
+*/
+function findPartialUsages(root, source) {
+	const usages = [];
+	const offsetOf = source === void 0 ? void 0 : createOffsets(source);
 	walk(root, (node) => {
-		if ((node.type === "PartialStatement" || node.type === "PartialBlockStatement") && node.name.type === "PathExpression" && !node.name.original.startsWith("@")) names.add(node.name.original);
+		if ((node.type === "PartialStatement" || node.type === "PartialBlockStatement") && node.name.type === "PathExpression" && !node.name.original.startsWith("@")) {
+			const { original, loc } = node.name;
+			const written = loc && offsetOf && source !== void 0 ? /^(?:\[[^\]]*\]|[^\s}~()[])+/.exec(source.slice(offsetOf(loc.start.line, loc.start.column)))?.[0] : void 0;
+			usages.push(toUsage(node, original, written ?? original));
+		}
 	});
-	return [...names];
+	return usages;
+}
+/** The partials defined in the template, `{{#*inline "name"}}`. */
+function findInlinePartials(root) {
+	const inline = [];
+	walk(root, (node) => {
+		if (node.type !== "DecoratorBlock" || node.path.original !== "inline") return;
+		const [name] = node.params;
+		if (name?.type === "StringLiteral") {
+			const start = node.loc?.start;
+			inline.push({
+				name: name.value,
+				line: start?.line,
+				column: start === void 0 ? void 0 : start.column + 1
+			});
+		}
+	});
+	return inline;
+}
+/** The offset in `source` of a line (1-based) and a column (0-based). */
+function createOffsets(source) {
+	const starts = [0];
+	for (let i = source.indexOf("\n"); i !== -1; i = source.indexOf("\n", i + 1)) starts.push(i + 1);
+	return (line, column) => (starts[line - 1] ?? 0) + column;
+}
+function toUsage(node, name, raw) {
+	const start = node.loc?.start;
+	return {
+		name,
+		raw,
+		line: start?.line,
+		column: start === void 0 ? void 0 : start.column + 1,
+		hash: hashValues(node.hash)
+	};
+}
+function hashValues(hash) {
+	const values = Object.create(null);
+	for (const { key, value } of hash?.pairs ?? []) values[key] = isLiteral(value) ? literalValue(value) : { expression: print(value) };
+	return values;
+}
+function isLiteral(node) {
+	return node.type !== "PathExpression" && node.type !== "SubExpression";
+}
+function literalValue(node) {
+	switch (node.type) {
+		case "StringLiteral":
+		case "NumberLiteral":
+		case "BooleanLiteral": return node.value;
+		case "NullLiteral": return null;
+		default: return;
+	}
+}
+/** The expression as it can be written in a template. */
+function print(node) {
+	switch (node.type) {
+		case "PathExpression": return node.original;
+		case "StringLiteral": return JSON.stringify(node.value);
+		case "NumberLiteral":
+		case "BooleanLiteral": return String(node.value);
+		case "NullLiteral": return "null";
+		case "UndefinedLiteral": return "undefined";
+		case "SubExpression": {
+			const parts = [node.path.original, ...node.params.map(print)];
+			for (const { key, value } of node.hash?.pairs ?? []) parts.push(`${key}=${print(value)}`);
+			return `(${parts.join(" ")})`;
+		}
+	}
 }
 //#endregion
-export { findPartials };
+export { findInlinePartials, findPartialUsages, findPartials };
 
 //# sourceMappingURL=partials.js.map

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

@@ -1 +1 @@
-{"version":3,"file":"partials.js","names":[],"sources":["../../../src/compiler/ast/partials.ts"],"sourcesContent":["import type { Program } from './types';\nimport { walk } from './walk';\n\n/** Names of the partials used by name, `{{> name}}` and `{{#> name}}`. */\nexport function findPartials(root: Program): string[] {\n\tconst names = new Set<string>();\n\n\twalk(root, (node) => {\n\t\tif (\n\t\t\t(node.type === 'PartialStatement' ||\n\t\t\t\tnode.type === 'PartialBlockStatement') &&\n\t\t\tnode.name.type === 'PathExpression' &&\n\t\t\t!node.name.original.startsWith('@')\n\t\t) {\n\t\t\tnames.add(node.name.original);\n\t\t}\n\t});\n\n\treturn [...names];\n}\n"],"mappings":";;;AAIA,SAAgB,aAAa,MAAyB;CACrD,MAAM,wBAAQ,IAAI,IAAY;CAE9B,KAAK,OAAO,SAAS;EACpB,KACE,KAAK,SAAS,sBACd,KAAK,SAAS,4BACf,KAAK,KAAK,SAAS,oBACnB,CAAC,KAAK,KAAK,SAAS,WAAW,GAAG,GAElC,MAAM,IAAI,KAAK,KAAK,QAAQ;CAE9B,CAAC;CAED,OAAO,CAAC,GAAG,KAAK;AACjB"}
+{"version":3,"file":"partials.js","names":[],"sources":["../../../src/compiler/ast/partials.ts"],"sourcesContent":["import type {\n\tExpression,\n\tHash,\n\tPartialBlockStatement,\n\tPartialStatement,\n\tProgram,\n} from './types';\nimport { walk } from './walk';\n\n/** Names of the partials used by name, `{{> name}}` and `{{#> name}}`. */\nexport function findPartials(root: Program): string[] {\n\treturn [...new Set(findPartialUsages(root).map(({ name }) => name))];\n}\n\nexport type HashLiteral = string | number | boolean | null | undefined;\n\nexport interface PartialUsageNode {\n\t/** The name as Handlebars reads it. */\n\tname: string;\n\t/**\n\t * The name as it is written, when the source is given, `name` otherwise:\n\t * Handlebars reads `p.` and `p..a` as `p`, and `p.a.` as `p.a`.\n\t */\n\traw: string;\n\t/** 1-based, undefined when the node has no location, made by a plugin. */\n\tline?: number;\n\t/** 1-based. */\n\tcolumn?: number;\n\thash: Record<string, HashLiteral | { expression: string }>;\n}\n\n/**\n * Every use of a partial by name, in the order they are written. With the\n * `source` of the template, as it was parsed, the names are as written.\n */\nexport function findPartialUsages(\n\troot: Program,\n\tsource?: string,\n): PartialUsageNode[] {\n\tconst usages: PartialUsageNode[] = [];\n\tconst offsetOf = source === undefined ? undefined : createOffsets(source);\n\n\twalk(root, (node) => {\n\t\tif (\n\t\t\t(node.type === 'PartialStatement' ||\n\t\t\t\tnode.type === 'PartialBlockStatement') &&\n\t\t\tnode.name.type === 'PathExpression' &&\n\t\t\t!node.name.original.startsWith('@')\n\t\t) {\n\t\t\tconst { original, loc } = node.name;\n\t\t\t// a name ends at what can not be in one, a space, `}`, `~` or `(`,\n\t\t\t// unless it is in a `[segment]`\n\t\t\tconst written =\n\t\t\t\tloc && offsetOf && source !== undefined\n\t\t\t\t\t? /^(?:\\[[^\\]]*\\]|[^\\s}~()[])+/.exec(\n\t\t\t\t\t\t\tsource.slice(offsetOf(loc.start.line, loc.start.column)),\n\t\t\t\t\t\t)?.[0]\n\t\t\t\t\t: undefined;\n\t\t\tusages.push(toUsage(node, original, written ?? original));\n\t\t}\n\t});\n\n\treturn usages;\n}\n\nexport interface InlinePartial {\n\tname: string;\n\t/** 1-based, undefined when the node has no location. */\n\tline?: number;\n\t/** 1-based. */\n\tcolumn?: number;\n}\n\n/** The partials defined in the template, `{{#*inline \"name\"}}`. */\nexport function findInlinePartials(root: Program): InlinePartial[] {\n\tconst inline: InlinePartial[] = [];\n\n\twalk(root, (node) => {\n\t\tif (node.type !== 'DecoratorBlock' || node.path.original !== 'inline') {\n\t\t\treturn;\n\t\t}\n\t\tconst [name] = node.params;\n\t\tif (name?.type === 'StringLiteral') {\n\t\t\tconst start = node.loc?.start;\n\t\t\tinline.push({\n\t\t\t\tname: name.value,\n\t\t\t\tline: start?.line,\n\t\t\t\tcolumn: start === undefined ? undefined : start.column + 1,\n\t\t\t});\n\t\t}\n\t});\n\n\treturn inline;\n}\n\n/** The offset in `source` of a line (1-based) and a column (0-based). */\nfunction createOffsets(\n\tsource: string,\n): (line: number, column: number) => number {\n\tconst starts = [0];\n\tfor (\n\t\tlet i = source.indexOf('\\n');\n\t\ti !== -1;\n\t\ti = source.indexOf('\\n', i + 1)\n\t) {\n\t\tstarts.push(i + 1);\n\t}\n\treturn (line, column) => (starts[line - 1] ?? 0) + column;\n}\n\nfunction toUsage(\n\tnode: PartialStatement | PartialBlockStatement,\n\tname: string,\n\traw: string,\n): PartialUsageNode {\n\tconst start = node.loc?.start;\n\treturn {\n\t\tname,\n\t\traw,\n\t\tline: start?.line,\n\t\t// Handlebars counts columns from 0\n\t\tcolumn: start === undefined ? undefined : start.column + 1,\n\t\thash: hashValues(node.hash),\n\t};\n}\n\nfunction hashValues(\n\thash: Hash | undefined,\n): Record<string, HashLiteral | { expression: string }> {\n\tconst values: Record<string, HashLiteral | { expression: string }> =\n\t\tObject.create(null);\n\tfor (const { key, value } of hash?.pairs ?? []) {\n\t\tvalues[key] = isLiteral(value)\n\t\t\t? literalValue(value)\n\t\t\t: { expression: print(value) };\n\t}\n\treturn values;\n}\n\nfunction isLiteral(node: Expression): boolean {\n\treturn node.type !== 'PathExpression' && node.type !== 'SubExpression';\n}\n\nfunction literalValue(node: Expression): HashLiteral {\n\tswitch (node.type) {\n\t\tcase 'StringLiteral':\n\t\tcase 'NumberLiteral':\n\t\tcase 'BooleanLiteral':\n\t\t\treturn node.value;\n\t\tcase 'NullLiteral':\n\t\t\treturn null;\n\t\tdefault:\n\t\t\treturn undefined;\n\t}\n}\n\n/** The expression as it can be written in a template. */\nfunction print(node: Expression): string {\n\tswitch (node.type) {\n\t\tcase 'PathExpression':\n\t\t\treturn node.original;\n\t\tcase 'StringLiteral':\n\t\t\treturn JSON.stringify(node.value);\n\t\tcase 'NumberLiteral':\n\t\tcase 'BooleanLiteral':\n\t\t\treturn String(node.value);\n\t\tcase 'NullLiteral':\n\t\t\treturn 'null';\n\t\tcase 'UndefinedLiteral':\n\t\t\treturn 'undefined';\n\t\tcase 'SubExpression': {\n\t\t\tconst parts = [node.path.original, ...node.params.map(print)];\n\t\t\tfor (const { key, value } of node.hash?.pairs ?? []) {\n\t\t\t\tparts.push(`${key}=${print(value)}`);\n\t\t\t}\n\t\t\treturn `(${parts.join(' ')})`;\n\t\t}\n\t}\n}\n"],"mappings":"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"}

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

@@ -25,7 +25,10 @@ export interface MustacheStatement extends BaseStatement {
   escaped: boolean;
   strip: StripFlags;
 }
-export interface Decorator extends MustacheStatement {}
+/** `{{* decorator}}` */
+export interface Decorator extends Omit<MustacheStatement, 'type'> {
+  type: 'Decorator';
+}
 export interface BlockStatement extends BaseStatement {
   type: 'BlockStatement';
   path: PathExpression;
@@ -37,7 +40,10 @@ export interface BlockStatement extends BaseStatement {
   inverseStrip: StripFlags;
   closeStrip: StripFlags;
 }
-export interface DecoratorBlock extends BlockStatement {}
+/** `{{#*inline "name"}}...{{/inline}}` */
+export interface DecoratorBlock extends Omit<BlockStatement, 'type'> {
+  type: 'DecoratorBlock';
+}
 export interface PartialStatement extends BaseStatement {
   type: 'PartialStatement';
   name: PathExpression | SubExpression;
@@ -65,7 +71,7 @@ export interface CommentStatement extends BaseStatement {
   value: string;
   strip: StripFlags;
 }
-export type Statement = MustacheStatement | BlockStatement | PartialStatement | PartialBlockStatement | ContentStatement | CommentStatement;
+export type Statement = MustacheStatement | BlockStatement | Decorator | DecoratorBlock | PartialStatement | PartialBlockStatement | ContentStatement | CommentStatement;
 interface BaseExpression extends BaseNode {}
 export interface SubExpression extends BaseExpression {
   type: 'SubExpression';

package/dist/compiler/ast/walk.js

@@ -6,11 +6,13 @@ function walk(node, callback) {
 			for (const statement of node.body) walk(statement, callback);
 			break;
 		case "MustacheStatement":
+		case "Decorator":
 			walk(node.path, callback);
 			for (const param of node.params) walk(param, callback);
 			if (node.hash) walk(node.hash, callback);
 			break;
 		case "BlockStatement":
+		case "DecoratorBlock":
 			walk(node.path, callback);
 			for (const param of node.params) walk(param, callback);
 			if (node.hash) walk(node.hash, callback);

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

@@ -1 +1 @@
-{"version":3,"file":"walk.js","names":[],"sources":["../../../src/compiler/ast/walk.ts"],"sourcesContent":["import type { Node } from './types';\n\nexport function walk(node: Node, callback: (node: Node) => void): void {\n\tcallback(node);\n\n\tswitch (node.type) {\n\t\tcase 'Program':\n\t\t\tfor (const statement of node.body) {\n\t\t\t\twalk(statement, callback);\n\t\t\t}\n\t\t\tbreak;\n\n\t\tcase 'MustacheStatement':\n\t\t\twalk(node.path, callback);\n\t\t\tfor (const param of node.params) {\n\t\t\t\twalk(param, callback);\n\t\t\t}\n\t\t\tif (node.hash) {\n\t\t\t\twalk(node.hash, callback);\n\t\t\t}\n\t\t\tbreak;\n\n\t\tcase 'BlockStatement':\n\t\t\twalk(node.path, callback);\n\t\t\tfor (const param of node.params) {\n\t\t\t\twalk(param, callback);\n\t\t\t}\n\t\t\tif (node.hash) {\n\t\t\t\twalk(node.hash, callback);\n\t\t\t}\n\t\t\twalk(node.program, callback);\n\n\t\t\tif (node.inverse) {\n\t\t\t\twalk(node.inverse, callback);\n\t\t\t}\n\t\t\tbreak;\n\n\t\tcase 'PartialStatement':\n\t\t\twalk(node.name, callback);\n\t\t\tfor (const param of node.params) {\n\t\t\t\twalk(param, callback);\n\t\t\t}\n\t\t\tif (node.hash) {\n\t\t\t\twalk(node.hash, callback);\n\t\t\t}\n\t\t\tbreak;\n\n\t\tcase 'PartialBlockStatement':\n\t\t\twalk(node.name, callback);\n\t\t\tfor (const param of node.params) {\n\t\t\t\twalk(param, callback);\n\t\t\t}\n\t\t\tif (node.hash) {\n\t\t\t\twalk(node.hash, callback);\n\t\t\t}\n\t\t\twalk(node.program, callback);\n\t\t\tbreak;\n\n\t\tcase 'SubExpression':\n\t\t\twalk(node.path, callback);\n\t\t\tfor (const param of node.params) {\n\t\t\t\twalk(param, callback);\n\t\t\t}\n\t\t\tif (node.hash) {\n\t\t\t\twalk(node.hash, callback);\n\t\t\t}\n\t\t\tbreak;\n\n\t\tcase 'Hash':\n\t\t\tfor (const pair of node.pairs) {\n\t\t\t\twalk(pair, callback);\n\t\t\t}\n\t\t\tbreak;\n\n\t\tcase 'HashPair':\n\t\t\twalk(node.value, callback);\n\t\t\tbreak;\n\t}\n}\n\nexport * from './types';\n"],"mappings":";AAEA,SAAgB,KAAK,MAAY,UAAsC;CACtE,SAAS,IAAI;CAEb,QAAQ,KAAK,MAAb;EACC,KAAK;GACJ,KAAK,MAAM,aAAa,KAAK,MAC5B,KAAK,WAAW,QAAQ;GAEzB;EAED,KAAK;GACJ,KAAK,KAAK,MAAM,QAAQ;GACxB,KAAK,MAAM,SAAS,KAAK,QACxB,KAAK,OAAO,QAAQ;GAErB,IAAI,KAAK,MACR,KAAK,KAAK,MAAM,QAAQ;GAEzB;EAED,KAAK;GACJ,KAAK,KAAK,MAAM,QAAQ;GACxB,KAAK,MAAM,SAAS,KAAK,QACxB,KAAK,OAAO,QAAQ;GAErB,IAAI,KAAK,MACR,KAAK,KAAK,MAAM,QAAQ;GAEzB,KAAK,KAAK,SAAS,QAAQ;GAE3B,IAAI,KAAK,SACR,KAAK,KAAK,SAAS,QAAQ;GAE5B;EAED,KAAK;GACJ,KAAK,KAAK,MAAM,QAAQ;GACxB,KAAK,MAAM,SAAS,KAAK,QACxB,KAAK,OAAO,QAAQ;GAErB,IAAI,KAAK,MACR,KAAK,KAAK,MAAM,QAAQ;GAEzB;EAED,KAAK;GACJ,KAAK,KAAK,MAAM,QAAQ;GACxB,KAAK,MAAM,SAAS,KAAK,QACxB,KAAK,OAAO,QAAQ;GAErB,IAAI,KAAK,MACR,KAAK,KAAK,MAAM,QAAQ;GAEzB,KAAK,KAAK,SAAS,QAAQ;GAC3B;EAED,KAAK;GACJ,KAAK,KAAK,MAAM,QAAQ;GACxB,KAAK,MAAM,SAAS,KAAK,QACxB,KAAK,OAAO,QAAQ;GAErB,IAAI,KAAK,MACR,KAAK,KAAK,MAAM,QAAQ;GAEzB;EAED,KAAK;GACJ,KAAK,MAAM,QAAQ,KAAK,OACvB,KAAK,MAAM,QAAQ;GAEpB;EAED,KAAK,YACJ,KAAK,KAAK,OAAO,QAAQ;CAE3B;AACD"}
+{"version":3,"file":"walk.js","names":[],"sources":["../../../src/compiler/ast/walk.ts"],"sourcesContent":["import type { Node } from './types';\n\nexport function walk(node: Node, callback: (node: Node) => void): void {\n\tcallback(node);\n\n\tswitch (node.type) {\n\t\tcase 'Program':\n\t\t\tfor (const statement of node.body) {\n\t\t\t\twalk(statement, callback);\n\t\t\t}\n\t\t\tbreak;\n\n\t\tcase 'MustacheStatement':\n\t\tcase 'Decorator':\n\t\t\twalk(node.path, callback);\n\t\t\tfor (const param of node.params) {\n\t\t\t\twalk(param, callback);\n\t\t\t}\n\t\t\tif (node.hash) {\n\t\t\t\twalk(node.hash, callback);\n\t\t\t}\n\t\t\tbreak;\n\n\t\tcase 'BlockStatement':\n\t\tcase 'DecoratorBlock':\n\t\t\twalk(node.path, callback);\n\t\t\tfor (const param of node.params) {\n\t\t\t\twalk(param, callback);\n\t\t\t}\n\t\t\tif (node.hash) {\n\t\t\t\twalk(node.hash, callback);\n\t\t\t}\n\t\t\twalk(node.program, callback);\n\n\t\t\tif (node.inverse) {\n\t\t\t\twalk(node.inverse, callback);\n\t\t\t}\n\t\t\tbreak;\n\n\t\tcase 'PartialStatement':\n\t\t\twalk(node.name, callback);\n\t\t\tfor (const param of node.params) {\n\t\t\t\twalk(param, callback);\n\t\t\t}\n\t\t\tif (node.hash) {\n\t\t\t\twalk(node.hash, callback);\n\t\t\t}\n\t\t\tbreak;\n\n\t\tcase 'PartialBlockStatement':\n\t\t\twalk(node.name, callback);\n\t\t\tfor (const param of node.params) {\n\t\t\t\twalk(param, callback);\n\t\t\t}\n\t\t\tif (node.hash) {\n\t\t\t\twalk(node.hash, callback);\n\t\t\t}\n\t\t\twalk(node.program, callback);\n\t\t\tbreak;\n\n\t\tcase 'SubExpression':\n\t\t\twalk(node.path, callback);\n\t\t\tfor (const param of node.params) {\n\t\t\t\twalk(param, callback);\n\t\t\t}\n\t\t\tif (node.hash) {\n\t\t\t\twalk(node.hash, callback);\n\t\t\t}\n\t\t\tbreak;\n\n\t\tcase 'Hash':\n\t\t\tfor (const pair of node.pairs) {\n\t\t\t\twalk(pair, callback);\n\t\t\t}\n\t\t\tbreak;\n\n\t\tcase 'HashPair':\n\t\t\twalk(node.value, callback);\n\t\t\tbreak;\n\t}\n}\n\nexport * from './types';\n"],"mappings":";AAEA,SAAgB,KAAK,MAAY,UAAsC;CACtE,SAAS,IAAI;CAEb,QAAQ,KAAK,MAAb;EACC,KAAK;GACJ,KAAK,MAAM,aAAa,KAAK,MAC5B,KAAK,WAAW,QAAQ;GAEzB;EAED,KAAK;EACL,KAAK;GACJ,KAAK,KAAK,MAAM,QAAQ;GACxB,KAAK,MAAM,SAAS,KAAK,QACxB,KAAK,OAAO,QAAQ;GAErB,IAAI,KAAK,MACR,KAAK,KAAK,MAAM,QAAQ;GAEzB;EAED,KAAK;EACL,KAAK;GACJ,KAAK,KAAK,MAAM,QAAQ;GACxB,KAAK,MAAM,SAAS,KAAK,QACxB,KAAK,OAAO,QAAQ;GAErB,IAAI,KAAK,MACR,KAAK,KAAK,MAAM,QAAQ;GAEzB,KAAK,KAAK,SAAS,QAAQ;GAE3B,IAAI,KAAK,SACR,KAAK,KAAK,SAAS,QAAQ;GAE5B;EAED,KAAK;GACJ,KAAK,KAAK,MAAM,QAAQ;GACxB,KAAK,MAAM,SAAS,KAAK,QACxB,KAAK,OAAO,QAAQ;GAErB,IAAI,KAAK,MACR,KAAK,KAAK,MAAM,QAAQ;GAEzB;EAED,KAAK;GACJ,KAAK,KAAK,MAAM,QAAQ;GACxB,KAAK,MAAM,SAAS,KAAK,QACxB,KAAK,OAAO,QAAQ;GAErB,IAAI,KAAK,MACR,KAAK,KAAK,MAAM,QAAQ;GAEzB,KAAK,KAAK,SAAS,QAAQ;GAC3B;EAED,KAAK;GACJ,KAAK,KAAK,MAAM,QAAQ;GACxB,KAAK,MAAM,SAAS,KAAK,QACxB,KAAK,OAAO,QAAQ;GAErB,IAAI,KAAK,MACR,KAAK,KAAK,MAAM,QAAQ;GAEzB;EAED,KAAK;GACJ,KAAK,MAAM,QAAQ,KAAK,OACvB,KAAK,MAAM,QAAQ;GAEpB;EAED,KAAK,YACJ,KAAK,KAAK,OAAO,QAAQ;CAE3B;AACD"}

package/dist/compiler/compile.d.ts

@@ -1,7 +1,9 @@
+import { CompilePlugin } from "../plugins/index.js";
 import { PluginData } from "../runtime/chunks.js";
 import { Chunks, PartialChunk } from "./chunks.js";
 import { RsbuildOptions } from "./rsbuild.js";
-import { CompilePlugin } from "../plugins/index.js";
+import { RuntimeRequest } from "./plugins.js";
+import { BundledRuntime, RuntimeBundle } from "./runtimes.js";
 //#region src/compiler/compile.d.ts
 export interface CompileTemplateOptions {
   root?: string;
@@ -10,22 +12,29 @@ export interface CompileTemplateOptions {
   plugins?: CompilePlugin[];
   /** Rsbuild config for bundling scripts and styles, merged over the defaults. */
   rsbuild?: RsbuildOptions;
+  /** Called with the warnings of plugins, `console.warn` by default. */
+  onWarn?: (message: string) => void;
 }
 export interface CompiledTemplate {
+  /** Version of the compiled output, checked by the runtime. */
+  format: number;
   chunks: Chunks;
   /** Templates provided by plugins, by partial name. */
   pluginPartials: Map<string, object>;
   /** Data provided by plugins, by plugin name and data name. */
   pluginData: PluginData;
+  /** Runtime halves of the plugins, bundled. */
+  bundledPlugins: BundledRuntime[];
   entry: string;
+  /** The ES module to render the template with, it imports nothing. */
   source: string;
 }
 /**
  * scan imports -> compile plugins -> validate dependencies -> precompile
- * templates -> bundle assets -> emit module source.
+ * templates -> bundle assets and plugin runtimes -> emit module source.
  */
 export declare function compileTemplate(options?: CompileTemplateOptions): Promise<CompiledTemplate>;
-/** A template compiled up to the bundling of its scripts and styles. */
+/** A template compiled up to the bundling of its scripts, styles and plugin runtimes. */
 export interface PreparedTemplate {
   root: string;
   /** Id of the entry template. */
@@ -33,16 +42,23 @@ export interface PreparedTemplate {
   chunks: Chunks;
   partials: PartialChunk[];
   pluginData: PluginData;
+  /** The runtime halves of the plugins, to bundle. */
+  runtimes: RuntimeRequest[];
   /** The entries each script entry depends on. */
   dependencies: Map<string, string[]>;
 }
-/**
- * Everything but bundling the scripts and styles, for validated options.
- * `onRead` is called with every template and json file before it is read,
- * even when compiling fails.
- */
-export declare function prepareTemplate(options?: CompileTemplateOptions, onRead?: (file: string) => void): Promise<PreparedTemplate>;
-/** Emits the module source of a template whose scripts and styles are bundled. */
-export declare function finishTemplate({ entry, chunks, partials, pluginData }: PreparedTemplate): CompiledTemplate;
+export interface PrepareOptions {
+  /**
+   * Called with every template and json file before it is read, and the files
+   * plugins add, even when compiling fails.
+   */
+  onRead?: (file: string) => void;
+  /** Whether the template is compiled again on changes, told to plugins. */
+  watch?: boolean;
+}
+/** Everything but bundling the scripts, styles and plugin runtimes, for validated options. */
+export declare function prepareTemplate(options?: CompileTemplateOptions, { onRead, watch }?: PrepareOptions): Promise<PreparedTemplate>;
+/** Emits the module source of a template whose scripts, styles and runtimes are bundled. */
+export declare function finishTemplate({ entry, chunks, partials, pluginData }: PreparedTemplate, bundle: RuntimeBundle | undefined): CompiledTemplate;
 //#endregion
 //# sourceMappingURL=compile.d.ts.map