dsh-claude-desktop-theme 0.3.0 → 0.4.0

package/lib/types/client/compat/account-menu.d.ts

@@ -1,4 +1,4 @@
-import type { Disposer } from '../contracts/ports.ts';
+import type { Disposer, ThemePreferencePort } from '../contracts/ports.ts';
 /** Marks the portalled account menu for the stylesheet. */
 export declare const ACCOUNT_MENU_ATTRIBUTE = "data-ccd-account-menu";
 /**
@@ -38,8 +38,8 @@ export declare function accountNameToken(name: string): string;
  * the account itself (the account name over a workspace line). DSH's account
  * menu is a portalled `Menu` of plain rows and the signed-in name only exists on
  * the sidebar trigger, so this mirrors that real value onto the open menu and
- * tags it: no row is added, renamed or reordered — the stylesheet only reshapes
- * the card and prints the name it was given.
+ * tags it. The contact row becomes a More submenu whose feedback action still
+ * invokes the original host button.
  *
  * The menu is recognised structurally (a fixed-position `[role="menu"]` that is
  * open while the trigger reports `aria-expanded`), so no menu class hash is
@@ -49,4 +49,4 @@ export declare function accountNameToken(name: string): string;
  * @param report - sink for observer failures; the native menu stays untouched.
  * @returns disposer that disconnects the observers and clears every mark.
  */
-export declare function mountAccountMenu(document: Document, report: (error: unknown) => void): Disposer;
+export declare function mountAccountMenu(document: Document, report: (error: unknown) => void, theme?: ThemePreferencePort | null): Disposer;

package/lib/types/client/compat/account-more.d.ts

@@ -0,0 +1,3 @@
+import type { Disposer } from '../contracts/ports.ts';
+/** ui-settings-account's pinned Menu items are Settings, Contact, Sign in/out. */
+export declare function mountAccountMore(menu: HTMLElement): Disposer;

package/lib/types/client/compat/account-theme.d.ts

@@ -0,0 +1,3 @@
+import type { Disposer, ThemePreferencePort } from '../contracts/ports.ts';
+/** A compact theme row sharing the settings page's native preference service. */
+export declare function mountAccountTheme(menu: HTMLElement, theme: ThemePreferencePort | null): Disposer;

package/lib/types/client/compat/browser-header.d.ts

@@ -0,0 +1,57 @@
+import type { Disposer } from '../contracts/ports.ts';
+/**
+ * The browsing region's header line, and the word that names it.
+ *
+ * The reference draws this region as ONE line: the group's name at the inline
+ * start and, at the trailing edge, the plus that starts a Session, Search and
+ * the view options. DSH renders those controls on a section header of its own,
+ * above a tree whose first row is the first Workspace's, so `sidebar.css` parks
+ * the header on that row's line — and this module is what tells it when. The
+ * merge holds only while the tree actually leads with a Workspace row: flat
+ * mode renders no group at all, and `compat/empty-groups.ts` takes every group
+ * off screen when there is nothing to show, so in both the header stays in the
+ * flow and is the region's own title line.
+ *
+ * That title is a word the host serves (`section.workspaces` when the tree is
+ * grouped, `section.sessions` when it is a flat list) and the reference's is
+ * 最近会话 / Recents. The word is rewritten the way the sidebar's navigation
+ * labels are: only a string the host itself rendered is replaced — a locale
+ * this module does not know keeps the host's own word — and every write is
+ * undone on release. The grouped word takes the reference's name only while the
+ * plugin's no-history prompt is up, which `empty-groups.ts` marks
+ * `data-ccd-empty-state="new"`; a region that still has groups to show keeps
+ * the host's own heading.
+ *
+ * The state is one marker attribute on the browsing region rather than a style
+ * per element, so a single answer covers every re-render the host makes and
+ * dropping the attribute restores the host's own two-row layout.
+ *
+ * The parked band is locked to the tree's content, not to the region's top
+ * edge: the header sits on the first Workspace row's line, so it has to leave
+ * with that row when the tree scrolls. No attribute reports a scroll, and the
+ * scroller is a sibling of the header rather than an ancestor, so CSS cannot
+ * see it (a scroll-driven animation timeline resolves against an ancestor);
+ * this module therefore listens to the scroller and publishes its distance as
+ * `--ccd-header-scroll` for the band's `top`. That is one deliberate listener
+ * beside the observers — the same exception `view-switch.ts` records for the
+ * column's width — and it writes only when the value changes.
+ */
+/** Marker on the browsing region while its header shares the first row's line. */
+export declare const BROWSER_HEADER_ATTRIBUTE = "data-ccd-header-merged";
+/** Custom property carrying the tree's scrolled distance, in px. */
+export declare const HEADER_SCROLL_PROPERTY = "--ccd-header-scroll";
+/**
+ * The name the browsing region's own title line draws.
+ * @param text - the host's word, exactly as it rendered it.
+ * @param noHistory - whether the plugin's no-history prompt is on screen.
+ * @returns the reference's name, or null to leave the host's own word.
+ */
+export declare function browserHeaderWord(text: string, noHistory: boolean): string | null;
+/**
+ * Publish the browsing region's merged-header state, and name its title line.
+ *
+ * @param document - renderer document carrying the sidebar.
+ * @param report - sink for observer failures; the host's two-row layout stays.
+ * @returns disposer that drops the marker and restores every label.
+ */
+export declare function mountBrowserHeader(document: Document, report: (error: unknown) => void): Disposer;

package/lib/types/client/compat/browser-menu.d.ts

@@ -0,0 +1,16 @@
+/** Browser capture menu backed by the native webview. */
+export interface BrowserPopupLayout {
+    readonly width: number;
+    readonly align: 'start' | 'end';
+}
+interface BrowserMenuActions {
+    popup(anchor: HTMLElement, content: HTMLElement, layout: BrowserPopupLayout): void;
+    dismiss(): void;
+    notice(anchor: HTMLElement, text: string): void;
+}
+export interface BrowserMenus {
+    more(anchor: HTMLElement): void;
+    release(): void;
+}
+export declare function mountBrowserMenus(node: HTMLElement, actions: BrowserMenuActions): BrowserMenus;
+export {};

package/lib/types/client/compat/files-pane.d.ts

