deck-plugin-sdk 1.5.0 → 1.6.1

package/package.json

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

package/shim/bridge.js

@@ -10,12 +10,47 @@ const b = () => {
   return x;
 };
 
+export const adblockConfig = (...a) => b().adblockConfig(...a);
+export const adblockInfo = (...a) => b().adblockInfo(...a);
+export const adblockRebuild = (...a) => b().adblockRebuild(...a);
+export const adblockUpdate = (...a) => b().adblockUpdate(...a);
 export const agentClis = (...a) => b().agentClis(...a);
 export const agentMcpStatus = (...a) => b().agentMcpStatus(...a);
 export const askSudoPassword = (...a) => b().askSudoPassword(...a);
 export const backupExport = (...a) => b().backupExport(...a);
 export const backupInspect = (...a) => b().backupInspect(...a);
 export const backupRestore = (...a) => b().backupRestore(...a);
+export const bookmarksBarMode = (...a) => b().bookmarksBarMode(...a);
+export const browserAgentAnswer = (...a) => b().browserAgentAnswer(...a);
+export const browserAgentConfig = (...a) => b().browserAgentConfig(...a);
+export const browserAgentFillAnswer = (...a) => b().browserAgentFillAnswer(...a);
+export const browserBounds = (...a) => b().browserBounds(...a);
+export const browserCapture = (...a) => b().browserCapture(...a);
+export const browserCdp = (...a) => b().browserCdp(...a);
+export const browserClear = (...a) => b().browserClear(...a);
+export const browserClose = (...a) => b().browserClose(...a);
+export const browserDefaultRegister = (...a) => b().browserDefaultRegister(...a);
+export const browserDefaultStatus = (...a) => b().browserDefaultStatus(...a);
+export const browserDevtools = (...a) => b().browserDevtools(...a);
+export const browserDownload = (...a) => b().browserDownload(...a);
+export const browserFind = (...a) => b().browserFind(...a);
+export const browserHistoryCount = (...a) => b().browserHistoryCount(...a);
+export const browserHistoryForgetRange = (...a) => b().browserHistoryForgetRange(...a);
+export const browserHistoryForgetUrl = (...a) => b().browserHistoryForgetUrl(...a);
+export const browserHistoryList = (...a) => b().browserHistoryList(...a);
+export const browserHistoryRecent = (...a) => b().browserHistoryRecent(...a);
+export const browserHistorySuggest = (...a) => b().browserHistorySuggest(...a);
+export const browserHistoryVisit = (...a) => b().browserHistoryVisit(...a);
+export const browserMute = (...a) => b().browserMute(...a);
+export const browserNav = (...a) => b().browserNav(...a);
+export const browserOpen = (...a) => b().browserOpen(...a);
+export const browserPermissionSet = (...a) => b().browserPermissionSet(...a);
+export const browserPermissions = (...a) => b().browserPermissions(...a);
+export const browserPrivacy = (...a) => b().browserPrivacy(...a);
+export const browserSetKeys = (...a) => b().browserSetKeys(...a);
+export const browserSite = (...a) => b().browserSite(...a);
+export const browserSiteClear = (...a) => b().browserSiteClear(...a);
+export const browserZoom = (...a) => b().browserZoom(...a);
 export const claudePlanLimits = (...a) => b().claudePlanLimits(...a);
 export const claudeUsage = (...a) => b().claudeUsage(...a);
 export const clearWallpaper = (...a) => b().clearWallpaper(...a);
@@ -28,9 +63,18 @@ export const dbConnect = (...a) => b().dbConnect(...a);
 export const dbDisconnect = (...a) => b().dbDisconnect(...a);
 export const dbQuery = (...a) => b().dbQuery(...a);
 export const dbSchema = (...a) => b().dbSchema(...a);
+export const deckReady = (...a) => b().deckReady(...a);
 export const deleteIconPack = (...a) => b().deleteIconPack(...a);
 export const dirsDownload = (...a) => b().dirsDownload(...a);
 export const exec = (...a) => b().exec(...a);
