mudlet-map-editor 0.17.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/editor/reader/EditorMapReader.d.ts

@@ -78,6 +78,7 @@ export declare class EditorArea {
     addRoomsLive(newRooms: LiveRoom[]): void;
     removeRoomById(id: number): void;
     removeRoomsById(ids: Set<number>): void;
+    renameRoomId(fromId: number, toId: number): void;
     rebuildPlanes(): void;
     rebuildExits(): void;
 }
@@ -120,6 +121,7 @@ export declare class EditorMapReader {
     setRoomField(id: number, field: 'name' | 'environment' | 'weight' | 'symbol', value: string | number): void;
     setRoomLock(id: number, lock: boolean): void;
     setUserDataEntry(id: number, key: string, value: string | null): void;
+    renameRoomId(fromId: number, toId: number): void;
     /** Add a raw room (expected `raw.rooms[id]` already set or not, we set it). */
     addRoom(id: number, rawRoom: MudletRoom): void;
     /** Bulk-add many rooms. Does one rebuildPlanes/rebuildExits per affected area. */

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

@@ -291,6 +291,10 @@ export type Command = {
     room: RoomSnapshot;
     areaId: number;
     neighborEdits: NeighborEdit[];
+} | {
+    kind: 'renameRoomId';
+    fromId: number;
+    toId: number;
 } | {
     kind: 'addExit';
     fromId: number;

package/dist-lib/i18n/locales/panels.en.d.ts

@@ -17,6 +17,7 @@ export declare const panelsEn: {
     };
     readonly room: {
         readonly heading: "Room #{{id}}";
+        readonly id: "Room ID";
         readonly centerView: "Center view on room";
         readonly exits: "Exits";
         readonly specialExits: "Special Exits";
@@ -66,7 +67,12 @@ export declare const panelsEn: {
         readonly dashDotDot: "Dash-Dot-Dot";
         readonly enterExitNameFirst: "Enter exit name first.";
         readonly updatedField: "Updated {{field}} on room {{id}}";
+        readonly idUpdated: "Room #{{from}} renamed to #{{to}}";
+        readonly idExists: "Room #{{id}} already exists.";
         readonly exitAdded: "Exit {{dir}} → room {{id}} added.";
+        readonly exitRoomCreated: "Created room #{{id}} {{dir}} of room #{{from}}.";
+        readonly exitCreateOccupied: "Cannot create room #{{id}}: cell ({{x}}, {{y}}, {{z}}) is already occupied.";
+        readonly exitCreateInOut: "Cannot auto-create rooms for in/out directions.";
         readonly specialExitAdded: "Special exit '{{name}}' → {{id}} added";
         readonly specialExitRemoved: "Special exit '{{name}}' removed";
         readonly customLineRemoved: "Custom line '{{name}}' removed";
@@ -126,6 +132,7 @@ export declare const panelsEn: {
             readonly moveRoom: "Move room #{{id}}";
             readonly addRoom: "Add room #{{id}}";
             readonly deleteRoom: "Delete room #{{id}}";
+            readonly renameRoomId: "Rename room #{{from}} -> #{{to}}";
             readonly addExitBidi: "Add exit #{{from}} {{dir}} ↔ #{{to}}";
             readonly addExitUni: "Add exit #{{from}} {{dir}} → #{{to}}";
             readonly removeExit: "Remove exit #{{from}} {{dir}}";

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';