@movk/maplibre 1.0.0

package/dist/runtime/components/Tooltip.vue

@@ -0,0 +1,106 @@
+<script setup>
+import { onMounted, onUnmounted, shallowRef, useTemplateRef, watch } from "vue";
+import { Popup } from "maplibre-gl";
+import { useMap } from "../composables/useMap";
+const props = defineProps({
+  layerId: { type: String, required: true },
+  options: { type: Object, required: false },
+  cursor: { type: String, required: false, default: "pointer" },
+  trigger: { type: String, required: false, default: "hover" }
+});
+const ctx = useMap();
+const el = useTemplateRef("el");
+const hovered = shallowRef();
+let popup;
+let unbind;
+function setCursor(value) {
+  const map = ctx.map.value;
+  if (map) map.getCanvas().style.cursor = value;
+}
+function show(event) {
+  const map = ctx.map.value;
+  if (!map || !popup || !el.value) return;
+  hovered.value = event.features?.[0];
+  popup.setLngLat(event.lngLat).setDOMContent(el.value);
+  if (!popup.isOpen()) popup.addTo(map);
+}
+function close() {
+  hovered.value = void 0;
+  popup?.remove();
+}
+function onMove(event) {
+  setCursor(props.cursor);
+  show(event);
+}
+function onLeave() {
+  setCursor("");
+  close();
+}
+function onClick(event) {
+  show(event);
+}
+function onEnter() {
+  setCursor(props.cursor);
+}
+function onLeaveCursor() {
+  setCursor("");
+}
+function popupOptions() {
+  return props.trigger === "hover" ? { ...props.options, closeButton: false, closeOnClick: false } : { closeButton: true, closeOnClick: false, ...props.options };
+}
+function bind(map) {
+  if (props.trigger === "none") return;
+  if (props.trigger === "hover") {
+    map.on("mousemove", props.layerId, onMove);
+    map.on("mouseleave", props.layerId, onLeave);
+    unbind = () => {
+      map.off("mousemove", props.layerId, onMove);
+      map.off("mouseleave", props.layerId, onLeave);
+    };
+    return;
+  }
+  map.on("click", props.layerId, onClick);
+  map.on("mouseenter", props.layerId, onEnter);
+  map.on("mouseleave", props.layerId, onLeaveCursor);
+  unbind = () => {
+    map.off("click", props.layerId, onClick);
+    map.off("mouseenter", props.layerId, onEnter);
+    map.off("mouseleave", props.layerId, onLeaveCursor);
+  };
+}
+function teardown() {
+  unbind?.();
+  unbind = void 0;
+  setCursor("");
+  popup?.remove();
+  popup = void 0;
+}
+function setup(map) {
+  popup = new Popup(popupOptions());
+  popup.on("close", () => hovered.value = void 0);
+  bind(map);
+}
+onMounted(async () => {
+  const map = await ctx.whenLoaded();
+  setup(map);
+});
+watch(() => props.trigger, () => {
+  const map = ctx.map.value;
+  if (!map) return;
+  teardown();
+  setup(map);
+});
+onUnmounted(teardown);
+defineExpose({
+  /** 当前激活要素 */
+  hovered: () => hovered.value
+});
+</script>
+
+<template>
+  <div style="display: none">
+    <div ref="el">
+      <slot :feature="hovered" :close="close" />
+    </div>
+  </div>
+</template>

package/dist/runtime/components/Tooltip.vue.d.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;
+    };
+};

package/dist/runtime/components/buffers/BufferCircle.d.vue.ts

@@ -0,0 +1,27 @@
+/** 圆形缓冲区：turf 测地圆，半径单位米。 */
+type __VLS_Props = {
+    /** 圆心经纬度 */
+    center: [number, number];
+    /** 半径（米） */
+    radius: number;
+    /**
+     * 圆周采样段数
+     * @defaultValue 64
+     */
+    steps?: number;
+    /** 图层 id 前缀；省略时自动生成 */
+    layerId?: string;
+    /** 主色（快捷样式） */
+    color?: string;
+    /** 整体覆盖填充 paint */
+    fillPaint?: Record<string, unknown>;
+    /** 整体覆盖描边 paint */
+    linePaint?: Record<string, unknown>;
+    /** 插入到该图层之前 */
+    beforeId?: string;
+};
+declare const __VLS_export: import("vue").DefineComponent<__VLS_Props, {}, {}, {}, {}, import("vue").ComponentOptionsMixin, import("vue").ComponentOptionsMixin, {}, string, import("vue").PublicProps, Readonly<__VLS_Props> & Readonly<{}>, {
+    steps: number;
+}, {}, {}, {}, string, import("vue").ComponentProvideOptions, false, {}, any>;
+declare const _default: typeof __VLS_export;
+export default _default;

