@movk/maplibre 1.0.0

package/dist/runtime/plugins/config.d.ts

@@ -0,0 +1,2 @@
+declare const _default: any;
+export default _default;

package/dist/runtime/plugins/config.js

@@ -0,0 +1,6 @@
+import { defineNuxtPlugin, useRuntimeConfig } from "#app";
+import { setMaplibreConfig } from "../domains/map/config.js";
+export default defineNuxtPlugin(() => {
+  const config = useRuntimeConfig().public.maplibre;
+  if (config) setMaplibreConfig(config);
+});

package/dist/runtime/types/draw.d.ts

@@ -0,0 +1,30 @@
+import type { Ref } from 'vue';
+import type { TerraDraw, TerraDrawExtend } from 'terra-draw';
+import type { Feature, FeatureCollection, Geometry } from 'geojson';
+type FeatureId = TerraDrawExtend.FeatureId;
+/**
+ * 由 MaplibreDrawControl 下发的绘制上下文。
+ * 子树内经 useMaplibreDraw() 注入，子树外经 useMaplibreDraw({ mapId }) 查注册表。
+ * 写操作等待实例就绪后执行，并同步控件的 v-model:features / v-model:mode。
+ */
+export interface MaplibreDrawContext {
+    /** 所属地图 id */
+    mapId: string;
+    /** terra-draw 实例引用；控件挂载且地图 load 后才有值 */
+    draw: Readonly<Ref<TerraDraw | undefined>>;
+    /** 实例就绪时 resolve；跨树调用且该 mapId 未注册控件时 reject */
+    whenReady: () => Promise<TerraDraw>;
+    /** 切换绘制模式（如 'select'、'polygon'） */
+    changeMode: (mode: string) => Promise<void>;
+    /** 添加要素；缺失 id 时自动生成，缺失 properties.mode 时按几何类型推断。返回成功添加的要素 id */
+    add: (geojson: Feature | FeatureCollection | Geometry) => Promise<FeatureId[]>;
+    /** 清空全部要素 */
+    deleteAll: () => Promise<void>;
+    /** 设置要素属性（如 color 覆盖主题色） */
+    setFeatureProperty: (featureId: FeatureId, property: string, value: unknown) => Promise<void>;
+    /** 已完成的要素集合（不含绘制中的要素与辅助点）；未就绪时为 undefined */
+    getAll: () => FeatureCollection | undefined;
+    /** 当前绘制模式；未就绪时为 undefined */
+    getMode: () => string | undefined;
+}
+export {};

package/dist/runtime/types/index.d.ts

@@ -0,0 +1,3 @@
+export type * from './draw';
+export type * from './map';
+export type * from './tianditu';

package/dist/runtime/types/map.d.ts

