tg-map-vue3 3.9.8 → 4.0.0

package/dist/src/map/map-factory.d.ts

@@ -1,10 +0,0 @@
-import type { AbstractMap } from './map/map';
-import { MapOptions } from './map/map-options';
-export declare enum TgMapType {
-    google = "google",
-    baidu = "baidu",
-    here = "here"
-}
-export declare namespace TgMapFactory {
-    function createMap(type: TgMapType, $map: HTMLElement, mapOptions?: Partial<MapOptions>): AbstractMap;
-}

package/dist/src/map/map-loader.d.ts

@@ -1,19 +0,0 @@
-import { type TgMapConfig } from './map-config';
-import { TgMapType } from './map-factory';
-/**
- * 使用类型映射的方式`TgMapConfig[T]`, 确定`type`的类型之后, 不会自动推断`config`的类型,
- * 故另外声明了一个联合类型{@link LoadMapOptionsImpl}, 在实现代码中使用它来自动推断类型
- */
-type LoadMapOptions<T extends TgMapType> = {
-    type: T;
-    config: TgMapConfig[T];
-};
-/**
- * 加载缓存的地图, 保证一种地图只加载一次
- */
-export declare function loadCachedMap(type: TgMapType): Promise<unknown>;
-/** 载入地图库 */
-export declare function loadMap<T extends TgMapType>(options: LoadMapOptions<T>): Promise<unknown>;
-export declare function loadJsonp(url: string, callbackParamName?: string): Promise<unknown>;
-export declare function loadJs(url: string): Promise<unknown>;
-export {};

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

@@ -1,17 +0,0 @@
-export interface Size {
-    readonly width: number;
-    readonly height: number;
-}
-export interface Point {
-    readonly x: number;
-    readonly y: number;
-}
-export declare namespace Point {
-    const ZERO: Point;
-}
-export interface Padding {
-    top: number;
-    right: number;
-    bottom: number;
-    left: number;
-}

package/dist/src/map/unions.d.ts

@@ -1,19 +0,0 @@
-import type { BaiduInfoBox } from './map/overlay/baidu-info-box';
-import type { GoogleLabel } from './map/overlay/google-label';
-/**
- * Map相关的各种类型的联合, 可以用来简化一部分代码的书写
- */
-export type UnionMap = google.maps.Map | BMap.Map | H.Map;
-export type UnionBaiduIcon = BMap.Icon | BMap.Symbol;
-export type UnionGoogleIcon = google.maps.Icon | google.maps.Symbol | google.maps.UrlIcon;
-export type UnionInfoWindow = google.maps.InfoWindow | BMap.InfoWindow;
-export type UnionAutocomplete = google.maps.places.Autocomplete | BMap.Autocomplete;
-export type UnionPlacesService = google.maps.places.PlacesService | BMap.LocalSearch;
-export type UnionGoogleOverlay = google.maps.Marker | google.maps.Polyline | google.maps.Polygon | google.maps.Circle | google.maps.Rectangle | GoogleLabel;
-export type UnionBaiduOverlay = BMap.Marker | BMap.Polyline | BMap.Polygon | BMap.Circle | BMap.Label | BaiduInfoBox;
-export type UnionGoogleEventTarget = google.maps.MVCObject;
-export type UnionBaiduEventTarget = UnionBaiduOverlay | BMap.InfoWindow | BMap.Autocomplete | BMap.Map;
-export type UnionBaiduShape = BMap.Polyline | BMap.Polygon | BMap.Circle;
-export type UnionGoogleShape = google.maps.Polyline | google.maps.Polygon | google.maps.Circle | google.maps.Rectangle;
-export type UnionControl = BMap.Control | HTMLElement;
-export type GoogleLayer = google.maps.TrafficLayer | google.maps.TransitLayer | google.maps.KmlLayer | google.maps.BicyclingLayer;

package/dist/src/utils/arrays.d.ts

