@hachej/boring-workspace 0.1.79 → 0.1.81

package/README.md

@@ -71,6 +71,51 @@ do not set `lazy: true`.
 | `@hachej/boring-workspace/app/server` | Node | App composition: `createWorkspaceAgentServer` |
 | `@hachej/boring-workspace/globals.css` | Browser | Global CSS for the workspace chrome |
 
+## Files panel: multi-root filesystems
+
+The built-in `FileTreePane` shows a single filesystem root by default (today's
+behavior — no dropdown, no extra chrome). Host apps that expose additional
+governed filesystems (e.g. a shared `company_context`) can pass a `roots` list;
+the panel then renders a **dropdown** at the top to switch the active filesystem
+and shows one root's tree at a time.
+
+```tsx
+import { FileTreePane, type FileTreeRootConfig } from "@hachej/boring-workspace"
+
+const roots: FileTreeRootConfig[] = [
+  { filesystem: "user", label: "Workspace", rootDir: ".", access: "readwrite" },
+  { filesystem: "company_context", label: "Company", rootDir: "/", access: "readonly" },
+]
+
+<FileTreePane roots={roots} />
+```
+
+`FileTreeRootConfig`:
+
+| Field | Required | Meaning |
+| --- | --- | --- |
+| `filesystem` | yes | Filesystem id threaded to the file routes (`?filesystem=…`). `"user"` is the default workspace root. |
+| `label` | yes | Text shown in the switcher dropdown. |
+| `rootDir` | no | Root directory for the tree (defaults to `.` for `user`, `/` otherwise). |
+| `access` | no | `"readonly"` hides all mutating affordances (new/rename/delete/drag) for that root; defaults to `"readwrite"`. |
+| `searchPlaceholder` | no | Per-root placeholder for the search input. |
+
+Notes:
+
+- **Additive & backward-compatible.** Omitting `roots` (or passing a single
+  entry) preserves the exact single-root UI — the switcher is hidden.
+- **Governance-agnostic.** The workspace package never imports governance. The
+  host supplies the roots list — a governed app (e.g. via
+  `boring-governance` bindings or a tenant `…/governance/usage` response) maps
+  its per-user filesystem access into `FileTreeRootConfig[]`.
+- **Isolated errors.** A `403`/`404` on one root renders an inline "Failed to
+  load files" state inside the pane while the dropdown stays usable to switch
+  to another root — it never blanks the whole panel.
+
+See the multi-filesystem playground fixture in
+`apps/workspace-playground/src/front/App.tsx` (guarded by
+`VITE_PLAYGROUND_MULTI_FS=1`) for a working consumer.
+
 ## Documentation
 
 See [`docs/README.md`](./docs/README.md) for the architecture overview, key

package/dist/{FileTree-C8JPlZtS.js → FileTree-DQQ1NXtr.js}

@@ -1,5 +1,5 @@
 import { n as e } from "./rolldown-runtime-Dqa2HsxW.js";
-import { At as t } from "./WorkspaceProvider-DcOiZU24.js";
+import { At as t } from "./WorkspaceProvider-DH-yiJZ8.js";
 import { t as n } from "./utils-BRcxFdrz.js";
 import { createContext as r, useCallback as i, useContext as a, useEffect as o, useMemo as s, useRef as c } from "react";
 import { jsx as l, jsxs as u } from "react/jsx-runtime";

package/dist/{MarkdownEditor-B9wN6tGH.js → MarkdownEditor-D8NqIunl.js}

@@ -1,5 +1,5 @@
 import { n as e } from "./rolldown-runtime-Dqa2HsxW.js";
-import { Ft as t, Nt as n, Rt as r, nn as i } from "./WorkspaceProvider-DcOiZU24.js";
+import { Ft as t, Nt as n, Rt as r, nn as i } from "./WorkspaceProvider-DH-yiJZ8.js";
 import { t as a } from "./utils-BRcxFdrz.js";
 import { useCallback as o, useEffect as s, useMemo as c, useRef as l, useState as u } from "react";
 import { Fragment as d, jsx as f, jsxs as p } from "react/jsx-runtime";

package/dist/{WorkspaceLoadingState-TgOWTNJC.js → WorkspaceLoadingState-D_b8t-6U.js}

@@ -1,4 +1,4 @@
-import { Kt as e, S as t, Vt as n, Wt as r, X as i, _ as a, at as o, mn as s, o as c, pn as l, v as u, x as ee, zt as te } from "./WorkspaceProvider-DcOiZU24.js";
+import { Kt as e, S as t, Vt as n, Wt as r, X as i, _ as a, at as o, mn as s, o as c, pn as l, v as u, x as ee, zt as te } from "./WorkspaceProvider-DH-yiJZ8.js";
 import { t as d } from "./utils-BRcxFdrz.js";
 import { Suspense as ne, createContext as f, createElement as p, useCallback as m, useContext as h, useEffect as g, useMemo as _, useRef as v, useState as y, useSyncExternalStore as re } from "react";
 import { Fragment as ie, jsx as b, jsxs as x } from "react/jsx-runtime";