@hachej/boring-workspace 0.1.71 → 0.1.73

package/dist/src/front/layout/ChatPaneStage.d.ts

@@ -0,0 +1,59 @@
+import { ReactNode } from 'react';
+export interface ChatPaneDescriptor {
+    id: string;
+    title?: string | null;
+    panel?: string;
+    params?: Record<string, unknown>;
+}
+export interface ChatPaneStageProps {
+    panes: ChatPaneDescriptor[];
+    activePaneId?: string | null;
+    renderPane: (pane: ChatPaneDescriptor) => ReactNode;
+    /** Optional host actions rendered in the active chat pane header. */
+    topActions?: ReactNode;
+    onActivePaneChange?: (id: string) => void;
+    onClosePane?: (id: string) => void;
+    /**
+     * Pane to flash with a brief highlight ring — feedback when an action
+     * targets a pane that is already visible (e.g. "open as pane" on an open
+     * session). The parent clears it after a beat; the fade-out is CSS.
+     */
+    flashPaneId?: string | null;
+    /**
+     * Persist the dockview layout (splits, sizes) under
+     * `${storageKey}:chatPaneLayout`.
+     */
+    storageKey?: string;
+    /**
+     * Called when a session is dropped onto the stage (drag a session-browser
+     * row in). The parent opens the session as a pane placed where it was
+     * dropped.
+     */
+    onDropSession?: (sessionId: string) => void;
+}
+/**
+ * Chat pane stage: a dockview-backed surface where each open session is a
+ * pane. Drag flat pane headers to split in any direction, drag a session
+ * row in to open it at a drop position, resize — geometry persists per
+ * workspace.
+ */
+export declare function ChatPaneStage(props: ChatPaneStageProps): import("react").JSX.Element;
+export declare function paneTitle(pane: {
+    title?: string | null;
+}): string;
+/**
+ * DataTransfer type for dragging a chat session (e.g. a session-browser row)
+ * into the chat stage. The payload is the session id.
+ */
+export declare const CHAT_SESSION_DRAG_TYPE = "application/x-boring-chat-session";
+/**
+ * The pane focus treatment shared by both engines: the selected chat stays
+ * white while the others recede behind a faint grey wash — no border on the
+ * active pane, the background contrast alone marks the selection. Flash is a
+ * stronger transient ring for open-as-pane feedback.
+ */
+export declare function PaneFocusRing({ dimmed, flash }: {
+    active?: boolean;
+    dimmed: boolean;
+    flash: boolean;
+}): import("react").JSX.Element;

package/dist/src/front/layout/ChatPaneStageDock.d.ts

@@ -0,0 +1,5 @@
+import { ChatPaneStageProps } from './ChatPaneStage';
+type ChatPaneStageDockProps = ChatPaneStageProps;
+/** Dockview-backed chat stage: drag pane headers to split in any direction. */
+export declare function ChatPaneStageDock({ panes, activePaneId, renderPane, topActions, onActivePaneChange, onClosePane, flashPaneId, storageKey, onDropSession, }: ChatPaneStageDockProps): import("react").JSX.Element | null;
+export {};

package/dist/src/front/layout/IdeLayout.d.ts

@@ -0,0 +1,4 @@
+import { LayoutConfig } from '../dock';
+import { IdeLayoutProps } from './types';
+export declare function buildIdeLayout(props?: IdeLayoutProps): LayoutConfig;
+export declare function IdeLayout(props: IdeLayoutProps): import("react").JSX.Element;

package/dist/src/front/layout/ResponsiveDockviewShell.d.ts

@@ -0,0 +1,6 @@
+import { LayoutConfig } from '../dock';
+export interface ResponsiveDockviewShellProps {
+    layout: LayoutConfig;
+    className?: string;
+}
+export declare function ResponsiveDockviewShell({ layout, className, }: ResponsiveDockviewShellProps): import("react").JSX.Element;

package/dist/src/front/layout/ThemeToggle.d.ts

@@ -0,0 +1,10 @@
+/**
+ * Light/dark theme toggle for the workspace top bar.
+ *
+ * Reads/writes theme through the WorkspaceProvider store (persisted under the
+ * workspace preferences key). Tailwind's dark variant in the workspace
+ * `globals.css` keys off the `.dark` class on the document root, so we keep
+ * that class in sync with the active theme here. SSR-safe: the class sync runs
+ * inside an effect guarded by a `document` check.
+ */
+export declare function ThemeToggle(): import("react").JSX.Element;

