@cn-map/gaode-shared 0.0.0 → 0.0.1

package/LICENSE

@@ -1,21 +1,21 @@
-MIT License
-
-Copyright (c) 2024-present Jungzl.
-
-Permission is hereby granted, free of charge, to any person obtaining a copy
-of this software and associated documentation files (the "Software"), to deal
-in the Software without restriction, including without limitation the rights
-to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
-copies of the Software, and to permit persons to whom the Software is
-furnished to do so, subject to the following conditions:
-
-The above copyright notice and this permission notice shall be included in all
-copies or substantial portions of the Software.
-
-THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
-IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
-FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
-AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
-LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
-OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
-SOFTWARE.
+MIT License
+
+Copyright (c) 2024-present Jungzl.
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -1,6 +1,41 @@
 # @cn-map/gaode-shared
 
-高德地图 多框架共享代码。
+高德地图 monorepo 共享代码包，包含事件常量、补丁集合等多个模块。
 
-- 仓库：https://github.com/Jungzl/amap
-- 许可证：MIT
+## 安装
+
+```bash
+npm install @cn-map/gaode-shared
+```
+
+```bash
+yarn add @cn-map/gaode-shared
+```
+
+```bash
+pnpm add @cn-map/gaode-shared
+```
+
+```bash
+bun add @cn-map/gaode-shared
+```
+
+## 模块
+
+### Patch 补丁模块
+
+高德地图 JavaScript API 补丁集，解决原始 API 存在的问题。
+
+详细说明请查看 [Patch 补丁文档](./src/patch/README.md)
+
+### Const 常量模块
+
+事件常量和其他共享常量。
+
+```typescript
+import { complete, dragStart, hotspotClick } from '@cn-map/gaode-shared/const'
+```
+
+## 许可证
+
+[MIT](https://github.com/Jungzl/amap/blob/main/LICENSE)

package/dist/const/index.d.ts

@@ -0,0 +1,55 @@
+export declare const hotspotClick = "hotspotClick";
+export declare const hotspotOver = "hotspotOver";
+export declare const hotspotOut = "hotspotOut";
+export declare const dragStart = "dragStart";
+export declare const dragging = "dragging";
+export declare const dragEnd = "dragEnd";
+export declare const click = "click";
+export declare const dblClick = "dblClick";
+export declare const rightClick = "rightClick";
+export declare const mouseDown = "mouseDown";
+export declare const mouseUp = "mouseUp";
+export declare const mouseOver = "mouseOver";
+export declare const mouseOut = "mouseOut";
+export declare const mouseMove = "mouseMove";
+export declare const mouseWheel = "mouseWheel";
+export declare const touchStart = "touchStart";
+export declare const touchMove = "touchMove";
+export declare const touchEnd = "touchEnd";
+export declare const hide = "hide";
+export declare const show = "show";
+export declare const zoomStart = "zoomStart";
+export declare const zoomEnd = "zoomEnd";
+export declare const zoomChange = "zoomChange";
+export declare const pitchStart = "pitchStart";
+export declare const pitchEnd = "pitchEnd";
+export declare const pitchChange = "pitchChange";
+export declare const rotateStart = "rotateStart";
+export declare const rotateEnd = "rotateEnd";
+export declare const rotateChange = "rotateChange";
+export declare const mapMove = "mapMove";
+export declare const viewChange = "viewChange";
+export declare const resize = "resize";
+export declare const complete = "complete";
+export declare const error = "error";
+export declare const open = "open";
+export declare const close = "close";
+export declare const moveStart = "moveStart";
+export declare const moveEnd = "moveEnd";
+export declare const moving = "moving";
+export declare const moveAlong = "moveAlong";
+export declare const draw = "draw";
+export declare const select = "select";
+export declare const choose = "choose";
+export declare const add = "add";
+export declare const end = "end";
+export declare const addNode = "addNode";
+export declare const adjust = "adjust";
+export declare const removeNode = "removeNode";
+export declare const move = "move";
+export declare const selectChanged = "selectChanged";
+export declare const markerClick = "markerClick";
+export declare const listElementClick = "listElementClick";
+export declare const addWay = "addWay";
+export declare const floorChange = "floorChange";
+export declare const loaded = "loaded";

package/dist/const/index.js

@@ -0,0 +1,57 @@
+// src/const/index.ts
+const hotspotClick = "hotspotClick";
+const hotspotOver = "hotspotOver";
+const hotspotOut = "hotspotOut";
+const dragStart = "dragStart";
+const dragging = "dragging";
+const dragEnd = "dragEnd";
+const click = "click";
+const dblClick = "dblClick";
+const rightClick = "rightClick";
+const mouseDown = "mouseDown";
+const mouseUp = "mouseUp";
+const mouseOver = "mouseOver";
+const mouseOut = "mouseOut";
+const mouseMove = "mouseMove";
+const mouseWheel = "mouseWheel";
+const touchStart = "touchStart";
+const touchMove = "touchMove";
+const touchEnd = "touchEnd";
+const hide = "hide";
+const show = "show";
+const zoomStart = "zoomStart";
+const zoomEnd = "zoomEnd";
+const zoomChange = "zoomChange";
+const pitchStart = "pitchStart";
+const pitchEnd = "pitchEnd";
+const pitchChange = "pitchChange";
+const rotateStart = "rotateStart";
+const rotateEnd = "rotateEnd";
+const rotateChange = "rotateChange";
+const mapMove = "mapMove";
+const viewChange = "viewChange";
+const resize = "resize";
+const complete = "complete";
+const error = "error";
+const open = "open";
+const close = "close";
+const moveStart = "moveStart";
+const moveEnd = "moveEnd";
+const moving = "moving";
+const moveAlong = "moveAlong";
+const draw = "draw";
+const select = "select";
+const choose = "choose";
+const add = "add";
+const end = "end";
+const addNode = "addNode";
+const adjust = "adjust";
+const removeNode = "removeNode";
+const move = "move";
+const selectChanged = "selectChanged";
+const markerClick = "markerClick";
+const listElementClick = "listElementClick";
+const addWay = "addWay";
+const floorChange = "floorChange";
+const loaded = "loaded";
+export { add, addNode, addWay, adjust, choose, click, close, complete, dblClick, dragEnd, dragStart, dragging, draw, end, error, floorChange, hide, hotspotClick, hotspotOut, hotspotOver, listElementClick, loaded, mapMove, markerClick, mouseDown, mouseMove, mouseOut, mouseOver, mouseUp, mouseWheel, move, moveAlong, moveEnd, moveStart, moving, open, pitchChange, pitchEnd, pitchStart, removeNode, resize, rightClick, rotateChange, rotateEnd, rotateStart, select, selectChanged, show, touchEnd, touchMove, touchStart, viewChange, zoomChange, zoomEnd, zoomStart };

package/dist/index.d.ts

@@ -0,0 +1 @@
+export {}

package/dist/index.js

@@ -0,0 +1,2 @@
+// src/index.ts
+console.warn(`Please import from the subpath`);

package/dist/patch/context-menu.d.ts

@@ -0,0 +1,2 @@
+declare const patchContextMenu: () => void;
+export { patchContextMenu as default };

package/dist/patch/context-menu.js

@@ -0,0 +1,11 @@
+import { createPatchOnce } from "./utils.js";
+// src/patch/context-menu.ts
+let originalYy;
+function patch() {
+	originalYy = AMap.ContextMenu.prototype.Yy;
+	AMap.ContextMenu.prototype.Yy = function() {
+		return this.dom ?? originalYy.call(this);
+	};
+}
+const patchContextMenu = createPatchOnce("contextMenu", patch);
+export { patchContextMenu as default };

package/dist/patch/geobuffer-source.d.ts

@@ -0,0 +1,2 @@
+declare const patchGeoBufferSource: () => void;
+export { patchGeoBufferSource as default };

package/dist/patch/geobuffer-source.js

@@ -0,0 +1,57 @@
+import { createPatchOnce } from "./utils.js";
+// src/patch/geobuffer-source.ts
+let originalLoad;
+function patch() {
+	originalLoad = Loca.GeoBufferSource.prototype.load;
+	Loca.GeoBufferSource.prototype.load = function() {
+		if (this.status === "loaded" || this.status === "loading") return;
+		this._ac = new AbortController();
+		const signal = this._ac.signal;
+		this.status = "loading";
+		if (this.options.data) {
+			if (this.valid(this.options.data)) {
+				const u = this;
+				Promise.resolve().then(() => {
+					if (signal.aborted) return;
+					u.status = "unload";
+					originalLoad.call(u);
+				}).catch(() => {
+					if (!signal.aborted) u.status = "loaded";
+				});
+			}
+		} else {
+			const f = this;
+			const l = this.url;
+			if (!l) return;
+			fetch(l, { signal }).then((c) => {
+				if (signal.aborted) throw new DOMException("Aborted", "AbortError");
+				return c.arrayBuffer();
+			}).then((c) => {
+				if (signal.aborted) throw new DOMException("Aborted", "AbortError");
+				try {
+					delete f.options.url;
+					f.url = void 0;
+					f.options.data = c;
+					f.status = "unload";
+					originalLoad.call(f);
+				} catch (e) {
+					console.error("Error in processing data:", e);
+					if (!signal.aborted) f.status = "loaded";
+				} finally {
+					f.options.url = l;
+					f.url = l;
+					delete f.options.data;
+				}
+			}).catch((error) => {
+				if (error.name !== "AbortError" && !signal.aborted) f.status = "loaded";
+			});
+		}
+	};
+	Loca.GeoBufferSource.prototype.abort = function() {
+		this._ac?.abort();
+		delete this._ac;
+		this.status = "unload";
+	};
+}
+const patchGeoBufferSource = createPatchOnce("geoBufferSource", patch);
+export { patchGeoBufferSource as default };

package/dist/patch/geojson-source.d.ts

@@ -0,0 +1,2 @@
+declare const patchGeoJSONSource: () => void;
+export { patchGeoJSONSource as default };

package/dist/patch/geojson-source.js

@@ -0,0 +1,45 @@
+import { createPatchOnce } from "./utils.js";
+// src/patch/geojson-source.ts
+function patch() {
+	Loca.GeoJSONSource.prototype.load = function() {
+		if (this.status === "loaded" || this.status === "loading") return;
+		this._ac = new AbortController();
+		const signal = this._ac.signal;
+		this.status = "loading";
+		if (this.options.data) {
+			if (this.valid(this.options.data)) {
+				const o = this;
+				Promise.resolve().then(() => {
+					if (signal.aborted) return;
+					o.dataset = o.bf(this.options.data);
+					o.nf();
+				}).catch(() => {
+					if (!signal.aborted) o.status = "loaded";
+				});
+			}
+		} else {
+			const l = this;
+			const u = this.url;
+			if (!u) return;
+			fetch(u, { signal }).then((f) => {
+				if (signal.aborted) throw new DOMException("Aborted", "AbortError");
+				return f.json();
+			}).then((f) => {
+				if (signal.aborted) throw new DOMException("Aborted", "AbortError");
+				if (l.valid(f)) {
+					l.dataset = l.bf(f);
+					l.nf();
+				}
+			}).catch((error) => {
+				if (error.name !== "AbortError" && !signal.aborted) l.status = "loaded";
+			});
+		}
+	};
+	Loca.GeoJSONSource.prototype.abort = function() {
+		this._ac?.abort();
+		delete this._ac;
+		this.status = "unload";
+	};
+}
+const patchGeoJSONSource = createPatchOnce("geoJSONSource", patch);
+export { patchGeoJSONSource as default };

package/dist/patch/index.d.ts

@@ -0,0 +1,8 @@
+import patchContextMenu from "./context-menu.js";
+import patchGeoBufferSource from "./geobuffer-source.js";
+import patchGeoJSONSource from "./geojson-source.js";
+import patchLocaLayer from "./loca-layer.js";
+import patchMap from "./map.js";
+import patchPolygonEditor from "./polygon-editor.js";
+import { PatchConfig, getPatchConfig, setPatchConfig } from "./utils.js";
+export { type PatchConfig, getPatchConfig, patchContextMenu, patchGeoBufferSource, patchGeoJSONSource, patchLocaLayer, patchMap, patchPolygonEditor, setPatchConfig };

package/dist/patch/index.js

@@ -0,0 +1,8 @@
+import patchContextMenu from "./context-menu.js";
+import patchGeoBufferSource from "./geobuffer-source.js";
+import patchGeoJSONSource from "./geojson-source.js";
+import patchLocaLayer from "./loca-layer.js";
+import patchMap from "./map.js";
+import patchPolygonEditor from "./polygon-editor.js";
+import { getPatchConfig, setPatchConfig } from "./utils.js";
+export { getPatchConfig, patchContextMenu, patchGeoBufferSource, patchGeoJSONSource, patchLocaLayer, patchMap, patchPolygonEditor, setPatchConfig };

package/dist/patch/loca-layer.d.ts

@@ -0,0 +1,2 @@
+declare const patchLocaLayer: () => void;
+export { patchLocaLayer as default };

package/dist/patch/loca-layer.js

@@ -0,0 +1,13 @@
+import { createPatchOnce } from "./utils.js";
+// src/patch/loca-layer.ts
+function patch() {
+	Loca.Layer.prototype.setLoca = function() {
+		const a = arguments.length > 0 && arguments[0] !== void 0 ? arguments[0] : null;
+		const o = this.loca;
+		this.loca = a;
+		this.map = a ? a == null ? void 0 : a.map : null;
+		o && o.requestRender();
+	};
+}
+const patchLocaLayer = createPatchOnce("locaLayer", patch);
+export { patchLocaLayer as default };

package/dist/patch/map.d.ts

@@ -0,0 +1,2 @@
+declare const patchMap: () => void;
+export { patchMap as default };

package/dist/patch/map.js

@@ -0,0 +1,15 @@
+import { createPatchOnce } from "./utils.js";
+// src/patch/map.ts
+function patch() {
+	AMap.Map.prototype.addControl = function(t) {
+		t.addTo(this);
+	};
+	AMap.Map.prototype.removeControl = function(t) {
+		if (typeof t.remove === "function") t.remove();
+		else if (typeof t.removeFrom === "function") t.removeFrom(this);
+		const index = this.controls.indexOf(t);
+		if (index !== -1) this.controls.splice(index, 1);
+	};
+}
+const patchMap = createPatchOnce("map", patch);
+export { patchMap as default };

package/dist/patch/polygon-editor.d.ts

@@ -0,0 +1,2 @@
+declare const patchPolygonEditor: () => void;
+export { patchPolygonEditor as default };

package/dist/patch/polygon-editor.js

@@ -0,0 +1,14 @@
+import { createPatchOnce } from "./utils.js";
+// src/patch/polygon-editor.ts
+function patch() {
+	AMap.PolygonEditor.prototype.destroy = function() {
+		this.singleRingListHandle.forEach((ring) => {
+			return ring.destroy();
+		});
+		this.singleRingListHandle.clear();
+		if (this.editingPolyObj.poly) this.map.remove(this.editingPolyObj.poly);
+		delete this.editingPolyObj.poly;
+	};
+}
+const patchPolygonEditor = createPatchOnce("polygonEditor", patch);
+export { patchPolygonEditor as default };

package/dist/patch/utils.d.ts

@@ -0,0 +1,18 @@
+export interface PatchConfig {
+  map?: boolean;
+  contextMenu?: boolean;
+  locaLayer?: boolean;
+  geoJSONSource?: boolean;
+  geoBufferSource?: boolean;
+  polygonEditor?: boolean;
+}
+/**
+ * 获取当前补丁配置
+ */
+export declare function getPatchConfig(): Readonly<PatchConfig>;
+/**
+ * 设置补丁配置
+ * 注意：必须在任何组件加载或补丁应用之前调用
+ * 一旦某个补丁被检查，该补丁的配置即被锁定
+ */
+export declare function setPatchConfig(config: Partial<PatchConfig>): void;

package/dist/patch/utils.js

@@ -0,0 +1,49 @@
+// src/patch/utils.ts
+let globalPatchConfig = {
+	map: true,
+	contextMenu: true,
+	locaLayer: true,
+	geoJSONSource: true,
+	geoBufferSource: true,
+	polygonEditor: true
+};
+/**
+* 获取当前补丁配置
+*/
+function getPatchConfig() {
+	return { ...globalPatchConfig };
+}
+/**
+* 设置补丁配置
+* 注意：必须在任何组件加载或补丁应用之前调用
+* 一旦某个补丁被检查，该补丁的配置即被锁定
+*/
+function setPatchConfig(config) {
+	globalPatchConfig = {
+		...globalPatchConfig,
+		...config
+	};
+}
+/**
+* 创建补丁函数，确保补丁只会应用一次
+* 配置只在首次调用时读取，随后即锁定
+* @param patchName - PatchConfig 中定义的补丁名称
+* @param patchFn - 实际执行补丁逻辑的函数
+*/
+function createPatchOnce(patchName, patchFn) {
+	let checked = false;
+	return function applyPatch() {
+		if (checked) return;
+		if (globalPatchConfig[patchName] === false) {
+			checked = true;
+			return;
+		}
+		if (typeof AMap === "undefined") {
+			console.warn(`[gaode-patch] 高德地图未加载，${patchName} 补丁将被跳过`);
+			return;
+		}
+		patchFn();
+		checked = true;
+	};
+}
+export { createPatchOnce, getPatchConfig, setPatchConfig };

package/dist/types/index.d.ts

@@ -0,0 +1,36 @@
+/**
+ * 可能 `null` 类型
+ */
+export type Nullable<T> = T | null;
+/**
+ * 访问器
+ */
+export type Accessor<T> = () => T;
+/**
+ * 可能是访问器
+ */
+export type AccessorLike<T> = Accessor<T> | T;
+/**
+ * 地图事件转换为 prop 属性
+ * @example
+ * ```ts
+ * type Props = EventToProp<'click'>; // 'onClick'
+ * ```
+ */
+export type EventToProp<T extends AMap.EventType> = `on${Capitalize<T>}`;
+/**
+ * prop 属性转换为地图事件
+ * @example
+ * ```ts
+ * type Event = EventFromProp<'onClick'>; // 'click'
+ * ```
+ */
+export type EventFromProp<T extends EventToProp<AMap.EventType>> = T extends `on${infer U}` ? Uncapitalize<U> extends AMap.EventType ? Uncapitalize<U> : never : never;
+/**
+ * 地图事件属性
+ * @example
+ * ```ts
+ * type Props = MapEventProps<'click', any>; // { onClick?: AMap.EventCallback<'click', any> }
+ * ```
+ */
+export type MapEventProps<T extends AMap.EventType, U> = { [K in EventToProp<T>]?: AMap.EventCallback<EventFromProp<K>, U>; };

package/dist/utils/clone.d.ts

@@ -0,0 +1,10 @@
+/**
+ * 纯拷贝工具，不解代理：
+ * - 默认浅拷贝（拷贝顶层普通对象/数组，嵌套值保持引用）
+ * - `deep = true` 深拷贝（递归拷贝普通对象/数组）
+ * 类实例（LngLat / Pixel / Icon / HTMLElement / AMap 实例）与函数保持引用；
+ * 稀疏数组保留空槽；`seen` 处理循环引用。
+ * 需要解代理时请先调用各框架原生解代理 API（Vue `toRaw`/`toDefinedRaw`、
+ * Solid `unwrap`/`snapshot`、Svelte `snapshot`）。
+ */
+export declare function clone<T>(value: T, deep?: boolean): T;

package/dist/utils/clone.js

@@ -0,0 +1,48 @@
+// src/utils/clone.ts
+function isPlainObject(value) {
+	const proto = Object.getPrototypeOf(value);
+	return proto === Object.prototype || proto === null;
+}
+function isClassInstance(value) {
+	const proto = Object.getPrototypeOf(value);
+	return !!proto && proto !== Object.prototype && proto !== Array.prototype;
+}
+/**
+* 纯拷贝工具，不解代理：
+* - 默认浅拷贝（拷贝顶层普通对象/数组，嵌套值保持引用）
+* - `deep = true` 深拷贝（递归拷贝普通对象/数组）
+* 类实例（LngLat / Pixel / Icon / HTMLElement / AMap 实例）与函数保持引用；
+* 稀疏数组保留空槽；`seen` 处理循环引用。
+* 需要解代理时请先调用各框架原生解代理 API（Vue `toRaw`/`toDefinedRaw`、
+* Solid `unwrap`/`snapshot`、Svelte `snapshot`）。
+*/
+function clone(value, deep = false) {
+	return cloneInternal(value, deep, /* @__PURE__ */ new Map());
+}
+function cloneInternal(value, deep, seen) {
+	if (value == null || typeof value !== "object") return value;
+	if (isClassInstance(value)) return value;
+	if (Array.isArray(value)) {
+		const existing = seen.get(value);
+		if (existing !== void 0) return existing;
+		const copy = value.slice();
+		seen.set(value, copy);
+		if (deep) {
+			for (let i = 0; i < copy.length; i++) if (i in copy) copy[i] = cloneInternal(copy[i], true, seen);
+		}
+		return copy;
+	}
+	if (isPlainObject(value)) {
+		const existing = seen.get(value);
+		if (existing !== void 0) return existing;
+		const copy = {};
+		seen.set(value, copy);
+		for (const key of Object.keys(value)) {
+			const item = value[key];
+			copy[key] = deep ? cloneInternal(item, true, seen) : item;
+		}
+		return copy;
+	}
+	return value;
+}
+export { clone };

package/dist/utils/console.d.ts

@@ -0,0 +1,12 @@
+export declare class Logger {
+  silent: boolean;
+  LABEL: string;
+  SHARED_STYLES: string;
+  setSilent(value: boolean): void;
+  bgColor(color: string): string;
+  log(...args: any[]): void;
+  info(...args: any[]): void;
+  warn(...args: any[]): void;
+  error(...args: any[]): void;
+}
+export declare const logger: Logger;

package/dist/utils/console.js

@@ -0,0 +1,26 @@
+// src/utils/console.ts
+var Logger = class {
+	silent = false;
+	LABEL = "🌏 %c@cn-map/gaode";
+	SHARED_STYLES = "padding:1px 4px;color:white;border-radius:2px;";
+	setSilent(value) {
+		this.silent = value;
+	}
+	bgColor(color) {
+		return `${this.SHARED_STYLES}background:${color};`;
+	}
+	log(...args) {
+		if (!this.silent) console.log(this.LABEL, this.bgColor("silver"), ...args);
+	}
+	info(...args) {
+		if (!this.silent) console.info(this.LABEL, this.bgColor("steelblue"), ...args);
+	}
+	warn(...args) {
+		if (!this.silent) console.warn(this.LABEL, this.bgColor("darkorange"), ...args);
+	}
+	error(...args) {
+		if (!this.silent) console.error(this.LABEL, this.bgColor("crimson"), ...args);
+	}
+};
+const logger = new Logger();
+export { Logger, logger };

package/dist/utils/helpers.d.ts

@@ -0,0 +1,32 @@
+import { EventToProp } from "../types/index.js";
+/**
+ * Converts a string to lowercase.
+ * @param {string} str - The input string.
+ * @example
+ * lowercase('dblClick') // 'dblclick'
+ * @returns {string} The lowercase string.
+ */
+export declare function lowercase<T extends AMap.EventType>(str: T): Lowercase<T>;
+/**
+ * Converts an event type to a prop name.
+ * @param {AMap.EventType} eventType - The event type.
+ * @example
+ * eventToProp('click') // 'onClick'
+ * eventToProp('dblClick') // 'onDblClick'
+ * @returns {EventToProp<T>} The prop name.
+ */
+export declare function eventToProp<T extends AMap.EventType>(eventType: T): EventToProp<T>;
+/**
+ * Returns an array of event prop names for given events.
+ * @template T - The type of the event.
+ * @param {AMap.EventType[]} events - An array of event types.
+ * @example
+ * eventsToProps(['click', 'dblClick']) // ['onClick', 'onDblClick']
+ * @returns {EventToProp<T>[]} An array of event prop names.
+ */
+export declare function eventsToProps<T extends AMap.EventType>(events: T[]): EventToProp<T>[];
+/**
+ * Creates an error indicating that a required context is missing.
+ * @param {string} name - The name of the context that is missing.
+ */
+export declare function lostContextError(name: string): Error;

package/dist/utils/helpers.js

@@ -0,0 +1,51 @@
+// src/utils/helpers.ts
+/**
+* Converts a string to lowercase.
+* @param {string} str - The input string.
+* @example
+* lowercase('dblClick') // 'dblclick'
+* @returns {string} The lowercase string.
+*/
+function lowercase(str) {
+	return str.toLowerCase();
+}
+/**
+* Capitalizes the first letter of a string.
+* @param {string} str - The input string.
+* @example
+* capitalize('dblclick') // 'Dblclick'
+* @returns {string} The capitalized string.
+*/
+function capitalize(str) {
+	return str.charAt(0).toUpperCase() + str.slice(1);
+}
+/**
+* Converts an event type to a prop name.
+* @param {AMap.EventType} eventType - The event type.
+* @example
+* eventToProp('click') // 'onClick'
+* eventToProp('dblClick') // 'onDblClick'
+* @returns {EventToProp<T>} The prop name.
+*/
+function eventToProp(eventType) {
+	return `on${capitalize(eventType)}`;
+}
+/**
+* Returns an array of event prop names for given events.
+* @template T - The type of the event.
+* @param {AMap.EventType[]} events - An array of event types.
+* @example
+* eventsToProps(['click', 'dblClick']) // ['onClick', 'onDblClick']
+* @returns {EventToProp<T>[]} An array of event prop names.
+*/
+function eventsToProps(events) {
+	return events.map(eventToProp);
+}
+/**
+* Creates an error indicating that a required context is missing.
+* @param {string} name - The name of the context that is missing.
+*/
+function lostContextError(name) {
+	return /* @__PURE__ */ new Error(`缺少 ${name} 上下文，请确保在正确的上下文中使用组件或钩子`);
+}
+export { eventToProp, eventsToProps, lostContextError, lowercase };

package/dist/utils/index.d.ts

@@ -0,0 +1,4 @@
+import { clone } from "./clone.js";
+import { Logger, logger } from "./console.js";
+import { eventToProp, eventsToProps, lostContextError, lowercase } from "./helpers.js";
+export { Logger, clone, eventToProp, eventsToProps, logger, lostContextError, lowercase };

package/dist/utils/index.js

@@ -0,0 +1,4 @@
+import { clone } from "./clone.js";
+import { Logger, logger } from "./console.js";
+import { eventToProp, eventsToProps, lostContextError, lowercase } from "./helpers.js";
+export { Logger, clone, eventToProp, eventsToProps, logger, lostContextError, lowercase };

package/package.json

@@ -1,23 +1,89 @@
 {
   "name": "@cn-map/gaode-shared",
-  "version": "0.0.0",
+  "version": "0.0.1",
   "description": "高德地图 多框架共享代码",
   "keywords": [
     "amap",
     "高德地图"
   ],
+  "bugs": {
+    "url": "https://gtihub.com/Jungzl/amap/issues"
+  },
   "license": "MIT",
-  "author": "jungzl",
   "repository": {
     "type": "git",
     "url": "git+https://github.com/Jungzl/amap.git",
     "directory": "packages/shared"
   },
-  "bugs": {
-    "url": "https://github.com/Jungzl/amap/issues"
+  "files": [
+    "dist"
+  ],
+  "type": "module",
+  "sideEffects": false,
+  "main": "./dist/index.js",
+  "module": "./dist/index.js",
+  "types": "./dist/index.d.ts",
+  "typesVersions": {
+    "*": {
+      "const": [
+        "./dist/const/index.d.ts"
+      ],
+      "types": [
+        "./dist/types/index.d.ts"
+      ],
+      "patch": [
+        "./dist/patch/index.d.ts"
+      ],
+      "utils": [
+        "./dist/utils/index.d.ts"
+      ]
+    }
+  },
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "default": "./dist/index.js"
+    },
+    "./const": {
+      "types": "./dist/const/index.d.ts",
+      "default": "./dist/const/index.js"
+    },
+    "./types": {
+      "types": "./dist/types/index.d.ts",
+      "default": "./dist/types/index.js"
+    },
+    "./patch": {
+      "types": "./dist/patch/index.d.ts",
+      "default": "./dist/patch/index.js"
+    },
+    "./patch/*": {
+      "types": "./dist/patch/*.d.ts",
+      "default": "./dist/patch/*.js"
+    },
+    "./utils": {
+      "types": "./dist/utils/index.d.ts",
+      "default": "./dist/utils/index.js"
+    },
+    "./package.json": "./package.json"
+  },
+  "devDependencies": {
+    "@cn-map/gaode-types": "^2.1.0",
+    "vitest": "^5.1.0"
+  },
+  "peerDependencies": {
+    "@cn-map/gaode-types": "^2.0.0"
   },
-  "publishConfig": {
-    "access": "public"
+  "peerDependenciesMeta": {
+    "@cn-map/gaode-types": {
+      "optional": true
+    }
   },
-  "files": []
+  "scripts": {
+    "build": "tsdown",
+    "dev": "tsdown --watch",
+    "check:type": "tsc",
+    "test": "vitest run",
+    "test:unit": "vitest run -p unit",
+    "test:coverage": "vitest run --coverage --bail=1"
+  }
 }