deskforge 1.0.0

package/packages/core/dist/animation/spring.js

@@ -0,0 +1,79 @@
+"use strict";
+// spring.ts
+// Spring physics for natural feeling animations.
+// Real springs overshoot and oscillate before settling.
+// This makes UI feel alive rather than mechanical.
+// Used for button presses, card expansions, transitions.
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.SpringPresets = void 0;
+exports.createSpringState = createSpringState;
+exports.stepSpring = stepSpring;
+exports.isSpringSettled = isSpringSettled;
+// Preset spring configurations for common use cases
+const SpringPresets = {
+    // Snappy — fast and barely oscillates
+    // Good for button presses
+    snappy: {
+        mass: 1,
+        stiffness: 400,
+        damping: 40,
+    },
+    // Gentle — slow and smooth
+    // Good for page transitions
+    gentle: {
+        mass: 1,
+        stiffness: 120,
+        damping: 14,
+    },
+    // Bouncy — overshoots and bounces
+    // Good for playful elements
+    bouncy: {
+        mass: 1,
+        stiffness: 180,
+        damping: 10,
+    },
+    // Stiff — very fast, no bounce
+    // Good for instant feedback
+    stiff: {
+        mass: 1,
+        stiffness: 600,
+        damping: 60,
+    },
+};
+exports.SpringPresets = SpringPresets;
+// Creates initial spring state at a given position
+function createSpringState(initialPosition) {
+    return {
+        position: initialPosition,
+        velocity: 0
+    };
+}
+// Advances the spring simulation by one time step
+// deltaTime — time elapsed since last frame in seconds
+// target — the value the spring is moving toward
+// Returns updated spring state
+function stepSpring(state, config, target, deltaTime) {
+    // Spring force pulls toward target
+    const springForce = -config.stiffness * (state.position - target);
+    // Damping force resists movement
+    const dampingForce = -config.damping * state.velocity;
+    // Total acceleration = force / mass
+    const acceleration = (springForce + dampingForce) / config.mass;
+    // Update velocity
+    const newVelocity = state.velocity + acceleration * deltaTime;
+    // Update position
+    const newPosition = state.position + newVelocity * deltaTime;
+    return {
+        position: newPosition,
+        velocity: newVelocity
+    };
+}
+// Returns true if spring has settled at target
+// Used to know when to stop animating
+function isSpringSettled(state, target) {
+    const positionDiff = Math.abs(state.position - target);
+    const velocityDiff = Math.abs(state.velocity);
+    // Settled when close enough to target and barely moving
+    return positionDiff < 0.01 && velocityDiff < 0.01;
+}
+//# sourceMappingURL=spring.js.map

