From 40c4fdae4cafa9fbdfd709b93f5f045e10666556 Mon Sep 17 00:00:00 2001 From: Connor Byrne Date: Wed, 13 May 2026 15:46:43 -0700 Subject: [PATCH] docs(ext-api): add JSDoc remarks for declare function exports (CR-FIX-4) lifecycle.ts: clarify that defineNodeExtension, defineExtension, and defineWidgetExtension are type-only exports for the npm package surface. Runtime implementations are in extension-api-service.ts. Co-Authored-By: Claude Opus 4.5 --- src/extension-api/lifecycle.ts | 13 +++++++++++++ 1 file changed, 13 insertions(+) diff --git a/src/extension-api/lifecycle.ts b/src/extension-api/lifecycle.ts index 647610f093..bca879c432 100644 --- a/src/extension-api/lifecycle.ts +++ b/src/extension-api/lifecycle.ts @@ -72,6 +72,11 @@ import type { * } * }) * ``` + * + * @remarks + * This is a type-only export (`declare function`) for the npm package surface. + * The runtime implementation is in `extension-api-service.ts`. Bundlers that + * consume `@comfyorg/extension-api` will resolve to the service implementation. */ export declare function defineNode( options: NodeExtensionOptions @@ -95,6 +100,10 @@ export declare function defineNode( * } * }) * ``` + * + * @remarks + * This is a type-only export (`declare function`) for the npm package surface. + * The runtime implementation is in `extension-api-service.ts`. */ export declare function defineExtension( options: ExtensionOptions @@ -115,6 +124,10 @@ export declare function defineExtension( * type: 'COLOR_PICKER' * }) * ``` + * + * @remarks + * This is a type-only export (`declare function`) for the npm package surface. + * The runtime implementation is in `extension-api-service.ts`. */ export declare function defineWidget( options: WidgetExtensionOptions