@lumikmz/kmz 0.10.0 → 0.11.1

package/dist/index.d.mts

@@ -2,77 +2,91 @@
 type Brand<T, B> = T & {
   readonly __brand: B;
 };
-type Meters = Brand<number, "Meters">;
-type MetersPerSecond = Brand<number, "MetersPerSecond">;
-type Degrees = Brand<number, "Degrees">;
-declare const meters: (n: number) => Meters;
-declare const metersPerSecond: (n: number) => MetersPerSecond;
-declare const degrees: (n: number) => Degrees;
-interface LngLat {
+export type Meters = Brand<number, "Meters">;
+export type MetersPerSecond = Brand<number, "MetersPerSecond">;
+export type Degrees = Brand<number, "Degrees">;
+export declare const meters: (n: number) => Meters;
+export declare const metersPerSecond: (n: number) => MetersPerSecond;
+export declare const degrees: (n: number) => Degrees;
+export interface LngLat {
   readonly lng: number;
   readonly lat: number;
 }
-interface LngLatHeight {
+export interface LngLatHeight {
   readonly lng: number;
   readonly lat: number;
   readonly height: Meters;
 }
 //#endregion
 //#region src/types/errors.d.ts
-declare class KmzError extends Error {
+export declare class KmzError extends Error {
   constructor(message: string);
 }
-declare class PlannerError extends KmzError {
+export declare class PlannerError extends KmzError {
   constructor(message: string);
 }
-interface Issue {
+export interface Issue {
   path: string;
   message: string;
   severity: "error" | "warning";
 }
 //#endregion
 //#region src/types/enums.d.ts
-type FlyToWaylineMode = "safely" | "pointToPoint";
-type FinishAction = "goHome" | "noAction" | "autoLand" | "gotoFirstWaypoint";
-type ExitOnRCLost = "goContinue" | "executeLostAction";
-type ExecuteRCLostAction = "goBack" | "landing" | "hover";
-type TemplateType = "waypoint" | "mapping2d" | "mapping3d" | "mappingStrip" | "targetdetection";
-type CoordinateMode = "WGS84";
+export type FlyToWaylineMode = "safely" | "pointToPoint";
+export type FinishAction = "goHome" | "noAction" | "autoLand" | "gotoFirstWaypoint";
+export type ExitOnRCLost = "goContinue" | "executeLostAction";
+export type ExecuteRCLostAction = "goBack" | "landing" | "hover";
+export type TemplateType = "waypoint" | "mapping2d" | "mapping3d" | "mappingStrip" | "targetdetection";
+export type CoordinateMode = "WGS84";
 /** Used in template.kml `waylineCoordinateSysParam.heightMode`. */
-type TemplateHeightMode = "EGM96" | "relativeToStartPoint" | "aboveGroundLevel" | "realTimeFollowSurface";
+export type TemplateHeightMode = "EGM96" | "relativeToStartPoint" | "aboveGroundLevel" | "realTimeFollowSurface";
 /** Used in waylines.wpml `Folder.executeHeightMode`. */
-type ExecuteHeightMode = "WGS84" | "relativeToStartPoint" | "realTimeFollowSurface";
-type PositioningType = "GPS" | "RTKBaseStation" | "QianXun" | "Custom";
-type WaypointTurnMode = "coordinateTurn" | "toPointAndStopWithDiscontinuityCurvature" | "toPointAndStopWithContinuityCurvature" | "toPointAndPassWithContinuityCurvature";
-type WaypointHeadingMode = "followWayline" | "manually" | "fixed" | "smoothTransition" | "towardPOI";
+export type ExecuteHeightMode = "WGS84" | "relativeToStartPoint" | "realTimeFollowSurface";
+export type PositioningType = "GPS" | "RTKBaseStation" | "QianXun" | "Custom";
+export type WaypointTurnMode = "coordinateTurn" | "toPointAndStopWithDiscontinuityCurvature" | "toPointAndStopWithContinuityCurvature" | "toPointAndPassWithContinuityCurvature";
+export type WaypointHeadingMode = "followWayline" | "manually" | "fixed" | "smoothTransition" | "towardPOI";
 /** Spec typo preserved: `followBadArc` (intended "shortest path / smaller arc"). */
-type WaypointHeadingPathMode = "clockwise" | "counterClockwise" | "followBadArc";
+export type WaypointHeadingPathMode = "clockwise" | "counterClockwise" | "followBadArc";
 /** Template waypoint folder allows manual + per-point; mapping templates allow manual + fixed. */
-type GimbalPitchMode = "manual" | "usePointSetting" | "fixed";
-type ShootType = "time" | "distance";
-type MappingHeadingMode = "fixed" | "followWayline";
+export type GimbalPitchMode = "manual" | "usePointSetting" | "fixed";
+export type ShootType = "time" | "distance";
+export type MappingHeadingMode = "fixed" | "followWayline";
 /** Spec typo preserved: `visable`. */
-type LensType = "wide" | "zoom" | "ir" | "narrow_band" | "visable";
-type FocusMode = "firstPoint" | "custom";
-type MeteringMode = "average" | "spot";
-type LidarReturnMode = "singleReturnStrongest" | "dualReturn" | "tripleReturn";
-type LidarScanningMode = "repetitive" | "nonRepetitive";
-type ActionGroupMode = "sequence";
-type ActionTriggerType = "reachPoint" | "betweenAdjacentPoints" | "betweenAdjacentPointsIncludeFirstPoint" | "multipleTiming" | "multipleDistance";
-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";
-type PanoShotSubMode = "panoShot_360";
-type OrientedPhotoMode = "normalPhoto" | "lowLightSmartShooting";
+export type LensType = "wide" | "zoom" | "ir" | "narrow_band" | "visable";
+export type FocusMode = "firstPoint" | "custom";
+export type MeteringMode = "average" | "spot";
+export type LidarReturnMode = "singleReturnStrongest" | "dualReturn" | "tripleReturn";
+export type LidarScanningMode = "repetitive" | "nonRepetitive";
+export type ActionGroupMode = "sequence";
+export type ActionTriggerType = "reachPoint" | "betweenAdjacentPoints" | "betweenAdjacentPointsIncludeFirstPoint" | "multipleTiming" | "multipleDistance";
+export type ActionActuatorFunc = "targetDetection" | "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";
+export type GimbalHeadingYawBase = "north" | "aircraft";
+export type GimbalRotateMode = "absoluteAngle";
+export type AircraftPathMode = "clockwise" | "counterClockwise";
+export type RecordPointCloudOperate = "startRecord" | "pauseRecord" | "resumeRecord" | "stopRecord";
+export type PanoShotSubMode = "panoShot_360";
+export type OrientedPhotoMode = "normalPhoto" | "lowLightSmartShooting";
 //#endregion
 //#region src/types/drone-payload.d.ts
-interface DroneInfo {
+export interface DroneInfo {
   droneEnumValue: number;
   droneSubEnumValue?: number;
 }
-interface PayloadInfo {
+export interface PayloadInfo {
   payloadEnumValue: number;
   /**
    * Payload sub-type (`type-subtype-gimbalindex`, the middle field). Non-standard
@@ -81,9 +95,11 @@ interface PayloadInfo {
    */
   payloadSubEnumValue?: number;
   payloadPositionIndex: number;
+  /** FlightHub 2 patrol-camera selection, in 35mm-equivalent millimeters. */
+  equivalentFocalLength?: number;
 }
 /** Aircraft `{ droneEnumValue, droneSubEnumValue }` tuples. */
-declare const DroneEnum: {
+export declare const DroneEnum: {
   readonly M400: {
     readonly droneEnumValue: 103;
     readonly droneSubEnumValue: 0;
@@ -142,7 +158,7 @@ declare const DroneEnum: {
   };
 };
 /** Payload `{ payloadEnumValue, payloadPositionIndex }` tuples for common cameras. */
-declare const PayloadEnum: {
+export declare const PayloadEnum: {
   readonly M30Camera: {
     readonly payloadEnumValue: 52;
     readonly payloadSubEnumValue: 0;
@@ -249,7 +265,7 @@ declare const PayloadEnum: {
  * `wpml:missionConfig` — shared between template.kml and waylines.wpml.
  * See `docs/kmz/common-element.html` §missionConfig.
  */
-interface MissionConfig {
+export interface MissionConfig {
   flyToWaylineMode: FlyToWaylineMode;
   finishAction: FinishAction;
   exitOnRCLost: ExitOnRCLost;
@@ -269,7 +285,7 @@ interface MissionConfig {
   /** Only M3D/M3TD, M4D/M4TD, M4E/M4T. */
   autoRerouteInfo?: AutoRerouteInfo;
 }
-interface AutoRerouteInfo {
+export interface AutoRerouteInfo {
   missionAutoRerouteMode: boolean;
   transitionalAutoRerouteMode: boolean;
 }
@@ -277,7 +293,7 @@ interface AutoRerouteInfo {
  * `wpml:payloadParam` — per-payload imaging settings.
  * Lives under template `Folder`.
  */
-interface PayloadParam {
+export interface PayloadParam {
   payloadPositionIndex: number;
   focusMode?: FocusMode;
   meteringMode?: MeteringMode;
@@ -300,7 +316,7 @@ interface PayloadParam {
  * `wpml:waypointHeadingParam` & `wpml:globalWaypointHeadingParam`.
  * See `docs/kmz/common-element.html` §waypointHeadingParam.
  */
-interface WaypointHeadingParam {
+export interface WaypointHeadingParam {
   waypointHeadingMode: WaypointHeadingMode;
   /** Required iff `waypointHeadingMode === "smoothTransition"`. Range `[-180, 180]`. */
   waypointHeadingAngle?: Degrees;
@@ -319,7 +335,7 @@ interface WaypointHeadingParam {
  * `wpml:waypointTurnParam`.
  * See `docs/kmz/common-element.html` §waypointTurnParam.
  */
-interface WaypointTurnParam {
+export interface WaypointTurnParam {
   waypointTurnMode: WaypointTurnMode;
   /**
    * Required iff `waypointTurnMode === "coordinateTurn"`
@@ -331,7 +347,7 @@ interface WaypointTurnParam {
  * `wpml:waylineCoordinateSysParam`.
  * Mapping templates require globalShootHeight + surfaceFollowModeEnable.
  */
-interface WaylineCoordinateSysParam {
+export interface WaylineCoordinateSysParam {
   /** Currently only `"WGS84"` is allowed. */
   coordinateMode: CoordinateMode;
   heightMode: TemplateHeightMode;
@@ -358,7 +374,7 @@ interface WaylineCoordinateSysParam {
  * `wpml:mappingHeadingParam` — only on `mapping2d` Folder
  * (M3E/M3T/M3M, M3D/M3TD, M4D/M4TD, M4E/M4T).
  */
-interface MappingHeadingParam {
+export interface MappingHeadingParam {
   mappingHeadingMode: MappingHeadingMode;
   /** Required iff `mappingHeadingMode === "fixed"`. Range `[0, 360]`. */
   mappingHeadingAngle?: Degrees;
@@ -367,7 +383,7 @@ interface MappingHeadingParam {
  * `wpml:overlap` — child of mapping2d / mapping3d / mappingStrip Folders.
  * All fields individually optional in spec but at least one ortho pair is required in practice.
  */
-interface Overlap {
+export interface Overlap {
   orthoLidarOverlapH?: number;
   orthoLidarOverlapW?: number;
   orthoCameraOverlapH?: number;
@@ -385,7 +401,7 @@ interface Overlap {
  * - `actionGroupId` is unique within the entire KMZ (monotonically from 0).
  * - `actionId` is scoped within its group.
  */
-interface ActionGroup {
+export interface ActionGroup {
   actionGroupId: number;
   actionGroupStartIndex: number;
   actionGroupEndIndex: number;
@@ -393,38 +409,62 @@ interface ActionGroup {
   actionTrigger: ActionTrigger;
   action: Action[];
 }
-interface ActionTrigger {
+export interface ActionTrigger {
   actionTriggerType: ActionTriggerType;
   /** Seconds for `multipleTiming`, meters for `multipleDistance`. */
   actionTriggerParam?: number;
 }
 /** Discriminated by `actionActuatorFunc`. */
-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;
+export type Action = TargetDetectionAction | 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;
   actionActuatorFuncParam: P;
 }
-interface TakePhotoParam {
+export interface TargetDetectionParam {
+  focalLength?: number;
+  payloadPositionIndex: number;
+  useGlobalPayloadLensIndex: boolean;
+  payloadLensIndex: LensType[];
+  actionUUID: string;
+  irGainMode?: string;
+  irColorPalette?: string;
+  customTitle: string;
+  customText: string;
+  modelIndex: number;
+  modelScore: number;
+  alarmInterval: number;
+  useThirdModel: boolean;
+  algorithmType: string;
+  targetParam: {
+    maxThreshold: number;
+    minThreshold: number;
+    useMaxThreshold: boolean;
+    useMinThreshold: boolean;
+    targetType: string;
+  };
+}
+export type TargetDetectionAction = ActionBase<"targetDetection", TargetDetectionParam>;
+export interface TakePhotoParam {
   payloadPositionIndex: number;
   fileSuffix?: string;
   payloadLensIndex?: LensType[];
   useGlobalPayloadLensIndex: boolean;
 }
-type TakePhotoAction = ActionBase<"takePhoto", TakePhotoParam>;
-interface StartRecordParam {
+export type TakePhotoAction = ActionBase<"takePhoto", TakePhotoParam>;
+export interface StartRecordParam {
   payloadPositionIndex: number;
   fileSuffix?: string;
   payloadLensIndex?: LensType[];
   useGlobalPayloadLensIndex: boolean;
 }
-type StartRecordAction = ActionBase<"startRecord", StartRecordParam>;
-interface StopRecordParam {
+export type StartRecordAction = ActionBase<"startRecord", StartRecordParam>;
+export interface StopRecordParam {
   payloadPositionIndex: number;
   payloadLensIndex?: LensType[];
 }
-type StopRecordAction = ActionBase<"stopRecord", StopRecordParam>;
-interface FocusParam {
+export type StopRecordAction = ActionBase<"stopRecord", StopRecordParam>;
+export interface FocusParam {
   payloadPositionIndex: number;
   isPointFocus: boolean;
   focusX: number;
@@ -438,19 +478,19 @@ interface FocusParam {
   /** Calibration focus flag, observed in mapping WPML exports. */
   isCalibrationFocus?: boolean;
 }
-type FocusAction = ActionBase<"focus", FocusParam>;
-interface ZoomParam {
+export type FocusAction = ActionBase<"focus", FocusParam>;
+export interface ZoomParam {
   payloadPositionIndex: number;
   /** mm, > 0. */
   focalLength: number;
 }
-type ZoomAction = ActionBase<"zoom", ZoomParam>;
-interface CustomDirNameParam {
+export type ZoomAction = ActionBase<"zoom", ZoomParam>;
+export interface CustomDirNameParam {
   payloadPositionIndex: number;
   directoryName: string;
 }
-type CustomDirNameAction = ActionBase<"customDirName", CustomDirNameParam>;
-interface GimbalRotateParam {
+export type CustomDirNameAction = ActionBase<"customDirName", CustomDirNameParam>;
+export interface GimbalRotateParam {
   payloadPositionIndex: number;
   gimbalHeadingYawBase: GimbalHeadingYawBase;
   gimbalRotateMode: GimbalRotateMode;
@@ -464,27 +504,27 @@ interface GimbalRotateParam {
   /** seconds */
   gimbalRotateTime: number;
 }
-type GimbalRotateAction = ActionBase<"gimbalRotate", GimbalRotateParam>;
-interface RotateYawParam {
+export type GimbalRotateAction = ActionBase<"gimbalRotate", GimbalRotateParam>;
+export interface RotateYawParam {
   /** `[-180, 180]`, 0=N, 90=E, -90=W, ±180=S. */
   aircraftHeading: Degrees;
   /** Required on M300/M350. */
   aircraftPathMode?: AircraftPathMode;
 }
-type RotateYawAction = ActionBase<"rotateYaw", RotateYawParam>;
-interface HoverParam {
+export type RotateYawAction = ActionBase<"rotateYaw", RotateYawParam>;
+export interface HoverParam {
   /** seconds, > 0. */
   hoverTime: number;
 }
-type HoverAction = ActionBase<"hover", HoverParam>;
-interface GimbalEvenlyRotateParam {
+export type HoverAction = ActionBase<"hover", HoverParam>;
+export interface GimbalEvenlyRotateParam {
   payloadPositionIndex: number;
   gimbalPitchRotateAngle: Degrees;
 }
 /** Must be paired with `actionTriggerType === "betweenAdjacentPoints"`. */
-type GimbalEvenlyRotateAction = ActionBase<"gimbalEvenlyRotate", GimbalEvenlyRotateParam>;
+export type GimbalEvenlyRotateAction = ActionBase<"gimbalEvenlyRotate", GimbalEvenlyRotateParam>;
 /** Deprecated for M30/M30T after firmware V06.01.10.02. Prefer `orientedShoot`. */
-interface AccurateShootParam {
+export interface AccurateShootParam {
   gimbalPitchRotateAngle: Degrees;
   gimbalYawRotateAngle: Degrees;
   focusX: number;
@@ -512,8 +552,8 @@ interface AccurateShootParam {
   accurateCameraShutterTime?: number;
   accurateCameraISO?: number;
 }
-type AccurateShootAction = ActionBase<"accurateShoot", AccurateShootParam>;
-interface OrientedShootParam {
+export type AccurateShootAction = ActionBase<"accurateShoot", AccurateShootParam>;
+export interface OrientedShootParam {
   gimbalPitchRotateAngle: Degrees;
   gimbalYawRotateAngle: Degrees;
   focusX: number;
@@ -543,8 +583,8 @@ interface OrientedShootParam {
   orientedCameraISO: number;
   orientedPhotoMode: OrientedPhotoMode;
 }
-type OrientedShootAction = ActionBase<"orientedShoot", OrientedShootParam>;
-interface PanoShotParam {
+export type OrientedShootAction = ActionBase<"orientedShoot", OrientedShootParam>;
+export interface PanoShotParam {
   payloadPositionIndex?: number;
   payloadLensIndex?: LensType[];
   useGlobalPayloadLensIndex?: boolean;
@@ -552,14 +592,14 @@ interface PanoShotParam {
   actionUUID?: string;
   panoShotSubMode: PanoShotSubMode;
 }
-type PanoShotAction = ActionBase<"panoShot", PanoShotParam>;
-interface RecordPointCloudParam {
+export type PanoShotAction = ActionBase<"panoShot", PanoShotParam>;
+export interface RecordPointCloudParam {
   payloadPositionIndex: number;
   recordPointCloudOperate: RecordPointCloudOperate;
 }
-type RecordPointCloudAction = ActionBase<"recordPointCloud", RecordPointCloudParam>;
+export type RecordPointCloudAction = ActionBase<"recordPointCloud", RecordPointCloudParam>;
 /** M4D/M4TD only. */
-interface MegaphoneParam {
+export interface MegaphoneParam {
   payloadPositionIndex: number;
   actionUUID: string;
   /** 0 = start, 1 = stop. */
@@ -577,8 +617,8 @@ interface MegaphoneParam {
   /** Non-spec DJI Pilot TTS params observed in M4D/M4TD megaphone actions. */
   ttsparam?: MegaphoneTtsParam;
 }
-type MegaphoneAction = ActionBase<"megaphone", MegaphoneParam>;
-interface MegaphoneTtsParam {
+export type MegaphoneAction = ActionBase<"megaphone", MegaphoneParam>;
+export interface MegaphoneTtsParam {
   text: string;
   role: "male" | "female";
   language: "CN";
@@ -588,7 +628,7 @@ interface MegaphoneTtsParam {
   speed: number;
 }
 /** M4D/M4TD only — starts gimbal swing in smart-oblique mode. */
-interface SmartObliquePoint {
+export interface SmartObliquePoint {
   /** seconds before this pose starts; DJI exports currently use 0. */
   smartObliqueRunningTime: number;
   /** seconds to hold this pose for smart-oblique shooting. */
@@ -597,20 +637,20 @@ interface SmartObliquePoint {
   smartObliqueEulerRoll: Degrees;
   smartObliqueEulerYaw: Degrees;
 }
-interface StartSmartObliqueParam {
+export interface StartSmartObliqueParam {
   /** Observed in DJI exports; older generated files may omit it. */
   smartObliqueCycleMode?: "unlimited";
   payloadPositionIndex: number;
   smartObliquePoint?: SmartObliquePoint[];
 }
-type StartSmartObliqueAction = ActionBase<"startSmartOblique", StartSmartObliqueParam>;
+export type StartSmartObliqueAction = ActionBase<"startSmartOblique", StartSmartObliqueParam>;
 /** M4D/M4TD only — stops gimbal swing in smart-oblique mode. */
-interface StopSmartObliqueParam {
+export interface StopSmartObliqueParam {
   payloadPositionIndex: number;
 }
-type StopSmartObliqueAction = ActionBase<"stopSmartOblique", StopSmartObliqueParam>;
+export type StopSmartObliqueAction = ActionBase<"stopSmartOblique", StopSmartObliqueParam>;
 /** Starts interval (time-lapse) shooting for a mapping strip. */
-interface StartTimeLapseParam {
+export interface StartTimeLapseParam {
   payloadPositionIndex: number;
   useGlobalPayloadLensIndex: boolean;
   /** Comma-separated in WPML; may contain visible and infrared lenses together. */
@@ -618,35 +658,35 @@ interface StartTimeLapseParam {
   /** Minimum shoot interval in seconds. Derived from `forwardGroundSpacing / speed`. */
   minShootInterval: number;
 }
-type StartTimeLapseAction = ActionBase<"startTimeLapse", StartTimeLapseParam>;
+export type StartTimeLapseAction = ActionBase<"startTimeLapse", StartTimeLapseParam>;
 /** Stops interval shooting for a mapping strip. */
-interface StopTimeLapseParam {
+export interface StopTimeLapseParam {
   payloadPositionIndex: number;
   payloadLensIndex: LensType[];
 }
-type StopTimeLapseAction = ActionBase<"stopTimeLapse", StopTimeLapseParam>;
+export type StopTimeLapseAction = ActionBase<"stopTimeLapse", StopTimeLapseParam>;
 /** Locks gimbal pitch angle during a mapping strip. */
-interface GimbalAngleLockParam {
+export interface GimbalAngleLockParam {
   payloadPositionIndex: number;
 }
-type GimbalAngleLockAction = ActionBase<"gimbalAngleLock", GimbalAngleLockParam>;
+export 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 {
+export interface GimbalAngleUnlockAction {
   actionId: number;
   actionActuatorFunc: "gimbalAngleUnlock";
 }
 /** Sets camera focus mode (e.g. "manual") before a mapping run. */
-interface SetFocusTypeParam {
+export interface SetFocusTypeParam {
   payloadPositionIndex: number;
   /** e.g. `"manual"`, `"auto"`. */
   cameraFocusType: string;
 }
-type SetFocusTypeAction = ActionBase<"setFocusType", SetFocusTypeParam>;
+export type SetFocusTypeAction = ActionBase<"setFocusType", SetFocusTypeParam>;
 /** M4D/M4TD only. */
-interface SearchlightParam {
+export interface SearchlightParam {
   payloadPositionIndex: number;
   actionUUID?: string;
   /** 0 = off, 1 = illuminate, 2 = flash. */
@@ -654,7 +694,7 @@ interface SearchlightParam {
   /** 0–100. */
   searchlightBrightness: number;
 }
-type SearchlightAction = ActionBase<"searchlight", SearchlightParam>;
+export type SearchlightAction = ActionBase<"searchlight", SearchlightParam>;
 //#endregion
 //#region src/types/placemark.d.ts
 /**
@@ -662,7 +702,7 @@ type SearchlightAction = ActionBase<"searchlight", SearchlightParam>;
  *
  * Note coordinate order: `Point.coordinates` is `lon,lat` per KML (no altitude).
  */
-interface TemplateWaypointPlacemark {
+export interface TemplateWaypointPlacemark {
   Point: {
     coordinates: LngLat;
   };
@@ -693,10 +733,11 @@ interface TemplateWaypointPlacemark {
   actionGroup?: ActionGroup[];
 }
 /** Survey-area boundary polygon, shared by mapping2d / mapping3d Placemarks. */
-interface TemplatePolygon {
+export interface TemplatePolygon {
   outerBoundaryIs: {
     LinearRing: {
-      /** Space-separated `lon,lat,alt` triples. */coordinates: string;
+      /** Space-separated `lon,lat,alt` triples. */
+      coordinates: string;
     };
   };
 }
@@ -704,7 +745,7 @@ interface TemplatePolygon {
  * `Placemark` inside a `mapping2d` Folder. Per the WPML spec the shooting/mapping
  * params live HERE alongside the polygon — NOT on the Folder.
  */
-interface Mapping2dPlacemark {
+export interface Mapping2dPlacemark {
   /** M300/M350 only. */
   caliFlightEnable?: boolean;
   elevationOptimizeEnable: boolean;
@@ -737,7 +778,7 @@ interface Mapping2dPlacemark {
   height: Meters;
 }
 /** `Placemark` inside a `mapping3d` (oblique) Folder. Params live here, not on the Folder. */
-interface Mapping3dPlacemark {
+export interface Mapping3dPlacemark {
   caliFlightEnable?: boolean;
   inclinedGimbalPitch: Degrees;
   /** Range `[1, 15]`. */
@@ -752,7 +793,7 @@ interface Mapping3dPlacemark {
   height: Meters;
 }
 /** `Placemark` inside a FlightHub 2 patrol-area `targetdetection` Folder. */
-interface TargetDetectionPlacemark {
+export interface TargetDetectionPlacemark {
   direction: Degrees;
   margin: number;
   gimbalPitchMode: "fixed";
@@ -763,9 +804,12 @@ interface TargetDetectionPlacemark {
   mappingHeadingParam: MappingHeadingParam;
   gimbalPitchAngle: Degrees;
   recordEnable: boolean;
+  /** FlightHub 2 always emits this action for patrol-area routes. */
+  targetDetectionActionEnable?: boolean;
+  action?: TargetDetectionAction;
 }
 /** `Placemark` inside a `mappingStrip` Folder — uses a LineString; params live here. */
-interface MappingStripPlacemark {
+export interface MappingStripPlacemark {
   caliFlightEnable: boolean;
   /** Optional field observed in FlightHub 2 mappingStrip exports. */
   elevationOptimizeEnable?: boolean;
@@ -784,7 +828,8 @@ interface MappingStripPlacemark {
   /** Overlap ratios as percentages `[0, 100]`. */
   overlap: Overlap;
   LineString: {
-    /** Space-separated `lon,lat,alt` triples. Alt consumed only when `stripUseTemplateAltitude === true`. */coordinates: string;
+    /** Space-separated `lon,lat,alt` triples. Alt consumed only when `stripUseTemplateAltitude === true`. */
+    coordinates: string;
   };
   ellipsoidHeight: Meters;
   height: Meters;
@@ -797,7 +842,7 @@ interface MappingStripPlacemark {
  * The spec's `useGlobalXxx` switches are template-only — in waylines.wpml the
  * params are inlined unconditionally, so they are required here.
  */
-interface WaylinesPlacemark {
+export interface WaylinesPlacemark {
   Point: {
     coordinates: LngLat;
   };
@@ -825,7 +870,7 @@ interface WaylinesPlacemark {
  * `template.kml` document. Mirrors `<kml><Document>` structure.
  * See `docs/kmz/template-kml.html`.
  */
-type Template = WaypointTemplate | Mapping2dTemplate | Mapping3dTemplate | MappingStripTemplate | TargetDetectionTemplate;
+export type Template = WaypointTemplate | Mapping2dTemplate | Mapping3dTemplate | MappingStripTemplate | TargetDetectionTemplate;
 interface TemplateDocumentBase {
   /** Unix milliseconds. */
   author?: string;
@@ -837,10 +882,10 @@ interface TemplateDocumentBase {
   };
   missionConfig: MissionConfig;
 }
-interface WaypointTemplate extends TemplateDocumentBase {
+export interface WaypointTemplate extends TemplateDocumentBase {
   Folder: WaypointFolder;
 }
-interface WaypointFolder {
+export interface WaypointFolder {
   templateType: "waypoint";
   /** Range `[0, 65535]`. */
   templateId: number;
@@ -861,10 +906,10 @@ interface WaypointFolder {
   globalWaypointHeadingParam: WaypointHeadingParam;
   Placemark: TemplateWaypointPlacemark[];
 }
-interface Mapping2dTemplate extends TemplateDocumentBase {
+export interface Mapping2dTemplate extends TemplateDocumentBase {
   Folder: Mapping2dFolder;
 }
-interface Mapping2dFolder {
+export interface Mapping2dFolder {
   templateType: "mapping2d";
   templateId: number;
   waylineCoordinateSysParam: WaylineCoordinateSysParam;
@@ -873,10 +918,10 @@ interface Mapping2dFolder {
   /** Holds the survey polygon AND all shooting/mapping params (per WPML nesting). */
   Placemark: Mapping2dPlacemark;
 }
-interface Mapping3dTemplate extends TemplateDocumentBase {
+export interface Mapping3dTemplate extends TemplateDocumentBase {
   Folder: Mapping3dFolder;
 }
-interface Mapping3dFolder {
+export interface Mapping3dFolder {
   templateType: "mapping3d";
   templateId: number;
   waylineCoordinateSysParam: WaylineCoordinateSysParam;
@@ -885,10 +930,10 @@ interface Mapping3dFolder {
   /** Holds the survey polygon AND all shooting/mapping params. */
   Placemark: Mapping3dPlacemark;
 }
-interface TargetDetectionTemplate extends TemplateDocumentBase {
+export interface TargetDetectionTemplate extends TemplateDocumentBase {
   Folder: TargetDetectionFolder;
 }
-interface TargetDetectionFolder {
+export interface TargetDetectionFolder {
   templateType: "targetdetection";
   templateId: number;
   waylineCoordinateSysParam: WaylineCoordinateSysParam;
@@ -896,10 +941,10 @@ interface TargetDetectionFolder {
   payloadParam?: PayloadParam;
   Placemark: TargetDetectionPlacemark;
 }
-interface MappingStripTemplate extends TemplateDocumentBase {
+export interface MappingStripTemplate extends TemplateDocumentBase {
   Folder: MappingStripFolder;
 }
-interface MappingStripFolder {
+export interface MappingStripFolder {
   templateType: "mappingStrip";
   templateId: number;
   waylineCoordinateSysParam: WaylineCoordinateSysParam;
@@ -915,7 +960,7 @@ interface MappingStripFolder {
  * The XML `<wpml:startActionGroup>` element only wraps raw `<wpml:action>` items —
  * it has no `actionGroupId`, `actionGroupMode`, or `actionTrigger` elements.
  */
-interface StartActionGroup {
+export interface StartActionGroup {
   action: Action[];
 }
 /**
@@ -925,11 +970,11 @@ interface StartActionGroup {
  * Cardinality: `Folder` is `1..*` — `mapping3d` templates expand to 5 Folders
  * (1 ortho + 4 oblique).
  */
-interface Waylines {
+export interface Waylines {
   missionConfig: MissionConfig;
   Folder: WaylinesFolder[];
 }
-interface WaylinesFolder {
+export interface WaylinesFolder {
   /** Links back to template Folder's `templateId`. */
   templateId: number;
   waylineId: number;
@@ -981,7 +1026,7 @@ interface PlanOptions {
  *
  * Mapping templates require `options.lineSpacing` (meters between flight lines).
  */
-declare function plan(template: Template, options?: PlanOptions): Waylines;
+export declare function plan(template: Template, options?: PlanOptions): Waylines;
 //#endregion
 //#region src/plan/plan-mapping-strip.d.ts
 interface MappingStripRegion {
@@ -1011,12 +1056,14 @@ interface MappingStripDerived {
   surveyAreaSize: number;
   regions: MappingStripRegion[];
   flightRoutes: MappingStripRegionRoute[];
+  /** Horizontal mission distance, including known ingress and finish travel. */
   totalFlightLength: Meters;
   photoSpacing: Meters;
   estimatedPhotoCount: number;
+  /** Estimated horizontal flying seconds at the configured work/transit speeds. */
   estimatedDuration: number;
 }
-declare function deriveMappingStrip(template: MappingStripTemplate, options?: PlanOptions): MappingStripDerived;
+export declare function deriveMappingStrip(template: MappingStripTemplate, options?: PlanOptions): MappingStripDerived;
 //#endregion
 //#region src/validate/index.d.ts
 /**
@@ -1025,10 +1072,10 @@ declare function deriveMappingStrip(template: MappingStripTemplate, options?: Pl
  *
  * The function is non-throwing by design — callers decide how to react.
  */
-declare function validate(doc: Template | Waylines): Issue[];
+export declare function validate(doc: Template | Waylines): Issue[];
 //#endregion
 //#region src/plan/geometry.d.ts
 /** Great-circle distance between two WGS-84 coordinates, in meters. */
-declare function haversineMeters(a: LngLat, b: LngLat): number;
+export 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, 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, TargetDetectionFolder, TargetDetectionPlacemark, TargetDetectionTemplate, 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 };
+export type { MappingStripDerived, MappingStripRegion, MappingStripRegionRoute, PlanOptions };