@achasoft/dsh-advanced-sidebar 0.1.0

package/types/client/locales.d.ts

@@ -0,0 +1,474 @@
+/**
+ * `advancedSidebar` namespace dictionaries.
+ *
+ * Simplified Chinese is the key-set source of truth and English is checked complete against it, so
+ * a key added to one and forgotten in the other is a compile error rather than a string that
+ * silently falls back to its own name at runtime.
+ *
+ * Operator diagnostics — a git stderr line, a spawn error, a missing executable — are NOT in here.
+ * They arrive from the Host already phrased, stay English, and are rendered verbatim: translating a
+ * substring of someone's stderr would make it unsearchable.
+ * @module @achasoft/dsh-advanced-sidebar/client/locales
+ */
+/** Simplified Chinese dictionary (the key-set source of truth). */
+export declare const zh: {
+    'menu.trigger': string;
+    'menu.aria': string;
+    'menu.section.session': string;
+    'menu.changes': string;
+    'menu.terminal': string;
+    'menu.files': string;
+    'menu.tasks': string;
+    'menu.openIn': string;
+    'menu.openIn.newWindow': string;
+    'menu.archive': string;
+    'menu.preview': string;
+    'menu.delete': string;
+    'menu.empty': string;
+    'menu.noSession': string;
+    'menu.noDirectory': string;
+    'panel.close': string;
+    'panel.refresh': string;
+    'panel.retry': string;
+    'panel.loading': string;
+    'panel.session': string;
+    'panel.resize': string;
+    'changes.title': string;
+    'changes.empty': string;
+    'changes.group.staged': string;
+    'changes.group.unstaged': string;
+    'changes.group.untracked': string;
+    'changes.group.conflicted': string;
+    'changes.branch.detached': string;
+    'changes.branch.unborn': string;
+    'changes.ahead': string;
+    'changes.behind': string;
+    'changes.truncated': string;
+    'changes.diff.empty': string;
+    'changes.diff.binary': string;
+    'changes.diff.truncated': string;
+    'changes.diff.copy': string;
+    'changes.diff.copied': string;
+    'changes.stage': string;
+    'changes.unstage': string;
+    'changes.stage.all': string;
+    'changes.unstage.all': string;
+    'changes.commit': string;
+    'changes.push': string;
+    'changes.push.hint': string;
+    'changes.push.upToDate': string;
+    'changes.push.done': string;
+    'changes.publish': string;
+    'changes.publish.hint': string;
+    'changes.push.published': string;
+    'changes.commit.suggest': string;
+    'changes.commit.suggest.hint': string;
+    'changes.commit.suggest.truncated': string;
+    'changes.commit.message': string;
+    'changes.commit.placeholder': string;
+    'changes.commit.amend': string;
+    'changes.commit.count.one': string;
+    'changes.commit.count.other': string;
+    'changes.commit.nothing': string;
+    'changes.commit.done': string;
+    'changes.commit.author': string;
+    'changes.commit.noIdentity': string;
+    'changes.commit.working': string;
+    'changes.readOnly': string;
+    'changes.reveal': string;
+    'changes.count': string;
+    'terminal.title': string;
+    'terminal.starting': string;
+    'terminal.exited': string;
+    'terminal.exitedSignal': string;
+    'terminal.restart': string;
+    'terminal.interrupt': string;
+    'terminal.clear': string;
+    'terminal.lossy': string;
+    'terminal.inputAria': string;
+    'terminal.hint': string;
+    'terminal.tabs': string;
+    'terminal.tab': string;
+    'terminal.new': string;
+    'terminal.limit': string;
+    'files.title': string;
+    'files.empty': string;
+    'files.up': string;
+    'files.preview.binary': string;
+    'files.preview.truncated': string;
+    'files.preview.pick': string;
+    'files.open': string;
+    'files.reveal': string;
+    'files.size': string;
+    'tasks.title': string;
+    'tasks.empty': string;
+    'tasks.status.running': string;
+    'tasks.status.stopping': string;
+    'tasks.status.completed': string;
+    'tasks.status.killed': string;
+    'tasks.status.failed': string;
+    'tasks.stop': string;
+    'tasks.stopped': string;
+    'tasks.alreadyFinished': string;
+    'tasks.output': string;
+    'tasks.output.hide': string;
+    'tasks.output.empty': string;
+    'tasks.output.withheld': string;
+    'tasks.duration.seconds': string;
+    'tasks.duration.minutes': string;
+    'tasks.duration.hours': string;
+    'tasks.filter.text': string;
+    'tasks.filter.text.placeholder': string;
+    'tasks.filter.status': string;
+    'tasks.filter.status.all': string;
+    'tasks.filter.since': string;
+    'tasks.filter.since.any': string;
+    'tasks.filter.none': string;
+    'tasks.filter.count': string;
+    'date.today': string;
+    'date.clear': string;
+    'date.previousMonth': string;
+    'date.nextMonth': string;
+    'preview.title': string;
+    'preview.server': string;
+    'preview.none': string;
+    'preview.state.stopped': string;
+    'preview.state.starting': string;
+    'preview.state.ready': string;
+    'preview.state.exited': string;
+    'preview.state.failed': string;
+    'preview.start': string;
+    'preview.stop': string;
+    'preview.notStartable': string;
+    'preview.logs': string;
+    'preview.logs.empty': string;
+    'preview.address': string;
+    'preview.newWindow': string;
+    'preview.device': string;
+    'preview.device.desktop': string;
+    'preview.device.tablet': string;
+    'preview.device.mobile': string;
+    'preview.frame': string;
+    'preview.noUrl': string;
+    'preview.empty': string;
+    'preview.emptyFile': string;
+    'delete.title': string;
+    'delete.body.archive': string;
+    'delete.body.purge': string;
+    'delete.confirm': string;
+    'delete.cancel': string;
+    'delete.done.archive': string;
+    'delete.done.purge': string;
+    'delete.done.kept': string;
+    'archive.done': string;
+    'notice.dismiss': string;
+    'error.transport': string;
+    'settings.title': string;
+    'settings.description': string;
+    'settings.status.ready': string;
+    'settings.status.partial': string;
+    'settings.group.placement': string;
+    'settings.group.entries': string;
+    'settings.group.behavior': string;
+    'settings.group.limits': string;
+    'settings.showInSessionHeader': string;
+    'settings.showInSessionHeader.hint': string;
+    'settings.showChanges': string;
+    'settings.showChanges.hint': string;
+    'settings.showTerminal': string;
+    'settings.showTerminal.hint': string;
+    'settings.showFiles': string;
+    'settings.showFiles.hint': string;
+    'settings.showTasks': string;
+    'settings.showTasks.hint': string;
+    'settings.showOpenIn': string;
+    'settings.showOpenIn.hint': string;
+    'settings.showArchive': string;
+    'settings.showArchive.hint': string;
+    'settings.showDelete': string;
+    'settings.showDelete.hint': string;
+    'settings.showPreview': string;
+    'settings.showPreview.hint': string;
+    'settings.previewsFromLaunchFile': string;
+    'settings.previewsFromLaunchFile.hint': string;
+    'settings.maxPreviews': string;
+    'settings.maxPreviews.hint': string;
+    'settings.previewReadyTimeoutMs': string;
+    'settings.previewReadyTimeoutMs.hint': string;
+    'settings.previews': string;
+    'settings.previews.hint': string;
+    'settings.previews.empty': string;
+    'settings.panelWidth': string;
+    'settings.panelWidth.hint': string;
+    'settings.deleteMode': string;
+    'settings.deleteMode.archive': string;
+    'settings.deleteMode.purge': string;
+    'settings.deleteMode.hint': string;
+    'settings.deleteMode.unsupported': string;
+    'settings.confirmDelete': string;
+    'settings.confirmDelete.hint': string;
+    'settings.allowTaskKill': string;
+    'settings.allowTaskKill.hint': string;
+    'settings.showTaskOutput': string;
+    'settings.showTaskOutput.hint': string;
+    'settings.gitMaxFiles': string;
+    'settings.gitMaxFiles.hint': string;
+    'settings.gitTimeoutMs': string;
+    'settings.gitTimeoutMs.hint': string;
+    'settings.allowGitStaging': string;
+    'settings.allowGitStaging.hint': string;
+    'settings.allowGitPush': string;
+    'settings.allowGitPush.hint': string;
+    'settings.allowCommitMessageDraft': string;
+    'settings.allowCommitMessageDraft.hint': string;
+    'settings.gitPushTimeoutMs': string;
+    'settings.gitPushTimeoutMs.hint': string;
+    'settings.commitMessageMaxBytes': string;
+    'settings.commitMessageMaxBytes.hint': string;
+    'settings.allowGitCommit': string;
+    'settings.allowGitCommit.hint': string;
+    'settings.gitCommitTimeoutMs': string;
+    'settings.gitCommitTimeoutMs.hint': string;
+    'settings.terminalShell': string;
+    'settings.terminalShell.hint': string;
+    'settings.maxTerminals': string;
+    'settings.maxTerminals.hint': string;
+    'settings.editors': string;
+    'settings.editors.hint': string;
+    'settings.editors.empty': string;
+    'settings.editors.available': string;
+    'settings.editors.missing': string;
+    'settings.unavailable': string;
+};
+/** The advancedSidebar namespace key union. */
+export type AdvancedSidebarKey = keyof typeof zh;
+/** English dictionary, checked complete against the zh key set. */
+export declare const en: {
+    'menu.trigger': string;
+    'menu.aria': string;
+    'menu.section.session': string;
+    'menu.changes': string;
+    'menu.terminal': string;
+    'menu.files': string;
+    'menu.tasks': string;
+    'menu.openIn': string;
+    'menu.openIn.newWindow': string;
+    'menu.archive': string;
+    'menu.preview': string;
+    'menu.delete': string;
+    'menu.empty': string;
+    'menu.noSession': string;
+    'menu.noDirectory': string;
+    'panel.close': string;
+    'panel.refresh': string;
+    'panel.retry': string;
+    'panel.loading': string;
+    'panel.session': string;
+    'panel.resize': string;
+    'changes.title': string;
+    'changes.empty': string;
+    'changes.group.staged': string;
+    'changes.group.unstaged': string;
+    'changes.group.untracked': string;
+    'changes.group.conflicted': string;
+    'changes.branch.detached': string;
+    'changes.branch.unborn': string;
+    'changes.ahead': string;
+    'changes.behind': string;
+    'changes.truncated': string;
+    'changes.diff.empty': string;
+    'changes.diff.binary': string;
+    'changes.diff.truncated': string;
+    'changes.diff.copy': string;
+    'changes.diff.copied': string;
+    'changes.stage': string;
+    'changes.unstage': string;
+    'changes.stage.all': string;
+    'changes.unstage.all': string;
+    'changes.commit': string;
+    'changes.push': string;
+    'changes.push.hint': string;
+    'changes.push.upToDate': string;
+    'changes.push.done': string;
+    'changes.publish': string;
+    'changes.publish.hint': string;
+    'changes.push.published': string;
+    'changes.commit.suggest': string;
+    'changes.commit.suggest.hint': string;
+    'changes.commit.suggest.truncated': string;
+    'changes.commit.message': string;
+    'changes.commit.placeholder': string;
+    'changes.commit.amend': string;
+    'changes.commit.count.one': string;
+    'changes.commit.count.other': string;
+    'changes.commit.nothing': string;
+    'changes.commit.done': string;
+    'changes.commit.author': string;
+    'changes.commit.noIdentity': string;
+    'changes.commit.working': string;
+    'changes.readOnly': string;
+    'changes.reveal': string;
+    'changes.count': string;
+    'terminal.title': string;
+    'terminal.starting': string;
+    'terminal.exited': string;
+    'terminal.exitedSignal': string;
+    'terminal.restart': string;
+    'terminal.interrupt': string;
+    'terminal.clear': string;
+    'terminal.lossy': string;
+    'terminal.inputAria': string;
+    'terminal.hint': string;
+    'terminal.tabs': string;
+    'terminal.tab': string;
+    'terminal.new': string;
+    'terminal.limit': string;
+    'files.title': string;
+    'files.empty': string;
+    'files.up': string;
+    'files.preview.binary': string;
+    'files.preview.truncated': string;
+    'files.preview.pick': string;
+    'files.open': string;
+    'files.reveal': string;
+    'files.size': string;
+    'tasks.title': string;
+    'tasks.empty': string;
+    'tasks.status.running': string;
+    'tasks.status.stopping': string;
+    'tasks.status.completed': string;
+    'tasks.status.killed': string;
+    'tasks.status.failed': string;
+    'tasks.stop': string;
+    'tasks.stopped': string;
+    'tasks.alreadyFinished': string;
+    'tasks.output': string;
+    'tasks.output.hide': string;
+    'tasks.output.empty': string;
+    'tasks.output.withheld': string;
+    'tasks.duration.seconds': string;
+    'tasks.duration.minutes': string;
+    'tasks.duration.hours': string;
+    'tasks.filter.text': string;
+    'tasks.filter.text.placeholder': string;
+    'tasks.filter.status': string;
+    'tasks.filter.status.all': string;
+    'tasks.filter.since': string;
+    'tasks.filter.since.any': string;
+    'tasks.filter.none': string;
+    'tasks.filter.count': string;
+    'date.today': string;
+    'date.clear': string;
+    'date.previousMonth': string;
+    'date.nextMonth': string;
+    'preview.title': string;
+    'preview.server': string;
+    'preview.none': string;
+    'preview.state.stopped': string;
+    'preview.state.starting': string;
+    'preview.state.ready': string;
+    'preview.state.exited': string;
+    'preview.state.failed': string;
+    'preview.start': string;
+    'preview.stop': string;
+    'preview.notStartable': string;
+    'preview.logs': string;
+    'preview.logs.empty': string;
+    'preview.address': string;
+    'preview.newWindow': string;
+    'preview.device': string;
+    'preview.device.desktop': string;
+    'preview.device.tablet': string;
+    'preview.device.mobile': string;
+    'preview.frame': string;
+    'preview.noUrl': string;
+    'preview.empty': string;
+    'preview.emptyFile': string;
+    'delete.title': string;
+    'delete.body.archive': string;
+    'delete.body.purge': string;
+    'delete.confirm': string;
+    'delete.cancel': string;
+    'delete.done.archive': string;
+    'delete.done.purge': string;
+    'delete.done.kept': string;
+    'archive.done': string;
+    'notice.dismiss': string;
+    'error.transport': string;
+    'settings.title': string;
+    'settings.description': string;
+    'settings.status.ready': string;
+    'settings.status.partial': string;
+    'settings.group.placement': string;
+    'settings.group.entries': string;
+    'settings.group.behavior': string;
+    'settings.group.limits': string;
+    'settings.showInSessionHeader': string;
+    'settings.showInSessionHeader.hint': string;
+    'settings.showChanges': string;
+    'settings.showChanges.hint': string;
+    'settings.showTerminal': string;
+    'settings.showTerminal.hint': string;
+    'settings.showFiles': string;
+    'settings.showFiles.hint': string;
+    'settings.showTasks': string;
+    'settings.showTasks.hint': string;
+    'settings.showOpenIn': string;
+    'settings.showOpenIn.hint': string;
+    'settings.showArchive': string;
+    'settings.showArchive.hint': string;
+    'settings.showDelete': string;
+    'settings.showDelete.hint': string;
+    'settings.showPreview': string;
+    'settings.showPreview.hint': string;
+    'settings.previewsFromLaunchFile': string;
+    'settings.previewsFromLaunchFile.hint': string;
+    'settings.maxPreviews': string;
+    'settings.maxPreviews.hint': string;
+    'settings.previewReadyTimeoutMs': string;
+    'settings.previewReadyTimeoutMs.hint': string;
+    'settings.previews': string;
+    'settings.previews.hint': string;
+    'settings.previews.empty': string;
+    'settings.panelWidth': string;
+    'settings.panelWidth.hint': string;
+    'settings.deleteMode': string;
+    'settings.deleteMode.archive': string;
+    'settings.deleteMode.purge': string;
+    'settings.deleteMode.hint': string;
+    'settings.deleteMode.unsupported': string;
+    'settings.confirmDelete': string;
+    'settings.confirmDelete.hint': string;
+    'settings.allowTaskKill': string;
+    'settings.allowTaskKill.hint': string;
+    'settings.showTaskOutput': string;
+    'settings.showTaskOutput.hint': string;
+    'settings.gitMaxFiles': string;
+    'settings.gitMaxFiles.hint': string;
+    'settings.gitTimeoutMs': string;
+    'settings.gitTimeoutMs.hint': string;
+    'settings.allowGitStaging': string;
+    'settings.allowGitStaging.hint': string;
+    'settings.allowGitPush': string;
+    'settings.allowGitPush.hint': string;
+    'settings.allowCommitMessageDraft': string;
+    'settings.allowCommitMessageDraft.hint': string;
+    'settings.gitPushTimeoutMs': string;
+    'settings.gitPushTimeoutMs.hint': string;
+    'settings.commitMessageMaxBytes': string;
+    'settings.commitMessageMaxBytes.hint': string;
+    'settings.allowGitCommit': string;
+    'settings.allowGitCommit.hint': string;
+    'settings.gitCommitTimeoutMs': string;
+    'settings.gitCommitTimeoutMs.hint': string;
+    'settings.terminalShell': string;
+    'settings.terminalShell.hint': string;
+    'settings.maxTerminals': string;
+    'settings.maxTerminals.hint': string;
+    'settings.editors': string;
+    'settings.editors.hint': string;
+    'settings.editors.empty': string;
+    'settings.editors.available': string;
+    'settings.editors.missing': string;
+    'settings.unavailable': string;
+};

