@hachej/boring-workspace 0.1.62 → 0.1.64

package/dist/workspace.js

@@ -1,27 +1,27 @@
 var X = Object.defineProperty;
 var Q = (e, t, a) => t in e ? X(e, t, { enumerable: !0, configurable: !0, writable: !0, value: a }) : e[t] = a;
 var T = (e, t, a) => Q(e, typeof t != "symbol" ? t + "" : t, a);
-import { u as D, p as Y, a as Z, b as ee, D as te } from "./WorkspaceProvider-kf-pjz6V.js";
-import { A as qe, C as Je, c as Ve, d as Ge, e as Xe, f as Qe, F as Ye, g as Ze, M as et, h as tt, P as at, i as rt, j as nt, k as st, l as ot, R as it, S as lt, m as ct, n as dt, T as ut, U as pt, W as mt, o as ft, q as ht, r as gt, s as bt, t as yt, v as kt, w as St, x as vt, y as Pt, z as xt, B as wt, E as Ct, G as Et, H as Nt, I as Rt, J as Tt, K as Ot, L as It, N as Wt, O as Ft, Q as Lt, V as Bt, X as Mt, Y as Kt, Z as _t, _ as Dt, $ as At, a0 as $t, a1 as jt, a2 as zt, a3 as Ht, a4 as Ut, a5 as qt, a6 as Jt, a7 as Vt, a8 as Gt, a9 as Xt, aa as Qt, ab as Yt, ac as Zt, ad as ea, ae as ta, af as aa, ag as ra, ah as na, ai as sa, aj as oa, ak as ia, al as la, am as ca, an as da, ao as ua, ap as pa, aq as ma, ar as fa, as as ha, at as ga, au as ba, av as ya, aw as ka, ax as Sa, ay as va, az as Pa, aA as xa, aB as wa, aC as Ca, aD as Ea, aE as Na, aF as Ra, aG as Ta, aH as Oa, aI as Ia, aJ as Wa, aK as Fa, aL as La } from "./WorkspaceProvider-kf-pjz6V.js";
+import { u as D, p as Y, a as Z, b as ee, D as te } from "./WorkspaceProvider-CEZUOy1M.js";
+import { A as qe, C as Je, c as Ve, d as Ge, e as Xe, f as Qe, F as Ye, g as Ze, M as et, h as tt, P as at, i as rt, j as nt, k as st, l as ot, R as it, S as lt, m as ct, n as dt, T as ut, U as pt, W as mt, o as ft, q as ht, r as gt, s as yt, t as bt, v as kt, w as St, x as vt, y as Pt, z as xt, B as wt, E as Ct, G as Et, H as Nt, I as Rt, J as Tt, K as Ot, L as It, N as Wt, O as Ft, Q as Lt, V as Mt, X as Bt, Y as Kt, Z as _t, _ as Dt, $ as At, a0 as $t, a1 as jt, a2 as zt, a3 as Ht, a4 as Ut, a5 as qt, a6 as Jt, a7 as Vt, a8 as Gt, a9 as Xt, aa as Qt, ab as Yt, ac as Zt, ad as ea, ae as ta, af as aa, ag as ra, ah as na, ai as sa, aj as oa, ak as ia, al as la, am as ca, an as da, ao as ua, ap as pa, aq as ma, ar as fa, as as ha, at as ga, au as ya, av as ba, aw as ka, ax as Sa, ay as va, az as Pa, aA as xa, aB as wa, aC as Ca, aD as Ea, aE as Na, aF as Ra, aG as Ta, aH as Oa, aI as Ia, aJ as Wa, aK as Fa, aL as La, aM as Ma } from "./WorkspaceProvider-CEZUOy1M.js";
 import { c as C } from "./utils-B6yFEsav.js";
-import { C as Ma, T as Ka, W as _a, b as Da } from "./WorkspaceLoadingState-Dfnk7JjR.js";
+import { C as Ka, T as _a, W as Da, b as Aa } from "./WorkspaceLoadingState-D4SB2awA.js";
 import { jsx as r, jsxs as g, Fragment as ae } from "react/jsx-runtime";
 import { Button as x, Sheet as re, SheetContent as ne, SheetHeader as se, SheetTitle as oe, SheetDescription as ie, EmptyState as le, Kbd as O, ErrorState as ce, IconButton as I } from "@hachej/boring-ui-kit";
