tg-map-vue3 3.0.1

package/dist/src/map/map/overlay/label.d.ts

@@ -0,0 +1,89 @@
+/// <reference types="baidumap-web-sdk" />
+import { BaiduOverlay, Overlay, GoogleOverlay } from './overlay';
+import type { BaiduMap } from '../baidu-map';
+import { LatLng, CoordType } from '../../lat-lng';
+import { Point } from '../../types';
+import type { Tg } from '../../event';
+import type { GoogleMap } from '../google-map';
+import { type GoogleLabel } from './google-label';
+export type BaiduLabel = BMap.Label & {
+    __label__?: BaiduLabelOverlay;
+};
+export type LabelEventMap = {
+    click: Tg.Event;
+};
+/**
+ * 初始位置, 左上角对齐position
+ */
+export interface LabelOptions {
+    content: LabelContent;
+    position?: LatLng;
+    offset?: Point;
+    /**
+     * ## 不同行为
+     * 当将label添加到marker中时:
+     * - baidu: zIndex设置无效, Label的元素的z-index始终为80
+     * - google: 依然有效, 但貌似是由于marker元素的opacity:0;的原因, 调整成比marker小的zIndex后, 依然不能位于marker后方...
+     * */
+    zIndex?: number;
+}
+/**
+ * ## 不同实现
+ * - baidu: 有Label类,
+ *    - 添加到地图上时, 默认左上角对齐position
+ *    - 添加到marker中时, 默认左上角对齐marker的icon的左上角
+ *    - 内容只能是string, string可以是html字符串
+ * - google: 没有Label类, 我们用OverlayView实现了一个GoogleLabel
+ *    - 添加到地图上时, 默认左上角对齐position
+ *    - 没有添加到marker中的功能
+ *    - 内容是HTMLElement
+ *
+ * 针对这些不同, 使用了如下方法使它们行为尽量一致:
+ * 1. {@link BaiduLabelOverlay.attachIcon}, 让BaiduLabelOverlay关联icon, 使其添加到地图上时也是左上角对齐position
+ * 2. {@link GoogleMarker.setLabel}, 让GoogleMarker关联GoogleLabel, 联动它们的显隐/位置, 使其支持添加到marker中
+ * 3. {@link BaiduLabelOverlay.setContentInternal}, 将HTMLElement转成string, 并让BaiduLabelOverlay监听HTMLElement的改变, 由于转换成了string, 故里面的事件监听是无效的, 只能使用{@link LabelEventMap}中的事件
+ */
+export interface Label {
+    setContent(content: LabelContent): void;
+    getPosition(): LatLng;
+    setPosition(position: LatLng): void;
+    getOffset(): Point;
+    setOffset(offset: Point): void;
+    setZIndex(zIndex: number): void;
+}
+export type LabelOverlay = Label & Overlay;
+type LabelContent = string | HTMLElement;
+declare namespace LabelContent {
+    function toString(content: LabelContent): string;
+    function toElement(content: LabelContent): HTMLElement;
+}
+/** 内容只能是固定不变的 */
+export declare class BaiduLabelOverlay extends BaiduOverlay<BaiduLabel> implements Label {
+    static create(this: BaiduMap, options: LabelOptions): BaiduLabelOverlay;
+    private icon;
+    private content;
+    private contentObserver;
+    constructor(innerOverlay: BaiduLabel, coordType: CoordType, map: BaiduMap, content: LabelContent);
+    private setContentInternal;
+    setZIndex(zIndex: number): void;
+    getPosition(): LatLng;
+    setPosition(position: LatLng): void;
+    getOffset(): Point;
+    setOffset(offset: Point): void;
+    setContent(content: LabelContent): void;
+    /**
+     * 关联新的Icon, 内部使用的方法
+     * @description baidu中Label默认左上角对齐Icon的左上, 我们要将其转换为对齐marker的position
+     * */
+    attachIcon(icon: BMap.Icon | undefined): void;
+}
+export declare class GoogleLabelOverlay extends GoogleOverlay<GoogleLabel> implements Label {
+    static create(this: GoogleMap, options: LabelOptions): GoogleLabelOverlay;
+    setZIndex(zIndex: number): void;
+    setContent(content: LabelContent): void;
+    getPosition(): LatLng;
+    setPosition(position: LatLng): void;
+    getOffset(): Point;
+    setOffset(offset: Point): void;
+}
+export {};

