stylus-source 0.15.4

data/lib/stylus/middleware.js

@@ -0,0 +1,223 @@
+/*!
+ * Stylus - middleware
+ * Copyright(c) 2010 LearnBoost <dev@learnboost.com>
+ * MIT Licensed
+ */
+
+/**
+ * Module dependencies.
+ */
+
+var stylus = require('./stylus')
+  , fs = require('fs')
+  , url = require('url')
+  , basename = require('path').basename
+  , join = require('path').join;
+
+/**
+ * Import map.
+ */
+
+var imports = {};
+
+/**
+ * Return Connect middleware with the given `options`.
+ *
+ * Options:
+ *
+ *    `force`     Always re-compile
+ *    `debug`     Output debugging information
+ *    `src`       Source directory used to find .styl files
+ *    `dest`      Destination directory used to output .css files
+ *                when undefined defaults to `src`.
+ *    `compile`   Custom compile function, accepting the arguments
+ *                `(str, path)`.
+ *    `compress`  Whether the output .css files should be compressed
+ *    `firebug`   Emits debug infos in the generated css that can
+ *                be used by the FireStylus Firebug plugin
+ *    `linenos`   Emits comments in the generated css indicating 
+ *                the corresponding stylus line
+ *
+ * Examples:
+ * 
+ * Here we set up the custom compile function so that we may
+ * set the `compress` option, or define additional functions.
+ * 
+ * By default the compile function simply sets the `filename`
+ * and renders the CSS.
+ * 
+ *      function compile(str, path) {
+ *        return stylus(str)
+ *          .set('filename', path)
+ *          .set('compress', true);
+ *      }
+ * 
+ * Pass the middleware to Connect, grabbing .styl files from this directory
+ * and saving .css files to _./public_. Also supplying our custom `compile` function.
+ * 
+ * Following that we have a `staticProvider` layer setup to serve the .css
+ * files generated by Stylus.
+ * 
+ *      var server = connect.createServer(
+ *          stylus.middleware({
+ *              src: __dirname
+ *            , dest: __dirname + '/public'
+ *            , compile: compile
+ *          })
+ *        , connect.static(__dirname + '/public')
+ *      );
+ * 
+ * @param {Object} options
+ * @return {Function}
+ * @api public
+ */
+
+module.exports = function(options){
+  options = options || {};
+
+  // Accept src/dest dir
+  if ('string' == typeof options) {
+    options = { src: options };
+  }
+
+  // Force compilation
+  var force = options.force;
+
+  // Debug option
+  var debug = options.debug;
+
+  // Source dir required
+  var src = options.src;
+  if (!src) throw new Error('stylus.middleware() requires "src" directory');
+
+  // Default dest dir to source
+  var dest = options.dest
+    ? options.dest
+    : src;
+
+  // Default compile callback
+  options.compile = options.compile || function(str, path){
+    return stylus(str)
+      .set('filename', path)
+      .set('compress', options.compress)
+      .set('firebug', options.firebug)
+      .set('linenos', options.linenos);
+  };
+
+  // Middleware
+  return function(req, res, next){
+    if ('GET' != req.method && 'HEAD' != req.method) return next();
+    var path = url.parse(req.url).pathname;
+    if (/\.css$/.test(path)) {
+      var cssPath = join(dest, path)
+        , stylusPath = join(src, path.replace('.css', '.styl'));
+
+      if (debug) {
+        log('source', stylusPath);
+        log('dest', cssPath);
+      }
+
+      // Ignore ENOENT to fall through as 404
+      function error(err) {
+        next('ENOENT' == err.code
+          ? null
+          : err);
+      }
+
+      // Force
+      if (force) return compile();
+
+      // Compile to cssPath
+      function compile() {
+        if (debug) log('read', stylusPath);
+        fs.readFile(stylusPath, 'utf8', function(err, str){
+          if (err) return error(err);
+          var style = options.compile(str, stylusPath);
+          var paths = style.options._imports = [];
+          delete imports[stylusPath];
+          style.render(function(err, css){
+            if (err) return next(err);
+            if (debug) log('render', stylusPath);
+            imports[stylusPath] = paths;
+            fs.writeFile(cssPath, css, 'utf8', next);
+          });
+        });
+      }
+
+      // Re-compile on server restart, disregarding
+      // mtimes since we need to map imports
+      if (!imports[stylusPath]) return compile();
+
+      // Compare mtimes
+      fs.stat(stylusPath, function(err, stylusStats){
+        if (err) return error(err);
+        fs.stat(cssPath, function(err, cssStats){
+          // CSS has not been compiled, compile it!
+          if (err) {
+            if ('ENOENT' == err.code) {
+              if (debug) log('not found', cssPath);
+              compile();
+            } else {
+              next(err);
+            }
+          } else {
+            // Source has changed, compile it
+            if (stylusStats.mtime > cssStats.mtime) {
+              if (debug) log('modified', cssPath);
+              compile();
+            // Already compiled, check imports
+            } else {
+              checkImports(stylusPath, function(changed){
+                if (debug && changed.length) {
+                  changed.forEach(function(path) {
+                    log('modified import %s', path);
+                  });
+                }
+                changed.length ? compile() : next();
+              });
+            }
+          }
+        });
+      });
+    } else {
+      next();
+    }
+  }
+};
+
+/**
+ * Check `path`'s imports to see if they have been altered.
+ *
+ * @param {String} path
+ * @param {Function} fn
+ * @api private
+ */
+
+function checkImports(path, fn) {
+  var nodes = imports[path];
+  if (!nodes) return fn();
+  if (!nodes.length) return fn();
+
+  var pending = nodes.length
+    , changed = [];
+
+  nodes.forEach(function(imported){
+    fs.stat(imported.path, function(err, stat){
+      // error or newer mtime
+      if (err || !imported.mtime || stat.mtime > imported.mtime) {
+        changed.push(imported.path);
+      }
+      --pending || fn(changed);
+    });
+  });
+}
+
+/**
+ * Log a message.
+ *
+ * @api private
+ */
+
+function log(key, val) {
+  console.error('  \033[90m%s :\033[0m \033[36m%s\033[0m', key, val);
+}

