cabbage-react 1.0.15 → 1.0.17

package/dist/cabbage/cabbage.d.ts

@@ -1,23 +1,78 @@
 export class Cabbage {
     /**
-     * Main entry point for sending any data from UI widgets to the Cabbage backend.
+     * Main entry point for sending widget value changes to the Cabbage backend.
+     *
      * This function automatically routes messages to the appropriate backend function
      * based on the automatable flag:
      *
-     * - automatable=true: Routes to sendParameterUpdate for real-time parameter control /
-     *                     this also sends the value as channel data to Csound
+     * - `automatable=true`: Routes to `sendParameterUpdate()` for DAW-automatable parameters.
+     *   The value is sent to the DAW for automation recording and also forwarded to Csound.
+     *
+     * - `automatable=false`: Routes to `sendChannelData()` for non-automatable data.
+     *   The value is sent directly to Csound without DAW parameter involvement.
+     *
+     * **When to use**: Call this from widget event handlers (e.g., pointer events, input changes)
+     * when the user interacts with a widget.
+     *
+     * **When NOT to use**: Do not call this when handling incoming `parameterChange` messages
+     * from the backend. Those messages are for display updates only.
+     *
+     * @param {Object} message - The message object containing widget data
+     * @param {string} message.channel - The channel name
+     * @param {number} message.paramIdx - Parameter index (required if automatable)
+     * @param {number|string} message.value - The value to send
+     * @param {Object|null} vscode - VS Code API object (null for plugin mode)
+     * @param {boolean} automatable - Whether this widget is DAW-automatable
+     */
+    static sendChannelUpdate(message: {
+        channel: string;
+        paramIdx: number;
+        value: number | string;
+    }, vscode?: Object | null, automatable?: boolean): void;
+    /**
+     * Internal: Send a parameter update to the DAW for automation recording.
+     * Use `sendChannelUpdate()` instead - it will route here automatically for automatable widgets.
+     *
+     * This function sends the parameter value to the DAW's automation system.
+     * The DAW will then send the value back via a `parameterChange` message,
+     * which updates both the UI and Csound.
      *
-     * - automatable=false: Routes to sendChannelData for string/numeric data transmission
+     * **Important**: This creates a round-trip through the DAW:
+     * 1. UI calls `sendParameterUpdate()` with value
+     * 2. DAW receives and records/processes the value
+     * 3. DAW sends `parameterChange` back to the plugin
+     * 4. Plugin updates Csound and sends `parameterChange` to UI
+     * 5. UI updates its display (but does NOT call sendParameterUpdate again!)
      *
-     * All widget interactions should use this function instead of calling the lower-level
-     * sendParameterUpdate or sendChannelData functions directly.
+     * @param {Object} message - The parameter message
+     * @param {number} message.paramIdx - The parameter index (must be >= 0)
+     * @param {string} message.channel - The channel name
+     * @param {number} message.value - The parameter value (full range, not normalized)
+     * @param {string} [message.channelType="number"] - The channel type
+     * @param {Object|null} vscode - VS Code API object (null for plugin mode)
      */
-    static sendChannelUpdate(message: any, vscode?: null, automatable?: boolean): void;
-    static sendParameterUpdate(message: any, vscode?: null): void;
+    static sendParameterUpdate(message: {
+        paramIdx: number;
+        channel: string;
+        value: number;
+        channelType?: string | undefined;
+    }, vscode?: Object | null): void;
     static sendCustomCommand(command: any, vscode?: null, additionalData?: {}): void;
     static sendWidgetUpdate(widget: any, vscode?: null): void;
     static sendMidiMessageFromUI(statusByte: any, dataByte1: any, dataByte2: any, vscode?: null): void;
-    static sendChannelData(channel: any, data: any, vscode?: null): void;
+    /**
+     * Internal: Send channel data directly to Csound without DAW automation involvement.
+     * Use `sendChannelUpdate()` instead - it will route here automatically for non-automatable widgets.
+     *
+     * Used for non-automatable widgets like buttons, file selectors, or
+     * any widget that sends string data. The value is sent directly to Csound's
+     * channel system and is not recorded by DAW automation.
+     *
+     * @param {string} channel - The Csound channel name
+     * @param {number|string} data - The data to send (number or string)
+     * @param {Object|null} vscode - VS Code API object (null for plugin mode)
+     */
+    static sendChannelData(channel: string, data: number | string, vscode?: Object | null): void;
     static MidiMessageFromHost(statusByte: any, dataByte1: any, dataByte2: any): void;
     static triggerFileOpenDialog(vscode: any, channel: any, options?: {}): void;
     static openUrl(vscode: any, url: any, file: any): void;

package/dist/cabbage/cabbage.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"cabbage.d.ts","sourceRoot":"","sources":["../../src/cabbage/cabbage.js"],"names":[],"mappings":"AAMA;IACC;;;;;;;;;;;;OAYG;IACH,mFAYC;IAED,8DAsCC;IAED,iFAiCC;IAED,0DAiBC;IAED,mGA6BC;IAED,qEAoCC;IAED,kFASC;IAED,4EA2BC;IAED,uDAsBC;IAED;;;;;;;;;;;OAWG;IACH,4BAPW,MAAM,UACN,MAAM,WACN,MAAM,QA4BhB;CACD"}
+{"version":3,"file":"cabbage.d.ts","sourceRoot":"","sources":["../../src/cabbage/cabbage.js"],"names":[],"mappings":"AAqFA;IACC;;;;;;;;;;;;;;;;;;;;;;;;OAwBG;IACH,kCANG;QAAwB,OAAO,EAAvB,MAAM;QACU,QAAQ,EAAxB,MAAM;QACiB,KAAK,EAA5B,MAAM,GAAC,MAAM;KACrB,WAAQ,MAAM,GAAC,IAAI,gBACX,OAAO,QAcjB;IAED;;;;;;;;;;;;;;;;;;;;;OAqBG;IACH,oCANG;QAAwB,QAAQ,EAAxB,MAAM;QACU,OAAO,EAAvB,MAAM;QACU,KAAK,EAArB,MAAM;QACW,WAAW;KACpC,WAAQ,MAAM,GAAC,IAAI,QAwCrB;IAED,iFAiCC;IAED,0DAiBC;IAED,mGA6BC;IAED;;;;;;;;;;;OAWG;IACH,gCAJW,MAAM,QACN,MAAM,GAAC,MAAM,WACb,MAAM,GAAC,IAAI,QAsCrB;IAED,kFASC;IAED,4EA2BC;IAED,uDAsBC;IAED;;;;;;;;;;;OAWG;IACH,4BAPW,MAAM,UACN,MAAM,WACN,MAAM,QA4BhB;CACD"}

