trackswap 0.0.2 → 0.0.4

package/dist/FIT/types/sport.d.ts

@@ -1,47 +1,47 @@
 export declare enum Sport {
-    GENERIC = 0,// 通用
-    RUNNING = 1,// 跑步
-    CYCLING = 2,// 骑行
-    TRANSITION = 3,// 过渡
-    FITNESS_EQUIPMENT = 4,// 健身器材
-    SWIMMING = 5,// 游泳
-    BASKETBALL = 6,// 篮球
-    SOCCER = 7,// 足球
-    TENNIS = 8,// 网球
-    AMERICAN_FOOTBALL = 9,// 美式足球
-    TRAINING = 10,// 训练
-    WALKING = 11,// 步行
-    CROSS_COUNTRY_SKIING = 12,// 越野滑雪
-    ALPINE_SKIING = 13,// 高山滑雪
-    SNOWBOARDING = 14,// 滑雪板
-    ROWING = 15,// 划船
-    MOUNTAINEERING = 16,// 登山
-    HIKING = 17,// 徒步
-    MULTISPORT = 18,// 多项运动
-    PADDLING = 19,// 划水
-    FLYING = 20,// 飞行
-    E_BIKING = 21,// 电动自行车
-    MOTORCYCLING = 22,// 摩托车
-    BOATING = 23,// 划船
-    DRIVING = 24,// 驾驶
-    GOLF = 25,// 高尔夫
-    HANG_GLIDING = 26,// 悬挂滑翔
-    HORSEBACK_RIDING = 27,// 骑马
-    HUNTING = 28,// 狩猎
-    FISHING = 29,// 钓鱼
-    INLINE_SKATING = 30,// 轮滑
-    ROCK_CLIMBING = 31,// 攀岩
-    SAILING = 32,// 帆船
-    ICE_SKATING = 33,// 滑冰
-    SKY_DIVING = 34,// 跳伞
-    SNOWSHOEING = 35,// 雪鞋行走
-    SNOWMOBILING = 36,// 雪地摩托
-    STAND_UP_PADDLEBOARDING = 37,// 站立式划桨
-    SURFING = 38,// 冲浪
-    WAKEBOARDING = 39,// 尾波滑水
-    WATER_SKIING = 40,// 滑水
-    YOGA = 41,// 瑜伽
-    PILATES = 42,// 普拉提
-    CALISTHENICS = 43,// 徒手健身
+    GENERIC = 0,
+    RUNNING = 1,
+    CYCLING = 2,
+    TRANSITION = 3,
+    FITNESS_EQUIPMENT = 4,
+    SWIMMING = 5,
+    BASKETBALL = 6,
+    SOCCER = 7,
+    TENNIS = 8,
+    AMERICAN_FOOTBALL = 9,
+    TRAINING = 10,
+    WALKING = 11,
+    CROSS_COUNTRY_SKIING = 12,
+    ALPINE_SKIING = 13,
+    SNOWBOARDING = 14,
+    ROWING = 15,
+    MOUNTAINEERING = 16,
+    HIKING = 17,
+    MULTISPORT = 18,
+    PADDLING = 19,
+    FLYING = 20,
+    E_BIKING = 21,
+    MOTORCYCLING = 22,
+    BOATING = 23,
+    DRIVING = 24,
+    GOLF = 25,
+    HANG_GLIDING = 26,
+    HORSEBACK_RIDING = 27,
+    HUNTING = 28,
+    FISHING = 29,
+    INLINE_SKATING = 30,
+    ROCK_CLIMBING = 31,
+    SAILING = 32,
+    ICE_SKATING = 33,
+    SKY_DIVING = 34,
+    SNOWSHOEING = 35,
+    SNOWMOBILING = 36,
+    STAND_UP_PADDLEBOARDING = 37,
+    SURFING = 38,
+    WAKEBOARDING = 39,
+    WATER_SKIING = 40,
+    YOGA = 41,
+    PILATES = 42,
+    CALISTHENICS = 43,
     ALL = 254
 }

package/dist/FIT/types.d.ts

@@ -1,7 +1,4 @@
 import { IProcessingContext } from "../core/base.js";
