@kurot/cli 1.0.2

package/dist/core/plugins/compile-exml.js

@@ -0,0 +1,223 @@
+import * as esbuild from 'esbuild';
+import * as os from 'node:os';
+import * as fs from 'node:fs/promises';
+import * as path from 'node:path';
+import { ensureDir, writeFile } from '../../utils/fs.js';
+import { logger } from '../../utils/logger.js';
+import { parseToIR, generateCode } from '../exml/index.js';
+/**
+ * Compiles `.exml` skin files into a single ESM module and rewrites the theme.
+ *
+ * Each skin becomes a real JS factory (`import { Skin, ... } from '@kurot/ui'`)
+ * bundled into `js/default.thm.js` (dev) or `js/default.thm.min_<hash>.js`
+ * (release). The module registers each factory on `globalThis` under its class
+ * name. The output `default.thm.json` keeps only the `skins` mapping plus a
+ * `skinsJs` pointer to that module, which the runtime `Theme` imports.
+ *
+ * The input theme follows Egret conventions; no `.exml` is shipped.
+ */
+export function compileExml() {
+    return {
+        name: 'compile EXML',
+        async apply(ctx) {
+            const { project } = ctx;
+            if (!project.config.exml || !project.themeFile)
+                return;
+            const theme = await loadTheme(project);
+            const files = await resolveExmlFiles(project, theme);
+            if (files.length === 0) {
+                logger.step('no .exml files found, skipping');
+                return;
+            }
+            const skins = files.map(file => ({ file, className: extractClassName(file) }));
+            const skinsFile = await buildSkinsModule(ctx, skins);
+            ctx.outputs.skinsScript = `js/${skinsFile}`;
+            const relThemePath = project.config.exml.themeFile;
+            const outTheme = { ...theme };
+            delete outTheme.exmls;
+            delete outTheme.autoGenerateExmlsList;
+            outTheme.skins = remapSkins(project, theme.skins ?? {}, skins);
+            outTheme.skinsJs = toPosix(path.relative(path.dirname(relThemePath), `js/${skinsFile}`));
+            await writeFile(path.join(project.outputDir, relThemePath), JSON.stringify(outTheme, null, '\t'));
+            logger.step(`compiled ${skins.length} skin(s) → ${ctx.outputs.skinsScript}`);
+        },
+    };
+}
+/**
+ * Generates one ESM module per skin in a temp dir, plus an index that imports
+ * and registers them, then bundles to `js/default.thm[.min_<hash>].js`.
+ *
+ * Engine packages and custom namespaces stay external (resolved by the page
+ * import map — see `compile-engine.ts` and `compile-custom-namespaces.ts`).
+ */
+async function buildSkinsModule(ctx, skins) {
+    const { project } = ctx;
+    const jsDir = path.join(project.outputDir, 'js');
+    await ensureDir(jsDir);
+    const customNamespaces = project.customNamespaces.map(ns => ({ prefix: ns.prefix, specifier: ns.specifier }));
+    const isRelease = project.mode === 'release';
+    const stubDir = await fs.mkdtemp(path.join(os.tmpdir(), 'kurot-skins-'));
+    try {
+        const indexLines = [];
+        await Promise.all(skins.map(async (skin, i) => {
+            const code = generateSkinModule(skin, customNamespaces, isRelease);
+            await fs.writeFile(path.join(stubDir, `skin${i}.ts`), code);
+            const funcName = factoryName(skin.className);
+            indexLines.push(`import { ${funcName} as s${i} } from './skin${i}.js';\n` +
+                `globalThis[${JSON.stringify(skin.className)}] = s${i};`);
+        }));
+        await fs.writeFile(path.join(stubDir, 'index.ts'), indexLines.join('\n\n') + '\n');
+        const engineExternal = project.enginePackages.length > 0 ? project.enginePackages : ['@kurot/ui', '@kurot/core'];
+        const result = await esbuild.build({
+            entryPoints: [path.join(stubDir, 'index.ts')],
+            outdir: jsDir,
+            entryNames: isRelease ? 'default.thm.min_[hash]' : 'default.thm',
+            bundle: true,
+            format: 'esm',
+            platform: 'browser',
+            target: 'es2022',
+            minify: isRelease,
+            metafile: true,
+            logLevel: 'warning',
+            external: [...engineExternal, ...project.customNamespaces.map(ns => ns.specifier)],
+        });
+        const output = Object.keys(result.metafile.outputs).find(f => f.endsWith('.js'));
+        return path.basename(output ?? 'default.thm.js');
+    }
+    finally {
+        await fs.rm(stubDir, { recursive: true, force: true });
+    }
+}
+/**
+ * Generates an ESM skin factory, returning a stub on parse failure.
+ */
+function generateSkinModule(skin, customNamespaces, strict) {
+    try {
+        const ir = parseToIR(skin.file.contents, skin.className, customNamespaces);
+        if (ir.unresolvedTags.length > 0) {
+            const tags = [...new Set(ir.unresolvedTags)].join(', ');
+            logger.warn(`${skin.file.relPath}: unresolved tag(s) dropped from skin: ${tags}`);
+        }
+        return generateCode(ir, { format: 'esm' });
+    }
+    catch (err) {
+        const message = err instanceof Error ? err.message : String(err);
+        if (strict) {
+            throw new Error(`EXML compile failed for ${skin.file.relPath}: ${message}`, { cause: err });
+        }
+        logger.warn(`EXML compile failed for ${skin.file.relPath}: ${message}`);
+        return `// Failed to compile ${skin.file.relPath}: ${message}\nexport function ${factoryName(skin.className)}() { return {}; }\n`;
+    }
+}
+/**
+ * Determines which `.exml` files to compile (honours `autoGenerateExmlsList`).
+ */
+async function resolveExmlFiles(project, theme) {
+    const declared = (theme.exmls ?? []).map(e => (typeof e === 'string' ? e : e?.path)).filter(Boolean);
+    if (theme.autoGenerateExmlsList === false && declared.length > 0) {
+        const files = [];
+        for (const rel of declared) {
+            try {
+                files.push(await readExmlAt(project.resourceDir, resolveExmlPath(project, rel)));
+            }
+            catch {
+                logger.warn(`declared EXML not found, skipping: ${rel}`);
+            }
+        }
+        return files;
+    }
+    return collectExmlFiles(project.resourceDir);
+}
+/**
+ * Recursively collects every `.exml` file under `resource/`, sorted by path.
+ */
+async function collectExmlFiles(resourceDir) {
+    const results = [];
+    async function walk(dir) {
+        let entries;
+        try {
+            entries = await fs.readdir(dir, { withFileTypes: true });
+        }
+        catch {
+            return;
+        }
+        for (const entry of entries) {
+            const full = path.join(dir, entry.name);
+            if (entry.isDirectory())
+                await walk(full);
+            else if (entry.name.endsWith('.exml'))
+                results.push(await readExmlAt(resourceDir, full));
+        }
+    }
+    await walk(resourceDir);
+    return results.sort((a, b) => a.relPath.localeCompare(b.relPath));
+}
+/**
+ * Resolves a theme-declared EXML path (project-root- or resource-relative).
+ */
+function resolveExmlPath(project, declared) {
+    const normalized = declared.replace(/^\.\//, '');
+    return normalized.startsWith('resource/')
+        ? path.resolve(project.root, normalized)
+        : path.resolve(project.resourceDir, normalized);
+}
+/**
+ * Reads a `.exml` file at an absolute path, computing its `resource/`-relative path.
+ */
+async function readExmlAt(resourceDir, absolute) {
+    return {
+        path: absolute,
+        relPath: toPosix(path.relative(resourceDir, absolute)),
+        contents: await fs.readFile(absolute, 'utf-8'),
+    };
+}
+/**
+ * Reads the existing theme file, or returns an empty theme on miss.
+ */
+async function loadTheme(project) {
+    try {
+        return JSON.parse(await fs.readFile(project.themeFile, 'utf-8'));
+    }
+    catch {
+        return { skins: {} };
+    }
+}
+/**
+ * Rewrites the `skins` map to class names: Egret path values
+ * (`resource/skins/X.exml`) are matched to their compiled skin; values that are
+ * already class names pass through.
+ */
+function remapSkins(project, skins, compiled) {
+    const byRelPath = new Map(compiled.map(s => [s.file.relPath, s.className]));
+    const result = {};
+    for (const [host, value] of Object.entries(skins)) {
+        if (/\.exml$/i.test(value) || value.includes('/')) {
+            const relPath = toPosix(path.relative(project.resourceDir, resolveExmlPath(project, value)));
+            result[host] = byRelPath.get(relPath) ?? value;
+        }
+        else {
+            result[host] = value;
+        }
+    }
+    return result;
+}
+/**
+ * Reads the `class="..."` attribute, falling back to the file name.
+ */
+function extractClassName(file) {
+    const match = file.contents.match(/class="([^"]+)"/);
+    return match ? match[1] : path.basename(file.path, '.exml');
+}
+/**
+ * `skins.ButtonSkin` → `createButtonSkin` (matches the EXML codegen).
+ */
+function factoryName(className) {
+    return `create${className.split('.').pop()}`;
+}
+/**
+ * Converts a file system path to forward-slash form (a no-op on POSIX).
+ */
+function toPosix(p) {
+    return p.split(path.sep).join('/');
+}
+//# sourceMappingURL=compile-exml.js.map

