deck-plugin-sdk 1.5.0 → 1.6.1

package/types/core/bridge.d.ts

@@ -1,8 +1,192 @@
 // GENERATED by sdk/gen-types.mjs from Deck's source — do not edit.
 import { type DebugTarget } from "./debugtargets";
 import type { Accent, Background, Density, Palette, TermCustom, TermTheme } from "./theme";
+import type { SearchEngine } from "./browserurl";
 /** Open a URL in the default browser. */
 export declare const openExternal: (url: string) => Promise<void>;
+/** A box in physical pixels, relative to the window: where a browser pane's webview goes. */
+export interface PhysRect {
+    x: number;
+    y: number;
+    w: number;
+    h: number;
+}
+/** Open `url` in the browser pane's own webview (created the first time) at `r`. A private one
+ *  keeps no cookies, history or cache. */
+export declare const browserOpen: (pane: string, url: string, isPrivate: boolean, r: PhysRect) => Promise<void>;
+/** Move the pane's webview, or hide it. */
+export declare const browserBounds: (pane: string, r: PhysRect, visible: boolean) => Promise<void>;
+export declare const browserNav: (pane: string, action: "back" | "forward" | "reload" | "go" | "focus", url?: string) => Promise<void>;
+/** 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>;
+/** 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>;
+/** Whether the ad blocker is ready, how many rules it holds, and when its lists were downloaded. */
+export declare const adblockInfo: () => Promise<{
+    ready: boolean;
+    rules: number;
+    updated: number;
+}>;
+/** Rebuild the ad blocker from its lists and the user's own rules, after those changed. */
+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>;
+/** 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>;
+/** The user's answer to an agent asking to be signed in on a page: the login to fill, or none. */
+export declare const browserAgentFillAnswer: (id: number, login: string | null) => Promise<void>;
+/** A saved login, without its secrets. */
+export interface VaultMeta {
+    id: string;
+    site: string;
+    username: string;
+    note: string;
+    totp: boolean;
+    created: number;
+    updated: number;
+    used: number;
+}
+/** A login to save: a password or 2FA key left out keeps the saved one; an empty 2FA key removes it. */
+export interface VaultEntryIn {
+    id?: string;
+    site: string;
+    username: string;
+    password?: string;
+    note?: string;
+    totp?: string;
+}
+export declare const vaultStatus: () => Promise<{
+    exists: boolean;
+    unlocked: boolean;
+}>;
+/** The minutes before the vault locks itself, and whether to offer saving a sign-in. */
+export declare const vaultConfig: (autolockMinutes: number, offer: boolean) => Promise<void>;
+export declare const vaultCreate: (password: string) => Promise<void>;
+export declare const vaultUnlock: (password: string) => Promise<void>;
+export declare const vaultLock: () => Promise<void>;
+export declare const vaultChangePassword: (old: string, next: string) => Promise<void>;
+export declare const vaultList: () => Promise<VaultMeta[]>;
+/** Add or update a login; its id. */
+export declare const vaultSave: (entry: VaultEntryIn) => Promise<string>;
+export declare const vaultDelete: (id: string) => Promise<void>;
+/** One login's password, to show or copy. */
+export declare const vaultSecret: (id: string) => Promise<string>;
+/** One login's 2FA code now, and the seconds it has left. */
+export declare const vaultTotp: (id: string) => Promise<{
+    code: string;
+    remaining: number;
+}>;
+export declare const vaultGenerate: (length: number, symbols: boolean) => Promise<string>;
+/** The sites never offered saving for. */
+export declare const vaultNeverList: () => Promise<string[]>;
+export declare const vaultNeverRemove: (site: string) => Promise<void>;
+/** The logins saved for the page a pane shows. */
+export declare const vaultMatches: (pane: string) => Promise<VaultMeta[]>;
+/** Fill a login into the pane's page ("ok", or "user" when the page asks for the username first). */
+export declare const vaultFill: (pane: string, id: string) => Promise<string>;
+/** Fill a new generated password into a sign-up page's password fields. */
+export declare const vaultFillNew: (pane: string, length: number, symbols: boolean) => Promise<void>;
+export declare const vaultOfferAnswer: (pane: string, answer: "save" | "never" | "dismiss") => Promise<void>;
+/** Logins from a password export (Chrome, Edge, Brave, Firefox, Bitwarden). */
+export declare const vaultImport: (path: string) => Promise<{
+    added: number;
+    updated: number;
+    skipped: number;
+}>;
+/** Every login to a plain-text CSV file, after the master password again; how many. */
+export declare const vaultExport: (path: string, password: string) => Promise<number>;
+/** A page in the history: its title, how often and when it was last visited (ms). */
+export interface HistoryPage {
+    url: string;
+    title: string;
+    count: number;
+    last: number;
+}
+/** One visit to a page. */
+export interface HistoryVisit {
+    url: string;
+    title: string;
+    at: number;
+}
+/** A visit to a web page; `counted` false is only its title arriving. Whether anything changed. */
+export declare const browserHistoryVisit: (url: string, title: string, counted: boolean) => Promise<boolean>;
+export declare const browserHistoryRecent: (limit: number) => Promise<HistoryPage[]>;
+/** Visits newest first, before `before` (ms), whose page matches every word of `q`. */
+export declare const browserHistoryList: (q: string, before: number | null, limit: number) => Promise<HistoryVisit[]>;
+/** The pages the address bar offers for `q`, best first. */
+export declare const browserHistorySuggest: (q: string, limit: number) => Promise<HistoryPage[]>;
+/** How many pages the history holds. */
+export declare const browserHistoryCount: () => Promise<number>;
+export declare const browserHistoryForgetUrl: (url: string) => Promise<void>;
+/** Forget the visits from `from` to `to` (ms); all of them when neither is given. */
+export declare const browserHistoryForgetRange: (from?: number, to?: number) => Promise<void>;
+/** An installed extension. `id` is WebView2's, which chrome-extension:// addresses use. */
+export interface BrowserExtension {
+    id: string;
+    name: string;
+    version: string;
+    enabled: boolean;
+    storeId?: string;
+    popup?: string;
+    options?: string;
+    icon?: string;
+    path: string;
+    inPlace: boolean;
+}
+export declare const extensionsList: () => Promise<BrowserExtension[]>;
+/** Install from the Chrome Web Store, by its link or the extension's id; its name. */
+export declare const extensionInstallStore: (link: string) => Promise<string>;
+/** Install an unpacked extension from a folder: copied in, or loaded where it is (`inPlace`, developer mode); its name. */
+export declare const extensionInstallFolder: (path: string, inPlace?: boolean) => Promise<string>;
+/** Load an extension again from its files (an unpacked one's edits); its name. */
+export declare const extensionReload: (id: string) => Promise<string>;
+export declare const extensionSetEnabled: (id: string, enabled: boolean) => Promise<void>;
+export declare const extensionRemove: (id: string) => Promise<void>;
+/** Show an extension's popup page for `pane`, its right edge at `right` and top at `top` (physical pixels). */
+export declare const extensionPopup: (pane: string, id: string, page: string, right: number, top: number) => Promise<void>;
+export declare const extensionPopupClose: (pane: string) => Promise<void>;
+/** The sites agents may use in the browser without asking. */
+export declare const browserAgentConfig: (sites: string[]) => Promise<void>;
+/** The user's answer to an agent's question about a site. */
+export declare const browserAgentAnswer: (id: number, site: string, allow: boolean, forGood: boolean) => Promise<void>;
+/** A DevTools protocol call on a browser pane's page, and its answer. */
+export declare const browserCdp: (pane: string, method: string, params?: unknown) => Promise<unknown>;
+/** Open a browser pane's developer tools. */
+export declare const browserDevtools: (pane: string) => Promise<void>;
+/** What the site in a browser pane keeps and has been allowed: its cookie count and permissions. */
+export declare const browserSite: (pane: string) => Promise<{
+    origin: string;
+    cookies: number;
+    permissions: {
+        origin: string;
+        kind: number;
+        state: number;
+    }[];
+}>;
+/** Delete the site's cookies, storage and cache. */
+export declare const browserSiteClear: (pane: string) => Promise<void>;
+/** Every site given or refused a permission. */
+export declare const browserPermissions: () => Promise<{
+    origin: string;
+    kind: number;
+    state: number;
+}[]>;
+/** Set a site's permission: 0 ask again, 1 allow, 2 block. */
+export declare const browserPermissionSet: (origin: string, kind: number, state: number) => Promise<void>;
+/** Mute or unmute a browser pane's page. */
+export declare const browserMute: (pane: string, muted: boolean) => Promise<void>;
+/** Set a browser pane's page zoom (1 = 100%). */
+export declare const browserZoom: (pane: string, factor: number) => Promise<void>;
+/** Pause, resume or cancel one of the browser's downloads. */
+export declare const browserDownload: (id: number, action: "pause" | "resume" | "cancel") => Promise<void>;
+/** Find in the pane's page: start a search, step through its matches, or stop (clearing them). */
+export declare const browserFind: (pane: string, action: "start" | "next" | "prev" | "stop", term?: string, matchCase?: boolean) => Promise<void>;
+export declare const browserCapture: (pane: string) => Promise<ArrayBuffer>;
 export interface AppProc {
     name: string;
     title: string;
@@ -56,6 +240,19 @@ export interface Settings {
     serversList: boolean;
     /** The mouse wheel over a tab bar switches tabs rather than scrolling the bar. */
     tabWheelSwitch: boolean;
+    /** When the tabs do not fit, every one but the open tab shrinks to its icon. */
+    tabSqueeze?: boolean;
+    /** Each project's own colour on the sidebar's collapsed rail. Off, they are all one grey. */
+    projectColours?: 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
+     *  notification while Deck is not focused. A missing entry takes the default (notifications.ts). */
+    notifPrefs?: Partial<Record<"input" | "done" | "attention" | "activity" | "update" | "error" | "plugin", Partial<Record<"card" | "bell" | "sound" | "os", boolean>>>>;
+    /** No cards and no sound; everything still lands in the bell. */
+    doNotDisturb?: boolean;
+    /** Which corner on the right the notification cards stack in. */
+    notifPosition?: "bottom" | "top";
     /** Install plugin and language updates at startup instead of only announcing them. */
     pluginAutoUpdate: boolean;
     soundOnFire: boolean;
@@ -116,7 +313,58 @@ export interface Settings {
      * else the Windows account's (see `userName` in settingsstore.ts).
      */
     userName: string;
+    /** What a new browser pane opens: Deck's start page, the search engine's own page, or a URL
+     *  (a site, or a local .html file the user wrote). */
+    browserHome: "deck" | "search" | "url";
+    browserHomeUrl: string;
+    /** Where a search typed into the address bar or the start page goes. */
+    browserSearch: SearchEngine;
+    /** Which parts of Deck's start page show. */
+    browserHomeSections: {
+        clock: boolean;
+        search: boolean;
+        servers: boolean;
+        pins: boolean;
+        recent: boolean;
+    };
+    /** Behind the start page: a photo that changes each time it opens, one from a folder of the
+     *  user's own, or none (Deck's background). */
+    browserBackground: "photos" | "folder" | "none";
+    browserBackgroundFolder: string;
+    /** Where the bookmarks bar shows under a browser's toolbar: on every page, on the start page
+     *  only, or not at all (and only once something is on it). true and false are what it was saved
+     *  as before it had three; read it through bookmarksBarMode. */
+    browserBookmarksBar: "always" | "home" | "never" | boolean;
+    /** WebView2's tracking prevention for the browser: how many trackers it blocks. */
+    browserTracking: "none" | "basic" | "balanced" | "strict";
+    /** Whether the vault offers to save a sign-in, and the minutes it stays open unused. */
+    browserVaultOffer: boolean;
+    browserVaultLock: number;
+    /** Extensions pinned to the browser's toolbar, by WebView2's id, in order. */
+    browserPinnedExtensions: string[];
+    /** The Extensions page's developer mode: load unpacked folders in place, reload them, ids and folders shown. */
+    browserExtensionsDev: boolean;
+    /** Whether the browser fills in forms (addresses, names). */
+    browserAutofill: boolean;
+    /** The ad blocker (EasyList and EasyPrivacy), and the sites it is switched off for, by host. */
+    browserAdblock: boolean;
+    browserAdblockOff: string[];
+    /** Skip YouTube's video ads: click Skip when it shows, run an unskippable one to its end. */
+    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";
+    /** 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. */
+    browserAgentSites: string[];
+    /**
+     * Where a file type opens, by extension (".pdf"): "editor", "browser" or "plugin:<id>". A type
+     * not listed is Automatic (see `openerFor` in fileview.ts).
+     */
+    openWith?: Record<string, string>;
 }
+/** The bookmarks bar setting, older true/false values included. */
+export declare const bookmarksBarMode: (s: Settings) => "always" | "home" | "never";
 export declare const DEFAULT_SETTINGS: Settings;
 export declare const setAutostart: (on: boolean) => Promise<void>;
 export declare const getAutostart: () => Promise<boolean>;
@@ -239,6 +487,18 @@ export declare const logLatest: () => Promise<string>;
 export declare const openFile: (path: string) => Promise<void>;
 /** Files Deck was launched with — a double-click through Explorer's "Open with". */
 export declare const launchFiles: () => Promise<string[]>;
+/** Web addresses Deck was launched with: a link opened in another app, Deck being the default browser. */
+export declare const launchUrls: () => Promise<string[]>;
+export interface DefaultBrowserStatus {
+    registered: boolean;
+    isDefault: boolean;
+    name: string;
+}
+/** Whether Deck is offered as a browser in Windows, and whether links open with it. */
+export declare const browserDefaultStatus: () => Promise<DefaultBrowserStatus>;
+/** Register Deck as a browser for this user and open Windows' Default apps page at it: Windows
+ *  keeps the choice itself to the user. */
+export declare const browserDefaultRegister: () => Promise<DefaultBrowserStatus>;
 export declare const mediaSetNowPlaying: (title: string, artist: string, artPath: string) => Promise<void>;
 export declare const mediaSetPlayback: (playing: boolean) => Promise<void>;
 export interface TrackMeta {
@@ -411,6 +671,8 @@ export interface StartupMarks {
     setupEnd: number;
 }
 export declare const startupMarks: () => Promise<StartupMarks | null>;
+/** The page has drawn: Rust shows the window, hidden until then so it never shows see-through. */
+export declare const deckReady: () => Promise<void>;
 /** What a backup file holds: the Deck that wrote it, when, and how many of each thing. */
 export interface BackupSummary {
     deck: string;
@@ -664,6 +926,8 @@ export interface DbTable {
     name: string;
     kind: "table" | "view";
     columns: DbColumn[];
+    /** The statement that created it, where the engine keeps one (SQLite). */
+    sql?: string;
 }
 export interface DbForeignKey {
     table: string;
@@ -675,11 +939,15 @@ export interface DbSchema {
     tables: DbTable[];
     foreignKeys: DbForeignKey[];
 }
-/** Open a postgres:// or mysql:// connection. The handle outlives the calling component. */
+/** Open a connection; the url's scheme picks the engine. The handle outlives the calling component. */
 export declare const dbConnect: (url: string) => Promise<number>;
 export declare const dbDisconnect: (handle: number) => Promise<void>;
-/** Run ONE statement. `readOnly` wraps it in a read-only transaction the server enforces. */
-export declare const dbQuery: (handle: number, sql: string, readOnly: boolean) => Promise<DbQueryResult>;
+/**
+ * Run a statement and return up to 1000 rows, after skipping the first `skip` (how a grid pages).
+ * `readOnly` refuses writes, by the database itself (a read-only session on Postgres and MySQL,
+ * query_only on SQLite).
+ */
+export declare const dbQuery: (handle: number, sql: string, readOnly: boolean, skip?: number) => Promise<DbQueryResult>;
 export declare const dbSchema: (handle: number) => Promise<DbSchema>;
 /** Open a tunnel. `remote` is host:port as seen FROM `host`. Returns [id, local port]. */
 export declare const sshTunnelOpen: (host: string, remote: string) => Promise<[number, number]>;

package/types/core/browser.d.ts

@@ -0,0 +1,189 @@
+// GENERATED by sdk/gen-types.mjs from Deck's source — do not edit.
+import { type RecentPage } from "./browserurl";
+import { type Bookmarks } from "./bookmarks";
+/**
+ * `home`: the pane shows Deck's start page, and its webview (if it has one) is hidden. `back` and
+ * `forward`: whether the page has history that way. `private`: nothing it visits is kept.
+ * `page`: which of Deck's own pages the pane shows instead of a site, with `home` set too so the
+ * webview stays hidden ("" with `home` is the start page).
+ */
+export type DeckPage = "" | "history" | "bookmarks" | "settings" | "downloads" | "passwords" | "extensions";
+export interface BrowserState {
+    url: string;
+    title: string;
+    loading: boolean;
+    home: boolean;
+    page: DeckPage;
+    back: boolean;
+    forward: boolean;
+    private: boolean;
+    /** The find bar: shown, and the matches the search has (index is the current one, from 1). */
+    findOpen: boolean;
+    findCount: number;
+    findIndex: number;
+    /** The site's icon, whether the page plays sound and is muted, and its zoom (1 = 100%). */
+    favicon: string;
+    playing: boolean;
+    muted: boolean;
+    zoom: number;
+    /** The tab's own volume, 0 to 1, over what the page sets (VOLUME_JS in browser.rs). */
+    volume: number;
+    /** Ads and trackers the ad blocker refused on the current page. */
+    blocked: number;
+    /** The device the page is laid out as (DeviceBar), "" for the page's own size. */
+    device: string;
+    /** The device turned on its side (width and height swapped). */
+    rotated: boolean;
+    /** Devices shown side by side (DeviceBar), the first in the pane's own webview; [] for one. */
+    devices: string[];
+}
+export declare const subscribeBrowser: (f: () => void) => () => void;
+export declare const browserState: (pane: string) => BrowserState | undefined;
+/**
+ * The pane is gone (closed, or its tab or workspace was): close its webview and forget its page.
+ * Called from terminals.ts's destroy(), which every way of removing a pane goes through.
+ */
+export declare function closeBrowserPane(pane: string): void;
+/** The find bar registers how to focus its box, for Ctrl+F while it is already open. */
+export declare function registerFindBox(pane: string, focus: () => void): () => void;
+/** Open the find bar (Ctrl+F), or put the keyboard back in it when it is open. */
+export declare function openFind(pane: string): void;
+/** Close it and clear the page's highlights. */
+export declare function closeFind(pane: string): void;
+/** Show the start page in the pane, or leave it for `url`. */
+export declare const showHome: (pane: string) => void;
+export declare const leaveHome: (pane: string, url: string) => void;
+/** Show the history page in the pane. */
+export declare const showHistory: (pane: string) => void;
+/** Show the bookmarks page in the pane. */
+export declare const showBookmarks: (pane: string) => void;
+/** Show the downloads in the pane. */
+export declare const showDownloads: (pane: string) => void;
+/** Show the extensions in the pane. */
+export declare const showExtensions: (pane: string) => void;
+/** Show the password vault in the pane. */
+export declare const showPasswords: (pane: string) => void;
+/** Show the browser's settings in the pane. */
+export declare const showBrowserSettings: (pane: string) => void;
+/** A new pane's kind, before anything else is known about it. */
+export declare const startPane: (pane: string, isPrivate: boolean) => void;
+/** Every ad and tracker blocked so far. */
+export declare const totalBlocked: () => number;
+/** The user's own ad blocker rules, as text. */
+export declare const myFilters: () => Promise<string>;
+/** Save them, and put them to work. */
+export declare function saveMyFilters(text: string): Promise<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;
+/** Show these devices side by side (the first in the pane's own webview), or one ([]). */
+export declare const setDevices: (pane: string, devices: string[]) => void;
+/** A side-by-side device's webview rather than a pane's own. */
+export declare function isMirror(pane: string): boolean;
+/** The pane a mirror belongs to (a pane is its own). */
+export declare function paneOf(id: string): string;
+export declare function addMirror(id: string): void;
+export declare function removeMirror(id: string): void;
+/** Close a pane's mirrors from the `from`th on: side by side switched off, a device taken away, the
+ *  pane closed. Not when the pane is only out of sight: a mirror stays, hidden, as the pane's own
+ *  webview does, so coming back neither reloads it nor races a close against a reopen. */
+export declare function closeMirrors(pane: string, from?: number): void;
+/** Mute or unmute a pane's page. */
+export declare const setMuted: (pane: string, muted: boolean) => undefined;
+/** The tab's volume, 0 to 1. Kept for the tab, and sent again to each page it loads. */
+export declare function setVolume(pane: string, v: number): void;
+/** A browser pane says how to tell whether it has the keyboard and is showing a page. */
+export declare function registerZoomTarget(pane: string, holds: () => boolean): () => void;
+/** The browser pane whose page Deck's zoom keys should zoom, if the keyboard is in one. */
+export declare const activeBrowserPage: () => string | undefined;
+/** Zoom the pane's page a step in or out, or back to 100% (0). */
+export declare function stepZoom(pane: string, dir: -1 | 0 | 1): void;
+/** The URL a just-opened browser pane should show, if a page asked for it. */
+export declare const takeWaitingUrl: () => {
+    url: string;
+    private: boolean;
+} | undefined;
+/** A new browser tab, on `url` or on the start page. */
+export declare const newBrowserTab: (url?: string, isPrivate?: boolean) => boolean | void;
+/** Read once, before the first browser pane asks. */
+export declare const loadPanes: () => Promise<void>;
+/** The page a pane was on when Deck last closed. */
+export declare const savedPage: (pane: string) => string | undefined;
+/** How Ctrl+Shift+B shows or hides the bookmarks bar: set by the browser pane, which holds the settings. */
+export declare const setBarToggle: (f: () => void) => void;
+/** Bookmark the pane's page, as its star does: Ctrl+D, and the browser menu. */
+export declare const pressStar: (pane: string) => void | undefined;
+/** The pane's star registers how to bookmark the page, for Ctrl+D. */
+export declare function registerStar(pane: string, run: () => void): () => void;
+/** The pane's key in the address bar registers what Ctrl+Shift+L does: fill the login, or offer the choice. */
+export declare function registerVaultKey(pane: string, run: () => void): () => void;
+/** The pane's address bar registers how to focus it, for Ctrl+L. */
+export declare function registerAddressBar(pane: string, focus: () => void): () => void;
+/** Tell Rust which chords to take from a page. Called when a browser pane mounts and whenever a
+ *  binding changes. */
+export declare function syncBrowserKeys(): void;
+export interface Pin {
+    title: string;
+    url: string;
+}
+export declare const subscribeLists: (f: () => void) => () => void;
+export declare const listsSnapshot: () => number;
+export declare const browserPins: () => Pin[];
+export declare const recentPages: () => RecentPage[];
+export declare const ensureLists: () => undefined;
+/** `id` is Rust's, for pausing and cancelling, and starts again each run; `key` is unique for good.
+ *  `session`: started since Deck opened, so the toolbar shows it. */
+export interface Download {
+    key: string;
+    id: number;
+    pane: string;
+    url: string;
+    path: string;
+    received: number;
+    total: number;
+    state: "running" | "paused" | "done" | "failed";
+    started: number;
+    session: boolean;
+    /** An extension being installed from the store (extensions.rs), not a file: its name once known. */
+    extension?: string;
+}
+export declare const subscribeDownloads: (f: () => void) => () => void;
+export declare const downloadsSnapshot: () => number;
+/** Newest first. */
+export declare const browserDownloads: () => Download[];
+/** Take one finished download off the list (the file stays). */
+export declare function forgetDownload(key: string): void;
+/** Take every finished download off the list. */
+export declare function clearDownloads(): void;
+export declare const browserBookmarks: () => Bookmarks;
+export declare function setBookmarks(next: Bookmarks): void;
+/** A Chromium browser's bookmarks on this machine, one per profile that has any. */
+export interface BookmarkSource {
+    browser: string;
+    profile: string;
+    path: string;
+}
+/** Every profile of Chrome, Edge and Brave with a Bookmarks file. A browser not installed is no error. */
+export declare function findBookmarkSources(): Promise<BookmarkSource[]>;
+/** Import one source's bookmarks as a "From Chrome" folder in each root. Returns how many pages. */
+export declare function importBookmarks(src: BookmarkSource): Promise<number>;
+/** Every bookmark to a bookmarks HTML file, which any browser imports, and Deck too. How many pages. */
+export declare function exportBookmarks(path: string): Promise<number>;
+/** A bookmarks HTML file (Deck's own export, or any browser's) merged in, into folders of the same
+ *  name and without pages already bookmarked. How many pages it added. */
+export declare function importBookmarksFile(path: string): Promise<number>;
+export declare function setPins(next: Pin[]): void;
+/** Forget one page, or every visit between `from` and `to` (all of them when neither is given). */
+export declare function forgetHistory(url: string): void;
+export declare function forgetHistory(range: {
+    from?: number;
+    to?: number;
+}): void;
+export declare const forgetRecent: (url: string) => void;
+export declare const serversSnapshot: () => number;
+export declare const devServers: () => string[];
+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;
+export declare function trackBrowser(pane: string, el: HTMLElement, url: string): () => void;

package/types/core/browserurl.d.ts

@@ -0,0 +1,64 @@
+// GENERATED by sdk/gen-types.mjs from Deck's source — do not edit.
+export type SearchEngine = "google" | "brave" | "duckduckgo" | "bing";
+export declare const SEARCH_ENGINES: Record<SearchEngine, {
+    label: string;
+    home: string;
+    query: string;
+}>;
+export declare const searchUrl: (engine: SearchEngine, q: string) => string;
+/**
+ * What was typed into the address bar or the start page's search box, as a URL to open.
+ *
+ * A scheme is kept; a local host gets plain http (dev servers rarely have TLS); a Windows or Unix
+ * path to a file becomes file:///; text with a space, or a single word with no dot, is a search;
+ * anything else is a host and gets https.
+ */
+export declare function toUrl(typed: string, engine: SearchEngine): string;
+/**
+ * Local URLs in a chunk of terminal output: what a dev server prints when it starts ("Local:
+ * http://localhost:5173/"). 0.0.0.0 is where a server listens, not somewhere to go, so it becomes
+ * localhost. A trailing dot or comma is the sentence's, not the URL's.
+ */
+export declare function devUrls(chunk: string): string[];
+/** The web addresses in a line of terminal output, where each starts and its text: what Ctrl+click
+ *  opens. A trailing dot, comma or closing bracket is the sentence's, not the address's. */
+export declare function findUrls(line: string): {
+    start: number;
+    text: string;
+}[];
+export interface RecentPage {
+    url: string;
+    title: string;
+}
+/** Whether `url` is a search engine's results page: on the way somewhere, not a place to go back to. */
+export declare const isSearchPage: (url: string) => boolean;
+/** One page in the history: how often it was opened, and when last (browser_history.rs keeps them). */
+export interface Visit {
+    url: string;
+    title: string;
+    count: number;
+    last: number;
+}
+export interface Suggestion {
+    url: string;
+    title: string;
+    kind: "pin" | "bookmark" | "history";
+}
+/**
+ * What the address bar offers for `typed`: pinned sites, bookmarks and history whose address or
+ * title holds every word typed. An address that starts with what was typed comes first, then by
+ * how often and how lately it was visited, a pin or a bookmark counting as often.
+ */
+export declare function suggest(typed: string, sources: {
+    pins?: readonly {
+        url: string;
+        title: string;
+    }[];
+    bookmarks?: readonly {
+        url: string;
+        title: string;
+    }[];
+    history?: readonly Visit[];
+}, now: number, limit?: number): Suggestion[];
+/** A day's heading in the history: Today, Yesterday, or the date. */
+export declare function dayLabel(t: number, now: number): string;