package/types/client/panels/ChangesPanel.d.ts

@@ -0,0 +1,22 @@
+/**
+ * The Changes panel: what git reports as uncommitted in the session's working directory, each
+ * file's patch on demand, and the two writes that turn a reading into a commit.
+ *
+ * Staging and committing are offered; DISCARDING is not. Stage, unstage, and commit are all
+ * recoverable — the working tree is untouched by the first two, and a commit stays in the reflog —
+ * while discarding destroys uncommitted work with nothing left to recover it from. A sidebar is the
+ * wrong place for the one irreversible verb in the set, and `git restore` is a keystroke away in
+ * the Terminal panel beside it.
+ *
+ * Every write returns the reading that follows it, so the lists never lag a round trip behind the
+ * index they describe.
+ * @module @achasoft/dsh-advanced-sidebar/client/panels/ChangesPanel
+ */
+import { type PanelProps } from './shared.tsx';
+/**
+ * The git status reading and its per-file patches.
+ * @param props - the target, the translator, and the dock's face.
+ * @returns the panel body.
+ * @see {@link PanelProps}
+ */
+export declare function ChangesPanel({ target, t, face }: PanelProps): import("react").JSX.Element;

package/types/client/panels/FilesPanel.d.ts

@@ -0,0 +1,16 @@
+/**
+ * The Files panel: the session's working directory, one level at a time, with a text preview.
+ *
+ * The listing comes from this plugin's own endpoint rather than the Web Client's `listDirectory`,
+ * because the Host's browse capability returns directories only — its one shipped caller is a
+ * workspace picker, and a file browser that cannot show files is not one.
+ * @module @achasoft/dsh-advanced-sidebar/client/panels/FilesPanel
+ */
+import { type PanelProps } from './shared.tsx';
+/**
+ * The directory listing and the preview beside it.
+ * @param props - the target, the translator, and the dock's face.
+ * @returns the panel body.
+ * @see {@link PanelProps}
+ */
+export declare function FilesPanel({ target, t, face }: PanelProps): import("react").JSX.Element;

