@kurot/core 2.5.3 → 2.5.5

package/CHANGELOG.md

@@ -4,9 +4,79 @@ All notable changes to `@kurot/core` are documented here.
 
 ---
 
+## [2.5.5] — 2026-10-18
+
+Prepared locally; not published. Documentation-only patch over 2.5.4.
+
+### Documentation
+
+- Expand common display, graphics, text, input, timer, texture, audio and network
+  JSDoc with checked defaults, logical/physical units, failure paths and cleanup
+  ownership. Add a timer-disposal example; remove resolved comment-gap exemptions.
+- Add generated public API references, capability/symbol/member indexes,
+  explicit coverage reports and strict-compiled JSDoc examples. Fill in
+  application/resource ownership, ticker identity and texture-density guidance without changing
+  executable code, public signatures or SDK dependencies.
+- Add a short public game-authoring guide and a complete repository Star Catcher
+  reference with deterministic rules, keyboard/touch input, pause, restart and
+  cleanup. Its check command verifies development and release behavior.
+- Correct resource quick-start paths/imports and document the Player stop versus
+  gameplay pause boundary. Runtime implementations, signatures and exports are unchanged.
+
+### Compatibility
+
+- Existing Core peers accept 2.5.5; no consumer migration or raised dependency
+  minimum is required. UI, Game, DragonBones, ui-runtime and compatible Spine
+  adapters need no dependent release for this Core patch.
+- Applications may adopt the documentation after publication, or read repository
+  docs while retaining their installed runtime. SDK/app locks and dependencies
+  are unchanged; no application or template is upgraded by this preparation.
+
+## [2.5.4] — 2026-10-12
+
+Published; npm latest, package download and registry integrity verified on 2026-10-12.
+All 628 generated files match the tested local build.
+
+### Fixed
+
+- Fix Web Audio repeats to use one native looping source, retaining the total
+  `loops` count and first-play offset. Finite playback ends on the audio clock;
+  joins no longer wait for JavaScript ended callbacks.
+- Wrap channel position per iteration, freeze finite completion, suppress queued
+  callbacks after manual stop and release source/gain nodes.
+- Use native HTML looping for unlimited fallback playback; retain finite fallback
+  counting and document its browser-dependent timing limitation.
+- Add unit and minified browser regressions, including sample comparisons with
+  Tentax's application-owned MP3. See [audio playback](docs/audio-playback.md).
+
+### Compatibility
+
+- Preserve existing `Sound.play(startTime, loops)` parameters: non-positive counts
+  are unlimited, positive counts are total plays, and the offset applies only to
+  the first play. No public API, dependency, resource or XML-format change.
+- Existing UI/Game/DragonBones/Spine/ui-runtime peers accept 2.5.4 without new
+  SDK releases or raised minima. SDK development locks are unchanged.
+  Apps adopt published 2.5.4 through their installation/lock and rebuild; exact
+  Core pins must be updated explicitly. CLI and headless packages need no release.
+- Published Core 2.5.3 does not contain the fix. Continuous scheduling reproduces
+  decoded samples; it does not trim asset silence or repair waveform boundaries.
+
+### Verification — 2026-10-12
+
+- Core build and all 941 unit tests pass (81 files), including 41 audio tests.
+- All 22 minified browser checks pass, covering 44.1/48 kHz, finite/unlimited
+  counts and first-play offsets. Tentax's current MP3 has zero inserted/missing
+  frames across unlimited/two-play joins and stops at the exact finite boundary.
+  Its unchanged music manager crosses the real-time boundary on one source
+  during a 200 ms control-thread stall, using an isolated checkout Core bundle.
+- Clean prepublish build and package packing verify version 2.5.4, all 642 files,
+  native looping/finite scheduling, declarations and public docs. Packed files
+  match the checkout byte for byte; tests and the application MP3 are excluded.
+  Dependency declarations are unchanged and `git diff --check` passes.
+
 ## [2.5.3] — 2026-10-10
 
