device-navigation/dist/nav-controller/exit-out-of.js

Navigate HTML elements in two dimensions with non-pointer devices.

import { findNavTreeNodeByNavEntry } from '../nav-tree/walk-nav-tree.js';
import { focusElement } from '../util/focus.js';
import { NavAction } from './navigate.js';
/**
 * Shift focus from the currently focused node to its parent. If there is no parent, or rather if
 * the parent is the tree root, this returns a failure result.
 *
 * @category Internal
 */
export function exitOutOf(navTree, currentlyFocused) {
    if (!currentlyFocused) {
        return {
            success: false,
            reason: 'no focused node to exit out of',
            direction: undefined,
            navAction: NavAction.Exit,
        };
    }
    const closestGroupAncestor = currentlyFocused.position.ancestorChain
        .toReversed()
        .find((ancestor) => !ancestor.node.root && !ancestor.node.navEntry.navParams.group)?.node;
    if (!closestGroupAncestor || closestGroupAncestor.root) {
        return {
            success: false,
            reason: 'failed to find ancestor, nothing to exit to',
            direction: undefined,
            navAction: NavAction.Exit,
        };
    }
    const { nodeCoords } = findNavTreeNodeByNavEntry(navTree, closestGroupAncestor.navEntry);
    focusElement(closestGroupAncestor.element);
    return {
        success: true,
        defaulted: false,
        wrapped: false,
        newElement: closestGroupAncestor.element,
        direction: undefined,
        navAction: NavAction.Exit,
        coords: nodeCoords,
    };
}