1.0.0

Author: dutchenkoOleg

.gitignore

@@ -1,19 +1,6 @@
-# Build and Release Folders
-bin/
-bin-debug/
-bin-release/
-[Oo]bj/ # FlashDevelop obj
-[Bb]in/ # FlashDevelop bin
-
-# Other files and folders
-.settings/
-
-# Executables
-*.swf
-*.air
-*.ipa
-*.apk
-
-# Project files, i.e. `.project`, `.actionScriptProperties` and `.flexProperties`
-# should NOT be excluded as they contain compiler settings and other important
-# information for Eclipse / Flash Builder.
+.idea
+tmp
+node_modules
+npm-debug.log
+.DS_Store
+thumbs.db

README.md

@@ -1,2 +1,50 @@
 # sort-css-media-queries
-The custom `sort` method for the plugin `css-mqpacker` and possibly something else
+
+![npm](https://img.shields.io/badge/node-6.10.2-yellow.svg)
+![es2015](https://img.shields.io/badge/ECMAScript-2015_(ES6)-blue.svg)
+
+The custom `sort` method for [`css-mqpacker`](https://www.npmjs.com/package/css-mqpacker) or [`pleeease`](https://www.npmjs.com/package/pleeease) (which uses css-mqpacker) or, perhaps, something else ))
+
+## Installing
+
+```shell
+npm install --save sort-css-media-queries
+# or using yarn cli
+yarn add sort-css-media-queries
+```
+
+## Usage
+
+See the original docs at first https://www.npmjs.com/package/css-mqpacker#sort;
+
+```js
+
+const sortCSSmq = require('sort-css-media-queries');
+
+// your cool code
+// ...
+
+postcss([
+  mqpacker({
+    sort: sortCSSmq
+  })
+]).process(css);
+
+```
+
+### Warn
+
+it's use es6 syntax
+
+- ECMAScript 2015 (ES6) and beyond - https://nodejs.org/en/docs/es6/
+- Node.js ES2015 Support - http://node.green/ 
+
+
+## Tests
+
+Sorry but here no tests yet.
+
+
+## Contributing
+
+you know what to do - [issues](https://github.com/dutchenkoOleg/sort-css-media-queries/issues) and [pulls](https://github.com/dutchenkoOleg/sort-css-media-queries/pulls)

index.js

@@ -0,0 +1,133 @@
+'use strict';
+
+/**
+ * The custom `sort` method for
+ * for the [`css-mqpacker`](https://www.npmjs.com/package/css-mqpacker) or
+ * [`pleeease`](https://www.npmjs.com/package/pleeease) which using `css-mqpacker`
+ * or, perhaps, something else ))
+ *
+ * @module sort-css-media-queries
+ * @author Oleg Dutchenko <[email protected]>
+ * @version 1.0.0
+ * @sourcecode |+16
+ */
+
+const minMaxWidth = /(!?\(\s*min(-device-)?-width).+\(\s*max(-device)?-width/;
+const minWidth = /\(\s*min(-device)?-width/;
+const maxMinWidth = /(!?\(\s*max(-device)?-width).+\(\s*min(-device)?-width/;
+const maxWidth = /\(\s*max(-device)?-width/;
+
+const isMinWidth = testQuery(minMaxWidth, maxMinWidth, minWidth);
+const isMaxWidth = testQuery(maxMinWidth, minMaxWidth, maxWidth);
+
+const minMaxHeight = /(!?\(\s*min(-device)?-height).+\(\s*max(-device)?-height/;
+const minHeight = /\(\s*min(-device)?-height/;
+const maxMinHeight = /(!?\(\s*max(-device)?-height).+\(\s*min(-device)?-height/;
+const maxHeight = /\(\s*max(-device)?-height/;
+
+const isMinHeight = testQuery(minMaxHeight, maxMinHeight, minHeight);
+const isMaxHeight = testQuery(maxMinHeight, minMaxHeight, maxHeight);
+
+/**
+ * Sorting an array with media queries
+ * @param {string} a
+ * @param {string} b
+ * @return {number} 1 / 0 / -1
+ * @sourcecode
+ */
+export default function (a, b) {
+	let minA = isMinWidth(a) || isMinHeight(a);
+	let maxA = isMaxWidth(a) || isMaxHeight(a);
+	
+	let minB = isMinWidth(b) || isMinHeight(b);
+	let maxB = isMaxWidth(b) || isMaxHeight(b);
+	
+	if (minA && maxB) {
+		return -1;
+	}
+	if (maxA && minB) {
+		return 1;
+	}
+	
+	let lengthA = getQueryLength(a);
+	let lengthB = getQueryLength(b);
+	
+	if (lengthA > lengthB) {
+		if (maxA) {
+			return -1;
+		}
+		return 1;
+	}
+	if (lengthA < lengthB) {
+		if (maxA) {
+			return 1;
+		}
+		return -1;
+	}
+	return a.localeCompare(b);
+}
+
+/**
+ * Wrapper for creating test functions
+ * @private
+ * @param {RegExp} doubleTestTrue
+ * @param {RegExp} doubleTestFalse
+ * @param {RegExp} singleTest
+ * @return {Function}
+ * @sourcecode
+ */
+function testQuery (doubleTestTrue, doubleTestFalse, singleTest) {
+	/**
+	 * @param {string} query
+	 * @return {boolean}
+	 */
+	return function(query) {
+		if ( doubleTestTrue.test(query) ) {
+			return true;
+		} else if ( doubleTestFalse.test(query) ) {
+			return false;
+		}
+		return singleTest.test(query);
+	}
+}
+
+/**
+ * Obtain the length of the media request in pixels.
+ * Copy from original source `function inspectLength (length)`
+ * {@link https://github.com/hail2u/node-css-mqpacker/blob/master/index.js#L58}
+ * @private
+ * @param {string} length
+ * @return {number}
+ * @sourcecode
+ */
+function getQueryLength (length) {
+	length = /(-?\d*\.?\d+)(ch|em|ex|px|rem)/.exec(length);
+
+	if (!length) {
+		return Number.MAX_VALUE;
+	}
+
+	let num = length[1];
+	let unit = length[2];
+
+	switch (unit) {
+		case "ch":
+			num = parseFloat(num) * 8.8984375;
+			break;
+
+		case "em":
+		case "rem":
+			num = parseFloat(num) * 16;
+			break;
+
+		case "ex":
+			num = parseFloat(num) * 8.296875;
+			break;
+
+		case "px":
+			num = parseFloat(num);
+			break;
+	}
+
+	return num;
+}

package.json

@@ -0,0 +1,30 @@
+{
+  "name": "sort-css-media-queries",
+  "version": "1.0.0",
+  "description": "The custom `sort` method for `css-mqpacker` or `pleeease` (which uses css-mqpacker) or, perhaps, something else ))",
+  "main": "index.js",
+  "scripts": {
+    "test": "echo \"Error: no test specified\" && exit 1"
+  },
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/dutchenkoOleg/sort-css-media-queries.git"
+  },
+  "keywords": [
+    "css-mqpacker",
+    "node-css-mqpacker",
+    "pleeease",
+    "mq",
+    "media",
+    "queries"
+  ],
+  "author": "Oleg Dutchenko <[email protected]>",
+  "license": "MIT",
+  "bugs": {
+    "url": "https://github.com/dutchenkoOleg/sort-css-media-queries/issues"
+  },
+  "engines": {
+    "node": ">= 6.10.2"
+  },
+  "homepage": "https://github.com/dutchenkoOleg/sort-css-media-queries#readme"
+}