import { SvelteComponent } from 'svelte'
import type { Point2dInputParams, Point3dInputParams, Point4dInputParams } from 'tweakpane'
import type { Simplify, ValueChangeEvent } from '../utils.js'
export type PointValue2dObject = {
	x: number
	y: number
}
export type PointValue2dTuple = [x: number, y: number]
export type PointValue2d = Simplify<PointValue2dObject | PointValue2dTuple>
export type PointValue3dObject = {
	x: number
	y: number
	z: number
}
export type PointValue3dTuple = [x: number, y: number, z: number]
export type PointValue3d = Simplify<PointValue3dObject | PointValue3dTuple>
export type PointValue4dObject = {
	x: number
	y: number
	z: number
	w: number
}
export type PointValue4dTuple = [x: number, y: number, z: number, w: number]
export type PointValue4d = Simplify<PointValue4dObject | PointValue4dTuple>
/**
 * TODO docs
 */
export type PointOptions<
	Dimensions extends '2' | '3' | '4',
	Axis extends 'w' | 'x' | 'y' | 'z',
> = Dimensions extends '4'
	? Point4dInputParams[Axis]
	: Dimensions extends '3'
		? Point3dInputParams[Axis]
		: Dimensions extends '2'
			? Point2dInputParams[Axis]
			: never
export type PointChangeEvent = ValueChangeEvent<PointValue2d | PointValue3d | PointValue4d>
declare class __sveltets_Render<T extends PointValue2d | PointValue3d | PointValue4d> {
	props(): Omit<
		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?:
					| (T extends PointValue4d
							? Point4dInputParams
							: T extends PointValue3d
								? Point3dInputParams
								: T extends PointValue2d
									? Point2dInputParams
									: unknown)
					| 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?: import('../internal/GenericInput.svelte').GenericInputRef | 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('../utils.js').Plugin | undefined
			},
			'object' | 'key'
		> & {
			/**
			 * A 2D, 3D, or 4D point object to control.
			 *
			 * Takes a tuple with a `number` value for each dimension, or an object
			 * with at least `x` and `y` values, and optionally `z` and `w` values for
			 * additional dimensions.
			 *
			 * The type of this value will determine the availability of axis-specific
			 * option props.
			 *
			 * @bindable
			 */
			value: T
		} & {
			/**
			 * DOM class name of the button used to expand and collapse the input's
			 * picker.
			 *
			 * @default `undefined`
			 */
			buttonClass?: string
			/**
			 * Expand or collapse the input's picker.
			 *
			 * @default `false`
			 * @bindable
			 */
			expanded?: boolean
			/**
			 * The style of value "picker" to use in the input.
			 *
			 * @default `'popup'`
			 */
			picker?: 'inline' | 'popup'
			/**
			 * Allow users to interactively expand / contract the picker.
			 *
			 * @default `true`
			 */
			userExpandable?: boolean
		},
		'ref' | 'options' | 'plugin' | 'buttonClass'
	> &
		(T extends PointValue2d | PointValue3d | PointValue4d
			? {
					/**
					 * Input parameters specific to the X dimension.
					 *
					 * Renamed from `x` in Tweakpane API to clarify that it is an object of
					 * options, not a value.
					 *
					 * @default `undefined`
					 */
					optionsX?:
						| (T extends infer T_1
								? T_1 extends T
									? T_1 extends PointValue4d
										? Point4dInputParams
										: T_1 extends PointValue3d
											? Point3dInputParams
											: T_1 extends PointValue2d
												? Point2dInputParams
												: unknown
									: never
								: never)['x']
						| undefined
					/**
					 * Input parameters specific to the Y dimension.
					 *
					 * For 2D point values, the object also includes the `inverted` key,
					 * which inverts the Y axis.
					 *
					 * Renamed from `y` in Tweakpane API to clarify that it is an object of
					 * options, not a value.
					 *
					 * @default `undefined`
					 */
					optionsY?:
						| (T extends infer T_2
								? T_2 extends T
									? T_2 extends PointValue4d
										? Point4dInputParams
										: T_2 extends PointValue3d
											? Point3dInputParams
											: T_2 extends PointValue2d
												? Point2dInputParams
												: unknown
									: never
								: never)['y']
						| undefined
				}
			: unknown) &
		(T extends PointValue3d | PointValue4d
			? {
					/**
					 * Input parameters specific to the Z dimension.
					 *
					 * Renamed from `z` in Tweakpane API to clarify that it is an object
					 * of options, not a value.
					 *
					 * @default `undefined`
					 */
					optionsZ?:
						| (T extends infer T_3
								? T_3 extends T
									? T_3 extends PointValue4d
										? Point4dInputParams
										: T_3 extends PointValue3d
											? Point3dInputParams
											: T_3 extends PointValue2d
												? Point2dInputParams
												: unknown
									: never
								: never)['z']
						| undefined
				}
			: unknown) &
		(T extends PointValue4d
			? {
					/**
					 * Input parameters specific to the W dimension.
					 *
					 * Renamed from `w` in Tweakpane API to clarify that it is an object
					 * of options, not a value.
					 *
					 * @default `undefined`
					 */
					optionsW?:
						| (T extends infer T_4
								? T_4 extends T
									? T_4 extends PointValue4d
										? Point4dInputParams
										: T_4 extends PointValue3d
											? Point3dInputParams
											: T_4 extends PointValue2d
												? Point2dInputParams
												: unknown
									: never
								: never)['w']
						| undefined
				}
			: unknown) & {
			/**
			 * A 2D, 3D, or 4D point object to control.
			 *
			 * Takes a tuple with a `number` value for each dimension, or an object
			 * with at least `x` and `y` values, and optionally `z` and `w` values for
			 * additional dimensions.
			 *
			 * The type of this value will determine the availability of axis-specific
			 * option props.
			 *
			 * @bindable
			 */
			value: T
			/**
			 * The minimum value for all dimensions.
			 *
			 * If undefined, there is no minimum.
			 *
			 * @default `undefined`
			 */
			min?: number
			/**
			 * The maximum value for all dimensions.
			 *
			 * If undefined, there is no maximum.
			 *
			 * @default `undefined`
			 */
			max?: number
			/**
			 * A function to customize the point value's string representation (e.g.
			 * rounding, etc.).
			 *
			 * If undefined, normal `.toString()` formatting is used.
			 *
			 * @default `undefined`
			 */
			format?: ((value: number) => string) | undefined
			/**
			 * The unit scale for key-based input for all dimensions (e.g. the up and
			 * down arrow keys).
			 *
			 * Will be overridden by `stepValue` if defined.
			 *
			 * @default `1`
			 */
			keyScale?: number
			/**
			 * The unit scale for pointer-based input for all dimensions.
			 *
			 * If undefined, default is dynamic [based on magnitude of
			 * `value`](https://github.com/cocopon/tweakpane/blob/66dfbea04bfe9b7f031673c955ceda1f92356e75/packages/core/src/common/number/util.ts#L54).
			 *
			 * @default `undefined``
			 */
			pointerScale?: number
			/**
			 * The minimum step interval for all dimensions.
			 *
			 * If undefined, there is no step constraint.
			 *
			 * @default `undefined`
			 */
			step?: number
		}
	events(): {
		/**
		 * Fires when `value` changes.
		 *
		 * _This event is provided for advanced use cases. It's usually preferred to
		 * bind to the `value` prop instead._
		 *
		 * The `event.details` payload includes a copy of the value and an `origin`
		 * field to distinguish between user-interactive changes (`internal`) and
		 * changes resulting from programmatic manipulation of the `value`
		 * (`external`).
		 *
		 * @extends ValueChangeEvent
		 * @event
		 */
		change: PointChangeEvent
	}
	slots(): {}
}
export type PointProps<T extends PointValue2d | PointValue3d | PointValue4d> = ReturnType<
	__sveltets_Render<T>['props']
