@praxisjs/store 0.1.0

package/CHANGELOG.md

@@ -0,0 +1,12 @@
+# @praxisjs/store
+
+## 0.1.0
+
+### Minor Changes
+
+- aaf7dab: Initial beta release
+
+### Patch Changes
+
+- Updated dependencies [aaf7dab]
+  - @praxisjs/core@0.1.0

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026-present Mateus Martins
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/dist/create-store.d.ts

@@ -0,0 +1,2 @@
+export declare function createStore<T extends Record<string, unknown>>(definition: T & ThisType<T>): () => T;
+//# sourceMappingURL=create-store.d.ts.map

package/dist/create-store.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"create-store.d.ts","sourceRoot":"","sources":["../src/create-store.ts"],"names":[],"mappings":"AAEA,wBAAgB,WAAW,CAAC,CAAC,SAAS,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAC3D,UAAU,EAAE,CAAC,GAAG,QAAQ,CAAC,CAAC,CAAC,WA4D5B"}

package/dist/create-store.js

@@ -0,0 +1,67 @@
+import { signal, effect } from "@praxisjs/core";
+export function createStore(definition) {
+    const initialState = {};
+    const methods = {};
+    for (const [key, value] of Object.entries(definition)) {
+        if (typeof value === "function")
+            methods[key] = value;
+        else
+            initialState[key] = value;
+    }
+    const signals = {};
+    for (const [key, value] of Object.entries(initialState)) {
+        signals[key] = signal(value);
+    }
+    const store = new Proxy({}, {
+        get(_t, key) {
+            if (typeof key !== "string")
+                return undefined;
+            if (key in methods)
+                return (...args) => methods[key].call(store, ...args);
+            if (key === "$subscribe")
+                return subscribe;
+            if (key === "$reset")
+                return reset;
+            if (key === "$patch")
+                return patch;
+            if (key === "$state")
+                return getState;
+            if (key in signals)
+                return signals[key]();
+            const desc = Object.getOwnPropertyDescriptor(definition, key);
+            if (desc?.get)
+                return desc.get.call(store);
+            return undefined;
+        },
+        set(_t, key, value) {
+            if (typeof key !== "string")
+                return false;
+            if (key in signals) {
+                signals[key].set(value);
+                return true;
+            }
+            return false;
+        },
+    });
+    function getState() {
+        const s = {};
+        for (const k of Object.keys(signals))
+            s[k] = signals[k]();
+        return s;
+    }
+    function subscribe(fn) {
+        return effect(() => { fn(getState()); });
+    }
+    function reset() {
+        for (const [k, v] of Object.entries(initialState))
+            signals[k].set(v);
+    }
+    function patch(partial) {
+        for (const [k, v] of Object.entries(partial)) {
+            if (k in signals)
+                signals[k].set(v);
+        }
+    }
+    return () => store;
+}
+//# sourceMappingURL=create-store.js.map

