@termix-ssh/plugin-sdk 1.0.10 → 1.0.12

package/dist/host/types/src/ui/look/theme-registry.d.ts

@@ -0,0 +1,41 @@
+import type { TFunction } from "i18next";
+/** Follows the OS between the light and dark theme. Not a real theme. */
+export declare const SYSTEM_THEME = "system";
+export interface ThemeSwatch {
+    background: string;
+    panel: string;
+    text: string;
+}
+export interface ThemeDef {
+    /** Also the class put on <html> while the theme is active. */
+    id: string;
+    /** i18n key: core's for built-ins, the plugin namespace's for plugins. */
+    label: string;
+    mode: "light" | "dark";
+    swatch: ThemeSwatch;
+    /** Set for a plugin theme. */
+    pluginId?: string;
+    /** Where a plugin theme's CSS is served. Built-ins live in index.css. */
+    cssHref?: string;
+}
+/**
+ * The two themes core keeps as a fallback, with their tokens in index.css.
+ * The rest come from theme plugins. A plugin theme with the same id takes
+ * the built-in's place while it is installed.
+ */
+export declare const BUILTIN_THEMES: readonly ThemeDef[];
+/** Built-ins in their order, a plugin theme in a built-in's place, then the rest as declared. */
+export declare function listThemes(): ThemeDef[];
+export declare function getTheme(id: string): ThemeDef | undefined;
+/** Replaces every plugin theme at once, from the plugin list. */
+export declare function setPluginThemes(themes: ThemeDef[]): void;
+export declare function subscribeThemes(listener: () => void): () => void;
+export declare function useThemes(): ThemeDef[];
+/** The light or dark mode a theme id stands for, following the OS for system. */
+export declare function themeMode(id: string): "light" | "dark";
+/** The theme to show for a saved id: itself, or System when it is gone. */
+export declare function effectiveThemeId(id: string): string;
+export declare function themeLabel(theme: ThemeDef, t: TFunction): string;
+export declare function arePluginThemesKnown(): boolean;
+/** On logout, and a test seam. */
+export declare function resetPluginThemes(): void;

package/dist/host/types/src/ui/look/use-look-theme.d.ts

@@ -0,0 +1,12 @@
+/**
+ * Shows the theme the look settles on once it is known. A theme someone
+ * picked themselves is kept in this browser too; a default is only shown,
+ * so a later default change still reaches them.
+ */
+export declare function useLookTheme(layoutId: string): void;
+/**
+ * Picks a theme for this user: shown now and kept in this browser. Unless
+ * they keep settings on this device only, it is saved to their account too,
+ * which is what other devices follow.
+ */
+export declare function useChooseTheme(): (themeId: string) => void;

package/dist/host/types/src/ui/manage/manage-requests.d.ts

@@ -0,0 +1,34 @@
+import type { HostDraft } from "@termix-ssh/plugin-sdk/frontend";
+import type { HostDefaultsLevel } from "../../types/host-defaults";
+export type ManageMode = "hosts" | "credentials" | "defaults";
+/** What to open in the Manage tab. */
+export type ManageRequest = {
+    kind: "host";
+    hostId: string | null;
+    draft?: HostDraft;
+} | {
+    kind: "credential";
+    credentialId: string | null;
+} | {
+    kind: "defaults";
+    level: HostDefaultsLevel;
+    folderName?: string;
+} | {
+    kind: "browse";
+    mode: ManageMode;
+};
+export declare const MANAGE_REQUEST_EVENT = "manage:request";
+/**
+ * Parks a request for the Manage tab and pokes it. The shell opens the tab on
+ * the same event, and the tab claims the parked request once it mounts.
+ */
+export declare function requestManage(request: ManageRequest): void;
+/** Takes the parked request, leaving none behind. */
+export declare function takePendingManageRequest(): ManageRequest | null;
+/**
+ * The window events older callers fire (the dashboard, folder menus, the
+ * palette), turned into a request. Null for anything else.
+ */
+export declare function requestFromLegacyEvent(name: string, detail?: unknown): ManageRequest | null;
+/** Test seam. */
+export declare function resetManageRequests(): void;

package/dist/host/types/src/ui/plugin-host/loader.d.ts

