@tx5dr/contracts 1.2.0

package/dist/schema/logbook.schema.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"logbook.schema.d.ts","sourceRoot":"","sources":["../../src/schema/logbook.schema.ts"],"names":[],"mappings":"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"}

package/dist/schema/logbook.schema.js

@@ -0,0 +1,256 @@
+import { z } from 'zod';
+export const DxccCountSummarySchema = z.object({
+    current: z.number().default(0),
+    total: z.number().default(0),
+    deleted: z.number().default(0),
+});
+export const DxccBucketItemSchema = z.object({
+    key: z.string(),
+    worked: z.number().default(0),
+    confirmed: z.number().default(0),
+});
+export const LogBookDxccSummarySchema = z.object({
+    worked: DxccCountSummarySchema,
+    confirmed: DxccCountSummarySchema,
+    reviewCount: z.number().default(0),
+    byBand: z.array(DxccBucketItemSchema).default([]),
+    byMode: z.array(DxccBucketItemSchema).default([]),
+});
+/**
+ * 日志本信息Schema
+ */
+export const LogBookInfoSchema = z.object({
+    id: z.string(),
+    name: z.string(),
+    description: z.string().optional(),
+    filePath: z.string(),
+    createdAt: z.number(),
+    lastUsed: z.number(),
+    isActive: z.boolean(),
+});
+/**
+ * 创建日志本请求Schema
+ */
+export const CreateLogBookRequestSchema = z.object({
+    id: z.string(),
+    name: z.string(),
+    description: z.string().optional(),
+    filePath: z.string().optional(),
+    logFileName: z.string().optional(),
+    autoCreateFile: z.boolean().optional().default(true),
+});
+/**
+ * 更新日志本请求Schema
+ */
+export const UpdateLogBookRequestSchema = z.object({
+    name: z.string().optional(),
+    description: z.string().optional(),
+    isActive: z.boolean().optional(),
+});
+/**
+ * 连接操作员到日志本请求Schema
+ */
+export const ConnectOperatorToLogBookRequestSchema = z.object({
+    operatorId: z.string(),
+    logBookId: z.string(),
+});
+/**
+ * 日志本统计信息Schema
+ */
+export const LogBookStatisticsSchema = z.object({
+    totalQSOs: z.number(),
+    totalOperators: z.number(),
+    uniqueCallsigns: z.number(),
+    lastQSO: z.string().optional(),
+    firstQSO: z.string().optional(),
+    dxcc: LogBookDxccSummarySchema.optional(),
+});
+/**
+ * 日志本列表响应Schema
+ */
+export const LogBookListResponseSchema = z.object({
+    success: z.boolean(),
+    data: z.array(LogBookInfoSchema),
+});
+/**
+ * 日志本详情响应Schema
+ */
+export const LogBookDetailResponseSchema = z.object({
+    success: z.boolean(),
+    data: LogBookInfoSchema.merge(z.object({
+        statistics: LogBookStatisticsSchema,
+        connectedOperators: z.array(z.string()),
+    })),
+});
+/**
+ * 日志本操作响应Schema
+ */
+export const LogBookActionResponseSchema = z.object({
+    success: z.boolean(),
+    message: z.string(),
+    data: LogBookInfoSchema.optional(),
+});
+/**
+ * 日志本QSO查询选项Schema
+ */
+export const LogBookQSOQueryOptionsSchema = z.object({
+    callsign: z.string().optional(),
+    grid: z.string().optional(),
+    band: z.string().optional(),
+    mode: z.string().optional(),
+    dxccStatus: z.enum(['deleted']).optional(),
+    qslFlow: z.enum(['two_way_confirmed', 'not_two_way_confirmed']).optional(),
+    /** 排除的模式列表，逗号分隔，如 "FT8,FT4" */
+    excludeModes: z.string().optional(),
+    startDate: z.string().optional(),
+    endDate: z.string().optional(),
+    qslStatus: z.enum(['confirmed', 'uploaded', 'none']).optional(),
+    limit: z.coerce.number().optional().default(100),
+    offset: z.coerce.number().optional().default(0),
+});
+export const LogBookRecentGlobeQuerySchema = z.object({
+    operatorId: z.string().optional(),
+    hours: z.coerce.number().int().min(1).max(168).optional().default(24),
+    limit: z.coerce.number().int().min(1).max(500).optional().default(300),
+});
+export const LogBookRecentGlobeHomeSourceSchema = z.enum([
+    'operator_grid',
+    'station_coordinates',
+    'station_grid',
+]);
+export const LogBookRecentGlobeHomeSchema = z.object({
+    source: LogBookRecentGlobeHomeSourceSchema,
+    grid: z.string().optional(),
+    latitude: z.number().min(-90).max(90),
+    longitude: z.number().min(-180).max(180),
+});
+export const LogBookRecentGlobeItemSchema = z.object({
+    id: z.string(),
+    callsign: z.string(),
+    startTime: z.number(),
+    mode: z.string(),
+    frequency: z.number(),
+    grid: z.string(),
+});
+export const LogBookRecentGlobeResponseSchema = z.object({
+    success: z.boolean(),
+    data: z.object({
+        home: LogBookRecentGlobeHomeSchema.nullable(),
+        items: z.array(LogBookRecentGlobeItemSchema),
+        meta: z.object({
+            hours: z.number().int().min(1),
+            totalReturned: z.number().int().nonnegative(),
+            droppedInvalidGrid: z.number().int().nonnegative(),
+            limited: z.boolean(),
+        }),
+    }),
+});
+export const LogBookWorkedGridQuerySchema = z.object({
+    band: z.string().optional(),
+});
+export const LogBookWorkedGridItemSchema = z.object({
+    grid: z.string().regex(/^[A-R]{2}[0-9]{2}$/),
+    count: z.number().int().positive(),
+});
+export const LogBookWorkedGridResponseSchema = z.object({
+    success: z.boolean(),
+    data: z.object({
+        items: z.array(LogBookWorkedGridItemSchema),
+        meta: z.object({
+            band: z.string().optional(),
+            total: z.number().int().nonnegative(),
+        }),
+    }),
+});
+/**
+ * 日志本导出选项Schema
+ */
+export const LogBookExportOptionsSchema = z.object({
+    format: z.enum(['adif', 'csv']).default('adif'),
+    startDate: z.string().optional(),
+    endDate: z.string().optional(),
+    callsign: z.string().optional(),
+});
+export const LogBookImportFormatSchema = z.enum(['adif', 'csv']);
+export const LogBookImportResultSchema = z.object({
+    detectedFormat: LogBookImportFormatSchema,
+    totalRead: z.number().int().nonnegative(),
+    imported: z.number().int().nonnegative(),
+    merged: z.number().int().nonnegative(),
+    skipped: z.number().int().nonnegative(),
+});
+export const LogBookImportResponseSchema = z.object({
+    success: z.boolean(),
+    message: z.string(),
+    data: LogBookImportResultSchema,
+});
+/**
+ * 更新QSO记录请求Schema
+ */
+export const UpdateQSORequestSchema = z.object({
+    callsign: z.string().optional(),
+    grid: z.string().optional(),
+    qth: z.string().optional(),
+    frequency: z.number().optional(),
+    mode: z.string().optional(),
+    submode: z.string().optional(),
+    startTime: z.number().optional(),
+    endTime: z.number().optional(),
+    reportSent: z.string().optional(),
+    reportReceived: z.string().optional(),
+    messageHistory: z.array(z.string()).optional(),
+    comment: z.string().optional(),
+    myGrid: z.string().optional(),
+    myCallsign: z.string().optional(),
+    // QSL 确认状态
+    lotwQslSent: z.enum(['Y', 'N', 'R', 'Q', 'I']).optional(),
+    lotwQslReceived: z.enum(['Y', 'N', 'R', 'I', 'V']).optional(),
+    lotwQslSentDate: z.number().optional(),
+    lotwQslReceivedDate: z.number().optional(),
+    qrzQslSent: z.enum(['Y', 'N']).optional(),
+    qrzQslReceived: z.enum(['Y', 'N']).optional(),
+    qrzQslSentDate: z.number().optional(),
+    qrzQslReceivedDate: z.number().optional(),
+    notes: z.string().optional(),
+});
+/**
+ * 手动补录QSO记录请求Schema
+ */
+export const CreateQSORequestSchema = z.object({
+    callsign: z.string().min(1),
+    frequency: z.number().positive(),
+    mode: z.string().min(1),
+    submode: z.string().optional(),
+    startTime: z.number().positive(),
+    endTime: z.number().optional(),
+    grid: z.string().optional(),
+    qth: z.string().optional(),
+    reportSent: z.string().optional(),
+    reportReceived: z.string().optional(),
+    messageHistory: z.array(z.string()).optional().default([]),
+    comment: z.string().optional(),
+    notes: z.string().optional(),
+});
+/**
+ * QSO操作响应Schema
+ */
+export const QSOActionResponseSchema = z.object({
+    success: z.boolean(),
+    message: z.string(),
+    data: z.object({
+        id: z.string(),
+        callsign: z.string(),
+        grid: z.string().optional(),
+        frequency: z.number(),
+        mode: z.string(),
+        submode: z.string().optional(),
+        startTime: z.number(),
+        endTime: z.number().optional(),
+        reportSent: z.string().optional(),
+        reportReceived: z.string().optional(),
+        messageHistory: z.array(z.string()),
+        comment: z.string().optional(),
+        notes: z.string().optional(),
+    }).optional(),
+});
+//# sourceMappingURL=logbook.schema.js.map

