spark-plugs 0.1.0

package/dist/index.d.ts

@@ -0,0 +1,8 @@
+export { plug, type Spark } from "./internals/plug";
+export { Store, createStore, store } from "./internals/store";
+export { engine, type EngineConfig } from "./internals/engine";
+export { fluxCapacitor } from "./internals/fluxCapacitor";
+export { shallow } from "./internals/shallow";
+export { useSpark, type Selector, type SparkValue, } from "./react/hooks/useSpark";
+export { useFluxCapacitor } from "./react/hooks/useFluxCapacitor";
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../spark/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,IAAI,EAAE,KAAK,KAAK,EAAE,MAAM,kBAAkB,CAAC;AACpD,OAAO,EAAE,KAAK,EAAE,WAAW,EAAE,KAAK,EAAE,MAAM,mBAAmB,CAAC;AAC9D,OAAO,EAAE,MAAM,EAAE,KAAK,YAAY,EAAE,MAAM,oBAAoB,CAAC;AAC/D,OAAO,EAAE,aAAa,EAAE,MAAM,2BAA2B,CAAC;AAC1D,OAAO,EAAE,OAAO,EAAE,MAAM,qBAAqB,CAAC;AAE9C,OAAO,EACL,QAAQ,EACR,KAAK,QAAQ,EACb,KAAK,UAAU,GAChB,MAAM,wBAAwB,CAAC;AAChC,OAAO,EAAE,gBAAgB,EAAE,MAAM,gCAAgC,CAAC"}

package/dist/index.js

@@ -0,0 +1,8 @@
+export { plug } from "./internals/plug";
+export { Store, createStore, store } from "./internals/store";
+export { engine } from "./internals/engine";
+export { fluxCapacitor } from "./internals/fluxCapacitor";
+export { shallow } from "./internals/shallow";
+export { useSpark, } from "./react/hooks/useSpark";
+export { useFluxCapacitor } from "./react/hooks/useFluxCapacitor";
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../spark/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,IAAI,EAAc,MAAM,kBAAkB,CAAC;AACpD,OAAO,EAAE,KAAK,EAAE,WAAW,EAAE,KAAK,EAAE,MAAM,mBAAmB,CAAC;AAC9D,OAAO,EAAE,MAAM,EAAqB,MAAM,oBAAoB,CAAC;AAC/D,OAAO,EAAE,aAAa,EAAE,MAAM,2BAA2B,CAAC;AAC1D,OAAO,EAAE,OAAO,EAAE,MAAM,qBAAqB,CAAC;AAE9C,OAAO,EACL,QAAQ,GAGT,MAAM,wBAAwB,CAAC;AAChC,OAAO,EAAE,gBAAgB,EAAE,MAAM,gCAAgC,CAAC"}

package/dist/internals/engine.d.ts

@@ -0,0 +1,15 @@
+import { SparkValue } from "../react/hooks/useSpark";
+import { Spark } from "./plug";
+export interface EngineConfig<T extends Spark<any>[], S> {
+    sparks: [...T];
+    selector: (...args: {
+        [K in keyof T]: SparkValue<T[K]>;
+    }) => S;
+    __isEngineConfig: true;
+}
+export declare function engine<S extends Spark<any>[], // S is inferred as a specific tuple type (e.g., [Spark<string>, Spark<number>])
+R>(sparks: [...S], // Use [...S] to ensure a specific tuple type is inferred
+selector: (...args: {
+    [K in keyof S]: SparkValue<S[K]>;
+}) => R): EngineConfig<S, R>;
+//# sourceMappingURL=engine.d.ts.map

package/dist/internals/engine.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"engine.d.ts","sourceRoot":"","sources":["../../spark/internals/engine.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,UAAU,EAAE,MAAM,yBAAyB,CAAC;AACrD,OAAO,EAAE,KAAK,EAAE,MAAM,QAAQ,CAAC;AAG/B,MAAM,WAAW,YAAY,CAAC,CAAC,SAAS,KAAK,CAAC,GAAG,CAAC,EAAE,EAAE,CAAC;IACrD,MAAM,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC;IACf,QAAQ,EAAE,CAAC,GAAG,IAAI,EAAE;SAAG,CAAC,IAAI,MAAM,CAAC,GAAG,UAAU,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC;KAAE,KAAK,CAAC,CAAC;IAE/D,gBAAgB,EAAE,IAAI,CAAC;CACxB;AAED,wBAAgB,MAAM,CACpB,CAAC,SAAS,KAAK,CAAC,GAAG,CAAC,EAAE,EAAE,gFAAgF;AACxG,CAAC,EAED,MAAM,EAAE,CAAC,GAAG,CAAC,CAAC,EAAE,yDAAyD;AACzE,QAAQ,EAAE,CAER,GAAG,IAAI,EAAE;KAAG,CAAC,IAAI,MAAM,CAAC,GAAG,UAAU,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC;CAAE,KAC1C,CAAC,GACL,YAAY,CAAC,CAAC,EAAE,CAAC,CAAC,CAQpB"}

