mudlet-map-editor 0.7.1 → 0.9.0

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

@@ -0,0 +1,24 @@
+import type { MudletMap } from '../mapIO';
+import { type RoomClipboard } from './store';
+import type { SceneHandle } from './scene';
+export declare function copyRoomsToClipboard(map: MudletMap, ids: number[]): number;
+export type PasteResult = {
+    count: number;
+    newIds: number[];
+    externalExitsStubbed: number;
+    externalSpecialExitsDropped: number;
+};
+export declare function pasteClipboard(clipboard: RoomClipboard, target: {
+    x: number;
+    y: number;
+    z: number;
+    areaId: number;
+}, scene: SceneHandle | null): PasteResult | null;
+/** Copy → paste-at-offset in one step, without touching the user's clipboard. */
+export declare function duplicateRooms(map: MudletMap, ids: number[], offset: {
+    dx: number;
+    dy: number;
+}, target: {
+    areaId: number;
+    z: number;
+}, scene: SceneHandle | null): PasteResult | null;

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

@@ -98,3 +98,12 @@ export declare function customLineSegmentAt(renderer: MapRenderer, roomId: numbe
  * renderer-prepended room centre), or null.
  */
 export declare function customLinePointAt(renderer: MapRenderer, roomId: number, exitName: string, mapX: number, mapY: number, roomSize: number): number | null;
+/**
+ * Hit-test a `room.stubs` entry against the geometry the renderer actually
+ * drew. Non-cardinal stubs (up/down/in/out) render as zero-length segments
+ * and are implicitly skipped by the distance check.
+ */
+export declare function stubAt(renderer: MapRenderer, mapX: number, mapY: number, roomSize: number): {
+    roomId: number;
+    dir: Direction;
+} | null;

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

@@ -0,0 +1,20 @@
+import type { SceneHandle } from './scene';
+export type ScriptResult = {
+    commandCount: number;
+    logs: string[];
+    /** Value the script returned via `return …`. `undefined` means no return. */
+    returnValue?: unknown;
+    /** JSON-stringified form of `returnValue`, or an error marker if not serialisable. */
+    returnJson?: string;
+    error?: {
+        message: string;
+        name: string;
+    };
+};
+/**
+ * Run a user script against the current map. Each helper mutates the map
+ * eagerly (so subsequent reads see updated state) and records a Command. On
+ * success, all commands are pushed as a single batch to the undo stack. On
+ * error, every applied command is reverted.
+ */
+export declare function runScript(code: string, scene: SceneHandle): ScriptResult;

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

@@ -0,0 +1 @@
+export declare function buildAiPrompt(): string;

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

@@ -0,0 +1,29 @@
+/**
+ * Metadata for script API symbols — consumed by the CodeMirror completion
+ * source in ScriptPanel. Keep in sync with the `api` object in `script.ts`.
+ */
+export type ApiKind = 'function' | 'variable' | 'namespace';
+/** Simplified return-type tag used to pick member completions after `x.` or `fn().`. */
+export type ApiReturnType = 'Room' | 'RoomArray' | 'Area' | 'AreaArray' | 'Env' | 'EnvArray' | 'Direction' | 'DirectionArray' | 'void' | 'number' | 'string' | 'boolean' | 'unknown';
+export interface ApiEntry {
+    name: string;
+    kind: ApiKind;
+    signature?: string;
+    detail: string;
+    /** Short human description shown in completion popup. */
+    info: string;
+    /** Return type for functions / inferred type for variables. Used by the completion engine. */
+    returns?: ApiReturnType;
+}
+export declare const SCRIPT_API: ApiEntry[];
+/** Fields available on an Area, used as completions after `.` on an area variable. */
+export declare const AREA_FIELDS: ApiEntry[];
+/** Fields available on an Env snapshot, used as completions after `.` on an env variable. */
+export declare const ENV_FIELDS: ApiEntry[];
+/**
+ * A curated subset of Array.prototype members, used as completions after `.`
+ * on any expression whose inferred type is an array.
+ */
+export declare const ARRAY_METHODS: ApiEntry[];
+/** Fields available on a Room snapshot, used as completions after `.` on a room variable. */
+export declare const ROOM_FIELDS: ApiEntry[];

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

@@ -0,0 +1,8 @@
+/**
+ * Ambient TypeScript declarations for the script sandbox, loaded into Monaco
+ * via addExtraLib() so the editor gives full type-aware autocomplete, hover,
+ * and signature help.
+ *
+ * Keep in sync with the `api` object in `script.ts`.
+ */
+export declare const SCRIPT_TYPES_DTS: string;

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

@@ -1,7 +1,21 @@
-import type { MudletMap } from '../mapIO';
+import type { MudletMap, MudletRoom } from '../mapIO';
 import type { Command, HitItem, HoverTarget, LoadedMap, Pending, Selection, SwatchSet, ToolId } from './types';
+export type RoomClipboard = {
+    /** Rooms captured at copy time; origId preserved for internal-exit remap. */
+    rooms: Array<{
+        origId: number;
+        room: MudletRoom;
+    }>;
+    /** Centroid of source rooms in raw Mudlet space — paste offset is computed relative to this. */
+    origin: {
+        x: number;
+        y: number;
+        z: number;
+    };
+};
 interface UserSettings {
     snapToGrid: boolean;
+    panelWidth: number;
 }
 export declare function saveUserSettings(patch: Partial<UserSettings>): void;
 export declare function saveSwatchState(sets: SwatchSet[], activeSetId: string | null, activeSwatchId: string | null): void;
@@ -36,8 +50,18 @@ export interface EditorState {
         x: number;
         y: number;
     } | null;
+    /** Last pointer position over the map in render-space (y-down), updated on every pointermove. */
+    cursorMap: {
+        x: number;
+        y: number;
+    } | null;
+    /** In-memory clipboard of copied rooms. Not persisted across reloads. */
+    clipboard: RoomClipboard | null;
     sidebarTab: string;
     panelCollapsed: boolean;
+    panelExpanded: boolean;
+    /** Side panel width in pixels (persisted). Ignored when the panel is collapsed or modal-expanded. */
+    panelWidth: number;
     contextMenu: ContextMenuState;
     savedUndoLength: number;
     /** When set, the next area/z navigation pans to this map-space point instead of fitting. Consumed and cleared by App. */

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

@@ -65,6 +65,10 @@ export type HitItem = {
     kind: 'customLine';
     roomId: number;
     exitName: string;
+} | {
+    kind: 'stub';
+    roomId: number;
+    dir: Direction;
 } | {
     kind: 'label';
     id: number;
@@ -83,6 +87,10 @@ export type Selection = {
     roomId: number;
     exitName: string;
     pointIndex?: number;
+} | {
+    kind: 'stub';
+    roomId: number;
+    dir: Direction;
 } | {
     kind: 'label';
     id: number;
@@ -101,6 +109,10 @@ export type HoverTarget = {
     kind: 'customLine';
     roomId: number;
     exitName: string;
+} | {
+    kind: 'stub';
+    roomId: number;
+    dir: Direction;
 } | {
     kind: 'label';
     id: number;
@@ -322,6 +334,11 @@ export type Command = {
     field: 'name' | 'environment' | 'weight' | 'symbol';
     from: string | number;
     to: string | number;
+} | {
+    kind: 'setRoomHash';
+    id: number;
+    from: string | null;
+    to: string | null;
 } | {
     kind: 'addArea';
     id: number;