@caoguo/maplibre 0.0.6 → 0.0.7

package/dist/controls/index.d.cts

@@ -0,0 +1,171 @@
+import { ThemeName } from '@caoguo/theme';
+
+interface ScaleBar {
+    /** 比例尺条代表的真实距离（米） */
+    meters: number;
+    /** 比例尺条在屏幕上的像素宽度 */
+    pixels: number;
+    /** 展示文案，如 "500 m" / "2 km" */
+    label: string;
+}
+/**
+ * 计算比例尺。
+ * @param latitude 当前视图中心纬度（度）
+ * @param zoom     MapLibre zoom（Web Mercator）
+ * @param dpiScale 设备像素比（默认 1；Retina 设为 window.devicePixelRatio）
+ * @param maxWidth 比例尺条最大像素宽度（默认 100）
+ * @param tileSize 瓦片像素尺寸（默认 512，MapLibre v4 默认）
+ */
+declare function computeScaleBar(latitude: number, zoom: number, opts?: {
+    dpiScale?: number;
+    maxWidth?: number;
+    tileSize?: number;
+}): ScaleBar;
+interface ScaleControlOptions {
+    /** 挂载容器（可选；不传则在地图容器内自动创建） */
+    container?: HTMLElement;
+    /** 是否显示实时坐标（默认 true） */
+    showCoordinate?: boolean;
+    /** 最大比例尺像素宽度 */
+    maxWidth?: number;
+}
+/**
+ * 比例尺控件。需传入 maplibre Map 实例（直接用 maplibre-gl 的 Map）。
+ */
+declare class ScaleControl {
+    private el;
+    private barEl;
+    private labelEl;
+    private coordEl?;
+    private map;
+    private opts;
+    private onMove;
+    private onZoom;
+    constructor(map: ScaleControl['map'], options?: ScaleControlOptions);
+    /** 把控件挂到地图容器（无预设容器时调用） */
+    addTo(container: HTMLElement): this;
+    /** 计算并刷新显示 */
+    update(): void;
+    private handleMove;
+    /** 移除控件与事件监听 */
+    remove(): void;
+}
+
+/**
+ * 主题切换控件（T8 / F-1.9）。
+ *
+ * 在暗色（caoguo-dark）与亮色（caoguo-light）官方矢量主题间切换，
+ * 调用 `map.setStyle` 并保留当前视图（center/zoom）与现有 GeoJSON 源/图层。
+ *
+ * 设计为「纯函数 core + 薄 DOM 绑定」：
+ * - `toggleTheme` / `themeFromStyle` 为纯逻辑，可独立单测；
+ * - `ThemeSwitcher` 类负责渲染按钮并绑定点击事件。
+ */
+
+interface ThemeSwitcherOptions {
+    /** 挂载容器（可选） */
+    container?: HTMLElement;
+    /** 初始主题 */
+    initial?: ThemeName;
+}
+declare function oppositeTheme(theme: ThemeName): ThemeName;
+/**
+ * 从当前 style 对象推断主题名（依据其 JSON 标识）。
+ * 非草果主题时回退到传入的 fallback。
+ */
+declare function themeFromStyle(style: {
+    name?: string;
+} | string | null | undefined, fallback?: ThemeName): ThemeName;
+declare class ThemeSwitcher {
+    private el;
+    private btn;
+    private current;
+    private map;
+    constructor(map: ThemeSwitcher['map'], options?: ThemeSwitcherOptions);
+    private applyLabel;
+    /** 当前主题 */
+    getTheme(): ThemeName;
+    /** 切换到指定主题（保留视图，diff 模式避免闪烁） */
+    setTheme(theme: ThemeName): void;
+    /** 在明暗之间切换 */
+    toggle(): void;
+    /** 挂到容器 */
+    addTo(container: HTMLElement): this;
+    /** 移除 */
+    remove(): void;
+}
+
+/**
+ * 图例控件（通用）。
+ *
+ * 行业专题图（水深色阶 / 光缆利用率 / 闸站状态 / 故障告警等）渲染后，
+ * 需要用户可读的图例说明。本控件接收数据驱动的图例项（label + color），
+ * 以「色块 + 文案」形式渲染；支持运行时 setItems 随图层切换更新。
+ *
+ * 设计为「纯函数 renderLegendHtml + 薄 DOM 绑定」：renderLegendHtml 不依赖浏览器，可独立单测。
+ */
+interface LegendItem {
+    /** 文案，如「水深 > 3m」「利用率高」 */
+    label: string;
+    /** 色值（CSS color，可与渲染层 paint 配色保持一致） */
+    color: string;
+    /** 标记形状：color 色块（默认）/ line 线段 */
+    shape?: 'color' | 'line';
+}
+interface LegendOptions {
+    /** 图例标题（可选） */
+    title?: string;
+    /** 图例项 */
+    items: LegendItem[];
+    /** 挂载容器（可选；不传则自动创建） */
+    container?: HTMLElement;
+}
+/** 纯函数：根据图例项生成 HTML 字符串（可单测） */
+declare function renderLegendHtml(items: LegendItem[], title?: string): string;
+/** 图例控件 */
+declare class LegendControl {
+    private el;
+    private bodyEl;
+    private opts;
+    constructor(options: LegendOptions);
+    private render;
+    /** 运行时更新图例项（随图层切换重新渲染） */
+    setItems(items: LegendItem[], title?: string): void;
+    /** 挂载到容器 */
+    addTo(container: HTMLElement): this;
+    remove(): void;
+}
+
+/**
+ * 地图导出控件（通用）。
+ *
+ * 行业专题图渲染后，常需导出当前视图为成果图（PNG）。
+ * 基于 maplibre-gl 画布 `toDataURL('image/png')` 生成截图并触发浏览器下载。
+ *
+ * 设计为「纯函数 triggerDownload + 薄 DOM 绑定」：triggerDownload 不依赖地图，可独立单测。
+ */
+interface ExportOptions {
+    /** 下载文件名（不含扩展名） */
+    filename?: string;
+    /** 挂载容器（可选；不传则自动创建） */
+    container?: HTMLElement;
+    /** 按钮文案 */
+    buttonText?: string;
+}
+/** 纯函数：触发浏览器下载（data URL） */
+declare function triggerDownload(dataUrl: string, filename: string): void;
+/** 导出控件 */
+declare class ExportControl {
+    private el;
+    private map;
+    private filename;
+    private onClick;
+    constructor(map: ExportControl['map'], options?: ExportOptions);
+    /** 导出当前地图视图为 PNG 并下载 */
+    export(): void;
+    /** 挂载到容器 */
+    addTo(container: HTMLElement): this;
+    remove(): void;
+}
+
+export { ExportControl, type ExportOptions, LegendControl, type LegendItem, type LegendOptions, type ScaleBar, ScaleControl, type ScaleControlOptions, ThemeSwitcher, type ThemeSwitcherOptions, computeScaleBar, oppositeTheme, renderLegendHtml, themeFromStyle, triggerDownload };

