signalk-race-control 0.12.7 → 0.12.9

package/CHANGELOG.md

@@ -0,0 +1,120 @@
+# Changelog
+
+All notable changes to `signalk-race-control`, newest first.
+
+## 0.12.9 (2026-10-13)
+- Patch `brace-expansion` (via `exceljs`) to fix the npm audit finding
+- Fix the MFD tile showing "No active race" over a live race (its stylesheet ignored the `hidden` attribute)
+- Add this changelog and App Store screenshots
+
+## 0.12.8 (2026-10-12)
+- Split the Excel export by class
+
+## 0.12.7 (2026-10-11)
+- Allow editing class start times before the race starts
+
+## 0.12.6 (2026-09-20)
+- Add read-only MFD tile webapp for signalk-mfd-plugin
+
+## 0.12.5 (2026-09-20)
+- Add optional buddy-list registration when adding a boat
+
+## 0.12.4 (2026-09-20)
+- Fix webapp icon resolution via signalk.appIcon
+
+## 0.12.3 (2026-09-20)
+- Add a favicon: a racing mark with a clock hand
+
+## 0.12.2 (2026-09-19)
+- Repopulate the schedule input/button from the actual saved schedule
+
+## 0.12.1 (2026-09-18)
+- Fix App Store audit warnings: repository field, uuid override
+- Add a plugin-level test suite
+
+## 0.12.0 (2026-09-16)
+- Auto-activate the course as a SignalK route on start-line crossing
+- Add 10-minute laylines for self on the course chart
+- Add a lift/header wind-shift instrument for self
+
+## 0.11.1 (2026-09-16)
+- Fix OpenSeaMap autosuggest/snap never finding real data
+
+## 0.11.0 (2026-09-16)
+- Let the chart fill the page width, without trapping page scroll
+- Add a recenter button to the chart
+- Reuse a chosen OpenSeaMap mark instantly in other course-point rows
+- Scope the recenter button to just the race's own course
+- Fall back to self position when recentering with no course set
+- Schedule Start/Call-off only need a date on multi-day races
+- Revert Schedule Start to always need a date
+- Add classes for staggered/pursuit starts
+- Fix buoy name suggestion losing to a generic reverse-geocode guess
+- Fix map-pick feedback stalling on a slow Overpass lookup
+- Cache OpenSeaMap nav marks per chart area
+- Reorder course sections and turn course points into tables
+- Collapse course positions once a course is saved
+
+## 0.10.1 (2026-09-15)
+- Fix scheduled start/call-off firing immediately when set far enough ahead
+
+## 0.10.0 (2026-09-15)
+- Fix multiple registered charts stacking instead of switching
+- Show a boat's inherited start time instead of blank
+- Autosuggest course point names from the chart area, not just waypoints
+- Source the course-point name autosuggest from OpenSeaMap, not general OSM
+- Try multiple Overpass mirrors, and ask to snap a map click to a nearby mark
+- Default the chart to Eniro's plain map, not whichever loaded first
+
+## 0.9.0 (2026-09-13)
+- Add click-to-place course points on the map, fix unreadable mark dropdown
+- Merge course-point buttons into one, suggest names from OpenStreetMap
+
+## 0.8.0 (2026-09-13)
+- Fix Add Boat not responding to Enter in the offline export
+- Mark speed pickups on the course chart
+- Draw speed-pickup rings in each boat's own trace color
+- Add a real background chart to the course/replay map
+
+## 0.7.0 (2026-09-08)
+- Auto-stop a complete race, and add a DNS status
+- Make Excel export use live formulas, reorder time columns
+- Sort DNS boats to the end and allow marking DNS before race start
+- Sort DNS boats last in the offline export template too
+
+## 0.6.0 (2026-09-07)
+- Add KTK's KLR handicap register alongside VET-tall
+
+## 0.5.1 (2026-09-04)
+- Stop the boats table from resizing/reshuffling confusingly
+
+## 0.5.0 (2026-09-03)
+- Add a start timer view with distance/ETA/burn time to the line
+
+## 0.4.3 (2026-09-03)
+- Let course points autocomplete against existing SignalK waypoints
+- Make mark-rounding radius configurable and add manual mark rounding
+- Record positions for manual mark roundings and improve chart replay
+- Add author to package.json
+
+## 0.4.2 (2026-09-02)
+- Remember sail number across races, like MMSI
+
+## 0.4.1 (2026-08-30)
+- Make the offline export installable as a standalone iOS app
+
+## 0.4.0 (2026-08-30)
+- Fetch VET-tall handicaps live in the offline export
+
+## 0.3.0 (2026-08-20)
+- Add Manage2Sail fleet import with handicap-system conversion
+
+## 0.2.0 (2026-08-20)
+- Add signalk-race-control plugin: race timing, handicaps, course/chart, VET import
+- Add MIT LICENSE file and drop empty repository field
+- Add offline export: standalone backup race timer
+- Add multi-day races and individual per-boat start times
+- Fix ghost row left in the boat table after removing a boat
+- Fall back to the leader when no boat is marked self
+- Clarify the multi-day toggle isn't needed for ordinary overnight races
+- Fix scheduled call-off loss, stale offline exports, and add race-start correction

