@movk/maplibre 1.0.0

package/dist/runtime/utils/cluster.js

@@ -0,0 +1,42 @@
+import { textFontLayout } from "../domains/map/config.js";
+export function clusterLayerSpecs(options) {
+  const { id, sourceId } = options;
+  const clusters = {
+    id: `${id}-clusters`,
+    type: "circle",
+    source: sourceId,
+    filter: ["has", "point_count"],
+    paint: options.clusterPaint ?? {
+      // 按聚合数量分级配色与半径：<100 / <750 / >=750
+      "circle-color": ["step", ["get", "point_count"], "#51bbd6", 100, "#f1f075", 750, "#f28cb1"],
+      "circle-radius": ["step", ["get", "point_count"], 20, 100, 30, 750, 40]
+    }
+  };
+  const count = {
+    id: `${id}-count`,
+    type: "symbol",
+    source: sourceId,
+    filter: ["has", "point_count"],
+    layout: options.countLayout ?? {
+      "text-field": ["get", "point_count_abbreviated"],
+      "text-size": 12,
+      ...textFontLayout()
+    },
+    paint: options.countPaint ?? {
+      "text-color": "#fff"
+    }
+  };
+  const points = {
+    id: `${id}-points`,
+    type: "circle",
+    source: sourceId,
+    filter: ["!", ["has", "point_count"]],
+    paint: options.pointPaint ?? {
+      "circle-color": "#11b4da",
+      "circle-radius": 6,
+      "circle-stroke-width": 1.5,
+      "circle-stroke-color": "#fff"
+    }
+  };
+  return { clusters, count, points };
+}

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

@@ -0,0 +1,12 @@
+/** 常用坐标系标识，对齐 gcoord 的 CRS 常量 */
+export type CRS = 'WGS84' | 'GCJ02' | 'BD09' | 'EPSG3857';
+export interface TransformOptions {
+    /**
+     * 输出坐标保留的小数位数，省略则保留完整精度
+     */
+    precision?: number;
+}
+/** 转换单个经纬度点，返回新坐标。 */
+export declare function transformPoint(point: [number, number], from: CRS, to: CRS, options?: TransformOptions): [number, number];
+/** 转换任意 GeoJSON（点/线/面/集合），返回新对象，不修改入参。 */
+export declare function transformGeoJSON<T>(geojson: T, from: CRS, to: CRS, options?: TransformOptions): T;

package/dist/runtime/utils/coordinate.js

@@ -0,0 +1,44 @@
+import gcoord from "gcoord";
+const CRS_MAP = {
+  WGS84: gcoord.WGS84,
+  GCJ02: gcoord.GCJ02,
+  BD09: gcoord.BD09,
+  EPSG3857: gcoord.EPSG3857
+};
+function roundNum(n, precision) {
+  const factor = 10 ** precision;
+  return Math.round(n * factor) / factor;
+}
+function roundCoords(coords, precision) {
+  if (!Array.isArray(coords)) return;
+  if (typeof coords[0] === "number") {
+    for (let i = 0; i < coords.length; i++) {
+      coords[i] = roundNum(coords[i], precision);
+    }
+    return;
+  }
+  for (const child of coords) roundCoords(child, precision);
+}
+function roundGeoJSON(node, precision) {
+  if (!node || typeof node !== "object") return;
+  const obj = node;
+  if (Array.isArray(obj.features)) {
+    for (const feature of obj.features) roundGeoJSON(feature, precision);
+  }
+  if (obj.geometry) roundGeoJSON(obj.geometry, precision);
+  if (Array.isArray(obj.geometries)) {
+    for (const geometry of obj.geometries) roundGeoJSON(geometry, precision);
+  }
+  if (obj.coordinates) roundCoords(obj.coordinates, precision);
+}
+export function transformPoint(point, from, to, options = {}) {
+  const result = gcoord.transform(point, CRS_MAP[from], CRS_MAP[to]);
+  if (options.precision === void 0) return result;
+  return [roundNum(result[0], options.precision), roundNum(result[1], options.precision)];
+}
+export function transformGeoJSON(geojson, from, to, options = {}) {
+  const input = structuredClone(geojson);
+  const result = gcoord.transform(input, CRS_MAP[from], CRS_MAP[to]);
+  if (options.precision !== void 0) roundGeoJSON(result, options.precision);
+  return result;
+}