package/dist/create-store.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"create-store.js","sourceRoot":"","sources":["../src/create-store.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,gBAAgB,CAAC;AAEhD,MAAM,UAAU,WAAW,CACzB,UAA2B;IAE3B,MAAM,YAAY,GAA4B,EAAE,CAAC;IACjD,MAAM,OAAO,GAAoD,EAAE,CAAC;IAEpE,KAAK,MAAM,CAAC,GAAG,EAAE,KAAK,CAAC,IAAI,MAAM,CAAC,OAAO,CAAC,UAAU,CAAC,EAAE,CAAC;QACtD,IAAI,OAAO,KAAK,KAAK,UAAU;YAAE,OAAO,CAAC,GAAG,CAAC,GAAG,KAAwC,CAAC;;YACpF,YAAY,CAAC,GAAG,CAAC,GAAG,KAAK,CAAC;IACjC,CAAC;IAED,MAAM,OAAO,GAA8C,EAAE,CAAC;IAC9D,KAAK,MAAM,CAAC,GAAG,EAAE,KAAK,CAAC,IAAI,MAAM,CAAC,OAAO,CAAC,YAAY,CAAC,EAAE,CAAC;QACxD,OAAO,CAAC,GAAG,CAAC,GAAG,MAAM,CAAC,KAAK,CAAC,CAAC;IAC/B,CAAC;IAED,MAAM,KAAK,GAAG,IAAI,KAAK,CAAC,EAAO,EAAE;QAC/B,GAAG,CAAC,EAAE,EAAE,GAAoB;YAC1B,IAAI,OAAO,GAAG,KAAK,QAAQ;gBAAE,OAAO,SAAS,CAAC;YAC9C,IAAI,GAAG,IAAI,OAAO;gBAChB,OAAO,CAAC,GAAG,IAAe,EAAW,EAAE,CAAC,OAAO,CAAC,GAAG,CAAC,CAAC,IAAI,CAAC,KAAK,EAAE,GAAG,IAAI,CAAC,CAAC;YAC5E,IAAI,GAAG,KAAK,YAAY;gBAAE,OAAO,SAAS,CAAC;YAC3C,IAAI,GAAG,KAAK,QAAQ;gBAAE,OAAO,KAAK,CAAC;YACnC,IAAI,GAAG,KAAK,QAAQ;gBAAE,OAAO,KAAK,CAAC;YACnC,IAAI,GAAG,KAAK,QAAQ;gBAAE,OAAO,QAAQ,CAAC;YACtC,IAAI,GAAG,IAAI,OAAO;gBAAE,OAAO,OAAO,CAAC,GAAG,CAAC,EAAE,CAAC;YAC1C,MAAM,IAAI,GAAG,MAAM,CAAC,wBAAwB,CAAC,UAAU,EAAE,GAAG,CAAC,CAAC;YAC9D,IAAI,IAAI,EAAE,GAAG;gBAAE,OAAO,IAAI,CAAC,GAAG,CAAC,IAAI,CAAC,KAAK,CAAY,CAAC;YACtD,OAAO,SAAS,CAAC;QACnB,CAAC;QACD,GAAG,CAAC,EAAE,EAAE,GAAoB,EAAE,KAAc;YAC1C,IAAI,OAAO,GAAG,KAAK,QAAQ;gBAAE,OAAO,KAAK,CAAC;YAC1C,IAAI,GAAG,IAAI,OAAO,EAAE,CAAC;gBACnB,OAAO,CAAC,GAAG,CAAC,CAAC,GAAG,CAAC,KAAK,CAAC,CAAC;gBACxB,OAAO,IAAI,CAAC;YACd,CAAC;YACD,OAAO,KAAK,CAAC;QACf,CAAC;KACF,CAAC,CAAC;IAEH,SAAS,QAAQ;QACf,MAAM,CAAC,GAA4B,EAAE,CAAC;QACtC,KAAK,MAAM,CAAC,IAAI,MAAM,CAAC,IAAI,CAAC,OAAO,CAAC;YAAE,CAAC,CAAC,CAAC,CAAC,GAAG,OAAO,CAAC,CAAC,CAAC,EAAE,CAAC;QAC1D,OAAO,CAAC,CAAC;IACX,CAAC;IAED,SAAS,SAAS,CAAC,EAA4C;QAC7D,OAAO,MAAM,CAAC,GAAG,EAAE,GAAG,EAAE,CAAC,QAAQ,EAAE,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC;IAC3C,CAAC;IAED,SAAS,KAAK;QACZ,KAAK,MAAM,CAAC,CAAC,EAAE,CAAC,CAAC,IAAI,MAAM,CAAC,OAAO,CAAC,YAAY,CAAC;YAAE,OAAO,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC;IACvE,CAAC;IAED,SAAS,KAAK,CAAC,OAAyC;QACtD,KAAK,MAAM,CAAC,CAAC,EAAE,CAAC,CAAC,IAAI,MAAM,CAAC,OAAO,CAAC,OAAO,CAAC,EAAE,CAAC;YAC7C,IAAI,CAAC,IAAI,OAAO;gBAAE,OAAO,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC;QACtC,CAAC;IACH,CAAC;IAED,OAAO,GAAG,EAAE,CAAC,KAAK,CAAC;AACrB,CAAC"}

package/dist/decorators.d.ts

@@ -0,0 +1,3 @@
+export declare function Store(): <T extends new (...args: unknown[]) => unknown>(constructor: T) => T;
+export declare function UseStore(StoreConstructor: new () => unknown): (target: object, propertyKey: string | symbol) => void;
+//# sourceMappingURL=decorators.d.ts.map

