frontsau 0.0.1

data/lib/Phamlp/sass/tree/SassContext.php

@@ -0,0 +1,120 @@
+<?php
+/* SVN FILE: $Id: SassContext.php 118 2010-09-21 09:45:11Z chris.l.yates@gmail.com $ */
+/**
+ * SassContext class file.
+ * @author			Chris Yates <chris.l.yates@gmail.com>
+ * @copyright 	Copyright (c) 2010 PBM Web Development
+ * @license			http://phamlp.googlecode.com/files/license.txt
+ * @package			PHamlP
+ * @subpackage	Sass.tree
+ */
+
+/**
+ * SassContext class.
+ * Defines the context that the parser is operating in and so allows variables
+ * to be scoped.
+ * A new context is created for Mixins and imported files.
+ * @package			PHamlP
+ * @subpackage	Sass.tree
+ */
+class SassContext {
+	/**
+	 * @var SassContext enclosing context
+	 */
+	protected $parent;
+	/**
+	 * @var array mixins defined in this context
+	 */
+	protected $mixins = array();
+	/**
+	 * @var array variables defined in this context
+	 */
+	protected $variables = array();
+	/**
+	 * @var SassNode the node being processed
+	 */
+	public $node; 
+
+	/**
+	 * SassContext constructor.
+	 * @param SassContext - the enclosing context
+	 * @return SassContext
+	 */
+	public function __construct($parent = null) {
+		$this->parent = $parent;
+	}
+
+	/**
+	 * Adds a mixin
+	 * @param string name of mixin
+	 * @return SassMixinDefinitionNode the mixin
+	 */
+	public function addMixin($name, $mixin) {
+		$this->mixins[$name] = $mixin;
+		return $this;
+	}
+
+	/**
+	 * Returns a mixin
+	 * @param string name of mixin to return
+	 * @return SassMixinDefinitionNode the mixin
+	 * @throws SassContextException if mixin not defined in this context
+	 */
+	public function getMixin($name) {
+		if (isset($this->mixins[$name])) {
+			return $this->mixins[$name];
+		}
+		elseif (!empty($this->parent)) {
+			return $this->parent->getMixin($name);
+		}
+		throw new SassContextException('Undefined {what}: {name}', array('{what}'=>'Mixin', '{name}'=>$name), $this->node);
+	}
+
+	/**
+	 * Returns a variable defined in this context
+	 * @param string name of variable to return
+	 * @return string the variable
+	 * @throws SassContextException if variable not defined in this context
+	 */
+	public function getVariable($name) {
+		if (isset($this->variables[$name])) {
+			return $this->variables[$name];
+		}
+		elseif (!empty($this->parent)) {
+			return $this->parent->getVariable($name);
+		}
+		else {
+			throw new SassContextException('Undefined {what}: {name}', array('{what}'=>'Variable', '{name}'=>$name), $this->node);
+		}
+	}
+
+	/**
+	 * Returns a value indicating if the variable exists in this context
+	 * @param string name of variable to test
+	 * @return boolean true if the variable exists in this context, false if not
+	 */
+	public function hasVariable($name) {
+		return isset($this->variables[$name]);
+	}
+
+	/**
+	 * Sets a variable to the given value
+	 * @param string name of variable
+	 * @param sassLiteral value of variable
+	 */
+	public function setVariable($name, $value) {
+		$this->variables[$name] = $value;
+		return $this;
+	}
+
+	/**
+	 * Makes variables and mixins from this context available in the parent context.
+	 * Note that if there are variables or mixins with the same name in the two
+	 * contexts they will be set to that defined in this context.
+	 */
+	public function merge() {
+	  $this->parent->variables =
+	  	array_merge($this->parent->variables, $this->variables);
+	  $this->parent->mixins = array_merge($this->parent->mixins, $this->mixins);
+	}
+}

data/lib/Phamlp/sass/tree/SassDebugNode.php