package/dist/src/front/layout/TopBar.d.ts

@@ -0,0 +1,17 @@
+import { ReactNode } from 'react';
+export interface TopBarProps {
+    appTitle?: string;
+    sessionTitle?: string;
+    onCommandPalette?: () => void;
+    onNewChat?: () => void;
+    /** Override the brand/title block on the left. Hosts pass workspace
+     *  switchers, breadcrumbs, etc. here. When set, the default
+     *  `[B] appTitle / sessionTitle` block is replaced entirely. */
+    topBarLeft?: ReactNode;
+    /** Override the avatar on the right. The new-chat (+) button stays —
+     *  it's session-mechanic, not host chrome. Hosts pass theme toggles,
+     *  user menus, etc. here. */
+    topBarRight?: ReactNode;
+    className?: string;
+}
+export declare function TopBar({ appTitle, sessionTitle, onCommandPalette, onNewChat, topBarLeft, topBarRight, className, }: TopBarProps): import("react").JSX.Element;

package/dist/src/front/layout/__tests__/ChatPaneStageDock.test.d.ts

@@ -0,0 +1 @@
+export {};

package/dist/src/front/layout/__tests__/TopBar.test.d.ts

@@ -0,0 +1 @@
+export {};

package/dist/src/front/layout/__tests__/presets.test.d.ts

@@ -0,0 +1 @@
+export {};

package/dist/src/front/layout/cornerChrome.d.ts

@@ -0,0 +1,10 @@
+import { ReactNode } from 'react';
+export declare function CornerChromeButton({ label, hint, side, onClick, pressed, pulse, children, }: {
+    label: string;
+    hint?: string;
+    side?: "top" | "bottom" | "left" | "right";
+    onClick: () => void;
+    pressed: boolean;
+    pulse?: boolean;
+    children: ReactNode;
+}): import("react").JSX.Element;

package/dist/src/front/layout/index.d.ts

@@ -0,0 +1,9 @@
+export { IdeLayout, buildIdeLayout } from './IdeLayout';
+export { ChatLayout, buildChatLayout } from './ChatLayout';
+export { TopBar } from './TopBar';
+export { ThemeToggle } from './ThemeToggle';
+/** Tier 2 entry: declarative LayoutConfig with stock responsive chrome. */
+export { ResponsiveDockviewShell } from './ResponsiveDockviewShell';
+export type { TopBarProps } from './TopBar';
+export type { ResponsiveDockviewShellProps } from './ResponsiveDockviewShell';
+export type { IdeLayoutProps, ChatLayoutProps } from './types';

package/dist/src/front/layout/mobileShell.d.ts

@@ -0,0 +1,18 @@
+import { ReactNode } from 'react';
+import { ChatPaneDescriptor } from './ChatPaneStage';
+export declare function MobileSingleChatPane({ pane, totalPanes, topActions, onClosePane, renderPane, }: {
+    pane: ChatPaneDescriptor;
+    totalPanes: number;
+    topActions?: ReactNode;
+    onClosePane?: (id: string) => void;
+    renderPane: (pane: ChatPaneDescriptor) => ReactNode;
+}): import("react").JSX.Element;
+export declare function MobileChatBar({ canOpenNav, canOpenWorkspace, onOpenNav, onOpenWorkspace, }: {
+    canOpenNav: boolean;
+    canOpenWorkspace: boolean;
+    onOpenNav?: () => void;
+    onOpenWorkspace: () => void;
+}): import("react").JSX.Element;
+export declare function MobileWorkspaceBar({ onBack }: {
+    onBack: () => void;
+}): import("react").JSX.Element;

package/dist/src/front/layout/paneCollapseButton.d.ts

