@praxisjs/decorators 0.4.2 → 0.4.3

package/CHANGELOG.md

@@ -1,5 +1,23 @@
 # @praxisjs/decorators
 
+## 0.4.3
+
+### Patch Changes
+
+- ea59035: Fix three bugs in `Lazy`, `Virtual`, and `Watch` decorators
+
+  **`Lazy` / `Virtual` — incompatible type constraint**
+  Both decorators constrained their generic to `new (...args: any[]) => RootComponent`, where the bare `RootComponent` defaults to `RootComponent<Record<string, never>>`. This made the constraint incompatible with `StatefulComponent`, whose `_rawProps` is typed as `Record<string, unknown>`, causing a TypeScript error at the call site. Changed the constraint to `RootComponent<Record<string, any>>` so any component subclass is accepted.
+
+  **`Lazy` — infinite recursion on render after becoming visible**
+  `_originalRender` was initialized to `this.render.bind(this)`, which at instance-creation time resolves to `LazyWrapper.render` (the override itself). Calling `render()` after the component became visible would then recurse infinitely. Fixed by capturing `constructor.prototype.render` — the parent class's render method — instead.
+
+  **`Watch` — reactive effect leaked after component unmount**
+  The decorator created a reactive `effect()` on `onMount` but never called the returned stop function on unmount. This caused the effect to keep running and the handler to keep firing even after the component was unmounted, resulting in a memory leak and stale callbacks. The decorator now hooks into `onUnmount` to stop the effect and preserves any existing `onUnmount` implementation on the instance.
+
+- Updated dependencies [d11a10a]
+  - @praxisjs/core@0.4.2
+
 ## 0.4.2
 
 ### Patch Changes

package/dist/__tests__/component.test.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=component.test.d.ts.map

package/dist/__tests__/component.test.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"component.test.d.ts","sourceRoot":"","sources":["../../src/__tests__/component.test.ts"],"names":[],"mappings":""}

package/dist/__tests__/component.test.js