package/dist/src/map/map/overlay/marker.d.ts

@@ -0,0 +1,126 @@
+/// <reference types="baidumap-web-sdk" />
+/// <reference types="googlemaps" />
+import { LatLng, CoordType } from '../../lat-lng';
+import { BaiduOverlay, GoogleOverlay, Overlay, type OverlayOptions } from './overlay';
+import { Icon } from './icon';
+import type { Nullable } from '../../../utils/mapped-types';
+import type { UnionIcon } from '../../unions';
+import type { AbstractMap } from '../map';
+import type { Tg } from '../../event';
+import type { BaiduMap } from '../baidu-map';
+import type { GoogleMap } from '../google-map';
+import type { BaiduLabelOverlay, LabelOverlay, GoogleLabelOverlay } from './label';
+import type { BaiduInfoBox } from './baidu-info-box';
+export interface MarkerOptions extends OverlayOptions {
+    position: LatLng;
+    title?: string;
+    icon?: Icon;
+    /** @default true */
+    clickable?: boolean;
+    /** @default false */
+    draggable?: boolean;
+    /**
+     * 拖拽时是否显示`x`
+     * @default true
+     * */
+    crossOnDrag?: boolean;
+    /**
+     * ## 不同行为
+     * - google: 有`cursor` 属性, 作用是hover时改变cursor
+     * - baidu: 有`draggingCursor`属性, 作用是拖动时改变cursor
+     * @deprecated 不推荐使用
+     */
+    cursor?: string;
+    zIndex?: number;
+}
+/** 仅仅起到类型声明的作用... */
+type MarkerEventMap = {
+    click: Tg.Event;
+    dblclick: Tg.MouseEvent;
+    rightclick: Tg.Event;
+    mousedown: Tg.MouseEvent;
+    mouseup: Tg.MouseEvent;
+    mouseout: Tg.MouseEvent;
+    mouseover: Tg.MouseEvent;
+    dragstart: Tg.Event;
+    drag: Tg.MouseEvent;
+    dragend: Tg.MouseEvent;
+};
+export interface Marker extends Tg.EventTargetTyped<Marker, MarkerEventMap> {
+    getPosition(): LatLng;
+    setPosition(position: LatLng): void;
+    setTitle(title: string): void;
+    getTitle(): string;
+    setIcon(icon: Icon): void;
+    /** 感觉并没有读取Icon的必要, 直接返回UnionIcon, 懒得写包装类_(:3」∠)_ */
+    getIcon(): Nullable<UnionIcon>;
+    /**
+     * ## 不同行为
+     * - baidu: 不支持设置clickable
+     * - google: 支持
+     * @deprecated 不推荐使用
+     */
+    setClickable(enable: boolean): void;
+    isClickable(): boolean;
+    setDraggable(enable: boolean): void;
+    isDraggable(): boolean;
+    /**
+     * ## 不同行为
+     * - baidu: 调用该方法无效
+     * - google: 有效
+     */
+    setZIndex(zIndex?: number): void;
+    getZIndex(): number | undefined;
+    setLabel(label: LabelOverlay | undefined): void;
+}
+export type MarkerOverlay = Marker & Overlay;
+export type BMarker = BMap.Marker & {
+    __info_box__?: BaiduInfoBox;
+};
+export declare class BaiduMarker extends BaiduOverlay<BMarker> implements Marker {
+    /** baidu的Marker不支持读/写clickable等属性, 故只能将创建临时的clickable保存在这个state中 */
+    private state;
+    static create(this: BaiduMap, options: MarkerOptions): BaiduMarker;
+    constructor(innerOverlay: BMap.Marker, coordType: CoordType, map: AbstractMap, 
+    /** baidu的Marker不支持读/写clickable等属性, 故只能将创建临时的clickable保存在这个state中 */
+    state: {
+        clickable: boolean;
+        draggable: boolean;
+        zIndex: number | undefined;
+    });
+    getPosition(): LatLng;
+    setPosition(position: LatLng): void;
+    setTitle(title: string): void;
+    getTitle(): string;
+    setIcon(icon: Icon): void;
+    getIcon(): UnionIcon;
+    setClickable(enable: boolean): void;
+    isClickable(): boolean;
+    setDraggable(enable: boolean): void;
+    isDraggable(): boolean;
+    setZIndex(zIndex?: number): void;
+    getZIndex(): number | undefined;
+    setLabel(label: BaiduLabelOverlay | undefined): void;
+    getLabel(): BaiduLabelOverlay | undefined;
+}
+export declare class GoogleMarker extends GoogleOverlay<google.maps.Marker> implements Marker {
+    static create(this: GoogleMap, options: MarkerOptions): GoogleMarker;
+    private label;
+    private labelPositionListener;
+    private labelVisibleListener;
+    private labelMapChangedListener;
+    getPosition(): LatLng;
+    setPosition(position: LatLng): void;
+    setTitle(title: string): void;
+    getTitle(): string;
+    setIcon(icon: Icon): void;
+    getIcon(): Nullable<UnionIcon>;
+    setClickable(flag: boolean): void;
+    isClickable(): boolean;
+    setDraggable(enable: boolean): void;
+    isDraggable(): boolean;
+    setZIndex(zIndex?: number): void;
+    getZIndex(): number | undefined;
+    setLabel(label: GoogleLabelOverlay | undefined): void;
+}
+export {};

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

