cabbage-react 1.0.14 → 1.0.16

package/dist/cabbage/cabbage.d.ts

@@ -1,25 +1,94 @@
 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;
+    /**
+     * @private
+     * 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)
+     */
+    private static sendChannelData;
     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;
+    /**
+     * Request a resize of the plugin GUI window.
+     * This is only supported in plugin mode (CLAP/VST3/AUv2).
+     * The host may accept or reject the resize request.
+     *
+     * @param {number} width - The requested width in pixels
+     * @param {number} height - The requested height in pixels
+     * @param {object} vscode - The vscode API object (null for plugin mode)
+     *
+     * The response will be sent via hostMessageCallback with:
+     * {command: "resizeResponse", accepted: boolean, width: number, height: number}
+     */
+    static requestResize(width: number, height: number, vscode?: object): void;
 }
 //# sourceMappingURL=cabbage.d.ts.map

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;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;;;;;;;;;;;;OAYG;IACH,+BAoCC;IAED,kFASC;IAED,4EA2BC;IAED,uDAsBC;IAED;;;;;;;;;;;OAWG;IACH,4BAPW,MAAM,UACN,MAAM,WACN,MAAM,QA4BhB;CACD"}

package/dist/hooks/useCabbageState.d.ts

@@ -3,8 +3,9 @@
  * 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;
 };
 //# sourceMappingURL=useCabbageState.d.ts.map

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