@@ -0,0 +1,137 @@
+import { describe, it, expect } from "vitest";
+import { StatefulComponent, StatelessComponent } from "@praxisjs/core";
+import { Component } from "../component/component";
+// ── Component decorator ───────────────────────────────────────────────────────
+describe("Component decorator", () => {
+    it("sets __isComponent = true on the enhanced class", () => {
+        class MyComp extends StatefulComponent {
+            render() { return null; }
+        }
+        const Enhanced = Component()(MyComp, {});
+        expect(Enhanced.__isComponent).toBe(true);
+    });
+    it("preserves the original class name", () => {
+        class MyButton extends StatefulComponent {
+            render() { return null; }
+        }
+        const Enhanced = Component()(MyButton, {});
+        expect(Enhanced.name).toBe("MyButton");
+    });
+    it("marks __isStateless = false for StatefulComponent subclasses", () => {
+        class MyStateful extends StatefulComponent {
+            render() { return null; }
+        }
+        const Enhanced = Component()(MyStateful, {});
+        expect(Enhanced.__isStateless).toBe(false);
+    });
+    it("marks __isStateless = true for StatelessComponent subclasses", () => {
+        class MyStateless extends StatelessComponent {
+            render() { return null; }
+        }
+        // eslint-disable-next-line @typescript-eslint/no-explicit-any
+        const Enhanced = Component()(MyStateless, {});
+        expect(Enhanced.__isStateless).toBe(true);
+    });
+    it("enhanced class can still be instantiated", () => {
+        class Counter extends StatefulComponent {
+            render() { return null; }
+        }
+        const Enhanced = Component()(Counter, {});
+        const instance = new Enhanced();
+        expect(instance).toBeInstanceOf(Counter);
+    });
+    it("returns a subclass of the original constructor", () => {
+        class Base extends StatefulComponent {
+            render() { return null; }
+        }
+        const Enhanced = Component()(Base, {});
+        expect(Enhanced.prototype).toBeInstanceOf(Base);
+    });
+    // ── Happy paths ──────────────────────────────────────────────────────────────
+    it("forwards constructor args — props reach the base constructor", () => {
+        class WithProps extends StatefulComponent {
+            render() { return null; }
+        }
+        const Enhanced = Component()(WithProps, {});
+        const instance = new Enhanced({ greeting: "hello" });
+        expect(instance.props.greeting).toBe("hello");
+    });
+    it("instance methods from the original class remain accessible", () => {
+        class Greeter extends StatefulComponent {
+            greet() { return "hello"; }
+            render() { return null; }
+        }
+        const Enhanced = Component()(Greeter, {});
+        const instance = new Enhanced();
+        expect(instance.greet()).toBe("hello");
+    });
+    it("static properties of the original class are preserved on Enhanced", () => {
+        class WithStatic extends StatefulComponent {
+            static version = "1.0";
+            render() { return null; }
+        }
+        const Enhanced = Component()(WithStatic, {});
+        expect(Enhanced.version).toBe("1.0");
+    });
+    // ── Edge cases ───────────────────────────────────────────────────────────────
+    it("applying Component() twice preserves name and flags", () => {
+        class MyComp extends StatefulComponent {
+            render() { return null; }
+        }
+        const E1 = Component()(MyComp, {});
+        const E2 = Component()(E1, {});
+        expect(E2.__isComponent).toBe(true);
+        expect(E2.__isStateless).toBe(false);
+        expect(E2.name).toBe("MyComp"); // name survives double-wrap
+    });
+    it("deep StatelessComponent inheritance — __isStateless is still true", () => {
+        class BaseStateless extends StatelessComponent {
+            render() { return null; }
+        }
+        class DeepChild extends BaseStateless {
+            render() { return null; }
+        }
+        // eslint-disable-next-line @typescript-eslint/no-explicit-any
+        const Enhanced = Component()(DeepChild, {});
+        expect(Enhanced.__isStateless).toBe(true);
+    });
+    it("anonymous class gets an empty name", () => {
+        // eslint-disable-next-line @typescript-eslint/no-explicit-any
+        const Enhanced = Component()(
+        // eslint-disable-next-line @typescript-eslint/no-explicit-any
+        class extends StatefulComponent {
+            render() { return null; }
+        }, {});
+        expect(Enhanced.name).toBe("");
+    });
+    it("__isComponent and __isStateless are static — not own properties of instances", () => {
+        class MyComp extends StatefulComponent {
+            render() { return null; }
+        }
+        const Enhanced = Component()(MyComp, {});
+        const instance = new Enhanced();
+        // Static fields live on the class, not on instances
+        expect(Object.prototype.hasOwnProperty.call(instance, "__isComponent")).toBe(false);
+        expect(Object.prototype.hasOwnProperty.call(instance, "__isStateless")).toBe(false);
+    });
+    it("subclassing Enhanced inherits __isComponent and __isStateless", () => {
+        class MyComp extends StatefulComponent {
+            render() { return null; }
+        }
+        const Enhanced = Component()(MyComp, {});
+        // `class Sub extends Enhanced` sets Object.getPrototypeOf(Sub) === Enhanced,
+        // making static fields visible through the chain. Simulate that here to
+        // avoid TS2510 (conflicting constructor return types in the intersection type).
+        const Sub = Object.create(Enhanced);
+        expect(Sub.__isComponent).toBe(true);
+        expect(Sub.__isStateless).toBe(false);
+    });
+    it("Enhanced is a different reference from the original constructor", () => {
+        class MyComp extends StatefulComponent {
+            render() { return null; }
+        }
+        const Enhanced = Component()(MyComp, {});
+        expect(Enhanced).not.toBe(MyComp);
+    });
+});
+//# sourceMappingURL=component.test.js.map

package/dist/__tests__/component.test.js.map

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

package/dist/__tests__/events.test.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=events.test.d.ts.map

package/dist/__tests__/events.test.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"events.test.d.ts","sourceRoot":"","sources":["../../src/__tests__/events.test.ts"],"names":[],"mappings":""}

package/dist/__tests__/events.test.js

