@napi-rs/canvas 0.1.84 → 0.1.85

package/README.md

@@ -298,6 +298,92 @@ path.simplify().toSVGString()
 // => "M89.005 3.818L2.933 89.89Q1.526 91.296 0.765 93.134Q0.004 94.972 0.004 96.961Q0.004 98.95 0.765 100.788Q1.526 102.625 2.933 104.032Q4.339 105.439 6.177 106.2Q8.015 106.961 10.004 106.961Q11.993 106.961 13.831 106.2Q15.668 105.439 17.075 104.032L96.076 25.031L175.077 104.032Q176.484 105.439 178.322 106.2Q180.159 106.961 182.148 106.961Q184.138 106.961 185.975 106.2Q187.813 105.439 189.219 104.032Q190.626 102.625 191.387 100.788Q192.148 98.95 192.148 96.961Q192.148 94.972 191.387 93.134Q190.626 91.296 189.22 89.89L103.147 3.818Q101.741 2.411 99.903 1.65Q98.065 0.889 96.076 0.889Q94.087 0.889 92.249 1.65Q90.412 2.411 89.005 3.818Z"
 ```
 
+## Lottie Animation
+
+Render [Lottie](https://airbnb.io/lottie/) animations using Skia's [Skottie](https://skia.org/docs/user/modules/skottie/) module.
+
+### Load Animation
+
+```js
+const { LottieAnimation } = require('@napi-rs/canvas')
+
+// Load from file
+const animation = LottieAnimation.loadFromFile('animation.json')
+
+// Load from JSON string with resource path for external assets
+const animation = LottieAnimation.loadFromData(jsonString, {
+  resourcePath: '/path/to/assets',
+})
+```
+
+### Animation Properties
+
+```js
+animation.duration // Total duration in seconds
+animation.fps // Frames per second
+animation.frames // Total frame count
+animation.width // Animation width
+animation.height // Animation height
+animation.version // Lottie format version
+```
+
+### Playback Control
+
+```js
+animation.seekFrame(30) // Seek to frame 30
+animation.seek(1.5) // Seek to 1.5 seconds
+```
+
+### Render to Canvas
+
+```js
+const { createCanvas, LottieAnimation } = require('@napi-rs/canvas')
+
+const animation = LottieAnimation.loadFromFile('animation.json')
+const canvas = createCanvas(animation.width, animation.height)
+const ctx = canvas.getContext('2d')
+
+// Render at original size
+animation.render(ctx)
+
+// Render with custom destination rect
+animation.render(ctx, { x: 0, y: 0, width: 800, height: 600 })
+```
+
+### Supported Features
+
+- **Embedded images** - Base64-encoded images (`data:image/png;base64,...`)
+- **Embedded fonts** - Vector glyph paths for text rendering without system fonts
+- **External assets** - Load images from `resourcePath` directory
+- **dotLottie format** - Extract `.lottie` ZIP files at runtime (see example)
+
+### Example: Encode Lottie to Video
+
+See [`example/lottie-to-video.ts`](./example/lottie-to-video.ts) for encoding Lottie animations to MP4 using [`@napi-rs/webcodecs`](https://github.com/Brooooooklyn/webcodecs-node).
+
+```js
+import { createCanvas, LottieAnimation } from '@napi-rs/canvas'
+import {
+  VideoEncoder,
+  VideoFrame,
+  Mp4Muxer,
+  type EncodedVideoChunk,
+  type EncodedVideoChunkMetadata,
+} from '@napi-rs/webcodecs'
+
+const animation = LottieAnimation.loadFromFile('animation.json')
+const canvas = createCanvas(animation.width, animation.height)
+const ctx = canvas.getContext('2d')
+
+for (let frame = 0; frame < animation.frames; frame++) {
+  animation.seekFrame(frame)
+  ctx.fillStyle = '#ffffff'
+  ctx.fillRect(0, 0, canvas.width, canvas.height)
+  animation.render(ctx)
+  // Encode frame to video...
+}
+```
+
 # [Example](./example/tiger.js)
 
 > The tiger.json was serialized from [gojs/samples/tiger](https://github.com/NorthwoodsSoftware/GoJS/blob/master/samples/tiger.html)

package/index.d.ts

@@ -957,3 +957,99 @@ export declare class PDFDocument {
   endPage(): void
   close(): Buffer
 }
+
+export interface LottieAnimationOptions {
+  /** Base path for resolving external resources (images, fonts) */
+  resourcePath?: string
+}
+
+export interface LottieRenderRect {
+  x: number
+  y: number
+  width: number
+  height: number
+}
+
+/**
+ * Lottie animation class for loading and rendering Lottie JSON files.
+ *
+ * @example
+ * ```typescript
+ * import { LottieAnimation, createCanvas } from '@napi-rs/canvas'
+ *
+ * const animation = LottieAnimation.loadFromFile('./animation.json')
+ * const canvas = createCanvas(animation.width, animation.height)
+ * const ctx = canvas.getContext('2d')
+ *
+ * // Render frame 0
+ * animation.seekFrame(0)
+ * animation.render(ctx)
+ *
+ * // Save to PNG
+ * const buffer = canvas.toBuffer('image/png')
+ * ```
+ */
+export declare class LottieAnimation {
+  /**
+   * Load animation from JSON string or Buffer
+   * @param data - JSON string or Buffer containing Lottie animation data
+   * @param options - Optional configuration
+   */
+  static loadFromData(data: string | Buffer, options?: LottieAnimationOptions): LottieAnimation
+
+  /**
+   * Load animation from file path
+   * External assets are resolved relative to the file's directory
+   * @param path - Path to the Lottie JSON file
+   */
+  static loadFromFile(path: string): LottieAnimation
+
+  /** Animation duration in seconds */
+  readonly duration: number
+
+  /** Frame rate (frames per second) */
+  readonly fps: number
+
+  /** Total frame count */
+  readonly frames: number
+
+  /** Animation width in pixels */
+  readonly width: number
+
+  /** Animation height in pixels */
+  readonly height: number
+
+  /** Lottie format version string */
+  readonly version: string
+
+  /** Animation in-point (start frame) */
+  readonly inPoint: number
+
+  /** Animation out-point (end frame) */
+  readonly outPoint: number
+
+  /**
+   * Seek to normalized position
+   * @param t - Position between 0.0 (start) and 1.0 (end)
+   */
+  seek(t: number): void
+
+  /**
+   * Seek to specific frame index
+   * @param frame - Frame index (0 = first frame)
+   */
+  seekFrame(frame: number): void
+
+  /**
+   * Seek to specific time in seconds
+   * @param seconds - Time in seconds from start
+   */
+  seekTime(seconds: number): void
+
+  /**
+   * Render current frame to canvas context
+   * @param ctx - Canvas 2D rendering context
+   * @param dst - Optional destination rectangle for scaling/positioning
+   */
+  render(ctx: CanvasRenderingContext2D, dst?: LottieRenderRect): void
+}

package/index.js

@@ -19,6 +19,7 @@ const {
   PdfDocument,
   GifEncoder,
   GifDisposal,
+  LottieAnimation,
 } = require('./js-binding')
 
 const { DOMPoint, DOMMatrix, DOMRect } = require('./geometry')
@@ -190,4 +191,6 @@ module.exports = {
   // GIF encoding
   GifEncoder,
   GifDisposal,
+  // Lottie animation
+  LottieAnimation,
 }

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@napi-rs/canvas",
-  "version": "0.1.84",
+  "version": "0.1.85",
   "description": "Canvas for Node.js with skia backend",
   "main": "index.js",
   "repository": {
@@ -37,6 +37,7 @@
       "x86_64-unknown-linux-gnu",
       "x86_64-apple-darwin",
       "x86_64-pc-windows-msvc",
+      "aarch64-pc-windows-msvc",
       "armv7-unknown-linux-gnueabihf",
       "x86_64-unknown-linux-musl",
       "aarch64-unknown-linux-gnu",
@@ -58,6 +59,7 @@
     "bench": "node --import @oxc-node/core/register benchmark/bench.ts",
     "build": "napi build --platform --release --js js-binding.js",
     "build:debug": "napi build --platform --js js-binding.js",
+    "example-lottie": "yarn oxnode ./example/lottie-to-video.ts",
     "format": "run-p format:source format:rs format:toml",
     "format:rs": "cargo fmt",
     "format:source": "prettier . -w",
@@ -76,7 +78,9 @@
     "@jimp/jpeg": "^0.22.12",
     "@jimp/png": "^0.22.12",
     "@napi-rs/cli": "^3.1.1",
+    "@napi-rs/webcodecs": "^1.1.0",
     "@octokit/rest": "^22.0.0",
+    "@oxc-node/cli": "^0.0.35",
     "@oxc-node/core": "^0.0.35",
     "@taplo/cli": "^0.7.0",
     "@types/lodash": "^4.17.17",
@@ -140,17 +144,22 @@
     "singleQuote": true,
     "arrowParens": "always"
   },
+  "funding": {
+    "type": "github",
+    "url": "https://github.com/sponsors/Brooooooklyn"
+  },
   "packageManager": "yarn@4.12.0",
   "optionalDependencies": {
-    "@napi-rs/canvas-linux-x64-gnu": "0.1.84",
-    "@napi-rs/canvas-darwin-x64": "0.1.84",
-    "@napi-rs/canvas-win32-x64-msvc": "0.1.84",
-    "@napi-rs/canvas-linux-arm-gnueabihf": "0.1.84",
-    "@napi-rs/canvas-linux-x64-musl": "0.1.84",
-    "@napi-rs/canvas-linux-arm64-gnu": "0.1.84",
-    "@napi-rs/canvas-linux-arm64-musl": "0.1.84",
-    "@napi-rs/canvas-darwin-arm64": "0.1.84",
-    "@napi-rs/canvas-android-arm64": "0.1.84",
-    "@napi-rs/canvas-linux-riscv64-gnu": "0.1.84"
+    "@napi-rs/canvas-linux-x64-gnu": "0.1.85",
+    "@napi-rs/canvas-darwin-x64": "0.1.85",
+    "@napi-rs/canvas-win32-x64-msvc": "0.1.85",
+    "@napi-rs/canvas-win32-arm64-msvc": "0.1.85",
+    "@napi-rs/canvas-linux-arm-gnueabihf": "0.1.85",
+    "@napi-rs/canvas-linux-x64-musl": "0.1.85",
+    "@napi-rs/canvas-linux-arm64-gnu": "0.1.85",
+    "@napi-rs/canvas-linux-arm64-musl": "0.1.85",
+    "@napi-rs/canvas-darwin-arm64": "0.1.85",
+    "@napi-rs/canvas-android-arm64": "0.1.85",
+    "@napi-rs/canvas-linux-riscv64-gnu": "0.1.85"
   }
 }