@movk/maplibre 1.0.0

package/dist/runtime/components/Map.vue

@@ -0,0 +1,134 @@
+<script setup>
+import { onMounted, onUnmounted, provide, useId, useTemplateRef, watch } from "vue";
+import { useResizeObserver } from "@vueuse/core";
+import { omitUndefined } from "@movk/core";
+import { LngLat } from "maplibre-gl";
+import { createMaplibreContext, MaplibreContextKey } from "../domains/map/context";
+import { createMaplibreGl } from "../domains/map/create-map";
+import { getMaplibreConfig } from "../domains/map/config";
+import { getMapContext, registerMap, unregisterMap } from "../domains/map/registry";
+import { bindMapEvents } from "../utils/events";
+defineOptions({ inheritAttrs: false });
+function blankStyle() {
+  const { glyphs } = getMaplibreConfig();
+  return { version: 8, ...glyphs ? { glyphs } : {}, sources: {}, layers: [] };
+}
+const props = defineProps({
+  mapId: { type: String, required: false },
+  options: { type: Object, required: false },
+  persistent: { type: Boolean, required: false, default: false }
+});
+const emit = defineEmits(["load", "idle", "error", "click", "dblclick", "contextmenu", "mousemove", "mousedown", "mouseup", "movestart", "moveend", "zoomstart", "zoomend", "rotateend", "pitchend", "dragend", "styledata", "sourcedata"]);
+const FORWARDED_EVENTS = [
+  "error",
+  "click",
+  "dblclick",
+  "contextmenu",
+  "mousemove",
+  "mousedown",
+  "mouseup",
+  "movestart",
+  "moveend",
+  "zoomstart",
+  "zoomend",
+  "rotateend",
+  "pitchend",
+  "dragend",
+  "styledata",
+  "sourcedata"
+];
+const center = defineModel("center", { type: [Object, Array] });
+const zoom = defineModel("zoom", { type: Number });
+const bearing = defineModel("bearing", { type: Number });
+const pitch = defineModel("pitch", { type: Number });
+const container = useTemplateRef("container");
+const mapId = props.mapId ?? `movk-maplibre-${useId()}`;
+const existing = props.mapId ? getMapContext(mapId) : void 0;
+const created = existing ? void 0 : createMaplibreContext(mapId);
+const context = existing ?? created.context;
+provide(MaplibreContextKey, context);
+if (created && props.mapId) registerMap(context);
+function syncModelsFromMap(map) {
+  const c = map.getCenter();
+  center.value = [c.lng, c.lat];
+  zoom.value = map.getZoom();
+  bearing.value = map.getBearing();
+  pitch.value = map.getPitch();
+}
+let runtimeBound = false;
+function bindRuntime(map) {
+  if (runtimeBound) return;
+  runtimeBound = true;
+  bindMapEvents(map, FORWARDED_EVENTS, (type, event) => emit(type, event));
+  map.on("load", () => emit("load", map));
+  map.on("idle", () => emit("idle", map));
+  map.on("moveend", () => syncModelsFromMap(map));
+  useResizeObserver(container, () => map.resize());
+}
+onMounted(() => {
+  if (existing?.map.value) {
+    bindRuntime(existing.map.value);
+    return;
+  }
+  if (!created || !container.value) return;
+  const map = createMaplibreGl(omitUndefined({
+    ...props.options,
+    style: props.options?.style ?? blankStyle(),
+    center: center.value ?? props.options?.center,
+    zoom: zoom.value ?? props.options?.zoom,
+    bearing: bearing.value ?? props.options?.bearing,
+    pitch: pitch.value ?? props.options?.pitch,
+    container: container.value
+  }));
+  created.attach(map);
+  bindRuntime(map);
+});
+watch(center, (value) => {
+  const map = context.map.value;
+  if (!map || !value) return;
+  const next = LngLat.convert(value);
+  const cur = map.getCenter();
+  if (Math.abs(cur.lng - next.lng) < 1e-9 && Math.abs(cur.lat - next.lat) < 1e-9) return;
+  map.setCenter(value);
+});
+watch(zoom, (value) => {
+  const map = context.map.value;
+  if (!map || value === void 0 || map.getZoom() === value) return;
+  map.setZoom(value);
+});
+watch(bearing, (value) => {
+  const map = context.map.value;
+  if (!map || value === void 0 || map.getBearing() === value) return;
+  map.setBearing(value);
+});
+watch(pitch, (value) => {
+  const map = context.map.value;
+  if (!map || value === void 0 || map.getPitch() === value) return;
+  map.setPitch(value);
+});
+watch(() => props.options?.style, (style) => {
+  const map = context.map.value;
+  if (!map || !style) return;
+  map.setStyle(style, { diff: false });
+});
+onUnmounted(() => {
+  if (props.persistent) return;
+  context.map.value?.remove();
+  unregisterMap(context.id);
+});
+defineExpose({
+  /** 当前地图上下文 */
+  context: () => context
+});
+</script>
+
+<template>
+  <div class="movk-maplibre" v-bind="$attrs">
+    <div ref="container" class="movk-maplibre__container" />
+    <slot />
+  </div>
+</template>
+
+<style>
+@layer components{:where(.movk-maplibre){height:100%;position:relative;width:100%}}.movk-maplibre>.movk-maplibre__container{inset:0;position:absolute}
+</style>