package/packages/core/dist/animation/spring.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"spring.js","sourceRoot":"","sources":["../../src/animation/spring.ts"],"names":[],"mappings":";AAAA,YAAY;AACZ,iDAAiD;AACjD,wDAAwD;AACxD,mDAAmD;AACnD,yDAAyD;;;AA8GvD,8CAAiB;AACjB,gCAAU;AACV,0CAAe;AAjGjB,oDAAoD;AACpD,MAAM,aAAa,GAAG;IACpB,sCAAsC;IACtC,0BAA0B;IAC1B,MAAM,EAAE;QACN,IAAI,EAAO,CAAC;QACZ,SAAS,EAAE,GAAG;QACd,OAAO,EAAI,EAAE;KACE;IAEjB,2BAA2B;IAC3B,4BAA4B;IAC5B,MAAM,EAAE;QACN,IAAI,EAAO,CAAC;QACZ,SAAS,EAAE,GAAG;QACd,OAAO,EAAI,EAAE;KACE;IAEjB,kCAAkC;IAClC,4BAA4B;IAC5B,MAAM,EAAE;QACN,IAAI,EAAO,CAAC;QACZ,SAAS,EAAE,GAAG;QACd,OAAO,EAAI,EAAE;KACE;IAEjB,+BAA+B;IAC/B,4BAA4B;IAC5B,KAAK,EAAE;QACL,IAAI,EAAO,CAAC;QACZ,SAAS,EAAE,GAAG;QACd,OAAO,EAAI,EAAE;KACE;CAClB,CAAA;AA6DC,sCAAa;AA3Df,mDAAmD;AACnD,SAAS,iBAAiB,CAAC,eAAuB;IAChD,OAAO;QACL,QAAQ,EAAE,eAAe;QACzB,QAAQ,EAAE,CAAC;KACZ,CAAA;AACH,CAAC;AAED,kDAAkD;AAClD,uDAAuD;AACvD,iDAAiD;AACjD,+BAA+B;AAC/B,SAAS,UAAU,CACjB,KAAsB,EACtB,MAAuB,EACvB,MAAiB,EACjB,SAAiB;IAEjB,mCAAmC;IACnC,MAAM,WAAW,GACf,CAAC,MAAM,CAAC,SAAS,GAAG,CAAC,KAAK,CAAC,QAAQ,GAAG,MAAM,CAAC,CAAA;IAE/C,iCAAiC;IACjC,MAAM,YAAY,GAChB,CAAC,MAAM,CAAC,OAAO,GAAG,KAAK,CAAC,QAAQ,CAAA;IAElC,oCAAoC;IACpC,MAAM,YAAY,GAChB,CAAC,WAAW,GAAG,YAAY,CAAC,GAAG,MAAM,CAAC,IAAI,CAAA;IAE5C,kBAAkB;IAClB,MAAM,WAAW,GACf,KAAK,CAAC,QAAQ,GAAG,YAAY,GAAG,SAAS,CAAA;IAE3C,kBAAkB;IAClB,MAAM,WAAW,GACf,KAAK,CAAC,QAAQ,GAAG,WAAW,GAAG,SAAS,CAAA;IAE1C,OAAO;QACL,QAAQ,EAAE,WAAW;QACrB,QAAQ,EAAE,WAAW;KACtB,CAAA;AACH,CAAC;AAED,+CAA+C;AAC/C,sCAAsC;AACtC,SAAS,eAAe,CACtB,KAAmB,EACnB,MAAc;IAEd,MAAM,YAAY,GAAG,IAAI,CAAC,GAAG,CAAC,KAAK,CAAC,QAAQ,GAAG,MAAM,CAAC,CAAA;IACtD,MAAM,YAAY,GAAG,IAAI,CAAC,GAAG,CAAC,KAAK,CAAC,QAAQ,CAAC,CAAA;IAE7C,wDAAwD;IACxD,OAAO,YAAY,GAAG,IAAI,IAAI,YAAY,GAAG,IAAI,CAAA;AACnD,CAAC"}

package/packages/core/dist/component/component.d.ts

@@ -0,0 +1,6 @@
+import { DFNode } from "../tree";
+type ComponentFn<P = Record<string, unknown>> = (props: P) => DFNode;
+declare function Component<P = Record<string, unknown>>(fn: ComponentFn<P>): ComponentFn<P>;
+export type { ComponentFn };
+export { Component };
+//# sourceMappingURL=component.d.ts.map

package/packages/core/dist/component/component.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"component.d.ts","sourceRoot":"","sources":["../../src/component/component.ts"],"names":[],"mappings":"AAMA,OAAO,EAAE,MAAM,EAAE,MAAM,SAAS,CAAC;AAIjC,KAAK,WAAW,CAAC,CAAC,GAAG,MAAM,CAAC,MAAM,EAAC,OAAO,CAAC,IAAI,CAAC,KAAK,EAAG,CAAC,KAAI,MAAM,CAAA;AAInE,iBAAS,SAAS,CAAC,CAAC,GAAG,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAC1C,EAAE,EAAC,WAAW,CAAC,CAAC,CAAC,GACnB,WAAW,CAAC,CAAC,CAAC,CAEf;AAED,YAAY,EAAC,WAAW,EAAC,CAAA;AACzB,OAAO,EAAC,SAAS,EAAC,CAAA"}

package/packages/core/dist/component/component.js

@@ -0,0 +1,14 @@
+"use strict";
+//component.ts
+//The Component factory functionn.
+//Takes a function that returns a DFNode tree.
+//Returns a reusable component funtion.
+//This is how developers create custom components.
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.Component = Component;
+//Creates a reusable DeskForge component
+// fn - function that receives props and return DFNode tree
+function Component(fn) {
+    return fn;
+}
+//# sourceMappingURL=component.js.map

