|
1
|
|
|
<?php |
|
2
|
|
|
|
|
3
|
|
|
namespace LesserPhp; |
|
4
|
|
|
|
|
5
|
|
|
/** |
|
6
|
|
|
* lesserphp |
|
7
|
|
|
* https://www.maswaba.de/lesserphp |
|
8
|
|
|
* |
|
9
|
|
|
* LESS CSS compiler, adapted from http://lesscss.org |
|
10
|
|
|
* |
|
11
|
|
|
* Copyright 2013, Leaf Corcoran <[email protected]> |
|
12
|
|
|
* Copyright 2016, Marcus Schwarz <[email protected]> |
|
13
|
|
|
* Licensed under MIT or GPLv3, see LICENSE |
|
14
|
|
|
* @package LesserPhp |
|
15
|
|
|
*/ |
|
16
|
|
|
use LesserPhp\Color\Converter; |
|
17
|
|
|
use LesserPhp\Exception\GeneralException; |
|
18
|
|
|
use LesserPhp\Library\Assertions; |
|
19
|
|
|
use LesserPhp\Library\Coerce; |
|
20
|
|
|
use LesserPhp\Library\Functions; |
|
21
|
|
|
|
|
22
|
|
|
/** |
|
23
|
|
|
* The LESS compiler and parser. |
|
24
|
|
|
* |
|
25
|
|
|
* Converting LESS to CSS is a three stage process. The incoming file is parsed |
|
26
|
|
|
* by `lessc_parser` into a syntax tree, then it is compiled into another tree |
|
27
|
|
|
* representing the CSS structure by `lessc`. The CSS tree is fed into a |
|
28
|
|
|
* formatter, like `lessc_formatter` which then outputs CSS as a string. |
|
29
|
|
|
* |
|
30
|
|
|
* During the first compile, all values are *reduced*, which means that their |
|
31
|
|
|
* types are brought to the lowest form before being dump as strings. This |
|
32
|
|
|
* handles math equations, variable dereferences, and the like. |
|
33
|
|
|
* |
|
34
|
|
|
* The `parse` function of `lessc` is the entry point. |
|
35
|
|
|
* |
|
36
|
|
|
* In summary: |
|
37
|
|
|
* |
|
38
|
|
|
* The `lessc` class creates an instance of the parser, feeds it LESS code, |
|
39
|
|
|
* then transforms the resulting tree to a CSS tree. This class also holds the |
|
40
|
|
|
* evaluation context, such as all available mixins and variables at any given |
|
41
|
|
|
* time. |
|
42
|
|
|
* |
|
43
|
|
|
* The `lessc_parser` class is only concerned with parsing its input. |
|
44
|
|
|
* |
|
45
|
|
|
* The `lessc_formatter` takes a CSS tree, and dumps it to a formatted string, |
|
46
|
|
|
* handling things like indentation. |
|
47
|
|
|
*/ |
|
48
|
|
|
class Compiler |
|
49
|
|
|
{ |
|
50
|
|
|
const VERSION = 'v0.5.1'; |
|
51
|
|
|
|
|
52
|
|
|
public static $TRUE = ['keyword', 'true']; |
|
53
|
|
|
public static $FALSE = ['keyword', 'false']; |
|
54
|
|
|
|
|
55
|
|
|
/** |
|
56
|
|
|
* @var callable[] |
|
57
|
|
|
*/ |
|
58
|
|
|
private $libFunctions = []; |
|
59
|
|
|
|
|
60
|
|
|
/** |
|
61
|
|
|
* @var string[] |
|
62
|
|
|
*/ |
|
63
|
|
|
private $registeredVars = []; |
|
64
|
|
|
|
|
65
|
|
|
/** |
|
66
|
|
|
* @var bool |
|
67
|
|
|
*/ |
|
68
|
|
|
protected $preserveComments = false; |
|
69
|
|
|
|
|
70
|
|
|
/** |
|
71
|
|
|
* @var string $vPrefix prefix of abstract properties |
|
72
|
|
|
*/ |
|
73
|
|
|
private $vPrefix = '@'; |
|
74
|
|
|
|
|
75
|
|
|
/** |
|
76
|
|
|
* @var string $mPrefix prefix of abstract blocks |
|
77
|
|
|
*/ |
|
78
|
|
|
private $mPrefix = '$'; |
|
79
|
|
|
|
|
80
|
|
|
/** |
|
81
|
|
|
* @var string |
|
82
|
|
|
*/ |
|
83
|
|
|
private $parentSelector = '&'; |
|
84
|
|
|
|
|
85
|
|
|
/** |
|
86
|
|
|
* @var bool $importDisabled disable @import |
|
87
|
|
|
*/ |
|
88
|
|
|
private $importDisabled = false; |
|
89
|
|
|
|
|
90
|
|
|
/** |
|
91
|
|
|
* @var string[] |
|
92
|
|
|
*/ |
|
93
|
|
|
private $importDirs = []; |
|
94
|
|
|
|
|
95
|
|
|
/** |
|
96
|
|
|
* @var int |
|
97
|
|
|
*/ |
|
98
|
|
|
private $numberPrecision; |
|
99
|
|
|
|
|
100
|
|
|
/** |
|
101
|
|
|
* @var string[] |
|
102
|
|
|
*/ |
|
103
|
|
|
private $allParsedFiles = []; |
|
104
|
|
|
|
|
105
|
|
|
/** |
|
106
|
|
|
* set to the parser that generated the current line when compiling |
|
107
|
|
|
* so we know how to create error messages |
|
108
|
|
|
* @var \LesserPhp\Parser |
|
109
|
|
|
*/ |
|
110
|
|
|
private $sourceParser; |
|
111
|
|
|
|
|
112
|
|
|
/** |
|
113
|
|
|
* @var integer $sourceLoc Lines of Code |
|
114
|
|
|
*/ |
|
115
|
|
|
private $sourceLoc; |
|
116
|
|
|
|
|
117
|
|
|
/** |
|
118
|
|
|
* @var int $nextImportId uniquely identify imports |
|
119
|
|
|
*/ |
|
120
|
|
|
private static $nextImportId = 0; |
|
121
|
|
|
|
|
122
|
|
|
/** |
|
123
|
|
|
* @var Parser |
|
124
|
|
|
*/ |
|
125
|
|
|
private $parser; |
|
126
|
|
|
|
|
127
|
|
|
/** |
|
128
|
|
|
* @var \LesserPhp\Formatter\FormatterInterface |
|
129
|
|
|
*/ |
|
130
|
|
|
private $formatter; |
|
131
|
|
|
|
|
132
|
|
|
/** |
|
133
|
|
|
* @var \LesserPhp\NodeEnv What's the meaning of "env" in this context? |
|
134
|
|
|
*/ |
|
135
|
|
|
private $env; |
|
136
|
|
|
|
|
137
|
|
|
/** |
|
138
|
|
|
* @var \LesserPhp\Library\Coerce |
|
139
|
|
|
*/ |
|
140
|
|
|
private $coerce; |
|
141
|
|
|
|
|
142
|
|
|
/** |
|
143
|
|
|
* @var \LesserPhp\Library\Assertions |
|
144
|
|
|
*/ |
|
145
|
|
|
private $assertions; |
|
146
|
|
|
|
|
147
|
|
|
/** |
|
148
|
|
|
* @var \LesserPhp\Library\Functions |
|
149
|
|
|
*/ |
|
150
|
|
|
private $functions; |
|
151
|
|
|
|
|
152
|
|
|
/** |
|
153
|
|
|
* @var mixed what's this exactly? |
|
154
|
|
|
*/ |
|
155
|
|
|
private $scope; |
|
156
|
|
|
|
|
157
|
|
|
/** |
|
158
|
|
|
* @var string |
|
159
|
|
|
*/ |
|
160
|
|
|
private $formatterName; |
|
161
|
|
|
|
|
162
|
|
|
/** |
|
163
|
|
|
* @var \LesserPhp\Color\Converter |
|
164
|
|
|
*/ |
|
165
|
|
|
private $converter; |
|
166
|
|
|
|
|
167
|
|
|
/** |
|
168
|
|
|
* @var bool Allow importing of *.css files |
|
169
|
|
|
* @see tryImport() |
|
170
|
|
|
* @see importCss() |
|
171
|
|
|
*/ |
|
172
|
64 |
|
private $import_css = false; |
|
173
|
|
|
|
|
174
|
64 |
|
/** |
|
175
|
64 |
|
* Constructor. |
|
176
|
64 |
|
* |
|
177
|
64 |
|
* Hardwires dependencies for now |
|
178
|
64 |
|
*/ |
|
179
|
|
|
public function __construct() |
|
180
|
|
|
{ |
|
181
|
|
|
$this->coerce = new Coerce(); |
|
182
|
|
|
$this->assertions = new Assertions($this->coerce); |
|
183
|
|
|
$this->converter = new Converter(); |
|
184
|
|
|
$this->functions = new Functions($this->assertions, $this->coerce, $this, $this->converter); |
|
185
|
|
|
} |
|
186
|
48 |
|
|
|
187
|
|
|
/** |
|
188
|
48 |
|
* @param array $items |
|
189
|
48 |
|
* @param $delim |
|
190
|
|
|
* |
|
191
|
27 |
|
* @return array |
|
192
|
|
|
*/ |
|
193
|
|
|
public static function compressList(array $items, $delim) |
|
194
|
|
|
{ |
|
195
|
|
|
if (!isset($items[1]) && isset($items[0])) { |
|
196
|
|
|
return $items[0]; |
|
197
|
|
|
} else { |
|
198
|
|
|
return ['list', $delim, $items]; |
|
199
|
|
|
} |
|
200
|
36 |
|
} |
|
201
|
|
|
|
|
202
|
36 |
|
/** |
|
203
|
|
|
* @param string $what |
|
204
|
|
|
* |
|
205
|
|
|
* @return string |
|
206
|
|
|
*/ |
|
207
|
|
|
public static function pregQuote($what) |
|
208
|
|
|
{ |
|
209
|
|
|
return preg_quote($what, '/'); |
|
210
|
|
|
} |
|
211
|
|
|
|
|
212
|
|
|
/** |
|
213
|
3 |
|
* @param array $importPath |
|
214
|
|
|
* @param $parentBlock |
|
215
|
3 |
|
* @param $out |
|
216
|
2 |
|
* |
|
217
|
|
|
* @return array|false |
|
218
|
|
|
* @throws \LesserPhp\Exception\GeneralException |
|
219
|
3 |
|
*/ |
|
220
|
3 |
|
protected function tryImport(array $importPath, $parentBlock, $out) |
|
221
|
2 |
|
{ |
|
222
|
|
|
if ($importPath[0] === 'function' && $importPath[1] === 'url') { |
|
223
|
|
|
$importPath = $this->flattenList($importPath[2]); |
|
224
|
3 |
|
} |
|
225
|
|
|
|
|
226
|
|
|
$str = $this->coerce->coerceString($importPath); |
|
227
|
3 |
|
if ($str === null) { |
|
228
|
|
|
return false; |
|
229
|
|
|
} |
|
230
|
|
|
|
|
231
|
3 |
|
$url = $this->compileValue($this->functions->e($str)); |
|
232
|
|
|
|
|
233
|
3 |
|
$pi = pathinfo($url); |
|
234
|
2 |
|
|
|
235
|
|
|
// don't import if it ends in css |
|
236
|
|
|
if ($pi['extension'] == 'css' && !$this->import_css) { |
|
237
|
3 |
|
return false; |
|
238
|
1 |
|
} |
|
239
|
|
|
|
|
240
|
|
|
$realPath = $this->functions->findImport($url); |
|
241
|
2 |
|
|
|
242
|
2 |
|
if ($realPath === null) { |
|
243
|
|
|
return false; |
|
244
|
|
|
} |
|
245
|
2 |
|
|
|
246
|
2 |
|
if ($this->isImportDisabled()) { |
|
247
|
2 |
|
return [false, '/* import disabled */']; |
|
248
|
|
|
} |
|
249
|
|
|
|
|
250
|
2 |
|
if (isset($this->allParsedFiles[realpath($realPath)])) { |
|
251
|
2 |
|
return [false, null]; |
|
252
|
2 |
|
} |
|
253
|
|
|
|
|
254
|
|
|
$this->addParsedFile($realPath); |
|
255
|
|
|
$parser = $this->makeParser($realPath); |
|
256
|
|
|
$root = $parser->parse(file_get_contents($realPath)); |
|
257
|
|
|
|
|
258
|
|
|
// set the parents of all the block props |
|
259
|
2 |
|
foreach ($root->props as $prop) { |
|
260
|
2 |
|
if ($prop[0] === 'block') { |
|
261
|
2 |
|
$prop[1]->parent = $parentBlock; |
|
262
|
2 |
|
} |
|
263
|
|
|
} |
|
264
|
|
|
|
|
265
|
|
|
// copy mixins into scope, set their parents |
|
266
|
2 |
|
// bring blocks from import into current block |
|
267
|
|
|
// TODO: need to mark the source parser these came from this file |
|
268
|
|
|
foreach ($root->children as $childName => $child) { |
|
269
|
|
|
if (isset($parentBlock->children[$childName])) { |
|
270
|
2 |
|
$parentBlock->children[$childName] = array_merge( |
|
271
|
2 |
|
$parentBlock->children[$childName], |
|
272
|
|
|
$child |
|
273
|
2 |
|
); |
|
274
|
2 |
|
} else { |
|
275
|
|
|
$parentBlock->children[$childName] = $child; |
|
276
|
2 |
|
} |
|
277
|
|
|
} |
|
278
|
|
|
|
|
279
|
|
|
$dir = $pi["dirname"]; |
|
280
|
|
|
|
|
281
|
|
|
list($top, $bottom) = $this->sortProps($root->props, true); |
|
282
|
|
|
|
|
283
|
|
|
if ($pi['extension'] != 'css') { |
|
284
|
|
|
$this->compileImportedProps($top, $parentBlock, $out, $dir); |
|
285
|
2 |
|
} |
|
286
|
|
|
|
|
287
|
2 |
|
return [true, $bottom, $parser, $dir]; |
|
288
|
|
|
} |
|
289
|
2 |
|
|
|
290
|
|
|
/** |
|
291
|
2 |
|
* @param array $props |
|
292
|
|
|
* @param $block |
|
293
|
2 |
|
* @param $out |
|
294
|
2 |
|
* @param string $importDir |
|
295
|
|
|
*/ |
|
296
|
|
|
protected function compileImportedProps(array $props, $block, $out, $importDir) |
|
297
|
2 |
|
{ |
|
298
|
2 |
|
$oldSourceParser = $this->sourceParser; |
|
299
|
2 |
|
|
|
300
|
|
|
$oldImport = $this->importDirs; |
|
301
|
|
|
|
|
302
|
|
|
array_unshift($this->importDirs, $importDir); |
|
303
|
|
|
|
|
304
|
|
|
foreach ($props as $prop) { |
|
305
|
|
|
$this->compileProp($prop, $block, $out); |
|
306
|
|
|
} |
|
307
|
|
|
|
|
308
|
|
|
$this->importDirs = $oldImport; |
|
309
|
|
|
$this->sourceParser = $oldSourceParser; |
|
310
|
|
|
} |
|
311
|
|
|
|
|
312
|
|
|
/** |
|
313
|
|
|
* Recursively compiles a block. |
|
314
|
|
|
* |
|
315
|
|
|
* A block is analogous to a CSS block in most cases. A single LESS document |
|
316
|
|
|
* is encapsulated in a block when parsed, but it does not have parent tags |
|
317
|
|
|
* so all of it's children appear on the root level when compiled. |
|
318
|
|
|
* |
|
319
|
|
|
* Blocks are made up of props and children. |
|
320
|
|
|
* |
|
321
|
|
|
* Props are property instructions, array tuples which describe an action |
|
322
|
|
|
* to be taken, eg. write a property, set a variable, mixin a block. |
|
323
|
|
|
* |
|
324
|
|
|
* The children of a block are just all the blocks that are defined within. |
|
325
|
49 |
|
* This is used to look up mixins when performing a mixin. |
|
326
|
|
|
* |
|
327
|
49 |
|
* Compiling the block involves pushing a fresh environment on the stack, |
|
328
|
49 |
|
* and iterating through the props, compiling each one. |
|
329
|
49 |
|
* |
|
330
|
38 |
|
* See lessc::compileProp() |
|
331
|
46 |
|
* |
|
332
|
46 |
|
* @param Block $block |
|
333
|
35 |
|
* |
|
334
|
6 |
|
* @throws \LesserPhp\Exception\GeneralException |
|
335
|
3 |
|
*/ |
|
336
|
3 |
|
protected function compileBlock(Block $block) |
|
337
|
4 |
|
{ |
|
338
|
4 |
|
switch ($block->type) { |
|
339
|
4 |
|
case "root": |
|
340
|
2 |
|
$this->compileRoot($block); |
|
341
|
|
|
break; |
|
342
|
|
|
case null: |
|
|
|
|
|
|
343
|
4 |
|
$this->compileCSSBlock($block); |
|
344
|
4 |
|
break; |
|
345
|
|
|
case "media": |
|
346
|
|
|
$this->compileMedia($block); |
|
|
|
|
|
|
347
|
|
|
break; |
|
348
|
38 |
|
case "directive": |
|
349
|
|
|
$name = "@" . $block->name; |
|
|
|
|
|
|
350
|
|
|
if (!empty($block->value)) { |
|
351
|
|
|
$name .= " " . $this->compileValue($this->reduce($block->value)); |
|
|
|
|
|
|
352
|
|
|
} |
|
353
|
|
|
|
|
354
|
|
|
$this->compileNestedBlock($block, [$name]); |
|
355
|
46 |
|
break; |
|
356
|
|
|
default: |
|
357
|
46 |
|
$block->parser->throwError("unknown block type: $block->type\n", $block->count); |
|
358
|
|
|
} |
|
359
|
46 |
|
} |
|
360
|
46 |
|
|
|
361
|
46 |
|
/** |
|
362
|
|
|
* @param Block $block |
|
363
|
46 |
|
* |
|
364
|
46 |
|
* @throws \LesserPhp\Exception\GeneralException |
|
365
|
|
|
*/ |
|
366
|
35 |
|
protected function compileCSSBlock(Block $block) |
|
367
|
35 |
|
{ |
|
368
|
35 |
|
$env = $this->pushEnv($this->env); |
|
369
|
|
|
|
|
370
|
|
|
$selectors = $this->compileSelectors($block->tags); |
|
|
|
|
|
|
371
|
|
|
$env->setSelectors($this->multiplySelectors($selectors)); |
|
372
|
|
|
$out = $this->makeOutputBlock(null, $env->getSelectors()); |
|
|
|
|
|
|
373
|
3 |
|
|
|
374
|
|
|
$this->scope->children[] = $out; |
|
375
|
3 |
|
$this->compileProps($block, $out); |
|
376
|
3 |
|
|
|
377
|
|
|
$block->scope = $env; // mixins carry scope with them! |
|
|
|
|
|
|
378
|
3 |
|
$this->popEnv(); |
|
379
|
|
|
} |
|
380
|
3 |
|
|
|
381
|
3 |
|
/** |
|
382
|
|
|
* @param Block\Media $media |
|
383
|
3 |
|
*/ |
|
384
|
|
|
protected function compileMedia(Block\Media $media) |
|
385
|
3 |
|
{ |
|
386
|
3 |
|
$env = $this->pushEnv($this->env, $media); |
|
387
|
3 |
|
$parentScope = $this->mediaParent($this->scope); |
|
388
|
3 |
|
|
|
389
|
3 |
|
$query = $this->compileMediaQuery($this->multiplyMedia($env)); |
|
|
|
|
|
|
390
|
3 |
|
|
|
391
|
3 |
|
$this->scope = $this->makeOutputBlock($media->type, [$query]); |
|
392
|
|
|
$parentScope->children[] = $this->scope; |
|
393
|
|
|
|
|
394
|
|
|
$this->compileProps($media, $this->scope); |
|
395
|
3 |
|
|
|
396
|
3 |
|
if (count($this->scope->lines) > 0) { |
|
397
|
3 |
|
$orphanSelelectors = $this->findClosestSelectors(); |
|
398
|
|
|
if ($orphanSelelectors !== null) { |
|
399
|
|
|
$orphan = $this->makeOutputBlock(null, $orphanSelelectors); |
|
400
|
|
|
$orphan->lines = $this->scope->lines; |
|
401
|
|
|
array_unshift($this->scope->children, $orphan); |
|
402
|
|
|
$this->scope->lines = []; |
|
403
|
|
|
} |
|
404
|
3 |
|
} |
|
405
|
|
|
|
|
406
|
3 |
|
$this->scope = $this->scope->parent; |
|
407
|
1 |
|
$this->popEnv(); |
|
408
|
1 |
|
} |
|
409
|
|
|
|
|
410
|
1 |
|
/** |
|
411
|
|
|
* @param $scope |
|
412
|
|
|
* |
|
413
|
3 |
|
* @return mixed |
|
414
|
|
|
*/ |
|
415
|
|
|
protected function mediaParent($scope) |
|
416
|
|
|
{ |
|
417
|
|
|
while (!empty($scope->parent)) { |
|
418
|
|
|
if (!empty($scope->type) && $scope->type !== "media") { |
|
419
|
|
|
break; |
|
420
|
4 |
|
} |
|
421
|
|
|
$scope = $scope->parent; |
|
422
|
4 |
|
} |
|
423
|
4 |
|
|
|
424
|
4 |
|
return $scope; |
|
425
|
|
|
} |
|
426
|
4 |
|
|
|
427
|
|
|
/** |
|
428
|
4 |
|
* @param Block $block |
|
429
|
4 |
|
* @param string[] $selectors |
|
430
|
4 |
|
*/ |
|
431
|
|
|
protected function compileNestedBlock(Block $block, array $selectors) |
|
432
|
|
|
{ |
|
433
|
|
|
$this->pushEnv($this->env, $block); |
|
434
|
|
|
$this->scope = $this->makeOutputBlock($block->type, $selectors); |
|
435
|
49 |
|
$this->scope->parent->children[] = $this->scope; |
|
436
|
|
|
|
|
437
|
49 |
|
$this->compileProps($block, $this->scope); |
|
438
|
49 |
|
|
|
439
|
49 |
|
$this->scope = $this->scope->parent; |
|
440
|
38 |
|
$this->popEnv(); |
|
441
|
38 |
|
} |
|
442
|
|
|
|
|
443
|
|
|
/** |
|
444
|
|
|
* @param Block $root |
|
445
|
|
|
*/ |
|
446
|
|
|
protected function compileRoot(Block $root) |
|
447
|
|
|
{ |
|
448
|
|
|
$this->pushEnv($this->env); |
|
449
|
49 |
|
$this->scope = $this->makeOutputBlock($root->type); |
|
450
|
|
|
$this->compileProps($root, $this->scope); |
|
451
|
49 |
|
$this->popEnv(); |
|
452
|
49 |
|
} |
|
453
|
|
|
|
|
454
|
38 |
|
/** |
|
455
|
38 |
|
* @param Block $block |
|
456
|
|
|
* @param \stdClass $out |
|
457
|
|
|
* |
|
458
|
|
|
* @throws \LesserPhp\Exception\GeneralException |
|
459
|
|
|
*/ |
|
460
|
|
|
protected function compileProps(Block $block, $out) |
|
461
|
|
|
{ |
|
462
|
|
|
foreach ($this->sortProps($block->props) as $prop) { |
|
463
|
|
|
$this->compileProp($prop, $block, $out); |
|
464
|
|
|
} |
|
465
|
|
|
$out->lines = $this->deduplicate($out->lines); |
|
466
|
38 |
|
} |
|
467
|
|
|
|
|
468
|
38 |
|
/** |
|
469
|
38 |
|
* Deduplicate lines in a block. Comments are not deduplicated. If a |
|
470
|
|
|
* duplicate rule is detected, the comments immediately preceding each |
|
471
|
38 |
|
* occurence are consolidated. |
|
472
|
38 |
|
* |
|
473
|
2 |
|
* @param array $lines |
|
474
|
2 |
|
* |
|
475
|
|
|
* @return array |
|
476
|
37 |
|
*/ |
|
477
|
37 |
|
protected function deduplicate(array $lines) |
|
478
|
|
|
{ |
|
479
|
37 |
|
$unique = []; |
|
480
|
37 |
|
$comments = []; |
|
481
|
|
|
|
|
482
|
|
|
foreach ($lines as $line) { |
|
483
|
38 |
|
if (strpos($line, '/*') === 0) { |
|
484
|
|
|
$comments[] = $line; |
|
485
|
|
|
continue; |
|
486
|
|
|
} |
|
487
|
|
|
if (!in_array($line, $unique)) { |
|
488
|
|
|
$unique[] = $line; |
|
489
|
|
|
} |
|
490
|
|
|
array_splice($unique, array_search($line, $unique), 0, $comments); |
|
491
|
|
|
$comments = []; |
|
492
|
49 |
|
} |
|
493
|
|
|
|
|
494
|
49 |
|
return array_merge($unique, $comments); |
|
495
|
49 |
|
} |
|
496
|
49 |
|
|
|
497
|
49 |
|
/** |
|
498
|
|
|
* @param array $props |
|
499
|
49 |
|
* @param bool $split |
|
500
|
49 |
|
* |
|
501
|
49 |
|
* @return array |
|
502
|
1 |
|
*/ |
|
503
|
1 |
|
protected function sortProps(array $props, $split = false) |
|
504
|
49 |
|
{ |
|
505
|
43 |
|
$vars = []; |
|
506
|
43 |
|
$imports = []; |
|
507
|
23 |
|
$other = []; |
|
508
|
|
|
$stack = []; |
|
509
|
43 |
|
|
|
510
|
|
|
foreach ($props as $prop) { |
|
511
|
43 |
|
switch ($prop[0]) { |
|
512
|
43 |
|
case "comment": |
|
513
|
47 |
|
$stack[] = $prop; |
|
514
|
3 |
|
break; |
|
515
|
3 |
|
case "assign": |
|
516
|
3 |
|
$stack[] = $prop; |
|
517
|
3 |
|
if (isset($prop[1][0]) && $prop[1][0] == $this->vPrefix) { |
|
518
|
3 |
|
$vars = array_merge($vars, $stack); |
|
519
|
3 |
|
} else { |
|
520
|
3 |
|
$other = array_merge($other, $stack); |
|
521
|
|
|
} |
|
522
|
46 |
|
$stack = []; |
|
523
|
46 |
|
break; |
|
524
|
46 |
|
case "import": |
|
525
|
49 |
|
$id = self::$nextImportId++; |
|
526
|
|
|
$prop[] = $id; |
|
527
|
|
|
$stack[] = $prop; |
|
528
|
49 |
|
$imports = array_merge($imports, $stack); |
|
529
|
|
|
$other[] = ["import_mixin", $id]; |
|
530
|
49 |
|
$stack = []; |
|
531
|
2 |
|
break; |
|
532
|
|
|
default: |
|
533
|
49 |
|
$stack[] = $prop; |
|
534
|
|
|
$other = array_merge($other, $stack); |
|
535
|
|
|
$stack = []; |
|
536
|
|
|
break; |
|
537
|
|
|
} |
|
538
|
|
|
} |
|
539
|
|
|
$other = array_merge($other, $stack); |
|
540
|
|
|
|
|
541
|
|
|
if ($split) { |
|
542
|
3 |
|
return [array_merge($imports, $vars), $other]; |
|
543
|
|
|
} else { |
|
544
|
3 |
|
return array_merge($imports, $vars, $other); |
|
545
|
3 |
|
} |
|
546
|
3 |
|
} |
|
547
|
3 |
|
|
|
548
|
3 |
|
/** |
|
549
|
3 |
|
* @param array $queries |
|
550
|
3 |
|
* |
|
551
|
3 |
|
* @return string |
|
552
|
1 |
|
*/ |
|
553
|
1 |
|
protected function compileMediaQuery(array $queries) |
|
554
|
1 |
|
{ |
|
555
|
1 |
|
$compiledQueries = []; |
|
556
|
|
|
foreach ($queries as $query) { |
|
557
|
1 |
|
$parts = []; |
|
558
|
|
|
foreach ($query as $q) { |
|
559
|
1 |
|
switch ($q[0]) { |
|
560
|
1 |
|
case "mediaType": |
|
561
|
1 |
|
$parts[] = implode(" ", array_slice($q, 1)); |
|
562
|
3 |
|
break; |
|
563
|
|
|
case "mediaExp": |
|
564
|
|
|
if (isset($q[2])) { |
|
565
|
|
|
$parts[] = "($q[1]: " . |
|
566
|
3 |
|
$this->compileValue($this->reduce($q[2])) . ")"; |
|
567
|
3 |
|
} else { |
|
568
|
|
|
$parts[] = "($q[1])"; |
|
569
|
|
|
} |
|
570
|
|
|
break; |
|
571
|
3 |
|
case "variable": |
|
572
|
3 |
|
$parts[] = $this->compileValue($this->reduce($q)); |
|
573
|
|
|
break; |
|
574
|
3 |
|
} |
|
575
|
|
|
} |
|
576
|
|
|
|
|
577
|
3 |
|
if (count($parts) > 0) { |
|
578
|
|
|
$compiledQueries[] = implode(" and ", $parts); |
|
579
|
|
|
} |
|
580
|
|
|
} |
|
581
|
|
|
|
|
582
|
|
|
$out = "@media"; |
|
583
|
|
|
if (!empty($parts)) { |
|
584
|
|
|
$out .= " " . |
|
585
|
|
|
implode($this->formatter->getSelectorSeparator(), $compiledQueries); |
|
586
|
3 |
|
} |
|
587
|
|
|
|
|
588
|
3 |
|
return $out; |
|
589
|
3 |
|
} |
|
590
|
|
|
|
|
591
|
3 |
|
/** |
|
592
|
|
|
* @param \LesserPhp\NodeEnv $env |
|
593
|
|
|
* @param array $childQueries |
|
594
|
|
|
* |
|
595
|
3 |
|
* @return array |
|
596
|
3 |
|
*/ |
|
597
|
|
|
protected function multiplyMedia(NodeEnv $env = null, array $childQueries = null) |
|
598
|
|
|
{ |
|
599
|
3 |
|
if ($env === null || |
|
600
|
3 |
|
(!empty($env->getBlock()->type) && $env->getBlock()->type !== 'media') |
|
601
|
3 |
|
) { |
|
602
|
3 |
|
return $childQueries; |
|
603
|
|
|
} |
|
604
|
1 |
|
|
|
605
|
1 |
|
// plain old block, skip |
|
606
|
1 |
|
if (empty($env->getBlock()->type)) { |
|
607
|
|
|
return $this->multiplyMedia($env->getParent(), $childQueries); |
|
608
|
|
|
} |
|
609
|
|
|
|
|
610
|
|
|
$out = []; |
|
611
|
3 |
|
$queries = $env->getBlock()->queries; |
|
612
|
|
|
if ($childQueries === null) { |
|
613
|
|
|
$out = $queries; |
|
614
|
|
|
} else { |
|
615
|
|
|
foreach ($queries as $parent) { |
|
616
|
|
|
foreach ($childQueries as $child) { |
|
617
|
|
|
$out[] = array_merge($parent, $child); |
|
618
|
|
|
} |
|
619
|
|
|
} |
|
620
|
46 |
|
} |
|
621
|
|
|
|
|
622
|
46 |
|
return $this->multiplyMedia($env->getParent(), $out); |
|
623
|
46 |
|
} |
|
624
|
46 |
|
|
|
625
|
46 |
|
/** |
|
626
|
46 |
|
* @param $tag |
|
627
|
|
|
* @param $replace |
|
628
|
46 |
|
* |
|
629
|
|
|
* @return int |
|
630
|
46 |
|
*/ |
|
631
|
|
|
protected function expandParentSelectors(&$tag, $replace) |
|
632
|
|
|
{ |
|
633
|
|
|
$parts = explode("$&$", $tag); |
|
634
|
|
|
$count = 0; |
|
635
|
|
|
foreach ($parts as &$part) { |
|
636
|
46 |
|
$part = str_replace($this->parentSelector, $replace, $part, $c); |
|
637
|
|
|
$count += $c; |
|
638
|
46 |
|
} |
|
639
|
46 |
|
$tag = implode($this->parentSelector, $parts); |
|
640
|
46 |
|
|
|
641
|
46 |
|
return $count; |
|
642
|
13 |
|
} |
|
643
|
13 |
|
|
|
644
|
|
|
/** |
|
645
|
46 |
|
* @return array|null |
|
646
|
|
|
*/ |
|
647
|
|
|
protected function findClosestSelectors() |
|
648
|
46 |
|
{ |
|
649
|
|
|
$env = $this->env; |
|
650
|
|
|
$selectors = null; |
|
651
|
|
|
while ($env !== null) { |
|
652
|
|
|
if ($env->getSelectors() !== null) { |
|
653
|
|
|
$selectors = $env->getSelectors(); |
|
|
|
|
|
|
654
|
|
|
break; |
|
655
|
|
|
} |
|
656
|
|
|
$env = $env->getParent(); |
|
657
|
|
|
} |
|
658
|
|
|
|
|
659
|
46 |
|
return $selectors; |
|
660
|
|
|
} |
|
661
|
|
|
|
|
662
|
|
|
|
|
663
|
46 |
|
/** |
|
664
|
46 |
|
* multiply $selectors against the nearest selectors in env |
|
665
|
|
|
* |
|
666
|
46 |
|
* @param array $selectors |
|
667
|
46 |
|
* |
|
668
|
|
|
* @return array |
|
669
|
|
|
*/ |
|
670
|
46 |
|
protected function multiplySelectors(array $selectors) |
|
671
|
|
|
{ |
|
672
|
|
|
// find parent selectors |
|
673
|
13 |
|
|
|
674
|
13 |
|
$parentSelectors = $this->findClosestSelectors(); |
|
675
|
13 |
|
if ($parentSelectors === null) { |
|
676
|
13 |
|
// kill parent reference in top level selector |
|
677
|
|
|
foreach ($selectors as &$s) { |
|
678
|
|
|
$this->expandParentSelectors($s, ""); |
|
679
|
13 |
|
} |
|
680
|
4 |
|
|
|
681
|
|
|
return $selectors; |
|
682
|
13 |
|
} |
|
683
|
|
|
|
|
684
|
|
|
$out = []; |
|
685
|
|
|
foreach ($parentSelectors as $parent) { |
|
686
|
|
|
foreach ($selectors as $child) { |
|
687
|
13 |
|
$count = $this->expandParentSelectors($child, $parent); |
|
688
|
|
|
|
|
689
|
|
|
// don't prepend the parent tag if & was used |
|
690
|
|
|
if ($count > 0) { |
|
691
|
|
|
$out[] = trim($child); |
|
692
|
|
|
} else { |
|
693
|
|
|
$out[] = trim($parent . ' ' . $child); |
|
694
|
|
|
} |
|
695
|
|
|
} |
|
696
|
|
|
} |
|
697
|
|
|
|
|
698
|
46 |
|
return $out; |
|
699
|
|
|
} |
|
700
|
46 |
|
|
|
701
|
|
|
/** |
|
702
|
46 |
|
* reduces selector expressions |
|
703
|
46 |
|
* |
|
704
|
4 |
|
* @param array $selectors |
|
705
|
4 |
|
* |
|
706
|
|
|
* @return array |
|
707
|
46 |
|
* @throws \LesserPhp\Exception\GeneralException |
|
708
|
|
|
*/ |
|
709
|
|
|
protected function compileSelectors(array $selectors) |
|
710
|
|
|
{ |
|
711
|
46 |
|
$out = []; |
|
712
|
|
|
|
|
713
|
|
|
foreach ($selectors as $s) { |
|
714
|
|
|
if (is_array($s)) { |
|
715
|
|
|
list(, $value) = $s; |
|
716
|
|
|
$out[] = trim($this->compileValue($this->reduce($value))); |
|
717
|
|
|
} else { |
|
718
|
|
|
$out[] = $s; |
|
719
|
|
|
} |
|
720
|
4 |
|
} |
|
721
|
|
|
|
|
722
|
4 |
|
return $out; |
|
723
|
|
|
} |
|
724
|
|
|
|
|
725
|
|
|
/** |
|
726
|
|
|
* @param $left |
|
727
|
|
|
* @param $right |
|
728
|
|
|
* |
|
729
|
|
|
* @return bool |
|
730
|
|
|
*/ |
|
731
|
|
|
protected function equals($left, $right) |
|
732
|
21 |
|
{ |
|
733
|
|
|
return $left == $right; |
|
734
|
|
|
} |
|
735
|
|
|
|
|
736
|
21 |
|
/** |
|
737
|
5 |
|
* @param $block |
|
738
|
5 |
|
* @param $orderedArgs |
|
739
|
5 |
|
* @param $keywordArgs |
|
740
|
5 |
|
* |
|
741
|
5 |
|
* @return bool |
|
742
|
|
|
*/ |
|
743
|
5 |
|
protected function patternMatch($block, $orderedArgs, $keywordArgs) |
|
744
|
5 |
|
{ |
|
745
|
1 |
|
// match the guards if it has them |
|
746
|
1 |
|
// any one of the groups must have all its guards pass for a match |
|
747
|
|
|
if (!empty($block->guards)) { |
|
748
|
|
|
$groupPassed = false; |
|
749
|
5 |
|
foreach ($block->guards as $guardGroup) { |
|
750
|
5 |
|
foreach ($guardGroup as $guard) { |
|
751
|
1 |
|
$this->pushEnv($this->env); |
|
752
|
|
|
$this->zipSetArgs($block->args, $orderedArgs, $keywordArgs); |
|
753
|
|
|
|
|
754
|
5 |
|
$negate = false; |
|
755
|
|
|
if ($guard[0] === "negate") { |
|
756
|
5 |
|
$guard = $guard[1]; |
|
757
|
3 |
|
$negate = true; |
|
758
|
|
|
} |
|
759
|
5 |
|
|
|
760
|
5 |
|
$passed = $this->reduce($guard) == self::$TRUE; |
|
761
|
|
|
if ($negate) { |
|
762
|
|
|
$passed = !$passed; |
|
763
|
|
|
} |
|
764
|
5 |
|
|
|
765
|
5 |
|
$this->popEnv(); |
|
766
|
|
|
|
|
767
|
|
|
if ($passed) { |
|
768
|
|
|
$groupPassed = true; |
|
769
|
5 |
|
} else { |
|
770
|
5 |
|
$groupPassed = false; |
|
771
|
|
|
break; |
|
772
|
|
|
} |
|
773
|
|
|
} |
|
774
|
19 |
|
|
|
775
|
12 |
|
if ($groupPassed) { |
|
776
|
|
|
break; |
|
777
|
|
|
} |
|
778
|
14 |
|
} |
|
779
|
14 |
|
|
|
780
|
2 |
|
if (!$groupPassed) { |
|
781
|
2 |
|
return false; |
|
782
|
2 |
|
} |
|
783
|
2 |
|
} |
|
784
|
|
|
|
|
785
|
|
|
if (empty($block->args)) { |
|
786
|
2 |
|
return $block->isVararg || empty($orderedArgs) && empty($keywordArgs); |
|
787
|
|
|
} |
|
788
|
|
|
|
|
789
|
|
|
$remainingArgs = $block->args; |
|
790
|
14 |
|
if ($keywordArgs) { |
|
791
|
|
|
$remainingArgs = []; |
|
792
|
14 |
|
foreach ($block->args as $arg) { |
|
793
|
14 |
|
if ($arg[0] === "arg" && isset($keywordArgs[$arg[1]])) { |
|
794
|
14 |
|
continue; |
|
795
|
3 |
|
} |
|
796
|
2 |
|
|
|
797
|
|
|
$remainingArgs[] = $arg; |
|
798
|
3 |
|
} |
|
799
|
14 |
|
} |
|
800
|
|
|
|
|
801
|
14 |
|
$i = -1; // no args |
|
802
|
3 |
|
// try to match by arity or by argument literal |
|
803
|
|
|
foreach ($remainingArgs as $i => $arg) { |
|
804
|
14 |
|
switch ($arg[0]) { |
|
805
|
2 |
|
case "lit": |
|
806
|
2 |
|
if (empty($orderedArgs[$i]) || !$this->equals($arg[1], $orderedArgs[$i])) { |
|
807
|
14 |
|
return false; |
|
808
|
|
|
} |
|
809
|
|
|
break; |
|
810
|
|
|
case "arg": |
|
811
|
13 |
|
// no arg and no default value |
|
812
|
2 |
|
if (!isset($orderedArgs[$i]) && !isset($arg[2])) { |
|
813
|
|
|
return false; |
|
814
|
13 |
|
} |
|
815
|
|
|
break; |
|
816
|
|
|
case "rest": |
|
817
|
13 |
|
$i--; // rest can be empty |
|
818
|
|
|
break 2; |
|
819
|
|
|
} |
|
820
|
|
|
} |
|
821
|
|
|
|
|
822
|
|
|
if ($block->isVararg) { |
|
823
|
|
|
return true; // not having enough is handled above |
|
824
|
|
|
} else { |
|
825
|
|
|
$numMatched = $i + 1; |
|
826
|
|
|
|
|
827
|
|
|
// greater than because default values always match |
|
828
|
|
|
return $numMatched >= count($orderedArgs); |
|
829
|
21 |
|
} |
|
830
|
|
|
} |
|
831
|
21 |
|
|
|
832
|
21 |
|
/** |
|
833
|
|
|
* @param array $blocks |
|
834
|
21 |
|
* @param $orderedArgs |
|
835
|
1 |
|
* @param $keywordArgs |
|
836
|
|
|
* @param array $skip |
|
837
|
|
|
* |
|
838
|
21 |
|
* @return array|null |
|
839
|
21 |
|
*/ |
|
840
|
|
|
protected function patternMatchAll(array $blocks, $orderedArgs, $keywordArgs, array $skip = []) |
|
841
|
|
|
{ |
|
842
|
|
|
$matches = null; |
|
843
|
21 |
|
foreach ($blocks as $block) { |
|
844
|
|
|
// skip seen blocks that don't have arguments |
|
845
|
|
|
if (isset($skip[$block->id]) && !isset($block->args)) { |
|
846
|
|
|
continue; |
|
847
|
|
|
} |
|
848
|
|
|
|
|
849
|
|
|
if ($this->patternMatch($block, $orderedArgs, $keywordArgs)) { |
|
850
|
|
|
$matches[] = $block; |
|
851
|
|
|
} |
|
852
|
|
|
} |
|
853
|
|
|
|
|
854
|
|
|
return $matches; |
|
855
|
|
|
} |
|
856
|
|
|
|
|
857
|
22 |
|
/** |
|
858
|
|
|
* attempt to find blocks matched by path and args |
|
859
|
22 |
|
* |
|
860
|
5 |
|
* @param $searchIn |
|
861
|
|
|
* @param array $path |
|
862
|
22 |
|
* @param $orderedArgs |
|
863
|
1 |
|
* @param $keywordArgs |
|
864
|
|
|
* @param array $seen |
|
865
|
22 |
|
* |
|
866
|
|
|
* @return array|null |
|
867
|
22 |
|
*/ |
|
868
|
|
|
protected function findBlocks($searchIn, array $path, $orderedArgs, $keywordArgs, array $seen = []) |
|
869
|
22 |
|
{ |
|
870
|
21 |
|
if ($searchIn === null) { |
|
871
|
21 |
|
return null; |
|
872
|
21 |
|
} |
|
873
|
21 |
|
if (isset($seen[$searchIn->id])) { |
|
874
|
|
|
return null; |
|
875
|
|
|
} |
|
876
|
21 |
|
$seen[$searchIn->id] = true; |
|
877
|
|
|
|
|
878
|
|
|
$name = $path[0]; |
|
879
|
3 |
|
|
|
880
|
3 |
|
if (isset($searchIn->children[$name])) { |
|
881
|
3 |
|
$blocks = $searchIn->children[$name]; |
|
882
|
|
|
if (count($path) === 1) { |
|
883
|
3 |
|
$matches = $this->patternMatchAll($blocks, $orderedArgs, $keywordArgs, $seen); |
|
884
|
|
|
if (!empty($matches)) { |
|
885
|
|
|
// This will return all blocks that match in the closest |
|
886
|
|
|
// scope that has any matching block, like lessjs |
|
887
|
|
|
return $matches; |
|
888
|
|
|
} |
|
889
|
3 |
|
} else { |
|
890
|
3 |
|
$matches = []; |
|
891
|
3 |
|
foreach ($blocks as $subBlock) { |
|
892
|
|
|
$subMatches = $this->findBlocks( |
|
893
|
|
|
$subBlock, |
|
894
|
|
|
array_slice($path, 1), |
|
895
|
|
|
$orderedArgs, |
|
896
|
3 |
|
$keywordArgs, |
|
897
|
|
|
$seen |
|
898
|
|
|
); |
|
899
|
22 |
|
|
|
900
|
|
|
if ($subMatches !== null) { |
|
901
|
|
|
foreach ($subMatches as $sm) { |
|
902
|
|
|
$matches[] = $sm; |
|
903
|
22 |
|
} |
|
904
|
|
|
} |
|
905
|
|
|
} |
|
906
|
|
|
|
|
907
|
|
|
return count($matches) > 0 ? $matches : null; |
|
908
|
|
|
} |
|
909
|
|
|
} |
|
910
|
|
|
if ($searchIn->parent === $searchIn) { |
|
911
|
|
|
return null; |
|
912
|
|
|
} |
|
913
|
|
|
|
|
914
|
|
|
return $this->findBlocks($searchIn->parent, $path, $orderedArgs, $keywordArgs, $seen); |
|
915
|
|
|
} |
|
916
|
16 |
|
|
|
917
|
|
|
/** |
|
918
|
16 |
|
* sets all argument names in $args to either the default value |
|
919
|
|
|
* or the one passed in through $values |
|
920
|
16 |
|
* |
|
921
|
16 |
|
* @param array $args |
|
922
|
14 |
|
* @param $orderedValues |
|
923
|
14 |
|
* @param $keywordValues |
|
924
|
|
|
* |
|
925
|
2 |
|
* @throws \LesserPhp\Exception\GeneralException |
|
926
|
14 |
|
*/ |
|
927
|
|
|
protected function zipSetArgs(array $args, $orderedValues, $keywordValues) |
|
928
|
13 |
|
{ |
|
929
|
13 |
|
$assignedValues = []; |
|
930
|
6 |
|
|
|
931
|
|
|
$i = 0; |
|
932
|
6 |
|
foreach ($args as $a) { |
|
933
|
|
|
if ($a[0] === "arg") { |
|
934
|
|
|
if (isset($keywordValues[$a[1]])) { |
|
935
|
|
|
// has keyword arg |
|
936
|
|
|
$value = $keywordValues[$a[1]]; |
|
937
|
14 |
|
} elseif (isset($orderedValues[$i])) { |
|
938
|
14 |
|
// has ordered arg |
|
939
|
14 |
|
$value = $orderedValues[$i]; |
|
940
|
|
|
$i++; |
|
941
|
|
|
} elseif (isset($a[2])) { |
|
942
|
14 |
|
// has default value |
|
943
|
|
|
$value = $a[2]; |
|
944
|
|
|
} else { |
|
945
|
|
|
throw new GeneralException('Failed to assign arg ' . $a[1]); |
|
946
|
|
|
} |
|
947
|
16 |
|
|
|
948
|
16 |
|
$value = $this->reduce($value); |
|
949
|
2 |
|
$this->set($a[1], $value); |
|
950
|
2 |
|
$assignedValues[] = $value; |
|
951
|
|
|
} else { |
|
952
|
|
|
// a lit |
|
953
|
|
|
$i++; |
|
954
|
16 |
|
} |
|
955
|
16 |
|
} |
|
956
|
|
|
|
|
957
|
|
|
// check for a rest |
|
958
|
|
|
$last = end($args); |
|
959
|
|
|
if ($last[0] === "rest") { |
|
960
|
|
|
$rest = array_slice($orderedValues, count($args) - 1); |
|
961
|
|
|
$this->set($last[1], $this->reduce(["list", " ", $rest])); |
|
962
|
|
|
} |
|
963
|
|
|
|
|
964
|
|
|
// wow is this the only true use of PHP's + operator for arrays? |
|
965
|
|
|
$this->env->setArguments($assignedValues + $orderedValues); |
|
966
|
49 |
|
} |
|
967
|
|
|
|
|
968
|
|
|
/** |
|
969
|
49 |
|
* compile a prop and update $lines or $blocks appropriately |
|
970
|
|
|
* |
|
971
|
49 |
|
* @param $prop |
|
972
|
49 |
|
* @param Block $block |
|
973
|
43 |
|
* @param $out |
|
974
|
43 |
|
* |
|
975
|
23 |
|
* @throws \LesserPhp\Exception\GeneralException |
|
976
|
|
|
*/ |
|
977
|
43 |
|
protected function compileProp($prop, Block $block, $out) |
|
978
|
|
|
{ |
|
979
|
43 |
|
// set error position context |
|
980
|
|
|
$this->sourceLoc = isset($prop[-1]) ? $prop[-1] : -1; |
|
981
|
|
|
|
|
982
|
37 |
|
switch ($prop[0]) { |
|
983
|
47 |
|
case 'assign': |
|
984
|
46 |
|
list(, $name, $value) = $prop; |
|
985
|
46 |
|
if ($name[0] == $this->vPrefix) { |
|
986
|
35 |
|
$this->set($name, $value); |
|
987
|
25 |
|
} else { |
|
988
|
25 |
|
$out->lines[] = $this->formatter->property( |
|
989
|
22 |
|
$name, |
|
990
|
|
|
$this->compileValue($this->reduce($value)) |
|
991
|
22 |
|
); |
|
992
|
22 |
|
} |
|
993
|
22 |
|
break; |
|
994
|
15 |
|
case 'block': |
|
995
|
15 |
|
list(, $child) = $prop; |
|
996
|
4 |
|
$this->compileBlock($child); |
|
997
|
3 |
|
break; |
|
998
|
|
|
case 'ruleset': |
|
999
|
2 |
|
case 'mixin': |
|
1000
|
|
|
list(, $path, $args, $suffix) = $prop; |
|
1001
|
4 |
|
|
|
1002
|
|
|
$orderedArgs = []; |
|
1003
|
15 |
|
$keywordArgs = []; |
|
1004
|
15 |
|
foreach ((array)$args as $arg) { |
|
1005
|
15 |
|
switch ($arg[0]) { |
|
1006
|
|
|
case "arg": |
|
1007
|
15 |
|
if (!isset($arg[2])) { |
|
1008
|
|
|
$orderedArgs[] = $this->reduce(["variable", $arg[1]]); |
|
1009
|
|
|
} else { |
|
1010
|
|
|
$keywordArgs[$arg[1]] = $this->reduce($arg[2]); |
|
1011
|
22 |
|
} |
|
1012
|
|
|
break; |
|
1013
|
22 |
|
|
|
1014
|
5 |
|
case "lit": |
|
1015
|
|
|
$orderedArgs[] = $this->reduce($arg[1]); |
|
1016
|
|
|
break; |
|
1017
|
17 |
|
default: |
|
1018
|
|
|
throw new GeneralException("Unknown arg type: " . $arg[0]); |
|
1019
|
8 |
|
} |
|
1020
|
|
|
} |
|
1021
|
|
|
|
|
1022
|
17 |
|
$mixins = $this->findBlocks($block, $path, $orderedArgs, $keywordArgs); |
|
1023
|
17 |
|
|
|
1024
|
|
|
if ($mixins === null) { |
|
1025
|
|
|
$block->parser->throwError("{$prop[1][0]} is undefined", $block->count); |
|
1026
|
|
|
} |
|
1027
|
17 |
|
|
|
1028
|
17 |
|
if (strpos($prop[1][0], "$") === 0) { |
|
1029
|
2 |
|
//Use Ruleset Logic - Only last element |
|
1030
|
2 |
|
$mixins = [array_pop($mixins)]; |
|
1031
|
2 |
|
} |
|
1032
|
|
|
|
|
1033
|
|
|
foreach ($mixins as $mixin) { |
|
|
|
|
|
|
1034
|
17 |
|
if ($mixin === $block && !$orderedArgs) { |
|
|
|
|
|
|
1035
|
17 |
|
continue; |
|
1036
|
14 |
|
} |
|
1037
|
14 |
|
|
|
1038
|
14 |
|
$haveScope = false; |
|
1039
|
|
|
if (isset($mixin->parent->scope)) { |
|
1040
|
|
|
$haveScope = true; |
|
1041
|
17 |
|
$mixinParentEnv = $this->pushEnv($this->env); |
|
1042
|
17 |
|
$mixinParentEnv->storeParent = $mixin->parent->scope; |
|
|
|
|
|
|
1043
|
17 |
|
} |
|
1044
|
|
|
|
|
1045
|
|
|
$haveArgs = false; |
|
1046
|
17 |
|
if (isset($mixin->args)) { |
|
1047
|
17 |
|
$haveArgs = true; |
|
1048
|
17 |
|
$this->pushEnv($this->env); |
|
1049
|
17 |
|
$this->zipSetArgs($mixin->args, $orderedArgs, $keywordArgs); |
|
1050
|
17 |
|
} |
|
1051
|
|
|
|
|
1052
|
1 |
|
$oldParent = $mixin->parent; |
|
1053
|
1 |
|
if ($mixin != $block) { |
|
1054
|
1 |
|
$mixin->parent = $block; |
|
1055
|
1 |
|
} |
|
1056
|
|
|
|
|
1057
|
|
|
foreach ($this->sortProps($mixin->props) as $subProp) { |
|
1058
|
|
|
if ($suffix !== null && |
|
1059
|
17 |
|
$subProp[0] === "assign" && |
|
1060
|
|
|
is_string($subProp[1]) && |
|
1061
|
|
|
$subProp[1]{0} != $this->vPrefix |
|
1062
|
17 |
|
) { |
|
1063
|
|
|
$subProp[2] = [ |
|
1064
|
17 |
|
'list', |
|
1065
|
14 |
|
' ', |
|
1066
|
|
|
[$subProp[2], ['keyword', $suffix]], |
|
1067
|
17 |
|
]; |
|
1068
|
17 |
|
} |
|
1069
|
|
|
|
|
1070
|
|
|
$this->compileProp($subProp, $mixin, $out); |
|
1071
|
|
|
} |
|
1072
|
17 |
|
|
|
1073
|
5 |
|
$mixin->parent = $oldParent; |
|
1074
|
|
|
|
|
1075
|
|
|
if ($haveArgs) { |
|
1076
|
5 |
|
$this->popEnv(); |
|
1077
|
1 |
|
} |
|
1078
|
1 |
|
if ($haveScope) { |
|
1079
|
1 |
|
$this->popEnv(); |
|
1080
|
4 |
|
} |
|
1081
|
1 |
|
} |
|
1082
|
1 |
|
|
|
1083
|
3 |
|
break; |
|
1084
|
3 |
|
case 'raw': |
|
1085
|
3 |
|
$out->lines[] = $prop[1]; |
|
1086
|
|
|
break; |
|
1087
|
3 |
|
case "directive": |
|
1088
|
|
|
list(, $name, $value) = $prop; |
|
1089
|
3 |
|
$out->lines[] = "@$name " . $this->compileValue($this->reduce($value)) . ';'; |
|
1090
|
2 |
|
break; |
|
1091
|
3 |
|
case "comment": |
|
1092
|
|
|
$out->lines[] = $prop[1]; |
|
1093
|
3 |
|
break; |
|
1094
|
3 |
|
case "import": |
|
1095
|
3 |
|
list(, $importPath, $importId) = $prop; |
|
1096
|
3 |
|
$importPath = $this->reduce($importPath); |
|
1097
|
3 |
|
|
|
1098
|
3 |
|
$result = $this->tryImport($importPath, $block, $out); |
|
1099
|
3 |
|
|
|
1100
|
|
|
$this->env->addImports($importId, $result === false ? |
|
1101
|
|
|
[false, "@import " . $this->compileValue($importPath) . ";"] : |
|
1102
|
2 |
|
$result); |
|
1103
|
2 |
|
|
|
1104
|
|
|
break; |
|
1105
|
|
|
case "import_mixin": |
|
1106
|
3 |
|
list(, $importId) = $prop; |
|
1107
|
|
|
$import = $this->env->getImports($importId); |
|
1108
|
|
|
if ($import[0] === false) { |
|
1109
|
|
|
if (isset($import[1])) { |
|
1110
|
38 |
|
$out->lines[] = $import[1]; |
|
1111
|
|
|
} |
|
1112
|
|
|
} else { |
|
1113
|
|
|
list(, $bottom, $parser, $importDir) = $import; |
|
|
|
|
|
|
1114
|
|
|
$this->compileImportedProps($bottom, $block, $out, $importDir); |
|
1115
|
|
|
} |
|
1116
|
|
|
|
|
1117
|
|
|
break; |
|
1118
|
|
|
default: |
|
1119
|
|
|
$block->parser->throwError("unknown op: {$prop[0]}\n", $block->count); |
|
1120
|
|
|
} |
|
1121
|
|
|
} |
|
1122
|
|
|
|
|
1123
|
|
|
|
|
1124
|
|
|
/** |
|
1125
|
|
|
* Compiles a primitive value into a CSS property value. |
|
1126
|
|
|
* |
|
1127
|
|
|
* Values in lessphp are typed by being wrapped in arrays, their format is |
|
1128
|
|
|
* typically: |
|
1129
|
|
|
* |
|
1130
|
53 |
|
* array(type, contents [, additional_contents]*) |
|
1131
|
|
|
* |
|
1132
|
|
|
* The input is expected to be reduced. This function will not work on |
|
1133
|
53 |
|
* things like expressions and variables. |
|
1134
|
|
|
* |
|
1135
|
|
|
* @param array $value |
|
1136
|
|
|
* @param array $options |
|
1137
|
53 |
|
* |
|
1138
|
53 |
|
* @return string |
|
1139
|
53 |
|
* @throws GeneralException |
|
1140
|
|
|
*/ |
|
1141
|
|
|
public function compileValue(array $value, array $options = []) |
|
1142
|
53 |
|
{ |
|
1143
|
|
|
try { |
|
1144
|
52 |
|
if (!isset($value[0])) { |
|
1145
|
1 |
|
throw new GeneralException('Missing value type'); |
|
1146
|
1 |
|
} |
|
1147
|
|
|
|
|
1148
|
|
|
$options = array_replace([ |
|
1149
|
|
|
'numberPrecision' => $this->numberPrecision, |
|
1150
|
|
|
'compressColors' => ($this->formatter ? $this->formatter->getCompressColors() : false), |
|
1151
|
|
|
], $options); |
|
1152
|
|
|
|
|
1153
|
|
|
$valueClass = \LesserPhp\Compiler\Value\AbstractValue::factory($this, $this->coerce, $options, $value); |
|
1154
|
|
|
|
|
1155
|
|
|
return $valueClass->getCompiled(); |
|
1156
|
|
|
} catch (\UnexpectedValueException $e) { |
|
1157
|
|
|
throw new GeneralException($e->getMessage()); |
|
1158
|
2 |
|
} |
|
1159
|
|
|
} |
|
1160
|
2 |
|
|
|
1161
|
1 |
|
/** |
|
1162
|
|
|
* Helper function to get arguments for color manipulation functions. |
|
1163
|
2 |
|
* takes a list that contains a color like thing and a percentage |
|
1164
|
2 |
|
* |
|
1165
|
2 |
|
* @param array $args |
|
1166
|
|
|
* |
|
1167
|
2 |
|
* @return array |
|
1168
|
|
|
*/ |
|
1169
|
|
|
public function colorArgs(array $args) |
|
1170
|
|
|
{ |
|
1171
|
|
|
if ($args[0] !== 'list' || count($args[2]) < 2) { |
|
1172
|
|
|
return [['color', 0, 0, 0], 0]; |
|
1173
|
|
|
} |
|
1174
|
|
|
list($color, $delta) = $args[2]; |
|
1175
|
|
|
$color = $this->assertions->assertColor($color); |
|
1176
|
|
|
$delta = (float) $delta[1]; |
|
1177
|
|
|
|
|
1178
|
24 |
|
return [$color, $delta]; |
|
1179
|
|
|
} |
|
1180
|
24 |
|
|
|
1181
|
24 |
|
/** |
|
1182
|
6 |
|
* Convert the rgb, rgba, hsl color literals of function type |
|
1183
|
|
|
* as returned by the parser into values of color type. |
|
1184
|
|
|
* |
|
1185
|
24 |
|
* @param array $func |
|
1186
|
|
|
* |
|
1187
|
24 |
|
* @return bool|mixed |
|
1188
|
1 |
|
*/ |
|
1189
|
1 |
|
protected function funcToColor(array $func) |
|
1190
|
1 |
|
{ |
|
1191
|
1 |
|
$fname = $func[1]; |
|
1192
|
1 |
|
if ($func[2][0] !== 'list') { |
|
1193
|
|
|
return false; |
|
1194
|
1 |
|
} // need a list of arguments |
|
1195
|
1 |
|
/** @var array $rawComponents */ |
|
1196
|
1 |
|
$rawComponents = $func[2][2]; |
|
1197
|
1 |
|
|
|
1198
|
|
|
if ($fname === 'hsl' || $fname === 'hsla') { |
|
1199
|
1 |
|
$hsl = ['hsl']; |
|
1200
|
|
|
$i = 0; |
|
1201
|
|
|
foreach ($rawComponents as $c) { |
|
1202
|
1 |
|
$val = $this->reduce($c); |
|
1203
|
1 |
|
$val = isset($val[1]) ? (float) $val[1] : 0; |
|
1204
|
|
|
|
|
1205
|
|
|
if ($i === 0) { |
|
1206
|
1 |
|
$clamp = 360; |
|
1207
|
|
|
} elseif ($i < 3) { |
|
1208
|
|
|
$clamp = 100; |
|
1209
|
|
|
} else { |
|
1210
|
1 |
|
$clamp = 1; |
|
1211
|
24 |
|
} |
|
1212
|
4 |
|
|
|
1213
|
4 |
|
$hsl[] = $this->converter->clamp($val, $clamp); |
|
1214
|
4 |
|
$i++; |
|
1215
|
4 |
|
} |
|
1216
|
4 |
|
|
|
1217
|
4 |
|
while (count($hsl) < 4) { |
|
1218
|
1 |
|
$hsl[] = 0; |
|
1219
|
|
|
} |
|
1220
|
4 |
|
|
|
1221
|
|
|
return $this->converter->toRGB($hsl); |
|
1222
|
4 |
|
} elseif ($fname === 'rgb' || $fname === 'rgba') { |
|
1223
|
4 |
|
$components = []; |
|
1224
|
|
|
$i = 1; |
|
1225
|
|
|
foreach ($rawComponents as $c) { |
|
1226
|
4 |
|
$c = $this->reduce($c); |
|
1227
|
|
|
if ($i < 4) { |
|
1228
|
|
|
if ($c[0] === "number" && $c[2] === "%") { |
|
1229
|
|
|
$components[] = 255 * ($c[1] / 100); |
|
1230
|
|
|
} else { |
|
1231
|
|
|
$components[] = (float) $c[1]; |
|
1232
|
4 |
|
} |
|
1233
|
|
|
} elseif ($i === 4) { |
|
1234
|
4 |
|
if ($c[0] === "number" && $c[2] === "%") { |
|
1235
|
|
|
$components[] = 1.0 * ($c[1] / 100); |
|
1236
|
|
|
} else { |
|
1237
|
4 |
|
$components[] = (float) $c[1]; |
|
1238
|
|
|
} |
|
1239
|
4 |
|
} else { |
|
1240
|
|
|
break; |
|
1241
|
|
|
} |
|
1242
|
23 |
|
|
|
1243
|
|
|
$i++; |
|
1244
|
|
|
} |
|
1245
|
|
|
while (count($components) < 3) { |
|
1246
|
|
|
$components[] = 0; |
|
1247
|
|
|
} |
|
1248
|
|
|
array_unshift($components, 'color'); |
|
1249
|
|
|
|
|
1250
|
|
|
return $this->fixColor($components); |
|
1251
|
48 |
|
} |
|
1252
|
|
|
|
|
1253
|
48 |
|
return false; |
|
1254
|
48 |
|
} |
|
1255
|
7 |
|
|
|
1256
|
7 |
|
/** |
|
1257
|
7 |
|
* @param array $value |
|
1258
|
|
|
* @param bool $forExpression |
|
1259
|
7 |
|
* |
|
1260
|
1 |
|
* @return array|bool|mixed|null // <!-- dafuq? |
|
1261
|
|
|
*/ |
|
1262
|
|
|
public function reduce(array $value, $forExpression = false) |
|
1263
|
7 |
|
{ |
|
1264
|
6 |
|
switch ($value[0]) { |
|
1265
|
|
|
case "interpolate": |
|
1266
|
|
|
$reduced = $this->reduce($value[1]); |
|
1267
|
7 |
|
$var = $this->compileValue($reduced); |
|
1268
|
48 |
|
$res = $this->reduce(["variable", $this->vPrefix . $var]); |
|
1269
|
28 |
|
|
|
1270
|
28 |
|
if ($res[0] === "raw_color") { |
|
1271
|
1 |
|
$res = $this->coerce->coerceColor($res); |
|
1272
|
1 |
|
} |
|
1273
|
|
|
|
|
1274
|
|
|
if (empty($value[2])) { |
|
1275
|
28 |
|
$res = $this->functions->e($res); |
|
1276
|
|
|
} |
|
1277
|
28 |
|
|
|
1278
|
|
|
return $res; |
|
1279
|
|
|
case "variable": |
|
1280
|
|
|
$key = $value[1]; |
|
1281
|
28 |
|
if (is_array($key)) { |
|
1282
|
28 |
|
$key = $this->reduce($key); |
|
1283
|
27 |
|
$key = $this->vPrefix . $this->compileValue($this->functions->e($key)); |
|
1284
|
|
|
} |
|
1285
|
27 |
|
|
|
1286
|
47 |
|
$seen =& $this->env->seenNames; |
|
1287
|
29 |
|
|
|
1288
|
26 |
|
if (!empty($seen[$key])) { |
|
1289
|
|
|
$this->throwError("infinite loop detected: $key"); |
|
1290
|
|
|
} |
|
1291
|
29 |
|
|
|
1292
|
47 |
|
$seen[$key] = true; |
|
1293
|
19 |
|
$out = $this->reduce($this->get($key)); |
|
1294
|
47 |
|
$seen[$key] = false; |
|
1295
|
26 |
|
|
|
1296
|
26 |
|
return $out; |
|
1297
|
11 |
|
case "list": |
|
1298
|
11 |
|
foreach ($value[2] as &$item) { |
|
1299
|
11 |
|
$item = $this->reduce($item, $forExpression); |
|
1300
|
26 |
|
} |
|
1301
|
|
|
|
|
1302
|
|
|
return $value; |
|
1303
|
|
|
case "expression": |
|
1304
|
|
|
return $this->evaluate($value); |
|
1305
|
26 |
|
case "string": |
|
1306
|
45 |
|
foreach ($value[2] as &$part) { |
|
1307
|
4 |
|
if (is_array($part)) { |
|
1308
|
|
|
$strip = $part[0] === "variable"; |
|
1309
|
4 |
|
$part = $this->reduce($part); |
|
1310
|
45 |
|
if ($strip) { |
|
1311
|
24 |
|
$part = $this->functions->e($part); |
|
1312
|
24 |
|
} |
|
1313
|
4 |
|
} |
|
1314
|
|
|
} |
|
1315
|
|
|
|
|
1316
|
23 |
|
return $value; |
|
1317
|
23 |
|
case "escape": |
|
1318
|
1 |
|
list(, $inner) = $value; |
|
1319
|
|
|
|
|
1320
|
|
|
return $this->functions->e($this->reduce($inner)); |
|
1321
|
|
|
case "function": |
|
1322
|
23 |
|
$color = $this->funcToColor($value); |
|
1323
|
23 |
|
if ($color) { |
|
1324
|
1 |
|
return $color; |
|
1325
|
|
|
} |
|
1326
|
|
|
|
|
1327
|
23 |
|
list(, $name, $args) = $value; |
|
1328
|
|
|
if ($name === "%") { |
|
1329
|
23 |
|
$name = "_sprintf"; |
|
1330
|
14 |
|
} |
|
1331
|
14 |
|
|
|
1332
|
|
|
// user functions |
|
1333
|
|
|
$f = null; |
|
1334
|
14 |
|
if (isset($this->libFunctions[$name]) && is_callable($this->libFunctions[$name])) { |
|
1335
|
1 |
|
$f = $this->libFunctions[$name]; |
|
1336
|
|
|
} |
|
1337
|
13 |
|
|
|
1338
|
|
|
$func = str_replace('-', '_', $name); |
|
1339
|
9 |
|
|
|
1340
|
|
|
if ($f !== null || method_exists($this->functions, $func)) { |
|
1341
|
2 |
|
if ($args[0] === 'list') { |
|
1342
|
2 |
|
$args = self::compressList($args[2], $args[1]); |
|
1343
|
|
|
} |
|
1344
|
2 |
|
|
|
1345
|
2 |
|
if ($f !== null) { |
|
1346
|
2 |
|
$ret = $f($this->reduce($args, true), $this); |
|
1347
|
2 |
|
} else { |
|
1348
|
|
|
$ret = $this->functions->$func($this->reduce($args, true), $this); |
|
1349
|
|
|
} |
|
1350
|
|
|
if ($ret === null) { |
|
1351
|
|
|
return [ |
|
1352
|
|
|
"string", |
|
1353
|
8 |
|
"", |
|
1354
|
3 |
|
[ |
|
1355
|
7 |
|
$name, |
|
1356
|
2 |
|
"(", |
|
1357
|
|
|
$args, |
|
1358
|
|
|
")", |
|
1359
|
8 |
|
], |
|
1360
|
|
|
]; |
|
1361
|
|
|
} |
|
1362
|
|
|
|
|
1363
|
10 |
|
// convert to a typed value if the result is a php primitive |
|
1364
|
|
|
if (is_numeric($ret)) { |
|
1365
|
10 |
|
$ret = ['number', $ret, ""]; |
|
1366
|
40 |
|
} elseif (!is_array($ret)) { |
|
1367
|
6 |
|
$ret = ['keyword', $ret]; |
|
1368
|
6 |
|
} |
|
1369
|
|
|
|
|
1370
|
6 |
|
return $ret; |
|
1371
|
|
|
} |
|
1372
|
6 |
|
|
|
1373
|
|
|
// plain function, reduce args |
|
1374
|
6 |
|
$value[2] = $this->reduce($value[2]); |
|
1375
|
6 |
|
|
|
1376
|
|
|
return $value; |
|
1377
|
6 |
|
case "unary": |
|
1378
|
|
|
list(, $op, $exp) = $value; |
|
1379
|
|
|
$exp = $this->reduce($exp); |
|
1380
|
|
|
|
|
1381
|
|
|
if ($exp[0] === "number") { |
|
1382
|
|
|
switch ($op) { |
|
1383
|
|
|
case "+": |
|
1384
|
40 |
|
return $exp; |
|
1385
|
22 |
|
case "-": |
|
1386
|
22 |
|
$exp[1] *= -1; |
|
1387
|
5 |
|
|
|
1388
|
5 |
|
return $exp; |
|
1389
|
2 |
|
} |
|
1390
|
|
|
} |
|
1391
|
5 |
|
|
|
1392
|
22 |
|
return ["string", "", [$op, $exp]]; |
|
1393
|
6 |
|
} |
|
1394
|
|
|
|
|
1395
|
|
|
if ($forExpression) { |
|
1396
|
|
|
switch ($value[0]) { |
|
1397
|
40 |
|
case "keyword": |
|
1398
|
|
|
$color = $this->coerce->coerceColor($value); |
|
1399
|
|
|
if ($color !== null) { |
|
1400
|
|
|
return $color; |
|
1401
|
|
|
} |
|
1402
|
|
|
break; |
|
1403
|
|
|
case "raw_color": |
|
1404
|
|
|
return $this->coerce->coerceColor($value); |
|
1405
|
|
|
} |
|
1406
|
|
|
} |
|
1407
|
2 |
|
|
|
1408
|
|
|
return $value; |
|
1409
|
2 |
|
} |
|
1410
|
2 |
|
|
|
1411
|
|
|
/** |
|
1412
|
|
|
* turn list of length 1 into value type |
|
1413
|
2 |
|
* |
|
1414
|
|
|
* @param array $value |
|
1415
|
|
|
* |
|
1416
|
|
|
* @return array |
|
1417
|
|
|
*/ |
|
1418
|
|
|
protected function flattenList(array $value) |
|
1419
|
|
|
{ |
|
1420
|
|
|
if ($value[0] === 'list' && count($value[2]) === 1) { |
|
1421
|
|
|
return $this->flattenList($value[2][0]); |
|
1422
|
|
|
} |
|
1423
|
19 |
|
|
|
1424
|
|
|
return $value; |
|
1425
|
19 |
|
} |
|
1426
|
|
|
|
|
1427
|
19 |
|
/** |
|
1428
|
19 |
|
* evaluate an expression |
|
1429
|
|
|
* |
|
1430
|
19 |
|
* @param array $exp |
|
1431
|
19 |
|
* |
|
1432
|
5 |
|
* @return array |
|
1433
|
|
|
*/ |
|
1434
|
|
|
protected function evaluate($exp) |
|
1435
|
19 |
|
{ |
|
1436
|
19 |
|
list(, $op, $left, $right, $whiteBefore, $whiteAfter) = $exp; |
|
1437
|
5 |
|
|
|
1438
|
|
|
$left = $this->reduce($left, true); |
|
1439
|
|
|
$right = $this->reduce($right, true); |
|
1440
|
19 |
|
|
|
1441
|
19 |
|
$leftColor = $this->coerce->coerceColor($left); |
|
1442
|
|
|
if ($leftColor !== null) { |
|
1443
|
|
|
$left = $leftColor; |
|
1444
|
19 |
|
} |
|
1445
|
|
|
|
|
1446
|
|
|
$rightColor = $this->coerce->coerceColor($right); |
|
1447
|
|
|
if ($rightColor !== null) { |
|
1448
|
19 |
|
$right = $rightColor; |
|
1449
|
1 |
|
} |
|
1450
|
|
|
|
|
1451
|
|
|
$ltype = $left[0]; |
|
1452
|
19 |
|
$rtype = $right[0]; |
|
1453
|
19 |
|
|
|
1454
|
2 |
|
// operators that work on all types |
|
1455
|
|
|
if ($op === "and") { |
|
1456
|
|
|
return $this->functions->toBool($left == self::$TRUE && $right == self::$TRUE); |
|
1457
|
|
|
} |
|
1458
|
17 |
|
|
|
1459
|
17 |
|
if ($op === "=") { |
|
1460
|
17 |
|
return $this->functions->toBool($this->equals($left, $right)); |
|
1461
|
17 |
|
} |
|
1462
|
17 |
|
|
|
1463
|
|
|
$str = $this->stringConcatenate($left, $right); |
|
1464
|
|
|
if ($op === "+" && $str !== null) { |
|
1465
|
|
|
return $str; |
|
1466
|
|
|
} |
|
1467
|
1 |
|
|
|
1468
|
1 |
|
// type based operators |
|
1469
|
1 |
|
$fname = "op_${ltype}_${rtype}"; |
|
1470
|
|
|
if (is_callable([$this, $fname])) { |
|
1471
|
1 |
|
$out = $this->$fname($op, $left, $right); |
|
1472
|
1 |
|
if ($out !== null) { |
|
1473
|
|
|
return $out; |
|
1474
|
|
|
} |
|
1475
|
1 |
|
} |
|
1476
|
|
|
|
|
1477
|
|
|
// make the expression look it did before being parsed |
|
1478
|
|
|
$paddedOp = $op; |
|
1479
|
|
|
if ($whiteBefore) { |
|
1480
|
|
|
$paddedOp = " " . $paddedOp; |
|
1481
|
|
|
} |
|
1482
|
|
|
if ($whiteAfter) { |
|
1483
|
|
|
$paddedOp .= " "; |
|
1484
|
|
|
} |
|
1485
|
|
|
|
|
1486
|
19 |
|
return ["string", "", [$left, $paddedOp, $right]]; |
|
1487
|
19 |
|
} |
|
1488
|
2 |
|
|
|
1489
|
2 |
|
/** |
|
1490
|
|
|
* @param array $left |
|
1491
|
2 |
|
* @param array $right |
|
1492
|
|
|
* |
|
1493
|
2 |
|
* @return array|null |
|
1494
|
|
|
*/ |
|
1495
|
|
|
protected function stringConcatenate(array $left, array $right) |
|
1496
|
18 |
|
{ |
|
1497
|
18 |
|
$strLeft = $this->coerce->coerceString($left); |
|
1498
|
1 |
|
if ($strLeft !== null) { |
|
1499
|
|
|
if ($right[0] === "string") { |
|
1500
|
1 |
|
$right[1] = ""; |
|
1501
|
|
|
} |
|
1502
|
|
|
$strLeft[2][] = $right; |
|
1503
|
17 |
|
|
|
1504
|
|
|
return $strLeft; |
|
1505
|
|
|
} |
|
1506
|
|
|
|
|
1507
|
|
|
$strRight = $this->coerce->coerceString($right); |
|
1508
|
|
|
if ($strRight !== null) { |
|
1509
|
|
|
array_unshift($strRight[2], $left); |
|
1510
|
|
|
|
|
1511
|
|
|
return $strRight; |
|
1512
|
|
|
} |
|
1513
|
|
|
|
|
1514
|
|
|
return null; |
|
1515
|
|
|
} |
|
1516
|
7 |
|
|
|
1517
|
7 |
|
|
|
1518
|
|
|
/** |
|
1519
|
|
|
* make sure a color's components don't go out of bounds |
|
1520
|
7 |
|
* |
|
1521
|
7 |
|
* @param array $c |
|
1522
|
|
|
* |
|
1523
|
|
|
* @return mixed |
|
1524
|
|
|
*/ |
|
1525
|
7 |
|
public function fixColor(array $c) |
|
1526
|
|
|
{ |
|
1527
|
|
|
foreach (range(1, 3) as $i) { |
|
1528
|
|
|
if ($c[$i] < 0) { |
|
1529
|
|
|
$c[$i] = 0; |
|
1530
|
|
|
} |
|
1531
|
|
|
if ($c[$i] > 255) { |
|
1532
|
|
|
$c[$i] = 255; |
|
1533
|
|
|
} |
|
1534
|
|
|
} |
|
1535
|
|
|
|
|
1536
|
|
|
return $c; |
|
1537
|
|
|
} |
|
1538
|
1 |
|
|
|
1539
|
1 |
|
/** |
|
1540
|
|
|
* @param string $op |
|
1541
|
|
|
* @param array $lft |
|
1542
|
1 |
|
* @param array $rgt |
|
1543
|
|
|
* |
|
1544
|
|
|
* @return array|null |
|
1545
|
|
|
* @throws \LesserPhp\Exception\GeneralException |
|
1546
|
|
|
*/ |
|
1547
|
|
|
protected function op_number_color($op, array $lft, array $rgt) |
|
1548
|
|
|
{ |
|
1549
|
|
|
if ($op === '+' || $op === '*') { |
|
1550
|
|
|
return $this->op_color_number($op, $rgt, $lft); |
|
1551
|
|
|
} |
|
1552
|
|
|
|
|
1553
|
|
|
return null; |
|
1554
|
|
|
} |
|
1555
|
2 |
|
|
|
1556
|
|
|
/** |
|
1557
|
|
|
* @param string $op |
|
1558
|
|
|
* @param array $lft |
|
1559
|
2 |
|
* @param array $rgt |
|
1560
|
|
|
* |
|
1561
|
|
|
* @return array |
|
1562
|
2 |
|
* @throws \LesserPhp\Exception\GeneralException |
|
1563
|
|
|
*/ |
|
1564
|
|
|
protected function op_color_number($op, array $lft, array $rgt) |
|
1565
|
|
|
{ |
|
1566
|
|
|
if ($rgt[0] === '%') { |
|
1567
|
|
|
$rgt[1] /= 100; |
|
1568
|
|
|
} |
|
1569
|
|
|
|
|
1570
|
|
|
return $this->op_color_color( |
|
1571
|
|
|
$op, |
|
1572
|
|
|
$lft, |
|
1573
|
|
|
array_fill(1, count($lft) - 1, $rgt[1]) |
|
1574
|
|
|
); |
|
1575
|
|
|
} |
|
1576
|
|
|
|
|
1577
|
5 |
|
/** |
|
1578
|
5 |
|
* @param string $op |
|
1579
|
5 |
|
* @param array |
|
1580
|
5 |
|
* $left |
|
1581
|
5 |
|
* @param array $right |
|
1582
|
|
|
* |
|
1583
|
5 |
|
* @return array |
|
1584
|
5 |
|
* @throws \LesserPhp\Exception\GeneralException |
|
1585
|
5 |
|
*/ |
|
1586
|
1 |
|
protected function op_color_color($op, array $left, array $right) |
|
1587
|
1 |
|
{ |
|
1588
|
1 |
|
$out = ['color']; |
|
1589
|
1 |
|
$max = count($left) > count($right) ? count($left) : count($right); |
|
1590
|
1 |
|
foreach (range(1, $max - 1) as $i) { |
|
1591
|
1 |
|
$lval = isset($left[$i]) ? $left[$i] : 0; |
|
1592
|
1 |
|
$rval = isset($right[$i]) ? $right[$i] : 0; |
|
1593
|
1 |
|
switch ($op) { |
|
1594
|
1 |
|
case '+': |
|
1595
|
1 |
|
$out[] = $lval + $rval; |
|
1596
|
1 |
|
break; |
|
1597
|
|
|
case '-': |
|
1598
|
|
|
$out[] = $lval - $rval; |
|
1599
|
1 |
|
break; |
|
1600
|
1 |
|
case '*': |
|
1601
|
|
|
$out[] = $lval * $rval; |
|
1602
|
5 |
|
break; |
|
1603
|
|
|
case '%': |
|
1604
|
|
|
$out[] = $lval % $rval; |
|
1605
|
|
|
break; |
|
1606
|
5 |
|
case '/': |
|
1607
|
|
|
if ($rval == 0) { |
|
1608
|
|
|
throw new GeneralException("evaluate error: can't divide by zero"); |
|
1609
|
|
|
} |
|
1610
|
|
|
$out[] = $lval / $rval; |
|
1611
|
|
|
break; |
|
1612
|
|
|
default: |
|
1613
|
|
|
throw new GeneralException('evaluate error: color op number failed on op ' . $op); |
|
1614
|
|
|
} |
|
1615
|
|
|
} |
|
1616
|
|
|
|
|
1617
|
|
|
return $this->fixColor($out); |
|
1618
|
|
|
} |
|
1619
|
|
|
|
|
1620
|
|
|
/** |
|
1621
|
15 |
|
* operator on two numbers |
|
1622
|
|
|
* |
|
1623
|
15 |
|
* @param string $op |
|
1624
|
|
|
* @param array $left |
|
1625
|
15 |
|
* @param array $right |
|
1626
|
9 |
|
* |
|
1627
|
9 |
|
* @return array |
|
1628
|
12 |
|
* @throws \LesserPhp\Exception\GeneralException |
|
1629
|
8 |
|
*/ |
|
1630
|
8 |
|
protected function op_number_number($op, $left, $right) |
|
1631
|
10 |
|
{ |
|
1632
|
6 |
|
$unit = empty($left[2]) ? $right[2] : $left[2]; |
|
1633
|
6 |
|
|
|
1634
|
9 |
|
$value = 0; |
|
|
|
|
|
|
1635
|
1 |
|
switch ($op) { |
|
1636
|
1 |
|
case '+': |
|
1637
|
8 |
|
$value = $left[1] + $right[1]; |
|
1638
|
4 |
|
break; |
|
1639
|
|
|
case '*': |
|
1640
|
|
|
$value = $left[1] * $right[1]; |
|
1641
|
4 |
|
break; |
|
1642
|
4 |
|
case '-': |
|
1643
|
5 |
|
$value = $left[1] - $right[1]; |
|
1644
|
1 |
|
break; |
|
1645
|
5 |
|
case '%': |
|
1646
|
3 |
|
$value = $left[1] % $right[1]; |
|
1647
|
3 |
|
break; |
|
1648
|
1 |
|
case '/': |
|
1649
|
2 |
|
if ($right[1] == 0) { |
|
1650
|
2 |
|
throw new GeneralException('parse error: divide by zero'); |
|
1651
|
|
|
} |
|
1652
|
|
|
$value = $left[1] / $right[1]; |
|
1653
|
|
|
break; |
|
1654
|
|
|
case '<': |
|
1655
|
13 |
|
return $this->functions->toBool($left[1] < $right[1]); |
|
1656
|
|
|
case '>': |
|
1657
|
|
|
return $this->functions->toBool($left[1] > $right[1]); |
|
1658
|
|
|
case '>=': |
|
1659
|
|
|
return $this->functions->toBool($left[1] >= $right[1]); |
|
1660
|
|
|
case '=<': |
|
1661
|
|
|
return $this->functions->toBool($left[1] <= $right[1]); |
|
1662
|
|
|
default: |
|
1663
|
|
|
throw new GeneralException('parse error: unknown number operator: ' . $op); |
|
1664
|
|
|
} |
|
1665
|
|
|
|
|
1666
|
49 |
|
return ['number', $value, $unit]; |
|
1667
|
49 |
|
} |
|
1668
|
49 |
|
|
|
1669
|
49 |
|
/** |
|
1670
|
49 |
|
* @param $type |
|
1671
|
49 |
|
* @param null $selectors |
|
1672
|
|
|
* |
|
1673
|
49 |
|
* @return \stdClass |
|
1674
|
|
|
*/ |
|
1675
|
|
|
protected function makeOutputBlock($type, $selectors = null) |
|
1676
|
|
|
{ |
|
1677
|
|
|
$b = new \stdClass(); |
|
1678
|
|
|
$b->lines = []; |
|
1679
|
|
|
$b->children = []; |
|
1680
|
|
|
$b->selectors = $selectors; |
|
1681
|
|
|
$b->type = $type; |
|
1682
|
|
|
$b->parent = $this->scope; |
|
1683
|
|
|
|
|
1684
|
49 |
|
return $b; |
|
1685
|
49 |
|
} |
|
1686
|
49 |
|
|
|
1687
|
49 |
|
/** |
|
1688
|
|
|
* @param \LesserPhp\NodeEnv $parent |
|
1689
|
49 |
|
* @param Block|null $block |
|
1690
|
|
|
* |
|
1691
|
49 |
|
* @return \LesserPhp\NodeEnv |
|
1692
|
|
|
*/ |
|
1693
|
|
|
protected function pushEnv($parent, Block $block = null) |
|
1694
|
|
|
{ |
|
1695
|
|
|
$e = new NodeEnv(); |
|
1696
|
|
|
$e->setParent($parent); |
|
1697
|
|
|
$e->setBlock($block); |
|
|
|
|
|
|
1698
|
|
|
$e->setStore([]); |
|
1699
|
|
|
|
|
1700
|
|
|
$this->env = $e; |
|
1701
|
40 |
|
|
|
1702
|
40 |
|
return $e; |
|
1703
|
|
|
} |
|
1704
|
40 |
|
|
|
1705
|
|
|
/** |
|
1706
|
|
|
* pop something off the stack |
|
1707
|
|
|
* |
|
1708
|
|
|
* @return \LesserPhp\NodeEnv |
|
1709
|
|
|
*/ |
|
1710
|
|
|
protected function popEnv() |
|
1711
|
|
|
{ |
|
1712
|
|
|
$old = $this->env; |
|
1713
|
|
|
$this->env = $this->env->getParent(); |
|
1714
|
|
|
|
|
1715
|
27 |
|
return $old; |
|
1716
|
27 |
|
} |
|
1717
|
|
|
|
|
1718
|
|
|
/** |
|
1719
|
|
|
* set something in the current env |
|
1720
|
|
|
* |
|
1721
|
|
|
* @param $name |
|
1722
|
|
|
* @param $value |
|
1723
|
|
|
*/ |
|
1724
|
|
|
protected function set($name, $value) |
|
1725
|
|
|
{ |
|
1726
|
|
|
$this->env->addStore($name, $value); |
|
1727
|
|
|
} |
|
1728
|
28 |
|
|
|
1729
|
|
|
/** |
|
1730
|
|
|
* get the highest occurrence entry for a name |
|
1731
|
28 |
|
* |
|
1732
|
|
|
* @param $name |
|
1733
|
28 |
|
* |
|
1734
|
28 |
|
* @return array |
|
1735
|
28 |
|
* @throws \LesserPhp\Exception\GeneralException |
|
1736
|
3 |
|
*/ |
|
1737
|
|
|
protected function get($name) |
|
1738
|
|
|
{ |
|
1739
|
28 |
|
$current = $this->env; |
|
1740
|
27 |
|
|
|
1741
|
|
|
// track scope to evaluate |
|
1742
|
|
|
$scopeSecondary = []; |
|
1743
|
19 |
|
|
|
1744
|
|
|
$isArguments = $name === $this->vPrefix . 'arguments'; |
|
1745
|
|
|
while ($current) { |
|
1746
|
|
|
if ($isArguments && count($current->getArguments()) > 0) { |
|
1747
|
19 |
|
return ['list', ' ', $current->getArguments()]; |
|
1748
|
19 |
|
} |
|
1749
|
|
|
|
|
1750
|
1 |
|
if (isset($current->getStore()[$name])) { |
|
1751
|
|
|
return $current->getStore()[$name]; |
|
1752
|
|
|
} |
|
1753
|
|
|
// has secondary scope? |
|
1754
|
1 |
|
if (isset($current->storeParent)) { |
|
1755
|
|
|
$scopeSecondary[] = $current->storeParent; |
|
|
|
|
|
|
1756
|
|
|
} |
|
1757
|
|
|
|
|
1758
|
|
|
if ($current->getParent() !== null) { |
|
1759
|
|
|
$current = $current->getParent(); |
|
1760
|
|
|
} else { |
|
1761
|
|
|
$current = null; |
|
1762
|
|
|
} |
|
1763
|
|
|
} |
|
1764
|
|
|
|
|
1765
|
|
|
while (count($scopeSecondary)) { |
|
1766
|
|
|
// pop one off |
|
1767
|
|
|
$current = array_shift($scopeSecondary); |
|
1768
|
|
|
while ($current) { |
|
1769
|
|
|
if ($isArguments && isset($current->arguments)) { |
|
1770
|
|
|
return ['list', ' ', $current->arguments]; |
|
1771
|
|
|
} |
|
1772
|
|
|
|
|
1773
|
|
|
if (isset($current->store[$name])) { |
|
1774
|
|
|
return $current->store[$name]; |
|
1775
|
|
|
} |
|
1776
|
|
|
|
|
1777
|
|
|
// has secondary scope? |
|
1778
|
|
|
if (isset($current->storeParent)) { |
|
1779
|
1 |
|
$scopeSecondary[] = $current->storeParent; |
|
1780
|
|
|
} |
|
1781
|
|
|
|
|
1782
|
|
|
if (isset($current->parent)) { |
|
1783
|
|
|
$current = $current->parent; |
|
1784
|
|
|
} else { |
|
1785
|
|
|
$current = null; |
|
1786
|
|
|
} |
|
1787
|
|
|
} |
|
1788
|
|
|
} |
|
1789
|
|
|
|
|
1790
|
|
|
throw new GeneralException("variable $name is undefined"); |
|
1791
|
1 |
|
} |
|
1792
|
1 |
|
|
|
1793
|
1 |
|
/** |
|
1794
|
1 |
|
* inject array of unparsed strings into environment as variables |
|
1795
|
1 |
|
* |
|
1796
|
|
|
* @param string[] $args |
|
1797
|
1 |
|
* |
|
1798
|
1 |
|
* @throws \LesserPhp\Exception\GeneralException |
|
1799
|
1 |
|
*/ |
|
1800
|
|
|
protected function injectVariables(array $args) |
|
1801
|
|
|
{ |
|
1802
|
|
|
$this->pushEnv($this->env); |
|
1803
|
1 |
|
$parser = new Parser($this, __METHOD__); |
|
1804
|
|
|
foreach ($args as $name => $strValue) { |
|
1805
|
1 |
|
if ($name{0} !== '@') { |
|
1806
|
|
|
$name = '@' . $name; |
|
1807
|
|
|
} |
|
1808
|
|
|
$parser->count = 0; |
|
1809
|
|
|
$parser->buffer = (string) $strValue; |
|
1810
|
|
|
if (!$parser->propertyValue($value)) { |
|
1811
|
|
|
throw new GeneralException("failed to parse passed in variable $name: $strValue"); |
|
1812
|
|
|
} |
|
1813
|
|
|
|
|
1814
|
|
|
$this->set($name, $value); |
|
1815
|
|
|
} |
|
1816
|
49 |
|
} |
|
1817
|
49 |
|
|
|
1818
|
|
|
/** |
|
1819
|
49 |
|
* @param string $string |
|
1820
|
49 |
|
* @param string $name |
|
1821
|
|
|
* |
|
1822
|
49 |
|
* @return string |
|
1823
|
49 |
|
* @throws \LesserPhp\Exception\GeneralException |
|
1824
|
49 |
|
*/ |
|
1825
|
|
|
public function compile($string, $name = null) |
|
1826
|
49 |
|
{ |
|
1827
|
|
|
$locale = setlocale(LC_NUMERIC, 0); |
|
1828
|
49 |
|
setlocale(LC_NUMERIC, 'C'); |
|
1829
|
1 |
|
|
|
1830
|
|
|
$this->parser = $this->makeParser($name); |
|
1831
|
|
|
$root = $this->parser->parse($string); |
|
1832
|
49 |
|
|
|
1833
|
49 |
|
$this->env = null; |
|
1834
|
|
|
$this->scope = null; |
|
1835
|
38 |
|
$this->allParsedFiles = []; |
|
1836
|
38 |
|
|
|
1837
|
38 |
|
$this->formatter = $this->newFormatter(); |
|
1838
|
38 |
|
|
|
1839
|
|
|
if (!empty($this->registeredVars)) { |
|
1840
|
38 |
|
$this->injectVariables($this->registeredVars); |
|
1841
|
|
|
} |
|
1842
|
|
|
|
|
1843
|
|
|
$this->sourceParser = $this->parser; // used for error messages |
|
1844
|
|
|
$this->compileBlock($root); |
|
1845
|
|
|
|
|
1846
|
|
|
ob_start(); |
|
1847
|
|
|
$this->formatter->block($this->scope); |
|
1848
|
|
|
$out = ob_get_clean(); |
|
1849
|
|
|
setlocale(LC_NUMERIC, $locale); |
|
1850
|
|
|
|
|
1851
|
|
|
return $out; |
|
1852
|
1 |
|
} |
|
1853
|
|
|
|
|
1854
|
|
|
/** |
|
1855
|
|
|
* @param string $fname |
|
1856
|
1 |
|
* @param string $outFname |
|
1857
|
|
|
* |
|
1858
|
1 |
|
* @return int|string |
|
1859
|
|
|
* @throws \LesserPhp\Exception\GeneralException |
|
1860
|
1 |
|
*/ |
|
1861
|
|
|
public function compileFile($fname, $outFname = null) |
|
1862
|
1 |
|
{ |
|
1863
|
|
|
if (!is_readable($fname)) { |
|
1864
|
1 |
|
throw new GeneralException('load error: failed to find ' . $fname); |
|
1865
|
|
|
} |
|
1866
|
1 |
|
|
|
1867
|
|
|
$pi = pathinfo($fname); |
|
1868
|
1 |
|
|
|
1869
|
|
|
$oldImport = $this->importDirs; |
|
1870
|
|
|
|
|
1871
|
|
|
$this->importDirs[] = $pi['dirname'] . '/'; |
|
1872
|
1 |
|
|
|
1873
|
|
|
$this->addParsedFile($fname); |
|
1874
|
|
|
|
|
1875
|
|
|
$out = $this->compile(file_get_contents($fname), $fname); |
|
1876
|
|
|
|
|
1877
|
|
|
$this->importDirs = $oldImport; |
|
1878
|
|
|
|
|
1879
|
|
|
if ($outFname !== null) { |
|
1880
|
|
|
return file_put_contents($outFname, $out); |
|
1881
|
|
|
} |
|
1882
|
|
|
|
|
1883
|
|
|
return $out; |
|
1884
|
|
|
} |
|
1885
|
|
|
|
|
1886
|
|
|
/** |
|
1887
|
1 |
|
* Based on explicit input/output files does a full change check on cache before compiling. |
|
1888
|
|
|
* |
|
1889
|
|
|
* @param string $in |
|
1890
|
1 |
|
* @param string $out |
|
1891
|
|
|
* @param boolean $force |
|
1892
|
|
|
* |
|
1893
|
|
|
* @return string Compiled CSS results |
|
1894
|
1 |
|
* @throws GeneralException |
|
1895
|
1 |
|
*/ |
|
1896
|
1 |
|
public function checkedCachedCompile($in, $out, $force = false) |
|
1897
|
|
|
{ |
|
1898
|
|
|
if (!is_file($in) || !is_readable($in)) { |
|
1899
|
|
|
throw new GeneralException('Invalid or unreadable input file specified.'); |
|
1900
|
1 |
|
} |
|
1901
|
|
|
if (is_dir($out) || !is_writable(file_exists($out) ? $out : dirname($out))) { |
|
1902
|
1 |
|
throw new GeneralException('Invalid or unwritable output file specified.'); |
|
1903
|
1 |
|
} |
|
1904
|
1 |
|
|
|
1905
|
1 |
|
$outMeta = $out . '.meta'; |
|
1906
|
1 |
|
$metadata = null; |
|
1907
|
|
|
if (!$force && is_file($outMeta)) { |
|
1908
|
|
|
$metadata = unserialize(file_get_contents($outMeta)); |
|
1909
|
|
|
} |
|
1910
|
|
|
|
|
1911
|
1 |
|
$output = $this->cachedCompile($metadata ?: $in); |
|
1912
|
|
|
|
|
1913
|
|
|
if (!$metadata || $metadata['updated'] != $output['updated']) { |
|
1914
|
|
|
$css = $output['compiled']; |
|
1915
|
|
|
unset($output['compiled']); |
|
1916
|
|
|
file_put_contents($out, $css); |
|
1917
|
|
|
file_put_contents($outMeta, serialize($output)); |
|
1918
|
|
|
} else { |
|
1919
|
|
|
$css = file_get_contents($out); |
|
1920
|
|
|
} |
|
1921
|
|
|
|
|
1922
|
|
|
return $css; |
|
1923
|
|
|
} |
|
1924
|
|
|
|
|
1925
|
|
|
/** |
|
1926
|
|
|
* compile only if changed input has changed or output doesn't exist |
|
1927
|
|
|
* |
|
1928
|
|
|
* @param string $in |
|
1929
|
|
|
* @param string $out |
|
1930
|
|
|
* |
|
1931
|
|
|
* @return bool |
|
1932
|
|
|
* @throws \LesserPhp\Exception\GeneralException |
|
1933
|
|
|
*/ |
|
1934
|
|
|
public function checkedCompile($in, $out) |
|
1935
|
|
|
{ |
|
1936
|
|
|
if (!is_file($out) || filemtime($in) > filemtime($out)) { |
|
1937
|
|
|
$this->compileFile($in, $out); |
|
1938
|
|
|
|
|
1939
|
|
|
return true; |
|
1940
|
|
|
} |
|
1941
|
|
|
|
|
1942
|
|
|
return false; |
|
1943
|
|
|
} |
|
1944
|
|
|
|
|
1945
|
|
|
/** |
|
1946
|
|
|
* Execute lessphp on a .less file or a lessphp cache structure |
|
1947
|
|
|
* |
|
1948
|
|
|
* The lessphp cache structure contains information about a specific |
|
1949
|
|
|
* less file having been parsed. It can be used as a hint for future |
|
1950
|
|
|
* calls to determine whether or not a rebuild is required. |
|
1951
|
|
|
* |
|
1952
|
|
|
* The cache structure contains two important keys that may be used |
|
1953
|
|
|
* externally: |
|
1954
|
|
|
* |
|
1955
|
|
|
* compiled: The final compiled CSS |
|
1956
|
|
|
* updated: The time (in seconds) the CSS was last compiled |
|
1957
|
|
|
* |
|
1958
|
|
|
* The cache structure is a plain-ol' PHP associative array and can |
|
1959
|
1 |
|
* be serialized and unserialized without a hitch. |
|
1960
|
|
|
* |
|
1961
|
1 |
|
* @param mixed $in Input |
|
1962
|
1 |
|
* @param bool $force Force rebuild? |
|
1963
|
|
|
* |
|
1964
|
|
|
* @return array lessphp cache structure |
|
1965
|
|
|
* @throws \LesserPhp\Exception\GeneralException |
|
1966
|
|
|
*/ |
|
1967
|
|
|
public function cachedCompile($in, $force = false) |
|
1968
|
|
|
{ |
|
1969
|
|
|
// assume no root |
|
1970
|
|
|
$root = null; |
|
1971
|
|
|
|
|
1972
|
|
|
if (is_string($in)) { |
|
1973
|
|
|
$root = $in; |
|
1974
|
|
|
} elseif (is_array($in) && isset($in['root'])) { |
|
1975
|
|
|
if ($force || !isset($in['files'])) { |
|
1976
|
|
|
// If we are forcing a recompile or if for some reason the |
|
1977
|
|
|
// structure does not contain any file information we should |
|
1978
|
|
|
// specify the root to trigger a rebuild. |
|
1979
|
|
|
$root = $in['root']; |
|
1980
|
|
|
} elseif (isset($in['files']) && is_array($in['files'])) { |
|
1981
|
|
|
foreach ($in['files'] as $fname => $ftime) { |
|
1982
|
|
|
if (!file_exists($fname) || filemtime($fname) > $ftime) { |
|
1983
|
|
|
// One of the files we knew about previously has changed |
|
1984
|
|
|
// so we should look at our incoming root again. |
|
1985
|
1 |
|
$root = $in['root']; |
|
1986
|
|
|
break; |
|
1987
|
1 |
|
} |
|
1988
|
1 |
|
} |
|
1989
|
1 |
|
} |
|
1990
|
1 |
|
} else { |
|
1991
|
1 |
|
// TODO: Throw an exception? We got neither a string nor something |
|
1992
|
|
|
// that looks like a compatible lessphp cache structure. |
|
1993
|
1 |
|
return null; |
|
1994
|
|
|
} |
|
1995
|
|
|
|
|
1996
|
|
|
if ($root !== null) { |
|
1997
|
|
|
// If we have a root value which means we should rebuild. |
|
1998
|
|
|
$out = []; |
|
1999
|
|
|
$out['root'] = $root; |
|
2000
|
|
|
$out['compiled'] = $this->compileFile($root); |
|
2001
|
|
|
$out['files'] = $this->allParsedFiles; |
|
2002
|
|
|
$out['updated'] = time(); |
|
2003
|
|
|
|
|
2004
|
|
|
return $out; |
|
2005
|
|
|
} else { |
|
2006
|
|
|
// No changes, pass back the structure |
|
2007
|
|
|
// we were given initially. |
|
2008
|
|
|
return $in; |
|
2009
|
|
|
} |
|
2010
|
|
|
} |
|
2011
|
|
|
|
|
2012
|
|
|
/** |
|
2013
|
|
|
* parse and compile buffer |
|
2014
|
37 |
|
* This is deprecated |
|
2015
|
|
|
* |
|
2016
|
|
|
* @param null $str |
|
2017
|
|
|
* @param null $initialVariables |
|
2018
|
|
|
* |
|
2019
|
37 |
|
* @return int|string |
|
2020
|
37 |
|
* @throws \LesserPhp\Exception\GeneralException |
|
2021
|
1 |
|
* @deprecated |
|
2022
|
|
|
*/ |
|
2023
|
|
|
public function parse($str = null, $initialVariables = null) |
|
2024
|
37 |
|
{ |
|
2025
|
|
|
if (is_array($str)) { |
|
2026
|
|
|
$initialVariables = $str; |
|
2027
|
37 |
|
$str = null; |
|
2028
|
|
|
} |
|
2029
|
|
|
|
|
2030
|
37 |
|
$oldVars = $this->registeredVars; |
|
2031
|
|
|
if ($initialVariables !== null) { |
|
2032
|
37 |
|
$this->setVariables($initialVariables); |
|
2033
|
|
|
} |
|
2034
|
|
|
|
|
2035
|
|
|
if ($str === null) { |
|
2036
|
|
|
throw new GeneralException('nothing to parse'); |
|
2037
|
|
|
} else { |
|
2038
|
|
|
$out = $this->compile($str); |
|
2039
|
|
|
} |
|
2040
|
|
|
|
|
2041
|
|
|
$this->registeredVars = $oldVars; |
|
2042
|
49 |
|
|
|
2043
|
49 |
|
return $out; |
|
2044
|
|
|
} |
|
2045
|
49 |
|
|
|
2046
|
|
|
/** |
|
2047
|
|
|
* @param string $name |
|
2048
|
|
|
* |
|
2049
|
|
|
* @return \LesserPhp\Parser |
|
2050
|
|
|
*/ |
|
2051
|
|
|
protected function makeParser($name) |
|
2052
|
|
|
{ |
|
2053
|
1 |
|
$parser = new Parser($this, $name); |
|
2054
|
1 |
|
$parser->setWriteComments($this->preserveComments); |
|
2055
|
|
|
|
|
2056
|
|
|
return $parser; |
|
2057
|
|
|
} |
|
2058
|
14 |
|
|
|
2059
|
14 |
|
/** |
|
2060
|
|
|
* @param string $name |
|
2061
|
|
|
*/ |
|
2062
|
|
|
public function setFormatter($name) |
|
2063
|
|
|
{ |
|
2064
|
|
|
$this->formatterName = $name; |
|
2065
|
|
|
} |
|
2066
|
49 |
|
|
|
2067
|
49 |
|
public function setFormatterClass($formatter) |
|
2068
|
1 |
|
{ |
|
2069
|
|
|
$this->formatter = $formatter; |
|
2070
|
|
|
} |
|
2071
|
1 |
|
|
|
2072
|
|
|
/** |
|
2073
|
|
|
* @return \LesserPhp\Formatter\FormatterInterface |
|
2074
|
49 |
|
*/ |
|
2075
|
|
|
protected function newFormatter() |
|
2076
|
49 |
|
{ |
|
2077
|
|
|
$className = 'Lessjs'; |
|
2078
|
|
|
if (!empty($this->formatterName)) { |
|
2079
|
|
|
if (!is_string($this->formatterName)) { |
|
2080
|
|
|
return $this->formatterName; |
|
2081
|
|
|
} |
|
2082
|
|
|
$className = $this->formatterName; |
|
2083
|
|
|
} |
|
2084
|
1 |
|
|
|
2085
|
1 |
|
$className = '\LesserPhp\Formatter\\' . $className; |
|
2086
|
|
|
|
|
2087
|
|
|
return new $className; |
|
2088
|
|
|
} |
|
2089
|
|
|
|
|
2090
|
|
|
/** |
|
2091
|
|
|
* @param bool $preserve |
|
2092
|
|
|
*/ |
|
2093
|
1 |
|
public function setPreserveComments($preserve) |
|
2094
|
1 |
|
{ |
|
2095
|
|
|
$this->preserveComments = $preserve; |
|
2096
|
|
|
} |
|
2097
|
|
|
|
|
2098
|
|
|
/** |
|
2099
|
|
|
* @param string $name |
|
2100
|
|
|
* @param callable $func |
|
2101
|
1 |
|
*/ |
|
2102
|
1 |
|
public function registerFunction($name, callable $func) |
|
2103
|
|
|
{ |
|
2104
|
|
|
$this->libFunctions[$name] = $func; |
|
2105
|
|
|
} |
|
2106
|
|
|
|
|
2107
|
|
|
/** |
|
2108
|
|
|
* @param string $name |
|
2109
|
1 |
|
*/ |
|
2110
|
1 |
|
public function unregisterFunction($name) |
|
2111
|
|
|
{ |
|
2112
|
|
|
unset($this->libFunctions[$name]); |
|
2113
|
|
|
} |
|
2114
|
|
|
|
|
2115
|
|
|
/** |
|
2116
|
|
|
* @param array $variables |
|
2117
|
|
|
*/ |
|
2118
|
|
|
public function setVariables(array $variables) |
|
2119
|
|
|
{ |
|
2120
|
|
|
$this->registeredVars = array_merge($this->registeredVars, $variables); |
|
|
|
|
|
|
2121
|
|
|
} |
|
2122
|
|
|
|
|
2123
|
|
|
/** |
|
2124
|
|
|
* @param $name |
|
2125
|
38 |
|
*/ |
|
2126
|
38 |
|
public function unsetVariable($name) |
|
2127
|
|
|
{ |
|
2128
|
|
|
unset($this->registeredVars[$name]); |
|
2129
|
|
|
} |
|
2130
|
|
|
|
|
2131
|
|
|
/** |
|
2132
|
|
|
* @param string[] $dirs |
|
2133
|
|
|
*/ |
|
2134
|
|
|
public function setImportDirs(array $dirs) |
|
2135
|
|
|
{ |
|
2136
|
|
|
$this->importDirs = $dirs; |
|
2137
|
|
|
} |
|
2138
|
|
|
|
|
2139
|
|
|
/** |
|
2140
|
|
|
* @param string $dir |
|
2141
|
4 |
|
*/ |
|
2142
|
|
|
public function addImportDir($dir) |
|
2143
|
|
|
{ |
|
2144
|
|
|
$this->importDirs[] = $dir; |
|
2145
|
|
|
} |
|
2146
|
|
|
|
|
2147
|
|
|
/** |
|
2148
|
|
|
* @return string[] |
|
2149
|
2 |
|
*/ |
|
2150
|
2 |
|
public function getImportDirs() |
|
2151
|
|
|
{ |
|
2152
|
|
|
return $this->importDirs; |
|
2153
|
|
|
} |
|
2154
|
|
|
|
|
2155
|
|
|
/** |
|
2156
|
|
|
* @param string $file |
|
2157
|
|
|
*/ |
|
2158
|
|
|
public function addParsedFile($file) |
|
2159
|
|
|
{ |
|
2160
|
|
|
$this->allParsedFiles[realpath($file)] = filemtime($file); |
|
2161
|
|
|
} |
|
2162
|
|
|
|
|
2163
|
|
|
/** |
|
2164
|
|
|
* Uses the current value of $this->count to show line and line number |
|
2165
|
|
|
* |
|
2166
|
|
|
* @param string $msg |
|
2167
|
|
|
* |
|
2168
|
|
|
* @throws GeneralException |
|
2169
|
|
|
*/ |
|
2170
|
|
|
public function throwError($msg = null) |
|
2171
|
|
|
{ |
|
2172
|
|
|
if ($this->sourceLoc >= 0) { |
|
2173
|
|
|
$this->sourceParser->throwError($msg, $this->sourceLoc); |
|
2174
|
|
|
} |
|
2175
|
|
|
throw new GeneralException($msg); |
|
2176
|
|
|
} |
|
2177
|
|
|
|
|
2178
|
|
|
/** |
|
2179
|
|
|
* compile file $in to file $out if $in is newer than $out |
|
2180
|
|
|
* returns true when it compiles, false otherwise |
|
2181
|
|
|
* |
|
2182
|
|
|
* @param $in |
|
2183
|
|
|
* @param $out |
|
2184
|
|
|
* @param \LesserPhp\Compiler|null $less |
|
2185
|
|
|
* |
|
2186
|
|
|
* @return bool |
|
2187
|
|
|
* @throws \LesserPhp\Exception\GeneralException |
|
2188
|
|
|
*/ |
|
2189
|
|
|
public static function ccompile($in, $out, Compiler $less = null) |
|
2190
|
|
|
{ |
|
2191
|
|
|
if ($less === null) { |
|
2192
|
|
|
$less = new self; |
|
2193
|
|
|
} |
|
2194
|
|
|
|
|
2195
|
|
|
return $less->checkedCompile($in, $out); |
|
2196
|
|
|
} |
|
2197
|
|
|
|
|
2198
|
|
|
/** |
|
2199
|
|
|
* @param $in |
|
2200
|
|
|
* @param bool $force |
|
2201
|
|
|
* @param \LesserPhp\Compiler|null $less |
|
2202
|
|
|
* |
|
2203
|
|
|
* @return array |
|
2204
|
|
|
* @throws \LesserPhp\Exception\GeneralException |
|
2205
|
|
|
*/ |
|
2206
|
|
|
public static function cexecute($in, $force = false, Compiler $less = null) |
|
2207
|
|
|
{ |
|
2208
|
|
|
if ($less === null) { |
|
2209
|
|
|
$less = new self; |
|
2210
|
|
|
} |
|
2211
|
49 |
|
|
|
2212
|
|
|
return $less->cachedCompile($in, $force); |
|
2213
|
|
|
} |
|
2214
|
|
|
|
|
2215
|
|
|
/** |
|
2216
|
|
|
* Import Css |
|
2217
|
|
|
* |
|
2218
|
|
|
* Set allowing importing (and not compiling) |
|
2219
|
|
|
* |
|
2220
|
|
|
* @param bool $true (optional) Default, allow CSS. |
|
2221
|
46 |
|
* |
|
2222
|
|
|
* @return void |
|
2223
|
|
|
* |
|
2224
|
|
|
* @access public |
|
2225
|
|
|
* |
|
2226
|
|
|
* @author Michael Mulligan <[email protected]> |
|
2227
|
|
|
*/ |
|
2228
|
|
|
public function importCss($true = null) |
|
2229
|
3 |
|
{ |
|
2230
|
|
|
if ($true === null) { |
|
2231
|
|
|
return $this->import_css; |
|
2232
|
|
|
} else { |
|
2233
|
|
|
$this->import_css = (bool) $true; |
|
2234
|
|
|
} |
|
2235
|
|
|
} |
|
2236
|
|
|
|
|
2237
|
|
|
/** |
|
2238
|
|
|
* prefix of abstract properties |
|
2239
|
|
|
* |
|
2240
|
|
|
* @return string |
|
2241
|
|
|
*/ |
|
2242
|
|
|
public function getVPrefix() |
|
2243
|
|
|
{ |
|
2244
|
|
|
return $this->vPrefix; |
|
2245
|
|
|
} |
|
2246
|
|
|
|
|
2247
|
|
|
/** |
|
2248
|
|
|
* prefix of abstract blocks |
|
2249
|
|
|
* |
|
2250
|
1 |
|
* @return string |
|
2251
|
1 |
|
*/ |
|
2252
|
|
|
public function getMPrefix() |
|
2253
|
|
|
{ |
|
2254
|
|
|
return $this->mPrefix; |
|
2255
|
|
|
} |
|
2256
|
|
|
|
|
2257
|
|
|
/** |
|
2258
|
3 |
|
* @return string |
|
2259
|
|
|
*/ |
|
2260
|
1 |
|
public function getParentSelector() |
|
2261
|
|
|
{ |
|
2262
|
|
|
return $this->parentSelector; |
|
2263
|
|
|
} |
|
2264
|
|
|
|
|
2265
|
|
|
/** |
|
2266
|
|
|
* @param int $numberPresicion |
|
2267
|
|
|
*/ |
|
2268
|
|
|
protected function setNumberPrecision($numberPresicion = null) |
|
2269
|
|
|
{ |
|
2270
|
|
|
$this->numberPrecision = $numberPresicion; |
|
2271
|
|
|
} |
|
2272
|
|
|
|
|
2273
|
|
|
/** |
|
2274
|
|
|
* @return \LesserPhp\Library\Coerce |
|
2275
|
|
|
*/ |
|
2276
|
|
|
protected function getCoerce() |
|
2277
|
|
|
{ |
|
2278
|
|
|
return $this->coerce; |
|
2279
|
|
|
} |
|
2280
|
|
|
|
|
2281
|
|
|
public function setImportDisabled() |
|
2282
|
|
|
{ |
|
2283
|
|
|
$this->importDisabled = true; |
|
2284
|
|
|
} |
|
2285
|
|
|
|
|
2286
|
|
|
/** |
|
2287
|
|
|
* @return bool |
|
2288
|
|
|
*/ |
|
2289
|
|
|
public function isImportDisabled() |
|
2290
|
|
|
{ |
|
2291
|
|
|
return $this->importDisabled; |
|
2292
|
|
|
} |
|
2293
|
|
|
} |
|
2294
|
|
|
|