deck-plugin-sdk 1.1.0 → 1.4.0

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "deck-plugin-sdk",
-  "version": "1.1.0",
+  "version": "1.4.0",
   "description": "Build a plugin for Deck, outside the Deck repository.",
   "type": "module",
   "license": "MIT",

package/shim/bridge.js

@@ -9,6 +9,8 @@ const b = () => {
   return x;
 };
 
+export const agentClis = (...a) => b().agentClis(...a);
+export const agentMcpStatus = (...a) => b().agentMcpStatus(...a);
 export const askSudoPassword = (...a) => b().askSudoPassword(...a);
 export const backupExport = (...a) => b().backupExport(...a);
 export const backupInspect = (...a) => b().backupInspect(...a);
@@ -136,6 +138,9 @@ export const httpSend = (...a) => b().httpSend(...a);
 export const httpSendAs = (...a) => b().httpSendAs(...a);
 export const httpSendReply = (...a) => b().httpSendReply(...a);
 export const importIconPack = (...a) => b().importIconPack(...a);
+export const installAgentHooks = (...a) => b().installAgentHooks(...a);
+export const installAgentMcp = (...a) => b().installAgentMcp(...a);
+export const installAgentSkills = (...a) => b().installAgentSkills(...a);
 export const installClaudeHooks = (...a) => b().installClaudeHooks(...a);
 export const installClaudeMcp = (...a) => b().installClaudeMcp(...a);
 export const installFromRegistry = (...a) => b().installFromRegistry(...a);
@@ -181,6 +186,8 @@ export const readTrackMeta = (...a) => b().readTrackMeta(...a);
 export const remoteHome = (...a) => b().remoteHome(...a);
 export const remoteStat = (...a) => b().remoteStat(...a);
 export const remoteSudoPassword = (...a) => b().remoteSudoPassword(...a);
+export const removeAgentHooks = (...a) => b().removeAgentHooks(...a);
+export const removeAgentMcp = (...a) => b().removeAgentMcp(...a);
 export const removeClaudeHooks = (...a) => b().removeClaudeHooks(...a);
 export const removeClaudeMcp = (...a) => b().removeClaudeMcp(...a);
 export const removeLanguage = (...a) => b().removeLanguage(...a);

package/shim/p2p.d.ts

@@ -0,0 +1,4 @@
+// GENERATED by sdk/gen-shim.mjs — do not edit.
+//
+// Deck's real types, so a plugin is checked against the actual shape.
+export * from "../types/core/p2p";

package/shim/p2p.js

@@ -0,0 +1,15 @@
+// GENERATED by sdk/gen-shim.mjs — do not edit.
+//
+// Deck's live connections to other Decks. Resolved at USE time like the bridge: a plugin module is evaluated
+// during loadPlugins, and a reference copied out at import time would capture a half-built
+// object. One transport for every plugin, so a fix to it reaches all of them.
+const t = () => {
+  const x = window.__deck?.p2p;
+  if (!x) throw new Error("window.__deck.p2p is missing — this plugin only runs inside Deck");
+  return x;
+};
+
+export const cleanCode = (...a) => t().cleanCode(...a);
+export const newCode = (...a) => t().newCode(...a);
+export const selfId = (...a) => t().selfId(...a);
+export const share = (...a) => t().share(...a);

package/shim/settings.d.ts

@@ -1,5 +1,5 @@
 // GENERATED by sdk/gen-shim.mjs — do not edit.
 //
 // Deck's real settings types, so a plugin is checked against the actual shape.
-export { useSettings, getSettings, saveSettings } from "../types/core/settingsstore";
+export { useSettings, getSettings, saveSettings, userName } from "../types/core/settingsstore";
 export type { Settings } from "../types/core/bridge";

package/shim/settings.js