-/**
- * Session 对应 AbstractTrackType Lap 对应 RouteSegType Records 对应 RouteType 每个Record 对应 PointType
- */
 export interface FITFileType {
     fileIdMesgs?: FileIdMesgType[];
     fileCreatorMesgs?: FileCreatorMesgType[];
@@ -62,9 +59,6 @@ export interface DeviceSettingsMesgType {
     timeZoneOffset?: number;
     backlightMode?: string;
 }
-/**
- * FIT userProfileMesg
- */
 export interface UserProfileMesgType {
     friendlyName?: string;
     weight?: number;
@@ -84,17 +78,8 @@ export interface UserProfileMesgType {
     positionSetting?: string;
     temperatureSetting?: string;
 }
-/**
- * FIT SessionMesg
- */
 export interface SessionMesgType {
-    /**
-     * 时间
-     */
     timestamp?: string;
-    /**
-     * 开始时间
-     */
     startTime?: string;
     startPositionLat?: number;
     startPositionLong?: number;
@@ -114,13 +99,7 @@ export interface SessionMesgType {
     maxSpeed?: number;
     avgPower?: number;
     maxPower?: number;
-    /**
-     * 总爬升
-     */
     totalAscent?: number;
-    /**
-     * 总下降
-     */
     totalDescent?: number;
     firstLapIndex?: number;
     numLaps?: number;
@@ -140,9 +119,6 @@ export interface SessionMesgType {
     enhancedMaxSpeed?: number;
     lapMesgs?: LapMesgType[];
 }
-/**
- * FIT RecordMesg
- */
 export interface RecordMesgType {
     timestamp?: string;
     positionLat?: number;
@@ -159,9 +135,6 @@ export interface RecordMesgType {
     enhancedSpeed?: number;
     [key: string]: number | string | undefined | any;
 }
-/**
- * FIT 文件额外记录的数据 LapMesg
- */
 export interface LapMesgType {
     timestamp?: string;
     startTime?: string;
@@ -204,23 +177,15 @@ export interface ActivityMesgType {
     eventType?: string;
     [key: string]: number | string | undefined | any;
 }
-/**
- * FIT 消息处理上下文
- */
 export interface FITContext extends IProcessingContext {
-    /** 原始二进制数据 */
     rawData?: Buffer;
-    /** FIT SDK 解析的原始消息 */
     rawMessages?: FITDecoderMesgs;
-    /** 最终结果 */
     result?: FITFileType;
-    /** FIT 文件头信息 */
     fileHeader?: {
         type?: string;
         manufacturer?: string;
         product?: number;
     };
-    /** FIT 特定的性能统计 */
     performance: {
         startTime: number;
         parseTime?: number;

package/dist/GPX/base.d.ts

@@ -1,60 +1,16 @@
-import { IPlugin as ICorePlugin, IConverterPlugin as ICoreConverterPlugin, IMiddlewarePlugin as ICoreMiddlewarePlugin, BaseConverter as CoreBaseConverter, BaseMiddleware as CoreBaseMiddleware } from "../core/base.js";
+import { IPlugin, IConverterPlugin, IMiddlewarePlugin, BaseConverter, BaseMiddleware } from "../core/base.js";
 import { DecoderContext, GPX11Type } from "./types.js";
-/**
- * GPX 插件接口（继承通用插件接口）
- */
-export interface IGPXPlugin extends ICorePlugin<DecoderContext> {
+export interface IGPXPlugin extends IPlugin<DecoderContext> {
 }
-/**
- * GPX 转换器插件接口（继承通用转换器接口）
- */
-export interface IGPXConverterPlugin extends ICoreConverterPlugin<DecoderContext> {
+export interface IGPXConverterPlugin extends IConverterPlugin<DecoderContext> {
 }
-/**
- * GPX 中间件插件接口（继承通用中间件接口）
- */
-export interface IGPXMiddlewarePlugin extends ICoreMiddlewarePlugin<DecoderContext, GPX11Type> {
+export interface IGPXMiddlewarePlugin extends IMiddlewarePlugin<DecoderContext, GPX11Type> {
 }
-/**
- * GPX 基础转换器抽象类（继承通用基础转换器）
- */
-export declare abstract class BaseGPXConverter extends CoreBaseConverter<DecoderContext> implements IGPXConverterPlugin {
-    /**
-     * 解析 GPX 坐标值（经纬度）
-     */
+export declare abstract class BaseGPXConverter extends BaseConverter<DecoderContext> implements IGPXConverterPlugin {
     protected parseCoordinate(value: string | number | undefined): number | undefined;
-    /**
-     * 解析 GPX 时间格式
-     */
     protected parseGPXTime(value: string | undefined): Date | undefined;
-    /**
-     * 提取数值属性（GPX 常用的处理方式）
-     */
     protected extractNumericAttributes<U extends Record<string, any>>(ast: any, target: U, mapping: Record<string, keyof U>): void;
 }
-/**
- * GPX 基础中间件抽象类（继承通用基础中间件）
- */
-export declare abstract class BaseGPXMiddleware extends CoreBaseMiddleware<DecoderContext, GPX11Type> implements IGPXMiddlewarePlugin {
+export declare abstract class BaseGPXMiddleware extends BaseMiddleware<DecoderContext, GPX11Type> implements IGPXMiddlewarePlugin {
     onError(error: Error, context: DecoderContext): Promise<void>;
 }
-/**
- * @deprecated 使用 IGPXPlugin 替代
- */
-export type IPlugin = IGPXPlugin;
-/**
- * @deprecated 使用 IGPXConverterPlugin 替代
- */
-export type IConverterPlugin = IGPXConverterPlugin;
-/**
- * @deprecated 使用 IGPXMiddlewarePlugin 替代
- */
-export type IMiddlewarePlugin = IGPXMiddlewarePlugin;
-/**
- * @deprecated 使用 BaseGPXConverter 替代
- */
-export declare const BaseConverter: typeof BaseGPXConverter;
-/**
- * @deprecated 使用 BaseGPXMiddleware 替代
- */
-export declare const BaseMiddleware: typeof BaseGPXMiddleware;

package/dist/GPX/converters.d.ts

@@ -1,82 +1,52 @@
 import { BaseGPXConverter } from "./base.js";
 import { TokenAST } from "../types.js";
 import { BoundsType, CopyrightType, EmailType, LinkType, MetadataType, PersonType, RteType, TrksegType, TrkType, WptType, DecoderContext } from "./types.js";
-/**
- * WPT转换器
- */
 export declare class WptConverter extends BaseGPXConverter {
     name: string;
     supportedTags: string[];
     version: string;
     convert(ast: TokenAST, context: DecoderContext): WptType | undefined;
 }
-/**
- * Route转换器
- */
 export declare class RteConverter extends BaseGPXConverter {
     name: string;
     supportedTags: string[];
     convert(ast: TokenAST, context: DecoderContext): RteType | undefined;
 }
-/**
- * Track转换器
- */
 export declare class TrkConverter extends BaseGPXConverter {
     name: string;
     supportedTags: string[];
     convert(ast: TokenAST, context: DecoderContext): TrkType | undefined;
 }
-/**
- * Track Segment转换器
- */
 export declare class TrksegConverter extends BaseGPXConverter {
     name: string;
     supportedTags: string[];
     convert(ast: TokenAST, context: DecoderContext): TrksegType | undefined;
 }
-/**
- * Link转换器
- */
 export declare class LinkConverter extends BaseGPXConverter {
     name: string;
     supportedTags: string[];
     convert(ast: TokenAST, context: DecoderContext): LinkType | undefined;
 }
-/**
- * Metadata转换器
- */
 export declare class MetadataConverter extends BaseGPXConverter {
     name: string;
     supportedTags: string[];
     convert(ast: TokenAST, context: DecoderContext): MetadataType | undefined;
 }
-/**
- * Person转换器
- */
 export declare class PersonConverter extends BaseGPXConverter {
     name: string;
     supportedTags: string[];
     convert(ast: TokenAST, context: DecoderContext): PersonType | undefined;
 }
-/**
- * Email转换器
- */
 export declare class EmailConverter extends BaseGPXConverter {
     name: string;
     supportedTags: string[];
     convert(ast: TokenAST, context: DecoderContext): EmailType | undefined;
 }
-/**
- * Copyright转换器
- */
 export declare class CopyrightConverter extends BaseGPXConverter {
     name: string;
     supportedTags: string[];
     convert(ast: TokenAST, context: DecoderContext): CopyrightType | undefined;
 }
-/**
- * Bounds转换器
- */
 export declare class BoundsConverter extends BaseGPXConverter {
     name: string;
     supportedTags: string[];

package/dist/GPX/decoder.d.ts

@@ -1,9 +1,6 @@
 import { ExtensionsType, TokenAST } from "../types.js";
 import { IGPXConverterPlugin, IGPXMiddlewarePlugin } from "./base.js";
 import { GPX11Type } from "./types.js";
-/**
- * GPX解码器主类
- */
 export declare class GPXDecoder {
     private converterPlugins;
     private registeredPlugins;
@@ -12,95 +9,32 @@ export declare class GPXDecoder {
     private initialized;
     private defaultConvertersRegistered;
     constructor();
-    /**
-     * 初始化流水线 - 注册固定的核心处理器
-     */
     private initializePipeline;
-    /**
-     * 自动注册默认转换器 - 处理标准GPX标签
-     */
     private registerDefaultConverters;
-    /**
-     * 为指定标签添加转换器，按优先级排序
-     */
     private addConverterForTag;
-    /**
-     * 注册转换器插件
-     */
     registerConverter(plugin: IGPXConverterPlugin): Promise<void>;
-    /**
-     * 注册中间件插件 - 真正的扩展点
-     */
     registerMiddleware(plugin: IGPXMiddlewarePlugin): Promise<void>;
-    /**
-     * 获取转换器（返回优先级最高的）
-     */
     getConverter(tag: string): IGPXConverterPlugin | undefined;
-    /**
-     * 获取指定标签的所有转换器（按优先级排序）
-     */
     getAllConverters(tag: string): IGPXConverterPlugin[];
-    /**
-     * 移除转换器
-     */
     unregisterConverter(pluginName: string): void;
-    /**
-     * 移除中间件
-     */
     unregisterMiddleware(name: string): void;
-    /**
-     * 列出所有已注册的转换器标签
-     */
     listConverters(): string[];
-    /**
-     * 列出所有已注册的转换器插件
-     */
     listConverterPlugins(): string[];
-    /**
-     * 列出所有已注册的中间件
-     */
     listMiddlewares(): string[];
-    /**
-     * 列出核心处理器（只读）
-     */
     listProcessors(): string[];
-    /**
-     * 获取标签的转换器详情（包括优先级信息）
-     */
     getConverterDetails(tag?: string): Record<string, Array<{
         name: string;
         priority: number;
     }>>;
-    /**
-     * 获取中间件详情（包括支持的钩子）
-     */
     getMiddlewareDetails(): Array<{
         name: string;
         hooks: string[];
     }>;
-    /**
-     * 初始化解码器
-     */
     initialize(): Promise<void>;
-    /**
-     * 销毁解码器
-     */
     destroy(): Promise<void>;
-    /**
-     * 创建解码上下文
-     */
     private createContext;
-    /**
-     * 执行中间件钩子
-     */
     private executeMiddlewareHook;
-    /**
-     * 主解析方法 - 固定的流水线 + 灵活的中间件
-     */
     parserByBuffer(buffer: Buffer): Promise<GPX11Type | undefined>;
-    /**
-     * 转换Extensions（向后兼容）
-     */
     convertExtensions(extensionsAST: TokenAST): ExtensionsType;
 }
 declare const _default: {

package/dist/GPX/encoder.d.ts

@@ -1,151 +1,42 @@
 import { GPX11Type } from "./types.js";
-/**
- * GPX 编码器 - 将 GPX11Type 数据编码为 GPX XML 格式
- */
 export declare class GPXEncoder {
     private compact;
-    /**
-     * 构造函数
-     * @param options 编码器选项
-     */
     constructor(options?: {
         compact?: boolean;
     });
-    /**
-     * 编码 GPX 数据为 Buffer
-     */
     encode(gpxData: GPX11Type): Promise<Buffer>;
-    /**
-     * 编码 GPX 数据为 XML 字符串
-     */
     encodeToString(gpxData: GPX11Type): string;
-    /**
-     * 构建完整的 GPX XML
-     */
     private buildGPXXML;
-    /**
-     * 压缩XML字符串，去掉多余的换行和空格
-     */
     private compressXML;
-    /**
-     * 构建 XML 头部
-     */
     private buildXMLHeader;
-    /**
-     * 构建 GPX 内容
-     */
     private buildGPXContent;
-    /**
-     * 构建 metadata 元素
-     */
     private buildMetadata;
-    /**
-     * 构建 author 元素
-     */
     private buildAuthor;
-    /**
-     * 构建 copyright 元素
-     */
     private buildCopyright;
-    /**
-     * 构建 bounds 元素
-     */
     private buildBounds;
-    /**
-     * 构建航路点元素
-     */
     private buildWaypoint;
-    /**
-     * 添加标准航路点元素
-     */
     private addStandardWaypointElements;
-    /**
-     * 构建 rte 元素
-     */
     private buildRoute;
-    /**
-     * 构建轨迹元素
-     */
     private buildTrack;
-    /**
-     * 构建轨迹段元素
-     */
     private buildTrackSegment;
-    /**
-     * 添加路线和轨迹的公共元素
-     */
     private addRouteTrackCommonElements;
-    /**
-     * 处理点的扩展属性
-     */
     private processPointExtensions;
-    /**
-     * 构建 TrackPoint 扩展
-     */
     private buildTrackPointExtension;
-    /**
-     * 构建 Power 扩展
-     */
     private buildPowerExtension;
-    /**
-     * 构建 GPX 扩展
-     */
     private buildGpxExtensions;
-    /**
-     * 构建扩展元素
-     */
     private buildExtensions;
-    /**
-     * 递归构建扩展内容
-     */
     private buildExtensionContent;
-    /**
-     * 构建 link 元素
-     */
     private buildLink;
-    /**
-     * 添加多个 link 元素
-     */
     private addLinks;
-    /**
-     * 构建时间元素
-     */
     private buildTimeElement;
-    /**
-     * 添加可选元素
-     */
     private addOptionalElement;
-    /**
-     * 验证坐标有效性
-     */
     private isValidCoordinate;
-    /**
-     * 格式化坐标
-     */
     private formatCoordinate;
-    /**
-     * 格式化高程
-     */
     private formatElevation;
-    /**
-     * 数字四舍五入
-     */
     private roundTo;
-    /**
-     * XML 转义
-     */
     private escapeXML;
-    /**
-     * XML 属性值转义（专门用于属性值的安全转义）
-     */
     private escapeXMLAttribute;
-    /**
-     * 深度拷贝
-     */
     private deepClone;
-    /**
-     * @deprecated 使用 encode() 替代
-     */
     encoder(node: GPX11Type): Promise<Buffer>;
 }
 declare const _default: {

package/dist/GPX/middleware.d.ts

@@ -1,9 +1,6 @@
 import { Token, TokenAST } from "../types";
 import { BaseGPXMiddleware } from "./base";
 import { DecoderContext } from "./types";
-/**
- * 性能监控中间件
- */
 export declare class PerformanceMiddleware extends BaseGPXMiddleware {
     name: string;
     description: string;
@@ -12,16 +9,10 @@ export declare class PerformanceMiddleware extends BaseGPXMiddleware {
     onComplete(result: any, context: DecoderContext): Promise<any>;
     private countNodes;
 }
-/**
- * 验证中间件
- */
 export declare class ValidationMiddleware extends BaseGPXMiddleware {
     name: string;
     description: string;
     onComplete(result: any, context: DecoderContext): Promise<any>;
     private validateGPX;
 }
-/**
- * 注册所有默认中间件
- */
 export declare function registerDefaultMiddlewares(decoder: any): Promise<void>;

package/dist/GPX/processor.d.ts

@@ -1,37 +1,22 @@
 import { DecoderContext } from "./types.js";
-/**
- * 流水线阶段
- */
 export declare enum PipelineStage {
     TOKENIZE = "tokenize",
     AST_GENERATE = "ast_generate",
     CONVERT = "convert",
     COMPLETE = "complete"
 }
-/**
- * 流水线处理器
- */
 export interface IPipelineProcessor {
     stage: PipelineStage;
     process(context: DecoderContext): Promise<DecoderContext>;
 }
-/**
- * Tokenize处理器, 将xml转为 token
- */
 export declare class TokenizeProcessor implements IPipelineProcessor {
     stage: PipelineStage;
     process(context: DecoderContext): Promise<DecoderContext>;
 }
-/**
- * AST生成处理器
- */
 export declare class AstGenerateProcessor implements IPipelineProcessor {
     stage: PipelineStage;
     process(context: DecoderContext): Promise<DecoderContext>;
 }
-/**
- * 转换处理器
- */
 export declare class ConvertProcessor implements IPipelineProcessor {
     private getConverter;
     stage: PipelineStage;
@@ -39,9 +24,6 @@ export declare class ConvertProcessor implements IPipelineProcessor {
     process(context: DecoderContext): Promise<DecoderContext>;
     private assignResult;
 }
-/**
- * 完成处理器
- */
 export declare class CompleteProcessor implements IPipelineProcessor {
     stage: PipelineStage;
     process(context: DecoderContext): Promise<DecoderContext>;