package/dist/core/plugins/compile-exml.js.map

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

package/dist/core/plugins/compile-source.d.ts

@@ -0,0 +1,14 @@
+import type { BuildPlugin } from '../pipeline.js';
+/**
+ * Compiles the project source with esbuild, matching Egret's output shape:
+ *
+ * - **development**: each `src/**\/*.ts` is emitted to a mirrored `.js` path
+ *   (`Main.js`, `com/akakata/LoadingUI.js`), preserving directory structure.
+ * - **release**: all source is bundled and minified into `js/main.min_<hash>.js`.
+ *
+ * Engine packages stay external in both modes (resolved by the HTML import map),
+ * so engine code is never duplicated into the app output. The entry script path
+ * is reported via `ctx.outputs.entryScript`.
+ */
+export declare function compileSource(): BuildPlugin;
+//# sourceMappingURL=compile-source.d.ts.map

package/dist/core/plugins/compile-source.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"compile-source.d.ts","sourceRoot":"","sources":["../../../src/core/plugins/compile-source.ts"],"names":[],"mappings":"AAMA,OAAO,KAAK,EAAgB,WAAW,EAAE,MAAM,gBAAgB,CAAC;AAGhE;;;;;;;;;;GAUG;AACH,wBAAgB,aAAa,IAAI,WAAW,CAU3C"}

