deck-plugin-sdk 1.17.2 → 1.17.3

package/package.json

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

package/shim/terminals.js

@@ -14,6 +14,7 @@ const t = () => {
 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 activeWorkspaceFolders = (...a) => t().activeWorkspaceFolders(...a);
 export const addTabToZone = (...a) => t().addTabToZone(...a);
 export const addToGroup = (...a) => t().addToGroup(...a);
 export const agentSessions = (...a) => t().agentSessions(...a);
@@ -95,6 +96,7 @@ export const useAgentPanesVersion = (...a) => t().useAgentPanesVersion(...a);
 export const useLayout = (...a) => t().useLayout(...a);
 export const webglLimit = (...a) => t().webglLimit(...a);
 export const workspaceByCwd = (...a) => t().workspaceByCwd(...a);
+export const workspaceHolding = (...a) => t().workspaceHolding(...a);
 export const workspaceShellCount = (...a) => t().workspaceShellCount(...a);
 export const zoneAt = (...a) => t().zoneAt(...a);
 export const zoneBoardFull = (...a) => t().zoneBoardFull(...a);

package/template/plugin.json

@@ -5,6 +5,6 @@
   "icon": "Sparkles",
   "color": "#a78bfa",
   "version": "0.1.0",
-  "minDeck": "1.17.2",
+  "minDeck": "1.17.3",
   "permissions": []
 }

package/types/core/app/teamkeys.d.ts

@@ -0,0 +1,31 @@
+// GENERATED by sdk/gen-types.mjs from Deck's source — do not edit.
+import type { MemberList } from "./teams";
+/** A team's size, and how long a name may be: past these a list is not even looked at. */
+export declare const MAX_MEMBERS = 200;
+export declare const MAX_NAME = 60;
+export declare const cleanName: (v: unknown) => string;
+export declare const subtle: () => SubtleCrypto;
+export declare const enc: TextEncoder, dec: TextDecoder;
+export declare const b64: (b: ArrayBuffer | Uint8Array) => string;
+export declare const unb64: (s: string) => Uint8Array<ArrayBuffer>;
+export declare const hex: (b: ArrayBuffer | Uint8Array) => string;
+export declare const random: (n: number) => Uint8Array<ArrayBuffer>;
+export declare const ECDSA: {
+    readonly name: "ECDSA";
+    readonly namedCurve: "P-256";
+};
+export declare const SIG: {
+    readonly name: "ECDSA";
+    readonly hash: "SHA-256";
+};
+export declare const ECDH: {
+    readonly name: "ECDH";
+    readonly namedCurve: "P-256";
+};
+/** A member's id: the first half of the hash of their public key. */
+export declare function idOf(pub: string): Promise<string>;
+export declare function verify(pub: string, text: string, sig: string): Promise<boolean>;
+/** What the owner signs: every field but the signature, in one fixed order. */
+export declare const canon: (l: MemberList) => string;
+/** Whether a list is the owner's own: signed by them, for this team, with ids that match the keys. */
+export declare function validList(l: MemberList, ownerPub?: string): Promise<boolean>;

package/types/core/app/teams.d.ts

@@ -1,5 +1,6 @@
 // GENERATED by sdk/gen-types.mjs from Deck's source — do not edit.
 import { share, type Json, type RoomLike, type P2pShare } from "./p2pshare";