@@ -0,0 +1,45 @@
+import type { Ref, ShallowRef } from 'vue';
+import type { Map as MaplibreMap, MapOptions } from 'maplibre-gl';
+/** 运行时全局配置；Nuxt 模式由插件注入，Vue 模式由 vue-plugin 注入 */
+export interface MaplibreRuntimeConfig {
+    /** 天地图服务 token（tk），用于天地图底图与地理编码 */
+    tk?: string;
+    /** 字体 pbf 地址模板（含 {fontstack} 与 {range}），用于 MaplibreMap 缺省的空白样式；未配置时空白样式不支持文字标注 */
+    glyphs?: string;
+    /** 库内置文字图层（聚合计数、量算标签）使用的字体栈，需存在于当前样式的 glyphs 服务；未配置时使用 MapLibre 默认字体 */
+    textFont?: string[];
+    /** maplibre-gl worker 脚本地址；经打包工具（Vite 等）使用时必需，Nuxt 模块已自动注入 */
+    workerUrl?: string;
+    /** Web Worker 数量 */
+    workerCount?: number;
+    /** 是否预热 GL 资源 */
+    prewarm?: boolean;
+    /** RTL 文本插件；true 使用默认 CDN，或自定义地址与懒加载 */
+    RTLTextPlugin?: boolean | {
+        pluginURL?: string;
+        lazy?: boolean;
+    };
+}
+/** MaplibreMap 组件 options：剔除 container（由组件内部接管） */
+export type MaplibreMapOptions = Omit<MapOptions, 'container'>;
+/** 弹窗触发时机；'none' 表示不绑定自动触发，由外部受控 */
+export type PopupTrigger = 'click' | 'hover' | 'none';
+/**
+ * 由 MaplibreMap 向子组件下发的地图上下文。
+ * 子组件经 useMap() 注入，直接访问实例与就绪状态，无需 id 查表。
+ */
+export interface MaplibreContext {
+    /** 地图 id（未显式指定时为内部生成的唯一值） */
+    id: string;
+    /** 地图实例引用；SSR 与挂载前为 undefined */
+    map: ShallowRef<MaplibreMap | undefined>;
+    /** 样式是否已加载完成 */
+    isLoaded: Ref<boolean>;
+    /** 样式首次加载完成时 resolve */
+    whenLoaded: () => Promise<MaplibreMap>;
+    /**
+     * 样式就绪即执行回调，且每次 setStyle 重新加载后重跑（用于重建 source/layer）。
+     * 返回取消订阅函数。
+     */
+    onReady: (callback: (map: MaplibreMap) => void) => () => void;
+}

package/dist/runtime/types/tianditu.d.ts

