@kurot/cli 1.0.2

package/dist/core/plugins/index.js

@@ -0,0 +1,39 @@
+import { cleanOutput } from './clean-output.js';
+import { compileExml } from './compile-exml.js';
+import { compileEngine } from './compile-engine.js';
+import { compileCustomNamespaces } from './compile-custom-namespaces.js';
+import { compileSource } from './compile-source.js';
+import { generateHtml } from './generate-html.js';
+import { writeManifest } from './manifest.js';
+import { copyAssets } from './copy-assets.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 function defaultPlugins() {
+    return [
+        cleanOutput(),
+        compileExml(),
+        compileEngine(),
+        compileCustomNamespaces(),
+        compileSource(),
+        generateHtml(),
+        writeManifest(),
+        copyAssets(),
+    ];
+}
+//# sourceMappingURL=index.js.map

package/dist/core/plugins/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/core/plugins/index.ts"],"names":[],"mappings":"AACA,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,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,MAAM,UAAU,cAAc;IAC7B,OAAO;QACN,WAAW,EAAE;QACb,WAAW,EAAE;QACb,aAAa,EAAE;QACf,uBAAuB,EAAE;QACzB,aAAa,EAAE;QACf,YAAY,EAAE;QACd,aAAa,EAAE;QACf,UAAU,EAAE;KACZ,CAAC;AACH,CAAC"}

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

@@ -0,0 +1,14 @@
+import type { BuildPlugin } from '../pipeline.js';
+/**
+ * Writes Egret-style `manifest.json` for release builds:
+ *
+ * ```json
+ * { "initial": ["js/kurot.core.min_<hash>.js", ...], "game": ["js/main.min_<hash>.js"] }
+ * ```
+ *
+ * `initial` lists the engine chunks (loaded first), `game` the app entry. Skins
+ * are embedded in `default.thm.json` and loaded at runtime, so they are not
+ * listed here. No-op outside release mode.
+ */
+export declare function writeManifest(): BuildPlugin;
+//# sourceMappingURL=manifest.d.ts.map

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

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

package/dist/core/plugins/manifest.js

@@ -0,0 +1,28 @@
+import * as path from 'node:path';
+import { writeFile } from '../../utils/fs.js';
+/**
+ * Writes Egret-style `manifest.json` for release builds:
+ *
+ * ```json
+ * { "initial": ["js/kurot.core.min_<hash>.js", ...], "game": ["js/main.min_<hash>.js"] }
+ * ```
+ *
+ * `initial` lists the engine chunks (loaded first), `game` the app entry. Skins
+ * are embedded in `default.thm.json` and loaded at runtime, so they are not
+ * listed here. No-op outside release mode.
+ */
+export function writeManifest() {
+    return {
+        name: 'write manifest.json',
+        async apply(ctx) {
+            if (ctx.project.mode !== 'release')
+                return;
+            const manifest = {
+                initial: Object.values(ctx.outputs.engine),
+                game: [ctx.outputs.skinsScript, ctx.outputs.entryScript].filter(Boolean),
+            };
+            await writeFile(path.join(ctx.project.outputDir, 'manifest.json'), JSON.stringify(manifest, null, '\t') + '\n');
+        },
+    };
+}
+//# sourceMappingURL=manifest.js.map

package/dist/core/plugins/manifest.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"manifest.js","sourceRoot":"","sources":["../../../src/core/plugins/manifest.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,IAAI,MAAM,WAAW,CAAC;AAClC,OAAO,EAAE,SAAS,EAAE,MAAM,mBAAmB,CAAC;AAG9C;;;;;;;;;;GAUG;AACH,MAAM,UAAU,aAAa;IAC5B,OAAO;QACN,IAAI,EAAE,qBAAqB;QAC3B,KAAK,CAAC,KAAK,CAAC,GAAiB;YAC5B,IAAI,GAAG,CAAC,OAAO,CAAC,IAAI,KAAK,SAAS;gBAAE,OAAO;YAE3C,MAAM,QAAQ,GAAG;gBAChB,OAAO,EAAE,MAAM,CAAC,MAAM,CAAC,GAAG,CAAC,OAAO,CAAC,MAAM,CAAC;gBAC1C,IAAI,EAAE,CAAC,GAAG,CAAC,OAAO,CAAC,WAAW,EAAE,GAAG,CAAC,OAAO,CAAC,WAAW,CAAC,CAAC,MAAM,CAAC,OAAO,CAAC;aACxE,CAAC;YACF,MAAM,SAAS,CACd,IAAI,CAAC,IAAI,CAAC,GAAG,CAAC,OAAO,CAAC,SAAS,EAAE,eAAe,CAAC,EACjD,IAAI,CAAC,SAAS,CAAC,QAAQ,EAAE,IAAI,EAAE,IAAI,CAAC,GAAG,IAAI,CAC3C,CAAC;QACH,CAAC;KACD,CAAC;AACH,CAAC"}

