@bonsae/nrg 0.20.1 → 0.21.0

package/types/server.d.ts

@@ -491,18 +491,18 @@ type InferOutputs<T> = T extends readonly TSchema[] ? {
 } : any;
 declare function NodeRef<T extends new (...args: any[]) => any>(nodeClass: T, options?: NrgSchemaOptions): TNodeRef<InstanceType<T>>;
 declare function TypedInput$1<T = unknown>(options?: NrgSchemaOptions): TTypedInput<T>;
-declare function ReturnProperty(options?: NrgSchemaOptions & {
-	default?: string;
-}): import("@sinclair/typebox").TString;
+declare function OutputReturnProperties(options?: NrgSchemaOptions & {
+	default?: Record<number, string>;
+}): import("@sinclair/typebox").TRecord<import("@sinclair/typebox").TNumber, import("@sinclair/typebox").TString>;
 /**
  * Extended TypeBox type builder with NRG-specific schema types.
  * Includes all standard TypeBox types plus {@link NodeRef}, {@link TypedInput}
- * and {@link ReturnProperty}.
+ * and {@link OutputReturnProperties}.
  */
 export declare const SchemaType: import("@sinclair/typebox").JavaScriptTypeBuilder & {
 	NodeRef: typeof NodeRef;
 	TypedInput: typeof TypedInput$1;
-	ReturnProperty: typeof ReturnProperty;
+	OutputReturnProperties: typeof OutputReturnProperties;
 };
 /**
  * Creates a validated object schema from a set of properties. Automatically
@@ -614,31 +614,43 @@ declare abstract class Node$1<TConfig = any, TCredentials = any, TSettings = any
 	get credentials(): NodeCredentials<TCredentials> | undefined;
 	get settings(): TSettings;
 }
+type SendOptions = {
+	/**
+	 * Node-author default for how the outgoing message carries the incoming
+	 * context. The flow author's per-port override (when set) wins; otherwise
+	 * this is used, falling back to `"carry"` when omitted.
+	 */
+	defaultMode?: ContextMode;
+};
 /**
  * Controls how an outgoing message carries the incoming message's context:
- * - `"nest"` (default): keep all incoming keys and push the full input under
- *   `input`, so the prior message — including any value the result overwrites
- *   — is always recoverable (`msg.input.output`). The `input` chain
- *   accumulates one frame per node, forming a provenance trail visible in the
- *   debug panel.
- * - `"carry"`: keep all incoming keys (including any upstream `input`) but do
- *   not record this node — context flows through without growing.
+ * - `"carry"` (default): keep all incoming keys — including any upstream
+ *   `input` — but do not record this node, so context flows through without the
+ *   provenance chain growing. The safe default for loops and long chains.
+ * - `"trace"`: keep all incoming keys and also push the full input under
+ *   `input`, so the prior message — including any value the result overwrites —
+ *   stays recoverable (`msg.input.output`). The chain accumulates one frame per
+ *   node, a provenance trail visible in the debug panel; opt in for linear
+ *   flows that want full lineage.
  * - `"reset"`: drop all inherited context; the outgoing message is only the
  *   result at the return key.
  */
-export type ContextMode = "nest" | "carry" | "reset";
+export type ContextMode = "carry" | "trace" | "reset";
 /**
  * Base class for nodes that process messages. Provides input/output handling,
  * schema validation, status updates, and emit port management.
  *
  * Every node has a return key (`"output"` by default): the value passed to
- * `send()` is merged into the incoming message at that key and the full prior
- * message is kept under `input` (`{ ...msg, [returnKey]: result, input: msg }`),
- * so upstream properties propagate and the provenance chain is recoverable.
- * Declaring `returnProperty` in the `configSchema` only lets the flow author
- * override the key in the editor — it does not change that a return key always
- * exists. `this.send(x)` always means "x is the result", never "x is the whole
- * message".
+ * `send()` is merged into the incoming message at that key
+ * (`{ ...msg, [returnKey]: result }`), so upstream properties propagate. By
+ * default the context is carried without growing; pass
+ * `{ defaultMode: "trace" }` to also keep the full prior message under `input`
+ * as a recoverable provenance chain. The return key, output validation, and
+ * context mode all resolve per output port; declaring
+ * `outputReturnProperties` in the `configSchema` sets per-port default keys and
+ * lets the flow author pick a key other than `output` per port — it does not
+ * change that a return key always exists. `this.send(x)` always means "x is the result", never "x is the
+ * whole message".
  *
  * @example
  * ```ts
@@ -648,7 +660,7 @@ export type ContextMode = "nest" | "carry" | "reset";
  *   static readonly color = "#ffffff" as const;
  *
  *   async input(msg: Input) {
- *     // sends { ...msg, output: <result>, input: msg }
+ *     // sends { ...msg, output: <result> }
  *     this.send(msg.output.toUpperCase());
  *   }
  * }
@@ -669,7 +681,7 @@ export declare abstract class IONode<TConfig = any, TCredentials = any, TInput =
 	constructor(RED: RED, node: NodeRedNode, config: IONodeConfig<TConfig>, credentials: IONodeCredentials<TCredentials>);
 	[WIRE_HANDLERS](nodeRedNode: NodeRedNode, createdPromise: Promise<void>): void;
 	input(msg: TInput): void | Promise<void>;
-	send(msg: TOutput, contextMode?: ContextMode): void;
+	send(msg: TOutput, options?: SendOptions): void;
 	get baseOutputs(): number;
 	get totalOutputs(): number;
 	/**
@@ -682,7 +694,7 @@ export declare abstract class IONode<TConfig = any, TCredentials = any, TInput =
 	 * throw an error or call `this.error()` for the error port, and the complete
 	 * port is sent automatically on successful input processing.
 	 */
