@kurot/ui 3.1.0 → 3.3.0

package/CHANGELOG.md

@@ -4,6 +4,69 @@ All notable changes to `@kurot/ui` are documented here.
 
 ---
 
+## [3.3.0] — 2026-10-08
+
+### Added
+
+- Export RichLabel as an independent Component wrapping one native TextField.
+  Its only content interface is textFlow; ordinary Label text, appearance fields,
+  fitting and style presets are not exposed. Per-run styling stays in the flow.
+- Support continuous Unicode wrapping across runs, hard breaks, automatic bounds,
+  parent width constraints, maximum width, line spacing and alignment.
+- Copy assigned/read runs and styles, notify textFlow bindings, clear with [],
+  cache unchanged measurements and invalidate metrics after late font readiness.
+
+### Fixed
+
+- Apply BitmapLabel.maxWidth when measuring automatic bounds without an explicit
+  or parent-supplied width, keeping wrapped height consistent with rendering.
+- Remeasure BitmapLabel and RichLabel automatic height after an authored width
+  changes, including after the component has already completed layout.
+
+### Dependencies and migration
+
+- Require Core ^2.3.0 for independent rich-text measurement. UI development
+  dependencies and the lockfile resolve published Core 2.3.1 without local
+  overrides; the compatible patch does not raise the peer minimum.
+- Native code and programmatic skins can use both text components. KUI catalogs,
+  CLI compilation, ui-runtime materialization and Editor authoring are separate
+  follow-up work; this release does not migrate projects or edit those packages.
+
+### Verification
+
+- Cover content ownership, binding, measurement, layout, late font readiness and
+  per-run Canvas styling. Add minified Canvas 2D, WebGL 1 and WebGL 2 browser tests
+  for rich text and bitmap labels, including width changes and clearing content.
+
+## [3.2.0] — 2026-10-08
+
+### Added
+
+- Export BitmapLabel, a native UI component wrapping Core BitmapText with normal
+  measurement, parent layout constraints, alignment, spacing and text bindings.
+- Accept a caller-owned BitmapFont or a configured font-resource name. Resolve
+  preloaded fonts synchronously and load missing fonts through Core's resource
+  singleton, reporting completion and loading/type errors through events.
+- Ignore superseded asynchronous font results, including A-to-B-to-A changes.
+  Font ownership remains with the resource cache or caller.
+
+### Dependencies and migration
+
+- Require `@kurot/core ^2.2.0` in peer and development dependencies for rendered
+  BitmapText, FontAnalyzer and pure text measurement. Upgrade older Core installs
+  and lockfiles before adopting UI 3.2.0.
+- Remove the local Core dependency override and build against published Core.
+  UI continues to depend only on Core; bitmap-font is Core's dependency.
+- BitmapLabel supports native code and programmatic skins. The ui-document
+  catalog, CLI KUI tags, Editor and ui-runtime materializers do not yet adopt it.
+
+### Tests and documentation
+
+- Cover layout and measurement, alignment, binding notifications, cached and
+  asynchronous font resolution, stale requests, invalid resources and errors.
+- Translate architecture documentation to English and correct outdated Skin,
+  theme-adapter, validation and virtual-layout descriptions against source.
+
 ## [3.1.0] — 2026-10-05
 
 ### Added

package/README.md

