@grida/canvas-wasm 0.0.82-canary.1 → 0.0.84-canary.0

package/dist/index.d.mts

@@ -193,6 +193,192 @@ declare namespace fonts {
   }
 }
 
+declare namespace svgtypes {
+  // ====================================================================================================
+  // #region: Core Type Definitions
+  // ====================================================================================================
+
+  /**
+   * rust/serde Option<T> equivalant
+   */
+  type TOption<T> = T | null;
+  type RGBA8888 = [r: number, g: number, b: number, a: number];
+  type Transform2D = [[number, number, number], [number, number, number]];
+  type StrokeCap = "butt" | "round" | "square";
+  type StrokeJoin = "miter" | "round" | "bevel";
+  type FillRule = "nonzero" | "evenodd";
+  type BlendMode =
+    | "normal"
+    | "multiply"
+    | "screen"
+    | "overlay"
+    | "darken"
+    | "lighten"
+    | "color-dodge"
+    | "color-burn"
+    | "hard-light"
+    | "soft-light"
+    | "difference"
+    | "exclusion"
+    | "hue"
+    | "saturation"
+    | "color"
+    | "luminosity";
+
+  export enum SVGTextAnchor {
+    start = "start",
+    middle = "middle",
+    end = "end",
+  }
+
+  export enum SVGSpreadMethod {
+    pad = "pad",
+    reflect = "reflect",
+    repeat = "repeat",
+  }
+
+  export interface SVGSolidPaint {
+    kind: "solid";
+    color: RGBA8888;
+  }
+
+  export interface SVGGradientStop {
+    color: RGBA8888;
+    offset: number;
+    // opacity: number;
+  }
+
+  export interface SVGLinearGradientPaint {
+    kind: "linear-gradient";
+    id: string;
+    x1: number;
+    y1: number;
+    x2: number;
+    y2: number;
+    transform: Transform2D;
+    stops: Array<SVGGradientStop>;
+    spread_method: SVGSpreadMethod;
+  }
+
+  export interface SVGRadialGradientPaint {
+    kind: "radial-gradient";
+    id: string;
+    cx: number;
+    cy: number;
+    r: number;
+    fx: number;
+    fy: number;
+    transform: Transform2D;
+    stops: Array<SVGGradientStop>;
+    spread_method: SVGSpreadMethod;
+  }
+
+  export type SVGPaint =
+    | SVGSolidPaint
+    | SVGLinearGradientPaint
+    | SVGRadialGradientPaint;
+
+  export interface SVGFillAttributes {
+    paint: SVGPaint;
+    fill_opacity: number;
+    fill_rule: FillRule;
+  }
+
+  export interface SVGStrokeAttributes {
+    paint: SVGPaint;
+    stroke_width: TOption<number>;
+    stroke_linecap: StrokeCap;
+    stroke_linejoin: StrokeJoin;
+    stroke_miterlimit: number;
+    stroke_dasharray: TOption<Array<number>>;
+    stroke_opacity: number;
+  }
+
+  export namespace ir {
+    export interface IRSVGInitialContainerNode {
+      width: number;
+      height: number;
+      children: Array<IRSVGChildNode>;
+    }
+
+    export type IRSVGChildNode =
+      | IRSVGGroupNode
+      | IRSVGPathNode
+      | IRSVGTextNode
+      | IRSVGImageNode;
+
+    export interface IRSVGGroupNode {
+      kind: "group";
+      transform: Transform2D;
+      opacity: number;
+      blend_mode: BlendMode;
+      children: Array<IRSVGChildNode>;
+    }
+
+    export interface IRSVGPathNode {
+      kind: "path";
+      transform: Transform2D;
+      fill: TOption<SVGFillAttributes>;
+      stroke: TOption<SVGStrokeAttributes>;
+      d: string;
+    }
+
+    export interface IRSVGTextNode {
+      kind: "text";
+      transform: Transform2D;
+      text_content: string;
+      fill: TOption<SVGFillAttributes>;
+      stroke: TOption<SVGStrokeAttributes>;
+      spans: Array<IRSVGTextSpanNode>;
+    }
+
+    export interface IRSVGTextSpanNode {
+      transform: Transform2D;
+      text: string;
+      fill: TOption<SVGFillAttributes>;
+      stroke: TOption<SVGStrokeAttributes>;
+      font_size: TOption<number>;
+      anchor: SVGTextAnchor;
+    }
+
+    export interface IRSVGImageNode {
+      kind: "image";
+    }
+  }
+}
+
+declare namespace svg {
+  export type SVGOptimizeResponse = CAPIMethodResult<{
+    /** Optimized SVG string with CSS styles resolved and inlined */
+    svg_optimized: string;
+  }>;
+
+  export type SVGPackResponse = CAPIMethodResult<{
+    svg: svgtypes.ir.IRSVGInitialContainerNode;
+  }>;
+
+  // ====================================================================================================
+  // #region: WASM Function Declarations
+  // ====================================================================================================
+
+  export interface SVGModule {
+    // ====================================================================================================
+    // #region: High-Level SVG APIs
+    // ====================================================================================================
+
+    /**
+     * Optimizes and resolves an SVG, producing a flat, self-contained SVG output.
+     * Resolves CSS styles from `<style>` tags and inlines them as element attributes.
+     *
+     * @param svg - Pointer to input SVG string (null-terminated C string)
+     * @returns Pointer to JSON string containing {@link svgtypes.SvgOptimizeResponse}
+     */
+    _grida_svg_optimize(svg: CPtr): CPtr;
+
+    _grida_svg_pack(sgv: CPtr): CPtr;
+  }
+}
+
 ///
 /// @grida/canvas-wasm grida-canvas-wasm.js typescript definitions
 /// this is NOT generated by emscripten. update manually.