package/dist/core/project.d.ts

@@ -0,0 +1,95 @@
+import { type ProjectConfig } from './config.js';
+export type BuildMode = 'development' | 'release';
+/**
+ * A project-defined EXML namespace (Egret's `xmlns:game="game.*"` convention).
+ *
+ * `specifier` is the virtual module specifier used in generated `import`
+ * statements (e.g. `#ns/game`); it is resolved via an HTML import map to the
+ * bundled chunk produced from `entry`, so the app bundle and the skins bundle
+ * both import the same module instance.
+ */
+export interface CustomNamespace {
+    /**
+     * The XML namespace prefix (e.g. `game` for `xmlns:game="game.*"`).
+     */
+    readonly prefix: string;
+    /**
+     * Virtual module specifier used in generated `import` statements.
+     */
+    readonly specifier: string;
+    /**
+     * Absolute path to the barrel file exporting every class in this namespace.
+     */
+    readonly entry: string;
+}
+/**
+ * Resolved view of a Kurot project.
+ *
+ * Loads `kurot.config.ts`, then resolves every project path to an absolute
+ * location so plugins never have to touch `process.cwd()` or `path.resolve`
+ * themselves. This is the single source of truth for the build pipeline.
+ */
+export interface Project {
+    /**
+     * Project root (current working directory).
+     */
+    readonly root: string;
+    /**
+     * Build mode this project view was resolved for.
+     */
+    readonly mode: BuildMode;
+    /**
+     * Validated user configuration.
+     */
+    readonly config: ProjectConfig;
+    /**
+     * Absolute path to the entry source file.
+     */
+    readonly entry: string;
+    /**
+     * Absolute path to the source root directory (`src/`).
+     */
+    readonly srcDir: string;
+    /**
+     * Absolute output directory.
+     * - development: `bin-debug`
+     * - release: `bin-release/web/<timestamp>` (Egret-style versioned folder)
+     */
+    readonly outputDir: string;
+    /**
+     * Absolute path to the `resource/` directory.
+     */
+    readonly resourceDir: string;
+    /**
+     * Absolute path to the project-owned HTML template, when configured.
+     */
+    readonly htmlTemplate?: string;
+    /**
+     * Absolute path to the theme file, when EXML is enabled.
+     */
+    readonly themeFile?: string;
+    /**
+     * `@kurot/*` engine packages this project depends on (excluding the CLI).
+     * Each is bundled into its own chunk and wired up via an HTML import map.
+     */
+    readonly enginePackages: string[];
+    /**
+     * Project-defined EXML namespaces, resolved from `config.exml.namespaces`.
+     */
+    readonly customNamespaces: CustomNamespace[];
+}
+/**
+ * Base output folder names, used by both build and clean.
+ */
+export declare const OUTPUT_DIRS: {
+    readonly development: "bin-debug";
+    readonly release: "bin-release";
+};
+/**
+ * Loads and resolves the project rooted at the current working directory.
+ *
+ * @param mode - The build mode to resolve the project for
+ * @returns The resolved project view
+ */
+export declare function loadProject(mode: BuildMode): Promise<Project>;
+//# sourceMappingURL=project.d.ts.map

