Add channel-nine-only notification builder preset

docs/_javascript/notification_builder.js

@@ -5,7 +5,8 @@
   const EXAMPLES = {
     find: { label: "Find my node", kind: "all", id: "", when: "disconnected", vibration: "200,200,200", led: "100,100,100,700", sound: "find:d=8,o=6,b=180:c,e,g,p", screen: "on", gpio: "off", repeat: "forever", gap: "1000", stop: "connected" },
     food: { label: "Your food truck order is ready", kind: "channel", id: "3", when: "any", vibration: "50,300,40,20,500", led: "100,100,100,500", sound: "order:d=8,o=5,b=180:c,e,g,4c6", screen: "on", gpio: "off", repeat: "forever", gap: "2000", stop: "button" },
-    vip: { label: "VIP chat", kind: "contact", id: "", when: "disconnected", vibration: "100,100,300", led: "50,300,40,20,500", sound: "vip:d=8,o=5,b=180:c,e,g,4g", screen: "on", gpio: "off", repeat: "2", gap: "500", stop: "button" }
+    vip: { label: "VIP chat", kind: "contact", id: "", when: "disconnected", vibration: "100,100,300", led: "50,300,40,20,500", sound: "vip:d=8,o=5,b=180:c,e,g,4g", screen: "on", gpio: "off", repeat: "2", gap: "500", stop: "button" },
+    channel9: { label: "Only channel 9", kind: "channel", id: "9", when: "any", vibration: "off", led: "off", sound: "ch9:d=8,o=5,b=180:c,e,g", screen: "off", gpio: "off", repeat: "1", gap: "500", stop: "button", quietOthers: "on" }
   };
   function pulse(text) {
     if (text === "off" || text === "inherit") return [];
@@ -91,6 +92,14 @@
     if (config.repeat !== "forever" && (!/^\d+$/.test(config.repeat) || Number(config.repeat) < 1 || Number(config.repeat) > 65535)) throw new Error("Repeat must be 1-65535 or forever.");
     if (!/^\d+$/.test(config.gap) || Number(config.gap) < 1 || Number(config.gap) > 60000) throw new Error("Repeat gap must be 1-60000 ms.");
     if (!["button", "connected", "never"].includes(config.stop)) throw new Error("Unknown stop condition.");
+    if (config.quietOthers === "on") {
+      if (config.kind !== "channel") throw new Error("Silencing other message alerts needs a channel exception.");
+      // This is a shared RULE, not master off: the selected channel can still
+      // override it. Copy and USB Save must apply the same two-rule recipe.
+      result.push("set notify.enabled on");
+      for (const name of Object.keys(OUTPUTS)) result.push("set notify." + name + " all off");
+      result.push("set notify.repeat all 1", "set notify.gap all 500", "set notify.stop all button");
+    }
     for (const name of Object.keys(OUTPUTS)) {
       if (!["off", "inherit"].includes(config[name])) result.push("set notify." + name + " on");
       result.push("set notify." + name + " " + target + " " + config[name]);
@@ -104,6 +113,7 @@
     return result;
   }
   function notificationText(config) {
+    if (config.quietOthers === "on") throw new Error("Use CLI commands or USB Save for the silent default and channel exception; a notification DM cannot configure these rules.");
     const parts = [];
     for (const name of ["vibration", "sound", "led", "screen"]) if (config[name] !== "inherit") parts.push(name + "=" + config[name]);
     for (const name of ["repeat", "gap"]) parts.push(name + "=" + config[name]);
@@ -185,6 +195,10 @@
     let client = null, supported = null, previewTimer = null, previewUrl = null, previewVersion = 0;
     const config = () => Object.fromEntries(new FormData(form));
     function render() {
+      const quiet = form.elements.quietOthers;
+      quiet.disabled = form.elements.kind.value !== "channel";
+      if (quiet.disabled) quiet.checked = false;
+      find("quiet-warning").hidden = !quiet.checked;
       try {
         output.textContent = commands(config()).join("\n"); error.textContent = "";
         try { find("dm").textContent = notificationText(config()); }
@@ -193,8 +207,11 @@
       catch (e) { output.textContent = ""; find("dm").textContent = ""; error.textContent = e.message; }
     }
     function preset(name) {
-      const values = { remote: "inherit", ...EXAMPLES[name] };
-      for (const [key, value] of Object.entries(values)) if (form.elements[key]) form.elements[key].value = value;
+      const values = { remote: "inherit", quietOthers: "off", ...EXAMPLES[name] };
+      for (const [key, value] of Object.entries(values)) if (form.elements[key]) {
+        if (key === "quietOthers") form.elements[key].checked = value === "on";
+        else form.elements[key].value = value;
+      }
       render();
     }
     function stopPreview(status = "Stopped") {
@@ -296,6 +313,9 @@
           const c = config(), list = commands(c);
           if (!client || supported === null) throw new Error("Connect updated Companion firmware first.");
           for (const name of Object.keys(OUTPUTS)) if (!["off", "inherit"].includes(c[name]) && !(supported & OUTPUTS[name])) throw new Error(name + " is unavailable on this device. Choose off or inherit.");
+          // Resolve/check numeric channel slots before changing the shared
+          // default: a missing exception channel must not leave all alerts mute.
+          if (c.quietOthers === "on") await run("get notify.sound " + selector(c));
           for (const text of list) await run(text);
           if (action === "apply-test") await run("notify.test " + selector(c));
         }

docs/_stylesheets/notification_builder.css

@@ -7,6 +7,8 @@
 .notification-builder small { font-size: .7rem; font-weight: 400; color: var(--md-default-fg-color--light); }
 .notification-builder input, .notification-builder select { width: 100%; min-width: 0; border: 1px solid var(--md-default-fg-color--lighter); border-radius: 6px; padding: .6rem; background: var(--md-default-bg-color); color: var(--md-default-fg-color); font: inherit; font-weight: 400; }
 .notification-builder input:focus, .notification-builder select:focus { outline: 2px solid var(--md-primary-fg-color); outline-offset: 2px; }
+.notification-builder .notification-checkbox { flex-direction: row; align-items: center; margin-top: 1rem; }
+.notification-builder .notification-checkbox input { width: auto; flex: 0 0 auto; padding: 0; }
 .notification-builder button { border: 1px solid var(--md-primary-fg-color); border-radius: 6px; padding: .5rem .75rem; margin: .2rem; cursor: pointer; color: var(--md-primary-fg-color); font: inherit; }
 .notification-builder button:hover { background: var(--md-primary-fg-color); color: var(--md-primary-bg-color); }
 .notification-builder button:disabled { opacity: .5; cursor: wait; }

docs/notifications.md

@@ -13,6 +13,7 @@ stop policy. USB testing uses Binary Companion mode at 115200 baud.
     <button type="button" data-example="find">Find my node</button>
     <button type="button" data-example="food">Food order ready</button>
     <button type="button" data-example="vip">VIP chat</button>
+    <button type="button" data-example="channel9">Only channel 9</button>
   </div>
   <form data-role="form" onsubmit="return false">
     <section class="notification-card">
@@ -22,6 +23,12 @@ stop policy. USB testing uses Binary Companion mode at 115200 baud.
         <label>Contact/room key or channel slot<input name="id" autocomplete="off" placeholder="Full contact/room public key, or channel slot such as 3"></label>
         <label>Companion client status<select name="when"><option value="any">Connected or disconnected</option><option value="connected">Connected</option><option value="disconnected">Disconnected</option></select></label>
       </div>
+      <label class="notification-checkbox"><input type="checkbox" name="quietOthers" value="on">Silence other message alerts (channel exception)</label>
+      <p data-role="quiet-warning" hidden>This saves a silent default plus the selected channel's rule.
+      It also silences ordinary DMs and room-message alerts. Existing specific/state rules
+      and authorized <code>!notify</code> strings can still alert; review the
+      <a href="#only-channel-9-alerts-all-other-channels-silent">channel 9 example and caveats</a>.
+      Copy commands and USB Save include both rules; preview only plays the exception.</p>
       <p>Connected means an active phone/app, USB, WiFi, Ethernet or serial
       companion client. It selects a message rule; connecting or disconnecting
       alone does not create an alert. Contact matching uses the full public key.
@@ -106,7 +113,9 @@ stop policy. USB testing uses Binary Companion mode at 115200 baud.
     <p>Save writes the generated commands in order and stops at the first device
     error; earlier successful settings remain saved. A test with a connection
     suffix selects that profile even over USB. Stop-on-connect still watches
-    real subsequent connections. USB testing requires Chrome or Edge.</p>
+    real subsequent connections. The silence-other-alerts option saves both
+    the silent default and the selected channel rule. Deleting the selected
+    rule does not delete that default. USB testing requires Chrome or Edge.</p>
     <pre data-role="device-log" class="notification-log" aria-live="polite"></pre>
   </section>
 </div>
@@ -247,6 +256,10 @@ This example makes message alerts silent by default, then plays one short
 melody for channel 9. It works both with and without a connected companion
 client and requires a device with a buzzer. Messages still arrive normally;
 this changes the node's alerts, not the phone app's notification settings.
+Use the **Only channel 9** button above to load this setup into the builder.
+You can change the channel slot or alert pattern before copying or saving.
+Uncheck **Silence other message alerts** to generate only the selected rule;
+this does not remove a silent default already saved on the node.
 
 `channel:9` means the firmware's **zero-based slot 9** (the tenth slot), not
 a channel named `ch9`. Configure that slot before running these commands.