@@ -23,6 +23,8 @@ export declare function orderForActivation(summaries: PluginSummary[]): {
  * to call as often as needed; calls run one after another.
  */
 export declare function syncPlugins(summaries?: PluginSummary[]): Promise<void>;
+/** Tries a plugin's frontend again even though this bundle failed before. */
+export declare function retryPluginFrontend(pluginId: string): Promise<void>;
 /**
  * The `?view=` names enabled guest plugins serve to anonymous pages, so the
  * entry point can tell a guest link from a signed-in full-screen view

package/dist/host/types/src/ui/plugin-host/scope.d.ts

@@ -7,6 +7,12 @@ export declare function usePluginScope(): string | null;
  * without each call site having to remember.
  */
 export declare function withPluginScope<P extends object>(pluginId: string, Inner: ComponentType<P>): ComponentType<P>;
+/**
+ * The plugin id for the hooks without the error boundary, for a component
+ * whose caller handles a crash itself (a layout, which the repair view takes
+ * over from).
+ */
+export declare function withPluginContext<P extends object>(pluginId: string, Inner: ComponentType<P>): ComponentType<P>;
 /**
  * A plugin icon the shell renders inline (rail, tab strip, host row). Small
  * enough that a broken one should just disappear, not take the row with it.

package/dist/host/types/src/ui/plugin-host/sdk-ui.d.ts

@@ -47,6 +47,8 @@ export { BrowserSignInDialog } from "../ssh/dialogs/BrowserSignInDialog";
 export { FOLDER_COLORS } from "../lib/theme";
 export { useTabs, useTabsSafe } from "../shell/TabContext";
 export { ActionSlot, ComponentSlot } from "../shell/ActionSlot";
+export { TabStage } from "../shell/stage/TabStage";
+export { ShellConfirmCapture } from "../shell/controller/ShellControllerProvider";
 export { HostFeatureFields, type HostFeatureFieldsProps, } from "../settings/HostPluginSections";
 export { HostDefaultBadge, DefaultsOnly as HostDefaultField, useIsDefaultsEditor, } from "../lib/host-defaults-context";
 export { PluginComponent } from "./component-registry";
@@ -99,3 +101,103 @@ export { InlineView, PanePrompt, SurfaceScope, useConfirm, useSurfaceKind, type
 export { PROMPT_BUTTON, PROMPT_DESTRUCTIVE_BUTTON, PROMPT_PRIMARY_BUTTON, } from "../components/surface/prompt-styles";
 export { ConnectionGate, useConnectionGate, type ConnectionGateController, type ConnectionGateProps, } from "../components/connection/ConnectionGate";
 export { type ConnectionUnavailable } from "../components/connection/ConnectionScreen";
+export { APP_VERSION } from "../lib/app-version";
+export { Command as CommandPrimitive } from "cmdk";
+export { buildExportPayload, hostKey, maskSecrets, pluginSecretKeys, type ExportPayload, type FieldGroup, } from "../sidebar/host-export-payload";
+export { type AuthOverrideProtocol, SSH_AUTH_PROTOCOL, } from "../../types/auth-protocols";
+export { CREDENTIAL_ROW_FIELD_KEYS, type CredentialDensity, type CredentialRowFields, type CredentialSidebarFilterState, type CredentialSidebarPreferences, type CredentialSortKey, type CredentialTrayTrigger, defaultCredentialRowFields, defaultCredentialSidebarPreferences, sanitizeCredentialSidebarPreferences, } from "../../types/credential-sidebar-preferences";
+export { CORE_HOST_DEFAULTS, CORE_NAMESPACE, type DefaultOverrides, defaultValuesEqual, findCoreHostDefault, type HostDefaultsLevel, type ResolvedHostDefault, splitDefaultKey, } from "../../types/host-defaults";
+export { defaultHostRowFields, defaultHostSidebarPreferences, type HostClickBehavior, type HostDensity, type HostGroupKey, type HostRowFields, type HostSidebarFilterState, type HostSidebarPreferences, type HostTrayTrigger, sanitizeHostSidebarPreferences, type SortKey, } from "../../types/host-sidebar-preferences";
+export type { HostData, HostProtocolAuthInput, ProxyNode, SSHHost, SSHHostData, } from "../../types";
+export { UI_AREA_KEYS, type UiAreaKey, type UiPreset, } from "../../types/ui-preferences";
+export type { AdminSection, Credential, DashboardCardId, FontSizeId, Host, HostFolder, SharePermissionLevel, Tab, TabType, ThemeId, ToolsTab, UiFontId, } from "../../types/ui-types";
+export { type AuditLog, type AuditLogFilters, getAuditForwarding, getAuditLogActions, getAuditLogs, updateAuditForwarding, } from "../api/audit-log-api";
+export { getUserSecondFactors, resetUserSecondFactors, type UserSecondFactorSummary, } from "../api/auth-methods-api";
+export { getCredentials } from "../api/credentials-api";
+export { getFolderDefaultsId, getHostDefaultsLevel, type HostDefaultsChange, type HostDefaultsTarget, previewHostDefaultsLevel, resetHostToDefaults, resolveHostDefaults, saveHostDefaultsLevel, waitForDefaultsJob, } from "../api/host-defaults-api";
+export { getHostTags, saveHostTags } from "../api/host-tags-api";
+export { getSessionTimeoutMinutes, getUserPreferences, parseCustomKeybindings, saveUserPreferences, } from "../api/open-tabs-api";
+export { getDeveloperMode, getPluginAdminSettings, getPluginHostSettings, getPlugins, getPluginUserSettings, type PluginSettingsErrors, type PluginSettingsField, PluginSettingsValidationError, type PluginSummary, setAllPluginChannels, setDeveloperMode, setPluginOptions, updatePluginAdminSettings, updatePluginHostSettings, updatePluginUserSettings, } from "../api/plugins-api";
+export { getNotificationPrivateEndpoints, setNotificationPrivateEndpoints, } from "../api/private-endpoints-api";
+export { type CredentialPermissionLevel, type FolderAccessRule, getCredentialAccess, getFolderAccess, getRoles, revokeCredentialAccess, revokeFolderAccess, shareCredential, type ShareTarget, } from "../api/rbac-api";
+export { type BrandingSettings, getBranding, updateBranding, } from "../api/settings-api";
+export { getSyncConflicts, getSyncErrors, retrySyncErrors, settleSyncConflict, type SyncBasicAuth, type SyncConflictItem, type SyncEntityInfo, type SyncErrorItem, syncNow, type SyncProxyHeader, type SyncStatus, unlinkServer, updateSyncSettings, } from "../api/sync-api";
+export { getChannelReleases, getUpdateChannel, type ReleaseInfo, setUpdateChannel, type UpdateChannelState, } from "../api/system-status-api";
+export { getTlsStatus, type TlsStatus, uploadTlsCertificate, } from "../api/tls-api";
+export { Command, CommandEmpty, CommandGroup, CommandItem, CommandList, } from "../components/command";
+export { usePluginDocsUrl } from "../components/docs-link";
+export { DEFAULT_FOLDER_COLOR, DEFAULT_FOLDER_ICON, FolderIconEl, HexColorPicker, IconPicker, } from "../components/folder-style";
+export { useTheme } from "../components/theme-provider";
+export { VersionBadge } from "../components/version-badge";
+export { useBranding } from "../contexts/BrandingContext";
+export { useAreaPreferences, useUiPreference, useUiPreferencesContext, } from "../contexts/UiPreferencesContext";
+export { getRegisteredDashboardCard, useRegisteredDashboardCards, } from "../dashboard/dashboard-cards-registry";
+export { useActionSlot } from "../hooks/use-action-slot";
+export { useInstalledPlugins } from "../hooks/use-installed-plugins";
+export { usePageVisibleInterval } from "../hooks/use-page-visible-interval";
+export { usePermissions } from "../hooks/use-permissions";
+export { getStatusClasses, useStatusColorScheme, } from "../hooks/use-status-color-scheme";
+export { useSyncStatus } from "../hooks/use-sync-status";
+export { useSshAuthProviders } from "../hooks/useSshAuthProviders";
+export { changeAppLanguage, normalizeLanguageCode } from "../i18n/i18n";
+export { LANGUAGES } from "../i18n/languages";
+export { getLiveHostStatus, useHostStatus, useServerStatus, useServerStatusMeta, } from "../lib/ServerStatusContext";
+export { activityTarget } from "../lib/activity-types";
+export { applyPresetSideEffects } from "../lib/apply-ui-preset";
+export { getDatabaseTransferUrl } from "../lib/database-transfer-url";
+export { canConfigureUpdates, type DesktopUpdateMode, desktopUpdates, type DesktopUpdateState, useDesktopUpdate, } from "../lib/desktop-updates";
+export { type DocsPage, docsUrl } from "../lib/docs";
+export { getErrorMessage } from "../lib/error-message";
+export { getDefaultConnectionTab, resolveHostTabType, } from "../lib/host-connection-tabs";
+export { DefaultsOnly, HostDefaultsContext, type HostDefaultsContextValue, HostOnly, } from "../lib/host-defaults-context";
+export { invalidateHostsAndStatusCaches, invalidateServerStatusCache, } from "../lib/hosts-request-cache";
+export { reportBetaFeedbackUrl, reportCoreIssueUrl } from "../lib/issue-url";
+export { notifySyncChanged } from "../lib/linked-server";
+export { clearLocalAdaptivePreferences, getPreferredHostAction, recordHostActionPreference, } from "../lib/local-adaptive-preferences";
+export { pluginKey, pluginName } from "../lib/plugin-i18n";
+export { PluginIcon } from "../lib/plugin-icon";
+export { rem } from "../lib/rem";
+export { getConnectedRemoteApi } from "../lib/remote-server-api";
+export { roleLabel } from "../lib/role-label";
+export type { StatusValue } from "../lib/server-status-store";
+export { parseServerTime } from "../lib/server-time";
+export { refreshSyncStatus, setSyncStatus } from "../lib/sync-status";
+export { tabJumpHotkeyKeys } from "../lib/tab-jump-hotkey";
+export { ACCENT_PRESET_COLORS, applyAccentColor, applyFontSize, applyUiFont, DASHBOARD_CARDS, FONT_SIZES, UI_FONTS, } from "../lib/theme";
+export { registerLayout } from "../look/layout-registry";
+export { useChooseTheme } from "../look/use-look-theme";
+export { type AccessRecord, type ActiveSessionInfo, adminCreateUser, adminCreateUserCredential, adminCreateUserHost, adminDeleteUserCredential, adminDeleteUserHost, adminExportUserData, adminGetHostPassword, adminGetUserCredentials, adminGetUserHosts, adminResetUserPassword, adminUpdateUserCredential, adminUpdateUserHost, type ApiKey, assignRoleToUser, bulkImportSSHHosts, bulkUpdateSSHHosts, changePassword, createApiKey, createCredential, type CreatedApiKey, createRole, createSSHHost, deleteAccount, deleteAllHostsInFolder, deleteApiKey, deleteCredential, deleteOpenTab, deleteRole, deleteSSHHost, deleteUser, deployCredentialToHost, duplicateCredential, exportAllSSHHosts, generateKeyPair, generatePublicKeyFromPrivate, getActiveSessions, getApiKeys, getCredentialDetails, getCredentialSidebarPreferences, getExternalAutoProvision, getHostAccess, getHostAuthOverride, getHostPassword, getHostSidebarPreferences, getLogLevel, getPasswordLoginAllowed, getPasswordResetAllowed, getPermissionsCatalog, getRegistrationAllowed, getSecondFactorAfterExternalLogin, getSessions, getSessionTimeout, getSSHFolders, getSSHHosts, getStatusCheckSettings, getUserInfo, getUserList, getUserRoles, importSSHConfigHosts, type LinkedAccountInfo, linkExternalToPasswordAccount, logoutUser, makeUserAdmin, type OpenTabRecord, type PermissionCatalogEntry, releaseUrlFrom, removeAdminStatus, removeRoleFromUser, renameCredentialFolder, renameFolder, reorderCredentials, reorderFolders, reorderSSHHosts, resetRecentActivity, revokeAllUserSessions, revokeHostAccess, revokeSession, type Role, saveCredentialSidebarPreferences, saveHostSidebarPreferences, setHostAuthOverride, shareFolder, shareHost, type SSHHostWithStatus, unlinkExternalFromPasswordAccount, updateCredential, updateExternalAutoProvision, updateFolderMetadata, updateHostAccess, updateLogLevel, updatePasswordLoginAllowed, updatePasswordResetAllowed, updateRegistrationAllowed, updateRole, updateSecondFactorAfterExternalLogin, updateSessionTimeout, updateSSHHost, updateStatusCheckSettings, type UserPreferences, type UserRole, } from "../main-axios";
+export { MANAGE_REQUEST_EVENT, type ManageMode, type ManageRequest, requestFromLegacyEvent, requestManage, takePendingManageRequest, } from "../manage/manage-requests";
+export { useSshAuthEditors } from "./auth-registry";
+export { usePluginStore } from "./plugin-store";
+export { shell } from "./shell-bridge";
+export { OPEN_PLUGINS_EVENT } from "../plugins/open-plugins";
+export { isPrerelease } from "../plugins/plugin-model";
+export { usePluginHostSections } from "../settings/HostPluginSections";
+export { SettingsFieldRow } from "../settings/SettingsFields";
+export { LookSettings } from "../look/LookSettings";
+export { useThemeOptions } from "../settings/appearance/appearance-controls";
+export { hasVisibleFields, isFieldShown, } from "../settings/settings-fields-util";
+export { LinkServerDialog } from "../settings/sync/LinkServerDialog";
+export { ProxySettingsFields } from "../settings/sync/ProxySettingsFields";
+export { useShellController } from "../shell/controller/ShellControllerProvider";
+export { type KeybindingActionDef, useKeybindingActions, useKeybindingDefaults, } from "../shell/keybinding-registry";
+export { filterPaletteItems, loadPaletteGroup, paletteEntriesFor, type PaletteItemDef, usePaletteEntries, usePaletteGroups, } from "../shell/palette-registry";
+export { getPanel, usePanels } from "../shell/panel-registry";
+export { SplitLayoutMenu } from "../shell/split/SplitLayoutMenu";
+export { beginSplitDrag, endSplitDrag, isSplitDragging, moveSplitDrag, } from "../shell/split/split-drag";
+export { canJoinSplit, isSplitTab, type SplitSummary, type TabSplitAction, } from "../shell/split/split-tabs";
+export { openInSplit, type SplitOpenTarget, useSplitTargets, } from "../shell/split/split-targets";
+export { MAX_PANES } from "../shell/split/split-tree";
+export { registerTabCloseGuard } from "../shell/tab-close-guards";
+export { useTabHandlesVersion } from "../shell/tab-handles";
+export { getTabType, isPersistentTabType, isSessionTabType, type TabShellCallbacks, } from "../shell/tab-registry";
+export { markTabSurfaceUsed, preloadTabSurface, tabIcon, } from "../shell/tabUtils";
+export { AuthEnrollmentSections } from "../sidebar/AuthEnrollmentSections";
+export { mapCredentials, sshHostToHost } from "../sidebar/HostManagerData";
+export { getHostEditorSection, makeHostSshSubTabs, makeHostTabs, useHostEditorSections, } from "../sidebar/HostManagerTabs";
+export { actionOrder, defaultConnectAction, type HostActionDef, hostActionsFor, hostBadgesFor, hostMenuItemsFor, listHostActions, runHostAction, useHostActions, useHostBadges, useHostContextMenuItems, } from "../sidebar/host-contributions";
+export { useEditorDefaultKeys } from "../sidebar/host-defaults/catalog";
+export { enabledHostProtocols, type HostProtocolDef, hostProtocolFlags, type HostProtocols, listHostProtocols, protocolEnabled, protocolPort, useHostProtocols, withProtocolSettings, } from "../sidebar/host-protocols";
+export { quickConnectTargets } from "../sidebar/quick-connect-host";
+export { groupRailItems, isCoreRailView, moveRailItem, promotableIds, type RailGroup, type RailItemDef, railItemLabel, rightDockableIds, useRailItems, } from "../sidebar/rail-items";

package/dist/host/types/src/ui/plugin-host/view-ownership.d.ts

@@ -6,7 +6,7 @@ import { type PluginRecord } from "./plugin-store";
  * because a disabled plugin never runs its frontend and so never registers
  * anything, yet a saved tab or card of its still has to say whose it is.
  */
-export type ViewKind = "tab" | "panel" | "card";
+export type ViewKind = "tab" | "panel" | "card" | "layout";
 export type ViewStatus = 
 /** Registered by a running plugin. */
 "ready"

package/dist/host/types/src/ui/plugins/PluginConsentPrompt.d.ts

@@ -0,0 +1,20 @@
+import { type PluginEntry } from "./plugin-model";
+export interface ConsentRequest {
+    plugin: PluginEntry;
+    mode: "install" | "update" | "upload" | "enable";
+    version: string;
+    /** What the prompt lists: all of them to install, only the new ones to update. */
+    capabilities: string[];
+    /** Set for a file uploaded in developer mode. */
+    uploadToken?: string;
+}
+/**
+ * Install and update consent. Capabilities read as consequences, worst first;
+ * the low risk ones fold into one line so the list stays short enough to read.
+ */
+export declare function PluginConsentPrompt({ request, busy, onCancel, onConfirm, }: {
+    request: ConsentRequest | null;
+    busy?: boolean;
+    onCancel: () => void;
+    onConfirm: () => void;
+}): import("react").JSX.Element;

package/dist/host/types/src/ui/plugins/PluginDetail.d.ts

@@ -0,0 +1,7 @@
+import { type PluginEntry } from "./plugin-model";
+import type { PluginsManager } from "./use-plugins-manager";
+export declare function PluginDetail({ plugin, manager, onUninstalled, }: {
+    plugin: PluginEntry;
+    manager: PluginsManager;
+    onUninstalled: () => void;
+}): import("react").JSX.Element;

package/dist/host/types/src/ui/plugins/PluginReleaseNotes.d.ts

@@ -0,0 +1,14 @@
+import { type PluginEntry } from "./plugin-model";
+/**
+ * The newest version's notes, from the registry and the installed
+ * CHANGELOG.md, with older versions behind a toggle in a capped scroll area.
+ * Renders nothing when there are no versions to list.
+ */
+export declare function PluginReleaseNotes({ plugin }: {
+    plugin: PluginEntry;
+}): import("react").JSX.Element;
+/** The plugin's YouTube video. Nothing is loaded when it has none. */
+export declare function PluginVideo({ videoId, name, }: {
+    videoId?: string;
+    name: string;
+}): import("react").JSX.Element;

package/dist/host/types/src/ui/plugins/PluginsTab.d.ts

@@ -0,0 +1 @@
+export declare function PluginsTab(): import("react").JSX.Element;

package/dist/host/types/src/ui/plugins/RegistriesSection.d.ts

@@ -0,0 +1,4 @@
+import type { PluginsManager } from "./use-plugins-manager";
+export declare function RegistriesSection({ manager }: {
+    manager: PluginsManager;
+}): import("react").JSX.Element;

package/dist/host/types/src/ui/plugins/plugin-bits.d.ts

@@ -0,0 +1,23 @@
+export declare function PluginIconBox({ name, size, muted, }: {
+    name?: string;
+    size?: "sm" | "md" | "lg";
+    muted?: boolean;
+}): import("react").JSX.Element;
+/** One capability as its consequence, with a mark only on the severe ones. */
+export declare function CapabilityRow({ capability, showId, className, }: {
+    capability: string;
+    showId?: boolean;
+    className?: string;
+}): import("react").JSX.Element;
+/** Permanent mark on anything installed without a registry signature. */
+export declare function UnverifiedBadge(): import("react").JSX.Element;
+/** Marks a plugin from the community registry or a custom one. */
+export declare function SourceBadge({ source, registryName, }: {
+    source: string;
+    registryName?: string | null;
+}): import("react").JSX.Element;
+export declare function BetaBadge(): import("react").JSX.Element;
+/** How often the plugin's release files were downloaded. */
+export declare function DownloadCount({ count }: {
+    count: number | null;
+}): import("react").JSX.Element;

package/dist/host/types/src/ui/plugins/plugin-model.d.ts

@@ -0,0 +1,116 @@
+import { type CapabilityRisk } from "@termix-ssh/plugin-sdk/capabilities";
+import type { PluginEnvVar } from "@termix-ssh/plugin-sdk/docs";
+import { type ChangeType, type ChangelogChange, type ChangelogRelease } from "@termix-ssh/plugin-sdk/changelog";
+import type { PluginChannel, PluginSummary, PluginUploadPreview, RegistryPluginEntry, RegistryPluginVersion } from "../api/plugins-api";
+export type PluginStatus = "running" | "disabled" | "failed" | "blocked" | "server";
+/** One row of the Plugins tab: what is installed merged with the registry. */
+export interface PluginEntry {
+    id: string;
+    name: string;
+    description: string;
+    author: string;
+    category: string;
+    icon?: string;
+    repository?: string;
+    videoId?: string;
+    features: string[];
+    /** Docs link: the installed manifest's, else the registry's. */
+    docs?: string;
+    env: PluginEnvVar[];
+    installed: boolean;
+    version: string | null;
+    latestVersion: string | null;
+    /** Newest beta, when one is newer than stable. */
+    latestBeta: string | null;
+    channel: PluginChannel;
+    /** The installed copy is a beta. */
+    isBeta: boolean;
+    updateAvailable: boolean;
+    addedCapabilities: string[];
+    versions: RegistryPluginVersion[];
+    capabilities: string[];
+    status: PluginStatus | null;
+    enabled: boolean;
+    lastError: string | null;
+    autoUpdate: boolean;
+    pinnedVersion: string | null;
+    bundled: boolean;
+    inRegistry: boolean;
+    contributes: Record<string, unknown> | null;
+    publishedAt: string | null;
+    downloads: number | null;
+    source: PluginSource;
+    /** Installed from a file or folder with no registry signature behind it. */
+    unverified: boolean;
+    /** The registry it is listed in or was installed from. */
+    registryId: string | null;
+    registryName: string | null;
+    /** A linked server decides whether it runs here. */
+    managedByServer: boolean;
+    /** The app is drawn with it by default, so it can be swapped but not uninstalled. */
+    defaultLook: boolean;
+}
+export type PluginSource = "bundled" | "official" | "community" | "custom" | "unverified";
+export declare function isPrerelease(version: string | null | undefined): boolean;
+/** A beta newer than what is installed, worth offering with "Try beta". */
+export declare function betaToTry(plugin: Pick<PluginEntry, "installed" | "version" | "latestBeta" | "channel">): string | null;
+/** Where an installed copy came from, as the issue report names it. */
+export declare function pluginSource(summary: PluginSummary): PluginSource;
+export declare function pluginStatus(summary: PluginSummary): PluginStatus;
+export declare function mergePlugins(installed: PluginSummary[], registry: RegistryPluginEntry[] | null): PluginEntry[];
+/** A row for a file that was uploaded but not installed yet. */
+export declare function uploadEntry(preview: PluginUploadPreview): PluginEntry;
+export type SortKey = "popular" | "name" | "updated" | "category";
+export declare function sortPlugins(rows: PluginEntry[], key: SortKey): PluginEntry[];
+export declare function matchesQuery(row: PluginEntry, query: string): boolean;
+export declare function categoriesOf(rows: PluginEntry[]): string[];
+export declare function capabilityRisk(capability: string): CapabilityRisk;
+/** Worst first, the order the consent copy is read in. */
+export declare function orderByRisk(capabilities: string[]): string[];
+export declare function isSevere(capability: string): boolean;
+/** Contribution kinds worth naming in "Adds to Termix", with a count each. */
+declare const CONTRIBUTION_KINDS: readonly ["tabs", "panels", "dashboardCards", "actions", "protocols", "auth", "settings", "hostCapability", "permissions", "keybindingActions", "syncEntities"];
+export type ContributionKind = (typeof CONTRIBUTION_KINDS)[number];
+export declare function describeContributions(contributes: Record<string, unknown> | null): Array<{
+    kind: ContributionKind;
+    count: number;
+}>;
+export declare function formatBytes(bytes: number): string;
+/** 1234 reads as 1.2k, so the number stays a rough ranking. */
+export declare function formatCount(count: number): string;
+/**
+ * A new bug report on the plugin's own repo with what a maintainer asks first
+ * already filled in. Official plugins use the org bug form and the plugin
+ * template ships the same one. Null when the repository is not on GitHub.
+ */
+export declare function reportIssueUrl(plugin: Pick<PluginEntry, "id" | "repository" | "version" | "latestVersion" | "status" | "source" | "lastError">, termixVersion?: string): string | null;
+/**
+ * Beta feedback on the plugin's own repo, through the org beta form. Null when
+ * the repository is not on GitHub.
+ */
+export declare function betaFeedbackUrl(plugin: Pick<PluginEntry, "id" | "repository" | "version" | "lastError">, termixVersion?: string): string | null;
+/** A new feature request on the plugin's own repo, or null when not on GitHub. */
+export declare function requestFeatureUrl(plugin: Pick<PluginEntry, "repository">): string | null;
+/** One version in a plugin's release notes. */
+export interface ReleaseRow {
+    version: string;
+    date: string | null;
+    summary?: string;
+    changes: ChangelogChange[];
+    /** False only for a registry version this build cannot run. */
+    compatible: boolean;
+    releaseNotesUrl?: string;
+}
+/**
+ * The registry's versions and the installed copy's CHANGELOG.md as one list,
+ * newest first. The installed copy's notes win for a version in both.
+ */
+export declare function mergeReleaseNotes(versions: RegistryPluginVersion[], local: ChangelogRelease[]): ReleaseRow[];
+/** The changes of one release grouped by type, in the changelog's order. */
+export declare function groupChanges(changes: ChangelogChange[]): Array<{
+    type: ChangeType;
+    items: string[];
+}>;
+/** The embed address for a video id, or null for anything that is not one. */
+export declare function youtubeEmbedUrl(videoId: string | undefined): string | null;
+export {};

package/dist/host/types/src/ui/plugins/use-plugins-manager.d.ts

@@ -0,0 +1,75 @@
+import { type PluginChannel } from "../api/plugins-api";
+import { type PluginEntry } from "./plugin-model";
+import type { ConsentRequest } from "./PluginConsentPrompt";
+export declare function usePluginsManager(): {
+    plugins: {
+        name: string;
+        description: string;
+        id: string;
+        author: string;
+        category: string;
+        icon?: string;
+        repository?: string;
+        videoId?: string;
+        features: string[];
+        docs?: string;
+        env: import("@termix-ssh/plugin-sdk/docs").PluginEnvVar[];
+        installed: boolean;
+        version: string | null;
+        latestVersion: string | null;
+        latestBeta: string | null;
+        channel: PluginChannel;
+        isBeta: boolean;
+        updateAvailable: boolean;
+        addedCapabilities: string[];
+        versions: import("../api/plugins-api").RegistryPluginVersion[];
+        capabilities: string[];
+        status: import("./plugin-model").PluginStatus | null;
+        enabled: boolean;
+        lastError: string | null;
+        autoUpdate: boolean;
+        pinnedVersion: string | null;
+        bundled: boolean;
+        inRegistry: boolean;
+        contributes: Record<string, unknown> | null;
+        publishedAt: string | null;
+        downloads: number | null;
+        source: import("./plugin-model").PluginSource;
+        unverified: boolean;
+        registryId: string | null;
+        registryName: string | null;
+        managedByServer: boolean;
+        defaultLook: boolean;
+    }[];
+    loading: boolean;
+    refreshing: boolean;
+    registryError: string;
+    managedByServer: boolean;
+    lastCheckedAt: string;
+    registries: import("../api/plugins-api").RegistryListingSource[];
+    reload: () => Promise<void>;
+    busy: Set<string>;
+    consent: ConsentRequest;
+    setConsent: import("react").Dispatch<import("react").SetStateAction<ConsentRequest>>;
+    developerMode: boolean;
+    signedOnly: boolean;
+    requestUpload: (file: File) => Promise<void>;
+    refresh: () => Promise<void>;
+    requestInstall: (plugin: PluginEntry, version?: string) => void;
+    requestUpdate: (plugin: PluginEntry, version?: string) => Promise<void>;
+    confirmConsent: () => Promise<void>;
+    toggle: (plugin: PluginEntry) => Promise<void>;
+    retry: (plugin: PluginEntry) => Promise<void>;
+    uninstall: (plugin: PluginEntry) => Promise<boolean>;
+    removeData: (plugin: PluginEntry) => Promise<boolean>;
+    setOptions: (plugin: PluginEntry, options: {
+        autoUpdate?: boolean;
+        pinned?: boolean;
+        channel?: PluginChannel;
+    }) => Promise<void>;
+    tryBeta: (plugin: PluginEntry) => Promise<void>;
+    leaveBeta: (plugin: PluginEntry) => Promise<void>;
+    setAllChannels: (channel: PluginChannel) => Promise<void>;
+    updateAll: () => Promise<void>;
+};
+export type PluginsManager = ReturnType<typeof usePluginsManager>;

package/dist/host/types/src/ui/settings/appearance/appearance-controls.d.ts

@@ -0,0 +1,53 @@
+import type { FontSizeId, ThemeId, UiFontId } from "../../../types/ui-types";
+import { type ThemeSwatch } from "../../look/theme-registry";
+export declare const DEFAULT_ACCENT = "#f59145";
+/** The built-in themes, with System first. Plugin themes come from useThemeOptions. */
+export declare const THEMES: {
+    id: ThemeId;
+    preview: string;
+}[];
+export interface ThemeOption {
+    id: ThemeId;
+    label: string;
+    /** Null for System, which previews light and dark side by side. */
+    swatch: ThemeSwatch | null;
+}
+/** Every theme to pick from, System first, plugin themes included. */
+export declare function useThemeOptions(): ThemeOption[];
+export declare function isHexColor(value: string): boolean;
+/**
+ * Theme, accent, font and language, applied right away and stored the same
+ * way the profile settings store them.
+ */
+export declare function useAppearanceSettings(): {
+    theme: string;
+    accent: string;
+    fontSize: FontSizeId;
+    uiFont: UiFontId;
+    language: string;
+    setTheme(id: ThemeId): void;
+    setAccent(value: string): void;
+    setFontSize(id: FontSizeId): void;
+    setUiFont(id: UiFontId): void;
+    setLanguage(code: string): void;
+};
+export declare function ThemeGrid({ value, onChange, }: {
+    value: ThemeId;
+    onChange: (id: ThemeId) => void;
+}): import("react").JSX.Element;
+export declare function AccentPicker({ value, onChange, }: {
+    value: string;
+    onChange: (value: string) => void;
+}): import("react").JSX.Element;
+export declare function FontSizePicker({ value, onChange, }: {
+    value: FontSizeId;
+    onChange: (id: FontSizeId) => void;
+}): import("react").JSX.Element;
+export declare function UiFontSelect({ value, onChange, }: {
+    value: UiFontId;
+    onChange: (id: UiFontId) => void;
+}): import("react").JSX.Element;
+export declare function LanguageSelect({ value, onChange, }: {
+    value: string;
+    onChange: (code: string) => void;
+}): import("react").JSX.Element;

package/dist/host/types/src/ui/settings/sync/LinkServerDialog.d.ts

@@ -0,0 +1,12 @@
+import { type SyncStatus } from "../../api/sync-api";
+interface LinkServerDialogProps {
+    open: boolean;
+    onOpenChange: (open: boolean) => void;
+    onLinked: (status: SyncStatus) => void;
+    /** Sign back in to the server this desktop is already linked to. */
+    relogin?: {
+        serverUrl: string;
+    };
+}
+export declare function LinkServerDialog({ open, onOpenChange, onLinked, relogin, }: LinkServerDialogProps): import("react").JSX.Element;
+export {};

package/dist/host/types/src/ui/settings/sync/ProxySettingsFields.d.ts

@@ -0,0 +1,15 @@
+import type { SyncBasicAuth, SyncProxyHeader } from "../../api/sync-api";
+interface ProxySettingsFieldsProps {
+    customHeaders: SyncProxyHeader[];
+    basicAuth: SyncBasicAuth | null;
+    onChange: (next: {
+        customHeaders?: SyncProxyHeader[];
+        basicAuth?: SyncBasicAuth | null;
+    }) => void;
+}
+/**
+ * What a reverse proxy in front of the server wants: extra headers (a
+ * Cloudflare Access service token, a gateway key) and basic auth.
+ */
+export declare function ProxySettingsFields({ customHeaders, basicAuth, onChange, }: ProxySettingsFieldsProps): import("react").JSX.Element;
+export {};

package/dist/host/types/src/ui/settings/sync/saved-servers.d.ts

@@ -0,0 +1,3 @@
+export declare function getSavedServerUrls(): string[];
+export declare function rememberServerUrl(url: string): string[];
+export declare function forgetServerUrl(url: string): string[];

package/dist/host/types/src/ui/shell/controller/ShellControllerProvider.d.ts

@@ -0,0 +1,20 @@
+import { type TabStageStore } from "../stage/tab-stage-store";
+import type { ShellController } from "./types";
+/** The live shell, for core layout code. Throws outside the shell. */
+export declare function useShellController(): ShellController;
+/** The live shell, or null outside it. */
+export declare function useOptionalShellController(): ShellController | null;
+export declare function useTabStageStore(): TabStageStore;
+/**
+ * Hands the main area's confirm to code outside it, like closeTab. A layout
+ * renders it inside the scope its tab-close questions should show in.
+ */
+export declare function ShellConfirmCapture(): null;
+/** Owns every bit of shell state and behaviour a layout draws. */
+export declare function ShellControllerProvider({ username, onLogout, children, }: {
+    username: string;
+    onLogout: (options?: {
+        manual?: boolean;
+    }) => void;
+    children: React.ReactNode;
+}): import("react").JSX.Element;

package/dist/host/types/src/ui/shell/controller/plugin-shell.d.ts

@@ -0,0 +1,7 @@
+import type { ShellController as PluginShellController } from "@termix-ssh/plugin-sdk/frontend";
+/**
+ * The shell as a plugin layout sees it, through useShell() in the SDK. Inside
+ * the shell this reads the controller's context; outside (an overlay a
+ * plugin mounted elsewhere) the last published one.
+ */
+export declare function usePluginShell(pluginId: string): PluginShellController | null;

package/dist/host/types/src/ui/shell/controller/shell-store.d.ts

@@ -0,0 +1,4 @@
+import type { ShellController } from "./types";
+export declare function publishShellController(next: ShellController | null): void;
+export declare function getShellController(): ShellController | null;
+export declare function useShellSnapshot(): ShellController | null;