package/dist/core/plugins/compile-source.js

@@ -0,0 +1,132 @@
+import * as esbuild from 'esbuild';
+import * as fs from 'node:fs/promises';
+import * as path from 'node:path';
+import { ensureDir } from '../../utils/fs.js';
+import { logger } from '../../utils/logger.js';
+import { namespaceModuleExternalPlugin, normalizeModuleKey } from '../namespace-external-plugin.js';
+/**
+ * Compiles the project source with esbuild, matching Egret's output shape:
+ *
+ * - **development**: each `src/**\/*.ts` is emitted to a mirrored `.js` path
+ *   (`Main.js`, `com/akakata/LoadingUI.js`), preserving directory structure.
+ * - **release**: all source is bundled and minified into `js/main.min_<hash>.js`.
+ *
+ * Engine packages stay external in both modes (resolved by the HTML import map),
+ * so engine code is never duplicated into the app output. The entry script path
+ * is reported via `ctx.outputs.entryScript`.
+ */
+export function compileSource() {
+    return {
+        name: 'compile source',
+        async apply(ctx) {
+            const { project } = ctx;
+            await ensureDir(project.outputDir);
+            return project.mode === 'release' ? buildRelease(ctx) : buildDevelopment(ctx);
+        },
+    };
+}
+const COMMON = {
+    bundle: true,
+    format: 'esm',
+    platform: 'browser',
+    target: 'es2022',
+    logLevel: 'warning',
+};
+/**
+ * Per-file output preserving the source tree (development).
+ */
+async function buildDevelopment(ctx) {
+    const { project } = ctx;
+    const allSources = await collectSources(project.srcDir);
+    // Files already bundled into a custom-namespace chunk (compile-custom-namespaces.ts)
+    // must not also become their own dev entry point — that would emit a second,
+    // distinct copy of the same classes instead of resolving to the shared chunk.
+    const sources = allSources.filter(file => !ctx.outputs.namespaceModules.has(normalizeModuleKey(file)));
+    const entryPoints = sources.length > 0 ? sources : [project.entry];
+    const options = {
+        ...COMMON,
+        entryPoints,
+        outdir: project.outputDir,
+        outbase: project.srcDir,
+        entryNames: '[dir]/[name]',
+        chunkNames: 'js/chunks/[name]-[hash]',
+        splitting: true,
+        sourcemap: ctx.sourcemap,
+        external: [...project.enginePackages, ...project.customNamespaces.map(ns => ns.specifier)],
+        plugins: [namespaceModuleExternalPlugin(ctx.outputs.namespaceModules)],
+        define: defines(false),
+    };
+    ctx.outputs.entryScript = toOutputPath(project, project.entry);
+    if (ctx.watch) {
+        const context = await esbuild.context(options);
+        await context.watch();
+        ctx.disposers.push(() => context.dispose());
+        return;
+    }
+    await esbuild.build(options);
+}
+/**
+ * Single minified, content-hashed bundle under `js/` (release).
+ */
+async function buildRelease(ctx) {
+    const { project } = ctx;
+    const result = await esbuild.build({
+        ...COMMON,
+        entryPoints: [project.entry],
+        outdir: path.join(project.outputDir, 'js'),
+        entryNames: 'main.min_[hash]',
+        minify: true,
+        sourcemap: ctx.sourcemap,
+        metafile: true,
+        external: [...project.enginePackages, ...project.customNamespaces.map(ns => ns.specifier)],
+        plugins: [namespaceModuleExternalPlugin(ctx.outputs.namespaceModules)],
+        define: defines(true),
+    });
+    const output = Object.keys(result.metafile.outputs).find(f => f.endsWith('.js'));
+    ctx.outputs.entryScript = output ? `js/${path.basename(output)}` : 'js/main.min.js';
+    if (ctx.analyze) {
+        logger.info('Bundle analysis:\n' + (await esbuild.analyzeMetafile(result.metafile)));
+    }
+}
+/**
+ * Build-time `define` replacements for `process.env.DEBUG`/`process.env.RELEASE`.
+ */
+function defines(isRelease) {
+    return {
+        'process.env.DEBUG': JSON.stringify(!isRelease),
+        'process.env.RELEASE': JSON.stringify(isRelease),
+    };
+}
+/**
+ * Maps an absolute source path to its output path, relative to the output dir.
+ */
+function toOutputPath(project, sourceFile) {
+    return path.relative(project.srcDir, sourceFile).replace(/\.ts$/, '.js').split(path.sep).join('/');
+}
+/**
+ * Collects every `.ts` source (excluding `.d.ts`) under the source directory.
+ */
+async function collectSources(srcDir) {
+    const results = [];
+    async function walk(dir) {
+        let entries;
+        try {
+            entries = await fs.readdir(dir, { withFileTypes: true });
+        }
+        catch {
+            return;
+        }
+        for (const entry of entries) {
+            const full = path.join(dir, entry.name);
+            if (entry.isDirectory()) {
+                await walk(full);
+            }
+            else if (entry.name.endsWith('.ts') && !entry.name.endsWith('.d.ts')) {
+                results.push(full);
+            }
+        }
+    }
+    await walk(srcDir);
+    return results.sort();
+}
+//# sourceMappingURL=compile-source.js.map