package/dist/controls/index.d.ts

@@ -0,0 +1,171 @@
+import { ThemeName } from '@caoguo/theme';
+
+interface ScaleBar {
+    /** 比例尺条代表的真实距离（米） */
+    meters: number;
+    /** 比例尺条在屏幕上的像素宽度 */
+    pixels: number;
+    /** 展示文案，如 "500 m" / "2 km" */
+    label: string;
+}
+/**
+ * 计算比例尺。
+ * @param latitude 当前视图中心纬度（度）
+ * @param zoom     MapLibre zoom（Web Mercator）
+ * @param dpiScale 设备像素比（默认 1；Retina 设为 window.devicePixelRatio）
+ * @param maxWidth 比例尺条最大像素宽度（默认 100）
+ * @param tileSize 瓦片像素尺寸（默认 512，MapLibre v4 默认）
+ */
+declare function computeScaleBar(latitude: number, zoom: number, opts?: {
+    dpiScale?: number;
+    maxWidth?: number;
+    tileSize?: number;
+}): ScaleBar;
+interface ScaleControlOptions {
+    /** 挂载容器（可选；不传则在地图容器内自动创建） */
+    container?: HTMLElement;
+    /** 是否显示实时坐标（默认 true） */
+    showCoordinate?: boolean;
+    /** 最大比例尺像素宽度 */
+    maxWidth?: number;
+}
+/**
+ * 比例尺控件。需传入 maplibre Map 实例（直接用 maplibre-gl 的 Map）。
+ */
+declare class ScaleControl {
+    private el;
+    private barEl;
+    private labelEl;
+    private coordEl?;
+    private map;
+    private opts;
+    private onMove;
+    private onZoom;
+    constructor(map: ScaleControl['map'], options?: ScaleControlOptions);
+    /** 把控件挂到地图容器（无预设容器时调用） */
+    addTo(container: HTMLElement): this;
+    /** 计算并刷新显示 */
+    update(): void;
+    private handleMove;
+    /** 移除控件与事件监听 */
+    remove(): void;
+}
+
+/**
+ * 主题切换控件（T8 / F-1.9）。
+ *
+ * 在暗色（caoguo-dark）与亮色（caoguo-light）官方矢量主题间切换，
+ * 调用 `map.setStyle` 并保留当前视图（center/zoom）与现有 GeoJSON 源/图层。
+ *
+ * 设计为「纯函数 core + 薄 DOM 绑定」：
+ * - `toggleTheme` / `themeFromStyle` 为纯逻辑，可独立单测；
+ * - `ThemeSwitcher` 类负责渲染按钮并绑定点击事件。
+ */
+
+interface ThemeSwitcherOptions {
+    /** 挂载容器（可选） */
+    container?: HTMLElement;
+    /** 初始主题 */
+    initial?: ThemeName;
+}
+declare function oppositeTheme(theme: ThemeName): ThemeName;
+/**
+ * 从当前 style 对象推断主题名（依据其 JSON 标识）。
+ * 非草果主题时回退到传入的 fallback。
+ */
+declare function themeFromStyle(style: {
+    name?: string;
+} | string | null | undefined, fallback?: ThemeName): ThemeName;
+declare class ThemeSwitcher {
+    private el;
+    private btn;
+    private current;
+    private map;
+    constructor(map: ThemeSwitcher['map'], options?: ThemeSwitcherOptions);
+    private applyLabel;
+    /** 当前主题 */
+    getTheme(): ThemeName;
+    /** 切换到指定主题（保留视图，diff 模式避免闪烁） */
+    setTheme(theme: ThemeName): void;
+    /** 在明暗之间切换 */
+    toggle(): void;
+    /** 挂到容器 */
+    addTo(container: HTMLElement): this;
+    /** 移除 */
+    remove(): void;
+}
+
+/**
+ * 图例控件（通用）。
+ *
+ * 行业专题图（水深色阶 / 光缆利用率 / 闸站状态 / 故障告警等）渲染后，
+ * 需要用户可读的图例说明。本控件接收数据驱动的图例项（label + color），
+ * 以「色块 + 文案」形式渲染；支持运行时 setItems 随图层切换更新。
+ *
+ * 设计为「纯函数 renderLegendHtml + 薄 DOM 绑定」：renderLegendHtml 不依赖浏览器，可独立单测。
+ */
+interface LegendItem {
+    /** 文案，如「水深 > 3m」「利用率高」 */
+    label: string;
+    /** 色值（CSS color，可与渲染层 paint 配色保持一致） */
+    color: string;
+    /** 标记形状：color 色块（默认）/ line 线段 */
+    shape?: 'color' | 'line';
+}
+interface LegendOptions {
+    /** 图例标题（可选） */
+    title?: string;
+    /** 图例项 */
+    items: LegendItem[];
+    /** 挂载容器（可选；不传则自动创建） */
+    container?: HTMLElement;
+}
+/** 纯函数：根据图例项生成 HTML 字符串（可单测） */
+declare function renderLegendHtml(items: LegendItem[], title?: string): string;
+/** 图例控件 */
+declare class LegendControl {
+    private el;
+    private bodyEl;
+    private opts;
+    constructor(options: LegendOptions);
+    private render;
+    /** 运行时更新图例项（随图层切换重新渲染） */
+    setItems(items: LegendItem[], title?: string): void;
+    /** 挂载到容器 */
+    addTo(container: HTMLElement): this;
+    remove(): void;
+}
+
+/**
+ * 地图导出控件（通用）。
+ *
+ * 行业专题图渲染后，常需导出当前视图为成果图（PNG）。
+ * 基于 maplibre-gl 画布 `toDataURL('image/png')` 生成截图并触发浏览器下载。
+ *
+ * 设计为「纯函数 triggerDownload + 薄 DOM 绑定」：triggerDownload 不依赖地图，可独立单测。
+ */
+interface ExportOptions {
+    /** 下载文件名（不含扩展名） */
+    filename?: string;
+    /** 挂载容器（可选；不传则自动创建） */
+    container?: HTMLElement;
+    /** 按钮文案 */
+    buttonText?: string;
+}
+/** 纯函数：触发浏览器下载（data URL） */
+declare function triggerDownload(dataUrl: string, filename: string): void;
+/** 导出控件 */
+declare class ExportControl {
+    private el;
+    private map;
+    private filename;
+    private onClick;
+    constructor(map: ExportControl['map'], options?: ExportOptions);
+    /** 导出当前地图视图为 PNG 并下载 */
+    export(): void;
+    /** 挂载到容器 */
+    addTo(container: HTMLElement): this;
+    remove(): void;
+}
+
+export { ExportControl, type ExportOptions, LegendControl, type LegendItem, type LegendOptions, type ScaleBar, ScaleControl, type ScaleControlOptions, ThemeSwitcher, type ThemeSwitcherOptions, computeScaleBar, oppositeTheme, renderLegendHtml, themeFromStyle, triggerDownload };