@@ -1,19 +0,0 @@
-import type { AnyFunction, Constructor } from './mapped-types';
-export declare namespace Arrays {
-    function findByType<T>(arr: any[], constructor: Constructor<T>): T | undefined;
-    /** 自动推断item的类型的{@link Array.includes} */
-    function includesTyped<T extends E, E>(arr: T[], item: E): item is T;
-    /** 设置 指定位置的值 */
-    function at<T>(arr: T[], index: number, value: T): void;
-    /** 获取 指定位置的值 */
-    function at<T>(arr: T[], index: number): T | undefined;
-}
-export declare namespace MVCArrays {
-    function indexOf<T>(arr: google.maps.MVCArray<T>, item: T): number;
-    function remove<T>(arr: google.maps.MVCArray<T>, item: T): T | undefined;
-    /**
-     * 监听数组内容变化
-     * @see https://developers.google.com/maps/documentation/javascript/shapes#editable_events
-     * */
-    function listenChanged<T>(path: google.maps.MVCArray<T>, handler: AnyFunction): google.maps.MapsEventListener[];
-}

package/dist/src/utils/baidu-utils.d.ts

@@ -1,23 +0,0 @@
-/**
- * 3.0版的Overlay是类
- * @see http://lbsyun.baidu.com/cms/jsapi/reference/jsapi_reference_3_0.html#a3b0
- */
-export declare function ensureBaiduV3(): void;
-/**
- * 尝试修复baidu内存占用会越来越大的问题
- *
- * 当前版本的baidu源码中, 存在如下代码:
- * ```
- * A.lang.qx = function(a) {
- *   var b = window[A.da]; // A.da等于'$BAIDU$'
- *   b.kT && delete b.kT[a] // kT属性不存在, 故永远无法移除成功
- * }
- * ```
- * 最终会导致`$BAIDU$._instances`对象不断增长, 故我们把`$BAIDU$`对象的`kT`属性重定向到`_instances`
- * 保证该方法能够执行成功
- */
-export declare function tryFixBaiduOutOfMemory(): void;
-export declare const BMapPoints: {
-    /** {@link BMap.Point.equals} 无效, 故需要自己写一个 */
-    equals(a: BMap.Point, b: BMap.Point): boolean;
-};

package/dist/src/utils/elements.d.ts

@@ -1,4 +0,0 @@
-export declare namespace Elements {
-    /** @see https://stackoverflow.com/questions/4880381/check-whether-html-element-has-scrollbars */
-    function isScrollable(ele: Element): boolean;
-}

package/dist/src/utils/formatter.d.ts

@@ -1 +0,0 @@
-export declare function dimen(value: string | number | null | undefined): string | undefined;

package/dist/src/utils/google-utils.d.ts

@@ -1,34 +0,0 @@
-import { type CoordTypeSupplier } from '../map/lat-lng';
-import type { Place } from '../map/map/extra/places-service';
-/**
- * Google地图官方提供的载入方式, 使用{@link google.map.importLibrary}动态载入依赖
- *
- * 实验性的特性, 实测当前只有`3.52`版支持
- *
- * @see https://developers.google.com/maps/documentation/javascript/load-maps-js-api#dynamic-library-import
- */
-export declare function initGoogleMapDynamicLibraryImport(args: {
-    key: string;
-    v?: string;
-}): void;
-export declare const GoogleConst: {
-    /** Google的坐标0点 */
-    readonly LATLNG_ZERO: google.maps.LatLng;
-    readonly BOUNDS_ZERO: google.maps.LatLngBounds;
-};
-export interface AddressFields {
-    /** 国家 */
-    country: string;
-    /** 省 */
-    province: string;
-    /** 市 */
-    city: string;
-    /** 区 */
-    district: string;
-    /** 街道 */
-    street: string;
-    /** 门牌号 */
-    streetNumber: string;
-}
-export declare function parseGoogleAddressComponents(addressComponents: google.maps.GeocoderAddressComponent[], outResult?: AddressFields): AddressFields;
-export declare function parseGooglePlace(place: google.maps.places.PlaceResult, coordTypeSupplier: CoordTypeSupplier): Place;

