cabbage-react 1.0.49 → 1.0.51

package/dist/hooks/useCabbageMessage.d.ts

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

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

@@ -1 +1 @@
-{"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;;CA0BhC,CAAC"}
+{"version":3,"file":"useCabbageMessage.d.ts","sourceRoot":"","sources":["../../src/hooks/useCabbageMessage.ts"],"names":[],"mappings":"AAEA;;;;;;GAMG;AACH,eAAO,MAAM,iBAAiB,GAAI,CAAC,EAClC,aAAa,MAAM,EACnB,YAAY,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;;CA8BrD,CAAC"}
+{"version":3,"file":"useCabbageProperties.d.ts","sourceRoot":"","sources":["../../src/hooks/useCabbageProperties.ts"],"names":[],"mappings":"AAEA;;;;;;GAMG;AACH,eAAO,MAAM,oBAAoB,GAChC,WAAW,MAAM,EACjB,qBAAqB,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;CA2FnC,CAAC"}
+{"version":3,"file":"useCabbageState.d.ts","sourceRoot":"","sources":["../../src/hooks/useCabbageState.ts"],"names":[],"mappings":"AAIA;;;;;;;GAOG;AACH,eAAO,MAAM,eAAe,GAAI,CAAC,EAChC,WAAW,MAAM,EACjB,UAAS,OAAO,GAAG,OAAO,GAAG,KAAK,GAAG,UAAuB,EAC5D,gBAAgB,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:s,value:e,gesture:a="complete"},o=null){const n={command:"controlData",channel:s,value:e,gesture:a};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(s=null,e={}){this.sendCustomCommand("isReadyToLoad",s)}static sendMidiMessageFromUI(s,e,a,o=null){var n={statusByte:s,dataByte1:e,dataByte2:a};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(s,e,a){}static triggerFileOpenDialog(s,e,a={}){var o={channel:e,directory:a.directory||"",filters:a.filters||"*",openAtLastKnownLocation:a.openAtLastKnownLocation!==void 0?a.openAtLastKnownLocation:!0};const n={command:"fileOpen",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 openUrl(s,e,a){var o={url:e,file:a};const n={command:"openUrl",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 requestResize(s,e,a=null){const o={command:"requestResize",width:s,height:e};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(s){typeof window.consumeKeypresses=="function"&&window.consumeKeypresses(s)}static sendChannelData(s,e,a=null){var o={channel:s};if(typeof e=="string")o.stringData=e;else if(typeof e=="number")o.floatData=e;else{console.warn("Cabbage: sendChannelData received unsupported data type:",typeof e);return}const n={command:"channelData",obj:JSON.stringify(o)};a!==null?a.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(s,e=null){const a={command:"widgetStateUpdate",obj:JSON.stringify(CabbageUtils.sanitizeForEditor(s))};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:",a)}static addMessageListener(s){const e=a=>{a.source!==window&&s(a.data)};return window.addEventListener("message",e),window.hostMessageCallback=s,()=>{window.removeEventListener("message",e),window.hostMessageCallback===s&&(window.hostMessageCallback=null)}}static sendCustomCommand(s,e=null,a={}){const o={command:s,text:JSON.stringify(a)};if(e!==null)e.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 C=r=>{const[s,e]=l.useState();return l.useEffect(()=>{const a=o=>{const{id:n,widgetJson:t,command:m}=o.data;if(n===r&&t&&m==="widgetUpdate"){const i=JSON.parse(t);console.log(`[Cabbage-React] Received properties for channelId: ${n}`,i),e(i)}};return window.addEventListener("message",a),()=>window.removeEventListener("message",a)},[]),{properties:s}},y=(r,s="complete")=>{const{properties:e}=C(r),[a,o]=l.useState(),[n,t]=l.useState(),m=i=>{o(i),M.sendControlData({channel:r,value:i,gesture:s})};return l.useEffect(()=>{var f;const i=e==null?void 0:e.channels.find(d=>d.id===r);if(!i)return;const g=i.parameterIndex;if(n===void 0&&g!==void 0&&(console.log(`[Cabbage-React] Received parameterIndex for channelId: ${i.id}`,g),t(g)),a!==void 0)return;const w=(f=i.range)==null?void 0:f.value;w!=null&&(console.log(`[Cabbage-React] Received initial value for channelId: ${i.id}`,w),o(w))},[e]),l.useEffect(()=>{const i=g=>{var f;const{command:w}=g.data;if(w==="parameterChange"){const{value:d,paramIdx:c}=g.data.data;if(c!==n||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=(f=u==null?void 0:u.range)==null?void 0:f.value;console.log(`[Cabbage-React] Received batch widget update for channelId: ${c.id}`,b),o(b)}};return window.addEventListener("message",i),()=>window.removeEventListener("message",i)},[n]),{value:a,setValue:m}},I=(r,s)=>{const[e,a]=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),s&&s(t),a(t))};return window.addEventListener("message",o),()=>window.removeEventListener("message",o)},[r,s]),{message:e}};exports.Cabbage=M;exports.useCabbageMessage=I;exports.useCabbageProperties=C;exports.useCabbageState=y;
+"use strict";Object.defineProperty(exports,Symbol.toStringTag,{value:"Module"});const d=require("react");class M{static sendControlData({channel:e,value:s,gesture:n="complete"},o=null){const a={command:"controlData",channel:e,value:s,gesture:n};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:",a)}static isReadyToLoad(e=null,s={}){this.sendCustomCommand("isReadyToLoad",e)}static sendMidiMessageFromUI(e,s,n,o=null){var a={statusByte:e,dataByte1:s,dataByte2:n};const t={command:"midiMessage",obj:JSON.stringify(a)};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,s,n){}static triggerFileOpenDialog(e,s,n={}){var o={channel:s,directory:n.directory||"",filters:n.filters||"*",openAtLastKnownLocation:n.openAtLastKnownLocation!==void 0?n.openAtLastKnownLocation:!0};const a={command:"fileOpen",obj:JSON.stringify(o)};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:",a)}static openUrl(e,s,n){var o={url:s,file:n};const a={command:"openUrl",obj:JSON.stringify(o)};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:",a)}static requestResize(e,s,n=null){const o={command:"requestResize",width:e,height:s};if(n!==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,s,n=null){var o={channel:e};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 a={command:"channelData",obj:JSON.stringify(o)};n!==null?n.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 sendWidgetUpdate(e,s=null){const n={command:"widgetStateUpdate",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("Cabbage: window.sendMessageFromUI is not available. Message:",n)}static addMessageListener(e){const s=n=>{n.source!==window&&e(n.data)};return window.addEventListener("message",s),window.hostMessageCallback=e,()=>{window.removeEventListener("message",s),window.hostMessageCallback===e&&(window.hostMessageCallback=null)}}static sendCustomCommand(e,s=null,n={}){const o={command:e,text:JSON.stringify(n)};if(s!==null)s.postMessage(o);else if(typeof window.sendMessageFromUI=="function")try{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:",o),console.error("Cabbage: typeof window.sendMessageFromUI:",typeof window.sendMessageFromUI),console.error("Cabbage: window.sendMessageFromUI value:",window.sendMessageFromUI))}}const C=(r,e)=>{const[s,n]=d.useState();return d.useEffect(()=>{const o=a=>{const{id:t,widgetJson:c,command:u}=a.data;if(t===r&&c&&u==="widgetUpdate"){const l=JSON.parse(c);console.log(`[Cabbage-React] Received properties for channelId: ${t}`,l),e&&e(l),n(l)}};return window.addEventListener("message",o),()=>window.removeEventListener("message",o)},[r,e]),{properties:s,onPropertiesUpdate:e}},y=(r,e="complete",s)=>{const{properties:n}=C(r),[o,a]=d.useState(),[t,c]=d.useState(),u=i=>{a(i),M.sendControlData({channel:r,value:i,gesture:e})},l=i=>{s&&s(i),a(i)};return d.useEffect(()=>{const i=n?.channels.find(m=>m.id===r);if(!i)return;const g=i.parameterIndex;if(t===void 0&&g!==void 0&&(console.log(`[Cabbage-React] Received parameterIndex for channelId: ${i.id}`,g),c(g)),o!==void 0)return;const w=i.range?.value;w!=null&&(console.log(`[Cabbage-React] Received initial value for channelId: ${i.id}`,w),l(w))},[n]),d.useEffect(()=>{const i=g=>{const{command:w}=g.data;if(w==="parameterChange"){const{value:m,paramIdx:f}=g.data.data;if(f!==t||m===null)return;console.log(`[Cabbage-React] Received parameterChange for parameterIndex: ${f}`,m),l(m)}else if(w==="batchWidgetUpdate"){const f=g.data.widgets?.find(p=>p.id===r);if(!f)return;const b=JSON.parse(f.widgetJson).channels.find(p=>p.id===r)?.range?.value;console.log(`[Cabbage-React] Received batch widget update for channelId: ${f.id}`,b),l(b)}};return window.addEventListener("message",i),()=>window.removeEventListener("message",i)},[r,s,t]),{value:o,setValue:u}},I=(r,e)=>{const[s,n]=d.useState();return d.useEffect(()=>{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),n(t))};return window.addEventListener("message",o),()=>window.removeEventListener("message",o)},[r,e]),{message:s}};exports.Cabbage=M;exports.useCabbageMessage=I;exports.useCabbageProperties=C;exports.useCabbageState=y;