package/dist/core/plugins/compile-source.js.map

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

package/dist/core/plugins/copy-assets.d.ts

@@ -0,0 +1,12 @@
+import type { BuildPlugin } from '../pipeline.js';
+/**
+ * Copies the project's `resource/` directory into the output.
+ *
+ * - The theme file is skipped — `compile EXML` emits it with the resolved skin
+ *   payload, so copying the source version would overwrite it.
+ * - `.exml` source files are skipped when EXML is enabled, since skins are
+ *   compiled to a JS module and the runtime never reads raw `.exml` — this
+ *   keeps the output clean, matching Egret's release.
+ */
+export declare function copyAssets(): BuildPlugin;
+//# sourceMappingURL=copy-assets.d.ts.map

package/dist/core/plugins/copy-assets.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"copy-assets.d.ts","sourceRoot":"","sources":["../../../src/core/plugins/copy-assets.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAgB,WAAW,EAAE,MAAM,gBAAgB,CAAC;AAEhE;;;;;;;;GAQG;AACH,wBAAgB,UAAU,IAAI,WAAW,CAmBxC"}

package/dist/core/plugins/copy-assets.js

@@ -0,0 +1,33 @@
+import * as path from 'node:path';
+import { copyDir, exists } from '../../utils/fs.js';
+/**
+ * Copies the project's `resource/` directory into the output.
+ *
+ * - The theme file is skipped — `compile EXML` emits it with the resolved skin
+ *   payload, so copying the source version would overwrite it.
+ * - `.exml` source files are skipped when EXML is enabled, since skins are
+ *   compiled to a JS module and the runtime never reads raw `.exml` — this
+ *   keeps the output clean, matching Egret's release.
+ */
+export function copyAssets() {
+    return {
+        name: 'copy assets',
+        async apply(ctx) {
+            const { project } = ctx;
+            if (!(await exists(project.resourceDir)))
+                return;
+            const exml = project.config.exml;
+            const themeName = exml ? path.basename(exml.themeFile) : undefined;
+            const dest = path.join(project.outputDir, 'resource');
+            await copyDir(project.resourceDir, dest, name => {
+                if (name === themeName)
+                    return false;
+                // Skins are compiled to a JS module — never ship raw .exml sources.
+                if (exml && name.endsWith('.exml'))
+                    return false;
+                return true;
+            });
+        },
+    };
+}
+//# sourceMappingURL=copy-assets.js.map

