@ham2k/extension-sdk 0.5.4 → 0.5.5

package/dist/index.d.ts

@@ -1,4 +1,4 @@
-// @ham2k/extension-sdk 0.5.4
+// @ham2k/extension-sdk 0.5.5
 /** Experimental v1 scene contract. All coordinates are in the scene's viewBox. */
 export interface SvgScene {
 	version: 1;
@@ -236,6 +236,7 @@ export interface HookContext {
 export interface HistoryForCallOptions {
 	refType?: string | string[];
 	refPrefix?: string | string[];
+	refsSegmentAware?: boolean;
 	operation?: string | string[];
 	excludeOperation?: string | string[];
 	fromDate?: string;
@@ -707,6 +708,10 @@ export interface CommandAction {
 		wpm: number;
 	};
 	showKeyer?: Record<string, never>;
+	setEnterSends?: {
+		on?: boolean;
+		running?: boolean;
+	};
 	updateQso?: Record<string, JSONValue>;
 	addQso?: Record<string, JSONValue>;
 	sendSpots?: {

package/docs/hooks.md

@@ -64,10 +64,14 @@ hook method receives `(args, ctx)` where `ctx: HookContext` is:
   `options` (`HistoryForCallOptions` in `types.ts`) narrow the history
   before it is ordered and limited, so `{ refType: 'cwt' }` finds last
   month's CWT exchange behind a week of POTA contacts. The filters are
-  `refType` (a ref in the QSO's own `refs`), `refPrefix` (a ref whose `ref`
-  starts with it, ignoring ASCII case; with `refType`, the same ref must pass
-  both, so `{ refType: 'potaActivation', refPrefix: 'FR-' }` finds French
-  parks), `operation`/`excludeOperation`,
+  `refType` (a ref in the QSO's own `refs` or its operation's, since an
+  activation's ref lives on the operation), `refPrefix` (such a ref whose
+  `ref` starts with it, ignoring ASCII case; with `refType`, the same ref
+  must pass both, so `{ refType: 'potaActivation', refPrefix: 'FR-' }` finds
+  every contact made activating a French park; an operation's refs are its
+  base ones unless `refsSegmentAware: true`, which reads them as they stood
+  at each contact, so a rove's second park or a contest that ended at a
+  break is seen), `operation`/`excludeOperation`,
   `band`/`excludeBand`, `mode`/`excludeMode` (`SSB` also matches its
   sidebands, and `CW`/`PHONE`/`DATA` match their whole family), whole UTC
   days through `fromDate`/`toDate` or `fromDateMillis`/`toDateMillis`, and
@@ -847,7 +851,7 @@ interface CommandHook {
 // CommandInterpretation: {expectsParams?, mixedCase?, error?, describe?, confirm?, commands?: CommandAction[]}
 // CommandCatalogEntry: {command, describe, params?, category?, needsOperation?, expectsParams?, suggest?}
 // CommandAction (closed set): {setVfo?, setPower?, updateQso?, addQso?,
-//   setKeyerSpeed?, showKeyer?, sendSpots?, syncAll?, updateSettings?, updateSetting?, openSettings?,
+//   setKeyerSpeed?, showKeyer?, setEnterSends?, sendSpots?, syncAll?, updateSettings?, updateSetting?, openSettings?,
 //   updateOperation?, markSegment?, setCallField?, reloadDataFiles?, devNotice?, devStatus?,
 //   devProgress?, devHammer?, devSplash?, devOnboard?, devTester?, devPopup?,
 //   devTimeTravel?, toggleExperiment?}

package/package.json

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