@kurot/core 2.5.5 → 2.6.0

package/docs/api/ticker-variable/callLater-method.md

@@ -1,6 +1,6 @@
 # callLater
 
-Package: `@kurot/core@2.5.5`. Generated from public declarations and JSDoc.
+Package: `@kurot/core@2.6.0`. Generated from public declarations and JSDoc.
 
 ```ts
 callLater(fn: (args: unknown[]) => void, ...args: unknown[]): void;

package/docs/api/ticker-variable/frameRate-accessor.md

@@ -1,6 +1,6 @@
 # frameRate
 
-Package: `@kurot/core@2.5.5`. Generated from public declarations and JSDoc.
+Package: `@kurot/core@2.6.0`. Generated from public declarations and JSDoc.
 
 ```ts
 get frameRate(): number;

package/docs/api/ticker-variable/pause-method.md

@@ -1,6 +1,6 @@
 # pause
 
-Package: `@kurot/core@2.5.5`. Generated from public declarations and JSDoc.
+Package: `@kurot/core@2.6.0`. Generated from public declarations and JSDoc.
 
 ```ts
 pause(): void;

package/docs/api/ticker-variable/removePlayer-method.md

@@ -1,6 +1,6 @@
 # removePlayer
 
-Package: `@kurot/core@2.5.5`. Generated from public declarations and JSDoc.
+Package: `@kurot/core@2.6.0`. Generated from public declarations and JSDoc.
 
 ```ts
 removePlayer(player: Renderable): void;

package/docs/api/ticker-variable/resume-method.md

@@ -1,6 +1,6 @@
 # resume
 
-Package: `@kurot/core@2.5.5`. Generated from public declarations and JSDoc.
+Package: `@kurot/core@2.6.0`. Generated from public declarations and JSDoc.
 
 ```ts
 resume(): void;

package/docs/api/ticker-variable/setFrameRate-method.md

@@ -1,6 +1,6 @@
 # setFrameRate
 
-Package: `@kurot/core@2.5.5`. Generated from public declarations and JSDoc.
+Package: `@kurot/core@2.6.0`. Generated from public declarations and JSDoc.
 
 ```ts
 setFrameRate(value: number): boolean;

package/docs/api/ticker-variable/start-method.md

@@ -1,6 +1,6 @@
 # start
 
-Package: `@kurot/core@2.5.5`. Generated from public declarations and JSDoc.
+Package: `@kurot/core@2.6.0`. Generated from public declarations and JSDoc.
 
 ```ts
 start(): void;

package/docs/api/ticker-variable/startTick-method.md

@@ -1,6 +1,6 @@
 # startTick
 
-Package: `@kurot/core@2.5.5`. Generated from public declarations and JSDoc.
+Package: `@kurot/core@2.6.0`. Generated from public declarations and JSDoc.
 
 ```ts
 startTick(callback: TickCallback, thisObject: unknown): void;

package/docs/api/ticker-variable/stop-method.md

@@ -1,6 +1,6 @@
 # stop
 
-Package: `@kurot/core@2.5.5`. Generated from public declarations and JSDoc.
+Package: `@kurot/core@2.6.0`. Generated from public declarations and JSDoc.
 
 ```ts
 stop(): void;

package/docs/api/ticker-variable/stopTick-method.md

@@ -1,6 +1,6 @@
 # stopTick
 
-Package: `@kurot/core@2.5.5`. Generated from public declarations and JSDoc.
+Package: `@kurot/core@2.6.0`. Generated from public declarations and JSDoc.
 
 ```ts
 stopTick(callback: TickCallback, thisObject: unknown): void;

package/docs/api/ticker-variable/update-method.md

@@ -1,6 +1,6 @@
 # update
 