package/dist/runtime/components/buffers/BufferCircle.vue

@@ -0,0 +1,30 @@
+<script setup>
+import { computed, useId } from "vue";
+import { circle } from "@turf/circle";
+import { bufferPaints } from "../../utils/buffer";
+import MaplibreSource from "../Source.vue";
+import MaplibreLayer from "../Layer.vue";
+const props = defineProps({
+  center: { type: Array, required: true },
+  radius: { type: Number, required: true },
+  steps: { type: Number, required: false, default: 64 },
+  layerId: { type: String, required: false },
+  color: { type: String, required: false },
+  fillPaint: { type: Object, required: false },
+  linePaint: { type: Object, required: false },
+  beforeId: { type: String, required: false }
+});
+const id = props.layerId ?? `movk-buffer-circle-${useId()}`;
+const source = computed(() => ({
+  type: "geojson",
+  data: circle(props.center, props.radius, { steps: props.steps, units: "meters" })
+}));
+const paints = computed(() => bufferPaints({ color: props.color }));
+</script>
+
+<template>
+  <MaplibreSource :source-id="id" :source="source">
+    <MaplibreLayer :layer-id="`${id}-fill`" type="fill" :source="id" :paint="fillPaint ?? paints.fill" :before-id="beforeId" />
+    <MaplibreLayer :layer-id="`${id}-line`" type="line" :source="id" :paint="linePaint ?? paints.line" :before-id="beforeId" />
+  </MaplibreSource>
+</template>

package/dist/runtime/components/buffers/BufferCircle.vue.d.ts

@@ -0,0 +1,27 @@
+/** 圆形缓冲区：turf 测地圆，半径单位米。 */
+type __VLS_Props = {
+    /** 圆心经纬度 */
+    center: [number, number];
+    /** 半径（米） */
+    radius: number;
+    /**
+     * 圆周采样段数
+     * @defaultValue 64
+     */
+    steps?: number;
+    /** 图层 id 前缀；省略时自动生成 */
+    layerId?: string;
+    /** 主色（快捷样式） */
+    color?: string;
+    /** 整体覆盖填充 paint */
+    fillPaint?: Record<string, unknown>;
+    /** 整体覆盖描边 paint */
+    linePaint?: Record<string, unknown>;
+    /** 插入到该图层之前 */
+    beforeId?: string;
+};
+declare const __VLS_export: import("vue").DefineComponent<__VLS_Props, {}, {}, {}, {}, import("vue").ComponentOptionsMixin, import("vue").ComponentOptionsMixin, {}, string, import("vue").PublicProps, Readonly<__VLS_Props> & Readonly<{}>, {
+    steps: number;
+}, {}, {}, {}, string, import("vue").ComponentProvideOptions, false, {}, any>;
+declare const _default: typeof __VLS_export;
+export default _default;

package/dist/runtime/components/buffers/BufferEllipse.d.vue.ts

@@ -0,0 +1,35 @@
+/** 椭圆缓冲区：半轴单位米，angle 为长轴方位角。 */
+type __VLS_Props = {
+    /** 中心经纬度 */
+    center: [number, number];
+    /** x 半轴（米） */
+    xSemiAxis: number;
+    /** y 半轴（米） */
+    ySemiAxis: number;
+    /**
+     * 旋转角（度，正北顺时针）
+     * @defaultValue 0
+     */
+    angle?: number;
+    /**
+     * 周长采样段数
+     * @defaultValue 64
+     */
+    steps?: number;
+    /** 图层 id 前缀；省略时自动生成 */
+    layerId?: string;
+    /** 主色（快捷样式） */
+    color?: string;
+    /** 整体覆盖填充 paint */
+    fillPaint?: Record<string, unknown>;
+    /** 整体覆盖描边 paint */
+    linePaint?: Record<string, unknown>;
+    /** 插入到该图层之前 */
+    beforeId?: string;
+};
+declare const __VLS_export: import("vue").DefineComponent<__VLS_Props, {}, {}, {}, {}, import("vue").ComponentOptionsMixin, import("vue").ComponentOptionsMixin, {}, string, import("vue").PublicProps, Readonly<__VLS_Props> & Readonly<{}>, {
+    steps: number;
+    angle: number;
+}, {}, {}, {}, string, import("vue").ComponentProvideOptions, false, {}, any>;
+declare const _default: typeof __VLS_export;
+export default _default;

