vesium 1.0.1-beta.54 → 1.0.1-beta.59

package/README.md

@@ -32,7 +32,7 @@
 
 ## Documentation
 
-To view the documentation, visit <a href="https://vesium.geovue.org" target="__blank">cesium.geovue.org</a>
+To view the documentation, visit <a href="https://vesium.js.org" target="__blank">vesium.js.org</a>
 
 ## Features
 

package/dist/index.cjs

@@ -1,34 +1,7 @@
-//#region rolldown:runtime
-var __create = Object.create;
-var __defProp = Object.defineProperty;
-var __getOwnPropDesc = Object.getOwnPropertyDescriptor;
-var __getOwnPropNames = Object.getOwnPropertyNames;
-var __getProtoOf = Object.getPrototypeOf;
-var __hasOwnProp = Object.prototype.hasOwnProperty;
-var __copyProps = (to, from, except, desc) => {
-	if (from && typeof from === "object" || typeof from === "function") for (var keys = __getOwnPropNames(from), i = 0, n = keys.length, key; i < n; i++) {
-		key = keys[i];
-		if (!__hasOwnProp.call(to, key) && key !== except) __defProp(to, key, {
-			get: ((k) => from[k]).bind(null, key),
-			enumerable: !(desc = __getOwnPropDesc(from, key)) || desc.enumerable
-		});
-	}
-	return to;
-};
-var __toESM = (mod, isNodeMode, target) => (target = mod != null ? __create(__getProtoOf(mod)) : {}, __copyProps(isNodeMode || !mod || !mod.__esModule ? __defProp(target, "default", {
-	value: mod,
-	enumerable: true
-}) : target, mod));
-
-//#endregion
-let __vueuse_core = require("@vueuse/core");
-__vueuse_core = __toESM(__vueuse_core);
+let _vueuse_core = require("@vueuse/core");
 let cesium = require("cesium");
-cesium = __toESM(cesium);
 let vue = require("vue");