package/dist/src/utils/here-utils.d.ts

@@ -1,10 +0,0 @@
-/**
- * 最新是3.1版, 但@types/heremaps和以前的项目都用的是3.0版, 故当前先用3.0...
- * TODO: 改成使用3.1版实现
- **/
-export declare const HERE_SUPPORTED_VERSIONS: readonly ["3.0"];
-/**
- * 当前@types/heremaps是v3.0版, 和v3.1版api有区别, 若要使用3.1版, 需要用这个方法来做到类型注解兼容...
- * @see https://developer.here.com/documentation/maps/topics/migration.html
- */
-export declare function ensureHereV31(): void;

package/dist/src/utils/mapped-types.d.ts

@@ -1,90 +0,0 @@
-import type { Component, ComponentPublicInstance } from 'vue';
-/** deep版的 `Partial` */
-export type DeepPartial<T> = {
-    [U in keyof T]?: T[U] extends object ? DeepPartial<T[U]> : T[U];
-};
-/** 表示一个函数 */
-export type AnyFunction = (...args: any[]) => any;
-/**
- * 表示一个构造器
- * {@link import('vue/types/options').Constructor}
- * */
-export type Constructor<T = {}> = new (...args: any[]) => T;
-/**
- * 抽象构造器类型, 相比{@link Constructor}, 不能直接用new创建对象
- * @see https://www.typescriptlang.org/docs/handbook/release-notes/typescript-4-2.html#abstract-construct-signatures
- */
-export type AbstractConstructor<T = {}> = abstract new (...args: any[]) => T;
-/** 原始类型=>包装类型 */
-export type PrimitiveToWrapper<T> = T extends boolean ? boolean : T extends string ? string : T extends number ? number : T;
-/** 包装类型=>原始类型 */
-export type WrapperToPrimitive<T> = T extends boolean ? boolean : T extends string ? string : T extends number ? number : T;
-/**
- * `vue instanceof VueConstructor`时`vue`并不会自动转换成`VueConstructor`的子类, 用该方法可以实现这种转换
- */
-export declare function isInstanceOf<T>(obj: any, constructor: Constructor<T>): obj is T;
-/** @see isInstanceOf */
-export declare function safeAs<T>(obj: any, constructor: Constructor<T>): T | undefined;
-/** 判断{@link instance}是否是{@link component}的实例 */
-export declare function isComponentByType<C extends Component & AbstractConstructor>(instance: ComponentPublicInstance | null, component: C): instance is InstanceType<C>;
-/** 安全转换组件类型, 若不能转换会返回`undefined` */
-export declare function safeAsComponent<C extends Component & AbstractConstructor>(instance: ComponentPublicInstance | null, component: C): InstanceType<C> | undefined;
-/**
- * 查找[startInstance, endComponent)之间的第一个类型为{@link component}的父组件
- * @param component 查找的组件
- * @param startInstance 查找的开始实例, 包含
- * @param endComponent 查找的终止组件, 不包含
- * @returns
- */
-export declare function findAncestorComponentByType<C extends Component & AbstractConstructor>(component: C, startInstance: ComponentPublicInstance | null, endComponent?: Component & AbstractConstructor): InstanceType<C> | undefined;
-/** {@link NonNullable} 的反义词 */
-export type Nullable<T> = T | null | undefined;
-/** T的所有value的联合类型 */
-export type ValueOf<T> = T[keyof T];
-/**
- * 提取出T中value为V的子类的所有key
- * @see https://stackoverflow.com/questions/54520676/in-typescript-how-to-specify-only-keys-of-a-generic-object-whose-values-are-stri
- * */
-export type KeysMatching<T, V> = {
-    [K in keyof T]: T[K] extends V ? K : never;
-}[keyof T];
-/**
- * 并不存在可以精确表示一个枚举类型, 该类只能近似表示一个字符枚举
- * */
-export type StringEnumLike = {
-    [k: string]: string;
-};
-/**
- * String枚举的值, 包括`string`类型
- * @see https://stackoverflow.com/questions/52393730/typescript-string-literal-union-type-from-enum
- */
-export type StringEnumValue<E extends StringEnumLike> = ValueOf<E> | `${ValueOf<E>}`;
-/**
- * 包装`T`中的部分枚举字段的值为{@link StringEnumValue}
- *
- * 会校验{@link EnumObjects}中的类型是否书写正确, 若写错, 会推断成`never`
- * */
-export type WrapStringEnumValue<T, EnumObjects extends {
-    [k in keyof T]?: StringEnumLike;
-}> = {
-    [P in keyof T]: P extends keyof EnumObjects ? EnumObjects[P] extends StringEnumLike ? T[P] extends ValueOf<EnumObjects[P]> | undefined ? StringEnumValue<EnumObjects[P]> : never : never : T[P];
-};
-/** 取消包装`T`中的{@link StringEnumValue}字段 */
-export declare function unwrapStringEnumValue<T extends object>(value: T): {
-    [K in keyof T]: T[K] extends StringEnumValue<infer Enum> ? StringEnumLike extends Enum ? T[K] : Enum[keyof Enum] : Exclude<T[K], undefined> extends StringEnumValue<infer Enum> ? StringEnumLike extends Enum ? T[K] : Enum[keyof Enum] | undefined : T[K];
-};
-export declare function unwrapStringEnumValue<E extends StringEnumLike>(value: StringEnumValue<E>, enumObject?: E): E[keyof E];
-export declare function unwrapStringEnumValue<E extends StringEnumLike>(value: StringEnumValue<E> | undefined, enumObject?: E): E[keyof E] | undefined;
-/**
- * 非空的值
- *
- * 类型`{}`也表示"任何非空的值", 但由于它看起来像空对象, 所以一般更推荐用Thing
- *
- * @see https://github.com/microsoft/TypeScript/issues/7648#issuecomment-541625573
- * @see https://github.com/typescript-eslint/typescript-eslint/issues/2063#issuecomment-675156492
- */
-export type Thing = string | number | boolean | bigint | object | symbol;
-/** 除T指定的类型外, 其他参数 */
-export type TypedAny<T> = T & {
-    [k: string]: any;
-};

