@harborclient/sdk 1.6.0 → 1.6.2

package/CHANGELOG.md

@@ -4,6 +4,23 @@ All notable changes to this project will be documented in this file.
 
 ## Unreleased
 
+## 1.6.2 - 2026-08-04
+
+- docs(sdk): enhance API index formatting for improved readability. (`52517d89`)
+- feat(docs): add hc_sdk_manifest.json for comprehensive SDK action and command documentation. (`39adb007`)
+- docs(sdk): update AGENTS.md to include additional sync script details. (`61daf83a`)
+- docs(sdk): clean up API index documentation by removing empty entries. (`d6cfb700`)
+- refactor(sdk): replace installReact with setHostReact for improved plugin integration. (`3acb19dd`)
+- feat(docs): update SDK documentation and improve manifest guidelines. (`a85afcea`)
+
+## 1.6.1 - 2026-08-03
+
+- feat(docs): enhance SDK documentation and update API references. (`6331350c`)
+- feat(docs): update SDK documentation and enhance plugin API guidelines. (`46a2a29e`)
+- refactor(ResponseEditor): simplify split pane wrapping and adjust padding. (`4b480786`)
+- feat(settings): enhance deep link handling for settings navigation. (`3d03652e`)
+- feat(gui): add response editor split functionality. (`bd1aaaba`)
+
 ## 1.6.0 - 2026-08-03
 
 - feat(sse): enhance import functionality for Server-Sent Events (SSE). (`e26fa155`)

package/README.md

