@kurot/cli 1.0.2

package/dist/core/config.d.ts

@@ -0,0 +1,94 @@
+export type BuildTarget = 'html5';
+export interface StageConfig {
+    /**
+     * Stage width in points.
+     */
+    width: number;
+    /**
+     * Stage height in points.
+     */
+    height: number;
+    /**
+     * Egret-style scale mode: `showAll` | `noScale` | `exactFit` | `noBorder` |
+     * `fixedHeight` | `fixedWidth` | `fixedNarrow` | `fixedWide`.
+     */
+    scaleMode: string;
+    /**
+     * Preferred device orientation (e.g. `auto`, `portrait`, `landscape`).
+     */
+    orientation: string;
+    /**
+     * Target frame rate, in frames per second.
+     */
+    frameRate: number;
+}
+export interface ExmlConfig {
+    /**
+     * Path to the Egret-style theme file (e.g. `resource/default.thm.json`),
+     * relative to the project root.
+     */
+    themeFile: string;
+    /**
+     * Custom EXML namespaces for project-defined components, matching Egret's
+     * `xmlns:game="game.*"` convention. Maps the namespace prefix used in EXML
+     * (e.g. `game`) to a barrel file that exports every class referenced under
+     * that namespace (e.g. `src/ui/index.ts` re-exporting `HeroNarrowIR`, etc.).
+     *
+     * Each barrel is bundled into its own chunk and wired into both the app and
+     * skins bundles via an import map, so a class referenced from EXML and from
+     * game code resolves to the same module instance (no duplicate class identity).
+     */
+    namespaces?: Record<string, string>;
+}
+export interface OutputConfig {
+    /**
+     * Development build output directory, relative to the project root
+     * (default: `bin-debug`). Release builds always go to
+     * `bin-release/web/<timestamp>` regardless of this setting.
+     */
+    dir: string;
+}
+export interface HtmlConfig {
+    /**
+     * Path to the project-owned HTML template, relative to the project root.
+     * Omit to use the CLI's built-in default template.
+     */
+    template: string;
+}
+export interface ProjectConfig {
+    /**
+     * Build target platform. Only `html5` is currently supported.
+     */
+    target: BuildTarget;
+    /**
+     * Path to the entry source file, relative to the project root
+     * (default: `src/Main.ts`).
+     */
+    entry: string;
+    /**
+     * Development build output settings.
+     */
+    output: OutputConfig;
+    /**
+     * HTML page template settings. Omit to use the built-in default page.
+     */
+    html?: HtmlConfig;
+    /**
+     * Stage / canvas configuration.
+     */
+    stage: StageConfig;
+    /**
+     * EXML compilation settings. Omit to disable EXML support entirely.
+     */
+    exml?: ExmlConfig;
+}
+/**
+ * Loads and validates `kurot.config.ts` (or `.js`) from the current working
+ * directory, merging it over `DEFAULTS`. Falls back to `DEFAULTS` entirely
+ * when no config file is present.
+ *
+ * @returns The validated project configuration
+ * @throws {ConfigError} If `stage.frameRate`, `stage.scaleMode`, or `entry` is invalid
+ */
+export declare function loadConfig(): Promise<ProjectConfig>;
+//# sourceMappingURL=config.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"config.d.ts","sourceRoot":"","sources":["../../src/core/config.ts"],"names":[],"mappings":"AAIA,MAAM,MAAM,WAAW,GAAG,OAAO,CAAC;AAElC,MAAM,WAAW,WAAW;IAC3B;;OAEG;IACH,KAAK,EAAE,MAAM,CAAC;IACd;;OAEG;IACH,MAAM,EAAE,MAAM,CAAC;IACf;;;OAGG;IACH,SAAS,EAAE,MAAM,CAAC;IAClB;;OAEG;IACH,WAAW,EAAE,MAAM,CAAC;IACpB;;OAEG;IACH,SAAS,EAAE,MAAM,CAAC;CAClB;AAED,MAAM,WAAW,UAAU;IAC1B;;;OAGG;IACH,SAAS,EAAE,MAAM,CAAC;IAClB;;;;;;;;;OASG;IACH,UAAU,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;CACpC;AAED,MAAM,WAAW,YAAY;IAC5B;;;;OAIG;IACH,GAAG,EAAE,MAAM,CAAC;CACZ;AAED,MAAM,WAAW,UAAU;IAC1B;;;OAGG;IACH,QAAQ,EAAE,MAAM,CAAC;CACjB;AAED,MAAM,WAAW,aAAa;IAC7B;;OAEG;IACH,MAAM,EAAE,WAAW,CAAC;IACpB;;;OAGG;IACH,KAAK,EAAE,MAAM,CAAC;IACd;;OAEG;IACH,MAAM,EAAE,YAAY,CAAC;IACrB;;OAEG;IACH,IAAI,CAAC,EAAE,UAAU,CAAC;IAClB;;OAEG;IACH,KAAK,EAAE,WAAW,CAAC;IACnB;;OAEG;IACH,IAAI,CAAC,EAAE,UAAU,CAAC;CAClB;AA0BD;;;;;;;GAOG;AACH,wBAAsB,UAAU,IAAI,OAAO,CAAC,aAAa,CAAC,CA6CzD"}