package/dist/internals/engine.js

@@ -0,0 +1,10 @@
+export function engine(sparks, // Use [...S] to ensure a specific tuple type is inferred
+selector) {
+    // The function returns the strongly typed EngineConfig object
+    return {
+        sparks,
+        selector,
+        __isEngineConfig: true,
+    };
+}
+//# sourceMappingURL=engine.js.map

package/dist/internals/engine.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"engine.js","sourceRoot":"","sources":["../../spark/internals/engine.ts"],"names":[],"mappings":"AAWA,MAAM,UAAU,MAAM,CAIpB,MAAc,EAAE,yDAAyD;AACzE,QAGM;IAEN,8DAA8D;IAE9D,OAAO;QACL,MAAM;QACN,QAAQ;QACR,gBAAgB,EAAE,IAAI;KACd,CAAC;AACb,CAAC"}

package/dist/internals/fluxCapacitor.d.ts

@@ -0,0 +1,16 @@
+import { Spark } from "./plug";
+type StateSnapshot = Record<string, unknown>;
+export declare function fluxCapacitor(plugsToTrack: Spark<any>[]): {
+    engine: import("./engine").EngineConfig<[Spark<StateSnapshot[]>, Spark<number>], {
+        stateHistory: StateSnapshot[];
+        currentIndex: number;
+        canUndo: boolean;
+        canRedo: boolean;
+        setCurrentIndex: (nextIndex: number) => void;
+        resetToDefaultValues: () => void;
+    }>;
+    redo: () => void;
+    undo: () => void;
+};
+export {};
+//# sourceMappingURL=fluxCapacitor.d.ts.map

package/dist/internals/fluxCapacitor.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"fluxCapacitor.d.ts","sourceRoot":"","sources":["../../spark/internals/fluxCapacitor.ts"],"names":[],"mappings":"AACA,OAAO,EAAQ,KAAK,EAAE,MAAM,QAAQ,CAAC;AAErC,KAAK,aAAa,GAAG,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;AAK7C,wBAAgB,aAAa,CAAC,YAAY,EAAE,KAAK,CAAC,GAAG,CAAC,EAAE;;;;;;qCAmElB,MAAM;;;;;EA4B3C"}

package/dist/internals/fluxCapacitor.js

@@ -0,0 +1,75 @@
+import { engine } from "./engine";
+import { plug } from "./plug";
+const historyPlug = plug([]);
+const historyIndexPlug = plug(0);
+export function fluxCapacitor(plugsToTrack) {
+    let isTimeTraveling = false;
+    let initialState = {};
+    plugsToTrack.forEach((p) => {
+        initialState[p.id] = p.store.getStore().get(p);
+    });
+    historyPlug.store.quietlySetState({
+        key: historyPlug,
+        value: [initialState],
+    });
+    const recordCurrentState = () => {
+        if (isTimeTraveling)
+            return;
+        const currentHistory = historyPlug();
+        const currentState = {};
+        plugsToTrack.forEach((p) => {
+            currentState[p.id] = p.store.getStore().get(p);
+        });
+        const nextHistory = [...currentHistory, currentState];
+        historyPlug(nextHistory);
+        historyIndexPlug(currentHistory.length);
+    };
+    plugsToTrack.forEach((p) => p.subscribe(recordCurrentState));
+    const applySnapshot = (index) => {
+        isTimeTraveling = true;
+        const snapshot = historyPlug()[index]; // Type assertion
+        plugsToTrack.forEach((p) => {
+            if (snapshot.hasOwnProperty(p.id)) {
+                p.store.setState({ key: p, value: snapshot[p.id] });
+            }
+        });
+        isTimeTraveling = false;
+    };
+    const undo = () => {
+        const currentIndex = historyIndexPlug();
+        if (currentIndex > 0) {
+            const newIndex = currentIndex - 1;
+            historyIndexPlug(newIndex);
+            applySnapshot(newIndex);
+        }
+    };
+    const redo = () => {
+        const currentIndex = historyIndexPlug();
+        const newIndex = currentIndex + 1;
+        if (currentIndex < historyPlug().length) {
+            historyIndexPlug(newIndex);
+            applySnapshot(newIndex);
+        }
+    };
+    const setCurrentIndex = (nextIndex) => {
+        historyIndexPlug(nextIndex);
+        applySnapshot(nextIndex);
+    };
+    const resetToDefaultValues = () => {
+        historyIndexPlug(0);
+        historyPlug((p) => (p === null || p === void 0 ? void 0 : p[0]) !== undefined ? [p[0]] : []);
+        applySnapshot(0);
+    };
+    const timeTravelStatusEngine = engine([historyPlug, historyIndexPlug], (history, currentIndex) => {
+        return {
+            stateHistory: history,
+            currentIndex,
+            canUndo: currentIndex !== 0,
+            canRedo: currentIndex < history.length - 1,
+            setCurrentIndex,
+            resetToDefaultValues,
+        };
+    });
+    return { engine: timeTravelStatusEngine, redo, undo };
+}
+//# sourceMappingURL=fluxCapacitor.js.map