package/README.md

@@ -229,7 +229,9 @@ and a live projected finishing order — during and after the race.
   finishing instantly), or the current corrected-time gap if both are still racing or
   both have finished. With no boat marked self, the column instead compares everyone
   against the current **leader** (tagged accordingly), so it's never just blank.
-- **Export to Excel** — a genuine `.xlsx` snapshot of the current standings (same
+- **Export to Excel** — a genuine `.xlsx` snapshot of the current standings, with one
+  worksheet per class (each ranked on its own; boats with no class go on a "No class"
+  sheet, and a race with no classes gets a single "Results" sheet) (same
   ranking, same rows as the on-screen table: rank, boat, sail number, MMSI, TCF, start
   time, finish time, elapsed, corrected, status), with the time columns rendered in
   your browser's own timezone rather than the server's (and with the date included,

package/index.js

@@ -2400,28 +2400,12 @@ module.exports = function (app) {
       const workbook = new ExcelJS.Workbook();
       workbook.creator = 'Race Control';
       workbook.created = new Date();
-      const sheet = workbook.addWorksheet('Results');
-
-      const titleRow = sheet.addRow([race.name]);
-      sheet.mergeCells(titleRow.number, 1, titleRow.number, headers.length);
-      titleRow.getCell(1).font = { bold: true, size: 14 };
 
       const statusLine = race.stopTime
         ? `Called off ${formatLocalDateTime(race.stopTime, tz)}`
         : race.startTime
           ? `Started ${formatLocalDateTime(race.startTime, tz)}`
           : 'Not started';
-      const infoRow = sheet.addRow([statusLine]);
-      sheet.mergeCells(infoRow.number, 1, infoRow.number, headers.length);
-      infoRow.getCell(1).font = { italic: true, color: { argb: 'FF64748B' } };
-
-      sheet.addRow([]);
-
-      const headerRow = sheet.addRow(headers);
-      headerRow.font = { bold: true };
-      headerRow.eachCell((cell) => {
-        cell.fill = { type: 'pattern', pattern: 'solid', fgColor: { argb: 'FFE2E8F0' } };
-      });
 
       // Real Excel date/time values in Start/Finish (shifted the same way
       // formatLocalDateTime above does, to display as the exporting
@@ -2435,43 +2419,92 @@ module.exports = function (app) {
       // that would just sit there, wrong, once the file is reopened later.
       const dateNumFmt = race.multiDay ? 'yyyy-mm-dd hh:mm:ss' : 'hh:mm:ss';
       const durationNumFmt = '[h]:mm:ss';
-      ranked.forEach((r, i) => {
-        const status = r.boat.dns
-          ? 'DNS'
-          : r.boat.dnf
-            ? 'DNF'
-            : r.boat.finishTime
-              ? 'Finished'
-              : race.startTime
-                ? 'Racing'
-                : 'Not started';
-        const rankLabel = r.boat.dns ? 'DNS' : r.boat.dnf ? 'DNF' : r.rankMs != null ? i + 1 : '';
-        const start = effectiveStartTime(race, r.boat);
-        const startDate = start != null ? new Date(start - tz * 60000) : null;
-        const finishDate = r.boat.finishTime != null ? new Date(r.boat.finishTime - tz * 60000) : null;
-        const rowNum = headerRow.number + 1 + i;
-        const row = sheet.addRow([
-          rankLabel,
-          r.boat.name,
-          r.boat.sailNumber || '',
-          r.boat.mmsi || '',
-          r.boat.tcf,
-          startDate,
-          finishDate,
-          { formula: `IF(OR(F${rowNum}="",G${rowNum}=""),"",G${rowNum}-F${rowNum})` },
-          { formula: `IF(H${rowNum}="","",H${rowNum}*E${rowNum})` },
-          status
-        ]);
-        row.getCell(6).numFmt = dateNumFmt;
-        row.getCell(7).numFmt = dateNumFmt;
-        row.getCell(8).numFmt = durationNumFmt;
-        row.getCell(9).numFmt = durationNumFmt;
-      });
 
-      const widths = [7, 24, 12, 12, 8, race.multiDay ? 17 : 12, race.multiDay ? 17 : 12, 12, 12, 12];
-      widths.forEach((w, i) => {
-        sheet.getColumn(i + 1).width = w;
-      });
+      // One worksheet per class, each ranked on its own (the global order
+      // from rankedBoatList is preserved within a class, so DNF/DNS/unranked
+      // boats still trail). A race with no classes keeps the single
+      // "Results" sheet.
+      const usedSheetNames = new Set();
+      const uniqueSheetName = (raw) => {
+        // Excel sheet names: max 31 chars, none of : \ / ? * [ ], unique.
+        const base = (String(raw).replace(/[:\\/?*\[\]]/g, ' ').replace(/\s+/g, ' ').trim() || 'Class').slice(0, 31);
+        let name = base;
+        for (let n = 2; usedSheetNames.has(name.toLowerCase()); n++) {
+          const suffix = ` (${n})`;
+          name = base.slice(0, 31 - suffix.length) + suffix;
+        }
+        usedSheetNames.add(name.toLowerCase());
+        return name;
+      };
+
+      const addResultsSheet = (sheetName, title, entries) => {
+        const sheet = workbook.addWorksheet(uniqueSheetName(sheetName));
+
+        const titleRow = sheet.addRow([title]);
+        sheet.mergeCells(titleRow.number, 1, titleRow.number, headers.length);
+        titleRow.getCell(1).font = { bold: true, size: 14 };
+
+        const infoRow = sheet.addRow([statusLine]);
+        sheet.mergeCells(infoRow.number, 1, infoRow.number, headers.length);
+        infoRow.getCell(1).font = { italic: true, color: { argb: 'FF64748B' } };
+
+        sheet.addRow([]);
+
+        const headerRow = sheet.addRow(headers);
+        headerRow.font = { bold: true };
+        headerRow.eachCell((cell) => {
+          cell.fill = { type: 'pattern', pattern: 'solid', fgColor: { argb: 'FFE2E8F0' } };
+        });
+
+        entries.forEach((r, i) => {
+          const status = r.boat.dns
+            ? 'DNS'
+            : r.boat.dnf
+              ? 'DNF'
+              : r.boat.finishTime
+                ? 'Finished'
+                : race.startTime
+                  ? 'Racing'
+                  : 'Not started';
+          const rankLabel = r.boat.dns ? 'DNS' : r.boat.dnf ? 'DNF' : r.rankMs != null ? i + 1 : '';
+          const start = effectiveStartTime(race, r.boat);
+          const startDate = start != null ? new Date(start - tz * 60000) : null;
+          const finishDate = r.boat.finishTime != null ? new Date(r.boat.finishTime - tz * 60000) : null;
+          const rowNum = headerRow.number + 1 + i;
+          const row = sheet.addRow([
+            rankLabel,
+            r.boat.name,
+            r.boat.sailNumber || '',
+            r.boat.mmsi || '',
+            r.boat.tcf,
+            startDate,
+            finishDate,
+            { formula: `IF(OR(F${rowNum}="",G${rowNum}=""),"",G${rowNum}-F${rowNum})` },
+            { formula: `IF(H${rowNum}="","",H${rowNum}*E${rowNum})` },
+            status
+          ]);
+          row.getCell(6).numFmt = dateNumFmt;
+          row.getCell(7).numFmt = dateNumFmt;
+          row.getCell(8).numFmt = durationNumFmt;
+          row.getCell(9).numFmt = durationNumFmt;
+        });
+
+        const widths = [7, 24, 12, 12, 8, race.multiDay ? 17 : 12, race.multiDay ? 17 : 12, 12, 12, 12];
+        widths.forEach((w, i) => {
+          sheet.getColumn(i + 1).width = w;
+        });
+      };
+
+      const classes = race.classes || [];
+      if (!classes.length) {
+        addResultsSheet('Results', race.name, ranked);
+      } else {
+        classes.forEach((cls) => {
+          addResultsSheet(cls.name, `${race.name} — ${cls.name}`, ranked.filter((r) => r.boat.classId === cls.id));
+        });
+        const unclassed = ranked.filter((r) => !r.boat.classId);
+        if (unclassed.length) addResultsSheet('No class', `${race.name} — No class`, unclassed);
+      }
 
       const safeName = (race.name || 'race').replace(/[^a-z0-9\-_]+/gi, '_').slice(0, 60) || 'race';
       res.setHeader('Content-Type', 'application/vnd.openxmlformats-officedocument.spreadsheetml.sheet');

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "signalk-race-control",
-  "version": "0.12.7",
+  "version": "0.12.9",
   "description": "SignalK plugin and webapp for tracking elapsed and handicap-corrected (Time-on-Time) race time, with a per-boat editable TCF and boat names pulled from AIS when available.",
   "main": "index.js",
   "author": "Joachim Bakke <github@heiamoss.com>",
@@ -9,7 +9,15 @@
     "url": "https://github.com/joabakk/signalk-race-control.git"
   },
   "signalk": {
-    "appIcon": "favicon.svg"
+    "appIcon": "favicon.svg",
+    "displayName": "Race Control",
+    "screenshots": [
+      "screenshots/results.png",
+      "screenshots/course-chart.png",
+      "screenshots/start-timer.png",
+      "screenshots/mfd-leaderboard.png",
+      "screenshots/mfd-countdown.png"
+    ]
   },
   "keywords": [
     "signalk-node-server-plugin",
@@ -27,6 +35,12 @@
     "exceljs": "^4.4.0"
   },
   "overrides": {
-    "uuid": "^11.1.1"
+    "uuid": "^11.1.1",
+    "glob": {
+      "brace-expansion": "^1.1.21"
+    },
+    "readdir-glob": {
+      "brace-expansion": "^2.1.7"
+    }
   }
 }

package/public/mfd-tile.html

@@ -17,6 +17,9 @@
     --bad: #f87171;
   }
   * { box-sizing: border-box; }
+  /* Elements that set their own `display` would otherwise override the
+     `hidden` attribute's UA-stylesheet `display: none`. */
+  [hidden] { display: none !important; }
   html, body {
     margin: 0;
     height: 100%;

package/test/plugin.test.js

@@ -326,3 +326,83 @@ describe('/overpass proxy — falls back across mirrors', () => {
     assert.deepEqual(res.body.elements, []);
   });
 });