package/dist/core/config.js

@@ -0,0 +1,70 @@
+import * as path from 'node:path';
+import { exists } from '../utils/fs.js';
+import { ConfigError } from './errors.js';
+const DEFAULTS = {
+    target: 'html5',
+    entry: 'src/Main.ts',
+    output: { dir: 'bin-debug' },
+    stage: {
+        width: 640,
+        height: 1136,
+        scaleMode: 'showAll',
+        orientation: 'auto',
+        frameRate: 60,
+    },
+};
+const VALID_SCALE_MODES = [
+    'showAll',
+    'noScale',
+    'exactFit',
+    'noBorder',
+    'fixedHeight',
+    'fixedWidth',
+    'fixedNarrow',
+    'fixedWide',
+];
+/**
+ * Loads and validates `kurot.config.ts` (or `.js`) from the current working
+ * directory, merging it over `DEFAULTS`. Falls back to `DEFAULTS` entirely
+ * when no config file is present.
+ *
+ * @returns The validated project configuration
+ * @throws {ConfigError} If `stage.frameRate`, `stage.scaleMode`, or `entry` is invalid
+ */
+export async function loadConfig() {
+    const configPath = path.resolve('kurot.config.ts');
+    const jsConfigPath = path.resolve('kurot.config.js');
+    let config;
+    if ((await exists(configPath)) || (await exists(jsConfigPath))) {
+        // Dynamic import of `kurot.config.ts` relies on Node's built-in
+        // TypeScript type-stripping support (no `tsx`/`ts-node` involved).
+        const mod = await import((await exists(configPath)) ? configPath : jsConfigPath);
+        const userConfig = mod.default ?? mod;
+        config = { ...DEFAULTS, ...userConfig, stage: { ...DEFAULTS.stage, ...userConfig.stage } };
+    }
+    else {
+        config = DEFAULTS;
+    }
+    // Validate stage.frameRate
+    if (!Number.isInteger(config.stage.frameRate) || config.stage.frameRate <= 0) {
+        throw new ConfigError(`Invalid config: stage.frameRate must be a positive integer, got ${config.stage.frameRate}`);
+    }
+    // Validate stage.scaleMode
+    if (!VALID_SCALE_MODES.includes(config.stage.scaleMode)) {
+        throw new ConfigError(`Invalid config: stage.scaleMode must be one of ${VALID_SCALE_MODES.map(m => `'${m}'`).join(', ')}, got '${config.stage.scaleMode}'`);
+    }
+    // Validate entry file exists
+    const entryPath = path.resolve(config.entry);
+    if (!(await exists(entryPath))) {
+        throw new ConfigError(`Invalid config: entry file '${config.entry}' does not exist`);
+    }
+    // Validate HTML template exists
+    if (config.html) {
+        const templatePath = path.resolve(config.html.template);
+        if (!(await exists(templatePath))) {
+            throw new ConfigError(`Invalid config: HTML template '${config.html.template}' does not exist`);
+        }
+    }
+    return config;
+}
+//# sourceMappingURL=config.js.map

