mudlet-map-renderer 2.2.0 → 2.3.1

package/README.md

@@ -186,6 +186,34 @@ For large maps, spatial culling hides off-screen rooms for better performance:
 renderer.setCullingMode('indexed');
 ```
 
+### OffscreenCanvas rendering (Web Worker)
+
+For large maps, an opt-in backend moves per-frame rasterisation into a Web
+Worker via `OffscreenCanvas`, keeping the main thread responsive during
+pan/zoom. The default Konva backend is unchanged — pass the worker backend to
+`MapRenderer`'s `backendFactory` parameter:
+
+```ts
+import { MapRenderer, createSettings } from 'mudlet-map-renderer';
+import { createOffscreenBackend } from 'mudlet-map-renderer/offscreen';
+
+const renderer = new MapRenderer(
+  mapReader,
+  createSettings(),
+  container,
+  createOffscreenBackend(container), // ← opt in
+);
+```
+
+Everything else (drawing, navigation, styles, highlights, paths, hit-testing,
+events) works as usual. Hit-testing and `getDrawnExits()` stay synchronous; the
+one caveat is that `exportCanvas()` returns `undefined` (use the headless
+exporters instead). Image labels, the ambient-light overlay, and live effects
+are all supported.
+
+See **[docs/offscreen-rendering.md](docs/offscreen-rendering.md)** for the full
+guide — architecture, feature support, limitations, benchmarks, and the API.
+
 ### Styles
 
 A `Style` is a target-agnostic visual transformer. One style drives the

package/dist/index.d.ts

@@ -25,7 +25,7 @@ export type { CameraTransform } from './draw/DrawCommandBuilder';
 export { svgFromBatches } from './render/SvgRenderer';
 export { renderToCanvas } from './render/CanvasRenderer';
 export type { ImageFactory, CanvasRenderOptions } from './render/CanvasRenderer';
-export { Parchment, Blueprint, Neon, Sketchy, Isometric, Construction, SciFi, GradientRooms, StainedGlass, GraphPaper, Topographic, Watercolor, compose, identityStyle, applyStyleToShapes, } from './style';
+export { Parchment, Blueprint, Neon, Sketchy, Isometric, Construction, SciFi, GradientRooms, StainedGlass, GraphPaper, Topographic, Watercolor, DarkModern, TreasureMap, treasureMapDecorations, compose, identityStyle, applyStyleToShapes, } from './style';
 export type { Style, StyleContext, SketchyOptions, IsometricOptions, IsometricRotation, GradientRoomsOptions, WatercolorOptions, } from './style';
 export type { Exporter, ExportContext, ExportCanvas } from './export/Exporter';
 export { SvgExporter } from './export/SvgExporter';
@@ -38,6 +38,12 @@ export type { SceneOverlay, SceneOverlayContext } from './overlay/SceneOverlay';
 export type { LiveEffect, CoordinateTransform } from './overlay/LiveEffect';
 export { AmbientLightOverlay } from './overlay/AmbientLightOverlay';
 export type { AmbientLightOptions } from './overlay/AmbientLightOverlay';
+export { RippleEffect } from './overlay/RippleEffect';
+export type { RippleOptions } from './overlay/RippleEffect';
+export { WaypointOverlay } from './overlay/WaypointOverlay';
+export type { Waypoint } from './overlay/WaypointOverlay';
+export { placeLabels } from './labelPlacement';
+export type { Direction8, Rect, Obstacle, LabelPlacementItem, PlacedLabel, PlaceLabelsOptions, SlotScore, } from './labelPlacement';
 export { default as MapReader } from './reader/MapReader';
 export type { IMapReader } from './reader/MapReader';
 export { default as PathFinder } from './PathFinder';