package/dist/schema/logbook.schema.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"logbook.schema.js","sourceRoot":"","sources":["../../src/schema/logbook.schema.ts"],"names":[],"mappings":"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"}

package/dist/schema/mode.schema.d.ts

@@ -0,0 +1,130 @@
+import { z } from 'zod';
+/**
+ * 模式描述符 - 定义 FT8/FT4 等模式的时序参数
+ */
+export declare const ModeDescriptorSchema: z.ZodObject<{
+    /** 模式名称，如 "FT8", "FT4" */
+    name: z.ZodString;
+    /** 时隙长度（毫秒），FT8=15000, FT4=7500, VOICE=0 */
+    slotMs: z.ZodNumber;
+    /** 时钟容差（毫秒） */
+    toleranceMs: z.ZodDefault<z.ZodNumber>;
+    /**
+     * 窗口时机（毫秒）- 必需
+     * 使用这些时机作为从时隙结束时间的偏移量
+     * 每个窗口都会获取固定长度的解码数据（FT8: 15秒，FT4: 7.5秒）
+     * 数组长度决定了子窗口的数量
+     * 支持负偏移，可以获取时隙结束前或其他周期的音频数据
+     */
+    windowTiming: z.ZodArray<z.ZodNumber, "many">;
+    /**
+     * 发射时机（毫秒）- 从时隙开始的延迟
+     * 对齐 WSJT-X 标准：信号在时隙边界后 ~0.5s 开始
+     * FT8: 500ms（信号 T+0.5s 起，12.64s 长，T+13.14s 结束）
+     * FT4: 500ms（信号 T+0.5s 起，6.0s 长，T+6.5s 结束，留 1.0s 给末端解码）
+     */
+    transmitTiming: z.ZodNumber;
+    /**
+     * 编码提前量（毫秒）- 在transmitTiming之前多久开始编码
+     * 默认400ms,用于补偿编码+混音时间
+     */
+    encodeAdvance: z.ZodDefault<z.ZodNumber>;
+}, "strip", z.ZodTypeAny, {
+    name: string;
+    slotMs: number;
+    toleranceMs: number;
+    windowTiming: number[];
+    transmitTiming: number;
+    encodeAdvance: number;
+}, {
+    name: string;
+    slotMs: number;
+    windowTiming: number[];
+    transmitTiming: number;
+    toleranceMs?: number | undefined;
+    encodeAdvance?: number | undefined;
+}>;
+export type ModeDescriptor = z.infer<typeof ModeDescriptorSchema>;
+/**
+ * 预定义的模式
+ */
+export declare const MODES: {
+    readonly FT8: ModeDescriptor;
+    readonly FT4: ModeDescriptor;
+    readonly VOICE: ModeDescriptor;
+};
+/**
+ * 解码窗口预设
+ */
+export declare const DecodeWindowPreset: {
+    readonly MAXIMUM: "maximum";
+    readonly BALANCED: "balanced";
+    readonly LIGHTWEIGHT: "lightweight";
+    readonly MINIMUM: "minimum";
+    readonly CUSTOM: "custom";
+};
+/**
+ * FT8 解码窗口预设映射
+ * 偏移量基于时隙结束时间（T+15000ms），即 offset = 实际触发时间 - 15000
+ * FT8 信号：T+500ms 开始，T+13140ms 结束（12.64s）
+ * WSJT-X 标准三轮：T+11.8s(-3200) / T+13.5s(-1500) / T+14.7s(-300)
+ */
+export declare const FT8_WINDOW_PRESETS: Record<string, number[]>;
+/**
+ * FT4 解码窗口预设映射
+ * 偏移量基于时隙结束时间（T+7500ms）
+ * FT4 信号：T+500ms 开始，T+6500ms 结束（6.0s）
+ * 双 pass 设计对齐 WSJT-X/JTDX：早 pass 让下一周期 encodeStart 前能用上结果
+ */
+export declare const FT4_WINDOW_PRESETS: Record<string, number[]>;
+/**
+ * 解码窗口设置 Schema
+ */
+export declare const DecodeWindowSettingsSchema: z.ZodObject<{
+    ft8: z.ZodOptional<z.ZodObject<{
+        preset: z.ZodDefault<z.ZodEnum<["maximum", "balanced", "lightweight", "minimum", "custom"]>>;
+        customWindowTiming: z.ZodOptional<z.ZodArray<z.ZodNumber, "many">>;
+    }, "strip", z.ZodTypeAny, {
+        preset: "minimum" | "maximum" | "custom" | "balanced" | "lightweight";
+        customWindowTiming?: number[] | undefined;
+    }, {
+        preset?: "minimum" | "maximum" | "custom" | "balanced" | "lightweight" | undefined;
+        customWindowTiming?: number[] | undefined;
+    }>>;
+    ft4: z.ZodOptional<z.ZodObject<{
+        preset: z.ZodDefault<z.ZodEnum<["maximum", "balanced", "lightweight", "custom"]>>;
+        customWindowTiming: z.ZodOptional<z.ZodArray<z.ZodNumber, "many">>;
+    }, "strip", z.ZodTypeAny, {
+        preset: "maximum" | "custom" | "balanced" | "lightweight";
+        customWindowTiming?: number[] | undefined;
+    }, {
+        preset?: "maximum" | "custom" | "balanced" | "lightweight" | undefined;
+        customWindowTiming?: number[] | undefined;
+    }>>;
+}, "strip", z.ZodTypeAny, {
+    ft8?: {
+        preset: "minimum" | "maximum" | "custom" | "balanced" | "lightweight";
+        customWindowTiming?: number[] | undefined;
+    } | undefined;
+    ft4?: {
+        preset: "maximum" | "custom" | "balanced" | "lightweight";
+        customWindowTiming?: number[] | undefined;
+    } | undefined;
+}, {
+    ft8?: {
+        preset?: "minimum" | "maximum" | "custom" | "balanced" | "lightweight" | undefined;
+        customWindowTiming?: number[] | undefined;
+    } | undefined;
+    ft4?: {
+        preset?: "maximum" | "custom" | "balanced" | "lightweight" | undefined;
+        customWindowTiming?: number[] | undefined;
+    } | undefined;
+}>;
+export type DecodeWindowSettings = z.infer<typeof DecodeWindowSettingsSchema>;
+export declare const DEFAULT_DECODE_WINDOW_SETTINGS: DecodeWindowSettings;
+/**
+ * 根据模式名和设置解析实际的 windowTiming
+ * 返回 null 表示使用 MODES 中的默认值
+ */
+export declare function resolveWindowTiming(modeName: string, settings?: DecodeWindowSettings): number[] | null;
+//# sourceMappingURL=mode.schema.d.ts.map

