@kurot/ui 4.2.0 → 5.1.0

package/docs/api/coverage.json

@@ -1,8 +1,8 @@
 {
   "package": "@kurot/ui",
-  "version": "4.2.0",
-  "exports": 94,
-  "members": 5025,
+  "version": "5.1.0",
+  "exports": 95,
+  "members": 5149,
   "missing": [],
   "withoutComment": [
     "AddItems.apply",

package/docs/api/coverage.md

@@ -1,6 +1,6 @@
 # @kurot/ui API coverage
 
-Version: 4.2.0. Public export names: 94. Public/protected member entries: 5025.
+Version: 5.1.0. Public export names: 95. Public/protected member entries: 5149.
 
 Missing declaration references: **0**. Inventory is independently read through the TypeScript checker.
 

package/docs/api/examples/{d9d3bd3be01f.ts → 0ec6d9fa6766.ts}

@@ -2,7 +2,7 @@ import { EventDispatcher } from '@kurot/core';
 import { Binding } from '@kurot/ui';
 
 const user = Object.assign(new EventDispatcher(), { name: 'Player' });
-const watcher = Binding.bindHandler(user, ['name'], value => console.log(value), undefined);
+const watcher = Binding.bindHandler(user, ['name'], value => console.log(value));
 watcher?.unwatch();
 
 export {};

package/docs/api/examples/15c37ae8a98b.ts

@@ -0,0 +1,10 @@
+import { Backdrop, UILayer } from '@kurot/ui';
+
+export function addBackdrop(layer: UILayer): Backdrop {
+    const backdrop = new Backdrop({ blurX: 36, blurY: 36, resolution: 0.5 });
+    backdrop.left = backdrop.right = backdrop.top = backdrop.bottom = 0;
+    layer.addChildAt(backdrop, 0);
+    return backdrop;
+}
+
+export {};

package/docs/api/examples.json

@@ -1,11 +1,15 @@
 {
   "package": "@kurot/ui",
-  "version": "4.2.0",
+  "version": "5.1.0",
   "examples": [
     {
       "file": "examples/37f49b480a1c.ts",
       "owner": "Theme"
     },
+    {
+      "file": "examples/15c37ae8a98b.ts",
+      "owner": "Backdrop"
+    },
     {
       "file": "examples/792376c209f3.ts",
       "owner": "ProgressBar.slideDuration"
@@ -19,7 +23,7 @@
       "owner": "Binding.bindProperty"
     },
     {
-      "file": "examples/d9d3bd3be01f.ts",
+      "file": "examples/0ec6d9fa6766.ts",
       "owner": "Binding.bindHandler"
     },
     {

package/docs/api/getAssetAdapter-function.md

@@ -1,6 +1,6 @@
 # getAssetAdapter
 
-Package: `@kurot/ui@4.2.0`. Generated from public declarations and JSDoc.
+Package: `@kurot/ui@5.1.0`. Generated from public declarations and JSDoc.
 
 ```ts
 getAssetAdapter(): IAssetAdapter;

package/docs/api/getTheme-function.md

@@ -1,6 +1,6 @@
 # getTheme
 
-Package: `@kurot/ui@4.2.0`. Generated from public declarations and JSDoc.
+Package: `@kurot/ui@5.1.0`. Generated from public declarations and JSDoc.
 
 ```ts
 getTheme(): Theme | undefined;

package/docs/api/getUIContext-function.md

@@ -1,6 +1,6 @@
 # getUIContext
 
-Package: `@kurot/ui@4.2.0`. Generated from public declarations and JSDoc.
+Package: `@kurot/ui@5.1.0`. Generated from public declarations and JSDoc.
 
 ```ts
 getUIContext(node: DisplayObject): UIContext | undefined;

package/docs/api/index.md

@@ -1,6 +1,6 @@
 # @kurot/ui API
 
-Version: **4.2.0**. Read the installed package's matching documentation.
+Version: **5.1.0**. Read the installed package's matching documentation.
 
 Choose a capability in [topics](topics.md), then open a symbol and only the members needed.
 Parameter/result helpers are in [supporting types](supporting/index.md); machine lookup is in [api-index.json](api-index.json).
@@ -16,6 +16,7 @@ Coverage of declarations and coverage of behavioral comments are reported separa
 | `Animation` | Class | [open](Animation-class.md) |
 | `ArrayCollection` | Class | [open](ArrayCollection-class.md) |
 | `ArrayCollectionEvents` | Interface | [open](ArrayCollectionEvents-interface.md) |
+| `Backdrop` | Class | [open](Backdrop-class.md) |
 | `BasicLayout` | Class | [open](BasicLayout-class.md) |
 | `Binding` | Class | [open](Binding-class.md) |
 | `BitmapLabel` | Class | [open](BitmapLabel-class.md) |

package/docs/api/isUIComponent-function.md

@@ -1,6 +1,6 @@
 # isUIComponent
 
-Package: `@kurot/ui@4.2.0`. Generated from public declarations and JSDoc.
+Package: `@kurot/ui@5.1.0`. Generated from public declarations and JSDoc.
 
 ```ts
 isUIComponent(obj: unknown): obj is IUIComponent;

package/docs/api/setAssetAdapter-function.md

@@ -1,6 +1,6 @@
 # setAssetAdapter
 
-Package: `@kurot/ui@4.2.0`. Generated from public declarations and JSDoc.
+Package: `@kurot/ui@5.1.0`. Generated from public declarations and JSDoc.
 
 ```ts
 setAssetAdapter(adapter: IAssetAdapter): void;

package/docs/api/setTheme-function.md

@@ -1,6 +1,6 @@
 # setTheme
 
-Package: `@kurot/ui@4.2.0`. Generated from public declarations and JSDoc.
+Package: `@kurot/ui@5.1.0`. Generated from public declarations and JSDoc.
 
 ```ts
 setTheme(theme: Theme): void;

package/docs/api/topics/components.md

@@ -1,6 +1,7 @@
 # components
 
 - [Animation](../Animation-class.md) — Class
+- [Backdrop](../Backdrop-class.md) — Class
 - [BitmapLabel](../BitmapLabel-class.md) — Class
 - [Button](../Button-class.md) — Class
 - [CheckBox](../CheckBox-class.md) — Class

package/docs/api/topics.md

@@ -4,7 +4,7 @@ Read one capability list, then only the required symbol/member pages.
 
 - [binding](topics/binding.md) — 2 declarations
 - [collections](topics/collections.md) — 4 declarations
-- [components](topics/components.md) — 42 declarations
+- [components](topics/components.md) — 43 declarations
 - [core](topics/core.md) — 24 declarations
 - [events](topics/events.md) — 7 declarations
 - [layouts](topics/layouts.md) — 11 declarations

package/docs/api/validator-variable/addEventListener-method.md

@@ -1,6 +1,6 @@
 # addEventListener
 
-Package: `@kurot/ui@4.2.0`. Generated from public declarations and JSDoc.
+Package: `@kurot/ui@5.1.0`. Generated from public declarations and JSDoc.
 
 ```ts
 addEventListener<K extends string>(type: K, listener: (event: Event) => void, useCapture?: boolean, priority?: number): void;

package/docs/api/validator-variable/dispatchEvent-method.md

@@ -1,6 +1,6 @@
 # dispatchEvent
 
-Package: `@kurot/ui@4.2.0`. Generated from public declarations and JSDoc.
+Package: `@kurot/ui@5.1.0`. Generated from public declarations and JSDoc.
 
 ```ts
 dispatchEvent(event: Event): boolean;

package/docs/api/validator-variable/dispatchEventWith-method.md

@@ -1,6 +1,6 @@
 # dispatchEventWith
 
-Package: `@kurot/ui@4.2.0`. Generated from public declarations and JSDoc.
+Package: `@kurot/ui@5.1.0`. Generated from public declarations and JSDoc.
 
 ```ts
 dispatchEventWith(type: string, bubbles?: boolean, data?: unknown, cancelable?: boolean): boolean;

package/docs/api/validator-variable/hasEventListener-method.md

@@ -1,6 +1,6 @@
 # hasEventListener
 
-Package: `@kurot/ui@4.2.0`. Generated from public declarations and JSDoc.
+Package: `@kurot/ui@5.1.0`. Generated from public declarations and JSDoc.
 
 ```ts
 hasEventListener(type: string): boolean;

package/docs/api/validator-variable/invalidateDisplayList-method.md

@@ -1,6 +1,6 @@
 # invalidateDisplayList
 
-Package: `@kurot/ui@4.2.0`. Generated from public declarations and JSDoc.
+Package: `@kurot/ui@5.1.0`. Generated from public declarations and JSDoc.
 
 ```ts
 invalidateDisplayList(client: QueueClient): void;

package/docs/api/validator-variable/invalidateProperties-method.md

@@ -1,6 +1,6 @@
 # invalidateProperties
 
-Package: `@kurot/ui@4.2.0`. Generated from public declarations and JSDoc.
+Package: `@kurot/ui@5.1.0`. Generated from public declarations and JSDoc.
 
 ```ts
 invalidateProperties(client: QueueClient): void;

package/docs/api/validator-variable/invalidateSize-method.md

@@ -1,6 +1,6 @@
 # invalidateSize
 
-Package: `@kurot/ui@4.2.0`. Generated from public declarations and JSDoc.
+Package: `@kurot/ui@5.1.0`. Generated from public declarations and JSDoc.
 
 ```ts
 invalidateSize(client: QueueClient): void;

package/docs/api/validator-variable/notifyListener-method.md

@@ -1,6 +1,6 @@
 # notifyListener
 
-Package: `@kurot/ui@4.2.0`. Generated from public declarations and JSDoc.
+Package: `@kurot/ui@5.1.0`. Generated from public declarations and JSDoc.
 
 ```ts
 protected notifyListener(event: Event, capturePhase: boolean): boolean;

package/docs/api/validator-variable/once-method.md

@@ -1,6 +1,6 @@
 # once
 
-Package: `@kurot/ui@4.2.0`. Generated from public declarations and JSDoc.
+Package: `@kurot/ui@5.1.0`. Generated from public declarations and JSDoc.
 
 ```ts
 once<K extends string>(type: K, listener: (event: Event) => void, useCapture?: boolean, priority?: number): void;

package/docs/api/validator-variable/removeEventListener-method.md

@@ -1,6 +1,6 @@
 # removeEventListener
 
-Package: `@kurot/ui@4.2.0`. Generated from public declarations and JSDoc.
+Package: `@kurot/ui@5.1.0`. Generated from public declarations and JSDoc.
 
 ```ts
 removeEventListener<K extends string>(type: K, listener: (event: Event) => void, useCapture?: boolean): void;

package/docs/api/validator-variable/validateClient-method.md

@@ -1,6 +1,6 @@
 # validateClient
 
-Package: `@kurot/ui@4.2.0`. Generated from public declarations and JSDoc.
+Package: `@kurot/ui@5.1.0`. Generated from public declarations and JSDoc.
 
 ```ts
 validateClient(target: QueueClient): void;

package/docs/api/validator-variable/willTrigger-method.md

@@ -1,6 +1,6 @@
 # willTrigger
 
-Package: `@kurot/ui@4.2.0`. Generated from public declarations and JSDoc.
+Package: `@kurot/ui@5.1.0`. Generated from public declarations and JSDoc.
 
 ```ts
 willTrigger(type: string): boolean;

package/docs/api/validator-variable.md

@@ -1,6 +1,6 @@
 # validator
 
-Package: `@kurot/ui@4.2.0`. Generated from public declarations and JSDoc.
+Package: `@kurot/ui@5.1.0`. Generated from public declarations and JSDoc.
 
 ```ts
 validator: Validator;

package/docs/architecture.md

@@ -3,7 +3,7 @@
 For production game UI and project directories, use
 [standard authoring](ui-authoring.md); this document explains engine internals.
 
-> Package version: 3.6.2 (published), with peerDependency `@kurot/core: ^2.5.2`.
+> Package version: 5.1.0 (prepared; npm publication pending), with Core peer ^3.2.0.
 > No local Core override is needed for builds or centered-flip checks.
 > See [CHANGELOG.md](../CHANGELOG.md) for release-by-release changes.
 > The [AI context map](./ai-context.md) provides directory, behavior, terminology
@@ -17,22 +17,25 @@ For production game UI and project directories, use
 
 ## 1. Overview
 
-`@kurot/ui` is an EUI-compatible UI framework rewritten on top of
+`@kurot/ui` provides native skinnable components and layout on top of
 [`@kurot/core`](../../core/docs/architecture.md). Core is a `peerDependency`,
 excluded from the output bundle. Consumers explicitly install it so packages
 using UI share one Core instance, display tree infrastructure and global state.
 
-The central architectural choice is delegation in place of prototype mixins.
-Egret EUI uses `implementUIComponent()` to copy prototype members and combine
-DisplayObject and UIComponent behavior. Such copied members are difficult to
-represent in strict TypeScript. Kurot uses composition instead: Group and
-Component both directly extend Sprite and hold a UIState instance as `this.ui`.
+Group and Component directly extend Sprite and hold a UIState instance as
+`this.ui`. Display-tree ownership stays with the host; UIState owns layout
+properties, measurement and validation.
 Their IUIComponent methods delegate layout state and validation to UIState.
 UIState communicates with its host through the narrow IUIOwner callback interface,
 without depending on the host's concrete DisplayObject subclass. This separation
 allows skin and validation systems to evolve independently and follows the
 repository preference for composition over deeper application inheritance.
 
+`Backdrop` composes one Core BackdropBlur with Component's UIState. It bypasses
+default Skin lookup, has zero intrinsic size and synchronizes the effect to its
+validated local frame. Core owns sampling and reusable rendering resources;
+UILayer/parent layout owns resize. See [the backdrop contract](backdrop.md).
+
 ---
 
 ## 2. Validation cycle
@@ -111,8 +114,7 @@ validateClient instead converges synchronously for its target subtree.
 `_schedule()` uses Core's ticker.callLater() to schedule `_flush()`. Core executes
 flushCallLaters() before Player.render(), so initial property commits, measurement
 and layout run before newly mounted components are drawn. This provides the
-render-preparation ordering that Egret's Validator establishes through
-Event.RENDER, without independent UI and renderer RAF loops competing for order.
+ordering needed to validate UI before drawing within the same Core frame loop.
 
 ---
 
@@ -121,8 +123,7 @@ Event.RENDER, without independent UI and renderer RAF loops competing for order.
 ### 3.1 Skin is a data object
 
 `components/Skin.ts` defines Skin as an EventDispatcher<SkinEvents>, rather than
-a display object. Egret EUI's Skin also extends EventDispatcher; its nonvisual
-role is shared with Kurot.
+a display object. Its content is attached to the host Component.
 
 Skin declares skinParts (names), states (State entries) and elementsContent
 (display objects to attach). Component._setSkin() performs the attachment:
@@ -192,8 +193,8 @@ Theme for a default:
   and calls component._applySkinName(), causing validation of the applied skin.
 
 An early-created component can render without its skin until theme loading,
-including the skinsJs import, finishes. This follows EUI's asynchronous-theme
-pattern and decouples UI-tree construction from theme loading.
+including the skinsJs import, finishes. UI-tree construction and asynchronous
+theme loading have separate lifecycles.
 
 ### 3.5 Replacing a skin
 
@@ -442,24 +443,17 @@ pluggable LayoutBase.
 
 ---
 
-## 7. Relationship to Egret EUI
-
-| Egret EUI concept                                      | Kurot UI counterpart                                      | Notes                                                                                                                                                                          |
-| ------------------------------------------------------ | --------------------------------------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ |
-| `eui.Component`                                        | `Component`                                               | Same role; UI behavior uses standard Sprite inheritance and explicit delegation rather than prototype mixins                                                                   |
-| `eui.Skin`                                             | `Skin`                                                    | Both are nonvisual EventDispatcher objects; their content is attached to the host component                                                                                    |
-| Three-phase UIComponent validation                     | `UIState` + `Validator`                                   | Depth-ordered properties, measurement and display-list phases; Kurot uses Core's callLater queue before rendering where Egret uses Event.RENDER                                |
-| Theme adapters and theme registration                  | `IThemeAdapter` + `Theme`/`getTheme()`/`setTheme()`       | Both support theme adapters; Kurot injects the adapter through the Theme constructor, while the Egret reference resolves eui.IThemeAdapter through its implementation registry |
-| Global registration of compiled EXML skins             | `globalThis["skins.X"] = factory` from ESM imports        | Both use global skin names; Kurot's compiled output registers factories invoked with .call(this) to provide host context                                                       |
-| State/SetProperty/SetStateProperty/AddItems            | Same class names and IOverride interface                  | Direct adaptation of declarative state overrides                                                                                                                               |
-| BasicLayout/VerticalLayout/HorizontalLayout/TileLayout | Same class names                                          | Similar percentage allocation, gaps, padding and virtual-layout algorithms, including iterative min/max clamping                                                               |
-| Prototype-copy UIComponent implementation              | TypeScript inheritance + UIState/ILayoutTarget delegation | The central architectural change described in section 1                                                                                                                        |
-
-Kurot-specific choices include the IUIOwner/UIState composition boundary,
-constructor-based Theme adapter injection and ESM skin factories with explicit
-host context. UIState can exist independently of a specific DisplayObject
-subclass; Group and Component each hold an instance rather than requiring a
-shared visual base class for all validation state.
+## 7. Native integration contracts
+
+| Owner | Contract |
+| --- | --- |
+| Component / Group | Sprite subclasses delegate layout and validation to UIState. |
+| Skin | Nonvisual EventDispatcher containing parts, states and host-attached display content. |
+| UIState / Validator | Depth-ordered property, measurement and display-list queues flushed through Core's callLater before rendering. |
+| Theme / UIContext | Skin factories, defaults and resource adapters are resolved through the configured global or local application scope. |
+| State / IOverride | Declarative property, binding and display-child overrides are applied and restored by the owning component. |
+| Layouts | Basic, vertical, horizontal and tile layout own allocation, gaps, padding, min/max bounds and optional virtualization. |
+
 
 ---
 
@@ -476,7 +470,7 @@ file and case counts.
 | Collections and data-driven components | ArrayCollection, DataGroup, ListBase, ItemRenderer, ComboBox, TabBar, ViewStack                                                                |
 | Individual components                  | RadioButton, Range, Slider, ProgressBar, Scroller, Label, BitmapLabel, RichLabel, TextInput                                                    |
 | Text fitting                           | ButtonLabelTextFit, LabelTextFit, LabelTextFitBounds                                                                                           |
-| Cross-component behavior               | Enabled (EUI-aligned enabled/touchEnabled/touchChildren behavior), EventMapOverride, GestureLifecycle, TransformLayout, ScrollAndVirtualLayout |
+| Cross-component behavior               | Enabled (enabled/touchEnabled/touchChildren coordination), EventMapOverride, GestureLifecycle, TransformLayout, ScrollAndVirtualLayout |
 
 There is no dedicated Group.test.ts; Group state behavior is covered indirectly
 by container/component tests. There are also no separate VerticalLayout.test.ts

package/docs/backdrop.md

@@ -0,0 +1,107 @@
+# Backdrop
+
+Available in UI **5.1.0**, requiring Core **^3.2.0**. UI 5.1.0 is prepared for
+publication; the published UI 5.0.0 archive does not export Backdrop.
+
+`Backdrop` wraps Core's `BackdropBlur` with standard UI layout. Create it in
+TypeScript and insert it before the existing modal input/dim mask and popup.
+Earlier rendered content is blurred; the popup and later prompt/guide layers
+stay sharp. It does not pause gameplay or block input by default.
+
+## Fill a UI layer
+
+```ts
+import { Backdrop, UILayer } from '@kurot/ui';
+
+const layer = new UILayer();
+const backdrop = new Backdrop({
+    blurX: 36,
+    blurY: 36,
+    quality: 1,
+    resolution: 0.5,
+});
+backdrop.left = backdrop.right = backdrop.top = backdrop.bottom = 0;
+layer.addChild(backdrop);
+// Add the existing input/dim mask and popup after the backdrop.
+// Add layer to the application's existing Stage/layer hierarchy.
+```
+
+`UILayer` follows logical Stage dimensions; its default BasicLayout stretches
+the constrained backdrop. Resizing, stage reattachment and ordinary validation
+update the sampled rectangle. Backdrop itself registers no Stage resize or
+ticker listeners. It does not introduce a global fullScreen flag or change
+stage scaling/DPR. Use the usual validation/render cycle; `validateNow()` is
+available when immediate synchronous layout is needed.
+
+The four zero constraints fill a parent with BasicLayout. They are explicit,
+not constructor defaults. Inside an ordinary Group they fill that Group rather
+than the Stage. Other layouts keep their own allocation rules.
+
+## Regional layout and controls
+
+Use normal width/height, left/right/top/bottom, percent size and center
+constraints. Width/height options set explicit logical UI sizes; parent layout
+can allocate a different frame, as for other components. The effect has no
+intrinsic preferred size. Its previous allocated size cannot enlarge an
+automatically measured parent or keep a cleared constraint's old size alive.
+
+| Control | Contract |
+| --- | --- |
+| `blurX`, `blurY` | Local logical radii, initially 4; finite and non-negative. Zero disables an axis. |
+| `quality` | Integer GPU horizontal/vertical pass pairs, 1–16; initially 1. |
+| `resolution` | Positive optional pixels-per-local-unit cap. Undefined inherits target density; lower values reduce work and detail, without changing layout. |
+| `alpha` | Mixes original and blurred pixels; zero preserves the background. Ancestor alpha participates. |
+
+Set these properties directly after construction. Blur validation and dirty
+tracking belong to Core. Display transforms, flips and rectangular clips apply
+to the local UI frame. A full-screen Retina blur still costs a capture and blur
+each frame; start with quality 1 and a suitable resolution cap.
+
+## Input, ordering and lifecycle
+
+The wrapper and its internal effect default to disabled input. The wrapper
+returns no hit target so a Core ancestor cannot mistake its rectangle for an
+input-blocking descendant. Existing container hit policies still apply:
+an otherwise empty Group/UILayer can catch input through its own bounds unless
+configured with `touchThrough = true`. Keep modal event blocking in the existing
+input mask. Explicitly enabling Backdrop.touchEnabled opts into bounds hits.
+
+Remove it with `layer.removeChild(backdrop)` to restore the underlying scene
+on the next render; re-add it before the popup to reuse the same effect node.
+Hiding it or setting alpha to zero also leaves the background unchanged.
+There is no per-node captured image, timer or explicit GPU disposal API.
+Stable dimensions reuse Core's context/renderer-owned targets and canvases;
+Player destruction and context restoration follow Core's resource lifecycle.
+
+This is a code-created visual, not a content container or a skinned control.
+It does not resolve a default Theme/UIContext Skin. Do not place content inside
+it. This change adds no KUI catalog, CLI compilation or semantic runtime support.
+SAO and application layer organization remain unchanged.
+
+## Rendering boundaries
+
+The [Core BackdropBlur contract](../../core/docs/backdrop-blur.md) applies:
+WebGL 1/2 sample on the GPU; Canvas uses a native-filter approximation and
+preserves original background where filters are unavailable. Parent filters
+and object masks can isolate the sampled layer. Rendered texture caches on
+the wrapper or an ancestor are rejected, since a static cached image cannot
+hold a dynamic backdrop. Multiple backdrops execute in display order, so an
+upper backdrop can blur a lower popup while its own later popup stays sharp.
+
+## Verification
+
+From `packages/ui`:
+
+```sh
+pnpm build
+pnpm test
+pnpm exec playwright test test/browser/backdrop.spec.ts --workers=1
+```
+
+Unit coverage checks default/explicit sizing, full-layer and regional layouts,
+growing/shrinking dimensions, percent/center/scale allocation, input, absent
+intrinsic size, default-Skin bypass and reuse across attachment cycles.
+Browser checks use published Core and real Canvas/WebGL 1/WebGL 2 pixels at
+1×/2×/3× device/output density: dynamic background, sharp foreground, alpha,
+stacking, clipping, transforms, resize, input, removal/reinsertion and recovery
+after a rejected texture cache. No local source alias replaces Core.

package/docs/bitmap-label.md

@@ -33,8 +33,8 @@ 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.
 
-Vertical alignment inherits BitmapText's default: middle with Core >= 2.5.3,
-top with the accepted Core 2.5.2 baseline. Explicit alignment remains effective
+Vertical alignment inherits BitmapText's default: middle with Core 3.
+Explicit alignment remains effective
 in either line mode. The headless catalog records middle; omitted XML values
 still use the native host default.
 

package/docs/callbacks.md

@@ -0,0 +1,31 @@
+# Native callback ownership
+
+Available in UI 5.0.0 with Core ^3.0.0. Callbacks own their instance binding.
+
+| API | Source signature |
+| --- | --- |
+| Animation | `new Animation(updateFunction)` |
+| Watcher constructor | `new Watcher(property, handler?, next?)` |
+| Watcher.watch | `Watcher.watch(host, chain, handler?)` |
+| Watcher.setHandler | `watcher.setHandler(handler)` |
+| Binding.bindHandler | `Binding.bindHandler(host, chain, handler)` |
+
+These callbacks run without an injected receiver. Use stable arrow members or
+bind a method once if it accesses instance state. Animation supplies itself as
+the update/end callback argument; Watcher and Binding supply the observed value.
+Watcher constructor's third argument is an optional downstream Watcher.
+
+Binding.bindHandler calls the handler synchronously with the initial value;
+Watcher.watch does not. Both initial and later calls use the same unbound
+contract. Replacing a handler updates the downstream chain without emitting
+another initial value. Reset detaches the previous host before observing a new
+one. Retain the returned Watcher and call unwatch() when its owner is released.
+
+Animation.stop() unregisters its ticker callback and does not call endFunction.
+Natural completion calls the final update, stops the animation, then calls
+endFunction once. Callback exceptions propagate. TouchScroll retains its own
+stable update callback so bounce/throw animation continues to update the owner.
+
+EventDispatcher's event receiver and Component's host-aware Skin factory are
+separate existing contracts and are unchanged. DragonBones event adapter
+receivers follow its upstream protocol.

package/docs/label-text-layout.md

@@ -3,7 +3,7 @@
 `TextFitMode` is `none | shrink`. Native Label owns normal layout, single- and
 multiline fitting, outline-safe bounds and derived rendering observations.
 KUI compilation and semantic materialization pass the authored policy to that
-same native component. UI's Core peer requirement is ^2.5.2.
+same native component. UI 5's Core peer requirement is ^3.0.0.
 
 ## Outline-safe layout
 
@@ -53,8 +53,8 @@ automatically; omitted Label flags continue to allow wrapping.
 ## Vertical alignment and skin defaults
 
 Label, RichLabel and EditableText inherit TextField's default; BitmapLabel
-inherits BitmapText's. With Core >= 2.5.3 they default to
-`verticalAlign="middle"`; the accepted Core 2.5.2 baseline defaults to top. Button
+inherits BitmapText's. With Core 3 they default to
+`verticalAlign="middle"`. Button
 skins in the native KUI kit already set middle explicitly. Button does not
 overwrite an authored top/bottom or a skin state. Use explicit top for content
 intended to start at the top of a taller box. `verticalCenter` positions the

package/docs/list-data-types.md

@@ -1,8 +1,8 @@
 # Typed list data
 
-Available in UI >= 4.2.0 within 4.x. Declared typed list fields in KUI hosts also
+Available in UI 4.2.x and 5.x. Declared typed list fields in KUI hosts also
 require CLI >= 4.1.1 within 4.x; ordinary TypeScript use needs only UI.
-Core peer remains ^2.5.2, with no resource or KUI format change.
+UI 5 requires Core ^3.0.0. List data types do not change resource or KUI formats.
 
 ## Collections and selection
 

package/docs/rich-label.md

@@ -1,7 +1,7 @@
 # RichLabel
 
-Native rich text in an independent Component using Core TextField. UI 4.1 adds
-component typography while retaining Core peer ^2.5.2. KUI authoring uses CLI 4.1
+Native rich text in an independent Component using Core TextField. UI 5 requires
+Core ^3.0.0 and retains component typography. KUI authoring uses CLI 4.1
 and ui-document 0.14; direct TypeScript use needs UI only.
 
 ```ts
@@ -71,8 +71,8 @@ and alpha remain available.
 | verticalAlign | Host Core | top, middle or bottom. |
 | textWidth / textHeight | Read-only | Complete content under the current width constraint, before height clipping. Empty content has zero metrics. |
 
-Vertical alignment follows the host TextField default: middle with Core >= 2.5.3,
-top with the accepted Core 2.5.2 baseline. Explicit alignment works in either
+Vertical alignment follows the host TextField default: middle with Core 3.
+Explicit alignment works in either
 line mode. The headless catalog records middle; omitted XML retains the native
 host default.
 

package/docs/skin-part-fields.md

@@ -103,7 +103,7 @@ side effects.
 
 ## Typed list fields
 
-UI >= 4.2.0 within 4.x supports `declare items: List<ItemData | null>` on a host
+UI 4.2.x and 5.x supports `declare items: List<ItemData | null>` on a host
 component. Its dataProvider, selectedItem and itemTap callbacks retain that item
 type. ItemRenderer uses `ItemRenderer<TSkin, T>` so existing Skin arguments keep
 their meaning. See [list data types](list-data-types.md).