package/dist/core/project.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"project.d.ts","sourceRoot":"","sources":["../../src/core/project.ts"],"names":[],"mappings":"AAEA,OAAO,EAAc,KAAK,aAAa,EAAE,MAAM,aAAa,CAAC;AAE7D,MAAM,MAAM,SAAS,GAAG,aAAa,GAAG,SAAS,CAAC;AAElD;;;;;;;GAOG;AACH,MAAM,WAAW,eAAe;IAC/B;;OAEG;IACH,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;IACxB;;OAEG;IACH,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAC;IAC3B;;OAEG;IACH,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;CACvB;AAED;;;;;;GAMG;AACH,MAAM,WAAW,OAAO;IACvB;;OAEG;IACH,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB;;OAEG;IACH,QAAQ,CAAC,IAAI,EAAE,SAAS,CAAC;IACzB;;OAEG;IACH,QAAQ,CAAC,MAAM,EAAE,aAAa,CAAC;IAC/B;;OAEG;IACH,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;IACvB;;OAEG;IACH,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;IACxB;;;;OAIG;IACH,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAC;IAC3B;;OAEG;IACH,QAAQ,CAAC,WAAW,EAAE,MAAM,CAAC;IAC7B;;OAEG;IACH,QAAQ,CAAC,YAAY,CAAC,EAAE,MAAM,CAAC;IAC/B;;OAEG;IACH,QAAQ,CAAC,SAAS,CAAC,EAAE,MAAM,CAAC;IAC5B;;;OAGG;IACH,QAAQ,CAAC,cAAc,EAAE,MAAM,EAAE,CAAC;IAClC;;OAEG;IACH,QAAQ,CAAC,gBAAgB,EAAE,eAAe,EAAE,CAAC;CAC7C;AAED;;GAEG;AACH,eAAO,MAAM,WAAW;;;CAAgE,CAAC;AAEzF;;;;;GAKG;AACH,wBAAsB,WAAW,CAAC,IAAI,EAAE,SAAS,GAAG,OAAO,CAAC,OAAO,CAAC,CAqBnE"}

package/dist/core/project.js

@@ -0,0 +1,79 @@
+import * as path from 'node:path';
+import * as fs from 'node:fs';
+import { loadConfig } from './config.js';
+/**
+ * Base output folder names, used by both build and clean.
+ */
+export const OUTPUT_DIRS = { development: 'bin-debug', release: 'bin-release' };
+/**
+ * Loads and resolves the project rooted at the current working directory.
+ *
+ * @param mode - The build mode to resolve the project for
+ * @returns The resolved project view
+ */
+export async function loadProject(mode) {
+    const root = process.cwd();
+    const config = await loadConfig();
+    const outputDir = mode === 'release'
+        ? path.resolve(root, OUTPUT_DIRS.release, 'web', timestamp())
+        : path.resolve(root, config.output.dir);
+    return {
+        root,
+        mode,
+        config,
+        entry: path.resolve(root, config.entry),
+        srcDir: path.resolve(root, 'src'),
+        outputDir,
+        resourceDir: path.resolve(root, 'resource'),
+        htmlTemplate: config.html ? path.resolve(root, config.html.template) : undefined,
+        themeFile: config.exml ? path.resolve(root, config.exml.themeFile) : undefined,
+        enginePackages: detectEnginePackages(root),
+        customNamespaces: resolveCustomNamespaces(root, config.exml?.namespaces),
+    };
+}
+/**
+ * The specifier prefix used for project-defined EXML namespaces (kept out of
+ * npm's `@scope` space).
+ */
+const NAMESPACE_SPECIFIER_PREFIX = '#ns/';
+/**
+ * Resolves `config.exml.namespaces` into `CustomNamespace` entries with
+ * absolute barrel paths.
+ */
+function resolveCustomNamespaces(root, namespaces) {
+    if (!namespaces)
+        return [];
+    return Object.entries(namespaces).map(([prefix, entry]) => ({
+        prefix,
+        specifier: `${NAMESPACE_SPECIFIER_PREFIX}${prefix}`,
+        entry: path.resolve(root, entry),
+    }));
+}
+/**
+ * Reads `@kurot/*` runtime dependencies (excluding the CLI) from package.json.
+ */
+function detectEnginePackages(root) {
+    try {
+        const pkg = JSON.parse(fs.readFileSync(path.join(root, 'package.json'), 'utf-8'));
+        return Object.keys(pkg.dependencies ?? {})
+            .filter(name => name.startsWith('@kurot/') && name !== '@kurot/cli')
+            .sort();
+    }
+    catch {
+        return [];
+    }
+}
+/**
+ * Egret-style `YYMMDDHHmmss` version stamp.
+ */
+function timestamp() {
+    const d = new Date();
+    const p = (n) => String(n).padStart(2, '0');
+    return (String(d.getFullYear() % 100) +
+        p(d.getMonth() + 1) +
+        p(d.getDate()) +
+        p(d.getHours()) +
+        p(d.getMinutes()) +
+        p(d.getSeconds()));
+}
+//# sourceMappingURL=project.js.map

