Repository navigation
docs(custom-nodes): publish frontend extension migration guides and canvas pointer API - #2223
Conversation
…anvas pointer API Amp-Thread-ID: https://ampcode.com/threads/T-01a19df1-12f1-7428-a314-3b9547d383b9
|
Preview deployment for your docs. Learn more about Mintlify Previews.
💡 Tip: Enable Automations to automatically generate PRs for you. |
🌐 i18n translation sync checkEnglish docs changed in this PR. 64 files in 4 languages may not be synced yet. The automated translation workflow handles these updates. Expand a language to see the files. Japanese (
|
|
Warning Review limit reached
This review includes 5 billable files and costs up to $1.25.
Reviews can continue after your included limit without a manual trigger. An admin must approve usage-based billing. Or wait 30 minutes for your next included review. View limit details
|
| Layer / File(s) | Summary |
|---|---|
Canvas pointer handling custom-nodes/js/canvas-pointer-api.mdx, docs.json |
Documents click, drag, double-click, and selection handling; widget pointer callbacks; hover state; and custom cursor control. Adds the page to navigation. |
Link registration and connection callbacks custom-nodes/js/link-registration-migration.mdx, custom-nodes/js/connection-callbacks-migration.mdx, docs.json |
Documents link registration results and views, callback ordering, workflow and API prompt loading, and node lifecycle events. Adds the migration pages to navigation. |
Widget migration custom-nodes/js/widgets-migration.mdx |
Documents widget registration and store-backed values, gallery inputs, removal, and Agent updates through widget APIs. |
Serialization callbacks custom-nodes/js/serialization-callbacks-migration.mdx |
Documents Pinia requirements, callback data, persistence surfaces, serialization behavior, and node property enumeration. |
Node identity and geometry custom-nodes/js/node-id-migration.mdx, custom-nodes/js/node-geometry-migration.mdx |
Documents string node IDs, geometry APIs, rendered bounds, z-order, and updates to detached objects. |
PrimeVue removal custom-nodes/js/primevue-removal-migration.mdx, docs.json |
Documents PrimeVue removal, theme variable mappings, tooltip changes, and icon usage. Adds the migration page to navigation. |
Possibly related PRs
- Comfy-Org/docs#1575: Maps legacy frontend extension surfaces to the published V2 JavaScript SDK, a connected migration path.
Suggested reviewers: comfyui-wiki
Merge Risk: 
Low · previous review d241c
-
This PR only adds documentation. Some examples and statements, mainly on serialization hooks and connection rejection, could lead extension authors to lose data or leave links in a bad state if copied as written. The PrimeIcons guidance also conflicts with two existing pages. These are fixable text edits and should be corrected before or shortly after merge.
Pre-merge checks: 
2
Finishing Touches
-
Generate unit tests (beta)
-
- Commit to this branch
- Create a new PR
Simplify code
-
- Commit to this branch
- Create a new PR
-
- Autofix · Keep fixing CodeRabbit findings and required CI, and resolving merge conflicts
…n and widget edge cases Amp-Thread-ID: https://ampcode.com/threads/T-01a19df1-12f1-7428-a314-3b9547d383b9
Publishes the ComfyUI frontend's extension migration notes, which until now lived only in the frontend repo, under Custom Nodes > Migration Guides:
onPointerDownand cursor control.Changes from the frontend originals: examples use APIs extensions can reach at runtime. The connection-callbacks guide no longer imports from the internal
@/lib/litegraphalias, the widget guide usesaddCustomWidgetinstead of subclassing the internalBaseWidget, and the node ID guide compares against the string sentinels. English only; translations are left to the i18n pipeline.mint broken-linkspasses.Removes the originals from the frontend: Comfy-Org/ComfyUI_frontend#22731 (Linear FRONT-3790)