@praxisjs/decorators 1.7.0 → 2.0.1

package/src/__tests__/synced.test.ts

@@ -1,193 +0,0 @@
-// @vitest-environment jsdom
-import { describe, it, expect, vi, beforeEach } from "vitest";
-
-import { StatefulComponent } from "@praxisjs/core";
-import { effect } from "@praxisjs/core/internal";
-
-import { Synced } from "../properties/synced";
-
-// BroadcastChannel mock (same as core test)
-class MockBroadcastChannel {
-  static instances: MockBroadcastChannel[] = [];
-  static byChannel: Map<string, MockBroadcastChannel[]> = new Map();
-
-  onmessage: ((event: MessageEvent) => void) | null = null;
-  readonly name: string;
-  closed = false;
-
-  constructor(name: string) {
-    this.name = name;
-    MockBroadcastChannel.instances.push(this);
-    if (!MockBroadcastChannel.byChannel.has(name)) {
-      MockBroadcastChannel.byChannel.set(name, []);
-    }
-    MockBroadcastChannel.byChannel.get(name)!.push(this);
-  }
-
-  postMessage(data: unknown) {
-    MockBroadcastChannel.byChannel.get(this.name)?.forEach((ch) => {
-      if (ch !== this && ch.onmessage) {
-        ch.onmessage(new MessageEvent("message", { data }));
-      }
-    });
-  }
-
-  close() {
-    this.closed = true;
-    const list = MockBroadcastChannel.byChannel.get(this.name);
-    if (list) {
-      const idx = list.indexOf(this);
-      if (idx !== -1) list.splice(idx, 1);
-    }
-    MockBroadcastChannel.instances.splice(
-      MockBroadcastChannel.instances.indexOf(this),
-      1,
-    );
-  }
-}
-
-beforeEach(() => {
-  MockBroadcastChannel.instances = [];
-  MockBroadcastChannel.byChannel = new Map();
-  vi.stubGlobal("BroadcastChannel", MockBroadcastChannel);
-});
-
-class TestComponent extends StatefulComponent {
-  render() { return null; }
-}
-
-function fieldCtx(name: string) {
-  const initializers: Array<(this: unknown) => void> = [];
-  return {
-    ctx: {
-      name,
-      kind: "field" as const,
-      addInitializer(fn: (this: unknown) => void) { initializers.push(fn); },
-    } as ClassFieldDecoratorContext,
-    run(instance: unknown) {
-      initializers.forEach((fn) => { fn.call(instance); });
-    },
-  };
-}
-
-describe("@Synced decorator", () => {
-  it("reads and writes the field reactively", () => {
-    const { ctx, run } = fieldCtx("count");
-    Synced()(undefined, ctx);
-    const instance = new TestComponent();
-    (instance as unknown as Record<string, unknown>).count = 0;
-    run(instance);
-
-    const inst = instance as unknown as { count: number };
-    expect(inst.count).toBe(0);
-    inst.count = 5;
-    expect(inst.count).toBe(5);
-  });
-
-  it("uses field name as channel name by default", () => {
-    const { ctx, run } = fieldCtx("cart");
-    Synced()(undefined, ctx);
-    const instance = new TestComponent();
-    (instance as unknown as Record<string, unknown>).cart = [];
-    run(instance);
-
-    expect(MockBroadcastChannel.instances[0].name).toBe("cart");
-  });
-
-  it("uses custom channel name when provided", () => {
-    const { ctx, run } = fieldCtx("items");
-    Synced("my-channel")(undefined, ctx);
-    const instance = new TestComponent();
-    (instance as unknown as Record<string, unknown>).items = [];
-    run(instance);
-
-    expect(MockBroadcastChannel.instances[0].name).toBe("my-channel");
-  });
-
-  it("triggers reactive effects on write", () => {
-    const { ctx, run } = fieldCtx("value");
-    Synced()(undefined, ctx);
-    const instance = new TestComponent();
-    (instance as unknown as Record<string, unknown>).value = 0;
-    run(instance);
-
-    const inst = instance as unknown as { value: number };
-    const log: number[] = [];
-    effect(() => { log.push(inst.value); });
-
-    inst.value = 10;
-    expect(log).toEqual([0, 10]);
-  });
-
-  it("updates field when a remote message arrives", () => {
-    const { ctx, run } = fieldCtx("score");
-    Synced()(undefined, ctx);
-    const instance = new TestComponent();
-    (instance as unknown as Record<string, unknown>).score = 0;
-    run(instance);
-
-    const inst = instance as unknown as { score: number };
-    const channel = MockBroadcastChannel.instances[0];
-    channel.onmessage!(new MessageEvent("message", { data: JSON.stringify(42) }));
-
-    expect(inst.score).toBe(42);
-  });
-
-  it("two @Synced fields on the same instance share the signalMap entry", () => {
-    const { ctx: ctx1, run: run1 } = fieldCtx("a");
-    const { ctx: ctx2, run: run2 } = fieldCtx("b");
-    Synced()(undefined, ctx1);
-    Synced()(undefined, ctx2);
-
-    const instance = new TestComponent();
-    (instance as unknown as Record<string, unknown>).a = 1;
-    (instance as unknown as Record<string, unknown>).b = 2;
-    run1(instance);
-    run2(instance);
-
-    const inst = instance as unknown as { a: number; b: number };
-    inst.a = 10;
-    inst.b = 20;
-    expect(inst.a).toBe(10);
-    expect(inst.b).toBe(20);
-
-    // Both fields have their own BroadcastChannel
-    expect(MockBroadcastChannel.instances.length).toBe(2);
-    instance.onUnmount?.();
-    expect(MockBroadcastChannel.instances.every((ch) => ch.closed)).toBe(true);
-  });
-
-  it("reuses the existing signal when the same channel key is registered again on the same instance", () => {
-    // Two fields using an identical explicit channel name bind to the same SyncedSignal.
-    const { ctx: ctx1, run: run1 } = fieldCtx("alpha");
-    const { ctx: ctx2, run: run2 } = fieldCtx("beta");
-    Synced("shared-chan")(undefined, ctx1);
-    Synced("shared-chan")(undefined, ctx2);
-
-    const instance = new TestComponent();
-    (instance as unknown as Record<string, unknown>).alpha = "initial";
-    (instance as unknown as Record<string, unknown>).beta = "initial";
-    run1(instance);
-    // second bind for "shared-chan" on the same instance hits the map.has(key) === true branch
-    run2(instance);
-
-    const inst = instance as unknown as { alpha: string; beta: string };
-    inst.alpha = "changed";
-    // both fields share the same underlying signal
-    expect(inst.beta).toBe("changed");
-    instance.onUnmount?.();
-  });
-
-  it("onUnmount closes the BroadcastChannel", () => {
-    const { ctx, run } = fieldCtx("data");
-    Synced()(undefined, ctx);
-    const instance = new TestComponent();
-    (instance as unknown as Record<string, unknown>).data = null;
-    run(instance);
-
-    const channel = MockBroadcastChannel.instances[0];
-    expect(channel.closed).toBe(false);
-    instance.onUnmount?.();
-    expect(channel.closed).toBe(true);
-  });
-});

