Carlos Florêncio
126 lines
4.6 KiB
TypeScript
126 lines
4.6 KiB
TypeScript
import type { DockviewApi, AddPanelOptions } from "dockview-react";
|
|
import {
|
|
SIDEBAR_LOCK,
|
|
SIDEBAR_GROUP,
|
|
CENTER_GROUP,
|
|
LAYOUT_SIDEBAR_MAX_PX,
|
|
LAYOUT_RIGHT_MAX_PX,
|
|
RIGHT_TOP_GROUP,
|
|
RIGHT_BOTTOM_GROUP,
|
|
resolveGroupIds,
|
|
} from "./layout-manager";
|
|
import type { LayoutGroupIds } from "./layout-manager";
|
|
|
|
// Re-export for consumers that import from this module
|
|
export { getRootSplitview } from "./layout-manager";
|
|
|
|
/** After fromJSON() restores a session layout, apply fixups and return group IDs. */
|
|
export function applyLayoutFixups(api: DockviewApi): LayoutGroupIds {
|
|
const sb = api.getPanel("sidebar");
|
|
if (sb) {
|
|
sb.group.locked = SIDEBAR_LOCK;
|
|
sb.group.header.hidden = false;
|
|
sb.group.api.setConstraints({ maximumWidth: LAYOUT_SIDEBAR_MAX_PX });
|
|
}
|
|
|
|
const oldChanges = api.getPanel("diff-files");
|
|
if (oldChanges) oldChanges.api.setTitle("Changes");
|
|
const oldFiles = api.getPanel("all-files");
|
|
if (oldFiles) oldFiles.api.setTitle("Files");
|
|
|
|
// Constrain right column groups by their well-known IDs.
|
|
// Groups created from presets carry stable IDs (e.g. "group-right-top"),
|
|
// so this works regardless of which panels are in them.
|
|
for (const gid of [RIGHT_TOP_GROUP, RIGHT_BOTTOM_GROUP]) {
|
|
const group = api.groups.find((g) => g.id === gid);
|
|
if (group) {
|
|
group.api.setConstraints({ maximumWidth: LAYOUT_RIGHT_MAX_PX });
|
|
}
|
|
}
|
|
|
|
return resolveGroupIds(api);
|
|
}
|
|
|
|
/**
|
|
* Resolve a fallback group position when the intended reference is stale.
|
|
*
|
|
* Tries to land in the center column, in this order:
|
|
* 1. Well-known CENTER_GROUP id.
|
|
* 2. Group containing the `chat` panel (post-drag, the well-known id may be
|
|
* gone but the chat panel still marks the center column).
|
|
* 3. Group containing any `session:*` panel (active session: chat is removed
|
|
* and replaced with per-session tabs).
|
|
* 4. Any group that is NOT the sidebar AND NOT a right-column group
|
|
* (Changes/Files/Terminal). Returning a right-column group would leak the
|
|
* panel into the narrow tools column — same UX bug as the sidebar leak.
|
|
*
|
|
* Returns undefined if no center-like group exists. The caller drops the
|
|
* position so dockview picks a default. Never returns the sidebar.
|
|
*/
|
|
export function fallbackGroupPosition(api: DockviewApi): { referenceGroup: string } | undefined {
|
|
const centerGroup = api.groups.find((g) => g.id === CENTER_GROUP);
|
|
if (centerGroup) return { referenceGroup: centerGroup.id };
|
|
|
|
const chatGroupId = api.getPanel("chat")?.group?.id;
|
|
if (chatGroupId) return { referenceGroup: chatGroupId };
|
|
|
|
const sessionGroupId = api.panels.find((p) => p.id.startsWith("session:"))?.group?.id;
|
|
if (sessionGroupId) return { referenceGroup: sessionGroupId };
|
|
|
|
const centerish = api.groups.find(
|
|
(g) => g.id !== SIDEBAR_GROUP && g.id !== RIGHT_TOP_GROUP && g.id !== RIGHT_BOTTOM_GROUP,
|
|
);
|
|
if (centerish) return { referenceGroup: centerish.id };
|
|
|
|
return undefined;
|
|
}
|
|
|
|
export function focusOrAddPanel(
|
|
api: DockviewApi,
|
|
options: AddPanelOptions & { id: string },
|
|
quiet = false,
|
|
): void {
|
|
const existing = api.getPanel(options.id);
|
|
if (existing) {
|
|
if (!quiet) existing.api.setActive();
|
|
return;
|
|
}
|
|
// Guard: if the referenced group or panel no longer exists (stale ID after
|
|
// layout transition), fall back to a known group. Avoid the active panel's
|
|
// group because the user may have just clicked in the sidebar.
|
|
const pos = options.position;
|
|
if (pos && "referenceGroup" in pos) {
|
|
const groupExists = api.groups.some((g) => g.id === pos.referenceGroup);
|
|
if (!groupExists) {
|
|
const fallback = fallbackGroupPosition(api);
|
|
options = fallback
|
|
? { ...options, position: { ...pos, ...fallback } }
|
|
: (Object.fromEntries(
|
|
Object.entries(options).filter(([k]) => k !== "position"),
|
|
) as typeof options);
|
|
}
|
|
}
|
|
|
|
if (pos && "referencePanel" in pos) {
|
|
const refPanel = api.getPanel(pos.referencePanel as string);
|
|
if (!refPanel) {
|
|
const fallback = fallbackGroupPosition(api);
|
|
options = fallback
|
|
? { ...options, position: fallback }
|
|
: (Object.fromEntries(
|
|
Object.entries(options).filter(([k]) => k !== "position"),
|
|
) as typeof options);
|
|
}
|
|
}
|
|
|
|
// For quiet adds use dockview's `inactive` flag so the new panel is never
|
|
// briefly activated. The save-active / restore-active dance flips the new
|
|
// panel's `isActive` to true and then back, which fires spurious
|
|
// onDidActiveChange events on listeners (e.g. PlanTab's seen-mark).
|
|
if (quiet) {
|
|
api.addPanel({ ...options, inactive: true });
|
|
} else {
|
|
api.addPanel(options);
|
|
}
|
|
}
|