package/dist/core/project.js.map

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

package/dist/core/template.d.ts

@@ -0,0 +1,13 @@
+export declare const TEMPLATES: readonly ["game", "empty"];
+export type TemplateName = (typeof TEMPLATES)[number];
+/**
+ * Scaffolds a new project by copying `templates/<template>/` into `./<name>/`,
+ * then writing a fresh `package.json`:
+ *
+ * - `name` is set to the project name.
+ * - `@kurot/cli` is pinned to the version of the CLI doing the scaffolding,
+ *   so a project always uses the CLI that created it (never a stale template pin).
+ * - `@kurot/*` engine packages are set to `latest`.
+ */
+export declare function scaffoldProject(name: string, template: TemplateName): Promise<void>;
+//# sourceMappingURL=template.d.ts.map

package/dist/core/template.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"template.d.ts","sourceRoot":"","sources":["../../src/core/template.ts"],"names":[],"mappings":"AASA,eAAO,MAAM,SAAS,4BAA6B,CAAC;AACpD,MAAM,MAAM,YAAY,GAAG,CAAC,OAAO,SAAS,CAAC,CAAC,MAAM,CAAC,CAAC;AAEtD;;;;;;;;GAQG;AACH,wBAAsB,eAAe,CAAC,IAAI,EAAE,MAAM,EAAE,QAAQ,EAAE,YAAY,GAAG,OAAO,CAAC,IAAI,CAAC,CAsBzF"}

package/dist/core/template.js

@@ -0,0 +1,79 @@
+import * as path from 'node:path';
+import * as fs from 'node:fs/promises';
+import { fileURLToPath } from 'node:url';
+import { copyDir, writeFile, exists } from '../utils/fs.js';
+const __dirname = path.dirname(fileURLToPath(import.meta.url));
+const TEMPLATES_DIR = path.resolve(__dirname, '../../templates');
+const CLI_PKG = path.resolve(__dirname, '../../package.json');
+export const TEMPLATES = ['game', 'empty'];
+/**
+ * Scaffolds a new project by copying `templates/<template>/` into `./<name>/`,
+ * then writing a fresh `package.json`:
+ *
+ * - `name` is set to the project name.
+ * - `@kurot/cli` is pinned to the version of the CLI doing the scaffolding,
+ *   so a project always uses the CLI that created it (never a stale template pin).
+ * - `@kurot/*` engine packages are set to `latest`.
+ */
+export async function scaffoldProject(name, template) {
+    const templateDir = path.join(TEMPLATES_DIR, template);
+    const destDir = path.resolve(name);
+    if (!(await exists(templateDir))) {
+        throw new Error(`Template "${template}" not found at ${templateDir}`);
+    }
+    if (await exists(destDir)) {
+        throw new Error(`Directory "${name}" already exists`);
+    }
+    await copyDir(templateDir, destDir);
+    const pkgPath = path.join(destDir, 'package.json');
+    if (await exists(pkgPath)) {
+        const pkg = JSON.parse(await fs.readFile(pkgPath, 'utf-8'));
+        pkg.name = path.basename(destDir);
+        const cliVersion = await readCliVersion();
+        await pinKurotDeps(pkg.dependencies, cliVersion);
+        await pinKurotDeps(pkg.devDependencies, cliVersion);
+        await writeFile(pkgPath, JSON.stringify(pkg, null, '\t') + '\n');
+    }
+}
+/**
+ * Rewrites `@kurot/*` ranges: the CLI to its own version, and each engine
+ * package to the concrete latest version (`^x.y.z`) resolved from the registry.
+ */
+async function pinKurotDeps(deps, cliVersion) {
+    if (!deps)
+        return;
+    await Promise.all(Object.keys(deps).map(async (dep) => {
+        if (dep === '@kurot/cli')
+            deps[dep] = `^${cliVersion}`;
+        else if (dep.startsWith('@kurot/'))
+            deps[dep] = await resolveLatest(dep);
+    }));
+}
+/**
+ * Resolves a package's latest published version to a caret range (`^x.y.z`).
+ * Falls back to the `latest` dist-tag when the registry is unreachable or the
+ * package is unpublished, deferring resolution to install time.
+ */
+async function resolveLatest(pkg) {
+    try {
+        const url = `https://registry.npmjs.org/${pkg.replace('/', '%2F')}/latest`;
+        const res = await fetch(url, { signal: AbortSignal.timeout(3000) });
+        if (res.ok) {
+            const data = (await res.json());
+            if (data.version)
+                return `^${data.version}`;
+        }
+    }
+    catch {
+        // Offline / unpublished — fall back below.
+    }
+    return 'latest';
+}
+/**
+ * Reads this CLI's own version from its package.json.
+ */
+async function readCliVersion() {
+    const pkg = JSON.parse(await fs.readFile(CLI_PKG, 'utf-8'));
+    return pkg.version;
+}
+//# sourceMappingURL=template.js.map

