dsh-claude-desktop-theme 0.2.0

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

@@ -0,0 +1,52 @@
+import type { Disposer } from '../contracts/ports.ts';
+/** Marks the portalled account menu for the stylesheet. */
+export declare const ACCOUNT_MENU_ATTRIBUTE = "data-ccd-account-menu";
+/**
+ * Custom property carrying the signed-in name shown as the menu header.
+ *
+ * The value is one *quoted* CSS string token (`accountNameToken`); the
+ * stylesheet paints it with `content: var(--ccd-account-name, "")`.
+ */
+export declare const ACCOUNT_NAME_PROPERTY = "--ccd-account-name";
+/**
+ * One account name as a complete CSS string token.
+ *
+ * The quotes are part of the value, not decoration: `content` has no production
+ * that takes a bare word, so after `var()` substitution the value is matched
+ * against the property's grammar, and a name that is not exactly one `<string>`
+ * leaves the declaration invalid at computed-value time. `content` is not
+ * inherited, so that behaves as `unset` — the initial `normal`, which computes
+ * to `none` on `::before`. The pseudo-element is then never generated, and the
+ * header disappears whole, its padding with it. CSS's own custom-property
+ * examples keep the quotes for the same reason (`--external-link: "external
+ * link"` feeding `content: " (" var(--external-link) ")"`).
+ *
+ * Inside the quotes a name travels as written, except for the three things CSS
+ * string syntax cannot carry raw: the quote and the backslash take a preceding
+ * backslash, and a control character takes a hex escape padded to six digits
+ * followed by one space (`\00000a `) — the form CSS serializes strings in. That
+ * space terminates the escape while the value is tokenized, so it is consumed
+ * rather than painted, and the six digits leave no room for a hex digit of the
+ * following character to be swallowed by the escape.
+ *
+ * @param name - the signed-in name as read from the trigger.
+ * @returns the name as one quoted CSS string token for the custom property.
+ */
+export declare function accountNameToken(name: string): string;
+/**
+ * The reference draws the signed-in account menu as a card whose first block is
+ * 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.
+ *
+ * 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
+ * needed here.
+ *
+ * @param document - renderer document carrying the sidebar and the portal.
+ * @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;

package/lib/types/client/compat/adapter.d.ts

@@ -0,0 +1,17 @@
+import type { Context } from '@deepseek-ai/cordis';
+import type { HostServices, ThemePreferencePort } from '../contracts/ports.ts';
+/**
+ * Build the theme service's preference face.
+ *
+ * `getTheme`／`setTheme` are the service's only read and write entries and
+ * `theme/change` is its only change signal (see `ThemeRuntime`), so the plugin's
+ * Appearance control is another surface for the native preference rather than a
+ * second switch of its own. A build that does not publish them yields null and
+ * the page keeps its other rows; activation is not failed over an optional
+ * control.
+ * @param ctx - client context carrying the theme service and its event bus.
+ * @returns the port, or null when this build cannot read or write the preference.
+ */
+export declare function createThemePreferencePort(ctx: Context): ThemePreferencePort | null;
+/** This compatibility boundary targets the pinned SDK, not arbitrary DSH versions. */
+export declare function createHostServices(ctx: Context): HostServices;

package/lib/types/client/compat/blank-session-rows.d.ts