-Package: `@kurot/core@2.5.5`. Generated from public declarations and JSDoc.
+Package: `@kurot/core@2.6.0`. Generated from public declarations and JSDoc.
 
 ```ts
 update(forceUpdate: boolean): void;

package/docs/api/ticker-variable.md

@@ -1,6 +1,6 @@
 # ticker
 
-Package: `@kurot/core@2.5.5`. Generated from public declarations and JSDoc.
+Package: `@kurot/core@2.6.0`. Generated from public declarations and JSDoc.
 
 ```ts
 ticker: SystemTicker;

package/docs/api/toColorString-function.md

@@ -1,6 +1,6 @@
 # toColorString
 
-Package: `@kurot/core@2.5.5`. Generated from public declarations and JSDoc.
+Package: `@kurot/core@2.6.0`. Generated from public declarations and JSDoc.
 
 ```ts
 toColorString(value: number): string;

package/docs/api/tokenize-function.md

@@ -1,6 +1,6 @@
 # tokenize
 
-Package: `@kurot/core@2.5.5`. Generated from public declarations and JSDoc.
+Package: `@kurot/core@2.6.0`. Generated from public declarations and JSDoc.
 
 ```ts
 tokenize(text: string): string[];

package/docs/architecture.md

@@ -1,6 +1,6 @@
 # @kurot/core architecture
 
-> Package version: 2.5.4 (published; registry metadata, integrity and generated files verified on 2026-10-12). See [CHANGELOG.md](../CHANGELOG.md) for release notes.
+> Package version: 2.6.0 (prepared; publication pending). See [CHANGELOG.md](../CHANGELOG.md) for release notes.
 > The [AI context map](./ai-context.md) covers directories, non-obvious behavior,
 > terminology and task-to-file references. This document explains design choices
 > and internal mechanisms for contributors; the two documents complement each other.
@@ -14,17 +14,17 @@ resources, networking and media runtime. Public APIs follow Egret's
 `DisplayObject` and event model, while rendering uses a flat
 `InstructionSet + RenderPipe` pipeline inspired by Pixi.js 8.
 
-Since 2.2.0, Core uses published `@kurot/bitmap-font ^0.1.0` as the headless font-data
+Core uses `@kurot/bitmap-font ^0.1.0` as the headless font-data
 and layout kernel. Core manages font resources, image-page ownership and glyph
 drawing in both backends. UI components belong to the UI package.
 
-Since 2.5.4, SoundChannel schedules Web Audio repeats through one native looping
+SoundChannel schedules Web Audio repeats through one native looping
 source. Finite total counts end on the audio clock, independently of JavaScript
 completion callbacks. HTML unlimited fallback uses native looping; finite
 fallback transitions remain browser-timed. See [audio playback](audio-playback.md)
 for count/offset semantics, lifecycle, asset boundaries and verification.
 
-Since 2.4.0, `DisplayObject.flipX`/`flipY` reflect around a local frame center
+`DisplayObject.flipX`/`flipY` reflect around a local frame center
 independently of authored scale and anchors. `matrix` exposes the authored
 transform; `$getMatrix()` supplies the effective reflection transform to
 rendering and coordinate conversion. UI provides its validated layout frame
@@ -32,7 +32,7 @@ through `$getFlipBounds()`. See [centered flips](centered-flips.md) for frame,
 scrolling, caching and consumer requirements.
 
 TextField uses Unicode 17.0 line-break rules with dictionary and overflow
-tailoring. Since 2.2.1, tailoring uses imported rule identities, and layout
+tailoring. Tailoring uses imported rule identities, and layout
 filters optional break positions through `Intl.Segmenter` grapheme boundaries.
 Word and grapheme segmenters are cached; paragraph results remain local to
 each layout. See [text layout](text-layout.md).

package/docs/audio-playback.md

@@ -1,9 +1,6 @@
 # Sound playback and continuous loops
 
-Core 2.5.4 is published, verified on npm on 2026-10-12, including latest, download,
-registry integrity and generated modules matching the tested build. It fixes
-continuous Web Audio looping; published Core 2.5.3 lacks this correction.
-SDK dependency ranges and development locks are unchanged. Native Sound loads through
+Native Sound loads through
 Web Audio when available and decodable, with HTMLAudioElement as a fallback. `Sound.type` labels
 music/effects; it does not select a different loop implementation.
 
