From e6b07e81b739cd7f20459223028ddde88d36835e Mon Sep 17 00:00:00 2001 From: Ari Sulistiono Date: Fri, 13 Nov 2026 06:07:04 +0700 Subject: [PATCH 1/9] Integrate MUTE/SOLO/PFL in SOF only while preserving MAIN PRE/POST and native cue safety --- site/preview-v2/index.html | 27 ++++++++++++++++++++++++--- 1 file changed, 24 insertions(+), 3 deletions(-) diff --git a/site/preview-v2/index.html b/site/preview-v2/index.html index 4df87e2ae..a44442f5c 100644 --- a/site/preview-v2/index.html +++ b/site/preview-v2/index.html @@ -718,10 +718,18 @@ tapMode==='mixed'?'Mixed PRE and POST parallel WIRE sends · click to set all POST': (tapMode==='send'?'POST follows channel fader':'PRE independent before FX')+ ' · '+parallelSends.length+' outgoing parallel SEND(s), primary MAIN unchanged'; - code+='
' + // Shared v9 physical keys: MUTE/SOLO in both contexts, PFL only in SOF + // audio channels. PRE/POST remains the normal MAIN MIX routing control. + const sofPfl=sofEnabled&&t.kind==='audio'; + const hasTap=t.kind!=='master'&&!sofEnabled; + const isNative=!!window.__JUCE__?.backend; + const pflTitle=isNative?'PFL unavailable · independent native MONITOR L/R not admitted': + 'PFL · visual audition request only; no monitoring audio in browser preview'; + code+='
' +'' +''; - if(t.kind!=='master')code+=''; + if(hasTap)code+=''; + if(sofPfl)code+=''; code+='
'; code+=sectionFader(t); code+='
'+(sofEnabled&&t.kind==='audio'?'S ': '')+formatDb(sofEnabled&&t.kind==='audio'?getSofLevel(t):t.level)+'
'; @@ -830,6 +838,8 @@ function toggleSof(force){ sofEnabled=typeof force==='boolean'?force:!sofEnabled; if(sofEnabled&&!sofTarget){sofEnabled=false;say('Create a Bus or FX Return to use Sends on Faders');return;} + // Don't leave a hidden browser-only PFL request armed outside SOF. + if(!sofEnabled){tracks.forEach(channel=>{channel.cue=false;});master.cue=false;} const btn=document.getElementById('sofToggle');btn.classList.toggle('active',sofEnabled); btn.setAttribute('aria-pressed',String(sofEnabled));document.querySelector('.console-body').classList.toggle('sends-mode',sofEnabled); render();say(sofEnabled?'SENDS ON FADERS: adjusting '+sofTarget+' send levels · main faders protected':'MAIN MIX: faders control primary channel level'); @@ -2058,7 +2068,18 @@ else if(a==='fxOn'){if(deferNativeFxIntent('FX chain bypass'))return;t.fxOn=!t.fxOn;} else if(a==='pre'){t.pre=!t.pre;syncActiveSend(t);} else if(a==='sendOn'){say('Legacy SEND disabled; patch via WIRE');return;} - else if(['mute','solo','cue','mon','phase'].includes(a)){ + else if(a==='cue'){ + // Only a browser-reference cue selection; never route to MAIN/audio. + if(!sofEnabled||t.kind!=='audio'||window.__JUCE__?.backend){ + say('PFL requires SOF and an admitted independent native monitor'); + return; + } + t.cue=!t.cue; + refreshStrip(t); + say(t.name+' PFL '+(t.cue?'selected':'cleared')+' · visual reference only; no monitor audio'); + return; + } + else if(['mute','solo','mon','phase'].includes(a)){ t[a]=!t[a]; if(t.group&&(a==='mute'||a==='solo')){ tracks.filter(other=>other.group===t.group&&other.id!==t.id).forEach(other=>{other[a]=t[a];refreshStrip(other);}); From 9db8d4f2de322601293cda307bd0092d6475fbe3 Mon Sep 17 00:00:00 2001 From: Ari Sulistiono Date: Fri, 13 Nov 2026 06:07:36 +0700 Subject: [PATCH 2/9] Use exact approved blue PFL OFF/ON raster and v9 OFF shadow in SOF key row --- site/preview-buttons/assets/mixer-control-keys.css | 13 ++++++++++++- 1 file changed, 12 insertions(+), 1 deletion(-) diff --git a/site/preview-buttons/assets/mixer-control-keys.css b/site/preview-buttons/assets/mixer-control-keys.css index 6996d2e17..9a617cea1 100644 --- a/site/preview-buttons/assets/mixer-control-keys.css +++ b/site/preview-buttons/assets/mixer-control-keys.css @@ -16,7 +16,7 @@ border-bottom:1px solid #415463!important; box-shadow:inset 0 1px 0 #ffffff0a!important; } -.app .console-body .strip .mx-hw-row[data-tap-applicable="false"]{ +.app .console-body .strip .mx-hw-row[data-tap-applicable="false"]:not([data-pfl-applicable="true"]){ grid-template-columns:repeat(2,minmax(0,33%))!important; justify-content:center!important; } @@ -89,6 +89,16 @@ .app .console-body .strip .mx-hw-row>button.mx-hw-key[data-hw-kind="tap"][data-tap-visual="idle"]{--mx-native-x:33.333333%} .app .console-body .strip .mx-hw-row>button.mx-hw-key[data-hw-kind="tap"][data-tap-visual="post"]{--mx-native-x:66.666667%} .app .console-body .strip .mx-hw-row>button.mx-hw-key[data-hw-kind="tap"][data-tap-visual="mixed"]{--mx-native-x:100%} +/* Approved v9 PFL FontMatched source: physical 57x30 OFF + ON PNGs. + Two frames are a separate extension to the original MUTE/SOLO/tap atlas: + no repaint or reallocation of any previously approved control. */ +.app .console-body .strip .mx-hw-row>button.mx-hw-key[data-hw-kind="pfl"]::before{ + background-image:url("harmonice-thin-flat-v9-pfl-font-matched-57x30.png")!important; + background-size:200% 100%!important; + background-position:var(--mx-native-x,0%) 0%!important; +} +.app .console-body .strip .mx-hw-row>button.mx-hw-key[data-hw-kind="pfl"][aria-pressed="true"]{--mx-native-x:100%} +.app .console-body .strip .mx-hw-row>button.mx-hw-key[data-hw-kind="pfl"][aria-pressed="false"]{--mx-native-x:0%} /* Approved v9 HTML, physical 1x: --shadow-u:1px. Exactly the two OFF-only alpha drop-shadow layers from the signed-off Harmonice_Thin_Flat_Bezel_v9_Refined_OFF_Shadow_Interactive_AB.html. @@ -96,6 +106,7 @@ the clickable box or ON face. No artwork repaint or geometry change. */ .app .console-body .strip .mx-hw-row>button.mx-hw-key[data-hw-kind="mute"][aria-pressed="false"]::before, .app .console-body .strip .mx-hw-row>button.mx-hw-key[data-hw-kind="solo"][aria-pressed="false"]::before, +.app .console-body .strip .mx-hw-row>button.mx-hw-key[data-hw-kind="pfl"][aria-pressed="false"]::before, .app .console-body .strip .mx-hw-row>button.mx-hw-key[data-hw-kind="tap"][data-tap-visual="pre"]::before{ filter: drop-shadow(0 .8px 1.15px rgba(0,0,0,.42)) From 475e57bd0f4ff67a29452b282c72d25fc63d872c Mon Sep 17 00:00:00 2001 From: Ari Sulistiono Date: Fri, 13 Nov 2026 06:07:48 +0700 Subject: [PATCH 3/9] Ship the PFL FontMatched alpha PNG in the same Pages/native GUI assembler --- scripts/build_pages.py | 3 ++- 1 file changed, 2 insertions(+), 1 deletion(-) diff --git a/scripts/build_pages.py b/scripts/build_pages.py index 0a77aefec..0ec75a8ab 100644 --- a/scripts/build_pages.py +++ b/scripts/build_pages.py @@ -56,11 +56,12 @@ canonical_html=(canonical/'index.html').read_text(encoding='utf-8') special=('mixer-control-keys.css','mixer-control-keys.js') sprite='harmonice-thin-flat-v9-approved-off-shadow-57x30.png' +pfl_sprite='harmonice-thin-flat-v9-pfl-font-matched-57x30.png' for src in sorted((canonical/'assets').iterdir()): if not src.is_file(): raise SystemExit('Unexpected nested preview-v2 asset: '+str(src)) if src.name not in special: shutil.copy2(src,buttons_dest/'assets'/src.name) -for name in (*special,sprite): +for name in (*special,sprite,pfl_sprite): src=buttons_source/name if not src.is_file(): raise SystemExit('Approved PNG asset missing: '+str(src)) shutil.copy2(src,buttons_dest/'assets'/name) From 5366db23b7f37c0868573a8d95965ef5ca476778 Mon Sep 17 00:00:00 2001 From: Ari Sulistiono Date: Fri, 13 Nov 2026 06:10:40 +0700 Subject: [PATCH 4/9] =?UTF-8?q?Add=20exact=20approved=20PFL=20FontMatched?= =?UTF-8?q?=20OFF/ON=20transparent=20PNG=20sprite=20(2=C3=9757x30)?= MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit --- ...onice-thin-flat-v9-pfl-font-matched-57x30.png | Bin 0 -> 5692 bytes 1 file changed, 0 insertions(+), 0 deletions(-) create mode 100644 site/preview-buttons/assets/harmonice-thin-flat-v9-pfl-font-matched-57x30.png diff --git a/site/preview-buttons/assets/harmonice-thin-flat-v9-pfl-font-matched-57x30.png b/site/preview-buttons/assets/harmonice-thin-flat-v9-pfl-font-matched-57x30.png new file mode 100644 index 0000000000000000000000000000000000000000..1c3174d26f569c3b1e9ae900c14d3110f8da756c GIT binary patch literal 5692 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 Date: Fri, 13 Nov 2026 06:11:37 +0700 Subject: [PATCH 5/9] Account for approved PFL extension sprite in exact Pages/native asset inventory --- tests/pages_png_buttons_wire_reconciliation_smoke.py | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/tests/pages_png_buttons_wire_reconciliation_smoke.py b/tests/pages_png_buttons_wire_reconciliation_smoke.py index 4fd086c2e..b3532ce08 100644 --- a/tests/pages_png_buttons_wire_reconciliation_smoke.py +++ b/tests/pages_png_buttons_wire_reconciliation_smoke.py @@ -52,7 +52,7 @@ def verify_bundle(dist): # byte identity against this build's generated public root, not unrelated # developer-local files or an older locked GUI reference. favicons={"favicon.ico","favicon-16x16.png","favicon-32x32.png"} - expected=canonical|{SPRITE,"arsonmix-approved-runtime.css"}|favicons + expected=canonical|{SPRITE,"harmonice-thin-flat-v9-pfl-font-matched-57x30.png","arsonmix-approved-runtime.css"}|favicons assert published==expected,("asset set drift",published^expected) for name in favicons: assert (generated/"assets"/name).read_bytes()==(dist/name).read_bytes(),name From 16ea23654cc899c36d3c29f42a7cebd71bac5f1f Mon Sep 17 00:00:00 2001 From: Ari Sulistiono Date: Fri, 13 Nov 2026 06:12:14 +0700 Subject: [PATCH 6/9] Lock exact approved PFL raster hash and workspace/native safety in fast key contracts --- tests/harmonice_v7_keys_contract.py | 26 +++++++++++++++++++++++++- 1 file changed, 25 insertions(+), 1 deletion(-) diff --git a/tests/harmonice_v7_keys_contract.py b/tests/harmonice_v7_keys_contract.py index f3a71a972..be3059e20 100644 --- a/tests/harmonice_v7_keys_contract.py +++ b/tests/harmonice_v7_keys_contract.py @@ -1,6 +1,6 @@ """Harmonice v9 approved PNG button integration — fast source/asset guard. -Tests one owner, physical PNG, PFL hidden (not deleted), atomic reference tap +Tests one owner, physical PNG, PFL only in SOF (not main), atomic reference tap transactions and native fail-closed behavior. This is NOT hardware PCM proof. """ from pathlib import Path @@ -55,6 +55,30 @@ def test_reference_prepost_atomic_and_main_independent(self): self.assertIn("if(t.kind!=='master')code+='II", png[16:24]), (114, 30)) + self.assertEqual(png[25], 6, "PFL must retain the approved true RGBA transparency") + self.assertEqual(hashlib.sha256(png).hexdigest(), + "1ede18534fa678461ebcb1a100a61170700d75048b11607600cf09d9de8872fd", + "PFL-ON glyph and alpha must stay byte-for-byte user-approved") + self.assertIn("pfl_sprite='" + pfl + "'", BUILD) + self.assertIn("for name in (*special,sprite,pfl_sprite):", BUILD) + self.assertIn('background-image:url("' + pfl + '")', CSS) + self.assertIn("background-size:200% 100%", CSS) + self.assertIn('[data-hw-kind="pfl"][aria-pressed="true"]', CSS) + self.assertIn('[data-hw-kind="pfl"][aria-pressed="false"]::before', CSS) + self.assertIn("const sofPfl=sofEnabled&&t.kind==='audio'", HTML) + self.assertIn("const hasTap=t.kind!=='master'&&!sofEnabled", HTML) + self.assertIn('if(sofPfl)code+=', HTML) + self.assertIn('data-action="cue"', HTML) + self.assertIn("t.cue=!t.cue", HTML) + self.assertIn("if(!sofEnabled){tracks.forEach(channel=>{channel.cue=false;});master.cue=false;}", HTML) + self.assertIn("PFL requires a separate MONITOR L/R pair", BRIDGE) + self.assertIn("if(!sofEnabled||t.kind!=='audio'||window.__JUCE__?.backend)", HTML) + def test_native_pcm_never_fakes_prepost_state(self): self.assertIn('if(action==="tapMode"){', BRIDGE) self.assertIn('routing unchanged', BRIDGE) From 575a7af0ca305f56d8d7a32ca266e08119f79b82 Mon Sep 17 00:00:00 2001 From: Ari Sulistiono Date: Fri, 13 Nov 2026 06:12:42 +0700 Subject: [PATCH 7/9] Use explicit PNG signature bytes for approved PFL raster contract --- tests/harmonice_v7_keys_contract.py | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/tests/harmonice_v7_keys_contract.py b/tests/harmonice_v7_keys_contract.py index be3059e20..4de4ce4f9 100644 --- a/tests/harmonice_v7_keys_contract.py +++ b/tests/harmonice_v7_keys_contract.py @@ -58,7 +58,7 @@ def test_reference_prepost_atomic_and_main_independent(self): def test_approved_pfl_fontmatched_png_and_sof_scope(self): pfl = "harmonice-thin-flat-v9-pfl-font-matched-57x30.png" png = (OWNER / pfl).read_bytes() - self.assertEqual(png[:8], b"\\x89PNG\\r\\n\\x1a\\n") + self.assertEqual(png[:8], bytes.fromhex("89504e470d0a1a0a")) self.assertEqual(struct.unpack(">II", png[16:24]), (114, 30)) self.assertEqual(png[25], 6, "PFL must retain the approved true RGBA transparency") self.assertEqual(hashlib.sha256(png).hexdigest(), From 918c854ec8fb6531449587061b200fd660b53796 Mon Sep 17 00:00:00 2001 From: Ari Sulistiono Date: Fri, 13 Nov 2026 06:13:03 +0700 Subject: [PATCH 8/9] Chromium verifies blue PFL raster, state and SOF-only visibility in existing Stage D session --- ...pproved_css_stage_d_single_bundle_smoke.py | 37 +++++++++++++++++++ 1 file changed, 37 insertions(+) diff --git a/tests/approved_css_stage_d_single_bundle_smoke.py b/tests/approved_css_stage_d_single_bundle_smoke.py index fdf5daad2..00c7eacf2 100644 --- a/tests/approved_css_stage_d_single_bundle_smoke.py +++ b/tests/approved_css_stage_d_single_bundle_smoke.py @@ -104,6 +104,43 @@ async def main(): assert await key.get_attribute("aria-pressed") == "true" on_filter=await key.evaluate("(e)=>getComputedStyle(e,'::before').filter") assert on_filter=="none","MUTE ON must not inherit raised OFF shadow: "+on_filter + if size[0]==1680: + # Real SOF toolbar workflow; no private graph API or + # alternate renderer. Verify the exact user-approved PFL + # raster, OFF alpha shadow, ON image and workspace isolation. + await page.locator("#sofToggle").click() + row=page.locator("#tracks .strip[data-id='1'] .mx-hw-row") + assert await row.locator("button.mx-hw-key").count()==3 + assert await row.locator("[data-hw-kind='mute']").count()==1 + assert await row.locator("[data-hw-kind='solo']").count()==1 + assert await row.locator("[data-hw-kind='tap']").count()==0 + pfl=row.locator("[data-hw-kind='pfl']") + assert await pfl.count()==1 + assert await pfl.get_attribute("aria-pressed")=="false" + off_pfl=await pfl.evaluate("""el=>({ + image:getComputedStyle(el,'::before').backgroundImage, + position:getComputedStyle(el,'::before').backgroundPosition, + shadow:getComputedStyle(el,'::before').filter + })""") + assert "harmonice-thin-flat-v9-pfl-font-matched-57x30.png" in off_pfl["image"] + assert off_pfl["position"].startswith("0%"),off_pfl + assert "drop-shadow(" in off_pfl["shadow"],off_pfl + assert await page.locator("#master [data-hw-kind='pfl']").count()==0 + await pfl.click() + assert await pfl.get_attribute("aria-pressed")=="true" + on_pfl=await pfl.evaluate("""el=>({ + position:getComputedStyle(el,'::before').backgroundPosition, + shadow:getComputedStyle(el,'::before').filter + })""") + assert on_pfl["position"].startswith("100%"),on_pfl + assert on_pfl["shadow"]=="none",on_pfl + # Hidden PFL requests cannot survive leaving SOF. + await page.locator("#sofToggle").click() + assert await page.locator("#tracks [data-hw-kind='pfl']").count()==0 + assert await page.locator("#tracks .strip[data-id='1'] [data-hw-kind='tap']").count()==1 + await page.locator("#sofToggle").click() + assert await page.locator("#tracks .strip[data-id='1'] [data-hw-kind='pfl']").get_attribute("aria-pressed")=="false" + await page.locator("#sofToggle").click() assert len(css_requests) == 1, (size,css_requests) await page.close() print("PASS Stage D one stylesheet / 17 requests eliminated:", From 3ff8a6eabcde26a2191487e0f5e8084aa5de027f Mon Sep 17 00:00:00 2001 From: Ari Sulistiono Date: Fri, 13 Nov 2026 06:13:42 +0700 Subject: [PATCH 9/9] Document approved physical key ownership, SOF PFL safety and PR #604 forward-port contract --- docs/HARMONICE_PHYSICAL_KEYS_SOF_CONTRACT.md | 64 ++++++++++++++++++++ 1 file changed, 64 insertions(+) create mode 100644 docs/HARMONICE_PHYSICAL_KEYS_SOF_CONTRACT.md diff --git a/docs/HARMONICE_PHYSICAL_KEYS_SOF_CONTRACT.md b/docs/HARMONICE_PHYSICAL_KEYS_SOF_CONTRACT.md new file mode 100644 index 000000000..efc83f06a --- /dev/null +++ b/docs/HARMONICE_PHYSICAL_KEYS_SOF_CONTRACT.md @@ -0,0 +1,64 @@ +# Harmonice v9 physical MUTE / SOLO / PFL — SOF integration contract + +## Artwork provenance and nonnegotiable look + +Use the user's approved **Harmonice_Thin_Flat_Bezel_v9_PFL_FontMatched_Assets.zip**. +The blue PFL PNG master has the same thin flat bezel, cap geometry, typography +and ON text debossing as the v9 MUTE/SOLO faces. Do not recreate it in CSS/SVG. + +- Existing production 4×3, 57×30-per-cell MUTE/SOLO/PRE/POST atlas remains + **exactly unchanged**: + `site/preview-buttons/assets/harmonice-thin-flat-v9-approved-off-shadow-57x30.png`. +- New approved **PFL OFF / PFL ON** raster is a separate 2×1 114×30 RGBA atlas: + `site/preview-buttons/assets/harmonice-thin-flat-v9-pfl-font-matched-57x30.png`. +- PFL sprite SHA256: `1ede18534fa678461ebcb1a100a61170700d75048b11607600cf09d9de8872fd`. +- Display through the same `mixer-control-keys.css` and existing + `strip(t)` renderer; the artwork remains PNG, never a CSS imitation. +- PFL OFF inherits the two approved v9 lower-alpha drop shadows; PFL ON does + **not** inherit OFF shadow. Neither frame alters button hitbox/strip height. + +## One workspace decides the third physical key + +| Context | Source audio strip | BUS/FX strip | MASTER | +| --- | --- | --- | --- | +| MAIN MIX | MUTE, SOLO, PRE/POST | MUTE, SOLO, PRE/POST | MUTE, SOLO | +| SOF | **MUTE, SOLO, PFL** | MUTE, SOLO | MUTE, SOLO | + +PFL is **not** a replacement for PRE/POST routing. In SOF, the selected +send's PRE/POST belongs in the contextual **FX/send processing panel** (PR +#604); its hardware key row uses PFL. The PFL key does not change the +SOF target's send tap/gain or the channel's PRIMARY MAIN edge. + +## Monitoring and state contract + +- Browser reference: PFL uses the existing per-channel `cue` state, purely + as visual feedback. The browser generates no real monitored audio and + **must not feed cue into MAIN**. PFL is initially OFF. +- Leaving SOF clears browser-only PFL requests; there must be no invisible + armed cue. Normal MUTE/SOLO survive workspace changes. +- Native: PFL is disabled / visibly OFF until a separate pre-fader MONITOR + L/R bus has a real native route and ACK/readback. The existing native + bridge `consumeAction('cue')` fails closed; the button must never simulate + monitor audio or claim native availability. +- Native SOF itself remains unavailable until native send gain/tap support is + admitted. This PR does **not** implement an audio PCM audition bus. + +## Concurrent work: draft PR #604 + +**Do not overwrite or independently merge #604's experimental SOF branch.** +The SOF author must forward-port the third-key decision from `strip(t)`: +`sofPfl = sofEnabled && t.kind==='audio'`, `hasTap = t.kind!=='master' && +!sofEnabled`. When SOF is active, preserve PFL in the MUTE/SOLO key row +and keep per-EdgeId PRE/POST in the contextual SOF panel. Preserve the one +existing key CSS owner, both approved raster sprites and native fail-closed +behavior. Do not restore PFL into MAIN MIX or the hidden Clear PFL toolbar. + +## Regression evidence + +- Fast `tests/harmonice_v7_keys_contract.py` checks SHA, dimensions, the + existing MUTE/SOLO sprite, renderer contracts and native guard. +- Existing Chromium Stage D checks both contexts, PFL OFF→ON without layout + changes, actual sprite URL/frame/shadow, no MASTER PFL, and reset on exiting + SOF. It does not assert any native PCM audio. +- Publish only the single `/preview/` GUI; `/preview-prod/` is a frozen + pre-v7 comparison and must remain unchanged.