@@ -0,0 +1,190 @@
+import { describe, it, expect, vi } from "vitest";
+import { StatefulComponent } from "@praxisjs/core";
+import { createCommand } from "../events/command";
+import { Emit } from "../events/emit";
+import { readProp } from "../events/helper";
+import { OnCommand } from "../events/on-command";
+// ── Helpers ───────────────────────────────────────────────────────────────────
+class TestComponent extends StatefulComponent {
+    render() { return null; }
+}
+function methodCtx(name) {
+    const initializers = [];
+    return {
+        ctx: {
+            name,
+            kind: "method",
+            addInitializer(fn) { initializers.push(fn); },
+        },
+        run(instance) { initializers.forEach((fn) => { fn.call(instance); }); },
+    };
+}
+// ── createCommand ─────────────────────────────────────────────────────────────
+describe("createCommand", () => {
+    it("trigger calls all subscribed handlers with the argument", () => {
+        const cmd = createCommand();
+        const h1 = vi.fn();
+        const h2 = vi.fn();
+        cmd.subscribe(h1);
+        cmd.subscribe(h2);
+        cmd.trigger(42);
+        expect(h1).toHaveBeenCalledWith(42);
+        expect(h2).toHaveBeenCalledWith(42);
+    });
+    it("trigger does nothing when no handlers are subscribed", () => {
+        const cmd = createCommand();
+        expect(() => cmd.trigger("hello")).not.toThrow();
+    });
+    it("subscribe returns an unsubscribe function", () => {
+        const cmd = createCommand();
+        const handler = vi.fn();
+        const unsub = cmd.subscribe(handler);
+        unsub();
+        cmd.trigger();
+        expect(handler).not.toHaveBeenCalled();
+    });
+    it("void command can be triggered without args", () => {
+        const cmd = createCommand();
+        const handler = vi.fn();
+        cmd.subscribe(handler);
+        cmd.trigger(undefined);
+        expect(handler).toHaveBeenCalledOnce();
+    });
+});
+// ── readProp ──────────────────────────────────────────────────────────────────
+describe("readProp", () => {
+    it("returns value from _rawProps when defined", () => {
+        const instance = new TestComponent({ myProp: "fromParent" });
+        expect(readProp(instance, "myProp")).toBe("fromParent");
+    });
+    it("falls back to _defaults when _rawProps does not define the prop", () => {
+        const instance = new TestComponent();
+        instance._defaults.myProp = "default";
+        expect(readProp(instance, "myProp")).toBe("default");
+    });
+    it("returns undefined when prop is not in either", () => {
+        const instance = new TestComponent();
+        expect(readProp(instance, "missing")).toBeUndefined();
+    });
+});
+// ── Emit ─────────────────────────────────────────────────────────────────────
+describe("Emit decorator", () => {
+    it("calls the prop callback with the return value of the method", () => {
+        const { ctx, run } = methodCtx("handleInput");
+        const original = function (value) { return value.toUpperCase(); };
+        Emit("onChange")(original, ctx);
+        const callback = vi.fn();
+        const instance = new TestComponent({ onChange: callback });
+        run(instance);
+        const method = instance.handleInput;
+        method.call(instance, "hello");
+        expect(callback).toHaveBeenCalledWith("HELLO");
+    });
+    it("calls the prop callback with the method args when return value is undefined", () => {
+        const { ctx, run } = methodCtx("doSomething");
+        const original = function (a, b) { return undefined; };
+        Emit("onDo")(original, ctx);
+        const callback = vi.fn();
+        const instance = new TestComponent({ onDo: callback });
+        run(instance);
+        const method = instance.doSomething;
+        method.call(instance, 1, 2);
+        expect(callback).toHaveBeenCalledWith(1, 2);
+    });
+    it("calls the prop callback with no args when return is undefined and no args", () => {
+        const { ctx, run } = methodCtx("fire");
+        const original = function () { return undefined; };
+        Emit("onFire")(original, ctx);
+        const callback = vi.fn();
+        const instance = new TestComponent({ onFire: callback });
+        run(instance);
+        const method = instance.fire;
+        method.call(instance);
+        expect(callback).toHaveBeenCalledOnce();
+        expect(callback).toHaveBeenCalledWith();
+    });
+    it("does not throw when the prop callback is not a function", () => {
+        const { ctx, run } = methodCtx("submit");
+        const original = function () { return "result"; };
+        Emit("onSubmit")(original, ctx);
+        const instance = new TestComponent(); // no onSubmit prop
+        run(instance);
+        const method = instance.submit;
+        expect(() => method.call(instance)).not.toThrow();
+    });
+    it("still returns the original method's return value", () => {
+        const { ctx, run } = methodCtx("compute");
+        const original = function () { return 99; };
+        Emit("onResult")(original, ctx);
+        const callback = vi.fn();
+        const instance = new TestComponent({ onResult: callback });
+        run(instance);
+        const method = instance.compute;
+        const result = method.call(instance);
+        expect(result).toBe(99);
+    });
+});
+// ── OnCommand ─────────────────────────────────────────────────────────────────
+describe("OnCommand decorator", () => {
+    it("subscribes to the command on mount and calls the method when triggered", () => {
+        const { ctx, run } = methodCtx("handleCmd");
+        const handler = vi.fn();
+        OnCommand("myCommand")(handler, ctx);
+        const cmd = createCommand();
+        const instance = new TestComponent({ myCommand: cmd });
+        run(instance);
+        instance.onMount?.();
+        cmd.trigger("payload");
+        expect(handler).toHaveBeenCalledWith("payload");
+    });
+    it("unsubscribes from the command on unmount", () => {
+        const { ctx, run } = methodCtx("onMsg");
+        const handler = vi.fn();
+        OnCommand("msg")(handler, ctx);
+        const cmd = createCommand();
+        const instance = new TestComponent({ msg: cmd });
+        run(instance);
+        instance.onMount?.();
+        instance.onUnmount?.();
+        cmd.trigger("after-unmount");
+        expect(handler).not.toHaveBeenCalled();
+    });
+    it("warns when the command prop is not provided", () => {
+        const { ctx, run } = methodCtx("onMissing");
+        OnCommand("missingProp")(vi.fn(), ctx);
+        const instance = new TestComponent(); // no missingProp
+        run(instance);
+        const warn = vi.spyOn(console, "warn").mockImplementation(() => { });
+        instance.onMount?.();
+        expect(warn).toHaveBeenCalledWith(expect.stringContaining("[OnCommand]"));
+        warn.mockRestore();
+    });
+    it("warns when the command prop is not a valid Command", () => {
+        const { ctx, run } = methodCtx("onBadCmd");
+        OnCommand("badProp")(vi.fn(), ctx);
+        const instance = new TestComponent({ badProp: "not-a-command" });
+        run(instance);
+        const warn = vi.spyOn(console, "warn").mockImplementation(() => { });
+        instance.onMount?.();
+        expect(warn).toHaveBeenCalledWith(expect.stringContaining("[OnCommand]"));
+        warn.mockRestore();
+    });
+    it("preserves the original onMount and onUnmount implementations", () => {
+        const { ctx, run } = methodCtx("onEvt");
+        OnCommand("evt")(vi.fn(), ctx);
+        const cmd = createCommand();
+        const instance = new TestComponent({ evt: cmd });
+        run(instance);
+        const mountSpy = vi.fn();
+        const unmountSpy = vi.fn();
+        const prevMount = instance.onMount?.bind(instance);
+        const prevUnmount = instance.onUnmount?.bind(instance);
+        instance.onMount = function () { mountSpy(); prevMount?.(); };
+        instance.onUnmount = function () { unmountSpy(); prevUnmount?.(); };
+        instance.onMount();
+        instance.onUnmount();
+        expect(mountSpy).toHaveBeenCalled();
+        expect(unmountSpy).toHaveBeenCalled();
+    });
+});
+//# sourceMappingURL=events.test.js.map