package/dist/core/template.js.map

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

package/dist/define.d.ts

@@ -0,0 +1,2 @@
+export type { ProjectConfig, BuildTarget, StageConfig, ExmlConfig, OutputConfig } from './core/config.js';
+//# sourceMappingURL=define.d.ts.map

package/dist/define.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"define.d.ts","sourceRoot":"","sources":["../src/define.ts"],"names":[],"mappings":"AAAA,YAAY,EAAE,aAAa,EAAE,WAAW,EAAE,WAAW,EAAE,UAAU,EAAE,YAAY,EAAE,MAAM,kBAAkB,CAAC"}

package/dist/define.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=define.js.map

package/dist/define.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"define.js","sourceRoot":"","sources":["../src/define.ts"],"names":[],"mappings":""}

package/dist/index.d.ts

@@ -0,0 +1,3 @@
+#!/usr/bin/env node
+export {};
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":""}

package/dist/index.js

@@ -0,0 +1,19 @@
+#!/usr/bin/env node
+import { readFileSync } from 'node:fs';
+import { fileURLToPath } from 'node:url';
+import { dirname, join } from 'node:path';
+import { Command } from 'commander';
+import { buildCommand } from './commands/build.js';
+import { createCommand } from './commands/create.js';
+import { cleanCommand } from './commands/clean.js';
+import { devCommand } from './commands/dev.js';
+const __dirname = dirname(fileURLToPath(import.meta.url));
+const pkg = JSON.parse(readFileSync(join(__dirname, '../package.json'), 'utf-8'));
+const program = new Command();
+program.name('kurot').description('Kurot - Egret Next CLI').version(pkg.version);
+program.addCommand(buildCommand);
+program.addCommand(devCommand);
+program.addCommand(createCommand);
+program.addCommand(cleanCommand);
+program.parse();
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":";AAEA,OAAO,EAAE,YAAY,EAAE,MAAM,SAAS,CAAC;AACvC,OAAO,EAAE,aAAa,EAAE,MAAM,UAAU,CAAC;AACzC,OAAO,EAAE,OAAO,EAAE,IAAI,EAAE,MAAM,WAAW,CAAC;AAC1C,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AAEpC,OAAO,EAAE,YAAY,EAAE,MAAM,qBAAqB,CAAC;AACnD,OAAO,EAAE,aAAa,EAAE,MAAM,sBAAsB,CAAC;AACrD,OAAO,EAAE,YAAY,EAAE,MAAM,qBAAqB,CAAC;AACnD,OAAO,EAAE,UAAU,EAAE,MAAM,mBAAmB,CAAC;AAE/C,MAAM,SAAS,GAAG,OAAO,CAAC,aAAa,CAAC,MAAM,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC,CAAC;AAC1D,MAAM,GAAG,GAAG,IAAI,CAAC,KAAK,CAAC,YAAY,CAAC,IAAI,CAAC,SAAS,EAAE,iBAAiB,CAAC,EAAE,OAAO,CAAC,CAAC,CAAC;AAElF,MAAM,OAAO,GAAG,IAAI,OAAO,EAAE,CAAC;AAE9B,OAAO,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC,WAAW,CAAC,wBAAwB,CAAC,CAAC,OAAO,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC;AAEjF,OAAO,CAAC,UAAU,CAAC,YAAY,CAAC,CAAC;AACjC,OAAO,CAAC,UAAU,CAAC,UAAU,CAAC,CAAC;AAC/B,OAAO,CAAC,UAAU,CAAC,aAAa,CAAC,CAAC;AAClC,OAAO,CAAC,UAAU,CAAC,YAAY,CAAC,CAAC;AAEjC,OAAO,CAAC,KAAK,EAAE,CAAC"}

