deskforge 1.0.0

package/packages/state/dist/state/src/reducer.js

@@ -0,0 +1,44 @@
+"use strict";
+// reducer.ts
+// Complex state management with named actions.
+// Similar to Redux but simpler — no boilerplate.
+// Mutate state directly inside actions.
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.Reducer = Reducer;
+const state_1 = require("./state");
+const scheduler_1 = require("../../core/src/scheduler/scheduler");
+// Creates a reducer with named actions
+// State is reactive — UI updates when actions run
+// Actions receive state directly — mutate it freely
+function Reducer(config) {
+    // Each reducer gets its own scheduler
+    const scheduler = (0, scheduler_1.createScheduler)();
+    // Create reactive state
+    const reactiveState = (0, state_1.State)({ ...config.state }, scheduler);
+    // Snapshot of initial state for reset
+    const initialState = { ...config.state };
+    // Calls a named action with optional payload
+    function dispatch(action, payload) {
+        const actionFn = config.actions[action];
+        if (!actionFn) {
+            console.error(`DeskForge Reducer: unknown action "${action}"`);
+            return;
+        }
+        // Pass reactive state directly to action
+        // Action mutates it — Proxy handles re-renders
+        actionFn(reactiveState, payload);
+    }
+    // Resets all values back to initial state
+    function reset() {
+        Object.keys(initialState).forEach(key => {
+            reactiveState[key] =
+                initialState[key];
+        });
+    }
+    return {
+        state: reactiveState,
+        dispatch,
+        reset
+    };
+}
+//# sourceMappingURL=reducer.js.map

package/packages/state/dist/state/src/reducer.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"reducer.js","sourceRoot":"","sources":["../../../src/reducer.ts"],"names":[],"mappings":";AAAA,aAAa;AACb,+CAA+C;AAC/C,iDAAiD;AACjD,wCAAwC;;AAmF/B,0BAAO;AAjFhB,mCAAyC;AACzC,kEAAoE;AA8BpE,uCAAuC;AACvC,kDAAkD;AAClD,oDAAoD;AACpD,SAAS,OAAO,CACd,MAAwB;IAExB,sCAAsC;IACtC,MAAM,SAAS,GAAG,IAAA,2BAAe,GAAE,CAAA;IAEnC,wBAAwB;IACxB,MAAM,aAAa,GAAG,IAAA,aAAK,EACzB,EAAE,GAAG,MAAM,CAAC,KAAK,EAAE,EACnB,SAAS,CACV,CAAA;IAED,sCAAsC;IACtC,MAAM,YAAY,GAAG,EAAE,GAAG,MAAM,CAAC,KAAK,EAAE,CAAA;IAExC,6CAA6C;IAC7C,SAAS,QAAQ,CAAC,MAAc,EAAE,OAAiB;QACjD,MAAM,QAAQ,GAAG,MAAM,CAAC,OAAO,CAAC,MAAM,CAAC,CAAA;QAEvC,IAAI,CAAC,QAAQ,EAAE,CAAC;YACd,OAAO,CAAC,KAAK,CACX,sCAAsC,MAAM,GAAG,CAChD,CAAA;YACD,OAAM;QACR,CAAC;QAED,yCAAyC;QACzC,+CAA+C;QAC/C,QAAQ,CAAC,aAAa,EAAE,OAAO,CAAC,CAAA;IAClC,CAAC;IAED,0CAA0C;IAC1C,SAAS,KAAK;QACZ,MAAM,CAAC,IAAI,CAAC,YAAY,CAAC,CAAC,OAAO,CAAC,GAAG,CAAC,EAAE;YACrC,aAAyC,CAAC,GAAG,CAAC;gBAC7C,YAAY,CAAC,GAAG,CAAC,CAAA;QACrB,CAAC,CAAC,CAAA;IACJ,CAAC;IAED,OAAO;QACL,KAAK,EAAK,aAAa;QACvB,QAAQ;QACR,KAAK;KACN,CAAA;AACH,CAAC"}

package/packages/state/dist/state/src/ref.d.ts

@@ -0,0 +1,9 @@
+interface DFRef<T> {
+    value: T;
+    readonly initial: T;
+}
+declare function Ref<T>(initialValue: T): DFRef<T>;
+declare function resetRef<T>(ref: DFRef<T>): void;
+export type { DFRef };
+export { Ref, resetRef };
+//# sourceMappingURL=ref.d.ts.map

package/packages/state/dist/state/src/ref.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ref.d.ts","sourceRoot":"","sources":["../../../src/ref.ts"],"names":[],"mappings":"AAOA,UAAU,KAAK,CAAC,CAAC;IACf,KAAK,EAAW,CAAC,CAAA;IACjB,QAAQ,CAAC,OAAO,EAAE,CAAC,CAAA;CACpB;AAID,iBAAS,GAAG,CAAC,CAAC,EAAE,YAAY,EAAE,CAAC,GAAG,KAAK,CAAC,CAAC,CAAC,CAkBzC;AAGD,iBAAS,QAAQ,CAAC,CAAC,EAAE,GAAG,EAAE,KAAK,CAAC,CAAC,CAAC,GAAG,IAAI,CAExC;AAED,YAAY,EAAE,KAAK,EAAE,CAAA;AACrB,OAAO,EAAE,GAAG,EAAE,QAAQ,EAAE,CAAA"}

package/packages/state/dist/state/src/ref.js

@@ -0,0 +1,33 @@
+"use strict";
+// ref.ts
+// A Ref holds a stable value that persists across renders.
+// Changing ref.value NEVER triggers a re-render.
+// Use for timers, element references, previous values.
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.Ref = Ref;
+exports.resetRef = resetRef;
+// Creates a stable non-reactive reference
+// NO Proxy. NO tracking. NO subscriber notification.
+function Ref(initialValue) {
+    // Plain variable — changing this notifies nobody
+    let current = initialValue;
+    return {
+        // Returns current value
+        get value() {
+            return current;
+        },
+        // Updates current value — no re-render triggered
+        set value(newValue) {
+            current = newValue;
+        },
+        // Always returns the original starting value
+        get initial() {
+            return initialValue;
+        }
+    };
+}
+// Resets ref back to its original initial value
+function resetRef(ref) {
+    ref.value = ref.initial;
+}
+//# sourceMappingURL=ref.js.map

package/packages/state/dist/state/src/ref.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"ref.js","sourceRoot":"","sources":["../../../src/ref.ts"],"names":[],"mappings":";AAAA,SAAS;AACT,2DAA2D;AAC3D,iDAAiD;AACjD,uDAAuD;;AAqC9C,kBAAG;AAAE,4BAAQ;AA5BtB,0CAA0C;AAC1C,qDAAqD;AACrD,SAAS,GAAG,CAAI,YAAe;IAC7B,iDAAiD;IACjD,IAAI,OAAO,GAAM,YAAY,CAAA;IAE7B,OAAO;QACL,wBAAwB;QACxB,IAAI,KAAK;YACP,OAAO,OAAO,CAAA;QAChB,CAAC;QACD,iDAAiD;QACjD,IAAI,KAAK,CAAC,QAAW;YACnB,OAAO,GAAG,QAAQ,CAAA;QACpB,CAAC;QACD,6CAA6C;QAC7C,IAAI,OAAO;YACT,OAAO,YAAY,CAAA;QACrB,CAAC;KACF,CAAA;AACH,CAAC;AAED,gDAAgD;AAChD,SAAS,QAAQ,CAAI,GAAa;IAChC,GAAG,CAAC,KAAK,GAAG,GAAG,CAAC,OAAO,CAAA;AACzB,CAAC"}