@@ -1 +1 @@
-{"version":3,"file":"useCabbageState.d.ts","sourceRoot":"","sources":["../../src/hooks/useCabbageState.ts"],"names":[],"mappings":"AAIA;;;;GAIG;AACH,eAAO,MAAM,eAAe,GAAI,CAAC,aAAa,MAAM;;sBAMjB,CAAC;CAqGnC,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 u=require("react");console.log("Cabbage: loading cabbage.js");class f{static sendChannelUpdate(e,n=null,a=!1){if(a===!0||a===1)f.sendParameterUpdate(e,n);else{const s=e.value!==void 0?e.value:e.stringData||e.floatData;f.sendChannelData(e.channel,s,n)}}static sendParameterUpdate(e,n=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 a={command:"parameterChange",paramIdx:e.paramIdx,channel:e.channel,value:e.value,channelType:e.channelType||"number"};n!==null?n.postMessage(a):typeof window.sendMessageFromUI=="function"?window.sendMessageFromUI(a):console.error("Cabbage: window.sendMessageFromUI is not available. Message:",a)}static sendCustomCommand(e,n=null,a={}){const s={command:e,text:JSON.stringify(a)};if(n!==null)n.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,n=null){const a={command:"widgetStateUpdate",obj:JSON.stringify(CabbageUtils.sanitizeForEditor(e))};n!==null?n.postMessage(a):typeof window.sendMessageFromUI=="function"?window.sendMessageFromUI(a):console.error("Cabbage: window.sendMessageFromUI is not available. Message:",a)}static sendMidiMessageFromUI(e,n,a,s=null){var o={statusByte:e,dataByte1:n,dataByte2:a};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,n,a=null){var s={channel:e};if(typeof n=="string")s.stringData=n;else if(typeof n=="number")s.floatData=n;else{console.warn("Cabbage: sendChannelData received unsupported data type:",typeof n);return}const o={command:"channelData",obj:JSON.stringify(s)};console.log("Cabbage: sending channel data from UI",s),a!==null?a.postMessage(o):typeof window.sendMessageFromUI=="function"?window.sendMessageFromUI(o):console.error("Cabbage: window.sendMessageFromUI is not available. Message:",o)}static MidiMessageFromHost(e,n,a){console.log("Cabbage: Got MIDI Message"+e+":"+n+":"+a)}static triggerFileOpenDialog(e,n,a={}){var s={channel:n,directory:a.directory||"",filters:a.filters||"*",openAtLastKnownLocation:a.openAtLastKnownLocation!==void 0?a.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,n,a){var s={url:n,file:a};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)}}const M=d=>{const[e,n]=u.useState();return u.useEffect(()=>{const a=s=>{const{id:o,widgetJson:l,command:t}=s.data;if(o===d&&l&&t==="widgetUpdate"){const r=JSON.parse(l);console.log(`[Cabbage-React] Received properties for channelId ${o}`,r),n(r)}};return window.addEventListener("message",a),()=>{window.removeEventListener("message",a)}},[]),{properties:e}},I=d=>{const{properties:e}=M(d),[n,a]=u.useState(),[s,o]=u.useState(),l=t=>{a(t);const r={channel:d,paramIdx:s,value:t};f.sendParameterUpdate(r,null)};return u.useEffect(()=>{var i;const t=e==null?void 0:e.channels.find(g=>g.id===d);if(!t)return;const r=t==null?void 0:t.parameterIndex;s===void 0&&r!==void 0&&(console.log(`[Cabbage-React] Received parameterIndex for channelId "${t.id}"`,r),o(r));const c=e==null?void 0:e.value;c!=null&&(console.log(`[Cabbage-React] Received initial value for channelId "${d}"`,c),a(c));const m=(i=t.range)==null?void 0:i.defaultValue;n===void 0&&m!==void 0&&(console.log(`[Cabbage-React] Received default value for channelId "${t.id}"`,m),a(m))},[e]),u.useEffect(()=>{const t=r=>{var m;const{command:c}=r.data;if(c==="parameterChange"){const{value:i,paramIdx:g}=r.data.data;if(g!==s||i===null)return;console.log(`[Cabbage-React] Received parameterChange for parameterIndex ${g}`,i),a(i)}else if(c==="batchWidgetUpdate"){const i=r.data.widgets,g=i==null?void 0:i.find(w=>w.id===d);if(!g)return;const b=JSON.parse(g.widgetJson).channels.find(w=>w.id===d),p=(m=b==null?void 0:b.range)==null?void 0:m.value;console.log(`[Cabbage-React] Received batch widget update for channelId ${g.id}`,p),a(p)}};return window.addEventListener("message",t),()=>{window.removeEventListener("message",t)}},[s]),{value:n,setValue:l}};exports.Cabbage=f;exports.useCabbageProperties=M;exports.useCabbageState=I;
+"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.mjs

@@ -1,28 +1,62 @@
-import { useState as b, useEffect as p } from "react";
+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.
    *
-   * - automatable=false: Routes to sendChannelData for string/numeric data transmission
+   * **When to use**: Call this from widget event handlers (e.g., pointer events, input changes)
+   * when the user interacts with a widget.
    *
-   * All widget interactions should use this function instead of calling the lower-level
-   * sendParameterUpdate or sendChannelData functions directly.
+   * **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(e, n = null, a = !1) {
-    if (a === !0 || a === 1)
-      f.sendParameterUpdate(e, n);
+  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, n);
+      f.sendChannelData(e.channel, s, a);
     }
   }