package/dist/runtime/components/Map.vue.d.ts

@@ -0,0 +1,84 @@
+import type { LngLatLike, Map as MaplibreMap } from 'maplibre-gl';
+import type { MaplibreMapOptions } from '../types';
+type __VLS_Props = {
+    /** 地图 id；省略时自动生成。提供后可经 useMaplibre(id) 外部访问 */
+    mapId?: string;
+    /**
+     * maplibre-gl Map 初始化选项（container 由组件接管）；缺省 style 时使用空白样式
+     * @see https://maplibre.org/maplibre-gl-js/docs/API/type-aliases/MapOptions/
+     */
+    options?: MaplibreMapOptions;
+    /** 卸载时不销毁实例，配合 keepalive / `<keep-alive>` 跨路由复用 */
+    persistent?: boolean;
+};
+type __VLS_ModelProps = {
+    'center'?: LngLatLike;
+    'zoom'?: number;
+    'bearing'?: number;
+    'pitch'?: number;
+};
+type __VLS_PublicProps = __VLS_Props & __VLS_ModelProps;
+declare var __VLS_1: {};
+type __VLS_Slots = {} & {
+    default?: (props: typeof __VLS_1) => any;
+};
+declare const __VLS_base: import("vue").DefineComponent<__VLS_PublicProps, {
+    /** 当前地图上下文 */
+    context: () => import("../types").MaplibreContext;
+}, {}, {}, {}, import("vue").ComponentOptionsMixin, import("vue").ComponentOptionsMixin, {
+    click: (event: import("maplibre-gl").MapMouseEvent) => any;
+    load: (map: MaplibreMap) => any;
+    error: (event: import("maplibre-gl").ErrorEvent) => any;
+    idle: (map: MaplibreMap) => any;
+    sourcedata: (event: import("maplibre-gl").MapSourceDataEvent) => any;
+    styledata: (event: import("maplibre-gl").MapStyleDataEvent) => any;
+    contextmenu: (event: import("maplibre-gl").MapMouseEvent) => any;
+    dblclick: (event: import("maplibre-gl").MapMouseEvent) => any;
+    mousemove: (event: import("maplibre-gl").MapMouseEvent) => any;
+    mouseup: (event: import("maplibre-gl").MapMouseEvent) => any;
+    mousedown: (event: import("maplibre-gl").MapMouseEvent) => any;
+    movestart: (event: import("maplibre-gl").MapMovementEvent) => any;
+    moveend: (event: import("maplibre-gl").MapMovementEvent) => any;
+    zoomstart: (event: import("maplibre-gl").MapMovementEvent) => any;
+    zoomend: (event: import("maplibre-gl").MapMovementEvent) => any;
+    rotateend: (event: import("maplibre-gl").MapMovementEvent) => any;
+    dragend: (event: import("maplibre-gl").MapMovementEvent) => any;
+    pitchend: (event: import("maplibre-gl").MapMovementEvent) => any;
+    "update:center": (value: LngLatLike | undefined) => any;
+    "update:zoom": (value: number | undefined) => any;
+    "update:bearing": (value: number | undefined) => any;
+    "update:pitch": (value: number | undefined) => any;
+}, string, import("vue").PublicProps, Readonly<__VLS_PublicProps> & Readonly<{
+    onClick?: ((event: import("maplibre-gl").MapMouseEvent) => any) | undefined;
+    onLoad?: ((map: MaplibreMap) => any) | undefined;
+    onError?: ((event: import("maplibre-gl").ErrorEvent) => any) | undefined;
+    onIdle?: ((map: MaplibreMap) => any) | undefined;
+    onSourcedata?: ((event: import("maplibre-gl").MapSourceDataEvent) => any) | undefined;
+    onStyledata?: ((event: import("maplibre-gl").MapStyleDataEvent) => any) | undefined;
+    onContextmenu?: ((event: import("maplibre-gl").MapMouseEvent) => any) | undefined;
+    onDblclick?: ((event: import("maplibre-gl").MapMouseEvent) => any) | undefined;
+    onMousemove?: ((event: import("maplibre-gl").MapMouseEvent) => any) | undefined;
+    onMouseup?: ((event: import("maplibre-gl").MapMouseEvent) => any) | undefined;
+    onMousedown?: ((event: import("maplibre-gl").MapMouseEvent) => any) | undefined;
+    onMovestart?: ((event: import("maplibre-gl").MapMovementEvent) => any) | undefined;
+    onMoveend?: ((event: import("maplibre-gl").MapMovementEvent) => any) | undefined;
+    onZoomstart?: ((event: import("maplibre-gl").MapMovementEvent) => any) | undefined;
+    onZoomend?: ((event: import("maplibre-gl").MapMovementEvent) => any) | undefined;
+    onRotateend?: ((event: import("maplibre-gl").MapMovementEvent) => any) | undefined;
+    onDragend?: ((event: import("maplibre-gl").MapMovementEvent) => any) | undefined;
+    onPitchend?: ((event: import("maplibre-gl").MapMovementEvent) => any) | undefined;
+    "onUpdate:center"?: ((value: LngLatLike | undefined) => any) | undefined;
+    "onUpdate:zoom"?: ((value: number | undefined) => any) | undefined;
+    "onUpdate:bearing"?: ((value: number | undefined) => any) | undefined;
+    "onUpdate:pitch"?: ((value: number | undefined) => any) | undefined;
+}>, {
+    persistent: boolean;
+}, {}, {}, {}, string, import("vue").ComponentProvideOptions, false, {}, any>;
+declare const __VLS_export: __VLS_WithSlots<typeof __VLS_base, __VLS_Slots>;
+declare const _default: typeof __VLS_export;
+export default _default;
+type __VLS_WithSlots<T, S> = T & {
+    new (): {
+        $slots: S;
+    };
+};

