@hachej/boring-workspace 0.1.62 → 0.1.63

package/docs/README.md

@@ -34,6 +34,7 @@ the doc that matches your task.
 | Abstraction | Where | What it is |
 | --- | --- | --- |
 | `WorkspaceProvider` | `src/front/provider` | Root provider; boots plugins, layout, bridge. |
+| `useWorkspaceLeftPaneActions()` | `@hachej/boring-workspace` | Public hook for host apps that want to render workspace left-pane category buttons inside their own explorer/sidebar without mounting `WorkbenchLeftPane`. |
 | `definePlugin()` | `@hachej/boring-workspace/plugin` | Declarative front plugin: panels, commands, catalogs, bindings, providers, surfaceResolvers. |
 | `defineServerPlugin()` | `@hachej/boring-workspace/server` | Trusted boot-time server plugin: routes, agent tools, system prompt, Pi packages, provisioning. |
 | `PaneProps<T>` | `src/shared/types/panel.ts` | Props every panel/page component receives (`params`, `api`, `containerApi`). |
@@ -66,6 +67,34 @@ the doc that matches your task.
   reset; agent consumes them under `[data-boring-agent]`. See
   [`docs/TAILWIND-V4-STYLE-ISOLATION.md`](../../../docs/TAILWIND-V4-STYLE-ISOLATION.md).
 
+## Host explorer composition
+
+Standalone workspaces can keep using `WorkbenchLeftPane`. Apps that already own a
+left explorer/sidebar can instead render the category actions themselves:
+
+```tsx
+import { useWorkspaceLeftPaneActions } from "@hachej/boring-workspace"
+
+function HostExplorer({ onOpenPanel, activePanelId }) {
+  const actions = useWorkspaceLeftPaneActions({ onOpenPanel, activePanelId })
+
+  return actions.map((action) => (
+    <button key={action.id} aria-pressed={action.active} onClick={action.select}>
+      {action.icon}
+      {action.title}
+    </button>
+  ))
+}
+```
+
+Pass `activePanelId` when the host also renders `workspace-page` panels and wants
+those launcher actions to show the focused page as active.
+
+Use this public hook rather than deep-importing chrome internals. Search UI,
+workspace-source content hosting, and plugin chrome action portals remain owned
+by the default `WorkbenchLeftPane` unless a host explicitly renders that full
+component.
+
 ## Docs
 
 Authoring:

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@hachej/boring-workspace",
-  "version": "0.1.62",
+  "version": "0.1.63",
   "type": "module",
   "license": "MIT",
   "description": "Workspace UI, plugin, and bridge package for composing chat, files, catalogs, editors, and app-specific panes.",
@@ -139,9 +139,9 @@
     "tailwind-merge": "^2.0.0",
     "zod": "^3.23.0",
     "zustand": "^5.0.0",
-    "@hachej/boring-agent": "0.1.62",
-    "@hachej/boring-ui-kit": "0.1.62",
-    "@hachej/boring-ui-plugin-cli": "0.1.62"
+    "@hachej/boring-agent": "0.1.63",
+    "@hachej/boring-ui-kit": "0.1.63",
+    "@hachej/boring-ui-plugin-cli": "0.1.63"
   },
   "devDependencies": {
     "@tailwindcss/postcss": "^4.0.0",