-Prepared; not yet published. Published 2.5.2 remains the registry baseline.
+Published; package download, registry integrity and tested alignment modules verified on 2026-10-10.
 
 ### Changed
 
@@ -21,9 +91,9 @@ Prepared; not yet published. Published 2.5.2 remains the registry baseline.
 
 - Text with omitted alignment can move within a taller box. Set top explicitly
   for content intended to begin there; XML is not migrated automatically.
-- Prepared ui-document 0.13.1 records middle for all four UI text types without
+- Published ui-document 0.13.1 records middle for all four UI text types without
   adding a Core dependency or inserting omitted properties. Apps adopt runtime
-  and authoring installations/locks explicitly after publication and rebuild.
+  and authoring installations/locks explicitly and rebuild.
 - No public API, runtime dependency, resource or XML-format change. Existing SDK
   peers accept the patch without another UI/Game/DragonBones/Spine/runtime release.
   The standalone bitmap-font kernel retains its own layout default.

package/README.md

@@ -1,13 +1,40 @@
 # @kurot/core
 
-**2.5.3 is prepared, not yet published.** TextField and BitmapText now default
-to middle alignment, inherited by UI text components. Explicit top/bottom remain
-effective and multiline controls only line generation. Published 2.5.2 remains
-the verified npm baseline. See [CHANGELOG.md](CHANGELOG.md).
+**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.3 (prepared, not published).** Targets ES2022 and evergreen browsers (Chrome / Edge / Firefox / Safari). No IE / old-Android / pre-2022 Safari support shims.
+> **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
 
@@ -26,8 +53,8 @@ its bitmap-font line frame. Nominal measurement and font-fitting sizes are uncha
 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 prepared ui-document 0.13.1; the headless
-bitmap-font kernel is unchanged. After publication, adopt Core 2.5.3 in the
+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).
 
@@ -178,8 +205,11 @@ matching UI release; Core does not expose `textFit` or `minFontSize`.
 
 ## 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.
+
 ```bash
-pnpm add @kurot/core@^2.5.2
+pnpm add @kurot/core@^2.5.4
 ```
 
 Core depends on `@kurot/bitmap-font ^0.1.0` for bitmap-font data and shared
@@ -308,6 +338,10 @@ 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.
+
 ```typescript
 import { createPlayer, Sprite, Shape } from '@kurot/core';
 
@@ -330,7 +364,8 @@ rect.x = 100;
 rect.y = 100;
 root.addChild(rect);
 
-// stop() is resumable; destroy() performs final lifecycle cleanup.
+// stop() pauses this Player's rendering; the shared ticker can keep running.
+// Clean up application-owned activity before final app destruction.
 // app.destroy();
 ```
 
