@onda-lang/webaudio 0.8.4 → 0.8.6

package/api.md

@@ -135,12 +135,14 @@ endpoints, apply linear, logarithmic, or curved scale, and clamp and snap to the
 
 Complete wasm32 processor exports receive an optional execution-output descriptor containing
 independently nullable delegate and print batches. Allocate all descriptors and storage before
-real-time execution.
+real-time execution. Their linear-memory regions must be mutually disjoint and must not overlap any
+other region accessed by the processor call, matching the processor ABI's execution-output
+contract.
 
 `writeDelegateBatch` and `writePrintBatch` initialize reusable batch descriptors.
 `writeExecutionOutput` connects their addresses. Call `resetExecutionOutput` immediately before
-every generated init or process entry. Generated event entries reset after successful input
-preflight instead, so rejected input preserves existing records. After a successful generated call,
+every generated init or process entry. Generated event entries reset before input preflight, so
+rejected input returns empty batches. After a successful generated call,
 `readDelegateBatch` or `readPrintBatch` validates the result counters.
 `decodeDelegateRecords` converts delegate payloads using `metadata.delegates`.
 `decodePrintRecords` preserves primitive types and source sites; `formatPrintRecords` and
@@ -303,6 +305,7 @@ OndaPayloadSchema
 OndaPayloadDefault
 OndaPayloadValue
 OndaPayloadSizes
+OndaPayloadTensorMetadata
 PayloadPlan
 canonicalF32Number
 EVENT_INPUT_SIZE_BYTES
@@ -432,11 +435,21 @@ are rejected. Missing event arguments use declared constant defaults.
 Supply `i64` as `bigint`, an exact safe integer, or a decimal string. `decode(bytes)` returns named
 nested values with `bigint` for `i64`. Plans own immutable schema snapshots.
 
+`tensorMetadata` exposes the schema's flattened SoA contract without reparsing JSON. Each immutable
+record contains `path`, `encoding`, fixed `shape`, `parameterIndex`, `isSlice`, and
+`fixedElementCount`. Tuple path components use `__0`, `__1`, and so on. A slice's runtime tensor
+length is its logical length times `fixedElementCount`; the dynamic outer axis is therefore not
+repeated in `shape`.
+
 `requiredWorkspace(bytes)` preflights packed little-endian input. `sizes(lengths)` reports wire
 and aligned workspace sizes without allocating payload storage. Low-level wasm hosts provision
 both regions and a 16-byte descriptor, then call `writeEventInput` before invoking the event.
 Rejected input returns `PROCESSOR_EXECUTION_INPUT_REJECTED` (2) and leaves processor state usable.
 `OndaAudioProcessor.trigger` performs logical encoding before transferring bytes to the worklet.
+Web hosts intentionally have no unchecked tensor-view event entry: JavaScript values must cross the
+main-thread/worklet and Wasm linear-memory boundaries, so native borrowed addresses cannot be
+preserved end to end. Web event dispatch remains the packed, checked `onda_event_N` path and uses
+its preallocated workspace.
 Decoded `f32` leaves use `canonicalF32Number(value)`: the returned JavaScript number has the
 shortest decimal representation that round-trips to the same `f32`, so JSON and controls do not
 expose an irrelevant widened binary tail.

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@onda-lang/webaudio",
-  "version": "0.8.4",
+  "version": "0.8.6",
   "type": "module",
   "description": "Optional Web Audio adapter for Onda processor WebAssembly artifacts",
   "license": "MIT",
@@ -34,7 +34,7 @@
     "prepack": "node ../../scripts/stage-web-api-docs.mjs"
   },
   "dependencies": {
-    "@onda-lang/processor-abi": "0.8.4"
+    "@onda-lang/processor-abi": "0.8.6"
   },
   "publishConfig": {
     "access": "public"