@lumikmz/kmz 0.2.1 → 0.4.0

package/dist/index.d.mts

@@ -59,8 +59,8 @@ type LidarReturnMode = "singleReturnStrongest" | "dualReturn" | "tripleReturn";
 type LidarScanningMode = "repetitive" | "nonRepetitive";
 type ActionGroupMode = "sequence";
 type ActionTriggerType = "reachPoint" | "betweenAdjacentPoints" | "multipleTiming" | "multipleDistance";
-type ActionActuatorFunc = "takePhoto" | "startRecord" | "stopRecord" | "focus" | "zoom" | "customDirName" | "gimbalRotate" | "rotateYaw" | "hover" | "gimbalEvenlyRotate" | "accurateShoot" | "orientedShoot" | "panoShot" | "recordPointCloud" | "megaphone" | "searchlight";
-type GimbalHeadingYawBase = "north";
+type ActionActuatorFunc = "takePhoto" | "startRecord" | "stopRecord" | "focus" | "zoom" | "customDirName" | "gimbalRotate" | "rotateYaw" | "hover" | "gimbalEvenlyRotate" | "accurateShoot" | "orientedShoot" | "panoShot" | "recordPointCloud" | "megaphone" | "searchlight" /** ⚠️ NON-SPEC — observed in real DJI KMZ exports, absent from WPML 1.15 docs. */ | "startSmartOblique" /** ⚠️ NON-SPEC — observed in real DJI KMZ exports, absent from WPML 1.15 docs. */ | "stopSmartOblique" /** Starts time-lapse (interval) shooting for a mapping strip. */ | "startTimeLapse" /** Stops time-lapse shooting. */ | "stopTimeLapse" /** Locks gimbal angle during a mapping strip. */ | "gimbalAngleLock" /** Unlocks gimbal angle (no params in XML). */ | "gimbalAngleUnlock" /** Sets camera focus mode (manual / auto). */ | "setFocusType";
+type GimbalHeadingYawBase = "north" | "aircraft";
 type GimbalRotateMode = "absoluteAngle";
 type AircraftPathMode = "clockwise" | "counterClockwise";
 type RecordPointCloudOperate = "startRecord" | "pauseRecord" | "resumeRecord" | "stopRecord";
@@ -74,6 +74,12 @@ interface DroneInfo {
 }
 interface PayloadInfo {
   payloadEnumValue: number;
+  /**
+   * Payload sub-type (`type-subtype-gimbalindex`, the middle field). Non-standard
+   * WPML extension that DJI tooling emits; written when present. Main-gimbal
+   * cameras are subtype 0 (e.g. M4TD Camera = 99-0-0).
+   */
+  payloadSubEnumValue?: number;
   payloadPositionIndex: number;
 }
 /** Aircraft `{ droneEnumValue, droneSubEnumValue }` tuples. */