@@ -0,0 +1,84 @@
+<?php
+/* SVN FILE: $Id: SassDebugNode.php 49 2010-04-04 10:51:24Z chris.l.yates $ */
+/**
+ * SassDebugNode class file.
+ * @author			Chris Yates <chris.l.yates@gmail.com>
+ * @copyright 	Copyright (c) 2010 PBM Web Development
+ * @license			http://phamlp.googlecode.com/files/license.txt
+ * @package			PHamlP
+ * @subpackage	Sass.tree
+ */
+
+/**
+ * SassDebugNode class.
+ * Represents a Sass @debug or @warn directive.
+ * @package			PHamlP
+ * @subpackage	Sass.tree
+ */
+class SassDebugNode extends SassNode {
+	const IDENTIFIER = '@';
+	const MATCH = '/^@(?:debug|warn)\s+(.+?)\s*;?$/';
+	const MESSAGE = 1;
+
+	/**
+	 * @var string the debug/warning message
+	 */
+	private $message;
+	/**
+	 * @var array parameters for the message;
+	 * only used by internal warning messages
+	 */
+	private $params;
+	/**
+	 * @var boolean true if this is a warning
+	 */
+	private $warning;
+
+	/**
+	 * SassDebugNode.
+	 * @param object source token
+	 * @param mixed string: an internally generated warning message about the
+	 * source
+	 * boolean: the source token is a @debug or @warn directive containing the
+	 * message; True if this is a @warn directive
+	 * @param array parameters for the message
+	 * @return SassDebugNode
+	 */
+	public function __construct($token, $message=false, $params=array()) {
+		parent::__construct($token);
+		if (is_string($message)) {
+			$this->message = $message;
+			$this->warning = true;
+		}
+		else {
+			preg_match(self::MATCH, $token->source, $matches);
+			$this->message = $matches[self::MESSAGE];
+			$this->warning = $message;			
+		}
+		$this->params = $params;
+	}
+
+	/**
+	 * Parse this node.
+	 * This raises an error.
+	 * @return array An empty array
+	 */
+	public function parse($context) {
+		if (!$this->warning || ($this->root->parser->quiet === false)) {
+			set_error_handler(array($this, 'errorHandler'));
+			trigger_error(($this->warning ? $this->interpolate(Phamlp::t('sass', $this->message, $this->params), $context) : $this->evaluate(Phamlp::t('sass', $this->message, $this->params), $context)->toString()));
+			restore_error_handler();			
+		}
+
+		return array();
+	}
+
+	/**
+	 * Error handler for degug and warning statements.
+	 * @param int Error number 
+	 * @param string Message 
+	 */
+	public function errorHandler($errno, $message) {
+		echo '<div style="background-color:#ce4dd6;border-bottom:1px dashed #88338d;color:white;font:10pt verdana;margin:0;padding:0.5em 2%;width:96%;"><p style="height:auto;margin:0.25em 0;padding:0;width:100%;"><span style="font-weight:bold;">SASS '.($this->warning ? 'WARNING' : 'DEBUG').":</span> $message</p><p style=\"margin:0.1em;padding:0;padding-left:0.5em;width:100%;\">{$this->filename}::{$this->line}</p><p style=\"margin:0.1em;padding:0;padding-left:0.5em;width:100%;\">Source: {$this->source}</p></div>";
+	}
+}

data/lib/Phamlp/sass/tree/SassDirectiveNode.php

@@ -0,0 +1,76 @@
+<?php
+/* SVN FILE: $Id: SassDirectiveNode.php 118 2010-09-21 09:45:11Z chris.l.yates@gmail.com $ */
+/**
+ * SassDirectiveNode class file.
+ * @author			Chris Yates <chris.l.yates@gmail.com>
+ * @copyright 	Copyright (c) 2010 PBM Web Development
+ * @license			http://phamlp.googlecode.com/files/license.txt
+ * @package			PHamlP
+ * @subpackage	Sass.tree
+ */
+
+/**
+ * SassDirectiveNode class.
+ * Represents a CSS directive.
+ * @package			PHamlP
+ * @subpackage	Sass.tree
+ */
+class SassDirectiveNode extends SassNode {
+	const NODE_IDENTIFIER = '@';
+	const MATCH = '/^(@\w+)/';
+
+	/**
+	 * SassDirectiveNode.
+	 * @param object source token
+	 * @return SassDirectiveNode
+	 */
+	public function __construct($token) {
+		parent::__construct($token);
+	}
+	
+	protected function getDirective() {
+		return self::extractDirective($this->token);
+	}
+
+	/**
+	 * Parse this node.
+	 * @param SassContext the context in which this node is parsed
+	 * @return array the parsed node
+	 */
+	public function parse($context) {
+		$this->children = $this->parseChildren($context);
+		return array($this);
+	}
+
+	/**
+	 * Render this node.
+	 * @return string the rendered node
+	 */
+	public function render() {
+		$properties = array();
+		foreach ($this->children as $child) {
+			$properties[] = $child->render();
+		} // foreach
+
+		return $this->renderer->renderDirective($this, $properties);
+	}
+
+	/**
+	 * Returns a value indicating if the token represents this type of node.
+	 * @param object token
+	 * @return boolean true if the token represents this type of node, false if not
+	 */
+	public static function isa($token) {
+		return $token->source[0] === self::NODE_IDENTIFIER;
+	}
+
+	/**
+	 * Returns the directive
+	 * @param object token
+	 * @return string the directive
+	 */
+	public static function extractDirective($token) {
+		preg_match(self::MATCH, $token->source, $matches);
+	  return strtolower($matches[1]);
+	}
+}