package/dist/controls/index.js

@@ -0,0 +1,4 @@
+export { ExportControl, LegendControl, ScaleControl, ThemeSwitcher, computeScaleBar, oppositeTheme, renderLegendHtml, themeFromStyle, triggerDownload } from '../chunk-MLLIAWVI.js';
+import '../chunk-DENQSIV2.js';
+//# sourceMappingURL=index.js.map
+//# sourceMappingURL=index.js.map

package/dist/controls/index.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":[],"names":[],"mappings":"","file":"index.js"}

package/dist/crs/index.cjs

@@ -0,0 +1,137 @@
+'use strict';
+
+// src/crs/gcj02.ts
+var PI = Math.PI;
+var A = 6378245;
+var EE = 0.006693421622965943;
+function outOfChina(lng, lat) {
+  return lng < 72.004 || lng > 137.8347 || lat < 0.8293 || lat > 55.8271;
+}
+function transformLat(lng, lat) {
+  let ret = -100 + 2 * lng + 3 * lat + 0.2 * lat * lat + 0.1 * lng * lat + 0.2 * Math.sqrt(Math.abs(lng));
+  ret += (20 * Math.sin(6 * lng * PI) + 20 * Math.sin(2 * lng * PI)) * 2 / 3;
+  ret += (20 * Math.sin(lat * PI) + 40 * Math.sin(lat / 3 * PI)) * 2 / 3;
+  ret += (160 * Math.sin(lat / 12 * PI) + 320 * Math.sin(lat * PI / 30)) * 2 / 3;
+  return ret;
+}
+function transformLng(lng, lat) {
+  let ret = 300 + lng + 2 * lat + 0.1 * lng * lng + 0.1 * lng * lat + 0.1 * Math.sqrt(Math.abs(lng));
+  ret += (20 * Math.sin(6 * lng * PI) + 20 * Math.sin(2 * lng * PI)) * 2 / 3;
+  ret += (20 * Math.sin(lng * PI) + 40 * Math.sin(lng / 3 * PI)) * 2 / 3;
+  ret += (150 * Math.sin(lng / 12 * PI) + 300 * Math.sin(lng / 30 * PI)) * 2 / 3;
+  return ret;
+}
+function wgs84ToGcj02(lng, lat) {
+  if (outOfChina(lng, lat)) return [lng, lat];
+  let dLat = transformLat(lng - 105, lat - 35);
+  let dLng = transformLng(lng - 105, lat - 35);
+  const radLat = lat / 180 * PI;
+  let magic = Math.sin(radLat);
+  magic = 1 - EE * magic * magic;
+  const sqrtMagic = Math.sqrt(magic);
+  dLat = dLat * 180 / (A * (1 - EE) / (magic * sqrtMagic) * PI);
+  dLng = dLng * 180 / (A / sqrtMagic * Math.cos(radLat) * PI);
+  return [lng + dLng, lat + dLat];
+}
+function gcj02ToWgs84(lng, lat) {
+  if (outOfChina(lng, lat)) return [lng, lat];
+  let [mlng, mlat] = wgs84ToGcj02(lng, lat);
+  let dlng = mlng - lng;
+  let dlat = mlat - lat;
+  [mlng, mlat] = wgs84ToGcj02(lng - dlng, lat - dlat);
+  dlng = mlng - lng;
+  dlat = mlat - lat;
+  [mlng, mlat] = wgs84ToGcj02(lng - dlng, lat - dlat);
+  dlng = mlng - lng;
+  dlat = mlat - lat;
+  return [lng - dlng, lat - dlat];
+}
+function isInChina(lng, lat) {
+  return !outOfChina(lng, lat);
+}
+
+// src/crs/cgcs2000.ts
+var gridShift = null;
+function setCgcs2000GridShift(provider) {
+  gridShift = provider;
+}
+function wgs84ToCgcs2000(lng, lat) {
+  if (!gridShift) return [lng, lat];
+  const [dLng, dLat] = gridShift.shift(lng, lat);
+  return [lng + dLng, lat + dLat];
+}
+function cgcs2000ToWgs84(lng, lat) {
+  if (!gridShift) return [lng, lat];
+  const [dLng, dLat] = gridShift.shift(lng, lat);
+  return [lng - dLng, lat - dLat];
+}
+
+// src/crs/transform.ts
+function toWgs84(crs, lng, lat) {
+  switch (crs) {
+    case "WGS84":
+      return [lng, lat];
+    case "GCJ02":
+      return gcj02ToWgs84(lng, lat);
+    case "CGCS2000":
+      return cgcs2000ToWgs84(lng, lat);
+  }
+}
+function fromWgs84(crs, lng, lat) {
+  switch (crs) {
+    case "WGS84":
+      return [lng, lat];
+    case "GCJ02":
+      return wgs84ToGcj02(lng, lat);
+    case "CGCS2000":
+      return wgs84ToCgcs2000(lng, lat);
+  }
+}
+function createTransformer(from, to) {
+  if (from === to) {
+    const identity = (lng, lat) => [lng, lat];
+    return { forward: identity, inverse: identity };
+  }
+  const forward = (lng, lat) => {
+    const [wLng, wLat] = toWgs84(from, lng, lat);
+    return fromWgs84(to, wLng, wLat);
+  };
+  const inverse = (lng, lat) => {
+    const [wLng, wLat] = toWgs84(to, lng, lat);
+    return fromWgs84(from, wLng, wLat);
+  };
+  return { forward, inverse };
+}
+function transformPoint(lng, lat, from, to) {
+  return createTransformer(from, to).forward(lng, lat);
+}
+function transformBounds(b, from, to) {
+  const t = createTransformer(from, to);
+  const xs = [];
+  const ys = [];
+  for (const [x, y] of [
+    [b[0], b[1]],
+    [b[2], b[1]],
+    [b[0], b[3]],
+    [b[2], b[3]]
+  ]) {
+    const [nx, ny] = t.forward(x, y);
+    xs.push(nx);
+    ys.push(ny);
+  }
+  return [Math.min(...xs), Math.min(...ys), Math.max(...xs), Math.max(...ys)];
+}
+
+exports.cgcs2000ToWgs84 = cgcs2000ToWgs84;
+exports.createTransformer = createTransformer;
+exports.fromWgs84 = fromWgs84;
+exports.gcj02ToWgs84 = gcj02ToWgs84;
+exports.isInChina = isInChina;
+exports.setCgcs2000GridShift = setCgcs2000GridShift;
+exports.toWgs84 = toWgs84;
+exports.transformBounds = transformBounds;
+exports.transformPoint = transformPoint;
+exports.wgs84ToCgcs2000 = wgs84ToCgcs2000;
+exports.wgs84ToGcj02 = wgs84ToGcj02;
+//# sourceMappingURL=index.cjs.map
+//# sourceMappingURL=index.cjs.map