package/dist/runtime/utils/draw-theme.d.ts

@@ -0,0 +1,47 @@
+import type { GeoJSONStoreFeatures, HexColor } from 'terra-draw';
+export interface DrawThemeOptions {
+    /**
+     * 非激活态主色
+     * @defaultValue '#3b82f6'
+     */
+    color?: HexColor;
+    /**
+     * 激活态（绘制辅助点/选中）主色
+     * @defaultValue '#f59e0b'
+     */
+    activeColor?: HexColor;
+    /**
+     * 多边形填充不透明度
+     * @defaultValue 0.1
+     */
+    fillOpacity?: number;
+    /**
+     * 线宽
+     * @defaultValue 2
+     */
+    lineWidth?: number;
+    /**
+     * 顶点圆半径
+     * @defaultValue 5
+     */
+    vertexRadius?: number;
+}
+type ColorStyle = (feature: GeoJSONStoreFeatures) => HexColor;
+type ModeStyles = Record<string, number | HexColor | ColorStyle>;
+/** 各模式的 terra-draw styles，键为模式名 */
+export interface DrawThemeStyles {
+    select: Record<string, number | HexColor>;
+    point: ModeStyles;
+    linestring: ModeStyles;
+    polygon: ModeStyles;
+    rectangle: ModeStyles;
+    circle: ModeStyles;
+    ellipse: ModeStyles;
+    sector: ModeStyles;
+}
+/**
+ * 生成 terra-draw 各模式的主题样式。
+ * 要素 `properties.color` 优先于主题色，便于按要素单独着色（配合 setFeatureProperty）。
+ */
+export declare function drawThemeStyles(options?: DrawThemeOptions): DrawThemeStyles;
+export {};

package/dist/runtime/utils/draw-theme.js

@@ -0,0 +1,39 @@
+export function drawThemeStyles(options = {}) {
+  const color = options.color ?? "#3b82f6";
+  const activeColor = options.activeColor ?? "#f59e0b";
+  const fillOpacity = options.fillOpacity ?? 0.1;
+  const lineWidth = options.lineWidth ?? 2;
+  const vertexRadius = options.vertexRadius ?? 5;
+  const themed = (feature) => feature.properties?.color ?? color;
+  const shape = { fillColor: themed, fillOpacity, outlineColor: themed, outlineWidth: lineWidth };
+  const guidance = (prefix) => ({
+    [`${prefix}Color`]: activeColor,
+    [`${prefix}Width`]: vertexRadius,
+    [`${prefix}OutlineColor`]: "#ffffff",
+    [`${prefix}OutlineWidth`]: 2
+  });
+  return {
+    select: {
+      selectedPointColor: activeColor,
+      selectedPointWidth: vertexRadius + 1,
+      selectedLineStringColor: activeColor,
+      selectedLineStringWidth: lineWidth,
+      selectedPolygonColor: activeColor,
+      selectedPolygonFillOpacity: fillOpacity,
+      selectedPolygonOutlineColor: activeColor,
+      selectedPolygonOutlineWidth: lineWidth,
+      ...guidance("selectionPoint"),
+      midPointColor: activeColor,
+      midPointWidth: Math.max(vertexRadius - 2, 1),
+      midPointOutlineColor: "#ffffff",
+      midPointOutlineWidth: 1
+    },
+    point: { pointColor: themed, pointWidth: vertexRadius, pointOutlineColor: "#ffffff", pointOutlineWidth: 2 },
+    linestring: { lineStringColor: themed, lineStringWidth: lineWidth, ...guidance("closingPoint"), ...guidance("coordinatePoint") },
+    polygon: { ...shape, ...guidance("closingPoint"), ...guidance("coordinatePoint") },
+    rectangle: shape,
+    circle: shape,
+    ellipse: shape,
+    sector: shape
+  };
+}

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