package/dist/core/config.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"config.js","sourceRoot":"","sources":["../../src/core/config.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,IAAI,MAAM,WAAW,CAAC;AAClC,OAAO,EAAE,MAAM,EAAE,MAAM,gBAAgB,CAAC;AACxC,OAAO,EAAE,WAAW,EAAE,MAAM,aAAa,CAAC;AA4F1C,MAAM,QAAQ,GAAkB;IAC/B,MAAM,EAAE,OAAO;IACf,KAAK,EAAE,aAAa;IACpB,MAAM,EAAE,EAAE,GAAG,EAAE,WAAW,EAAE;IAC5B,KAAK,EAAE;QACN,KAAK,EAAE,GAAG;QACV,MAAM,EAAE,IAAI;QACZ,SAAS,EAAE,SAAS;QACpB,WAAW,EAAE,MAAM;QACnB,SAAS,EAAE,EAAE;KACb;CACD,CAAC;AAEF,MAAM,iBAAiB,GAAG;IACzB,SAAS;IACT,SAAS;IACT,UAAU;IACV,UAAU;IACV,aAAa;IACb,YAAY;IACZ,aAAa;IACb,WAAW;CACF,CAAC;AAEX;;;;;;;GAOG;AACH,MAAM,CAAC,KAAK,UAAU,UAAU;IAC/B,MAAM,UAAU,GAAG,IAAI,CAAC,OAAO,CAAC,iBAAiB,CAAC,CAAC;IACnD,MAAM,YAAY,GAAG,IAAI,CAAC,OAAO,CAAC,iBAAiB,CAAC,CAAC;IAErD,IAAI,MAAqB,CAAC;IAE1B,IAAI,CAAC,MAAM,MAAM,CAAC,UAAU,CAAC,CAAC,IAAI,CAAC,MAAM,MAAM,CAAC,YAAY,CAAC,CAAC,EAAE,CAAC;QAChE,gEAAgE;QAChE,mEAAmE;QACnE,MAAM,GAAG,GAAG,MAAM,MAAM,CAAC,CAAC,MAAM,MAAM,CAAC,UAAU,CAAC,CAAC,CAAC,CAAC,CAAC,UAAU,CAAC,CAAC,CAAC,YAAY,CAAC,CAAC;QACjF,MAAM,UAAU,GAAkB,GAAG,CAAC,OAAO,IAAI,GAAG,CAAC;QACrD,MAAM,GAAG,EAAE,GAAG,QAAQ,EAAE,GAAG,UAAU,EAAE,KAAK,EAAE,EAAE,GAAG,QAAQ,CAAC,KAAK,EAAE,GAAG,UAAU,CAAC,KAAK,EAAE,EAAE,CAAC;IAC5F,CAAC;SAAM,CAAC;QACP,MAAM,GAAG,QAAQ,CAAC;IACnB,CAAC;IAED,2BAA2B;IAC3B,IAAI,CAAC,MAAM,CAAC,SAAS,CAAC,MAAM,CAAC,KAAK,CAAC,SAAS,CAAC,IAAI,MAAM,CAAC,KAAK,CAAC,SAAS,IAAI,CAAC,EAAE,CAAC;QAC9E,MAAM,IAAI,WAAW,CACpB,mEAAmE,MAAM,CAAC,KAAK,CAAC,SAAS,EAAE,CAC3F,CAAC;IACH,CAAC;IAED,2BAA2B;IAC3B,IAAI,CAAC,iBAAiB,CAAC,QAAQ,CAAC,MAAM,CAAC,KAAK,CAAC,SAA+C,CAAC,EAAE,CAAC;QAC/F,MAAM,IAAI,WAAW,CACpB,kDAAkD,iBAAiB,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,UAAU,MAAM,CAAC,KAAK,CAAC,SAAS,GAAG,CACpI,CAAC;IACH,CAAC;IAED,6BAA6B;IAC7B,MAAM,SAAS,GAAG,IAAI,CAAC,OAAO,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC;IAC7C,IAAI,CAAC,CAAC,MAAM,MAAM,CAAC,SAAS,CAAC,CAAC,EAAE,CAAC;QAChC,MAAM,IAAI,WAAW,CAAC,+BAA+B,MAAM,CAAC,KAAK,kBAAkB,CAAC,CAAC;IACtF,CAAC;IAED,gCAAgC;IAChC,IAAI,MAAM,CAAC,IAAI,EAAE,CAAC;QACjB,MAAM,YAAY,GAAG,IAAI,CAAC,OAAO,CAAC,MAAM,CAAC,IAAI,CAAC,QAAQ,CAAC,CAAC;QACxD,IAAI,CAAC,CAAC,MAAM,MAAM,CAAC,YAAY,CAAC,CAAC,EAAE,CAAC;YACnC,MAAM,IAAI,WAAW,CAAC,kCAAkC,MAAM,CAAC,IAAI,CAAC,QAAQ,kBAAkB,CAAC,CAAC;QACjG,CAAC;IACF,CAAC;IAED,OAAO,MAAM,CAAC;AACf,CAAC"}

package/dist/core/dev-server.d.ts

@@ -0,0 +1,21 @@
+import type { Project } from './project.js';
+export interface DevServerOptions {
+    /**
+     * Port for the dev server to listen on.
+     */
+    port: number;
+    /**
+     * Whether to generate sourcemaps for the app bundle.
+     */
+    sourcemap: boolean;
+}
+/**
+ * Starts a development server.
+ *
+ * The build pipeline runs once with watch enabled: esbuild rebuilds `main.js`
+ * on every source change, and an `fs.watch` on `resource/` recompiles EXML and
+ * re-copies assets. Files are served straight from the output directory.
+ * The browser is not auto-reloaded — refresh manually to pick up changes.
+ */
+export declare function startDevServer(project: Project, options: DevServerOptions): Promise<void>;
+//# sourceMappingURL=dev-server.d.ts.map

