@kurot/cli 1.0.2

package/dist/core/namespace-external-plugin.js

@@ -0,0 +1,66 @@
+import * as path from 'node:path';
+/**
+ * Normalizes an absolute file path into a namespace-module lookup key by
+ * stripping its extension, if present.
+ *
+ * Both sides of the lookup go through this: `compile-custom-namespaces.ts`
+ * keys `ctx.outputs.namespaceModules` by the exact files esbuild reports it
+ * inlined (`metafile.outputs[x].inputs`), and `namespaceModuleExternalPlugin`
+ * normalizes a resolved import path the same way before checking the map.
+ * Stripping the extension is what lets a `./HeroNarrowIR.js` import (the
+ * `.js`-suffixed ESM import convention used throughout this codebase, e.g.
+ * `import { HeroNarrowIR } from './ui/index.js'`) match its `HeroNarrowIR.ts`
+ * source file (the metafile key).
+ *
+ * @param absolutePath - Absolute file path to normalize
+ * @returns The path with its extension stripped, if any
+ */
+export function normalizeModuleKey(absolutePath) {
+    const ext = path.extname(absolutePath);
+    return ext ? absolutePath.slice(0, -ext.length) : absolutePath;
+}
+/**
+ * Rewrites imports that resolve to a project-defined namespace's source files
+ * to that namespace's virtual specifier, marking them external.
+ *
+ * A custom-namespace class (e.g. `HeroNarrowIR`) can be referenced two ways:
+ * game code imports it by relative path (`./ui/HeroNarrowIR.js`), while
+ * EXML-generated skins import it by the virtual specifier (`#ns/game`,
+ * resolved via the HTML import map — see `compile-custom-namespaces.ts`).
+ * `external: [specifier]` alone only catches the second case; esbuild matches
+ * externals by the literal import string, so the relative import would
+ * otherwise get inlined as a second, distinct copy of the class with
+ * mismatched `instanceof` identity.
+ *
+ * `namespaceModules` is precise (sourced from esbuild's own metafile, not a
+ * guess), so this covers every file a namespace chunk actually inlined — not
+ * just its barrel entry point. Deliberately synchronous and does no file
+ * system I/O: esbuild's own docs warn against calling `build.resolve()`
+ * recursively from within `onResolve` (no loop detection), and this codebase's
+ * `.js`-suffixed import convention (see `normalizeModuleKey`) makes that
+ * unnecessary — a plain path + extension-strip is enough to match.
+ *
+ * @param namespaceModules - Extensionless absolute path → virtual specifier,
+ * populated from esbuild's `metafile.outputs[x].inputs` (see `compile-custom-namespaces.ts`)
+ * @returns An esbuild plugin implementing the rewrite
+ */
+export function namespaceModuleExternalPlugin(namespaceModules) {
+    return {
+        name: 'kurot-namespace-external',
+        setup(build) {
+            if (namespaceModules.size === 0)
+                return;
+            build.onResolve({ filter: /^\./ }, args => {
+                // Entry points resolve normally; only rewrite actual import statements.
+                if (args.kind !== 'import-statement' && args.kind !== 'dynamic-import')
+                    return undefined;
+                const resolved = path.resolve(args.resolveDir, args.path);
+                const specifier = namespaceModules.get(normalizeModuleKey(resolved));
+                if (!specifier)
+                    return undefined;
+                return { path: specifier, external: true };
+            });
+        },
+    };
+}
+//# sourceMappingURL=namespace-external-plugin.js.map

