@kurot/core 2.5.5 → 2.6.0

package/README.md

@@ -1,222 +1,35 @@
 # @kurot/core
 
-**2.5.4 is published**, verified on npm on 2026-10-12, including latest, package
-download and registry integrity. All 628 generated files match the tested build.
-It fixes continuous Web Audio loops while preserving `Sound.play(startTime, loops)`
-semantics. Published 2.5.3 lacks this audio correction. See [CHANGELOG.md](CHANGELOG.md).
-
-A modern rewrite of the Egret game engine. Maintains Egret-compatible display object and event APIs while upgrading the rendering architecture, type safety, and tooling.
-
-> **Package version: 2.5.5 (prepared, not published).** Documentation-only patch over 2.5.4. Targets ES2022 and evergreen browsers (Chrome / Edge / Firefox / Safari). No IE / old-Android / pre-2022 Safari support shims.
-
-## API reference in 2.5.5 (not published)
-
-Find capabilities in [API topics](docs/api/topics.md), names in the
-[symbol index](docs/api/index.md), and individual members through each symbol's
-page. [Coverage](docs/api/coverage.md) distinguishes declaration coverage from
-remaining behavioral-comment gaps. Examples are checked with strict TypeScript.
-The generated reference is included by this checkout's package configuration;
-existing registry artifacts are unchanged. The 2.5.5 patch changes comments and
-distributed documentation, with no runtime/signature/export changes. Existing
-peer ranges still apply; other SDKs and applications need no upgrade for it.
-
-## Continuous audio loops in 2.5.4
-
-Core 2.5.4 loops Web Audio through one native source, with
-finite counts ending on the audio clock. Existing `sound.play(startTime, loops)`
-semantics remain: `loops <= 0` is unlimited, positive `loops` counts total plays,
-and the offset applies only to the first play. Position wraps per iteration;
-manual stop suppresses completion and releases nodes. HTML unlimited playback
-uses native looping; finite HTML fallback retains browser-dependent transitions.
-
-Update the application's Core installation/lock to published 2.5.4 and
-rebuild to adopt the fix. Exact Core pins require an explicit declaration update;
-compatible ranges such as `^2.5.3` already accept it. SDK peers and development
-locks remain unchanged; UI/Game/DragonBones/Spine/runtime need no new release.
-No new dependency or public API is introduced.
-See [audio playback](docs/audio-playback.md) for asset boundaries and tests.
-
-## Default middle alignment in 2.5.3
-
-TextField and BitmapText default to `verticalAlign = "middle"`, inherited by UI
-Label, RichLabel, BitmapLabel and EditableText. TextInput's text skin parts inherit
-the same host default. Explicit top/bottom and named skin states stay effective.
-`multiline` controls hard breaks and wrapping; changing line mode or input type
-does not choose an alignment. `verticalCenter` positions a component's box in its
-parent and remains independent of text alignment inside that box.
-
-Dynamic text keeps the unified glyph block introduced in 2.5.2. Input centers
-stable editing rows, including the caret, selection and composition underline;
-overflowing input retains its existing top-aligned scrolling. BitmapText centers
-its bitmap-font line frame. Nominal measurement and font-fitting sizes are unchanged.
-
-Content that omitted alignment may move within a taller box. Set
-`verticalAlign = "top"` explicitly when it should start at the top, such as a
-paragraph in a fixed-height region. No XML is rewritten automatically.
-Authoring catalog defaults match in published ui-document 0.13.1; the headless
-bitmap-font kernel is unchanged. Adopt Core 2.5.3 in the
-application installation/lock and rebuild. Existing SDK peers accept it without
-new SDK releases or higher minima. See [text layout](docs/text-layout.md#default-middle-alignment-core-253).
-
-## Unified vertical alignment in 2.5.2
-
-Dynamic `top`, `middle` and `bottom` align one complete glyph block to the top,
-center or bottom of the TextField. They use the same boundaries in both line modes,
-including rich runs and fallback glyphs. Blank rows retain their space; outlines
-are render-only. `multiline` controls only hard breaks and wrapping. TextField and
-ordinary UI Label default to top in 2.5.2; button skins set `verticalAlign="middle"`
-on their caption Labels explicitly. `verticalCenter` positions the Label itself
-in its parent and does not replace text alignment inside that Label.
-
-Input uses stable editing-row bounds for all three alignments, preserving caret,
-selection, composition and scrolling. Overflowing input rows remain top-aligned
-for editing. Layout measurements and font fitting stay nominal. Dynamic top/bottom
-captions may move compared with 2.5.1. Update the application installation/lock and
-rebuild; existing SDK peers accept 2.5.2 without new releases.
-No installed Editor/game is upgraded by this source change.
-See [text alignment](docs/text-layout.md#unified-vertical-alignment-core-252).
-
-## Published middle alignment in 2.5.1
-
-`multiline` controls hard breaks and wrapping. Dynamic `verticalAlign = "middle"`
-centers the complete glyph block in either line mode, including rich text and
-fallback fonts. Blank rows retain their space; relative baselines and line
-spacing remain unchanged. Identical single-row content centers identically
-with either `multiline` value. Input keeps stable editing rows, including its
-caret, selection and composition underline. Top/bottom alignment and nominal
-measurement sizes retain their contracts.
-
-Existing multiline middle-aligned captions may move. Adopt Core 2.5.1
-and rebuild the application; existing SDK peers accept the patch
-without new releases. This source change does not update installed Editors or
-games. See [text alignment](docs/text-layout.md#middle-alignment-independent-of-line-mode-core-251).
-
-## Text alignment correction in 2.5.0
-
-Published 2.5.0 centers single-line dynamic middle alignment by measured glyph
-ink, including fallback fonts and accents. Its multiline text and input retain
-font-frame alignment; rich runs share an alphabetic baseline. Version 2.5.1
-extends visual middle alignment to multiline dynamic text. Layout sizes and wrapping stay nominal.
-The existing font-readiness invalidation refreshes these cached metrics.
-See [text alignment](docs/text-layout.md#visual-centering-and-stable-baselines-core-250).
-Install Core 2.5.0 and rebuild to adopt it; published 2.4.0
-does not include the correction. Existing SDK peer ranges require no change.
-
-## Bitmap fill correction in 2.3.3
-
-`Bitmap.fillMode` / UI `Image.fillMode` now honor `repeat` and `clip` in both
-backends and bitmap caches. Repeat uses the original texture dimensions, including
-transparent trim margins; partial edge tiles are cropped rather than stretched.
-Nine-slice remains active only for `scale`. No XML or resource migration is needed.
-Core 2.3.3 is published; Core 2.3.2 does not include this fix. UI 3.3.0/runtime
-0.9.0 and Game/DragonBones/Spine peers accept it without SDK bumps. Current
-UI 3.4.0/runtime 0.10.0 require Core ^2.4.0, which includes it. Applications adopt
-its installation/lock and rebuild; templates are not rewritten.
-See [bitmap fill modes](docs/bitmap-fill.md).
-
-## Text outline fix in 2.3.2
-
-Version 2.3.2 preserves dynamic TextField outlines beyond the layout box in
-Canvas drawing, WebGL text textures, display-list caches, filter captures and
-object-mask buffers. Rich-text run strokes are included. Layout measurements,
-wrapping and alignment retain their existing dimensions; input viewports and
-external clips remain exact. This fix is not included in published 2.3.1.
-No API or resource-format migration is required. UI 3.3.0/runtime 0.9.0 and
-Game/DragonBones/Spine peers accept the patch without SDK bumps. Current
-UI 3.4.0/runtime 0.10.0 require Core ^2.4.0, which includes it.
-Update the application's installation and lockfile, then rebuild; existing
-bundled Editor Apps retain their old Core until rebuilt.
-See [text layout](docs/text-layout.md#text-outlines-core-232).
-
-## Blank rich-text lines in 2.3.1
-
-An unstyled blank run between styled runs now uses the TextField base font size,
-matching other unstyled content, rather than borrowing a later run's size.
-Core 2.3.1 is published as a compatible patch. Consumers whose Core peer range
-accepts it need no SDK bump. Current UI 3.4.0/runtime 0.10.0 require Core ^2.4.0,
-which includes the correction.
-
-## Independent text measurement in 2.3.0
-
-```ts
-const metrics = textField.measureText(240);
-const naturalSize = textField.measureText(); // NaN: no width constraint
-```
-
-Measurements honor rich-text runs, wrapping and line spacing without changing
-rendered bounds, line caches or scrolling. Height is the complete content height
-before clipping. Rich-text lines use their actual run sizes, including blank
-lines. Assigning `text` clears a previous `textFlow`, even for an identical string.
-See [text layout](docs/text-layout.md) for font-readiness and width contracts.
-
-Core 2.3.1 is published.
-UI 3.3.0 adds RichLabel using this API; other existing Core 2.x consumers do not
-need package version bumps merely to accept Core 2.3.0.
-
-## Text wrapping fixes in 2.2.1
-
-TextField wrapping remains functional when a bundler renames functions.
-Dictionary wrapping and alphabetic overflow no longer depend on Unicode rule
-function names. Both word wrapping and `wordWrap = false` keep grapheme
-clusters intact, including family emoji, flags, skin-tone modifiers and combining
-marks. A cluster wider than the field can overflow intact. Source and input
-indices continue to use UTF-16 offsets.
-
-The patch adds no public API, runtime dependency or resource/KUI format change.
-The existing UI 3.2.0, Game 2.0.0, ui-runtime 0.8.2 and DragonBones 0.1.0 peer
-ranges accept it. Update the installed Core version and lockfile to receive
-the fixes; see [text layout](docs/text-layout.md).
-
-## Fractional viewport clipping in 2.5.0
-
-Axis-aligned WebGL clips now floor their left/top physical edges and ceil their
-right/bottom edges before calculating scissor dimensions. This preserves boundary
-pixels when a scaled UI list or another viewport lands between pixels, avoiding
-cut-off nine-slice outlines. Scissor precision remains one physical pixel; nested
-or rotated clips retain the stencil path. No skin padding or layout change is
-required. Published Core 2.4.0 does not include this correction.
-
-## Scroll clipping in 2.1.1
-
-WebGL keeps a `scrollRect` viewport fixed when it is nested inside another clip
-or rotated. Its `x`/`y` move the content; they do not move the viewport boundary.
-This fixes the shifted visible area in nested UI Scrollers, including Editor
-Preview. Rectangular masks keep their own local origin.
-
-This patch changes no public API, text behavior or resource/KUI format, and
-requires no project migration. The UI 3.1, game 2.0 and ui-runtime 0.8 peer ranges
-accept it; update the installed Core version and lockfile to receive the fix.
-UI Scrollers use the corrected Core path without a separate UI release.
-
-## Text layout in 2.1.0
-
-Explicit `TextField.multiline = false` now renders only the first hard-separated
-line, without width wrapping. Dynamic text defaults to multiline and input text
-to single-line until the flag is assigned. Fixed height clips drawing without
-changing the measured line count. If an older skin set `multiline="false"` but
-expected wrapping, remove that flag or set it to `true`; files are not migrated
-automatically.
-
-Load fonts before measuring text. If a font becomes ready later, call
-`textField.invalidateTextMetrics()` to refresh cached measurements even when its
-family name is unchanged. See the [Core text contract](docs/text-layout.md).
-Automatic Label font shrinking is a separate UI capability and requires the
-matching UI release; Core does not expose `textFit` or `minFontSize`.
+TypeScript / ESM / ES2022 display, rendering, events, text, resources and media
+for browser games. Package version: **2.6.0** (prepared; publication pending).
+
+Start with the [game authoring guide](docs/game-authoring.md),
+[API topics](docs/api/topics.md) or [symbol index](docs/api/index.md). Read only
+the relevant symbol/member pages; installed packages include public declarations
+and docs without requiring the engine source.
+
+| Contract | Guide |
+| --- | --- |
+| Text wrapping, alignment, measurement and fonts | [Text layout](docs/text-layout.md) |
+| Texture units, density and atlas frames | [Texture density](docs/texture-density.md) |
+| Bitmap scale, repeat and clip | [Bitmap fill](docs/bitmap-fill.md) |
+| Audio time units, loops and channel cleanup | [Audio playback](docs/audio-playback.md) |
+| Resources, manifests and errors | [Resource loading](docs/resource.md) |
+| Shader and filter ownership | [Filters](docs/filters.md) |
 
 ## Installation
 
-Until 2.5.5 is published, install the recorded published baseline below. Its
-runtime supports the same APIs; use repository docs for the new reference.
+The package includes the generated API reference and game authoring guide.
+Canvas stage-attribute startup requires Core >= 2.6.0 within 2.x.
 
 ```bash
-pnpm add @kurot/core@^2.5.4
+pnpm add @kurot/core@^2.6.0
 ```
 
 Core depends on `@kurot/bitmap-font ^0.1.0` for bitmap-font data and shared
 layout. Package installation resolves this dependency from npm. Install other
 Kurot packages separately when the application needs their capabilities.
-Published UI 3.2.0 provides BitmapLabel and requires Core `^2.2.0`;
-UI 3.1.0 does not contain this component.
+UI provides BitmapLabel when the application needs native bitmap-font UI layout.
 
 ## Features
 
@@ -305,42 +118,10 @@ The rendering pipeline borrows concepts from Pixi.js 8 while keeping the Egret d
 | WebGL state management                | Egret     | DrawCmdManager batching command queue                           |
 | Mask strategies                       | Egret     | scissor / stencil / offscreen compositing                       |
 
-## Validated renderer comparison
-
-Kurot 1.0.15 was compared with PixiJS 8.20.0 and Egret 5.4.1 across seven
-deterministic workloads. The complete run used headless Chromium 151.0.7922.34
-on an Apple M1 Max, an 800×600 surface at DPR/resolution 1, 60 warmup frames,
-300 measured frames, five fresh browser contexts per case, and 175 total cases.
-
-| WebGL 2 workload   | Objects | Frame P95 Kurot / PixiJS | Render P95 Kurot / PixiJS | Draw calls Kurot / PixiJS |
-| ------------------ | ------: | -----------------------: | ------------------------: | ------------------------: |
-| Sprite batch       |     500 |           16.8 / 17.2 ms |              0.2 / 0.2 ms |                     1 / 1 |
-| Mixed textures     |     500 |           17.0 / 17.1 ms |              0.3 / 0.2 ms |                     1 / 1 |
-| Dynamic transforms |     300 |           17.1 / 17.1 ms |              0.3 / 0.2 ms |                     1 / 1 |
-| Deep container     |     500 |           17.1 / 17.1 ms |              0.3 / 0.2 ms |                     1 / 1 |
-| Rapid churn        |     500 |           17.0 / 17.0 ms |              0.3 / 0.3 ms |                     1 / 1 |
-| Texture swap       |     500 |           16.8 / 16.8 ms |              0.3 / 0.2 ms |                     1 / 1 |
-| Filter heavy       |      50 |           25.0 / 17.9 ms |              0.7 / 0.4 ms |                 200 / 150 |
-
-The result supports a narrow conclusion: Kurot's sprite/container batching is
-competitive in these six ordinary workloads, while PixiJS has a small
-renderer-call advantage in several cases and is clearly ahead in the measured
-filter workload. Kurot's next renderer priority is reducing filter passes and
-offscreen-composition cost.
-
-It does not establish overall PixiJS feature parity, mobile performance, or a
-memory advantage. Most ordinary cases are close to browser refresh cadence, so
-they demonstrate batching and the absence of obvious stalls more strongly than
-they distinguish CPU limits. Canvas2D/WebGL1/WebGL2 golden tests and manual
-checks on macOS Chrome, Windows Chrome/Firefox, recent iOS browsers, and a
-recent Android Chrome device provide correctness evidence, not cross-device
-performance rankings.
-
 ## Quick Start
 
 For a complete gameplay loop, read the [game-authoring guide](docs/game-authoring.md)
-and the repository's Star Catcher reference project. The guide is included in
-the prepared 2.5.5 patch; the published 2.5.4 artifact retains its original contents.
+and the repository's [Star Catcher reference project](../../examples/star-catcher/README.md).
 
 ```typescript
 import { createPlayer, Sprite, Shape } from '@kurot/core';
@@ -370,6 +151,9 @@ root.addChild(rect);
 ```
 
 `createPlayer()` automatically uses the device pixel ratio, capped at `2`.
+Stage defaults can also come from canvas attributes emitted by the CLI; see
+[stage configuration](docs/stage-configuration.md) for precedence, validation
+and the Core >= 2.6.0 requirement.
 Pass `resolution` explicitly when a project needs a different sharpness and
 GPU-memory tradeoff. Individual `TextField` instances can also override their
 raster density through `textField.resolution`. The value can be changed while
@@ -381,7 +165,7 @@ their cached sampling scale is capped at 8× to bound zoom-related memory use.
 The Core 2.5.0 [texture density API](docs/texture-density.md) adds independent
 source density through `new Texture(2)` and sheet JSON `resolution: 2`.
 High-density images retain logical dimensions and nine-slice corners while
-sampling physical atlas pixels. Published Core 2.4.0 does not contain this API.
+sampling physical atlas pixels.
 
 ## Multilingual text
 
@@ -403,7 +187,7 @@ pnpm run dev          # watch mode
 
 ## Documentation
 
-- [Game authoring](./docs/game-authoring.md) — short consumer path through input, time, rules, restart, cleanup and acceptance checks (unreleased)
+- [Game authoring](./docs/game-authoring.md) — short consumer path through input, time, rules, restart, cleanup and acceptance checks
 - [CHANGELOG.md](./CHANGELOG.md) — versioned release notes, including the full list of 1.0.0 breaking changes
 - [Architecture](./docs/architecture.md) — engine structure and rendering pipeline
 - [Resource system](./docs/resource.md) — resource configuration, loading, and lifecycle
@@ -505,24 +289,13 @@ does not replace the manual checks on physical devices.
 
 MIT
 
-## Resource manifest migration in 2.0.0
-
-Sheet `subkeys` now maps each frame name to a metadata object instead of using
-a comma-separated string. Old manifests fail validation before any resource
-is registered. Refresh every old sheet explicitly in Kurot Editor before using
-the new Core and CLI. Core indexes the frame aliases; `scale9grid` metadata is
-applied to UI Images by the compiler or document resolver, not automatically
-to arbitrary `Bitmap` objects. See the
-[resource format](docs/resource.md) and
-[nine-slice contract](../ui-document/docs/resource-nine-slice.md).
+## Resource manifests
 
-The optional `resource/config/style.json` is handled by current document 0.13.0 and
-CLI 3.5.0, including named colors and Label presets. Core does not read this file or interpret `@style:colors:<key>` XML
-references. Compiled skins receive numeric RGB values; the application loads
-fonts before measuring text. See the
-[project style contract](../ui-document/docs/project-styles.md).
+Sheet subkeys are metadata objects. Image/frame grids use logical coordinates;
+see the [resource format contract](../ui-document/docs/resource-nine-slice.md)
+for validation, defaults and authoring rules.
 
-## Bitmap fonts in 2.2.0
+## Bitmap fonts
 
 [Core bitmap fonts](docs/bitmap-fonts.md) use the headless @kurot/bitmap-font
 package for data and layout. Built-in `font` resources load the descriptor and
@@ -534,6 +307,6 @@ Widths/heights are layout constraints; use scaleX/scaleY to resize the artwork.
 Height admits complete lines, and explicit `multiline = false` keeps the first
 hard-separated line unwrapped. `BitmapText.EMPTY_FACTOR` is deprecated in favor
 of `font.data.spaceAdvance`. See the linked contracts before migrating custom
-bitmap-text measurements. Native UI BitmapLabel was introduced in UI 3.2.0;
-current UI 3.4.0, document 0.13.0, CLI 3.5.0 and runtime 0.10.0 include its native,
-authoring, compilation and materialization contracts. Editor adoption is separate.
+bitmap-text measurements.
+UI BitmapLabel, document font references and CLI/runtime font adapters use
+this contract; project resource ownership remains explicit.

package/dist/kurot/player/KurotOptions.d.ts

@@ -1,7 +1,9 @@
 import type { StageScaleMode } from '../display/enums/StageScaleMode.js';
 import type { OrientationMode } from '../display/enums/OrientationMode.js';
 /**
- * Configuration options for initializing the Kurot engine.
+ * Configuration options for initializing the Kurot engine. Stage settings use
+ * explicit options first, then the canvas attributes documented below, then
+ * their original defaults. Attributes are read once when createPlayer is called.
  */
 export interface KurotOptions {
     /**
@@ -9,19 +11,21 @@ export interface KurotOptions {
      */
     canvas: HTMLCanvasElement;
     /**
-     * Frame rate (default: 60).
+     * Target frame rate. Falls back to data-frame-rate, then 60.
      */
     frameRate?: number;
     /**
-     * Stage scale mode (default: 'showAll').
+     * Stage scale mode. Falls back to data-scale-mode, then 'showAll'.
      */
     scaleMode?: StageScaleMode;
     /**
-     * Initial content width in logical pixels.
+     * Initial content width in logical pixels. Falls back to data-content-width,
+     * then canvas.width or 640 when the canvas width is zero.
      */
     contentWidth?: number;
     /**
-     * Initial content height in logical pixels.
+     * Initial content height in logical pixels. Falls back to data-content-height,
+     * then canvas.height or 1136 when the canvas height is zero.
      */
     contentHeight?: number;
     /**
@@ -32,7 +36,7 @@ export interface KurotOptions {
      */
     resolution?: number;
     /**
-     * Screen orientation mode (default: 'auto').
+     * Screen orientation mode. Falls back to data-orientation, then 'auto'.
      */
     orientation?: OrientationMode;
     /**

package/dist/kurot/player/KurotOptions.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"KurotOptions.d.ts","sourceRoot":"","sources":["../../../src/kurot/player/KurotOptions.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,oCAAoC,CAAC;AACzE,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,qCAAqC,CAAC;AAE3E;;GAEG;AACH,MAAM,WAAW,YAAY;IAC5B;;OAEG;IACH,MAAM,EAAE,iBAAiB,CAAC;IAE1B;;OAEG;IACH,SAAS,CAAC,EAAE,MAAM,CAAC;IAEnB;;OAEG;IACH,SAAS,CAAC,EAAE,cAAc,CAAC;IAE3B;;OAEG;IACH,YAAY,CAAC,EAAE,MAAM,CAAC;IAEtB;;OAEG;IACH,aAAa,CAAC,EAAE,MAAM,CAAC;IAEvB;;;;;OAKG;IACH,UAAU,CAAC,EAAE,MAAM,CAAC;IAEpB;;OAEG;IACH,WAAW,CAAC,EAAE,eAAe,CAAC;IAE9B;;OAEG;IACH,UAAU,CAAC,EAAE,MAAM,CAAC;IAEpB;;;;OAIG;IACH,UAAU,CAAC,EAAE,MAAM,CAAC;CACpB"}
+{"version":3,"file":"KurotOptions.d.ts","sourceRoot":"","sources":["../../../src/kurot/player/KurotOptions.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,oCAAoC,CAAC;AACzE,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,qCAAqC,CAAC;AAE3E;;;;GAIG;AACH,MAAM,WAAW,YAAY;IAC5B;;OAEG;IACH,MAAM,EAAE,iBAAiB,CAAC;IAE1B;;OAEG;IACH,SAAS,CAAC,EAAE,MAAM,CAAC;IAEnB;;OAEG;IACH,SAAS,CAAC,EAAE,cAAc,CAAC;IAE3B;;;OAGG;IACH,YAAY,CAAC,EAAE,MAAM,CAAC;IAEtB;;;OAGG;IACH,aAAa,CAAC,EAAE,MAAM,CAAC;IAEvB;;;;;OAKG;IACH,UAAU,CAAC,EAAE,MAAM,CAAC;IAEpB;;OAEG;IACH,WAAW,CAAC,EAAE,eAAe,CAAC;IAE9B;;OAEG;IACH,UAAU,CAAC,EAAE,MAAM,CAAC;IAEpB;;;;OAIG;IACH,UAAU,CAAC,EAAE,MAAM,CAAC;CACpB"}

package/dist/kurot/player/canvas-stage-options.d.ts

@@ -0,0 +1,9 @@
+import type { KurotOptions } from './KurotOptions.js';
+type StageOptions = Required<Pick<KurotOptions, 'contentWidth' | 'contentHeight' | 'scaleMode' | 'orientation' | 'frameRate'>>;
+/**
+ * Read startup defaults once, before allocating Player resources. Explicit
+ * options bypass their corresponding attributes, including malformed ones.
+ */
+export declare function resolveCanvasStageOptions(options: KurotOptions): StageOptions;
+export {};
+//# sourceMappingURL=canvas-stage-options.d.ts.map

package/dist/kurot/player/canvas-stage-options.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"canvas-stage-options.d.ts","sourceRoot":"","sources":["../../../src/kurot/player/canvas-stage-options.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,mBAAmB,CAAC;AAEtD,KAAK,YAAY,GAAG,QAAQ,CAAC,IAAI,CAAC,YAAY,EAAE,cAAc,GAAG,eAAe,GAAG,WAAW,GAAG,aAAa,GAAG,WAAW,CAAC,CAAC,CAAC;AAE/H;;;GAGG;AACH,wBAAgB,yBAAyB,CAAC,OAAO,EAAE,YAAY,GAAG,YAAY,CAS7E"}

package/dist/kurot/player/canvas-stage-options.js

@@ -0,0 +1,39 @@
+import { OrientationMode } from '../display/enums/OrientationMode.js';
+import { StageScaleMode } from '../display/enums/StageScaleMode.js';
+/**
+ * Read startup defaults once, before allocating Player resources. Explicit
+ * options bypass their corresponding attributes, including malformed ones.
+ */
+export function resolveCanvasStageOptions(options) {
+    const { canvas } = options;
+    return {
+        contentWidth: options.contentWidth ?? numberAttribute(canvas, 'data-content-width') ?? (canvas.width || 640),
+        contentHeight: options.contentHeight ?? numberAttribute(canvas, 'data-content-height') ?? (canvas.height || 1136),
+        frameRate: options.frameRate ?? numberAttribute(canvas, 'data-frame-rate', true) ?? 60,
+        scaleMode: options.scaleMode ?? enumAttribute(canvas, 'data-scale-mode', Object.values(StageScaleMode)) ?? StageScaleMode.SHOW_ALL,
+        orientation: options.orientation ?? enumAttribute(canvas, 'data-orientation', Object.values(OrientationMode)) ?? OrientationMode.AUTO,
+    };
+}
+function numberAttribute(canvas, name, integer = false) {
+    const raw = canvas.getAttribute(name);
+    if (raw === null) {
+        return undefined;
+    }
+    const value = Number(raw);
+    if (!raw.trim() || !Number.isFinite(value) || value <= 0 || (integer && !Number.isInteger(value))) {
+        throw new Error(`Invalid canvas ${name}: expected a positive ${integer ? 'integer' : 'finite number'}, got '${raw}'.`);
+    }
+    return value;
+}
+function enumAttribute(canvas, name, values) {
+    const raw = canvas.getAttribute(name);
+    if (raw === null) {
+        return undefined;
+    }
+    const value = values.find(candidate => candidate === raw.trim());
+    if (value === undefined) {
+        throw new Error(`Invalid canvas ${name}: expected ${values.join(', ')}, got '${raw}'.`);
+    }
+    return value;
+}
+//# sourceMappingURL=canvas-stage-options.js.map

package/dist/kurot/player/canvas-stage-options.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"canvas-stage-options.js","sourceRoot":"","sources":["../../../src/kurot/player/canvas-stage-options.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,eAAe,EAAE,MAAM,qCAAqC,CAAC;AACtE,OAAO,EAAE,cAAc,EAAE,MAAM,oCAAoC,CAAC;AAKpE;;;GAGG;AACH,MAAM,UAAU,yBAAyB,CAAC,OAAqB;IAC9D,MAAM,EAAE,MAAM,EAAE,GAAG,OAAO,CAAC;IAC3B,OAAO;QACN,YAAY,EAAE,OAAO,CAAC,YAAY,IAAI,eAAe,CAAC,MAAM,EAAE,oBAAoB,CAAC,IAAI,CAAC,MAAM,CAAC,KAAK,IAAI,GAAG,CAAC;QAC5G,aAAa,EAAE,OAAO,CAAC,aAAa,IAAI,eAAe,CAAC,MAAM,EAAE,qBAAqB,CAAC,IAAI,CAAC,MAAM,CAAC,MAAM,IAAI,IAAI,CAAC;QACjH,SAAS,EAAE,OAAO,CAAC,SAAS,IAAI,eAAe,CAAC,MAAM,EAAE,iBAAiB,EAAE,IAAI,CAAC,IAAI,EAAE;QACtF,SAAS,EAAE,OAAO,CAAC,SAAS,IAAI,aAAa,CAAC,MAAM,EAAE,iBAAiB,EAAE,MAAM,CAAC,MAAM,CAAC,cAAc,CAAC,CAAC,IAAI,cAAc,CAAC,QAAQ;QAClI,WAAW,EAAE,OAAO,CAAC,WAAW,IAAI,aAAa,CAAC,MAAM,EAAE,kBAAkB,EAAE,MAAM,CAAC,MAAM,CAAC,eAAe,CAAC,CAAC,IAAI,eAAe,CAAC,IAAI;KACrI,CAAC;AACH,CAAC;AAED,SAAS,eAAe,CAAC,MAAyB,EAAE,IAAY,EAAE,OAAO,GAAG,KAAK;IAChF,MAAM,GAAG,GAAG,MAAM,CAAC,YAAY,CAAC,IAAI,CAAC,CAAC;IACtC,IAAI,GAAG,KAAK,IAAI,EAAE,CAAC;QAClB,OAAO,SAAS,CAAC;IAClB,CAAC;IACD,MAAM,KAAK,GAAG,MAAM,CAAC,GAAG,CAAC,CAAC;IAC1B,IAAI,CAAC,GAAG,CAAC,IAAI,EAAE,IAAI,CAAC,MAAM,CAAC,QAAQ,CAAC,KAAK,CAAC,IAAI,KAAK,IAAI,CAAC,IAAI,CAAC,OAAO,IAAI,CAAC,MAAM,CAAC,SAAS,CAAC,KAAK,CAAC,CAAC,EAAE,CAAC;QACnG,MAAM,IAAI,KAAK,CAAC,kBAAkB,IAAI,yBAAyB,OAAO,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC,CAAC,eAAe,UAAU,GAAG,IAAI,CAAC,CAAC;IACxH,CAAC;IACD,OAAO,KAAK,CAAC;AACd,CAAC;AAED,SAAS,aAAa,CAAmB,MAAyB,EAAE,IAAY,EAAE,MAAoB;IACrG,MAAM,GAAG,GAAG,MAAM,CAAC,YAAY,CAAC,IAAI,CAAC,CAAC;IACtC,IAAI,GAAG,KAAK,IAAI,EAAE,CAAC;QAClB,OAAO,SAAS,CAAC;IAClB,CAAC;IACD,MAAM,KAAK,GAAG,MAAM,CAAC,IAAI,CAAC,SAAS,CAAC,EAAE,CAAC,SAAS,KAAK,GAAG,CAAC,IAAI,EAAE,CAAC,CAAC;IACjE,IAAI,KAAK,KAAK,SAAS,EAAE,CAAC;QACzB,MAAM,IAAI,KAAK,CAAC,kBAAkB,IAAI,cAAc,MAAM,CAAC,IAAI,CAAC,IAAI,CAAC,UAAU,GAAG,IAAI,CAAC,CAAC;IACzF,CAAC;IACD,OAAO,KAAK,CAAC;AACd,CAAC"}

package/dist/kurot/player/createPlayer.d.ts

@@ -34,6 +34,9 @@ export interface KurotApp {
  * Creates and initializes a Kurot player from the given options.
  * This is the main entry point for starting a Kurot application.
  * Use a single live application and call destroy() when its page/view closes.
+ * Stage settings resolve per field from explicit options, then canvas data-*
+ * attributes, then existing defaults. CLI pages can call createPlayer({ canvas }).
+ * Invalid consumed attributes throw before Player resources are allocated.
  *
  * ```ts
  * import { createPlayer, Sprite } from '@kurot/core';

package/dist/kurot/player/createPlayer.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"createPlayer.d.ts","sourceRoot":"","sources":["../../../src/kurot/player/createPlayer.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,KAAK,EAAE,MAAM,qBAAqB,CAAC;AAG5C,OAAO,EAAE,aAAa,EAAE,MAAM,6BAA6B,CAAC;AAG5D,OAAO,EAAE,MAAM,EAAE,MAAM,aAAa,CAAC;AACrC,OAAO,EAAE,YAAY,EAAE,MAAM,mBAAmB,CAAC;AACjD,OAAO,EAAE,aAAa,EAAE,MAAM,oBAAoB,CAAC;AAGnD,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,mBAAmB,CAAC;AAGtD;;;GAGG;AACH,MAAM,WAAW,QAAQ;IACxB,MAAM,EAAE,MAAM,CAAC;IACf,KAAK,EAAE,KAAK,CAAC;IACb,YAAY,EAAE,YAAY,CAAC;IAC3B,aAAa,EAAE,aAAa,CAAC;IAC7B;;;OAGG;IACH,KAAK,CAAC,IAAI,CAAC,EAAE,aAAa,GAAG,IAAI,CAAC;IAClC;;;OAGG;IACH,IAAI,IAAI,IAAI,CAAC;IACb;;;;OAIG;IACH,OAAO,IAAI,IAAI,CAAC;CAChB;AAED;;;;;;;;;;;;;;;;;;;GAmBG;AACH,wBAAgB,YAAY,CAAC,OAAO,EAAE,YAAY,GAAG,QAAQ,CAqE5D"}
+{"version":3,"file":"createPlayer.d.ts","sourceRoot":"","sources":["../../../src/kurot/player/createPlayer.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,KAAK,EAAE,MAAM,qBAAqB,CAAC;AAC5C,OAAO,EAAE,aAAa,EAAE,MAAM,6BAA6B,CAAC;AAG5D,OAAO,EAAE,MAAM,EAAE,MAAM,aAAa,CAAC;AACrC,OAAO,EAAE,YAAY,EAAE,MAAM,mBAAmB,CAAC;AACjD,OAAO,EAAE,aAAa,EAAE,MAAM,oBAAoB,CAAC;AAGnD,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,mBAAmB,CAAC;AAItD;;;GAGG;AACH,MAAM,WAAW,QAAQ;IACxB,MAAM,EAAE,MAAM,CAAC;IACf,KAAK,EAAE,KAAK,CAAC;IACb,YAAY,EAAE,YAAY,CAAC;IAC3B,aAAa,EAAE,aAAa,CAAC;IAC7B;;;OAGG;IACH,KAAK,CAAC,IAAI,CAAC,EAAE,aAAa,GAAG,IAAI,CAAC;IAClC;;;OAGG;IACH,IAAI,IAAI,IAAI,CAAC;IACb;;;;OAIG;IACH,OAAO,IAAI,IAAI,CAAC;CAChB;AAED;;;;;;;;;;;;;;;;;;;;;;GAsBG;AACH,wBAAgB,YAAY,CAAC,OAAO,EAAE,YAAY,GAAG,QAAQ,CAiE5D"}

package/dist/kurot/player/createPlayer.js

@@ -1,6 +1,4 @@
 import { Stage } from '../display/Stage.js';
-import { StageScaleMode } from '../display/enums/StageScaleMode.js';
-import { OrientationMode } from '../display/enums/OrientationMode.js';
 import { RenderTexture } from '../display/texture/RenderTexture.js';
 import { Matrix } from '../geom/Matrix.js';
 import { Player } from './Player.js';
@@ -9,10 +7,14 @@ import { ScreenAdapter } from './ScreenAdapter.js';
 import { setupLifecycle } from './SystemTicker.js';
 import { CanvasRenderer, CanvasBuffer } from './canvas/index.js';
 import { Capabilities } from '../system/Capabilities.js';
+import { resolveCanvasStageOptions } from './canvas-stage-options.js';
 /**
  * Creates and initializes a Kurot player from the given options.
  * This is the main entry point for starting a Kurot application.
  * Use a single live application and call destroy() when its page/view closes.
+ * Stage settings resolve per field from explicit options, then canvas data-*
+ * attributes, then existing defaults. CLI pages can call createPlayer({ canvas }).
+ * Invalid consumed attributes throw before Player resources are allocated.
  *
  * ```ts
  * import { createPlayer, Sprite } from '@kurot/core';
@@ -30,6 +32,7 @@ import { Capabilities } from '../system/Capabilities.js';
  * ```
  */
 export function createPlayer(options) {
+    const { contentWidth, contentHeight, scaleMode, orientation, frameRate } = resolveCanvasStageOptions(options);
     Capabilities._init();
     if (!RenderTexture.renderer) {
         const _renderer = new CanvasRenderer();
@@ -41,7 +44,7 @@ export function createPlayer(options) {
             return buffer.surface;
         };
     }
-    const { canvas, frameRate = 60, scaleMode = StageScaleMode.SHOW_ALL, contentWidth = canvas.width || 640, contentHeight = canvas.height || 1136, resolution = Math.min(window.devicePixelRatio || 1, 2), orientation = OrientationMode.AUTO, maxTouches = 99, background, } = options;
+    const { canvas, resolution = Math.min(window.devicePixelRatio || 1, 2), maxTouches = 99, background, } = options;
     if (background) {
         canvas.style.backgroundColor = background;
     }

package/dist/kurot/player/createPlayer.js.map

@@ -1 +1 @@
-{"version":3,"file":"createPlayer.js","sourceRoot":"","sources":["../../../src/kurot/player/createPlayer.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"createPlayer.js","sourceRoot":"","sources":["../../../src/kurot/player/createPlayer.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,KAAK,EAAE,MAAM,qBAAqB,CAAC;AAE5C,OAAO,EAAE,aAAa,EAAE,MAAM,qCAAqC,CAAC;AACpE,OAAO,EAAE,MAAM,EAAE,MAAM,mBAAmB,CAAC;AAC3C,OAAO,EAAE,MAAM,EAAE,MAAM,aAAa,CAAC;AACrC,OAAO,EAAE,YAAY,EAAE,MAAM,mBAAmB,CAAC;AACjD,OAAO,EAAE,aAAa,EAAE,MAAM,oBAAoB,CAAC;AACnD,OAAO,EAAE,cAAc,EAAE,MAAM,mBAAmB,CAAC;AACnD,OAAO,EAAE,cAAc,EAAE,YAAY,EAAE,MAAM,mBAAmB,CAAC;AAEjE,OAAO,EAAE,YAAY,EAAE,MAAM,2BAA2B,CAAC;AACzD,OAAO,EAAE,yBAAyB,EAAE,MAAM,2BAA2B,CAAC;AA6BtE;;;;;;;;;;;;;;;;;;;;;;GAsBG;AACH,MAAM,UAAU,YAAY,CAAC,OAAqB;IACjD,MAAM,EAAE,YAAY,EAAE,aAAa,EAAE,SAAS,EAAE,WAAW,EAAE,SAAS,EAAE,GAAG,yBAAyB,CAAC,OAAO,CAAC,CAAC;IAC9G,YAAY,CAAC,KAAK,EAAE,CAAC;IAErB,IAAI,CAAC,aAAa,CAAC,QAAQ,EAAE,CAAC;QAC7B,MAAM,SAAS,GAAG,IAAI,cAAc,EAAE,CAAC;QACvC,aAAa,CAAC,QAAQ,GAAG,CAAC,aAAa,EAAE,KAAK,EAAE,MAAM,EAAE,OAAO,EAAE,OAAO,EAAE,EAAE;YAC3E,MAAM,MAAM,GAAG,IAAI,YAAY,CAAC,KAAK,EAAE,MAAM,CAAC,CAAC;YAC/C,MAAM,CAAC,GAAG,IAAI,MAAM,EAAE,CAAC;YACvB,CAAC,CAAC,SAAS,CAAC,OAAO,EAAE,OAAO,CAAC,CAAC;YAC9B,SAAS,CAAC,MAAM,CAAC,aAAa,EAAE,MAAM,EAAE,CAAC,CAAC,CAAC;YAC3C,OAAO,MAAM,CAAC,OAAO,CAAC;QACvB,CAAC,CAAC;IACH,CAAC;IACD,MAAM,EACL,MAAM,EACN,UAAU,GAAG,IAAI,CAAC,GAAG,CAAC,MAAM,CAAC,gBAAgB,IAAI,CAAC,EAAE,CAAC,CAAC,EACtD,UAAU,GAAG,EAAE,EACf,UAAU,GACV,GAAG,OAAO,CAAC;IAEZ,IAAI,UAAU,EAAE,CAAC;QAChB,MAAM,CAAC,KAAK,CAAC,eAAe,GAAG,UAAU,CAAC;IAC3C,CAAC;IAED,MAAM,KAAK,GAAG,IAAI,KAAK,EAAE,CAAC;IAC1B,KAAK,CAAC,SAAS,GAAG,SAAS,CAAC;IAC5B,KAAK,CAAC,WAAW,GAAG,WAAW,CAAC;IAChC,KAAK,CAAC,UAAU,GAAG,UAAU,CAAC;IAC9B,KAAK,CAAC,SAAS,GAAG,SAAS,CAAC;IAE5B,MAAM,MAAM,GAAG,IAAI,MAAM,CAAC,MAAM,EAAE,KAAK,CAAC,CAAC;IACzC,MAAM,YAAY,GAAG,IAAI,YAAY,CAAC,KAAK,EAAE,MAAM,CAAC,CAAC;IACrD,MAAM,aAAa,GAAG,IAAI,aAAa,CACtC,MAAM,EACN,MAAM,EACN,YAAY,EACZ,YAAY,EACZ,aAAa,EACb,UAAU,CACV,CAAC;IACF,MAAM,gBAAgB,GAAG,cAAc,CAAC,KAAK,CAAC,CAAC;IAC/C,IAAI,SAAS,GAAG,KAAK,CAAC;IAEtB,OAAO;QACN,MAAM;QACN,KAAK;QACL,YAAY;QACZ,aAAa;QACb,KAAK,CAAC,IAAoB;YACzB,IAAI,SAAS;gBAAE,MAAM,IAAI,KAAK,CAAC,6CAA6C,CAAC,CAAC;YAC9E,MAAM,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC;QACpB,CAAC;QACD,IAAI;YACH,MAAM,CAAC,IAAI,EAAE,CAAC;QACf,CAAC;QACD,OAAO;YACN,IAAI,SAAS;gBAAE,OAAO;YACtB,SAAS,GAAG,IAAI,CAAC;YACjB,MAAM,CAAC,OAAO,EAAE,CAAC;YACjB,YAAY,CAAC,OAAO,EAAE,CAAC;YACvB,aAAa,CAAC,OAAO,EAAE,CAAC;YACxB,gBAAgB,EAAE,CAAC;QACpB,CAAC;KACD,CAAC;AACH,CAAC"}