@@ -368,6 +403,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)
 - [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
@@ -422,8 +458,8 @@ Release regression gates are deliberately machine-scoped. Set a stable
 name and exact browser version match. Timing limits use both observed variance
 and a 12% floor; a baseline row needs at least five samples before it can gate.
 
-Deterministic visual regression tests cover Canvas 2D, WebGL 1, WebGL 2, and
-WebGL context restoration:
+Visual regression is a local, on-demand check for renderer changes. The tests
+cover Canvas 2D, WebGL 1, WebGL 2, and WebGL context restoration:
 
 ```bash
 pnpm test:visual
@@ -433,6 +469,17 @@ After an intentional renderer change has been visually reviewed, regenerate the
 golden images with `pnpm test:visual:update`. Failed comparisons retain expected,
 actual, and diff images under the ignored local `test-results/` directory.
 
+The golden scene explicitly uses middle-aligned text, matching Core 2.5.3.
+It loads its bundled Chakra Petch bold font before layout, so glyph-block
+placement does not depend on a system Arial substitute. The font and its SIL
+Open Font License are in `examples/visual-regression/fonts/`. Text-alignment
+tests separately check the default and explicit top/middle/bottom modes.
+Baselines live in `examples/visual-regression/tests/snapshots/<platform>/`
+because font rasterization and ink metrics can differ between operating systems
+even with the same font file. `pnpm test:visual:update` updates only the current
+platform's baselines. Review text-layout changes before updating snapshots and
+keep the existing pixel thresholds.
+
 Resource-lifetime soak tests repeatedly rebuild scenes, upload and dispose
 textures, pressure blur framebuffer pools, force garbage collection, and restore
 a lost WebGL context. The short release smoke is:

package/dist/kurot/display/Bitmap.d.ts

@@ -6,7 +6,16 @@ import { BitmapFillMode } from './enums/BitmapFillMode.js';
 import type { Stage } from './Stage.js';
 export declare let bitmapPixelHitTest: ((bitmap: Bitmap, localX: number, localY: number) => boolean) | undefined;
 export declare function setBitmapPixelHitTest(fn: (bitmap: Bitmap, localX: number, localY: number) => boolean): void;
+/**
+ * Displays a Texture without taking ownership of its lifetime.
+ * Assign undefined to texture to clear the image. Texture dimensions and
+ * nine-slice grids are logical units, independent of the canvas resolution.
+ */
 export declare class Bitmap extends DisplayObject {
+    /**
+     * Initial smoothing copied by new Bitmap instances, true by default.
+     * Changing this value does not affect existing bitmaps.
+     */
     static defaultSmoothing: boolean;
     private _texture?;
     private _smoothing;
@@ -27,18 +36,51 @@ export declare class Bitmap extends DisplayObject {
     sourceWidth: number;
     sourceHeight: number;
     constructor(value?: Texture);
+    /**
+     * Texture reference, initially undefined. Assignment does not transfer
+     * resource ownership; assigning undefined clears the image without disposing
+     * the old texture or its shared BitmapData.
+     */
     get texture(): Texture | undefined;
     set texture(value: Texture | undefined);
+    /**
+     * Whether scaled texture sampling is smoothed; initially the value of
+     * Bitmap.defaultSmoothing (true). Set false for nearest-neighbor pixel art.
+     */
     get smoothing(): boolean;
     set smoothing(value: boolean);
+    /**
+     * How the texture fills explicit dimensions: 'scale' by default, or 'clip'
+     * and 'repeat'. Nine-slice scaling is used only with 'scale'.
+     */
     get fillMode(): BitmapFillMode;
     set fillMode(value: BitmapFillMode);
+    /**
+     * Optional nine-slice rectangle in logical texture coordinates, initially
+     * undefined. It is retained by reference; reassign after editing to invalidate
+     * render data. Has an effect only when fillMode is 'scale'.
+     */
     get scale9Grid(): Rectangle | undefined;
     set scale9Grid(value: Rectangle | undefined);
+    /**
+     * Whether bitmap hit testing consults the installed pixel-test callback;
+     * false by default. With no callback, bounds hits remain accepted. This does
+     * not enable touchEnabled by itself.
+     */
     get pixelHitTest(): boolean;
     set pixelHitTest(value: boolean);
+    /**
+     * Drawn width in unscaled logical units, initially the texture frame width.
+     * NaN restores automatic width; negative values are ignored. This resizes the
+     * bitmap's fill region without changing scaleX.
+     */
     get width(): number;
     set width(value: number);
+    /**
+     * Drawn height in unscaled logical units, initially the texture frame height.
+     * NaN restores automatic height; negative values are ignored. This resizes the
+     * bitmap's fill region without changing scaleY.
+     */
     get height(): number;
     set height(value: number);
     $onAddToStage(stage: Stage, $nestLevel: number): void;

package/dist/kurot/display/Bitmap.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"Bitmap.d.ts","sourceRoot":"","sources":["../../../src/kurot/display/Bitmap.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,SAAS,EAAE,MAAM,sBAAsB,CAAC;AACjD,OAAO,EAAE,aAAa,EAAoB,MAAM,oBAAoB,CAAC;AACrE,OAAO,EAAE,UAAU,EAAE,MAAM,yBAAyB,CAAC;AACrD,OAAO,EAAE,OAAO,EAAE,MAAM,sBAAsB,CAAC;AAC/C,OAAO,EAAE,cAAc,EAAE,MAAM,2BAA2B,CAAC;AAC3D,OAAO,KAAK,EAAE,KAAK,EAAE,MAAM,YAAY,CAAC;AAExC,eAAO,IAAI,kBAAkB,EAAE,CAAC,CAAC,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,KAAK,OAAO,CAAC,GAAG,SAAS,CAAC;AAEzG,wBAAgB,qBAAqB,CAAC,EAAE,EAAE,CAAC,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,KAAK,OAAO,GAAG,IAAI,CAE3G;AAED,qBAAa,MAAO,SAAQ,aAAa;IAGxC,OAAc,gBAAgB,UAAQ;IAItC,OAAO,CAAC,QAAQ,CAAC,CAAU;IAC3B,OAAO,CAAC,UAAU,CAAoC;IACtD,OAAO,CAAC,SAAS,CAAwC;IACzD,OAAO,CAAC,WAAW,CAAC,CAAY;IAChC,OAAO,CAAC,aAAa,CAAS;IAC9B,OAAO,CAAC,oBAAoB,CAAO;IACnC,OAAO,CAAC,qBAAqB,CAAO;IAEpC,UAAU,CAAC,EAAE,UAAU,CAAC;IACxB,OAAO,SAAK;IACZ,OAAO,SAAK;IACZ,WAAW,SAAK;IAChB,YAAY,SAAK;IACjB,aAAa,SAAK;IAClB,aAAa,SAAK;IAClB,YAAY,SAAK;IACjB,aAAa,SAAK;IAClB,WAAW,SAAK;IAChB,YAAY,SAAK;gBAIE,KAAK,CAAC,EAAE,OAAO;IAUlC,IAAW,OAAO,IAAI,OAAO,GAAG,SAAS,CAExC;IACD,IAAW,OAAO,CAAC,KAAK,EAAE,OAAO,GAAG,SAAS,EAE5C;IAED,IAAW,SAAS,IAAI,OAAO,CAE9B;IACD,IAAW,SAAS,CAAC,KAAK,EAAE,OAAO,EAMlC;IAED,IAAW,QAAQ,IAAI,cAAc,CAEpC;IACD,IAAW,QAAQ,CAAC,KAAK,EAAE,cAAc,EAOxC;IAED,IAAW,UAAU,IAAI,SAAS,GAAG,SAAS,CAE7C;IACD,IAAW,UAAU,CAAC,KAAK,EAAE,SAAS,GAAG,SAAS,EAIjD;IAED,IAAW,YAAY,IAAI,OAAO,CAEjC;IACD,IAAW,YAAY,CAAC,KAAK,EAAE,OAAO,EAErC;IAED,IAAoB,KAAK,IAAI,MAAM,CAElC;IACD,IAAoB,KAAK,CAAC,KAAK,EAAE,MAAM,EAOtC;IAED,IAAoB,MAAM,IAAI,MAAM,CAEnC;IACD,IAAoB,MAAM,CAAC,KAAK,EAAE,MAAM,EAOvC;IAIQ,aAAa,CAAC,KAAK,EAAE,KAAK,EAAE,UAAU,EAAE,MAAM,GAAG,IAAI;IAOrD,kBAAkB,IAAI,IAAI;IAO1B,qBAAqB,CAAC,MAAM,EAAE,SAAS,GAAG,IAAI;IAM9C,QAAQ,CAAC,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,GAAG,aAAa,GAAG,SAAS;IAa5E,OAAO,CAAC,UAAU;IA4BlB,OAAO,CAAC,gBAAgB;IAkBxB,OAAO,CAAC,cAAc;CAOtB"}
+{"version":3,"file":"Bitmap.d.ts","sourceRoot":"","sources":["../../../src/kurot/display/Bitmap.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,SAAS,EAAE,MAAM,sBAAsB,CAAC;AACjD,OAAO,EAAE,aAAa,EAAoB,MAAM,oBAAoB,CAAC;AACrE,OAAO,EAAE,UAAU,EAAE,MAAM,yBAAyB,CAAC;AACrD,OAAO,EAAE,OAAO,EAAE,MAAM,sBAAsB,CAAC;AAC/C,OAAO,EAAE,cAAc,EAAE,MAAM,2BAA2B,CAAC;AAC3D,OAAO,KAAK,EAAE,KAAK,EAAE,MAAM,YAAY,CAAC;AAExC,eAAO,IAAI,kBAAkB,EAAE,CAAC,CAAC,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,KAAK,OAAO,CAAC,GAAG,SAAS,CAAC;AAEzG,wBAAgB,qBAAqB,CAAC,EAAE,EAAE,CAAC,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,KAAK,OAAO,GAAG,IAAI,CAE3G;AAED;;;;GAIG;AACH,qBAAa,MAAO,SAAQ,aAAa;IAGxC;;;OAGG;IACH,OAAc,gBAAgB,UAAQ;IAItC,OAAO,CAAC,QAAQ,CAAC,CAAU;IAC3B,OAAO,CAAC,UAAU,CAAoC;IACtD,OAAO,CAAC,SAAS,CAAwC;IACzD,OAAO,CAAC,WAAW,CAAC,CAAY;IAChC,OAAO,CAAC,aAAa,CAAS;IAC9B,OAAO,CAAC,oBAAoB,CAAO;IACnC,OAAO,CAAC,qBAAqB,CAAO;IAEpC,UAAU,CAAC,EAAE,UAAU,CAAC;IACxB,OAAO,SAAK;IACZ,OAAO,SAAK;IACZ,WAAW,SAAK;IAChB,YAAY,SAAK;IACjB,aAAa,SAAK;IAClB,aAAa,SAAK;IAClB,YAAY,SAAK;IACjB,aAAa,SAAK;IAClB,WAAW,SAAK;IAChB,YAAY,SAAK;gBAIE,KAAK,CAAC,EAAE,OAAO;IAUlC;;;;OAIG;IACH,IAAW,OAAO,IAAI,OAAO,GAAG,SAAS,CAExC;IACD,IAAW,OAAO,CAAC,KAAK,EAAE,OAAO,GAAG,SAAS,EAE5C;IAED;;;OAGG;IACH,IAAW,SAAS,IAAI,OAAO,CAE9B;IACD,IAAW,SAAS,CAAC,KAAK,EAAE,OAAO,EAMlC;IAED;;;OAGG;IACH,IAAW,QAAQ,IAAI,cAAc,CAEpC;IACD,IAAW,QAAQ,CAAC,KAAK,EAAE,cAAc,EAOxC;IAED;;;;OAIG;IACH,IAAW,UAAU,IAAI,SAAS,GAAG,SAAS,CAE7C;IACD,IAAW,UAAU,CAAC,KAAK,EAAE,SAAS,GAAG,SAAS,EAIjD;IAED;;;;OAIG;IACH,IAAW,YAAY,IAAI,OAAO,CAEjC;IACD,IAAW,YAAY,CAAC,KAAK,EAAE,OAAO,EAErC;IAED;;;;OAIG;IACH,IAAoB,KAAK,IAAI,MAAM,CAElC;IACD,IAAoB,KAAK,CAAC,KAAK,EAAE,MAAM,EAOtC;IAED;;;;OAIG;IACH,IAAoB,MAAM,IAAI,MAAM,CAEnC;IACD,IAAoB,MAAM,CAAC,KAAK,EAAE,MAAM,EAOvC;IAIQ,aAAa,CAAC,KAAK,EAAE,KAAK,EAAE,UAAU,EAAE,MAAM,GAAG,IAAI;IAOrD,kBAAkB,IAAI,IAAI;IAO1B,qBAAqB,CAAC,MAAM,EAAE,SAAS,GAAG,IAAI;IAM9C,QAAQ,CAAC,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,GAAG,aAAa,GAAG,SAAS;IAa5E,OAAO,CAAC,UAAU;IA4BlB,OAAO,CAAC,gBAAgB;IAkBxB,OAAO,CAAC,cAAc;CAOtB"}

package/dist/kurot/display/Bitmap.js

@@ -5,8 +5,17 @@ export let bitmapPixelHitTest;
 export function setBitmapPixelHitTest(fn) {
     bitmapPixelHitTest = fn;
 }
+/**
+ * Displays a Texture without taking ownership of its lifetime.
+ * Assign undefined to texture to clear the image. Texture dimensions and
+ * nine-slice grids are logical units, independent of the canvas resolution.
+ */
 export class Bitmap extends DisplayObject {
     // ── Static fields ─────────────────────────────────────────────────────────
+    /**
+     * Initial smoothing copied by new Bitmap instances, true by default.
+     * Changing this value does not affect existing bitmaps.
+     */
     static defaultSmoothing = true;
     // ── Instance fields ───────────────────────────────────────────────────────
     _texture;
@@ -36,12 +45,21 @@ export class Bitmap extends DisplayObject {
         }
     }
     // ── Getters / Setters ─────────────────────────────────────────────────────
+    /**
+     * Texture reference, initially undefined. Assignment does not transfer
+     * resource ownership; assigning undefined clears the image without disposing
+     * the old texture or its shared BitmapData.
+     */
     get texture() {
         return this._texture;
     }
     set texture(value) {
         this.setTexture(value);
     }
+    /**
+     * Whether scaled texture sampling is smoothed; initially the value of
+     * Bitmap.defaultSmoothing (true). Set false for nearest-neighbor pixel art.
+     */
     get smoothing() {
         return this._smoothing;
     }
@@ -52,6 +70,10 @@ export class Bitmap extends DisplayObject {
         this._smoothing = value;
         this.$markDirty();
     }
+    /**
+     * How the texture fills explicit dimensions: 'scale' by default, or 'clip'
+     * and 'repeat'. Nine-slice scaling is used only with 'scale'.
+     */
     get fillMode() {
         return this._fillMode;
     }
@@ -63,6 +85,11 @@ export class Bitmap extends DisplayObject {
         this.$renderDirty = true;
         this.$markDirty();
     }
+    /**
+     * Optional nine-slice rectangle in logical texture coordinates, initially
+     * undefined. It is retained by reference; reassign after editing to invalidate
+     * render data. Has an effect only when fillMode is 'scale'.
+     */
     get scale9Grid() {
         return this._scale9Grid;
     }
@@ -71,12 +98,22 @@ export class Bitmap extends DisplayObject {
         this.$renderDirty = true;
         this.$markDirty();
     }
+    /**
+     * Whether bitmap hit testing consults the installed pixel-test callback;
+     * false by default. With no callback, bounds hits remain accepted. This does
+     * not enable touchEnabled by itself.
+     */
     get pixelHitTest() {
         return this._pixelHitTest;
     }
     set pixelHitTest(value) {
         this._pixelHitTest = !!value;
     }
+    /**
+     * Drawn width in unscaled logical units, initially the texture frame width.
+     * NaN restores automatic width; negative values are ignored. This resizes the
+     * bitmap's fill region without changing scaleX.
+     */
     get width() {
         return isNaN(this._explicitBitmapWidth) ? this.$getContentBounds().width : this._explicitBitmapWidth;
     }
@@ -88,6 +125,11 @@ export class Bitmap extends DisplayObject {
         this.$renderDirty = true;
         this.$markDirty();
     }
+    /**
+     * Drawn height in unscaled logical units, initially the texture frame height.
+     * NaN restores automatic height; negative values are ignored. This resizes the
+     * bitmap's fill region without changing scaleY.
+     */
     get height() {
         return isNaN(this._explicitBitmapHeight) ? this.$getContentBounds().height : this._explicitBitmapHeight;
     }

package/dist/kurot/display/Bitmap.js.map

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