dsh-claude-desktop-theme 0.4.4 → 0.4.6

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

@@ -1,70 +1,10 @@
 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. */
+/** Native scrollbars reveal their ink while scrolling, then return to idle. */
 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.
+ * Keep the existing entry-point name for assembly compatibility. Geometry and
+ * dragging now belong entirely to native scrollbars; no overlay or per-surface
+ * observers are needed. Capture also reaches dynamically inserted scrollers.
  */
 export declare function mountScrollPills(document: Document, report: (error: unknown) => void): Disposer;

package/lib/types/client/compat/sidebar-search.d.ts

@@ -0,0 +1,18 @@
+import type { Disposer } from '../contracts/ports.ts';
+/** Marks the sidebar column whose field is currently parked above New Session. */
+export declare const SIDEBAR_SEARCH_PLACED_ATTRIBUTE = "data-ccd-sidebar-search-placed";
+/**
+ * Park the browsing region's search field above New Session.
+ *
+ * The field belongs to `ui-workspace`'s `WorkspaceBrowser`, and React removes
+ * it from the section header whenever the sidebar collapses to its rail.
+ * Moving the React-owned node would make that removal target the wrong parent,
+ * so the node stays where React put it and is positioned over the gap that New
+ * Session opens above itself. That gap sits after the brand row when the brand
+ * is visible and directly below the window strip when it is not.
+ *
+ * The section header keeps its own row. With the search slot out of flow, its
+ * label takes the leading edge and the native View options trigger stays on the
+ * trailing edge.
+ */
+export declare function mountSidebarSearch(document: Document, report: (error: unknown) => void): Disposer;

package/lib/types/client/compat/status-groups.d.ts

