add function 'reverse'

Author: KROT47

CHANGELOG.md

@@ -1,4 +1,9 @@
 
+# 1.1.2
+
+2018-03-31
+ - Add function 'reverse'
+ 
 # 1.1.1
 
 2017-04-22

README.md

@@ -22,6 +22,7 @@ The plugin extends Less with the following functions:
 - [`flatten  `](docs/ref.md#flatten)   - returns a one-dimensional list containing all elements of an input list.
 - [`join     `](docs/ref.md#join)      - joins all elements of a list into a string.
 - [`l        `](docs/ref.md#l)         - creates a comma or space separated list.
+- [`reverse  `](docs/ref.md#reverse)   - returns list in reversed order.
 - [`slice    `](docs/ref.md#slice)     - returns selected portion of a list.
 - [`splice   `](docs/ref.md#splice)    - replaces or removes selected portion of a list and returns the modified copy.
 - [`transpose`](docs/ref.md#transpose) - transposes rows and columns of a list.

docs/ref.md

@@ -202,6 +202,38 @@ at(l(a, b, c), 2); // b
 
 ---------------------------------------------------------------
 
+### `reverse`
+
+   Returns list in reversed order.
+
+**Syntax**
+```
+reverse(list)
+```
+
+**Parameters** <dl></dl>
+`list` <dl><dd>
+    Required. The input list.
+    </dd></dl>
+
+**Returns**
+
+   List in reversed order: from last to first.
+
+**Example**
+```less
+@list: one, two, three, four;
+
+reverse(@list);     // four, three, two, one
+
+
+@list: black white, one two;
+
+reverse(@list);     // one two, black white
+```
+
+---------------------------------------------------------------
+
 ### `slice`
 
    Returns selected portion of a list.

lib/main.js

@@ -154,6 +154,16 @@ module.exports = function(less) {
 
         // ....................................................
 
+        reverse: function(list) {
+            if (isArray(list.value)) {
+                list.value = list.value.reverse();
+            }
+
+            return list;
+        },
+
+        // ....................................................
+
         _inspect: function(list, prefix, postfix) {
             prefix  = prefix  ? prefix.value  : "[";
             postfix = postfix ? postfix.value : "]";

package.json

@@ -1,6 +1,6 @@
 {
   "name": "less-plugin-lists",
-  "version": "1.1.1",
+  "version": "1.1.2",
   "description": "list/array manipulation for Less",
   "homepage": "https://github.com/seven-phases-max/less-plugin-lists",
   "author": "Max Mikhailov",

test/css/reverse.css

@@ -0,0 +1,5 @@
+reverse {
+  00: tomato potato, banana apple;
+  01: black, white;
+  02: black white;
+}

test/less/reverse.less

@@ -0,0 +1,10 @@
+
+@0: banana apple, tomato potato;
+@1: white, black;
+@2: white black;
+
+reverse {
+    00: reverse(@0);
+    01: reverse(@1);
+    02: reverse(@2);
+}