@@ -0,0 +1,15 @@
+import { ReactNode } from 'react';
+export interface PaneCollapseButtonProps {
+    label: string;
+    onClick: () => void;
+    children: ReactNode;
+    side?: "top" | "right" | "bottom" | "left";
+    className?: string;
+}
+/**
+ * Canonical chrome for left-pane collapse/expand controls.
+ *
+ * Rule: collapsed and expanded states keep the same button position, size,
+ * style, and icon family. The action changes; the chrome does not jump.
+ */
+export declare function PaneCollapseButton({ label, onClick, children, side, className, }: PaneCollapseButtonProps): import("react").JSX.Element;

package/dist/src/front/layout/plugin-tabs/AppLeftOverlayChromeContext.d.ts

@@ -0,0 +1 @@
+export { AppLeftOverlayChromeProvider, useAppLeftOverlayChrome, type AppLeftOverlayChromeValue, } from '../../../shared/plugins/appLeftOverlayChrome';

package/dist/src/front/layout/plugin-tabs/AppLeftPane.d.ts

@@ -0,0 +1,75 @@
+import { ReactNode } from 'react';
+export interface AppLeftPaneSession {
+    id: string;
+    title?: string | null;
+    updatedAt?: string | number;
+    turnCount?: number;
+}
+export interface AppLeftPaneProjectSession {
+    id: string;
+    title?: string | null;
+    updatedAt?: string | number;
+}
+export interface AppLeftPaneProject {
+    id: string;
+    name: string;
+    available?: boolean;
+    sessionCount?: number;
+    /** Sessions needing attention (blocked / awaiting input); shown as the row badge. */
+    blockedCount?: number;
+    sessions?: AppLeftPaneProjectSession[];
+    hasMoreSessions?: boolean;
+    loadingSessions?: boolean;
+}
+export type AppLeftPaneLayoutMode = "single-project" | "multi-project";
+export type AppLeftPaneHeaderMode = "full" | "workspace" | "hidden";
+export interface AppLeftPaneAction {
+    id: string;
+    label: string;
+    icon: ReactNode;
+    onClick: () => void;
+    trailing?: ReactNode;
+    emphasis?: boolean;
+    active?: boolean;
+}
+export interface AppLeftPaneProps {
+    width?: number;
+    appTitle?: string;
+    workspaceLabel?: string;
+    workspaceSectionTitle?: string;
+    projects?: AppLeftPaneProject[];
+    activeProjectId?: string | null;
+    onOpenProjectSession?: (projectId: string, sessionId: string) => void;
+    onShowMoreProjectSessions?: (projectId: string) => void;
+    onCreateProject?: () => void;
+    /** Start a new chat inside a specific project (multi-project tree row "+"). */
+    onCreateProjectSession?: (projectId: string) => void;
+    /** Open a project's workspace settings (rename / runtime / deletion). */
+    onOpenProjectSettings?: (projectId: string) => void;
+    /** Open a project in a new browser tab. */
+    onOpenProjectInNewTab?: (projectId: string) => void;
+    sessionTitle?: string;
+    topSlot?: ReactNode;
+    bottomSlot?: ReactNode;
+    /** full: brand + workspace, workspace: workspace picker only, hidden: reserve collapse clearance only. */
+    headerMode?: AppLeftPaneHeaderMode;
+    sessions: AppLeftPaneSession[];
+    activeSessionId?: string | null;
+    openSessionIds: readonly string[];
+    pinnedSessionIds: readonly string[];
+    onCreateSession: () => void;
+    onOpenCommandPalette: () => void;
+    onSwitchSession: (id: string) => void;
+    onOpenSessionAsPane: (id: string) => void;
+    onToggleSessionPinned: (id: string) => void;
+    onDeleteSession?: (id: string) => void;
+    /** Primary app-left actions supplied by the host/app/plugin shell after New chat/Search. */
+    actions?: readonly AppLeftPaneAction[];
+    /**
+     * single-project: workspace shown below the app-title logo, no Workspaces
+     * section — just the session list. multi-project: the Workspaces/projects
+     * tree (PR2). Defaults to single-project.
+     */
+    layoutMode?: AppLeftPaneLayoutMode;
+}
+export declare function AppLeftPane({ width, appTitle, workspaceLabel, workspaceSectionTitle, projects, activeProjectId, onOpenProjectSession, onShowMoreProjectSessions, onCreateProject, onCreateProjectSession, onOpenProjectSettings, onOpenProjectInNewTab, topSlot, bottomSlot, headerMode, sessions, activeSessionId, openSessionIds, pinnedSessionIds, onCreateSession, onOpenCommandPalette, onSwitchSession, onOpenSessionAsPane, onToggleSessionPinned, onDeleteSession, actions, layoutMode, }: AppLeftPaneProps): import("react").JSX.Element;