+export const extensionInstallFolder = (...a) => b().extensionInstallFolder(...a);
+export const extensionInstallStore = (...a) => b().extensionInstallStore(...a);
+export const extensionPopup = (...a) => b().extensionPopup(...a);
+export const extensionPopupClose = (...a) => b().extensionPopupClose(...a);
+export const extensionReload = (...a) => b().extensionReload(...a);
+export const extensionRemove = (...a) => b().extensionRemove(...a);
+export const extensionSetEnabled = (...a) => b().extensionSetEnabled(...a);
+export const extensionsList = (...a) => b().extensionsList(...a);
 export const footerOrder = (...a) => b().footerOrder(...a);
 export const fsCopy = (...a) => b().fsCopy(...a);
 export const fsCreateDir = (...a) => b().fsCreateDir(...a);
@@ -97,6 +141,7 @@ export const installFromRegistry = (...a) => b().installFromRegistry(...a);
 export const isFullscreen = (...a) => b().isFullscreen(...a);
 export const languagesDir = (...a) => b().languagesDir(...a);
 export const launchFiles = (...a) => b().launchFiles(...a);
+export const launchUrls = (...a) => b().launchUrls(...a);
 export const listApps = (...a) => b().listApps(...a);
 export const listInstalled = (...a) => b().listInstalled(...a);
 export const logLatest = (...a) => b().logLatest(...a);
@@ -138,6 +183,26 @@ export const sshTunnelClose = (...a) => b().sshTunnelClose(...a);
 export const sshTunnelOpen = (...a) => b().sshTunnelOpen(...a);
 export const startupMarks = (...a) => b().startupMarks(...a);
 export const toggleFullscreen = (...a) => b().toggleFullscreen(...a);
+export const vaultChangePassword = (...a) => b().vaultChangePassword(...a);
+export const vaultConfig = (...a) => b().vaultConfig(...a);
+export const vaultCreate = (...a) => b().vaultCreate(...a);
+export const vaultDelete = (...a) => b().vaultDelete(...a);
+export const vaultExport = (...a) => b().vaultExport(...a);
+export const vaultFill = (...a) => b().vaultFill(...a);
+export const vaultFillNew = (...a) => b().vaultFillNew(...a);
+export const vaultGenerate = (...a) => b().vaultGenerate(...a);
+export const vaultImport = (...a) => b().vaultImport(...a);
+export const vaultList = (...a) => b().vaultList(...a);
+export const vaultLock = (...a) => b().vaultLock(...a);
+export const vaultMatches = (...a) => b().vaultMatches(...a);
+export const vaultNeverList = (...a) => b().vaultNeverList(...a);
+export const vaultNeverRemove = (...a) => b().vaultNeverRemove(...a);
+export const vaultOfferAnswer = (...a) => b().vaultOfferAnswer(...a);
+export const vaultSave = (...a) => b().vaultSave(...a);
+export const vaultSecret = (...a) => b().vaultSecret(...a);
+export const vaultStatus = (...a) => b().vaultStatus(...a);
+export const vaultTotp = (...a) => b().vaultTotp(...a);
+export const vaultUnlock = (...a) => b().vaultUnlock(...a);
 export const vpsRunsPull = (...a) => b().vpsRunsPull(...a);
 export const watchFiles = (...a) => b().watchFiles(...a);
 

package/shim/ui.d.ts

@@ -6,6 +6,7 @@ export * from "../types/components/ConfirmDialog";
 export * from "../types/components/NamePrompt";
 export * from "../types/components/ContextMenu";
 export * from "../types/components/Toast";
+export * from "../types/core/notifyapi";
 export * from "../types/components/useResize";
 export * from "../types/modules/editor/MarkdownLive";
 export * from "../types/components/TreeRow";

package/shim/ui.js

@@ -10,13 +10,17 @@ const u = () => {
 };
 
 export const ActivityBar = (...a) => u().ActivityBar(...a);
+export const Chip = (...a) => u().Chip(...a);
 export const ConfirmDialog = (...a) => u().ConfirmDialog(...a);
 export const ContextMenu = (...a) => u().ContextMenu(...a);