package/dist/crs/index.cjs.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../src/crs/gcj02.ts","../../src/crs/cgcs2000.ts","../../src/crs/transform.ts"],"names":[],"mappings":"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","file":"index.cjs","sourcesContent":["/**\n * WGS84 <-> GCJ-02（火星坐标系）转换。\n *\n * 算法：公开的解析偏移模型（Krasovsky 椭球），与 coordtransform 一致。\n * 全国范围单点误差 < 50m（PRD 验收 F-1.1）。\n * 注意：GCJ-02 -> WGS84 采用 3 次迭代反算，进一步收敛残差。\n */\n\nconst PI = Math.PI;\nconst A = 6378245.0; // 长半轴\nconst EE = 0.00669342162296594323; // 第一偏心率平方\n\nfunction outOfChina(lng: number, lat: number): boolean {\n  return lng < 72.004 || lng > 137.8347 || lat < 0.8293 || lat > 55.8271;\n}\n\nfunction transformLat(lng: number, lat: number): number {\n  let ret =\n    -100.0 +\n    2.0 * lng +\n    3.0 * lat +\n    0.2 * lat * lat +\n    0.1 * lng * lat +\n    0.2 * Math.sqrt(Math.abs(lng));\n  ret += ((20.0 * Math.sin(6.0 * lng * PI) + 20.0 * Math.sin(2.0 * lng * PI)) * 2.0) / 3.0;\n  ret += ((20.0 * Math.sin(lat * PI) + 40.0 * Math.sin((lat / 3.0) * PI)) * 2.0) / 3.0;\n  ret += ((160.0 * Math.sin((lat / 12.0) * PI) + 320 * Math.sin((lat * PI) / 30.0)) * 2.0) / 3.0;\n  return ret;\n}\n\nfunction transformLng(lng: number, lat: number): number {\n  let ret =\n    300.0 +\n    lng +\n    2.0 * lat +\n    0.1 * lng * lng +\n    0.1 * lng * lat +\n    0.1 * Math.sqrt(Math.abs(lng));\n  ret += ((20.0 * Math.sin(6.0 * lng * PI) + 20.0 * Math.sin(2.0 * lng * PI)) * 2.0) / 3.0;\n  ret += ((20.0 * Math.sin(lng * PI) + 40.0 * Math.sin((lng / 3.0) * PI)) * 2.0) / 3.0;\n  ret += ((150.0 * Math.sin((lng / 12.0) * PI) + 300.0 * Math.sin((lng / 30.0) * PI)) * 2.0) / 3.0;\n  return ret;\n}\n\n/** WGS84 -> GCJ-02 */\nexport function wgs84ToGcj02(lng: number, lat: number): [number, number] {\n  if (outOfChina(lng, lat)) return [lng, lat];\n  let dLat = transformLat(lng - 105.0, lat - 35.0);\n  let dLng = transformLng(lng - 105.0, lat - 35.0);\n  const radLat = (lat / 180.0) * PI;\n  let magic = Math.sin(radLat);\n  magic = 1 - EE * magic * magic;\n  const sqrtMagic = Math.sqrt(magic);\n  dLat = (dLat * 180.0) / (((A * (1 - EE)) / (magic * sqrtMagic)) * PI);\n  dLng = (dLng * 180.0) / ((A / sqrtMagic) * Math.cos(radLat) * PI);\n  return [lng + dLng, lat + dLat];\n}\n\n/** GCJ-02 -> WGS84（3 次迭代反算） */\nexport function gcj02ToWgs84(lng: number, lat: number): [number, number] {\n  if (outOfChina(lng, lat)) return [lng, lat];\n  let [mlng, mlat] = wgs84ToGcj02(lng, lat);\n  let dlng = mlng - lng;\n  let dlat = mlat - lat;\n  // 一次迭代\n  [mlng, mlat] = wgs84ToGcj02(lng - dlng, lat - dlat);\n  dlng = mlng - lng;\n  dlat = mlat - lat;\n  // 二次迭代（收敛）\n  [mlng, mlat] = wgs84ToGcj02(lng - dlng, lat - dlat);\n  dlng = mlng - lng;\n  dlat = mlat - lat;\n  return [lng - dlng, lat - dlat];\n}\n\n/** 是否在 GCJ-02 偏移覆盖区（中国境内外判定） */\nexport function isInChina(lng: number, lat: number): boolean {\n  return !outOfChina(lng, lat);\n}\n","/**\n * WGS84 <-> CGCS2000 转换。\n *\n * 说明：CGCS2000 与 WGS84 采用近似相同的参考椭球（扁率/长半轴差异极小，\n * 历元差异仅导致 cm~dm 级点位偏移），在 Web Mercator 显示尺度下等价于一致。\n * 因此 Phase 0 默认实现为恒等变换（残差 < 0.5m，满足 PRD 验收 F-1.1）。\n *\n * 测绘级高精度需求：可注入 `GridShiftProvider`（区域 7 参数 / 格网平移），\n * 见 types.ts。本文件保留可扩展入口。\n */\n\nimport type { GridShiftProvider, LngLat } from './types';\n\nlet gridShift: GridShiftProvider | null = null;\n\n/** 注册 CGCS2000 偏移提供方（可选，测绘级） */\nexport function setCgcs2000GridShift(provider: GridShiftProvider | null): void {\n  gridShift = provider;\n}\n\n/** WGS84 -> CGCS2000 */\nexport function wgs84ToCgcs2000(lng: number, lat: number): LngLat {\n  if (!gridShift) return [lng, lat];\n  const [dLng, dLat] = gridShift.shift(lng, lat);\n  return [lng + dLng, lat + dLat];\n}\n\n/** CGCS2000 -> WGS84 */\nexport function cgcs2000ToWgs84(lng: number, lat: number): LngLat {\n  if (!gridShift) return [lng, lat];\n  const [dLng, dLat] = gridShift.shift(lng, lat);\n  return [lng - dLng, lat - dLat];\n}\n","/**\n * 坐标系变换组合器（以 WGS84 为枢纽）。\n *\n * 用法：\n *   const t = createTransformer('GCJ02', 'WGS84');\n *   const [lng, lat] = t.forward(114.30, 30.59); // GCJ-02 业务数据 -> 渲染基准\n */\n\nimport type { Bounds, CRS, LngLat, Transformer } from './types';\nimport { cgcs2000ToWgs84, wgs84ToCgcs2000 } from './cgcs2000';\nimport { gcj02ToWgs84, wgs84ToGcj02 } from './gcj02';\n\n/** 把任意 CRS 的坐标转换到 WGS84 */\nexport function toWgs84(crs: CRS, lng: number, lat: number): LngLat {\n  switch (crs) {\n    case 'WGS84':\n      return [lng, lat];\n    case 'GCJ02':\n      return gcj02ToWgs84(lng, lat);\n    case 'CGCS2000':\n      return cgcs2000ToWgs84(lng, lat);\n  }\n}\n\n/** 把 WGS84 坐标转换到目标 CRS */\nexport function fromWgs84(crs: CRS, lng: number, lat: number): LngLat {\n  switch (crs) {\n    case 'WGS84':\n      return [lng, lat];\n    case 'GCJ02':\n      return wgs84ToGcj02(lng, lat);\n    case 'CGCS2000':\n      return wgs84ToCgcs2000(lng, lat);\n  }\n}\n\nexport function createTransformer(from: CRS, to: CRS): Transformer {\n  if (from === to) {\n    const identity = (lng: number, lat: number): LngLat => [lng, lat];\n    return { forward: identity, inverse: identity };\n  }\n  const forward = (lng: number, lat: number): LngLat => {\n    const [wLng, wLat] = toWgs84(from, lng, lat);\n    return fromWgs84(to, wLng, wLat);\n  };\n  const inverse = (lng: number, lat: number): LngLat => {\n    const [wLng, wLat] = toWgs84(to, lng, lat);\n    return fromWgs84(from, wLng, wLat);\n  };\n  return { forward, inverse };\n}\n\n/** 单点快捷转换 */\nexport function transformPoint(\n  lng: number,\n  lat: number,\n  from: CRS,\n  to: CRS\n): LngLat {\n  return createTransformer(from, to).forward(lng, lat);\n}\n\n/** 范围 [w, s, e, n] 转换（取四个角点极值） */\nexport function transformBounds(b: Bounds, from: CRS, to: CRS): Bounds {\n  const t = createTransformer(from, to);\n  const xs: number[] = [];\n  const ys: number[] = [];\n  for (const [x, y] of [\n    [b[0], b[1]],\n    [b[2], b[1]],\n    [b[0], b[3]],\n    [b[2], b[3]],\n  ]) {\n    const [nx, ny] = t.forward(x, y);\n    xs.push(nx);\n    ys.push(ny);\n  }\n  return [Math.min(...xs), Math.min(...ys), Math.max(...xs), Math.max(...ys)];\n}\n"]}