package/packages/state/dist/state/src/state.d.ts

@@ -0,0 +1,10 @@
+import type { Scheduler } from '../../core/src/scheduler';
+type StateKey = string;
+type Subscriber = () => void;
+type SubscriberMap = Map<StateKey, Set<Subscriber>>;
+declare function setActiveSubscriber(sub: Subscriber | null): void;
+declare function State<T extends Record<string, unknown>>(initialValue: T, scheduler?: Scheduler): T;
+declare function track(subscriber: Subscriber, fn: () => void): void;
+export type { Subscriber, SubscriberMap };
+export { State, track, setActiveSubscriber };
+//# sourceMappingURL=state.d.ts.map

package/packages/state/dist/state/src/state.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"state.d.ts","sourceRoot":"","sources":["../../../src/state.ts"],"names":[],"mappings":"AAOA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,0BAA0B,CAAA;AAIzD,KAAK,QAAQ,GAAG,MAAM,CAAA;AAGtB,KAAK,UAAU,GAAG,MAAM,IAAI,CAAA;AAI5B,KAAK,aAAa,GAAG,GAAG,CAAC,QAAQ,EAAE,GAAG,CAAC,UAAU,CAAC,CAAC,CAAA;AAOnD,iBAAS,mBAAmB,CAAC,GAAG,EAAE,UAAU,GAAG,IAAI,GAAG,IAAI,CAEzD;AAMD,iBAAS,KAAK,CAAC,CAAC,SAAS,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAC9C,YAAY,EAAE,CAAC,EACf,SAAS,CAAC,EAAI,SAAS,GACtB,CAAC,CA+CH;AAID,iBAAS,KAAK,CACZ,UAAU,EAAE,UAAU,EACtB,EAAE,EAAU,MAAM,IAAI,GACrB,IAAI,CAIN;AAED,YAAY,EAAE,UAAU,EAAE,aAAa,EAAE,CAAA;AACzC,OAAO,EAAE,KAAK,EAAE,KAAK,EAAE,mBAAmB,EAAE,CAAA"}

package/packages/state/dist/state/src/state.js

@@ -0,0 +1,70 @@
+"use strict";
+// state.ts
+// The reactive state system for DeskForge.
+// Uses JavaScript Proxy to intercept reads and writes.
+// When you read state — your component is registered as a watcher.
+// When you write state — all watchers are notified and re-render.
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.State = State;
+exports.track = track;
+exports.setActiveSubscriber = setActiveSubscriber;
+const scheduler_1 = require("../../core/src/scheduler");
+const scheduler_2 = require("../../core/src/scheduler");
+// The currently rendering component
+// Any state reads while this is set register as subscribers
+let activeSubscriber = null;
+// Sets the active subscriber during component rendering
+function setActiveSubscriber(sub) {
+    activeSubscriber = sub;
+}
+// Creates a reactive state object from an initial value
+// Mutate properties directly — UI updates automatically
+// Uses JavaScript Proxy to intercept reads and writes
+function State(initialValue, scheduler) {
+    // Create a default scheduler if not provided
+    const finalScheduler = scheduler || (0, scheduler_2.createScheduler)();
+    // Maps each key to the set of components watching it
+    const subscribers = new Map();
+    // Gets or creates the subscriber set for a key
+    function getSubscribers(key) {
+        if (!subscribers.has(key)) {
+            subscribers.set(key, new Set());
+        }
+        return subscribers.get(key);
+    }
+    // Wrap the state object in a Proxy
+    const proxy = new Proxy(initialValue, {
+        // Intercepts every READ of state
+        // If a component is rendering — register it as subscriber
+        get(target, key) {
+            if (activeSubscriber !== null) {
+                getSubscribers(key).add(activeSubscriber);
+            }
+            return target[key];
+        },
+        // Intercepts every WRITE to state
+        // Notifies all subscribers via scheduler
+        set(target, key, value) {
+            const oldValue = target[key];
+            // Skip if value did not actually change
+            if (oldValue === value)
+                return true;
+            // Update the value
+            target[key] = value;
+            // Notify all watchers — batched via scheduler
+            getSubscribers(key).forEach(subscriber => {
+                (0, scheduler_1.schedule)(finalScheduler, subscriber);
+            });
+            return true;
+        }
+    });
+    return proxy;
+}
+// Tracks which state keys a component reads during render
+// Registers component as subscriber for those keys
+function track(subscriber, fn) {
+    setActiveSubscriber(subscriber);
+    fn();
+    setActiveSubscriber(null);
+}
+//# sourceMappingURL=state.js.map

package/packages/state/dist/state/src/state.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"state.js","sourceRoot":"","sources":["../../../src/state.ts"],"names":[],"mappings":";AAAA,WAAW;AACX,2CAA2C;AAC3C,uDAAuD;AACvD,mEAAmE;AACnE,kEAAkE;;AA6FzD,sBAAK;AAAE,sBAAK;AAAE,kDAAmB;AA3F1C,wDAAyD;AAEzD,wDAA0D;AAY1D,oCAAoC;AACpC,4DAA4D;AAC5D,IAAI,gBAAgB,GAAsB,IAAI,CAAA;AAE9C,wDAAwD;AACxD,SAAS,mBAAmB,CAAC,GAAsB;IACjD,gBAAgB,GAAG,GAAG,CAAA;AACxB,CAAC;AAED,wDAAwD;AACxD,wDAAwD;AACxD,sDAAsD;AAEtD,SAAS,KAAK,CACZ,YAAe,EACf,SAAuB;IAEvB,6CAA6C;IAC7C,MAAM,cAAc,GAAG,SAAS,IAAI,IAAA,2BAAe,GAAE,CAAA;IACrD,qDAAqD;IACrD,MAAM,WAAW,GAAkB,IAAI,GAAG,EAAE,CAAA;IAE5C,+CAA+C;IAC/C,SAAS,cAAc,CAAC,GAAa;QACnC,IAAI,CAAC,WAAW,CAAC,GAAG,CAAC,GAAG,CAAC,EAAE,CAAC;YAC1B,WAAW,CAAC,GAAG,CAAC,GAAG,EAAE,IAAI,GAAG,EAAE,CAAC,CAAA;QACjC,CAAC;QACD,OAAO,WAAW,CAAC,GAAG,CAAC,GAAG,CAAE,CAAA;IAC9B,CAAC;IAED,mCAAmC;IACnC,MAAM,KAAK,GAAG,IAAI,KAAK,CAAC,YAAY,EAAE;QAEpC,iCAAiC;QACjC,0DAA0D;QAC1D,GAAG,CAAC,MAAM,EAAE,GAAW;YACrB,IAAI,gBAAgB,KAAK,IAAI,EAAE,CAAC;gBAC9B,cAAc,CAAC,GAAG,CAAC,CAAC,GAAG,CAAC,gBAAgB,CAAC,CAAA;YAC3C,CAAC;YACD,OAAO,MAAM,CAAC,GAAG,CAAC,CAAA;QACpB,CAAC;QAED,kCAAkC;QAClC,yCAAyC;QACzC,GAAG,CAAC,MAAM,EAAE,GAAW,EAAE,KAAc;YACrC,MAAM,QAAQ,GAAG,MAAM,CAAC,GAAG,CAAC,CAAA;YAE5B,wCAAwC;YACxC,IAAI,QAAQ,KAAK,KAAK;gBAAE,OAAO,IAAI,CAAA;YAEnC,mBAAmB;YACnB,MAAM,CAAC,GAAc,CAAC,GAAG,KAAmB,CAAA;YAE5C,8CAA8C;YAC9C,cAAc,CAAC,GAAG,CAAC,CAAC,OAAO,CAAC,UAAU,CAAC,EAAE;gBACvC,IAAA,oBAAQ,EAAC,cAAc,EAAE,UAAU,CAAC,CAAA;YACtC,CAAC,CAAC,CAAA;YAEF,OAAO,IAAI,CAAA;QACb,CAAC;KACF,CAAC,CAAA;IAEF,OAAO,KAAU,CAAA;AACnB,CAAC;AAED,0DAA0D;AAC1D,mDAAmD;AACnD,SAAS,KAAK,CACZ,UAAsB,EACtB,EAAsB;IAEtB,mBAAmB,CAAC,UAAU,CAAC,CAAA;IAC/B,EAAE,EAAE,CAAA;IACJ,mBAAmB,CAAC,IAAI,CAAC,CAAA;AAC3B,CAAC"}