package/dist/runtime/components/Marker.d.vue.ts

@@ -0,0 +1,54 @@
+import { Marker } from 'maplibre-gl';
+import type { LngLatLike, MarkerOptions, PopupOptions } from 'maplibre-gl';
+import type { PopupTrigger } from '../types';
+type __VLS_Props = {
+    /**
+     * 标记选项；element 由默认插槽提供，无需在此传入
+     * @see https://maplibre.org/maplibre-gl-js/docs/API/type-aliases/MarkerOptions/
+     */
+    options?: Omit<MarkerOptions, 'element'>;
+    /**
+     * 弹窗选项，仅在提供 #popup 插槽时生效
+     * @see https://maplibre.org/maplibre-gl-js/docs/API/type-aliases/PopupOptions/
+     */
+    popupOptions?: PopupOptions;
+    /**
+     * #popup 插槽的触发时机；'none' 表示不绑定监听，完全由 v-model:open 受控
+     * @defaultValue 'click'
+     */
+    trigger?: PopupTrigger;
+};
+declare function closePopup(): void;
+type __VLS_ModelProps = {
+    'lnglat': LngLatLike;
+    /** 弹窗开合状态；初始传 true 即默认展开 */
+    'open'?: boolean;
+};
+type __VLS_PublicProps = __VLS_Props & __VLS_ModelProps;
+declare var __VLS_1: {}, __VLS_11: {
+    close: typeof closePopup;
+};
+type __VLS_Slots = {} & {
+    default?: (props: typeof __VLS_1) => any;
+} & {
+    popup?: (props: typeof __VLS_11) => any;
+};
+declare const __VLS_base: import("vue").DefineComponent<__VLS_PublicProps, {
+    marker: () => Marker | undefined;
+}, {}, {}, {}, import("vue").ComponentOptionsMixin, import("vue").ComponentOptionsMixin, {
+    "update:lnglat": (value: LngLatLike) => any;
+    "update:open": (value: boolean) => any;
+}, string, import("vue").PublicProps, Readonly<__VLS_PublicProps> & Readonly<{
+    "onUpdate:lnglat"?: ((value: LngLatLike) => any) | undefined;
+    "onUpdate:open"?: ((value: boolean) => any) | undefined;
+}>, {
+    trigger: PopupTrigger;
+}, {}, {}, {}, string, import("vue").ComponentProvideOptions, false, {}, any>;
+declare const __VLS_export: __VLS_WithSlots<typeof __VLS_base, __VLS_Slots>;
+declare const _default: typeof __VLS_export;
+export default _default;
+type __VLS_WithSlots<T, S> = T & {
+    new (): {
+        $slots: S;
+    };
+};

