@kurot/cli 3.6.1 → 3.7.0

package/CHANGELOG.md

@@ -7,9 +7,77 @@ and CLI command/configuration APIs follow [Semantic Versioning](https://semver.o
 The early KUI XML contract follows the pre-1.0 `ui-document` kernel; authored
 format changes are documented explicitly in each release.
 
+## 3.7.0 — 2026-10-27
+
+Prepared for publication; not yet published.
+
+### Added
+
+- Optional `output.versionedAssets` release packaging: place runtime files in
+  `assets/<content-hash>/` and emit an HTML base URL, covering same-name resource
+  updates, generated themes, atlas/font pages and page-shell assets. Identical
+  output reuses the version; development and existing configurations keep their
+  paths. Root manifest and reported script paths use the version prefix.
+- Validate the option and reject conflicting HTML base elements before moving
+  output. Add regressions for same-name replacements, deterministic versions,
+  generated KUI, shell/script changes and disabled/development builds.
+
+### Changed
+
+- The game starter resolves its Theme URL against document.baseURI so compiled
+  skin imports follow the selected release directory with existing UI runtimes.
+
+### Fixed
+
+- Parse release HTML with parse5 before inserting the versioned base URL.
+  Preserve quoted attribute values containing greater-than signs and ignore
+  base-like text in scripts/styles. Keep the authored template intact, require
+  an explicit head and reject actual conflicting base elements.
+
+### Compatibility and adoption
+
+- This minor release adds an opt-in configuration field. The default paths,
+  development/watch behavior, commands and KUI/resource formats retain their
+  existing contracts. ui-document remains ^0.13.0; Core/UI and other SDKs need
+  no new release or higher peer minima.
+- Add parse5 ^7.3.0 as a CLI dependency for HTML parsing. Its entities dependency
+  supports the CLI's Node.js >= 20 baseline; it is not shipped in game bundles.
+- Projects enabling versioning need CLI >= 3.7.0 within 3.x, an absolute Theme
+  config URL based on document.baseURI and the deployment rules in
+  docs/release-assets.md. Existing projects may keep versioning disabled.
+- demo/game use ^3.3.1, and the selected Tentax/MilfMaster templates use ^3.6.0;
+  these ranges accept 3.7.0 as optional installation/lock adoption. Star Catcher
+  pins 3.3.1, and Editor/Studio pin 3.6.1; adopting this feature requires explicit
+  declaration updates. Their installations/locks are unchanged by preparation.
+- Bundled template latest placeholders remain; create records the running CLI's
+  version range. New scaffolds from 3.7.0 receive the Theme URL correction.
+  Other SDK peers/development locks and unrelated applications are unaffected.
+
+### Adoption
+
+- MilfMaster enables versioning using a committed pnpm patch to its installed
+  registry CLI 3.6.0. The patch carries the release feature without upgrading
+  runtime SDKs or depending on another checkout. No npm publication is claimed.
+
+### Verification — 2026-10-27
+
+- Clean CLI build and all 25 test files / 132 tests pass with maxWorkers=1,
+  including quoted HTML attributes, script/style text, release process
+  configuration and generated KUI output. git diff --check passes. An earlier
+  parallel run hit a resource-watch batch-reason assertion; its isolated rerun
+  and subsequent full runs passed.
+- The packed 3.7.0 archive contains 239 entries, including the compiled version
+  plugin, release deployment guide and corrected game starter. Its metadata
+  declares parse5 ^7.3.0 and the unchanged ui-document ^0.13.0 requirement.
+- MilfMaster's same-browser-cache fixture keeps its old immutable response
+  cached while the next deployment loads the changed resource, atlas page and
+  font through a new version directory; uncached old-version lazy loads remain
+  available. Actual minified game startup passes on WebGL and Canvas.
+
 ## 3.6.1 — 2026-10-18
 
-Prepared locally; not published.
+Published; verified on npm on 2026-10-18, including latest, downloaded tarball
+SHA-512 integrity and all 234 files matching prepared commit 46459e97.
 
 ### Fixed
 
@@ -36,13 +104,17 @@ Prepared locally; not published.
 - Command/configuration APIs, KUI format and runtime Skin output are unchanged.
   ui-document remains ^0.13.0, locked to registry 0.13.0; no Core/UI dependency
   or other dependency/lock update is added.
-- To receive the declaration correction after publication, update the project's
+- To receive the declaration correction, update the project's
   CLI installation/lock and rebuild to regenerate .kurot/skin-parts.d.ts.
   Published 3.6.0 keeps the old property form. Core/UI runtime upgrades are not
   required for this fix; existing compatible application ranges remain valid.
 - New scaffolds receive README/AGENTS entries. Existing games retain their own
   instructions, resources and directories. Template latest placeholders remain
   unchanged; UI 3.6.2 is needed only to read the new bundled UI guides.
+- Kurot-Studio adopts exact registry CLI 3.6.1 with a matching lock in commit
+  048e5c1. Its application build and complete check (175 files / 1,451 tests)
+  pass; other direct/transitive dependencies and game installations are unchanged.
+  The application has not been published.
 
 ### Verification
 

package/README.md

@@ -1,94 +1,21 @@
 # @kurot/cli
 
-**3.6.0 is published**, verified on npm on 2026-10-10 with matching registry
-integrity and successful package download. It adds the rounded 2× KUI game skin kit and mascot brand splash,
-and fixes development Theme lookup and empty runtime asset directories.
-Core 2.5.0 is also published and verified; new game scaffolds resolve Core ^2.5.0. The dependency/lock remains published ui-document 0.13.0.
+Build-time KUI XML → ESM Skin compilation, game scaffolding and development
+resource watching. Package version: **3.7.0** (prepared for publication).
+Requires Node.js >= 20 and
+ui-document **^0.13.0**; games supply their own Core/UI runtime packages.
 
-Build tooling for the Kurot UI Editor workflow. It uses esbuild, emits ES2022
-ESM, and compiles canonical KUI XML skins into runtime theme modules.
-
-> **Current version: 3.6.1 (prepared; not published).** Requires `@kurot/ui-document@^0.13.0`
-> and Node.js 20 or later. The CLI runs only at build time.
-
-> **Release scope:** The 3.x line is dedicated to Kurot Editor integration.
-> Existing game projects that use EXML should remain on
-> `@kurot/cli@1.3.x`. The KUI toolchain is not an in-place project upgrade and does
-> not require those projects to change their configuration or UI assets.
-
-Version 3.6.1 fixes generated host skinParts declarations for full TypeScript
-checks with skipLibCheck=false and ships README/AGENTS entries in both templates.
-The game entry links UI 3.6.2's authoring/directory guide and complete ScoreHUD
-recipe. Runtime Skin output, dependency ranges and locks are unchanged. After
-publication, existing projects adopt the fix by updating their CLI installation/
-lock and rebuilding; new template docs do not overwrite existing project files.
-
-See [CHANGELOG.md](CHANGELOG.md) for release history.
-
-Version 3.3.1 fixes development synchronization for all runtime resources,
-including locale JSON, atlas PNG/JSON, fonts and translations. No project
-configuration changes are required; refresh the preview after synchronization.
-See [development resource watching](docs/dev-resource-watching.md).
-
-Version 3.2.1 adds project styles, bundled fonts and English translations to the
-game template. Existing projects are not rewritten. See [game template setup](docs/game-template.md).
-
-Version 3.3.0 compiles shared Label presets from `style.json.labels` into native
-properties, with local and Skin state fields taking priority. See [Label presets](#label-presets-in-330).
-
-## Centered flips in 3.5.0
-
-Compile independent `flipX`/`flipY` booleans on display nodes and named Skin
-states, for example `flipY="true" flipY.down="false"`. The compiler rejects
-malformed booleans and flags on the nonvisual Skin root. Percent dimensions and
-negative scale retain their existing contracts; no authored XML is converted.
-
-The dependency/lock uses published ui-document 0.13.0. Apps rendering these
-flags need published Core 2.4.0/UI 3.4.0; CLI-built skins run directly through
-UI. CLI 3.5.0 is published.
-
-## BitmapLabel and RichLabel in 3.4.0
-
-Compile BitmapLabel with a configured `font` resource, and RichLabel with
-literal `textFlow` / `Span` elements. Named Skin states replace complete run
-arrays; an empty flow clears content. Span elements never become display
-children or Skin parts. New native text fields are validated before output,
-and percentage-looking text such as `100%` remains literal.
-
-Rendering these new tags requires UI `^3.3.0` and Core `^2.3.0` in the app;
-these are the original native API minimums. Current UI 3.4.0 requires Core
-`^2.4.0`, which includes the Core 2.3.1 blank rich-text line correction. Existing controls
-and templates do not require automatic upgrades or migrations. See
-[text component compilation](docs/text-components.md).
-
-## Label text fitting in 3.1.0
-
-The shared ui-document catalog supports Label `textFit` and `minFontSize`
-in KUI XML:
-
-```xml
-<Skin xmlns="https://kurot.dev/ui/1" class="skins.AmountSkin" states="down">
-    <Label id="labelDisplay" text="KZT 10 000,00" width="140" size="24"
-           multiline="false" textFit="shrink" minFontSize="16" size.down="20" />
-</Skin>
-```
-
-The compiler emits the policy, base size and state overrides unchanged. UI
-derives the drawing size after layout validation. Rendering this capability
-requires `@kurot/ui@^3.1.0` and `@kurot/core@^2.1.0` in the application.
-These are the original fitting API minimums; current UI 3.4.0 requires Core ^2.4.0.
-Explicit `multiline="false"` means one unwrapped first line; remove it or set
-it to true for text intended to wrap. Files are not migrated automatically.
-See the [compilation contract](docs/label-text-layout.md) and
-[native Label contract](../ui/docs/label-text-layout.md).
+For UI production use the installed UI [authoring guide](../ui/docs/ui-authoring.md)
+and [ScoreHUD recipe](../ui/docs/recipes/score-hud.md). Legacy EXML projects use
+the separate CLI 1.3.x line. KUI configuration and resource files are project-owned.
 
 ## Usage
 
-The CLI does not require a global install. Use published CLI 3.6.0 below. New game scaffolds need Core ^2.5.0 for the
+The CLI does not require a global install. Install the CLI as a project development dependency. New game scaffolds need Core ^2.5.0 for the
 2× skin kit; existing projects keep their own installed SDKs and resources.
 
 ```bash
-npx @kurot/cli@3.6.0 create my-game
+npx @kurot/cli@3.7.0 create my-game
 cd my-game
 pnpm install
 pnpm dev
@@ -96,7 +23,7 @@ pnpm dev
 
 Scaffolded projects expose `build`, `dev`, and `clean` scripts. For an
 Editor-managed KUI XML project, install the package with
-`pnpm add -D @kurot/cli@^3.6.0`. Existing EXML projects should keep their current
+`pnpm add -D @kurot/cli@^3.7.0`. Existing EXML projects should keep their current
 1.3.x dependency.
 
 ## Commands
@@ -113,24 +40,12 @@ resource loading, and an editable HTML template. Fonts load before creating UI;
 translations register after preload. The `empty` template contains a minimal
 `Sprite` application without UI/style/language dependencies.
 
-CLI 3.6.1 adds project README and AGENTS files to both templates.
-They route gameplay work to installed SDK guides/types, document startup and
-build checks, and distinguish authored files from generated output. Published
-CLI 3.6.0 templates retain their original contents. Existing project files are
-not overwritten when adopting the new CLI.
-
-CLI 3.6.0 supplies rounded Kurot-owned textures,
-native `.kui.xml` component states and resource-default nine-slice grids under
-`resource/assets/ui/kui`. See [default KUI skins](docs/default-ui-skins.md).
-Registry CLI 3.5.0 still contains the previous atlas.
-The default Button uses symmetric padding and Panel titles use middle alignment.
-The source preview also uses Core 2.5.0's multilingual ink centering;
-inputs and multiline text retain stable baselines.
-The new 2× atlas requires published Core ^2.5.0; CLI 3.6.0 is also published.
-
-The CLI 3.6.0 game-template refresh introduces a "Made with Kurot" brand splash
-with a playful mascot entrance, looping hops and sparkles. It supports reduced
-motion and applies to newly created projects; see [HTML brand splash](docs/game-template.md#html-brand-splash).
+Both templates include README/AGENTS entries for commands, authored/generated
+files and installed SDK guides. The game template supplies rounded 2× KUI skins,
+project fonts/colors/translations and a mascot splash with reduced-motion support.
+The 2× skin kit needs Core >= 2.5.0 within 2.x. Existing project files remain
+project-owned. See [template startup](docs/game-template.md) and
+[default UI skins](docs/default-ui-skins.md).
 
 ### `kurot build`
 
@@ -144,8 +59,14 @@ Development output is written to `bin-debug/`. Release output is written to
 project namespace, theme, and application code are separate ESM chunks joined
 by the generated HTML import map.
 
-The CLI 3.6.0 asset-copy correction omits empty runtime directory trees;
-registry CLI 3.5.0 does not include it. With KUI enabled, authored
+Set `output: { dir: 'bin-debug', versionedAssets: true }` to place release
+resources and scripts in `assets/<content-hash>/`. A generated HTML base URL
+versions relative requests, including atlas pages, fonts and startup images.
+Identical builds reuse the same path; development output is unchanged.
+See [release assets and deployment](docs/release-assets.md) for theme loading,
+cache headers and upload order. This option requires CLI >= 3.7.0 within 3.x.
+
+Asset copying omits empty runtime directory trees. With KUI enabled, authored
 `.kui.xml` files are compiled into the theme chunk and excluded from `resource/`;
 skin-only directories such as `resource/ui` therefore do not appear in output.
 Images, JSON and other runtime files inside those directories are still copied.
@@ -165,7 +86,7 @@ The development server rebuilds TypeScript, KUI XML, custom namespaces, and
 the component catalog as their sources change. Browser refresh is currently
 manual. JSONL mode reserves stdout for incremental build and server events.
 
-Since 3.3.1, dev also synchronizes the complete `resource/` tree,
+Dev also synchronizes the complete `resource/` tree,
 including locale JSON, atlas PNG/JSON, fonts and translation files, with deletion
 and rename handling. Runtime-only edits do not recompile skins; style and resource
 default changes still do. Refresh after synchronization succeeds. No atlas
@@ -239,7 +160,7 @@ use `property.state` on the affected node, so internal graphics remain unnamed.
 Image sources use their resource key directly, for example
 `source="button_up_png"`.
 
-CLI 3.6.0/3.6.1 uses published `@kurot/ui-document@^0.13.0` and retains its literal-string XML rules.
+The CLI uses `@kurot/ui-document@^0.13.0` and its literal-string XML rules.
 For example, `<Label text="100.80" text.down="false" size="48" />` compiles
 the exact strings `100.80` and `false`, while the font size stays numeric.
 String properties no longer add or remove backslash type escapes. Remove old
@@ -265,11 +186,10 @@ node inside the Skin is inferred as a skin part; its `id` is the part
 name. The declaration augments the UI runtime with those exact names and types.
 This file is editor-only, ignored by git, and never enters browser bundles.
 
-CLI 3.6.1 emits a getter for each host's narrowed skinParts,
-matching Component's accessor and supporting `tsc --noEmit --skipLibCheck false`.
-Published CLI 3.6.0 emits a readonly property and can fail with TS2610. Rebuild
-using the fixed CLI to regenerate declarations; Core/UI and project dependency
-requirements are unchanged. Generated runtime Skin factories are unaffected.
+Generated host skinParts use getter signatures matching Component's accessor.
+After changing authored Skin inputs, rebuild the declarations and run
+`tsc --noEmit --skipLibCheck false`. Edit authored inputs rather than generated
+`.kurot/` files. Runtime Skin factories are separate from editor declarations.
 
 ## Reusable components
 
@@ -325,7 +245,7 @@ enabled properties files are registered in `preload`. Replace fonts by changing
 the resource-relative files/paths, and add languages through the Editor.
 See [game template setup](docs/game-template.md) for lifecycle and fallback rules.
 
-## Resource defaults in 3.0.0
+## Resource defaults
 
 KUI builds validate `resource/default.res.json` and inherit image or sheet-frame
 `scale9grid` values into compiled `Image.scale9Grid` when XML does not set one.
@@ -337,7 +257,7 @@ Sheet `subkeys` must be an object-valued frame map. Refresh old sheets in the
 Editor before upgrading a KUI project; string-valued subkeys now fail the build.
 See the [resource nine-slice contract](../ui-document/docs/resource-nine-slice.md).
 
-## Project style colors in 3.2.0
+## Project style colors
 
 The optional fixed `resource/config/style.json` is independent of
 `default.res.json`. Each KUI build reads it through the shared document kernel, validates
@@ -365,14 +285,12 @@ switching. CLI-built skins run directly through `@kurot/ui`; `@kurot/ui-runtime`
 is not required for this compilation path. Node.js >= 20 and semantic format
 version 2 remain unchanged.
 
-The previous `@token:color:<key>` XML prefix is rejected by ui-document 0.10.
-Update those references explicitly before adopting CLI 3.2; ordinary text stays
-literal. Existing EXML projects remain on CLI 1.3.x. No Core/UI rendering change
-is required for color expansion.
+Only `@style:colors:<key>` is accepted for authored palette references.
+Ordinary text remains literal; color expansion changes compiled copies only.
 
-## Label presets in 3.3.0
+## Label presets
 
-CLI 3.3.0 expands `textStyle="@style:labels:<key>"` through the shared
+The compiler expands `textStyle="@style:labels:<key>"` through the shared
 `style.json.labels` contract before generating native Label properties. Local and
 state fields win; authoring references remain in XML. Development watches the
 stylesheet and retains the last good bundle on errors. Programmatic `compileKUI`
@@ -383,6 +301,4 @@ than selecting a different preset. Missing presets, unsupported selection or
 invalid configuration fail explicitly. Expansion runs after resource defaults
 and before color resolution. It does not load fonts or measure text.
 
-CLI 3.6.0/3.6.1 uses published ui-document 0.13.0 without local overrides. CLI
-3.2.1 does not include this feature. Existing projects are not migrated.
 See [the shared contract](../ui-document/docs/project-styles.md).

package/dist/core/config.d.ts

@@ -67,6 +67,11 @@ export interface OutputConfig {
      * `bin-release/web/<timestamp>` regardless of this setting.
      */
     readonly dir: string;
+    /**
+     * Place release assets in `assets/<content-hash>/` and set the entry page's
+     * base URL to that directory. Defaults to false; ignored in development.
+     */
+    readonly versionedAssets?: boolean;
 }
 export interface HtmlConfig {
     /**
@@ -86,7 +91,7 @@ export interface ProjectConfig {
      */
     readonly entry: string;
     /**
-     * Development build output settings.
+     * Build output settings.
      */
     readonly output: OutputConfig;
     /**

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

@@ -1 +1 @@
-{"version":3,"file":"config.d.ts","sourceRoot":"","sources":["../../src/core/config.ts"],"names":[],"mappings":"AAIA;;GAEG;AACH,MAAM,MAAM,WAAW,GAAG,OAAO,CAAC;AAElC,MAAM,WAAW,WAAW;IAC3B;;OAEG;IACH,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;IACvB;;OAEG;IACH,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;IACxB;;;OAGG;IACH,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAC;IAC3B;;OAEG;IACH,QAAQ,CAAC,WAAW,EAAE,MAAM,CAAC;IAC7B;;OAEG;IACH,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAC;CAC3B;AAED,MAAM,WAAW,SAAS;IACzB;;OAEG;IACH,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAC;IAC3B;;OAEG;IACH,QAAQ,CAAC,UAAU,CAAC,EAAE,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC,CAAC;IACvD;;;;;;;OAOG;IACH,QAAQ,CAAC,UAAU,CAAC,EAAE,gBAAgB,CAAC;CACvC;AAED,MAAM,WAAW,gBAAgB;IAChC;;OAEG;IACH,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAC;IAC3B;;;OAGG;IACH,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAC;IAC3B;;;OAGG;IACH,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;CACzB;AAED,MAAM,WAAW,YAAY;IAC5B;;;;OAIG;IACH,QAAQ,CAAC,GAAG,EAAE,MAAM,CAAC;CACrB;AAED,MAAM,WAAW,UAAU;IAC1B;;;OAGG;IACH,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAC;CAC1B;AAED,MAAM,WAAW,aAAa;IAC7B;;OAEG;IACH,QAAQ,CAAC,MAAM,EAAE,WAAW,CAAC;IAC7B;;;OAGG;IACH,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;IACvB;;OAEG;IACH,QAAQ,CAAC,MAAM,EAAE,YAAY,CAAC;IAC9B;;OAEG;IACH,QAAQ,CAAC,IAAI,CAAC,EAAE,UAAU,CAAC;IAC3B;;OAEG;IACH,QAAQ,CAAC,KAAK,EAAE,WAAW,CAAC;IAC5B;;OAEG;IACH,QAAQ,CAAC,EAAE,CAAC,EAAE,SAAS,CAAC;CACxB;AA0BD;;;;;;;GAOG;AACH,wBAAsB,UAAU,IAAI,OAAO,CAAC,aAAa,CAAC,CA4CzD"}
+{"version":3,"file":"config.d.ts","sourceRoot":"","sources":["../../src/core/config.ts"],"names":[],"mappings":"AAIA;;GAEG;AACH,MAAM,MAAM,WAAW,GAAG,OAAO,CAAC;AAElC,MAAM,WAAW,WAAW;IAC3B;;OAEG;IACH,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;IACvB;;OAEG;IACH,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;IACxB;;;OAGG;IACH,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAC;IAC3B;;OAEG;IACH,QAAQ,CAAC,WAAW,EAAE,MAAM,CAAC;IAC7B;;OAEG;IACH,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAC;CAC3B;AAED,MAAM,WAAW,SAAS;IACzB;;OAEG;IACH,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAC;IAC3B;;OAEG;IACH,QAAQ,CAAC,UAAU,CAAC,EAAE,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC,CAAC;IACvD;;;;;;;OAOG;IACH,QAAQ,CAAC,UAAU,CAAC,EAAE,gBAAgB,CAAC;CACvC;AAED,MAAM,WAAW,gBAAgB;IAChC;;OAEG;IACH,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAC;IAC3B;;;OAGG;IACH,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAC;IAC3B;;;OAGG;IACH,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;CACzB;AAED,MAAM,WAAW,YAAY;IAC5B;;;;OAIG;IACH,QAAQ,CAAC,GAAG,EAAE,MAAM,CAAC;IACrB;;;OAGG;IACH,QAAQ,CAAC,eAAe,CAAC,EAAE,OAAO,CAAC;CACnC;AAED,MAAM,WAAW,UAAU;IAC1B;;;OAGG;IACH,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAC;CAC1B;AAED,MAAM,WAAW,aAAa;IAC7B;;OAEG;IACH,QAAQ,CAAC,MAAM,EAAE,WAAW,CAAC;IAC7B;;;OAGG;IACH,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;IACvB;;OAEG;IACH,QAAQ,CAAC,MAAM,EAAE,YAAY,CAAC;IAC9B;;OAEG;IACH,QAAQ,CAAC,IAAI,CAAC,EAAE,UAAU,CAAC;IAC3B;;OAEG;IACH,QAAQ,CAAC,KAAK,EAAE,WAAW,CAAC;IAC5B;;OAEG;IACH,QAAQ,CAAC,EAAE,CAAC,EAAE,SAAS,CAAC;CACxB;AA0BD;;;;;;;GAOG;AACH,wBAAsB,UAAU,IAAI,OAAO,CAAC,aAAa,CAAC,CAgDzD"}

package/dist/core/config.js

@@ -45,6 +45,9 @@ export async function loadConfig() {
     else {
         config = DEFAULTS;
     }
+    if (config.output.versionedAssets !== undefined && typeof config.output.versionedAssets !== 'boolean') {
+        throw new ConfigError('Invalid config: output.versionedAssets must be a boolean');
+    }
     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}`);
     }