@@ -0,0 +1,74 @@
+import type { BlankSessionsPort, Disposer } from '../contracts/ports.ts';
+/**
+ * Hide provisional root sessions using SessionSummary.blank from
+ * dsh-api-session-controller and ui-workspace's data-row-key=session:<id>.
+ * Remove the display marker after the first message or scope release.
+ * Fork children retain their rows while their summaries are settling.
+ *
+ * The hide has to be in force before the host measures the list, not merely
+ * before it paints. `ui-workspace`'s AnimatedRows reads every keyed row's
+ * rectangle inside the commit that mounts it — `getSnapshotBeforeUpdate` then
+ * `componentDidUpdate`, both before any microtask — and glides the rows below
+ * from their previous position. A marker written by a MutationObserver lands
+ * one microtask too late: the row is measured as a real box, and the height it
+ * then drops out of the flow becomes a jump the host's 200ms glide plays back
+ * (issue 04). The ids are therefore written twice: as a rule in the plugin's
+ * own adopted sheet, keyed by `data-row-key`, which is the one value the
+ * element carries from the moment React creates it and which is known one
+ * store notification earlier, before the row is committed at all; and as the
+ * marker attribute below, which is the same fact recorded on an element that
+ * already exists and the fallback wherever a document cannot carry the sheet.
+ */
+/** Marks one host row the stylesheet keeps out of the column. */
+export declare const BLANK_ROW_ATTRIBUTE = "data-ccd-blank-session";
+/** The slice of one host list row this filter reads. */
+export interface SessionRowFacts {
+    /** Host presentation fact: created and not yet given durable history. */
+    readonly blank?: boolean;
+    /** Direct parent, present on fork and subagent children. */
+    readonly parentId?: string;
+}
+/** The slice of the host session list this filter reads (`SessionListState`). */
+export interface SessionListFacts {
+    readonly ids: readonly string[];
+    readonly byId: Readonly<Record<string, SessionRowFacts | undefined>>;
+}
+/**
+ * Ids whose provisional row must stay out of the column.
+ *
+ * A row qualifies when the host still calls it blank and it is a root Session:
+ * a blank child is a fork that has not received its authoritative summary yet,
+ * not a New Session placeholder.
+ *
+ * @param state - host session-list snapshot.
+ * @returns the ids to hide, in no particular order.
+ */
+export declare function blankSessionIds(state: SessionListFacts): ReadonlySet<string>;
+/**
+ * Session id carried by one `data-row-key`, or null for any other row.
+ *
+ * @param key - the attribute value, as read from the DOM.
+ * @returns the id, or null when the row is not a Session row.
+ */
+export declare function rowSessionId(key: string | null | undefined): string | null;
+/**
+ * Keep the host's provisional New Session rows out of the sidebar column.
+ *
+ * Reconciliation runs synchronously (never on an animation frame, which a
+ * hidden or occluded window throttles) and is driven by two signals: the host
+ * session list, which is what makes a row stop being provisional, and the
+ * document's own childList changes, which is how a row arrives at all. A
+ * mutation outside the Workspace browser is ignored before any query runs, so
+ * a streaming Conversation never pays for this observer.
+ *
+ * Both signals write the same fact to two places: the sheet, which reaches the
+ * list before the row lays out, and the marker attribute on the row, which is
+ * what a stylesheet can hide and what the release path clears.
+ *
+ * @param document - renderer document carrying the sidebar.
+ * @param source - provisional-id source built over the host session list.
+ * @param report - sink for source failures; the native rows stay untouched.
+ * @returns disposer that stops both signals, removes the sheet, and clears
+ *   every tag it wrote.
+ */
+export declare function mountBlankSessionRows(document: Document, source: BlankSessionsPort, report: (error: unknown) => void): Disposer;

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

@@ -0,0 +1,11 @@
+import type { Disposer } from '../contracts/ports.ts';
+/** Marks a menu this module has already placed above its anchor. */
+export declare const FLIPPED_MENU_ATTRIBUTE = "data-ccd-menu-flipped";
+/**
+ * Place bottom-edge Composer and hero-chip menus above their anchors, using
+ * the Menu primitive's side=top geometry. Cap only cards taller than the free
+ * space above the anchor so later content growth keeps its natural height.
+ * MutationObserver and resize reapply placement when the host updates it.
+ * @returns disposer that restores each menu and releases the observers.
+ */
+export declare function mountComposerMenuPlacement(document: Document, report: (error: unknown) => void): Disposer;

package/lib/types/client/compat/composer-placeholder.d.ts

@@ -0,0 +1,3 @@
+import type { Disposer } from '../contracts/ports.ts';
+/** Unify the default hero hint with chat, preserving the official editor. */
+export declare function mountComposerPlaceholder(document: Document, report: (error: unknown) => void): Disposer;

package/lib/types/client/compat/composer-status-order.d.ts