-import { Toaster as $a, dismissToast as ja, toast as za } from "@hachej/boring-ui-kit";
-import { useSyncExternalStore as A, useState as E, useEffect as v, useRef as w, useCallback as b, useMemo as P, Suspense as de, Component as ue } from "react";
-import { FileTree as Ua } from "./FileTree-zGmxifl_.js";
-import { MarkdownEditor as Ja } from "./MarkdownEditor-BykEKKxv.js";
-import { MenuIcon as pe, PanelLeftIcon as B, PinIcon as me, CheckIcon as fe, CopyIcon as he } from "lucide-react";
-function Be() {
+import { Toaster as ja, dismissToast as za, toast as Ha } from "@hachej/boring-ui-kit";
+import { useSyncExternalStore as A, useState as E, useEffect as v, useRef as w, useCallback as y, useMemo as P, Suspense as de, Component as ue } from "react";
+import { FileTree as qa } from "./FileTree-DjhAzlg3.js";
+import { MarkdownEditor as Va } from "./MarkdownEditor-CeN7n6mw.js";
+import { MenuIcon as pe, PanelLeftIcon as M, PinIcon as me, CheckIcon as fe, CopyIcon as he } from "lucide-react";
+function Me() {
   const e = D();
   return A(e.subscribe, e.getSnapshot);
 }
 function $(e) {
   switch (e.kind) {
     case "openFile":
-      return { kind: "openFile", params: { path: e.path, ...e.mode ? { mode: e.mode } : {} } };
+      return { kind: "openFile", params: { path: e.path, ...e.mode ? { mode: e.mode } : {}, ...e.filesystem ? { filesystem: e.filesystem } : {} } };
     case "openSurface":
-      return { kind: "openSurface", params: { kind: e.surfaceKind, target: e.target, ...e.meta ? { meta: e.meta } : {} } };
+      return { kind: "openSurface", params: { kind: e.surfaceKind, target: e.target, ...e.filesystem ? { filesystem: e.filesystem } : {}, ...e.meta ? { meta: e.meta } : {} } };
     case "openPanel":
       return {
         kind: "openPanel",
@@ -39,10 +39,10 @@ function $(e) {
 function ge(e) {
   return `boring-workspace-command:${encodeURIComponent(JSON.stringify($(e)))}`;
 }
-function be(e) {
+function ye(e) {
   return e.button === 0 && !e.metaKey && !e.ctrlKey && !e.altKey && !e.shiftKey;
 }
-function Me({ to: e, children: t, className: a, title: n, href: o, onClick: i }) {
+function Be({ to: e, children: t, className: a, title: n, href: o, onClick: i }) {
   return /* @__PURE__ */ r(
     "a",
     {
@@ -50,13 +50,13 @@ function Me({ to: e, children: t, className: a, title: n, href: o, onClick: i })
       className: a,
       title: n,
       onClick: (u) => {
-        i == null || i(u), !(u.defaultPrevented || !be(u)) && (u.preventDefault(), Y($(e)));
+        i == null || i(u), !(u.defaultPrevented || !ye(u)) && (u.preventDefault(), Y($(e)));
       },
       children: t
     }
   );
 }
-function ye(e, t) {
+function be(e, t) {
   return e ? `${e.replace(/\/$/, "")}${t}` : t;
 }
 function ke() {
@@ -74,7 +74,7 @@ async function Ke(e) {
   e.recordSet && t.set("recordSet", e.recordSet), e.offset !== void 0 && t.set("offset", String(e.offset)), e.limit !== void 0 && t.set("limit", String(e.limit)), e.q && t.set("q", e.q);
   const a = { ...e.headers ?? {} }, n = e.workspaceId ?? ke();
   n && !Object.keys(a).some((i) => i.toLowerCase() === "x-boring-workspace-id") && (a["x-boring-workspace-id"] = n);
-  const o = await fetch(ye(e.apiBaseUrl, `/api/v1/files/records?${t}`), {
+  const o = await fetch(be(e.apiBaseUrl, `/api/v1/files/records?${t}`), {
     method: "GET",
     headers: a,
     signal: e.signal
@@ -83,14 +83,14 @@ async function Ke(e) {
     throw new Error(`readFileRecords failed: HTTP ${o.status}`);
   return await o.json();
 }
-function M(e) {
+function B(e) {
   return typeof window > "u" ? !1 : window.innerWidth < e;
 }
 function K(e = 1024) {
-  const [t, a] = E(() => M(e));
+  const [t, a] = E(() => B(e));
   return v(() => {
     const n = () => {
-      a(M(e));
+      a(B(e));
     };
     return n(), window.addEventListener("resize", n), () => {
       window.removeEventListener("resize", n);
@@ -112,7 +112,7 @@ function Se({
       return;
     }
     l && o.current && (o.current = !1, a(!1));
-  }, [e, a]), b(() => {
+  }, [e, a]), y(() => {
     o.current = !1;
   }, []);
 }
@@ -127,9 +127,9 @@ function _e(e) {
       try {
         const p = e.toJSON(), f = [];
         if (p && typeof p == "object" && "panels" in p) {
-          const y = p;
-          if (y.panels)
-            for (const [, m] of Object.entries(y.panels))
+          const b = p;
+          if (b.panels)
+            for (const [, m] of Object.entries(b.panels))
               m.id && f.push({
                 id: m.id,
                 component: m.contentComponent ?? m.id,
@@ -137,9 +137,9 @@ function _e(e) {
               });
         }
         const s = n.current;
-        (s.length !== f.length || s.some((y, m) => {
+        (s.length !== f.length || s.some((b, m) => {
           var k;
-          return y.id !== ((k = f[m]) == null ? void 0 : k.id);
+          return b.id !== ((k = f[m]) == null ? void 0 : k.id);
         })) && a(f);
       } catch {
       }
@@ -148,7 +148,7 @@ function _e(e) {
     const c = setInterval(l, 500);
     return () => clearInterval(c);
   }, [e]);
-  const o = b(
+  const o = y(
     (l) => {
       e == null || e.addPanel("artifacts", {
         id: l.id,
@@ -157,28 +157,28 @@ function _e(e) {
       });
     },
     [e]
-  ), i = b(
+  ), i = y(
     (l) => {
       e == null || e.removePanel(l);
     },
     [e]
-  ), u = b(
+  ), u = y(
     (l) => {
       e == null || e.activatePanel(l);
     },
     [e]
-  ), d = b(
+  ), d = y(
     (l) => n.current.some((c) => c.id === l),
     []
   );
   return { panels: t, open: o, close: i, activate: u, isOpen: d };
 }
 function De(e, t = {}) {
-  const a = t.toolPanelMap ?? {}, n = b(
+  const a = t.toolPanelMap ?? {}, n = y(
     (i) => a[i],
     [a]
   );
-  return { openForTool: b(
+  return { openForTool: y(
     (i, u) => {
       const d = a[i];
       if (!d) return;
@@ -211,7 +211,7 @@ function we({
   v(() => {
     (!p || !i && !d) && h(!1);
   }, [p, i, d]);
-  const y = p && (i || d && n.collapsed), m = p && !i && (!d || !n.collapsed), k = P(
+  const b = p && (i || d && n.collapsed), m = p && !i && (!d || !n.collapsed), k = P(
     () => m ? e : xe(e),
     [m, e]
   ), j = P(() => {
@@ -229,13 +229,13 @@ function we({
     a.subscribe,
     a.getSnapshot,
     a.getSnapshot
-  ), H = P(() => a.getComponents(), [a, z]), W = c ? H[c] : null, U = c ? ((F = a.get(c)) == null ? void 0 : F.title) ?? "Sidebar" : "Sidebar", q = b(() => {
+  ), H = P(() => a.getComponents(), [a, z]), W = c ? H[c] : null, U = c ? ((F = a.get(c)) == null ? void 0 : F.title) ?? "Sidebar" : "Sidebar", q = y(() => {
     h(!0);
-  }, []), J = b(() => {
+  }, []), J = y(() => {
     f(), o({ collapsed: !1 }), h(!1);
-  }, [f, o]), V = b(() => {
+  }, [f, o]), V = y(() => {
     f(), o({ collapsed: !0 }), h(!1);
-  }, [f, o]), G = b(
+  }, [f, o]), G = y(
     (S) => {
       S.target.closest("[role='treeitem']") && h(!1);
     },
@@ -249,7 +249,7 @@ function we({
         "aria-hidden": "true"
       }
     ),
-    y && /* @__PURE__ */ r(
+    b && /* @__PURE__ */ r(
       "div",
       {
         className: C(
@@ -264,7 +264,7 @@ function we({
             size: "icon-sm",
             onClick: q,
             "aria-label": i ? "Open sidebar menu" : "Open collapsed sidebar",
-            children: i ? /* @__PURE__ */ r(pe, { className: "h-4 w-4" }) : /* @__PURE__ */ r(B, { className: "h-4 w-4" })
+            children: i ? /* @__PURE__ */ r(pe, { className: "h-4 w-4" }) : /* @__PURE__ */ r(M, { className: "h-4 w-4" })
           }
         )
       }
@@ -277,7 +277,7 @@ function we({
         size: "icon-sm",
         onClick: V,
         "aria-label": "Collapse sidebar",
-        children: /* @__PURE__ */ r(B, { className: "h-4 w-4" })
+        children: /* @__PURE__ */ r(M, { className: "h-4 w-4" })
       }
     ) }),
     /* @__PURE__ */ r(
@@ -291,7 +291,7 @@ function we({
       },
       j
     ),
-    y && /* @__PURE__ */ r(re, { open: s, onOpenChange: h, children: /* @__PURE__ */ g(
+    b && /* @__PURE__ */ r(re, { open: s, onOpenChange: h, children: /* @__PURE__ */ g(
       ne,
       {
         side: "left",
@@ -443,23 +443,23 @@ function ze({
     }
     d((s) => s && c.includes(s) ? s : t && c.includes(t) ? t : c[0] ?? null);
   }, [c, t]);
-  const p = b((s) => {
+  const p = y((s) => {
     var h;
     d(s), (h = l.current[s]) == null || h.focus();
-  }, []), f = b(
+  }, []), f = y(
     (s, h) => {
       if (s.target !== s.currentTarget) return;
       if (s.key === "Enter" || s.key === " ") {
         s.preventDefault(), a == null || a(h);
         return;
       }
-      const y = c.indexOf(h);
-      if (y < 0) return;
-      let m = y;
+      const b = c.indexOf(h);
+      if (b < 0) return;
+      let m = b;
       if (s.key === "ArrowDown")
-        m = Math.min(y + 1, c.length - 1);
+        m = Math.min(b + 1, c.length - 1);
       else if (s.key === "ArrowUp")
-        m = Math.max(y - 1, 0);
+        m = Math.max(b - 1, 0);
       else if (s.key === "Home")
         m = 0;
       else if (s.key === "End")
@@ -547,7 +547,7 @@ function Ne({
   onKeyDown: u,
   rowRef: d
 }) {
-  const [l, c] = E(!1), p = b((f) => {
+  const [l, c] = E(!1), p = y((f) => {
     f.stopPropagation(), Ee(e.id).then((s) => {
       s && (c(!0), window.setTimeout(() => c(!1), 1200));
     });
@@ -627,19 +627,19 @@ function Ne({
 export {
   qe as ArtifactSurfacePane,
   Je as CatalogRegistry,
-  Ma as ChatLayout,
+  Ka as ChatLayout,
   Ve as CodeEditor,
   Ge as CodeEditorPane,
   Xe as CommandPalette,
   Qe as CommandRegistry,
   te as DockviewShell,
   $e as EmptyPane,
-  Ua as FileTree,
+  qa as FileTree,
   Ye as FileTreePane,
   Ze as FileTreeView,
   Ae as IdeLayout,
   et as MAX_PANELS,
-  Ja as MarkdownEditor,
+  Va as MarkdownEditor,
   tt as MarkdownEditorPane,
   at as PanelChrome,
   je as PanelErrorBoundary,
@@ -654,25 +654,25 @@ export {
   ct as SurfaceResolverRegistry,
   dt as SurfaceShell,
   ut as ThemeProvider,
-  $a as Toaster,
-  Ka as TopBar,
+  ja as Toaster,
+  _a as TopBar,
   pt as UI_COMMAND_EVENT,
   mt as WORKSPACE_ATTENTION_ACTION_EVENT,
   ft as WORKSPACE_COMPOSER_STOP_EVENT,
   ht as WORKSPACE_COMPOSER_STOP_REASONS,
   gt as WORKSPACE_OPEN_PATH_SURFACE_KIND,
-  bt as WORKSPACE_SURFACE_OPEN_SKIPPED_EVENT,
-  yt as WorkbenchLeftPane,
+  yt as WORKSPACE_SURFACE_OPEN_SKIPPED_EVENT,
+  bt as WorkbenchLeftPane,
   kt as WorkspaceFilesProvider,
-  Me as WorkspaceLink,
-  _a as WorkspaceLoadingState,
+  Be as WorkspaceLink,
+  Da as WorkspaceLoadingState,
   St as WorkspacePluginClientProvider,
   vt as WorkspaceProvider,
   Pt as WorkspaceSourceRegistry,
   xt as agentMeta,
   wt as bindStore,
   Ct as bootstrap,
-  Da as buildChatLayout,
+  Aa as buildChatLayout,
   Et as buildFullPagePanelHref,
   Ce as buildIdeLayout,
   Nt as closePanelSchema,
@@ -683,10 +683,10 @@ export {
   It as createWorkspacePluginClient,
   Wt as createWorkspaceStore,
   Ft as definePanel,
-  ja as dismissToast,
+  za as dismissToast,
   Lt as emitAgentData,
-  Bt as emitFilesystemAgentFileChange,
-  Mt as emitWorkspaceAttentionAction,
+  Mt as emitFilesystemAgentFileChange,
+  Bt as emitWorkspaceAttentionAction,
   Kt as emitWorkspaceComposerStop,
   _t as events,
   Dt as expandToFileSchema,
@@ -703,10 +703,10 @@ export {
   Xt as openPanelSchema,
   Y as postUiCommand,
   Ke as readFileRecords,
-  za as toast,
+  Ha as toast,
   Qt as useActiveFile,
   Yt as useActivePanel,
-  Be as useActivePanels,
+  Me as useActivePanels,
   Zt as useApiBaseUrl,
   _e as useArtifactPanels,
   De as useArtifactRouting,
@@ -727,9 +727,9 @@ export {
   fa as useKeyboardShortcuts,
   ha as useOpenPanels,
   ga as usePanelRenderMode,
-  ba as usePluginErrors,
+  ya as usePluginErrors,
   D as useRegistry,
-  ya as useResetLayout,
+  ba as useResetLayout,
   Se as useResponsiveSidebarCollapse,
   ee as useSetSidebar,
   Z as useSidebarState,
@@ -742,14 +742,15 @@ export {
   wa as useWorkspaceChatPanel,
   Ca as useWorkspaceContext,
   Ea as useWorkspaceContextOptional,
-  Na as useWorkspacePluginClient,
-  Ra as useWorkspaceRequestId,
-  Ta as useWorkspaceSourceRegistry,
-  Oa as userMeta,
-  Ia as workspaceAttentionSessionBadgeForBlocker,
-  Wa as workspaceComposerStopAppliesToSession,
-  Fa as workspaceComposerStopTargetSessionId,
-  La as workspaceEvents,
+  Na as useWorkspaceLeftPaneActions,
+  Ra as useWorkspacePluginClient,
+  Ta as useWorkspaceRequestId,
+  Oa as useWorkspaceSourceRegistry,
+  Ia as userMeta,
+  Wa as workspaceAttentionSessionBadgeForBlocker,
+  Fa as workspaceComposerStopAppliesToSession,
+  La as workspaceComposerStopTargetSessionId,
+  Ma as workspaceEvents,
   $ as workspaceLinkCommand,
   ge as workspaceLinkHref
 };

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.64",
   "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.64",
+    "@hachej/boring-ui-plugin-cli": "0.1.64",
+    "@hachej/boring-ui-kit": "0.1.64"
   },
   "devDependencies": {
     "@tailwindcss/postcss": "^4.0.0",