package/dist/src/utils/objects.d.ts

@@ -1,27 +0,0 @@
-export declare namespace Objects {
-    function fromArray<T>(arr: T[], keySelector: (it: T) => string): {
-        [key: string]: T;
-    };
-    function fromEntries<V>(entries: [string, V][]): {
-        [k: string]: V;
-    };
-    function toJsonSafely(value: any): string;
-    /** 删除obj中纯对象上的值为undefined的属性 */
-    function deleteUndefinedPropertyOnPlainObjectDeeply(obj: any): void;
-    /** 存在则返回, 不存在则新建 */
-    function putIfAbsent<K extends keyof any, V>(obj: Record<K, V>, key: K, ifAbsent: () => Exclude<V, undefined>): Exclude<V, undefined>;
-    /** @see Omit */
-    function omit<T, K extends keyof any>(obj: T, ...keys: K[]): Omit<T, K>;
-    /** @see Pick */
-    function pick<T, K extends keyof T>(obj: T, ...keys: K[]): Pick<T, K>;
-    /**
-     * 使用{@link keyPath}读取`obj`的字段
-     *
-     * @param keyPath `.`分隔的字段名 或 字段名数组
-     * @returns 若字段不存在, 则返回`undefined`
-     */
-    function get(obj: any, keyPath: string | string[]): any;
-    function del(obj: any, keyPath: string | string[]): any;
-}
-/** 用于替代Vue2中的filter, 直接交给模板使用 */
-export declare const stringify: typeof Objects.toJsonSafely;

package/dist/src/utils/spherical-utils.d.ts

