deskforge 1.0.0

package/examples/deskforge-app/dist/packages/core/src/tree/tree.js

@@ -0,0 +1,43 @@
+"use strict";
+// tree.ts
+// Manages the full component tree.
+// A tree has a root node and a count of all nodes inside it.
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.createTree = createTree;
+exports.walkTree = walkTree;
+exports.findNode = findNode;
+// Counts all nodes recursively including deeply nested ones
+function countNodes(node) {
+    return (1 +
+        node.children.reduce((total, child) => total + countNodes(child), 0));
+}
+// Creates a tree from a root node
+// Automatically counts all nodes inside it
+function createTree(root) {
+    return {
+        root,
+        nodeCount: countNodes(root)
+    };
+}
+// Visits every node in the tree depth first
+// Calls visitor function on each node
+function walkTree(tree, visitor) {
+    // Inner recursive function
+    function walk(node) {
+        visitor(node);
+        node.children.forEach(child => walk(child));
+    }
+    walk(tree.root);
+}
+// Finds a node by its id
+// Returns the node if found or null if not found
+function findNode(tree, id) {
+    let result = null;
+    walkTree(tree, (node) => {
+        if (node.id === id) {
+            result = node;
+        }
+    });
+    return result;
+}
+//# sourceMappingURL=tree.js.map

package/examples/deskforge-app/dist/packages/core/src/tree/tree.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"tree.js","sourceRoot":"","sources":["../../../../../../../packages/core/src/tree/tree.ts"],"names":[],"mappings":";AAAA,UAAU;AACV,mCAAmC;AACnC,6DAA6D;;AA6DpD,gCAAU;AAAE,4BAAQ;AAAE,4BAAQ;AAnDvC,4DAA4D;AAC5D,SAAS,UAAU,CAAC,IAAY;IAC9B,OAAO,CACL,CAAC;QACD,IAAI,CAAC,QAAQ,CAAC,MAAM,CAClB,CAAC,KAAK,EAAE,KAAK,EAAE,EAAE,CAAC,KAAK,GAAG,UAAU,CAAC,KAAK,CAAC,EAAE,CAAC,CAC/C,CACF,CAAA;AACH,CAAC;AAED,kCAAkC;AAClC,2CAA2C;AAC3C,SAAS,UAAU,CAAC,IAAY;IAC9B,OAAO;QACL,IAAI;QACJ,SAAS,EAAE,UAAU,CAAC,IAAI,CAAC;KAC5B,CAAA;AACH,CAAC;AAED,4CAA4C;AAC5C,sCAAsC;AACtC,SAAS,QAAQ,CACf,IAAe,EACf,OAA+B;IAE/B,2BAA2B;IAC3B,SAAS,IAAI,CAAC,IAAY;QACxB,OAAO,CAAC,IAAI,CAAC,CAAA;QACb,IAAI,CAAC,QAAQ,CAAC,OAAO,CAAC,KAAK,CAAC,EAAE,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC,CAAA;IAC7C,CAAC;IACD,IAAI,CAAC,IAAI,CAAC,IAAI,CAAC,CAAA;AACjB,CAAC;AAED,yBAAyB;AACzB,iDAAiD;AACjD,SAAS,QAAQ,CACf,IAAY,EACZ,EAAY;IAEZ,IAAI,MAAM,GAAkB,IAAI,CAAA;IAEhC,QAAQ,CAAC,IAAI,EAAE,CAAC,IAAI,EAAE,EAAE;QACtB,IAAI,IAAI,CAAC,EAAE,KAAK,EAAE,EAAE,CAAC;YACnB,MAAM,GAAG,IAAI,CAAA;QACf,CAAC;IACH,CAAC,CAAC,CAAA;IAEF,OAAO,MAAM,CAAA;AACf,CAAC"}

package/examples/deskforge-app/dist/packages/renderer/src/canvas.d.ts

@@ -0,0 +1,23 @@
+import { Canvas as SkiaCanvas } from 'skia-canvas';
+/**
+ * Canvas wraps skia-canvas and provides DeskForge-specific methods
+ */
+interface Canvas {
+    skiaCanvas: InstanceType<typeof SkiaCanvas>;
+    width: number;
+    height: number;
+    getContext(): ReturnType<InstanceType<typeof SkiaCanvas>['getContext']>;
+    toBuffer(type?: 'png' | 'jpeg'): Promise<Buffer>;
+    toDataURL(type?: 'png' | 'jpeg'): Promise<string>;
+    saveAs(path: string, type?: 'png' | 'jpeg'): Promise<void>;
+}
+/**
+ * Creates a new Canvas instance
+ */
+declare function createCanvas(width: number, height: number): Canvas;
+/**
+ * Creates a canvas with a specific device pixel ratio
+ */
+declare function createCanvasWithDPR(width: number, height: number, dpr?: number): Canvas;
+export type { Canvas };
+export { createCanvas, createCanvasWithDPR };