package/dist/core/dev-server.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"dev-server.d.ts","sourceRoot":"","sources":["../../src/core/dev-server.ts"],"names":[],"mappings":"AAIA,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,cAAc,CAAC;AAY5C,MAAM,WAAW,gBAAgB;IAChC;;OAEG;IACH,IAAI,EAAE,MAAM,CAAC;IACb;;OAEG;IACH,SAAS,EAAE,OAAO,CAAC;CACnB;AAED;;;;;;;GAOG;AACH,wBAAsB,cAAc,CAAC,OAAO,EAAE,OAAO,EAAE,OAAO,EAAE,gBAAgB,GAAG,OAAO,CAAC,IAAI,CAAC,CAoB/F"}

package/dist/core/dev-server.js

@@ -0,0 +1,113 @@
+import * as http from 'node:http';
+import * as fs from 'node:fs/promises';
+import * as fsSync from 'node:fs';
+import * as path from 'node:path';
+import { createContext, runPipeline, disposeContext } from './pipeline.js';
+import { compileExml, compileEngine, compileCustomNamespaces, compileSource, generateHtml, copyAssets, } from './plugins/index.js';
+import { logger } from '../utils/logger.js';
+/**
+ * Starts a development server.
+ *
+ * The build pipeline runs once with watch enabled: esbuild rebuilds `main.js`
+ * on every source change, and an `fs.watch` on `resource/` recompiles EXML and
+ * re-copies assets. Files are served straight from the output directory.
+ * The browser is not auto-reloaded — refresh manually to pick up changes.
+ */
+export async function startDevServer(project, options) {
+    const ctx = createContext(project, { sourcemap: options.sourcemap, watch: true });
+    await runPipeline(ctx, [
+        compileExml(),
+        compileEngine(),
+        compileCustomNamespaces(),
+        compileSource(),
+        generateHtml(),
+        copyAssets(),
+    ]);
+    watchResources(project, ctx);
+    const server = startHttpServer(project, options.port);
+    process.on('SIGINT', async () => {
+        logger.info('Stopping dev server...');
+        await disposeContext(ctx);
+        server.close();
+        process.exit(0);
+    });
+}
+/**
+ * Recompiles EXML and re-copies assets when a `.exml` file changes.
+ */
+function watchResources(project, ctx) {
+    if (!project.config.exml)
+        return;
+    let debounce;
+    let watcher;
+    try {
+        watcher = fsSync.watch(project.resourceDir, { recursive: true }, (_event, filename) => {
+            if (!filename || !filename.endsWith('.exml'))
+                return;
+            clearTimeout(debounce);
+            debounce = setTimeout(async () => {
+                logger.info(`EXML changed: ${path.basename(filename)}, recompiling...`);
+                try {
+                    await compileExml().apply(ctx);
+                    await copyAssets().apply(ctx);
+                }
+                catch (err) {
+                    logger.warn(`EXML recompile failed: ${err instanceof Error ? err.message : err}`);
+                }
+            }, 100);
+        });
+    }
+    catch {
+        logger.warn('EXML watcher unavailable (recursive fs.watch unsupported on this platform).');
+        return;
+    }
+    ctx.disposers.push(() => watcher.close());
+}
+/**
+ * Serves static files from the project output directory.
+ */
+function startHttpServer(project, port) {
+    const server = http.createServer(async (req, res) => {
+        const url = (req.url ?? '/').split('?')[0];
+        const filePath = path.join(project.outputDir, url === '/' ? 'index.html' : url);
+        try {
+            const data = await fs.readFile(filePath);
+            res.writeHead(200, { 'Content-Type': mimeType(filePath) });
+            res.end(data);
+        }
+        catch {
+            res.writeHead(404);
+            res.end('Not found');
+        }
+    });
+    server.listen(port, () => {
+        logger.success(`Dev server running at http://localhost:${port}`);
+        logger.info('Watching for changes (refresh the browser to reload)...');
+    });
+    return server;
+}
+const MIME_TYPES = {
+    '.html': 'text/html; charset=utf-8',
+    '.js': 'application/javascript',
+    '.mjs': 'application/javascript',
+    '.map': 'application/json',
+    '.css': 'text/css',
+    '.json': 'application/json',
+    '.png': 'image/png',
+    '.jpg': 'image/jpeg',
+    '.jpeg': 'image/jpeg',
+    '.gif': 'image/gif',
+    '.svg': 'image/svg+xml',
+    '.webp': 'image/webp',
+    '.mp3': 'audio/mpeg',
+    '.ogg': 'audio/ogg',
+    '.wav': 'audio/wav',
+    '.mp4': 'video/mp4',
+    '.woff': 'font/woff',
+    '.woff2': 'font/woff2',
+    '.ttf': 'font/ttf',
+};
+function mimeType(filePath) {
+    return MIME_TYPES[path.extname(filePath).toLowerCase()] ?? 'application/octet-stream';
+}
+//# sourceMappingURL=dev-server.js.map

