# WAX Web helper (WaxWeb) **Canonical AI / author doc for Web Audio apps inside WAX.** Give models **this URL only** for the web path (not WordPress HTML, not contributor internals). | | | |--|--| | Helper script | `https://szfpro.github.io/CodeEditorHTML/wax-web.js` | | This doc | `https://szfpro.github.io/CodeEditorHTML/wax/docs/WEB.md` | | Native / hybrid graphs | [`NATIVE.md`](NATIVE.md) | **Requires:** WAX runtime ≥ 1.0.0, plugin ≥ 1.20.0 (helper **0.2.2+**). Inside the WAX plugin WebView, `WaxWeb` is usually **injected** — no ` ``` **Inside WAX / Custom Pages:** skip the ` ``` --- ## Raw globals (optional) Prefer WaxWeb. If you skip the helper: ```js window.WAX_DataTree.push(data, appName); // appName required await window.WAX_DataTree.pull(appName); window.WAX_Play / window.WAX_Stop / window.WAX_BPM window.WAX_RequestPlayheadInfo(); window.PlayheadInfo; ``` Same rules: whole-blob DataTree, pull before push. --- ## AI checklist before finishing a page - [ ] `WaxWeb.create({ appName })` with unique stable id - [ ] Correct script URL or plugin inject (no invented CDN); Custom Pages: omit CDN or end of `` - [ ] Audio via `wax.audio.input` / `output` / `connect` - [ ] DataTree: `setProvider` + `await pull()` + `canPush` gate + debounced `push(collect())` - [ ] No `subscribe` / `push(key,value)` / JUCE backends - [ ] MIDI automation uses `fromMIDI` guard - [ ] Sequencer sounds scheduled on AudioContext time - [ ] If you need native plugin DSP / `midinotein` → switch to [`NATIVE.md`](NATIVE.md) --- ## Do not - Call low-level bridge / emit APIs from page code - Share one `appName` across different devices - Label a Web Audio page “WaxNative” — use [`NATIVE.md`](NATIVE.md) for native graphs - Store meter/scope animation in DataTree - Put `wax-web.js` early in `` for Custom Pages when inject already provides `WaxWeb` (omit it, or load at end of ``)