package/dist/internals/fluxCapacitor.js.map

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

package/dist/internals/plug.d.ts

@@ -0,0 +1,14 @@
+import { Store } from "./store";
+export type PrevStateFunction<T> = (prevState: T) => T;
+export interface Spark<T> {
+    (newValue?: T | PrevStateFunction<T>): T;
+    id: string;
+    store: Store;
+    subscribe: (subscriber: () => void) => () => void;
+    unsubscribe: (subscriber: () => void) => void;
+    quietSet: ({ value }: {
+        value: unknown;
+    }) => void;
+}
+export declare function plug<T>(initialValue?: T): Spark<T>;
+//# sourceMappingURL=plug.d.ts.map

package/dist/internals/plug.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"plug.d.ts","sourceRoot":"","sources":["../../spark/internals/plug.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,KAAK,EAAE,MAAM,SAAS,CAAC;AAEhC,MAAM,MAAM,iBAAiB,CAAC,CAAC,IAAI,CAAC,SAAS,EAAE,CAAC,KAAK,CAAC,CAAC;AAEvD,MAAM,WAAW,KAAK,CAAC,CAAC;IACtB,CAAC,QAAQ,CAAC,EAAE,CAAC,GAAG,iBAAiB,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC;IACzC,EAAE,EAAE,MAAM,CAAC;IACX,KAAK,EAAE,KAAK,CAAC;IACb,SAAS,EAAE,CAAC,UAAU,EAAE,MAAM,IAAI,KAAK,MAAM,IAAI,CAAC;IAClD,WAAW,EAAE,CAAC,UAAU,EAAE,MAAM,IAAI,KAAK,IAAI,CAAC;IAC9C,QAAQ,EAAE,CAAC,EAAE,KAAK,EAAE,EAAE;QAAE,KAAK,EAAE,OAAO,CAAA;KAAE,KAAK,IAAI,CAAC;CACnD;AAED,wBAAgB,IAAI,CAAC,CAAC,EAAE,YAAY,CAAC,EAAE,CAAC,YAkDvC"}

package/dist/internals/plug.js

@@ -0,0 +1,46 @@
+import { Store } from "./store";
+export function plug(initialValue) {
+    const store = new Store();
+    // Use a fallback UUID generator for compatibility
+    function generateUUID() {
+        if (typeof crypto !== "undefined" && crypto.randomUUID) {
+            try {
+                return crypto.randomUUID();
+            }
+            catch (e) {
+                // Fall through to fallback
+            }
+        }
+        // Fallback implementation
+        return "xxxxxxxx-xxxx-4xxx-yxxx-xxxxxxxxxxxx".replace(/[xy]/g, (c) => {
+            const r = (Math.random() * 16) | 0;
+            const v = c === "x" ? r : (r & 0x3) | 0x8;
+            return v.toString(16);
+        });
+    }
+    const stableId = generateUUID();
+    const spark = function (newValue) {
+        const existingStoreValue = store.getStore().get(spark);
+        if (newValue === undefined)
+            return existingStoreValue;
+        const nextState = typeof newValue === "function"
+            ? newValue(existingStoreValue)
+            : newValue;
+        if (!Object.is(nextState, existingStoreValue)) {
+            store.setState({ key: spark, value: nextState });
+        }
+        return existingStoreValue;
+    };
+    spark.id = stableId;
+    spark.store = store;
+    spark.subscribe = store.subscribe;
+    spark.unsubscribe = store.unsubscribe;
+    spark.quietSet = ({ value }) => {
+        store.quietlySetState({ key: spark, value });
+    };
+    if (arguments.length > 0) {
+        store.quietlySetState({ key: spark, value: initialValue });
+    }
+    return spark;
+}
+//# sourceMappingURL=plug.js.map

