mudlet-map-editor 0.18.0 → 0.19.0

package/dist-lib/components/Toolbar.d.ts

@@ -1,5 +1,14 @@
-export declare function Toolbar({ title, onHelpClick, onLoadFromUrl, onSave, onSearchClick, onSettingsClick }: {
+import { type ReactNode } from 'react';
+import type { ToolbarAction } from '../editor/plugin';
+/** `logo` is the plugin override slot. `undefined` means no plugin claimed it
+ *  (toolbar falls back to the built-in Mudlet logo); any other value — including
+ *  `null` — is rendered as-is, so a plugin can explicitly hide the slot.
+ *  `transformActions` is the composed plugin transform applied to the built-in
+ *  file-action list (see EditorPlugin#toolbarActions). */
+export declare function Toolbar({ title, logo, transformActions, onHelpClick, onLoadFromUrl, onSave, onSearchClick, onSettingsClick }: {
     title?: string;
+    logo?: ReactNode;
+    transformActions?: (actions: ToolbarAction[]) => ToolbarAction[];
     onHelpClick: () => void;
     onLoadFromUrl: () => void;
     onSave?: (bytes: Uint8Array) => void;

package/dist-lib/editor/plugin.d.ts

@@ -1,4 +1,4 @@
-import type { ReactNode } from 'react';
+import type { CSSProperties, ReactNode } from 'react';
 import type { MudletMap, MudletRoom } from '../mapIO';
 import type { SwatchSet } from './types';
 import type { SceneHandle } from './scene';
@@ -31,6 +31,38 @@ export interface RoomPanelSection {
     id: string;
     render(props: RoomSectionProps): ReactNode;
 }
+/** A button in the toolbar header row's file-action group. Plugins reshape the
+ *  list via `toolbarActions` — filter to hide built-ins, map to override
+ *  callbacks/labels, or push to add new entries. Built-in ids are 'new',
+ *  'load', 'loadUrl', and 'save'. */
+export interface ToolbarAction {
+    /** Stable id; plugins target a specific action by matching on this. */
+    id: string;
+    /** Tooltip text shown on hover. */
+    title?: string;
+    /** Button contents — typically an SVG icon, but any node works. */
+    icon?: ReactNode;
+    /** Click handler. Ignored when `filePicker` is set. */
+    onClick?: () => void;
+    /** When set, the action renders as a `<label>` wrapping a hidden `<input
+     *  type="file">`; clicking opens the OS file picker and the chosen file is
+     *  passed to `onFile`. Used by the built-in "load .dat" entry. */
+    filePicker?: {
+        accept: string;
+        onFile: (file: File) => void;
+    };
+    /** Disable the button (greys out + ignores clicks). */
+    disabled?: boolean;
+    /** Overlay node rendered on top of the button — used by the built-in
+     *  "save" entry to draw the dirty-marker asterisk. */
+    badge?: ReactNode;
+    /** Inline style for the button/label root. */
+    style?: CSSProperties;
+    /** Escape hatch: when set, every other field except `id` is ignored and
+     *  this node is rendered in place. Use for controls that aren't a single
+     *  button (e.g. a dropdown). */
+    render?: () => ReactNode;
+}
 export interface EditorPlugin {
     /** Stable identifier used to namespace plugin warning ack keys. Defaults to array index if omitted. */
     id?: string;
@@ -39,6 +71,22 @@ export interface EditorPlugin {
     onMapClosed?(): void;
     onMapSave?(bytes: Uint8Array): void;
     renderOverlay?(): ReactNode;
+    /** Replace the toolbar logo. The first plugin that defines this hook claims
+     *  the slot — its return value is rendered as-is (including `null`, which
+     *  hides the logo entirely). When no plugin defines it, the built-in Mudlet
+     *  logo appears. */
+    renderLogo?(): ReactNode;
+    /** Reshape the toolbar's file-action button list. The hook receives the
+     *  current list (built-ins first, then any earlier-plugin additions) and
+     *  returns a new list. Typical uses:
+     *    - **Hide** a built-in: `actions.filter(a => a.id !== 'loadUrl')`
+     *    - **Replace a callback**: `actions.map(a => a.id === 'save'
+     *        ? { ...a, onClick: mySave } : a)` (keeps the button visuals,
+     *        swaps the behaviour — onMapSave still fires when the editor
+     *        serialises the map elsewhere)
+     *    - **Add** a custom button: `[...actions, { id, title, icon, onClick }]`
+     *  Plugin transforms are applied in plugin order. */
+    toolbarActions?(actions: ToolbarAction[]): ToolbarAction[];
     sidebarTabs?(): SidebarTab[];
     swatchSets?(): SwatchSet[];
     /** Contribute additional sections rendered at the bottom of the room selection panel. */

package/dist-lib/index.d.ts

@@ -1,6 +1,6 @@
 import './styles.css';
 export { default as App } from './App';
-export type { EditorPlugin, SidebarTab, RoomPanelSection, RoomSectionProps, PluginCheckResult } from './editor/plugin';
+export type { EditorPlugin, SidebarTab, RoomPanelSection, RoomSectionProps, PluginCheckResult, ToolbarAction } from './editor/plugin';
 export type { MudletMap, MudletRoom, MudletColor } from './mapIO';
 export type { SwatchSet, Swatch } from './editor/types';
 export { loadUrlIntoStore } from './editor/loadFile';