package/examples/deskforge-app/dist/packages/renderer/src/canvas.js

@@ -0,0 +1,38 @@
+"use strict";
+// canvas.ts
+// Canvas abstraction — wraps skia-canvas for the framework
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.createCanvas = createCanvas;
+exports.createCanvasWithDPR = createCanvasWithDPR;
+const skia_canvas_1 = require("skia-canvas");
+/**
+ * Creates a new Canvas instance
+ */
+function createCanvas(width, height) {
+    const skiaCanvas = new skia_canvas_1.Canvas(width, height);
+    return {
+        skiaCanvas,
+        width,
+        height,
+        getContext() {
+            return skiaCanvas.getContext('2d');
+        },
+        toBuffer(type = 'png') {
+            return skiaCanvas.toBuffer(type);
+        },
+        async toDataURL(type = 'png') {
+            return skiaCanvas.toURL(type);
+        },
+        async saveAs(path, type = 'png') {
+            return skiaCanvas.toFile(path, { format: type });
+        }
+    };
+}
+/**
+ * Creates a canvas with a specific device pixel ratio
+ */
+function createCanvasWithDPR(width, height, dpr = 1) {
+    const canvas = createCanvas(width * dpr, height * dpr);
+    return canvas;
+}
+//# sourceMappingURL=canvas.js.map

package/examples/deskforge-app/dist/packages/renderer/src/canvas.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"canvas.js","sourceRoot":"","sources":["../../../../../../packages/renderer/src/canvas.ts"],"names":[],"mappings":";AAAA,YAAY;AACZ,2DAA2D;;AAoElD,oCAAY;AAAE,kDAAmB;AAlE1C,6CAAkD;AAwBlD;;GAEG;AACH,SAAS,YAAY,CAAC,KAAa,EAAE,MAAc;IACjD,MAAM,UAAU,GAAG,IAAI,oBAAU,CAAC,KAAK,EAAE,MAAM,CAAC,CAAA;IAEhD,OAAO;QACL,UAAU;QACV,KAAK;QACL,MAAM;QAEN,UAAU;YACR,OAAO,UAAU,CAAC,UAAU,CAAC,IAAI,CAAC,CAAA;QACpC,CAAC;QAED,QAAQ,CAAC,OAAuB,KAAK;YACnC,OAAO,UAAU,CAAC,QAAQ,CAAC,IAAI,CAAC,CAAA;QAClC,CAAC;QAED,KAAK,CAAC,SAAS,CAAC,OAAuB,KAAK;YAC1C,OAAO,UAAU,CAAC,KAAK,CAAC,IAAI,CAAC,CAAA;QAC/B,CAAC;QAED,KAAK,CAAC,MAAM,CAAC,IAAY,EAAE,OAAuB,KAAK;YACrD,OAAO,UAAU,CAAC,MAAM,CAAC,IAAI,EAAE,EAAE,MAAM,EAAE,IAAI,EAAE,CAAC,CAAA;QAClD,CAAC;KACF,CAAA;AACH,CAAC;AAED;;GAEG;AACH,SAAS,mBAAmB,CAC1B,KAAa,EACb,MAAc,EACd,MAAc,CAAC;IAEf,MAAM,MAAM,GAAG,YAAY,CAAC,KAAK,GAAG,GAAG,EAAE,MAAM,GAAG,GAAG,CAAC,CAAA;IACtD,OAAO,MAAM,CAAA;AACf,CAAC"}

package/examples/deskforge-app/dist/packages/renderer/src/context.d.ts

@@ -0,0 +1,33 @@
+import type { Canvas, CanvasRenderingContext2D } from 'skia-canvas';
+/**
+ * RenderContext wraps the skia-canvas 2D rendering context
+ * and provides additional state for rendering operations
+ */
+interface RenderContext {
+    ctx: CanvasRenderingContext2D;
+    canvas: Canvas;
+    state: {
+        fillColor: string;
+        strokeColor: string;
+        strokeWidth: number;
+        opacity: number;
+        font: string;
+        textAlign: 'left' | 'center' | 'right';
+        textBaseline: 'top' | 'middle' | 'bottom';
+    };
+    stateStack: RenderContext['state'][];
+}
+/**
+ * Creates a new render context from a skia-canvas context
+ */
+declare function createRenderContext(ctx: CanvasRenderingContext2D, canvas: Canvas): RenderContext;
+/**
+ * Save the current rendering state to the stack
+ */
+declare function pushState(context: RenderContext): void;
+/**
+ * Restore the previous rendering state from the stack
+ */
+declare function popState(context: RenderContext): void;
+export type { RenderContext };
+export { createRenderContext, pushState, popState };

