@ham2k/extension-tools 1.16.1 → 1.18.0

package/h2kext-dev.mjs

@@ -104,6 +104,9 @@ export function parseArgs(argv) {
       case "--dir":
         options.dir = resolve(value())
         break
+      case "--force-name":
+        options.forceName = true
+        break
       case "--help":
       case "-h":
         options.help = true
@@ -115,7 +118,7 @@ export function parseArgs(argv) {
   return options
 }
 
-export const USAGE = `usage: h2kext-dev [--port <n>] [--host <address>] [--entry <file>] [--inline <pkg,…>] [--dir <path>]
+export const USAGE = `usage: h2kext-dev [--port <n>] [--host <address>] [--entry <file>] [--inline <pkg,…>] [--dir <path>] [--force-name]
 
 Serves the extension in the current directory to the app's Extension Dev
 Server (Settings → Developer), rebuilding it as you save and printing what it
@@ -125,7 +128,8 @@ logs. Point the app at one of the addresses it prints.
   --host    the address to bind (default 0.0.0.0, so a phone on the LAN can connect)
   --entry   the entry point (default src/index.ts); pass what build.mjs passes
   --inline  shared libraries to bundle rather than take from the app; pass what build.mjs passes
-  --dir     the extension directory (default the current directory)`
+  --dir     the extension directory (default the current directory)
+  --force-name  Ham2K's own extensions: waives the key convention, as h2kext-pack's does`
 
 /// The author's own esbuild, resolved from their project rather than from
 /// wherever this file is installed: the preset is written to use the caller's
@@ -164,6 +168,7 @@ export async function createDevServer({
   port = DEFAULT_PORT,
   entry = "src/index.ts",
   inline = [],
+  forceName = false,
   log = console.log,
   warn = console.error,
 }) {
@@ -203,6 +208,11 @@ export async function createDevServer({
   let watching = false
 
   function fail(message) {
+    // The same failure again is not news, as an unchanged good build is not:
+    // a rebuild with nothing new to say — a late file event, a save that
+    // changed nothing — would otherwise repeat the error to the app, ahead
+    // of the reload the next real change brings.
+    if (buildError === message) return
     buildError = message
     if (watching) {
       warn(`${stamp()}  ✗ ${key}\n${message}`)
@@ -227,7 +237,7 @@ export async function createDevServer({
     // text compared for "unchanged" is the folded one: an edit to ABOUT.md
     // alone is a reload too.
     parsed = await withAboutFiles(parsed, dir)
-    const problems = validateManifest(parsed)
+    const problems = validateManifest(parsed, { forceName })
     if (problems.length) throw new Error(problems.join("\n"))
     if (parsed.key !== key) throw new Error(`${MANIFEST_ENTRY}: 'key' changed from ${key} to ${parsed.key}; restart h2kext-dev to serve it`)
     return { parsed, text: JSON.stringify(parsed) }

package/h2kext.mjs

@@ -57,8 +57,13 @@ import yazl from "yazl"
 /// trigger; 14 adds `host.fyi`, messages on the FYI line under the call
 /// info; 15 adds `incomplete` on a live scoring verdict, the fields a
 /// contact still needs before Enter logs it; 16 names the kernel `__halo`,
-/// and keeps `__polo` only for a bundle that declares a lower level.
-export const H2KEXT_API_VERSION = 16
+/// and keeps `__polo` only for a bundle that declares a lower level; 17
+/// makes a spectrum's gestures the host's — tuning, zoom, pan and an axis —
+/// unless its scene's `gestures` and `scale` say otherwise; 18 adds the
+/// logging row's segmented fields (`group`), `autoadvanceWhen`/`Before`, a
+/// field's `suffix` and `ourExchange`, display-only (`editable: false`) and
+/// optional (`chars.min: 0`) fields.
+export const H2KEXT_API_VERSION = 18
 
 /// 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
@@ -230,6 +235,8 @@ SHARED_MODULES_BY_API[13] = SHARED_MODULES_BY_API[12]
 SHARED_MODULES_BY_API[14] = SHARED_MODULES_BY_API[13]
 SHARED_MODULES_BY_API[15] = SHARED_MODULES_BY_API[14]
 SHARED_MODULES_BY_API[16] = SHARED_MODULES_BY_API[15]
+SHARED_MODULES_BY_API[17] = SHARED_MODULES_BY_API[16]
+SHARED_MODULES_BY_API[18] = SHARED_MODULES_BY_API[17]
 
 /// 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

package/package.json

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