package/types/client/panels/PreviewPanel.d.ts

@@ -0,0 +1,27 @@
+/**
+ * The Preview panel: run the thing you are building and look at it without leaving the session.
+ *
+ * A launch configuration is started on the Host, its port is watched until it accepts, and the
+ * result is rendered in a frame beside the conversation. The frame is a plain `<iframe>` pointed at
+ * a loopback URL, which is what makes this work for any dev server rather than for a list of
+ * blessed ones.
+ *
+ * Two things a person needs are therefore always present, not hidden behind a state:
+ *
+ * - **Logs.** A server that failed to start has nothing to show in the frame, and its stderr is the
+ *   only place the reason exists. The log view is one toggle away at every state, and opens itself
+ *   when a start fails.
+ * - **Open in a new window.** A page can refuse to be framed (`X-Frame-Options`,
+ *   `frame-ancestors`), and cross-origin framing gives the panel no way to detect that — the load
+ *   event fires either way. So the escape hatch is a permanent control rather than an error
+ *   recovery, and the panel says so instead of pretending a blank frame is a loading one.
+ * @module @achasoft/dsh-advanced-sidebar/client/panels/PreviewPanel
+ */
+import { type PanelProps } from './shared.tsx';
+/**
+ * The server picker, the frame, and the log view.
+ * @param props - the target, the translator, and the dock's face.
+ * @returns the panel body.
+ * @see {@link PanelProps}
+ */
+export declare function PreviewPanel({ target, t, face }: PanelProps): import("react").JSX.Element;