package/dist/core/plugins/copy-assets.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"copy-assets.js","sourceRoot":"","sources":["../../../src/core/plugins/copy-assets.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,IAAI,MAAM,WAAW,CAAC;AAClC,OAAO,EAAE,OAAO,EAAE,MAAM,EAAE,MAAM,mBAAmB,CAAC;AAGpD;;;;;;;;GAQG;AACH,MAAM,UAAU,UAAU;IACzB,OAAO;QACN,IAAI,EAAE,aAAa;QACnB,KAAK,CAAC,KAAK,CAAC,GAAiB;YAC5B,MAAM,EAAE,OAAO,EAAE,GAAG,GAAG,CAAC;YACxB,IAAI,CAAC,CAAC,MAAM,MAAM,CAAC,OAAO,CAAC,WAAW,CAAC,CAAC;gBAAE,OAAO;YAEjD,MAAM,IAAI,GAAG,OAAO,CAAC,MAAM,CAAC,IAAI,CAAC;YACjC,MAAM,SAAS,GAAG,IAAI,CAAC,CAAC,CAAC,IAAI,CAAC,QAAQ,CAAC,IAAI,CAAC,SAAS,CAAC,CAAC,CAAC,CAAC,SAAS,CAAC;YAEnE,MAAM,IAAI,GAAG,IAAI,CAAC,IAAI,CAAC,OAAO,CAAC,SAAS,EAAE,UAAU,CAAC,CAAC;YACtD,MAAM,OAAO,CAAC,OAAO,CAAC,WAAW,EAAE,IAAI,EAAE,IAAI,CAAC,EAAE;gBAC/C,IAAI,IAAI,KAAK,SAAS;oBAAE,OAAO,KAAK,CAAC;gBACrC,oEAAoE;gBACpE,IAAI,IAAI,IAAI,IAAI,CAAC,QAAQ,CAAC,OAAO,CAAC;oBAAE,OAAO,KAAK,CAAC;gBACjD,OAAO,IAAI,CAAC;YACb,CAAC,CAAC,CAAC;QACJ,CAAC;KACD,CAAC;AACH,CAAC"}

package/dist/core/plugins/generate-html.d.ts

@@ -0,0 +1,16 @@
+import type { BuildPlugin } from '../pipeline.js';
+import type { Project } from '../project.js';
+/**
+ * Writes `index.html`.
+ *
+ * Engine packages are wired up through an ES module import map
+ * (`@kurot/core` → `./js/kurot.core.js`), so the bundled app and engine
+ * chunks resolve bare specifiers in the browser. The entry script bootstraps
+ * the engine via the user's own `createPlayer()` call.
+ */
+export declare function generateHtml(): BuildPlugin;
+/**
+ * Replaces every required Kurot placeholder in the page template.
+ */
+export declare function renderHtml(template: string, project: Project, entryScript: string, engine: Record<string, string>): string;
+//# sourceMappingURL=generate-html.d.ts.map

