@kurot/core 2.1.0 → 2.2.0

package/dist/kurot/text/BitmapText.js

@@ -1,48 +1,62 @@
+import { layoutBitmapText } from '@kurot/bitmap-font';
 import { DisplayObject } from '../display/DisplayObject.js';
-import { HorizontalAlign } from './enums/HorizontalAlign.js';
-import { VerticalAlign } from './enums/VerticalAlign.js';
 /**
- * Renders text using a BitmapFont (texture atlas), avoiding system font rendering differences.
+ * Draws atlas glyphs directly through WebGL batching or Canvas 2D.
+ * Width wraps by code point; use multiline=false for one unwrapped line.
+ * Fonts are borrowed. Missing glyphs are skipped; U+0020 has a fallback advance.
  */
 export class BitmapText extends DisplayObject {
+    // ── Static fields ─────────────────────────────────────────────────────────
+    /**
+     * @deprecated Font layout uses its explicit spaceAdvance metric.
+     * Set that metric in font data before constructing a font.
+     */
     static EMPTY_FACTOR = 0.33;
+    // ── Instance fields ──────────────────────────────────────────────────────
     _text = '';
     _font;
     _lineSpacing = 0;
     _letterSpacing = 0;
-    _textAlign = HorizontalAlign.LEFT;
-    _verticalAlign = VerticalAlign.TOP;
+    _textAlign = 'left';
+    _verticalAlign = 'top';
+    _smoothing = true;
+    _multiline = true;
+    _layout;
+    // ── Constructor ──────────────────────────────────────────────────────────
+    constructor() {
+        super();
+        this.$renderObjectType = 7 /* RenderObjectType.BITMAP_TEXT */;
+    }
+    // ── Getters / Setters ─────────────────────────────────────────────────────
+    get width() {
+        return super.width;
+    }
     set width(value) {
-        const v = isNaN(value) ? NaN : value;
-        if (this.$explicitWidth === v)
+        if (Object.is(this.$explicitWidth, value))
             return;
-        this.$explicitWidth = v;
+        if (!Number.isNaN(value) && (!Number.isFinite(value) || value < 0))
+            throw new RangeError('BitmapText.width must be nonnegative or NaN.');
+        this.$explicitWidth = value;
         this._invalidate();
     }
+    get height() {
+        return super.height;
+    }
     set height(value) {
-        const v = isNaN(value) ? NaN : value;
-        if (this.$explicitHeight === v)
+        if (Object.is(this.$explicitHeight, value))
             return;
-        this.$explicitHeight = v;
+        if (!Number.isNaN(value) && (!Number.isFinite(value) || value < 0))
+            throw new RangeError('BitmapText.height must be nonnegative or NaN.');
+        this.$explicitHeight = value;
         this._invalidate();
     }
-    _smoothing = true;
-    _textLinesChanged = false;
-    _textLines = [];
-    _textLinesWidth = [];
-    _lineHeights = [];
-    _textWidth = 0;
-    _textHeight = 0;
-    _textStartX = 0;
-    _textStartY = 0;
     get text() {
         return this._text;
     }
     set text(value) {
-        const v = value ?? '';
-        if (this._text === v)
+        if (this._text === value)
             return;
-        this._text = v;
+        this._text = value;
         this._invalidate();
     }
     get font() {
@@ -60,6 +74,8 @@ export class BitmapText extends DisplayObject {
     set lineSpacing(value) {
         if (this._lineSpacing === value)
             return;
+        if (!Number.isFinite(value) || value < 0)
+            throw new RangeError('BitmapText.lineSpacing must be finite and nonnegative.');
         this._lineSpacing = value;
         this._invalidate();
     }
@@ -69,6 +85,8 @@ export class BitmapText extends DisplayObject {
     set letterSpacing(value) {
         if (this._letterSpacing === value)
             return;
+        if (!Number.isFinite(value))
+            throw new RangeError('BitmapText.letterSpacing must be finite.');
         this._letterSpacing = value;
         this._invalidate();
     }
@@ -78,6 +96,8 @@ export class BitmapText extends DisplayObject {
     set textAlign(value) {
         if (this._textAlign === value)
             return;
+        if (!['left', 'center', 'right'].includes(value))
+            throw new RangeError('Invalid bitmap text alignment.');
         this._textAlign = value;
         this._invalidate();
     }
@@ -87,6 +107,8 @@ export class BitmapText extends DisplayObject {
     set verticalAlign(value) {
         if (this._verticalAlign === value)
             return;
+        if (!['top', 'middle', 'bottom'].includes(value))
+            throw new RangeError('Invalid bitmap text vertical alignment.');
         this._verticalAlign = value;
         this._invalidate();
     }
@@ -99,141 +121,71 @@ export class BitmapText extends DisplayObject {
         this._smoothing = value;
         this.$markDirty();
     }
+    get multiline() {
+        return this._multiline;
+    }
+    set multiline(value) {
+        if (this._multiline === value)
+            return;
+        this._multiline = value;
+        this._invalidate();
+    }
     get textWidth() {
-        this._ensureLines();
-        return this._textWidth;
+        return this.getLayout().width;
     }
     get textHeight() {
-        this._ensureLines();
-        return this._textHeight;
-    }
-    $measureContentBounds(bounds) {
-        this._ensureLines();
-        if (this._textLines.length === 0) {
-            bounds.setEmpty();
-        }
-        else {
-            bounds.setTo(this._textStartX, this._textStartY, this._textWidth, this._textHeight);
-        }
+        return this.getLayout().height;
+    }
+    // ── Public methods ───────────────────────────────────────────────────────
+    getLayout() {
+        this._layout ??= this.measureText(this.$explicitWidth, this.$explicitHeight);
+        return this._layout;
+    }
+    /**
+     * Measures with independent constraints without changing the rendered field.
+     * NaN means unconstrained; font, spacing, alignment and multiline are retained.
+     */
+    measureText(width = NaN, height = NaN) {
+        return this._font
+            ? layoutBitmapText(this._font.data, this._text, {
+                width: Number.isNaN(width) ? undefined : width,
+                height: Number.isNaN(height) ? undefined : height,
+                lineSpacing: this._lineSpacing,
+                letterSpacing: this._letterSpacing,
+                textAlign: this._textAlign,
+                verticalAlign: this._verticalAlign,
+                multiline: this._multiline,
+            })
+            : { glyphs: [], lines: [], width: 0, height: 0, startX: 0, startY: 0, bounds: { x: 0, y: 0, width: 0, height: 0 } };
+    }
+    getGlyphs() {
+        return this.getLayout().glyphs;
     }
     getTextLines() {
-        return this._ensureLines();
+        return this.getLayout().lines.map(line => line.text);
     }
     getTextLinesWidth() {
-        this._ensureLines();
-        return this._textLinesWidth;
+        return this.getLayout().lines.map(line => line.width);
     }
     getLineHeights() {
-        this._ensureLines();
-        return this._lineHeights;
+        return this.getLayout().lines.map(line => line.height);
     }
     getTextStartX() {
-        this._ensureLines();
-        return this._textStartX;
+        return this.getLayout().startX;
     }
     getTextStartY() {
-        this._ensureLines();
-        return this._textStartY;
+        return this.getLayout().startY;
     }
+    // ── Override methods ─────────────────────────────────────────────────────
+    $measureContentBounds(bounds) {
+        const measured = this.getLayout().bounds;
+        bounds.setTo(measured.x, measured.y, measured.width, measured.height);
+    }
+    // ── Private methods ──────────────────────────────────────────────────────
     _invalidate() {
-        this._textLinesChanged = true;
+        this._layout = undefined;
         this.$renderDirty = true;
         this.$markDirty();
     }
-    _ensureLines() {
-        if (!this._textLinesChanged)
-            return this._textLines;
-        this._textLinesChanged = false;
-        this._textLines = [];
-        this._textLinesWidth = [];
-        this._lineHeights = [];
-        this._textWidth = 0;
-        this._textHeight = 0;
-        const font = this._font;
-        if (!this._text || !font)
-            return this._textLines;
-        const hasWidthSet = !isNaN(this.$explicitWidth);
-        const fieldWidth = this.$explicitWidth;
-        const fieldHeight = this.$explicitHeight;
-        const emptyHeight = font.getFirstCharHeight();
-        const emptyWidth = Math.ceil(emptyHeight * BitmapText.EMPTY_FACTOR);
-        const textArr = this._text.split(/(?:\r\n|\r|\n)/);
-        let totalWidth = 0;
-        let totalHeight = 0;
-        const pushLine = (str, lh, lw) => {
-            if (!isNaN(fieldHeight) && this._textLines.length > 0 && totalHeight > fieldHeight)
-                return false;
-            totalHeight += lh + this._lineSpacing;
-            this._textLines.push(str);
-            this._lineHeights.push(lh);
-            this._textLinesWidth.push(lw);
-            totalWidth = Math.max(lw, totalWidth);
-            return true;
-        };
-        for (let i = 0; i < textArr.length; i++) {
-            let line = textArr[i];
-            let len = line.length;
-            let lineHeight = 0;
-            let xPos = 0;
-            let isFirstChar = true;
-            for (let j = 0; j < len; j++) {
-                if (!isFirstChar)
-                    xPos += this._letterSpacing;
-                const ch = line.charAt(j);
-                const texture = font.getTexture(ch);
-                let texW;
-                let texH;
-                if (!texture) {
-                    if (ch === ' ') {
-                        texW = emptyWidth;
-                        texH = emptyHeight;
-                    }
-                    else {
-                        if (isFirstChar)
-                            isFirstChar = false;
-                        continue;
-                    }
-                }
-                else {
-                    texW = texture.textureWidth;
-                    texH = texture.textureHeight;
-                }
-                if (isFirstChar)
-                    isFirstChar = false;
-                if (hasWidthSet && j > 0 && xPos + texW > fieldWidth) {
-                    if (!pushLine(line.substring(0, j), lineHeight, xPos))
-                        break;
-                    line = line.substring(j);
-                    len = line.length;
-                    j = 0;
-                    xPos = len === 1 ? texW : font.getConfig(ch, 'xadvance') || texW;
-                    lineHeight = texH;
-                    continue;
-                }
-                xPos += j === len - 1 ? texW : font.getConfig(ch, 'xadvance') || texW;
-                lineHeight = Math.max(texH, lineHeight);
-            }
-            if (!isNaN(fieldHeight) && i > 0 && totalHeight > fieldHeight)
-                break;
-            pushLine(line, lineHeight, xPos);
-        }
-        this._textWidth = totalWidth;
-        this._textHeight = Math.max(0, totalHeight - this._lineSpacing);
-        this._textStartX = 0;
-        this._textStartY = 0;
-        if (hasWidthSet && fieldWidth > totalWidth) {
-            if (this._textAlign === HorizontalAlign.RIGHT)
-                this._textStartX = fieldWidth - totalWidth;
-            else if (this._textAlign === HorizontalAlign.CENTER)
-                this._textStartX = Math.floor((fieldWidth - totalWidth) / 2);
-        }
-        if (!isNaN(fieldHeight) && fieldHeight > this._textHeight) {
-            if (this._verticalAlign === VerticalAlign.BOTTOM)
-                this._textStartY = fieldHeight - this._textHeight;
-            else if (this._verticalAlign === VerticalAlign.MIDDLE)
-                this._textStartY = Math.floor((fieldHeight - this._textHeight) / 2);
-        }
-        return this._textLines;
-    }
 }
 //# sourceMappingURL=BitmapText.js.map

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

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

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

@@ -4,6 +4,7 @@ export { TextFieldType } from './enums/TextFieldType.js';
 export { TextFieldInputType } from './enums/TextFieldInputType.js';
 export type { ITextStyle, ITextElement, IWTextElement, ILineElement, IHitTextElement } from './types/ITextElement.js';
 export { HtmlTextParser } from './HtmlTextParser.js';
+export type { BitmapFontOptions } from './BitmapFont.js';
 export { BitmapFont } from './BitmapFont.js';
 export { BitmapText } from './BitmapText.js';
 export { measureText, getFontString } from './TextMeasurer.js';

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

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/kurot/text/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,eAAe,EAAE,MAAM,4BAA4B,CAAC;AAC7D,OAAO,EAAE,aAAa,EAAE,MAAM,0BAA0B,CAAC;AACzD,OAAO,EAAE,aAAa,EAAE,MAAM,0BAA0B,CAAC;AACzD,OAAO,EAAE,kBAAkB,EAAE,MAAM,+BAA+B,CAAC;AACnE,YAAY,EAAE,UAAU,EAAE,YAAY,EAAE,aAAa,EAAE,YAAY,EAAE,eAAe,EAAE,MAAM,yBAAyB,CAAC;AACtH,OAAO,EAAE,cAAc,EAAE,MAAM,qBAAqB,CAAC;AACrD,OAAO,EAAE,UAAU,EAAE,MAAM,iBAAiB,CAAC;AAC7C,OAAO,EAAE,UAAU,EAAE,MAAM,iBAAiB,CAAC;AAC7C,OAAO,EAAE,WAAW,EAAE,aAAa,EAAE,MAAM,mBAAmB,CAAC;AAC/D,OAAO,EAAE,SAAS,EAAE,MAAM,gBAAgB,CAAC;AAC3C,OAAO,EAAE,SAAS,EAAE,MAAM,gBAAgB,CAAC;AAC3C,OAAO,EAAE,eAAe,EAAE,MAAM,sBAAsB,CAAC;AACvD,OAAO,EAAE,QAAQ,EAAE,cAAc,EAAE,MAAM,eAAe,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/kurot/text/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,eAAe,EAAE,MAAM,4BAA4B,CAAC;AAC7D,OAAO,EAAE,aAAa,EAAE,MAAM,0BAA0B,CAAC;AACzD,OAAO,EAAE,aAAa,EAAE,MAAM,0BAA0B,CAAC;AACzD,OAAO,EAAE,kBAAkB,EAAE,MAAM,+BAA+B,CAAC;AACnE,YAAY,EAAE,UAAU,EAAE,YAAY,EAAE,aAAa,EAAE,YAAY,EAAE,eAAe,EAAE,MAAM,yBAAyB,CAAC;AACtH,OAAO,EAAE,cAAc,EAAE,MAAM,qBAAqB,CAAC;AACrD,YAAY,EAAE,iBAAiB,EAAE,MAAM,iBAAiB,CAAC;AACzD,OAAO,EAAE,UAAU,EAAE,MAAM,iBAAiB,CAAC;AAC7C,OAAO,EAAE,UAAU,EAAE,MAAM,iBAAiB,CAAC;AAC7C,OAAO,EAAE,WAAW,EAAE,aAAa,EAAE,MAAM,mBAAmB,CAAC;AAC/D,OAAO,EAAE,SAAS,EAAE,MAAM,gBAAgB,CAAC;AAC3C,OAAO,EAAE,SAAS,EAAE,MAAM,gBAAgB,CAAC;AAC3C,OAAO,EAAE,eAAe,EAAE,MAAM,sBAAsB,CAAC;AACvD,OAAO,EAAE,QAAQ,EAAE,cAAc,EAAE,MAAM,eAAe,CAAC"}

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

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/kurot/text/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,eAAe,EAAE,MAAM,4BAA4B,CAAC;AAC7D,OAAO,EAAE,aAAa,EAAE,MAAM,0BAA0B,CAAC;AACzD,OAAO,EAAE,aAAa,EAAE,MAAM,0BAA0B,CAAC;AACzD,OAAO,EAAE,kBAAkB,EAAE,MAAM,+BAA+B,CAAC;AAEnE,OAAO,EAAE,cAAc,EAAE,MAAM,qBAAqB,CAAC;AACrD,OAAO,EAAE,UAAU,EAAE,MAAM,iBAAiB,CAAC;AAC7C,OAAO,EAAE,UAAU,EAAE,MAAM,iBAAiB,CAAC;AAC7C,OAAO,EAAE,WAAW,EAAE,aAAa,EAAE,MAAM,mBAAmB,CAAC;AAC/D,OAAO,EAAE,SAAS,EAAE,MAAM,gBAAgB,CAAC;AAC3C,OAAO,EAAE,SAAS,EAAE,MAAM,gBAAgB,CAAC;AAC3C,OAAO,EAAE,eAAe,EAAE,MAAM,sBAAsB,CAAC;AACvD,OAAO,EAAE,QAAQ,EAAE,cAAc,EAAE,MAAM,eAAe,CAAC"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/kurot/text/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,eAAe,EAAE,MAAM,4BAA4B,CAAC;AAC7D,OAAO,EAAE,aAAa,EAAE,MAAM,0BAA0B,CAAC;AACzD,OAAO,EAAE,aAAa,EAAE,MAAM,0BAA0B,CAAC;AACzD,OAAO,EAAE,kBAAkB,EAAE,MAAM,+BAA+B,CAAC;AAEnE,OAAO,EAAE,cAAc,EAAE,MAAM,qBAAqB,CAAC;AAErD,OAAO,EAAE,UAAU,EAAE,MAAM,iBAAiB,CAAC;AAC7C,OAAO,EAAE,UAAU,EAAE,MAAM,iBAAiB,CAAC;AAC7C,OAAO,EAAE,WAAW,EAAE,aAAa,EAAE,MAAM,mBAAmB,CAAC;AAC/D,OAAO,EAAE,SAAS,EAAE,MAAM,gBAAgB,CAAC;AAC3C,OAAO,EAAE,SAAS,EAAE,MAAM,gBAAgB,CAAC;AAC3C,OAAO,EAAE,eAAe,EAAE,MAAM,sBAAsB,CAAC;AACvD,OAAO,EAAE,QAAQ,EAAE,cAAc,EAAE,MAAM,eAAe,CAAC"}

package/docs/ai-context.md

@@ -5,7 +5,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.1.0`. It provides Kurot's scene graph,
+Package identity: `@kurot/core@2.2.0`. 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
@@ -28,7 +28,7 @@ src/kurot/
 ├── player/         Game loop + both render backends. Player, createPlayer(), SystemTicker/
 │                   ticker singleton, ScreenAdapter, TouchHandler. Backend-neutral abstractions
 │                   live here: RenderPipe / RenderContext / RenderBuffer interfaces (the latter
-│                   two are internal), InstructionSet, and pipes/ (Bitmap/Graphics/Mesh/Text/
+│                   two are internal), InstructionSet, and pipes/ (Bitmap/BitmapText/Graphics/Mesh/Text/
 │                   Filter/Mask/Particle). The WebGL instruction renderer consumes the pipes.
 │   ├── webgl/      WebGLRenderer, WebGLRenderContext, WebGLRenderBuffer/Target,
 │   │               WebGLVertexArrayObject, WebGLDrawCmdManager, MultiTextureBatcher,
@@ -44,7 +44,7 @@ src/kurot/
 ├── text/           TextField, BitmapText/BitmapFont, StageText (DOM overlay, INPUT mode only),
 │                   HtmlTextParser, InputController, TextMeasurer, LineBreaks, TextLineLayout, WordWrap.
 ├── resource/        Resource class + `resource` singleton, ResourceLoader, analyzers/
-│                   (Image/Json/Text/Sound/Sheet). Async, resource.json-driven (RES-compatible).
+│                   (Image/Json/Text/Sound/Sheet/Font). Async, resource.json-driven (RES-compatible).
 ├── net/            HttpRequest, ImageLoader. Low-level; resource/analyzers build on these.
 ├── media/          Sound (+SoundChannel), Video. Web Audio + HTMLAudioElement fallback.
 ├── system/         Capabilities (static). Must be _init()'d — createPlayer() does this for you.
@@ -73,6 +73,10 @@ colocated under `examples/benchmark/`; none are exported from `index.ts`.
   rendering**. It's a WebGL-only optimization hint that isolates a subtree
   into its own `InstructionSet` — toggling it never changes pixels, only which
   instruction set absorbs rebuilds.
+- A `scrollRect` clips a fixed viewport at local (0,0); its x/y translate the
+  content, not the clip. WebGL's nested/rotated stencil path must use the same
+  viewport origin as its axis-aligned scissor path. Rectangle masks retain
+  their own local x/y. See `player/pipes/MaskPipe.ts`.
 - `CanvasRenderer` is not purely a fallback. The WebGL backend depends on it
   internally to rasterize Graphics/Text to offscreen canvases before texture
   upload, and to snapshot `RenderTexture`. Don't reason about it as dead code
@@ -112,8 +116,11 @@ colocated under `examples/benchmark/`; none are exported from `index.ts`.
 - `BlurFilter.quality` controls pass pairs (1–16); large radii downsample to
   stay within the existing 32-physical-pixel shader tier. Glow/DropShadow keep
   their existing fixed-sample shader and do not use their quality metadata.
-- GPU filters are skipped by Canvas 2D, including the Canvas capture used by
-  cacheAsTexture and RenderTexture. Do not cache GPU effects through those APIs.
+- Canvas 2D skips CustomFilter, MultiPassFilter and BloomFilter, including the
+  Canvas capture used by cacheAsTexture and RenderTexture. Built-in Blur, Glow
+  and DropShadow use CSS approximations; ColorMatrix uses CPU pixels. These
+  fallbacks are not pixel-equivalent to WebGL. Do not cache GPU shader effects
+  through those capture APIs. See docs/filters.md.
 - Filter setters invalidate weakly attached users. Direct uniform/binding edits
   need `filter.invalidate()`. Auxiliary canvas/video edits additionally need
   `BitmapData.invalidate(source)` for upload refresh.
@@ -158,11 +165,11 @@ Re-export order: `events`, `geom`, `utils`, `display`, `net`, `filters`,
 - **Media**: `Sound`/`SoundType`/`SoundEvents`, `SoundChannel`, `Video`.
 - **Player**: `Player`, `createPlayer`/`KurotApp`/`KurotOptions`; ticker: `SystemTicker`, `ticker`, `getTimer`, `setupLifecycle`, `START_TIME`, `invalidateRenderFlag`/`setInvalidateRenderFlag`, `requestRenderingFlag`/`setRequestRenderingFlag`, `Renderable`; rendering: `InstructionSet`/`Instruction`, `RenderPipe` (type), `CanvasBuffer`, `hitTestBuffer`, `CanvasRenderer`, `DisplayList`; input/layout: `TouchHandler`, `ScreenAdapter`/`StageDisplaySize`; WebGL: `WebGLRenderer`, `WebGLRenderContext`, `WebGLRenderBuffer`, `WebGLRenderTarget`, `WebGLVertexArrayObject`, `WebGLDrawCmdManager`, `WebGLProgram`, `ShaderLib`, `checkWebGLSupport`, `MultiTextureBatcher`.
     - `RenderContext` / `RenderBuffer` (`player/RenderContext.ts`, `player/RenderBuffer.ts`) are internal backend-neutral contracts and are not re-exported.
-- **Text**: `HorizontalAlign`, `VerticalAlign`, `TextFieldType`, `TextFieldInputType`; types `ITextStyle`, `ITextElement`, `IWTextElement`, `ILineElement`, `IHitTextElement`; `HtmlTextParser`, `BitmapFont`, `BitmapText`, `measureText`/`getFontString`, `TextField`, `StageText`, `InputController`, `tokenize`/`splitGraphemes`.
+- **Text**: `HorizontalAlign`, `VerticalAlign`, `TextFieldType`, `TextFieldInputType`; types `ITextStyle`, `ITextElement`, `IWTextElement`, `ILineElement`, `IHitTextElement`, `BitmapFontOptions`; `HtmlTextParser`, `BitmapFont`, `BitmapText`, `measureText`/`getFontString`, `TextField`, `StageText`, `InputController`, `tokenize`/`splitGraphemes`.
 - **System**: `Capabilities`.
 - **localStorage**: namespace object — `import { localStorage } from '@kurot/core'`, then `localStorage.getItem(...)`.
 - **External**: `ExternalInterface` (named, not namespaced).
-- **Resource**: `Resource`/`resource` (shared instance), `ProgressCallback`, `ResourceEventListener`, `ResourceItem`, `ResourceType`, `ResourceConfig`/`ResourceConfigData`/`ResourceConfigEntry`, `ResourceLoader`, `ResourceEventType`/`ResourceEvent`, `AnalyzerBase`, `ImageAnalyzer`, `JsonAnalyzer`, `TextAnalyzer`, `SoundAnalyzer`, `SheetAnalyzer`.
+- **Resource**: `Resource`/`resource` (shared instance), `ProgressCallback`, `ResourceEventListener`, `ResourceItem`, `ResourceType`, `ResourceConfig`/`ResourceConfigData`/`ResourceConfigEntry`, `ResourceLoader`, `ResourceEventType`/`ResourceEvent`, `AnalyzerBase`, `ImageAnalyzer`, `JsonAnalyzer`, `TextAnalyzer`, `SoundAnalyzer`, `SheetAnalyzer`, `FontAnalyzer`.
 
 `examples/benchmark/` is dev-only tooling and is **not** exported from `index.ts`.
 
@@ -236,3 +243,15 @@ separate UI capability requiring Core 2.1.0 or later.
 See [text layout](text-layout.md) for the Core contract and
 [Label text layout](../../ui/docs/label-text-layout.md) for fit bounds, state
 restoration and shared-schema boundaries.
+
+## Bitmap fonts in 2.2.0
+
+[bitmap-fonts.md](bitmap-fonts.md) documents the headless bitmap-font dependency,
+FontAnalyzer and BitmapTextPipe. ResourceType.Font is built in; BitmapText
+now draws via WebGL/Canvas. BitmapFontOptions controls page ownership. Native
+font data comes from @kurot/bitmap-font; do not reimplement parsing/layout here.
+The dependency is published @kurot/bitmap-font ^0.1.0, with no local override.
+BitmapText.measureText() leaves rendered constraints and layout caches unchanged;
+text borrows the font and the resource/caller retains ownership. Font pages are
+full, unrotated textures at scale factor 1. Core 2.1.1 does not include these
+changes. Source versions alone do not confirm Core publication.