intraxia / jaxion

src/Contract/Axolotl/Dictionary.php

Indentation +174 added lines, -174 removed lines

@@ -5,178 +5,178 @@
 use Iterator;
 
 interface Dictionary extends Iterator, Countable, Serializes {
-	/**
-	 * Returns the type of the dictionary's keys.
-	 *
-	 * @return string
-	 */
-	public function get_key_type();
-
-	/**
-	 * Returns the type of the dictionary's values.
-	 *
-	 * @return string
-	 */
-	public function get_value_type();
-
-	/**
-	 * Returns true if $key is in the dictionary, returns false if it is not.
-	 *
-	 * @param mixed $key Key to check for.
-	 *
-	 * @return bool
-	 */
-	public function exists( $key );
-
-	/**
-	 * Returns true if the callable returns true. The callable should accept a
-	 * key and value as arguments and return a boolean.
-	 *
-	 * @param  callable $callable
-	 * @return bool
-	 */
-	public function contains( $callable );
-
-	/**
-	 * Returns the value associated with $key.
-	 *
-	 * @param mixed $key Key to get.
-	 *
-	 * @return mixed
-	 */
-	public function get( $key );
-
-	/**
-	 * Removes the key-value pair represented by $key from the dictionary.
-	 *
-	 * @param mixed $key Key to remove.
-	 *
-	 * @return static
-	 */
-	public function delete( $key );
-
-	/**
-	 * Returns true if $value is in the dictionary, returns false if not.
-	 *
-	 * @param mixed $value Value to check for existence.
-	 *
-	 * @return bool
-	 */
-	public function value_exists( $value );
-
-	/**
-	 * Returns the number of key-value pairs in the dictionary.
-	 *
-	 * @return int
-	 */
-	public function count();
-
-	/**
-	 * Removes every key-value pair from the dictionary.
-	 *
-	 * @return static
-	 */
-	public function clear();
-
-	/**
-	 * Returns the key-value pairs in the dictionary as an associative array.
-	 *
-	 * @return array
-	 */
-	public function to_array();
-
-	/**
-	 * Returns a dictionary that only contains the key-value pairs which satisfy
-	 * $condition.
-	 *
-	 * @param callable $condition
-	 *
-	 * @return static
-	 */
-	public function filter( $condition );
-
-	/**
-	 * Removes all key-value pairs from the Dictionary that do not satisfy
-	 * $condition.
-	 *
-	 * @param callable $condition
-	 *
-	 * @return Dictionary
-	 */
-	public function reject( $condition );
-
-	/**
-	 * Adds the key-value pair containing $key and $value to the dictionary.
-	 *
-	 * @param mixed $key   Key to add.
-	 * @param mixed $value Value to add.
-	 *
-	 * @return Dictionary
-	 * @throws \InvalidArgumentException
-	 */
-	public function add( $key, $value );
-
-	/**
-	 * Applies the callback function $callable to each key-value pair in the
-	 * dictionary.
-	 *
-	 * @param callable $callable
-	 */
-	public function each( $callable );
-
-	/**
-	 * Returns the value associated with $key in the dictionary, returns
-	 * $default if it does not.
-	 *
-	 * @param mixed $key     Key to fetch.
-	 * @param mixed $default Default value if key is not found.
-	 *
-	 * @return mixed
-	 */
-	public function get_or_else( $key, $default );
-
-	/**
-	 * Returns an array of all keys in the dictionary.
-	 *
-	 * @return array
-	 */
-	public function keys();
-
-	/**
-	 * Returns an array of all values in the dictionary.
-	 *
-	 * @return array
-	 */
-	public function values();
-
-	/**
-	 * Returns a new dictionary with the callback function $callable applied to
-	 * every key-value pair in the dictionary.
-	 *
-	 * @param callable $callable
-	 *
-	 * @return static
-	 */
-	public function map( $callable );
-
-	/**
-	 * Adds every key-value pair in $storage to the dictionary.
-	 *
-	 * @param array|Dictionary $source Storage object to merge.
-	 *
-	 * @return static
-	 */
-	public function merge( $source );
-
-
-	/**
-	 * Reduce the dictionary to a single value. The callable should contain
-	 * args: carry, key, value
-	 *
-	 * @param callable $callable
-	 * @param mixed    $initial
-	 *
-	 * @return mixed
-	 */
-	public function reduce( $callable, $initial );
+    /**
+     * Returns the type of the dictionary's keys.
+     *
+     * @return string
+     */
+    public function get_key_type();
+
+    /**
+     * Returns the type of the dictionary's values.
+     *
+     * @return string
+     */
+    public function get_value_type();
+
+    /**
+     * Returns true if $key is in the dictionary, returns false if it is not.
+     *
+     * @param mixed $key Key to check for.
+     *
+     * @return bool
+     */
+    public function exists( $key );
+
+    /**
+     * Returns true if the callable returns true. The callable should accept a
+     * key and value as arguments and return a boolean.
+     *
+     * @param  callable $callable
+     * @return bool
+     */
+    public function contains( $callable );
+
+    /**
+     * Returns the value associated with $key.
+     *
+     * @param mixed $key Key to get.
+     *
+     * @return mixed
+     */
+    public function get( $key );
+
+    /**
+     * Removes the key-value pair represented by $key from the dictionary.
+     *
+     * @param mixed $key Key to remove.
+     *
+     * @return static
+     */
+    public function delete( $key );
+
+    /**
+     * Returns true if $value is in the dictionary, returns false if not.
+     *
+     * @param mixed $value Value to check for existence.
+     *
+     * @return bool
+     */
+    public function value_exists( $value );
+
+    /**
+     * Returns the number of key-value pairs in the dictionary.
+     *
+     * @return int
+     */
+    public function count();
+
+    /**
+     * Removes every key-value pair from the dictionary.
+     *
+     * @return static
+     */
+    public function clear();
+
+    /**
+     * Returns the key-value pairs in the dictionary as an associative array.
+     *
+     * @return array
+     */
+    public function to_array();
+
+    /**
+     * Returns a dictionary that only contains the key-value pairs which satisfy
+     * $condition.
+     *
+     * @param callable $condition
+     *
+     * @return static
+     */
+    public function filter( $condition );
+
+    /**
+     * Removes all key-value pairs from the Dictionary that do not satisfy
+     * $condition.
+     *
+     * @param callable $condition
+     *
+     * @return Dictionary
+     */
+    public function reject( $condition );
+
+    /**
+     * Adds the key-value pair containing $key and $value to the dictionary.
+     *
+     * @param mixed $key   Key to add.
+     * @param mixed $value Value to add.
+     *
+     * @return Dictionary
+     * @throws \InvalidArgumentException
+     */
+    public function add( $key, $value );
+
+    /**
+     * Applies the callback function $callable to each key-value pair in the
+     * dictionary.
+     *
+     * @param callable $callable
+     */
+    public function each( $callable );
+
+    /**
+     * Returns the value associated with $key in the dictionary, returns
+     * $default if it does not.
+     *
+     * @param mixed $key     Key to fetch.
+     * @param mixed $default Default value if key is not found.
+     *
+     * @return mixed
+     */
+    public function get_or_else( $key, $default );
+
+    /**
+     * Returns an array of all keys in the dictionary.
+     *
+     * @return array
+     */
+    public function keys();
+
+    /**
+     * Returns an array of all values in the dictionary.
+     *
+     * @return array
+     */
+    public function values();
+
+    /**
+     * Returns a new dictionary with the callback function $callable applied to
+     * every key-value pair in the dictionary.
+     *
+     * @param callable $callable
+     *
+     * @return static
+     */
+    public function map( $callable );
+
+    /**
+     * Adds every key-value pair in $storage to the dictionary.
+     *
+     * @param array|Dictionary $source Storage object to merge.
+     *
+     * @return static
+     */
+    public function merge( $source );
+
+
+    /**
+     * Reduce the dictionary to a single value. The callable should contain
+     * args: carry, key, value
+     *
+     * @param callable $callable
+     * @param mixed    $initial
+     *
+     * @return mixed
+     */
+    public function reduce( $callable, $initial );
 }