data/lib/stylus/nodes/arguments.js

@@ -0,0 +1,65 @@
+
+/*!
+ * Stylus - Arguments
+ * Copyright(c) 2010 LearnBoost <dev@learnboost.com>
+ * MIT Licensed
+ */
+
+/**
+ * Module dependencies.
+ */
+
+var Node = require('./node')
+  , nodes = require('../nodes')
+  , utils = require('../utils');
+
+/**
+ * Initialize a new `Arguments`.
+ *
+ * @api public
+ */
+
+var Arguments = module.exports = function Arguments(){
+  nodes.Expression.call(this);
+  this.map = {};
+};
+
+/**
+ * Inherit from `nodes.Expression.prototype`.
+ */
+
+Arguments.prototype.__proto__ = nodes.Expression.prototype;
+
+/**
+ * Initialize an `Arguments` object with the nodes
+ * from the given `expr`.
+ *
+ * @param {Expression} expr
+ * @return {Arguments}
+ * @api public
+ */
+
+Arguments.fromExpression = function(expr){
+  var args = new Arguments
+    , len = expr.nodes.length;
+  args.lineno = expr.lineno;
+  args.isList = expr.isList;
+  for (var i = 0; i < len; ++i) {
+    args.push(expr.nodes[i]);
+  }
+  return args;
+};
+
+/**
+ * Return a clone of this node.
+ *
+ * @return {Node}
+ * @api public
+ */
+
+Arguments.prototype.clone = function(){
+  var clone = nodes.Expression.prototype.clone.call(this);
+  clone.map = this.map;
+  return clone;
+};
+

data/lib/stylus/nodes/binop.js

@@ -0,0 +1,54 @@
+
+/*!
+ * Stylus - BinOp
+ * Copyright(c) 2010 LearnBoost <dev@learnboost.com>
+ * MIT Licensed
+ */
+
+/**
+ * Module dependencies.
+ */
+
+var Node = require('./node');
+
+/**
+ * Initialize a new `BinOp` with `op`, `left` and `right`.
+ *
+ * @param {String} op
+ * @param {Node} left
+ * @param {Node} right
+ * @api public
+ */
+
+var BinOp = module.exports = function BinOp(op, left, right){
+  Node.call(this);
+  this.op = op;
+  this.left = left;
+  this.right = right;
+};
+
+/**
+ * Inherit from `Node.prototype`.
+ */
+
+BinOp.prototype.__proto__ = Node.prototype;
+
+/**
+ * Return a clone of this node.
+ * 
+ * @return {Node}
+ * @api public
+ */
+
+BinOp.prototype.clone = function(){
+  var clone = new BinOp(
+      this.op
+    , this.left.clone()
+    , this.right ?
+      this.right.clone()
+      : null);
+  clone.lineno = this.lineno;
+  clone.filename = this.filename;
+  if (this.val) clone.val = this.val.clone();
+  return clone;
+};