package/dist/internals/plug.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"plug.js","sourceRoot":"","sources":["../../spark/internals/plug.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,KAAK,EAAE,MAAM,SAAS,CAAC;AAahC,MAAM,UAAU,IAAI,CAAI,YAAgB;IACtC,MAAM,KAAK,GAAG,IAAI,KAAK,EAAE,CAAC;IAC1B,kDAAkD;IAClD,SAAS,YAAY;QACnB,IAAI,OAAO,MAAM,KAAK,WAAW,IAAI,MAAM,CAAC,UAAU,EAAE,CAAC;YACvD,IAAI,CAAC;gBACH,OAAO,MAAM,CAAC,UAAU,EAAE,CAAC;YAC7B,CAAC;YAAC,OAAO,CAAC,EAAE,CAAC;gBACX,2BAA2B;YAC7B,CAAC;QACH,CAAC;QACD,0BAA0B;QAC1B,OAAO,sCAAsC,CAAC,OAAO,CAAC,OAAO,EAAE,CAAC,CAAC,EAAE,EAAE;YACnE,MAAM,CAAC,GAAG,CAAC,IAAI,CAAC,MAAM,EAAE,GAAG,EAAE,CAAC,GAAG,CAAC,CAAC;YACnC,MAAM,CAAC,GAAG,CAAC,KAAK,GAAG,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,GAAG,GAAG,CAAC,GAAG,GAAG,CAAC;YAC1C,OAAO,CAAC,CAAC,QAAQ,CAAC,EAAE,CAAC,CAAC;QACxB,CAAC,CAAC,CAAC;IACL,CAAC;IACD,MAAM,QAAQ,GAAW,YAAY,EAAE,CAAC;IAExC,MAAM,KAAK,GAAa,UAAU,QAAmC;QACnE,MAAM,kBAAkB,GAAG,KAAK,CAAC,QAAQ,EAAE,CAAC,GAAG,CAAC,KAAK,CAAM,CAAC;QAE5D,IAAI,QAAQ,KAAK,SAAS;YAAE,OAAO,kBAAkB,CAAC;QAEtD,MAAM,SAAS,GACb,OAAO,QAAQ,KAAK,UAAU;YAC5B,CAAC,CAAE,QAAiC,CAAC,kBAAkB,CAAC;YACxD,CAAC,CAAC,QAAQ,CAAC;QAEf,IAAI,CAAC,MAAM,CAAC,EAAE,CAAC,SAAS,EAAE,kBAAkB,CAAC,EAAE,CAAC;YAC9C,KAAK,CAAC,QAAQ,CAAC,EAAE,GAAG,EAAE,KAAK,EAAE,KAAK,EAAE,SAAS,EAAE,CAAC,CAAC;QACnD,CAAC;QAED,OAAO,kBAAkB,CAAC;IAC5B,CAAC,CAAC;IAEF,KAAK,CAAC,EAAE,GAAG,QAAQ,CAAC;IACpB,KAAK,CAAC,KAAK,GAAG,KAAK,CAAC;IACpB,KAAK,CAAC,SAAS,GAAG,KAAK,CAAC,SAAS,CAAC;IAClC,KAAK,CAAC,WAAW,GAAG,KAAK,CAAC,WAAW,CAAC;IACtC,KAAK,CAAC,QAAQ,GAAG,CAAC,EAAE,KAAK,EAAE,EAAE,EAAE;QAC7B,KAAK,CAAC,eAAe,CAAC,EAAE,GAAG,EAAE,KAAK,EAAE,KAAK,EAAE,CAAC,CAAC;IAC/C,CAAC,CAAC;IAEF,IAAI,SAAS,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;QACzB,KAAK,CAAC,eAAe,CAAC,EAAE,GAAG,EAAE,KAAK,EAAE,KAAK,EAAE,YAAY,EAAE,CAAC,CAAC;IAC7D,CAAC;IAED,OAAO,KAAK,CAAC;AACf,CAAC"}

package/dist/internals/shallow.d.ts

@@ -0,0 +1,2 @@
+export declare function shallow<T>(valueA: T, valueB: T): boolean;
+//# sourceMappingURL=shallow.d.ts.map

package/dist/internals/shallow.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"shallow.d.ts","sourceRoot":"","sources":["../../spark/internals/shallow.ts"],"names":[],"mappings":"AAgDA,wBAAgB,OAAO,CAAC,CAAC,EAAE,MAAM,EAAE,CAAC,EAAE,MAAM,EAAE,CAAC,GAAG,OAAO,CA0BxD"}

package/dist/internals/shallow.js

@@ -0,0 +1,56 @@
+// File used from Zustand!
+const isIterable = (obj) => Symbol.iterator in obj;
+const hasIterableEntries = (value) => 
+// HACK: avoid checking entries type
+"entries" in value;
+const compareEntries = (valueA, valueB) => {
+    const mapA = valueA instanceof Map ? valueA : new Map(valueA.entries());
+    const mapB = valueB instanceof Map ? valueB : new Map(valueB.entries());
+    if (mapA.size !== mapB.size) {
+        return false;
+    }
+    for (const [key, value] of mapA) {
+        if (!mapB.has(key) || !Object.is(value, mapB.get(key))) {
+            return false;
+        }
+    }
+    return true;
+};
+// Ordered iterables
+const compareIterables = (valueA, valueB) => {
+    const iteratorA = valueA[Symbol.iterator]();
+    const iteratorB = valueB[Symbol.iterator]();
+    let nextA = iteratorA.next();
+    let nextB = iteratorB.next();
+    while (!nextA.done && !nextB.done) {
+        if (!Object.is(nextA.value, nextB.value)) {
+            return false;
+        }
+        nextA = iteratorA.next();
+        nextB = iteratorB.next();
+    }
+    return !!nextA.done && !!nextB.done;
+};
+export function shallow(valueA, valueB) {
+    if (Object.is(valueA, valueB)) {
+        return true;
+    }
+    if (typeof valueA !== "object" ||
+        valueA === null ||
+        typeof valueB !== "object" ||
+        valueB === null) {
+        return false;
+    }
+    if (Object.getPrototypeOf(valueA) !== Object.getPrototypeOf(valueB)) {
+        return false;
+    }
+    if (isIterable(valueA) && isIterable(valueB)) {
+        if (hasIterableEntries(valueA) && hasIterableEntries(valueB)) {
+            return compareEntries(valueA, valueB);
+        }
+        return compareIterables(valueA, valueB);
+    }
+    // assume plain objects
+    return compareEntries({ entries: () => Object.entries(valueA) }, { entries: () => Object.entries(valueB) });
+}
+//# sourceMappingURL=shallow.js.map

