@rive-app/canvas-single 2.40.1 → 2.41.1

package/rive_advanced.mjs.d.ts

@@ -164,12 +164,19 @@ export declare class RendererWrapper {
   drawPath(path: RenderPath, paint: RenderPaint): void;
   clipPath(path: RenderPath): void;
   /**
-   * Calls the context's clearRect() function to clear the entire canvas. Crucial to call
-   * this at the start of the render loop to clear the canvas before drawing the next frame
+   * Begins a frame. Crucial to call this at the start of the render loop: besides clearing
+   * the canvas, it registers the renderer so that its queued draws actually get flushed.
    *
-   * For the underlying API, check
+   * Pass clear=false to draw on top of whatever the canvas already holds instead of
+   * starting from a blank one.
+   *
+   * For the underlying clear, check
    * https://developer.mozilla.org/en-US/docs/Web/API/CanvasRenderingContext2D/clearRect
    */
+  beginFrame(clear?: boolean): void;
+  /**
+   * @deprecated Use {@link beginFrame} instead. Equivalent to `beginFrame(true)`.
+   */
   clear(): void;
   delete(): void;
   flush(): void;
@@ -184,7 +191,15 @@ export declare class RendererWrapper {
 
 export declare class RenderPathWrapper {
   reset(): void;
-  addPath(path: CommandPath, transform: Mat2D): void;
+  addPath(
+    path: CommandPath,
+    xx: number,
+    xy: number,
+    yx: number,
+    yy: number,
+    tx: number,
+    ty: number,
+  ): void;
   fillRule(value: FillRule): void;
   moveTo(x: number, y: number): void;
   lineTo(x: number, y: number): void;
@@ -233,11 +248,11 @@ export declare class Renderer extends RendererWrapper {
   ): void;
 }
 
-export declare class CommandPath {}
+export declare class CommandPath { }
 
-export declare class RenderPath extends RenderPathWrapper {}
+export declare class RenderPath extends RenderPathWrapper { }
 
-export declare class RenderPaint extends RenderPaintWrapper {}
+export declare class RenderPaint extends RenderPaintWrapper { }
 
 /////////////////////
 // CANVAS RENDERER //
@@ -287,7 +302,7 @@ export declare class CanvasRenderPaint extends RenderPaint {
   ): void;
 }
 
-export declare class CanvasRenderPath extends RenderPath {}
+export declare class CanvasRenderPath extends RenderPath { }
 
 export interface CanvasRenderFactory {
   makeRenderPaint(): CanvasRenderPaint;
@@ -1202,11 +1217,11 @@ export declare class DataEnum {
   get values(): string[];
 }
 
-export declare class SMIBool {}
+export declare class SMIBool { }
 
-export declare class SMINumber {}
+export declare class SMINumber { }
 
-export declare class SMITrigger {}
+export declare class SMITrigger { }
 
 ///////////
 // ENUMS //
@@ -1428,7 +1443,7 @@ export declare class FontAsset extends FileAsset {
   setFont(font: Font | FontWrapper): void;
 }
 
-export declare class FileAssetLoader {}
+export declare class FileAssetLoader { }
 
 export declare class CustomFileAssetLoader extends FileAssetLoader {
   constructor({ loadContents }: { loadContents: Function });

package/semantics/index.d.ts

@@ -1,5 +1,5 @@
 export { SemanticTreeModel } from "./semanticTreeModel";
 export { AccessibilityOverlay } from "./accessibilityOverlay";
 export type { AccessibilityOverlayOptions } from "./accessibilityOverlay";
-export { SemanticRole, SemanticState, SemanticTrait, SemanticActionType, SemanticMode, hasState, hasTrait, roleName, stateNames, traitNames, } from "./types";
+export { SemanticRole, SemanticState, SemanticCheckState, SemanticTrait, SemanticActionType, SemanticMode, CHECK_STATE_OFFSET, CHECK_STATE_MASK, checkStateOf, hasState, hasTrait, roleName, stateNames, traitNames, } from "./types";
 export type { SemanticsDiffNode, SemanticsDiff, SemanticNodeData, RiveSemanticsOptions, } from "./types";

package/semantics/types.d.ts

@@ -25,8 +25,6 @@ export declare const SemanticState: {
     readonly None: 0;
     readonly Expanded: number;
     readonly Selected: number;
-    readonly Checked: number;
-    readonly Mixed: number;
     readonly Toggled: number;
     readonly Required: number;
     readonly Disabled: number;
@@ -39,6 +37,21 @@ export declare const SemanticState: {
     readonly Multiline: number;
 };
 export declare function hasState(flags: number, state: number): boolean;
+export declare const SemanticCheckState: {
+    readonly Unchecked: 0;
+    readonly Checked: 1;
+    readonly Mixed: 2;
+};
+export type SemanticCheckState = (typeof SemanticCheckState)[keyof typeof SemanticCheckState];
+/** Bit offset of the check field within stateFlags. */
+export declare const CHECK_STATE_OFFSET = 2;
+/** Mask of the check field within stateFlags. */
+export declare const CHECK_STATE_MASK: number;
+/**
+ * Decodes the check field out of `flags`. The field is two bits. Returns 0, 1, or 2
+ * per the mapping in SemanticCheckState.
+ */
+export declare function checkStateOf(flags: number): SemanticCheckState;
 /**
  * Controls when the instance builds semantic trees and accessibility overlays.
  *