svelte-tweakpane-ui 1.1.4 → 1.2.1

package/dist/index.d.ts

@@ -1,7 +1,8 @@
 export { type ButtonClickEvent, default as Button } from './control/Button.svelte';
 export { type ButtonGridClickEvent, default as ButtonGrid } from './control/ButtonGrid.svelte';
-export { default as Checkbox } from './control/Checkbox.svelte';
+export { type CheckboxChangeEvent, default as Checkbox } from './control/Checkbox.svelte';
 export {
+	type ColorChangeEvent,
 	type ColorValue,
 	type ColorValueRgbObject,
 	type ColorValueRgbTuple,
@@ -11,19 +12,22 @@ export {
 	default as Color
 } from './control/Color.svelte';
 export {
+	type CubicBezierChangeEvent,
 	type CubicBezierValue,
 	type CubicBezierValueObject,
 	type CubicBezierValueTuple,
 	default as CubicBezier
 } from './control/CubicBezier.svelte';
-export { type ImageValue, default as Image } from './control/Image.svelte';
+export { type ImageChangeEvent, type ImageValue, default as Image } from './control/Image.svelte';
 export {
+	type IntervalSliderChangeEvent,
 	type IntervalSliderValue,
 	type IntervalSliderValueObject,
 	type IntervalSliderValueTuple,
 	default as IntervalSlider
 } from './control/IntervalSlider.svelte';
 export {
+	type ListChangeEvent,
 	type ListOptions,
 	type ListOptionsArray,
 	type ListOptionsObjectArray,
@@ -31,6 +35,7 @@ export {
 	default as List
 } from './control/List.svelte';
 export {
+	type PointChangeEvent,
 	type PointOptions,
 	type PointValue2d,
 	type PointValue2dObject,
@@ -43,9 +48,15 @@ export {
 	type PointValue4dTuple,
 	default as Point
 } from './control/Point.svelte';
-export { default as RadioGrid } from './control/RadioGrid.svelte';
-export { type RingSeries, type RingUnit, default as Ring } from './control/Ring.svelte';
+export { type RadioGridChangeEvent, default as RadioGrid } from './control/RadioGrid.svelte';
 export {
+	type RingChangeEvent,
+	type RingSeries,
+	type RingUnit,
+	default as Ring
+} from './control/Ring.svelte';
+export {
+	type RotationEulerChangeEvent,
 	type RotationEulerOptions,
 	type RotationEulerOrder,
 	type RotationEulerUnit,
@@ -55,25 +66,31 @@ export {
 	default as RotationEuler
 } from './control/RotationEuler.svelte';
 export {
+	type RotationQuaternionChangeEvent,
 	type RotationQuaternionOptions,
 	type RotationQuaternionValue,
 	type RotationQuaternionValueObject,
 	type RotationQuaternionValueTuple,
 	default as RotationQuaternion
 } from './control/RotationQuaternion.svelte';
-export { default as Slider } from './control/Slider.svelte';
-export { default as Text } from './control/Text.svelte';
-export { default as Textarea } from './control/Textarea.svelte';
-export { default as Wheel } from './control/Wheel.svelte';
-export { type BindingOptions, type BindingRef, default as Binding } from './core/Binding.svelte';
+export { type SliderChangeEvent, default as Slider } from './control/Slider.svelte';
+export { type TextChangeEvent, default as Text } from './control/Text.svelte';
+export { type TextareaChangeEvent, default as Textarea } from './control/Textarea.svelte';
+export { type WheelChangeEvent, default as Wheel } from './control/Wheel.svelte';
+export {
+	type BindingChangeEvent,
+	type BindingOptions,
+	type BindingRef,
+	default as Binding
+} from './core/Binding.svelte';
 export { type BladeOptions, type BladeRef, default as Blade } from './core/Blade.svelte';
 export { default as Folder } from './core/Folder.svelte';
 export { type PanePosition, default as Pane } from './core/Pane.svelte';
 export { default as Separator } from './core/Separator.svelte';
 export { default as TabGroup } from './core/TabGroup.svelte';
 export { default as TabPage } from './core/TabPage.svelte';
-export { default as AutoObject } from './extra/AutoObject.svelte';
-export { default as AutoValue } from './extra/AutoValue.svelte';
+export { type AutoObjectChangeEvent, default as AutoObject } from './extra/AutoObject.svelte';
+export { type AutoValueChangeEvent, default as AutoValue } from './extra/AutoValue.svelte';
 export { default as Element } from './extra/Element.svelte';
 export { type FpsGraphChangeEvent, default as FpsGraph } from './monitor/FpsGraph.svelte';
 export { default as Monitor } from './monitor/Monitor.svelte';
@@ -90,5 +107,5 @@ export {
 } from './monitor/WaveformMonitor.svelte';
 export type { Theme, ThemeColorValue } from './theme.js';
 export { default as ThemeUtils } from './theme.js';
-export type { BindingObject, Plugin } from './utils.js';
+export type { BindingObject, Plugin, ValueChangeEvent } from './utils.js';
 export { default as Utils } from './utils.js';

package/dist/internal/GenericBinding.svelte

@@ -19,4 +19,4 @@
 	$: value, setValue();
 </script>
 
-<Binding bind:object bind:ref {key} {options} {...$$restProps} />
+<Binding bind:object bind:ref on:change {key} {options} {...$$restProps} />

package/dist/internal/GenericBinding.svelte.d.ts

@@ -50,18 +50,24 @@ declare class __sveltets_Render<
 			 * [`BindingApi`](https://tweakpane.github.io/docs/api/classes/_internal_.BindingApi.html) for
 			 * this control.
 			 *
-			 * This is primarily for internal use, when implementing convenience components wrapping
-			 * Binding's functionality.
+			 * This property is exposed for advanced use cases only, such as when implementing convenience
+			 * components wrapping `<Binding>`'s functionality.
+			 *
+			 * Direct manipulation of Tweakpane's internals can break _Svelte Tweakpane UI_ abstractions.
+			 *
 			 * @bindable
 			 * @readonly
 			 */
 			ref?: V | undefined;
 			/**
 			 * Imported Tweakpane `TpPluginBundle` (aliased as `Plugin`) module to automatically register in
-			 * the binding's containing `<Pane>`.
+			 * the `<Binding>`'s containing `<Pane>`.
+			 *
+			 * This property is exposed for advanced use cases only, such as when implementing convenience
+			 * components wrapping `<Binding>`'s functionality in combination with a Tweakpane plugin.
+			 *
+			 * Direct manipulation of Tweakpane's internals can break _Svelte Tweakpane UI_ abstractions.
 			 *
-			 * This is primarily for internal use, when implementing convenience components wrapping
-			 * Binding's functionality in combination with a Tweakpane plugin.
 			 * @default `undefined`
 			 */
 			plugin?: import('tweakpane').TpPluginBundle | undefined;
@@ -74,7 +80,9 @@ declare class __sveltets_Render<
 		 * */
 		value: T;
 	};
-	events(): {} & {
+	events(): {
+		change: import('../core/Binding.svelte').BindingChangeEvent;
+	} & {
 		[evt: string]: CustomEvent<any>;
 	};
 	slots(): {};

package/dist/internal/GenericBladeFolding.svelte.d.ts

@@ -24,18 +24,24 @@ declare class __sveltets_Render<T extends BladeOptions, U extends BladeRef> {
 		 * Reference to internal Tweakpane
 		 * [`BladeApi`](https://tweakpane.github.io/docs/api/classes/BladeApi.html) for this blade.
 		 *
-		 * This is primarily for internal use, when implementing convenience components wrapping Blade's
-		 * functionality.
+		 * This property is exposed for advanced use cases only, such as when implementing convenience
+		 * components wrapping `<Blade>`'s functionality.
+		 *
+		 * Direct manipulation of Tweakpane's internals can break _Svelte Tweakpane UI_ abstractions.
+		 *
 		 * @bindable
 		 * @readonly
 		 */
 		ref?: U | undefined;
 		/**
-		 * Imported Tweakpane `TpPluginBundle` (Aliased as `Plugin`) module to register before creating
-		 * the blade.
+		 * Imported Tweakpane `TpPluginBundle` (aliased as `Plugin`) module to automatically register in
+		 * the `<Blade>`'s containing `<Pane>`.
+		 *
+		 * This property is exposed for advanced use cases only, such as when implementing convenience
+		 * components wrapping `<Blade>`'s functionality in combination with a Tweakpane plugin.
+		 *
+		 * Direct manipulation of Tweakpane's internals can break _Svelte Tweakpane UI_ abstractions.
 		 *
-		 * This is primarily for internal use, when implementing convenience components wrapping Blade's
-		 * functionality in combination with a Tweakpane plugin.
 		 * @default `undefined`
 		 */
 		plugin?: import('tweakpane').TpPluginBundle | undefined;

package/dist/internal/GenericInput.svelte

@@ -14,4 +14,4 @@
 	};
 </script>
 
-<GenericBinding bind:value bind:ref options={optionsInternal} {...$$restProps} />
+<GenericBinding bind:value bind:ref on:change options={optionsInternal} {...$$restProps} />

package/dist/internal/GenericInput.svelte.d.ts

@@ -52,18 +52,24 @@ declare class __sveltets_Render<
 			 * [`BindingApi`](https://tweakpane.github.io/docs/api/classes/_internal_.BindingApi.html) for
 			 * this control.
 			 *
-			 * This is primarily for internal use, when implementing convenience components wrapping
-			 * Binding's functionality.
+			 * This property is exposed for advanced use cases only, such as when implementing convenience
+			 * components wrapping `<Binding>`'s functionality.
+			 *
+			 * Direct manipulation of Tweakpane's internals can break _Svelte Tweakpane UI_ abstractions.
+			 *
 			 * @bindable
 			 * @readonly
 			 */
 			ref?: V | undefined;
 			/**
 			 * Imported Tweakpane `TpPluginBundle` (aliased as `Plugin`) module to automatically register in
-			 * the binding's containing `<Pane>`.
+			 * the `<Binding>`'s containing `<Pane>`.
+			 *
+			 * This property is exposed for advanced use cases only, such as when implementing convenience
+			 * components wrapping `<Binding>`'s functionality in combination with a Tweakpane plugin.
+			 *
+			 * Direct manipulation of Tweakpane's internals can break _Svelte Tweakpane UI_ abstractions.
 			 *
-			 * This is primarily for internal use, when implementing convenience components wrapping
-			 * Binding's functionality in combination with a Tweakpane plugin.
 			 * @default `undefined`
 			 */
 			plugin?: import('@tweakpane/core').TpPluginBundle | undefined;
@@ -76,7 +82,9 @@ declare class __sveltets_Render<
 		 */
 		value: T;
 	};
-	events(): {} & {
+	events(): {
+		change: import('..').BindingChangeEvent;
+	} & {
 		[evt: string]: CustomEvent<any>;
 	};
 	slots(): {};

package/dist/internal/GenericInputFolding.svelte

@@ -37,4 +37,4 @@
 		ref.element.querySelector(`.${buttonClass}`)?.click();
 </script>
 
-<GenericInput bind:value bind:ref options={optionsInternal} {...$$restProps} />
+<GenericInput bind:value bind:ref on:change options={optionsInternal} {...$$restProps} />

package/dist/internal/GenericInputFolding.svelte.d.ts

@@ -54,18 +54,24 @@ declare class __sveltets_Render<
 			 * [`BindingApi`](https://tweakpane.github.io/docs/api/classes/_internal_.BindingApi.html) for
 			 * this control.
 			 *
-			 * This is primarily for internal use, when implementing convenience components wrapping
-			 * Binding's functionality.
+			 * This property is exposed for advanced use cases only, such as when implementing convenience
+			 * components wrapping `<Binding>`'s functionality.
+			 *
+			 * Direct manipulation of Tweakpane's internals can break _Svelte Tweakpane UI_ abstractions.
+			 *
 			 * @bindable
 			 * @readonly
 			 */
 			ref?: V | undefined;
 			/**
 			 * Imported Tweakpane `TpPluginBundle` (aliased as `Plugin`) module to automatically register in
-			 * the binding's containing `<Pane>`.
+			 * the `<Binding>`'s containing `<Pane>`.
+			 *
+			 * This property is exposed for advanced use cases only, such as when implementing convenience
+			 * components wrapping `<Binding>`'s functionality in combination with a Tweakpane plugin.
+			 *
+			 * Direct manipulation of Tweakpane's internals can break _Svelte Tweakpane UI_ abstractions.
 			 *
-			 * This is primarily for internal use, when implementing convenience components wrapping
-			 * Binding's functionality in combination with a Tweakpane plugin.
 			 * @default `undefined`
 			 */
 			plugin?: import('tweakpane').TpPluginBundle | undefined;
@@ -100,7 +106,9 @@ declare class __sveltets_Render<
 		 * */
 		userExpandable?: boolean | undefined;
 	};
-	events(): {} & {
+	events(): {
+		change: import('..').BindingChangeEvent;
+	} & {
 		[evt: string]: CustomEvent<any>;
 	};
 	slots(): {};

package/dist/internal/GenericMonitor.svelte.d.ts

@@ -52,18 +52,24 @@ declare class __sveltets_Render<
 			 * [`BindingApi`](https://tweakpane.github.io/docs/api/classes/_internal_.BindingApi.html) for
 			 * this control.
 			 *
-			 * This is primarily for internal use, when implementing convenience components wrapping
-			 * Binding's functionality.
+			 * This property is exposed for advanced use cases only, such as when implementing convenience
+			 * components wrapping `<Binding>`'s functionality.
+			 *
+			 * Direct manipulation of Tweakpane's internals can break _Svelte Tweakpane UI_ abstractions.
+			 *
 			 * @bindable
 			 * @readonly
 			 */
 			ref?: V | undefined;
 			/**
 			 * Imported Tweakpane `TpPluginBundle` (aliased as `Plugin`) module to automatically register in
-			 * the binding's containing `<Pane>`.
+			 * the `<Binding>`'s containing `<Pane>`.
+			 *
+			 * This property is exposed for advanced use cases only, such as when implementing convenience
+			 * components wrapping `<Binding>`'s functionality in combination with a Tweakpane plugin.
+			 *
+			 * Direct manipulation of Tweakpane's internals can break _Svelte Tweakpane UI_ abstractions.
 			 *
-			 * This is primarily for internal use, when implementing convenience components wrapping
-			 * Binding's functionality in combination with a Tweakpane plugin.
 			 * @default `undefined`
 			 */
 			plugin?: import('@tweakpane/core').TpPluginBundle | undefined;

package/dist/internal/GenericPane.svelte

@@ -12,15 +12,15 @@
 	export let theme = void 0;
 	export let scale = 1;
 	export let userCreatedPane = true;
-	export let paneRef = void 0;
+	export let tpPane = void 0;
 	const parentStore = writable();
 	const existingParentStore = getContext('parentStore');
 	let pluginsRegistered = [];
 	const registerPlugin = (plugin) => {
-		if (paneRef === void 0) {
-			console.warn(`paneRef is undefined, failed to register plugin "${plugin.id}"`);
+		if (tpPane === void 0) {
+			console.warn(`tpPane is undefined, failed to register plugin "${plugin.id}"`);
 		} else if (!pluginsRegistered.includes(plugin.id)) {
-			paneRef?.registerPlugin(plugin);
+			tpPane?.registerPlugin(plugin);
 			pluginsRegistered.push(plugin.id);
 		}
 	};
@@ -35,7 +35,7 @@
 		$parentStore.on('fold', () => {
 			_expanded = $parentStore.expanded;
 		});
-		paneRef = $parentStore;
+		tpPane = $parentStore;
 		setContext('parentStore', parentStore);
 		onDestroy(() => {
 			$parentStore.dispose();
@@ -44,32 +44,32 @@
 		setContext('parentStore', writable(true));
 	}
 	function setScale(scale2) {
-		if (paneRef) {
+		if (tpPane) {
 			if (scale2 === 1) {
-				paneRef.element.style.removeProperty('transform-origin');
-				paneRef.element.style.removeProperty('transform');
-				paneRef.element.style.removeProperty('width');
+				tpPane.element.style.removeProperty('transform-origin');
+				tpPane.element.style.removeProperty('transform');
+				tpPane.element.style.removeProperty('width');
 			} else {
 				const clampedScale = Math.max(0, scale2);
-				paneRef.element.style.transformOrigin = '0 0';
-				paneRef.element.style.transform = `scale(${clampedScale})`;
-				paneRef.element.style.width = `${100 / clampedScale}%`;
+				tpPane.element.style.transformOrigin = '0 0';
+				tpPane.element.style.transform = `scale(${clampedScale})`;
+				tpPane.element.style.width = `${100 / clampedScale}%`;
 			}
 		}
 	}
 	function syncFolded() {
-		if (paneRef) {
-			paneRef.expanded = _expanded;
+		if (tpPane) {
+			tpPane.expanded = _expanded;
 		}
 		expanded = _expanded;
 	}
-	$: paneRef?.element && paneRef?.element.classList.add('svelte-tweakpane-ui');
-	$: paneRef && setScale(scale);
-	$: paneRef && updateCollapsibility(userExpandable, paneRef.element, 'tp-rotv_b', 'tp-rotv_m');
-	$: paneRef && title && (paneRef.title = title);
-	$: paneRef && applyTheme(paneRef.element, theme);
-	$: _expanded, paneRef && syncFolded();
-	$: paneRef && (_expanded = expanded);
+	$: tpPane?.element && tpPane?.element.classList.add('svelte-tweakpane-ui');
+	$: tpPane && setScale(scale);
+	$: tpPane && updateCollapsibility(userExpandable, tpPane.element, 'tp-rotv_b', 'tp-rotv_m');
+	$: tpPane && title && (tpPane.title = title);
+	$: tpPane && applyTheme(tpPane.element, theme);
+	$: _expanded, tpPane && expanded !== void 0 && syncFolded();
+	$: tpPane && (_expanded = expanded);
 </script>
 
 {#if BROWSER}

package/dist/internal/GenericPane.svelte.d.ts

@@ -53,9 +53,19 @@ declare const __propDef: {
 		 */ scale?: number | undefined;
 		/** Internal use only. */ userCreatedPane?: boolean | undefined;
 		/**
-		 * Internal use only.
+		 * The internal Tweakpane [`Pane`](https://tweakpane.github.io/docs/api/classes/Pane.html) object.
+		 *
+		 * This property is exposed for advanced use cases only.
+		 *
+		 * Direct manipulation of Tweakpane's internals can break _Svelte Tweakpane UI_ abstractions.
+		 *
+		 * Note that the `Pane` type for this property comes from the core Tweakpane library.
+		 * Creating an alias is suggested to avoid confusion with the _Svelte Tweakpane UI_ `Pane`
+		 * component: e.g. `import { type Pane as TpPane } from 'tweakpane'`
+		 *
+		 * @bindable
 		 * @readonly
-		 * */ paneRef?: TpPane | undefined;
+		 * */ tpPane?: TpPane | undefined;
 	};
 	events: {
 		[evt: string]: CustomEvent<any>;

package/dist/internal/GenericSlider.svelte

@@ -22,4 +22,4 @@
 	};
 </script>
 
-<GenericInput bind:value options={optionsInternal} {...$$restProps} />
+<GenericInput bind:value on:change options={optionsInternal} {...$$restProps} />

package/dist/internal/GenericSlider.svelte.d.ts

@@ -48,18 +48,24 @@ declare class __sveltets_Render<T extends number | IntervalSliderValue> {
 			 * [`BindingApi`](https://tweakpane.github.io/docs/api/classes/_internal_.BindingApi.html) for
 			 * this control.
 			 *
-			 * This is primarily for internal use, when implementing convenience components wrapping
-			 * Binding's functionality.
+			 * This property is exposed for advanced use cases only, such as when implementing convenience
+			 * components wrapping `<Binding>`'s functionality.
+			 *
+			 * Direct manipulation of Tweakpane's internals can break _Svelte Tweakpane UI_ abstractions.
+			 *
 			 * @bindable
 			 * @readonly
 			 */
 			ref?: GenericSliderRef | undefined;
 			/**
 			 * Imported Tweakpane `TpPluginBundle` (aliased as `Plugin`) module to automatically register in
-			 * the binding's containing `<Pane>`.
+			 * the `<Binding>`'s containing `<Pane>`.
+			 *
+			 * This property is exposed for advanced use cases only, such as when implementing convenience
+			 * components wrapping `<Binding>`'s functionality in combination with a Tweakpane plugin.
+			 *
+			 * Direct manipulation of Tweakpane's internals can break _Svelte Tweakpane UI_ abstractions.
 			 *
-			 * This is primarily for internal use, when implementing convenience components wrapping
-			 * Binding's functionality in combination with a Tweakpane plugin.
 			 * @default `undefined`
 			 */
 			plugin?: import('tweakpane').TpPluginBundle | undefined;
@@ -87,7 +93,7 @@ declare class __sveltets_Render<T extends number | IntervalSliderValue> {
 		 * */
 		max?: number | undefined;
 		/**
-		 * A function to customize the point value's formatting (e.g. rounding, etc.).
+		 * A function to customize the point value's string representation (e.g. rounding, etc.).
 		 * @default `undefined`  \
 		 * Normal `.toString()` formatting.
 		 * */
@@ -112,7 +118,9 @@ declare class __sveltets_Render<T extends number | IntervalSliderValue> {
 		 * */
 		step?: number | undefined;
 	};
-	events(): {} & {
+	events(): {
+		change: import('..').BindingChangeEvent;
+	} & {
 		[evt: string]: CustomEvent<any>;
 	};
 	slots(): {};

package/dist/internal/InternalMonitorBoolean.svelte.d.ts

@@ -48,18 +48,24 @@ declare const __propDef: {
 				 * [`BindingApi`](https://tweakpane.github.io/docs/api/classes/_internal_.BindingApi.html) for
 				 * this control.
 				 *
-				 * This is primarily for internal use, when implementing convenience components wrapping
-				 * Binding's functionality.
+				 * This property is exposed for advanced use cases only, such as when implementing convenience
+				 * components wrapping `<Binding>`'s functionality.
+				 *
+				 * Direct manipulation of Tweakpane's internals can break _Svelte Tweakpane UI_ abstractions.
+				 *
 				 * @bindable
 				 * @readonly
 				 */
 				ref?: import('./GenericMonitor.svelte').GenericMonitorRef | undefined;
 				/**
 				 * Imported Tweakpane `TpPluginBundle` (aliased as `Plugin`) module to automatically register in
-				 * the binding's containing `<Pane>`.
+				 * the `<Binding>`'s containing `<Pane>`.
+				 *
+				 * This property is exposed for advanced use cases only, such as when implementing convenience
+				 * components wrapping `<Binding>`'s functionality in combination with a Tweakpane plugin.
+				 *
+				 * Direct manipulation of Tweakpane's internals can break _Svelte Tweakpane UI_ abstractions.
 				 *
-				 * This is primarily for internal use, when implementing convenience components wrapping
-				 * Binding's functionality in combination with a Tweakpane plugin.
 				 * @default `undefined`
 				 */
 				plugin?: import('@tweakpane/core').TpPluginBundle | undefined;

package/dist/internal/InternalMonitorNumber.svelte.d.ts

@@ -48,18 +48,24 @@ declare const __propDef: {
 				 * [`BindingApi`](https://tweakpane.github.io/docs/api/classes/_internal_.BindingApi.html) for
 				 * this control.
 				 *
-				 * This is primarily for internal use, when implementing convenience components wrapping
-				 * Binding's functionality.
+				 * This property is exposed for advanced use cases only, such as when implementing convenience
+				 * components wrapping `<Binding>`'s functionality.
+				 *
+				 * Direct manipulation of Tweakpane's internals can break _Svelte Tweakpane UI_ abstractions.
+				 *
 				 * @bindable
 				 * @readonly
 				 */
 				ref?: import('./GenericMonitor.svelte').GenericMonitorRef | undefined;
 				/**
 				 * Imported Tweakpane `TpPluginBundle` (aliased as `Plugin`) module to automatically register in
-				 * the binding's containing `<Pane>`.
+				 * the `<Binding>`'s containing `<Pane>`.
+				 *
+				 * This property is exposed for advanced use cases only, such as when implementing convenience
+				 * components wrapping `<Binding>`'s functionality in combination with a Tweakpane plugin.
+				 *
+				 * Direct manipulation of Tweakpane's internals can break _Svelte Tweakpane UI_ abstractions.
 				 *
-				 * This is primarily for internal use, when implementing convenience components wrapping
-				 * Binding's functionality in combination with a Tweakpane plugin.
 				 * @default `undefined`
 				 */
 				plugin?: import('@tweakpane/core').TpPluginBundle | undefined;
@@ -111,7 +117,7 @@ declare const __propDef: {
 		 * */
 		max?: number | undefined;
 		/**
-		 * A function to customize the number's formatting (e.g. rounding, etc.).
+		 * A function to customize the number's string representation (e.g. rounding, etc.).
 		 * @default `undefined`  \
 		 * Normal `.toString()` formatting.
 		 * */
@@ -162,7 +168,12 @@ export type InternalMonitorNumberSlots = typeof __propDef.slots;
  * }, 100);
  * </script>
  *
- * <InternalMonitorNumber value={numberToMonitor} min={-1} max={1} graph={true} />
+ * <InternalMonitorNumber
+ * value={numberToMonitor}
+ * min={-1}
+ * max={1}
+ * graph={true}
+ * />
  * ```
  *
  * @sourceLink

package/dist/internal/InternalMonitorString.svelte.d.ts

@@ -48,18 +48,24 @@ declare const __propDef: {
 				 * [`BindingApi`](https://tweakpane.github.io/docs/api/classes/_internal_.BindingApi.html) for
 				 * this control.
 				 *
-				 * This is primarily for internal use, when implementing convenience components wrapping
-				 * Binding's functionality.
+				 * This property is exposed for advanced use cases only, such as when implementing convenience
+				 * components wrapping `<Binding>`'s functionality.
+				 *
+				 * Direct manipulation of Tweakpane's internals can break _Svelte Tweakpane UI_ abstractions.
+				 *
 				 * @bindable
 				 * @readonly
 				 */
 				ref?: import('./GenericMonitor.svelte').GenericMonitorRef | undefined;
 				/**
 				 * Imported Tweakpane `TpPluginBundle` (aliased as `Plugin`) module to automatically register in
-				 * the binding's containing `<Pane>`.
+				 * the `<Binding>`'s containing `<Pane>`.
+				 *
+				 * This property is exposed for advanced use cases only, such as when implementing convenience
+				 * components wrapping `<Binding>`'s functionality in combination with a Tweakpane plugin.
+				 *
+				 * Direct manipulation of Tweakpane's internals can break _Svelte Tweakpane UI_ abstractions.
 				 *
-				 * This is primarily for internal use, when implementing convenience components wrapping
-				 * Binding's functionality in combination with a Tweakpane plugin.
 				 * @default `undefined`
 				 */
 				plugin?: import('@tweakpane/core').TpPluginBundle | undefined;