@rive-app/canvas-advanced-single 2.43.0 → 2.44.0

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@rive-app/canvas-advanced-single",
-  "version": "2.43.0",
+  "version": "2.44.0",
   "description": "Rive's lightweight low-level canvas based web api all in one js file.",
   "main": "canvas_advanced_single.mjs",
   "homepage": "https://rive.app",

package/rive_advanced.mjs.d.ts

@@ -1036,6 +1036,30 @@ export declare class StateMachineInstance {
    */
   focusPrevious(): boolean;
 
+  /**
+   * Move focus to the nearest focusable node to the left of the current focus, by on-screen position.
+   * @returns false if nothing is focused or no node lies in that direction
+   */
+  focusLeft(): boolean;
+
+  /**
+   * Move focus to the nearest focusable node to the right of the current focus, by on-screen position.
+   * @returns false if nothing is focused or no node lies in that direction
+   */
+  focusRight(): boolean;
+
+  /**
+   * Move focus to the nearest focusable node above the current focus, by on-screen position.
+   * @returns false if nothing is focused or no node lies in that direction
+   */
+  focusUp(): boolean;
+
+  /**
+   * Move focus to the nearest focusable node below the current focus, by on-screen position.
+   * @returns false if nothing is focused or no node lies in that direction
+   */
+  focusDown(): boolean;
+
   /**
    * Clear focus from the Rive focus tree.
    */
@@ -1048,6 +1072,35 @@ export declare class StateMachineInstance {
    */
   focusState(): FocusState;
 
+  /**
+   * Forward a key press/release to the focus tree via the state machine's focus manager.
+   * The event bubbles from the primary focus node up its ancestors until a handler consumes it.
+   * Modifier keys are sent as keys too; held modifiers also go in the `modifiers` bitmask.
+   * @param key - GLFW-style key code (see js/src/utils/keyMap.ts)
+   * @param modifiers - KeyModifiers bitmask (shift=1, ctrl=2, alt=4, meta=8)
+   * @param isPressed - true for keydown, false for keyup
+   * @param isRepeat - true if this is an auto-repeat keydown
+   * @returns true if a node in the focus chain consumed the event
+   */
+  keyInput(key: number, modifiers: number, isPressed: boolean, isRepeat: boolean): boolean;
+
+  /**
+   * Forward committed text (a printable stroke, IME composition result, or paste) to the focus
+   * tree. This is the only way characters get inserted into a focused text field; `keyInput`
+   * never inserts text. For a printable stroke, hosts typically call both: `keyInput` so
+   * keyboard listeners on that key fire, then `textInput` for the characters.
+   * @param text - the committed text
+   * @returns true if a node in the focus chain consumed the text
+   */
+  textInput(text: string): boolean;
+
+  /**
+   * The selected text of the focused element, or an empty string when nothing with a
+   * selection is focused. Used to fill the clipboard on copy/cut. An obscured field 
+   * (i.e. a password) reports empty string.
+   */
+  selectedText(): string;
+
   /**
    * Deletes the underlying instance created via the WASM. It's important to clean up this instance
    * when no longer in use
@@ -1354,6 +1407,7 @@ export enum StrokeJoin {
 
 export enum BlendMode {
   srcOver = 3,
+  additive = 12,
   screen = 14,
   overlay = 15,
   darken = 16,