mudlet-map-renderer 2.0.0 → 2.1.0

package/dist/rendering/KonvaRenderBackend.d.ts

@@ -116,7 +116,7 @@ export declare class KonvaRenderBackend implements InteractiveBackend {
     private applyPositionMarker;
     private clearCurrentRoomOverlay;
     private updateCurrentRoomOverlay;
-    syncHighlight(roomId: number, color: string | undefined): void;
+    syncHighlight(roomId: number, colors: string[] | undefined): void;
     syncHighlights(): void;
     syncPaths(): void;
     private clearOverlayShapes;

package/dist/rendering/MapRenderer.d.ts

@@ -99,7 +99,12 @@ export declare class MapRenderer {
     updatePositionMarker(roomId: number): void;
     clearPosition(): void;
     centerOn(roomId: number, instant?: boolean): void;
-    renderHighlight(roomId: number, color: string): void;
+    /**
+     * Highlight a room. Pass a single colour for the classic ring/marker, or an
+     * array of colours to split the highlight into that many equal pie wedges
+     * (one colour each).
+     */
+    renderHighlight(roomId: number, color: string | string[]): void;
     removeHighlight(roomId: number): void;
     hasHighlight(roomId: number): boolean;
     clearHighlights(): void;

package/dist/scene/OverlayStyle.d.ts

@@ -7,15 +7,19 @@ export type HighlightData = {
     /** For circle: radius. For rect: half-size. */
     size: number;
     cornerRadius: number;
-    strokeColor: string;
+    /**
+     * One or more colours. A single colour draws the classic ring/marker; two
+     * or more split the highlight into that many equal pie wedges (one colour
+     * each).
+     */
+    colors: string[];
     strokeAlpha: number;
     strokeWidth: number;
-    fillColor: string;
     fillAlpha: number;
     dash?: number[];
     dashEnabled: boolean;
 };
-export declare function computeHighlight(room: MapData.Room, color: string, settings: Settings): HighlightData;
+export declare function computeHighlight(room: MapData.Room, color: string | string[], settings: Settings): HighlightData;
 export type PositionMarkerData = {
     shape: 'circle' | 'rect';
     cx: number;

package/dist/scene/Shape.d.ts

@@ -62,6 +62,13 @@ export interface Paint {
 }
 /** True when `fill` is a gradient object rather than a colour string. */
 export declare function isGradientFill(fill: FillStyle | undefined): fill is LinearGradient | RadialGradient;
+/**
+ * Resolve a paint's effective dash pattern. Returns the dash only when it is
+ * present AND not explicitly disabled (`dashEnabled === false` blanks it).
+ * Renderers call this so every shape kind — rect, circle, line — honours
+ * `dashEnabled` identically.
+ */
+export declare function resolveDash(dash: number[] | undefined, dashEnabled: boolean | undefined): number[] | undefined;
 /**
  * Apply a camera-style affine (translate by world origin, scale uniformly,
  * translate by render offset) to a fill. Strings pass through unchanged.

package/dist/scene/elements/OverlayLayout.d.ts

@@ -6,6 +6,9 @@ import { Shape } from '../Shape';
  * a group) so the corner dashes line up cleanly — each side's dash pattern
  * starts fresh at the corner instead of wrapping continuously around the
  * perimeter (same approach as the backend renderer).
+ *
+ * When the highlight carries more than one colour the ring is split into that
+ * many equal pie wedges via {@link highlightWedgesToShape}.
  */
 export declare function highlightToShape(data: HighlightData): Shape;
 /** Build the player-position marker. */

package/dist/types/Settings.d.ts

@@ -129,10 +129,18 @@ export type HighlightStyle = {
      */
     dashEnabled: boolean;
     /**
-     * When true, the highlight shape matches the current roomShape setting
-     * (rectangle, circle, or roundedRectangle). When false, the highlight is always a circle.
+     * @deprecated Use {@link shape} instead. Only consulted when `shape` is
+     * `'match'` (or omitted): when true (the default) the highlight follows the
+     * current roomShape (rectangle / roundedRectangle / circle); when false it
+     * is always a circle.
      */
-    matchRoomShape: boolean;
+    matchRoomShape?: boolean;
+    /**
+     * Outline shape of the highlight. `'match'` (the default when omitted)
+     * follows the current roomShape; the other values force that specific shape
+     * regardless of the room's shape.
+     */
+    shape?: 'match' | 'rectangle' | 'roundedRectangle' | 'circle';
 };
 /**
  * Settings for map rendering.

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "mudlet-map-renderer",
-  "version": "2.0.0",
+  "version": "2.1.0",
   "license": "MIT",
   "repository": {
     "url": "https://github.com/Delwing/mudlet-map-renderer"