package/dist/core/plugins/generate-html.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"generate-html.d.ts","sourceRoot":"","sources":["../../../src/core/plugins/generate-html.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAgB,WAAW,EAAE,MAAM,gBAAgB,CAAC;AAChE,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,eAAe,CAAC;AAqD7C;;;;;;;GAOG;AACH,wBAAgB,YAAY,IAAI,WAAW,CAW1C;AAiCD;;GAEG;AACH,wBAAgB,UAAU,CACzB,QAAQ,EAAE,MAAM,EAChB,OAAO,EAAE,OAAO,EAChB,WAAW,EAAE,MAAM,EACnB,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,GAC5B,MAAM,CAuBR"}

package/dist/core/plugins/generate-html.js

@@ -0,0 +1,137 @@
+import * as path from 'node:path';
+import * as fs from 'node:fs/promises';
+import { writeFile } from '../../utils/fs.js';
+import { BuildError } from '../errors.js';
+const PLACEHOLDERS = {
+    importMap: '{{KUROT_IMPORT_MAP}}',
+    stageWidth: '{{KUROT_STAGE_WIDTH}}',
+    stageHeight: '{{KUROT_STAGE_HEIGHT}}',
+    scaleMode: '{{KUROT_SCALE_MODE}}',
+    orientation: '{{KUROT_ORIENTATION}}',
+    frameRate: '{{KUROT_FRAME_RATE}}',
+    entryScript: '{{KUROT_ENTRY_SCRIPT}}',
+};
+const DEFAULT_TEMPLATE = `<!DOCTYPE html>
+<html>
+<head>
+	<meta charset="utf-8">
+	<meta name="viewport" content="width=device-width,initial-scale=1,user-scalable=no">
+	<title>Kurot Game</title>
+	<style>
+		html, body {
+			margin: 0;
+			padding: 0;
+			width: 100%;
+			height: 100%;
+			background: #000000;
+			overflow: hidden;
+		}
+
+		body {
+			display: flex;
+			align-items: center;
+			justify-content: center;
+		}
+
+		canvas {
+			display: block;
+		}
+	</style>
+	{{KUROT_IMPORT_MAP}}
+</head>
+<body>
+	<canvas id="gameCanvas"
+		data-content-width="{{KUROT_STAGE_WIDTH}}"
+		data-content-height="{{KUROT_STAGE_HEIGHT}}"
+		data-scale-mode="{{KUROT_SCALE_MODE}}"
+		data-orientation="{{KUROT_ORIENTATION}}"
+		data-frame-rate="{{KUROT_FRAME_RATE}}"></canvas>
+	<script type="module" src="{{KUROT_ENTRY_SCRIPT}}"></script>
+</body>
+</html>
+`;
+/**
+ * Writes `index.html`.
+ *
+ * Engine packages are wired up through an ES module import map
+ * (`@kurot/core` → `./js/kurot.core.js`), so the bundled app and engine
+ * chunks resolve bare specifiers in the browser. The entry script bootstraps
+ * the engine via the user's own `createPlayer()` call.
+ */
+export function generateHtml() {
+    return {
+        name: 'generate index.html',
+        async apply(ctx) {
+            const entryScript = ctx.outputs.entryScript ?? 'main.js';
+            const template = await loadTemplate(ctx.project);
+            const html = renderHtml(template, ctx.project, entryScript, ctx.outputs.engine);
+            await writeFile(path.join(ctx.project.outputDir, 'index.html'), html);
+            await copyTemplateAssets(ctx.project);
+        },
+    };
+}
+/**
+ * Copies files placed beside the project HTML template into the web output.
+ *
+ * This keeps page-shell assets such as a startup logo separate from game
+ * resources. The template itself is skipped because the rendered HTML has
+ * already been written to the output directory.
+ */
+async function copyTemplateAssets(project) {
+    if (!project.htmlTemplate)
+        return;
+    const templateDirectory = path.dirname(project.htmlTemplate);
+    const templateFileName = path.basename(project.htmlTemplate);
+    const entries = await fs.readdir(templateDirectory, { withFileTypes: true });
+    for (const entry of entries) {
+        if (entry.name === templateFileName)
+            continue;
+        const source = path.join(templateDirectory, entry.name);
+        const destination = path.join(project.outputDir, entry.name);
+        await fs.cp(source, destination, { recursive: true });
+    }
+}
+/**
+ * Loads the project-owned template or falls back to the built-in page.
+ */
+async function loadTemplate(project) {
+    if (!project.htmlTemplate)
+        return DEFAULT_TEMPLATE;
+    return fs.readFile(project.htmlTemplate, 'utf-8');
+}
+/**
+ * Replaces every required Kurot placeholder in the page template.
+ */
+export function renderHtml(template, project, entryScript, engine) {
+    const missing = Object.values(PLACEHOLDERS).filter(placeholder => !template.includes(placeholder));
+    if (missing.length > 0) {
+        const source = project.htmlTemplate ?? 'the built-in HTML template';
+        throw new BuildError(`HTML template '${source}' is missing required placeholders: ${missing.join(', ')}`);
+    }
+    const { stage } = project.config;
+    const replacements = new Map([
+        [PLACEHOLDERS.importMap, Object.keys(engine).length > 0 ? renderImportMap(engine) : ''],
+        [PLACEHOLDERS.stageWidth, String(stage.width)],
+        [PLACEHOLDERS.stageHeight, String(stage.height)],
+        [PLACEHOLDERS.scaleMode, stage.scaleMode],
+        [PLACEHOLDERS.orientation, stage.orientation],
+        [PLACEHOLDERS.frameRate, String(stage.frameRate)],
+        [PLACEHOLDERS.entryScript, entryScript],
+    ]);
+    let html = template;
+    for (const [placeholder, value] of replacements) {
+        html = html.replaceAll(placeholder, value);
+    }
+    return html;
+}
+/**
+ * Renders the `<script type="importmap">` tag mapping engine package
+ * specifiers to their bundled chunk paths.
+ */
+function renderImportMap(engine) {
+    const imports = Object.entries(engine)
+        .map(([pkg, file]) => `\t\t\t"${pkg}": "./${file}"`)
+        .join(',\n');
+    return `<script type="importmap">\n\t{\n\t\t"imports": {\n${imports}\n\t\t}\n\t}\n\t</script>\n`;
+}
+//# sourceMappingURL=generate-html.js.map

