cabbage-react 1.0.49 → 1.0.50

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,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;;CA8BrD,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;CA2FnC,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: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 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 f, useEffect as p } 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,12 +20,12 @@ 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: n, gesture: s = "complete" }, o = null) {
     const a = {
       command: "controlData",
-      channel: s,
-      value: e,
-      gesture: n
+      channel: e,
+      value: n,
+      gesture: s
     };
     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:",
@@ -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, n = {}) {
+    this.sendCustomCommand("isReadyToLoad", e);
   }
   /**
    * Send a MIDI message from the UI to the Cabbage backend.
@@ -49,11 +49,11 @@ 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, n, s, o = null) {
     var a = {
-      statusByte: s,
-      dataByte1: e,
-      dataByte2: n
+      statusByte: e,
+      dataByte1: n,
+      dataByte2: s
     };
     const t = {
       command: "midiMessage",
@@ -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, n, s) {
   }
   /**
    * Trigger a native file open dialog for file selection widgets.
@@ -83,18 +83,18 @@ 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, n, s = {}) {
     var o = {
-      channel: e,
-      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 a = {
       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, n, s) {
     var o = {
-      url: e,
-      file: n
+      url: n,
+      file: s
     };
     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,13 +132,13 @@ 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, n, s = null) {
     const o = {
       command: "requestResize",
-      width: s,
-      height: e
+      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(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, n, s = null) {
     var o = {
-      channel: s
+      channel: e
     };
-    if (typeof e == "string")
-      o.stringData = e;
-    else if (typeof e == "number")
-      o.floatData = e;
+    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 e
+        typeof n
       );
       return;
     }
@@ -197,7 +197,7 @@ class C {
       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(
+    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
     );
@@ -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(s, e = null) {
-    const n = {
+  static sendWidgetUpdate(e, n = null) {
+    const s = {
       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(
+    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,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 n = (s) => {
+      s.source !== window && e(s.data);
     };
-    return window.addEventListener("message", e), window.hostMessageCallback = s, () => {
-      window.removeEventListener("message", e), window.hostMessageCallback === s && (window.hostMessageCallback = null);
+    return window.addEventListener("message", n), window.hostMessageCallback = e, () => {
+      window.removeEventListener("message", n), window.hostMessageCallback === e && (window.hostMessageCallback = null);
     };
   }
-  static sendCustomCommand(s, e = null, n = {}) {
+  static sendCustomCommand(e, n = null, s = {}) {
     const o = {
-      command: s,
-      text: JSON.stringify(n)
+      command: e,
+      text: JSON.stringify(s)
     };
-    if (e !== null)
-      e.postMessage(o);
+    if (n !== null)
+      n.postMessage(o);
     else if (typeof window.sendMessageFromUI == "function")
       try {
         const a = window.sendMessageFromUI(o);
@@ -287,91 +287,94 @@ class C {
     ));
   }
 }
-const y = (r) => {
-  const [s, e] = f();
+const F = (r, e) => {
+  const [n, s] = u();
   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: c, command: b } = a.data;
+      if (t === r && c && b === "widgetUpdate") {
+        const l = JSON.parse(c);
         console.log(
-          `[Cabbage-React] Received properties for channelId: ${a}`,
-          i
-        ), e(i);
+          `[Cabbage-React] Received properties for channelId: ${t}`,
+          l
+        ), e && e(l), s(l);
       }
     };
-    return window.addEventListener("message", n), () => window.removeEventListener("message", n);
-  }, []), {
-    properties: s
+    return window.addEventListener("message", o), () => window.removeEventListener("message", o);
+  }, [r, e]), {
+    properties: n,
+    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", n) => {
+  const { properties: s } = F(r), [o, a] = u(), [t, c] = u(), b = (i) => {
+    a(i), I.sendControlData({
       channel: r,
       value: i,
-      gesture: s
+      gesture: e
     });
+  }, l = (i) => {
+    n && n(i), a(i);
   };
   return p(() => {
-    var m;
-    const i = e == null ? void 0 : e.channels.find(
+    var f;
+    const i = s == null ? void 0 : s.channels.find(
       (d) => d.id === r
     );
     if (!i) return;
-    const l = i.parameterIndex;
-    if (a === void 0 && l !== void 0 && (console.log(
+    const w = i.parameterIndex;
+    if (t === void 0 && w !== 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;
-    w != null && (console.log(
-      `[Cabbage-React] Received initial value for channelId: ${i.id}`,
       w
-    ), o(w));
-  }, [e]), 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;
+    ), 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 = (m = u == null ? void 0 : u.range) == null ? void 0 : m.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", i), () => window.removeEventListener("message", i);
-  }, [a]), {
-    value: n,
-    setValue: c
+  }, [r, n, t]), {
+    value: o,
+    setValue: b
   };
-}, v = (r, s) => {
-  const [e, n] = f();
+}, 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
-      ), s && s(t), n(t));
+      ), e && e(t), s(t));
     };
     return window.addEventListener("message", o), () => window.removeEventListener("message", o);
-  }, [r, s]), { message: e };
+  }, [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.49",
+	"version": "1.0.50",
 	"type": "module",
 	"keywords": [
 		"cabbage",