data/lib/Phamlp/sass/tree/SassElseNode.php

@@ -0,0 +1,28 @@
+<?php
+/* SVN FILE: $Id: SassIfNode.php 49 2010-04-04 10:51:24Z chris.l.yates $ */
+/**
+ * SassElseNode class file.
+ * @author			Chris Yates <chris.l.yates@gmail.com>
+ * @copyright 	Copyright (c) 2010 PBM Web Development
+ * @license			http://phamlp.googlecode.com/files/license.txt
+ * @package			PHamlP
+ * @subpackage	Sass.tree
+ */
+
+/**
+ * SassElseNode class.
+ * Represents Sass Else If and Else statements.
+ * Else If and Else statement nodes are chained below the If statement node.
+ * @package			PHamlP
+ * @subpackage	Sass.tree
+ */
+class SassElseNode extends SassIfNode {
+	/**
+	 * SassElseNode constructor.
+	 * @param object source token
+	 * @return SassElseNode
+	 */
+	public function __construct($token) {
+		parent::__construct($token, false);
+	}
+}

data/lib/Phamlp/sass/tree/SassExtendNode.php

@@ -0,0 +1,47 @@
+<?php
+/* SVN FILE: $Id: SassExtendNode.php 49 2010-04-04 10:51:24Z chris.l.yates $ */
+/**
+ * SassExtendNode class file.
+ * @author			Chris Yates <chris.l.yates@gmail.com>
+ * @copyright 	Copyright (c) 2010 PBM Web Development
+ * @license			http://phamlp.googlecode.com/files/license.txt
+ * @package			PHamlP
+ * @subpackage	Sass.tree
+ */
+
+/**
+ * SassExtendNode class.
+ * Represents a Sass @debug or @warn directive.
+ * @package			PHamlP
+ * @subpackage	Sass.tree
+ */
+class SassExtendNode extends SassNode {
+	const IDENTIFIER = '@';
+	const MATCH = '/^@extend\s+(.+)/i';
+	const VALUE = 1;
+
+	/**
+	 * @var string the directive
+	 */
+	private $value;
+
+	/**
+	 * SassExtendNode.
+	 * @param object source token
+	 * @return SassExtendNode
+	 */
+	public function __construct($token) {
+		parent::__construct($token);
+		preg_match(self::MATCH, $token->source, $matches);
+		$this->value = $matches[self::VALUE];
+	}
+
+	/**
+	 * Parse this node.
+	 * @return array An empty array
+	 */
+	public function parse($context) {
+		$this->root->extend($this->value, $this->parent->selectors);
+		return array();
+	}
+}

data/lib/Phamlp/sass/tree/SassForNode.php