package/packages/state/dist/state/src/store.d.ts

@@ -0,0 +1,19 @@
+type Actions<T> = {
+    [key: string]: (state: T, payload?: unknown) => void;
+};
+interface StoreConfig<T extends Record<string, unknown>> {
+    state: T;
+    actions: Actions<T>;
+    persist?: boolean;
+    persistKey?: string;
+}
+interface DFStore<T extends Record<string, unknown>> {
+    state: T;
+    dispatch: (// call a named action
+    action: string, payload?: unknown) => void;
+    reset: () => void;
+}
+declare function Store<T extends Record<string, unknown>>(config: StoreConfig<T>): DFStore<T>;
+export type { DFStore, StoreConfig, Actions };
+export { Store };
+//# sourceMappingURL=store.d.ts.map

package/packages/state/dist/state/src/store.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"store.d.ts","sourceRoot":"","sources":["../../../src/store.ts"],"names":[],"mappings":"AAUA,KAAK,OAAO,CAAC,CAAC,IAAI;IAChB,CAAC,GAAG,EAAE,MAAM,GAAG,CAAC,KAAK,EAAE,CAAC,EAAE,OAAO,CAAC,EAAE,OAAO,KAAK,IAAI,CAAA;CACrD,CAAA;AAGD,UAAU,WAAW,CAAC,CAAC,SAAS,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC;IACrD,KAAK,EAAO,CAAC,CAAA;IACb,OAAO,EAAK,OAAO,CAAC,CAAC,CAAC,CAAA;IACtB,OAAO,CAAC,EAAI,OAAO,CAAA;IACnB,UAAU,CAAC,EAAE,MAAM,CAAA;CACpB;AAGD,UAAU,OAAO,CAAC,CAAC,SAAS,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC;IACjD,KAAK,EAAK,CAAC,CAAA;IACX,QAAQ,EAAE,CAAc,sBAAsB;IAC5C,MAAM,EAAG,MAAM,EACf,OAAO,CAAC,EAAE,OAAO,KACd,IAAI,CAAA;IACT,KAAK,EAAK,MAAM,IAAI,CAAA;CACrB;AAKD,iBAAS,KAAK,CAAC,CAAC,SAAS,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAC9C,MAAM,EAAE,WAAW,CAAC,CAAC,CAAC,GACrB,OAAO,CAAC,CAAC,CAAC,CAsCZ;AAED,YAAY,EAAE,OAAO,EAAE,WAAW,EAAE,OAAO,EAAE,CAAA;AAC7C,OAAO,EAAE,KAAK,EAAE,CAAA"}

package/packages/state/dist/state/src/store.js

@@ -0,0 +1,42 @@
+"use strict";
+// store.ts
+// Global app-wide reactive state.
+// Accessible from any component without prop drilling.
+// Supports named actions and optional persistence to disk.
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.Store = Store;
+const state_1 = require("./state");
+const scheduler_1 = require("../../core/src/scheduler/scheduler");
+// Creates a global reactive store
+// State is reactive — components re-render on change
+// Actions are the only way to modify state
+function Store(config) {
+    // Each store gets its own scheduler
+    const scheduler = (0, scheduler_1.createScheduler)();
+    // Create reactive state from initial values
+    const reactiveState = (0, state_1.State)({ ...config.state }, scheduler);
+    // Keep a copy of initial state for reset
+    const initialState = { ...config.state };
+    // Calls a named action with optional payload
+    function dispatch(action, payload) {
+        const actionFn = config.actions[action];
+        if (!actionFn) {
+            console.error(`DeskForge Store: unknown action "${action}"`);
+            return;
+        }
+        actionFn(reactiveState, payload);
+    }
+    // Resets all state values back to their initial values
+    function reset() {
+        Object.keys(initialState).forEach(key => {
+            reactiveState[key] =
+                initialState[key];
+        });
+    }
+    return {
+        state: reactiveState,
+        dispatch,
+        reset
+    };
+}
+//# sourceMappingURL=store.js.map

