@ericchen1990/pano-view 3.8.0 → 3.10.0

package/dist/data.d.mts

@@ -531,6 +531,17 @@ type ProjectHotspotDefinition = HotspotDefinition & {
 };
 declare function resolveHotspotAssets(hotspot: ProjectHotspotDefinition, baseUrl: string, sceneId: string, resolver?: AssetUrlResolver): ProjectHotspotDefinition;
 
+/**
+ * Shared drag inertia and edge bounce for map pan and scene-menu scrolling.
+ * Axis motion is pure; hosts own pointer capture and rAF loops.
+ */
+type PanoDragMotion = {
+    /** Continue sliding after release from pointer velocity. Defaults to true. */
+    inertia?: boolean;
+    /** Rubber-band past edges while dragging; spring back on release. Defaults to true. */
+    bounce?: boolean;
+};
+
 type PanoMapCorner = "top-left" | "top-right" | "bottom-left" | "bottom-right";
 type PanoMapGradientStop = {
     offset: number;
@@ -622,6 +633,11 @@ type PanoMapDefinition = {
      * Only applies when `interaction` is `"zoom"`. Defaults to 8.
      */
     maxScale?: number;
+    /**
+     * Pan inertia and edge bounce when `interaction` is `"zoom"`.
+     * Omit for both on; set `false` or flag fields to disable.
+     */
+    dragMotion?: PanoDragMotion | false;
     spots: PanoMapSpotDefinition[];
     sector?: PanoMapSectorDefinition;
 };
@@ -680,4 +696,4 @@ declare function parsePanoProject(value: unknown, options?: {
 }): PanoProjectDefinition;
 declare function loadPanoProject(source: string | PanoProjectDefinition, options?: LoadPanoProjectOptions): Promise<LoadedPanoProject>;
 
-export { type AssetUrlContext, type AssetUrlResolver, type CubemapViewerConfig, type JsonObject, type JsonRequestOptions, type JsonValue, type LoadPanoProjectOptions, type LoadSceneFromJsonOptions, type LoadedPanoProject, type LoadedProjectScene, PanoDataError, type PanoDataErrorCode, type PanoMapControlsDefinition, type PanoMapCorner, type PanoMapDefinition, type PanoMapDialogPresentation, type PanoMapDockedPresentation, type PanoMapGradientStop, type PanoMapPresentation, type PanoMapSectorDefinition, type PanoMapSectorGradient, type PanoMapSpotDefinition, type PanoProjectDefinition, type PanoProjectSceneDefinition, type PanoViewLimits, type PopupAssetUrlContext, type PopupAssetUrlResolver, type ProjectCustomHotspotAction, type ProjectHotspotAction, type ProjectHotspotDefinition, type ProjectHotspotTrigger, type ProjectPopupBlock, type ProjectPopupDefinition, type SceneFromViewerConfigOptions, type SphereViewerConfig, type ViewerConfig, type ViewerDocument, hotspotAction, loadPanoProject, loadSceneFromJson, parsePanoMap, parsePanoProject, projectHotspotTriggers, resolvePanoMapAssets, resolveHotspotAssets as resolveProjectHotspotAssets, resolveProjectPopupAssets, sceneFromViewerConfig, setHotspotAction };
+export { type AssetUrlContext, type AssetUrlResolver, type CubemapViewerConfig, type JsonObject, type JsonRequestOptions, type JsonValue, type LoadPanoProjectOptions, type LoadSceneFromJsonOptions, type LoadedPanoProject, type LoadedProjectScene, PanoDataError, type PanoDataErrorCode, type PanoDragMotion, type PanoMapControlsDefinition, type PanoMapCorner, type PanoMapDefinition, type PanoMapDialogPresentation, type PanoMapDockedPresentation, type PanoMapGradientStop, type PanoMapPresentation, type PanoMapSectorDefinition, type PanoMapSectorGradient, type PanoMapSpotDefinition, type PanoProjectDefinition, type PanoProjectSceneDefinition, type PanoViewLimits, type PopupAssetUrlContext, type PopupAssetUrlResolver, type ProjectCustomHotspotAction, type ProjectHotspotAction, type ProjectHotspotDefinition, type ProjectHotspotTrigger, type ProjectPopupBlock, type ProjectPopupDefinition, type SceneFromViewerConfigOptions, type SphereViewerConfig, type ViewerConfig, type ViewerDocument, hotspotAction, loadPanoProject, loadSceneFromJson, parsePanoMap, parsePanoProject, projectHotspotTriggers, resolvePanoMapAssets, resolveHotspotAssets as resolveProjectHotspotAssets, resolveProjectPopupAssets, sceneFromViewerConfig, setHotspotAction };

package/dist/data.d.ts

@@ -531,6 +531,17 @@ type ProjectHotspotDefinition = HotspotDefinition & {
 };
 declare function resolveHotspotAssets(hotspot: ProjectHotspotDefinition, baseUrl: string, sceneId: string, resolver?: AssetUrlResolver): ProjectHotspotDefinition;
 
+/**
+ * Shared drag inertia and edge bounce for map pan and scene-menu scrolling.
+ * Axis motion is pure; hosts own pointer capture and rAF loops.
+ */
+type PanoDragMotion = {
+    /** Continue sliding after release from pointer velocity. Defaults to true. */
+    inertia?: boolean;
+    /** Rubber-band past edges while dragging; spring back on release. Defaults to true. */
+    bounce?: boolean;
+};
+
 type PanoMapCorner = "top-left" | "top-right" | "bottom-left" | "bottom-right";
 type PanoMapGradientStop = {
     offset: number;
@@ -622,6 +633,11 @@ type PanoMapDefinition = {
      * Only applies when `interaction` is `"zoom"`. Defaults to 8.
      */
     maxScale?: number;
+    /**
+     * Pan inertia and edge bounce when `interaction` is `"zoom"`.
+     * Omit for both on; set `false` or flag fields to disable.
+     */
+    dragMotion?: PanoDragMotion | false;
     spots: PanoMapSpotDefinition[];
     sector?: PanoMapSectorDefinition;
 };
@@ -680,4 +696,4 @@ declare function parsePanoProject(value: unknown, options?: {
 }): PanoProjectDefinition;
 declare function loadPanoProject(source: string | PanoProjectDefinition, options?: LoadPanoProjectOptions): Promise<LoadedPanoProject>;
 
-export { type AssetUrlContext, type AssetUrlResolver, type CubemapViewerConfig, type JsonObject, type JsonRequestOptions, type JsonValue, type LoadPanoProjectOptions, type LoadSceneFromJsonOptions, type LoadedPanoProject, type LoadedProjectScene, PanoDataError, type PanoDataErrorCode, type PanoMapControlsDefinition, type PanoMapCorner, type PanoMapDefinition, type PanoMapDialogPresentation, type PanoMapDockedPresentation, type PanoMapGradientStop, type PanoMapPresentation, type PanoMapSectorDefinition, type PanoMapSectorGradient, type PanoMapSpotDefinition, type PanoProjectDefinition, type PanoProjectSceneDefinition, type PanoViewLimits, type PopupAssetUrlContext, type PopupAssetUrlResolver, type ProjectCustomHotspotAction, type ProjectHotspotAction, type ProjectHotspotDefinition, type ProjectHotspotTrigger, type ProjectPopupBlock, type ProjectPopupDefinition, type SceneFromViewerConfigOptions, type SphereViewerConfig, type ViewerConfig, type ViewerDocument, hotspotAction, loadPanoProject, loadSceneFromJson, parsePanoMap, parsePanoProject, projectHotspotTriggers, resolvePanoMapAssets, resolveHotspotAssets as resolveProjectHotspotAssets, resolveProjectPopupAssets, sceneFromViewerConfig, setHotspotAction };
+export { type AssetUrlContext, type AssetUrlResolver, type CubemapViewerConfig, type JsonObject, type JsonRequestOptions, type JsonValue, type LoadPanoProjectOptions, type LoadSceneFromJsonOptions, type LoadedPanoProject, type LoadedProjectScene, PanoDataError, type PanoDataErrorCode, type PanoDragMotion, type PanoMapControlsDefinition, type PanoMapCorner, type PanoMapDefinition, type PanoMapDialogPresentation, type PanoMapDockedPresentation, type PanoMapGradientStop, type PanoMapPresentation, type PanoMapSectorDefinition, type PanoMapSectorGradient, type PanoMapSpotDefinition, type PanoProjectDefinition, type PanoProjectSceneDefinition, type PanoViewLimits, type PopupAssetUrlContext, type PopupAssetUrlResolver, type ProjectCustomHotspotAction, type ProjectHotspotAction, type ProjectHotspotDefinition, type ProjectHotspotTrigger, type ProjectPopupBlock, type ProjectPopupDefinition, type SceneFromViewerConfigOptions, type SphereViewerConfig, type ViewerConfig, type ViewerDocument, hotspotAction, loadPanoProject, loadSceneFromJson, parsePanoMap, parsePanoProject, projectHotspotTriggers, resolvePanoMapAssets, resolveHotspotAssets as resolveProjectHotspotAssets, resolveProjectPopupAssets, sceneFromViewerConfig, setHotspotAction };

package/dist/data.mjs

@@ -914,6 +914,23 @@ function parsePresentation(value, field) {
     ...offsetY === void 0 ? {} : { offsetY }
   };
 }
+function parseOptionalBoolean(value, field) {
+  if (value === void 0) return void 0;
+  if (value === true) return true;
+  if (value === false) return false;
+  throw new Error(`${field}: expected a boolean`);
+}
+function parseDragMotion(value, field) {
+  if (value === false) return false;
+  if (!isRecord(value)) throw new Error(`${field}: expected an object or false`);
+  const inertia = parseOptionalBoolean(value.inertia, `${field}.inertia`);
+  const bounce = parseOptionalBoolean(value.bounce, `${field}.bounce`);
+  const motion = {
+    ...inertia === void 0 ? {} : { inertia },
+    ...bounce === void 0 ? {} : { bounce }
+  };
+  return motion;
+}
 function parseControls(value, field) {
   if (!isRecord(value)) throw new Error(`${field}: expected an object`);
   const collapse = value.collapse === void 0 ? void 0 : value.collapse === true ? true : value.collapse === false ? false : (() => {
@@ -962,6 +979,7 @@ function parsePanoMap(value, sceneIds, options = {}) {
     const controls = value.controls === void 0 ? void 0 : parseControls(value.controls, "map.controls");
     const iconSize = optionalNumber(value, "iconSize", { exclusiveMin: 0 });
     const maxScale = optionalNumber(value, "maxScale", { min: 1 });
+    const dragMotion = value.dragMotion === void 0 ? void 0 : parseDragMotion(value.dragMotion, "map.dragMotion");
     if (!Array.isArray(value.spots)) throw new Error("map.spots: expected an array");
     const spotIds = /* @__PURE__ */ new Set();
     const spots = value.spots.map((spot, index) => {
@@ -979,6 +997,7 @@ function parsePanoMap(value, sceneIds, options = {}) {
       ...controls === void 0 ? {} : { controls },
       ...iconSize === void 0 ? {} : { iconSize },
       ...maxScale === void 0 ? {} : { maxScale },
+      ...dragMotion === void 0 ? {} : { dragMotion },
       spots,
       ...sector === void 0 ? {} : { sector }
     };