@@ -41,24 +38,13 @@ fallback playback retains ended-based counting because HTMLAudioElement does not
 offer a sample-accurate finite repeat count. Sample-continuous finite looping is
 a Web Audio guarantee; fallback transitions depend on browser media behavior.
 
-## Audio assets and adoption
+## Audio assets
 
 Continuous scheduling does not trim silence, repair musical phrasing, remove
 waveform discontinuities or apply a crossfade. MP3 encoder delay/padding handling
 belongs to the browser decoder. Prepare seamless source material as needed; the
 runtime reproduces the decoded samples at their original loop boundary.
 
-Applications adopt published 2.5.4 through their Core installation/
-lock and rebuild. Compatible ranges such as `^2.5.3` already accept it; exact
-Core pins require an explicit declaration update. Existing Core 2.x peers,
-including UI 3.6.0's ^2.5.2, accept 2.5.4 without new SDK versions or raised peer
-minima. Development lock adoption is optional. UI, Game, DragonBones, Spine,
-runtime, CLI and the document kernel have no API migration.
-Editor 0.28.5, Reskin, the selected Tentax/MilfMaster templates and demo/game
-examples adopt registry 2.5.4 with matching app locks and rebuilt outputs. Other
-SDK development and independent Reskin project installations retain their own
-baselines. Isolated verification does not edit application sources or audio assets.
-
 ## Verification
 
 Unit tests cover counts, offsets, volume, position, completion, cleanup and HTML