-vue = __toESM(vue);
-let __vesium_shared = require("@vesium/shared");
-__vesium_shared = __toESM(__vesium_shared);
+let _vesium_shared = require("@vesium/shared");
 
 //#region createViewer/index.ts
 /**
@@ -48,7 +21,7 @@ function createViewer(...args) {
 	const scope = (0, vue.getCurrentScope)();
 	if (scope) CREATE_VIEWER_COLLECTION.set(scope, readonlyViewer);
 	const canvas = (0, vue.computed)(() => viewer.value?.canvas);
-	(0, __vueuse_core.useMutationObserver)(document?.body, () => {
+	(0, _vueuse_core.useMutationObserver)(document?.body, () => {
 		if (canvas.value && !document?.body.contains(canvas.value)) viewer.value = void 0;
 	}, {
 		childList: true,
@@ -63,7 +36,7 @@ function createViewer(...args) {
 			onCleanup(() => !viewer.value?.isDestroyed() && viewer.value?.destroy());
 		} else viewer.value = void 0;
 	});
-	(0, __vueuse_core.tryOnScopeDispose)(() => {
+	(0, _vueuse_core.tryOnScopeDispose)(() => {
 		viewer.value = void 0;
 	});
 	return (0, vue.computed)(() => {
@@ -95,10 +68,10 @@ async function toPromiseValue(source, options = {}) {
 	try {
 		const { raw = true } = options;
 		let value;
-		if ((0, __vesium_shared.isFunction)(source)) value = await source();
+		if ((0, _vesium_shared.isFunction)(source)) value = await source();
 		else {
 			const result = (0, vue.toValue)(source);
-			value = (0, __vesium_shared.isPromise)(result) ? await result : result;
+			value = (0, _vesium_shared.isPromise)(result) ? await result : result;
 		}
 		return raw ? (0, vue.toRaw)(value) : value;
 	} catch (error) {
@@ -134,7 +107,7 @@ function useCesiumEventListener(event, listener, options = {}) {
 			}
 		}
 	});
-	(0, __vueuse_core.tryOnScopeDispose)(cleanup.stop);
+	(0, _vueuse_core.tryOnScopeDispose)(cleanup.stop);
 	return cleanup.stop;
 }
 
@@ -176,7 +149,7 @@ function useCameraState(options = {}) {
 		const eventField = (0, vue.toValue)(options.event) || "changed";
 		return camera.value?.[eventField];
 	});
-	const changedSymbol = (0, __vueuse_core.refThrottled)((0, vue.shallowRef)(Symbol("camera change")), options.delay ?? 8, true, false);
+	const changedSymbol = (0, _vueuse_core.refThrottled)((0, vue.shallowRef)(Symbol("camera change")), options.delay ?? 8, true, false);
 	const setChangedSymbol = () => {
 		changedSymbol.value = Symbol("camera change");
 	};
@@ -224,7 +197,7 @@ function useCesiumFps(options = {}) {
 	const p = (0, vue.shallowRef)(performance.now());
 	useCesiumEventListener(() => viewer.value?.scene.postRender, () => p.value = performance.now());
 	const interval = (0, vue.ref)(0);
-	(0, __vueuse_core.watchThrottled)(p, (value, oldValue) => {
+	(0, _vueuse_core.watchThrottled)(p, (value, oldValue) => {
 		interval.value = value - oldValue;
 	}, { throttle: delay });
 	const fps = (0, vue.computed)(() => {
@@ -248,7 +221,7 @@ function useCollectionScope(options) {
 	const scope = (0, vue.shallowReactive)(/* @__PURE__ */ new Set());
 	const add = (instance, ...args) => {
 		const result = addEffect(instance, ...args);
-		if ((0, __vesium_shared.isPromise)(result)) return new Promise((resolve, reject) => {
+		if ((0, _vesium_shared.isPromise)(result)) return new Promise((resolve, reject) => {
 			result.then((i) => {
 				scope.add(i);
 				resolve(i);
@@ -273,7 +246,7 @@ function useCollectionScope(options) {
 			remove(instance, ...args);
 		});
 	};
-	(0, __vueuse_core.tryOnScopeDispose)(() => removeScope(...removeScopeArgs));
+	(0, _vueuse_core.tryOnScopeDispose)(() => removeScope(...removeScopeArgs));
 	return {
 		scope: (0, vue.shallowReadonly)(scope),
 		add,
@@ -287,7 +260,7 @@ function useCollectionScope(options) {
 //#region useDataSource/index.ts
 function useDataSource(dataSources, options = {}) {
 	const { destroyOnRemove, collection, isActive = true, evaluating } = options;
-	const result = (0, __vueuse_core.computedAsync)(() => toPromiseValue(dataSources), void 0, { evaluating });
+	const result = (0, _vueuse_core.computedAsync)(() => toPromiseValue(dataSources), void 0, { evaluating });
 	const viewer = useViewer();
 	(0, vue.watchEffect)((onCleanup) => {
 		if ((0, vue.toValue)(isActive)) {
@@ -317,7 +290,7 @@ function useDataSourceScope(options = {}) {
 	return useCollectionScope({
 		addEffect(instance) {
 			if (!collection.value) throw new Error("collection is not defined");
-			if ((0, __vesium_shared.isPromise)(instance)) return new Promise((resolve, reject) => {
+			if ((0, _vesium_shared.isPromise)(instance)) return new Promise((resolve, reject) => {
 				instance.then((i) => {
 					collection.value.add(i);
 					resolve(i);
@@ -341,23 +314,32 @@ function useDataSourceScope(options = {}) {
 * Cesium HtmlElement Overlay
 */
 function useElementOverlay(target, position, options = {}) {
-	const { referenceWindow, horizontal = "center", vertical = "bottom", offset = {
+	const { referenceWindow, horizontal = "center", vertical = "bottom", clampToGround, offset = {
 		x: 0,
 		y: 0
 	} } = options;
-	const cartesian3 = (0, vue.computed)(() => (0, __vesium_shared.toCartesian3)((0, vue.toValue)(position)));
 	const viewer = useViewer();
+	const cartesian3 = (0, vue.computed)(() => {
+		const positionValue = (0, vue.toValue)(position);
+		if (!positionValue) return;
+		else if (!(0, vue.toValue)(clampToGround)) return (0, _vesium_shared.toCartesian3)(positionValue);
+		else {
+			const cartographic = (0, _vesium_shared.toCartographic)((0, vue.toValue)(positionValue));
+			cartographic.height = +(viewer.value?.scene.globe.getHeight(cartographic) || 0).toFixed(2);
+			return (0, _vesium_shared.toCartesian3)(cartographic);
+		}
+	});
 	const coord = (0, vue.shallowRef)();
 	useCesiumEventListener(() => viewer.value?.scene.postRender, () => {
 		if (!viewer.value?.scene) return;
 		if (!cartesian3.value) coord.value = void 0;
 		else {
-			const result = (0, __vesium_shared.cartesianToCanvasCoord)(cartesian3.value, viewer.value.scene);
+			const result = (0, _vesium_shared.cartesianToCanvasCoord)(cartesian3.value, viewer.value.scene);
 			coord.value = !cesium.Cartesian2.equals(result, coord.value) ? result : coord.value;
 		}
 	});
-	const canvasBounding = (0, __vueuse_core.useElementBounding)(() => viewer.value?.canvas.parentElement);
-	const targetBounding = (0, __vueuse_core.useElementBounding)(target);
+	const canvasBounding = (0, _vueuse_core.useElementBounding)(() => viewer.value?.canvas.parentElement);
+	const targetBounding = (0, _vueuse_core.useElementBounding)(target);
 	const finalOffset = (0, vue.computed)(() => {
 		const _offset = (0, vue.toValue)(offset);
 		let x$1 = _offset?.x ?? 0;
@@ -411,7 +393,7 @@ function useElementOverlay(target, position, options = {}) {
 //#region useEntity/index.ts
 function useEntity(data, options = {}) {
 	const { collection, isActive = true, evaluating } = options;
-	const result = (0, __vueuse_core.computedAsync)(() => toPromiseValue(data), [], { evaluating });
+	const result = (0, _vueuse_core.computedAsync)(() => toPromiseValue(data), [], { evaluating });
 	const viewer = useViewer();
 	(0, vue.watchEffect)((onCleanup) => {
 		if ((0, vue.toValue)(isActive)) {
@@ -441,7 +423,7 @@ function useEntityScope(options = {}) {
 	return useCollectionScope({
 		addEffect(instance) {
 			if (!collection.value) throw new Error("collection is not defined");
-			if ((0, __vesium_shared.isPromise)(instance)) return new Promise((resolve, reject) => {
+			if ((0, _vesium_shared.isPromise)(instance)) return new Promise((resolve, reject) => {
 				instance.then((i) => {
 					collection.value.add(i);
 					resolve(i);
@@ -472,7 +454,7 @@ function useScenePick(windowPosition, options = {}) {
 	const { width = 3, height = 3, throttled = 8 } = options;
 	const isActive = (0, vue.toRef)(options.isActive ?? true);
 	const viewer = useViewer();
-	const position = (0, __vueuse_core.refThrottled)((0, vue.computed)(() => (0, vue.toValue)(windowPosition)?.clone()), throttled, false, true);
+	const position = (0, _vueuse_core.refThrottled)((0, vue.computed)(() => (0, vue.toValue)(windowPosition)?.clone()), throttled, false, true);
 	const pick = (0, vue.shallowRef)();
 	(0, vue.watchEffect)(() => {
 		if (viewer.value && position.value && isActive.value) {
@@ -512,7 +494,7 @@ function useScreenSpaceEventHandler(type, inputAction, options = {}) {
 		const modifierValue = (0, vue.toValue)(modifier);
 		const handlerValue = (0, vue.toValue)(handler);
 		if (!handlerValue || !isActive.value || !inputAction) return;
-		if ((0, __vesium_shared.isDef)(typeValue)) {
+		if ((0, _vesium_shared.isDef)(typeValue)) {
 			handlerValue.setInputAction(inputAction, typeValue, modifierValue);
 			onCleanup(() => handlerValue.removeInputAction(typeValue, modifierValue));
 		}
@@ -521,7 +503,7 @@ function useScreenSpaceEventHandler(type, inputAction, options = {}) {
 		cleanup1();
 		cleanup2();
 	};
-	(0, __vueuse_core.tryOnScopeDispose)(stop);
+	(0, _vueuse_core.tryOnScopeDispose)(stop);
 	return stop;
 }
 
@@ -561,7 +543,7 @@ function useDrag(listener) {
 		dragging.value = true;
 		position.value = event.position.clone();
 	});
-	const stopMouseMoveWatch = useScreenSpaceEventHandler(cesium.ScreenSpaceEventType.MOUSE_MOVE, (0, __vesium_shared.throttle)(({ startPosition, endPosition }) => {
+	const stopMouseMoveWatch = useScreenSpaceEventHandler(cesium.ScreenSpaceEventType.MOUSE_MOVE, (0, _vesium_shared.throttle)(({ startPosition, endPosition }) => {
 		motionEvent.value = {
 			startPosition: motionEvent.value?.endPosition.clone() || startPosition.clone(),
 			endPosition: endPosition.clone()
@@ -584,7 +566,7 @@ function useDrag(listener) {
 		stopMouseMoveWatch();
 		stopLeftUpWatch();
 	};
-	(0, __vueuse_core.tryOnScopeDispose)(stop);
+	(0, _vueuse_core.tryOnScopeDispose)(stop);
 	return stop;
 }
 
@@ -699,15 +681,15 @@ function useGraphicEvent() {
 		eventTypeMap.get(type) ?? eventTypeMap.set(type, /* @__PURE__ */ new Set());
 		eventTypeMap.get(type).add(listener);
 		let { cursor = "pointer", dragCursor } = options;
-		if ((0, __vesium_shared.isDef)(cursor)) {
-			const _cursor = (0, __vesium_shared.isFunction)(cursor) ? cursor : () => cursor;
+		if ((0, _vesium_shared.isDef)(cursor)) {
+			const _cursor = (0, _vesium_shared.isFunction)(cursor) ? cursor : () => cursor;
 			cursorCollection.get(_graphic) ?? cursorCollection.set(_graphic, /* @__PURE__ */ new Map());
 			cursorCollection.get(_graphic).get(type) ?? cursorCollection.get(_graphic).set(type, /* @__PURE__ */ new Map());
 			cursorCollection.get(_graphic).get(type).set(listener, _cursor);
 		}
 		if (type === "DRAG") dragCursor ??= ((event) => event?.dragging ? "crosshair" : void 0);
-		if ((0, __vesium_shared.isDef)(dragCursor)) {
-			const _dragCursor = (0, __vesium_shared.isFunction)(dragCursor) ? dragCursor : () => dragCursor;
+		if ((0, _vesium_shared.isDef)(dragCursor)) {
+			const _dragCursor = (0, _vesium_shared.isFunction)(dragCursor) ? dragCursor : () => dragCursor;
 			dragCursorCollection.get(_graphic) ?? dragCursorCollection.set(_graphic, /* @__PURE__ */ new Map());
 			dragCursorCollection.get(_graphic).get(type) ?? dragCursorCollection.get(_graphic).set(type, /* @__PURE__ */ new Map());
 			dragCursorCollection.get(_graphic).get(type).set(listener, _dragCursor);
@@ -730,31 +712,31 @@ function useGraphicEvent() {
 		if (dragCursorCollection?.get(_graphic)?.size === 0) dragCursorCollection?.delete(_graphic);
 	};
 	for (const type of POSITIONED_EVENT_TYPES) usePositioned(type, (event) => {
-		(0, __vesium_shared.resolvePick)(event.pick).concat(GLOBAL_GRAPHIC_SYMBOL).forEach((graphic) => {
-			collection.get(graphic)?.get(type)?.forEach((fn) => (0, __vesium_shared.tryRun)(fn)?.(event));
+		(0, _vesium_shared.resolvePick)(event.pick).concat(GLOBAL_GRAPHIC_SYMBOL).forEach((graphic) => {
+			collection.get(graphic)?.get(type)?.forEach((fn) => (0, _vesium_shared.tryRun)(fn)?.(event));
 		});
 	});
 	const dragging = (0, vue.ref)(false);
 	const viewer = useViewer();
 	useHover((event) => {
-		(0, __vesium_shared.resolvePick)(event.pick).concat(GLOBAL_GRAPHIC_SYMBOL).forEach((graphic) => {
-			collection.get(graphic)?.get("HOVER")?.forEach((fn) => (0, __vesium_shared.tryRun)(fn)?.(event));
+		(0, _vesium_shared.resolvePick)(event.pick).concat(GLOBAL_GRAPHIC_SYMBOL).forEach((graphic) => {
+			collection.get(graphic)?.get("HOVER")?.forEach((fn) => (0, _vesium_shared.tryRun)(fn)?.(event));
 			if (!dragging.value) cursorCollection.get(graphic)?.forEach((map) => {
 				map.forEach((fn) => {
-					const cursor = event.hovering ? (0, __vesium_shared.tryRun)(fn)(event) : "";
+					const cursor = event.hovering ? (0, _vesium_shared.tryRun)(fn)(event) : "";
 					viewer.value?.canvas.style?.setProperty("cursor", cursor);
 				});
 			});
 		});
 	});
 	useDrag((event) => {
-		const graphics = (0, __vesium_shared.resolvePick)(event.pick).concat(GLOBAL_GRAPHIC_SYMBOL);
+		const graphics = (0, _vesium_shared.resolvePick)(event.pick).concat(GLOBAL_GRAPHIC_SYMBOL);
 		dragging.value = event.dragging;
 		graphics.forEach((graphic) => {
-			collection.get(graphic)?.get("DRAG")?.forEach((fn) => (0, __vesium_shared.tryRun)(fn)(event));
+			collection.get(graphic)?.get("DRAG")?.forEach((fn) => (0, _vesium_shared.tryRun)(fn)(event));
 			dragCursorCollection.get(graphic)?.forEach((map) => {
 				map.forEach((fn) => {
-					const cursor = event.dragging ? (0, __vesium_shared.tryRun)(fn)(event) : "";
+					const cursor = event.dragging ? (0, _vesium_shared.tryRun)(fn)(event) : "";
 					viewer.value?.canvas.style?.setProperty("cursor", cursor);
 				});
 			});
@@ -771,7 +753,7 @@ function useGraphicEvent() {
 //#region useImageryLayer/index.ts
 function useImageryLayer(data, options = {}) {
 	const { destroyOnRemove, collection, isActive = true, evaluating } = options;
-	const result = (0, __vueuse_core.computedAsync)(() => toPromiseValue(data), [], { evaluating });
+	const result = (0, _vueuse_core.computedAsync)(() => toPromiseValue(data), [], { evaluating });
 	const viewer = useViewer();
 	(0, vue.watchEffect)((onCleanup) => {
 		if ((0, vue.toValue)(isActive)) {
@@ -813,7 +795,7 @@ function useImageryLayerScope(options = {}) {
 	return useCollectionScope({
 		addEffect(instance, index) {
 			if (!collection.value) throw new Error("collection is not defined");
-			if ((0, __vesium_shared.isPromise)(instance)) return new Promise((resolve, reject) => {
+			if ((0, _vesium_shared.isPromise)(instance)) return new Promise((resolve, reject) => {
 				instance.then((i) => {
 					collection.value.add(i, index);
 					resolve(i);
@@ -835,7 +817,7 @@ function useImageryLayerScope(options = {}) {
 //#region usePostProcessStage/index.ts
 function usePostProcessStage(data, options = {}) {
 	const { collection, isActive = true, evaluating } = options;
-	const result = (0, __vueuse_core.computedAsync)(() => toPromiseValue(data), void 0, { evaluating });
+	const result = (0, _vueuse_core.computedAsync)(() => toPromiseValue(data), void 0, { evaluating });
 	const viewer = useViewer();
 	(0, vue.watchEffect)((onCleanup) => {
 		if (!viewer.value) return;
@@ -866,7 +848,7 @@ function usePostProcessStageScope(options = {}) {
 	return useCollectionScope({
 		addEffect(instance) {
 			if (!collection.value) throw new Error("collection is not defined");
-			if ((0, __vesium_shared.isPromise)(instance)) return new Promise((resolve, reject) => {
+			if ((0, _vesium_shared.isPromise)(instance)) return new Promise((resolve, reject) => {
 				instance.then((instance$1) => {
 					collection.value.add(instance$1);
 					resolve(instance$1);
@@ -885,7 +867,7 @@ function usePostProcessStageScope(options = {}) {
 //#region usePrimitive/index.ts
 function usePrimitive(data, options = {}) {
 	const { collection, isActive = true, evaluating } = options;
-	const result = (0, __vueuse_core.computedAsync)(() => toPromiseValue(data), void 0, { evaluating });
+	const result = (0, _vueuse_core.computedAsync)(() => toPromiseValue(data), void 0, { evaluating });
 	const viewer = useViewer();
 	(0, vue.watchEffect)((onCleanup) => {
 		if ((0, vue.toValue)(isActive)) {
@@ -916,7 +898,7 @@ function usePrimitiveScope(options = {}) {
 	const { scope, add, remove, removeWhere, removeScope } = useCollectionScope({
 		addEffect(instance, ...args) {
 			if (!collection.value) throw new Error("collection is not defined");
-			if ((0, __vesium_shared.isPromise)(instance)) return new Promise((resolve, reject) => {
+			if ((0, _vesium_shared.isPromise)(instance)) return new Promise((resolve, reject) => {
 				instance.then((instance$1) => resolve(collection.value.add(instance$1, ...args))).catch((error) => reject(error));
 			});
 			else return collection.value.add(instance, ...args);
@@ -982,7 +964,7 @@ function useScaleBar(options = {}) {
 	const { maxPixel = 80, delay = 8 } = options;
 	const maxPixelRef = (0, vue.computed)(() => (0, vue.toValue)(maxPixel));
 	const viewer = useViewer();
-	const canvasSize = (0, __vueuse_core.useElementSize)(() => viewer.value?.canvas);
+	const canvasSize = (0, _vueuse_core.useElementSize)(() => viewer.value?.canvas);
 	const pixelDistance = (0, vue.ref)();
 	const setPixelDistance = async () => {
 		await (0, vue.nextTick)();
@@ -996,8 +978,8 @@ function useScaleBar(options = {}) {
 		if (!leftPosition || !rightPosition) return;
 		pixelDistance.value = new cesium.EllipsoidGeodesic(scene.globe.ellipsoid.cartesianToCartographic(leftPosition), scene.globe.ellipsoid.cartesianToCartographic(rightPosition)).surfaceDistance;
 	};
-	(0, __vueuse_core.watchImmediate)(viewer, () => setPixelDistance());
-	useCesiumEventListener(() => viewer.value?.camera.changed, (0, __vesium_shared.throttle)(setPixelDistance, delay));
+	(0, _vueuse_core.watchImmediate)(viewer, () => setPixelDistance());
+	useCesiumEventListener(() => viewer.value?.camera.changed, (0, _vesium_shared.throttle)(setPixelDistance, delay));
 	const distance = (0, vue.computed)(() => {
 		if (pixelDistance.value) return distances.find((item) => pixelDistance.value * maxPixelRef.value > item);
 	});
@@ -1027,7 +1009,7 @@ function useScaleBar(options = {}) {
 function useSceneDrillPick(windowPosition, options = {}) {
 	const { width = 3, height = 3, limit, throttled = 8, isActive = true } = options;
 	const viewer = useViewer();
-	const position = (0, __vueuse_core.refThrottled)((0, vue.computed)(() => (0, vue.toValue)(windowPosition)), throttled, false, true);
+	const position = (0, _vueuse_core.refThrottled)((0, vue.computed)(() => (0, vue.toValue)(windowPosition)), throttled, false, true);
 	return (0, vue.computed)(() => {
 		if (position.value && (0, vue.toValue)(isActive)) return viewer.value?.scene.drillPick(position.value, (0, vue.toValue)(limit), (0, vue.toValue)(width), (0, vue.toValue)(height));
 	});
@@ -1059,10 +1041,10 @@ exports.useSceneDrillPick = useSceneDrillPick;
 exports.useScenePick = useScenePick;
 exports.useScreenSpaceEventHandler = useScreenSpaceEventHandler;
 exports.useViewer = useViewer;
-Object.keys(__vesium_shared).forEach(function (k) {
+Object.keys(_vesium_shared).forEach(function (k) {
   if (k !== 'default' && !Object.prototype.hasOwnProperty.call(exports, k)) Object.defineProperty(exports, k, {
     enumerable: true,
-    get: function () { return __vesium_shared[k]; }
+    get: function () { return _vesium_shared[k]; }
   });
 });