package/dist/schema/mode.schema.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"mode.schema.d.ts","sourceRoot":"","sources":["../../src/schema/mode.schema.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAExB;;GAEG;AACH,eAAO,MAAM,oBAAoB;IAC/B,0BAA0B;;IAE1B,4CAA4C;;IAE5C,eAAe;;IAEf;;;;;;OAMG;;IAEH;;;;;OAKG;;IAEH;;;OAGG;;;;;;;;;;;;;;;;EAEH,CAAC;AAEH,MAAM,MAAM,cAAc,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,oBAAoB,CAAC,CAAC;AAElE;;GAEG;AACH,eAAO,MAAM,KAAK;kBAQX,cAAc;kBASd,cAAc;oBAQd,cAAc;CACX,CAAC;AAEX;;GAEG;AACH,eAAO,MAAM,kBAAkB;;;;;;CAMrB,CAAC;AAEX;;;;;GAKG;AACH,eAAO,MAAM,kBAAkB,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,EAAE,CAKvD,CAAC;AAEF;;;;;GAKG;AACH,eAAO,MAAM,kBAAkB,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,EAAE,CAIvD,CAAC;AAEF;;GAEG;AACH,eAAO,MAAM,0BAA0B;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;EASrC,CAAC;AAEH,MAAM,MAAM,oBAAoB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,0BAA0B,CAAC,CAAC;AAE9E,eAAO,MAAM,8BAA8B,EAAE,oBAO5C,CAAC;AAEF;;;GAGG;AACH,wBAAgB,mBAAmB,CACjC,QAAQ,EAAE,MAAM,EAChB,QAAQ,CAAC,EAAE,oBAAoB,GAC9B,MAAM,EAAE,GAAG,IAAI,CAsBjB"}