package/examples/deskforge-app/dist/packages/renderer/src/context.js

@@ -0,0 +1,45 @@
+"use strict";
+// context.ts
+// Rendering context — wraps the skia-canvas drawing context
+// Provides a high-level API for rendering operations
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.createRenderContext = createRenderContext;
+exports.pushState = pushState;
+exports.popState = popState;
+/**
+ * Creates a new render context from a skia-canvas context
+ */
+function createRenderContext(ctx, canvas) {
+    return {
+        ctx,
+        canvas,
+        state: {
+            fillColor: '#000000',
+            strokeColor: '#000000',
+            strokeWidth: 1,
+            opacity: 1,
+            font: '12px sans-serif',
+            textAlign: 'left',
+            textBaseline: 'top'
+        },
+        stateStack: []
+    };
+}
+/**
+ * Save the current rendering state to the stack
+ */
+function pushState(context) {
+    context.stateStack.push({ ...context.state });
+    context.ctx.save();
+}
+/**
+ * Restore the previous rendering state from the stack
+ */
+function popState(context) {
+    const saved = context.stateStack.pop();
+    if (saved) {
+        context.state = saved;
+        context.ctx.restore();
+    }
+}
+//# sourceMappingURL=context.js.map

package/examples/deskforge-app/dist/packages/renderer/src/context.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"context.js","sourceRoot":"","sources":["../../../../../../packages/renderer/src/context.ts"],"names":[],"mappings":";AAAA,aAAa;AACb,4DAA4D;AAC5D,qDAAqD;;AAgF5C,kDAAmB;AAAE,8BAAS;AAAE,4BAAQ;AA3CjD;;GAEG;AACH,SAAS,mBAAmB,CAC1B,GAA6B,EAC7B,MAAc;IAEd,OAAO;QACL,GAAG;QACH,MAAM;QACN,KAAK,EAAE;YACL,SAAS,EAAE,SAAS;YACpB,WAAW,EAAE,SAAS;YACtB,WAAW,EAAE,CAAC;YACd,OAAO,EAAE,CAAC;YACV,IAAI,EAAE,iBAAiB;YACvB,SAAS,EAAE,MAAM;YACjB,YAAY,EAAE,KAAK;SACpB;QACD,UAAU,EAAE,EAAE;KACf,CAAA;AACH,CAAC;AAED;;GAEG;AACH,SAAS,SAAS,CAAC,OAAsB;IACvC,OAAO,CAAC,UAAU,CAAC,IAAI,CAAC,EAAE,GAAG,OAAO,CAAC,KAAK,EAAE,CAAC,CAAA;IAC7C,OAAO,CAAC,GAAG,CAAC,IAAI,EAAE,CAAA;AACpB,CAAC;AAED;;GAEG;AACH,SAAS,QAAQ,CAAC,OAAsB;IACtC,MAAM,KAAK,GAAG,OAAO,CAAC,UAAU,CAAC,GAAG,EAAE,CAAA;IACtC,IAAI,KAAK,EAAE,CAAC;QACV,OAAO,CAAC,KAAK,GAAG,KAAK,CAAA;QACrB,OAAO,CAAC,GAAG,CAAC,OAAO,EAAE,CAAA;IACvB,CAAC;AACH,CAAC"}

package/examples/deskforge-app/dist/packages/renderer/src/dirty-region.d.ts

@@ -0,0 +1,42 @@
+export interface Rect {
+    x: number;
+    y: number;
+    width: number;
+    height: number;
+}
+/**
+ * Tracks dirty regions that need re-rendering
+ */
+export declare class DirtyRegionTracker {
+    private regions;
+    private canvasWidth;
+    private canvasHeight;
+    constructor(width: number, height: number);
+    /**
+     * Mark a region as dirty
+     */
+    markDirty(rect: Rect): void;
+    /**
+     * Mark entire canvas as dirty
+     */
+    markAllDirty(): void;
+    /**
+     * Get merged dirty regions (optimized)
+     */
+    getDirtyRegions(): Rect[];
+    /**
+     * Clear all dirty regions
+     */
+    clear(): void;
+    /**
+     * Check if region needs rendering
+     */
+    isDirty(rect: Rect): boolean;
+    /**
+     * Resize tracker when canvas resizes
+     */
+    resize(width: number, height: number): void;
+    private clampRect;
+    private rectsIntersect;
+    private mergeRegions;
+}

package/examples/deskforge-app/dist/packages/renderer/src/dirty-region.js

