deck-plugin-sdk 0.18.0 → 0.21.0

package/package.json

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

package/shim/bridge.js

@@ -34,6 +34,9 @@ export const fsCopy = (...a) => b().fsCopy(...a);
 export const fsCreateDir = (...a) => b().fsCreateDir(...a);
 export const fsCreateFile = (...a) => b().fsCreateFile(...a);
 export const fsDelete = (...a) => b().fsDelete(...a);
+export const fsFiles = (...a) => b().fsFiles(...a);
+export const fsFind = (...a) => b().fsFind(...a);
+export const fsHash = (...a) => b().fsHash(...a);
 export const fsHomeDir = (...a) => b().fsHomeDir(...a);
 export const fsList = (...a) => b().fsList(...a);
 export const fsMove = (...a) => b().fsMove(...a);
@@ -46,6 +49,8 @@ export const fsReveal = (...a) => b().fsReveal(...a);
 export const fsSaveUnique = (...a) => b().fsSaveUnique(...a);
 export const fsSearch = (...a) => b().fsSearch(...a);
 export const fsSize = (...a) => b().fsSize(...a);
+export const fsThumbnail = (...a) => b().fsThumbnail(...a);
+export const fsTrash = (...a) => b().fsTrash(...a);
 export const fsWrite = (...a) => b().fsWrite(...a);
 export const fsWriteBytes = (...a) => b().fsWriteBytes(...a);
 export const getAutostart = (...a) => b().getAutostart(...a);
@@ -86,6 +91,7 @@ export const gitMerge = (...a) => b().gitMerge(...a);
 export const gitMergeAs = (...a) => b().gitMergeAs(...a);
 export const gitMergeBase = (...a) => b().gitMergeBase(...a);
 export const gitPendingOp = (...a) => b().gitPendingOp(...a);
+export const gitPoll = (...a) => b().gitPoll(...a);
 export const gitPull = (...a) => b().gitPull(...a);
 export const gitPullRebase = (...a) => b().gitPullRebase(...a);
 export const gitPush = (...a) => b().gitPush(...a);
@@ -116,6 +122,8 @@ export const gitTagDeleteRemote = (...a) => b().gitTagDeleteRemote(...a);
 export const gitTagPush = (...a) => b().gitTagPush(...a);
 export const gitUndoCommit = (...a) => b().gitUndoCommit(...a);
 export const gitUnstage = (...a) => b().gitUnstage(...a);
+export const glabApi = (...a) => b().glabApi(...a);
+export const glabRun = (...a) => b().glabRun(...a);
 export const googleAccount = (...a) => b().googleAccount(...a);
 export const googleSignIn = (...a) => b().googleSignIn(...a);
 export const googleSignOut = (...a) => b().googleSignOut(...a);
@@ -137,6 +145,7 @@ export const listApps = (...a) => b().listApps(...a);
 export const listInstalled = (...a) => b().listInstalled(...a);
 export const mailCached = (...a) => b().mailCached(...a);
 export const mailRefresh = (...a) => b().mailRefresh(...a);
+export const mediaMeta = (...a) => b().mediaMeta(...a);
 export const mediaSetNowPlaying = (...a) => b().mediaSetNowPlaying(...a);
 export const mediaSetPlayback = (...a) => b().mediaSetPlayback(...a);
 export const memUsage = (...a) => b().memUsage(...a);
@@ -171,11 +180,13 @@ export const readTermLayout = (...a) => b().readTermLayout(...a);
 export const readTrackMeta = (...a) => b().readTrackMeta(...a);
 export const removeClaudeHooks = (...a) => b().removeClaudeHooks(...a);
 export const removeClaudeMcp = (...a) => b().removeClaudeMcp(...a);
+export const removeLanguage = (...a) => b().removeLanguage(...a);
 export const restartApp = (...a) => b().restartApp(...a);
 export const revealInFolder = (...a) => b().revealInFolder(...a);
 export const runScriptNow = (...a) => b().runScriptNow(...a);
 export const sessionList = (...a) => b().sessionList(...a);
 export const setAutostart = (...a) => b().setAutostart(...a);
+export const setDebugTargets = (...a) => b().setDebugTargets(...a);
 export const setVaultRoot = (...a) => b().setVaultRoot(...a);
 export const setWallpaper = (...a) => b().setWallpaper(...a);
 export const setupChecks = (...a) => b().setupChecks(...a);