+
+describe('GET /races/:id/export.xlsx — split by class', () => {
+  const ExcelJS = require('exceljs');
+  const { Writable } = require('node:stream');
+  let plugin;
+  let router;
+
+  before(() => {
+    const dataDir = fs.mkdtempSync(path.join(os.tmpdir(), 'race-control-test-'));
+    plugin = pluginFactory(makeApp(dataDir));
+    plugin.start({});
+    router = makeRouter();
+    plugin.registerWithRouter(router);
+  });
+
+  after(() => {
+    plugin.stop();
+  });
+
+  // The export streams a workbook into `res`; collect it and re-read it.
+  async function exportWorkbook(raceId) {
+    const route = router._routes.find((r) => r.method === 'GET' && r.pattern.test(`/races/${raceId}/export.xlsx`));
+    const chunks = [];
+    const res = new Writable({
+      write(chunk, _enc, cb) {
+        chunks.push(Buffer.from(chunk));
+        cb();
+      }
+    });
+    res.setHeader = () => {};
+    res.status = () => res;
+    res.json = () => {};
+    const done = new Promise((resolve) => res.on('finish', resolve));
+    await route.handler({ params: { id: raceId }, query: { tzOffsetMinutes: '0' }, body: {} }, res);
+    await done;
+    const wb = new ExcelJS.Workbook();
+    await wb.xlsx.load(Buffer.concat(chunks));
+    return wb;
+  }
+
+  const boatNames = (sheet) => {
+    const names = [];
+    sheet.eachRow((row, n) => {
+      if (n > 4) names.push(row.getCell(2).value);
+    });
+    return names;
+  };
+
+  test('a race with no classes exports a single Results sheet', async () => {
+    const created = await call(router, 'POST', '/races', { body: { name: 'Plain' } });
+    const id = created.body.race.id;
+    await call(router, 'POST', `/races/${id}/boats`, { body: { name: 'Alpha' } });
+    const wb = await exportWorkbook(id);
+    assert.deepEqual(wb.worksheets.map((w) => w.name), ['Results']);
+    assert.deepEqual(boatNames(wb.getWorksheet('Results')), ['Alpha']);
+  });
+
+  test('a race with classes exports one sheet per class, ranked within it', async () => {
+    const created = await call(router, 'POST', '/races', { body: { name: 'Split' } });
+    const id = created.body.race.id;
+    const classA = (await call(router, 'POST', `/races/${id}/classes`, { body: { name: 'Cruisers' } })).body.classes[0];
+    const classes = (await call(router, 'POST', `/races/${id}/classes`, { body: { name: 'Racers: 1/2' } })).body.classes;
+    const classB = classes[1];
+    const add = async (name, classId) => {
+      const b = (await call(router, 'POST', `/races/${id}/boats`, { body: { name } })).body;
+      if (classId) await call(router, 'PUT', `/races/${id}/boats/${b.id}/class`, { body: { classId } });
+    };
+    await add('A1', classA.id);
+    await add('A2', classA.id);
+    await add('B1', classB.id);
+    await add('Loner', null);
+
+    const wb = await exportWorkbook(id);
+    assert.deepEqual(wb.worksheets.map((w) => w.name), ['Cruisers', 'Racers 1 2', 'No class']);
+    assert.deepEqual(boatNames(wb.getWorksheet('Cruisers')).sort(), ['A1', 'A2']);
+    assert.deepEqual(boatNames(wb.getWorksheet('Racers 1 2')), ['B1']);
+    assert.deepEqual(boatNames(wb.getWorksheet('No class')), ['Loner']);
+    assert.match(wb.getWorksheet('Cruisers').getCell(1, 1).value, /Split — Cruisers/);
+  });
+});