@@ -0,0 +1,38 @@
+import type { CoordType } from '../../lat-lng';
+import type { AbstractMap } from '../map';
+import type { UnionGoogleOverlay, UnionBaiduOverlay } from '../../unions';
+import type { Tg } from '../../event';
+import { AbstractEventTargetDelegate } from '../../event-target';
+export interface OverlayOptions {
+    /** @default true */
+    visible?: boolean;
+}
+export declare abstract class Overlay<T = unknown> implements Tg.EventTarget {
+    innerOverlay: T;
+    /** 用于保存Overlay内部点的坐标, 它的值有可能和map的不同 */
+    protected coordType: CoordType;
+    protected map: AbstractMap;
+    private delegate;
+    addEventListener: (type: string, listener: Tg.EventListener) => void;
+    removeEventListener: (type: string, listener: Tg.EventListener) => void;
+    constructor(innerOverlay: T, 
+    /** 用于保存Overlay内部点的坐标, 它的值有可能和map的不同 */
+    coordType: CoordType, map: AbstractMap, delegate: AbstractEventTargetDelegate);
+    remove(): void;
+    abstract isVisible(): boolean;
+    abstract setVisible(visible: boolean): void;
+}
+export declare class GoogleOverlay<T extends UnionGoogleOverlay = UnionGoogleOverlay> extends Overlay<T> {
+    constructor(innerOverlay: T, coordType: CoordType, map: AbstractMap);
+    isVisible(): boolean;
+    setVisible(visible: boolean): void;
+}
+export declare class BaiduOverlay<T extends UnionBaiduOverlay = UnionBaiduOverlay> extends Overlay<T> {
+    constructor(innerOverlay: T, coordType: CoordType, map: AbstractMap);
+    /** 仅限内部使用; 设为private时, 生成的d.ts文件中, 方法返回值会变成any, 故改成了public */
+    get overlay(): Required<Pick<UnionBaiduOverlay, "show" | "isVisible" | "hide">>;
+    isVisible(): boolean;
+    setVisible(visible: boolean): void;
+    /** 在创建BaiduOverlay时, 设置options.visible, 仅内部使用 */
+    visibleOptionInternal(visible: boolean | undefined): this;
+}

package/dist/src/map/map/overlay/polygon.d.ts