package/dist/schema/mode.schema.js

@@ -0,0 +1,141 @@
+import { z } from 'zod';
+/**
+ * 模式描述符 - 定义 FT8/FT4 等模式的时序参数
+ */
+export const ModeDescriptorSchema = z.object({
+    /** 模式名称，如 "FT8", "FT4" */
+    name: z.string(),
+    /** 时隙长度（毫秒），FT8=15000, FT4=7500, VOICE=0 */
+    slotMs: z.number().nonnegative(),
+    /** 时钟容差（毫秒） */
+    toleranceMs: z.number().nonnegative().default(100),
+    /**
+     * 窗口时机（毫秒）- 必需
+     * 使用这些时机作为从时隙结束时间的偏移量
+     * 每个窗口都会获取固定长度的解码数据（FT8: 15秒，FT4: 7.5秒）
+     * 数组长度决定了子窗口的数量
+     * 支持负偏移，可以获取时隙结束前或其他周期的音频数据
+     */
+    windowTiming: z.array(z.number()),
+    /**
+     * 发射时机（毫秒）- 从时隙开始的延迟
+     * 对齐 WSJT-X 标准：信号在时隙边界后 ~0.5s 开始
+     * FT8: 500ms（信号 T+0.5s 起，12.64s 长，T+13.14s 结束）
+     * FT4: 500ms（信号 T+0.5s 起，6.0s 长，T+6.5s 结束，留 1.0s 给末端解码）
+     */
+    transmitTiming: z.number().nonnegative(),
+    /**
+     * 编码提前量（毫秒）- 在transmitTiming之前多久开始编码
+     * 默认400ms,用于补偿编码+混音时间
+     */
+    encodeAdvance: z.number().nonnegative().default(400)
+});
+/**
+ * 预定义的模式
+ */
+export const MODES = {
+    FT8: {
+        name: 'FT8',
+        slotMs: 15000,
+        toleranceMs: 100,
+        windowTiming: [-3200, -1500, -300], // WSJT-X 标准：11.8s / 13.5s / 14.7s 三轮解码
+        transmitTiming: 500, // WSJT-X 标准：信号在时隙边界后 ~0.5s 开始
+        encodeAdvance: 0 // 编码在 transmitStart 时触发，留出 500ms 给策略决策
+    },
+    FT4: {
+        name: 'FT4',
+        slotMs: 7500,
+        toleranceMs: 50,
+        // 双 pass 解码：T+6000ms 早 pass（让下一周期 encodeStart 之前能拿到对端消息）+ T+7500ms 末 pass
+        windowTiming: [-1500, 0],
+        transmitTiming: 500, // WSJT-X 标准：FT4 信号 T+0.5s 起，6.0s 长
+        encodeAdvance: 300 // encodeStart 在 T+200ms 触发，留 ~300ms 给编码完成，使 transmitStart 时音频已就绪
+    },
+    VOICE: {
+        name: 'VOICE',
+        slotMs: 0, // 语音模式无时隙概念
+        toleranceMs: 0,
+        windowTiming: [], // 无解码窗口
+        transmitTiming: 0,
+        encodeAdvance: 0,
+    },
+};
+/**
+ * 解码窗口预设
+ */
+export const DecodeWindowPreset = {
+    MAXIMUM: 'maximum',
+    BALANCED: 'balanced',
+    LIGHTWEIGHT: 'lightweight',
+    MINIMUM: 'minimum',
+    CUSTOM: 'custom',
+};
+/**
+ * FT8 解码窗口预设映射
+ * 偏移量基于时隙结束时间（T+15000ms），即 offset = 实际触发时间 - 15000
+ * FT8 信号：T+500ms 开始，T+13140ms 结束（12.64s）
+ * WSJT-X 标准三轮：T+11.8s(-3200) / T+13.5s(-1500) / T+14.7s(-300)
+ */
+export const FT8_WINDOW_PRESETS = {
+    maximum: [-3200, -1500, -800, -300, -150], // 5 轮
+    balanced: [-3200, -1500, -300], // 3 轮：WSJT-X 标准时序
+    lightweight: [-3200, -300], // 2 轮：首尾两轮
+    minimum: [-300], // 1 轮：信号结束后最终解码
+};
+/**
+ * FT4 解码窗口预设映射
+ * 偏移量基于时隙结束时间（T+7500ms）
+ * FT4 信号：T+500ms 开始，T+6500ms 结束（6.0s）
+ * 双 pass 设计对齐 WSJT-X/JTDX：早 pass 让下一周期 encodeStart 前能用上结果
+ */
+export const FT4_WINDOW_PRESETS = {
+    maximum: [-2000, -1000, 0], // 3 轮：T+5.5s / T+6.5s / T+7.5s
+    balanced: [-1500, 0], // 2 轮：T+6.0s（早 pass）+ T+7.5s（末 pass）
+    lightweight: [0], // 1 轮：仅末端
+};
+/**
+ * 解码窗口设置 Schema
+ */
+export const DecodeWindowSettingsSchema = z.object({
+    ft8: z.object({
+        preset: z.enum(['maximum', 'balanced', 'lightweight', 'minimum', 'custom']).default('balanced'),
+        customWindowTiming: z.array(z.number().int().min(-5000).max(1000)).optional(),
+    }).optional(),
+    ft4: z.object({
+        preset: z.enum(['maximum', 'balanced', 'lightweight', 'custom']).default('balanced'),
+        customWindowTiming: z.array(z.number().int().min(-5000).max(1000)).optional(),
+    }).optional(),
+});
+export const DEFAULT_DECODE_WINDOW_SETTINGS = {
+    ft8: {
+        preset: 'balanced',
+    },
+    ft4: {
+        preset: 'balanced',
+    },
+};
+/**
+ * 根据模式名和设置解析实际的 windowTiming
+ * 返回 null 表示使用 MODES 中的默认值
+ */
+export function resolveWindowTiming(modeName, settings) {
+    if (!settings)
+        return null;
+    const modeKey = modeName.toUpperCase();
+    if (modeKey === 'FT8' && settings.ft8) {
+        const { preset, customWindowTiming } = settings.ft8;
+        if (preset === 'custom' && customWindowTiming && customWindowTiming.length > 0) {
+            return [...customWindowTiming].sort((a, b) => a - b);
+        }
+        return FT8_WINDOW_PRESETS[preset] ?? null;
+    }
+    if (modeKey === 'FT4' && settings.ft4) {
+        const { preset, customWindowTiming } = settings.ft4;
+        if (preset === 'custom' && customWindowTiming && customWindowTiming.length > 0) {
+            return [...customWindowTiming].sort((a, b) => a - b);
+        }
+        return FT4_WINDOW_PRESETS[preset] ?? null;
+    }
+    return null;
+}
+//# sourceMappingURL=mode.schema.js.map