@@ -0,0 +1,78 @@
+import type { Disposer } from '../contracts/ports.ts';
+/**
+ * The Files pane's own three controls, and the empty column beside it
+ * (DESIGN.md §6.9).
+ *
+ * `right-panel.css` dresses what the host draws. Three things the reference
+ * draws have nothing in the host's pane to dress, so this module supplies them
+ * as nodes the sheet styles, and keeps them in place across React's renders:
+ *
+ * **The filter field.** The host's `FilesBody` header is a root path with a
+ * reload and the open-in-app actions after it — there is no filter in the
+ * package at all. The reference's pane leads with a rounded field over the tree
+ * and nothing else, so the field takes the path's seat (the sheet hides the
+ * label) and the host's own controls keep theirs at the row's end. Typing
+ * filters the *loaded* rows by name: a row stays when its own name contains the
+ * query or when it is an ancestor of a row that does. The host lists a
+ * directory only once it is expanded, so a filtered tree can only narrow what
+ * the reader has already opened — the reference searches its session on the
+ * server, which this interface has no face for.
+ *
+ * **The tree's show / hide control.** The reference's own pane hides its file
+ * tree from a control on the divider between its two columns and, once hidden,
+ * leaves a small affordance at the pane's leading edge to bring it back. This
+ * pane has one column, so the control lives in the header line: {@link
+ * TOGGLE_ATTRIBUTE} marks the button, {@link TREE_ATTRIBUTE} on the root carries
+ * the state, and the sheet swaps the rows for {@link EXPAND_ATTRIBUTE}'s row
+ * while the tree is away.
+ *
+ * **The Files tab's mark.** The host's tab title draws a category-coloured
+ * folder; the reference draws a three-row list on a tinted square. The mark
+ * cannot be drawn on the host's glyph — a mask would clip the square with it —
+ * so {@link TAB_ATTRIBUTE} marks the Files tab, {@link MARK_ATTRIBUTE} is the
+ * node that takes the glyph's seat, and the sheet paints both.
+ *
+ * The empty column is DockKit's, not the Files package's: a dock column no tab
+ * has claimed shows one line of the host's copy. The reference's landing state
+ * is a folder over a title and a line of guidance, so the host's line is marked
+ * ({@link EMPTY_SOURCE_ATTRIBUTE}) and left in the document, and a block this
+ * module writes ({@link EMPTY_ATTRIBUTE}) is what the column draws.
+ *
+ * Everything written here lands on host nodes as `data-ccd-files-*` markers or
+ * as plugin-owned nodes beside them, and the disposer takes all of it back.
+ * The module is unconditional: the right panel exists in both DSH builds and
+ * behind every feature switch.
+ */
+/** The state of the tree, written on the Files root: `hidden` or absent. */
+export declare const TREE_ATTRIBUTE = "data-ccd-files-tree";
+/** Marks a row the filter excludes; the sheet does not draw it. */
+export declare const ROW_ATTRIBUTE = "data-ccd-files-hidden";
+/** Marks the Files tab in the panel's strip. */
+export declare const TAB_ATTRIBUTE = "data-ccd-files-tab";
+/** The filter field's own box, and the input inside it. */
+export declare const FIELD_ATTRIBUTE = "data-ccd-files-filter";
+/** The filter's clear control. */
+export declare const CLEAR_ATTRIBUTE = "data-ccd-files-clear";
+/** The header's tree show / hide control, and the pane's own re-open row. */
+export declare const TOGGLE_ATTRIBUTE = "data-ccd-files-toggle";
+export declare const EXPAND_ATTRIBUTE = "data-ccd-files-expand";
+/** The Files tab's mark, in the seat the host's file-type glyph had. */
+export declare const MARK_ATTRIBUTE = "data-ccd-files-mark";
+/** The empty column's block, and the host line it stands in for. */
+export declare const EMPTY_ATTRIBUTE = "data-ccd-files-empty";
+export declare const EMPTY_SOURCE_ATTRIBUTE = "data-ccd-files-empty-source";
+/** One empty column's three parts. */
+export declare const EMPTY_MARK_ATTRIBUTE = "data-ccd-files-empty-mark";
+export declare const EMPTY_TITLE_ATTRIBUTE = "data-ccd-files-empty-title";
+export declare const EMPTY_BODY_ATTRIBUTE = "data-ccd-files-empty-body";
+/** The line a query that matched nothing leaves under the list. */
+export declare const NOMATCH_ATTRIBUTE = "data-ccd-files-nomatch";
+/**
+ * Mount the Files pane's filter field, its tree control, its tab mark and the
+ * empty column beside it.
+ *
+ * @param document - renderer document carrying the interface.
+ * @param report - sink for observer failures; the host's own pane stays usable.
+ * @returns disposer that removes every node, marker and listener added here.
+ */
+export declare function mountFilesPane(document: Document, report: (error: unknown) => void): Disposer;

package/lib/types/client/compat/header-menu-actions.d.ts

@@ -0,0 +1,14 @@
+import type { Context } from '@deepseek-ai/cordis';
+/** Only host-authoritative identity and mutations cross into the menu renderer. */
+export interface HeaderMenuActions {
+    read(id: string): {
+        title: string;
+        folder: string;
+        path: string;
+    } | null;
+    rename(id: string, title: string): Promise<void>;
+    fork(id: string): Promise<void>;
+    archive(id: string): Promise<void>;
+    subscribe(listener: () => void): () => void;
+}
+export declare function headerMenuActions(ctx: Context): HeaderMenuActions;

package/lib/types/client/compat/header-menus.d.ts

@@ -0,0 +1,4 @@
+import type { Disposer } from '../contracts/ports.ts';
+import type { HeaderMenuActions } from './header-menu-actions.ts';
+/** Add reference menus beside the native title without moving React-owned nodes. */
+export declare function mountHeaderMenus(document: Document, actions: HeaderMenuActions, report: (error: unknown) => void): Disposer;

package/lib/types/client/compat/host-dom.d.ts

@@ -28,6 +28,15 @@
  * - `packages/client/ui-attachment/src/client/ComposerAttachments.module.css` (`dVdiKa_`)
  * - `packages/client/ui-chat/src/client/chat/StatsPills.module.css` (`OpZ85W_`)
  * - `packages/client/ui-workspace/src/client/WorkspaceBrowser.module.css` (`_7514NG_`)
