MarcusSchwarz / lesserphp

src/LesserPhp/Compiler.php

Doc Comments +20 added lines, -1 removed lines

@@ -181,7 +181,7 @@ 
     /**
      * attempts to find the path of an import url, returns null for css files
      *
-     * @param $url
+     * @param string $url
      *
      * @return null|string
      */
@@ -197,6 +197,9 @@ 
         return null;
     }
 
+    /**
+     * @param string $name
+     */
     protected function fileExists($name)
     {
         return is_file($name);
@@ -398,6 +401,9 @@ 
         return $scope;
     }
 
+    /**
+     * @param string[] $selectors
+     */
     protected function compileNestedBlock($block, $selectors)
     {
         $this->pushEnv($this->env, $block);
@@ -418,6 +424,9 @@ 
         $this->popEnv();
     }
 
+    /**
+     * @param \stdClass $out
+     */
     protected function compileProps($block, $out)
     {
         foreach ($this->sortProps($block->props) as $prop) {
@@ -1349,6 +1358,9 @@ 
         return $value;
     }
 
+    /**
+     * @param boolean $a
+     */
     public function toBool($a)
     {
         if ($a) {
@@ -1565,6 +1577,10 @@ 
     }
 
     // the state of execution
+
+    /**
+     * @param NodeEnv $parent
+     */
     protected function pushEnv($parent, $block = null)
     {
         $e = new \LesserPhp\NodeEnv();
@@ -1875,6 +1891,9 @@ 
         return $out;
     }
 
+    /**
+     * @param string|null $name
+     */
     protected function makeParser($name)
     {
         $parser = new \LesserPhp\Parser($this, $name);

Spacing +8 added lines, -9 removed lines

@@ -882,7 +882,7 @@ 
 
                 $orderedArgs = [];
                 $keywordArgs = [];
-                foreach ((array)$args as $arg) {
+                foreach ((array) $args as $arg) {
                     switch ($arg[0]) {
                         case "arg":
                             if (!isset($arg[2])) {
@@ -979,8 +979,7 @@ 
                 $result = $this->tryImport($importPath, $block, $out);
 
                 $this->env->addImports($importId, $result === false ?
-                    [false, "@import " . $this->compileValue($importPath) . ";"] :
-                    $result);
+                    [false, "@import " . $this->compileValue($importPath) . ";"] : $result);
 
                 break;
             case "import_mixin":
@@ -1102,7 +1101,7 @@ 
         }
         list($color, $delta) = $args[2];
         $color = $this->assertions->assertColor($color);
-        $delta = (float)$delta[1];
+        $delta = (float) $delta[1];
 
         return [$color, $delta];
     }
@@ -1129,7 +1128,7 @@ 
             $i = 0;
             foreach ($rawComponents as $c) {
                 $val = $this->reduce($c);
-                $val = isset($val[1]) ? (float)$val[1] : 0;
+                $val = isset($val[1]) ? (float) $val[1] : 0;
 
                 if ($i === 0) {
                     $clamp = 360;
@@ -1158,13 +1157,13 @@ 
                     if ($c[0] === "number" && $c[2] === "%") {
                         $components[] = 255 * ($c[1] / 100);
                     } else {
-                        $components[] = (float)$c[1];
+                        $components[] = (float) $c[1];
                     }
                 } elseif ($i === 4) {
                     if ($c[0] === "number" && $c[2] === "%") {
                         $components[] = 1.0 * ($c[1] / 100);
                     } else {
-                        $components[] = (float)$c[1];
+                        $components[] = (float) $c[1];
                     }
                 } else {
                     break;
@@ -1213,7 +1212,7 @@ 
                     $key = $this->vPrefix . $this->compileValue($this->functions->e($key));
                 }
 
-                $seen =& $this->env->seenNames;
+                $seen = & $this->env->seenNames;
 
                 if (!empty($seen[$key])) {
                     $this->throwError("infinite loop detected: $key");
@@ -1660,7 +1659,7 @@ 
                 $name = '@' . $name;
             }
             $parser->count = 0;
-            $parser->buffer = (string)$strValue;
+            $parser->buffer = (string) $strValue;
             if (!$parser->propertyValue($value)) {
                 throw new GeneralException("failed to parse passed in variable $name: $strValue");
             }

src/LesserPhp/Parser.php

Doc Comments +26 added lines

@@ -114,6 +114,9 @@ 
         }
     }
 
+    /**
+     * @param string $buffer
+     */
     public function parse($buffer)
     {
         $this->count = 0;
@@ -483,6 +486,7 @@ 
 
     /**
      * recursively parse infix equation with $lhs at precedence $minP
+     * @param integer $minP
      */
     protected function expHelper($lhs, $minP)
     {
@@ -775,6 +779,11 @@ 
     }
 
     // an unbounded string stopped by $end
+
+    /**
+     * @param string $end
+     * @param string[] $rejectStrs
+     */
     protected function openString($end, &$out, $nestingOpen = null, $rejectStrs = null)
     {
         $oldWhite = $this->eatWhiteDefault;
@@ -1429,6 +1438,9 @@ 
 
     /* raw parsing functions */
 
+    /**
+     * @param boolean $eatWhitespace
+     */
     protected function literal($what, $eatWhitespace = null)
     {
         if ($eatWhitespace === null) {
@@ -1456,6 +1468,9 @@ 
         return $this->match(self::$literalCache[$what], $m, $eatWhitespace);
     }
 
+    /**
+     * @param string $parseItem
+     */
     protected function genericList(&$out, $parseItem, $delim = "", $flatten = true)
     {
         $s = $this->seek();
@@ -1549,6 +1564,10 @@ 
     }
 
     // match something without consuming it
+
+    /**
+     * @param string $regex
+     */
     protected function peek($regex, &$out = null, $from = null)
     {
         if ($from === null) {
@@ -1572,6 +1591,9 @@ 
 
     /* misc functions */
 
+    /**
+     * @param integer $count
+     */
     public function throwError($msg = "parse error", $count = null)
     {
         $count = $count === null ? $this->count : $count;
@@ -1621,6 +1643,10 @@ 
     }
 
     // push a block that doesn't multiply tags
+
+    /**
+     * @param string $type
+     */
     protected function pushSpecialBlock($type)
     {
         return $this->pushBlock(null, $type);