@bonsae/nrg 0.1.0 → 0.3.0

package/build/index.js

@@ -0,0 +1,7 @@
+// src/utils.ts
+function defineRuntimeSettings(settings) {
+  return settings;
+}
+export {
+  defineRuntimeSettings
+};

package/build/server/index.cjs

@@ -661,13 +661,24 @@ function NodeRef(nodeClass, options) {
   };
 }
 function TypedInput(options) {
+  const { types, ...rest } = options ?? {};
   return {
     ...TypedInputSchema,
-    ...options,
+    ...rest,
+    ...types ? { "x-typed-types": types } : {},
     [import_typebox.Kind]: "TypedInput"
   };
 }
+var _OriginalString = import_typebox.Type.String.bind(import_typebox.Type);
+function StringWithLang(options) {
+  const { lang, ...rest } = options ?? {};
+  return _OriginalString({
+    ...rest,
+    ...lang ? { "x-editor-language": lang } : {}
+  });
+}
 var SchemaType = Object.assign({}, import_typebox.Type, {
+  String: StringWithLang,
   NodeRef,
   TypedInput
 });

package/build/server/resources/nrg-client.js

@@ -1,4 +1,4 @@
-(function(){var s=document.createElement("style");s.textContent="[data-v-e5c98949] .node-red-vue-input-error-message{color:var(--red-ui-text-color-error)}[data-v-e5c98949] .nrg-label{display:inline-block;width:100%;cursor:default}[data-v-e5c98949] .form-row input[type=text],[data-v-e5c98949] .form-row input[type=number],[data-v-e5c98949] .form-row input[type=password]{height:34px;padding:0 8px;box-sizing:border-box}.container[data-v-508cfdb8]{position:relative}.expand-button[data-v-508cfdb8]{position:absolute;top:-23px;right:0;z-index:10;transition:color .3s ease;cursor:pointer}.nrg-required[data-v-642581e2]{color:var(--red-ui-text-color-error);margin-left:2px}\n";document.head.appendChild(s);})();
+(function(){var s=document.createElement("style");s.textContent="[data-v-e5c98949] .node-red-vue-input-error-message{color:var(--red-ui-text-color-error)}[data-v-e5c98949] .nrg-label{display:inline-block;width:100%;cursor:default}[data-v-e5c98949] .form-row input[type=text],[data-v-e5c98949] .form-row input[type=number],[data-v-e5c98949] .form-row input[type=password]{height:34px;padding:0 8px;box-sizing:border-box}.container[data-v-508cfdb8]{position:relative}.expand-button[data-v-508cfdb8]{position:absolute;top:-23px;right:0;z-index:10;transition:color .3s ease;cursor:pointer}.nrg-required[data-v-2a313890]{color:var(--red-ui-text-color-error);margin-left:2px}\n";document.head.appendChild(s);})();
 import { defineComponent as je, resolveComponent as qe, openBlock as te, createElementBlock as re, Fragment as Ke, createElementVNode as ue, createCommentVNode as ge, createVNode as Vn, toDisplayString as Pe, withDirectives as ws, vShow as bs, renderList as fr, createTextVNode as pr, createBlock as ze, createApp as Es } from "/nrg/assets/vue.esm-browser.prod.js";
 function Ss() {
 }
@@ -6168,7 +6168,13 @@ function Dn(e, t, r) {
         language: t["x-editor-language"]
       } : { key: e, label: s, inputType: "text", required: r, htmlType: "text" };
     default:
-      return {
+      return t["x-editor-language"] ? {
+        key: e,
+        label: s,
+        inputType: "editor",
+        required: r,
+        language: t["x-editor-language"]
+      } : {
         key: e,
         label: s,
         inputType: "text",
@@ -6348,7 +6354,7 @@ function Bo(e, t, r, s, m, o) {
     ))
   ]);
 }
-const Mn = /* @__PURE__ */ Ie(zo, [["render", Bo], ["__scopeId", "data-v-642581e2"]]), gs = {}, sr = {};
+const Mn = /* @__PURE__ */ Ie(zo, [["render", Bo], ["__scopeId", "data-v-2a313890"]]), gs = {}, sr = {};
 function Qo(e) {
   Object.assign(gs, e);
 }

package/build/vite/index.js

@@ -111,9 +111,6 @@ function mergeOptions(defaults, overrides) {
   }
   return result;
 }
-function defineRuntimeSettings(settings) {
-  return settings;
-}
 
 // src/vite/node-red-launcher.ts
 import { spawn } from "child_process";