package/dist/internals/shallow.js.map

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

package/dist/internals/store.d.ts

@@ -0,0 +1,19 @@
+export declare class Store {
+    store: Map<any, unknown>;
+    subscribers: Set<() => void>;
+    getStore(): Map<any, unknown>;
+    setState({ key, value }: {
+        key: any;
+        value: unknown;
+    }): void;
+    quietlySetState({ key, value }: {
+        key: any;
+        value: unknown;
+    }): void;
+    subscribe: (subscriber: () => void) => () => void;
+    unsubscribe: (subscriber: () => void) => void;
+    clearSubscribers: () => void;
+}
+export declare function createStore(): Store;
+export declare const store: Store;
+//# sourceMappingURL=store.d.ts.map

package/dist/internals/store.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"store.d.ts","sourceRoot":"","sources":["../../spark/internals/store.ts"],"names":[],"mappings":"AAAA,qBAAa,KAAK;IAChB,KAAK,EAAE,GAAG,CAAC,GAAG,EAAE,OAAO,CAAC,CAAa;IACrC,WAAW,EAAE,GAAG,CAAC,MAAM,IAAI,CAAC,CAAa;IAEzC,QAAQ;IAIR,QAAQ,CAAC,EAAE,GAAG,EAAE,KAAK,EAAE,EAAE;QAAE,GAAG,EAAE,GAAG,CAAC;QAAC,KAAK,EAAE,OAAO,CAAA;KAAE;IAMrD,eAAe,CAAC,EAAE,GAAG,EAAE,KAAK,EAAE,EAAE;QAAE,GAAG,EAAE,GAAG,CAAC;QAAC,KAAK,EAAE,OAAO,CAAA;KAAE;IAI5D,SAAS,GAAI,YAAY,MAAM,IAAI,gBAMjC;IAEF,WAAW,GAAI,YAAY,MAAM,IAAI,UAEnC;IAEF,gBAAgB,aAAkC;CACnD;AAED,wBAAgB,WAAW,UAE1B;AAED,eAAO,MAAM,KAAK,OAAgB,CAAC"}

package/dist/internals/store.js

@@ -0,0 +1,31 @@
+export class Store {
+    constructor() {
+        this.store = new Map();
+        this.subscribers = new Set();
+        this.subscribe = (subscriber) => {
+            this.subscribers.add(subscriber);
+            return () => {
+                this.unsubscribe(subscriber);
+            };
+        };
+        this.unsubscribe = (subscriber) => {
+            this.subscribers.delete(subscriber);
+        };
+        this.clearSubscribers = () => this.subscribers.clear();
+    }
+    getStore() {
+        return this.store;
+    }
+    setState({ key, value }) {
+        this.store.set(key, value);
+        this.subscribers.forEach((subscriber) => subscriber());
+    }
+    quietlySetState({ key, value }) {
+        this.store.set(key, value);
+    }
+}
+export function createStore() {
+    return new Store();
+}
+export const store = createStore();
+//# sourceMappingURL=store.js.map

package/dist/internals/store.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"store.js","sourceRoot":"","sources":["../../spark/internals/store.ts"],"names":[],"mappings":"AAAA,MAAM,OAAO,KAAK;IAAlB;QACE,UAAK,GAAsB,IAAI,GAAG,EAAE,CAAC;QACrC,gBAAW,GAAoB,IAAI,GAAG,EAAE,CAAC;QAgBzC,cAAS,GAAG,CAAC,UAAsB,EAAE,EAAE;YACrC,IAAI,CAAC,WAAW,CAAC,GAAG,CAAC,UAAU,CAAC,CAAC;YAEjC,OAAO,GAAG,EAAE;gBACV,IAAI,CAAC,WAAW,CAAC,UAAU,CAAC,CAAC;YAC/B,CAAC,CAAC;QACJ,CAAC,CAAC;QAEF,gBAAW,GAAG,CAAC,UAAsB,EAAE,EAAE;YACvC,IAAI,CAAC,WAAW,CAAC,MAAM,CAAC,UAAU,CAAC,CAAC;QACtC,CAAC,CAAC;QAEF,qBAAgB,GAAG,GAAG,EAAE,CAAC,IAAI,CAAC,WAAW,CAAC,KAAK,EAAE,CAAC;IACpD,CAAC;IA3BC,QAAQ;QACN,OAAO,IAAI,CAAC,KAAK,CAAC;IACpB,CAAC;IAED,QAAQ,CAAC,EAAE,GAAG,EAAE,KAAK,EAAgC;QACnD,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,GAAG,EAAE,KAAK,CAAC,CAAC;QAE3B,IAAI,CAAC,WAAW,CAAC,OAAO,CAAC,CAAC,UAAU,EAAE,EAAE,CAAC,UAAU,EAAE,CAAC,CAAC;IACzD,CAAC;IAED,eAAe,CAAC,EAAE,GAAG,EAAE,KAAK,EAAgC;QAC1D,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,GAAG,EAAE,KAAK,CAAC,CAAC;IAC7B,CAAC;CAeF;AAED,MAAM,UAAU,WAAW;IACzB,OAAO,IAAI,KAAK,EAAE,CAAC;AACrB,CAAC;AAED,MAAM,CAAC,MAAM,KAAK,GAAG,WAAW,EAAE,CAAC"}

