@gtkx/ffi 0.4.1 → 0.5.0

package/dist/generated/gsk/blend-node.js

@@ -3,25 +3,30 @@ import { RenderNode } from "./render-node.js";
 /** A render node applying a blending function between its two child nodes. */
 export class BlendNode extends RenderNode {
     static glibTypeName = "GskBlendNode";
-    constructor(...args) {
-        super(...args);
-    }
-    createPtr(args) {
-        const [bottom, top, blendMode] = args;
-        return call("libgtk-4.so.1", "gsk_blend_node_new", [
-            {
-                type: { type: "gobject", borrowed: true },
-                value: bottom?.id ?? bottom,
-            },
-            {
-                type: { type: "gobject", borrowed: true },
-                value: top?.id ?? top,
-            },
-            {
-                type: { type: "int", size: 32, unsigned: false },
-                value: blendMode,
-            },
-        ], { type: "gobject", borrowed: false });
+    /**
+     * Creates a `GskRenderNode` that will use `blend_mode` to blend the `top` node onto the `bottom` node.
+     * @param bottom - The bottom node to be drawn
+     * @param top - The node to be blended onto the `bottom` node
+     * @param blendMode - The blend mode to use
+     */
+    constructor(bottom, top, blendMode) {
+        super();
+        if (bottom !== undefined) {
+            this.id = call("libgtk-4.so.1", "gsk_blend_node_new", [
+                {
+                    type: { type: "gobject", borrowed: true },
+                    value: bottom?.id ?? bottom,
+                },
+                {
+                    type: { type: "gobject", borrowed: true },
+                    value: top?.id ?? top,
+                },
+                {
+                    type: { type: "int", size: 32, unsigned: false },
+                    value: blendMode,
+                },
+            ], { type: "gobject", borrowed: false });
+        }
     }
     /**
      * Retrieves the blend mode used by @node.

package/dist/generated/gsk/blur-node.d.ts

@@ -7,9 +7,7 @@ export declare class BlurNode extends RenderNode {
      * @param child - the child node to blur
      * @param radius - the blur radius. Must be positive
      */
-    constructor(child: RenderNode, radius: number);
-    constructor(...args: unknown[]);
-    protected createPtr(args: unknown[]): unknown;
+    constructor(child?: RenderNode | null, radius?: number | null);
     /**
      * Retrieves the child `GskRenderNode` of the blur @node.
      */

package/dist/generated/gsk/blur-node.js

@@ -3,21 +3,25 @@ import { RenderNode } from "./render-node.js";
 /** A render node applying a blur effect to its single child. */
 export class BlurNode extends RenderNode {
     static glibTypeName = "GskBlurNode";
-    constructor(...args) {
-        super(...args);
-    }
-    createPtr(args) {
-        const [child, radius] = args;
-        return call("libgtk-4.so.1", "gsk_blur_node_new", [
-            {
-                type: { type: "gobject", borrowed: true },
-                value: child?.id ?? child,
-            },
-            {
-                type: { type: "float", size: 32 },
-                value: radius,
-            },
-        ], { type: "gobject", borrowed: false });
+    /**
+     * Creates a render node that blurs the child.
+     * @param child - the child node to blur
+     * @param radius - the blur radius. Must be positive
+     */
+    constructor(child, radius) {
+        super();
+        if (child !== undefined) {
+            this.id = call("libgtk-4.so.1", "gsk_blur_node_new", [
+                {
+                    type: { type: "gobject", borrowed: true },
+                    value: child?.id ?? child,
+                },
+                {
+                    type: { type: "float", size: 32 },
+                    value: radius,
+                },
+            ], { type: "gobject", borrowed: false });
+        }
     }
     /**
      * Retrieves the child `GskRenderNode` of the blur @node.

package/dist/generated/gsk/border-node.d.ts

@@ -12,9 +12,7 @@ export declare class BorderNode extends RenderNode {
      * @param borderWidth - the stroke width of the border on
      * @param borderColor - the color used on the top, right,
      */
-    constructor(outline: number, borderWidth: number[], borderColor: Gdk.RGBA[]);
-    constructor(...args: unknown[]);
-    protected createPtr(args: unknown[]): unknown;
+    constructor(outline?: number | null, borderWidth?: number[] | null, borderColor?: Gdk.RGBA[] | null);
     /**
      * Retrieves the colors of the border.
      */

package/dist/generated/gsk/border-node.js

@@ -3,32 +3,40 @@ import { RenderNode } from "./render-node.js";
 /** A render node for a border. */
 export class BorderNode extends RenderNode {
     static glibTypeName = "GskBorderNode";
-    constructor(...args) {
-        super(...args);
-    }
-    createPtr(args) {
-        const [outline, borderWidth, borderColor] = args;
-        return call("libgtk-4.so.1", "gsk_border_node_new", [
-            {
-                type: { type: "int", size: 64, unsigned: true },
-                value: outline,
-            },
-            {
-                type: { type: "array", itemType: { type: "float", size: 32 } },
-                value: borderWidth,
-            },
-            {
-                type: {
-                    type: "array",
-                    itemType: {
-                        type: "boxed",
-                        innerType: "GdkRGBA",
-                        lib: "libgtk-4.so.1",
+    /**
+     * Creates a `GskRenderNode` that will stroke a border rectangle inside the
+     * given @outline.
+     *
+     * The 4 sides of the border can have different widths and colors.
+     * @param outline - a `GskRoundedRect` describing the outline of the border
+     * @param borderWidth - the stroke width of the border on
+     * @param borderColor - the color used on the top, right,
+     */
+    constructor(outline, borderWidth, borderColor) {
+        super();
+        if (outline !== undefined) {
+            this.id = call("libgtk-4.so.1", "gsk_border_node_new", [
+                {
+                    type: { type: "int", size: 64, unsigned: true },
+                    value: outline,
+                },
+                {
+                    type: { type: "array", itemType: { type: "float", size: 32 } },
+                    value: borderWidth,
+                },
+                {
+                    type: {
+                        type: "array",
+                        itemType: {
+                            type: "boxed",
+                            innerType: "GdkRGBA",
+                            lib: "libgtk-4.so.1",
+                        },
                     },
+                    value: borderColor,
                 },
-                value: borderColor,
-            },
-        ], { type: "gobject", borrowed: false });
+            ], { type: "gobject", borrowed: false });
+        }
     }
     /**
      * Retrieves the colors of the border.

package/dist/generated/gsk/broadway-renderer.d.ts

@@ -17,8 +17,7 @@ export declare class BroadwayRenderer extends Renderer {
      * This function is only available when GTK was compiled with Broadway
      * support.
      */
-    constructor(...args: unknown[]);
-    protected createPtr(_args: unknown[]): unknown;
+    constructor();
     connect(signal: "notify", handler: (self: BroadwayRenderer, pspec: GObject.ParamSpec) => void, after?: boolean): number;
     connect(signal: string, handler: (...args: any[]) => any, after?: boolean): number;
 }

package/dist/generated/gsk/broadway-renderer.js

@@ -17,11 +17,9 @@ export class BroadwayRenderer extends Renderer {
      * This function is only available when GTK was compiled with Broadway
      * support.
      */
-    constructor(...args) {
-        super(...args);
-    }
-    createPtr(_args) {
-        return call("libgtk-4.so.1", "gsk_broadway_renderer_new", [], {
+    constructor() {
+        super();
+        this.id = call("libgtk-4.so.1", "gsk_broadway_renderer_new", [], {
             type: "gobject",
             borrowed: false,
         });

package/dist/generated/gsk/cairo-node.d.ts

@@ -11,9 +11,7 @@ export declare class CairoNode extends RenderNode {
      * You can draw to the cairo surface using [method@Gsk.CairoNode.get_draw_context].
      * @param bounds - the rectangle to render to
      */
-    constructor(bounds: Graphene.Rect);
-    constructor(...args: unknown[]);
-    protected createPtr(args: unknown[]): unknown;
+    constructor(bounds?: Graphene.Rect | null);
     /**
      * Creates a Cairo context for drawing using the surface associated
      * to the render node.

package/dist/generated/gsk/cairo-node.js

@@ -3,22 +3,28 @@ import { RenderNode } from "./render-node.js";
 /** A render node for a Cairo surface. */
 export class CairoNode extends RenderNode {
     static glibTypeName = "GskCairoNode";
-    constructor(...args) {
-        super(...args);
-    }
-    createPtr(args) {
-        const [bounds] = args;
-        return call("libgtk-4.so.1", "gsk_cairo_node_new", [
-            {
-                type: {
-                    type: "boxed",
-                    borrowed: true,
-                    innerType: "GrapheneRect",
-                    lib: "libgtk-4.so.1",
+    /**
+     * Creates a `GskRenderNode` that will render a cairo surface
+     * into the area given by @bounds.
+     *
+     * You can draw to the cairo surface using [method@Gsk.CairoNode.get_draw_context].
+     * @param bounds - the rectangle to render to
+     */
+    constructor(bounds) {
+        super();
+        if (bounds !== undefined) {
+            this.id = call("libgtk-4.so.1", "gsk_cairo_node_new", [
+                {
+                    type: {
+                        type: "boxed",
+                        borrowed: true,
+                        innerType: "GrapheneRect",
+                        lib: "libgtk-4.so.1",
+                    },
+                    value: bounds?.id ?? bounds,
                 },
-                value: bounds?.id ?? bounds,
-            },
-        ], { type: "gobject", borrowed: false });
+            ], { type: "gobject", borrowed: false });
+        }
     }
     /**
      * Creates a Cairo context for drawing using the surface associated

package/dist/generated/gsk/cairo-renderer.d.ts

@@ -18,8 +18,7 @@ export declare class CairoRenderer extends Renderer {
      * content and will instead render an error marker. Its usage should be
      * avoided.
      */
-    constructor(...args: unknown[]);
-    protected createPtr(_args: unknown[]): unknown;
+    constructor();
     connect(signal: "notify", handler: (self: CairoRenderer, pspec: GObject.ParamSpec) => void, after?: boolean): number;
     connect(signal: string, handler: (...args: any[]) => any, after?: boolean): number;
 }

package/dist/generated/gsk/cairo-renderer.js

@@ -18,11 +18,9 @@ export class CairoRenderer extends Renderer {
      * content and will instead render an error marker. Its usage should be
      * avoided.
      */
-    constructor(...args) {
-        super(...args);
-    }
-    createPtr(_args) {
-        return call("libgtk-4.so.1", "gsk_cairo_renderer_new", [], {
+    constructor() {
+        super();
+        this.id = call("libgtk-4.so.1", "gsk_cairo_renderer_new", [], {
             type: "gobject",
             borrowed: false,
         });

package/dist/generated/gsk/clip-node.d.ts

@@ -9,9 +9,7 @@ export declare class ClipNode extends RenderNode {
      * @param child - The node to draw
      * @param clip - The clip to apply
      */
-    constructor(child: RenderNode, clip: Graphene.Rect);
-    constructor(...args: unknown[]);
-    protected createPtr(args: unknown[]): unknown;
+    constructor(child?: RenderNode | null, clip?: Graphene.Rect | null);
     /**
      * Gets the child node that is getting clipped by the given @node.
      */

package/dist/generated/gsk/clip-node.js

@@ -3,26 +3,31 @@ import { RenderNode } from "./render-node.js";
 /** A render node applying a rectangular clip to its single child node. */
 export class ClipNode extends RenderNode {
     static glibTypeName = "GskClipNode";
-    constructor(...args) {
-        super(...args);
-    }
-    createPtr(args) {
-        const [child, clip] = args;
-        return call("libgtk-4.so.1", "gsk_clip_node_new", [
-            {
-                type: { type: "gobject", borrowed: true },
-                value: child?.id ?? child,
-            },
-            {
-                type: {
-                    type: "boxed",
-                    borrowed: true,
-                    innerType: "GrapheneRect",
-                    lib: "libgtk-4.so.1",
+    /**
+     * Creates a `GskRenderNode` that will clip the `child` to the area
+     * given by @clip.
+     * @param child - The node to draw
+     * @param clip - The clip to apply
+     */
+    constructor(child, clip) {
+        super();
+        if (child !== undefined) {
+            this.id = call("libgtk-4.so.1", "gsk_clip_node_new", [
+                {
+                    type: { type: "gobject", borrowed: true },
+                    value: child?.id ?? child,
                 },
-                value: clip?.id ?? clip,
-            },
-        ], { type: "gobject", borrowed: false });
+                {
+                    type: {
+                        type: "boxed",
+                        borrowed: true,
+                        innerType: "GrapheneRect",
+                        lib: "libgtk-4.so.1",
+                    },
+                    value: clip?.id ?? clip,
+                },
+            ], { type: "gobject", borrowed: false });
+        }
     }
     /**
      * Gets the child node that is getting clipped by the given @node.

package/dist/generated/gsk/color-matrix-node.d.ts

@@ -17,9 +17,7 @@ export declare class ColorMatrixNode extends RenderNode {
      * @param colorMatrix - The matrix to apply
      * @param colorOffset - Values to add to the color
      */
-    constructor(child: RenderNode, colorMatrix: Graphene.Matrix, colorOffset: Graphene.Vec4);
-    constructor(...args: unknown[]);
-    protected createPtr(args: unknown[]): unknown;
+    constructor(child?: RenderNode | null, colorMatrix?: Graphene.Matrix | null, colorOffset?: Graphene.Vec4 | null);
     /**
      * Gets the child node that is getting its colors modified by the given @node.
      */

package/dist/generated/gsk/color-matrix-node.js

@@ -3,35 +3,48 @@ import { RenderNode } from "./render-node.js";
 /** A render node controlling the color matrix of its single child node. */
 export class ColorMatrixNode extends RenderNode {
     static glibTypeName = "GskColorMatrixNode";
-    constructor(...args) {
-        super(...args);
-    }
-    createPtr(args) {
-        const [child, colorMatrix, colorOffset] = args;
-        return call("libgtk-4.so.1", "gsk_color_matrix_node_new", [
-            {
-                type: { type: "gobject", borrowed: true },
-                value: child?.id ?? child,
-            },
-            {
-                type: {
-                    type: "boxed",
-                    borrowed: true,
-                    innerType: "GrapheneMatrix",
-                    lib: "libgtk-4.so.1",
+    /**
+     * Creates a `GskRenderNode` that will drawn the `child` with
+     * @color_matrix.
+     *
+     * In particular, the node will transform colors by applying
+     *
+     * pixel = transpose(color_matrix) * pixel + color_offset
+     *
+     * for every pixel. The transformation operates on unpremultiplied
+     * colors, with color components ordered R, G, B, A.
+     * @param child - The node to draw
+     * @param colorMatrix - The matrix to apply
+     * @param colorOffset - Values to add to the color
+     */
+    constructor(child, colorMatrix, colorOffset) {
+        super();
+        if (child !== undefined) {
+            this.id = call("libgtk-4.so.1", "gsk_color_matrix_node_new", [
+                {
+                    type: { type: "gobject", borrowed: true },
+                    value: child?.id ?? child,
                 },
-                value: colorMatrix?.id ?? colorMatrix,
-            },
-            {
-                type: {
-                    type: "boxed",
-                    borrowed: true,
-                    innerType: "GrapheneVec4",
-                    lib: "libgtk-4.so.1",
+                {
+                    type: {
+                        type: "boxed",
+                        borrowed: true,
+                        innerType: "GrapheneMatrix",
+                        lib: "libgtk-4.so.1",
+                    },
+                    value: colorMatrix?.id ?? colorMatrix,
                 },
-                value: colorOffset?.id ?? colorOffset,
-            },
-        ], { type: "gobject", borrowed: false });
+                {
+                    type: {
+                        type: "boxed",
+                        borrowed: true,
+                        innerType: "GrapheneVec4",
+                        lib: "libgtk-4.so.1",
+                    },
+                    value: colorOffset?.id ?? colorOffset,
+                },
+            ], { type: "gobject", borrowed: false });
+        }
     }
     /**
      * Gets the child node that is getting its colors modified by the given @node.

package/dist/generated/gsk/color-node.d.ts

@@ -10,9 +10,7 @@ export declare class ColorNode extends RenderNode {
      * @param rgba - a `GdkRGBA` specifying a color
      * @param bounds - the rectangle to render the color into
      */
-    constructor(rgba: Gdk.RGBA, bounds: Graphene.Rect);
-    constructor(...args: unknown[]);
-    protected createPtr(args: unknown[]): unknown;
+    constructor(rgba?: Gdk.RGBA | null, bounds?: Graphene.Rect | null);
     /**
      * Retrieves the color of the given @node.
      *

package/dist/generated/gsk/color-node.js

@@ -3,31 +3,36 @@ import { RenderNode } from "./render-node.js";
 /** A render node for a solid color. */
 export class ColorNode extends RenderNode {
     static glibTypeName = "GskColorNode";
-    constructor(...args) {
-        super(...args);
-    }
-    createPtr(args) {
-        const [rgba, bounds] = args;
-        return call("libgtk-4.so.1", "gsk_color_node_new", [
-            {
-                type: {
-                    type: "boxed",
-                    borrowed: true,
-                    innerType: "GdkRGBA",
-                    lib: "libgtk-4.so.1",
+    /**
+     * Creates a `GskRenderNode` that will render the color specified by `rgba` into
+     * the area given by @bounds.
+     * @param rgba - a `GdkRGBA` specifying a color
+     * @param bounds - the rectangle to render the color into
+     */
+    constructor(rgba, bounds) {
+        super();
+        if (rgba !== undefined) {
+            this.id = call("libgtk-4.so.1", "gsk_color_node_new", [
+                {
+                    type: {
+                        type: "boxed",
+                        borrowed: true,
+                        innerType: "GdkRGBA",
+                        lib: "libgtk-4.so.1",
+                    },
+                    value: rgba?.id ?? rgba,
                 },
-                value: rgba?.id ?? rgba,
-            },
-            {
-                type: {
-                    type: "boxed",
-                    borrowed: true,
-                    innerType: "GrapheneRect",
-                    lib: "libgtk-4.so.1",
+                {
+                    type: {
+                        type: "boxed",
+                        borrowed: true,
+                        innerType: "GrapheneRect",
+                        lib: "libgtk-4.so.1",
+                    },
+                    value: bounds?.id ?? bounds,
                 },
-                value: bounds?.id ?? bounds,
-            },
-        ], { type: "gobject", borrowed: false });
+            ], { type: "gobject", borrowed: false });
+        }
     }
     /**
      * Retrieves the color of the given @node.

package/dist/generated/gsk/component-transfer-node.d.ts

@@ -11,9 +11,7 @@ export declare class ComponentTransferNode extends RenderNode {
      * @param b - transfer for the blue component
      * @param a - transfer for the alpha component
      */
-    constructor(child: RenderNode, r: ComponentTransfer, g: ComponentTransfer, b: ComponentTransfer, a: ComponentTransfer);
-    constructor(...args: unknown[]);
-    protected createPtr(args: unknown[]): unknown;
+    constructor(child?: RenderNode | null, r?: ComponentTransfer | null, g?: ComponentTransfer | null, b?: ComponentTransfer | null, a?: ComponentTransfer | null);
     /**
      * Gets the child node that is getting drawn by the given @node.
      */

package/dist/generated/gsk/component-transfer-node.js

@@ -2,53 +2,61 @@ import { call, getObject, registerType } from "@gtkx/ffi";
 import { RenderNode } from "./render-node.js";
 export class ComponentTransferNode extends RenderNode {
     static glibTypeName = "GskComponentTransferNode";
-    constructor(...args) {
-        super(...args);
-    }
-    createPtr(args) {
-        const [child, r, g, b, a] = args;
-        return call("libgtk-4.so.1", "gsk_component_transfer_node_new", [
-            {
-                type: { type: "gobject", borrowed: true },
-                value: child?.id ?? child,
-            },
-            {
-                type: {
-                    type: "boxed",
-                    borrowed: true,
-                    innerType: "GskComponentTransfer",
-                    lib: "libgtk-4.so.1",
+    /**
+     * Creates a render node that will apply component
+     * transfers to a child node.
+     * @param child - The child to apply component transfers to
+     * @param r - transfer for the red component
+     * @param g - transfer for the green component
+     * @param b - transfer for the blue component
+     * @param a - transfer for the alpha component
+     */
+    constructor(child, r, g, b, a) {
+        super();
+        if (child !== undefined) {
+            this.id = call("libgtk-4.so.1", "gsk_component_transfer_node_new", [
+                {
+                    type: { type: "gobject", borrowed: true },
+                    value: child?.id ?? child,
                 },
-                value: r?.id ?? r,
-            },
-            {
-                type: {
-                    type: "boxed",
-                    borrowed: true,
-                    innerType: "GskComponentTransfer",
-                    lib: "libgtk-4.so.1",
+                {
+                    type: {
+                        type: "boxed",
+                        borrowed: true,
+                        innerType: "GskComponentTransfer",
+                        lib: "libgtk-4.so.1",
+                    },
+                    value: r?.id ?? r,
                 },
-                value: g?.id ?? g,
-            },
-            {
-                type: {
-                    type: "boxed",
-                    borrowed: true,
-                    innerType: "GskComponentTransfer",
-                    lib: "libgtk-4.so.1",
+                {
+                    type: {
+                        type: "boxed",
+                        borrowed: true,
+                        innerType: "GskComponentTransfer",
+                        lib: "libgtk-4.so.1",
+                    },
+                    value: g?.id ?? g,
                 },
-                value: b?.id ?? b,
-            },
-            {
-                type: {
-                    type: "boxed",
-                    borrowed: true,
-                    innerType: "GskComponentTransfer",
-                    lib: "libgtk-4.so.1",
+                {
+                    type: {
+                        type: "boxed",
+                        borrowed: true,
+                        innerType: "GskComponentTransfer",
+                        lib: "libgtk-4.so.1",
+                    },
+                    value: b?.id ?? b,
                 },
-                value: a?.id ?? a,
-            },
-        ], { type: "gobject", borrowed: false });
+                {
+                    type: {
+                        type: "boxed",
+                        borrowed: true,
+                        innerType: "GskComponentTransfer",
+                        lib: "libgtk-4.so.1",
+                    },
+                    value: a?.id ?? a,
+                },
+            ], { type: "gobject", borrowed: false });
+        }
     }
     /**
      * Gets the child node that is getting drawn by the given @node.