@@ -0,0 +1,247 @@
+import type { LineString, MultiPolygon } from 'geojson';
+/** 经纬度包围盒 [minx, miny, maxx, maxy]，WGS84。 */
+export type Bounds = [number, number, number, number];
+/** 地名搜索返回的 POI 点；天地图坐标系 CGCS2000 与 WGS84 兼容，坐标原样透传。 */
+export interface Poi {
+    name: string;
+    address?: string;
+    phone?: string;
+    /** WGS84 经纬度 [lng, lat] */
+    location: [number, number];
+    /** POI 类型：101 POI 数据、102 公交站点 */
+    poiType?: number;
+    hotPointID?: string;
+    province?: string;
+    city?: string;
+    county?: string;
+    typeCode?: string;
+    typeName?: string;
+    source?: string;
+    /** 距中心点距离（仅周边搜索返回，原样字符串，1km 以下为米、以上为千米） */
+    distance?: string;
+}
+/** 统计搜索结果（resultType=2）。 */
+export interface Statistics {
+    /** 命中 POI 总数 */
+    count: number;
+    /** 涉及行政区数量 */
+    adminCount: number;
+    /** 推荐行政区，坐标为 WGS84（天地图 CGCS2000 兼容坐标原样透传） */
+    priorityCities: {
+        name: string;
+        count: number;
+        adminCode: string;
+        location: [number, number];
+    }[];
+}
+/** 行政区搜索结果（resultType=3）。 */
+export interface Area {
+    name: string;
+    adminCode: string;
+    /** 显示级别 1-18 */
+    level: number;
+    /** 中心点 WGS84 [lng, lat] */
+    location: [number, number];
+    /** 定位范围 [minx, miny, maxx, maxy]，WGS84 */
+    bound?: Bounds;
+}
+/** 建议词结果（resultType=4）。 */
+export interface Suggestion {
+    /** 提示类型：1 是否在 X 搜 Y、2 在 X 无结果、3 多个可跳转行政区、4 城市 */
+    type: number;
+    keyword: string;
+    admins: {
+        adminName: string;
+        adminCode: string;
+    }[];
+}
+/** 线路结果（resultType=5）。 */
+export interface LineResult {
+    name: string;
+    uuid: string;
+    stationNum?: string;
+}
+/** 单个查询分类的检索结果（category 传多个 dataTypes 时按分类名分组）。 */
+export interface CategoryResult {
+    /** 查询分类名（来自 dataTypes 中的某一项，天地图按此分组返回） */
+    name: string;
+    /** 该分类命中 POI 总数 */
+    count: number;
+    pois: Poi[];
+}
+/**
+ * 地名搜索归一化结果，按 kind 判别对应 resultType；无数据为 empty。
+ * category 传多个 dataTypes 时天地图按分类名分组返回，对应 kind: 'categories'。
+ */
+export type SearchResult = {
+    kind: 'poi';
+    count: number;
+    pois: Poi[];
+    suggestedDistrict?: SuggestedDistrict;
+} | {
+    kind: 'categories';
+    categories: CategoryResult[];
+} | {
+    kind: 'statistics';
+    statistics: Statistics;
+} | {
+    kind: 'area';
+    area: Area;
+} | {
+    kind: 'suggestion';
+    suggestion: Suggestion;
+} | {
+    kind: 'line';
+    lines: LineResult[];
+} | {
+    kind: 'empty';
+};
+/** 天地图从关键词里识别出的行政区建议（伴随 POI 结果返回，可用于收窄二次检索范围）。 */
+export interface SuggestedDistrict {
+    name: string;
+    code: string;
+}
+/** 地名搜索公共分页/过滤参数。 */
+interface SearchCommon {
+    /**
+     * 返回结果起始位（分页）
+     * @defaultValue 0
+     */
+    start?: number;
+    /**
+     * 返回条数 1-300
+     * @defaultValue 10
+     */
+    count?: number;
+    /** POI 分类（分类名或编码，多个用英文逗号分隔） */
+    dataTypes?: string;
+    /** 返回信息类别：1 基本、2 详细 */
+    show?: 1 | 2;
+}
+/**
+ * 地名搜索参数，按 type 判别对应天地图 queryType：
+ * normal(1) / inView(2) / nearby(3) / polygon(10) / district(12) / category(13) / statistics(14)。
+ * 所有坐标入参均为 WGS84。
+ */
+export type SearchParams = ({
+    type: 'normal';
+    keyword: string;
+    bounds: Bounds;
+    level: number;
+    specify?: string;
+} & SearchCommon) | ({
+    type: 'inView';
+    keyword: string;
+    bounds: Bounds;
+    level: number;
+} & SearchCommon) | ({
+    type: 'nearby';
+    keyword: string;
+    center: [number, number];
+    radius: number;
+} & SearchCommon) | ({
+    type: 'polygon';
+    keyword: string;
+    polygon: [number, number][];
+} & SearchCommon) | ({
+    type: 'district';
+    specify: string;
+    keyword?: string;
+} & SearchCommon) | ({
+    type: 'category';
+    specify: string;
+    bounds: Bounds;
+    dataTypes: string;
+} & SearchCommon) | ({
+    type: 'statistics';
+    specify: string;
+    keyword?: string;
+} & SearchCommon);
+/** 正地理编码（地址→坐标）结果；天地图坐标系 CGCS2000 与 WGS84 兼容，坐标原样透传。 */
+export interface GeocodePoint {
+    /** WGS84 经纬度 [lng, lat] */
+    location: [number, number];
+    /** 匹配级别，如「门址」 */
+    level?: string;
+    /** 匹配得分 0-100 */
+    score?: number;
+}
+/** 逆地理编码（坐标→地址）结果。 */
+export interface ReverseGeocodeResult {
+    formattedAddress: string;
+    province?: string;
+    city?: string;
+    county?: string;
+    road?: string;
+    poi?: string;
+}
+/** 地名精确定位（locate）选项。 */
+export interface LocateOptions {
+    /**
+     * 自定义检索范围（WGS84 [minx, miny, maxx, maxy]）；已知大致范围时传入可提升排序精度
+     * @defaultValue 全国范围
+     */
+    bounds?: Bounds;
+    /**
+     * 查询级别 1-18
+     * @defaultValue 10
+     */
+    level?: number;
+    count?: number;
+}
+/** 下级行政区（无边界轮廓）。 */
+export interface AdministrativeChild {
+    name: string;
+    code: string;
+    /** 行政区划级别：国家 5、省 4、市 3、区县 2 */
+    level: number;
+    /** 中心点 WGS84 [lng, lat] */
+    center: [number, number];
+}
+/** 行政区划查询结果。 */
+export interface AdministrativeDivision extends AdministrativeChild {
+    /** 行政区边界；仅在 boundary 且天地图返回轮廓时存在，坐标为 WGS84（原样透传） */
+    boundary?: MultiPolygon;
+    children?: AdministrativeChild[];
+}
+/** 行政区划查询选项。 */
+export interface AdministrativeOptions {
+    /**
+     * 下级行政区级数：0 不返回、1 下一级、2 下两级、3 下三级
+     * @defaultValue 0
+     */
+    childLevel?: 0 | 1 | 2 | 3;
+    /**
+     * 是否返回边界轮廓
+     * @defaultValue true
+     */
+    boundary?: boolean;
+}
+/** 驾车/步行路线模式，映射天地图 style：最快 0、最短 1、避开高速 2、步行 3。 */
+export type RouteMode = 'fastest' | 'shortest' | 'avoid-highway' | 'walking';
+/** 路线规划选项。 */
+export interface RouteOptions {
+    /**
+     * 路线模式
+     * @defaultValue 'fastest'
+     */
+    mode?: RouteMode;
+    /** 途经点（WGS84），按顺序途经 */
+    waypoints?: [number, number][];
+}
+/** 路线规划结果。 */
+export interface RouteResult {
+    /** 总距离（公里） */
+    distanceKm: number;
+    /** 总时长（分钟） */
+    durationMinutes: number;
+    /** 整条路线折线（WGS84） */
+    path: LineString;
+    /** 逐段转向文字摘要 */
+    summary?: string;
+    /** 适宜展示整条路线的中心点（WGS84） */
+    center?: [number, number];
+    /** 适宜缩放级别 */
+    scale?: number;
+}
+export {};

