Cинтаксическое дерево

			
				html, body.home {
					margin: 10px 20px;
				}
			
		

			
				type: 'root',
				nodes: [
					{
						type: 'rule',
						selectors: 'html, body.home',
						nodes: [{
							type: 'decl',
							prop: 'margin',
							value: '10px 20px'
						}]
					}
				]
			
		

postcss plugin boilerplate

			
				var postcss = require('postcss');

				module.exports = postcss.plugin('PLUGIN_NAME', function (opts) {
					opts = opts || {};
					// Work with options here
					return function (css, result) {
						// Transform CSS AST here
					};
				});
			
		

node

• next, prev, remove, replaceWith, moveTo
• clone, cloneBefore, cloneAfter

container (node with children)

• prepend, append, removeChild, insertBefore, insertAfter
• every, some, each

container

• walk
• walkRules, walkAtRules, waltDecls, walkComments

result

• result.warn(text, opts) - кинуть warning
• result.opts = { from, to } (если были предоставлены)


• result.messages - массив сообщений
• result.processor.plugins - список всех плагинов
• result.root - изначальный root

Второй по бесполезности плагин в мире

			
				css.walkDecls(function(decl) {
					if (decl.prop === 'width') {
						var comment = postcss.comment({text: 'Upside down!'});
						decl.prop = 'height';
						decl.parent.insertBefore(decl, comment);
					}
				});