package/dist/hooks/useCabbageState.d.ts

@@ -3,7 +3,7 @@
  * This hook listens for updates to a parameter value from Cabbage and
  * sends updates to Cabbage when the parameter value changes locally (e.g., through a UI slider).
  */
-export declare const useCabbageState: <T>(channelId: string) => {
+export declare const useCabbageState: <T>(channelId: string, isDragging?: boolean) => {
     value: T | undefined;
     setValue: (value: T) => void;
     parameterIndex: number | undefined;

package/dist/hooks/useCabbageState.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"useCabbageState.d.ts","sourceRoot":"","sources":["../../src/hooks/useCabbageState.ts"],"names":[],"mappings":"AAKA;;;;GAIG;AACH,eAAO,MAAM,eAAe,GAAI,CAAC,aAAa,MAAM;;sBAQjB,CAAC;;CA0GnC,CAAC"}
+{"version":3,"file":"useCabbageState.d.ts","sourceRoot":"","sources":["../../src/hooks/useCabbageState.ts"],"names":[],"mappings":"AAIA;;;;GAIG;AACH,eAAO,MAAM,eAAe,GAAI,CAAC,aAAa,MAAM,eAAe,OAAO;;sBAMvC,CAAC;;CA+GnC,CAAC"}

package/dist/index.cjs

@@ -1 +1 @@
-"use strict";Object.defineProperty(exports,Symbol.toStringTag,{value:"Module"});const c=require("react"),C=c.createContext({devMode:!1});console.log("Cabbage: loading cabbage.js");class f{static sendChannelUpdate(e,a=null,n=!1){if(n===!0||n===1)f.sendParameterUpdate(e,a);else{const s=e.value!==void 0?e.value:e.stringData||e.floatData;f.sendChannelData(e.channel,s,a)}}static sendParameterUpdate(e,a=null){if(e.paramIdx===void 0||e.paramIdx===null){console.error("Cabbage.sendParameterUpdate: message missing paramIdx!",e);return}if(e.paramIdx<0){console.warn("Cabbage.sendParameterUpdate: paramIdx is -1, skipping (non-automatable widget)",e);return}const n={command:"parameterChange",paramIdx:e.paramIdx,channel:e.channel,value:e.value,channelType:e.channelType||"number"};a!==null?a.postMessage(n):typeof window.sendMessageFromUI=="function"?window.sendMessageFromUI(n):console.error("Cabbage: window.sendMessageFromUI is not available. Message:",n)}static sendCustomCommand(e,a=null,n={}){const s={command:e,text:JSON.stringify(n)};if(a!==null)a.postMessage(s);else if(typeof window.sendMessageFromUI=="function"){console.log("Cabbage: Calling window.sendMessageFromUI with:",s);try{const o=window.sendMessageFromUI(s);console.log("Cabbage: sendMessageFromUI returned:",o)}catch(o){console.error("Cabbage: sendMessageFromUI threw error:",o),console.error("Cabbage: Error stack:",o.stack)}}else console.error("Cabbage: window.sendMessageFromUI is not available yet. Message:",s),console.error("Cabbage: typeof window.sendMessageFromUI:",typeof window.sendMessageFromUI),console.error("Cabbage: window.sendMessageFromUI value:",window.sendMessageFromUI)}static sendWidgetUpdate(e,a=null){const n={command:"widgetStateUpdate",obj:JSON.stringify(CabbageUtils.sanitizeForEditor(e))};a!==null?a.postMessage(n):typeof window.sendMessageFromUI=="function"?window.sendMessageFromUI(n):console.error("Cabbage: window.sendMessageFromUI is not available. Message:",n)}static sendMidiMessageFromUI(e,a,n,s=null){var o={statusByte:e,dataByte1:a,dataByte2:n};const l={command:"midiMessage",obj:JSON.stringify(o)};s!==null?s.postMessage(l):typeof window.sendMessageFromUI=="function"?window.sendMessageFromUI(l):console.error("Cabbage: window.sendMessageFromUI is not available. Message:",l)}static sendChannelData(e,a,n=null){var s={channel:e};if(typeof a=="string")s.stringData=a;else if(typeof a=="number")s.floatData=a;else{console.warn("Cabbage: sendChannelData received unsupported data type:",typeof a);return}const o={command:"channelData",obj:JSON.stringify(s)};console.log("Cabbage: sending channel data from UI",s),n!==null?n.postMessage(o):typeof window.sendMessageFromUI=="function"?window.sendMessageFromUI(o):console.error("Cabbage: window.sendMessageFromUI is not available. Message:",o)}static MidiMessageFromHost(e,a,n){console.log("Cabbage: Got MIDI Message"+e+":"+a+":"+n)}static triggerFileOpenDialog(e,a,n={}){var s={channel:a,directory:n.directory||"",filters:n.filters||"*",openAtLastKnownLocation:n.openAtLastKnownLocation!==void 0?n.openAtLastKnownLocation:!0};const o={command:"fileOpen",obj:JSON.stringify(s)};e!==null?e.postMessage(o):typeof window.sendMessageFromUI=="function"?window.sendMessageFromUI(o):console.error("Cabbage: window.sendMessageFromUI is not available. Message:",o)}static openUrl(e,a,n){var s={url:a,file:n};const o={command:"openUrl",obj:JSON.stringify(s)};e!==null?e.postMessage(o):typeof window.sendMessageFromUI=="function"?window.sendMessageFromUI(o):console.error("Cabbage: window.sendMessageFromUI is not available. Message:",o)}static requestResize(e,a,n=null){const s={command:"requestResize",width:e,height:a};if(n!==null){console.warn("Cabbage: requestResize is not supported in VS Code extension mode");return}else typeof window.sendMessageFromUI=="function"?window.sendMessageFromUI(s):console.error("Cabbage: window.sendMessageFromUI is not available. Message:",s)}}const I=i=>{const[e,a]=c.useState();return c.useEffect(()=>{const n=s=>{const{id:o,widgetJson:l,command:b}=s.data;if(o===i&&l&&b==="widgetUpdate"){const t=JSON.parse(l);console.log(`[Cabbage-React] Received properties for channelId ${o}`,t),a(t)}};return window.addEventListener("message",n),()=>{window.removeEventListener("message",n)}},[]),{properties:e}},U=i=>{const{devMode:e}=c.useContext(C),{properties:a}=I(i),[n,s]=c.useState(),[o,l]=c.useState(),b=t=>{if(e)s(t);else{if(o===void 0){console.warn(`[Cabbage-React] parameterIndex not ready for "${i}"`);return}const d={channel:i,paramIdx:o,value:t};f.sendParameterUpdate(d,null)}};return c.useEffect(()=>{var r;const t=a==null?void 0:a.channels.find(g=>g.id===i);if(!t)return;const d=t==null?void 0:t.parameterIndex;o===void 0&&d!==void 0&&(console.log(`[Cabbage-React] Received parameterIndex for channelId "${t.id}"`,d),l(d));const m=a==null?void 0:a.value;m!=null&&(console.log(`[Cabbage-React] Received initial value for channelId "${i}"`,m),s(m));const u=(r=t.range)==null?void 0:r.defaultValue;n===void 0&&u!==void 0&&(console.log(`[Cabbage-React] Received default value for channelId "${t.id}"`,u),s(u))},[a]),c.useEffect(()=>{const t=d=>{var u;const{command:m}=d.data;if(m==="parameterChange"){const{value:r,paramIdx:g}=d.data.data;if(g!==o||r===null)return;console.log(`[Cabbage-React] Received parameterChange for parameterIndex ${g}`,r),s(r)}else if(m==="batchWidgetUpdate"){const r=d.data.widgets,g=r==null?void 0:r.find(p=>p.id===i);if(!g)return;const w=JSON.parse(g.widgetJson).channels.find(p=>p.id===i),M=(u=w==null?void 0:w.range)==null?void 0:u.value;console.log(`[Cabbage-React] Received batch widget update for channelId ${g.id}`,M),s(M)}};return window.addEventListener("message",t),()=>{window.removeEventListener("message",t)}},[o]),{value:n,setValue:b,parameterIndex:o}};exports.Cabbage=f;exports.CabbageContext=C;exports.useCabbageProperties=I;exports.useCabbageState=U;
+"use strict";Object.defineProperty(exports,Symbol.toStringTag,{value:"Module"});const u=require("react");console.log("Cabbage: loading cabbage.js");class f{static sendChannelUpdate(e,a=null,n=!1){if(n===!0||n===1)f.sendParameterUpdate(e,a);else{const s=e.value!==void 0?e.value:e.stringData||e.floatData;f.sendChannelData(e.channel,s,a)}}static sendParameterUpdate(e,a=null){if(e.paramIdx===void 0||e.paramIdx===null){console.error("Cabbage.sendParameterUpdate: message missing paramIdx!",e);return}if(e.paramIdx<0){console.warn("Cabbage.sendParameterUpdate: paramIdx is -1, skipping (non-automatable widget)",e);return}const n={command:"parameterChange",paramIdx:e.paramIdx,channel:e.channel,value:e.value,channelType:e.channelType||"number"};a!==null?a.postMessage(n):typeof window.sendMessageFromUI=="function"?window.sendMessageFromUI(n):console.error("Cabbage: window.sendMessageFromUI is not available. Message:",n)}static sendCustomCommand(e,a=null,n={}){const s={command:e,text:JSON.stringify(n)};if(a!==null)a.postMessage(s);else if(typeof window.sendMessageFromUI=="function"){console.log("Cabbage: Calling window.sendMessageFromUI with:",s);try{const o=window.sendMessageFromUI(s);console.log("Cabbage: sendMessageFromUI returned:",o)}catch(o){console.error("Cabbage: sendMessageFromUI threw error:",o),console.error("Cabbage: Error stack:",o.stack)}}else console.error("Cabbage: window.sendMessageFromUI is not available yet. Message:",s),console.error("Cabbage: typeof window.sendMessageFromUI:",typeof window.sendMessageFromUI),console.error("Cabbage: window.sendMessageFromUI value:",window.sendMessageFromUI)}static sendWidgetUpdate(e,a=null){const n={command:"widgetStateUpdate",obj:JSON.stringify(CabbageUtils.sanitizeForEditor(e))};a!==null?a.postMessage(n):typeof window.sendMessageFromUI=="function"?window.sendMessageFromUI(n):console.error("Cabbage: window.sendMessageFromUI is not available. Message:",n)}static sendMidiMessageFromUI(e,a,n,s=null){var o={statusByte:e,dataByte1:a,dataByte2:n};const l={command:"midiMessage",obj:JSON.stringify(o)};s!==null?s.postMessage(l):typeof window.sendMessageFromUI=="function"?window.sendMessageFromUI(l):console.error("Cabbage: window.sendMessageFromUI is not available. Message:",l)}static sendChannelData(e,a,n=null){var s={channel:e};if(typeof a=="string")s.stringData=a;else if(typeof a=="number")s.floatData=a;else{console.warn("Cabbage: sendChannelData received unsupported data type:",typeof a);return}const o={command:"channelData",obj:JSON.stringify(s)};console.log("Cabbage: sending channel data from UI",s),n!==null?n.postMessage(o):typeof window.sendMessageFromUI=="function"?window.sendMessageFromUI(o):console.error("Cabbage: window.sendMessageFromUI is not available. Message:",o)}static MidiMessageFromHost(e,a,n){console.log("Cabbage: Got MIDI Message"+e+":"+a+":"+n)}static triggerFileOpenDialog(e,a,n={}){var s={channel:a,directory:n.directory||"",filters:n.filters||"*",openAtLastKnownLocation:n.openAtLastKnownLocation!==void 0?n.openAtLastKnownLocation:!0};const o={command:"fileOpen",obj:JSON.stringify(s)};e!==null?e.postMessage(o):typeof window.sendMessageFromUI=="function"?window.sendMessageFromUI(o):console.error("Cabbage: window.sendMessageFromUI is not available. Message:",o)}static openUrl(e,a,n){var s={url:a,file:n};const o={command:"openUrl",obj:JSON.stringify(s)};e!==null?e.postMessage(o):typeof window.sendMessageFromUI=="function"?window.sendMessageFromUI(o):console.error("Cabbage: window.sendMessageFromUI is not available. Message:",o)}static requestResize(e,a,n=null){const s={command:"requestResize",width:e,height:a};if(n!==null){console.warn("Cabbage: requestResize is not supported in VS Code extension mode");return}else typeof window.sendMessageFromUI=="function"?window.sendMessageFromUI(s):console.error("Cabbage: window.sendMessageFromUI is not available. Message:",s)}}const I=i=>{const[e,a]=u.useState();return u.useEffect(()=>{const n=s=>{const{id:o,widgetJson:l,command:b}=s.data;if(o===i&&l&&b==="widgetUpdate"){const t=JSON.parse(l);console.log(`[Cabbage-React] Received properties for channelId ${o}`,t),a(t)}};return window.addEventListener("message",n),()=>{window.removeEventListener("message",n)}},[]),{properties:e}},C=(i,e)=>{const{properties:a}=I(i),[n,s]=u.useState(),[o,l]=u.useState(),b=t=>{if(o===void 0){console.warn(`[Cabbage-React] parameterIndex not ready for "${i}"`);return}s(t);const d={paramIdx:o,channel:i,value:t,channelType:"number"};f.sendParameterUpdate(d,null)};return u.useEffect(()=>{var r;const t=a==null?void 0:a.channels.find(g=>g.id===i);if(!t)return;const d=t==null?void 0:t.parameterIndex;o===void 0&&d!==void 0&&(console.log(`[Cabbage-React] Received parameterIndex for channelId "${t.id}"`,d),l(d));const c=a==null?void 0:a.value;c!=null&&(console.log(`[Cabbage-React] Received initial value for channelId "${i}"`,c),s(c));const m=(r=t.range)==null?void 0:r.defaultValue;n===void 0&&m!==void 0&&(console.log(`[Cabbage-React] Received default value for channelId "${t.id}"`,m),s(m))},[a]),u.useEffect(()=>{const t=d=>{var m;const{command:c}=d.data;if(c==="parameterChange"){if(e)return;const{value:r,paramIdx:g}=d.data.data;if(g!==o||r===null)return;console.log(`[Cabbage-React] Received parameterChange for parameterIndex ${g}`,r),s(r)}else if(c==="batchWidgetUpdate"){const r=d.data.widgets,g=r==null?void 0:r.find(p=>p.id===i);if(!g)return;const w=JSON.parse(g.widgetJson).channels.find(p=>p.id===i),M=(m=w==null?void 0:w.range)==null?void 0:m.value;console.log(`[Cabbage-React] Received batch widget update for channelId ${g.id}`,M),s(M)}};return window.addEventListener("message",t),()=>{window.removeEventListener("message",t)}},[o]),{value:n,setValue:b,parameterIndex:o}};exports.Cabbage=f;exports.useCabbageProperties=I;exports.useCabbageState=C;

package/dist/index.d.ts

@@ -1,4 +1,3 @@
-export { CabbageContext } from './context/CabbageContext';
 export { useCabbageState } from './hooks/useCabbageState';
 export { useCabbageProperties } from './hooks/useCabbageProperties';
 export { Cabbage } from './cabbage/cabbage';

package/dist/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,cAAc,EAAE,MAAM,0BAA0B,CAAC;AAC1D,OAAO,EAAE,eAAe,EAAE,MAAM,yBAAyB,CAAC;AAC1D,OAAO,EAAE,oBAAoB,EAAE,MAAM,8BAA8B,CAAC;AACpE,OAAO,EAAE,OAAO,EAAE,MAAM,mBAAmB,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,eAAe,EAAE,MAAM,yBAAyB,CAAC;AAC1D,OAAO,EAAE,oBAAoB,EAAE,MAAM,8BAA8B,CAAC;AACpE,OAAO,EAAE,OAAO,EAAE,MAAM,mBAAmB,CAAC"}

package/dist/index.mjs

@@ -1,21 +1,30 @@
-import { createContext as C, useState as p, useEffect as M, useContext as U } from "react";
-const F = C({
-  devMode: !1
-});
+import { useState as p, useEffect as M } from "react";
 console.log("Cabbage: loading cabbage.js");
 class f {
   /**
-   * Main entry point for sending any data from UI widgets to the Cabbage backend.
+   * Main entry point for sending widget value changes to the Cabbage backend.
+   *
    * This function automatically routes messages to the appropriate backend function
    * based on the automatable flag:
    *
-   * - automatable=true: Routes to sendParameterUpdate for real-time parameter control /
-   *                     this also sends the value as channel data to Csound
+   * - `automatable=true`: Routes to `sendParameterUpdate()` for DAW-automatable parameters.
+   *   The value is sent to the DAW for automation recording and also forwarded to Csound.
+   *
+   * - `automatable=false`: Routes to `sendChannelData()` for non-automatable data.
+   *   The value is sent directly to Csound without DAW parameter involvement.
+   *
+   * **When to use**: Call this from widget event handlers (e.g., pointer events, input changes)
+   * when the user interacts with a widget.
    *
-   * - automatable=false: Routes to sendChannelData for string/numeric data transmission
+   * **When NOT to use**: Do not call this when handling incoming `parameterChange` messages
+   * from the backend. Those messages are for display updates only.
    *
-   * All widget interactions should use this function instead of calling the lower-level
-   * sendParameterUpdate or sendChannelData functions directly.
+   * @param {Object} message - The message object containing widget data
+   * @param {string} message.channel - The channel name
+   * @param {number} message.paramIdx - Parameter index (required if automatable)
+   * @param {number|string} message.value - The value to send
+   * @param {Object|null} vscode - VS Code API object (null for plugin mode)
+   * @param {boolean} automatable - Whether this widget is DAW-automatable
    */
   static sendChannelUpdate(e, a = null, n = !1) {
     if (n === !0 || n === 1)
@@ -25,6 +34,28 @@ class f {
       f.sendChannelData(e.channel, s, a);
     }
   }
+  /**
+   * Internal: Send a parameter update to the DAW for automation recording.
+   * Use `sendChannelUpdate()` instead - it will route here automatically for automatable widgets.
+   *
+   * This function sends the parameter value to the DAW's automation system.
+   * The DAW will then send the value back via a `parameterChange` message,
+   * which updates both the UI and Csound.
+   *
+   * **Important**: This creates a round-trip through the DAW:
+   * 1. UI calls `sendParameterUpdate()` with value
+   * 2. DAW receives and records/processes the value
+   * 3. DAW sends `parameterChange` back to the plugin
+   * 4. Plugin updates Csound and sends `parameterChange` to UI
+   * 5. UI updates its display (but does NOT call sendParameterUpdate again!)
+   *
+   * @param {Object} message - The parameter message
+   * @param {number} message.paramIdx - The parameter index (must be >= 0)
+   * @param {string} message.channel - The channel name
+   * @param {number} message.value - The parameter value (full range, not normalized)
+   * @param {string} [message.channelType="number"] - The channel type
+   * @param {Object|null} vscode - VS Code API object (null for plugin mode)
+   */
   static sendParameterUpdate(e, a = null) {
     if (e.paramIdx === void 0 || e.paramIdx === null) {
       console.error(
@@ -104,6 +135,18 @@ class f {
       l
     );
   }
+  /**
+   * Internal: Send channel data directly to Csound without DAW automation involvement.
+   * Use `sendChannelUpdate()` instead - it will route here automatically for non-automatable widgets.
+   *
+   * Used for non-automatable widgets like buttons, file selectors, or
+   * any widget that sends string data. The value is sent directly to Csound's
+   * channel system and is not recorded by DAW automation.
+   *
+   * @param {string} channel - The Csound channel name
+   * @param {number|string} data - The data to send (number or string)
+   * @param {Object|null} vscode - VS Code API object (null for plugin mode)
+   */
   static sendChannelData(e, a, n = null) {
     var s = {
       channel: e
@@ -193,7 +236,7 @@ class f {
       );
   }
 }
-const v = (i) => {
+const U = (i) => {
   const [e, a] = p();
   return M(() => {
     const n = (s) => {
@@ -212,20 +255,22 @@ const v = (i) => {
   }, []), {
     properties: e
   };
-}, x = (i) => {
-  const { devMode: e } = U(F), { properties: a } = v(i), [n, s] = p(), [o, l] = p(), u = (t) => {
-    if (e)
-      s(t);
-    else {
-      if (o === void 0) {
-        console.warn(
-          `[Cabbage-React] parameterIndex not ready for "${i}"`
-        );
-        return;
-      }
-      const d = { channel: i, paramIdx: o, value: t };
-      f.sendParameterUpdate(d, null);
+}, h = (i, e) => {
+  const { properties: a } = U(i), [n, s] = p(), [o, l] = p(), u = (t) => {
+    if (o === void 0) {
+      console.warn(
+        `[Cabbage-React] parameterIndex not ready for "${i}"`
+      );
+      return;
     }
+    s(t);
+    const d = {
+      paramIdx: o,
+      channel: i,
+      value: t,
+      channelType: "number"
+    };
+    f.sendParameterUpdate(d, null);
   };
   return M(() => {
     var r;
@@ -253,6 +298,7 @@ const v = (i) => {
       var m;
       const { command: c } = d.data;
       if (c === "parameterChange") {
+        if (e) return;
         const { value: r, paramIdx: g } = d.data.data;
         if (g !== o || r === null) return;
         console.log(
@@ -282,7 +328,6 @@ const v = (i) => {
 };
 export {
   f as Cabbage,
-  F as CabbageContext,
-  v as useCabbageProperties,
-  x as useCabbageState
+  U as useCabbageProperties,
+  h as useCabbageState
 };

package/package.json

@@ -1,6 +1,6 @@
 {
 	"name": "cabbage-react",
-	"version": "1.0.15",
+	"version": "1.0.17",
 	"type": "module",
 	"keywords": [
 		"cabbage",

package/dist/context/CabbageContext.d.ts

@@ -1,6 +0,0 @@
-interface CabbageContext {
-    devMode: boolean;
-}
-export declare const CabbageContext: import('react').Context<CabbageContext>;
-export {};
-//# sourceMappingURL=CabbageContext.d.ts.map

package/dist/context/CabbageContext.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"CabbageContext.d.ts","sourceRoot":"","sources":["../../src/context/CabbageContext.ts"],"names":[],"mappings":"AAEA,UAAU,cAAc;IACvB,OAAO,EAAE,OAAO,CAAC;CACjB;AAED,eAAO,MAAM,cAAc,yCAEzB,CAAC"}