prettier-plugin-multiline-arrays/dist/printer/child-docs.js

Prettier plugin to force all arrays to be multiline.

/**
 * @returns Boolean true means keep walking children and siblings, false means stop walking children
 *   and siblings. Returning false does not stop walking of aunts/uncles or ancestors.
 */
export function walkDoc(startDoc, 
/** Return something falsy to prevent walking of child docs */
debug, 
/** If this returns something falsy, none of the current node's children will be walked. */
callback, parents = [], index = undefined) {
    if (!startDoc) {
        return true;
    }
    if (debug) {
        const parent = parents[0];
        console.info({
            firingCallbackFor: startDoc,
            status: 'Calling callback',
            parent: parent
                ? {
                    isArray: Array.isArray(parent),
                    type: parent?.type ?? typeof parent,
                }
                : undefined,
            index,
        });
    }
    if (!callback(startDoc, parents, index)) {
        // if the callback returns something falsy, don't try to walk its children
        return false;
    }
    if (typeof startDoc === 'string') {
        return true;
    }
    else if (Array.isArray(startDoc)) {
        if (debug) {
            console.info('walking array children');
        }
        // one a child returns false, abort walking this array
        startDoc.every((innerDoc, index) => {
            return walkDoc(innerDoc, debug, callback, [
                { parent: startDoc, childIndexInThisParent: index },
                ...parents,
            ], index);
        });
    }
    else if ('contents' in startDoc) {
        if (debug) {
            console.info('walking contents property');
        }
        return walkDoc(startDoc.contents, debug, callback, [
            { parent: startDoc, childIndexInThisParent: undefined },
            ...parents,
        ], undefined);
    }
    else if ('parts' in startDoc) {
        if (debug) {
            console.info('walking parts property');
        }
        return walkDoc(startDoc.parts, debug, callback, [
            { parent: startDoc, childIndexInThisParent: undefined },
            ...parents,
        ], undefined);
    }
    return true;
}