package/dist/index.mjs

@@ -20,11 +20,11 @@ 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: s, value: e, gesture: n = "complete" }, o = null) {
+  static sendControlData({ channel: e, value: s, gesture: n = "complete" }, o = null) {
     const a = {
       command: "controlData",
-      channel: s,
-      value: e,
+      channel: e,
+      value: s,
       gesture: n
     };
     o !== null ? o.postMessage(a) : typeof window.sendMessageFromUI == "function" ? window.sendMessageFromUI(a) : window.parent !== window ? window.parent.postMessage(a, "*") : console.error(
@@ -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(s = null, e = {}) {
-    this.sendCustomCommand("isReadyToLoad", s);
+  static isReadyToLoad(e = null, s = {}) {
+    this.sendCustomCommand("isReadyToLoad", e);
   }
   /**
    * Send a MIDI message from the UI to the Cabbage backend.
@@ -49,10 +49,10 @@ class C {
    * @param {number} dataByte2 - Second MIDI data byte
    * @param {Object|null} vscode - VS Code API object (null for plugin mode)
    */
-  static sendMidiMessageFromUI(s, e, n, o = null) {
+  static sendMidiMessageFromUI(e, s, n, o = null) {
     var a = {
-      statusByte: s,
-      dataByte1: e,
+      statusByte: e,
+      dataByte1: s,
       dataByte2: n
     };
     const t = {
@@ -71,7 +71,7 @@ class C {
    * @param {number} dataByte1 - First MIDI data byte
    * @param {number} dataByte2 - Second MIDI data byte
    */
-  static MidiMessageFromHost(s, e, n) {
+  static MidiMessageFromHost(e, s, n) {
   }
   /**
    * Trigger a native file open dialog for file selection widgets.
@@ -83,9 +83,9 @@ 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(s, e, n = {}) {
+  static triggerFileOpenDialog(e, s, n = {}) {
     var o = {
-      channel: e,
+      channel: s,
       directory: n.directory || "",
       filters: n.filters || "*",
       openAtLastKnownLocation: n.openAtLastKnownLocation !== void 0 ? n.openAtLastKnownLocation : !0
@@ -94,7 +94,7 @@ class C {
       command: "fileOpen",
       obj: JSON.stringify(o)
     };
-    s !== null ? s.postMessage(a) : typeof window.sendMessageFromUI == "function" ? window.sendMessageFromUI(a) : window.parent !== window ? window.parent.postMessage(a, "*") : 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:",
       a
     );
@@ -106,16 +106,16 @@ class C {
    * @param {string} url - URL to open
    * @param {string} file - File path to open
    */
-  static openUrl(s, e, n) {
+  static openUrl(e, s, n) {
     var o = {
-      url: e,
+      url: s,
       file: n
     };
     const a = {
       command: "openUrl",
       obj: JSON.stringify(o)
     };
-    s !== null ? s.postMessage(a) : typeof window.sendMessageFromUI == "function" ? window.sendMessageFromUI(a) : window.parent !== window ? window.parent.postMessage(a, "*") : 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:",
       a
     );
@@ -132,11 +132,11 @@ class C {
    * The response will be sent via hostMessageCallback with:
    * {command: "resizeResponse", accepted: boolean, width: number, height: number}
    */
-  static requestResize(s, e, n = null) {
+  static requestResize(e, s, n = null) {
     const o = {
       command: "requestResize",
-      width: s,
-      height: e
+      width: e,
+      height: s
     };
     if (n !== null) {
       console.warn(
@@ -168,8 +168,8 @@ class C {
    * myCustomEditor.addEventListener('focus', () => Cabbage.consumeKeypresses(true));
    * myCustomEditor.addEventListener('blur',  () => Cabbage.consumeKeypresses(false));
    */
-  static consumeKeypresses(s) {
-    typeof window.consumeKeypresses == "function" && window.consumeKeypresses(s);
+  static consumeKeypresses(e) {
+    typeof window.consumeKeypresses == "function" && window.consumeKeypresses(e);
   }
   /**
    * Send channel data directly to Csound without DAW automation involvement.
@@ -178,18 +178,18 @@ 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(s, e, n = null) {
+  static sendChannelData(e, s, n = null) {
     var o = {
-      channel: s
+      channel: e
     };
-    if (typeof e == "string")
-      o.stringData = e;
-    else if (typeof e == "number")
-      o.floatData = e;
+    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 e
+        typeof s
       );
       return;
     }
@@ -209,12 +209,12 @@ 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(s, e = null) {
+  static sendWidgetUpdate(e, s = null) {
     const n = {
       command: "widgetStateUpdate",
-      obj: JSON.stringify(CabbageUtils.sanitizeForEditor(s))
+      obj: JSON.stringify(CabbageUtils.sanitizeForEditor(e))
     };
-    e !== null ? e.postMessage(n) : typeof window.sendMessageFromUI == "function" ? window.sendMessageFromUI(n) : window.parent !== window ? window.parent.postMessage(n, "*") : console.error(
+    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
     );
@@ -254,21 +254,21 @@ class C {
    * onMount(() => { remove = Cabbage.addMessageListener((msg) => { ... }); });
    * onDestroy(() => remove?.());
    */
-  static addMessageListener(s) {
-    const e = (n) => {
-      n.source !== window && s(n.data);
+  static addMessageListener(e) {
+    const s = (n) => {
+      n.source !== window && e(n.data);
     };
-    return window.addEventListener("message", e), window.hostMessageCallback = s, () => {
-      window.removeEventListener("message", e), window.hostMessageCallback === s && (window.hostMessageCallback = null);
+    return window.addEventListener("message", s), window.hostMessageCallback = e, () => {
+      window.removeEventListener("message", s), window.hostMessageCallback === e && (window.hostMessageCallback = null);
     };
   }
-  static sendCustomCommand(s, e = null, n = {}) {
+  static sendCustomCommand(e, s = null, n = {}) {
     const o = {
-      command: s,
+      command: e,
       text: JSON.stringify(n)
     };
-    if (e !== null)
-      e.postMessage(o);
+    if (s !== null)
+      s.postMessage(o);
     else if (typeof window.sendMessageFromUI == "function")
       try {
         const a = window.sendMessageFromUI(o);
@@ -287,91 +287,92 @@ class C {
     ));
   }
 }
-const y = (r) => {
-  const [s, e] = f();
+const y = (r, e) => {
+  const [s, n] = f();
   return p(() => {
-    const n = (o) => {
-      const { id: a, widgetJson: t, command: c } = o.data;
-      if (a === r && t && c === "widgetUpdate") {
-        const i = JSON.parse(t);
+    const o = (a) => {
+      const { id: t, widgetJson: g, command: u } = a.data;
+      if (t === r && g && u === "widgetUpdate") {
+        const d = JSON.parse(g);
         console.log(
-          `[Cabbage-React] Received properties for channelId: ${a}`,
-          i
-        ), e(i);
+          `[Cabbage-React] Received properties for channelId: ${t}`,
+          d
+        ), e && e(d), n(d);
       }
     };
-    return window.addEventListener("message", n), () => window.removeEventListener("message", n);
-  }, []), {
-    properties: s
+    return window.addEventListener("message", o), () => window.removeEventListener("message", o);
+  }, [r, e]), {
+    properties: s,
+    onPropertiesUpdate: e
   };
-}, F = (r, s = "complete") => {
-  const { properties: e } = y(r), [n, o] = f(), [a, t] = f(), c = (i) => {
-    o(i), C.sendControlData({
+}, h = (r, e = "complete", s) => {
+  const { properties: n } = y(r), [o, a] = f(), [t, g] = f(), u = (i) => {
+    a(i), C.sendControlData({
       channel: r,
       value: i,
-      gesture: s
+      gesture: e
     });
+  }, d = (i) => {
+    s && s(i), a(i);
   };
   return p(() => {
-    var m;
-    const i = e == null ? void 0 : e.channels.find(
-      (d) => d.id === r
+    const i = n?.channels.find(
+      (c) => c.id === r
     );
     if (!i) return;
     const l = i.parameterIndex;
-    if (a === void 0 && l !== void 0 && (console.log(
+    if (t === void 0 && l !== void 0 && (console.log(
       `[Cabbage-React] Received parameterIndex for channelId: ${i.id}`,
       l
-    ), t(l)), n !== void 0) return;
-    const w = (m = i.range) == null ? void 0 : m.value;
+    ), g(l)), o !== void 0) return;
+    const w = i.range?.value;
     w != null && (console.log(
       `[Cabbage-React] Received initial value for channelId: ${i.id}`,
       w
-    ), o(w));
-  }, [e]), p(() => {
+    ), d(w));
+  }, [n]), p(() => {
     const i = (l) => {
-      var m;
       const { command: w } = l.data;
       if (w === "parameterChange") {
-        const { value: d, paramIdx: g } = l.data.data;
-        if (g !== a || d === null) return;
+        const { value: c, paramIdx: m } = l.data.data;
+        if (m !== t || c === null) return;
         console.log(
-          `[Cabbage-React] Received parameterChange for parameterIndex: ${g}`,
-          d
-        ), o(d);
+          `[Cabbage-React] Received parameterChange for parameterIndex: ${m}`,
+          c
+        ), d(c);
       } 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(
+        const m = l.data.widgets?.find((b) => b.id === r);
+        if (!m) return;
+        const M = JSON.parse(m.widgetJson).channels.find(
           (b) => b.id === r
-        ), M = (m = u == null ? void 0 : u.range) == null ? void 0 : m.value;
+        )?.range?.value;
         console.log(
-          `[Cabbage-React] Received batch widget update for channelId: ${g.id}`,
+          `[Cabbage-React] Received batch widget update for channelId: ${m.id}`,
           M
-        ), o(M);
+        ), d(M);
       }
     };
     return window.addEventListener("message", i), () => window.removeEventListener("message", i);
-  }, [a]), {
-    value: n,
-    setValue: c
+  }, [r, s, t]), {
+    value: o,
+    setValue: u
   };
-}, v = (r, s) => {
-  const [e, n] = f();
+}, v = (r, e) => {
+  const [s, n] = f();
   return p(() => {
     const o = (a) => {
-      const { data: t, type: c } = a;
-      !t || c !== "message" || t.type === r && (console.log(
+      const { data: t, type: g } = a;
+      !t || g !== "message" || t.type === r && (console.log(
         `[Cabbage-React] Received data for messageType: ${t.type}`,
         t
-      ), s && s(t), n(t));
+      ), e && e(t), n(t));
     };
     return window.addEventListener("message", o), () => window.removeEventListener("message", o);
-  }, [r, s]), { message: e };
+  }, [r, e]), { message: s };
 };
 export {
   C as Cabbage,
   v as useCabbageMessage,
   y as useCabbageProperties,
-  F as useCabbageState
+  h as useCabbageState
 };

package/package.json

@@ -1,6 +1,6 @@
 {
 	"name": "cabbage-react",
-	"version": "1.0.49",
+	"version": "1.0.51",
 	"type": "module",
 	"keywords": [
 		"cabbage",
@@ -26,21 +26,21 @@
 		"build": "vite build"
 	},
 	"dependencies": {
-		"react": "^19.1.0",
-		"vite-plugin-dts": "^4.5.3"
+		"react": "^19.2.4",
+		"vite-plugin-dts": "^4.5.4"
 	},
 	"devDependencies": {
-		"@eslint/js": "^9.21.0",
-		"@types/node": "^22.15.17",
-		"@types/react": "^19.1.3",
-		"@vitejs/plugin-react": "^4.3.4",
-		"eslint": "^9.21.0",
-		"eslint-plugin-react-hooks": "^5.1.0",
-		"eslint-plugin-react-refresh": "^0.4.19",
-		"globals": "^15.15.0",
-		"typescript": "~5.7.2",
-		"typescript-eslint": "^8.24.1",
-		"vite": "^6.2.0"
+		"@eslint/js": "^10.0.1",
+		"@types/node": "^25.3.3",
+		"@types/react": "^19.2.14",
+		"@vitejs/plugin-react": "^5.1.4",
+		"eslint": "^10.0.2",
+		"eslint-plugin-react-hooks": "^7.0.1",
+		"eslint-plugin-react-refresh": "^0.5.2",
+		"globals": "^17.4.0",
+		"typescript": "~5.9.3",
+		"typescript-eslint": "^8.56.1",
+		"vite": "^7.3.1"
 	},
 	"files": [
 		"dist",