package/types/client/panels/TasksPanel.d.ts

@@ -0,0 +1,28 @@
+/**
+ * The Background tasks panel: this session's `ctx.jobs` records, with Stop and the output of a
+ * settled one.
+ *
+ * The list is not fetched. The Host already pushes `session/jobs` frames that the Web Client folds
+ * into its `jobsBySession` mirror, so this panel reads the same live data the session header's job
+ * chip reads — it appears, moves, and empties without a single request. Only the two verbs the
+ * mirror has no wire for go over this plugin's endpoint.
+ * @module @achasoft/dsh-advanced-sidebar/client/panels/TasksPanel
+ */
+import type { SessionListState } from '@deepseek-ai/dsh-client-runtime/client';
+import type { SnapshotSelectorHook } from '@deepseek-ai/dsh-client-ui-slots';
+import type { AdvancedSidebarSettings } from '../../host/types.ts';
+import { type PanelProps } from './shared.tsx';
+/** The panel's own props: the dock's share plus the two facts only the dock can supply. */
+export interface TasksPanelProps extends PanelProps {
+    /** The global session feed the mirror rides on. */
+    useSessions: SnapshotSelectorHook<SessionListState>;
+    /** The resolved settings section, which decides whether Stop and output are offered. */
+    settings: AdvancedSidebarSettings | undefined;
+}
+/**
+ * The task list, Stop, and the output of a settled task.
+ * @param props - the target, the translator, the dock's face, the session feed, and the settings.
+ * @returns the panel body.
+ * @see {@link TasksPanelProps}
+ */
+export declare function TasksPanel({ target, t, face, useSessions, settings }: TasksPanelProps): import("react").JSX.Element;