package/src/__tests__/until.test.ts

@@ -1,113 +0,0 @@
-import { describe, it, expect } from "vitest";
-
-import { signal, computed } from "@praxisjs/core/internal";
-
-import { Until } from "../functions/until";
-
-// Simulates TC39 decorator context for a method decorator
-function mockMethodContext(name: string) {
-  const initializers: Array<(this: object) => void> = [];
-  const ctx = {
-    name,
-    kind: "method" as const,
-    addInitializer(fn: (this: object) => void) {
-      initializers.push(fn);
-    },
-    runInitializers(instance: object) {
-      initializers.forEach((fn) => { fn.call(instance); });
-    },
-  };
-  return ctx;
-}
-
-// ── @Until ────────────────────────────────────────────────────────────────────
-
-describe("Until", () => {
-  it("resolves immediately when the signal is already truthy", async () => {
-    const s = signal(42);
-    const obj: Record<string, unknown> = { count: s };
-
-    const ctx = mockMethodContext("wait");
-    Until("count")(() => {}, ctx as unknown as ClassMethodDecoratorContext);
-    ctx.runInitializers(obj);
-
-    const result = await (obj.wait as () => Promise<number>)();
-    expect(result).toBe(42);
-  });
-
-  it("resolves when the signal becomes truthy", async () => {
-    const s = signal<number>(0);
-    const obj: Record<string, unknown> = { count: s };
-
-    const ctx = mockMethodContext("wait");
-    Until("count")(() => {}, ctx as unknown as ClassMethodDecoratorContext);
-    ctx.runInitializers(obj);
-
-    const promise = (obj.wait as () => Promise<number>)();
-    s.set(5);
-    expect(await promise).toBe(5);
-  });
-
-  it("resolves with a computed signal", async () => {
-    const s = signal(0);
-    const doubled = computed(() => s() * 2);
-    const obj: Record<string, unknown> = { doubled };
-
-    const ctx = mockMethodContext("waitDoubled");
-    Until("doubled")(() => {}, ctx as unknown as ClassMethodDecoratorContext);
-    ctx.runInitializers(obj);
-
-    const promise = (obj.waitDoubled as () => Promise<number>)();
-    s.set(3); // doubled becomes 6 (truthy)
-    expect(await promise).toBe(6);
-  });
-
-  it("each call returns a new promise", async () => {
-    const s = signal<string>("");
-    const obj: Record<string, unknown> = { name: s };
-
-    const ctx = mockMethodContext("waitName");
-    Until("name")(() => {}, ctx as unknown as ClassMethodDecoratorContext);
-    ctx.runInitializers(obj);
-
-    const wait = obj.waitName as () => Promise<string>;
-
-    const p1 = wait();
-    const p2 = wait();
-    expect(p1).not.toBe(p2);
-
-    s.set("alice");
-    expect(await p1).toBe("alice");
-    expect(await p2).toBe("alice");
-  });
-
-  it("does not resolve when signal stays falsy", async () => {
-    const s = signal<number>(0);
-    const obj: Record<string, unknown> = { count: s };
-
-    const ctx = mockMethodContext("wait");
-    Until("count")(() => {}, ctx as unknown as ClassMethodDecoratorContext);
-    ctx.runInitializers(obj);
-
-    let resolved = false;
-    (obj.wait as () => Promise<number>)().then(() => { resolved = true; });
-
-    await new Promise((res) => { setTimeout(res, 10); });
-    expect(resolved).toBe(false);
-  });
-
-  it("ignores the original method body", async () => {
-    const s = signal("hello");
-    const obj: Record<string, unknown> = { value: s };
-
-    let bodyCalled = false;
-    const original = () => { bodyCalled = true; };
-
-    const ctx = mockMethodContext("wait");
-    Until("value")(original, ctx as unknown as ClassMethodDecoratorContext);
-    ctx.runInitializers(obj);
-
-    await (obj.wait as () => Promise<string>)();
-    expect(bodyCalled).toBe(false);
-  });
-});

