cabbage-react 1.0.51 → 1.0.53

package/dist/hooks/useCabbageMessage.d.ts

@@ -4,8 +4,12 @@
  * 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 when receiving a new message (synchronous - bypasses state batching)
+ * @param options - Optional configuration
+ * @param options.skip - When true, the hook returns a NOP state and never registers listeners
  */
-export declare const useCabbageMessage: <T>(messageType: string, onMessage?: (message: T) => void) => {
+export declare const useCabbageMessage: <T>(messageType: string, onMessage?: (message: T) => void, options?: {
+    skip?: boolean;
+}) => {
     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;;;;;;GAMG;AACH,eAAO,MAAM,iBAAiB,GAAI,CAAC,EAClC,aAAa,MAAM,EACnB,YAAY,CAAC,OAAO,EAAE,CAAC,KAAK,IAAI;;CAyBhC,CAAC"}
+{"version":3,"file":"useCabbageMessage.d.ts","sourceRoot":"","sources":["../../src/hooks/useCabbageMessage.ts"],"names":[],"mappings":"AAEA;;;;;;;;GAQG;AACH,eAAO,MAAM,iBAAiB,GAAI,CAAC,EAClC,aAAa,MAAM,EACnB,YAAY,CAAC,OAAO,EAAE,CAAC,KAAK,IAAI,EAChC,UAAU;IAAE,IAAI,CAAC,EAAE,OAAO,CAAA;CAAE;;CA4B5B,CAAC"}

package/dist/hooks/useCabbageProperties.d.ts

@@ -4,9 +4,12 @@
  * whenever new data is received.
  * @param channelId
  * @param onPropertiesUpdate - Callback fires immediately when receiving an update to properties (synchronous - bypasses state batching)
+ * @param options - Optional configuration
+ * @param options.skip - When true, the hook returns a NOP state and never registers listeners
  */
-export declare const useCabbageProperties: (channelId: string, onPropertiesUpdate?: (properties: Record<string, any>) => void) => {
+export declare const useCabbageProperties: (channelId: string, onPropertiesUpdate?: (properties: Record<string, any>) => void, options?: {
+    skip?: boolean;
+}) => {
     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;;;;;;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"}
+{"version":3,"file":"useCabbageProperties.d.ts","sourceRoot":"","sources":["../../src/hooks/useCabbageProperties.ts"],"names":[],"mappings":"AAEA;;;;;;;;GAQG;AACH,eAAO,MAAM,oBAAoB,GAChC,WAAW,MAAM,EACjB,qBAAqB,CAAC,UAAU,EAAE,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,KAAK,IAAI,EAC9D,UAAU;IAAE,IAAI,CAAC,EAAE,OAAO,CAAA;CAAE;;CAiC5B,CAAC"}

package/dist/hooks/useCabbageState.d.ts

@@ -3,11 +3,14 @@
  * 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
- * @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)
+ * @param options - Optional configuration
+ * @param options.skip - When true, the hook returns a NOP state and never registers listeners
  */
-export declare const useCabbageState: <T>(channelId: string, gesture?: "begin" | "value" | "end" | "complete", onValueUpdate?: (value: T) => void) => {
+export declare const useCabbageState: <T>(channelId: string, onValueUpdate?: (value: T) => void, options?: {
+    skip?: boolean;
+}) => {
     value: T | undefined;
-    setValue: (value: T) => void;
+    setValue: (value: T, gesture?: "begin" | "value" | "end" | "complete") => void;
 };
 //# sourceMappingURL=useCabbageState.d.ts.map

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

@@ -1 +1 @@
-{"version":3,"file":"useCabbageState.d.ts","sourceRoot":"","sources":["../../src/hooks/useCabbageState.ts"],"names":[],"mappings":"AAIA;;;;;;;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"}
+{"version":3,"file":"useCabbageState.d.ts","sourceRoot":"","sources":["../../src/hooks/useCabbageState.ts"],"names":[],"mappings":"AAIA;;;;;;;;GAQG;AACH,eAAO,MAAM,eAAe,GAAI,CAAC,EAChC,WAAW,MAAM,EACjB,gBAAgB,CAAC,KAAK,EAAE,CAAC,KAAK,IAAI,EAClC,UAAU;IAAE,IAAI,CAAC,EAAE,OAAO,CAAA;CAAE;;sBAYpB,CAAC,YACC,OAAO,GAAG,OAAO,GAAG,KAAK,GAAG,UAAU;CA8FhD,CAAC"}

package/dist/index.cjs

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

package/dist/index.mjs

@@ -1,4 +1,4 @@
-import { useState as f, useEffect as p } from "react";
+import { useState as p, useEffect as u } from "react";
 class C {
   /**
    * 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: e, value: s, gesture: n = "complete" }, o = null) {
-    const a = {
+  static sendControlData({ channel: e, value: a, gesture: n = "complete" }, o = null) {
+    const s = {
       command: "controlData",
       channel: e,
-      value: s,
+      value: a,
       gesture: n
     };
-    o !== null ? o.postMessage(a) : typeof window.sendMessageFromUI == "function" ? window.sendMessageFromUI(a) : window.parent !== window ? window.parent.postMessage(a, "*") : console.error(
+    o !== null ? o.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:",
-      a
+      s
     );
   }
   /**
@@ -38,7 +38,7 @@ class C {
    * @param {Object|null} vscode - VS Code API object (null for plugin mode)
    * @param {Object} additionalData - Additional initialization data
    */
-  static isReadyToLoad(e = null, s = {}) {
+  static isReadyToLoad(e = null, a = {}) {
     this.sendCustomCommand("isReadyToLoad", e);
   }
   /**
@@ -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(e, s, n, o = null) {
-    var a = {
+  static sendMidiMessageFromUI(e, a, n, o = null) {
+    var s = {
       statusByte: e,
-      dataByte1: s,
+      dataByte1: a,
       dataByte2: n
     };
-    const t = {
+    const r = {
       command: "midiMessage",
-      obj: JSON.stringify(a)
+      obj: JSON.stringify(s)
     };
-    o !== null ? o.postMessage(t) : typeof window.sendMessageFromUI == "function" ? window.sendMessageFromUI(t) : window.parent !== window ? window.parent.postMessage(t, "*") : console.error(
+    o !== null ? o.postMessage(r) : typeof window.sendMessageFromUI == "function" ? window.sendMessageFromUI(r) : window.parent !== window ? window.parent.postMessage(r, "*") : console.error(
       "Cabbage: window.sendMessageFromUI is not available. Message:",
-      t
+      r
     );
   }
   /**
@@ -71,7 +71,7 @@ class C {
    * @param {number} dataByte1 - First MIDI data byte
    * @param {number} dataByte2 - Second MIDI data byte
    */
-  static MidiMessageFromHost(e, s, n) {
+  static MidiMessageFromHost(e, a, n) {
   }
   /**
    * 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(e, s, n = {}) {
+  static triggerFileOpenDialog(e, a, n = {}) {
     var o = {
-      channel: s,
+      channel: a,
       directory: n.directory || "",
       filters: n.filters || "*",
       openAtLastKnownLocation: n.openAtLastKnownLocation !== void 0 ? n.openAtLastKnownLocation : !0
     };
-    const a = {
+    const s = {
       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(
+    e !== null ? e.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:",
-      a
+      s
     );
   }
   /**
@@ -106,18 +106,18 @@ class C {
    * @param {string} url - URL to open
    * @param {string} file - File path to open
    */
-  static openUrl(e, s, n) {
+  static openUrl(e, a, n) {
     var o = {
-      url: s,
+      url: a,
       file: n
     };
-    const a = {
+    const s = {
       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(
+    e !== null ? e.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:",
-      a
+      s
     );
   }
   /**
@@ -132,11 +132,11 @@ class C {
    * The response will be sent via hostMessageCallback with:
    * {command: "resizeResponse", accepted: boolean, width: number, height: number}
    */
-  static requestResize(e, s, n = null) {
+  static requestResize(e, a, n = null) {
     const o = {
       command: "requestResize",
       width: e,
-      height: s
+      height: a
     };
     if (n !== null) {
       console.warn(
@@ -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(e, s, n = null) {
+  static sendChannelData(e, a, n = null) {
     var o = {
       channel: e
     };
-    if (typeof s == "string")
-      o.stringData = s;
-    else if (typeof s == "number")
-      o.floatData = s;
+    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 s
+        typeof a
       );
       return;
     }
-    const a = {
+    const s = {
       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(
+    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:",
-      a
+      s
     );
   }
   /**
@@ -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(e, s = null) {
+  static sendWidgetUpdate(e, a = 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(
+    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
     );
@@ -255,25 +255,25 @@ class C {
    * onDestroy(() => remove?.());
    */
   static addMessageListener(e) {
-    const s = (n) => {
+    const a = (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);
+    return window.addEventListener("message", a), window.hostMessageCallback = e, () => {
+      window.removeEventListener("message", a), window.hostMessageCallback === e && (window.hostMessageCallback = null);
     };
   }
-  static sendCustomCommand(e, s = null, n = {}) {
+  static sendCustomCommand(e, a = null, n = {}) {
     const o = {
       command: e,
       text: JSON.stringify(n)
     };
-    if (s !== null)
-      s.postMessage(o);
+    if (a !== null)
+      a.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);
+        const s = window.sendMessageFromUI(o);
+      } catch (s) {
+        console.error("Cabbage: sendMessageFromUI threw error:", s), console.error("Cabbage: Error stack:", s.stack);
       }
     else window.parent !== window ? window.parent.postMessage(o, "*") : (console.error(
       "Cabbage: window.sendMessageFromUI is not available yet. Message:",
@@ -287,92 +287,91 @@ class C {
     ));
   }
 }
-const y = (r, e) => {
-  const [s, n] = f();
-  return p(() => {
-    const o = (a) => {
-      const { id: t, widgetJson: g, command: u } = a.data;
-      if (t === r && g && u === "widgetUpdate") {
-        const d = JSON.parse(g);
+const y = (i, e, a) => {
+  if (!i || a?.skip) return { properties: void 0 };
+  const [n, o] = p();
+  return u(() => {
+    const s = (r) => {
+      const { id: d, widgetJson: g, command: f } = r.data;
+      if (d === i && g && f === "widgetUpdate") {
+        const t = JSON.parse(g);
         console.log(
-          `[Cabbage-React] Received properties for channelId: ${t}`,
-          d
-        ), e && e(d), n(d);
+          `[Cabbage-React] Received properties for channelId: ${d}`,
+          t
+        ), e && e(t), o(t);
       }
     };
-    return window.addEventListener("message", o), () => window.removeEventListener("message", o);
-  }, [r, e]), {
-    properties: s,
-    onPropertiesUpdate: e
-  };
-}, 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: e
+    return window.addEventListener("message", s), () => window.removeEventListener("message", s);
+  }, [i, e]), { properties: n };
+}, F = (i, e, a) => {
+  if (!i || a?.skip)
+    return { value: void 0, setValue: () => {
+    } };
+  const { properties: n } = y(i), [o, s] = p(), [r, d] = p(), g = (t, l = "complete") => {
+    s(t), C.sendControlData({
+      channel: i,
+      value: t,
+      gesture: l
     });
-  }, d = (i) => {
-    s && s(i), a(i);
+  }, f = (t) => {
+    e && e(t), s(t);
   };
-  return p(() => {
-    const i = n?.channels.find(
-      (c) => c.id === r
+  return u(() => {
+    const t = n?.channels.find(
+      (c) => c.id === i
     );
-    if (!i) return;
-    const l = i.parameterIndex;
-    if (t === void 0 && l !== void 0 && (console.log(
-      `[Cabbage-React] Received parameterIndex for channelId: ${i.id}`,
+    if (!t) return;
+    const l = t.parameterIndex;
+    if (r === void 0 && l !== void 0 && (console.log(
+      `[Cabbage-React] Received parameterIndex for channelId: ${t.id}`,
       l
-    ), g(l)), o !== void 0) return;
-    const w = i.range?.value;
+    ), d(l)), o !== void 0) return;
+    const w = t.range?.value;
     w != null && (console.log(
-      `[Cabbage-React] Received initial value for channelId: ${i.id}`,
+      `[Cabbage-React] Received initial value for channelId: ${t.id}`,
       w
-    ), d(w));
-  }, [n]), p(() => {
-    const i = (l) => {
+    ), f(w));
+  }, [n]), u(() => {
+    const t = (l) => {
       const { command: w } = l.data;
       if (w === "parameterChange") {
         const { value: c, paramIdx: m } = l.data.data;
-        if (m !== t || c === null) return;
+        if (m !== r || c === null) return;
         console.log(
           `[Cabbage-React] Received parameterChange for parameterIndex: ${m}`,
           c
-        ), d(c);
+        ), f(c);
       } else if (w === "batchWidgetUpdate") {
-        const m = l.data.widgets?.find((b) => b.id === r);
+        const m = l.data.widgets?.find((b) => b.id === i);
         if (!m) return;
         const M = JSON.parse(m.widgetJson).channels.find(
-          (b) => b.id === r
+          (b) => b.id === i
         )?.range?.value;
         console.log(
           `[Cabbage-React] Received batch widget update for channelId: ${m.id}`,
           M
-        ), d(M);
+        ), f(M);
       }
     };
-    return window.addEventListener("message", i), () => window.removeEventListener("message", i);
-  }, [r, s, t]), {
-    value: o,
-    setValue: u
-  };
-}, v = (r, e) => {
-  const [s, n] = f();
-  return p(() => {
-    const o = (a) => {
-      const { data: t, type: g } = a;
-      !t || g !== "message" || t.type === r && (console.log(
-        `[Cabbage-React] Received data for messageType: ${t.type}`,
-        t
-      ), e && e(t), n(t));
+    return window.addEventListener("message", t), () => window.removeEventListener("message", t);
+  }, [i, e, r]), { value: o, setValue: g };
+}, h = (i, e, a) => {
+  if (!i || a?.skip) return { message: void 0 };
+  const [n, o] = p();
+  return u(() => {
+    const s = (r) => {
+      const { data: d, type: g } = r;
+      !d || g !== "message" || d.type === i && (console.log(
+        `[Cabbage-React] Received data for messageType: ${d.type}`,
+        d
+      ), e && e(d), o(d));
     };
-    return window.addEventListener("message", o), () => window.removeEventListener("message", o);
-  }, [r, e]), { message: s };
+    return window.addEventListener("message", s), () => window.removeEventListener("message", s);
+  }, [i, e]), { message: n };
 };
 export {
   C as Cabbage,
-  v as useCabbageMessage,
+  h as useCabbageMessage,
   y as useCabbageProperties,
-  h as useCabbageState
+  F as useCabbageState
 };

package/package.json

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