@ham2k/extension-sdk 0.5.5 → 0.5.7

package/AGENTS.md

@@ -34,24 +34,24 @@ build/             generated: index.js + manifest.json
 ## The smallest whole extension
 
 ```ts
-import { defineExtension } from '@ham2k/extension-sdk'
-import type { PanelHook } from '@ham2k/extension-sdk'
+import { defineExtension } from "@ham2k/extension-sdk"
+import type { PanelHook } from "@ham2k/extension-sdk"
 
-import manifest from '../manifest.json'
+import manifest from "../manifest.json"
 
 const HelloPanel: PanelHook = {
   async getPanels() {
-    return [{ key: 'hello', title: 'Hello World', icon: 'hand-wave-outline' }]
+    return [{ key: "hello", title: "Hello World", icon: "hand-wave-outline" }]
   },
   async render() {
-    return { kind: 'markdown', content: '# Hello, World!' }
+    return { kind: "markdown", content: "# Hello, World!" }
   },
 }
 
 defineExtension({
   ...manifest,
   onActivation({ registerHook }) {
-    registerHook('panel', { key: manifest.key, hook: HelloPanel })
+    registerHook("panel", { key: manifest.key, hook: HelloPanel })
   },
 })
 ```
@@ -100,7 +100,7 @@ No Node, no DOM, no `fetch`, no `window`, no filesystem. One ES2020 engine
 evaluating one script. Reach the outside world through `host`:
 
 ```ts
-import { host } from '@ham2k/extension-sdk'
+import { host } from "@ham2k/extension-sdk"
 
 await host.fetch(url)          // https only, and only domains your manifest lists
 await host.kvGet('key')        // storage, namespaced to your extension
@@ -114,7 +114,7 @@ host.log('…')                  // the app's console
 
 ## Traps worth knowing before you write anything
 
-- **A panel returns content, not widgets.** `{ kind: 'markdown', content }` and
+- **A panel returns content, not widgets.** `{ kind: "markdown", content }` and
   its siblings. There is no way to reach the app's UI toolkit, by design.
 - **`host.fetch` only reaches domains your manifest's `domains` lists**, over
   https. An undeclared host is refused at the call, not at build.
@@ -122,7 +122,7 @@ host.log('…')                  // the app's console
   carries `@ham2k/lib-*`, `i18next` and `liquidjs`; naming one in
   `sharedDependencies` rewrites your imports into lookups on the app's single
   copy, which is worth roughly thirty times the bundle size. Don't install them.
-  `inline: ['liquidjs']` in your build ships your own copy, for when you need a
+  `inline: ["liquidjs"]` in your build ships your own copy, for when you need a
   version the app does not carry. A scaffolded manifest already declares the
   eight this SDK's own modules reach — importing anything from it pulls them
   in — so deleting one from the manifest breaks a build that was working.

package/README.md

@@ -9,24 +9,24 @@ npm install --save-dev @ham2k/extension-tools esbuild
 ```
 
 ```ts
-import { defineExtension } from '@ham2k/extension-sdk'
-import type { PanelHook } from '@ham2k/extension-sdk'
+import { defineExtension } from "@ham2k/extension-sdk"
+import type { PanelHook } from "@ham2k/extension-sdk"
 
-import manifest from '../manifest.json'
+import manifest from "../manifest.json"
 
 const HelloPanel: PanelHook = {
   async getPanels() {
-    return [{ key: 'hello', title: 'Hello World', icon: 'hand-wave-outline' }]
+    return [{ key: "hello", title: "Hello World", icon: "hand-wave-outline" }]
   },
   async render() {
-    return { kind: 'markdown', content: '# Hello, World!' }
+    return { kind: "markdown", content: "# Hello, World!" }
   },
 }
 
 defineExtension({
   ...manifest,
   onActivation({ registerHook }) {
-    registerHook('panel', { key: manifest.key, hook: HelloPanel })
+    registerHook("panel", { key: manifest.key, hook: HelloPanel })
   },
 })
 ```

package/dist/activityExports.js

