@kurot/core 2.5.0 → 2.5.1

package/CHANGELOG.md

@@ -4,10 +4,50 @@ All notable changes to `@kurot/core` are documented here.
 
 ---
 
+## [2.5.1] — 2026-10-10
+
+Prepared, not published. The latest verified registry release remains 2.5.0.
+
+### Fixed
+
+- Decouple dynamic `verticalAlign = "middle"` from `multiline`. Single and
+  multiple lines center their complete glyph block, including mixed-size rich
+  runs and fallback glyphs. Identical one-line content has the same placement
+  in either line mode. Blank rows retain their nominal height and line spacing.
+- Reuse cached block bounds for drawing, link hits and render-only glyph/outline
+  padding so nested bitmap caches and WebGL text captures retain centered ink.
+- Preserve stable input row baselines, caret, selection and composition geometry
+  in both line modes; preserve top/bottom alignment and nominal measurements.
+
+### Compatibility
+
+- No new API, dependencies, XML fields or resource format. Existing multiline
+  dynamic middle-aligned captions can move to their visual center; changing
+  glyphs can translate the block without changing its relative baselines.
+- Unchanged UI, Game, DragonBones, Spine and ui-runtime SDK peers accept this
+  patch without version bumps. Applications adopt Core and rebuild explicitly.
+  Editor's exact 2.5.0 pin must be changed to adopt it; compatible game ranges
+  such as `^2.5.0` need an installation/lock update. CLI and headless packages
+  require no release. See [text layout](docs/text-layout.md).
+
+### Verification — 2026-10-10
+
+- Core 2.5.1 build and all 900 unit tests pass (81 files).
+- All 12 minified browser checks pass in Canvas, WebGL 1/2 at 1×/2×.
+  Independent Canvas references verify identical one-row placement in both
+  line modes, 24/40/56 px automatic-height captions, multilingual paragraphs,
+  wrapping, rich text, blank rows, outlines and nested caches. Input caret,
+  selection, composition underline and second-row character hits pass.
+- Package dry-run verifies the 2.5.1 manifest, compiled block-alignment module,
+  declarations and updated documentation; `git diff --check` passes.
+  No application dependency or SDK peer changes.
+
 ## [2.5.0] — 2026-10-10
 
-Prepared for publication; not yet published. Latest verified npm release is
-2.4.0. Publish Core 2.5.0 before CLI 3.6.0, whose game template uses 2× sheets.
+Published; registry version metadata and latest verified on 2026-10-10.
+CLI 3.6.0 is also published; its game template requires this Core release.
+The published archive downloads through npm pack with matching registry integrity;
+its density API, text baseline module and fractional scissor correction are present.
 
 ### Added
 

package/README.md

@@ -1,22 +1,38 @@
 # @kurot/core
 
-**2.5.0 is prepared for publication, not yet published.** Latest verified npm
-release: 2.4.0. This release adds independent source texture density and fixes
-text alignment, fractional viewport edges and root WebGL target restoration.
-See [texture density](docs/texture-density.md) and [CHANGELOG.md](CHANGELOG.md).
+**2.5.1 is prepared, not published.** It makes dynamic middle alignment
+independent of single/multiline mode. The latest verified registry release is
+2.5.0 (2026-10-10), with source texture density, text baselines, fractional
+viewport fixes and root WebGL target restoration. 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.0 (pending publication).** Targets ES2022 and evergreen browsers (Chrome / Edge / Firefox / Safari). No IE / old-Android / pre-2022 Safari support shims.
+> **Package version: 2.5.1 (prepared, not published).** Targets ES2022 and evergreen browsers (Chrome / Edge / Firefox / Safari). No IE / old-Android / pre-2022 Safari support shims.
+
+## Unified 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. After publication,
+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
 
-Single-line dynamic middle alignment centers measured glyph ink, including
-fallback fonts and accents. Multiline text and input keep stable font baselines;
-rich runs share an alphabetic baseline. Layout sizes and wrapping stay nominal.
+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 after publication and rebuild to adopt it; published 2.4.0
+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
@@ -123,7 +139,6 @@ matching UI release; Core does not expose `textFit` or `minFontSize`.
 ## Installation
 
 ```bash
-# After Core 2.5.0 is published:
 pnpm add @kurot/core@^2.5.0
 ```
 

package/dist/kurot/text/TextBlockBounds.d.ts