@@ -0,0 +1,106 @@
+"use strict";
+// dirty-region.ts
+// Dirty region tracking for incremental rendering optimization
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.DirtyRegionTracker = void 0;
+/**
+ * Tracks dirty regions that need re-rendering
+ */
+class DirtyRegionTracker {
+    constructor(width, height) {
+        this.regions = [];
+        this.canvasWidth = width;
+        this.canvasHeight = height;
+    }
+    /**
+     * Mark a region as dirty
+     */
+    markDirty(rect) {
+        this.regions.push(this.clampRect(rect));
+    }
+    /**
+     * Mark entire canvas as dirty
+     */
+    markAllDirty() {
+        this.regions = [{
+                x: 0,
+                y: 0,
+                width: this.canvasWidth,
+                height: this.canvasHeight,
+            }];
+    }
+    /**
+     * Get merged dirty regions (optimized)
+     */
+    getDirtyRegions() {
+        if (this.regions.length === 0)
+            return [];
+        if (this.regions.length === 1)
+            return this.regions;
+        // Simple merging: if regions overlap significantly, merge them
+        return this.mergeRegions(this.regions);
+    }
+    /**
+     * Clear all dirty regions
+     */
+    clear() {
+        this.regions = [];
+    }
+    /**
+     * Check if region needs rendering
+     */
+    isDirty(rect) {
+        return this.regions.some(r => this.rectsIntersect(r, rect));
+    }
+    /**
+     * Resize tracker when canvas resizes
+     */
+    resize(width, height) {
+        this.canvasWidth = width;
+        this.canvasHeight = height;
+        this.markAllDirty();
+    }
+    // Private helpers
+    clampRect(rect) {
+        return {
+            x: Math.max(0, rect.x),
+            y: Math.max(0, rect.y),
+            width: Math.min(this.canvasWidth - rect.x, rect.width),
+            height: Math.min(this.canvasHeight - rect.y, rect.height),
+        };
+    }
+    rectsIntersect(r1, r2) {
+        return !(r1.x + r1.width < r2.x ||
+            r2.x + r2.width < r1.x ||
+            r1.y + r1.height < r2.y ||
+            r2.y + r2.height < r1.y);
+    }
+    mergeRegions(rects) {
+        if (rects.length <= 1)
+            return rects;
+        const sorted = [...rects].sort((a, b) => a.x - b.x);
+        const merged = [];
+        for (const rect of sorted) {
+            const last = merged[merged.length - 1];
+            if (last && this.rectsIntersect(last, rect)) {
+                // Merge by creating bounding box
+                const minX = Math.min(last.x, rect.x);
+                const minY = Math.min(last.y, rect.y);
+                const maxX = Math.max(last.x + last.width, rect.x + rect.width);
+                const maxY = Math.max(last.y + last.height, rect.y + rect.height);
+                merged[merged.length - 1] = {
+                    x: minX,
+                    y: minY,
+                    width: maxX - minX,
+                    height: maxY - minY,
+                };
+            }
+            else {
+                merged.push(rect);
+            }
+        }
+        return merged;
+    }
+}
+exports.DirtyRegionTracker = DirtyRegionTracker;
+//# sourceMappingURL=dirty-region.js.map

package/examples/deskforge-app/dist/packages/renderer/src/dirty-region.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"dirty-region.js","sourceRoot":"","sources":["../../../../../../packages/renderer/src/dirty-region.ts"],"names":[],"mappings":"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"}

package/examples/deskforge-app/dist/packages/renderer/src/engine.d.ts

@@ -0,0 +1,56 @@
+import type { DFNode, DFTree } from '@deskforge/core';
+import type { Renderer } from './renderer';
+/**
+ * Configuration for the rendering engine
+ */
+interface RenderEngineConfig {
+    renderer: Renderer;
+    root: DFNode | DFTree;
+    onBeforeRender?: () => void;
+    onAfterRender?: () => void;
+    onError?: (error: Error) => void;
+}
+/**
+ * Render engine that integrates rendering with scheduling
+ */
+declare class RenderEngine {
+    private config;
+    private scheduler;
+    private root;
+    private running;
+    constructor(config: RenderEngineConfig);
+    /**
+     * Start the rendering engine
+     */
+    start(): void;
+    /**
+     * Stop the rendering engine
+     */
+    stop(): void;
+    /**
+     * Schedule a render
+     */
+    scheduleRender(): void;
+    /**
+     * Perform a render
+     */
+    private render;
+    /**
+     * Update the root node
+     */
+    setRoot(node: DFNode): void;
+    /**
+     * Update the root tree
+     */
+    setTree(tree: DFTree): void;
+    /**
+     * Get the current root node
+     */
+    getRoot(): DFNode;
+    /**
+     * Force immediate render (bypasses scheduler)
+     */
+    forceRender(): void;
+}
+export { RenderEngine };
+export type { RenderEngineConfig };

