stylelint-sassdoc/src/utils/checkCommentsForExample.js

stylelint plugin to check scss files for a valid sassdoc documentation Credits to https://github.com/anneangersbach

const adjacentLineIsSCSSComment = require('./adjacentLineIsSCSSComment');
const regExCheck = require('./regExCheck');

/**
 * Checks the preceding comment nodes for @example
 * @param {Node} node - the current node
*/
let results = [];
module.exports = function checkCommentsForExample(node, tail = 0) {
    const previousNode = node.prev();
    if (tail === 0) {
        results = [];
    }
    if (adjacentLineIsSCSSComment(node)) {
        // check for @example
        if (regExCheck(previousNode, /@example/)) {
            const returnComment = {};
            returnComment.returnOnLine = previousNode.source.start.line;
            returnComment.node = previousNode;
            results.push(returnComment);
        }
        // continue with any comments preceding this one
        return checkCommentsForExample(previousNode, tail + 1);
    }

    return results;
};