@@ -2,10 +2,35 @@
 
 UI component framework for [@kurot/core](https://github.com/kurot-engine/kurot/tree/main/packages/core). Migrated from Egret EUI, rewritten in modern TypeScript with clean class inheritance — no namespace hacks, no prototype manipulation.
 
-> **Current release: 3.1.0.** Requires `@kurot/core@^2.1.0`. Targets ES2022 + evergreen browsers, same as core.
+> **Package version: 3.3.0.** Requires `@kurot/core@^2.3.0`. Targets ES2022 + evergreen browsers, same as core.
 
 For the full list of changes in this release, see [CHANGELOG.md](./CHANGELOG.md).
 
+## RichLabel in 3.3.0
+
+```ts
+import { RichLabel } from '@kurot/ui';
+
+const message = new RichLabel([
+	{ text: 'Important: ', style: { size: 20, bold: true, textColor: 0xff9900 } },
+	{ text: 'all runs wrap together.', style: { size: 20, italic: true } },
+]);
+message.maxWidth = 240;
+group.addChild(message);
+```
+
+RichLabel extends Component independently. Its content interface is `textFlow`,
+with no whole-component Label text, color, font, fitting or preset properties.
+It supports multiline layout, automatic bounds, parent constraints and alignment.
+Assigned/read runs and styles are copied; reassign an edited snapshot to update.
+See [RichLabel](docs/rich-label.md) for defaults, measurement and font readiness.
+BitmapLabel now also honors maxWidth during automatic measurement. Both text
+components remeasure automatic height when an authored width changes.
+
+UI 3.3.0 builds and tests against published Core 2.3.1 without local overrides.
+These native APIs do
+not add KUI tags or an Editor rich-text authoring interface by themselves.
+
 ## Label text fitting in 3.1.0
 
 Single-line Labels can shrink their drawing size to fit the available region:
@@ -33,22 +58,44 @@ intended to wrap. Files are not migrated automatically. Load fonts before
 measurement; after late loading, call `label.invalidateSize()` to refresh
 metrics even if the family name is unchanged.
 
-See the [text layout and fitting contract](docs/label-text-layout.md). KUI
-authoring requires ui-document 0.9.x and matching CLI/ui-runtime releases;
-programmatic UI depends only on Core.
+See the [text layout and fitting contract](docs/label-text-layout.md). Fitting
+metadata was introduced in ui-document 0.9.0 and remains supported in 0.11.0.
+Current CLI-built KUI projects use published CLI 3.3.0 with ui-document `^0.11.0`;
+Published ui-runtime 0.8.2 uses the same kernel range. Programmatic UI depends
+only on Core.
 
 ## Installation
 
 ```bash
-pnpm add @kurot/ui@^3.1.0 @kurot/core@^2.1.0
+pnpm add @kurot/ui@^3.3.0 @kurot/core@^2.3.0
 ```
 
 `@kurot/ui` declares `@kurot/core` as a peer dependency. Install both packages explicitly so the application controls the resolved core version.
 
-UI 3.1 requires Core 2.1.0 or later within Core 2.x. Refresh old sheet manifests with
+UI 3.3 requires Core 2.3.0 or later within Core 2.x for independent rich-text
+measurement as well as BitmapText rendering and font resources. Core installs its published bitmap-font dependency automatically.
+Refresh older Core/UI lockfiles and old sheet manifests with
 string-valued `subkeys` in Kurot Editor before launching the application.
 See the [resource migration guide](../ui-document/docs/resource-nine-slice.md).
 
+## Project style colors
+
+CLI 3.3.0 resolves Label presets and named colors from the optional
+`resource/config/style.json` into native UI properties, including state overrides:
+
+```xml
+<Label id="labelDisplay" textColor="#FF9900"
+       textColor.disabled="@style:colors:disabled-text" />
+```
+
+The Label belongs to a Skin declaring the `disabled` state. Native Skin state
+handling applies the compiled numeric color and restores the base color on
+leaving that state. The same reference syntax works for base color properties.
+UI does not read style.json or evaluate XML references itself; programmatic
+components assign numeric colors. This release does not introduce complete
+typography presets or automatic live theme switching. See the
+[project style contract](../ui-document/docs/project-styles.md).
+
 ## Quick Start
 
 ```ts
@@ -204,19 +251,21 @@ dynamic properties; use `this.skinParts.<name>` during the ready lifecycle.
 
 ### Basic Controls
 
-| Component      | Description                                                                    |
-| -------------- | ------------------------------------------------------------------------------ |
-| `Label`        | Text display. Wraps `TextField` in the UI lifecycle.                           |
-| `Button`       | Tappable button with `up`/`down`/`disabled` states and `labelDisplay` part.    |
-| `CheckBox`     | Toggle button. Dispatches `Event.CHANGE` on selection change.                  |
-| `RadioButton`  | Mutually exclusive toggle. Use `groupName` to link buttons.                    |
-| `ToggleButton` | Base for toggle-style buttons.                                                 |
-| `ToggleSwitch` | Binary on/off switch (visual variant of `ToggleButton`).                       |
-| `ProgressBar`  | Value indicator. Inject `thumb` (a `Component`) as the fill part.              |
-| `HSlider`      | Horizontal slider. Inject `thumb` and `track` skin parts; default range 0–100. |
-| `VSlider`      | Vertical slider. Inject `thumb` and `track` skin parts; default range 0–100.   |
-| `Rect`         | Filled/stroked rectangle. Supports `fillColor`, `strokeColor`, `fillAlpha`.    |
-| `Image`        | Bitmap display. Supports URL string or `Texture`, `scale9Grid`, `fillMode`.    |
+| Component      | Description                                                                     |
+| -------------- | ------------------------------------------------------------------------------- |
+| `Label`        | Text display. Wraps `TextField` in the UI lifecycle.                            |
+| `RichLabel`    | Styled runs in one continuous TextField layout; independent textFlow content.   |
+| `BitmapLabel`  | Bitmap-font display. Wraps BitmapText with font resources, layout and bindings. |
+| `Button`       | Tappable button with `up`/`down`/`disabled` states and `labelDisplay` part.     |
+| `CheckBox`     | Toggle button. Dispatches `Event.CHANGE` on selection change.                   |
+| `RadioButton`  | Mutually exclusive toggle. Use `groupName` to link buttons.                     |
+| `ToggleButton` | Base for toggle-style buttons.                                                  |
+| `ToggleSwitch` | Binary on/off switch (visual variant of `ToggleButton`).                        |
+| `ProgressBar`  | Value indicator. Inject `thumb` (a `Component`) as the fill part.               |
+| `HSlider`      | Horizontal slider. Inject `thumb` and `track` skin parts; default range 0–100.  |
+| `VSlider`      | Vertical slider. Inject `thumb` and `track` skin parts; default range 0–100.    |
+| `Rect`         | Filled/stroked rectangle. Supports `fillColor`, `strokeColor`, `fillAlpha`.     |
+| `Image`        | Bitmap display. Supports URL string or `Texture`, `scale9Grid`, `fillMode`.     |
 
 Both sliders inherit Range's default `minimum = 0` and `maximum = 100`.
 Set either bound explicitly when a control needs a different range.
@@ -281,10 +330,12 @@ data.addItem('Durian');
 data.addItemAt('Elderberry', 1);
 data.removeItemAt(0);
 data.replaceItemAt('Fig', 0);
-data.sortOn('name'); // sort by field
-data.sort((a, b) => (a > b ? 1 : -1)); // custom sort
+data.sort((a, b) => String(a).localeCompare(String(b)));
 data.filterFunction(item => item !== 'Fig');
 data.refresh(); // notify view after manual source changes
+
+const records = new ArrayCollection([{ name: 'Pear' }, { name: 'Apple' }]);
+records.sortOn('name'); // sort records by field
 ```
 
 ## Virtual Layout
@@ -335,20 +386,37 @@ component.percentHeight = 100;
 ## View States
 
 ```ts
-import { State, SetProperty, AddItems } from '@kurot/ui';
+import { Label, Rect, Skin, State, SetProperty } from '@kurot/ui';
 
-class MyButtonSkin extends Skin {
-	states = [
-		new State('up'),
-		new State('down', [new SetProperty('bg', 'fillColor', 0x5a4bd1)]),
-		new State('disabled', [
-			new SetProperty('bg', 'fillColor', 0x636e72),
-			new SetProperty('lbl', 'textColor', 0xb2bec3),
-		]),
-	];
+class StatefulButtonSkin extends Skin {
+	constructor() {
+		super();
+		const bg = new Rect(120, 36, 0x6c5ce7);
+		const labelDisplay = new Label();
+		labelDisplay.textColor = 0xffffff;
+		labelDisplay.horizontalCenter = 0;
+		labelDisplay.verticalCenter = 0;
+		this.setPart('bg', bg);
+		this.setPart('labelDisplay', labelDisplay);
+		this.skinParts = ['labelDisplay'];
+		this.elementsContent = [bg, labelDisplay];
+		this.states = [
+			new State('up'),
+			new State('down', [new SetProperty('bg', 'fillColor', 0x5a4bd1)]),
+			new State('disabled', [
+				new SetProperty('bg', 'fillColor', 0x636e72),
+				new SetProperty('labelDisplay', 'textColor', 0xb2bec3),
+			]),
+		];
+	}
 }
 ```
 
+Button selects `up`, `down` or `disabled` through its native behavior. Each
+state restores the previous property values before applying the next overrides.
+CLI-built skins generate the same `State`/`SetProperty` objects from XML
+attributes such as `textColor.disabled`.
+
 ## Events
 
 | Event                               | Dispatched by                                                    | Description                                                        |
@@ -405,14 +473,39 @@ cross-framework ranking.
 
 ## Differences from Egret EUI
 
-|                | Egret EUI                   | @kurot/ui                            |
-| -------------- | --------------------------- | ------------------------------------ |
-| Namespace      | `eui.*` global              | ES Module named exports              |
-| Component base | `namespace` + `mixin`       | Standard class inheritance           |
-| Layout state   | Prototype-injected          | `UIState` delegation                 |
-| Authored skins | EXML runtime parser         | KUI XML compiled by `@kurot/cli`     |
-| Skin parts     | Incremental dynamic fields  | Atomic typed `skinParts`             |
-| Skin lifecycle | `partAdded` / `partRemoved` | `onSkinReady` / `onSkinRemoved`      |
-| `thisObject`   | Required in event listeners | Not needed — use arrow functions     |
-| Virtual layout | Default on                  | Opt-in via `useVirtualLayout = true` |
-| i18n           | Built-in                    | Not supported                        |
+|                | Egret EUI                   | @kurot/ui                                                   |
+| -------------- | --------------------------- | ----------------------------------------------------------- |
+| Namespace      | `eui.*` global              | ES Module named exports                                     |
+| Component base | `namespace` + `mixin`       | Standard class inheritance                                  |
+| Layout state   | Prototype-injected          | `UIState` delegation                                        |
+| Authored skins | EXML runtime parser         | KUI XML compiled by `@kurot/cli`                            |
+| Skin parts     | Incremental dynamic fields  | Atomic typed `skinParts`                                    |
+| Skin lifecycle | `partAdded` / `partRemoved` | `onSkinReady` / `onSkinRemoved`                             |
+| `thisObject`   | Required in event listeners | Not needed — use arrow functions                            |
+| Virtual layout | Default on                  | Opt-in via `useVirtualLayout = true`                        |
+| i18n           | Built-in                    | Project-managed translations; Core handles Unicode wrapping |
+
+## Bitmap labels in 3.2.0
+
+[BitmapLabel](docs/bitmap-label.md) wraps Core BitmapText with native UI layout,
+spacing, alignment and configured font-resource names:
+
+```ts
+import { BitmapLabel } from '@kurot/ui';
+
+const amount = new BitmapLabel('1,234.56');
+amount.font = 'number_font_fnt';
+amount.multiline = false;
+amount.height = 100;
+group.addChild(amount);
+```
+
+Register the font descriptor in Core's resource configuration before assigning
+its name, or assign a BitmapFont directly. The label borrows its font; the
+resource cache or caller retains ownership. Superseded async requests cannot
+replace a newer assignment. Successful named loads dispatch Event.COMPLETE;
+failed or incorrectly typed resources dispatch IOErrorEvent.IO_ERROR.
+
+The component supports native code and programmatic skins. Installed KUI
+compilers, the ui-document catalog, Editor and ui-runtime materializers do not
+yet adopt the BitmapLabel tag. Published UI 3.1.0 does not include the component.

package/dist/kurot/components/BitmapLabel.d.ts

@@ -0,0 +1,48 @@
+import { BitmapFont } from '@kurot/core';
+import { Component } from './Component.js';
+import type { IDisplayText } from '../core/IDisplayText.js';
+/**
+ * UI layout wrapper around BitmapText. String fonts are configured resource
+ * names; FontAnalyzer loads the descriptor and its page. Font ownership stays
+ * with the resource cache or the caller that supplied a BitmapFont.
+ */
+export declare class BitmapLabel extends Component implements IDisplayText {
+    private readonly _bitmapText;
+    private _font?;
+    private _fontChanged;
+    private _fontRequest;
+    private _widthConstraint;
+    constructor(text?: string);
+    get width(): number;
+    set width(value: number);
+    get text(): string;
+    set text(value: string);
+    get font(): string | BitmapFont | undefined;
+    set font(value: string | BitmapFont | undefined);
+    get textAlign(): 'left' | 'center' | 'right';
+    set textAlign(value: 'left' | 'center' | 'right');
+    get verticalAlign(): 'top' | 'middle' | 'bottom';
+    set verticalAlign(value: 'top' | 'middle' | 'bottom');
+    get letterSpacing(): number;
+    set letterSpacing(value: number);
+    get lineSpacing(): number;
+    set lineSpacing(value: number);
+    get multiline(): boolean;
+    set multiline(value: boolean);
+    get smoothing(): boolean;
+    set smoothing(value: boolean);
+    /**
+     * Content metrics under the label's width constraint, before height clipping.
+     */
+    get textWidth(): number;
+    get textHeight(): number;
+    createChildren(): void;
+    commitProperties(): void;
+    measure(): void;
+    setLayoutBoundsSize(layoutWidth: number, layoutHeight: number): void;
+    updateDisplayList(unscaledWidth: number, unscaledHeight: number): void;
+    private _invalidateText;
+    private _measureText;
+    private _resolveFont;
+}
+//# sourceMappingURL=BitmapLabel.d.ts.map

package/dist/kurot/components/BitmapLabel.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"BitmapLabel.d.ts","sourceRoot":"","sources":["../../../src/kurot/components/BitmapLabel.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,UAAU,EAA6C,MAAM,aAAa,CAAC;AACpF,OAAO,EAAE,SAAS,EAAE,MAAM,gBAAgB,CAAC;AAC3C,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,yBAAyB,CAAC;AAG5D;;;;GAIG;AACH,qBAAa,WAAY,SAAQ,SAAU,YAAW,YAAY;IAEjE,OAAO,CAAC,QAAQ,CAAC,WAAW,CAAoB;IAChD,OAAO,CAAC,KAAK,CAAC,CAAsB;IACpC,OAAO,CAAC,YAAY,CAAS;IAC7B,OAAO,CAAC,YAAY,CAAK;IACzB,OAAO,CAAC,gBAAgB,CAAO;gBAGZ,IAAI,SAAK;IAO5B,IAAoB,KAAK,IAAI,MAAM,CAElC;IACD,IAAoB,KAAK,CAAC,KAAK,EAAE,MAAM,EAKtC;IAED,IAAW,IAAI,IAAI,MAAM,CAExB;IACD,IAAW,IAAI,CAAC,KAAK,EAAE,MAAM,EAK5B;IACD,IAAW,IAAI,IAAI,MAAM,GAAG,UAAU,GAAG,SAAS,CAEjD;IACD,IAAW,IAAI,CAAC,KAAK,EAAE,MAAM,GAAG,UAAU,GAAG,SAAS,EAQrD;IACD,IAAW,SAAS,IAAI,MAAM,GAAG,QAAQ,GAAG,OAAO,CAElD;IACD,IAAW,SAAS,CAAC,KAAK,EAAE,MAAM,GAAG,QAAQ,GAAG,OAAO,EAItD;IACD,IAAW,aAAa,IAAI,KAAK,GAAG,QAAQ,GAAG,QAAQ,CAEtD;IACD,IAAW,aAAa,CAAC,KAAK,EAAE,KAAK,GAAG,QAAQ,GAAG,QAAQ,EAI1D;IACD,IAAW,aAAa,IAAI,MAAM,CAEjC;IACD,IAAW,aAAa,CAAC,KAAK,EAAE,MAAM,EAIrC;IACD,IAAW,WAAW,IAAI,MAAM,CAE/B;IACD,IAAW,WAAW,CAAC,KAAK,EAAE,MAAM,EAInC;IACD,IAAW,SAAS,IAAI,OAAO,CAE9B;IACD,IAAW,SAAS,CAAC,KAAK,EAAE,OAAO,EAIlC;IACD,IAAW,SAAS,IAAI,OAAO,CAE9B;IACD,IAAW,SAAS,CAAC,KAAK,EAAE,OAAO,EAIlC;IACD;;OAEG;IACH,IAAW,SAAS,IAAI,MAAM,CAE7B;IACD,IAAW,UAAU,IAAI,MAAM,CAE9B;IAGe,cAAc,IAAI,IAAI;IAItB,gBAAgB,IAAI,IAAI;IAMxB,OAAO,IAAI,IAAI;IAIf,mBAAmB,CAAC,WAAW,EAAE,MAAM,EAAE,YAAY,EAAE,MAAM,GAAG,IAAI;IAOpE,iBAAiB,CAAC,aAAa,EAAE,MAAM,EAAE,cAAc,EAAE,MAAM,GAAG,IAAI;IAOtF,OAAO,CAAC,eAAe;IAIvB,OAAO,CAAC,YAAY;IAWpB,OAAO,CAAC,YAAY;CA0BpB"}

package/dist/kurot/components/BitmapLabel.js

@@ -0,0 +1,196 @@
+import { BitmapFont, BitmapText, Event, IOErrorEvent, resource } from '@kurot/core';
+import { Component } from './Component.js';
+import { PropertyEvent } from '../events/PropertyEvent.js';
+/**
+ * UI layout wrapper around BitmapText. String fonts are configured resource
+ * names; FontAnalyzer loads the descriptor and its page. Font ownership stays
+ * with the resource cache or the caller that supplied a BitmapFont.
+ */
+export class BitmapLabel extends Component {
+    // ── Instance fields ──────────────────────────────────────────────────────
+    _bitmapText = new BitmapText();
+    _font;
+    _fontChanged = false;
+    _fontRequest = 0;
+    _widthConstraint = NaN;
+    // ── Constructor ──────────────────────────────────────────────────────────
+    constructor(text = '') {
+        super();
+        this.touchChildren = false;
+        this.text = text;
+    }
+    // ── Getters / Setters ─────────────────────────────────────────────────────
+    get width() {
+        return super.width;
+    }
+    set width(value) {
+        if (Object.is(this.$explicitWidth, value))
+            return;
+        super.width = value;
+        // Component width changes alone do not invalidate automatic text height.
+        this._invalidateText();
+    }
+    get text() {
+        return this._bitmapText.text;
+    }
+    set text(value) {
+        if (this.text === value)
+            return;
+        this._bitmapText.text = value;
+        PropertyEvent.dispatchPropertyEvent(this, 'text');
+        this._invalidateText();
+    }
+    get font() {
+        return this._font;
+    }
+    set font(value) {
+        if (this._font === value)
+            return;
+        this._font = value;
+        this._fontRequest++;
+        this._fontChanged = typeof value === 'string';
+        this._bitmapText.font = value instanceof BitmapFont ? value : undefined;
+        this.invalidateProperties();
+        this._invalidateText();
+    }
+    get textAlign() {
+        return this._bitmapText.textAlign;
+    }
+    set textAlign(value) {
+        if (this.textAlign === value)
+            return;
+        this._bitmapText.textAlign = value;
+        this.invalidateDisplayList();
+    }
+    get verticalAlign() {
+        return this._bitmapText.verticalAlign;
+    }
+    set verticalAlign(value) {
+        if (this.verticalAlign === value)
+            return;
+        this._bitmapText.verticalAlign = value;
+        this.invalidateDisplayList();
+    }
+    get letterSpacing() {
+        return this._bitmapText.letterSpacing;
+    }
+    set letterSpacing(value) {
+        if (this.letterSpacing === value)
+            return;
+        this._bitmapText.letterSpacing = value;
+        this._invalidateText();
+    }
+    get lineSpacing() {
+        return this._bitmapText.lineSpacing;
+    }
+    set lineSpacing(value) {
+        if (this.lineSpacing === value)
+            return;
+        this._bitmapText.lineSpacing = value;
+        this._invalidateText();
+    }
+    get multiline() {
+        return this._bitmapText.multiline;
+    }
+    set multiline(value) {
+        if (this.multiline === value)
+            return;
+        this._bitmapText.multiline = value;
+        this._invalidateText();
+    }
+    get smoothing() {
+        return this._bitmapText.smoothing;
+    }
+    set smoothing(value) {
+        if (this.smoothing === value)
+            return;
+        this._bitmapText.smoothing = value;
+        this.invalidateDisplayList();
+    }
+    /**
+     * Content metrics under the label's width constraint, before height clipping.
+     */
+    get textWidth() {
+        return this._measureText().width;
+    }
+    get textHeight() {
+        return this._measureText().height;
+    }
+    // ── Override methods ─────────────────────────────────────────────────────
+    createChildren() {
+        super.createChildren();
+        this.addChild(this._bitmapText);
+    }
+    commitProperties() {
+        super.commitProperties();
+        if (!this._fontChanged)
+            return;
+        this._fontChanged = false;
+        this._resolveFont();
+    }
+    measure() {
+        const measured = this._measureText();
+        this.setMeasuredSize(measured.width, measured.height);
+    }
+    setLayoutBoundsSize(layoutWidth, layoutHeight) {
+        super.setLayoutBoundsSize(layoutWidth, layoutHeight);
+        const width = Number.isFinite(layoutWidth) ? this.width : NaN;
+        if (Object.is(this._widthConstraint, width))
+            return;
+        this._widthConstraint = width;
+        this._invalidateText();
+    }
+    updateDisplayList(unscaledWidth, unscaledHeight) {
+        super.updateDisplayList(unscaledWidth, unscaledHeight);
+        this._bitmapText.width = unscaledWidth;
+        this._bitmapText.height = unscaledHeight;
+    }
+    // ── Private methods ──────────────────────────────────────────────────────
+    _invalidateText() {
+        this.invalidateSize();
+        this.invalidateDisplayList();
+    }
+    _measureText() {
+        const width = Number.isFinite(this._widthConstraint)
+            ? this._widthConstraint
+            : Number.isFinite(this.$explicitWidth)
+                ? this.$explicitWidth
+                : this.maxWidth !== 100000
+                    ? this.maxWidth
+                    : NaN;
+        const layout = this._bitmapText.measureText(width);
+        return { width: layout.width, height: layout.height };
+    }
+    _resolveFont() {
+        const name = this._font;
+        if (typeof name !== 'string')
+            return;
+        const request = this._fontRequest;
+        const apply = (font) => {
+            if (request !== this._fontRequest)
+                return;
+            if (!(font instanceof BitmapFont))
+                throw new TypeError(`Resource ${name} is not a bitmap font.`);
+            this._bitmapText.font = font;
+            this._invalidateText();
+            this.dispatchEventWith(Event.COMPLETE);
+        };
+        const cached = resource.get(name);
+        const report = (error) => {
+            if (request !== this._fontRequest)
+                return;
+            this.dispatchEventWith(IOErrorEvent.IO_ERROR, false, { source: name, error });
+        };
+        if (cached !== undefined) {
+            try {
+                apply(cached);
+            }
+            catch (error) {
+                report(error);
+            }
+            return;
+        }
+        void resource.load(name).then(apply).catch(report);
+    }
+}
+//# sourceMappingURL=BitmapLabel.js.map

package/dist/kurot/components/BitmapLabel.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"BitmapLabel.js","sourceRoot":"","sources":["../../../src/kurot/components/BitmapLabel.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,UAAU,EAAE,UAAU,EAAE,KAAK,EAAE,YAAY,EAAE,QAAQ,EAAE,MAAM,aAAa,CAAC;AACpF,OAAO,EAAE,SAAS,EAAE,MAAM,gBAAgB,CAAC;AAE3C,OAAO,EAAE,aAAa,EAAE,MAAM,4BAA4B,CAAC;AAE3D;;;;GAIG;AACH,MAAM,OAAO,WAAY,SAAQ,SAAS;IACzC,4EAA4E;IAC3D,WAAW,GAAG,IAAI,UAAU,EAAE,CAAC;IACxC,KAAK,CAAuB;IAC5B,YAAY,GAAG,KAAK,CAAC;IACrB,YAAY,GAAG,CAAC,CAAC;IACjB,gBAAgB,GAAG,GAAG,CAAC;IAE/B,4EAA4E;IAC5E,YAAmB,IAAI,GAAG,EAAE;QAC3B,KAAK,EAAE,CAAC;QACR,IAAI,CAAC,aAAa,GAAG,KAAK,CAAC;QAC3B,IAAI,CAAC,IAAI,GAAG,IAAI,CAAC;IAClB,CAAC;IAED,6EAA6E;IAC7E,IAAoB,KAAK;QACxB,OAAO,KAAK,CAAC,KAAK,CAAC;IACpB,CAAC;IACD,IAAoB,KAAK,CAAC,KAAa;QACtC,IAAI,MAAM,CAAC,EAAE,CAAC,IAAI,CAAC,cAAc,EAAE,KAAK,CAAC;YAAE,OAAO;QAClD,KAAK,CAAC,KAAK,GAAG,KAAK,CAAC;QACpB,yEAAyE;QACzE,IAAI,CAAC,eAAe,EAAE,CAAC;IACxB,CAAC;IAED,IAAW,IAAI;QACd,OAAO,IAAI,CAAC,WAAW,CAAC,IAAI,CAAC;IAC9B,CAAC;IACD,IAAW,IAAI,CAAC,KAAa;QAC5B,IAAI,IAAI,CAAC,IAAI,KAAK,KAAK;YAAE,OAAO;QAChC,IAAI,CAAC,WAAW,CAAC,IAAI,GAAG,KAAK,CAAC;QAC9B,aAAa,CAAC,qBAAqB,CAAC,IAAI,EAAE,MAAM,CAAC,CAAC;QAClD,IAAI,CAAC,eAAe,EAAE,CAAC;IACxB,CAAC;IACD,IAAW,IAAI;QACd,OAAO,IAAI,CAAC,KAAK,CAAC;IACnB,CAAC;IACD,IAAW,IAAI,CAAC,KAAsC;QACrD,IAAI,IAAI,CAAC,KAAK,KAAK,KAAK;YAAE,OAAO;QACjC,IAAI,CAAC,KAAK,GAAG,KAAK,CAAC;QACnB,IAAI,CAAC,YAAY,EAAE,CAAC;QACpB,IAAI,CAAC,YAAY,GAAG,OAAO,KAAK,KAAK,QAAQ,CAAC;QAC9C,IAAI,CAAC,WAAW,CAAC,IAAI,GAAG,KAAK,YAAY,UAAU,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,SAAS,CAAC;QACxE,IAAI,CAAC,oBAAoB,EAAE,CAAC;QAC5B,IAAI,CAAC,eAAe,EAAE,CAAC;IACxB,CAAC;IACD,IAAW,SAAS;QACnB,OAAO,IAAI,CAAC,WAAW,CAAC,SAAS,CAAC;IACnC,CAAC;IACD,IAAW,SAAS,CAAC,KAAkC;QACtD,IAAI,IAAI,CAAC,SAAS,KAAK,KAAK;YAAE,OAAO;QACrC,IAAI,CAAC,WAAW,CAAC,SAAS,GAAG,KAAK,CAAC;QACnC,IAAI,CAAC,qBAAqB,EAAE,CAAC;IAC9B,CAAC;IACD,IAAW,aAAa;QACvB,OAAO,IAAI,CAAC,WAAW,CAAC,aAAa,CAAC;IACvC,CAAC;IACD,IAAW,aAAa,CAAC,KAAkC;QAC1D,IAAI,IAAI,CAAC,aAAa,KAAK,KAAK;YAAE,OAAO;QACzC,IAAI,CAAC,WAAW,CAAC,aAAa,GAAG,KAAK,CAAC;QACvC,IAAI,CAAC,qBAAqB,EAAE,CAAC;IAC9B,CAAC;IACD,IAAW,aAAa;QACvB,OAAO,IAAI,CAAC,WAAW,CAAC,aAAa,CAAC;IACvC,CAAC;IACD,IAAW,aAAa,CAAC,KAAa;QACrC,IAAI,IAAI,CAAC,aAAa,KAAK,KAAK;YAAE,OAAO;QACzC,IAAI,CAAC,WAAW,CAAC,aAAa,GAAG,KAAK,CAAC;QACvC,IAAI,CAAC,eAAe,EAAE,CAAC;IACxB,CAAC;IACD,IAAW,WAAW;QACrB,OAAO,IAAI,CAAC,WAAW,CAAC,WAAW,CAAC;IACrC,CAAC;IACD,IAAW,WAAW,CAAC,KAAa;QACnC,IAAI,IAAI,CAAC,WAAW,KAAK,KAAK;YAAE,OAAO;QACvC,IAAI,CAAC,WAAW,CAAC,WAAW,GAAG,KAAK,CAAC;QACrC,IAAI,CAAC,eAAe,EAAE,CAAC;IACxB,CAAC;IACD,IAAW,SAAS;QACnB,OAAO,IAAI,CAAC,WAAW,CAAC,SAAS,CAAC;IACnC,CAAC;IACD,IAAW,SAAS,CAAC,KAAc;QAClC,IAAI,IAAI,CAAC,SAAS,KAAK,KAAK;YAAE,OAAO;QACrC,IAAI,CAAC,WAAW,CAAC,SAAS,GAAG,KAAK,CAAC;QACnC,IAAI,CAAC,eAAe,EAAE,CAAC;IACxB,CAAC;IACD,IAAW,SAAS;QACnB,OAAO,IAAI,CAAC,WAAW,CAAC,SAAS,CAAC;IACnC,CAAC;IACD,IAAW,SAAS,CAAC,KAAc;QAClC,IAAI,IAAI,CAAC,SAAS,KAAK,KAAK;YAAE,OAAO;QACrC,IAAI,CAAC,WAAW,CAAC,SAAS,GAAG,KAAK,CAAC;QACnC,IAAI,CAAC,qBAAqB,EAAE,CAAC;IAC9B,CAAC;IACD;;OAEG;IACH,IAAW,SAAS;QACnB,OAAO,IAAI,CAAC,YAAY,EAAE,CAAC,KAAK,CAAC;IAClC,CAAC;IACD,IAAW,UAAU;QACpB,OAAO,IAAI,CAAC,YAAY,EAAE,CAAC,MAAM,CAAC;IACnC,CAAC;IAED,4EAA4E;IAC5D,cAAc;QAC7B,KAAK,CAAC,cAAc,EAAE,CAAC;QACvB,IAAI,CAAC,QAAQ,CAAC,IAAI,CAAC,WAAW,CAAC,CAAC;IACjC,CAAC;IACe,gBAAgB;QAC/B,KAAK,CAAC,gBAAgB,EAAE,CAAC;QACzB,IAAI,CAAC,IAAI,CAAC,YAAY;YAAE,OAAO;QAC/B,IAAI,CAAC,YAAY,GAAG,KAAK,CAAC;QAC1B,IAAI,CAAC,YAAY,EAAE,CAAC;IACrB,CAAC;IACe,OAAO;QACtB,MAAM,QAAQ,GAAG,IAAI,CAAC,YAAY,EAAE,CAAC;QACrC,IAAI,CAAC,eAAe,CAAC,QAAQ,CAAC,KAAK,EAAE,QAAQ,CAAC,MAAM,CAAC,CAAC;IACvD,CAAC;IACe,mBAAmB,CAAC,WAAmB,EAAE,YAAoB;QAC5E,KAAK,CAAC,mBAAmB,CAAC,WAAW,EAAE,YAAY,CAAC,CAAC;QACrD,MAAM,KAAK,GAAG,MAAM,CAAC,QAAQ,CAAC,WAAW,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC,CAAC,GAAG,CAAC;QAC9D,IAAI,MAAM,CAAC,EAAE,CAAC,IAAI,CAAC,gBAAgB,EAAE,KAAK,CAAC;YAAE,OAAO;QACpD,IAAI,CAAC,gBAAgB,GAAG,KAAK,CAAC;QAC9B,IAAI,CAAC,eAAe,EAAE,CAAC;IACxB,CAAC;IACe,iBAAiB,CAAC,aAAqB,EAAE,cAAsB;QAC9E,KAAK,CAAC,iBAAiB,CAAC,aAAa,EAAE,cAAc,CAAC,CAAC;QACvD,IAAI,CAAC,WAAW,CAAC,KAAK,GAAG,aAAa,CAAC;QACvC,IAAI,CAAC,WAAW,CAAC,MAAM,GAAG,cAAc,CAAC;IAC1C,CAAC;IAED,4EAA4E;IACpE,eAAe;QACtB,IAAI,CAAC,cAAc,EAAE,CAAC;QACtB,IAAI,CAAC,qBAAqB,EAAE,CAAC;IAC9B,CAAC;IACO,YAAY;QACnB,MAAM,KAAK,GAAG,MAAM,CAAC,QAAQ,CAAC,IAAI,CAAC,gBAAgB,CAAC;YACnD,CAAC,CAAC,IAAI,CAAC,gBAAgB;YACvB,CAAC,CAAC,MAAM,CAAC,QAAQ,CAAC,IAAI,CAAC,cAAc,CAAC;gBACrC,CAAC,CAAC,IAAI,CAAC,cAAc;gBACrB,CAAC,CAAC,IAAI,CAAC,QAAQ,KAAK,MAAM;oBACzB,CAAC,CAAC,IAAI,CAAC,QAAQ;oBACf,CAAC,CAAC,GAAG,CAAC;QACT,MAAM,MAAM,GAAG,IAAI,CAAC,WAAW,CAAC,WAAW,CAAC,KAAK,CAAC,CAAC;QACnD,OAAO,EAAE,KAAK,EAAE,MAAM,CAAC,KAAK,EAAE,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,CAAC;IACvD,CAAC;IACO,YAAY;QACnB,MAAM,IAAI,GAAG,IAAI,CAAC,KAAK,CAAC;QACxB,IAAI,OAAO,IAAI,KAAK,QAAQ;YAAE,OAAO;QACrC,MAAM,OAAO,GAAG,IAAI,CAAC,YAAY,CAAC;QAClC,MAAM,KAAK,GAAG,CAAC,IAAa,EAAQ,EAAE;YACrC,IAAI,OAAO,KAAK,IAAI,CAAC,YAAY;gBAAE,OAAO;YAC1C,IAAI,CAAC,CAAC,IAAI,YAAY,UAAU,CAAC;gBAAE,MAAM,IAAI,SAAS,CAAC,YAAY,IAAI,wBAAwB,CAAC,CAAC;YACjG,IAAI,CAAC,WAAW,CAAC,IAAI,GAAG,IAAI,CAAC;YAC7B,IAAI,CAAC,eAAe,EAAE,CAAC;YACvB,IAAI,CAAC,iBAAiB,CAAC,KAAK,CAAC,QAAQ,CAAC,CAAC;QACxC,CAAC,CAAC;QACF,MAAM,MAAM,GAAG,QAAQ,CAAC,GAAG,CAAC,IAAI,CAAC,CAAC;QAClC,MAAM,MAAM,GAAG,CAAC,KAAc,EAAQ,EAAE;YACvC,IAAI,OAAO,KAAK,IAAI,CAAC,YAAY;gBAAE,OAAO;YAC1C,IAAI,CAAC,iBAAiB,CAAC,YAAY,CAAC,QAAQ,EAAE,KAAK,EAAE,EAAE,MAAM,EAAE,IAAI,EAAE,KAAK,EAAE,CAAC,CAAC;QAC/E,CAAC,CAAC;QACF,IAAI,MAAM,KAAK,SAAS,EAAE,CAAC;YAC1B,IAAI,CAAC;gBACJ,KAAK,CAAC,MAAM,CAAC,CAAC;YACf,CAAC;YAAC,OAAO,KAAK,EAAE,CAAC;gBAChB,MAAM,CAAC,KAAK,CAAC,CAAC;YACf,CAAC;YACD,OAAO;QACR,CAAC;QACD,KAAK,QAAQ,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC,KAAK,CAAC,MAAM,CAAC,CAAC;IACpD,CAAC;CACD"}

package/dist/kurot/components/RichLabel.d.ts

@@ -0,0 +1,51 @@
+import type { ITextElement } from '@kurot/core';
+import { Component } from './Component.js';
+/**
+ * Displays styled text runs in one continuous layout. Content is assigned only
+ * through textFlow; ordinary Label text and appearance presets are not exposed.
+ * Unspecified run styles use the TextField defaults captured at construction.
+ */
+export declare class RichLabel extends Component {
+    private readonly _textField;
+    private _widthConstraint;
+    private _measurement?;
+    private _measurementWidth;
+    constructor(textFlow?: readonly ITextElement[]);
+    get width(): number;
+    set width(value: number);
+    /**
+     * Assignment and reads copy the runs and their styles. Reassign an edited
+     * snapshot to update the component; [] clears all content.
+     */
+    get textFlow(): ITextElement[];
+    set textFlow(value: readonly ITextElement[]);
+    get multiline(): boolean;
+    set multiline(value: boolean);
+    /**
+     * True uses Unicode line-break opportunities; false wraps by graphemes.
+     * Explicit multiline=false displays only the first unwrapped hard line.
+     */
+    get wordWrap(): boolean;
+    set wordWrap(value: boolean);
+    get lineSpacing(): number;
+    set lineSpacing(value: number);
+    get textAlign(): 'left' | 'center' | 'right';
+    set textAlign(value: 'left' | 'center' | 'right');
+    get verticalAlign(): 'top' | 'middle' | 'bottom';
+    set verticalAlign(value: 'top' | 'middle' | 'bottom');
+    /**
+     * Complete content metrics under the current width constraint, before
+     * height clipping. Empty content has zero width and height.
+     */
+    get textWidth(): number;
+    get textHeight(): number;
+    invalidateSize(): void;
+    createChildren(): void;
+    measure(): void;
+    setLayoutBoundsSize(layoutWidth: number, layoutHeight: number): void;
+    updateDisplayList(unscaledWidth: number, unscaledHeight: number): void;
+    private _copyTextFlow;
+    private _invalidateText;
+    private _measureText;
+}
+//# sourceMappingURL=RichLabel.d.ts.map

package/dist/kurot/components/RichLabel.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"RichLabel.d.ts","sourceRoot":"","sources":["../../../src/kurot/components/RichLabel.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAmB,YAAY,EAAiB,MAAM,aAAa,CAAC;AAChF,OAAO,EAAE,SAAS,EAAE,MAAM,gBAAgB,CAAC;AAG3C;;;;GAIG;AACH,qBAAa,SAAU,SAAQ,SAAS;IAGvC,OAAO,CAAC,QAAQ,CAAC,UAAU,CAAmB;IAC9C,OAAO,CAAC,gBAAgB,CAAO;IAC/B,OAAO,CAAC,YAAY,CAAC,CAAoC;IACzD,OAAO,CAAC,iBAAiB,CAAO;gBAIb,QAAQ,GAAE,SAAS,YAAY,EAAO;IASzD,IAAoB,KAAK,IAAI,MAAM,CAElC;IACD,IAAoB,KAAK,CAAC,KAAK,EAAE,MAAM,EAKtC;IAED;;;OAGG;IACH,IAAW,QAAQ,IAAI,YAAY,EAAE,CAEpC;IACD,IAAW,QAAQ,CAAC,KAAK,EAAE,SAAS,YAAY,EAAE,EAKjD;IAED,IAAW,SAAS,IAAI,OAAO,CAE9B;IACD,IAAW,SAAS,CAAC,KAAK,EAAE,OAAO,EAIlC;IAED;;;OAGG;IACH,IAAW,QAAQ,IAAI,OAAO,CAE7B;IACD,IAAW,QAAQ,CAAC,KAAK,EAAE,OAAO,EAIjC;IAED,IAAW,WAAW,IAAI,MAAM,CAE/B;IACD,IAAW,WAAW,CAAC,KAAK,EAAE,MAAM,EAOnC;IAED,IAAW,SAAS,IAAI,MAAM,GAAG,QAAQ,GAAG,OAAO,CAElD;IACD,IAAW,SAAS,CAAC,KAAK,EAAE,MAAM,GAAG,QAAQ,GAAG,OAAO,EAOtD;IAED,IAAW,aAAa,IAAI,KAAK,GAAG,QAAQ,GAAG,QAAQ,CAEtD;IACD,IAAW,aAAa,CAAC,KAAK,EAAE,KAAK,GAAG,QAAQ,GAAG,QAAQ,EAO1D;IAED;;;OAGG;IACH,IAAW,SAAS,IAAI,MAAM,CAE7B;IACD,IAAW,UAAU,IAAI,MAAM,CAE9B;IAIe,cAAc,IAAI,IAAI;IAOtB,cAAc,IAAI,IAAI;IAKtB,OAAO,IAAI,IAAI;IAKf,mBAAmB,CAAC,WAAW,EAAE,MAAM,EAAE,YAAY,EAAE,MAAM,GAAG,IAAI;IAQpE,iBAAiB,CAAC,aAAa,EAAE,MAAM,EAAE,cAAc,EAAE,MAAM,GAAG,IAAI;IAQtF,OAAO,CAAC,aAAa;IASrB,OAAO,CAAC,eAAe;IAKvB,OAAO,CAAC,YAAY;CAgBpB"}