package/examples/deskforge-app/dist/packages/renderer/src/engine.js

@@ -0,0 +1,95 @@
+"use strict";
+// engine.ts
+// Rendering engine — integrates renderer with scheduler
+// Handles automatic re-renders when state/props change
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.RenderEngine = void 0;
+const core_1 = require("@deskforge/core");
+/**
+ * Render engine that integrates rendering with scheduling
+ */
+class RenderEngine {
+    constructor(config) {
+        // The scheduler that batches renders
+        this.scheduler = (0, core_1.createScheduler)();
+        // Whether the engine is running
+        this.running = false;
+        this.config = {
+            onBeforeRender: () => { },
+            onAfterRender: () => { },
+            onError: (error) => console.error('RenderEngine error:', error),
+            ...config
+        };
+        // Extract root node
+        this.root = 'root' in config.root
+            ? config.root.root
+            : config.root;
+    }
+    /**
+     * Start the rendering engine
+     */
+    start() {
+        if (this.running)
+            return;
+        this.running = true;
+        this.render();
+    }
+    /**
+     * Stop the rendering engine
+     */
+    stop() {
+        if (!this.running)
+            return;
+        this.running = false;
+    }
+    /**
+     * Schedule a render
+     */
+    scheduleRender() {
+        if (!this.running)
+            return;
+        (0, core_1.schedule)(this.scheduler, () => this.render());
+    }
+    /**
+     * Perform a render
+     */
+    render() {
+        try {
+            this.config.onBeforeRender();
+            this.config.renderer.renderNode(this.root);
+            this.config.onAfterRender();
+        }
+        catch (error) {
+            const err = error instanceof Error ? error : new Error(String(error));
+            this.config.onError(err);
+        }
+    }
+    /**
+     * Update the root node
+     */
+    setRoot(node) {
+        this.root = node;
+        this.scheduleRender();
+    }
+    /**
+     * Update the root tree
+     */
+    setTree(tree) {
+        this.root = tree.root;
+        this.scheduleRender();
+    }
+    /**
+     * Get the current root node
+     */
+    getRoot() {
+        return this.root;
+    }
+    /**
+     * Force immediate render (bypasses scheduler)
+     */
+    forceRender() {
+        this.render();
+    }
+}
+exports.RenderEngine = RenderEngine;
+//# sourceMappingURL=engine.js.map