package/packages/core/dist/component/component.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"component.js","sourceRoot":"","sources":["../../src/component/component.ts"],"names":[],"mappings":";AAAA,cAAc;AACd,kCAAkC;AAClC,8CAA8C;AAC9C,uCAAuC;AACvC,kDAAkD;;AAiB1C,8BAAS;AATjB,wCAAwC;AACxC,2DAA2D;AAC3D,SAAS,SAAS,CACd,EAAiB;IAEjB,OAAO,EAAE,CAAA;AACb,CAAC"}

package/packages/core/dist/component/index.d.ts

@@ -0,0 +1,2 @@
+export * from './component';
+//# sourceMappingURL=index.d.ts.map

package/packages/core/dist/component/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/component/index.ts"],"names":[],"mappings":"AAAA,cAAc,aAAa,CAAA"}

package/packages/core/dist/component/index.js

@@ -0,0 +1,18 @@
+"use strict";
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __exportStar = (this && this.__exportStar) || function(m, exports) {
+    for (var p in m) if (p !== "default" && !Object.prototype.hasOwnProperty.call(exports, p)) __createBinding(exports, m, p);
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+__exportStar(require("./component"), exports);
+//# sourceMappingURL=index.js.map

package/packages/core/dist/component/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/component/index.ts"],"names":[],"mappings":";;;;;;;;;;;;;;;;AAAA,8CAA2B"}

package/packages/core/dist/index.d.ts

@@ -0,0 +1,6 @@
+export * from './tree/node';
+export * from './tree/index';
+export * from './scheduler/index';
+export * from './animation/index';
+export * from './component/index';
+//# sourceMappingURL=index.d.ts.map

package/packages/core/dist/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAKA,cAAc,aAAa,CAAA;AAC3B,cAAc,cAAc,CAAA;AAG5B,cAAc,mBAAmB,CAAA;AAMjC,cAAc,mBAAmB,CAAA;AAEjC,cAAc,mBAAmB,CAAA"}

package/packages/core/dist/index.js

@@ -0,0 +1,30 @@
+"use strict";
+// index.ts
+// Public door into the entire core package.
+// Every other package imports from here.
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __exportStar = (this && this.__exportStar) || function(m, exports) {
+    for (var p in m) if (p !== "default" && !Object.prototype.hasOwnProperty.call(exports, p)) __createBinding(exports, m, p);
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+// Object tree — the foundation of everything
+__exportStar(require("./tree/node"), exports);
+__exportStar(require("./tree/index"), exports);
+// Scheduler — controls when re-renders happen
+__exportStar(require("./scheduler/index"), exports);
+// Events — user interaction pipeline
+//export * from './events/index'
+// Animation — fluid motion system
+__exportStar(require("./animation/index"), exports);
+__exportStar(require("./component/index"), exports);
+//# sourceMappingURL=index.js.map

package/packages/core/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":";AAAA,WAAW;AACX,4CAA4C;AAC5C,yCAAyC;;;;;;;;;;;;;;;;AAEzC,6CAA6C;AAC7C,8CAA2B;AAC3B,+CAA4B;AAE5B,8CAA8C;AAC9C,oDAAiC;AAEjC,qCAAqC;AACrC,gCAAgC;AAEhC,kCAAkC;AAClC,oDAAiC;AAEjC,oDAAiC"}

package/packages/core/dist/scheduler/index.d.ts

@@ -0,0 +1,2 @@
+export * from './scheduler';
+//# sourceMappingURL=index.d.ts.map

package/packages/core/dist/scheduler/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/scheduler/index.ts"],"names":[],"mappings":"AAGA,cAAc,aAAa,CAAA"}

package/packages/core/dist/scheduler/index.js

@@ -0,0 +1,20 @@
+"use strict";
+// index.ts
+// Public door into the scheduler module.
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __exportStar = (this && this.__exportStar) || function(m, exports) {
+    for (var p in m) if (p !== "default" && !Object.prototype.hasOwnProperty.call(exports, p)) __createBinding(exports, m, p);
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+__exportStar(require("./scheduler"), exports);
+//# sourceMappingURL=index.js.map

package/packages/core/dist/scheduler/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/scheduler/index.ts"],"names":[],"mappings":";AAAA,WAAW;AACX,yCAAyC;;;;;;;;;;;;;;;;AAEzC,8CAA2B"}

package/packages/core/dist/scheduler/scheduler.d.ts

@@ -0,0 +1,12 @@
+type RenderCallback = () => void;
+interface Scheduler {
+    pending: RenderCallback[];
+    scheduled: boolean;
+}
+declare function createScheduler(): Scheduler;
+declare function schedule(scheduler: Scheduler, callback: RenderCallback): void;
+declare function flush(scheduler: Scheduler): void;
+declare function cancelAll(scheduler: Scheduler): void;
+export type { Scheduler, RenderCallback };
+export { createScheduler, schedule, flush, cancelAll };
+//# sourceMappingURL=scheduler.d.ts.map

package/packages/core/dist/scheduler/scheduler.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"scheduler.d.ts","sourceRoot":"","sources":["../../src/scheduler/scheduler.ts"],"names":[],"mappings":"AAMA,KAAK,cAAc,GAAG,MAAM,IAAI,CAAA;AAGhC,UAAU,SAAS;IACjB,OAAO,EAAI,cAAc,EAAE,CAAA;IAC3B,SAAS,EAAE,OAAO,CAAA;CACnB;AAGD,iBAAS,eAAe,IAAI,SAAS,CAKpC;AAID,iBAAS,QAAQ,CACf,SAAS,EAAE,SAAS,EACpB,QAAQ,EAAG,cAAc,GACxB,IAAI,CAiBN;AAGD,iBAAS,KAAK,CAAC,SAAS,EAAE,SAAS,GAAG,IAAI,CAkBzC;AAID,iBAAS,SAAS,CAAC,SAAS,EAAE,SAAS,GAAG,IAAI,CAG7C;AAED,YAAY,EAAE,SAAS,EAAE,cAAc,EAAE,CAAA;AACzC,OAAO,EAAE,eAAe,EAAE,QAAQ,EAAE,KAAK,EAAE,SAAS,EAAE,CAAA"}

package/packages/core/dist/scheduler/scheduler.js

@@ -0,0 +1,61 @@
+"use strict";
+// scheduler.ts
+// Controls WHEN re-renders happen.
+// Batches multiple state changes into one render per frame.
+// Prevents unnecessary redraws when state changes rapidly.
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.createScheduler = createScheduler;
+exports.schedule = schedule;
+exports.flush = flush;
+exports.cancelAll = cancelAll;
+// Creates a new empty scheduler
+function createScheduler() {
+    return {
+        pending: [],
+        scheduled: false
+    };
+}
+// Adds a callback to the queue and schedules a flush
+// If already scheduled — just adds to queue, no double flush
+function schedule(scheduler, callback) {
+    // Add to the pending queue
+    scheduler.pending.push(callback);
+    // Already scheduled — do nothing more
+    // This is the batching guard
+    if (scheduler.scheduled)
+        return;
+    // Mark as scheduled
+    scheduler.scheduled = true;
+    // Schedule flush on microtask queue
+    // Runs after current synchronous code finishes
+    // Faster than setTimeout — works in Node.js and browser
+    Promise.resolve().then(() => {
+        flush(scheduler);
+    });
+}
+// Runs all pending callbacks and resets the scheduler
+function flush(scheduler) {
+    // Copy queue before clearing
+    // New callbacks added during flush go into next batch
+    const callbacks = [...scheduler.pending];
+    // Clear queue and reset scheduled flag
+    scheduler.pending = [];
+    scheduler.scheduled = false;
+    // Run every callback
+    // try/catch so one crash does not stop the others
+    callbacks.forEach(callback => {
+        try {
+            callback();
+        }
+        catch (error) {
+            console.error('DeskForge scheduler error:', error);
+        }
+    });
+}
+// Cancels all pending callbacks
+// Used when app closes or component unmounts
+function cancelAll(scheduler) {
+    scheduler.pending = [];
+    scheduler.scheduled = false;
+}
+//# sourceMappingURL=scheduler.js.map

package/packages/core/dist/scheduler/scheduler.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"scheduler.js","sourceRoot":"","sources":["../../src/scheduler/scheduler.ts"],"names":[],"mappings":";AAAA,eAAe;AACf,mCAAmC;AACnC,4DAA4D;AAC5D,2DAA2D;;AAwElD,0CAAe;AAAE,4BAAQ;AAAE,sBAAK;AAAE,8BAAS;AA7DpD,gCAAgC;AAChC,SAAS,eAAe;IACtB,OAAO;QACL,OAAO,EAAI,EAAE;QACb,SAAS,EAAE,KAAK;KACjB,CAAA;AACH,CAAC;AAED,qDAAqD;AACrD,6DAA6D;AAC7D,SAAS,QAAQ,CACf,SAAoB,EACpB,QAAyB;IAEzB,2BAA2B;IAC3B,SAAS,CAAC,OAAO,CAAC,IAAI,CAAC,QAAQ,CAAC,CAAA;IAEhC,sCAAsC;IACtC,6BAA6B;IAC7B,IAAI,SAAS,CAAC,SAAS;QAAE,OAAM;IAE/B,oBAAoB;IACpB,SAAS,CAAC,SAAS,GAAG,IAAI,CAAA;IAE1B,oCAAoC;IACpC,+CAA+C;IAC/C,wDAAwD;IACxD,OAAO,CAAC,OAAO,EAAE,CAAC,IAAI,CAAC,GAAG,EAAE;QAC1B,KAAK,CAAC,SAAS,CAAC,CAAA;IAClB,CAAC,CAAC,CAAA;AACJ,CAAC;AAED,sDAAsD;AACtD,SAAS,KAAK,CAAC,SAAoB;IACjC,6BAA6B;IAC7B,sDAAsD;IACtD,MAAM,SAAS,GAAG,CAAC,GAAG,SAAS,CAAC,OAAO,CAAC,CAAA;IAExC,uCAAuC;IACvC,SAAS,CAAC,OAAO,GAAK,EAAE,CAAA;IACxB,SAAS,CAAC,SAAS,GAAG,KAAK,CAAA;IAE3B,qBAAqB;IACrB,kDAAkD;IAClD,SAAS,CAAC,OAAO,CAAC,QAAQ,CAAC,EAAE;QAC3B,IAAI,CAAC;YACH,QAAQ,EAAE,CAAA;QACZ,CAAC;QAAC,OAAO,KAAK,EAAE,CAAC;YACf,OAAO,CAAC,KAAK,CAAC,4BAA4B,EAAE,KAAK,CAAC,CAAA;QACpD,CAAC;IACH,CAAC,CAAC,CAAA;AACJ,CAAC;AAED,gCAAgC;AAChC,6CAA6C;AAC7C,SAAS,SAAS,CAAC,SAAoB;IACrC,SAAS,CAAC,OAAO,GAAK,EAAE,CAAA;IACxB,SAAS,CAAC,SAAS,GAAG,KAAK,CAAA;AAC7B,CAAC"}

package/packages/core/dist/tree/diff.d.ts

@@ -0,0 +1,17 @@
+import type { DFNode } from './node';
+import type { DFTree } from './tree';
+type PatchType = 'CREATE' | 'UPDATE' | 'DELETE' | 'REPLACE' | 'NONE';
+interface DFPatch {
+    type: PatchType;
+    node: DFNode;
+    oldNode: DFNode | null;
+    changes: Record<string, unknown>;
+}
+interface DFDiffResult {
+    patches: DFPatch[];
+    hasChanges: boolean;
+}
+declare function diffTrees(oldTree: DFTree, newTree: DFTree): DFDiffResult;
+export type { DFPatch, DFDiffResult };
+export { diffTrees };
+//# sourceMappingURL=diff.d.ts.map

package/packages/core/dist/tree/diff.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"diff.d.ts","sourceRoot":"","sources":["../../src/tree/diff.ts"],"names":[],"mappings":"AAIA,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,QAAQ,CAAA;AACpC,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,QAAQ,CAAA;AAGpC,KAAK,SAAS,GACV,QAAQ,GACR,QAAQ,GACR,QAAQ,GACR,SAAS,GACT,MAAM,CAAA;AAGV,UAAU,OAAO;IACf,IAAI,EAAK,SAAS,CAAA;IAClB,IAAI,EAAK,MAAM,CAAA;IACf,OAAO,EAAE,MAAM,GAAG,IAAI,CAAA;IACtB,OAAO,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAA;CACjC;AAGD,UAAU,YAAY;IACpB,OAAO,EAAK,OAAO,EAAE,CAAA;IACrB,UAAU,EAAE,OAAO,CAAA;CACpB;AAkFD,iBAAS,SAAS,CAChB,OAAO,EAAE,MAAM,EACf,OAAO,EAAE,MAAM,GACd,YAAY,CASd;AAED,YAAY,EAAE,OAAO,EAAE,YAAY,EAAE,CAAA;AACrC,OAAO,EAAE,SAAS,EAAE,CAAA"}