@@ -75,18 +61,3 @@ KUROT_AUDIO_FIXTURE=/absolute/path/to/gameplay.mp3 \
 ```
 
 The optional MP3 remains application-owned and is not copied into the SDK.
-
-On 2026-10-12, the build and all 941 unit tests pass, including 41 audio tests;
-all 22 minified browser checks pass. Tentax's gameplay.mp3 decodes to 2,016,000
-frames at 44.1 kHz (45.714285714 seconds). Unlimited and two-play rendering insert
-zero missing frames; the maximum difference from directly repeated decoded PCM
-after the 0.6 gain is 4.77e-8. Finite output stops at the exact expected boundary.
-An isolated minified bundle of Tentax's unchanged SoundMusicManager with built
-checkout Core crosses the real-time music boundary on one source, even with a
-200 ms control-thread stall at the join. The verification output is muted.
-
-After registry adoption, Tentax minified release 261012182738 passes the same
-unlimited/two-play MP3 sample comparisons using its generated Core chunk and
-copied runtime MP3. It uses one looping source, inserts zero missing frames,
-retains the 4.77e-8 maximum gain-rounding difference and stops finite output
-at the exact boundary. Application source audio and authored Skins are retained.

package/docs/bitmap-fill.md

@@ -1,8 +1,5 @@
 # Bitmap fill modes
 
-Core 2.3.3 is published. Version 2.3.2 stretches all fill modes;
-adopt the patch and rebuild to receive this correction.
-
 `Bitmap.fillMode` also controls UI `Image` rendering:
 
 | Mode | Behavior |
@@ -35,15 +32,7 @@ invalid periods, fractional dimensions and nine-slice precedence. The minified
 native Canvas patterns on Canvas/WebGL 1/WebGL 2 at 1x/2x, including rotation,
 tint, cache updates and the existing scale path.
 
-The Core 2.5.0 [texture density extension](texture-density.md) additionally
+[Texture density](texture-density.md) additionally
 tests source densities 1×/2×/3× at both output resolutions. Physical atlas sampling
 and logical repeat periods remain separate, including tinted cached images and
-nine-slice texture swaps. Published 2.4.0 does not interpret sheet density metadata.
-
-There are no new APIs or dependencies. UI 3.3.0/runtime 0.9.0 and
-Game/DragonBones/Spine peers accept this patch without SDK bumps. Current
-UI 3.4.0/runtime 0.10.0 require Core ^2.4.0 for centered flips; that release
-includes the fill correction. Optional development lock adoption is separate. Editor's local
-0.23.1 trial bound one built Core through `KUROT_CORE_PATH` while retaining its
-published 2.3.2 dependency lock. Editor 0.23.2 adopts registry Core 2.3.3 and
-updates its Bun lock; ordinary builds no longer require a local engine checkout.
+nine-slice texture swaps.

package/docs/bitmap-fonts.md

@@ -1,10 +1,5 @@
 # Bitmap fonts
 
-Available in Core 2.2.0 with the published `@kurot/bitmap-font ^0.1.0` dependency.
-Package installs and local builds resolve the font kernel from npm. Installed
-Core 2.1.1 does not include FontAnalyzer or BitmapText rendering; update Core and
-the lockfile to receive them. Source versions alone do not confirm publication.
-
 A bitmap font is a descriptor plus a full image page. Core owns image loading and
 rendering; @kurot/bitmap-font owns validation, parsing, serialization and layout.
 See [the shared format](../../bitmap-font/docs/format.md).
@@ -55,7 +50,7 @@ layout caches assume data does not mutate. Glyph subtextures are borrowed views.
 
 BitmapText has text/font, lineSpacing/letterSpacing, smoothing, multiline,
 left/center/right textAlign and top/middle/bottom verticalAlign. The default is
-multiline=true. Published Core 2.5.3 defaults verticalAlign to middle; published
+multiline=true. Core >= 2.5.3 defaults verticalAlign to middle; Core
 2.5.2 and earlier default to top. BitmapLabel inherits its host BitmapText default.
 Explicit top/bottom remain effective in either line mode. Core passes the selected
 alignment into the unchanged headless kernel, whose standalone layout default
@@ -70,8 +65,7 @@ Width and height are constraints, not scales; set scaleX/scaleY to resize font
 art. NaN removes a dimension constraint. Height admits complete line boxes;
 multiline=false draws the first hard-separated line without width wrapping.
 Explicit zero height draws nothing. Default textureScaleFactor=1 is required for
-font assets in this initial implementation.
-The Core 2.5.0 texture-density extension keeps literal font metrics separate:
+font assets. Texture density keeps literal font metrics separate:
 BitmapFont page textures require resolution=1. See [texture density](texture-density.md).
 
 WebGL's BitmapTextPipe submits cropped glyph quads to ordinary texture batching,
@@ -81,14 +75,11 @@ use that Canvas path. Both honor font offsets without allocating child nodes.
 Changing text/font/metrics invalidates layout and rendering, including an
 existing WebGL instruction without a scene rebuild.
 
-Core 2.2.0 fixes BitmapText's previous setter-only width/height accessors.
 BitmapText.EMPTY_FACTOR is retained as a deprecated field; per-font spaceAdvance
-now controls fallback spaces. Line-height, trailing-advance and complete-line
-clipping follow the shared
-format contract rather than the old unrendered class's approximate measurements.
+controls fallback spaces. Line-height, trailing-advance and complete-line
+clipping follow the shared format contract.
 
-UI 3.2.0 introduced native BitmapLabel; UI 3.1.0 does not include it. Current
-UI 3.4.0 retains it and requires Core ^2.4.0. Published document 0.13.0, CLI
-3.5.0 and runtime 0.10.0 support font authoring, compilation and materialization;
-existing installed compilers do not gain a new tag automatically. See
-[BitmapLabel](../../ui/docs/bitmap-label.md) for the feature's introduction versions.
+UI BitmapLabel adds native constraints and asynchronous configured-font loading.
+CLI and semantic runtime integrations use registered font resources; see
+[BitmapLabel](../../ui/docs/bitmap-label.md) and the
+[authoring contract](../../ui-document/docs/text-components.md).

package/docs/centered-flips.md

@@ -1,6 +1,6 @@
-# Centered display flips (Core 2.4.0)
+# Centered display flips
 
-Core 2.4.0 is published, verified on npm on 2026-10-09. `flipX` and `flipY` are boolean DisplayObject
+`flipX` and `flipY` are boolean DisplayObject
 properties, defaulting to false and inherited by all display subclasses.
 
 ```ts