package/dist/runtime/utils/animated-image.d.ts

@@ -0,0 +1,13 @@
+export interface DecodedAnimation {
+    /** 逐帧 ImageData(均缩放到 size×size) */
+    frames: ImageData[];
+    /** 每帧时长 ms,与 frames 一一对应 */
+    durations: number[];
+    /** 纹理边长 */
+    size: number;
+}
+/**
+ * 用浏览器原生 ImageDecoder(WebCodecs)逐帧解码动图(GIF/APNG/WebP/AVIF)为 ImageData。
+ * 帧统一缩放到 size×size。无 ImageDecoder/canvas 环境(旧浏览器/SSR/测试)返回空,由组件降级。
+ */
+export declare function decodeAnimatedImage(url: string, size: number): Promise<DecodedAnimation>;

package/dist/runtime/utils/animated-image.js

@@ -0,0 +1,47 @@
+const EMPTY = { frames: [], durations: [], size: 0 };
+function inferType(url) {
+  const ext = url.split("?")[0].split(".").pop()?.toLowerCase();
+  switch (ext) {
+    case "gif":
+      return "image/gif";
+    case "apng":
+    case "png":
+      return "image/png";
+    case "webp":
+      return "image/webp";
+    case "avif":
+      return "image/avif";
+    default:
+      return "image/png";
+  }
+}
+export async function decodeAnimatedImage(url, size) {
+  if (typeof ImageDecoder === "undefined" || typeof document === "undefined") return EMPTY;
+  try {
+    const res = await fetch(url);
+    const data = await res.arrayBuffer();
+    const type = res.headers.get("content-type") || inferType(url);
+    const decoder = new ImageDecoder({ data, type });
+    await decoder.tracks.ready;
+    const frameCount = decoder.tracks.selectedTrack?.frameCount ?? 1;
+    const canvas = document.createElement("canvas");
+    canvas.width = size;
+    canvas.height = size;
+    const context = canvas.getContext("2d", { willReadFrequently: true });
+    if (!context) return EMPTY;
+    const frames = [];
+    const durations = [];
+    for (let i = 0; i < frameCount; i++) {
+      const { image } = await decoder.decode({ frameIndex: i });
+      context.clearRect(0, 0, size, size);
+      context.drawImage(image, 0, 0, size, size);
+      frames.push(context.getImageData(0, 0, size, size));
+      durations.push((image.duration ?? 0) / 1e3);
+      image.close();
+    }
+    decoder.close();
+    return { frames, durations, size };
+  } catch {
+    return EMPTY;
+  }
+}