package/dist/src/front/layout/plugin-tabs/AppLeftPaneActions.d.ts

@@ -0,0 +1,13 @@
+import { ReactNode } from 'react';
+export declare function PrimaryAction({ icon, label, onClick, emphasis, active, trailing, }: {
+    icon: ReactNode;
+    label: string;
+    onClick: () => void;
+    emphasis?: boolean;
+    active?: boolean;
+    trailing?: ReactNode;
+}): import("react").JSX.Element;
+/** Small keyboard-shortcut hint badge (e.g. ⌘K), Linear/Stripe-style. */
+export declare function KbdHint({ keys }: {
+    keys: string;
+}): import("react").JSX.Element;

package/dist/src/front/layout/plugin-tabs/AppLeftPaneHeader.d.ts

@@ -0,0 +1,7 @@
+import { ReactNode } from 'react';
+export declare function AppLeftPaneHeader({ appTitle, workspaceLabel, topSlot, showBrand, }: {
+    appTitle?: string;
+    workspaceLabel?: string;
+    topSlot?: ReactNode;
+    showBrand?: boolean;
+}): import("react").JSX.Element;

package/dist/src/front/layout/plugin-tabs/AppLeftPaneProjects.d.ts

@@ -0,0 +1,18 @@
+import { ReactNode } from 'react';
+import { AppLeftPaneProject, AppLeftPaneProjectSession } from './AppLeftPane';
+export declare function usePinnedProjectIds(): [readonly string[], (projectId: string) => void];
+export declare function ProjectOverview({ projects, activeProjectId, fallbackName, expandedIds, onToggleExpanded, pinnedProjectIds, onTogglePinnedProject, onOpenProjectSession, onShowMoreProjectSessions, onCreateProjectSession, onOpenProjectSettings, onOpenProjectInNewTab, renderProjectSession, }: {
+    projects: AppLeftPaneProject[];
+    activeProjectId?: string | null;
+    fallbackName: string;
+    expandedIds: ReadonlySet<string>;
+    onToggleExpanded: (projectId: string) => void;
+    pinnedProjectIds: ReadonlySet<string>;
+    onTogglePinnedProject: (projectId: string) => void;
+    onOpenProjectSession?: (projectId: string, sessionId: string) => void;
+    onShowMoreProjectSessions?: (projectId: string) => void;
+    onCreateProjectSession?: (projectId: string) => void;
+    onOpenProjectSettings?: (projectId: string) => void;
+    onOpenProjectInNewTab?: (projectId: string) => void;
+    renderProjectSession?: (project: AppLeftPaneProject, session: AppLeftPaneProjectSession) => ReactNode;
+}): import("react").JSX.Element;

package/dist/src/front/layout/plugin-tabs/AppLeftPaneSections.d.ts

@@ -0,0 +1,6 @@
+import { ReactNode } from 'react';
+export declare function SessionSubSection({ title, empty, children }: {
+    title: string;
+    empty?: string;
+    children: ReactNode;
+}): import("react").JSX.Element | null;

package/dist/src/front/layout/plugin-tabs/AppLeftPaneSessionRow.d.ts

@@ -0,0 +1,18 @@
+import { WorkspaceAttentionSessionBadge } from '../../attention/WorkspaceAttentionProvider';
+import { AppLeftPaneSession } from './AppLeftPane';
+export type AppSessionRowState = "normal" | "open" | "active";
+export declare function AppSessionRow({ session, state, pinned, canSplit, canPin, working, attentionBadge, onSwitch, onOpenAsPane, onTogglePinned, onDelete, }: {
+    session: AppLeftPaneSession;
+    state: AppSessionRowState;
+    pinned: boolean;
+    /** Whether this session can be split-paned/dragged (same-project only). */
+    canSplit?: boolean;
+    /** Whether this session belongs to the active project's pinned-session scope. */
+    canPin?: boolean;
+    working?: boolean;
+    attentionBadge?: WorkspaceAttentionSessionBadge;
+    onSwitch: (id: string) => void;
+    onOpenAsPane: (id: string) => void;
+    onTogglePinned: (id: string) => void;
+    onDelete?: (id: string) => void;
+}): import("react").JSX.Element;

