mirror of
https://github.com/Termix-SSH/Termix.git
synced 2026-10-29 06:35:24 +00:00
* feat: shell controller, TabStage, layout and theme plugins with repair view * feat: move the classic layout into its own bundled plugin * feat: move color themes into a bundled themes plugin * fix: plugin tests and type checks work with a linked sdk * fix: home tab, layout switch and missing layout fallbacks for looks * chore: add classic layout and themes to the readme * chore: drop example plugin links from the plugin guide * feat: plugin filters by type, paged browse, hide plugins needing newer termix * feat: move desktop, status, import, audit and branding features into plugins * feat: host lock api so a plugin can load hosts from a config file (#1581) * chore: add hosts config to the plugin table * feat: login policy hook for plugins and optional https redirect (#1584) * chore: add login security to the plugin table * feat: api key socket tickets so a master can open remote sessions (#1654) * feat: sync moves to a plugin, desktop gets multiple accounts (#1580, #1654) * chore: add sync to the plugin table * feat: move the sync screens and wizard out of core into the plugin (#1580) * fix: add a neutral linked desktop hook for plugins (#1580) * fix: show the linked account's name and admin flag in the app (#1580) * feat: ssh transport providers, core ssh relay and plugin folders api * feat: support FIDO2 security keys through ssh agent * feat: add companion panels beside host tabs * feat: mTLS client certificates for desktop server links * feat: native web view for plugins in the desktop app * fix: detect the desktop link window by Electron's default user agent Fixes #1675 * fix: changelog for desktop link fix * fix: keep text primary keys in the plugin data export * fix: ship sharp binaries for Windows arm64 builds * feat: client cert on the sync link types (sdk 1.0.18) * chore: update translations * feat: themed title bar for the desktop app (#1690) * chore: changelog for the themed title bar * fix: draw the title bar in the sidebar color * feat: per host layout for the terminal panel bar * chore: sdk 1.0.19 for the panel bar layout * chore: bundle all 43 plugins for 26.10.3 * chore: update translations --------- Co-authored-by: SirHephaistos <60616553+SirHephaistos@users.noreply.github.com> Co-authored-by: Giovanny Aranda <garanda21@gmail.com>
134 lines
3.5 KiB
TypeScript
134 lines
3.5 KiB
TypeScript
import { useSyncExternalStore } from "react";
|
|
import {
|
|
getLook,
|
|
saveDefaultLook,
|
|
saveUserLook,
|
|
type LookResponse,
|
|
} from "@/api/look-api";
|
|
import { resolveLayoutId, safeLayoutInUrl } from "./resolve-look";
|
|
|
|
const LAST_LAYOUT_KEY = "termix-layout";
|
|
|
|
interface LookState {
|
|
/** The server answered, or failed to; the look is decided either way. */
|
|
loaded: boolean;
|
|
response: LookResponse | null;
|
|
}
|
|
|
|
let state: LookState = { loaded: false, response: null };
|
|
let request: Promise<LookResponse | null> | null = null;
|
|
const listeners = new Set<() => void>();
|
|
|
|
function setState(next: LookState) {
|
|
state = next;
|
|
for (const listener of listeners) listener();
|
|
}
|
|
|
|
function readLastLayout(): string | null {
|
|
try {
|
|
return localStorage.getItem(LAST_LAYOUT_KEY);
|
|
} catch {
|
|
return null;
|
|
}
|
|
}
|
|
|
|
/** Fetches the look once per session. Never rejects: no answer means defaults. */
|
|
export function loadLook(): Promise<LookResponse | null> {
|
|
request ??= getLook()
|
|
.then((response) => {
|
|
setState({ loaded: true, response });
|
|
return response;
|
|
})
|
|
.catch(() => {
|
|
setState({ loaded: true, response: null });
|
|
return null;
|
|
});
|
|
return request;
|
|
}
|
|
|
|
/** Fetches again, e.g. after an admin changed the defaults. */
|
|
export function reloadLook(): Promise<LookResponse | null> {
|
|
request = null;
|
|
return loadLook();
|
|
}
|
|
|
|
/** On logout: the next user has their own look. */
|
|
export function resetLook(): void {
|
|
request = null;
|
|
setState({ loaded: false, response: null });
|
|
}
|
|
|
|
export function getLookState(): LookState {
|
|
return state;
|
|
}
|
|
|
|
export function subscribeLook(listener: () => void): () => void {
|
|
listeners.add(listener);
|
|
return () => {
|
|
listeners.delete(listener);
|
|
};
|
|
}
|
|
|
|
export function useLookState(): LookState {
|
|
return useSyncExternalStore(subscribeLook, getLookState, getLookState);
|
|
}
|
|
|
|
/** The layout to show now. Remembered so a failed fetch next time still knows. */
|
|
export function chosenLayoutId(): string {
|
|
const id = resolveLayoutId(state.response, readLastLayout());
|
|
if (state.response) {
|
|
try {
|
|
localStorage.setItem(LAST_LAYOUT_KEY, id);
|
|
} catch {
|
|
// Private mode; the server is asked every time anyway.
|
|
}
|
|
}
|
|
return id;
|
|
}
|
|
|
|
/** The URL or the server asks for the repair view. */
|
|
export function safeLayoutRequested(): boolean {
|
|
return (
|
|
(typeof window !== "undefined" &&
|
|
safeLayoutInUrl(window.location.search)) ||
|
|
state.response?.safeLayout === true
|
|
);
|
|
}
|
|
|
|
function patchResponse(patch: Partial<LookResponse>) {
|
|
if (!state.response) return;
|
|
setState({ ...state, response: { ...state.response, ...patch } });
|
|
}
|
|
|
|
/** Tells the plugin runtime to load the chosen layout's code. */
|
|
function announceLayoutChange() {
|
|
if (typeof window !== "undefined") {
|
|
window.dispatchEvent(new Event("termix:plugins-changed"));
|
|
}
|
|
}
|
|
|
|
/** The user's own layout; null goes back to the default. */
|
|
export async function chooseLayout(layoutId: string | null): Promise<void> {
|
|
await saveUserLook({ layoutId });
|
|
patchResponse({ layoutId });
|
|
announceLayoutChange();
|
|
}
|
|
|
|
/** The user's own theme; null goes back to the default. */
|
|
export async function chooseThemeForAccount(
|
|
themeId: string | null,
|
|
): Promise<void> {
|
|
await saveUserLook({ themeId });
|
|
patchResponse({ themeId });
|
|
}
|
|
|
|
/** Admin only: what everyone sees until they choose their own. */
|
|
export async function chooseDefaultLook(defaults: {
|
|
layout?: string | null;
|
|
theme?: string | null;
|
|
}): Promise<void> {
|
|
const saved = await saveDefaultLook(defaults);
|
|
patchResponse({ defaults: saved });
|
|
announceLayoutChange();
|
|
}
|