package/dist/utils/fs.d.ts

@@ -0,0 +1,5 @@
+export declare function ensureDir(dir: string): Promise<void>;
+export declare function copyDir(src: string, dest: string, filter?: (name: string) => boolean): Promise<void>;
+export declare function writeFile(filePath: string, content: string): Promise<void>;
+export declare function exists(filePath: string): Promise<boolean>;
+//# sourceMappingURL=fs.d.ts.map

package/dist/utils/fs.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"fs.d.ts","sourceRoot":"","sources":["../../src/utils/fs.ts"],"names":[],"mappings":"AAGA,wBAAsB,SAAS,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAE1D;AAED,wBAAsB,OAAO,CAAC,GAAG,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,EAAE,MAAM,CAAC,EAAE,CAAC,IAAI,EAAE,MAAM,KAAK,OAAO,GAAG,OAAO,CAAC,IAAI,CAAC,CAY1G;AAED,wBAAsB,SAAS,CAAC,QAAQ,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAGhF;AAED,wBAAsB,MAAM,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC,CAK/D"}

package/dist/utils/fs.js

@@ -0,0 +1,30 @@
+import * as fs from 'node:fs/promises';
+import * as path from 'node:path';
+export async function ensureDir(dir) {
+    await fs.mkdir(dir, { recursive: true });
+}
+export async function copyDir(src, dest, filter) {
+    await ensureDir(dest);
+    const entries = await fs.readdir(src, { withFileTypes: true });
+    for (const entry of entries) {
+        const srcPath = path.join(src, entry.name);
+        const destPath = path.join(dest, entry.name);
+        if (entry.isDirectory()) {
+            await copyDir(srcPath, destPath, filter);
+        }
+        else if (!filter || filter(entry.name)) {
+            await fs.copyFile(srcPath, destPath);
+        }
+    }
+}
+export async function writeFile(filePath, content) {
+    await ensureDir(path.dirname(filePath));
+    await fs.writeFile(filePath, content, 'utf-8');
+}
+export async function exists(filePath) {
+    return fs
+        .access(filePath)
+        .then(() => true)
+        .catch(() => false);
+}
+//# sourceMappingURL=fs.js.map

package/dist/utils/fs.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"fs.js","sourceRoot":"","sources":["../../src/utils/fs.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,MAAM,kBAAkB,CAAC;AACvC,OAAO,KAAK,IAAI,MAAM,WAAW,CAAC;AAElC,MAAM,CAAC,KAAK,UAAU,SAAS,CAAC,GAAW;IAC1C,MAAM,EAAE,CAAC,KAAK,CAAC,GAAG,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC,CAAC;AAC1C,CAAC;AAED,MAAM,CAAC,KAAK,UAAU,OAAO,CAAC,GAAW,EAAE,IAAY,EAAE,MAAkC;IAC1F,MAAM,SAAS,CAAC,IAAI,CAAC,CAAC;IACtB,MAAM,OAAO,GAAG,MAAM,EAAE,CAAC,OAAO,CAAC,GAAG,EAAE,EAAE,aAAa,EAAE,IAAI,EAAE,CAAC,CAAC;IAC/D,KAAK,MAAM,KAAK,IAAI,OAAO,EAAE,CAAC;QAC7B,MAAM,OAAO,GAAG,IAAI,CAAC,IAAI,CAAC,GAAG,EAAE,KAAK,CAAC,IAAI,CAAC,CAAC;QAC3C,MAAM,QAAQ,GAAG,IAAI,CAAC,IAAI,CAAC,IAAI,EAAE,KAAK,CAAC,IAAI,CAAC,CAAC;QAC7C,IAAI,KAAK,CAAC,WAAW,EAAE,EAAE,CAAC;YACzB,MAAM,OAAO,CAAC,OAAO,EAAE,QAAQ,EAAE,MAAM,CAAC,CAAC;QAC1C,CAAC;aAAM,IAAI,CAAC,MAAM,IAAI,MAAM,CAAC,KAAK,CAAC,IAAI,CAAC,EAAE,CAAC;YAC1C,MAAM,EAAE,CAAC,QAAQ,CAAC,OAAO,EAAE,QAAQ,CAAC,CAAC;QACtC,CAAC;IACF,CAAC;AACF,CAAC;AAED,MAAM,CAAC,KAAK,UAAU,SAAS,CAAC,QAAgB,EAAE,OAAe;IAChE,MAAM,SAAS,CAAC,IAAI,CAAC,OAAO,CAAC,QAAQ,CAAC,CAAC,CAAC;IACxC,MAAM,EAAE,CAAC,SAAS,CAAC,QAAQ,EAAE,OAAO,EAAE,OAAO,CAAC,CAAC;AAChD,CAAC;AAED,MAAM,CAAC,KAAK,UAAU,MAAM,CAAC,QAAgB;IAC5C,OAAO,EAAE;SACP,MAAM,CAAC,QAAQ,CAAC;SAChB,IAAI,CAAC,GAAG,EAAE,CAAC,IAAI,CAAC;SAChB,KAAK,CAAC,GAAG,EAAE,CAAC,KAAK,CAAC,CAAC;AACtB,CAAC"}