package/dist/core/namespace-external-plugin.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"namespace-external-plugin.js","sourceRoot":"","sources":["../../src/core/namespace-external-plugin.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,IAAI,MAAM,WAAW,CAAC;AAElC;;;;;;;;;;;;;;;GAeG;AACH,MAAM,UAAU,kBAAkB,CAAC,YAAoB;IACtD,MAAM,GAAG,GAAG,IAAI,CAAC,OAAO,CAAC,YAAY,CAAC,CAAC;IACvC,OAAO,GAAG,CAAC,CAAC,CAAC,YAAY,CAAC,KAAK,CAAC,CAAC,EAAE,CAAC,GAAG,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC,YAAY,CAAC;AAChE,CAAC;AAED;;;;;;;;;;;;;;;;;;;;;;;;GAwBG;AACH,MAAM,UAAU,6BAA6B,CAAC,gBAA6C;IAC1F,OAAO;QACN,IAAI,EAAE,0BAA0B;QAChC,KAAK,CAAC,KAAK;YACV,IAAI,gBAAgB,CAAC,IAAI,KAAK,CAAC;gBAAE,OAAO;YAExC,KAAK,CAAC,SAAS,CAAC,EAAE,MAAM,EAAE,KAAK,EAAE,EAAE,IAAI,CAAC,EAAE;gBACzC,wEAAwE;gBACxE,IAAI,IAAI,CAAC,IAAI,KAAK,kBAAkB,IAAI,IAAI,CAAC,IAAI,KAAK,gBAAgB;oBAAE,OAAO,SAAS,CAAC;gBAEzF,MAAM,QAAQ,GAAG,IAAI,CAAC,OAAO,CAAC,IAAI,CAAC,UAAU,EAAE,IAAI,CAAC,IAAI,CAAC,CAAC;gBAC1D,MAAM,SAAS,GAAG,gBAAgB,CAAC,GAAG,CAAC,kBAAkB,CAAC,QAAQ,CAAC,CAAC,CAAC;gBACrE,IAAI,CAAC,SAAS;oBAAE,OAAO,SAAS,CAAC;gBAEjC,OAAO,EAAE,IAAI,EAAE,SAAS,EAAE,QAAQ,EAAE,IAAI,EAAE,CAAC;YAC5C,CAAC,CAAC,CAAC;QACJ,CAAC;KACD,CAAC;AACH,CAAC"}

package/dist/core/pipeline.d.ts

@@ -0,0 +1,75 @@
+import type { Project } from './project.js';
+/**
+ * Shared state threaded through every build plugin.
+ *
+ * Plugins read the immutable `project` and `options`, and communicate results
+ * to later plugins through `outputs` (e.g. the source compiler reports the
+ * generated entry script name so the HTML generator can reference it).
+ */
+export interface BuildContext {
+    readonly project: Project;
+    readonly sourcemap: boolean;
+    readonly analyze: boolean;
+    readonly watch: boolean;
+    /**
+     * Artifacts produced during the build, populated incrementally by plugins.
+     */
+    readonly outputs: {
+        /**
+         * Entry script path, relative to the output dir (e.g. `Main.js`, `js/main.min_ab12.js`).
+         */
+        entryScript?: string;
+        /**
+         * Compiled skins module path, relative to the output dir (e.g. `js/default.thm.js`).
+         */
+        skinsScript?: string;
+        /**
+         * Engine import-map: package specifier → chunk path relative to output dir.
+         */
+        engine: Record<string, string>;
+        /**
+         * Every source file bundled into a custom-namespace chunk (see
+         * `compile-custom-namespaces.ts`), keyed by its extensionless absolute
+         * path (see `normalizeModuleKey` in `namespace-external-plugin.ts`) and
+         * mapped to that namespace's virtual specifier (e.g. `#ns/game`).
+         *
+         * Populated from esbuild's `metafile.outputs[x].inputs` — the exact set
+         * of files a chunk inlined, not a guess. Two consumers rely on this:
+         * `compile-source.ts` excludes these files from its per-file dev output
+         * (re-emitting them as separate entry points would bundle a second,
+         * distinct copy of the same classes), and `namespaceModuleExternalPlugin`
+         * rewrites any import resolving to one of these paths — even a relative
+         * import that bypasses the namespace's barrel file — to the matching
+         * specifier instead of inlining it.
+         */
+        namespaceModules: Map<string, string>;
+    };
+    /**
+     * Cleanup callbacks registered by long-lived plugins (watchers, contexts).
+     */
+    readonly disposers: Array<() => Promise<void> | void>;
+}
+/**
+ * A single, named step in the build pipeline.
+ */
+export interface BuildPlugin {
+    readonly name: string;
+    apply(ctx: BuildContext): Promise<void>;
+}
+/**
+ * Creates a fresh build context for a project.
+ */
+export declare function createContext(project: Project, options?: {
+    sourcemap?: boolean;
+    analyze?: boolean;
+    watch?: boolean;
+}): BuildContext;
+/**
+ * Runs plugins in order, logging each step.
+ */
+export declare function runPipeline(ctx: BuildContext, plugins: BuildPlugin[]): Promise<void>;
+/**
+ * Invokes every registered disposer, ignoring individual failures.
+ */
+export declare function disposeContext(ctx: BuildContext): Promise<void>;
+//# sourceMappingURL=pipeline.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"pipeline.d.ts","sourceRoot":"","sources":["../../src/core/pipeline.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,cAAc,CAAC;AAE5C;;;;;;GAMG;AACH,MAAM,WAAW,YAAY;IAC5B,QAAQ,CAAC,OAAO,EAAE,OAAO,CAAC;IAC1B,QAAQ,CAAC,SAAS,EAAE,OAAO,CAAC;IAC5B,QAAQ,CAAC,OAAO,EAAE,OAAO,CAAC;IAC1B,QAAQ,CAAC,KAAK,EAAE,OAAO,CAAC;IACxB;;OAEG;IACH,QAAQ,CAAC,OAAO,EAAE;QACjB;;WAEG;QACH,WAAW,CAAC,EAAE,MAAM,CAAC;QACrB;;WAEG;QACH,WAAW,CAAC,EAAE,MAAM,CAAC;QACrB;;WAEG;QACH,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;QAC/B;;;;;;;;;;;;;;WAcG;QACH,gBAAgB,EAAE,GAAG,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;KACtC,CAAC;IACF;;OAEG;IACH,QAAQ,CAAC,SAAS,EAAE,KAAK,CAAC,MAAM,OAAO,CAAC,IAAI,CAAC,GAAG,IAAI,CAAC,CAAC;CACtD;AAED;;GAEG;AACH,MAAM,WAAW,WAAW;IAC3B,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,KAAK,CAAC,GAAG,EAAE,YAAY,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;CACxC;AAED;;GAEG;AACH,wBAAgB,aAAa,CAC5B,OAAO,EAAE,OAAO,EAChB,OAAO,GAAE;IAAE,SAAS,CAAC,EAAE,OAAO,CAAC;IAAC,OAAO,CAAC,EAAE,OAAO,CAAC;IAAC,KAAK,CAAC,EAAE,OAAO,CAAA;CAAO,GACvE,YAAY,CASd;AAED;;GAEG;AACH,wBAAsB,WAAW,CAAC,GAAG,EAAE,YAAY,EAAE,OAAO,EAAE,WAAW,EAAE,GAAG,OAAO,CAAC,IAAI,CAAC,CAK1F;AAED;;GAEG;AACH,wBAAsB,cAAc,CAAC,GAAG,EAAE,YAAY,GAAG,OAAO,CAAC,IAAI,CAAC,CAErE"}