package/dist/core/dev-server.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"dev-server.js","sourceRoot":"","sources":["../../src/core/dev-server.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,IAAI,MAAM,WAAW,CAAC;AAClC,OAAO,KAAK,EAAE,MAAM,kBAAkB,CAAC;AACvC,OAAO,KAAK,MAAM,MAAM,SAAS,CAAC;AAClC,OAAO,KAAK,IAAI,MAAM,WAAW,CAAC;AAElC,OAAO,EAAE,aAAa,EAAE,WAAW,EAAE,cAAc,EAAqB,MAAM,eAAe,CAAC;AAC9F,OAAO,EACN,WAAW,EACX,aAAa,EACb,uBAAuB,EACvB,aAAa,EACb,YAAY,EACZ,UAAU,GACV,MAAM,oBAAoB,CAAC;AAC5B,OAAO,EAAE,MAAM,EAAE,MAAM,oBAAoB,CAAC;AAa5C;;;;;;;GAOG;AACH,MAAM,CAAC,KAAK,UAAU,cAAc,CAAC,OAAgB,EAAE,OAAyB;IAC/E,MAAM,GAAG,GAAG,aAAa,CAAC,OAAO,EAAE,EAAE,SAAS,EAAE,OAAO,CAAC,SAAS,EAAE,KAAK,EAAE,IAAI,EAAE,CAAC,CAAC;IAClF,MAAM,WAAW,CAAC,GAAG,EAAE;QACtB,WAAW,EAAE;QACb,aAAa,EAAE;QACf,uBAAuB,EAAE;QACzB,aAAa,EAAE;QACf,YAAY,EAAE;QACd,UAAU,EAAE;KACZ,CAAC,CAAC;IAEH,cAAc,CAAC,OAAO,EAAE,GAAG,CAAC,CAAC;IAC7B,MAAM,MAAM,GAAG,eAAe,CAAC,OAAO,EAAE,OAAO,CAAC,IAAI,CAAC,CAAC;IAEtD,OAAO,CAAC,EAAE,CAAC,QAAQ,EAAE,KAAK,IAAI,EAAE;QAC/B,MAAM,CAAC,IAAI,CAAC,wBAAwB,CAAC,CAAC;QACtC,MAAM,cAAc,CAAC,GAAG,CAAC,CAAC;QAC1B,MAAM,CAAC,KAAK,EAAE,CAAC;QACf,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;IACjB,CAAC,CAAC,CAAC;AACJ,CAAC;AAED;;GAEG;AACH,SAAS,cAAc,CAAC,OAAgB,EAAE,GAAiB;IAC1D,IAAI,CAAC,OAAO,CAAC,MAAM,CAAC,IAAI;QAAE,OAAO;IAEjC,IAAI,QAAmD,CAAC;IACxD,IAAI,OAAyB,CAAC;IAC9B,IAAI,CAAC;QACJ,OAAO,GAAG,MAAM,CAAC,KAAK,CAAC,OAAO,CAAC,WAAW,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,EAAE,CAAC,MAAM,EAAE,QAAQ,EAAE,EAAE;YACrF,IAAI,CAAC,QAAQ,IAAI,CAAC,QAAQ,CAAC,QAAQ,CAAC,OAAO,CAAC;gBAAE,OAAO;YACrD,YAAY,CAAC,QAAQ,CAAC,CAAC;YACvB,QAAQ,GAAG,UAAU,CAAC,KAAK,IAAI,EAAE;gBAChC,MAAM,CAAC,IAAI,CAAC,iBAAiB,IAAI,CAAC,QAAQ,CAAC,QAAQ,CAAC,kBAAkB,CAAC,CAAC;gBACxE,IAAI,CAAC;oBACJ,MAAM,WAAW,EAAE,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC;oBAC/B,MAAM,UAAU,EAAE,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC;gBAC/B,CAAC;gBAAC,OAAO,GAAG,EAAE,CAAC;oBACd,MAAM,CAAC,IAAI,CAAC,0BAA0B,GAAG,YAAY,KAAK,CAAC,CAAC,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC,CAAC,GAAG,EAAE,CAAC,CAAC;gBACnF,CAAC;YACF,CAAC,EAAE,GAAG,CAAC,CAAC;QACT,CAAC,CAAC,CAAC;IACJ,CAAC;IAAC,MAAM,CAAC;QACR,MAAM,CAAC,IAAI,CAAC,6EAA6E,CAAC,CAAC;QAC3F,OAAO;IACR,CAAC;IACD,GAAG,CAAC,SAAS,CAAC,IAAI,CAAC,GAAG,EAAE,CAAC,OAAO,CAAC,KAAK,EAAE,CAAC,CAAC;AAC3C,CAAC;AAED;;GAEG;AACH,SAAS,eAAe,CAAC,OAAgB,EAAE,IAAY;IACtD,MAAM,MAAM,GAAG,IAAI,CAAC,YAAY,CAAC,KAAK,EAAE,GAAG,EAAE,GAAG,EAAE,EAAE;QACnD,MAAM,GAAG,GAAG,CAAC,GAAG,CAAC,GAAG,IAAI,GAAG,CAAC,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,CAAC;QAC3C,MAAM,QAAQ,GAAG,IAAI,CAAC,IAAI,CAAC,OAAO,CAAC,SAAS,EAAE,GAAG,KAAK,GAAG,CAAC,CAAC,CAAC,YAAY,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC;QAChF,IAAI,CAAC;YACJ,MAAM,IAAI,GAAG,MAAM,EAAE,CAAC,QAAQ,CAAC,QAAQ,CAAC,CAAC;YACzC,GAAG,CAAC,SAAS,CAAC,GAAG,EAAE,EAAE,cAAc,EAAE,QAAQ,CAAC,QAAQ,CAAC,EAAE,CAAC,CAAC;YAC3D,GAAG,CAAC,GAAG,CAAC,IAAI,CAAC,CAAC;QACf,CAAC;QAAC,MAAM,CAAC;YACR,GAAG,CAAC,SAAS,CAAC,GAAG,CAAC,CAAC;YACnB,GAAG,CAAC,GAAG,CAAC,WAAW,CAAC,CAAC;QACtB,CAAC;IACF,CAAC,CAAC,CAAC;IAEH,MAAM,CAAC,MAAM,CAAC,IAAI,EAAE,GAAG,EAAE;QACxB,MAAM,CAAC,OAAO,CAAC,0CAA0C,IAAI,EAAE,CAAC,CAAC;QACjE,MAAM,CAAC,IAAI,CAAC,yDAAyD,CAAC,CAAC;IACxE,CAAC,CAAC,CAAC;IACH,OAAO,MAAM,CAAC;AACf,CAAC;AAED,MAAM,UAAU,GAA2B;IAC1C,OAAO,EAAE,0BAA0B;IACnC,KAAK,EAAE,wBAAwB;IAC/B,MAAM,EAAE,wBAAwB;IAChC,MAAM,EAAE,kBAAkB;IAC1B,MAAM,EAAE,UAAU;IAClB,OAAO,EAAE,kBAAkB;IAC3B,MAAM,EAAE,WAAW;IACnB,MAAM,EAAE,YAAY;IACpB,OAAO,EAAE,YAAY;IACrB,MAAM,EAAE,WAAW;IACnB,MAAM,EAAE,eAAe;IACvB,OAAO,EAAE,YAAY;IACrB,MAAM,EAAE,YAAY;IACpB,MAAM,EAAE,WAAW;IACnB,MAAM,EAAE,WAAW;IACnB,MAAM,EAAE,WAAW;IACnB,OAAO,EAAE,WAAW;IACpB,QAAQ,EAAE,YAAY;IACtB,MAAM,EAAE,UAAU;CAClB,CAAC;AAEF,SAAS,QAAQ,CAAC,QAAgB;IACjC,OAAO,UAAU,CAAC,IAAI,CAAC,OAAO,CAAC,QAAQ,CAAC,CAAC,WAAW,EAAE,CAAC,IAAI,0BAA0B,CAAC;AACvF,CAAC"}

