cabbage-react 1.0.53 → 1.0.54

package/dist/hooks/useCabbageMessage.d.ts

@@ -3,12 +3,15 @@
  * 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 when receiving a new message (synchronous - bypasses state batching)
  * @param options - Optional configuration
+ * @param options.onMessage - Callback fires immediately when receiving a new message (synchronous - bypasses state batching)
  * @param options.skip - When true, the hook returns a NOP state and never registers listeners
+ * @param options.debug - When true, logs incoming messages for this hook to the console for debugging
  */
-export declare const useCabbageMessage: <T>(messageType: string, onMessage?: (message: T) => void, options?: {
+export declare const useCabbageMessage: <T>(messageType: string, options?: {
+    onMessage?: (message: T) => void;
     skip?: boolean;
+    debug?: boolean;
 }) => {
     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;;;;;;;;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"}
+{"version":3,"file":"useCabbageMessage.d.ts","sourceRoot":"","sources":["../../src/hooks/useCabbageMessage.ts"],"names":[],"mappings":"AAEA;;;;;;;;;GASG;AACH,eAAO,MAAM,iBAAiB,GAAI,CAAC,EAClC,aAAa,MAAM,EACnB,UAAU;IACT,SAAS,CAAC,EAAE,CAAC,OAAO,EAAE,CAAC,KAAK,IAAI,CAAC;IACjC,IAAI,CAAC,EAAE,OAAO,CAAC;IACf,KAAK,CAAC,EAAE,OAAO,CAAC;CAChB;;CA6BD,CAAC"}

package/dist/hooks/useCabbageProperties.d.ts

@@ -3,12 +3,15 @@
  * 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)
  * @param options - Optional configuration
+ * @param options.onPropertiesUpdate - Callback fires immediately when receiving an update to properties (synchronous - bypasses state batching)
  * @param options.skip - When true, the hook returns a NOP state and never registers listeners
+ * @param options.debug - When true, logs incoming updates to properties for this hook to the console for debugging
  */
-export declare const useCabbageProperties: (channelId: string, onPropertiesUpdate?: (properties: Record<string, any>) => void, options?: {
+export declare const useCabbageProperties: (channelId: string, options?: {
+    onPropertiesUpdate?: (properties: Record<string, any>) => void;
     skip?: boolean;
+    debug?: boolean;
 }) => {
     properties: Record<string, any> | undefined;
 };

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

@@ -1 +1 @@
-{"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"}
+{"version":3,"file":"useCabbageProperties.d.ts","sourceRoot":"","sources":["../../src/hooks/useCabbageProperties.ts"],"names":[],"mappings":"AAEA;;;;;;;;;GASG;AACH,eAAO,MAAM,oBAAoB,GAChC,WAAW,MAAM,EACjB,UAAU;IACT,kBAAkB,CAAC,EAAE,CAAC,UAAU,EAAE,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,KAAK,IAAI,CAAC;IAC/D,IAAI,CAAC,EAAE,OAAO,CAAC;IACf,KAAK,CAAC,EAAE,OAAO,CAAC;CAChB;;CAkCD,CAAC"}

package/dist/hooks/useCabbageState.d.ts

@@ -3,12 +3,15 @@
  * 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 onValueUpdate - Callback fires immediately when receiving a value update (synchronous - bypasses state batching)
  * @param options - Optional configuration
+ * @param options.onValueUpdate - Callback fires immediately when receiving a value update (synchronous - bypasses state batching)
  * @param options.skip - When true, the hook returns a NOP state and never registers listeners
+ * @param options.debug - When true, logs incoming value updates for this hook to the console for debugging
  */
-export declare const useCabbageState: <T>(channelId: string, onValueUpdate?: (value: T) => void, options?: {
+export declare const useCabbageState: <T>(channelId: string, options?: {
+    onValueUpdate?: (value: T) => void;
     skip?: boolean;
+    debug?: boolean;
 }) => {
     value: T | undefined;
     setValue: (value: T, gesture?: "begin" | "value" | "end" | "complete") => 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;;;;;;;;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"}
+{"version":3,"file":"useCabbageState.d.ts","sourceRoot":"","sources":["../../src/hooks/useCabbageState.ts"],"names":[],"mappings":"AAIA;;;;;;;;;GASG;AACH,eAAO,MAAM,eAAe,GAAI,CAAC,EAChC,WAAW,MAAM,EACjB,UAAU;IACT,aAAa,CAAC,EAAE,CAAC,KAAK,EAAE,CAAC,KAAK,IAAI,CAAC;IACnC,IAAI,CAAC,EAAE,OAAO,CAAC;IACf,KAAK,CAAC,EAAE,OAAO,CAAC;CAChB;;sBAYO,CAAC,YACC,OAAO,GAAG,OAAO,GAAG,KAAK,GAAG,UAAU;CAqGhD,CAAC"}

package/dist/index.cjs

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

package/dist/index.mjs

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

package/package.json

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