feat: add shared.js template for sharing constants between runtime and UI

Author: alex2844

docs/README.md

@@ -46,6 +46,7 @@ my-nodes/
 │   ├── nodes/
 │   │   └── example/
 │   │       ├── runtime.js       # Node.js runtime
+│   │       ├── shared.js        # Shared logic and constants
 │   │       ├── ui.js            # Browser editor logic
 │   │       └── template.html    # Editor panel HTML
 │   └── locales/

docs/ru/README.md

@@ -46,6 +46,7 @@ my-nodes/
 │   ├── nodes/
 │   │   └── example/
 │   │       ├── runtime.js       # Рантайм (Node.js)
+│   │       ├── shared.js        # Расшаренная логика и константы
 │   │       ├── ui.js            # Логика редактора (браузер)
 │   │       └── template.html    # HTML-шаблон панели
 │   └── locales/

packages/create-node-red/README.md

@@ -40,7 +40,7 @@ Calls `nrb init [projectDir]`, which generates:
 
 With `--example` flag, it also generates an example node:
 
-- `src/nodes/example/` — `runtime.js`, `ui.js`, `template.html`
+- `src/nodes/example/` — `runtime.js`, `shared.js`, `ui.js`, `template.html`
 - `src/locales/en-US/example.json`
 - `docs/en-US/nodes/example.md`
 

packages/create-node-red/docs/ru/README.md

@@ -39,7 +39,7 @@ bunx create-node-red my-nodes
 
 С флагом `--example` также генерируется узел-пример:
 
-- `src/nodes/example/` — `runtime.js`, `ui.js`, `template.html`
+- `src/nodes/example/` — `runtime.js`, `shared.js`, `ui.js`, `template.html`
 - `src/locales/en-US/example.json`
 - `docs/en-US/nodes/example.md`
 

packages/node-red-builder/README.md

@@ -70,6 +70,7 @@ full type safety in the editor.
 Creates:
 
 - `src/nodes/<name>/runtime.js`
+- `src/nodes/<name>/shared.js` (for functional nodes only)
 - `src/nodes/<name>/ui.js`
 - `src/nodes/<name>/template.html`
 - `src/locales/en-US/<name>.json`

packages/node-red-builder/docs/ru/README.md

@@ -68,6 +68,7 @@ CLI и рантайм-фреймворк для разработки нод Node
 Создаёт:
 
 - `src/nodes/<name>/runtime.js`
+- `src/nodes/<name>/shared.js` (только для функциональных нод)
 - `src/nodes/<name>/ui.js`
 - `src/nodes/<name>/template.html`
 - `src/locales/en-US/<name>.json`

packages/node-red-builder/src/cli/utils.js

@@ -204,6 +204,8 @@ export async function generateNode({ nodeName, prefix, color, type = 'node', con
 	const localeTemplate = isConfigNode ? 'src/locales/en-US/config-node.json' : 'src/locales/en-US/node.json';
 	await copyTemplate(localeTemplate, `src/locales/en-US/${nodeName}.json`, replacements);
 
-	if (!isConfigNode)
+	if (!isConfigNode) {
+		await copyTemplate(`${templateDir}/shared.js`, `src/nodes/${nodeName}/shared.js`, replacements);
 		await copyTemplate('docs/en-US/nodes/node.md', `docs/en-US/nodes/${nodeName}.md`, replacements);
+	}
 }

packages/node-red-builder/templates/src/nodes/node/runtime.js

@@ -1,17 +1,10 @@
 import { BaseNode, registerNode } from 'node-red-builder';
+import { ACTION } from './shared.js';
 /** @import { NodeMessage, NodeAPI } from 'node-red' */
 /** @import { NodeProps as BaseNodeProps } from 'node-red-builder' */
+/** @import { Action } from './shared.js' */
 // __CONFIG_IMPORT__
 
-/** @typedef {(typeof ACTION)[keyof typeof ACTION]} Action */
-export const ACTION = /** @type {const} */ ({
-	APPLY: 'apply',
-	RESTART: 'restart',
-	ADD: 'add',
-	DEL: 'delete',
-	UPDATE: 'update'
-});
-
 /** @typedef {Omit<BaseNodeProps, 'config'> & { action: string, actionType: 'action'|'str'|'msg' }} NodeProps */
 
 /** @extends {BaseNode<NodeProps>} */

packages/node-red-builder/templates/src/nodes/node/shared.js

@@ -0,0 +1,8 @@
+/** @typedef {(typeof ACTION)[keyof typeof ACTION]} Action */
+export const ACTION = /** @type {const} */ ({
+	APPLY: 'apply',
+	RESTART: 'restart',
+	ADD: 'add',
+	DEL: 'delete',
+	UPDATE: 'update'
+});

packages/node-red-builder/templates/src/nodes/node/ui.js

@@ -1,8 +1,9 @@
 import { setupTypedInput, createTypedInputOptions } from 'node-red-builder/ui';
-import { ACTION } from './runtime.js';
+import { ACTION } from './shared.js';
 /** @import { EditorRED } from 'node-red' */
 /** @import { EditorDefaults, TypedInputDefinition } from 'node-red-builder/ui' */
-/** @import { Action, __NODE_CLASS__ } from './runtime.js' */
+/** @import { Action } from './shared.js' */
+/** @import { __NODE_CLASS__ } from './runtime.js' */
 
 let /** @type {EditorRED} */ RED = /** @type {any} */ (window).RED;