qrcode.chapril.org-libreqr/less.php/lib/Less/Parser.php
2021-02-15 21:29:38 +01:00

2692 lines
66 KiB
PHP

<?php
require_once dirname( __FILE__ ).'/Cache.php';
/**
* Class for parsing and compiling less files into css
*
* @package Less
* @subpackage parser
*
*/
class Less_Parser {
/**
* Default parser options
*/
public static $default_options = array(
'compress' => false, // option - whether to compress
'strictUnits' => false, // whether units need to evaluate correctly
'strictMath' => false, // whether math has to be within parenthesis
'relativeUrls' => true, // option - whether to adjust URL's to be relative
'urlArgs' => '', // whether to add args into url tokens
'numPrecision' => 8,
'import_dirs' => array(),
'import_callback' => null,
'cache_dir' => null,
'cache_method' => 'php', // false, 'serialize', 'php', 'var_export', 'callback';
'cache_callback_get' => null,
'cache_callback_set' => null,
'sourceMap' => false, // whether to output a source map
'sourceMapBasepath' => null,
'sourceMapWriteTo' => null,
'sourceMapURL' => null,
'indentation' => ' ',
'plugins' => array(),
);
public static $options = array();
private $input; // Less input string
private $input_len; // input string length
private $pos; // current index in `input`
private $saveStack = array(); // holds state for backtracking
private $furthest;
private $mb_internal_encoding = ''; // for remember exists value of mbstring.internal_encoding
/**
* @var Less_Environment
*/
private $env;
protected $rules = array();
private static $imports = array();
public static $has_extends = false;
public static $next_id = 0;
/**
* Filename to contents of all parsed the files
*
* @var array
*/
public static $contentsMap = array();
/**
* @param Less_Environment|array|null $env
*/
public function __construct( $env = null ) {
// Top parser on an import tree must be sure there is one "env"
// which will then be passed around by reference.
if ( $env instanceof Less_Environment ) {
$this->env = $env;
} else {
$this->SetOptions( Less_Parser::$default_options );
$this->Reset( $env );
}
// mbstring.func_overload > 1 bugfix
// The encoding value must be set for each source file,
// therefore, to conserve resources and improve the speed of this design is taken here
if ( ini_get( 'mbstring.func_overload' ) ) {
$this->mb_internal_encoding = ini_get( 'mbstring.internal_encoding' );
@ini_set( 'mbstring.internal_encoding', 'ascii' );
}
}
/**
* Reset the parser state completely
*
*/
public function Reset( $options = null ) {
$this->rules = array();
self::$imports = array();
self::$has_extends = false;
self::$imports = array();
self::$contentsMap = array();
$this->env = new Less_Environment( $options );
// set new options
if ( is_array( $options ) ) {
$this->SetOptions( Less_Parser::$default_options );
$this->SetOptions( $options );
}
$this->env->Init();
}
/**
* Set one or more compiler options
* options: import_dirs, cache_dir, cache_method
*
*/
public function SetOptions( $options ) {
foreach ( $options as $option => $value ) {
$this->SetOption( $option, $value );
}
}
/**
* Set one compiler option
*
*/
public function SetOption( $option, $value ) {
switch ( $option ) {
case 'import_dirs':
$this->SetImportDirs( $value );
return;
case 'cache_dir':
if ( is_string( $value ) ) {
Less_Cache::SetCacheDir( $value );
Less_Cache::CheckCacheDir();
}
return;
}
Less_Parser::$options[$option] = $value;
}
/**
* Registers a new custom function
*
* @param string $name function name
* @param callable $callback callback
*/
public function registerFunction( $name, $callback ) {
$this->env->functions[$name] = $callback;
}
/**
* Removed an already registered function
*
* @param string $name function name
*/
public function unregisterFunction( $name ) {
if ( isset( $this->env->functions[$name] ) )
unset( $this->env->functions[$name] );
}
/**
* Get the current css buffer
*
* @return string
*/
public function getCss() {
$precision = ini_get( 'precision' );
@ini_set( 'precision', 16 );
$locale = setlocale( LC_NUMERIC, 0 );
setlocale( LC_NUMERIC, "C" );
try {
$root = new Less_Tree_Ruleset( array(), $this->rules );
$root->root = true;
$root->firstRoot = true;
$this->PreVisitors( $root );
self::$has_extends = false;
$evaldRoot = $root->compile( $this->env );
$this->PostVisitors( $evaldRoot );
if ( Less_Parser::$options['sourceMap'] ) {
$generator = new Less_SourceMap_Generator( $evaldRoot, Less_Parser::$contentsMap, Less_Parser::$options );
// will also save file
// FIXME: should happen somewhere else?
$css = $generator->generateCSS();
} else {
$css = $evaldRoot->toCSS();
}
if ( Less_Parser::$options['compress'] ) {
$css = preg_replace( '/(^(\s)+)|((\s)+$)/', '', $css );
}
} catch ( Exception $exc ) {
// Intentional fall-through so we can reset environment
}
// reset php settings
@ini_set( 'precision', $precision );
setlocale( LC_NUMERIC, $locale );
// If you previously defined $this->mb_internal_encoding
// is required to return the encoding as it was before
if ( $this->mb_internal_encoding != '' ) {
@ini_set( "mbstring.internal_encoding", $this->mb_internal_encoding );
$this->mb_internal_encoding = '';
}
// Rethrow exception after we handled resetting the environment
if ( !empty( $exc ) ) {
throw $exc;
}
return $css;
}
public function findValueOf( $varName ) {
foreach ( $this->rules as $rule ) {
if ( isset( $rule->variable ) && ( $rule->variable == true ) && ( str_replace( "@", "", $rule->name ) == $varName ) ) {
return $this->getVariableValue( $rule );
}
}
return null;
}
/**
*
* this function gets the private rules variable and returns an array of the found variables
* it uses a helper method getVariableValue() that contains the logic ot fetch the value from the rule object
*
* @return array
*/
public function getVariables() {
$variables = array();
$not_variable_type = array(
'Comment', // this include less comments ( // ) and css comments (/* */)
'Import', // do not search variables in included files @import
'Ruleset', // selectors (.someclass, #someid, …)
'Operation', //
);
// @TODO run compilation if not runned yet
foreach ( $this->rules as $key => $rule ) {
if ( in_array( $rule->type, $not_variable_type ) ) {
continue;
}
// Note: it seems rule->type is always Rule when variable = true
if ( $rule->type == 'Rule' && $rule->variable ) {
$variables[$rule->name] = $this->getVariableValue( $rule );
} else {
if ( $rule->type == 'Comment' ) {
$variables[] = $this->getVariableValue( $rule );
}
}
}
return $variables;
}
public function findVarByName( $var_name ) {
foreach ( $this->rules as $rule ) {
if ( isset( $rule->variable ) && ( $rule->variable == true ) ) {
if ( $rule->name == $var_name ) {
return $this->getVariableValue( $rule );
}
}
}
return null;
}
/**
*
* This method gets the value of the less variable from the rules object.
* Since the objects vary here we add the logic for extracting the css/less value.
*
* @param $var
*
* @return bool|string
*/
private function getVariableValue( $var ) {
if ( !is_a( $var, 'Less_Tree' ) ) {
throw new Exception( 'var is not a Less_Tree object' );
}
switch ( $var->type ) {
case 'Color':
return $this->rgb2html( $var->rgb );
case 'Unit':
return $var->value. $var->unit->numerator[0];
case 'Variable':
return $this->findVarByName( $var->name );
case 'Keyword':
return $var->value;
case 'Rule':
return $this->getVariableValue( $var->value );
case 'Value':
$value = '';
foreach ( $var->value as $sub_value ) {
$value .= $this->getVariableValue( $sub_value ).' ';
}
return $value;
case 'Quoted':
return $var->quote.$var->value.$var->quote;
case 'Dimension':
$value = $var->value;
if ( $var->unit && $var->unit->numerator ) {
$value .= $var->unit->numerator[0];
}
return $value;
case 'Expression':
$value = "";
foreach ( $var->value as $item ) {
$value .= $this->getVariableValue( $item )." ";
}
return $value;
case 'Operation':
throw new Exception( 'getVariables() require Less to be compiled. please use $parser->getCss() before calling getVariables()' );
case 'Comment':
case 'Import':
case 'Ruleset':
default:
throw new Exception( "type missing in switch/case getVariableValue for ".$var->type );
}
return false;
}
private function rgb2html( $r, $g = -1, $b = -1 ) {
if ( is_array( $r ) && sizeof( $r ) == 3 )
list( $r, $g, $b ) = $r;
$r = intval( $r ); $g = intval( $g );
$b = intval( $b );
$r = dechex( $r < 0 ? 0 : ( $r > 255 ? 255 : $r ) );
$g = dechex( $g < 0 ? 0 : ( $g > 255 ? 255 : $g ) );
$b = dechex( $b < 0 ? 0 : ( $b > 255 ? 255 : $b ) );
$color = ( strlen( $r ) < 2 ? '0' : '' ).$r;
$color .= ( strlen( $g ) < 2 ? '0' : '' ).$g;
$color .= ( strlen( $b ) < 2 ? '0' : '' ).$b;
return '#'.$color;
}
/**
* Run pre-compile visitors
*
*/
private function PreVisitors( $root ) {
if ( Less_Parser::$options['plugins'] ) {
foreach ( Less_Parser::$options['plugins'] as $plugin ) {
if ( !empty( $plugin->isPreEvalVisitor ) ) {
$plugin->run( $root );
}
}
}
}
/**
* Run post-compile visitors
*
*/
private function PostVisitors( $evaldRoot ) {
$visitors = array();
$visitors[] = new Less_Visitor_joinSelector();
if ( self::$has_extends ) {
$visitors[] = new Less_Visitor_processExtends();
}
$visitors[] = new Less_Visitor_toCSS();
if ( Less_Parser::$options['plugins'] ) {
foreach ( Less_Parser::$options['plugins'] as $plugin ) {
if ( property_exists( $plugin, 'isPreEvalVisitor' ) && $plugin->isPreEvalVisitor ) {
continue;
}
if ( property_exists( $plugin, 'isPreVisitor' ) && $plugin->isPreVisitor ) {
array_unshift( $visitors, $plugin );
} else {
$visitors[] = $plugin;
}
}
}
for ( $i = 0; $i < count( $visitors ); $i++ ) {
$visitors[$i]->run( $evaldRoot );
}
}
/**
* Parse a Less string into css
*
* @param string $str The string to convert
* @param string $uri_root The url of the file
* @return Less_Tree_Ruleset|Less_Parser
*/
public function parse( $str, $file_uri = null ) {
if ( !$file_uri ) {
$uri_root = '';
$filename = 'anonymous-file-'.Less_Parser::$next_id++.'.less';
} else {
$file_uri = self::WinPath( $file_uri );
$filename = $file_uri;
$uri_root = dirname( $file_uri );
}
$previousFileInfo = $this->env->currentFileInfo;
$uri_root = self::WinPath( $uri_root );
$this->SetFileInfo( $filename, $uri_root );
$this->input = $str;
$this->_parse();
if ( $previousFileInfo ) {
$this->env->currentFileInfo = $previousFileInfo;
}
return $this;
}
/**
* Parse a Less string from a given file
*
* @throws Less_Exception_Parser
* @param string $filename The file to parse
* @param string $uri_root The url of the file
* @param bool $returnRoot Indicates whether the return value should be a css string a root node
* @return Less_Tree_Ruleset|Less_Parser
*/
public function parseFile( $filename, $uri_root = '', $returnRoot = false ) {
if ( !file_exists( $filename ) ) {
$this->Error( sprintf( 'File `%s` not found.', $filename ) );
}
// fix uri_root?
// Instead of The mixture of file path for the first argument and directory path for the second argument has bee
if ( !$returnRoot && !empty( $uri_root ) && basename( $uri_root ) == basename( $filename ) ) {
$uri_root = dirname( $uri_root );
}
$previousFileInfo = $this->env->currentFileInfo;
if ( $filename ) {
$filename = self::AbsPath( $filename, true );
}
$uri_root = self::WinPath( $uri_root );
$this->SetFileInfo( $filename, $uri_root );
self::AddParsedFile( $filename );
if ( $returnRoot ) {
$rules = $this->GetRules( $filename );
$return = new Less_Tree_Ruleset( array(), $rules );
} else {
$this->_parse( $filename );
$return = $this;
}
if ( $previousFileInfo ) {
$this->env->currentFileInfo = $previousFileInfo;
}
return $return;
}
/**
* Allows a user to set variables values
* @param array $vars
* @return Less_Parser
*/
public function ModifyVars( $vars ) {
$this->input = Less_Parser::serializeVars( $vars );
$this->_parse();
return $this;
}
/**
* @param string $filename
*/
public function SetFileInfo( $filename, $uri_root = '' ) {
$filename = Less_Environment::normalizePath( $filename );
$dirname = preg_replace( '/[^\/\\\\]*$/', '', $filename );
if ( !empty( $uri_root ) ) {
$uri_root = rtrim( $uri_root, '/' ).'/';
}
$currentFileInfo = array();
// entry info
if ( isset( $this->env->currentFileInfo ) ) {
$currentFileInfo['entryPath'] = $this->env->currentFileInfo['entryPath'];
$currentFileInfo['entryUri'] = $this->env->currentFileInfo['entryUri'];
$currentFileInfo['rootpath'] = $this->env->currentFileInfo['rootpath'];
} else {
$currentFileInfo['entryPath'] = $dirname;
$currentFileInfo['entryUri'] = $uri_root;
$currentFileInfo['rootpath'] = $dirname;
}
$currentFileInfo['currentDirectory'] = $dirname;
$currentFileInfo['currentUri'] = $uri_root.basename( $filename );
$currentFileInfo['filename'] = $filename;
$currentFileInfo['uri_root'] = $uri_root;
// inherit reference
if ( isset( $this->env->currentFileInfo['reference'] ) && $this->env->currentFileInfo['reference'] ) {
$currentFileInfo['reference'] = true;
}
$this->env->currentFileInfo = $currentFileInfo;
}
/**
* @deprecated 1.5.1.2
*
*/
public function SetCacheDir( $dir ) {
if ( !file_exists( $dir ) ) {
if ( mkdir( $dir ) ) {
return true;
}
throw new Less_Exception_Parser( 'Less.php cache directory couldn\'t be created: '.$dir );
} elseif ( !is_dir( $dir ) ) {
throw new Less_Exception_Parser( 'Less.php cache directory doesn\'t exist: '.$dir );
} elseif ( !is_writable( $dir ) ) {
throw new Less_Exception_Parser( 'Less.php cache directory isn\'t writable: '.$dir );
} else {
$dir = self::WinPath( $dir );
Less_Cache::$cache_dir = rtrim( $dir, '/' ).'/';
return true;
}
}
/**
* Set a list of directories or callbacks the parser should use for determining import paths
*
* @param array $dirs
*/
public function SetImportDirs( $dirs ) {
Less_Parser::$options['import_dirs'] = array();
foreach ( $dirs as $path => $uri_root ) {
$path = self::WinPath( $path );
if ( !empty( $path ) ) {
$path = rtrim( $path, '/' ).'/';
}
if ( !is_callable( $uri_root ) ) {
$uri_root = self::WinPath( $uri_root );
if ( !empty( $uri_root ) ) {
$uri_root = rtrim( $uri_root, '/' ).'/';
}
}
Less_Parser::$options['import_dirs'][$path] = $uri_root;
}
}
/**
* @param string $file_path
*/
private function _parse( $file_path = null ) {
$this->rules = array_merge( $this->rules, $this->GetRules( $file_path ) );
}
/**
* Return the results of parsePrimary for $file_path
* Use cache and save cached results if possible
*
* @param string|null $file_path
*/
private function GetRules( $file_path ) {
$this->SetInput( $file_path );
$cache_file = $this->CacheFile( $file_path );
if ( $cache_file ) {
if ( Less_Parser::$options['cache_method'] == 'callback' ) {
if ( is_callable( Less_Parser::$options['cache_callback_get'] ) ) {
$cache = call_user_func_array(
Less_Parser::$options['cache_callback_get'],
array( $this, $file_path, $cache_file )
);
if ( $cache ) {
$this->UnsetInput();
return $cache;
}
}
} elseif ( file_exists( $cache_file ) ) {
switch ( Less_Parser::$options['cache_method'] ) {
// Using serialize
// Faster but uses more memory
case 'serialize':
$cache = unserialize( file_get_contents( $cache_file ) );
if ( $cache ) {
touch( $cache_file );
$this->UnsetInput();
return $cache;
}
break;
// Using generated php code
case 'var_export':
case 'php':
$this->UnsetInput();
return include $cache_file;
}
}
}
$rules = $this->parsePrimary();
if ( $this->pos < $this->input_len ) {
throw new Less_Exception_Chunk( $this->input, null, $this->furthest, $this->env->currentFileInfo );
}
$this->UnsetInput();
// save the cache
if ( $cache_file ) {
if ( Less_Parser::$options['cache_method'] == 'callback' ) {
if ( is_callable( Less_Parser::$options['cache_callback_set'] ) ) {
call_user_func_array(
Less_Parser::$options['cache_callback_set'],
array( $this, $file_path, $cache_file, $rules )
);
}
} else {
// msg('write cache file');
switch ( Less_Parser::$options['cache_method'] ) {
case 'serialize':
file_put_contents( $cache_file, serialize( $rules ) );
break;
case 'php':
file_put_contents( $cache_file, '<?php return '.self::ArgString( $rules ).'; ?>' );
break;
case 'var_export':
// Requires __set_state()
file_put_contents( $cache_file, '<?php return '.var_export( $rules, true ).'; ?>' );
break;
}
Less_Cache::CleanCache();
}
}
return $rules;
}
/**
* Set up the input buffer
*
*/
public function SetInput( $file_path ) {
if ( $file_path ) {
$this->input = file_get_contents( $file_path );
}
$this->pos = $this->furthest = 0;
// Remove potential UTF Byte Order Mark
$this->input = preg_replace( '/\\G\xEF\xBB\xBF/', '', $this->input );
$this->input_len = strlen( $this->input );
if ( Less_Parser::$options['sourceMap'] && $this->env->currentFileInfo ) {
$uri = $this->env->currentFileInfo['currentUri'];
Less_Parser::$contentsMap[$uri] = $this->input;
}
}
/**
* Free up some memory
*
*/
public function UnsetInput() {
unset( $this->input, $this->pos, $this->input_len, $this->furthest );
$this->saveStack = array();
}
public function CacheFile( $file_path ) {
if ( $file_path && $this->CacheEnabled() ) {
$env = get_object_vars( $this->env );
unset( $env['frames'] );
$parts = array();
$parts[] = $file_path;
$parts[] = filesize( $file_path );
$parts[] = filemtime( $file_path );
$parts[] = $env;
$parts[] = Less_Version::cache_version;
$parts[] = Less_Parser::$options['cache_method'];
return Less_Cache::$cache_dir . Less_Cache::$prefix . base_convert( sha1( json_encode( $parts ) ), 16, 36 ) . '.lesscache';
}
}
static function AddParsedFile( $file ) {
self::$imports[] = $file;
}
static function AllParsedFiles() {
return self::$imports;
}
/**
* @param string $file
*/
static function FileParsed( $file ) {
return in_array( $file, self::$imports );
}
function save() {
$this->saveStack[] = $this->pos;
}
private function restore() {
$this->pos = array_pop( $this->saveStack );
}
private function forget() {
array_pop( $this->saveStack );
}
/**
* Determine if the character at the specified offset from the current position is a white space.
*
* @param int $offset
*
* @return bool
*/
private function isWhitespace( $offset = 0 ) {
return strpos( " \t\n\r\v\f", $this->input[$this->pos + $offset] ) !== false;
}
/**
* Parse from a token, regexp or string, and move forward if match
*
* @param array $toks
* @return array
*/
private function match( $toks ) {
// The match is confirmed, add the match length to `this::pos`,
// and consume any extra white-space characters (' ' || '\n')
// which come after that. The reason for this is that LeSS's
// grammar is mostly white-space insensitive.
//
foreach ( $toks as $tok ) {
$char = $tok[0];
if ( $char === '/' ) {
$match = $this->MatchReg( $tok );
if ( $match ) {
return count( $match ) === 1 ? $match[0] : $match;
}
} elseif ( $char === '#' ) {
$match = $this->MatchChar( $tok[1] );
} else {
// Non-terminal, match using a function call
$match = $this->$tok();
}
if ( $match ) {
return $match;
}
}
}
/**
* @param string[] $toks
*
* @return string
*/
private function MatchFuncs( $toks ) {
if ( $this->pos < $this->input_len ) {
foreach ( $toks as $tok ) {
$match = $this->$tok();
if ( $match ) {
return $match;
}
}
}
}
// Match a single character in the input,
private function MatchChar( $tok ) {
if ( ( $this->pos < $this->input_len ) && ( $this->input[$this->pos] === $tok ) ) {
$this->skipWhitespace( 1 );
return $tok;
}
}
// Match a regexp from the current start point
private function MatchReg( $tok ) {
if ( preg_match( $tok, $this->input, $match, 0, $this->pos ) ) {
$this->skipWhitespace( strlen( $match[0] ) );
return $match;
}
}
/**
* Same as match(), but don't change the state of the parser,
* just return the match.
*
* @param string $tok
* @return integer
*/
public function PeekReg( $tok ) {
return preg_match( $tok, $this->input, $match, 0, $this->pos );
}
/**
* @param string $tok
*/
public function PeekChar( $tok ) {
// return ($this->input[$this->pos] === $tok );
return ( $this->pos < $this->input_len ) && ( $this->input[$this->pos] === $tok );
}
/**
* @param integer $length
*/
public function skipWhitespace( $length ) {
$this->pos += $length;
for ( ; $this->pos < $this->input_len; $this->pos++ ) {
$c = $this->input[$this->pos];
if ( ( $c !== "\n" ) && ( $c !== "\r" ) && ( $c !== "\t" ) && ( $c !== ' ' ) ) {
break;
}
}
}
/**
* @param string $tok
* @param string|null $msg
*/
public function expect( $tok, $msg = NULL ) {
$result = $this->match( array( $tok ) );
if ( !$result ) {
$this->Error( $msg ? "Expected '" . $tok . "' got '" . $this->input[$this->pos] . "'" : $msg );
} else {
return $result;
}
}
/**
* @param string $tok
*/
public function expectChar( $tok, $msg = null ) {
$result = $this->MatchChar( $tok );
if ( !$result ) {
$msg = $msg ? $msg : "Expected '" . $tok . "' got '" . $this->input[$this->pos] . "'";
$this->Error( $msg );
} else {
return $result;
}
}
//
// Here in, the parsing rules/functions
//
// The basic structure of the syntax tree generated is as follows:
//
// Ruleset -> Rule -> Value -> Expression -> Entity
//
// Here's some LESS code:
//
// .class {
// color: #fff;
// border: 1px solid #000;
// width: @w + 4px;
// > .child {...}
// }
//
// And here's what the parse tree might look like:
//
// Ruleset (Selector '.class', [
// Rule ("color", Value ([Expression [Color #fff]]))
// Rule ("border", Value ([Expression [Dimension 1px][Keyword "solid"][Color #000]]))
// Rule ("width", Value ([Expression [Operation "+" [Variable "@w"][Dimension 4px]]]))
// Ruleset (Selector [Element '>', '.child'], [...])
// ])
//
// In general, most rules will try to parse a token with the `$()` function, and if the return
// value is truly, will return a new node, of the relevant type. Sometimes, we need to check
// first, before parsing, that's when we use `peek()`.
//
//
// The `primary` rule is the *entry* and *exit* point of the parser.
// The rules here can appear at any level of the parse tree.
//
// The recursive nature of the grammar is an interplay between the `block`
// rule, which represents `{ ... }`, the `ruleset` rule, and this `primary` rule,
// as represented by this simplified grammar:
//
// primary → (ruleset | rule)+
// ruleset → selector+ block
// block → '{' primary '}'
//
// Only at one point is the primary rule not called from the
// block rule: at the root level.
//
private function parsePrimary() {
$root = array();
while ( true ) {
if ( $this->pos >= $this->input_len ) {
break;
}
$node = $this->parseExtend( true );
if ( $node ) {
$root = array_merge( $root, $node );
continue;
}
// $node = $this->MatchFuncs( array( 'parseMixinDefinition', 'parseRule', 'parseRuleset', 'parseMixinCall', 'parseComment', 'parseDirective'));
$node = $this->MatchFuncs( array( 'parseMixinDefinition', 'parseNameValue', 'parseRule', 'parseRuleset', 'parseMixinCall', 'parseComment', 'parseRulesetCall', 'parseDirective' ) );
if ( $node ) {
$root[] = $node;
} elseif ( !$this->MatchReg( '/\\G[\s\n;]+/' ) ) {
break;
}
if ( $this->PeekChar( '}' ) ) {
break;
}
}
return $root;
}
// We create a Comment node for CSS comments `/* */`,
// but keep the LeSS comments `//` silent, by just skipping
// over them.
private function parseComment() {
if ( $this->input[$this->pos] !== '/' ) {
return;
}
if ( $this->input[$this->pos + 1] === '/' ) {
$match = $this->MatchReg( '/\\G\/\/.*/' );
return $this->NewObj4( 'Less_Tree_Comment', array( $match[0], true, $this->pos, $this->env->currentFileInfo ) );
}
// $comment = $this->MatchReg('/\\G\/\*(?:[^*]|\*+[^\/*])*\*+\/\n?/');
$comment = $this->MatchReg( '/\\G\/\*(?s).*?\*+\/\n?/' );// not the same as less.js to prevent fatal errors
if ( $comment ) {
return $this->NewObj4( 'Less_Tree_Comment', array( $comment[0], false, $this->pos, $this->env->currentFileInfo ) );
}
}
private function parseComments() {
$comments = array();
while ( $this->pos < $this->input_len ) {
$comment = $this->parseComment();
if ( !$comment ) {
break;
}
$comments[] = $comment;
}
return $comments;
}
//
// A string, which supports escaping " and '
//
// "milky way" 'he\'s the one!'
//
private function parseEntitiesQuoted() {
$j = $this->pos;
$e = false;
$index = $this->pos;
if ( $this->input[$this->pos] === '~' ) {
$j++;
$e = true; // Escaped strings
}
$char = $this->input[$j];
if ( $char !== '"' && $char !== "'" ) {
return;
}
if ( $e ) {
$this->MatchChar( '~' );
}
$matched = $this->MatchQuoted( $char, $j + 1 );
if ( $matched === false ) {
return;
}
$quoted = $char.$matched.$char;
return $this->NewObj5( 'Less_Tree_Quoted', array( $quoted, $matched, $e, $index, $this->env->currentFileInfo ) );
}
/**
* When PCRE JIT is enabled in php, regular expressions don't work for matching quoted strings
*
* $regex = '/\\G\'((?:[^\'\\\\\r\n]|\\\\.|\\\\\r\n|\\\\[\n\r\f])*)\'/';
* $regex = '/\\G"((?:[^"\\\\\r\n]|\\\\.|\\\\\r\n|\\\\[\n\r\f])*)"/';
*
*/
private function MatchQuoted( $quote_char, $i ) {
$matched = '';
while ( $i < $this->input_len ) {
$c = $this->input[$i];
// escaped character
if ( $c === '\\' ) {
$matched .= $c . $this->input[$i + 1];
$i += 2;
continue;
}
if ( $c === $quote_char ) {
$this->pos = $i + 1;
$this->skipWhitespace( 0 );
return $matched;
}
if ( $c === "\r" || $c === "\n" ) {
return false;
}
$i++;
$matched .= $c;
}
return false;
}
//
// A catch-all word, such as:
//
// black border-collapse
//
private function parseEntitiesKeyword() {
// $k = $this->MatchReg('/\\G[_A-Za-z-][_A-Za-z0-9-]*/');
$k = $this->MatchReg( '/\\G%|\\G[_A-Za-z-][_A-Za-z0-9-]*/' );
if ( $k ) {
$k = $k[0];
$color = $this->fromKeyword( $k );
if ( $color ) {
return $color;
}
return $this->NewObj1( 'Less_Tree_Keyword', $k );
}
}
// duplicate of Less_Tree_Color::FromKeyword
private function FromKeyword( $keyword ) {
$keyword = strtolower( $keyword );
if ( Less_Colors::hasOwnProperty( $keyword ) ) {
// detect named color
return $this->NewObj1( 'Less_Tree_Color', substr( Less_Colors::color( $keyword ), 1 ) );
}
if ( $keyword === 'transparent' ) {
return $this->NewObj3( 'Less_Tree_Color', array( array( 0, 0, 0 ), 0, true ) );
}
}
//
// A function call
//
// rgb(255, 0, 255)
//
// We also try to catch IE's `alpha()`, but let the `alpha` parser
// deal with the details.
//
// The arguments are parsed with the `entities.arguments` parser.
//
private function parseEntitiesCall() {
$index = $this->pos;
if ( !preg_match( '/\\G([\w-]+|%|progid:[\w\.]+)\(/', $this->input, $name, 0, $this->pos ) ) {
return;
}
$name = $name[1];
$nameLC = strtolower( $name );
if ( $nameLC === 'url' ) {
return null;
}
$this->pos += strlen( $name );
if ( $nameLC === 'alpha' ) {
$alpha_ret = $this->parseAlpha();
if ( $alpha_ret ) {
return $alpha_ret;
}
}
$this->MatchChar( '(' ); // Parse the '(' and consume whitespace.
$args = $this->parseEntitiesArguments();
if ( !$this->MatchChar( ')' ) ) {
return;
}
if ( $name ) {
return $this->NewObj4( 'Less_Tree_Call', array( $name, $args, $index, $this->env->currentFileInfo ) );
}
}
/**
* Parse a list of arguments
*
* @return array
*/
private function parseEntitiesArguments() {
$args = array();
while ( true ) {
$arg = $this->MatchFuncs( array( 'parseEntitiesAssignment','parseExpression' ) );
if ( !$arg ) {
break;
}
$args[] = $arg;
if ( !$this->MatchChar( ',' ) ) {
break;
}
}
return $args;
}
private function parseEntitiesLiteral() {
return $this->MatchFuncs( array( 'parseEntitiesDimension','parseEntitiesColor','parseEntitiesQuoted','parseUnicodeDescriptor' ) );
}
// Assignments are argument entities for calls.
// They are present in ie filter properties as shown below.
//
// filter: progid:DXImageTransform.Microsoft.Alpha( *opacity=50* )
//
private function parseEntitiesAssignment() {
$key = $this->MatchReg( '/\\G\w+(?=\s?=)/' );
if ( !$key ) {
return;
}
if ( !$this->MatchChar( '=' ) ) {
return;
}
$value = $this->parseEntity();
if ( $value ) {
return $this->NewObj2( 'Less_Tree_Assignment', array( $key[0], $value ) );
}
}
//
// Parse url() tokens
//
// We use a specific rule for urls, because they don't really behave like
// standard function calls. The difference is that the argument doesn't have
// to be enclosed within a string, so it can't be parsed as an Expression.
//
private function parseEntitiesUrl() {
if ( $this->input[$this->pos] !== 'u' || !$this->matchReg( '/\\Gurl\(/' ) ) {
return;
}
$value = $this->match( array( 'parseEntitiesQuoted','parseEntitiesVariable','/\\Gdata\:.*?[^\)]+/','/\\G(?:(?:\\\\[\(\)\'"])|[^\(\)\'"])+/' ) );
if ( !$value ) {
$value = '';
}
$this->expectChar( ')' );
if ( isset( $value->value ) || $value instanceof Less_Tree_Variable ) {
return $this->NewObj2( 'Less_Tree_Url', array( $value, $this->env->currentFileInfo ) );
}
return $this->NewObj2( 'Less_Tree_Url', array( $this->NewObj1( 'Less_Tree_Anonymous', $value ), $this->env->currentFileInfo ) );
}
//
// A Variable entity, such as `@fink`, in
//
// width: @fink + 2px
//
// We use a different parser for variable definitions,
// see `parsers.variable`.
//
private function parseEntitiesVariable() {
$index = $this->pos;
if ( $this->PeekChar( '@' ) && ( $name = $this->MatchReg( '/\\G@@?[\w-]+/' ) ) ) {
return $this->NewObj3( 'Less_Tree_Variable', array( $name[0], $index, $this->env->currentFileInfo ) );
}
}
// A variable entity using the protective {} e.g. @{var}
private function parseEntitiesVariableCurly() {
$index = $this->pos;
if ( $this->input_len > ( $this->pos + 1 ) && $this->input[$this->pos] === '@' && ( $curly = $this->MatchReg( '/\\G@\{([\w-]+)\}/' ) ) ) {
return $this->NewObj3( 'Less_Tree_Variable', array( '@'.$curly[1], $index, $this->env->currentFileInfo ) );
}
}
//
// A Hexadecimal color
//
// #4F3C2F
//
// `rgb` and `hsl` colors are parsed through the `entities.call` parser.
//
private function parseEntitiesColor() {
if ( $this->PeekChar( '#' ) && ( $rgb = $this->MatchReg( '/\\G#([A-Fa-f0-9]{6}|[A-Fa-f0-9]{3})/' ) ) ) {
return $this->NewObj1( 'Less_Tree_Color', $rgb[1] );
}
}
//
// A Dimension, that is, a number and a unit
//
// 0.5em 95%
//
private function parseEntitiesDimension() {
$c = @ord( $this->input[$this->pos] );
// Is the first char of the dimension 0-9, '.', '+' or '-'
if ( ( $c > 57 || $c < 43 ) || $c === 47 || $c == 44 ) {
return;
}
$value = $this->MatchReg( '/\\G([+-]?\d*\.?\d+)(%|[a-z]+)?/' );
if ( $value ) {
if ( isset( $value[2] ) ) {
return $this->NewObj2( 'Less_Tree_Dimension', array( $value[1],$value[2] ) );
}
return $this->NewObj1( 'Less_Tree_Dimension', $value[1] );
}
}
//
// A unicode descriptor, as is used in unicode-range
//
// U+0?? or U+00A1-00A9
//
function parseUnicodeDescriptor() {
$ud = $this->MatchReg( '/\\G(U\+[0-9a-fA-F?]+)(\-[0-9a-fA-F?]+)?/' );
if ( $ud ) {
return $this->NewObj1( 'Less_Tree_UnicodeDescriptor', $ud[0] );
}
}
//
// JavaScript code to be evaluated
//
// `window.location.href`
//
private function parseEntitiesJavascript() {
$e = false;
$j = $this->pos;
if ( $this->input[$j] === '~' ) {
$j++;
$e = true;
}
if ( $this->input[$j] !== '`' ) {
return;
}
if ( $e ) {
$this->MatchChar( '~' );
}
$str = $this->MatchReg( '/\\G`([^`]*)`/' );
if ( $str ) {
return $this->NewObj3( 'Less_Tree_Javascript', array( $str[1], $this->pos, $e ) );
}
}
//
// The variable part of a variable definition. Used in the `rule` parser
//
// @fink:
//
private function parseVariable() {
if ( $this->PeekChar( '@' ) && ( $name = $this->MatchReg( '/\\G(@[\w-]+)\s*:/' ) ) ) {
return $name[1];
}
}
//
// The variable part of a variable definition. Used in the `rule` parser
//
// @fink();
//
private function parseRulesetCall() {
if ( $this->input[$this->pos] === '@' && ( $name = $this->MatchReg( '/\\G(@[\w-]+)\s*\(\s*\)\s*;/' ) ) ) {
return $this->NewObj1( 'Less_Tree_RulesetCall', $name[1] );
}
}
//
// extend syntax - used to extend selectors
//
function parseExtend( $isRule = false ) {
$index = $this->pos;
$extendList = array();
if ( !$this->MatchReg( $isRule ? '/\\G&:extend\(/' : '/\\G:extend\(/' ) ) { return;
}
do{
$option = null;
$elements = array();
while ( true ) {
$option = $this->MatchReg( '/\\G(all)(?=\s*(\)|,))/' );
if ( $option ) { break;
}
$e = $this->parseElement();
if ( !$e ) { break;
}
$elements[] = $e;
}
if ( $option ) {
$option = $option[1];
}
$extendList[] = $this->NewObj3( 'Less_Tree_Extend', array( $this->NewObj1( 'Less_Tree_Selector', $elements ), $option, $index ) );
}while ( $this->MatchChar( "," ) );
$this->expect( '/\\G\)/' );
if ( $isRule ) {
$this->expect( '/\\G;/' );
}
return $extendList;
}
//
// A Mixin call, with an optional argument list
//
// #mixins > .square(#fff);
// .rounded(4px, black);
// .button;
//
// The `while` loop is there because mixins can be
// namespaced, but we only support the child and descendant
// selector for now.
//
private function parseMixinCall() {
$char = $this->input[$this->pos];
if ( $char !== '.' && $char !== '#' ) {
return;
}
$index = $this->pos;
$this->save(); // stop us absorbing part of an invalid selector
$elements = $this->parseMixinCallElements();
if ( $elements ) {
if ( $this->MatchChar( '(' ) ) {
$returned = $this->parseMixinArgs( true );
$args = $returned['args'];
$this->expectChar( ')' );
} else {
$args = array();
}
$important = $this->parseImportant();
if ( $this->parseEnd() ) {
$this->forget();
return $this->NewObj5( 'Less_Tree_Mixin_Call', array( $elements, $args, $index, $this->env->currentFileInfo, $important ) );
}
}
$this->restore();
}
private function parseMixinCallElements() {
$elements = array();
$c = null;
while ( true ) {
$elemIndex = $this->pos;
$e = $this->MatchReg( '/\\G[#.](?:[\w-]|\\\\(?:[A-Fa-f0-9]{1,6} ?|[^A-Fa-f0-9]))+/' );
if ( !$e ) {
break;
}
$elements[] = $this->NewObj4( 'Less_Tree_Element', array( $c, $e[0], $elemIndex, $this->env->currentFileInfo ) );
$c = $this->MatchChar( '>' );
}
return $elements;
}
/**
* @param boolean $isCall
*/
private function parseMixinArgs( $isCall ) {
$expressions = array();
$argsSemiColon = array();
$isSemiColonSeperated = null;
$argsComma = array();
$expressionContainsNamed = null;
$name = null;
$returner = array( 'args' => array(), 'variadic' => false );
$this->save();
while ( true ) {
if ( $isCall ) {
$arg = $this->MatchFuncs( array( 'parseDetachedRuleset','parseExpression' ) );
} else {
$this->parseComments();
if ( $this->input[ $this->pos ] === '.' && $this->MatchReg( '/\\G\.{3}/' ) ) {
$returner['variadic'] = true;
if ( $this->MatchChar( ";" ) && !$isSemiColonSeperated ) {
$isSemiColonSeperated = true;
}
if ( $isSemiColonSeperated ) {
$argsSemiColon[] = array( 'variadic' => true );
} else {
$argsComma[] = array( 'variadic' => true );
}
break;
}
$arg = $this->MatchFuncs( array( 'parseEntitiesVariable','parseEntitiesLiteral','parseEntitiesKeyword' ) );
}
if ( !$arg ) {
break;
}
$nameLoop = null;
if ( $arg instanceof Less_Tree_Expression ) {
$arg->throwAwayComments();
}
$value = $arg;
$val = null;
if ( $isCall ) {
// Variable
if ( property_exists( $arg, 'value' ) && count( $arg->value ) == 1 ) {
$val = $arg->value[0];
}
} else {
$val = $arg;
}
if ( $val instanceof Less_Tree_Variable ) {
if ( $this->MatchChar( ':' ) ) {
if ( $expressions ) {
if ( $isSemiColonSeperated ) {
$this->Error( 'Cannot mix ; and , as delimiter types' );
}
$expressionContainsNamed = true;
}
// we do not support setting a ruleset as a default variable - it doesn't make sense
// However if we do want to add it, there is nothing blocking it, just don't error
// and remove isCall dependency below
$value = null;
if ( $isCall ) {
$value = $this->parseDetachedRuleset();
}
if ( !$value ) {
$value = $this->parseExpression();
}
if ( !$value ) {
if ( $isCall ) {
$this->Error( 'could not understand value for named argument' );
} else {
$this->restore();
$returner['args'] = array();
return $returner;
}
}
$nameLoop = ( $name = $val->name );
} elseif ( !$isCall && $this->MatchReg( '/\\G\.{3}/' ) ) {
$returner['variadic'] = true;
if ( $this->MatchChar( ";" ) && !$isSemiColonSeperated ) {
$isSemiColonSeperated = true;
}
if ( $isSemiColonSeperated ) {
$argsSemiColon[] = array( 'name' => $arg->name, 'variadic' => true );
} else {
$argsComma[] = array( 'name' => $arg->name, 'variadic' => true );
}
break;
} elseif ( !$isCall ) {
$name = $nameLoop = $val->name;
$value = null;
}
}
if ( $value ) {
$expressions[] = $value;
}
$argsComma[] = array( 'name' => $nameLoop, 'value' => $value );
if ( $this->MatchChar( ',' ) ) {
continue;
}
if ( $this->MatchChar( ';' ) || $isSemiColonSeperated ) {
if ( $expressionContainsNamed ) {
$this->Error( 'Cannot mix ; and , as delimiter types' );
}
$isSemiColonSeperated = true;
if ( count( $expressions ) > 1 ) {
$value = $this->NewObj1( 'Less_Tree_Value', $expressions );
}
$argsSemiColon[] = array( 'name' => $name, 'value' => $value );
$name = null;
$expressions = array();
$expressionContainsNamed = false;
}
}
$this->forget();
$returner['args'] = ( $isSemiColonSeperated ? $argsSemiColon : $argsComma );
return $returner;
}
//
// A Mixin definition, with a list of parameters
//
// .rounded (@radius: 2px, @color) {
// ...
// }
//
// Until we have a finer grained state-machine, we have to
// do a look-ahead, to make sure we don't have a mixin call.
// See the `rule` function for more information.
//
// We start by matching `.rounded (`, and then proceed on to
// the argument list, which has optional default values.
// We store the parameters in `params`, with a `value` key,
// if there is a value, such as in the case of `@radius`.
//
// Once we've got our params list, and a closing `)`, we parse
// the `{...}` block.
//
private function parseMixinDefinition() {
$cond = null;
$char = $this->input[$this->pos];
if ( ( $char !== '.' && $char !== '#' ) || ( $char === '{' && $this->PeekReg( '/\\G[^{]*\}/' ) ) ) {
return;
}
$this->save();
$match = $this->MatchReg( '/\\G([#.](?:[\w-]|\\\(?:[A-Fa-f0-9]{1,6} ?|[^A-Fa-f0-9]))+)\s*\(/' );
if ( $match ) {
$name = $match[1];
$argInfo = $this->parseMixinArgs( false );
$params = $argInfo['args'];
$variadic = $argInfo['variadic'];
// .mixincall("@{a}");
// looks a bit like a mixin definition..
// also
// .mixincall(@a: {rule: set;});
// so we have to be nice and restore
if ( !$this->MatchChar( ')' ) ) {
$this->furthest = $this->pos;
$this->restore();
return;
}
$this->parseComments();
if ( $this->MatchReg( '/\\Gwhen/' ) ) { // Guard
$cond = $this->expect( 'parseConditions', 'Expected conditions' );
}
$ruleset = $this->parseBlock();
if ( is_array( $ruleset ) ) {
$this->forget();
return $this->NewObj5( 'Less_Tree_Mixin_Definition', array( $name, $params, $ruleset, $cond, $variadic ) );
}
$this->restore();
} else {
$this->forget();
}
}
//
// Entities are the smallest recognized token,
// and can be found inside a rule's value.
//
private function parseEntity() {
return $this->MatchFuncs( array( 'parseEntitiesLiteral','parseEntitiesVariable','parseEntitiesUrl','parseEntitiesCall','parseEntitiesKeyword','parseEntitiesJavascript','parseComment' ) );
}
//
// A Rule terminator. Note that we use `peek()` to check for '}',
// because the `block` rule will be expecting it, but we still need to make sure
// it's there, if ';' was omitted.
//
private function parseEnd() {
return $this->MatchChar( ';' ) || $this->PeekChar( '}' );
}
//
// IE's alpha function
//
// alpha(opacity=88)
//
private function parseAlpha() {
if ( !$this->MatchReg( '/\\G\(opacity=/i' ) ) {
return;
}
$value = $this->MatchReg( '/\\G[0-9]+/' );
if ( $value ) {
$value = $value[0];
} else {
$value = $this->parseEntitiesVariable();
if ( !$value ) {
return;
}
}
$this->expectChar( ')' );
return $this->NewObj1( 'Less_Tree_Alpha', $value );
}
//
// A Selector Element
//
// div
// + h1
// #socks
// input[type="text"]
//
// Elements are the building blocks for Selectors,
// they are made out of a `Combinator` (see combinator rule),
// and an element name, such as a tag a class, or `*`.
//
private function parseElement() {
$c = $this->parseCombinator();
$index = $this->pos;
$e = $this->match( array( '/\\G(?:\d+\.\d+|\d+)%/', '/\\G(?:[.#]?|:*)(?:[\w-]|[^\x00-\x9f]|\\\\(?:[A-Fa-f0-9]{1,6} ?|[^A-Fa-f0-9]))+/',
'#*', '#&', 'parseAttribute', '/\\G\([^()@]+\)/', '/\\G[\.#](?=@)/', 'parseEntitiesVariableCurly' ) );
if ( is_null( $e ) ) {
$this->save();
if ( $this->MatchChar( '(' ) ) {
if ( ( $v = $this->parseSelector() ) && $this->MatchChar( ')' ) ) {
$e = $this->NewObj1( 'Less_Tree_Paren', $v );
$this->forget();
} else {
$this->restore();
}
} else {
$this->forget();
}
}
if ( !is_null( $e ) ) {
return $this->NewObj4( 'Less_Tree_Element', array( $c, $e, $index, $this->env->currentFileInfo ) );
}
}
//
// Combinators combine elements together, in a Selector.
//
// Because our parser isn't white-space sensitive, special care
// has to be taken, when parsing the descendant combinator, ` `,
// as it's an empty space. We have to check the previous character
// in the input, to see if it's a ` ` character.
//
private function parseCombinator() {
if ( $this->pos < $this->input_len ) {
$c = $this->input[$this->pos];
if ( $c === '>' || $c === '+' || $c === '~' || $c === '|' || $c === '^' ) {
$this->pos++;
if ( $this->input[$this->pos] === '^' ) {
$c = '^^';
$this->pos++;
}
$this->skipWhitespace( 0 );
return $c;
}
if ( $this->pos > 0 && $this->isWhitespace( -1 ) ) {
return ' ';
}
}
}
//
// A CSS selector (see selector below)
// with less extensions e.g. the ability to extend and guard
//
private function parseLessSelector() {
return $this->parseSelector( true );
}
//
// A CSS Selector
//
// .class > div + h1
// li a:hover
//
// Selectors are made out of one or more Elements, see above.
//
private function parseSelector( $isLess = false ) {
$elements = array();
$extendList = array();
$condition = null;
$when = false;
$extend = false;
$e = null;
$c = null;
$index = $this->pos;
while ( ( $isLess && ( $extend = $this->parseExtend() ) ) || ( $isLess && ( $when = $this->MatchReg( '/\\Gwhen/' ) ) ) || ( $e = $this->parseElement() ) ) {
if ( $when ) {
$condition = $this->expect( 'parseConditions', 'expected condition' );
} elseif ( $condition ) {
// error("CSS guard can only be used at the end of selector");
} elseif ( $extend ) {
$extendList = array_merge( $extendList, $extend );
} else {
// if( count($extendList) ){
//error("Extend can only be used at the end of selector");
//}
if ( $this->pos < $this->input_len ) {
$c = $this->input[ $this->pos ];
}
$elements[] = $e;
$e = null;
}
if ( $c === '{' || $c === '}' || $c === ';' || $c === ',' || $c === ')' ) { break;
}
}
if ( $elements ) {
return $this->NewObj5( 'Less_Tree_Selector', array( $elements, $extendList, $condition, $index, $this->env->currentFileInfo ) );
}
if ( $extendList ) {
$this->Error( 'Extend must be used to extend a selector, it cannot be used on its own' );
}
}
private function parseTag() {
return ( $tag = $this->MatchReg( '/\\G[A-Za-z][A-Za-z-]*[0-9]?/' ) ) ? $tag : $this->MatchChar( '*' );
}
private function parseAttribute() {
$val = null;
if ( !$this->MatchChar( '[' ) ) {
return;
}
$key = $this->parseEntitiesVariableCurly();
if ( !$key ) {
$key = $this->expect( '/\\G(?:[_A-Za-z0-9-\*]*\|)?(?:[_A-Za-z0-9-]|\\\\.)+/' );
}
$op = $this->MatchReg( '/\\G[|~*$^]?=/' );
if ( $op ) {
$val = $this->match( array( 'parseEntitiesQuoted','/\\G[0-9]+%/','/\\G[\w-]+/','parseEntitiesVariableCurly' ) );
}
$this->expectChar( ']' );
return $this->NewObj3( 'Less_Tree_Attribute', array( $key, $op === null ? null : $op[0], $val ) );
}
//
// The `block` rule is used by `ruleset` and `mixin.definition`.
// It's a wrapper around the `primary` rule, with added `{}`.
//
private function parseBlock() {
if ( $this->MatchChar( '{' ) ) {
$content = $this->parsePrimary();
if ( $this->MatchChar( '}' ) ) {
return $content;
}
}
}
private function parseBlockRuleset() {
$block = $this->parseBlock();
if ( $block ) {
$block = $this->NewObj2( 'Less_Tree_Ruleset', array( null, $block ) );
}
return $block;
}
private function parseDetachedRuleset() {
$blockRuleset = $this->parseBlockRuleset();
if ( $blockRuleset ) {
return $this->NewObj1( 'Less_Tree_DetachedRuleset', $blockRuleset );
}
}
//
// div, .class, body > p {...}
//
private function parseRuleset() {
$selectors = array();
$this->save();
while ( true ) {
$s = $this->parseLessSelector();
if ( !$s ) {
break;
}
$selectors[] = $s;
$this->parseComments();
if ( $s->condition && count( $selectors ) > 1 ) {
$this->Error( 'Guards are only currently allowed on a single selector.' );
}
if ( !$this->MatchChar( ',' ) ) {
break;
}
if ( $s->condition ) {
$this->Error( 'Guards are only currently allowed on a single selector.' );
}
$this->parseComments();
}
if ( $selectors ) {
$rules = $this->parseBlock();
if ( is_array( $rules ) ) {
$this->forget();
return $this->NewObj2( 'Less_Tree_Ruleset', array( $selectors, $rules ) ); // Less_Environment::$strictImports
}
}
// Backtrack
$this->furthest = $this->pos;
$this->restore();
}
/**
* Custom less.php parse function for finding simple name-value css pairs
* ex: width:100px;
*
*/
private function parseNameValue() {
$index = $this->pos;
$this->save();
// $match = $this->MatchReg('/\\G([a-zA-Z\-]+)\s*:\s*((?:\'")?[a-zA-Z0-9\-% \.,!]+?(?:\'")?)\s*([;}])/');
$match = $this->MatchReg( '/\\G([a-zA-Z\-]+)\s*:\s*([\'"]?[#a-zA-Z0-9\-%\.,]+?[\'"]?) *(! *important)?\s*([;}])/' );
if ( $match ) {
if ( $match[4] == '}' ) {
$this->pos = $index + strlen( $match[0] ) - 1;
}
if ( $match[3] ) {
$match[2] .= ' !important';
}
return $this->NewObj4( 'Less_Tree_NameValue', array( $match[1], $match[2], $index, $this->env->currentFileInfo ) );
}
$this->restore();
}
private function parseRule( $tryAnonymous = null ) {
$merge = false;
$startOfRule = $this->pos;
$c = $this->input[$this->pos];
if ( $c === '.' || $c === '#' || $c === '&' ) {
return;
}
$this->save();
$name = $this->MatchFuncs( array( 'parseVariable','parseRuleProperty' ) );
if ( $name ) {
$isVariable = is_string( $name );
$value = null;
if ( $isVariable ) {
$value = $this->parseDetachedRuleset();
}
$important = null;
if ( !$value ) {
// prefer to try to parse first if its a variable or we are compressing
// but always fallback on the other one
//if( !$tryAnonymous && is_string($name) && $name[0] === '@' ){
if ( !$tryAnonymous && ( Less_Parser::$options['compress'] || $isVariable ) ) {
$value = $this->MatchFuncs( array( 'parseValue','parseAnonymousValue' ) );
} else {
$value = $this->MatchFuncs( array( 'parseAnonymousValue','parseValue' ) );
}
$important = $this->parseImportant();
// a name returned by this.ruleProperty() is always an array of the form:
// [string-1, ..., string-n, ""] or [string-1, ..., string-n, "+"]
// where each item is a tree.Keyword or tree.Variable
if ( !$isVariable && is_array( $name ) ) {
$nm = array_pop( $name );
if ( $nm->value ) {
$merge = $nm->value;
}
}
}
if ( $value && $this->parseEnd() ) {
$this->forget();
return $this->NewObj6( 'Less_Tree_Rule', array( $name, $value, $important, $merge, $startOfRule, $this->env->currentFileInfo ) );
} else {
$this->furthest = $this->pos;
$this->restore();
if ( $value && !$tryAnonymous ) {
return $this->parseRule( true );
}
}
} else {
$this->forget();
}
}
function parseAnonymousValue() {
if ( preg_match( '/\\G([^@+\/\'"*`(;{}-]*);/', $this->input, $match, 0, $this->pos ) ) {
$this->pos += strlen( $match[1] );
return $this->NewObj1( 'Less_Tree_Anonymous', $match[1] );
}
}
//
// An @import directive
//
// @import "lib";
//
// Depending on our environment, importing is done differently:
// In the browser, it's an XHR request, in Node, it would be a
// file-system operation. The function used for importing is
// stored in `import`, which we pass to the Import constructor.
//
private function parseImport() {
$this->save();
$dir = $this->MatchReg( '/\\G@import?\s+/' );
if ( $dir ) {
$options = $this->parseImportOptions();
$path = $this->MatchFuncs( array( 'parseEntitiesQuoted','parseEntitiesUrl' ) );
if ( $path ) {
$features = $this->parseMediaFeatures();
if ( $this->MatchChar( ';' ) ) {
if ( $features ) {
$features = $this->NewObj1( 'Less_Tree_Value', $features );
}
$this->forget();
return $this->NewObj5( 'Less_Tree_Import', array( $path, $features, $options, $this->pos, $this->env->currentFileInfo ) );
}
}
}
$this->restore();
}
private function parseImportOptions() {
$options = array();
// list of options, surrounded by parens
if ( !$this->MatchChar( '(' ) ) {
return $options;
}
do{
$optionName = $this->parseImportOption();
if ( $optionName ) {
$value = true;
switch ( $optionName ) {
case "css":
$optionName = "less";
$value = false;
break;
case "once":
$optionName = "multiple";
$value = false;
break;
}
$options[$optionName] = $value;
if ( !$this->MatchChar( ',' ) ) { break;
}
}
}while ( $optionName );
$this->expectChar( ')' );
return $options;
}
private function parseImportOption() {
$opt = $this->MatchReg( '/\\G(less|css|multiple|once|inline|reference|optional)/' );
if ( $opt ) {
return $opt[1];
}
}
private function parseMediaFeature() {
$nodes = array();
do{
$e = $this->MatchFuncs( array( 'parseEntitiesKeyword','parseEntitiesVariable' ) );
if ( $e ) {
$nodes[] = $e;
} elseif ( $this->MatchChar( '(' ) ) {
$p = $this->parseProperty();
$e = $this->parseValue();
if ( $this->MatchChar( ')' ) ) {
if ( $p && $e ) {
$r = $this->NewObj7( 'Less_Tree_Rule', array( $p, $e, null, null, $this->pos, $this->env->currentFileInfo, true ) );
$nodes[] = $this->NewObj1( 'Less_Tree_Paren', $r );
} elseif ( $e ) {
$nodes[] = $this->NewObj1( 'Less_Tree_Paren', $e );
} else {
return null;
}
} else return null;
}
} while ( $e );
if ( $nodes ) {
return $this->NewObj1( 'Less_Tree_Expression', $nodes );
}
}
private function parseMediaFeatures() {
$features = array();
do{
$e = $this->parseMediaFeature();
if ( $e ) {
$features[] = $e;
if ( !$this->MatchChar( ',' ) ) break;
} else {
$e = $this->parseEntitiesVariable();
if ( $e ) {
$features[] = $e;
if ( !$this->MatchChar( ',' ) ) break;
}
}
} while ( $e );
return $features ? $features : null;
}
private function parseMedia() {
if ( $this->MatchReg( '/\\G@media/' ) ) {
$features = $this->parseMediaFeatures();
$rules = $this->parseBlock();
if ( is_array( $rules ) ) {
return $this->NewObj4( 'Less_Tree_Media', array( $rules, $features, $this->pos, $this->env->currentFileInfo ) );
}
}
}
//
// A CSS Directive
//
// @charset "utf-8";
//
private function parseDirective() {
if ( !$this->PeekChar( '@' ) ) {
return;
}
$rules = null;
$index = $this->pos;
$hasBlock = true;
$hasIdentifier = false;
$hasExpression = false;
$hasUnknown = false;
$value = $this->MatchFuncs( array( 'parseImport','parseMedia' ) );
if ( $value ) {
return $value;
}
$this->save();
$name = $this->MatchReg( '/\\G@[a-z-]+/' );
if ( !$name ) return;
$name = $name[0];
$nonVendorSpecificName = $name;
$pos = strpos( $name, '-', 2 );
if ( $name[1] == '-' && $pos > 0 ) {
$nonVendorSpecificName = "@" . substr( $name, $pos + 1 );
}
switch ( $nonVendorSpecificName ) {
/*
case "@font-face":
case "@viewport":
case "@top-left":
case "@top-left-corner":
case "@top-center":
case "@top-right":
case "@top-right-corner":
case "@bottom-left":
case "@bottom-left-corner":
case "@bottom-center":
case "@bottom-right":
case "@bottom-right-corner":
case "@left-top":
case "@left-middle":
case "@left-bottom":
case "@right-top":
case "@right-middle":
case "@right-bottom":
hasBlock = true;
break;
*/
case "@charset":
$hasIdentifier = true;
$hasBlock = false;
break;
case "@namespace":
$hasExpression = true;
$hasBlock = false;
break;
case "@keyframes":
$hasIdentifier = true;
break;
case "@host":
case "@page":
case "@document":
case "@supports":
$hasUnknown = true;
break;
}
if ( $hasIdentifier ) {
$value = $this->parseEntity();
if ( !$value ) {
$this->error( "expected " . $name . " identifier" );
}
} else if ( $hasExpression ) {
$value = $this->parseExpression();
if ( !$value ) {
$this->error( "expected " . $name. " expression" );
}
} else if ( $hasUnknown ) {
$value = $this->MatchReg( '/\\G[^{;]+/' );
if ( $value ) {
$value = $this->NewObj1( 'Less_Tree_Anonymous', trim( $value[0] ) );
}
}
if ( $hasBlock ) {
$rules = $this->parseBlockRuleset();
}
if ( $rules || ( !$hasBlock && $value && $this->MatchChar( ';' ) ) ) {
$this->forget();
return $this->NewObj5( 'Less_Tree_Directive', array( $name, $value, $rules, $index, $this->env->currentFileInfo ) );
}
$this->restore();
}
//
// A Value is a comma-delimited list of Expressions
//
// font-family: Baskerville, Georgia, serif;
//
// In a Rule, a Value represents everything after the `:`,
// and before the `;`.
//
private function parseValue() {
$expressions = array();
do{
$e = $this->parseExpression();
if ( $e ) {
$expressions[] = $e;
if ( !$this->MatchChar( ',' ) ) {
break;
}
}
}while ( $e );
if ( $expressions ) {
return $this->NewObj1( 'Less_Tree_Value', $expressions );
}
}
private function parseImportant() {
if ( $this->PeekChar( '!' ) && $this->MatchReg( '/\\G! *important/' ) ) {
return ' !important';
}
}
private function parseSub() {
if ( $this->MatchChar( '(' ) ) {
$a = $this->parseAddition();
if ( $a ) {
$this->expectChar( ')' );
return $this->NewObj2( 'Less_Tree_Expression', array( array( $a ), true ) ); // instead of $e->parens = true so the value is cached
}
}
}
/**
* Parses multiplication operation
*
* @return Less_Tree_Operation|null
*/
function parseMultiplication() {
$return = $m = $this->parseOperand();
if ( $return ) {
while ( true ) {
$isSpaced = $this->isWhitespace( -1 );
if ( $this->PeekReg( '/\\G\/[*\/]/' ) ) {
break;
}
$op = $this->MatchChar( '/' );
if ( !$op ) {
$op = $this->MatchChar( '*' );
if ( !$op ) {
break;
}
}
$a = $this->parseOperand();
if ( !$a ) { break;
}
$m->parensInOp = true;
$a->parensInOp = true;
$return = $this->NewObj3( 'Less_Tree_Operation', array( $op, array( $return, $a ), $isSpaced ) );
}
}
return $return;
}
/**
* Parses an addition operation
*
* @return Less_Tree_Operation|null
*/
private function parseAddition() {
$return = $m = $this->parseMultiplication();
if ( $return ) {
while ( true ) {
$isSpaced = $this->isWhitespace( -1 );
$op = $this->MatchReg( '/\\G[-+]\s+/' );
if ( $op ) {
$op = $op[0];
} else {
if ( !$isSpaced ) {
$op = $this->match( array( '#+','#-' ) );
}
if ( !$op ) {
break;
}
}
$a = $this->parseMultiplication();
if ( !$a ) {
break;
}
$m->parensInOp = true;
$a->parensInOp = true;
$return = $this->NewObj3( 'Less_Tree_Operation', array( $op, array( $return, $a ), $isSpaced ) );
}
}
return $return;
}
/**
* Parses the conditions
*
* @return Less_Tree_Condition|null
*/
private function parseConditions() {
$index = $this->pos;
$return = $a = $this->parseCondition();
if ( $a ) {
while ( true ) {
if ( !$this->PeekReg( '/\\G,\s*(not\s*)?\(/' ) || !$this->MatchChar( ',' ) ) {
break;
}
$b = $this->parseCondition();
if ( !$b ) {
break;
}
$return = $this->NewObj4( 'Less_Tree_Condition', array( 'or', $return, $b, $index ) );
}
return $return;
}
}
private function parseCondition() {
$index = $this->pos;
$negate = false;
$c = null;
if ( $this->MatchReg( '/\\Gnot/' ) ) $negate = true;
$this->expectChar( '(' );
$a = $this->MatchFuncs( array( 'parseAddition','parseEntitiesKeyword','parseEntitiesQuoted' ) );
if ( $a ) {
$op = $this->MatchReg( '/\\G(?:>=|<=|=<|[<=>])/' );
if ( $op ) {
$b = $this->MatchFuncs( array( 'parseAddition','parseEntitiesKeyword','parseEntitiesQuoted' ) );
if ( $b ) {
$c = $this->NewObj5( 'Less_Tree_Condition', array( $op[0], $a, $b, $index, $negate ) );
} else {
$this->Error( 'Unexpected expression' );
}
} else {
$k = $this->NewObj1( 'Less_Tree_Keyword', 'true' );
$c = $this->NewObj5( 'Less_Tree_Condition', array( '=', $a, $k, $index, $negate ) );
}
$this->expectChar( ')' );
return $this->MatchReg( '/\\Gand/' ) ? $this->NewObj3( 'Less_Tree_Condition', array( 'and', $c, $this->parseCondition() ) ) : $c;
}
}
/**
* An operand is anything that can be part of an operation,
* such as a Color, or a Variable
*
*/
private function parseOperand() {
$negate = false;
$offset = $this->pos + 1;
if ( $offset >= $this->input_len ) {
return;
}
$char = $this->input[$offset];
if ( $char === '@' || $char === '(' ) {
$negate = $this->MatchChar( '-' );
}
$o = $this->MatchFuncs( array( 'parseSub','parseEntitiesDimension','parseEntitiesColor','parseEntitiesVariable','parseEntitiesCall' ) );
if ( $negate ) {
$o->parensInOp = true;
$o = $this->NewObj1( 'Less_Tree_Negative', $o );
}
return $o;
}
/**
* Expressions either represent mathematical operations,
* or white-space delimited Entities.
*
* 1px solid black
* @var * 2
*
* @return Less_Tree_Expression|null
*/
private function parseExpression() {
$entities = array();
do{
$e = $this->MatchFuncs( array( 'parseAddition','parseEntity' ) );
if ( $e ) {
$entities[] = $e;
// operations do not allow keyword "/" dimension (e.g. small/20px) so we support that here
if ( !$this->PeekReg( '/\\G\/[\/*]/' ) ) {
$delim = $this->MatchChar( '/' );
if ( $delim ) {
$entities[] = $this->NewObj1( 'Less_Tree_Anonymous', $delim );
}
}
}
}while ( $e );
if ( $entities ) {
return $this->NewObj1( 'Less_Tree_Expression', $entities );
}
}
/**
* Parse a property
* eg: 'min-width', 'orientation', etc
*
* @return string
*/
private function parseProperty() {
$name = $this->MatchReg( '/\\G(\*?-?[_a-zA-Z0-9-]+)\s*:/' );
if ( $name ) {
return $name[1];
}
}
/**
* Parse a rule property
* eg: 'color', 'width', 'height', etc
*
* @return string
*/
private function parseRuleProperty() {
$offset = $this->pos;
$name = array();
$index = array();
$length = 0;
$this->rulePropertyMatch( '/\\G(\*?)/', $offset, $length, $index, $name );
while ( $this->rulePropertyMatch( '/\\G((?:[\w-]+)|(?:@\{[\w-]+\}))/', $offset, $length, $index, $name ) ); // !
if ( ( count( $name ) > 1 ) && $this->rulePropertyMatch( '/\\G\s*((?:\+_|\+)?)\s*:/', $offset, $length, $index, $name ) ) {
// at last, we have the complete match now. move forward,
// convert name particles to tree objects and return:
$this->skipWhitespace( $length );
if ( $name[0] === '' ) {
array_shift( $name );
array_shift( $index );
}
foreach ( $name as $k => $s ) {
if ( !$s || $s[0] !== '@' ) {
$name[$k] = $this->NewObj1( 'Less_Tree_Keyword', $s );
} else {
$name[$k] = $this->NewObj3( 'Less_Tree_Variable', array( '@' . substr( $s, 2, -1 ), $index[$k], $this->env->currentFileInfo ) );
}
}
return $name;
}
}
private function rulePropertyMatch( $re, &$offset, &$length, &$index, &$name ) {
preg_match( $re, $this->input, $a, 0, $offset );
if ( $a ) {
$index[] = $this->pos + $length;
$length += strlen( $a[0] );
$offset += strlen( $a[0] );
$name[] = $a[1];
return true;
}
}
public static function serializeVars( $vars ) {
$s = '';
foreach ( $vars as $name => $value ) {
$s .= ( ( $name[0] === '@' ) ? '' : '@' ) . $name .': '. $value . ( ( substr( $value, -1 ) === ';' ) ? '' : ';' );
}
return $s;
}
/**
* Some versions of php have trouble with method_exists($a,$b) if $a is not an object
*
* @param string $b
*/
public static function is_method( $a, $b ) {
return is_object( $a ) && method_exists( $a, $b );
}
/**
* Round numbers similarly to javascript
* eg: 1.499999 to 1 instead of 2
*
*/
public static function round( $i, $precision = 0 ) {
$precision = pow( 10, $precision );
$i = $i * $precision;
$ceil = ceil( $i );
$floor = floor( $i );
if ( ( $ceil - $i ) <= ( $i - $floor ) ) {
return $ceil / $precision;
} else {
return $floor / $precision;
}
}
/**
* Create Less_Tree_* objects and optionally generate a cache string
*
* @return mixed
*/
public function NewObj0( $class ) {
$obj = new $class();
if ( $this->CacheEnabled() ) {
$obj->cache_string = ' new '.$class.'()';
}
return $obj;
}
public function NewObj1( $class, $arg ) {
$obj = new $class( $arg );
if ( $this->CacheEnabled() ) {
$obj->cache_string = ' new '.$class.'('.Less_Parser::ArgString( $arg ).')';
}
return $obj;
}
public function NewObj2( $class, $args ) {
$obj = new $class( $args[0], $args[1] );
if ( $this->CacheEnabled() ) {
$this->ObjCache( $obj, $class, $args );
}
return $obj;
}
public function NewObj3( $class, $args ) {
$obj = new $class( $args[0], $args[1], $args[2] );
if ( $this->CacheEnabled() ) {
$this->ObjCache( $obj, $class, $args );
}
return $obj;
}
public function NewObj4( $class, $args ) {
$obj = new $class( $args[0], $args[1], $args[2], $args[3] );
if ( $this->CacheEnabled() ) {
$this->ObjCache( $obj, $class, $args );
}
return $obj;
}
public function NewObj5( $class, $args ) {
$obj = new $class( $args[0], $args[1], $args[2], $args[3], $args[4] );
if ( $this->CacheEnabled() ) {
$this->ObjCache( $obj, $class, $args );
}
return $obj;
}
public function NewObj6( $class, $args ) {
$obj = new $class( $args[0], $args[1], $args[2], $args[3], $args[4], $args[5] );
if ( $this->CacheEnabled() ) {
$this->ObjCache( $obj, $class, $args );
}
return $obj;
}
public function NewObj7( $class, $args ) {
$obj = new $class( $args[0], $args[1], $args[2], $args[3], $args[4], $args[5], $args[6] );
if ( $this->CacheEnabled() ) {
$this->ObjCache( $obj, $class, $args );
}
return $obj;
}
// caching
public function ObjCache( $obj, $class, $args = array() ) {
$obj->cache_string = ' new '.$class.'('. self::ArgCache( $args ).')';
}
public function ArgCache( $args ) {
return implode( ',', array_map( array( 'Less_Parser','ArgString' ), $args ) );
}
/**
* Convert an argument to a string for use in the parser cache
*
* @return string
*/
public static function ArgString( $arg ) {
$type = gettype( $arg );
if ( $type === 'object' ) {
$string = $arg->cache_string;
unset( $arg->cache_string );
return $string;
} elseif ( $type === 'array' ) {
$string = ' Array(';
foreach ( $arg as $k => $a ) {
$string .= var_export( $k, true ).' => '.self::ArgString( $a ).',';
}
return $string . ')';
}
return var_export( $arg, true );
}
public function Error( $msg ) {
throw new Less_Exception_Parser( $msg, null, $this->furthest, $this->env->currentFileInfo );
}
public static function WinPath( $path ) {
return str_replace( '\\', '/', $path );
}
public static function AbsPath( $path, $winPath = false ) {
if ( strpos( $path, '//' ) !== false && preg_match( '_^(https?:)?//\\w+(\\.\\w+)+/\\w+_i', $path ) ) {
return $winPath ? '' : false;
} else {
$path = realpath( $path );
if ( $winPath ) {
$path = self::WinPath( $path );
}
return $path;
}
}
public function CacheEnabled() {
return ( Less_Parser::$options['cache_method'] && ( Less_Cache::$cache_dir || ( Less_Parser::$options['cache_method'] == 'callback' ) ) );
}
}