package/dist/core/pipeline.js

@@ -0,0 +1,30 @@
+import { logger } from '../utils/logger.js';
+/**
+ * Creates a fresh build context for a project.
+ */
+export function createContext(project, options = {}) {
+    return {
+        project,
+        sourcemap: options.sourcemap ?? false,
+        analyze: options.analyze ?? false,
+        watch: options.watch ?? false,
+        outputs: { engine: {}, namespaceModules: new Map() },
+        disposers: [],
+    };
+}
+/**
+ * Runs plugins in order, logging each step.
+ */
+export async function runPipeline(ctx, plugins) {
+    for (const plugin of plugins) {
+        logger.step(plugin.name);
+        await plugin.apply(ctx);
+    }
+}
+/**
+ * Invokes every registered disposer, ignoring individual failures.
+ */
+export async function disposeContext(ctx) {
+    await Promise.allSettled(ctx.disposers.map(dispose => dispose()));
+}
+//# sourceMappingURL=pipeline.js.map

package/dist/core/pipeline.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"pipeline.js","sourceRoot":"","sources":["../../src/core/pipeline.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,MAAM,EAAE,MAAM,oBAAoB,CAAC;AA8D5C;;GAEG;AACH,MAAM,UAAU,aAAa,CAC5B,OAAgB,EAChB,UAAuE,EAAE;IAEzE,OAAO;QACN,OAAO;QACP,SAAS,EAAE,OAAO,CAAC,SAAS,IAAI,KAAK;QACrC,OAAO,EAAE,OAAO,CAAC,OAAO,IAAI,KAAK;QACjC,KAAK,EAAE,OAAO,CAAC,KAAK,IAAI,KAAK;QAC7B,OAAO,EAAE,EAAE,MAAM,EAAE,EAAE,EAAE,gBAAgB,EAAE,IAAI,GAAG,EAAE,EAAE;QACpD,SAAS,EAAE,EAAE;KACb,CAAC;AACH,CAAC;AAED;;GAEG;AACH,MAAM,CAAC,KAAK,UAAU,WAAW,CAAC,GAAiB,EAAE,OAAsB;IAC1E,KAAK,MAAM,MAAM,IAAI,OAAO,EAAE,CAAC;QAC9B,MAAM,CAAC,IAAI,CAAC,MAAM,CAAC,IAAI,CAAC,CAAC;QACzB,MAAM,MAAM,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC;IACzB,CAAC;AACF,CAAC;AAED;;GAEG;AACH,MAAM,CAAC,KAAK,UAAU,cAAc,CAAC,GAAiB;IACrD,MAAM,OAAO,CAAC,UAAU,CAAC,GAAG,CAAC,SAAS,CAAC,GAAG,CAAC,OAAO,CAAC,EAAE,CAAC,OAAO,EAAE,CAAC,CAAC,CAAC;AACnE,CAAC"}

