@kurot/cli 1.0.2 → 1.1.0

package/CHANGELOG.md

@@ -5,17 +5,69 @@ All notable changes to `@kurot/cli` are documented in this file.
 The format is based on [Keep a Changelog](https://keepachangelog.com/en/1.1.0/),
 and this project follows [Semantic Versioning](https://semver.org/spec/v2.0.0.html).
 
-## Unreleased
+## 1.1.0 — 2026-08-13
 
 ### Added
 
 - Project-owned HTML templates through `html.template`, with explicit placeholders for the import map, entry script, and stage settings.
 - Editable `template/web/index.html` files in both the `game` and `empty` project templates.
+- A serializable diagnostic model shared by build plugins, with stable codes,
+  severity, optional source locations and repair suggestions. Diagnostics are
+  deduplicated and sorted deterministically for reliable Agent consumption.
+- Source ranges for EXML elements and attributes, including accurate 1-based
+  line and column reporting for unknown component tags across LF and CRLF files.
+- Similar-name suggestions for unknown built-in EXML tags, such as
+  `eui:Buton` → `eui:Button`.
+- `--strict` support for `kurot build` and `kurot dev`. Strict policy promotes
+  supported recoverable warnings to errors; release builds enable it by default.
+- `kurot build --diagnostics json`, which reserves stdout for one structured
+  build result containing success state, mode, duration, output directory and
+  diagnostics.
+- `kurot dev --diagnostics jsonl`, which reserves stdout for independent
+  `build-start`, `diagnostic`, `build-complete` and `server-ready` events.
+- Stable diagnostics for the following cases:
+  - `KUROT_EXML_UNKNOWN_TAG`
+  - `KUROT_EXML_COMPILE_FAILED`
+  - `KUROT_EXML_DECLARED_FILE_NOT_FOUND`
+  - `KUROT_THEME_FILE_NOT_FOUND`
+  - `KUROT_THEME_INVALID_JSON`
+  - `KUROT_THEME_SKIN_NOT_FOUND`
+  - `KUROT_WATCH_RELEASE_IGNORED`
 
 ### Changed
 
 - The default page centers the game canvas horizontally and vertically.
 - Development builds clear the previous output before compiling and place shared application chunks under `js/chunks/`.
+- Unknown EXML tags remain warnings in normal development builds, but strict
+  and release builds now stop after reporting them with their source location.
+- A missing theme, invalid theme JSON, an absent explicitly declared EXML file,
+  and a theme Skin path that was not compiled are now reported as distinct
+  conditions instead of being silently collapsed into an empty theme.
+- Invalid theme JSON and genuine Skin compilation failures stop every build.
+  Missing inputs that remain recoverable in normal mode emit explicit warnings.
+- Machine-readable modes suppress colored human logs, keeping stdout free of
+  ANSI escapes and unstructured text. Failed commands set a non-zero exit code.
+
+### Fixed
+
+- Development EXML failures no longer generate empty Skin factories returning
+  `{}` and therefore can no longer masquerade as successful compilation.
+- EXML watch rebuilds stage the complete Skin bundle before installation. A
+  failed rebuild keeps the last successful bundle and dev server alive; fixing
+  the EXML source allows the next rebuild to recover normally.
+- Theme `skins` mappings are checked against the actual compiled EXML set, while
+  avoiding duplicate diagnostics when the same path was already reported as a
+  missing explicit declaration.
+
+### Tests
+
+- Added parser and collector coverage for source locations, strict promotion,
+  sorting, deduplication and JSON serialization.
+- Added real CLI process coverage for human output, JSON build success/failure,
+  strict unknown-tag failures, malformed EXML, theme errors, JSONL dev startup,
+  and failed-watch recovery.
+- Verified that a structured unknown-tag suggestion can be applied and followed
+  by a successful strict build with zero diagnostics.
 
 ## 1.0.0 — 2026-08-06
 

package/README.md

@@ -2,7 +2,7 @@
 
 CLI tool for the Kurot game engine — a modern replacement for the legacy Egret CLI. Powered by esbuild for fast compilation, with a built-in EXML skin parser and code generator.
 
-> Migrating from Egret? See [migration.md](docs/migration.md)
+> Migrating from Egret? See [egret-migration.md](../../docs/egret-migration.md)
 >
 > Release history: [CHANGELOG.md](CHANGELOG.md)
 
@@ -73,12 +73,22 @@ Compile the project into ESM application, engine, namespace, and theme bundles.
 kurot build [options]
 ```
 
-| Option          | Description                                            | Default |
-| --------------- | ------------------------------------------------------ | ------- |
-| `-r, --release` | Minified, content-hashed release build (→ bin-release) | `false` |
-| `--sourcemap`   | Generate sourcemaps                                    | `false` |
-| `--watch`       | Rebuild source on file changes                         | `false` |
-| `--analyze`     | Print bundle size analysis (esbuild metafile)          | `false` |
+| Option                   | Description                                            | Default |
+| ------------------------ | ------------------------------------------------------ | ------- |
+| `-r, --release`          | Minified, content-hashed release build (→ bin-release) | `false` |
+| `--sourcemap`            | Generate sourcemaps                                    | `false` |
+| `--watch`                | Rebuild source on file changes                         | `false` |
+| `--analyze`              | Print bundle size analysis (esbuild metafile)          | `false` |
+| `--strict`               | Promote supported warnings to build errors             | `false` |
+| `--diagnostics <format>` | Diagnostic output: `human` or `json`                   | `human` |
+
+`--diagnostics json` writes exactly one JSON result to stdout. It includes
+`success`, `mode`, `durationMs`, the output directory on success, and all
+structured diagnostics. Release builds use strict diagnostic policy by default.
+
+```bash
+kurot build --strict --diagnostics json
+```
 
 **Output (Egret-aligned shape, ESM under the hood):**
 
@@ -102,10 +112,23 @@ Start a development server with auto-recompilation on file changes (manual brows
 kurot dev [options]
 ```
 
-| Option              | Description         | Default |
-| ------------------- | ------------------- | ------- |
-| `-p, --port <port>` | Port to listen      | `3000`  |
-| `--sourcemap`       | Generate sourcemaps | `false` |
+| Option                   | Description                                | Default |
+| ------------------------ | ------------------------------------------ | ------- |
+| `-p, --port <port>`      | Port to listen                             | `3000`  |
+| `--sourcemap`            | Generate sourcemaps                        | `false` |
+| `--strict`               | Promote supported warnings to build errors | `false` |
+| `--diagnostics <format>` | Diagnostic output: `human` or `jsonl`      | `human` |
+
+Unlike build's single JSON result, `kurot dev --diagnostics jsonl` writes one
+JSON event per line so an agent can follow initial builds, diagnostics,
+rebuilds, and server readiness incrementally.
+
+```bash
+kurot dev --strict --diagnostics jsonl
+```
+
+Machine-readable modes reserve stdout for their JSON protocol and never include
+ANSI color sequences. Failures set a non-zero process exit code.
 
 ### `kurot clean`
 
@@ -197,6 +220,13 @@ The CLI includes a complete EXML skin parsing and code generation pipeline (XML
 - **Skin Properties** — preserves root properties such as `minWidth`, `minHeight`, and state-specific values
 - **Percent Layout** — auto-detects `width="100%"` and converts to `percentWidth`
 - **Data Binding** — parses `{expression}` binding syntax and generates `Binding.bindProperty` calls
+- **Structured Diagnostics** — stable codes, source locations, suggestions, and strict warning promotion
+
+Unknown tags remain warnings in normal development builds and are omitted from
+the generated visual tree. Under `--strict` (and in release builds), those
+warnings become errors. Syntax errors, invalid theme JSON, and other genuine
+Skin compilation failures always stop the build; the compiler never substitutes
+an empty Skin factory.
 
 The standard declarations `xmlns:eui="http://ns.egret.com/eui"` and
 `xmlns:egret="http://ns.egret.com/egret"` are namespace identifiers. The CLI

package/dist/commands/build.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"build.d.ts","sourceRoot":"","sources":["../../src/commands/build.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AA0BpC,eAAO,MAAM,YAAY,SAoCtB,CAAC"}
+{"version":3,"file":"build.d.ts","sourceRoot":"","sources":["../../src/commands/build.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AAoCpC,eAAO,MAAM,YAAY,SAyEtB,CAAC"}

package/dist/commands/build.js

@@ -3,39 +3,78 @@ import { loadProject } from '../core/project.js';
 import { createContext, runPipeline, disposeContext } from '../core/pipeline.js';
 import { defaultPlugins } from '../core/plugins/index.js';
 import { BuildError } from '../core/errors.js';
-import { logger } from '../utils/logger.js';
+import { DIAGNOSTIC_CODES, parseBuildDiagnosticsFormat, writeMachineOutput, } from '../core/diagnostics/index.js';
+import { logger, setLoggerEnabled } from '../utils/logger.js';
 export const buildCommand = new Command('build')
     .description('Build the project')
     .option('-r, --release', 'Minified, content-hashed release build (→ bin-release)', false)
     .option('--sourcemap', 'Generate sourcemaps', false)
     .option('--watch', 'Rebuild source on file changes', false)
     .option('--analyze', 'Print esbuild bundle size analysis', false)
+    .option('--strict', 'Treat supported warnings as build errors', false)
+    .option('--diagnostics <format>', 'Diagnostic output: human or json', 'human')
     .action(async (options) => {
     const start = Date.now();
+    const format = parseBuildDiagnosticsFormat(options.diagnostics);
+    const machine = format === 'json';
+    setLoggerEnabled(!machine);
+    let ctx;
+    let mode = options.release ? 'release' : 'development';
     try {
-        const mode = options.release ? 'release' : 'development';
         if (options.watch && options.release) {
             logger.warn('--watch is a development workflow; ignoring --release.');
+            mode = 'development';
         }
-        const project = await loadProject(options.watch ? 'development' : mode);
+        const project = await loadProject(mode);
         logger.info(`Building (${project.mode})...`);
-        const ctx = createContext(project, {
+        const buildCtx = createContext(project, {
             sourcemap: options.sourcemap,
             analyze: options.analyze,
             watch: options.watch,
+            strict: options.strict || project.mode === 'release',
         });
-        await runPipeline(ctx, defaultPlugins());
+        ctx = buildCtx;
+        if (options.watch && options.release) {
+            buildCtx.diagnostics.report({
+                code: DIAGNOSTIC_CODES.WATCH_RELEASE_IGNORED,
+                severity: 'warning',
+                message: 'Release mode was ignored because --watch uses development mode.',
+            });
+        }
+        await runPipeline(buildCtx, defaultPlugins());
         if (options.watch) {
             logger.success('Watching for changes. Press Ctrl+C to stop.');
-            await waitForShutdown(() => disposeContext(ctx));
-            return;
+            await waitForShutdown(() => disposeContext(buildCtx));
+        }
+        const durationMs = Date.now() - start;
+        logger.success(`Build completed in ${(durationMs / 1000).toFixed(2)}s → ${relativeOut(project.outputDir)}/`);
+        if (machine) {
+            writeMachineOutput({
+                success: true,
+                command: 'build',
+                mode: project.mode,
+                durationMs,
+                outputDir: project.outputDir,
+                diagnostics: buildCtx.diagnostics.all(),
+            });
         }
-        const elapsed = ((Date.now() - start) / 1000).toFixed(2);
-        logger.success(`Build completed in ${elapsed}s → ${relativeOut(project.outputDir)}/`);
     }
     catch (err) {
         const message = err instanceof Error ? err.message : String(err);
-        throw new BuildError(`Build failed: ${message}`, err instanceof Error ? err : undefined);
+        if (!machine) {
+            throw new BuildError(`Build failed: ${message}`, err instanceof Error ? err : undefined);
+        }
+        writeMachineOutput({
+            success: false,
+            command: 'build',
+            mode,
+            durationMs: Date.now() - start,
+            diagnostics: ctx?.diagnostics.all() ?? [],
+        });
+        process.exitCode = 1;
+    }
+    finally {
+        setLoggerEnabled(true);
     }
 });
 /**

package/dist/commands/build.js.map

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

package/dist/commands/dev.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"dev.d.ts","sourceRoot":"","sources":["../../src/commands/dev.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AAKpC,eAAO,MAAM,UAAU,SAmBpB,CAAC"}
+{"version":3,"file":"dev.d.ts","sourceRoot":"","sources":["../../src/commands/dev.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AAcpC,eAAO,MAAM,UAAU,SA8BpB,CAAC"}

package/dist/commands/dev.js

@@ -1,25 +1,39 @@
 import { Command } from 'commander';
 import { loadProject } from '../core/project.js';
 import { startDevServer } from '../core/dev-server.js';
-import { logger } from '../utils/logger.js';
+import { ConfigError } from '../core/errors.js';
+import { parseDevDiagnosticsFormat, writeMachineOutput } from '../core/diagnostics/index.js';
+import { logger, setLoggerEnabled } from '../utils/logger.js';
 export const devCommand = new Command('dev')
     .description('Start a development server with rebuild on change')
     .option('-p, --port <port>', 'Port to listen on', '3000')
     .option('--sourcemap', 'Generate sourcemaps', false)
+    .option('--strict', 'Treat supported warnings as build errors', false)
+    .option('--diagnostics <format>', 'Diagnostic output: human or jsonl', 'human')
     .action(async (options) => {
+    const format = parseDevDiagnosticsFormat(options.diagnostics);
+    const machine = format === 'jsonl';
+    setLoggerEnabled(!machine);
     const port = Number.parseInt(options.port, 10);
     if (!Number.isInteger(port) || port < 1 || port > 65535) {
-        logger.error(`Invalid port: ${options.port}`);
-        process.exit(1);
+        setLoggerEnabled(true);
+        throw new ConfigError(`Invalid port: ${options.port}`);
     }
     try {
         const project = await loadProject('development');
         logger.info(`Starting dev server on port ${port}...`);
-        await startDevServer(project, { port, sourcemap: options.sourcemap });
+        await startDevServer(project, {
+            port,
+            sourcemap: options.sourcemap,
+            strict: options.strict,
+            onEvent: machine ? writeMachineOutput : undefined,
+        });
     }
     catch (err) {
         logger.error(`Dev server failed: ${err instanceof Error ? err.message : String(err)}`);
-        process.exit(1);
+        process.exitCode = 1;
+        if (machine)
+            setLoggerEnabled(true);
     }
 });
 //# sourceMappingURL=dev.js.map

package/dist/commands/dev.js.map

@@ -1 +1 @@
-{"version":3,"file":"dev.js","sourceRoot":"","sources":["../../src/commands/dev.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AACpC,OAAO,EAAE,WAAW,EAAE,MAAM,oBAAoB,CAAC;AACjD,OAAO,EAAE,cAAc,EAAE,MAAM,uBAAuB,CAAC;AACvD,OAAO,EAAE,MAAM,EAAE,MAAM,oBAAoB,CAAC;AAE5C,MAAM,CAAC,MAAM,UAAU,GAAG,IAAI,OAAO,CAAC,KAAK,CAAC;KAC1C,WAAW,CAAC,mDAAmD,CAAC;KAChE,MAAM,CAAC,mBAAmB,EAAE,mBAAmB,EAAE,MAAM,CAAC;KACxD,MAAM,CAAC,aAAa,EAAE,qBAAqB,EAAE,KAAK,CAAC;KACnD,MAAM,CAAC,KAAK,EAAE,OAA6C,EAAE,EAAE;IAC/D,MAAM,IAAI,GAAG,MAAM,CAAC,QAAQ,CAAC,OAAO,CAAC,IAAI,EAAE,EAAE,CAAC,CAAC;IAC/C,IAAI,CAAC,MAAM,CAAC,SAAS,CAAC,IAAI,CAAC,IAAI,IAAI,GAAG,CAAC,IAAI,IAAI,GAAG,KAAK,EAAE,CAAC;QACzD,MAAM,CAAC,KAAK,CAAC,iBAAiB,OAAO,CAAC,IAAI,EAAE,CAAC,CAAC;QAC9C,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;IACjB,CAAC;IAED,IAAI,CAAC;QACJ,MAAM,OAAO,GAAG,MAAM,WAAW,CAAC,aAAa,CAAC,CAAC;QACjD,MAAM,CAAC,IAAI,CAAC,+BAA+B,IAAI,KAAK,CAAC,CAAC;QACtD,MAAM,cAAc,CAAC,OAAO,EAAE,EAAE,IAAI,EAAE,SAAS,EAAE,OAAO,CAAC,SAAS,EAAE,CAAC,CAAC;IACvE,CAAC;IAAC,OAAO,GAAG,EAAE,CAAC;QACd,MAAM,CAAC,KAAK,CAAC,sBAAsB,GAAG,YAAY,KAAK,CAAC,CAAC,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,GAAG,CAAC,EAAE,CAAC,CAAC;QACvF,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;IACjB,CAAC;AACF,CAAC,CAAC,CAAC"}
+{"version":3,"file":"dev.js","sourceRoot":"","sources":["../../src/commands/dev.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AACpC,OAAO,EAAE,WAAW,EAAE,MAAM,oBAAoB,CAAC;AACjD,OAAO,EAAE,cAAc,EAAE,MAAM,uBAAuB,CAAC;AACvD,OAAO,EAAE,WAAW,EAAE,MAAM,mBAAmB,CAAC;AAChD,OAAO,EAAE,yBAAyB,EAAE,kBAAkB,EAAE,MAAM,8BAA8B,CAAC;AAC7F,OAAO,EAAE,MAAM,EAAE,gBAAgB,EAAE,MAAM,oBAAoB,CAAC;AAS9D,MAAM,CAAC,MAAM,UAAU,GAAG,IAAI,OAAO,CAAC,KAAK,CAAC;KAC1C,WAAW,CAAC,mDAAmD,CAAC;KAChE,MAAM,CAAC,mBAAmB,EAAE,mBAAmB,EAAE,MAAM,CAAC;KACxD,MAAM,CAAC,aAAa,EAAE,qBAAqB,EAAE,KAAK,CAAC;KACnD,MAAM,CAAC,UAAU,EAAE,0CAA0C,EAAE,KAAK,CAAC;KACrE,MAAM,CAAC,wBAAwB,EAAE,mCAAmC,EAAE,OAAO,CAAC;KAC9E,MAAM,CAAC,KAAK,EAAE,OAAmB,EAAE,EAAE;IACrC,MAAM,MAAM,GAAG,yBAAyB,CAAC,OAAO,CAAC,WAAW,CAAC,CAAC;IAC9D,MAAM,OAAO,GAAG,MAAM,KAAK,OAAO,CAAC;IACnC,gBAAgB,CAAC,CAAC,OAAO,CAAC,CAAC;IAC3B,MAAM,IAAI,GAAG,MAAM,CAAC,QAAQ,CAAC,OAAO,CAAC,IAAI,EAAE,EAAE,CAAC,CAAC;IAC/C,IAAI,CAAC,MAAM,CAAC,SAAS,CAAC,IAAI,CAAC,IAAI,IAAI,GAAG,CAAC,IAAI,IAAI,GAAG,KAAK,EAAE,CAAC;QACzD,gBAAgB,CAAC,IAAI,CAAC,CAAC;QACvB,MAAM,IAAI,WAAW,CAAC,iBAAiB,OAAO,CAAC,IAAI,EAAE,CAAC,CAAC;IACxD,CAAC;IAED,IAAI,CAAC;QACJ,MAAM,OAAO,GAAG,MAAM,WAAW,CAAC,aAAa,CAAC,CAAC;QACjD,MAAM,CAAC,IAAI,CAAC,+BAA+B,IAAI,KAAK,CAAC,CAAC;QACtD,MAAM,cAAc,CAAC,OAAO,EAAE;YAC7B,IAAI;YACJ,SAAS,EAAE,OAAO,CAAC,SAAS;YAC5B,MAAM,EAAE,OAAO,CAAC,MAAM;YACtB,OAAO,EAAE,OAAO,CAAC,CAAC,CAAC,kBAAkB,CAAC,CAAC,CAAC,SAAS;SACjD,CAAC,CAAC;IACJ,CAAC;IAAC,OAAO,GAAG,EAAE,CAAC;QACd,MAAM,CAAC,KAAK,CAAC,sBAAsB,GAAG,YAAY,KAAK,CAAC,CAAC,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,GAAG,CAAC,EAAE,CAAC,CAAC;QACvF,OAAO,CAAC,QAAQ,GAAG,CAAC,CAAC;QACrB,IAAI,OAAO;YAAE,gBAAgB,CAAC,IAAI,CAAC,CAAC;IACrC,CAAC;AACF,CAAC,CAAC,CAAC"}

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

@@ -1,4 +1,5 @@
 import type { Project } from './project.js';
+import type { DevEvent } from './diagnostics/index.js';
 export interface DevServerOptions {
     /**
      * Port for the dev server to listen on.
@@ -8,6 +9,14 @@ export interface DevServerOptions {
      * Whether to generate sourcemaps for the app bundle.
      */
     sourcemap: boolean;
+    /**
+     * Whether supported warnings stop builds.
+     */
+    strict: boolean;
+    /**
+     * Receives machine-readable lifecycle events.
+     */
+    onEvent?: (event: DevEvent) => void;
 }
 /**
  * Starts a development server.

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

@@ -1 +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"}
+{"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;AAW5C,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,wBAAwB,CAAC;AAEvD,MAAM,WAAW,gBAAgB;IAChC;;OAEG;IACH,IAAI,EAAE,MAAM,CAAC;IACb;;OAEG;IACH,SAAS,EAAE,OAAO,CAAC;IACnB;;OAEG;IACH,MAAM,EAAE,OAAO,CAAC;IAChB;;OAEG;IACH,OAAO,CAAC,EAAE,CAAC,KAAK,EAAE,QAAQ,KAAK,IAAI,CAAC;CACpC;AAED;;;;;;;GAOG;AACH,wBAAsB,cAAc,CAAC,OAAO,EAAE,OAAO,EAAE,OAAO,EAAE,gBAAgB,GAAG,OAAO,CAAC,IAAI,CAAC,CA8B/F"}

package/dist/core/dev-server.js

@@ -14,17 +14,28 @@ import { logger } from '../utils/logger.js';
  * 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);
+    const ctx = createContext(project, { sourcemap: options.sourcemap, watch: true, strict: options.strict });
+    const startedAt = Date.now();
+    options.onEvent?.({ type: 'build-start', reason: 'initial' });
+    try {
+        await runPipeline(ctx, [
+            compileExml(),
+            compileEngine(),
+            compileCustomNamespaces(),
+            compileSource(),
+            generateHtml(),
+            copyAssets(),
+        ]);
+        emitDiagnostics(ctx, options);
+        options.onEvent?.({ type: 'build-complete', success: true, durationMs: Date.now() - startedAt });
+    }
+    catch (error) {
+        emitDiagnostics(ctx, options);
+        options.onEvent?.({ type: 'build-complete', success: false, durationMs: Date.now() - startedAt });
+        throw error;
+    }
+    watchResources(project, ctx, options);
+    const server = startHttpServer(project, options);
     process.on('SIGINT', async () => {
         logger.info('Stopping dev server...');
         await disposeContext(ctx);
@@ -35,7 +46,7 @@ export async function startDevServer(project, options) {
 /**
  * Recompiles EXML and re-copies assets when a `.exml` file changes.
  */
-function watchResources(project, ctx) {
+function watchResources(project, ctx, options) {
     if (!project.config.exml)
         return;
     let debounce;
@@ -46,13 +57,19 @@ function watchResources(project, ctx) {
                 return;
             clearTimeout(debounce);
             debounce = setTimeout(async () => {
+                const startedAt = Date.now();
+                options.onEvent?.({ type: 'build-start', reason: 'exml-change' });
                 logger.info(`EXML changed: ${path.basename(filename)}, recompiling...`);
                 try {
                     await compileExml().apply(ctx);
                     await copyAssets().apply(ctx);
+                    emitDiagnostics(ctx, options);
+                    options.onEvent?.({ type: 'build-complete', success: true, durationMs: Date.now() - startedAt });
                 }
                 catch (err) {
-                    logger.warn(`EXML recompile failed: ${err instanceof Error ? err.message : err}`);
+                    emitDiagnostics(ctx, options);
+                    options.onEvent?.({ type: 'build-complete', success: false, durationMs: Date.now() - startedAt });
+                    logger.error(`EXML recompile failed: ${err instanceof Error ? err.message : err}`);
                 }
             }, 100);
         });
@@ -66,7 +83,7 @@ function watchResources(project, ctx) {
 /**
  * Serves static files from the project output directory.
  */
-function startHttpServer(project, port) {
+function startHttpServer(project, options) {
     const server = http.createServer(async (req, res) => {
         const url = (req.url ?? '/').split('?')[0];
         const filePath = path.join(project.outputDir, url === '/' ? 'index.html' : url);
@@ -80,12 +97,19 @@ function startHttpServer(project, port) {
             res.end('Not found');
         }
     });
-    server.listen(port, () => {
-        logger.success(`Dev server running at http://localhost:${port}`);
+    server.listen(options.port, () => {
+        const url = `http://localhost:${options.port}`;
+        logger.success(`Dev server running at ${url}`);
         logger.info('Watching for changes (refresh the browser to reload)...');
+        options.onEvent?.({ type: 'server-ready', url });
     });
     return server;
 }
+function emitDiagnostics(ctx, options) {
+    for (const diagnostic of ctx.diagnostics.all()) {
+        options.onEvent?.({ type: 'diagnostic', diagnostic });
+    }
+}
 const MIME_TYPES = {
     '.html': 'text/html; charset=utf-8',
     '.js': 'application/javascript',

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

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

package/dist/core/diagnostics/codes.d.ts

@@ -0,0 +1,21 @@
+/**
+ * Stable diagnostic codes emitted by the CLI.
+ */
+export declare const DIAGNOSTIC_CODES: {
+    readonly EXML_UNKNOWN_TAG: "KUROT_EXML_UNKNOWN_TAG";
+    readonly EXML_COMPILE_FAILED: "KUROT_EXML_COMPILE_FAILED";
+    readonly EXML_DECLARED_FILE_NOT_FOUND: "KUROT_EXML_DECLARED_FILE_NOT_FOUND";
+    readonly THEME_FILE_NOT_FOUND: "KUROT_THEME_FILE_NOT_FOUND";
+    readonly THEME_INVALID_JSON: "KUROT_THEME_INVALID_JSON";
+    readonly THEME_SKIN_NOT_FOUND: "KUROT_THEME_SKIN_NOT_FOUND";
+    readonly WATCH_RELEASE_IGNORED: "KUROT_WATCH_RELEASE_IGNORED";
+};
+/**
+ * Union of diagnostic codes currently defined by the CLI.
+ */
+export type DiagnosticCode = (typeof DIAGNOSTIC_CODES)[keyof typeof DIAGNOSTIC_CODES];
+/**
+ * Returns whether strict mode promotes a diagnostic code to an error.
+ */
+export declare function isStrictDiagnosticCode(code: string): boolean;
+//# sourceMappingURL=codes.d.ts.map

package/dist/core/diagnostics/codes.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"codes.d.ts","sourceRoot":"","sources":["../../../src/core/diagnostics/codes.ts"],"names":[],"mappings":"AAAA;;GAEG;AACH,eAAO,MAAM,gBAAgB;;;;;;;;CAQnB,CAAC;AAEX;;GAEG;AACH,MAAM,MAAM,cAAc,GAAG,CAAC,OAAO,gBAAgB,CAAC,CAAC,MAAM,OAAO,gBAAgB,CAAC,CAAC;AAStF;;GAEG;AACH,wBAAgB,sBAAsB,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAE5D"}

package/dist/core/diagnostics/codes.js

@@ -0,0 +1,25 @@
+/**
+ * Stable diagnostic codes emitted by the CLI.
+ */
+export const DIAGNOSTIC_CODES = {
+    EXML_UNKNOWN_TAG: 'KUROT_EXML_UNKNOWN_TAG',
+    EXML_COMPILE_FAILED: 'KUROT_EXML_COMPILE_FAILED',
+    EXML_DECLARED_FILE_NOT_FOUND: 'KUROT_EXML_DECLARED_FILE_NOT_FOUND',
+    THEME_FILE_NOT_FOUND: 'KUROT_THEME_FILE_NOT_FOUND',
+    THEME_INVALID_JSON: 'KUROT_THEME_INVALID_JSON',
+    THEME_SKIN_NOT_FOUND: 'KUROT_THEME_SKIN_NOT_FOUND',
+    WATCH_RELEASE_IGNORED: 'KUROT_WATCH_RELEASE_IGNORED',
+};
+const STRICT_DIAGNOSTIC_CODES = new Set([
+    DIAGNOSTIC_CODES.EXML_UNKNOWN_TAG,
+    DIAGNOSTIC_CODES.EXML_DECLARED_FILE_NOT_FOUND,
+    DIAGNOSTIC_CODES.THEME_FILE_NOT_FOUND,
+    DIAGNOSTIC_CODES.THEME_SKIN_NOT_FOUND,
+]);
+/**
+ * Returns whether strict mode promotes a diagnostic code to an error.
+ */
+export function isStrictDiagnosticCode(code) {
+    return STRICT_DIAGNOSTIC_CODES.has(code);
+}
+//# sourceMappingURL=codes.js.map

package/dist/core/diagnostics/codes.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"codes.js","sourceRoot":"","sources":["../../../src/core/diagnostics/codes.ts"],"names":[],"mappings":"AAAA;;GAEG;AACH,MAAM,CAAC,MAAM,gBAAgB,GAAG;IAC/B,gBAAgB,EAAE,wBAAwB;IAC1C,mBAAmB,EAAE,2BAA2B;IAChD,4BAA4B,EAAE,oCAAoC;IAClE,oBAAoB,EAAE,4BAA4B;IAClD,kBAAkB,EAAE,0BAA0B;IAC9C,oBAAoB,EAAE,4BAA4B;IAClD,qBAAqB,EAAE,6BAA6B;CAC3C,CAAC;AAOX,MAAM,uBAAuB,GAAgC,IAAI,GAAG,CAAC;IACpE,gBAAgB,CAAC,gBAAgB;IACjC,gBAAgB,CAAC,4BAA4B;IAC7C,gBAAgB,CAAC,oBAAoB;IACrC,gBAAgB,CAAC,oBAAoB;CACrC,CAAC,CAAC;AAEH;;GAEG;AACH,MAAM,UAAU,sBAAsB,CAAC,IAAY;IAClD,OAAO,uBAAuB,CAAC,GAAG,CAAC,IAAsB,CAAC,CAAC;AAC5D,CAAC"}

package/dist/core/diagnostics/collector.d.ts

@@ -0,0 +1,28 @@
+import type { Diagnostic, DiagnosticPolicy } from './types.js';
+/**
+ * Collects, normalizes, deduplicates, and orders build diagnostics.
+ */
+export declare class DiagnosticCollector {
+    private readonly _policy;
+    private readonly _diagnostics;
+    constructor(_policy: DiagnosticPolicy);
+    /**
+     * Adds a diagnostic after applying the active policy.
+     */
+    report(diagnostic: Diagnostic): void;
+    /**
+     * Returns all diagnostics in stable source order.
+     */
+    all(): readonly Diagnostic[];
+    /**
+     * Returns whether any collected diagnostic is an error.
+     */
+    hasErrors(): boolean;
+    /**
+     * Removes diagnostics whose codes belong to a refreshed build scope.
+     */
+    removeByCodes(codes: readonly string[]): void;
+    private _normalize;
+    private _key;
+}
+//# sourceMappingURL=collector.d.ts.map

package/dist/core/diagnostics/collector.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"collector.d.ts","sourceRoot":"","sources":["../../../src/core/diagnostics/collector.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,UAAU,EAAE,gBAAgB,EAAE,MAAM,YAAY,CAAC;AAE/D;;GAEG;AACH,qBAAa,mBAAmB;IAOZ,OAAO,CAAC,QAAQ,CAAC,OAAO;IAJ3C,OAAO,CAAC,QAAQ,CAAC,YAAY,CAAiC;gBAI1B,OAAO,EAAE,gBAAgB;IAI7D;;OAEG;IACI,MAAM,CAAC,UAAU,EAAE,UAAU,GAAG,IAAI;IAO3C;;OAEG;IACI,GAAG,IAAI,SAAS,UAAU,EAAE;IAInC;;OAEG;IACI,SAAS,IAAI,OAAO;IAI3B;;OAEG;IACI,aAAa,CAAC,KAAK,EAAE,SAAS,MAAM,EAAE,GAAG,IAAI;IAWpD,OAAO,CAAC,UAAU;IAOlB,OAAO,CAAC,IAAI;CAWZ"}

package/dist/core/diagnostics/collector.js

@@ -0,0 +1,78 @@
+import { isStrictDiagnosticCode } from './codes.js';
+/**
+ * Collects, normalizes, deduplicates, and orders build diagnostics.
+ */
+export class DiagnosticCollector {
+    _policy;
+    // ── Instance fields ───────────────────────────────────────────────
+    _diagnostics = new Map();
+    // ── Constructor ───────────────────────────────────────────────────
+    constructor(_policy) {
+        this._policy = _policy;
+    }
+    // ── Public methods ────────────────────────────────────────────────
+    /**
+     * Adds a diagnostic after applying the active policy.
+     */
+    report(diagnostic) {
+        const normalized = this._normalize(diagnostic);
+        const key = this._key(normalized);
+        if (this._diagnostics.has(key))
+            return;
+        this._diagnostics.set(key, normalized);
+    }
+    /**
+     * Returns all diagnostics in stable source order.
+     */
+    all() {
+        return [...this._diagnostics.values()].sort(compareDiagnostics);
+    }
+    /**
+     * Returns whether any collected diagnostic is an error.
+     */
+    hasErrors() {
+        return [...this._diagnostics.values()].some(diagnostic => diagnostic.severity === 'error');
+    }
+    /**
+     * Removes diagnostics whose codes belong to a refreshed build scope.
+     */
+    removeByCodes(codes) {
+        const codeSet = new Set(codes);
+        for (const [key, diagnostic] of this._diagnostics) {
+            if (codeSet.has(diagnostic.code)) {
+                this._diagnostics.delete(key);
+            }
+        }
+    }
+    // ── Private methods ───────────────────────────────────────────────
+    _normalize(diagnostic) {
+        if (!this._policy.strict || diagnostic.severity === 'error' || !isStrictDiagnosticCode(diagnostic.code)) {
+            return diagnostic;
+        }
+        return { ...diagnostic, severity: 'error' };
+    }
+    _key(diagnostic) {
+        const location = diagnostic.location;
+        return [
+            diagnostic.code,
+            location?.file ?? '',
+            location?.line ?? '',
+            location?.column ?? '',
+            location?.offset ?? '',
+            diagnostic.message,
+        ].join('\u0000');
+    }
+}
+function compareDiagnostics(a, b) {
+    const fileOrder = (a.location?.file ?? '').localeCompare(b.location?.file ?? '');
+    if (fileOrder !== 0)
+        return fileOrder;
+    const lineOrder = (a.location?.line ?? 0) - (b.location?.line ?? 0);
+    if (lineOrder !== 0)
+        return lineOrder;
+    const columnOrder = (a.location?.column ?? 0) - (b.location?.column ?? 0);
+    if (columnOrder !== 0)
+        return columnOrder;
+    return a.code.localeCompare(b.code);
+}
+//# sourceMappingURL=collector.js.map