package/dist/runtime/utils/buffer.d.ts

@@ -0,0 +1,24 @@
+type PropBag = Record<string, unknown>;
+export interface BufferPaintOptions {
+    /**
+     * 主色
+     * @defaultValue '#3b82f6'
+     */
+    color?: string;
+    /**
+     * 填充不透明度
+     * @defaultValue 0.25
+     */
+    fillOpacity?: number;
+    /**
+     * 描边宽度
+     * @defaultValue 2
+     */
+    lineWidth?: number;
+}
+/** 缓冲区默认 fill/line paint；组件可经 fillPaint/linePaint 整体覆盖。 */
+export declare function bufferPaints(options?: BufferPaintOptions): {
+    fill: PropBag;
+    line: PropBag;
+};
+export {};

package/dist/runtime/utils/buffer.js

@@ -0,0 +1,13 @@
+export function bufferPaints(options = {}) {
+  const color = options.color ?? "#3b82f6";
+  return {
+    fill: {
+      "fill-color": color,
+      "fill-opacity": options.fillOpacity ?? 0.25
+    },
+    line: {
+      "line-color": color,
+      "line-width": options.lineWidth ?? 2
+    }
+  };
+}

package/dist/runtime/utils/building-effects.d.ts

@@ -0,0 +1,73 @@
+type PropBag = Record<string, unknown>;
+export interface BuildingGradientOptions {
+    /** 高度-颜色断点；缺省为低矮到高耸的蓝紫渐变 */
+    stops?: [number, string][];
+    /**
+     * 整体透明度
+     * @defaultValue 0.85
+     */
+    opacity?: number;
+    /**
+     * 显示建筑的最小缩放级别
+     * @defaultValue 15
+     */
+    minzoom?: number;
+    /**
+     * 建筑高度属性名
+     * @defaultValue 'render_height'
+     */
+    heightProperty?: string;
+    /**
+     * 建筑底面高度属性名
+     * @defaultValue 'render_min_height'
+     */
+    baseProperty?: string;
+}
+/**
+ * 按建筑高度插值着色的 fill-extrusion paint。
+ * 复用 building.ts 的 minzoom 高度起伏约定,避免建筑瞬间弹出。
+ */
+export declare function buildingGradientPaint(options?: BuildingGradientOptions): PropBag;
+export interface WindowTextureOptions {
+    /**
+     * 贴图边长（像素）
+     * @defaultValue 128
+     */
+    size?: number;
+    /**
+     * 窗户行数
+     * @defaultValue 8
+     */
+    rows?: number;
+    /**
+     * 窗户列数
+     * @defaultValue 6
+     */
+    cols?: number;
+    /**
+     * 亮窗颜色
+     * @defaultValue '#fde68a'
+     */
+    litColor?: string;
+    /**
+     * 暗窗/墙体颜色
+     * @defaultValue '#1f2937'
+     */
+    darkColor?: string;
+    /**
+     * 亮窗比例 0-1
+     * @defaultValue 0.45
+     */
+    litRatio?: number;
+    /**
+     * 随机种子（决定亮窗分布，保证可复现）
+     * @defaultValue 1
+     */
+    seed?: number;
+}
+/**
+ * 程序生成窗户点阵贴图,用于 fill-extrusion-pattern。
+ * LCG 伪随机由 seed 决定亮窗分布,保证可测;无 canvas 环境返回 undefined。
+ */
+export declare function windowTextureImage(options?: WindowTextureOptions): ImageData | undefined;
+export {};

