@praxisjs/decorators 0.1.0 → 0.2.0

package/CHANGELOG.md

@@ -1,5 +1,23 @@
 # @praxisjs/decorators
 
+## 0.2.0
+
+### Minor Changes
+
+- f48dbc4: Introduce WithHistory<T, K> utility type for better TypeScript inference when using the @History decorator, and fix performance issues in the history() primitive.
+
+  Changes:
+
+  @praxisjs/decorators: Added WithHistory<T, K> type that maps a property key to its corresponding \*History accessor type, enabling proper type-checking on decorated classes.
+  @praxisjs/decorators: Simplified @History decorator internals — replaced verbose getOwnPropertyDescriptor lookups with direct property access (this[propertyKey]), reducing complexity.
+  @praxisjs/core: Fixed history() to use peek() when reading \_past and \_current inside the tracking effect, preventing unnecessary re-runs caused by reactive reads during history recording.
+  @praxisjs/core: Added an \_initialized guard so the first value is captured without pushing an empty entry into the past stack.
+
+### Patch Changes
+
+- Updated dependencies [f48dbc4]
+  - @praxisjs/core@0.2.0
+
 ## 0.1.0
 
 ### Minor Changes

package/dist/index.d.ts

@@ -1,5 +1,5 @@
 export { Component, Memoize, Lazy, Virtual } from "./component";
 export { Memo, Bind, Log, Once, Retry, Debounce, Throttle, When, Watch, type WatchVal, type WatchVals, } from "./functions";
-export { Prop, State, Persisted, Slot, initSlots, History } from "./properties";
+export { Prop, State, Persisted, Slot, initSlots, History, type WithHistory } from "./properties";
 export { type Command, createCommand, Emit, OnCommand } from "./events";
 //# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,SAAS,EAAE,OAAO,EAAE,IAAI,EAAE,OAAO,EAAE,MAAM,aAAa,CAAC;AAChE,OAAO,EACL,IAAI,EACJ,IAAI,EACJ,GAAG,EACH,IAAI,EACJ,KAAK,EACL,QAAQ,EACR,QAAQ,EACR,IAAI,EACJ,KAAK,EACL,KAAK,QAAQ,EACb,KAAK,SAAS,GACf,MAAM,aAAa,CAAC;AACrB,OAAO,EAAE,IAAI,EAAE,KAAK,EAAE,SAAS,EAAE,IAAI,EAAE,SAAS,EAAE,OAAO,EAAE,MAAM,cAAc,CAAC;AAChF,OAAO,EAAE,KAAK,OAAO,EAAE,aAAa,EAAE,IAAI,EAAE,SAAS,EAAE,MAAM,UAAU,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,SAAS,EAAE,OAAO,EAAE,IAAI,EAAE,OAAO,EAAE,MAAM,aAAa,CAAC;AAChE,OAAO,EACL,IAAI,EACJ,IAAI,EACJ,GAAG,EACH,IAAI,EACJ,KAAK,EACL,QAAQ,EACR,QAAQ,EACR,IAAI,EACJ,KAAK,EACL,KAAK,QAAQ,EACb,KAAK,SAAS,GACf,MAAM,aAAa,CAAC;AACrB,OAAO,EAAE,IAAI,EAAE,KAAK,EAAE,SAAS,EAAE,IAAI,EAAE,SAAS,EAAE,OAAO,EAAE,KAAK,WAAW,EAAE,MAAM,cAAc,CAAC;AAClG,OAAO,EAAE,KAAK,OAAO,EAAE,aAAa,EAAE,IAAI,EAAE,SAAS,EAAE,MAAM,UAAU,CAAC"}