@@ -0,0 +1,99 @@
+<?php
+/* SVN FILE: $Id: SassForNode.php 118 2010-09-21 09:45:11Z chris.l.yates@gmail.com $ */
+/**
+ * SassForNode class file.
+ * This is an enhanced version of the standard SassScript @for loop that adds
+ * an optional step clause. Step must evaluate to a positive integer.
+ * The syntax is:
+ * <pre>@for <var> from <start> to|through <end>[ step <step>]</pre>.
+ *
+ * <start> can be less or greater than <end>.
+ * If the step clause is ommitted the <step> = 1.
+ * <var> is available to the rest of the script following evaluation
+ * and has the value that terminated the loop.
+ * 
+ * @author			Chris Yates <chris.l.yates@gmail.com>
+ * @copyright 	Copyright (c) 2010 PBM Web Development
+ * @license			http://phamlp.googlecode.com/files/license.txt
+ * @package			PHamlP
+ * @subpackage	Sass.tree 
+ */
+
+/**
+ * SassForNode class.
+ * Represents a Sass @for loop.
+ * @package			PHamlP
+ * @subpackage	Sass.tree
+ */
+class SassForNode extends SassNode {
+	const MATCH = '/@for\s+[!\$](\w+)\s+from\s+(.+?)\s+(through|to)\s+(.+?)(?:\s+step\s+(.+))?$/i';
+
+	const VARIABLE = 1;
+	const FROM = 2;
+	const INCLUSIVE = 3;
+	const TO = 4;
+	const STEP = 5;
+	const IS_INCLUSIVE = 'through';
+
+	/**
+	 * @var string variable name for the loop
+	 */
+	private $variable;
+	/**
+	 * @var string expression that provides the loop start value
+	 */
+	private $from;
+	/**
+	 * @var string expression that provides the loop end value
+	 */
+	private $to;
+	/**
+	 * @var boolean whether the loop end value is inclusive
+	 */
+	private $inclusive;
+	/**
+	 * @var string expression that provides the amount by which the loop variable
+	 * changes on each iteration
+	 */
+	private $step;
+
+	/**
+	 * SassForNode constructor.
+	 * @param object source token
+	 * @return SassForNode
+	 */
+	public function __construct($token) {
+		parent::__construct($token);
+		if (!preg_match(self::MATCH, $token->source, $matches)) {
+			throw new SassForNodeException('Invalid {what}', array('{what}'=>'@for directive'), $this);
+		}
+		$this->variable  = $matches[self::VARIABLE];
+		$this->from			 = $matches[self::FROM];
+		$this->to				 = $matches[self::TO];
+		$this->inclusive = ($matches[self::INCLUSIVE] === SassForNode::IS_INCLUSIVE);
+		$this->step			 = (empty($matches[self::STEP]) ? 1 : $matches[self::STEP]);
+	}
+
+	/**
+	 * Parse this node.
+	 * @param SassContext the context in which this node is parsed
+	 * @return array parsed child nodes
+	 */
+	public function parse($context) {
+		$children = array();
+		$from = (float)$this->evaluate($this->from, $context)->value;
+		$to		= (float)$this->evaluate($this->to,		$context)->value;
+		$step = (float)$this->evaluate($this->step, $context)->value * ($to > $from ? 1 : -1);
+
+		if ($this->inclusive) {
+			$to += ($from < $to ? 1 : -1);
+		}
+
+		$context = new SassContext($context);
+		for ($i = $from; ($from < $to ? $i < $to : $i > $to); $i = $i + $step) {
+			$context->setVariable($this->variable, new SassNumber($i));
+			$children = array_merge($children, $this->parseChildren($context));
+		}
+		return $children;
+	}
+}

data/lib/Phamlp/sass/tree/SassIfNode.php

