feat: add plugin button and navigation slots for enhanced plugin integration across various components
This commit is contained in:
@@ -0,0 +1,71 @@
|
||||
import React, { useSyncExternalStore } from 'react';
|
||||
import { IconButton } from 'folds';
|
||||
import { UILocation } from '@paarrot/plugin-manager';
|
||||
import { pluginRegistry } from './PluginAPI';
|
||||
|
||||
// ---------------------------------------------------------------------------
|
||||
// Module-level subscription store — works correctly with React 18 concurrent
|
||||
// rendering, lazy-mounted components (nav panels, route changes), and popup
|
||||
// menus that mount fresh after plugins have already loaded.
|
||||
// ---------------------------------------------------------------------------
|
||||
|
||||
type Listener = () => void;
|
||||
const listeners = new Set<Listener>();
|
||||
let storeVersion = 0;
|
||||
|
||||
export function subscribeToButtons(callback: Listener): () => void {
|
||||
listeners.add(callback);
|
||||
return () => listeners.delete(callback);
|
||||
}
|
||||
|
||||
export function getStoreVersion(): number {
|
||||
return storeVersion;
|
||||
}
|
||||
|
||||
/**
|
||||
* Notify all subscribed slots that the button registry has changed.
|
||||
* Call this after plugins load or unload.
|
||||
*/
|
||||
export function dispatchPluginButtonsChanged(): void {
|
||||
storeVersion += 1;
|
||||
for (const listener of listeners) {
|
||||
listener();
|
||||
}
|
||||
}
|
||||
|
||||
interface PluginButtonSlotProps {
|
||||
/** The UI location to render buttons for. */
|
||||
location: UILocation;
|
||||
}
|
||||
|
||||
/**
|
||||
* Renders all plugin-registered buttons for the given UI location.
|
||||
* Correctly handles components that mount before OR after plugins load,
|
||||
* including popup menus, navigation panels, and concurrent React renders.
|
||||
*/
|
||||
export function PluginButtonSlot({ location }: PluginButtonSlotProps): React.ReactElement | null {
|
||||
useSyncExternalStore(subscribeToButtons, getStoreVersion);
|
||||
|
||||
const buttons = pluginRegistry.getButtonsForLocation(location);
|
||||
if (buttons.length === 0) return null;
|
||||
|
||||
return (
|
||||
<>
|
||||
{buttons.map((button) => (
|
||||
<IconButton
|
||||
key={button.id}
|
||||
variant="SurfaceVariant"
|
||||
size="300"
|
||||
radii="300"
|
||||
aria-label={button.label}
|
||||
title={button.label}
|
||||
onClick={() => button.onClick?.()}
|
||||
>
|
||||
<span aria-hidden style={{ fontSize: '1.1em', lineHeight: 1 }}>
|
||||
{button.icon ?? '🔌'}
|
||||
</span>
|
||||
</IconButton>
|
||||
))}
|
||||
</>
|
||||
);
|
||||
}
|
||||
Reference in New Issue
Block a user