svelte-tweakpane-ui
Version:
A Svelte component library wrapping UI elements from Tweakpane, plus some additional functionality for convenience and flexibility.
165 lines (164 loc) • 4.64 kB
TypeScript
import { SvelteComponent } from 'svelte'
import type { BaseMonitorParams, MonitorBindingApi } from '@tweakpane/core'
export type GenericMonitorOptions = BaseMonitorParams
export type GenericMonitorRef = MonitorBindingApi
declare class __sveltets_Render<
T extends any,
U extends GenericMonitorOptions,
V extends GenericMonitorRef = GenericMonitorRef,
> {
props(): Omit<
{
/**
* The binding's target object with values to manipulate.
*
* @bindable
*/
object: import('@tweakpane/core').Bindable & Record<string, T>
/**
* The key for the value in the target `object` that the control should
* manipulate.
*/
key: string
/**
* Prevent interactivity and gray out the control.
*
* @default `false`
*/
disabled?: boolean
/**
* Text displayed next to control.
*
* @default `undefined`
*/
label?: string | undefined
/**
* Tweakpane's internal options object.
*
* See
* [`BindingParams`](https://tweakpane.github.io/docs/api/types/BindingParams.html).
*
* Valid types are contingent on the type of the value `key` points to in
* `object`.
*
* This is intended internal use, when implementing convenience components
* wrapping Binding's functionality. Options of interest are instead exposed
* as top-level props in _Svelte Tweakpane UI_.
*
* @default `undefined`
*/
options?: U | undefined
/**
* Custom color scheme.
*
* If undefined, inherits default Tweakpane theme equivalent to
* `ThemeUtils.presets.standard`, or the theme set with
* `setGlobalDefaultTheme()`.
*
* @default `undefined`
*/
theme?: import('..').Theme | undefined
/**
* Reference to internal Tweakpane
* [`BindingApi`](https://tweakpane.github.io/docs/api/classes/_internal_.BindingApi.html)
* for this control.
*
* 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>`.
*
* 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.
*
* @default `undefined`
*/
plugin?: import('..').Plugin | undefined
},
'object' | 'key'
> & {
/**
* The value to control.
*
* @bindable
*/
value: T
} & {
/**
* Number of past states to retain.
*
* If value is `number` and `graph` is `true`, default value is `64`.
*
* @default `1`
*/
bufferSize?: number
/**
* Time between value samples in milliseconds.
*
* Useful when `graph` is true. Defaults to reactive value updates only
* (`interval={0}`).
*
* @default `0`
*/
interval?: number
/**
* Number of visible rows of state history.
*
* If `bufferSize` is larger, then the value window will scroll once state
* history exceeds row count.
*
* If value is `string` and `multiline` is `true`, default value is `3`.
*
* @default `1`
*/
rows?: number
}
events(): {} & {
[evt: string]: CustomEvent<any>
}
slots(): {}
}
export type GenericMonitorProps<
T extends any,
U extends GenericMonitorOptions,
V extends GenericMonitorRef = GenericMonitorRef,
> = ReturnType<__sveltets_Render<T, U, V>['props']>
export type GenericMonitorEvents<
T extends any,
U extends GenericMonitorOptions,
V extends GenericMonitorRef = GenericMonitorRef,
> = ReturnType<__sveltets_Render<T, U, V>['events']>
export type GenericMonitorSlots<
T extends any,
U extends GenericMonitorOptions,
V extends GenericMonitorRef = GenericMonitorRef,
> = ReturnType<__sveltets_Render<T, U, V>['slots']>
/**
* This component is for internal use only.
*
* @sourceLink
* [GenericMonitor.svelte](https://github.com/kitschpatrol/svelte-tweakpane-ui/blob/main/src/lib/internal/GenericMonitor.svelte)
*/
export default class GenericMonitor<
T extends any,
U extends GenericMonitorOptions,
V extends GenericMonitorRef = GenericMonitorRef,
> extends SvelteComponent<
GenericMonitorProps<T, U, V>,
GenericMonitorEvents<T, U, V>,
GenericMonitorSlots<T, U, V>
> {}
export {}