package/examples/deskforge-app/dist/packages/renderer/src/engine.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"engine.js","sourceRoot":"","sources":["../../../../../../packages/renderer/src/engine.ts"],"names":[],"mappings":";AAAA,YAAY;AACZ,wDAAwD;AACxD,uDAAuD;;;AAGvD,0CAA2D;AAuB3D;;GAEG;AACH,MAAM,YAAY;IAahB,YAAY,MAA0B;QATtC,qCAAqC;QAC7B,cAAS,GAAG,IAAA,sBAAe,GAAE,CAAA;QAKrC,gCAAgC;QACxB,YAAO,GAAY,KAAK,CAAA;QAG9B,IAAI,CAAC,MAAM,GAAG;YACZ,cAAc,EAAE,GAAG,EAAE,GAAE,CAAC;YACxB,aAAa,EAAE,GAAG,EAAE,GAAE,CAAC;YACvB,OAAO,EAAE,CAAC,KAAK,EAAE,EAAE,CAAC,OAAO,CAAC,KAAK,CAAC,qBAAqB,EAAE,KAAK,CAAC;YAC/D,GAAG,MAAM;SACV,CAAA;QAED,oBAAoB;QACpB,IAAI,CAAC,IAAI,GAAG,MAAM,IAAI,MAAM,CAAC,IAAI;YAC/B,CAAC,CAAE,MAAM,CAAC,IAAe,CAAC,IAAI;YAC9B,CAAC,CAAE,MAAM,CAAC,IAAe,CAAA;IAC7B,CAAC;IAED;;OAEG;IACH,KAAK;QACH,IAAI,IAAI,CAAC,OAAO;YAAE,OAAM;QACxB,IAAI,CAAC,OAAO,GAAG,IAAI,CAAA;QACnB,IAAI,CAAC,MAAM,EAAE,CAAA;IACf,CAAC;IAED;;OAEG;IACH,IAAI;QACF,IAAI,CAAC,IAAI,CAAC,OAAO;YAAE,OAAM;QACzB,IAAI,CAAC,OAAO,GAAG,KAAK,CAAA;IACtB,CAAC;IAED;;OAEG;IACH,cAAc;QACZ,IAAI,CAAC,IAAI,CAAC,OAAO;YAAE,OAAM;QAEzB,IAAA,eAAQ,EAAC,IAAI,CAAC,SAAS,EAAE,GAAG,EAAE,CAAC,IAAI,CAAC,MAAM,EAAE,CAAC,CAAA;IAC/C,CAAC;IAED;;OAEG;IACK,MAAM;QACZ,IAAI,CAAC;YACH,IAAI,CAAC,MAAM,CAAC,cAAc,EAAE,CAAA;YAC5B,IAAI,CAAC,MAAM,CAAC,QAAQ,CAAC,UAAU,CAAC,IAAI,CAAC,IAAI,CAAC,CAAA;YAC1C,IAAI,CAAC,MAAM,CAAC,aAAa,EAAE,CAAA;QAC7B,CAAC;QAAC,OAAO,KAAK,EAAE,CAAC;YACf,MAAM,GAAG,GAAG,KAAK,YAAY,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,IAAI,KAAK,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC,CAAA;YACrE,IAAI,CAAC,MAAM,CAAC,OAAO,CAAC,GAAG,CAAC,CAAA;QAC1B,CAAC;IACH,CAAC;IAED;;OAEG;IACH,OAAO,CAAC,IAAY;QAClB,IAAI,CAAC,IAAI,GAAG,IAAI,CAAA;QAChB,IAAI,CAAC,cAAc,EAAE,CAAA;IACvB,CAAC;IAED;;OAEG;IACH,OAAO,CAAC,IAAY;QAClB,IAAI,CAAC,IAAI,GAAG,IAAI,CAAC,IAAI,CAAA;QACrB,IAAI,CAAC,cAAc,EAAE,CAAA;IACvB,CAAC;IAED;;OAEG;IACH,OAAO;QACL,OAAO,IAAI,CAAC,IAAI,CAAA;IAClB,CAAC;IAED;;OAEG;IACH,WAAW;QACT,IAAI,CAAC,MAAM,EAAE,CAAA;IACf,CAAC;CACF;AAEQ,oCAAY"}

package/examples/deskforge-app/dist/packages/renderer/src/filters.d.ts

@@ -0,0 +1,22 @@
+export type BlendMode = 'source-over' | 'multiply' | 'screen' | 'overlay' | 'darken' | 'lighten' | 'color-dodge' | 'color-burn' | 'hard-light' | 'soft-light' | 'difference' | 'exclusion';
+export interface FilterOptions {
+    blur?: number;
+    brightness?: number;
+    contrast?: number;
+    saturation?: number;
+    hueRotate?: number;
+    invert?: boolean;
+    sepia?: boolean;
+}
+/**
+ * Apply CSS filter string to canvas context
+ */
+export declare function applyFilter(ctx: CanvasRenderingContext2D, filter: FilterOptions): string;
+/**
+ * Set blend mode on canvas context
+ */
+export declare function setBlendMode(ctx: CanvasRenderingContext2D, mode: BlendMode): void;
+/**
+ * Reset to default blend mode
+ */
+export declare function resetBlendMode(ctx: CanvasRenderingContext2D): void;

package/examples/deskforge-app/dist/packages/renderer/src/filters.js

@@ -0,0 +1,41 @@
+"use strict";
+// filters.ts
+// Rendering filters and blend modes for advanced visual effects
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.applyFilter = applyFilter;
+exports.setBlendMode = setBlendMode;
+exports.resetBlendMode = resetBlendMode;
+/**
+ * Apply CSS filter string to canvas context
+ */
+function applyFilter(ctx, filter) {
+    const parts = [];
+    if (filter.blur)
+        parts.push(`blur(${filter.blur}px)`);
+    if (filter.brightness)
+        parts.push(`brightness(${filter.brightness})`);
+    if (filter.contrast)
+        parts.push(`contrast(${filter.contrast})`);
+    if (filter.saturation)
+        parts.push(`saturate(${filter.saturation})`);
+    if (filter.hueRotate)
+        parts.push(`hue-rotate(${filter.hueRotate}deg)`);
+    if (filter.invert)
+        parts.push(`invert(1)`);
+    if (filter.sepia)
+        parts.push(`sepia(1)`);
+    return parts.join(' ');
+}
+/**
+ * Set blend mode on canvas context
+ */
+function setBlendMode(ctx, mode) {
+    ctx.globalCompositeOperation = mode;
+}
+/**
+ * Reset to default blend mode
+ */
+function resetBlendMode(ctx) {
+    ctx.globalCompositeOperation = 'source-over';
+}
+//# sourceMappingURL=filters.js.map