package/dist/utils/logger.d.ts

@@ -0,0 +1,11 @@
+export declare const logger: {
+    info: (msg: string) => void;
+    success: (msg: string) => void;
+    warn: (msg: string) => void;
+    error: (msg: string) => void;
+    /**
+     * Logs a single pipeline step, indented under the current command.
+     */
+    step: (msg: string) => void;
+};
+//# sourceMappingURL=logger.d.ts.map

package/dist/utils/logger.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"logger.d.ts","sourceRoot":"","sources":["../../src/utils/logger.ts"],"names":[],"mappings":"AASA,eAAO,MAAM,MAAM;gBACN,MAAM,KAAG,IAAI;mBACV,MAAM,KAAG,IAAI;gBAChB,MAAM,KAAG,IAAI;iBACZ,MAAM,KAAG,IAAI;IAC1B;;OAEG;gBACS,MAAM,KAAG,IAAI;CACzB,CAAC"}

package/dist/utils/logger.js

@@ -0,0 +1,18 @@
+const reset = '\x1b[0m';
+const green = '\x1b[32m';
+const yellow = '\x1b[33m';
+const red = '\x1b[31m';
+const cyan = '\x1b[36m';
+const dim = '\x1b[2m';
+const tag = `${cyan}[kurot]${reset}`;
+export const logger = {
+    info: (msg) => console.log(`${tag} ${msg}`),
+    success: (msg) => console.log(`${tag} ${green}${msg}${reset}`),
+    warn: (msg) => console.warn(`${tag} ${yellow}${msg}${reset}`),
+    error: (msg) => console.error(`${tag} ${red}${msg}${reset}`),
+    /**
+     * Logs a single pipeline step, indented under the current command.
+     */
+    step: (msg) => console.log(`${tag} ${dim}›${reset} ${msg}`),
+};
+//# sourceMappingURL=logger.js.map

package/dist/utils/logger.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"logger.js","sourceRoot":"","sources":["../../src/utils/logger.ts"],"names":[],"mappings":"AAAA,MAAM,KAAK,GAAG,SAAS,CAAC;AACxB,MAAM,KAAK,GAAG,UAAU,CAAC;AACzB,MAAM,MAAM,GAAG,UAAU,CAAC;AAC1B,MAAM,GAAG,GAAG,UAAU,CAAC;AACvB,MAAM,IAAI,GAAG,UAAU,CAAC;AACxB,MAAM,GAAG,GAAG,SAAS,CAAC;AAEtB,MAAM,GAAG,GAAG,GAAG,IAAI,UAAU,KAAK,EAAE,CAAC;AAErC,MAAM,CAAC,MAAM,MAAM,GAAG;IACrB,IAAI,EAAE,CAAC,GAAW,EAAQ,EAAE,CAAC,OAAO,CAAC,GAAG,CAAC,GAAG,GAAG,IAAI,GAAG,EAAE,CAAC;IACzD,OAAO,EAAE,CAAC,GAAW,EAAQ,EAAE,CAAC,OAAO,CAAC,GAAG,CAAC,GAAG,GAAG,IAAI,KAAK,GAAG,GAAG,GAAG,KAAK,EAAE,CAAC;IAC5E,IAAI,EAAE,CAAC,GAAW,EAAQ,EAAE,CAAC,OAAO,CAAC,IAAI,CAAC,GAAG,GAAG,IAAI,MAAM,GAAG,GAAG,GAAG,KAAK,EAAE,CAAC;IAC3E,KAAK,EAAE,CAAC,GAAW,EAAQ,EAAE,CAAC,OAAO,CAAC,KAAK,CAAC,GAAG,GAAG,IAAI,GAAG,GAAG,GAAG,GAAG,KAAK,EAAE,CAAC;IAC1E;;OAEG;IACH,IAAI,EAAE,CAAC,GAAW,EAAQ,EAAE,CAAC,OAAO,CAAC,GAAG,CAAC,GAAG,GAAG,IAAI,GAAG,IAAI,KAAK,IAAI,GAAG,EAAE,CAAC;CACzE,CAAC"}