package/dist/react/hooks/useFluxCapacitor.d.ts

@@ -0,0 +1,14 @@
+import { fluxCapacitor } from "../../internals/fluxCapacitor";
+export declare function useFluxCapacitor(timeTravelStatusEngine: ReturnType<typeof fluxCapacitor>): {
+    undo: () => void;
+    redo: () => void;
+    stateHistory: {
+        [x: string]: unknown;
+    }[];
+    currentIndex: number;
+    canUndo: boolean;
+    canRedo: boolean;
+    setCurrentIndex: (nextIndex: number) => void;
+    resetToDefaultValues: () => void;
+};
+//# sourceMappingURL=useFluxCapacitor.d.ts.map

package/dist/react/hooks/useFluxCapacitor.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"useFluxCapacitor.d.ts","sourceRoot":"","sources":["../../../spark/react/hooks/useFluxCapacitor.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,aAAa,EAAE,MAAM,+BAA+B,CAAC;AAG9D,wBAAgB,gBAAgB,CAC9B,sBAAsB,EAAE,UAAU,CAAC,OAAO,aAAa,CAAC;;;;;;;;;;;EASzD"}

package/dist/react/hooks/useFluxCapacitor.js

@@ -0,0 +1,6 @@
+import { useSpark } from "./useSpark";
+export function useFluxCapacitor(timeTravelStatusEngine) {
+    const status = useSpark(timeTravelStatusEngine.engine);
+    return Object.assign(Object.assign({}, status), { undo: timeTravelStatusEngine.undo, redo: timeTravelStatusEngine.redo });
+}
+//# sourceMappingURL=useFluxCapacitor.js.map

package/dist/react/hooks/useFluxCapacitor.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"useFluxCapacitor.js","sourceRoot":"","sources":["../../../spark/react/hooks/useFluxCapacitor.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,QAAQ,EAAE,MAAM,YAAY,CAAC;AAEtC,MAAM,UAAU,gBAAgB,CAC9B,sBAAwD;IAExD,MAAM,MAAM,GAAG,QAAQ,CAAC,sBAAsB,CAAC,MAAM,CAAC,CAAC;IAEvD,uCACK,MAAM,KACT,IAAI,EAAE,sBAAsB,CAAC,IAAI,EACjC,IAAI,EAAE,sBAAsB,CAAC,IAAI,IACjC;AACJ,CAAC"}

package/dist/react/hooks/useSpark.d.ts

@@ -0,0 +1,12 @@
+import { EngineConfig } from "../../internals/engine";
+import { Spark } from "../../internals/plug";
+export type Selector<T, S> = (value: T) => S;
+export type SparkValue<S> = S extends Spark<infer T> ? T : never;
+export declare function useSpark<T>(spark: Spark<T>): T;
+export declare function useSpark<T, S>(spark: Spark<T>, selector: Selector<T, S>): S;
+export declare function useSpark<T extends Spark<any>[], R>(config: EngineConfig<T, R>): R;
+export declare function useSpark<S extends Spark<any>[]>(sparks: [...S], selector: (...args: {
+    [K in keyof S]: SparkValue<S[K]>;
+}) => any): any;
+export declare function useSpark<T, S>(sparks: Spark<T>[], selector: (values: T[]) => S): S;
+//# sourceMappingURL=useSpark.d.ts.map