package/examples/deskforge-app/dist/packages/renderer/src/filters.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"filters.js","sourceRoot":"","sources":["../../../../../../packages/renderer/src/filters.ts"],"names":[],"mappings":";AAAA,aAAa;AACb,gEAAgE;;AA6BhE,kCAeC;AAKD,oCAKC;AAKD,wCAEC;AAnCD;;GAEG;AACH,SAAgB,WAAW,CACzB,GAA6B,EAC7B,MAAqB;IAErB,MAAM,KAAK,GAAa,EAAE,CAAA;IAE1B,IAAI,MAAM,CAAC,IAAI;QAAE,KAAK,CAAC,IAAI,CAAC,QAAQ,MAAM,CAAC,IAAI,KAAK,CAAC,CAAA;IACrD,IAAI,MAAM,CAAC,UAAU;QAAE,KAAK,CAAC,IAAI,CAAC,cAAc,MAAM,CAAC,UAAU,GAAG,CAAC,CAAA;IACrE,IAAI,MAAM,CAAC,QAAQ;QAAE,KAAK,CAAC,IAAI,CAAC,YAAY,MAAM,CAAC,QAAQ,GAAG,CAAC,CAAA;IAC/D,IAAI,MAAM,CAAC,UAAU;QAAE,KAAK,CAAC,IAAI,CAAC,YAAY,MAAM,CAAC,UAAU,GAAG,CAAC,CAAA;IACnE,IAAI,MAAM,CAAC,SAAS;QAAE,KAAK,CAAC,IAAI,CAAC,cAAc,MAAM,CAAC,SAAS,MAAM,CAAC,CAAA;IACtE,IAAI,MAAM,CAAC,MAAM;QAAE,KAAK,CAAC,IAAI,CAAC,WAAW,CAAC,CAAA;IAC1C,IAAI,MAAM,CAAC,KAAK;QAAE,KAAK,CAAC,IAAI,CAAC,UAAU,CAAC,CAAA;IAExC,OAAO,KAAK,CAAC,IAAI,CAAC,GAAG,CAAC,CAAA;AACxB,CAAC;AAED;;GAEG;AACH,SAAgB,YAAY,CAC1B,GAA6B,EAC7B,IAAe;IAEf,GAAG,CAAC,wBAAwB,GAAG,IAAgC,CAAA;AACjE,CAAC;AAED;;GAEG;AACH,SAAgB,cAAc,CAAC,GAA6B;IAC1D,GAAG,CAAC,wBAAwB,GAAG,aAAa,CAAA;AAC9C,CAAC"}

package/examples/deskforge-app/dist/packages/renderer/src/index.d.ts

@@ -0,0 +1,15 @@
+export { Renderer } from './renderer';
+export type { RenderContext } from './context';
+export { createRenderContext, pushState, popState } from './context';
+export type { Canvas } from './canvas';
+export { createCanvas, createCanvasWithDPR } from './canvas';
+export { createNode, createTree } from '@deskforge/core';
+export type { PaintHandler, ComponentPainters } from './painter';
+export { defaultPainters, paintNode, paintTree } from './painter';
+export { RenderEngine } from './engine';
+export type { RenderEngineConfig } from './engine';
+export type { BlendMode, FilterOptions } from './filters';
+export { applyFilter, setBlendMode, resetBlendMode } from './filters';
+export { DirtyRegionTracker } from './dirty-region';
+export type { Rect } from './dirty-region';
+export { SVGBuilder, nodeToSVG } from './svg-export';

package/examples/deskforge-app/dist/packages/renderer/src/index.js