package/types/client/panels/TerminalPanel.d.ts

@@ -0,0 +1,40 @@
+/**
+ * The Terminal panel: interactive shells of the operator's own, in the session's working directory.
+ *
+ * There are as many as the Host's `maxTerminals` allows, on a tab strip. Each tab is a separate
+ * `spawnTerminal` allocation with its own emulator, its own poll chain, and its own lifetime; the
+ * handles live in the shared controller rather than in this component, so switching to another
+ * panel or closing the dock leaves the shells running exactly as hiding a terminal pane in an
+ * editor does. A reopened tab replays instead of restarting, because the Host retains each shell's
+ * scrollback and the panel asks for it from offset zero.
+ *
+ * The screen is a real terminal emulator (`@xterm/xterm`), not an approximation. That is not
+ * gold-plating: an interactive shell redraws its prompt with cursor addressing on every keystroke,
+ * and a screen model that understands only carriage returns and erase-line renders a login shell's
+ * prompt as overwritten fragments. Colour, line editing, history recall, and full-screen programs
+ * all come with the emulator; nothing here reimplements them.
+ *
+ * Output arrives by polling, because an out-of-tree plugin has no host-to-client push channel: each
+ * view holds the whole-stream offset it has already written into its emulator and asks for whatever
+ * came after it.
+ * @module @achasoft/dsh-advanced-sidebar/client/panels/TerminalPanel
+ */
+import type { SnapshotSelectorHook } from '@deepseek-ai/dsh-client-ui-slots';
+import '@xterm/xterm/css/xterm.css';
+import type { AdvancedSidebarSettings } from '../../host/types.ts';
+import type { SidebarState } from '../controller.ts';
+import { type PanelProps } from './shared.tsx';
+/** What the panel is handed on top of the shared panel props. */
+export interface TerminalPanelProps extends PanelProps {
+    /** The controller's snapshot hook; the tab strip is rendered from the shared terminal group. */
+    useSidebar: SnapshotSelectorHook<SidebarState>;
+    /** The resolved settings section; absent while neither source has answered. */
+    settings: AdvancedSidebarSettings | undefined;
+}
+/**
+ * The tab strip and the stack of screens under it.
+ * @param props - the target, the translator, the dock's face, and the controller's snapshot hook.
+ * @returns the panel body.
+ * @see {@link TerminalPanelProps}
+ */
+export declare function TerminalPanel({ target, t, face, useSidebar, settings }: TerminalPanelProps): import("react").JSX.Element;