package/dist/react/hooks/useSpark.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"useSpark.d.ts","sourceRoot":"","sources":["../../../spark/react/hooks/useSpark.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,YAAY,EAAE,MAAM,wBAAwB,CAAC;AACtD,OAAO,EAAE,KAAK,EAAE,MAAM,sBAAsB,CAAC;AAG7C,MAAM,MAAM,QAAQ,CAAC,CAAC,EAAE,CAAC,IAAI,CAAC,KAAK,EAAE,CAAC,KAAK,CAAC,CAAC;AAC7C,MAAM,MAAM,UAAU,CAAC,CAAC,IAAI,CAAC,SAAS,KAAK,CAAC,MAAM,CAAC,CAAC,GAAG,CAAC,GAAG,KAAK,CAAC;AAOjE,wBAAgB,QAAQ,CAAC,CAAC,EAAE,KAAK,EAAE,KAAK,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC;AAGhD,wBAAgB,QAAQ,CAAC,CAAC,EAAE,CAAC,EAAE,KAAK,EAAE,KAAK,CAAC,CAAC,CAAC,EAAE,QAAQ,EAAE,QAAQ,CAAC,CAAC,EAAE,CAAC,CAAC,GAAG,CAAC,CAAC;AAG7E,wBAAgB,QAAQ,CAAC,CAAC,SAAS,KAAK,CAAC,GAAG,CAAC,EAAE,EAAE,CAAC,EAChD,MAAM,EAAE,YAAY,CAAC,CAAC,EAAE,CAAC,CAAC,GACzB,CAAC,CAAC;AAGL,wBAAgB,QAAQ,CAAC,CAAC,SAAS,KAAK,CAAC,GAAG,CAAC,EAAE,EAC7C,MAAM,EAAE,CAAC,GAAG,CAAC,CAAC,EACd,QAAQ,EAAE,CAAC,GAAG,IAAI,EAAE;KAAG,CAAC,IAAI,MAAM,CAAC,GAAG,UAAU,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC;CAAE,KAAK,GAAG,GAC/D,GAAG,CAAC;AAGP,wBAAgB,QAAQ,CAAC,CAAC,EAAE,CAAC,EAC3B,MAAM,EAAE,KAAK,CAAC,CAAC,CAAC,EAAE,EAClB,QAAQ,EAAE,CAAC,MAAM,EAAE,CAAC,EAAE,KAAK,CAAC,GAC3B,CAAC,CAAC"}

package/dist/react/hooks/useSpark.js

