@workbench-kit/react 0.0.2-prototype.0.2.4 → 0.0.2-prototype.0.2.40

package/src/workbench/commands/quick-open-model.ts

@@ -0,0 +1,66 @@
+export interface QuickOpenItem {
+  /** Stable within its provider (often a workspace path). */
+  id: string;
+  label: string;
+  description?: string | undefined;
+  detail?: string | undefined;
+  icon?: string | undefined;
+  disabled?: boolean | undefined;
+  /** Provider-specific payload (e.g. `{ path }`). */
+  data?: unknown;
+}
+
+export interface QuickOpenSearchContext {
+  /** Aborted when the query, provider set, or open state changes. */
+  signal: AbortSignal;
+}
+
+export interface QuickOpenProvider {
+  /** Unique within the provider set passed to Quick Open. */
+  id: string;
+  label: string;
+  search: (
+    query: string,
+    context?: QuickOpenSearchContext,
+  ) => Promise<QuickOpenItem[]> | QuickOpenItem[];
+}
+
+export interface QuickOpenSelectContext {
+  index: number;
+  providerId: string;
+  query: string;
+}
+
+export function isQuickOpenItemSelectable(item: QuickOpenItem) {
+  return !item.disabled;
+}
+
+export function getNextQuickOpenItemIndex({
+  currentIndex,
+  direction,
+  items,
+}: {
+  currentIndex: number;
+  direction: 'next' | 'previous';
+  items: readonly QuickOpenItem[];
+}) {
+  if (items.length === 0) {
+    return -1;
+  }
+
+  const step = direction === 'next' ? 1 : -1;
+  let nextIndex = currentIndex;
+
+  for (let attempt = 0; attempt < items.length; attempt += 1) {
+    nextIndex = (nextIndex + step + items.length) % items.length;
+    const item = items[nextIndex];
+    if (item && isQuickOpenItemSelectable(item)) {
+      return nextIndex;
+    }
+  }
+
+  return -1;
+}
+
+/** Default debounce for provider search while typing. */
+export const DEFAULT_QUICK_OPEN_SEARCH_DEBOUNCE_MS = 200;

package/src/workbench/{WorkbenchEditorTabs.tsx → editor/WorkbenchEditorTabs.tsx}