package/dist/runtime/components/buffers/BufferEllipse.vue

@@ -0,0 +1,36 @@
+<script setup>
+import { computed, useId } from "vue";
+import { ellipse } from "@turf/ellipse";
+import { bufferPaints } from "../../utils/buffer";
+import MaplibreSource from "../Source.vue";
+import MaplibreLayer from "../Layer.vue";
+const props = defineProps({
+  center: { type: Array, required: true },
+  xSemiAxis: { type: Number, required: true },
+  ySemiAxis: { type: Number, required: true },
+  angle: { type: Number, required: false, default: 0 },
+  steps: { type: Number, required: false, default: 64 },
+  layerId: { type: String, required: false },
+  color: { type: String, required: false },
+  fillPaint: { type: Object, required: false },
+  linePaint: { type: Object, required: false },
+  beforeId: { type: String, required: false }
+});
+const id = props.layerId ?? `movk-buffer-ellipse-${useId()}`;
+const source = computed(() => ({
+  type: "geojson",
+  data: ellipse(props.center, props.xSemiAxis, props.ySemiAxis, {
+    angle: props.angle,
+    steps: props.steps,
+    units: "meters"
+  })
+}));
+const paints = computed(() => bufferPaints({ color: props.color }));
+</script>
+
+<template>
+  <MaplibreSource :source-id="id" :source="source">
+    <MaplibreLayer :layer-id="`${id}-fill`" type="fill" :source="id" :paint="fillPaint ?? paints.fill" :before-id="beforeId" />
+    <MaplibreLayer :layer-id="`${id}-line`" type="line" :source="id" :paint="linePaint ?? paints.line" :before-id="beforeId" />
+  </MaplibreSource>
+</template>

package/dist/runtime/components/buffers/BufferEllipse.vue.d.ts

@@ -0,0 +1,35 @@
+/** 椭圆缓冲区：半轴单位米，angle 为长轴方位角。 */
+type __VLS_Props = {
+    /** 中心经纬度 */
+    center: [number, number];
+    /** x 半轴（米） */
+    xSemiAxis: number;
+    /** y 半轴（米） */
+    ySemiAxis: number;
+    /**
+     * 旋转角（度，正北顺时针）
+     * @defaultValue 0
+     */
+    angle?: number;
+    /**
+     * 周长采样段数
+     * @defaultValue 64
+     */
+    steps?: number;
+    /** 图层 id 前缀；省略时自动生成 */
+    layerId?: string;
+    /** 主色（快捷样式） */
+    color?: string;
+    /** 整体覆盖填充 paint */
+    fillPaint?: Record<string, unknown>;
+    /** 整体覆盖描边 paint */
+    linePaint?: Record<string, unknown>;
+    /** 插入到该图层之前 */
+    beforeId?: string;
+};
+declare const __VLS_export: import("vue").DefineComponent<__VLS_Props, {}, {}, {}, {}, import("vue").ComponentOptionsMixin, import("vue").ComponentOptionsMixin, {}, string, import("vue").PublicProps, Readonly<__VLS_Props> & Readonly<{}>, {
+    steps: number;
+    angle: number;
+}, {}, {}, {}, string, import("vue").ComponentProvideOptions, false, {}, any>;
+declare const _default: typeof __VLS_export;
+export default _default;

package/dist/runtime/components/buffers/BufferLine.d.vue.ts

@@ -0,0 +1,21 @@
+import type { Feature, LineString } from 'geojson';
+/** 线缓冲区：沿线两侧扩展 width 米的走廊面。 */
+type __VLS_Props = {
+    /** 线要素、几何或坐标数组 */
+    line: Feature<LineString> | LineString | [number, number][];
+    /** 缓冲宽度（米） */
+    width: number;
+    /** 图层 id 前缀；省略时自动生成 */
+    layerId?: string;
+    /** 主色（快捷样式） */
+    color?: string;
+    /** 整体覆盖填充 paint */
+    fillPaint?: Record<string, unknown>;
+    /** 整体覆盖描边 paint */
+    linePaint?: Record<string, unknown>;
+    /** 插入到该图层之前 */
+    beforeId?: string;
+};
+declare const __VLS_export: 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 _default: typeof __VLS_export;
+export default _default;