>
export type PointEvents<T extends PointValue2d | PointValue3d | PointValue4d> = ReturnType<
	__sveltets_Render<T>['events']
>
export type PointSlots<T extends PointValue2d | PointValue3d | PointValue4d> = ReturnType<
	__sveltets_Render<T>['slots']
>
/**
 * Wraps the Tweakpane [point bindings](https://tweakpane.github.io/docs/input-bindings/#point).
 *
 * Provides a nice cartesian picker for 2D points, and numeric input fields for 3D and 4D points. See
 * the `<RotationEuler>` and `<RotationQuaternion>` components for higher-dimension graphical pickers.
 *
 * Extends the vanilla JS Tweakpane APIs to also support tuple values. (Useful when working with
 * frameworks like [three.js](https://threejs.org) / [threlte](https://threlte.xyz).)
 *
 * `<Point>` is a dynamic component, and the availability of the `optionsZ` and `optionsW` props will
 * change depending on the number of dimensions in the `value`.
 *
 * Usage outside of a `<Pane>` component will implicitly wrap the point picker in a `<Pane
 * position="inline">` component.
 *
 * @emits {PointChangeEvent} change - When `value` changes. (This event is provided for advanced use cases. Prefer binding to `value`.)
 *
 * @example
 * ```svelte
 * <script lang="ts">
 * import {
 *   Point,
 *   type PointOptions,
 *   type PointValue2d,
 *   type PointValue3d,
 *   type PointValue4d,
 * } from 'svelte-tweakpane-ui'
 *
 * let point2d: PointValue2d = { x: 0, y: 0 }
 *
 * // tuples are also fine
 * let point3d: PointValue3d = [0, 0, 0]
 *
 * // dimension-specific option type needs to know the type of the point value
 * let point3dXOptions: PointOptions<'3', 'x'> = {
 *   min: -100,
 *   max: 100,
 * }
 *
 * let point4d: PointValue4d = {
 *   x: 0,
 *   y: 0,
 *   z: 0,
 *   w: 0,
 * }
 * </script>
 *
 * <Point
 * bind:value={point2d}
 * expanded={true}
 * label="2D Point Picker"
 * picker="inline"
 * userExpandable={false}
 * />
 * <Point
 * bind:value={point3d}
 * label="3D Point Picker"
 * optionsX={point3dXOptions}
 * />
 * <Point bind:value={point4d} min={0} max={100} label="4D Point Picker" />
 *
 * <pre>
 * 2D Value:
 * {JSON.stringify(point2d, null, 2)}
 *
 * 3D Value:
 * {JSON.stringify(point3d, null, 2)}
 *
 * 4D Value:
 * {JSON.stringify(point4d, null, 2)}
 * </pre>
 * ```
 *
 * @sourceLink
 * [Point.svelte](https://github.com/kitschpatrol/svelte-tweakpane-ui/blob/main/src/lib/control/Point.svelte)
 */
export default class Point<
	T extends PointValue2d | PointValue3d | PointValue4d,
> extends SvelteComponent<PointProps<T>, PointEvents<T>, PointSlots<T>> {}
export {}