package/dist/core/plugins/generate-html.js.map

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

package/dist/core/plugins/index.d.ts

@@ -0,0 +1,21 @@
+import type { BuildPlugin } from '../pipeline.js';
+export { cleanOutput } from './clean-output.js';
+export { compileExml } from './compile-exml.js';
+export { compileEngine } from './compile-engine.js';
+export { compileCustomNamespaces } from './compile-custom-namespaces.js';
+export { compileSource } from './compile-source.js';
+export { generateHtml } from './generate-html.js';
+export { writeManifest } from './manifest.js';
+export { copyAssets } from './copy-assets.js';
+/**
+ * The standard build sequence.
+ *
+ * Order matters: `compileCustomNamespaces` must run before `compileSource`,
+ * since the latter reads `ctx.outputs.namespaceModules` to mark namespace
+ * files external and exclude them from per-file dev output (see
+ * `compile-source.ts`). Engine and source compilation report their output
+ * paths, then the HTML and manifest referencing them are written, and
+ * finally static assets are copied.
+ */
+export declare function defaultPlugins(): BuildPlugin[];
+//# sourceMappingURL=index.d.ts.map

package/dist/core/plugins/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/core/plugins/index.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,gBAAgB,CAAC;AAUlD,OAAO,EAAE,WAAW,EAAE,MAAM,mBAAmB,CAAC;AAChD,OAAO,EAAE,WAAW,EAAE,MAAM,mBAAmB,CAAC;AAChD,OAAO,EAAE,aAAa,EAAE,MAAM,qBAAqB,CAAC;AACpD,OAAO,EAAE,uBAAuB,EAAE,MAAM,gCAAgC,CAAC;AACzE,OAAO,EAAE,aAAa,EAAE,MAAM,qBAAqB,CAAC;AACpD,OAAO,EAAE,YAAY,EAAE,MAAM,oBAAoB,CAAC;AAClD,OAAO,EAAE,aAAa,EAAE,MAAM,eAAe,CAAC;AAC9C,OAAO,EAAE,UAAU,EAAE,MAAM,kBAAkB,CAAC;AAE9C;;;;;;;;;GASG;AACH,wBAAgB,cAAc,IAAI,WAAW,EAAE,CAW9C"}