package/dist/src/front/layout/plugin-tabs/PluginTabsWorkspaceShell.d.ts

@@ -0,0 +1,15 @@
+import { ReactNode } from 'react';
+export interface PluginTabsWorkspaceShellProps {
+    collapsed: boolean;
+    leftPane: ReactNode;
+    children: ReactNode;
+    onExpand: () => void;
+    onCollapse: () => void;
+    onResizeLeftPane?: (delta: number) => void;
+    leftPaneWidth?: number;
+    minLeftPaneWidth?: number;
+    maxLeftPaneWidth?: number;
+    className?: string;
+    mobileShellEnabled?: boolean;
+}
+export declare function PluginTabsWorkspaceShell({ collapsed, leftPane, children, onExpand, onCollapse, onResizeLeftPane, leftPaneWidth, minLeftPaneWidth, maxLeftPaneWidth, className, mobileShellEnabled, }: PluginTabsWorkspaceShellProps): import("react").JSX.Element;

package/dist/src/front/layout/plugin-tabs/__tests__/AppLeftPane.test.d.ts

@@ -0,0 +1 @@
+export {};

package/dist/src/front/layout/types.d.ts

@@ -0,0 +1,40 @@
+import { ReactNode } from 'react';
+import { ChatPaneDescriptor } from './ChatPaneStage';
+export interface IdeLayoutProps {
+    sidebar?: string;
+    center?: string;
+    right?: string;
+    className?: string;
+}
+export interface ChatLayoutProps {
+    nav?: string | null;
+    navParams?: Record<string, unknown>;
+    center?: string;
+    centerParams?: Record<string, unknown>;
+    chatPanes?: ChatPaneDescriptor[];
+    /** Optional host actions rendered in the active chat pane header. */
+    chatTopActions?: ReactNode;
+    activeChatPaneId?: string | null;
+    onActiveChatPaneChange?: (id: string) => void;
+    onCloseChatPane?: (id: string) => void;
+    onCreateChatPaneAfter?: (id: string) => void;
+    onDropChatSession?: (sessionId: string) => void;
+    flashChatPaneId?: string | null;
+    surface?: string | null;
+    surfaceParams?: Record<string, unknown>;
+    /** Opaque overlay rendered over the full chat stage only (not over the workbench). */
+    chatOverlay?: ReactNode;
+    /** Called when shell chrome needs to dismiss the chat overlay before collapsing chat. */
+    onCloseChatOverlay?: () => void;
+    surfaceOverlay?: ReactNode;
+    sidebar?: string | null;
+    sidebarParams?: Record<string, unknown>;
+    storageKey?: string;
+    /** Enable the phone-width one-surface mobile shell for direct ChatLayout hosts. */
+    mobileShellEnabled?: boolean;
+    onOpenNav?: () => void;
+    onOpenSurface?: () => void;
+    surfaceButtonBottomOffset?: number;
+    onOpenSidebar?: () => void;
+    className?: string;
+}

package/dist/src/front/layout/useViewportWidth.d.ts

@@ -0,0 +1 @@
+export declare function useViewportWidth(): number;

package/dist/src/front/lib/utils.d.ts

@@ -0,0 +1,2 @@
+import { ClassValue } from 'clsx';
+export declare function cn(...inputs: ClassValue[]): string;

package/dist/src/front/lib/utils.test.d.ts

@@ -0,0 +1 @@
+export {};

package/dist/src/front/lib/validation.d.ts