@@ -0,0 +1,34 @@
+export type Position2D = [number, number];
+export interface ArcLineOptions {
+    /**
+     * 弧线弯曲程度（相对两点距离的比例）
+     * @defaultValue 0.3
+     */
+    curvature?: number;
+    /**
+     * 采样段数
+     * @defaultValue 64
+     */
+    segments?: number;
+}
+/** 二次贝塞尔弧线：控制点取中点沿垂直方向偏移 curvature × 距离。 */
+export declare function arcLine(from: Position2D, to: Position2D, options?: ArcLineOptions): Position2D[];
+/**
+ * 预计算累计长度的沿线采样器：t ∈ [0,1]（按长度占比）→ 坐标。
+ * 供迁徙粒子/轨迹每帧取位，避免逐帧重算长度表。
+ */
+export declare function createLineSampler(coords: Position2D[]): (t: number) => Position2D;
+/** 第 ring 圈在当前时刻的扩散相位 [0,1)：线性推进 + 按圈序均匀错相。 */
+export declare function ringProgress(ring: number, rings: number, elapsedMs: number, durationMs: number): number;
+/** 扩散圈不透明度包络：两端为 0（保证取模回绕处无缝），中点峰值 1。 */
+export declare function ringFade(progress: number): number;
+/**
+ * 轨迹彗尾的 line-gradient 表达式：head 为头部 line-progress，
+ * 尾部到头部由透明渐变到主色，头部之后立即透明。停靠点保证严格递增。
+ */
+export declare function trailGradient(head: number, trailLength: number, color: string): unknown[];
+/**
+ * 生成雷达扇形扫描贴图（透明到主色的角向渐变）。
+ * 无 canvas 2d 环境（SSR/测试）时返回 undefined。
+ */
+export declare function radarSweepImage(size: number, color: string): ImageData | undefined;

package/dist/runtime/utils/effects.js

