minemap-widget-and-controls

What problem does it solve?

MineMap's widget and control ecosystem often suffers from unclear ownership of the IControl protocol, inconsistent lifecycle usage, and a mix of product controls versus debugging tools. This Skill clarifies how to implement, compose, and manage controls like Navigation, Scale, Fullscreen, Geolocate, Attribution, as well as debugging widgets such as FPSControl, Thumbnail, ModelTransformationControl, and BatchAddInstanceControl, to ensure predictable behavior and robust UX across projects.

Core Features & Use Cases

• Unified IControl protocol: defines onAdd, onRemove, and getDefaultPosition for all map controls.
• Lifecycle and composition guidance: map.addControl, map.removeControl, and hasControl coordination to prevent duplicates.
• Product vs debugging controls: recommended usage patterns for Navigation, Scale, Fullscreen, Geolocate, Attribution, FPSControl, Thumbnail, ModelTransformationControl, BatchAddInstanceControl.
• Practical workflows: typical patterns for adding controls in load events and debugging scenarios, with best practices for interaction and accessibility.

Quick Start

Add a Navigation control and a Scale control to the map during the load event to initialize standard UI tooling.