package/dist/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,SAAS,EAAE,OAAO,EAAE,IAAI,EAAE,OAAO,EAAE,MAAM,aAAa,CAAC;AAChE,OAAO,EACL,IAAI,EACJ,IAAI,EACJ,GAAG,EACH,IAAI,EACJ,KAAK,EACL,QAAQ,EACR,QAAQ,EACR,IAAI,EACJ,KAAK,GAGN,MAAM,aAAa,CAAC;AACrB,OAAO,EAAE,IAAI,EAAE,KAAK,EAAE,SAAS,EAAE,IAAI,EAAE,SAAS,EAAE,OAAO,EAAE,MAAM,cAAc,CAAC;AAChF,OAAO,EAAgB,aAAa,EAAE,IAAI,EAAE,SAAS,EAAE,MAAM,UAAU,CAAC"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,SAAS,EAAE,OAAO,EAAE,IAAI,EAAE,OAAO,EAAE,MAAM,aAAa,CAAC;AAChE,OAAO,EACL,IAAI,EACJ,IAAI,EACJ,GAAG,EACH,IAAI,EACJ,KAAK,EACL,QAAQ,EACR,QAAQ,EACR,IAAI,EACJ,KAAK,GAGN,MAAM,aAAa,CAAC;AACrB,OAAO,EAAE,IAAI,EAAE,KAAK,EAAE,SAAS,EAAE,IAAI,EAAE,SAAS,EAAE,OAAO,EAAoB,MAAM,cAAc,CAAC;AAClG,OAAO,EAAgB,aAAa,EAAE,IAAI,EAAE,SAAS,EAAE,MAAM,UAAU,CAAC"}

package/dist/properties/history.d.ts

@@ -1,2 +1,4 @@
+import { type HistoryElement } from "@praxisjs/core";
+export type WithHistory<T, K extends keyof T> = Record<`${string & K}History`, HistoryElement<T[K]>>;
 export declare function History(limit?: number): (target: object, propertyKey: string) => void;
 //# sourceMappingURL=history.d.ts.map

