@unrulysystems/native-motion-core 0.1.0-alpha.0

package/dist/gesture/dragConfig.d.cts

@@ -0,0 +1,298 @@
+import type { DragConstraints, SnapConfig } from "./types.cjs";
+import type { MotionValue } from "../types.cjs";
+export type DragAxis = 'x' | 'y';
+export type DragProp = DragAxis | true | false;
+export type DragConfigSeverity = 'development' | 'production';
+export interface DragInfo {
+    readonly point: {
+        readonly x: number;
+        readonly y: number;
+    };
+    readonly delta: {
+        readonly x: number;
+        readonly y: number;
+    };
+    readonly offset: {
+        readonly x: number;
+        readonly y: number;
+    };
+    readonly velocity: {
+        readonly x: number;
+        readonly y: number;
+    };
+}
+export declare const DEFAULT_DRAG_ELASTIC = 0.35;
+export interface DragConstraintsInput {
+    readonly left?: number;
+    readonly right?: number;
+    readonly top?: number;
+    readonly bottom?: number;
+}
+export interface DragSnapPointsInput {
+    readonly x?: readonly number[];
+    readonly y?: readonly number[];
+}
+export type DragCallback = (event: unknown, info: DragInfo) => void;
+export interface MeasuredDragConstraints {
+    top: number;
+    left: number;
+    bottom: number;
+    right: number;
+}
+export type MeasureDragConstraintsCallback = (constraints: MeasuredDragConstraints) => MeasuredDragConstraints | void;
+export declare function validateMeasureReplacementBox(replaced: MeasuredDragConstraints): MeasuredDragConstraints;
+export interface TapInfo {
+    readonly point: {
+        readonly x: number;
+        readonly y: number;
+    };
+}
+export type TapCallback = (event: unknown, info: TapInfo) => void;
+export interface DragSnapPointsX {
+    readonly x: readonly [number, ...number[]];
+    readonly y?: undefined;
+}
+export interface DragSnapPointsY {
+    readonly y: readonly [number, ...number[]];
+    readonly x?: undefined;
+}
+export type DragConstraintsX = {
+    readonly left: number;
+    readonly right: number;
+    readonly top?: undefined;
+    readonly bottom?: undefined;
+    readonly current?: undefined;
+} | {
+    readonly left: number;
+    readonly right?: undefined;
+    readonly top?: undefined;
+    readonly bottom?: undefined;
+    readonly current?: undefined;
+} | {
+    readonly left?: undefined;
+    readonly right: number;
+    readonly top?: undefined;
+    readonly bottom?: undefined;
+    readonly current?: undefined;
+};
+export type DragConstraintsY = {
+    readonly top: number;
+    readonly bottom: number;
+    readonly left?: undefined;
+    readonly right?: undefined;
+    readonly current?: undefined;
+} | {
+    readonly top: number;
+    readonly bottom?: undefined;
+    readonly left?: undefined;
+    readonly right?: undefined;
+    readonly current?: undefined;
+} | {
+    readonly top?: undefined;
+    readonly bottom: number;
+    readonly left?: undefined;
+    readonly right?: undefined;
+    readonly current?: undefined;
+};
+export type DragConstraintsBoth = {
+    readonly left: number;
+    readonly right?: number | undefined;
+    readonly top?: number | undefined;
+    readonly bottom?: number | undefined;
+    readonly current?: undefined;
+} | {
+    readonly left?: number | undefined;
+    readonly right: number;
+    readonly top?: number | undefined;
+    readonly bottom?: number | undefined;
+    readonly current?: undefined;
+} | {
+    readonly left?: number | undefined;
+    readonly right?: number | undefined;
+    readonly top: number;
+    readonly bottom?: number | undefined;
+    readonly current?: undefined;
+} | {
+    readonly left?: number | undefined;
+    readonly right?: number | undefined;
+    readonly top?: number | undefined;
+    readonly bottom: number;
+    readonly current?: undefined;
+};
+export interface DragConstraintsRef {
+    readonly current: unknown;
+    readonly left?: undefined;
+    readonly right?: undefined;
+    readonly top?: undefined;
+    readonly bottom?: undefined;
+}
+export interface DragControlOptions {
+    readonly distanceThreshold?: number | undefined;
+    readonly snapToCursor?: boolean | undefined;
+}
+/**
+ * Runtime-validate DragControls.start options (G-INV-8; seal review r6/r7/r8).
+ * Shared by native and web so both engines refuse malformed options identically.
+ * Omitted options stay undefined (pin defaults at the session); present keys must match shape.
+ * Closed plain-object shape only — unknown keys and non-plain objects refuse loud.
+ */
+export declare function validateDragControlOptions(options: unknown): DragControlOptions | undefined;
+export interface DragControlsHandle {
+    start(event: unknown, options?: DragControlOptions): void;
+    cancel(): void;
+    /** Pin-shaped zero-arg stop (native may ignore optional trailing args at the entry). */
+    stop(): void;
+    /**
+     * Runtime-required for both engines (pin motion.div + native MotionView subscribe).
+     * Optional on the type so pin/class typings without an explicit subscribe member still
+     * assign; `isDragControlsHandle` refuses at resolve when the method is missing (r8 major).
+     */
+    subscribe?(controls: unknown): () => void;
+}
+interface DragCallbackProps {
+    /** R15 D5: number in [0,1] or boolean (true → 0.35, false → 0). Per-side object deferred. */
+    readonly dragElastic?: number | boolean | undefined;
+    readonly dragPropagation?: boolean | undefined;
+    /** Imperative hub (REQ-API-043). Structural — each entry's useDragControls() returns a compatible instance. */
+    readonly dragControls?: DragControlsHandle | undefined;
+    /** When false, element-originated start is refused — hub-only initiation (REQ-API-043). Default true. */
+    readonly dragListener?: boolean | undefined;
+    /** R15 D4 (REQ-API-044): fix session to first axis past the pin 10px threshold. */
+    readonly dragDirectionLock?: boolean | undefined;
+    /** R15 D4: fires once when the lock axis is acquired. */
+    readonly onDirectionLock?: ((axis: DragAxis) => void) | undefined;
+    /**
+     * R15 D5 (REQ-API-045): gates the release velocity seed. Default true (pin).
+     * `false` zeroes platform velocity BEFORE projection (settle-at-release / nearest-to-origin,
+     * never a projected slide — the pin's `velocity: dragMomentum ? v : 0`).
+     */
+    readonly dragMomentum?: boolean | undefined;
+    /**
+     * R15 D5 (REQ-API-045): release inertia customization. Pin spreads InertiaOptions;
+     * `bounceStiffness`/`bounceDamping` name the BOUNDARY spring the two-phase inertia generator
+     * (R16, REQ-GESTURE-023) switches to at a wall — their pin meaning. The R15 D5 mapping onto
+     * the shared release spring is superseded for free-drag (the snap/cancel spring path keeps it
+     * until the snap-curve rung).
+     */
+    readonly dragTransition?: {
+        readonly bounceStiffness?: number;
+        readonly bounceDamping?: number;
+    } | undefined;
+    /**
+     * R15 D5 (REQ-API-045): force release target to origin on the named axes.
+     * `true` → both dragged axes; `'x'`/`'y'` → that axis only.
+     */
+    readonly dragSnapToOrigin?: boolean | 'x' | 'y' | undefined;
+    readonly onDragStart?: DragCallback | undefined;
+    readonly onDrag?: DragCallback | undefined;
+    readonly onDragEnd?: DragCallback | undefined;
+    /**
+     * R15 D5 (REQ-API-046): consumer-supplied MotionValues the drag session writes.
+     * Runtime already accepts these on native; they were missing from the public union.
+     */
+    readonly _dragX?: MotionValue<number> | undefined;
+    readonly _dragY?: MotionValue<number> | undefined;
+}
+interface DragMeasureHookProps {
+    readonly onMeasureDragConstraints?: MeasureDragConstraintsCallback | undefined;
+}
+interface DragNoMeasureHookProps {
+    readonly onMeasureDragConstraints?: undefined;
+}
+export type DragProps = {
+    readonly drag?: undefined;
+    readonly dragConstraints?: undefined;
+    readonly dragElastic?: undefined;
+    readonly dragSnapPoints?: undefined;
+    readonly dragPropagation?: undefined;
+    readonly dragControls?: undefined;
+    readonly dragListener?: undefined;
+    readonly onMeasureDragConstraints?: undefined;
+    readonly onDragStart?: undefined;
+    readonly onDrag?: undefined;
+    readonly onDragEnd?: undefined;
+    readonly _dragX?: undefined;
+    readonly _dragY?: undefined;
+} | ({
+    readonly drag: 'x';
+    readonly dragSnapPoints?: undefined;
+    readonly dragConstraints: DragConstraintsRef;
+} & DragCallbackProps & DragMeasureHookProps) | ({
+    readonly drag: 'x';
+    readonly dragSnapPoints?: DragSnapPointsX | undefined;
+    readonly dragConstraints?: DragConstraintsX | undefined;
+} & DragCallbackProps & DragNoMeasureHookProps) | ({
+    readonly drag: 'y';
+    readonly dragSnapPoints?: undefined;
+    readonly dragConstraints: DragConstraintsRef;
+} & DragCallbackProps & DragMeasureHookProps) | ({
+    readonly drag: 'y';
+    readonly dragSnapPoints?: DragSnapPointsY | undefined;
+    readonly dragConstraints?: DragConstraintsY | undefined;
+} & DragCallbackProps & DragNoMeasureHookProps) | ({
+    readonly drag: true;
+    readonly dragSnapPoints?: undefined;
+    readonly dragConstraints: DragConstraintsRef;
+} & DragCallbackProps & DragMeasureHookProps) | ({
+    readonly drag: true;
+    readonly dragSnapPoints?: undefined;
+    readonly dragConstraints?: DragConstraintsBoth | undefined;
+} & DragCallbackProps & DragNoMeasureHookProps) | ({
+    readonly drag: false;
+    readonly dragSnapPoints?: undefined;
+    readonly dragConstraints?: undefined;
+} & DragCallbackProps & DragNoMeasureHookProps);
+export interface DragConfigInput {
+    readonly drag: unknown;
+    readonly dragConstraints?: unknown;
+    readonly dragElastic?: unknown;
+    readonly dragSnapPoints?: unknown;
+    readonly dragPropagation?: unknown;
+    readonly onMeasureDragConstraints?: unknown;
+    /** R15 D3 (REQ-API-043): structural hub — validated at the shared resolver boundary. */
+    readonly dragControls?: unknown;
+    /** R15 D3 (REQ-API-043): element-originated start gate — boolean only. */
+    readonly dragListener?: unknown;
+    /** R15 D4 (REQ-API-044): axis lock after pin 10px threshold. */
+    readonly dragDirectionLock?: unknown;
+    /** R15 D5 (REQ-API-045). */
+    readonly dragMomentum?: unknown;
+    readonly dragTransition?: unknown;
+    readonly dragSnapToOrigin?: unknown;
+}
+export interface ResolvedDragAxisConfig {
+    readonly constraints?: DragConstraints | undefined;
+    readonly snap?: SnapConfig | undefined;
+    readonly constraintsRef?: {
+        readonly ref: DragConstraintsRef;
+        readonly elastic: number;
+    } | undefined;
+}
+interface ResolvedDragHubFields {
+    readonly dragPropagation: boolean;
+    /** Canonical: omitted and true both resolve true (pin default element listener). */
+    readonly dragListener: boolean;
+    /** Process-local identity token for the hub object, or null when absent. */
+    readonly dragControlsToken: number | null;
+    /** R15 D4: omitted and false are identical (default off). */
+    readonly dragDirectionLock: boolean;
+    /** R15 D5: omitted and true are identical (pin default momentum on). */
+    readonly dragMomentum: boolean;
+    /** R15 D5: resolved bounce spring override (undefined → GESTURE_RELEASE_SPRING). */
+    readonly dragTransition: {
+        readonly bounceStiffness?: number;
+        readonly bounceDamping?: number;
+    } | null;
+    /** R15 D5: which axes force release target 0. */
+    readonly dragSnapToOrigin: false | true | 'x' | 'y';
+}
+export type ResolvedDragConfig = {
+    readonly x?: ResolvedDragAxisConfig | undefined;
+    readonly y?: ResolvedDragAxisConfig | undefined;
+} & ResolvedDragHubFields;
+export declare function resolvedDragAxes(config: ResolvedDragConfig): readonly DragAxis[];
+export declare function dragConfigMountSignature(config: ResolvedDragConfig | null): string;
+export declare function describeValue(value: unknown): string;
+export declare function gateOrphanDragCallbacks(callbackName: string, severity: DragConfigSeverity, report: (error: Error) => void): void;
+export declare function resolveDragConfig(input: DragConfigInput, severity: DragConfigSeverity, report: (error: Error) => void): ResolvedDragConfig | null;
+export {};

