mudlet-map-renderer 0.22.0-konva → 0.23.0-konva

package/dist/AreaMapRenderer.d.ts

@@ -42,24 +42,26 @@ export type AreaDomainInfo = {
     isEmpire: boolean;
 };
 export type DomainFilter = "ishtar" | "empire" | "interdomain" | "all";
-export declare class AreaMapSettings {
-    static areaWidth: number;
-    static areaHeight: number;
-    static areaSpacing: number;
-    static fontSize: number;
-    static connectionLineWidth: number;
-    static areaFillColor: string;
-    static areaStrokeColor: string;
-    static textColor: string;
-    static connectionColor: string;
-    static highlightColor: string;
-}
+export type AreaMapSettings = {
+    areaWidth: number;
+    areaHeight: number;
+    areaSpacing: number;
+    fontSize: number;
+    connectionLineWidth: number;
+    areaFillColor: string;
+    areaStrokeColor: string;
+    textColor: string;
+    connectionColor: string;
+    highlightColor: string;
+};
+export declare function createAreaMapSettings(): AreaMapSettings;
 export declare class AreaMapRenderer {
     private readonly stage;
     private readonly backgroundLayer;
     private readonly areaLayer;
     private readonly connectionLayer;
     private readonly mapReader;
+    private readonly settings;
     private areaNodes;
     private connectionGroups;
     private currentZoom;
@@ -69,7 +71,7 @@ export declare class AreaMapRenderer {
     private backgroundImage?;
     private backgroundConfig?;
     private dotsMode;
-    constructor(container: HTMLDivElement, mapReader: MapReader);
+    constructor(container: HTMLDivElement, mapReader: MapReader, settings?: AreaMapSettings);
     private initResize;
     private initScaling;
     setZoom(zoom: number): void;

package/dist/ExitRenderer.d.ts

@@ -1,6 +1,6 @@
 import { default as Exit } from './reader/Exit';
 import { default as MapReader } from './reader/MapReader';
-import { Renderer } from './Renderer';
+import { Settings, Renderer } from './Renderer';
 export type ExitDrawLine = {
     points: number[];
     stroke: string;
@@ -38,7 +38,8 @@ export type ExitDrawData = {
 export default class ExitRenderer {
     private mapReader;
     private mapRenderer;
-    constructor(mapReader: MapReader, mapRenderer: Renderer);
+    private readonly settings;
+    constructor(mapReader: MapReader, mapRenderer: Renderer, settings: Settings);
     /**
      * Get the edge point of a room based on its shape
      */

package/dist/PathRenderer.d.ts

@@ -1,10 +1,12 @@
 import { default as Konva } from 'konva';
 import { default as MapReader } from './reader/MapReader';
+import { Settings } from './Renderer';
 export default class PathRenderer {
     private readonly mapReader;
     private readonly overlayLayer;
+    private readonly settings;
     private paths;
-    constructor(mapReader: MapReader, overlayLayer: Konva.Layer);
+    constructor(mapReader: MapReader, overlayLayer: Konva.Layer, settings: Settings);
     private getRoomEdgePoint;
     private findConnection;
     private findExitDirection;

package/dist/Renderer.d.ts

@@ -24,6 +24,13 @@ export type RoomContextMenuEventDetail = {
         y: number;
     };
 };
+export type RoomClickEventDetail = {
+    roomId: number;
+    position: {
+        x: number;
+        y: number;
+    };
+};
 export type ZoomChangeEventDetail = {
     zoom: number;
 };
@@ -75,125 +82,56 @@ export type PlayerMarkerStyle = {
     dashEnabled: boolean;
 };
 /**
- * Global settings for map rendering.
- * All properties are static and can be modified at runtime to change the map's appearance and behavior.
+ * Settings for map rendering.
+ * All properties can be modified at runtime to change the map's appearance and behavior.
+ * Create with {@link createSettings} and pass to the {@link Renderer} constructor.
+ * Multiple renderers can share the same settings object for synchronized configuration.
  */
-export declare class Settings {
-    /**
-     * Size of each room in map units (width/height for rectangles, diameter for circles).
-     * Typical values: 0.2 - 1.5
-     * Default: 0.6
-     */
-    static roomSize: number;
-    /**
-     * Width of lines (exit connections, room borders) in map units.
-     * Typical values: 0.01 - 0.1
-     * Default: 0.025
-     */
-    static lineWidth: number;
-    /**
-     * Color of exit connection lines as RGB string.
-     * Example: 'rgb(225, 255, 225)' for light green
-     */
-    static lineColor: string;
-    /**
-     * When true, map instantly jumps to the new position when the current room changes.
-     * When false, the map smoothly animates/pans to the new position.
-     * Default: false (animated movement)
-     */
-    static instantMapMove: boolean;
-    /**
-     * When true, highlights the current room and its exits with an overlay.
-     * The overlay uses a semi-transparent color to emphasize the current position.
-     * Default: true
-     */
-    static highlightCurrentRoom: boolean;
-    /**
-     * Legacy flag for enabling/disabling culling (prefer using cullingMode instead).
-     * Default: true
-     */
-    static cullingEnabled: boolean;
-    /**
-     * Determines how off-screen elements are culled to improve performance:
-     * - "none": No culling, render everything (worst performance, best accuracy)
-     * - "basic": Classic viewport-based culling (good performance)
-     * - "indexed": Spatial index culling using R-tree (best performance)
-     *
-     * Default: "indexed"
-     */
-    static cullingMode: CullingMode;
-    /**
-     * Custom culling bounds for manually specifying the visible area.
-     * When set, only elements within these bounds are rendered.
-     * Format: { x, y, width, height } in map coordinates.
-     * Default: null (uses viewport bounds)
-     */
-    static cullingBounds: {
+export type Settings = {
+    /** Size of each room in map units (width/height for rectangles, diameter for circles). Default: 0.6 */
+    roomSize: number;
+    /** Width of lines (exit connections, room borders) in map units. Default: 0.025 */
+    lineWidth: number;
+    /** Color of exit connection lines as RGB string. Default: 'rgb(225, 255, 225)' */
+    lineColor: string;
+    /** Background color of the map container. Default: '#000000' */
+    backgroundColor: string;
+    /** When true, map instantly jumps to new position on room change. Default: false */
+    instantMapMove: boolean;
+    /** When true, highlights the current room and its exits with an overlay. Default: true */
+    highlightCurrentRoom: boolean;
+    /** Legacy flag for enabling/disabling culling (prefer cullingMode). Default: true */
+    cullingEnabled: boolean;
+    /** How off-screen elements are culled: "none" | "basic" | "indexed". Default: "indexed" */
+    cullingMode: CullingMode;
+    /** Custom culling bounds in map coordinates, or null for viewport bounds. Default: null */
+    cullingBounds: {
         x: number;
         y: number;
         width: number;
         height: number;
     } | null;
-    /**
-     * How to render room labels:
-     * - "image": Render labels as images (better performance for many labels)
-     * - "data": Render labels as text data (better for dynamic content)
-     *
-     * Default: "image"
-     */
-    static labelRenderMode: LabelRenderMode;
-    /**
-     * When true, room labels have transparent backgrounds.
-     * When false, labels have opaque backgrounds for better readability.
-     */
-    static transparentLabels: boolean;
-    /**
-     * Shape used to render rooms:
-     * - "rectangle": Rooms are drawn as squares/rectangles
-     * - "circle": Rooms are drawn as circles
-     *
-     * Default: "rectangle"
-     *
-     * Note: Exit line calculations automatically adjust based on room shape.
-     * Circle mode calculates exact tangent points on the circle's edge.
-     */
-    static roomShape: RoomShape;
-    /**
-     * Style configuration for the player position marker.
-     * See PlayerMarkerStyle type for details on individual properties.
-     *
-     * Default configuration creates a cyan-green dashed circle that's 1.7x the room size.
-     */
-    static playerMarker: PlayerMarkerStyle;
-    /**
-     * Whether to render a subtle background grid behind the map.
-     * Default: false
-     */
-    static gridEnabled: boolean;
-    /**
-     * Grid line spacing in map units (1 = every integer coordinate).
-     * Default: 1
-     */
-    static gridSize: number;
-    /**
-     * Color of the grid lines as a CSS color string.
-     * Default: 'rgba(255, 255, 255, 0.07)' (very subtle white)
-     */
-    static gridColor: string;
-    /**
-     * Width of grid lines in map units.
-     * Default: 0.02
-     */
-    static gridLineWidth: number;
-    /**
-     * Performance monitoring callback. When set, receives averaged PerfSnapshot
-     * every 60 culling frames (~1 second at 60fps) with timing breakdowns.
-     *
-     * Set to a function to enable, null to disable.
-     * Example: Settings.perfCallback = (stats) => console.log(stats);
-     */
-    static perfCallback: ((stats: PerfSnapshot) => void) | null;
-}
+    /** How to render room labels: "image" | "data". Default: "image" */
+    labelRenderMode: LabelRenderMode;
+    /** When true, room labels have transparent backgrounds. Default: false */
+    transparentLabels: boolean;
+    /** Shape used to render rooms: "rectangle" | "circle" | "roundedRectangle". Default: "rectangle" */
+    roomShape: RoomShape;
+    /** Style configuration for the player position marker. */
+    playerMarker: PlayerMarkerStyle;
+    /** Whether to render a background grid. Default: false */
+    gridEnabled: boolean;
+    /** Grid line spacing in map units. Default: 1 */
+    gridSize: number;
+    /** Color of grid lines as CSS color string. Default: 'rgba(255, 255, 255, 0.07)' */
+    gridColor: string;
+    /** Width of grid lines in map units. Default: 0.02 */
+    gridLineWidth: number;
+    /** Performance monitoring callback, or null to disable. */
+    perfCallback: ((stats: PerfSnapshot) => void) | null;
+};
+/** Creates a new Settings object with default values. */
+export declare function createSettings(): Settings;
 export declare class Renderer {
     private readonly stage;
     private readonly gridLayer;
@@ -202,6 +140,7 @@ export declare class Renderer {
     private readonly overlayLayer;
     private readonly positionLayer;
     private mapReader;
+    private readonly settings;
     private exitRenderer;
     private pathRenderer;
     private highlights;
@@ -233,7 +172,7 @@ export declare class Renderer {
     private exitBatchShape?;
     private visibleExitDrawData;
     private cachedGridBounds;
-    constructor(container: HTMLDivElement, mapReader: MapReader);
+    constructor(container: HTMLDivElement, mapReader: MapReader, settings?: Settings);
     private clientToMapPoint;
     private findRoomAtClientPoint;
     private initRoomHitDetection;
@@ -249,6 +188,7 @@ export declare class Renderer {
     private collectStandaloneExitCandidates;
     private refreshStandaloneExitBoundsIfNeeded;
     private emitRoomContextEvent;
+    private emitRoomClickEvent;
     private emitZoomChangeEvent;
     setZoom(zoom: number): boolean;
     /**
@@ -261,18 +201,19 @@ export declare class Renderer {
     getCullingMode(): CullingMode;
     getCurrentArea(): Area | undefined;
     /**
-     * Refreshes the current room overlay to reflect any changes to Settings.
+     * Refreshes the current room overlay to reflect any changes to settings.
      * Call this after modifying Settings properties (like roomSize, roomShape, lineWidth, etc.)
      * to update the visual appearance of the current room and its exits without changing position.
      */
     refreshCurrentRoomOverlay(): void;
     /**
-     * Completely refreshes the map to reflect changes to Settings.
+     * Completely refreshes the map to reflect changes to settings.
      * This re-renders the entire current area and updates the player position marker.
      * Call this after changing Settings properties like roomSize, roomShape, lineWidth, etc.
      *
      * Note: This is more expensive than refreshCurrentRoomOverlay() but ensures everything is updated.
      */
+    updateBackground(): void;
     refresh(): void;
     /**
      * Updates the player position marker without centering the view.
@@ -284,6 +225,8 @@ export declare class Renderer {
     renderPath(locations: number[], color?: string): import('konva/lib/Group').Group | import('konva/lib/Shape').Shape<import('konva/lib/Shape').ShapeConfig> | undefined;
     clearPaths(): void;
     renderHighlight(roomId: number, color: string): import('konva/lib/Shape').Shape<import('konva/lib/Shape').ShapeConfig> | undefined;
+    removeHighlight(roomId: number): void;
+    hasHighlight(roomId: number): boolean;
     clearHighlights(): void;
     private refreshHighlights;
     private createHighlightShape;