@@ -0,0 +1,35 @@
+/// <reference types="baidumap-web-sdk" />
+/// <reference types="googlemaps" />
+import type { Tg } from '../../event';
+import type { Overlay } from './overlay';
+import { LatLng } from '../../lat-lng';
+import { BaiduShape, GoogleShape, type ShapeOptions, type Shape } from './shape';
+import type { BaiduMap } from '../baidu-map';
+import type { GoogleMap } from '../google-map';
+type PolygonEventMap = {
+    click: Tg.Event;
+    dblclick: Tg.Event;
+    mousedown: Tg.MouseEvent;
+    mouseup: Tg.MouseEvent;
+    mouseout: Tg.MouseEvent;
+    mouseover: Tg.MouseEvent;
+};
+export interface PolygonOptions extends ShapeOptions {
+    paths: LatLng[][];
+}
+export interface Polygon extends Tg.EventTargetTyped<Polygon, PolygonEventMap>, Shape {
+    getPaths(): LatLng[][];
+    setPaths(paths: LatLng[][]): void;
+}
+export type PolygonOverlay = Polygon & Overlay;
+export declare class BaiduPolygon extends BaiduShape<BMap.Polygon> implements Polygon {
+    static create(this: BaiduMap, options: PolygonOptions): BaiduPolygon;
+    getPaths(): LatLng[][];
+    setPaths(paths: LatLng[][]): void;
+}
+export declare class GooglePolygon extends GoogleShape<google.maps.Polygon> implements Polygon {
+    static create(this: GoogleMap, options: PolygonOptions): GooglePolygon;
+    getPaths(): LatLng[][];
+    setPaths(paths: LatLng[][]): void;
+}
+export {};

package/dist/src/map/map/overlay/polyline.d.ts

@@ -0,0 +1,35 @@
+/// <reference types="baidumap-web-sdk" />
+/// <reference types="googlemaps" />
+import type { Overlay } from './overlay';
+import { LatLng } from '../../lat-lng';
+import type { Tg } from '../../event';
+import type { BaiduMap } from '../baidu-map';
+import type { GoogleMap } from '../google-map';
+import { BaiduShape, GoogleShape, type NotFillableShape, type NotFillableShapeOptions } from './shape';
+type PolylineEventMap = {
+    click: Tg.Event;
+    dblclick: Tg.Event;
+    mousedown: Tg.MouseEvent;
+    mouseup: Tg.MouseEvent;
+    mouseout: Tg.MouseEvent;
+    mouseover: Tg.MouseEvent;
+};
+export interface PolylineOptions extends NotFillableShapeOptions {
+    path: LatLng[];
+}
+export interface Polyline extends Tg.EventTargetTyped<Polyline, PolylineEventMap>, NotFillableShape {
+    getPath(): LatLng[];
+    setPath(path: LatLng[]): void;
+}
+export type PolylineOverlay = Polyline & Overlay;
+export declare class BaiduPolyline extends BaiduShape<BMap.Polyline> implements Polyline {
+    static create(this: BaiduMap, options: PolylineOptions): BaiduPolyline;
+    getPath(): LatLng[];
+    setPath(path: LatLng[]): void;
+}
+export declare class GooglePolyline extends GoogleShape<google.maps.Polyline> implements Polyline {
+    static create(this: GoogleMap, options: PolylineOptions): GooglePolyline;
+    getPath(): LatLng[];
+    setPath(path: LatLng[]): void;
+}
+export {};

package/dist/src/map/map/overlay/shape.d.ts