package/dist/schema/mode.schema.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"mode.schema.js","sourceRoot":"","sources":["../../src/schema/mode.schema.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAExB;;GAEG;AACH,MAAM,CAAC,MAAM,oBAAoB,GAAG,CAAC,CAAC,MAAM,CAAC;IAC3C,0BAA0B;IAC1B,IAAI,EAAE,CAAC,CAAC,MAAM,EAAE;IAChB,4CAA4C;IAC5C,MAAM,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,WAAW,EAAE;IAChC,eAAe;IACf,WAAW,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,WAAW,EAAE,CAAC,OAAO,CAAC,GAAG,CAAC;IAClD;;;;;;OAMG;IACH,YAAY,EAAE,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,MAAM,EAAE,CAAC;IACjC;;;;;OAKG;IACH,cAAc,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,WAAW,EAAE;IACxC;;;OAGG;IACH,aAAa,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,WAAW,EAAE,CAAC,OAAO,CAAC,GAAG,CAAC;CACrD,CAAC,CAAC;AAIH;;GAEG;AACH,MAAM,CAAC,MAAM,KAAK,GAAG;IACnB,GAAG,EAAE;QACH,IAAI,EAAE,KAAK;QACX,MAAM,EAAE,KAAK;QACb,WAAW,EAAE,GAAG;QAChB,YAAY,EAAE,CAAC,CAAC,IAAI,EAAE,CAAC,IAAI,EAAE,CAAC,GAAG,CAAC,EAAE,uCAAuC;QAC3E,cAAc,EAAE,GAAG,EAAG,8BAA8B;QACpD,aAAa,EAAE,CAAC,CAAM,uCAAuC;KAC5C;IACnB,GAAG,EAAE;QACH,IAAI,EAAE,KAAK;QACX,MAAM,EAAE,IAAI;QACZ,WAAW,EAAE,EAAE;QACf,0EAA0E;QAC1E,YAAY,EAAE,CAAC,CAAC,IAAI,EAAE,CAAC,CAAC;QACxB,cAAc,EAAE,GAAG,EAAE,mCAAmC;QACxD,aAAa,EAAE,GAAG,CAAG,iEAAiE;KACrE;IACnB,KAAK,EAAE;QACL,IAAI,EAAE,OAAO;QACb,MAAM,EAAE,CAAC,EAAa,YAAY;QAClC,WAAW,EAAE,CAAC;QACd,YAAY,EAAE,EAAE,EAAM,QAAQ;QAC9B,cAAc,EAAE,CAAC;QACjB,aAAa,EAAE,CAAC;KACC;CACX,CAAC;AAEX;;GAEG;AACH,MAAM,CAAC,MAAM,kBAAkB,GAAG;IAChC,OAAO,EAAE,SAAS;IAClB,QAAQ,EAAE,UAAU;IACpB,WAAW,EAAE,aAAa;IAC1B,OAAO,EAAE,SAAS;IAClB,MAAM,EAAE,QAAQ;CACR,CAAC;AAEX;;;;;GAKG;AACH,MAAM,CAAC,MAAM,kBAAkB,GAA6B;IAC1D,OAAO,EAAE,CAAC,CAAC,IAAI,EAAE,CAAC,IAAI,EAAE,CAAC,GAAG,EAAE,CAAC,GAAG,EAAE,CAAC,GAAG,CAAC,EAAG,MAAM;IAClD,QAAQ,EAAE,CAAC,CAAC,IAAI,EAAE,CAAC,IAAI,EAAE,CAAC,GAAG,CAAC,EAAgB,kBAAkB;IAChE,WAAW,EAAE,CAAC,CAAC,IAAI,EAAE,CAAC,GAAG,CAAC,EAAqB,WAAW;IAC1D,OAAO,EAAE,CAAC,CAAC,GAAG,CAAC,EAAgC,gBAAgB;CAChE,CAAC;AAEF;;;;;GAKG;AACH,MAAM,CAAC,MAAM,kBAAkB,GAA6B;IAC1D,OAAO,EAAE,CAAC,CAAC,IAAI,EAAE,CAAC,IAAI,EAAE,CAAC,CAAC,EAAI,+BAA+B;IAC7D,QAAQ,EAAE,CAAC,CAAC,IAAI,EAAE,CAAC,CAAC,EAAW,qCAAqC;IACpE,WAAW,EAAE,CAAC,CAAC,CAAC,EAAe,UAAU;CAC1C,CAAC;AAEF;;GAEG;AACH,MAAM,CAAC,MAAM,0BAA0B,GAAG,CAAC,CAAC,MAAM,CAAC;IACjD,GAAG,EAAE,CAAC,CAAC,MAAM,CAAC;QACZ,MAAM,EAAE,CAAC,CAAC,IAAI,CAAC,CAAC,SAAS,EAAE,UAAU,EAAE,aAAa,EAAE,SAAS,EAAE,QAAQ,CAAC,CAAC,CAAC,OAAO,CAAC,UAAU,CAAC;QAC/F,kBAAkB,EAAE,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,EAAE,CAAC,GAAG,CAAC,CAAC,IAAI,CAAC,CAAC,GAAG,CAAC,IAAI,CAAC,CAAC,CAAC,QAAQ,EAAE;KAC9E,CAAC,CAAC,QAAQ,EAAE;IACb,GAAG,EAAE,CAAC,CAAC,MAAM,CAAC;QACZ,MAAM,EAAE,CAAC,CAAC,IAAI,CAAC,CAAC,SAAS,EAAE,UAAU,EAAE,aAAa,EAAE,QAAQ,CAAC,CAAC,CAAC,OAAO,CAAC,UAAU,CAAC;QACpF,kBAAkB,EAAE,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,EAAE,CAAC,GAAG,CAAC,CAAC,IAAI,CAAC,CAAC,GAAG,CAAC,IAAI,CAAC,CAAC,CAAC,QAAQ,EAAE;KAC9E,CAAC,CAAC,QAAQ,EAAE;CACd,CAAC,CAAC;AAIH,MAAM,CAAC,MAAM,8BAA8B,GAAyB;IAClE,GAAG,EAAE;QACH,MAAM,EAAE,UAAU;KACnB;IACD,GAAG,EAAE;QACH,MAAM,EAAE,UAAU;KACnB;CACF,CAAC;AAEF;;;GAGG;AACH,MAAM,UAAU,mBAAmB,CACjC,QAAgB,EAChB,QAA+B;IAE/B,IAAI,CAAC,QAAQ;QAAE,OAAO,IAAI,CAAC;IAE3B,MAAM,OAAO,GAAG,QAAQ,CAAC,WAAW,EAAE,CAAC;IAEvC,IAAI,OAAO,KAAK,KAAK,IAAI,QAAQ,CAAC,GAAG,EAAE,CAAC;QACtC,MAAM,EAAE,MAAM,EAAE,kBAAkB,EAAE,GAAG,QAAQ,CAAC,GAAG,CAAC;QACpD,IAAI,MAAM,KAAK,QAAQ,IAAI,kBAAkB,IAAI,kBAAkB,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;YAC/E,OAAO,CAAC,GAAG,kBAAkB,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC,EAAE,EAAE,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC;QACvD,CAAC;QACD,OAAO,kBAAkB,CAAC,MAAM,CAAC,IAAI,IAAI,CAAC;IAC5C,CAAC;IAED,IAAI,OAAO,KAAK,KAAK,IAAI,QAAQ,CAAC,GAAG,EAAE,CAAC;QACtC,MAAM,EAAE,MAAM,EAAE,kBAAkB,EAAE,GAAG,QAAQ,CAAC,GAAG,CAAC;QACpD,IAAI,MAAM,KAAK,QAAQ,IAAI,kBAAkB,IAAI,kBAAkB,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;YAC/E,OAAO,CAAC,GAAG,kBAAkB,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC,EAAE,EAAE,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC;QACvD,CAAC;QACD,OAAO,kBAAkB,CAAC,MAAM,CAAC,IAAI,IAAI,CAAC;IAC5C,CAAC;IAED,OAAO,IAAI,CAAC;AACd,CAAC"}