cabbage-react 1.0.48 → 1.0.50

package/dist/hooks/useCabbageMessage.d.ts

@@ -2,9 +2,10 @@
  * Custom hook to get the latest message for a specific type from Cabbage backend.
  * This hook listens to messages sent from the backend and updates the local state
  * whenever new data is received.
- * @param messageType
+ * @param messageType - The value of the `type` property in the incoming message object to listen for.
+ * @param onMessage - Callback fires immediately when receiving a new message (synchronous - bypasses state batching)
  */
-export declare const useCabbageMessage: <T>(messageType: string) => {
-    data: T | undefined;
+export declare const useCabbageMessage: <T>(messageType: string, onMessage?: (message: T) => void) => {
+    message: T | undefined;
 };
 //# sourceMappingURL=useCabbageMessage.d.ts.map

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

@@ -1 +1 @@
-{"version":3,"file":"useCabbageMessage.d.ts","sourceRoot":"","sources":["../../src/hooks/useCabbageMessage.ts"],"names":[],"mappings":"AAEA;;;;;GAKG;AACH,eAAO,MAAM,iBAAiB,GAAI,CAAC,eAAe,MAAM;;CA8BvD,CAAC"}
+{"version":3,"file":"useCabbageMessage.d.ts","sourceRoot":"","sources":["../../src/hooks/useCabbageMessage.ts"],"names":[],"mappings":"AAEA;;;;;;GAMG;AACH,eAAO,MAAM,iBAAiB,GAAI,CAAC,eACrB,MAAM,cACP,CAAC,OAAO,EAAE,CAAC,KAAK,IAAI;;CAyBhC,CAAC"}

package/dist/hooks/useCabbageProperties.d.ts

@@ -3,8 +3,10 @@
  * This hook listens for updates to parameter properties from the backend and updates the local state
  * whenever new data is received.
  * @param channelId
+ * @param onPropertiesUpdate - Callback fires immediately when receiving an update to properties (synchronous - bypasses state batching)
  */
-export declare const useCabbageProperties: (channelId: string) => {
+export declare const useCabbageProperties: (channelId: string, onPropertiesUpdate?: (properties: Record<string, any>) => void) => {
     properties: Record<string, any> | undefined;
+    onPropertiesUpdate: ((properties: Record<string, any>) => void) | undefined;
 };
 //# sourceMappingURL=useCabbageProperties.d.ts.map

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

@@ -1 +1 @@
-{"version":3,"file":"useCabbageProperties.d.ts","sourceRoot":"","sources":["../../src/hooks/useCabbageProperties.ts"],"names":[],"mappings":"AAEA;;;;;GAKG;AACH,eAAO,MAAM,oBAAoB,cAAe,MAAM;;CAgCrD,CAAC"}
+{"version":3,"file":"useCabbageProperties.d.ts","sourceRoot":"","sources":["../../src/hooks/useCabbageProperties.ts"],"names":[],"mappings":"AAEA;;;;;;GAMG;AACH,eAAO,MAAM,oBAAoB,cACrB,MAAM,uBACI,CAAC,UAAU,EAAE,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,KAAK,IAAI;;sCAA5B,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,KAAK,IAAI;CAiC9D,CAAC"}

package/dist/hooks/useCabbageState.d.ts

@@ -4,8 +4,9 @@
  * sends updates to the backend when the parameter value changes locally (e.g., through a UI slider).
  * @param channelId
  * @param gesture - The gesture type: "begin" (start of interaction), "value" (during interaction), "end" (end of continuous interaction), or "complete" (discrete action e.g. button click).
+ * @param onValueUpdate - Callback fires immediately when receiving a value update (synchronous - bypasses state batching)
  */
-export declare const useCabbageState: <T>(channelId: string, gesture?: "begin" | "value" | "end" | "complete") => {
+export declare const useCabbageState: <T>(channelId: string, gesture?: "begin" | "value" | "end" | "complete", onValueUpdate?: (value: T) => void) => {
     value: T | undefined;
     setValue: (value: T) => void;
 };

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

@@ -1 +1 @@
-{"version":3,"file":"useCabbageState.d.ts","sourceRoot":"","sources":["../../src/hooks/useCabbageState.ts"],"names":[],"mappings":"AAIA;;;;;;GAMG;AACH,eAAO,MAAM,eAAe,GAAI,CAAC,aACrB,MAAM,YACR,OAAO,GAAG,OAAO,GAAG,KAAK,GAAG,UAAU;;sBAOb,CAAC;CA6FnC,CAAC"}
+{"version":3,"file":"useCabbageState.d.ts","sourceRoot":"","sources":["../../src/hooks/useCabbageState.ts"],"names":[],"mappings":"AAIA;;;;;;;GAOG;AACH,eAAO,MAAM,eAAe,GAAI,CAAC,aACrB,MAAM,YACR,OAAO,GAAG,OAAO,GAAG,KAAK,GAAG,UAAU,kBAC/B,CAAC,KAAK,EAAE,CAAC,KAAK,IAAI;;sBAOA,CAAC;CAgGnC,CAAC"}

package/dist/index.cjs

@@ -1 +1 @@
-"use strict";Object.defineProperty(exports,Symbol.toStringTag,{value:"Module"});const l=require("react");class M{static sendControlData({channel:n,value:s,gesture:a="complete"},o=null){const e={command:"controlData",channel:n,value:s,gesture:a};o!==null?o.postMessage(e):typeof window.sendMessageFromUI=="function"?window.sendMessageFromUI(e):window.parent!==window?window.parent.postMessage(e,"*"):console.error("Cabbage: window.sendMessageFromUI is not available. Message:",e)}static isReadyToLoad(n=null,s={}){this.sendCustomCommand("isReadyToLoad",n)}static sendMidiMessageFromUI(n,s,a,o=null){var e={statusByte:n,dataByte1:s,dataByte2:a};const i={command:"midiMessage",obj:JSON.stringify(e)};o!==null?o.postMessage(i):typeof window.sendMessageFromUI=="function"?window.sendMessageFromUI(i):window.parent!==window?window.parent.postMessage(i,"*"):console.error("Cabbage: window.sendMessageFromUI is not available. Message:",i)}static MidiMessageFromHost(n,s,a){}static triggerFileOpenDialog(n,s,a={}){var o={channel:s,directory:a.directory||"",filters:a.filters||"*",openAtLastKnownLocation:a.openAtLastKnownLocation!==void 0?a.openAtLastKnownLocation:!0};const e={command:"fileOpen",obj:JSON.stringify(o)};n!==null?n.postMessage(e):typeof window.sendMessageFromUI=="function"?window.sendMessageFromUI(e):window.parent!==window?window.parent.postMessage(e,"*"):console.error("Cabbage: window.sendMessageFromUI is not available. Message:",e)}static openUrl(n,s,a){var o={url:s,file:a};const e={command:"openUrl",obj:JSON.stringify(o)};n!==null?n.postMessage(e):typeof window.sendMessageFromUI=="function"?window.sendMessageFromUI(e):window.parent!==window?window.parent.postMessage(e,"*"):console.error("Cabbage: window.sendMessageFromUI is not available. Message:",e)}static requestResize(n,s,a=null){const o={command:"requestResize",width:n,height:s};if(a!==null){console.warn("Cabbage: requestResize is not supported in VS Code extension mode");return}else typeof window.sendMessageFromUI=="function"?window.sendMessageFromUI(o):window.parent!==window?window.parent.postMessage(o,"*"):console.error("Cabbage: window.sendMessageFromUI is not available. Message:",o)}static consumeKeypresses(n){typeof window.consumeKeypresses=="function"&&window.consumeKeypresses(n)}static sendChannelData(n,s,a=null){var o={channel:n};if(typeof s=="string")o.stringData=s;else if(typeof s=="number")o.floatData=s;else{console.warn("Cabbage: sendChannelData received unsupported data type:",typeof s);return}const e={command:"channelData",obj:JSON.stringify(o)};a!==null?a.postMessage(e):typeof window.sendMessageFromUI=="function"?window.sendMessageFromUI(e):window.parent!==window?window.parent.postMessage(e,"*"):console.error("Cabbage: window.sendMessageFromUI is not available. Message:",e)}static sendWidgetUpdate(n,s=null){const a={command:"widgetStateUpdate",obj:JSON.stringify(CabbageUtils.sanitizeForEditor(n))};s!==null?s.postMessage(a):typeof window.sendMessageFromUI=="function"?window.sendMessageFromUI(a):window.parent!==window?window.parent.postMessage(a,"*"):console.error("Cabbage: window.sendMessageFromUI is not available. Message:",a)}static addMessageListener(n){const s=a=>{a.source!==window&&n(a.data)};return window.addEventListener("message",s),window.hostMessageCallback=n,()=>{window.removeEventListener("message",s),window.hostMessageCallback===n&&(window.hostMessageCallback=null)}}static sendCustomCommand(n,s=null,a={}){const o={command:n,text:JSON.stringify(a)};if(s!==null)s.postMessage(o);else if(typeof window.sendMessageFromUI=="function")try{const e=window.sendMessageFromUI(o)}catch(e){console.error("Cabbage: sendMessageFromUI threw error:",e),console.error("Cabbage: Error stack:",e.stack)}else window.parent!==window?window.parent.postMessage(o,"*"):(console.error("Cabbage: window.sendMessageFromUI is not available yet. Message:",o),console.error("Cabbage: typeof window.sendMessageFromUI:",typeof window.sendMessageFromUI),console.error("Cabbage: window.sendMessageFromUI value:",window.sendMessageFromUI))}}const C=r=>{const[n,s]=l.useState();return l.useEffect(()=>{const a=o=>{const{id:e,widgetJson:i,command:f}=o.data;if(e===r&&i&&f==="widgetUpdate"){const t=JSON.parse(i);console.log(`[Cabbage-React] Received properties for channelId: ${e}`,t),s(t)}};return window.addEventListener("message",a),()=>{window.removeEventListener("message",a)}},[]),{properties:n}},y=(r,n="complete")=>{const{properties:s}=C(r),[a,o]=l.useState(),[e,i]=l.useState(),f=t=>{o(t),M.sendControlData({channel:r,value:t,gesture:n})};return l.useEffect(()=>{var m;const t=s==null?void 0:s.channels.find(d=>d.id===r);if(!t)return;const g=t.parameterIndex;if(e===void 0&&g!==void 0&&(console.log(`[Cabbage-React] Received parameterIndex for channelId: ${t.id}`,g),i(g)),a!==void 0)return;const w=(m=t.range)==null?void 0:m.value;w!=null&&(console.log(`[Cabbage-React] Received initial value for channelId: ${t.id}`,w),o(w))},[s]),l.useEffect(()=>{const t=g=>{var m;const{command:w}=g.data;if(w==="parameterChange"){const{value:d,paramIdx:c}=g.data.data;if(c!==e||d===null)return;console.log(`[Cabbage-React] Received parameterChange for parameterIndex: ${c}`,d),o(d)}else if(w==="batchWidgetUpdate"){const d=g.data.widgets,c=d==null?void 0:d.find(p=>p.id===r);if(!c)return;const u=JSON.parse(c.widgetJson).channels.find(p=>p.id===r),b=(m=u==null?void 0:u.range)==null?void 0:m.value;console.log(`[Cabbage-React] Received batch widget update for channelId: ${c.id}`,b),o(b)}};return window.addEventListener("message",t),()=>{window.removeEventListener("message",t)}},[e]),{value:a,setValue:f}},I=r=>{const[n,s]=l.useState();return l.useEffect(()=>{const a=o=>{const{data:e,type:i}=o;if(e&&i==="message"){if(e.type!==r)return;console.log(`[Cabbage-React] Received data for messageType: ${e.type}`,e),s(e)}};return window.addEventListener("message",a),()=>{window.removeEventListener("message",a)}},[]),{data:n}};exports.Cabbage=M;exports.useCabbageMessage=I;exports.useCabbageProperties=C;exports.useCabbageState=y;
+"use strict";Object.defineProperty(exports,Symbol.toStringTag,{value:"Module"});const l=require("react");class y{static sendControlData({channel:e,value:a,gesture:s="complete"},o=null){const n={command:"controlData",channel:e,value:a,gesture:s};o!==null?o.postMessage(n):typeof window.sendMessageFromUI=="function"?window.sendMessageFromUI(n):window.parent!==window?window.parent.postMessage(n,"*"):console.error("Cabbage: window.sendMessageFromUI is not available. Message:",n)}static isReadyToLoad(e=null,a={}){this.sendCustomCommand("isReadyToLoad",e)}static sendMidiMessageFromUI(e,a,s,o=null){var n={statusByte:e,dataByte1:a,dataByte2:s};const t={command:"midiMessage",obj:JSON.stringify(n)};o!==null?o.postMessage(t):typeof window.sendMessageFromUI=="function"?window.sendMessageFromUI(t):window.parent!==window?window.parent.postMessage(t,"*"):console.error("Cabbage: window.sendMessageFromUI is not available. Message:",t)}static MidiMessageFromHost(e,a,s){}static triggerFileOpenDialog(e,a,s={}){var o={channel:a,directory:s.directory||"",filters:s.filters||"*",openAtLastKnownLocation:s.openAtLastKnownLocation!==void 0?s.openAtLastKnownLocation:!0};const n={command:"fileOpen",obj:JSON.stringify(o)};e!==null?e.postMessage(n):typeof window.sendMessageFromUI=="function"?window.sendMessageFromUI(n):window.parent!==window?window.parent.postMessage(n,"*"):console.error("Cabbage: window.sendMessageFromUI is not available. Message:",n)}static openUrl(e,a,s){var o={url:a,file:s};const n={command:"openUrl",obj:JSON.stringify(o)};e!==null?e.postMessage(n):typeof window.sendMessageFromUI=="function"?window.sendMessageFromUI(n):window.parent!==window?window.parent.postMessage(n,"*"):console.error("Cabbage: window.sendMessageFromUI is not available. Message:",n)}static requestResize(e,a,s=null){const o={command:"requestResize",width:e,height:a};if(s!==null){console.warn("Cabbage: requestResize is not supported in VS Code extension mode");return}else typeof window.sendMessageFromUI=="function"?window.sendMessageFromUI(o):window.parent!==window?window.parent.postMessage(o,"*"):console.error("Cabbage: window.sendMessageFromUI is not available. Message:",o)}static consumeKeypresses(e){typeof window.consumeKeypresses=="function"&&window.consumeKeypresses(e)}static sendChannelData(e,a,s=null){var o={channel:e};if(typeof a=="string")o.stringData=a;else if(typeof a=="number")o.floatData=a;else{console.warn("Cabbage: sendChannelData received unsupported data type:",typeof a);return}const n={command:"channelData",obj:JSON.stringify(o)};s!==null?s.postMessage(n):typeof window.sendMessageFromUI=="function"?window.sendMessageFromUI(n):window.parent!==window?window.parent.postMessage(n,"*"):console.error("Cabbage: window.sendMessageFromUI is not available. Message:",n)}static sendWidgetUpdate(e,a=null){const s={command:"widgetStateUpdate",obj:JSON.stringify(CabbageUtils.sanitizeForEditor(e))};a!==null?a.postMessage(s):typeof window.sendMessageFromUI=="function"?window.sendMessageFromUI(s):window.parent!==window?window.parent.postMessage(s,"*"):console.error("Cabbage: window.sendMessageFromUI is not available. Message:",s)}static addMessageListener(e){const a=s=>{s.source!==window&&e(s.data)};return window.addEventListener("message",a),window.hostMessageCallback=e,()=>{window.removeEventListener("message",a),window.hostMessageCallback===e&&(window.hostMessageCallback=null)}}static sendCustomCommand(e,a=null,s={}){const o={command:e,text:JSON.stringify(s)};if(a!==null)a.postMessage(o);else if(typeof window.sendMessageFromUI=="function")try{const n=window.sendMessageFromUI(o)}catch(n){console.error("Cabbage: sendMessageFromUI threw error:",n),console.error("Cabbage: Error stack:",n.stack)}else window.parent!==window?window.parent.postMessage(o,"*"):(console.error("Cabbage: window.sendMessageFromUI is not available yet. Message:",o),console.error("Cabbage: typeof window.sendMessageFromUI:",typeof window.sendMessageFromUI),console.error("Cabbage: window.sendMessageFromUI value:",window.sendMessageFromUI))}}const I=(r,e)=>{const[a,s]=l.useState();return l.useEffect(()=>{const o=n=>{const{id:t,widgetJson:m,command:p}=n.data;if(t===r&&m&&p==="widgetUpdate"){const g=JSON.parse(m);console.log(`[Cabbage-React] Received properties for channelId: ${t}`,g),e&&e(g),s(g)}};return window.addEventListener("message",o),()=>window.removeEventListener("message",o)},[r,e]),{properties:a,onPropertiesUpdate:e}},F=(r,e="complete",a)=>{const{properties:s}=I(r),[o,n]=l.useState(),[t,m]=l.useState(),p=i=>{n(i),y.sendControlData({channel:r,value:i,gesture:e})},g=i=>{a&&a(i),n(i)};return l.useEffect(()=>{var u;const i=s==null?void 0:s.channels.find(d=>d.id===r);if(!i)return;const w=i.parameterIndex;if(t===void 0&&w!==void 0&&(console.log(`[Cabbage-React] Received parameterIndex for channelId: ${i.id}`,w),m(w)),o!==void 0)return;const c=(u=i.range)==null?void 0:u.value;c!=null&&(console.log(`[Cabbage-React] Received initial value for channelId: ${i.id}`,c),g(c))},[s]),l.useEffect(()=>{const i=w=>{var u;const{command:c}=w.data;if(c==="parameterChange"){const{value:d,paramIdx:f}=w.data.data;if(f!==t||d===null)return;console.log(`[Cabbage-React] Received parameterChange for parameterIndex: ${f}`,d),g(d)}else if(c==="batchWidgetUpdate"){const d=w.data.widgets,f=d==null?void 0:d.find(M=>M.id===r);if(!f)return;const b=JSON.parse(f.widgetJson).channels.find(M=>M.id===r),C=(u=b==null?void 0:b.range)==null?void 0:u.value;console.log(`[Cabbage-React] Received batch widget update for channelId: ${f.id}`,C),g(C)}};return window.addEventListener("message",i),()=>window.removeEventListener("message",i)},[r,a,t]),{value:o,setValue:p}},U=(r,e)=>{const[a,s]=l.useState();return l.useEffect(()=>{const o=n=>{const{data:t,type:m}=n;!t||m!=="message"||t.type===r&&(console.log(`[Cabbage-React] Received data for messageType: ${t.type}`,t),e&&e(t),s(t))};return window.addEventListener("message",o),()=>window.removeEventListener("message",o)},[r,e]),{message:a}};exports.Cabbage=y;exports.useCabbageMessage=U;exports.useCabbageProperties=I;exports.useCabbageState=F;

package/dist/index.mjs

@@ -1,5 +1,5 @@
-import { useState as m, useEffect as f } from "react";
-class C {
+import { useState as u, useEffect as p } from "react";
+class I {
   /**
    * Send a widget value change to the Cabbage backend.
    *
@@ -20,16 +20,16 @@ class C {
    * @param {string} [data.gesture="complete"] - The gesture type: "begin" (start of interaction), "value" (during interaction), "end" (end of continuous interaction), or "complete" (discrete action e.g. button click).
    * @param {Object|null} vscode - VS Code API object (null for plugin mode)
    */
-  static sendControlData({ channel: a, value: s, gesture: n = "complete" }, o = null) {
-    const e = {
+  static sendControlData({ channel: e, value: n, gesture: s = "complete" }, o = null) {
+    const a = {
       command: "controlData",
-      channel: a,
-      value: s,
-      gesture: n
+      channel: e,
+      value: n,
+      gesture: s
     };
-    o !== null ? o.postMessage(e) : typeof window.sendMessageFromUI == "function" ? window.sendMessageFromUI(e) : window.parent !== window ? window.parent.postMessage(e, "*") : console.error(
+    o !== null ? o.postMessage(a) : typeof window.sendMessageFromUI == "function" ? window.sendMessageFromUI(a) : window.parent !== window ? window.parent.postMessage(a, "*") : console.error(
       "Cabbage: window.sendMessageFromUI is not available. Message:",
-      e
+      a
     );
   }
   /**
@@ -38,8 +38,8 @@ class C {
    * @param {Object|null} vscode - VS Code API object (null for plugin mode)
    * @param {Object} additionalData - Additional initialization data
    */
-  static isReadyToLoad(a = null, s = {}) {
-    this.sendCustomCommand("isReadyToLoad", a);
+  static isReadyToLoad(e = null, n = {}) {
+    this.sendCustomCommand("isReadyToLoad", e);
   }
   /**
    * Send a MIDI message from the UI to the Cabbage backend.
@@ -49,19 +49,19 @@ class C {
    * @param {number} dataByte2 - Second MIDI data byte
    * @param {Object|null} vscode - VS Code API object (null for plugin mode)
    */
-  static sendMidiMessageFromUI(a, s, n, o = null) {
-    var e = {
-      statusByte: a,
-      dataByte1: s,
-      dataByte2: n
+  static sendMidiMessageFromUI(e, n, s, o = null) {
+    var a = {
+      statusByte: e,
+      dataByte1: n,
+      dataByte2: s
     };
-    const i = {
+    const t = {
       command: "midiMessage",
-      obj: JSON.stringify(e)
+      obj: JSON.stringify(a)
     };
-    o !== null ? o.postMessage(i) : typeof window.sendMessageFromUI == "function" ? window.sendMessageFromUI(i) : window.parent !== window ? window.parent.postMessage(i, "*") : console.error(
+    o !== null ? o.postMessage(t) : typeof window.sendMessageFromUI == "function" ? window.sendMessageFromUI(t) : window.parent !== window ? window.parent.postMessage(t, "*") : console.error(
       "Cabbage: window.sendMessageFromUI is not available. Message:",
-      i
+      t
     );
   }
   /**
@@ -71,7 +71,7 @@ class C {
    * @param {number} dataByte1 - First MIDI data byte
    * @param {number} dataByte2 - Second MIDI data byte
    */
-  static MidiMessageFromHost(a, s, n) {
+  static MidiMessageFromHost(e, n, s) {
   }
   /**
    * Trigger a native file open dialog for file selection widgets.
@@ -83,20 +83,20 @@ class C {
    * @param {string} [options.filters="*"] - File filters (e.g., "*.wav;*.aiff")
    * @param {boolean} [options.openAtLastKnownLocation=true] - Whether to open at last known location
    */
-  static triggerFileOpenDialog(a, s, n = {}) {
+  static triggerFileOpenDialog(e, n, s = {}) {
     var o = {
-      channel: s,
-      directory: n.directory || "",
-      filters: n.filters || "*",
-      openAtLastKnownLocation: n.openAtLastKnownLocation !== void 0 ? n.openAtLastKnownLocation : !0
+      channel: n,
+      directory: s.directory || "",
+      filters: s.filters || "*",
+      openAtLastKnownLocation: s.openAtLastKnownLocation !== void 0 ? s.openAtLastKnownLocation : !0
     };
-    const e = {
+    const a = {
       command: "fileOpen",
       obj: JSON.stringify(o)
     };
-    a !== null ? a.postMessage(e) : typeof window.sendMessageFromUI == "function" ? window.sendMessageFromUI(e) : window.parent !== window ? window.parent.postMessage(e, "*") : console.error(
+    e !== null ? e.postMessage(a) : typeof window.sendMessageFromUI == "function" ? window.sendMessageFromUI(a) : window.parent !== window ? window.parent.postMessage(a, "*") : console.error(
       "Cabbage: window.sendMessageFromUI is not available. Message:",
-      e
+      a
     );
   }
   /**
@@ -106,18 +106,18 @@ class C {
    * @param {string} url - URL to open
    * @param {string} file - File path to open
    */
-  static openUrl(a, s, n) {
+  static openUrl(e, n, s) {
     var o = {
-      url: s,
-      file: n
+      url: n,
+      file: s
     };
-    const e = {
+    const a = {
       command: "openUrl",
       obj: JSON.stringify(o)
     };
-    a !== null ? a.postMessage(e) : typeof window.sendMessageFromUI == "function" ? window.sendMessageFromUI(e) : window.parent !== window ? window.parent.postMessage(e, "*") : console.error(
+    e !== null ? e.postMessage(a) : typeof window.sendMessageFromUI == "function" ? window.sendMessageFromUI(a) : window.parent !== window ? window.parent.postMessage(a, "*") : console.error(
       "Cabbage: window.sendMessageFromUI is not available. Message:",
-      e
+      a
     );
   }
   /**
@@ -132,13 +132,13 @@ class C {
    * The response will be sent via hostMessageCallback with:
    * {command: "resizeResponse", accepted: boolean, width: number, height: number}
    */
-  static requestResize(a, s, n = null) {
+  static requestResize(e, n, s = null) {
     const o = {
       command: "requestResize",
-      width: a,
-      height: s
+      width: e,
+      height: n
     };
-    if (n !== null) {
+    if (s !== null) {
       console.warn(
         "Cabbage: requestResize is not supported in VS Code extension mode"
       );
@@ -168,8 +168,8 @@ class C {
    * myCustomEditor.addEventListener('focus', () => Cabbage.consumeKeypresses(true));
    * myCustomEditor.addEventListener('blur',  () => Cabbage.consumeKeypresses(false));
    */
-  static consumeKeypresses(a) {
-    typeof window.consumeKeypresses == "function" && window.consumeKeypresses(a);
+  static consumeKeypresses(e) {
+    typeof window.consumeKeypresses == "function" && window.consumeKeypresses(e);
   }
   /**
    * Send channel data directly to Csound without DAW automation involvement.
@@ -178,28 +178,28 @@ class C {
    * @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(a, s, n = null) {
+  static sendChannelData(e, n, s = null) {
     var o = {
-      channel: a
+      channel: e
     };
-    if (typeof s == "string")
-      o.stringData = s;
-    else if (typeof s == "number")
-      o.floatData = s;
+    if (typeof n == "string")
+      o.stringData = n;
+    else if (typeof n == "number")
+      o.floatData = n;
     else {
       console.warn(
         "Cabbage: sendChannelData received unsupported data type:",
-        typeof s
+        typeof n
       );
       return;
     }
-    const e = {
+    const a = {
       command: "channelData",
       obj: JSON.stringify(o)
     };
-    n !== null ? n.postMessage(e) : typeof window.sendMessageFromUI == "function" ? window.sendMessageFromUI(e) : window.parent !== window ? window.parent.postMessage(e, "*") : console.error(
+    s !== null ? s.postMessage(a) : typeof window.sendMessageFromUI == "function" ? window.sendMessageFromUI(a) : window.parent !== window ? window.parent.postMessage(a, "*") : console.error(
       "Cabbage: window.sendMessageFromUI is not available. Message:",
-      e
+      a
     );
   }
   /**
@@ -209,14 +209,14 @@ class C {
    * @param {Object} widget - The widget configuration object to update
    * @param {Object|null} vscode - VS Code API object (null for plugin mode)
    */
-  static sendWidgetUpdate(a, s = null) {
-    const n = {
+  static sendWidgetUpdate(e, n = null) {
+    const s = {
       command: "widgetStateUpdate",
-      obj: JSON.stringify(CabbageUtils.sanitizeForEditor(a))
+      obj: JSON.stringify(CabbageUtils.sanitizeForEditor(e))
     };
-    s !== null ? s.postMessage(n) : typeof window.sendMessageFromUI == "function" ? window.sendMessageFromUI(n) : window.parent !== window ? window.parent.postMessage(n, "*") : console.error(
+    n !== null ? n.postMessage(s) : typeof window.sendMessageFromUI == "function" ? window.sendMessageFromUI(s) : window.parent !== window ? window.parent.postMessage(s, "*") : console.error(
       "Cabbage: window.sendMessageFromUI is not available. Message:",
-      n
+      s
     );
   }
   /**
@@ -254,26 +254,26 @@ class C {
    * onMount(() => { remove = Cabbage.addMessageListener((msg) => { ... }); });
    * onDestroy(() => remove?.());
    */
-  static addMessageListener(a) {
-    const s = (n) => {
-      n.source !== window && a(n.data);
+  static addMessageListener(e) {
+    const n = (s) => {
+      s.source !== window && e(s.data);
     };
-    return window.addEventListener("message", s), window.hostMessageCallback = a, () => {
-      window.removeEventListener("message", s), window.hostMessageCallback === a && (window.hostMessageCallback = null);
+    return window.addEventListener("message", n), window.hostMessageCallback = e, () => {
+      window.removeEventListener("message", n), window.hostMessageCallback === e && (window.hostMessageCallback = null);
     };
   }
-  static sendCustomCommand(a, s = null, n = {}) {
+  static sendCustomCommand(e, n = null, s = {}) {
     const o = {
-      command: a,
-      text: JSON.stringify(n)
+      command: e,
+      text: JSON.stringify(s)
     };
-    if (s !== null)
-      s.postMessage(o);
+    if (n !== null)
+      n.postMessage(o);
     else if (typeof window.sendMessageFromUI == "function")
       try {
-        const e = window.sendMessageFromUI(o);
-      } catch (e) {
-        console.error("Cabbage: sendMessageFromUI threw error:", e), console.error("Cabbage: Error stack:", e.stack);
+        const a = window.sendMessageFromUI(o);
+      } catch (a) {
+        console.error("Cabbage: sendMessageFromUI threw error:", a), console.error("Cabbage: Error stack:", a.stack);
       }
     else window.parent !== window ? window.parent.postMessage(o, "*") : (console.error(
       "Cabbage: window.sendMessageFromUI is not available yet. Message:",
@@ -287,102 +287,94 @@ class C {
     ));
   }
 }
-const y = (r) => {
-  const [a, s] = m();
-  return f(() => {
-    const n = (o) => {
-      const { id: e, widgetJson: i, command: p } = o.data;
-      if (e === r && i && p === "widgetUpdate") {
-        const t = JSON.parse(i);
+const F = (r, e) => {
+  const [n, s] = u();
+  return p(() => {
+    const o = (a) => {
+      const { id: t, widgetJson: c, command: b } = a.data;
+      if (t === r && c && b === "widgetUpdate") {
+        const l = JSON.parse(c);
         console.log(
-          `[Cabbage-React] Received properties for channelId: ${e}`,
-          t
-        ), s(t);
+          `[Cabbage-React] Received properties for channelId: ${t}`,
+          l
+        ), e && e(l), s(l);
       }
     };
-    return window.addEventListener("message", n), () => {
-      window.removeEventListener("message", n);
-    };
-  }, []), {
-    properties: a
+    return window.addEventListener("message", o), () => window.removeEventListener("message", o);
+  }, [r, e]), {
+    properties: n,
+    onPropertiesUpdate: e
   };
-}, F = (r, a = "complete") => {
-  const { properties: s } = y(r), [n, o] = m(), [e, i] = m(), p = (t) => {
-    o(t), C.sendControlData({
+}, h = (r, e = "complete", n) => {
+  const { properties: s } = F(r), [o, a] = u(), [t, c] = u(), b = (i) => {
+    a(i), I.sendControlData({
       channel: r,
-      value: t,
-      gesture: a
+      value: i,
+      gesture: e
     });
+  }, l = (i) => {
+    n && n(i), a(i);
   };
-  return f(() => {
-    var c;
-    const t = s == null ? void 0 : s.channels.find(
+  return p(() => {
+    var f;
+    const i = s == null ? void 0 : s.channels.find(
       (d) => d.id === r
     );
-    if (!t) return;
-    const l = t.parameterIndex;
-    if (e === void 0 && l !== void 0 && (console.log(
-      `[Cabbage-React] Received parameterIndex for channelId: ${t.id}`,
-      l
-    ), i(l)), n !== void 0) return;
-    const w = (c = t.range) == null ? void 0 : c.value;
-    w != null && (console.log(
-      `[Cabbage-React] Received initial value for channelId: ${t.id}`,
+    if (!i) return;
+    const w = i.parameterIndex;
+    if (t === void 0 && w !== void 0 && (console.log(
+      `[Cabbage-React] Received parameterIndex for channelId: ${i.id}`,
       w
-    ), o(w));
-  }, [s]), f(() => {
-    const t = (l) => {
-      var c;
-      const { command: w } = l.data;
-      if (w === "parameterChange") {
-        const { value: d, paramIdx: g } = l.data.data;
-        if (g !== e || d === null) return;
+    ), c(w)), o !== void 0) return;
+    const g = (f = i.range) == null ? void 0 : f.value;
+    g != null && (console.log(
+      `[Cabbage-React] Received initial value for channelId: ${i.id}`,
+      g
+    ), l(g));
+  }, [s]), p(() => {
+    const i = (w) => {
+      var f;
+      const { command: g } = w.data;
+      if (g === "parameterChange") {
+        const { value: d, paramIdx: m } = w.data.data;
+        if (m !== t || d === null) return;
         console.log(
-          `[Cabbage-React] Received parameterChange for parameterIndex: ${g}`,
+          `[Cabbage-React] Received parameterChange for parameterIndex: ${m}`,
           d
-        ), o(d);
-      } else if (w === "batchWidgetUpdate") {
-        const d = l.data.widgets, g = d == null ? void 0 : d.find((b) => b.id === r);
-        if (!g) return;
-        const u = JSON.parse(g.widgetJson).channels.find(
-          (b) => b.id === r
-        ), M = (c = u == null ? void 0 : u.range) == null ? void 0 : c.value;
+        ), l(d);
+      } else if (g === "batchWidgetUpdate") {
+        const d = w.data.widgets, m = d == null ? void 0 : d.find((C) => C.id === r);
+        if (!m) return;
+        const M = JSON.parse(m.widgetJson).channels.find(
+          (C) => C.id === r
+        ), y = (f = M == null ? void 0 : M.range) == null ? void 0 : f.value;
         console.log(
-          `[Cabbage-React] Received batch widget update for channelId: ${g.id}`,
-          M
-        ), o(M);
+          `[Cabbage-React] Received batch widget update for channelId: ${m.id}`,
+          y
+        ), l(y);
       }
     };
-    return window.addEventListener("message", t), () => {
-      window.removeEventListener("message", t);
-    };
-  }, [e]), {
-    value: n,
-    setValue: p
+    return window.addEventListener("message", i), () => window.removeEventListener("message", i);
+  }, [r, n, t]), {
+    value: o,
+    setValue: b
   };
-}, v = (r) => {
-  const [a, s] = m();
-  return f(() => {
-    const n = (o) => {
-      const { data: e, type: i } = o;
-      if (e && i === "message") {
-        if (e.type !== r) return;
-        console.log(
-          `[Cabbage-React] Received data for messageType: ${e.type}`,
-          e
-        ), s(e);
-      }
-    };
-    return window.addEventListener("message", n), () => {
-      window.removeEventListener("message", n);
+}, L = (r, e) => {
+  const [n, s] = u();
+  return p(() => {
+    const o = (a) => {
+      const { data: t, type: c } = a;
+      !t || c !== "message" || t.type === r && (console.log(
+        `[Cabbage-React] Received data for messageType: ${t.type}`,
+        t
+      ), e && e(t), s(t));
     };
-  }, []), {
-    data: a
-  };
+    return window.addEventListener("message", o), () => window.removeEventListener("message", o);
+  }, [r, e]), { message: n };
 };
 export {
-  C as Cabbage,
-  v as useCabbageMessage,
-  y as useCabbageProperties,
-  F as useCabbageState
+  I as Cabbage,
+  L as useCabbageMessage,
+  F as useCabbageProperties,
+  h as useCabbageState
 };

package/package.json

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