@floegence/floe-webapp-core 0.44.2 → 0.46.0

package/dist/components/workbench/WorkbenchFilterBar.d.ts

@@ -8,6 +8,8 @@ export interface WorkbenchFilterBarProps {
     widgets: readonly WorkbenchWidgetItem[];
     filters: Record<string, boolean>;
     mode?: WorkbenchInteractionMode;
+    /** Changes built-in Dock clicks without affecting drag-to-create behavior. */
+    activationMode?: WorkbenchDockItemActivationMode;
     /** Solo a single dock component in the supplied mode scope; soloing it again shows the full scope. */
     onSoloFilter: (id: string, scope: readonly string[]) => void;
     onSelectMode?: (mode: WorkbenchInteractionMode) => void;
@@ -22,14 +24,26 @@ export interface WorkbenchFilterBarProps {
     onCreateToolAt?: (tool: WorkbenchDockToolId, clientX: number, clientY: number, context?: WorkbenchDockDropContext) => void;
     /**
      * Handles a plain click on a dock item. Return true when the host consumed
-     * the click and the default filter-solo behavior should be skipped.
+     * the click and the configured default activation should be skipped.
      */
     onItemClick?: (item: WorkbenchDockItemActivation) => boolean | void;
+    onFocusCycleItem?: (item: WorkbenchDockItemActivation) => void;
+    resolveItemPresentation?: (item: Pick<WorkbenchDockItemActivation, 'kind' | 'id'>) => WorkbenchDockItemPresentation;
+    onDockActivation?: (item: Readonly<{
+        kind: 'widget' | 'tool' | 'host' | 'external' | 'action' | 'mode';
+        id: string;
+    }>) => void;
     onDragPreviewChange?: (preview: WorkbenchDockDragPreview | null) => void;
     viewport?: WorkbenchViewport;
     onViewportCommit?: (viewport: WorkbenchViewport) => void;
     onViewportInteractionStart?: (kind: 'pan') => void;
 }
+export type WorkbenchDockItemActivationMode = 'solo-filter' | 'focus-cycle';
+export type WorkbenchDockItemPresentation = Readonly<{
+    count: number;
+    currentIndex: number | null;
+    active: boolean;
+}>;
 export type WorkbenchDockAction = Readonly<{
     id: string;
     label: string;
@@ -49,8 +63,11 @@ export type WorkbenchHostDockItem = Readonly<{
     onActivate?: (trigger: HTMLButtonElement) => void;
     /** Requests a product-owned context menu for this concrete Dock button. */
     onContextMenu?: BarItemContextMenuHandler;
+    /** Places the host item before or after Floe's built-in component group. */
+    dockPlacement?: WorkbenchDockItemPlacement;
     canvasPlacement?: WorkbenchDockCanvasPlacement;
 }>;
+export type WorkbenchDockItemPlacement = 'before-components' | 'after-components';
 export type WorkbenchDockItemActivation = Readonly<{
     kind: 'widget' | 'tool';
     id: WorkbenchWidgetType | WorkbenchDockToolId;
@@ -63,6 +80,8 @@ export type WorkbenchExternalDockDragItem = Readonly<{
     icon: Component<{
         class?: string;
     }>;
+    /** Places the Dock drop preview before or after Floe's built-in component group. */
+    dockPlacement?: WorkbenchDockItemPlacement;
     canvasPlacement?: WorkbenchDockCanvasPlacement;
     onDropToDock?: () => void;
 }>;