jsdoc-75lb/node_modules-3.4.0/detect-indent/index.js

An API documentation generator for JavaScript.

'use strict';

// detect either spaces or tabs but not both to properly handle tabs
// for indentation and spaces for alignment
var INDENT_RE = /^(?:( )+|\t+)/;

var repeating = require('repeating');

module.exports = function (str) {
	if (typeof str !== 'string') {
		throw new TypeError('Expected a string');
	}

	// used to if tabs or spaces are the most used
	var t = 0;
	var s = 0;

	// remember the indentation used for the previous line
	var prev = 0;

	// remember how much a given indentation size was used
	var indents = {};

	str.split(/\n/g).forEach(function (line) {
		if (!line) {
			// ignore empty lines
			return;
		}

		var matches = line.match(INDENT_RE);

		var indent;
		if (!matches) {
			indent = 0;
		} else {
			indent = matches[0].length;

			if (matches[1]) {
				// spaces were used
				s++;
			} else {
				// tabs were used
				t++;
			}
		}

		var diff = Math.abs(indent - prev);
		prev = indent;

		if (diff) {
			// an indent or deindent has been detected
			indents[diff] = (indents[diff] || 0) + 1;
		}
	});

	// find most frequent indentation
	var amount = 0;
	var max = 0;
	var n;
	for (var diff in indents) {
		n = indents[diff];
		if (n > max) {
			max = n;
			amount = +diff;
		}
	}

	var type;
	var actual;
	if (!amount) {
		type = null;
		actual = '';
	} else if (s >= t) {
		type = 'space';
		actual = repeating(' ', amount);
	} else {
		type = 'tab';
		actual = repeating('\t', amount);
	}

	return {
		amount: amount,
		type: type,
		indent: actual
	};
};