From d6aa562e7aa2b3b62664c575952f6f8cbdbb8a0f Mon Sep 17 00:00:00 2001 From: Connor Byrne Date: Wed, 13 May 2026 13:26:20 -0700 Subject: [PATCH] chore(ext-api): regen api-snapshot after NodeMode doc fix Cascades the foundation fix (8564a19dc7) into the published API snapshot. NodeMode JSDoc now correctly maps numeric slots to LGraphEventMode names (was wrong for slots 1-4 in prior snapshot). Other diff churn is whitespace/format-only from a fresh dts build. --- packages/extension-api/api-snapshot/node.d.ts | 21 ++++++++++++++----- 1 file changed, 16 insertions(+), 5 deletions(-) diff --git a/packages/extension-api/api-snapshot/node.d.ts b/packages/extension-api/api-snapshot/node.d.ts index 4bb642ff6d..e7d26ed260 100644 --- a/packages/extension-api/api-snapshot/node.d.ts +++ b/packages/extension-api/api-snapshot/node.d.ts @@ -17,11 +17,22 @@ export type Size = [width: number, height: number] /** * LiteGraph node execution mode. * - * - `0` — Always execute. - * - `1` — Never execute (muted). - * - `2` — Bypass (passthrough). - * - `3` — Execute once. - * - `4` — Execute on trigger. + * Numeric values match `LGraphEventMode` in the LiteGraph runtime. + * + * - `0` — `ALWAYS`: execute every run (default). + * - `1` — `ON_EVENT`: legacy slot for the dead trigger/action subsystem; + * has no behavioural effect in the current scheduler. Reserved for ABI + * compatibility — do not use in new extensions. + * - `2` — `NEVER`: muted; node is skipped during execution. + * - `3` — `ON_TRIGGER`: legacy slot for the dead trigger/action subsystem; + * gated behind `LiteGraph.do_add_triggers_slots` (always `false`). Reserved + * for ABI compatibility — do not use in new extensions. + * - `4` — `BYPASS`: passthrough; inputs are forwarded to outputs without + * running the node. + * + * Practical extension code should use `0` (always) or `2` (never/muted) or + * `4` (bypass). Slots `1` and `3` are documented for completeness but their + * runtime semantics are pending the AUDIT-LG trigger-subsystem cleanup. * * @stability stable */