map-ol-utils 0.2.0 → 1.0.0

package/dist/index.d.cts

@@ -5,6 +5,8 @@ import { CRSTypes } from "gcoord";
 import { Source, WMTS, XYZ } from "ol/source.js";
 import { Coordinate } from "ol/coordinate.js";
 import Feature$1, { FeatureLike } from "ol/Feature.js";
+import { NormalizeStats, RestoreMode, TdtDecoderWorkerClient, TdtDecoderWorkerClientOptions } from "tdt-vts-core";
+import VectorTileLayer from "ol/layer/VectorTile.js";
 import VectorTileSource from "ol/source/VectorTile.js";
 import { Emitter, EventType } from "mitt";
 import TileLayer from "ol/layer/Tile.js";
@@ -24,6 +26,7 @@ import { StyleLike } from "ol/style/Style.js";
 import Collection from "ol/Collection.js";
 import Point$1 from "ol/geom/Point.js";
 import Cluster from "ol/source/Cluster.js";
+export * from "tdt-vts-core";
 //#region src/core/types.d.ts
 interface CustomMap extends Map$1 {
   activeBaseLayer?: string;
@@ -149,206 +152,6 @@ interface ElasticDataItemConfig extends DataItemConfig {
   largeImg: string;
 }
 //#endregion
-//#region src/tdt-vts/pk.d.ts
-interface TileCoordinate {
-  z: number;
-  x: number;
-  y: number;
-}
-interface TdtVtsUrlOptions {
-  token: string;
-  type?: string;
-  version?: string;
-  maxZoom?: number;
-  hosts?: readonly string[];
-  wrapX?: boolean;
-}
-/**
- * 将 XYZ 瓦片坐标编码为天地图 VTS 使用的 pk 参数。
- *
- * 算法按 main.0f98e6f9.js 中的实现还原：
- * 1. 从 bit=z 到 bit=0 交织 x/y 位；
- * 2. 反转；
- * 3. 将 0-based 位置 9、8、7、6 加一；
- * 4. 0/1/2/3/4 映射为 a/d/g/j/m；
- * 5. 连续字符使用“额外重复次数”压缩。
- */
-declare const encodeTdtPk: (x: number, y: number, z: number) => string;
-/** 反解 pk；用于调试、单元测试和核对网络请求。 */
-declare const decodeTdtPk: (pk: string) => TileCoordinate;
-/**
- * 根据 OpenLayers 的 [z, x, y] 生成最终 VTS 地址，不依赖字符串替换。
- */
-declare const createTdtVtsUrl: (tileCoord: readonly [number, number, number], options: TdtVtsUrlOptions) => string | undefined;
-declare const redactTdtToken: (url: string) => string;
-//#endregion
-//#region src/tdt-vts/private-mvt.d.ts
-declare const TDT_XOR_BYTE_INDEXES: readonly [1, 2, 3, 4, 99];
-type MvtLayout = 'private' | 'standard';
-type RestoreMode = 'auto' | 'header' | 'always' | 'never';
-type MvtGeometryType = 0 | 1 | 2 | 3 | 4;
-type MvtValue = {
-  kind: 'string';
-  value: string;
-} | {
-  kind: 'float';
-  value: number;
-} | {
-  kind: 'double';
-  value: number;
-} | {
-  kind: 'int64';
-  value: bigint;
-} | {
-  kind: 'uint64';
-  value: bigint;
-} | {
-  kind: 'sint64';
-  value: bigint;
-} | {
-  kind: 'boolean';
-  value: boolean;
-} | {
-  kind: 'null';
-  value: null;
-};
-interface MvtFeature {
-  id?: bigint;
-  tags: number[];
-  type: MvtGeometryType;
-  geometry: number[];
-}
-interface MvtLayer {
-  version: number;
-  name: string;
-  extent: number;
-  features: MvtFeature[];
-  keys: string[];
-  values: MvtValue[];
-}
-interface MvtTile {
-  layers: MvtLayer[];
-}
-interface LayerStats {
-  name: string;
-  featureCount: number;
-  pointCount: number;
-  lineCount: number;
-  polygonCount: number;
-  extent: number;
-  version: number;
-}
-interface NormalizeStats {
-  restored: boolean;
-  pragma: string | null;
-  inputBytes: number;
-  outputBytes: number;
-  layerCount: number;
-  featureCount: number;
-  layers: LayerStats[];
-}
-interface NormalizeOptions {
-  pragma?: string | null;
-  restoreMode?: RestoreMode;
-}
-interface NormalizeResult {
-  data: Uint8Array;
-  stats: NormalizeStats;
-}
-declare const restoreTdtBytes: (input: ArrayBuffer | ArrayBufferView | Uint8Array) => Uint8Array;
-declare const decodeMvt: (input: ArrayBuffer | ArrayBufferView | Uint8Array, layout: MvtLayout) => MvtTile;
-declare const privateTypeToStandard: (type: MvtGeometryType) => MvtGeometryType;
-declare const normalizePrivateGeometry: (geometry: readonly number[]) => number[];
-declare const encodeStandardMvt: (privateTile: MvtTile) => Uint8Array;
-declare const normalizePrivateMvt: (input: ArrayBuffer | ArrayBufferView | Uint8Array, options?: NormalizeOptions) => NormalizeResult;
-declare const resolveFeatureProperties: (layer: MvtLayer, feature: MvtFeature) => Record<string, string | number | boolean | bigint | null>;
-//#endregion
-//#region src/tdt-vts/style-loader.d.ts
-declare const TDT_VECTOR_SOURCE_ID = "base-tdt-vector-tile";
-interface JsonStyleLayer {
-  id: string;
-  type: string;
-  source?: string;
-  'source-layer'?: string;
-  beforeLayerId?: string;
-  minzoom?: number;
-  maxzoom?: number;
-  layout?: Record<string, unknown>;
-  paint?: Record<string, unknown>;
-  filter?: unknown;
-  metadata?: Record<string, unknown>;
-  [key: string]: unknown;
-}
-interface JsonStyleDocument {
-  version: 8;
-  name?: string;
-  metadata?: Record<string, unknown>;
-  sources: Record<string, Record<string, unknown>>;
-  sprite?: unknown;
-  glyphs?: string;
-  layers: JsonStyleLayer[];
-  [key: string]: unknown;
-}
-interface TdtStyleBundle {
-  style: JsonStyleDocument;
-  style0LayerCount: number;
-  style1LayerCount: number;
-  skippedLayerIds: string[];
-}
-interface LoadStyleOptions {
-  style0Url: string;
-  style1Url: string;
-  sourceId?: string;
-  signal?: AbortSignal;
-}
-/** 按原 bundle 的 beforeLayerId 语义逐层插入。 */
-declare const mergeTdtStyleLayers: (baseLayers: readonly JsonStyleLayer[], extraLayers: readonly JsonStyleLayer[]) => JsonStyleLayer[];
-declare const loadTdtStyleBundle: (options: LoadStyleOptions) => Promise<TdtStyleBundle>;
-declare const getConstantBackgroundColor: (style: JsonStyleDocument) => string | undefined;
-//#endregion
-//#region src/tdt-vts/tile-loader.d.ts
-interface TdtTileResponseStats extends NormalizeStats {
-  contentType: string | null;
-  cacheControl: string | null;
-}
-interface LoadedTdtTile {
-  buffer: ArrayBuffer;
-  stats: TdtTileResponseStats;
-}
-interface LoadTdtVtsOptions {
-  restoreMode?: RestoreMode;
-  signal?: AbortSignal;
-  fetch?: typeof globalThis.fetch;
-}
-/** Fetch a private Tianditu VTS tile and return a standard MVT buffer. */
-declare const loadAndNormalizeTdtVts: (url: string, options?: LoadTdtVtsOptions) => Promise<LoadedTdtTile>;
-//#endregion
-//#region src/tdt-vts/worker-client.d.ts
-type DecodedTile = LoadedTdtTile;
-interface DecodeTileOptions {
-  signal?: AbortSignal;
-}
-interface TdtDecoderWorkerClientOptions {
-  requestTimeoutMs?: number;
-  workerFactory?: () => Worker;
-}
-declare class TdtDecoderWorkerClient {
-  private readonly restoreMode;
-  private readonly worker;
-  private readonly pending;
-  private nextId;
-  private disposed;
-  private readonly requestTimeoutMs;
-  constructor(restoreMode: RestoreMode, options?: TdtDecoderWorkerClientOptions);
-  decode(url: string, options?: DecodeTileOptions): Promise<DecodedTile>;
-  dispose(): void;
-  private takePending;
-  private cancelRequest;
-  private fail;
-  private readonly handleMessage;
-  private readonly handleWorkerError;
-}
-//#endregion
 //#region src/tdt-vts/source.d.ts
 interface SourceDiagnostics {
   onDecoded?: (stats: NormalizeStats & {
@@ -358,8 +161,9 @@ interface SourceDiagnostics {
   onError?: (error: Error, redactedUrl: string) => void;
 }
 interface CreateTdtSourceOptions {
-  token: string;
+  token?: string;
   restoreMode: RestoreMode;
+  hosts: readonly [string, ...string[]];
   minZoom?: number;
   maxZoom?: number;
   diagnostics?: SourceDiagnostics;
@@ -369,7 +173,24 @@ interface TdtSourceBundle {
   source: VectorTileSource<FeatureLike>;
   decoder: TdtDecoderWorkerClient;
 }
+interface CreateTdtVtsLayerOptions {
+  token?: string;
+  hosts: readonly [string, ...string[]];
+  style: string | TdtVtsStyle;
+}
+interface TdtVtsStyle {
+  version: 8;
+  sources: Record<string, Record<string, unknown>>;
+  layers: Array<{
+    id: string;
+    type: string;
+    layout?: Record<string, unknown>;
+    [key: string]: unknown;
+  }>;
+  [key: string]: unknown;
+}
 declare const createTdtVectorSource: (options: CreateTdtSourceOptions) => TdtSourceBundle;
+declare const createTdtVtsLayer: (options: CreateTdtVtsLayerOptions) => Promise<VectorTileLayer<VectorTileSource<FeatureLike>>>;
 //#endregion
 //#region src/core/emitter.d.ts
 declare const emitter: Emitter<Record<EventType, any>>;
@@ -416,7 +237,7 @@ declare const createZheJiangLayer: (layerName?: ZheJiangType, tk?: string) => Ti
  * 根据图层名称获取图层
  * @param name
  */
-declare const getLayerByName: (name: string) => Layer<import("node_modules/ol/source").Source, import("node_modules/ol/renderer/Layer").default<any>, {
+declare const getLayerByName: (name: string) => Layer<import("ol/source").Source, import("ol/renderer/Layer").default<any>, {
   [x: string]: any;
 }> | undefined;
 /**
@@ -511,9 +332,9 @@ declare const createDrawInteraction: (type: Type | undefined, vectorLayer: Vecto
 //#endregion
 //#region src/layer/geojson-layer.d.ts
 /** 直接从 GeoJSON 创建矢量图层。 */
-declare const createGeoJsonLayer: (geoJson: any, style: StyleLike | FlatStyleLike | null | undefined, config?: LayerConfig) => VectorLayer<VectorSource<import("node_modules/ol").Feature<import("node_modules/ol/geom").Geometry, {
+declare const createGeoJsonLayer: (geoJson: any, style: StyleLike | FlatStyleLike | null | undefined, config?: LayerConfig) => VectorLayer<VectorSource<import("ol").Feature<import("ol/geom").Geometry, {
   [x: string]: any;
-}>>, import("node_modules/ol").Feature<import("node_modules/ol/geom").Geometry, {
+}>>, import("ol").Feature<import("ol/geom").Geometry, {
   [x: string]: any;
 }>>;
 //#endregion
@@ -574,9 +395,9 @@ declare const activeFeatureByUid: (uid: string) => void;
  * @param dataList
  * @param config
  */
-declare const createBusinessLayer: (dataList: MassData[], config: VectorConfig) => VectorLayer<VectorSource<Feature<import("node_modules/ol/geom").Geometry, {
+declare const createBusinessLayer: (dataList: MassData[], config: VectorConfig) => VectorLayer<VectorSource<Feature<import("ol/geom").Geometry, {
   [x: string]: any;
-}>>, Feature<import("node_modules/ol/geom").Geometry, {
+}>>, Feature<import("ol/geom").Geometry, {
   [x: string]: any;
 }>>;
 /**
@@ -591,9 +412,9 @@ declare const appendFeaturesByLayer: (targetLayer: VectorLayer, dataList: MassDa
  * @param dataList
  * @param config
  */
-declare const createVectorFaceLayer: (dataList: MassData[] | undefined, config: VectorConfig) => VectorLayer<VectorSource<Feature<import("node_modules/ol/geom").Geometry, {
+declare const createVectorFaceLayer: (dataList: MassData[] | undefined, config: VectorConfig) => VectorLayer<VectorSource<Feature<import("ol/geom").Geometry, {
   [x: string]: any;
-}>>, Feature<import("node_modules/ol/geom").Geometry, {
+}>>, Feature<import("ol/geom").Geometry, {
   [x: string]: any;
 }>>;
 /**
@@ -601,9 +422,9 @@ declare const createVectorFaceLayer: (dataList: MassData[] | undefined, config:
  * @param dataList
  * @param config
  */
-declare const createVectorLineLayer: (dataList: MassData[] | undefined, config: VectorConfig) => VectorLayer<VectorSource<Feature<import("node_modules/ol/geom").Geometry, {
+declare const createVectorLineLayer: (dataList: MassData[] | undefined, config: VectorConfig) => VectorLayer<VectorSource<Feature<import("ol/geom").Geometry, {
   [x: string]: any;
-}>>, Feature<import("node_modules/ol/geom").Geometry, {
+}>>, Feature<import("ol/geom").Geometry, {
   [x: string]: any;
 }>>;
 //#endregion
@@ -654,8 +475,8 @@ declare const updateMarksLayersByStatus: (checkedStatusList?: string[]) => MassD
  */
 declare const createClusterLayer: (dataList: ClusterData[], config: ClusterConfig) => VectorLayer<Cluster<Feature<Point, {
   [x: string]: any;
-}>>, Feature<import("node_modules/ol/geom").Geometry, {
+}>>, Feature<import("ol/geom").Geometry, {
   [x: string]: any;
 }>>;
 //#endregion
-export { ClusterConfig, ClusterData, type CreateTdtSourceOptions, CustomMap, DataItemConfig, type DecodedTile, ElasticDataItemConfig, GeometryCoordinates, GeometryType, GetImgUrl, GetImgUrlFn, HzsyType, IconConfig, type JsonStyleDocument, type JsonStyleLayer, LayerConfig, type LayerStats, type LoadStyleOptions, type LoadTdtVtsOptions, type LoadedTdtTile, MassData, type MvtFeature, type MvtGeometryType, type MvtLayer, type MvtLayout, type MvtTile, type MvtValue, type NormalizeOptions, type NormalizeResult, type NormalizeStats, type RestoreMode, type SourceDiagnostics, TDT_VECTOR_SOURCE_ID, TDT_XOR_BYTE_INDEXES, TdtDecoderWorkerClient, type TdtSourceBundle, type TdtStyleBundle, type TdtTileResponseStats, type TdtVtsUrlOptions, type TileCoordinate, VectorConfig, WmtsSourceOptions, WorldLayerType, ZheJiangType, activeFeatureByUid, addFeaturesByLayer, addMassMarksLayer, appendFeaturesByLayer, baseLayers, buildMassMarksStyles, changeLayer, changeSource, changeUnselectStyle, createAnimationMarker, createBaseLayer, createBusinessLayer, createClusterLayer, createDrawInteraction, createElasticMarkerLayer, createGeoJsonLayer, createIconStyle, createLayerSelectByNames, createMap, createMapInstance, createMapWorldLayer, createMarker, createMarkersLayer, createMassMarksLayer, createMoveMarkerLayer, createOverlay, createSelectByLayer, createTdtVectorSource, createTdtVtsUrl, createText, createVectorFaceLayer, createVectorLineLayer, createWmtsLayer, createZheJiangLayer, decodeMvt, decodeTdtPk, disposeInstance, disposeMap, emitter, encodeStandardMvt, encodeTdtPk, flyToAnimate, getConstantBackgroundColor, getDrawStyle, getLayerByName, getLayersDataList, getMapInstance, instance, loadAndNormalizeTdtVts, loadTdtStyleBundle, mergeTdtStyleLayers, normalizePrivateGeometry, normalizePrivateMvt, privateTypeToStandard, redactTdtToken, removeAllLayers, removeLayerByName, removeOverlays, resetActiveFeature, resetActiveVector, resetMap, resetZoomAndCenter, resolveFeatureProperties, restoreTdtBytes, setFitViewByCoords, setFitViewByGeom, setFitViewByLayer, updateMarksLayersByStatus };
+export { ClusterConfig, ClusterData, type CreateTdtSourceOptions, type CreateTdtVtsLayerOptions, CustomMap, DataItemConfig, ElasticDataItemConfig, GeometryCoordinates, GeometryType, GetImgUrl, GetImgUrlFn, HzsyType, IconConfig, LayerConfig, MassData, type SourceDiagnostics, type TdtSourceBundle, type TdtVtsStyle, VectorConfig, WmtsSourceOptions, WorldLayerType, ZheJiangType, activeFeatureByUid, addFeaturesByLayer, addMassMarksLayer, appendFeaturesByLayer, baseLayers, buildMassMarksStyles, changeLayer, changeSource, changeUnselectStyle, createAnimationMarker, createBaseLayer, createBusinessLayer, createClusterLayer, createDrawInteraction, createElasticMarkerLayer, createGeoJsonLayer, createIconStyle, createLayerSelectByNames, createMap, createMapInstance, createMapWorldLayer, createMarker, createMarkersLayer, createMassMarksLayer, createMoveMarkerLayer, createOverlay, createSelectByLayer, createTdtVectorSource, createTdtVtsLayer, createText, createVectorFaceLayer, createVectorLineLayer, createWmtsLayer, createZheJiangLayer, disposeInstance, disposeMap, emitter, flyToAnimate, getDrawStyle, getLayerByName, getLayersDataList, getMapInstance, instance, removeAllLayers, removeLayerByName, removeOverlays, resetActiveFeature, resetActiveVector, resetMap, resetZoomAndCenter, setFitViewByCoords, setFitViewByGeom, setFitViewByLayer, updateMarksLayersByStatus };

package/dist/index.d.mts

@@ -1,3 +1,5 @@
+import { NormalizeStats, RestoreMode, TdtDecoderWorkerClient, TdtDecoderWorkerClientOptions } from "tdt-vts-core";
+import VectorTileLayer from "ol/layer/VectorTile.js";
 import VectorTileSource from "ol/source/VectorTile.js";
 import { Emitter, EventType } from "mitt";
 import { Source, WMTS, XYZ } from "ol/source.js";
@@ -24,6 +26,7 @@ import Geometry, { Type } from "ol/geom/Geometry.js";
 import { FlatStyleLike } from "ol/style/flat.js";
 import { StyleLike } from "ol/style/Style.js";
 import Collection from "ol/Collection.js";
+export * from "tdt-vts-core";
 //#region src/core/types.d.ts
 interface CustomMap extends Map$1 {
   activeBaseLayer?: string;
@@ -149,206 +152,6 @@ interface ElasticDataItemConfig extends DataItemConfig {
   largeImg: string;
 }
 //#endregion
-//#region src/tdt-vts/pk.d.ts
-interface TileCoordinate {
-  z: number;
-  x: number;
-  y: number;
-}
-interface TdtVtsUrlOptions {
-  token: string;
-  type?: string;
-  version?: string;
-  maxZoom?: number;
-  hosts?: readonly string[];
-  wrapX?: boolean;
-}
-/**
- * 将 XYZ 瓦片坐标编码为天地图 VTS 使用的 pk 参数。
- *
- * 算法按 main.0f98e6f9.js 中的实现还原：
- * 1. 从 bit=z 到 bit=0 交织 x/y 位；
- * 2. 反转；
- * 3. 将 0-based 位置 9、8、7、6 加一；
- * 4. 0/1/2/3/4 映射为 a/d/g/j/m；
- * 5. 连续字符使用“额外重复次数”压缩。
- */
-declare const encodeTdtPk: (x: number, y: number, z: number) => string;
-/** 反解 pk；用于调试、单元测试和核对网络请求。 */
-declare const decodeTdtPk: (pk: string) => TileCoordinate;
-/**
- * 根据 OpenLayers 的 [z, x, y] 生成最终 VTS 地址，不依赖字符串替换。
- */
-declare const createTdtVtsUrl: (tileCoord: readonly [number, number, number], options: TdtVtsUrlOptions) => string | undefined;
-declare const redactTdtToken: (url: string) => string;
-//#endregion
-//#region src/tdt-vts/private-mvt.d.ts
-declare const TDT_XOR_BYTE_INDEXES: readonly [1, 2, 3, 4, 99];
-type MvtLayout = 'private' | 'standard';
-type RestoreMode = 'auto' | 'header' | 'always' | 'never';
-type MvtGeometryType = 0 | 1 | 2 | 3 | 4;
-type MvtValue = {
-  kind: 'string';
-  value: string;
-} | {
-  kind: 'float';
-  value: number;
-} | {
-  kind: 'double';
-  value: number;
-} | {
-  kind: 'int64';
-  value: bigint;
-} | {
-  kind: 'uint64';
-  value: bigint;
-} | {
-  kind: 'sint64';
-  value: bigint;
-} | {
-  kind: 'boolean';
-  value: boolean;
-} | {
-  kind: 'null';
-  value: null;
-};
-interface MvtFeature {
-  id?: bigint;
-  tags: number[];
-  type: MvtGeometryType;
-  geometry: number[];
-}
-interface MvtLayer {
-  version: number;
-  name: string;
-  extent: number;
-  features: MvtFeature[];
-  keys: string[];
-  values: MvtValue[];
-}
-interface MvtTile {
-  layers: MvtLayer[];
-}
-interface LayerStats {
-  name: string;
-  featureCount: number;
-  pointCount: number;
-  lineCount: number;
-  polygonCount: number;
-  extent: number;
-  version: number;
-}
-interface NormalizeStats {
-  restored: boolean;
-  pragma: string | null;
-  inputBytes: number;
-  outputBytes: number;
-  layerCount: number;
-  featureCount: number;
-  layers: LayerStats[];
-}
-interface NormalizeOptions {
-  pragma?: string | null;
-  restoreMode?: RestoreMode;
-}
-interface NormalizeResult {
-  data: Uint8Array;
-  stats: NormalizeStats;
-}
-declare const restoreTdtBytes: (input: ArrayBuffer | ArrayBufferView | Uint8Array) => Uint8Array;
-declare const decodeMvt: (input: ArrayBuffer | ArrayBufferView | Uint8Array, layout: MvtLayout) => MvtTile;
-declare const privateTypeToStandard: (type: MvtGeometryType) => MvtGeometryType;
-declare const normalizePrivateGeometry: (geometry: readonly number[]) => number[];
-declare const encodeStandardMvt: (privateTile: MvtTile) => Uint8Array;
-declare const normalizePrivateMvt: (input: ArrayBuffer | ArrayBufferView | Uint8Array, options?: NormalizeOptions) => NormalizeResult;
-declare const resolveFeatureProperties: (layer: MvtLayer, feature: MvtFeature) => Record<string, string | number | boolean | bigint | null>;
-//#endregion
-//#region src/tdt-vts/style-loader.d.ts
-declare const TDT_VECTOR_SOURCE_ID = "base-tdt-vector-tile";
-interface JsonStyleLayer {
-  id: string;
-  type: string;
-  source?: string;
-  'source-layer'?: string;
-  beforeLayerId?: string;
-  minzoom?: number;
-  maxzoom?: number;
-  layout?: Record<string, unknown>;
-  paint?: Record<string, unknown>;
-  filter?: unknown;
-  metadata?: Record<string, unknown>;
-  [key: string]: unknown;
-}
-interface JsonStyleDocument {
-  version: 8;
-  name?: string;
-  metadata?: Record<string, unknown>;
-  sources: Record<string, Record<string, unknown>>;
-  sprite?: unknown;
-  glyphs?: string;
-  layers: JsonStyleLayer[];
-  [key: string]: unknown;
-}
-interface TdtStyleBundle {
-  style: JsonStyleDocument;
-  style0LayerCount: number;
-  style1LayerCount: number;
-  skippedLayerIds: string[];
-}
-interface LoadStyleOptions {
-  style0Url: string;
-  style1Url: string;
-  sourceId?: string;
-  signal?: AbortSignal;
-}
-/** 按原 bundle 的 beforeLayerId 语义逐层插入。 */
-declare const mergeTdtStyleLayers: (baseLayers: readonly JsonStyleLayer[], extraLayers: readonly JsonStyleLayer[]) => JsonStyleLayer[];
-declare const loadTdtStyleBundle: (options: LoadStyleOptions) => Promise<TdtStyleBundle>;
-declare const getConstantBackgroundColor: (style: JsonStyleDocument) => string | undefined;
-//#endregion
-//#region src/tdt-vts/tile-loader.d.ts
-interface TdtTileResponseStats extends NormalizeStats {
-  contentType: string | null;
-  cacheControl: string | null;
-}
-interface LoadedTdtTile {
-  buffer: ArrayBuffer;
-  stats: TdtTileResponseStats;
-}
-interface LoadTdtVtsOptions {
-  restoreMode?: RestoreMode;
-  signal?: AbortSignal;
-  fetch?: typeof globalThis.fetch;
-}
-/** Fetch a private Tianditu VTS tile and return a standard MVT buffer. */
-declare const loadAndNormalizeTdtVts: (url: string, options?: LoadTdtVtsOptions) => Promise<LoadedTdtTile>;
-//#endregion
-//#region src/tdt-vts/worker-client.d.ts
-type DecodedTile = LoadedTdtTile;
-interface DecodeTileOptions {
-  signal?: AbortSignal;
-}
-interface TdtDecoderWorkerClientOptions {
-  requestTimeoutMs?: number;
-  workerFactory?: () => Worker;
-}
-declare class TdtDecoderWorkerClient {
-  private readonly restoreMode;
-  private readonly worker;
-  private readonly pending;
-  private nextId;
-  private disposed;
-  private readonly requestTimeoutMs;
-  constructor(restoreMode: RestoreMode, options?: TdtDecoderWorkerClientOptions);
-  decode(url: string, options?: DecodeTileOptions): Promise<DecodedTile>;
-  dispose(): void;
-  private takePending;
-  private cancelRequest;
-  private fail;
-  private readonly handleMessage;
-  private readonly handleWorkerError;
-}
-//#endregion
 //#region src/tdt-vts/source.d.ts
 interface SourceDiagnostics {
   onDecoded?: (stats: NormalizeStats & {
@@ -358,8 +161,9 @@ interface SourceDiagnostics {
   onError?: (error: Error, redactedUrl: string) => void;
 }
 interface CreateTdtSourceOptions {
-  token: string;
+  token?: string;
   restoreMode: RestoreMode;
+  hosts: readonly [string, ...string[]];
   minZoom?: number;
   maxZoom?: number;
   diagnostics?: SourceDiagnostics;
@@ -369,7 +173,24 @@ interface TdtSourceBundle {
   source: VectorTileSource<FeatureLike>;
   decoder: TdtDecoderWorkerClient;
 }
+interface CreateTdtVtsLayerOptions {
+  token?: string;
+  hosts: readonly [string, ...string[]];
+  style: string | TdtVtsStyle;
+}
+interface TdtVtsStyle {
+  version: 8;
+  sources: Record<string, Record<string, unknown>>;
+  layers: Array<{
+    id: string;
+    type: string;
+    layout?: Record<string, unknown>;
+    [key: string]: unknown;
+  }>;
+  [key: string]: unknown;
+}
 declare const createTdtVectorSource: (options: CreateTdtSourceOptions) => TdtSourceBundle;
+declare const createTdtVtsLayer: (options: CreateTdtVtsLayerOptions) => Promise<VectorTileLayer<VectorTileSource<FeatureLike>>>;
 //#endregion
 //#region src/core/emitter.d.ts
 declare const emitter: Emitter<Record<EventType, any>>;
@@ -416,7 +237,7 @@ declare const createZheJiangLayer: (layerName?: ZheJiangType, tk?: string) => Ti
  * 根据图层名称获取图层
  * @param name
  */
-declare const getLayerByName: (name: string) => Layer<import("node_modules/ol/source").Source, import("node_modules/ol/renderer/Layer").default<any>, {
+declare const getLayerByName: (name: string) => Layer<import("ol/source").Source, import("ol/renderer/Layer").default<any>, {
   [x: string]: any;
 }> | undefined;
 /**
@@ -511,9 +332,9 @@ declare const createDrawInteraction: (type: Type | undefined, vectorLayer: Vecto
 //#endregion
 //#region src/layer/geojson-layer.d.ts
 /** 直接从 GeoJSON 创建矢量图层。 */
-declare const createGeoJsonLayer: (geoJson: any, style: StyleLike | FlatStyleLike | null | undefined, config?: LayerConfig) => VectorLayer<VectorSource<import("node_modules/ol").Feature<import("node_modules/ol/geom").Geometry, {
+declare const createGeoJsonLayer: (geoJson: any, style: StyleLike | FlatStyleLike | null | undefined, config?: LayerConfig) => VectorLayer<VectorSource<import("ol").Feature<import("ol/geom").Geometry, {
   [x: string]: any;
-}>>, import("node_modules/ol").Feature<import("node_modules/ol/geom").Geometry, {
+}>>, import("ol").Feature<import("ol/geom").Geometry, {
   [x: string]: any;
 }>>;
 //#endregion
@@ -574,9 +395,9 @@ declare const activeFeatureByUid: (uid: string) => void;
  * @param dataList
  * @param config
  */
-declare const createBusinessLayer: (dataList: MassData[], config: VectorConfig) => VectorLayer<VectorSource<Feature<import("node_modules/ol/geom").Geometry, {
+declare const createBusinessLayer: (dataList: MassData[], config: VectorConfig) => VectorLayer<VectorSource<Feature<import("ol/geom").Geometry, {
   [x: string]: any;
-}>>, Feature<import("node_modules/ol/geom").Geometry, {
+}>>, Feature<import("ol/geom").Geometry, {
   [x: string]: any;
 }>>;
 /**
@@ -591,9 +412,9 @@ declare const appendFeaturesByLayer: (targetLayer: VectorLayer, dataList: MassDa
  * @param dataList
  * @param config
  */
-declare const createVectorFaceLayer: (dataList: MassData[] | undefined, config: VectorConfig) => VectorLayer<VectorSource<Feature<import("node_modules/ol/geom").Geometry, {
+declare const createVectorFaceLayer: (dataList: MassData[] | undefined, config: VectorConfig) => VectorLayer<VectorSource<Feature<import("ol/geom").Geometry, {
   [x: string]: any;
-}>>, Feature<import("node_modules/ol/geom").Geometry, {
+}>>, Feature<import("ol/geom").Geometry, {
   [x: string]: any;
 }>>;
 /**
@@ -601,9 +422,9 @@ declare const createVectorFaceLayer: (dataList: MassData[] | undefined, config:
  * @param dataList
  * @param config
  */
-declare const createVectorLineLayer: (dataList: MassData[] | undefined, config: VectorConfig) => VectorLayer<VectorSource<Feature<import("node_modules/ol/geom").Geometry, {
+declare const createVectorLineLayer: (dataList: MassData[] | undefined, config: VectorConfig) => VectorLayer<VectorSource<Feature<import("ol/geom").Geometry, {
   [x: string]: any;
-}>>, Feature<import("node_modules/ol/geom").Geometry, {
+}>>, Feature<import("ol/geom").Geometry, {
   [x: string]: any;
 }>>;
 //#endregion
@@ -654,8 +475,8 @@ declare const updateMarksLayersByStatus: (checkedStatusList?: string[]) => MassD
  */
 declare const createClusterLayer: (dataList: ClusterData[], config: ClusterConfig) => VectorLayer<Cluster<Feature<Point$1, {
   [x: string]: any;
-}>>, Feature<import("node_modules/ol/geom").Geometry, {
+}>>, Feature<import("ol/geom").Geometry, {
   [x: string]: any;
 }>>;
 //#endregion
-export { ClusterConfig, ClusterData, type CreateTdtSourceOptions, CustomMap, DataItemConfig, type DecodedTile, ElasticDataItemConfig, GeometryCoordinates, GeometryType, GetImgUrl, GetImgUrlFn, HzsyType, IconConfig, type JsonStyleDocument, type JsonStyleLayer, LayerConfig, type LayerStats, type LoadStyleOptions, type LoadTdtVtsOptions, type LoadedTdtTile, MassData, type MvtFeature, type MvtGeometryType, type MvtLayer, type MvtLayout, type MvtTile, type MvtValue, type NormalizeOptions, type NormalizeResult, type NormalizeStats, type RestoreMode, type SourceDiagnostics, TDT_VECTOR_SOURCE_ID, TDT_XOR_BYTE_INDEXES, TdtDecoderWorkerClient, type TdtSourceBundle, type TdtStyleBundle, type TdtTileResponseStats, type TdtVtsUrlOptions, type TileCoordinate, VectorConfig, WmtsSourceOptions, WorldLayerType, ZheJiangType, activeFeatureByUid, addFeaturesByLayer, addMassMarksLayer, appendFeaturesByLayer, baseLayers, buildMassMarksStyles, changeLayer, changeSource, changeUnselectStyle, createAnimationMarker, createBaseLayer, createBusinessLayer, createClusterLayer, createDrawInteraction, createElasticMarkerLayer, createGeoJsonLayer, createIconStyle, createLayerSelectByNames, createMap, createMapInstance, createMapWorldLayer, createMarker, createMarkersLayer, createMassMarksLayer, createMoveMarkerLayer, createOverlay, createSelectByLayer, createTdtVectorSource, createTdtVtsUrl, createText, createVectorFaceLayer, createVectorLineLayer, createWmtsLayer, createZheJiangLayer, decodeMvt, decodeTdtPk, disposeInstance, disposeMap, emitter, encodeStandardMvt, encodeTdtPk, flyToAnimate, getConstantBackgroundColor, getDrawStyle, getLayerByName, getLayersDataList, getMapInstance, instance, loadAndNormalizeTdtVts, loadTdtStyleBundle, mergeTdtStyleLayers, normalizePrivateGeometry, normalizePrivateMvt, privateTypeToStandard, redactTdtToken, removeAllLayers, removeLayerByName, removeOverlays, resetActiveFeature, resetActiveVector, resetMap, resetZoomAndCenter, resolveFeatureProperties, restoreTdtBytes, setFitViewByCoords, setFitViewByGeom, setFitViewByLayer, updateMarksLayersByStatus };
+export { ClusterConfig, ClusterData, type CreateTdtSourceOptions, type CreateTdtVtsLayerOptions, CustomMap, DataItemConfig, ElasticDataItemConfig, GeometryCoordinates, GeometryType, GetImgUrl, GetImgUrlFn, HzsyType, IconConfig, LayerConfig, MassData, type SourceDiagnostics, type TdtSourceBundle, type TdtVtsStyle, VectorConfig, WmtsSourceOptions, WorldLayerType, ZheJiangType, activeFeatureByUid, addFeaturesByLayer, addMassMarksLayer, appendFeaturesByLayer, baseLayers, buildMassMarksStyles, changeLayer, changeSource, changeUnselectStyle, createAnimationMarker, createBaseLayer, createBusinessLayer, createClusterLayer, createDrawInteraction, createElasticMarkerLayer, createGeoJsonLayer, createIconStyle, createLayerSelectByNames, createMap, createMapInstance, createMapWorldLayer, createMarker, createMarkersLayer, createMassMarksLayer, createMoveMarkerLayer, createOverlay, createSelectByLayer, createTdtVectorSource, createTdtVtsLayer, createText, createVectorFaceLayer, createVectorLineLayer, createWmtsLayer, createZheJiangLayer, disposeInstance, disposeMap, emitter, flyToAnimate, getDrawStyle, getLayerByName, getLayersDataList, getMapInstance, instance, removeAllLayers, removeLayerByName, removeOverlays, resetActiveFeature, resetActiveVector, resetMap, resetZoomAndCenter, setFitViewByCoords, setFitViewByGeom, setFitViewByLayer, updateMarksLayersByStatus };