package/packages/state/dist/state/src/store.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"store.js","sourceRoot":"","sources":["../../../src/store.ts"],"names":[],"mappings":";AAAA,WAAW;AACX,kCAAkC;AAClC,uDAAuD;AACvD,2DAA2D;;AA2ElD,sBAAK;AAzEd,mCAAwC;AACxC,kEAAoE;AA0BpE,kCAAkC;AAClC,qDAAqD;AACrD,2CAA2C;AAC3C,SAAS,KAAK,CACZ,MAAsB;IAEtB,oCAAoC;IACpC,MAAM,SAAS,GAAG,IAAA,2BAAe,GAAE,CAAA;IAEnC,4CAA4C;IAC5C,MAAM,aAAa,GAAG,IAAA,aAAK,EACzB,EAAE,GAAG,MAAM,CAAC,KAAK,EAAE,EACnB,SAAS,CACV,CAAA;IAED,yCAAyC;IACzC,MAAM,YAAY,GAAG,EAAE,GAAG,MAAM,CAAC,KAAK,EAAE,CAAA;IAExC,6CAA6C;IAC7C,SAAS,QAAQ,CAAC,MAAc,EAAE,OAAiB;QACjD,MAAM,QAAQ,GAAG,MAAM,CAAC,OAAO,CAAC,MAAM,CAAC,CAAA;QAEvC,IAAI,CAAC,QAAQ,EAAE,CAAC;YACd,OAAO,CAAC,KAAK,CAAC,oCAAoC,MAAM,GAAG,CAAC,CAAA;YAC5D,OAAM;QACR,CAAC;QAED,QAAQ,CAAC,aAAa,EAAE,OAAO,CAAC,CAAA;IAClC,CAAC;IAED,uDAAuD;IACvD,SAAS,KAAK;QACZ,MAAM,CAAC,IAAI,CAAC,YAAY,CAAC,CAAC,OAAO,CAAC,GAAG,CAAC,EAAE;YACrC,aAAyC,CAAC,GAAG,CAAC;gBAC7C,YAAY,CAAC,GAAG,CAAC,CAAA;QACrB,CAAC,CAAC,CAAA;IACJ,CAAC;IAED,OAAO;QACL,KAAK,EAAK,aAAa;QACvB,QAAQ;QACR,KAAK;KACN,CAAA;AACH,CAAC"}

package/packages/state/dist/state/src/watch.d.ts

@@ -0,0 +1,15 @@
+import type { Scheduler } from '../../core/src/scheduler/scheduler';
+type WatchSource<T> = () => T;
+type WatchCallback<T> = (newValue: T, oldValue: T | undefined) => void | (() => void);
+interface WatchHandle {
+    stop(): void;
+    trigger(): void;
+}
+declare function Watch<T>(source: WatchSource<T>, callback: WatchCallback<T>, scheduler: Scheduler): WatchHandle;
+declare namespace Watch {
+    var immediate: <T>(source: WatchSource<T>, callback: WatchCallback<T>, scheduler: Scheduler) => WatchHandle;
+    var once: <T>(source: WatchSource<T>, callback: WatchCallback<T>, scheduler: Scheduler) => WatchHandle;
+}
+export type { WatchHandle, WatchCallback, WatchSource };
+export { Watch };
+//# sourceMappingURL=watch.d.ts.map

package/packages/state/dist/state/src/watch.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"watch.d.ts","sourceRoot":"","sources":["../../../src/watch.ts"],"names":[],"mappings":"AAOA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,oCAAoC,CAAA;AAGnE,KAAK,WAAW,CAAC,CAAC,IAAI,MAAM,CAAC,CAAA;AAI7B,KAAK,aAAa,CAAC,CAAC,IAAI,CACtB,QAAQ,EAAE,CAAC,EACX,QAAQ,EAAE,CAAC,GAAG,SAAS,KACpB,IAAI,GAAG,CAAC,MAAM,IAAI,CAAC,CAAA;AAGxB,UAAU,WAAW;IACnB,IAAI,IAAO,IAAI,CAAA;IACf,OAAO,IAAI,IAAI,CAAA;CAChB;AAuED,iBAAS,KAAK,CAAC,CAAC,EACd,MAAM,EAAK,WAAW,CAAC,CAAC,CAAC,EACzB,QAAQ,EAAG,aAAa,CAAC,CAAC,CAAC,EAC3B,SAAS,EAAE,SAAS,GACnB,WAAW,CAKb;kBATQ,KAAK;oBAYa,CAAC,UACf,WAAW,CAAC,CAAC,CAAC,YACd,aAAa,CAAC,CAAC,CAAC,aAChB,SAAS,KACnB,WAAW;eAQQ,CAAC,UACV,WAAW,CAAC,CAAC,CAAC,YACd,aAAa,CAAC,CAAC,CAAC,aAChB,SAAS,KACnB,WAAW;;AAOd,YAAY,EAAE,WAAW,EAAE,aAAa,EAAE,WAAW,EAAE,CAAA;AACvD,OAAO,EAAE,KAAK,EAAE,CAAA"}

package/packages/state/dist/state/src/watch.js

@@ -0,0 +1,79 @@
+"use strict";
+// watch.ts
+// Watch reacts to specific state value changes.
+// Runs a callback when the watched value changes.
+// Three variants: standard, immediate, once.
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.Watch = Watch;
+const state_1 = require("./state");
+const scheduler_1 = require("../../core/src/scheduler/scheduler");
+// Internal factory for all three Watch variants
+function createWatch(source, callback, scheduler, options) {
+    let oldValue = undefined;
+    let cleanup = undefined;
+    let isStopped = false;
+    // Runs any cleanup from previous callback
+    function runCleanup() {
+        if (cleanup) {
+            cleanup();
+            cleanup = undefined;
+        }
+    }
+    // Runs when a dependency changes
+    // Compares new value to old — fires callback if different
+    const subscriber = () => {
+        if (isStopped)
+            return;
+        let newValue = undefined;
+        (0, state_1.track)(subscriber, () => {
+            newValue = source();
+        });
+        if (newValue !== oldValue) {
+            runCleanup();
+            const result = callback(newValue, oldValue);
+            // If callback returned a function — that is cleanup
+            if (typeof result === 'function') {
+                cleanup = result;
+            }
+            oldValue = newValue;
+            // Stop after first run if once mode
+            if (options.once) {
+                isStopped = true;
+            }
+        }
+    };
+    // Initial read to register dependencies
+    (0, state_1.track)(subscriber, () => {
+        oldValue = source();
+    });
+    // If immediate — run callback right away on first load
+    if (options.immediate) {
+        (0, scheduler_1.schedule)(scheduler, subscriber);
+    }
+    return {
+        stop() { isStopped = true; runCleanup(); },
+        trigger() { (0, scheduler_1.schedule)(scheduler, subscriber); }
+    };
+}
+// Standard Watch — runs when value changes
+function Watch(source, callback, scheduler) {
+    return createWatch(source, callback, scheduler, {
+        immediate: false,
+        once: false
+    });
+}
+// Runs on load AND on every change after that
+Watch.immediate = function (source, callback, scheduler) {
+    return createWatch(source, callback, scheduler, {
+        immediate: true,
+        once: false
+    });
+};
+// Runs exactly one time then stops automatically
+Watch.once = function (source, callback, scheduler) {
+    return createWatch(source, callback, scheduler, {
+        immediate: false,
+        once: true
+    });
+};
+//# sourceMappingURL=watch.js.map