@@ -0,0 +1,12 @@
+import type { TextField } from './TextField.js';
+interface TextBlockBounds {
+    readonly top: number;
+    readonly bottom: number;
+}
+/**
+ * Measures the complete glyph block, retaining nominal rows for blank lines.
+ * Outlines belong to render padding and do not change alignment.
+ */
+export declare function getTextBlockBounds(field: TextField): TextBlockBounds;
+export {};
+//# sourceMappingURL=TextBlockBounds.d.ts.map

package/dist/kurot/text/TextBlockBounds.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"TextBlockBounds.d.ts","sourceRoot":"","sources":["../../../src/kurot/text/TextBlockBounds.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,gBAAgB,CAAC;AAGhD,UAAU,eAAe;IACxB,QAAQ,CAAC,GAAG,EAAE,MAAM,CAAC;IACrB,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;CACxB;AAKD;;;GAGG;AACH,wBAAgB,kBAAkB,CAAC,KAAK,EAAE,SAAS,GAAG,eAAe,CAkBpE"}

package/dist/kurot/text/TextBlockBounds.js

@@ -0,0 +1,25 @@
+// Font, wrapping and line-spacing invalidation replace the field's line array.
+const boundsCache = new WeakMap();
+/**
+ * Measures the complete glyph block, retaining nominal rows for blank lines.
+ * Outlines belong to render padding and do not change alignment.
+ */
+export function getTextBlockBounds(field) {
+    const lines = field.getLinesArr();
+    const cached = boundsCache.get(lines);
+    if (cached)
+        return cached;
+    let top = Infinity;
+    let bottom = -Infinity;
+    let lineTop = 0;
+    for (const line of lines) {
+        const hasInk = line.inkAscent + line.inkDescent > 0;
+        top = Math.min(top, lineTop + (hasInk ? line.baseline - line.inkAscent : 0));
+        bottom = Math.max(bottom, lineTop + (hasInk ? line.baseline + line.inkDescent : line.height));
+        lineTop += line.height + field.lineSpacing;
+    }
+    const bounds = { top: top === Infinity ? 0 : top, bottom: bottom === -Infinity ? 0 : bottom };
+    boundsCache.set(lines, bounds);
+    return bounds;
+}
+//# sourceMappingURL=TextBlockBounds.js.map

package/dist/kurot/text/TextBlockBounds.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"TextBlockBounds.js","sourceRoot":"","sources":["../../../src/kurot/text/TextBlockBounds.ts"],"names":[],"mappings":"AAQA,+EAA+E;AAC/E,MAAM,WAAW,GAAG,IAAI,OAAO,EAAmC,CAAC;AAEnE;;;GAGG;AACH,MAAM,UAAU,kBAAkB,CAAC,KAAgB;IAClD,MAAM,KAAK,GAAG,KAAK,CAAC,WAAW,EAAE,CAAC;IAClC,MAAM,MAAM,GAAG,WAAW,CAAC,GAAG,CAAC,KAAK,CAAC,CAAC;IACtC,IAAI,MAAM;QAAE,OAAO,MAAM,CAAC;IAE1B,IAAI,GAAG,GAAG,QAAQ,CAAC;IACnB,IAAI,MAAM,GAAG,CAAC,QAAQ,CAAC;IACvB,IAAI,OAAO,GAAG,CAAC,CAAC;IAChB,KAAK,MAAM,IAAI,IAAI,KAAK,EAAE,CAAC;QAC1B,MAAM,MAAM,GAAG,IAAI,CAAC,SAAS,GAAG,IAAI,CAAC,UAAU,GAAG,CAAC,CAAC;QACpD,GAAG,GAAG,IAAI,CAAC,GAAG,CAAC,GAAG,EAAE,OAAO,GAAG,CAAC,MAAM,CAAC,CAAC,CAAC,IAAI,CAAC,QAAQ,GAAG,IAAI,CAAC,SAAS,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC;QAC7E,MAAM,GAAG,IAAI,CAAC,GAAG,CAAC,MAAM,EAAE,OAAO,GAAG,CAAC,MAAM,CAAC,CAAC,CAAC,IAAI,CAAC,QAAQ,GAAG,IAAI,CAAC,UAAU,CAAC,CAAC,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC,CAAC;QAC9F,OAAO,IAAI,IAAI,CAAC,MAAM,GAAG,KAAK,CAAC,WAAW,CAAC;IAC5C,CAAC;IAED,MAAM,MAAM,GAAG,EAAE,GAAG,EAAE,GAAG,KAAK,QAAQ,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,GAAG,EAAE,MAAM,EAAE,MAAM,KAAK,CAAC,QAAQ,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,MAAM,EAAE,CAAC;IAC9F,WAAW,CAAC,GAAG,CAAC,KAAK,EAAE,MAAM,CAAC,CAAC;IAC/B,OAAO,MAAM,CAAC;AACf,CAAC"}