@@ -0,0 +1,189 @@
+import { z } from 'zod';
+declare const layoutPartitionSchema: z.ZodObject<{
+    layout: z.ZodNullable<z.ZodObject<{
+        grid: z.ZodObject<{
+            root: z.ZodUnknown;
+            width: z.ZodOptional<z.ZodNumber>;
+            height: z.ZodOptional<z.ZodNumber>;
+            orientation: z.ZodOptional<z.ZodNumber>;
+        }, "passthrough", z.ZodTypeAny, z.objectOutputType<{
+            root: z.ZodUnknown;
+            width: z.ZodOptional<z.ZodNumber>;
+            height: z.ZodOptional<z.ZodNumber>;
+            orientation: z.ZodOptional<z.ZodNumber>;
+        }, z.ZodTypeAny, "passthrough">, z.objectInputType<{
+            root: z.ZodUnknown;
+            width: z.ZodOptional<z.ZodNumber>;
+            height: z.ZodOptional<z.ZodNumber>;
+            orientation: z.ZodOptional<z.ZodNumber>;
+        }, z.ZodTypeAny, "passthrough">>;
+        panels: z.ZodRecord<z.ZodString, z.ZodObject<{
+            id: z.ZodString;
+            contentComponent: z.ZodOptional<z.ZodString>;
+            title: z.ZodOptional<z.ZodString>;
+        }, "passthrough", z.ZodTypeAny, z.objectOutputType<{
+            id: z.ZodString;
+            contentComponent: z.ZodOptional<z.ZodString>;
+            title: z.ZodOptional<z.ZodString>;
+        }, z.ZodTypeAny, "passthrough">, z.objectInputType<{
+            id: z.ZodString;
+            contentComponent: z.ZodOptional<z.ZodString>;
+            title: z.ZodOptional<z.ZodString>;
+        }, z.ZodTypeAny, "passthrough">>>;
+    }, "passthrough", z.ZodTypeAny, z.objectOutputType<{
+        grid: z.ZodObject<{
+            root: z.ZodUnknown;
+            width: z.ZodOptional<z.ZodNumber>;
+            height: z.ZodOptional<z.ZodNumber>;
+            orientation: z.ZodOptional<z.ZodNumber>;
+        }, "passthrough", z.ZodTypeAny, z.objectOutputType<{
+            root: z.ZodUnknown;
+            width: z.ZodOptional<z.ZodNumber>;
+            height: z.ZodOptional<z.ZodNumber>;
+            orientation: z.ZodOptional<z.ZodNumber>;
+        }, z.ZodTypeAny, "passthrough">, z.objectInputType<{
+            root: z.ZodUnknown;
+            width: z.ZodOptional<z.ZodNumber>;
+            height: z.ZodOptional<z.ZodNumber>;
+            orientation: z.ZodOptional<z.ZodNumber>;
+        }, z.ZodTypeAny, "passthrough">>;
+        panels: z.ZodRecord<z.ZodString, z.ZodObject<{
+            id: z.ZodString;
+            contentComponent: z.ZodOptional<z.ZodString>;
+            title: z.ZodOptional<z.ZodString>;
+        }, "passthrough", z.ZodTypeAny, z.objectOutputType<{
+            id: z.ZodString;
+            contentComponent: z.ZodOptional<z.ZodString>;
+            title: z.ZodOptional<z.ZodString>;
+        }, z.ZodTypeAny, "passthrough">, z.objectInputType<{
+            id: z.ZodString;
+            contentComponent: z.ZodOptional<z.ZodString>;
+            title: z.ZodOptional<z.ZodString>;
+        }, z.ZodTypeAny, "passthrough">>>;
+    }, z.ZodTypeAny, "passthrough">, z.objectInputType<{
+        grid: z.ZodObject<{
+            root: z.ZodUnknown;
+            width: z.ZodOptional<z.ZodNumber>;
+            height: z.ZodOptional<z.ZodNumber>;
+            orientation: z.ZodOptional<z.ZodNumber>;
+        }, "passthrough", z.ZodTypeAny, z.objectOutputType<{
+            root: z.ZodUnknown;
+            width: z.ZodOptional<z.ZodNumber>;
+            height: z.ZodOptional<z.ZodNumber>;
+            orientation: z.ZodOptional<z.ZodNumber>;
+        }, z.ZodTypeAny, "passthrough">, z.objectInputType<{
+            root: z.ZodUnknown;
+            width: z.ZodOptional<z.ZodNumber>;
+            height: z.ZodOptional<z.ZodNumber>;
+            orientation: z.ZodOptional<z.ZodNumber>;
+        }, z.ZodTypeAny, "passthrough">>;
+        panels: z.ZodRecord<z.ZodString, z.ZodObject<{
+            id: z.ZodString;
+            contentComponent: z.ZodOptional<z.ZodString>;
+            title: z.ZodOptional<z.ZodString>;
+        }, "passthrough", z.ZodTypeAny, z.objectOutputType<{
+            id: z.ZodString;
+            contentComponent: z.ZodOptional<z.ZodString>;
+            title: z.ZodOptional<z.ZodString>;
+        }, z.ZodTypeAny, "passthrough">, z.objectInputType<{
+            id: z.ZodString;
+            contentComponent: z.ZodOptional<z.ZodString>;
+            title: z.ZodOptional<z.ZodString>;
+        }, z.ZodTypeAny, "passthrough">>>;
+    }, z.ZodTypeAny, "passthrough">>>;
+    sidebar: z.ZodObject<{
+        collapsed: z.ZodBoolean;
+        width: z.ZodNumber;
+    }, "strip", z.ZodTypeAny, {
+        width: number;
+        collapsed: boolean;
+    }, {
+        width: number;
+        collapsed: boolean;
+    }>;
+    panelSizes: z.ZodRecord<z.ZodString, z.ZodNumber>;
+}, "strip", z.ZodTypeAny, {
+    layout: z.objectOutputType<{
+        grid: z.ZodObject<{
+            root: z.ZodUnknown;
+            width: z.ZodOptional<z.ZodNumber>;
+            height: z.ZodOptional<z.ZodNumber>;
+            orientation: z.ZodOptional<z.ZodNumber>;
+        }, "passthrough", z.ZodTypeAny, z.objectOutputType<{
+            root: z.ZodUnknown;
+            width: z.ZodOptional<z.ZodNumber>;
+            height: z.ZodOptional<z.ZodNumber>;
+            orientation: z.ZodOptional<z.ZodNumber>;
+        }, z.ZodTypeAny, "passthrough">, z.objectInputType<{
+            root: z.ZodUnknown;
+            width: z.ZodOptional<z.ZodNumber>;
+            height: z.ZodOptional<z.ZodNumber>;
+            orientation: z.ZodOptional<z.ZodNumber>;
+        }, z.ZodTypeAny, "passthrough">>;
+        panels: z.ZodRecord<z.ZodString, z.ZodObject<{
+            id: z.ZodString;
+            contentComponent: z.ZodOptional<z.ZodString>;
+            title: z.ZodOptional<z.ZodString>;
+        }, "passthrough", z.ZodTypeAny, z.objectOutputType<{
+            id: z.ZodString;
+            contentComponent: z.ZodOptional<z.ZodString>;
+            title: z.ZodOptional<z.ZodString>;
+        }, z.ZodTypeAny, "passthrough">, z.objectInputType<{
+            id: z.ZodString;
+            contentComponent: z.ZodOptional<z.ZodString>;
+            title: z.ZodOptional<z.ZodString>;
+        }, z.ZodTypeAny, "passthrough">>>;
+    }, z.ZodTypeAny, "passthrough"> | null;
+    sidebar: {
+        width: number;
+        collapsed: boolean;
+    };
+    panelSizes: Record<string, number>;
+}, {
+    layout: z.objectInputType<{
+        grid: z.ZodObject<{
+            root: z.ZodUnknown;
+            width: z.ZodOptional<z.ZodNumber>;
+            height: z.ZodOptional<z.ZodNumber>;
+            orientation: z.ZodOptional<z.ZodNumber>;
+        }, "passthrough", z.ZodTypeAny, z.objectOutputType<{
+            root: z.ZodUnknown;
+            width: z.ZodOptional<z.ZodNumber>;
+            height: z.ZodOptional<z.ZodNumber>;
+            orientation: z.ZodOptional<z.ZodNumber>;
+        }, z.ZodTypeAny, "passthrough">, z.objectInputType<{
+            root: z.ZodUnknown;
+            width: z.ZodOptional<z.ZodNumber>;
+            height: z.ZodOptional<z.ZodNumber>;
+            orientation: z.ZodOptional<z.ZodNumber>;
+        }, z.ZodTypeAny, "passthrough">>;
+        panels: z.ZodRecord<z.ZodString, z.ZodObject<{
+            id: z.ZodString;
+            contentComponent: z.ZodOptional<z.ZodString>;
+            title: z.ZodOptional<z.ZodString>;
+        }, "passthrough", z.ZodTypeAny, z.objectOutputType<{
+            id: z.ZodString;
+            contentComponent: z.ZodOptional<z.ZodString>;
+            title: z.ZodOptional<z.ZodString>;
+        }, z.ZodTypeAny, "passthrough">, z.objectInputType<{
+            id: z.ZodString;
+            contentComponent: z.ZodOptional<z.ZodString>;
+            title: z.ZodOptional<z.ZodString>;
+        }, z.ZodTypeAny, "passthrough">>>;
+    }, z.ZodTypeAny, "passthrough"> | null;
+    sidebar: {
+        width: number;
+        collapsed: boolean;
+    };
+    panelSizes: Record<string, number>;
+}>;
+declare const preferencesPartitionSchema: z.ZodObject<{
+    theme: z.ZodEnum<["light", "dark"]>;
+}, "strip", z.ZodTypeAny, {
+    theme: "light" | "dark";
+}, {
+    theme: "light" | "dark";
+}>;
+export declare function validateLayoutPartition(data: unknown): z.infer<typeof layoutPartitionSchema> | null;
+export declare function validatePreferencesPartition(data: unknown): z.infer<typeof preferencesPartitionSchema> | null;
+export {};

