cabbage-react 1.0.53 → 1.0.55

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":"AAGA;;;;;;;;;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":"AAGA;;;;;;;;;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":"AAKA;;;;;;;;;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;;sBAmBO,CAAC,YACC,OAAO,GAAG,OAAO,GAAG,KAAK,GAAG,UAAU;CAiFhD,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 l=require("react");class C{static sendControlData({channel:e,value:s,gesture:n="complete"},t=null){const a={command:"controlData",channel:e,value:s,gesture:n};t!==null?t.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,t=null){var a={statusByte:e,dataByte1:s,dataByte2:n};const r={command:"midiMessage",obj:JSON.stringify(a)};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,n){}static triggerFileOpenDialog(e,s,n={}){var t={channel:s,directory:n.directory||"",filters:n.filters||"*",openAtLastKnownLocation:n.openAtLastKnownLocation!==void 0?n.openAtLastKnownLocation:!0};const a={command:"fileOpen",obj:JSON.stringify(t)};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 t={url:s,file:n};const a={command:"openUrl",obj:JSON.stringify(t)};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 t={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(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,n=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 a={command:"channelData",obj:JSON.stringify(t)};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 t={command:e,text:JSON.stringify(n)};if(s!==null)s.postMessage(t);else if(typeof window.sendMessageFromUI=="function")try{const a=window.sendMessageFromUI(t)}catch(a){console.error("Cabbage: sendMessageFromUI threw error:",a),console.error("Cabbage: Error stack:",a.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 b=(o,e)=>(...s)=>{e&&console.log(`[Cabbage-React][${o}]`,...s)},U=(o,e)=>{if(!o||e?.skip)return{properties:void 0};const s=b(`useCabbageProperties:${o}`,e?.debug),[n,t]=l.useState();return l.useEffect(()=>{const a=r=>{const{id:d,widgetJson:c,command:m}=r.data;if(d===o&&c&&m==="widgetUpdate"){const i=JSON.parse(c);s("Received properties",i),e?.onPropertiesUpdate&&e.onPropertiesUpdate(i),t(i)}};return window.addEventListener("message",a),()=>window.removeEventListener("message",a)},[o,e?.onPropertiesUpdate]),{properties:n}},y=(o,e)=>{if(!o||e?.skip)return{value:void 0,setValue:()=>{}};const s=b(`useCabbageState:${o}`,e?.debug),{properties:n}=U(o,{debug:e?.debug}),[t,a]=l.useState(),[r,d]=l.useState(),c=(i,g="complete")=>{a(i),C.sendControlData({channel:o,value:i,gesture:g})},m=i=>{e?.onValueUpdate&&e.onValueUpdate(i),a(i)};return l.useEffect(()=>{const i=n?.channels.find(u=>u.id===o);if(!i)return;const g=i.parameterIndex;if(r===void 0&&g!==void 0&&(s("Received parameterIndex",g),d(g)),t!==void 0)return;const w=i.range?.value;w!=null&&(s("Received initial value",w),m(w))},[n]),l.useEffect(()=>{const i=g=>{const{command:w}=g.data;if(w==="parameterChange"){const{value:u,paramIdx:f}=g.data.data;if(f!==r||u===null)return;s("Received parameterChange",u),m(u)}else if(w==="batchWidgetUpdate"){const f=g.data.widgets?.find(p=>p.id===o);if(!f)return;const M=JSON.parse(f.widgetJson).channels.find(p=>p.id===o)?.range?.value;s("Received batchWidgetUpdate",M),m(M)}};return window.addEventListener("message",i),()=>window.removeEventListener("message",i)},[o,e?.onValueUpdate,r]),{value:t,setValue:c}},v=(o,e)=>{if(!o||e?.skip)return{message:void 0};const s=b(`useCabbageMessage:${o}`,e?.debug),[n,t]=l.useState();return l.useEffect(()=>{const a=r=>{const{data:d,type:c}=r;!d||c!=="message"||d.type===o&&(s("Received data",d),e?.onMessage&&e.onMessage(d),t(d))};return window.addEventListener("message",a),()=>window.removeEventListener("message",a)},[o,e?.onMessage]),{message:n}};exports.Cabbage=C;exports.useCabbageMessage=v;exports.useCabbageProperties=U;exports.useCabbageState=y;

package/dist/index.mjs

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

package/dist/utils/cabbageDebug.d.ts

@@ -0,0 +1,2 @@
+export declare const createCabbageDebugger: (scope: string, enabled?: boolean) => (...args: any[]) => void;
+//# sourceMappingURL=cabbageDebug.d.ts.map

package/dist/utils/cabbageDebug.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"cabbageDebug.d.ts","sourceRoot":"","sources":["../../src/utils/cabbageDebug.ts"],"names":[],"mappings":"AAAA,eAAO,MAAM,qBAAqB,GACjC,OAAO,MAAM,EACb,UAAU,OAAO,MAET,GAAG,MAAM,GAAG,EAAE,SAKtB,CAAC"}

package/package.json

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