@@ -0,0 +1,48 @@
+import { BaiduOverlay, GoogleOverlay, type OverlayOptions } from './overlay';
+import type { CoordType } from '../../lat-lng';
+import type { BaiduMap } from '../baidu-map';
+import type { UnionBaiduShape, UnionGoogleShape } from '../../unions';
+export interface ShapeOptions extends OverlayOptions {
+    clickable?: boolean;
+    editable?: boolean;
+    strokeColor?: string;
+    strokeOpacity?: number;
+    strokeWeight?: number;
+    fillColor?: string;
+    fillOpacity?: number;
+}
+export interface Shape {
+    isEditable(): boolean;
+    setEditable(editable: boolean): void;
+    setStrokeColor(color: string): void;
+    setStrokeOpacity(opacity: number): void;
+    setStrokeWeight(weight: number): void;
+    /** Polyline 没有该方法 */
+    setFillColor(color: string): void;
+    /** @see setFillColor */
+    setFillOpacity(opacity: number): void;
+}
+export type NotFillableShape = Omit<Shape, 'setFillColor' | 'setFillOpacity'>;
+export type NotFillableShapeOptions = Omit<ShapeOptions, 'fillColor' | 'fillOpacity'>;
+export declare abstract class BaiduShape<T extends UnionBaiduShape> extends BaiduOverlay<T> implements Shape {
+    private state;
+    constructor(innerOverlay: T, coordType: CoordType, map: BaiduMap, state: {
+        editable: boolean;
+    });
+    isEditable(): boolean;
+    setEditable(editable: boolean): void;
+    setStrokeColor(color: string): void;
+    setStrokeOpacity(opacity: number): void;
+    setStrokeWeight(weight: number): void;
+    setFillColor(color: string): void;
+    setFillOpacity(opacity: number): void;
+}
+export declare abstract class GoogleShape<T extends UnionGoogleShape> extends GoogleOverlay<T> implements Shape {
+    isEditable(): boolean;
+    setEditable(editable: boolean): void;
+    setStrokeColor(color: string): void;
+    setStrokeOpacity(opacity: number): void;
+    setStrokeWeight(weight: number): void;
+    setFillColor(color: string): void;
+    setFillOpacity(opacity: number): void;
+}

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

@@ -0,0 +1,14 @@
+import type { DeepPartial } from '../utils/mapped-types';
+export interface MapConfig {
+    version: string;
+    key: string;
+    language: string;
+}
+export interface TgMapConfig {
+    google: MapConfig;
+    baidu: MapConfig;
+    here: MapConfig;
+}
+export type PartialTgMapConfig = DeepPartial<TgMapConfig>;
+export declare function getTgMapConfig(): TgMapConfig;
+export declare function setTgMapConfig(config?: PartialTgMapConfig): void;

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

@@ -0,0 +1,10 @@
+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

@@ -0,0 +1,5 @@
+import type { MapConfig } from './map-config';
+import { TgMapType } from './map-factory';
+export declare function loadMap(type: TgMapType, config: MapConfig): Promise<unknown>;
+export declare function loadJsonp(url: string, callbackParamName?: string): Promise<unknown>;
+export declare function loadJs(url: string): Promise<unknown>;

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

@@ -0,0 +1,17 @@
+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

@@ -0,0 +1,19 @@
+/// <reference types="googlemaps" />
+/// <reference types="heremaps" />
+/// <reference types="baidumap-web-sdk" />
+import type { GoogleLabel } from './map/overlay/google-label';
+import type { BaiduInfoBox } from './map/overlay/baidu-info-box';
+/**
+ * Map相关的各种类型的联合, 可以用来简化一部分代码的书写
+ */
+export type UnionMap = google.maps.Map | BMap.Map | H.Map;
+export type UnionIcon = google.maps.Icon | google.maps.Symbol | google.maps.UrlIcon | BMap.Icon;
+export type UnionInfoWindow = google.maps.InfoWindow | BMap.InfoWindow;
+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.Map;
+export type UnionBaiduShape = BMap.Polyline | BMap.Polygon | BMap.Circle;
+export type UnionGoogleShape = google.maps.Polyline | google.maps.Polygon | google.maps.Circle;
+export type UnionControl = BMap.Control | Node;
+export type GoogleLayer = google.maps.TrafficLayer | google.maps.TransitLayer | google.maps.KmlLayer | google.maps.BicyclingLayer;

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

@@ -0,0 +1,10 @@
+/// <reference types="googlemaps" />
+import type { Constructor } from '../components';
+export declare namespace Arrays {
+    function remove<T>(arr: T[], item: T): T | undefined;
+    function findByType<T>(arr: any[], constructor: Constructor<T>): 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;
+}

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