@@ -11,3 +11,6 @@ const s = () => {
 export const useSettings = (...a) => s().use(...a);
 export const getSettings = (...a) => s().get(...a);
 export const saveSettings = (...a) => s().save(...a);
+// What to call the user (needs a Deck newer than 1.1): the name set in Settings, else their Google or Windows
+// account's. For a plugin that shows the user to someone else.
+export const userName = (...a) => s().userName(...a);

package/shim/terminals.d.ts

@@ -1,4 +1,4 @@
 // GENERATED by sdk/gen-shim.mjs — do not edit.
 //
-// Deck's real terminal types, so a plugin is checked against the actual layout shape.
+// Deck's real types, so a plugin is checked against the actual shape.
 export * from "../types/core/terminals";

package/shim/terminals.js

@@ -19,11 +19,13 @@ export const attach = (...a) => t().attach(...a);
 export const bracketPaste = (...a) => t().bracketPaste(...a);
 export const clearPane = (...a) => t().clearPane(...a);
 export const closeLeaf = (...a) => t().closeLeaf(...a);
+export const copyFrom = (...a) => t().copyFrom(...a);
 export const destroy = (...a) => t().destroy(...a);
 export const findLeaf = (...a) => t().findLeaf(...a);
 export const focusPane = (...a) => t().focusPane(...a);
 export const getInstance = (...a) => t().getInstance(...a);
 export const getLayout = (...a) => t().getLayout(...a);
+export const hasSelection = (...a) => t().hasSelection(...a);
 export const insertBeside = (...a) => t().insertBeside(...a);
 export const isPinned = (...a) => t().isPinned(...a);
 export const isWorkspaceActive = (...a) => t().isWorkspaceActive(...a);
@@ -44,11 +46,14 @@ export const paneLabel = (...a) => t().paneLabel(...a);
 export const paneLines = (...a) => t().paneLines(...a);
 export const paneLocation = (...a) => t().paneLocation(...a);
 export const pasteInto = (...a) => t().pasteInto(...a);
+export const pasteText = (...a) => t().pasteText(...a);
+export const pasteTextInto = (...a) => t().pasteTextInto(...a);
 export const publishLayout = (...a) => t().publishLayout(...a);
 export const queueInput = (...a) => t().queueInput(...a);
 export const refit = (...a) => t().refit(...a);
 export const reorderTab = (...a) => t().reorderTab(...a);
 export const restartPane = (...a) => t().restartPane(...a);
+export const runsLines = (...a) => t().runsLines(...a);
 export const sendInput = (...a) => t().sendInput(...a);
 export const setLeafLabel = (...a) => t().setLeafLabel(...a);
 export const setLeafView = (...a) => t().setLeafView(...a);

package/shim/ui.js

@@ -51,11 +51,13 @@ export const collectFiles = (...a) => u().collectFiles(...a);
 export const conflict = (...a) => u().conflict(...a);
 export const decodeText = (...a) => u().decodeText(...a);
 export const dispatch = (...a) => u().dispatch(...a);
+export const forLanguage = (...a) => u().forLanguage(...a);
 export const formatChord = (...a) => u().formatChord(...a);
 export const getEditorSettings = (...a) => u().getEditorSettings(...a);
 export const getOverrides = (...a) => u().getOverrides(...a);
 export const match = (...a) => u().match(...a);
 export const mediaKind = (...a) => u().mediaKind(...a);
+export const modelOptionsFor = (...a) => u().modelOptionsFor(...a);
 export const monacoOptionsFrom = (...a) => u().monacoOptionsFrom(...a);
 export const normalizeChord = (...a) => u().normalizeChord(...a);
 export const onKey = (...a) => u().onKey(...a);

package/template/plugin.json

@@ -1,8 +1,9 @@
-{
-  "id": "__ID__",
-  "name": "__NAME__",
-  "description": "One line on what this is for, shown under its name in Settings.",
-  "icon": "Sparkles",
-  "version": "0.1.0",
-  "minDeck": "0.17.0"
-}
+{
+  "id": "__ID__",
+  "name": "__NAME__",
+  "description": "One line on what this is for, shown under its name in Settings.",
+  "icon": "Sparkles",
+  "color": "#a78bfa",
+  "version": "0.1.0",
+  "minDeck": "0.17.0"
+}

package/types/components/ContextMenu.d.ts

@@ -28,7 +28,7 @@ export interface MenuItem {
     checked?: boolean;
 }
 export type MenuEntry = MenuItem | "sep";
-export declare function ContextMenu({ x, y, items, alignRight, onClose, onReorder, flipAt }: {
+export declare function ContextMenu({ x, y, items, alignRight, onClose, onReorder, flipAt, up }: {
     x: number;
     y: number;
     items: MenuEntry[];
@@ -36,6 +36,8 @@ export declare function ContextMenu({ x, y, items, alignRight, onClose, onReorde
     onClose: () => void;
     /** A submenu flips around its parent row's LEFT edge, not the point it opened at. */
     flipAt?: number;
+    /** Open upward from (x, y) when it fits: a menu from a bottom bar, above the bar's buttons. */
+    up?: boolean;
     /** Called with (draggedId, newIndexAmongDraggableRows) after a drag-sort. */
     onReorder?: (id: string, toIndex: number) => void;
 }): import("react").ReactPortal;

package/types/components/menuplace.d.ts

@@ -27,4 +27,10 @@ export declare function place(x: number, y: number, width: number, height: numbe
  *
  * Left out by a menu raised at a cursor, which has no width and so flips around itself.
  */
-flipAt?: number): Placement;
+flipAt?: number, 
+/**
+ * Open upward from (x, y) whenever it fits there. For a menu raised from a button in a bottom
+ * bar: opening downward fits too (the window's edge is further down), and then covers the very
+ * buttons the menu is about.
+ */
+up?: boolean): Placement;

package/types/components/ui.d.ts

@@ -23,7 +23,7 @@ export declare function TimeInput({ value, onChange, className, }: {
     onChange: (v: string) => void;
     className?: string;
 }): import("react").JSX.Element;
-export declare function Select(props: React.SelectHTMLAttributes<HTMLSelectElement>): import("react").JSX.Element;
+export declare function Select({ className, ...props }: React.SelectHTMLAttributes<HTMLSelectElement>): import("react").JSX.Element;
 export declare function PrimaryButton({ children, ...p }: React.ButtonHTMLAttributes<HTMLButtonElement>): import("react").JSX.Element;
 export declare function GhostButton({ children, ...p }: React.ButtonHTMLAttributes<HTMLButtonElement>): import("react").JSX.Element;
 /**

package/types/core/bridge.d.ts

@@ -1,6 +1,6 @@
 // GENERATED by sdk/gen-types.mjs from Deck's source — do not edit.
 import { type DebugTarget } from "./debugtargets";
-import type { AccentColor, BgPreset, Density, TermTheme } from "./theme";
+import type { Accent, Background, Density, Palette, TermCustom, TermTheme } from "./theme";
 /** Open a URL in the default browser. */
 export declare const openExternal: (url: string) => Promise<void>;
 export interface AppProc {
@@ -44,12 +44,30 @@ export interface Settings {
     reduceMotion: boolean;
     /** The Servers list (hosts from ~/.ssh/config) under the workspace list. */
     serversList: boolean;
+    /** The mouse wheel over a tab bar switches tabs rather than scrolling the bar. */
+    tabWheelSwitch: boolean;
+    /** Install plugin and language updates at startup instead of only announcing them. */
+    pluginAutoUpdate: boolean;
     soundOnFire: boolean;
     playerPlacement: "fixed" | "floating";
-    accent: AccentColor;
-    bgPreset: BgPreset;
+    accent: Accent;
+    bgPreset: Background;
+    /** The colours of the "custom" background, each "#rrggbb". Kept when a preset is picked, so
+     *  going back to Custom finds them again. */
+    customTheme?: Partial<Palette>;
+    /** Custom palettes the user saved by name, shown as cards beside the presets. */
+    savedThemes?: {
+        id: string;
+        name: string;
+        palette: Partial<Palette>;
+    }[];
+    /** The saved theme the custom colours came from, which edits are written back to. */
+    savedThemeId?: string;
     density: Density;
+    uiZoom: number;
     termTheme: TermTheme;
+    /** The "custom" terminal theme's colours. Kept when another theme is picked. */
+    termCustom?: Partial<TermCustom>;
     termFont: string;
     termFontSize: number;
     termScrollback: number;
@@ -75,7 +93,19 @@ export interface Settings {
     drawerHidden: string[];
     /** Drawer tabs left-to-right. Ids missing from it keep their discovery order, after the rest. */
     drawerOrder: string[];
+    /** Which side of the footer each drawer tab and readout sits on, in order (core/footerlayout.ts).
+     *  Absent until something is moved: drawer tabs left, readouts right, in the orders above. */
+    footerLayout?: {
+        left: string[];
+        right: string[];
+    };
     httpMcpRevealSecrets: boolean;
+    /**
+     * What to call the user: shown to the others when sharing (a Canvas board's cursor and the
+     * host's "wants to join"). "" means work it out: the Google account's name when signed in,
+     * else the Windows account's (see `userName` in settingsstore.ts).
+     */
+    userName: string;
 }
 export declare const DEFAULT_SETTINGS: Settings;
 export declare const setAutostart: (on: boolean) => Promise<void>;
@@ -517,6 +547,30 @@ export declare const claudeMcpStatus: () => Promise<string>;
 export declare const claudeMcpEntry: () => Promise<string>;
 export declare const installClaudeMcp: () => Promise<string>;
 export declare const removeClaudeMcp: () => Promise<void>;
+/**
+ * The same for any AI coding agent Deck knows: "claude", "codex", "gemini" or "cursor". Each keeps
+ * its MCP servers somewhere else (see agentmcp.rs); the status is the same four answers, with
+ * "no-node" when nothing could run the server whatever the config says.
+ */
+export declare const agentMcpStatus: (agent: string) => Promise<string>;
+export declare const installAgentMcp: (agent: string) => Promise<string>;
+export declare const removeAgentMcp: (agent: string) => Promise<void>;
+/** Deck's hooks for an agent that has them ("claude", "codex"): what the Agents panel and the
+ *  agent notifications hear from. Merged into the agent's own settings, backed up first. */
+export declare const installAgentHooks: (agent: string) => Promise<void>;
+export declare const removeAgentHooks: (agent: string) => Promise<void>;
+/**
+ * Deck's skills (how to use its MCP tools) for an agent that reads skills: "claude" or "codex".
+ * Each comes back with what happened to it: "installed", "updated", "current", "kept-yours" (a
+ * skill of that name that is not Deck's) or "kept-edited" (Deck's, changed since). Deck only
+ * replaces a skill folder it wrote and nobody has edited.
+ */
+export declare const installAgentSkills: (agent: string) => Promise<{
+    skill: string;
+    outcome: string;
+}[]>;
+/** Which agent command-line tools are on PATH: any of claude, codex, gemini, cursor-agent, cursor. */
+export declare const agentClis: () => Promise<string[]>;
 export declare const removeClaudeHooks: () => Promise<void>;
 export declare const notifyOs: (title: string, body: string) => Promise<void>;
 export declare const gitStatus: (dir: string) => Promise<GitStatusRow[]>;

package/types/core/editorsettings.d.ts

@@ -1,5 +1,11 @@
 // GENERATED by sdk/gen-types.mjs from Deck's source — do not edit.
 import type * as MonacoNS from "monaco-editor";
+/** What a language may set differently from the editor-wide value. Absent means "as everywhere". */
+export interface LanguageOverride {
+    tabSize?: number;
+    insertSpaces?: boolean;
+    formatOnSave?: boolean;
+}
 export interface EditorSettings {
     fontSize: number;
     fontFamily: string;
@@ -38,9 +44,32 @@ export interface EditorSettings {
     mouseWheelZoom: boolean;
     autoClosingBrackets: boolean;
     autoClosingQuotes: boolean;
+    /** When a file writes itself to disk. Off (the default) means only Ctrl+S saves. */
+    autoSave: "off" | "afterDelay" | "onFocusChange";
     autoSaveDelay: number;
     trimTrailingWhitespace: boolean;
     formatOnSave: boolean;
+    formatOnPaste: boolean;
+    /** Completion: popping up while typing, on a trigger character like ".", and what Enter does. */
+    quickSuggestions: boolean;
+    suggestOnTriggerCharacters: boolean;
+    acceptSuggestionOnEnter: "on" | "smart" | "off";
+    snippetSuggestions: "top" | "bottom" | "inline" | "none";
+    /** Renaming an HTML/JSX tag renames its closing tag as you type. */
+    linkedEditing: boolean;
+    /** Lines kept visible above and below the cursor when it moves near an edge. */
+    cursorSurroundingLines: number;
+    multiCursorModifier: "alt" | "ctrlCmd";
+    /** Copy or cut with nothing selected takes the whole line. */
+    emptySelectionClipboard: boolean;
+    /** The file tree: names or globs to hide (comma-separated), dotfiles, following the open file. */
+    treeHide: string;
+    treeShowDotfiles: boolean;
+    treeFollowActive: boolean;
+    /** The folders above what is in view stay pinned at the top of the tree while it scrolls. */
+    treeStickyScroll: boolean;
+    /** Per-language overrides, keyed by Monaco language id ("python", "typescript"). */
+    languageOverrides: Record<string, LanguageOverride>;
     formatLineLength: number;
     inlineErrors: boolean;
     inlineBlame: boolean;
@@ -66,4 +95,17 @@ export declare function getEditorSettings(): EditorSettings;
 /** For a store outside React that reacts to a setting (lsp.ts re-asks for inlay hints). */
 export declare function subscribeEditorSettings(cb: () => void): () => void;
 export declare function useEditorSettings(): EditorSettings;
+/** A language's own value for each overridable setting, else the editor-wide one. */
+export declare function forLanguage(s: EditorSettings, languageId: string | undefined): {
+    tabSize: number;
+    insertSpaces: boolean;
+    formatOnSave: boolean;
+};
+/** The model options for a file of `languageId`. */
+export declare function modelOptionsFor(s: EditorSettings, languageId: string | undefined): {
+    tabSize: number;
+    insertSpaces: boolean;
+};
+/** Whether the file tree shows an entry, under these settings (core/treehide.ts). */
+export declare const treeShows: (s: EditorSettings, name: string) => boolean;
 export declare function monacoOptionsFrom(s: EditorSettings): MonacoNS.editor.IEditorOptions;

package/types/core/lsp.d.ts

@@ -76,12 +76,17 @@ export interface LoadedLanguage {
     folder: string;
     /** language.json's version, or "" when it has none (a pack from before versions). */
     version: string;
+    /** Its lucide icon name and colour from language.json; "" when it names none. */
+    icon: string;
+    color: string;
     snippets?: number;
 }
 export interface LanguageError {
     folder: string;
     message: string;
 }
+export declare function subscribeLanguages(fn: () => void): () => void;
+export declare function languagesVersion(): number;
 /** Every language definition that loaded. */
 export declare function loadedLanguages(): readonly LoadedLanguage[];
 /**

package/types/core/monaco.d.ts

@@ -16,6 +16,7 @@ export declare function setEditorSurface(next: {
     card: string;
     elev: string;
     muted: string;
+    text?: string;
 }): void;
 /** Merge language-specific semantic-token colors into deck-dark (idempotent per token). */
 export declare function addSemanticColors(rules: TokenColor[]): void;

package/types/core/p2p.d.ts

@@ -0,0 +1,117 @@
+// GENERATED by sdk/gen-types.mjs from Deck's source — do not edit.
+/** What can travel: anything JSON can carry. */
+export type Json = string | number | boolean | null | Json[] | {
+    [k: string]: Json;
+};
+/** Whether someone may change what is shared, or only watch. */
+export type Mode = "edit" | "view";
+/** Who may change things: a default for everyone, and a choice per person that wins over it. */
+export interface Roles {
+    def: Mode;
+    per: Record<string, Mode>;
+}
+/** Why a share ended for a joiner: the host stopped, vanished, removed this Deck, turned it away,
+ *  or speaks another version. */
+export type Gone = "ended" | "lost" | "removed" | "denied" | "version";
+export interface Person {
+    id: string;
+    name: string; /** Round trip in ms, once measured. */
+    ms?: number;
+}
+/** What a share's bar and dialogs show. Replaced, never mutated, so React sees a change. */
+export interface ShareView {
+    /** Who is in and connected: on the host, everyone let in; on a joiner, the host and the others. */
+    peers: Person[];
+    /** On the host: who is asking to be let in. */
+    knocking: Person[];
+    /** On a joiner: the host is there but has not let this Deck in yet. */
+    waiting: boolean;
+    /** On a joiner: no host heard from for a while (wrong code, or a network that blocks it). */
+    stuck: boolean;
+    gone: Gone | null;
+    hostName: string;
+    /** A passing line: someone on another version, or whatever the plugin `say`s. */
+    note: string;
+    roles: Roles;
+    /** Whether this Deck may change things. */
+    canEdit: boolean;
+}
+export interface ShareOptions {
+    /** What the share is for, e.g. "canvas-share". Decks only meet others using the same one. */
+    app: string;
+    /** The share code, which names the room (see newCode). */
+    code: string;
+    /** Optional extra secret, needed with the code to connect at all. Sharing works without one. */
+    password?: string;
+    /** The plugin's message channel, at most 12 bytes (Trystero's cap). Defaults to "msg". */
+    channel?: string;
+    /** Whether this Deck is the one sharing. */
+    host: boolean;
+    /** Shown to the others: in the host's knock, on cursors, in the list of who is here. */
+    name: string;
+    /** The plugin's own protocol version. Decks on different versions do not share. */
+    version: number;
+    /** The host's default for who may change things. Joiners may until the host says otherwise. */
+    mode?: Mode;
+}
+export interface ShareHandlers<T> {
+    /** A plugin message, only ever from someone let in (and the host). Check `mayEdit(peer)` before
+     *  applying a change: a view-only person's edits are to be dropped by every Deck. */
+    message: (msg: T, peer: string) => void;
+    /** On the host: someone was just let in. Send them what they need to start, e.g. the board. */
+    welcome?: (peer: string) => void;
+    /** Someone left or was removed: forget what was kept for them (a cursor). */
+    left?: (peer: string) => void;
+}
+export interface P2pShare<T> {
+    readonly host: boolean;
+    /** Send a plugin message to everyone let in, or to one of them. Sends nothing before this Deck is
+     *  let in. Settles once handed to the connection, so awaiting it paces the sender. */
+    send(msg: T, to?: string): Promise<void>;
+    /** Whether a peer may change things: the host always, anyone else by the roles. */
+    mayEdit(peer: string): boolean;
+    /** The host: let someone in, or turn them away. */
+    allow(peer: string): void;
+    deny(peer: string): void;
+    /** The host: remove someone who was let in. They cannot come back with the same Deck. */
+    kick(peer: string): void;
+    /** The host: everyone's default, and one person's own choice (`null` follows the default). */
+    setDefault(mode: Mode): void;
+    setPerson(peer: string, mode: Mode | null): void;
+    /** Show a passing line in the view for a few seconds. */
+    say(note: string): void;
+    /** Leave. With `announce` (the host ending on purpose) everyone is told first, so they end at
+     *  once rather than when the connection times out. Safe to call twice. */
+    close(announce?: boolean): Promise<void>;
+    /** For useSyncExternalStore. */
+    subscribe(fn: () => void): () => void;
+    getView(): ShareView;
+}
+/** The part of a Trystero room a share uses: a seam, so the check can run a share without a network. */
+export interface RoomLike {
+    /** This Deck's id in the room; Trystero's own is `selfId()`. */
+    selfId?: string;
+    makeAction(name: string, config: {
+        onMessage: (data: any, ctx: {
+            peerId: string;
+        }) => void;
+    }): {
+        send(data: any, options?: {
+            target?: string | string[];
+        }): Promise<void>;
+    };
+    ping(peer: string): Promise<number>;
+    leave(): Promise<void>;
+    getPeers(): Record<string, unknown>;
+    onPeerJoin: ((peer: string) => void) | null;
+    onPeerLeave: ((peer: string) => void) | null;
+}
+/** This Deck's id in every share: the one the others know it by. The same for the whole session,
+ *  so someone let in who rejoins after a dropped connection is let straight back in. */
+export declare function selfId(): string;
+/** Start sharing (`host`), or ask to join someone's share. */
+export declare function share<T extends Json>(opts: ShareOptions, on: ShareHandlers<T>, room?: RoomLike): P2pShare<T>;
+/** A share code: 16 random characters in four groups, easy to read out or paste. */
+export declare function newCode(random?: (n: number) => Uint8Array): string;
+/** A pasted code, tidied: spaces dropped, case folded. Empty when it is not a code. */
+export declare function cleanCode(text: string): string;

package/types/core/settingsstore.d.ts

@@ -11,6 +11,16 @@ export declare function publishSettings(s: Settings): void;
  * for the shared half.
  */
 export declare function saveSettings(next: Settings): void;
+/** The zoom steps Ctrl+= and Ctrl+- move through, in percent, as a browser's do. */
+export declare const ZOOM_STEPS: number[];
+/**
+ * Zoom the whole window: the webview's own zoom, the same as a browser's Ctrl+=, rather than CSS
+ * `zoom`, which leaves xterm and Monaco measuring the mouse in unzoomed pixels.
+ */
+export declare function applyZoom(pct: number | undefined): void;
+/** One step in or out from the current zoom, or back to 100% with dir 0. Saved like any setting. */
+export declare function stepZoom(dir: -1 | 0 | 1): void;
 /** Current settings for non-React callers (the palette's providers). */
 export declare const getSettings: () => Settings;
+export declare function userName(): Promise<string>;
 export declare function useSettings(): Settings;

package/types/core/terminals.d.ts

@@ -318,7 +318,31 @@ export declare function getInstance(id: string): Instance;
  * smaller writes would only add more seams.
  */
 export declare function bracketPaste(text: string, bracketed: boolean): string;
-/** Paste the clipboard text into a terminal's PTY (Ctrl+V and the context-menu Paste). */
+/** Whether a terminal has text selected, for its right-click menu's Copy. */
+export declare const hasSelection: (id: string) => boolean;
+/**
+ * Copy a terminal's selection, then clear it: with the selection kept, the next Ctrl+C copied
+ * again instead of interrupting the program, until something was clicked.
+ */
+export declare function copyFrom(id: string): void;
+/**
+ * A paste's line breaks as the Enter key sends them. Text copied on Windows carries CRLF, and
+ * written raw each line arrived as Enter plus a stray line feed. xterm's own paste does this
+ * conversion; Deck writes pastes itself, so it does it here.
+ */
+export declare const pasteText: (text: string) => string;
+/**
+ * A pasted line break that will run a command: one ending a line, outside a bracketed paste.
+ * The shell (PowerShell, cmd) takes each as Enter, so pasting two lines ran the first at once.
+ */
+export declare const runsLines: (text: string, bracketed: boolean) => boolean;
+/**
+ * Paste text into a terminal: line breaks as Enter, bracketed when the app asked for it, and
+ * when it would run lines in a shell that cannot tell a paste from typing, asked first, the way
+ * Windows Terminal asks. Focus goes back to the terminal afterwards, as a menu click takes it.
+ */
+export declare function pasteTextInto(id: string, text: string): Promise<void>;
+/** Paste the clipboard into a terminal, from its right-click menu (no key event to read). */
 export declare function pasteInto(id: string): Promise<void>;
 export declare function attach(id: string, el: HTMLElement, cwd: string): () => void;
 export declare function queueInput(paneId: string, text: string): void;

package/types/core/theme.d.ts

@@ -1,6 +1,28 @@
 // GENERATED by sdk/gen-types.mjs from Deck's source — do not edit.
 export type AccentColor = "violet" | "blue" | "cyan" | "green" | "amber" | "red";
+/** A preset's name, or a custom colour as "#rrggbb". */
+export type Accent = AccentColor | `#${string}`;
 export type BgPreset = "black" | "slate" | "warm" | "midnight" | "charcoal" | "nord" | "plum" | "dracula" | "forest";
+/** A preset, or "custom": the user's own colours, from `customTheme`. */
+export type Background = BgPreset | "custom";
+/**
+ * Every colour a theme sets, so a custom one can set them all: the five surfaces darkest first,
+ * and the three text colours. Each is "#rrggbb", which is what a colour picker reads and writes.
+ */
+export interface Palette {
+    app: string;
+    panel: string;
+    card: string;
+    elev: string;
+    hover: string;
+    text: string;
+    textSecondary: string;
+    muted: string;
+    /** What is drawn on the accent: a primary button's label, a switch's knob. */
+    onAccent: string;
+}
+/** "#rrggbb" as "r g b", the form the rgb(var(--x) / alpha) tokens take. */
+export declare const channels: (hex: string) => string;
 export type Density = "compact" | "cozy";
 /** Accent base/strong pairs. Values match the primitives already in tokens.css. */
 export declare const ACCENTS: Record<AccentColor, {
@@ -27,23 +49,54 @@ export declare const DENSITIES: Record<Density, {
     scale: number;
     radius: number;
 }>;
+/** The colours a background setting resolves to. A custom one missing a colour (or with none
+ *  saved) takes it from the near-black preset, so a half-filled palette still draws. */
+export declare function paletteOf(bgPreset?: string, custom?: Partial<Palette>): Palette;
+/** Whether a "#rrggbb" background is light: relative luminance over the midpoint. */
+export declare function isLightColor(hex: string): boolean;
+/** Whether an accent is a custom colour rather than a preset's name. */
+export declare const isCustomAccent: (accent?: string) => accent is `#${string}`;
+/**
+ * An accent's base and strong colours. A custom one has no hand-picked strong shade, so it is the
+ * base mixed toward black, which is what the presets' pairs are. Anything unknown (a preset that
+ * was removed) falls back to violet.
+ */
+export declare function accentOf(accent?: string): {
+    base: string;
+    strong: string;
+};
 /** Apply the three appearance settings to the document. Safe to call repeatedly. */
 export declare function applyTheme(opts: {
-    accent?: AccentColor;
-    bgPreset?: BgPreset;
+    accent?: Accent;
+    bgPreset?: Background;
+    customTheme?: Partial<Palette>;
     density?: Density;
     termTheme?: TermTheme;
+    termCustom?: Partial<TermCustom>;
 }): void;
 /** The values the app starts with, before settings.json has been read. Matches tokens.css. */
 export declare const DEFAULT_APPEARANCE: {
-    accent: AccentColor;
-    bgPreset: BgPreset;
+    accent: Accent;
+    bgPreset: Background;
     density: Density;
 };
-export type TermTheme = "match" | "deck" | "dark" | "dimmed" | "solarized";
+export type TermTheme = "match" | "deck" | "dark" | "dimmed" | "solarized" | "custom";
+/** The eight ANSI colours programs print with. Bright variants follow them in a custom theme. */
+export declare const ANSI_KEYS: readonly ["black", "red", "green", "yellow", "blue", "magenta", "cyan", "white"];
+export type Ansi = Record<(typeof ANSI_KEYS)[number], string>;
+/** xterm's own defaults, which every theme but a custom one leaves in place. */
+export declare const XTERM_ANSI: Ansi;
+/** A custom terminal theme: every colour, each "#rrggbb". */
+export interface TermCustom {
+    background: string;
+    foreground: string;
+    cursor: string;
+    selection: string;
+    ansi: Ansi;
+}
 /** Fixed palettes. "match" isn't here — it's derived from the app's accent + background at
  *  resolve time (see termThemeColors), so it changes with those settings. */
-export declare const TERM_THEMES: Record<Exclude<TermTheme, "match">, {
+export declare const TERM_THEMES: Record<Exclude<TermTheme, "match" | "custom">, {
     label: string;
     background: string;
     foreground: string;
@@ -55,13 +108,16 @@ export declare const TERM_THEME_LABELS: Record<TermTheme, string>;
 /** Resolve a terminal theme to concrete colours. "match" follows the app's own appearance: the
  *  card surface as the background (so a terminal reads as part of the panel it sits in) and the
  *  accent as the cursor, so picking a new accent recolours the terminal too. */
-export declare function termThemeColors(theme: TermTheme, accent?: AccentColor, bgPreset?: BgPreset): {
+export declare function termThemeColors(theme: TermTheme, accent?: Accent, bgPreset?: Background, custom?: Partial<Palette>, term?: Partial<TermCustom>): {
     label: string;
     background: string;
     foreground: string;
     cursor: string;
     selectionBackground: string;
+    ansi?: Ansi;
 };
+/** A custom terminal theme with every colour filled: what is missing comes from the Deck theme. */
+export declare function customTerm(t?: Partial<TermCustom>): TermCustom;
 export declare const TERM_FONTS: {
     value: string;
     label: string;

package/types/core/treehide.d.ts

@@ -0,0 +1,5 @@
+// GENERATED by sdk/gen-types.mjs from Deck's source — do not edit.
+/** "dist, *.log" as one case-insensitive whole-name pattern each: * is any run, ? one character. */
+export declare function hidePatterns(text: string): RegExp[];
+/** Whether the tree shows an entry named `name`. */
+export declare function treeVisible(name: string, hide: string, dotfiles: boolean): boolean;