@termix-ssh/plugin-sdk 1.0.11 → 1.0.13

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

@@ -0,0 +1,29 @@
+import { type LookResponse } from "../api/look-api";
+interface LookState {
+    /** The server answered, or failed to; the look is decided either way. */
+    loaded: boolean;
+    response: LookResponse | null;
+}
+/** Fetches the look once per session. Never rejects: no answer means defaults. */
+export declare function loadLook(): Promise<LookResponse | null>;
+/** Fetches again, e.g. after an admin changed the defaults. */
+export declare function reloadLook(): Promise<LookResponse | null>;
+/** On logout: the next user has their own look. */
+export declare function resetLook(): void;
+export declare function getLookState(): LookState;
+export declare function subscribeLook(listener: () => void): () => void;
+export declare function useLookState(): LookState;
+/** The layout to show now. Remembered so a failed fetch next time still knows. */
+export declare function chosenLayoutId(): string;
+/** The URL or the server asks for the repair view. */
+export declare function safeLayoutRequested(): boolean;
+/** The user's own layout; null goes back to the default. */
+export declare function chooseLayout(layoutId: string | null): Promise<void>;
+/** The user's own theme; null goes back to the default. */
+export declare function chooseThemeForAccount(themeId: string | null): Promise<void>;
+/** Admin only: what everyone sees until they choose their own. */
+export declare function chooseDefaultLook(defaults: {
+    layout?: string | null;
+    theme?: string | null;
+}): Promise<void>;
+export {};

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

@@ -0,0 +1,18 @@
+import type { LookResponse } from "../api/look-api";
+/** The theme a fresh install starts in when nothing else says otherwise. */
+export declare const FALLBACK_THEME = "dark";
+/**
+ * The layout to show: the user's choice, else the admin default, else the
+ * default look. Empty when none of them names one, which the repair view
+ * answers. Without an answer from the server the last layout this browser
+ * showed stands in.
+ */
+export declare function resolveLayoutId(look: LookResponse | null, lastShown?: string | null): string;
+/**
+ * The theme to show: the user's choice, else the one this browser kept
+ * (today's per-device setting, so existing users see no change), else the
+ * admin default, else the layout's own, else the default look's.
+ */
+export declare function resolveThemeId(look: LookResponse | null, localTheme: string | null, layoutDefaultTheme?: string): string;
+/** ?safe-layout=1 in the address bar opens the repair view. */
+export declare function safeLayoutInUrl(search: string): boolean;

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

@@ -0,0 +1,7 @@
+import { type ThemeDef } from "./theme-registry";
+/**
+ * Loads the one plugin theme stylesheet the shown theme needs, and only that
+ * one. Built-in themes need none. A theme whose plugin has not loaded yet
+ * keeps the stylesheet it had last time.
+ */
+export declare function applyThemeCss(id: string, theme: ThemeDef | undefined): void;

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/main-axios.d.ts

@@ -103,7 +103,7 @@ export declare const appReadyPromise: Promise<void>;
  */
 export declare function isLoginRequestUrl(url: string | undefined): boolean;
 export declare function handleApiError(error: unknown, operation: string): never;
-export { getSSHHosts, createSSHHost, updateSSHHost, bulkImportSSHHosts, importSSHConfigHosts, bulkUpdateSSHHosts, reorderSSHHosts, deleteSSHHost, getSSHHostById, exportSSHHostWithCredentials, exportAllSSHHosts, testProxyConnection, } from "./api/ssh-host-management-api";
+export { getSSHHosts, createSSHHost, updateSSHHost, bulkUpdateSSHHosts, reorderSSHHosts, deleteSSHHost, getSSHHostById, testProxyConnection, } from "./api/ssh-host-management-api";
 export { getAllServerStatuses, getServerStatusById, refreshServerPolling, getStatusCheckSettings, updateStatusCheckSettings, } from "./api/host-status-api";
 export { getHostSidebarPreferences, saveHostSidebarPreferences, } from "./api/host-sidebar-preferences-api";
 export { getCredentialSidebarPreferences, saveCredentialSidebarPreferences, } from "./api/credential-sidebar-preferences-api";
@@ -165,7 +165,7 @@ export declare function changePassword(oldPassword: string, newPassword: string)
 export { getUserList, getSessions, revokeSession, revokeAllUserSessions, createApiKey, getApiKeys, deleteApiKey, makeUserAdmin, removeAdminStatus, deleteUser, deleteAccount, updateRegistrationAllowed, getExternalAutoProvision, updateExternalAutoProvision, getSecondFactorAfterExternalLogin, updateSecondFactorAfterExternalLogin, updatePasswordLoginAllowed, getPasswordResetAllowed, updatePasswordResetAllowed, adminResetUserPassword, adminExportUserData, type ApiKey, type CreatedApiKey, } from "./api/user-management-api";
 export { adminGetUserHosts, adminCreateUserHost, adminUpdateUserHost, adminDeleteUserHost, adminGetHostPassword, adminGetUserCredentials, adminGetUserCredentialDetails, adminCreateUserCredential, adminUpdateUserCredential, adminDeleteUserCredential, } from "./api/admin-user-data-api";
 export { getReleasesRSS, getVersionInfo, releaseUrlFrom, getDatabaseHealth, } from "./api/system-status-api";