@@ -0,0 +1,78 @@
+export function arcLine(from, to, options = {}) {
+  const curvature = options.curvature ?? 0.3;
+  const segments = options.segments ?? 64;
+  const dx = to[0] - from[0];
+  const dy = to[1] - from[1];
+  const mid = [from[0] + dx / 2, from[1] + dy / 2];
+  const control = [mid[0] - dy * curvature, mid[1] + dx * curvature];
+  const coords = [];
+  for (let i = 0; i <= segments; i++) {
+    const t = i / segments;
+    const a = 1 - t;
+    coords.push([
+      a * a * from[0] + 2 * a * t * control[0] + t * t * to[0],
+      a * a * from[1] + 2 * a * t * control[1] + t * t * to[1]
+    ]);
+  }
+  coords[0] = [...from];
+  coords[segments] = [...to];
+  return coords;
+}
+export function createLineSampler(coords) {
+  const cumulative = [0];
+  for (let i = 1; i < coords.length; i++) {
+    const dx = coords[i][0] - coords[i - 1][0];
+    const dy = coords[i][1] - coords[i - 1][1];
+    cumulative.push(cumulative[i - 1] + Math.hypot(dx, dy));
+  }
+  const total = cumulative[cumulative.length - 1];
+  return (t) => {
+    if (t <= 0 || total === 0) return [...coords[0]];
+    if (t >= 1) return [...coords[coords.length - 1]];
+    const target = t * total;
+    let i = 1;
+    while (cumulative[i] < target) i++;
+    const segStart = cumulative[i - 1];
+    const ratio = (target - segStart) / (cumulative[i] - segStart);
+    const a = coords[i - 1];
+    const b = coords[i];
+    return [a[0] + (b[0] - a[0]) * ratio, a[1] + (b[1] - a[1]) * ratio];
+  };
+}
+export function ringProgress(ring, rings, elapsedMs, durationMs) {
+  return (elapsedMs / durationMs + ring / rings) % 1;
+}
+export function ringFade(progress) {
+  return Math.sin(progress * Math.PI);
+}
+export function trailGradient(head, trailLength, color) {
+  const eps = 1e-4;
+  const transparent = "rgba(0, 0, 0, 0)";
+  const h = Math.min(Math.max(head, eps), 1);
+  const tail = Math.max(h - Math.max(trailLength, eps), 0);
+  const expr = ["interpolate", ["linear"], ["line-progress"], tail, transparent, h, color];
+  if (h + eps < 1) expr.push(h + eps, transparent);
+  return expr;
+}
+export function radarSweepImage(size, color) {
+  if (typeof document === "undefined") return void 0;
+  const canvas = document.createElement("canvas");
+  canvas.width = size;
+  canvas.height = size;
+  const context = canvas.getContext("2d", { willReadFrequently: true });
+  if (!context) return void 0;
+  const half = size / 2;
+  const steps = 120;
+  const sweep = Math.PI * 1.5;
+  for (let i = 0; i < steps; i++) {
+    const angle = i / steps * sweep;
+    context.beginPath();
+    context.moveTo(half, half);
+    context.arc(half, half, half, angle, angle + sweep / steps + 0.01);
+    context.closePath();
+    context.globalAlpha = i / steps * 0.85;
+    context.fillStyle = color;
+    context.fill();
+  }
+  return context.getImageData(0, 0, size, size);
+}

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

@@ -0,0 +1,6 @@
+import type { Map as MaplibreMap } from 'maplibre-gl';
+/**
+ * 表驱动地绑定地图事件并转发，返回解绑函数。
+ * 传入 layerId 时绑定到指定图层（用于图层级交互事件）。
+ */
+export declare function bindMapEvents<E extends string>(map: MaplibreMap, events: readonly E[], handler: (type: E, event: unknown) => void, layerId?: string): () => void;

package/dist/runtime/utils/events.js

@@ -0,0 +1,20 @@
+export function bindMapEvents(map, events, handler, layerId) {
+  const bound = events.map((type) => {
+    const listener = (event) => handler(type, event);
+    if (layerId) {
+      map.on(type, layerId, listener);
+    } else {
+      map.on(type, listener);
+    }
+    return { type, listener };
+  });
+  return () => {
+    for (const { type, listener } of bound) {
+      if (layerId) {
+        map.off(type, layerId, listener);
+      } else {
+        map.off(type, listener);
+      }
+    }
+  };
+}

package/dist/runtime/utils/frame-icon.d.ts

@@ -0,0 +1,27 @@
+import type { Map as MaplibreMap, StyleImageInterface } from 'maplibre-gl';
+/**
+ * 按经过时间选当前帧索引。
+ * 有 durations(每帧 ms,长度=total)按累积时长循环选帧;否则按固定 fps。
+ */
+export declare function pickFrameIndex(elapsedMs: number, durations: number[] | undefined, fps: number, total: number): number;
+export interface FrameStyleImageOptions {
+    /** 纹理边长(像素),帧统一缩放到 size×size */
+    size: number;
+    /** 当前帧序列(响应式取值) */
+    frames: () => ImageData[];
+    /** 取地图实例以触发重绘 */
+    getMap: () => MaplibreMap | undefined;
+    /**
+     * 固定帧率；durations 缺省时生效
+     * @defaultValue 12
+     */
+    fps?: number;
+    /** 每帧时长 ms（响应式取值），优先于 fps */
+    durations?: () => number[] | undefined;
+}
+/**
+ * 构造帧动画 StyleImageInterface:maplibre 每帧调 render 取当前帧并自重绘。
+ * 帧未就绪时首次返回 true 以初始透明 data 建立纹理(maplibre 仅在 render 首次返回 true 时建纹理),
+ * 避免 symbol 图层 styleimagemissing。
+ */
+export declare function createFrameStyleImage(options: FrameStyleImageOptions): StyleImageInterface;

