@kurot/ui 3.1.0 → 3.2.0

package/docs/bitmap-label.md

@@ -0,0 +1,41 @@
+# BitmapLabel
+
+Available in UI 3.2.0 with `@kurot/core ^2.2.0`. Core resolves its published
+@kurot/bitmap-font dependency from npm. UI 3.2.0 is prepared for publication;
+published UI 3.1.0 does not contain this component. Core 2.1.1 does not contain
+its required BitmapText rendering.
+
+```ts
+import { BitmapLabel } from '@kurot/ui';
+
+const label = new BitmapLabel('1,234.56');
+label.font = 'number_font_fnt';
+label.multiline = false;
+label.height = 100;
+group.addChild(label);
+```
+
+`font` accepts a BitmapFont, a configured resource name, or undefined to clear.
+Names resolve through the Core resource singleton. Preloaded names resolve
+synchronously during commitProperties; unloaded names start resource.load.
+Successful name resolution dispatches Event.COMPLETE; failed or incorrectly
+typed resources dispatch IOErrorEvent.IO_ERROR with source/error data.
+Superseded asynchronous requests cannot overwrite a newer font assignment,
+including A-to-B-to-A changes. The resource cache or caller retains ownership.
+
+Text assignments dispatch PropertyEvent.PROPERTY_CHANGE for binding. The
+component participates in normal layout, measurement and invalidation and owns
+one BitmapText child. Parent width constraints affect wrapping; measurements do
+not leave temporary width/height constraints on that child. textWidth/textHeight
+report content under the width constraint before height clipping.
+
+Properties: text, font, textAlign, verticalAlign, letterSpacing, lineSpacing,
+multiline and smoothing, plus ordinary Component properties. Tint is the ordinary
+DisplayObject tint. Alignments position glyphs without scaling them. Set scaleX
+and scaleY for decorative number sizing. Default multiline=true; explicit false
+keeps the first hard-separated line unwrapped.
+
+This initial change exposes a native UI component and supports programmatic
+skins. The ui-document built-in catalog, CLI KUI tag registry, Editor and
+ui-runtime materializers do not yet adopt BitmapLabel. Those require coordinated
+consumer releases; do not assume an installed compiler accepts the XML tag.

package/docs/label-text-layout.md

@@ -1,9 +1,14 @@
 # Label text layout and fitting
 
-This contract applies to UI 3.1.0 with Core >= 2.1.0 within Core 2.x. The public
+Introduced in UI 3.1.0 with Core >= 2.1.0, this contract is unchanged in UI 3.2.0,
+which requires Core ^2.2.0. The public
 `TextFitMode` type is `none | shrink`. Native UI depends only on Core. KUI
-authoring uses ui-document 0.9.x and matching CLI/ui-runtime releases; older
-consumers must update their dependency ranges before using the new fields.
+authoring introduced fitting metadata in ui-document 0.9.0 and retains it in
+0.11.0. Published CLI 3.3.0 and ui-runtime 0.8.2 use ui-document `^0.11.0`.
+Runtime 0.8.0's `^0.9.0` and runtime 0.8.1's `^0.10.0` peer ranges exclude
+the current kernel. Label presets are expanded into native properties before
+rendering; their precedence does not change fitting behavior. See the
+[project style contract](../../ui-document/docs/project-styles.md).
 
 ## Lines and bounds
 

package/package.json

@@ -1,7 +1,7 @@
 {
 	"name": "@kurot/ui",
-	"version": "3.1.0",
-	"description": "EUI-compatible UI component framework for the Kurot game engine — skin-based components, layouts, data binding, view states",
+	"version": "3.2.0",
+	"description": "EUI-compatible UI component framework for the Kurot game engine \u2014 skin-based components, layouts, data binding, view states",
 	"author": "Kelvin <kyia.x52@gmail.com>",
 	"license": "MIT",
 	"type": "module",
@@ -33,10 +33,10 @@
 		"prepublishOnly": "npm run clean && npm run build"
 	},
 	"peerDependencies": {
-		"@kurot/core": "^2.1.0"
+		"@kurot/core": "^2.2.0"
 	},
 	"devDependencies": {
-		"@kurot/core": "^2.1.0",
+		"@kurot/core": "^2.2.0",
 		"@playwright/test": "1.62.1",
 		"@types/node": "^22.0.0",
 		"happy-dom": "^20.8.9",