package/packages/state/dist/state/src/watch.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"watch.js","sourceRoot":"","sources":["../../../src/watch.ts"],"names":[],"mappings":";AAAA,WAAW;AACX,gDAAgD;AAChD,kDAAkD;AAClD,6CAA6C;;AA+HpC,sBAAK;AA7Hd,mCAAwC;AACxC,kEAAmE;AAmBnE,gDAAgD;AAChD,SAAS,WAAW,CAClB,MAAyB,EACzB,QAA2B,EAC3B,SAAoB,EACpB,OAGC;IAED,IAAI,QAAQ,GAAyB,SAAS,CAAA;IAC9C,IAAI,OAAO,GAA+B,SAAS,CAAA;IACnD,IAAI,SAAS,GAAwB,KAAK,CAAA;IAE1C,0CAA0C;IAC1C,SAAS,UAAU;QACjB,IAAI,OAAO,EAAE,CAAC;YACZ,OAAO,EAAE,CAAA;YACT,OAAO,GAAG,SAAS,CAAA;QACrB,CAAC;IACH,CAAC;IAED,iCAAiC;IACjC,0DAA0D;IAC1D,MAAM,UAAU,GAAG,GAAS,EAAE;QAC5B,IAAI,SAAS;YAAE,OAAM;QAErB,IAAI,QAAQ,GAAkB,SAAS,CAAA;QAEvC,IAAA,aAAK,EAAC,UAAU,EAAE,GAAG,EAAE;YACrB,QAAQ,GAAG,MAAM,EAAE,CAAA;QACrB,CAAC,CAAC,CAAA;QAEF,IAAI,QAAQ,KAAK,QAAQ,EAAE,CAAC;YAC1B,UAAU,EAAE,CAAA;YAEZ,MAAM,MAAM,GAAG,QAAQ,CAAC,QAAa,EAAE,QAAQ,CAAC,CAAA;YAEhD,oDAAoD;YACpD,IAAI,OAAO,MAAM,KAAK,UAAU,EAAE,CAAC;gBACjC,OAAO,GAAG,MAAM,CAAA;YAClB,CAAC;YAED,QAAQ,GAAG,QAAQ,CAAA;YAEnB,oCAAoC;YACpC,IAAI,OAAO,CAAC,IAAI,EAAE,CAAC;gBACjB,SAAS,GAAG,IAAI,CAAA;YAClB,CAAC;QACH,CAAC;IACH,CAAC,CAAA;IAED,wCAAwC;IACxC,IAAA,aAAK,EAAC,UAAU,EAAE,GAAG,EAAE;QACrB,QAAQ,GAAG,MAAM,EAAE,CAAA;IACrB,CAAC,CAAC,CAAA;IAEF,uDAAuD;IACvD,IAAI,OAAO,CAAC,SAAS,EAAE,CAAC;QACtB,IAAA,oBAAQ,EAAC,SAAS,EAAE,UAAU,CAAC,CAAA;IACjC,CAAC;IAED,OAAO;QACL,IAAI,KAAc,SAAS,GAAG,IAAI,CAAC,CAAC,UAAU,EAAE,CAAA,CAAC,CAAC;QAClD,OAAO,KAAW,IAAA,oBAAQ,EAAC,SAAS,EAAE,UAAU,CAAC,CAAA,CAAC,CAAC;KACpD,CAAA;AACH,CAAC;AAED,2CAA2C;AAC3C,SAAS,KAAK,CACZ,MAAyB,EACzB,QAA2B,EAC3B,SAAoB;IAEpB,OAAO,WAAW,CAAC,MAAM,EAAE,QAAQ,EAAE,SAAS,EAAE;QAC9C,SAAS,EAAE,KAAK;QAChB,IAAI,EAAO,KAAK;KACjB,CAAC,CAAA;AACJ,CAAC;AAED,8CAA8C;AAC9C,KAAK,CAAC,SAAS,GAAG,UAChB,MAAyB,EACzB,QAA2B,EAC3B,SAAoB;IAEpB,OAAO,WAAW,CAAC,MAAM,EAAE,QAAQ,EAAE,SAAS,EAAE;QAC9C,SAAS,EAAE,IAAI;QACf,IAAI,EAAO,KAAK;KACjB,CAAC,CAAA;AACJ,CAAC,CAAA;AAED,iDAAiD;AACjD,KAAK,CAAC,IAAI,GAAG,UACX,MAAyB,EACzB,QAA2B,EAC3B,SAAoB;IAEpB,OAAO,WAAW,CAAC,MAAM,EAAE,QAAQ,EAAE,SAAS,EAAE;QAC9C,SAAS,EAAE,KAAK;QAChB,IAAI,EAAO,IAAI;KAChB,CAAC,CAAA;AACJ,CAAC,CAAA"}

package/packages/state/dist/state.d.ts

@@ -0,0 +1,10 @@
+import type { Scheduler } from '@deskforge/core';
+type StateKey = string;
+type Subscriber = () => void;
+type SubscriberMap = Map<StateKey, Set<Subscriber>>;
+declare function setActiveSubscriber(sub: Subscriber | null): void;
+declare function State<T extends Record<string, unknown>>(initialValue: T, scheduler?: Scheduler): T;
+declare function track(subscriber: Subscriber, fn: () => void): void;
+export type { Subscriber, SubscriberMap };
+export { State, track, setActiveSubscriber };
+//# sourceMappingURL=state.d.ts.map

package/packages/state/dist/state.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"state.d.ts","sourceRoot":"","sources":["../src/state.ts"],"names":[],"mappings":"AAOA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,iBAAiB,CAAA;AAGhD,KAAK,QAAQ,GAAG,MAAM,CAAA;AAGtB,KAAK,UAAU,GAAG,MAAM,IAAI,CAAA;AAI5B,KAAK,aAAa,GAAG,GAAG,CAAC,QAAQ,EAAE,GAAG,CAAC,UAAU,CAAC,CAAC,CAAA;AAOnD,iBAAS,mBAAmB,CAAC,GAAG,EAAE,UAAU,GAAG,IAAI,GAAG,IAAI,CAEzD;AAMD,iBAAS,KAAK,CAAC,CAAC,SAAS,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAC9C,YAAY,EAAE,CAAC,EACf,SAAS,CAAC,EAAI,SAAS,GACtB,CAAC,CA+CH;AAID,iBAAS,KAAK,CACZ,UAAU,EAAE,UAAU,EACtB,EAAE,EAAU,MAAM,IAAI,GACrB,IAAI,CAIN;AAED,YAAY,EAAE,UAAU,EAAE,aAAa,EAAE,CAAA;AACzC,OAAO,EAAE,KAAK,EAAE,KAAK,EAAE,mBAAmB,EAAE,CAAA"}

package/packages/state/dist/state.js

