@motion-script/web 0.1.0

package/dist/render-context.d.ts

@@ -0,0 +1,107 @@
+import type { CanvasKit } from "@motion-script/canvaskit";
+import { type BooleanOperation, type ClipShape, type EllipseState, type FillProp, type FillResolved, type ImageState, type ShadowProp, type ShadowResolved, type StrokeProp, type StrokeResolved, type LineState, type MaskOptions, type PathState, PathBuilder, type PolygonState, type PolygramState, type RectState, type Render2DPaintContext, RenderContext, type RichTextState, type SpaceRects, type TextState, type TransformState, type Vector2, type BulgePinchEffect, type ZoomEffect, type FontStyle, type SkSLEffect } from "@motion-script/core";
+import { WebStorageAdapter } from "./storage-adapter";
+/**
+ * CanvasKit/Skia implementation of {@link RenderContext} — the main render
+ * loop driving a mounted `<canvas>` (or an offscreen one during export).
+ * Owns the WebGL surface and the per-frame draw stack (transforms, clips,
+ * masks, camera, backdrop effects); delegates shape/fill/stroke painting to
+ * the handlers built in {@link buildHandlers}. All async asset work happens
+ * up front in {@link WebStorageAdapter} so render() stays synchronous per frame.
+ */
+export declare class WebRenderContext extends RenderContext {
+    private currentCanvas;
+    private canvasKit;
+    private canvasElement;
+    private surface;
+    private paint;
+    private layerPaint;
+    private mounted;
+    private isRendering;
+    private effectLayerStack;
+    private clipRestoreStack;
+    private fillHandler;
+    private strokeHandler;
+    private shapeHandler;
+    private imageRenderer;
+    private deferredPaintsStack;
+    private pendingImage;
+    private pendingImageShadows;
+    private pendingImageFills;
+    private pendingImageStrokes;
+    storageAdapter: WebStorageAdapter;
+    constructor(canvasKit: CanvasKit, storageAdapter: WebStorageAdapter);
+    measureText(text: string, fontSize: number, fontFamily: string, fontWeight?: number, letterSpacing?: number, fontStyle?: FontStyle): number;
+    private buildHandlers;
+    private flushPendingImage;
+    pixelRatio: number;
+    private renderPass;
+    begin(id: string, rects?: SpaceRects): void;
+    end(): void;
+    dispose(): void;
+    /** Runs one synchronous draw pass (`callback`) against the mounted surface. */
+    render(callback: () => void): Promise<void>;
+    /** Attaches a WebGL CanvasKit surface to `canvas`, remounting if already mounted (HMR/StrictMode). */
+    mount(canvas: HTMLCanvasElement): void;
+    unmount(): void;
+    /** Snapshots the current surface and encodes it as a PNG data URL via the browser's canvas (CanvasKit ships no wasm encoders). */
+    screenshot(): string | undefined;
+    /** Wraps the just-flushed canvas as a `VideoFrame` for the export pipeline (mediabunny's `CanvasSource`). */
+    captureVideoFrame(timestampUs: number, durationUs: number): VideoFrame | undefined;
+    /** Applies the node's transform to the canvas and, when opacity < 1 or effects are present, pushes a `saveLayer` tracked in {@link effectLayerStack} for `end()` to unwind. */
+    transform(state: Partial<TransformState>): RenderContext;
+    private spaceRect;
+    rect(state: Partial<RectState>): Render2DPaintContext;
+    ellipse(state: Partial<EllipseState>): Render2DPaintContext;
+    path(state: Partial<PathState> | PathBuilder): Render2DPaintContext;
+    line(state: Partial<LineState>): Render2DPaintContext;
+    polygon(state: Partial<PolygonState>): Render2DPaintContext;
+    polygram(state: Partial<PolygramState>): Render2DPaintContext;
+    text(state: Partial<TextState>): Render2DPaintContext;
+    /** Lays out spans/runs and paints each run's fill/stroke immediately (rich text carries per-span paint, bypassing the usual `.fill()/.stroke()` chain). */
+    richText(state: Partial<RichTextState>): Render2DPaintContext;
+    /** Defers drawing until a chained `.fill()/.stroke()/.shadow()` or the next shape call flushes via {@link flushPendingImage} — lets images join the same paint-context chaining as other shapes. */
+    image(state: Partial<ImageState>): Render2DPaintContext;
+    /** @internal */ _appendImageShadows(s: ShadowResolved[]): void;
+    /** @internal */ _appendImageFills(f: FillResolved[]): void;
+    /** @internal */ _appendImageStrokes(s: StrokeResolved[]): void;
+    private imagePaintCtx;
+    fill(fills: FillProp | FillProp[]): Render2DPaintContext;
+    private applyFillSpaceBounds;
+    private strokeShapesForSpace;
+    stroke(strokes: StrokeProp | StrokeProp[]): Render2DPaintContext;
+    shadow(shadows: ShadowProp | ShadowProp[]): Render2DPaintContext;
+    cut(): Render2DPaintContext;
+    private cameraRestoreStack;
+    beginCamera(viewport: {
+        x: number;
+        y: number;
+        width: number;
+        height: number;
+    }, centerOn: Vector2, zoom: number, heading: number): void;
+    endCamera(): void;
+    beginClipRect(state: Partial<RectState>): void;
+    beginClipEllipse(state: Partial<EllipseState>): void;
+    endClip(): void;
+    private buildClipShape;
+    beginClipShape(shape: ClipShape): void;
+    private backgroundBlurStack;
+    beginBackgroundBlur(radius: number): void;
+    endBackgroundBlur(): void;
+    private backgroundDistortionStack;
+    beginBackgroundDistortion(effect: BulgePinchEffect | ZoomEffect, width: number, height: number): void;
+    endBackgroundDistortion(): void;
+    private backdropSkSLStack;
+    beginBackdropSkSL(effect: SkSLEffect, width: number, height: number): void;
+    endBackdropSkSL(): void;
+    drawWebGLCanvas(canvas: HTMLCanvasElement, x: number, y: number, w: number, h: number): boolean;
+    beginBoolean(op: BooleanOperation): void;
+    endBoolean(): Render2DPaintContext;
+    mask(options?: MaskOptions): Render2DPaintContext;
+    beginMask(options?: MaskOptions): void;
+    applyMask(): Render2DPaintContext;
+    endMask(): void;
+    /** Replays fill/stroke calls that were postponed by an active mask scope (see `mask`/`fill`/`stroke`), in original order, once the mask resolves at `endMask`. */
+    private flushDeferredPaints;
+}
+//# sourceMappingURL=render-context.d.ts.map

package/dist/render-context.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"render-context.d.ts","sourceRoot":"","sources":["../src/render-context.ts"],"names":[],"mappings":"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"}