package/dist/runtime/utils/building-effects.js

@@ -0,0 +1,50 @@
+import { buildingExtrusionPaint, DEFAULT_HEIGHT_PROPERTY } from "./building.js";
+const DEFAULT_STOPS = [
+  [0, "#1e3a8a"],
+  [50, "#3b82f6"],
+  [150, "#22d3ee"],
+  [300, "#a78bfa"]
+];
+export function buildingGradientPaint(options = {}) {
+  const stops = options.stops ?? DEFAULT_STOPS;
+  const heightProperty = options.heightProperty ?? DEFAULT_HEIGHT_PROPERTY;
+  const colorExpr = ["interpolate", ["linear"], ["get", heightProperty]];
+  for (const [height, color] of stops) colorExpr.push(height, color);
+  return {
+    "fill-extrusion-color": colorExpr,
+    ...buildingExtrusionPaint({ minzoom: options.minzoom, heightProperty, baseProperty: options.baseProperty }),
+    "fill-extrusion-opacity": options.opacity ?? 0.85
+  };
+}
+export function windowTextureImage(options = {}) {
+  if (typeof document === "undefined") return void 0;
+  const size = options.size ?? 128;
+  const rows = options.rows ?? 8;
+  const cols = options.cols ?? 6;
+  const litColor = options.litColor ?? "#fde68a";
+  const darkColor = options.darkColor ?? "#1f2937";
+  const litRatio = options.litRatio ?? 0.45;
+  const canvas = document.createElement("canvas");
+  canvas.width = size;
+  canvas.height = size;
+  const context = canvas.getContext("2d", { willReadFrequently: true });
+  if (!context) return void 0;
+  context.fillStyle = darkColor;
+  context.fillRect(0, 0, size, size);
+  let seed = (options.seed ?? 1) >>> 0;
+  const rand = () => {
+    seed = seed * 1664525 + 1013904223 >>> 0;
+    return seed / 4294967295;
+  };
+  const cellW = size / cols;
+  const cellH = size / rows;
+  const padX = cellW * 0.2;
+  const padY = cellH * 0.2;
+  for (let r = 0; r < rows; r++) {
+    for (let c = 0; c < cols; c++) {
+      context.fillStyle = rand() < litRatio ? litColor : darkColor;
+      context.fillRect(c * cellW + padX, r * cellH + padY, cellW - padX * 2, cellH - padY * 2);
+    }
+  }
+  return context.getImageData(0, 0, size, size);
+}

package/dist/runtime/utils/building.d.ts