@@ -4,7 +4,7 @@ TypeScript definitions, utility modules, and React runtime helpers for [HarborCl
 
 **Documentation:** [https://harborclient.github.io/harborclient/sdk/](https://harborclient.github.io/harborclient/sdk/)
 
-Install as a **dev dependency** in your plugin project. The package ships type declarations, HTTP/storage/UI helpers, and a JSX runtime that forwards to the host's React instance via `installReact(hc.react)`.
+Install as a **dev dependency** in your plugin project. The package ships type declarations, HTTP/storage/UI helpers, and a JSX runtime that forwards to the host's React instance (HarborClient installs `hc.react` before `activate(hc)` — no plugin-side setup call is required).
 
 Requires HarborClient **>=1.9.0** when using `hc.pluginId`, renderer HTTP lifecycle events, typed IPC invoke, and host request commands.
 
@@ -19,11 +19,9 @@ See the [install guide](https://harborclient.github.io/harborclient/sdk/install)
 ## Quick start
 
 ```tsx
-import { installReact } from '@harborclient/sdk';
 import type { PluginContext } from '@harborclient/sdk';
 
 export function activate(hc: PluginContext): void {
-  installReact(hc.react);
   // register contributions…
 }
 ```

package/dist/components/CodeEditor/config.js

@@ -26,7 +26,7 @@ export function getCodeEditorConfigStore() {
  * Returns the CodeEditor React context, creating it on first access.
  *
  * Deferred so importing CodeEditor in a plugin bundle does not call requireHostReact()
- * before activate() runs installReact(hc.react).
+ * before the host installs React for the plugin view.
  */
 function getCodeEditorContext() {
     if (codeEditorContext == null) {

package/dist/components/SegmentedTabs/index.d.ts

@@ -1,4 +1,4 @@
-import type { ComponentPropsWithoutRef, JSX } from 'react';
+import type { ComponentPropsWithoutRef, JSX, MouseEvent } from 'react';
 import type { TabItem } from './types.js';
 export { SegmentedTabsGroup } from './SegmentedTabsGroup.js';
 export { SegmentedTabPanel } from './SegmentedTabPanel.js';
@@ -53,10 +53,15 @@ interface Props<T extends string> extends Omit<ComponentPropsWithoutRef<'div'>,
      * `SegmentedTabsGroup`.
      */
     ariaLabel?: string;
+    /**
+     * Called when the user right-clicks a tab button. The browser context menu is
+     * suppressed so hosts can show a custom menu.
+     */
+    onTabContextMenu?: (value: T, event: MouseEvent<HTMLButtonElement>) => void;
 }
 /**
  * macOS-style segmented tab control with WAI-ARIA tabs or radiogroup semantics.
  * The tab strip wraps to additional rows when tabs exceed the container width.
  */
-export declare function SegmentedTabs<T extends string>({ tabs, value: valueProp, onChange: onChangeProp, editable, visibleTabValues: visibleTabValuesProp, defaultVisibleTabValues, onVisibleTabValuesChange, fullWidth, className, pattern, ariaLabel: ariaLabelProp, ...props }: Props<T>): JSX.Element;
+export declare function SegmentedTabs<T extends string>({ tabs, value: valueProp, onChange: onChangeProp, editable, visibleTabValues: visibleTabValuesProp, defaultVisibleTabValues, onVisibleTabValuesChange, fullWidth, className, pattern, ariaLabel: ariaLabelProp, onTabContextMenu, ...props }: Props<T>): JSX.Element;
 //# sourceMappingURL=index.d.ts.map

package/dist/components/SegmentedTabs/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/components/SegmentedTabs/index.tsx"],"names":[],"mappings":"AASA,OAAO,KAAK,EAAE,wBAAwB,EAAE,GAAG,EAAiB,MAAM,OAAO,CAAC;AAM1E,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,YAAY,CAAC;AAE1C,OAAO,EAAE,kBAAkB,EAAE,MAAM,yBAAyB,CAAC;AAC7D,OAAO,EAAE,iBAAiB,EAAE,MAAM,wBAAwB,CAAC;AAC3D,YAAY,EAAE,OAAO,EAAE,MAAM,YAAY,CAAC;AAgD1C,UAAU,KAAK,CAAC,CAAC,SAAS,MAAM,CAAE,SAAQ,IAAI,CAC5C,wBAAwB,CAAC,KAAK,CAAC,EAC/B,UAAU,GAAG,WAAW,GAAG,YAAY,GAAG,UAAU,CACrD;IACC;;OAEG;IACH,IAAI,EAAE,OAAO,CAAC,CAAC,CAAC,EAAE,CAAC;IAEnB;;OAEG;IACH,KAAK,CAAC,EAAE,CAAC,CAAC;IAEV;;;OAGG;IACH,QAAQ,CAAC,EAAE,CAAC,KAAK,EAAE,CAAC,KAAK,IAAI,CAAC;IAE9B;;OAEG;IACH,QAAQ,CAAC,EAAE,OAAO,CAAC;IAEnB;;;OAGG;IACH,gBAAgB,CAAC,EAAE,CAAC,EAAE,CAAC;IAEvB;;;OAGG;IACH,uBAAuB,CAAC,EAAE,CAAC,EAAE,CAAC;IAE9B;;OAEG;IACH,wBAAwB,CAAC,EAAE,CAAC,gBAAgB,EAAE,CAAC,EAAE,KAAK,IAAI,CAAC;IAE3D;;OAEG;IACH,SAAS,CAAC,EAAE,OAAO,CAAC;IAEpB;;OAEG;IACH,SAAS,CAAC,EAAE,MAAM,CAAC;IAEnB;;;OAGG;IACH,OAAO,CAAC,EAAE,MAAM,GAAG,YAAY,CAAC;IAEhC;;;OAGG;IACH,SAAS,CAAC,EAAE,MAAM,CAAC;CACpB;AAED;;;GAGG;AACH,wBAAgB,aAAa,CAAC,CAAC,SAAS,MAAM,EAAE,EAC9C,IAAI,EACJ,KAAK,EAAE,SAAS,EAChB,QAAQ,EAAE,YAAY,EACtB,QAAe,EACf,gBAAgB,EAAE,oBAAoB,EACtC,uBAAuB,EACvB,wBAAwB,EACxB,SAAiB,EACjB,SAAS,EACT,OAAgB,EAChB,SAAS,EAAE,aAAa,EACxB,GAAG,KAAK,EACT,EAAE,KAAK,CAAC,CAAC,CAAC,GAAG,GAAG,CAAC,OAAO,CA4PxB"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/components/SegmentedTabs/index.tsx"],"names":[],"mappings":"AASA,OAAO,KAAK,EAAE,wBAAwB,EAAE,GAAG,EAAiB,UAAU,EAAE,MAAM,OAAO,CAAC;AAMtF,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,YAAY,CAAC;AAE1C,OAAO,EAAE,kBAAkB,EAAE,MAAM,yBAAyB,CAAC;AAC7D,OAAO,EAAE,iBAAiB,EAAE,MAAM,wBAAwB,CAAC;AAC3D,YAAY,EAAE,OAAO,EAAE,MAAM,YAAY,CAAC;AAgD1C,UAAU,KAAK,CAAC,CAAC,SAAS,MAAM,CAAE,SAAQ,IAAI,CAC5C,wBAAwB,CAAC,KAAK,CAAC,EAC/B,UAAU,GAAG,WAAW,GAAG,YAAY,GAAG,UAAU,CACrD;IACC;;OAEG;IACH,IAAI,EAAE,OAAO,CAAC,CAAC,CAAC,EAAE,CAAC;IAEnB;;OAEG;IACH,KAAK,CAAC,EAAE,CAAC,CAAC;IAEV;;;OAGG;IACH,QAAQ,CAAC,EAAE,CAAC,KAAK,EAAE,CAAC,KAAK,IAAI,CAAC;IAE9B;;OAEG;IACH,QAAQ,CAAC,EAAE,OAAO,CAAC;IAEnB;;;OAGG;IACH,gBAAgB,CAAC,EAAE,CAAC,EAAE,CAAC;IAEvB;;;OAGG;IACH,uBAAuB,CAAC,EAAE,CAAC,EAAE,CAAC;IAE9B;;OAEG;IACH,wBAAwB,CAAC,EAAE,CAAC,gBAAgB,EAAE,CAAC,EAAE,KAAK,IAAI,CAAC;IAE3D;;OAEG;IACH,SAAS,CAAC,EAAE,OAAO,CAAC;IAEpB;;OAEG;IACH,SAAS,CAAC,EAAE,MAAM,CAAC;IAEnB;;;OAGG;IACH,OAAO,CAAC,EAAE,MAAM,GAAG,YAAY,CAAC;IAEhC;;;OAGG;IACH,SAAS,CAAC,EAAE,MAAM,CAAC;IAEnB;;;OAGG;IACH,gBAAgB,CAAC,EAAE,CAAC,KAAK,EAAE,CAAC,EAAE,KAAK,EAAE,UAAU,CAAC,iBAAiB,CAAC,KAAK,IAAI,CAAC;CAC7E;AAED;;;GAGG;AACH,wBAAgB,aAAa,CAAC,CAAC,SAAS,MAAM,EAAE,EAC9C,IAAI,EACJ,KAAK,EAAE,SAAS,EAChB,QAAQ,EAAE,YAAY,EACtB,QAAe,EACf,gBAAgB,EAAE,oBAAoB,EACtC,uBAAuB,EACvB,wBAAwB,EACxB,SAAiB,EACjB,SAAS,EACT,OAAgB,EAChB,SAAS,EAAE,aAAa,EACxB,gBAAgB,EAChB,GAAG,KAAK,EACT,EAAE,KAAK,CAAC,CAAC,CAAC,GAAG,GAAG,CAAC,OAAO,CAqQxB"}

package/dist/components/SegmentedTabs/index.js

@@ -49,7 +49,7 @@ function focusFirstFocusableInPanel(panel) {
  * macOS-style segmented tab control with WAI-ARIA tabs or radiogroup semantics.
  * The tab strip wraps to additional rows when tabs exceed the container width.
  */
-export function SegmentedTabs({ tabs, value: valueProp, onChange: onChangeProp, editable = true, visibleTabValues: visibleTabValuesProp, defaultVisibleTabValues, onVisibleTabValuesChange, fullWidth = false, className, pattern = 'tabs', ariaLabel: ariaLabelProp, ...props }) {
+export function SegmentedTabs({ tabs, value: valueProp, onChange: onChangeProp, editable = true, visibleTabValues: visibleTabValuesProp, defaultVisibleTabValues, onVisibleTabValuesChange, fullWidth = false, className, pattern = 'tabs', ariaLabel: ariaLabelProp, onTabContextMenu, ...props }) {
     const context = useContext(SegmentedTabsContext);
     const standaloneId = useId();
     const tabRefs = useRef(new Map());
@@ -197,7 +197,12 @@ export function SegmentedTabs({ tabs, value: valueProp, onChange: onChangeProp,
                                 tabRefs.current.set(tab.value, element);
                             else
                                 tabRefs.current.delete(tab.value);
-                        }, type: "button", className: tabClassName, disabled: tab.disabled, tabIndex: tab.disabled ? -1 : 0, onClick: () => onChange(tab.value), ...(isRadiogroup
+                        }, type: "button", className: tabClassName, disabled: tab.disabled, tabIndex: tab.disabled ? -1 : 0, "data-tab-value": tab.value, onClick: () => onChange(tab.value), onContextMenu: onTabContextMenu
+                            ? (event) => {
+                                event.preventDefault();
+                                onTabContextMenu(tab.value, event);
+                            }
+                            : undefined, ...(isRadiogroup
                             ? { role: 'radio', 'aria-checked': selected }
                             : {
                                 role: 'tab',

package/dist/components/SettingIdLabel/index.d.ts

@@ -8,9 +8,16 @@ export interface Props {
      * Stable setting id shown on hover and keyboard focus.
      */
     settingId: string;
+    /**
+     * Optional content between the label and the setting id (e.g. a cog actions menu).
+     */
+    afterLabel?: ReactNode;
 }
 /**
  * Setting label with a VS Code-style id affordance revealed on hover and focus.
+ *
+ * Renders as `<label> [afterLabel] <setting id>` so actions sit after the title
+ * and before the hover-revealed id.
  */
-export declare function SettingIdLabel({ children, settingId }: Props): JSX.Element;
+export declare function SettingIdLabel({ children, settingId, afterLabel }: Props): JSX.Element;
 //# sourceMappingURL=index.d.ts.map

package/dist/components/SettingIdLabel/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/components/SettingIdLabel/index.tsx"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,GAAG,EAAE,SAAS,EAAE,MAAM,OAAO,CAAC;AAE5C,MAAM,WAAW,KAAK;IACpB;;OAEG;IACH,QAAQ,EAAE,SAAS,CAAC;IAEpB;;OAEG;IACH,SAAS,EAAE,MAAM,CAAC;CACnB;AAED;;GAEG;AACH,wBAAgB,cAAc,CAAC,EAAE,QAAQ,EAAE,SAAS,EAAE,EAAE,KAAK,GAAG,GAAG,CAAC,OAAO,CAa1E"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/components/SettingIdLabel/index.tsx"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,GAAG,EAAE,SAAS,EAAE,MAAM,OAAO,CAAC;AAE5C,MAAM,WAAW,KAAK;IACpB;;OAEG;IACH,QAAQ,EAAE,SAAS,CAAC;IAEpB;;OAEG;IACH,SAAS,EAAE,MAAM,CAAC;IAElB;;OAEG;IACH,UAAU,CAAC,EAAE,SAAS,CAAC;CACxB;AAED;;;;;GAKG;AACH,wBAAgB,cAAc,CAAC,EAAE,QAAQ,EAAE,SAAS,EAAE,UAAU,EAAE,EAAE,KAAK,GAAG,GAAG,CAAC,OAAO,CActF"}

package/dist/components/SettingIdLabel/index.js

@@ -1,7 +1,10 @@
 import { jsx as _jsx, jsxs as _jsxs } from "@harborclient/sdk/jsx-runtime";
 /**
  * Setting label with a VS Code-style id affordance revealed on hover and focus.
+ *
+ * Renders as `<label> [afterLabel] <setting id>` so actions sit after the title
+ * and before the hover-revealed id.
  */
-export function SettingIdLabel({ children, settingId }) {
-    return (_jsxs("span", { className: "group/setting-label inline-flex items-baseline gap-2", children: [_jsx("span", { children: children }), _jsx("span", { className: "pointer-events-none font-mono text-[14px] text-muted opacity-0 transition-opacity select-none group-focus-within/setting-label:opacity-100 group-hover/setting-label:opacity-100", title: settingId, "aria-label": `Setting id: ${settingId}`, children: settingId })] }));
+export function SettingIdLabel({ children, settingId, afterLabel }) {
+    return (_jsxs("span", { className: "group/setting-label inline-flex min-w-0 items-center gap-2", children: [_jsx("span", { children: children }), afterLabel, _jsx("span", { className: "pointer-events-none font-mono text-[14px] text-muted opacity-0 transition-opacity select-none group-focus-within/setting-label:opacity-100 group-hover/setting-label:opacity-100", title: settingId, "aria-label": `Setting id: ${settingId}`, children: settingId })] }));
 }

package/dist/runtime/index.d.ts

@@ -1,15 +1,6 @@
 import type * as React from 'react';
 import type { Disposable, ImportHandler, PluginContext, ThemeContribution } from '../types.js';
 
-/**
- * Installs the HarborClient renderer React instance for plugin JSX and hooks.
- *
- * Call once at the start of `activate(hc)` before registering UI contributions.
- *
- * @param react - React namespace from `hc.react`.
- */
-export function installReact(react: typeof React): void;
-
 /**
  * Creates a React component from a factory that receives the host React namespace.
  *

package/dist/runtime/index.js

@@ -1,15 +1,4 @@
-import { requireHostReact, setHostReact } from './reactHost.js';
-
-/**
- * Installs the HarborClient renderer React instance for plugin JSX and hooks.
- *
- * Call once at the start of `activate(hc)` before registering UI contributions.
- *
- * @param {typeof import('react')} react - React namespace from `hc.react`.
- */
-export function installReact(react) {
-  setHostReact(react);
-}
+import { requireHostReact } from './reactHost.js';
 
 /**
  * Creates a React component from a factory that receives the host React namespace.
@@ -26,7 +15,7 @@ export function createPluginComponent(factory) {
   let Component = null;
 
   /**
-   * Lazily builds the component on first render after installReact().
+   * Lazily builds the component on first render after the host installs React.
    *
    * @param {P} props - Component props.
    * @returns {import('react').ReactElement | null}

package/dist/runtime/jsx-runtime-host.js

@@ -8,7 +8,7 @@ export const Fragment = React.Fragment;
  * Used when bundling third-party deps (e.g. @uiw/react-codemirror,
  * @fortawesome/react-fontawesome) that import `react/jsx-runtime`. Aliasing
  * those imports to this module keeps them on the same host React instance as
- * the plugin shell without requiring installReact() to have run first.
+ * the plugin shell without requiring the host React install to have run first.
  *
  * @param {import('react').ElementType} type - Element type or Fragment.
  * @param {Record<string, unknown> | null | undefined} props - Element props.

package/dist/runtime/reactHost.js

@@ -53,7 +53,7 @@ export function requireHostReact() {
   }
   if (hostReact == null) {
     throw new Error(
-      'Plugin React host is not installed. Call installReact(hc.react) at the start of activate().'
+      'Plugin React host is not installed. The view host must call setHostReact() before activate().'
     );
   }
   return hostReact;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@harborclient/sdk",
-  "version": "1.6.0",
+  "version": "1.6.2",
   "description": "TypeScript SDK for HarborClient development.",
   "keywords": [
     "harborclient",
@@ -229,6 +229,7 @@
     "debug": "^4.4.3",
     "eslint": "^10.5.0",
     "jsdom": "^26.1.0",
+    "markdown-it": "^15.0.0",
     "mermaid": "^11.15.0",
     "overlayscrollbars": "^2.16.0",
     "overlayscrollbars-react": "^0.5.6",
@@ -238,6 +239,7 @@
     "react-dom": "^19.2.7",
     "react-markdown": "^10.1.0",
     "remark-gfm": "^4.0.1",
+    "shiki": "^4.4.1",
     "storybook": "^10.4.6",
     "tailwindcss": "^4.3.1",
     "typescript": "^5.8.3",
@@ -265,7 +267,7 @@
     "storybook": "storybook dev -p 6006",
     "build-storybook": "storybook build -o docs/.vitepress/static/storybook",
     "docs:build": "pnpm docs:build:nav && pnpm build-storybook && vitepress build docs",
-    "docs:build:nav": "node scripts/build-docs-nav.mjs && node scripts/assert-docs-slugs.mjs",
+    "docs:build:nav": "node scripts/build-hc-api-docs.mjs && node scripts/build-docs-nav.mjs && node scripts/assert-docs-slugs.mjs",
     "docs:preview": "pnpm docs:build && vitepress preview docs",
     "docs:serve": "pnpm docs:build:nav && concurrently --kill-others --prefixColors=auto -n nav,vp \"node scripts/watch-docs-nav.mjs\" \"vitepress dev docs\"",
     "plugin:sign": "pnpm build && node dist/signing/cli-sign.js",