src/Axolotl/Type.php

Indentation +154 added lines, -154 removed lines

@@ -15,158 +15,158 @@
  */
 class Type {
 
-	/**
-	 * Type to validate against.
-	 *
-	 * @var string
-	 */
-	private $type;
-
-	/**
-	 * Type constructor.
-	 *
-	 * @param string $type
-	 * @param bool   $key_type
-	 */
-	public function __construct( $type, $key_type = false ) {
-		$this->type = $this->determine( $type, $key_type );
-	}
-
-	/**
-	 * Get validation type.
-	 *
-	 * @return string
-	 */
-	public function get_type() {
-		return $this->type;
-	}
-
-	/**
-	 * Returns whether the type is an Axolotl model.
-	 *
-	 * @return bool
-	 */
-	public function is_model() {
-		if ( ! class_exists( $this->type ) ) {
-			return false;
-		}
-
-		$reflection = new ReflectionClass( $this->type );
-		return $reflection->isSubclassOf( 'Intraxia\Jaxion\Axolotl\Model' );
-	}
-
-	/**
-	 * Create a new model from the given data.
-	 *
-	 * @param array $data Data for the model.
-	 *
-	 * @return Model
-	 */
-	public function create_model( array $data ) {
-		return new $this->type( $data );
-	}
-
-	/**
-	 * Validates an array of element.
-	 *
-	 * @param array $elements Elements to be validated.
-	 *
-	 * @throws InvalidArgumentException
-	 */
-	public function validate_elements( array $elements ) {
-		foreach ( $elements as $element ) {
-			$this->validate_element( $element );
-		}
-	}
-
-	/**
-	 * Validate whether the
-	 *
-	 * @param mixed $element Element to validate.
-	 *
-	 * @throws InvalidArgumentException
-	 */
-	public function validate_element( $element ) {
-		$type = gettype( $element );
-		$callable = $this->type === 'callable';
-		$is_object = 'object' === $type;
-		$loose_check = $this->type === 'object';
-
-		// callable must be callable
-		if ( $callable && ! is_callable( $element ) ) {
-			throw new InvalidArgumentException( 'Item must be callable' );
-		}
-
-		// target isn't callable, object must be an instance of target
-		if ( ! $loose_check && ! $callable && $is_object && ! is_a( $element, $this->type ) ) {
-			throw new InvalidArgumentException( "Item is not type or subtype of $this->type" );
-		}
-
-		// a non callable, non object type should match the target string
-		if ( ! $callable && ! $is_object && $type !== $this->type ) {
-			throw new InvalidArgumentException( "Item is not of type: $this->type" );
-		}
-	}
-
-	/**
-	 * Determine the type to validate against.
-	 *
-	 * @param string $type     Type to determine.
-	 * @param bool   $key_type Whether the type is for keys.
-	 *
-	 * @return string
-	 *
-	 * @throws InvalidArgumentException
-	 */
-	private function determine( $type, $key_type = false ) {
-		if ( ! $key_type && $this->non_scalar_type_exists( $type ) ) {
-			return $type;
-		}
-
-		if ( $scalar_type = $this->determine_scalar( $type ) ) {
-			if ( $key_type && (in_array( $scalar_type, array( 'double', 'boolean' ) )) ) {
-				throw new InvalidArgumentException( 'This type is not supported as a key.' );
-			}
-
-			return $scalar_type;
-		}
-
-		throw new InvalidArgumentException( 'This type does not exist.' );
-	}
-
-	/**
-	 * Determines whether the given type exists.
-	 *
-	 * @param string $type Type to check.
-	 *
-	 * @return bool
-	 */
-	private function non_scalar_type_exists( $type ) {
-		return class_exists( $type )
-				|| interface_exists( $type )
-				|| in_array( $type, array( 'array', 'object', 'callable' ) );
-	}
-
-	/**
-	 * Returns the type if it's scalar, otherwise, returns null.
-	 *
-	 * @param string $type Type to check.
-	 *
-	 * @return string|null
-	 */
-	private function determine_scalar( $type ) {
-		$synonyms = array(
-			'int' => 'integer',
-			'float' => 'double',
-			'bool' => 'boolean',
-		);
-
-		if ( array_key_exists( $type, $synonyms ) ) {
-			$type = $synonyms[ $type ];
-		}
-
-		return in_array( $type, array( 'string', 'integer', 'double', 'boolean' ) ) ?
-			$type :
-			null;
-	}
+    /**
+     * Type to validate against.
+     *
+     * @var string
+     */
+    private $type;
+
+    /**
+     * Type constructor.
+     *
+     * @param string $type
+     * @param bool   $key_type
+     */
+    public function __construct( $type, $key_type = false ) {
+        $this->type = $this->determine( $type, $key_type );
+    }
+
+    /**
+     * Get validation type.
+     *
+     * @return string
+     */
+    public function get_type() {
+        return $this->type;
+    }
+
+    /**
+     * Returns whether the type is an Axolotl model.
+     *
+     * @return bool
+     */
+    public function is_model() {
+        if ( ! class_exists( $this->type ) ) {
+            return false;
+        }
+
+        $reflection = new ReflectionClass( $this->type );
+        return $reflection->isSubclassOf( 'Intraxia\Jaxion\Axolotl\Model' );
+    }
+
+    /**
+     * Create a new model from the given data.
+     *
+     * @param array $data Data for the model.
+     *
+     * @return Model
+     */
+    public function create_model( array $data ) {
+        return new $this->type( $data );
+    }
+
+    /**
+     * Validates an array of element.
+     *
+     * @param array $elements Elements to be validated.
+     *
+     * @throws InvalidArgumentException
+     */
+    public function validate_elements( array $elements ) {
+        foreach ( $elements as $element ) {
+            $this->validate_element( $element );
+        }
+    }
+
+    /**
+     * Validate whether the
+     *
+     * @param mixed $element Element to validate.
+     *
+     * @throws InvalidArgumentException
+     */
+    public function validate_element( $element ) {
+        $type = gettype( $element );
+        $callable = $this->type === 'callable';
+        $is_object = 'object' === $type;
+        $loose_check = $this->type === 'object';
+
+        // callable must be callable
+        if ( $callable && ! is_callable( $element ) ) {
+            throw new InvalidArgumentException( 'Item must be callable' );
+        }
+
+        // target isn't callable, object must be an instance of target
+        if ( ! $loose_check && ! $callable && $is_object && ! is_a( $element, $this->type ) ) {
+            throw new InvalidArgumentException( "Item is not type or subtype of $this->type" );
+        }
+
+        // a non callable, non object type should match the target string
+        if ( ! $callable && ! $is_object && $type !== $this->type ) {
+            throw new InvalidArgumentException( "Item is not of type: $this->type" );
+        }
+    }
+
+    /**
+     * Determine the type to validate against.
+     *
+     * @param string $type     Type to determine.
+     * @param bool   $key_type Whether the type is for keys.
+     *
+     * @return string
+     *
+     * @throws InvalidArgumentException
+     */
+    private function determine( $type, $key_type = false ) {
+        if ( ! $key_type && $this->non_scalar_type_exists( $type ) ) {
+            return $type;
+        }
+
+        if ( $scalar_type = $this->determine_scalar( $type ) ) {
+            if ( $key_type && (in_array( $scalar_type, array( 'double', 'boolean' ) )) ) {
+                throw new InvalidArgumentException( 'This type is not supported as a key.' );
+            }
+
+            return $scalar_type;
+        }
+
+        throw new InvalidArgumentException( 'This type does not exist.' );
+    }
+
+    /**
+     * Determines whether the given type exists.
+     *
+     * @param string $type Type to check.
+     *
+     * @return bool
+     */
+    private function non_scalar_type_exists( $type ) {
+        return class_exists( $type )
+                || interface_exists( $type )
+                || in_array( $type, array( 'array', 'object', 'callable' ) );
+    }
+
+    /**
+     * Returns the type if it's scalar, otherwise, returns null.
+     *
+     * @param string $type Type to check.
+     *
+     * @return string|null
+     */
+    private function determine_scalar( $type ) {
+        $synonyms = array(
+            'int' => 'integer',
+            'float' => 'double',
+            'bool' => 'boolean',
+        );
+
+        if ( array_key_exists( $type, $synonyms ) ) {
+            $type = $synonyms[ $type ];
+        }
+
+        return in_array( $type, array( 'string', 'integer', 'double', 'boolean' ) ) ?
+            $type :
+            null;
+    }
 }