@@ -0,0 +1,95 @@
+<?php
+/* SVN FILE: $Id: SassIfNode.php 118 2010-09-21 09:45:11Z chris.l.yates@gmail.com $ */
+/**
+ * SassIfNode class file.
+ * @author			Chris Yates <chris.l.yates@gmail.com>
+ * @copyright 	Copyright (c) 2010 PBM Web Development
+ * @license			http://phamlp.googlecode.com/files/license.txt
+ * @package			PHamlP
+ * @subpackage	Sass.tree
+ */
+
+/**
+ * SassIfNode class.
+ * Represents Sass If, Else If and Else statements.
+ * Else If and Else statement nodes are chained below the If statement node.
+ * @package			PHamlP
+ * @subpackage	Sass.tree
+ */
+class SassIfNode extends SassNode {
+	const MATCH_IF = '/^@if\s+(.+)$/i';
+	const MATCH_ELSE = '/@else(\s+if\s+(.+))?/i';
+	const IF_EXPRESSION = 1;
+	const ELSE_IF = 1;
+	const ELSE_EXPRESSION = 2;
+	/**
+	 * @var SassIfNode the next else node.
+	 */
+	private $else;
+	/**
+	 * @var string expression to evaluate
+	 */
+	private $expression;
+
+	/**
+	 * SassIfNode constructor.
+	 * @param object source token
+	 * @param boolean true for an "if" node, false for an "else if | else" node
+	 * @return SassIfNode
+	 */
+	public function __construct($token, $if=true) {
+		parent::__construct($token);
+		if ($if) {
+			preg_match(self::MATCH_IF, $token->source, $matches);
+			$this->expression = $matches[SassIfNode::IF_EXPRESSION];
+		}
+		else {
+			preg_match(self::MATCH_ELSE, $token->source, $matches);
+			$this->expression = (sizeof($matches)==1 ? null : $matches[SassIfNode::ELSE_EXPRESSION]);
+		}
+	}
+
+	/**
+	 * Adds an "else" statement to this node.
+	 * @param SassIfNode "else" statement node to add
+	 * @return SassIfNode this node
+	 */
+	public function addElse($node) {
+	  if (is_null($this->else)) {
+	  	$node->parent	= $this->parent;
+	  	$node->root		= $this->root;
+			$this->else		= $node;
+	  }
+	  else {
+			$this->else->addElse($node);
+	  }
+	  return $this;
+	}
+
+	/**
+	 * Parse this node.
+	 * @param SassContext the context in which this node is parsed
+	 * @return array parsed child nodes
+	 */
+	public function parse($context) {
+		if ($this->isElse() || $this->evaluate($this->expression, $context)->toBoolean()) {
+			$children = $this->parseChildren($context);
+		}
+		elseif (!empty($this->else)) {
+			$children = $this->else->parse($context);
+		}
+		else {
+			$children = array();
+		}
+		return $children;
+	}
+
+	/**
+	 * Returns a value indicating if this node is an "else" node.
+	 * @return true if this node is an "else" node, false if this node is an "if"
+	 * or "else if" node
+	 */
+	private function isElse() {
+	  return empty($this->expression);
+	}
+}

data/lib/Phamlp/sass/tree/SassImportNode.php

@@ -0,0 +1,69 @@
+<?php
+/* SVN FILE: $Id: SassImportNode.php 49 2010-04-04 10:51:24Z chris.l.yates $ */
+/**
+ * SassImportNode class file.
+ * @author			Chris Yates <chris.l.yates@gmail.com>
+ * @copyright 	Copyright (c) 2010 PBM Web Development
+ * @license			http://phamlp.googlecode.com/files/license.txt
+ * @package			PHamlP
+ * @subpackage	Sass.tree
+ */
+
+/**
+ * SassImportNode class.
+ * Represents a CSS Import.
+ * @package			PHamlP
+ * @subpackage	Sass.tree
+ */
+class SassImportNode extends SassNode {
+	const IDENTIFIER = '@';
+	const MATCH = '/^@import\s+(.+)/i';
+	const MATCH_CSS = '/^(.+\.css|url\(.+\)|.+" \w+|"http)/im';
+	const FILES = 1;
+
+	/**
+	 * @var array files to import
+	 */
+	private $files = array();
+
+	/**
+	 * SassImportNode.
+	 * @param object source token
+	 * @return SassImportNode
+	 */
+	public function __construct($token) {
+		parent::__construct($token);
+		preg_match(self::MATCH, $token->source, $matches);
+		foreach (explode(',', $matches[self::FILES]) as $file) {
+			$this->files[] = trim($file);
+		}		
+	}
+
+	/**
+	 * Parse this node.
+	 * If the node is a CSS import return the CSS import rule.
+	 * Else returns the rendered tree for the file.
+	 * @param SassContext the context in which this node is parsed
+	 * @return array the parsed node
+	 */
+	public function parse($context) {
+		$imported = array();
+		foreach ($this->files as $file) {
+			if (preg_match(self::MATCH_CSS, $file)) {
+				return "@import {$file}";
+			}
+			else {
+				$file = trim($file, '\'"');
+				$tree = SassFile::getTree(
+					SassFile::getFile($file, $this->parser), $this->parser);
+				if (empty($tree)) {
+					throw new SassImportNodeException('Unable to create document tree for {file}', array('{file}'=>$file), $this);
+				}
+				else {
+					$imported = array_merge($imported, $tree->parse($context)->children);
+				}
+			}
+		}
+		return $imported;
+	}
+}