package/dist/runtime/components/Marker.vue

@@ -0,0 +1,86 @@
+<script setup>
+import { onMounted, onUnmounted, ref, useSlots, useTemplateRef, watch } from "vue";
+import { Marker } from "maplibre-gl";
+import { useMap } from "../composables/useMap";
+import MaplibrePopup from "./Popup.vue";
+const props = defineProps({
+  options: { type: Object, required: false },
+  popupOptions: { type: Object, required: false },
+  trigger: { type: String, required: false, default: "click" }
+});
+const lnglat = defineModel("lnglat", { type: [Object, Array], ...{ required: true } });
+const open = defineModel("open", { type: Boolean, ...{ default: false } });
+const ctx = useMap();
+const slots = useSlots();
+const el = useTemplateRef("el");
+const ready = ref(false);
+let marker;
+let unbindTrigger;
+function openPopup() {
+  open.value = true;
+}
+function closePopup() {
+  open.value = false;
+}
+function togglePopup() {
+  open.value = !open.value;
+}
+function onElementClick(event) {
+  event.stopPropagation();
+  togglePopup();
+}
+function bindTrigger() {
+  unbindTrigger?.();
+  unbindTrigger = void 0;
+  if (!marker || !slots.popup || props.trigger === "none") return;
+  const element = marker.getElement();
+  if (props.trigger === "click") {
+    element.addEventListener("click", onElementClick);
+    unbindTrigger = () => element.removeEventListener("click", onElementClick);
+    return;
+  }
+  element.addEventListener("mouseenter", openPopup);
+  element.addEventListener("mouseleave", closePopup);
+  unbindTrigger = () => {
+    element.removeEventListener("mouseenter", openPopup);
+    element.removeEventListener("mouseleave", closePopup);
+  };
+}
+onMounted(async () => {
+  const map = await ctx.whenLoaded();
+  const useSlot = Boolean(slots.default && el.value);
+  marker = new Marker({ ...props.options, ...useSlot ? { element: el.value } : {} });
+  marker.setLngLat(lnglat.value).addTo(map);
+  ready.value = true;
+  bindTrigger();
+  if (props.options?.draggable) {
+    marker.on("dragend", () => {
+      const { lng, lat } = marker.getLngLat();
+      lnglat.value = [lng, lat];
+    });
+  }
+});
+watch(lnglat, (value) => {
+  if (value) marker?.setLngLat(value);
+});
+watch(() => props.trigger, bindTrigger);
+onUnmounted(() => {
+  unbindTrigger?.();
+  marker?.remove();
+});
+defineExpose({ marker: () => marker });
+</script>
+
+<template>
+  <div v-if="$slots.default" ref="el" :style="{ visibility: ready ? void 0 : 'hidden' }">
+    <slot />
+  </div>
+  <MaplibrePopup
+    v-if="$slots.popup && open"
+    :lnglat="lnglat"
+    :options="popupOptions"
+    @close="closePopup"
+  >
+    <slot name="popup" :close="closePopup" />
+  </MaplibrePopup>
+</template>

package/dist/runtime/components/Marker.vue.d.ts

