@harborclient/sdk 1.6.1 → 1.6.2

package/CHANGELOG.md

@@ -4,6 +4,15 @@ 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`)

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/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.1",
+  "version": "1.6.2",
   "description": "TypeScript SDK for HarborClient development.",
   "keywords": [
     "harborclient",