nexus-shell 0.2.9 → 0.2.11

package/dist/core/services/PaneService.d.ts

@@ -0,0 +1,66 @@
+import { StoreApi, UseBoundStore } from 'zustand';
+import { LucideIcon } from 'lucide-react';
+import { PaneSide } from '../../components/widgets/SidebarPane';
+
+/**
+ * The shell's docked panes, one store per edge.
+ *
+ * Every edge behaves identically — a registry of panels, one of which is open,
+ * remembered across reloads — so they share an implementation rather than
+ * drifting into three. Which edge a panel belongs to is data on the panel, not
+ * a separate API per side.
+ */
+/** Ids the shell's own panels use by default. */
+export declare const CHAT_PANEL_ID = "chat";
+export declare const TERMINAL_PANEL_ID = "terminal";
+export declare const SETTINGS_PANEL_ID = "settings";
+export interface IPanel {
+    id: string;
+    label: string;
+    icon: LucideIcon;
+    component: React.ComponentType<any> | React.ReactNode;
+    /**
+     * Which edge the panel docks to. Defaults to `"left"`.
+     *
+     * This is the whole placement API: move a panel by changing this, not by
+     * registering it somewhere else.
+     */
+    side?: PaneSide;
+    /**
+     * Where the panel's icon sits on its rail. `"end"` pins it to the far group —
+     * conventionally settings and account. Defaults to `"start"`.
+     */
+    align?: 'start' | 'end';
+}
+export interface PaneState {
+    /** Id of the open panel, or `null` when the pane is collapsed. */
+    activePanel: string | null;
+    panels: IPanel[];
+    setActivePanel: (id: string | null) => void;
+    /** Open the panel, or close it if it is already open. */
+    togglePanel: (id: string) => void;
+    setPanels: (panels: IPanel[]) => void;
+}
+export type PaneStore = UseBoundStore<StoreApi<PaneState>>;
+/**
+ * A pane store bound to one storage key.
+ *
+ * Exported so an application with a docked region the shell doesn't provide
+ * gets the same behaviour without reimplementing it.
+ */
+export declare const createPaneStore: (storageKey: string) => PaneStore;
+export declare const useLeftPaneStore: PaneStore;
+export declare const useRightPaneStore: PaneStore;
+export declare const useBottomPaneStore: PaneStore;
+/** The store for one edge. */
+export declare const paneStore: (side: PaneSide) => PaneStore;
+/** Every pane store, for code that has to look across all of them. */
+export declare const PANE_SIDES: PaneSide[];
+/**
+ * Register panels across every edge at once.
+ *
+ * Panels arrive as one list and are routed by their `side`, so a caller never
+ * has to know there are three stores. Each edge is set rather than appended,
+ * matching how the rest of the shell's configuration behaves.
+ */
+export declare const setPanels: (panels: IPanel[]) => void;

package/dist/core/services/TerminalService.d.ts

@@ -1,8 +1,13 @@
+/**
+ * The terminal's scrollback.
+ *
+ * Visibility used to live here too, back when the terminal had exactly one
+ * place it could be. It is now registered like any other panel, so whatever
+ * hosts it owns whether it is showing — see `terminalPanel()` and
+ * `togglePanel()`.
+ */
 interface TerminalState {
-    isOpen: boolean;
     history: string[];
-    setOpen: (open: boolean) => void;
-    toggle: () => void;
     addHistory: (line: string) => void;
     clearHistory: () => void;
 }

package/dist/index.d.ts

@@ -23,7 +23,8 @@
  * to.
  */
 export { ShellLayout, ShellLayout as NexusWorkspaceShell, type ShellLayoutProps } from './components/layout/ShellLayout';
-export { initializeShell, DEFAULT_COMMAND_IDS, type InitializeShellOptions, } from './core/Boot';
+export { initializeShell, togglePanel, DEFAULT_COMMAND_IDS, type InitializeShellOptions, } from './core/Boot';
+export { PaneHostProvider, usePaneHost, useHostChrome, type IPaneHost, type PaneHostProviderProps, } from './components/layout/PaneHost';
 export { commandRegistry, CommandRegistry, type ICommand } from './core/registry/CommandRegistry';
 export { menuRegistry, MenuRegistry, type IMenuItemConfig } from './core/registry/MenuRegistry';
 export { pluginRegistry, type IPlugin, type PluginStatus } from './core/registry/PluginRegistry';
@@ -31,8 +32,7 @@ export { componentRegistry, type ComponentConstructor } from './core/registry/Co
 export { useChatStore, type ISlashCommandConfig } from './core/services/ChatService';
 export { useLayoutStore } from './core/services/LayoutService';
 export { useModalStore, type ModalType as ModalStoreType } from './core/services/ModalStoreService';
-export { useRightSidebarStore } from './core/services/RightSidebarService';
-export { useSidebarStore, type ISidebarPanel } from './core/services/SidebarService';
+export { createPaneStore, paneStore, setPanels, useLeftPaneStore, useRightPaneStore, useBottomPaneStore, PANE_SIDES, CHAT_PANEL_ID, TERMINAL_PANEL_ID, SETTINGS_PANEL_ID, type IPanel, type PaneState, type PaneStore, } from './core/services/PaneService';
 export { useStatusBarStore, type IStatusBarWidgetConfig } from './core/services/StatusBarService';
 export { useTerminalStore } from './core/services/TerminalService';
 export { useThemeStore, type ThemeType } from './core/services/ThemeService';
@@ -50,7 +50,7 @@ export { Modal, type ModalProps, type ModalType } from './components/widgets/Mod
 export { QuickSearch, type QuickSearchProps, type IQuickSearchResult } from './components/widgets/QuickSearch';
 export { SearchWidget, type SearchWidgetProps, type ISearchResult } from './components/widgets/SearchWidget';
 export { SettingsPanel, type SettingsPanelProps, type ISettingsThemeOption, DEFAULT_SETTINGS_THEMES } from './components/widgets/SettingsPanel';
-export { SidebarPane, type SidebarPaneProps } from './components/widgets/SidebarPane';
+export { SidebarPane, type SidebarPaneProps, type PaneSide } from './components/widgets/SidebarPane';
 export { StatusBar, type StatusBarProps, type IStatusBarWidget } from './components/widgets/StatusBar';
 export { TerminalPane, type TerminalPaneProps } from './components/widgets/TerminalPane';
 export { ThemeSwitcher, type ThemeSwitcherProps, type IThemeOption, DEFAULT_THEME_OPTIONS } from './components/widgets/ThemeSwitcher';