Lessc::lib_cos()   A
last analyzed

Complexity

Conditions 1
Paths 1

Size

Total Lines 3
Code Lines 1

Duplication

Lines 0
Ratio 0 %

Importance

Changes 0
Metric Value
cc 1
eloc 1
nc 1
nop 1
dl 0
loc 3
rs 10
c 0
b 0
f 0
1
<?php
2
3
/* Copyright (C) 2024       Rafael San José             <[email protected]>
4
 *
5
 * This program is free software; you can redistribute it and/or modify
6
 * it under the terms of the GNU General Public License as published by
7
 * the Free Software Foundation; either version 3 of the License, or
8
 * (at your option) any later version.
9
 *
10
 * This program is distributed in the hope that it will be useful,
11
 * but WITHOUT ANY WARRANTY; without even the implied warranty of
12
 * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
13
 * GNU General Public License for more details.
14
 *
15
 * You should have received a copy of the GNU General Public License
16
 * along with this program. If not, see <https://www.gnu.org/licenses/>.
17
 * or see https://www.gnu.org/
18
 */
19
20
/**
21
 * lessphp v0.8.0
22
 * http://leafo.net/lessphp
23
 *
24
 * LESS CSS compiler, adapted from http://lesscss.org
25
 *
26
 * Copyright 2013, Leaf Corcoran <[email protected]>
27
 * Licensed under MIT or GPLv3, see LICENSE
28
 */
29
30
namespace Dolibarr\Code\Core\Classes;
31
32
// phpcs:disable
33
/**
34
 * The LESS compiler and parser.
35
 *
36
 * Converting LESS to CSS is a three stage process. The incoming file is parsed
37
 * by `lessc_parser` into a syntax tree, then it is compiled into another tree
38
 * representing the CSS structure by `lessc`. The CSS tree is fed into a
39
 * formatter, like `lessc_formatter` which then outputs CSS as a string.
40
 *
41
 * During the first compile, all values are *reduced*, which means that their
42
 * types are brought to the lowest form before being dump as strings. This
43
 * handles math equations, variable dereferences, and the like.
44
 *
45
 * The `parse` function of `lessc` is the entry point.
46
 *
47
 * In summary:
48
 *
49
 * The `lessc` class creates an instance of the parser, feeds it LESS code,
50
 * then transforms the resulting tree to a CSS tree. This class also holds the
51
 * evaluation context, such as all available mixins and variables at any given
52
 * time.
53
 *
54
 * The `lessc_parser` class is only concerned with parsing its input.
55
 *
56
 * The `lessc_formatter` takes a CSS tree, and dumps it to a formatted string,
57
 * handling things like indentation.
58
 */