@@ -0,0 +1,34 @@
+"use strict";
+// index.ts
+// Public API for the renderer package
+// Everything needed to render DeskForge components with skia-canvas
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.nodeToSVG = exports.SVGBuilder = exports.DirtyRegionTracker = exports.resetBlendMode = exports.setBlendMode = exports.applyFilter = exports.RenderEngine = exports.paintTree = exports.paintNode = exports.defaultPainters = exports.createTree = exports.createNode = exports.createCanvasWithDPR = exports.createCanvas = exports.popState = exports.pushState = exports.createRenderContext = exports.Renderer = void 0;
+var renderer_1 = require("./renderer");
+Object.defineProperty(exports, "Renderer", { enumerable: true, get: function () { return renderer_1.Renderer; } });
+var context_1 = require("./context");
+Object.defineProperty(exports, "createRenderContext", { enumerable: true, get: function () { return context_1.createRenderContext; } });
+Object.defineProperty(exports, "pushState", { enumerable: true, get: function () { return context_1.pushState; } });
+Object.defineProperty(exports, "popState", { enumerable: true, get: function () { return context_1.popState; } });
+var canvas_1 = require("./canvas");
+Object.defineProperty(exports, "createCanvas", { enumerable: true, get: function () { return canvas_1.createCanvas; } });
+Object.defineProperty(exports, "createCanvasWithDPR", { enumerable: true, get: function () { return canvas_1.createCanvasWithDPR; } });
+var core_1 = require("@deskforge/core");
+Object.defineProperty(exports, "createNode", { enumerable: true, get: function () { return core_1.createNode; } });
+Object.defineProperty(exports, "createTree", { enumerable: true, get: function () { return core_1.createTree; } });
+var painter_1 = require("./painter");
+Object.defineProperty(exports, "defaultPainters", { enumerable: true, get: function () { return painter_1.defaultPainters; } });
+Object.defineProperty(exports, "paintNode", { enumerable: true, get: function () { return painter_1.paintNode; } });
+Object.defineProperty(exports, "paintTree", { enumerable: true, get: function () { return painter_1.paintTree; } });
+var engine_1 = require("./engine");
+Object.defineProperty(exports, "RenderEngine", { enumerable: true, get: function () { return engine_1.RenderEngine; } });
+var filters_1 = require("./filters");
+Object.defineProperty(exports, "applyFilter", { enumerable: true, get: function () { return filters_1.applyFilter; } });
+Object.defineProperty(exports, "setBlendMode", { enumerable: true, get: function () { return filters_1.setBlendMode; } });
+Object.defineProperty(exports, "resetBlendMode", { enumerable: true, get: function () { return filters_1.resetBlendMode; } });
+var dirty_region_1 = require("./dirty-region");
+Object.defineProperty(exports, "DirtyRegionTracker", { enumerable: true, get: function () { return dirty_region_1.DirtyRegionTracker; } });
+var svg_export_1 = require("./svg-export");
+Object.defineProperty(exports, "SVGBuilder", { enumerable: true, get: function () { return svg_export_1.SVGBuilder; } });
+Object.defineProperty(exports, "nodeToSVG", { enumerable: true, get: function () { return svg_export_1.nodeToSVG; } });
+//# sourceMappingURL=index.js.map

package/examples/deskforge-app/dist/packages/renderer/src/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../../../../packages/renderer/src/index.ts"],"names":[],"mappings":";AAAA,WAAW;AACX,sCAAsC;AACtC,oEAAoE;;;AAEpE,uCAAqC;AAA5B,oGAAA,QAAQ,OAAA;AAEjB,qCAAoE;AAA3D,8GAAA,mBAAmB,OAAA;AAAE,oGAAA,SAAS,OAAA;AAAE,mGAAA,QAAQ,OAAA;AAEjD,mCAA4D;AAAnD,sGAAA,YAAY,OAAA;AAAE,6GAAA,mBAAmB,OAAA;AAC1C,wCAAwD;AAA/C,kGAAA,UAAU,OAAA;AAAE,kGAAA,UAAU,OAAA;AAE/B,qCAAiE;AAAxD,0GAAA,eAAe,OAAA;AAAE,oGAAA,SAAS,OAAA;AAAE,oGAAA,SAAS,OAAA;AAC9C,mCAAuC;AAA9B,sGAAA,YAAY,OAAA;AAGrB,qCAAqE;AAA5D,sGAAA,WAAW,OAAA;AAAE,uGAAA,YAAY,OAAA;AAAE,yGAAA,cAAc,OAAA;AAClD,+CAAmD;AAA1C,kHAAA,kBAAkB,OAAA;AAE3B,2CAAoD;AAA3C,wGAAA,UAAU,OAAA;AAAE,uGAAA,SAAS,OAAA"}

package/examples/deskforge-app/dist/packages/renderer/src/painter.d.ts

@@ -0,0 +1,26 @@
+import type { DFNode } from '@deskforge/core';
+import type { RenderContext } from './context';
+/**
+ * Handler function for rendering a specific component type
+ */
+type PaintHandler = (node: DFNode, context: RenderContext) => void;
+/**
+ * Component painters — maps component types to rendering functions
+ */
+interface ComponentPainters {
+    [componentType: string]: PaintHandler;
+}
+/**
+ * Default component painters for built-in components
+ */
+declare const defaultPainters: ComponentPainters;
+/**
+ * Paints a single node using the appropriate painter
+ */
+declare function paintNode(node: DFNode, context: RenderContext, painters?: ComponentPainters): void;
+/**
+ * Paints a tree of nodes recursively
+ */
+declare function paintTree(node: DFNode, context: RenderContext, painters?: ComponentPainters): void;
+export type { PaintHandler, ComponentPainters };
+export { defaultPainters, paintNode, paintTree };