@termix-ssh/plugin-sdk 1.0.2 → 1.0.4

package/dist/host/{chunk-SS43S6VI.js → chunk-RU4E5XLY.js}

@@ -2,10 +2,11 @@ const __termixNoGlob = () => ({});
 import {
   hasPermission,
   usePermissions
-} from "./chunk-XKMRKQFN.js";
+} from "./chunk-O2OHNVFX.js";
 import {
   PRESETS,
   SYNC_CHANGED_EVENT,
+  TRUST_TOKEN_KEY,
   authApi,
   buildOriginWsUrl,
   byOrderThenId,
@@ -38,7 +39,7 @@ import {
   usePluginStore,
   useTabTypes,
   websocketAuthProtocols
-} from "./chunk-LKYAVM4T.js";
+} from "./chunk-F5RZH6HE.js";
 import {
   __export,
   define_import_meta_env_default
@@ -14572,9 +14573,6 @@ function resetShellBridge() {
   setShellHosts([], false);
 }
 
-// src/ui/components/panel-layout.tsx
-import { Children as Children5, Fragment as Fragment11, useRef as useRef28 } from "react";
-
 // node_modules/lucide-react/dist/esm/icons/index.mjs
 var icons_exports = {};
 __export(icons_exports, {
@@ -48949,9 +48947,294 @@ var __iconData1857 = {
 __iconData1857.node;
 var ZoomOut = createLucideIcon(__iconData1857);
 
-// src/ui/components/panel-layout.tsx
+// src/ui/components/docs-link.tsx
+import { useTranslation as useTranslation2 } from "react-i18next";
+
+// packages/plugin-sdk/dist/docs.js
+function pluginDocsUrl(value) {
+  if (typeof value !== "string")
+    return null;
+  try {
+    const url = new URL(value.trim());
+    if (url.protocol !== "https:")
+      return null;
+    return url.toString().replace(/\/$/, "");
+  } catch {
+    return null;
+  }
+}
+function pluginDocsPage(base, page, anchor) {
+  const clean = (page ?? "").replace(/^\/+|\/+$/g, "");
+  const url = clean ? `${base}/${clean}` : base;
+  return anchor ? `${url}#${anchor.replace(/^#/, "")}` : url;
+}
+
+// src/ui/lib/docs-pages.json
+var docs_pages_default = {
+  home: "",
+  install: "install",
+  updating: "install/updating",
+  betas: "configure/betas",
+  envVars: "configure/environment-variables",
+  https: "configure/https",
+  database: "configure/database",
+  reverseProxy: "configure/reverse-proxy",
+  desktopSync: "configure/desktop-sync",
+  interface: "guide/interface",
+  dashboard: "guide/dashboard",
+  manage: "guide/manage",
+  hosts: "guide/hosts",
+  portKnocking: "guide/hosts#port-knocking",
+  hostDefaults: "guide/host-defaults",
+  credentials: "guide/credentials",
+  sharing: "guide/sharing",
+  account: "guide/account",
+  accountSecurity: "guide/account#security",
+  accountData: "guide/account#your-data",
+  apiKeys: "guide/api-keys",
+  commandPalette: "guide/command-palette",
+  settings: "guide/settings",
+  interfaceSettings: "guide/settings#interface",
+  appearance: "guide/settings#appearance",
+  keybindings: "guide/settings#keybindings",
+  users: "guide/users",
+  sessions: "guide/users#sessions",
+  roles: "guide/roles",
+  adminGeneral: "guide/admin-settings",
+  branding: "guide/admin-settings#branding",
+  adminDatabase: "guide/admin-settings#database",
+  adminSsl: "configure/https",
+  auditLog: "guide/audit-log",
+  importExport: "guide/import-export",
+  plugins: "guide/plugins",
+  pluginCatalog: "plugins",
+  cli: "cli",
+  develop: "develop"
+};
+
+// src/ui/lib/docs.ts
+var DOCS_URL = "https://docs.termix.site";
+function docsUrl(page = "home") {
+  const path2 = docs_pages_default[page] ?? "";
+  return path2 ? `${DOCS_URL}/${path2}` : `${DOCS_URL}/`;
+}
+
+// src/ui/plugin-host/scope.tsx
+import {
+  Component as Component2,
+  createContext as createContext6,
+  Suspense,
+  useContext as useContext5
+} from "react";
+
+// src/ui/plugin-host/host-scope.ts
+function isHostLike(value) {
+  if (!value || typeof value !== "object" || Array.isArray(value)) return false;
+  if (!("id" in value)) return false;
+  return "pluginSettings" in value || "ip" in value && "port" in value;
+}
+var cache = /* @__PURE__ */ new WeakMap();
+function scopeHost(value, pluginId) {
+  if (!isHostLike(value)) return value;
+  const full = shellHost(value.id)?.pluginSettings ?? value.pluginSettings;
+  let perPlugin = cache.get(value);
+  const hit = perPlugin?.get(pluginId);
+  if (hit && hit.source === full) return hit.scoped;
+  const own = full?.[pluginId];
+  const scoped = { ...value, pluginSettings: own ? { [pluginId]: own } : {} };
+  if (!perPlugin) {
+    perPlugin = /* @__PURE__ */ new Map();
+    cache.set(value, perPlugin);
+  }
+  perPlugin.set(pluginId, { source: full, scoped });
+  return scoped;
+}
+function scopeHostArgs(args, pluginId) {
+  return args.map(
+    (arg) => isHostLike(arg) ? scopeHost(arg, pluginId) : scopeHostFields(arg, pluginId)
+  );
+}
+var HOST_FIELDS = ["host", "sshHost", "hostConfig"];
+function scopeHostFields(value, pluginId) {
+  if (!value || typeof value !== "object" || Array.isArray(value)) return value;
+  const record = value;
+  let next = null;
+  for (const field of HOST_FIELDS) {
+    if (!(field in record)) continue;
+    const scoped = scopeHost(record[field], pluginId);
+    if (scoped === record[field]) continue;
+    next ??= { ...record };
+    next[field] = scoped;
+  }
+  return next ?? value;
+}
+function scopeHostCallback(fn, pluginId) {
+  if (!fn) return fn;
+  return ((...args) => fn(...scopeHostArgs(args, pluginId)));
+}
+
+// src/ui/plugin-host/scope.tsx
 import { useTranslation } from "react-i18next";
-import { Fragment as Fragment12, jsx as jsx29, jsxs as jsxs7 } from "react/jsx-runtime";
+import { jsx as jsx29, jsxs as jsxs7 } from "react/jsx-runtime";
+var PluginScopeContext = createContext6(null);
+function usePluginScope() {
+  return useContext5(PluginScopeContext);
+}
+function CrashNotice({
+  pluginId,
+  onRetry
+}) {
+  const { t } = useTranslation();
+  const name = getPluginRecord(pluginId)?.summary.name ?? pluginId;
+  return /* @__PURE__ */ jsxs7("div", { className: "flex flex-col items-center justify-center gap-2 p-4 text-center text-sm text-muted-foreground", children: [
+    /* @__PURE__ */ jsx29("span", { children: t("plugins.runtime.crashed", { name }) }),
+    /* @__PURE__ */ jsx29(
+      "button",
+      {
+        type: "button",
+        className: "text-xs underline underline-offset-2 hover:text-foreground",
+        onClick: onRetry,
+        children: t("plugins.runtime.retry")
+      }
+    )
+  ] });
+}
+var PluginErrorBoundary = class extends Component2 {
+  state = { error: false };
+  static getDerivedStateFromError() {
+    return { error: true };
+  }
+  componentDidCatch(error, info) {
+    console.error(
+      `[plugins] ${this.props.pluginId} crashed while rendering`,
+      error,
+      info.componentStack
+    );
+  }
+  render() {
+    if (this.state.error) {
+      return /* @__PURE__ */ jsx29(
+        CrashNotice,
+        {
+          pluginId: this.props.pluginId,
+          onRetry: () => this.setState({ error: false })
+        }
+      );
+    }
+    return this.props.children;
+  }
+};
+function PluginScope({
+  pluginId,
+  children
+}) {
+  return /* @__PURE__ */ jsx29(PluginScopeContext.Provider, { value: pluginId, children: /* @__PURE__ */ jsx29(PluginErrorBoundary, { pluginId, children: /* @__PURE__ */ jsx29(Suspense, { fallback: null, children }) }) });
+}
+function withPluginScope(pluginId, Inner) {
+  function Scoped(props) {
+    return /* @__PURE__ */ jsx29(PluginScope, { pluginId, children: /* @__PURE__ */ jsx29(Inner, { ...scopeHostFields(props, pluginId) }) });
+  }
+  Scoped.displayName = `Plugin(${pluginId}:${Inner.displayName ?? Inner.name ?? "Component"})`;
+  return Scoped;
+}
+var IconBoundary = class extends Component2 {
+  state = { error: false };
+  static getDerivedStateFromError() {
+    return { error: true };
+  }
+  componentDidCatch(error) {
+    console.error(`[plugins] ${this.props.pluginId} icon failed`, error);
+  }
+  render() {
+    return this.state.error ? null : this.props.children;
+  }
+};
+function withIconBoundary(pluginId, Icon2) {
+  if (!Icon2) return void 0;
+  function SafeIcon(props) {
+    return /* @__PURE__ */ jsx29(IconBoundary, { pluginId, children: /* @__PURE__ */ jsx29(Icon2, { ...props }) });
+  }
+  SafeIcon.displayName = `PluginIcon(${pluginId})`;
+  return SafeIcon;
+}
+function guardCallback(pluginId, fn, fallback) {
+  if (!fn) return void 0;
+  return (...args) => {
+    try {
+      return fn(...args);
+    } catch (error) {
+      console.error(`[plugins] ${pluginId} callback failed`, error);
+      return fallback;
+    }
+  };
+}
+
+// src/ui/components/docs-link.tsx
+import { jsx as jsx30 } from "react/jsx-runtime";
+function usePluginDocsUrl(pluginId, page, anchor) {
+  const { records } = usePluginStore();
+  const base = pluginId ? records.get(pluginId)?.summary.docs : void 0;
+  return base ? pluginDocsPage(base, page, anchor) : null;
+}
+function DocsLink({
+  core,
+  page,
+  anchor,
+  href,
+  variant = "text",
+  children,
+  className
+}) {
+  const { t } = useTranslation2();
+  const pluginId = usePluginScope();
+  const pluginUrl = usePluginDocsUrl(
+    page !== void 0 ? pluginId : null,
+    page,
+    anchor
+  );
+  const url = href ?? (core ? withAnchor(docsUrl(core), anchor) : null) ?? pluginUrl;
+  if (!url) return null;
+  const label = t("common.docs");
+  if (variant === "icon") {
+    return /* @__PURE__ */ jsx30(
+      "a",
+      {
+        href: url,
+        target: "_blank",
+        rel: "noopener noreferrer",
+        title: label,
+        "aria-label": label,
+        className: cn(
+          "flex size-7 shrink-0 items-center justify-center text-muted-foreground transition-colors hover:bg-muted/40 hover:text-foreground",
+          className
+        ),
+        children: /* @__PURE__ */ jsx30(BookOpen, { className: "size-3.5" })
+      }
+    );
+  }
+  return /* @__PURE__ */ jsx30(
+    "a",
+    {
+      href: url,
+      target: "_blank",
+      rel: "noopener noreferrer",
+      className: cn(
+        "shrink-0 text-[10px] text-accent-brand hover:underline",
+        className
+      ),
+      children: children ?? label
+    }
+  );
+}
+function withAnchor(url, anchor) {
+  if (!anchor) return url;
+  return `${url.split("#")[0]}#${anchor.replace(/^#/, "")}`;
+}
+
+// src/ui/components/panel-layout.tsx
+import { Children as Children5, Fragment as Fragment11, useRef as useRef28 } from "react";
+import { useTranslation as useTranslation3 } from "react-i18next";
+import { Fragment as Fragment12, jsx as jsx31, jsxs as jsxs8 } from "react/jsx-runtime";
 var PANEL = {
   body: "p-2.5",
   gap: "gap-2",
@@ -48970,10 +49253,11 @@ function PanelShell({
   tabs,
   footer,
   scroll = true,
+  docs,
   className,
   children
 }) {
-  const body = /* @__PURE__ */ jsx29(
+  const body = /* @__PURE__ */ jsx31(
     "div",
     {
       className: cn(
@@ -48984,43 +49268,49 @@ function PanelShell({
       children
     }
   );
-  const bands = /* @__PURE__ */ jsxs7(Fragment12, { children: [
-    toolbar && /* @__PURE__ */ jsx29(
+  const bands = /* @__PURE__ */ jsxs8(Fragment12, { children: [
+    toolbar && /* @__PURE__ */ jsx31(
       "div",
       {
         className: `flex shrink-0 items-center gap-2 border-b border-border ${PANEL.band}`,
         children: toolbar
       }
     ),
-    tabs && /* @__PURE__ */ jsx29("div", { className: "shrink-0 border-b border-border px-1", children: tabs })
+    tabs && /* @__PURE__ */ jsx31("div", { className: "shrink-0 border-b border-border px-1", children: tabs })
   ] });
-  const foot = footer && /* @__PURE__ */ jsx29("div", { className: "flex shrink-0 items-center gap-2 border-t border-border px-3 py-2", children: footer });
+  const foot = footer && /* @__PURE__ */ jsx31("div", { className: "flex shrink-0 items-center gap-2 border-t border-border px-3 py-2", children: footer });
   if (!chrome) {
-    return /* @__PURE__ */ jsxs7("div", { className: "flex min-h-0 flex-1 flex-col", children: [
+    return /* @__PURE__ */ jsxs8("div", { className: "flex min-h-0 flex-1 flex-col", children: [
       bands,
       body,
       foot
     ] });
   }
-  return /* @__PURE__ */ jsxs7("div", { className: "flex h-full min-h-0 flex-1 flex-col overflow-hidden bg-background", children: [
-    /* @__PURE__ */ jsxs7(
+  return /* @__PURE__ */ jsxs8("div", { className: "flex h-full min-h-0 flex-1 flex-col overflow-hidden bg-background", children: [
+    /* @__PURE__ */ jsxs8(
       "header",
       {
         className: `flex ${PANEL.header} shrink-0 flex-row items-center border-b border-border`,
         children: [
-          leading && /* @__PURE__ */ jsxs7(Fragment12, { children: [
-            leading,
-            /* @__PURE__ */ jsx29(Separator4, { orientation: "vertical" })
-          ] }),
-          /* @__PURE__ */ jsxs7("div", { className: "flex min-w-0 flex-1 items-center gap-2 px-3", children: [
-            icon && /* @__PURE__ */ jsx29("span", { className: "shrink-0 text-accent-brand", children: icon }),
-            /* @__PURE__ */ jsx29("span", { className: "truncate text-base font-bold tracking-tight", children: title }),
-            status && /* @__PURE__ */ jsxs7(Fragment12, { children: [
-              /* @__PURE__ */ jsx29(Separator4, { orientation: "vertical", className: "h-4 self-center" }),
-              /* @__PURE__ */ jsx29("span", { className: "truncate text-[10px] font-semibold uppercase tracking-widest text-muted-foreground", children: status })
+          leading && /* @__PURE__ */ jsx31("div", { className: "flex h-full shrink-0 border-r border-border", children: leading }),
+          /* @__PURE__ */ jsxs8("div", { className: "flex min-w-0 flex-1 items-center gap-2 px-3", children: [
+            icon && /* @__PURE__ */ jsx31("span", { className: "shrink-0 text-accent-brand", children: icon }),
+            /* @__PURE__ */ jsx31("span", { className: "truncate text-base font-bold tracking-tight", children: title }),
+            status && /* @__PURE__ */ jsxs8(Fragment12, { children: [
+              /* @__PURE__ */ jsx31(
+                Separator4,
+                {
+                  orientation: "vertical",
+                  className: "h-4 data-[orientation=vertical]:self-center"
+                }
+              ),
+              /* @__PURE__ */ jsx31("span", { className: "truncate text-[10px] font-semibold uppercase tracking-widest text-muted-foreground", children: status })
             ] })
           ] }),
-          actions4 && /* @__PURE__ */ jsx29("div", { className: "flex shrink-0 items-center gap-1 px-2", children: actions4 })
+          (actions4 || docs) && /* @__PURE__ */ jsxs8("div", { className: "flex shrink-0 items-center gap-1 px-2", children: [
+            actions4,
+            docs && /* @__PURE__ */ jsx31(DocsLink, { href: docs, variant: "icon" })
+          ] })
         ]
       }
     ),
@@ -49034,9 +49324,9 @@ function BackButton({
   label,
   className
 }) {
-  const { t } = useTranslation();
+  const { t } = useTranslation3();
   const text = label ?? t("common.back");
-  return /* @__PURE__ */ jsx29(
+  return /* @__PURE__ */ jsx31(
     "button",
     {
       type: "button",
@@ -49047,7 +49337,7 @@ function BackButton({
         "flex h-full w-12.5 shrink-0 items-center justify-center text-muted-foreground transition-colors hover:bg-muted/40 hover:text-foreground focus-visible:ring-1 focus-visible:ring-ring",
         className
       ),
-      children: /* @__PURE__ */ jsx29(ArrowLeft, { className: "size-4" })
+      children: /* @__PURE__ */ jsx31(ArrowLeft, { className: "size-4" })
     }
   );
 }
@@ -49063,10 +49353,10 @@ function PanelSearch({
   inputRef,
   className
 }) {
-  const { t } = useTranslation();
+  const { t } = useTranslation3();
   const localRef = useRef28(null);
   const text = placeholder ?? t("common.search");
-  return /* @__PURE__ */ jsxs7(
+  return /* @__PURE__ */ jsxs8(
     "div",
     {
       className: cn(
@@ -49075,8 +49365,8 @@ function PanelSearch({
         className
       ),
       children: [
-        /* @__PURE__ */ jsx29(Search, { className: "pointer-events-none absolute left-2.5 top-1/2 size-3.5 -translate-y-1/2 text-muted-foreground" }),
-        /* @__PURE__ */ jsx29(
+        /* @__PURE__ */ jsx31(Search, { className: "pointer-events-none absolute left-2.5 top-1/2 size-3.5 -translate-y-1/2 text-muted-foreground" }),
+        /* @__PURE__ */ jsx31(
           "input",
           {
             ref: (el) => {
@@ -49106,7 +49396,7 @@ function PanelSearch({
             className: "h-8 w-full min-w-0 border border-input bg-transparent pl-8 pr-7 text-xs outline-none transition-colors placeholder:text-muted-foreground focus-visible:border-ring focus-visible:ring-1 focus-visible:ring-ring/50 disabled:cursor-not-allowed disabled:opacity-50 dark:bg-input/30"
           }
         ),
-        value && /* @__PURE__ */ jsx29(
+        value && /* @__PURE__ */ jsx31(
           "button",
           {
             type: "button",
@@ -49117,7 +49407,7 @@ function PanelSearch({
               localRef.current?.focus();
             },
             className: "absolute right-1.5 top-1/2 flex size-5 -translate-y-1/2 items-center justify-center text-muted-foreground hover:text-foreground",
-            children: /* @__PURE__ */ jsx29(X, { className: "size-3" })
+            children: /* @__PURE__ */ jsx31(X, { className: "size-3" })
           }
         )
       ]
@@ -49130,14 +49420,14 @@ function Segmented({
   options: options2,
   className
 }) {
-  return /* @__PURE__ */ jsx29(
+  return /* @__PURE__ */ jsx31(
     "div",
     {
       role: "radiogroup",
       className: cn("flex items-center border border-border", className),
       children: options2.map((option, i) => {
         const active = option.value === value;
-        return /* @__PURE__ */ jsxs7(
+        return /* @__PURE__ */ jsxs8(
           "button",
           {
             type: "button",
@@ -49153,7 +49443,7 @@ function Segmented({
             children: [
               option.icon,
               option.label,
-              option.count !== void 0 && /* @__PURE__ */ jsx29("span", { className: "text-[10px] tabular-nums opacity-60", children: option.count })
+              option.count !== void 0 && /* @__PURE__ */ jsx31("span", { className: "text-[10px] tabular-nums opacity-60", children: option.count })
             ]
           },
           option.value
@@ -49168,35 +49458,35 @@ function ViewToggle({
   density,
   onDensity
 }) {
-  const { t } = useTranslation();
-  return /* @__PURE__ */ jsxs7("div", { className: "flex items-center border border-border", children: [
-    /* @__PURE__ */ jsx29(
+  const { t } = useTranslation3();
+  return /* @__PURE__ */ jsxs8("div", { className: "flex items-center border border-border", children: [
+    /* @__PURE__ */ jsx31(
       ToggleButton,
       {
         active: view === "grid",
         onClick: () => onView("grid"),
         title: t("panel.gridView"),
-        children: /* @__PURE__ */ jsx29(Grid3x3, { className: "size-4" })
+        children: /* @__PURE__ */ jsx31(Grid3x3, { className: "size-4" })
       }
     ),
-    /* @__PURE__ */ jsx29(
+    /* @__PURE__ */ jsx31(
       ToggleButton,
       {
         active: view === "list",
         onClick: () => onView("list"),
         title: t("panel.listView"),
         bordered: true,
-        children: /* @__PURE__ */ jsx29(List2, { className: "size-4" })
+        children: /* @__PURE__ */ jsx31(List2, { className: "size-4" })
       }
     ),
-    density && onDensity && /* @__PURE__ */ jsx29(
+    density && onDensity && /* @__PURE__ */ jsx31(
       ToggleButton,
       {
         active: density === "compact",
         onClick: () => onDensity(density === "compact" ? "comfortable" : "compact"),
         title: density === "compact" ? t("panel.comfortableRows") : t("panel.compactRows"),
         bordered: true,
-        children: /* @__PURE__ */ jsx29(Rows3, { className: "size-4" })
+        children: /* @__PURE__ */ jsx31(Rows3, { className: "size-4" })
       }
     )
   ] });
@@ -49208,7 +49498,7 @@ function ToggleButton({
   bordered,
   children
 }) {
-  return /* @__PURE__ */ jsx29(
+  return /* @__PURE__ */ jsx31(
     "button",
     {
       type: "button",
@@ -49231,9 +49521,9 @@ function Facts({
 }) {
   const items = Children5.toArray(children).filter(Boolean);
   if (items.length === 0) return null;
-  return /* @__PURE__ */ jsx29("span", { className: cn("flex min-w-0 items-center gap-2", className), children: items.map((child, i) => /* @__PURE__ */ jsxs7(Fragment11, { children: [
-    i > 0 && /* @__PURE__ */ jsx29("span", { "aria-hidden": true, className: "h-3 w-px shrink-0 bg-border" }),
-    /* @__PURE__ */ jsx29("span", { className: "min-w-0 truncate", children: child })
+  return /* @__PURE__ */ jsx31("span", { className: cn("flex min-w-0 items-center gap-2", className), children: items.map((child, i) => /* @__PURE__ */ jsxs8(Fragment11, { children: [
+    i > 0 && /* @__PURE__ */ jsx31("span", { "aria-hidden": true, className: "h-3 w-px shrink-0 bg-border" }),
+    /* @__PURE__ */ jsx31("span", { className: "min-w-0 truncate", children: child })
   ] }, i)) });
 }
 function GroupHeading({
@@ -49242,10 +49532,10 @@ function GroupHeading({
   action,
   className
 }) {
-  return /* @__PURE__ */ jsxs7("div", { className: cn("flex items-center gap-2", className), children: [
-    /* @__PURE__ */ jsx29("span", { className: "text-[10px] font-semibold uppercase tracking-widest text-muted-foreground", children: title }),
-    count3 !== void 0 && /* @__PURE__ */ jsx29("span", { className: "text-[10px] tabular-nums text-muted-foreground/60", children: count3 }),
-    /* @__PURE__ */ jsx29("div", { className: "h-px flex-1 bg-border" }),
+  return /* @__PURE__ */ jsxs8("div", { className: cn("flex items-center gap-2", className), children: [
+    /* @__PURE__ */ jsx31("span", { className: "text-[10px] font-semibold uppercase tracking-widest text-muted-foreground", children: title }),
+    count3 !== void 0 && /* @__PURE__ */ jsx31("span", { className: "text-[10px] tabular-nums text-muted-foreground/60", children: count3 }),
+    /* @__PURE__ */ jsx31("div", { className: "h-px flex-1 bg-border" }),
     action
   ] });
 }
@@ -49257,9 +49547,9 @@ var PROMPT_DESTRUCTIVE_BUTTON = "inline-flex h-7 items-center justify-center gap
 
 // src/ui/components/surface/surface-scope.tsx
 import {
-  createContext as createContext6,
+  createContext as createContext7,
   useCallback as useCallback18,
-  useContext as useContext5,
+  useContext as useContext6,
   useEffect as useEffect27,
   useId as useId2,
   useLayoutEffect as useLayoutEffect5,
@@ -49268,9 +49558,9 @@ import {
   useState as useState25
 } from "react";
 import { createPortal as createPortal3 } from "react-dom";
-import { useTranslation as useTranslation2 } from "react-i18next";
-import { Fragment as Fragment13, jsx as jsx30, jsxs as jsxs8 } from "react/jsx-runtime";
-var ScopeContext = createContext6(null);
+import { useTranslation as useTranslation4 } from "react-i18next";
+import { Fragment as Fragment13, jsx as jsx32, jsxs as jsxs9 } from "react/jsx-runtime";
+var ScopeContext = createContext7(null);
 function widest(widths) {
   if (widths.includes("wide")) return "wide";
   return widths.some(Boolean);
@@ -49339,7 +49629,7 @@ function SurfaceScope({
     [kind, overlay, openView, closeView, views, confirm, close]
   );
   const current = confirms[0];
-  return /* @__PURE__ */ jsx30(ScopeContext.Provider, { value, children: /* @__PURE__ */ jsxs8(
+  return /* @__PURE__ */ jsx32(ScopeContext.Provider, { value, children: /* @__PURE__ */ jsxs9(
     "div",
     {
       className: cn(
@@ -49348,7 +49638,7 @@ function SurfaceScope({
       ),
       children: [
         children,
-        /* @__PURE__ */ jsx30(
+        /* @__PURE__ */ jsx32(
           "div",
           {
             ref: setOverlay,
@@ -49358,7 +49648,7 @@ function SurfaceScope({
             )
           }
         ),
-        current && /* @__PURE__ */ jsx30(
+        current && /* @__PURE__ */ jsx32(
           ConfirmCard,
           {
             options: current,
@@ -49371,13 +49661,13 @@ function SurfaceScope({
   ) });
 }
 function useSurfaceKind() {
-  return useContext5(ScopeContext)?.kind ?? null;
+  return useContext6(ScopeContext)?.kind ?? null;
 }
 function useSurfaceClose() {
-  return useContext5(ScopeContext)?.close ?? null;
+  return useContext6(ScopeContext)?.close ?? null;
 }
 function useConfirm() {
-  const scope = useContext5(ScopeContext);
+  const scope = useContext6(ScopeContext);
   return useCallback18(
     (options2) => {
       if (scope) return scope.confirm(options2);
@@ -49391,7 +49681,7 @@ function ConfirmCard({
   options: options2,
   onSettle
 }) {
-  const { t } = useTranslation2();
+  const { t } = useTranslation4();
   const confirmRef = useRef29(null);
   const titleId = useId2();
   const destructive = options2.destructive ?? true;
@@ -49416,7 +49706,7 @@ function ConfirmCard({
       if (previous && document.contains(previous)) previous.focus();
     };
   }, []);
-  return /* @__PURE__ */ jsx30(
+  return /* @__PURE__ */ jsx32(
     PanePrompt,
     {
       open: true,
@@ -49427,8 +49717,8 @@ function ConfirmCard({
       description: options2.description,
       tone: destructive ? "destructive" : "default",
       onCancel: () => onSettle(false),
-      actions: /* @__PURE__ */ jsxs8(Fragment13, { children: [
-        /* @__PURE__ */ jsx30(
+      actions: /* @__PURE__ */ jsxs9(Fragment13, { children: [
+        /* @__PURE__ */ jsx32(
           "button",
           {
             type: "button",
@@ -49437,7 +49727,7 @@ function ConfirmCard({
             children: options2.cancelLabel ?? t("common.cancel")
           }
         ),
-        /* @__PURE__ */ jsxs8(
+        /* @__PURE__ */ jsxs9(
           "button",
           {
             ref: confirmRef,
@@ -49446,7 +49736,7 @@ function ConfirmCard({
             className: destructive ? PROMPT_DESTRUCTIVE_BUTTON : PROMPT_PRIMARY_BUTTON,
             children: [
               options2.confirmLabel ?? (destructive ? t("common.delete") : t("common.confirm")),
-              /* @__PURE__ */ jsx30("span", { "aria-hidden": true, className: "ml-1.5 opacity-60", children: "\u21B5" })
+              /* @__PURE__ */ jsx32("span", { "aria-hidden": true, className: "ml-1.5 opacity-60", children: "\u21B5" })
             ]
           }
         )
@@ -49473,31 +49763,31 @@ function PanePrompt({
   const fallbackId = useId2();
   if (!open) return null;
   const headingId = titleId ?? fallbackId;
-  return /* @__PURE__ */ jsx30(
+  return /* @__PURE__ */ jsx32(
     "div",
     {
       className: cn(
-        "motion-context-enter absolute inset-0 flex items-center justify-center overflow-y-auto p-4",
-        layer === "connection" ? "z-500 bg-canvas" : "z-50 bg-background/80 backdrop-blur-sm"
+        "motion-fade-enter absolute inset-0 flex items-center justify-center overflow-y-auto p-4",
+        layer === "connection" ? "z-500 bg-canvas" : "z-50 bg-background/85"
       ),
       style: layer === "connection" && backgroundColor ? { backgroundColor } : void 0,
       onMouseDown: (e) => {
         if (e.target === e.currentTarget) onCancel?.();
       },
-      children: /* @__PURE__ */ jsxs8(
+      children: /* @__PURE__ */ jsxs9(
         "div",
         {
           role,
           "aria-modal": "true",
           "aria-labelledby": labelledBy ?? headingId,
           className: cn(
-            "my-auto flex w-full max-w-sm flex-col border bg-popover shadow-xl",
+            "motion-context-enter my-auto flex w-full max-w-sm flex-col border bg-popover shadow-xl",
             tone === "destructive" ? "border-destructive/40" : "border-border",
             className
           ),
           children: [
-            /* @__PURE__ */ jsxs8("div", { className: "flex items-start gap-2.5 px-4 pt-4", children: [
-              icon && /* @__PURE__ */ jsx30(
+            /* @__PURE__ */ jsxs9("div", { className: "flex items-start gap-2.5 px-4 pt-4", children: [
+              icon && /* @__PURE__ */ jsx32(
                 "span",
                 {
                   className: cn(
@@ -49507,8 +49797,8 @@ function PanePrompt({
                   children: icon
                 }
               ),
-              /* @__PURE__ */ jsxs8("div", { className: "flex min-w-0 flex-col gap-1", children: [
-                /* @__PURE__ */ jsx30(
+              /* @__PURE__ */ jsxs9("div", { className: "flex min-w-0 flex-col gap-1", children: [
+                /* @__PURE__ */ jsx32(
                   "p",
                   {
                     id: headingId,
@@ -49516,12 +49806,12 @@ function PanePrompt({
                     children: title
                   }
                 ),
-                description && /* @__PURE__ */ jsx30("div", { className: "text-xs leading-snug text-muted-foreground", children: description })
+                description && /* @__PURE__ */ jsx32("div", { className: "text-xs leading-snug text-muted-foreground", children: description })
               ] })
             ] }),
-            children && /* @__PURE__ */ jsx30("div", { className: "px-4 pt-3", children }),
-            actions4 && /* @__PURE__ */ jsx30("div", { className: "flex justify-end gap-2 px-4 py-3", children: actions4 }),
-            !actions4 && /* @__PURE__ */ jsx30("div", { className: "h-4" })
+            children && /* @__PURE__ */ jsx32("div", { className: "px-4 pt-3", children }),
+            actions4 && /* @__PURE__ */ jsx32("div", { className: "flex justify-end gap-2 px-4 py-3", children: actions4 }),
+            !actions4 && /* @__PURE__ */ jsx32("div", { className: "h-4" })
           ]
         }
       )
@@ -49544,7 +49834,7 @@ function InlineView({
   className,
   children
 }) {
-  const scope = useContext5(ScopeContext);
+  const scope = useContext6(ScopeContext);
   const id = useId2();
   const { openView, closeView } = scope ?? {};
   useLayoutEffect5(() => {
@@ -49558,7 +49848,7 @@ function InlineView({
   }, [onBeforeClose, onOpenChange]);
   if (!open) return null;
   const padded = scope?.kind === "tab" || scope?.kind === "pane";
-  const view = /* @__PURE__ */ jsx30(
+  const view = /* @__PURE__ */ jsx32(
     "div",
     {
       className: cn(
@@ -49571,10 +49861,10 @@ function InlineView({
           void requestClose();
         }
       },
-      children: /* @__PURE__ */ jsx30(
+      children: /* @__PURE__ */ jsx32(
         PanelShell,
         {
-          leading: /* @__PURE__ */ jsx30(BackButton, { onClick: () => void requestClose() }),
+          leading: /* @__PURE__ */ jsx32(BackButton, { onClick: () => void requestClose() }),
           icon,
           title,
           status,
@@ -49582,7 +49872,7 @@ function InlineView({
           toolbar,
           footer,
           scroll,
-          children: bare ? children : /* @__PURE__ */ jsx30(
+          children: bare ? children : /* @__PURE__ */ jsx32(
             "div",
             {
               className: cn(
@@ -49601,7 +49891,7 @@ function InlineView({
   if (scope?.overlay) return createPortal3(view, scope.overlay);
   if (scope) return null;
   return createPortal3(
-    /* @__PURE__ */ jsx30("div", { className: "fixed inset-0 z-50 bg-background", children: view }),
+    /* @__PURE__ */ jsx32("div", { className: "fixed inset-0 z-50 bg-background", children: view }),
     document.body
   );
 }
@@ -50252,7 +50542,8 @@ var en_default = {
     mobileSidebarDescription: "Displays the mobile sidebar.",
     toggleSidebar: "Toggle Sidebar",
     search: "Search...",
-    new: "New"
+    new: "New",
+    docs: "Docs"
   },
   onboarding: {
     stepCounter: "Step {{current}} of {{total}}",
@@ -50296,7 +50587,8 @@ var en_default = {
     desktopLocalBody: "Everything is stored here. Nothing to set up.",
     desktopLinkTitle: "With my Termix server",
     desktopLinkBody: "Sign in to your server to use the same hosts and settings on every device.",
-    desktopLinked: "Linked to {{server}}"
+    desktopLinked: "Linked to {{server}}",
+    pluginsDocsLink: "Read about each one"
   },
   nav: {
     home: "Home",
@@ -50974,7 +51266,8 @@ var en_default = {
     select: "Select",
     toggleWith: "Toggle with",
     pluginActions: "More actions",
-    noTargetTab: "No terminal tab is open"
+    noTargetTab: "No terminal tab is open",
+    documentation: "Documentation"
   },
   splitScreen: {
     title: "Split screen",
@@ -52229,7 +52522,11 @@ var en_default = {
         waitingForStable: "Back on stable. Stays on {{version}} until a stable release is newer.",
         versionLabel: "{{version}} (beta)",
         sendFeedback: "Send beta feedback"
-      }
+      },
+      documentation: "Documentation",
+      envVars: "Environment variables",
+      envRequired: "Required",
+      envDefault: "Default: {{value}}"
     }
   },
   settings: {
@@ -52514,6 +52811,7 @@ var en_default = {
     collapse: "Collapse",
     expand: "Expand",
     cannotBeUndone: "This cannot be undone.",
+    hostNotFound: "Couldn't find that host. Try refreshing the list.",
     hostCount_one: "{{count}} host",
     hostCount_other: "{{count}} hosts",
     credentialCount_one: "{{count}} credential",
@@ -52676,23 +52974,23 @@ import { useMemo as useMemo14, useSyncExternalStore as useSyncExternalStore3 } f
 
 // src/ui/contexts/UiPreferencesContext.tsx
 import {
-  createContext as createContext7,
+  createContext as createContext8,
   useCallback as useCallback19,
-  useContext as useContext6,
+  useContext as useContext7,
   useEffect as useEffect28,
   useMemo as useMemo13,
   useRef as useRef30,
   useState as useState26
 } from "react";
-import { jsx as jsx31 } from "react/jsx-runtime";
-var UiPreferencesContext = createContext7(
+import { jsx as jsx33 } from "react/jsx-runtime";
+var UiPreferencesContext = createContext8(
   null
 );
 function useUiPreferencesContext() {
-  return useContext6(UiPreferencesContext);
+  return useContext7(UiPreferencesContext);
 }
 function useAreaPreferences(area) {
-  const ctx = useContext6(UiPreferencesContext);
+  const ctx = useContext7(UiPreferencesContext);
   if (!ctx) return PRESETS.balanced[area];
   return ctx.resolve(area);
 }
@@ -52713,8 +53011,8 @@ registeredRailItems.subscribe(() => {
 
 // src/ui/components/tab-strip.tsx
 import { useEffect as useEffect29, useRef as useRef31, useState as useState27 } from "react";
-import { useTranslation as useTranslation3 } from "react-i18next";
-import { jsx as jsx32, jsxs as jsxs9 } from "react/jsx-runtime";
+import { useTranslation as useTranslation5 } from "react-i18next";
+import { jsx as jsx34, jsxs as jsxs10 } from "react/jsx-runtime";
 function TabStrip({
   tabs,
   activeTab,
@@ -52725,7 +53023,7 @@ function TabStrip({
   className
 }) {
   const ref = useRef31(null);
-  const { t } = useTranslation3();
+  const { t } = useTranslation5();
   const [scroll, setScroll] = useState27({ left: false, right: false });
   useEffect29(() => {
     const el = ref.current;
@@ -52757,7 +53055,7 @@ function TabStrip({
   }, []);
   const renderTab = (tab) => {
     const active = isActive ? isActive(tab.id) : activeTab === tab.id;
-    return /* @__PURE__ */ jsxs9(
+    return /* @__PURE__ */ jsxs10(
       "button",
       {
         type: "button",
@@ -52766,14 +53064,14 @@ function TabStrip({
         children: [
           tab.icon,
           tab.label,
-          tab.count !== void 0 && /* @__PURE__ */ jsx32("span", { className: "text-[10px] tabular-nums opacity-60", children: tab.count })
+          tab.count !== void 0 && /* @__PURE__ */ jsx34("span", { className: "text-[10px] tabular-nums opacity-60", children: tab.count })
         ]
       },
       tab.id
     );
   };
   const overflow = scroll.left || scroll.right;
-  return /* @__PURE__ */ jsxs9(
+  return /* @__PURE__ */ jsxs10(
     "div",
     {
       className: cn(
@@ -52782,7 +53080,7 @@ function TabStrip({
         className
       ),
       children: [
-        overflow && /* @__PURE__ */ jsx32(
+        overflow && /* @__PURE__ */ jsx34(
           "button",
           {
             type: "button",
@@ -52794,11 +53092,11 @@ function TabStrip({
               left: -ref.current.clientWidth * 0.75,
               behavior: "smooth"
             }),
-            children: /* @__PURE__ */ jsx32(ChevronLeft, { className: "size-4" })
+            children: /* @__PURE__ */ jsx34(ChevronLeft, { className: "size-4" })
           }
         ),
-        /* @__PURE__ */ jsx32("div", { ref, className: "min-w-0 flex-1 overflow-x-auto scrollbar-none", children: /* @__PURE__ */ jsx32("div", { className: "flex min-w-max", children: tabs.map(renderTab) }) }),
-        overflow && /* @__PURE__ */ jsx32(
+        /* @__PURE__ */ jsx34("div", { ref, className: "min-w-0 flex-1 overflow-x-auto scrollbar-none", children: /* @__PURE__ */ jsx34("div", { className: "flex min-w-max", children: tabs.map(renderTab) }) }),
+        overflow && /* @__PURE__ */ jsx34(
           "button",
           {
             type: "button",
@@ -52810,17 +53108,17 @@ function TabStrip({
               left: ref.current.clientWidth * 0.75,
               behavior: "smooth"
             }),
-            children: /* @__PURE__ */ jsx32(ChevronRight, { className: "size-4" })
+            children: /* @__PURE__ */ jsx34(ChevronRight, { className: "size-4" })
           }
         ),
-        trailing && /* @__PURE__ */ jsx32("div", { className: "flex shrink-0 items-center gap-1 px-1", children: trailing })
+        trailing && /* @__PURE__ */ jsx34("div", { className: "flex shrink-0 items-center gap-1 px-1", children: trailing })
       ]
     }
   );
 }
 
 // src/ui/sidebar/HostManagerTabs.tsx
-import { jsx as jsx33 } from "react/jsx-runtime";
+import { jsx as jsx35 } from "react/jsx-runtime";
 var sections = createRegistry(byOrderThenId);
 var registerHostEditorSection = sections.register;
 var unregisterHostEditorSection = sections.unregister;
@@ -53243,8 +53541,8 @@ function sectionPosition(section, order2 = 0) {
 }
 
 // src/ui/components/theme-provider.tsx
-import { createContext as createContext8, useContext as useContext7, useEffect as useEffect30, useState as useState28 } from "react";
-import { jsx as jsx34 } from "react/jsx-runtime";
+import { createContext as createContext9, useContext as useContext8, useEffect as useEffect30, useState as useState28 } from "react";
+import { jsx as jsx36 } from "react/jsx-runtime";
 var ALL_THEME_CLASSES = [
   "light",
   "dark",
@@ -53261,7 +53559,7 @@ var initialState = {
   setTheme: () => null,
   setThemePreview: () => null
 };
-var ThemeProviderContext = createContext8(initialState);
+var ThemeProviderContext = createContext9(initialState);
 function ThemeProvider({
   children,
   defaultTheme = "dark",
@@ -53293,10 +53591,10 @@ function ThemeProvider({
       setPreviewTheme(preview);
     }
   };
-  return /* @__PURE__ */ jsx34(ThemeProviderContext.Provider, { ...props, value, children });
+  return /* @__PURE__ */ jsx36(ThemeProviderContext.Provider, { ...props, value, children });
 }
 var useTheme = () => {
-  const context = useContext7(ThemeProviderContext);
+  const context = useContext8(ThemeProviderContext);
   if (context === void 0)
     throw new Error("useTheme must be used within a ThemeProvider");
   return context;
@@ -53504,162 +53802,13 @@ async function getPlugins() {
 }
 var PLUGINS_CHANGED_EVENT = "termix:plugins-changed";
 
-// src/ui/plugin-host/scope.tsx
-import {
-  Component as Component2,
-  createContext as createContext9,
-  Suspense,
-  useContext as useContext8
-} from "react";
-
-// src/ui/plugin-host/host-scope.ts
-function isHostLike(value) {
-  if (!value || typeof value !== "object" || Array.isArray(value)) return false;
-  if (!("id" in value)) return false;
-  return "pluginSettings" in value || "ip" in value && "port" in value;
-}
-var cache = /* @__PURE__ */ new WeakMap();
-function scopeHost(value, pluginId) {
-  if (!isHostLike(value)) return value;
-  const full = shellHost(value.id)?.pluginSettings ?? value.pluginSettings;
-  let perPlugin = cache.get(value);
-  const hit = perPlugin?.get(pluginId);
-  if (hit && hit.source === full) return hit.scoped;
-  const own = full?.[pluginId];
-  const scoped = { ...value, pluginSettings: own ? { [pluginId]: own } : {} };
-  if (!perPlugin) {
-    perPlugin = /* @__PURE__ */ new Map();
-    cache.set(value, perPlugin);
-  }
-  perPlugin.set(pluginId, { source: full, scoped });
-  return scoped;
-}
-function scopeHostArgs(args, pluginId) {
-  return args.map(
-    (arg) => isHostLike(arg) ? scopeHost(arg, pluginId) : scopeHostFields(arg, pluginId)
-  );
-}
-var HOST_FIELDS = ["host", "sshHost", "hostConfig"];
-function scopeHostFields(value, pluginId) {
-  if (!value || typeof value !== "object" || Array.isArray(value)) return value;
-  const record = value;
-  let next = null;
-  for (const field of HOST_FIELDS) {
-    if (!(field in record)) continue;
-    const scoped = scopeHost(record[field], pluginId);
-    if (scoped === record[field]) continue;
-    next ??= { ...record };
-    next[field] = scoped;
-  }
-  return next ?? value;
-}
-function scopeHostCallback(fn, pluginId) {
-  if (!fn) return fn;
-  return ((...args) => fn(...scopeHostArgs(args, pluginId)));
-}
-
-// src/ui/plugin-host/scope.tsx
-import { useTranslation as useTranslation4 } from "react-i18next";
-import { jsx as jsx35, jsxs as jsxs10 } from "react/jsx-runtime";
-var PluginScopeContext = createContext9(null);
-function usePluginScope() {
-  return useContext8(PluginScopeContext);
-}
-function CrashNotice({
-  pluginId,
-  onRetry
-}) {
-  const { t } = useTranslation4();
-  const name = getPluginRecord(pluginId)?.summary.name ?? pluginId;
-  return /* @__PURE__ */ jsxs10("div", { className: "flex flex-col items-center justify-center gap-2 p-4 text-center text-sm text-muted-foreground", children: [
-    /* @__PURE__ */ jsx35("span", { children: t("plugins.runtime.crashed", { name }) }),
-    /* @__PURE__ */ jsx35(
-      "button",
-      {
-        type: "button",
-        className: "text-xs underline underline-offset-2 hover:text-foreground",
-        onClick: onRetry,
-        children: t("plugins.runtime.retry")
-      }
-    )
-  ] });
-}
-var PluginErrorBoundary = class extends Component2 {
-  state = { error: false };
-  static getDerivedStateFromError() {
-    return { error: true };
-  }
-  componentDidCatch(error, info) {
-    console.error(
-      `[plugins] ${this.props.pluginId} crashed while rendering`,
-      error,
-      info.componentStack
-    );
-  }
-  render() {
-    if (this.state.error) {
-      return /* @__PURE__ */ jsx35(
-        CrashNotice,
-        {
-          pluginId: this.props.pluginId,
-          onRetry: () => this.setState({ error: false })
-        }
-      );
-    }
-    return this.props.children;
-  }
-};
-function PluginScope({
-  pluginId,
-  children
-}) {
-  return /* @__PURE__ */ jsx35(PluginScopeContext.Provider, { value: pluginId, children: /* @__PURE__ */ jsx35(PluginErrorBoundary, { pluginId, children: /* @__PURE__ */ jsx35(Suspense, { fallback: null, children }) }) });
-}
-function withPluginScope(pluginId, Inner) {
-  function Scoped(props) {
-    return /* @__PURE__ */ jsx35(PluginScope, { pluginId, children: /* @__PURE__ */ jsx35(Inner, { ...scopeHostFields(props, pluginId) }) });
-  }
-  Scoped.displayName = `Plugin(${pluginId}:${Inner.displayName ?? Inner.name ?? "Component"})`;
-  return Scoped;
-}
-var IconBoundary = class extends Component2 {
-  state = { error: false };
-  static getDerivedStateFromError() {
-    return { error: true };
-  }
-  componentDidCatch(error) {
-    console.error(`[plugins] ${this.props.pluginId} icon failed`, error);
-  }
-  render() {
-    return this.state.error ? null : this.props.children;
-  }
-};
-function withIconBoundary(pluginId, Icon2) {
-  if (!Icon2) return void 0;
-  function SafeIcon(props) {
-    return /* @__PURE__ */ jsx35(IconBoundary, { pluginId, children: /* @__PURE__ */ jsx35(Icon2, { ...props }) });
-  }
-  SafeIcon.displayName = `PluginIcon(${pluginId})`;
-  return SafeIcon;
-}
-function guardCallback(pluginId, fn, fallback) {
-  if (!fn) return void 0;
-  return (...args) => {
-    try {
-      return fn(...args);
-    } catch (error) {
-      console.error(`[plugins] ${pluginId} callback failed`, error);
-      return fallback;
-    }
-  };
-}
-
 // src/ui/hooks/useSshAuthProviders.ts
 import { useEffect as useEffect32, useMemo as useMemo15, useState as useState30 } from "react";
 
 // src/ui/api/auth-methods-api.ts
 function remember(data) {
   if (data?.token) localStorage.setItem("jwt", data.token);
+  if (data?.trustToken) localStorage.setItem(TRUST_TOKEN_KEY, data.trustToken);
   if (data?.success && !data.requires_totp) markUserAuthenticated();
   return data;
 }
@@ -53813,7 +53962,7 @@ function contextKey(context) {
   try {
     return JSON.stringify(context);
   } catch {
-    return String(Object.keys(context));
+    return Object.entries(context).map(([key, value]) => `${key}:${value == null ? "-" : typeof value}`).join(",");
   }
 }
 
@@ -53828,7 +53977,7 @@ import {
   useSyncExternalStore as useSyncExternalStore6,
   useState as useState31
 } from "react";
-import { jsx as jsx36 } from "react/jsx-runtime";
+import { jsx as jsx37 } from "react/jsx-runtime";
 var StatusStoreContext = createContext10(null);
 var ServerStatusContext = createContext10(null);
 var activeStore = null;
@@ -53950,6 +54099,9 @@ var pluginHostBridge = {
     }
     return pluginId;
   },
+  useDocsUrl(pluginId, page, anchor) {
+    return usePluginDocsUrl(pluginId, page, anchor);
+  },
   useTranslation(pluginId) {
     const { t, i18n: i18n2 } = useI18nTranslation(pluginId);
     return {
@@ -54176,6 +54328,18 @@ function pluginKey(pluginId, key) {
 
 // src/ui/plugin-host/app.ts
 var ONBOARDING_ID = /^[a-z0-9][a-z0-9-]{0,63}$/;
+function createDocsApi(manifest) {
+  const url = pluginDocsUrl(manifest?.docs);
+  const page = (name, anchor) => url ? pluginDocsPage(url, name, anchor) : null;
+  return {
+    url,
+    page,
+    open(name, anchor) {
+      const target = page(name, anchor);
+      if (target) window.open(target, "_blank", "noopener,noreferrer");
+    }
+  };
+}
 function createPluginApp(pluginId, manifest, contributes, options2 = {}) {
   const bag = [];
   let disposed = false;
@@ -54580,6 +54744,7 @@ function createPluginApp(pluginId, manifest, contributes, options2 = {}) {
       onReady: (listener) => track(tabsApi.onReady(listener))
     },
     confirm: (options3) => shell.confirm(options3),
+    docs: createDocsApi(manifest),
     desktop: {
       available: isElectron(),
       remoteServerUrl,
@@ -54622,8 +54787,8 @@ function createPluginApp(pluginId, manifest, contributes, options2 = {}) {
 
 // src/ui/shell/ActionSlot.tsx
 import React50 from "react";
-import { useTranslation as useTranslation5 } from "react-i18next";
-import { Fragment as Fragment14, jsx as jsx37, jsxs as jsxs11 } from "react/jsx-runtime";
+import { useTranslation as useTranslation6 } from "react-i18next";
+import { Fragment as Fragment14, jsx as jsx38, jsxs as jsxs11 } from "react/jsx-runtime";
 function ActionSlot({
   slotId,
   context,
@@ -54633,17 +54798,17 @@ function ActionSlot({
   hideLabels,
   when
 }) {
-  const { t } = useTranslation5();
+  const { t } = useTranslation6();
   const contributions2 = useActionSlot(slotId, when).filter(
     (contribution) => contribution.kind !== "component"
   );
   if (!enabled || contributions2.length === 0) return null;
-  return /* @__PURE__ */ jsx37(Fragment14, { children: contributions2.map((contribution) => {
+  return /* @__PURE__ */ jsx38(Fragment14, { children: contributions2.map((contribution) => {
     const invoke = () => {
       void invokeAction(contribution.actionId, ...context?.() ?? []);
     };
     if (renderItem) {
-      return /* @__PURE__ */ jsx37(React50.Fragment, { children: renderItem(contribution, invoke) }, contribution.actionId);
+      return /* @__PURE__ */ jsx38(React50.Fragment, { children: renderItem(contribution, invoke) }, contribution.actionId);
     }
     const Icon2 = contribution.icon;
     const label = t(contribution.titleKey);
@@ -54656,7 +54821,7 @@ function ActionSlot({
         title: label,
         onClick: invoke,
         children: [
-          Icon2 && /* @__PURE__ */ jsx37(Icon2, { className: "size-4 shrink-0" }),
+          Icon2 && /* @__PURE__ */ jsx38(Icon2, { className: "size-4 shrink-0" }),
           !hideLabels && label
         ]
       },
@@ -54673,37 +54838,37 @@ function ComponentSlot({
     (contribution) => contribution.kind === "component" && contribution.component
   );
   if (contributions2.length === 0) return null;
-  return /* @__PURE__ */ jsx37(Fragment14, { children: contributions2.map((contribution) => {
+  return /* @__PURE__ */ jsx38(Fragment14, { children: contributions2.map((contribution) => {
     const Contributed = contribution.component;
-    return /* @__PURE__ */ jsx37(Contributed, { ...props ?? {} }, contribution.actionId);
+    return /* @__PURE__ */ jsx38(Contributed, { ...props ?? {} }, contribution.actionId);
   }) });
 }
 
 // src/ui/plugin-host/PluginViewPlaceholder.tsx
-import { useTranslation as useTranslation6 } from "react-i18next";
+import { useTranslation as useTranslation7 } from "react-i18next";
 
 // src/ui/plugins/open-plugins.ts
 var OPEN_PLUGINS_EVENT = "termix:open-plugins";
 
 // src/ui/plugin-host/PluginViewPlaceholder.tsx
-import { jsx as jsx38, jsxs as jsxs12 } from "react/jsx-runtime";
+import { jsx as jsx39, jsxs as jsxs12 } from "react/jsx-runtime";
 function PluginViewPlaceholder({
   kind,
   viewId,
   compact = false
 }) {
-  const { t } = useTranslation6();
+  const { t } = useTranslation7();
   usePluginStore();
   const { has } = usePermissions();
   const { status, owner } = unregisteredViewStatus(kind, viewId);
   const name = owner?.summary.name ?? viewId;
   if (status === "loading") {
-    return /* @__PURE__ */ jsx38(
+    return /* @__PURE__ */ jsx39(
       "div",
       {
         className: "flex h-full w-full items-center justify-center",
         "aria-label": t("plugins.runtime.loading", { name }),
-        children: /* @__PURE__ */ jsx38("div", { className: "size-5 rounded-full border-2 border-muted-foreground/30 border-t-muted-foreground/70 animate-spin" })
+        children: /* @__PURE__ */ jsx39("div", { className: "size-5 rounded-full border-2 border-muted-foreground/30 border-t-muted-foreground/70 animate-spin" })
       }
     );
   }
@@ -54716,10 +54881,10 @@ function PluginViewPlaceholder({
       "data-status": status,
       className: `flex h-full w-full flex-col items-center justify-center gap-2 text-center ${compact ? "p-3" : "p-6"}`,
       children: [
-        /* @__PURE__ */ jsx38(CircleSlash, { className: "size-6 text-muted-foreground/40" }),
-        /* @__PURE__ */ jsx38("span", { className: "text-sm font-semibold text-muted-foreground", children: title }),
-        /* @__PURE__ */ jsx38("span", { className: "text-xs text-muted-foreground/70", children: hint }),
-        !compact && status !== "failed" && has("admin.plugins.manage") && /* @__PURE__ */ jsx38(
+        /* @__PURE__ */ jsx39(CircleSlash, { className: "size-6 text-muted-foreground/40" }),
+        /* @__PURE__ */ jsx39("span", { className: "text-sm font-semibold text-muted-foreground", children: title }),
+        /* @__PURE__ */ jsx39("span", { className: "text-xs text-muted-foreground/70", children: hint }),
+        !compact && status !== "failed" && has("admin.plugins.manage") && /* @__PURE__ */ jsx39(
           Button,
           {
             variant: "outline",
@@ -54825,6 +54990,7 @@ export {
   notifyShellReady,
   resetShellBridge,
   usePluginScope,
+  DocsLink,
   PANEL,
   PanelShell,
   BackButton,