package/packages/core/dist/tree/diff.js

@@ -0,0 +1,67 @@
+"use strict";
+// diff.ts
+// Compares two trees and finds what changed.
+// Only changed nodes get redrawn by Skia — nothing else.
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.diffTrees = diffTrees;
+// Compares old and new props and returns what changed
+function diffProps(oldProps, newProps) {
+    const changes = {};
+    // Check for new or changed props
+    Object.keys(newProps).forEach(key => {
+        if (oldProps[key] !== newProps[key]) {
+            changes[key] = newProps[key];
+        }
+    });
+    // Check for deleted props
+    Object.keys(oldProps).forEach(key => {
+        if (!(key in newProps)) {
+            changes[key] = undefined;
+        }
+    });
+    return changes;
+}
+// Recursively compares two nodes and collects patches
+function diffNodes(oldNode, newNode, patches) {
+    // Both null — nothing to do
+    if (!oldNode && !newNode)
+        return;
+    // Node was created
+    if (!oldNode && newNode) {
+        patches.push({ type: 'CREATE', node: newNode, oldNode: null, changes: {} });
+        return;
+    }
+    // Node was deleted
+    if (oldNode && !newNode) {
+        patches.push({ type: 'DELETE', node: oldNode, oldNode, changes: {} });
+        return;
+    }
+    if (oldNode && newNode) {
+        // Completely different component type — replace entirely
+        if (oldNode.type !== newNode.type) {
+            patches.push({ type: 'REPLACE', node: newNode, oldNode, changes: {} });
+            return;
+        }
+        // Same type — check if props changed
+        const changes = diffProps(oldNode.props, newNode.props);
+        if (Object.keys(changes).length > 0) {
+            patches.push({ type: 'UPDATE', node: newNode, oldNode, changes });
+        }
+        // Recurse into children
+        const maxChildren = Math.max(oldNode.children.length, newNode.children.length);
+        for (let i = 0; i < maxChildren; i++) {
+            diffNodes(oldNode.children[i] ?? null, newNode.children[i] ?? null, patches);
+        }
+    }
+}
+// Main diff function — compares two full trees
+// Returns all patches and whether anything changed
+function diffTrees(oldTree, newTree) {
+    const patches = [];
+    diffNodes(oldTree.root, newTree.root, patches);
+    return {
+        patches,
+        hasChanges: patches.length > 0
+    };
+}
+//# sourceMappingURL=diff.js.map