@@ -1183,14 +1180,15 @@ function minifier() {
   return {
     name: "vite-plugin-node-red:client:minifier",
     apply: "build",
-    renderChunk: {
-      order: "post",
-      async handler(code, chunk, outputOptions) {
-        if (outputOptions.format === "es" && chunk.fileName.endsWith(".js")) {
-          const result = await transform(code, { minify: true });
-          return result.code;
+    async generateBundle(_options, bundle) {
+      for (const [fileName, chunk] of Object.entries(bundle)) {
+        if (chunk.type === "chunk" && fileName.endsWith(".js")) {
+          const result = await transform(chunk.code, {
+            minify: true
+          });
+          chunk.code = result.code;
+          chunk.map = null;
         }
-        return code;
       }
     }
   };
@@ -1204,8 +1202,6 @@ import fs8 from "fs";
 import mime2 from "mime-types";
 var VIRTUAL_ID = "virtual:nrg/node-definitions";
 var RESOLVED_ID = "\0" + VIRTUAL_ID;
-var VIRTUAL_ENTRY_ID = "virtual:nrg/client-entry";
-var RESOLVED_ENTRY_ID = "\0" + VIRTUAL_ENTRY_ID;
 var SKIP_DEFAULTS = /* @__PURE__ */ new Set(["x", "y", "z", "g", "wires", "type", "id"]);
 function getDefaultsFromSchema(schema) {
   if (!schema?.properties) return void 0;
@@ -1243,6 +1239,7 @@ function resolveIcon(iconsDir, type) {
 function nodeDefinitionsInliner(serverOutDir, entryPath, iconsDir, componentsDir, nodesDir, hasUserEntry = true) {
   let _nodeTypes = [];
   let _definitions = {};
+  const cacheDir = path8.resolve("node_modules", ".nrg", "client");
   return {
     name: "vite-plugin-node-red:client:node-definitions-inliner",
     enforce: "pre",
@@ -1302,64 +1299,93 @@ function nodeDefinitionsInliner(serverOutDir, entryPath, iconsDir, componentsDir
           outputsSchema
         };
       }
+      if (!hasUserEntry) {
+        const nodesCache = path8.resolve(cacheDir, "nodes");
+        if (fs8.existsSync(nodesCache)) {
+          fs8.rmSync(nodesCache, { recursive: true });
+        }
+        fs8.mkdirSync(nodesCache, { recursive: true });
+        for (const type of _nodeTypes) {
+          const userTsPath = nodesDir ? path8.resolve(nodesDir, `${type}.ts`) : null;
+          if (userTsPath && fs8.existsSync(userTsPath)) continue;
+          const content = [
+            `// auto-generated by nrg`,
+            `import { defineNode } from "@bonsae/nrg/client";`,
+            ``,
+            `export default defineNode({`,
+            `  type: ${JSON.stringify(type)},`,
+            `});`,
+            ``
+          ].join("\n");
+          fs8.writeFileSync(path8.resolve(nodesCache, `${type}.ts`), content);
+        }
+        const entryContent = generateEntryCode("");
+        fs8.mkdirSync(path8.dirname(path8.resolve(cacheDir, "index.ts")), {
+          recursive: true
+        });
+        fs8.writeFileSync(path8.resolve(cacheDir, "index.ts"), entryContent);
+      }
     },
     resolveId(id) {
       if (id === VIRTUAL_ID) return RESOLVED_ID;
-      if (id === VIRTUAL_ENTRY_ID) return RESOLVED_ENTRY_ID;
     },
     load(id) {
-      if (id === RESOLVED_ENTRY_ID) return "";
-      if (id !== RESOLVED_ID) return;
-      return `export default ${JSON.stringify(_definitions)};`;
+      if (id === RESOLVED_ID)
+        return `export default ${JSON.stringify(_definitions)};`;
+      if (!hasUserEntry && id === entryPath) {
+        return generateEntryCode("");
+      }
     },
     transform(code, id) {
-      if (id !== entryPath && id !== RESOLVED_ENTRY_ID) return;
-      const nrgImports = /* @__PURE__ */ new Set(["__setSchemas"]);
-      const lines = [`import __nrgSchemas from "${VIRTUAL_ID}";`];
-      const postLines = [`__setSchemas(__nrgSchemas);`];
-      if (componentsDir && fs8.existsSync(componentsDir)) {
-        const formImports = [];
-        const formEntries = [];
-        for (const type of _nodeTypes) {
-          const componentPath = path8.resolve(componentsDir, `${type}.vue`);
-          if (fs8.existsSync(componentPath)) {
-            const varName = `__nrgForm_${type.replace(/-/g, "_")}`;
-            formImports.push(
-              `import ${varName} from ${JSON.stringify(componentPath)};`
-            );
-            formEntries.push(`${JSON.stringify(type)}: ${varName}`);
-          }
-        }
-        if (formImports.length > 0) {
-          lines.push(...formImports);
-          nrgImports.add("__setForms");
-          postLines.push(`__setForms({ ${formEntries.join(", ")} });`);
+      if (id !== entryPath) return;
+      if (!hasUserEntry) return;
+      return { code: generateEntryCode(code), map: null };
+    }
+  };
+  function generateEntryCode(userCode) {
+    const nrgImports = /* @__PURE__ */ new Set(["__setSchemas"]);
+    const lines = [`import __nrgSchemas from "${VIRTUAL_ID}";`];
+    const postLines = [`__setSchemas(__nrgSchemas);`];
+    if (componentsDir && fs8.existsSync(componentsDir)) {
+      const formImports = [];
+      const formEntries = [];
+      for (const type of _nodeTypes) {
+        const componentPath = path8.resolve(componentsDir, `${type}.vue`);
+        if (fs8.existsSync(componentPath)) {
+          const varName = `__nrgForm_${type.replace(/-/g, "_")}`;
+          formImports.push(
+            `import ${varName} from ${JSON.stringify(componentPath)};`
+          );
+          formEntries.push(`${JSON.stringify(type)}: ${varName}`);
         }
       }
-      if (!hasUserEntry) {
-        const defVarNames = [];
-        for (const type of _nodeTypes) {
-          const varName = `__nrgNodeDef_${type.replace(/-/g, "_")}`;
-          const tsPath = nodesDir ? path8.resolve(nodesDir, `${type}.ts`) : null;
-          if (tsPath && fs8.existsSync(tsPath)) {
-            lines.push(`import ${varName} from ${JSON.stringify(tsPath)};`);
-          } else {
-            lines.push(`const ${varName} = { type: ${JSON.stringify(type)} };`);
-          }
-          defVarNames.push(varName);
-        }
-        if (defVarNames.length > 0) {
-          nrgImports.add("registerTypes");
-          postLines.push(`registerTypes([${defVarNames.join(", ")}]);`);
-        }
+      if (formImports.length > 0) {
+        lines.push(...formImports);
+        nrgImports.add("__setForms");
+        postLines.push(`__setForms({ ${formEntries.join(", ")} });`);
       }
-      const importLine = `import { ${[...nrgImports].join(", ")} } from "@bonsae/nrg/client";`;
-      lines.splice(1, 0, importLine);
-      lines.push(...postLines);
-      lines.push("");
-      return { code: lines.join("\n") + code, map: null };
     }
-  };
+    if (!hasUserEntry) {
+      const nodesCache = path8.resolve(cacheDir, "nodes");
+      const defVarNames = [];
+      for (const type of _nodeTypes) {
+        const varName = `__nrgNodeDef_${type.replace(/-/g, "_")}`;
+        const userTsPath = nodesDir ? path8.resolve(nodesDir, `${type}.ts`) : null;
+        const tsPath = userTsPath && fs8.existsSync(userTsPath) ? userTsPath : path8.resolve(nodesCache, `${type}.ts`);
+        lines.push(`import ${varName} from ${JSON.stringify(tsPath)};`);
+        defVarNames.push(varName);
+      }
+      if (defVarNames.length > 0) {
+        nrgImports.add("registerTypes");
+        postLines.push(`registerTypes([${defVarNames.join(", ")}]);`);
+      }
+    }
+    const importLine = `import { ${[...nrgImports].join(", ")} } from "@bonsae/nrg/client";`;
+    lines.splice(1, 0, importLine);
+    lines.push(...postLines);
+    lines.push("");
+    return lines.join("\n") + userCode;
+  }
 }
 
 // src/vite/client/plugins/static-copy.ts
@@ -1525,7 +1551,7 @@ async function build2(clientBuildOptions, buildContext) {
     build: {
       outDir: buildContext.outDir,
       emptyOutDir: false,
-      sourcemap: buildContext.isDev ? "inline" : true,
+      sourcemap: buildContext.isDev ? "inline" : false,
       minify: !buildContext.isDev && format !== "es",
       copyPublicDir: false,
       lib: {
@@ -1888,6 +1914,5 @@ function nodeRed(options = {}) {
   ];
 }
 export {
-  defineRuntimeSettings,
   nodeRed
 };

package/build/vite/utils.js

@@ -48,13 +48,9 @@ function mergeOptions(defaults, overrides) {
   }
   return result;
 }
-function defineRuntimeSettings(settings) {
-  return settings;
-}
 export {
   cleanDir,
   copyFiles,
-  defineRuntimeSettings,
   getPackageName,
   mergeOptions
 };

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@bonsae/nrg",
-  "version": "0.1.0",
+  "version": "0.3.0",
   "description": "NRG framework — build Node-RED nodes with Vue 3, TypeScript, and JSON Schema",
   "author": "Allan Oricil <allanoricil@duck.com>",
   "license": "MIT",
@@ -23,6 +23,9 @@
     "lint:fix": "eslint src/ --fix",
     "format": "prettier --write \"src/**/*.{ts,vue,json}\"",
     "format:check": "prettier --check \"src/**/*.{ts,vue,json}\"",
+    "docs:dev": "pnpm --dir docs dev",
+    "docs:build": "pnpm --dir docs build",
+    "docs:preview": "pnpm --dir docs preview",
     "prepare": "husky"
   },
   "files": [
@@ -30,6 +33,10 @@
     "build/"
   ],
   "exports": {
+    ".": {
+      "types": "./src/index.ts",
+      "default": "./build/index.js"
+    },
     "./server": {
       "types": "./src/core/server/index.ts",
       "require": "./build/server/index.cjs",

package/src/core/client/components/node-red-json-schema-form.vue

@@ -291,6 +291,16 @@ function buildField(
       return { key, label, inputType: "text", required, htmlType: "text" };
 
     default:
+      // string with editor language → code editor
+      if (schema["x-editor-language"]) {
+        return {
+          key,
+          label,
+          inputType: "editor",
+          required,
+          language: schema["x-editor-language"],
+        };
+      }
       // string (or untyped)
       return {
         key,

package/src/core/server/schemas/type.ts

@@ -26,15 +26,29 @@ function NodeRef<T extends new (...args: any[]) => any>(
   } as unknown as TNodeRef<InstanceType<T>>;
 }
 
-function TypedInput(options?: SchemaOptions): TTypedInput {
+function TypedInput(
+  options?: SchemaOptions & { types?: string[] },
+): TTypedInput {
+  const { types, ...rest } = options ?? {};
   return {
     ...TypedInputSchema,
-    ...options,
+    ...rest,
+    ...(types ? { "x-typed-types": types } : {}),
     [Kind]: "TypedInput",
   } as unknown as TTypedInput;
 }
 
+const _OriginalString = BaseType.String.bind(BaseType);
+function StringWithLang(options?: SchemaOptions & { lang?: string }) {
+  const { lang, ...rest } = options ?? {};
+  return _OriginalString({
+    ...rest,
+    ...(lang ? { "x-editor-language": lang } : {}),
+  });
+}
+
 const SchemaType = Object.assign({}, BaseType, {
+  String: StringWithLang,
   NodeRef,
   TypedInput,
 });

package/src/index.ts

@@ -0,0 +1,2 @@
+export { defineRuntimeSettings } from "./utils";
+export type { NodeRedRuntimeSettings } from "./types";

package/src/types.ts

@@ -0,0 +1,189 @@
+import type { Http2ServerRequest } from "http2";
+
+export interface NodeRedRuntimeSettings {
+  userDir?: string;
+  nodesDir?: string | string[];
+  flowFile?: string;
+  flowFilePretty?: boolean;
+  credentialSecret?: string | false;
+  requireHttps?: boolean;
+  https?:
+    | { key: string; cert: string }
+    | (() =>
+        | Promise<{ key: string; cert: string }>
+        | { key: string; cert: string });
+  httpsRefreshInterval?: number;
+  httpAdminRoot?: string;
+  httpNodeRoot?: string;
+  httpNodeCors?: { origin: string; methods: string };
+  httpStatic?: string | { path: string; root: string }[];
+  httpStaticRoot?: string;
+  httpAdminMiddleware?: (req: unknown, res: unknown, next: () => void) => void;
+  httpNodeMiddleware?: (req: unknown, res: unknown, next: () => void) => void;
+  httpServerOptions?: Record<string, unknown>;
+  adminAuth?: {
+    type?: "credentials" | "strategy";
+    users?: {
+      username: string;
+      password: string;
+      permissions?: string | string[];
+    }[];
+    default?: {
+      permissions?: string | string[];
+    };
+    tokens?: (
+      token: string,
+    ) => Promise<{ user: string; permissions: string | string[] } | null>;
+    tokenHeader: "string";
+    sessionExpiryTime?: number;
+    [key: string]: unknown;
+  };
+  httpNodeAuth?: {
+    user?: string;
+    pass?: string;
+  };
+  httpStaticAuth?: {
+    user?: string;
+    pass?: string;
+  };
+  lang?:
+    | "en-US"
+    | "de"
+    | "es-ES"
+    | "fr"
+    | "ko"
+    | "pt-BR"
+    | "ru"
+    | "ja"
+    | "zh-CN"
+    | "zh-TW";
+  diagnostics?: {
+    enabled?: boolean;
+    ui?: boolean;
+  };
+  runtimeState?: {
+    enabled?: boolean;
+    ui?: boolean;
+  };
+  disableEditor?: boolean;
+  editorTheme?: {
+    page?: {
+      title?: string;
+      favicon?: string;
+      css?: string | string[];
+      scripts?: string | string[];
+    };
+    header?: {
+      title?: string;
+      image?: string;
+      url?: string;
+    };
+    deployButton?: {
+      type?: "simple" | "default";
+      label?: string;
+      icon?: string;
+    };
+    menu?: {
+      "menu-item-import-library"?: boolean;
+      "menu-item-export-library"?: boolean;
+      "menu-item-keyboard-shortcuts"?: boolean;
+      "menu-item-help"?: {
+        label?: string;
+        url?: string;
+      };
+      [menuItem: string]:
+        | boolean
+        | { label?: string; url?: string }
+        | undefined;
+    };
+    userMenu?: boolean;
+    login?: {
+      image?: string;
+    };
+    logout?: {
+      redirect?: string;
+    };
+    palette?: {
+      catalogues?: string[];
+      categories?: string[];
+      theme?: { category: string; type: string; color: string }[];
+    };
+    projects?: {
+      enabled?: boolean;
+      workflow?: {
+        mode: "manual" | "auto";
+      };
+    };
+    codeEditor?: {
+      lib?: "monaco" | "ace";
+      options?: Record<string, unknown>;
+    };
+    mermaid?: {
+      theme?: string;
+    };
+    tours?: boolean;
+    theme?: string;
+    [key: string]: unknown;
+  };
+  contextStorage?: {
+    default?: {
+      module?: "memory" | "localfilesystem" | object;
+      config?: Record<string, unknown>;
+    };
+    [store: string]:
+      | {
+          module?: "memory" | "localfilesystem" | object;
+          config?: Record<string, unknown>;
+        }
+      | undefined;
+  };
+  exportGlobalContextKeys?: boolean;
+  logging?: {
+    console?: {
+      level?: "fatal" | "error" | "warn" | "info" | "debug" | "trace" | "off";
+      metrics?: boolean;
+      audit?: boolean;
+    };
+  };
+  fileWorkingDirectory?: string;
+  functionExternalModules?: boolean;
+  functionGlobalContext?: Record<string, unknown>;
+  nodeMessageBufferMaxLength?: number;
+  functionTimeout?: number;
+  externalModules?: {
+    autoInstall?: boolean;
+    autoInstallRetry?: number;
+    palette?: {
+      allowInstall?: boolean;
+      allowUpdate?: boolean;
+      allowUpload?: boolean;
+      allowList?: string[];
+      denyList?: string[];
+      allowUpdateList?: string[];
+      denyUpdateList?: string[];
+    };
+    modules?: {
+      allowInstall?: boolean;
+      allowList?: string[];
+      denyList?: string[];
+    };
+  };
+  execMaxBufferSize?: number;
+  debugMaxLength?: number;
+  debugUseColors?: boolean;
+  httpRequestTimeout?: number;
+  mqttReconnectTime?: number;
+  serialReconnectTime?: number;
+  socketReconnectTime?: number;
+  socketTimeout?: number;
+  tcpMsgQueueSize?: number;
+  inboundWebSocketTimeout?: number;
+  tlsConfigDisableLocalFiles?: boolean;
+  webSocketNodeVerifyClient?: (info: {
+    origin: string;
+    req: Http2ServerRequest;
+    secure: boolean;
+  }) => boolean;
+  apiMaxLength?: string;
+  [key: string]: unknown;
+}

package/src/utils.ts

@@ -0,0 +1,20 @@
+import type { NodeRedRuntimeSettings } from "./types";
+
+/**
+ * Type-safe helper for defining Node-RED runtime settings.
+ *
+ * @example
+ * ```typescript
+ * import { defineRuntimeSettings } from "@bonsae/nrg";
+ *
+ * export default defineRuntimeSettings({
+ *   flowFile: "flows.json",
+ *   flowFilePretty: true,
+ * });
+ * ```
+ */
+export function defineRuntimeSettings(
+  settings: NodeRedRuntimeSettings,
+): NodeRedRuntimeSettings {
+  return settings;
+}

package/src/vite/client/build.ts

@@ -173,7 +173,7 @@ async function build(
     build: {
       outDir: buildContext.outDir,
       emptyOutDir: false,
-      sourcemap: buildContext.isDev ? "inline" : true,
+      sourcemap: buildContext.isDev ? "inline" : false,
       minify: !buildContext.isDev && format !== "es",
       copyPublicDir: false,
       lib: {

package/src/vite/client/plugins/minifier.ts

@@ -6,15 +6,16 @@ function minifier(): Plugin {
     name: "vite-plugin-node-red:client:minifier",
     apply: "build",
 
-    renderChunk: {
-      order: "post",
-      async handler(code, chunk, outputOptions) {
-        if (outputOptions.format === "es" && chunk.fileName.endsWith(".js")) {
-          const result = await transform(code, { minify: true });
-          return result.code;
+    async generateBundle(_options, bundle) {
+      for (const [fileName, chunk] of Object.entries(bundle)) {
+        if (chunk.type === "chunk" && fileName.endsWith(".js")) {
+          const result = await transform(chunk.code, {
+            minify: true,
+          });
+          chunk.code = result.code;
+          chunk.map = null as any;
         }
-        return code;
-      },
+      }
     },
   };
 }

package/src/vite/client/plugins/node-definitions-inliner.ts

@@ -8,9 +8,6 @@ import mime from "mime-types";
 const VIRTUAL_ID = "virtual:nrg/node-definitions";
 const RESOLVED_ID = "\0" + VIRTUAL_ID;
 
-const VIRTUAL_ENTRY_ID = "virtual:nrg/client-entry";
-const RESOLVED_ENTRY_ID = "\0" + VIRTUAL_ENTRY_ID;
-
 const SKIP_DEFAULTS = new Set(["x", "y", "z", "g", "wires", "type", "id"]);
 
 function getDefaultsFromSchema(
@@ -77,6 +74,8 @@ function nodeDefinitionsInliner(
 ): Plugin {
   let _nodeTypes: string[] = [];
   let _definitions: Record<string, any> = {};
+  // Cache directory for generated files (inside node_modules, gitignored)
+  const cacheDir = path.resolve("node_modules", ".nrg", "client");
 
   return {
     name: "vite-plugin-node-red:client:node-definitions-inliner",
@@ -145,80 +144,132 @@ function nodeDefinitionsInliner(
           outputsSchema,
         };
       }
+
+      // When no user entry, generate node definition files in cache
+      // so they appear as separate files in browser devtools.
+      if (!hasUserEntry) {
+        const nodesCache = path.resolve(cacheDir, "nodes");
+        if (fs.existsSync(nodesCache)) {
+          fs.rmSync(nodesCache, { recursive: true });
+        }
+        fs.mkdirSync(nodesCache, { recursive: true });
+
+        for (const type of _nodeTypes) {
+          // Skip if user has a physical node definition file
+          const userTsPath = nodesDir
+            ? path.resolve(nodesDir, `${type}.ts`)
+            : null;
+          if (userTsPath && fs.existsSync(userTsPath)) continue;
+
+          const content = [
+            `// auto-generated by nrg`,
+            `import { defineNode } from "@bonsae/nrg/client";`,
+            ``,
+            `export default defineNode({`,
+            `  type: ${JSON.stringify(type)},`,
+            `});`,
+            ``,
+          ].join("\n");
+          fs.writeFileSync(path.resolve(nodesCache, `${type}.ts`), content);
+        }
+
+        // Also write the entry file to cache
+        const entryContent = generateEntryCode("");
+        fs.mkdirSync(path.dirname(path.resolve(cacheDir, "index.ts")), {
+          recursive: true,
+        });
+        fs.writeFileSync(path.resolve(cacheDir, "index.ts"), entryContent);
+      }
     },
 
     resolveId(id) {
       if (id === VIRTUAL_ID) return RESOLVED_ID;
-      if (id === VIRTUAL_ENTRY_ID) return RESOLVED_ENTRY_ID;
     },
 
     load(id) {
-      if (id === RESOLVED_ENTRY_ID) return "";
-      if (id !== RESOLVED_ID) return;
-      return `export default ${JSON.stringify(_definitions)};`;
+      if (id === RESOLVED_ID)
+        return `export default ${JSON.stringify(_definitions)};`;
+
+      // For auto-generated entries, return the generated code directly
+      // so the browser devtools shows the actual source instead of the
+      // placeholder comment on disk.
+      if (!hasUserEntry && id === entryPath) {
+        return generateEntryCode("");
+      }
     },
 
     transform(code, id) {
-      if (id !== entryPath && id !== RESOLVED_ENTRY_ID) return;
+      if (id !== entryPath) return;
+      // When the user provides their own entry, prepend the generated
+      // code to their source. For auto-generated entries, the load hook
+      // already returned the full code.
+      if (!hasUserEntry) return;
 
-      const nrgImports = new Set<string>(["__setSchemas"]);
-      const lines = [`import __nrgSchemas from "${VIRTUAL_ID}";`];
-      const postLines: string[] = [`__setSchemas(__nrgSchemas);`];
+      return { code: generateEntryCode(code), map: null };
+    },
+  };
 
-      // Auto-detect form components by convention: {componentsDir}/{type}.vue
-      if (componentsDir && fs.existsSync(componentsDir)) {
-        const formImports: string[] = [];
-        const formEntries: string[] = [];
+  function generateEntryCode(userCode: string): string {
+    const nrgImports = new Set<string>(["__setSchemas"]);
+    const lines = [`import __nrgSchemas from "${VIRTUAL_ID}";`];
+    const postLines: string[] = [`__setSchemas(__nrgSchemas);`];
 
-        for (const type of _nodeTypes) {
-          const componentPath = path.resolve(componentsDir, `${type}.vue`);
-          if (fs.existsSync(componentPath)) {
-            const varName = `__nrgForm_${type.replace(/-/g, "_")}`;
-            formImports.push(
-              `import ${varName} from ${JSON.stringify(componentPath)};`,
-            );
-            formEntries.push(`${JSON.stringify(type)}: ${varName}`);
-          }
-        }
+    // Auto-detect form components by convention: {componentsDir}/{type}.vue
+    if (componentsDir && fs.existsSync(componentsDir)) {
+      const formImports: string[] = [];
+      const formEntries: string[] = [];
 
-        if (formImports.length > 0) {
-          lines.push(...formImports);
-          nrgImports.add("__setForms");
-          postLines.push(`__setForms({ ${formEntries.join(", ")} });`);
+      for (const type of _nodeTypes) {
+        const componentPath = path.resolve(componentsDir, `${type}.vue`);
+        if (fs.existsSync(componentPath)) {
+          const varName = `__nrgForm_${type.replace(/-/g, "_")}`;
+          formImports.push(
+            `import ${varName} from ${JSON.stringify(componentPath)};`,
+          );
+          formEntries.push(`${JSON.stringify(type)}: ${varName}`);
         }
       }
 
-      // Auto-register only when no user entry was provided.
-      // When the user provides client/index.ts, they control registration.
-      if (!hasUserEntry) {
-        const defVarNames: string[] = [];
-        for (const type of _nodeTypes) {
-          const varName = `__nrgNodeDef_${type.replace(/-/g, "_")}`;
-          const tsPath = nodesDir ? path.resolve(nodesDir, `${type}.ts`) : null;
-
-          if (tsPath && fs.existsSync(tsPath)) {
-            lines.push(`import ${varName} from ${JSON.stringify(tsPath)};`);
-          } else {
-            lines.push(`const ${varName} = { type: ${JSON.stringify(type)} };`);
-          }
-          defVarNames.push(varName);
-        }
+      if (formImports.length > 0) {
+        lines.push(...formImports);
+        nrgImports.add("__setForms");
+        postLines.push(`__setForms({ ${formEntries.join(", ")} });`);
+      }
+    }
 
-        if (defVarNames.length > 0) {
-          nrgImports.add("registerTypes");
-          postLines.push(`registerTypes([${defVarNames.join(", ")}]);`);
-        }
+    // Auto-register only when no user entry was provided.
+    if (!hasUserEntry) {
+      const nodesCache = path.resolve(cacheDir, "nodes");
+      const defVarNames: string[] = [];
+
+      for (const type of _nodeTypes) {
+        const varName = `__nrgNodeDef_${type.replace(/-/g, "_")}`;
+        // Use physical file if user has one, otherwise use cached generated file
+        const userTsPath = nodesDir
+          ? path.resolve(nodesDir, `${type}.ts`)
+          : null;
+        const tsPath =
+          userTsPath && fs.existsSync(userTsPath)
+            ? userTsPath
+            : path.resolve(nodesCache, `${type}.ts`);
+        lines.push(`import ${varName} from ${JSON.stringify(tsPath)};`);
+        defVarNames.push(varName);
       }
 
-      // Build the @bonsae/nrg/client import line
-      const importLine = `import { ${[...nrgImports].join(", ")} } from "@bonsae/nrg/client";`;
-      lines.splice(1, 0, importLine);
+      if (defVarNames.length > 0) {
+        nrgImports.add("registerTypes");
+        postLines.push(`registerTypes([${defVarNames.join(", ")}]);`);
+      }
+    }
 
-      lines.push(...postLines);
-      lines.push("");
-      return { code: lines.join("\n") + code, map: null };
-    },
-  };
+    // Build the @bonsae/nrg/client import line
+    const importLine = `import { ${[...nrgImports].join(", ")} } from "@bonsae/nrg/client";`;
+    lines.splice(1, 0, importLine);
+
+    lines.push(...postLines);
+    lines.push("");
+    return lines.join("\n") + userCode;
+  }
 }
 
 export { nodeDefinitionsInliner };

package/src/vite/index.ts

@@ -1,3 +1,2 @@
 export { nodeRed } from "./plugin";
-export { defineRuntimeSettings } from "./utils";
-export type { NodeRedPluginOptions, NodeRedRuntimeSettings } from "./types";
+export type { NodeRedPluginOptions } from "./types";

package/src/vite/types.ts

@@ -1,6 +1,5 @@
 import type { Plugin } from "vite";
 import type { NodeRedLauncher } from "./node-red-launcher";
-import type { Http2ServerRequest } from "http2";
 
 interface BuildContext {
   outDir: string;
@@ -105,199 +104,6 @@ interface NodeRedPluginOptions {
   extraFilesCopyTargets?: CopyTarget[];
 }
 
-interface NodeRedRuntimeSettings {
-  // NOTE: commented out because the preferred port must be set using NodeRedLauncherOptions.runtime.port
-  // uiPort?: number;
-  // NOTE: commented out because the plugin set it to 127.0.0.1
-  // uiHost?: string;
-  userDir?: string;
-  nodesDir?: string | string[];
-  flowFile?: string;
-  flowFilePretty?: boolean;
-  credentialSecret?: string | false;
-  requireHttps?: boolean;
-  https?:
-    | { key: string; cert: string }
-    | (() =>
-        | Promise<{ key: string; cert: string }>
-        | { key: string; cert: string });
-  httpsRefreshInterval?: number;
-  httpAdminRoot?: string;
-  httpNodeRoot?: string;
-  httpNodeCors?: { origin: string; methods: string };
-  httpStatic?: string | { path: string; root: string }[];
-  httpStaticRoot?: string;
-  httpAdminMiddleware?: (req: unknown, res: unknown, next: () => void) => void;
-  httpNodeMiddleware?: (req: unknown, res: unknown, next: () => void) => void;
-  httpServerOptions?: Record<string, unknown>;
-  adminAuth?: {
-    type?: "credentials" | "strategy";
-    users?: {
-      username: string;
-      password: string;
-      permissions?: string | string[];
-    }[];
-    default?: {
-      permissions?: string | string[];
-    };
-    tokens?: (
-      token: string,
-    ) => Promise<{ user: string; permissions: string | string[] } | null>;
-    tokenHeader: "string";
-    sessionExpiryTime?: number;
-    [key: string]: unknown;
-  };
-  httpNodeAuth?: {
-    user?: string;
-    pass?: string;
-  };
-  httpStaticAuth?: {
-    user?: string;
-    pass?: string;
-  };
-  lang?:
-    | "en-US"
-    | "de"
-    | "es-ES"
-    | "fr"
-    | "ko"
-    | "pt-BR"
-    | "ru"
-    | "ja"
-    | "zh-CN"
-    | "zh-TW";
-  diagnostics?: {
-    enabled?: boolean;
-    ui?: boolean;
-  };
-  runtimeState?: {
-    enabled?: boolean;
-    ui?: boolean;
-  };
-  disableEditor?: boolean;
-  editorTheme?: {
-    page?: {
-      title?: string;
-      favicon?: string;
-      css?: string | string[];
-      scripts?: string | string[];
-    };
-    header?: {
-      title?: string;
-      image?: string;
-      url?: string;
-    };
-    deployButton?: {
-      type?: "simple" | "default";
-      label?: string;
-      icon?: string;
-    };
-    menu?: {
-      "menu-item-import-library"?: boolean;
-      "menu-item-export-library"?: boolean;
-      "menu-item-keyboard-shortcuts"?: boolean;
-      "menu-item-help"?: {
-        label?: string;
-        url?: string;
-      };
-      [menuItem: string]:
-        | boolean
-        | { label?: string; url?: string }
-        | undefined;
-    };
-    userMenu?: boolean;
-    login?: {
-      image?: string;
-    };
-    logout?: {
-      redirect?: string;
-    };
-    palette?: {
-      catalogues?: string[];
-      categories?: string[];
-      theme?: { category: string; type: string; color: string }[];
-    };
-    projects?: {
-      enabled?: boolean;
-      workflow?: {
-        mode: "manual" | "auto";
-      };
-    };
-    codeEditor?: {
-      lib?: "monaco" | "ace";
-      // TODO: add monaco option types
-      options?: Record<string, unknown>;
-    };
-    mermaid?: {
-      theme?: string;
-    };
-    tours?: boolean;
-    theme?: string;
-    [key: string]: unknown;
-  };
-  contextStorage?: {
-    default?: {
-      module?: "memory" | "localfilesystem" | object;
-      config?: Record<string, unknown>;
-    };
-    [store: string]:
-      | {
-          module?: "memory" | "localfilesystem" | object;
-          config?: Record<string, unknown>;
-        }
-      | undefined;
-  };
-  exportGlobalContextKeys?: boolean;
-  logging?: {
-    console?: {
-      level?: "fatal" | "error" | "warn" | "info" | "debug" | "trace" | "off";
-      metrics?: boolean;
-      audit?: boolean;
-    };
-  };
-  fileWorkingDirectory?: string;
-  functionExternalModules?: boolean;
-  functionGlobalContext?: Record<string, unknown>;
-  nodeMessageBufferMaxLength?: number;
-  functionTimeout?: number;
-  externalModules?: {
-    autoInstall?: boolean;
-    autoInstallRetry?: number;
-    palette?: {
-      allowInstall?: boolean;
-      allowUpdate?: boolean;
-      allowUpload?: boolean;
-      allowList?: string[];
-      denyList?: string[];
-      allowUpdateList?: string[];
-      denyUpdateList?: string[];
-    };
-    modules?: {
-      allowInstall?: boolean;
-      allowList?: string[];
-      denyList?: string[];
-    };
-  };
-  execMaxBufferSize?: number;
-  debugMaxLength?: number;
-  debugUseColors?: boolean;
-  httpRequestTimeout?: number;
-  mqttReconnectTime?: number;
-  serialReconnectTime?: number;
-  socketReconnectTime?: number;
-  socketTimeout?: number;
-  tcpMsgQueueSize?: number;
-  inboundWebSocketTimeout?: number;
-  tlsConfigDisableLocalFiles?: boolean;
-  webSocketNodeVerifyClient?: (info: {
-    origin: string;
-    req: Http2ServerRequest;
-    secure: boolean;
-  }) => boolean;
-  apiMaxLength?: string;
-  [key: string]: unknown;
-}
-
 interface PackageJson {
   name: string;
   version: string;
@@ -362,7 +168,6 @@ export {
   LoggerOptions,
   NodeRedLauncherOptions,
   NodeRedPluginOptions,
-  NodeRedRuntimeSettings,
   PackageJson,
   ServerBuildOptions,
   ServerPluginOptions,

package/src/vite/utils.ts

@@ -1,6 +1,6 @@
 import fs from "fs";
 import path from "path";
-import type { NodeRedRuntimeSettings, PackageJson } from "./types";
+import type { PackageJson } from "./types";
 
 function cleanDir(dir: string) {
   if (fs.existsSync(dir)) {
@@ -69,35 +69,4 @@ function mergeOptions<T extends Record<string, unknown>>(
   return result;
 }
 
-/**
- * Define Node-RED runtime settings with full type support.
- *
- * Note: All paths should be absolute. Use `import.meta.dirname` or `__dirname` to resolve relative paths.
- *
- * @example
- * ```typescript
- * import { defineRuntimeSettings } from "./vite/utils";
- * import path from "path";
- *
- * const __dirname = import.meta.dirname;
- *
- * export default defineRuntimeSettings({
- *   userDir: path.resolve(__dirname, ".node-red"),
- *   flowFile: "flows.json",
- *   httpStatic: path.resolve(__dirname, "public"),
- * });
- * ```
- */
-function defineRuntimeSettings(
-  settings: NodeRedRuntimeSettings,
-): NodeRedRuntimeSettings {
-  return settings;
-}
-
-export {
-  cleanDir,
-  copyFiles,
-  defineRuntimeSettings,
-  getPackageName,
-  mergeOptions,
-};
+export { cleanDir, copyFiles, getPackageName, mergeOptions };