src/Axolotl/Dictionary.php

Indentation +368 added lines, -368 removed lines

@@ -14,372 +14,372 @@
  */
 class Dictionary implements DictionaryContract {
 
-	/**
-	 * Dictionary storage array.
-	 *
-	 * @var array
-	 */
-	protected $storage = array();
-
-	/**
-	 * Key Type service.
-	 *
-	 * @var Type
-	 */
-	protected $key_type;
-
-	/**
-	 * Value Type service.
-	 *
-	 * @var Type
-	 */
-	protected $val_type;
-
-	/**
-	 * Where Dictionary is in loop.
-	 *
-	 * @var int
-	 */
-	protected $position = 0;
-
-	/**
-	 * Dictionary keys.
-	 *
-	 * @var array
-	 */
-	protected $keys = array();
-
-	/**
-	 * Dictionary constructor.
-	 *
-	 * @param string $key_type
-	 * @param string $val_type
-	 * @param array  $storage
-	 *
-	 * @throws InvalidArgumentException
-	 */
-	public function __construct( $key_type, $val_type, array $storage = array() ) {
-		$this->key_type = new Type( $key_type, true );
-		$this->val_type = new Type( $val_type );
-
-		foreach ( $storage as $key => $val ) {
-			$this->key_type->validate_element( $key );
-			$this->val_type->validate_element( $val );
-
-			$this->storage[ $key ] = $val;
-		}
-	}
-
-	/**
-	 * {@inheritdoc}
-	 *
-	 * @return string
-	 */
-	public function get_key_type() {
-		return $this->key_type->get_type();
-	}
-
-	/**
-	 * {@inheritdoc}
-	 *
-	 * @return string
-	 */
-	public function get_value_type() {
-		return $this->val_type->get_type();
-	}
-
-	/**
-	 * {@inheritdoc}
-	 *
-	 * @param mixed $key Key to check.
-	 *
-	 * @return bool
-	 */
-	public function exists( $key ) {
-		return array_key_exists( $key, $this->storage );
-	}
-
-	/**
-	 * {@inheritdoc}
-	 *
-	 * @param mixed $key Key to get.
-	 *
-	 * @return mixed|null
-	 */
-	public function get( $key ) {
-		return $this->exists( $key ) ? $this->storage[ $key ] : null;
-	}
-
-	/**
-	 * {@inheritdoc}
-	 *
-	 * @param mixed $key Key to remove.
-	 *
-	 * @return DictionaryContract
-	 */
-	public function delete( $key ) {
-		$storage = $this->storage;
-		if ( $this->exists( $key ) ) {
-			unset( $storage[ $key ] );
-		}
-
-		return new static( $this->get_key_type(), $this->get_value_type(), $storage );
-	}
-
-	/**
-	 * {@inheritdoc}
-	 *
-	 * @param mixed $value Value to validate.
-	 *
-	 * @return bool
-	 */
-	public function value_exists( $value ) {
-		return in_array( $value, $this->storage );
-	}
-
-	/**
-	 * {@inheritdoc}
-	 */
-	public function count() {
-		return count( $this->storage );
-	}
-
-	/**
-	 * {@inheritdoc}
-	 */
-	public function clear() {
-		return new static( $this->get_key_type(), $this->get_value_type() );
-	}
-
-	/**
-	 * {@inheritdoc}
-	 *
-	 * @return array
-	 */
-	public function to_array() {
-		return $this->storage;
-	}
-
-	/**
-	 * {@inheritdoc}
-	 *
-	 * @param callable $condition Conditional callback.
-	 *
-	 * @return DictionaryContract
-	 */
-	public function filter( $condition ) {
-		$storage = array();
-
-		foreach ( $this->storage as $key => $value ) {
-			if ( call_user_func( $condition, $value, $key ) ) {
-				$storage[ $key ] = $value;
-			}
-		}
-
-		return new static( $this->get_key_type(), $this->get_value_type(), $storage );
-	}
-
-	/**
-	 * {@inheritdoc}
-	 *
-	 * @param callable $condition Callback condition.
-	 *
-	 * @return DictionaryContract
-	 */
-	public function reject( $condition ) {
-		return $this->filter( function ( $v, $k ) use ( $condition ) {
-			return ! call_user_func( $condition, $v, $k );
-		} );
-	}
-
-	/**
-	 * {@inheritdoc}
-	 *
-	 * @param mixed $key   Key to add.
-	 * @param mixed $value Value to add.
-	 *
-	 * @return DictionaryContract
-	 */
-	public function add( $key, $value ) {
-		$storage         = $this->storage;
-		$storage[ $key ] = $value;
-
-		return new static( $this->get_key_type(), $this->get_value_type(), $storage );
-	}
-
-	/**
-	 * {@inheritdoc}
-	 *
-	 * @param callable $callable Function to call.
-	 */
-	public function each( $callable ) {
-		foreach ( $this->storage as $key => $value ) {
-			call_user_func( $callable, $value, $key );
-		}
-	}
-
-	/**
-	 * {@inheritdoc}
-	 *
-	 * @param mixed $key     Key to fetch.
-	 * @param mixed $default Default to return if key is missing.
-	 *
-	 * @return mixed
-	 */
-	public function get_or_else( $key, $default ) {
-		return ( $this->exists( $key ) ) ? $this->get( $key ) : $default;
-	}
-
-	/**
-	 * {@inheritdoc}
-	 */
-	public function keys() {
-		return array_keys( $this->storage );
-	}
-
-	/**
-	 * {@inheritdoc}
-	 */
-	public function values() {
-		return array_values( $this->storage );
-	}
-
-	/**
-	 * {@inheritdoc}
-	 *
-	 * @param callable $callable Function to call.
-	 *
-	 * @return DictionaryContract
-	 */
-	public function map( $callable ) {
-		$items = array();
-		$val_type = null;
-
-		foreach ( $this->storage as $key => $val ) {
-			$v = call_user_func( $callable, $val, $key );
-
-			if ( ! isset( $val_type ) ) {
-				$val_type = gettype( $v );
-			}
-
-			$items[ $key ] = $v;
-		}
-
-		return new static( $this->get_key_type(), $val_type, $items );
-	}
-
-	/**
-	 * {@inheritdoc}
-	 *
-	 * @param array|DictionaryContract $source Source to merge.
-	 *
-	 * @return DictionaryContract
-	 *
-	 * @throws InvalidArgumentException
-	 */
-	public function merge( $source ) {
-		if ( $source instanceof self ) {
-			$source = $source->to_array();
-		}
-
-		if ( ! is_array( $source ) ) {
-			throw new InvalidArgumentException( 'Combine must be a Dictionary or an array' );
-		}
-
-		return new static( $this->get_key_type(), $this->get_value_type(), array_merge( $this->storage, $source ) );
-	}
-
-
-	/**
-	 * {@inheritdoc}
-	 *
-	 * @param callable $callable
-	 *
-	 * @return bool
-	 */
-	public function contains( $callable ) {
-		foreach ( $this->storage as $key => $value ) {
-			if ( call_user_func( $callable, $value, $key ) ) {
-				return true;
-			}
-		}
-
-		return false;
-	}
-
-	/**
-	 * {@inheritdoc}
-	 *
-	 * @param callable $callable
-	 * @param mixed    $initial
-	 *
-	 * @return mixed
-	 */
-	public function reduce( $callable, $initial ) {
-		$carry = $initial;
-
-		foreach ( $this->storage as $key => $value ) {
-			$carry = $callable( $carry, $value, $key );
-		}
-
-		return $carry;
-	}
-
-	/**
-	 * Return the current element.
-	 *
-	 * @return mixed
-	 */
-	public function current() {
-		$key = $this->keys[ $this->position ];
-		return $this->storage[ $key ];
-	}
-
-	/**
-	 * Move forward to next element.
-	 */
-	public function next() {
-		$this->position ++;
-	}
-
-	/**
-	 * Return the key of the current element.
-	 *
-	 * @return mixed
-	 */
-	public function key() {
-		return $this->keys[ $this->position ];
-	}
-
-	/**
-	 * Checks if current position is valid.
-	 *
-	 * @return bool
-	 */
-	public function valid() {
-		return isset( $this->keys[ $this->position ] );
-	}
-
-	/**
-	 * Rewind the Iterator to the first element.
-	 */
-	public function rewind() {
-		$this->position = 0;
-		$this->keys = array_keys( $this->storage );
-	}
-
-	/**
-	 * {@inheritDoc}
-	 *
-	 * @return array
-	 */
-	public function serialize() {
-		return $this->map(function( $val ) {
-			if ( $val instanceof Serializes ) {
-				$val = $val->serialize();
-			}
-
-			return $val;
-		})->to_array();
-	}
+    /**
+     * Dictionary storage array.
+     *
+     * @var array
+     */
+    protected $storage = array();
+
+    /**
+     * Key Type service.
+     *
+     * @var Type
+     */
+    protected $key_type;
+
+    /**
+     * Value Type service.
+     *
+     * @var Type
+     */
+    protected $val_type;
+
+    /**
+     * Where Dictionary is in loop.
+     *
+     * @var int
+     */
+    protected $position = 0;
+
+    /**
+     * Dictionary keys.
+     *
+     * @var array
+     */
+    protected $keys = array();
+
+    /**
+     * Dictionary constructor.
+     *
+     * @param string $key_type
+     * @param string $val_type
+     * @param array  $storage
+     *
+     * @throws InvalidArgumentException
+     */
+    public function __construct( $key_type, $val_type, array $storage = array() ) {
+        $this->key_type = new Type( $key_type, true );
+        $this->val_type = new Type( $val_type );
+
+        foreach ( $storage as $key => $val ) {
+            $this->key_type->validate_element( $key );
+            $this->val_type->validate_element( $val );
+
+            $this->storage[ $key ] = $val;
+        }
+    }
+
+    /**
+     * {@inheritdoc}
+     *
+     * @return string
+     */
+    public function get_key_type() {
+        return $this->key_type->get_type();
+    }
+
+    /**
+     * {@inheritdoc}
+     *
+     * @return string
+     */
+    public function get_value_type() {
+        return $this->val_type->get_type();
+    }
+
+    /**
+     * {@inheritdoc}
+     *
+     * @param mixed $key Key to check.
+     *
+     * @return bool
+     */
+    public function exists( $key ) {
+        return array_key_exists( $key, $this->storage );
+    }
+
+    /**
+     * {@inheritdoc}
+     *
+     * @param mixed $key Key to get.
+     *
+     * @return mixed|null
+     */
+    public function get( $key ) {
+        return $this->exists( $key ) ? $this->storage[ $key ] : null;
+    }
+
+    /**
+     * {@inheritdoc}
+     *
+     * @param mixed $key Key to remove.
+     *
+     * @return DictionaryContract
+     */
+    public function delete( $key ) {
+        $storage = $this->storage;
+        if ( $this->exists( $key ) ) {
+            unset( $storage[ $key ] );
+        }
+
+        return new static( $this->get_key_type(), $this->get_value_type(), $storage );
+    }
+
+    /**
+     * {@inheritdoc}
+     *
+     * @param mixed $value Value to validate.
+     *
+     * @return bool
+     */
+    public function value_exists( $value ) {
+        return in_array( $value, $this->storage );
+    }
+
+    /**
+     * {@inheritdoc}
+     */
+    public function count() {
+        return count( $this->storage );
+    }
+
+    /**
+     * {@inheritdoc}
+     */
+    public function clear() {
+        return new static( $this->get_key_type(), $this->get_value_type() );
+    }
+
+    /**
+     * {@inheritdoc}
+     *
+     * @return array
+     */
+    public function to_array() {
+        return $this->storage;
+    }
+
+    /**
+     * {@inheritdoc}
+     *
+     * @param callable $condition Conditional callback.
+     *
+     * @return DictionaryContract
+     */
+    public function filter( $condition ) {
+        $storage = array();
+
+        foreach ( $this->storage as $key => $value ) {
+            if ( call_user_func( $condition, $value, $key ) ) {
+                $storage[ $key ] = $value;
+            }
+        }
+
+        return new static( $this->get_key_type(), $this->get_value_type(), $storage );
+    }
+
+    /**
+     * {@inheritdoc}
+     *
+     * @param callable $condition Callback condition.
+     *
+     * @return DictionaryContract
+     */
+    public function reject( $condition ) {
+        return $this->filter( function ( $v, $k ) use ( $condition ) {
+            return ! call_user_func( $condition, $v, $k );
+        } );
+    }
+
+    /**
+     * {@inheritdoc}
+     *
+     * @param mixed $key   Key to add.
+     * @param mixed $value Value to add.
+     *
+     * @return DictionaryContract
+     */
+    public function add( $key, $value ) {
+        $storage         = $this->storage;
+        $storage[ $key ] = $value;
+
+        return new static( $this->get_key_type(), $this->get_value_type(), $storage );
+    }
+
+    /**
+     * {@inheritdoc}
+     *
+     * @param callable $callable Function to call.
+     */
+    public function each( $callable ) {
+        foreach ( $this->storage as $key => $value ) {
+            call_user_func( $callable, $value, $key );
+        }
+    }
+
+    /**
+     * {@inheritdoc}
+     *
+     * @param mixed $key     Key to fetch.
+     * @param mixed $default Default to return if key is missing.
+     *
+     * @return mixed
+     */
+    public function get_or_else( $key, $default ) {
+        return ( $this->exists( $key ) ) ? $this->get( $key ) : $default;
+    }
+
+    /**
+     * {@inheritdoc}
+     */
+    public function keys() {
+        return array_keys( $this->storage );
+    }
+
+    /**
+     * {@inheritdoc}
+     */
+    public function values() {
+        return array_values( $this->storage );
+    }
+
+    /**
+     * {@inheritdoc}
+     *
+     * @param callable $callable Function to call.
+     *
+     * @return DictionaryContract
+     */
+    public function map( $callable ) {
+        $items = array();
+        $val_type = null;
+
+        foreach ( $this->storage as $key => $val ) {
+            $v = call_user_func( $callable, $val, $key );
+
+            if ( ! isset( $val_type ) ) {
+                $val_type = gettype( $v );
+            }
+
+            $items[ $key ] = $v;
+        }
+
+        return new static( $this->get_key_type(), $val_type, $items );
+    }
+
+    /**
+     * {@inheritdoc}
+     *
+     * @param array|DictionaryContract $source Source to merge.
+     *
+     * @return DictionaryContract
+     *
+     * @throws InvalidArgumentException
+     */
+    public function merge( $source ) {
+        if ( $source instanceof self ) {
+            $source = $source->to_array();
+        }
+
+        if ( ! is_array( $source ) ) {
+            throw new InvalidArgumentException( 'Combine must be a Dictionary or an array' );
+        }
+
+        return new static( $this->get_key_type(), $this->get_value_type(), array_merge( $this->storage, $source ) );
+    }
+
+
+    /**
+     * {@inheritdoc}
+     *
+     * @param callable $callable
+     *
+     * @return bool
+     */
+    public function contains( $callable ) {
+        foreach ( $this->storage as $key => $value ) {
+            if ( call_user_func( $callable, $value, $key ) ) {
+                return true;
+            }
+        }
+
+        return false;
+    }
+
+    /**
+     * {@inheritdoc}
+     *
+     * @param callable $callable
+     * @param mixed    $initial
+     *
+     * @return mixed
+     */
+    public function reduce( $callable, $initial ) {
+        $carry = $initial;
+
+        foreach ( $this->storage as $key => $value ) {
+            $carry = $callable( $carry, $value, $key );
+        }
+
+        return $carry;
+    }
+
+    /**
+     * Return the current element.
+     *
+     * @return mixed
+     */
+    public function current() {
+        $key = $this->keys[ $this->position ];
+        return $this->storage[ $key ];
+    }
+
+    /**
+     * Move forward to next element.
+     */
+    public function next() {
+        $this->position ++;
+    }
+
+    /**
+     * Return the key of the current element.
+     *
+     * @return mixed
+     */
+    public function key() {
+        return $this->keys[ $this->position ];
+    }
+
+    /**
+     * Checks if current position is valid.
+     *
+     * @return bool
+     */
+    public function valid() {
+        return isset( $this->keys[ $this->position ] );
+    }
+
+    /**
+     * Rewind the Iterator to the first element.
+     */
+    public function rewind() {
+        $this->position = 0;
+        $this->keys = array_keys( $this->storage );
+    }
+
+    /**
+     * {@inheritDoc}
+     *
+     * @return array
+     */
+    public function serialize() {
+        return $this->map(function( $val ) {
+            if ( $val instanceof Serializes ) {
+                $val = $val->serialize();
+            }
+
+            return $val;
+        })->to_array();
+    }
 }