package/packages/core/dist/tree/diff.js.map

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

package/packages/core/dist/tree/index.d.ts

@@ -0,0 +1,4 @@
+export * from './node';
+export * from './tree';
+export * from './diff';
+//# sourceMappingURL=index.d.ts.map

package/packages/core/dist/tree/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/tree/index.ts"],"names":[],"mappings":"AAIA,cAAc,QAAQ,CAAA;AACtB,cAAc,QAAQ,CAAA;AACtB,cAAc,QAAQ,CAAA"}

package/packages/core/dist/tree/index.js

@@ -0,0 +1,23 @@
+"use strict";
+// index.ts
+// Public door into the tree module.
+// Other packages import from here — not from individual files.
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __exportStar = (this && this.__exportStar) || function(m, exports) {
+    for (var p in m) if (p !== "default" && !Object.prototype.hasOwnProperty.call(exports, p)) __createBinding(exports, m, p);
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+__exportStar(require("./node"), exports);
+__exportStar(require("./tree"), exports);
+__exportStar(require("./diff"), exports);
+//# sourceMappingURL=index.js.map

package/packages/core/dist/tree/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/tree/index.ts"],"names":[],"mappings":";AAAA,WAAW;AACX,oCAAoC;AACpC,+DAA+D;;;;;;;;;;;;;;;;AAE/D,yCAAsB;AACtB,yCAAsB;AACtB,yCAAsB"}

package/packages/core/dist/tree/node.d.ts

@@ -0,0 +1,13 @@
+interface DFNode<P = Record<string, unknown>> {
+    id: string;
+    type: string;
+    props: P;
+    children: DFNode[];
+    key: string | number | null;
+}
+declare function generateId(): string;
+declare function createNode<P extends Record<string, unknown>>(type: string, props?: P, children?: DFNode[]): DFNode<P>;
+declare function isNode(value: unknown): value is DFNode;
+export type { DFNode };
+export { createNode, isNode, generateId };
+//# sourceMappingURL=node.d.ts.map

package/packages/core/dist/tree/node.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"node.d.ts","sourceRoot":"","sources":["../../src/tree/node.ts"],"names":[],"mappings":"AAUA,UAAU,MAAM,CAAC,CAAC,GAAG,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC;IAG1C,EAAE,EAAE,MAAM,CAAA;IAIV,IAAI,EAAE,MAAM,CAAA;IAIZ,KAAK,EAAE,CAAC,CAAA;IAIR,QAAQ,EAAE,MAAM,EAAE,CAAA;IAIlB,GAAG,EAAE,MAAM,GAAG,MAAM,GAAG,IAAI,CAAA;CAC5B;AAOD,iBAAS,UAAU,IAAI,MAAM,CAE5B;AAQD,iBAAS,UAAU,CAAC,CAAC,SAAS,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAEnD,IAAI,EAAE,MAAM,EAEZ,KAAK,CAAC,EAAE,CAAC,EAET,QAAQ,CAAC,EAAE,MAAM,EAAE,GAClB,MAAM,CAAC,CAAC,CAAC,CAaX;AAOD,iBAAS,MAAM,CAAC,KAAK,EAAE,OAAO,GAAG,KAAK,IAAI,MAAM,CAa/C;AAKD,YAAY,EAAE,MAAM,EAAE,CAAA;AAGtB,OAAO,EAAE,UAAU,EAAE,MAAM,EAAE,UAAU,EAAE,CAAA"}

