diff --git a/.github/workflows/reference-wire-qa.yml b/.github/workflows/reference-wire-qa.yml new file mode 100644 index 000000000..bc92d6e61 --- /dev/null +++ b/.github/workflows/reference-wire-qa.yml @@ -0,0 +1,87 @@ +name: PR278 Wire reference - focused smoke and Chromium + +on: + pull_request: + paths: + - 'design-references/audition-mixer-study/index.html' + - 'design-references/audition-mixer-study/smoke.test.cjs' + - 'design-references/audition-mixer-study/visual_wire_v15_qa.py' + - 'design-references/audition-mixer-study/visual_wire_v18_qa.py' + - 'design-references/audition-mixer-study/visual_wire_v19_collapse_qa.py' + - 'design-references/audition-mixer-study/visual_wire_v22_smart_snap_qa.py' + - 'design-references/audition-mixer-study/visual_wire_v26_focus_qa.py' + - 'design-references/audition-mixer-study/visual_buttons_v29_3d_qa.py' + - 'design-references/audition-mixer-study/visual_wire_v30_views_qa.py' + - 'design-references/audition-mixer-study/visual_wire_v31_gravity_qa.py' + - 'design-references/audition-mixer-study/visual_wire_v32_cross_bank_qa.py' + - 'design-references/audition-mixer-study/visual_wire_v34_intent_qa.py' + - '.github/workflows/reference-wire-qa.yml' + workflow_dispatch: + +permissions: + contents: read + +concurrency: + group: arsonmix-ref-wire-${{ github.event.pull_request.number || github.ref }} + cancel-in-progress: true + +jobs: + wire-reference: + if: github.event_name != 'pull_request' || github.event.pull_request.number == 278 + name: Reference-only state + Chromium pointer QA + runs-on: ubuntu-latest + timeout-minutes: 12 + steps: + - uses: actions/checkout@v4 + - name: Model and workflow contract (zero install) + run: node design-references/audition-mixer-study/smoke.test.cjs + - uses: actions/setup-python@v5 + with: + python-version: '3.12' + - name: Install Chromium only after model passes + run: | + python -m pip install --quiet playwright + python -m playwright install --with-deps chromium + - name: Physical OUT-IN drag, snap, no-reflow and Bus-only browser QA + run: python design-references/audition-mixer-study/visual_wire_v15_qa.py + - name: Verify connected-IN replug, snap-back and release on three viewports + run: python design-references/audition-mixer-study/visual_wire_v18_qa.py + - name: Compact WIRE rail and live signal summary QA + run: python design-references/audition-mixer-study/visual_wire_v19_collapse_qa.py + - name: V22 smart magnet and faithful SVG rail icons across three viewports + run: python design-references/audition-mixer-study/visual_wire_v22_smart_snap_qa.py + - name: V26 Focus Signal Flow incoming-back outgoing-front and badge QA + run: python design-references/audition-mixer-study/visual_wire_v26_focus_qa.py + - name: V29 user's raised and recessed 3D hardware keycap style + run: python design-references/audition-mixer-study/visual_buttons_v29_3d_qa.py + - name: V30 Focus, OUT only and All routing views across three viewports + run: python design-references/audition-mixer-study/visual_wire_v30_views_qa.py + - name: V31 gravitational cable drape from top mounted OUT/IN nodes + run: python design-references/audition-mixer-study/visual_wire_v31_gravity_qa.py + - name: V32 isolated soft settling + any-bank contextual patch + run: python design-references/audition-mixer-study/visual_wire_v32_cross_bank_qa.py + - name: V34 operator intent, SEND gain precision and pointer cancel across four viewports + run: python design-references/audition-mixer-study/visual_wire_v34_intent_qa.py + - name: Upload V32 operator cross-bank screenshot + if: success() + uses: actions/upload-artifact@v4 + with: + name: ref-wire-v32-cross-bank-visual + path: design-references/audition-mixer-study/preview-v32-cross-bank-1680.png + if-no-files-found: ignore + retention-days: 2 + - name: Upload focused screenshots only when a check fails + if: failure() + uses: actions/upload-artifact@v4 + with: + name: ref-wire-chromium-failure + path: | + preview-v15-wire-*.png + preview-v17-wire-*.png + preview-v18-replug-*.png + preview-v19-collapsed-*.png + preview-v22-smart-snap-*.png + preview-v26-focus-*.png + preview-v29-buttons-3d-*.png + if-no-files-found: ignore + retention-days: 2 diff --git a/design-references/audition-mixer-study/V10_SOURCE_FIRST_MULT_UX_STUDY_20261102.md b/design-references/audition-mixer-study/V10_SOURCE_FIRST_MULT_UX_STUDY_20261102.md new file mode 100644 index 000000000..4b28b80ea --- /dev/null +++ b/design-references/audition-mixer-study/V10_SOURCE_FIRST_MULT_UX_STUDY_20261102.md @@ -0,0 +1,60 @@ +# ArSonMix — Source-first 1→N Channel Mult UX (decision record) + +Date: 2026-11-02 | Isolated PR #278 | Source: CH1 → destinations CH3–CH6 | Status: **UX DESIGN DECISION, NOT NATIVE IMPLEMENTATION** + +## Problem and scope + +One physical/live audio source is required to feed four **independently processed** full mixer channels, not four source channels summed into one group, not four linked faders, and not sidechain-only. For the operator: CH1 → CH3, CH4, CH5, CH6 (each has its own insert rack, pan, M/S/PFL, fader, meter, and OUT). Input is captured once. Do not silently produce a fifth audible dry path to Master. + +## Official competing app workflows (verified 2026-11-02) + +| Product | Actual source → multi-destination operation | UX advantage | Limitation for this exact task | +| --- | --- | --- | --- | +| **Image-Line FL Studio** | Select source mixer insert, click send/routing switch below each destination insert; set each send amount. Also select several target tracks and use **Track routing → Route this track to selected** or **…selected only**. The latter disables current direct Master send. | Source-first, visual destination selection directly on console, bulk destination selection, no required intermediate bus | Compact arrow/switches can be cryptic to beginners; must show direction and avoid confusing sidechain and audible send | +| **PreSonus Studio One → Fender Studio Pro** | Channel **Add Send** targets existing Bus/FX Channel; drop effect onto Send rack to create an FX Channel instantly. Each Send has level, pan and pre/post-fader; **send source remains post-inserts**. Multiple Bus sends are explicitly described as **multing**. | Excellent fast FX creation, per-send state | Bus/FX destination role and per-send creation are more work than a single bulk route to four ordinary independently processed channels | +| **Adobe Audition** | Open Sends panel, enable a send, choose destination Bus, set pre/post-fader, level/pan. Up to **16 sends/channel** independent of primary OUT. | Explicit structured signal path, visible per-send controls | For 4 receiver channels needs destination Bus tracks and several repeated slot configurations | + +Primary sources: +- FL Studio Mixer Menu, direct multi-target: https://www.image-line.com/fl-studio-learning/fl-studio-online-manual/html/mixer_mixermenu.htm +- FL Studio Mixer, clickable destination switches: https://www.image-line.com/fl-studio-learning/fl-studio-online-manual/html/mixer.htm +- FL Studio I/O routing, existing Master path behavior: https://www.image-line.com/fl-studio-learning/fl-studio-online-manual/html/mixer_iorouting.htm +- Fender Studio Pro Effects Signal Routing and Sends: https://fenderstudiopromanual.fender.com/en/Content/Mixing_Topics/Effects_Signal_Routing.htm +- Adobe Audition routing and 16 sends: https://helpx.adobe.com/audition/desktop/mixing-multitrack-sessions/multitrack-routing-eq-controls.html + +**Interpretation, not usability study**: the best conceptual fit is FL Studio's **source-first direct mult**, while Adobe's clear state/levels and Fender Studio Pro's efficient FX creation should be borrowed. Avoid claiming an independently measured usability ranking. + +## Approved proposal: ArSonMix MULT / SPLIT source-first, in the same Live Console + +1. **Select source CH1** (no pop-up needed). Its IN and existing dry OUT remain visible. +2. Click a compact **MULT ⇢** command in its ROUTE section. This arms a clearly indicated routing-selection mode; do not hide the FX rack, navigate to a new screen, or replace the main mixer with a DAW patch editor. +3. **Click CH3, CH4, CH5, CH6**, directly on their nameplates/target indicators; **Shift-click** a consecutive range to select CH3–CH6 together. Existing channel group selection and F2/double-click identity have no behavioral changes outside this mode. +4. The same nonmodal small anchored menu summarizes **CH1 → [CH3] [CH4] [CH5] [CH6] (4)**. Choose **Add parallel** (preserves CH1 direct OUT) or **Only selected** (explicitly removes CH1 direct MAIN, retaining source capture); no implicit duplicate audible MAIN contribution. +5. Optional advanced settings show **PRE INSERT** vs **POST INSERT** source tap independently of **PRE/POST FADER** and any destination send amount; do not label a pre-fader send as 'pre-FX'. Default source tap **PRE INSERT** for clean independently processed receiver lanes, when native graph supports it. +6. Click **Apply**. Each receiver's IN is explicitly labeled **CH1 · PRE INSERT [MULT]** (or the chosen tap), source shows **⇢4**, with a one-click **View receivers** action. All receivers remain full independent channel strips with their own FX/fader/OUT. +7. Editing a destination should not require reopening CH1: target's IN dropdown can select an existing internal source as an **advanced alternative**, but not the *primary* four-times-repeated operator workflow. + +## Native/audio invariants — blocker before LIVE state + +- Selection mode creates a **pending graph intent**, never GUI-local pretend live output. Native ACK returns revision/deviceEpoch and per-receiver accepted source binding; only after then mark each edge LIVE; failures keep the old audible graph intact. +- Multi-channel fanout reads a single immutable source buffer/tap; never four hardware capture callback instances. Publish prepared acyclic graph off audio thread, no realtime allocations/locks/scanner calls. +- Refuse source→itself, transitive cycles, deleted/incompatible target, stale output identity, accidental second direct Master feed, format/latency mismatch; no hidden hardware input replacement. If CH3–CH6 already have real inputs, disclose replacements in the review and require explicit operator acceptance. +- Audio output path must be explicit per destination. Monitor/ASIO safety persists; a best-effort WASAPI monitor is secondary and never clock-master for ASIO. +- Independent plugin PDC and deterministic latency policy: PRE INSERT split must not require CH1 insert latency. A source channel with 'Only selected' remains an audible source *through receivers*, not automatically muted. +- This is **not** GROUP/VCA, SENDS ON FADERS, or Sidechain. Bus/FX sends continue to coexist for normal group/return mixes. + +## UX acceptance criteria to implement next (not yet shipped in V9) + +- Scenario A: CH1 → CH3–CH6, one source selection, one MULT action, four destination clicks (or CH3 + Shift CH6), one Apply. No duplicate per-target dropdown ceremony. +- Scenario B: `Only selected` means CH1 is **not** fed directly to Main, but CH3–CH6 each can route to Main exactly once. No pop or level doubling during graph transition. +- Scenario C: Source badge ⇢4; each destination displays linked source identity/tap, independent fader/FX/meter, and clear nonlive/pending/failed states. +- Scenario D: Starting CH1→CH3–CH6 then attempting CH4→CH1 is rejected with no audible graph mutation; removal CH6 gives ⇢3. +- Scenario E: All 4 outputs independently isolated/bypassed tested with timestamped PCM, levels and CPU/latency baseline on real Windows native engine (V9 reference is never proof of this). +- Scenario F: FX rack/fader geometry from V9 must not change when MULT mode opens/closes; 1366/1680/1920px screenshots reviewed against LV1 hardware-console visual identity. + +## Implementation ownership + +- **PR #278 GUI prototype:** source-first MULT selection interaction, semantic signals, no fake live indicator; retire dropdown-only as primary path. +- **Native engine:** ChannelId & TapPoint fanout, immutable GraphIntent/ACK, topology validation, PCM/latency, deterministic callback execution. +- **Integration/FAT:** independently audible 4 destinations from 1 physical source, routing/monitor isolation and fault-case test. + +Do not merge this GUI-only prototype as native functionality. The initial V9 receiver-side IN dropdown is useful as an advanced alternative **but is NOT the approved primary workflow**. diff --git a/design-references/audition-mixer-study/V11_MIDDLE_WIRE_ROUTING_IMPLEMENTATION_20261102.md b/design-references/audition-mixer-study/V11_MIDDLE_WIRE_ROUTING_IMPLEMENTATION_20261102.md new file mode 100644 index 000000000..24b7173c7 --- /dev/null +++ b/design-references/audition-mixer-study/V11_MIDDLE_WIRE_ROUTING_IMPLEMENTATION_20261102.md @@ -0,0 +1,52 @@ +# ArSonMix V11 — Source-first Wire Routing: Mid-console Preview + +Date: 2026-11-02 | Authority: operator-approved PR #278 | Status: **isolated GUI reference**, not native ASIO/VST3 routing + +## Decision: wiring in the middle, not below the hardware fader + +FL Studio's own manual documents bottom-of-mixer destination Send switches, cable graphics, and per-destination send-level knobs. This is good familiarity evidence, **not** a reason to put ArSonMix's routing below the operator-approved tactile fader. In ArSonMix, preserve the lowest hardware controls (pan, M/S/PFL, fader, LCD meter, nameplate) and place a persistent **WIRE row exactly between FX rack and PAN**, reusing the previously overcomplicated SEND/BUS section. + +- Collapsed SEND/BUS → **53px wire row**, never hidden. The original SEND header remains a compact status strip; advanced BUS/AUX send selection expands separately to 129px. +- FX rack is elastic (V9): extra vertical room flows to FX slots when ROUTE/advanced SEND collapses. Fader height and meter ruler remain invariant while FX is expanded. +- Existing 16 Sends to Bus/FX Return, Sends-on-Faders and Master/primary OUT remain modeled. Do not confuse 1→4 independent audio-channel source splitting with four receives into one Bus, or overwrite real input assignments. +- One only full-window SVG overlay sits over the visible **source/target wire strip**; no physical wires over meter/gain controls, no canvas, no audio-thread rendering, no per-meter-frame geometry recomputation. +- Visual language: source has prominent down-arrow and green socket; destinations show gray up-arrow; connected destinations show green diamond/socket; selected source draws curved two-layer green cable paths to connected on-bank destinations. Maintain readable labels for blind/color-vision accessibility. +- If the source is not visible in the current bank, show the source identity in the global banner. **Off-bank cables are not drawn across nonexistent slots**; connected on-bank destinations retain their linked sockets and receive labels. Bank changes do not change the topology. +- Material inspiration: FL Studio's cable/arrow affordances; physical satin metal, segment-glass meter, fader PNG and calm palette remain ArSonMix style. Match operator recognition rather than stealing another application's logo/pixel assets. + +## Implemented in PR #278 + +1. Select channel source by clicking its channel strip, e.g. CH1. Source ID stays stable while clicking a destination wire socket (prevent delegated mousedown from replacing selection with target). +2. Click CH3, CH4, CH5 and CH6 up-arrows in the center BUS/SEND wire row. Four **separate receiver-side** `CH01 PRE-FX SPLIT` source bindings are created; each receiver keeps independent FX/fader/pan/meter/primary output. +3. On-source fanout badge displays `⇢4`. Global banner reads source and receiver count. The live SVG overlay uses source/receiver actual rectangles, paints curved 2-layer lines and does not capture pointer events. No layout reads within meter animation or audio callback. +4. Clicking a connected target again disconnects that one edge; other receivers remain. A receiver with a real/non-None source is refused (fail closed) rather than silently replaced. Circular/missing-source graph requests are refused by `splitWouldCycle`. +5. Source output stays unchanged; an explicit `SOURCE ONLY (No Main)` output choice from V9 lets the operator prevent an extra dry Main feed. The prototype must never say the audio actually flows. + +**Verified:** 172/172 deterministic DOM/source and input-model smoke checks (including four receiver click paths, individual unlink and occupied-input refusal). **Unverified:** final rendered Chromium layout and manual visual aesthetics. Do not merge this source into web/native without screenshot + native ACK regression gates. + +## Native engine strategy + +- Normalize wire `Link(sourceChannelId, targetChannelId, TapPoint, Enable)` as an **immutable audio graph intent**. Demo strings are transitional; production uses stable IDs, graph revision, device epoch and unique request IDs. +- Two explicit audio semantics: **MULT/PRE INSERT** duplicates one captured PCM source buffer at pre-insert tap into several independent channel processors; **SEND/POST FADER** passes source channel's output under per-destination send level, FL Studio style. Never use the same control for both without clear tap/mode labeling. PRE/POST send fader is not the same as PRE/POST source inserts. +- Multiple sink processing from one source is **one capture, multiple read-only fanout edges**. Check channel format, latency/PDC, gain/headroom, routing graph cycles, stereo pin identities and hardware device epoch off realtime thread; publish prepared graph atomically to callback. No locks, allocations, scanning or geometry work in ASIO callback. +- UI shows PENDING until native graph ACK, no green live cable until accepted. Failed update returns reason and preserves old graph audio; viewer may preview pending connection in a distinct dotted amber line, never counterfeit LIVE. +- User edits a wire at 1→N while audio is running; the graph updates at buffer boundary with ramp/dezipper to prevent pops, without restarting ASIO or forcing WASAPI on primary clock. +- Every destination owns independent meter and insert chain; block inadvertent double direct-MAIN and monitor feedback loops. Native measured acceptance on Windows must separately test one→four with receivers muted one by one and different FX chains. + +## Formal UX tests before merge + +- 1680x900 Comfort selected CH1, click CH3..CH6: four visible green links, no crossing outside the WIRE row or obscuring MUTE/fader/FX, bank unchanged. Compare with FL Studio's target-arrow pattern. +- 1366x768 / 1920x1080 in all density modes and with ROUTE/SEND collapsed and expanded; rail, channels, fixed Master aligned; FX receives reclaimed height instead of moving faders. +- Keyboard focus, up-arrow/button aria-pressed behavior, no color-only status; occupied source refusals readable. +- Persistent source across destination clicks and no wire state reset during plugin browser, bank navigation, scenes, rename or density changes. No hidden source link from off-bank mistaken for lost routing. +- Verify PRE INSERT default independent of source fader; use native execution for real acoustic proof, not simulated meter sine waves. + +## Primary references + +- [FL Studio Mixer Explained — routing iconography and Send switches](https://www.image-line.com/fl-studio-learning/fl-studio-online-manual/html/mixer.htm) +- [FL Studio Mixer Menu — Route this track to selected](https://www.image-line.com/fl-studio-learning/fl-studio-online-manual/html/mixer_mixermenu.htm) +- [FL Studio Mixer Audio Routing — source to destination and Master default](https://www.image-line.com/fl-studio-learning/fl-studio-online-manual/html/mixer_iorouting.htm) + +### Deliberate V11 limitations + +The UI reference currently only routes **ordinary audio-channel source → ordinary audio-channel target** using the prior V9 PRE INSERT binding. AUX/FX Return/Master wire sockets remain disabled indicators in the middle row, while existing SEND/OUT controls still work elsewhere. Batch-Shift routing, live wire gain knobs, native graph ACK and signed-off rendered screenshots are next milestones; none are claimed delivered by V11. diff --git a/design-references/audition-mixer-study/V12_FL_STYLE_WIRE_ROUTING_ARD_PRD_ACCEPTANCE_20261102.md b/design-references/audition-mixer-study/V12_FL_STYLE_WIRE_ROUTING_ARD_PRD_ACCEPTANCE_20261102.md new file mode 100644 index 000000000..e8ff90851 --- /dev/null +++ b/design-references/audition-mixer-study/V12_FL_STYLE_WIRE_ROUTING_ARD_PRD_ACCEPTANCE_20261102.md @@ -0,0 +1,71 @@ +# ArSonMix — V12 FL-style Wire Routing (ARD / PRD / UX Acceptance) + +Date: 2026-11-02 | Product: ArSonMix single-window Live Digital Console | Visual-authority branch: PR #278 +**Status: implemented as interactive GUI-only reference. Not an operational ASIO/VST3 source-to-sink audio graph.** + +## Sources and design decisions + +Image-Line's [Mixer Explained](https://www.image-line.com/fl-studio-learning/fl-studio-online-manual/html/mixer.htm) and [Mixer Audio Routing](https://www.image-line.com/fl-studio-learning/fl-studio-online-manual/html/mixer_iorouting.htm) establish the exact operator expectations: select a source insert; destination up-arrows switch its sends; an enabled send has a per-link level control; green cable traces reveal the path; source's Master routing is independent; impossible feedback paths must be disabled. The official [Mixer Menu](https://www.image-line.com/fl-studio-learning/fl-studio-online-manual/html/mixer_mixermenu.htm) adds the one-to-many routing command and “only” variant which disconnects source direct Master. + +**Ownership decision:** use FL's *interaction grammar and direction iconography* with an original ArSonMix silver/satin console skin. Do not import the brand's proprietary image/button assets. Unlike FL, route wires **in the existing middle BUS/SEND strip** below elastic FX rack and above PAN / MUTE / SOLO / PFL / stable fader / glass meter. User explicitly approved this location. Do not reintroduce DAW transport/timeline. + +## Beginner operator journey (maximum six actions for CH1→CH3–6) + +1. Select **CH1** by clicking any ordinary non-wire part of its channel. Its wire socket displays a green **▼ SOURCE**. +2. Scan the middle row: unused destinations display **△ WIRE**; connected ones show green **◆ LINKED** with a metal gain knob and unlink ×. The pinned Master shows **MAIN ON/OFF** on its own socket. +3. Click arrows at **CH3, CH4, CH5, CH6** OR click CH3 then **Shift-click CH6**. Both produce the same four links and a **⇢4** source count. +4. For levels, turn each individual wire pot (accessible range −60 to +6 dB; native keyboard arrows; wheel is ±1 dB; double-click resets to 0 dB). Moving one pot must never move another. +5. Use **MAIN ON/OFF** in the Master wire socket to remove/restore direct Main feed without affecting other links (duplicated compact toolbar control for when source is off-bank). +6. Choose **Follow Fader** (default, FL-style POST FADER audible send) or **Independent (Pre FX)** (multiplies a PRE INSERT source tap into independent receiver processors) **before creating new connections**. Existing links retain their tap, the control does not silently change existing graph edges. + +**Mental model for users:** “green source down-arrow → target up-arrow → cable → individual knob.” Every wire is directional. A gray/empty arrow is unconnected, green solid line is active **in the GUI reference only**, dashed amber is a hover candidate and not yet accepted. Cyan is PRE FX tap. Never require creating four Bus channels for CH1→CH3–6. + +## GUI reference shipped to PR #278 + +- Independent `wireEdges[]` persisted as `{id,sourceId,destId,mode,levelDb,enabled}` with immutable stable numeric channel IDs. A wire edge is NOT the receiver's `input` string and does not overwrite physical/virtual inputs; it also does not replace the older advanced `CH## PRE-FX SPLIT` input selection. +- Multiple sources may send to the same receiver; each wire pair is unique, independently disconnected and independently leveled. +- `wireConnectRange()` preflights all same-bank destinations for feedback before a batch transaction. Shift-click links all visible contiguous destinations without repeated rendering; no partial commit if any proposed edge creates a cycle. +- `wireIsCycle()` traverses wire sends, existing advanced split inputs, Bus OUT and Bus send connections. Default Main is a separate primary output, never a hidden second graph edge. No claim of full native graph admission. +- Renderer creates only the selected source's **on-bank** cable splines, with two fixed-stroke noninteractive SVG paths per link. Candidate routes are drawn amber/dashed on hover. No cable overlays the fader, meter or FX; pointer events bypass the SVG overlay. No animation, canvas, per-frame geometry pass or JS audio processor. +- Real controls use semantic BUTTON/aria-pressed for sockets and native RANGE for gain; status bar announces wire changes and explicit **GUI DEMO ONLY** notices. Keyboard arrow and screen-reader labels remain available. +- Source selection survives target socket, unlink and gain movement. Bank switching keeps off-bank edges and the global source/count indicator; local SVG never paints to nonexistent strips. +- Scene Save/Recall now includes wire graph, stable next edge ID, selected source, routing mode and range anchor. Existing V9 input, BUS, FX Return, M/S/PFL, Send-on-Faders, FX picker and source hardware art remain untouched. +- V9 FX is elastically taller when ROUTE or advanced SEND collapses; fader and calibrated meter heights remain stable when FX is expanded. + +## AV / accessibility standards + +- Routing row stays visible in collapsed advanced Send, with charcoal wells, satin socket rims, defined arrow anatomy, luminous green/cyan states and non-distracting cable glow. No giant cards, bold headings or consumer DAW timeline. +- Glass LCD metering remains fixed-band dBFS independent of fader dB. Cable rendering must never touch meter canvas or realtime scheduler. +- 1366×768 Comfort, 1680×900, 1920×1080; Standard and Compact too. No horizontal strip overflow; Master pinned and rail aligned; no FX/fader overlap. Screenshots require manual human signoff, not just static source checks. + +## Engine implementation plan — DO NOT label LIVE until native ACK + +**Wire protocol** (example): +```text +WireIntent { + requestId, baseGraphRevision, deviceEpoch, + sourceChannelId, destinationChannelId, + kind: POST_FADER_SEND | PRE_INSERT_MULT, + amountDb, enabled, mainFeedPolicy +} +WireAck { requestId, acceptedGraphRevision, deviceEpoch, + acceptedEdges, rejectedEdges[reason], measuredLatencySamples } +``` +- **Data plane:** a single captured PCM buffer fans out by read-only references. POST FADER uses source FX/pan/mute/fader result with its own send gain. PRE INSERT uses pre-FX input tap and receiver's independent FX/fader/pan/output. Clarify source mute/solo/tap policy before native delivery. +- **Graph:** validate source/target stable IDs, target role, no feedback cycles, no duplicate unintended direct-Main, existing physical input summing and format compatibility, plugin delay compensation and deviceEpoch; create graph off callback, publish at buffer boundary atomically, crossfade/ramp to avoid pops. No allocations, locks, VST scans, JS layout, or WASAPI clock sleeps on ASIO callback. +- **State truth:** pending preview is dashed amber, ACK-connected live edge is green; rejection displays cause and **preserves previous PCM graph**. Current browser reference uses green as *GUI state only*, with unambiguous DEMO status bar and no native audio claim. +- **Monitoring:** main ASIO monitor is the stable priority, secondary buffered WASAPI mirror cannot stall or synchronize the ASIO callback. Do not implement a second resampling mixer to fake a wire. + +## Verification + +**Completed:** 191/191 deterministic zero-dependency JavaScript/DOM workflow assertions (source-first one-to-many, multi-input retention, range linking, per-wire gain, mode, cycle checks, direct Master, scene recall, static material invariants). `visual_wire_v12_qa.py` is included for actual Chromium geometry and screenshot capture but has **NOT** been executed in this conversation. A DOM harness is not proof of rendered pixels or ASIO sound. + +**Required before a production merge:** +1. Real Chromium at three viewports × three densities; screen capture source CH1 linking CH3–6, standalone Master control, all Route/SEND collapse states. No cable over fader or FX, no clipping, and legible gain pots. +2. Native test: CH1 mic → CH3/4/5/6, four independent plugin chains and faders, each receiver alone audible; mix-sum headroom and monitor path checked. Switch native mode while running with exact accepted revision. +3. Fail-closed: self-loop, multihop cycle, occupied physical input, invalid mono/stereo width, wrong device epoch, unplug, plugin crash, target delete, snapshot recall with stale routes. +4. Performance: source fanout should add no redundant hardware captures or unexpected ASIO latency; measure RT allocation, CPU budget and sample timing under 4/16/64 edges. + +## Repository boundary + +PR #278 stays Draft until owner visual approval. Prototype HTML and tests live inside `design-references/audition-mixer-study`; public Pages preview exports may follow after standalone smoke. Native code must conform to existing approved v5.2 ARD/PRD rather than copying this reference script directly. diff --git a/design-references/audition-mixer-study/V13_WIRE_ONLY_PATCH_BAY_OPERATOR_DECISION_20261102.md b/design-references/audition-mixer-study/V13_WIRE_ONLY_PATCH_BAY_OPERATOR_DECISION_20261102.md new file mode 100644 index 000000000..507665721 --- /dev/null +++ b/design-references/audition-mixer-study/V13_WIRE_ONLY_PATCH_BAY_OPERATOR_DECISION_20261102.md @@ -0,0 +1,31 @@ +# V13 — WIRE-ONLY Patch Bay: Remove BUS Dropdown and SEND Slider + +Date: 2026-11-02. Source of truth: owner-approved isolated GUI PR #278. + +## FL Studio reference and operator decision + +Image-Line's official Mixer routing docs show **select source → destination up-arrow switch → per-route send knob**, green wire/arrow indication, and independent direct-Master enable. A separate "choose BUS" dropdown + second horizontal Send Level slider in **every** main channel strip adds no value to that primary routing workflow. Accordingly: + +- **Remove from main channel DOM**, not merely hide with `display:none`: `S1–S16` selector, BUS/FX destination dropdown, legacy Pre/Post and Power buttons, horizontal Send Level input/output. +- **Retain per-link gain** as the existing embedded physical rotary pot `wire-gain`, range −60…+6 dB (0 dB unity). Do NOT remove gain from routing or conflate it with the source fader. +- Main control is a **full-width WIRE PATCH BAY**, in the *existing middle SEND/BUS row*, below FX rack, above PAN and M/S/PFL/fader. Compact 80 px, Expanded 160 px via the existing rail button; compact short-display fallback 58 px at <=680 px viewport height. +- A wire has a visible source ▼, available destination △, connected ◆, and one self-contained knob. Hover cable is dashed amber; committed GUI demo cable green (send) or cyan (pre-FX reference), arcing upwards through the recessed empty patch canvas. +- **Silence unconnected channel wells** visually: do not repeat “CHANNEL PATCH” on ten empty strips. Only source and active receiver display tiny relevant metadata. Pinned Master displays direct connection state. +- Keep the newest geometric P0 contract: FX rack owns **all reclaimed space** from ROUTE and WIRE; PAN, MUTE/SOLO/PFL, fader, and footer retain the same Y positions and heights for all eight ROUTE/FX/WIRE permutations. The approved viewport-proportional fader height is `clamp(150px,100dvh - 630px,485px)` and does **not** shrink or jump when opening the 160px wire bay. The console body faces remain flat anodized metal and FX is the elastic upper section. + +## Compatibility / native engineering boundary + +Source data retains 16 legacy send slots, active send state, snapshot compatibility, and old handlers for migration; they are **not** duplicated as a second set of per-channel operator controls. Existing legacy sends remain logically distinct from new wire edges. Keep guarding against duplicate connections into the same Bus/FX Return and display a LEGACY send cue on a connected destination when applicable. A follow-up native migration must reconcile legacy sends into a single canonical graph and expose advanced editing outside the main strip. Do not delete saved routes or silently change live sound. + +**Crucial**: This is **GUI reference only**. No ASIO PCM fanout, native graph revision/ACK, VST3 or live wire audio is implemented here. A visible green line represents only accepted browser state. Real native implementation requires accepted stable IDs, validated graph, safe PRE INSERT/POST FADER tap semantics and device epoch, buffer-boundary publication, PDC/headroom and live FAT. + +## Source verification and release gate + +- V13 smoke must confirm **no** `send-select`, `send-slot`, `sendlevel`, `data-field=sendLevel`, `data-action=sendOn` or `data-action=pre` in channel-strip HTML. +- CH1 → CH3–CH6 by four arrows or click CH3 then Shift-click CH6 must preserve independent 0 dB physical knob on each destination. +- On real Chromium at 1366×768 / 1666×888 / 1920×1080: verify 80/160px wire heights, rail/channel/Master alignment, 4 FX rack insert rows, no clipped route/patch/header, no cable crossing FX/PAN/fader, and no horizontal page scrolling. Two screenshots should be reviewed by operator: compact and expanded patch. +- Public preview must only be updated after the final branch smoke and main Chromium CI validates the exact source snapshot. Keep PR Draft pending owner visual approval. + +Sources: +- [FL Studio Mixer Audio Routing](https://www.image-line.com/fl-studio-learning/fl-studio-online-manual/html/mixer_iorouting.htm) +- [FL Studio Mixer Explained](https://www.image-line.com/fl-studio-learning/fl-studio-online-manual/html/mixer.htm) diff --git a/design-references/audition-mixer-study/V14_CROSS_DAW_LIVE_OPERATOR_UX_AUDIT_20261102.md b/design-references/audition-mixer-study/V14_CROSS_DAW_LIVE_OPERATOR_UX_AUDIT_20261102.md new file mode 100644 index 000000000..7fec0df18 --- /dev/null +++ b/design-references/audition-mixer-study/V14_CROSS_DAW_LIVE_OPERATOR_UX_AUDIT_20261102.md @@ -0,0 +1,92 @@ +# ArSonMix V14 — Cross-DAW Workflow Audit and Live-Sound Operator UX Decision + +Date: 2026-11-02 | Target: owner-selected GUI reference PR #278, **V13.2** | Status: AUDIT/PROPOSED UX CONTRACT, **NOT** implemented native audio +Scope: learn from official **FL Studio**, **Fender Studio Pro / Studio One lineage**, **Adobe Audition**, plus **Waves eMotion LV1** live-console patches where applicable. Keep ArSonMix an **operator-first live digital mixer**, NOT a DAW timeline. + +## 1. Reliable reference facts — keep semantics separate + +1. **FL Studio Mixer** uses external hardware IN/OUT selectors *separately* from INTERNAL insert-to-insert sends. The operator selects the **source mixer track**, clicks a **destination Send switch**, and adjusts the **send-level knob** on that target. Existing source→Master route remains unless explicitly disabled. FL supports multirouting and prevents feedback cycles. An insert may receive both physical input and internal sends. [Mixer audio routing](https://www.image-line.com/fl-studio-learning/fl-studio-online-manual/html/mixer_iorouting.htm); [Mixer explained](https://www.image-line.com/fl-studio-learning/fl-studio-online-manual/html/mixer.htm). +2. **Fender Studio Pro (successor lineage of Studio One)** exposes compact Input and Output labels at channel top, shows input-type/Output/FX/Bus distinctions, supports click-to-assign or ordered multi-assignment, and hides/shows detailed Sends/I/O. Bus/FX channels list their contributing tracks rather than pretending to have a single hardware input. Main Output remains pinned to the far right. Its Send rack can create a new FX Return by drag/dropping effects; this is excellent for beginners. [Console](https://fenderstudiopromanual.fender.com/en/Content/Mixing_Topics/The_Console.htm); [Effects signal routing](https://fenderstudiopromanual.fender.com/en/Content/Mixing_Topics/Effects_Signal_Routing.htm); [Hardware I/O matrix](https://fenderstudiopromanual.fender.com/en/Content/Setup_Topics/Audio_Device_Input_Output.htm). +3. **Adobe Audition** groups Input/Output, FX, Sends, and EQ into independently visible/collapsible sets. Its Output chooser distinguishes Bus/Mix/hardware. [Multitrack routing](https://helpx.adobe.com/audition/desktop/mixing-multitrack-sessions/multitrack-routing-eq-controls.html). +4. **Waves eMotion LV1** separates external I/O device patching, internal routing to groups/MAIN/matrix, and processing; output tap choices include INP, PRE, PST and PSP. This is particularly relevant to live sound but should not force ordinary operators into a matrix. [Patch tutorial](https://www.waves.com/emotion-lv1-tutorial-2-2-using-the-patch-window); [Mixer channel strip](https://www.waves.com/emotion-lv1-tutorial-4-5-mixer-channel-strip-1). + +These are documented application capabilities, NOT independent empirical usability scores. + +## 2. Current V13.2 source audit — evidence in index.html + +| Priority | Current observable implementation | UX failure / exact risk | Decision | +|---|---|---|---| +| P0 | `channelOptions(...,'input')` combines hardware, CABLE L/R, and `CH## PRE/POST-FX SPLIT` in **one** IN picker | Three different routing concepts are one menu; conflicts with new direct wire target selection | **IN is external source binding only** on main strip; Move internal split to WIRE edge/tap inspector. Underlying migration must be versioned | +| P0 | `channelOptions(...,'output')` exposes Master, Bus and hardware together; pinned MAIN socket and WIRE also route | Duplicate OUT authorities; selected source may have implicit main dry + send, wrong perception of routing | Keep compact **OUT summary/status** but no duplicate inline destination dropdown. Primary MAIN/GROUP direct route controlled by WIRE (unique graph authority); physical endpoints via I/O Patch drawer | +| P0 | `init()` starts with hidden active `Host → Bus A` and `Interview → Bus A` legacy sends | After V13 removed visible legacy Send picker, the **live route can be invisible** from wire; violates soundman trust | Unify/visible-project all *accepted* Send/primary edges to WIRE; migration must de-duplicate safely and distinguish LEGACY until reconciled | +| P0 | `sofTarget`, `getSofLevel`, `setSofLevel` still address legacy `sendSlots`; `wireEdges[]` is separate | Sends-on-Faders can change the **wrong gain** or do nothing to an active wire | SOF uses same canonical stable-ID edge gain as WIRE. Disable/defer unsafe SOF until native confirmed; show strong mode indicator | +| P0 | `wireConnect` restricts source to `kind==='audio'`; `wireSourceId` only changes for audio; `wireFor` excludes Main as standard edge | Bus/FX cannot send onward as FL Studio does, and MAIN state is not modeled uniformly | Support legal source roles (Audio, Bus, FX Return, MON if allowed) with graph cycle/role validation. Main primary/output remains terminal, not send source | +| P1 | `wireMode` global select toggles only **new** edges; current wire mode varies per edge | User assumes changing dropdown modifies currently selected link; existing sends silently keep prior tap | Default edge type inferred by destination role; active edge popover shows tap/level/edit + exact status; never global ambiguous tap mode | +| P1 | `renderWireRouting()` clears cables if selected source is off-bank | Operator sees no wires when bank changes despite accepted links | Docked SOURCE indicator plus on-bank inbound/outbound count; “Show receivers”/“Jump to source” navigation, no fake off-bank cable | +| P1 | Selected channel for gain/FX and selected **wire source** share channel-click state; modifying OUT ends with `selectTrack(t)` | Editing a receiver can silently change the armed wire source | Split explicit **inspectedChannelId** from **wireSourceId**; no silent source turnover during editing, use color-coded SOURCE lock | +| P1 | Top IN can be `None` while meters can animate in demo; input choices are hardcoded device names | Missing “No input / disconnected / device unavailable / pending / accepted” truth; real audio could be misunderstood | Native verified PortRef, deviceEpoch, mono/stereo pins and input level; never claim audio flow from UI-only level animation | +| P1 | Master primary OUT and direct destinations can be set in both ROUTE and WIRE, with role-named options | MAIN ON/OFF becomes ambiguous if direct OUT goes to Bus or hardware | Distinguish primary mix destination from hardware endpoint. MAIN switch reflects exactly accepted direct Main edge, never guessed from a string | +| P2 | FX rack has quick add, but no drop-to-wire FX Return action | Creating shared Reverb requires manual FX Return + plugin + routing | Drag effect onto **WIRE ➕ FX RETURN** to create and patch one wet return automatically | +| P2 | Section rail has primarily cryptic glyphs and both “Narrow” and “View Compact” | Mode/UI terminology duplicates; first-time users must decode icons | Compact text/tooltip: INPUT, INSERT, WIRE, PAN, LEVEL; unify density controls, keep shortcut names and contextual help | +| P2 | “Group” button actually links faders, while GROUP Bus is a different DSP role | An ordinary user might expect a combined Drum Group | Rename **LINK FADERS**, separate **ROUTE TO BUS** (exclusive serial audio submix), and **VCA** future-only | + +## 3. Recommended single-console hierarchy (wire-centric) + +```text +[CH01 · Vocal Mic] Selected SOURCE chip: 01 → 4 targets +[IN 🎙 Mic 1 • ASIO • Mono • OK] [Ø] [M/ST] [ⓘ] +[FX EQ → COMP → +FX] (rack elastic when ROUTE/WIRE folded) +[WIRE source ⇣══▶ CH3,4,5,6] 80px compact / 160px expanded +[OUT ● MAIN • ⇢ 4] optional ONE compact summary chip; + no second always-open dropdown +[PAN Center] fixed Y position +[MUTE | SOLO | PFL] fixed Y position +[LED VU / FADER] fixed height and Y +[CH01 Vocal Mic] name/identity +``` + +**Top IN:** always-visible **one source binding summary**, click to open an anchored nonmodal **INPUT PATCH** popover. Source groups: Hardware ASIO (named verified mono/stereo pins), Virtual Input (verified bridge/device source), Channel Copy/MULT (advanced; do not mix with hardware list), None. Include current device, port availability, last accepted source, channel processing width, estimated latency status. “Unsupported/disconnected” fail closed; do not offer hard-coded dead endpoints. + +**Top OUT:** Retain **one glanceable destination/status**, not a second competing routing authority. Default `● MAIN`; when routed exclusively to Group show `● BUS DRUMS → MAIN`; when multiple direct sends show `⇢4` WIRE. Click OUT for read-only route inspector and an **Advanced Hardware Output** patch action, not a full duplicated destination dropdown. Move physical output mapping (Main, Monitor, broadcast return, direct outs) to named output buses in a compact Audio I/O drawer; advanced matrix available on demand. This refines the old v5.2 PRD requirement “Direct compact IN and OUT” instead of deleting visibility entirely. + +**Central WIRE:** uniquely owns INTERNAL routing. Clicking CH1 source then CH3+Shift CH6 creates 4 links; per-edge hardware knob; accepted direction/role/tap labels. Hover preview amber dashed, linked green/cyan when ACK accepted. Shift-range and unlink remain. Context menu **Send** vs **Route Only** vs **Sidechain** where appropriate. Provide destination-group role defaults with explicit undo, never silently delete a primary direct-Main edge. + +**Rule per target role:** Audio channel → ordinary POST-FADER send (or advanced PRE-INSERT split); FX Return → parallel Send; MON/AUX → independent monitor send default PRE-FADER, explicitly configurable; Group Bus → operator chooses “ROUTE ONLY” (serial group, remove direct MAIN) versus “SEND PARALLEL”; Main → direct output route. Both Main and external hardware output are distinct concepts. + +**Processing vs engineering:** Always-visible mic source, compact IN health, FX bypass, Pan, M/S/PFL, fader, VU, selected route count. Higher-detail gain/polarity/device matrix, plugin latency, tap, snapshot transaction in popover or nonmodal inspector. Avoid separate DAW timeline, full-screen patching or multiple redundant modes. + +## 4. Five primary soundman workflows (target interactions) + +1. **Plug in microphone → sound:** select active device once; CH1 IN → Mic 1, observe RAW input meter and Output/Main state; adjust CH1 fader, MAIN meter follows. No need to create a Wire to hear basic channel. +2. **One source → four channels:** click CH1; click CH3, Shift-click CH6. Four independently adjustable send pots, source badges +4, receiver IN source hints. For independent FX processing of identical capture use explicit PRE-INSERT MULT mode/tap; avoid default source fader linkage confusion. +3. **Vocal → reverb:** drag Reverb plugin to `WIRE ➕ FX RETURN`, creates FX Return channel and sends CH1 to it with wet processor. Original dry to MAIN preserved; Send knob changes only wet amount. No manual Bus creation. +4. **Drums → one group:** multi-select audio channels, click `ROUTE TO BUS` → Drum Bus or +NEW. Source primary outputs replace MAIN, Group Bus routes once to MAIN. No accidental extra MAIN feed; CH buses remain separate from LINK FADERS. +5. **Stage monitor:** select MON bus → `SENDS ON FADERS`; source channel faders temporarily control accepted MON sends, not Main gains. Visible bright but restrained MON mode banner, safe return to MIX. Independent ASIO main and secondary best-effort mirror never share a realtime clock. + +## 5. Phased owner decision and acceptance gates + +### P0 — eliminate dangerous competing authorities +- Unify canonical signal graph in engine and UI: physical PortRef input, primary serial GROUP/MAIN route, parallel SEND, independent PRE-INSERT MULT, true hardware output patch. Every audible accepted legacy send must appear in WIRE or migration preview. +- Bind sends-on-faders, snapshot, wire gain and bus routing to the same accepted graph revision; make invisible routes and old slot duplication impossible. +- Keep approved V13.2 physical proportions: elastic FX; **PAN, MUTE/SOLO/PFL, FADER and footer stationary** across all ROUTE/FX/WIRE folds. Do not replace fader artwork or change app into multitrack DAW. + +### P1 — UX simplification +- Top IN becomes compact device-bound source badge and popover; OUT becomes route status & inspect, not second authority. +- Explicit role-aware routing context, source lock and off-bank navigation; source → Master default visible and editable. +- Rename Group to LINK FADERS; show Bus/FX/MON roles, display routing from any legal mix node. +- Input/source/edge statuses: AVAILABLE, UNPATCHED, PENDING, LIVE, FAILED, DISCONNECTED. No false green accepted or fake meters. + +### P2 — one gesture smart assists +- Drop FX on patch bay creates FX Return+Send, multi-select→Group Bus, quick MON mixes, clear duplicate/feedback preview, undo last route with a single action. +- One rare **Advanced PATCH** matrix exposes all internal/hardware graph edges, not required for the 90% quick workflows. +- Keyboard/source shortcut and accessible arrow/knob labels; color is secondary to icon/text shape. + +**Production acceptance:** Native ACK/GraphRevision/DeviceEpoch of each audio edge, real PCM before/after each processor, 1→4 split vs send audible semantics, independent send levels, cycle rejection, device hotplug/pending vs live state, source/direct hardware monitor, snapshot reset and rollback; one primary JUCE ASIO callback, zero RT allocations/locks, independent best-effort WASAPI mirror. Browser DOM/Chromium green passes remain GUI-only proof. + +## 6. Existing PRD/ARD reconciliation + +Current `docs/PRD_ARSONMIX_OPERATOR_FIRST_LIVE_MIXER_V5_20261101.md` correctly requires direct compact IN/OUT and verified device endpoints, but its older `SENDS dropdown shows...` requirement conflicts with owner-approved V13 wire-only console. **Revise PRD with a clearly versioned V14 addendum**, not by silently deleting technical behavior: the *underlying send graph/tap/gain* remains, its primary operator UI becomes the **WIRE** arrow/knob. SENDS ON FADERS remains a valid monitor workflow only after bound to wire edges. ARD already forbids WebView2 as PCM authority and requires native ACK; preserve it. + +## Summary + +**Keep** tactile physical console + Source IN + FX rack + middle FL wire + fixed PAN/M/S/PFL/LED/fader + pinned MAIN. **Remove from main strip** duplicated old output-picker authority and internal split entries inside hardware IN menu. **Move** hardware patch and per-edge advanced tap/level to simple popovers. **Unify** every audible route and fader Send mode into one accepted graph with a truthful, readable live representation. Do not conflate UI-demo click correctness with native audio. diff --git a/design-references/audition-mixer-study/V15_DRAG_WIRE_LEFT_RIGHT_BUS_ONLY_OPERATOR_UX_20261102.md b/design-references/audition-mixer-study/V15_DRAG_WIRE_LEFT_RIGHT_BUS_ONLY_OPERATOR_UX_20261102.md new file mode 100644 index 000000000..34db88820 --- /dev/null +++ b/design-references/audition-mixer-study/V15_DRAG_WIRE_LEFT_RIGHT_BUS_ONLY_OPERATOR_UX_20261102.md @@ -0,0 +1,65 @@ +# ArSonMix V15 — Physical Drag-Wire Patch Bay and Easy Bus-Only Routing + +Date: 2026-11-02 | Source of truth: PR #278 isolated reference | **GUI DEMO ONLY**, not native PCM and no accepted audio graph ACK. + +## Official DAW workflow research + +1. [FL Studio mixer routing](https://www.image-line.com/fl-studio-learning/fl-studio-online-manual/html/mixer_mixermenu.htm): A source can send to selected tracks, or **Route this track to selected only** which also deselects direct Master send. It can create a submix, selected tracks to this track only, ordinary sends and sidechain routing. Track order is not a signal-direction rule. It supports a dedicated “Routing cables” display. +2. [Fender Studio Pro / Studio One Effects Signal Routing](https://fenderstudiopromanual.fender.com/en/Content/Mixing_Topics/Effects_Signal_Routing.htm): primary channel OUT to Bus is serial group routing; **Sends** are parallel and independent of primary OUT. FX Returns own independent insert chains/fader/OUT and can send onward; drag an effect onto Send creates a new FX Return and a Send. +3. [Adobe Audition multitrack routing](https://helpx.adobe.com/audition/desktop/mixing-multitrack-sessions/multitrack-routing-eq-controls.html): Master/Mix is a terminal output to hardware; Bus output can reach another Bus or Mix; multiple Sends to different buses are independent of primary Output. Bus chaining and monitor mixes are genuine, not alternate labels for a fader LINK group. + +**UX decision**: borrow FL Studio's direct source-first interaction, Studio One's serial-vs-parallel semantics, Audition's explicit primary output separation. Express it with original ArSonMix physical patch jacks (not imported FL graphics): **OUT ● (filled) → IN ○ (hollow)**, a cable that follows the pointer, and a safe nonmodal decision for a Bus. + +## Implemented on PR #278 + +- Every ordinary audio channel, Group Bus, and FX Return has its own **filled SEND OUT** node. Every other channel has a **hollow SEND IN** socket, and Master is the terminal (no OUT). The source is not inferred from left-to-right order. +- Drag filled OUT → hollow IN; start dragging after a 5px displacement threshold. Lightweight SVG cable follows the actual pointer; release over an accepted input socket commits via the SAME `requestWireConnection()` guard used by click-to-click routing. Canceled/off-target drags leave the audio graph unchanged. +- Drag from CH08 RIGHT to CH03 LEFT is valid. Source socket clicks also arm that source without requiring the user to start dragging. Click target IN after switching to another bank is a low-error alternative for long-distance links; no invisible auto-scroll/teleport. +- Routing labels remain tiny, with separate engraved OUT/IN, connected/inactive sockets, and one per-link gain dial. Selected source is tinted green; connected send shows green/cyan depending on declared tap; pending hover line amber. The socket's visual result is browser state only, not a genuine live PCM ACK. +- Compact wire view retains connection cables; expanded wire view provides taller, recessed routing canvas. The P0 fader/PAN block must remain at the approved stationary position; FX rack absorbs ROUTE/WIRE fold changes. +- All source roles except terminal Master may originate a wire (Audio/Bus/FX). Group Bus and FX Return have their own valid OUT path to Main or another legal bus. + +### Dragging to a Bus: exactly two nonmodal choices + +- **VIA BUS ONLY** (recommended serial path): one primary route **CH → BUS → MAIN**. Source primary OUT becomes the Bus (and therefore is **not** direct MAIN). A `kind:'primary',mode:'routeOnly'` reference edge visualizes the one serial primary route, not a parallel audio Send. Disconnecting it leaves source `SOURCE ONLY (No Main)` rather than silently restoring an additional direct-main path. +- **PARALLEL SEND**: one dedicated `kind:'send',mode:'send'` edge is created; current primary OUT is unchanged (typically direct MAIN). Good for shared Reverb, FX processing, foldback and layered send mixes. The operator must choose; merely touching a Bus jack must not mutate Main feed. +- **Master as destination**: a direct Master jack toggles primary Main only when the source currently routes to Main or Source Only. When primary route is through a Bus, direct Master cannot be silently re-enabled; changing to Main must be an explicit higher-level re-route. +- **Legacy Send conflict**: if an existing hidden legacy Send connects this source to the Bus, do not create a second audible path or silently delete the old send. Refuse with an explanatory message until the canonical graph migration is accepted. + +## Workflow and failure-mode acceptance matrix + +| Case | Expected soundman workflow | Native audio invariant | +| --- | --- | --- | +| CH1→CH3, rightward | OUT1 drag → IN3, or select CH1 then click IN3 | One read-only source buffer, one valid accepted edge | +| CH8→CH3, **leftward** | OUT8 drag LEFT → IN3 | Destination location never limits graph direction | +| CH1→CH3/4/5/6 | Click CH1 → CH3, Shift-click CH6; or 4 successive drags | Independent per-destination processing and gain | +| CH1→Bus A→Master **without direct Main** | Drag OUT1 → IN Bus A → **VIA BUS ONLY** | Exclusive primary Out=Bus A; Bus A Out=Main once | +| CH1→Bus A + Main simultaneously | Same gesture → **PARALLEL SEND** | Keep Main, create one extra send; warn about gain/headroom | +| CH1→FX Return Reverb | OUT1 → FX Return IN | Parallel wet/send, preserve dry Main; dedicated return VST insert | +| Bus A→Bus B→Main | Bus A OUT → Bus B IN, choose **VIA BUS ONLY** | Acyclic graph, single serial primary route | +| FX Return→Bus A→Main | FX OUT → Bus IN then choose route-only | Independent FX return insert/fader and valid downstream | +| Bus A→CH3 while CH3→Bus A | Attempt reverse drag | Reject transitive cycle; preserve previous accepted graph | +| OUT1 released on blank metal | pointer cancel/no valid input | No edge created, no source/fader moved | +| Source and destination same strip | OUT1 → IN1 | Reject; no feedback/self-loop | +| Source or target hidden in next bank | Click source, switch bank, click target IN | Source stable across navigation; off-bank edge persists | +| Channel renamed / restyled | Rename source/Bus | Stable IDs, no broken connections based on mutable text | +| Main and secondary WASAPI monitor | Source to Main, monitor sink mirrored best-effort | No secondary sink stalls clock or ASIO audio callback | +| Device disconnected / reopened | Mic ASIO deviceEpoch changes | Existing accepted graph never points at stale hardware pins | +| Scene recall and safety | Restore prior source/Bus paths | Single atomic native graph revision or reject, no partial states | +| Mono Mic to stereo return | Select/route legal width | Explicit channel width and legal L/R projection | +| 16+ sends / high CPU | Many destinations | No per-route physical capture duplicates, bounded RT work | +| Sidechain-only | Advanced destination route type | No audible duplicate dry signal; not falsely drawn as normal send | +| Physical output routing | Bus/MAIN OUT to device pins | Separate native hardware patch, never mistaken for channel-to-channel wire | +| Dragging over input with legacy Send | Refuse duplicate; show migration reason | No two audible unintentional paths to same destination | +| Soft keyboard/screen-reader use | Choose Source OUT; click IN; adjust native range | Controls have unique labels and focus ring; not drag-only | + +## Remaining production gates + +1. Existing `V14` upper IN/OUT UX audit remains **unimplemented** here: verified audio PortRefs, primary OUT summary, canonical unified graph and real Send-on-Faders must be done by native/UI ownership. Current V15 browser demo still has upper IN/OUT dropdowns. +2. New V15 pointer gesture needs actual Chromium drag screenshot/geometry acceptance at 1366×768, 1680×900 and 1920×1080, all three densities; CSS should be reviewed manually for 28–30px nodes, cable contrast and green/amber semantics. A JS DOM state test does not prove visual hit testing, `elementFromPoint`, nor tactile aesthetics. +3. Native graph: prepare structural changes off callback, stable ChannelIds, target width, loop/duplicate-PATH preflight, `requestId/baseGraphRevision/deviceEpoch` and accepted snapshot ACK, sample-accurate PCM fanout and source tap semantics (POST FADER vs PRE INSERT), PDC/latency/headroom and 30-minute real ASIO FAT. No GUI green “LIVE” until native graph ACK. +4. Future ergonomic enhancement: add a compact post-drag **Undo route**, safe Replace/Swap when an existing primary route is present, advanced SIDECHAIN-only and destination navigator for off-bank source/target. + +## Source boundary + +All implementation is isolated to `design-references/audition-mixer-study/index.html` and companion smoke/QA files within PR #278. The source remains Draft. Do not merge the browser demo into production engine as if its wires were real PCM. diff --git a/design-references/audition-mixer-study/V17_MAGNETIC_WIRE_PHYSICAL_PATCH_BAY_20261102.md b/design-references/audition-mixer-study/V17_MAGNETIC_WIRE_PHYSICAL_PATCH_BAY_20261102.md new file mode 100644 index 000000000..79dd8684f --- /dev/null +++ b/design-references/audition-mixer-study/V17_MAGNETIC_WIRE_PHYSICAL_PATCH_BAY_20261102.md @@ -0,0 +1,49 @@ +# V17 — Magnetic Physical Wire Patch Bay (GUI reference) + +Date: 2026-11-02. Authority: isolated GUI PR #278. Status: implemented in HTML demo; **NOT native audio routing**. + +## User-approved design + +- Four stable controls in a physically fixed horizontal matrix: **OUT** (small filled metal jack), **IN** (larger recessed socket), **GAIN** (dark idle / destination channel accent when connected), and **REMOVE** (reserved slot hidden until linked). +- OUT and IN **do not shift** when routes become linked or unlinked; physical positions are not calculated from number of connections. +- A live IN shows a colored small center contact inside the larger recessed ring. Idle IN remains hollow. +- Rounded cables use symmetric cubic Bézier splines. Routing from the right to the left has exactly the same capability as left to right. +- **Preview** is solid, translucent and softly separated from the chassis. Only committed wires use a strong line; no dashed wire. +- **Auto snap** when the pointer is within 42 CSS pixels of a candidate socket *or* enters another strip's WIRE compartment. Snapping can cross the previously selected source and can target pinned MAIN. +- A drag released over PAN, MUTE, FADER or unrelated FX does not create a route. Connection is committed only on pointerup to a legal target. +- Hover and release candidate highlighting is only a visual affordance; graph safety/Bus choice remain existing V15 logic. +- Starting/canceling drag must not select a new source. An accepted drop selects its source. +- Pointer rendering uses a single requestAnimationFrame gate per frame rather than rebuilding the full mixer on every mousemove. +- WIRE collapse continues to hide wire graphics without deleting routing state. + +## What was changed + +1. `index.html`: stable four-column tray (24/28/22/14 px), idle pot placeholder, idle close slot; source pin visual smaller than destination ring. Active gain uses `--ch`, the strip's existing channel color. +2. `index.html`: `wirePathData` applies a bounded cubic spline with distance-dependent lift, symmetric for either sign of horizontal travel. `renderWireRouting` renders an opaque committed cable and a translucent solid preview, skipping off-bank edges without mutating them. +3. `index.html`: `wireSnapTarget` resolves the closest legal socket in a magnetic halo or WIRE compartment; `setWireSnapTarget` highlights candidate; `queueWireGestureFrame` throttles redraw. Pointerup recomputes snap to avoid using stale pointer frames. Cancellation clears only transient drag state. +4. `smoke.test.cjs`: fixed geometry and inactive/active controls checks; verifies no dashed wire, snap/drop integration, and source selection safety. +5. `visual_wire_v15_qa.py`: extends actual Chromium acceptance with an **off-center magnetic drop**, socket-vs-pin size, static knob coordinates before/after connection, and solid cable preview. + +## Acceptance and evidence + +| Check | Result | +|---|---| +| JavaScript inline syntax compilation (non-executing V8 parse) | PASS | +| Smoke test source syntax compilation | PASS | +| CSS brace balance | PASS | +| Static presence of snap/drop, stable grid, rAF gate and dash-free SVG renderer | PASS | +| Full smoke.test.cjs execution | **PASS: 214/214** in GitHub Actions dedicated reference workflow | +| Chromium actual pointer geometry, magnetic off-center drop, no-reflow, Bus-only path | **PASS** at 1680×900 in dedicated GitHub Actions workflow | +| 1366/1920 px visual QA, Firefox and operator aesthetic review | OPEN; no final visual approval claimed | +| Native ASIO/PCM graph, VST3 and accepted graph ACK | OUT OF SCOPE / OPEN | +| Pages preview publication | OPEN: reference branch is not automatically deployed | + +## Manual operator check + +Expand WIRE in the left section rail; select CH08 OUT, drag **left** toward CH03 and release **near** its IN rather than directly on the center. The wire should bend naturally toward the receiving socket, turn solid only after the drop, and preserve all IN/OUT/GAIN positions. Turn the CH03 gain knob; it should carry CH03's channel hue. Drag and release on a fader: it must not create a new edge. For a Bus target, continue to choose **VIA BUS ONLY** or **PARALLEL SEND** explicitly; this interaction does not turn the browser demo into native audio. + +## Production handoff + +The physical connectors are the operator-facing graph editor only. Native ownership must preflight source/destination/feedback, send-tap semantics, duplicate legacy SEND routes, device epoch and channel identity, and return an accepted graph revision before UI may label the wire as live PCM. Preserve one authoritative native signal graph and fail closed on rejected or pending transactions. + +Evidence: [Focused V17 GitHub Actions run #41377926771](https://github.com/masarray/arsonmix/actions/runs/41377926771) — successful; branch head at test: `55fb824052c323c4b37ced4cbd28b51de599e86e`. CI checks are reference-only, not production PCM certification. diff --git a/design-references/audition-mixer-study/V17_RELEASE_AUDIT_AND_PREVIEW_HANDOFF_20261102.md b/design-references/audition-mixer-study/V17_RELEASE_AUDIT_AND_PREVIEW_HANDOFF_20261102.md new file mode 100644 index 000000000..5502cdde5 --- /dev/null +++ b/design-references/audition-mixer-study/V17_RELEASE_AUDIT_AND_PREVIEW_HANDOFF_20261102.md @@ -0,0 +1,42 @@ +# ArSonMix V17 — Routing UX Optimization Audit and Preview Handoff + +Date: 2026-11-02. Scope: PR #278 isolated HTML routing reference, **not native PCM/VST3 integration**. + +## Implemented / retained + +- **Stable patch row**: fixed 24 / 28 / 22 / 14 px OUT / IN / gain / disconnect columns (plus gaps). No linked-state layout shift; dark idle knob and channel-accent active knob; small filled OUT contact and larger recessed IN with a center pin when linked. +- **Efficient pointer interaction**: one `requestAnimationFrame` render request per pointer frame; compute nearest magnetic candidate only during drag; the received graph changes on accepted release, never on pointermove. Cancel/invalid-drop do not rewrite the graph or source. +- **Smooth legible wires**: symmetric cubic Bézier path toward left or right, solid translucent drag preview, brighter committed cables; no dashed preview. +- **Operator workflow**: drag OUT to IN, or select source and click IN; direct MAIN, Bus-only serial and parallel Bus paths remain different explicit actions. Do not auto-add a direct master route for a Bus-only path. +- **Presentation**: retained pre-existing global physical MUTE/SOLO button material and channel colors; avoided native GUI/engine edits. +- **Build/publish hygiene**: copied the *qualified HTML blob* from the PR reference into main's `site/preview-v2/index.html`, with `site/preview-v2/build.json` and `site/preview/candidate.json` in **one atomic Git commit** instead of several potentially conflicting Pages publications. Main builder reads this same file for `/preview/mixer.html`. + +## Verification ledger + +| Gate | Result | +|---|---| +| Node in-memory DOM/workflow suite | **214/214 PASS** | +| Chromium real pointer drag, leftward send and Bus-only action | **PASS** | +| Socket and gain centers unchanged before vs after connection | **PASS** | +| Magnetic off-center release | **PASS** | +| Invalid drop over fader must not create routing edge | **PASS** | +| Responsive geometry and interaction | **PASS 1366×768 / 1680×900 / 1920×1080** | +| Dedicated reference CI | [PASS #41384650297](https://github.com/masarray/arsonmix/actions/runs/41384650297) | +| Main Pages publication commit | [`b42391f`](https://github.com/masarray/arsonmix/commit/b42391fb96d4e322db73929fedb34c2f3b5dc099) | +| Production main UI smoke and automatic Pages deployment | Follow release gate status in GitHub Actions, do not infer from source commit | + +## Remaining audit findings / separation boundaries + +1. **P0: native routing canonical graph is still separate.** The HTML's wire links are DEMO state. Do not claim ASIO or VST3 sound exists until `GraphIntent → validated audio graph → GraphAccepted(revision)` is confirmed with DSP and device-epoch tests. +2. **P0: legacy SEND slots and Sends-on-Faders are not the same model as wire edges.** In native integration, migrate/reconcile those graph paths and prohibit hidden audible duplicate Sends before promoting this UX to production. +3. **P1: upper physical I/O has overlapping responsibilities with wire routing.** Native UI should show verified physical IN and a compact read-only OUT/route summary; reserve internal graph edits for WIRE, using native signal data. +4. **P1: cross-bank navigator and keyboard-first accessibility.** Current clicking source across banks is preserved; automatic drag across changing banks is not certified. +5. **P1: screen reader, touch/precision and compositor benchmarking.** DOM + Chromium coverage does not substitute for Windows high-DPI screenshot review, hardware tactile judgment or actual audio load/latency tests. +6. **P2: source cleanup.** HTML reference remains large and contains historical V12–V16 fallback CSS. Consolidate only after recorded three-width pixel baselines, avoiding risky wholesale CSS surgery during publication. + +## Test and release integrity + +- Production source remains PR #271 renderer and PR #266 audio-engine owner; do not merge PR #278 by default. +- GitHub Pages is a **preview-only operator workflow reference**, explicitly says `SIMULATED METERS / NO REAL AUDIO`. +- All new preview data is versioned and traceable to the isolated PR source blob, test run and atomic main publication commit. +- Test changes are confined to the focused `reference-wire-qa.yml`; no duplicate heavyweight Windows/ASIO pipeline for every PR draft change. diff --git a/design-references/audition-mixer-study/V18_IN_SOCKET_REPLUG_UNPLUG_OPERATOR_WORKFLOW_20261102.md b/design-references/audition-mixer-study/V18_IN_SOCKET_REPLUG_UNPLUG_OPERATOR_WORKFLOW_20261102.md new file mode 100644 index 000000000..62c85025c --- /dev/null +++ b/design-references/audition-mixer-study/V18_IN_SOCKET_REPLUG_UNPLUG_OPERATOR_WORKFLOW_20261102.md @@ -0,0 +1,36 @@ +# ArSonMix V18 — Pull Cable From Receiving IN, Replug or Unplug + +**Status:** implemented on PR #278 isolated GUI reference; V18 does **not** perform native ASIO/PCM audio rerouting. + +## Fast soundman operation + +- **Grab:** move pointer to a connected **IN socket** (or its near-side surrounding tray, within 22 CSS px of its center), press and drag. +- **Move:** the connected cable's old segment disappears, its round tip follows the pointer, and the original socket shows a recessed empty hole. The original connection is still preserved in the model while dragging. +- **Replug:** bring cable within the target's 42px magnetic halo, or into another channel's WIRE compartment; the loose cable jumps visually to the destination socket. Release to transfer the **same** edge ID to that destination. +- **Unplug:** move beyond **31px** of the original receiving socket and release outside the magnetic area of any *other* receiving socket. This removes that one edge. +- **Accidental move protection:** a motion under the drag threshold remains a click; after starting a drag, returning to the original receiving socket preserves the connection. A canceled pointer gesture changes no routing. +- **Original single-click and OUT→IN drag** remain available; the dedicated × button and per-wire gain knob are retained for accessibility and keyboard alternatives. + +## Audio-graph safety contract + +1. Replug preserves ID, enabled state, level in dB, processing tap/mode and send-vs-primary semantics; it does **not** create another Send. +2. Reject a new destination on feedback cycles, already-linked destinations, legacy active Send duplication, or invalid receiving channel. On rejection **keep the previous connection**. +3. Primary **VIA BUS ONLY** can be moved only to another Bus or explicitly to MAIN; moving it to MAIN removes the original primary Bus edge and sets source primary output to MAIN. Unplugging a Bus-only wire leaves **SOURCE ONLY (No Main)**, never silently enabling an extra dry Master signal. +4. Main output hardware patch, device epoch and accepted native audio-graph revision still require production ENGINE work; the visual demo does not claim real PCM. + +## Visual/performance contract + +- Fixed four-column socket/knob/close geometry from V17; no resize/reflow when moving or unlinking an edge. +- One SVG cubic Bézier cable preview and a small unblurred circular plug at the free endpoint; target snaps to the receiving jack. +- No blur/filter-based animation; pointer redraw via requestAnimationFrame and model update on accepted release only. +- Source selection stays unchanged while dragging, and legacy click is suppressed once after an actual drag to avoid accidental toggling. + +## QA evidence + +- 221/221 model/DOM assertions PASS: move left/right, preserve gain/id, original snap-back, pull-to-disconnect, pointercancel, reject duplicate. +- Real Chromium connected-IN pointer tests at **1366×768**, **1680×900**, **1920×1080** PASS in [GitHub Actions #41393926429](https://github.com/masarray/arsonmix/actions/runs/41393926429). +- Preview publishing commit [`ba8c43e`](https://github.com/masarray/arsonmix/commit/ba8c43e68020b7bc1bd8c18e2f0edc9eb350f99c) is an atomic snapshot of the qualified PR278 source; GitHub Pages production release gate executes separately. + +## Remaining native integration + +Do **not** merge the HTML demo as a real DSP graph. Replace demo state with a validated `GraphIntent(oldEdgeId,newDestination | disconnect)` against a stable revision, reject duplicate/cycle/invalid device-epoch actions and update the GUI only after the engine's accepted graph ACK. Preserve audio-thread constraints, recovery and undo in native Windows qualification. diff --git a/design-references/audition-mixer-study/V19_COLLAPSE_RACK_DAW_UX_20261102.md b/design-references/audition-mixer-study/V19_COLLAPSE_RACK_DAW_UX_20261102.md new file mode 100644 index 000000000..fa16c25aa --- /dev/null +++ b/design-references/audition-mixer-study/V19_COLLAPSE_RACK_DAW_UX_20261102.md @@ -0,0 +1,32 @@ +# ArSonMix — Compact Rack V19: Routing Awareness Without Cable Clutter + +Date: 2026-11-02. Scope: PR #278 browser GUI design reference. Native audio remains unintegrated. + +## Pattern benchmarks + +- FL Studio manual, [Mixer Explained](https://www.image-line.com/fl-studio-learning/fl-studio-online-manual/html/mixer.htm): selected-channel routing emphasizes direction and muted incoming-source send controls; routing cables can be made visible in Mixer View, not globally on every strip. +- FL Studio manual, [Mixer Menu](https://www.image-line.com/fl-studio-learning/fl-studio-online-manual/html/mixer_mixermenu.htm): "Routing cables" is an optional visualization. +- Steinberg Cubase 15 [MixConsole](https://www.steinberg.help/r/cubase-pro/15.0/en/cubase_nuendo/topics/mixconsole/mixconsole_mixconsole_window_r.html): dedicated Routing, Inserts and Sends sections remain separate from the fader section. +- REAPER [User Guide](https://dlx.reaper.fm/userguide/): allows sending information in the track control panel when room permits; a Routing Matrix is available for complete graph troubleshooting. + +These are **design inspiration**, not claims that those DAWs use ArSonMix's exact numerical badges or compact layout. + +## Final collapse contract + +1. **No cable paths** when WIRE is collapsed. Keep existing `display:none` SVG guard to preserve the 23px WIRE rack and prevent hidden pointer hit areas. +2. **Show a meaningful folded state** inside each channel's 23px section: `← N` incoming internal paths, `→ N` outgoing internal paths; tiny neutral em dash when none. Outgoing uses the channel's color, incoming is deliberately more subdued. Status is a **summary**, not a separate editable routing surface. +3. Count enabled GUI wire edges, Split-source links, active legacy Send slots, and direct bus/FX primary paths that are not already represented as wire edges. **Do not count the ordinary direct Master path** in the WIRE tally; it remains an I/O concern. This avoids a noisy `→1` on every default track. +4. Clicking the folded summary opens WIRE using the existing rail disclosure handler. The indicator is an accessible labeled button and never causes an unvalidated graph mutation. +5. **28px left section rail**: short `I/O`, `FX`, `W` labels, tiny 3px chevrons (closed = right, open = down), a restrained 2px left activity edge. Remove pseudo-text `OPEN`, `PATCH` and `WIRE` that competed for space. +6. Preserve approved V20 MUTE/SOLO key material, fixed left rail width, 23px collapse, FX rack height ownership, PAN and fader heights. No blur or animation. + +## Verification + +- 225/225 DOM/workflow tests pass, including legacy Send visibility, per-channel in/out counts and click-to-expand. +- Chromium UI checks at 1366×768, 1680×900, 1920×1080 passed in [GitHub Actions #41397350090](https://github.com/masarray/arsonmix/actions/runs/41397350090). +- V15 and V18 real pointer routing regression tests also passed in the same workflow. +- Qualified atomically into main preview commit [`4403d9d`](https://github.com/masarray/arsonmix/commit/4403d9d255e3a13357600456e7d581802729d389) without modifying native audio sources. + +## Related follow-on + +A dedicated **Focus** view can later show bright selected-channel outgoing wires above faint incoming wires when expanded. Collapsed WIRE should continue using ONLY this 23px static summary, even if Focus has been enabled for the expanded view. Any change of actual primary path, legacy Sends or graph-edge admission still requires the native audio engine ACK and safe migration strategy. diff --git a/design-references/audition-mixer-study/V30_WIRE_FOCUS_OUT_ALL_OPERATOR_VIEWS_20261102.md b/design-references/audition-mixer-study/V30_WIRE_FOCUS_OUT_ALL_OPERATOR_VIEWS_20261102.md new file mode 100644 index 000000000..a38fab70f --- /dev/null +++ b/design-references/audition-mixer-study/V30_WIRE_FOCUS_OUT_ALL_OPERATOR_VIEWS_20261102.md @@ -0,0 +1,19 @@ +# ArSonMix V30 — Optional WIRE View Modes (GUI Reference) + +Date: 2026-11-02. Implementation: isolated design reference in PR #278; **not native audio routing**. + +## Operator behavior + +- **Focus (default):** selected channel incoming cables behind its brighter outgoing cables, as approved in V26. Compact channel-colored IN/OUT legend is unchanged. +- **OUT only:** shows outgoing cables from the selected channel, deliberately hides incoming paths without unlinking them. +- **All wires:** adds only unrelated routes whose endpoints both exist in the currently visible bank as very faint context behind selected-channel incoming and outgoing. Hidden-bank routes are never fabricated across empty strips; selected channel's IN/OUT legend still reports links to other banks. +- Collapsing WIRE empties the cable SVG regardless of mode, preserving the approved 23px DOT/socket status and no overflow into PAN. +- Mode control occupies just 77px in the existing header; no new rack, panel, fader movement, or routing editor. +- View change does **not** rebuild channel strips, update `wireEdges`, touch sends or source/MAIN output, or create a new graph transaction. +- Reset restores Focus; expanded routing supports the same drag/snap/unplug paths. + +## Acceptance gate + +1. Zero-dependency model contract in `smoke.test.cjs`, including default, display-only mode changes, layer order and reset. +2. Dedicated Chromium Playwright test `visual_wire_v30_views_qa.py` at 1366×768, 1680×900 and 1920×1080: four actual routing fixtures, default Focus 2-IN/1-OUT, OUT 0-IN/1-OUT, ALL one faint unrelated route plus focus, unchanged socket/fader state, collapsed zero-cable SVG and expand restoration. +3. The reference-only PR GitHub Actions workflow runs the V30 test after V29. CI outcome must be verified separately. No production engine/pixel/PCM qualification is claimed. diff --git a/design-references/audition-mixer-study/V31_GRAVITY_HANGING_WIRE_20261102.md b/design-references/audition-mixer-study/V31_GRAVITY_HANGING_WIRE_20261102.md new file mode 100644 index 000000000..c9cc62640 --- /dev/null +++ b/design-references/audition-mixer-study/V31_GRAVITY_HANGING_WIRE_20261102.md @@ -0,0 +1,23 @@ +# ArSonMix V31 — Top patch bar with gravity-hanging signal cables + +Date: 2026-11-02. PR #278 isolated browser reference; **NOT** native audio. + +## Visual and interaction contract + +- OUT solid pin, recessed IN socket and WIRE gain knob stay in their current fixed 24/28/22px grid, now at the **TOP** of each expanded WIRE compartment. +- The remaining WIRE compartment below the controls is a neutral dark suspended-cable canvas. Remove duplicate painted words/labels from that open stage; channel identity remains in the existing header badges. +- Every connection is a downward-draping catenary-inspired cubic Bézier: OUT starts down, IN terminates up, left-to-right and right-to-left both behave identically. +- Sag scales sublinearly with horizontal distance and is clamped to actual available WIRE stage height. It must **never enter PAN/fader**. The previous upward 164px arch is eliminated. +- A compact damped spring runs for **at most 24 animation frames** after accepted new/rerouted cable, with no global timer, permanent animation loop or audio-thread effect. Respect OS reduced-motion. Drag preview, magnetic snap and unplug preserve the existing V23–V26 interactions. +- Collapsed WIRE remains 23px high; no connectors/cables outside it, only original DOT/socket summary. Focus, OUT only, All display options unchanged. +- Preserve V30 graphite keycaps, PAN, FX sizing, fader asset and graph/mult/Bus-only semantics. + +## Research + +Image-Line FL Studio Mixer Menu describes optional **Routing cables** with “Jiggly goodness”, while mixer guide describes directional track routes and selected-source sends. ArSonMix's curve and spring are a fresh interpretation rather than copied FL Studio source code. + +## QA + +- Full deterministic model smoke plus dedicated Chromium `visual_wire_v31_gravity_qa.py` across 1366×768, 1680×900, 1920×1080. +- Verify node rectangle above cable stage; Bézier control points and midpoint sag below endpoints; bottom depth bounded by WIRE; forward and reverse links; All and fold controls; zero browser errors. +- Legacy V15/V18/V19/V22/V26/V29/V30 workflows must remain green before promoting preview. diff --git a/design-references/audition-mixer-study/V32_CROSS_BANK_CONTEXTUAL_WIRE_20261102.md b/design-references/audition-mixer-study/V32_CROSS_BANK_CONTEXTUAL_WIRE_20261102.md new file mode 100644 index 000000000..a922add38 --- /dev/null +++ b/design-references/audition-mixer-study/V32_CROSS_BANK_CONTEXTUAL_WIRE_20261102.md @@ -0,0 +1,20 @@ +# V32 — Local soft-wire settle + cross-bank smart patch + +Scope: **PR #278 browser GUI reference only**, not native ASIO / DSP / PCM. Existing top-mounted OUT/IN connectors, stable patch-bay row, V30 Focus/OUT/All and realistic keycaps remain intact. + +## User scenario +1. Select CH01 **OUT**. This explicitly pins the source until a new OUT is selected or Escape unpins it. Selecting another strip's ordinary fader or name cannot silently retarget an active patch. +2. Navigate BANK Next to CH11. The compact WIRE ledger says **FROM CH01 · Track 1 ↶** and **Click any IN on this bank**. The source chip returns to its bank without changing routing state. +3. Existing edges (including active legacy SEND slots) enter from a small colored boundary socket. The **FROM CH01** source identity stays in the fixed header; no micro-label may overlap the hanging cable. Never draw a fictitious line to a hidden channel's arbitrary onscreen x-coordinate. +4. Click an IN on a remote bank: the same validated graph is used; duplicate SEND and feedback cycles remain blocked. Bus destination still requires VIA BUS ONLY / PARALLEL decision. CH01→CH11 is already enabled in the demo's legacy SEND slot; the IN is explicitly linked and duplicate insertion explains **ALREADY CONNECTED**. CH03→CH11 demonstrates a new parallel route. +5. Returning to source bank preserves links and selection. The full routing remains independent of bank display. + +## Animation and performance +- The V31 global `wireSpring` made all visible edges wobble simultaneously. V32 gives an active key `sourceId-destId` to only the newly committed edge. +- Maximum motion 2.8 SVG units, exponential decay with one gentle settling phase, at most 18 `requestAnimationFrame` callbacks; accepts `prefers-reduced-motion`. +- Cache measured edge endpoint coordinates per layout render; each animation frame calls `setAttribute('d', ...)` only for SVG paths belonging to that edge (stroke and shadow). Other cable DOM, all mixer strips, racks, faders, and audio data never rebuild on the animation frame. +- A new accepted route invalidates the previous motion token. Collapsed WIRE clears paths; hidden-bank edges have no artificial canvas. +- Long cables are bounded by actual patch-bay compartment clearance; PAN remains untouched. + +## Acceptance +Run `node design-references/audition-mixer-study/smoke.test.cjs` and `python design-references/audition-mixer-study/visual_wire_v32_cross_bank_qa.py` as well as the V15–V31 Chromium suite. Test full bank changes and linked legacy SEND, proper source persistence, independent wire path mutation counts, genuine Bus route choice, and return-to-source. Publish only after all checks succeed. diff --git a/design-references/audition-mixer-study/V34_OPERATOR_INTENT_AND_FINE_SEND_20261102.md b/design-references/audition-mixer-study/V34_OPERATOR_INTENT_AND_FINE_SEND_20261102.md new file mode 100644 index 000000000..b2601d966 --- /dev/null +++ b/design-references/audition-mixer-study/V34_OPERATOR_INTENT_AND_FINE_SEND_20261102.md @@ -0,0 +1,42 @@ +# V34 — Operator-Intent WIRE and Fine SEND Gesture + +Date: 2026-11-02. Scope: PR #278 isolated GUI reference, **not** JUCE native routing, PCM, ASIO, VST3, or a production release. + +## Decision grounded in professional console workflow + +FL Studio's official mixer reference separates the **source → destination send switch → per-link gain** from external I/O. For a live operator mixer, ArSonMix goes one step safer: **ordinary channel focus never arms or retargets a patch**. Only the WIRE OUT node can deliberately pin a source; receiving IN sockets, universal destination picker and MAIN toggle require that pin. Fender Studio Pro-style adaptive console layout remains intact; no DAW timeline, new routing matrix or second per-strip SEND panel. + +Official reference: https://www.image-line.com/fl-studio-learning/fl-studio-online-manual/html/mixer_iorouting.htm + +## User tasks and contract + +| User task | Expected operation | Never allowed | +| --- | --- | --- | +| Mix normally | Click channel, FX, fader, PAN, MUTE/SOLO; WIRE stays dark when idle | Silent update of patch source or graph | +| Open patch | Expand WIRE, explicitly click OUT on a source | Selecting a channel alone arming OUT | +| Connect | Choose receiver IN or drag from OUT; accept cycle/duplicate/BUS role checks | Clicking idle IN to modify any graph | +| Multiple channels/banks | Keep explicit source pinned while moving bank, show named FROM and any-bank destination picker | Invent visual cable to invisible channel positions | +| Inspect | Header and focused cables only after source armed | Dense colorful wires on normal mixer selection | +| Send gain | Compact tactile knob, drag ~3 px/dB or Shift ~14 px/dB, step 0.1 dB, wheel 0.5 dB, double click unity | Short 22px travel, changing a different link | +| Cancel | Pointercancel restores original knob gain; Escape disarms WIRE; no accidental connection | Mutating graph on cancelled routing gesture | + +## Implementation guard rails + +- `selected channel` (mixer inspection) is not `wireSourceId` (active patch origin); source is considered **armed** only when both `wireIntent` and `wireSourcePinned` are true. +- `wireTray`, focused legend, rendered paths, receiving IN, MAIN toggle, and universal bank picker use the same intent gate. +- Existing `wireEdges`, `sendSlots`, primary OUT and split projection remain compatible; the browser still has multiple read-only routing projections, **not yet** a unified accepted native signal graph. +- Legacy send cannot silently create a duplicate wire. BUS routing requires explicit Route Only or Parallel choice. +- Background paths remain restricted to the WIRE compartment. V32 per-edge geometry cache/settle, gravity-hanging arc and reduced-motion gate are retained. +- 22×24 knob footprint does not change strip geometry; 30×64 metal fader thumb and pinned MAIN stay. +- No UI animation or pointer work in audio callback: this isolated reference has no PCM. +- No claim that a browser mock or fake LED meter proves native sound. Real integration requires accepted graph ACK/revision/epoch and Windows physical FAT. + +## Evidence and release gate + +- `smoke.test.cjs` verifies that idle IN, ordinary channel selection, existing route projection and explicit source actions cannot accidentally patch. +- `visual_wire_v34_intent_qa.py` drives real Chromium pointer gestures for idle/armed state, 0.1 dB Shift fine adjustment, cancel rollback, pinned cross-bank source, Escape and view-only switch at 1366×768, 1680×920, 1910×912 and 1920×1080. +- The established V15/V18/V19/V22/V26/V29/V30/V31/V32 Chromium suites must also pass on one pinned commit. +- PR #278 stays **Draft** until exact-SHA CI plus owner physical visual review. Public preview should not be promoted until V34 acceptance. +- Next: native V35 requires stable typed edge ID graph (SERIAL GROUP, PARALLEL SEND, SPLIT, LEGACY projection, hardware port), snapshot/SoF authority, accepted ACK and no false live status. + +Do not merge or publish the reference as a native audio feature. diff --git a/design-references/audition-mixer-study/V5_VISUAL_RECOVERY_AND_VST3_MANAGER_CONTRACT.md b/design-references/audition-mixer-study/V5_VISUAL_RECOVERY_AND_VST3_MANAGER_CONTRACT.md new file mode 100644 index 000000000..d84b38e9f --- /dev/null +++ b/design-references/audition-mixer-study/V5_VISUAL_RECOVERY_AND_VST3_MANAGER_CONTRACT.md @@ -0,0 +1,32 @@ +# ArSonMix Preview V2 → V5: Visual Recovery & Plugin UX Contract +Date: 2026-11-01 · PR #278 · Isolated reference GUI, NOT a running native mixer. + +## Owner's actual screenshots and correction +The old `/preview/` fader/meter was visually richer; V4 `/preview-v2/` had a broken draggable fader, blurred/oversized thumb, cyan-illuminated machined slot, overcompressed IN/OUT, docked Plugin Manager that obscured channels, Add FX opening the wrong screen, and redundant TRIM. + +V5 makes the **existing** live-console workflow less noisy without reintroducing a DAW editor/timeline: +1. **Fixed fader:** one source of truth for gain `-60…+10 dB`, cap `--fader-y`, original silver/rose PNG, 29×62 proportional size, pointer drag/capture and keyboard-accessible input, matched gain ruler. The current demo dBFS meter is simulated, with 0…−60 dBFS scale, independent of fader gain. The old 36×77 original PNG is embedded once (rendered proportionally smaller). Physical slot uses black graphite only; RAIL3 cyan glow explicitly disabled. +2. **Visual hierarchy:** FX rack height responsive to screen, MUTE/SOLO/PFL direct and same BTN-180 manual material, slim fader, no TRIM/EQ row/Input I/Send stereo PAN. Source IN/OUT separate 24px rows with full-height selects and clearer contrast. Ten fixed-width channel slots plus one equal-width pinned Master; a one-channel last bank does **not** stretch. +3. **Add FX fast picker:** clicking an insert opens a short floating contextual list anchored to that specific channel and insert index; typing narrows effects; clicking an item inserts and closes; F8 opens **Plugin Manager**, not the insert picker. +4. **Plugin Manager:** standalone floating card, not a bank dock; browsing/search, favorites, hidden entries, recent, metadata import, path list and Scan action. It does not steal channel width or change bank paging. +5. **PAN center:** physical PAN thumb/center-origin bar with ±8 click/drag center snap. Double-click PAN resets to center. + +## Plugin Manager source-of-truth vs native integration +Official workflow benchmarks: [Image-Line FL Studio plugin scanning / Verify](https://www.image-line.com/fl-studio-learning/fl-studio-online-manual/html/basics_externalplugins.htm), [FL Studio F8 Plugin Picker](https://www.image-line.com/fl-studio-learning/fl-studio-online-manual/html/browser.htm), [Adobe Audition Audio Plug-in Manager](https://helpx.adobe.com/audition/desktop/applying-effects/adding-third-party-plug-ins.html). + +**Default Windows VST3 discovery root:** `%COMMONPROGRAMFILES%\VST3` (commonly `C:\Program Files\Common Files\VST3`). Standard VST3 installation paths should always be scanned. An additional VST3 folder can be supported by ArSonMix's own native scanner if authorized by the user, but note that Adobe and FL Studio document *custom directory settings primarily for legacy VST/VST2*; do not assume clicking "Add folder" makes VST3 discoverable through the OS default path. Display a rescan/verify workflow for changed installations. + +**Security & performance implementation contract for native ArSonMix host (NOT a GitHub Pages capability):** +- Expose a trusted native Plugin Management service independent from the realtime ASIO audio callback. The front-end adapter defined here is `window.ArSonMixNativePlugins.scan({paths: string[], verify: true})`; this must be provided by the actual native host or replaced by its documented typed bridge. The source demo has no host adapter and must report that explicitly. +- Enumerate `.vst3` bundles in approved locations outside the audio thread; verify each plugin as an **effect**, its stable VST3 class ID, vendor, layout/I/O, compatibility, architecture, and plugin load status. Categorize effects vs instruments, reject instruments from FX inserts, preserve favorites and a stable unique plugin identity across renames/restarts. +- Isolate or supervise scanner faults/hangs, record plugin failures as failed/unavailable without crashing the mixer; rescan updated plugins on explicit command; do not load an untrusted plugin merely by importing JSON metadata. +- Pass a validated catalog to `ArSonMixReference.setPluginCatalog([...])` in this reference prototype; production must use accepted `ConsoleSnapshot/Intent/Ack` and a real VST3 lease on native engine. A demo catalog entry must **never** be mistaken for a loaded VST3 effect. +- Manage file paths only with explicit user choice; do not silently crawl arbitrary folders. Physical plugin scanning/instantiation cannot occur on GitHub Pages. + +## Verification and open gate +- 121/121 zero-dependency DOM/workflow tests, including actual pointer-drag simulation, FX picker open/search/insert, PAN center snap, shared Master width, and no bottom scrollbar: **PASS**. +- Embedded script parsed and CSS brace balance checked. +- Real Chromium screenshot/pixel QA of this V5 reference **NOT EXECUTED** here; full visual signoff across 1366×768, 1680×900 and 1920×1080 remains open. Native VST3 installation/scan and live audio are **NOT IMPLEMENTED** by this reference branch. +- The preview is a snapshot published through the existing Pages train only; `/preview/` legacy production GUI remains untouched. + +**Next production integration gate:** native scanner/validation + live VST3 catalog and loading, native Console intent/ACK, and Windows hardware-first PCM qualification; this cannot be certified by static HTML. diff --git a/design-references/audition-mixer-study/V6_CONSOLE_VISUAL_IDENTITY_SYSTEM_20261101.md b/design-references/audition-mixer-study/V6_CONSOLE_VISUAL_IDENTITY_SYSTEM_20261101.md new file mode 100644 index 000000000..94e9eb796 --- /dev/null +++ b/design-references/audition-mixer-study/V6_CONSOLE_VISUAL_IDENTITY_SYSTEM_20261101.md @@ -0,0 +1,50 @@ +# ArSonMix V6 — One Console / One Material: Visual Identity System + +Date: 2026-11-01 | Isolated PR #278 | Main Preview export route `/preview-v2/` + +## Visual authority and nonnegotiables + +**Visual material:** historical `web/styles-src/20-button-180.css`, old mixer VU/fader PNG and RAIL3 geometry, and `web/app.js` `channelIcons`/`channelPalette`/`strip-name` identity. **Workflow authority:** new operator-first ten-channel bank, top bank arrows, FX direct insertion, PFL and snapshot. The old DAW editor/timeline and automation workflow remain out of scope. + +Previous V5 had a split personality: the upper route/FX looked like dark web-form tables while the lower fader area resembled machined hardware. V6 adopts **one graphite/navy metal chassis and one crystal/plastic button material** across the complete channel height. Bright chromatic blocks are reserved for **channel identity** at both ends, meter/signal/clip states and active command states; they must not be repeated on every FX row. No oversized font/card or unsupported GUI decoration. + +## Theme tokens (implemented in the V6 HTML) + +| Role | CSS token | Color | Visual behavior | +| --- | --- | --- | --- | +| Backplate | `--am-metal-base` | `#0B161E` | Negative space between strips | +| Channel panel | `--am-metal-panel` | `#14232C` | Route / sends / FX tonal unity | +| Elevated tool surface | `--am-metal-raised` | `#20313B` | Top toolbar and popovers | +| Fine divider | `--am-metal-edge` | `#334956` | One-pixel borders; no fat frames | +| Machined opening | `--am-metal-inset` | `#030A0F` | Realistic slot, no cyan glow | +| Primary text | `--am-text-primary` | `#DAE9EF` | Readable but non-glowing text | +| Secondary text | `--am-text-muted` | `#94B1BD` | Only supplemental metadata | +| Interactive focus | `--am-accent` | `#66CBDD` | Focus/selection, not ambient glow | +| Off-state plastic | `--am-crystal` | `#E7EFF0` | Brighter off BTN-180, same original 7-shadow recipe | + +## Channel identity (copied from historical app) + +Top nameplate: **CH XX / channel name / icon**. Bottom plate: **channel name / icon**. Both share `--ch` derived from the track's stable `color` field and use the same color-mixing ratio/graphite support. The extra top band has its own matching left section-rail band, preventing the common misaligned-section regression. The entire strip remains equally sized, including the pinned MASTER and incomplete CH11+ banks. + +Original approved icon list (in order): `♩ ♫ ♬ 🎙 🎸 🎹 🥁 🎧 ▥ ◉ ◎ ⊞`. +Original approved palette (in order): +`#1699CD #B92E41 #CF6B1E #B28C27 #34A544 #168762 #0E95C9 #066FA9 #7140B5 #B52893 #C32974 #586889`. + +Click either channel identity strip to edit **name, icon and color** via one lightweight anchored popover (same operation pattern as the old `openChannelIdentity()`). Rename updates output and every send-slot route referencing that name, avoiding a silent broken routing graph. Duplicate/empty channel names rejected. Current session fields are preserved by snapshot copy/recall. + +## BTN-180 and toolbar rule + +- `web/styles-src/20-button-180.css` original surface is already bundled in the reference. V6 brightens **OFF only** to `#E7EFF0`, preserving edge color, inset/outside shadows, 1px pressed travel, and semantic ON faces (MUTE red / SOLO yellow / PFL cyan). +- Apply to all header **buttons**, including More menu. Keep selects as dark inset console controls. Avoid fake VST/DAW controls. +- All header controls have the same **29px height** and are center-aligned against the 44px toolbar. Text line-height is 1; SVG bank arrow is vertically centered as a 20px icon. Preserve the user's exact SVG path data: left `M14,17L9,12l5-5V17Z`, right `M10,17V7l5,5l-5,5Z`; use `currentColor` so disabled/hover color is consistent. +- Header state color only appears on active `aria-pressed` actions; route/FX forms remain quiet in dark metal. + +## Quality gates + +Passed: **132/132** existing and V6-specific zero-dependency DOM/business interaction checks, including original 12-icon palette, same-color top/bottom identity, exact arrow paths, toolbar BTN-180 styling, live Bus rename routing migration, original fader pointer drag and fast FX picker. Embedded JS parses; CSS braces balance. + +**Not certified:** pixel screenshot equivalence on Chromium at 1366/1680/1920, perceived color contrast on user hardware, native realtime VST3 and true meter precision. V6 is an HTML GUI reference, not an ASIO audio engine. Keep PR Draft and separate from production GUI/engine threads until a native integration gate. + +## Preview acceptance checklist + +At desktop size: 10 source strips + one pinned Master equal-width, stable section edges, header buttons centered, channel bands same exact hue on top and bottom, 29px aligned 3-way MUTE/SOLO/PFL; FX Add opens fast picker without Plugin Manager; change icon/name/color via identity editor and see both nameplates update; group/sends/snapshot retain behavior; pan center snaps; fader drag updates the cap and LCD. For CH11/Bus A arrow, never widen one strip. Verify no bottom horizontal scrollbar and no clipped IN/OUT. diff --git a/design-references/audition-mixer-study/V8_ADAPTIVE_BANK_COLLAPSE_ACCEPTANCE_20261102.md b/design-references/audition-mixer-study/V8_ADAPTIVE_BANK_COLLAPSE_ACCEPTANCE_20261102.md new file mode 100644 index 000000000..9bae4a2c5 --- /dev/null +++ b/design-references/audition-mixer-study/V8_ADAPTIVE_BANK_COLLAPSE_ACCEPTANCE_20261102.md @@ -0,0 +1,35 @@ +# ArSonMix V8 — Adaptive Bank Geometry and Collapse Integrity + +Date: 2026-11-02 | Owner-selected isolated GUI reference PR #278 | GUI only + +## Regression addressed + +1. **Density was partly cosmetic:** a single hardcoded 130px source-bank divisor ignored Comfort / Standard / Compact and could compress an intended senior-accessible channel below its chosen minimum. +2. **Bank width used the wrong rail budget:** width was calculated with 28px even though the actual console rail is 32px; source strips and pinned MAIN could differ slightly. +3. **Create Channel / FX Return / Bus could select an offscreen channel:** horizontal scrollbar is intentionally suppressed, so the prior `scrollLeft=99999` did not reveal newly created items. +4. **Collapse visually clipped children instead of hiding them:** expanded-specific `display:grid!important`/`display:block!important` declarations overrode earlier collapsed rules for Route and Send. The 23px collapsed area showed partial controls that looked overlapped. + +## Implemented + +- `DENSITY_WIDTH={comfort:150,standard:125,compact:105}`; bank capacity is bounded by an actual section-rail-adjusted width budget, with 2px total subpixel tolerance near the 1680px breakpoint. Maximum **10 channel slots + one pinned same-width Master**, never a giant single last-bank strip. Remaining slots on a partial bank stay reserved. +- `bankGeometry()` is the single source of available width for capacity and the pinned MAIN CSS variable; a floating Plugin Manager does **not** decrease bank capacity. +- `setDensity()` retains the leftmost visible channel as a bank anchor as page size changes; channel reorder is not performed. +- `revealTrack()` makes a newly created channel visible on its correct bank before presenting it as selected; user filters revert to All if necessary to reveal the newly created role. +- Targeted final CSS rules hide Route fields / FX rack / Send controls on collapse rather than merely clipping their container. The rail and source sections share the exact `--route-h`, `--fx-h`, and `--send-h` tokens. +- Existing pointer-capture fader behavior, legacy hardware artworks, icon palette, channel identity, FX picker, M/S/PFL, Sends on Faders, Group, snapshots and one-window Manager remain untouched. + +## Verification performed + +- **150/150** zero-dependency smoke assertions passed in the JavaScript harness, including new 1366px geometry scenarios: + - Comfort: seven source strips plus Master; `--channel-w` ≈ 166.75px. + - Standard: nine source strips plus Master. + - Compact: ten source strips plus Master. + - 1180px Comfort: six readable strips plus Master. + - 1680px Comfort: ten source strips plus Master at ≈ 149.82px (within 2px total rounding tolerance). + - Newly added audio, bus and FX Return visible on their bank. + - Collapsed content rules are present with higher CSS specificity and `!important`. +- This is **DOM, source and deterministic width-budget verification**, **not** rendered Chromium screenshot or OS/native evidence. CSS geometry still needs a rendered screenshot review at 1366×768, 1680×900, and 1920×1080, with Route/FX/SEND individually and jointly expanded; compare against operator screenshot. + +## Native contract and publishing + +GUI reference only; do **not** merge the entire isolated prototype into production `web/**`, call demo meters live, or claim genuine VST3/ASIO. ARD v5.2 §K and PRD v5.2 §9 remain normative. Publish isolated source under `/preview-v2/` for visual review, keeping `/preview/mixer.html` and actual native production files untouched. diff --git a/design-references/audition-mixer-study/V9_FX_GLASS_MULT_OPERATOR_ACCEPTANCE_20261102.md b/design-references/audition-mixer-study/V9_FX_GLASS_MULT_OPERATOR_ACCEPTANCE_20261102.md new file mode 100644 index 000000000..373630e3a --- /dev/null +++ b/design-references/audition-mixer-study/V9_FX_GLASS_MULT_OPERATOR_ACCEPTANCE_20261102.md @@ -0,0 +1,62 @@ +# ArSonMix V9 — Elastic FX Rack, Console-Glass Meters & One-to-Four Channel Split + +Date: 2026-11-02 | Owner-selected GUI reference PR #278 | Normative native boundary: PRD v5.2 §9 and ARD v5.2 §K. + +## Operator-visible changes — isolated prototype, not audio + +### 1. Section collapse must pay back FX rack, NOT resize live fader + +- The fader remains at a deterministic physical height `--fader-fixed-h:clamp(198px,31vh,300px)` whenever FX is expanded; its thumb/pointer travel, dB gain ruler and native-equivalent meter framing are not remapped by Route/Send toggles. +- The FX rack is now the only elastic vertical section: `flex:1 1 var(--fx-h)`, with a scrollable occupied-insert list and one Add FX row. Route/Send/identity/Pan/M-S-PFL/footer remain fixed height. Identical constraints are applied to the left section rail and Master. +- Collapse Route (~76px → 23px) -> FX receives reclaimed pixels. Expand Send (~23px → 103px) -> FX gives up those pixels, with no fader motion. If FX is itself intentionally collapsed, the fader can use the remaining space as a special case. +- The <680px-height media rule lowers the physical fader height and upper row dimensions to preserve visibility; never claim a physically usable mixer at arbitrarily tiny windows without layout review. + +### 2. Meter as a recessed glass LCD instrument, not generic HTML VU + +- Preserve independent stereo L/R LED lanes, mono single lane, independent dBFS ruler, clipping LED and segmented fixed green/yellow/orange/red bands. Do not confuse meter dBFS with fader gain dB. +- New multi-layer glass reflections at low alpha, milled recessed frame, colored luminous LED fill, high-contrast dBFS scale and dedicated illuminated clip lens. All are static CSS; each meter refresh still updates only the `--lit` property. No backdrop blur, canvas repaint, layout animation or WebAudio meters. +- Fader retains original silver/rose PNG assets and its machined dark rail, with matching satin-metal plates across Route/FX/Send/Pan and improved FX row readability. Physical source remains simulated in this reference. + +### 3. CH1 → CH2/CH3/CH4/CH5 one-to-many split / mult (visual reference) + +The consumer's request is **one source into four independent processing channels**. This is not `GROUP` (4 → 1), not `LINK FADERS` (control-only), and not `SEND → AUX/FX RETURN` (different role). The source channel is not replicated four times at the hardware-capture layer. + +Reference GUI supports independent selection on each target's **IN**: +`CH01 PRE-FX SPLIT` or `CH01 POST-FX SPLIT`. These are GUI-only channel-input labels based on the immutable numeric source identity (rather than mutable channel name); 4 target selections show a `⇢4` fanout indicator on CH1. Follow-up sources can be chained but self/cyclic split bindings are rejected. The source's `OUT` may use `SOURCE ONLY (No Main)` to avoid an automatic extra dry contribution to MAIN. All operations clearly report **demo/no PCM**. + +**Production contract — not implemented by V9**: + +```text +Physical/virtual IN (verified PortRef, deviceEpoch) + -> Input Channel CH1 (stable ChannelId, immutable PCM block) + -> TAP PRE_INSERT (before CH1 FX) OR TAP POST_INSERT (after CH1 FX, before fader) + -> ChannelSourceBinding(CH2, CH1 ChannelId, TapPoint) + -> ChannelSourceBinding(CH3, CH1 ChannelId, TapPoint) + -> ChannelSourceBinding(CH4, CH1 ChannelId, TapPoint) + -> ChannelSourceBinding(CH5, CH1 ChannelId, TapPoint) + -> optional CH1 direct OUT (explicit SOURCE ONLY disables direct feed) +Every receiver has independent FX inserts, fader, mute, pan, meter, primary OUT. +``` + +- Graph validation: reject alias/self/circular dependencies, duplicate audible Main edges, stale `deviceEpoch`/`baseGraphRevision`, incompatible width, phantom stereo pins, accidental +6 dB; device changes fail closed. +- Native structural update: validate and prepare off callback, publish immutable graph and issue `Ack(requestId,acceptedRevision)`, show LIVE only after PCM and output status verify. Multiple receivers can share a read-only source buffer, not multiply hardware capture callbacks. No allocations, locks, I/O or VST plugin loading inside realtime callback. +- Source-split from PRE/POST inserts must state exact latency compensation and headroom policy. Reconcile with serial GROUP, FX Return, independent MAIN/MONITOR and Show/snapshot. One-to-many fanout does not imply source fader changes receivers; choice of tap is explicit. +- Native GUI team owns `IN` picker + pending/ACK display; engine owns source fanout PCM + graph validation + PDC; integration/FAT owns audible four-receiver test with independent processor and output and a 30min 0FX acoustic baseline. + +## Quality gates + +Reference `smoke.test.cjs`: **162/162** DOM/behavior checks passed at V9 base, plus Source Only scenario to be confirmed at subsequent exact SHA; no native audio tested. Existing Chromium CI for previous V8 must not be reused as proof of V9. V9 must be independently rendered at 1366×768, 1680×900, 1920×1080. For every viewport test: + +1. Fader height before/after Route collapse changes by ≤1px; FX height increases at least 40px. +2. Fader height before/after Send expand changes by ≤1px; FX height decreases instead. +3. Verify rail/channel/Master section edge alignment; no overlap, no truncated route or long FX strings; FX list scrolls when full; the last bank never creates a giant single channel. +4. Verify meter glass in real Chromium with source image comparison, at idle and demo level; never claim 'prettier than reference' without a human screenshot review. +5. Repeat density Comfort/Standard/Compact and plugin manager overlay tests. Headless Chromium gate is necessary, not sufficient for user visual signoff. + +## Official UX references + +- Waves eMotion LV1 classic User Guide: https://assets.wavescdn.com/user-guides/emotion-lv1-classic-console-user-guide.html +- Waves LV1 Sends on Faders: https://www.waves.com/emotion-lv1-tutorial-4-9-mixer-window-aux-mode +- Fender Studio Pro effects and multing: https://fenderstudiopromanual.fender.com/en/Content/Mixing_Topics/Effects_Signal_Routing.htm + +**Status: isolated GUI reference. No real Native ChannelId consumer/PCM, audio callback change or physical VST3 processing in this PR.** diff --git a/design-references/audition-mixer-study/VISUAL_RECOVERY_STRATEGY_V3_20261101.md b/design-references/audition-mixer-study/VISUAL_RECOVERY_STRATEGY_V3_20261101.md new file mode 100644 index 000000000..53bd38232 --- /dev/null +++ b/design-references/audition-mixer-study/VISUAL_RECOVERY_STRATEGY_V3_20261101.md @@ -0,0 +1,98 @@ +# ArSonMix Preview V2 — Visual Recovery v3 / Asset Reuse Contract +**Date:** 2026-11-01 · **Owner:** isolated reference GUI / PR #278 · **Status:** implementation specification; NOT yet visual acceptance. + +## 0. Decision and authority + +This decision follows the owner's actual screenshot `image(20261101-080701).png` (1817×1005 browser frame), PRD v5.2 §9, ARD v5.2 §K, and the existing *approved native GUI asset pipeline*. The owner accepts the general single-window LIVE-console workflow, but **rejects the current visual styling, density, eye fatigue, insufficient precision and artificial CSS slider art**. No new product design, DAW timeline, reworked native DSP or another mock audio runtime. + +**Design direction:** **Adobe Audition** for clean vertical channel hierarchy + section show/hide; **Studio One** for compact rack grouping / quick FX selection and console operations; **Waves eMotion LV1 v17** for operator-first fader focus, layers/modes and customizable information density. **ArSonMix original artwork** is the source of material identity. These are workflow inspirations, not a mandate to copy a third-party application’s copyrighted skins. + +**Critical safety:** PR #278 and `/preview-v2/` remain browser-only demos. There is no verified real VST3 instance, native meter, or live PCM. UI state changes cannot claim ACK or hardware changes. Keep PR Draft. + +## 1. Screenshot diagnosis — what is wrong, why it feels wrong + +| P | Visual observation in screenshot / audited DOM | Root cause | Required correction | +|---|---|---|---| +| P0 | Every strip shouts equally: routing labels, add-effect rows, toggles, tiny EQ graphs, pan and TRIM occupy the same visual weight. | No visual information budget / no priority distinction. The expanded rack across **all** channels multiplies the same empty controls. | **Fader first**, one strongest readout, one nameplate, one row of MUTE/SOLO; convert idle FX/EQ/SENDS to short summaries. Provide *mode/expanded* access on demand. | +| P0 | Main fader thumbs appear short and repeatedly metallic-painted; PAN thumb looks like a separate tiny widget. | Preview V2 invented CSS-drawn **48×27 px** fader thumbs and CSS **15×19 px** pan thumbs, replacing the approved PNG artwork. | Restore the **natural-size original 36×77 px** ARI thumb and **18×40 px** PAN-SLIDER exactly; retain actual cavity and center line. Do not recolor, stretch or apply filters at runtime. | +| P0 | Fader meter/scale arrangement and V2 dB limits are not the previously verified physical ruler. | V2 CSS grid `[scale][fader][meter]` and `+15…−60` differ from old verified `[left VU][fader][right ruler]` and native reference `+10…−60`. | Restore geometry and two independent calibration rulers; reconcile fader gain range with **actual native contract** before declaring parity; do not silently force `+10` if engine API differs. | +| P0 | Plugin Manager obscures several middle/right channel strips, even if Master is still visible. | `position:absolute` overlay is not allocated space in the bank viewport. | Desktop **docked inspector/drawer inside same Mixer window**, 300–340 px, **reserving bank width** when open; pinned MAIN stays visible; no overlay of any fader. Bank capacity recalculates only on drawer open/close or viewport resize. | +| P1 | Color accents repeat on every strip in fader track, number, trim, FX and footer; metallic grooves and gradients compete for attention. | No budget for bright elements; highly repeated panels/strong strokes create visual rhythm fatigue. | Use quiet graphite/steel surfaces; one meaningful accent per channel (nameplate + under-cap line); reserve red for clip/mute, yellow for solo, cyan for focused/active. Lower bezel and gradient contrast 40–60% from V2 visually; no gratuitous glow. | +| P1 | `1/8`, `+1 Add effect`, `+2 Add effect`… appear in many strips, and empty EQ graphs look as important as working channels. | Empty-list affordances repeated in each slot; static equalizer decoration in inactive channels. | Rack summary **`FX 2`**; when opened show occupied slots and **one `+ Add FX`** on first empty row; advanced slots via `Show all`. Show **EQ** label/active flag; curve only in EQ layer or selected channel, never decorative repeated waveforms. | +| P1 | Top bar contains dense labels and small `More`/bank/scene controls. The 150 px "Comfort" width alone does not fix readability. | Visual density was scaled by column width without redistributing information. | Use 2-tier hierarchy: always visible **source→MAIN, MUTE/SOLO, PAN, fader/meter**; FX/SENDS/EQ details are deliberate secondary layer; infrequent controls in one top More menu. | +| P1 | Tooltip-sized hints/abbreviations and numerous ~9–10 px labels are uncomfortable for seniors. | Too much metadata exposed at all times. | Body primary >= **12 px** on Comfort; key channel name >= **13 px**; dB readout 16–18 px; secondary >= **11 px**, meet WCAG 4.5:1 normal text where applicable; direct actions >= **24×24 CSS px** or equivalent WCAG spacing; prioritize ~30 px actions. | +| P1 | FX/SEND/EQ expand/collapse formerly misaligned and fader well grows/shrinks unpredictably. | Repeated CSS overrides across old base, media blocks and late `!important` patches. | **One source of truth** for section-height tokens per density, every rail/track/Master aligned; one relevant layer at a time by default, preserve independent explicit toggles. Measure computed bounding boxes in Chromium. | +| P2 | 3 density variants feel like 3 independently styled themes. | Repeated CSS selectors and conditional overrides. | Density controls **only size/spacing**; all roles use same component structure, source artwork and state palette. | + +## 2. Restore the actual existing ArSonMix assets — exact source inventory + +Assets **already checked into `main`**; do **not** draw replacement CSS thumbnails, search for third-party skins or create new derivative PNGs: + +| UI part | Exact canonical asset | Geometric contract | Code ownership/reference | +|---|---|---|---| +| Ordinary INPUT/Bus/FX fader | `web/assets/faders/FADER-ARI-SILVER.png` | 36×77 RGBA, render **natural dimensions**, black center detent at **y=38** | `web/styles-src/41-mixer-performance.css`, `42-mixer-premium.css`; `docs/ARI_FADER_ASSET_20261026.md` | +| Pinned MAIN fader | `web/assets/faders/FADER-ARI-ROSEGOLD.png` | 36×77 RGBA, same detent and travel | `docs/MIXER_10CH_ERGONOMIC_PASS_20261026.md`. **Use ROSEGOLD (not bright GOLD) unless owner explicitly prefers otherwise.** | +| PAN thumb | `web/assets/pan/PAN-SLIDER.png` | 18×40 RGBA, centered track and center detent, center-origin direction ribbon | `web/styles-src/40-rail-pan.css`, `docs/PAN_AND_BUTTON_UX.md` | +| MUTE/SOLO small physical buttons | `web/assets/buttons/SO-S-SLV.png`, `SO-S-RED.png`, `SO-S-YLW.png` | Preserve assets/aspect ratio and correct OFF/ON semantics. Touch *target* can be larger than visible PNG; never stretch into FX rows. | `web/styles-src/20-button-180.css`; `docs/PAN_AND_BUTTON_UX.md` | +| Fader recess, LED segments, tick calibrations | Existing authored CSS (no new PNG necessary) | VU bank **left**, physically calibrated fader **center**, dB ruler **right**, track dark **above cap**; RAIL3 cyan onset **below cap** with black falloff at bottom | `docs/FADER_MODULE_REFERENCE_AUDIT_20261027.md`, `docs/RAIL3_CYAN_FADE_TO_BLACK_20261031.md` | + +**Asset integrity note:** Historical docs have more than one vintage for ROSEGOLD and GOLD artwork. Verify **Git blob/decoded PNG bytes in current main**, image dimensions, hash and visual reference before pinning SHA; don't trust an old document hash without reconciling it. No image files/fonts exported from the system. + +**Architecture:** Create a reusable **presentational** `ArsonFaderArt` and `ArsonPanArt` component or equivalent local module in `design-references/audition-mixer-study/`. Import only the **visual behavior/material**; do not copy old runtime audio controls or event handlers. The current standalone `index.html` and `/preview-v2/` must render the same bytes; bundle local PNGs under `site/preview-v2/assets/` using a deterministic build step (or one build-time data URI per asset; not repeated per strip). Preview **must** work offline when its assets are downloaded as a bundle. Zero third-party CDN or font requests. + +## 3. A readable 150 px Comfort strip — visual hierarchy and information budget + +From top to bottom; all channels line up at the same vertical band boundaries: + +1. **Identity / ROUTE (priority 2):** one high-contrast channel name `VOCAL 1`; small Mono/Stereo flag; compact **IN → OUT** (e.g. `IN1 → MAIN`); detailed device path on hover/selection, never truncate a *critical* output without accessible full name. 1 line source + 1 line output maximum in normal mode. +2. **PROCESSING SUMMARY (priority 3):** compact `FX 2 · EQ · SEND 1` with status marks; **not** eight identical `Add effect` rows or full mini EQ graphs simultaneously on all strips. Show an active FX *name* when focused, not every long plugin title in every strip. One explicit global **ROUTE / FX / SEND / EQ** section rail mode, which reveals the relevant expanded band's controls across the bank while preserving fader alignment. +3. **PAN (priority 2):** one 18×40 original PNG slider; center snap; light band exclusively from C→left or C→right; full range accessible via keyboard; tiny L/C/R markers or value on focus, not multiple duplicate numbers. +4. **MUTE + SOLO (priority 1):** clear, >=30px high hit regions in Comfort; PFL always accessible but visually lower priority; never hide a critical safety action behind a More menu. +5. **FADER + LEFT LED + RIGHT GAIN SCALE (priority 1):** allocate the largest continuous area (target **>=48%** of visible strip height at 900px desktop; **>=260px** usable travel area when viewport permits). Single dB LCD just above fader, meaningful clip indicator. Reuse actual silver/rose-gold artwork; cap detent and scale must agree at **0, minimum and maximum**. +6. **Footer ID (priority 2):** high-contrast nameplate; one thin semantic channel-color strip only; status role/icon stays readable, no large saturated full-column backgrounds. + +**Initial view:** `Comfort + Mix/Fader layer`; show full faders, live meters, names, route summaries, pan, Mute/Solo/PFL. **FX/SENDS/EQ collapsed** by default. Expand a layer explicitly on left rail: on selection of FX, present per-bank real occupied inserts; avoid simultaneous large FX + Sends + EQ layout unless the operator explicitly opts into Expert/Expanded mode. Do not silently change any audio gain on show/hide. + +### Concrete width budget (Comfort 150px) +- Left VU bank **28px**, fader well **54px**, right gain ruler **25px**, two inter-column gaps **6px**, horizontal padding **8px** each side. Total **135px**, leaving **15px tolerance** for borders and scrollbar. +- Normal fader thumb stays **36×77 px** even in Comfort; achieve better usability by enlarged **invisible hit target**, not bitmap stretching. Maintain thumb black-center y=38; use the same center point to map pointer, keyboard and native gain readback. Native max/min must be the authority (current V2 demo `+15`, legacy reference `+10`: explicit unresolved mismatch). +- Meter is real fixed-zone green→yellow→red **only when PCM is available**; simulated animation stays clearly marked DEMO in browser preview. + +## 4. Non-negotiable behavior and performance + +- **Do not rewrite accepted Console UX:** Keep bank switching, role filter, pinned MAIN, per-strip input/output, mono/stereo processing independent of physical source, FX search/insert/reorder/bypass, Sends on Faders, cue/PFL, Snapshot Safe, copy/paste and channel selection. +- **Plugin Manager should not cover any active fader**: use an in-window docked panel with bounded width, independent scroll and a stable pinned MAIN. Opening closes no audio path and changes only bank geometry. `Escape` returns focus to invoking FX slot. +- Readability must not depend on hover, differentiating colors alone, mouse precision or visual memory of hidden modes. Preserve ARIA names, keyboard fader/pan + Enter/Escape, focus outlines, explicit OFF/ON. +- **No heavy repaint:** native-to-UI level/PCM meter updates touch only affected custom properties/text nodes; static original image is drawn once; no canvas repainting for a static fader, animated blur, image filter, per-strip requestAnimationFrame or whole DOM rebuild when dragging. +- **One authoritative source:** `design-references/audition-mixer-study/index.html` stays isolated reference; `web/**`, native bridge, engine and build are owned by their workstreams. Do not merge this DEMO as a real audio mixer. +- Pages `/preview-v2/` is a **snapshot** from reviewed PR #278, not a magic live branch view. The next visual milestone must update it via the **existing single Pages publisher** only after explicit source/visual QA; preserve `/preview/`. + +## 5. Meaningful delivery milestones, not micro-PRs + +### V3-G1: Reuse old hardware art **and calibrate** +In one batch replace new CSS fader + PAN with approved PNG components and restore VU-left/fader-middle/gain-scale-right, old RAIL3 cavity, silent-above-cap. Keep visual hit targets >=24px; no old runtime/DSP code. Verify image asset bytes, native fader contract and pan center snap. + +### V3-G2: One clean surface + plugin drawer +As a **single integrated UI slice**, remove repeated dummy FX/EQ rows, implement one active upper-mode layer, simplify top bar, maintain FX/SENDS/EQ accessibility, make Plugin Manager dock rather than cover faders, preserve horizontal bank/MAIN. All relevant controls remain discoverable within two deliberate interactions; Live Fader/MUTE/SOLO always one interaction. + +### V3-G3: Visual qualification, then **one** public Preview V2 update +- Browser pixel and bounding-box captures **1366×768**, **1680×900**, **1920×1080** at 100% zoom. +- For each density, test **Mix default**, **ROUTE expanded**, **FX expanded**, **SENDS expanded**, **EQ expanded**, **Plugin Manager open** and **Master pinned**. Ensure no overlaps, header wrap, clipped text, or hidden action; 10+ channels bank/scroll predictably. +- Reference snapshot test: real PNG must decode 36×77, PAN 18×40; fader-detent aligns with right ruler at 0/min/max and doesn't jump on pointer-down. Mono VU one physical meter, stereo separate L/R and clip; dBFS scale not confused with gain scale. +- Keyboard/interaction functional gate: pan center, FX reorder, mute/solo/PFL, Snapshot Safe, sends-on-faders preserving primary fader, plugin search and Escape; no regression to current 84/84 DOM checks. +- Accessibility: contrast >=4.5:1 for ordinary text where WCAG AA applies, core pointer targets >=24×24 or qualified spacing exceptions, 200% text zoom without losing *critical controls* as feasible with intentional banking. +- Performance: no continuous CSS animation in idle, no per-frame DOM replacement; compare pointer/fader responsiveness on integrated GPU and ordinary Windows machine before claiming performance PASS. +- Update `site/preview-v2/` **only once** after V3-G1/G2 pass; keep exact source SHA in `build.json`, run a single targeted Chromium screenshot workflow, and publish via the existing guarded main Pages pipeline. No new release/Windows CI merely for CSS. + +**Release gate:** User visual signoff only on an *actual rendered Preview V2 screenshot*, not CSS source diffs. Rejection means targeted redesign of the failing row, not new visual theme or whole-app rewrite. + +## 6. External engineering references + +- Waves official eMotion LV1 v17 (2026-09-01): https://www.waves.com/emotion-lv1-v17-news — fewer distractions, configurable mixer rows, focused parameters. +- Waves official LV1 Mixer window tutorial: https://www.waves.com/emotion-lv1-tutorial-4-1-mixer-window-overview — layers/modes and always-available faders/meters. +- Adobe official Audition mixer routing/EQ: https://helpx.adobe.com/audition/desktop/mixing-multitrack-sessions/multitrack-routing-eq-controls.html — Show/Hide Inputs/Outputs, Effects, Sends, EQ. +- Studio One console reference: https://www.soundonsound.com/techniques/using-studio-ones-mixing-console — Console, sections, scene view and visibility. +- WCAG 2.2 text contrast and pointer targets: https://www.w3.org/TR/WCAG22/ and https://www.w3.org/WAI/WCAG22/Understanding/target-size-minimum +- Internal approved art/calibration: `docs/ARI_FADER_ASSET_20261026.md`, `docs/RAIL3_CYAN_FADE_TO_BLACK_20261031.md`, `docs/FADER_MODULE_REFERENCE_AUDIT_20261027.md`, `docs/PAN_AND_BUTTON_UX.md`. + +> **Implementation checkpoint (2026-11-01):** V3-G1 original silver/rose-gold fader PNGs + pan PNG and VU-left/fader-middle/ruler-right layout are now implemented in PR #278; V3-G2 quiet default FX/SEND/EQ, **true paged 10-channel bank**, arrow-only navigation, hidden bottom scrollbar, and Plugin Manager reserved-width dock are implemented. A single Pages commit `44ff625` copied the reviewed source to `/preview-v2/`. The stable HTML/JS DOM regression suite is **98/98 PASS**. **V3-G3 rendered Chromium screenshot/geometric QA and native PCM/VST3 qualification remain unverified.** Historical old fader `+10 dB` vs V2 demo `+15 dB` scale is NOT reconciled with production native gain limits; the preview currently keeps its demo `+15 dB` control range and must not be called calibrated native parity. diff --git a/design-references/audition-mixer-study/assets/knob-ICON.svg b/design-references/audition-mixer-study/assets/knob-ICON.svg new file mode 100644 index 000000000..ef56513c6 --- /dev/null +++ b/design-references/audition-mixer-study/assets/knob-ICON.svg @@ -0,0 +1,12 @@ + + + + + + + + + + diff --git a/design-references/audition-mixer-study/assets/mixer-wire-dots.css b/design-references/audition-mixer-study/assets/mixer-wire-dots.css new file mode 100644 index 000000000..51bd2e57f --- /dev/null +++ b/design-references/audition-mixer-study/assets/mixer-wire-dots.css @@ -0,0 +1,52 @@ +/* V43 WIRE DOT OWNER — the 12px pin is the only OUT indicator. + Neutral graphite when idle; approach/armed changes PIN FILL, never adds + a second outer circle or glowing key housing. Kept in this one owner block. */ +.console-body.wire-routing-v15 .strip .wire-tray .wire-node-out, +.console-body.wire-routing-v15 .strip .wire-tray .wire-node-out:is(.is-near,:hover,:focus-visible,.is-source):not(:disabled){ + background:transparent!important;border:0!important;box-shadow:none!important; +} +.console-body.wire-routing-v15 .strip .wire-tray .wire-node-out .wire-pin{ + width:12px;height:12px;box-sizing:border-box;border-radius:50%; + background:#4b535b!important;border:1px solid #56636c!important; + box-shadow:inset 0 1px 0 #ffffff12!important;filter:none!important; +} +.console-body.wire-routing-v15 .strip .wire-tray .wire-node-out:is(.is-near,:hover,:focus-visible,.is-source):not(:disabled) .wire-pin{ + background:var(--ch,#83d7b5)!important;border-color:#a6e9ce!important; + box-shadow:inset 0 1px 0 #e6fff846,0 0 5px var(--ch,#83d7b5)!important; +} +/* Preserve the original magnetic IN ring and inner socket. The inactive + receiver is dark even when a committed wire exists. A hovered eligible + receiver or snap-target lights independently of prior click-to-arm: + dragging a brand-new wire must NOT keep the socket dormant. */ +.console-body.wire-routing-v15:not(.wire-intent):not(.wire-dragging) .strip .wire-tray .wire-node-in{ + color:#687881!important;border-color:#394a55!important; + background:#1b2b35!important;box-shadow:inset 0 1px 2px #07141c!important; + filter:none!important;opacity:1!important; +} +.console-body.wire-routing-v15:not(.wire-intent):not(.wire-dragging) .strip .wire-tray .wire-node-in .wire-arrow{ + background:#4b535b!important;border-color:#40505a!important; + box-shadow:none!important;filter:none!important; +} +.console-body.wire-routing-v15:not(.wire-intent):not(.wire-dragging) .strip .wire-tray .wire-node-in .wire-label{ + color:#687881!important; +} +.console-body.wire-routing-v15:is(.wire-intent,.wire-dragging) .strip .wire-tray .wire-node-in:is(:hover,.is-snap-target):not(.is-source){ + color:#c9f9e8!important;border-color:#90edbf!important; + background:#174433!important; + box-shadow:inset 0 2px 4px #0009,0 0 0 2px #61c99e77!important; + opacity:1!important; +} +.console-body.wire-routing-v15:is(.wire-intent,.wire-dragging) .strip .wire-tray .wire-node-in:is(:hover,.is-snap-target):not(.is-source) .wire-arrow{ + background:var(--ch,#8de1bc)!important;border-color:#c7ffe6!important; + box-shadow:0 0 5px var(--ch,#8de1bc)!important; +} +.console-body .strip.selected::after{ + border-width:1px!important;opacity:.58!important;box-shadow:none!important; +} + +/* The same original pin grows subtly while held; never create a second ring. */ +.console-body.wire-routing-v15 .strip .wire-tray .wire-node-out.is-drag-origin .wire-pin{ + transform:scale(1.27)!important;transform-origin:center!important; + background:var(--ch,#83d7b5)!important;border-color:#b1f6d7!important; + box-shadow:inset 0 1px 0 #e6fff846,0 0 5px var(--ch,#83d7b5)!important; +} diff --git a/design-references/audition-mixer-study/index.html b/design-references/audition-mixer-study/index.html new file mode 100644 index 000000000..1460e7423 --- /dev/null +++ b/design-references/audition-mixer-study/index.html @@ -0,0 +1,5823 @@ + + + + + + +ArSonMix — Live Console Reference + + + + +
+
Mixer · Reference SessionOPERATOR-FIRST · SINGLE LIVE CONSOLE REFERENCE
+ +
+
Live MixerCH01 · click destination arrows10 audio tracks · 1 bus · master
+
+ +
+
+
+ + + + +
+ +
+ + + \ No newline at end of file diff --git a/design-references/audition-mixer-study/smoke.test.cjs b/design-references/audition-mixer-study/smoke.test.cjs new file mode 100644 index 000000000..5cc402abe --- /dev/null +++ b/design-references/audition-mixer-study/smoke.test.cjs @@ -0,0 +1,1093 @@ +// Reference mixer state smoke; Node built-ins only. No DSP or visual verification. +// Run: node design-references/audition-mixer-study/smoke.test.cjs +const fs=require('node:fs'),path=require('node:path'),vm=require('node:vm'),assert=require('node:assert/strict'); +const html=fs.readFileSync(path.join(__dirname,'index.html'),'utf8'); +const script=html.match(/