custom-elements.js

'use strict';
/* eslint-env commonjs, es6 */

exports.defineTags = function (dictionary) {
	dictionary.defineTag('customelement', {
		mustHaveValue: true,
		mustNotHaveDescription: false,
		canHaveType: false,
		canHaveName: false,
		onTagged: function (doclet, tag) {
			if (!doclet.customelements) {
				doclet.customelements = [];
			}

			doclet.customelements.push({
				'name': tag.value
			});
		}
	});
};


exports.handlers = {
	newDoclet: function (e) {
		const parameters = e.doclet.customelements;
		if (parameters) {
			e.doclet.kind = 'external';
			e.doclet.name = e.doclet.longname = e.doclet.customelements.map(a => `${a.name}`).join(', ');
			e.doclet.description = `${e.doclet.description}<pre><code>${e.doclet.customelements.map(a => `&lt;${a.name} ${(e.doclet.properties || []).map(b => `${b.name}="[${b.type.names.join(', ')}]"`).join(' ')}&gt;`).join('\n')}</code></pre>`;
			delete e.doclet.meta.code;
			if (!e.doclet.examples) {
				console.log('\x1b[33m%s\x1b[0m', 'NO EXAMPLES FOR:' + e.doclet.name);
			}
		}
	}

}