@@ -0,0 +1,56 @@
+import type { Disposer } from '../contracts/ports.ts';
+/**
+ * The Composer status bar's seat order, and the context ring's accessible name.
+ *
+ * Host facts (DSH `0.2.0-rc.2`, read from the installed `app.asar`):
+ *
+ * - The status bar is `ui-conversation`'s `InputBar` control row
+ *   (`.yhfFVG_row`). Its flex children are the leading `.yhfFVG_tools` group —
+ *   command button, then `.yhfFVG_modes` holding the `conversation.input.permission`
+ *   and `conversation.input.plan` seats — and the trailing `.yhfFVG_trailing`
+ *   group — the model seat, then the `conversation.input.activity` seat, then the
+ *   absolutely positioned send/stop buttons.
+ * - `@deepseek-ai/dsh-experimental-client-ui-voice-input` registers its control
+ *   into `conversation.input.activity`. The renderer seats every slot entry in a
+ *   `display: contents` outlet (`div[data-slot="…"]`, see
+ *   `dsh-client-ui-renderer`'s `SlotOutlet`), so the seat the slot occupies is
+ *   that outlet's parent element.
+ * - `ContextMeter` (`ui-conversation`'s skeleton) renders the ring's trigger
+ *   with an accessible name carrying the reading, and returns nothing at all
+ *   until the token meter knows both a numerator and the context window.
+ *
+ * The voice control therefore sits one flex container away from the permission
+ * control it is asked to follow, and `order` cannot cross containers: the seat
+ * itself has to move. It is moved into `.yhfFVG_modes`, immediately after the
+ * permission seat and before the plan seat, and marked with
+ * {@link VOICE_SEAT_ATTRIBUTE} so the stylesheet and the release path can find
+ * it.
+ *
+ * Moving a node React owns is only safe while React never removes that node from
+ * the parent it was moved out of. It does not: `InputBar` renders the seat under
+ * two guards, `input === void 0` and `sessionId === void 0` — `input` is the
+ * shell's own store snapshot, which exists as soon as the shell does — and the
+ * `conversation.composer.bar` entry that owns the whole Composer is a
+ * `session-maybe` slot, whose documented contract is that such an entry adopts
+ * its first session in place and remounts, as one deleted subtree, on every later
+ * identity change. Within one instance the seat is therefore only ever inserted,
+ * never removed. Moving the *ring* instead is not available at all: `InputBar`
+ * unmounts the ring whenever the voice control expands, and React would then call
+ * `removeChild` on a parent the node no longer belongs to.
+ *
+ * The seat goes back to its recorded host position — and the mark comes off —
+ * whenever the host switches the row to the voice control's capture layout
+ * (`InputBar` hides `.yhfFVG_tools` and lets `.yhfFVG_trailing` span the row), so
+ * that layout keeps the host's own geometry, and again on release.
+ */
+/** Mark on a relocated voice seat; the composer sheet reads it. */
+export declare const VOICE_SEAT_ATTRIBUTE = "data-ccd-voice-seat";
+/**
+ * Keep the voice control beside the permission control, and the context ring's
+ * accessible name free of the percentage it no longer shows.
+ *
+ * @param document - renderer document carrying the Composer.
+ * @param report - sink for observer failures; the host's own order stays.
+ * @returns disposer that restores every seat and label it touched.
+ */
+export declare function mountComposerStatusOrder(document: Document, report: (error: unknown) => void): Disposer;

package/lib/types/client/compat/conversation-fade.d.ts

@@ -0,0 +1,37 @@
+import type { Disposer } from '../contracts/ports.ts';
+/** Marks that the transcript still has content above the scroll viewport. */
+export declare const FADE_TOP_ATTRIBUTE = "data-ccd-fade-top";
+/** Marks that the transcript still has content below the scroll viewport. */
+export declare const FADE_BOTTOM_ATTRIBUTE = "data-ccd-fade-bottom";
+/**
+ * Custom property carrying how much of the scroll viewport the resident
+ * Composer covers. The bottom fade has to end at the Composer's own top edge:
+ * the scroller runs to the bottom of the window, so a stencil pinned to its
+ * bottom edge would sit behind the Composer and fade nothing.
+ */
+export declare const FADE_BOTTOM_INSET_PROPERTY = "--ccd-fade-bottom-inset";
+export interface EdgeFadeState {
+    readonly top: boolean;
+    readonly bottom: boolean;
+}
+/**
+ * Determine whether content extends past each edge of the scroll viewport.
+ * The mount publishes those flags and the sticky Composer's top inset for
+ * the page's gradient overlays; the Composer is a child of the scroll viewport.
+ */
+export declare function edgeFadeState(scrollTop: number, scrollHeight: number, clientHeight: number): EdgeFadeState;
+/**
+ * Keeps the transcript's edge-fade attributes in step with its scroll state.
+ *
+ * The scroller is a session-scoped element, so the module re-resolves it from
+ * the document and moves its own listener across element swaps. Content growth
+ * (streaming), column drags and window resizes all change the answer, so the
+ * observer watches the same three signals the host's own view does — DOM
+ * mutations, inline framework geometry and the window — rather than animation
+ * frames, which an occluded window throttles.
+ *
+ * @param document - renderer document carrying the Conversation page.
+ * @param report - sink for observer failures; the transcript stays usable.
+ * @returns disposer that disconnects every observer and clears both attributes.
+ */
+export declare function mountConversationFade(document: Document, report: (error: unknown) => void): Disposer;

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