package/dist/core/plugins/clean-output.d.ts

@@ -0,0 +1,3 @@
+import type { BuildPlugin } from '../pipeline.js';
+export declare function cleanOutput(): BuildPlugin;
+//# sourceMappingURL=clean-output.d.ts.map

package/dist/core/plugins/clean-output.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"clean-output.d.ts","sourceRoot":"","sources":["../../../src/core/plugins/clean-output.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,gBAAgB,CAAC;AAGlD,wBAAgB,WAAW,IAAI,WAAW,CAOzC"}

package/dist/core/plugins/clean-output.js

@@ -0,0 +1,11 @@
+import * as fs from 'node:fs/promises';
+// Removes artifacts from previous builds before writing the new output.
+export function cleanOutput() {
+    return {
+        name: 'clean output',
+        async apply(ctx) {
+            await fs.rm(ctx.project.outputDir, { recursive: true, force: true });
+        },
+    };
+}
+//# sourceMappingURL=clean-output.js.map

package/dist/core/plugins/clean-output.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"clean-output.js","sourceRoot":"","sources":["../../../src/core/plugins/clean-output.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,MAAM,kBAAkB,CAAC;AAGvC,wEAAwE;AACxE,MAAM,UAAU,WAAW;IAC1B,OAAO;QACN,IAAI,EAAE,cAAc;QACpB,KAAK,CAAC,KAAK,CAAC,GAAG;YACd,MAAM,EAAE,CAAC,EAAE,CAAC,GAAG,CAAC,OAAO,CAAC,SAAS,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,KAAK,EAAE,IAAI,EAAE,CAAC,CAAC;QACtE,CAAC;KACD,CAAC;AACH,CAAC"}

package/dist/core/plugins/compile-custom-namespaces.d.ts

@@ -0,0 +1,19 @@
+import type { BuildPlugin } from '../pipeline.js';
+/**
+ * Bundles each project-defined EXML namespace (`exml.namespaces` in
+ * `kurot.config.ts`, matching Egret's `xmlns:game="game.*"` convention)
+ * into its own chunk under `js/`.
+ *
+ * A namespace barrel (e.g. `src/ui/index.ts` re-exporting `HeroNarrowIR`,
+ * etc.) is compiled exactly once and wired into the page via the same import
+ * map used for `@kurot/*` engine chunks (see `compile-engine.ts`). Both the
+ * app bundle (`compile-source.ts`) and the compiled skins bundle
+ * (`compile-exml.ts`) mark the namespace specifier as external, so a class
+ * referenced from EXML and from game code resolves to the same module
+ * instance — never two copies with mismatched `instanceof` identity.
+ *
+ * In watch mode each barrel is rebuilt on change; the browser still needs a
+ * manual refresh to pick up the new chunk, matching the rest of `kurot dev`.
+ */
+export declare function compileCustomNamespaces(): BuildPlugin;
+//# sourceMappingURL=compile-custom-namespaces.d.ts.map

package/dist/core/plugins/compile-custom-namespaces.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"compile-custom-namespaces.d.ts","sourceRoot":"","sources":["../../../src/core/plugins/compile-custom-namespaces.ts"],"names":[],"mappings":"AAKA,OAAO,KAAK,EAAgB,WAAW,EAAE,MAAM,gBAAgB,CAAC;AAGhE;;;;;;;;;;;;;;;GAeG;AACH,wBAAgB,uBAAuB,IAAI,WAAW,CAmBrD"}

package/dist/core/plugins/compile-custom-namespaces.js