@@ -23,14 +23,16 @@ function activityExportHook(rules) {
   const prefix = `${rules.key}-adif`;
   return {
     async getExportTypes() {
-      return [{
-        ...exportTypeDefinition(rules.activationType, "adif", rules.label),
-        templateCategory: "reference",
-        templateSample: rules.templateSample ?? {
-          log: { ref: "REF-1234", refName: "Example Reference" },
-          operation: { refs: [{ type: rules.activationType, ref: "REF-1234" }] }
+      return [
+        {
+          ...exportTypeDefinition(rules.activationType, "adif", rules.label),
+          templateCategory: "reference",
+          templateSample: rules.templateSample ?? {
+            log: { ref: "REF-1234", refName: "Example Reference" },
+            operation: { refs: [{ type: rules.activationType, ref: "REF-1234" }] }
+          }
         }
-      }];
+      ];
     },
     async suggestExportOptions({ operation, qsos, compactFilenames }, ctx) {
       const refs = refsOfType(operation, rules.activationType);
@@ -113,21 +115,23 @@ function huntingExportHook(rules) {
       if (refsOfType(operation, rules.activationType).length > 0) return [];
       if (huntedQsos(qsos ?? []).length === 0) return [];
       const t = tFor(ctx);
-      return [{
-        exportType,
-        qsoCount: huntedQsos(qsos ?? []).length,
-        templateData: { activity: rules.label },
-        format: "adif",
-        label: t("adifForHunter", { program: rules.label }),
-        filename: filenameForHunt(operation, qsos ?? [], rules.label, compactFilenames),
-        icon: rules.icon,
-        color: rules.color,
-        selectedByDefault: true
-        // No `refType`: hunted refs live on QSOs, not on operation segments,
-        // so this isn't the segment-scoped slice `activityExportHook` uses —
-        // it spans the whole log. (See `HuntingExportRules.color` for why the
-        // accent has to be threaded explicitly instead.)
-      }];
+      return [
+        {
+          exportType,
+          qsoCount: huntedQsos(qsos ?? []).length,
+          templateData: { activity: rules.label },
+          format: "adif",
+          label: t("adifForHunter", { program: rules.label }),
+          filename: filenameForHunt(operation, qsos ?? [], rules.label, compactFilenames),
+          icon: rules.icon,
+          color: rules.color,
+          selectedByDefault: true
+          // No `refType`: hunted refs live on QSOs, not on operation segments,
+          // so this isn't the segment-scoped slice `activityExportHook` uses —
+          // it spans the whole log. (See `HuntingExportRules.color` for why the
+          // accent has to be threaded explicitly instead.)
+        }
+      ];
     },
     async generateExport(args, ctx) {
       const requested = String(args.exportType ?? "");
@@ -163,7 +167,18 @@ function huntingExportHook(rules) {
     }
   };
 }
-async function adifForExport({ operation, qsos, segments, includePrivateData, includeLookupData, exportSettings, exportData, exportTitle, mainHandler, includeFieldsFrom }) {
+async function adifForExport({
+  operation,
+  qsos,
+  segments,
+  includePrivateData,
+  includeLookupData,
+  exportSettings,
+  exportData,
+  exportTitle,
+  mainHandler,
+  includeFieldsFrom
+}) {
   const { hooks } = await import("@ham2k/extension-sdk");
   const entries = await hooks.invokeOne("export", "adif", "generateExport", {
     operation,

package/dist/activityScoring.js

@@ -62,9 +62,7 @@ function activityScorer(rules) {
       if (candidates.length === 0) notice ?? (notice = "mode");
     }
     if (unique.has("ref")) {
-      candidates = candidates.filter(
-        (c) => c.refs.length === 0 && now.refs.length === 0 || c.refs.some((r) => now.refs.includes(r))
-      );
+      candidates = candidates.filter((c) => c.refs.length === 0 && now.refs.length === 0 || c.refs.some((r) => now.refs.includes(r)));
       if (candidates.length === 0 && now.refs.length > 0) notice ?? (notice = "ref");
     }
     if (notice) return notice;
@@ -189,14 +187,10 @@ function summarizeActivation(activatedRefs, qsos, duplicates, huntedQsos, scope,
   const detail = refKeys.map(
     (key) => activatedRefs[key] >= qsosToActivate ? `\u2705 **${key}: ${fmtInteger(activatedRefs[key])}**` : `\u274C ${key}: ${fmtInteger(activatedRefs[key])}/${fmtInteger(qsosToActivate)}`
   );
-  const parts = [
-    qsos === 1 ? t("activationQsoOne") : t("activationQsoMany", { formatted: fmtInteger(qsos) })
-  ];
+  const parts = [qsos === 1 ? t("activationQsoOne") : t("activationQsoMany", { formatted: fmtInteger(qsos) })];
   if (huntedQsos > 0) {
     const p2p = resolveRuleText(rules.p2pLabel, ctx, t("ref2ref"));
-    parts.push(
-      huntedQsos === 1 ? t("p2pQsoOne", { label: p2p }) : t("p2pQsoMany", { label: p2p, formatted: fmtInteger(huntedQsos) })
-    );
+    parts.push(huntedQsos === 1 ? t("p2pQsoOne", { label: p2p }) : t("p2pQsoMany", { label: p2p, formatted: fmtInteger(huntedQsos) }));
   }
   return {
     key: "activation",

package/dist/exportNames.js

@@ -26,22 +26,23 @@ function exportFilename(parts) {
   const millis = parts.startAtMillis && parts.startAtMillis > 0 ? parts.startAtMillis : Date.now();
   const extension = parts.extension.replace(/^\./, "");
   const shape = `${parts.compact ? "Compact" : "Normal"}${parts.ref ? "Ref" : parts.activity ? "Activity" : ""}Name`;
-  const modifier = [
-    (parts.modifier ?? "").trim(),
-    isTestOperation(parts.stationCall) ? "Testing" : ""
-  ].filter((part) => part !== "").join(" ");
+  const modifier = [(parts.modifier ?? "").trim(), isTestOperation(parts.stationCall) ? "Testing" : ""].filter((part) => part !== "").join(" ");
   const stem = oneLine(
-    renderTemplate(NAME_TEMPLATES[shape], {
-      op: dateValues(millis),
-      log: logValues({
-        station: String(parts.stationCall ?? "").trim(),
-        ref: parts.ref,
-        activity: parts.activity,
-        modifier,
-        extension,
-        compact: parts.compact
-      })
-    }, shape)
+    renderTemplate(
+      NAME_TEMPLATES[shape],
+      {
+        op: dateValues(millis),
+        log: logValues({
+          station: String(parts.stationCall ?? "").trim(),
+          ref: parts.ref,
+          activity: parts.activity,
+          modifier,
+          extension,
+          compact: parts.compact
+        })
+      },
+      shape
+    )
   );
   return `${sanitize(stem) || "export"}.${extension}`;
 }

package/dist/exportSettings.js

@@ -118,7 +118,17 @@ function prepareExportOption(option, operation, qsos, compact) {
   const rendered = oneLine(renderTemplate(template ?? "", context, "Export filename"));
   const stem = rendered.replace(/[/\\:*?"<>|\x00-\x1f]+/g, "-").replace(/[. ]+$/g, "").trim() || "export";
   const filename = stem.toLowerCase().endsWith(`.${extension}`) ? stem : `${stem}.${extension}`;
-  const titleContext = settings.includePrivateData === false ? { ...context, op: { ...context.op, title: "", userTitle: "", userNotes: "", grid: String(context.op.grid ?? "").slice(0, 6) }, log: { ...context.log, modifier: "" } } : context;
+  const titleContext = settings.includePrivateData === false ? {
+    ...context,
+    op: {
+      ...context.op,
+      title: "",
+      userTitle: "",
+      userNotes: "",
+      grid: String(context.op.grid ?? "").slice(0, 6)
+    },
+    log: { ...context.log, modifier: "" }
+  } : context;
   const title = oneLine(renderTemplate(settings.titleTemplate ?? "", titleContext, "Export title"));
   return { ...option, filename, exportTitle: title, exportData: settings.includePrivateData === false ? { ...data, modifier: "" } : data };
 }

package/dist/index.d.ts

@@ -1,4 +1,4 @@
-// @ham2k/extension-sdk 0.5.5
+// @ham2k/extension-sdk 0.5.7
 /** Experimental v1 scene contract. All coordinates are in the scene's viewBox. */
 export interface SvgScene {
 	version: 1;
@@ -102,7 +102,7 @@ export interface SvgSceneControl {
 	hover?: boolean;
 	/** Accessible descriptions indexed by (value - min) / step. */
 	valueLabels?: string[];
-	/** Knobs use relative horizontal/upward dragging. Default: step per scene unit. */
+	/** Knobs use relative horizontal/upward dragging. Value per scene unit; default 1. */
 	sensitivity?: number;
 }
 export interface PanelSceneEvent {
@@ -393,6 +393,7 @@ export interface RefGeojson {
 export interface LoggingControlDescriptor {
 	key: string;
 	label: string;
+	shortLabel?: string;
 	icon?: string;
 	color?: string;
 	order?: number;
@@ -632,12 +633,14 @@ export interface ScoreQsosRequest {
 	segments?: OperationSegmentPayload[];
 	ref?: Record<string, JSONValue>;
 	resumeFrom?: JSONValue;
+	resumeDay?: number;
 }
 export interface ScoreQsosResult {
 	qsoScores: Record<string, QsoScoreVerdict>;
 	daySections: DayScoreSummary[];
 	operationSummary: Record<string, ScoreTally>;
 	scoresheet?: JSONValue;
+	scoresheetDay?: number;
 }
 export interface ScoreQsoRequest {
 	operation: Record<string, JSONValue>;
@@ -646,6 +649,8 @@ export interface ScoreQsoRequest {
 	ref?: Record<string, JSONValue>;
 	segments?: OperationSegmentPayload[];
 	resumeFrom?: JSONValue;
+	resumeDay?: number;
+	qsos?: Record<string, JSONValue>[];
 }
 export interface QsoScoreNotices {
 	notices: string[];
@@ -661,6 +666,8 @@ export interface ScoreCandidatesRequest {
 	ref?: Record<string, JSONValue>;
 	segments?: OperationSegmentPayload[];
 	resumeFrom?: JSONValue;
+	resumeDay?: number;
+	qsos?: Record<string, JSONValue>[];
 }
 export type ScoreCandidatesResult = Record<string, QsoScoreNotices>;
 export interface ScoringHook {
@@ -1520,7 +1527,7 @@ export declare function huntingExportHook(rules: HuntingExportRules): {
 	suggestExportOptions({ operation, qsos, compactFilenames }: ExportOptionsRequest, ctx: HookContext): Promise<ExportOption[]>;
 	generateExport(args: ExportRequest, ctx: HookContext): Promise<ExportResult>;
 };
-export declare function adifForExport({ operation, qsos, segments, includePrivateData, includeLookupData, exportSettings, exportData, exportTitle, mainHandler, includeFieldsFrom }: {
+export declare function adifForExport({ operation, qsos, segments, includePrivateData, includeLookupData, exportSettings, exportData, exportTitle, mainHandler, includeFieldsFrom, }: {
 	operation: Record<string, JSONValue>;
 	qsos: Record<string, JSONValue>[];
 	segments?: OperationSegmentPayload[];

package/dist/scoring.js

@@ -1,7 +1,10 @@
 const DAY_IN_MILLIS = 1e3 * 60 * 60 * 24;
-function copyCheckpoint(sheet) {
+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 dayOf(qso) {
   const millis = Number(qso.startAtMillis ?? 0);
   return millis - millis % DAY_IN_MILLIS;
@@ -27,9 +30,9 @@ function contestScorer(scorer, options = {}) {
     const refs = operation.refs ?? [];
     return refs.find((r) => typeof r?.type === "string" && scopedRefTypes.includes(r.type));
   }
-  function fold(scoresheet, qsos, args, ctx, onQso, onDayEnd, segments) {
+  function fold(scoresheet, qsos, args, ctx, onQso, onDayEnd, segments, startDay) {
     let sheet = scoresheet;
-    let currentDay;
+    let currentDay = startDay;
     let dayCount = 0;
     const timeline = segments && segments.length > 1 ? segments : void 0;
     let segmentIndex = 0;
@@ -60,35 +63,29 @@ function contestScorer(scorer, options = {}) {
       onQso?.(typeof qso.uuid === "string" ? qso.uuid : void 0, result.score);
     }
     if (currentDay !== void 0) onDayEnd?.(currentDay, dayCount, sheet);
-    return sheet;
+    return { sheet, day: currentDay };
   }
   async function liveScoresheet(args, ctx, excludeUuid) {
     if (args.resumeFrom !== void 0) {
-      return copyCheckpoint(args.resumeFrom);
+      const { sheet, day } = openCheckpoint(args.resumeFrom, args.resumeDay);
+      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);
     }
     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 start = args.resumeFrom !== void 0 ? copyCheckpoint(args.resumeFrom) : scorer.startScoresheet({ operation: args.operation, ref: args.ref }, ctx);
+      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 qsoScores = {};
       const daySections = [];
-      const end = fold(
+      const { sheet: end, day: endDay } = fold(
         start,
         qsos,
         args,
@@ -103,27 +100,23 @@ function contestScorer(scorer, options = {}) {
             scores: scorer.summarizeScore({ scoresheet: sheet, operation: args.operation, ref: args.ref, scope: "day" }, ctx)
           });
         },
-        args.segments
+        args.segments,
+        resumed?.day
       );
       return {
         qsoScores,
         daySections,
-        operationSummary: scorer.summarizeScore(
-          { scoresheet: end, operation: args.operation, ref: args.ref, scope: "operation" },
-          ctx
-        ),
-        scoresheet: end
+        operationSummary: scorer.summarizeScore({ scoresheet: end, operation: args.operation, ref: args.ref, scope: "operation" }, ctx),
+        scoresheet: end,
+        ...endDay !== void 0 && { scoresheetDay: endDay }
       };
     },
     /// Live path: score the candidate against the log so far and report only
     /// its notices/alerts. Nothing is recorded — the resulting scoresheet is
     /// 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
-      );
+      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 } };
     },
     /// The same live judgement as `scoreQso`, for many candidates at once —
@@ -138,12 +131,12 @@ function contestScorer(scorer, options = {}) {
     /// contract that makes the batch fold linear. Without it the first
     /// candidate's call would count as worked for every candidate after it.
     async scoreCandidates(args, ctx) {
-      const base = await liveScoresheet(args, ctx);
+      const { sheet: base } = await liveScoresheet(args, ctx);
       const result = {};
       for (const candidate of args.candidates) {
         const { score } = scorer.scoreQso(
           {
-            scoresheet: copyCheckpoint(base),
+            scoresheet: copySheet(base),
             qso: candidateAsOfNow(candidate.qso),
             operation: args.operation,
             ref: args.ref,

package/docs/distribution.md

@@ -198,8 +198,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 +224,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

package/docs/hooks.md

@@ -499,8 +499,11 @@ interface ActivityHook {
   suggest?(args: SuggestArgs, ctx): Promise<ActivitySuggestion[]>
   processQsoBeforeSave?(args: { qso, operation }, ctx): Promise<Patch | null>
 }
-// LoggingControlDescriptor: {key, label, icon?, color?, order?, optionType?,
-//   allowsMultiple?, editable?, input}
+// LoggingControlDescriptor: {key, label, shortLabel?, 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.
 // SuggestArgs: {operation, location?: {lat, lon}, callsign?, searchTerm?, scoped?}
 // ActivitySuggestion: Ref & {distance?, relevance?, allowsMultiple?}
 
@@ -1168,14 +1171,16 @@ interface ScoringHook {
   scoreQso?(args: ScoreQsoRequest, ctx): Promise<QsoScoreNotices>
   scoreCandidates?(args: ScoreCandidatesRequest, ctx): Promise<ScoreCandidatesResult>
 }
-// ScoreQsosRequest: {operation, qsos, ref?, resumeFrom?}
+// ScoreQsosRequest: {operation, qsos, ref?, segments?, resumeFrom?, resumeDay?}
 // 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
 // }
-// ScoreCandidatesRequest: {operation, candidates: {key, qso}[], ref?, segments?, resumeFrom?}
+// ScoreQsoRequest:        {operation, qso, excludeUuid?, ref?, segments?, resumeFrom?, resumeDay?, qsos?}
+// ScoreCandidatesRequest: {operation, candidates: {key, qso}[], ref?, segments?, resumeFrom?, resumeDay?, qsos?}
 // ScoreCandidatesResult:  Record<candidateKey, QsoScoreNotices>
 ```
 
@@ -1187,7 +1192,16 @@ 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.
+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;
+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 `resumeFrom` plus the appended contacts, and only
+their verdicts come back.
 `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
@@ -1288,13 +1302,14 @@ numeric value patches; local-only controls and animation frames make no bridge
 calls. Controls with `continuous: true` send `change` events during dragging and a
 final `commit` on release; pending movements are coalesced to the newest value.
 Numeric text supports `scale`, `truncate`, `modulo`, and `minIntegerDigits`
-for local numeric formatting. KI2D’s Radio Panel uses these for its Modern
+for local numeric formatting; bindings accept `scale`, `truncate` and `modulo`
+too, applied to the value before the ramp. KI2D’s Radio Panel uses these for its Modern
 frequency groups; its settings offer Modern/LCD styles and radio selection. Local sliders may use `hover` and `discrete` hourly buckets. Text `samples`
 may hold numbers or preformatted strings; control `valueLabels` supplies accessible
 value descriptions. Transform/opacity bindings may also supply numeric `samples`,
 equally spaced over their `input` range, instead of the `output` ramp. The host
 interpolates and clamps these locally; chart markers and callouts can follow
-individual readings without bridge calls. See [the prototype contract and migration plan](https://github.com/ham2k/halo/blob/main/docs/design/svg-scenes.md)
+individual readings without bridge calls. See [the design notes and open milestones](https://github.com/ham2k/halo/blob/main/docs/design/svg-scenes.md)
 and the `k2hrc-svg-scenes` sample. This API is experimental.
 
 Scene-capable hosts also supply `args.environment` on **render and event** calls:

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@ham2k/extension-sdk",
-  "version": "0.5.5",
+  "version": "0.5.7",
   "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() })
   },
 })

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

@@ -1,16 +1,20 @@
 // Copyright ©️ 2026 Sebastian Delmont <sd@ham2k.com>
 // SPDX-License-Identifier: MIT
-import type { PanelContent, PanelHook, SceneBinding, SvgSceneLayer } from '@ham2k/extension-sdk'
+import type { PanelContent, PanelHook, SceneBinding, SvgSceneLayer } from "@ham2k/extension-sdk"
 
-const svg = (body: string, width = 640, height = 360) =>
-  `<svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 ${width} ${height}">${body}</svg>`
+const svg = (body: string, width = 640, height = 360) => `<svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 ${width} ${height}">${body}</svg>`
 const bind = (value: string, input: [number, number], output: [number, number]): SceneBinding => ({ value, input, output })
-const label = (x: number, y: number, text: string, size = 16, color = '#9aaec6') =>
+const label = (x: number, y: number, text: string, size = 16, color = "#9aaec6") =>
   `<text x="${x}" y="${y}" fill="${color}" font-family="sans-serif" font-size="${size}">${text}</text>`
-const button = (x: number, text: string) => `<rect x="${x}" y="298" width="172" height="38" rx="8" fill="#283b52"/>${label(x + 12, 322, text, 14, '#e7edf4')}`
-const textLayer = (id: string, value: string, x: number, y: number, width: number,
-  size: number, prefix = '', suffix = '', decimals = 0): SvgSceneLayer =>
-  ({ id, x, y, width, height: size + 12, text: { value, prefix, suffix, decimals, size, color: '#a9efcf' } })
+const button = (x: number, text: string) => `<rect x="${x}" y="298" width="172" height="38" rx="8" fill="#283b52"/>${label(x + 12, 322, text, 14, "#e7edf4")}`
+const textLayer = (id: string, value: string, x: number, y: number, width: number, size: number, prefix = "", suffix = "", decimals = 0): SvgSceneLayer => ({
+  id,
+  x,
+  y,
+  width,
+  height: size + 12,
+  text: { value, prefix, suffix, decimals, size, color: "#a9efcf" },
+})
 
 type RadioState = { requested: number; reported: number; connected: number; due: number; slow: number }
 /** Inject time for deterministic tests; no timers or per-frame extension work. */
@@ -24,103 +28,214 @@ export function createScenePanels(now: () => number = () => Date.now()): PanelHo
       s = { requested: 14074, reported: 14074, connected: 1, due: 0, slow: 1 }
       radios.set(id, s)
     }
-    if (s.connected && s.due && now() >= s.due) { s.reported = s.requested; s.due = 0 }
+    if (s.connected && s.due && now() >= s.due) {
+      s.reported = s.requested
+      s.due = 0
+    }
     return s
   }
   return {
     async getPanels() {
       return [
-        { key: 'radio', title: 'Radio Front Face · Simulation', icon: 'radio-tower', multiple: true, on: ['tick:1'] },
-        { key: 'weather', title: 'Weather Chart · Simulation', icon: 'weather-partly-cloudy', multiple: true },
+        { key: "radio", title: "Radio Front Face · Simulation", icon: "radio-tower", multiple: true, on: ["tick:1"] },
+        { key: "weather", title: "Weather Chart · Simulation", icon: "weather-partly-cloudy", multiple: true },
       ]
     },
     async render(args): Promise<PanelContent> {
-      if (args.panelKey === 'weather') {
+      if (args.panelKey === "weather") {
         const temperatures = [17, 18, 21, 24, 25, 23, 20, 18]
-        const points = temperatures.map((t, i) => `${60 + i * 74},${265 - (t - 15) * 14}`).join(' ')
-        return { kind: 'svgScene', scene: {
-          version: 1, width: 640, height: 360, values: { hour: 0 },
-          layers: [
-            { id: 'chart', x: 0, y: 0, width: 640, height: 360, svg: svg(`
+        const points = temperatures.map((t, i) => `${60 + i * 74},${265 - (t - 15) * 14}`).join(" ")
+        return {
+          kind: "svgScene",
+          scene: {
+            version: 1,
+            width: 640,
+            height: 360,
+            values: { hour: 0 },
+            layers: [
+              {
+                id: "chart",
+                x: 0,
+                y: 0,
+                width: 640,
+                height: 360,
+                svg: svg(`
               <rect width="640" height="360" rx="18" fill="#142337"/>
-              ${label(30, 38, 'FORECAST / SIMULATED DATA', 18, '#e7edf4')}
-              ${[15, 20, 25].map(t => `<path d="M60 ${265 - (t - 15) * 14}H580" stroke="#31445b"/>${label(20, 270 - (t - 15) * 14, String(t), 12)}`).join('')}
+              ${label(30, 38, "FORECAST / SIMULATED DATA", 18, "#e7edf4")}
+              ${[15, 20, 25].map((t) => `<path d="M60 ${265 - (t - 15) * 14}H580" stroke="#31445b"/>${label(20, 270 - (t - 15) * 14, String(t), 12)}`).join("")}
               <polyline points="${points}" fill="none" stroke="#8bdccc" stroke-width="4"/>
-              ${temperatures.map((t, i) => `<circle cx="${60 + i * 74}" cy="${265 - (t - 15) * 14}" r="5" fill="#e7edf4"/>${label(52 + i * 74, 288, '+' + i + 'h', 12)}`).join('')}
-              ${label(30, 334, 'Drag the chart to inspect · Arrow keys to step', 14)}
-            `) },
-            { id: 'cursor', x: 59, y: 100, width: 2, height: 172,
-              svg: svg('<rect width="2" height="172" fill="#f7c576"/>', 2, 172),
-              translateX: bind('hour', [0, 7], [0, 518]) },
-            textLayer('hour', 'hour', 30, 52, 250, 24, 'In ', ' hours'),
-            { ...textLayer('temperature', 'hour', 370, 52, 240, 24, '', ' °C'),
-              text: { value: 'hour', samples: temperatures, suffix: ' °C', size: 24, color: '#a9efcf' } },
-          ],
-          controls: [{ id: 'inspect', kind: 'slider', label: 'Forecast hour', x: 60, y: 100, width: 518, height: 185,
-            value: 'hour', min: 0, max: 7, step: 1 }],
-        } }
+              ${temperatures.map((t, i) => `<circle cx="${60 + i * 74}" cy="${265 - (t - 15) * 14}" r="5" fill="#e7edf4"/>${label(52 + i * 74, 288, "+" + i + "h", 12)}`).join("")}
+              ${label(30, 334, "Drag the chart to inspect · Arrow keys to step", 14)}
+            `),
+              },
+              {
+                id: "cursor",
+                x: 59,
+                y: 100,
+                width: 2,
+                height: 172,
+                svg: svg('<rect width="2" height="172" fill="#f7c576"/>', 2, 172),
+                translateX: bind("hour", [0, 7], [0, 518]),
+              },
+              textLayer("hour", "hour", 30, 52, 250, 24, "In ", " hours"),
+              {
+                ...textLayer("temperature", "hour", 370, 52, 240, 24, "", " °C"),
+                text: { value: "hour", samples: temperatures, suffix: " °C", size: 24, color: "#a9efcf" },
+              },
+            ],
+            controls: [
+              { id: "inspect", kind: "slider", label: "Forecast hour", x: 60, y: 100, width: 518, height: 185, value: "hour", min: 0, max: 7, step: 1 },
+            ],
+          },
+        }
       }
       const s = state(args.instanceId ?? args.panelKey)
-      return { kind: 'svgScene', scene: {
-        version: 1, width: 640, height: 360,
-        values: { requested: s.requested, reported: s.reported, connected: s.connected, slow: s.slow },
-        layers: [
-          { id: 'face', x: 0, y: 0, width: 640, height: 360, svg: svg(`
+      return {
+        kind: "svgScene",
+        scene: {
+          version: 1,
+          width: 640,
+          height: 360,
+          values: { requested: s.requested, reported: s.reported, connected: s.connected, slow: s.slow },
+          layers: [
+            {
+              id: "face",
+              x: 0,
+              y: 0,
+              width: 640,
+              height: 360,
+              svg: svg(`
             <rect width="640" height="360" rx="18" fill="#142337"/>
-            ${label(28, 35, 'RADIO FRONT FACE / SIMULATED CAT', 18, '#e7edf4')}
+            ${label(28, 35, "RADIO FRONT FACE / SIMULATED CAT", 18, "#e7edf4")}
             <rect x="28" y="58" width="350" height="114" rx="12" fill="#0a1622"/>
-            ${label(42, 78, 'REPORTED VFO', 12)}${label(42, 143, 'REQUESTED', 12)}
+            ${label(42, 78, "REPORTED VFO", 12)}${label(42, 143, "REQUESTED", 12)}
             <path d="M417 150 A90 90 0 0 1 597 150" fill="none" stroke="#52657d" stroke-width="5"/>
-            ${label(423, 170, '14.0', 12)}${label(565, 170, '14.35', 12)}
-            ${label(424, 197, 'VFO POSITION', 12)}
+            ${label(423, 170, "14.0", 12)}${label(565, 170, "14.35", 12)}
+            ${label(424, 197, "VFO POSITION", 12)}
             <path d="M42 236 H332" stroke="#52657d" stroke-width="6"/>
-            ${label(42, 268, 'Band position / kHz', 14)}
-            ${label(548, 256, 'LINK', 12)}
-            ${button(28, 'Connect / disconnect')}${button(234, 'External tune +5 kHz')}${button(440, 'Toggle 2 s / 0 s delay')}
-          `) },
-          textLayer('reported', 'reported', 42, 78, 320, 34, '', ' kHz', 1),
-          textLayer('requested', 'requested', 168, 121, 210, 22, '', '', 1),
-          { id: 'needle', x: 503, y: 72, width: 8, height: 80, pivot: [0.5, 1], transitionMs: 450,
-            svg: svg('<path d="M4 0 L7 80 H1 Z" fill="#f6c673"/>', 8, 80),
-            rotation: bind('reported', [14000, 14350], [-80, 80]) },
-          { id: 'knob', x: 400, y: 204, width: 72, height: 72,
-            svg: svg('<circle cx="36" cy="36" r="34" fill="#31455d" stroke="#7187a0" stroke-width="2"/><path d="M36 8V22" stroke="#f6c673" stroke-width="4"/>', 72, 72),
-            rotation: bind('requested', [14000, 14350], [-150, 150]) },
-          { id: 'handle', x: 36, y: 224, width: 12, height: 24,
-            svg: svg('<rect width="12" height="24" rx="4" fill="#a9efcf"/>', 12, 24),
-            translateX: bind('requested', [14000, 14350], [0, 290]) },
-          { id: 'led', x: 548, y: 208, width: 40, height: 40,
-            svg: svg('<defs><radialGradient id="glow"><stop stop-color="#a9ffbd"/><stop offset="0.3" stop-color="#58e8a2"/><stop offset="1" stop-color="#58e8a2" stop-opacity="0"/></radialGradient></defs><circle cx="20" cy="20" r="20" fill="url(#glow)"/>', 40, 40),
-            opacity: bind('connected', [0, 1], [0.08, 1]), pulse: { periodMs: 1700, minOpacity: 0.55, flicker: true } },
-        ],
-        controls: [
-          { id: 'tune', label: 'Tuning knob, kHz', kind: 'knob', x: 398, y: 202, width: 76, height: 76,
-            value: 'requested', min: 14000, max: 14350, step: 0.1, sensitivity: 0.1, event: 'tune' },
-          { id: 'band', label: 'Band position, kHz', kind: 'slider', x: 42, y: 215, width: 290, height: 42,
-            value: 'requested', min: 14000, max: 14350, step: 0.1, event: 'tune' },
-          ...(['connect', 'external', 'delay'] as const).map((event, i) => ({
-            id: event, label: ['Toggle connection', 'Simulate external tuning', 'Toggle CAT delay'][i],
-            kind: 'button' as const, x: 28 + i * 206, y: 298, width: 172, height: 38, event,
-          })),
-        ],
-      } }
+            ${label(42, 268, "Band position / kHz", 14)}
+            ${label(548, 256, "LINK", 12)}
+            ${button(28, "Connect / disconnect")}${button(234, "External tune +5 kHz")}${button(440, "Toggle 2 s / 0 s delay")}
+          `),
+            },
+            textLayer("reported", "reported", 42, 78, 320, 34, "", " kHz", 1),
+            textLayer("requested", "requested", 168, 121, 210, 22, "", "", 1),
+            {
+              id: "needle",
+              x: 503,
+              y: 72,
+              width: 8,
+              height: 80,
+              pivot: [0.5, 1],
+              transitionMs: 450,
+              svg: svg('<path d="M4 0 L7 80 H1 Z" fill="#f6c673"/>', 8, 80),
+              rotation: bind("reported", [14000, 14350], [-80, 80]),
+            },
+            {
+              id: "knob",
+              x: 400,
+              y: 204,
+              width: 72,
+              height: 72,
+              svg: svg(
+                '<circle cx="36" cy="36" r="34" fill="#31455d" stroke="#7187a0" stroke-width="2"/><path d="M36 8V22" stroke="#f6c673" stroke-width="4"/>',
+                72,
+                72,
+              ),
+              rotation: bind("requested", [14000, 14350], [-150, 150]),
+            },
+            {
+              id: "handle",
+              x: 36,
+              y: 224,
+              width: 12,
+              height: 24,
+              svg: svg('<rect width="12" height="24" rx="4" fill="#a9efcf"/>', 12, 24),
+              translateX: bind("requested", [14000, 14350], [0, 290]),
+            },
+            {
+              id: "led",
+              x: 548,
+              y: 208,
+              width: 40,
+              height: 40,
+              svg: svg(
+                '<defs><radialGradient id="glow"><stop stop-color="#a9ffbd"/><stop offset="0.3" stop-color="#58e8a2"/><stop offset="1" stop-color="#58e8a2" stop-opacity="0"/></radialGradient></defs><circle cx="20" cy="20" r="20" fill="url(#glow)"/>',
+                40,
+                40,
+              ),
+              opacity: bind("connected", [0, 1], [0.08, 1]),
+              pulse: { periodMs: 1700, minOpacity: 0.55, flicker: true },
+            },
+          ],
+          controls: [
+            {
+              id: "tune",
+              label: "Tuning knob, kHz",
+              kind: "knob",
+              x: 398,
+              y: 202,
+              width: 76,
+              height: 76,
+              value: "requested",
+              min: 14000,
+              max: 14350,
+              step: 0.1,
+              sensitivity: 0.1,
+              event: "tune",
+            },
+            {
+              id: "band",
+              label: "Band position, kHz",
+              kind: "slider",
+              x: 42,
+              y: 215,
+              width: 290,
+              height: 42,
+              value: "requested",
+              min: 14000,
+              max: 14350,
+              step: 0.1,
+              event: "tune",
+            },
+            ...(["connect", "external", "delay"] as const).map((event, i) => ({
+              id: event,
+              label: ["Toggle connection", "Simulate external tuning", "Toggle CAT delay"][i],
+              kind: "button" as const,
+              x: 28 + i * 206,
+              y: 298,
+              width: 172,
+              height: 38,
+              event,
+            })),
+          ],
+        },
+      }
     },
     async onEvent(args) {
       const s = state(args.instanceId ?? args.panelKey)
       const event = args.event
-      if (event.action === 'connect') { s.connected = 1 - s.connected; s.due = 0; s.requested = s.reported }
-      if (event.action === 'delay') s.slow = 1 - s.slow
-      if (event.action === 'external') {
-        if (!s.connected) throw new Error('Radio disconnected')
+      if (event.action === "connect") {
+        s.connected = 1 - s.connected
+        s.due = 0
+        s.requested = s.reported
+      }
+      if (event.action === "delay") s.slow = 1 - s.slow
+      if (event.action === "external") {
+        if (!s.connected) throw new Error("Radio disconnected")
         s.reported = s.reported + 5 > 14350 ? 14000 : s.reported + 5
-        s.requested = s.reported; s.due = 0
+        s.requested = s.reported
+        s.due = 0
       }
-      if (event.action === 'tune') {
-        if (!s.connected) throw new Error('Radio disconnected')
-        if (typeof event.value !== 'number' || !Number.isFinite(event.value)) throw new Error('Invalid frequency')
+      if (event.action === "tune") {
+        if (!s.connected) throw new Error("Radio disconnected")
+        if (typeof event.value !== "number" || !Number.isFinite(event.value)) throw new Error("Invalid frequency")
         s.requested = Math.max(14000, Math.min(14350, event.value))
         s.due = now() + (s.slow ? 2000 : 0)
-        if (!s.slow) { s.reported = s.requested; s.due = 0 }
+        if (!s.slow) {
+          s.reported = s.requested
+          s.due = 0
+        }
       }
       return { values: { requested: s.requested, reported: s.reported, connected: s.connected, slow: s.slow } }
     },