qrcode.chapril.org-libreqr/vendor/wikimedia/less.php/lib/Less/Parser.php
2023-07-07 22:33:10 +02:00

2730 lines
67 KiB
PHP

<?php
/**
* Parse and compile Less files into CSS
*/
class Less_Parser {
/**
* Default parser options
*/
public static $default_options = [
'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' => [],
'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' => [],
];
/** @var array{compress:bool,strictUnits:bool,strictMath:bool,numPrecision:int,import_dirs:array,import_callback:null|callable,indentation:string} */
public static $options = [];
private $input; // Less input string
private $input_len; // input string length
private $pos; // current index in `input`
private $saveStack = []; // 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 = [];
private static $imports = [];
public static $has_extends = false;
public static $next_id = 0;
/**
* Filename to contents of all parsed the files
*
* @var array
*/
public static $contentsMap = [];
/**
* @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( self::$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 = [];
self::$imports = [];
self::$has_extends = false;
self::$imports = [];
self::$contentsMap = [];
$this->env = new Less_Environment();
// set new options
if ( is_array( $options ) ) {
$this->SetOptions( self::$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;
}
self::$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( null, $this->rules );
$root->root = true;
$root->firstRoot = true;
$this->PreVisitors( $root );
self::$has_extends = false;
$evaldRoot = $root->compile( $this->env );
$this->PostVisitors( $evaldRoot );
if ( self::$options['sourceMap'] ) {
$generator = new Less_SourceMap_Generator( $evaldRoot, self::$contentsMap, self::$options );
// will also save file
// FIXME: should happen somewhere else?
$css = $generator->generateCSS();
} else {
$css = $evaldRoot->toCSS();
}
if ( self::$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;
}
/**
* 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 = [];
$not_variable_type = [
'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 Less_Tree $var
* @return string
*/
private function getVariableValue( Less_Tree $var ) {
switch ( get_class( $var ) ) {
case Less_Tree_Color::class:
return $this->rgb2html( $var->rgb );
case Less_Tree_Variable::class:
return $this->findVarByName( $var->name );
case Less_Tree_Keyword::class:
return $var->value;
case Less_Tree_Url::class:
// Based on Less_Tree_Url::genCSS()
// Recurse to serialize the Less_Tree_Quoted value
return 'url(' . $this->getVariableValue( $var->value ) . ')';
case Less_Tree_Rule::class:
return $this->getVariableValue( $var->value );
case Less_Tree_Value::class:
$value = '';
foreach ( $var->value as $sub_value ) {
$value .= $this->getVariableValue( $sub_value ) . ' ';
}
return $value;
case Less_Tree_Quoted::class:
return $var->quote . $var->value . $var->quote;
case Less_Tree_Dimension::class:
$value = $var->value;
if ( $var->unit && $var->unit->numerator ) {
$value .= $var->unit->numerator[0];
}
return $value;
case Less_Tree_Expression::class:
$value = '';
foreach ( $var->value as $item ) {
$value .= $this->getVariableValue( $item ) . " ";
}
return $value;
case Less_Tree_Operation::class:
throw new Exception( 'getVariables() require Less to be compiled. please use $parser->getCss() before calling getVariables()' );
case Less_Tree_Unit::class:
case Less_Tree_Comment::class:
case Less_Tree_Import::class:
case Less_Tree_Ruleset::class:
default:
throw new Exception( "type missing in switch/case getVariableValue for " . $var->type );
}
}
private function rgb2html( $r, $g = -1, $b = -1 ) {
if ( is_array( $r ) && count( $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 ( self::$options['plugins'] ) {
foreach ( self::$options['plugins'] as $plugin ) {
if ( !empty( $plugin->isPreEvalVisitor ) ) {
$plugin->run( $root );
}
}
}
}
/**
* Run post-compile visitors
*/
private function PostVisitors( $evaldRoot ) {
$visitors = [];
$visitors[] = new Less_Visitor_joinSelector();
if ( self::$has_extends ) {
$visitors[] = new Less_Visitor_processExtends();
}
$visitors[] = new Less_Visitor_toCSS();
if ( self::$options['plugins'] ) {
foreach ( self::$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
*
* @throws Less_Exception_Parser If the compiler encounters invalid syntax
* @param string $str The string to convert
* @param string|null $file_uri The url of the file
* @return Less_Parser
*/
public function parse( $str, $file_uri = null ) {
if ( !$file_uri ) {
$uri_root = '';
$filename = 'anonymous-file-' . self::$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 If the compiler encounters invalid syntax
* @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( null, $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 = self::serializeVars( $vars );
$this->_parse();
return $this;
}
/**
* @param string $filename
* @param string $uri_root
*/
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 = [];
// 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 ) {
self::$options['import_dirs'] = [];
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, '/' ) . '/';
}
}
self::$options['import_dirs'][$path] = $uri_root;
}
}
/**
* @param string|null $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 ( self::$options['cache_method'] == 'callback' ) {
if ( is_callable( self::$options['cache_callback_get'] ) ) {
$cache = call_user_func_array(
self::$options['cache_callback_get'],
[ $this, $file_path, $cache_file ]
);
if ( $cache ) {
$this->UnsetInput();
return $cache;
}
}
} elseif ( file_exists( $cache_file ) ) {
switch ( self::$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 ( self::$options['cache_method'] == 'callback' ) {
if ( is_callable( self::$options['cache_callback_set'] ) ) {
call_user_func_array(
self::$options['cache_callback_set'],
[ $this, $file_path, $cache_file, $rules ]
);
}
} else {
switch ( self::$options['cache_method'] ) {
case 'serialize':
file_put_contents( $cache_file, serialize( $rules ) );
break;
case 'php':
// Mask PHP open tag to avoid breaking Doxygen
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 ( self::$options['sourceMap'] && $this->env->currentFileInfo ) {
$uri = $this->env->currentFileInfo['currentUri'];
self::$contentsMap[$uri] = $this->input;
}
}
/**
* Free up some memory
*/
public function UnsetInput() {
$this->input = $this->pos = $this->input_len = $this->furthest = null;
$this->saveStack = [];
}
public function CacheFile( $file_path ) {
if ( $file_path && $this->CacheEnabled() ) {
$env = get_object_vars( $this->env );
unset( $env['frames'] );
$parts = [];
$parts[] = $file_path;
$parts[] = filesize( $file_path );
$parts[] = filemtime( $file_path );
$parts[] = $env;
$parts[] = Less_Version::cache_version;
$parts[] = self::$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() {
if ( $this->pos > $this->furthest ) {
$this->furthest = $this->pos;
}
$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 ) {
// @phan-suppress-next-line PhanParamSuspiciousOrder False positive
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 null|string|array|Less_Tree
*/
private function matcher( $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 null|string|array|Less_Tree
*/
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.
*
* @param string $tok
* @see less-2.5.3.js#parserInput.$char
*/
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
*
* @return array|null
*/
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 int|false
*/
public function PeekReg( $tok ) {
return preg_match( $tok, $this->input, $match, 0, $this->pos );
}
/**
* @param string $tok
*/
public function PeekChar( $tok ) {
return ( $this->pos < $this->input_len ) && ( $this->input[$this->pos] === $tok );
}
/**
* @param int $length
* @see less-2.5.3.js#skipWhitespace
*/
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->matcher( [ $tok ] );
if ( !$result ) {
$this->Error( $msg ? "Expected '" . $tok . "' got '" . $this->input[$this->pos] . "'" : $msg );
} else {
return $result;
}
}
/**
* @param string $tok
* @param string|null $msg
*/
public function expectChar( $tok, $msg = null ) {
$result = $this->MatchChar( $tok );
if ( !$result ) {
$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.
//
// @see less-2.5.3.js#parsers.primary
private function parsePrimary() {
$root = [];
while ( true ) {
if ( $this->pos >= $this->input_len ) {
break;
}
$node = $this->parseExtend( true );
if ( $node ) {
$root = array_merge( $root, $node );
continue;
}
$node = $this->MatchFuncs( [
'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->NewObj( 'Less_Tree_Comment', [ $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->NewObj( 'Less_Tree_Comment', [ $comment[0], false, $this->pos, $this->env->currentFileInfo ] );
}
}
private function parseComments() {
$comments = [];
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!'
*
* @return Less_Tree_Quoted|null
*/
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->NewObj( 'Less_Tree_Quoted', [ $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
*
* @return Less_Tree_Keyword|Less_Tree_Color|null
*/
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->NewObj( '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->NewObj( 'Less_Tree_Color', [ substr( Less_Colors::color( $keyword ), 1 ) ] );
}
if ( $keyword === 'transparent' ) {
return $this->NewObj( 'Less_Tree_Color', [ [ 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->NewObj( 'Less_Tree_Call', [ $name, $args, $index, $this->env->currentFileInfo ] );
}
}
/**
* Parse a list of arguments
*
* @return array<Less_Tree_Assignment|Less_Tree_Expression>
*/
private function parseEntitiesArguments() {
$args = [];
while ( true ) {
$arg = $this->MatchFuncs( [ 'parseEntitiesAssignment', 'parseExpression' ] );
if ( !$arg ) {
break;
}
$args[] = $arg;
if ( !$this->MatchChar( ',' ) ) {
break;
}
}
return $args;
}
/** @return Less_Tree_Dimension|Less_Tree_Color|Less_Tree_Quoted|Less_Tree_UnicodeDescriptor|null */
private function parseEntitiesLiteral() {
return $this->MatchFuncs( [ '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* )
*
* @return Less_Tree_Assignment|null
*/
private function parseEntitiesAssignment() {
$key = $this->MatchReg( '/\\G\w+(?=\s?=)/' );
if ( !$key ) {
return;
}
if ( !$this->MatchChar( '=' ) ) {
return;
}
$value = $this->parseEntity();
if ( $value ) {
return $this->NewObj( 'Less_Tree_Assignment', [ $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->matcher( [ 'parseEntitiesQuoted','parseEntitiesVariable','/\\Gdata\:.*?[^\)]+/','/\\G(?:(?:\\\\[\(\)\'"])|[^\(\)\'"])+/' ] );
if ( !$value ) {
$value = '';
}
$this->expectChar( ')' );
// @phan-suppress-next-line PhanUndeclaredProperty
if ( isset( $value->value ) || $value instanceof Less_Tree_Variable ) {
return $this->NewObj( 'Less_Tree_Url', [ $value, $this->env->currentFileInfo ] );
}
return $this->NewObj( 'Less_Tree_Url', [ $this->NewObj( '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`.
*
* @return Less_Tree_Variable|null
*/
private function parseEntitiesVariable() {
$index = $this->pos;
if ( $this->PeekChar( '@' ) && ( $name = $this->MatchReg( '/\\G@@?[\w-]+/' ) ) ) {
return $this->NewObj( 'Less_Tree_Variable', [ $name[0], $index, $this->env->currentFileInfo ] );
}
}
/**
* A variable entity using the protective `{}` e.g. `@{var}`.
*
* @return Less_Tree_Variable|null
*/
private function parseEntitiesVariableCurly() {
$index = $this->pos;
if ( $this->input_len > ( $this->pos + 1 ) && $this->input[$this->pos] === '@' && ( $curly = $this->MatchReg( '/\\G@\{([\w-]+)\}/' ) ) ) {
return $this->NewObj( 'Less_Tree_Variable', [ '@' . $curly[1], $index, $this->env->currentFileInfo ] );
}
}
/**
* A Hexadecimal color
*
* #4F3C2F
*
* `rgb` and `hsl` colors are parsed through the `entities.call` parser.
*
* @return Less_Tree_Color|null
*/
private function parseEntitiesColor() {
if ( $this->PeekChar( '#' ) && ( $rgb = $this->MatchReg( '/\\G#([A-Fa-f0-9]{6}|[A-Fa-f0-9]{3})/' ) ) ) {
return $this->NewObj( 'Less_Tree_Color', [ $rgb[1] ] );
}
}
/**
* A Dimension, that is, a number and a unit
*
* 0.5em 95%
*
* @return Less_Tree_Dimension|null
*/
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->NewObj( 'Less_Tree_Dimension', [ $value[1],$value[2] ] );
}
return $this->NewObj( 'Less_Tree_Dimension', [ $value[1] ] );
}
}
/**
* A unicode descriptor, as is used in unicode-range
*
* U+0?? or U+00A1-00A9
*
* @return Less_Tree_UnicodeDescriptor|null
*/
function parseUnicodeDescriptor() {
$ud = $this->MatchReg( '/\\G(U\+[0-9a-fA-F?]+)(\-[0-9a-fA-F?]+)?/' );
if ( $ud ) {
return $this->NewObj( '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->NewObj( 'Less_Tree_Javascript', [ $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->NewObj( 'Less_Tree_RulesetCall', [ $name[1] ] );
}
}
//
// extend syntax - used to extend selectors
//
function parseExtend( $isRule = false ) {
$index = $this->pos;
$extendList = [];
if ( !$this->MatchReg( $isRule ? '/\\G&:extend\(/' : '/\\G:extend\(/' ) ) {
return;
}
do {
$option = null;
$elements = [];
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->NewObj( 'Less_Tree_Extend', [ $this->NewObj( '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 = [];
}
$important = $this->parseImportant();
if ( $this->parseEnd() ) {
$this->forget();
return $this->NewObj( 'Less_Tree_Mixin_Call', [ $elements, $args, $index, $this->env->currentFileInfo, $important ] );
}
}
$this->restore();
}
private function parseMixinCallElements() {
$elements = [];
$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->NewObj( 'Less_Tree_Element', [ $c, $e[0], $elemIndex, $this->env->currentFileInfo ] );
$c = $this->MatchChar( '>' );
}
return $elements;
}
/**
* @param bool $isCall
*/
private function parseMixinArgs( $isCall ) {
$expressions = [];
$argsSemiColon = [];
$isSemiColonSeperated = null;
$argsComma = [];
$expressionContainsNamed = null;
$name = null;
$returner = [ 'args' => [], 'variadic' => false ];
$this->save();
while ( true ) {
if ( $isCall ) {
$arg = $this->MatchFuncs( [ '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[] = [ 'variadic' => true ];
} else {
$argsComma[] = [ 'variadic' => true ];
}
break;
}
$arg = $this->MatchFuncs( [ 'parseEntitiesVariable', 'parseEntitiesLiteral', 'parseEntitiesKeyword' ] );
}
'@phan-var Less_Tree_DetachedRuleset|Less_Tree_Expression|Less_Tree_Variable|Less_Tree_Dimension|Less_Tree_Color|Less_Tree_Quoted|Less_Tree_UnicodeDescriptor|Less_Tree_Keyword|null $arg';
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'] = [];
return $returner;
}
}
$nameLoop = ( $name = $val->name );
} elseif ( !$isCall && $this->MatchReg( '/\\G\.{3}/' ) ) {
$returner['variadic'] = true;
if ( $this->MatchChar( ";" ) && !$isSemiColonSeperated ) {
$isSemiColonSeperated = true;
}
if ( $isSemiColonSeperated ) {
$argsSemiColon[] = [ 'name' => $arg->name, 'variadic' => true ];
} else {
$argsComma[] = [ 'name' => $arg->name, 'variadic' => true ];
}
break;
} elseif ( !$isCall ) {
$name = $nameLoop = $val->name;
$value = null;
}
}
if ( $value ) {
$expressions[] = $value;
}
$argsComma[] = [ '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->NewObj( 'Less_Tree_Value', [ $expressions ] );
}
$argsSemiColon[] = [ 'name' => $name, 'value' => $value ];
$name = null;
$expressions = [];
$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];
// TODO: Less.js doesn't limit this to $char == '{'.
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->restore();
return;
}
$this->parseComments();
if ( $this->MatchReg( '/\\Gwhen/' ) ) { // Guard
$cond = $this->expect( 'parseConditions', 'Expected conditions' );
}
$ruleset = $this->parseBlock();
if ( $ruleset !== null ) {
$this->forget();
return $this->NewObj( 'Less_Tree_Mixin_Definition', [ $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( [ '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->NewObj( '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 `*`.
*
* @return Less_Tree_Element|null
* @see less-2.5.3.js#parsers.element
*/
private function parseElement() {
$c = $this->parseCombinator();
$index = $this->pos;
// TODO: Speed up by calling MatchChar directly, like less.js does
$e = $this->matcher( [
'/\\G(?:\d+\.\d+|\d+)%/',
'/\\G(?:[.#]?|:*)(?:[\w-]|[^\x00-\x9f]|\\\\(?:[A-Fa-f0-9]{1,6} ?|[^A-Fa-f0-9]))+/',
'#*',
'#&',
'parseAttribute',
'/\\G\([^&()@]+\)/',
'/\\G[\.#:](?=@)/',
'parseEntitiesVariableCurly'
] );
if ( $e === null ) {
$this->save();
if ( $this->MatchChar( '(' ) ) {
if ( ( $v = $this->parseSelector() ) && $this->MatchChar( ')' ) ) {
$e = $this->NewObj( 'Less_Tree_Paren', [ $v ] );
$this->forget();
} else {
$this->restore();
}
} else {
$this->forget();
}
}
if ( $e !== null ) {
return $this->NewObj( 'Less_Tree_Element', [ $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.
//
// @see less-2.5.3.js#parsers.combinator
private function parseCombinator() {
if ( $this->pos < $this->input_len ) {
$c = $this->input[$this->pos];
// TODO: Figure out why less.js also handles '/' here, and implement with regression test.
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
*
* @return Less_Tree_Selector|null
* @see less-2.5.3.js#parsers.lessSelector
*/
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 ::parseElement.
*
* @return Less_Tree_Selector|null
* @see less-2.5.3.js#parsers.selector
*/
private function parseSelector( $isLess = false ) {
$elements = [];
$extendList = [];
$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->NewObj( 'Less_Tree_Selector', [ $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->matcher( [ 'parseEntitiesQuoted','/\\G[0-9]+%/','/\\G[\w-]+/','parseEntitiesVariableCurly' ] );
}
$this->expectChar( ']' );
return $this->NewObj( 'Less_Tree_Attribute', [ $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 `{}`.
*
* @return array<Less_Tree>|null
* @see less-2.5.3.js#parsers.block
*/
private function parseBlock() {
if ( $this->MatchChar( '{' ) ) {
$content = $this->parsePrimary();
if ( $this->MatchChar( '}' ) ) {
return $content;
}
}
}
private function parseBlockRuleset() {
$block = $this->parseBlock();
if ( $block ) {
$block = $this->NewObj( 'Less_Tree_Ruleset', [ null, $block ] );
}
return $block;
}
/** @return Less_Tree_DetachedRuleset|null */
private function parseDetachedRuleset() {
$blockRuleset = $this->parseBlockRuleset();
if ( $blockRuleset ) {
return $this->NewObj( 'Less_Tree_DetachedRuleset', [ $blockRuleset ] );
}
}
/**
* Ruleset such as:
*
* div, .class, body > p {
* }
*
* @return Less_Tree_Ruleset|null
* @see less-2.5.3.js#parsers.ruleset
*/
private function parseRuleset() {
$selectors = [];
$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();
// TODO: Less_Environment::$strictImports is not yet ported
// It is passed here by less.js
return $this->NewObj( 'Less_Tree_Ruleset', [ $selectors, $rules ] );
}
}
// Backtrack
$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\-%\.,]+?[\'"]?) *(! *important)?\s*([;}])/' );
if ( $match ) {
if ( $match[4] == '}' ) {
$this->pos = $index + strlen( $match[0] ) - 1;
}
if ( $match[3] ) {
$match[2] .= ' !important';
}
return $this->NewObj( 'Less_Tree_NameValue', [ $match[1], $match[2], $index, $this->env->currentFileInfo ] );
}
$this->restore();
}
// @see less-2.5.3.js#parsers.rule
private function parseRule( $tryAnonymous = null ) {
$value = null;
$startOfRule = $this->pos;
$c = $this->input[$this->pos];
$important = null;
$merge = false;
// TODO: Figure out why less.js also handles ':' here, and implement with regression test.
if ( $c === '.' || $c === '#' || $c === '&' ) {
return;
}
$this->save();
$name = $this->MatchFuncs( [ 'parseVariable', 'parseRuleProperty' ] );
if ( $name ) {
$isVariable = is_string( $name );
if ( $isVariable ) {
$value = $this->parseDetachedRuleset();
}
if ( !$value ) {
// 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 && count( $name ) > 1 ) {
$merge = array_pop( $name )->value;
}
// prefer to try to parse first if its a variable or we are compressing
// but always fallback on the other one
$tryValueFirst = ( !$tryAnonymous && ( self::$options['compress'] || $isVariable ) );
if ( $tryValueFirst ) {
$value = $this->parseValue();
}
if ( !$value ) {
$value = $this->parseAnonymousValue();
if ( $value ) {
$this->forget();
// anonymous values absorb the end ';' which is required for them to work
return $this->NewObj( 'Less_Tree_Rule', [ $name, $value, false, $merge, $startOfRule, $this->env->currentFileInfo ] );
}
}
if ( !$tryValueFirst && !$value ) {
$value = $this->parseValue();
}
$important = $this->parseImportant();
}
if ( $value && $this->parseEnd() ) {
$this->forget();
return $this->NewObj( 'Less_Tree_Rule', [ $name, $value, $important, $merge, $startOfRule, $this->env->currentFileInfo ] );
} else {
$this->restore();
if ( $value && !$tryAnonymous ) {
return $this->parseRule( true );
}
}
} else {
$this->forget();
}
}
function parseAnonymousValue() {
$match = $this->MatchReg( '/\\G([^@+\/\'"*`(;{}-]*);/' );
if ( $match ) {
return $this->NewObj( '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( [ 'parseEntitiesQuoted','parseEntitiesUrl' ] );
if ( $path ) {
$features = $this->parseMediaFeatures();
if ( $this->MatchChar( ';' ) ) {
if ( $features ) {
$features = $this->NewObj( 'Less_Tree_Value', [ $features ] );
}
$this->forget();
return $this->NewObj( 'Less_Tree_Import', [ $path, $features, $options, $this->pos, $this->env->currentFileInfo ] );
}
}
}
$this->restore();
}
private function parseImportOptions() {
$options = [];
// 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 = [];
do{
$e = $this->MatchFuncs( [ 'parseEntitiesKeyword','parseEntitiesVariable' ] );
if ( $e ) {
$nodes[] = $e;
} elseif ( $this->MatchChar( '(' ) ) {
$p = $this->parseProperty();
$e = $this->parseValue();
if ( $this->MatchChar( ')' ) ) {
if ( $p && $e ) {
$r = $this->NewObj( 'Less_Tree_Rule', [ $p, $e, null, null, $this->pos, $this->env->currentFileInfo, true ] );
$nodes[] = $this->NewObj( 'Less_Tree_Paren', [ $r ] );
} elseif ( $e ) {
$nodes[] = $this->NewObj( 'Less_Tree_Paren', [ $e ] );
} else {
return null;
}
} else {
return null;
}
}
} while ( $e );
if ( $nodes ) {
return $this->NewObj( 'Less_Tree_Expression', [ $nodes ] );
}
}
private function parseMediaFeatures() {
$features = [];
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 ?: null;
}
private function parseMedia() {
if ( $this->MatchReg( '/\\G@media/' ) ) {
$this->save();
$features = $this->parseMediaFeatures();
$rules = $this->parseBlock();
if ( $rules === null ) {
$this->restore();
return;
}
$this->forget();
return $this->NewObj( 'Less_Tree_Media', [ $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( [
'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" );
}
} elseif ( $hasExpression ) {
$value = $this->parseExpression();
if ( !$value ) {
$this->error( "expected " . $name . " expression" );
}
} elseif ( $hasUnknown ) {
$value = $this->MatchReg( '/\\G[^{;]+/' );
if ( $value ) {
$value = $this->NewObj( 'Less_Tree_Anonymous', [ trim( $value[0] ) ] );
}
}
if ( $hasBlock ) {
$rules = $this->parseBlockRuleset();
}
if ( $rules || ( !$hasBlock && $value && $this->MatchChar( ';' ) ) ) {
$this->forget();
return $this->NewObj( 'Less_Tree_Directive', [ $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 = [];
do{
$e = $this->parseExpression();
if ( $e ) {
$expressions[] = $e;
if ( !$this->MatchChar( ',' ) ) {
break;
}
}
} while ( $e );
if ( $expressions ) {
return $this->NewObj( '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->NewObj( 'Less_Tree_Expression', [ [ $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->NewObj( 'Less_Tree_Operation', [ $op, [ $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->matcher( [ '#+','#-' ] );
}
if ( !$op ) {
break;
}
}
$a = $this->parseMultiplication();
if ( !$a ) {
break;
}
$m->parensInOp = true;
$a->parensInOp = true;
$return = $this->NewObj( 'Less_Tree_Operation', [ $op, [ $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->NewObj( 'Less_Tree_Condition', [ '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( [ 'parseAddition','parseEntitiesKeyword','parseEntitiesQuoted' ] );
if ( $a ) {
$op = $this->MatchReg( '/\\G(?:>=|<=|=<|[<=>])/' );
if ( $op ) {
$b = $this->MatchFuncs( [ 'parseAddition','parseEntitiesKeyword','parseEntitiesQuoted' ] );
if ( $b ) {
$c = $this->NewObj( 'Less_Tree_Condition', [ $op[0], $a, $b, $index, $negate ] );
} else {
$this->Error( 'Unexpected expression' );
}
} else {
$k = $this->NewObj( 'Less_Tree_Keyword', [ 'true' ] );
$c = $this->NewObj( 'Less_Tree_Condition', [ '=', $a, $k, $index, $negate ] );
}
$this->expectChar( ')' );
// @phan-suppress-next-line PhanPossiblyInfiniteRecursionSameParams
return $this->MatchReg( '/\\Gand/' ) ? $this->NewObj( 'Less_Tree_Condition', [ '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( [ 'parseSub','parseEntitiesDimension','parseEntitiesColor','parseEntitiesVariable','parseEntitiesCall' ] );
if ( $negate ) {
$o->parensInOp = true;
$o = $this->NewObj( 'Less_Tree_Negative', [ $o ] );
}
return $o;
}
/**
* Expressions either represent mathematical operations,
* or white-space delimited Entities.
*
* @return Less_Tree_Expression|null
*/
private function parseExpression() {
$entities = [];
do {
$e = $this->MatchFuncs( [ '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->NewObj( 'Less_Tree_Anonymous', [ $delim ] );
}
}
}
} while ( $e );
if ( $entities ) {
return $this->NewObj( '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 array<Less_Tree_Keyword|Less_Tree_Variable>
*/
private function parseRuleProperty() {
$name = [];
$index = [];
$this->save();
$simpleProperty = $this->MatchReg( '/\\G([_a-zA-Z0-9-]+)\s*:/' );
if ( $simpleProperty ) {
$name[] = $this->NewObj( 'Less_Tree_Keyword', [ $simpleProperty[1] ] );
$this->forget();
return $name;
}
$this->rulePropertyMatch( '/\\G(\*?)/', $index, $name );
// Consume!
// @phan-suppress-next-line PhanPluginEmptyStatementWhileLoop
while ( $this->rulePropertyMatch( '/\\G((?:[\w-]+)|(?:@\{[\w-]+\}))/', $index, $name ) );
if ( ( count( $name ) > 1 ) && $this->rulePropertyMatch( '/\\G\s*((?:\+_|\+)?)\s*:/', $index, $name ) ) {
$this->forget();
// at last, we have the complete match now. move forward,
// convert name particles to tree objects and return:
if ( $name[0] === '' ) {
array_shift( $name );
array_shift( $index );
}
foreach ( $name as $k => $s ) {
if ( !$s || $s[0] !== '@' ) {
$name[$k] = $this->NewObj( 'Less_Tree_Keyword', [ $s ] );
} else {
$name[$k] = $this->NewObj( 'Less_Tree_Variable', [ '@' . substr( $s, 2, -1 ), $index[$k], $this->env->currentFileInfo ] );
}
}
return $name;
} else {
$this->restore();
}
}
private function rulePropertyMatch( $re, &$index, &$name ) {
$i = $this->pos;
$chunk = $this->MatchReg( $re );
if ( $chunk ) {
$index[] = $i;
$name[] = $chunk[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 mixed $a
* @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( $input, $precision = 0 ) {
$precision = pow( 10, $precision );
$i = $input * $precision;
$ceil = ceil( $i );
$floor = floor( $i );
if ( ( $ceil - $i ) <= ( $i - $floor ) ) {
return $ceil / $precision;
} else {
return $floor / $precision;
}
}
/**
* Create a new instance of $class with args $args, and optionally generates a cache string.
* $class should be a Less_Tree_* class.
*
* @phan-template TClassName
* @phan-param class-string<TClassName> $class
* @phan-param array<int,mixed> $args
* @phan-return TClassName
*
* @param string $class
* @param mixed[] $args
* @return Less_Tree Instance of $class subclass created with $args
*/
public function NewObj( $class, $args = [] ) {
$obj = new $class( ...$args );
if ( $this->CacheEnabled() ) {
$argStrings = array_map(
[ __CLASS__, 'ArgString' ],
$args
);
$argCache = implode( ',', $argStrings );
// @phan-suppress-next-line PhanTypeExpectedObjectPropAccess False positive
$obj->cache_string = " new $class($argCache)";
}
return $obj;
}
/**
* 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 );
}
/** @return never */
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?:)?\/\//i', $path ) ) {
return $winPath ? '' : false;
} else {
$path = realpath( $path );
if ( $winPath ) {
$path = self::WinPath( $path );
}
return $path;
}
}
public function CacheEnabled() {
return ( self::$options['cache_method'] && ( Less_Cache::$cache_dir || ( self::$options['cache_method'] == 'callback' ) ) );
}
}