package/dist/runtime/components/buffers/BufferLine.vue

@@ -0,0 +1,40 @@
+<script setup>
+import { computed, useId } from "vue";
+import { buffer } from "@turf/buffer";
+import { bufferPaints } from "../../utils/buffer";
+import MaplibreSource from "../Source.vue";
+import MaplibreLayer from "../Layer.vue";
+const props = defineProps({
+  line: { type: [Object, Array], required: true },
+  width: { type: Number, required: true },
+  layerId: { type: String, required: false },
+  color: { type: String, required: false },
+  fillPaint: { type: Object, required: false },
+  linePaint: { type: Object, required: false },
+  beforeId: { type: String, required: false }
+});
+const id = props.layerId ?? `movk-buffer-line-${useId()}`;
+function toFeature(line) {
+  if (Array.isArray(line)) {
+    return { type: "Feature", properties: {}, geometry: { type: "LineString", coordinates: line } };
+  }
+  if (line.type === "LineString") {
+    return { type: "Feature", properties: {}, geometry: line };
+  }
+  return line;
+}
+const EMPTY = { type: "FeatureCollection", features: [] };
+const source = computed(() => ({
+  type: "geojson",
+  // buffer 在退化输入下可能返回 undefined，回退空集合
+  data: buffer(toFeature(props.line), props.width, { units: "meters" }) ?? EMPTY
+}));
+const paints = computed(() => bufferPaints({ color: props.color }));
+</script>
+
+<template>
+  <MaplibreSource :source-id="id" :source="source">
+    <MaplibreLayer :layer-id="`${id}-fill`" type="fill" :source="id" :paint="fillPaint ?? paints.fill" :before-id="beforeId" />
+    <MaplibreLayer :layer-id="`${id}-line`" type="line" :source="id" :paint="linePaint ?? paints.line" :before-id="beforeId" />
+  </MaplibreSource>
+</template>

package/dist/runtime/components/buffers/BufferLine.vue.d.ts

@@ -0,0 +1,21 @@
+import type { Feature, LineString } from 'geojson';
+/** 线缓冲区：沿线两侧扩展 width 米的走廊面。 */
+type __VLS_Props = {
+    /** 线要素、几何或坐标数组 */
+    line: Feature<LineString> | LineString | [number, number][];
+    /** 缓冲宽度（米） */
+    width: number;
+    /** 图层 id 前缀；省略时自动生成 */
+    layerId?: string;
+    /** 主色（快捷样式） */
+    color?: string;
+    /** 整体覆盖填充 paint */
+    fillPaint?: Record<string, unknown>;
+    /** 整体覆盖描边 paint */
+    linePaint?: Record<string, unknown>;
+    /** 插入到该图层之前 */
+    beforeId?: string;
+};
+declare const __VLS_export: 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 _default: typeof __VLS_export;
+export default _default;

package/dist/runtime/components/buffers/BufferPolygon.d.vue.ts

@@ -0,0 +1,21 @@
+import type { Feature, Polygon } from 'geojson';
+/** 多边形缓冲区：向外扩展（或负值收缩）width 米。 */
+type __VLS_Props = {
+    /** 面要素、几何或外环坐标数组 */
+    polygon: Feature<Polygon> | Polygon | [number, number][];
+    /** 缓冲宽度（米），负值向内收缩 */
+    width: number;
+    /** 图层 id 前缀；省略时自动生成 */
+    layerId?: string;
+    /** 主色（快捷样式） */
+    color?: string;
+    /** 整体覆盖填充 paint */
+    fillPaint?: Record<string, unknown>;
+    /** 整体覆盖描边 paint */
+    linePaint?: Record<string, unknown>;
+    /** 插入到该图层之前 */
+    beforeId?: string;
+};
+declare const __VLS_export: 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 _default: typeof __VLS_export;
+export default _default;

package/dist/runtime/components/buffers/BufferPolygon.vue

