/* * Copyright 2020 Adobe. All rights reserved. * This file is licensed to you under the Apache License, Version 2.0 (the "License"); * you may not use this file except in compliance with the License. You may obtain a copy * of the License at http://www.apache.org/licenses/LICENSE-2.0 * * Unless required by applicable law or agreed to in writing, software distributed under * the License is distributed on an "AS IS" BASIS, WITHOUT WARRANTIES OR REPRESENTATIONS * OF ANY KIND, either express or implied. See the License for the specific language * governing permissions and limitations under the License. */ import type {Collection, Node} from '@react-types/shared'; export function getChildNodes(node: Node, collection: Collection>): Iterable> { // New API: call collection.getChildren with the node key. if (typeof collection.getChildren === 'function') { return collection.getChildren(node.key); } // Old API: access childNodes directly. return node.childNodes; } export function getFirstItem(iterable: Iterable): T | undefined { return getNthItem(iterable, 0); } export function getNthItem(iterable: Iterable, index: number): T | undefined { if (index < 0) { return undefined; } let i = 0; for (let item of iterable) { if (i === index) { return item; } i++; } } export function getLastItem(iterable: Iterable): T | undefined { let lastItem: T | undefined = undefined; for (let value of iterable) { lastItem = value; } return lastItem; } export function compareNodeOrder(collection: Collection>, a: Node, b: Node) { // If the two nodes have the same parent, compare their indices. if (a.parentKey === b.parentKey) { return a.index - b.index; } // Otherwise, collect all of the ancestors from each node, and find the first one that doesn't match starting from the root. // Include the base nodes in case we are comparing nodes of different levels so that we can compare the higher node to the lower level node's // ancestor of the same level let aAncestors = [...getAncestors(collection, a), a]; let bAncestors = [...getAncestors(collection, b), b]; let firstNonMatchingAncestor = aAncestors.slice(0, bAncestors.length).findIndex((a, i) => a !== bAncestors[i]); if (firstNonMatchingAncestor !== -1) { // Compare the indices of two children within the common ancestor. a = aAncestors[firstNonMatchingAncestor]; b = bAncestors[firstNonMatchingAncestor]; return a.index - b.index; } // If there isn't a non matching ancestor, we might be in a case where one of the nodes is the ancestor of the other. if (aAncestors.findIndex(node => node === b) >= 0) { return 1; } else if (bAncestors.findIndex(node => node === a) >= 0) { return -1; } // 🤷 return -1; } function getAncestors(collection: Collection>, node: Node): Node[] { let parents: Node[] = []; let currNode: Node | null = node; while (currNode?.parentKey != null) { currNode = collection.getItem(currNode.parentKey); if (currNode) { parents.unshift(currNode); } } return parents; }