package/dist/gesture/dragConfig.d.ts

@@ -0,0 +1,298 @@
+import type { DragConstraints, SnapConfig } from "./types.js";
+import type { MotionValue } from "../types.js";
+export type DragAxis = 'x' | 'y';
+export type DragProp = DragAxis | true | false;
+export type DragConfigSeverity = 'development' | 'production';
+export interface DragInfo {
+    readonly point: {
+        readonly x: number;
+        readonly y: number;
+    };
+    readonly delta: {
+        readonly x: number;
+        readonly y: number;
+    };
+    readonly offset: {
+        readonly x: number;
+        readonly y: number;
+    };
+    readonly velocity: {
+        readonly x: number;
+        readonly y: number;
+    };
+}
+export declare const DEFAULT_DRAG_ELASTIC = 0.35;
+export interface DragConstraintsInput {
+    readonly left?: number;
+    readonly right?: number;
+    readonly top?: number;
+    readonly bottom?: number;
+}
+export interface DragSnapPointsInput {
+    readonly x?: readonly number[];
+    readonly y?: readonly number[];
+}
+export type DragCallback = (event: unknown, info: DragInfo) => void;
+export interface MeasuredDragConstraints {
+    top: number;
+    left: number;
+    bottom: number;
+    right: number;
+}
+export type MeasureDragConstraintsCallback = (constraints: MeasuredDragConstraints) => MeasuredDragConstraints | void;
+export declare function validateMeasureReplacementBox(replaced: MeasuredDragConstraints): MeasuredDragConstraints;
+export interface TapInfo {
+    readonly point: {
+        readonly x: number;
+        readonly y: number;
+    };
+}
+export type TapCallback = (event: unknown, info: TapInfo) => void;
+export interface DragSnapPointsX {
+    readonly x: readonly [number, ...number[]];
+    readonly y?: undefined;
+}
+export interface DragSnapPointsY {
+    readonly y: readonly [number, ...number[]];
+    readonly x?: undefined;
+}
+export type DragConstraintsX = {
+    readonly left: number;
+    readonly right: number;
+    readonly top?: undefined;
+    readonly bottom?: undefined;
+    readonly current?: undefined;
+} | {
+    readonly left: number;
+    readonly right?: undefined;
+    readonly top?: undefined;
+    readonly bottom?: undefined;
+    readonly current?: undefined;
+} | {
+    readonly left?: undefined;
+    readonly right: number;
+    readonly top?: undefined;
+    readonly bottom?: undefined;
+    readonly current?: undefined;
+};
+export type DragConstraintsY = {
+    readonly top: number;
+    readonly bottom: number;
+    readonly left?: undefined;
+    readonly right?: undefined;
+    readonly current?: undefined;
+} | {
+    readonly top: number;
+    readonly bottom?: undefined;
+    readonly left?: undefined;
+    readonly right?: undefined;
+    readonly current?: undefined;
+} | {
+    readonly top?: undefined;
+    readonly bottom: number;
+    readonly left?: undefined;
+    readonly right?: undefined;
+    readonly current?: undefined;
+};
+export type DragConstraintsBoth = {
+    readonly left: number;
+    readonly right?: number | undefined;
+    readonly top?: number | undefined;
+    readonly bottom?: number | undefined;
+    readonly current?: undefined;
+} | {
+    readonly left?: number | undefined;
+    readonly right: number;
+    readonly top?: number | undefined;
+    readonly bottom?: number | undefined;
+    readonly current?: undefined;
+} | {
+    readonly left?: number | undefined;
+    readonly right?: number | undefined;
+    readonly top: number;
+    readonly bottom?: number | undefined;
+    readonly current?: undefined;
+} | {
+    readonly left?: number | undefined;
+    readonly right?: number | undefined;
+    readonly top?: number | undefined;
+    readonly bottom: number;
+    readonly current?: undefined;
+};
+export interface DragConstraintsRef {
+    readonly current: unknown;
+    readonly left?: undefined;
+    readonly right?: undefined;
+    readonly top?: undefined;
+    readonly bottom?: undefined;
+}
+export interface DragControlOptions {
+    readonly distanceThreshold?: number | undefined;
+    readonly snapToCursor?: boolean | undefined;
+}
+/**
+ * Runtime-validate DragControls.start options (G-INV-8; seal review r6/r7/r8).
+ * Shared by native and web so both engines refuse malformed options identically.
+ * Omitted options stay undefined (pin defaults at the session); present keys must match shape.
+ * Closed plain-object shape only — unknown keys and non-plain objects refuse loud.
+ */
+export declare function validateDragControlOptions(options: unknown): DragControlOptions | undefined;
+export interface DragControlsHandle {
+    start(event: unknown, options?: DragControlOptions): void;
+    cancel(): void;
+    /** Pin-shaped zero-arg stop (native may ignore optional trailing args at the entry). */
+    stop(): void;
+    /**
+     * Runtime-required for both engines (pin motion.div + native MotionView subscribe).
+     * Optional on the type so pin/class typings without an explicit subscribe member still
+     * assign; `isDragControlsHandle` refuses at resolve when the method is missing (r8 major).
+     */
+    subscribe?(controls: unknown): () => void;
+}
+interface DragCallbackProps {
+    /** R15 D5: number in [0,1] or boolean (true → 0.35, false → 0). Per-side object deferred. */
+    readonly dragElastic?: number | boolean | undefined;
+    readonly dragPropagation?: boolean | undefined;
+    /** Imperative hub (REQ-API-043). Structural — each entry's useDragControls() returns a compatible instance. */
+    readonly dragControls?: DragControlsHandle | undefined;
+    /** When false, element-originated start is refused — hub-only initiation (REQ-API-043). Default true. */
+    readonly dragListener?: boolean | undefined;
+    /** R15 D4 (REQ-API-044): fix session to first axis past the pin 10px threshold. */
+    readonly dragDirectionLock?: boolean | undefined;
+    /** R15 D4: fires once when the lock axis is acquired. */
+    readonly onDirectionLock?: ((axis: DragAxis) => void) | undefined;
+    /**
+     * R15 D5 (REQ-API-045): gates the release velocity seed. Default true (pin).
+     * `false` zeroes platform velocity BEFORE projection (settle-at-release / nearest-to-origin,
+     * never a projected slide — the pin's `velocity: dragMomentum ? v : 0`).
+     */
+    readonly dragMomentum?: boolean | undefined;
+    /**
+     * R15 D5 (REQ-API-045): release inertia customization. Pin spreads InertiaOptions;
+     * `bounceStiffness`/`bounceDamping` name the BOUNDARY spring the two-phase inertia generator
+     * (R16, REQ-GESTURE-023) switches to at a wall — their pin meaning. The R15 D5 mapping onto
+     * the shared release spring is superseded for free-drag (the snap/cancel spring path keeps it
+     * until the snap-curve rung).
+     */
+    readonly dragTransition?: {
+        readonly bounceStiffness?: number;
+        readonly bounceDamping?: number;
+    } | undefined;
+    /**
+     * R15 D5 (REQ-API-045): force release target to origin on the named axes.
+     * `true` → both dragged axes; `'x'`/`'y'` → that axis only.
+     */
+    readonly dragSnapToOrigin?: boolean | 'x' | 'y' | undefined;
+    readonly onDragStart?: DragCallback | undefined;
+    readonly onDrag?: DragCallback | undefined;
+    readonly onDragEnd?: DragCallback | undefined;
+    /**
+     * R15 D5 (REQ-API-046): consumer-supplied MotionValues the drag session writes.
+     * Runtime already accepts these on native; they were missing from the public union.
+     */
+    readonly _dragX?: MotionValue<number> | undefined;
+    readonly _dragY?: MotionValue<number> | undefined;
+}
+interface DragMeasureHookProps {
+    readonly onMeasureDragConstraints?: MeasureDragConstraintsCallback | undefined;
+}
+interface DragNoMeasureHookProps {
+    readonly onMeasureDragConstraints?: undefined;
+}
+export type DragProps = {
+    readonly drag?: undefined;
+    readonly dragConstraints?: undefined;
+    readonly dragElastic?: undefined;
+    readonly dragSnapPoints?: undefined;
+    readonly dragPropagation?: undefined;
+    readonly dragControls?: undefined;
+    readonly dragListener?: undefined;
+    readonly onMeasureDragConstraints?: undefined;
+    readonly onDragStart?: undefined;
+    readonly onDrag?: undefined;
+    readonly onDragEnd?: undefined;
+    readonly _dragX?: undefined;
+    readonly _dragY?: undefined;
+} | ({
+    readonly drag: 'x';
+    readonly dragSnapPoints?: undefined;
+    readonly dragConstraints: DragConstraintsRef;
+} & DragCallbackProps & DragMeasureHookProps) | ({
+    readonly drag: 'x';
+    readonly dragSnapPoints?: DragSnapPointsX | undefined;
+    readonly dragConstraints?: DragConstraintsX | undefined;
+} & DragCallbackProps & DragNoMeasureHookProps) | ({
+    readonly drag: 'y';
+    readonly dragSnapPoints?: undefined;
+    readonly dragConstraints: DragConstraintsRef;
+} & DragCallbackProps & DragMeasureHookProps) | ({
+    readonly drag: 'y';
+    readonly dragSnapPoints?: DragSnapPointsY | undefined;
+    readonly dragConstraints?: DragConstraintsY | undefined;
+} & DragCallbackProps & DragNoMeasureHookProps) | ({
+    readonly drag: true;
+    readonly dragSnapPoints?: undefined;
+    readonly dragConstraints: DragConstraintsRef;
+} & DragCallbackProps & DragMeasureHookProps) | ({
+    readonly drag: true;
+    readonly dragSnapPoints?: undefined;
+    readonly dragConstraints?: DragConstraintsBoth | undefined;
+} & DragCallbackProps & DragNoMeasureHookProps) | ({
+    readonly drag: false;
+    readonly dragSnapPoints?: undefined;
+    readonly dragConstraints?: undefined;
+} & DragCallbackProps & DragNoMeasureHookProps);
+export interface DragConfigInput {
+    readonly drag: unknown;
+    readonly dragConstraints?: unknown;
+    readonly dragElastic?: unknown;
+    readonly dragSnapPoints?: unknown;
+    readonly dragPropagation?: unknown;
+    readonly onMeasureDragConstraints?: unknown;
+    /** R15 D3 (REQ-API-043): structural hub — validated at the shared resolver boundary. */
+    readonly dragControls?: unknown;
+    /** R15 D3 (REQ-API-043): element-originated start gate — boolean only. */
+    readonly dragListener?: unknown;
+    /** R15 D4 (REQ-API-044): axis lock after pin 10px threshold. */
+    readonly dragDirectionLock?: unknown;
+    /** R15 D5 (REQ-API-045). */
+    readonly dragMomentum?: unknown;
+    readonly dragTransition?: unknown;
+    readonly dragSnapToOrigin?: unknown;
+}
+export interface ResolvedDragAxisConfig {
+    readonly constraints?: DragConstraints | undefined;
+    readonly snap?: SnapConfig | undefined;
+    readonly constraintsRef?: {
+        readonly ref: DragConstraintsRef;
+        readonly elastic: number;
+    } | undefined;
+}
+interface ResolvedDragHubFields {
+    readonly dragPropagation: boolean;
+    /** Canonical: omitted and true both resolve true (pin default element listener). */
+    readonly dragListener: boolean;
+    /** Process-local identity token for the hub object, or null when absent. */
+    readonly dragControlsToken: number | null;
+    /** R15 D4: omitted and false are identical (default off). */
+    readonly dragDirectionLock: boolean;
+    /** R15 D5: omitted and true are identical (pin default momentum on). */
+    readonly dragMomentum: boolean;
+    /** R15 D5: resolved bounce spring override (undefined → GESTURE_RELEASE_SPRING). */
+    readonly dragTransition: {
+        readonly bounceStiffness?: number;
+        readonly bounceDamping?: number;
+    } | null;
+    /** R15 D5: which axes force release target 0. */
+    readonly dragSnapToOrigin: false | true | 'x' | 'y';
+}
+export type ResolvedDragConfig = {
+    readonly x?: ResolvedDragAxisConfig | undefined;
+    readonly y?: ResolvedDragAxisConfig | undefined;
+} & ResolvedDragHubFields;
+export declare function resolvedDragAxes(config: ResolvedDragConfig): readonly DragAxis[];
+export declare function dragConfigMountSignature(config: ResolvedDragConfig | null): string;
+export declare function describeValue(value: unknown): string;
+export declare function gateOrphanDragCallbacks(callbackName: string, severity: DragConfigSeverity, report: (error: Error) => void): void;
+export declare function resolveDragConfig(input: DragConfigInput, severity: DragConfigSeverity, report: (error: Error) => void): ResolvedDragConfig | null;
+export {};