package/dist/core/config.js.map

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

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

@@ -8,6 +8,7 @@ export { compileSource } from './compile-source.js';
 export { generateHtml } from './generate-html.js';
 export { writeManifest } from './manifest.js';
 export { copyAssets } from './copy-assets.js';
+export { versionAssets } from './version-assets.js';
 /**
  * The standard build sequence.
  *
@@ -16,7 +17,7 @@ export { copyAssets } from './copy-assets.js';
  * 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.
+ * finally static assets are copied and optionally versioned for release.
  */
 export declare function defaultPlugins(): BuildPlugin[];
 //# sourceMappingURL=index.d.ts.map

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

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/core/plugins/index.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,gBAAgB,CAAC;AAWlD,OAAO,EAAE,WAAW,EAAE,MAAM,mBAAmB,CAAC;AAChD,OAAO,EAAE,UAAU,EAAE,MAAM,kBAAkB,CAAC;AAC9C,OAAO,EAAE,aAAa,EAAE,MAAM,qBAAqB,CAAC;AACpD,OAAO,EAAE,uBAAuB,EAAE,MAAM,gCAAgC,CAAC;AACzE,OAAO,EAAE,qBAAqB,EAAE,MAAM,wBAAwB,CAAC;AAC/D,OAAO,EAAE,aAAa,EAAE,MAAM,qBAAqB,CAAC;AACpD,OAAO,EAAE,YAAY,EAAE,MAAM,oBAAoB,CAAC;AAClD,OAAO,EAAE,aAAa,EAAE,MAAM,eAAe,CAAC;AAC9C,OAAO,EAAE,UAAU,EAAE,MAAM,kBAAkB,CAAC;AAE9C;;;;;;;;;GASG;AACH,wBAAgB,cAAc,IAAI,WAAW,EAAE,CAY9C"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/core/plugins/index.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,gBAAgB,CAAC;AAYlD,OAAO,EAAE,WAAW,EAAE,MAAM,mBAAmB,CAAC;AAChD,OAAO,EAAE,UAAU,EAAE,MAAM,kBAAkB,CAAC;AAC9C,OAAO,EAAE,aAAa,EAAE,MAAM,qBAAqB,CAAC;AACpD,OAAO,EAAE,uBAAuB,EAAE,MAAM,gCAAgC,CAAC;AACzE,OAAO,EAAE,qBAAqB,EAAE,MAAM,wBAAwB,CAAC;AAC/D,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;AAC9C,OAAO,EAAE,aAAa,EAAE,MAAM,qBAAqB,CAAC;AAEpD;;;;;;;;;GASG;AACH,wBAAgB,cAAc,IAAI,WAAW,EAAE,CAa9C"}

