@praxisjs/decorators 1.5.0 → 1.6.0

package/src/__tests__/properties.test.ts

@@ -201,6 +201,34 @@ describe("FunctionProp decorator", () => {
 
     expect((instance as unknown as Record<string, unknown>).filter).toBe(nextFilter);
   });
+
+  it("warns on a non-function raw prop in non-production", () => {
+    const { ctx, run } = fieldCtx("filter");
+    FunctionProp()(undefined, ctx);
+
+    const instance = new TestComponent({ filter: "not-a-function" });
+    run(instance);
+
+    const warn = vi.spyOn(console, "warn").mockImplementation(() => {});
+    expect((instance as unknown as Record<string, unknown>).filter).toBe("not-a-function");
+    expect(warn).toHaveBeenCalledWith(expect.stringContaining("[FunctionProp]"));
+    warn.mockRestore();
+  });
+
+  it("does not warn in production", () => {
+    const { ctx, run } = fieldCtx("filter");
+    FunctionProp()(undefined, ctx);
+
+    const instance = new TestComponent({ filter: "not-a-function" });
+    run(instance);
+
+    const warn = vi.spyOn(console, "warn").mockImplementation(() => {});
+    vi.stubEnv("NODE_ENV", "production");
+    expect((instance as unknown as Record<string, unknown>).filter).toBe("not-a-function");
+    expect(warn).not.toHaveBeenCalled();
+    vi.unstubAllEnvs();
+    warn.mockRestore();
+  });
 });
 
 // ── Computed ──────────────────────────────────────────────────────────────────

package/src/events/command.ts

@@ -1,3 +1,5 @@
+import { createFieldDecorator } from "../create-field-decorator";
+
 export interface Command<T = void> {
   trigger(arg: T): void;
   subscribe(handler: (arg: T) => void): () => void;
@@ -15,3 +17,15 @@ export function createCommand<T = void>(): Command<T> {
     },
   };
 }
+
+// eslint-disable-next-line @typescript-eslint/no-unnecessary-type-parameters
+export function Command<T = void>() {
+  return createFieldDecorator({
+    bind(_instance, _name, _initialValue) {
+      const command = createCommand<T>();
+      return {
+        descriptor: { get: () => command },
+      };
+    },
+  });
+}

package/src/events/index.ts

@@ -1,3 +1,3 @@
-export { type Command, createCommand } from "./command";
+export { Command, createCommand } from "./command";
 export { Emit } from "./emit";
 export { OnCommand } from "./on-command";

package/src/index.ts

@@ -34,7 +34,7 @@ export {
   Ref,
   createRef,
 } from "./properties";
-export { type Command, createCommand, Emit, OnCommand } from "./events";
+export { Command, createCommand, Emit, OnCommand } from "./events";
 export {
   createFieldDecorator,
   type FieldBehavior,

package/src/properties/function-prop.ts

@@ -15,6 +15,14 @@ export function FunctionProp() {
           get() {
             const fromParent = getComponentRawProp(instance, name);
             if (fromParent !== undefined) {
+              if (
+                process.env.NODE_ENV !== "production" &&
+                typeof fromParent !== "function"
+              ) {
+                console.warn(
+                  `[FunctionProp] "${name}" received a non-function value (${typeof fromParent}). @FunctionProp() expects a function.`,
+                );
+              }
               return fromParent;
             }
             return getComponentDefault(instance, name);

package/tsconfig.json

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