-  static sendParameterUpdate(e, n = null) {
+  /**
+   * 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(
         "Cabbage.sendParameterUpdate: message missing paramIdx!",
@@ -37,25 +71,25 @@ class f {
       );
       return;
     }
-    const a = {
+    const n = {
       command: "parameterChange",
       paramIdx: e.paramIdx,
       channel: e.channel,
       value: e.value,
       channelType: e.channelType || "number"
     };
-    n !== null ? n.postMessage(a) : typeof window.sendMessageFromUI == "function" ? window.sendMessageFromUI(a) : console.error(
+    a !== null ? a.postMessage(n) : typeof window.sendMessageFromUI == "function" ? window.sendMessageFromUI(n) : console.error(
       "Cabbage: window.sendMessageFromUI is not available. Message:",
-      a
+      n
     );
   }
-  static sendCustomCommand(e, n = null, a = {}) {
+  static sendCustomCommand(e, a = null, n = {}) {
     const s = {
       command: e,
-      text: JSON.stringify(a)
+      text: JSON.stringify(n)
     };
-    if (n !== null)
-      n.postMessage(s);
+    if (a !== null)
+      a.postMessage(s);
     else if (typeof window.sendMessageFromUI == "function") {
       console.log("Cabbage: Calling window.sendMessageFromUI with:", s);
       try {
@@ -76,21 +110,21 @@ class f {
         window.sendMessageFromUI
       );
   }
-  static sendWidgetUpdate(e, n = null) {
-    const a = {
+  static sendWidgetUpdate(e, a = null) {
+    const n = {
       command: "widgetStateUpdate",
       obj: JSON.stringify(CabbageUtils.sanitizeForEditor(e))
     };
-    n !== null ? n.postMessage(a) : typeof window.sendMessageFromUI == "function" ? window.sendMessageFromUI(a) : console.error(
+    a !== null ? a.postMessage(n) : typeof window.sendMessageFromUI == "function" ? window.sendMessageFromUI(n) : console.error(
       "Cabbage: window.sendMessageFromUI is not available. Message:",
-      a
+      n
     );
   }
-  static sendMidiMessageFromUI(e, n, a, s = null) {
+  static sendMidiMessageFromUI(e, a, n, s = null) {
     var o = {
       statusByte: e,
-      dataByte1: n,
-      dataByte2: a
+      dataByte1: a,
+      dataByte2: n
     };
     const l = {
       command: "midiMessage",
@@ -101,18 +135,31 @@ class f {
       l
     );
   }
-  static sendChannelData(e, n, a = null) {
+  /**
+   * @private
+   * 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
     };
-    if (typeof n == "string")
-      s.stringData = n;
-    else if (typeof n == "number")
-      s.floatData = n;
+    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 n
+        typeof a
       );
       return;
     }
@@ -120,22 +167,22 @@ class f {
       command: "channelData",
       obj: JSON.stringify(s)
     };
-    console.log("Cabbage: sending channel data from UI", s), a !== null ? a.postMessage(o) : typeof window.sendMessageFromUI == "function" ? window.sendMessageFromUI(o) : console.error(
+    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, n, a) {
+  static MidiMessageFromHost(e, a, n) {
     console.log(
-      "Cabbage: Got MIDI Message" + e + ":" + n + ":" + a
+      "Cabbage: Got MIDI Message" + e + ":" + a + ":" + n
     );
   }
-  static triggerFileOpenDialog(e, n, a = {}) {
+  static triggerFileOpenDialog(e, a, n = {}) {
     var s = {
-      channel: n,
-      directory: a.directory || "",
-      filters: a.filters || "*",
-      openAtLastKnownLocation: a.openAtLastKnownLocation !== void 0 ? a.openAtLastKnownLocation : !0
+      channel: a,
+      directory: n.directory || "",
+      filters: n.filters || "*",
+      openAtLastKnownLocation: n.openAtLastKnownLocation !== void 0 ? n.openAtLastKnownLocation : !0
     };
     const o = {
       command: "fileOpen",
@@ -146,10 +193,10 @@ class f {
       o
     );
   }
-  static openUrl(e, n, a) {
+  static openUrl(e, a, n) {
     var s = {
-      url: n,
-      file: a
+      url: a,
+      file: n
     };
     const o = {
       command: "openUrl",
@@ -160,90 +207,128 @@ class f {
       o
     );
   }
+  /**
+   * Request a resize of the plugin GUI window.
+   * This is only supported in plugin mode (CLAP/VST3/AUv2).
+   * The host may accept or reject the resize request.
+   *
+   * @param {number} width - The requested width in pixels
+   * @param {number} height - The requested height in pixels
+   * @param {object} vscode - The vscode API object (null for plugin mode)
+   *
+   * The response will be sent via hostMessageCallback with:
+   * {command: "resizeResponse", accepted: boolean, width: number, height: number}
+   */
+  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 = (d) => {
-  const [e, n] = b();
-  return p(() => {
-    const a = (s) => {
-      const { id: o, widgetJson: l, command: t } = s.data;
-      if (o === d && l && t === "widgetUpdate") {
-        const r = JSON.parse(l);
+const U = (i) => {
+  const [e, a] = p();
+  return M(() => {
+    const n = (s) => {
+      const { id: o, widgetJson: l, command: u } = s.data;
+      if (o === i && l && u === "widgetUpdate") {
+        const t = JSON.parse(l);
         console.log(
           `[Cabbage-React] Received properties for channelId ${o}`,
-          r
-        ), n(r);
+          t
+        ), a(t);
       }
     };
-    return window.addEventListener("message", a), () => {
-      window.removeEventListener("message", a);
+    return window.addEventListener("message", n), () => {
+      window.removeEventListener("message", n);
     };
   }, []), {
     properties: e
   };
-}, F = (d) => {
-  const { properties: e } = I(d), [n, a] = b(), [s, o] = b(), l = (t) => {
-    a(t);
-    const r = {
-      channel: d,
-      paramIdx: s,
-      value: t
-    };
-    f.sendParameterUpdate(r, 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 p(() => {
-    var i;
-    const t = e == null ? void 0 : e.channels.find(
-      (g) => g.id === d
+  return M(() => {
+    var r;
+    const t = a == null ? void 0 : a.channels.find(
+      (g) => g.id === i
     );
     if (!t) return;
-    const r = t == null ? void 0 : t.parameterIndex;
-    s === void 0 && r !== void 0 && (console.log(
+    const d = t == null ? void 0 : t.parameterIndex;
+    o === void 0 && d !== void 0 && (console.log(
       `[Cabbage-React] Received parameterIndex for channelId "${t.id}"`,
-      r
-    ), o(r));
-    const c = e == null ? void 0 : e.value;
+      d
+    ), l(d));
+    const c = a == null ? void 0 : a.value;
     c != null && (console.log(
-      `[Cabbage-React] Received initial value for channelId "${d}"`,
+      `[Cabbage-React] Received initial value for channelId "${i}"`,
       c
-    ), a(c));
-    const m = (i = t.range) == null ? void 0 : i.defaultValue;
+    ), 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
-    ), a(m));
-  }, [e]), p(() => {
-    const t = (r) => {
+    ), s(m));
+  }, [a]), M(() => {
+    const t = (d) => {
       var m;
-      const { command: c } = r.data;
+      const { command: c } = d.data;
       if (c === "parameterChange") {
-        const { value: i, paramIdx: g } = r.data.data;
-        if (g !== s || i === null) return;
+        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}`,
-          i
-        ), a(i);
+          r
+        ), s(r);
       } else if (c === "batchWidgetUpdate") {
-        const i = r.data.widgets, g = i == null ? void 0 : i.find((w) => w.id === d);
+        const r = d.data.widgets, g = r == null ? void 0 : r.find((b) => b.id === i);
         if (!g) return;
-        const u = JSON.parse(g.widgetJson).channels.find(
-          (w) => w.id === d
-        ), M = (m = u == null ? void 0 : u.range) == null ? void 0 : m.value;
+        const w = JSON.parse(g.widgetJson).channels.find(
+          (b) => b.id === i
+        ), I = (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
-        ), a(M);
+          I
+        ), s(I);
       }
     };
     return window.addEventListener("message", t), () => {
       window.removeEventListener("message", t);
     };
-  }, [s]), {
+  }, [o]), {
     value: n,
-    setValue: l
+    setValue: u,
+    parameterIndex: o
   };
 };
 export {
   f as Cabbage,
-  I as useCabbageProperties,
-  F as useCabbageState
+  U as useCabbageProperties,
+  h as useCabbageState
 };

package/package.json

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