package/dist/decorators.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"decorators.d.ts","sourceRoot":"","sources":["../src/decorators.ts"],"names":[],"mappings":"AAEA,wBAAgB,KAAK,KACF,CAAC,SAAS,KAAK,GAAG,IAAI,EAAE,OAAO,EAAE,KAAK,OAAO,EAAE,aAAa,CAAC,KAAG,CAAC,CAInF;AAED,wBAAgB,QAAQ,CAAC,gBAAgB,EAAE,UAAU,OAAO,IAGzC,QAAQ,MAAM,EAAE,aAAa,MAAM,GAAG,MAAM,KAAG,IAAI,CAkBrE"}

package/dist/decorators.js

@@ -0,0 +1,27 @@
+const storeRegistry = new Map();
+export function Store() {
+    return function (constructor) {
+        storeRegistry.set(constructor, null);
+        return constructor;
+    };
+}
+export function UseStore(StoreConstructor) {
+    const cache = new WeakMap();
+    return function (target, propertyKey) {
+        Object.defineProperty(target, propertyKey, {
+            get() {
+                if (!cache.has(this)) {
+                    if (!storeRegistry.has(StoreConstructor) ||
+                        storeRegistry.get(StoreConstructor) === null) {
+                        storeRegistry.set(StoreConstructor, new StoreConstructor());
+                    }
+                    cache.set(this, storeRegistry.get(StoreConstructor));
+                }
+                return cache.get(this);
+            },
+            enumerable: true,
+            configurable: true,
+        });
+    };
+}
+//# sourceMappingURL=decorators.js.map

package/dist/decorators.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"decorators.js","sourceRoot":"","sources":["../src/decorators.ts"],"names":[],"mappings":"AAAA,MAAM,aAAa,GAAG,IAAI,GAAG,EAAgD,CAAC;AAE9E,MAAM,UAAU,KAAK;IACnB,OAAO,UAAyD,WAAc;QAC5E,aAAa,CAAC,GAAG,CAAC,WAAW,EAAE,IAAI,CAAC,CAAC;QACrC,OAAO,WAAW,CAAC;IACrB,CAAC,CAAC;AACJ,CAAC;AAED,MAAM,UAAU,QAAQ,CAAC,gBAAmC;IAC1D,MAAM,KAAK,GAAG,IAAI,OAAO,EAAmB,CAAC;IAE7C,OAAO,UAAU,MAAc,EAAE,WAA4B;QAC3D,MAAM,CAAC,cAAc,CAAC,MAAM,EAAE,WAAW,EAAE;YACzC,GAAG;gBACD,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,IAAI,CAAC,EAAE,CAAC;oBACrB,IACE,CAAC,aAAa,CAAC,GAAG,CAAC,gBAAgB,CAAC;wBACpC,aAAa,CAAC,GAAG,CAAC,gBAAgB,CAAC,KAAK,IAAI,EAC5C,CAAC;wBACD,aAAa,CAAC,GAAG,CAAC,gBAAgB,EAAE,IAAI,gBAAgB,EAAE,CAAC,CAAC;oBAC9D,CAAC;oBACD,KAAK,CAAC,GAAG,CAAC,IAAI,EAAE,aAAa,CAAC,GAAG,CAAC,gBAAgB,CAAC,CAAC,CAAC;gBACvD,CAAC;gBACD,OAAO,KAAK,CAAC,GAAG,CAAC,IAAI,CAAC,CAAC;YACzB,CAAC;YACD,UAAU,EAAE,IAAI;YAChB,YAAY,EAAE,IAAI;SACnB,CAAC,CAAC;IACL,CAAC,CAAC;AACJ,CAAC"}

package/dist/index.d.ts

@@ -0,0 +1,3 @@
+export { createStore } from "./create-store";
+export { Store, UseStore } from "./decorators";
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,WAAW,EAAE,MAAM,gBAAgB,CAAC;AAC7C,OAAO,EAAE,KAAK,EAAE,QAAQ,EAAE,MAAM,cAAc,CAAC"}

package/dist/index.js

@@ -0,0 +1,3 @@
+export { createStore } from "./create-store";
+export { Store, UseStore } from "./decorators";
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,WAAW,EAAE,MAAM,gBAAgB,CAAC;AAC7C,OAAO,EAAE,KAAK,EAAE,QAAQ,EAAE,MAAM,cAAc,CAAC"}

package/package.json