@@ -139,46 +145,57 @@ declare const DroneEnum: {
 declare const PayloadEnum: {
   readonly M30Camera: {
     readonly payloadEnumValue: 52;
+    readonly payloadSubEnumValue: 0;
     readonly payloadPositionIndex: 0;
   };
   readonly M30TCamera: {
     readonly payloadEnumValue: 53;
+    readonly payloadSubEnumValue: 0;
     readonly payloadPositionIndex: 0;
   };
   readonly M3ECamera: {
     readonly payloadEnumValue: 66;
+    readonly payloadSubEnumValue: 0;
     readonly payloadPositionIndex: 0;
   };
   readonly M3TCamera: {
     readonly payloadEnumValue: 67;
+    readonly payloadSubEnumValue: 0;
     readonly payloadPositionIndex: 0;
   };
   readonly M3TACamera: {
     readonly payloadEnumValue: 129;
+    readonly payloadSubEnumValue: 0;
     readonly payloadPositionIndex: 0;
   };
   readonly M3DCamera: {
     readonly payloadEnumValue: 80;
+    readonly payloadSubEnumValue: 0;
     readonly payloadPositionIndex: 0;
   };
   readonly M3TDCamera: {
     readonly payloadEnumValue: 81;
+    readonly payloadSubEnumValue: 0;
     readonly payloadPositionIndex: 0;
   };
   readonly M4DCamera: {
     readonly payloadEnumValue: 98;
+    readonly payloadSubEnumValue: 0;
     readonly payloadPositionIndex: 0;
   };
   readonly M4TDCamera: {
     readonly payloadEnumValue: 99;
+    readonly payloadSubEnumValue: 0;
     readonly payloadPositionIndex: 0;
   };
   readonly M4ECamera: {
     readonly payloadEnumValue: 88;
+    readonly payloadSubEnumValue: 0;
     readonly payloadPositionIndex: 0;
   };
   readonly M4TCamera: {
     readonly payloadEnumValue: 89;
+    readonly payloadSubEnumValue: 0;
     readonly payloadPositionIndex: 0;
   };
   readonly ZenmuseZ30: {
@@ -269,6 +286,11 @@ interface PayloadParam {
   modelColoringEnable?: boolean;
   /** Comma-joined `LensType` tokens, e.g. `["wide","ir"]`. */
   imageFormat: LensType[];
+  /**
+   * ⚠️ NON-SPEC — observed in 司空2 (FlightHub 2) KMZ exports, absent from WPML 1.15.
+   * Photo size/ratio token, e.g. `"default_l"`. Pass-through for compatibility.
+   */
+  photoSize?: string;
 }
 //#endregion
 //#region src/types/waypoint-params.d.ts
@@ -282,7 +304,14 @@ interface WaypointHeadingParam {
   waypointHeadingAngle?: Degrees;
   /** Required iff `waypointHeadingMode === "towardPOI"`. Z aim unsupported; set height to 0. */
   waypointPoiPoint?: LngLatHeight;
+  /**
+   * Whether `waypointHeadingAngle` is in effect at this waypoint.
+   * Observed in mapping waylines exports; `false` on the terminal waypoint.
+   */
+  waypointHeadingAngleEnable?: boolean;
   waypointHeadingPathMode: WaypointHeadingPathMode;
+  /** POI index when `waypointHeadingMode === "towardPOI"`. Default 0. */
+  waypointHeadingPoiIndex?: number;
 }
 /**
  * `wpml:waypointTurnParam`.
@@ -311,6 +340,17 @@ interface WaylineCoordinateSysParam {
   surfaceFollowModeEnable?: boolean;
   /** Required iff `surfaceFollowModeEnable === true`. */
   surfaceRelativeHeight?: Meters;
+  /**
+   * ⚠️ NON-SPEC — observed in real DJI KMZ exports, absent from WPML 1.15 docs.
+   * When true, surface-follow uses live onboard sensor height (no DSM file).
+   */
+  isRealtimeSurfaceFollow?: boolean;
+  /**
+   * ⚠️ NON-SPEC — observed in real DJI KMZ exports, absent from WPML 1.15 docs.
+   * Path inside the KMZ to the DSM `.tif` used for surface-follow,
+   * e.g. `"wpmz/res/dsm/foo.tif"`. Only set when `isRealtimeSurfaceFollow` is false.
+   */
+  dsmFile?: string;
 }
 /**
  * `wpml:mappingHeadingParam` — only on `mapping2d` Folder
@@ -357,7 +397,7 @@ interface ActionTrigger {
   actionTriggerParam?: number;
 }
 /** Discriminated by `actionActuatorFunc`. */
-type Action = TakePhotoAction | StartRecordAction | StopRecordAction | FocusAction | ZoomAction | CustomDirNameAction | GimbalRotateAction | RotateYawAction | HoverAction | GimbalEvenlyRotateAction | AccurateShootAction | OrientedShootAction | PanoShotAction | RecordPointCloudAction | MegaphoneAction | SearchlightAction;
+type Action = TakePhotoAction | StartRecordAction | StopRecordAction | FocusAction | ZoomAction | CustomDirNameAction | GimbalRotateAction | RotateYawAction | HoverAction | GimbalEvenlyRotateAction | AccurateShootAction | OrientedShootAction | PanoShotAction | RecordPointCloudAction | MegaphoneAction | SearchlightAction | StartSmartObliqueAction | StopSmartObliqueAction | StartTimeLapseAction | StopTimeLapseAction | GimbalAngleLockAction | GimbalAngleUnlockAction | SetFocusTypeAction;
 interface ActionBase<F extends string, P> {
   actionId: number;
   actionActuatorFunc: F;
@@ -393,6 +433,8 @@ interface FocusParam {
   focusRegionHeight?: number;
   /** Required on M3E/M3T/M3M, M3D/M3TD, M4D/M4TD, M4E/M4T. */
   isInfiniteFocus?: boolean;
+  /** Calibration focus flag, observed in mapping WPML exports. */
+  isCalibrationFocus?: boolean;
 }
 type FocusAction = ActionBase<"focus", FocusParam>;
 interface ZoomParam {
@@ -504,6 +546,8 @@ interface PanoShotParam {
   payloadPositionIndex?: number;
   payloadLensIndex?: LensType[];
   useGlobalPayloadLensIndex?: boolean;
+  /** Photo meta tag written alongside the panorama; UUID string. */
+  actionUUID?: string;
   panoShotSubMode: PanoShotSubMode;
 }
 type PanoShotAction = ActionBase<"panoShot", PanoShotParam>;
@@ -530,6 +574,52 @@ interface MegaphoneParam {
   megaphoneFileBitrate: 1 | 2 | 3 | 4 | 5 | 6;
 }
 type MegaphoneAction = ActionBase<"megaphone", MegaphoneParam>;
+/** M4D/M4TD only — starts gimbal swing in smart-oblique mode. */
+interface StartSmartObliqueParam {
+  payloadPositionIndex: number;
+}
+type StartSmartObliqueAction = ActionBase<"startSmartOblique", StartSmartObliqueParam>;
+/** M4D/M4TD only — stops gimbal swing in smart-oblique mode. */
+interface StopSmartObliqueParam {
+  payloadPositionIndex: number;
+}
+type StopSmartObliqueAction = ActionBase<"stopSmartOblique", StopSmartObliqueParam>;
+/** Starts interval (time-lapse) shooting for a mapping strip. */
+interface StartTimeLapseParam {
+  payloadPositionIndex: number;
+  useGlobalPayloadLensIndex: boolean;
+  /** Single lens token (not a list — mapping strips use one lens). */
+  payloadLensIndex: LensType;
+  /** Minimum shoot interval in seconds. Derived from `forwardGroundSpacing / speed`. */
+  minShootInterval: number;
+}
+type StartTimeLapseAction = ActionBase<"startTimeLapse", StartTimeLapseParam>;
+/** Stops interval shooting for a mapping strip. */
+interface StopTimeLapseParam {
+  payloadPositionIndex: number;
+  payloadLensIndex: LensType;
+}
+type StopTimeLapseAction = ActionBase<"stopTimeLapse", StopTimeLapseParam>;
+/** Locks gimbal pitch angle during a mapping strip. */
+interface GimbalAngleLockParam {
+  payloadPositionIndex: number;
+}
+type GimbalAngleLockAction = ActionBase<"gimbalAngleLock", GimbalAngleLockParam>;
+/**
+ * Unlocks gimbal angle after a mapping strip ends.
+ * ⚠️ No `actionActuatorFuncParam` element is emitted in XML — this action has no params.
+ */
+interface GimbalAngleUnlockAction {
+  actionId: number;
+  actionActuatorFunc: "gimbalAngleUnlock";
+}
+/** Sets camera focus mode (e.g. "manual") before a mapping run. */
+interface SetFocusTypeParam {
+  payloadPositionIndex: number;
+  /** e.g. `"manual"`, `"auto"`. */
+  cameraFocusType: string;
+}
+type SetFocusTypeAction = ActionBase<"setFocusType", SetFocusTypeParam>;
 /** M4D/M4TD only. */
 interface SearchlightParam {
   payloadPositionIndex: number;
@@ -577,24 +667,87 @@ interface TemplateWaypointPlacemark {
   isRisky?: boolean;
   actionGroup?: ActionGroup[];
 }
-/**
- * `Placemark` inside a mapping-type Folder (mapping2d / mapping3d).
- * Holds the survey polygon. Folder-level fields carry shooting params.
- */
-interface TemplatePolygonPlacemark {
-  Polygon: {
-    outerBoundaryIs: {
-      LinearRing: {
-        /** Space-separated `lon,lat,alt` triples. */coordinates: string;
-      };
+/** Survey-area boundary polygon, shared by mapping2d / mapping3d Placemarks. */
+interface TemplatePolygon {
+  outerBoundaryIs: {
+    LinearRing: {
+      /** Space-separated `lon,lat,alt` triples. */coordinates: string;
     };
   };
 }
-/** Placemark for `mappingStrip` Folder — uses a LineString. */
-interface TemplateLineStringPlacemark {
+/**
+ * `Placemark` inside a `mapping2d` Folder. Per the WPML spec the shooting/mapping
+ * params live HERE alongside the polygon — NOT on the Folder.
+ */
+interface Mapping2dPlacemark {
+  /** M300/M350 only. */
+  caliFlightEnable?: boolean;
+  elevationOptimizeEnable: boolean;
+  /** M300/M350+P1, M3E/M3T/M3M, M3D. */
+  smartObliqueEnable?: boolean;
+  smartObliqueGimbalPitch?: Degrees;
+  /** M4E only. */
+  quickOrthoMappingEnable?: boolean;
+  /** Required iff `quickOrthoMappingEnable === true`. `[10, 30]`. */
+  quickOrthoMappingPitch?: Degrees;
+  /** M3E/M3T/M3M. */
+  facadeWaylineEnable?: boolean;
+  shootType: ShootType;
+  /** `[0, 360]`. */
+  direction: Degrees;
+  /** Outward survey-area margin, meters. */
+  margin: number;
+  /** M3E/M3T/M3M, M3D/M3TD, M4D/M4TD, M4E/M4T. */
+  mappingHeadingParam?: MappingHeadingParam;
+  /** M3E/M3T/M3M, M3D/M3TD, M4D/M4TD, M4E/M4T. */
+  gimbalPitchMode?: "manual" | "fixed";
+  /** Required iff `gimbalPitchMode === "fixed"`. `[-90, -30]`. */
+  gimbalPitchAngle?: Degrees;
+  /** Overlap ratios as percentages `[0, 100]` (e.g. `80`, not `0.8`). */
+  overlap: Overlap;
+  Polygon: TemplatePolygon;
+  /** WGS84 ellipsoid. */
+  ellipsoidHeight: Meters;
+  /** Per Folder `heightMode`. */
+  height: Meters;
+}
+/** `Placemark` inside a `mapping3d` (oblique) Folder. Params live here, not on the Folder. */
+interface Mapping3dPlacemark {
+  caliFlightEnable?: boolean;
+  inclinedGimbalPitch: Degrees;
+  /** Range `[1, 15]`. */
+  inclinedFlightSpeed: MetersPerSecond;
+  shootType: ShootType;
+  direction: Degrees;
+  margin: number;
+  /** Overlap ratios as percentages `[0, 100]`. */
+  overlap: Overlap;
+  Polygon: TemplatePolygon;
+  ellipsoidHeight: Meters;
+  height: Meters;
+}
+/** `Placemark` inside a `mappingStrip` Folder — uses a LineString; params live here. */
+interface MappingStripPlacemark {
+  caliFlightEnable: boolean;
+  shootType: ShootType;
+  direction: Degrees;
+  /** Float meters (vs integer in mapping2d/3d). */
+  margin: number;
+  singleLineEnable: boolean;
+  cuttingDistance: number;
+  boundaryOptimEnable: boolean;
+  leftExtend: number;
+  rightExtend: number;
+  includeCenterEnable: boolean;
+  /** Overlap ratios as percentages `[0, 100]`. */
+  overlap: Overlap;
   LineString: {
     /** Space-separated `lon,lat,alt` triples. Alt consumed only when `stripUseTemplateAltitude === true`. */coordinates: string;
   };
+  ellipsoidHeight: Meters;
+  height: Meters;
+  /** When true, altitudes are read from LineString triples. */
+  stripUseTemplateAltitude: boolean;
 }
 /**
  * `Placemark` inside a Folder of waylines.wpml.
@@ -616,6 +769,13 @@ interface WaylinesPlacemark {
   useStraightLine?: boolean;
   isRisky?: boolean;
   actionGroup?: ActionGroup[];
+  /** Per-waypoint gimbal orientation hint observed in mapping waylines exports. */
+  waypointGimbalHeadingParam?: {
+    waypointGimbalPitchAngle: Degrees;
+    waypointGimbalYawAngle: Degrees;
+  };
+  /** Waypoint work type; 0 = normal. Observed in mapping waylines exports. */
+  waypointWorkType?: number;
 }
 //#endregion
 //#region src/types/template.d.ts
@@ -664,35 +824,8 @@ interface Mapping2dFolder {
   waylineCoordinateSysParam: WaylineCoordinateSysParam;
   autoFlightSpeed: MetersPerSecond;
   payloadParam?: PayloadParam;
-  /** M300/M350 only. */
-  caliFlightEnable?: boolean;
-  elevationOptimizeEnable: boolean;
-  /** M300/M350+P1, M3E/M3T/M3M, M3D. */
-  smartObliqueEnable?: boolean;
-  smartObliqueGimbalPitch?: Degrees;
-  shootType: ShootType;
-  /** `[0, 360]`. */
-  direction: Degrees;
-  /** Outward survey-area margin, meters. */
-  margin: number;
-  overlap: Overlap;
-  /** WGS84 ellipsoid. */
-  ellipsoidHeight: Meters;
-  /** Per Folder `heightMode`. */
-  height: Meters;
-  /** M3E/M3T/M3M. */
-  facadeWaylineEnable?: boolean;
-  /** M3E/M3T/M3M, M3D/M3TD, M4D/M4TD, M4E/M4T. */
-  mappingHeadingParam?: MappingHeadingParam;
-  /** M3E/M3T/M3M, M3D/M3TD, M4D/M4TD, M4E/M4T. */
-  gimbalPitchMode?: "manual" | "fixed";
-  /** Required iff `gimbalPitchMode === "fixed"`. `[-90, -30]`. */
-  gimbalPitchAngle?: Degrees;
-  /** M4E only. */
-  quickOrthoMappingEnable?: boolean;
-  /** Required iff `quickOrthoMappingEnable === true`. `[10, 30]`. */
-  quickOrthoMappingPitch?: Degrees;
-  Placemark: TemplatePolygonPlacemark;
+  /** Holds the survey polygon AND all shooting/mapping params (per WPML nesting). */
+  Placemark: Mapping2dPlacemark;
 }
 interface Mapping3dTemplate extends TemplateDocumentBase {
   Folder: Mapping3dFolder;
@@ -703,17 +836,8 @@ interface Mapping3dFolder {
   waylineCoordinateSysParam: WaylineCoordinateSysParam;
   autoFlightSpeed: MetersPerSecond;
   payloadParam?: PayloadParam;
-  caliFlightEnable?: boolean;
-  inclinedGimbalPitch: Degrees;
-  /** Range `[1, 15]`. */
-  inclinedFlightSpeed: MetersPerSecond;
-  shootType: ShootType;
-  direction: Degrees;
-  margin: number;
-  overlap: Overlap;
-  ellipsoidHeight: Meters;
-  height: Meters;
-  Placemark: TemplatePolygonPlacemark;
+  /** Holds the survey polygon AND all shooting/mapping params. */
+  Placemark: Mapping3dPlacemark;
 }
 interface MappingStripTemplate extends TemplateDocumentBase {
   Folder: MappingStripFolder;
@@ -724,26 +848,19 @@ interface MappingStripFolder {
   waylineCoordinateSysParam: WaylineCoordinateSysParam;
   autoFlightSpeed: MetersPerSecond;
   payloadParam?: PayloadParam;
-  caliFlightEnable: boolean;
-  shootType: ShootType;
-  direction: Degrees;
-  /** Float meters (vs integer in mapping2d/3d). */
-  margin: number;
-  singleLineEnable: boolean;
-  cuttingDistance: number;
-  boundaryOptimEnable: boolean;
-  leftExtend: number;
-  rightExtend: number;
-  includeCenterEnable: boolean;
-  overlap: Overlap;
-  ellipsoidHeight: Meters;
-  height: Meters;
-  /** When true, altitudes are read from LineString triples. */
-  stripUseTemplateAltitude: boolean;
-  Placemark: TemplateLineStringPlacemark;
+  /** Holds the LineString AND all strip params. */
+  Placemark: MappingStripPlacemark;
 }
 //#endregion
 //#region src/types/waylines.d.ts
+/**
+ * Pre-flight action list executed before the wayline starts.
+ * The XML `<wpml:startActionGroup>` element only wraps raw `<wpml:action>` items —
+ * it has no `actionGroupId`, `actionGroupMode`, or `actionTrigger` elements.
+ */
+interface StartActionGroup {
+  action: Action[];
+}
 /**
  * `waylines.wpml` document. Mirrors `<kml><Document>` structure.
  * See `docs/kmz/waylines-wpml.html`.
@@ -763,19 +880,37 @@ interface WaylinesFolder {
   /** Range `[1, 15]`. */
   autoFlightSpeed: MetersPerSecond;
   /**
-   * Optional pre-wayline action group.
+   * Optional pre-wayline action list executed before the wayline starts.
    * Available on M30/M30T, M3E/M3T/M3M, M3D/M3TD, M4D/M4TD, M4E/M4T.
    */
-  startActionGroup?: ActionGroup;
+  startActionGroup?: StartActionGroup;
   Placemark: WaylinesPlacemark[];
 }
 //#endregion
 //#region src/plan/index.d.ts
+/**
+ * Options for `plan()`.
+ *
+ * Mapping templates (`mapping2d`, `mapping3d`) require `lineSpacing` — the perpendicular
+ * distance between adjacent flight lines in meters. The formula is:
+ * `2 · height · tan(HFOV / 2) · (1 − sideOverlap)`.
+ *
+ * `shootInterval` — time-lapse interval in seconds for `startTimeLapse` actions.
+ * Formula: `forwardGroundSpacing / speed`,
+ * where `forwardGroundSpacing = 2 · height · tan(VFOV / 2) · (1 − forwardOverlap)`.
+ * Camera FOV and sensor data live in the demo layer, not in this package.
+ */
+interface PlanOptions {
+  lineSpacing?: Meters;
+  shootInterval?: number;
+}
 /**
  * Compile a high-level `Template` into executable `Waylines`.
  * Dispatch is by `template.Folder.templateType` per the DJI WPML spec.
+ *
+ * Mapping templates require `options.lineSpacing` (meters between flight lines).
  */
-declare function plan(template: Template): Waylines;
+declare function plan(template: Template, options?: PlanOptions): Waylines;
 //#endregion
 //#region src/validate/index.d.ts
 /**
@@ -786,4 +921,8 @@ declare function plan(template: Template): Waylines;
  */
 declare function validate(doc: Template | Waylines): Issue[];
 //#endregion
-export { AccurateShootAction, AccurateShootParam, Action, ActionActuatorFunc, ActionGroup, ActionGroupMode, ActionTrigger, ActionTriggerType, AircraftPathMode, AutoRerouteInfo, CoordinateMode, CustomDirNameAction, CustomDirNameParam, Degrees, DroneEnum, DroneInfo, type ExecuteHeightMode, ExecuteRCLostAction, ExitOnRCLost, FinishAction, FlyToWaylineMode, FocusAction, FocusMode, FocusParam, GimbalEvenlyRotateAction, GimbalEvenlyRotateParam, GimbalHeadingYawBase, GimbalPitchMode, GimbalRotateAction, GimbalRotateMode, GimbalRotateParam, HoverAction, HoverParam, type Issue, KmzError, LensType, LidarReturnMode, LidarScanningMode, LngLat, LngLatHeight, Mapping2dFolder, Mapping2dTemplate, Mapping3dFolder, Mapping3dTemplate, MappingHeadingMode, MappingHeadingParam, MappingStripFolder, MappingStripTemplate, MegaphoneAction, MegaphoneParam, MeteringMode, Meters, MetersPerSecond, MissionConfig, OrientedPhotoMode, OrientedShootAction, OrientedShootParam, Overlap, PanoShotAction, PanoShotParam, PanoShotSubMode, PayloadEnum, PayloadInfo, PayloadParam, PlannerError, PositioningType, RecordPointCloudAction, RecordPointCloudOperate, RecordPointCloudParam, RotateYawAction, RotateYawParam, SearchlightAction, SearchlightParam, ShootType, StartRecordAction, StartRecordParam, StopRecordAction, StopRecordParam, TakePhotoAction, TakePhotoParam, Template, TemplateHeightMode, TemplateLineStringPlacemark, TemplatePolygonPlacemark, TemplateType, TemplateWaypointPlacemark, WaylineCoordinateSysParam, Waylines, WaylinesFolder, WaylinesPlacemark, WaypointFolder, WaypointHeadingMode, WaypointHeadingParam, WaypointHeadingPathMode, WaypointTemplate, WaypointTurnMode, WaypointTurnParam, ZoomAction, ZoomParam, degrees, meters, metersPerSecond, plan, validate };
+//#region src/plan/geometry.d.ts
+/** Great-circle distance between two WGS-84 coordinates, in meters. */
+declare function haversineMeters(a: LngLat, b: LngLat): number;
+//#endregion
+export { AccurateShootAction, AccurateShootParam, Action, ActionActuatorFunc, ActionGroup, ActionGroupMode, ActionTrigger, ActionTriggerType, AircraftPathMode, AutoRerouteInfo, CoordinateMode, CustomDirNameAction, CustomDirNameParam, Degrees, DroneEnum, DroneInfo, ExecuteHeightMode, ExecuteRCLostAction, ExitOnRCLost, FinishAction, FlyToWaylineMode, FocusAction, FocusMode, FocusParam, GimbalAngleLockAction, GimbalAngleLockParam, GimbalAngleUnlockAction, GimbalEvenlyRotateAction, GimbalEvenlyRotateParam, GimbalHeadingYawBase, GimbalPitchMode, GimbalRotateAction, GimbalRotateMode, GimbalRotateParam, HoverAction, HoverParam, Issue, KmzError, LensType, LidarReturnMode, LidarScanningMode, LngLat, LngLatHeight, Mapping2dFolder, Mapping2dPlacemark, Mapping2dTemplate, Mapping3dFolder, Mapping3dPlacemark, Mapping3dTemplate, MappingHeadingMode, MappingHeadingParam, MappingStripFolder, MappingStripPlacemark, MappingStripTemplate, MegaphoneAction, MegaphoneParam, MeteringMode, Meters, MetersPerSecond, MissionConfig, OrientedPhotoMode, OrientedShootAction, OrientedShootParam, Overlap, PanoShotAction, PanoShotParam, PanoShotSubMode, PayloadEnum, PayloadInfo, PayloadParam, type PlanOptions, PlannerError, PositioningType, RecordPointCloudAction, RecordPointCloudOperate, RecordPointCloudParam, RotateYawAction, RotateYawParam, SearchlightAction, SearchlightParam, SetFocusTypeAction, SetFocusTypeParam, ShootType, StartActionGroup, StartRecordAction, StartRecordParam, StartSmartObliqueAction, StartSmartObliqueParam, StartTimeLapseAction, StartTimeLapseParam, StopRecordAction, StopRecordParam, StopSmartObliqueAction, StopSmartObliqueParam, StopTimeLapseAction, StopTimeLapseParam, TakePhotoAction, TakePhotoParam, Template, TemplateHeightMode, TemplatePolygon, TemplateType, TemplateWaypointPlacemark, WaylineCoordinateSysParam, Waylines, WaylinesFolder, WaylinesPlacemark, WaypointFolder, WaypointHeadingMode, WaypointHeadingParam, WaypointHeadingPathMode, WaypointTemplate, WaypointTurnMode, WaypointTurnParam, ZoomAction, ZoomParam, degrees, haversineMeters, meters, metersPerSecond, plan, validate };