@@ -9,7 +9,7 @@ sprite.scaleX = 0.5;
 ```
 
 Reflection uses the local content bounds center, including nonzero origins.
-UI 3.4 supplies the actual unscaled layout frame instead. A scrollRect uses its
+UI supplies the actual unscaled layout frame instead. A scrollRect uses its
 visible viewport. Authored position, scale, rotation, skew and anchors are
 preserved. Negative scale continues to act around the authored anchor; combining
 negative scale and a centered flag applies both. Resizing/content changes update
@@ -23,12 +23,6 @@ only when a display subclass owns a different local reflection frame.
 
 Canvas/WebGL rendering, local/global coordinate conversion, hits, clips,
 display-list caches and render groups use that effective transform. External
-masks retain their independent coordinates. No existing negative-scale skin or
-application is converted automatically. Core keeps bitmap-font ^0.1.0 and needs
-no new runtime dependency. UI alone requires a new Core minimum when adopting
-its frame hook; other SDKs with Core 2.x peers can adopt Core optionally.
-
-The repository [adoption contract](../../../docs/centered-flips.md) records
-headless/compiler/runtime versions and publication order. UI development now
-installs registry Core 2.4.0 without local overrides. UI 3.4.0 and document
-0.13.0, CLI 3.5.0 and runtime 0.10.0 are also published. Consumers adopt each installation/lock explicitly and rebuild.
+masks retain their independent coordinates. Negative scale and centered flags remain separate authored operations. See the
+[shared flip contract](../../../docs/centered-flips.md) for authoring, runtime
+integration and current verification scope.

package/docs/game-authoring.md

@@ -1,9 +1,7 @@
 # Make a game with Kurot
 
-This guide is for game authors and models using the public SDK. It is an
-unreleased documentation addition, verified against registry Core 2.5.4; that
-published artifact does not yet include this file. Read installed declarations
-for APIs, then open only the topic guides needed by the current task.
+Use the public SDK and the consumer project's own README, declarations and
+bundled topic guides. This workflow needs no engine source in the game project.
 
 ## 1. Establish the project and its baseline
 
@@ -23,6 +21,12 @@ reproduction and preserve the chosen SDK versions while developing gameplay.
 CLI-compiled skins run through UI without ui-runtime. ui-document is headless;
 the game starter uses it for project styles, not as a rendering engine.
 
+For authored game UI, use the repository's
+[standard UI workflow](../../ui/docs/ui-authoring.md), including its directory
+map and paired ScoreHUD example. Those new guides postdate UI 3.6.1; use the
+repository copy until a later package includes them. The installed UI API
+reference remains the source for exact methods and properties.
+
 For a complete reference in an engine checkout, read
 [Star Catcher](../../../examples/star-catcher/README.md) and run its `pnpm check`.
 It demonstrates input → score → three misses → end → restart → cleanup with
@@ -43,6 +47,9 @@ app.start(root);
 ```
 
 `createPlayer` initializes capabilities, rendering, input and screen adaptation.
+CLI pages can use `createPlayer({ canvas })` with the defaults described in
+[stage configuration](stage-configuration.md). This requires Core >= 2.6.0
+within 2.x; keep explicit options with older installations.
 When customizing CLI-authored HTML, retain its import-map, stage and entry-script
 placeholders; the CLI validates all of them before generating the page.
 One Player owns the page's runtime hooks. Keep its canvas parent sized: the

package/docs/resource.md

