deck-plugin-sdk 0.22.0 → 1.2.0

package/build-plugin.mjs

@@ -1,143 +1,150 @@
-// Build a Deck plugin: TSX sources -> one plugin.js Deck can import.
-//
-// The same build Deck's own plugins get, with one difference: the shim is shipped with this
-// package rather than generated, because generating it needs Deck's TypeScript sources and the
-// point of this package is that you do not have them.
-//
-// Why a plugin wants a build step at all: JSX, and ordinary imports across as many files as you
-// like. It is not rebuilding Deck — it is what a VS Code extension does.
-//
-// The shim is the whole trick. Deck hands React, its bridge, `listen`, its icons and its
-// animation library over on `window.__deck`, and esbuild resolves those module names to files
-// that read from there. So your sources import "react" as normal code does, and at run time get
-// DECK'S React — which is not an optimisation but a requirement, since two Reacts in one tree
-// break hooks.
-import { build } from "esbuild";
-import { cpSync, existsSync, readdirSync, readFileSync, rmSync, writeFileSync } from "node:fs";
-import { createRequire } from "node:module";
-import { dirname, join } from "node:path";
-import { fileURLToPath } from "node:url";
-
-const sdk = dirname(fileURLToPath(import.meta.url));
-const require = createRequire(import.meta.url);
-
-/** The module names a plugin may import, and the shipped file each resolves to. */
-function shimMap(shimDir) {
-  return {
-    react: join(shimDir, "react.js"),
-    "deckreact/jsx-runtime": join(shimDir, "jsx-runtime.js"),
-    "@tauri-apps/api/event": join(shimDir, "event.js"),
-    "lucide-react": join(shimDir, "icons.js"),
-    "framer-motion": join(shimDir, "motion.js"),
-  };
-}
-
-/**
- * Build the plugin in `dir`.
- *
- * The shim is copied in rather than imported from node_modules, because a plugin's sources refer
- * to it by relative path (`../shim/bridge.js`) and that has to resolve on disk. Copied on every
- * build so updating the SDK updates the shim, which is the behaviour someone upgrading expects.
- */
-export async function buildPlugin(dir, { entry = "plugin.tsx" } = {}) {
-  const manifestPath = join(dir, "plugin.json");
-  if (!existsSync(manifestPath)) {
-    throw new Error(`no plugin.json in ${dir}`);
-  }
-  const manifest = JSON.parse(readFileSync(manifestPath, "utf8"));
-
-  const shimDir = join(dir, "shim");
-  rmSync(shimDir, { recursive: true, force: true });
-  cpSync(join(sdk, "shim"), shimDir, { recursive: true });
-  // The declarations the shim's .d.ts files point at, as ../types/. Copied beside it for the
-  // same reason: a relative reference has to find something.
-  const typesDir = join(dir, "types");
-  rmSync(typesDir, { recursive: true, force: true });
-  cpSync(join(sdk, "types"), typesDir, { recursive: true });
-
-  // ---- icons and animation, generated per plugin ----
-  //
-  // These two cannot be shipped pre-generated like the rest of the shim. They name only the
-  // exports THIS plugin imports, on purpose: re-exporting the whole package goes through a
-  // module esbuild cannot see into, which defeats tree-shaking — doing that with lucide took a
-  // bundle from 403kb to 640kb, larger than just bundling it.
-  //
-  // Nothing about this needs Deck's source, only the plugin's own and the real package, so it
-  // runs here the same way it runs inside the Deck repository.
-  const sources = readdirSync(join(dir, "src"), { recursive: true })
-    .filter((f) => typeof f === "string" && /\.tsx?$/.test(f))
-    .map((f) => readFileSync(join(dir, "src", f), "utf8"));
-
-  for (const [pkg, file, global] of [
-    ["lucide-react", "icons.js", "icons"],
-    ["framer-motion", "motion.js", "motion"],
-  ]) {
-    const re = new RegExp(String.raw`import\s*\{([^}]*)\}\s*from\s*"${pkg}"`, "g");
-    const names = [...new Set(sources.flatMap((src) => [...src.matchAll(re)]
-      .flatMap((m) => m[1].split(",").map((n) => n.trim().split(/\s+as\s+/)[0]).filter(Boolean))))].sort();
-
-    // Checked against the real package, so a typo fails here rather than as a blank icon at run
-    // time. Only loaded when something is actually imported from it, since framer-motion is an
-    // optional peer dependency.
-    if (names.length) {
-      let real;
-      try { real = require(pkg); }
-      catch { throw new Error(`this plugin imports from "${pkg}" — run: npm i ${pkg}`); }
-      for (const n of names) if (!(n in real)) throw new Error(`${pkg} has no export "${n}"`);
-    }
-
-    writeFileSync(join(shimDir, file), `// GENERATED by the Deck plugin build — do not edit.
-//
-// Deck's ${pkg}, so this plugin does not bundle its own copy. Only the names this plugin
-// imports: naming every export would defeat tree-shaking and make the bundle larger.
-const __src = window.__deck.${global};
-${names.map((n) => `export const ${n} = __src.${n};`).join("\n")}
-`);
-  }
-
-  const shims = shimMap(shimDir);
-
-  await build({
-    entryPoints: [join(dir, "src", entry)],
-    outfile: join(dir, "plugin.js"),
-    bundle: true,
-    format: "esm",
-    target: "es2022",
-    // Nobody reads a plugin bundle; it is loaded by one import() at startup.
-    minify: true,
-    jsx: "automatic",
-    // React comes from Deck, so the automatic runtime must import from the shim rather than a
-    // "react/jsx-runtime" that does not exist here.
-    jsxImportSource: "deckreact",
-    // A .wasm import becomes a Uint8Array inlined in the bundle rather than a sidecar file. A
-    // plugin is installed as plugin.json + plugin.js, so a file beside them would never arrive.
-    loader: { ".wasm": "binary" },
-    // A resolve plugin rather than esbuild's `alias`, which maps package to package while these
-    // point at single files.
-    plugins: [{
-      name: "deck-runtime",
-      setup(b) {
-        const filter = new RegExp(`^(${Object.keys(shims)
-          .map((k) => k.replace(/[/\\^$*+?.()|[\]{}]/g, "\\$&")).join("|")})$`);
-        b.onResolve({ filter }, (a) => ({ path: shims[a.path] }));
-      },
-    }],
-    logLevel: "info",
-  });
-
-  // Optional: only a plugin that brings agent-facing tools has one. Built for node, because the
-  // MCP server runs outside the webview.
-  if (existsSync(join(dir, "src", "mcp.ts"))) {
-    await build({
-      entryPoints: [join(dir, "src", "mcp.ts")],
-      outfile: join(dir, "mcp.js"),
-      platform: "node",
-      format: "esm",
-      target: "node18",
-      bundle: true,
-      logLevel: "info",
-    });
-  }
-
-  return manifest;
-}
+// Build a Deck plugin: TSX sources -> one plugin.js Deck can import.
+//
+// The same build Deck's own plugins get, with one difference: the shim is shipped with this
+// package rather than generated, because generating it needs Deck's TypeScript sources and the
+// point of this package is that you do not have them.
+//
+// Why a plugin wants a build step at all: JSX, and ordinary imports across as many files as you
+// like. It is not rebuilding Deck — it is what a VS Code extension does.
+//
+// The shim is the whole trick. Deck hands React, its bridge, `listen`, its icons and its
+// animation library over on `window.__deck`, and esbuild resolves those module names to files
+// that read from there. So your sources import "react" as normal code does, and at run time get
+// DECK'S React — which is not an optimisation but a requirement, since two Reacts in one tree
+// break hooks.
+import { build } from "esbuild";
+import { cpSync, existsSync, readdirSync, readFileSync, rmSync, writeFileSync } from "node:fs";
+import { createRequire } from "node:module";
+import { dirname, join } from "node:path";
+import { fileURLToPath } from "node:url";
+
+const sdk = dirname(fileURLToPath(import.meta.url));
+const require = createRequire(import.meta.url);
+
+/** The module names a plugin may import, and the shipped file each resolves to. */
+function shimMap(shimDir) {
+  return {
+    react: join(shimDir, "react.js"),
+    "deckreact/jsx-runtime": join(shimDir, "jsx-runtime.js"),
+    // A library compiled with the automatic runtime imports it under its real name.
+    "react/jsx-runtime": join(shimDir, "jsx-runtime.js"),
+    // Deck's react-dom (needs Deck 1.1); only bundled when a plugin or its library imports it.
+    "react-dom": join(shimDir, "react-dom.js"),
+    "@tauri-apps/api/event": join(shimDir, "event.js"),
+    "lucide-react": join(shimDir, "icons.js"),
+    "framer-motion": join(shimDir, "motion.js"),
+  };
+}
+
+/**
+ * Build the plugin in `dir`.
+ *
+ * The shim is copied in rather than imported from node_modules, because a plugin's sources refer
+ * to it by relative path (`../shim/bridge.js`) and that has to resolve on disk. Copied on every
+ * build so updating the SDK updates the shim, which is the behaviour someone upgrading expects.
+ */
+export async function buildPlugin(dir, { entry = "plugin.tsx" } = {}) {
+  const manifestPath = join(dir, "plugin.json");
+  if (!existsSync(manifestPath)) {
+    throw new Error(`no plugin.json in ${dir}`);
+  }
+  const manifest = JSON.parse(readFileSync(manifestPath, "utf8"));
+
+  const shimDir = join(dir, "shim");
+  rmSync(shimDir, { recursive: true, force: true });
+  cpSync(join(sdk, "shim"), shimDir, { recursive: true });
+  // The declarations the shim's .d.ts files point at, as ../types/. Copied beside it for the
+  // same reason: a relative reference has to find something.
+  const typesDir = join(dir, "types");
+  rmSync(typesDir, { recursive: true, force: true });
+  cpSync(join(sdk, "types"), typesDir, { recursive: true });
+
+  // ---- icons and animation, generated per plugin ----
+  //
+  // These two cannot be shipped pre-generated like the rest of the shim. They name only the
+  // exports THIS plugin imports, on purpose: re-exporting the whole package goes through a
+  // module esbuild cannot see into, which defeats tree-shaking — doing that with lucide took a
+  // bundle from 403kb to 640kb, larger than just bundling it.
+  //
+  // Nothing about this needs Deck's source, only the plugin's own and the real package, so it
+  // runs here the same way it runs inside the Deck repository.
+  const sources = readdirSync(join(dir, "src"), { recursive: true })
+    .filter((f) => typeof f === "string" && /\.tsx?$/.test(f))
+    .map((f) => readFileSync(join(dir, "src", f), "utf8"));
+
+  for (const [pkg, file, global] of [
+    ["lucide-react", "icons.js", "icons"],
+    ["framer-motion", "motion.js", "motion"],
+  ]) {
+    const re = new RegExp(String.raw`import\s*\{([^}]*)\}\s*from\s*"${pkg}"`, "g");
+    const names = [...new Set(sources.flatMap((src) => [...src.matchAll(re)]
+      .flatMap((m) => m[1].split(",").map((n) => n.trim().split(/\s+as\s+/)[0]).filter(Boolean))))].sort();
+
+    // Checked against the real package, so a typo fails here rather than as a blank icon at run
+    // time. Only loaded when something is actually imported from it, since framer-motion is an
+    // optional peer dependency.
+    if (names.length) {
+      let real;
+      try { real = require(pkg); }
+      catch { throw new Error(`this plugin imports from "${pkg}" — run: npm i ${pkg}`); }
+      for (const n of names) if (!(n in real)) throw new Error(`${pkg} has no export "${n}"`);
+    }
+
+    writeFileSync(join(shimDir, file), `// GENERATED by the Deck plugin build — do not edit.
+//
+// Deck's ${pkg}, so this plugin does not bundle its own copy. Only the names this plugin
+// imports: naming every export would defeat tree-shaking and make the bundle larger.
+const __src = window.__deck.${global};
+${names.map((n) => `export const ${n} = __src.${n};`).join("\n")}
+`);
+  }
+
+  const shims = shimMap(shimDir);
+
+  await build({
+    entryPoints: [join(dir, "src", entry)],
+    outfile: join(dir, "plugin.js"),
+    bundle: true,
+    format: "esm",
+    target: "es2022",
+    // Nobody reads a plugin bundle; it is loaded by one import() at startup.
+    minify: true,
+    // A package that ships separate builds picks the production one.
+    conditions: ["production"],
+    jsx: "automatic",
+    // React comes from Deck, so the automatic runtime must import from the shim rather than a
+    // "react/jsx-runtime" that does not exist here.
+    jsxImportSource: "deckreact",
+    // A .wasm import becomes a Uint8Array inlined in the bundle rather than a sidecar file. A
+    // plugin is installed as plugin.json + plugin.js, so a file beside them would never arrive.
+    // A .css import becomes its text, for the plugin to inject as a <style>, for the same reason.
+    loader: { ".wasm": "binary", ".css": "text" },
+    // A resolve plugin rather than esbuild's `alias`, which maps package to package while these
+    // point at single files.
+    plugins: [{
+      name: "deck-runtime",
+      setup(b) {
+        const filter = new RegExp(`^(${Object.keys(shims)
+          .map((k) => k.replace(/[/\\^$*+?.()|[\]{}]/g, "\\$&")).join("|")})$`);
+        b.onResolve({ filter }, (a) => ({ path: shims[a.path] }));
+      },
+    }],
+    logLevel: "info",
+  });
+
+  // Optional: only a plugin that brings agent-facing tools has one. Built for node, because the
+  // MCP server runs outside the webview.
+  if (existsSync(join(dir, "src", "mcp.ts"))) {
+    await build({
+      entryPoints: [join(dir, "src", "mcp.ts")],
+      outfile: join(dir, "mcp.js"),
+      platform: "node",
+      format: "esm",
+      target: "node18",
+      bundle: true,
+      logLevel: "info",
+    });
+  }
+
+  return manifest;
+}