@@ -0,0 +1,40 @@
+<script setup>
+import { computed, useId } from "vue";
+import { buffer } from "@turf/buffer";
+import { bufferPaints } from "../../utils/buffer";
+import MaplibreSource from "../Source.vue";
+import MaplibreLayer from "../Layer.vue";
+const props = defineProps({
+  polygon: { type: [Object, Array], required: true },
+  width: { type: Number, required: true },
+  layerId: { type: String, required: false },
+  color: { type: String, required: false },
+  fillPaint: { type: Object, required: false },
+  linePaint: { type: Object, required: false },
+  beforeId: { type: String, required: false }
+});
+const id = props.layerId ?? `movk-buffer-polygon-${useId()}`;
+function toFeature(polygon) {
+  if (Array.isArray(polygon)) {
+    return { type: "Feature", properties: {}, geometry: { type: "Polygon", coordinates: [polygon] } };
+  }
+  if (polygon.type === "Polygon") {
+    return { type: "Feature", properties: {}, geometry: polygon };
+  }
+  return polygon;
+}
+const EMPTY = { type: "FeatureCollection", features: [] };
+const source = computed(() => ({
+  type: "geojson",
+  // 负宽度收缩塌缩为空时 buffer 返回 undefined，回退空集合
+  data: buffer(toFeature(props.polygon), props.width, { units: "meters" }) ?? EMPTY
+}));
+const paints = computed(() => bufferPaints({ color: props.color }));
+</script>
+
+<template>
+  <MaplibreSource :source-id="id" :source="source">
+    <MaplibreLayer :layer-id="`${id}-fill`" type="fill" :source="id" :paint="fillPaint ?? paints.fill" :before-id="beforeId" />
+    <MaplibreLayer :layer-id="`${id}-line`" type="line" :source="id" :paint="linePaint ?? paints.line" :before-id="beforeId" />
+  </MaplibreSource>
+</template>

package/dist/runtime/components/buffers/BufferPolygon.vue.d.ts

@@ -0,0 +1,21 @@
+import type { Feature, Polygon } from 'geojson';
+/** 多边形缓冲区：向外扩展（或负值收缩）width 米。 */
+type __VLS_Props = {
+    /** 面要素、几何或外环坐标数组 */
+    polygon: Feature<Polygon> | Polygon | [number, number][];
+    /** 缓冲宽度（米），负值向内收缩 */
+    width: number;
+    /** 图层 id 前缀；省略时自动生成 */
+    layerId?: string;
+    /** 主色（快捷样式） */
+    color?: string;
+    /** 整体覆盖填充 paint */
+    fillPaint?: Record<string, unknown>;
+    /** 整体覆盖描边 paint */
+    linePaint?: Record<string, unknown>;
+    /** 插入到该图层之前 */
+    beforeId?: string;
+};
+declare const __VLS_export: 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 _default: typeof __VLS_export;
+export default _default;

package/dist/runtime/components/buffers/BufferSector.d.vue.ts

@@ -0,0 +1,31 @@
+/** 扇形缓冲区：bearing1 → bearing2（度，正北顺时针），半径单位米。 */
+type __VLS_Props = {
+    /** 圆心经纬度 */
+    center: [number, number];
+    /** 半径（米） */
+    radius: number;
+    /** 起始方位角（度） */
+    bearing1: number;
+    /** 结束方位角（度） */
+    bearing2: number;
+    /**
+     * 弧线采样段数
+     * @defaultValue 64
+     */
+    steps?: number;
+    /** 图层 id 前缀；省略时自动生成 */
+    layerId?: string;
+    /** 主色（快捷样式） */
+    color?: string;
+    /** 整体覆盖填充 paint */
+    fillPaint?: Record<string, unknown>;
+    /** 整体覆盖描边 paint */
+    linePaint?: Record<string, unknown>;
+    /** 插入到该图层之前 */
+    beforeId?: string;
+};
+declare const __VLS_export: import("vue").DefineComponent<__VLS_Props, {}, {}, {}, {}, import("vue").ComponentOptionsMixin, import("vue").ComponentOptionsMixin, {}, string, import("vue").PublicProps, Readonly<__VLS_Props> & Readonly<{}>, {
+    steps: number;
+}, {}, {}, {}, string, import("vue").ComponentProvideOptions, false, {}, any>;
+declare const _default: typeof __VLS_export;
+export default _default;