@@ -1,7 +1,11 @@
-import { EditorTabs, type EditorTabsProps } from '../primitives/workbench-editor';
+import { EditorTabs, type EditorTabsProps } from '../../primitives/workbench-editor';
+import type { ContextMenuItem } from '../../overlay/ContextMenu';
 import { useWorkbenchEditorTabContextMenu } from './useWorkbenchEditorTabContextMenu';
 
 export interface WorkbenchEditorTabsProps extends EditorTabsProps {
+  /** Additional host actions appended after the built-in close group. */
+  readonly getExtraTabContextMenuItems?:
+    ((tabId: string) => readonly ContextMenuItem[] | undefined) | undefined;
   /**
    * Optional bulk close. Defaults to calling `onClose` for every closable tab.
    */
@@ -10,26 +14,32 @@ export interface WorkbenchEditorTabsProps extends EditorTabsProps {
    * Optional close-others. Defaults to calling `onClose` for every other closable tab.
    */
   readonly onCloseOthers?: ((tabId: string) => void) | undefined;
+  /** Optional close-to-right override. Defaults to closing each later closable tab. */
+  readonly onCloseToRight?: ((tabId: string) => void) | undefined;
 }
 
 /**
- * Editor tab strip with a built-in Close / Close others / Close all context menu.
+ * Editor tab strip with a built-in Close / Close others / Close to the right / Close all menu.
  * Intended for `WorkbenchStandaloneShell` secondary areas that own tab state in the host.
- * Tabs with `closable: false` keep Close disabled and are skipped by Close others / Close all.
+ * Tabs with `closable: false` keep Close disabled and are skipped by every bulk close action.
  */
 export function WorkbenchEditorTabs({
+  getExtraTabContextMenuItems,
   onClose,
   onCloseAll,
   onCloseOthers,
+  onCloseToRight,
   onSelect,
   onTabContextMenu,
   tabs,
   ...props
 }: WorkbenchEditorTabsProps) {
   const tabContextMenu = useWorkbenchEditorTabContextMenu({
+    getExtraTabContextMenuItems,
     onClose: onClose ?? (() => undefined),
     onCloseAll,
     onCloseOthers,
+    onCloseToRight,
     onSelectTab: onSelect,
     tabs,
   });

package/src/workbench/{editor-tabs-dnd.ts → editor/editor-tabs-dnd.ts}

@@ -1,4 +1,4 @@
-import type { EditorTabDropPosition } from '../primitives/workbench-editor';
+import type { EditorTabDropPosition } from '../../primitives/workbench-editor';
 
 export const EDITOR_TAB_DRAG_DATA_TYPE = 'application/x-workbench-kit-editor-tab' as const;
 

package/src/workbench/{editorTabContextMenu.ts → editor/editorTabContextMenu.ts}

@@ -4,14 +4,14 @@ import {
   resolveCommandMenuItems,
 } from '@workbench-kit/platform';
 
-import type { ContextMenuItem } from '../overlay/ContextMenu';
+import type { ContextMenuItem } from '../../overlay/ContextMenu';
 import {
   WORKBENCH_COMMAND_SURFACE_EDITOR,
   commandMenuItemsToContextMenuItems,
   createWorkbenchEditorCommands,
   createWorkbenchStandaloneEditorTabMenuEntries,
   type WorkbenchEditorCommandContext,
-} from './commands';
+} from '../commands/commands';
 
 const editorCommandRegistry = createCommandRegistry(createWorkbenchEditorCommands());
 const standaloneEditorTabMenuEntries = createWorkbenchStandaloneEditorTabMenuEntries();
@@ -29,25 +29,41 @@ export interface CreateWorkbenchStandaloneEditorTabCommandContextInput {
   readonly onClose: (tabId: string) => void;
   readonly onCloseAll?: (() => void) | undefined;
   readonly onCloseOthers?: ((tabId: string) => void) | undefined;
+  readonly onCloseToRight?: ((tabId: string) => void) | undefined;
   readonly tabId: string;
   readonly tabs: readonly WorkbenchStandaloneEditorTabLike[];
 }
 
+export interface CreateWorkbenchStandaloneEditorTabContextMenuItemsInput extends CreateWorkbenchStandaloneEditorTabCommandContextInput {
+  readonly getExtraTabContextMenuItems?:
+    ((tabId: string) => readonly ContextMenuItem[] | undefined) | undefined;
+}
+
 export function createWorkbenchStandaloneEditorTabCommandContext({
   onClose,
   onCloseAll,
   onCloseOthers,
+  onCloseToRight,
   tabId,
   tabs,
 }: CreateWorkbenchStandaloneEditorTabCommandContextInput): WorkbenchEditorCommandContext {
   const targetTab = tabs.find((tab) => tab.id === tabId);
+  const targetIndex = tabs.findIndex((tab) => tab.id === tabId);
   const closableTabIds = tabs.filter(isWorkbenchEditorTabClosable).map((tab) => tab.id);
   const otherClosableTabIds = closableTabIds.filter((id) => id !== tabId);
+  const rightClosableTabIds =
+    targetIndex < 0
+      ? []
+      : tabs
+          .slice(targetIndex + 1)
+          .filter(isWorkbenchEditorTabClosable)
+          .map((tab) => tab.id);
   const canCloseTarget = Boolean(targetTab && isWorkbenchEditorTabClosable(targetTab));
 
   return {
     canCloseAll: closableTabIds.length > 0,
     canCloseOthers: otherClosableTabIds.length > 0,
+    canCloseToRight: rightClosableTabIds.length > 0,
     canClosePath: canCloseTarget,
     canCopyPath: false,
     canDeletePath: false,
@@ -74,6 +90,18 @@ export function createWorkbenchStandaloneEditorTabCommandContext({
         onClose(id);
       }
     },
+    closeToRight: () => {
+      if (rightClosableTabIds.length === 0) {
+        return;
+      }
+      if (onCloseToRight) {
+        onCloseToRight(tabId);
+        return;
+      }
+      for (const id of rightClosableTabIds) {
+        onClose(id);
+      }
+    },
     closePath: () => {
       if (canCloseTarget) {
         onClose(tabId);
@@ -95,11 +123,11 @@ export function createWorkbenchStandaloneEditorTabCommandContext({
 }
 
 export function createWorkbenchStandaloneEditorTabContextMenuItems(
-  input: CreateWorkbenchStandaloneEditorTabCommandContextInput,
+  input: CreateWorkbenchStandaloneEditorTabContextMenuItemsInput,
 ): ContextMenuItem[] {
   const context = createWorkbenchStandaloneEditorTabCommandContext(input);
 
-  return commandMenuItemsToContextMenuItems(
+  const builtInItems = commandMenuItemsToContextMenuItems(
     resolveCommandMenuItems({
       context,
       entries: standaloneEditorTabMenuEntries,
@@ -108,4 +136,15 @@ export function createWorkbenchStandaloneEditorTabContextMenuItems(
     }),
     (commandId) => executeCommand(editorCommandRegistry, commandId, context),
   );
+  const extraItems = input.getExtraTabContextMenuItems?.(input.tabId) ?? [];
+
+  if (extraItems.length === 0) {
+    return builtInItems;
+  }
+
+  return [
+    ...builtInItems,
+    { id: 'standalone-tab-extra-separator', type: 'separator' },
+    ...extraItems,
+  ];
 }

package/src/workbench/{useEditorTabsStripDnd.ts → editor/useEditorTabsStripDnd.ts}

@@ -1,7 +1,7 @@
 import { useCallback, useMemo, useRef, useState } from 'react';
 import type { DragEvent as ReactDragEvent } from 'react';
 
-import type { EditorTabDropPosition, EditorTabsProps } from '../primitives/workbench-editor';
+import type { EditorTabDropPosition, EditorTabsProps } from '../../primitives/workbench-editor';
 import {
   EDITOR_TAB_DRAG_DATA_TYPE,
   isEditorTabsScrollerEventTarget,

package/src/workbench/{useWorkbenchEditorTabContextMenu.tsx → editor/useWorkbenchEditorTabContextMenu.tsx}

@@ -1,15 +1,18 @@
 import { useCallback, useState, type MouseEvent as ReactMouseEvent, type ReactNode } from 'react';
 
-import { ContextMenu } from '../overlay/ContextMenu';
+import { ContextMenu, type ContextMenuItem } from '../../overlay/ContextMenu';
 import {
   createWorkbenchStandaloneEditorTabContextMenuItems,
   type WorkbenchStandaloneEditorTabLike,
 } from './editorTabContextMenu';
 
 export interface UseWorkbenchEditorTabContextMenuOptions {
+  readonly getExtraTabContextMenuItems?:
+    ((tabId: string) => readonly ContextMenuItem[] | undefined) | undefined;
   readonly onClose: (tabId: string) => void;
   readonly onCloseAll?: (() => void) | undefined;
   readonly onCloseOthers?: ((tabId: string) => void) | undefined;
+  readonly onCloseToRight?: ((tabId: string) => void) | undefined;
   readonly onSelectTab?: ((tabId: string) => void) | undefined;
   readonly tabs: readonly WorkbenchStandaloneEditorTabLike[];
 }
@@ -20,13 +23,16 @@ export interface UseWorkbenchEditorTabContextMenuResult {
 }
 
 export function useWorkbenchEditorTabContextMenu({
+  getExtraTabContextMenuItems,
   onClose,
   onCloseAll,
   onCloseOthers,
+  onCloseToRight,
   onSelectTab,
   tabs,
 }: UseWorkbenchEditorTabContextMenuOptions): UseWorkbenchEditorTabContextMenuResult {
   const [menuState, setMenuState] = useState<{
+    returnFocusTarget: HTMLElement;
     tabId: string;
     x: number;
     y: number;
@@ -37,7 +43,12 @@ export function useWorkbenchEditorTabContextMenu({
       event.preventDefault();
       event.stopPropagation();
       onSelectTab?.(tabId);
-      setMenuState({ tabId, x: event.clientX, y: event.clientY });
+      setMenuState({
+        returnFocusTarget: event.currentTarget,
+        tabId,
+        x: event.clientX,
+        y: event.clientY,
+      });
     },
     [onSelectTab],
   );
@@ -47,12 +58,15 @@ export function useWorkbenchEditorTabContextMenu({
       <ContextMenu
         ariaLabel="Editor tab menu"
         items={createWorkbenchStandaloneEditorTabContextMenuItems({
+          getExtraTabContextMenuItems,
           onClose,
           onCloseAll,
           onCloseOthers,
+          onCloseToRight,
           tabId: menuState.tabId,
           tabs,
         })}
+        returnFocusTarget={menuState.returnFocusTarget}
         x={menuState.x}
         y={menuState.y}
         onClose={() => setMenuState(null)}

package/src/workbench/editor-tabs/index.ts

@@ -1,22 +1,23 @@
-export { normalizeEditorTabReorderIndex } from '../editor-tabs-dnd';
+export { normalizeEditorTabReorderIndex } from '../editor/editor-tabs-dnd';
 export {
   createWorkbenchStandaloneEditorTabCommandContext,
   createWorkbenchStandaloneEditorTabContextMenuItems,
   isWorkbenchEditorTabClosable,
-} from '../editorTabContextMenu';
+} from '../editor/editorTabContextMenu';
 export type {
   CreateWorkbenchStandaloneEditorTabCommandContextInput,
+  CreateWorkbenchStandaloneEditorTabContextMenuItemsInput,
   WorkbenchStandaloneEditorTabLike,
-} from '../editorTabContextMenu';
-export { useEditorTabsStripDnd } from '../useEditorTabsStripDnd';
+} from '../editor/editorTabContextMenu';
+export { useEditorTabsStripDnd } from '../editor/useEditorTabsStripDnd';
 export type {
   UseEditorTabsStripDndOptions,
   UseEditorTabsStripDndResult,
-} from '../useEditorTabsStripDnd';
-export { useWorkbenchEditorTabContextMenu } from '../useWorkbenchEditorTabContextMenu';
+} from '../editor/useEditorTabsStripDnd';
+export { useWorkbenchEditorTabContextMenu } from '../editor/useWorkbenchEditorTabContextMenu';
 export type {
   UseWorkbenchEditorTabContextMenuOptions,
   UseWorkbenchEditorTabContextMenuResult,
-} from '../useWorkbenchEditorTabContextMenu';
-export { WorkbenchEditorTabs } from '../WorkbenchEditorTabs';
-export type { WorkbenchEditorTabsProps } from '../WorkbenchEditorTabs';
+} from '../editor/useWorkbenchEditorTabContextMenu';
+export { WorkbenchEditorTabs } from '../editor/WorkbenchEditorTabs';
+export type { WorkbenchEditorTabsProps } from '../editor/WorkbenchEditorTabs';