deck-plugin-sdk 1.6.0 → 1.6.1

package/package.json

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

package/template/plugin.json

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

package/types/core/bridge.d.ts

@@ -357,6 +357,11 @@ export interface Settings {
     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";

package/types/core/fileview.d.ts

@@ -29,7 +29,26 @@ export declare const fileOpeners: {
 /** The id of the plugin that opens `path` (by its extension), or undefined: the Editor's. */
 export declare function pluginForFile(path: string): string | undefined;
 /**
- * Open `path` in the plugin that claims its type, as a tab of its own. False when no plugin does,
- * so the caller opens it in the Editor as before. Every way Deck opens a file asks this first.
+ * The files Deck's browser opens: the types defaultbrowser.rs registers with Windows (FILE_TYPES
+ * there), so a choice offered here is one Windows can hand over too.
  */
-export declare function openWithPlugin(path: string): boolean;
+export declare const BROWSER_TYPES: string[];
+/** Where a file opens: the Editor, a browser tab, or a plugin's pane (`plugin:<id>`). */
+export type Opener = "editor" | "browser" | `plugin:${string}`;
+/** The user's choice per extension (Settings, `openWith`); a type with none is Automatic. */
+export declare const openPrefs: {
+    current: Record<string, string>;
+};
+/**
+ * Where `path` opens. The user's choice for its type wins, where it still can (the plugin is
+ * loaded, the file is local for a browser tab); otherwise Automatic: `hint`, how it was opened
+ * (a page Windows handed Deck as the browser), then the plugin that claims the type, then the Editor.
+ */
+export declare function openerFor(path: string, hint?: Opener, prefs?: Record<string, string>): Opener;
+/** `C:\a b\x.html` as file:///C:/a%20b/x.html, for a browser tab. */
+export declare const fileUrl: (path: string) => string;
+/**
+ * Open `path` where its type opens (`openerFor`), as a tab of its own. False when that is the
+ * Editor, which the caller opens it in. Every way Deck opens a file asks this first.
+ */
+export declare function openByType(path: string, hint?: Opener): boolean;