package/packages/core/dist/tree/node.js

@@ -0,0 +1,59 @@
+"use strict";
+// node.ts
+// The atom of DeskForge. Every UI component — Button, Text,
+// Column, Window — is represented as a DFNode object.
+// The entire app is one giant tree of these objects.
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.createNode = createNode;
+exports.isNode = isNode;
+exports.generateId = generateId;
+// ─── ID GENERATOR ────────────────────────────────────────
+// Generates a short unique ID for each node
+// Uses Math.random() converted to hex string
+// Result looks like: "df_a3f9b2"
+function generateId() {
+    return 'df_' + Math.random().toString(16).slice(2, 8);
+}
+// ─── NODE FACTORY ────────────────────────────────────────
+// Creates a new DFNode with the given type, props, children
+// Props default to empty object if not provided
+// Children default to empty array if not provided
+// Key is always null by default
+function createNode(
+// The component type name
+type, 
+// Optional props object — defaults to empty object
+props, 
+// Optional children array — defaults to empty array
+children) {
+    return {
+        // Generate a unique id for this node
+        id: generateId(),
+        // Store the component type
+        type,
+        // Use provided props or empty object cast to P
+        props: props ?? {},
+        // Use provided children or empty array
+        children: children ?? [],
+        // Always null unless set explicitly later
+        key: null
+    };
+}
+// ─── TYPE GUARD ──────────────────────────────────────────
+// Checks if an unknown value is a valid DFNode
+// Used by the renderer and diff engine to validate nodes
+// Returns true if value has all required DFNode properties
+function isNode(value) {
+    return (
+    // Must not be null
+    value !== null &&
+        // Must be an object
+        typeof value === 'object' &&
+        // Must have a string type property
+        typeof value.type === 'string' &&
+        // Must have an object props property
+        typeof value.props === 'object' &&
+        // Must have an array children property
+        Array.isArray(value.children));
+}
+//# sourceMappingURL=node.js.map