-	sendToPort<P extends (TOutput extends Record<string, Record<string, any>> ? keyof TOutput & string : never) | number>(port: P, msg: P extends keyof TOutput ? TOutput[P] : unknown, contextMode?: ContextMode): void;
+	sendToPort<P extends (TOutput extends Record<string, Record<string, any>> ? keyof TOutput & string : never) | number>(port: P, msg: P extends keyof TOutput ? TOutput[P] : unknown, options?: SendOptions): void;
 	status(status: IONodeStatus): void;
 	error(message: string, msg?: any): void;
 	updateWires(wires: string[][]): void;
@@ -696,8 +708,12 @@ export declare abstract class IONode<TConfig = any, TCredentials = any, TInput =
 type IONodeContextScope = NodeContextScope;
 type IONodeConfig<TConfig = any> = NodeConfig<TConfig> & Static<typeof IONodeConfigSchema> & {
 	validateInput?: boolean;
-	validateOutput?: boolean;
-	returnProperty?: string;
+	/** Per-port output-validation flags, keyed by base-output port index. */
+	validateOutputs?: Record<number, boolean>;
+	/** Per-port return properties, keyed by base-output port index. */
+	outputReturnProperties?: Record<number, string>;
+	/** Per-port context modes, keyed by base-output port index. */
+	contextModes?: Record<number, "carry" | "trace" | "reset">;
 };
 type IONodeCredentials<TCredentials = any> = NodeCredentials<TCredentials>;
 type IONodeStatus = {

package/types/shims/client/types.d.ts

@@ -68,14 +68,19 @@ export interface NodeRedNode {
     outputs?: number;
     /** injected when the node has an inputSchema */
     validateInput?: boolean;
-    /** injected when the node has an outputsSchema */
-    validateOutput?: boolean;
-    /** present when the node's configSchema declares SchemaType.ReturnProperty() */
-    returnProperty?: string;
     /** built-in port toggles, present when declared in the configSchema */
     errorPort?: boolean;
     completePort?: boolean;
     statusPort?: boolean;
+    /**
+     * Per-port output settings, indexed by base-output port; injected (empty) when
+     * the node has an outputsSchema. Read at runtime by IONode.
+     * `outputReturnProperties` is author-declared (SchemaType.OutputReturnProperties)
+     * — present only when the node opts into per-port return keys.
+     */
+    validateOutputs?: Record<number, boolean>;
+    contextModes?: Record<number, "carry" | "trace" | "reset">;
+    outputReturnProperties?: Record<number, string>;
     [key: string]: any;
 }
 export interface NodeDefinition {
@@ -170,6 +175,14 @@ export interface NodeCredentials {
 export interface NodeFeatures {
     hasInputSchema: boolean;
     hasOutputSchema: boolean;
+    /**
+     * Base output ports (excludes built-in error/complete/status), in port-index
+     * order. Drives the per-port context-mode rows in the Outputs subsection.
+     */
+    outputPorts: {
+        index: number;
+        label: string;
+    }[];
 }
 /** Client-side representation of a TypedInput field: the raw value string and its type selector. */
 export interface TypedInputValue {

package/types/test-client-component.d.ts

@@ -80,14 +80,19 @@ interface NodeRedNode {
 	outputs?: number;
 	/** injected when the node has an inputSchema */
 	validateInput?: boolean;
-	/** injected when the node has an outputsSchema */
-	validateOutput?: boolean;
-	/** present when the node's configSchema declares SchemaType.ReturnProperty() */
-	returnProperty?: string;
 	/** built-in port toggles, present when declared in the configSchema */
 	errorPort?: boolean;
 	completePort?: boolean;
 	statusPort?: boolean;
+	/**
+	 * Per-port output settings, indexed by base-output port; injected (empty) when
+	 * the node has an outputsSchema. Read at runtime by IONode.
+	 * `outputReturnProperties` is author-declared (SchemaType.OutputReturnProperties)
+	 * — present only when the node opts into per-port return keys.
+	 */
+	validateOutputs?: Record<number, boolean>;
+	contextModes?: Record<number, "carry" | "trace" | "reset">;
+	outputReturnProperties?: Record<number, string>;
 	[key: string]: any;
 }
 interface JsonPropertySchema extends JsonSchemaObjectExtensions {

package/types/test-client-unit.d.ts

@@ -155,14 +155,19 @@ interface NodeRedNode {
 	outputs?: number;
 	/** injected when the node has an inputSchema */
 	validateInput?: boolean;
-	/** injected when the node has an outputsSchema */
-	validateOutput?: boolean;
-	/** present when the node's configSchema declares SchemaType.ReturnProperty() */
-	returnProperty?: string;
 	/** built-in port toggles, present when declared in the configSchema */
 	errorPort?: boolean;
 	completePort?: boolean;
 	statusPort?: boolean;
+	/**
+	 * Per-port output settings, indexed by base-output port; injected (empty) when
+	 * the node has an outputsSchema. Read at runtime by IONode.
+	 * `outputReturnProperties` is author-declared (SchemaType.OutputReturnProperties)
+	 * — present only when the node opts into per-port return keys.
+	 */
+	validateOutputs?: Record<number, boolean>;
+	contextModes?: Record<number, "carry" | "trace" | "reset">;
+	outputReturnProperties?: Record<number, string>;
 	[key: string]: any;
 }
 interface TypedInputValue {

package/vite/index.js

@@ -2038,113 +2038,363 @@ function localesGenerator(options) {
   ];
   const frameworkLabels = {
     "en-US": {
-      configs: { name: "Name", returnProperty: "Return key" },
+      configs: { name: "Name" },
       toggles: {
-        validateInput: "Validate Input",
-        validateOutput: "Validate Output",
+        validateInput: "Validate",
         errorPort: "Error Port",
         completePort: "Complete Port",
-        statusPort: "Status Port",
-        returnPropertyOverride: "Override return prop key"
+        statusPort: "Status Port"
+      },
+      sections: {
+        portsSettings: "Ports Settings",
+        input: "Input",
+        outputs: "Outputs",
+        lifecyclePorts: "Lifecycle Ports"
+      },
+      outputs: {
+        port: "Port",
+        label: "Label",
+        validate: "Validate",
+        returnProperty: "Return Property",
+        contextMode: "Context Mode"
+      },
+      contextModes: {
+        modes: {
+          default: "Default",
+          carry: "carry",
+          trace: "trace",
+          reset: "reset"
+        }
+      },
+      help: {
+        validateInput: "Validate incoming messages against the input schema before input() runs.",
+        outputs: "Per-port output settings. Validate checks the sent value against the port's schema; Context Mode controls how the incoming message is carried.",
+        lifecyclePorts: "Optional extra output ports that fire on error, on completion, and on every status change.",
+        learnMore: "Learn more"
       }
     },
     de: {
-      configs: { name: "Name", returnProperty: "R\xFCckgabe-Schl\xFCssel" },
+      configs: { name: "Name" },
       toggles: {
-        validateInput: "Eingabe validieren",
-        validateOutput: "Ausgabe validieren",
+        validateInput: "Validieren",
         errorPort: "Fehler-Port",
         completePort: "Abschluss-Port",
-        statusPort: "Status-Port",
-        returnPropertyOverride: "R\xFCckgabe-Schl\xFCssel \xFCberschreiben"
+        statusPort: "Status-Port"
+      },
+      sections: {
+        portsSettings: "Port-Einstellungen",
+        input: "Eingang",
+        outputs: "Ausg\xE4nge",
+        lifecyclePorts: "Lebenszyklus-Ports"
+      },
+      outputs: {
+        port: "Port",
+        label: "Bezeichnung",
+        validate: "Validieren",
+        returnProperty: "R\xFCckgabe-Eigenschaft",
+        contextMode: "Kontextmodus"
+      },
+      contextModes: {
+        modes: {
+          default: "Standard",
+          carry: "carry",
+          trace: "trace",
+          reset: "reset"
+        }
+      },
+      help: {
+        validateInput: "Eingehende Nachrichten vor dem Ausf\xFChren von input() gegen das Eingabe-Schema validieren.",
+        outputs: "Ausgabe-Einstellungen pro Port. Validieren pr\xFCft den gesendeten Wert gegen das Schema des Ports; Kontextmodus steuert, wie die eingehende Nachricht \xFCbertragen wird.",
+        lifecyclePorts: "Optionale zus\xE4tzliche Ausg\xE4nge, die bei Fehler, Abschluss und jeder Status\xE4nderung ausl\xF6sen.",
+        learnMore: "Mehr erfahren"
       }
     },
     "es-ES": {
-      configs: { name: "Nombre", returnProperty: "Clave de retorno" },
+      configs: { name: "Nombre" },
       toggles: {
-        validateInput: "Validar entrada",
-        validateOutput: "Validar salida",
+        validateInput: "Validar",
         errorPort: "Puerto de error",
         completePort: "Puerto de completado",
-        statusPort: "Puerto de estado",
-        returnPropertyOverride: "Sobrescribir clave de retorno"
+        statusPort: "Puerto de estado"
+      },
+      sections: {
+        portsSettings: "Configuraci\xF3n de puertos",
+        input: "Entrada",
+        outputs: "Salidas",
+        lifecyclePorts: "Puertos de ciclo de vida"
+      },
+      outputs: {
+        port: "Puerto",
+        label: "Etiqueta",
+        validate: "Validar",
+        returnProperty: "Propiedad de retorno",
+        contextMode: "Modo de contexto"
+      },
+      contextModes: {
+        modes: {
+          default: "Predeterminado",
+          carry: "carry",
+          trace: "trace",
+          reset: "reset"
+        }
+      },
+      help: {
+        validateInput: "Valida los mensajes entrantes con el esquema de entrada antes de ejecutar input().",
+        outputs: "Ajustes de salida por puerto. Validar comprueba el valor enviado con el esquema del puerto; Modo de contexto controla c\xF3mo se transporta el mensaje entrante.",
+        lifecyclePorts: "Puertos de salida adicionales opcionales que se activan en error, al completar y en cada cambio de estado.",
+        learnMore: "M\xE1s informaci\xF3n"
       }
     },
     fr: {
-      configs: { name: "Nom", returnProperty: "Cl\xE9 de retour" },
+      configs: { name: "Nom" },
       toggles: {
-        validateInput: "Valider l'entr\xE9e",
-        validateOutput: "Valider la sortie",
+        validateInput: "Valider",
         errorPort: "Port d'erreur",
         completePort: "Port de compl\xE9tion",
-        statusPort: "Port de statut",
-        returnPropertyOverride: "Remplacer la cl\xE9 de retour"
+        statusPort: "Port de statut"
+      },
+      sections: {
+        portsSettings: "Param\xE8tres des ports",
+        input: "Entr\xE9e",
+        outputs: "Sorties",
+        lifecyclePorts: "Ports de cycle de vie"
+      },
+      outputs: {
+        port: "Port",
+        label: "Libell\xE9",
+        validate: "Valider",
+        returnProperty: "Propri\xE9t\xE9 de retour",
+        contextMode: "Mode de contexte"
+      },
+      contextModes: {
+        modes: {
+          default: "Par d\xE9faut",
+          carry: "carry",
+          trace: "trace",
+          reset: "reset"
+        }
+      },
+      help: {
+        validateInput: "Valide les messages entrants avec le sch\xE9ma d'entr\xE9e avant l'ex\xE9cution de input().",
+        outputs: "R\xE9glages de sortie par port. Valider v\xE9rifie la valeur envoy\xE9e avec le sch\xE9ma du port ; Mode de contexte contr\xF4le la fa\xE7on dont le message entrant est transmis.",
+        lifecyclePorts: "Ports de sortie suppl\xE9mentaires optionnels d\xE9clench\xE9s en cas d'erreur, \xE0 la fin et \xE0 chaque changement de statut.",
+        learnMore: "En savoir plus"
       }
     },
     ko: {
-      configs: { name: "\uC774\uB984", returnProperty: "\uBC18\uD658 \uD0A4" },
+      configs: { name: "\uC774\uB984" },
       toggles: {
-        validateInput: "\uC785\uB825 \uAC80\uC99D",
-        validateOutput: "\uCD9C\uB825 \uAC80\uC99D",
+        validateInput: "\uAC80\uC99D",
         errorPort: "\uC624\uB958 \uD3EC\uD2B8",
         completePort: "\uC644\uB8CC \uD3EC\uD2B8",
-        statusPort: "\uC0C1\uD0DC \uD3EC\uD2B8",
-        returnPropertyOverride: "\uBC18\uD658 \uD0A4 \uC7AC\uC815\uC758"
+        statusPort: "\uC0C1\uD0DC \uD3EC\uD2B8"
+      },
+      sections: {
+        portsSettings: "\uD3EC\uD2B8 \uC124\uC815",
+        input: "\uC785\uB825",
+        outputs: "\uCD9C\uB825",
+        lifecyclePorts: "\uC218\uBA85 \uC8FC\uAE30 \uD3EC\uD2B8"
+      },
+      outputs: {
+        port: "\uD3EC\uD2B8",
+        label: "\uB808\uC774\uBE14",
+        validate: "\uAC80\uC99D",
+        returnProperty: "\uBC18\uD658 \uC18D\uC131",
+        contextMode: "\uCEE8\uD14D\uC2A4\uD2B8 \uBAA8\uB4DC"
+      },
+      contextModes: {
+        modes: {
+          default: "\uAE30\uBCF8\uAC12",
+          carry: "carry",
+          trace: "trace",
+          reset: "reset"
+        }
+      },
+      help: {
+        validateInput: "input() \uC2E4\uD589 \uC804\uC5D0 \uB4E4\uC5B4\uC624\uB294 \uBA54\uC2DC\uC9C0\uB97C \uC785\uB825 \uC2A4\uD0A4\uB9C8\uB85C \uAC80\uC99D\uD569\uB2C8\uB2E4.",
+        outputs: "\uD3EC\uD2B8\uBCC4 \uCD9C\uB825 \uC124\uC815. \uAC80\uC99D\uC740 \uC804\uC1A1 \uAC12\uC744 \uD3EC\uD2B8 \uC2A4\uD0A4\uB9C8\uB85C \uD655\uC778\uD558\uACE0, \uCEE8\uD14D\uC2A4\uD2B8 \uBAA8\uB4DC\uB294 \uB4E4\uC5B4\uC628 \uBA54\uC2DC\uC9C0\uB97C \uC804\uB2EC\uD558\uB294 \uBC29\uC2DD\uC744 \uC81C\uC5B4\uD569\uB2C8\uB2E4.",
+        lifecyclePorts: "\uC624\uB958, \uC644\uB8CC, \uBAA8\uB4E0 \uC0C1\uD0DC \uBCC0\uACBD \uC2DC \uBC1C\uC0DD\uD558\uB294 \uC120\uD0DD\uC801 \uCD94\uAC00 \uCD9C\uB825 \uD3EC\uD2B8\uC785\uB2C8\uB2E4.",
+        learnMore: "\uC790\uC138\uD788 \uBCF4\uAE30"
       }
     },
     "pt-BR": {
-      configs: { name: "Nome", returnProperty: "Chave de retorno" },
+      configs: { name: "Nome" },
       toggles: {
-        validateInput: "Validar Entrada",
-        validateOutput: "Validar Sa\xEDda",
+        validateInput: "Validar",
         errorPort: "Porta de Erro",
         completePort: "Porta de Conclus\xE3o",
-        statusPort: "Porta de Status",
-        returnPropertyOverride: "Sobrescrever chave de retorno"
+        statusPort: "Porta de Status"
+      },
+      sections: {
+        portsSettings: "Configura\xE7\xF5es de portas",
+        input: "Entrada",
+        outputs: "Sa\xEDdas",
+        lifecyclePorts: "Portas de ciclo de vida"
+      },
+      outputs: {
+        port: "Porta",
+        label: "R\xF3tulo",
+        validate: "Validar",
+        returnProperty: "Propriedade de retorno",
+        contextMode: "Modo de contexto"
+      },
+      contextModes: {
+        modes: {
+          default: "Padr\xE3o",
+          carry: "carry",
+          trace: "trace",
+          reset: "reset"
+        }
+      },
+      help: {
+        validateInput: "Valida as mensagens recebidas com o esquema de entrada antes de input() executar.",
+        outputs: "Configura\xE7\xF5es de sa\xEDda por porta. Validar verifica o valor enviado com o esquema da porta; Modo de contexto controla como a mensagem recebida \xE9 transportada.",
+        lifecyclePorts: "Portas de sa\xEDda extras opcionais que disparam em erro, na conclus\xE3o e a cada mudan\xE7a de status.",
+        learnMore: "Saiba mais"
       }
     },
     ru: {
-      configs: { name: "\u0418\u043C\u044F", returnProperty: "\u041A\u043B\u044E\u0447 \u0432\u043E\u0437\u0432\u0440\u0430\u0442\u0430" },
+      configs: { name: "\u0418\u043C\u044F" },
       toggles: {
-        validateInput: "\u041F\u0440\u043E\u0432\u0435\u0440\u0438\u0442\u044C \u0432\u0445\u043E\u0434",
-        validateOutput: "\u041F\u0440\u043E\u0432\u0435\u0440\u0438\u0442\u044C \u0432\u044B\u0445\u043E\u0434",
+        validateInput: "\u041F\u0440\u043E\u0432\u0435\u0440\u044F\u0442\u044C",
         errorPort: "\u041F\u043E\u0440\u0442 \u043E\u0448\u0438\u0431\u043A\u0438",
         completePort: "\u041F\u043E\u0440\u0442 \u0437\u0430\u0432\u0435\u0440\u0448\u0435\u043D\u0438\u044F",
-        statusPort: "\u041F\u043E\u0440\u0442 \u0441\u0442\u0430\u0442\u0443\u0441\u0430",
-        returnPropertyOverride: "\u041F\u0435\u0440\u0435\u043E\u043F\u0440\u0435\u0434\u0435\u043B\u0438\u0442\u044C \u043A\u043B\u044E\u0447 \u0432\u043E\u0437\u0432\u0440\u0430\u0442\u0430"
+        statusPort: "\u041F\u043E\u0440\u0442 \u0441\u0442\u0430\u0442\u0443\u0441\u0430"
+      },
+      sections: {
+        portsSettings: "\u041D\u0430\u0441\u0442\u0440\u043E\u0439\u043A\u0438 \u043F\u043E\u0440\u0442\u043E\u0432",
+        input: "\u0412\u0445\u043E\u0434",
+        outputs: "\u0412\u044B\u0445\u043E\u0434\u044B",
+        lifecyclePorts: "\u041F\u043E\u0440\u0442\u044B \u0436\u0438\u0437\u043D\u0435\u043D\u043D\u043E\u0433\u043E \u0446\u0438\u043A\u043B\u0430"
+      },
+      outputs: {
+        port: "\u041F\u043E\u0440\u0442",
+        label: "\u041C\u0435\u0442\u043A\u0430",
+        validate: "\u041F\u0440\u043E\u0432\u0435\u0440\u044F\u0442\u044C",
+        returnProperty: "\u0421\u0432\u043E\u0439\u0441\u0442\u0432\u043E \u0432\u043E\u0437\u0432\u0440\u0430\u0442\u0430",
+        contextMode: "\u0420\u0435\u0436\u0438\u043C \u043A\u043E\u043D\u0442\u0435\u043A\u0441\u0442\u0430"
+      },
+      contextModes: {
+        modes: {
+          default: "\u041F\u043E \u0443\u043C\u043E\u043B\u0447\u0430\u043D\u0438\u044E",
+          carry: "carry",
+          trace: "trace",
+          reset: "reset"
+        }
+      },
+      help: {
+        validateInput: "\u041F\u0440\u043E\u0432\u0435\u0440\u044F\u0442\u044C \u0432\u0445\u043E\u0434\u044F\u0449\u0438\u0435 \u0441\u043E\u043E\u0431\u0449\u0435\u043D\u0438\u044F \u043F\u043E \u0441\u0445\u0435\u043C\u0435 \u0432\u0432\u043E\u0434\u0430 \u043F\u0435\u0440\u0435\u0434 \u0432\u044B\u0437\u043E\u0432\u043E\u043C input().",
+        outputs: "\u041D\u0430\u0441\u0442\u0440\u043E\u0439\u043A\u0438 \u0432\u044B\u0432\u043E\u0434\u0430 \u0434\u043B\u044F \u043A\u0430\u0436\u0434\u043E\u0433\u043E \u043F\u043E\u0440\u0442\u0430. \xAB\u041F\u0440\u043E\u0432\u0435\u0440\u044F\u0442\u044C\xBB \u0441\u0432\u0435\u0440\u044F\u0435\u0442 \u043E\u0442\u043F\u0440\u0430\u0432\u043B\u0435\u043D\u043D\u043E\u0435 \u0437\u043D\u0430\u0447\u0435\u043D\u0438\u0435 \u0441\u043E \u0441\u0445\u0435\u043C\u043E\u0439 \u043F\u043E\u0440\u0442\u0430; \xAB\u0420\u0435\u0436\u0438\u043C \u043A\u043E\u043D\u0442\u0435\u043A\u0441\u0442\u0430\xBB \u0443\u043F\u0440\u0430\u0432\u043B\u044F\u0435\u0442 \u0442\u0435\u043C, \u043A\u0430\u043A \u043F\u0435\u0440\u0435\u043D\u043E\u0441\u0438\u0442\u0441\u044F \u0432\u0445\u043E\u0434\u044F\u0449\u0435\u0435 \u0441\u043E\u043E\u0431\u0449\u0435\u043D\u0438\u0435.",
+        lifecyclePorts: "\u0414\u043E\u043F\u043E\u043B\u043D\u0438\u0442\u0435\u043B\u044C\u043D\u044B\u0435 \u043D\u0435\u043E\u0431\u044F\u0437\u0430\u0442\u0435\u043B\u044C\u043D\u044B\u0435 \u0432\u044B\u0445\u043E\u0434\u043D\u044B\u0435 \u043F\u043E\u0440\u0442\u044B, \u0441\u0440\u0430\u0431\u0430\u0442\u044B\u0432\u0430\u044E\u0449\u0438\u0435 \u043F\u0440\u0438 \u043E\u0448\u0438\u0431\u043A\u0435, \u0437\u0430\u0432\u0435\u0440\u0448\u0435\u043D\u0438\u0438 \u0438 \u043A\u0430\u0436\u0434\u043E\u043C \u0438\u0437\u043C\u0435\u043D\u0435\u043D\u0438\u0438 \u0441\u0442\u0430\u0442\u0443\u0441\u0430.",
+        learnMore: "\u041F\u043E\u0434\u0440\u043E\u0431\u043D\u0435\u0435"
       }
     },
     ja: {
-      configs: { name: "\u540D\u524D", returnProperty: "\u623B\u308A\u30AD\u30FC" },
+      configs: { name: "\u540D\u524D" },
       toggles: {
-        validateInput: "\u5165\u529B\u691C\u8A3C",
-        validateOutput: "\u51FA\u529B\u691C\u8A3C",
+        validateInput: "\u691C\u8A3C",
         errorPort: "\u30A8\u30E9\u30FC\u30DD\u30FC\u30C8",
         completePort: "\u5B8C\u4E86\u30DD\u30FC\u30C8",
-        statusPort: "\u30B9\u30C6\u30FC\u30BF\u30B9\u30DD\u30FC\u30C8",
-        returnPropertyOverride: "\u623B\u308A\u30AD\u30FC\u3092\u4E0A\u66F8\u304D"
+        statusPort: "\u30B9\u30C6\u30FC\u30BF\u30B9\u30DD\u30FC\u30C8"
+      },
+      sections: {
+        portsSettings: "\u30DD\u30FC\u30C8\u8A2D\u5B9A",
+        input: "\u5165\u529B",
+        outputs: "\u51FA\u529B",
+        lifecyclePorts: "\u30E9\u30A4\u30D5\u30B5\u30A4\u30AF\u30EB\u30DD\u30FC\u30C8"
+      },
+      outputs: {
+        port: "\u30DD\u30FC\u30C8",
+        label: "\u30E9\u30D9\u30EB",
+        validate: "\u691C\u8A3C",
+        returnProperty: "\u623B\u308A\u30D7\u30ED\u30D1\u30C6\u30A3",
+        contextMode: "\u30B3\u30F3\u30C6\u30AD\u30B9\u30C8\u30E2\u30FC\u30C9"
+      },
+      contextModes: {
+        modes: {
+          default: "\u30C7\u30D5\u30A9\u30EB\u30C8",
+          carry: "carry",
+          trace: "trace",
+          reset: "reset"
+        }
+      },
+      help: {
+        validateInput: "input() \u306E\u5B9F\u884C\u524D\u306B\u3001\u53D7\u4FE1\u30E1\u30C3\u30BB\u30FC\u30B8\u3092\u5165\u529B\u30B9\u30AD\u30FC\u30DE\u3067\u691C\u8A3C\u3057\u307E\u3059\u3002",
+        outputs: "\u30DD\u30FC\u30C8\u3054\u3068\u306E\u51FA\u529B\u8A2D\u5B9A\u3002\u691C\u8A3C\u306F\u9001\u4FE1\u5024\u3092\u30DD\u30FC\u30C8\u306E\u30B9\u30AD\u30FC\u30DE\u3067\u78BA\u8A8D\u3057\u3001\u30B3\u30F3\u30C6\u30AD\u30B9\u30C8\u30E2\u30FC\u30C9\u306F\u53D7\u4FE1\u30E1\u30C3\u30BB\u30FC\u30B8\u306E\u5F15\u304D\u7D99\u304E\u65B9\u3092\u5236\u5FA1\u3057\u307E\u3059\u3002",
+        lifecyclePorts: "\u30A8\u30E9\u30FC\u6642\u30FB\u5B8C\u4E86\u6642\u30FB\u30B9\u30C6\u30FC\u30BF\u30B9\u5909\u66F4\u3054\u3068\u306B\u767A\u706B\u3059\u308B\u4EFB\u610F\u306E\u8FFD\u52A0\u51FA\u529B\u30DD\u30FC\u30C8\u3002",
+        learnMore: "\u8A73\u7D30"
       }
     },
     "zh-CN": {
-      configs: { name: "\u540D\u79F0", returnProperty: "\u8FD4\u56DE\u952E" },
+      configs: { name: "\u540D\u79F0" },
       toggles: {
-        validateInput: "\u9A8C\u8BC1\u8F93\u5165",
-        validateOutput: "\u9A8C\u8BC1\u8F93\u51FA",
+        validateInput: "\u9A8C\u8BC1",
         errorPort: "\u9519\u8BEF\u7AEF\u53E3",
         completePort: "\u5B8C\u6210\u7AEF\u53E3",
-        statusPort: "\u72B6\u6001\u7AEF\u53E3",
-        returnPropertyOverride: "\u8986\u76D6\u8FD4\u56DE\u952E"
+        statusPort: "\u72B6\u6001\u7AEF\u53E3"
+      },
+      sections: {
+        portsSettings: "\u7AEF\u53E3\u8BBE\u7F6E",
+        input: "\u8F93\u5165",
+        outputs: "\u8F93\u51FA",
+        lifecyclePorts: "\u751F\u547D\u5468\u671F\u7AEF\u53E3"
+      },
+      outputs: {
+        port: "\u7AEF\u53E3",
+        label: "\u6807\u7B7E",
+        validate: "\u9A8C\u8BC1",
+        returnProperty: "\u8FD4\u56DE\u5C5E\u6027",
+        contextMode: "\u4E0A\u4E0B\u6587\u6A21\u5F0F"
+      },
+      contextModes: {
+        modes: {
+          default: "\u9ED8\u8BA4",
+          carry: "carry",
+          trace: "trace",
+          reset: "reset"
+        }
+      },
+      help: {
+        validateInput: "\u5728 input() \u8FD0\u884C\u524D\uFF0C\u6839\u636E\u8F93\u5165\u6A21\u5F0F\u6821\u9A8C\u4F20\u5165\u6D88\u606F\u3002",
+        outputs: "\u6309\u7AEF\u53E3\u7684\u8F93\u51FA\u8BBE\u7F6E\u3002\u9A8C\u8BC1\u6839\u636E\u7AEF\u53E3\u6A21\u5F0F\u6821\u9A8C\u53D1\u9001\u7684\u503C\uFF1B\u4E0A\u4E0B\u6587\u6A21\u5F0F\u63A7\u5236\u5982\u4F55\u643A\u5E26\u4F20\u5165\u6D88\u606F\u3002",
+        lifecyclePorts: "\u53EF\u9009\u7684\u989D\u5916\u8F93\u51FA\u7AEF\u53E3\uFF0C\u5728\u51FA\u9519\u3001\u5B8C\u6210\u4EE5\u53CA\u6BCF\u6B21\u72B6\u6001\u53D8\u5316\u65F6\u89E6\u53D1\u3002",
+        learnMore: "\u4E86\u89E3\u66F4\u591A"
       }
     },
     "zh-TW": {
-      configs: { name: "\u540D\u7A31", returnProperty: "\u8FD4\u56DE\u9375" },
+      configs: { name: "\u540D\u7A31" },
       toggles: {
-        validateInput: "\u9A57\u8B49\u8F38\u5165",
-        validateOutput: "\u9A57\u8B49\u8F38\u51FA",
+        validateInput: "\u9A57\u8B49",
         errorPort: "\u932F\u8AA4\u7AEF\u53E3",
         completePort: "\u5B8C\u6210\u7AEF\u53E3",
-        statusPort: "\u72C0\u614B\u7AEF\u53E3",
-        returnPropertyOverride: "\u8986\u84CB\u8FD4\u56DE\u9375"
+        statusPort: "\u72C0\u614B\u7AEF\u53E3"
+      },
+      sections: {
+        portsSettings: "\u7AEF\u53E3\u8A2D\u5B9A",
+        input: "\u8F38\u5165",
+        outputs: "\u8F38\u51FA",
+        lifecyclePorts: "\u751F\u547D\u9031\u671F\u7AEF\u53E3"
+      },
+      outputs: {
+        port: "\u7AEF\u53E3",
+        label: "\u6A19\u7C64",
+        validate: "\u9A57\u8B49",
+        returnProperty: "\u8FD4\u56DE\u5C6C\u6027",
+        contextMode: "\u5167\u5BB9\u6A21\u5F0F"
+      },
+      contextModes: {
+        modes: {
+          default: "\u9810\u8A2D",
+          carry: "carry",
+          trace: "trace",
+          reset: "reset"
+        }
+      },
+      help: {
+        validateInput: "\u5728 input() \u57F7\u884C\u524D\uFF0C\u4F9D\u8F38\u5165\u7D50\u69CB\u63CF\u8FF0\u9A57\u8B49\u50B3\u5165\u8A0A\u606F\u3002",
+        outputs: "\u4F9D\u9023\u63A5\u57E0\u7684\u8F38\u51FA\u8A2D\u5B9A\u3002\u9A57\u8B49\u4F9D\u9023\u63A5\u57E0\u7D50\u69CB\u63CF\u8FF0\u6AA2\u67E5\u9001\u51FA\u7684\u503C\uFF1B\u5167\u5BB9\u6A21\u5F0F\u63A7\u5236\u5982\u4F55\u651C\u5E36\u50B3\u5165\u8A0A\u606F\u3002",
+        lifecyclePorts: "\u53EF\u9078\u7684\u984D\u5916\u8F38\u51FA\u9023\u63A5\u57E0\uFF0C\u5728\u767C\u751F\u932F\u8AA4\u3001\u5B8C\u6210\u4EE5\u53CA\u6BCF\u6B21\u72C0\u614B\u8B8A\u66F4\u6642\u89F8\u767C\u3002",
+        learnMore: "\u77AD\u89E3\u66F4\u591A"
       }
     }
   };
@@ -2351,7 +2601,8 @@ function nodeDefinitionsInliner(serverOutDir, entryPath, iconsDir, componentsDir
           defaults.validateInput = { required: false, value: false };
         }
         if (defaults && outputsSchema) {
-          defaults.validateOutput = { required: false, value: false };
+          defaults.validateOutputs = { required: false, value: {} };
+          defaults.contextModes = { required: false, value: {} };
         }
         const credentials = getCredentialsFromSchema(credentialsSchema);
         _definitions[type] = {