package/dist/runtime/components/buffers/BufferSector.vue

@@ -0,0 +1,35 @@
+<script setup>
+import { computed, useId } from "vue";
+import { sector } from "@turf/sector";
+import { bufferPaints } from "../../utils/buffer";
+import MaplibreSource from "../Source.vue";
+import MaplibreLayer from "../Layer.vue";
+const props = defineProps({
+  center: { type: Array, required: true },
+  radius: { type: Number, required: true },
+  bearing1: { type: Number, required: true },
+  bearing2: { type: Number, required: true },
+  steps: { type: Number, required: false, default: 64 },
+  layerId: { type: String, required: false },
+  color: { type: String, required: false },
+  fillPaint: { type: Object, required: false },
+  linePaint: { type: Object, required: false },
+  beforeId: { type: String, required: false }
+});
+const id = props.layerId ?? `movk-buffer-sector-${useId()}`;
+const source = computed(() => ({
+  type: "geojson",
+  data: sector(props.center, props.radius, props.bearing1, props.bearing2, {
+    steps: props.steps,
+    units: "meters"
+  })
+}));
+const paints = computed(() => bufferPaints({ color: props.color }));
+</script>
+
+<template>
+  <MaplibreSource :source-id="id" :source="source">
+    <MaplibreLayer :layer-id="`${id}-fill`" type="fill" :source="id" :paint="fillPaint ?? paints.fill" :before-id="beforeId" />
+    <MaplibreLayer :layer-id="`${id}-line`" type="line" :source="id" :paint="linePaint ?? paints.line" :before-id="beforeId" />
+  </MaplibreSource>
+</template>

package/dist/runtime/components/buffers/BufferSector.vue.d.ts

@@ -0,0 +1,31 @@
+/** 扇形缓冲区：bearing1 → bearing2（度，正北顺时针），半径单位米。 */
+type __VLS_Props = {
+    /** 圆心经纬度 */
+    center: [number, number];
+    /** 半径（米） */
+    radius: number;
+    /** 起始方位角（度） */
+    bearing1: number;
+    /** 结束方位角（度） */
+    bearing2: number;
+    /**
+     * 弧线采样段数
+     * @defaultValue 64
+     */
+    steps?: number;
+    /** 图层 id 前缀；省略时自动生成 */
+    layerId?: string;
+    /** 主色（快捷样式） */
+    color?: string;
+    /** 整体覆盖填充 paint */
+    fillPaint?: Record<string, unknown>;
+    /** 整体覆盖描边 paint */
+    linePaint?: Record<string, unknown>;
+    /** 插入到该图层之前 */
+    beforeId?: string;
+};
+declare const __VLS_export: import("vue").DefineComponent<__VLS_Props, {}, {}, {}, {}, import("vue").ComponentOptionsMixin, import("vue").ComponentOptionsMixin, {}, string, import("vue").PublicProps, Readonly<__VLS_Props> & Readonly<{}>, {
+    steps: number;
+}, {}, {}, {}, string, import("vue").ComponentProvideOptions, false, {}, any>;
+declare const _default: typeof __VLS_export;
+export default _default;

package/dist/runtime/components/controls/AttributionControl.d.vue.ts

@@ -0,0 +1,24 @@
+import { AttributionControl } from 'maplibre-gl';
+import type { ControlPosition } from 'maplibre-gl';
+type __VLS_Props = {
+    /** 控件停靠位置；省略用地图默认位置 */
+    position?: ControlPosition;
+    /**
+     * AttributionControl 构造选项
+     * @see https://maplibre.org/maplibre-gl-js/docs/API/type-aliases/AttributionControlOptions/
+     */
+    options?: ConstructorParameters<typeof AttributionControl>[0];
+};
+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/controls/AttributionControl.vue

@@ -0,0 +1,18 @@
+<script setup>
+import { omitUndefined } from "@movk/core";
+import { AttributionControl } from "maplibre-gl";
+import { useControl } from "../../domains/map/control";
+const props = defineProps({
+  position: { type: String, required: false },
+  options: { type: null, required: false }
+});
+useControl(
+  () => new AttributionControl(omitUndefined(props.options ?? {})),
+  () => props.position,
+  () => props.options
+);
+</script>
+
+<template>
+  <slot />
+</template>