@napi-rs/canvas 0.1.82 → 0.1.84

package/README.md

@@ -1,7 +1,7 @@
 # `skr canvas`
 
 [![CI](https://github.com/Brooooooklyn/canvas/actions/workflows/CI.yaml/badge.svg)](https://github.com/Brooooooklyn/canvas/actions/workflows/CI.yaml)
-![Skia Version](https://img.shields.io/badge/Skia-chrome%2Fm142-hotpink)
+![Skia Version](https://img.shields.io/badge/Skia-chrome%2Fm143-hotpink)
 [![install size](https://packagephobia.com/badge?p=@napi-rs/canvas)](https://packagephobia.com/result?p=@napi-rs/canvas)
 [![Downloads](https://img.shields.io/npm/dm/@napi-rs/canvas.svg?sanitize=true)](https://npmcharts.com/compare/@napi-rs/canvas?minimal=true)
 

package/index.d.ts

@@ -5,21 +5,21 @@ export function clearAllCache(): void
 
 interface CanvasRenderingContext2D
   extends CanvasCompositing,
-    CanvasDrawPath,
-    CanvasFillStrokeStyles,
-    CanvasFilters,
-    CanvasImageData,
-    CanvasImageSmoothing,
-    CanvasPath,
-    CanvasPathDrawingStyles,
-    CanvasRect,
-    CanvasSettings,
-    CanvasShadowStyles,
-    CanvasState,
-    CanvasText,
-    CanvasTextDrawingStyles,
-    CanvasTransform,
-    CanvasPDFAnnotations {}
+  CanvasDrawPath,
+  CanvasFillStrokeStyles,
+  CanvasFilters,
+  CanvasImageData,
+  CanvasImageSmoothing,
+  CanvasPath,
+  CanvasPathDrawingStyles,
+  CanvasRect,
+  CanvasSettings,
+  CanvasShadowStyles,
+  CanvasState,
+  CanvasText,
+  CanvasTextDrawingStyles,
+  CanvasTransform,
+  CanvasPDFAnnotations { }
 
 interface CanvasState {
   isContextLost(): boolean
@@ -211,6 +211,7 @@ interface CanvasTextDrawingStyles {
   textBaseline: CanvasTextBaseline
   textRendering: CanvasTextRendering
   wordSpacing: string
+  fontVariationSettings: string
 }
 
 interface CanvasFilters {
@@ -421,7 +422,7 @@ type OmitNeverOfMatrix = OmitMatrixMethod[keyof OmitMatrixMethod]
 
 export const DOMMatrix: {
   prototype: DOMMatrix
-  new (init?: string | number[]): DOMMatrix
+  new(init?: string | number[]): DOMMatrix
   fromFloat32Array(array32: Float32Array): DOMMatrix
   fromFloat64Array(array64: Float64Array): DOMMatrix
   fromMatrix(other?: DOMMatrixInit): DOMMatrix
@@ -448,7 +449,7 @@ export interface DOMRect extends DOMRectReadOnly {
 
 export const DOMRect: {
   prototype: DOMRect
-  new (x?: number, y?: number, width?: number, height?: number): DOMRect
+  new(x?: number, y?: number, width?: number, height?: number): DOMRect
   fromRect(other?: DOMRectInit): DOMRect
 }
 
@@ -470,7 +471,7 @@ export interface DOMPoint extends DOMPointReadOnly {
 
 export const DOMPoint: {
   prototype: DOMPoint
-  new (x?: number, y?: number, z?: number, w?: number): DOMPoint
+  new(x?: number, y?: number, z?: number, w?: number): DOMPoint
   fromPoint(other?: DOMPointInit): DOMPoint
 }
 
@@ -618,6 +619,121 @@ export interface AvifConfig {
   /** set to '4:2:0' to use chroma subsampling, default '4:4:4' */
   chromaSubsampling?: ChromaSubsampling
 }
+
+/** GIF encoding configuration for single-frame encoding */
+export interface GifConfig {
+  /**
+   * Quality for NeuQuant color quantization (1-30, lower = slower but better quality)
+   * @default 10
+   */
+  quality?: number
+}
+
+/** Configuration for the GIF encoder (animated GIFs) */
+export interface GifEncoderConfig {
+  /**
+   * Loop count: 0 = infinite loop, positive number = finite loops
+   * @default 0 (infinite)
+   */
+  repeat?: number
+  /**
+   * Quality for NeuQuant color quantization (1-30, lower = slower but better quality)
+   * @default 10
+   */
+  quality?: number
+}
+
+/** Configuration for individual GIF frames */
+export interface GifFrameConfig {
+  /**
+   * Frame delay in milliseconds
+   * @default 100
+   */
+  delay?: number
+  /** Disposal method for this frame */
+  disposal?: GifDisposal
+  /** Transparent color index (0-255), if the frame has transparency */
+  transparent?: number
+  /** X offset of this frame within the canvas */
+  left?: number
+  /** Y offset of this frame within the canvas */
+  top?: number
+}
+
+/** GIF frame disposal method */
+export enum GifDisposal {
+  /** Keep the frame visible (default) */
+  Keep = 0,
+  /** Clear the frame area to the background color */
+  Background = 1,
+  /** Restore to the previous frame */
+  Previous = 2,
+}
+
+/**
+ * GIF Encoder for creating animated GIFs.
+ * Implements `Disposable` interface for use with the `using` keyword (ES2024).
+ *
+ * @example
+ * ```typescript
+ * // Basic usage
+ * const encoder = new GifEncoder(100, 100, { repeat: 0, quality: 10 });
+ * encoder.addFrame(rgbaData, 100, 100, { delay: 100 });
+ * encoder.addFrame(rgbaData2, 100, 100, { delay: 100 });
+ * const buffer = encoder.finish();
+ *
+ * // With `using` keyword (automatic cleanup)
+ * {
+ *   using encoder = new GifEncoder(100, 100);
+ *   encoder.addFrame(frame1, 100, 100, { delay: 100 });
+ *   const buffer = encoder.finish();
+ * } // encoder automatically disposed
+ * ```
+ */
+export class GifEncoder implements Disposable {
+  /**
+   * Create a new GIF encoder with the specified dimensions
+   * @param width - Width of the GIF canvas in pixels
+   * @param height - Height of the GIF canvas in pixels
+   * @param config - Optional encoder configuration
+   */
+  constructor(width: number, height: number, config?: GifEncoderConfig)
+
+  /** Width of the GIF canvas */
+  readonly width: number
+  /** Height of the GIF canvas */
+  readonly height: number
+  /** Number of frames added so far */
+  readonly frameCount: number
+
+  /**
+   * Add a frame from RGBA pixel data
+   * @param data - RGBA pixel data (must be width * height * 4 bytes)
+   * @param width - Width of the frame in pixels
+   * @param height - Height of the frame in pixels
+   * @param config - Optional frame configuration
+   */
+  addFrame(data: Uint8Array, width: number, height: number, config?: GifFrameConfig): void
+
+  /**
+   * Finish encoding and return the GIF data.
+   * Clears all accumulated frames after encoding.
+   * @throws Error if no frames have been added
+   */
+  finish(): Buffer
+
+  /**
+   * Dispose of the encoder, clearing all accumulated frames without encoding.
+   * Called automatically when using the `using` keyword.
+   */
+  dispose(): void
+
+  /**
+   * Symbol.dispose implementation for ES2024 Explicit Resource Management.
+   * Allows using `using encoder = new GifEncoder(...)` syntax.
+   */
+  [Symbol.dispose](): void
+}
 /**
  * https://en.wikipedia.org/wiki/Chroma_subsampling#Types_of_sampling_and_subsampling
  * https://developer.mozilla.org/en-US/docs/Web/Media/Formats/Video_concepts
@@ -675,24 +791,29 @@ export class Canvas {
   encodeSync(format: 'webp' | 'jpeg', quality?: number): Buffer
   encodeSync(format: 'png'): Buffer
   encodeSync(format: 'avif', cfg?: AvifConfig): Buffer
+  encodeSync(format: 'gif', quality?: number): Buffer
   encode(format: 'webp' | 'jpeg', quality?: number): Promise<Buffer>
   encode(format: 'png'): Promise<Buffer>
   encode(format: 'avif', cfg?: AvifConfig): Promise<Buffer>
+  encode(format: 'gif', quality?: number): Promise<Buffer>
   encodeStream(format: 'webp' | 'jpeg', quality?: number): ReadableStream<Buffer>
   encodeStream(format: 'png'): ReadableStream<Buffer>
   toBuffer(mime: 'image/png'): Buffer
   toBuffer(mime: 'image/jpeg' | 'image/webp', quality?: number): Buffer
   toBuffer(mime: 'image/avif', cfg?: AvifConfig): Buffer
+  toBuffer(mime: 'image/gif', quality?: number): Buffer
   // raw pixels
   data(): Buffer
   toDataURL(mime?: 'image/png'): string
   toDataURL(mime: 'image/jpeg' | 'image/webp', quality?: number): string
-  toDataURL(mime?: 'image/jpeg' | 'image/webp' | 'image/png', quality?: number): string
+  toDataURL(mime: 'image/gif', quality?: number): string
+  toDataURL(mime?: 'image/jpeg' | 'image/webp' | 'image/png' | 'image/gif', quality?: number): string
   toDataURL(mime?: 'image/avif', cfg?: AvifConfig): string
 
   toDataURLAsync(mime?: 'image/png'): Promise<string>
   toDataURLAsync(mime: 'image/jpeg' | 'image/webp', quality?: number): Promise<string>
-  toDataURLAsync(mime?: 'image/jpeg' | 'image/webp' | 'image/png', quality?: number): Promise<string>
+  toDataURLAsync(mime: 'image/gif', quality?: number): Promise<string>
+  toDataURLAsync(mime?: 'image/jpeg' | 'image/webp' | 'image/png' | 'image/gif', quality?: number): Promise<string>
   toDataURLAsync(mime?: 'image/avif', cfg?: AvifConfig): Promise<string>
 
   toBlob(callback: (blob: Blob | null) => void, mime?: string, quality?: number): void
@@ -708,6 +829,21 @@ export declare class FontKey {
   private readonly key: symbol
 }
 
+export interface FontVariationAxis {
+  /** OpenType tag as a 32-bit integer (e.g., 0x77676874 for 'wght') */
+  tag: number
+  /** Current value for this axis */
+  value: number
+  /** Minimum value for this axis */
+  min: number
+  /** Maximum value for this axis */
+  max: number
+  /** Default value for this axis */
+  def: number
+  /** Whether this axis should be hidden from UI */
+  hidden: boolean
+}
+
 interface IGlobalFonts {
   readonly families: { family: string; styles: { weight: number; width: string; style: string }[] }[]
   // return true if succeeded
@@ -717,6 +853,24 @@ interface IGlobalFonts {
   has(name: string): boolean
   loadFontsFromDir(path: string): number
   remove(key: FontKey): void
+  /**
+   * Get variation axes for a specific font instance
+   * @param familyName The font family name
+   * @param weight Font weight (100-900)
+   * @param width Font width/stretch value
+   * @param slant Font slant (0 = upright, 1 = italic, 2 = oblique)
+   * @returns Array of variation axes or empty array if not a variable font
+   */
+  getVariationAxes(familyName: string, weight: number, width: number, slant: number): FontVariationAxis[]
+  /**
+   * Check if a font has variable font capabilities
+   * @param familyName The font family name
+   * @param weight Font weight (100-900)
+   * @param width Font width/stretch value
+   * @param slant Font slant (0 = upright, 1 = italic, 2 = oblique)
+   * @returns true if the font is a variable font
+   */
+  hasVariations(familyName: string, weight: number, width: number, slant: number): boolean
 }
 
 export const GlobalFonts: IGlobalFonts

package/index.js

@@ -17,12 +17,21 @@ const {
   StrokeCap,
   convertSVGTextToPath,
   PdfDocument,
+  GifEncoder,
+  GifDisposal,
 } = require('./js-binding')
 
 const { DOMPoint, DOMMatrix, DOMRect } = require('./geometry')
 
 const loadImage = require('./load-image')
 
+// Add Symbol.dispose support for GifEncoder (ECMAScript 2024 Explicit Resource Management)
+if (GifEncoder && typeof Symbol.dispose !== 'undefined') {
+  GifEncoder.prototype[Symbol.dispose] = function () {
+    this.dispose()
+  }
+}
+
 const SvgExportFlag = {
   ConvertTextToPaths: 0x01,
   NoPrettyXML: 0x02,
@@ -178,4 +187,7 @@ module.exports = {
   CanvasElement,
   SVGCanvas,
   PDFDocument: PdfDocument,
+  // GIF encoding
+  GifEncoder,
+  GifDisposal,
 }

package/js-binding.js

@@ -460,3 +460,5 @@ module.exports.PathOp = nativeBinding.PathOp
 module.exports.StrokeCap = nativeBinding.StrokeCap
 module.exports.StrokeJoin = nativeBinding.StrokeJoin
 module.exports.SvgExportFlag = nativeBinding.SvgExportFlag
+module.exports.GifEncoder = nativeBinding.GifEncoder
+module.exports.GifDisposal = nativeBinding.GifDisposal

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@napi-rs/canvas",
-  "version": "0.1.82",
+  "version": "0.1.84",
   "description": "Canvas for Node.js with skia backend",
   "main": "index.js",
   "repository": {
@@ -77,7 +77,7 @@
     "@jimp/png": "^0.22.12",
     "@napi-rs/cli": "^3.1.1",
     "@octokit/rest": "^22.0.0",
-    "@oxc-node/core": "^0.0.34",
+    "@oxc-node/core": "^0.0.35",
     "@taplo/cli": "^0.7.0",
     "@types/lodash": "^4.17.17",
     "@types/node": "^24.0.0",
@@ -102,7 +102,7 @@
     "semver": "^7.7.2",
     "skia-canvas": "^3.0.0",
     "table": "^6.9.0",
-    "tinybench": "^5.0.0",
+    "tinybench": "^6.0.0",
     "typescript": "^5.8.3"
   },
   "lint-staged": {
@@ -140,17 +140,17 @@
     "singleQuote": true,
     "arrowParens": "always"
   },
-  "packageManager": "yarn@4.11.0",
+  "packageManager": "yarn@4.12.0",
   "optionalDependencies": {
-    "@napi-rs/canvas-linux-x64-gnu": "0.1.82",
-    "@napi-rs/canvas-darwin-x64": "0.1.82",
-    "@napi-rs/canvas-win32-x64-msvc": "0.1.82",
-    "@napi-rs/canvas-linux-arm-gnueabihf": "0.1.82",
-    "@napi-rs/canvas-linux-x64-musl": "0.1.82",
-    "@napi-rs/canvas-linux-arm64-gnu": "0.1.82",
-    "@napi-rs/canvas-linux-arm64-musl": "0.1.82",
-    "@napi-rs/canvas-darwin-arm64": "0.1.82",
-    "@napi-rs/canvas-android-arm64": "0.1.82",
-    "@napi-rs/canvas-linux-riscv64-gnu": "0.1.82"
+    "@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"
   }
 }