package/dist/core/errors.d.ts

@@ -0,0 +1,16 @@
+/**
+ * A build step failed. Thrown by the CLI's `build` command and caught at the
+ * top level to print a friendly error instead of a raw stack trace.
+ */
+export declare class BuildError extends Error {
+    readonly cause?: Error | undefined;
+    constructor(message: string, cause?: Error | undefined);
+}
+/**
+ * `kurot.config.ts` failed validation (e.g. a missing entry file or an
+ * invalid `stage.scaleMode`).
+ */
+export declare class ConfigError extends Error {
+    constructor(message: string);
+}
+//# sourceMappingURL=errors.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"errors.d.ts","sourceRoot":"","sources":["../../src/core/errors.ts"],"names":[],"mappings":"AAAA;;;GAGG;AACH,qBAAa,UAAW,SAAQ,KAAK;IAGnC,QAAQ,CAAC,KAAK,CAAC,EAAE,KAAK;gBADtB,OAAO,EAAE,MAAM,EACN,KAAK,CAAC,EAAE,KAAK,YAAA;CAKvB;AAED;;;GAGG;AACH,qBAAa,WAAY,SAAQ,KAAK;gBACzB,OAAO,EAAE,MAAM;CAI3B"}

package/dist/core/errors.js

@@ -0,0 +1,23 @@
+/**
+ * A build step failed. Thrown by the CLI's `build` command and caught at the
+ * top level to print a friendly error instead of a raw stack trace.
+ */
+export class BuildError extends Error {
+    cause;
+    constructor(message, cause) {
+        super(message);
+        this.cause = cause;
+        this.name = 'BuildError';
+    }
+}
+/**
+ * `kurot.config.ts` failed validation (e.g. a missing entry file or an
+ * invalid `stage.scaleMode`).
+ */
+export class ConfigError extends Error {
+    constructor(message) {
+        super(message);
+        this.name = 'ConfigError';
+    }
+}
+//# sourceMappingURL=errors.js.map