+ * - `packages/client/ui-sidebar-right/src/client/shell/SidebarRight.tsx` (the
+ *   panel box and its `data-sidebar-right-*` hooks)
+ * - `packages/client/ui-dockkit/src/client/DockLayout.tsx` and its
+ *   `DockLayout.module.css` (`_6nhg2_`), shipped on both installers as part of
+ *   the `dsh-web-frontend` dist (`data-dockkit-*` hooks)
+ * - `packages/client/ui-sidebar-files/src/client/FilesBody.tsx` (the file tree
+ *   and its `data-files-*` hooks)
+ * - `packages/client/ui-workspace/src/client/rows/Rows.module.css` (`jJkEga_`: the
+ *   Workspace and Session rows, and the primary bundle's copy of the same sheet)
  * - `packages/client/ui-workspace/src/client/rows/Rows.tsx` (`data-row-key` on the
  *   Workspace and Session rows: `workspace:<key>` / `session:<id>`)
  * - `packages/client/ui-settings/src/client/SettingsRoot.module.css` (`Dws9Sa_`)
@@ -48,6 +57,75 @@ export declare const HOST: Readonly<{
     readonly centerColumn: '._6Qf49G_centerCol';
     readonly rightbarColumn: '._6Qf49G_rightbarCol';
     readonly resizeHandle: '._6Qf49G_handle';
+    /**
+     * ui-sidebar-right/shell/SidebarRight.tsx: the right panel's own box, which
+     * the host positions absolutely against the column's right edge and sizes
+     * inline (the resolved width, or `100vw` in full screen). Its
+     * `data-sidebar-right-panel` (`push` / `fullscreen`) and
+     * `data-sidebar-right-open` are the package's own stable hooks, so the card
+     * `shell.css` paints on it survives a build whose classes were rehashed; this
+     * plugin authors no selector for the panel's hashed class.
+     */
+    readonly rightbarPanel: '[data-sidebar-right-panel]';
+    /**
+     * DockKit (`dsh-web-frontend`'s dock layout, the static bundle both installers
+     * ship — the same case `_1ypvv_` records in `host-builds.ts`, so these need no
+     * prefix entry): the boxes inside that panel, also addressed by the package's
+     * own data attributes. `surface` is the layout root the card's fill is drawn
+     * on, `pane` a dock column that would otherwise paint the canvas over it,
+     * `strip` the tab strip (the card's header row), `divider` the hairline
+     * between two columns, `empty` a column no tab has claimed. Only
+     * `features/shell/right-panel.css` reads them.
+     */
+    readonly dockSurface: '[data-dockkit-surface]';
+    readonly dockPane: '[data-dockkit-pane]';
+    readonly dockStrip: '[data-dockkit-strip]';
+    readonly dockTab: '[data-dockkit-tab]';
+    readonly dockTabTitle: '[data-dockkit-tab-title]';
+    readonly dockStripChrome: '[data-dockkit-strip-chrome]';
+    readonly dockDivider: '[data-dockkit-divider]';
+    readonly dockEmpty: '[data-dockkit-empty]';
+    /**
+     * DockKit's tab body and its two hosts. Every tab of the panel draws one
+     * `content` box, and where that box sits says how the tab is hosted: inside a
+     * dock column (`host="dock"`) it is a tab of the panel's own strip, while a
+     * `float` box carries `data-dockkit-float` itself and is drawn `position:
+     * fixed` at the rectangle the layout stores for it. `compat/right-panes.ts`
+     * reads the two apart to decide which tabs are still tabs and which are panes.
+     */
+    readonly dockContent: '[data-dockkit-content]';
+    readonly dockFloat: '[data-dockkit-float]';
+    /**
+     * DockKit's float header: the grip a pointer drags the pane by, and the two
+     * controls it draws — "dock back into the panel" and "close". The panes this
+     * plugin draws keep the grip's place as their title row (with the drag
+     * retired) and hide the dock control, because a pane is already docked in
+     * everything but name; the close control stays the reader's way out of one.
+     */
+    readonly dockFloatGrip: '[data-dockkit-float-grip]';
+    readonly dockFloatTitle: '[data-dockkit-float-title]';
+    readonly dockFloatDock: '[data-dockkit-float-dock]';
+    readonly dockFloatResize: '[data-dockkit-float-resize]';
+    /**
+     * ui-sidebar-right/shell/SidebarRight.tsx: the Session the panel on screen is
+     * drawing. The panel element is reused across Session switches, so the tabs
+     * this module floats are read for the Session this hook names rather than for
+     * whatever the layout last held.
+     */
+    readonly rightbarSession: '[data-sidebar-right-session]';
+    /**
+     * ui-sidebar-files/FilesBody.tsx: the file tree's own hooks. The pane's header
+     * is the root's non-body child (the scroller writes `data-files-body`), each
+     * entry row carries `data-files-entry` (`directory` / `file` / `other`) with
+     * the path it stands for, and the host's folder glyph and per-type glyph are
+     * the row button's first child. The tree's rows are dressed through these
+     * hooks and their own structure, so the Files sheet needs no class name of
+     * that package — whose hashes differ per build and are not in the pinned
+     * tables — either.
+     */
+    readonly filesRoot: '[data-files-root]';
+    readonly filesBody: '[data-files-body]';
+    readonly filesEntry: '[data-files-entry]';
     readonly sidebarRoot: '._3WPZCG_root';
     readonly sidebarLogoRow: '._3WPZCG_logoRow';
     readonly sidebarBrand: '._3WPZCG_brand';
@@ -71,6 +149,25 @@ export declare const HOST: Readonly<{
     readonly browserSectionHeader: '._7514NG_sectionHeader';
     readonly browserSectionLabel: '._7514NG_sectionLabel';
     readonly browserListArea: '._7514NG_listArea';
+    /** WorkspaceBrowser.module.css: the header's two control groups, which
+        `sidebar.css` keeps clickable while the header is parked over a row. */
+    readonly browserSectionActions: '._7514NG_headerActions';
+    readonly browserSearchSlot: '._7514NG_searchSlot';
+    /** WorkspaceBrowser.module.css: the search control and its expanded state —
+        the one the parked header paints a background under, because the field
+        then covers the Workspace row it is parked on. */
+    readonly browserSearch: '._7514NG_search';
+    readonly browserSearchExpanded: '._7514NG_searchExpanded';
+    /** WorkspaceBrowser.module.css: the tree's own scroller — the one element
+        whose scroll distance the parked header band follows. */
+    readonly browserList: '._7514NG_list';
+    /** Rows.module.css: one Workspace's row, the line the merged header shares,
+        and its trailing action group (`sidebar.css` parks both). */
+    readonly workspaceRow: '.jJkEga_projectRow';
+    readonly workspaceRowActions: '.jJkEga_rowActions';
+    /** Rows.module.css: the state the host puts on a row whose menu is open —
+        `sidebar.css` keeps that row's own actions visible through it. */
+    readonly workspaceRowMenuOpen: '.jJkEga_menuOpen';
     /**
      * WorkspaceBrowser.module.css: the section header's view-options trigger —
      * the one control there that is an `iconButton` *and* carries `wide` (its
@@ -193,6 +290,10 @@ export declare const HOST: Readonly<{
     /** TeamAction.module.css: native team dialog entry, retaining its label at every width. */
     readonly teamActionTrigger: '._2tNPVa_trigger';
     readonly teamActionLabel: '._2tNPVa_triggerLabel';
+    /** TeamAction.module.css: the panel's own body, the one element of that
+        surface that scrolls. `compat/scroll-pill.ts` tracks it like the four
+        page-level scrollers, so the panel carries the interface's bar too. */
+    readonly teamBody: '._2tNPVa_body';
     /** AgentPresetLabel.module.css: passive mode description, omitted from the conversation header. */
     readonly presetModeLabel: '._3li69W_label';
     /** AgentPresetLabel.module.css: redundant icon may yield space to its text. */
@@ -254,6 +355,12 @@ export declare const ANCHOR: Readonly<{
      * Workspace headers share the attribute with other prefixes.
      */
     readonly sessionRows: '[data-row-key^="session:"]';
+    /**
+     * Each Workspace's own row, the first keyed row of its group. `Rows.tsx`
+     * writes it, and `browser-header.ts` reads it to tell a grouped tree from a
+     * flat list before publishing the region's merged-header state.
+     */
+    readonly workspaceRows: '[data-row-key^="workspace:"]';
     readonly settings: '[data-slot="sidebar.settings"]';
     readonly conversation: '[data-conversation-content]';
     /**
@@ -263,6 +370,15 @@ export declare const ANCHOR: Readonly<{
      * reads it rather than a measurement of our own.
      */
     readonly rightbarCollapsed: '[data-slot="root"] > div[data-rightbar-collapsed]';
+    /**
+     * AppFrame.tsx: the same frame element while the sidebar's own track is 0.
+     * The host writes `data-sidebar-collapsed` from the layout store, and on the
+     * desktop builds the collapsed sidebar is not a rail — the frame solves its
+     * grid track to 0px and `sidebarCol`'s `overflow: hidden` clips the whole
+     * column. `compat/view-switch.ts` reads it as the state in which the parked
+     * View switcher has no corner to sit in.
+     */
+    readonly sidebarCollapsed: '[data-slot="root"] > div[data-sidebar-collapsed]';
     /** The element that actually scrolls the Conversation page. In the pinned
         layout the transcript column inside it is `overflow: visible`, so this is
         the scroll viewport the edge fade has to describe. */

package/lib/types/client/compat/pane-chrome.d.ts

@@ -0,0 +1,29 @@
+export interface PaneChromeOptions {
+    readonly kind: string;
+    readonly title: string;
+    readonly filesRoot: HTMLElement | null;
+    readonly zoomed: boolean;
+    readonly onZoom: () => void;
+    readonly onNew: () => void;
+    readonly onSelect: (id: string) => void;
+    readonly onClose: (id: string) => void;
+    readonly closeTabs: readonly string[];
+    readonly terminals: readonly {
+        id: string;
+        title: string;
+        selected: boolean;
+    }[];
+    readonly files: readonly {
+        id: string;
+        title: string;
+        selected: boolean;
+    }[];
+    readonly panel: HTMLElement;
+}
+export interface PaneChrome {
+    update(options: PaneChromeOptions): void;
+    release(): void;
+}
+/** Claude's toolbar beside host controls. Page picking keeps its reference
+ * silhouette and explains the host limitation; pane windows are omitted. */
+export declare function mountPaneChrome(node: HTMLElement): PaneChrome | null;

package/lib/types/client/compat/pane-icons.d.ts

@@ -0,0 +1,23 @@
+/** Toolbar silhouettes matching the Claude recording. Static SVG only. */
+declare const ICONS: {
+    readonly Add: "<svg viewBox=\"0 0 1000 1000\" fill=\"currentColor\" aria-hidden=\"true\"><path transform=\"translate(0 1000) scale(1 -1)\" d=\"M472 800Q472 812 480.0 820.0Q488 828 500 828Q512 828 520.0 820.0Q528 812 528 800V200Q528 188 520.0 180.0Q512 172 500 172Q488 172 480.0 180.0Q472 188 472 200ZM800 528Q812 528 820.0 520.0Q828 512 828 500Q828 488 820.0 480.0Q812 472 800 472H200Q188 472 180.0 480.0Q172 488 172 500Q172 512 180.0 520.0Q188 528 200 528Z\"/></svg>";
+    readonly DotsVertical: "<svg viewBox=\"0 0 1000 1000\" fill=\"currentColor\" aria-hidden=\"true\"><path transform=\"translate(0 1000) scale(1 -1)\" d=\"M434 221Q434 232 441.5 241.0Q449 250 461 251Q472 251 481.0 243.5Q490 236 491 224Q491 221 493.5 218.5Q496 216 500 216Q504 216 506.5 218.5Q509 221 509 225Q509 229 506.5 231.5Q504 234 500 234Q496 234 493.5 231.5Q491 229 491 226Q491 237 483.5 246.0Q476 255 464 255L502 253Q513 252 521.0 243.5Q529 235 528 223Q527 212 518.5 204.0Q510 196 498 197L461 199Q449 200 441.5 209.0Q434 218 434 229Q436 255 455.0 273.0Q474 291 500 291Q518 291 533.0 282.0Q548 273 557.0 258.0Q566 243 566 225Q566 207 557.0 192.0Q548 177 533.0 168.0Q518 159 500 159Q474 159 455.0 177.0Q436 195 434 221ZM434 496Q434 507 441.5 516.0Q449 525 461 526Q472 526 481.0 518.5Q490 511 491 499Q491 496 493.5 493.5Q496 491 500 491Q504 491 506.5 493.5Q509 496 509 500Q509 504 506.5 506.5Q504 509 500 509Q496 509 493.5 506.5Q491 504 491 501Q491 512 483.5 521.0Q476 530 464 530L502 528Q513 527 521.0 518.5Q529 510 528 498Q527 487 518.5 479.0Q510 471 498 472L461 474Q449 475 441.5 484.0Q434 493 434 504Q436 530 455.0 548.0Q474 566 500 566Q518 566 533.0 557.0Q548 548 557.0 533.0Q566 518 566 500Q566 482 557.0 467.0Q548 452 533.0 443.0Q518 434 500 434Q474 434 455.0 452.0Q436 470 434 496ZM434 771Q434 782 441.5 791.0Q449 800 461 801Q472 801 481.0 793.5Q490 786 491 774Q491 771 493.5 768.5Q496 766 500 766Q504 766 506.5 768.5Q509 771 509 775Q509 779 506.5 781.5Q504 784 500 784Q496 784 493.5 781.5Q491 779 491 776Q491 787 483.5 796.0Q476 805 464 805L502 803Q513 802 521.0 793.5Q529 785 528 773Q527 762 518.5 754.0Q510 746 498 747L461 749Q449 750 441.5 759.0Q434 768 434 779Q436 805 455.0 823.0Q474 841 500 841Q518 841 533.0 832.0Q548 823 557.0 808.0Q566 793 566 775Q566 757 557.0 742.0Q548 727 533.0 718.0Q518 709 500 709Q474 709 455.0 727.0Q436 745 434 771Z\"/></svg>";
+    readonly WindowNew: "<svg viewBox=\"0 0 1000 1000\" fill=\"currentColor\" aria-hidden=\"true\"><path transform=\"translate(0 1000) scale(1 -1)\" d=\"M325 647V703H875V647ZM297 425V775Q297 797 307.5 814.5Q318 832 335.5 842.5Q353 853 375 853H825Q847 853 864.5 842.5Q882 832 892.5 814.5Q903 797 903 775V425Q903 403 892.5 385.5Q882 368 864.5 357.5Q847 347 825 347H375Q353 347 335.5 357.5Q318 368 307.5 385.5Q297 403 297 425ZM353 425Q353 416 359.5 409.5Q366 403 375 403H825Q834 403 840.5 409.5Q847 416 847 425V775Q847 784 840.5 790.5Q834 797 825 797H375Q366 797 359.5 790.5Q353 784 353 775ZM647 375H703V225Q703 203 692.5 185.5Q682 168 664.5 157.5Q647 147 625 147H175Q153 147 135.5 157.5Q118 168 107.5 185.5Q97 203 97 225V575Q97 597 107.5 614.5Q118 632 135.5 642.5Q153 653 175 653H325V597H175Q166 597 159.5 590.5Q153 584 153 575V225Q153 216 159.5 209.5Q166 203 175 203H625Q634 203 640.5 209.5Q647 216 647 225Z\"/></svg>";
+    readonly Expand: "<svg viewBox=\"0 0 1000 1000\" fill=\"currentColor\" aria-hidden=\"true\"><path transform=\"translate(0 1000) scale(1 -1)\" d=\"M595 555Q587 547 575.0 547.0Q563 547 555 555Q547 563 547.0 575.0Q547 587 555 595L805 845L845 805ZM625 797Q613 797 605.0 805.0Q597 813 597 825Q597 837 605.0 845.0Q613 853 625 853H825Q837 853 845.0 845.0Q853 837 853 825V625Q853 613 845.0 605.0Q837 597 825 597Q813 597 805.0 605.0Q797 613 797 625V797ZM405 445Q413 453 425.0 453.0Q437 453 445 445Q453 437 453.0 425.0Q453 413 445 405L195 155L155 195ZM375 203Q387 203 395.0 195.0Q403 187 403 175Q403 163 395.0 155.0Q387 147 375 147H175Q163 147 155.0 155.0Q147 163 147 175V375Q147 387 155.0 395.0Q163 403 175 403Q187 403 195.0 395.0Q203 387 203 375V203Z\"/></svg>";
+    readonly Collapse: "<svg viewBox=\"0 0 1000 1000\" fill=\"currentColor\" aria-hidden=\"true\"><path transform=\"translate(0 1000) scale(1 -1)\" d=\"M805 845Q813 853 825.0 853.0Q837 853 845 845Q853 837 853.0 825.0Q853 813 845 805L595 555L555 595ZM775 603Q787 603 795.0 595.0Q803 587 803 575Q803 563 795.0 555.0Q787 547 775 547H575Q563 547 555.0 555.0Q547 563 547 575V775Q547 787 555.0 795.0Q563 803 575 803Q587 803 595.0 795.0Q603 787 603 775V603ZM195 155Q187 147 175.0 147.0Q163 147 155 155Q147 163 147.0 175.0Q147 187 155 195L405 445L445 405ZM225 397Q213 397 205.0 405.0Q197 413 197 425Q197 437 205.0 445.0Q213 453 225 453H425Q437 453 445.0 445.0Q453 437 453 425V225Q453 213 445.0 205.0Q437 197 425 197Q413 197 405.0 205.0Q397 213 397 225V397Z\"/></svg>";
+    readonly Search: "<svg viewBox=\"0 0 1000 1000\" fill=\"currentColor\" aria-hidden=\"true\"><path transform=\"translate(0 1000) scale(1 -1)\" d=\"M753 575Q753 510 728.0 449.5Q703 389 657 343Q611 297 550.5 272.0Q490 247 425 247Q360 247 299.5 272.0Q239 297 193 343Q147 389 122.0 449.5Q97 510 97 575Q97 640 122.0 700.5Q147 761 193 807Q239 853 299.5 878.0Q360 903 425 903Q490 903 550.5 878.0Q611 853 657 807Q703 761 728.0 700.5Q753 640 753 575ZM697 575Q697 629 676.0 679.0Q655 729 617 767Q579 805 529.0 826.0Q479 847 425 847Q371 847 321.0 826.0Q271 805 233 767Q195 729 174.0 679.0Q153 629 153 575Q153 521 174.0 471.0Q195 421 233 383Q271 345 321.0 324.0Q371 303 425 303Q479 303 529.0 324.0Q579 345 617 383Q655 421 676.0 471.0Q697 521 697 575ZM618 343 657 382 895 145Q903 137 903.0 125.0Q903 113 895 105Q887 97 875.0 97.0Q863 97 855 105Z\"/></svg>";
+    readonly Cursor: "<svg viewBox=\"0 0 1000 1000\" fill=\"currentColor\" aria-hidden=\"true\"><path transform=\"translate(0 1000) scale(1 -1)\" d=\"M174 826Q188 840 207.5 845.0Q227 850 246 844L855 648Q877 642 890.0 623.5Q903 605 903 583Q903 559 888.0 540.0Q873 521 849 516L624 467Q634 470 640.0 478.0Q646 486 645.5 496.5Q645 507 638 515L852 300Q868 285 868.0 263.0Q868 241 852 225L775 148Q760 132 737.5 132.0Q715 132 700 148L485 362Q493 355 503.5 354.5Q514 354 522.0 360.0Q530 366 533 376L484 151Q479 127 460.0 112.0Q441 97 417 97Q395 97 377.0 110.0Q359 123 352 145L156 754Q150 773 155.0 792.5Q160 812 174 826ZM214 786Q207 780 210 771L405 162Q406 158 409.5 155.5Q413 153 417 153Q422 153 425.0 156.0Q428 159 429 163L478 388Q480 399 488.5 405.0Q497 411 507.0 410.5Q517 410 525 402L740 188H735L812 265V260L598 475Q590 483 589.5 493.0Q589 503 595.0 511.5Q601 520 612 522L837 571Q841 572 844.0 575.0Q847 578 847 583Q847 587 844.5 590.5Q842 594 838 595L229 790Q220 793 214 786Z\"/></svg>";
+    readonly Globe: "<svg viewBox=\"0 0 1000 1000\" fill=\"currentColor\" aria-hidden=\"true\"><path transform=\"translate(0 1000) scale(1 -1)\" d=\"M872 500Q872 426 843.5 357.5Q815 289 763 237Q711 185 642.5 156.5Q574 128 500 128Q426 128 357.5 156.5Q289 185 237 237Q185 289 156.5 357.5Q128 426 128 500Q128 574 156.5 642.5Q185 711 237 763Q289 815 357.5 843.5Q426 872 500 872Q574 872 642.5 843.5Q711 815 763 763Q815 711 843.5 642.5Q872 574 872 500ZM816 500Q816 563 792.0 621.0Q768 679 723 723Q679 768 621.0 792.0Q563 816 500 816Q437 816 379.0 792.0Q321 768 277 723Q232 679 208.0 621.0Q184 563 184 500Q184 437 208.0 379.0Q232 321 277 277Q321 232 379.0 208.0Q437 184 500 184Q563 184 621.0 208.0Q679 232 723 277Q768 321 792.0 379.0Q816 437 816 500ZM684 500Q684 426 671.5 360.5Q659 295 636 245Q625 220 611.0 199.0Q597 178 580 163Q562 146 543 138Q500 118 457 138Q438 146 420 163Q403 178 389.0 199.0Q375 220 364 245Q341 295 328.5 360.5Q316 426 316 500Q316 574 328.5 639.5Q341 705 364 755Q375 780 389.0 801.0Q403 822 420 837Q438 854 457 862Q500 882 543 862Q562 854 580 837Q597 822 611.0 801.0Q625 780 636 755Q659 705 671.5 639.5Q684 574 684 500ZM628 500Q628 569 616.5 628.5Q605 688 585 731Q575 753 564.0 769.5Q553 786 542 796Q531 806 520 811Q500 820 480 811Q469 806 458 796Q447 786 436.0 769.5Q425 753 415 731Q395 688 383.5 628.5Q372 569 372 500Q372 431 383.5 371.5Q395 312 415 269Q425 247 436.0 230.5Q447 214 458 204Q469 194 480 189Q500 180 520 189Q531 194 542 204Q553 214 564.0 230.5Q575 247 585 269Q605 312 616.5 371.5Q628 431 628 500ZM156 472V528H844V472Z\"/></svg>";
+    readonly CaretDown: "<svg viewBox=\"0 0 1000 1000\" fill=\"currentColor\" aria-hidden=\"true\"><path transform=\"translate(0 1000) scale(1 -1)\" d=\"M805 670Q813 678 825.0 678.0Q837 678 845 670Q853 662 853.0 650.0Q853 638 845 630L520 305Q512 297 500.0 297.0Q488 297 480 305L155 630Q147 638 147.0 650.0Q147 662 155 670Q163 678 175.0 678.0Q187 678 195 670L500 365Z\"/></svg>";
+    readonly CaretLeft: "<svg viewBox=\"0 0 1000 1000\" fill=\"currentColor\" aria-hidden=\"true\"><path transform=\"translate(0 1000) scale(1 -1)\" d=\"M670 195Q678 187 678.0 175.0Q678 163 670 155Q662 147 650.0 147.0Q638 147 630 155L305 480Q297 488 297.0 500.0Q297 512 305 520L630 845Q638 853 650.0 853.0Q662 853 670 845Q678 837 678.0 825.0Q678 813 670 805L365 500Z\"/></svg>";
+    readonly CaretRight: "<svg viewBox=\"0 0 1000 1000\" fill=\"currentColor\" aria-hidden=\"true\"><path transform=\"translate(0 1000) scale(1 -1)\" d=\"M370 155Q362 147 350.0 147.0Q338 147 330 155Q322 163 322.0 175.0Q322 187 330 195L635 500L330 805Q322 813 322.0 825.0Q322 837 330 845Q338 853 350.0 853.0Q362 853 370 845L695 520Q703 512 703.0 500.0Q703 488 695 480Z\"/></svg>";
+    readonly ArrowClockwise: "<svg viewBox=\"0 0 1000 1000\" fill=\"currentColor\" aria-hidden=\"true\"><path transform=\"translate(0 1000) scale(1 -1)\" d=\"M869 609Q872 598 867.0 587.5Q862 577 851 573Q840 570 829.5 575.0Q819 580 815 591Q801 634 773.0 675.0Q745 716 704.5 749.0Q664 782 612.5 802.0Q561 822 500 822Q433 822 375.0 797.0Q317 772 272.5 727.5Q228 683 203.0 625.0Q178 567 178 500Q178 433 203.0 375.0Q228 317 272.5 272.5Q317 228 375.0 203.0Q433 178 500 178Q576 178 642.5 208.0Q709 238 753 293Q760 302 772.0 303.0Q784 304 793 297Q802 290 803.0 278.0Q804 266 797 257Q745 193 667.0 157.5Q589 122 500 122Q422 122 353.5 151.5Q285 181 233.0 233.0Q181 285 151.5 353.5Q122 422 122 500Q122 578 151.5 646.5Q181 715 233.0 767.0Q285 819 353.5 848.5Q422 878 500 878Q570 878 630.0 855.5Q690 833 737.5 794.5Q785 756 818.0 708.0Q851 660 869 609ZM847 825Q847 837 855.0 845.0Q863 853 875 853Q887 853 895.0 845.0Q903 837 903 825V575Q903 563 895.0 555.0Q887 547 875 547H625Q613 547 605.0 555.0Q597 563 597 575Q597 587 605.0 595.0Q613 603 625 603H847Z\"/></svg>";
+    readonly X: "<svg viewBox=\"0 0 1000 1000\" fill=\"currentColor\" aria-hidden=\"true\"><path transform=\"translate(0 1000) scale(1 -1)\" d=\"M705 745Q713 753 725.0 753.0Q737 753 745 745Q753 737 753.0 725.0Q753 713 745 705L295 255Q287 247 275.0 247.0Q263 247 255 255Q247 263 247.0 275.0Q247 287 255 295ZM745 295Q753 287 753.0 275.0Q753 263 745 255Q737 247 725.0 247.0Q713 247 705 255L255 705Q247 713 247.0 725.0Q247 737 255 745Q263 753 275.0 753.0Q287 753 295 745Z\"/></svg>";
+    readonly Folder: "<svg viewBox=\"0 0 1000 1000\" fill=\"currentColor\" aria-hidden=\"true\"><path transform=\"translate(0 1000) scale(1 -1)\" d=\"M275 647Q263 647 255.0 655.0Q247 663 247 675Q247 687 255.0 695.0Q263 703 275 703H825Q847 703 864.5 692.5Q882 682 892.5 664.5Q903 647 903 625V225Q903 203 892.5 185.5Q882 168 864.5 157.5Q847 147 825 147H175Q153 147 135.5 157.5Q118 168 107.5 185.5Q97 203 97 225V775Q97 797 107.5 814.5Q118 832 135.5 842.5Q153 853 175 853H444Q466 853 485.0 841.5Q504 830 514 810L575 688Q580 677 576.5 666.0Q573 655 563 650Q552 645 541.0 648.5Q530 652 525 662L464 785Q458 797 444 797H175Q166 797 159.5 790.5Q153 784 153 775V225Q153 216 159.5 209.5Q166 203 175 203H825Q834 203 840.5 209.5Q847 216 847 225V625Q847 634 840.5 640.5Q834 647 825 647Z\"/></svg>";
+    readonly Files: "<svg viewBox=\"0 0 1000 1000\" fill=\"currentColor\" aria-hidden=\"true\"><path transform=\"translate(0 1000) scale(1 -1)\" d=\"M785 247H415Q396 247 380.5 256.0Q365 265 356.0 280.5Q347 296 347 315V835Q347 854 356.0 869.5Q365 885 380.5 894.0Q396 903 415 903H666Q693 903 713 884L833 767Q853 747 853 718V315Q853 296 844.0 280.5Q835 265 819.5 256.0Q804 247 785 247ZM785 303Q790 303 793.5 306.5Q797 310 797 315V718L793 727L674 844L666 847H415Q410 847 406.5 843.5Q403 840 403 835V315Q403 310 406.5 306.5Q410 303 415 303ZM375 753V697H215Q210 697 206.5 693.5Q203 690 203 685V165Q203 160 206.5 156.5Q210 153 215 153H585Q590 153 593.5 156.5Q597 160 597 165V275H653V165Q653 146 644.0 130.5Q635 115 619.5 106.0Q604 97 585 97H215Q196 97 180.5 106.0Q165 115 156.0 130.5Q147 146 147 165V685Q147 704 156.0 719.5Q165 735 180.5 744.0Q196 753 215 753ZM622 850Q622 862 630.0 870.0Q638 878 650 878Q662 878 670.0 870.0Q678 862 678 850V750Q678 741 684.5 734.5Q691 728 700 728H800Q812 728 820.0 720.0Q828 712 828 700Q828 688 820.0 680.0Q812 672 800 672H700Q678 672 660.5 682.5Q643 693 632.5 710.5Q622 728 622 750Z\"/></svg>";
+    readonly SidebarClose: "<svg viewBox=\"0 0 1000 1000\" fill=\"currentColor\" aria-hidden=\"true\"><path transform=\"translate(0 1000) scale(1 -1)\" d=\"M147 825Q147 837 155.0 845.0Q163 853 175 853Q187 853 195.0 845.0Q203 837 203 825V175Q203 163 195.0 155.0Q187 147 175 147Q163 147 155.0 155.0Q147 163 147 175ZM825 528Q837 528 845.0 520.0Q853 512 853 500Q853 488 845.0 480.0Q837 472 825 472H393L570 295Q578 287 578.0 275.0Q578 263 570 255Q562 247 550.0 247.0Q538 247 530 255L305 480Q296 489 296.5 500.5Q297 512 304.5 520.0Q312 528 325 528ZM530 745Q538 753 550.0 753.0Q562 753 570 745Q578 737 578.0 725.0Q578 713 570 705L345 480L305 520Z\"/></svg>";
+    readonly SidebarOpen: "<svg viewBox=\"0 0 1000 1000\" fill=\"currentColor\" aria-hidden=\"true\"><path transform=\"translate(0 1000) scale(1 -1)\" d=\"M797 825Q797 837 805.0 845.0Q813 853 825 853Q837 853 845.0 845.0Q853 837 853 825V175Q853 163 845.0 155.0Q837 147 825 147Q813 147 805.0 155.0Q797 163 797 175ZM175 472Q163 472 155.0 480.0Q147 488 147 500Q147 512 155.0 520.0Q163 528 175 528H675Q688 528 695.5 520.0Q703 512 703.5 500.5Q704 489 695 480L470 255Q462 247 450.0 247.0Q438 247 430 255Q422 263 422.0 275.0Q422 287 430 295L607 472ZM430 705Q422 713 422.0 725.0Q422 737 430 745Q438 753 450.0 753.0Q462 753 470 745L695 520L655 480Z\"/></svg>";
+};
+export type PaneIcon = keyof typeof ICONS;
+export declare function paneIcon(name: PaneIcon): string;
+export {};

package/lib/types/client/compat/pane-tiles.d.ts

@@ -0,0 +1,37 @@
+/** Stateful two-column tiling. Closing a view keeps its neighbours in place;
+ * each column has its own row sizes, as in the Claude sidebar recording. */
+export interface PaneRect {
+    readonly x: number;
+    readonly y: number;
+    readonly width: number;
+    readonly height: number;
+}
+export interface PaneColumn {
+    readonly ids: readonly string[];
+    readonly sizes: readonly number[];
+}
+/** Session-owned membership and proportions, independent of DOM mount order. */
+export interface PaneLayout {
+    readonly columns: readonly PaneColumn[];
+    readonly column: number;
+}
+export interface PaneSeam {
+    readonly axis: 'row' | 'column';
+    readonly column: number;
+    readonly index: number;
+    readonly rect: PaneRect;
+}
+export interface PaneTiles {
+    readonly rects: ReadonlyMap<string, PaneRect>;
+    readonly seams: readonly PaneSeam[];
+}
+export declare const MIN_SHARE = 0.15;
+export declare const EMPTY_LAYOUT: PaneLayout;
+/** First two views stack; the third starts a second column. Further views split
+ * the roomiest cell in the less populated column. Existing cells stay put. */
+export declare function reconcilePanes(layout: PaneLayout, liveIds: readonly string[]): PaneLayout;
+/** Rectangles fill the card edge to edge, with gaps only between neighbours. */
+export declare function tilePanes(area: PaneRect, layout: PaneLayout, gap: number): PaneTiles;
+/** Resize just the pair beside this seam, keeping both usable. The caller
+ * supplies a minimum in viewport pixels converted to an axis fraction. */
+export declare function resizePanes(layout: PaneLayout, seam: PaneSeam, fraction: number, minimum?: number): PaneLayout;

package/lib/types/client/compat/relative-file-path.d.ts

@@ -0,0 +1,2 @@
+/** Display a host file relative to the session's working directory on either platform. */
+export declare function relativeFilePath(path: string, cwd: string): string;

package/lib/types/client/compat/right-panes.d.ts

@@ -0,0 +1,16 @@
+import type { Context } from '@deepseek-ai/cordis';
+import type { Disposer } from '../contracts/ports.ts';
+/** DockLayout can only render two horizontal dock panes. Its floating leaves
+ * have no such limit: retain those host-rendered bodies and controls, and give
+ * them session-owned column geometry. No React-owned node is reparented. */
+export declare const PANES_ATTRIBUTE = "data-ccd-panes";
+export declare const PANE_ATTRIBUTE = "data-ccd-pane";
+export declare const SEAM_ATTRIBUTE = "data-ccd-pane-seam";
+export declare const SEAM_AXIS_ATTRIBUTE = "data-ccd-pane-axis";
+export declare const SEAM_INDEX_ATTRIBUTE = "data-ccd-pane-seam-index";
+export declare const DRAGGING_ATTRIBUTE = "data-ccd-pane-dragging";
+export declare const PANE_LEFT_PROPERTY = "--ccd-pane-left";
+export declare const PANE_TOP_PROPERTY = "--ccd-pane-top";
+export declare const PANE_WIDTH_PROPERTY = "--ccd-pane-width";
+export declare const PANE_HEIGHT_PROPERTY = "--ccd-pane-height";
+export declare function mountRightPanes(ctx: Context, document: Document, report: (error: unknown) => void): Disposer;

package/lib/types/client/compat/scroll-pill.d.ts

@@ -0,0 +1,70 @@
+import type { Disposer } from '../contracts/ports.ts';
+/**
+ * The window's scrollbars: thin, dark, and there only while something moves
+ * (DESIGN.md §三).
+ *
+ * Two mechanisms, one look.
+ *
+ * **The ink.** Every scroller inside `theme/scrollbars.css`'s scope keeps the
+ * host's own track, thumb box and navigation, and this module publishes the
+ * moment one is moving as {@link SCROLLING_ATTRIBUTE}; the sheet keeps the ink
+ * switched off until it sees that attribute, so no surface in the window
+ * carries a bar at rest. A listener on the document's capture phase sees every
+ * element scroll in one place — scroll events do not bubble, but they do travel
+ * down — and clears the mark again once the surface has been still for
+ * {@link IDLE_MS}.
+ *
+ * **The pill.** The five page-level surfaces — the Conversation page, the
+ * transcript column, the sidebar's tree, the Files pane and the agent-team panel
+ * — go one step further and keep no ink at all: {@link PILL_SURFACE_ATTRIBUTE}
+ * takes their track's thumb out of the painting, and a floating pill
+ * ({@link PILL_ATTRIBUTE}, all of them in one fixed layer) follows the scroll
+ * position instead. That pill is the short capsule the reference draws. The
+ * painted thumb cannot be it: its length is the content's share of the track, so
+ * a surface that only just overflows — a short conversation, a panel with one
+ * page of content — paints a bar the height of its own viewport. The pill is
+ * capped at {@link PILL_MAX} instead, and never shorter than {@link PILL_MIN}.
+ *
+ * The pill is centred on the painted thumb it stands in for, and sits inside the
+ * track's own strip at the edge, so it is where the pointer expects: the host's
+ * thumb — invisible, but still laid out and still the thing that drags — is
+ * directly underneath it, and a drag that starts anywhere on the pill grabs
+ * that bar.
+ *
+ * Everything here is written on elements the host owns, so the disposer puts
+ * each mark back: attributes off, layer gone, listeners removed.
+ */
+/** Marks a surface whose bar is the floating pill rather than the track's ink. */
+export declare const PILL_SURFACE_ATTRIBUTE = "data-ccd-scroll-pill";
+/** Marks a surface in motion — and, on a pill, the pill that belongs to it. */
+export declare const SCROLLING_ATTRIBUTE = "data-ccd-scrolling";
+/** The one fixed layer every pill is painted in. */
+export declare const PILL_LAYER_ATTRIBUTE = "data-ccd-scroll-layer";
+/** Identifies one floating pill. */
+export declare const PILL_ATTRIBUTE = "data-ccd-scroll-thumb";
+/**
+ * How long a mark survives after the last scroll event. The reference's own
+ * overlay scroller fades out about this long after the wheel stops; long enough
+ * to read the position between two flicks, short enough that a resting window
+ * carries no ink.
+ */
+export declare const IDLE_MS = 800;
+/**
+ * The surfaces the pill replaces the ink on. All five are page-level chrome the
+ * reader scrolls by the screenful; the host's popup cards and this plugin's own
+ * panels keep the painted bar (it appears while they scroll, like every other
+ * surface in the sheet's scope), because they are short-lived and their tracks
+ * are narrower.
+ * @param document - renderer document carrying the interface.
+ * @returns the selectors, resolved for the build on screen.
+ */
+export declare function pillSurfaces(document: Document): readonly string[];
+/**
+ * Follow the interface's five page-level scrollers with a floating pill each,
+ * and mark every other scroller while it moves.
+ *
+ * @param document - renderer document carrying the interface.
+ * @param report - sink for observer failures; the host's own bars stay usable.
+ * @returns disposer that removes every pill, mark and listener.
+ */
+export declare function mountScrollPills(document: Document, report: (error: unknown) => void): Disposer;

package/lib/types/client/compat/view-switch.d.ts

@@ -6,9 +6,50 @@ export declare const VIEW_WIDTH_PROPERTY = "--ccd-view-w";
 /** Animate selection changes; layout corrections must be immediate. */
 export declare const VIEW_DURATION_PROPERTY = "--ccd-view-duration";
 /**
- * Measure the selected ui-conversation tab and publish slider geometry.
- * MutationObserver handles tablist replacement and layout changes synchronously,
- * including occluded windows where animation frames are throttled.
- * @returns disposer that clears the observer and published properties.
+ * Marker on the tablist while it is parked in the sidebar's window-control row.
+ * `conversation.css` draws the fixed-position state from it; its absence means
+ * the host's own row (the header, or whatever the platform still offers) keeps
+ * the switcher.
  */
-export declare function mountViewSwitch(document: Document, report: (error: unknown) => void): Disposer;
+export declare const VIEW_DOCK_ATTRIBUTE = "data-ccd-view-dock";
+/** Custom property carrying the parked tablist's inset from the window's right edge. */
+export declare const VIEW_DOCK_RIGHT_PROPERTY = "--ccd-view-dock-right";
+/** Marker on a tab whose label is drawn as artwork, naming the View it selects. */
+export declare const VIEW_TAB_ATTRIBUTE = "data-ccd-view";
+/** Marker on the artwork seat injected into a decorated tab. */
+export declare const VIEW_GLYPH_ATTRIBUTE = "data-ccd-view-glyph";
+/**
+ * The parked pill's inset from the sidebar column's right edge, in px. Measured
+ * at @2x on the reference: the column's divider sits 16 device px right of the
+ * pill's right edge (docs/issues/img/todo-sidebar-sessions-target.webp).
+ */
+export declare const VIEW_DOCK_INSET = 8;
+/** Bundled artwork, one per shipped View; see features/conversation/view-switch-icons.ts. */
+export interface ViewSwitchIcons {
+    readonly chat: string;
+    readonly trajectory: string;
+}
+/**
+ * Shape the host's View switcher, and park it where the reference has it.
+ *
+ * Three jobs, one observer:
+ * - Publish the selected segment's geometry for the sliding thumb
+ *   (`--ccd-view-x` / `-w` / `-duration`), measured against the tablist.
+ * - Replace each shipped tab's text label with bundled artwork (the host draws
+ *   the labels itself; a tab has no icon of its own), reversibly.
+ * - Park the tablist in the sidebar column's top-right corner — the reference
+ *   keeps the View switcher on the window-control row — by measuring the
+ *   column and publishing its inset (`data-ccd-view-dock` +
+ *   `--ccd-view-dock-right`). The node stays where React put it: only CSS moves
+ *   it, exactly as the macOS sidebar toggle is parked.
+ *
+ * The mutation observer covers tablist replacement, selection, frame drags
+ * (inline grid tracks) and the collapse flag, synchronously, including occluded
+ * windows where animation frames are throttled. A ResizeObserver on the sidebar
+ * column covers what no attribute says: the column's own width while the grid
+ * track animates between 0 and its settled value.
+ *
+ * @returns disposer that clears the observers, every injected node, every
+ *     written attribute and every published property.
+ */
+export declare function mountViewSwitch(document: Document, icons: ViewSwitchIcons, report: (error: unknown) => void): Disposer;