package/package.json

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

package/shim/bridge.js

@@ -9,6 +9,7 @@ const b = () => {
   return x;
 };
 
+export const askSudoPassword = (...a) => b().askSudoPassword(...a);
 export const backupExport = (...a) => b().backupExport(...a);
 export const backupInspect = (...a) => b().backupInspect(...a);
 export const backupRestore = (...a) => b().backupRestore(...a);
@@ -130,7 +131,10 @@ export const googleSignOut = (...a) => b().googleSignOut(...a);
 export const googleToken = (...a) => b().googleToken(...a);
 export const historyClear = (...a) => b().historyClear(...a);
 export const historyDelete = (...a) => b().historyDelete(...a);
+export const httpCancel = (...a) => b().httpCancel(...a);
 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 installClaudeHooks = (...a) => b().installClaudeHooks(...a);
 export const installClaudeMcp = (...a) => b().installClaudeMcp(...a);
@@ -174,6 +178,9 @@ export const readMusicSuggestions = (...a) => b().readMusicSuggestions(...a);
 export const readMusicTaste = (...a) => b().readMusicTaste(...a);
 export const readTermLayout = (...a) => b().readTermLayout(...a);
 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 removeClaudeHooks = (...a) => b().removeClaudeHooks(...a);
 export const removeClaudeMcp = (...a) => b().removeClaudeMcp(...a);
 export const removeLanguage = (...a) => b().removeLanguage(...a);