59
class Lessc
60
{
61
62
	public static $VERSION = "v0.8.0";
63
64
	public static $TRUE = array("keyword", "true");
65
	public static $FALSE = array("keyword", "false");
66
67
	protected $libFunctions = array();
68
	protected $registeredVars = array();
69
	protected $preserveComments = false;
70
71
	public $vPrefix = '@'; // prefix of abstract properties
72
	public $mPrefix = '$'; // prefix of abstract blocks
73
	public $parentSelector = '&';
74
75
	public $importDisabled = false;
76
	public $importDir = '';
77
78
	public $scope;
79
	public $formatter;
80
	public $formatterName;
81
	public $parser;
82
	public $_parseFile;
83
	public $env;
84
	public $count;
85
86
	protected $numberPrecision = null;
87
88
	protected $allParsedFiles = array();
89
90
	// set to the parser that generated the current line when compiling
91
	// so we know how to create error messages
92
	protected $sourceParser = null;
93
	protected $sourceLoc = null;
94
95
	protected static $nextImportId = 0; // uniquely identify imports
96
97
	// attempts to find the path of an import url, returns null for css files
98
	protected function findImport($url)
99
	{
100
		foreach ((array) $this->importDir as $dir) {
101
			$full = $dir.(substr($dir, -1) != '/' ? '/' : '').$url;
102
			if ($this->fileExists($file = $full.'.less') || $this->fileExists($file = $full)) {
103
				return $file;
104
			}
105
		}
106
107
		return null;
108
	}
109
110
	/**
111
	 * fileExists
112
	 *
113
	 * @param       string  $name   Filename
114
	 * @return      boolean
115
	 */
116
	protected function fileExists($name)
117
	{
118
		return is_file($name);
119
	}
120
121
	public static function compressList($items, $delim)
122
	{
123
		if (!isset($items[1]) && isset($items[0])) {
124
			return $items[0];
125
		} else {
126
			return array('list', $delim, $items);
127
		}
128
	}
129
130
	public static function preg_quote($what)
131
	{
132
		return preg_quote($what, '/');
133
	}
134
135
	protected function tryImport($importPath, $parentBlock, $out)
136
	{
137
		if ($importPath[0] == "function" && $importPath[1] == "url") {
138
			$importPath = $this->flattenList($importPath[2]);
139
		}
140
141
		$str = $this->coerceString($importPath);
142
		if ($str === null) {
143
			return false;
144
		}
145
146
		$url = $this->compileValue($this->lib_e($str));
147
148
		// don't import if it ends in css
149
		if (substr_compare($url, '.css', -4, 4) === 0) {
150
			return false;
151
		}
152
153
		$realPath = $this->findImport($url);
154
155
		if ($realPath === null) {
156
			return false;
157
		}
158
159
		if ($this->importDisabled) {
160
			return array(false, "/* import disabled */");
161
		}
162
163
		if (isset($this->allParsedFiles[realpath($realPath)])) {
164
			return array(false, null);
165
		}
166
167
		$this->addParsedFile($realPath);
168
		$parser = $this->makeParser($realPath);
169
		$root = $parser->parse(file_get_contents($realPath));
170
171
		// set the parents of all the block props
172
		foreach ($root->props as $prop) {
173
			if ($prop[0] == "block") {
174
				$prop[1]->parent = $parentBlock;
175
			}
176
		}
177
178
		// copy mixins into scope, set their parents
179
		// bring blocks from import into current block
180
		// TODO: need to mark the source parser these came from this file
181
		foreach ($root->children as $childName => $child) {
182
			if (isset($parentBlock->children[$childName])) {
183
				$parentBlock->children[$childName] = array_merge(
184
					$parentBlock->children[$childName],
185
					$child
186
				);
187
			} else {
188
				$parentBlock->children[$childName] = $child;
189
			}
190
		}
191
192
		$pi = pathinfo($realPath);
193
		$dir = $pi["dirname"];
194
195
		list($top, $bottom) = $this->sortProps($root->props, true);
196
		$this->compileImportedProps($top, $parentBlock, $out, $parser, $dir);
197
198
		return array(true, $bottom, $parser, $dir);
199
	}
200
201
	protected function compileImportedProps($props, $block, $out, $sourceParser, $importDir)
202
	{
203
		$oldSourceParser = $this->sourceParser;
204
205
		$oldImport = $this->importDir;
206
207
		// TODO: this is because the importDir api is stupid
208
		$this->importDir = (array) $this->importDir;
209
		array_unshift($this->importDir, $importDir);
210
211
		foreach ($props as $prop) {
212
			$this->compileProp($prop, $block, $out);
213
		}
214
215
		$this->importDir = $oldImport;
216
		$this->sourceParser = $oldSourceParser;
217
	}
218
219
	/**
220
	 * Recursively compiles a block.
221
	 *
222
	 * A block is analogous to a CSS block in most cases. A single LESS document
223
	 * is encapsulated in a block when parsed, but it does not have parent tags
224
	 * so all of it's children appear on the root level when compiled.
225
	 *
226
	 * Blocks are made up of props and children.
227
	 *
228
	 * Props are property instructions, array tuples which describe an action
229
	 * to be taken, eg. write a property, set a variable, mixin a block.
230
	 *
231
	 * The children of a block are just all the blocks that are defined within.
232
	 * This is used to look up mixins when performing a mixin.
233
	 *
234
	 * Compiling the block involves pushing a fresh environment on the stack,
235
	 * and iterating through the props, compiling each one.
236
	 *
237
	 * See Lessc::compileProp()
238
	 *
239
	 */
240
	protected function compileBlock($block)
241
	{
242
		switch ($block->type) {
243
			case "root":
244
				$this->compileRoot($block);
245
				break;
246
			case null:
247
				$this->compileCSSBlock($block);
248
				break;
249
			case "media":
250
				$this->compileMedia($block);
251
				break;
252
			case "directive":
253
				$name = "@".$block->name;
254
				if (!empty($block->value)) {
255
					$name .= " ".$this->compileValue($this->reduce($block->value));
256
				}
257
258
				$this->compileNestedBlock($block, array($name));
259
				break;
260
			default:
261
				$this->throwError("unknown block type: $block->type\n");
262
		}
263
	}
264
265
	protected function compileCSSBlock($block)
266
	{
267
		$env = $this->pushEnv();
268
269
		$selectors = $this->compileSelectors($block->tags);
270
		$env->selectors = $this->multiplySelectors($selectors);
271
		$out = $this->makeOutputBlock(null, $env->selectors);
272
273
		$this->scope->children[] = $out;
274
		$this->compileProps($block, $out);
275
276
		$block->scope = $env; // mixins carry scope with them!
277
		$this->popEnv();
278
	}
279
280
	protected function compileMedia($media)
281
	{
282
		$env = $this->pushEnv($media);
283
		$parentScope = $this->mediaParent($this->scope);
284
285
		$query = $this->compileMediaQuery($this->multiplyMedia($env));
286
287
		$this->scope = $this->makeOutputBlock($media->type, array($query));
288
		$parentScope->children[] = $this->scope;
289
290
		$this->compileProps($media, $this->scope);
291
292
		if (count($this->scope->lines) > 0) {
293
			$orphanSelelectors = $this->findClosestSelectors();
294
			if (!is_null($orphanSelelectors)) {
295
				$orphan = $this->makeOutputBlock(null, $orphanSelelectors);
296
				$orphan->lines = $this->scope->lines;
297
				array_unshift($this->scope->children, $orphan);
298
				$this->scope->lines = array();
299
			}
300
		}
301
302
		$this->scope = $this->scope->parent;
303
		$this->popEnv();
304
	}
305
306
	protected function mediaParent($scope)
307
	{
308
		while (!empty($scope->parent)) {
309
			if (!empty($scope->type) && $scope->type != "media") {
310
				break;
311
			}
312
			$scope = $scope->parent;
313
		}
314
315
		return $scope;
316
	}
317
318
	protected function compileNestedBlock($block, $selectors)
319
	{
320
		$this->pushEnv($block);
321
		$this->scope = $this->makeOutputBlock($block->type, $selectors);
322
		$this->scope->parent->children[] = $this->scope;
323
324
		$this->compileProps($block, $this->scope);
325
326
		$this->scope = $this->scope->parent;
327
		$this->popEnv();
328
	}
329
330
	protected function compileRoot($root)
331
	{
332
		$this->pushEnv();
333
		$this->scope = $this->makeOutputBlock($root->type);
334
		$this->compileProps($root, $this->scope);
335
		$this->popEnv();
336
	}
337
338
	protected function compileProps($block, $out)
339
	{
340
		foreach ($this->sortProps($block->props) as $prop) {
341
			$this->compileProp($prop, $block, $out);
342
		}
343
		$out->lines = $this->deduplicate($out->lines);
344
	}
345
346
	/**
347
	 * Deduplicate lines in a block. Comments are not deduplicated. If a
348
	 * duplicate rule is detected, the comments immediately preceding each
349
	 * occurence are consolidated.
350
	 */
351
	protected function deduplicate($lines)
352
	{
353
		$unique = array();
354
		$comments = array();
355
356
		foreach ($lines as $line) {
357
			if (strpos($line, '/*') === 0) {
358
				$comments[] = $line;
359
				continue;
360
			}
361
			if (!in_array($line, $unique)) {
362
				$unique[] = $line;
363
			}
364
			array_splice($unique, array_search($line, $unique), 0, $comments);
365
			$comments = array();
366
		}
367
		return array_merge($unique, $comments);
368
	}
369
370
	protected function sortProps($props, $split = false)
371
	{
372
		$vars = array();
373
		$imports = array();
374
		$other = array();
375
		$stack = array();
376
377
		foreach ($props as $prop) {
378
			switch ($prop[0]) {
379
				case "comment":
380
					$stack[] = $prop;
381
					break;
382
				case "assign":
383
					$stack[] = $prop;
384
					if (isset($prop[1][0]) && $prop[1][0] == $this->vPrefix) {
385
						$vars = array_merge($vars, $stack);
386
					} else {
387
						$other = array_merge($other, $stack);
388
					}
389
					$stack = array();
390
					break;
391
				case "import":
392
					$id = self::$nextImportId++;
393
					$prop[] = $id;
394
					$stack[] = $prop;
395
					$imports = array_merge($imports, $stack);
396
					$other[] = array("import_mixin", $id);
397
					$stack = array();
398
					break;
399
				default:
400
					$stack[] = $prop;
401
					$other = array_merge($other, $stack);
402
					$stack = array();
403
					break;
404
			}
405
		}
406
		$other = array_merge($other, $stack);
407
408
		if ($split) {
409
			return array(array_merge($imports, $vars), $other);
410
		} else {
411
			return array_merge($imports, $vars, $other);
412
		}
413
	}
414
415
	protected function compileMediaQuery($queries)
416
	{
417
		$compiledQueries = array();
418
		foreach ($queries as $query) {
419
			$parts = array();
420
			foreach ($query as $q) {
421
				switch ($q[0]) {
422
					case "mediaType":
423
						$parts[] = implode(" ", array_slice($q, 1));
424
						break;
425
					case "mediaExp":
426
						if (isset($q[2])) {
427
							$parts[] = "($q[1]: ".
428
								$this->compileValue($this->reduce($q[2])).")";
429
						} else {
430
							$parts[] = "($q[1])";
431
						}
432
						break;
433
					case "variable":
434
						$parts[] = $this->compileValue($this->reduce($q));
435
						break;
436
				}
437
			}
438
439
			if (count($parts) > 0) {
440
				$compiledQueries[] = implode(" and ", $parts);
441
			}
442
		}
443
444
		$out = "@media";
445
		if (!empty($parts)) {
446
			$out .= " ".
447
				implode($this->formatter->selectorSeparator, $compiledQueries);
448
		}
449
		return $out;
450
	}
451
452
	protected function multiplyMedia($env, $childQueries = null)
453
	{
454
		if (is_null($env) ||
455
			!empty($env->block->type) && $env->block->type != "media"
456
		) {
457
			return $childQueries;
458
		}
459
460
		// plain old block, skip
461
		if (empty($env->block->type)) {
462
			return $this->multiplyMedia($env->parent, $childQueries);
463
		}
464
465
		$out = array();
466
		$queries = $env->block->queries;
467
		if (is_null($childQueries)) {
468
			$out = $queries;
469
		} else {
470
			foreach ($queries as $parent) {
471
				foreach ($childQueries as $child) {
472
					$out[] = array_merge($parent, $child);
473
				}
474
			}
475
		}
476
477
		return $this->multiplyMedia($env->parent, $out);
478
	}
479
480
	protected function expandParentSelectors(&$tag, $replace)
481
	{
482
		$parts = explode("$&$", $tag);
483
		$count = 0;
484
		foreach ($parts as &$part) {
485
			$c = 0;
486
			$part = str_replace($this->parentSelector, $replace, $part, $c);
487
			$count += $c;
488
		}
489
		$tag = implode($this->parentSelector, $parts);
490
		return $count;
491
	}
492
493
	protected function findClosestSelectors()
494
	{
495
		$env = $this->env;
496
		$selectors = null;
497
		while ($env !== null) {
498
			if (isset($env->selectors)) {
499
				$selectors = $env->selectors;
500
				break;
501
			}
502
			$env = $env->parent;
503
		}
504
505
		return $selectors;
506
	}
507
508
509
	// multiply $selectors against the nearest selectors in env
510
	protected function multiplySelectors($selectors)
511
	{
512
		// find parent selectors
513
514
		$parentSelectors = $this->findClosestSelectors();
515
		if (is_null($parentSelectors)) {
516
			// kill parent reference in top level selector
517
			foreach ($selectors as &$s) {
518
				$this->expandParentSelectors($s, "");
519
			}
520
521
			return $selectors;
522
		}
523
524
		$out = array();
525
		foreach ($parentSelectors as $parent) {
526
			foreach ($selectors as $child) {
527
				$count = $this->expandParentSelectors($child, $parent);
528
529
				// don't prepend the parent tag if & was used
530
				if ($count > 0) {
531
					$out[] = trim($child);
532
				} else {
533
					$out[] = trim($parent.' '.$child);
534
				}
535
			}
536
		}
537
538
		return $out;
539
	}
540
541
	// reduces selector expressions
542
	protected function compileSelectors($selectors)
543
	{
544
		$out = array();
545
546
		foreach ($selectors as $s) {
547
			if (is_array($s)) {
548
				list(, $value) = $s;
549
				$out[] = trim($this->compileValue($this->reduce($value)));
550
			} else {
551
				$out[] = $s;
552
			}
553
		}
554
555
		return $out;
556
	}
557
558
	protected function eq($left, $right)
559
	{
560
		return $left == $right;
561
	}
562
563
	protected function patternMatch($block, $orderedArgs, $keywordArgs)
564
	{
565
		// match the guards if it has them
566
		// any one of the groups must have all its guards pass for a match
567
		if (!empty($block->guards)) {
568
			$groupPassed = false;
569
			foreach ($block->guards as $guardGroup) {
570
				foreach ($guardGroup as $guard) {
571
					$this->pushEnv();
572
					$this->zipSetArgs($block->args, $orderedArgs, $keywordArgs);
573
574
					$negate = false;
575
					if ($guard[0] == "negate") {
576
						$guard = $guard[1];
577
						$negate = true;
578
					}
579
580
					$passed = $this->reduce($guard) == self::$TRUE;
581
					if ($negate) {
582
						$passed = !$passed;
583
					}
584
585
					$this->popEnv();
586
587
					if ($passed) {
588
						$groupPassed = true;
589
					} else {
590
						$groupPassed = false;
591
						break;
592
					}
593
				}
594
595
				if ($groupPassed) {
596
					break;
597
				}
598
			}
599
600
			if (!$groupPassed) {
601
				return false;
602
			}
603
		}
604
605
		if (empty($block->args)) {
606
			return $block->isVararg || empty($orderedArgs) && empty($keywordArgs);
607
		}
608
609
		$remainingArgs = $block->args;
610
		if ($keywordArgs) {
611
			$remainingArgs = array();
612
			foreach ($block->args as $arg) {
613
				if ($arg[0] == "arg" && isset($keywordArgs[$arg[1]])) {
614
					continue;
615
				}
616
617
				$remainingArgs[] = $arg;
618
			}
619
		}
620
621
		$i = -1; // no args
622
		// try to match by arity or by argument literal
623
		foreach ($remainingArgs as $i => $arg) {
624
			switch ($arg[0]) {
625
				case "lit":
626
					if (empty($orderedArgs[$i]) || !$this->eq($arg[1], $orderedArgs[$i])) {
627
						return false;
628
					}
629
					break;
630
				case "arg":
631
					// no arg and no default value
632
					if (!isset($orderedArgs[$i]) && !isset($arg[2])) {
633
						return false;
634
					}
635
					break;
636
				case "rest":
637
					$i--; // rest can be empty
638
					break 2;
639
			}
640
		}
641
642
		if ($block->isVararg) {
643
			return true; // not having enough is handled above
644
		} else {
645
			$numMatched = $i + 1;
646
			// greater than because default values always match
647
			return $numMatched >= count($orderedArgs);
648
		}
649
	}
650
651
	protected function patternMatchAll($blocks, $orderedArgs, $keywordArgs, $skip = array())
652
	{
653
		$matches = null;
654
		foreach ($blocks as $block) {
655
			// skip seen blocks that don't have arguments
656
			if (isset($skip[$block->id]) && !isset($block->args)) {
657
				continue;
658
			}
659
660
			if ($this->patternMatch($block, $orderedArgs, $keywordArgs)) {
661
				$matches[] = $block;
662
			}
663
		}
664
665
		return $matches;
666
	}
667
668
	// attempt to find blocks matched by path and args
669
	protected function findBlocks($searchIn, $path, $orderedArgs, $keywordArgs, $seen = array())
670
	{
671
		if ($searchIn == null) {
672
			return null;
673
		}
674
		if (isset($seen[$searchIn->id])) {
675
			return null;
676
		}
677
		$seen[$searchIn->id] = true;
678
679
		$name = $path[0];
680
681
		if (isset($searchIn->children[$name])) {
682
			$blocks = $searchIn->children[$name];
683
			if (count($path) == 1) {
684
				$matches = $this->patternMatchAll($blocks, $orderedArgs, $keywordArgs, $seen);
0 ignored issues
show
Bug introduced by
Are you sure the assignment to $matches is correct as $this->patternMatchAll($...s, $keywordArgs, $seen) targeting Dolibarr\Code\Core\Class...essc::patternMatchAll() seems to always return null.

This check looks for function or method calls that always return null and whose return value is assigned to a variable.

class A
{
    function getObject()
    {
        return null;
    }

}

$a = new A();
$object = $a->getObject();

The method getObject() can return nothing but null, so it makes no sense to assign that value to a variable.

The reason is most likely that a function or method is imcomplete or has been reduced for debug purposes.

Loading history...
685
				if (!empty($matches)) {
686
					// This will return all blocks that match in the closest
687
					// scope that has any matching block, like lessjs
688
					return $matches;
689
				}
690
			} else {
691
				$matches = array();
692
				foreach ($blocks as $subBlock) {
693
					$subMatches = $this->findBlocks(
694
						$subBlock,
695
						array_slice($path, 1),
696
						$orderedArgs,
697
						$keywordArgs,
698
						$seen
699
					);
700
701
					if (!is_null($subMatches)) {
702
						foreach ($subMatches as $sm) {
703
							$matches[] = $sm;
704
						}
705
					}
706
				}
707
708
				return count($matches) > 0 ? $matches : null;
709
			}
710
		}
711
		if ($searchIn->parent === $searchIn) {
712
			return null;
713
		}
714
		return $this->findBlocks($searchIn->parent, $path, $orderedArgs, $keywordArgs, $seen);
715
	}
716
717
	// sets all argument names in $args to either the default value
718
	// or the one passed in through $values
719
	protected function zipSetArgs($args, $orderedValues, $keywordValues)
720
	{
721
		$assignedValues = array();
722
723
		$i = 0;
724
		foreach ($args as $a) {
725
			if ($a[0] == "arg") {
726
				if (isset($keywordValues[$a[1]])) {
727
					// has keyword arg
728
					$value = $keywordValues[$a[1]];
729
				} elseif (isset($orderedValues[$i])) {
730
					// has ordered arg
731
					$value = $orderedValues[$i];
732
					$i++;
733
				} elseif (isset($a[2])) {
734
					// has default value
735
					$value = $a[2];
736
				} else {
737
					$value = null; // :(
738
					$this->throwError("Failed to assign arg ".$a[1]); // This ends function by throwing an exception
739
				}
740
741
				$value = $this->reduce($value);
742
				$this->set($a[1], $value);
743
				$assignedValues[] = $value;
744
			} else {
745
				// a lit
746
				$i++;
747
			}
748
		}
749
750
		// check for a rest
751
		$last = end($args);
752
		if ($last && $last[0] == "rest") {
753
			$rest = array_slice($orderedValues, count($args) - 1);
754
			$this->set($last[1], $this->reduce(array("list", " ", $rest)));
755
		}
756
757
		// wow is this the only true use of PHP's + operator for arrays?
758
		$this->env->arguments = $assignedValues + $orderedValues;
759
	}
760
761
	// compile a prop and update $lines or $blocks appropriately
762
	protected function compileProp($prop, $block, $out)
763
	{
764
		// set error position context
765
		$this->sourceLoc = isset($prop[-1]) ? $prop[-1] : -1;
766
767
		switch ($prop[0]) {
768
			case 'assign':
769
				list(, $name, $value) = $prop;
770
				if ($name[0] == $this->vPrefix) {
771
					$this->set($name, $value);
772
				} else {
773
					$out->lines[] = $this->formatter->property(
774
						$name,
775
						$this->compileValue($this->reduce($value))
776
					);
777
				}
778
				break;
779
			case 'block':
780
				list(, $child) = $prop;
781
				$this->compileBlock($child);
782
				break;
783
			case 'mixin':
784
				list(, $path, $args, $suffix) = $prop;
785
786
				$orderedArgs = array();
787
				$keywordArgs = array();
788
				foreach ((array) $args as $arg) {
789
					$argval = null;
790
					switch ($arg[0]) {
791
						case "arg":
792
							if (!isset($arg[2])) {
793
								$orderedArgs[] = $this->reduce(array("variable", $arg[1]));
794
							} else {
795
								$keywordArgs[$arg[1]] = $this->reduce($arg[2]);
796
							}
797
							break;
798
799
						case "lit":
800
							$orderedArgs[] = $this->reduce($arg[1]);
801
							break;
802
						default:
803
							$this->throwError("Unknown arg type: ".$arg[0]);
804
					}
805
				}
806
807
				$mixins = $this->findBlocks($block, $path, $orderedArgs, $keywordArgs);
808
809
				if ($mixins === null) {
810
					$this->throwError("{$prop[1][0]} is undefined");
811
				}
812
813
				foreach ($mixins as $mixin) {
814
					if ($mixin === $block && !$orderedArgs) {
0 ignored issues
show
Bug Best Practice introduced by
The expression $orderedArgs of type array is implicitly converted to a boolean; are you sure this is intended? If so, consider using empty($expr) instead to make it clear that you intend to check for an array without elements.

This check marks implicit conversions of arrays to boolean values in a comparison. While in PHP an empty array is considered to be equal (but not identical) to false, this is not always apparent.

Consider making the comparison explicit by using empty(..) or ! empty(...) instead.

Loading history...
815
						continue;
816
					}
817
818
					$haveScope = false;
819
					if (isset($mixin->parent->scope)) {
820
						$haveScope = true;
821
						$mixinParentEnv = $this->pushEnv();
822
						$mixinParentEnv->storeParent = $mixin->parent->scope;
823
					}
824
825
					$haveArgs = false;
826
					if (isset($mixin->args)) {
827
						$haveArgs = true;
828
						$this->pushEnv();
829
						$this->zipSetArgs($mixin->args, $orderedArgs, $keywordArgs);
830
					}
831
832
					$oldParent = $mixin->parent;
833
					if ($mixin != $block) {
834
						$mixin->parent = $block;
835
					}
836
837
					foreach ($this->sortProps($mixin->props) as $subProp) {
838
						if ($suffix !== null &&
839
							$subProp[0] == "assign" &&
840
							is_string($subProp[1]) &&
841
							$subProp[1][0] != $this->vPrefix
842
						) {
843
							$subProp[2] = array(
844
								'list', ' ',
845
								array($subProp[2], array('keyword', $suffix))
846
							);
847
						}
848
849
						$this->compileProp($subProp, $mixin, $out);
850
					}
851
852
					$mixin->parent = $oldParent;
853
854
					if ($haveArgs) {
855
						$this->popEnv();
856
					}
857
					if ($haveScope) {
858
						$this->popEnv();
859
					}
860
				}
861
862
				break;
863
			case 'raw':
864
				$out->lines[] = $prop[1];
865
				break;
866
			case "directive":
867
				list(, $name, $value) = $prop;
868
				$out->lines[] = "@$name ".$this->compileValue($this->reduce($value)).';';
869
				break;
870
			case "comment":
871
				$out->lines[] = $prop[1];
872
				break;
873
			case "import":
874
				list(, $importPath, $importId) = $prop;
875
				$importPath = $this->reduce($importPath);
876
877
				if (!isset($this->env->imports)) {
878
					$this->env->imports = array();
879
				}
880
881
				$result = $this->tryImport($importPath, $block, $out);
882
883
				$this->env->imports[$importId] = $result === false ?
884
					array(false, "@import ".$this->compileValue($importPath).";") : $result;
885
886
				break;
887
			case "import_mixin":
888
				list(, $importId) = $prop;
889
				$import = $this->env->imports[$importId];
890
				if ($import[0] === false) {
891
					if (isset($import[1])) {
892
						$out->lines[] = $import[1];
893
					}
894
				} else {
895
					list(, $bottom, $parser, $importDir) = $import;
896
					$this->compileImportedProps($bottom, $block, $out, $parser, $importDir);
897
				}
898
899
				break;
900
			default:
901
				$this->throwError("unknown op: {$prop[0]}\n");
902
		}
903
	}
904
905
906
	/**
907
	 * Compiles a primitive value into a CSS property value.
908
	 *
909
	 * Values in lessphp are typed by being wrapped in arrays, their format is
910
	 * typically:
911
	 *
912
	 *     array(type, contents [, additional_contents]*)
913
	 *
914
	 * The input is expected to be reduced. This function will not work on
915
	 * things like expressions and variables.
916
	 */
917
	public function compileValue($value)
918
	{
919
		switch ($value[0]) {
920
			case 'list':
921
				// [1] - delimiter
922
				// [2] - array of values
923
				return implode($value[1], array_map(array($this, 'compileValue'), $value[2]));
924
			case 'raw_color':
925
				if (!empty($this->formatter->compressColors)) {
926
					return $this->compileValue($this->coerceColor($value));
927
				}
928
				return $value[1];
929
			case 'keyword':
930
				// [1] - the keyword
931
				return $value[1];
932
			case 'number':
933
				list(, $num, $unit) = $value;
934
				// [1] - the number
935
				// [2] - the unit
936
				if ($this->numberPrecision !== null) {
937
					$num = round($num, $this->numberPrecision);
938
				}
939
				return $num.$unit;
940
			case 'string':
941
				// [1] - contents of string (includes quotes)
942
				list(, $delim, $content) = $value;
943
				foreach ($content as &$part) {
944
					if (is_array($part)) {
945
						$part = $this->compileValue($part);
946
					}
947
				}
948
				return $delim.implode($content).$delim;
949
			case 'color':
950
				// [1] - red component (either number or a %)
951
				// [2] - green component
952
				// [3] - blue component
953
				// [4] - optional alpha component
954
				list(, $r, $g, $b) = $value;
955
				$r = round($r);
956
				$g = round($g);
957
				$b = round($b);
958
959
				if (count($value) == 5 && $value[4] != 1) { // rgba
960
					return 'rgba('.$r.','.$g.','.$b.','.$value[4].')';
961
				}
962
963
				$h = sprintf("#%02x%02x%02x", $r, $g, $b);
964
965
				if (!empty($this->formatter->compressColors)) {
966
					// Converting hex color to short notation (e.g. #003399 to #039)
967
					if ($h[1] === $h[2] && $h[3] === $h[4] && $h[5] === $h[6]) {
968
						$h = '#'.$h[1].$h[3].$h[5];
969
					}
970
				}
971
972
				return $h;
973
974
			case 'function':
975
				list(, $name, $args) = $value;
976
				return $name.'('.$this->compileValue($args).')';
977
			default: // assumed to be unit
978
				$this->throwError("unknown value type: $value[0]");
979
		}
980
	}
981
982
	protected function lib_pow($args)
983
	{
984
		list($base, $exp) = $this->assertArgs($args, 2, "pow");
985
		return pow($this->assertNumber($base), $this->assertNumber($exp));
986
	}
987
988
	protected function lib_pi()
989
	{
990
		return pi();
991
	}
992
993
	protected function lib_mod($args)
994
	{
995
		list($a, $b) = $this->assertArgs($args, 2, "mod");
996
		return $this->assertNumber($a) % $this->assertNumber($b);
997
	}
998
999
	protected function lib_tan($num)
1000
	{
1001
		return tan($this->assertNumber($num));
1002
	}
1003
1004
	protected function lib_sin($num)
1005
	{
1006
		return sin($this->assertNumber($num));
1007
	}
1008
1009
	protected function lib_cos($num)
1010
	{
1011
		return cos($this->assertNumber($num));
1012
	}
1013
1014
	protected function lib_atan($num)
1015
	{
1016
		$num = atan($this->assertNumber($num));
1017
		return array("number", $num, "rad");
1018
	}
1019
1020
	protected function lib_asin($num)
1021
	{
1022
		$num = asin($this->assertNumber($num));
1023
		return array("number", $num, "rad");
1024
	}
1025
1026
	protected function lib_acos($num)
1027
	{
1028
		$num = acos($this->assertNumber($num));
1029
		return array("number", $num, "rad");
1030
	}
1031
1032
	protected function lib_sqrt($num)
1033
	{
1034
		return sqrt($this->assertNumber($num));
1035
	}
1036
1037
	protected function lib_extract($value)
1038
	{
1039
		list($list, $idx) = $this->assertArgs($value, 2, "extract");
1040
		$idx = $this->assertNumber($idx);
1041
		// 1 indexed
1042
		if ($list[0] == "list" && isset($list[2][$idx - 1])) {
1043
			return $list[2][$idx - 1];
1044
		}
1045
		return '';
1046
	}
1047
1048
	protected function lib_isnumber($value)
1049
	{
1050
		return $this->toBool($value[0] == "number");
1051
	}
1052
1053
	protected function lib_isstring($value)
1054
	{
1055
		return $this->toBool($value[0] == "string");
1056
	}
1057
1058
	protected function lib_iscolor($value)
1059
	{
1060
		return $this->toBool($this->coerceColor($value));
1061
	}
1062
1063
	protected function lib_iskeyword($value)
1064
	{
1065
		return $this->toBool($value[0] == "keyword");
1066
	}
1067
1068
	protected function lib_ispixel($value)
1069
	{
1070
		return $this->toBool($value[0] == "number" && $value[2] == "px");
1071
	}
1072
1073
	protected function lib_ispercentage($value)
1074
	{
1075
		return $this->toBool($value[0] == "number" && $value[2] == "%");
1076
	}
1077
1078
	protected function lib_isem($value)
1079
	{
1080
		return $this->toBool($value[0] == "number" && $value[2] == "em");
1081
	}
1082
1083
	protected function lib_isrem($value)
1084
	{
1085
		return $this->toBool($value[0] == "number" && $value[2] == "rem");
1086
	}
1087
1088
	protected function lib_rgbahex($color)
1089
	{
1090
		$color = $this->coerceColor($color);
1091
		if (is_null($color)) {
1092
			$this->throwError("color expected for rgbahex");
1093
		}
1094
1095
		return sprintf(
1096
			"#%02x%02x%02x%02x",
1097
			isset($color[4]) ? $color[4] * 255 : 255,
1098
			$color[1],
1099
			$color[2],
1100
			$color[3]
1101
		);
1102
	}
1103
1104
	protected function lib_argb($color)
1105
	{
1106
		return $this->lib_rgbahex($color);
1107
	}
1108
1109
	/**
1110
	 * Given an url, decide whether to output a regular link or the base64-encoded contents of the file
1111
	 *
1112
	 * @param  array  $value either an argument list (two strings) or a single string
1113
	 * @return string        formatted url(), either as a link or base64-encoded
1114
	 */
1115
	protected function lib_data_uri($value)
1116
	{
1117
		$mime = ($value[0] === 'list') ? $value[2][0][2] : null;
1118
		$url = ($value[0] === 'list') ? $value[2][1][2][0] : $value[2][0];
1119
1120
		$fullpath = $this->findImport($url);
1121
1122
		if ($fullpath && ($fsize = filesize($fullpath)) !== false) {
1123
			// IE8 can't handle data uris larger than 32KB
1124
			if ($fsize / 1024 < 32) {
1125
				if (is_null($mime)) {
1126
					if (class_exists('finfo')) { // php 5.3+
1127
						$finfo = new finfo(FILEINFO_MIME);
0 ignored issues
show
Bug introduced by
The type Dolibarr\Code\Core\Classes\finfo was not found. Did you mean finfo? If so, make sure to prefix the type with \.
Loading history...
1128
						$mime = explode('; ', $finfo->file($fullpath));
1129
						$mime = $mime[0];
1130
					} elseif (function_exists('mime_content_type')) { // PHP 5.2
1131
						$mime = mime_content_type($fullpath);
1132
					}
1133
				}
1134
1135
				if (!is_null($mime)) { // fallback if the mime type is still unknown
1136
					$url = sprintf('data:%s;base64,%s', $mime, base64_encode(file_get_contents($fullpath)));
1137
				}
1138
			}
1139
		}
1140
1141
		return 'url("'.$url.'")';
1142
	}
1143
1144
	// utility func to unquote a string
1145
	protected function lib_e($arg)
1146
	{
1147
		switch ($arg[0]) {
1148
			case "list":
1149
				$items = $arg[2];
1150
				if (isset($items[0])) {
1151
					return $this->lib_e($items[0]);
1152
				}
1153
				$this->throwError("unrecognised input"); // This ends function by throwing an exception
1154
				// no break
1155
			case "string":
1156
				$arg[1] = "";
1157
				return $arg;
1158
			case "keyword":
1159
				return $arg;
1160
			default:
1161
				return array("keyword", $this->compileValue($arg));
1162
		}
1163
	}
1164
1165
	protected function lib__sprintf($args)
1166
	{
1167
		if ($args[0] != "list") {
1168
			return $args;
1169
		}
1170
		$values = $args[2];
1171
		$string = array_shift($values);
1172
		$template = $this->compileValue($this->lib_e($string));
1173
1174
		$i = 0;
1175
		$m = array();
1176
		if (preg_match_all('/%[dsa]/', $template, $m)) {
1177
			foreach ($m[0] as $match) {
1178
				$val = isset($values[$i]) ?
1179
					$this->reduce($values[$i]) : array('keyword', '');
1180
1181
				// lessjs compat, renders fully expanded color, not raw color
1182
				if ($color = $this->coerceColor($val)) {
1183
					$val = $color;
1184
				}
1185
1186
				$i++;
1187
				$rep = $this->compileValue($this->lib_e($val));
1188
				$template = preg_replace(
1189
					'/'.self::preg_quote($match).'/',
1190
					$rep,
1191
					$template,
1192
					1
1193
				);
1194
			}
1195
		}
1196
1197
		$d = $string[0] == "string" ? $string[1] : '"';
1198
		return array("string", $d, array($template));
1199
	}
1200
1201
	protected function lib_floor($arg)
1202
	{
1203
		$value = $this->assertNumber($arg);
1204
		return array("number", floor($value), $arg[2]);
1205
	}
1206
1207
	protected function lib_ceil($arg)
1208
	{
1209
		$value = $this->assertNumber($arg);
1210
		return array("number", ceil($value), $arg[2]);
1211
	}
1212
1213
	protected function lib_round($arg)
1214
	{
1215
		if ($arg[0] != "list") {
1216
			$value = $this->assertNumber($arg);
1217
			return array("number", round($value), $arg[2]);
1218
		} else {
1219
			$value = $this->assertNumber($arg[2][0]);
1220
			$precision = $this->assertNumber($arg[2][1]);
1221
			return array("number", round($value, $precision), $arg[2][0][2]);
1222
		}
1223
	}
1224
1225
	protected function lib_unit($arg)
1226
	{
1227
		if ($arg[0] == "list") {
1228
			list($number, $newUnit) = $arg[2];
1229
			return array("number", $this->assertNumber($number),
1230
				$this->compileValue($this->lib_e($newUnit)));
1231
		} else {
1232
			return array("number", $this->assertNumber($arg), "");
1233
		}
1234
	}
1235
1236
	/**
1237
	 * Helper function to get arguments for color manipulation functions.
1238
	 * takes a list that contains a color like thing and a percentage
1239
	 */
1240
	public function colorArgs($args)
1241
	{
1242
		if ($args[0] != 'list' || count($args[2]) < 2) {
1243
			return array(array('color', 0, 0, 0), 0);
1244
		}
1245
		list($color, $delta) = $args[2];
1246
		$color = $this->assertColor($color);
1247
		$delta = (float) $delta[1];
1248
1249
		return array($color, $delta);
1250
	}
1251
1252
	protected function lib_darken($args)
1253
	{
1254
		list($color, $delta) = $this->colorArgs($args);
1255
1256
		$hsl = $this->toHSL($color);
1257
		$hsl[3] = $this->clamp($hsl[3] - $delta, 100);
1258
		return $this->toRGB($hsl);
1259
	}
1260
1261
	protected function lib_lighten($args)
1262
	{
1263
		list($color, $delta) = $this->colorArgs($args);
1264
1265
		$hsl = $this->toHSL($color);
1266
		$hsl[3] = $this->clamp($hsl[3] + $delta, 100);
1267
		return $this->toRGB($hsl);
1268
	}
1269
1270
	protected function lib_saturate($args)
1271
	{
1272
		list($color, $delta) = $this->colorArgs($args);
1273
1274
		$hsl = $this->toHSL($color);
1275
		$hsl[2] = $this->clamp($hsl[2] + $delta, 100);
1276
		return $this->toRGB($hsl);
1277
	}
1278
1279
	protected function lib_desaturate($args)
1280
	{
1281
		list($color, $delta) = $this->colorArgs($args);
1282
1283
		$hsl = $this->toHSL($color);
1284
		$hsl[2] = $this->clamp($hsl[2] - $delta, 100);
1285
		return $this->toRGB($hsl);
1286
	}
1287
1288
	protected function lib_spin($args)
1289
	{
1290
		list($color, $delta) = $this->colorArgs($args);
1291
1292
		$hsl = $this->toHSL($color);
1293
1294
		$hsl[1] = $hsl[1] + $delta % 360;
1295
		if ($hsl[1] < 0) {
1296
			$hsl[1] += 360;
1297
		}
1298
1299
		return $this->toRGB($hsl);
1300
	}
1301
1302
	protected function lib_fadeout($args)
1303
	{
1304
		list($color, $delta) = $this->colorArgs($args);
1305
		$color[4] = $this->clamp((isset($color[4]) ? $color[4] : 1) - $delta / 100);
1306
		return $color;
1307
	}
1308
1309
	protected function lib_fadein($args)
1310
	{
1311
		list($color, $delta) = $this->colorArgs($args);
1312
		$color[4] = $this->clamp((isset($color[4]) ? $color[4] : 1) + $delta / 100);
1313
		return $color;
1314
	}
1315
1316
	protected function lib_hue($color)
1317
	{
1318
		$hsl = $this->toHSL($this->assertColor($color));
1319
		return round($hsl[1]);
1320
	}
1321
1322
	protected function lib_saturation($color)
1323
	{
1324
		$hsl = $this->toHSL($this->assertColor($color));
1325
		return round($hsl[2]);
1326
	}
1327
1328
	protected function lib_lightness($color)
1329
	{
1330
		$hsl = $this->toHSL($this->assertColor($color));
1331
		return round($hsl[3]);
1332
	}
1333
1334
	// get the alpha of a color
1335
	// defaults to 1 for non-colors or colors without an alpha
1336
	protected function lib_alpha($value)
1337
	{
1338
		if (!is_null($color = $this->coerceColor($value))) {
1339
			return isset($color[4]) ? $color[4] : 1;
1340
		}
1341
		return '';
1342
	}
1343
1344
	// set the alpha of the color
1345
	protected function lib_fade($args)
1346
	{
1347
		list($color, $alpha) = $this->colorArgs($args);
1348
		$color[4] = $this->clamp($alpha / 100.0);
1349
		return $color;
1350
	}
1351
1352
	protected function lib_percentage($arg)
1353
	{
1354
		$num = $this->assertNumber($arg);
1355
		return array("number", $num * 100, "%");
1356
	}
1357
1358
	/**
1359
	 * Mix color with white in variable proportion.
1360
	 *
1361
	 * It is the same as calling `mix(#ffffff, @color, @weight)`.
1362
	 *
1363
	 *     tint(@color, [@weight: 50%]);
1364
	 *
1365
	 * http://lesscss.org/functions/#color-operations-tint
1366
	 *
1367
	 * @return array Color
1368
	 */
1369
	protected function lib_tint($args)
1370
	{
1371
		$white = ['color', 255, 255, 255];
1372
		if ($args[0] == 'color') {
1373
			return $this->lib_mix(['list', ',', [$white, $args]]);
1374
		} elseif ($args[0] == "list" && count($args[2]) == 2) {
1375
			return $this->lib_mix([$args[0], $args[1], [$white, $args[2][0], $args[2][1]]]);
1376
		} else {
1377
			$this->throwError("tint expects (color, weight)");
1378
		}
1379
		return array();
1380
	}
1381
1382
	/**
1383
	 * Mix color with black in variable proportion.
1384
	 *
1385
	 * It is the same as calling `mix(#000000, @color, @weight)`
1386
	 *
1387
	 *     shade(@color, [@weight: 50%]);
1388
	 *
1389
	 * http://lesscss.org/functions/#color-operations-shade
1390
	 *
1391
	 * @return array Color
1392
	 */
1393
	protected function lib_shade($args)
1394
	{
1395
		$black = ['color', 0, 0, 0];
1396
		if ($args[0] == 'color') {
1397
			return $this->lib_mix(['list', ',', [$black, $args]]);
1398
		} elseif ($args[0] == "list" && count($args[2]) == 2) {
1399
			return $this->lib_mix([$args[0], $args[1], [$black, $args[2][0], $args[2][1]]]);
1400
		} else {
1401
			$this->throwError("shade expects (color, weight)");
1402
		}
1403
		return array();
1404
	}
1405
1406
	/**
1407
	 * lib_mix
1408
	 * mixes two colors by weight
1409
	 * mix(@color1, @color2, [@weight: 50%]);
1410
	 * http://sass-lang.com/docs/yardoc/Sass/Script/Functions.html#mix-instance_method
1411
	 *
1412
	 * @param array         $args   Args
1413
	 * @return array
1414
	 */
1415
	protected function lib_mix($args)
1416
	{
1417
		if ($args[0] != "list" || count($args[2]) < 2) {
1418
			$this->throwError("mix expects (color1, color2, weight)");
1419
		}
1420
1421
		list($first, $second) = $args[2];
1422
		$first = $this->assertColor($first);
1423
		$second = $this->assertColor($second);
1424
1425
		$first_a = $this->lib_alpha($first);
1426
		$second_a = $this->lib_alpha($second);
1427
1428
		if (isset($args[2][2])) {
1429
			$weight = $args[2][2][1] / 100.0;
1430
		} else {
1431
			$weight = 0.5;
1432
		}
1433
1434
		$w = $weight * 2 - 1;
1435
		$a = $first_a - $second_a;
1436
1437
		$w1 = (($w * $a == -1 ? $w : ($w + $a) / (1 + $w * $a)) + 1) / 2.0;
1438
		$w2 = 1.0 - $w1;
1439
1440
		$new = array('color',
1441
			$w1 * $first[1] + $w2 * $second[1],
1442
			$w1 * $first[2] + $w2 * $second[2],
1443
			$w1 * $first[3] + $w2 * $second[3],
1444
		);
1445
1446
		if ($first_a != 1.0 || $second_a != 1.0) {
1447
			$new[] = $first_a * $weight + $second_a * ($weight - 1);
1448
		}
1449
1450
		return $this->fixColor($new);
1451
	}
1452
1453
	/**
1454
	 * lib_contrast
1455
	 *
1456
	 * @param array         $args   Args
1457
	 * @return array
1458
	 */
1459
	protected function lib_contrast($args)
1460
	{
1461
		$darkColor  = array('color', 0, 0, 0);
1462
		$lightColor = array('color', 255, 255, 255);
1463
		$threshold  = 0.43;
1464
1465
		if ($args[0] == 'list') {
1466
			$inputColor = (isset($args[2][0])) ? $this->assertColor($args[2][0]) : $lightColor;
1467
			$darkColor  = (isset($args[2][1])) ? $this->assertColor($args[2][1]) : $darkColor;
1468
			$lightColor = (isset($args[2][2])) ? $this->assertColor($args[2][2]) : $lightColor;
1469
			$threshold  = (isset($args[2][3])) ? $this->assertNumber($args[2][3]) : $threshold;
1470
		} else {
1471
			$inputColor = $this->assertColor($args);
1472
		}
1473
1474
		$inputColor = $this->coerceColor($inputColor);
1475
		$darkColor  = $this->coerceColor($darkColor);
1476
		$lightColor = $this->coerceColor($lightColor);
1477
1478
		//Figure out which is actually light and dark!
1479
		if ($this->toLuma($darkColor) > $this->toLuma($lightColor)) {
1480
			$t = $lightColor;
1481
			$lightColor = $darkColor;
1482
			$darkColor  = $t;
1483
		}
1484
1485
		$inputColor_alpha = $this->lib_alpha($inputColor);
1486
		if (($this->toLuma($inputColor) * $inputColor_alpha) < $threshold) {
1487
			return $lightColor;
1488
		}
1489
		return $darkColor;
1490
	}
1491
1492
	private function toLuma($color)
1493
	{
1494
		list(, $r, $g, $b) = $this->coerceColor($color);
1495
1496
		$r = $r / 255;
1497
		$g = $g / 255;
1498
		$b = $b / 255;
1499
1500
		$r = ($r <= 0.03928) ? $r / 12.92 : pow((($r + 0.055) / 1.055), 2.4);
1501
		$g = ($g <= 0.03928) ? $g / 12.92 : pow((($g + 0.055) / 1.055), 2.4);
1502
		$b = ($b <= 0.03928) ? $b / 12.92 : pow((($b + 0.055) / 1.055), 2.4);
1503
1504
		return (0.2126 * $r) + (0.7152 * $g) + (0.0722 * $b);
1505
	}
1506
1507
	protected function lib_luma($color)
1508
	{
1509
		return array("number", round($this->toLuma($color) * 100, 8), "%");
1510
	}
1511
1512
1513
	public function assertColor($value, $error = "expected color value")
1514
	{
1515
		$color = $this->coerceColor($value);
1516
		if (is_null($color)) {
1517
			$this->throwError($error);
1518
		}
1519
		return $color;
1520
	}
1521
1522
	public function assertNumber($value, $error = "expecting number")
1523
	{
1524
		if ($value[0] == "number") {
1525
			return $value[1];
1526
		}
1527
		$this->throwError($error);
1528
	}
1529
1530
	public function assertArgs($value, $expectedArgs, $name = "")
1531
	{
1532
		if ($expectedArgs == 1) {
1533
			return $value;
1534
		} else {
1535
			if ($value[0] !== "list" || $value[1] != ",") {
1536
				$this->throwError("expecting list");
1537
			}
1538
			$values = $value[2];
1539
			$numValues = count($values);
1540
			if ($expectedArgs != $numValues) {
1541
				if ($name) {
1542
					$name = $name.": ";
1543
				}
1544
1545
				$this->throwError("{$name}expecting $expectedArgs arguments, got $numValues");
1546
			}
1547
1548
			return $values;
1549
		}
1550
	}
1551
1552
	protected function toHSL($color)
1553
	{
1554
		if ($color[0] === 'hsl') {
1555
			return $color;
1556
		}
1557
1558
		$r = $color[1] / 255;
1559
		$g = $color[2] / 255;
1560
		$b = $color[3] / 255;
1561
1562
		$min = min($r, $g, $b);
1563
		$max = max($r, $g, $b);
1564
1565
		$L = ($min + $max) / 2;
1566
		if ($min == $max) {
1567
			$S = $H = 0;
1568
		} else {
1569
			if ($L < 0.5) {
1570
				$S = ($max - $min) / ($max + $min);
1571
			} else {
1572
				$S = ($max - $min) / (2.0 - $max - $min);
1573
			}
1574
			if ($r == $max) {
1575
				$H = ($g - $b) / ($max - $min);
1576
			} elseif ($g == $max) {
1577
				$H = 2.0 + ($b - $r) / ($max - $min);
1578
			} elseif ($b == $max) {
1579
				$H = 4.0 + ($r - $g) / ($max - $min);
1580
			}
1581
		}
1582
1583
		$out = array('hsl',
1584
			($H < 0 ? $H + 6 : $H) * 60,
1585
			$S * 100,
1586
			$L * 100,
1587
		);
1588
1589
		if (count($color) > 4) {
1590
			// copy alpha
1591
			$out[] = $color[4];
1592
		}
1593
		return $out;
1594
	}
1595
1596
	protected function toRGB_helper($comp, $temp1, $temp2)
1597
	{
1598
		if ($comp < 0) {
1599
			$comp += 1.0;
1600
		} elseif ($comp > 1) {
1601
			$comp -= 1.0;
1602
		}
1603
1604
		if (6 * $comp < 1) {
1605
			return $temp1 + ($temp2 - $temp1) * 6 * $comp;
1606
		}
1607
		if (2 * $comp < 1) {
1608
			return $temp2;
1609
		}
1610
		if (3 * $comp < 2) {
1611
			return $temp1 + ($temp2 - $temp1) * ((2 / 3) - $comp) * 6;
1612
		}
1613
1614
		return $temp1;
1615
	}
1616
1617
	/**
1618
	 * Converts a hsl array into a color value in rgb.
1619
	 * Expects H to be in range of 0 to 360, S and L in 0 to 100
1620
	 */
1621
	protected function toRGB($color)
1622
	{
1623
		if ($color[0] === 'color') {
1624
			return $color;
1625
		}
1626
1627
		$H = $color[1] / 360;
1628
		$S = $color[2] / 100;
1629
		$L = $color[3] / 100;
1630
1631
		if ($S == 0) {
1632
			$r = $g = $b = $L;
1633
		} else {
1634
			$temp2 = $L < 0.5 ?
1635
				$L * (1.0 + $S) : $L + $S - $L * $S;
1636
1637
			$temp1 = 2.0 * $L - $temp2;
1638
1639
			$r = $this->toRGB_helper($H + 1 / 3, $temp1, $temp2);
1640
			$g = $this->toRGB_helper($H, $temp1, $temp2);
1641
			$b = $this->toRGB_helper($H - 1 / 3, $temp1, $temp2);
1642
		}
1643
1644
		// $out = array('color', round($r*255), round($g*255), round($b*255));
1645
		$out = array('color', $r * 255, $g * 255, $b * 255);
1646
		if (count($color) > 4) {
1647
			// copy alpha
1648
			$out[] = $color[4];
1649
		}
1650
		return $out;
1651
	}
1652
1653
	protected function clamp($v, $max = 1, $min = 0)
1654
	{
1655
		return min($max, max($min, $v));
1656
	}
1657
1658
	/**
1659
	 * Convert the rgb, rgba, hsl color literals of function type
1660
	 * as returned by the parser into values of color type.
1661
	 */
1662
	protected function funcToColor($func)
1663
	{
1664
		$fname = $func[1];
1665
		if ($func[2][0] != 'list') {
1666
			// need a list of arguments
1667
			return false;
1668
		}
1669
		$rawComponents = $func[2][2];
1670
1671
		if ($fname == 'hsl' || $fname == 'hsla') {
1672
			$hsl = array('hsl');
1673
			$i = 0;
1674
			foreach ($rawComponents as $c) {
1675
				$val = $this->reduce($c);
1676
				$val = isset($val[1]) ? (float) $val[1] : 0;
1677
1678
				if ($i == 0) {
1679
					$clamp = 360;
1680
				} elseif ($i < 3) {
1681
					$clamp = 100;
1682
				} else {
1683
					$clamp = 1;
1684
				}
1685
1686
				$hsl[] = $this->clamp($val, $clamp);
1687
				$i++;
1688
			}
1689
1690
			while (count($hsl) < 4) {
1691
				$hsl[] = 0;
1692
			}
1693
			return $this->toRGB($hsl);
1694
1695
		} elseif ($fname == 'rgb' || $fname == 'rgba') {
1696
			$components = array();
1697
			$i = 1;
1698
			foreach ($rawComponents as $c) {
1699
				$c = $this->reduce($c);
1700
				if ($i < 4) {
1701
					if ($c[0] == "number" && $c[2] == "%") {
1702
						$components[] = 255 * ($c[1] / 100);
1703
					} else {
1704
						$components[] = (float) $c[1];
1705
					}
1706
				} elseif ($i == 4) {
1707
					if ($c[0] == "number" && $c[2] == "%") {
1708
						$components[] = 1.0 * ($c[1] / 100);
1709
					} else {
1710
						$components[] = (float) $c[1];
1711
					}
1712
				} else {
1713
					break;
1714
				}
1715
1716
				$i++;
1717
			}
1718
			while (count($components) < 3) {
1719
				$components[] = 0;
1720
			}
1721
			array_unshift($components, 'color');
1722
			return $this->fixColor($components);
1723
		}
1724
1725
		return false;
1726
	}
1727
1728
	protected function reduce($value, $forExpression = false)
1729
	{
1730
		switch ($value[0]) {
1731
			case "interpolate":
1732
				$reduced = $this->reduce($value[1]);
1733
				$var = $this->compileValue($reduced);
1734
				$res = $this->reduce(array("variable", $this->vPrefix.$var));
1735
1736
				if ($res[0] == "raw_color") {
1737
					$res = $this->coerceColor($res);
1738
				}
1739
1740
				if (empty($value[2])) {
1741
					$res = $this->lib_e($res);
1742
				}
1743
1744
				return $res;
1745
			case "variable":
1746
				$key = $value[1];
1747
				if (is_array($key)) {
1748
					$key = $this->reduce($key);
1749
					$key = $this->vPrefix.$this->compileValue($this->lib_e($key));
1750
				}
1751
1752
				$seen = & $this->env->seenNames;
1753
1754
				if (!empty($seen[$key])) {
1755
					$this->throwError("infinite loop detected: $key");
1756
				}
1757
1758
				$seen[$key] = true;
1759
				$out = $this->reduce($this->get($key));
1760
				$seen[$key] = false;
1761
				return $out;
1762
			case "list":
1763
				foreach ($value[2] as &$item) {
1764
					$item = $this->reduce($item, $forExpression);
1765
				}
1766
				return $value;
1767
			case "expression":
1768
				return $this->evaluate($value);
1769
			case "string":
1770
				foreach ($value[2] as &$part) {
1771
					if (is_array($part)) {
1772
						$strip = $part[0] == "variable";
1773
						$part = $this->reduce($part);
1774
						if ($strip) {
1775
							$part = $this->lib_e($part);
1776
						}
1777
					}
1778
				}
1779
				return $value;
1780
			case "escape":
1781
				list(, $inner) = $value;
1782
				return $this->lib_e($this->reduce($inner));
1783
			case "function":
1784
				$color = $this->funcToColor($value);
1785
				if ($color) {
1786
					return $color;
1787
				}
1788
1789
				list(, $name, $args) = $value;
1790
				if ($name == "%") {
1791
					$name = "_sprintf";
1792
				}
1793
1794
				$f = isset($this->libFunctions[$name]) ?
1795
					$this->libFunctions[$name] : array($this, 'lib_'.str_replace('-', '_', $name));
1796
1797
				if (is_callable($f)) {
1798
					if ($args[0] == 'list') {
1799
						$args = self::compressList($args[2], $args[1]);
1800
					}
1801
1802
					$ret = call_user_func($f, $this->reduce($args, true), $this);
1803
1804
					if (is_null($ret)) {
1805
						return array("string", "", array(
1806
							$name, "(", $args, ")"
1807
						));
1808
					}
1809
1810
					// convert to a typed value if the result is a php primitive
1811
					if (is_numeric($ret)) {
1812
						$ret = array('number', $ret, "");
1813
					} elseif (!is_array($ret)) {
1814
						$ret = array('keyword', $ret);
1815
					}
1816
1817
					return $ret;
1818
				}
1819
1820
				// plain function, reduce args
1821
				$value[2] = $this->reduce($value[2]);
1822
				return $value;
1823
			case "unary":
1824
				list(, $op, $exp) = $value;
1825
				$exp = $this->reduce($exp);
1826
1827
				if ($exp[0] == "number") {
1828
					switch ($op) {
1829
						case "+":
1830
							return $exp;
1831
						case "-":
1832
							$exp[1] *= -1;
1833
							return $exp;
1834
					}
1835
				}
1836
				return array("string", "", array($op, $exp));
1837
		}
1838
1839
		if ($forExpression) {
1840
			switch ($value[0]) {
1841
				case "keyword":
1842
					if ($color = $this->coerceColor($value)) {
1843
						return $color;
1844
					}
1845
					break;
1846
				case "raw_color":
1847
					return $this->coerceColor($value);
1848
			}
1849
		}
1850
1851
		return $value;
1852
	}
1853
1854
1855
	// coerce a value for use in color operation
1856
	protected function coerceColor($value)
1857
	{
1858
		switch ($value[0]) {
1859
			case 'color':
1860
				return $value;
1861
			case 'raw_color':
1862
				$c = array("color", 0, 0, 0);
1863
				$colorStr = substr($value[1], 1);
1864
				$num = hexdec($colorStr);
1865
				$width = strlen($colorStr) == 3 ? 16 : 256;
1866
1867
				for ($i = 3; $i > 0; $i--) { // 3 2 1
1868
					$t = intval($num) % $width;
1869
					$num /= $width;
1870
1871
					$c[$i] = $t * (256 / $width) + $t * floor(16/$width);
1872
				}
1873
1874
				return $c;
1875
			case 'keyword':
1876
				$name = $value[1];
1877
				if (isset(self::$cssColors[$name])) {
1878
					$rgba = explode(',', self::$cssColors[$name]);
1879
1880
					if (isset($rgba[3])) {
1881
						return array('color', $rgba[0], $rgba[1], $rgba[2], $rgba[3]);
1882
					}
1883
					return array('color', $rgba[0], $rgba[1], $rgba[2]);
1884
				}
1885
				return null;
1886
		}
1887
		return null;
1888
	}
1889
1890
	// make something string like into a string
1891
	protected function coerceString($value)
1892
	{
1893
		switch ($value[0]) {
1894
			case "string":
1895
				return $value;
1896
			case "keyword":
1897
				return array("string", "", array($value[1]));
1898
		}
1899
		return null;
1900
	}
1901
1902
	// turn list of length 1 into value type
1903
	protected function flattenList($value)
1904
	{
1905
		if ($value[0] == "list" && count($value[2]) == 1) {
1906
			return $this->flattenList($value[2][0]);
1907
		}
1908
		return $value;
1909
	}
1910
1911
	public function toBool($a)
1912
	{
1913
		return $a ? self::$TRUE : self::$FALSE;
1914
	}
1915
1916
	// evaluate an expression
1917
	protected function evaluate($exp)
1918
	{
1919
		list(, $op, $left, $right, $whiteBefore, $whiteAfter) = $exp;
1920
1921
		$left = $this->reduce($left, true);
1922
		$right = $this->reduce($right, true);
1923
1924
		if ($leftColor = $this->coerceColor($left)) {
1925
			$left = $leftColor;
1926
		}
1927
1928
		if ($rightColor = $this->coerceColor($right)) {
1929
			$right = $rightColor;
1930
		}
1931
1932
		$ltype = $left[0];
1933
		$rtype = $right[0];
1934
1935
		// operators that work on all types
1936
		if ($op == "and") {
1937
			return $this->toBool($left == self::$TRUE && $right == self::$TRUE);
1938
		}
1939
1940
		if ($op == "=") {
1941
			return $this->toBool($this->eq($left, $right));
1942
		}
1943
1944
		if ($op == "+" && !is_null($str = $this->stringConcatenate($left, $right))) {
1945
			return $str;
1946
		}
1947
1948
		// type based operators
1949
		$fname = "op_{$ltype}_{$rtype}";
1950
		if (is_callable(array($this, $fname))) {
1951
			$out = $this->$fname($op, $left, $right);
1952
			if (!is_null($out)) {
1953
				return $out;
1954
			}
1955
		}
1956
1957
		// make the expression look it did before being parsed
1958
		$paddedOp = $op;
1959
		if ($whiteBefore) {
1960
			$paddedOp = " ".$paddedOp;
1961
		}
1962
		if ($whiteAfter) {
1963
			$paddedOp .= " ";
1964
		}
1965
1966
		return array("string", "", array($left, $paddedOp, $right));
1967
	}
1968
1969
	protected function stringConcatenate($left, $right)
1970
	{
1971
		if ($strLeft = $this->coerceString($left)) {
1972
			if ($right[0] == "string") {
1973
				$right[1] = "";
1974
			}
1975
			$strLeft[2][] = $right;
1976
			return $strLeft;
1977
		}
1978
1979
		if ($strRight = $this->coerceString($right)) {
1980
			array_unshift($strRight[2], $left);
1981
			return $strRight;
1982
		}
1983
		return '';
1984
	}
1985
1986
1987
	// make sure a color's components don't go out of bounds
1988
	protected function fixColor($c)
1989
	{
1990
		foreach (range(1, 3) as $i) {
1991
			if ($c[$i] < 0) {
1992
				$c[$i] = 0;
1993
			}
1994
			if ($c[$i] > 255) {
1995
				$c[$i] = 255;
1996
			}
1997
		}
1998
1999
		return $c;
2000
	}
2001
2002
	protected function op_number_color($op, $lft, $rgt)
2003
	{
2004
		if ($op == '+' || $op == '*') {
2005
			return $this->op_color_number($op, $rgt, $lft);
2006
		}
2007
		return array();
2008
	}
2009
2010
	protected function op_color_number($op, $lft, $rgt)
2011
	{
2012
		if ($rgt[0] == '%') {
2013
			$rgt[1] /= 100;
2014
		}
2015
2016
		return $this->op_color_color(
2017
			$op,
2018
			$lft,
2019
			array_fill(1, count($lft) - 1, $rgt[1])
2020
		);
2021
	}
2022
2023
	protected function op_color_color($op, $left, $right)
2024
	{
2025
		$out = array('color');
2026
		$max = count($left) > count($right) ? count($left) : count($right);
2027
		foreach (range(1, $max - 1) as $i) {
2028
			$lval = isset($left[$i]) ? $left[$i] : 0;
2029
			$rval = isset($right[$i]) ? $right[$i] : 0;
2030
			switch ($op) {
2031
				case '+':
2032
					$out[] = $lval + $rval;
2033
					break;
2034
				case '-':
2035
					$out[] = $lval - $rval;
2036
					break;
2037
				case '*':
2038
					$out[] = $lval * $rval;
2039
					break;
2040
				case '%':
2041
					$out[] = $lval % $rval;
2042
					break;
2043
				case '/':
2044
					if ($rval == 0) {
2045
						$this->throwError("evaluate error: can't divide by zero");
2046
					}
2047
					$out[] = $lval / $rval;
2048
					break;
2049
				default:
2050
					$this->throwError('evaluate error: color op number failed on op '.$op);
2051
			}
2052
		}
2053
		return $this->fixColor($out);
2054
	}
2055
2056
	public function lib_red($color)
2057
	{
2058
		$color = $this->coerceColor($color);
2059
		if (is_null($color)) {
2060
			$this->throwError('color expected for red()');
2061
		}
2062
2063
		return $color[1];
2064
	}
2065
2066
	public function lib_green($color)
2067
	{
2068
		$color = $this->coerceColor($color);
2069
		if (is_null($color)) {
2070
			$this->throwError('color expected for green()');
2071
		}
2072
2073
		return $color[2];
2074
	}
2075
2076
	public function lib_blue($color)
2077
	{
2078
		$color = $this->coerceColor($color);
2079
		if (is_null($color)) {
2080
			$this->throwError('color expected for blue()');
2081
		}
2082
2083
		return $color[3];
2084
	}
2085
2086
2087
	// operator on two numbers
2088
	protected function op_number_number($op, $left, $right)
2089
	{
2090
		$unit = empty($left[2]) ? $right[2] : $left[2];
2091
2092
		$value = 0;
2093
		switch ($op) {
2094
			case '+':
2095
				$value = $left[1] + $right[1];
2096
				break;
2097
			case '*':
2098
				$value = $left[1] * $right[1];
2099
				break;
2100
			case '-':
2101
				$value = $left[1] - $right[1];
2102
				break;
2103
			case '%':
2104
				$value = $left[1] % $right[1];
2105
				break;
2106
			case '/':
2107
				if ($right[1] == 0) {
2108
					$this->throwError('parse error: divide by zero');
2109
				}
2110
				$value = $left[1] / $right[1];
2111
				break;
2112
			case '<':
2113
				return $this->toBool($left[1] < $right[1]);
2114
			case '>':
2115
				return $this->toBool($left[1] > $right[1]);
2116
			case '>=':
2117
				return $this->toBool($left[1] >= $right[1]);
2118
			case '=<':
2119
				return $this->toBool($left[1] <= $right[1]);
2120
			default:
2121
				$this->throwError('parse error: unknown number operator: '.$op);
2122
		}
2123
2124
		return array("number", $value, $unit);
2125
	}
2126
2127
2128
	/* environment functions */
2129
2130
	protected function makeOutputBlock($type, $selectors = null)
2131
	{
2132
		$b = new stdclass();
0 ignored issues
show
Bug introduced by
The type Dolibarr\Code\Core\Classes\stdclass was not found. Did you mean stdclass? If so, make sure to prefix the type with \.
Loading history...
2133
		$b->lines = array();
2134
		$b->children = array();
2135
		$b->selectors = $selectors;
2136
		$b->type = $type;
2137
		$b->parent = $this->scope;
2138
		return $b;
2139
	}
2140
2141
	// the state of execution
2142
	protected function pushEnv($block = null)
2143
	{
2144
		$e = new stdclass();
2145
		$e->parent = $this->env;
2146
		$e->store = array();
2147
		$e->block = $block;
2148
2149
		$this->env = $e;
2150
		return $e;
2151
	}
2152
2153
	// pop something off the stack
2154
	protected function popEnv()
2155
	{
2156
		$old = $this->env;
2157
		$this->env = $this->env->parent;
2158
		return $old;
2159
	}
2160
2161
	// set something in the current env
2162
	protected function set($name, $value)
2163
	{
2164
		$this->env->store[$name] = $value;
2165
	}
2166
2167
2168
	// get the highest occurrence entry for a name
2169
	protected function get($name)
2170
	{
2171
		$current = $this->env;
2172
2173
		$isArguments = $name == $this->vPrefix.'arguments';
2174
		while ($current) {
2175
			if ($isArguments && isset($current->arguments)) {
2176
				return array('list', ' ', $current->arguments);
2177
			}
2178
2179
			if (isset($current->store[$name])) {
2180
				return $current->store[$name];
2181
			}
2182
2183
			$current = isset($current->storeParent) ?
2184
				$current->storeParent : $current->parent;
2185
		}
2186
2187
		$this->throwError("variable $name is undefined");
2188
	}
2189
2190
	// inject array of unparsed strings into environment as variables
2191
	protected function injectVariables($args)
2192
	{
2193
		$this->pushEnv();
2194
		$parser = new lessc_parser($this, __METHOD__);
2195
		$value = null;
2196
		foreach ($args as $name => $strValue) {
2197
			if ($name[0] !== '@') {
2198
				$name = '@'.$name;
2199
			}
2200
			$parser->count = 0;
2201
			$parser->buffer = (string) $strValue;
2202
			if (!$parser->propertyValue($value)) {
2203
				throw new Exception("failed to parse passed in variable $name: $strValue");
0 ignored issues
show
Bug introduced by
The type Dolibarr\Code\Core\Classes\Exception was not found. Did you mean Exception? If so, make sure to prefix the type with \.
Loading history...
2204
			}
2205
2206
			$this->set($name, $value);
2207
		}
2208
	}
2209
2210
	/**
2211
	 * Initialize any static state, can initialize parser for a file
2212
	 * $opts isn't used yet
2213
	 */
2214
	public function __construct($fname = null)
2215
	{
2216
		if ($fname !== null) {
2217
			// used for deprecated parse method
2218
			$this->_parseFile = $fname;
2219
		}
2220
	}
2221
2222
	public function compile($string, $name = null)
2223
	{
2224
		$locale = setlocale(LC_NUMERIC, 0);
2225
		setlocale(LC_NUMERIC, "C");
2226
2227
		$this->parser = $this->makeParser($name);
2228
		$root = $this->parser->parse($string);
2229
2230
		$this->env = null;
2231
		$this->scope = null;
2232
2233
		$this->formatter = $this->newFormatter();
2234
2235
		if (!empty($this->registeredVars)) {
2236
			$this->injectVariables($this->registeredVars);
2237
		}
2238
2239
		$this->sourceParser = $this->parser; // used for error messages
2240
		$this->compileBlock($root);
2241
2242
		ob_start();
2243
		$this->formatter->block($this->scope);
2244
		$out = ob_get_clean();
2245
		setlocale(LC_NUMERIC, $locale);
2246
		return $out;
2247
	}
2248
2249
	public function compileFile($fname, $outFname = null)
2250
	{
2251
		if (!is_readable($fname)) {
2252
			throw new Exception('load error: failed to find '.$fname);
2253
		}
2254
2255
		$pi = pathinfo($fname);
2256
2257
		$oldImport = $this->importDir;
2258
2259
		$this->importDir = (array) $this->importDir;
2260
		$this->importDir[] = $pi['dirname'].'/';
2261
2262
		$this->addParsedFile($fname);
2263
2264
		$out = $this->compile(file_get_contents($fname), $fname);
2265
2266
		$this->importDir = $oldImport;
2267
2268
		if ($outFname !== null) {
2269
			return file_put_contents($outFname, $out);
2270
		}
2271
2272
		return $out;
2273
	}
2274
2275
	// compile only if changed input has changed or output doesn't exist
2276
	public function checkedCompile($in, $out)
2277
	{
2278
		if (!is_file($out) || filemtime($in) > filemtime($out)) {
2279
			$this->compileFile($in, $out);
2280
			return true;
2281
		}
2282
		return false;
2283
	}
2284
2285
	/**
2286
	 * Execute lessphp on a .less file or a lessphp cache structure
2287
	 *
2288
	 * The lessphp cache structure contains information about a specific
2289
	 * less file having been parsed. It can be used as a hint for future
2290
	 * calls to determine whether or not a rebuild is required.
2291
	 *
2292
	 * The cache structure contains two important keys that may be used
2293
	 * externally:
2294
	 *
2295
	 * compiled: The final compiled CSS
2296
	 * updated: The time (in seconds) the CSS was last compiled
2297
	 *
2298
	 * The cache structure is a plain-ol' PHP associative array and can
2299
	 * be serialized and unserialized without a hitch.
2300
	 *
2301
	 * @param mixed $in Input
2302
	 * @param bool $force Force rebuild?
2303
	 * @return array|null lessphp cache structure
2304
	 */
2305
	public function cachedCompile($in, $force = false)
2306
	{
2307
		// assume no root
2308
		$root = null;
2309
2310
		if (is_string($in)) {
2311
			$root = $in;
2312
		} elseif (is_array($in) && isset($in['root'])) {
2313
			if ($force || !isset($in['files'])) {
2314
				// If we are forcing a recompile or if for some reason the
2315
				// structure does not contain any file information we should
2316
				// specify the root to trigger a rebuild.
2317
				$root = $in['root'];
2318
			} elseif (isset($in['files']) && is_array($in['files'])) {
2319
				foreach ($in['files'] as $fname => $ftime) {
2320
					if (!file_exists($fname) || filemtime($fname) > $ftime) {
2321
						// One of the files we knew about previously has changed
2322
						// so we should look at our incoming root again.
2323
						$root = $in['root'];
2324
						break;
2325
					}
2326
				}
2327
			}
2328
		} else {
2329
			// TODO: Throw an exception? We got neither a string nor something
2330
			// that looks like a compatible lessphp cache structure.
2331
			return null;
2332
		}
2333
2334
		if ($root !== null) {
2335
			// If we have a root value which means we should rebuild.
2336
			$out = array();
2337
			$out['root'] = $root;
2338
			$out['compiled'] = $this->compileFile($root);
2339
			$out['files'] = $this->allParsedFiles();
2340
			$out['updated'] = time();
2341
			return $out;
2342
		} else {
2343
			// No changes, pass back the structure
2344
			// we were given initially.
2345
			return $in;
2346
		}
2347
	}
2348
2349
	// parse and compile buffer
2350
	// This is deprecated
2351
	public function parse($str = null, $initialVariables = null)
2352
	{
2353
		if (is_array($str)) {
2354
			$initialVariables = $str;
2355
			$str = null;
2356
		}
2357
2358
		$oldVars = $this->registeredVars;
2359
		if ($initialVariables !== null) {
2360
			$this->setVariables($initialVariables);
2361
		}
2362
2363
		if ($str == null) {
2364
			if (empty($this->_parseFile)) {
2365
				throw new exception("nothing to parse");
0 ignored issues
show
Bug introduced by
The type Dolibarr\Code\Core\Classes\exception was not found. Did you mean exception? If so, make sure to prefix the type with \.
Loading history...
2366
			}
2367
2368
			$out = $this->compileFile($this->_parseFile);
2369
		} else {
2370
			$out = $this->compile($str);
2371
		}
2372
2373
		$this->registeredVars = $oldVars;
2374
		return $out;
2375
	}
2376
2377
	protected function makeParser($name)
2378
	{
2379
		$parser = new lessc_parser($this, $name);
2380
		$parser->writeComments = $this->preserveComments;
2381
2382
		return $parser;
2383
	}
2384
2385
	public function setFormatter($name)
2386
	{
2387
		$this->formatterName = $name;
2388
	}
2389
2390
	protected function newFormatter()
2391
	{
2392
		$className = "lessc_formatter_lessjs";
2393
		if (!empty($this->formatterName)) {
2394
			if (!is_string($this->formatterName)) {
2395
				return $this->formatterName;
2396
			}
2397
			$className = "lessc_formatter_$this->formatterName";
2398
		}
2399
2400
		return new $className();
2401
	}
2402
2403
	public function setPreserveComments($preserve)
2404
	{
2405
		$this->preserveComments = $preserve;
2406
	}
2407
2408
	public function registerFunction($name, $func)
2409
	{
2410
		$this->libFunctions[$name] = $func;
2411
	}
2412
2413
	public function unregisterFunction($name)
2414
	{
2415
		unset($this->libFunctions[$name]);
2416
	}
2417
2418
	public function setVariables($variables)
2419
	{
2420
		$this->registeredVars = array_merge($this->registeredVars, $variables);
2421
	}
2422
2423
	public function unsetVariable($name)
2424
	{
2425
		unset($this->registeredVars[$name]);
2426
	}
2427
2428
	public function setImportDir($dirs)
2429
	{
2430
		$this->importDir = (array) $dirs;
2431
	}
2432
2433
	public function addImportDir($dir)
2434
	{
2435
		$this->importDir = (array) $this->importDir;
2436
		$this->importDir[] = $dir;
2437
	}
2438
2439
	public function allParsedFiles()
2440
	{
2441
		return $this->allParsedFiles;
2442
	}
2443
2444
	public function addParsedFile($file)
2445
	{
2446
		$this->allParsedFiles[realpath($file)] = filemtime($file);
2447
	}
2448
2449
	/**
2450
	 * Uses the current value of $this->count to show line and line number
2451
	 */
2452
	public function throwError($msg = null)
2453
	{
2454
		if ($this->sourceLoc >= 0) {
2455
			$this->sourceParser->throwError($msg, $this->sourceLoc);
2456
		}
2457
		throw new exception($msg);
2458
	}
2459
2460
	// compile file $in to file $out if $in is newer than $out
2461
	// returns true when it compiles, false otherwise
2462
	public static function ccompile($in, $out, $less = null)
2463
	{
2464
		if ($less === null) {
2465
			$less = new self();
2466
		}
2467
		return $less->checkedCompile($in, $out);
2468
	}
2469
2470
	public static function cexecute($in, $force = false, $less = null)
2471
	{
2472
		if ($less === null) {
2473
			$less = new self();
2474
		}
2475
		return $less->cachedCompile($in, $force);
2476
	}
2477
2478
	protected static $cssColors = array(
2479
		'aliceblue' => '240,248,255',
2480
		'antiquewhite' => '250,235,215',
2481
		'aqua' => '0,255,255',
2482
		'aquamarine' => '127,255,212',
2483
		'azure' => '240,255,255',
2484
		'beige' => '245,245,220',
2485
		'bisque' => '255,228,196',
2486
		'black' => '0,0,0',
2487
		'blanchedalmond' => '255,235,205',
2488
		'blue' => '0,0,255',
2489
		'blueviolet' => '138,43,226',
2490
		'brown' => '165,42,42',
2491
		'burlywood' => '222,184,135',
2492
		'cadetblue' => '95,158,160',
2493
		'chartreuse' => '127,255,0',
2494
		'chocolate' => '210,105,30',
2495
		'coral' => '255,127,80',
2496
		'cornflowerblue' => '100,149,237',
2497
		'cornsilk' => '255,248,220',
2498
		'crimson' => '220,20,60',
2499
		'cyan' => '0,255,255',
2500
		'darkblue' => '0,0,139',
2501
		'darkcyan' => '0,139,139',
2502
		'darkgoldenrod' => '184,134,11',
2503
		'darkgray' => '169,169,169',
2504
		'darkgreen' => '0,100,0',
2505
		'darkgrey' => '169,169,169',
2506
		'darkkhaki' => '189,183,107',
2507
		'darkmagenta' => '139,0,139',
2508
		'darkolivegreen' => '85,107,47',
2509
		'darkorange' => '255,140,0',
2510
		'darkorchid' => '153,50,204',
2511
		'darkred' => '139,0,0',
2512
		'darksalmon' => '233,150,122',
2513
		'darkseagreen' => '143,188,143',
2514
		'darkslateblue' => '72,61,139',
2515
		'darkslategray' => '47,79,79',
2516
		'darkslategrey' => '47,79,79',
2517
		'darkturquoise' => '0,206,209',
2518
		'darkviolet' => '148,0,211',
2519
		'deeppink' => '255,20,147',
2520
		'deepskyblue' => '0,191,255',
2521
		'dimgray' => '105,105,105',
2522
		'dimgrey' => '105,105,105',
2523
		'dodgerblue' => '30,144,255',
2524
		'firebrick' => '178,34,34',
2525
		'floralwhite' => '255,250,240',
2526
		'forestgreen' => '34,139,34',
2527
		'fuchsia' => '255,0,255',
2528
		'gainsboro' => '220,220,220',
2529
		'ghostwhite' => '248,248,255',
2530
		'gold' => '255,215,0',
2531
		'goldenrod' => '218,165,32',
2532
		'gray' => '128,128,128',
2533
		'green' => '0,128,0',
2534
		'greenyellow' => '173,255,47',
2535
		'grey' => '128,128,128',
2536
		'honeydew' => '240,255,240',
2537
		'hotpink' => '255,105,180',
2538
		'indianred' => '205,92,92',
2539
		'indigo' => '75,0,130',
2540
		'ivory' => '255,255,240',
2541
		'khaki' => '240,230,140',
2542
		'lavender' => '230,230,250',
2543
		'lavenderblush' => '255,240,245',
2544
		'lawngreen' => '124,252,0',
2545
		'lemonchiffon' => '255,250,205',
2546
		'lightblue' => '173,216,230',
2547
		'lightcoral' => '240,128,128',
2548
		'lightcyan' => '224,255,255',
2549
		'lightgoldenrodyellow' => '250,250,210',
2550
		'lightgray' => '211,211,211',
2551
		'lightgreen' => '144,238,144',
2552
		'lightgrey' => '211,211,211',
2553
		'lightpink' => '255,182,193',
2554
		'lightsalmon' => '255,160,122',
2555
		'lightseagreen' => '32,178,170',
2556
		'lightskyblue' => '135,206,250',
2557
		'lightslategray' => '119,136,153',
2558
		'lightslategrey' => '119,136,153',
2559
		'lightsteelblue' => '176,196,222',
2560
		'lightyellow' => '255,255,224',
2561
		'lime' => '0,255,0',
2562
		'limegreen' => '50,205,50',
2563
		'linen' => '250,240,230',
2564
		'magenta' => '255,0,255',
2565
		'maroon' => '128,0,0',
2566
		'mediumaquamarine' => '102,205,170',
2567
		'mediumblue' => '0,0,205',
2568
		'mediumorchid' => '186,85,211',
2569
		'mediumpurple' => '147,112,219',
2570
		'mediumseagreen' => '60,179,113',
2571
		'mediumslateblue' => '123,104,238',
2572
		'mediumspringgreen' => '0,250,154',
2573
		'mediumturquoise' => '72,209,204',
2574
		'mediumvioletred' => '199,21,133',
2575
		'midnightblue' => '25,25,112',
2576
		'mintcream' => '245,255,250',
2577
		'mistyrose' => '255,228,225',
2578
		'moccasin' => '255,228,181',
2579
		'navajowhite' => '255,222,173',
2580
		'navy' => '0,0,128',
2581
		'oldlace' => '253,245,230',
2582
		'olive' => '128,128,0',
2583
		'olivedrab' => '107,142,35',
2584
		'orange' => '255,165,0',
2585
		'orangered' => '255,69,0',
2586
		'orchid' => '218,112,214',
2587
		'palegoldenrod' => '238,232,170',
2588
		'palegreen' => '152,251,152',
2589
		'paleturquoise' => '175,238,238',
2590
		'palevioletred' => '219,112,147',
2591
		'papayawhip' => '255,239,213',
2592
		'peachpuff' => '255,218,185',
2593
		'peru' => '205,133,63',
2594
		'pink' => '255,192,203',
2595
		'plum' => '221,160,221',
2596
		'powderblue' => '176,224,230',
2597
		'purple' => '128,0,128',
2598
		'red' => '255,0,0',
2599
		'rosybrown' => '188,143,143',
2600
		'royalblue' => '65,105,225',
2601
		'saddlebrown' => '139,69,19',
2602
		'salmon' => '250,128,114',
2603
		'sandybrown' => '244,164,96',
2604
		'seagreen' => '46,139,87',
2605
		'seashell' => '255,245,238',
2606
		'sienna' => '160,82,45',
2607
		'silver' => '192,192,192',
2608
		'skyblue' => '135,206,235',
2609
		'slateblue' => '106,90,205',
2610
		'slategray' => '112,128,144',
2611
		'slategrey' => '112,128,144',
2612
		'snow' => '255,250,250',
2613
		'springgreen' => '0,255,127',
2614
		'steelblue' => '70,130,180',
2615
		'tan' => '210,180,140',
2616
		'teal' => '0,128,128',
2617
		'thistle' => '216,191,216',
2618
		'tomato' => '255,99,71',
2619
		'transparent' => '0,0,0,0',
2620
		'turquoise' => '64,224,208',
2621
		'violet' => '238,130,238',
2622
		'wheat' => '245,222,179',
2623
		'white' => '255,255,255',
2624
		'whitesmoke' => '245,245,245',
2625
		'yellow' => '255,255,0',
2626
		'yellowgreen' => '154,205,50'
2627
	);
2628
}
2629