package/types/client/panels/shared.d.ts

@@ -0,0 +1,65 @@
+/**
+ * Pieces the five panels share: the props they are all given, the two formatters that would
+ * otherwise be written five times, and the path renderer.
+ * @module @achasoft/dsh-advanced-sidebar/client/panels/shared
+ */
+import type { PanelHostInjected, Translate } from '../contract.ts';
+import type { OperationTarget } from '../controller.ts';
+/** What every panel is handed by the dock. */
+export interface PanelProps {
+    /** The session and directory this panel acts on. */
+    target: OperationTarget;
+    /** The namespace translator. */
+    t: Translate;
+    /**
+     * The dock's own injected face, minus the reserved `hooks` compartment: the renderer replaces
+     * that with bound `use<Name>` selector props before the dock is rendered, so no panel ever sees
+     * the sources themselves.
+     */
+    face: Omit<PanelHostInjected, 'hooks'>;
+}
+/**
+ * Format a byte count for a file row.
+ *
+ * Locale-independent on purpose: these are units, not prose, and a translated "KB" would make a
+ * size unreadable to anyone reading the same screen in the other language.
+ * @param bytes - the size.
+ * @returns the formatted size.
+ */
+export declare function formatBytes(bytes: number): string;
+/**
+ * Render one path, truncating in the MIDDLE rather than at either end.
+ *
+ * The usual one-line trick for this — `direction: rtl` with `text-overflow: ellipsis` — is wrong
+ * for a path: the bidirectional algorithm reorders the neutral characters a path is made of, so
+ * `dsh/tasks.db` renders as `dsh\tasks.db.` with the separator flipped and the ellipsis moved
+ * inside the name. Two spans do it correctly and in one direction: the head clips with an ellipsis,
+ * the tail never shrinks.
+ * @param props.value - the path.
+ * @param props.className - the row's own class; the container is a flex box.
+ * @returns the path element.
+ */
+export declare function PathText({ value, className }: {
+    value: string;
+    className?: string | undefined;
+}): import("react").JSX.Element;
+/**
+ * Hold the latest value of something an effect reads but must not RESTART for.
+ *
+ * The translator is the case this exists for. Its identity changes on every locale switch, and an
+ * effect that lists it as a dependency is torn down and re-run when the interface language
+ * changes — which for the terminal effect means killing a running shell, and for a poll chain means
+ * dropping and re-arming it. The effects need the current translator, not a reason to restart.
+ * @param value - the value to track.
+ * @returns a ref whose `current` is the latest value.
+ */
+export declare function useLatest<T>(value: T): {
+    readonly current: T;
+};
+/**
+ * Phrase one transport failure for a panel's error line.
+ * @param reason - whatever the call rejected with.
+ * @param t - the namespace translator.
+ * @returns a single-line message.
+ */
+export declare function transportMessage(reason: unknown, t: Translate): string;