From 929de15c73c99b80996720222bff6967191baad3 Mon Sep 17 00:00:00 2001 From: Brooklyn Nicholson Date: Sun, 27 Sep 2026 12:51:14 -0500 Subject: [PATCH] docs(desktop): correct WorkspacePageHeaderControl older-host note A named import of a missing SDK export fails to link through the runtime shim, so the plugin never loads; it is not undefined. Point authors at a namespace-import feature-detect or the raw Contribute form. Refs #123597 Originally authored by Justin Haynes (@jhaynes). --- website/docs/developer-guide/desktop-plugin-sdk.md | 8 +++++--- 1 file changed, 5 insertions(+), 3 deletions(-) diff --git a/website/docs/developer-guide/desktop-plugin-sdk.md b/website/docs/developer-guide/desktop-plugin-sdk.md index 5bbc349a83..c63cdb148f 100644 --- a/website/docs/developer-guide/desktop-plugin-sdk.md +++ b/website/docs/developer-guide/desktop-plugin-sdk.md @@ -832,9 +832,11 @@ jsx(WorkspacePageHeaderControl, { }) ``` -`WorkspacePageHeaderControl` is new in this release. A plugin that must also -run on older desktop builds, where the import is `undefined`, keeps the raw -`Contribute` form above. +`WorkspacePageHeaderControl` is new in this release. Older desktop builds don't +export it, and a named import of a missing SDK export stops the plugin module +from loading. A plugin that must also run on older builds either feature-detects +through a namespace import (`import * as sdk from '@hermes/plugin-sdk'`, then +`sdk.WorkspacePageHeaderControl ?? …`) or keeps the raw `Contribute` form above. ### Sidebar nav visibility and order (`SIDEBAR_NAV_PREFS_AREA`)