@@ -0,0 +1,23 @@
+{
+  "name": "@praxisjs/store",
+  "version": "0.1.0",
+  "type": "module",
+  "main": "./dist/index.js",
+  "types": "./dist/index.d.ts",
+  "exports": {
+    ".": {
+      "import": "./dist/index.js",
+      "types": "./dist/index.d.ts"
+    }
+  },
+  "devDependencies": {
+    "typescript": "^5.9.3"
+  },
+  "dependencies": {
+    "@praxisjs/core": "0.1.0"
+  },
+  "scripts": {
+    "build": "tsc",
+    "dev": "tsc --watch"
+  }
+}

package/src/create-store.ts

@@ -0,0 +1,64 @@
+import { signal, effect } from "@praxisjs/core";
+
+export function createStore<T extends Record<string, unknown>>(
+  definition: T & ThisType<T>,
+) {
+  const initialState: Record<string, unknown> = {};
+  const methods: Record<string, (...args: unknown[]) => unknown> = {};
+
+  for (const [key, value] of Object.entries(definition)) {
+    if (typeof value === "function") methods[key] = value as (...args: unknown[]) => unknown;
+    else initialState[key] = value;
+  }
+
+  const signals: Record<string, ReturnType<typeof signal>> = {};
+  for (const [key, value] of Object.entries(initialState)) {
+    signals[key] = signal(value);
+  }
+
+  const store = new Proxy({} as T, {
+    get(_t, key: string | symbol) {
+      if (typeof key !== "string") return undefined;
+      if (key in methods)
+        return (...args: unknown[]): unknown => methods[key].call(store, ...args);
+      if (key === "$subscribe") return subscribe;
+      if (key === "$reset") return reset;
+      if (key === "$patch") return patch;
+      if (key === "$state") return getState;
+      if (key in signals) return signals[key]();
+      const desc = Object.getOwnPropertyDescriptor(definition, key);
+      if (desc?.get) return desc.get.call(store) as unknown;
+      return undefined;
+    },
+    set(_t, key: string | symbol, value: unknown) {
+      if (typeof key !== "string") return false;
+      if (key in signals) {
+        signals[key].set(value);
+        return true;
+      }
+      return false;
+    },
+  });
+
+  function getState(): Record<string, unknown> {
+    const s: Record<string, unknown> = {};
+    for (const k of Object.keys(signals)) s[k] = signals[k]();
+    return s;
+  }
+
+  function subscribe(fn: (state: Record<string, unknown>) => void): () => void {
+    return effect(() => { fn(getState()); });
+  }
+
+  function reset(): void {
+    for (const [k, v] of Object.entries(initialState)) signals[k].set(v);
+  }
+
+  function patch(partial: Partial<Record<string, unknown>>): void {
+    for (const [k, v] of Object.entries(partial)) {
+      if (k in signals) signals[k].set(v);
+    }
+  }
+
+  return () => store;
+}

package/src/decorators.ts

@@ -0,0 +1,31 @@
+const storeRegistry = new Map<new (...args: unknown[]) => unknown, unknown>();
+
+export function Store() {
+  return function <T extends new (...args: unknown[]) => unknown>(constructor: T): T {
+    storeRegistry.set(constructor, null);
+    return constructor;
+  };
+}
+
+export function UseStore(StoreConstructor: new () => unknown) {
+  const cache = new WeakMap<object, unknown>();
+
+  return function (target: object, propertyKey: string | symbol): void {
+    Object.defineProperty(target, propertyKey, {
+      get(this: object): unknown {
+        if (!cache.has(this)) {
+          if (
+            !storeRegistry.has(StoreConstructor) ||
+            storeRegistry.get(StoreConstructor) === null
+          ) {
+            storeRegistry.set(StoreConstructor, new StoreConstructor());
+          }
+          cache.set(this, storeRegistry.get(StoreConstructor));
+        }
+        return cache.get(this);
+      },
+      enumerable: true,
+      configurable: true,
+    });
+  };
+}

package/src/index.ts

@@ -0,0 +1,2 @@
+export { createStore } from "./create-store";
+export { Store, UseStore } from "./decorators";

package/tsconfig.json

@@ -0,0 +1,8 @@
+{
+  "extends": "../../../tsconfig.base.json",
+  "compilerOptions": {
+    "outDir": "./dist",
+    "rootDir": "./src"
+  },
+  "include": ["src"]
+}