less 1.2.2 → 1.3.3

package/.npmignore

@@ -0,0 +1 @@
+dist/*

package/CHANGELOG.md

@@ -0,0 +1,118 @@
+# 1.3.3
+
+2012-12-30
+
+ - Fix critical bug with mixin call if using multiple brackets
+ - when using the filter contrast function, the function is passed through if the first argument is not a color
+
+# 1.3.2
+
+2012-12-28
+
+ - browser and server url re-writing is now aligned to not re-write (previous lessc behaviour)
+ - url-rewriting can be made to re-write to be relative to the entry file using the relative-urls option (less.relativeUrls option)
+ - rootpath option can be used to add a base path to every url
+ - Support mixin argument seperator of ';' so you can pass comma seperated values. e.g. `.mixin(23px, 12px;);`
+ - Fix lots of problems with named arguments in corner cases, not behaving as expected
+ - hsv, hsva, unit functions
+ - fixed lots more bad error messages
+ - fix `@import-once` to use the full path, not the relative one for determining if an import has been imported already
+ - support `:not(:nth-child(3))`
+ - mixin guards take units into account
+ - support unicode descriptors (`U+00A1-00A9`)
+ - support calling mixins with a stack when using `&` (broken in 1.3.1)
+ - support `@namespace` and namespace combinators
+ - when using % with colour functions, take into account a colour is out of 256
+ - when doing maths with a % do not divide by 100 and keep the unit
+ - allow url to contain % (e.g. %20 for a space)
+ - if a mixin guard stops execution a default mixin is not required
+ - units are output in strings (use the unit function if you need to get the value without unit)
+ - do not infinite recurse when mixins call mixins of the same name
+ - fix issue on important on mixin calls
+ - fix issue with multiple comments being confused
+ - tolerate multiple semi-colons on rules
+ - ignore subsequant `@charset`
+ - syncImport option for node.js to read files syncronously
+ - write the output directory if it is missing
+ - change dependency on cssmin to ycssmin
+ - lessc can load files over http
+ - allow calling less.watch() in non dev mode
+ - don't cache in dev mode
+ - less files cope with query parameters better
+ - sass debug statements are now chrome compatible
+ - modifyVars function added to re-render with different root variables
+
+# 1.3.1
+
+2012-10-18
+
+- Support for comment and @media debugging statements
+- bug fix for async access in chrome extensions
+- new functions tint, shade, multiply, screen, overlay, hardlight, difference, exclusion, average, negation, softlight, red, green, blue, contrast
+- allow escaped characters in attributes
+- in selectors support @{a} directly, e.g. .a.@{a} { color: black; }
+- add fraction parameter to round function
+- much better support for & selector
+- preserve order of link statements client side
+- lessc has better help
+- rhino version fixed
+- fix bugs in clientside error handling
+- support dpi, vmin, vm, dppx, dpcm units
+- Fix ratios in media statements
+- in mixin guards allow comparing colors and strings
+- support for -*-keyframes (for -khtml but now supports any)
+- in mix function, default weight to 50%
+- support @import-once
+- remove duplicate rules in output
+- implement named parameters when calling mixins
+- many numerous bug fixes
+
+# 1.3.0
+
+2012-03-10
+
+- @media bubbling
+- Support arbitrary entities as selectors
+- [Variadic argument support](https://gist.github.com/1933613)
+- Behaviour of zero-arity mixins has [changed](https://gist.github.com/1933613)
+- Allow `@import` directives in any selector
+- Media-query features can now be a variable
+- Automatic merging of media-query conditions
+- Fix global variable leaks
+- Fix error message on wrong-arity call
+- Fix an `@arguments` behaviour bug
+- Fix `::` selector output
+- Fix a bug when using @media with mixins
+
+
+# 1.2.1
+
+2012-01-15
+
+- Fix imports in browser
+- Improve error reporting in browser
+- Fix Runtime error reports from imported files
+- Fix `File not found` import error reporting
+
+
+# 1.2.0
+
+2012-01-07
+
+- Mixin guards
+- New function `percentage`
+- New `color` function to parse hex color strings
+- New type-checking stylesheet functions
+- Fix Rhino support
+- Fix bug in string arguments to mixin call
+- Fix error reporting when index is 0
+- Fix browser support in WebKit and IE
+- Fix string interpolation bug when var is empty
+- Support `!important` after mixin calls
+- Support vanilla @keyframes directive
+- Support variables in certain css selectors, like `nth-child`
+- Support @media and @import features properly
+- Improve @import support with media features
+- Improve error reports from imported files
+- Improve function call error reporting
+- Improve error-reporting

package/CONTRIBUTING.md

@@ -0,0 +1,50 @@
+## Bug Reports
+
+ - Please create a short test case
+ - Test with the latest version
+ - indicate how you use less - browser/lessc/external tool
+
+## Feature Requests
+
+ - Please search feature requests to see if something similar exists already
+ - include a use-case - we do not add language features without a reason
+ - consider whether your language feature would be better as a function
+
+## Pull Requests
+
+Thankyou! Please take the time to read these guidelines
+
+ - Consider adding a feature request first to see if people are pro or con
+ - do not change the dist/ folder - we do this when releasing
+ - tests - please add tests for your work. use `make test` to see if they pass
+ - spaces not tabs
+ - end lines in semi-colons - loosely aim towards jslint standards
+
+## Developing
+
+1. install cygwin - http://cygwin.com/install.html 
+ - default options +
+	- Devel -> Make
+                -> Git
+2. install node.js - http://nodejs.org/
+3. install phantomJS - http://phantomjs.org/download.html
+	- copy to a directory of your choice
+	- (windows) modify the path directory to include whereever you have copied it
+4. clone the repository and download to local computer
+5. run `npm install -g diff` to get diffs in your tests
+
+`lessc or node bin/lessc`
+
+to run the less compiler
+
+`make test`
+
+runs the node tests
+
+`make browser-test`
+
+runs the headless browser tests
+
+`make browser-test-server`
+
+sets up the server for the headless tests.. then go to http://localhost:8081/browser/test-runner-main.htm or one of the other test runner pages created in /test/browser/

package/Makefile

@@ -21,22 +21,33 @@ DIST = dist/less-${VERSION}.js
 RHINO = dist/less-rhino-${VERSION}.js
 DIST_MIN = dist/less-${VERSION}.min.js
 
+browser-prepare: DIST := test/browser/less.js
+
 less:
 	@@mkdir -p dist
 	@@touch ${DIST}
 	@@cat ${HEADER} | sed s/@VERSION/${VERSION}/ > ${DIST}
 	@@echo "(function (window, undefined) {" >> ${DIST}
 	@@cat build/require.js\
-	      build/amd.js\
 	      build/ecma-5.js\
 	      ${SRC}/parser.js\
 	      ${SRC}/functions.js\
 	      ${SRC}/colors.js\
 	      ${SRC}/tree/*.js\
 	      ${SRC}/tree.js\
-	      ${SRC}/browser.js >> ${DIST}
+	      ${SRC}/browser.js\
+	      build/amd.js >> ${DIST}
 	@@echo "})(window);" >> ${DIST}
 	@@echo ${DIST} built.
+	
+browser-prepare: less
+	node test/browser-test-prepare.js
+	
+browser-test: browser-prepare
+	phantomjs test/browser/phantom-runner.js
+
+browser-test-server: browser-prepare
+	phantomjs test/browser/phantom-runner.js --no-tests
 
 rhino:
 	@@mkdir -p dist
@@ -45,6 +56,7 @@ rhino:
 	      build/ecma-5.js\
 	      ${SRC}/parser.js\
 	      ${SRC}/functions.js\
+	      ${SRC}/colors.js\
 	      ${SRC}/tree/*.js\
 	      ${SRC}/tree.js\
 	      ${SRC}/rhino.js > ${RHINO}

package/benchmark/benchmark.less

@@ -11,27 +11,27 @@
 @colour_positive: #ff0000;
 @colour_negative: #ff0000;
 
-.box_shadow () {
+.box_shadow (...) {
 }
-.text_shadow () {
+.text_shadow (...) {
 }
-.border_radius () {
+.border_radius (...) {
 }
-.border_radius_top_left () {
+.border_radius_top_left (...) {
 }
-.border_radius_top_right () {
+.border_radius_top_right (...) {
 }
-.border_radius_bottom_right () {
+.border_radius_bottom_right (...) {
 }
-.border_radius_bottom_left () {
+.border_radius_bottom_left (...) {
 }
-.border_radius_top () {
+.border_radius_top (...) {
 }
-.border_radius_right () {
+.border_radius_right (...) {
 }
-.border_radius_bottom () {
+.border_radius_bottom (...) {
 }
-.border_radius_left () {
+.border_radius_left (...) {
 }
 div.browse {
   margin: 0 0 20px;

package/benchmark/less-benchmark.js

@@ -10,7 +10,7 @@ if (process.argv[2]) { file = path.join(process.cwd(), process.argv[2]) }
 fs.readFile(file, 'utf8', function (e, data) {
     var tree, css, start, end, total;
 
-    sys.puts("Bechmarking...\n", path.basename(file) + " (" +
+    sys.puts("Benchmarking...\n", path.basename(file) + " (" +
              parseInt(data.length / 1024) + " KB)", "");
 
     start = new(Date);

package/bin/lessc

@@ -13,8 +13,17 @@ var options = {
     optimization: 1,
     silent: false,
     paths: [],
-    color: true
+    color: true,
+    strictImports: false,
+    rootpath: '',
+    relativeUrls: false
 };
+var continueProcessing = true,
+    currentErrorcode;
+
+// calling process.exit does not flush stdout always
+// so use this to set the exit code
+process.on('exit', function() { process.reallyExit(currentErrorcode) });
 
 args = args.filter(function (arg) {
     var match;
@@ -31,7 +40,7 @@ args = args.filter(function (arg) {
         case 'v':
         case 'version':
             sys.puts("lessc " + less.version.join('.') + " (LESS Compiler) [JavaScript]");
-            process.exit(0);
+            continueProcessing = false;
         case 'verbose':
             options.verbose = true;
             break;
@@ -39,10 +48,13 @@ args = args.filter(function (arg) {
         case 'silent':
             options.silent = true;
             break;
+        case 'strict-imports':
+            options.strictImports = true;
+            break;
         case 'h':
         case 'help':
-            sys.puts("usage: lessc source [destination]");
-            process.exit(0);
+            require('../lib/less/lessc_helper').printUsage();
+            continueProcessing = false;
         case 'x':
         case 'compress':
             options.compress = true;
@@ -54,19 +66,44 @@ args = args.filter(function (arg) {
             options.color = false;
             break;
         case 'include-path':
-            options.paths = match[2].split(os.type().match(/Windows/) ? ';' : ':')
-                .map(function(p) {
-                    if (p) {
-                      return path.resolve(process.cwd(), p);
-                    }
-                });
+            if (!match[2]) {
+                sys.puts("include-path option requires a parameter");
+                continueProcessing = false;
+            } else {
+                options.paths = match[2].split(os.type().match(/Windows/) ? ';' : ':')
+                    .map(function(p) {
+                        if (p) {
+                            return path.resolve(process.cwd(), p);
+                        }
+                    });
+            }
             break;
         case 'O0': options.optimization = 0; break;
         case 'O1': options.optimization = 1; break;
         case 'O2': options.optimization = 2; break;
+        case 'line-numbers':
+            options.dumpLineNumbers = match[2];
+            break;
+        case 'rp':
+        case 'rootpath':
+            if (!match[2]) {
+                sys.puts("rootpath option requires a parameter");
+                continueProcessing = false;
+            } else {
+                options.rootpath = path.normalize(match[2] + '/').replace('\\', '/');
+            }
+            break;
+        case "ru":
+        case "relative-urls":
+            options.relativeUrls = true;
+            break;
     }
 });
 
+if (!continueProcessing) {
+    return;
+}
+
 var input = args[1];
 if (input && input != '-') {
     input = path.resolve(process.cwd(), input);
@@ -76,49 +113,68 @@ if (output) {
     output = path.resolve(process.cwd(), output);
 }
 
-var css, fd, tree;
-
 if (! input) {
     sys.puts("lessc: no input files");
-    process.exit(1);
+    sys.puts("");
+    require('../lib/less/lessc_helper').printUsage();
+    currentErrorcode = 1;
+    return;
 }
 
+var ensureDirectory = function (filepath) {
+    var dir = path.dirname(filepath),
+        existsSync = fs.existsSync || path.existsSync;
+    if (!existsSync(dir)) {
+        fs.mkdirSync(dir);
+    }
+};
+
 var parseLessFile = function (e, data) {
     if (e) {
         sys.puts("lessc: " + e.message);
-        process.exit(1);
+        currentErrorcode = 1;
+        return;
     }
 
     new(less.Parser)({
         paths: [path.dirname(input)].concat(options.paths),
         optimization: options.optimization,
-        filename: input
+        filename: input,
+        rootpath: options.rootpath,
+        relativeUrls: options.relativeUrls,
+        strictImports: options.strictImports,
+        dumpLineNumbers: options.dumpLineNumbers
     }).parse(data, function (err, tree) {
         if (err) {
             less.writeError(err, options);
-            process.exit(1);
+            currentErrorcode = 1;
+            return;
         } else {
             try {
-                css = tree.toCSS({
+                var css = tree.toCSS({
                     compress: options.compress,
                     yuicompress: options.yuicompress
                 });
                 if (output) {
-                    fd = fs.openSync(output, "w");
-                    fs.writeSync(fd, css, 0, "utf8");
+                    ensureDirectory(output);
+                    fs.writeFileSync(output, css, 'utf8');
+                    if (options.verbose) {
+                        console.log('lessc: wrote ' + output);
+                    }
                 } else {
                     sys.print(css);
                 }
             } catch (e) {
                 less.writeError(e, options);
-                process.exit(2);
+                currentErrorcode = 2;
+                return;
             }
         }
     });
 };
 
 if (input != '-') {
-    fs.readFile(input, 'utf-8', parseLessFile);
+    fs.readFile(input, 'utf8', parseLessFile);
 } else {
     process.stdin.resume();
     process.stdin.setEncoding('utf8');

package/build/amd.js

@@ -0,0 +1,6 @@
+// amd.js
+//
+// Define Less as an AMD module.
+if (typeof define === "function" && define.amd) {
+    define("less", [], function () { return less; } );
+}

package/build/ecma-5.js

@@ -0,0 +1,120 @@
+
+// ecma-5.js
+//
+// -- kriskowal Kris Kowal Copyright (C) 2009-2010 MIT License
+// -- tlrobinson Tom Robinson
+// dantman Daniel Friesen
+
+//
+// Array
+//
+if (!Array.isArray) {
+    Array.isArray = function(obj) {
+        return Object.prototype.toString.call(obj) === "[object Array]" ||
+               (obj instanceof Array);
+    };
+}
+if (!Array.prototype.forEach) {
+    Array.prototype.forEach =  function(block, thisObject) {
+        var len = this.length >>> 0;
+        for (var i = 0; i < len; i++) {
+            if (i in this) {
+                block.call(thisObject, this[i], i, this);
+            }
+        }
+    };
+}
+if (!Array.prototype.map) {
+    Array.prototype.map = function(fun /*, thisp*/) {
+        var len = this.length >>> 0;
+        var res = new Array(len);
+        var thisp = arguments[1];
+
+        for (var i = 0; i < len; i++) {
+            if (i in this) {
+                res[i] = fun.call(thisp, this[i], i, this);
+            }
+        }
+        return res;
+    };
+}
+if (!Array.prototype.filter) {
+    Array.prototype.filter = function (block /*, thisp */) {
+        var values = [];
+        var thisp = arguments[1];
+        for (var i = 0; i < this.length; i++) {
+            if (block.call(thisp, this[i])) {
+                values.push(this[i]);
+            }
+        }
+        return values;
+    };
+}
+if (!Array.prototype.reduce) {
+    Array.prototype.reduce = function(fun /*, initial*/) {
+        var len = this.length >>> 0;
+        var i = 0;
+
+        // no value to return if no initial value and an empty array
+        if (len === 0 && arguments.length === 1) throw new TypeError();
+
+        if (arguments.length >= 2) {
+            var rv = arguments[1];
+        } else {
+            do {
+                if (i in this) {
+                    rv = this[i++];
+                    break;
+                }
+                // if array contains no values, no initial value to return
+                if (++i >= len) throw new TypeError();
+            } while (true);
+        }
+        for (; i < len; i++) {
+            if (i in this) {
+                rv = fun.call(null, rv, this[i], i, this);
+            }
+        }
+        return rv;
+    };
+}
+if (!Array.prototype.indexOf) {
+    Array.prototype.indexOf = function (value /*, fromIndex */ ) {
+        var length = this.length;
+        var i = arguments[1] || 0;
+
+        if (!length)     return -1;
+        if (i >= length) return -1;
+        if (i < 0)       i += length;
+
+        for (; i < length; i++) {
+            if (!Object.prototype.hasOwnProperty.call(this, i)) { continue }
+            if (value === this[i]) return i;
+        }
+        return -1;
+    };
+}
+
+//
+// Object
+//
+if (!Object.keys) {
+    Object.keys = function (object) {
+        var keys = [];
+        for (var name in object) {
+            if (Object.prototype.hasOwnProperty.call(object, name)) {
+                keys.push(name);
+            }
+        }
+        return keys;
+    };
+}
+
+//
+// String
+//
+if (!String.prototype.trim) {
+    String.prototype.trim = function () {
+        return String(this).replace(/^\s\s*/, '').replace(/\s\s*$/, '');
+    };
+}

package/build/header.js

@@ -0,0 +1,7 @@
+//
+// LESS - Leaner CSS v@VERSION
+// http://lesscss.org
+// 
+// Copyright (c) 2009-2011, Alexis Sellier
+// Licensed under the Apache 2.0 License.
+//

package/build/require-rhino.js

@@ -0,0 +1,7 @@
+//
+// Stub out `require` in rhino
+//
+function require(arg) {
+    return less[arg.split('/')[1]];
+};
+

package/build/require.js

@@ -0,0 +1,7 @@
+//
+// Stub out `require` in the browser
+//
+function require(arg) {
+    return window.less[arg.split('/')[1]];
+};
+