package/dist/runtime/utils/frame-icon.js

@@ -0,0 +1,45 @@
+export function pickFrameIndex(elapsedMs, durations, fps, total) {
+  if (total <= 0) return 0;
+  if (durations && durations.length === total) {
+    const cycle = durations.reduce((sum, d) => sum + d, 0);
+    if (cycle <= 0) return 0;
+    let t = elapsedMs % cycle;
+    for (let i = 0; i < total; i++) {
+      if (t < durations[i]) return i;
+      t -= durations[i];
+    }
+    return total - 1;
+  }
+  return Math.floor(elapsedMs / 1e3 * fps) % total;
+}
+export function createFrameStyleImage(options) {
+  const { size, frames, getMap } = options;
+  const fps = options.fps ?? 12;
+  let start = 0;
+  let lastIndex = -1;
+  let committed = false;
+  const image = {
+    width: size,
+    height: size,
+    data: new Uint8Array(size * size * 4),
+    render() {
+      const fs = frames();
+      const total = fs.length;
+      if (!total) {
+        if (committed) return false;
+        committed = true;
+        return true;
+      }
+      const map = getMap();
+      if (map) map.triggerRepaint();
+      committed = true;
+      if (!start) start = performance.now();
+      const index = pickFrameIndex(performance.now() - start, options.durations?.(), fps, total);
+      if (index === lastIndex) return false;
+      lastIndex = index;
+      image.data = fs[index].data;
+      return true;
+    }
+  };
+  return image;
+}

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

@@ -0,0 +1,5 @@
+import type { GeoJSON } from 'geojson';
+/** 西南/东北角包围盒，可直接传给 map.fitBounds */
+export type LngLatBoundsTuple = [[number, number], [number, number]];
+/** 扫描任意 GeoJSON 的全部坐标求包围盒；无坐标时返回 undefined。 */
+export declare function boundsOfGeoJSON(input: GeoJSON): LngLatBoundsTuple | undefined;

package/dist/runtime/utils/geometry.js

@@ -0,0 +1,41 @@
+export function boundsOfGeoJSON(input) {
+  let west = Infinity;
+  let south = Infinity;
+  let east = -Infinity;
+  let north = -Infinity;
+  let found = false;
+  function visitPosition(position) {
+    const [lng, lat] = position;
+    if (typeof lng !== "number" || typeof lat !== "number") return;
+    found = true;
+    if (lng < west) west = lng;
+    if (lng > east) east = lng;
+    if (lat < south) south = lat;
+    if (lat > north) north = lat;
+  }
+  function visitCoordinates(coordinates) {
+    if (coordinates.length === 0) return;
+    if (typeof coordinates[0] === "number") {
+      visitPosition(coordinates);
+      return;
+    }
+    for (const child of coordinates) visitCoordinates(child);
+  }
+  function visitGeometry(geometry) {
+    if (geometry.type === "GeometryCollection") {
+      for (const child of geometry.geometries) visitGeometry(child);
+      return;
+    }
+    visitCoordinates(geometry.coordinates);
+  }
+  if (input.type === "FeatureCollection") {
+    for (const feature of input.features) {
+      if (feature.geometry) visitGeometry(feature.geometry);
+    }
+  } else if (input.type === "Feature") {
+    if (input.geometry) visitGeometry(input.geometry);
+  } else {
+    visitGeometry(input);
+  }
+  return found ? [[west, south], [east, north]] : void 0;
+}

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

