@bonsae/nrg 0.17.0 → 0.18.1

package/test/client/component/config.js

@@ -0,0 +1,37 @@
+// src/test/client/component/config.ts
+import path from "path";
+import vue from "@vitejs/plugin-vue";
+import { playwright } from "@vitest/browser-playwright";
+var defaultConfig = {
+  plugins: [vue()],
+  esbuild: {
+    tsconfigRaw: "{}"
+  },
+  resolve: {
+    alias: {
+      "@": path.resolve(process.cwd(), "src"),
+      "@bonsae/nrg/client": "@bonsae/nrg/test/client/component"
+    }
+  },
+  server: {
+    fs: {
+      allow: [".."]
+    }
+  },
+  test: {
+    testTimeout: 3e4,
+    setupFiles: ["@bonsae/nrg/test/client/component/setup"],
+    browser: {
+      enabled: true,
+      instances: [
+        { browser: "chromium" },
+        { browser: "firefox" },
+        { browser: "webkit" }
+      ],
+      provider: playwright()
+    }
+  }
+};
+export {
+  defaultConfig
+};

package/test/client/component/index.js

@@ -103,6 +103,16 @@ function createJQ(el) {
       state.listeners[event].push(cb);
       return jq;
     },
+    off(event) {
+      if (event) {
+        delete state.listeners[event];
+      } else {
+        for (const key of Object.keys(state.listeners)) {
+          delete state.listeners[key];
+        }
+      }
+      return jq;
+    },
     val(value) {
       if (value !== void 0) {
         if (el instanceof HTMLInputElement || el instanceof HTMLSelectElement || el instanceof HTMLTextAreaElement) {
@@ -180,15 +190,25 @@ function createJQuery() {
   };
 }
 
-// src/test/client/component/index.ts
-var defaultConfig = {
-  testTimeout: 3e4,
-  setupFiles: ["@bonsae/nrg/test/client/component/setup"],
-  browser: {
-    enabled: true,
-    instances: [{ browser: "chromium" }]
+// src/core/client/use-form-node.ts
+import { inject } from "vue";
+function useFormNode() {
+  const node = inject("__nrg_form_node");
+  const schema = inject("__nrg_form_schema");
+  const errors = inject("__nrg_form_errors");
+  if (!node) {
+    throw new Error(
+      "useFormNode() must be called inside a form component mounted by NRG."
+    );
   }
-};
+  return {
+    node,
+    schema,
+    errors
+  };
+}
+
+// src/test/client/component/index.ts
 function createNode(overrides = {}) {
   const node = {
     id: `test-${Math.random().toString(36).slice(2, 10)}`,
@@ -200,7 +220,12 @@ function createNode(overrides = {}) {
   };
   const RED = getMockRED();
   spyOnRED(RED);
-  return { node, RED };
+  const provide = {
+    __nrg_form_node: node,
+    __nrg_form_schema: {},
+    __nrg_form_errors: {}
+  };
+  return { node, RED, provide };
 }
 function spyIfNeeded(obj, method) {
   if (!vi.isMockFunction(obj[method])) {
@@ -230,5 +255,5 @@ export {
   createJQuery,
   createNode,
   createRED,
-  defaultConfig
+  useFormNode
 };

package/test/client/component/setup.js

@@ -104,6 +104,16 @@ function createJQ(el) {
       state.listeners[event].push(cb);
       return jq;
     },
+    off(event) {
+      if (event) {
+        delete state.listeners[event];
+      } else {
+        for (const key of Object.keys(state.listeners)) {
+          delete state.listeners[key];
+        }
+      }
+      return jq;
+    },
     val(value) {
       if (value !== void 0) {
         if (el instanceof HTMLInputElement || el instanceof HTMLSelectElement || el instanceof HTMLTextAreaElement) {

package/test/client/e2e/index.js

@@ -1929,7 +1929,7 @@ async function build2(clientBuildOptions, buildContext) {
   const config = {
     configFile: false,
     logLevel: "warn",
-    base: `/${path9.join("resources", buildContext.packageName)}`,
+    base: `/resources/${buildContext.packageName}`,
     publicDir: path9.resolve(srcDir, "public"),
     resolve: {
       alias: {
@@ -1959,9 +1959,9 @@ async function build2(clientBuildOptions, buildContext) {
         external,
         treeshake: false,
         output: {
-          entryFileNames: path9.join("resources", "index.[hash].js"),
-          chunkFileNames: path9.join("resources", "vendor.[hash].js"),
-          assetFileNames: path9.join("resources", "[name].[hash].[ext]"),
+          entryFileNames: "resources/index.[hash].js",
+          chunkFileNames: "resources/vendor.[hash].js",
+          assetFileNames: "resources/[name].[hash].[ext]",
           globals,
           paths: {
             vue: "/nrg/assets/vue.esm-browser.prod.js",

package/test/client/unit/config.js

@@ -0,0 +1,26 @@
+// src/test/client/unit/config.ts
+import path from "path";
+var defaultConfig = {
+  esbuild: {
+    tsconfigRaw: "{}"
+  },
+  resolve: {
+    alias: {
+      "@": path.resolve(process.cwd(), "src"),
+      "@bonsae/nrg/client": "@bonsae/nrg/test/client/unit"
+    }
+  },
+  server: {
+    fs: {
+      allow: [".."]
+    }
+  },
+  test: {
+    testTimeout: 3e4,
+    environment: "happy-dom",
+    setupFiles: ["@bonsae/nrg/test/client/unit/setup"]
+  }
+};
+export {
+  defaultConfig
+};

package/test/client/unit/index.js

@@ -100,6 +100,16 @@ function createJQ(el) {
       state.listeners[event].push(cb);
       return jq;
     },
+    off(event) {
+      if (event) {
+        delete state.listeners[event];
+      } else {
+        for (const key of Object.keys(state.listeners)) {
+          delete state.listeners[key];
+        }
+      }
+      return jq;
+    },
     val(value) {
       if (value !== void 0) {
         if (el instanceof HTMLInputElement || el instanceof HTMLSelectElement || el instanceof HTMLTextAreaElement) {
@@ -177,14 +187,25 @@ function createJQuery() {
   };
 }
 
-// src/test/client/unit/index.ts
-var defaultConfig = {
-  testTimeout: 3e4,
-  environment: "happy-dom",
-  setupFiles: ["@bonsae/nrg/test/client/unit/setup"]
-};
+// src/core/client/use-form-node.ts
+import { inject } from "vue";
+function useFormNode() {
+  const node = inject("__nrg_form_node");
+  const schema = inject("__nrg_form_schema");
+  const errors = inject("__nrg_form_errors");
+  if (!node) {
+    throw new Error(
+      "useFormNode() must be called inside a form component mounted by NRG."
+    );
+  }
+  return {
+    node,
+    schema,
+    errors
+  };
+}
 export {
   createJQuery,
   createRED,
-  defaultConfig
+  useFormNode
 };

package/test/client/unit/setup.js

@@ -103,6 +103,16 @@ function createJQ(el) {
       state.listeners[event].push(cb);
       return jq;
     },
+    off(event) {
+      if (event) {
+        delete state.listeners[event];
+      } else {
+        for (const key of Object.keys(state.listeners)) {
+          delete state.listeners[key];
+        }
+      }
+      return jq;
+    },
     val(value) {
       if (value !== void 0) {
         if (el instanceof HTMLInputElement || el instanceof HTMLSelectElement || el instanceof HTMLTextAreaElement) {

package/test/server/unit/config.js

@@ -0,0 +1,15 @@
+// src/test/server/unit/config.ts
+import path from "path";
+var defaultConfig = {
+  resolve: {
+    alias: {
+      "@": path.resolve(process.cwd(), "src")
+    }
+  },
+  test: {
+    testTimeout: 3e4
+  }
+};
+export {
+  defaultConfig
+};

package/test/server/unit/index.js

@@ -399,6 +399,7 @@ function initValidator(RED) {
 var WIRE_HANDLERS = Symbol.for("nrg.wireHandlers");
 
 // src/test/server/unit/index.ts
+import { Kind } from "@sinclair/typebox";
 function buildConfig(NodeClass, userConfig = {}) {
   const defaults = {};
   if (NodeClass.configSchema?.properties) {
@@ -413,7 +414,7 @@ function buildConfig(NodeClass, userConfig = {}) {
   }
   return { ...defaults, ...userConfig };
 }
-function attachHelpers(node, nodeRedNode) {
+function attachHelpers(node, nodeRedNode, NodeClass) {
   const sentMessages = [];
   const statusCalls = [];
   nodeRedNode.send.mockImplementation((msg) => {
@@ -449,6 +450,15 @@ function attachHelpers(node, nodeRedNode) {
     },
     sent(port) {
       if (port === void 0) return [...sentMessages];
+      if (typeof port === "string") {
+        const schema = NodeClass.outputsSchema;
+        if (!schema || Array.isArray(schema) || typeof schema === "object" && Kind in schema) {
+          return [];
+        }
+        const idx = Object.keys(schema).indexOf(port);
+        if (idx === -1) return [];
+        return sentMessages.map((msg) => Array.isArray(msg) ? msg[idx] : void 0).filter((msg) => msg != null);
+      }
       return sentMessages.map(
         (msg) => Array.isArray(msg) ? msg[port] : port === 0 ? msg : void 0
       ).filter((msg) => msg != null);
@@ -523,7 +533,11 @@ async function createNode(NodeClass, options = {}) {
   NodeClass.validateSettings(RED);
   await Promise.resolve(NodeClass.registered?.(RED));
   const node = new NodeClass(RED, nodeRedNode, config, credentials);
-  const augmented = attachHelpers(node, nodeRedNode);
+  const augmented = attachHelpers(
+    node,
+    nodeRedNode,
+    NodeClass
+  );
   const createdPromise = Promise.resolve(node.created?.());
   node[WIRE_HANDLERS](nodeRedNode, createdPromise);
   await createdPromise;

package/types/client.d.ts

@@ -1,7 +1,12 @@
 // Generated by dts-bundle-generator v9.5.1
 
+import { SchemaOptions, Static, TSchema } from '@sinclair/typebox';
 import { App, Component } from 'vue';
 
+interface NodeRefResolved<T = any> {
+	readonly __nrg_node_ref: true;
+	readonly __instance: T;
+}
 export interface NodeStateCredentials {
 	[key: string]: any;
 }
@@ -87,13 +92,74 @@ export interface NodeDefinition {
 	onPaletteRemove?: (this: NodeRedNode) => void;
 	form?: NodeFormDefinition;
 }
+export interface NodeDefaults {
+	[key: string]: {
+		value: any;
+		type?: string;
+		label?: string;
+		required?: boolean;
+		validate?: (this: NodeRedNode, value: any, opt: any) => any;
+	};
+}
+export interface NodeCredentials {
+	[key: string]: {
+		value?: string;
+		type?: "password" | "text";
+		label?: string;
+		required?: boolean;
+	};
+}
+export interface MergedNodeDefinition extends NodeDefinition {
+	defaults?: NodeDefaults;
+	credentials?: NodeCredentials;
+	configSchema?: Record<string, any>;
+	credentialsSchema?: {
+		properties?: Record<string, any>;
+	};
+	outputsSchema?: Record<string, any>;
+	inputSchema?: Record<string, any>;
+}
 export interface NodeFeatures {
 	hasInputSchema: boolean;
 	hasOutputSchema: boolean;
 }
+/** Client-side representation of a TypedInput field: the raw value string and its type selector. */
+export interface TypedInputValue {
+	value: string;
+	type: string;
+}
+type _ToClient<T> = T extends NodeRefResolved<any> ? string : T extends {
+	resolve(...args: any[]): any;
+	value: unknown;
+	type: string;
+} ? TypedInputValue : T extends (...args: any[]) => any ? T : T extends Array<infer I> ? _ToClient<I>[] : T extends object ? {
+	[K in keyof T]: _ToClient<T[K]>;
+} : T;
+/**
+ * Infers the client-side TypeScript type from a TypeBox schema.
+ *
+ * Resolves schema types to their client form representations:
+ * - `NodeRef<T>` → `string` (node ID in the editor)
+ * - `TypedInput<T>` → `{ value: string; type: string }`
+ * - All other types resolve via TypeBox's `Static<T>`
+ *
+ * @example
+ * ```ts
+ * import type { Infer } from "@bonsae/nrg/client";
+ * import type { ConfigSchema } from "../schemas/my-node";
+ *
+ * type Config = Infer<typeof ConfigSchema>;
+ * ```
+ */
+export type Infer<T extends TSchema> = _ToClient<Static<T>>;
 
 export {};
 
 export declare function defineNode<T extends NodeDefinition>(options: T): T;
 export declare function registerType(definition: NodeDefinition): Promise<void>;
 export declare function registerTypes(nodes: NodeDefinition[]): Promise<void>;
+export declare function useFormNode<TConfig extends TSchema = TSchema, TCredentials extends TSchema = TSchema>(): {
+  node: NodeRedNode & Infer<TConfig> & { credentials: Infer<TCredentials> & Record<string, any> };
+  schema: Record<string, any>;
+  errors: Record<string, string>;
+};

package/types/server.d.ts

@@ -432,15 +432,19 @@ export declare const StatusPortSchema: import("@sinclair/typebox").TObject<{
 		name: import("@sinclair/typebox").TString;
 	}>;
 }>;
+interface NodeRefResolved<T = any> {
+	readonly __nrg_node_ref: true;
+	readonly __instance: T;
+}
 /** Schema type representing a reference to a config node. Resolves to the node instance at runtime. */
 export interface TNodeRef<T = any> extends TSchema {
 	[Kind]: "NodeRef";
-	static: T;
+	static: NodeRefResolved<T>;
 	type: "string";
 	format: "node-id";
 	"x-nrg-node-type"?: string;
 }
-type ResolveNodeRefs<T> = T extends TypedInput<any> ? T : T extends (...args: any[]) => any ? T : T extends Array<infer Item> ? ResolveNodeRefs<Item>[] : T extends object ? {
+type ResolveNodeRefs<T> = T extends NodeRefResolved<infer I> ? I : T extends TypedInput<any> ? T : T extends (...args: any[]) => any ? T : T extends Array<infer Item> ? ResolveNodeRefs<Item>[] : T extends object ? {
 	[K in keyof T]: ResolveNodeRefs<T[K]>;
 } : T;
 /**
@@ -460,6 +464,7 @@ type TypedInputType = (typeof TYPED_INPUT_TYPES)[number];
 export interface TTypedInput<T = unknown> extends TSchema {
 	[Kind]: "TypedInput";
 	static: TypedInput<T>;
+	"x-nrg-typed-input": true;
 }
 interface NrgSchemaOptions extends SchemaOptions, NrgSchemaExtensions {
 }

package/types/shims/form/components/node-red-config-input.vue.d.ts

@@ -35,7 +35,9 @@ declare const _default: import("vue").DefineComponent<import("vue").ExtractPropT
         type: StringConstructor;
         default: string;
     };
-}>, {}, {}, {
+}>, {
+    jqInput: import("vue").ShallowRef<any, any>;
+}, {}, {
     inputId(): string;
     effectiveValue(): string;
 }, {}, import("vue").ComponentOptionsMixin, import("vue").ComponentOptionsMixin, ("update:modelValue" | "update:value")[], "update:modelValue" | "update:value", import("vue").PublicProps, Readonly<import("vue").ExtractPropTypes<{

package/types/shims/form/components/node-red-editor-input.vue.d.ts

@@ -28,7 +28,10 @@ declare const _default: import("vue").DefineComponent<import("vue").ExtractPropT
         type: StringConstructor;
         default: string;
     };
-}>, {}, {
+}>, {
+    editor: import("vue").ShallowRef<any, any>;
+    expandedEditorTray: import("vue").ShallowRef<any, any>;
+}, {
     editorId: string;
     stateId: string;
     trayElement: HTMLElement | null;

package/types/shims/form/components/node-red-json-schema-form.vue.d.ts

@@ -263,7 +263,9 @@ declare const _default: import("vue").DefineComponent<import("vue").ExtractPropT
             type: StringConstructor;
             default: string;
         };
-    }>, {}, {}, {
+    }>, {
+        selectWidget: import("vue").ShallowRef<any, any>;
+    }, {}, {
         effectiveValue(): string | unknown[];
     }, {}, import("vue").ComponentOptionsMixin, import("vue").ComponentOptionsMixin, ("update:modelValue" | "update:value")[], "update:modelValue" | "update:value", import("vue").PublicProps, Readonly<import("vue").ExtractPropTypes<{
         modelValue: {
@@ -353,7 +355,10 @@ declare const _default: import("vue").DefineComponent<import("vue").ExtractPropT
     }, {}, string, import("vue").ComponentProvideOptions, true, {}, any>;
     NodeRedTypedInput: import("vue").DefineComponent<import("vue").ExtractPropTypes<{
         modelValue: {
-            type: ObjectConstructor;
+            type: PropType<{
+                value: string;
+                type: string;
+            } | undefined>;
             default: undefined;
             validator: (obj: {
                 value: string;
@@ -361,7 +366,10 @@ declare const _default: import("vue").DefineComponent<import("vue").ExtractPropT
             } | undefined) => boolean;
         };
         value: {
-            type: ObjectConstructor;
+            type: PropType<{
+                value: string;
+                type: string;
+            } | undefined>;
             default: undefined;
             validator: (obj: {
                 value: string;
@@ -388,7 +396,10 @@ declare const _default: import("vue").DefineComponent<import("vue").ExtractPropT
             type: StringConstructor;
             default: string;
         };
-    }>, {}, {}, {
+    }>, {
+        inputWidget: import("vue").ShallowRef<any, any>;
+        mutationObserver: import("vue").ShallowRef<MutationObserver | null, MutationObserver | null>;
+    }, {}, {
         effectiveValue(): {
             value: string;
             type: string;
@@ -398,7 +409,10 @@ declare const _default: import("vue").DefineComponent<import("vue").ExtractPropT
         onChange(): void;
     }, import("vue").ComponentOptionsMixin, import("vue").ComponentOptionsMixin, ("update:modelValue" | "update:value")[], "update:modelValue" | "update:value", import("vue").PublicProps, Readonly<import("vue").ExtractPropTypes<{
         modelValue: {
-            type: ObjectConstructor;
+            type: PropType<{
+                value: string;
+                type: string;
+            } | undefined>;
             default: undefined;
             validator: (obj: {
                 value: string;
@@ -406,7 +420,10 @@ declare const _default: import("vue").DefineComponent<import("vue").ExtractPropT
             } | undefined) => boolean;
         };
         value: {
-            type: ObjectConstructor;
+            type: PropType<{
+                value: string;
+                type: string;
+            } | undefined>;
             default: undefined;
             validator: (obj: {
                 value: string;
@@ -440,8 +457,14 @@ declare const _default: import("vue").DefineComponent<import("vue").ExtractPropT
         label: string;
         icon: string;
         required: boolean;
-        modelValue: Record<string, any>;
-        value: Record<string, any>;
+        modelValue: {
+            value: string;
+            type: string;
+        } | undefined;
+        value: {
+            value: string;
+            type: string;
+        } | undefined;
         error: string;
         types: ("msg" | "flow" | "global" | "str" | "num" | "bool" | "json" | "bin" | "re" | "jsonata" | "date" | "env" | "node" | "cred" | NodeRED.TypedInputTypeDefinition)[];
     }, {}, {
@@ -516,7 +539,9 @@ declare const _default: import("vue").DefineComponent<import("vue").ExtractPropT
             type: StringConstructor;
             default: string;
         };
-    }>, {}, {}, {
+    }>, {
+        jqInput: import("vue").ShallowRef<any, any>;
+    }, {}, {
         inputId(): string;
         effectiveValue(): string;
     }, {}, import("vue").ComponentOptionsMixin, import("vue").ComponentOptionsMixin, ("update:modelValue" | "update:value")[], "update:modelValue" | "update:value", import("vue").PublicProps, Readonly<import("vue").ExtractPropTypes<{
@@ -631,7 +656,10 @@ declare const _default: import("vue").DefineComponent<import("vue").ExtractPropT
             type: StringConstructor;
             default: string;
         };
-    }>, {}, {
+    }>, {
+        editor: import("vue").ShallowRef<any, any>;
+        expandedEditorTray: import("vue").ShallowRef<any, any>;
+    }, {
         editorId: string;
         stateId: string;
         trayElement: HTMLElement | null;

package/types/shims/form/components/node-red-select-input.vue.d.ts

@@ -38,7 +38,9 @@ declare const _default: import("vue").DefineComponent<import("vue").ExtractPropT
         type: StringConstructor;
         default: string;
     };
-}>, {}, {}, {
+}>, {
+    selectWidget: import("vue").ShallowRef<any, any>;
+}, {}, {
     effectiveValue(): string | unknown[];
 }, {}, import("vue").ComponentOptionsMixin, import("vue").ComponentOptionsMixin, ("update:modelValue" | "update:value")[], "update:modelValue" | "update:value", import("vue").PublicProps, Readonly<import("vue").ExtractPropTypes<{
     modelValue: {

package/types/shims/form/components/node-red-typed-input.vue.d.ts

@@ -1,6 +1,9 @@
 declare const _default: import("vue").DefineComponent<import("vue").ExtractPropTypes<{
     modelValue: {
-        type: ObjectConstructor;
+        type: PropType<{
+            value: string;
+            type: string;
+        } | undefined>;
         default: undefined;
         validator: (obj: {
             value: string;
@@ -8,7 +11,10 @@ declare const _default: import("vue").DefineComponent<import("vue").ExtractPropT
         } | undefined) => boolean;
     };
     value: {
-        type: ObjectConstructor;
+        type: PropType<{
+            value: string;
+            type: string;
+        } | undefined>;
         default: undefined;
         validator: (obj: {
             value: string;
@@ -35,7 +41,10 @@ declare const _default: import("vue").DefineComponent<import("vue").ExtractPropT
         type: StringConstructor;
         default: string;
     };
-}>, {}, {}, {
+}>, {
+    inputWidget: import("vue").ShallowRef<any, any>;
+    mutationObserver: import("vue").ShallowRef<MutationObserver | null, MutationObserver | null>;
+}, {}, {
     effectiveValue(): {
         value: string;
         type: string;
@@ -45,7 +54,10 @@ declare const _default: import("vue").DefineComponent<import("vue").ExtractPropT
     onChange(): void;
 }, import("vue").ComponentOptionsMixin, import("vue").ComponentOptionsMixin, ("update:modelValue" | "update:value")[], "update:modelValue" | "update:value", import("vue").PublicProps, Readonly<import("vue").ExtractPropTypes<{
     modelValue: {
-        type: ObjectConstructor;
+        type: PropType<{
+            value: string;
+            type: string;
+        } | undefined>;
         default: undefined;
         validator: (obj: {
             value: string;
@@ -53,7 +65,10 @@ declare const _default: import("vue").DefineComponent<import("vue").ExtractPropT
         } | undefined) => boolean;
     };
     value: {
-        type: ObjectConstructor;
+        type: PropType<{
+            value: string;
+            type: string;
+        } | undefined>;
         default: undefined;
         validator: (obj: {
             value: string;
@@ -87,8 +102,14 @@ declare const _default: import("vue").DefineComponent<import("vue").ExtractPropT
     label: string;
     icon: string;
     required: boolean;
-    modelValue: Record<string, any>;
-    value: Record<string, any>;
+    modelValue: {
+        value: string;
+        type: string;
+    } | undefined;
+    value: {
+        value: string;
+        type: string;
+    } | undefined;
     error: string;
     types: ("msg" | "flow" | "global" | "str" | "num" | "bool" | "json" | "bin" | "re" | "jsonata" | "date" | "env" | "node" | "cred" | NodeRED.TypedInputTypeDefinition)[];
 }, {}, {