package/dist/kurot/text/TextRenderBounds.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"TextRenderBounds.d.ts","sourceRoot":"","sources":["../../../src/kurot/text/TextRenderBounds.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,gBAAgB,CAAC;AAIhD;;;GAGG;AACH,wBAAgB,oBAAoB,CAAC,SAAS,EAAE,SAAS,GAAG,MAAM,CAqBjE"}
+{"version":3,"file":"TextRenderBounds.d.ts","sourceRoot":"","sources":["../../../src/kurot/text/TextRenderBounds.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,gBAAgB,CAAC;AAKhD;;;GAGG;AACH,wBAAgB,oBAAoB,CAAC,SAAS,EAAE,SAAS,GAAG,MAAM,CAuBjE"}

package/dist/kurot/text/TextRenderBounds.js

@@ -1,3 +1,4 @@
+import { getTextBlockBounds } from './TextBlockBounds.js';
 import { TextFieldType } from './enums/TextFieldType.js';
 import { VerticalAlign } from './enums/VerticalAlign.js';
 /**
@@ -9,10 +10,12 @@ export function getTextRenderPadding(textField) {
         return 0;
     let stroke = 0;
     let overhang = 0;
+    const bounds = getTextBlockBounds(textField);
+    const baselineShift = textField.verticalAlign === VerticalAlign.MIDDLE
+        ? (textField.textHeight - bounds.top - bounds.bottom) / 2 : 0;
     for (const line of textField.getLinesArr()) {
         if (line.inkAscent + line.inkDescent > 0) {
-            const baseline = !textField.multiline && textField.verticalAlign === VerticalAlign.MIDDLE
-                ? (line.height + line.inkAscent - line.inkDescent) / 2 : line.baseline;
+            const baseline = line.baseline + baselineShift;
             overhang = Math.max(overhang, line.inkAscent - baseline, baseline + line.inkDescent - line.height);
         }
         for (const element of line.elements) {

package/dist/kurot/text/TextRenderBounds.js.map

@@ -1 +1 @@
-{"version":3,"file":"TextRenderBounds.js","sourceRoot":"","sources":["../../../src/kurot/text/TextRenderBounds.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,aAAa,EAAE,MAAM,0BAA0B,CAAC;AACzD,OAAO,EAAE,aAAa,EAAE,MAAM,0BAA0B,CAAC;AAEzD;;;GAGG;AACH,MAAM,UAAU,oBAAoB,CAAC,SAAoB;IACxD,IAAI,SAAS,CAAC,IAAI,KAAK,aAAa,CAAC,KAAK;QAAE,OAAO,CAAC,CAAC;IAErD,IAAI,MAAM,GAAG,CAAC,CAAC;IACf,IAAI,QAAQ,GAAG,CAAC,CAAC;IACjB,KAAK,MAAM,IAAI,IAAI,SAAS,CAAC,WAAW,EAAE,EAAE,CAAC;QAC5C,IAAI,IAAI,CAAC,SAAS,GAAG,IAAI,CAAC,UAAU,GAAG,CAAC,EAAE,CAAC;YAC1C,MAAM,QAAQ,GAAG,CAAC,SAAS,CAAC,SAAS,IAAI,SAAS,CAAC,aAAa,KAAK,aAAa,CAAC,MAAM;gBACxF,CAAC,CAAC,CAAC,IAAI,CAAC,MAAM,GAAG,IAAI,CAAC,SAAS,GAAG,IAAI,CAAC,UAAU,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,QAAQ,CAAC;YACxE,QAAQ,GAAG,IAAI,CAAC,GAAG,CAAC,QAAQ,EAAE,IAAI,CAAC,SAAS,GAAG,QAAQ,EAAE,QAAQ,GAAG,IAAI,CAAC,UAAU,GAAG,IAAI,CAAC,MAAM,CAAC,CAAC;QACpG,CAAC;QACD,KAAK,MAAM,OAAO,IAAI,IAAI,CAAC,QAAQ,EAAE,CAAC;YACrC,MAAM,KAAK,GAAG,OAAO,CAAC,KAAK,EAAE,MAAM,IAAI,SAAS,CAAC,MAAM,CAAC;YACxD,IAAI,MAAM,CAAC,QAAQ,CAAC,KAAK,CAAC,IAAI,KAAK,GAAG,MAAM,EAAE,CAAC;gBAC9C,MAAM,GAAG,KAAK,CAAC;YAChB,CAAC;QACF,CAAC;IACF,CAAC;IAED,yEAAyE;IACzE,OAAO,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,MAAM,GAAG,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC,QAAQ,GAAG,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,QAAQ,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC;AACpG,CAAC"}
+{"version":3,"file":"TextRenderBounds.js","sourceRoot":"","sources":["../../../src/kurot/text/TextRenderBounds.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,kBAAkB,EAAE,MAAM,sBAAsB,CAAC;AAC1D,OAAO,EAAE,aAAa,EAAE,MAAM,0BAA0B,CAAC;AACzD,OAAO,EAAE,aAAa,EAAE,MAAM,0BAA0B,CAAC;AAEzD;;;GAGG;AACH,MAAM,UAAU,oBAAoB,CAAC,SAAoB;IACxD,IAAI,SAAS,CAAC,IAAI,KAAK,aAAa,CAAC,KAAK;QAAE,OAAO,CAAC,CAAC;IAErD,IAAI,MAAM,GAAG,CAAC,CAAC;IACf,IAAI,QAAQ,GAAG,CAAC,CAAC;IACjB,MAAM,MAAM,GAAG,kBAAkB,CAAC,SAAS,CAAC,CAAC;IAC7C,MAAM,aAAa,GAAG,SAAS,CAAC,aAAa,KAAK,aAAa,CAAC,MAAM;QACrE,CAAC,CAAC,CAAC,SAAS,CAAC,UAAU,GAAG,MAAM,CAAC,GAAG,GAAG,MAAM,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC;IAC/D,KAAK,MAAM,IAAI,IAAI,SAAS,CAAC,WAAW,EAAE,EAAE,CAAC;QAC5C,IAAI,IAAI,CAAC,SAAS,GAAG,IAAI,CAAC,UAAU,GAAG,CAAC,EAAE,CAAC;YAC1C,MAAM,QAAQ,GAAG,IAAI,CAAC,QAAQ,GAAG,aAAa,CAAC;YAC/C,QAAQ,GAAG,IAAI,CAAC,GAAG,CAAC,QAAQ,EAAE,IAAI,CAAC,SAAS,GAAG,QAAQ,EAAE,QAAQ,GAAG,IAAI,CAAC,UAAU,GAAG,IAAI,CAAC,MAAM,CAAC,CAAC;QACpG,CAAC;QACD,KAAK,MAAM,OAAO,IAAI,IAAI,CAAC,QAAQ,EAAE,CAAC;YACrC,MAAM,KAAK,GAAG,OAAO,CAAC,KAAK,EAAE,MAAM,IAAI,SAAS,CAAC,MAAM,CAAC;YACxD,IAAI,MAAM,CAAC,QAAQ,CAAC,KAAK,CAAC,IAAI,KAAK,GAAG,MAAM,EAAE,CAAC;gBAC9C,MAAM,GAAG,KAAK,CAAC;YAChB,CAAC;QACF,CAAC;IACF,CAAC;IAED,yEAAyE;IACzE,OAAO,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,MAAM,GAAG,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC,QAAQ,GAAG,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,QAAQ,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC;AACpG,CAAC"}

package/dist/kurot/text/TextVerticalLayout.d.ts

@@ -1,7 +1,7 @@
 import type { TextField } from './TextField.js';
 /**
- * Single-line dynamic middle alignment centers visible ink. Multiline and input
- * retain nominal line boxes so changing glyphs cannot move their baselines.
+ * Dynamic middle alignment centers the complete glyph block independently of
+ * multiline. Input retains nominal rows for stable editing geometry.
  */
 export declare function getTextVerticalOffset(field: TextField): number;
 //# sourceMappingURL=TextVerticalLayout.d.ts.map

package/dist/kurot/text/TextVerticalLayout.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"TextVerticalLayout.d.ts","sourceRoot":"","sources":["../../../src/kurot/text/TextVerticalLayout.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,gBAAgB,CAAC;AAIhD;;;GAGG;AACH,wBAAgB,qBAAqB,CAAC,KAAK,EAAE,SAAS,GAAG,MAAM,CAe9D"}
+{"version":3,"file":"TextVerticalLayout.d.ts","sourceRoot":"","sources":["../../../src/kurot/text/TextVerticalLayout.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,gBAAgB,CAAC;AAKhD;;;GAGG;AACH,wBAAgB,qBAAqB,CAAC,KAAK,EAAE,SAAS,GAAG,MAAM,CAa9D"}

package/dist/kurot/text/TextVerticalLayout.js

@@ -1,17 +1,16 @@
+import { getTextBlockBounds } from './TextBlockBounds.js';
 import { TextFieldType } from './enums/TextFieldType.js';
 import { VerticalAlign } from './enums/VerticalAlign.js';
 /**
- * Single-line dynamic middle alignment centers visible ink. Multiline and input
- * retain nominal line boxes so changing glyphs cannot move their baselines.
+ * Dynamic middle alignment centers the complete glyph block independently of
+ * multiline. Input retains nominal rows for stable editing geometry.
  */
 export function getTextVerticalOffset(field) {
-    const lines = field.getLinesArr();
     const height = !isNaN(field.$explicitHeight) ? field.$explicitHeight : field.textHeight;
-    const line = lines[0];
     if (field.verticalAlign === VerticalAlign.MIDDLE) {
-        if (field.type === TextFieldType.DYNAMIC && !field.multiline && line
-            && line.inkAscent + line.inkDescent > 0) {
-            return (height - line.inkAscent - line.inkDescent) / 2 + line.inkAscent - line.baseline;
+        if (field.type === TextFieldType.DYNAMIC) {
+            const bounds = getTextBlockBounds(field);
+            return (height - bounds.top - bounds.bottom) / 2;
         }
         return Math.max(0, (height - field.textHeight) / 2);
     }

package/dist/kurot/text/TextVerticalLayout.js.map

@@ -1 +1 @@
-{"version":3,"file":"TextVerticalLayout.js","sourceRoot":"","sources":["../../../src/kurot/text/TextVerticalLayout.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,aAAa,EAAE,MAAM,0BAA0B,CAAC;AACzD,OAAO,EAAE,aAAa,EAAE,MAAM,0BAA0B,CAAC;AAEzD;;;GAGG;AACH,MAAM,UAAU,qBAAqB,CAAC,KAAgB;IACrD,MAAM,KAAK,GAAG,KAAK,CAAC,WAAW,EAAE,CAAC;IAClC,MAAM,MAAM,GAAG,CAAC,KAAK,CAAC,KAAK,CAAC,eAAe,CAAC,CAAC,CAAC,CAAC,KAAK,CAAC,eAAe,CAAC,CAAC,CAAC,KAAK,CAAC,UAAU,CAAC;IACxF,MAAM,IAAI,GAAG,KAAK,CAAC,CAAC,CAAC,CAAC;IACtB,IAAI,KAAK,CAAC,aAAa,KAAK,aAAa,CAAC,MAAM,EAAE,CAAC;QAClD,IAAI,KAAK,CAAC,IAAI,KAAK,aAAa,CAAC,OAAO,IAAI,CAAC,KAAK,CAAC,SAAS,IAAI,IAAI;eAChE,IAAI,CAAC,SAAS,GAAG,IAAI,CAAC,UAAU,GAAG,CAAC,EAAE,CAAC;YAC1C,OAAO,CAAC,MAAM,GAAG,IAAI,CAAC,SAAS,GAAG,IAAI,CAAC,UAAU,CAAC,GAAG,CAAC,GAAG,IAAI,CAAC,SAAS,GAAG,IAAI,CAAC,QAAQ,CAAC;QACzF,CAAC;QACD,OAAO,IAAI,CAAC,GAAG,CAAC,CAAC,EAAE,CAAC,MAAM,GAAG,KAAK,CAAC,UAAU,CAAC,GAAG,CAAC,CAAC,CAAC;IACrD,CAAC;IACD,IAAI,KAAK,CAAC,aAAa,KAAK,aAAa,CAAC,MAAM,EAAE,CAAC;QAClD,OAAO,IAAI,CAAC,GAAG,CAAC,CAAC,EAAE,MAAM,GAAG,KAAK,CAAC,UAAU,CAAC,CAAC;IAC/C,CAAC;IACD,OAAO,CAAC,CAAC;AACV,CAAC"}
+{"version":3,"file":"TextVerticalLayout.js","sourceRoot":"","sources":["../../../src/kurot/text/TextVerticalLayout.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,kBAAkB,EAAE,MAAM,sBAAsB,CAAC;AAC1D,OAAO,EAAE,aAAa,EAAE,MAAM,0BAA0B,CAAC;AACzD,OAAO,EAAE,aAAa,EAAE,MAAM,0BAA0B,CAAC;AAEzD;;;GAGG;AACH,MAAM,UAAU,qBAAqB,CAAC,KAAgB;IACrD,MAAM,MAAM,GAAG,CAAC,KAAK,CAAC,KAAK,CAAC,eAAe,CAAC,CAAC,CAAC,CAAC,KAAK,CAAC,eAAe,CAAC,CAAC,CAAC,KAAK,CAAC,UAAU,CAAC;IACxF,IAAI,KAAK,CAAC,aAAa,KAAK,aAAa,CAAC,MAAM,EAAE,CAAC;QAClD,IAAI,KAAK,CAAC,IAAI,KAAK,aAAa,CAAC,OAAO,EAAE,CAAC;YAC1C,MAAM,MAAM,GAAG,kBAAkB,CAAC,KAAK,CAAC,CAAC;YACzC,OAAO,CAAC,MAAM,GAAG,MAAM,CAAC,GAAG,GAAG,MAAM,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC;QAClD,CAAC;QACD,OAAO,IAAI,CAAC,GAAG,CAAC,CAAC,EAAE,CAAC,MAAM,GAAG,KAAK,CAAC,UAAU,CAAC,GAAG,CAAC,CAAC,CAAC;IACrD,CAAC;IACD,IAAI,KAAK,CAAC,aAAa,KAAK,aAAa,CAAC,MAAM,EAAE,CAAC;QAClD,OAAO,IAAI,CAAC,GAAG,CAAC,CAAC,EAAE,MAAM,GAAG,KAAK,CAAC,UAAU,CAAC,CAAC;IAC/C,CAAC;IACD,OAAO,CAAC,CAAC;AACV,CAAC"}

package/docs/ai-context.md

@@ -1,7 +1,8 @@
 # @kurot/core — AI context map
 
-Core 2.5.0 is prepared for publication, not yet published. Latest verified npm
-release is 2.4.0. Read
+Core 2.5.1 is prepared, not published, with dynamic middle alignment independent
+of multiline. Core 2.5.0 remains the latest verified registry release
+(2026-10-10). Read
 [centered flips](../../../docs/centered-flips.md) before changing transforms,
 reflection frames, authored flags or dependency adoption.
 
@@ -15,7 +16,7 @@ agent unfamiliar with Kurot does not need to re-derive the architecture from
 scratch on every session. Treat the package source and its `src/index.ts`
 barrel as the authority for current behavior and exports.
 
-Package identity: `@kurot/core@2.5.0`, pending publication. It provides Kurot's scene graph,
+Package identity: `@kurot/core@2.5.1`, prepared, not published. It provides Kurot's scene graph,
 events, rendering, text, resource, network and media runtime. Rendering uses a
 flat `InstructionSet + RenderPipe` pipeline. ES2022 / evergreen browsers only
 with `strict: true`. Two
@@ -53,7 +54,7 @@ src/kurot/
 │                   push/pop scene integration in player/pipes/.
 ├── text/           TextField, BitmapText/BitmapFont, StageText (DOM overlay, INPUT mode only),
 │                   HtmlTextParser, InputController, TextMeasurer, TextSegmentation,
-│                   LineBreaks, TextLineLayout, WordWrap.
+│                   LineBreaks, TextLineLayout, TextBlockBounds, TextVerticalLayout, WordWrap.
 ├── resource/        Resource class + `resource` singleton, ResourceLoader, analyzers/
 │                   (Image/Json/Text/Sound/Sheet/Font). Async, resource.json-driven (RES-compatible).
 ├── net/            HttpRequest, ImageLoader. Low-level; resource/analyzers build on these.
@@ -227,7 +228,7 @@ Re-export order: `events`, `geom`, `utils`, `display`, `net`, `filters`,
 | Change how instructions are built/executed | `player/webgl/WebGLRenderer.ts`, `player/InstructionSet.ts`                                                                                                                     |
 | Add a new resource type/parser             | `resource/analyzers/`, register in `Resource.ts`                                                                                                                                |
 | Debug a texture-batching issue             | `player/webgl/MultiTextureBatcher.ts`, `player/webgl/WebGLDrawCmdManager.ts`                                                                                                    |
-| Change text layout/wrapping                | `text/LineBreaks.ts`, `text/TextLineLayout.ts`, `text/TextSegmentation.ts`, `text/TextMeasurer.ts`; `docs/text-layout.md`                                                       |
+| Change text layout/wrapping                | `text/LineBreaks.ts`, `text/TextLineLayout.ts`, `text/TextBlockBounds.ts`, `text/TextVerticalLayout.ts`, `text/TextSegmentation.ts`, `text/TextMeasurer.ts`; `docs/text-layout.md`                                                       |
 | Understand dirty-flag propagation          | `display/DisplayObject.ts` (`$markDirty`, `$cacheDirtyUp`, `$renderDirtyUp`)                                                                                                    |
 | Run perf tests                             | `examples/benchmark/`, `pnpm benchmark`; automated Kurot/PixiJS/Egret comparison via `pnpm benchmark:compare`                                                                   |
 
@@ -240,17 +241,21 @@ vertices, UVs, or indices, call updateVertices(). WebGL keeps Mesh indices
 separate from quad indices and splits oversized meshes into ordered batches
 with local index remapping (player/webgl/split-mesh.ts).
 
-## Text alignment in 2.5.0
+## Text alignment in 2.5.1
 
 `TextLineLayout.ts` caches alphabetic `baseline` and visible `inkAscent` /
-`inkDescent` per line. `TextVerticalLayout.ts` centers ink only for dynamic,
-single-line middle alignment. Multiline/INPUT/top/bottom retain nominal rows
-with content-independent font frames, including blank lines. Canvas, WebGL
+`inkDescent` per line. `TextBlockBounds.ts` caches the union of row glyph bounds,
+using nominal rows for blank lines. `TextVerticalLayout.ts` centers the entire
+dynamic block in either line mode. Multiline only controls line generation;
+input/top/bottom retain nominal alignment with content-independent font frames.
+Relative row baselines and spacing stay stable, but a dynamic middle block can
+translate when its glyph extents change. Canvas, WebGL
 rasterization and link hit testing share the offset. Render bounds add glyph
 margin without changing measurement, input or external clip boundaries. See
-[text layout](text-layout.md#visual-centering-and-stable-baselines-core-250).
-Core 2.4.0 on npm does not include this correction; existing consumer peer ranges
-accept 2.5.0 without SDK bumps. Adoption updates the Core installation/lock.
+[text layout](text-layout.md#middle-alignment-independent-of-line-mode-core-251).
+Published Core 2.5.0 centers only single-line dynamic ink. Version 2.5.1 is
+prepared, not published; existing consumer peers accept it without SDK bumps.
+Adoption requires an explicit installation/lock update and rebuild after release.
 
 ## Text layout in 2.0.1
 

package/docs/architecture.md

@@ -1,6 +1,6 @@
 # @kurot/core architecture
 
-> Package version: 2.5.0 (pending publication; latest verified npm release: 2.4.0). See [CHANGELOG.md](../CHANGELOG.md) for release notes.
+> Package version: 2.5.0 (published; registry version metadata verified on 2026-10-10). See [CHANGELOG.md](../CHANGELOG.md) for release notes.
 > The [AI context map](./ai-context.md) covers directories, non-obvious behavior,
 > terminology and task-to-file references. This document explains design choices
 > and internal mechanisms for contributors; the two documents complement each other.

package/docs/text-layout.md

@@ -40,8 +40,60 @@ Dictionary and grapheme segmentation follow the browser's `Intl` data. The
 pinned Unicode 17.0 tables govern the line-break profile; they do not replace
 the browser's grapheme implementation.
 
+## Middle alignment independent of line mode (Core 2.5.1)
+
+Core 2.5.1 is prepared, not published. The current verified registry release is
+2.5.0. Its single-line-only visual centering is described in the following section.
+
+`multiline` controls hard breaks and width wrapping. Dynamic
+`verticalAlign = "middle"` centers the complete laid-out glyph block in either
+line mode. Identical single-row content, font and bounds produce identical
+placement with `multiline = true` or `false`, including automatic height.
+Multiple rows receive one shared translation; their relative alphabetic baselines
+and line spacing are preserved. Rich runs and fallback glyphs participate in the
+same block bounds. Each blank/whitespace-only row contributes its nominal height,
+including leading and trailing blank rows. An entirely blank block uses those
+nominal rows. Outlines remain render-only and do not affect alignment.
+
+```ts
+textField.multiline = true;
+textField.verticalAlign = 'middle';
+textField.text = 'First line\nSecond line';
+```
+
+The visible block is centered within the explicit height, or the nominal content
+height when height is automatic. An overflowing dynamic block remains centered;
+ordinary viewport clipping and scrolling still apply. Changing the outer glyph
+extents can translate the complete block, without changing its row baselines or
+distances. The cache reuses block bounds until font/content/wrapping/spacing
+invalidation replaces the line layout.
+
+INPUT continues to align its stable editing rows in either line mode. Caret,
+selection, composition underline and pointer-to-character mapping use those rows,
+so changing glyphs cannot move the editing frame. `top` and `bottom` retain their
+nominal-row semantics. `textHeight`, `measureText()`, automatic dimensions, font
+fitting and wrapping measurements retain their existing contracts.
+
+Canvas, WebGL text rasterization, link hit tests and glyph/outline capture margins
+share the block alignment. External masks/scrollRect and input viewports keep
+their authored clip boundaries. No new public property, runtime dependency or
+XML/resource format is introduced. Existing multiline dynamic middle-aligned
+captions can move compared with 2.5.0; adopt the released Core patch and rebuild
+the application to receive the change. Existing SDK peers accept the patch.
+
+Unit checks cover both line modes, complete paragraphs, mixed-size rich text,
+blank rows, font/spacing invalidation, top/bottom, short viewports, links and
+single/multiline input caret/selection. The minified browser checks compare
+independent Canvas measurements and actual pixels in Canvas and WebGL 1/2 at
+1×/2×, including multilingual text, wrapping, caches, outlines, caret, selection,
+composition decoration and input character hits.
+
 ## Visual centering and stable baselines (Core 2.5.0)
 
+This section records the published 2.5.0 behavior. Version 2.5.1 extends dynamic
+middle alignment to multiple rows as described above; input and top/bottom retain
+the contracts below.
+
 Canvas and WebGL use the same alphabetic baseline and logical-pixel Canvas
 `TextMetrics`. Each cached line records `baseline`, `inkAscent` and `inkDescent`;
 rich runs share that baseline, even when their sizes or font families differ.
@@ -66,11 +118,10 @@ or operating-system offset table is used.
   the actual selected glyphs rather than promising identical pixels.
 
 See the [Canvas TextMetrics contract](https://html.spec.whatwg.org/multipage/canvas.html#textmetrics).
-The correction is included in Core 2.5.0, pending publication; it is not in
+The correction is included in published Core 2.5.0; it is not in
 published Core 2.4.0. There is no new alignment
 property, runtime dependency or XML format. Default KUI single-line control
-labels use the existing flags with symmetric padding. Adopt Core 2.5.0 after
-publication and rebuild to receive this behavior; SDK peers need no
+labels use the existing flags with symmetric padding. Adopt Core 2.5.0 and rebuild to receive this behavior; SDK peers need no
 incidental change.
 
 `test/TextVerticalLayout.test.ts` covers ink centering, mixed sizes, stable input

package/docs/texture-density.md

@@ -1,7 +1,7 @@
 # Texture density
 
-This API is included in Core 2.5.0, prepared for publication but not yet
-published. Published Core 2.4.0 and earlier do not interpret sheet `resolution`.
+This API is included in published Core 2.5.0, with registry version metadata
+verified on 2026-10-10. Published Core 2.4.0 and earlier do not interpret sheet `resolution`.
 
 `new Texture(resolution)` describes source pixels per logical unit. The default
 is 1; the value must be finite and positive, is immutable, and is inherited by

package/package.json

@@ -1,6 +1,6 @@
 {
 	"name": "@kurot/core",
-	"version": "2.5.0",
+	"version": "2.5.1",
 	"description": "Modern rewrite of the Egret game engine — WebGL multi-texture batching, instruction-driven render pipeline, strict TypeScript, Egret-compatible API",
 	"author": "Kelvin <kyia.x52@gmail.com>",
 	"license": "MIT",