npm / @opentui/core
@opentui/core
What changed in @opentui/core 0.8, from its official release notes, upgrade guides and advisories. Sources checked 2026-10-29.
10 breaking88 new APIs and options
See which of these apply to your code, ranked, in your agent:
npx @unstale/cli init@opentui/core 0.898 changes
Breaking changes 10
Renames FFIRenderLib.contextDrawSceneText to FFIRenderLib.contextDrawSceneBody.
Changes the pixel-resolution control variant to query-pixel-resolution with an optional sentinel, and changes the modes control variant to restore-modes.
Renames ot_buffer_draw_scene_text to ot_buffer_draw_scene_body.
Renames OT_SCENE_RECORD_SCENE_TEXT to OT_SCENE_RECORD_SCENE_BODY.
Renames the ot_scene_stats field reserved to damage_rows.
The content property now has type ScrollBoxContent instead of ContentRenderable.
The horizontalScrollBar property now has type ScrollBoxBar instead of ScrollBarRenderable.
The verticalScrollBar property now has type ScrollBoxBar instead of ScrollBarRenderable.
The viewport property now has type ScrollBoxViewport instead of BoxRenderable.
The wrapper property now has type ScrollBoxWrapper instead of BoxRenderable.
New APIs and options 88
Adds an optional tolerance property to animation tick options.
Adds an animation-tick registration method that accepts an FPS, callback, and optional options, and returns an unsubscribe function.
Adds a synchronizedOutput configuration property.
Adds an API to retrieve a scene node’s scroll state.
Adds an API to request scrolling by kind, with an optional target, alignment, and inset.
Adds an API to set a scene node’s scroll position, with per-axis relative positioning and optional reapplication.
Adds an API to configure scrolling on a scene node.
Adds an API to configure a scroll arrow for a scene node and axis.
Adds scroll lifecycle hooks with an active predicate and a notification callback.
Adds an option indicating whether the host is a multiplexer.
Adds a replySentinel terminal option.
Adds a synchronizedOutput terminal option.
Adds an API that accepts an FPS value or accessor, an animation tick callback, and optional animation tick options.
Adds the edit position constant OT_EDIT_POSITION_END.
Adds the edit position constant OT_EDIT_POSITION_PREV_CHAR.
Adds the input constant OT_INPUT_EXPECT_SENTINEL.
Adds the scene constant OT_SCENE_DEBUG_VERIFY.
Adds the scene frame constant OT_SCENE_FRAME_SCROLL.
Adds the full-path reason constant OT_SCENE_FULL_PATH_NON_LOCAL.
Adds the full-path reason constant OT_SCENE_FULL_PATH_OPTIONS.
Adds the full-path reason constant OT_SCENE_FULL_PATH_TAINTED.
Adds the full-path reason constant OT_SCENE_FULL_PATH_UNRETAINED.
Adds an API to get a node's scroll state.
Adds the scene hook constant OT_SCENE_HOOK_SCROLL.
Adds the scroll alignment constant OT_SCENE_SCROLL_ALIGN_END.
Adds the scroll alignment constant OT_SCENE_SCROLL_ALIGN_NEAREST.
Adds the scroll alignment constant OT_SCENE_SCROLL_ALIGN_START.
Adds the scroll bar policy constant OT_SCENE_SCROLL_BAR_ALWAYS.
Adds the scroll bar policy constant OT_SCENE_SCROLL_BAR_AUTO.
Adds the scroll bar placement constant OT_SCENE_SCROLL_BAR_INSET.
Adds the scroll bar policy constant OT_SCENE_SCROLL_BAR_NEVER.
Adds scroll bar configuration options, including policy, placement, thickness, gap, arrows, and track colors.
Adds the scroll bar placement constant OT_SCENE_SCROLL_BAR_OVERLAY.
Adds scroll bar state fields for visibility, track, arrows, and thumb position and size.
Adds the scroll change constant OT_SCENE_SCROLL_CHANGED_CONTENT.
Adds the scroll change constant OT_SCENE_SCROLL_CHANGED_LAYOUT.
Adds the scroll change constant OT_SCENE_SCROLL_CHANGED_OFFSET_X.
Adds the scroll change constant OT_SCENE_SCROLL_CHANGED_OFFSET_Y.
Adds the scroll change constant OT_SCENE_SCROLL_CHANGED_VIEWPORT.
Adds the scroll fill constant OT_SCENE_SCROLL_FILL_CONTENT.
Adds the scroll fill constant OT_SCENE_SCROLL_FILL_VIEWPORT.
Adds the scroll fill constant OT_SCENE_SCROLL_FILL_WRAPPER.
Adds the scroll follow constant OT_SCENE_SCROLL_FOLLOW_BOTTOM.
Adds the scroll follow constant OT_SCENE_SCROLL_FOLLOW_LEFT.
Adds the scroll follow constant OT_SCENE_SCROLL_FOLLOW_NONE.
Adds the scroll follow constant OT_SCENE_SCROLL_FOLLOW_RIGHT.
Adds the scroll follow constant OT_SCENE_SCROLL_FOLLOW_TOP.
Adds scroll configuration fields for axes, follow behavior, culling, fills, padding, backgrounds, and bars.
Adds the scroll constant OT_SCENE_SCROLL_REAPPLY.
Adds the scroll constant OT_SCENE_SCROLL_RELATIVE_X.
Adds the scroll constant OT_SCENE_SCROLL_RELATIVE_Y.
Adds an API to issue a scroll request for a node.
Adds the scroll request constant OT_SCENE_SCROLL_REQUEST_ANCHOR.
Adds the scroll request constant OT_SCENE_SCROLL_REQUEST_INTO_VIEW.
Adds the scroll request constant OT_SCENE_SCROLL_REQUEST_LAYOUT.
Adds scroll state fields for offsets, bounds, content, viewport, bars, and change tracking.
Adds an API to scroll a node to an x/y position.
Adds the scroll axis constant OT_SCENE_SCROLL_X.
Adds the scroll axis constant OT_SCENE_SCROLL_Y.
Adds an API to configure scrolling for a node.
Adds an API to configure a scroll arrow for a node.
Adds the style constant OT_STYLE_CONTENT.
Adds the terminal constant OT_TERMINAL_HOST_MULTIPLEXER.
Adds the terminal constant OT_TERMINAL_REPLY_SENTINEL.
Adds the terminal constant OT_TERMINAL_SYNC_ALWAYS.
Adds the terminal constant OT_TERMINAL_SYNC_NEVER.
Adds an animation FPS property to renderables.
Adds an overridable renderable callback for animation ticks.
Adds an optional animationFps renderable option.
Adds a clock property to the render context.
Adds an animation-tick registration function to the render context.
Adds a scroll-box bar class with scrolling, visibility, arrow, track, sizing, and change-callback APIs.
Adds a scroll-box content class with child-management APIs and viewport culling.
Adds a callback API to run code after layout.
Adds an API to anchor a renderable in a scroll box, returning a cleanup function.
Adds an overflow property fixed to hidden.
Adds a read-only property identifying the scroll box’s primary axis.
Accepts either a child ID or renderable and adds optional alignment and inset settings when scrolling a child into view.
Adds a property to control horizontal scrolling.
Adds a property to control vertical scrolling.
Adds a viewport class with padding properties.
Adds a scroll-box wrapper class.
Adds a function that computes the size of a scroll unit from a bar’s viewport and scroll sizes, with an optional scroll step.
Adds a protocol-context property indicating whether the reply sentinel is active.
Adds a type for synchronized-output settings with auto, always, and never values.
Adds a frame-rate property to timelines.
Adds an optional frameRate setting to timeline options.
Adds a hook that accepts an optional FPS, an animation tick callback, and optional animation tick options.