@lumikmz/kmz 0.7.0 → 0.8.0

package/dist/index.d.mts

@@ -611,8 +611,8 @@ type StopSmartObliqueAction = ActionBase<"stopSmartOblique", StopSmartObliquePar
 interface StartTimeLapseParam {
   payloadPositionIndex: number;
   useGlobalPayloadLensIndex: boolean;
-  /** Single lens token (not a list — mapping strips use one lens). */
-  payloadLensIndex: LensType;
+  /** Comma-separated in WPML; may contain visible and infrared lenses together. */
+  payloadLensIndex: LensType[];
   /** Minimum shoot interval in seconds. Derived from `forwardGroundSpacing / speed`. */
   minShootInterval: number;
 }
@@ -620,7 +620,7 @@ type StartTimeLapseAction = ActionBase<"startTimeLapse", StartTimeLapseParam>;
 /** Stops interval shooting for a mapping strip. */
 interface StopTimeLapseParam {
   payloadPositionIndex: number;
-  payloadLensIndex: LensType;
+  payloadLensIndex: LensType[];
 }
 type StopTimeLapseAction = ActionBase<"stopTimeLapse", StopTimeLapseParam>;
 /** Locks gimbal pitch angle during a mapping strip. */
@@ -752,12 +752,16 @@ interface Mapping3dPlacemark {
 /** `Placemark` inside a `mappingStrip` Folder — uses a LineString; params live here. */
 interface MappingStripPlacemark {
   caliFlightEnable: boolean;
+  /** Optional field observed in FlightHub 2 mappingStrip exports. */
+  elevationOptimizeEnable?: boolean;
   shootType: ShootType;
   direction: Degrees;
   /** Float meters (vs integer in mapping2d/3d). */
   margin: number;
   singleLineEnable: boolean;
   cuttingDistance: number;
+  /** FlightHub 2 region merge ranges, serialized as JSON (for example `[[1,3]]`). */
+  stripMergedRegions?: number[][];
   boundaryOptimEnable: boolean;
   leftExtend: number;
   rightExtend: number;
@@ -925,7 +929,13 @@ interface WaylinesFolder {
  */
 interface PlanOptions {
   lineSpacing?: Meters;
+  crossTrackFootprint?: Meters;
+  photoSpacing?: Meters;
   shootInterval?: number;
+  /** mappingStrip UI layout mode; kept outside WPML until DJI direction encoding is verified. */
+  stripDirection?: "parallel" | "perpendicular";
+  /** Reverse mappingStrip region execution without changing region identities. */
+  regionOrderReversed?: boolean;
   resolveExecuteHeight?: (point: {
     lng: number;
     lat: number;
@@ -941,6 +951,41 @@ interface PlanOptions {
  */
 declare function plan(template: Template, options?: PlanOptions): Waylines;
 //#endregion
+//#region src/plan/plan-mapping-strip.d.ts
+interface MappingStripRegion {
+  id: string;
+  sourceRegionIndexes: number[];
+  startDistance: Meters;
+  endDistance: Meters;
+  centerLine: LngLat[];
+  polygon: LngLat[];
+}
+interface MappingStripRegionRoute {
+  regionId: string;
+  routeOffsets: Meters[];
+  routeLines: LngLat[][];
+  segments: MappingStripRouteSegment[];
+  executablePath: LngLat[];
+  length: Meters;
+}
+interface MappingStripRouteSegment {
+  kind: "work" | "turn" | "transit" | "elevationOptimize";
+  points: LngLat[];
+  photoEnabled: boolean;
+}
+interface MappingStripDerived {
+  centerLineLength: Meters;
+  surveyArea: LngLat[];
+  surveyAreaSize: number;
+  regions: MappingStripRegion[];
+  flightRoutes: MappingStripRegionRoute[];
+  totalFlightLength: Meters;
+  photoSpacing: Meters;
+  estimatedPhotoCount: number;
+  estimatedDuration: number;
+}
+declare function deriveMappingStrip(template: MappingStripTemplate, options?: PlanOptions): MappingStripDerived;
+//#endregion
 //#region src/validate/index.d.ts
 /**
  * Run semantic checks against a `Template` or `Waylines` document.
@@ -954,4 +999,4 @@ declare function validate(doc: Template | Waylines): Issue[];
 /** 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, MegaphoneTtsParam, 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, SmartObliquePoint, 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 };
+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, type MappingStripDerived, MappingStripFolder, MappingStripPlacemark, type MappingStripRegion, type MappingStripRegionRoute, MappingStripTemplate, MegaphoneAction, MegaphoneParam, MegaphoneTtsParam, 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, SmartObliquePoint, 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, deriveMappingStrip, haversineMeters, meters, metersPerSecond, plan, validate };