deck-plugin-sdk 1.6.1 → 1.8.0

package/shim/terminals.js

@@ -1,83 +1,97 @@
-// GENERATED by sdk/gen-shim.mjs — do not edit.
-//
-// Deck's terminal panes. 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. The layout store is shared, not copied — a second one would not know about the panes
-// Deck already has open.
-const t = () => {
-  const x = window.__deck?.terminals;
-  if (!x) throw new Error("window.__deck.terminals is missing — this plugin only runs inside Deck");
-  return x;
-};
-
-export const ZONE_BOARD = (...a) => t().ZONE_BOARD(...a);
-export const activeWorkspaceCwd = (...a) => t().activeWorkspaceCwd(...a);
-export const addTabToZone = (...a) => t().addTabToZone(...a);
-export const applyDtCommand = (...a) => t().applyDtCommand(...a);
-export const applyTerminalLook = (...a) => t().applyTerminalLook(...a);
-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);
-export const leafIds = (...a) => t().leafIds(...a);
-export const loadLayoutOnce = (...a) => t().loadLayoutOnce(...a);
-export const markAgentStarted = (...a) => t().markAgentStarted(...a);
-export const moveLeaf = (...a) => t().moveLeaf(...a);
-export const moveTabToZone = (...a) => t().moveTabToZone(...a);
-export const moveWorkspace = (...a) => t().moveWorkspace(...a);
-export const moveZone = (...a) => t().moveZone(...a);
-export const mutateLayout = (...a) => t().mutateLayout(...a);
-export const nextActiveAfterClose = (...a) => t().nextActiveAfterClose(...a);
-export const nextZoneSpot = (...a) => t().nextZoneSpot(...a);
-export const openFile = (...a) => t().openFile(...a);
-export const openTabInWorkspace = (...a) => t().openTabInWorkspace(...a);
-export const paneCwd = (...a) => t().paneCwd(...a);
-export const paneHasAgent = (...a) => t().paneHasAgent(...a);
-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);
-export const showActiveTab = (...a) => t().showActiveTab(...a);
-export const splitLeaf = (...a) => t().splitLeaf(...a);
-export const suspendWorkspace = (...a) => t().suspendWorkspace(...a);
-export const switchWorkspace = (...a) => t().switchWorkspace(...a);
-export const termKill = (...a) => t().termKill(...a);
-export const termList = (...a) => t().termList(...a);
-export const termResize = (...a) => t().termResize(...a);
-export const termScrollback = (...a) => t().termScrollback(...a);
-export const termSpawn = (...a) => t().termSpawn(...a);
-export const termSweepScrollback = (...a) => t().termSweepScrollback(...a);
-export const termWrite = (...a) => t().termWrite(...a);
-export const togglePin = (...a) => t().togglePin(...a);
-export const useAgentPanesVersion = (...a) => t().useAgentPanesVersion(...a);
-export const useLayout = (...a) => t().useLayout(...a);
-export const usePinnedPanes = (...a) => t().usePinnedPanes(...a);
-export const webglLimit = (...a) => t().webglLimit(...a);
-export const workspaceByCwd = (...a) => t().workspaceByCwd(...a);
-export const workspaceShellCount = (...a) => t().workspaceShellCount(...a);
-export const zoneAt = (...a) => t().zoneAt(...a);
-export const zoneBoardFull = (...a) => t().zoneBoardFull(...a);
-export const zoneOf = (...a) => t().zoneOf(...a);
-export const zoneToward = (...a) => t().zoneToward(...a);
-export const zones = (...a) => t().zones(...a);
+// GENERATED by sdk/gen-shim.mjs — do not edit.
+//
+// Deck's terminal panes. 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. The layout store is shared, not copied — a second one would not know about the panes
+// Deck already has open.
+import { pluginId } from "./scope.js";
+const t = () => {
+  const x = window.__deck?.forPlugin?.(pluginId)?.terminals ?? window.__deck?.terminals;
+  if (!x) throw new Error("window.__deck.terminals is missing — this plugin only runs inside Deck");
+  return x;
+};
+
+export const GROUP_COLORS = (...a) => t().GROUP_COLORS(...a);
+export const ZONE_BOARD = (...a) => t().ZONE_BOARD(...a);
+export const activeWorkspaceCwd = (...a) => t().activeWorkspaceCwd(...a);
+export const addTabToZone = (...a) => t().addTabToZone(...a);
+export const addToGroup = (...a) => t().addToGroup(...a);
+export const applyDtCommand = (...a) => t().applyDtCommand(...a);
+export const applyTerminalLook = (...a) => t().applyTerminalLook(...a);
+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);
+export const leafIds = (...a) => t().leafIds(...a);
+export const leaveGroup = (...a) => t().leaveGroup(...a);
+export const loadLayoutOnce = (...a) => t().loadLayoutOnce(...a);
+export const markAgentStarted = (...a) => t().markAgentStarted(...a);
+export const moveGroup = (...a) => t().moveGroup(...a);
+export const moveLeaf = (...a) => t().moveLeaf(...a);
+export const moveTabToZone = (...a) => t().moveTabToZone(...a);
+export const moveWorkspace = (...a) => t().moveWorkspace(...a);
+export const moveZone = (...a) => t().moveZone(...a);
+export const mutateLayout = (...a) => t().mutateLayout(...a);
+export const nextActiveAfterClose = (...a) => t().nextActiveAfterClose(...a);
+export const nextZoneSpot = (...a) => t().nextZoneSpot(...a);
+export const openActiveGroup = (...a) => t().openActiveGroup(...a);
+export const openFile = (...a) => t().openFile(...a);
+export const openInEditor = (...a) => t().openInEditor(...a);
+export const openTabInWorkspace = (...a) => t().openTabInWorkspace(...a);
+export const paneCwd = (...a) => t().paneCwd(...a);
+export const paneHasAgent = (...a) => t().paneHasAgent(...a);
+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 pruneGroups = (...a) => t().pruneGroups(...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 resetPaneModes = (...a) => t().resetPaneModes(...a);
+export const restartPane = (...a) => t().restartPane(...a);
+export const revealPane = (...a) => t().revealPane(...a);
+export const runsLines = (...a) => t().runsLines(...a);
+export const sendInput = (...a) => t().sendInput(...a);
+export const setGroup = (...a) => t().setGroup(...a);
+export const setLeafLabel = (...a) => t().setLeafLabel(...a);
+export const setLeafView = (...a) => t().setLeafView(...a);
+export const showActiveTab = (...a) => t().showActiveTab(...a);
+export const splitLeaf = (...a) => t().splitLeaf(...a);
+export const stopPaneAgent = (...a) => t().stopPaneAgent(...a);
+export const suspendWorkspace = (...a) => t().suspendWorkspace(...a);
+export const switchWorkspace = (...a) => t().switchWorkspace(...a);
+export const termKill = (...a) => t().termKill(...a);
+export const termList = (...a) => t().termList(...a);
+export const termResize = (...a) => t().termResize(...a);
+export const termScrollback = (...a) => t().termScrollback(...a);
+export const termSpawn = (...a) => t().termSpawn(...a);
+export const termSweepScrollback = (...a) => t().termSweepScrollback(...a);
+export const termWrite = (...a) => t().termWrite(...a);
+export const toggleGroupFold = (...a) => t().toggleGroupFold(...a);
+export const togglePin = (...a) => t().togglePin(...a);
+export const ungroup = (...a) => t().ungroup(...a);
+export const useAgentPanesVersion = (...a) => t().useAgentPanesVersion(...a);
+export const useLayout = (...a) => t().useLayout(...a);
+export const usePinnedPanes = (...a) => t().usePinnedPanes(...a);
+export const webglLimit = (...a) => t().webglLimit(...a);
+export const workspaceByCwd = (...a) => t().workspaceByCwd(...a);
+export const workspaceShellCount = (...a) => t().workspaceShellCount(...a);
+export const zoneAt = (...a) => t().zoneAt(...a);
+export const zoneBoardFull = (...a) => t().zoneBoardFull(...a);
+export const zoneOf = (...a) => t().zoneOf(...a);
+export const zoneToward = (...a) => t().zoneToward(...a);
+export const zones = (...a) => t().zones(...a);

package/shim/ui.d.ts

@@ -23,3 +23,4 @@ export * from "../types/modules/editor/tree";
 export * from "../types/core/decode";
 export * from "../types/core/keys";
 export * from "../types/modules/editor/MonacoHosts";
+export * from "../types/core/fileview";

package/shim/ui.js

@@ -46,7 +46,9 @@ export const activeScopes = (...a) => u().activeScopes(...a);
 export const allBindings = (...a) => u().allBindings(...a);
 export const allThemes = (...a) => u().allThemes(...a);
 export const applyLineChanges = (...a) => u().applyLineChanges(...a);
+export const bindMonacoKey = (...a) => u().bindMonacoKey(...a);
 export const buildChangeTree = (...a) => u().buildChangeTree(...a);
+export const byScope = (...a) => u().byScope(...a);
 export const chordFor = (...a) => u().chordFor(...a);
 export const chordIndex = (...a) => u().chordIndex(...a);
 export const claimedOutsideTerminal = (...a) => u().claimedOutsideTerminal(...a);
@@ -60,6 +62,7 @@ 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 keyOf = (...a) => u().keyOf(...a);
 export const match = (...a) => u().match(...a);
 export const mediaKind = (...a) => u().mediaKind(...a);
 export const modelOptionsFor = (...a) => u().modelOptionsFor(...a);
@@ -68,14 +71,21 @@ export const normalizeChord = (...a) => u().normalizeChord(...a);
 export const notify = (...a) => u().notify(...a);
 export const onKey = (...a) => u().onKey(...a);
 export const onKeys = (...a) => u().onKeys(...a);
+export const openByType = (...a) => u().openByType(...a);
+export const openIn = (...a) => u().openIn(...a);
+export const openerFor = (...a) => u().openerFor(...a);
+export const openersFor = (...a) => u().openersFor(...a);
 export const parseChord = (...a) => u().parseChord(...a);
+export const pluginForFile = (...a) => u().pluginForFile(...a);
 export const pushScope = (...a) => u().pushScope(...a);
 export const repoLabel = (...a) => u().repoLabel(...a);
+export const repoOf = (...a) => u().repoOf(...a);
 export const resolve = (...a) => u().resolve(...a);
 export const rowAt = (...a) => u().rowAt(...a);
 export const sameRows = (...a) => u().sameRows(...a);
 export const scopeActive = (...a) => u().scopeActive(...a);
 export const setPluginBindings = (...a) => u().setPluginBindings(...a);
+export const splitView = (...a) => u().splitView(...a);
 export const statusColor = (...a) => u().statusColor(...a);
 export const subscribeEditorSettings = (...a) => u().subscribeEditorSettings(...a);
 export const themeById = (...a) => u().themeById(...a);
@@ -90,3 +100,5 @@ export const useNarrow = (...a) => u().useNarrow(...a);
 export const useResize = (...a) => u().useResize(...a);
 export const useRowDrag = (...a) => u().useRowDrag(...a);
 export const useScope = (...a) => u().useScope(...a);
+export const viewKey = (...a) => u().viewKey(...a);
+export const withKey = (...a) => u().withKey(...a);

package/template/AGENTS.md

@@ -11,6 +11,7 @@ npm run dev            # build on every save and install into the test Deck, whi
 npm run build          # build once into plugin.js
 npm run install-local  # build and install into the user's real Deck
 npx deck-plugin check  # validate plugin.json
+npx deck-plugin publish --dry-run   # everything the registry checks, nothing published
 ```
 
 The test Deck is a second Deck with its own data, started with
@@ -22,7 +23,10 @@ the plugin's `console.warn` and `console.error` lines land there.
 ## Files
 
 - `plugin.json`: `id` (letters, digits, dashes; it is a folder name and a config key), `name`,
-  `description`, `icon` (a lucide icon name), `color`, `version`, `minDeck`.
+  `description`, `icon` (a lucide icon name), `color`, `version`, `minDeck`, and `permissions`:
+  what it uses of Deck (`files`, `processes`, `git`, `network`, `terminals`, `browser`,
+  `secrets`, `system`, `deck`; the table is `node_modules/deck-plugin-sdk/permissions.json`). A
+  bridge call outside them throws, naming the one to add: add it rather than working around it.
 - `src/plugin.tsx`: the entry. Its exports are what Deck uses (below).
 - `src/mcp.ts`, if present: tools for Deck's MCP server, built to `mcp.js`.
 - `plugin.js` (and `mcp.js`): the build's output, gitignored. Never edit them.

package/template/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) __YEAR__ __AUTHOR__
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/template/plugin.json

@@ -1,9 +1,10 @@
-{
-  "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": "1.6.1"
-}
+{
+  "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": "1.8.0",
+  "permissions": []
+}

package/types/components/MarkdownToolbar.d.ts

@@ -24,6 +24,8 @@ export interface TextSurface {
         to: number;
     }): void;
     focus(): void;
+    /** Whether the keyboard is in this text, for the markdown keys (Ctrl+B, Ctrl+I). */
+    hasFocus(): boolean;
 }
 /** A TextSurface over a CodeMirror EditorView. */
 export declare function cmSurface(view: EditorView): TextSurface;

package/types/core/bridge.d.ts

@@ -20,6 +20,26 @@ export declare const browserNav: (pane: string, action: "back" | "forward" | "re
 /** The chords Rust takes from a focused page: `deck` moves the keyboard back to Deck, `page` does not. */
 export declare const browserSetKeys: (deck: string[], page: string[]) => Promise<void>;
 export declare const browserClose: (pane: string) => Promise<void>;
+/** Answer a site's sign-in (user and password, or neither to cancel) or its certificate error (proceed). */
+export declare const browserSiteAnswer: (pane: string, id: number, a: {
+    user?: string;
+    password?: string;
+    proceed?: boolean;
+}) => Promise<void>;
+/** The page's print dialog, or its Save as dialog. */
+export declare const browserPrint: (pane: string, action: "print" | "save") => Promise<void>;
+/** Answer a site's request to send notifications (the pane's bar). */
+export declare const browserPermissionAnswer: (pane: string, id: number, allow: boolean) => Promise<void>;
+/** Open the app link (mailto:, zoommtg:) the pane asked for. */
+export declare const browserOpenAppLink: (pane: string, uri: string) => Promise<void>;
+/** A page's notification was clicked in Deck: the page hears of it. */
+export declare const browserNotificationClicked: (pane: string, id: number) => Promise<void>;
+/** Reload a page whose process hangs: that process is ended first. */
+export declare const browserReloadHung: (pane: string) => Promise<void>;
+/** The window fullscreen for a page that went fullscreen, or back as it was. */
+export declare const browserWindowFullscreen: (on: boolean) => Promise<void>;
+/** Put a hidden pane's page to sleep, or wake it. */
+export declare const browserSleep: (pane: string, on: boolean) => Promise<void>;
 /** A JPEG of what the pane's webview shows. */
 /** The ad blocker on or off, and the sites it is off for. */
 export declare const adblockConfig: (enabled: boolean, off: string[], youtube: boolean) => Promise<void>;
@@ -34,7 +54,8 @@ export declare const adblockRebuild: () => Promise<void>;
 /** Download the ad blocker's lists again now. */
 export declare const adblockUpdate: () => Promise<void>;
 /** The browser's privacy settings, for every browser pane. */
-export declare const browserPrivacy: (tracking: string, autofill: boolean) => Promise<void>;
+/** `scheme`: the light or dark mode pages are asked for (prefers-color-scheme); "auto" is Windows'. */
+export declare const browserPrivacy: (tracking: string, autofill: boolean, scheme: "light" | "dark" | "auto") => Promise<void>;
 /** Clear the browser's stored data of these kinds (cookies, cache, passwords, autofill) since `since`
  *  (seconds since 1970; 0 for all of it). */
 export declare const browserClear: (kinds: string[], since: number) => Promise<void>;
@@ -244,6 +265,10 @@ export interface Settings {
     tabSqueeze?: boolean;
     /** Each project's own colour on the sidebar's collapsed rail. Off, they are all one grey. */
     projectColours?: boolean;
+    /** Agents listed under their workspace in the sidebar: under every one (default), only the open one, or none. */
+    sidebarAgents?: "all" | "open" | "off";
+    /** The workspace sidebar is a button in the title bar that opens it over the panes, rather than a column. */
+    sidebarMenu?: boolean;
     /** Pane controls float over the pane's top-right corner on hover, instead of a header row. */
     floatingPaneControls: boolean;
     /** Per notification kind, whether it shows as a card, in the bell, with a sound, and as a Windows
@@ -353,6 +378,13 @@ export interface Settings {
     browserYoutubeSkip: boolean;
     /** Where Ctrl+click on a web address in a terminal opens it: a browser tab of Deck's, or the system's. */
     browserTerminalLinks: "deck" | "system";
+    /** Sleeping tabs: a browser tab out of sight this many minutes stops running until it is shown. */
+    browserSleep: boolean;
+    browserSleepAfter: number;
+    /** Whether pages are asked for light or dark to match Deck's theme ("deck") or Windows'. */
+    browserPageTheme?: "deck" | "windows";
+    /** App links opened without asking, as "<site origin> <scheme>" ("https://zoom.us zoommtg"). */
+    browserAppLinks: string[];
     /** The start page offers to make Deck the default browser while it is not. Off: "Don't ask again". */
     browserDefaultAsk?: boolean;
     /** Sites (by host) an agent may use in the browser without asking; localhost and files always. */
@@ -389,9 +421,11 @@ export interface MemProc {
     name: string;
     cmd: string;
     mem: number;
-    group: "deck" | "server" | "agent" | "pane-agent" | "pane";
+    group: "deck" | "server" | "browser" | "agent" | "pane-agent" | "pane";
     /** The language server's session id, or the terminal pane's id. */
     owner: string;
+    /** An agent, or a process in a terminal pane that is not its shell: memKill may stop it. */
+    killable: boolean;
 }
 export interface MemUsage {
     deck: number;
@@ -400,8 +434,15 @@ export interface MemUsage {
     /** Percent of all cores. -1 on the first reading, before there is anything to difference. */
     cpu: number;
     cpu_agents: number;
-    /** Deck minus its language servers. Part of `deck`. */
+    /** Deck minus its language servers and the browser. Part of `deck`. */
     core: number;
+    /** The browser's pages (its own WebView2 profile). Also part of `deck`. */
+    browser: number;
+    /** Browser panes with a live webview, each with its renderers' memory, largest first. */
+    browser_tabs: {
+        pane: string;
+        mem: number;
+    }[];
     /** Running language servers, largest first. Also part of `deck`. */
     servers: MemServer[];
     /** Terminal panes. NOT part of `deck` — informational only. */
@@ -414,6 +455,10 @@ export interface MemUsage {
 }
 /** `detail` also lists every process with its command line: for the open popover, not the poll. */
 export declare const memUsage: (detail?: boolean) => Promise<MemUsage>;
+/** Stop a process the memory popover lists, and what it started. Refused unless `killable`. An agent in a pane is asked to quit first: true when it did, false when it was killed. */
+export declare const memKill: (pid: number) => Promise<boolean>;
+/** Stop the claude or codex running in a terminal pane, as memKill does. */
+export declare const agentStop: (pane: string) => Promise<boolean>;
 export declare const listApps: () => Promise<AppProc[]>;
 export declare const listInstalled: () => Promise<AppProc[]>;
 export declare const runScriptNow: (command: string, args: string[], id?: string, name?: string) => Promise<void>;
@@ -603,11 +648,15 @@ export interface StartupProgram {
 export declare const pickExe: () => Promise<string>;
 export declare const readTermLayout: <T>() => Promise<T | null>;
 /** `mtimeMs` is epoch ms, 0 if unreadable — lets a caller tell a settled file from one still being written. */
+/** One entry of a folder. `size` is bytes (0 for a folder); `hidden` is Windows' hidden attribute,
+ *  or a dot name on a server. */
 export interface FsEntry {
     name: string;
     path: string;
     dir: boolean;
     mtimeMs: number;
+    size: number;
+    hidden: boolean;
 }
 export interface GitStatusRow {
     path: string;
@@ -615,7 +664,19 @@ export interface GitStatusRow {
     letter: string;
     staged: boolean;
 }
-export declare const fsList: (dir: string) => Promise<FsEntry[]>;
+/** One folder level, folders first. `all` includes the build folders (node_modules, target, .git…)
+ *  that a code folder's tree leaves out. */
+export declare const fsList: (dir: string, all?: boolean) => Promise<FsEntry[]>;
+/** A drive of this PC (`C:\`): its label, kind, and size and free space in bytes (0 for a network drive or a disc). */
+export interface Drive {
+    path: string;
+    label: string;
+    kind: "fixed" | "removable" | "network" | "cd";
+    total: number;
+    free: number;
+}
+/** The drives Windows has. A one-off read, never for a poll. */
+export declare const fsDrives: () => Promise<Drive[]>;
 /** `%APPDATA%\Deck\plugins` (Deck-Dev in a debug build), created on first call. */
 export declare const pluginsDir: () => Promise<string>;
 /** `%APPDATA%\Deck\languages` (Deck-Dev in a debug build), created on first call. */
@@ -691,6 +752,7 @@ export declare const backupRestore: (path: string) => Promise<BackupSummary>;
 export interface RemoteFile {
     url: string;
     sha256: string;
+    bytes?: number;
 }
 /**
  * Install a plugin or a language definition from the registry.

package/types/core/browser.d.ts

@@ -36,6 +36,24 @@ export interface BrowserState {
     rotated: boolean;
     /** Devices shown side by side (DeviceBar), the first in the pane's own webview; [] for one. */
     devices: string[];
+    /** The page is not running: asleep after being out of sight, or put away from the memory
+     *  readout. It wakes, or opens again, when the tab is shown. */
+    asleep: boolean;
+    /** The page's process crashed ("exited") or hangs ("unresponsive"); "" while it runs. */
+    crashed: "" | "exited" | "unresponsive";
+    /** An app link the page asked to open (mailto:, zoommtg:), and the site that asked, while the
+     *  pane's bar waits for an answer; "" otherwise. */
+    appLink: string;
+    appOrigin: string;
+    /** A site's request to send notifications, waiting for the pane's bar (0 for none), and the site. */
+    permAsk: number;
+    permOrigin: string;
+    /** A site's sign-in or certificate error waiting for the address bar (0 for none): which, the
+     *  address, and the realm or WebView2's error status. */
+    siteAsk: number;
+    siteKind: "" | "auth" | "cert";
+    siteUri: string;
+    siteDetail: string;
 }
 export declare const subscribeBrowser: (f: () => void) => () => void;
 export declare const browserState: (pane: string) => BrowserState | undefined;
@@ -73,6 +91,19 @@ export declare const totalBlocked: () => number;
 export declare const myFilters: () => Promise<string>;
 /** Save them, and put them to work. */
 export declare function saveMyFilters(text: string): Promise<void>;
+/** The address bar's answer to a site's sign-in or certificate error. */
+export declare function answerSite(pane: string, a: {
+    user?: string;
+    password?: string;
+    proceed?: boolean;
+}): void;
+/** The pane's bar: let the site send notifications, or not. */
+export declare function answerPermission(pane: string, allow: boolean): void;
+/** The pane's bar: open the app link it asked for, and with `always` for that site from now on. */
+export declare function openAppLink(pane: string, always: boolean): Promise<void>;
+export declare const dismissAppLink: (pane: string) => void;
+/** "Wait" on a page that hangs: the bar goes, and comes back if WebView2 reports it again. */
+export declare const dismissCrash: (pane: string) => void;
 /** Lay the pane's page out as a device (DeviceBar's ids), or as itself (""). */
 export declare const setDevice: (pane: string, device: string) => void;
 export declare const setRotated: (pane: string, rotated: boolean) => void;
@@ -186,4 +217,6 @@ export declare function noteTermOutput(pane: string, chunk: string): void;
 export declare function forgetTermPane(pane: string): void;
 /** Where a pane's page is on screen, in Deck's CSS pixels, while it shows one. */
 export declare const pageBox: (pane: string) => DOMRect | null;
+/** Close the pane's webview to give back its memory, keeping the tab and its address. */
+export declare function discardBrowserPane(pane: string): Promise<void>;
 export declare function trackBrowser(pane: string, el: HTMLElement, url: string): () => void;

package/types/core/fileview.d.ts

@@ -24,6 +24,7 @@ export declare const normaliseExts: (exts: unknown) => string[];
  */
 export declare const fileOpeners: {
     id: string;
+    name: string;
     exts: string[];
 }[];
 /** The id of the plugin that opens `path` (by its extension), or undefined: the Editor's. */
@@ -52,3 +53,16 @@ export declare const fileUrl: (path: string) => string;
  * Editor, which the caller opens it in. Every way Deck opens a file asks this first.
  */
 export declare function openByType(path: string, hint?: Opener): boolean;
+/**
+ * Everywhere `path` can open in Deck, for an Open with menu: the Editor, the browser (its types,
+ * on this PC), and each plugin that opens its type, named for the menu.
+ */
+export declare function openersFor(path: string): {
+    to: Opener;
+    label: string;
+}[];
+/**
+ * Open `path` in `to` whatever the Files tab says, for an Open with menu. False for the Editor,
+ * which the caller opens it in (terminals' openInEditor).
+ */
+export declare function openIn(path: string, to: Opener): boolean;

package/types/core/keys.d.ts

@@ -10,7 +10,7 @@
  * It is also what lets two bindings share a chord honestly — the editor's save and a terminal
  * action can both be Ctrl+S if the two surfaces never have the keyboard at the same time.
  */
-export type Scope = "app" | "workspaces" | "editor" | "terminal" | `plugin:${string}`;
+export type Scope = "app" | "workspaces" | "editor" | "terminal" | "browser" | "markdown" | `plugin:${string}`;
 /** Which thing owns the chord. Absent means a plain window listener. */
 export type Surface = "monaco" | "xterm" | "codemirror";
 export interface KeyBinding {
@@ -65,6 +65,14 @@ export declare function conflict(bindings: readonly KeyBinding[], overrides: Ove
 export declare function scopeActive(scope: Scope, active: ReadonlySet<Scope>): boolean;
 /** The binding to run for an event, or null. Scope-aware, so the caller need not filter. */
 export declare function match(bindings: readonly KeyBinding[], overrides: Overrides, e: Parameters<typeof parseChord>[0], active: ReadonlySet<Scope>): KeyBinding | null;
+/**
+ * The bindings in the order a key looks for its owner: every other scope before "app".
+ *
+ * "app" is always live, so if it came first in table order a pane's own binding for the same chord
+ * could never run: the PDF viewer's Ctrl+= zoomed the window, and F11 went to full screen when
+ * the debugger was paused on Step Into. The narrower scope is on screen to be asked first.
+ */
+export declare function byScope(bindings: readonly KeyBinding[]): KeyBinding[];
 /**
  * A chord as Monaco's keycode bitmask, or null when Monaco has no code for it.
  *

package/types/core/keystore.d.ts

@@ -20,6 +20,36 @@ export declare function resetOverrides(): Promise<void>;
 export declare function useKeybindings(): number;
 /** The chord in force for a binding, for a label or a tooltip. */
 export declare function chordFor(id: string): string;
+/** The same, as a person reads it ("Ctrl+B"), for a tooltip or a menu hint; "" when unbound. */
+export declare function keyOf(id: string): string;
+/** A tooltip with the key in force after it: "Go back (Alt+←)", or the label alone when unbound. */
+export declare function withKey(label: string, id: string): string;
+/**
+ * Bind a registry binding inside one Monaco editor, and follow it when it is rebound in Settings.
+ *
+ * Monaco takes its keys before Deck's listener sees them, so a chord it hosts (Save) has to be
+ * handed to it. A one-off `addCommand` read the chord once, at mount: a rebind only reached the
+ * editors opened after it. An action can be disposed, so this swaps it whenever the chord changes.
+ * `monaco` is passed in so this file does not pull in monaco-editor. Returns the cleanup.
+ */
+export declare function bindMonacoKey(ed: {
+    addAction(a: {
+        id: string;
+        label: string;
+        keybindings: number[];
+        run: () => void | Promise<void>;
+    }): {
+        dispose(): void;
+    };
+}, monaco: {
+    KeyMod: {
+        CtrlCmd: number;
+        Alt: number;
+        Shift: number;
+        WinCtrl: number;
+    };
+    KeyCode: object;
+}, id: string, run: () => void | Promise<void>): () => void;
 /**
  * An action, or an action with a `when` guard.
  *