@lincyaw/workbench

Presmium's workbench panels in React: the launcher of a workspace (its documents, made from a template, renamed, copied and deleted), a document's file tree, the source editor (CodeMirror 6, with a three-way merge when a file changed on disk), the problems of its compilation, its live preview (the web form or the slides, driven over Presmium's preview protocol) and its changes (an agent's change waiting for review, the changes not committed, the history and its undo). Under them, bound to no framework: the client of the workspace service (presmium serve), the workbench's state, the preview protocol's workbench side, and the shared components of Presmium's design (PmButton, PmDialog, PmMenu and the others) in React. Experimental (0.x).

Part of Presmium, which turns lectures written in MyST Markdown into web pages, slides, Jupyter notebooks and narrated lectures.

Usage

presmium studio shows these panels in DeepSeek Harness's web client: @lincyaw/dsh bundles them into its client part and places them. They know nothing of the host they are drawn in; a layout gives them one Workbench and places them:

import { HomePanel, DocumentView, Workbench, WorkbenchProvider, workspaceClient } from '@lincyaw/workbench'
import '@lincyaw/design/design.css'
import '@lincyaw/workbench/styles.css'

const workbench = new Workbench({ client: workspaceClient('api/presmium/'), locale: 'zh-CN' })

export function Centre({ open }: { open: boolean }) {
  return <WorkbenchProvider workbench={workbench}>{open ? <DocumentView /> : <HomePanel />}</WorkbenchProvider>
}

The workspace service's routes are reached under the page's api/presmium/ (the host passes them on to the service); React 18 is a peer dependency. Interactive controls wrap Radix Primitives; cmdk owns command search, React Arborist owns the file tree, and react-resizable-panels owns pane resizing. Presmium maintains the visual tokens and the document, save, review and preview behavior, rather than duplicating these libraries' focus, keyboard, positioning and drag logic.

Documents open in preview, with source and side by side modes. Text selections and picked preview blocks become conversation context. WorkbenchProvider protects unsaved changes when closing files, leaving a document or unloading the page. Set protectChanges={false} on auxiliary providers when several panels share one workbench, keeping the protection mounted once in its primary provider.

Hosts route text file references through workbench.openSource(document, path, { line }). The file tree and source reads and saves use the opened workspace's scope (''), including code outside the current lecture directory. Opening shared code or root notes keeps the selected lecture preview and existing drafts; switching lectures still protects unsaved changes. Without a selected lecture, root files open in source mode. Keep DocumentView mounted when hiding it so editor drafts and undo history survive navigation.

Documentation

• Design of the workbench on DeepSeek Harness (section 7)

License

Apache-2.0.