@@ -0,0 +1,36 @@
+type PropBag = Record<string, unknown>;
+export interface HeatmapPaintOptions {
+    /**
+     * 权重取值的要素属性
+     * @defaultValue 'temperature'
+     */
+    weightProperty?: string;
+    /**
+     * 权重属性取值范围 [min, max]，线性映射到 0..1 热力权重
+     * @defaultValue `[0, 40]`
+     */
+    weightRange?: [number, number];
+    /** 密度-颜色断点 [密度比 0..1, 颜色][]；缺省为蓝→红五档；density 0 处自动透明 */
+    colorStops?: [number, string][];
+    /**
+     * 热力半径（像素）
+     * @defaultValue 30
+     */
+    radius?: number;
+    /**
+     * 热力强度
+     * @defaultValue 1
+     */
+    intensity?: number;
+    /**
+     * 整体不透明度
+     * @defaultValue 1
+     */
+    opacity?: number;
+}
+/**
+ * 生成 maplibre heatmap 图层 paint:温度属性经 weightRange 线性映射为热力权重,
+ * heatmap-density 经 colorStops 着色(0 处必透明,否则全图铺底色)。
+ */
+export declare function heatmapPaint(options?: HeatmapPaintOptions): PropBag;
+export {};

package/dist/runtime/utils/heatmap.js

@@ -0,0 +1,30 @@
+const DEFAULT_COLOR_STOPS = [
+  [0.2, "#2c7bb6"],
+  [0.4, "#00a6ca"],
+  [0.6, "#7fbc41"],
+  [0.8, "#fdae61"],
+  [1, "#d7191c"]
+];
+export function heatmapPaint(options = {}) {
+  const weightProperty = options.weightProperty ?? "temperature";
+  const [min, max] = options.weightRange ?? [0, 40];
+  const colorStops = options.colorStops ?? DEFAULT_COLOR_STOPS;
+  const weightExpr = [
+    "interpolate",
+    ["linear"],
+    ["get", weightProperty],
+    min,
+    0,
+    max,
+    1
+  ];
+  const colorExpr = ["interpolate", ["linear"], ["heatmap-density"], 0, "rgba(0, 0, 0, 0)"];
+  for (const [stop, color] of colorStops) colorExpr.push(stop, color);
+  return {
+    "heatmap-weight": weightExpr,
+    "heatmap-intensity": options.intensity ?? 1,
+    "heatmap-color": colorExpr,
+    "heatmap-radius": options.radius ?? 30,
+    "heatmap-opacity": options.opacity ?? 1
+  };
+}

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

@@ -0,0 +1,13 @@
+import type { Map as MaplibreMap } from 'maplibre-gl';
+type PropBag = Record<string, unknown>;
+export interface LayerUpdate {
+    id: string;
+    paint?: PropBag;
+    layout?: PropBag;
+    filter?: unknown;
+    minzoom?: number;
+    maxzoom?: number;
+}
+/** 把图层的响应式变更（缩放范围、paint、layout、filter）增量应用到地图。 */
+export declare function applyLayerProps(map: MaplibreMap, next: LayerUpdate, prev?: LayerUpdate): void;
+export {};

package/dist/runtime/utils/layer.js

@@ -0,0 +1,17 @@
+import { equalsBy } from "@movk/core";
+function applyChangedProps(next, prev, apply) {
+  for (const key of Object.keys(next)) {
+    if (!equalsBy(next[key], prev[key])) apply(key, next[key]);
+  }
+}
+export function applyLayerProps(map, next, prev) {
+  const id = next.id;
+  if (next.minzoom !== prev?.minzoom || next.maxzoom !== prev?.maxzoom) {
+    map.setLayerZoomRange(id, next.minzoom ?? 0, next.maxzoom ?? 24);
+  }
+  applyChangedProps(next.paint ?? {}, prev?.paint ?? {}, (key, value) => map.setPaintProperty(id, key, value));
+  applyChangedProps(next.layout ?? {}, prev?.layout ?? {}, (key, value) => map.setLayoutProperty(id, key, value));
+  if (!equalsBy(next.filter, prev?.filter)) {
+    map.setFilter(id, next.filter);
+  }
+}

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

