@tx5dr/contracts 1.2.0

package/src/utils/grid.ts

@@ -0,0 +1,94 @@
+const GRID_WHITESPACE_REGEX = /\s+/g;
+const FOUR_CHARACTER_GRID_REGEX = /^[A-R]{2}[0-9]{2}$/;
+const TWO_CHARACTER_GRID_REGEX = /^[A-R]{2}$/;
+
+export function sanitizeGridInput(grid?: string | null): string {
+  if (!grid) {
+    return '';
+  }
+
+  return grid.toUpperCase().replace(GRID_WHITESPACE_REGEX, '');
+}
+
+export function getFourCharacterGrid(grid?: string | null): string | undefined {
+  const normalized = sanitizeGridInput(grid);
+  if (normalized.length < 4) {
+    return undefined;
+  }
+
+  const fourCharacterGrid = normalized.slice(0, 4);
+  return FOUR_CHARACTER_GRID_REGEX.test(fourCharacterGrid) ? fourCharacterGrid : undefined;
+}
+
+export function getTwoCharacterGrid(grid?: string | null): string | undefined {
+  const normalized = sanitizeGridInput(grid);
+  if (normalized.length < 2) {
+    return undefined;
+  }
+
+  const twoCharacterGrid = normalized.slice(0, 2);
+  return TWO_CHARACTER_GRID_REGEX.test(twoCharacterGrid) ? twoCharacterGrid : undefined;
+}
+
+export interface GridBounds {
+  lonMin: number;
+  lonMax: number;
+  latMin: number;
+  latMax: number;
+  centerLon: number;
+  centerLat: number;
+}
+
+export function getGridBounds(grid?: string | null): GridBounds | null {
+  const normalized = sanitizeGridInput(grid);
+  if (normalized.length < 2) {
+    return null;
+  }
+
+  const lonField = normalized.charCodeAt(0) - 65;
+  const latField = normalized.charCodeAt(1) - 65;
+
+  if (lonField < 0 || lonField > 17 || latField < 0 || latField > 17) {
+    return null;
+  }
+
+  let lonMin = lonField * 20 - 180;
+  let lonMax = lonMin + 20;
+  let latMin = latField * 10 - 90;
+  let latMax = latMin + 10;
+
+  if (normalized.length >= 4) {
+    const lonSquare = Number.parseInt(normalized[2], 10);
+    const latSquare = Number.parseInt(normalized[3], 10);
+    if (!Number.isFinite(lonSquare) || !Number.isFinite(latSquare)) {
+      return null;
+    }
+
+    lonMin += lonSquare * 2;
+    lonMax = lonMin + 2;
+    latMin += latSquare;
+    latMax = latMin + 1;
+  }
+
+  if (normalized.length >= 6) {
+    const lonSub = normalized.charCodeAt(4) - 65;
+    const latSub = normalized.charCodeAt(5) - 65;
+    if (lonSub < 0 || lonSub > 23 || latSub < 0 || latSub > 23) {
+      return null;
+    }
+
+    lonMin += lonSub * (2 / 24);
+    lonMax = lonMin + (2 / 24);
+    latMin += latSub * (1 / 24);
+    latMax = latMin + (1 / 24);
+  }
+
+  return {
+    lonMin,
+    lonMax,
+    latMin,
+    latMax,
+    centerLon: (lonMin + lonMax) / 2,
+    centerLat: (latMin + latMax) / 2,
+  };
+}

package/test/mode-schema.test.ts

@@ -0,0 +1,48 @@
+import { describe, expect, it } from 'vitest';
+import { MODES, FT4_WINDOW_PRESETS, FT8_WINDOW_PRESETS } from '../src/schema/mode.schema';
+
+describe('MODES.FT4 timing constants', () => {
+  it('aligns FT4 transmitTiming with WSJT-X standard (T+0.5s signal start)', () => {
+    expect(MODES.FT4.transmitTiming).toBe(500);
+  });
+
+  it('keeps FT4 encodeAdvance large enough to finish encode before transmit', () => {
+    // FT4 slot is 7.5s; encoder takes 100-200ms. encodeStart must fire BEFORE
+    // transmitStart with enough slack for AudioMixer to schedule playback.
+    expect(MODES.FT4.encodeAdvance).toBeGreaterThanOrEqual(200);
+    expect(MODES.FT4.encodeAdvance).toBeLessThan(MODES.FT4.transmitTiming);
+  });
+
+  it('keeps FT4 windowTiming dual-pass with an early decode', () => {
+    expect(MODES.FT4.windowTiming).toEqual([-1500, 0]);
+  });
+
+  it('keeps FT4 slot length at the WSJT-X standard 7.5s', () => {
+    expect(MODES.FT4.slotMs).toBe(7500);
+  });
+});
+
+describe('MODES.FT8 timing constants (regression guard)', () => {
+  it('keeps FT8 untouched at WSJT-X standard 500ms / encodeAdvance 0', () => {
+    expect(MODES.FT8.transmitTiming).toBe(500);
+    expect(MODES.FT8.encodeAdvance).toBe(0);
+    expect(MODES.FT8.slotMs).toBe(15000);
+  });
+
+  it('keeps FT8 balanced window preset at WSJT-X 3-pass schedule', () => {
+    expect(FT8_WINDOW_PRESETS.balanced).toEqual([-3200, -1500, -300]);
+  });
+});
+
+describe('FT4_WINDOW_PRESETS', () => {
+  it('exposes maximum / balanced / lightweight in monotonically increasing order', () => {
+    for (const [preset, timings] of Object.entries(FT4_WINDOW_PRESETS)) {
+      const sorted = [...timings].sort((a, b) => a - b);
+      expect(timings, `${preset} should be already sorted ascending`).toEqual(sorted);
+    }
+  });
+
+  it('balanced preset keeps an early pass so next-cycle encodeStart sees fresh decodes', () => {
+    expect(FT4_WINDOW_PRESETS.balanced.some((o) => o < 0)).toBe(true);
+  });
+});

package/tsconfig.json

@@ -0,0 +1,9 @@
+{
+  "extends": "../shared-config/tsconfig.json",
+  "compilerOptions": {
+    "outDir": "dist",
+    "rootDir": "src",
+    "noEmit": false
+  },
+  "include": ["src/**/*"]
+}