package/dist/core/errors.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"errors.js","sourceRoot":"","sources":["../../src/core/errors.ts"],"names":[],"mappings":"AAAA;;;GAGG;AACH,MAAM,OAAO,UAAW,SAAQ,KAAK;IAG1B;IAFV,YACC,OAAe,EACN,KAAa;QAEtB,KAAK,CAAC,OAAO,CAAC,CAAC;QAFN,UAAK,GAAL,KAAK,CAAQ;QAGtB,IAAI,CAAC,IAAI,GAAG,YAAY,CAAC;IAC1B,CAAC;CACD;AAED;;;GAGG;AACH,MAAM,OAAO,WAAY,SAAQ,KAAK;IACrC,YAAY,OAAe;QAC1B,KAAK,CAAC,OAAO,CAAC,CAAC;QACf,IAAI,CAAC,IAAI,GAAG,aAAa,CAAC;IAC3B,CAAC;CACD"}

package/dist/core/exml/ast.d.ts

@@ -0,0 +1,243 @@
+/**
+ * Intermediate representation (IR / AST) for a parsed EXML skin.
+ *
+ * The EXML parser converts XML → SkinIR, then the code generator
+ * converts SkinIR → JS source code.
+ */
+/**
+ * A literal value (string, number, boolean, null).
+ */
+export interface LiteralValue {
+    readonly type: 'literal';
+    readonly value: string | number | boolean | null;
+}
+/**
+ * A percent value (e.g. `width="100%"`).
+ */
+export interface PercentValue {
+    readonly type: 'percent';
+    /**
+     * The numeric portion (e.g. `100`).
+     */
+    readonly value: number;
+}
+/**
+ * A binding expression (e.g. `"{data.name}"`).
+ */
+export interface BindingValue {
+    readonly type: 'binding';
+    /**
+     * The expression string (e.g. `"data.name"`).
+     */
+    readonly expression: string;
+}
+/**
+ * A reference to a skin part by id (e.g. for an `AddItems` target).
+ */
+export interface RefValue {
+    readonly type: 'ref';
+    /**
+     * The variable name in generated code.
+     */
+    readonly varName: string;
+}
+export type PropertyValue = LiteralValue | PercentValue | BindingValue | RefValue;
+export interface PropertyAssignment {
+    /**
+     * Property name.
+     */
+    readonly name: string;
+    /**
+     * State name (empty = default, e.g. "up" from "label.up").
+     */
+    readonly state: string;
+    /**
+     * The value to assign.
+     */
+    readonly value: PropertyValue;
+}
+/**
+ * A component instance in the skin.
+ */
+export interface SkinNode {
+    /**
+     * Tag/class name (without namespace, e.g. "Button").
+     */
+    readonly className: string;
+    /**
+     * Module to import from (e.g. "@kurot/ui").
+     */
+    readonly module: string;
+    /**
+     * Variable name in generated code (e.g. "btn1").
+     */
+    readonly varName: string;
+    /**
+     * ID (skin part name, e.g. "myBtn") or undefined.
+     */
+    readonly id?: string;
+    /**
+     * Properties to set on this node.
+     */
+    readonly properties: PropertyAssignment[];
+    /**
+     * Children assigned to the default property.
+     */
+    readonly children: SkinNode[];
+    /**
+     * Children assigned to named properties (property nodes).
+     */
+    readonly propertyChildren: PropertyChild[];
+    /**
+     * `includeIn` state names (only present in these states).
+     */
+    readonly includeIn: string[];
+    /**
+     * `excludeFrom` state names (excluded from these states).
+     */
+    readonly excludeFrom: string[];
+}
+/**
+ * A child assigned to a specific property (via property node syntax).
+ */
+export interface PropertyChild {
+    /**
+     * Property name.
+     */
+    readonly propertyName: string;
+    /**
+     * The child node(s) — usually a single node or text content.
+     */
+    readonly nodes: (SkinNode | string)[];
+}
+export interface StateAddItems {
+    readonly type: 'AddItems';
+    /**
+     * ID of the item to add.
+     */
+    readonly targetId: string;
+    /**
+     * ID of the destination container.
+     */
+    readonly destinationId: string;
+    /**
+     * Insertion index (-1 = append).
+     */
+    readonly position: number;
+    /**
+     * Property name on the destination.
+     */
+    readonly propertyName: string;
+}
+export interface StateSetProperty {
+    readonly type: 'SetProperty';
+    /**
+     * ID of the target (empty = skin itself).
+     */
+    readonly targetId: string;
+    /**
+     * Property name.
+     */
+    readonly name: string;
+    /**
+     * Value to set.
+     */
+    readonly value: PropertyValue;
+}
+export interface StateSetStateProperty {
+    readonly type: 'SetStateProperty';
+    /**
+     * Property name.
+     */
+    readonly name: string;
+    /**
+     * Value to set.
+     */
+    readonly value: PropertyValue;
+    /**
+     * State that triggers this.
+     */
+    readonly stateName: string;
+}
+export type StateOverride = StateAddItems | StateSetProperty | StateSetStateProperty;
+export interface StateDef {
+    /**
+     * State name (e.g. "up", "down", "disabled").
+     */
+    readonly name: string;
+    /**
+     * State groups this state belongs to.
+     */
+    readonly stateGroups: string[];
+    /**
+     * State-specific overrides.
+     */
+    readonly overrides: StateOverride[];
+}
+export interface BindingDef {
+    /**
+     * Target variable name.
+     */
+    readonly targetVar: string;
+    /**
+     * Target property name.
+     */
+    readonly targetProp: string;
+    /**
+     * Binding expression string.
+     */
+    readonly expression: string;
+}
+export interface SkinIR {
+    /**
+     * Skin class name (e.g. "MySkin").
+     */
+    readonly className: string;
+    /**
+     * Superclass name (default: "Skin").
+     */
+    readonly superClassName: string;
+    /**
+     * Skin width (from root attributes).
+     */
+    readonly width?: number;
+    /**
+     * Skin height (from root attributes).
+     */
+    readonly height?: number;
+    /**
+     * Other properties declared on the root Skin element.
+     */
+    readonly properties: PropertyAssignment[];
+    /**
+     * All imports needed: className → module.
+     */
+    readonly imports: Map<string, string>;
+    /**
+     * Skin part IDs.
+     */
+    readonly skinParts: string[];
+    /**
+     * Visual children of the skin.
+     */
+    readonly children: SkinNode[];
+    /**
+     * Property children of the skin.
+     */
+    readonly propertyChildren: PropertyChild[];
+    /**
+     * State definitions.
+     */
+    readonly states: StateDef[];
+    /**
+     * Inline declarations (non-visual).
+     */
+    readonly declarations: SkinNode[];
+    /**
+     * Tag names that could not be resolved to a component or a project-defined
+     * namespace (see `NamespaceModule`). These are silently dropped from the
+     * generated skin, so callers should surface them as build warnings.
+     */
+    readonly unresolvedTags: string[];
+}
+//# sourceMappingURL=ast.d.ts.map