package/packages/core/dist/tree/node.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"node.js","sourceRoot":"","sources":["../../src/tree/node.ts"],"names":[],"mappings":";AAAA,UAAU;AACV,4DAA4D;AAC5D,sDAAsD;AACtD,qDAAqD;;AA4F5C,gCAAU;AAAE,wBAAM;AAAE,gCAAU;AA/DvC,4DAA4D;AAE5D,4CAA4C;AAC5C,6CAA6C;AAC7C,iCAAiC;AACjC,SAAS,UAAU;IACjB,OAAO,KAAK,GAAG,IAAI,CAAC,MAAM,EAAE,CAAC,QAAQ,CAAC,EAAE,CAAC,CAAC,KAAK,CAAC,CAAC,EAAE,CAAC,CAAC,CAAA;AACvD,CAAC;AAED,4DAA4D;AAE5D,4DAA4D;AAC5D,gDAAgD;AAChD,kDAAkD;AAClD,gCAAgC;AAChC,SAAS,UAAU;AACjB,0BAA0B;AAC1B,IAAY;AACZ,mDAAmD;AACnD,KAAS;AACT,oDAAoD;AACpD,QAAmB;IAEnB,OAAO;QACL,qCAAqC;QACrC,EAAE,EAAQ,UAAU,EAAE;QACtB,2BAA2B;QAC3B,IAAI;QACJ,+CAA+C;QAC/C,KAAK,EAAK,KAAK,IAAQ,EAAQ;QAC/B,uCAAuC;QACvC,QAAQ,EAAE,QAAQ,IAAI,EAAE;QACxB,0CAA0C;QAC1C,GAAG,EAAO,IAAI;KACf,CAAA;AACH,CAAC;AAED,4DAA4D;AAE5D,+CAA+C;AAC/C,yDAAyD;AACzD,2DAA2D;AAC3D,SAAS,MAAM,CAAC,KAAc;IAC5B,OAAO;IACL,mBAAmB;IACnB,KAAK,KAAK,IAAI;QACd,oBAAoB;QACpB,OAAO,KAAK,KAAK,QAAQ;QACzB,mCAAmC;QACnC,OAAQ,KAAgB,CAAC,IAAI,KAAK,QAAQ;QAC1C,qCAAqC;QACrC,OAAQ,KAAgB,CAAC,KAAK,KAAK,QAAQ;QAC3C,uCAAuC;QACvC,KAAK,CAAC,OAAO,CAAE,KAAgB,CAAC,QAAQ,CAAC,CAC1C,CAAA;AACH,CAAC"}