@@ -16,4 +16,4 @@ export declare function sessionGroup(status: SessionStatus | undefined, running:
  * uiSession.sessionStatus is the root observable provided by ui-session in the
  * pinned app.asar; it does not acquire or activate any listed Session.
  */
-export declare function mountStatusGroups(document: Document, ctx: Context, showEmpty: boolean, report: (error: unknown) => void): Disposer;
+export declare function mountStatusGroups(document: Document, ctx: Context, report: (error: unknown) => void): Disposer;

package/lib/types/client/compat/tool-call-details.d.ts

@@ -0,0 +1,10 @@
+import type { Disposer } from '../contracts/ports.ts';
+export interface CommandSegment {
+    readonly text: string;
+    readonly tone: 'command' | 'argument' | 'plain';
+}
+export declare function writeCommandClipboard(document: Document, text: string): Promise<void>;
+/** Presentation tokens only: preserve every character, including shell quotes. */
+export declare function commandSegments(command: string): CommandSegment[];
+/** Add a highlighted sibling; never rewrite React's command text or handlers. */
+export declare function mountToolCallDetails(document: Document, report: (error: unknown) => void, copyText?: (text: string) => Promise<void>): Disposer;

package/lib/types/client/compat/tool-call-groups.d.ts

@@ -0,0 +1,22 @@
+import type { Disposer } from '../contracts/ports.ts';
+import { type ToolFileSummary } from './tool-file-summary.ts';
+export type ToolGroupKind = 'read' | 'command' | 'tool' | 'reasoning';
+export interface ToolGroupEntry<T> {
+    readonly value: T;
+    readonly kind: ToolGroupKind | 'barrier';
+    readonly turn: string | null;
+    readonly settled: boolean;
+    readonly file?: ToolFileSummary | undefined;
+    readonly live?: boolean;
+    readonly description?: string;
+    readonly failed: boolean;
+}
+/** A visible reply, live activity, or turn boundary ends a run. */
+export declare function consecutiveToolGroups<T>(entries: readonly ToolGroupEntry<T>[], includeLive?: boolean): ToolGroupEntry<T>[][];
+export declare function toolGroupLabel(kinds: readonly ToolGroupKind[]): string;
+/**
+ * Inject only a sibling disclosure. Native calls keep their original React
+ * parents, identities, handlers and independent detail state. Adjacent borders
+ * paint the expanded list without wrapping or moving host nodes.
+ */
+export declare function mountToolCallGroups(document: Document, report: (error: unknown) => void): Disposer;

package/lib/types/client/compat/tool-call-labels.d.ts

@@ -0,0 +1,5 @@
+import type { Disposer } from '../contracts/ports.ts';
+/** Exact UI labels only: never translate model descriptions, paths or output. */
+export declare function englishToolLabel(text: string, running?: boolean): string | undefined;
+/** Keep React's title nodes intact and add English presentation siblings. */
+export declare function mountToolCallLabels(document: Document, report: (error: unknown) => void): Disposer;

package/lib/types/client/compat/tool-file-summary.d.ts

@@ -0,0 +1,13 @@
+/** Read only the native row header; expanded diffs and nested calls are not metadata. */
+export interface ToolFileSummary {
+    readonly action: 'write' | 'edit';
+    readonly name: string;
+    readonly added?: number | undefined;
+    readonly removed?: number | undefined;
+}
+export interface FileSummaryPart {
+    readonly text: string;
+    readonly tone: 'plain' | 'file' | 'added' | 'removed';
+}
+export declare function toolFileSummary(row: Element): ToolFileSummary | null;
+export declare function fileSummaryParts(files: readonly ToolFileSummary[], others: readonly string[]): FileSummaryPart[];

package/lib/types/client/compat/voice-waveform.d.ts

@@ -0,0 +1,12 @@
+import type { Disposer } from '../contracts/ports.ts';
+export interface VoiceWaveformHistory {
+    heights: number[];
+    sampledAt: number | null;
+}
+/** Sample each bar once, then translate the history continuously. A bar's
+ * height stays fixed for its entire trip from the right edge to the left. */
+export declare function advanceVoiceWaveform(history: VoiceWaveformHistory, now: number, level: number): number;
+/** Render reference geometry from the host's real audio samples. Keep its SVG
+ * mounted and untouched: its recording effect owns those original line nodes.
+ * The separate presentation SVG cannot enter the host's line-node snapshot. */
+export declare function mountVoiceWaveform(document: Document, report: (error: unknown) => void): Disposer;

package/lib/types/client/compat/workspace-branch.d.ts

@@ -0,0 +1,62 @@
+import { type GitBranchView, type GitCheckoutResult } from '../../shared/git.ts';
+import type { Disposer } from '../contracts/ports.ts';
+/** Marks the plugin's own groups in the picker card, which no host pass may count. */
+export declare const WORKSPACE_EXTRA_ATTRIBUTE = "data-ccd-workspace-extra";
+/** The plugin's branch card, nested in the host card so its pointer guard keeps both open. */
+export declare const BRANCH_MENU_ATTRIBUTE = "data-ccd-branch-menu";
+/** Search field shared by the picker card and the branch card. */
+export declare const MENU_SEARCH_ATTRIBUTE = "data-ccd-menu-search";
+/** A row the current query hides. */
+export declare const FILTERED_ATTRIBUTE = "data-ccd-filtered";
+/** Last listing per Workspace, so a reopened card shows its branch at once. */
+export type BranchCache = Map<string, GitBranchView>;
+interface Copy {
+    readonly branch: string;
+    readonly search: string;
+    readonly empty: string;
+    readonly loading: string;
+    /** The Host half predates this row: the route is registered only at Host start. */
+    readonly restart: string;
+    readonly detached: string;
+    readonly truncated: string;
+    readonly states: Readonly<Record<Exclude<GitBranchView['state'], 'ready'>, string>>;
+    readonly switching: (branch: string) => string;
+    readonly carried: (count: number) => string;
+    readonly busy: string;
+    readonly outcomes: Readonly<Record<Exclude<GitCheckoutResult['state'], 'switched'>, string>>;
+}
+/** Host-language copy, following the `<html lang>` the rest of the picker reads. */
+export declare function menuCopy(document: Document): {
+    readonly zh: boolean;
+    readonly copy: Copy;
+};
+/** One bare search line, as the model card draws it. */
+export declare function createMenuSearch(document: Document, placeholder: string): HTMLInputElement;
+/**
+ * The picker card's branch row and its side card.
+ *
+ * The row names the selected Workspace's current branch; the side card lists
+ * the repository's local branches with the current one checked, and choosing
+ * another one checks it out through the Host (`host/git.ts`). The picker only
+ * opens on the new-session page, so no conversation of this session is under
+ * way; another session of the same Workspace may be, and while one runs or waits
+ * for input the switch is refused, since it would change the files under that
+ * agent. There is no confirmation: git itself refuses a switch that would
+ * overwrite local changes, and changes it carries over are reported in one line
+ * at the foot of the card.
+ *
+ * Both are the plugin's own nodes: the row in a group after the host's pinned
+ * footer, the side card nested in the host card as a manual popover, so the
+ * primitive's outside-pointer guard (`card.contains(target)`) keeps the card open
+ * while the pointer is in the side card and the top layer lifts it out of the
+ * card's clipping.
+ *
+ * @param card - the open picker card (the portalled host `Menu`).
+ * @param workspaceId - selected Workspace; the Host resolves its directory.
+ * @param cache - listings retained across openings.
+ * @param busy - whether another session of this Workspace is running or waiting.
+ * @param report - sink for unexpected failures.
+ * @returns disposer that aborts the read and removes every node.
+ */
+export declare function mountWorkspaceBranch(card: HTMLElement, workspaceId: string, cache: BranchCache, busy: () => boolean, report: (error: unknown) => void): Disposer;
+export {};

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

@@ -1,4 +1,12 @@
 import type { Disposer } from '../contracts/ports.ts';
+import type { WorkspacePickerPort } from './workspace-picker-port.ts';
+/**
+ * The add row's label in the reference's words.
+ * @param text - one label run, as the host rendered it.
+ * @param zh - whether the interface is Chinese.
+ * @returns the rewritten run, or null when it carries no trailing ellipsis.
+ */
+export declare function openFolderLabel(text: string, zh: boolean): string | null;
 /**
  * Print the workspace picker's "add workspace" row with spaced dots.
  *
@@ -9,7 +17,8 @@ import type { Disposer } from '../contracts/ports.ts';
  * commit that mounts it and never shows the host's glyph first.
  *
  * @param document - renderer document carrying the hero chip and the portal.
+ * @param port - Workspace order and per-Workspace session activity.
  * @param report - sink for observer failures; the native label stays untouched.
  * @returns disposer that disconnects every observer and restores each label.
  */
-export declare function mountWorkspaceMenu(document: Document, report: (error: unknown) => void): Disposer;
+export declare function mountWorkspaceMenu(document: Document, port: WorkspacePickerPort, report: (error: unknown) => void): Disposer;

package/lib/types/client/compat/workspace-picker-port.d.ts

@@ -0,0 +1,9 @@
+import type { Context } from '@deepseek-ai/cordis';
+/** What the workspace picker reads from the host's authoritative snapshots. */
+export interface WorkspacePickerPort {
+    /** Workspace ids in the order the picker renders its rows. */
+    workspaceIds(): readonly string[];
+    /** Whether any session of the Workspace is running or waiting for input. */
+    busy(workspaceId: string): boolean;
+}
+export declare function workspacePickerPort(ctx: Context): WorkspacePickerPort;

package/lib/types/client/contracts/ports.d.ts

@@ -79,6 +79,7 @@ export interface SidebarRightPort {
     /** Open one page kind for the on-screen Session; an unregistered kind throws. */
     openTab(kind: string, options?: {
         readonly params?: Record<string, string>;
+        readonly revealIfOpened?: boolean;
     }): void;
     /** Focus a tab and the pane holding it; a missing tab is left alone. */
     focus(tabId: string): void;

package/lib/types/client/features/composer-pet/BlankPet.d.ts

@@ -1,7 +1,10 @@
 import type { PropsRuntime } from '@deepseek-ai/dsh-client-ui-slots';
+import type { PersonalizationConfig } from '../../../shared/config.ts';
 import type { PetAnchor } from '../../compat/pet-anchor.ts';
 /** Business face the frame overlay injects: the measured new-session corner. */
 export interface BlankPetFace {
+    /** Visual variant chosen in settings. */
+    readonly petStyle: PersonalizationConfig['petStyle'];
     /** Selector hook over the compat layer's measurement. */
     readonly useAnchor: () => PetAnchor | null;
 }
@@ -14,4 +17,4 @@ export type BlankPetProps = PropsRuntime<'shell.overlay'> & BlankPetFace;
  * @param props - injected measurement.
  * @returns the positioned whale, or null.
  */
-export declare function BlankPet({ useAnchor }: BlankPetProps): import("react/jsx-runtime").JSX.Element | null;
+export declare function BlankPet({ useAnchor, petStyle }: BlankPetProps): import("react/jsx-runtime").JSX.Element | null;

package/lib/types/client/features/composer-pet/ClaudePet.d.ts

@@ -0,0 +1,7 @@
+/** On appearing or clicking, take out a laptop, type, then return to standing. */
+export declare function ClaudePet(): import("react/jsx-runtime").JSX.Element;
+/** One shared drawing path for idle and recorded poses, also used by previews. */
+export declare function ClaudeArt({ elapsed, reducedMotion }: {
+    readonly elapsed?: number | null;
+    readonly reducedMotion?: boolean;
+}): import("react/jsx-runtime").JSX.Element;

package/lib/types/client/features/composer-pet/ComposerPet.d.ts

@@ -1,5 +1,5 @@
 /**
- * The hero-page whale. Accepted clicks choose one of three local reactions;
+ * The hero-page whale. Appearing or clicking chooses one of three local reactions;
  * busy clicks do nothing, and hiding or unmounting cancels all active frames.
  * It reads no session state and does not trigger any Composer action.
  * @returns the whale mark.

package/lib/types/client/features/composer-pet/claude-frames.d.ts

@@ -0,0 +1,12 @@
+/** Geometric reconstruction of the original click sequence, sampled at 20fps.
+ * Recording antialiasing/compression fringes are not artwork: there is no outline
+ * layer. All feet have a constant 3px width; their roots follow the belly while
+ * their toes share a ground line. Only the projected feet have a deliberate bend.
+ */
+export type ClaudeFrame = readonly [body: string, shade: string, eyes: string, laptop: string];
+export declare const CLAUDE_GROUND_Y = 23.5;
+export declare const CLAUDE_IDLE: ClaudeFrame;
+/** Pose order and hold times follow the recording; identical clean silhouettes
+ * are reused so compression noise cannot animate otherwise stationary edges. */
+export declare const CLAUDE_FRAMES: readonly ClaudeFrame[];
+export declare const CLAUDE_TRACK: readonly number[];

package/lib/types/client/features/composer-pet/claude-motion.d.ts

@@ -0,0 +1,3 @@
+export declare const CLAUDE_REACTION_MS: number;
+/** Each recorded pose lasts 50ms; null restores the static mark after playback. */
+export declare function claudePose(elapsed: number, reducedMotion?: boolean): readonly string[] | null;

package/lib/types/client/features/conversation/header-actions/BlankHeaderActions.d.ts

@@ -0,0 +1,10 @@
+import type { VIEWS } from './entries.ts';
+type View = (typeof VIEWS)[number];
+export interface BlankHeaderActionsProps {
+    readonly labels: Record<View['kind'], string>;
+    readonly useAvailableViews: () => readonly View[];
+    readonly open: (kind: View['kind']) => void;
+}
+/** The blank header keeps its corner seat even while it omits Session utilities. */
+export declare function BlankHeaderActions({ labels, useAvailableViews, open }: BlankHeaderActionsProps): import("react/jsx-runtime").JSX.Element | null;
+export {};

package/lib/types/client/features/conversation/header-actions/HeaderActionButton.d.ts

@@ -12,8 +12,9 @@ export interface HeaderActionProps {
  * One view button for the conversation header.
  *
  * All three sit in the utilities group beside the native actions, in terminal,
- * browser, project folder order; the corner seat past them holds nothing (the panel's shipped
- * expand control is retired there and its action moves into the Session menu).
+ * browser, project folder order. Blank Sessions use the corner seat instead,
+ * because the host omits their utilities group. The panel's shipped expand
+ * control is retired and its action moves into the Session menu.
  * All three are the same control: the box size, hover surface and spacing
  * belong to the seat's own stylesheet
  * (`features/conversation/conversation.css`) so every control in the row shares

package/lib/types/client/features/conversation/header-actions/entries.d.ts

@@ -64,16 +64,15 @@ export declare function utilitiesEntry(view: (typeof VIEWS)[number], labels: Rec
     inject: (sessionId: string) => HeaderActionProps;
 };
 /**
- * The corner seat's retirement: the cell the reference leaves empty.
+ * Retire the corner seat's shipped expand control.
  *
  * That seat's shipped occupant is `ui-sidebar-right`'s collapsed-panel expand
  * control, and this interface does not want it: hovering it drew a control the
  * reference has no room for, and the action it carries lives in the Session menu
  * instead ({@link sidebarExpandRow}). Registering below the occupant's rank
- * ({@link OVERRIDE_PRIORITY}) takes the cell, and the entry's component renders
- * nothing — a structural retirement rather than a control hidden in place, so
- * nothing of the displaced button stays behind: no hover surface, no tooltip and
- * no hit area.
+ * ({@link OVERRIDE_PRIORITY}) takes the cell. The replacement holds the three
+ * view buttons on blank Sessions, where the host omits utilities; on active
+ * Sessions the corner is hidden and utilities hold those same actions.
  *
  * @returns the options the registry is called with.
  */

package/lib/types/client/features/conversation/header-actions/mount.d.ts

@@ -2,8 +2,7 @@ import type { Context } from '@deepseek-ai/cordis';
 import type { FeatureEnvironment } from '../../../contracts/feature.ts';
 import type { CleanupScope } from '../../../core/cleanup.ts';
 /**
- * Add the right panel's views to the conversation header — the project folder
- * first, then terminal and browser, all in the utilities group — and move the
+ * Add terminal, browser and project folder to the conversation header, and move the
  * collapsed panel's re-entry action into the Session menu.
  *
  * The header's trailing group is a native list slot — `ui-open-in-app`,
@@ -15,9 +14,9 @@ import type { CleanupScope } from '../../../core/cleanup.ts';
  *
  * The corner seat is different, and deliberately so. It is a *single* cell whose
  * shipped occupant is `ui-sidebar-right`'s collapsed-panel expand control; the
- * reference draws nothing there, so the plugin shadows that occupant with an
- * entry that renders nothing and puts the expand action into the Session menu's
- * own ⋮ list (`compat/session-menu.ts`), where it appears only while the panel
+ * plugin shadows that occupant with the blank page's three view buttons,
+ * visible only under the host's headerBlank state, and puts the expand action
+ * into the Session menu's ⋮ list (`compat/session-menu.ts`), only while the panel
  * is collapsed. Nothing about the panel's own state changes hands: the menu row
  * calls the panel's own service method.
  *

package/lib/types/client/features/model-controls/EffortPanel.d.ts

@@ -4,6 +4,7 @@ export interface EffortPanelProps {
     readonly anchor: RefObject<HTMLButtonElement>;
     readonly choices: readonly EffortChoice[];
     readonly selected: number;
+    readonly defaultIndex: number;
     readonly disabled: boolean;
     readonly busy: boolean;
     readonly error: string | null;
@@ -11,4 +12,4 @@ export interface EffortPanelProps {
     readonly onClose: () => void;
 }
 /** Presentation-only slider: continuous local preview, one supported choice on release. */
-export declare function EffortPanel({ anchor, choices, selected, disabled, busy, error, onCommit, onClose }: EffortPanelProps): import("react/jsx-runtime").JSX.Element | null;
+export declare function EffortPanel({ anchor, choices, selected, defaultIndex, disabled, busy, error, onCommit, onClose }: EffortPanelProps): import("react/jsx-runtime").JSX.Element | null;

package/lib/types/client/features/model-controls/ModelControls.d.ts

@@ -3,9 +3,19 @@ import type { ModelDirectoryState } from '@deepseek-ai/dsh-client-ui-model-selec
 import type { PropsLocale } from '@deepseek-ai/dsh-client-ui-slots';
 import type { ModelSelection } from '@deepseek-ai/dsh-api-session-controller/types';
 export type ModelControlsProps = Omit<ModelSelectInjected, 'directory'> & PropsLocale<'model'> & {
+    readonly showModelIcons: boolean;
     readonly locked: boolean;
     readonly useDirectory: () => ModelDirectoryState;
     readonly selectEffort: (route: ModelSelection, effort: string | undefined) => void;
 };
 /** SDK-derived values/hooks and callbacks only; DSH retains all business state. */
-export declare function ModelControls({ locked, available, useDirectory, load, select, selectEffort, t }: ModelControlsProps): import("react/jsx-runtime").JSX.Element | null;
+export declare function ModelControls({ showModelIcons, locked, available, useDirectory, load, select, selectEffort, t }: ModelControlsProps): import("react/jsx-runtime").JSX.Element | null;
+export declare function ModelPanel({ showModelIcons, anchor, state, disabled, load, t, onClose, onSelect }: PropsLocale<'model'> & {
+    readonly showModelIcons: boolean;
+    readonly anchor: React.RefObject<HTMLButtonElement>;
+    readonly state: ModelDirectoryState;
+    readonly disabled: boolean;
+    readonly load: () => void;
+    readonly onClose: () => void;
+    readonly onSelect: (selection: ModelSelection) => void;
+}): import("react/jsx-runtime").JSX.Element;

package/lib/types/client/features/model-controls/PricingHint.d.ts

@@ -0,0 +1,19 @@
+import type { ReactElement } from 'react';
+/** Menu badges spell out the period; the Composer keeps its compact trend glyph. */
+export declare function PriceMark({ provider, model, compact, badge }: {
+    provider: string | undefined;
+    model: string | undefined;
+    compact?: boolean;
+    badge?: boolean;
+}): import("react/jsx-runtime").JSX.Element | null;
+/** Native top layer avoids clipping inside the model list and Composer. */
+export declare function PricingHint({ provider, model, compact, enabled, ignoreFocus, children }: {
+    provider: string | undefined;
+    model: string | undefined;
+    compact?: boolean;
+    enabled?: boolean;
+    ignoreFocus?: () => boolean;
+    children: ReactElement<{
+        'aria-describedby'?: string | undefined;
+    }>;
+}): import("react/jsx-runtime").JSX.Element;

package/lib/types/client/features/model-controls/model-icon-data.d.ts

@@ -0,0 +1,31 @@
+export interface ModelIconShape {
+    readonly kind: 'path' | 'circle' | 'ellipse' | 'rect';
+    readonly d?: string;
+    readonly cx?: string;
+    readonly cy?: string;
+    readonly r?: string;
+    readonly rx?: string;
+    readonly ry?: string;
+    readonly x?: string;
+    readonly y?: string;
+    readonly width?: string;
+    readonly height?: string;
+    readonly fillOpacity?: string;
+    readonly fillRule?: string;
+    readonly clipRule?: string;
+    readonly opacity?: string;
+    readonly transform?: string;
+}
+export interface ModelIconMark {
+    readonly title: string;
+    readonly viewBox: string;
+    readonly shapes: readonly ModelIconShape[];
+    readonly color?: ModelIconColor;
+}
+export interface ModelIconColor {
+    readonly viewBox: string;
+    readonly fill?: string;
+    readonly fillRule?: string;
+    readonly markup: string;
+}
+export declare const MODEL_ICONS: Readonly<Record<string, ModelIconMark>>;

package/lib/types/client/features/model-controls/model-icon-match.d.ts

@@ -0,0 +1,20 @@
+import type { ModelIconMark } from './model-icon-data.ts';
+export interface ModelIconTarget {
+    readonly id: string;
+    readonly name: string;
+}
+export interface ModelIconMatch {
+    readonly slug: string;
+    readonly mark: ModelIconMark;
+}
+/**
+ * Resolve one row's mark, preferring the model over its routing group.
+ *
+ * The provider is a fallback because a group such as `Magpie` can carry
+ * several brands; matching the group first made every row in it share one
+ * initial. The model row is the closest statement of which family a route
+ * actually serves.
+ */
+export declare function resolveModelIcon(provider: ModelIconTarget, model: ModelIconTarget): ModelIconMatch | null;
+/** The fallback seat: the model's own initial, not its routing group's. */
+export declare function modelIconInitial(provider: ModelIconTarget, model: ModelIconTarget): string;

package/lib/types/client/features/model-controls/model-icons.d.ts

@@ -0,0 +1,13 @@
+interface ModelIconTarget {
+    readonly id: string;
+    readonly name: string;
+}
+/**
+ * One row's leading glyph: the model family's mark when the index knows it,
+ * otherwise the model's initial. The seat is always drawn so rows align.
+ */
+export declare function ModelIcon({ provider, model }: {
+    readonly provider: ModelIconTarget;
+    readonly model: ModelIconTarget;
+}): import("react/jsx-runtime").JSX.Element;
+export {};

package/lib/types/client/features/model-controls/pricing.d.ts

@@ -0,0 +1,18 @@
+/** Official reference prices, CNY / million tokens; checked 2026-10-20.
+ * https://api-docs.deepseek.com/zh-cn/quick_start/pricing/
+ * The directory exposes route ids, not endpoints. Only the built-in DeepSeek
+ * route is eligible; these are reference prices, never a billing estimate.
+ */
+export interface ModelPrice {
+    readonly hit: number;
+    readonly input: number;
+    readonly output: number;
+}
+export declare function officialPrice(provider: string | undefined, model: string | undefined): ModelPrice | null;
+export interface PricingPeriod {
+    readonly peak: boolean;
+    readonly next: number | null;
+}
+/** Use absolute wall time, including after sleep; never decrement a counter. */
+export declare function pricingPeriod(time: number): PricingPeriod | null;
+export declare function pricingCountdown(remaining: number, zh: boolean): string;

package/lib/types/client/features/model-controls/selection.d.ts

@@ -36,6 +36,8 @@ export interface EffortViewCopy {
  * @returns every id a commit may carry, in provider order.
  */
 export declare function effortChoices(model: ModelCatalogModel | undefined, defaultName: string): EffortChoice[];
+/** Default marker: a valid provider default wins; otherwise mark High if offered. */
+export declare function effortDefaultIndex(model: ModelCatalogModel | undefined): number;
 /**
  * Lay out the card's stops, the resting thumb, and the trigger caption.
  *

package/lib/types/client/features/settings/ChoiceMenu.d.ts

@@ -0,0 +1,15 @@
+import type { ReactElement } from 'react';
+export declare function MenuCheck(): ReactElement;
+/** A small choice list with native-style focus, dismissal and keyboard navigation. */
+export declare function ChoiceMenu({ id, labelId, anchor, value, options, onSelect, onClose }: {
+    readonly id: string;
+    readonly labelId: string;
+    readonly anchor: HTMLElement;
+    readonly value: string;
+    readonly options: readonly {
+        readonly value: string;
+        readonly label: string;
+    }[];
+    readonly onSelect: (value: string) => void;
+    readonly onClose: () => void;
+}): ReactElement;

package/lib/types/client/features/settings/fields.d.ts

@@ -81,3 +81,21 @@ export interface FontRowProps {
  * @returns The row and, when open, its menu.
  */
 export declare function FontRow(props: FontRowProps): ReactElement;
+/** Styled choice control for named visual variants. */
+export declare function ChoiceRow({ id, label, value, options, onChange }: {
+    readonly id: string;
+    readonly label: string;
+    readonly value: string;
+    readonly options: readonly {
+        readonly value: string;
+        readonly label: string;
+    }[];
+    readonly onChange: (value: string) => void;
+}): ReactElement;
+export declare function NameRow({ id, label, value, onChange, onCommit }: {
+    readonly id: string;
+    readonly label: string;
+    readonly value: string;
+    readonly onChange: (value: string) => void;
+    readonly onCommit: () => void;
+}): ReactElement;