adding-deprecation-warnings

Use the defineDeprecatedProperty helper from src/lib/litegraph/src/utils/feedback.ts. It creates an Object.defineProperty getter/setter alias on the target object that forwards reads and writes to the new property while logging a deduplicated deprecation warning.

Search the ComfyUI custom node ecosystem with the comfy_codesearch tool for both the qualified name like widget.oldProp and the bare property name. Document all access patterns such as truthiness checks, local caching, and style mutation to confirm they remain compatible.

No, the alias is created with enumerable set to false, so it is excluded from Object.keys, for...in loops, and JSON.stringify output. It is also configurable, allowing later redefinition if needed.

The warnDeprecated function deduplicates messages using a Set, so each unique warning message is logged only once per session. This prevents console spam even when the deprecated property is accessed heavily inside loops.

Use a deprecation alias when third-party custom nodes still reference the old property name and backward compatibility must be preserved during a grace period. Direct removal is only safe when ecosystem searches confirm zero remaining usage.