@@ -0,0 +1,54 @@
+import { Marker } from 'maplibre-gl';
+import type { LngLatLike, MarkerOptions, PopupOptions } from 'maplibre-gl';
+import type { PopupTrigger } from '../types';
+type __VLS_Props = {
+    /**
+     * 标记选项；element 由默认插槽提供，无需在此传入
+     * @see https://maplibre.org/maplibre-gl-js/docs/API/type-aliases/MarkerOptions/
+     */
+    options?: Omit<MarkerOptions, 'element'>;
+    /**
+     * 弹窗选项，仅在提供 #popup 插槽时生效
+     * @see https://maplibre.org/maplibre-gl-js/docs/API/type-aliases/PopupOptions/
+     */
+    popupOptions?: PopupOptions;
+    /**
+     * #popup 插槽的触发时机；'none' 表示不绑定监听，完全由 v-model:open 受控
+     * @defaultValue 'click'
+     */
+    trigger?: PopupTrigger;
+};
+declare function closePopup(): void;
+type __VLS_ModelProps = {
+    'lnglat': LngLatLike;
+    /** 弹窗开合状态；初始传 true 即默认展开 */
+    'open'?: boolean;
+};
+type __VLS_PublicProps = __VLS_Props & __VLS_ModelProps;
+declare var __VLS_1: {}, __VLS_11: {
+    close: typeof closePopup;
+};
+type __VLS_Slots = {} & {
+    default?: (props: typeof __VLS_1) => any;
+} & {
+    popup?: (props: typeof __VLS_11) => any;
+};
+declare const __VLS_base: import("vue").DefineComponent<__VLS_PublicProps, {
+    marker: () => Marker | undefined;
+}, {}, {}, {}, import("vue").ComponentOptionsMixin, import("vue").ComponentOptionsMixin, {
+    "update:lnglat": (value: LngLatLike) => any;
+    "update:open": (value: boolean) => any;
+}, string, import("vue").PublicProps, Readonly<__VLS_PublicProps> & Readonly<{
+    "onUpdate:lnglat"?: ((value: LngLatLike) => any) | undefined;
+    "onUpdate:open"?: ((value: boolean) => any) | undefined;
+}>, {
+    trigger: PopupTrigger;
+}, {}, {}, {}, string, import("vue").ComponentProvideOptions, false, {}, any>;
+declare const __VLS_export: __VLS_WithSlots<typeof __VLS_base, __VLS_Slots>;
+declare const _default: typeof __VLS_export;
+export default _default;
+type __VLS_WithSlots<T, S> = T & {
+    new (): {
+        $slots: S;
+    };
+};

package/dist/runtime/components/Popup.d.vue.ts

@@ -0,0 +1,30 @@
+import { Popup } from 'maplibre-gl';
+import type { LngLatLike, PopupOptions } from 'maplibre-gl';
+type __VLS_Props = {
+    /** 弹窗锚定的经纬度 */
+    lnglat: LngLatLike;
+    /**
+     * Popup 选项
+     * @see https://maplibre.org/maplibre-gl-js/docs/API/type-aliases/PopupOptions/
+     */
+    options?: PopupOptions;
+};
+declare var __VLS_1: {};
+type __VLS_Slots = {} & {
+    default?: (props: typeof __VLS_1) => any;
+};
+declare const __VLS_base: import("vue").DefineComponent<__VLS_Props, {
+    popup: () => Popup | undefined;
+}, {}, {}, {}, import("vue").ComponentOptionsMixin, import("vue").ComponentOptionsMixin, {
+    close: () => any;
+}, string, import("vue").PublicProps, Readonly<__VLS_Props> & Readonly<{
+    onClose?: (() => any) | undefined;
+}>, {}, {}, {}, {}, string, import("vue").ComponentProvideOptions, false, {}, any>;
+declare const __VLS_export: __VLS_WithSlots<typeof __VLS_base, __VLS_Slots>;
+declare const _default: typeof __VLS_export;
+export default _default;
+type __VLS_WithSlots<T, S> = T & {
+    new (): {
+        $slots: S;
+    };
+};

package/dist/runtime/components/Popup.vue