package/types/components/ConfirmDialog.d.ts

@@ -19,4 +19,4 @@ export interface ConfirmState {
 export declare function ConfirmDialog({ state, onClose }: {
     state: ConfirmState | null;
     onClose: () => void;
-}): import("react").JSX.Element;
+}): import("react").ReactPortal;

package/types/core/bridge.d.ts

@@ -1,4 +1,5 @@
 // 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";
 /** Open a URL in the default browser. */
 export declare const openExternal: (url: string) => Promise<void>;
@@ -8,6 +9,8 @@ export interface AppProc {
     path: string;
 }
 export declare const configRead: (name: string) => Promise<string>;
+/** Raw bytes rather than a JSON argument: a 13.8MB pinboard parsed as JSON on Deck's UI thread
+ *  held every other command up for 200ms per save (see config_write in config.rs). */
 export declare const configWrite: (name: string, json: string) => Promise<void>;
 export declare const getVaultRoot: () => Promise<string>;
 export declare const setVaultRoot: (path: string) => Promise<void>;
@@ -99,6 +102,16 @@ export interface MemServer {
     mem: number;
     pid: number;
 }
+/** One process behind the figures, largest first. Only filled when memUsage(true) asks. */
+export interface MemProc {
+    pid: number;
+    name: string;
+    cmd: string;
+    mem: number;
+    group: "deck" | "server" | "agent" | "pane-agent" | "pane";
+    /** The language server's session id, or the terminal pane's id. */
+    owner: string;
+}
 export interface MemUsage {
     deck: number;
     agents: number;
@@ -116,8 +129,10 @@ export interface MemUsage {
     /** claude running inside a pane. Also not part of `deck`. */
     pane_agents: number;
     pane_agent_count: number;
+    procs: MemProc[];
 }
-export declare const memUsage: () => Promise<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>;
 export declare const listApps: () => Promise<AppProc[]>;
 export declare const listInstalled: () => Promise<AppProc[]>;
 export declare const closeApp: (target: string) => Promise<string>;
@@ -420,6 +435,8 @@ export declare const fsList: (dir: string) => Promise<FsEntry[]>;
 export declare const pluginsDir: () => Promise<string>;
 /** `%APPDATA%\Deck\languages` (Deck-Dev in a debug build), created on first call. */
 export declare const languagesDir: () => Promise<string>;
+/** Delete a language definition's folder (by its folder name). The server and debugger it names stay installed. */
+export declare const removeLanguage: (folder: string) => Promise<void>;
 export declare const fsRead: (path: string) => Promise<string>;
 /** Raw bytes, for a file that is not text — fsRead decodes as UTF-8 and would corrupt it. */
 export declare const fsReadBytes: (path: string) => Promise<Uint8Array<ArrayBuffer>>;
@@ -503,6 +520,8 @@ export declare const procKill: (id: string) => Promise<void>;
 export declare const fsCreateDir: (dir: string, name: string) => Promise<string>;
 export declare const fsRename: (path: string, newName: string) => Promise<string>;
 export declare const fsDelete: (path: string) => Promise<void>;
+/** Move to the Recycle Bin, so it can be restored (fsDelete removes for good). */
+export declare const fsTrash: (path: string) => Promise<void>;
 export declare const fsCopy: (src: string, dstDir: string) => Promise<string>;
 export declare const fsReveal: (path: string) => Promise<void>;
 export declare const installClaudeHooks: () => Promise<void>;
@@ -544,6 +563,11 @@ export interface GitInfo {
     behind: number;
 }
 export declare const gitInfo: (dir: string) => Promise<GitInfo>;
+/** gitStatus and gitInfo in one `git status -b`: what the editor's poll asks for every 3s. */
+export declare const gitPoll: (dir: string) => Promise<{
+    rows: GitStatusRow[];
+    info: GitInfo;
+}>;
 export declare const gitCommit: (dir: string, message: string) => Promise<string>;
 export declare const gitPush: (dir: string) => Promise<string>;
 export declare const gitPull: (dir: string) => Promise<string>;
@@ -572,11 +596,13 @@ export interface GraphCommit {
     refs: string[];
 }
 export declare const gitLogGraph: (dir: string, skip: number, rel?: string, refs?: string[]) => Promise<GraphCommit[]>;
+/** `old`: a rename's or copy's path before the commit, which its parent side is read from. */
 export interface CommitFile {
     rel: string;
     letter: string;
     adds: number;
     dels: number;
+    old?: string;
 }
 export declare const gitCommitFiles: (dir: string, hash: string) => Promise<CommitFile[]>;
 export declare const gitShowFile: (dir: string, rev: string, rel: string) => Promise<string>;
@@ -632,11 +658,18 @@ export declare const ghPrThreads: (dir: string, number: number) => Promise<strin
 export declare const ghPrLineComment: (dir: string, number: number, commit: string, path: string, line: number, side: "LEFT" | "RIGHT", body: string) => Promise<string>;
 export declare const ghThreadReply: (dir: string, thread: string, body: string) => Promise<string>;
 export declare const ghThreadResolve: (dir: string, thread: string, resolve: boolean) => Promise<string>;
+/** The GitLab CLI, `glab mr …` only. Rejects with "glab-missing" when glab is not installed. */
+export declare const glabRun: (dir: string, args: string[]) => Promise<string>;
+/**
+ * One GitLab REST request about this repo's merge requests (`projects/:id/merge_requests…` or
+ * `user`). `fields` go as strings; `json` values must be objects or arrays.
+ */
+export declare const glabApi: (dir: string, method: "GET" | "POST" | "PUT", path: string, fields?: [string, string][], json?: Record<string, object>) => Promise<string>;
 /** The files that differ between two revisions. */
 export declare const gitRangeFiles: (dir: string, from: string, to: string) => Promise<CommitFile[]>;
 export declare const gitMergeBase: (dir: string, a: string, b: string) => Promise<string>;
-/** Fetch pull request N's head from `remote`, so its commits can be diffed here. */
-export declare const gitFetchPr: (dir: string, remote: string, number: number, base: string) => Promise<string>;
+/** Fetch pull request N's head from `remote`, so its commits can be diffed here. `gitlab`: a merge request's. */
+export declare const gitFetchPr: (dir: string, remote: string, number: number, base: string, gitlab?: boolean) => Promise<string>;
 export declare const gitBranchRename: (dir: string, from: string, to: string) => Promise<string>;
 export declare const gitPendingOp: (dir: string) => Promise<string>;
 export declare const gitAbortOp: (dir: string, op: string) => Promise<string>;
@@ -671,6 +704,38 @@ export interface SearchOpts {
     includes: string;
     excludes: string;
 }
+/** Every file under `dir` (absolute paths), .gitignore respected — the editor's Ctrl+P. */
+export declare const fsFiles: (dir: string) => Promise<string[]>;
+/** One file `fsFind` found. `mtime` is milliseconds since the epoch. */
+export interface FoundFile {
+    path: string;
+    size: number;
+    mtime: number;
+}
+/**
+ * Every file with one of `exts` (no dot) under `roots`, or under every fixed drive when roots is
+ * null, skipping folders named in `excludeDirs` at any depth and files under `minSize` bytes.
+ * A walk of whole drives takes on the order of a minute.
+ */
+export declare const fsFind: (roots: string[] | null, exts: string[], excludeDirs: string[], minSize: number) => Promise<FoundFile[]>;
+/** Windows' own thumbnail of a file (what Explorer shows), as PNG bytes fitting `size` x `size`.
+ *  Rejects when Windows has none for it. */
+/** What Windows knows about a photo or video (its Properties' Details tab). Absent fields are null. */
+export interface MediaMeta {
+    /** Date taken or recorded, ms since the epoch. */
+    taken: number | null;
+    width: number | null;
+    height: number | null;
+    camera: string | null;
+    lat: number | null;
+    lon: number | null;
+    duration_ms: number | null;
+}
+/** The properties of each path, in order; one that cannot be read comes back all null. */
+export declare const mediaMeta: (paths: string[]) => Promise<MediaMeta[]>;
+/** SHA-256 of each file's contents, in order; null for one that cannot be read. */
+export declare const fsHash: (paths: string[]) => Promise<(string | null)[]>;
+export declare const fsThumbnail: (path: string, size: number) => Promise<Uint8Array<ArrayBuffer>>;
 export declare const fsSearch: (dir: string, query: string, o: SearchOpts) => Promise<SearchHit[]>;
 export declare const fsReplace: (dir: string, query: string, replacement: string, o: SearchOpts, files?: string[], line?: number) => Promise<number>;
 export interface DbQueryResult {
@@ -712,3 +777,11 @@ export declare const dbSchema: (handle: number) => Promise<DbSchema>;
 export declare const sshTunnelOpen: (host: string, remote: string) => Promise<[number, number]>;
 export declare const sshTunnelClose: (id: number) => Promise<void>;
 export declare const sshTunnelList: () => Promise<[number, number][]>;
+/**
+ * Offer programs to the editor's debugger: a plugin that runs something debuggable (the Flutter
+ * plugin's runs) publishes them here, and the Run and Debug panel lists them to attach to. Pass
+ * the plugin's whole current list each time, under its own `source`; an empty list removes it.
+ * See core/debugtargets.ts.
+ */
+export declare const setDebugTargets: (source: string, targets: DebugTarget[]) => void;
+export type { DebugTarget } from "./debugtargets";

package/types/core/debugtargets.d.ts

@@ -0,0 +1,38 @@
+// GENERATED by sdk/gen-types.mjs from Deck's source — do not edit.
+export interface DebugTarget {
+    /** Unique within its source. */
+    id: string;
+    /** What the panel shows: "Attach to netapp (Windows)". */
+    name: string;
+    /** The language whose debug adapter runs it (its language.json `debug` block). */
+    languageId: string;
+    request: "attach" | "launch";
+    /** The adapter's attach or launch arguments, e.g. `{ vmServiceUri }`. */
+    args: Record<string, unknown>;
+    /** Where the program's source is: the adapter's working directory. */
+    cwd: string;
+    /**
+     * The adapter to use when the language's definition names none (a language.json without a
+     * `debug` block). The publisher knows what it runs; Deck does not hardcode any language.
+     */
+    adapter?: {
+        strategy: string;
+        command?: string;
+        module?: string;
+        args?: string[];
+    };
+}
+/**
+ * A language's launch template with the editor's variables filled in, the names VS Code uses in
+ * launch.json: `${file}`, `${fileDirname}`, `${fileBasename}`, `${workspaceFolder}`. Every string
+ * in the template, at any depth; anything else is kept as it is. An unknown variable is left in
+ * place, so a typo shows in what the adapter is sent rather than silently becoming empty.
+ */
+export declare function fillLaunch(template: unknown, vars: {
+    file: string;
+    workspaceFolder: string;
+}): unknown;
+/** Replace one source's targets (an empty list removes them). */
+export declare function setTargets(source: string, targets: DebugTarget[]): void;
+export declare const getTargets: () => DebugTarget[];
+export declare const subscribeTargets: (fn: () => void) => () => void;

package/types/core/editorsettings.d.ts

@@ -17,6 +17,8 @@ export interface EditorSettings {
     indentGuides: boolean;
     bracketPairColorization: boolean;
     stickyScroll: boolean;
+    /** Greyed-out types and parameter names the language server suggests, drawn inline. */
+    inlayHints: "all" | "types" | "parameters" | "off";
     /**
      * Markdown: float the formatting bar over the selection instead of pinning it above the note.
      *
@@ -61,5 +63,7 @@ export declare const GRAPH_FONT_SIZES: number[];
 export declare const DEFAULT_EDITOR_SETTINGS: EditorSettings;
 export declare function updateEditorSettings(patch: Partial<EditorSettings>): void;
 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;
 export declare function monacoOptionsFrom(s: EditorSettings): MonacoNS.editor.IEditorOptions;

package/types/core/monaco.d.ts

@@ -26,6 +26,8 @@ export declare function addSemanticColors(rules: TokenColor[]): void;
  * built-in one rather than silently losing to it.
  */
 export declare function registerExtension(ext: string, languageId: string): void;
+/** Give up every extension a language claimed: its definition was removed. */
+export declare function forgetExtensions(languageId: string): void;
 /**
  * Map a filename to a Monaco language id.
  *

package/types/core/terminals.d.ts

@@ -225,7 +225,9 @@ export declare function moveLeaf(root: LayoutNode, srcId: string, targetId: stri
  * caller wants to type into the pane it just made. Pair it with queueInput: the pane has no PTY
  * until it is attached to a sized element, so anything written before then is dropped.
  */
-export declare function openTabInWorkspace(wsId: string, title: string): string | null;
+export declare function openTabInWorkspace(wsId: string, title: string, opts?: {
+    besideActive?: boolean;
+}): string | null;
 export declare function applyDtCommand(op: string, args: Record<string, unknown>): string | void;
 interface Instance {
     term: Terminal;