@harborclient/sdk 1.6.0 → 1.6.1

package/CHANGELOG.md

@@ -4,6 +4,14 @@ All notable changes to this project will be documented in this file.
 
 ## Unreleased
 
+## 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/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/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@harborclient/sdk",
-  "version": "1.6.0",
+  "version": "1.6.1",
   "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",