@ham2k/extension-tools 0.10.0 → 0.12.0

package/h2kext-build.mjs

@@ -202,6 +202,49 @@ function liquidBrowserBuild(fromDir) {
   }
 }
 
+/// What liquidjs times its `renderLimit` with, and what it is rewritten to.
+///
+/// liquidjs looks for `global.performance`, then `window.performance`, and
+/// falls back to `Date.now()`. The sandbox has neither global, and its `Date`
+/// is the APP clock (sdk/src/appClock.ts), which time travel speeds up — so a
+/// render limit of 250 ms is measured in travelled time, and at 1000x a
+/// template taking a quarter of a real millisecond fails with `template render
+/// limit exceeded`. The sandbox's own `performance` stays on real time.
+const LIQUID_TIMER = "(typeof global === 'object' && global.performance)"
+const LIQUID_REAL_TIMER = "(typeof performance === 'object' && performance)"
+
+/// Points liquidjs's render timer at the real clock — see [LIQUID_TIMER].
+///
+/// A rewrite of that one expression in that one file, rather than a `define`
+/// for `global` across the whole bundle: a define would quietly retarget
+/// every other library's `typeof global` check too, which is how bundles
+/// tell Node from a browser. Throws when the expression is not found exactly
+/// once, so a liquidjs upgrade that changes it fails the build instead of
+/// bringing the travelled timer back unnoticed.
+///
+/// Matched on the file's name, not on the path this preset aliases: an exact
+/// path misses the same file spelled another way (a Windows drive letter's
+/// case) or a caller's own `alias.liquidjs`, and a filter that never fires
+/// never reaches the check either. Every unminified build carries the
+/// expression once; a minified one fails the check, loudly.
+function liquidRealClockPlugin() {
+  return {
+    name: "ham2k-liquid-real-clock",
+    setup(build) {
+      build.onLoad({ filter: /[\\/]liquidjs[\\/]dist[\\/]liquid\.[^\\/]+\.m?js$/ }, async (args) => {
+        const source = await readFile(args.path, "utf8")
+        const found = source.split(LIQUID_TIMER).length - 1
+        if (found !== 1) {
+          throw new BuildError(
+            `liquidjs at ${args.path}: expected its render timer \`${LIQUID_TIMER}\` once, found it ${found} times — the real-clock rewrite needs updating`,
+          )
+        }
+        return { contents: source.replace(LIQUID_TIMER, LIQUID_REAL_TIMER), loader: "js" }
+      })
+    },
+  }
+}
+
 /// Where the author's SDK keeps the file that stands in for the timer globals
 /// (sdk/src/timers.ts), or null if it has none. Resolved from the CALLER's
 /// directory for the same reason as [liquidBrowserBuild]: it must be the very
@@ -261,7 +304,11 @@ export function buildOptionsFor({ entry, outfile, manifest = {}, dir = process.c
       ...(liquid ? { liquidjs: liquid } : {}),
       ...alias,
     },
-    plugins: [sharedModulesPlugin({ sharedDependencies: manifest.sharedDependencies, api: manifest.api, inline }), ...(rest.plugins ?? [])],
+    plugins: [
+      sharedModulesPlugin({ sharedDependencies: manifest.sharedDependencies, api: manifest.api, inline }),
+      liquidRealClockPlugin(),
+      ...(rest.plugins ?? []),
+    ],
     inject: [...(timersFile ? [timersFile] : []), ...(rest.inject ?? [])],
   }
 }

package/h2kext.mjs

@@ -35,14 +35,24 @@ import yazl from "yazl"
 /// 6 adds the scene's `spectrum` control and `host.setRadioSpectrum`; 7 adds
 /// `host.setRadio` (`tuneRadio` stays its alias) with power, keyer speed,
 /// tuner, passband and antennas, the keying calls, what `readRadio` reports of
-/// them, and the scene's host-fed `radio` values.
-export const H2KEXT_API_VERSION = 7
+/// them, and the scene's host-fed `radio` values; 8 adds the Developer
+/// panel's `target: 'developer'` settings and leaves a settings panel with
+/// nothing to show out of the Settings list; 9 hands `ctx.getQsos`'s QSOs
+/// frozen, from the one copy of the log every extension shares, and adds the
+/// `chasing` hook category.
+export const H2KEXT_API_VERSION = 9
 
 /// The first API with `host.webSocket`. A manifest declaring `webSockets`
 /// under an older one is refused: an older app would install it and fail only
 /// when it tried to connect.
 export const WEB_SOCKETS_API_VERSION = 2
 
+/// The first API that calls `chasing` hooks. A manifest promising one under an
+/// older api is refused: an older app would install it and ignore the
+/// program, and for an extension that does nothing else, install a bundle
+/// that silently does nothing.
+export const CHASING_API_VERSION = 9
+
 /// The first API with timers. The build points a bundle's bare `setTimeout`
 /// and friends at the SDK's only from here on: an older app's kernel hands an
 /// extension no timers, and a bundle declaring less says it runs there.
@@ -144,6 +154,8 @@ SHARED_MODULES_BY_API[4] = SHARED_MODULES_BY_API[3]
 SHARED_MODULES_BY_API[5] = SHARED_MODULES_BY_API[4]
 SHARED_MODULES_BY_API[6] = SHARED_MODULES_BY_API[5]
 SHARED_MODULES_BY_API[7] = SHARED_MODULES_BY_API[6]
+SHARED_MODULES_BY_API[8] = SHARED_MODULES_BY_API[7]
+SHARED_MODULES_BY_API[9] = SHARED_MODULES_BY_API[8]
 
 /// What a scaffolded extension declares on day one: the eight modules the SDK
 /// barrel itself reaches, so a project that has written no code yet still
@@ -333,6 +345,10 @@ export function validateManifest(manifest, { source = MANIFEST_ENTRY, forceName
     }
   }
 
+  if (Array.isArray(manifest.hooks) && manifest.hooks.includes("chasing") && Number.isInteger(manifest.api) && manifest.api < CHASING_API_VERSION) {
+    say(`'chasing' needs 'api' ${CHASING_API_VERSION} or later — an app older than that would install this and never ask it what a contact claims`)
+  }
+
   // An extension with no category is CORE to the host: always enabled, and
   // never listed in the Extensions panel. That is a status the app grants its
   // own extensions, not one a distributed bundle may claim for itself — a user

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@ham2k/extension-tools",
-  "version": "0.10.0",
+  "version": "0.12.0",
   "description": "Build and package extensions for the Ham2K Logger",
   "keywords": [
     "ham2k",