import { type ShallowRef } from "vue";
import type { Surface } from "@visuallyjs/browser-ui";
/**
 * Composable that provides access to a Surface in the current scope, as a reactive ref.
 *
 * ```vue
 * <script setup>
 * import { useSurface } from "@visuallyjs/browser-ui-vue"
 *
 * const surface = useSurface()
 *
 * function zoomToFit() {
 *   surface?.zoomToFit()
 * }
 *
 * </script>
 *
 * <template>
 *   <button :click="zoomToFit()">Zoom to fit</button>
 * </template>
 * ```
 *
 * @group Hooks
 */
export declare function useSurface(): ShallowRef<Surface>;