@@ -0,0 +1,69 @@
+"use strict";
+// state.ts
+// The reactive state system for DeskForge.
+// Uses JavaScript Proxy to intercept reads and writes.
+// When you read state — your component is registered as a watcher.
+// When you write state — all watchers are notified and re-render.
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.State = State;
+exports.track = track;
+exports.setActiveSubscriber = setActiveSubscriber;
+const core_1 = require("@deskforge/core");
+// The currently rendering component
+// Any state reads while this is set register as subscribers
+let activeSubscriber = null;
+// Sets the active subscriber during component rendering
+function setActiveSubscriber(sub) {
+    activeSubscriber = sub;
+}
+// Creates a reactive state object from an initial value
+// Mutate properties directly — UI updates automatically
+// Uses JavaScript Proxy to intercept reads and writes
+function State(initialValue, scheduler) {
+    // Create a default scheduler if not provided
+    const finalScheduler = scheduler || (0, core_1.createScheduler)();
+    // Maps each key to the set of components watching it
+    const subscribers = new Map();
+    // Gets or creates the subscriber set for a key
+    function getSubscribers(key) {
+        if (!subscribers.has(key)) {
+            subscribers.set(key, new Set());
+        }
+        return subscribers.get(key);
+    }
+    // Wrap the state object in a Proxy
+    const proxy = new Proxy(initialValue, {
+        // Intercepts every READ of state
+        // If a component is rendering — register it as subscriber
+        get(target, key) {
+            if (activeSubscriber !== null) {
+                getSubscribers(key).add(activeSubscriber);
+            }
+            return target[key];
+        },
+        // Intercepts every WRITE to state
+        // Notifies all subscribers via scheduler
+        set(target, key, value) {
+            const oldValue = target[key];
+            // Skip if value did not actually change
+            if (oldValue === value)
+                return true;
+            // Update the value
+            target[key] = value;
+            // Notify all watchers — batched via scheduler
+            getSubscribers(key).forEach(subscriber => {
+                (0, core_1.schedule)(finalScheduler, subscriber);
+            });
+            return true;
+        }
+    });
+    return proxy;
+}
+// Tracks which state keys a component reads during render
+// Registers component as subscriber for those keys
+function track(subscriber, fn) {
+    setActiveSubscriber(subscriber);
+    fn();
+    setActiveSubscriber(null);
+}
+//# sourceMappingURL=state.js.map

package/packages/state/dist/state.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"state.js","sourceRoot":"","sources":["../src/state.ts"],"names":[],"mappings":";AAAA,WAAW;AACX,2CAA2C;AAC3C,uDAAuD;AACvD,mEAAmE;AACnE,kEAAkE;;AA4FzD,sBAAK;AAAE,sBAAK;AAAE,kDAAmB;AA1F1C,0CAA2D;AAa3D,oCAAoC;AACpC,4DAA4D;AAC5D,IAAI,gBAAgB,GAAsB,IAAI,CAAA;AAE9C,wDAAwD;AACxD,SAAS,mBAAmB,CAAC,GAAsB;IACjD,gBAAgB,GAAG,GAAG,CAAA;AACxB,CAAC;AAED,wDAAwD;AACxD,wDAAwD;AACxD,sDAAsD;AAEtD,SAAS,KAAK,CACZ,YAAe,EACf,SAAuB;IAEvB,6CAA6C;IAC7C,MAAM,cAAc,GAAG,SAAS,IAAI,IAAA,sBAAe,GAAE,CAAA;IACrD,qDAAqD;IACrD,MAAM,WAAW,GAAkB,IAAI,GAAG,EAAE,CAAA;IAE5C,+CAA+C;IAC/C,SAAS,cAAc,CAAC,GAAa;QACnC,IAAI,CAAC,WAAW,CAAC,GAAG,CAAC,GAAG,CAAC,EAAE,CAAC;YAC1B,WAAW,CAAC,GAAG,CAAC,GAAG,EAAE,IAAI,GAAG,EAAE,CAAC,CAAA;QACjC,CAAC;QACD,OAAO,WAAW,CAAC,GAAG,CAAC,GAAG,CAAE,CAAA;IAC9B,CAAC;IAED,mCAAmC;IACnC,MAAM,KAAK,GAAG,IAAI,KAAK,CAAC,YAAY,EAAE;QAEpC,iCAAiC;QACjC,0DAA0D;QAC1D,GAAG,CAAC,MAAM,EAAE,GAAW;YACrB,IAAI,gBAAgB,KAAK,IAAI,EAAE,CAAC;gBAC9B,cAAc,CAAC,GAAG,CAAC,CAAC,GAAG,CAAC,gBAAgB,CAAC,CAAA;YAC3C,CAAC;YACD,OAAO,MAAM,CAAC,GAAG,CAAC,CAAA;QACpB,CAAC;QAED,kCAAkC;QAClC,yCAAyC;QACzC,GAAG,CAAC,MAAM,EAAE,GAAW,EAAE,KAAc;YACrC,MAAM,QAAQ,GAAG,MAAM,CAAC,GAAG,CAAC,CAAA;YAE5B,wCAAwC;YACxC,IAAI,QAAQ,KAAK,KAAK;gBAAE,OAAO,IAAI,CAAA;YAEnC,mBAAmB;YACnB,MAAM,CAAC,GAAc,CAAC,GAAG,KAAmB,CAAA;YAE5C,8CAA8C;YAC9C,cAAc,CAAC,GAAG,CAAC,CAAC,OAAO,CAAC,UAAU,CAAC,EAAE;gBACvC,IAAA,eAAQ,EAAC,cAAc,EAAE,UAAU,CAAC,CAAA;YACtC,CAAC,CAAC,CAAA;YAEF,OAAO,IAAI,CAAA;QACb,CAAC;KACF,CAAC,CAAA;IAEF,OAAO,KAAU,CAAA;AACnB,CAAC;AAED,0DAA0D;AAC1D,mDAAmD;AACnD,SAAS,KAAK,CACZ,UAAsB,EACtB,EAAsB;IAEtB,mBAAmB,CAAC,UAAU,CAAC,CAAA;IAC/B,EAAE,EAAE,CAAA;IACJ,mBAAmB,CAAC,IAAI,CAAC,CAAA;AAC3B,CAAC"}

package/packages/state/dist/store.d.ts

@@ -0,0 +1,19 @@
+type Actions<T> = {
+    [key: string]: (state: T, payload?: unknown) => void;
+};
+interface StoreConfig<T extends Record<string, unknown>> {
+    state: T;
+    actions: Actions<T>;
+    persist?: boolean;
+    persistKey?: string;
+}
+interface DFStore<T extends Record<string, unknown>> {
+    state: T;
+    dispatch: (// call a named action
+    action: string, payload?: unknown) => void;
+    reset: () => void;
+}
+declare function Store<T extends Record<string, unknown>>(config: StoreConfig<T>): DFStore<T>;
+export type { DFStore, StoreConfig, Actions };
+export { Store };
+//# sourceMappingURL=store.d.ts.map

package/packages/state/dist/store.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"store.d.ts","sourceRoot":"","sources":["../src/store.ts"],"names":[],"mappings":"AAUA,KAAK,OAAO,CAAC,CAAC,IAAI;IAChB,CAAC,GAAG,EAAE,MAAM,GAAG,CAAC,KAAK,EAAE,CAAC,EAAE,OAAO,CAAC,EAAE,OAAO,KAAK,IAAI,CAAA;CACrD,CAAA;AAGD,UAAU,WAAW,CAAC,CAAC,SAAS,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC;IACrD,KAAK,EAAO,CAAC,CAAA;IACb,OAAO,EAAK,OAAO,CAAC,CAAC,CAAC,CAAA;IACtB,OAAO,CAAC,EAAI,OAAO,CAAA;IACnB,UAAU,CAAC,EAAE,MAAM,CAAA;CACpB;AAGD,UAAU,OAAO,CAAC,CAAC,SAAS,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC;IACjD,KAAK,EAAK,CAAC,CAAA;IACX,QAAQ,EAAE,CAAc,sBAAsB;IAC5C,MAAM,EAAG,MAAM,EACf,OAAO,CAAC,EAAE,OAAO,KACd,IAAI,CAAA;IACT,KAAK,EAAK,MAAM,IAAI,CAAA;CACrB;AAKD,iBAAS,KAAK,CAAC,CAAC,SAAS,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAC9C,MAAM,EAAE,WAAW,CAAC,CAAC,CAAC,GACrB,OAAO,CAAC,CAAC,CAAC,CAsCZ;AAED,YAAY,EAAE,OAAO,EAAE,WAAW,EAAE,OAAO,EAAE,CAAA;AAC7C,OAAO,EAAE,KAAK,EAAE,CAAA"}