@@ -0,0 +1,104 @@
+import * as esbuild from 'esbuild';
+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';
+/**
+ * Bundles each project-defined EXML namespace (`exml.namespaces` in
+ * `kurot.config.ts`, matching Egret's `xmlns:game="game.*"` convention)
+ * into its own chunk under `js/`.
+ *
+ * A namespace barrel (e.g. `src/ui/index.ts` re-exporting `HeroNarrowIR`,
+ * etc.) is compiled exactly once and wired into the page via the same import
+ * map used for `@kurot/*` engine chunks (see `compile-engine.ts`). Both the
+ * app bundle (`compile-source.ts`) and the compiled skins bundle
+ * (`compile-exml.ts`) mark the namespace specifier as external, so a class
+ * referenced from EXML and from game code resolves to the same module
+ * instance — never two copies with mismatched `instanceof` identity.
+ *
+ * In watch mode each barrel is rebuilt on change; the browser still needs a
+ * manual refresh to pick up the new chunk, matching the rest of `kurot dev`.
+ */
+export function compileCustomNamespaces() {
+    return {
+        name: 'compile custom namespaces',
+        async apply(ctx) {
+            const { project } = ctx;
+            if (project.customNamespaces.length === 0)
+                return;
+            const jsDir = path.join(project.outputDir, 'js');
+            await ensureDir(jsDir);
+            for (const ns of project.customNamespaces) {
+                const { chunk, inputs } = await bundleNamespace(project, ns, jsDir, ctx);
+                ctx.outputs.engine[ns.specifier] = `js/${chunk}`;
+                for (const input of inputs)
+                    ctx.outputs.namespaceModules.set(normalizeModuleKey(input), ns.specifier);
+            }
+            logger.step(`bundled ${project.customNamespaces.length} custom namespace chunk(s) → js/`);
+        },
+    };
+}
+/**
+ * External specifiers a namespace chunk must not inline: engine packages and
+ * every other namespace.
+ */
+function externalFor(project, ns) {
+    return [...project.enginePackages, ...project.customNamespaces.filter(n => n !== ns).map(n => n.specifier)];
+}
+/**
+ * Bundles a single namespace barrel (its entry is already an absolute file).
+ */
+async function bundleNamespace(project, ns, jsDir, ctx) {
+    const base = chunkBaseName(ns.prefix);
+    const minify = project.mode === 'release';
+    const options = {
+        absWorkingDir: project.root,
+        entryPoints: { [base]: ns.entry },
+        outdir: jsDir,
+        entryNames: minify ? '[name].min_[hash]' : '[name]',
+        bundle: true,
+        format: 'esm',
+        platform: 'browser',
+        target: 'es2022',
+        minify,
+        metafile: true,
+        logLevel: 'warning',
+        external: externalFor(project, ns),
+        // Catches a barrel importing a *different* namespace's module by relative
+        // path (rather than its virtual specifier) — same rewrite as in compile-source.ts.
+        // Only namespaces bundled *before* this one have entries in `namespaceModules`
+        // yet, which is fine: namespaces don't import each other in the supported
+        // migration pattern (independent barrels), and self-references are already
+        // excluded by construction (a namespace's own files aren't in the map when
+        // bundling that same namespace — see the loop in `compileCustomNamespaces`).
+        plugins: [namespaceModuleExternalPlugin(ctx.outputs.namespaceModules)],
+    };
+    if (ctx.watch) {
+        const context = await esbuild.context(options);
+        const result = await context.rebuild();
+        await context.watch();
+        ctx.disposers.push(() => context.dispose());
+        return toBundleResult(project, result, base);
+    }
+    const result = await esbuild.build(options);
+    return toBundleResult(project, result, base);
+}
+/**
+ * Extracts the output chunk filename and every source file it inlined from
+ * an esbuild result's metafile.
+ */
+function toBundleResult(project, result, base) {
+    const outputs = result.metafile.outputs;
+    const outputPath = Object.keys(outputs).find(f => f.endsWith('.js'));
+    const inputs = outputPath
+        ? Object.keys(outputs[outputPath].inputs).map(input => path.resolve(project.root, input))
+        : [];
+    return { chunk: path.basename(outputPath ?? `${base}.js`), inputs };
+}
+/**
+ * `game` → `ns.game` (kept distinct from `@kurot/*` engine chunk names).
+ */
+function chunkBaseName(prefix) {
+    return `ns.${prefix}`;
+}
+//# sourceMappingURL=compile-custom-namespaces.js.map

package/dist/core/plugins/compile-custom-namespaces.js.map

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

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

