Files
Termix/src/ui/look/look-store.ts
T
a89ccc6b07 v26.10.3 (#1692)
* 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>
2026-10-20 16:03:29 -05:00

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();
}