@@ -1,20 +0,0 @@
-import type { LatLngLiteral } from '../components';
-/**
- * 球面两点之间距离(米)
- * @param p1
- * @param p2
- */
-declare function getDistance(p1: LatLngLiteral, p2: LatLngLiteral): number;
-/**
- *  已知一点经纬度,方位角,距离求另一点
- * @param pt 点
- * @param angle 角度
- * @param dist 距离
- */
-export declare function getDestination(pt: LatLngLiteral, angle: number, dist: number): LatLngLiteral;
-/** 球面工具 */
-export declare const SphericalUtils: {
-    getDistance: typeof getDistance;
-    getDestination: typeof getDestination;
-};
-export {};

package/dist/src/utils/strings.d.ts

@@ -1,21 +0,0 @@
-import type { StringEnumLike } from './mapped-types';
-export declare namespace Strings {
-    /**
-    * 将string转换成字符枚举, 转换失败返回undefined
-    * @see {@link import('./vue-utils.ts').stringEnumProp} 由于使用了Object.values(enumObject), 应该避免在enumObject上添加其他属性/方法
-    * @deprecated 使用{@link import('./mapped-types.ts').unwrapStringEnumValue}替代
-    */
-    function toEnumOrNull<E extends StringEnumLike>(value: string | undefined, enumObject: E): E[keyof E] | undefined;
-    function trimIndent(str: string): string;
-    /** 转换: `FuckYou` -> `fuck-you` */
-    function pascal2kebab(str: string): string;
-    /**
-     * 简单判断字符串是否表示一个整数
-     * - `10` : ✅️
-     * - `-10`: ✅️
-     * - `+10`: ❌️
-     * - `2e2`: ❌️
-     * @see https://stackoverflow.com/questions/175739/how-can-i-check-if-a-string-is-a-valid-number
-     * */
-    function isInt(str: string): boolean;
-}

package/dist/src/utils/utils.d.ts

@@ -1,13 +0,0 @@
-export declare function todo(msg?: string): never;
-export declare function debug(msg?: any): any;
-/**
- * entry的value是否定义了
- *
- * 可以用在Array.filter(isEntryValueDef)中, 用来过滤值为空的元素
- * @see isNotNull
- */
-export declare function isEntryValueDef<K, V>(entry: [K, V]): entry is [K, NonNullable<V>];
-/**
- * 创建一个异步初始化的单例, 保证只初始化成功一次
- */
-export declare function createAsyncSingleton<T>(creator: () => Promise<T>): () => Promise<T>;

package/dist/src/utils/values.d.ts

@@ -1,34 +0,0 @@
-/** 键值对 */
-export declare class KeyValue<K, V> {
-    private keyToValue;
-    private valueToKey;
-    /**
-     * `keys`和`values`数组中可以有相同的值, 若存在相同值, 则index越小的优先级越高
-     */
-    constructor(keys: K[], values: V[]);
-    toKey(value: V): K;
-    toValue(key: K): V;
-}
-export type KeySelector<T, K> = (this: T) => K;
-/** 用key快速查找元素的数组 */
-export declare class FastFindValues<T> {
-    values: readonly T[];
-    private maxSize4Debug;
-    private map;
-    constructor(values: readonly T[], maxSize4Debug?: number);
-    /** 获取保存key-value映射的Map */
-    getValueMap<K>(keySelector: KeySelector<T, K>): Map<K, T>;
-    /**
-     * 直接用key获取value
-     * @param keySelector 从T中读取key的方法, 会用它当key, 缓存结果, 故多次调用需要使用相同的keySelector对象, 不要每次创建新的, 推荐直接使用T.prototype.getXxx作为keySelector
-     */
-    getOrNull<K>(keySelector: KeySelector<T, K>, key: K): T | undefined;
-    get<K>(keySelector: KeySelector<T, K>, key: K): T;
-}
-/** 缓存的值 */
-export declare class CachedValue<T> {
-    private creator;
-    private value;
-    constructor(creator: () => T);
-    get(): T;
-}

package/src/map/dts/baidu.d.ts