package/dist/crs/index.d.cts

@@ -0,0 +1,80 @@
+/**
+ * 坐标系类型与变换接口（F-1.1）。
+ *
+ * 草果地图内部统一以 WGS84（EPSG:4326）为渲染基准。
+ * 业务数据可能为 GCJ-02（火星坐标）或 CGCS2000（国家2000），
+ * 通过 `createTransformer` 以 WGS84 为枢纽做相互转换。
+ */
+type CRS = 'WGS84' | 'GCJ02' | 'CGCS2000';
+type LngLat = [number, number];
+/** 一个坐标对（经/纬），与 MapLibre [lng, lat] 顺序一致 */
+type Point = LngLat;
+/** 地理范围 [west, south, east, north] */
+type Bounds = [number, number, number, number];
+interface Transformer {
+    /** 正向变换：from -> to */
+    forward(lng: number, lat: number): LngLat;
+    /** 逆向变换：to -> from（数学逆） */
+    inverse(lng: number, lat: number): LngLat;
+}
+/**
+ * CGCS2000 高精度偏移提供方（可选）。
+ * Phase 0 默认不接入官方格网，使用等价实现（误差 < 0.5m）。
+ * 测绘级场景可注入区域 7 参数 / 格网平移表。
+ */
+interface GridShiftProvider {
+    /** 返回相对 WGS84 的 [dLng, dLat] 偏移（单位：度） */
+    shift(lng: number, lat: number): LngLat;
+}
+
+/**
+ * WGS84 <-> GCJ-02（火星坐标系）转换。
+ *
+ * 算法：公开的解析偏移模型（Krasovsky 椭球），与 coordtransform 一致。
+ * 全国范围单点误差 < 50m（PRD 验收 F-1.1）。
+ * 注意：GCJ-02 -> WGS84 采用 3 次迭代反算，进一步收敛残差。
+ */
+/** WGS84 -> GCJ-02 */
+declare function wgs84ToGcj02(lng: number, lat: number): [number, number];
+/** GCJ-02 -> WGS84（3 次迭代反算） */
+declare function gcj02ToWgs84(lng: number, lat: number): [number, number];
+/** 是否在 GCJ-02 偏移覆盖区（中国境内外判定） */
+declare function isInChina(lng: number, lat: number): boolean;
+
+/**
+ * WGS84 <-> CGCS2000 转换。
+ *
+ * 说明：CGCS2000 与 WGS84 采用近似相同的参考椭球（扁率/长半轴差异极小，
+ * 历元差异仅导致 cm~dm 级点位偏移），在 Web Mercator 显示尺度下等价于一致。
+ * 因此 Phase 0 默认实现为恒等变换（残差 < 0.5m，满足 PRD 验收 F-1.1）。
+ *
+ * 测绘级高精度需求：可注入 `GridShiftProvider`（区域 7 参数 / 格网平移），
+ * 见 types.ts。本文件保留可扩展入口。
+ */
+
+/** 注册 CGCS2000 偏移提供方（可选，测绘级） */
+declare function setCgcs2000GridShift(provider: GridShiftProvider | null): void;
+/** WGS84 -> CGCS2000 */
+declare function wgs84ToCgcs2000(lng: number, lat: number): LngLat;
+/** CGCS2000 -> WGS84 */
+declare function cgcs2000ToWgs84(lng: number, lat: number): LngLat;
+
+/**
+ * 坐标系变换组合器（以 WGS84 为枢纽）。
+ *
+ * 用法：
+ *   const t = createTransformer('GCJ02', 'WGS84');
+ *   const [lng, lat] = t.forward(114.30, 30.59); // GCJ-02 业务数据 -> 渲染基准
+ */
+
+/** 把任意 CRS 的坐标转换到 WGS84 */
+declare function toWgs84(crs: CRS, lng: number, lat: number): LngLat;
+/** 把 WGS84 坐标转换到目标 CRS */
+declare function fromWgs84(crs: CRS, lng: number, lat: number): LngLat;
+declare function createTransformer(from: CRS, to: CRS): Transformer;
+/** 单点快捷转换 */
+declare function transformPoint(lng: number, lat: number, from: CRS, to: CRS): LngLat;
+/** 范围 [w, s, e, n] 转换（取四个角点极值） */
+declare function transformBounds(b: Bounds, from: CRS, to: CRS): Bounds;
+
+export { type Bounds, type CRS, type GridShiftProvider, type LngLat, type Point, type Transformer, cgcs2000ToWgs84, createTransformer, fromWgs84, gcj02ToWgs84, isInChina, setCgcs2000GridShift, toWgs84, transformBounds, transformPoint, wgs84ToCgcs2000, wgs84ToGcj02 };