@@ -0,0 +1,170 @@
+import { useCallback, useRef, useSyncExternalStore } from "react";
+import { shallow } from "../../internals/shallow";
+// Helper function to identify EngineConfig objects
+const isEngineConfig = (val) => val && val.__isEngineConfig === true;
+export function useSpark(input, selector) {
+    // Store the last computed value reference
+    const lastValueRef = useRef(undefined);
+    const activeConfig = isEngineConfig(input)
+        ? input
+        : {
+            sparks: Array.isArray(input) ? input : [input],
+            selector: selector,
+        };
+    const sparksToSubscribe = Array.isArray(activeConfig.sparks)
+        ? activeConfig.sparks
+        : [activeConfig.sparks];
+    const activeSelector = activeConfig.selector;
+    const subscribe = useCallback((subscriber) => {
+        const sparksToUnsubscribe = sparksToSubscribe.map((s) => s.subscribe(subscriber));
+        return () => sparksToUnsubscribe.forEach((sparkToUnsub) => sparkToUnsub());
+    }, [sparksToSubscribe]);
+    const getSnapshot = () => {
+        const values = sparksToSubscribe.map((s) => s.store.getStore().get(s));
+        if (activeSelector) {
+            const newValue = activeSelector(...values);
+            // Compare the *newly computed value* to the *last value*
+            if (Object.is(newValue, lastValueRef.current) ||
+                shallow(newValue, lastValueRef.current)) {
+                return lastValueRef.current; // Return the stable, previous reference
+            }
+            // If they are different references (or different primitives), update cache
+            lastValueRef.current = newValue;
+            return newValue;
+        }
+        else {
+            // Default case (single plug, no selector):
+            // We assume T is stable or handled by the consumer, so we just return the raw value
+            return values[0];
+        }
+    };
+    const storeValue = useSyncExternalStore(subscribe, getSnapshot);
+    return storeValue;
+}
+// --- useSpark Implementation ---
+// export function useSpark(
+//   // We make the implementation signature return 'any' or 'unknown' here because
+//   // TypeScript relies entirely on the overloads above for type checking the consumer code.
+//   input: Spark<any> | Spark<any>[] | EngineConfig<any, any>,
+//   selector?: Function
+// ): any {
+//   // Explicitly set return type to any/unknown in implementation signature
+//   const isEngineConfig = (val: any): val is EngineConfig<any, any> =>
+//     val && val.__isEngineConfig === true;
+//   let sparksToSubscribe: Spark<any>[];
+//   let activeSelector: Function | undefined;
+//   if (isEngineConfig(input)) {
+//     sparksToSubscribe = Array.isArray(input.sparks)
+//       ? input.sparks
+//       : [input.sparks];
+//     activeSelector = input.selector;
+//   } else {
+//     sparksToSubscribe = Array.isArray(input) ? input : [input];
+//     activeSelector = selector;
+//   }
+//   const subscribe = useCallback(
+//     (subscriber: () => void) => {
+//       sparksToSubscribe.forEach((s) => s.subscribe(subscriber));
+//       return () => sparksToSubscribe.forEach((s) => s.unsubscribe(subscriber));
+//     },
+//     [sparksToSubscribe]
+//   );
+//   const getSnapshot = () => {
+//     console.log({ sparksToSubscribe });
+//     const values = sparksToSubscribe.map((s) => s.store.getStore().get(s));
+//     console.log({ values });
+//     if (activeSelector) {
+//       // If we have a selector, return the result of applying it
+//       return activeSelector(...values);
+//     }
+//     // THE FIX: If it was originally a single input and no selector, return the single value (values[0])
+//     // The overloads ensure that if the user calls useSpark(plug), we return T, not an array.
+//     return values[0];
+//   };
+//   const storeValue = useSyncExternalStore(subscribe, getSnapshot);
+//   return storeValue;
+// }
+// Another version
+// import { useCallback, useSyncExternalStore } from "react";
+// import { Spark } from "../../internals/plug";
+// export type Selector<T, S> = (value: T) => S;
+// // Define a utility type to extract the value type T from a Spark<T>
+// export type SparkValue<S> = S extends Spark<infer T> ? T : never;
+// // Define an overload that handles an array of arbitrary Sparks
+// export function useSpark<S extends Spark<any>[]>(
+//   sparks: [...S],
+//   selector: (...args: { [K in keyof S]: SparkValue<S[K]> }) => any // The selector receives arguments matching the tuple types
+// ): any;
+// // Keep the existing single-spark and single-spark-with-selector overloads
+// export function useSpark<T>(spark: Spark<T>): T;
+// export function useSpark<T, S>(spark: Spark<T>, selector: (value: T) => S): S;
+// // Keep the existing all-same-type-array overload
+// export function useSpark<T, S>(
+//   sparks: Spark<T>[],
+//   selector: (values: T[]) => S
+// ): S;
+// // The implementation remains largely the same, but the types align correctly.
+// export function useSpark(
+//   sparkOrSparks: Spark<any> | Spark<any>[],
+//   selector?: Function // Use a generic Function type for the implementation signature
+// ) {
+//   const subscribe = useCallback(
+//     (subscriber: () => void) => {
+//       (Array.isArray(sparkOrSparks) ? sparkOrSparks : [sparkOrSparks]).forEach(
+//         (s) => s.subscribe(subscriber)
+//       );
+//     },
+//     [sparkOrSparks]
+//   ); // Added dependency to subscribe to correctly update when sparks change
+//   const getSnapshot = () => {
+//     const values = (
+//       Array.isArray(sparkOrSparks) ? sparkOrSparks : [sparkOrSparks]
+//     ).map((s) => s.store.getStore().get(s));
+//     // If the original input was a single spark, unwrap the value for selectors
+//     const finalValue = Array.isArray(sparkOrSparks) ? values : values[0];
+//     // Note: The selector expects multiple arguments when `sparkOrSparks` is an array of different types.
+//     if (selector) {
+//       // This is the key change to support your use case:
+//       // The selector is called with arguments spread out only if the input was an array of sparks.
+//       return Array.isArray(sparkOrSparks)
+//         ? selector(...values)
+//         : selector(finalValue);
+//     }
+//     return finalValue;
+//   };
+//   const storeValue = useSyncExternalStore(subscribe, getSnapshot);
+//   return storeValue;
+// }
+//Another version
+// export function useSpark<T>(spark: Spark<T>): T;
+// export function useSpark<T, S>(spark: Spark<T>, selector: Selector<T, S>): S;
+// export function useSpark<T, S>(
+//   sparks: Spark<T>[],
+//   selector: Selector<T[], S>
+// ): S;
+// export function useSpark<T, S>(
+//   spark: Spark<T> | Spark<T>[],
+//   selector?: Selector<T, S>
+// ) {
+//   const subscribe = useCallback((subscriber: () => void) => {
+//     Array.isArray(spark)
+//       ? spark.forEach((s) => s.subscribe(subscriber))
+//       : spark.subscribe(subscriber);
+//   }, []);
+//   const getSnapshot = () => {
+//     const value = Array.isArray(spark)
+//       ? spark.map((s) => s.store.getStore().get(spark) as T)
+//       : (spark.store.getStore().get(spark) as T);
+//     // const value = spark.store.getStore().get(spark) as T;
+//     console.log({ value });
+//     return selector
+//       ? Array.isArray(value)
+//         ? selector(...value)
+//         : selector(value)
+//       : value;
+//   };
+//   const storeValue = useSyncExternalStore(subscribe, getSnapshot);
+//   // const storeValue = useSyncExternalStore(spark.subscribe, getSnapshot);
+//   return storeValue;
+// }
+//# sourceMappingURL=useSpark.js.map

package/dist/react/hooks/useSpark.js.map

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

package/package.json

@@ -0,0 +1,26 @@
+{
+  "name": "spark-plugs",
+  "version": "0.1.0",
+  "description": "A tiny reactive store with React hooks, time travel via a flux capacitor, and a shallow-compare selector engine.",
+  "license": "MIT",
+  "type": "module",
+  "main": "dist/index.js",
+  "module": "dist/index.js",
+  "types": "dist/index.d.ts",
+  "files": [
+    "dist"
+  ],
+  "scripts": {
+    "build": "tsc -p tsconfig.json",
+    "clean": "rm -rf dist",
+    "prepare": "npm run build"
+  },
+  "peerDependencies": {
+    "react": "^18.0.0"
+  },
+  "devDependencies": {
+    "@types/react": "^18.0.0",
+    "typescript": "^5.6.0"
+  }
+}
+