+export const CountChip = (...a) => u().CountChip(...a);
 export const DayPicker = (...a) => u().DayPicker(...a);
+export const EmptyState = (...a) => u().EmptyState(...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 IconButton = (...a) => u().IconButton(...a);
 export const ImageViewer = (...a) => u().ImageViewer(...a);
 export const MarkdownLive = (...a) => u().MarkdownLive(...a);
 export const MarkdownToolbar = (...a) => u().MarkdownToolbar(...a);
@@ -50,6 +54,7 @@ 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 dismissNotification = (...a) => u().dismissNotification(...a);
 export const dispatch = (...a) => u().dispatch(...a);
 export const forLanguage = (...a) => u().forLanguage(...a);
 export const formatChord = (...a) => u().formatChord(...a);
@@ -60,6 +65,7 @@ export const mediaKind = (...a) => u().mediaKind(...a);
 export const modelOptionsFor = (...a) => u().modelOptionsFor(...a);
 export const monacoOptionsFrom = (...a) => u().monacoOptionsFrom(...a);
 export const normalizeChord = (...a) => u().normalizeChord(...a);
+export const notify = (...a) => u().notify(...a);
 export const onKey = (...a) => u().onKey(...a);
 export const onKeys = (...a) => u().onKeys(...a);
 export const parseChord = (...a) => u().parseChord(...a);
@@ -75,6 +81,7 @@ export const subscribeEditorSettings = (...a) => u().subscribeEditorSettings(...
 export const themeById = (...a) => u().themeById(...a);
 export const toMonaco = (...a) => u().toMonaco(...a);
 export const toast = (...a) => u().toast(...a);
+export const tone = (...a) => u().tone(...a);
 export const updateEditorSettings = (...a) => u().updateEditorSettings(...a);
 export const useEditorSettings = (...a) => u().useEditorSettings(...a);
 export const useIconThemesVersion = (...a) => u().useIconThemesVersion(...a);

package/template/plugin.json

@@ -5,5 +5,5 @@
   "icon": "Sparkles",
   "color": "#a78bfa",
   "version": "0.1.0",
-  "minDeck": "1.5.0"
+  "minDeck": "1.6.1"
 }

package/types/components/ActivityBar.d.ts

@@ -11,10 +11,12 @@ export interface ActivityView<Id extends string> {
     onClick?: (el: HTMLElement) => void;
 }
 export default ActivityBar;
-export declare function ActivityBar<Id extends string>({ views, active, onSelect, trailing, }: {
+export declare function ActivityBar<Id extends string>({ views, active, onSelect, trailing, grouped, }: {
     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;
+    /** The icons together in one rounded group, smaller, rather than loose pills. */
+    grouped?: boolean;
 }): import("react").JSX.Element;

package/types/components/ContextMenu.d.ts

@@ -26,6 +26,9 @@ export interface MenuItem {
     /** A setting rather than an action: renders a checkbox and does NOT close the menu, so several
      *  can be flipped in one visit. The caller re-renders with the new value. */
     checked?: boolean;
+    /** Controls of its own at the row's right (a zoom's − and +, a slider): the row is not
+     *  clicked itself, and using them leaves the menu open. */
+    controls?: React.ReactNode;
 }
 export type MenuEntry = MenuItem | "sep";
 export declare function ContextMenu({ x, y, items, alignRight, onClose, onReorder, flipAt, up }: {

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, pill, onAdd, addTitle, }: {
+export declare function TabStrip({ tabs, activeId, onSelect, onClose, onReorder, onDoubleClick, leading, trailing, pill: pillProp, chip, onAdd, addTitle, }: {
     tabs: readonly TabItem[];
     activeId: string | null;
     onSelect: (id: string) => void;
@@ -20,11 +20,16 @@ export declare function TabStrip({ tabs, activeId, onSelect, onClose, onReorder,
     /** Moves `from` to `to`'s position. Omit to make the strip non-reorderable. */
     onReorder?: (from: string, to: string) => void;
     onDoubleClick?: (id: string) => void;
+    /** Controls before the first tab. */
+    leading?: ReactNode;
     /** 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;
+    /** Rounded like `pill`, with the open tab raised on the card colour rather than lit in the
+     *  accent: the editor's tabs, where the accent already marks the open file in the tree. */
+    chip?: boolean;
     /** A + right after the last tab, as the workspace tabs have. */
     onAdd?: () => void;
     addTitle?: string;

package/types/components/ui.d.ts

@@ -58,10 +58,14 @@ export declare function DayPicker({ value, onChange, }: {
     onChange: (days: string[]) => void;
 }): import("react").JSX.Element;
 /** One readout in the footer strip: an icon, a short label, and an optional click. */
-export declare function StatusItem({ icon, color, label, title, onClick, }: {
+export declare function StatusItem({ icon, color, label, detail, meter, title, onClick, }: {
     icon: React.ReactNode;
     color: string;
     label: string;
+    /** A second, quieter part after the label: a branch, a commit. */
+    detail?: string;
+    /** 0 to 100: a small bar before the label, in the item's colour (a limit's use). */
+    meter?: number;
     title?: string;
     onClick?: () => void;
 }): import("react").JSX.Element;
@@ -100,3 +104,46 @@ export declare function Toggle({ on, onChange }: {
     on: boolean;
     onChange: (v: boolean) => void;
 }): import("react").JSX.Element;
+/** A state in its colour: Ready, Running, Paused, Failed. `color` is any CSS colour; a `--tone-*`
+ *  one (`tone("green")`) follows a light theme. */
+export declare function Chip({ color, title, children }: {
+    color: string;
+    title?: string;
+    children: ReactNode;
+}): import("react").JSX.Element;
+/** A `--tone-*` colour as CSS, for a Chip, a dot or text: `tone("amber")`. */
+export declare function tone(name: "red" | "emerald" | "amber" | "blue" | "green" | "cyan" | "sky" | "violet" | "pink" | "orange", shade?: 300 | 400): string;
+/** How many, after a heading or a row. */
+export declare function CountChip({ n, title }: {
+    n: number;
+    title?: string;
+}): import("react").JSX.Element;
+/**
+ * What a space is for and the way in, when it has nothing to show: a sentence and, usually, a
+ * button. `card` puts it in a quiet card, for when it is the only thing on screen.
+ */
+export declare function EmptyState({ icon, title, children, action, card }: {
+    icon?: ReactNode;
+    /** A short line above the sentence, when the space needs naming. */
+    title?: string;
+    children: ReactNode;
+    action?: {
+        label: string;
+        onClick: () => void;
+    };
+    card?: boolean;
+}): import("react").JSX.Element;
+/**
+ * An icon-only button. `toolbar` (size-7) for a panel's own actions, `row` (size-5) for one inside
+ * a list row, shown on the row's hover by the caller. `danger` turns it red on hover only; `active`
+ * marks a toggle that is on. `title` is required: it is the only label the button has.
+ */
+export declare function IconButton({ title, onClick, children, size, danger, active, disabled }: {
+    title: string;
+    onClick: (e: React.MouseEvent<HTMLButtonElement>) => void;
+    children: ReactNode;
+    size?: "toolbar" | "row";
+    danger?: boolean;
+    active?: boolean;
+    disabled?: boolean;
+}): import("react").JSX.Element;

package/types/components/useResize.d.ts

@@ -19,7 +19,7 @@ export declare function useNarrow(px: number): [boolean, (el: HTMLElement | null
  * Listeners go on `window`, not the divider, so a fast drag that outruns the pointer keeps
  * resizing instead of stopping the moment the cursor leaves the 4px handle.
  */
-export declare function useResize({ initial, min, max, direction, invert, }: {
+export declare function useResize({ initial, min, max, direction, invert, collapseBelow, onCollapse, }: {
     initial: number;
     min: number;
     max: number;
@@ -31,6 +31,13 @@ export declare function useResize({ initial, min, max, direction, invert, }: {
      * would grow a pane that is actually being squeezed from above.
      */
     invert?: boolean;
+    /**
+     * Dragged this far down (below `min`), the drag ends and `onCollapse` runs: the pane snaps shut
+     * rather than stopping at its minimum. Its size goes back to what it was when the drag began, so
+     * opening it again gives the width it had.
+     */
+    collapseBelow?: number;
+    onCollapse?: () => void;
 }): readonly [number, {
     readonly onMouseDown: (e: React.MouseEvent) => void;
 }, boolean];

package/types/core/bookmarks.d.ts

@@ -0,0 +1,79 @@
+// GENERATED by sdk/gen-types.mjs from Deck's source — do not edit.
+export interface BookmarkNode {
+    id: string;
+    title: string;
+    /** A page has a URL; a folder has children instead. */
+    url?: string;
+    children?: BookmarkNode[];
+}
+export interface Bookmarks {
+    bar: BookmarkNode[];
+    other: BookmarkNode[];
+}
+export declare const EMPTY: Bookmarks;
+export declare const isFolder: (n: BookmarkNode) => boolean;
+/** An id unique within this run and across runs: time, then a counter. */
+export declare const newId: () => string;
+/** Every page in the tree, depth first, with the folder titles above it. */
+export declare function pages(b: Bookmarks): {
+    node: BookmarkNode;
+    path: string[];
+}[];
+/** The bookmark for `url`, if there is one (the first, when it was saved twice). */
+export declare const findByUrl: (b: Bookmarks, url: string) => BookmarkNode | undefined;
+/** Every folder, for a "save in" list: the two roots first, then each folder by its path. */
+export declare function folders(b: Bookmarks): {
+    id: string;
+    path: string;
+}[];
+/** Add `node` at the end of `folder`. */
+export declare const add: (b: Bookmarks, folder: string, node: BookmarkNode) => Bookmarks;
+/** Remove the node with `id`, wherever it is (a folder goes with what is in it). */
+export declare function remove(b: Bookmarks, id: string): Bookmarks;
+/** Change a node's title or URL. */
+export declare function update(b: Bookmarks, id: string, patch: Partial<Pick<BookmarkNode, "title" | "url">>): Bookmarks;
+/** The node with `id`, and the id of the folder it is in. */
+export declare function locate(b: Bookmarks, id: string): {
+    node: BookmarkNode;
+    folder: string;
+} | null;
+/** Move a node to the end of another folder. A folder cannot go inside itself. */
+export declare function move(b: Bookmarks, id: string, folder: string): Bookmarks;
+/**
+ * A Chromium browser's Bookmarks file (Chrome, Edge, Brave all keep the same JSON) as Deck's
+ * nodes: its bar, its other bookmarks, and on Chrome its mobile ones, each as given. Anything that
+ * is not a page or a folder (a separator, an app link) is left out.
+ */
+export declare function fromChrome(json: string): {
+    bar: BookmarkNode[];
+    other: BookmarkNode[];
+};
+/** An import, as one folder in each root named after where it came from ("From Chrome"), left out
+ *  of a root it has nothing for. */
+export declare function addImport(b: Bookmarks, from: string, got: {
+    bar: BookmarkNode[];
+    other: BookmarkNode[];
+}): Bookmarks;
+/** How many pages a set of nodes holds. */
+export declare const countPages: (ns: readonly BookmarkNode[]) => number;
+/** Deck's bookmarks as a bookmarks HTML file. */
+export declare function toHtml(b: Bookmarks): string;
+/** A bookmarks HTML file as Deck's two roots. Read by its tags, not as a page: folders (H3) open
+ *  the list (DL) that follows them, pages are links (A HREF). */
+export declare function fromHtml(html: string): {
+    bar: BookmarkNode[];
+    other: BookmarkNode[];
+};
+/**
+ * An import merged in: a folder joins the folder of the same name where it lands (made if there
+ * is none), and a page already bookmarked anywhere is left out. So a file exported from Deck
+ * restores into the same places, and importing one twice adds nothing the second time.
+ * Returns the bookmarks and how many pages were added.
+ */
+export declare function mergeImport(b: Bookmarks, got: {
+    bar: BookmarkNode[];
+    other: BookmarkNode[];
+}): {
+    bookmarks: Bookmarks;
+    added: number;
+};