@@ -0,0 +1,2 @@
+/** 运行时日志器，跨 Nuxt 与纯 Vue 可用；统一携带 @movk/maplibre 标签 */
+export declare const logger: import("consola").ConsolaInstance;

package/dist/runtime/utils/logger.js

@@ -0,0 +1,2 @@
+import { consola } from "consola";
+export const logger = consola.withTag("@movk/maplibre");

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

@@ -0,0 +1,4 @@
+/** 距离格式化：千米以下取整米，以上保留两位 km。 */
+export declare function formatDistance(meters: number): string;
+/** 面积格式化：平方千米以下取整平方米，以上保留两位 km²。 */
+export declare function formatArea(squareMeters: number): string;

package/dist/runtime/utils/measure.js

@@ -0,0 +1,8 @@
+export function formatDistance(meters) {
+  if (meters < 1e3) return `${Math.round(meters)} m`;
+  return `${(meters / 1e3).toFixed(2)} km`;
+}
+export function formatArea(squareMeters) {
+  if (squareMeters < 1e6) return `${Math.round(squareMeters)} m\xB2`;
+  return `${(squareMeters / 1e6).toFixed(2)} km\xB2`;
+}

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

@@ -0,0 +1,31 @@
+export interface SpriteGrid {
+    /** 雪碧图列数 */
+    columns: number;
+    /**
+     * 雪碧图行数
+     * @defaultValue 1
+     */
+    rows?: number;
+    /** 单帧宽（像素） */
+    frameWidth: number;
+    /** 单帧高（像素） */
+    frameHeight: number;
+    /** 总帧数；缺省为 columns * rows */
+    frames?: number;
+}
+export interface FrameRect {
+    x: number;
+    y: number;
+    w: number;
+    h: number;
+}
+/**
+ * 计算雪碧图中第 index 帧的裁剪矩形(行优先排布)。
+ * index 越界按总帧数回绕,支持负数。
+ */
+export declare function spriteFrameRect(index: number, grid: SpriteGrid): FrameRect;
+/**
+ * 从已加载的雪碧图裁剪一帧到 size×size 画布,返回 ImageData。
+ * 无 canvas 2d 环境(SSR/测试)返回 undefined。
+ */
+export declare function spriteFrame(source: CanvasImageSource, rect: FrameRect, size: number): ImageData | undefined;

package/dist/runtime/utils/sprite.js

@@ -0,0 +1,23 @@
+export function spriteFrameRect(index, grid) {
+  const rows = grid.rows ?? 1;
+  const total = grid.frames ?? grid.columns * rows;
+  const i = (index % total + total) % total;
+  const col = i % grid.columns;
+  const row = Math.floor(i / grid.columns);
+  return {
+    x: col * grid.frameWidth,
+    y: row * grid.frameHeight,
+    w: grid.frameWidth,
+    h: grid.frameHeight
+  };
+}
+export function spriteFrame(source, rect, size) {
+  if (typeof document === "undefined") return void 0;
+  const canvas = document.createElement("canvas");
+  canvas.width = size;
+  canvas.height = size;
+  const context = canvas.getContext("2d", { willReadFrequently: true });
+  if (!context) return void 0;
+  context.drawImage(source, rect.x, rect.y, rect.w, rect.h, 0, 0, size, size);
+  return context.getImageData(0, 0, size, size);
+}

package/dist/runtime/utils/tianditu-administrative.d.ts

@@ -0,0 +1,3 @@
+import type { AdministrativeDivision, AdministrativeOptions } from '../types';
+/** 行政区划查询：按名称（或国标码）查中心点、边界轮廓、下级行政区。 */
+export declare function administrative(keyword: string, options: AdministrativeOptions, tk: string): Promise<AdministrativeDivision[]>;