@@ -0,0 +1,33 @@
+<script setup>
+import { onMounted, onUnmounted, useTemplateRef, watch } from "vue";
+import { Popup } from "maplibre-gl";
+import { useMap } from "../composables/useMap";
+const props = defineProps({
+  lnglat: { type: [Object, Array], required: true },
+  options: { type: Object, required: false }
+});
+const emit = defineEmits(["close"]);
+defineOptions({ inheritAttrs: false });
+const ctx = useMap();
+const el = useTemplateRef("el");
+let popup;
+onMounted(async () => {
+  const map = await ctx.whenLoaded();
+  popup = new Popup(props.options);
+  popup.setLngLat(props.lnglat);
+  if (el.value) popup.setDOMContent(el.value);
+  popup.on("close", () => emit("close"));
+  popup.addTo(map);
+});
+watch(() => props.lnglat, (value) => popup?.setLngLat(value));
+onUnmounted(() => popup?.remove());
+defineExpose({ popup: () => popup });
+</script>
+
+<template>
+  <div style="display: none">
+    <div ref="el" v-bind="$attrs">
+      <slot />
+    </div>
+  </div>
+</template>

package/dist/runtime/components/Popup.vue.d.ts

@@ -0,0 +1,30 @@
+import { Popup } from 'maplibre-gl';
+import type { LngLatLike, PopupOptions } from 'maplibre-gl';
+type __VLS_Props = {
+    /** 弹窗锚定的经纬度 */
+    lnglat: LngLatLike;
+    /**
+     * Popup 选项
+     * @see https://maplibre.org/maplibre-gl-js/docs/API/type-aliases/PopupOptions/
+     */
+    options?: PopupOptions;
+};
+declare var __VLS_1: {};
+type __VLS_Slots = {} & {
+    default?: (props: typeof __VLS_1) => any;
+};
+declare const __VLS_base: import("vue").DefineComponent<__VLS_Props, {
+    popup: () => Popup | undefined;
+}, {}, {}, {}, import("vue").ComponentOptionsMixin, import("vue").ComponentOptionsMixin, {
+    close: () => any;
+}, string, import("vue").PublicProps, Readonly<__VLS_Props> & Readonly<{
+    onClose?: (() => any) | undefined;
+}>, {}, {}, {}, {}, string, import("vue").ComponentProvideOptions, false, {}, any>;
+declare const __VLS_export: __VLS_WithSlots<typeof __VLS_base, __VLS_Slots>;
+declare const _default: typeof __VLS_export;
+export default _default;
+type __VLS_WithSlots<T, S> = T & {
+    new (): {
+        $slots: S;
+    };
+};

package/dist/runtime/components/Source.d.vue.ts

@@ -0,0 +1,23 @@
+import type { SourceSpecification } from '@maplibre/maplibre-gl-style-spec';
+type __VLS_Props = {
+    /** 数据源 id，供图层经 source 字段按字符串引用 */
+    sourceId: string;
+    /**
+     * 数据源定义
+     * @see https://maplibre.org/maplibre-style-spec/sources/
+     */
+    source: SourceSpecification;
+};
+declare var __VLS_1: {};
+type __VLS_Slots = {} & {
+    default?: (props: typeof __VLS_1) => any;
+};
+declare const __VLS_base: import("vue").DefineComponent<__VLS_Props, {}, {}, {}, {}, import("vue").ComponentOptionsMixin, import("vue").ComponentOptionsMixin, {}, string, import("vue").PublicProps, Readonly<__VLS_Props> & Readonly<{}>, {}, {}, {}, {}, string, import("vue").ComponentProvideOptions, false, {}, any>;
+declare const __VLS_export: __VLS_WithSlots<typeof __VLS_base, __VLS_Slots>;
+declare const _default: typeof __VLS_export;
+export default _default;
+type __VLS_WithSlots<T, S> = T & {
+    new (): {
+        $slots: S;
+    };
+};

package/dist/runtime/components/Source.vue