@@ -211,7 +397,8 @@ declare namespace createGridaCanvas$1 {
   interface GridaCanvasWasmBindings
     extends emscripten.emscripten_EXPORTED_RUNTIME_METHODS,
       canvas.CanvasModule,
-      fonts.FontsModule {}
+      fonts.FontsModule,
+      svg.SVGModule {}
 }
 
 declare class FontsAPI {
@@ -266,6 +453,38 @@ declare class FontsAPI {
     parseFont(fontData: ArrayBuffer | Uint8Array, faceId: string, userFontStyleItalic?: boolean): Promise<fonts.types.FaceRecord>;
 }
 
+declare class SVGAPI {
+    private module;
+    constructor(module: any);
+    /**
+     * Allocates memory for a string and returns pointer and length.
+     * @param txt - String to allocate
+     * @returns [pointer, length] tuple
+     */
+    private _alloc_string;
+    /**
+     * Frees memory allocated for a string.
+     * @param ptr - Pointer to free
+     * @param len - Length of allocated memory
+     */
+    private _free_string;
+    /**
+     * Converts a WASM-allocated string to JavaScript string and frees the WASM memory.
+     * @param ptr - Pointer to WASM string
+     * @returns JavaScript string
+     */
+    private _string_from_wasm;
+    /**
+     * Optimizes and resolves an SVG with JavaScript-friendly interface.
+     * Resolves CSS styles from `<style>` tags and inlines them as element attributes.
+     *
+     * @param svg - Input SVG string
+     * @returns Promise resolving to SvgOptimizeResponse
+     */
+    optimize(svg: string): svg.SVGOptimizeResponse;
+    pack(svg: string): svg.SVGPackResponse;
+}
+
 interface CreateImageResourceResult {
     hash: string;
     url: string;
@@ -283,6 +502,7 @@ declare class Scene {
     private appptr;
     private module;
     readonly fontskit: FontsAPI;
+    readonly svgkit: SVGAPI;
     constructor(module: createGridaCanvas.GridaCanvasWasmBindings, ptr: number);
     /**
      * Allocates memory for a string and returns pointer and length.
@@ -348,8 +568,8 @@ declare class Scene {
     setMainCameraTransform(transform: types.Transform2D): void;
     getNodeIdFromPoint(x: number, y: number): string | null;
     getNodeIdsFromPoint(x: number, y: number): string[];
-    getNodeIdsFromEnvelope(envelope: types.Rectangle): string[];
-    getNodeAbsoluteBoundingBox(id: string): types.Rectangle | null;
+    getNodeIdsFromEnvelope(envelope: types.Rect): string[];
+    getNodeAbsoluteBoundingBox(id: string): types.Rect | null;
     /**
      * Convert a node into a vector network representation.
      * Supports primitive shapes and text nodes.
@@ -429,7 +649,7 @@ declare namespace types {
             number
         ]
     ];
-    type Rectangle = {
+    type Rect = {
         x: number;
         y: number;
         width: number;
@@ -480,4 +700,4 @@ declare class ApplicationFactory {
     createWebGLCanvasSurfaceById(htmlcanvasid: string): Scene;
 }
 
-export { ApplicationFactory, type GridaCanvasModuleInitOptions, Scene, init as default, types, version };
+export { ApplicationFactory, type GridaCanvasModuleInitOptions, Scene, init as default, svgtypes, types, version };

package/dist/index.d.ts

@@ -193,6 +193,192 @@ declare namespace fonts {
   }
 }
 
+declare namespace svgtypes {
+  // ====================================================================================================
+  // #region: Core Type Definitions
+  // ====================================================================================================
+
+  /**
+   * rust/serde Option<T> equivalant
+   */
+  type TOption<T> = T | null;
+  type RGBA8888 = [r: number, g: number, b: number, a: number];
+  type Transform2D = [[number, number, number], [number, number, number]];
+  type StrokeCap = "butt" | "round" | "square";
+  type StrokeJoin = "miter" | "round" | "bevel";
+  type FillRule = "nonzero" | "evenodd";
+  type BlendMode =
+    | "normal"
+    | "multiply"
+    | "screen"
+    | "overlay"
+    | "darken"
+    | "lighten"
+    | "color-dodge"
+    | "color-burn"
+    | "hard-light"
+    | "soft-light"
+    | "difference"
+    | "exclusion"
+    | "hue"
+    | "saturation"
+    | "color"
+    | "luminosity";
+
+  export enum SVGTextAnchor {
+    start = "start",
+    middle = "middle",
+    end = "end",
+  }
+
+  export enum SVGSpreadMethod {
+    pad = "pad",
+    reflect = "reflect",
+    repeat = "repeat",
+  }
+
+  export interface SVGSolidPaint {
+    kind: "solid";
+    color: RGBA8888;
+  }
+
+  export interface SVGGradientStop {
+    color: RGBA8888;
+    offset: number;
+    // opacity: number;
+  }
+
+  export interface SVGLinearGradientPaint {
+    kind: "linear-gradient";
+    id: string;
+    x1: number;
+    y1: number;
+    x2: number;
+    y2: number;
+    transform: Transform2D;
+    stops: Array<SVGGradientStop>;
+    spread_method: SVGSpreadMethod;
+  }
+
+  export interface SVGRadialGradientPaint {
+    kind: "radial-gradient";
+    id: string;
+    cx: number;
+    cy: number;
+    r: number;
+    fx: number;
+    fy: number;
+    transform: Transform2D;
+    stops: Array<SVGGradientStop>;
+    spread_method: SVGSpreadMethod;
+  }
+
+  export type SVGPaint =
+    | SVGSolidPaint
+    | SVGLinearGradientPaint
+    | SVGRadialGradientPaint;
+
+  export interface SVGFillAttributes {
+    paint: SVGPaint;
+    fill_opacity: number;
+    fill_rule: FillRule;
+  }
+
+  export interface SVGStrokeAttributes {
+    paint: SVGPaint;
+    stroke_width: TOption<number>;
+    stroke_linecap: StrokeCap;
+    stroke_linejoin: StrokeJoin;
+    stroke_miterlimit: number;
+    stroke_dasharray: TOption<Array<number>>;
+    stroke_opacity: number;
+  }
+
+  export namespace ir {
+    export interface IRSVGInitialContainerNode {
+      width: number;
+      height: number;
+      children: Array<IRSVGChildNode>;
+    }
+
+    export type IRSVGChildNode =
+      | IRSVGGroupNode
+      | IRSVGPathNode
+      | IRSVGTextNode
+      | IRSVGImageNode;
+
+    export interface IRSVGGroupNode {
+      kind: "group";
+      transform: Transform2D;
+      opacity: number;
+      blend_mode: BlendMode;
+      children: Array<IRSVGChildNode>;
+    }
+
+    export interface IRSVGPathNode {
+      kind: "path";
+      transform: Transform2D;
+      fill: TOption<SVGFillAttributes>;
+      stroke: TOption<SVGStrokeAttributes>;
+      d: string;
+    }
+
+    export interface IRSVGTextNode {
+      kind: "text";
+      transform: Transform2D;
+      text_content: string;
+      fill: TOption<SVGFillAttributes>;
+      stroke: TOption<SVGStrokeAttributes>;
+      spans: Array<IRSVGTextSpanNode>;
+    }
+
+    export interface IRSVGTextSpanNode {
+      transform: Transform2D;
+      text: string;
+      fill: TOption<SVGFillAttributes>;
+      stroke: TOption<SVGStrokeAttributes>;
+      font_size: TOption<number>;
+      anchor: SVGTextAnchor;
+    }
+
+    export interface IRSVGImageNode {
+      kind: "image";
+    }
+  }
+}
+
+declare namespace svg {
+  export type SVGOptimizeResponse = CAPIMethodResult<{
+    /** Optimized SVG string with CSS styles resolved and inlined */
+    svg_optimized: string;
+  }>;
+
+  export type SVGPackResponse = CAPIMethodResult<{
+    svg: svgtypes.ir.IRSVGInitialContainerNode;
+  }>;
+
+  // ====================================================================================================
+  // #region: WASM Function Declarations
+  // ====================================================================================================
+
+  export interface SVGModule {
+    // ====================================================================================================
+    // #region: High-Level SVG APIs
+    // ====================================================================================================
+
+    /**
+     * Optimizes and resolves an SVG, producing a flat, self-contained SVG output.
+     * Resolves CSS styles from `<style>` tags and inlines them as element attributes.
+     *
+     * @param svg - Pointer to input SVG string (null-terminated C string)
+     * @returns Pointer to JSON string containing {@link svgtypes.SvgOptimizeResponse}
+     */
+    _grida_svg_optimize(svg: CPtr): CPtr;
+
+    _grida_svg_pack(sgv: CPtr): CPtr;
+  }
+}
+
 ///
 /// @grida/canvas-wasm grida-canvas-wasm.js typescript definitions
 /// this is NOT generated by emscripten. update manually.
@@ -211,7 +397,8 @@ declare namespace createGridaCanvas$1 {
   interface GridaCanvasWasmBindings
     extends emscripten.emscripten_EXPORTED_RUNTIME_METHODS,
       canvas.CanvasModule,
-      fonts.FontsModule {}
+      fonts.FontsModule,
+      svg.SVGModule {}
 }
 
 declare class FontsAPI {
@@ -266,6 +453,38 @@ declare class FontsAPI {
     parseFont(fontData: ArrayBuffer | Uint8Array, faceId: string, userFontStyleItalic?: boolean): Promise<fonts.types.FaceRecord>;
 }
 
+declare class SVGAPI {
+    private module;
+    constructor(module: any);
+    /**
+     * Allocates memory for a string and returns pointer and length.
+     * @param txt - String to allocate
+     * @returns [pointer, length] tuple
+     */
+    private _alloc_string;
+    /**
+     * Frees memory allocated for a string.
+     * @param ptr - Pointer to free
+     * @param len - Length of allocated memory
+     */
+    private _free_string;
+    /**
+     * Converts a WASM-allocated string to JavaScript string and frees the WASM memory.
+     * @param ptr - Pointer to WASM string
+     * @returns JavaScript string
+     */
+    private _string_from_wasm;
+    /**
+     * Optimizes and resolves an SVG with JavaScript-friendly interface.
+     * Resolves CSS styles from `<style>` tags and inlines them as element attributes.
+     *
+     * @param svg - Input SVG string
+     * @returns Promise resolving to SvgOptimizeResponse
+     */
+    optimize(svg: string): svg.SVGOptimizeResponse;
+    pack(svg: string): svg.SVGPackResponse;
+}
+
 interface CreateImageResourceResult {
     hash: string;
     url: string;
@@ -283,6 +502,7 @@ declare class Scene {
     private appptr;
     private module;
     readonly fontskit: FontsAPI;
+    readonly svgkit: SVGAPI;
     constructor(module: createGridaCanvas.GridaCanvasWasmBindings, ptr: number);
     /**
      * Allocates memory for a string and returns pointer and length.
@@ -348,8 +568,8 @@ declare class Scene {
     setMainCameraTransform(transform: types.Transform2D): void;
     getNodeIdFromPoint(x: number, y: number): string | null;
     getNodeIdsFromPoint(x: number, y: number): string[];
-    getNodeIdsFromEnvelope(envelope: types.Rectangle): string[];
-    getNodeAbsoluteBoundingBox(id: string): types.Rectangle | null;
+    getNodeIdsFromEnvelope(envelope: types.Rect): string[];
+    getNodeAbsoluteBoundingBox(id: string): types.Rect | null;
     /**
      * Convert a node into a vector network representation.
      * Supports primitive shapes and text nodes.
@@ -429,7 +649,7 @@ declare namespace types {
             number
         ]
     ];
-    type Rectangle = {
+    type Rect = {
         x: number;
         y: number;
         width: number;
@@ -480,4 +700,4 @@ declare class ApplicationFactory {
     createWebGLCanvasSurfaceById(htmlcanvasid: string): Scene;
 }
 
-export { ApplicationFactory, type GridaCanvasModuleInitOptions, Scene, init as default, types, version };
+export { ApplicationFactory, type GridaCanvasModuleInitOptions, Scene, init as default, svgtypes, types, version };