package/dist/__tests__/events.test.js.map

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

package/dist/__tests__/functions.test.js

@@ -108,6 +108,59 @@ describe("Retry", () => {
         await expect(wrapped.call({})).rejects.toThrow();
         expect(onRetry).toHaveBeenCalledTimes(2); // attempts 1 and 2, not the last
     });
+    it("maxAttempts=1 fails immediately without retrying", async () => {
+        const original = vi.fn(async () => { throw new Error("instant fail"); });
+        const ctx = mockMethodContext("once");
+        const wrapped = Retry(1)(original, ctx);
+        await expect(wrapped.call({})).rejects.toThrow("instant fail");
+        expect(original).toHaveBeenCalledTimes(1);
+    });
+    it("non-Error throw is wrapped in an Error", async () => {
+        const original = vi.fn(async () => {
+            // eslint-disable-next-line @typescript-eslint/only-throw-error
+            throw "string error";
+        });
+        const ctx = mockMethodContext("strThrow");
+        const wrapped = Retry(1)(original, ctx);
+        await expect(wrapped.call({})).rejects.toThrow("string error");
+    });
+    it("maxAttempts=0 throws immediately without calling the function", async () => {
+        const original = vi.fn(async () => "ok");
+        const ctx = mockMethodContext("never");
+        const wrapped = Retry(0)(original, ctx);
+        await expect(wrapped.call({})).rejects.toThrow("Unknown error");
+        expect(original).not.toHaveBeenCalled();
+    });
+    it("onRetry receives the correct attempt number", async () => {
+        const attempts = [];
+        const original = vi.fn(async () => { throw new Error("fail"); });
+        const ctx = mockMethodContext("numbered");
+        const wrapped = Retry(3, {
+            onRetry: (_err, attempt) => { attempts.push(attempt); },
+        })(original, ctx);
+        await expect(wrapped.call({})).rejects.toThrow();
+        expect(attempts).toEqual([1, 2]); // attempt 1 failed → onRetry(1), attempt 2 failed → onRetry(2)
+    });
+    it("backoff multiplies delay correctly", async () => {
+        vi.useFakeTimers();
+        const callTimes = [];
+        const original = vi.fn(async () => {
+            callTimes.push(Date.now());
+            throw new Error("fail");
+        });
+        const ctx = mockMethodContext("backoffTest");
+        const wrapped = Retry(3, { delay: 100, backoff: 2 })(original, ctx);
+        const p = wrapped.call({});
+        const rejection = expect(p).rejects.toThrow("fail");
+        await vi.runAllTimersAsync();
+        await rejection;
+        expect(callTimes.length).toBe(3);
+        // Attempt 2 runs 100ms after attempt 1
+        expect(callTimes[1] - callTimes[0]).toBeGreaterThanOrEqual(100);
+        // Attempt 3 runs 200ms after attempt 2 (backoff × 2)
+        expect(callTimes[2] - callTimes[1]).toBeGreaterThanOrEqual(200);
+        vi.useRealTimers();
+    });
 });
 // ── Log ──────────────────────────────────────────────────────────────────────
 describe("Log", () => {
@@ -170,6 +223,45 @@ describe("Log", () => {
         spy.mockRestore();
     });
 });