@@ -185,6 +192,7 @@ 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 sshHosts = (...a) => b().sshHosts(...a);
 export const sshTunnelClose = (...a) => b().sshTunnelClose(...a);
 export const sshTunnelList = (...a) => b().sshTunnelList(...a);
 export const sshTunnelOpen = (...a) => b().sshTunnelOpen(...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/react-dom.js

@@ -0,0 +1,19 @@
+// GENERATED by sdk/gen-shim.mjs — do not edit.
+//
+// Deck's react-dom, not a second copy.
+const ReactDOM = window.__deck.ReactDOM;
+export default ReactDOM;
+export const __DOM_INTERNALS_DO_NOT_USE_OR_WARN_USERS_THEY_CANNOT_UPGRADE = ReactDOM.__DOM_INTERNALS_DO_NOT_USE_OR_WARN_USERS_THEY_CANNOT_UPGRADE;
+export const createPortal = ReactDOM.createPortal;
+export const flushSync = ReactDOM.flushSync;
+export const preconnect = ReactDOM.preconnect;
+export const prefetchDNS = ReactDOM.prefetchDNS;
+export const preinit = ReactDOM.preinit;
+export const preinitModule = ReactDOM.preinitModule;
+export const preload = ReactDOM.preload;
+export const preloadModule = ReactDOM.preloadModule;
+export const requestFormReset = ReactDOM.requestFormReset;
+export const unstable_batchedUpdates = ReactDOM.unstable_batchedUpdates;
+export const useFormState = ReactDOM.useFormState;
+export const useFormStatus = ReactDOM.useFormStatus;
+export const version = ReactDOM.version;

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/ui.d.ts

@@ -12,3 +12,13 @@ export * from "../types/components/TreeRow";
 export * from "../types/components/dragrow";
 export * from "../types/components/TabStrip";
 export * from "../types/components/MarkdownToolbar";
+export * from "../types/components/ActivityBar";
+export * from "../types/core/editorsettings";
+export * from "../types/core/keystore";
+export * from "../types/modules/editor/viewers";
+export * from "../types/components/FileIcon";
+export * from "../types/core/icontheme";
+export * from "../types/modules/editor/tree";
+export * from "../types/core/decode";
+export * from "../types/core/keys";
+export * from "../types/modules/editor/MonacoHosts";

package/shim/ui.js

@@ -9,13 +9,21 @@ const u = () => {
   return x;
 };
 
+export const ActivityBar = (...a) => u().ActivityBar(...a);
 export const ConfirmDialog = (...a) => u().ConfirmDialog(...a);
 export const ContextMenu = (...a) => u().ContextMenu(...a);
 export const DayPicker = (...a) => u().DayPicker(...a);
 export const Field = (...a) => u().Field(...a);
+export const FileIcon = (...a) => u().FileIcon(...a);
+export const FontViewer = (...a) => u().FontViewer(...a);
 export const GhostButton = (...a) => u().GhostButton(...a);
+export const ImageViewer = (...a) => u().ImageViewer(...a);
 export const MarkdownLive = (...a) => u().MarkdownLive(...a);
 export const MarkdownToolbar = (...a) => u().MarkdownToolbar(...a);
+export const MediaDiff = (...a) => u().MediaDiff(...a);
+export const MediaViewer = (...a) => u().MediaViewer(...a);
+export const MonacoDiff = (...a) => u().MonacoDiff(...a);
+export const MonacoViewer = (...a) => u().MonacoViewer(...a);
 export const NamePrompt = (...a) => u().NamePrompt(...a);
 export const PanelHead = (...a) => u().PanelHead(...a);
 export const PrimaryButton = (...a) => u().PrimaryButton(...a);
@@ -30,8 +38,47 @@ export const TextInput = (...a) => u().TextInput(...a);
 export const TimeInput = (...a) => u().TimeInput(...a);
 export const Toggle = (...a) => u().Toggle(...a);
 export const TreeRow = (...a) => u().TreeRow(...a);
+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 buildChangeTree = (...a) => u().buildChangeTree(...a);
+export const chordFor = (...a) => u().chordFor(...a);
+export const chordIndex = (...a) => u().chordIndex(...a);
+export const claimedOutsideTerminal = (...a) => u().claimedOutsideTerminal(...a);
 export const cmSurface = (...a) => u().cmSurface(...a);
+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 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 monacoOptionsFrom = (...a) => u().monacoOptionsFrom(...a);
+export const normalizeChord = (...a) => u().normalizeChord(...a);
+export const onKey = (...a) => u().onKey(...a);
+export const onKeys = (...a) => u().onKeys(...a);
+export const parseChord = (...a) => u().parseChord(...a);
+export const parseDirty = (...a) => u().parseDirty(...a);
+export const pushScope = (...a) => u().pushScope(...a);
+export const repoLabel = (...a) => u().repoLabel(...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 statusColor = (...a) => u().statusColor(...a);
+export const subscribeEditorSettings = (...a) => u().subscribeEditorSettings(...a);
+export const themeById = (...a) => u().themeById(...a);
+export const toMonaco = (...a) => u().toMonaco(...a);
 export const toast = (...a) => u().toast(...a);
+export const updateEditorSettings = (...a) => u().updateEditorSettings(...a);
+export const useEditorSettings = (...a) => u().useEditorSettings(...a);
+export const useIconThemesVersion = (...a) => u().useIconThemesVersion(...a);
+export const useKeybindings = (...a) => u().useKeybindings(...a);
+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);

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/ActivityBar.d.ts

@@ -0,0 +1,20 @@
+// GENERATED by sdk/gen-types.mjs from Deck's source — do not edit.
+import type { LucideIcon } from "lucide-react";
+export interface ActivityView<Id extends string> {
+    id: Id;
+    icon: LucideIcon;
+    title: string;
+    /** Small count bubble on the icon. Absolutely positioned, so it never affects layout. */
+    badge?: number;
+    /** Makes this icon a plain action — it opens a menu or dialog instead of switching the panel,
+     *  and never takes the selected state. Receives its own button for anchoring a popup. */
+    onClick?: (el: HTMLElement) => void;
+}
+export default ActivityBar;
+export declare function ActivityBar<Id extends string>({ views, active, onSelect, trailing, }: {
+    views: readonly ActivityView<Id>[];
+    active: Id;
+    onSelect: (id: Id) => void;
+    /** Fixed controls pinned to the right — present for every view, or the icons shift. */
+    trailing?: React.ReactNode;
+}): import("react").JSX.Element;

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/FileIcon.d.ts

@@ -0,0 +1,7 @@
+// GENERATED by sdk/gen-types.mjs from Deck's source — do not edit.
+import { type IconRef } from "../core/icontheme";
+export declare function FileIcon({ icon, size, tint }: {
+    icon: IconRef;
+    size?: number;
+    tint?: string;
+}): import("react").JSX.Element;

package/types/components/TabStrip.d.ts

@@ -12,7 +12,7 @@ export interface TabItem {
     /** Tooltip for the close button; defaults to "Close". */
     closeTitle?: string;
 }
-export declare function TabStrip({ tabs, activeId, onSelect, onClose, onReorder, onDoubleClick, trailing, }: {
+export declare function TabStrip({ tabs, activeId, onSelect, onClose, onReorder, onDoubleClick, trailing, pill, onAdd, addTitle, }: {
     tabs: readonly TabItem[];
     activeId: string | null;
     onSelect: (id: string) => void;
@@ -22,5 +22,11 @@ export declare function TabStrip({ tabs, activeId, onSelect, onClose, onReorder,
     onDoubleClick?: (id: string) => void;
     /** Right-aligned controls after the tabs — view toggles, save state. */
     trailing?: ReactNode;
+    /** Rounded tabs with the active one lit in the accent, the look of the workspace tabs in the
+     *  title bar, instead of the editor-style boxed row. */
+    pill?: boolean;
+    /** A + right after the last tab, as the workspace tabs have. */
+    onAdd?: () => void;
+    addTitle?: string;
 }): import("react").JSX.Element;
 export default TabStrip;

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/useResize.d.ts

@@ -1,4 +1,16 @@
 // GENERATED by sdk/gen-types.mjs from Deck's source — do not edit.
+/**
+ * Whether an element is narrower than `px`, kept current as it resizes.
+ *
+ * A tool can now be a pane of any width, not the whole window, so a layout with a fixed sidebar
+ * asks this about its own box (never the window) and folds the sidebar away when it would leave
+ * the content too little room.
+ *
+ * Returns the answer and a ref callback to put on the element. A callback rather than a ref
+ * object, so the measuring starts whenever the element appears: a component that first renders a
+ * loading state has no element on its first run, and an effect reading a ref then never ran again.
+ */
+export declare function useNarrow(px: number): [boolean, (el: HTMLElement | null) => void];
 /**
  * A draggable split. Returns the size in px, the props for the divider, and whether a drag is
  * in progress — the last so an animated pane can turn its transition off while dragging, or the