package/dist/core/exml/ast.d.ts.map

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

package/dist/core/exml/ast.js

@@ -0,0 +1,8 @@
+/**
+ * Intermediate representation (IR / AST) for a parsed EXML skin.
+ *
+ * The EXML parser converts XML → SkinIR, then the code generator
+ * converts SkinIR → JS source code.
+ */
+export {};
+//# sourceMappingURL=ast.js.map

package/dist/core/exml/ast.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"ast.js","sourceRoot":"","sources":["../../../src/core/exml/ast.ts"],"names":[],"mappings":"AAAA;;;;;GAKG"}

package/dist/core/exml/codegen.d.ts

@@ -0,0 +1,23 @@
+/**
+ * Code generator — converts SkinIR into JavaScript source code.
+ *
+ * Generates ESM-compatible factory functions that create and configure
+ * Skin instances with all components, states, and bindings.
+ */
+import type { SkinIR } from './ast.js';
+export interface CodeGenOptions {
+    /**
+     * Output format. Only `'esm'` is supported (import/export statements for
+     * use as ES modules). Retained as an option for forward compatibility.
+     */
+    format?: 'esm';
+}
+/**
+ * Generate JavaScript source code from a SkinIR.
+ *
+ * @param ir - The skin intermediate representation
+ * @param options - Code generation options
+ * @returns Generated JS source string
+ */
+export declare function generateCode(ir: SkinIR, _options?: CodeGenOptions): string;
+//# sourceMappingURL=codegen.d.ts.map

package/dist/core/exml/codegen.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"codegen.d.ts","sourceRoot":"","sources":["../../../src/core/exml/codegen.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,KAAK,EACX,MAAM,EAYN,MAAM,UAAU,CAAC;AAKlB,MAAM,WAAW,cAAc;IAC9B;;;OAGG;IACH,MAAM,CAAC,EAAE,KAAK,CAAC;CACf;AAED;;;;;;GAMG;AACH,wBAAgB,YAAY,CAAC,EAAE,EAAE,MAAM,EAAE,QAAQ,CAAC,EAAE,cAAc,GAAG,MAAM,CAE1E"}