+// ── Log (additional branches) ─────────────────────────────────────────────────
+describe("Log — time option", () => {
+    it("includes elapsed time in sync result log when time=true", () => {
+        const spy = vi.spyOn(console, "log").mockImplementation(() => { });
+        const original = vi.fn(() => "value");
+        const ctx = mockMethodContext("timed");
+        const wrapped = Log({ args: false, result: true, time: true })(original, ctx);
+        class Svc {
+        }
+        wrapped.call(new Svc());
+        // Third argument should be a string containing "ms"
+        expect(spy).toHaveBeenCalledWith(expect.stringContaining("returned:"), "value", expect.stringContaining("ms"));
+        spy.mockRestore();
+    });
+    it("includes elapsed time in async result log when time=true", async () => {
+        const spy = vi.spyOn(console, "log").mockImplementation(() => { });
+        const original = vi.fn(async () => "async-val");
+        const ctx = mockMethodContext("asyncTimed");
+        const wrapped = Log({ args: false, result: true, time: true })(original, ctx);
+        class Svc {
+        }
+        await wrapped.call(new Svc());
+        expect(spy).toHaveBeenCalledWith(expect.stringContaining("resolved:"), "async-val", expect.stringContaining("ms"));
+        spy.mockRestore();
+    });
+    it("skips result log when result=false", () => {
+        const spy = vi.spyOn(console, "log").mockImplementation(() => { });
+        const original = vi.fn(() => 42);
+        const ctx = mockMethodContext("noResult");
+        const wrapped = Log({ args: false, result: false })(original, ctx);
+        class Svc {
+        }
+        wrapped.call(new Svc());
+        // Should not log a "returned:" line
+        const calls = spy.mock.calls.flat().join(" ");
+        expect(calls).not.toContain("returned:");
+        spy.mockRestore();
+    });
+});
 // ── Bind ─────────────────────────────────────────────────────────────────────
 describe("Bind", () => {
     it("binds method to the instance so 'this' is preserved", () => {
@@ -223,6 +315,41 @@ describe("Debounce", () => {
         expect(fn).toHaveBeenCalledOnce();
         vi.useRealTimers();
     });
+    it("multiple instances have independent timers", () => {
+        vi.useFakeTimers();
+        const fn = vi.fn();
+        const ctx = mockMethodContext("act");
+        Debounce(100)(fn, ctx);
+        const obj1 = {};
+        const obj2 = {};
+        ctx.runInitializers(obj1);
+        ctx.runInitializers(obj2);
+        const m1 = obj1.act;
+        const m2 = obj2.act;
+        m1("from-1");
+        m2("from-2");
+        vi.advanceTimersByTime(100);
+        // Both timers fire independently
+        expect(fn).toHaveBeenCalledTimes(2);
+        expect(fn).toHaveBeenCalledWith("from-1");
+        expect(fn).toHaveBeenCalledWith("from-2");
+        vi.useRealTimers();
+    });
+    it("delay=0 fires after the next macrotask", () => {
+        vi.useFakeTimers();
+        const fn = vi.fn();
+        const ctx = mockMethodContext("instant");
+        Debounce(0)(fn, ctx);
+        const obj = {};
+        ctx.runInitializers(obj);
+        const method = obj.instant;
+        method("a");
+        expect(fn).not.toHaveBeenCalled();
+        vi.advanceTimersByTime(0);
+        expect(fn).toHaveBeenCalledTimes(1);
+        expect(fn).toHaveBeenCalledWith("a");
+        vi.useRealTimers();
+    });
 });
 // ── Throttle ─────────────────────────────────────────────────────────────────
 describe("Throttle", () => {
@@ -266,5 +393,35 @@ describe("Throttle", () => {
         expect(fn).toHaveBeenCalledTimes(2);
         vi.useRealTimers();
     });
+    it("passes the first call's arguments to the underlying function", () => {
+        vi.useFakeTimers();
+        const fn = vi.fn();
+        const ctx = mockMethodContext("click");
+        Throttle(100)(fn, ctx);
+        const obj = {};
+        ctx.runInitializers(obj);
+        const method = obj.click;
+        method("first-arg");
+        method("second-arg");
+        expect(fn).toHaveBeenCalledWith("first-arg");
+        vi.useRealTimers();
+    });
+    it("multiple instances throttle independently", () => {
+        vi.useFakeTimers();
+        const fn = vi.fn();
+        const ctx = mockMethodContext("ping");
+        Throttle(100)(fn, ctx);
+        const obj1 = {};
+        const obj2 = {};
+        ctx.runInitializers(obj1);
+        ctx.runInitializers(obj2);
+        const m1 = obj1.ping;
+        const m2 = obj2.ping;
+        m1("a");
+        m2("b");
+        // Both first calls go through
+        expect(fn).toHaveBeenCalledTimes(2);
+        vi.useRealTimers();
+    });
 });
 //# sourceMappingURL=functions.test.js.map