package/dist/src/front/plugin/PluginErrorBoundary.d.ts

@@ -0,0 +1,21 @@
+import { Component, ReactNode, ErrorInfo, Context, ReactPortal, ReactElement, JSXElementConstructor } from 'react';
+import { PluginErrorContext, PluginErrorContextValue } from './PluginErrorContext';
+interface Props {
+    pluginId: string;
+    contributionKind: "panel" | "workspace-source" | "catalog-row" | "chat-suggestion" | "app-left-action";
+    contributionId?: string;
+    children?: ReactNode;
+    onError?: (error: Error, info: ErrorInfo) => void;
+}
+interface State {
+    error: Error | null;
+}
+export declare class PluginErrorBoundary extends Component<Props, State> {
+    static contextType: Context< PluginErrorContextValue | null>;
+    context: React.ContextType<typeof PluginErrorContext>;
+    state: State;
+    static getDerivedStateFromError(error: Error): State;
+    componentDidCatch(error: Error, info: ErrorInfo): void;
+    render(): string | number | bigint | boolean | Iterable<ReactNode> | Promise<string | number | bigint | boolean | ReactPortal | ReactElement<unknown, string | JSXElementConstructor<any>> | Iterable<ReactNode> | null | undefined> | import("react").JSX.Element | null | undefined;
+}
+export {};