@@ -0,0 +1,19 @@
+import type { BuildPlugin } from '../pipeline.js';
+/**
+ * Bundles each `@kurot/*` engine package into its own chunk under `js/`,
+ * externalizing the other engine packages so code is never duplicated.
+ *
+ * The resulting chunks are wired into the page via an import map (see
+ * `generate-html`), e.g. `@kurot/core` → `js/kurot.core.js`. This mirrors
+ * Egret's split `egret.min.js` / `eui.min.js` layout while staying ESM, so the
+ * browser-side dependency graph resolves bare specifiers to cached chunks.
+ *
+ * Engine chunks change rarely, so in release mode they carry a content hash for
+ * long-term caching.
+ */
+export declare function compileEngine(): BuildPlugin;
+/**
+ * `@kurot/core` → `kurot.core`.
+ */
+export declare function chunkBaseName(pkg: string): string;
+//# sourceMappingURL=compile-engine.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"compile-engine.d.ts","sourceRoot":"","sources":["../../../src/core/plugins/compile-engine.ts"],"names":[],"mappings":"AAKA,OAAO,KAAK,EAAgB,WAAW,EAAE,MAAM,gBAAgB,CAAC;AAGhE;;;;;;;;;;;GAWG;AACH,wBAAgB,aAAa,IAAI,WAAW,CA0B3C;AAoCD;;GAEG;AACH,wBAAgB,aAAa,CAAC,GAAG,EAAE,MAAM,GAAG,MAAM,CAEjD"}

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

@@ -0,0 +1,75 @@
+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';
+/**
+ * Bundles each `@kurot/*` engine package into its own chunk under `js/`,
+ * externalizing the other engine packages so code is never duplicated.
+ *
+ * The resulting chunks are wired into the page via an import map (see
+ * `generate-html`), e.g. `@kurot/core` → `js/kurot.core.js`. This mirrors
+ * Egret's split `egret.min.js` / `eui.min.js` layout while staying ESM, so the
+ * browser-side dependency graph resolves bare specifiers to cached chunks.
+ *
+ * Engine chunks change rarely, so in release mode they carry a content hash for
+ * long-term caching.
+ */
+export function compileEngine() {
+    return {
+        name: 'compile engine',
+        async apply(ctx) {
+            const { project } = ctx;
+            if (project.enginePackages.length === 0)
+                return;
+            const jsDir = path.join(project.outputDir, 'js');
+            await ensureDir(jsDir);
+            // Stub entry files (`export * from '<pkg>'`) keep package resolution
+            // and output naming under our control. They live inside the project's
+            // node_modules so esbuild resolves engine packages correctly.
+            const stubDir = await fs.mkdtemp(path.join(project.root, 'node_modules', '.kurot-engine-'));
+            try {
+                for (const pkg of project.enginePackages) {
+                    const chunk = await bundlePackage(project, pkg, stubDir, jsDir, project.mode === 'release');
+                    ctx.outputs.engine[pkg] = `js/${chunk}`;
+                }
+            }
+            finally {
+                await fs.rm(stubDir, { recursive: true, force: true });
+            }
+            logger.step(`bundled ${project.enginePackages.length} engine chunk(s) → js/`);
+        },
+    };
+}
+/**
+ * Bundles a single engine package, returning its output filename.
+ */
+async function bundlePackage(project, pkg, stubDir, jsDir, minify) {
+    const base = chunkBaseName(pkg);
+    const stub = path.join(stubDir, `${base}.ts`);
+    await fs.writeFile(stub, `export * from '${pkg}';\n`);
+    const result = await esbuild.build({
+        absWorkingDir: project.root,
+        entryPoints: [stub],
+        outdir: jsDir,
+        entryNames: minify ? '[name].min_[hash]' : '[name]',
+        bundle: true,
+        format: 'esm',
+        platform: 'browser',
+        target: 'es2022',
+        minify,
+        metafile: true,
+        logLevel: 'warning',
+        // Other engine packages stay external — resolved via the import map.
+        external: project.enginePackages.filter(p => p !== pkg),
+    });
+    const output = Object.keys(result.metafile.outputs).find(f => f.endsWith('.js'));
+    return path.basename(output ?? `${base}.js`);
+}
+/**
+ * `@kurot/core` → `kurot.core`.
+ */
+export function chunkBaseName(pkg) {
+    return pkg.replace(/^@/, '').replace(/\//g, '.');
+}
+//# sourceMappingURL=compile-engine.js.map

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

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

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

@@ -0,0 +1,14 @@
+import type { BuildPlugin } from '../pipeline.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 declare function compileExml(): BuildPlugin;
+//# sourceMappingURL=compile-exml.d.ts.map

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

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