@@ -1,53 +0,0 @@
-declare namespace BMap {
-  class OverlayV3 {
-    initialize(map: Map): HTMLElement
-    isVisible(): boolean
-    draw(): void
-    show(): void
-    hide(): void
-    // 这些方法文档中都没写, 但确实可以调用...
-    addEventListener(event: string, handler: Callback): void
-    removeEventListener(event: string, handler: Callback): void
-    /** @param event type名要以'on'开头 */
-    dispatchEvent(event: { type: string }): void
-  }
-  interface Map {
-    addEventListener(event: string, handler: Callback): void
-    removeEventListener(event: string, handler: Callback): void
-  }
-  interface Autocomplete {
-    addEventListener(event: string, handler: Callback): void
-    removeEventListener(event: string, handler: Callback): void
-  }
-  interface AutocompleteResultPoi {
-    city: string
-  }
-  interface LocalSearchOptions {
-    onSearchComplete?: ((results: LocalResult[] | LocalResult) => void) | undefined;
-  }
-  interface LocalResultPoi {
-    uid: string
-  }
-
-  interface MarkerOptions {
-    icon?: BMap.Symbol | Icon
-  }
-
-  interface Marker {
-    setIcon(icon: Icon | BMap.Symbol): void;
-    getIcon(): Icon | BMap.Symbol;
-  }
-
-  interface Symbol {
-    /** 实际的锚点, 第一次添加到地图上时会为undefined */
-    anchor?: Size
-    style: {
-      /** 设置的锚点 */
-      anchor: Size
-    }
-  }
-
-  interface IconOptions {
-    imageSize?: Size
-  }
-}

package/src/map/dts/google.d.ts

@@ -1,10 +0,0 @@
-declare namespace google.maps {
-  /** url可以直接作为Icon */
-  type UrlIcon = string
-  interface InfoWindow {
-    /** 获取Map, 文档中没写这个方法 */
-    getMap(): Map | undefined
-    /** 获取锚点, 文档中没写这个方法 */
-    getAnchor(): Marker | undefined
-  }
-}

package/src/map/dts/here-v31.d.ts

@@ -1,16 +0,0 @@
-// v3.1
-declare namespace H {
-  namespace service {
-    interface PlatformV31Constructor {
-      new(options: { apikey: string }): Platform
-    }
-    interface PlatformV31 extends Platform {
-
-    }
-    let PlatformV31: PlatformV31Constructor
-    interface DefaultLayers {
-      raster: { normal: H.service.MapType, satellite: H.service.MapType, terrain: H.service.MapType }
-      vector: { normal: { map: H.map.layer.TileLayer, traffic: H.map.layer.TileLayer, trafficincidents: H.map.layer.MarkerTileLayer } }
-    }
-  }
-}

package/src/map/dts/index.d.ts

@@ -1,4 +0,0 @@
-/* eslint-disable @typescript-eslint/triple-slash-reference */
-/// <reference path="./baidu.d.ts" preserve="true" />
-/// <reference path="./google.d.ts" preserve="true" />
-/// <reference path="./here-v31.d.ts" preserve="true" />

package/src/map/dts/js-modules.d.ts

@@ -1,15 +0,0 @@
-/**
- * 当前版本, tsconfig中`allowJs:true`和`declaration:true`不兼容, 导致引用第三方js库时, 无法利用JSDoc的类型注解
- * 未来貌似会增加允许两者同时为true的功能, 详见{@link https://github.com/microsoft/TypeScript/pull/32372}
- *
- * 当前使用两个tsconfig, 达到类似效果:
- * 1. tsconfig.json: `allowJs:true`+`declaration:false`, 用来在VSCode中利用第三方JS库的JSDoc注解
- * 2. tsconfig.types.json: `allowJs:false`+`declaration:true`, 用来在编译时正常输出.d.ts文件
- *
- * 而该文件(`js-modules.d.ts`)的作用就是声明用到的第三方js库, 让tsconfig.types.json能够正常编译
- *
- * typescript 3.7 之后已支持两者同时为true, 该文件暂时没有用, 可以移除
- */
-// cSpell:ignore bmaplib, markerclusterer
-// declare module 'bmaplib.markerclusterer'
-// declare module '@google/markerclusterer'