cabbage-react 1.0.30 → 1.0.32

package/README.md

@@ -18,19 +18,39 @@ npm install cabbage-react
 
 ### useCabbageState
 
-Synchronize a parameter with the backend. This hook:
+Synchronize a channel with the backend. This hook:
 
-- Identifies and sets the default value defined in .csd to a state.
-- Handles initialization when opening an existing session, or reopening the plugin window.
-- Listens for value updates from the host (DAW), or from Csound.
-- Sends changes to the backend using the provided value-setter.
+- Automatically updates local state when value is received or changed
+- Sends changes to the backend using the provided value-setter
 
 ### useCabbageProperties
 
-Get properties for a parameter from the backend. This hook:
+Get properties for a widget from the backend. This hook:
 
-- Listens for property updates from the backend.
-- Updates local state automatically when data changes.
+- Automatically updates local state when properties are received or changed
+
+### useCabbageMessage
+
+Get messages from the backend. This hook:
+
+- Automatically updates local state when a message is received
+- Expects a serialized JSON object (sent as a string) with an `id` property
+
+#### Example: sending a message from Csound
+
+```csd
+jsonData:S = sprintf({{
+{
+	"id":"NoteData",
+	"noteCount":%f,
+	"note":%f,
+	"noteLength":%f,
+	"noteVelocity":%f
+}
+}}, iNoteCount, iNote, iLength, iVelocity)
+
+cabbageSendMessage(jsonData)
+```
 
 ## Usage
 

package/dist/hooks/useCabbageMessage.d.ts

@@ -0,0 +1,10 @@
+/**
+ * Custom hook to get a message from Cabbage backend.
+ * This hook listens to messages sent from the backend and updates the local state
+ * whenever new data is received.
+ * @param messageId
+ */
+export declare const useCabbageMessage: <T>(messageId: string) => {
+    message: T | undefined;
+};
+//# sourceMappingURL=useCabbageMessage.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"useCabbageMessage.d.ts","sourceRoot":"","sources":["../../src/hooks/useCabbageMessage.ts"],"names":[],"mappings":"AAEA;;;;;GAKG;AACH,eAAO,MAAM,iBAAiB,GAAI,CAAC,aAAa,MAAM;;CAgCrD,CAAC"}

package/dist/hooks/useCabbageProperties.d.ts

@@ -2,7 +2,7 @@
  * Custom hook to get a parameter's properties from Cabbage backend.
  * This hook listens for updates to parameter properties from the backend and updates the local state
  * whenever new data is received.