package/package.json

@@ -0,0 +1,45 @@
+{
+	"name": "@kurot/cli",
+	"version": "1.0.2",
+	"description": "Kurot CLI - build tool for the Kurot game engine",
+	"type": "module",
+	"bin": {
+		"kurot": "./dist/index.js"
+	},
+	"main": "./dist/define.js",
+	"types": "./dist/define.d.ts",
+	"files": [
+		"dist",
+		"templates",
+		"README.md",
+		"CHANGELOG.md"
+	],
+	"publishConfig": {
+		"access": "public"
+	},
+	"scripts": {
+		"build": "tsc --build",
+		"dev": "tsc --watch",
+		"clean": "rm -rf dist",
+		"test": "vitest run",
+		"test:watch": "vitest",
+		"prepublishOnly": "npm run clean && npm run build",
+		"kurot": "tsx src/index.ts"
+	},
+	"dependencies": {
+		"commander": "^13.0.0",
+		"esbuild": "^0.25.0"
+	},
+	"devDependencies": {
+		"@types/node": "^22.0.0",
+		"tsx": "^4.21.0",
+		"typescript": "^5.6.0",
+		"vitest": "^4.1.4"
+	},
+	"packageManager": "pnpm@10.33.0",
+	"repository": {
+		"type": "git",
+		"url": "git+https://github.com/kurot-engine/kurot.git",
+		"directory": "packages/cli"
+	}
+}

package/templates/empty/kurot.config.ts

@@ -0,0 +1,13 @@
+export default {
+	target: 'html5',
+	entry: 'src/Main.ts',
+	output: { dir: 'bin-debug' },
+	html: { template: 'template/web/index.html' },
+	stage: {
+		width: 640,
+		height: 1136,
+		scaleMode: 'showAll',
+		orientation: 'auto',
+		frameRate: 60,
+	},
+};

package/templates/empty/package.json

@@ -0,0 +1,17 @@
+{
+	"name": "kurot-empty",
+	"version": "0.1.0",
+	"type": "module",
+	"scripts": {
+		"build": "kurot build",
+		"release": "kurot build --release",
+		"dev": "kurot dev",
+		"clean": "kurot clean"
+	},
+	"dependencies": {
+		"@kurot/core": "latest"
+	},
+	"devDependencies": {
+		"@kurot/cli": "latest"
+	}
+}

package/templates/empty/pnpm-workspace.yaml

@@ -0,0 +1,3 @@
+allowBuilds:
+  esbuild: true
+minimumReleaseAge: 0

package/templates/empty/src/Main.ts

@@ -0,0 +1,32 @@
+/**
+ * Kurot 空白项目模板
+ *
+ * 最小化入口，只依赖 @kurot/core，不含 UI 组件。
+ * 适用于纯 Canvas 渲染、自定义绘制、动画实验等场景。
+ *
+ * 生命周期：constructor → ADDED_TO_STAGE → $onAddToStage
+ */
+import { createPlayer, Sprite, Event } from '@kurot/core';
+
+class Main extends Sprite {
+	public constructor() {
+		super();
+		this.addEventListener(Event.ADDED_TO_STAGE, this.onAddedToStage);
+	}
+
+	private onAddedToStage(_event: Event): void {
+		// 在这里编写你的游戏逻辑
+		console.log('Kurot game started');
+	}
+}
+
+// ── 启动 ──────────────────────────────────────────────────────────────────
+const app = createPlayer({
+	canvas: document.getElementById('gameCanvas') as HTMLCanvasElement,
+	contentWidth: 640,
+	contentHeight: 1136,
+	scaleMode: 'showAll',
+	frameRate: 60,
+});
+
+app.start(new Main());