+export { idOf, validList } from "./teamkeys";
 export type Member = {
     id: string;
     pub: string;
@@ -64,10 +65,6 @@ export interface TeamDeps {
 export declare function _setTeamDeps(d: Partial<TeamDeps>): void;
 /** A short code for an identity, to read out and compare: whoever invites shows theirs, whoever joins sees it. */
 export declare const fingerprint: (id: string) => string;
-/** A member's id: the first half of the hash of their public key. */
-export declare function idOf(pub: string): Promise<string>;
-/** Whether a list is the owner's own: signed by them, for this team, with ids that match the keys. */
-export declare function validList(l: MemberList, ownerPub?: string): Promise<boolean>;
 /** A plugin's line to a team: its messages, only to and from checked members. */
 export declare function teamChannel<T extends Json>(teamId: string, app: string, on: ChannelHandlers<T>): TeamChannel<T>;
 export declare function teamsView(): TeamView[];
@@ -119,4 +116,3 @@ export declare function joinTeam(code: string): Promise<{
     share: P2pShare<InviteMsg>;
     done: Promise<TeamOffer>;
 }>;
-export {};

package/types/core/app/theme.d.ts

@@ -2,7 +2,7 @@
 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";
+export type BgPreset = "black" | "slate" | "warm" | "midnight" | "charcoal" | "nord" | "plum" | "dracula" | "forest" | "light" | "sand" | "solarizedLight" | "snow";
 /** A preset, or "custom": the user's own colours, from `customTheme`. */
 export type Background = BgPreset | "custom";
 /**
@@ -30,8 +30,9 @@ export declare const ACCENTS: Record<AccentColor, {
     base: string;
     strong: string;
 }>;
-/** The five-step neutral ramp, darkest surface first. Borders come from white alpha, so they
- *  work across all three without per-preset values. */
+/** The five-step neutral ramp: the window, the side panels, the content, the controls on it, a
+ *  hover. Borders and hovers are a wash of the text colour (applyTheme), so they work on every one.
+ *  A light preset sets its own dark text; the dark ones share PRESET_TEXT. */
 export declare const BG_PRESETS: Record<BgPreset, {
     label: string;
     app: string;
@@ -40,6 +41,8 @@ export declare const BG_PRESETS: Record<BgPreset, {
     elev: string;
     hover: string;
     muted: string;
+    text?: string;
+    textSecondary?: string;
 }>;
 /** Density scales the type ramp and the shared radii — the two things that set how much fits
  *  on screen without touching any component's own padding. */
@@ -80,12 +83,15 @@ export declare const DEFAULT_APPEARANCE: {
     bgPreset: Background;
     density: Density;
 };
-export type TermTheme = "match" | "deck" | "dark" | "dimmed" | "solarized" | "custom";
+export type TermTheme = "match" | "deck" | "dark" | "dimmed" | "solarized" | "light" | "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;
+/** ANSI colours that read on a light background (VS Code's light terminal): xterm's yellow and
+ *  white are near-invisible there. */
+export declare const LIGHT_ANSI: Ansi;
 /** A custom terminal theme: every colour, each "#rrggbb". */
 export interface TermCustom {
     background: string;
@@ -102,6 +108,7 @@ export declare const TERM_THEMES: Record<Exclude<TermTheme, "match" | "custom">,
     foreground: string;
     cursor: string;
     selectionBackground: string;
+    ansi?: Ansi;
 }>;
 /** The label a theme shows in the picker, including the derived "match" entry. */
 export declare const TERM_THEME_LABELS: Record<TermTheme, string>;

package/types/core/workspaces/folders.d.ts

@@ -0,0 +1,48 @@
+// GENERATED by sdk/gen-types.mjs from Deck's source — do not edit.
+/** The fields this needs, so it reads a LayoutWorkspace without importing layout.ts. */
+interface HasFolders {
+    cwd: string;
+    folders?: string[];
+}
+/** Every folder of a workspace, the main one first, each once. The main one may be "" (home). */
+export declare function foldersOf(ws: HasFolders): string[];
+/** Whether two spellings name the same folder (case, slashes, a trailing slash aside). */
+export declare const sameFolder: (a: string, b: string) => boolean;
+/** Whether a workspace has more than its main folder. */
+export declare const isMultiRoot: (ws: HasFolders) => boolean;
+/**
+ * The folder of `folders` that holds `path`: the deepest, so a folder inside another wins for its
+ * own files. Undefined when none does. Case and slashes do not matter; "" (home) holds nothing here.
+ */
+export declare function folderOf(folders: readonly string[], path: string): string | undefined;
+/** A path relative to the folder holding it, with that folder's name first when there are several. */
+export declare function relIn(folders: readonly string[], path: string): string;
+/**
+ * A folder's name as the tree and menus show it: its last segment, with its parent's when another
+ * folder of the workspace has the same last segment (two "app" folders read "shop/app", "blog/app").
+ */
+export declare function folderLabel(folders: readonly string[], folder: string): string;
+/** Why a folder cannot be added, or null when it can: already in, or inside (or holding) one that is. A
+ *  folder on a server (remotepath.ts) may join, and a server's workspace may take local folders. */
+export declare function cannotAdd(ws: HasFolders, dir: string): string | null;
+/** The workspace with `dir` added beside its folders (unchanged when it cannot be). */
+export declare function withFolder<W extends HasFolders>(ws: W, dir: string): W;
+/** The workspace without `dir`. The main folder stays: the session and the name hang on it. */
+export declare function withoutFolder<W extends HasFolders>(ws: W, dir: string): W;
+interface Mergeable extends HasFolders {
+    id: string;
+    tabs: {
+        root: unknown;
+        x?: number;
+        y?: number;
+    }[];
+    groups?: unknown[];
+}
+/**
+ * `from` folded into `into`: its folders join (its main one first), its tabs and groups move over,
+ * and every pane keeps running where it did: a pane that followed `from`'s main folder now names it
+ * as its own. Tabs lose their board place so they are laid out after `into`'s. `into` keeps its
+ * name, main folder and session.
+ */
+export declare function mergedInto<W extends Mergeable>(into: W, from: W): W;
+export {};

package/types/core/workspaces/layout.d.ts

@@ -7,6 +7,7 @@ export type LayoutNode = {
     id: string;
     label?: string;
     view?: string;
+    cwd?: string;
 } | {
     kind: "split";
     dir: SplitDir;
@@ -63,6 +64,8 @@ export interface LayoutWorkspace {
     cwd: string;
     tabs: LayoutTab[];
     activeTab: string;
+    /** More folders beside `cwd`, its main one (core/workspaces/folders.ts). Absent: just the one. */
+    folders?: string[];
     /** Tab groups: a name and colour over tabs that sit together in a zone's row, folded or not. */
     groups?: TabGroup[];
     /** Its colour on the sidebar's collapsed rail, by index (Terminals' TONES); none picks one from the name. */
@@ -116,8 +119,18 @@ export declare function activeWorkspaceCwd(): string;
 export declare function switchWorkspace(wsId: string, tabId?: string): void;
 /** The workspace whose cwd matches (case/slash-insensitive), for routing an agent hook to a tab. */
 export declare function workspaceByCwd(cwd: string): LayoutWorkspace | undefined;
-/** The folder a pane's shell was spawned in — its workspace's cwd. */
+/** The folder a pane's shell was spawned in: its own (one of the workspace's folders), else the workspace's. */
 export declare function paneCwd(paneId: string): string;
+/** The active workspace's folders, its main one first (folders.ts). */
+export declare const activeWorkspaceFolders: () => string[];
+/** The folder of the active workspace holding `path` (the deepest), else its main one: a language
+ *  server's boundary and git's folder for that file. */
+export declare const workspaceFolderFor: (path: string) => string;
+/** Where to run git for a file, and its path from there: the workspace folder holding it, or (a file
+ *  outside every folder) the main folder and the path the editor already has. */
+export declare function gitSpotFor(path: string, fallbackRel: string): [string, string];
+/** The workspace one of whose folders is `dir`, the main folder first: workspaceByCwd for every folder. */
+export declare function workspaceHolding(dir: string): LayoutWorkspace | undefined;
 /**
  * A pane's display name: its own label, else the title of the tab holding it.
  *
@@ -141,7 +154,7 @@ export declare const termSweepScrollback: (keep: string[]) => Promise<number>;
 export declare const termScrollback: (id: string) => Promise<string>;
 export declare const newLeaf: () => LayoutNode;
 export declare function leafIds(n: LayoutNode): string[];
-export declare function splitLeaf(n: LayoutNode, id: string, dir: SplitDir, ratio?: number, view?: string): LayoutNode;
+export declare function splitLeaf(n: LayoutNode, id: string, dir: SplitDir, ratio?: number, view?: string, cwd?: string): LayoutNode;
 export declare function setLeafLabel(n: LayoutNode, id: string, label: string): LayoutNode;
 /**
  * Turn a pane into a view, or back into a terminal when `view` is empty.

package/types/core/workspaces/terminals.d.ts

@@ -2,7 +2,7 @@
 import { Terminal } from "@xterm/xterm";
 import { FitAddon } from "@xterm/addon-fit";
 import { LayoutWorkspace } from "./layout";
-export { publishLayout, getLayout, loadLayoutOnce, mutateLayout, useLayout, activeWorkspaceCwd, switchWorkspace, workspaceByCwd, paneCwd, paneLabel, paneLocation, termSpawn, termWrite, termResize, termKill, termList, termSweepScrollback, termScrollback, leafIds, splitLeaf, setLeafLabel, setLeafView, closeLeaf, findLeaf, insertBeside, moveLeaf, openTabInWorkspace } from "./layout";
+export { publishLayout, getLayout, loadLayoutOnce, mutateLayout, useLayout, activeWorkspaceCwd, activeWorkspaceFolders, switchWorkspace, workspaceByCwd, workspaceHolding, paneCwd, paneLabel, paneLocation, termSpawn, termWrite, termResize, termKill, termList, termSweepScrollback, termScrollback, leafIds, splitLeaf, setLeafLabel, setLeafView, closeLeaf, findLeaf, insertBeside, moveLeaf, openTabInWorkspace } from "./layout";
 export type { SplitDir, LayoutNode, LayoutTab, LayoutWorkspace, FloatBounds, Layout, DropSide } from "./layout";
 export { ZONE_BOARD, zoneAt, zones, zoneOf, zoneToward, moveZone, reorderTab, GROUP_COLORS, addToGroup, leaveGroup, moveGroup, toggleGroupFold, ungroup, setGroup, openActiveGroup, pruneGroups, moveTabToZone, addTabToZone, reopenTab, showActiveTab, nextActiveAfterClose, setTabWindow, mergeWindow, dockWindow, nextZoneSpot, zoneBoardFull } from "./zones";
 export type { Zone, TabGroup } from "./zones";