@@ -0,0 +1,2 @@
+import type { DomPort } from '../contracts/ports.ts';
+export declare function createDomPort(document: Document): DomPort;

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

@@ -0,0 +1,24 @@
+/**
+ * Copy for the controls this plugin adds to DSH's own header cluster.
+ *
+ * DSH localises its own strings through `ctx.locale`; a third-party plugin may
+ * not borrow another package's namespace, so these two labels follow the
+ * document language instead. The glyphs and the actions stay native either way.
+ */
+export interface HeaderLabels {
+    /** Names the stretched hit area that opens the application menu. */
+    readonly open: string;
+    /** Names the right panel's terminal view. */
+    readonly terminal: string;
+    /** Names the right panel's browser view. */
+    readonly browser: string;
+    /** Names the corner control that shows the session's project directory. */
+    readonly files: string;
+    /** Names the Session menu's row that reveals a collapsed right panel. */
+    readonly expand: string;
+}
+/**
+ * @param document - renderer document whose language DSH sets from the locale.
+ * @returns Chinese copy for a Chinese document, English otherwise.
+ */
+export declare function headerLabels(document: Document): HeaderLabels;

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

@@ -0,0 +1,101 @@
+/**
+ * CSS-module prefix tables for the shipped DSH builds.
+ *
+ * DSH hashes CSS-module class names per build, and the installers are separate
+ * builds even at one version: `0.2.0-rc.2` ships commit `5e9e301d` for macOS and
+ * `04f392c9` for Windows, and every class of the pinned UI packages hashes
+ * differently between them. This plugin's stylesheets and `HOST` selectors are
+ * authored against the macOS build; a build listed below is rewritten through
+ * {@link aliasHostClasses} before it reaches the document, so one source styles
+ * both installers instead of duplicating every selector.
+ *
+ * Only the prefix differs. The local name after it (`_frame`, `_newSession`)
+ * and the static web frontend's markdown classes (`_markdown_1ypvv_5`) are
+ * identical in both builds, so neither needs an entry here.
+ *
+ * The tables are pinned to the DSH version the plugin declares
+ * (`dsh.engines.dsh = "=0.2.0-rc.2"`): a later release may rehash every prefix
+ * again, and both tables then have to be refreshed from that build's
+ * `app.asar` — the same single-place update `host-dom.ts` documents.
+ */
+/** One shipped DSH build and the prefixes it uses for the pinned classes. */
+export interface HostBuild {
+    /** Stable identity of the build, used for diagnostics and memoized tables. */
+    readonly id: string;
+    /** The layout frame's own class name, which identifies the build in a document. */
+    readonly frameClass: string;
+    /** Authored prefix → this build's prefix; empty for the authored build. */
+    readonly prefixes: Readonly<Record<string, string>>;
+}
+/**
+ * The build the stylesheets are authored against: DSH `0.2.0-rc.2`, macOS
+ * commit `5e9e301d`. An empty table is the identity rewrite.
+ */
+export declare const PINNED_BUILD: HostBuild;
+/**
+ * DSH `0.2.0-rc.2`, Windows commit `04f392c9`. Read from that build's
+ * `app.asar`: each entry is the same CSS module's class-name map, keyed by the
+ * prefix this plugin authored.
+ */
+export declare const WINDOWS_BUILD: HostBuild;
+/** Every build whose class names this plugin knows how to speak. */
+export declare const HOST_BUILDS: readonly HostBuild[];
+/** How a document's build was decided. */
+export type HostBuildState = 
+/** The frame named a registered build. */
+'identified'
+/** The shell has not rendered its frame yet; the preload's platform decided. */
+ | 'pending'
+/** A frame exists and belongs to no registered build: the classes cannot match. */
+ | 'unknown';
+/** One document's build and how confidently it was recognised. */
+export interface HostBuildStatus {
+    readonly build: HostBuild;
+    readonly state: HostBuildState;
+}
+/**
+ * Identify the build behind one document, and say how it was identified.
+ *
+ * The frame's own class name is the evidence: it is present from the first
+ * paint of the shell and names the build exactly. Before the shell renders,
+ * the Electron preload's `data-platform` attribute decides — it is written
+ * before any page script runs — so a stylesheet mounted during client boot is
+ * already rewritten for the right build.
+ *
+ * `unknown` is the state worth reporting: the frame is on screen, its classes
+ * match no table here, and every host selector in this plugin will therefore
+ * miss until the tables are refreshed from that build.
+ *
+ * @param document - the renderer document to identify.
+ * @returns the matching build and whether the document itself confirmed it.
+ */
+export declare function hostBuildStatus(document: Document): HostBuildStatus;
+/**
+ * Identify the build behind one document.
+ * @param document - the renderer document to identify.
+ * @returns the matching build, or the authored one when nothing is recognised.
+ */
+export declare function detectHostBuild(document: Document): HostBuild;
+/**
+ * Report the build as soon as the shell's frame settles the question.
+ *
+ * The frame appears after this plugin's client boots, so a status read at mount
+ * time is still `pending`; this watches for the first frame and then stops,
+ * which is also the moment an unregistered build becomes visible.
+ *
+ * @param document - the renderer document to watch.
+ * @param settle - receives the first non-pending status, exactly once.
+ * @returns disposer that stops the watch.
+ */
+export declare function watchHostBuild(document: Document, settle: (status: HostBuildStatus) => void): () => void;
+/**
+ * Rewrite authored host prefixes in one stylesheet or selector.
+ *
+ * The authored build is returned untouched, and a build without a table for a
+ * prefix keeps it, so an unknown class degrades to "the selector does not
+ * match" instead of corrupting the rule.
+ * @param text - stylesheet text or a selector list using authored prefixes.
+ * @param build - build whose prefixes the text should carry.
+ * @returns the text as that build names its classes.
+ */
+export declare function aliasHostClasses(text: string, build: HostBuild): string;

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