data/lib/stylus/nodes/block.js

@@ -0,0 +1,99 @@
+
+/*!
+ * Stylus - Block
+ * Copyright(c) 2010 LearnBoost <dev@learnboost.com>
+ * MIT Licensed
+ */
+
+/**
+ * Module dependencies.
+ */
+
+var Node = require('./node');
+
+/**
+ * Initialize a new `Block` node with `parent` Block.
+ *
+ * @param {Block} parent
+ * @api public
+ */
+
+var Block = module.exports = function Block(parent, node){
+  Node.call(this);
+  this.nodes = [];
+  this.parent = parent;
+  this.node = node;
+  this.scope = true;
+};
+
+/**
+ * Inherit from `Node.prototype`.
+ */
+
+Block.prototype.__proto__ = Node.prototype;
+
+/**
+ * Check if this block has properties..
+ *
+ * @return {Boolean}
+ * @api public
+ */
+
+Block.prototype.__defineGetter__('hasProperties', function(){
+  for (var i = 0, len = this.nodes.length; i < len; ++i) {
+    if ('property' == this.nodes[i].nodeName) {
+      return true;
+    }
+  }
+});
+
+/**
+ * Check if this block is empty.
+ *
+ * @return {Boolean}
+ * @api public
+ */
+
+Block.prototype.__defineGetter__('isEmpty', function(){
+  return !this.nodes.length;
+});
+
+/**
+ * Return a clone of this node.
+ * 
+ * @return {Node}
+ * @api public
+ */
+
+Block.prototype.clone = function(){
+  var clone = new Block(this.parent, this.node);
+  clone.lineno = this.lineno;
+  clone.filename = this.filename;
+  clone.scope = this.scope;
+  this.nodes.forEach(function(node){
+    node = node.clone();
+    switch (node.nodeName) {
+      case 'each':
+      case 'group':
+        node.block.parent = clone;
+        break;
+      case 'ident':
+        if ('function' == node.val.nodeName) {
+          node.val.block.parent = clone;
+        }
+    }
+    clone.push(node);
+  });
+  return clone;
+};
+
+/**
+ * Push a `node` to this block.
+ *
+ * @param {Node} node
+ * @api public
+ */
+
+Block.prototype.push = function(node){
+  this.nodes.push(node);
+};

data/lib/stylus/nodes/boolean.js

@@ -0,0 +1,103 @@
+
+/*!
+ * Stylus - Boolean
+ * Copyright(c) 2010 LearnBoost <dev@learnboost.com>
+ * MIT Licensed
+ */
+
+/**
+ * Module dependencies.
+ */
+
+var Node = require('./node')
+  , nodes = require('./');
+
+/**
+ * Initialize a new `Boolean` node with the given `val`.
+ *
+ * @param {Boolean} val
+ * @api public
+ */
+
+var Boolean = module.exports = function Boolean(val){
+  Node.call(this);
+  if (this.nodeName) {
+    this.val = !!val;
+  } else {
+    return new Boolean(val);
+  }
+};
+
+/**
+ * Inherit from `Node.prototype`.
+ */
+
+Boolean.prototype.__proto__ = Node.prototype;
+
+/**
+ * Return `this` node.
+ *
+ * @return {Boolean}
+ * @api public
+ */
+
+Boolean.prototype.toBoolean = function(){
+  return this;
+};
+
+/**
+ * Return `true` if this node represents `true`.
+ *
+ * @return {Boolean}
+ * @api public
+ */
+
+Boolean.prototype.__defineGetter__('isTrue', function(){
+  return this.val;
+});
+
+/**
+ * Return `true` if this node represents `false`.
+ *
+ * @return {Boolean}
+ * @api public
+ */
+
+Boolean.prototype.__defineGetter__('isFalse', function(){
+  return ! this.val;
+});
+
+/**
+ * Negate the value.
+ *
+ * @return {Boolean}
+ * @api public
+ */
+
+Boolean.prototype.negate = function(){
+  return Boolean(!this.val);
+};
+
+/**
+ * Return 'Boolean'.
+ *
+ * @return {String}
+ * @api public
+ */
+
+Boolean.prototype.inspect = function(){
+  return '[Boolean ' + this.val + ']';
+};
+
+/**
+ * Return 'true' or 'false'.
+ *
+ * @return {String}
+ * @api public
+ */
+
+Boolean.prototype.toString = function(){
+  return this.val
+    ? 'true'
+    : 'false';
+};