@termix-ssh/plugin-sdk 1.0.15 → 1.0.17

package/dist/frontend.d.ts

@@ -773,6 +773,43 @@ export interface SettingsComponentProps {
     setValue: (key: string, value: unknown) => void;
     running: boolean;
 }
+/** What a companion starts with. Read from the plugin's own settings. */
+export interface CompanionDefaults {
+    /** Open by itself the first time a matching tab shows. */
+    open?: boolean;
+    side?: "left" | "right" | "bottom";
+    /** Pixels of width, or height at the bottom. */
+    size?: number;
+    /** Show the edge button that opens and closes it. Default true. */
+    edgeButton?: boolean;
+}
+export interface CompanionProps {
+    /** The tab it sits beside. */
+    tab: PluginTabRecord;
+    host?: PluginHostRecord;
+    /** The host in the shape the connection APIs take. */
+    sshHost?: Record<string, unknown>;
+    /** The tab's surface handle (see TabHandle), read at call time. */
+    getHandle: () => TabHandle | null;
+    side: "left" | "right" | "bottom";
+    /** False while the tab is in the background or the panel is closed. */
+    isVisible: boolean;
+    close: () => void;
+    setSide: (side: "left" | "right" | "bottom") => void;
+}
+export interface CompanionOptions {
+    icon?: IconComponent;
+    titleKey?: string;
+    order?: number;
+    /** Tab types it applies to. Any tab with a host when empty. */
+    tabTypes?: string[];
+    when?: (tab: PluginTabRecord, host?: PluginHostRecord) => boolean;
+    /**
+     * A hook returning the starting state. It runs in the plugin's scope, so it
+     * can read the plugin's settings.
+     */
+    useDefaults?: () => CompanionDefaults;
+}
 export type ActionHandler = (...args: never[]) => unknown;
 export interface ActionSlotDefinition {
     id: string;
@@ -1001,6 +1038,14 @@ export interface TermixApp extends TermixAppInfo {
     registerRailItem: (item: RailItemContribution) => Disposer;
     registerPanel: (id: string, component: ComponentType<PanelProps>, options?: PanelOptions) => Disposer;
     registerTab: (type: string, component: ComponentType<TabProps>, options?: TabOptions) => Disposer;
+    /**
+     * A panel that sits beside any host tab the options match (a terminal, a
+     * desktop, ...), bound to that tab's host. The user opens, resizes and moves
+     * it; the tab keeps running underneath.
+     */
+    registerCompanion: (id: string, component: ComponentType<CompanionProps>, options?: CompanionOptions) => Disposer;
+    /** Opens a companion on a tab, or closes it when it is showing. */
+    toggleCompanion: (tab: PluginTabRecord, id?: string) => void;
     registerHostEditorSection: (section: HostEditorSectionContribution) => Disposer;
     registerHostAction: (action: HostActionContribution) => Disposer;
     registerHostProtocol: (protocol: HostProtocolContribution) => Disposer;

package/dist/host/{PluginsTab-S33WIIGC.js → PluginsTab-YAGYRBIE.js}

@@ -29,7 +29,7 @@ import {
   sortPlugins,
   uploadEntry,
   youtubeEmbedUrl
-} from "./chunk-VFTB2RDP.js";
+} from "./chunk-446UEDSK.js";
 import {
   ArrowDownWideNarrow,
   BookOpen,
@@ -107,8 +107,8 @@ import {
   updatePlugin,
   uploadPlugin,
   useConfirm
-} from "./chunk-2IV3VX7F.js";
-import "./chunk-3L45NNT5.js";
+} from "./chunk-LQKK2JJA.js";
+import "./chunk-7LEJ3HYF.js";
 import {
   __toESM,
   define_import_meta_env_default,

package/dist/host/{chunk-57DJU2ZA.js → chunk-2MU6WNSX.js}

@@ -26,7 +26,7 @@ var inFlight = null;
 function load() {
   if (cache) return Promise.resolve(cache);
   if (inFlight) return inFlight;
-  inFlight = import("./rbac-api-KA5IPQQL.js").then(({ getMyPermissions }) => getMyPermissions()).then((result) => {
+  inFlight = import("./rbac-api-LZVENREG.js").then(({ getMyPermissions }) => getMyPermissions()).then((result) => {
     cache = {
       permissions: result.permissions ?? [],
       isAdmin: !!result.isAdmin

package/dist/host/{chunk-VFTB2RDP.js → chunk-446UEDSK.js}

@@ -7,10 +7,10 @@ import {
   Trash,
   cn,
   useAreaPreferences
-} from "./chunk-2IV3VX7F.js";
+} from "./chunk-LQKK2JJA.js";
 import {
   isElectron
-} from "./chunk-3L45NNT5.js";
+} from "./chunk-7LEJ3HYF.js";
 import {
   __commonJS,
   __toESM,
@@ -2383,6 +2383,8 @@ var CAPABILITY_CATALOG = [
   entry("db:core-refs", "high"),
   entry("auth:provide", "high"),
   entry("auth:policy", "high"),
+  entry("sync:provide", "high"),
+  entry("ssh:transport", "high"),
   entry("device:serial", "high"),
   entry("notify:hub", "high"),
   entry("ui:layout", "high"),

package/dist/host/{chunk-3L45NNT5.js → chunk-7LEJ3HYF.js}

@@ -7,6 +7,7 @@ import {
 
 // src/ui/lib/linked-server.ts
 init_define_import_meta_env();
+import { useEffect as useEffect2, useState as useState2 } from "react";
 
 // src/ui/lib/electron.ts
 init_define_import_meta_env();
@@ -5432,7 +5433,6 @@ init_define_import_meta_env();
 init_define_import_meta_env();
 var LEGACY_SEEN = Object.freeze({
   plugins: 1,
-  "desktop-sync": 1,
   preset: 1,
   appearance: 1,
   security: 1
@@ -6316,7 +6316,7 @@ async function updateRole(roleId, roleData) {
   try {
     const response = await rbacApi.put(`/rbac/roles/${roleId}`, roleData);
     if (roleData.permissions) {
-      const { notifyPermissionsChanged } = await import("./use-permissions-LLN6TLAL.js");
+      const { notifyPermissionsChanged } = await import("./use-permissions-BYCDS5PD.js");
       notifyPermissionsChanged();
     }
     return response.data;
@@ -6898,7 +6898,7 @@ function createRemoteOriginApiInstance(path) {
   });
   instance.interceptors.request.use(
     async (config) => {
-      const { getLinkedSession: getLinkedSession2 } = await import("./linked-server-SCJH7DSL.js");
+      const { getLinkedSession: getLinkedSession2 } = await import("./linked-server-OUF3POT7.js");
       const linked = await getLinkedSession2();
       config.baseURL = linked ? `${linked.serverUrl}${path}` : "http://no-server-configured";
       if (config.headers.set) {
@@ -7287,6 +7287,22 @@ function notifySyncChanged() {
   cached = null;
   window.dispatchEvent(new CustomEvent(SYNC_CHANGED_EVENT));
 }
+function useDesktopLinked() {
+  const [linked, setLinked] = useState2(false);
+  useEffect2(() => {
+    let live = true;
+    const read = () => void getLinkedSession().then((session) => {
+      if (live) setLinked(!!session);
+    });
+    read();
+    window.addEventListener(SYNC_CHANGED_EVENT, read);
+    return () => {
+      live = false;
+      window.removeEventListener(SYNC_CHANGED_EVENT, read);
+    };
+  }, []);
+  return linked;
+}
 
 export {
   getPluginStoreState,
@@ -7332,6 +7348,7 @@ export {
   websocketAuthProtocols,
   getLinkedSession,
   notifySyncChanged,
+  useDesktopLinked,
   resolveConnectionOrigin,
   buildOriginWsUrl,
   getAllServerStatuses,