package/dist/crs/index.d.ts

@@ -0,0 +1,80 @@
+/**
+ * 坐标系类型与变换接口（F-1.1）。
+ *
+ * 草果地图内部统一以 WGS84（EPSG:4326）为渲染基准。
+ * 业务数据可能为 GCJ-02（火星坐标）或 CGCS2000（国家2000），
+ * 通过 `createTransformer` 以 WGS84 为枢纽做相互转换。
+ */
+type CRS = 'WGS84' | 'GCJ02' | 'CGCS2000';
+type LngLat = [number, number];
+/** 一个坐标对（经/纬），与 MapLibre [lng, lat] 顺序一致 */
+type Point = LngLat;
+/** 地理范围 [west, south, east, north] */
+type Bounds = [number, number, number, number];
+interface Transformer {
+    /** 正向变换：from -> to */
+    forward(lng: number, lat: number): LngLat;
+    /** 逆向变换：to -> from（数学逆） */
+    inverse(lng: number, lat: number): LngLat;
+}
+/**
+ * CGCS2000 高精度偏移提供方（可选）。
+ * Phase 0 默认不接入官方格网，使用等价实现（误差 < 0.5m）。
+ * 测绘级场景可注入区域 7 参数 / 格网平移表。
+ */
+interface GridShiftProvider {
+    /** 返回相对 WGS84 的 [dLng, dLat] 偏移（单位：度） */
+    shift(lng: number, lat: number): LngLat;
+}
+
+/**
+ * WGS84 <-> GCJ-02（火星坐标系）转换。
+ *
+ * 算法：公开的解析偏移模型（Krasovsky 椭球），与 coordtransform 一致。
+ * 全国范围单点误差 < 50m（PRD 验收 F-1.1）。
+ * 注意：GCJ-02 -> WGS84 采用 3 次迭代反算，进一步收敛残差。
+ */
+/** WGS84 -> GCJ-02 */
+declare function wgs84ToGcj02(lng: number, lat: number): [number, number];
+/** GCJ-02 -> WGS84（3 次迭代反算） */
+declare function gcj02ToWgs84(lng: number, lat: number): [number, number];
+/** 是否在 GCJ-02 偏移覆盖区（中国境内外判定） */
+declare function isInChina(lng: number, lat: number): boolean;
+
+/**
+ * WGS84 <-> CGCS2000 转换。
+ *
+ * 说明：CGCS2000 与 WGS84 采用近似相同的参考椭球（扁率/长半轴差异极小，
+ * 历元差异仅导致 cm~dm 级点位偏移），在 Web Mercator 显示尺度下等价于一致。
+ * 因此 Phase 0 默认实现为恒等变换（残差 < 0.5m，满足 PRD 验收 F-1.1）。
+ *
+ * 测绘级高精度需求：可注入 `GridShiftProvider`（区域 7 参数 / 格网平移），
+ * 见 types.ts。本文件保留可扩展入口。
+ */
+
+/** 注册 CGCS2000 偏移提供方（可选，测绘级） */
+declare function setCgcs2000GridShift(provider: GridShiftProvider | null): void;
+/** WGS84 -> CGCS2000 */
+declare function wgs84ToCgcs2000(lng: number, lat: number): LngLat;
+/** CGCS2000 -> WGS84 */
+declare function cgcs2000ToWgs84(lng: number, lat: number): LngLat;
+
+/**
+ * 坐标系变换组合器（以 WGS84 为枢纽）。
+ *
+ * 用法：
+ *   const t = createTransformer('GCJ02', 'WGS84');
+ *   const [lng, lat] = t.forward(114.30, 30.59); // GCJ-02 业务数据 -> 渲染基准
+ */
+
+/** 把任意 CRS 的坐标转换到 WGS84 */
+declare function toWgs84(crs: CRS, lng: number, lat: number): LngLat;
+/** 把 WGS84 坐标转换到目标 CRS */
+declare function fromWgs84(crs: CRS, lng: number, lat: number): LngLat;
+declare function createTransformer(from: CRS, to: CRS): Transformer;
+/** 单点快捷转换 */
+declare function transformPoint(lng: number, lat: number, from: CRS, to: CRS): LngLat;
+/** 范围 [w, s, e, n] 转换（取四个角点极值） */
+declare function transformBounds(b: Bounds, from: CRS, to: CRS): Bounds;
+
+export { type Bounds, type CRS, type GridShiftProvider, type LngLat, type Point, type Transformer, cgcs2000ToWgs84, createTransformer, fromWgs84, gcj02ToWgs84, isInChina, setCgcs2000GridShift, toWgs84, transformBounds, transformPoint, wgs84ToCgcs2000, wgs84ToGcj02 };

package/dist/crs/index.js

@@ -0,0 +1,3 @@
+export { cgcs2000ToWgs84, createTransformer, fromWgs84, gcj02ToWgs84, isInChina, setCgcs2000GridShift, toWgs84, transformBounds, transformPoint, wgs84ToCgcs2000, wgs84ToGcj02 } from '../chunk-SKXL3DKL.js';
+//# sourceMappingURL=index.js.map
+//# sourceMappingURL=index.js.map