tarsana / functional

build.php

Doc Comments -3 removed lines

@@ -634,8 +634,6 @@ 
  * Gets an element of the stream methods list.
  *
  * @signature String -> Block -> String
- * @param  string $moduleName
- * @param  object $block
  * @return string
  */
 function stream_method_link() {
@@ -661,7 +659,6 @@ 
  * Dump a variable and returns it.
  *
  * @signature a -> a
- * @param  mixed $something
  * @return mixed
  */
 function log() {

src/common.php

Doc Comments -4 removed lines

@@ -26,7 +26,6 @@ 
  * ```
  *
  * @signature * -> String
- * @param  mixed $data
  * @return string
  */
 function type() {
@@ -73,8 +72,6 @@ 
  *
  * @stream
  * @signature String -> * -> Boolean
- * @param  string $type
- * @param  mixed $data
  * @return boolean
  */
 function is() {
@@ -109,7 +106,6 @@ 
  *
  * @stream
  * @signature * -> String
- * @param  mixed $something
  * @return string
  */
 function toString () {

src/Internal/_stream.php

Doc Comments +1 added lines, -6 removed lines

@@ -40,7 +40,7 @@ 
  * Returns supported types in signatures.
  *
  * @signature List
- * @return array
+ * @return string[]
  */
 function _stream_types() {
     return [
@@ -126,7 +126,6 @@ 
  * @signature String -> String -> Maybe(Function) -> Operation
  * @param  string $name
  * @param  string $signature
- * @param  callable $fn
  * @return array
  */
 function _stream_operation($name, $signature, $callable = null) {
@@ -190,8 +189,6 @@ 
  * F\_stream_ensure_type('List -> Bar', 'Bar'); // throws "Stream: invalid signature 'List -> Bar' it should follow the syntax 'TypeArg1 -> TypeArg2 -> ... -> ReturnType' and types to use are Boolean, Number, String, Resource, Function, List, Array, Object, Any"
  * ```
  * @signature String -> String -> String
- * @param  string $signature
- * @param  string $type
  * @return string
  */
 function _stream_ensure_type() {
@@ -491,8 +488,6 @@ 
  * ```
  *
  * @signature [String] -> Operation -> Boolean
- * @param  array $argsTypes
- * @param  array $operation
  * @return bool
  */
 function _stream_operation_is_applicable() {

src/math.php

Doc Comments -23 removed lines

@@ -14,8 +14,6 @@ 
  *
  * @stream
  * @signature Number -> Number -> Number
- * @param  int|float $x
- * @param  int|float $y
  * @return int|float
  */
 function plus() {
@@ -35,8 +33,6 @@ 
  *
  * @stream
  * @signature Number -> Number -> Number
- * @param  int|float $x
- * @param  int|float $y
  * @return int|float
  */
 function minus() {
@@ -57,7 +53,6 @@ 
  *
  * @stream
  * @signature Number -> Number
- * @param  int|float $x
  * @return int|float
  */
 function negate() {
@@ -78,8 +73,6 @@ 
  *
  * @stream
  * @signature Number -> Number -> Number
- * @param  int|float $x
- * @param  int|float $y
  * @return int|float
  */
 function multiply() {
@@ -99,8 +92,6 @@ 
  *
  * @stream
  * @signature Number -> Number -> Number
- * @param  int|float $x
- * @param  int|float $y
  * @return int|float
  */
 function divide() {
@@ -120,8 +111,6 @@ 
  *
  * @stream
  * @signature Number -> Number -> Number
- * @param  int|float $x
- * @param  int|float $y
  * @return int|float
  */
 function modulo() {
@@ -142,7 +131,6 @@ 
  *
  * @stream
  * @signature [Number] -> Number
- * @param  array $numbers
  * @return int|float
  */
 function sum() {
@@ -163,7 +151,6 @@ 
  *
  * @stream
  * @signature [Number] -> Number
- * @param  array $numbers
  * @return int|float
  */
 function product() {
@@ -184,8 +171,6 @@ 
  *
  * @stream
  * @signature Number -> Number -> Number
- * @param  number $a
- * @param  number $b
  * @return number
  */
 function min() {
@@ -206,9 +191,6 @@ 
  *
  * @stream
  * @signature (a -> Number) -> a -> a -> a
- * @param  callable $fn
- * @param  mixed $a
- * @param  mixed $b
  * @return mixed
  */
 function minBy() {
@@ -229,8 +211,6 @@ 
  *
  * @stream
  * @signature Number -> Number -> Number
- * @param  number $a
- * @param  number $b
  * @return number
  */
 function max() {
@@ -251,9 +231,6 @@ 
  *
  * @stream
  * @signature (a -> Number) -> a -> a -> a
- * @param  callable $fn
- * @param  mixed $a
- * @param  mixed $b
  * @return mixed
  */
 function maxBy() {

src/string.php

Doc Comments -28 removed lines

@@ -14,8 +14,6 @@ 
  *
  * @stream
  * @signature String -> String -> [String]
- * @param string $delimiter
- * @param string $string
  * @return array
  */
 function split() {
@@ -34,8 +32,6 @@ 
  *
  * @stream
  * @signature String -> [String] -> String
- * @param string $glue
- * @param array $pieces
  * @return string
  */
 function join() {
@@ -59,9 +55,6 @@ 
  *
  * @stream
  * @signature String|[String] -> String|[String] -> String -> String
- * @param  string $search
- * @param  string $replacement
- * @param  string $string
  * @return string
  */
 function replace() {
@@ -81,9 +74,6 @@ 
  *
  * @stream
  * @signature String -> String -> String -> String
- * @param  string $pattern
- * @param  string $replacement
- * @param  string $string
  * @return string
  */
 function regReplace() {
@@ -101,7 +91,6 @@ 
  *
  * @stream
  * @signature String -> String
- * @param  string $string
  * @return string
  */
 function upperCase() {
@@ -119,7 +108,6 @@ 
  *
  * @stream
  * @signature String -> String
- * @param  string $string
  * @return string
  */
 function lowerCase() {
@@ -137,7 +125,6 @@ 
  *
  * @stream
  * @signature String -> String
- * @param  string $string
  * @return string
  */
 function camelCase() {
@@ -164,8 +151,6 @@ 
  *
  * @stream
  * @signature String -> String -> String
- * @param  string $delimiter
- * @param  string $string
  * @return string
  */
 function snakeCase() {
@@ -194,8 +179,6 @@ 
  *
  * @stream
  * @signature String -> String -> Boolean
- * @param  string $token
- * @param  string $string
  * @return bool
  */
 function startsWith() {
@@ -220,8 +203,6 @@ 
  *
  * @stream
  * @signature String -> String -> Boolean
- * @param  string $token
- * @param  string $string
  * @return bool
  */
 function endsWith() {
@@ -246,8 +227,6 @@ 
  *
  * @stream
  * @signature String -> String -> Boolean
- * @param  string $pattern
- * @param  string $string
  * @return bool
  */
 function test() {
@@ -270,8 +249,6 @@ 
  *
  * @stream
  * @signature String -> String -> [String]
- * @param  string $pattern
- * @param  string $string
  * @return array
  */
 function match() {
@@ -295,8 +272,6 @@ 
  *
  * @stream
  * @signature String -> String -> Number
- * @param  string $token
- * @param  string $text
  * @return int
  */
 function occurences() {
@@ -322,9 +297,6 @@ 
  *
  * @stream
  * @signature String -> String -> String -> [String]
- * @param  string $surrounders
- * @param  string $separator
- * @param  sring $text
  * @return array
  */
 function chunks() {

performance/run.php

Doc Comments +2 added lines, -2 removed lines

@@ -3,7 +3,7 @@ 
 /**
  * Returns the list of scripts to compare.
  *
- * @return array
+ * @return string[]
  */
 function scripts() {
     return [
@@ -101,7 +101,7 @@ 
  * and returns its running time in miliseconds.
  *
  * @param  string $path
- * @return array
+ * @return double
  */
 function execute($path, $input) {
     $start = microtime(true);

src/functions.php

Doc Comments -9 removed lines

@@ -82,8 +82,6 @@ 
  * ```
  *
  * @signature (*... -> a) -> [*] -> a
- * @param  callable $fn
- * @param  array    $args
  * @return mixed
  */
 function apply() {
@@ -107,7 +105,6 @@ 
  * ```
  *
  * @signature (((a, b, ...) -> o), (o -> p), ..., (y -> z)) -> ((a, b, ...) -> z)
- * @param  callable $fns...
  * @return callable
  */
 function pipe() {
@@ -138,7 +135,6 @@ 
  * ```
  *
  * @signature (((a, b, ...) -> o), (o -> p), ..., (y -> z)) -> ((a, b, ...) -> z)
- * @param  callable $fns...
  * @return callable
  */
 function compose() {
@@ -186,7 +182,6 @@ 
  * ```
  *
  * @signature a -> (* -> a)
- * @param  mixed $value
  * @return callable
  */
 function give() {
@@ -215,7 +210,6 @@ 
  * ```
  *
  * @signature ((a -> Boolean), ..., (a -> Boolean)) -> (a -> Boolean)
- * @param  callable $predicates...
  * @return callable
  */
 function all() {
@@ -249,7 +243,6 @@ 
  * ```
  *
  * @signature ((a -> Boolean), ..., (a -> Boolean)) -> (a -> Boolean)
- * @param  callable $predicates...
  * @return callable
  */
 function any() {
@@ -280,7 +273,6 @@ 
  * ```
  *
  * @signature (* -> ... -> *) -> (* -> ... -> Boolean)
- * @param  callable $fn
  * @return callable
  */
 function complement() {
@@ -313,7 +305,6 @@ 
  * ```
  *
  * @signature (a -> a -> Boolean) -> (a -> a -> Number)
- * @param  callable $fn
  * @return callable
  */
 function comparator() {

src/Internal/_functions.php

Doc Comments +4 added lines, -4 removed lines

@@ -88,7 +88,7 @@ 
  * @ignore
  * @signature (a -> b) -> (a -> b)
  * @param  callable $fn
- * @return callable
+ * @return \Closure
  */
 function _curry_one($fn) {
     return function() use($fn) {
@@ -113,7 +113,7 @@ 
  *
  * @signature (a,b -> c) -> (a -> b -> c)
  * @param  callable $fn
- * @return callable
+ * @return \Closure
  */
 function _curry_two($fn) {
     return function() use($fn) {
@@ -164,7 +164,7 @@ 
  *
  * @signature (a,b,c -> d) -> (a -> b -> c -> d)
  * @param  callable $fn
- * @return callable
+ * @return \Closure
  */
 function _curry_three($fn) {
     return function() use($fn) {
@@ -227,7 +227,7 @@ 
  * @param  callable $fn
  * @param  int $n
  * @param  array $given
- * @return callable
+ * @return \Closure
  */
 function _curry_n($fn, $n, $given = []) {
     return function() use($fn, $n, $given) {

src/list.php

Doc Comments -80 removed lines

@@ -15,8 +15,6 @@ 
  * @stream
  * @signature (a -> b) -> [a] -> [b]
  * @signature (a -> b) -> {k: a} -> {k: b}
- * @param  callable $fn
- * @param  array $list
  * @return array
  */
 function map() {
@@ -36,8 +34,6 @@ 
  *
  * @stream
  * @signature (a -> [b]) -> [a] -> [b]
- * @param  callable $fn
- * @param  array $list
  * @return array
  */
 function chain() {
@@ -63,8 +59,6 @@ 
  * ```
  * @stream
  * @signature (a -> Boolean) -> [a] -> [a]
- * @param  callable $fn
- * @param  array $list
  * @return array
  */
 function filter() {
@@ -92,9 +86,6 @@ 
  *
  * @stream
  * @signature (* -> a -> *) -> * -> [a] -> *
- * @param  callable $fn
- * @param  mixed $initial
- * @param  array $list
  * @return array
  */
 function reduce() {
@@ -120,8 +111,6 @@ 
  *
  * @stream
  * @signature (a -> *) -> [a] -> [a]
- * @param  callable $fn
- * @param  array $list
  * @return array
  */
 function each() {
@@ -148,7 +137,6 @@ 
  * @stream
  * @signature [a] -> a
  * @signature String -> String
- * @param  array|string $list
  * @return mixed
  */
 function head() {
@@ -173,7 +161,6 @@ 
  * @stream
  * @signature [a] -> a
  * @signature String -> String
- * @param  array|string $list
  * @return mixed
  */
 function last () {
@@ -203,7 +190,6 @@ 
  * @stream
  * @signature [a] -> a
  * @signature String -> String
- * @param  array|string $list
  * @return array
  */
 function init () {
@@ -237,7 +223,6 @@ 
  * @stream
  * @signature [a] -> a
  * @signature String -> String
- * @param  array|string $list
  * @return array
  */
 function tail () {
@@ -265,7 +250,6 @@ 
  * @stream
  * @signature [a] -> [a]
  * @signature String -> String
- * @param  array|string $list
  * @return array
  */
 function reverse () {
@@ -289,7 +273,6 @@ 
  * @stream
  * @signature [a] -> Number
  * @signature String -> Number
- * @param  array|string $list
  * @return int
  */
 function length() {
@@ -313,8 +296,6 @@ 
  *
  * @stream
  * @signature (a -> Boolean) -> [a] -> Boolean
- * @param  callable $predicate
- * @param  array $list
  * @return bool
  */
 function allSatisfies() {
@@ -340,8 +321,6 @@ 
  *
  * @stream
  * @signature (a -> Boolean) -> [a] -> Boolean
- * @param  callable $predicate
- * @param  array $list
  * @return bool
  */
 function anySatisfies() {
@@ -367,8 +346,6 @@ 
  * @stream
  * @signature [*] -> [*] -> [*]
  * @signature String -> String -> String
- * @param  array $list1
- * @param  array $list2
  * @return array
  */
 function concat() {
@@ -391,7 +368,6 @@ 
  *
  * @stream
  * @signature [[a]] -> [a]
- * @param  array $lists
  * @return array
  */
 function concatAll() {
@@ -426,9 +402,6 @@ 
  * @stream
  * @signature Number -> a -> [a] -> [a]
  * @signature Number -> String -> String -> String
- * @param  int $position
- * @param  mixed $item
- * @param  array $list
  * @return array
  */
 function insert() {
@@ -456,9 +429,6 @@ 
  * @stream
  * @signature Number -> [a] -> [a] -> [a]
  * @signature Number -> String -> String -> String
- * @param  int $position
- * @param  mixed $items
- * @param  array $list
  * @return array
  */
 function insertAll() {
@@ -491,8 +461,6 @@ 
  * @stream
  * @signature * -> [*] -> [*]
  * @signature String -> String -> String
- * @param  mixed $item
- * @param  array $list
  * @return array
  */
 function append() {
@@ -517,8 +485,6 @@ 
  * @stream
  * @signature a -> [a] -> [a]
  * @signature String -> String -> String
- * @param  mixed $item
- * @param  array $list
  * @return array
  */
 function prepend() {
@@ -548,8 +514,6 @@ 
  * @stream
  * @signature Number -> [a] -> [a]
  * @signature Number -> String -> String
- * @param  int $count
- * @param  array $list
  * @return array
  */
 function take() {
@@ -582,8 +546,6 @@ 
  *
  * @stream
  * @signature (a -> Boolean) -> [a] -> [a]
- * @param  callable $predicate
- * @param  array $list
  * @return array
  */
 function takeWhile() {
@@ -609,8 +571,6 @@ 
  *
  * @stream
  * @signature (a -> Boolean) -> [a] -> [a]
- * @param  callable $predicate
- * @param  array $list
  * @return array
  */
 function takeLastWhile() {
@@ -636,8 +596,6 @@ 
  *
  * @stream
  * @signature (a -> Boolean) -> [a] -> [a]
- * @param  callable $predicate
- * @param  array $list
  * @return array
  */
 function takeUntil() {
@@ -663,8 +621,6 @@ 
  *
  * @stream
  * @signature (a -> Boolean) -> [a] -> [a]
- * @param  callable $predicate
- * @param  array $list
  * @return array
  */
 function takeLastUntil() {
@@ -695,8 +651,6 @@ 
  * @stream
  * @signature Number -> [a] -> [a]
  * @signature Number -> String -> String
- * @param  int $count
- * @param  array $list
  * @return array
  */
 function remove() {
@@ -733,8 +687,6 @@ 
  *
  * @stream
  * @signature (a -> Boolean) -> [a] -> [a]
- * @param  callable $predicate
- * @param  array $list
  * @return array
  */
 function removeWhile() {
@@ -760,8 +712,6 @@ 
  *
  * @stream
  * @signature (a -> Boolean) -> [a] -> [a]
- * @param  callable $predicate
- * @param  array $list
  * @return array
  */
 function removeLastWhile() {
@@ -788,8 +738,6 @@ 
  *
  * @stream
  * @signature (a -> Boolean) -> [a] -> [a]
- * @param  callable $predicate
- * @param  array $list
  * @return array
  */
 function removeUntil() {
@@ -816,8 +764,6 @@ 
  *
  * @stream
  * @signature (a -> Boolean) -> [a] -> [a]
- * @param  callable $predicate
- * @param  array $list
  * @return array
  */
 function removeLastUntil() {
@@ -840,7 +786,6 @@ 
  *
  * @stream
  * @signature [(k, v)] -> {k: v}
- * @param  array $pairs
  * @return stdClass
  */
 function fromPairs() {
@@ -870,8 +815,6 @@ 
  * @stream
  * @signature Number -> [a] -> [[a]]
  * @signature Number -> String -> [String]
- * @param  int $size
- * @param  array $list
  * @return array
  */
 function slices() {
@@ -905,8 +848,6 @@ 
  * @stream
  * @signature a -> [a] -> Boolean
  * @signature String -> String -> Boolean
- * @param  mixed $item
- * @param  array|string $list
  * @return bool
  */
 function contains() {
@@ -932,8 +873,6 @@ 
  * @stream
  * @signature (a -> Boolean) -> [a] -> Maybe(Number)
  * @signature (v -> Boolean) -> {k: v} -> Maybe(k)
- * @param  callable $predicate
- * @param  array $list
  * @return mixed
  */
 function findIndex() {
@@ -961,8 +900,6 @@ 
  * @stream
  * @signature (a -> Boolean) -> [a] -> Maybe(Number)
  * @signature (v -> Boolean) -> {k: v} -> Maybe(k)
- * @param  callable $predicate
- * @param  array $list
  * @return mixed
  */
 function findLastIndex() {
@@ -991,8 +928,6 @@ 
  *
  * @stream
  * @signature (a -> Boolean) -> [a] -> Maybe(a)
- * @param  callable $predicate
- * @param  array $list
  * @return mixed
  */
 function find() {
@@ -1018,8 +953,6 @@ 
  *
  * @stream
  * @signature (a -> Boolean) -> [a] -> Maybe(a)
- * @param  callable $predicate
- * @param  array $list
  * @return mixed
  */
 function findLast() {
@@ -1057,8 +990,6 @@ 
  * @signature a -> [a] -> Number
  * @signature v -> {k: v} -> Maybe(k)
  * @signature String -> String -> Number
- * @param  mixed $item
- * @param  array $list
  * @return int
  */
 function indexOf() {
@@ -1097,8 +1028,6 @@ 
  * @signature a -> [a] -> Number
  * @signature v -> {k: v} -> Maybe(k)
  * @signature String -> String -> Number
- * @param  mixed $item
- * @param  array $list
  * @return int
  */
 function lastIndexOf() {
@@ -1132,8 +1061,6 @@ 
  *
  * @stream
  * @signature (a -> a -> Boolean) -> [a] -> [a]
- * @param  callable $areEqual
- * @param  array $list
  * @return array
  */
 function uniqueBy() {
@@ -1170,7 +1097,6 @@ 
  *
  * @stream
  * @signature [a] -> [a]
- * @param  array $list
  * @return array
  */
 function unique() {
@@ -1203,8 +1129,6 @@ 
  *
  * @stream
  * @signature (a -> String) -> [a] -> {String: a}
- * @param  callable $fn
- * @param  array $list
  * @return array
  */
 function groupBy() {
@@ -1234,8 +1158,6 @@ 
  *
  * @stream
  * @signature [a] -> [b] -> [[a,b]]
- * @param  array $list1
- * @param  array $list2
  * @return array
  */
 function pairsFrom() {
@@ -1280,8 +1202,6 @@ 
  *
  * @stream
  * @signature (a -> a -> Boolean) -> [a] -> [a]
- * @param  callable $compare
- * @param  array $list
  * @return array
  */
 function sort() {