@@ -0,0 +1,44 @@
+<script setup>
+import { onUnmounted, watch } from "vue";
+import { useMap } from "../composables/useMap";
+const props = defineProps({
+  sourceId: { type: String, required: true },
+  source: { type: Object, required: true }
+});
+const ctx = useMap();
+const stopReady = ctx.onReady((map) => {
+  if (!map.getSource(props.sourceId)) {
+    map.addSource(props.sourceId, props.source);
+  }
+});
+watch(() => props.source, (next) => {
+  const source = ctx.map.value?.getSource(props.sourceId);
+  if (!source) return;
+  if (next.type === "geojson" && next.data) {
+    source.setData(next.data);
+  } else if (next.type === "vector") {
+    if (next.url) source.setUrl(next.url);
+    if (next.tiles) source.setTiles(next.tiles);
+  } else if (next.type === "raster" || next.type === "raster-dem") {
+    if (next.url) source.setUrl(next.url);
+    if (next.tiles) source.setTiles(next.tiles);
+  } else if (next.type === "image" && next.url) {
+    source.updateImage(next);
+  } else if (next.type === "video" && next.coordinates) {
+    source.setCoordinates(next.coordinates);
+  }
+}, { deep: true });
+onUnmounted(() => {
+  stopReady();
+  const map = ctx.map.value;
+  if (!map?.getSource(props.sourceId)) return;
+  try {
+    map.removeSource(props.sourceId);
+  } catch {
+  }
+});
+</script>
+
+<template>
+  <slot />
+</template>

package/dist/runtime/components/Source.vue.d.ts

@@ -0,0 +1,23 @@
+import type { SourceSpecification } from '@maplibre/maplibre-gl-style-spec';
+type __VLS_Props = {
+    /** 数据源 id，供图层经 source 字段按字符串引用 */
+    sourceId: string;
+    /**
+     * 数据源定义
+     * @see https://maplibre.org/maplibre-style-spec/sources/
+     */
+    source: SourceSpecification;
+};
+declare var __VLS_1: {};
+type __VLS_Slots = {} & {
+    default?: (props: typeof __VLS_1) => any;
+};
+declare const __VLS_base: import("vue").DefineComponent<__VLS_Props, {}, {}, {}, {}, import("vue").ComponentOptionsMixin, import("vue").ComponentOptionsMixin, {}, string, import("vue").PublicProps, Readonly<__VLS_Props> & Readonly<{}>, {}, {}, {}, {}, string, import("vue").ComponentProvideOptions, false, {}, any>;
+declare const __VLS_export: __VLS_WithSlots<typeof __VLS_base, __VLS_Slots>;
+declare const _default: typeof __VLS_export;
+export default _default;
+type __VLS_WithSlots<T, S> = T & {
+    new (): {
+        $slots: S;
+    };
+};

package/dist/runtime/components/Tooltip.d.vue.ts

@@ -0,0 +1,45 @@
+import type { GeoJSONFeature, PopupOptions } from 'maplibre-gl';
+import type { PopupTrigger } from '../types';
+/** 目标图层要素的弹窗：按 trigger 以悬浮或点击触发，作用域插槽拿到当前要素。 */
+type __VLS_Props = {
+    /** 目标图层 id */
+    layerId: string;
+    /**
+     * Popup 选项（hover 模式下 closeButton/closeOnClick 由组件接管）
+     * @see https://maplibre.org/maplibre-gl-js/docs/API/type-aliases/PopupOptions/
+     */
+    options?: PopupOptions;
+    /**
+     * 悬浮时鼠标指针样式
+     * @defaultValue 'pointer'
+     */
+    cursor?: string;
+    /**
+     * 触发时机；'none' 表示不绑定任何监听，可用于临时停用
+     * @defaultValue 'hover'
+     */
+    trigger?: PopupTrigger;
+};
+declare function close(): void;
+declare var __VLS_1: {
+    feature: GeoJSONFeature | undefined;
+    close: typeof close;
+};
+type __VLS_Slots = {} & {
+    default?: (props: typeof __VLS_1) => any;
+};
+declare const __VLS_base: import("vue").DefineComponent<__VLS_Props, {
+    /** 当前激活要素 */
+    hovered: () => GeoJSONFeature | undefined;
+}, {}, {}, {}, import("vue").ComponentOptionsMixin, import("vue").ComponentOptionsMixin, {}, string, import("vue").PublicProps, Readonly<__VLS_Props> & Readonly<{}>, {
+    trigger: PopupTrigger;
+    cursor: string;
+}, {}, {}, {}, string, import("vue").ComponentProvideOptions, false, {}, any>;
+declare const __VLS_export: __VLS_WithSlots<typeof __VLS_base, __VLS_Slots>;
+declare const _default: typeof __VLS_export;
+export default _default;
+type __VLS_WithSlots<T, S> = T & {
+    new (): {
+        $slots: S;
+    };
+};