/** @module @airtable/blocks/ui: useCursor */ /** */
import Cursor from '../models/cursor';
/**
 * A hook for connecting a React component to your base's cursor. This returns a {@link Cursor}
 * instance and will re-render your component whenever the active Table or active View changes.
 * It excludes any change to the selected Records or selected Fields.
 *
 * `useCursor` should meet most of your needs for working with base cursors. If you need more granular
 * control of when your component updates or want to do anything other than re-render, the lower
 * level {@link useWatchable} hook might help.
 *
 * Returns the current cursor.
 *
 * @example
 * ```js
 * import {useBase, useCursor} from '@airtable/blocks/ui';
 *
 * // renders a list of tables and automatically updates
 * function TableList() {
 *      const base = useBase();
 *      const cursor = useCursor();
 *
 *      const table = base.getTableById(cursor.activeTableId);
 *
 *      return <p>The table named "{table.name}" is active!</p>;
 * }
 * ```
 * @docsPath UI/hooks/useCursor
 * @hook
 */
declare const useCursor: () => Cursor;
export default useCursor;