package/src/create-accessor-decorator.ts

@@ -1,45 +0,0 @@
-export interface AccessorBinding {
-  get: () => unknown;
-  set?: (value: unknown) => void;
-}
-
-export interface AccessorBehavior {
-  /**
-   * Called once per instance on first access. `initialValue` is the value
-   * provided by the `accessor` field initializer (e.g. `accessor count = 0`).
-   * Returns the get/set pair used by the accessor.
-   */
-  bind(instance: object, name: string | symbol, initialValue: unknown): AccessorBinding;
-}
-
-export function createAccessorDecorator(behavior: AccessorBehavior) {
-  return function <This extends object, V>(
-    _target: ClassAccessorDecoratorTarget<This, V>,
-    context: ClassAccessorDecoratorContext<This, V>,
-  ): ClassAccessorDecoratorResult<This, V> {
-    const bindings = new WeakMap<object, AccessorBinding>();
-    const initValues = new WeakMap<object, unknown>();
-
-    function getBinding(instance: object): AccessorBinding {
-      let b = bindings.get(instance);
-      if (!b) {
-        b = behavior.bind(instance, context.name, initValues.get(instance));
-        bindings.set(instance, b);
-      }
-      return b;
-    }
-
-    return {
-      init(this: This, value: V): V {
-        initValues.set(this as object, value);
-        return value;
-      },
-      get(this: This): V {
-        return getBinding(this as object).get() as V;
-      },
-      set(this: This, value: V): void {
-        getBinding(this as object).set?.(value as unknown);
-      },
-    };
-  };
-}

package/tsconfig.json

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