@@ -0,0 +1,247 @@
+/**
+ * Version-pinned host DOM facts.
+ *
+ * Every selector here was read from the running DSH `0.2.0-rc.2` renderer and
+ * cross-checked against the shipped CSS-module class names of the pinned UI
+ * packages. DSH hashes CSS-module class names per build, so these are the one
+ * place that may need updating for another DSH release; nothing outside this
+ * module may hard-code a host class name.
+ *
+ * The names below are the macOS build's. `host-builds.ts` holds the same
+ * classes as the Windows build spells them, and `hostSelectors` /
+ * `hostAnchors` resolve this table for the document actually on screen, so
+ * callers never branch on the platform themselves.
+ *
+ * Sources (app.asar, `0.2.0-rc.2`):
+ * - `packages/client/ui-layout/src/client/AppFrame.module.css` (`_6Qf49G_`)
+ * - `packages/client/ui-sidebar/src/client/SidebarRoot.module.css` (`_3WPZCG_`)
+ * - `packages/client/ui-conversation/src/client/ConversationRoot.module.css` (`ST7X_W_`)
+ * - `packages/client/ui-conversation/src/client/InputBar.module.css` (`yhfFVG_`)
+ * - `packages/client/ui-model-selection/src/client/ModelSelect.module.css` (`cl2Rlq_`)
+ * - `packages/client/ui-permission-presets/src/client/PermissionSelect.module.css` (`wXeviG_`)
+ * - `packages/experimental/client-ui-agent-team/src/client/TeamAction.module.css` (`_2tNPVa_`)
+ * - `packages/client/ui-agent-preset/src/client/AgentPresetLabel.module.css` (`_3li69W_`)
+ * - `packages/client/ui-open-in-app/src/client/OpenTargetButton.module.css` (`iq4beG_`)
+ * - `packages/session-query/session-log-export/src/client/HeaderAction.module.css` (`Da3aKq_`)
+ * - `packages/client/ui-conversation/src/client/ConversationHero.module.css` (`bocITq_`)
+ * - `packages/client/ui-conversation/src/client/skeleton/ContextMeter.module.css` (`y0jqnG_`)
+ * - `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-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_`)
+ * - `packages/client/ui-settings-account/src/client/AccountMenu.module.css` (`ZogL4G_`)
+ * - `packages/client/ui-primitives/lib/Menu.module.css` (`_4ub78_`, `_ri079_`)
+ * - `packages/client/ui-primitives/lib/Menu.js` (`MenuItemButton`: the icon seat
+ *   `account-menu.css` scales; its `[role="menuitem"] > span` structure)
+ * - `packages/client/ui-chat/src/client/chat/AssistantMarkdown.module.css` (`gKv1-q_`)
+ * - `packages/client/ui-chat/src/client/chat/ChatView.module.css` (`icaHSq_`: the
+ *   transcript scroll area and the floating jump-to-bottom control it renders
+ *   below the transcript while the reader is off the tail)
+ * - `packages/client/ui-primitives/lib/markdown/MarkdownText.module.css`
+ *   (static web-frontend bundle: `_1ypvv_`; shared by Web and Desktop)
+ */
+export declare const HOST: Readonly<{
+    readonly frame: '._6Qf49G_frame';
+    readonly sidebarColumn: '._6Qf49G_sidebarCol';
+    readonly centerColumn: '._6Qf49G_centerCol';
+    readonly rightbarColumn: '._6Qf49G_rightbarCol';
+    readonly resizeHandle: '._6Qf49G_handle';
+    readonly sidebarRoot: '._3WPZCG_root';
+    readonly sidebarLogoRow: '._3WPZCG_logoRow';
+    readonly sidebarBrand: '._3WPZCG_brand';
+    readonly sidebarBrandName: '._3WPZCG_brandName';
+    readonly sidebarTopStrip: '._3WPZCG_topStrip';
+    /** SidebarRoot.module.css: expanded macOS window-chrome toggle. */
+    readonly sidebarToggle: '._3WPZCG_toggle';
+    readonly sidebarNewSession: '._3WPZCG_newSession';
+    readonly sidebarNewSessionLabel: '._3WPZCG_newSessionLabel';
+    readonly sidebarNewSessionShortcut: '._3WPZCG_newSessionShortcut';
+    readonly sidebarPanelList: '._3WPZCG_panelList';
+    readonly sidebarPanelRow: '._3WPZCG_panelRow';
+    readonly sidebarPanelTitle: '._3WPZCG_panelTitle';
+    readonly sidebarPanelGlyph: '._3WPZCG_panelGlyph';
+    readonly sidebarRegionArea: '._3WPZCG_regionArea';
+    readonly sidebarFootArea: '._3WPZCG_footArea';
+    readonly sidebarSettingsArea: '._3WPZCG_settingsArea';
+    readonly sidebarIconButton: '._3WPZCG_iconButton';
+    readonly browserRoot: '._7514NG_root';
+    readonly browserSectionHeader: '._7514NG_sectionHeader';
+    readonly browserSectionLabel: '._7514NG_sectionLabel';
+    readonly browserListArea: '._7514NG_listArea';
+    readonly settingsTrigger: '.Dws9Sa_trigger';
+    readonly settingsTriggerRow: '.Dws9Sa_triggerRow';
+    readonly accountTrigger: '.ZogL4G_trigger';
+    readonly accountLabel: '.ZogL4G_label';
+    readonly conversationRoot: '.ST7X_W_root';
+    readonly conversationHeader: '.ST7X_W_header';
+    readonly conversationCrumb: '.ST7X_W_crumb';
+    /** ConversationRoot.tsx: the header's trailing corner seat. */
+    readonly headerCorner: '[data-conversation-header-corner]';
+    /** OpenTargetButton.module.css: the anchor the native application menu hangs from. */
+    readonly openTargetAnchor: '.iq4beG_menuAnchor';
+    /** OpenTargetButton.module.css: the bordered split box that becomes one hit box here. */
+    readonly openTargetSplit: '.iq4beG_split';
+    /** OpenTargetButton.module.css: leading icon half of the native split button. */
+    readonly openTargetMain: '.iq4beG_main';
+    /** OpenTargetButton.module.css: the only control that opens the application menu. */
+    readonly openTargetChevron: '.iq4beG_chevron';
+    /** OpenTargetButton.module.css: the chosen application's own image. */
+    readonly openTargetAppIcon: '.iq4beG_appIcon';
+    /** session-log-export/HeaderAction.module.css: native session action menu. */
+    readonly sessionMoreButton: '.Da3aKq_moreButton';
+    /**
+     * sidebar-right/ExpandButton.tsx: the collapsed rightbar's only re-entry
+     * control. This plugin no longer styles it: the corner entry shadows it in
+     * that single cell (`features/conversation/header-actions/entries.ts`,
+     * `OVERRIDE_PRIORITY`) and the expand action moves into the Session menu, so
+     * the marker is the pinned record of the control that was displaced — the
+     * thing to re-check against a later build.
+     */
+    readonly sidebarRightExpand: '[data-sidebar-right-expand]';
+    readonly conversationBody: '.ST7X_W_body';
+    readonly assistantMarkdown: '.gKv1-q_root';
+    readonly markdownBody: '._markdown_1ypvv_5:not([data-markdown-variant="compact"])';
+    readonly markdownFileMention: '._fileMention_1ypvv_85';
+    readonly conversationScroll: '.ST7X_W_scrollBody';
+    /** ChatView.module.css: the transcript's own scroll column, inside the page's
+        scroll viewport, and the two shells of the floating jump-to-bottom control
+        that ChatView renders off the tail. `conversation.css` places and sizes
+        that control; no TypeScript reads it. */
+    readonly chatViewScroll: '.icaHSq_scroll';
+    readonly chatViewColumn: '.icaHSq_column';
+    readonly chatViewToBottomSlot: '.icaHSq_toBottomSlot';
+    readonly chatViewToBottom: '.icaHSq_toBottom';
+    /**
+     * ConversationRoot.module.css + skeleton/ConversationWidthControls.tsx: the
+     * two transcript-width drag handles, one per side, rendered as the
+     * Conversation body's last child (`data-width-handle="left" | "right"` is the
+     * host's own stable hook on them; the class is hashed). `conversation.css`
+     * hides them: dragging one publishes `--dsh-chat-user-width` on the
+     * Conversation root, and `theme/composer.css` replaces the body rule that is
+     * that property's only consumer, so in this interface the handles carry a
+     * cursor and a hover rule and move nothing. This entry is the pinned record of
+     * what is hidden, and the selector a later build can be re-checked against.
+     */
+    readonly conversationWidthHandle: '.ST7X_W_root [data-width-handle]';
+    readonly conversationTabs: '.ST7X_W_tabs';
+    readonly conversationTab: '.ST7X_W_tab';
+    readonly conversationTabActive: '.ST7X_W_tabActive';
+    readonly composerSeat: '.ST7X_W_composerSeat';
+    readonly composerStack: '.ST7X_W_composerStack';
+    readonly composerRoot: '.yhfFVG_root';
+    readonly composerCard: '[data-composer-card]';
+    readonly composerCardClass: '.yhfFVG_card';
+    /** InputBar.module.css: workspace-less card's dashed ::after picker outline. */
+    readonly composerCardWorkspaceTrigger: '.yhfFVG_cardWorkspaceTrigger';
+    readonly composerScroll: '.yhfFVG_scroll';
+    readonly composerInput: '.yhfFVG_input';
+    /** InputBar.module.css: overlay hint, distinct from the editable text. */
+    readonly composerPlaceholder: '.yhfFVG_placeholder';
+    readonly composerAdd: '.yhfFVG_add';
+    readonly composerPrimary: '.yhfFVG_primary';
+    readonly composerRow: '.yhfFVG_row';
+    readonly composerTools: '.yhfFVG_tools';
+    readonly composerDock: '.yhfFVG_dock';
+    readonly composerTrailing: '.yhfFVG_trailing';
+    /** The draft-image rail the `ui-attachment` plugin renders into the card,
+        above the input panel (composer.css merges it into the input surface). */
+    readonly composerAttachmentRail: '.dVdiKa_rail';
+    /** ComposerAttachments.module.css: the draft image button clips its image. */
+    readonly composerAttachmentThumbnail: '.dVdiKa_thumbnail';
+    /** The Composer's model selector: one trigger carrying both texts. */
+    readonly modelSelectTrigger: '.cl2Rlq_trigger, [data-ccd-model-controls]';
+    readonly modelSelectLabel: '.cl2Rlq_triggerLabel';
+    readonly modelSelectEffort: '.cl2Rlq_triggerEffort';
+    /** PermissionSelect.module.css: compact permission text, keeping its button. */
+    readonly permissionSelectLabel: '.wXeviG_triggerLabel';
+    /** TeamAction.module.css: native team dialog entry, retaining its label at every width. */
+    readonly teamActionTrigger: '._2tNPVa_trigger';
+    readonly teamActionLabel: '._2tNPVa_triggerLabel';
+    /** 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. */
+    readonly presetModeIcon: '._3li69W_icon';
+    readonly statsAnchor: '.OpZ85W_anchor';
+    readonly statsRoot: '.OpZ85W_root';
+    readonly statsLabel: '.OpZ85W_label';
+    readonly statsSeparator: '.OpZ85W_sep';
+    readonly statsPill: '.OpZ85W_pill';
+    readonly contextMeterTrigger: '.y0jqnG_trigger';
+    readonly heroRoot: '.bocITq_root';
+    readonly heroHeadline: '.bocITq_headline';
+    readonly heroWorkspaceChip: '.bocITq_workspace';
+    readonly heroWorkspaceRow: '.ST7X_W_heroWorkspaceRow';
+    /** Hero-phase Composer column: the greeting block and the input stack are its
+        children, so the statistics card is appended here and positioned against
+        the greeting. */
+    readonly heroComposerStack: '.ST7X_W_composerStack';
+    /** Every menu surface the `Menu` primitive renders, portal or in place. */
+    readonly menu: '[role="menu"]';
+    readonly menuItem: '[role="menuitem"]';
+}>;
+/**
+ * Anchors that must exist before a feature may touch the host DOM. They are
+ * stable data attributes rather than hashed class names, so a failed probe
+ * means the frame is not the pinned one and the feature must stay off.
+ */
+export declare const ANCHOR: Readonly<{
+    readonly frame: '[data-slot="root"] > div';
+    readonly sidebar: '[data-slot="sidebar"]';
+    readonly workspaces: '[data-slot="sidebar.workspaces"]';
+    /**
+     * Every keyed row of the Workspace browser's tree, including the Session rows
+     * `blank-session-rows.ts` filters. `data-row-key` is the host's own identity
+     * for a row and survives its class hashes; the `empty` placeholder and the
+     * Workspace headers share the attribute with other prefixes.
+     */
+    readonly sessionRows: '[data-row-key^="session:"]';
+    readonly settings: '[data-slot="sidebar.settings"]';
+    readonly conversation: '[data-conversation-content]';
+    /**
+     * AppFrame.tsx: the frame element itself while the right panel's column has no
+     * width. The host writes `data-rightbar-collapsed` from `cols.rightbar === 0`,
+     * so it is the collapsed state's own statement — the header's expand control
+     * reads it rather than a measurement of our own.
+     */
+    readonly rightbarCollapsed: '[data-slot="root"] > div[data-rightbar-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. */
+    readonly conversationScroll: '[data-conversation-scroll]';
+    readonly composerSeat: '[data-composer-seat]';
+    readonly composerCard: '[data-composer-card]';
+    /**
+     * The blank-session Composer card. `ConversationRoot` (the pinned `.ST7X_W_root`
+     * class, `ConversationMainPanel`) writes `data-phase` on its root and `InputBar`
+     * renders the card inside it; the root class is what keeps this match off the
+     * editor's own `data-phase` input. `conversation.input.overlay` renders only
+     * with a Session, so this is the seat the no-session pet is measured from.
+     */
+    readonly composerCardHero: ".ST7X_W_root[data-phase=\"hero\"] [data-composer-card]";
+}>;
+/** One document's selector table, resolved for the build that document runs. */
+export type HostSelectors = Readonly<Record<keyof typeof HOST, string>>;
+/** One document's anchor table, resolved for the build that document runs. */
+export type HostAnchors = Readonly<Record<keyof typeof ANCHOR, string>>;
+/**
+ * The selectors this document's build actually answers to.
+ *
+ * `HOST` above is written against the authored build; a document running
+ * another build needs the same selectors in that build's class names. Read this
+ * once per mount and use the table, rather than mixing the two.
+ * @param document - the renderer document to speak to.
+ */
+export declare function hostSelectors(document: Document): HostSelectors;
+/** The anchors of this document's build; see {@link hostSelectors}. */
+export declare function hostAnchors(document: Document): HostAnchors;
+export interface HostProbe {
+    readonly frame: boolean;
+    readonly sidebar: boolean;
+    readonly workspaces: boolean;
+    readonly conversation: boolean;
+    readonly composer: boolean;
+}
+/** @param document - the renderer document to probe. */
+export declare function probeHost(document: Document): HostProbe;

package/lib/types/client/compat/open-target.d.ts

@@ -0,0 +1,9 @@
+import type { Disposer } from '../contracts/ports.ts';
+/**
+ * Annotate ui-open-in-app/OpenTargetButton for a full-box application-menu
+ * trigger. Its main half launches directly; the chevron opens the menu and
+ * exists only when applications are available. Publish menu availability and
+ * update accessible names to match the enlarged trigger.
+ * @returns disposer that restores attributes and markers.
+ */
+export declare function mountOpenTargetMode(document: Document, report: (error: unknown) => void): Disposer;