package/dist/properties/history.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"history.d.ts","sourceRoot":"","sources":["../../src/properties/history.ts"],"names":[],"mappings":"AAEA,wBAAgB,OAAO,CAAC,KAAK,SAAK,IACf,QAAQ,MAAM,EAAE,aAAa,MAAM,KAAG,IAAI,CA0D5D"}
+{"version":3,"file":"history.d.ts","sourceRoot":"","sources":["../../src/properties/history.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,KAAK,cAAc,EAAW,MAAM,gBAAgB,CAAC;AAE9D,MAAM,MAAM,WAAW,CAAC,CAAC,EAAE,CAAC,SAAS,MAAM,CAAC,IAAI,MAAM,CAAC,GAAG,MAAM,GAAG,CAAC,SAAS,EAAE,cAAc,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC;AAErG,wBAAgB,OAAO,CAAC,KAAK,SAAK,IACf,QAAQ,MAAM,EAAE,aAAa,MAAM,KAAG,IAAI,CAkC5D"}

package/dist/properties/history.js

@@ -3,15 +3,10 @@ export function History(limit = 50) {
     return function (target, propertyKey) {
         const historyKey = `${propertyKey}History`;
         const histories = new WeakMap();
-        const originalDescriptor = Object.getOwnPropertyDescriptor(target, propertyKey);
         Object.defineProperty(target, historyKey, {
             get() {
                 if (!histories.has(this)) {
-                    const source = () => {
-                        const desc = Object.getOwnPropertyDescriptor(this, propertyKey) ??
-                            Object.getOwnPropertyDescriptor(Object.getPrototypeOf(this), propertyKey);
-                        return desc?.get?.call(this);
-                    };
+                    const source = () => this[propertyKey];
                     const h = history(source, limit);
                     const originalUndo = () => { h.undo(); };
                     const originalRedo = () => { h.redo(); };
@@ -20,12 +15,11 @@ export function History(limit = 50) {
                         if (prev === undefined)
                             return;
                         originalUndo();
-                        (Object.getOwnPropertyDescriptor(Object.getPrototypeOf(this), propertyKey) ?? originalDescriptor)?.set?.call(this, prev);
+                        this[propertyKey] = prev;
                     };
                     h.redo = () => {
                         originalRedo();
-                        const next = h.current();
-                        (Object.getOwnPropertyDescriptor(Object.getPrototypeOf(this), propertyKey) ?? originalDescriptor)?.set?.call(this, next);
+                        this[propertyKey] = h.current();
                     };
                     histories.set(this, h);
                 }

package/dist/properties/history.js.map

@@ -1 +1 @@
-{"version":3,"file":"history.js","sourceRoot":"","sources":["../../src/properties/history.ts"],"names":[],"mappings":"AAAA,OAAO,EAAuB,OAAO,EAAE,MAAM,gBAAgB,CAAC;AAE9D,MAAM,UAAU,OAAO,CAAC,KAAK,GAAG,EAAE;IAChC,OAAO,UAAU,MAAc,EAAE,WAAmB;QAClD,MAAM,UAAU,GAAG,GAAG,WAAW,SAAS,CAAC;QAC3C,MAAM,SAAS,GAAG,IAAI,OAAO,EAAmC,CAAC;QAEjE,MAAM,kBAAkB,GAAG,MAAM,CAAC,wBAAwB,CACxD,MAAM,EACN,WAAW,CACZ,CAAC;QAEF,MAAM,CAAC,cAAc,CAAC,MAAM,EAAE,UAAU,EAAE;YACxC,GAAG;gBACD,IAAI,CAAC,SAAS,CAAC,GAAG,CAAC,IAAI,CAAC,EAAE,CAAC;oBACzB,MAAM,MAAM,GAAG,GAAG,EAAE;wBAClB,MAAM,IAAI,GACR,MAAM,CAAC,wBAAwB,CAAC,IAAI,EAAE,WAAW,CAAC;4BAClD,MAAM,CAAC,wBAAwB,CAC7B,MAAM,CAAC,cAAc,CAAC,IAAI,CAAC,EAC3B,WAAW,CACZ,CAAC;wBACJ,OAAO,IAAI,EAAE,GAAG,EAAE,IAAI,CAAC,IAAI,CAAY,CAAC;oBAC1C,CAAC,CAAC;oBAEF,MAAM,CAAC,GAAG,OAAO,CAAC,MAAuB,EAAE,KAAK,CAAC,CAAC;oBAElD,MAAM,YAAY,GAAG,GAAG,EAAE,GAAG,CAAC,CAAC,IAAI,EAAE,CAAC,CAAC,CAAC,CAAC;oBACzC,MAAM,YAAY,GAAG,GAAG,EAAE,GAAG,CAAC,CAAC,IAAI,EAAE,CAAC,CAAC,CAAC,CAAC;oBAEzC,CAAC,CAAC,IAAI,GAAG,GAAG,EAAE;wBACZ,MAAM,IAAI,GAAG,CAAC,CAAC,MAAM,EAAE,CAAC,CAAC,CAAC,MAAM,EAAE,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC;wBAC/C,IAAI,IAAI,KAAK,SAAS;4BAAE,OAAO;wBAC/B,YAAY,EAAE,CAAC;wBACf,CACE,MAAM,CAAC,wBAAwB,CAC7B,MAAM,CAAC,cAAc,CAAC,IAAI,CAAC,EAC3B,WAAW,CACZ,IAAI,kBAAkB,CACxB,EAAE,GAAG,EAAE,IAAI,CAAC,IAAI,EAAE,IAAI,CAAC,CAAC;oBAC3B,CAAC,CAAC;oBAEF,CAAC,CAAC,IAAI,GAAG,GAAG,EAAE;wBACZ,YAAY,EAAE,CAAC;wBACf,MAAM,IAAI,GAAG,CAAC,CAAC,OAAO,EAAE,CAAC;wBACzB,CACE,MAAM,CAAC,wBAAwB,CAC7B,MAAM,CAAC,cAAc,CAAC,IAAI,CAAC,EAC3B,WAAW,CACZ,IAAI,kBAAkB,CACxB,EAAE,GAAG,EAAE,IAAI,CAAC,IAAI,EAAE,IAAI,CAAC,CAAC;oBAC3B,CAAC,CAAC;oBAEF,SAAS,CAAC,GAAG,CAAC,IAAI,EAAE,CAAC,CAAC,CAAC;gBACzB,CAAC;gBACD,OAAO,SAAS,CAAC,GAAG,CAAC,IAAI,CAA4B,CAAC;YACxD,CAAC;YACD,UAAU,EAAE,KAAK;YACjB,YAAY,EAAE,IAAI;SACnB,CAAC,CAAC;IACL,CAAC,CAAC;AACJ,CAAC"}
+{"version":3,"file":"history.js","sourceRoot":"","sources":["../../src/properties/history.ts"],"names":[],"mappings":"AAAA,OAAO,EAAuB,OAAO,EAAE,MAAM,gBAAgB,CAAC;AAI9D,MAAM,UAAU,OAAO,CAAC,KAAK,GAAG,EAAE;IAChC,OAAO,UAAU,MAAc,EAAE,WAAmB;QAClD,MAAM,UAAU,GAAG,GAAG,WAAW,SAAS,CAAC;QAC3C,MAAM,SAAS,GAAG,IAAI,OAAO,EAAmC,CAAC;QAEjE,MAAM,CAAC,cAAc,CAAC,MAAM,EAAE,UAAU,EAAE;YACxC,GAAG;gBACD,IAAI,CAAC,SAAS,CAAC,GAAG,CAAC,IAAI,CAAC,EAAE,CAAC;oBACzB,MAAM,MAAM,GAAG,GAAG,EAAE,CAAC,IAAI,CAAC,WAAW,CAAC,CAAC;oBAEvC,MAAM,CAAC,GAAG,OAAO,CAAC,MAAuB,EAAE,KAAK,CAAC,CAAC;oBAElD,MAAM,YAAY,GAAG,GAAG,EAAE,GAAG,CAAC,CAAC,IAAI,EAAE,CAAC,CAAC,CAAC,CAAC;oBACzC,MAAM,YAAY,GAAG,GAAG,EAAE,GAAG,CAAC,CAAC,IAAI,EAAE,CAAC,CAAC,CAAC,CAAC;oBAEzC,CAAC,CAAC,IAAI,GAAG,GAAG,EAAE;wBACZ,MAAM,IAAI,GAAG,CAAC,CAAC,MAAM,EAAE,CAAC,CAAC,CAAC,MAAM,EAAE,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC;wBAC/C,IAAI,IAAI,KAAK,SAAS;4BAAE,OAAO;wBAC/B,YAAY,EAAE,CAAC;wBACf,IAAI,CAAC,WAAW,CAAC,GAAG,IAAI,CAAC;oBAC3B,CAAC,CAAC;oBAEF,CAAC,CAAC,IAAI,GAAG,GAAG,EAAE;wBACZ,YAAY,EAAE,CAAC;wBACf,IAAI,CAAC,WAAW,CAAC,GAAG,CAAC,CAAC,OAAO,EAAE,CAAC;oBAClC,CAAC,CAAC;oBAEF,SAAS,CAAC,GAAG,CAAC,IAAI,EAAE,CAAC,CAAC,CAAC;gBACzB,CAAC;gBACD,OAAO,SAAS,CAAC,GAAG,CAAC,IAAI,CAA4B,CAAC;YACxD,CAAC;YACD,UAAU,EAAE,KAAK;YACjB,YAAY,EAAE,IAAI;SACnB,CAAC,CAAC;IACL,CAAC,CAAC;AACJ,CAAC"}

package/dist/properties/index.d.ts

@@ -2,5 +2,5 @@ export { Prop } from "./prop";
 export { State } from "./state";
 export { Persisted } from "./persisted";
 export { Slot, initSlots } from "./slot";
-export { History } from "./history";
+export { History, type WithHistory } from "./history";
 //# sourceMappingURL=index.d.ts.map

package/dist/properties/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/properties/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,IAAI,EAAE,MAAM,QAAQ,CAAC;AAC9B,OAAO,EAAE,KAAK,EAAE,MAAM,SAAS,CAAC;AAChC,OAAO,EAAE,SAAS,EAAE,MAAM,aAAa,CAAC;AACxC,OAAO,EAAE,IAAI,EAAE,SAAS,EAAE,MAAM,QAAQ,CAAC;AACzC,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/properties/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,IAAI,EAAE,MAAM,QAAQ,CAAC;AAC9B,OAAO,EAAE,KAAK,EAAE,MAAM,SAAS,CAAC;AAChC,OAAO,EAAE,SAAS,EAAE,MAAM,aAAa,CAAC;AACxC,OAAO,EAAE,IAAI,EAAE,SAAS,EAAE,MAAM,QAAQ,CAAC;AACzC,OAAO,EAAE,OAAO,EAAE,KAAK,WAAW,EAAE,MAAM,WAAW,CAAC"}

package/dist/properties/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/properties/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,IAAI,EAAE,MAAM,QAAQ,CAAC;AAC9B,OAAO,EAAE,KAAK,EAAE,MAAM,SAAS,CAAC;AAChC,OAAO,EAAE,SAAS,EAAE,MAAM,aAAa,CAAC;AACxC,OAAO,EAAE,IAAI,EAAE,SAAS,EAAE,MAAM,QAAQ,CAAC;AACzC,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/properties/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,IAAI,EAAE,MAAM,QAAQ,CAAC;AAC9B,OAAO,EAAE,KAAK,EAAE,MAAM,SAAS,CAAC;AAChC,OAAO,EAAE,SAAS,EAAE,MAAM,aAAa,CAAC;AACxC,OAAO,EAAE,IAAI,EAAE,SAAS,EAAE,MAAM,QAAQ,CAAC;AACzC,OAAO,EAAE,OAAO,EAAoB,MAAM,WAAW,CAAC"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@praxisjs/decorators",
-  "version": "0.1.0",
+  "version": "0.2.0",
   "type": "module",
   "main": "./dist/index.js",
   "types": "./dist/index.d.ts",
@@ -15,7 +15,7 @@
     "typescript": "^5.9.3"
   },
   "dependencies": {
-    "@praxisjs/core": "0.1.0",
+    "@praxisjs/core": "0.2.0",
     "@praxisjs/jsx": "0.1.0",
     "@praxisjs/shared": "0.1.0"
   },

package/src/index.ts

@@ -12,5 +12,5 @@ export {
   type WatchVal,
   type WatchVals,
 } from "./functions";
-export { Prop, State, Persisted, Slot, initSlots, History } from "./properties";
+export { Prop, State, Persisted, Slot, initSlots, History, type WithHistory } from "./properties";
 export { type Command, createCommand, Emit, OnCommand } from "./events";

package/src/properties/history.ts

@@ -1,27 +1,16 @@
 import { type HistoryElement, history } from "@praxisjs/core";
 
+export type WithHistory<T, K extends keyof T> = Record<`${string & K}History`, HistoryElement<T[K]>>;
+
 export function History(limit = 50) {
   return function (target: object, propertyKey: string): void {
     const historyKey = `${propertyKey}History`;
     const histories = new WeakMap<object, HistoryElement<unknown>>();
 
-    const originalDescriptor = Object.getOwnPropertyDescriptor(
-      target,
-      propertyKey,
-    );
-
     Object.defineProperty(target, historyKey, {
-      get(this: object): HistoryElement<unknown> {
+      get(this: Record<string, unknown>): HistoryElement<unknown> {
         if (!histories.has(this)) {
-          const source = () => {
-            const desc =
-              Object.getOwnPropertyDescriptor(this, propertyKey) ??
-              Object.getOwnPropertyDescriptor(
-                Object.getPrototypeOf(this),
-                propertyKey,
-              );
-            return desc?.get?.call(this) as unknown;
-          };
+          const source = () => this[propertyKey];
 
           const h = history(source as () => unknown, limit);
 
@@ -32,23 +21,12 @@ export function History(limit = 50) {
             const prev = h.values()[h.values().length - 2];
             if (prev === undefined) return;
             originalUndo();
-            (
-              Object.getOwnPropertyDescriptor(
-                Object.getPrototypeOf(this),
-                propertyKey,
-              ) ?? originalDescriptor
-            )?.set?.call(this, prev);
+            this[propertyKey] = prev;
           };
 
           h.redo = () => {
             originalRedo();
-            const next = h.current();
-            (
-              Object.getOwnPropertyDescriptor(
-                Object.getPrototypeOf(this),
-                propertyKey,
-              ) ?? originalDescriptor
-            )?.set?.call(this, next);
+            this[propertyKey] = h.current();
           };
 
           histories.set(this, h);

package/src/properties/index.ts

@@ -2,4 +2,4 @@ export { Prop } from "./prop";
 export { State } from "./state";
 export { Persisted } from "./persisted";
 export { Slot, initSlots } from "./slot";
-export { History } from "./history";
+export { History, type WithHistory } from "./history";