@@ -0,0 +1,53 @@
+import type { FillExtrusionLayerSpecification } from '@maplibre/maplibre-gl-style-spec';
+type PropBag = Record<string, unknown>;
+/** 建筑数据来源：矢量瓦片或 GeoJSON 中带高度属性的面要素 */
+export interface BuildingSourceOptions {
+    /** 数据源 id（需已由 MaplibreSource 或样式声明） */
+    source: string;
+    /** 矢量瓦片中的图层名（如 OpenMapTiles 的 'building'）；GeoJSON 源省略 */
+    sourceLayer?: string;
+    /**
+     * 建筑高度属性名
+     * @defaultValue 'render_height'
+     */
+    heightProperty?: string;
+    /**
+     * 建筑底面高度属性名
+     * @defaultValue 'render_min_height'
+     */
+    baseProperty?: string;
+}
+export interface BuildingLayerOptions extends BuildingSourceOptions {
+    /** 图层 id */
+    id: string;
+    /**
+     * 建筑颜色
+     * @defaultValue '#aaa'
+     */
+    color?: string;
+    /**
+     * 整体透明度
+     * @defaultValue 0.8
+     */
+    opacity?: number;
+    /**
+     * 显示建筑的最小缩放级别
+     * @defaultValue 15
+     */
+    minzoom?: number;
+    /** 整体覆盖 paint（提供时忽略 color/opacity 预设） */
+    paint?: PropBag;
+}
+export declare const DEFAULT_HEIGHT_PROPERTY = "render_height";
+export declare const DEFAULT_BASE_PROPERTY = "render_min_height";
+/**
+ * 建筑拉伸的高度与底面 paint：进入 minzoom 后 0.05 级内由 0 插值到真实高度，避免建筑瞬间弹出。
+ */
+export declare function buildingExtrusionPaint(options?: {
+    minzoom?: number;
+    heightProperty?: string;
+    baseProperty?: string;
+}): PropBag;
+/** 生成 3D 建筑 fill-extrusion 图层规格。 */
+export declare function buildingLayerSpec(options: BuildingLayerOptions): FillExtrusionLayerSpecification;
+export {};

package/dist/runtime/utils/building.js

@@ -0,0 +1,26 @@
+export const DEFAULT_HEIGHT_PROPERTY = "render_height";
+export const DEFAULT_BASE_PROPERTY = "render_min_height";
+export function buildingExtrusionPaint(options = {}) {
+  const minzoom = options.minzoom ?? 15;
+  const rise = (property) => ["interpolate", ["linear"], ["zoom"], minzoom, 0, minzoom + 0.05, ["get", property]];
+  return {
+    "fill-extrusion-height": rise(options.heightProperty ?? DEFAULT_HEIGHT_PROPERTY),
+    "fill-extrusion-base": rise(options.baseProperty ?? DEFAULT_BASE_PROPERTY)
+  };
+}
+export function buildingLayerSpec(options) {
+  const minzoom = options.minzoom ?? 15;
+  const defaultPaint = {
+    "fill-extrusion-color": options.color ?? "#aaa",
+    ...buildingExtrusionPaint({ minzoom, heightProperty: options.heightProperty, baseProperty: options.baseProperty }),
+    "fill-extrusion-opacity": options.opacity ?? 0.8
+  };
+  return {
+    id: options.id,
+    type: "fill-extrusion",
+    source: options.source,
+    ...options.sourceLayer ? { "source-layer": options.sourceLayer } : {},
+    minzoom,
+    paint: options.paint ?? defaultPaint
+  };
+}

package/dist/runtime/utils/cluster.d.ts

@@ -0,0 +1,24 @@
+import type { CircleLayerSpecification, SymbolLayerSpecification } from '@maplibre/maplibre-gl-style-spec';
+type PropBag = Record<string, unknown>;
+export interface ClusterLayersOptions {
+    /** 图层 id 前缀，生成 {id}-clusters / {id}-count / {id}-points */
+    id: string;
+    /** 聚合 geojson 数据源 id */
+    sourceId: string;
+    /** 覆盖聚合圆 paint */
+    clusterPaint?: PropBag;
+    /** 覆盖计数文字 layout */
+    countLayout?: PropBag;
+    /** 覆盖计数文字 paint */
+    countPaint?: PropBag;
+    /** 覆盖散点 paint */
+    pointPaint?: PropBag;
+}
+export interface ClusterLayerSpecs {
+    clusters: CircleLayerSpecification;
+    count: SymbolLayerSpecification;
+    points: CircleLayerSpecification;
+}
+/** 生成聚合三层（分级聚合圆 / 数量标注 / 未聚合散点）图层规格。 */
+export declare function clusterLayerSpecs(options: ClusterLayersOptions): ClusterLayerSpecs;
+export {};