package/packages/state/dist/store.js

@@ -0,0 +1,42 @@
+"use strict";
+// store.ts
+// Global app-wide reactive state.
+// Accessible from any component without prop drilling.
+// Supports named actions and optional persistence to disk.
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.Store = Store;
+const state_1 = require("./state");
+const core_1 = require("@deskforge/core");
+// Creates a global reactive store
+// State is reactive — components re-render on change
+// Actions are the only way to modify state
+function Store(config) {
+    // Each store gets its own scheduler
+    const scheduler = (0, core_1.createScheduler)();
+    // Create reactive state from initial values
+    const reactiveState = (0, state_1.State)({ ...config.state }, scheduler);
+    // Keep a copy of initial state for reset
+    const initialState = { ...config.state };
+    // Calls a named action with optional payload
+    function dispatch(action, payload) {
+        const actionFn = config.actions[action];
+        if (!actionFn) {
+            console.error(`DeskForge Store: unknown action "${action}"`);
+            return;
+        }
+        actionFn(reactiveState, payload);
+    }
+    // Resets all state values back to their initial values
+    function reset() {
+        Object.keys(initialState).forEach(key => {
+            reactiveState[key] =
+                initialState[key];
+        });
+    }
+    return {
+        state: reactiveState,
+        dispatch,
+        reset
+    };
+}
+//# sourceMappingURL=store.js.map

package/packages/state/dist/store.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"store.js","sourceRoot":"","sources":["../src/store.ts"],"names":[],"mappings":";AAAA,WAAW;AACX,kCAAkC;AAClC,uDAAuD;AACvD,2DAA2D;;AA2ElD,sBAAK;AAzEd,mCAAsC;AACtC,0CAAiD;AA0BjD,kCAAkC;AAClC,qDAAqD;AACrD,2CAA2C;AAC3C,SAAS,KAAK,CACZ,MAAsB;IAEtB,oCAAoC;IACpC,MAAM,SAAS,GAAG,IAAA,sBAAe,GAAE,CAAA;IAEnC,4CAA4C;IAC5C,MAAM,aAAa,GAAG,IAAA,aAAK,EACzB,EAAE,GAAG,MAAM,CAAC,KAAK,EAAE,EACnB,SAAS,CACV,CAAA;IAED,yCAAyC;IACzC,MAAM,YAAY,GAAG,EAAE,GAAG,MAAM,CAAC,KAAK,EAAE,CAAA;IAExC,6CAA6C;IAC7C,SAAS,QAAQ,CAAC,MAAc,EAAE,OAAiB;QACjD,MAAM,QAAQ,GAAG,MAAM,CAAC,OAAO,CAAC,MAAM,CAAC,CAAA;QAEvC,IAAI,CAAC,QAAQ,EAAE,CAAC;YACd,OAAO,CAAC,KAAK,CAAC,oCAAoC,MAAM,GAAG,CAAC,CAAA;YAC5D,OAAM;QACR,CAAC;QAED,QAAQ,CAAC,aAAa,EAAE,OAAO,CAAC,CAAA;IAClC,CAAC;IAED,uDAAuD;IACvD,SAAS,KAAK;QACZ,MAAM,CAAC,IAAI,CAAC,YAAY,CAAC,CAAC,OAAO,CAAC,GAAG,CAAC,EAAE;YACrC,aAAyC,CAAC,GAAG,CAAC;gBAC7C,YAAY,CAAC,GAAG,CAAC,CAAA;QACrB,CAAC,CAAC,CAAA;IACJ,CAAC;IAED,OAAO;QACL,KAAK,EAAK,aAAa;QACvB,QAAQ;QACR,KAAK;KACN,CAAA;AACH,CAAC"}

package/packages/state/dist/watch.d.ts

@@ -0,0 +1,15 @@
+import type { Scheduler } from '@deskforge/core';
+type WatchSource<T> = () => T;
+type WatchCallback<T> = (newValue: T, oldValue: T | undefined) => void | (() => void);
+interface WatchHandle {
+    stop(): void;
+    trigger(): void;
+}
+declare function Watch<T>(source: WatchSource<T>, callback: WatchCallback<T>, scheduler: Scheduler): WatchHandle;
+declare namespace Watch {
+    var immediate: <T>(source: WatchSource<T>, callback: WatchCallback<T>, scheduler: Scheduler) => WatchHandle;
+    var once: <T>(source: WatchSource<T>, callback: WatchCallback<T>, scheduler: Scheduler) => WatchHandle;
+}
+export type { WatchHandle, WatchCallback, WatchSource };
+export { Watch };
+//# sourceMappingURL=watch.d.ts.map

package/packages/state/dist/watch.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"watch.d.ts","sourceRoot":"","sources":["../src/watch.ts"],"names":[],"mappings":"AAOA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,iBAAiB,CAAA;AAGhD,KAAK,WAAW,CAAC,CAAC,IAAI,MAAM,CAAC,CAAA;AAI7B,KAAK,aAAa,CAAC,CAAC,IAAI,CACtB,QAAQ,EAAE,CAAC,EACX,QAAQ,EAAE,CAAC,GAAG,SAAS,KACpB,IAAI,GAAG,CAAC,MAAM,IAAI,CAAC,CAAA;AAGxB,UAAU,WAAW;IACnB,IAAI,IAAO,IAAI,CAAA;IACf,OAAO,IAAI,IAAI,CAAA;CAChB;AAuED,iBAAS,KAAK,CAAC,CAAC,EACd,MAAM,EAAK,WAAW,CAAC,CAAC,CAAC,EACzB,QAAQ,EAAG,aAAa,CAAC,CAAC,CAAC,EAC3B,SAAS,EAAE,SAAS,GACnB,WAAW,CAKb;kBATQ,KAAK;oBAYa,CAAC,UACf,WAAW,CAAC,CAAC,CAAC,YACd,aAAa,CAAC,CAAC,CAAC,aAChB,SAAS,KACnB,WAAW;eAQQ,CAAC,UACV,WAAW,CAAC,CAAC,CAAC,YACd,aAAa,CAAC,CAAC,CAAC,aAChB,SAAS,KACnB,WAAW;;AAOd,YAAY,EAAE,WAAW,EAAE,aAAa,EAAE,WAAW,EAAE,CAAA;AACvD,OAAO,EAAE,KAAK,EAAE,CAAA"}

package/packages/state/dist/watch.js