-export { getCredentials, getCredentialDetails, createCredential, updateCredential, duplicateCredential, deleteCredential, getCredentialHosts, getCredentialFolders, getSSHHostWithCredentials, getHostPassword, applyCredentialToHost, removeCredentialFromHost, migrateHostToCredential, getFoldersWithStats, renameFolder, getSSHFolders, updateFolderMetadata, reorderFolders, deleteAllHostsInFolder, renameCredentialFolder, reorderCredentials, detectKeyType, detectPublicKeyType, validateKeyPair, generatePublicKeyFromPrivate, generateKeyPair, deployCredentialToHost, } from "./api/credentials-api";
+export { getCredentials, getCredentialDetails, createCredential, updateCredential, duplicateCredential, deleteCredential, getCredentialHosts, getCredentialFolders, getSSHHostWithCredentials, getHostPassword, applyCredentialToHost, removeCredentialFromHost, migrateHostToCredential, getFoldersWithStats, renameFolder, getSSHFolders, updateFolderMetadata, reorderFolders, deleteAllHostsInFolder, renameCredentialFolder, reorderCredentials, } from "./api/credentials-api";
 export type { UptimeInfo, RecentActivityItem } from "./api/dashboard-api";
 export { getUptime, getRecentActivity, logActivity, resetRecentActivity, } from "./api/dashboard-api";
 export { linkExternalToPasswordAccount, unlinkExternalFromPasswordAccount, } from "./api/external-account-api";

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/onboarding/onboarding-registry.d.ts

@@ -36,12 +36,14 @@ export interface OnboardingStepDef {
     forcePending?: (ctx: OnboardingCtx) => boolean;
     /** Skip stays hidden until this step has been confirmed. */
     required?: boolean;
+    /** Older step keys this one took over; seeing one counts as seeing this. */
+    replaces?: string[];
 }
 /** Where each section of plugin steps sits among the core steps. */
 export declare const SECTION_POSITION: Record<OnboardingSection, number>;
 export declare const onboardingSteps: import("../lib/registry").Registry<OnboardingStepDef>;
 /** Plugin steps sort inside their section by order, then key. */
-export declare function sectionPosition(section: OnboardingSection | undefined, order?: number): number;
+export declare function sectionPosition(section: OnboardingSection | undefined, order?: number, position?: number): number;
 export declare function sortSteps(steps: OnboardingStepDef[]): OnboardingStepDef[];
 /** Steps still on the deprecated onboarding.steps slot, read as version 1. */
 export declare function legacyStepDefs(contributions: SlotContribution[]): OnboardingStepDef[];

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,102 @@ 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 { 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 { PRESETS, 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, getAuditLogActions, getAuditLogs, } 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 } 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, bulkUpdateSSHHosts, changePassword, createApiKey, createCredential, type CreatedApiKey, createRole, createSSHHost, deleteAccount, deleteAllHostsInFolder, deleteApiKey, deleteCredential, deleteOpenTab, deleteRole, deleteSSHHost, deleteUser, duplicateCredential, getActiveSessions, getApiKeys, getCredentialDetails, getCredentialSidebarPreferences, getExternalAutoProvision, getHostAccess, getHostAuthOverride, getHostPassword, getHostSidebarPreferences, getLogLevel, getPasswordLoginAllowed, getPasswordResetAllowed, getPermissionsCatalog, getRegistrationAllowed, getSecondFactorAfterExternalLogin, getSessions, getSessionTimeout, getSSHFolders, getSSHHosts, getStatusCheckSettings, getUserInfo, getUserList, getUserRoles, 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, hostEditorToolbarItemsFor, hostMenuItemsFor, hostStatusIndicatorsFor, listHostActions, runHostAction, useHostActions, useHostBadges, useHostContextMenuItems, useHostEditorToolbarItems, useHostStatusIndicators, } 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,136 @@
+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;
+    /** Contribution keys from the manifest or the registry, like layouts. */
+    kinds: string[];
+    /** Listed, but no release runs on this build. */
+    unsupported: boolean;
+    /** The Termix range the newest release needs, when this build is too old. */
+    needsTermix: string | null;
+}
+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[];
+/** Contribution keys worth filtering by, in the order the filter lists them. */
+export declare const PLUGIN_KINDS: readonly ["layouts", "themes", "tabs", "panels", "dashboardCards", "protocols", "auth", "actions", "hostCapability"];
+export type PluginKind = (typeof PLUGIN_KINDS)[number];
+/** The filterable kinds present in a set of rows, with how many have each. */
+export declare function kindsOf(rows: PluginEntry[]): Array<{
+    kind: PluginKind;
+    count: number;
+}>;
+/** One page of rows, with the page clamped to what exists. */
+export declare function pageOf<T>(rows: T[], page: number, size: number): {
+    items: T[];
+    page: number;
+    pages: number;
+};
+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,78 @@
+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;
+        kinds: string[];
+        unsupported: boolean;
+        needsTermix: string | null;
+    }[];
+    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>;