package/dist/src/front/plugin/PluginErrorContext.d.ts

@@ -0,0 +1,19 @@
+import { ReactNode, Context } from 'react';
+export interface PluginError {
+    kind: "contribution";
+    pluginId: string;
+    contributionKind: "panel" | "workspace-source" | "catalog-row" | "chat-suggestion" | "app-left-action";
+    contributionId?: string;
+    error: Error;
+    componentStack?: string | null;
+}
+export interface PluginErrorContextValue {
+    errors: PluginError[];
+    reportPluginError: (error: PluginError) => void;
+}
+declare const PluginErrorContext: Context<PluginErrorContextValue | null>;
+export declare function PluginErrorProvider({ children }: {
+    children: ReactNode;
+}): import("react").JSX.Element;
+export declare function usePluginErrors(): PluginErrorContextValue;
+export { PluginErrorContext };

package/dist/src/front/plugin/PluginInspector.d.ts

@@ -0,0 +1,8 @@
+export interface PluginMeta {
+    id: string;
+    label?: string;
+    systemPrompt?: string;
+}
+export declare function PluginInspector({ plugins }: {
+    plugins: PluginMeta[];
+}): import("react").JSX.Element | null;

package/dist/src/front/plugin/__tests__/CatalogRegistry.test.d.ts

@@ -0,0 +1 @@
+export {};

package/dist/src/front/plugin/__tests__/PluginErrorBoundary.test.d.ts

@@ -0,0 +1 @@
+export {};

package/dist/src/front/plugin/__tests__/PluginInspector.test.d.ts

@@ -0,0 +1 @@
+export {};