@@ -0,0 +1,79 @@
+"use strict";
+// watch.ts
+// Watch reacts to specific state value changes.
+// Runs a callback when the watched value changes.
+// Three variants: standard, immediate, once.
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.Watch = Watch;
+const state_1 = require("./state");
+const core_1 = require("@deskforge/core");
+// Internal factory for all three Watch variants
+function createWatch(source, callback, scheduler, options) {
+    let oldValue = undefined;
+    let cleanup = undefined;
+    let isStopped = false;
+    // Runs any cleanup from previous callback
+    function runCleanup() {
+        if (cleanup) {
+            cleanup();
+            cleanup = undefined;
+        }
+    }
+    // Runs when a dependency changes
+    // Compares new value to old — fires callback if different
+    const subscriber = () => {
+        if (isStopped)
+            return;
+        let newValue = undefined;
+        (0, state_1.track)(subscriber, () => {
+            newValue = source();
+        });
+        if (newValue !== oldValue) {
+            runCleanup();
+            const result = callback(newValue, oldValue);
+            // If callback returned a function — that is cleanup
+            if (typeof result === 'function') {
+                cleanup = result;
+            }
+            oldValue = newValue;
+            // Stop after first run if once mode
+            if (options.once) {
+                isStopped = true;
+            }
+        }
+    };
+    // Initial read to register dependencies
+    (0, state_1.track)(subscriber, () => {
+        oldValue = source();
+    });
+    // If immediate — run callback right away on first load
+    if (options.immediate) {
+        (0, core_1.schedule)(scheduler, subscriber);
+    }
+    return {
+        stop() { isStopped = true; runCleanup(); },
+        trigger() { (0, core_1.schedule)(scheduler, subscriber); }
+    };
+}
+// Standard Watch — runs when value changes
+function Watch(source, callback, scheduler) {
+    return createWatch(source, callback, scheduler, {
+        immediate: false,
+        once: false
+    });
+}
+// Runs on load AND on every change after that
+Watch.immediate = function (source, callback, scheduler) {
+    return createWatch(source, callback, scheduler, {
+        immediate: true,
+        once: false
+    });
+};
+// Runs exactly one time then stops automatically
+Watch.once = function (source, callback, scheduler) {
+    return createWatch(source, callback, scheduler, {
+        immediate: false,
+        once: true
+    });
+};
+//# sourceMappingURL=watch.js.map

package/packages/state/dist/watch.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"watch.js","sourceRoot":"","sources":["../src/watch.ts"],"names":[],"mappings":";AAAA,WAAW;AACX,gDAAgD;AAChD,kDAAkD;AAClD,6CAA6C;;AA+HpC,sBAAK;AA7Hd,mCAA+B;AAC/B,0CAA0C;AAmB1C,gDAAgD;AAChD,SAAS,WAAW,CAClB,MAAyB,EACzB,QAA2B,EAC3B,SAAoB,EACpB,OAGC;IAED,IAAI,QAAQ,GAAyB,SAAS,CAAA;IAC9C,IAAI,OAAO,GAA+B,SAAS,CAAA;IACnD,IAAI,SAAS,GAAwB,KAAK,CAAA;IAE1C,0CAA0C;IAC1C,SAAS,UAAU;QACjB,IAAI,OAAO,EAAE,CAAC;YACZ,OAAO,EAAE,CAAA;YACT,OAAO,GAAG,SAAS,CAAA;QACrB,CAAC;IACH,CAAC;IAED,iCAAiC;IACjC,0DAA0D;IAC1D,MAAM,UAAU,GAAG,GAAS,EAAE;QAC5B,IAAI,SAAS;YAAE,OAAM;QAErB,IAAI,QAAQ,GAAkB,SAAS,CAAA;QAEvC,IAAA,aAAK,EAAC,UAAU,EAAE,GAAG,EAAE;YACrB,QAAQ,GAAG,MAAM,EAAE,CAAA;QACrB,CAAC,CAAC,CAAA;QAEF,IAAI,QAAQ,KAAK,QAAQ,EAAE,CAAC;YAC1B,UAAU,EAAE,CAAA;YAEZ,MAAM,MAAM,GAAG,QAAQ,CAAC,QAAa,EAAE,QAAQ,CAAC,CAAA;YAEhD,oDAAoD;YACpD,IAAI,OAAO,MAAM,KAAK,UAAU,EAAE,CAAC;gBACjC,OAAO,GAAG,MAAM,CAAA;YAClB,CAAC;YAED,QAAQ,GAAG,QAAQ,CAAA;YAEnB,oCAAoC;YACpC,IAAI,OAAO,CAAC,IAAI,EAAE,CAAC;gBACjB,SAAS,GAAG,IAAI,CAAA;YAClB,CAAC;QACH,CAAC;IACH,CAAC,CAAA;IAED,wCAAwC;IACxC,IAAA,aAAK,EAAC,UAAU,EAAE,GAAG,EAAE;QACrB,QAAQ,GAAG,MAAM,EAAE,CAAA;IACrB,CAAC,CAAC,CAAA;IAEF,uDAAuD;IACvD,IAAI,OAAO,CAAC,SAAS,EAAE,CAAC;QACtB,IAAA,eAAQ,EAAC,SAAS,EAAE,UAAU,CAAC,CAAA;IACjC,CAAC;IAED,OAAO;QACL,IAAI,KAAc,SAAS,GAAG,IAAI,CAAC,CAAC,UAAU,EAAE,CAAA,CAAC,CAAC;QAClD,OAAO,KAAW,IAAA,eAAQ,EAAC,SAAS,EAAE,UAAU,CAAC,CAAA,CAAC,CAAC;KACpD,CAAA;AACH,CAAC;AAED,2CAA2C;AAC3C,SAAS,KAAK,CACZ,MAAyB,EACzB,QAA2B,EAC3B,SAAoB;IAEpB,OAAO,WAAW,CAAC,MAAM,EAAE,QAAQ,EAAE,SAAS,EAAE;QAC9C,SAAS,EAAE,KAAK;QAChB,IAAI,EAAO,KAAK;KACjB,CAAC,CAAA;AACJ,CAAC;AAED,8CAA8C;AAC9C,KAAK,CAAC,SAAS,GAAG,UAChB,MAAyB,EACzB,QAA2B,EAC3B,SAAoB;IAEpB,OAAO,WAAW,CAAC,MAAM,EAAE,QAAQ,EAAE,SAAS,EAAE;QAC9C,SAAS,EAAE,IAAI;QACf,IAAI,EAAO,KAAK;KACjB,CAAC,CAAA;AACJ,CAAC,CAAA;AAED,iDAAiD;AACjD,KAAK,CAAC,IAAI,GAAG,UACX,MAAyB,EACzB,QAA2B,EAC3B,SAAoB;IAEpB,OAAO,WAAW,CAAC,MAAM,EAAE,QAAQ,EAAE,SAAS,EAAE;QAC9C,SAAS,EAAE,KAAK;QAChB,IAAI,EAAO,IAAI;KAChB,CAAC,CAAA;AACJ,CAAC,CAAA"}