@ham2k/extension-sdk 0.5.6 → 0.6.0

package/dist/scoring.js

@@ -1,9 +1,13 @@
+import { copyOnWrite } from "./copyOnWrite.js";
 const DAY_IN_MILLIS = 1e3 * 60 * 60 * 24;
+const HELD_CHECKPOINTS = 4;
+const RESUME_MISSING = "resume-missing";
+const CHECKPOINT_HELD_KEY = "$checkpointHeld";
 function copySheet(sheet) {
   return JSON.parse(JSON.stringify(sheet));
 }
-function openCheckpoint(resumeFrom, resumeDay) {
-  return { sheet: copySheet(resumeFrom), day: typeof resumeDay === "number" ? resumeDay : void 0 };
+function operationUuidOf(operation) {
+  return typeof operation.uuid === "string" ? operation.uuid : "";
 }
 function dayOf(qso) {
   const millis = Number(qso.startAtMillis ?? 0);
@@ -25,6 +29,26 @@ function candidateAsOfNow(qso) {
 function contestScorer(scorer, options = {}) {
   const scope = options.scope ?? "always";
   const scopedRefTypes = typeof scope === "object" && Array.isArray(scope.refTypes) ? scope.refTypes : void 0;
+  const held = /* @__PURE__ */ new Map();
+  function hold(operationUuid, key, sheet, day) {
+    held.delete(operationUuid);
+    held.set(operationUuid, { key, sheet, day });
+    while (held.size > HELD_CHECKPOINTS) held.delete(held.keys().next().value);
+  }
+  function resolveCheckpoint(args) {
+    const operationUuid = operationUuidOf(args.operation);
+    const key = typeof args.resumeKey === "string" ? args.resumeKey : void 0;
+    if (args.resumeFrom !== void 0) {
+      const day = typeof args.resumeDay === "number" ? args.resumeDay : void 0;
+      const sheet = args.resumeFrom;
+      if (key !== void 0) hold(operationUuid, key, sheet, day);
+      return { key: key ?? "", sheet, day };
+    }
+    if (key === void 0) return void 0;
+    const entry = held.get(operationUuid);
+    if (entry === void 0 || entry.key !== key) throw new Error(`${RESUME_MISSING}: ${key}`);
+    return entry;
+  }
   function refOfScopedType(operation) {
     if (!scopedRefTypes) return void 0;
     const refs = operation.refs ?? [];
@@ -66,33 +90,24 @@ function contestScorer(scorer, options = {}) {
     return { sheet, day: currentDay };
   }
   async function liveScoresheet(args, ctx, excludeUuid) {
-    if (args.resumeFrom !== void 0) {
-      const { sheet, day } = openCheckpoint(args.resumeFrom, args.resumeDay);
+    const resumed = resolveCheckpoint(args);
+    if (resumed !== void 0) {
+      const sheet = copyOnWrite(resumed.sheet);
       const tail = chronological(args.qsos ?? []).filter((q) => !excludeUuid || q.uuid !== excludeUuid);
-      if (tail.length === 0) return { sheet, day };
-      return fold(sheet, tail, args, ctx, void 0, void 0, args.segments, day);
+      if (tail.length === 0) return { sheet, day: resumed.day };
+      return fold(sheet, tail, args, ctx, void 0, void 0, args.segments, resumed.day);
     }
     const uuid = typeof args.operation.uuid === "string" ? args.operation.uuid : void 0;
     const log = uuid ? await ctx.getQsos?.(uuid) ?? [] : [];
-    const rest = chronological(log).filter(
-      (q) => !excludeUuid || q.uuid !== excludeUuid
-    );
-    return fold(
-      scorer.startScoresheet({ operation: args.operation, ref: args.ref }, ctx),
-      rest,
-      args,
-      ctx,
-      void 0,
-      void 0,
-      args.segments
-    );
+    const rest = chronological(log).filter((q) => !excludeUuid || q.uuid !== excludeUuid);
+    return fold(scorer.startScoresheet({ operation: args.operation, ref: args.ref }, ctx), rest, args, ctx, void 0, void 0, args.segments);
   }
   return {
     scope,
     async scoreQsos(args, ctx) {
       const qsos = chronological(args.qsos);
-      const resumed = args.resumeFrom !== void 0 ? openCheckpoint(args.resumeFrom, args.resumeDay) : void 0;
-      const start = resumed?.sheet ?? scorer.startScoresheet({ operation: args.operation, ref: args.ref }, ctx);
+      const resumed = resolveCheckpoint(args);
+      const start = resumed !== void 0 ? copySheet(resumed.sheet) : scorer.startScoresheet({ operation: args.operation, ref: args.ref }, ctx);
       const qsoScores = {};
       const daySections = [];
       const { sheet: end, day: endDay } = fold(
@@ -113,15 +128,15 @@ function contestScorer(scorer, options = {}) {
         args.segments,
         resumed?.day
       );
+      const checkpointHeld = typeof args.checkpointKey === "string";
+      if (checkpointHeld) hold(operationUuidOf(args.operation), args.checkpointKey, end, endDay);
       return {
         qsoScores,
         daySections,
-        operationSummary: scorer.summarizeScore(
-          { scoresheet: end, operation: args.operation, ref: args.ref, scope: "operation" },
-          ctx
-        ),
+        operationSummary: scorer.summarizeScore({ scoresheet: end, operation: args.operation, ref: args.ref, scope: "operation" }, ctx),
         scoresheet: end,
-        ...endDay !== void 0 && { scoresheetDay: endDay }
+        ...endDay !== void 0 && { scoresheetDay: endDay },
+        ...checkpointHeld && { checkpointHeld: true }
       };
     },
     /// Live path: score the candidate against the log so far and report only
@@ -129,30 +144,36 @@ function contestScorer(scorer, options = {}) {
     /// discarded, which is exactly why one `scoreQso` can serve both paths.
     async scoreQso(args, ctx) {
       const { sheet } = await liveScoresheet(args, ctx, args.excludeUuid);
-      const { score } = scorer.scoreQso(
-        { scoresheet: sheet, qso: candidateAsOfNow(args.qso), operation: args.operation, ref: args.ref, isNewDay: false },
-        ctx
-      );
-      return { notices: score.notices ?? [], alerts: score.alerts ?? [], ...score.dupe !== void 0 && { dupe: score.dupe } };
+      const { score } = scorer.scoreQso({ scoresheet: sheet, qso: candidateAsOfNow(args.qso), operation: args.operation, ref: args.ref, isNewDay: false }, ctx);
+      const checkpointHeld = typeof args.resumeKey === "string";
+      return {
+        notices: score.notices ?? [],
+        alerts: score.alerts ?? [],
+        ...score.dupe !== void 0 && { dupe: score.dupe },
+        ...checkpointHeld && { checkpointHeld: true }
+      };
     },
     /// The same live judgement as `scoreQso`, for many candidates at once —
     /// the Spots Panel annotating every spot on screen. The log is folded ONCE
-    /// and each candidate scored against its own copy of the result, so a
+    /// and each candidate scored against its own view of the result, so a
     /// candidate can neither see nor become a duplicate of another (both spots
     /// for the same unworked call read as unworked, which is what an operator
     /// scanning a band expects).
     ///
-    /// The copy is per candidate rather than per call because
+    /// The view is per candidate rather than per call because
     /// `ContestScorer.scoreQso` may mutate the scoresheet it is handed — the
     /// contract that makes the batch fold linear. Without it the first
-    /// candidate's call would count as worked for every candidate after it.
+    /// candidate's call would count as worked for every candidate after it. A
+    /// view, not a copy: copying a long log's worked-call map forty times over
+    /// was the cost of the whole pass.
     async scoreCandidates(args, ctx) {
       const { sheet: base } = await liveScoresheet(args, ctx);
       const result = {};
+      if (typeof args.resumeKey === "string") result[CHECKPOINT_HELD_KEY] = true;
       for (const candidate of args.candidates) {
         const { score } = scorer.scoreQso(
           {
-            scoresheet: copySheet(base),
+            scoresheet: copyOnWrite(base),
             qso: candidateAsOfNow(candidate.qso),
             operation: args.operation,
             ref: args.ref,
@@ -174,6 +195,8 @@ function tally(key, forScope, total, extra = {}) {
   return { key, for: forScope, total, ...extra };
 }
 export {
+  CHECKPOINT_HELD_KEY,
+  RESUME_MISSING,
   contestScorer,
   tally
 };

package/docs/distribution.md

@@ -37,7 +37,7 @@ The same manifest a built-in extension carries, plus `api`:
   "version": "1.2.3",
   "description": "Notes about the stations I work",
   "category": "dashboard",
-  "api": 1,
+  "api": 2,
   "domains": ["notes.example.org"],
   "icon": "note-text"
 }
@@ -45,7 +45,10 @@ The same manifest a built-in extension carries, plus `api`:
 
 `api` is the extension API the bundle was built against. The host refuses one
 it does not speak, so an older app meeting a newer bundle says so instead of
-failing somewhere deep in a hook.
+failing somewhere deep in a hook — and the catalog does not list it for that
+app at all. Declare the lowest version that has what the bundle uses, so it
+reaches every app that can run it: 2 adds `host.webSocket`, and the packer
+refuses a manifest declaring `webSockets` under anything less.
 
 Three fields are **refused** in a distributed bundle, and it is worth
 understanding why:
@@ -198,8 +201,8 @@ below — manifest, source, build script — so the rest of this section is what
 change rather than what to type.
 
 ```js
-import { build } from 'esbuild'
-import { buildExtension } from '@ham2k/extension-tools'
+import { build } from "esbuild"
+import { buildExtension } from "@ham2k/extension-tools"
 
 await buildExtension(build, { dir: import.meta.dirname })
 ```
@@ -224,7 +227,7 @@ own module state — and nothing anywhere that says so. If the second copy is
 what you want, which is how you use a version the host does not carry, say so:
 
 ```js
-await buildExtension(build, { dir: import.meta.dirname, inline: ['liquidjs'] })
+await buildExtension(build, { dir: import.meta.dirname, inline: ["liquidjs"] })
 ```
 
 `extensions/samples/hello-world` is the shortest complete example. Declaring
@@ -254,7 +257,7 @@ It reports every problem at once rather than one per run:
 h2kext-pack: ./build is not ready to package:
 manifest.json: missing required field 'name'
 manifest.json: key 'my-clock' must start with your callsign — 'my' is not one (e.g. ki2d-my-clock)
-manifest.json: missing 'api' — declare the extension API this was built against (currently 1)
+manifest.json: missing 'api' — declare the extension API this was built against (currently 2)
 ```
 
 `--force-name` waives the naming convention below. It exists for Ham2K's own
@@ -318,8 +321,8 @@ needs one degrades the same way it does in a build without that value
 configured.
 
 The sandbox is otherwise the same one the built-in extensions run in — no
-filesystem, no network beyond the `domains` the manifest declares and the user
-approved, no timers.
+filesystem, no network beyond the `domains` and `webSockets` the manifest
+declares and the user approved, no timers.
 
 ## Installing one
 

package/docs/hooks.md

@@ -499,11 +499,13 @@ interface ActivityHook {
   suggest?(args: SuggestArgs, ctx): Promise<ActivitySuggestion[]>
   processQsoBeforeSave?(args: { qso, operation }, ctx): Promise<Patch | null>
 }
-// LoggingControlDescriptor: {key, label, shortLabel?, icon?, color?, order?,
-//   optionType?, allowsMultiple?, editable?, input}
+// LoggingControlDescriptor: {key, label, shortLabel?, skipFocus?, icon?, color?,
+//   order?, optionType?, allowsMultiple?, editable?, input}
 // `shortLabel` is the same name in fewer characters, for a field the logging
 // row has squeezed below its label's width. The core measures and picks; the
 // extension only says what the short form is.
+// `skipFocus: true` takes a main logging field out of the Space and Tab cycle;
+// the arrow keys still reach it. Every shipped contest sets it on Our Serial.
 // SuggestArgs: {operation, location?: {lat, lon}, callsign?, searchTerm?, scoped?}
 // ActivitySuggestion: Ref & {distance?, relevance?, allowsMultiple?}
 
@@ -1161,8 +1163,10 @@ standing beside your credit, on the one row that can show only one.
 A scorer's internal *rules* stay private to its scoresheet: contests don't
 share a rule vocabulary, so only notices, alerts, points and summary tallies
 cross the boundary. `scoreQso` **may mutate** the scoresheet it's given and
-return it; copying accumulated state per QSO is quadratic, and the harness
-copies any checkpoint at its boundary.
+return it; copying accumulated state per QSO is quadratic. The batch pass
+copies the checkpoint it resumes from, once; the live paths hand the scorer a
+copy-on-write view of it instead (`copyOnWrite` in the SDK), so a candidate's
+writes land in the view and the held sheet is never touched.
 
 ```ts
 // The wire shape the harness produces, for reference:
@@ -1171,17 +1175,19 @@ interface ScoringHook {
   scoreQso?(args: ScoreQsoRequest, ctx): Promise<QsoScoreNotices>
   scoreCandidates?(args: ScoreCandidatesRequest, ctx): Promise<ScoreCandidatesResult>
 }
-// ScoreQsosRequest: {operation, qsos, ref?, segments?, resumeFrom?, resumeDay?}
+// ScoreQsosRequest: {operation, qsos, ref?, segments?, resumeFrom?, resumeDay?, resumeKey?, checkpointKey?}
 // ScoreQsosResult:  {
 //   qsoScores: Record<uuid, QsoScoreVerdict>,   // one per QSO claimed; see above
 //   daySections: {day, count, scores: Record<tallyKey, ScoreTally>}[],
 //   operationSummary: Record<tallyKey, ScoreTally>,
 //   scoresheet,                                  // checkpoint to resume from
 //   scoresheetDay?,                              // the day it ends on, handed back as resumeDay
+//   checkpointHeld?,                             // true: the harness kept the end sheet under checkpointKey
 // }
-// ScoreQsoRequest:        {operation, qso, excludeUuid?, ref?, segments?, resumeFrom?, resumeDay?, qsos?}
-// ScoreCandidatesRequest: {operation, candidates: {key, qso}[], ref?, segments?, resumeFrom?, resumeDay?, qsos?}
-// ScoreCandidatesResult:  Record<candidateKey, QsoScoreNotices>
+// ScoreQsoRequest:        {operation, qso, excludeUuid?, ref?, segments?, resumeFrom?, resumeDay?, resumeKey?, qsos?}
+// QsoScoreNotices:        {notices, alerts, dupe?, checkpointHeld?}
+// ScoreCandidatesRequest: {operation, candidates: {key, qso}[], ref?, segments?, resumeFrom?, resumeDay?, resumeKey?, qsos?}
+// ScoreCandidatesResult:  Record<candidateKey, QsoScoreNotices> + {"$checkpointHeld": true} when a checkpoint was named
 ```
 
 All three arrive already implemented by `contestScorer()`; a scorer writes the
@@ -1192,22 +1198,48 @@ both live paths for free.
 A candidate that carries no `startAtMillis` (the draft's time is still
 automatic) reaches the scorer stamped with the current time on both live
 paths, so a day-bucketed rule judges it as of now rather than at the epoch; a
-candidate that states a time keeps it. On both live paths a `resumeFrom`
-checkpoint, with the `qsos` logged since it, stands in for the whole-log read:
-the harness copies the checkpoint, replays that tail onto it (continuing the
-day `resumeDay` names, so no scorer's per-day tally restarts mid-day) and
-scores the candidate against the result. The host sends a checkpoint only when
-it can prove the log is what the checkpoint folded plus appended contacts
-(`scoreQso`), or when the log has not moved since the checkpoint was written
-(`scoreCandidates`, which sends no tail yet); otherwise the harness reads the
-log through `ctx.getQsos` and folds it cold.
+candidate that states a time keeps it. On both live paths a checkpoint, with
+the `qsos` logged since it, stands in for the whole-log read: the harness
+views the checkpoint copy-on-write, replays that tail onto the view
+(continuing the day `resumeDay` names, so no scorer's per-day tally restarts
+mid-day) and scores the candidate against the result. The host sends a
+checkpoint only when it can prove the log is what the checkpoint folded plus
+appended contacts; otherwise the harness reads the log through `ctx.getQsos`
+and folds it cold. The batched `scoreQsos` resumes the same way: after the
+first pass of a session, an append arrives as a checkpoint plus the appended
+contacts, and only their verdicts come back.
+
+**A checkpoint is held in the runtime and named, not sent, once it is
+there.** A sheet the size of a long log's worked-call map crossing the bridge
+on every keystroke would be most of the keystroke's cost. So the host names
+each checkpoint (`checkpointKey`, derived from the checkpoint's stamp) when
+the batch pass produces it, and the harness keeps the end sheet under that
+name — one per operation, the last few operations. A live call, or the next
+append, then carries `resumeKey` alone; a `resumeFrom` that arrives beside a
+`resumeKey` is filed under it too. A name the harness does not hold — a
+runtime restarted since, or one operation more than it keeps — is an error
+(`resume-missing`), never a silent cold fold, and the host answers it by
+sending the sheet once more. The host names a checkpoint only to a harness
+that has said `checkpointHeld: true` for it; a scorer built on an SDK without
+the cache never says so and keeps receiving the sheet. A `scoreCandidates`
+answer says it under the reserved key `$checkpointHeld`, since its other
+entries are the caller's candidate keys — a candidate key never starts with
+`$`.
+
+The view a scorer gets on the live paths takes every kind of write —
+assignment, `push`, `delete`, `Object.defineProperty` — and refuses the ones
+that would reach the base sheet by other means: `Object.freeze` (or `seal`,
+`preventExtensions`) on it throws. A sheet is plain JSON; one that is frozen
+or carries accessors is outside the contract and throws at the first touch.
+
 `scoreCandidates` answers the same question for many at once, which is what the
 Spots Panel asks to mark the spots already worked: the log is folded once per
-scorer and every candidate scored against a COPY of the result, so no candidate
-can become another's duplicate. Candidates carry no uuid — a spot is not a
-record — so results come back under caller-chosen keys.
+scorer and every candidate scored against its own copy-on-write VIEW of the
+result, so no candidate can become another's duplicate and no candidate pays
+for a copy of the log. Candidates carry no uuid — a spot is not a record — so
+results come back under caller-chosen keys.
 
-`Qsos.watchForOperation` already filters deleted rows and orders by
+`QsosRepository.forOperation` already filters deleted rows and orders by
 `startAtMillis`, so unlike web-lofi's `analyzeAndSectionQSOs` there's no
 `deleted`/`event` row bookkeeping on this side of the bridge.
 `ScoringService` (`app/lib/services/scoring_service.dart`) writes

package/docs/templates.md

@@ -224,7 +224,7 @@ will jump rather than count. Show HH:MM.
 | Panel documents | `custom-text`'s content and tab name | by the operator, in the panel's config form |
 | Export filenames and titles | Registered export types and `sdk/src/exportSettings.ts` | Settings → Exports, globally and per type |
 | ADIF NOTES / COMMENT / QSLMSG | Export type settings, consumed by `core/adif` | Settings → Exports; empty templates suppress a field |
-| CW messages | Radio settings `cwMessage1..8`, keyed on F1-F8 through the radio (docs/design/cat.md § CW keying) — rendered by the `template` hook (hooks.md) | by the operator, in the Station dialog's Messages… dialog |
+| CW messages | Radio settings `cwMessage1..8`, keyed on F1-F8 through the radio (docs/design/cat.md § CW keying) — rendered by the `template` hook (hooks.md) | by the operator, in the CW Keyer dialog (Settings → Radio, or the Station dialog's keyer row) |
 
 NOTES and COMMENT default to QSO notes and are withheld when private data
 is off. QSLMSG defaults to empty for program exports, and for the whole-log

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@ham2k/extension-sdk",
-  "version": "0.5.6",
+  "version": "0.6.0",
   "description": "Write extensions for the Ham2K Logger: typed hook contracts and the host API",
   "keywords": [
     "ham2k",

package/samples/k2hrc-cqww/build.mjs

@@ -1,6 +1,6 @@
-import { build } from 'esbuild'
-import { buildExtension } from '@ham2k/extension-tools'
+import { build } from "esbuild"
+import { buildExtension } from "@ham2k/extension-tools"
 
 await buildExtension(build, { dir: import.meta.dirname })
 
-console.log('built build/index.js')
+console.log("built build/index.js")

package/samples/k2hrc-cqww/src/index.ts

@@ -21,14 +21,7 @@
 // for the whole thing.
 
 import { annotateCallAgainstCountryFile, contestScorer, defineExtension } from "@ham2k/extension-sdk"
-import type {
-  ContestScorer,
-  HookContext,
-  JSONValue,
-  LoggingControlDescriptor,
-  Ref,
-  ScoreTally,
-} from "@ham2k/extension-sdk"
+import type { ContestScorer, HookContext, JSONValue, LoggingControlDescriptor, Ref, ScoreTally } from "@ham2k/extension-sdk"
 import { fmtInteger } from "@ham2k/lib-format-tools"
 
 import manifest from "../manifest.json" with { type: "json" }
@@ -53,7 +46,9 @@ function refOfType(container: Record<string, JSONValue>, type: string): Record<s
 
 /// "05" and "5" are the same multiplier and must not count twice.
 function normalizeZone(value: JSONValue | undefined): string {
-  const digits = String(value ?? "").trim().replace(/^0+(?=\d)/, "")
+  const digits = String(value ?? "")
+    .trim()
+    .replace(/^0+(?=\d)/, "")
   return /^([1-9]|[1-3][0-9]|40)$/.test(digits) ? digits : ""
 }
 
@@ -154,10 +149,7 @@ const CQWWScorer: ContestScorer<Scoresheet> = {
 
 const ActivityHook = {
   /// What the operator fills in when adding this contest to an operation.
-  async operationControls(
-    _args: { operation: Record<string, JSONValue> },
-    _ctx: HookContext,
-  ): Promise<LoggingControlDescriptor[]> {
+  async operationControls(_args: { operation: Record<string, JSONValue> }, _ctx: HookContext): Promise<LoggingControlDescriptor[]> {
     return [
       {
         key: "k2hrc-cqww/setup",
@@ -209,8 +201,7 @@ const ActivityHook = {
     const their = (args.qso?.their as Record<string, JSONValue>) ?? {}
     const guess = (their.guess as Record<string, JSONValue>) ?? {}
     const call = str(their.call)
-    const suggested =
-      normalizeZone(guess.cqZone) || (call ? normalizeZone(annotateCallAgainstCountryFile(call).cqZone) : "")
+    const suggested = normalizeZone(guess.cqZone) || (call ? normalizeZone(annotateCallAgainstCountryFile(call).cqZone) : "")
 
     return [
       {

package/samples/k2hrc-hamqth/build.mjs

@@ -1,6 +1,6 @@
-import { build } from 'esbuild'
-import { buildExtension } from '@ham2k/extension-tools'
+import { build } from "esbuild"
+import { buildExtension } from "@ham2k/extension-tools"
 
 await buildExtension(build, { dir: import.meta.dirname })
 
-console.log('built build/index.js')
+console.log("built build/index.js")

package/samples/k2hrc-hamqth/src/index.ts

@@ -46,8 +46,7 @@ async function login(ctx: HookContext): Promise<string> {
   const password = ctx.account?.credentials?.password
   if (!username || !password) throw new Error("No HamQTH account configured")
 
-  const response = await host.fetch(
-    `${API}?u=${encodeURIComponent(username)}&p=${encodeURIComponent(password)}`)
+  const response = await host.fetch(`${API}?u=${encodeURIComponent(username)}&p=${encodeURIComponent(password)}`)
   const sessionId = tag(response.body, "session_id")
   if (!sessionId) throw new Error(tag(response.body, "error") ?? `HTTP ${response.status}`)
 
@@ -62,8 +61,7 @@ async function login(ctx: HookContext): Promise<string> {
 /// Note that it re-logs-in only ONCE — a second failure is a real one, and
 /// looping on it would hammer the API behind the operator's back.
 async function fetchCall(call: string, ctx: HookContext): Promise<string> {
-  const search = (id: string) =>
-    host.fetch(`${API}?id=${id}&callsign=${encodeURIComponent(call)}&prg=${PROGRAM}`)
+  const search = (id: string) => host.fetch(`${API}?id=${id}&callsign=${encodeURIComponent(call)}&prg=${PROGRAM}`)
 
   const sessionId = ctx.account?.session?.sessionId ?? (await login(ctx))
   const response = await search(sessionId)
@@ -167,13 +165,11 @@ const HamQTHAccount = {
     if (!username || !credentials.password) return "Enter your HamQTH username and password"
 
     try {
-      const response = await host.fetch(
-        `${API}?u=${encodeURIComponent(username)}&p=${encodeURIComponent(credentials.password)}`)
+      const response = await host.fetch(`${API}?u=${encodeURIComponent(username)}&p=${encodeURIComponent(credentials.password)}`)
       const sessionId = tag(response.body, "session_id")
       if (!sessionId) return tag(response.body, "error") ?? `HamQTH returned HTTP ${response.status}`
 
-      const check = await host.fetch(
-        `${API}?id=${sessionId}&callsign=${encodeURIComponent(username)}&prg=${PROGRAM}`)
+      const check = await host.fetch(`${API}?id=${sessionId}&callsign=${encodeURIComponent(username)}&prg=${PROGRAM}`)
       const name = tag(check.body, "adr_name")
       return `✅ ${username.toUpperCase()}${name ? `: ${name}` : ""}`
     } catch (e) {

package/samples/k2hrc-llota/build.mjs

@@ -1,6 +1,6 @@
-import { build } from 'esbuild'
-import { buildExtension } from '@ham2k/extension-tools'
+import { build } from "esbuild"
+import { buildExtension } from "@ham2k/extension-tools"
 
 await buildExtension(build, { dir: import.meta.dirname })
 
-console.log('built build/index.js')
+console.log("built build/index.js")

package/samples/k2hrc-llota/src/index.ts

@@ -19,12 +19,7 @@
 // API key the program issues, and the export hooks that submit a log. See
 // `docs/hooks.md` §`spots` and §`export`.
 
-import {
-  activityScorer,
-  contestScorer,
-  defineExtension,
-  referenceActivity,
-} from "@ham2k/extension-sdk"
+import { activityScorer, contestScorer, defineExtension, referenceActivity } from "@ham2k/extension-sdk"
 import type { DataFileDefinition, HookContext } from "@ham2k/extension-sdk"
 import { locationToGrid6 } from "@ham2k/lib-geo-tools"
 
@@ -116,7 +111,9 @@ const referenceList: DataFileDefinition = {
   category: "k2hrc-llota",
 
   jsonToLookupEntry: (entry: Record<string, any>) => {
-    const ref = String(entry?.reference_code ?? "").trim().toUpperCase()
+    const ref = String(entry?.reference_code ?? "")
+      .trim()
+      .toUpperCase()
     // Returning null drops the entry. A list of this size will contain a few
     // rows that are not references, and throwing would abandon the rest.
     if (!ref) return null

package/samples/k2hrc-radio/build.mjs

@@ -1,6 +1,6 @@
-import { build } from 'esbuild'
-import { buildExtension } from '@ham2k/extension-tools'
+import { build } from "esbuild"
+import { buildExtension } from "@ham2k/extension-tools"
 
 await buildExtension(build, { dir: import.meta.dirname })
 
-console.log('built build/index.js')
+console.log("built build/index.js")

package/samples/k2hrc-radio/src/index.ts

@@ -49,11 +49,7 @@ const PREVIEW = `<svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 24 24">
 /// document that does not parse, and the sandbox is a mitigation, not a reason
 /// to skip this.
 function escapeHtml(value: string): string {
-  return value
-    .replace(/&/g, "&amp;")
-    .replace(/</g, "&lt;")
-    .replace(/>/g, "&gt;")
-    .replace(/"/g, "&quot;")
+  return value.replace(/&/g, "&amp;").replace(/</g, "&lt;").replace(/>/g, "&gt;").replace(/"/g, "&quot;")
 }
 
 /// 14074000 → "14.074.0" — the grouping a radio's own display uses, which is

package/samples/k2hrc-svg-scenes/build.mjs

@@ -1,6 +1,6 @@
-import { build } from 'esbuild'
-import { buildExtension } from '@ham2k/extension-tools'
+import { build } from "esbuild"
+import { buildExtension } from "@ham2k/extension-tools"
 
 await buildExtension(build, { dir: import.meta.dirname })
 
-console.log('built build/index.js')
+console.log("built build/index.js")

package/samples/k2hrc-svg-scenes/manifest.json

@@ -8,16 +8,8 @@
   "icon": "radio-tower",
   "accentColor": "#4C6EF5",
   "api": 1,
-  "keywords": [
-    "svg",
-    "panel",
-    "sample",
-    "weather",
-    "radio"
-  ],
-  "hooks": [
-    "panel"
-  ],
+  "keywords": ["svg", "panel", "sample", "weather", "radio"],
+  "hooks": ["panel"],
   "sharedDependencies": {
     "@ham2k/lib-callsigns": "^1.0.0",
     "@ham2k/lib-country-files": "^1.0.0",

package/samples/k2hrc-svg-scenes/src/index.ts

@@ -1,12 +1,12 @@
 // Copyright ©️ 2026 Sebastian Delmont <sd@ham2k.com>
 // SPDX-License-Identifier: MIT
-import { defineExtension } from '@ham2k/extension-sdk'
-import manifest from '../manifest.json' with { type: 'json' }
-import { createScenePanels } from './scenes.ts'
+import { defineExtension } from "@ham2k/extension-sdk"
+import manifest from "../manifest.json" with { type: "json" }
+import { createScenePanels } from "./scenes.ts"
 
 defineExtension({
   ...manifest,
   onActivation({ registerHook }) {
-    registerHook('panel', { key: manifest.key, hook: createScenePanels() })
+    registerHook("panel", { key: manifest.key, hook: createScenePanels() })
   },
 })