- * @param channelId - The channel name
+ * @param channelId
  */
 export declare const useCabbageProperties: (channelId: string) => {
     properties: Record<string, any> | undefined;

package/dist/hooks/useCabbageState.d.ts

@@ -2,7 +2,7 @@
  * Custom hook to sync a parameter with Cabbage backend.
  * This hook listens for updates to a parameter value from the backend and
  * sends updates to the backend when the parameter value changes locally (e.g., through a UI slider).
- * @param channelId - The channel name
+ * @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).
  */
 export declare const useCabbageState: <T>(channelId: string, gesture?: "begin" | "value" | "end" | "complete") => {

package/dist/index.cjs

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

package/dist/index.d.ts

@@ -1,4 +1,5 @@
 export { useCabbageState } from './hooks/useCabbageState';
 export { useCabbageProperties } from './hooks/useCabbageProperties';
+export { useCabbageMessage } from './hooks/useCabbageMessage';
 export { Cabbage } from './cabbage/cabbage';
 //# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

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

package/dist/index.mjs

@@ -1,6 +1,6 @@
-import { useState as u, useEffect as M } from "react";
+import { useState as f, useEffect as b } from "react";
 console.log("Cabbage: loading cabbage.js");
-class I {
+class C {
   /**
    * Send a widget value change to the Cabbage backend.
    *
@@ -21,16 +21,16 @@ class I {
    * @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: o, value: e, gesture: s = "complete" }, a = null) {
-    const n = {
+  static sendControlData({ channel: o, value: e, gesture: s = "complete" }, n = null) {
+    const a = {
       command: "controlData",
       channel: o,
       value: e,
       gesture: s
     };
-    a !== null ? a.postMessage(n) : typeof window.sendMessageFromUI == "function" ? window.sendMessageFromUI(n) : console.error(
+    n !== null ? n.postMessage(a) : typeof window.sendMessageFromUI == "function" ? window.sendMessageFromUI(a) : console.error(
       "Cabbage: window.sendMessageFromUI is not available. Message:",
-      n
+      a
     );
   }
   /**
@@ -50,19 +50,19 @@ class I {
    * @param {number} dataByte2 - Second MIDI data byte
    * @param {Object|null} vscode - VS Code API object (null for plugin mode)
    */
-  static sendMidiMessageFromUI(o, e, s, a = null) {
-    var n = {
+  static sendMidiMessageFromUI(o, e, s, n = null) {
+    var a = {
       statusByte: o,
       dataByte1: e,
       dataByte2: s
     };
-    const d = {
+    const r = {
       command: "midiMessage",
-      obj: JSON.stringify(n)
+      obj: JSON.stringify(a)
     };
-    a !== null ? a.postMessage(d) : typeof window.sendMessageFromUI == "function" ? window.sendMessageFromUI(d) : console.error(
+    n !== null ? n.postMessage(r) : typeof window.sendMessageFromUI == "function" ? window.sendMessageFromUI(r) : console.error(
       "Cabbage: window.sendMessageFromUI is not available. Message:",
-      d
+      r
     );
   }
   /**
@@ -88,19 +88,19 @@ class I {
    * @param {boolean} [options.openAtLastKnownLocation=true] - Whether to open at last known location
    */
   static triggerFileOpenDialog(o, e, s = {}) {
-    var a = {
+    var n = {
       channel: e,
       directory: s.directory || "",
       filters: s.filters || "*",
       openAtLastKnownLocation: s.openAtLastKnownLocation !== void 0 ? s.openAtLastKnownLocation : !0
     };
-    const n = {
+    const a = {
       command: "fileOpen",
-      obj: JSON.stringify(a)
+      obj: JSON.stringify(n)
     };
-    o !== null ? o.postMessage(n) : typeof window.sendMessageFromUI == "function" ? window.sendMessageFromUI(n) : console.error(
+    o !== null ? o.postMessage(a) : typeof window.sendMessageFromUI == "function" ? window.sendMessageFromUI(a) : console.error(
       "Cabbage: window.sendMessageFromUI is not available. Message:",
-      n
+      a
     );
   }
   /**
@@ -111,17 +111,17 @@ class I {
    * @param {string} file - File path to open
    */
   static openUrl(o, e, s) {
-    var a = {
+    var n = {
       url: e,
       file: s
     };
-    const n = {
+    const a = {
       command: "openUrl",
-      obj: JSON.stringify(a)
+      obj: JSON.stringify(n)
     };
-    o !== null ? o.postMessage(n) : typeof window.sendMessageFromUI == "function" ? window.sendMessageFromUI(n) : console.error(
+    o !== null ? o.postMessage(a) : typeof window.sendMessageFromUI == "function" ? window.sendMessageFromUI(a) : console.error(
       "Cabbage: window.sendMessageFromUI is not available. Message:",
-      n
+      a
     );
   }
   /**
@@ -137,7 +137,7 @@ class I {
    * {command: "resizeResponse", accepted: boolean, width: number, height: number}
    */
   static requestResize(o, e, s = null) {
-    const a = {
+    const n = {
       command: "requestResize",
       width: o,
       height: e
@@ -148,9 +148,9 @@ class I {
       );
       return;
     } else
-      typeof window.sendMessageFromUI == "function" ? window.sendMessageFromUI(a) : console.error(
+      typeof window.sendMessageFromUI == "function" ? window.sendMessageFromUI(n) : console.error(
         "Cabbage: window.sendMessageFromUI is not available. Message:",
-        a
+        n
       );
   }
   /**
@@ -161,13 +161,13 @@ class I {
    * @param {Object|null} vscode - VS Code API object (null for plugin mode)
    */
   static sendChannelData(o, e, s = null) {
-    var a = {
+    var n = {
       channel: o
     };
     if (typeof e == "string")
-      a.stringData = e;
+      n.stringData = e;
     else if (typeof e == "number")
-      a.floatData = e;
+      n.floatData = e;
     else {
       console.warn(
         "Cabbage: sendChannelData received unsupported data type:",
@@ -175,13 +175,13 @@ class I {
       );
       return;
     }
-    const n = {
+    const a = {
       command: "channelData",
-      obj: JSON.stringify(a)
+      obj: JSON.stringify(n)
     };
-    console.log("Cabbage: sending channel data from UI", a), s !== null ? s.postMessage(n) : typeof window.sendMessageFromUI == "function" ? window.sendMessageFromUI(n) : console.error(
+    console.log("Cabbage: sending channel data from UI", n), s !== null ? s.postMessage(a) : typeof window.sendMessageFromUI == "function" ? window.sendMessageFromUI(a) : console.error(
       "Cabbage: window.sendMessageFromUI is not available. Message:",
-      n
+      a
     );
   }
   /**
@@ -209,24 +209,24 @@ class I {
    * @param {Object} additionalData - Additional data to include in the command
    */
   static sendCustomCommand(o, e = null, s = {}) {
-    const a = {
+    const n = {
       command: o,
       text: JSON.stringify(s)
     };
     if (e !== null)
-      e.postMessage(a);
+      e.postMessage(n);
     else if (typeof window.sendMessageFromUI == "function") {
-      console.log("Cabbage: Calling window.sendMessageFromUI with:", a);
+      console.log("Cabbage: Calling window.sendMessageFromUI with:", n);
       try {
-        const n = window.sendMessageFromUI(a);
-        console.log("Cabbage: sendMessageFromUI returned:", n);
-      } catch (n) {
-        console.error("Cabbage: sendMessageFromUI threw error:", n), console.error("Cabbage: Error stack:", n.stack);
+        const a = window.sendMessageFromUI(n);
+        console.log("Cabbage: sendMessageFromUI returned:", a);
+      } catch (a) {
+        console.error("Cabbage: sendMessageFromUI threw error:", a), console.error("Cabbage: Error stack:", a.stack);
       }
     } else
       console.error(
         "Cabbage: window.sendMessageFromUI is not available yet. Message:",
-        a
+        n
       ), console.error(
         "Cabbage: typeof window.sendMessageFromUI:",
         typeof window.sendMessageFromUI
@@ -236,15 +236,15 @@ class I {
       );
   }
 }
-const C = (r) => {
-  const [o, e] = u();
-  return M(() => {
-    const s = (a) => {
-      const { id: n, widgetJson: d, command: w } = a.data;
-      if (n === r && d && w === "widgetUpdate") {
-        const t = JSON.parse(d);
+const I = (i) => {
+  const [o, e] = f();
+  return b(() => {
+    const s = (n) => {
+      const { id: a, widgetJson: r, command: l } = n.data;
+      if (a === i && r && l === "widgetUpdate") {
+        const t = JSON.parse(r);
         console.log(
-          `[Cabbage-React] Received properties for channelId ${n}`,
+          `[Cabbage-React] Received properties for channelId ${a}`,
           t
         ), e(t);
       }
@@ -255,63 +255,84 @@ const C = (r) => {
   }, []), {
     properties: o
   };
-}, y = (r, o = "complete") => {
-  const { properties: e } = C(r), [s, a] = u(), [n, d] = u(), w = (t) => {
-    a(t), I.sendControlData({
-      channel: r,
+}, v = (i, o = "complete") => {
+  const { properties: e } = I(i), [s, n] = f(), [a, r] = f(), l = (t) => {
+    n(t), C.sendControlData({
+      channel: i,
       value: t,
       gesture: o
     });
   };
-  return M(() => {
-    var m;
+  return b(() => {
+    var w;
     const t = e == null ? void 0 : e.channels.find(
-      (i) => i.id === r
+      (d) => d.id === i
     );
     if (!t) return;
-    const l = t == null ? void 0 : t.parameterIndex;
-    n === void 0 && l !== void 0 && (console.log(
+    const g = t == null ? void 0 : t.parameterIndex;
+    a === void 0 && g !== void 0 && (console.log(
       `[Cabbage-React] Received parameterIndex for channelId "${t.id}"`,
-      l
-    ), d(l));
-    const g = (m = t.range) == null ? void 0 : m.defaultValue;
-    s === void 0 && g !== void 0 && (console.log(
-      `[Cabbage-React] Received default value for channelId "${t.id}"`,
       g
-    ), a(g));
-  }, [e]), M(() => {
-    const t = (l) => {
-      var m;
-      const { command: g } = l.data;
-      if (g === "parameterChange") {
-        const { value: i, paramIdx: c } = l.data.data;
-        if (c !== n || i === null) return;
+    ), r(g));
+    const c = (w = t.range) == null ? void 0 : w.defaultValue;
+    s === void 0 && c !== void 0 && (console.log(
+      `[Cabbage-React] Received default value for channelId "${t.id}"`,
+      c
+    ), n(c));
+  }, [e]), b(() => {
+    const t = (g) => {
+      var w;
+      const { command: c } = g.data;
+      if (c === "parameterChange") {
+        const { value: d, paramIdx: m } = g.data.data;
+        if (m !== a || d === null) return;
         console.log(
-          `[Cabbage-React] Received parameterChange for parameterIndex ${c}`,
-          i
-        ), a(i);
-      } else if (g === "batchWidgetUpdate") {
-        const i = l.data.widgets, c = i == null ? void 0 : i.find((b) => b.id === r);
-        if (!c) return;
-        const f = JSON.parse(c.widgetJson).channels.find(
-          (b) => b.id === r
-        ), p = (m = f == null ? void 0 : f.range) == null ? void 0 : m.value;
+          `[Cabbage-React] Received parameterChange for parameterIndex ${m}`,
+          d
+        ), n(d);
+      } else if (c === "batchWidgetUpdate") {
+        const d = g.data.widgets, m = d == null ? void 0 : d.find((M) => M.id === i);
+        if (!m) return;
+        const u = JSON.parse(m.widgetJson).channels.find(
+          (M) => M.id === i
+        ), p = (w = u == null ? void 0 : u.range) == null ? void 0 : w.value;
         console.log(
-          `[Cabbage-React] Received batch widget update for channelId ${c.id}`,
+          `[Cabbage-React] Received batch widget update for channelId ${m.id}`,
           p
-        ), a(p);
+        ), n(p);
       }
     };
     return window.addEventListener("message", t), () => {
       window.removeEventListener("message", t);
     };
-  }, [n]), {
+  }, [a]), {
     value: s,
-    setValue: w
+    setValue: l
+  };
+}, y = (i) => {
+  const [o, e] = f();
+  return b(() => {
+    const s = (n) => {
+      const { widgetJson: a, command: r } = n.data;
+      if (a && r === "widgetUpdate") {
+        const l = JSON.parse(a);
+        if (l.id !== i) return;
+        console.log(
+          `[Cabbage-React] Received message for channelId ${l.id}`,
+          l
+        ), e(l);
+      }
+    };
+    return window.addEventListener("message", s), () => {
+      window.removeEventListener("message", s);
+    };
+  }, []), {
+    message: o
   };
 };
 export {
-  I as Cabbage,
-  C as useCabbageProperties,
-  y as useCabbageState
+  C as Cabbage,
+  y as useCabbageMessage,
+  I as useCabbageProperties,
+  v as useCabbageState
 };

package/package.json

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