Write HTML. Render video. Built for agents.
JavaScript aiai-agentsanimationclaude-codeffmpegframeworkgsaphtmlhtml-to-videomcpmotion-graphicspuppeteerrenderingtypescriptvideo-editor
import type { SerializedDockview } from "dockview-react";
import { PANEL_IDS, isPanelId, type PanelId } from "./panelRegistry";
export const DOCK_PANEL_COMPONENT = "panel";
function isRecord(value: unknown): value is Record<string, unknown> {
return typeof value === "object" && value !== null && !Array.isArray(value);
}
function collectLeafViews(node: unknown, into: unknown[]): boolean {
if (!isRecord(node)) return false;
if (node.type === "leaf") {
if (!isRecord(node.data) || !Array.isArray(node.data.views)) return false;
into.push(...node.data.views);
return true;
}
if (node.type === "branch") {
return Array.isArray(node.data) && node.data.every((child) => collectLeafViews(child, into));
}
return false;
}
function hasGridShape(grid: Record<string, unknown>): boolean {
const oriented = grid.orientation === "HORIZONTAL" || grid.orientation === "VERTICAL";
return oriented && typeof grid.width === "number" && typeof grid.height === "number";
}
function panelsAreRegistered(
panels: Record<string, unknown>,
allowed: readonly PanelId[],
): boolean {
const ids = Object.keys(panels);
return (
ids.length > 0 &&
ids.every((id) => {
const state = panels[id];
return (
isPanelId(id) &&
allowed.includes(id) &&
isRecord(state) &&
state.id === id &&
state.contentComponent === DOCK_PANEL_COMPONENT
);
})
);
}
function collectFloatingViews(floating: unknown, into: unknown[]): boolean {
if (floating === undefined) return true;
if (!Array.isArray(floating)) return false;
return floating.every((group) => {
if (!isRecord(group) || !isRecord(group.data) || !Array.isArray(group.data.views)) return false;
into.push(...group.data.views);
return true;
});
}
/** Parses a stored layout at the trust boundary; null (stale or foreign shape) means use the default preset. */
export function parseDockLayout(
value: unknown,
allowed: readonly PanelId[] = PANEL_IDS,
): SerializedDockview | null {
if (!isRecord(value) || !isRecord(value.grid) || !isRecord(value.panels)) return null;
const { grid, panels } = value;
if (!hasGridShape(grid) || !panelsAreRegistered(panels, allowed)) return null;
const views: unknown[] = [];
if (!collectLeafViews(grid.root, views)) return null;
if (!collectFloatingViews(value.floatingGroups, views)) return null;
const everyViewIsAPanel = views.every((id) => typeof id === "string" && id in panels);
const everyPanelIsPlaced = Object.keys(panels).every((id) => views.includes(id));
return everyViewIsAPanel && everyPanelIsPlaced ? (value as unknown as SerializedDockview) : null;
}