package/packages/core/dist/tree/tree.d.ts

@@ -0,0 +1,11 @@
+import type { DFNode } from './node';
+interface DFTree {
+    root: DFNode;
+    nodeCount: number;
+}
+declare function createTree(root: DFNode): DFTree;
+declare function walkTree(tree: DFTree, visitor: (node: DFNode) => void): void;
+declare function findNode(tree: DFTree, id: string): DFNode | null;
+export type { DFTree };
+export { createTree, walkTree, findNode };
+//# sourceMappingURL=tree.d.ts.map

package/packages/core/dist/tree/tree.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"tree.d.ts","sourceRoot":"","sources":["../../src/tree/tree.ts"],"names":[],"mappings":"AAIA,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,QAAQ,CAAA;AAGpC,UAAU,MAAM;IACd,IAAI,EAAO,MAAM,CAAA;IACjB,SAAS,EAAE,MAAM,CAAA;CAClB;AAcD,iBAAS,UAAU,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,CAKxC;AAID,iBAAS,QAAQ,CACf,IAAI,EAAK,MAAM,EACf,OAAO,EAAE,CAAC,IAAI,EAAE,MAAM,KAAK,IAAI,GAC9B,IAAI,CAON;AAID,iBAAS,QAAQ,CACf,IAAI,EAAE,MAAM,EACZ,EAAE,EAAI,MAAM,GACX,MAAM,GAAG,IAAI,CAUf;AAED,YAAY,EAAE,MAAM,EAAE,CAAA;AACtB,OAAO,EAAE,UAAU,EAAE,QAAQ,EAAE,QAAQ,EAAE,CAAA"}

package/packages/core/dist/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/packages/core/dist/tree/tree.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"tree.js","sourceRoot":"","sources":["../../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/packages/core/package.json

@@ -0,0 +1,30 @@
+{
+  "name": "@deskforge/core",
+  "version": "1.0.0",
+  "description": "DeskForge core — object tree, diff engine, scheduler",
+  "main": "dist/index.js",
+  "types": "dist/index.d.ts",
+  "scripts": {
+    "build": "tsc",
+    "check": "tsc --noEmit",
+    "prepare": "npm run build"
+  },
+  "devDependencies": {
+    "typescript": "^5.0.0"
+  },
+  "license": "MIT",
+  "files": [
+    "dist"
+  ],
+  "publishConfig": {
+    "access": "public"
+  },
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/deskforge/deskforge.git"
+  },
+  "bugs": {
+    "url": "https://github.com/deskforge/deskforge/issues"
+  },
+  "homepage": "https://github.com/deskforge/deskforge#readme"
+}