@@ -0,0 +1,9 @@
+/**
+ * typescript 3.7 的新特性[Assertion Functions](https://github.com/microsoft/TypeScript/issues/33352)
+ * */
+export declare function assert(condition: any, msg?: string): asserts condition;
+/**
+ * 可以用来防止switch时少写case
+ * @see https://www.zhihu.com/question/354601204
+ */
+export declare function assertNever(x: never): never;

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

@@ -0,0 +1,5 @@
+/**
+ * 3.0版的Overlay是类
+ * @see http://lbsyun.baidu.com/cms/jsapi/reference/jsapi_reference_3_0.html#a3b0
+ */
+export declare function ensureBaiduV3(): void;

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

@@ -0,0 +1,4 @@
+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

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

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

@@ -0,0 +1,10 @@
+/**
+ * 最新是3.1版, 但@types/heremaps和以前的项目都用的是3.0版, 故当前先用3.0...
+ * TODO: 改成使用3.1版实现
+ **/
+export declare const HERE_SUPPORTED_VERSIONS: string[];
+/**
+ * 当前@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/lifecycle-log.d.ts

@@ -0,0 +1,14 @@
+import { type App } from './@vue/compat';
+import type { VueHookName } from './vue-utils';
+export interface LifecycleLogOptions {
+    /** @default /^[A-Z]/ 匹配大写字母开头的组件名 */
+    nameRegex?: RegExp;
+    /** @default true 开启log */
+    enable?: boolean;
+    /** @default >> 除 updated, beforeUpdate 外的所有hook */
+    hookNames?: VueHookName[];
+}
+declare const LifecycleLogPlugin: {
+    install(app: App, options?: LifecycleLogOptions): void;
+};
+export default LifecycleLogPlugin;

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

@@ -0,0 +1,60 @@
+import type { Component, ComponentPublicInstance } from './@vue/compat';
+/** deep版的 `Partial` */
+export type DeepPartial<T> = {
+    [U in keyof T]?: T[U] extends object ? DeepPartial<T[U]> : T[U];
+};
+/**
+ * 表示一个构造器
+ * {@link import('./@vue/compat/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;
+/**
+ * 返回undefined但类型是指定的泛型T, 需要你自身保证在使用前先初始化
+ * 模仿了kotlin的lateinit关键字
+ * */
+export declare function lateinit<T>(): T;
+/** 用来给纯对象的成员加上类型验证 */
+export declare function typed<T>(t: T): 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;
+/** 安全转换组件类型, 若不能转换会返回`undefined` */
+export declare function safeAsComponent<C extends Component & AbstractConstructor>(instance: ComponentPublicInstance | null, component: C): 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;
+};
+/**
+ * 非空的值
+ * @see https://github.com/microsoft/TypeScript/issues/7648#issuecomment-541625573
+ */
+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

@@ -0,0 +1,13 @@
+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;
+}
+/** 用于替代Vue2中的filter, 直接交给模板使用 */
+export declare const stringify: typeof Objects.toJsonSafely;

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

@@ -0,0 +1,9 @@
+import type { StringEnumLike } from './mapped-types';
+export declare namespace Strings {
+    /**
+    * 将string转换成字符枚举, 转换失败返回undefined
+    * @see import('./vue-utils.ts').stringEnumProp 由于使用了Object.values(enumObject), 应该避免在enumObject上添加其他属性/方法
+    */
+    function toEnumOrNull<E extends StringEnumLike>(value: string | undefined, enumObject: E): E[keyof E] | undefined;
+    function trimIndent(str: string): string;
+}

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

@@ -0,0 +1,9 @@
+/** 抛异常是语句不是表达式, 使用该方法替换则可以在表达式中使用 */
+export declare function throwError(msg?: string): never;
+export declare function throwUnsupported(msg?: string): never;
+export declare function todo(msg?: string): never;
+export declare function debug(msg?: any): any;
+/** 啥也不做 */
+export declare function noop(...args: any[]): void;
+/** 可以用在Array.filter(isDef)中, 用来过滤为空的值 */
+export declare function isDef<T>(v: T | undefined | null): v is T;

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

@@ -0,0 +1,34 @@
+/** 键值对 */
+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;
+}