@janus-scheduler/counter-core 0.1.0 → 0.1.1

package/dist/CounterCore.d.ts

@@ -0,0 +1,65 @@
+/**
+ * PUBLIC state shape exposed to consumers
+ * Represents a snapshot of the counter state
+ */
+export type CounterState = {
+    count: number;
+};
+/**
+ * Listener function type
+ * - Receives updated state snapshots
+ * - Does not return anything
+ */
+type Listener = (state: CounterState) => void;
+/**
+ * CounterCore
+ * -----------
+ * A framework-agnostic, headless state engine.
+ * Owns counter state and notifies subscribers on changes.
+ */
+export declare class CounterCore {
+    /**
+     * Internal state owned by the core
+     * This should never be mutated directly from outside
+     */
+    private state;
+    /**
+     * Set of subscribers (framework wrappers, consumers)
+     * Each listener is notified when state changes
+     */
+    private listeners;
+    /**
+     * Create a new CounterCore instance
+     * @param initialValue optional starting value (default = 0)
+     */
+    constructor(initialValue?: number);
+    /**
+     * PUBLIC API
+     * Returns a safe snapshot of the current state
+     * (spread used to avoid exposing internal reference)
+     */
+    getState(): CounterState;
+    /**
+     * PUBLIC API
+     * Increment counter value
+     */
+    increment(): void;
+    /**
+     * PUBLIC API
+     * Decrement counter value
+     */
+    decrement(): void;
+    /**
+     * PUBLIC API
+     * Subscribe to state changes
+     * Used by framework wrappers
+     * @returns unsubscribe function
+     */
+    subscribe(listener: Listener): () => void;
+    /**
+     * INTERNAL helper
+     * Emits a snapshot of state to all subscribers
+     */
+    private emit;
+}
+export {};

package/dist/CounterCore.js

@@ -0,0 +1,61 @@
+/**
+ * CounterCore
+ * -----------
+ * A framework-agnostic, headless state engine.
+ * Owns counter state and notifies subscribers on changes.
+ */
+export class CounterCore {
+    /**
+     * Create a new CounterCore instance
+     * @param initialValue optional starting value (default = 0)
+     */
+    constructor(initialValue = 0) {
+        //initialize state and listeners set
+        this.state = { count: initialValue };
+        this.listeners = new Set();
+    }
+    /**
+     * PUBLIC API
+     * Returns a safe snapshot of the current state
+     * (spread used to avoid exposing internal reference)
+     */
+    getState() {
+        return { ...this.state };
+    }
+    /**
+     * PUBLIC API
+     * Increment counter value
+     */
+    increment() {
+        this.state.count += 2;
+        this.emit();
+    }
+    /**
+     * PUBLIC API
+     * Decrement counter value
+     */
+    decrement() {
+        this.state.count -= 1;
+        this.emit();
+    }
+    /**
+     * PUBLIC API
+     * Subscribe to state changes
+     * Used by framework wrappers
+     * @returns unsubscribe function
+     */
+    subscribe(listener) {
+        this.listeners.add(listener);
+        return () => {
+            this.listeners.delete(listener);
+        };
+    }
+    /**
+     * INTERNAL helper
+     * Emits a snapshot of state to all subscribers
+     */
+    emit() {
+        const snapshot = { ...this.state };
+        this.listeners.forEach((listener) => listener(snapshot));
+    }
+}

package/dist/index.d.ts

@@ -0,0 +1 @@
+export * from "./CounterCore";

package/dist/index.js

@@ -0,0 +1 @@
+export * from "./CounterCore";

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@janus-scheduler/counter-core",
-  "version": "0.1.0",
+  "version": "0.1.1",
   "main": "dist/index.cjs",
   "module": "dist/index.js",
   "types": "dist/index.d.ts",