package/dist/core/plugins/index.js

@@ -7,6 +7,7 @@ import { compileSource } from './compile-source.js';
 import { generateHtml } from './generate-html.js';
 import { writeManifest } from './manifest.js';
 import { copyAssets } from './copy-assets.js';
+import { versionAssets } from './version-assets.js';
 export { cleanOutput } from './clean-output.js';
 export { compileKUI } from './compile-kui.js';
 export { compileEngine } from './compile-engine.js';
@@ -16,6 +17,7 @@ export { compileSource } from './compile-source.js';
 export { generateHtml } from './generate-html.js';
 export { writeManifest } from './manifest.js';
 export { copyAssets } from './copy-assets.js';
+export { versionAssets } from './version-assets.js';
 /**
  * The standard build sequence.
  *
@@ -24,7 +26,7 @@ export { copyAssets } from './copy-assets.js';
  * 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.
+ * finally static assets are copied and optionally versioned for release.
  */
 export function defaultPlugins() {
     return [
@@ -37,6 +39,7 @@ export function defaultPlugins() {
         generateHtml(),
         writeManifest(),
         copyAssets(),
+        versionAssets(),
     ];
 }
 //# sourceMappingURL=index.js.map

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

@@ -1 +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,UAAU,EAAE,MAAM,kBAAkB,CAAC;AAC9C,OAAO,EAAE,aAAa,EAAE,MAAM,qBAAqB,CAAC;AACpD,OAAO,EAAE,uBAAuB,EAAE,MAAM,gCAAgC,CAAC;AACzE,OAAO,EAAE,qBAAqB,EAAE,MAAM,wBAAwB,CAAC;AAC/D,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,UAAU,EAAE,MAAM,kBAAkB,CAAC;AAC9C,OAAO,EAAE,aAAa,EAAE,MAAM,qBAAqB,CAAC;AACpD,OAAO,EAAE,uBAAuB,EAAE,MAAM,gCAAgC,CAAC;AACzE,OAAO,EAAE,qBAAqB,EAAE,MAAM,wBAAwB,CAAC;AAC/D,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,UAAU,EAAE;QACZ,aAAa,EAAE;QACf,uBAAuB,EAAE;QACzB,qBAAqB,EAAE;QACvB,aAAa,EAAE;QACf,YAAY,EAAE;QACd,aAAa,EAAE;QACf,UAAU,EAAE;KACZ,CAAC;AACH,CAAC"}
+{"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,UAAU,EAAE,MAAM,kBAAkB,CAAC;AAC9C,OAAO,EAAE,aAAa,EAAE,MAAM,qBAAqB,CAAC;AACpD,OAAO,EAAE,uBAAuB,EAAE,MAAM,gCAAgC,CAAC;AACzE,OAAO,EAAE,qBAAqB,EAAE,MAAM,wBAAwB,CAAC;AAC/D,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;AAC9C,OAAO,EAAE,aAAa,EAAE,MAAM,qBAAqB,CAAC;AAEpD,OAAO,EAAE,WAAW,EAAE,MAAM,mBAAmB,CAAC;AAChD,OAAO,EAAE,UAAU,EAAE,MAAM,kBAAkB,CAAC;AAC9C,OAAO,EAAE,aAAa,EAAE,MAAM,qBAAqB,CAAC;AACpD,OAAO,EAAE,uBAAuB,EAAE,MAAM,gCAAgC,CAAC;AACzE,OAAO,EAAE,qBAAqB,EAAE,MAAM,wBAAwB,CAAC;AAC/D,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;AAC9C,OAAO,EAAE,aAAa,EAAE,MAAM,qBAAqB,CAAC;AAEpD;;;;;;;;;GASG;AACH,MAAM,UAAU,cAAc;IAC7B,OAAO;QACN,WAAW,EAAE;QACb,UAAU,EAAE;QACZ,aAAa,EAAE;QACf,uBAAuB,EAAE;QACzB,qBAAqB,EAAE;QACvB,aAAa,EAAE;QACf,YAAY,EAAE;QACd,aAAa,EAAE;QACf,UAAU,EAAE;QACZ,aAAa,EAAE;KACf,CAAC;AACH,CAAC"}

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

@@ -0,0 +1,7 @@
+import type { BuildPlugin } from '../pipeline.js';
+/**
+ * Gives every relative release URL one content-addressed base, including
+ * secondary analyzer requests, fonts and assets owned by the HTML template.
+ */
+export declare function versionAssets(): BuildPlugin;
+//# sourceMappingURL=version-assets.d.ts.map

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

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

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

@@ -0,0 +1,108 @@
+import { createHash } from 'node:crypto';
+import { createReadStream } from 'node:fs';
+import * as fs from 'node:fs/promises';
+import * as path from 'node:path';
+import { defaultTreeAdapter, parse } from 'parse5';
+import { BuildError } from '../errors.js';
+/**
+ * Gives every relative release URL one content-addressed base, including
+ * secondary analyzer requests, fonts and assets owned by the HTML template.
+ */
+export function versionAssets() {
+    return {
+        name: 'version release assets',
+        async apply(ctx) {
+            if (ctx.project.mode !== 'release' || !ctx.project.config.output.versionedAssets) {
+                return;
+            }
+            const outputDir = ctx.project.outputDir;
+            const htmlPath = path.join(outputDir, 'index.html');
+            const html = await fs.readFile(htmlPath, 'utf8');
+            const headEnd = validateHtml(html);
+            const version = await hashDirectory(outputDir);
+            const prefix = `assets/${version}/`;
+            const entries = await fs.readdir(outputDir);
+            const staging = await fs.mkdtemp(path.join(outputDir, '.version-assets-'));
+            try {
+                for (const entry of entries) {
+                    if (entry === 'index.html' || entry === 'manifest.json') {
+                        continue;
+                    }
+                    await fs.rename(path.join(outputDir, entry), path.join(staging, entry));
+                }
+                await fs.mkdir(path.join(outputDir, 'assets'));
+                await fs.rename(staging, path.join(outputDir, prefix));
+            }
+            finally {
+                await fs.rm(staging, { recursive: true, force: true });
+            }
+            prefixOutputs(ctx, prefix);
+            const manifest = {
+                initial: Object.values(ctx.outputs.engine),
+                game: [ctx.outputs.skinsScript, ctx.outputs.entryScript].filter(Boolean),
+            };
+            await fs.writeFile(path.join(outputDir, 'manifest.json'), JSON.stringify(manifest, undefined, '\t') + '\n');
+            await fs.writeFile(htmlPath, `${html.slice(0, headEnd)}\n\t<base href="./${prefix}">${html.slice(headEnd)}`);
+        },
+    };
+}
+function validateHtml(html) {
+    const document = parse(html, { sourceCodeLocationInfo: true });
+    const root = document.childNodes.find(defaultTreeAdapter.isElementNode);
+    const head = root?.childNodes.filter(defaultTreeAdapter.isElementNode).find(node => node.tagName === 'head');
+    // HTML parsing can imply a head; insertion requires its authored start tag.
+    const headEnd = head?.sourceCodeLocation?.startTag?.endOffset;
+    if (headEnd === undefined) {
+        throw new BuildError('output.versionedAssets requires an HTML template with a <head> element.');
+    }
+    const elements = root ? [root] : [];
+    while (elements.length > 0) {
+        const element = elements.pop();
+        if (element.tagName === 'base') {
+            throw new BuildError("output.versionedAssets owns the HTML base URL; remove the template's <base> element.");
+        }
+        elements.push(...element.childNodes.filter(defaultTreeAdapter.isElementNode));
+    }
+    return headEnd;
+}
+async function hashDirectory(root) {
+    const hash = createHash('sha256');
+    const files = await listFiles(root);
+    for (const relative of files.sort()) {
+        const file = path.join(root, relative);
+        const stat = await fs.stat(file);
+        hash.update(JSON.stringify([relative, stat.size]) + '\n');
+        for await (const chunk of createReadStream(file)) {
+            hash.update(chunk);
+        }
+    }
+    return hash.digest('hex').slice(0, 32);
+}
+async function listFiles(root, directory = '') {
+    const files = [];
+    for (const entry of await fs.readdir(path.join(root, directory), { withFileTypes: true })) {
+        const relative = path.posix.join(directory, entry.name);
+        if (entry.isDirectory()) {
+            files.push(...(await listFiles(root, relative)));
+        }
+        else if (entry.isFile()) {
+            files.push(relative);
+        }
+        else {
+            throw new BuildError(`Versioned assets require regular files or directories: ${relative}`);
+        }
+    }
+    return files;
+}
+function prefixOutputs(ctx, prefix) {
+    if (ctx.outputs.entryScript) {
+        ctx.outputs.entryScript = prefix + ctx.outputs.entryScript;
+    }
+    if (ctx.outputs.skinsScript) {
+        ctx.outputs.skinsScript = prefix + ctx.outputs.skinsScript;
+    }
+    for (const specifier of Object.keys(ctx.outputs.engine)) {
+        ctx.outputs.engine[specifier] = prefix + ctx.outputs.engine[specifier];
+    }
+}
+//# sourceMappingURL=version-assets.js.map

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

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

package/docs/ai-context.md

@@ -1,14 +1,9 @@
 # @kurot/cli — AI context map
 
-CLI 3.6.0 is published, verified on npm on 2026-10-10, including latest,
-package download and matching registry integrity. Development installs
-published ui-document 0.13.0 with a matching
-registry lockfile, without local overrides. Read
-[centered flips](../../../docs/centered-flips.md) for transform and adoption contracts.
-
-Read this before exploring `src/`. [`architecture.md`](./architecture.md)
-explains the plugin pipeline. Version `@kurot/cli@3.6.1` is prepared locally (not published), runs on Node.js 20+,
-and is installed as a project dev dependency.
+`@kurot/cli@3.7.0` is build-time tooling on Node.js >= 20, with ordinary
+ui-document dependency **^0.13.0**. Projects supply their own Core/UI runtime.
+Read [architecture](architecture.md) for the plugin pipeline; the source and
+configuration exports establish current behavior.
 
 ## Directory map
 
@@ -31,34 +26,15 @@ src/
 └── utils/
 ```
 
-Project templates are under `templates/game` and `templates/empty`.
-CLI 3.6.1 includes README/AGENTS consumer navigation in both templates; its
-game entry links the new UI 3.6.2 authoring guide and complete ScoreHUD recipe. See [game-template.md](game-template.md).
-The CLI 3.6.0 game template's default KUI skin refresh includes 16 native Skin files,
-a Kurot-owned 2× atlas with logical resource-default nine-slice grids, and project palette
-colors. These replace the old EUI assets. Group/List/TabBar and text/image nodes use
-native XML composition rather than unused default Skin placeholders. See
-[default KUI skins](default-ui-skins.md). Private tools/default-ui-assets generates
-the committed assets with registry Atlas; CLI gains no atlas runtime dependency.
-The 2× sheet requires Core ^2.5.0; published Core 2.4.0
-does not interpret it. Private preview tooling binds checkout Core in an isolated
-trial. Core 2.5.0 was published before CLI 3.6.0; both are verified on npm.
-The CLI 3.6.0 game template includes the looping mascot brand splash; registry
-CLI 3.5.0 does not contain that HTML/logo refresh. See game-template.md.
-The 3.2.1 game template includes fixed style/locale configuration,
-English properties and licensed regular/bold font files. StyleManager finishes
-font loading before Main creates Player/Preloader; LocaleManager registers
-preload texts before creating the scene. See [game-template.md](game-template.md).
-Version 3.3.0 is published with Label preset compilation and
-published ui-document 0.11.0. It has no local document-kernel override.
-Published version 3.3.1 adds whole-resource dev synchronization, deletion/reconnect
-handling and no-store responses. Installed CLI 3.3.0 lacks these fixes; consumers
-must update their installed/locked version to receive them.
-
-## Native text adoption in 3.4.0
-
-Version 3.4.0 registers BitmapLabel and RichLabel from published UI
-3.3.0 and consumes document 0.12.0. `kui/validate-text-components.ts` applies
+Project templates are under `templates/game` and `templates/empty`, including
+README/AGENTS entries for installed SDK guides and project commands. The game
+template supplies paired KUI/TS components, default skins, a 2× atlas, palette,
+fonts, translations and splash HTML. See [template startup](game-template.md)
+and [default skins](default-ui-skins.md).
+
+## Native text compilation
+
+The compiler registers BitmapLabel and RichLabel through ui-document. `kui/validate-text-components.ts` applies
 strict shared property/state validation only to these new built-ins, preserving
 existing CLI-only and custom class contracts. Text flows remain literal arrays;
 Span data does not create nodes/parts. Only width/height use percent conversion.
@@ -80,11 +56,11 @@ transforms such as `flipX`/`flipY` belong on those children. Overrides use local
 `property.state` attributes. Storage IDs and runtime mapping metadata are not
 authored XML fields.
 
-CLI 3.5.0 validates centered-flip booleans on display nodes and named-state
+The compiler validates centered-flip booleans on display nodes and named-state
 overrides, including CLI-only controls. Malformed values and flags on the
 nonvisual Skin root fail compilation. Negative scales are preserved.
 
-CLI 3.6.0 requires `@kurot/ui-document@^0.13.0`. Schema-defined strings, including
+The CLI requires `@kurot/ui-document@^0.13.0`. Schema-defined strings, including
 numeric/boolean-looking text and state text, are literal attributes without
 backslash type escaping. Old synthetic prefixes become literal characters;
 do not migrate them silently. Numeric/boolean properties and schema-free
@@ -107,10 +83,9 @@ as the part name. Internal nodes can omit `id`; the declaration augments
 component classes. The file is development metadata and is excluded from
 runtime output.
 
-CLI 3.6.1 narrows host `skinParts` through a getter signature,
-preserving Component's accessor kind under `skipLibCheck=false`. Published CLI
-3.6.0 instead emits a readonly property and can report TS2610. Regenerate with
-the fixed CLI; do not change Core/UI or hand-edit the generated declaration.
+The generator narrows host `skinParts` through a getter signature,
+preserving Component's accessor kind under `skipLibCheck=false`. Regenerate after
+authored Skin changes; keep generated declarations out of manual edits.
 
 ## Reusable components
 
@@ -132,7 +107,7 @@ manual prefix cannot conflict with `ui.components.namespace`.
   `--strict` or release policy.
 - Machine diagnostic modes own stdout: build emits one JSON result; dev emits
   JSONL lifecycle events.
-- Since 3.3.1, dev watches all resource assets even without UI, emits
+- Dev watches all resource assets even without UI, emits
   resource-change for copy-only batches, retains KUI requirements across mixed
   batches, and reconciles deletions. Browser refresh remains manual; HTTP is
   no-store. Per-file staging/rename is not an atomic atlas pair transaction.
@@ -143,9 +118,8 @@ manual prefix cannot conflict with `ui.components.namespace`.
 - Engine and custom namespace chunks share `ctx.outputs.engine` because the
   import-map writer treats both as external specifier mappings.
 - Engine and reusable namespace bundles preserve class names in both modes.
-  The CLI 3.6.0 development fix also protects self-referencing classes, which
-  esbuild can rename without minification. Registry CLI 3.5.0 protects release
-  names only. Theme fallback uses constructor names.
+  Self-referencing classes retain stable names in both modes because Theme
+  fallback uses constructor names.
 - The Skin module builder stages output in a temporary directory and installs a
   bundle only after every Skin succeeds.
 - `cleanOutput` wipes the active output directory at the start of each build.
@@ -153,11 +127,10 @@ manual prefix cannot conflict with `ui.components.namespace`.
 - `create` queries the npm registry for current Kurot package versions and falls
   back to `latest` if the request fails.
 - Release output is timestamped and `manifest.json` exists only in release.
-- The CLI 3.6.0 asset-copy correction omits empty runtime directory trees,
+- Asset copying omits empty runtime directory trees,
   including skin-only `resource/ui`. Runtime files under UI directories remain
   eligible; generated theme JSON and the compiled Skin module remain required.
-  Template copies still preserve empty directories. Registry CLI 3.5.0 does not
-  include this correction.
+  Template copies still preserve empty directories.
 
 ## Plugin order
 
@@ -171,11 +144,19 @@ manual prefix cannot conflict with `ui.components.namespace`.
 6. compile application source;
 7. generate HTML;
 8. write the release manifest;
-9. copy runtime assets.
+9. copy runtime assets;
+10. optionally version release assets with `output.versionedAssets`.
 
 Do not reorder namespace or source compilation without reviewing externalization
 in `namespace-external-plugin.ts`.
 
+Release versioning runs last so the digest covers generated themes, scripts,
+resource bytes and template assets. It keeps index.html/manifest.json at the
+output root and moves all other files under assets/<hash>/. The HTML base URL
+versions document-relative requests; callers that explicitly resolve URLs must
+use document.baseURI. Existing UI Theme must receive an absolute config URL.
+See [release assets](release-assets.md). This option requires CLI >= 3.7.0 within 3.x.
+
 ## Configuration lookup
 
 | Task                             | File                                                                |
@@ -205,14 +186,14 @@ pnpm test
 CLI end-to-end tests bind localhost and may require permission in a restricted
 execution environment.
 
-## Resource configuration change in 3.0.0
+## Resource configuration
 
 KUI builds validate object subkeys, resolve resource nine-slice defaults, and
 watch the manifest during development. See
 [the resource-default contract](../../ui-document/docs/resource-nine-slice.md)
 for conversion and compilation boundaries.
 
-## Label text compilation in 3.1.0
+## Label text compilation
 
 The compiler consumes the shared ui-document catalog and emits Label `textFit`,
 `minFontSize`, authored `size` and state-size overrides unchanged. Runtime
@@ -222,7 +203,7 @@ within their respective majors. Neither engine is a CLI runtime dependency.
 See [text compilation](label-text-layout.md) and
 [native Label text layout](../../ui/docs/label-text-layout.md) for the boundary.
 
-## Project styles in 3.2.0
+## Project styles
 
 Read [project styles](../../ui-document/docs/project-styles.md). buildSkinsModule
 reads the optional fixed config/style.json once per build and forwards its numeric
@@ -233,13 +214,11 @@ without migrating files. Fonts are validated but not loaded; the application own
 font loading and rendering. Build/preview copies resolve references while authored
 XML retains them. No live runtime palette switching is introduced.
 
-## Label presets in 3.3.0
+## Label presets
 
 skin-module-builder.ts reads the entire stylesheet once per build and passes it
 through parseToIR/parseKUISkin. Resolve resource defaults, then Label presets, then colors before
 native emission; retain XML references and local/state precedence. compileKUI
 accepts an optional styleSheet. style.json changes already trigger whole-Skin
-rebuilds. Invalid presets retain the last successful bundle. The 3.3.0 dependency and
-lockfile used published ui-document 0.11.0 without a local override. Current
-CLI 3.5.0 development uses published ui-document 0.13.0. textStyle is
+rebuilds. Invalid presets retain the last successful bundle. textStyle is
 Default-only; individual named-state fields can still override preset properties.

package/docs/architecture.md

@@ -18,6 +18,7 @@ clean output
   → generate HTML
   → write release manifest
   → copy runtime assets
+  → optionally version release assets
 ```
 
 KUI compilation runs first because skin factories can import project namespace
@@ -39,7 +40,7 @@ factory variables, property assignments, semantic layout children, and state
 property overrides. Document contracts, reusable instances, data bindings, and
 actions remain `UIDocument` concepts.
 
-CLI 3.6.0 consumes ui-document ^0.13.0, retaining Label text-fitting metadata. The
+CLI 3.7.0 consumes ui-document ^0.13.0, retaining Label text-fitting metadata. The
 compiler emits `textFit`, `minFontSize`, base font sizes and state overrides;
 native UI owns measurement and derives drawing sizes after layout validation.
 See [Label compilation](label-text-layout.md). The application supplies UI
@@ -71,6 +72,13 @@ Development builds preserve application source module structure under
 `manifest.json`. Static resources retain stable paths because application code
 addresses them by key or URL.
 
+With `output.versionedAssets: true`, the final stage hashes the complete output
+and moves runtime files into `assets/<hash>/`. The entry HTML receives a base URL;
+the root release manifest and BuildContext script paths receive the same prefix.
+Relative references inside resources and ESM modules remain intact. This is one
+version for the complete build, rather than independent hashes per resource.
+See [release deployment](release-assets.md) for URL and hosting requirements.
+
 Asset copying creates directories only when an accepted runtime file needs them.
 KUI source files and source theme JSON are excluded when UI compilation is enabled,
 so a skin-only `resource/ui` tree is absent from output. Mixed directories retain
@@ -84,7 +92,7 @@ convention-based reusable components. A component change can affect its source
 namespace, paired skin, generated type declaration, and editor catalog, so that
 path refreshes all four outputs as one operation. The server preserves the last
 successful output after an invalid edit.
-Since 3.3.1, the resource watcher synchronizes all runtime assets even without UI,
+The resource watcher synchronizes all runtime assets even without UI,
 and reconciles additions, deletions and directory replacement. Runtime-only
 changes do not recompile skins. The fixed style.json and default.res.json paths
 still trigger KUI compilation; font loading remains an application responsibility.

package/docs/default-ui-skins.md

@@ -1,8 +1,6 @@
 # Default KUI skins
 
-This game-template refresh is included in published CLI 3.6.0, verified on npm
-on 2026-10-10. CLI 3.5.0 contains the older atlas. The 2× kit requires published
-Core ^2.5.0; actual published CLI scaffolding resolves that dependency.
+The 2× atlas needs Core >= 2.5.0 within 2.x for source-density metadata.
 The template owns the XML, textures and project colors; `@kurot/ui`
 does not ship a bitmap theme or load a stylesheet itself.
 
@@ -30,14 +28,12 @@ to draw the components, and no runtime light/dark switching is introduced.
 ## Text and spacing
 
 Single-line captions use `multiline="false" verticalAlign="middle"` with the
-Core 2.5.0 ink-centering correction. Button label padding is 10 pixels
+native dynamic-text ink centering. Button label padding is 10 pixels
 above/below; its down state uses 12/8 to retain a deliberate 2-pixel press offset.
 The icon has the same neutral/down centers. Panel titles also opt into middle
 alignment. Input text retains Core's stable font baseline while its placeholder
 uses dynamic visual centering. No language-specific skin offsets are required.
-See [Core text alignment](../../core/docs/text-layout.md#visual-centering-and-stable-baselines-core-250).
-Published Core 2.4.0 does not contain that correction; the isolated preview uses
-checkout Core for both text alignment and source density.
+See [Core text alignment](../../core/docs/text-layout.md#baselines-and-cached-metrics).
 
 ## Resources and XML
 
@@ -72,13 +68,11 @@ automatic scrolling policies and touch/trackpad scrolling. To display bars in a
 project, edit those parts explicitly.
 
 ItemRenderer backgrounds fit the allocated row width without extra horizontal
-padding. The checkout Core also fixes fractional WebGL scissor bounds so scaled
-Lists retain their right outline. Published Core 2.4.0 lacks that correction;
-shrinking the skin or changing its nine-slice grid is not required.
+padding. Core encloses fractional WebGL scissor bounds so scaled Lists retain their
+right outline; use the allocated row geometry without compensating skin offsets.
 
 Group, List, TabBar, ViewStack and text/image nodes are composed directly in XML;
-their old default-Skin placeholders were not conventional Theme mappings and
-are removed. Use `itemRendererSkinName` to choose a List/TabBar row appearance,
+they do not require placeholder default skins. Use `itemRendererSkinName` to choose a List/TabBar row appearance,
 and wrap the node with Group/Image/Scroller for its surface and viewport.
 
 ## Native preview and maintenance
@@ -87,9 +81,7 @@ and wrap the node with Group/Image/Scroller for its surface and viewport.
 `src/DefaultUI.ts` only connects data and events. The example installs its own
 project font loader and document dependency; other projects are unchanged.
 
-The example now locks registry Core 2.5.4, which supports sheet density. Its
-installed CLI remains 3.3.1, so use checkout CLI 3.6.0 for the current gallery's
-constructor-name preservation. From the repository root:
+Use the checkout CLI with the example's installed SDKs. From the repository root:
 
 ```sh
 pnpm --dir packages/cli build
@@ -105,18 +97,15 @@ directory, the same CLI accepts `build` and `build --release` for one-shot build
 The private asset tool's isolated source preview remains an optional maintenance
 tool for testing checkout engine changes; it is not required by the installed Core.
 
-CLI 3.6.0 preserves constructor names in development and release
+The CLI preserves constructor names in development and release
 engine/namespace bundles so Theme lookup also works for self-referencing
-classes such as Scroller. Published CLI 3.5.0 lacks the development correction.
+classes such as Scroller.
 
 `tools/default-ui-assets` contains editable SVG geometry and the reproducible
 PNG/atlas generator. It uses registry `@kurot/atlas@0.1.0` only as private
 repository tooling. CLI and runtime SDKs gain no atlas dependency. See its
 [maintenance instructions](../../../tools/default-ui-assets/README.md).
 
-Core 2.5.0 and CLI 3.6.0 are published; Core was published first.
-UI/Game/document/runtime need no incidental release; existing 1× consumers keep
-their behavior. See [density units and adoption](../../core/docs/texture-density.md).
-Existing projects keep their own skins, resource keys and startup code. New
-scaffolds receive this kit after the supporting Core and CLI publications;
-installing a new CLI does not rewrite an existing project's resources.
+Existing projects keep their own skins, resource keys and startup code. Updating
+the installed CLI does not rewrite authored resources. New scaffolds receive
+the template's current kit.

package/docs/dev-resource-watching.md

@@ -1,8 +1,7 @@
 # Development resource watching
 
-Available in published CLI 3.3.1. No configuration or
-dependency-range changes are required. Projects must install the new CLI to
-receive these behaviors; installed CLI 3.3.0 does not include them.
+`kurot dev` synchronizes runtime assets without additional watcher configuration.
+Browser refresh remains manual.
 
 ## Inputs and rebuilds
 

package/docs/game-template.md

@@ -1,27 +1,11 @@
-# Project styles and languages in the game template
-
-Project-owned style/font/language initialization was introduced in CLI 3.2.1
-and remains in published CLI 3.6.0. Existing projects keep their own startup
-code and HTML; the empty template stays minimal.
-
-## Project documentation in 3.6.1
-
-CLI 3.6.1 includes a project README and short AGENTS entry in both templates.
-This version is prepared locally and has not been published.
-They identify the gameplay entry, commands, expected startup, generated files
-and task-specific guides in installed SDK packages. Read the consumer project's
-manifest, lock and installation for its actual versions. These additions are
-not in the already published CLI 3.6.0 artifact and do not rewrite existing games.
-For gameplay, the entries point to Core's game-authoring guide when installed,
-or the Star Catcher reference in an engine checkout; older packages retain their
-README/type-declaration fallback.
-
-The [standard UI guide](../../ui/docs/ui-authoring.md), bundled in UI 3.6.2, adds
-directory, TS/Skin pairing and lifecycle rules above the API reference, with a
-complete HUD recipe. The game README points at its installed copy. UI 3.6.2 and
-CLI 3.6.1 are separate packages: installing UI supplies the guides, while using
-the new CLI for create supplies template entry docs. Existing projects keep
-their own instructions and can add the links explicitly.
+# Game template startup and project services
+
+The game template owns its style/font/language initialization, HTML, README and
+AGENTS entry. The empty template stays Core-only. New scaffolds receive these
+files; existing projects keep their own authored resources and instructions.
+For UI organization and component/Skin pairing use
+[standard authoring](../../ui/docs/ui-authoring.md) and the
+[ScoreHUD recipe](../../ui/docs/recipes/score-hud.md).
 
 ## Files
 
@@ -49,8 +33,6 @@ Templates do not implement live font/theme/language replacement.
 
 ## HTML brand splash
 
-This splash is included in published CLI 3.6.0; npm CLI 3.5.0 lacks it.
-
 The game template's `web/index.html` presents `web/logo.png` beneath a small
 "Made with" caption. The mascot makes a gentle entrance, then repeats a playful
 hop and sway every 3.2 seconds while the entry module loads. Sparkles and a soft
@@ -67,9 +49,8 @@ existing project HTML is project-owned.
 
 ## Change fonts and colors
 
-The CLI 3.6.0 [default KUI skins](default-ui-skins.md) use Kurot-owned textures
-under resource/assets/ui/kui and a matching color palette. Registry CLI 3.5.0
-does not include this skin refresh. Skin state text colors compile from the
+The [default KUI skins](default-ui-skins.md) use Kurot-owned textures under
+resource/assets/ui/kui and a matching color palette. Skin state text colors compile from the
 project stylesheet; texture colors are baked into the PNG, without live palette
 switching. Templates inherit project fonts and retain the existing licensed files.
 

package/docs/label-text-layout.md

@@ -1,6 +1,6 @@
 # Label text compilation
 
-CLI 3.6.0 consumes ui-document ^0.13.0 and compiles KUI text-fitting properties
+The CLI consumes ui-document ^0.13.0 and compiles KUI text-fitting properties
 through the existing UIDocument → SkinIR → ESM factory pipeline. The semantic
 document format remains version 2.
 
@@ -34,12 +34,10 @@ introduces build-time text measurement. See the
 
 ## Runtime boundary
 
-- The application must install UI `^3.1.0` and Core `^2.1.0` for shrinking.
-  These are the feature's original API minimums. Installing current UI 3.4.0
-  requires Core `^2.4.0` for that package's centered-flip contract.
-  They remain application dependencies; CLI depends on the headless document
-  package rather than importing the engine into the build process.
-- `textFit` is `none` by default or `shrink` for ordinary single-line Labels.
+- Applications supply an accepted Core/UI pair and satisfy the installed UI's
+  Core peer. The compiler depends on the headless document kernel.
+- `textFit` is `none` by default or `shrink` for ordinary Labels.
+  Supported fitting modes and bounds follow the installed native UI contract.
   Put a Button's policy on its `labelDisplay` skin part.
 - `minFontSize` defaults to 12 logical pixels and must be finite and >= 1.
   A minimum greater than the authored size does not enlarge the text.
@@ -47,20 +45,20 @@ introduces build-time text measurement. See the
   State removal restores the authored base size before fitting again.
 - `renderedSize` and `textFitOverflow` are runtime observations; do not author
   them in KUI XML.
-- Multiline Labels keep their base size; EditableText rejects shrinking.
+- EditableText rejects shrinking. Current native Label supports fitting in either
+  line mode; `multiline` continues to choose line generation.
 - Load fonts before measuring text. For late loading, native UI callers use
   `label.invalidateSize()` after the font becomes ready.
 
-UI 3.1's public Label contract owns the full fitting, overflow, layout and
-font-readiness rules. ui-document 0.9's catalog describes the authoring fields.
-The build does not rewrite existing skins or apply project translation rules.
+The [native Label contract](../../ui/docs/label-text-layout.md) owns fitting,
+overflow, layout and font-readiness rules. The compiler does not rewrite
+existing skins or apply project translation rules.
 
-## Migration
+## Authored line policy
 
-In Core 2.1.0, explicit `multiline="false"` means one unwrapped first line.
+Explicit `multiline="false"` means one unwrapped first line.
 Remove that flag or set it to true where wrapping is intended. The literal-string
 XML contract is retained: a backslash followed by `n` stays literal text rather
 than becoming a hard separator.
 
-Existing EXML projects remain on CLI 1.3.x. The KUI release does not introduce
-an EXML migration or resource-format change.
+EXML authoring uses the CLI 1.x line. This KUI compiler does not migrate EXML.

package/docs/release-assets.md

@@ -0,0 +1,76 @@
+# Versioned release assets
+
+Enable content-addressed release packaging in `kurot.config.ts`:
+
+```ts
+export default {
+	output: { dir: 'bin-debug', versionedAssets: true },
+	// Keep the project's other settings.
+};
+```
+
+The option requires CLI >= 3.7.0 within 3.x. It defaults to false and is ignored
+by development/watch builds.
+An index query string does not propagate to requests for resources.
+
+## Output and URLs
+
+```text
+bin-release/web/<timestamp>/
+├── index.html
+├── manifest.json
+└── assets/<hash>/
+    ├── js/
+    ├── resource/
+    └── <files copied beside the HTML template>
+```
+
+The hash is the first 32 hexadecimal characters of SHA-256 over sorted output
+paths, file sizes and bytes, including generated HTML, theme JSON and scripts.
+Any changed file changes the complete build's version. Identical builds retain
+their URL; unchanged individual files also get new URLs when another file changes.
+This trades granular cache reuse for one consistent release across all loaders.
+
+The CLI inserts `<base href="./assets/<hash>/">` first inside `<head>`. A request
+for `resource/assets/atlas.png` then resolves under the version directory, even
+when the entry is `/game/index.html?launch=...`. Atlas `file` references, bitmap
+font pages, stylesheet fonts, relative imports and direct browser requests use
+that directory without rewriting authored resources or keys. The release manifest
+stays at the root with prefixed script paths. Source maps move with their scripts.
+
+Custom templates must have an explicit `<head>` and no `<base>` element. The
+CLI inserts the base at the parsed start tag's source location without
+reserializing the template. Quoted attributes and script/style text are preserved.
+The build rejects symbolic links and other nonregular output files. Relative URLs
+must refer to files inside the build; root-relative URLs, remote URLs, and URLs
+explicitly based on location.href remain outside this mechanism. Applications
+that construct URLs should use document.baseURI for build assets. Relative links
+and forms also inherit the base; use explicit destinations for application navigation.
+If hosting has a CSP base-uri directive, it must allow this same-origin base.
+
+## Theme loading with existing UI
+
+UI runtimes that resolve a relative Theme config against location.href need an
+absolute config URL. The game starter uses:
+
+```ts
+const theme = new Theme(new URL('resource/default.thm.json', document.baseURI).href);
+```
+
+Use the same pattern in existing projects. This keeps the theme's `skinsJs`
+import inside the version directory without requiring a UI runtime update.
+
+## Deployment
+
+Upload the complete generated directory, including `assets/<hash>/`. Upload new
+asset directories first, then replace root manifest.json and index.html. Keep
+previous version directories available while older sessions may request assets;
+avoid deploy commands that delete those directories immediately. Publish the
+entry at a directory URL ending in `/` or at its actual `index.html` URL.
+
+Serve index.html with revalidation, for example `Cache-Control: no-cache`.
+Serve `assets/<hash>/**` with `Cache-Control: public, max-age=31536000, immutable`.
+If a launcher reads root manifest.json, give it revalidation too. These are server
+settings; the CLI writes static files and cannot set response headers. Never
+overwrite files inside an already published hash directory. Rollback replaces
+the root entry files with those of the previous complete release.

package/docs/text-components.md

@@ -1,12 +1,8 @@
 # BitmapLabel and RichLabel compilation
 
-Native text compilation was introduced in CLI 3.4.0 with document 0.12.0.
-Current CLI 3.6.0 requires published ui-document ^0.13.0 and retains these tags.
-Applications rendering these tags
-must install UI `^3.3.0` and Core `^2.3.0`; Core 2.3.1 fixes unstyled blank
-rich-text line metrics. The CLI does not install or bundle its own Core/UI.
-Document format version 2 and existing project configuration are unchanged.
-Installing UI 3.4.0 requires Core ^2.4.0 for that package's centered-flip contract.
+The compiler registers native text types through ui-document and generates Skin
+factories. Applications supply an accepted Core/UI pair; the CLI does not bundle
+its own engine. Semantic document format is 2.
 
 ```xml
 <Skin xmlns="https://kurot.dev/ui/1" class="TextSkin" states="disabled">

package/package.json

@@ -1,6 +1,6 @@
 {
 	"name": "@kurot/cli",
-	"version": "3.6.1",
+	"version": "3.7.0",
 	"description": "Kurot CLI - build tool for Kurot Editor KUI XML workflows",
 	"author": "Kelvin <kyia.x52@gmail.com>",
 	"license": "MIT",
@@ -30,7 +30,8 @@
 	"dependencies": {
 		"@kurot/ui-document": "^0.13.0",
 		"commander": "^13.0.0",
-		"esbuild": "^0.25.0"
+		"esbuild": "^0.25.0",
+		"parse5": "^7.3.0"
 	},
 	"devDependencies": {
 		"@types/node": "^22.0.0",

package/templates/game/src/Main.ts

@@ -75,7 +75,7 @@ class Main extends UILayer {
 
 	private async _loadTheme(): Promise<void> {
 		// Load the theme and its default UI skin mappings.
-		const theme = new Theme('resource/default.thm.json');
+		const theme = new Theme(new URL('resource/default.thm.json', document.baseURI).href);
 		await new Promise<void>(resolve => theme.addEventListener(Event.COMPLETE, () => resolve()));
 	}