@@ -190,7 +190,7 @@ Load a plain-text file through `HttpRequest`.
 const text = resource.get<string>('readme');
 ```
 
-### FontAnalyzer (2.2.0)
+### FontAnalyzer
 
 Load a font descriptor and its image page, resolved relative to the descriptor,
 and return a `BitmapFont`. Supported formats are Egret JSON `.fnt`, native JSON
@@ -227,7 +227,7 @@ Load a sprite sheet in TexturePacker JSON format in two steps:
 The Core 2.5.0 [texture density extension](texture-density.md) accepts optional
 sheet JSON `resolution` (default 1). Frame coordinates and original dimensions
 in JSON remain physical pixels; loaded Texture dimensions and trim offsets are
-logical. Published Core 2.4.0 does not interpret this field.
+logical.
 
 Resources can be retrieved in three ways:
 
@@ -291,7 +291,7 @@ Applications normally use `Resource.loadGroup()` instead of accessing
 
 ## Configuration format
 
-### Standard format (2.0.0)
+### Standard format
 
 ```json
 {

package/docs/stage-configuration.md

@@ -0,0 +1,76 @@
+# Canvas stage configuration
+
+`createPlayer()` resolves each startup stage setting independently:
+
+1. An explicitly supplied option.
+2. Its corresponding canvas attribute.
+3. The existing default shown below.
+
+| Option | Canvas attribute | Default without either |
+| --- | --- | --- |
+| `contentWidth` | `data-content-width` | `canvas.width`, or 640 when zero |
+| `contentHeight` | `data-content-height` | `canvas.height`, or 1136 when zero |
+| `scaleMode` | `data-scale-mode` | `showAll` |
+| `orientation` | `data-orientation` | `auto` |
+| `frameRate` | `data-frame-rate` | 60 |
+
+This behavior requires Core >= 2.6.0 within 2.x. CLI 3.8.0's game and empty
+templates use canvas-only startup; publish Core 2.6.0 before CLI 3.8.0 so new
+projects can install the required runtime. Older installations keep explicit
+stage options until adopting that Core release.
+
+For CLI-authored pages, put the defaults in `kurot.config.ts` or `.js`:
+
+```ts
+export default {
+  stage: {
+    width: 1136,
+    height: 640,
+    scaleMode: 'showAll',
+    orientation: 'landscape',
+    frameRate: 60,
+  },
+};
+```
+
+The CLI writes these values into the HTML canvas. The browser entry only needs:
+
+```ts
+import { createPlayer, Sprite } from '@kurot/core';
+
+const canvas = document.getElementById('gameCanvas');
+if (!(canvas instanceof HTMLCanvasElement)) {
+  throw new Error('Missing gameCanvas.');
+}
+const app = createPlayer({ canvas });
+app.start(new Sprite());
+```
+
+An explicit `createPlayer({ canvas, frameRate: 30 })` overrides only the frame
+rate. It also bypasses validation of that attribute. Consumed width/height
+attributes must be finite and positive; frame rate must be a positive integer.
+Scale modes use `StageScaleMode`; orientations use `OrientationMode`, including
+`landscapeFlipped`. Invalid consumed attributes throw before Player allocation.
+
+Attributes are read once. Editing them does not reconfigure a live Player.
+With CLI stage watching, save configuration, wait for its successful update,
+then manually refresh the browser. A new Player reads the new page defaults.
+Existing ScreenAdapter sizing, logical coordinate rounding and DPR behavior
+remain unchanged; these are design dimensions, not backing-store pixel sizes.
+
+Core does not load the CLI or import project configuration. Non-CLI applications
+can supply explicit options or author the same canvas attributes themselves.
+
+## Verification
+
+After building both `packages/core` and `packages/cli`, run from Core:
+
+```sh
+pnpm test:stage-config
+pnpm test:stage-config --canvas
+```
+
+The real CLI/browser check uses the empty template, edits stage defaults on the
+same dev process, manually reloads the page and inspects the resulting Stage.
+It also covers invalid-config retention/recovery, explicit overrides and release
+startup, using built Core/CLI without modifying consumer locks.