YetiForceCompany / YetiForceCRM

libraries/SabreDAV/VObject/Property/ICalendar/Period.php

Unused Use Statements +1 added lines, -1 removed lines

@@ -2,8 +2,8 @@
 
 namespace Sabre\VObject\Property;
 
-use Sabre\VObject\Property;
 use Sabre\VObject\Parameter;
+use Sabre\VObject\Property;
 
 /**
  * URI property.

Indentation +132 added lines, -132 removed lines

@@ -19,137 +19,137 @@
  */
 class Period extends Property {
 
-    /**
-     * In case this is a multi-value property. This string will be used as a
-     * delimiter.
-     *
-     * @var string|null
-     */
-    public $delimiter = ',';
-
-    /**
-     * Sets a raw value coming from a mimedir (iCalendar/vCard) file.
-     *
-     * This has been 'unfolded', so only 1 line will be passed. Unescaping is
-     * not yet done, but parameters are not included.
-     *
-     * @param string $val
-     *
-     * @return void
-     */
-    public function setRawMimeDirValue($val) {
-
-        $this->setValue(explode($this->delimiter, $val));
-
-    }
-
-    /**
-     * Returns a raw mime-dir representation of the value.
-     *
-     * @return string
-     */
-    public function getRawMimeDirValue() {
-
-        return implode($this->delimiter, $this->getParts());
-
-    }
-
-    /**
-     * Returns the type of value.
-     *
-     * This corresponds to the VALUE= parameter. Every property also has a
-     * 'default' valueType.
-     *
-     * @return string
-     */
-    public function getValueType() {
-
-        return 'PERIOD';
-
-    }
-
-    /**
-     * Sets the json value, as it would appear in a jCard or jCal object.
-     *
-     * The value must always be an array.
-     *
-     * @param array $value
-     *
-     * @return void
-     */
-    public function setJsonValue(array $value) {
-
-        $value = array_map(
-            function($item) {
-
-                return strtr(implode('/', $item), [':' => '', '-' => '']);
-
-            },
-            $value
-        );
-        parent::setJsonValue($value);
-
-    }
-
-    /**
-     * Returns the value, in the format it should be encoded for json.
-     *
-     * This method must always return an array.
-     *
-     * @return array
-     */
-    public function getJsonValue() {
-
-        $return = [];
-        foreach ($this->getParts() as $item) {
-
-            list($start, $end) = explode('/', $item, 2);
-
-            $start = DateTimeParser::parseDateTime($start);
-
-            // This is a duration value.
-            if ($end[0] === 'P') {
-                $return[] = [
-                    $start->format('Y-m-d\\TH:i:s'),
-                    $end
-                ];
-            } else {
-                $end = DateTimeParser::parseDateTime($end);
-                $return[] = [
-                    $start->format('Y-m-d\\TH:i:s'),
-                    $end->format('Y-m-d\\TH:i:s'),
-                ];
-            }
-
-        }
-
-        return $return;
-
-    }
-
-    /**
-     * This method serializes only the value of a property. This is used to
-     * create xCard or xCal documents.
-     *
-     * @param Xml\Writer $writer  XML writer.
-     *
-     * @return void
-     */
-    protected function xmlSerializeValue(Xml\Writer $writer) {
-
-        $writer->startElement(strtolower($this->getValueType()));
-        $value = $this->getJsonValue();
-        $writer->writeElement('start', $value[0][0]);
-
-        if ($value[0][1][0] === 'P') {
-            $writer->writeElement('duration', $value[0][1]);
-        }
-        else {
-            $writer->writeElement('end', $value[0][1]);
-        }
-
-        $writer->endElement();
-
-    }
+	/**
+	 * In case this is a multi-value property. This string will be used as a
+	 * delimiter.
+	 *
+	 * @var string|null
+	 */
+	public $delimiter = ',';
+
+	/**
+	 * Sets a raw value coming from a mimedir (iCalendar/vCard) file.
+	 *
+	 * This has been 'unfolded', so only 1 line will be passed. Unescaping is
+	 * not yet done, but parameters are not included.
+	 *
+	 * @param string $val
+	 *
+	 * @return void
+	 */
+	public function setRawMimeDirValue($val) {
+
+		$this->setValue(explode($this->delimiter, $val));
+
+	}
+
+	/**
+	 * Returns a raw mime-dir representation of the value.
+	 *
+	 * @return string
+	 */
+	public function getRawMimeDirValue() {
+
+		return implode($this->delimiter, $this->getParts());
+
+	}
+
+	/**
+	 * Returns the type of value.
+	 *
+	 * This corresponds to the VALUE= parameter. Every property also has a
+	 * 'default' valueType.
+	 *
+	 * @return string
+	 */
+	public function getValueType() {
+
+		return 'PERIOD';
+
+	}
+
+	/**
+	 * Sets the json value, as it would appear in a jCard or jCal object.
+	 *
+	 * The value must always be an array.
+	 *
+	 * @param array $value
+	 *
+	 * @return void
+	 */
+	public function setJsonValue(array $value) {
+
+		$value = array_map(
+			function($item) {
+
+				return strtr(implode('/', $item), [':' => '', '-' => '']);
+
+			},
+			$value
+		);
+		parent::setJsonValue($value);
+
+	}
+
+	/**
+	 * Returns the value, in the format it should be encoded for json.
+	 *
+	 * This method must always return an array.
+	 *
+	 * @return array
+	 */
+	public function getJsonValue() {
+
+		$return = [];
+		foreach ($this->getParts() as $item) {
+
+			list($start, $end) = explode('/', $item, 2);
+
+			$start = DateTimeParser::parseDateTime($start);
+
+			// This is a duration value.
+			if ($end[0] === 'P') {
+				$return[] = [
+					$start->format('Y-m-d\\TH:i:s'),
+					$end
+				];
+			} else {
+				$end = DateTimeParser::parseDateTime($end);
+				$return[] = [
+					$start->format('Y-m-d\\TH:i:s'),
+					$end->format('Y-m-d\\TH:i:s'),
+				];
+			}
+
+		}
+
+		return $return;
+
+	}
+
+	/**
+	 * This method serializes only the value of a property. This is used to
+	 * create xCard or xCal documents.
+	 *
+	 * @param Xml\Writer $writer  XML writer.
+	 *
+	 * @return void
+	 */
+	protected function xmlSerializeValue(Xml\Writer $writer) {
+
+		$writer->startElement(strtolower($this->getValueType()));
+		$value = $this->getJsonValue();
+		$writer->writeElement('start', $value[0][0]);
+
+		if ($value[0][1][0] === 'P') {
+			$writer->writeElement('duration', $value[0][1]);
+		}
+		else {
+			$writer->writeElement('end', $value[0][1]);
+		}
+
+		$writer->endElement();
+
+	}
 
 }

libraries/SabreDAV/VObject/Property/Time.php

Doc Comments +1 added lines, -1 removed lines

@@ -44,7 +44,7 @@
      *
      * This method must always return an array.
      *
-     * @return array
+     * @return string[]
      */
     function getJsonValue() {
 

Indentation +125 added lines, -125 removed lines

@@ -15,130 +15,130 @@
  */
 class Time extends Text {
 
-    /**
-     * In case this is a multi-value property. This string will be used as a
-     * delimiter.
-     *
-     * @var string|null
-     */
-    public $delimiter = null;
-
-    /**
-     * Returns the type of value.
-     *
-     * This corresponds to the VALUE= parameter. Every property also has a
-     * 'default' valueType.
-     *
-     * @return string
-     */
-    public function getValueType() {
-
-        return 'TIME';
-
-    }
-
-    /**
-     * Sets the JSON value, as it would appear in a jCard or jCal object.
-     *
-     * The value must always be an array.
-     *
-     * @param array $value
-     *
-     * @return void
-     */
-    public function setJsonValue(array $value) {
-
-        // Removing colons from value.
-        $value = str_replace(
-            ':',
-            '',
-            $value
-        );
-
-        if (count($value) === 1) {
-            $this->setValue(reset($value));
-        } else {
-            $this->setValue($value);
-        }
-
-    }
-
-    /**
-     * Returns the value, in the format it should be encoded for json.
-     *
-     * This method must always return an array.
-     *
-     * @return array
-     */
-    public function getJsonValue() {
-
-        $parts = DateTimeParser::parseVCardTime($this->getValue());
-        $timeStr = '';
-
-        // Hour
-        if (!is_null($parts['hour'])) {
-            $timeStr .= $parts['hour'];
-
-            if (!is_null($parts['minute'])) {
-                $timeStr .= ':';
-            }
-        } else {
-            // We know either minute or second _must_ be set, so we insert a
-            // dash for an empty value.
-            $timeStr .= '-';
-        }
-
-        // Minute
-        if (!is_null($parts['minute'])) {
-            $timeStr .= $parts['minute'];
-
-            if (!is_null($parts['second'])) {
-                $timeStr .= ':';
-            }
-        } else {
-            if (isset($parts['second'])) {
-                // Dash for empty minute
-                $timeStr .= '-';
-            }
-        }
-
-        // Second
-        if (!is_null($parts['second'])) {
-            $timeStr .= $parts['second'];
-        }
-
-        // Timezone
-        if (!is_null($parts['timezone'])) {
-            if ($parts['timezone'] === 'Z') {
-                $timeStr .= 'Z';
-            } else {
-                $timeStr .=
-                    preg_replace('/([0-9]{2})([0-9]{2})$/', '$1:$2', $parts['timezone']);
-            }
-        }
-
-        return [$timeStr];
-
-    }
-
-    /**
-     * Hydrate data from a XML subtree, as it would appear in a xCard or xCal
-     * object.
-     *
-     * @param array $value
-     *
-     * @return void
-     */
-    public function setXmlValue(array $value) {
-
-        $value = array_map(
-            function($value) {
-                return str_replace(':', '', $value);
-            },
-            $value
-        );
-        parent::setXmlValue($value);
-
-    }
+	/**
+	 * In case this is a multi-value property. This string will be used as a
+	 * delimiter.
+	 *
+	 * @var string|null
+	 */
+	public $delimiter = null;
+
+	/**
+	 * Returns the type of value.
+	 *
+	 * This corresponds to the VALUE= parameter. Every property also has a
+	 * 'default' valueType.
+	 *
+	 * @return string
+	 */
+	public function getValueType() {
+
+		return 'TIME';
+
+	}
+
+	/**
+	 * Sets the JSON value, as it would appear in a jCard or jCal object.
+	 *
+	 * The value must always be an array.
+	 *
+	 * @param array $value
+	 *
+	 * @return void
+	 */
+	public function setJsonValue(array $value) {
+
+		// Removing colons from value.
+		$value = str_replace(
+			':',
+			'',
+			$value
+		);
+
+		if (count($value) === 1) {
+			$this->setValue(reset($value));
+		} else {
+			$this->setValue($value);
+		}
+
+	}
+
+	/**
+	 * Returns the value, in the format it should be encoded for json.
+	 *
+	 * This method must always return an array.
+	 *
+	 * @return array
+	 */
+	public function getJsonValue() {
+
+		$parts = DateTimeParser::parseVCardTime($this->getValue());
+		$timeStr = '';
+
+		// Hour
+		if (!is_null($parts['hour'])) {
+			$timeStr .= $parts['hour'];
+
+			if (!is_null($parts['minute'])) {
+				$timeStr .= ':';
+			}
+		} else {
+			// We know either minute or second _must_ be set, so we insert a
+			// dash for an empty value.
+			$timeStr .= '-';
+		}
+
+		// Minute
+		if (!is_null($parts['minute'])) {
+			$timeStr .= $parts['minute'];
+
+			if (!is_null($parts['second'])) {
+				$timeStr .= ':';
+			}
+		} else {
+			if (isset($parts['second'])) {
+				// Dash for empty minute
+				$timeStr .= '-';
+			}
+		}
+
+		// Second
+		if (!is_null($parts['second'])) {
+			$timeStr .= $parts['second'];
+		}
+
+		// Timezone
+		if (!is_null($parts['timezone'])) {
+			if ($parts['timezone'] === 'Z') {
+				$timeStr .= 'Z';
+			} else {
+				$timeStr .=
+					preg_replace('/([0-9]{2})([0-9]{2})$/', '$1:$2', $parts['timezone']);
+			}
+		}
+
+		return [$timeStr];
+
+	}
+
+	/**
+	 * Hydrate data from a XML subtree, as it would appear in a xCard or xCal
+	 * object.
+	 *
+	 * @param array $value
+	 *
+	 * @return void
+	 */
+	public function setXmlValue(array $value) {
+
+		$value = array_map(
+			function($value) {
+				return str_replace(':', '', $value);
+			},
+			$value
+		);
+		parent::setXmlValue($value);
+
+	}
 
 }

libraries/SabreDAV/VObject/Property/ICalendar/DateTime.php

Indentation +375 added lines, -375 removed lines

@@ -26,379 +26,379 @@
  */
 class DateTime extends Property {
 
-    /**
-     * In case this is a multi-value property. This string will be used as a
-     * delimiter.
-     *
-     * @var string|null
-     */
-    public $delimiter = ',';
-
-    /**
-     * Sets a multi-valued property.
-     *
-     * You may also specify DateTime objects here.
-     *
-     * @param array $parts
-     *
-     * @return void
-     */
-    public function setParts(array $parts) {
-
-        if (isset($parts[0]) && $parts[0] instanceof DateTimeInterface) {
-            $this->setDateTimes($parts);
-        } else {
-            parent::setParts($parts);
-        }
-
-    }
-
-    /**
-     * Updates the current value.
-     *
-     * This may be either a single, or multiple strings in an array.
-     *
-     * Instead of strings, you may also use DateTime here.
-     *
-     * @param string|array|DateTimeInterface $value
-     *
-     * @return void
-     */
-    public function setValue($value) {
-
-        if (is_array($value) && isset($value[0]) && $value[0] instanceof DateTimeInterface) {
-            $this->setDateTimes($value);
-        } elseif ($value instanceof DateTimeInterface) {
-            $this->setDateTimes([$value]);
-        } else {
-            parent::setValue($value);
-        }
-
-    }
-
-    /**
-     * Sets a raw value coming from a mimedir (iCalendar/vCard) file.
-     *
-     * This has been 'unfolded', so only 1 line will be passed. Unescaping is
-     * not yet done, but parameters are not included.
-     *
-     * @param string $val
-     *
-     * @return void
-     */
-    public function setRawMimeDirValue($val) {
-
-        $this->setValue(explode($this->delimiter, $val));
-
-    }
-
-    /**
-     * Returns a raw mime-dir representation of the value.
-     *
-     * @return string
-     */
-    public function getRawMimeDirValue() {
-
-        return implode($this->delimiter, $this->getParts());
-
-    }
-
-    /**
-     * Returns true if this is a DATE-TIME value, false if it's a DATE.
-     *
-     * @return bool
-     */
-    public function hasTime() {
-
-        return strtoupper((string)$this['VALUE']) !== 'DATE';
-
-    }
-
-    /**
-     * Returns true if this is a floating DATE or DATE-TIME.
-     *
-     * Note that DATE is always floating.
-     */
-    public function isFloating() {
-
-        return
-            !$this->hasTime() ||
-            (
-                !isset($this['TZID']) &&
-                strpos($this->getValue(), 'Z') === false
-            );
-
-    }
-
-    /**
-     * Returns a date-time value.
-     *
-     * Note that if this property contained more than 1 date-time, only the
-     * first will be returned. To get an array with multiple values, call
-     * getDateTimes.
-     *
-     * If no timezone information is known, because it's either an all-day
-     * property or floating time, we will use the DateTimeZone argument to
-     * figure out the exact date.
-     *
-     * @param DateTimeZone $timeZone
-     *
-     * @return DateTimeImmutable
-     */
-    public function getDateTime(DateTimeZone $timeZone = null) {
-
-        $dt = $this->getDateTimes($timeZone);
-        if (!$dt) return;
-
-        return $dt[0];
-
-    }
-
-    /**
-     * Returns multiple date-time values.
-     *
-     * If no timezone information is known, because it's either an all-day
-     * property or floating time, we will use the DateTimeZone argument to
-     * figure out the exact date.
-     *
-     * @param DateTimeZone $timeZone
-     *
-     * @return DateTimeImmutable[]
-     * @return \DateTime[]
-     */
-    public function getDateTimes(DateTimeZone $timeZone = null) {
-
-        // Does the property have a TZID?
-        $tzid = $this['TZID'];
-
-        if ($tzid) {
-            $timeZone = TimeZoneUtil::getTimeZone((string)$tzid, $this->root);
-        }
-
-        $dts = [];
-        foreach ($this->getParts() as $part) {
-            $dts[] = DateTimeParser::parse($part, $timeZone);
-        }
-        return $dts;
-
-    }
-
-    /**
-     * Sets the property as a DateTime object.
-     *
-     * @param DateTimeInterface $dt
-     * @param bool isFloating If set to true, timezones will be ignored.
-     *
-     * @return void
-     */
-    public function setDateTime(DateTimeInterface $dt, $isFloating = false) {
-
-        $this->setDateTimes([$dt], $isFloating);
-
-    }
-
-    /**
-     * Sets the property as multiple date-time objects.
-     *
-     * The first value will be used as a reference for the timezones, and all
-     * the otehr values will be adjusted for that timezone
-     *
-     * @param DateTimeInterface[] $dt
-     * @param bool isFloating If set to true, timezones will be ignored.
-     *
-     * @return void
-     */
-    public function setDateTimes(array $dt, $isFloating = false) {
-
-        $values = [];
-
-        if ($this->hasTime()) {
-
-            $tz = null;
-            $isUtc = false;
-
-            foreach ($dt as $d) {
-
-                if ($isFloating) {
-                    $values[] = $d->format('Ymd\\THis');
-                    continue;
-                }
-                if (is_null($tz)) {
-                    $tz = $d->getTimeZone();
-                    $isUtc = in_array($tz->getName(), ['UTC', 'GMT', 'Z', '+00:00']);
-                    if (!$isUtc) {
-                        $this->offsetSet('TZID', $tz->getName());
-                    }
-                } else {
-                    $d = $d->setTimeZone($tz);
-                }
-
-                if ($isUtc) {
-                    $values[] = $d->format('Ymd\\THis\\Z');
-                } else {
-                    $values[] = $d->format('Ymd\\THis');
-                }
-
-            }
-            if ($isUtc || $isFloating) {
-                $this->offsetUnset('TZID');
-            }
-
-        } else {
-
-            foreach ($dt as $d) {
-
-                $values[] = $d->format('Ymd');
-
-            }
-            $this->offsetUnset('TZID');
-
-        }
-
-        $this->value = $values;
-
-    }
-
-    /**
-     * Returns the type of value.
-     *
-     * This corresponds to the VALUE= parameter. Every property also has a
-     * 'default' valueType.
-     *
-     * @return string
-     */
-    public function getValueType() {
-
-        return $this->hasTime() ? 'DATE-TIME' : 'DATE';
-
-    }
-
-    /**
-     * Returns the value, in the format it should be encoded for JSON.
-     *
-     * This method must always return an array.
-     *
-     * @return array
-     */
-    public function getJsonValue() {
-
-        $dts = $this->getDateTimes();
-        $hasTime = $this->hasTime();
-        $isFloating = $this->isFloating();
-
-        $tz = $dts[0]->getTimeZone();
-        $isUtc = $isFloating ? false : in_array($tz->getName(), ['UTC', 'GMT', 'Z']);
-
-        return array_map(
-            function(DateTimeInterface $dt) use ($hasTime, $isUtc) {
-
-                if ($hasTime) {
-                    return $dt->format('Y-m-d\\TH:i:s') . ($isUtc ? 'Z' : '');
-                } else {
-                    return $dt->format('Y-m-d');
-                }
-
-            },
-            $dts
-        );
-
-    }
-
-    /**
-     * Sets the json value, as it would appear in a jCard or jCal object.
-     *
-     * The value must always be an array.
-     *
-     * @param array $value
-     *
-     * @return void
-     */
-    public function setJsonValue(array $value) {
-
-        // dates and times in jCal have one difference to dates and times in
-        // iCalendar. In jCal date-parts are separated by dashes, and
-        // time-parts are separated by colons. It makes sense to just remove
-        // those.
-        $this->setValue(
-            array_map(
-                public function($item) {
-
-                    return strtr($item, [':' => '', '-' => '']);
-
-                },
-                $value
-            )
-        );
-
-    }
-
-    /**
-     * We need to intercept offsetSet, because it may be used to alter the
-     * VALUE from DATE-TIME to DATE or vice-versa.
-     *
-     * @param string $name
-     * @param mixed $value
-     *
-     * @return void
-     */
-    public function offsetSet($name, $value) {
-
-        parent::offsetSet($name, $value);
-        if (strtoupper($name) !== 'VALUE') {
-            return;
-        }
-
-        // This will ensure that dates are correctly encoded.
-        $this->setDateTimes($this->getDateTimes());
-
-    }
-
-    /**
-     * Validates the node for correctness.
-     *
-     * The following options are supported:
-     *   Node::REPAIR - May attempt to automatically repair the problem.
-     *
-     * This method returns an array with detected problems.
-     * Every element has the following properties:
-     *
-     *  * level - problem level.
-     *  * message - A human-readable string describing the issue.
-     *  * node - A reference to the problematic node.
-     *
-     * The level means:
-     *   1 - The issue was repaired (only happens if REPAIR was turned on)
-     *   2 - An inconsequential issue
-     *   3 - A severe issue.
-     *
-     * @param int $options
-     *
-     * @return array
-     */
-    public function validate($options = 0) {
-
-        $messages = parent::validate($options);
-        $valueType = $this->getValueType();
-        $values = $this->getParts();
-        try {
-            foreach ($values as $value) {
-                switch ($valueType) {
-                    case 'DATE' :
-                        DateTimeParser::parseDate($value);
-                        break;
-                    case 'DATE-TIME' :
-                        DateTimeParser::parseDateTime($value);
-                        break;
-                }
-            }
-        } catch (InvalidDataException $e) {
-            $messages[] = [
-                'level'   => 3,
-                'message' => 'The supplied value (' . $value . ') is not a correct ' . $valueType,
-                'node'    => $this,
-            ];
-        }
-        return $messages;
-
-    }
+	/**
+	 * In case this is a multi-value property. This string will be used as a
+	 * delimiter.
+	 *
+	 * @var string|null
+	 */
+	public $delimiter = ',';
+
+	/**
+	 * Sets a multi-valued property.
+	 *
+	 * You may also specify DateTime objects here.
+	 *
+	 * @param array $parts
+	 *
+	 * @return void
+	 */
+	public function setParts(array $parts) {
+
+		if (isset($parts[0]) && $parts[0] instanceof DateTimeInterface) {
+			$this->setDateTimes($parts);
+		} else {
+			parent::setParts($parts);
+		}
+
+	}
+
+	/**
+	 * Updates the current value.
+	 *
+	 * This may be either a single, or multiple strings in an array.
+	 *
+	 * Instead of strings, you may also use DateTime here.
+	 *
+	 * @param string|array|DateTimeInterface $value
+	 *
+	 * @return void
+	 */
+	public function setValue($value) {
+
+		if (is_array($value) && isset($value[0]) && $value[0] instanceof DateTimeInterface) {
+			$this->setDateTimes($value);
+		} elseif ($value instanceof DateTimeInterface) {
+			$this->setDateTimes([$value]);
+		} else {
+			parent::setValue($value);
+		}
+
+	}
+
+	/**
+	 * Sets a raw value coming from a mimedir (iCalendar/vCard) file.
+	 *
+	 * This has been 'unfolded', so only 1 line will be passed. Unescaping is
+	 * not yet done, but parameters are not included.
+	 *
+	 * @param string $val
+	 *
+	 * @return void
+	 */
+	public function setRawMimeDirValue($val) {
+
+		$this->setValue(explode($this->delimiter, $val));
+
+	}
+
+	/**
+	 * Returns a raw mime-dir representation of the value.
+	 *
+	 * @return string
+	 */
+	public function getRawMimeDirValue() {
+
+		return implode($this->delimiter, $this->getParts());
+
+	}
+
+	/**
+	 * Returns true if this is a DATE-TIME value, false if it's a DATE.
+	 *
+	 * @return bool
+	 */
+	public function hasTime() {
+
+		return strtoupper((string)$this['VALUE']) !== 'DATE';
+
+	}
+
+	/**
+	 * Returns true if this is a floating DATE or DATE-TIME.
+	 *
+	 * Note that DATE is always floating.
+	 */
+	public function isFloating() {
+
+		return
+			!$this->hasTime() ||
+			(
+				!isset($this['TZID']) &&
+				strpos($this->getValue(), 'Z') === false
+			);
+
+	}
+
+	/**
+	 * Returns a date-time value.
+	 *
+	 * Note that if this property contained more than 1 date-time, only the
+	 * first will be returned. To get an array with multiple values, call
+	 * getDateTimes.
+	 *
+	 * If no timezone information is known, because it's either an all-day
+	 * property or floating time, we will use the DateTimeZone argument to
+	 * figure out the exact date.
+	 *
+	 * @param DateTimeZone $timeZone
+	 *
+	 * @return DateTimeImmutable
+	 */
+	public function getDateTime(DateTimeZone $timeZone = null) {
+
+		$dt = $this->getDateTimes($timeZone);
+		if (!$dt) return;
+
+		return $dt[0];
+
+	}
+
+	/**
+	 * Returns multiple date-time values.
+	 *
+	 * If no timezone information is known, because it's either an all-day
+	 * property or floating time, we will use the DateTimeZone argument to
+	 * figure out the exact date.
+	 *
+	 * @param DateTimeZone $timeZone
+	 *
+	 * @return DateTimeImmutable[]
+	 * @return \DateTime[]
+	 */
+	public function getDateTimes(DateTimeZone $timeZone = null) {
+
+		// Does the property have a TZID?
+		$tzid = $this['TZID'];
+
+		if ($tzid) {
+			$timeZone = TimeZoneUtil::getTimeZone((string)$tzid, $this->root);
+		}
+
+		$dts = [];
+		foreach ($this->getParts() as $part) {
+			$dts[] = DateTimeParser::parse($part, $timeZone);
+		}
+		return $dts;
+
+	}
+
+	/**
+	 * Sets the property as a DateTime object.
+	 *
+	 * @param DateTimeInterface $dt
+	 * @param bool isFloating If set to true, timezones will be ignored.
+	 *
+	 * @return void
+	 */
+	public function setDateTime(DateTimeInterface $dt, $isFloating = false) {
+
+		$this->setDateTimes([$dt], $isFloating);
+
+	}
+
+	/**
+	 * Sets the property as multiple date-time objects.
+	 *
+	 * The first value will be used as a reference for the timezones, and all
+	 * the otehr values will be adjusted for that timezone
+	 *
+	 * @param DateTimeInterface[] $dt
+	 * @param bool isFloating If set to true, timezones will be ignored.
+	 *
+	 * @return void
+	 */
+	public function setDateTimes(array $dt, $isFloating = false) {
+
+		$values = [];
+
+		if ($this->hasTime()) {
+
+			$tz = null;
+			$isUtc = false;
+
+			foreach ($dt as $d) {
+
+				if ($isFloating) {
+					$values[] = $d->format('Ymd\\THis');
+					continue;
+				}
+				if (is_null($tz)) {
+					$tz = $d->getTimeZone();
+					$isUtc = in_array($tz->getName(), ['UTC', 'GMT', 'Z', '+00:00']);
+					if (!$isUtc) {
+						$this->offsetSet('TZID', $tz->getName());
+					}
+				} else {
+					$d = $d->setTimeZone($tz);
+				}
+
+				if ($isUtc) {
+					$values[] = $d->format('Ymd\\THis\\Z');
+				} else {
+					$values[] = $d->format('Ymd\\THis');
+				}
+
+			}
+			if ($isUtc || $isFloating) {
+				$this->offsetUnset('TZID');
+			}
+
+		} else {
+
+			foreach ($dt as $d) {
+
+				$values[] = $d->format('Ymd');
+
+			}
+			$this->offsetUnset('TZID');
+
+		}
+
+		$this->value = $values;
+
+	}
+
+	/**
+	 * Returns the type of value.
+	 *
+	 * This corresponds to the VALUE= parameter. Every property also has a
+	 * 'default' valueType.
+	 *
+	 * @return string
+	 */
+	public function getValueType() {
+
+		return $this->hasTime() ? 'DATE-TIME' : 'DATE';
+
+	}
+
+	/**
+	 * Returns the value, in the format it should be encoded for JSON.
+	 *
+	 * This method must always return an array.
+	 *
+	 * @return array
+	 */
+	public function getJsonValue() {
+
+		$dts = $this->getDateTimes();
+		$hasTime = $this->hasTime();
+		$isFloating = $this->isFloating();
+
+		$tz = $dts[0]->getTimeZone();
+		$isUtc = $isFloating ? false : in_array($tz->getName(), ['UTC', 'GMT', 'Z']);
+
+		return array_map(
+			function(DateTimeInterface $dt) use ($hasTime, $isUtc) {
+
+				if ($hasTime) {
+					return $dt->format('Y-m-d\\TH:i:s') . ($isUtc ? 'Z' : '');
+				} else {
+					return $dt->format('Y-m-d');
+				}
+
+			},
+			$dts
+		);
+
+	}
+
+	/**
+	 * Sets the json value, as it would appear in a jCard or jCal object.
+	 *
+	 * The value must always be an array.
+	 *
+	 * @param array $value
+	 *
+	 * @return void
+	 */
+	public function setJsonValue(array $value) {
+
+		// dates and times in jCal have one difference to dates and times in
+		// iCalendar. In jCal date-parts are separated by dashes, and
+		// time-parts are separated by colons. It makes sense to just remove
+		// those.
+		$this->setValue(
+			array_map(
+				public function($item) {
+
+					return strtr($item, [':' => '', '-' => '']);
+
+				},
+				$value
+			)
+		);
+
+	}
+
+	/**
+	 * We need to intercept offsetSet, because it may be used to alter the
+	 * VALUE from DATE-TIME to DATE or vice-versa.
+	 *
+	 * @param string $name
+	 * @param mixed $value
+	 *
+	 * @return void
+	 */
+	public function offsetSet($name, $value) {
+
+		parent::offsetSet($name, $value);
+		if (strtoupper($name) !== 'VALUE') {
+			return;
+		}
+
+		// This will ensure that dates are correctly encoded.
+		$this->setDateTimes($this->getDateTimes());
+
+	}
+
+	/**
+	 * Validates the node for correctness.
+	 *
+	 * The following options are supported:
+	 *   Node::REPAIR - May attempt to automatically repair the problem.
+	 *
+	 * This method returns an array with detected problems.
+	 * Every element has the following properties:
+	 *
+	 *  * level - problem level.
+	 *  * message - A human-readable string describing the issue.
+	 *  * node - A reference to the problematic node.
+	 *
+	 * The level means:
+	 *   1 - The issue was repaired (only happens if REPAIR was turned on)
+	 *   2 - An inconsequential issue
+	 *   3 - A severe issue.
+	 *
+	 * @param int $options
+	 *
+	 * @return array
+	 */
+	public function validate($options = 0) {
+
+		$messages = parent::validate($options);
+		$valueType = $this->getValueType();
+		$values = $this->getParts();
+		try {
+			foreach ($values as $value) {
+				switch ($valueType) {
+					case 'DATE' :
+						DateTimeParser::parseDate($value);
+						break;
+					case 'DATE-TIME' :
+						DateTimeParser::parseDateTime($value);
+						break;
+				}
+			}
+		} catch (InvalidDataException $e) {
+			$messages[] = [
+				'level'   => 3,
+				'message' => 'The supplied value (' . $value . ') is not a correct ' . $valueType,
+				'node'    => $this,
+			];
+		}
+		return $messages;
+
+	}
 }

libraries/SabreDAV/VObject/Property/UtcOffset.php

Indentation +52 added lines, -52 removed lines

@@ -13,65 +13,65 @@
  */
 class UtcOffset extends Text {
 
-    /**
-     * In case this is a multi-value property. This string will be used as a
-     * delimiter.
-     *
-     * @var string|null
-     */
-    public $delimiter = null;
+	/**
+	 * In case this is a multi-value property. This string will be used as a
+	 * delimiter.
+	 *
+	 * @var string|null
+	 */
+	public $delimiter = null;
 
-    /**
-     * Returns the type of value.
-     *
-     * This corresponds to the VALUE= parameter. Every property also has a
-     * 'default' valueType.
-     *
-     * @return string
-     */
-    public function getValueType() {
+	/**
+	 * Returns the type of value.
+	 *
+	 * This corresponds to the VALUE= parameter. Every property also has a
+	 * 'default' valueType.
+	 *
+	 * @return string
+	 */
+	public function getValueType() {
 
-        return 'UTC-OFFSET';
+		return 'UTC-OFFSET';
 
-    }
+	}
 
-    /**
-     * Sets the JSON value, as it would appear in a jCard or jCal object.
-     *
-     * The value must always be an array.
-     *
-     * @param array $value
-     *
-     * @return void
-     */
-    public function setJsonValue(array $value) {
+	/**
+	 * Sets the JSON value, as it would appear in a jCard or jCal object.
+	 *
+	 * The value must always be an array.
+	 *
+	 * @param array $value
+	 *
+	 * @return void
+	 */
+	public function setJsonValue(array $value) {
 
-        $value = array_map(
-            function($value) {
-                return str_replace(':', '', $value);
-            },
-            $value
-        );
-        parent::setJsonValue($value);
+		$value = array_map(
+			function($value) {
+				return str_replace(':', '', $value);
+			},
+			$value
+		);
+		parent::setJsonValue($value);
 
-    }
+	}
 
-    /**
-     * Returns the value, in the format it should be encoded for JSON.
-     *
-     * This method must always return an array.
-     *
-     * @return array
-     */
-    public function getJsonValue() {
+	/**
+	 * Returns the value, in the format it should be encoded for JSON.
+	 *
+	 * This method must always return an array.
+	 *
+	 * @return array
+	 */
+	public function getJsonValue() {
 
-        return array_map(
-            public function($value) {
-                return substr($value, 0, -2) . ':' .
-                       substr($value, -2);
-            },
-            parent::getJsonValue()
-        );
+		return array_map(
+			public function($value) {
+				return substr($value, 0, -2) . ':' .
+					   substr($value, -2);
+			},
+			parent::getJsonValue()
+		);
 
-    }
+	}
 }

libraries/SabreDAV/VObject/Parser/Json.php

Indentation +175 added lines, -175 removed lines

@@ -18,180 +18,180 @@
  */
 class Json extends Parser {
 
-    /**
-     * The input data.
-     *
-     * @var array
-     */
-    protected $input;
-
-    /**
-     * Root component.
-     *
-     * @var Document
-     */
-    protected $root;
-
-    /**
-     * This method starts the parsing process.
-     *
-     * If the input was not supplied during construction, it's possible to pass
-     * it here instead.
-     *
-     * If either input or options are not supplied, the defaults will be used.
-     *
-     * @param resource|string|array|null $input
-     * @param int $options
-     *
-     * @return Sabre\VObject\Document
-     */
-    public function parse($input = null, $options = 0) {
-
-        if (!is_null($input)) {
-            $this->setInput($input);
-        }
-        if (is_null($this->input)) {
-            throw new EofException('End of input stream, or no input supplied');
-        }
-
-        if (0 !== $options) {
-            $this->options = $options;
-        }
-
-        switch ($this->input[0]) {
-            case 'vcalendar' :
-                $this->root = new VCalendar([], false);
-                break;
-            case 'vcard' :
-                $this->root = new VCard([], false);
-                break;
-            default :
-                throw new ParseException('The root component must either be a vcalendar, or a vcard');
-
-        }
-        foreach ($this->input[1] as $prop) {
-            $this->root->add($this->parseProperty($prop));
-        }
-        if (isset($this->input[2])) foreach ($this->input[2] as $comp) {
-            $this->root->add($this->parseComponent($comp));
-        }
-
-        // Resetting the input so we can throw an feof exception the next time.
-        $this->input = null;
-
-        return $this->root;
-
-    }
-
-    /**
-     * Parses a component.
-     *
-     * @param array $jComp
-     *
-     * @return \Sabre\VObject\Component
-     */
-    public function parseComponent(array $jComp) {
-
-        // We can remove $self from PHP 5.4 onward.
-        $self = $this;
-
-        $properties = array_map(
-            function($jProp) use ($self) {
-                return $self->parseProperty($jProp);
-            },
-            $jComp[1]
-        );
-
-        if (isset($jComp[2])) {
-
-            $components = array_map(
-                public function($jComp) use ($self) {
-                    return $self->parseComponent($jComp);
-                },
-                $jComp[2]
-            );
-
-        } else $components = [];
-
-        return $this->root->createComponent(
-            $jComp[0],
-            array_merge($properties, $components),
-            $defaults = false
-        );
-
-    }
-
-    /**
-     * Parses properties.
-     *
-     * @param array $jProp
-     *
-     * @return \Sabre\VObject\Property
-     */
-    public function parseProperty(array $jProp) {
-
-        list(
-            $propertyName,
-            $parameters,
-            $valueType
-        ) = $jProp;
-
-        $propertyName = strtoupper($propertyName);
-
-        // This is the default class we would be using if we didn't know the
-        // value type. We're using this value later in this function.
-        $defaultPropertyClass = $this->root->getClassNameForPropertyName($propertyName);
-
-        $parameters = (array)$parameters;
-
-        $value = array_slice($jProp, 3);
-
-        $valueType = strtoupper($valueType);
-
-        if (isset($parameters['group'])) {
-            $propertyName = $parameters['group'] . '.' . $propertyName;
-            unset($parameters['group']);
-        }
-
-        $prop = $this->root->createProperty($propertyName, null, $parameters, $valueType);
-        $prop->setJsonValue($value);
-
-        // We have to do something awkward here. FlatText as well as Text
-        // represents TEXT values. We have to normalize these here. In the
-        // future we can get rid of FlatText once we're allowed to break BC
-        // again.
-        if ($defaultPropertyClass === 'Sabre\VObject\Property\FlatText') {
-            $defaultPropertyClass = 'Sabre\VObject\Property\Text';
-        }
-
-        // If the value type we received (e.g.: TEXT) was not the default value
-        // type for the given property (e.g.: BDAY), we need to add a VALUE=
-        // parameter.
-        if ($defaultPropertyClass !== get_class($prop)) {
-            $prop["VALUE"] = $valueType;
-        }
-
-        return $prop;
-
-    }
-
-    /**
-     * Sets the input data.
-     *
-     * @param resource|string|array $input
-     *
-     * @return void
-     */
-    public function setInput($input) {
-
-        if (is_resource($input)) {
-            $input = stream_get_contents($input);
-        }
-        if (is_string($input)) {
-            $input = json_decode($input);
-        }
-        $this->input = $input;
-
-    }
+	/**
+	 * The input data.
+	 *
+	 * @var array
+	 */
+	protected $input;
+
+	/**
+	 * Root component.
+	 *
+	 * @var Document
+	 */
+	protected $root;
+
+	/**
+	 * This method starts the parsing process.
+	 *
+	 * If the input was not supplied during construction, it's possible to pass
+	 * it here instead.
+	 *
+	 * If either input or options are not supplied, the defaults will be used.
+	 *
+	 * @param resource|string|array|null $input
+	 * @param int $options
+	 *
+	 * @return Sabre\VObject\Document
+	 */
+	public function parse($input = null, $options = 0) {
+
+		if (!is_null($input)) {
+			$this->setInput($input);
+		}
+		if (is_null($this->input)) {
+			throw new EofException('End of input stream, or no input supplied');
+		}
+
+		if (0 !== $options) {
+			$this->options = $options;
+		}
+
+		switch ($this->input[0]) {
+			case 'vcalendar' :
+				$this->root = new VCalendar([], false);
+				break;
+			case 'vcard' :
+				$this->root = new VCard([], false);
+				break;
+			default :
+				throw new ParseException('The root component must either be a vcalendar, or a vcard');
+
+		}
+		foreach ($this->input[1] as $prop) {
+			$this->root->add($this->parseProperty($prop));
+		}
+		if (isset($this->input[2])) foreach ($this->input[2] as $comp) {
+			$this->root->add($this->parseComponent($comp));
+		}
+
+		// Resetting the input so we can throw an feof exception the next time.
+		$this->input = null;
+
+		return $this->root;
+
+	}
+
+	/**
+	 * Parses a component.
+	 *
+	 * @param array $jComp
+	 *
+	 * @return \Sabre\VObject\Component
+	 */
+	public function parseComponent(array $jComp) {
+
+		// We can remove $self from PHP 5.4 onward.
+		$self = $this;
+
+		$properties = array_map(
+			function($jProp) use ($self) {
+				return $self->parseProperty($jProp);
+			},
+			$jComp[1]
+		);
+
+		if (isset($jComp[2])) {
+
+			$components = array_map(
+				public function($jComp) use ($self) {
+					return $self->parseComponent($jComp);
+				},
+				$jComp[2]
+			);
+
+		} else $components = [];
+
+		return $this->root->createComponent(
+			$jComp[0],
+			array_merge($properties, $components),
+			$defaults = false
+		);
+
+	}
+
+	/**
+	 * Parses properties.
+	 *
+	 * @param array $jProp
+	 *
+	 * @return \Sabre\VObject\Property
+	 */
+	public function parseProperty(array $jProp) {
+
+		list(
+			$propertyName,
+			$parameters,
+			$valueType
+		) = $jProp;
+
+		$propertyName = strtoupper($propertyName);
+
+		// This is the default class we would be using if we didn't know the
+		// value type. We're using this value later in this function.
+		$defaultPropertyClass = $this->root->getClassNameForPropertyName($propertyName);
+
+		$parameters = (array)$parameters;
+
+		$value = array_slice($jProp, 3);
+
+		$valueType = strtoupper($valueType);
+
+		if (isset($parameters['group'])) {
+			$propertyName = $parameters['group'] . '.' . $propertyName;
+			unset($parameters['group']);
+		}
+
+		$prop = $this->root->createProperty($propertyName, null, $parameters, $valueType);
+		$prop->setJsonValue($value);
+
+		// We have to do something awkward here. FlatText as well as Text
+		// represents TEXT values. We have to normalize these here. In the
+		// future we can get rid of FlatText once we're allowed to break BC
+		// again.
+		if ($defaultPropertyClass === 'Sabre\VObject\Property\FlatText') {
+			$defaultPropertyClass = 'Sabre\VObject\Property\Text';
+		}
+
+		// If the value type we received (e.g.: TEXT) was not the default value
+		// type for the given property (e.g.: BDAY), we need to add a VALUE=
+		// parameter.
+		if ($defaultPropertyClass !== get_class($prop)) {
+			$prop["VALUE"] = $valueType;
+		}
+
+		return $prop;
+
+	}
+
+	/**
+	 * Sets the input data.
+	 *
+	 * @param resource|string|array $input
+	 *
+	 * @return void
+	 */
+	public function setInput($input) {
+
+		if (is_resource($input)) {
+			$input = stream_get_contents($input);
+		}
+		if (is_string($input)) {
+			$input = json_decode($input);
+		}
+		$this->input = $input;
+
+	}
 
 }

libraries/SabreDAV/VObject/Component.php

Indentation +680 added lines, -680 removed lines

@@ -16,685 +16,685 @@
  */
 class Component extends Node {
 
-    /**
-     * Component name.
-     *
-     * This will contain a string such as VEVENT, VTODO, VCALENDAR, VCARD.
-     *
-     * @var string
-     */
-    public $name;
-
-    /**
-     * A list of properties and/or sub-components.
-     *
-     * @var array
-     */
-    protected $children = [];
-
-    /**
-     * Creates a new component.
-     *
-     * You can specify the children either in key=>value syntax, in which case
-     * properties will automatically be created, or you can just pass a list of
-     * Component and Property object.
-     *
-     * By default, a set of sensible values will be added to the component. For
-     * an iCalendar object, this may be something like CALSCALE:GREGORIAN. To
-     * ensure that this does not happen, set $defaults to false.
-     *
-     * @param Document $root
-     * @param string $name such as VCALENDAR, VEVENT.
-     * @param array $children
-     * @param bool $defaults
-     *
-     * @return void
-     */
-    public function __construct(Document $root, $name, array $children = [], $defaults = true) {
-
-        $this->name = strtoupper($name);
-        $this->root = $root;
-
-        if ($defaults) {
-            // This is a terribly convoluted way to do this, but this ensures
-            // that the order of properties as they are specified in both
-            // defaults and the childrens list, are inserted in the object in a
-            // natural way.
-            $list = $this->getDefaults();
-            $nodes = [];
-            foreach ($children as $key => $value) {
-                if ($value instanceof Node) {
-                    if (isset($list[$value->name])) {
-                        unset($list[$value->name]);
-                    }
-                    $nodes[] = $value;
-                } else {
-                    $list[$key] = $value;
-                }
-            }
-            foreach ($list as $key => $value) {
-                $this->add($key, $value);
-            }
-            foreach ($nodes as $node) {
-                $this->add($node);
-            }
-        } else {
-            foreach ($children as $k => $child) {
-                if ($child instanceof Node) {
-                    // Component or Property
-                    $this->add($child);
-                } else {
-
-                    // Property key=>value
-                    $this->add($k, $child);
-                }
-            }
-        }
-
-    }
-
-    /**
-     * Adds a new property or component, and returns the new item.
-     *
-     * This method has 3 possible signatures:
-     *
-     * add(Component $comp) // Adds a new component
-     * add(Property $prop)  // Adds a new property
-     * add($name, $value, array $parameters = []) // Adds a new property
-     * add($name, array $children = []) // Adds a new component
-     * by name.
-     *
-     * @return Node
-     */
-    public function add() {
-
-        $arguments = func_get_args();
-
-        if ($arguments[0] instanceof Node) {
-            if (isset($arguments[1])) {
-                throw new \InvalidArgumentException('The second argument must not be specified, when passing a VObject Node');
-            }
-            $arguments[0]->parent = $this;
-            $newNode = $arguments[0];
-
-        } elseif (is_string($arguments[0])) {
-
-            $newNode = call_user_func_array([$this->root, 'create'], $arguments);
-
-        } else {
-
-            throw new \InvalidArgumentException('The first argument must either be a \\Sabre\\VObject\\Node or a string');
-
-        }
-
-        $name = $newNode->name;
-        if (isset($this->children[$name])) {
-            $this->children[$name][] = $newNode;
-        } else {
-            $this->children[$name] = [$newNode];
-        }
-        return $newNode;
-
-    }
-
-    /**
-     * This method removes a component or property from this component.
-     *
-     * You can either specify the item by name (like DTSTART), in which case
-     * all properties/components with that name will be removed, or you can
-     * pass an instance of a property or component, in which case only that
-     * exact item will be removed.
-     *
-     * @param string|Property|Component $item
-     * @return void
-     */
-    public function remove($item) {
-
-        if (is_string($item)) {
-            // If there's no dot in the name, it's an exact property name and
-            // we can just wipe out all those properties.
-            //
-            if (strpos($item, '.') === false) {
-                unset($this->children[strtoupper($item)]);
-                return;
-            }
-            // If there was a dot, we need to ask select() to help us out and
-            // then we just call remove recursively.
-            foreach ($this->select($item) as $child) {
-
-                $this->remove($child);
-
-            }
-        } else {
-            foreach ($this->select($item->name) as $k => $child) {
-                if ($child === $item) {
-                    unset($this->children[$item->name][$k]);
-                    return;
-                }
-            }
-        }
-
-        throw new \InvalidArgumentException('The item you passed to remove() was not a child of this component');
-
-    }
-
-    /**
-     * Returns a flat list of all the properties and components in this
-     * component.
-     *
-     * @return array
-     */
-    public function children() {
-
-        $result = [];
-        foreach ($this->children as $childGroup) {
-            $result = array_merge($result, $childGroup);
-        }
-        return $result;
-
-    }
-
-    /**
-     * This method only returns a list of sub-components. Properties are
-     * ignored.
-     *
-     * @return array
-     */
-    public function getComponents() {
-
-        $result = [];
-
-        foreach ($this->children as $childGroup) {
-            foreach ($childGroup as $child) {
-                if ($child instanceof self) {
-                    $result[] = $child;
-                }
-            }
-        }
-        return $result;
-
-    }
-
-    /**
-     * Returns an array with elements that match the specified name.
-     *
-     * This function is also aware of MIME-Directory groups (as they appear in
-     * vcards). This means that if a property is grouped as "HOME.EMAIL", it
-     * will also be returned when searching for just "EMAIL". If you want to
-     * search for a property in a specific group, you can select on the entire
-     * string ("HOME.EMAIL"). If you want to search on a specific property that
-     * has not been assigned a group, specify ".EMAIL".
-     *
-     * @param string $name
-     * @return array
-     */
-    public function select($name) {
-
-        $group = null;
-        $name = strtoupper($name);
-        if (strpos($name, '.') !== false) {
-            list($group, $name) = explode('.', $name, 2);
-        }
-        if ($name === '') $name = null;
-
-        if (!is_null($name)) {
-
-            $result = isset($this->children[$name]) ? $this->children[$name] : [];
-
-            if (is_null($group)) {
-                return $result;
-            } else {
-                // If we have a group filter as well, we need to narrow it down
-                // more.
-                return array_filter(
-                    $result,
-                    function($child) use ($group) {
-
-                        return $child instanceof Property && strtoupper($child->group) === $group;
-
-                    }
-                );
-            }
-
-        }
-
-        // If we got to this point, it means there was no 'name' specified for
-        // searching, implying that this is a group-only search.
-        $result = [];
-        foreach ($this->children as $childGroup) {
-
-            foreach ($childGroup as $child) {
-
-                if ($child instanceof Property && strtoupper($child->group) === $group) {
-                    $result[] = $child;
-                }
-
-            }
-
-        }
-        return $result;
-
-    }
-
-    /**
-     * Turns the object back into a serialized blob.
-     *
-     * @return string
-     */
-    public function serialize() {
-
-        $str = "BEGIN:" . $this->name . "\r\n";
-
-        /**
-         * Gives a component a 'score' for sorting purposes.
-         *
-         * This is solely used by the childrenSort method.
-         *
-         * A higher score means the item will be lower in the list.
-         * To avoid score collisions, each "score category" has a reasonable
-         * space to accomodate elements. The $key is added to the $score to
-         * preserve the original relative order of elements.
-         *
-         * @param int $key
-         * @param array $array
-         *
-         * @return int
-         */
-        $sortScore = function($key, $array) {
-
-            if ($array[$key] instanceof Component) {
-
-                // We want to encode VTIMEZONE first, this is a personal
-                // preference.
-                if ($array[$key]->name === 'VTIMEZONE') {
-                    $score = 300000000;
-                    return $score + $key;
-                } else {
-                    $score = 400000000;
-                    return $score + $key;
-                }
-            } else {
-                // Properties get encoded first
-                // VCARD version 4.0 wants the VERSION property to appear first
-                if ($array[$key] instanceof Property) {
-                    if ($array[$key]->name === 'VERSION') {
-                        $score = 100000000;
-                        return $score + $key;
-                    } else {
-                        // All other properties
-                        $score = 200000000;
-                        return $score + $key;
-                    }
-                }
-            }
-
-        };
-
-        $children = $this->children();
-        $tmp = $children;
-        uksort(
-            $children,
-           function($a, $b) use ($sortScore, $tmp) {
-
-                $sA = $sortScore($a, $tmp);
-                $sB = $sortScore($b, $tmp);
-
-                return $sA - $sB;
-
-            }
-        );
-
-        foreach ($children as $child) $str .= $child->serialize();
-        $str .= "END:" . $this->name . "\r\n";
-
-        return $str;
-
-    }
-
-    /**
-     * This method returns an array, with the representation as it should be
-     * encoded in JSON. This is used to create jCard or jCal documents.
-     *
-     * @return array
-     */
-    public function jsonSerialize() {
-
-        $components = [];
-        $properties = [];
-
-        foreach ($this->children as $childGroup) {
-            foreach ($childGroup as $child) {
-                if ($child instanceof self) {
-                    $components[] = $child->jsonSerialize();
-                } else {
-                    $properties[] = $child->jsonSerialize();
-                }
-            }
-        }
-
-        return [
-            strtolower($this->name),
-            $properties,
-            $components
-        ];
-
-    }
-
-    /**
-     * This method serializes the data into XML. This is used to create xCard or
-     * xCal documents.
-     *
-     * @param Xml\Writer $writer  XML writer.
-     *
-     * @return void
-     */
-    public function xmlSerialize(Xml\Writer $writer) {
-
-        $components = [];
-        $properties = [];
-
-        foreach ($this->children as $childGroup) {
-            foreach ($childGroup as $child) {
-                if ($child instanceof self) {
-                    $components[] = $child;
-                } else {
-                    $properties[] = $child;
-                }
-            }
-        }
-
-        $writer->startElement(strtolower($this->name));
-
-        if (!empty($properties)) {
-
-            $writer->startElement('properties');
-
-            foreach ($properties as $property) {
-                $property->xmlSerialize($writer);
-            }
-
-            $writer->endElement();
-
-        }
-
-        if (!empty($components)) {
-
-            $writer->startElement('components');
-
-            foreach ($components as $component) {
-                $component->xmlSerialize($writer);
-            }
-
-            $writer->endElement();
-        }
-
-        $writer->endElement();
-
-    }
-
-    /**
-     * This method should return a list of default property values.
-     *
-     * @return array
-     */
-    protected function getDefaults() {
-
-        return [];
-
-    }
-
-    /* Magic property accessors {{{ */
-
-    /**
-     * Using 'get' you will either get a property or component.
-     *
-     * If there were no child-elements found with the specified name,
-     * null is returned.
-     *
-     * To use this, this may look something like this:
-     *
-     * $event = $calendar->VEVENT;
-     *
-     * @param string $name
-     *
-     * @return Property
-     */
-    public function __get($name) {
-
-        if ($name === 'children') {
-
-            throw new \RuntimeException('Starting sabre/vobject 4.0 the children property is now protected. You should use the children() method instead');
-
-        }
-
-        $matches = $this->select($name);
-        if (count($matches) === 0) {
-            return;
-        } else {
-            $firstMatch = current($matches);
-            /** @var $firstMatch Property */
-            $firstMatch->setIterator(new ElementList(array_values($matches)));
-            return $firstMatch;
-        }
-
-    }
-
-    /**
-     * This method checks if a sub-element with the specified name exists.
-     *
-     * @param string $name
-     *
-     * @return bool
-     */
-    public function __isset($name) {
-
-        $matches = $this->select($name);
-        return count($matches) > 0;
-
-    }
-
-    /**
-     * Using the setter method you can add properties or subcomponents.
-     *
-     * You can either pass a Component, Property
-     * object, or a string to automatically create a Property.
-     *
-     * If the item already exists, it will be removed. If you want to add
-     * a new item with the same name, always use the add() method.
-     *
-     * @param string $name
-     * @param mixed $value
-     *
-     * @return void
-     */
-    public function __set($name, $value) {
-
-        $name = strtoupper($name);
-        $this->remove($name);
-        if ($value instanceof self || $value instanceof Property) {
-            $this->add($value);
-        } else {
-            $this->add($name, $value);
-        }
-    }
-
-    /**
-     * Removes all properties and components within this component with the
-     * specified name.
-     *
-     * @param string $name
-     *
-     * @return void
-     */
-    public function __unset($name) {
-
-        $this->remove($name);
-
-    }
-
-    /* }}} */
-
-    /**
-     * This method is automatically called when the object is cloned.
-     * Specifically, this will ensure all child elements are also cloned.
-     *
-     * @return void
-     */
-    public function __clone() {
-
-        foreach ($this->children as $childName => $childGroup) {
-            foreach ($childGroup as $key => $child) {
-                $clonedChild = clone $child;
-                $clonedChild->parent = $this;
-                $clonedChild->root = $this->root;
-                $this->children[$childName][$key] = $clonedChild;
-            }
-        }
-
-    }
-
-    /**
-     * A simple list of validation rules.
-     *
-     * This is simply a list of properties, and how many times they either
-     * must or must not appear.
-     *
-     * Possible values per property:
-     *   * 0 - Must not appear.
-     *   * 1 - Must appear exactly once.
-     *   * + - Must appear at least once.
-     *   * * - Can appear any number of times.
-     *   * ? - May appear, but not more than once.
-     *
-     * It is also possible to specify defaults and severity levels for
-     * violating the rule.
-     *
-     * See the VEVENT implementation for getValidationRules for a more complex
-     * example.
-     *
-     * @var array
-     */
-    public function getValidationRules() {
-
-        return [];
-
-    }
-
-    /**
-     * Validates the node for correctness.
-     *
-     * The following options are supported:
-     *   Node::REPAIR - May attempt to automatically repair the problem.
-     *   Node::PROFILE_CARDDAV - Validate the vCard for CardDAV purposes.
-     *   Node::PROFILE_CALDAV - Validate the iCalendar for CalDAV purposes.
-     *
-     * This method returns an array with detected problems.
-     * Every element has the following properties:
-     *
-     *  * level - problem level.
-     *  * message - A human-readable string describing the issue.
-     *  * node - A reference to the problematic node.
-     *
-     * The level means:
-     *   1 - The issue was repaired (only happens if REPAIR was turned on).
-     *   2 - A warning.
-     *   3 - An error.
-     *
-     * @param int $options
-     *
-     * @return array
-     */
-    public function validate($options = 0) {
-
-        $rules = $this->getValidationRules();
-        $defaults = $this->getDefaults();
-
-        $propertyCounters = [];
-
-        $messages = [];
-
-        foreach ($this->children() as $child) {
-            $name = strtoupper($child->name);
-            if (!isset($propertyCounters[$name])) {
-                $propertyCounters[$name] = 1;
-            } else {
-                $propertyCounters[$name]++;
-            }
-            $messages = array_merge($messages, $child->validate($options));
-        }
-
-        foreach ($rules as $propName => $rule) {
-
-            switch ($rule) {
-                case '0' :
-                    if (isset($propertyCounters[$propName])) {
-                        $messages[] = [
-                            'level'   => 3,
-                            'message' => $propName . ' MUST NOT appear in a ' . $this->name . ' component',
-                            'node'    => $this,
-                        ];
-                    }
-                    break;
-                case '1' :
-                    if (!isset($propertyCounters[$propName]) || $propertyCounters[$propName] !== 1) {
-                        $repaired = false;
-                        if ($options & self::REPAIR && isset($defaults[$propName])) {
-                            $this->add($propName, $defaults[$propName]);
-                            $repaired = true;
-                        }
-                        $messages[] = [
-                            'level'   => $repaired ? 1 : 3,
-                            'message' => $propName . ' MUST appear exactly once in a ' . $this->name . ' component',
-                            'node'    => $this,
-                        ];
-                    }
-                    break;
-                case '+' :
-                    if (!isset($propertyCounters[$propName]) || $propertyCounters[$propName] < 1) {
-                        $messages[] = [
-                            'level'   => 3,
-                            'message' => $propName . ' MUST appear at least once in a ' . $this->name . ' component',
-                            'node'    => $this,
-                        ];
-                    }
-                    break;
-                case '*' :
-                    break;
-                case '?' :
-                    if (isset($propertyCounters[$propName]) && $propertyCounters[$propName] > 1) {
-                        $messages[] = [
-                            'level'   => 3,
-                            'message' => $propName . ' MUST NOT appear more than once in a ' . $this->name . ' component',
-                            'node'    => $this,
-                        ];
-                    }
-                    break;
-
-            }
-
-        }
-        return $messages;
-
-    }
-
-    /**
-     * Call this method on a document if you're done using it.
-     *
-     * It's intended to remove all circular references, so PHP can easily clean
-     * it up.
-     *
-     * @return void
-     */
-    public function destroy() {
-
-        parent::destroy();
-        foreach ($this->children as $childGroup) {
-            foreach ($childGroup as $child) {
-                $child->destroy();
-            }
-        }
-        $this->children = [];
-
-    }
+	/**
+	 * Component name.
+	 *
+	 * This will contain a string such as VEVENT, VTODO, VCALENDAR, VCARD.
+	 *
+	 * @var string
+	 */
+	public $name;
+
+	/**
+	 * A list of properties and/or sub-components.
+	 *
+	 * @var array
+	 */
+	protected $children = [];
+
+	/**
+	 * Creates a new component.
+	 *
+	 * You can specify the children either in key=>value syntax, in which case
+	 * properties will automatically be created, or you can just pass a list of
+	 * Component and Property object.
+	 *
+	 * By default, a set of sensible values will be added to the component. For
+	 * an iCalendar object, this may be something like CALSCALE:GREGORIAN. To
+	 * ensure that this does not happen, set $defaults to false.
+	 *
+	 * @param Document $root
+	 * @param string $name such as VCALENDAR, VEVENT.
+	 * @param array $children
+	 * @param bool $defaults
+	 *
+	 * @return void
+	 */
+	public function __construct(Document $root, $name, array $children = [], $defaults = true) {
+
+		$this->name = strtoupper($name);
+		$this->root = $root;
+
+		if ($defaults) {
+			// This is a terribly convoluted way to do this, but this ensures
+			// that the order of properties as they are specified in both
+			// defaults and the childrens list, are inserted in the object in a
+			// natural way.
+			$list = $this->getDefaults();
+			$nodes = [];
+			foreach ($children as $key => $value) {
+				if ($value instanceof Node) {
+					if (isset($list[$value->name])) {
+						unset($list[$value->name]);
+					}
+					$nodes[] = $value;
+				} else {
+					$list[$key] = $value;
+				}
+			}
+			foreach ($list as $key => $value) {
+				$this->add($key, $value);
+			}
+			foreach ($nodes as $node) {
+				$this->add($node);
+			}
+		} else {
+			foreach ($children as $k => $child) {
+				if ($child instanceof Node) {
+					// Component or Property
+					$this->add($child);
+				} else {
+
+					// Property key=>value
+					$this->add($k, $child);
+				}
+			}
+		}
+
+	}
+
+	/**
+	 * Adds a new property or component, and returns the new item.
+	 *
+	 * This method has 3 possible signatures:
+	 *
+	 * add(Component $comp) // Adds a new component
+	 * add(Property $prop)  // Adds a new property
+	 * add($name, $value, array $parameters = []) // Adds a new property
+	 * add($name, array $children = []) // Adds a new component
+	 * by name.
+	 *
+	 * @return Node
+	 */
+	public function add() {
+
+		$arguments = func_get_args();
+
+		if ($arguments[0] instanceof Node) {
+			if (isset($arguments[1])) {
+				throw new \InvalidArgumentException('The second argument must not be specified, when passing a VObject Node');
+			}
+			$arguments[0]->parent = $this;
+			$newNode = $arguments[0];
+
+		} elseif (is_string($arguments[0])) {
+
+			$newNode = call_user_func_array([$this->root, 'create'], $arguments);
+
+		} else {
+
+			throw new \InvalidArgumentException('The first argument must either be a \\Sabre\\VObject\\Node or a string');
+
+		}
+
+		$name = $newNode->name;
+		if (isset($this->children[$name])) {
+			$this->children[$name][] = $newNode;
+		} else {
+			$this->children[$name] = [$newNode];
+		}
+		return $newNode;
+
+	}
+
+	/**
+	 * This method removes a component or property from this component.
+	 *
+	 * You can either specify the item by name (like DTSTART), in which case
+	 * all properties/components with that name will be removed, or you can
+	 * pass an instance of a property or component, in which case only that
+	 * exact item will be removed.
+	 *
+	 * @param string|Property|Component $item
+	 * @return void
+	 */
+	public function remove($item) {
+
+		if (is_string($item)) {
+			// If there's no dot in the name, it's an exact property name and
+			// we can just wipe out all those properties.
+			//
+			if (strpos($item, '.') === false) {
+				unset($this->children[strtoupper($item)]);
+				return;
+			}
+			// If there was a dot, we need to ask select() to help us out and
+			// then we just call remove recursively.
+			foreach ($this->select($item) as $child) {
+
+				$this->remove($child);
+
+			}
+		} else {
+			foreach ($this->select($item->name) as $k => $child) {
+				if ($child === $item) {
+					unset($this->children[$item->name][$k]);
+					return;
+				}
+			}
+		}
+
+		throw new \InvalidArgumentException('The item you passed to remove() was not a child of this component');
+
+	}
+
+	/**
+	 * Returns a flat list of all the properties and components in this
+	 * component.
+	 *
+	 * @return array
+	 */
+	public function children() {
+
+		$result = [];
+		foreach ($this->children as $childGroup) {
+			$result = array_merge($result, $childGroup);
+		}
+		return $result;
+
+	}
+
+	/**
+	 * This method only returns a list of sub-components. Properties are
+	 * ignored.
+	 *
+	 * @return array
+	 */
+	public function getComponents() {
+
+		$result = [];
+
+		foreach ($this->children as $childGroup) {
+			foreach ($childGroup as $child) {
+				if ($child instanceof self) {
+					$result[] = $child;
+				}
+			}
+		}
+		return $result;
+
+	}
+
+	/**
+	 * Returns an array with elements that match the specified name.
+	 *
+	 * This function is also aware of MIME-Directory groups (as they appear in
+	 * vcards). This means that if a property is grouped as "HOME.EMAIL", it
+	 * will also be returned when searching for just "EMAIL". If you want to
+	 * search for a property in a specific group, you can select on the entire
+	 * string ("HOME.EMAIL"). If you want to search on a specific property that
+	 * has not been assigned a group, specify ".EMAIL".
+	 *
+	 * @param string $name
+	 * @return array
+	 */
+	public function select($name) {
+
+		$group = null;
+		$name = strtoupper($name);
+		if (strpos($name, '.') !== false) {
+			list($group, $name) = explode('.', $name, 2);
+		}
+		if ($name === '') $name = null;
+
+		if (!is_null($name)) {
+
+			$result = isset($this->children[$name]) ? $this->children[$name] : [];
+
+			if (is_null($group)) {
+				return $result;
+			} else {
+				// If we have a group filter as well, we need to narrow it down
+				// more.
+				return array_filter(
+					$result,
+					function($child) use ($group) {
+
+						return $child instanceof Property && strtoupper($child->group) === $group;
+
+					}
+				);
+			}
+
+		}
+
+		// If we got to this point, it means there was no 'name' specified for
+		// searching, implying that this is a group-only search.
+		$result = [];
+		foreach ($this->children as $childGroup) {
+
+			foreach ($childGroup as $child) {
+
+				if ($child instanceof Property && strtoupper($child->group) === $group) {
+					$result[] = $child;
+				}
+
+			}
+
+		}
+		return $result;
+
+	}
+
+	/**
+	 * Turns the object back into a serialized blob.
+	 *
+	 * @return string
+	 */
+	public function serialize() {
+
+		$str = "BEGIN:" . $this->name . "\r\n";
+
+		/**
+		 * Gives a component a 'score' for sorting purposes.
+		 *
+		 * This is solely used by the childrenSort method.
+		 *
+		 * A higher score means the item will be lower in the list.
+		 * To avoid score collisions, each "score category" has a reasonable
+		 * space to accomodate elements. The $key is added to the $score to
+		 * preserve the original relative order of elements.
+		 *
+		 * @param int $key
+		 * @param array $array
+		 *
+		 * @return int
+		 */
+		$sortScore = function($key, $array) {
+
+			if ($array[$key] instanceof Component) {
+
+				// We want to encode VTIMEZONE first, this is a personal
+				// preference.
+				if ($array[$key]->name === 'VTIMEZONE') {
+					$score = 300000000;
+					return $score + $key;
+				} else {
+					$score = 400000000;
+					return $score + $key;
+				}
+			} else {
+				// Properties get encoded first
+				// VCARD version 4.0 wants the VERSION property to appear first
+				if ($array[$key] instanceof Property) {
+					if ($array[$key]->name === 'VERSION') {
+						$score = 100000000;
+						return $score + $key;
+					} else {
+						// All other properties
+						$score = 200000000;
+						return $score + $key;
+					}
+				}
+			}
+
+		};
+
+		$children = $this->children();
+		$tmp = $children;
+		uksort(
+			$children,
+		   function($a, $b) use ($sortScore, $tmp) {
+
+				$sA = $sortScore($a, $tmp);
+				$sB = $sortScore($b, $tmp);
+
+				return $sA - $sB;
+
+			}
+		);
+
+		foreach ($children as $child) $str .= $child->serialize();
+		$str .= "END:" . $this->name . "\r\n";
+
+		return $str;
+
+	}
+
+	/**
+	 * This method returns an array, with the representation as it should be
+	 * encoded in JSON. This is used to create jCard or jCal documents.
+	 *
+	 * @return array
+	 */
+	public function jsonSerialize() {
+
+		$components = [];
+		$properties = [];
+
+		foreach ($this->children as $childGroup) {
+			foreach ($childGroup as $child) {
+				if ($child instanceof self) {
+					$components[] = $child->jsonSerialize();
+				} else {
+					$properties[] = $child->jsonSerialize();
+				}
+			}
+		}
+
+		return [
+			strtolower($this->name),
+			$properties,
+			$components
+		];
+
+	}
+
+	/**
+	 * This method serializes the data into XML. This is used to create xCard or
+	 * xCal documents.
+	 *
+	 * @param Xml\Writer $writer  XML writer.
+	 *
+	 * @return void
+	 */
+	public function xmlSerialize(Xml\Writer $writer) {
+
+		$components = [];
+		$properties = [];
+
+		foreach ($this->children as $childGroup) {
+			foreach ($childGroup as $child) {
+				if ($child instanceof self) {
+					$components[] = $child;
+				} else {
+					$properties[] = $child;
+				}
+			}
+		}
+
+		$writer->startElement(strtolower($this->name));
+
+		if (!empty($properties)) {
+
+			$writer->startElement('properties');
+
+			foreach ($properties as $property) {
+				$property->xmlSerialize($writer);
+			}
+
+			$writer->endElement();
+
+		}
+
+		if (!empty($components)) {
+
+			$writer->startElement('components');
+
+			foreach ($components as $component) {
+				$component->xmlSerialize($writer);
+			}
+
+			$writer->endElement();
+		}
+
+		$writer->endElement();
+
+	}
+
+	/**
+	 * This method should return a list of default property values.
+	 *
+	 * @return array
+	 */
+	protected function getDefaults() {
+
+		return [];
+
+	}
+
+	/* Magic property accessors {{{ */
+
+	/**
+	 * Using 'get' you will either get a property or component.
+	 *
+	 * If there were no child-elements found with the specified name,
+	 * null is returned.
+	 *
+	 * To use this, this may look something like this:
+	 *
+	 * $event = $calendar->VEVENT;
+	 *
+	 * @param string $name
+	 *
+	 * @return Property
+	 */
+	public function __get($name) {
+
+		if ($name === 'children') {
+
+			throw new \RuntimeException('Starting sabre/vobject 4.0 the children property is now protected. You should use the children() method instead');
+
+		}
+
+		$matches = $this->select($name);
+		if (count($matches) === 0) {
+			return;
+		} else {
+			$firstMatch = current($matches);
+			/** @var $firstMatch Property */
+			$firstMatch->setIterator(new ElementList(array_values($matches)));
+			return $firstMatch;
+		}
+
+	}
+
+	/**
+	 * This method checks if a sub-element with the specified name exists.
+	 *
+	 * @param string $name
+	 *
+	 * @return bool
+	 */
+	public function __isset($name) {
+
+		$matches = $this->select($name);
+		return count($matches) > 0;
+
+	}
+
+	/**
+	 * Using the setter method you can add properties or subcomponents.
+	 *
+	 * You can either pass a Component, Property
+	 * object, or a string to automatically create a Property.
+	 *
+	 * If the item already exists, it will be removed. If you want to add
+	 * a new item with the same name, always use the add() method.
+	 *
+	 * @param string $name
+	 * @param mixed $value
+	 *
+	 * @return void
+	 */
+	public function __set($name, $value) {
+
+		$name = strtoupper($name);
+		$this->remove($name);
+		if ($value instanceof self || $value instanceof Property) {
+			$this->add($value);
+		} else {
+			$this->add($name, $value);
+		}
+	}
+
+	/**
+	 * Removes all properties and components within this component with the
+	 * specified name.
+	 *
+	 * @param string $name
+	 *
+	 * @return void
+	 */
+	public function __unset($name) {
+
+		$this->remove($name);
+
+	}
+
+	/* }}} */
+
+	/**
+	 * This method is automatically called when the object is cloned.
+	 * Specifically, this will ensure all child elements are also cloned.
+	 *
+	 * @return void
+	 */
+	public function __clone() {
+
+		foreach ($this->children as $childName => $childGroup) {
+			foreach ($childGroup as $key => $child) {
+				$clonedChild = clone $child;
+				$clonedChild->parent = $this;
+				$clonedChild->root = $this->root;
+				$this->children[$childName][$key] = $clonedChild;
+			}
+		}
+
+	}
+
+	/**
+	 * A simple list of validation rules.
+	 *
+	 * This is simply a list of properties, and how many times they either
+	 * must or must not appear.
+	 *
+	 * Possible values per property:
+	 *   * 0 - Must not appear.
+	 *   * 1 - Must appear exactly once.
+	 *   * + - Must appear at least once.
+	 *   * * - Can appear any number of times.
+	 *   * ? - May appear, but not more than once.
+	 *
+	 * It is also possible to specify defaults and severity levels for
+	 * violating the rule.
+	 *
+	 * See the VEVENT implementation for getValidationRules for a more complex
+	 * example.
+	 *
+	 * @var array
+	 */
+	public function getValidationRules() {
+
+		return [];
+
+	}
+
+	/**
+	 * Validates the node for correctness.
+	 *
+	 * The following options are supported:
+	 *   Node::REPAIR - May attempt to automatically repair the problem.
+	 *   Node::PROFILE_CARDDAV - Validate the vCard for CardDAV purposes.
+	 *   Node::PROFILE_CALDAV - Validate the iCalendar for CalDAV purposes.
+	 *
+	 * This method returns an array with detected problems.
+	 * Every element has the following properties:
+	 *
+	 *  * level - problem level.
+	 *  * message - A human-readable string describing the issue.
+	 *  * node - A reference to the problematic node.
+	 *
+	 * The level means:
+	 *   1 - The issue was repaired (only happens if REPAIR was turned on).
+	 *   2 - A warning.
+	 *   3 - An error.
+	 *
+	 * @param int $options
+	 *
+	 * @return array
+	 */
+	public function validate($options = 0) {
+
+		$rules = $this->getValidationRules();
+		$defaults = $this->getDefaults();
+
+		$propertyCounters = [];
+
+		$messages = [];
+
+		foreach ($this->children() as $child) {
+			$name = strtoupper($child->name);
+			if (!isset($propertyCounters[$name])) {
+				$propertyCounters[$name] = 1;
+			} else {
+				$propertyCounters[$name]++;
+			}
+			$messages = array_merge($messages, $child->validate($options));
+		}
+
+		foreach ($rules as $propName => $rule) {
+
+			switch ($rule) {
+				case '0' :
+					if (isset($propertyCounters[$propName])) {
+						$messages[] = [
+							'level'   => 3,
+							'message' => $propName . ' MUST NOT appear in a ' . $this->name . ' component',
+							'node'    => $this,
+						];
+					}
+					break;
+				case '1' :
+					if (!isset($propertyCounters[$propName]) || $propertyCounters[$propName] !== 1) {
+						$repaired = false;
+						if ($options & self::REPAIR && isset($defaults[$propName])) {
+							$this->add($propName, $defaults[$propName]);
+							$repaired = true;
+						}
+						$messages[] = [
+							'level'   => $repaired ? 1 : 3,
+							'message' => $propName . ' MUST appear exactly once in a ' . $this->name . ' component',
+							'node'    => $this,
+						];
+					}
+					break;
+				case '+' :
+					if (!isset($propertyCounters[$propName]) || $propertyCounters[$propName] < 1) {
+						$messages[] = [
+							'level'   => 3,
+							'message' => $propName . ' MUST appear at least once in a ' . $this->name . ' component',
+							'node'    => $this,
+						];
+					}
+					break;
+				case '*' :
+					break;
+				case '?' :
+					if (isset($propertyCounters[$propName]) && $propertyCounters[$propName] > 1) {
+						$messages[] = [
+							'level'   => 3,
+							'message' => $propName . ' MUST NOT appear more than once in a ' . $this->name . ' component',
+							'node'    => $this,
+						];
+					}
+					break;
+
+			}
+
+		}
+		return $messages;
+
+	}
+
+	/**
+	 * Call this method on a document if you're done using it.
+	 *
+	 * It's intended to remove all circular references, so PHP can easily clean
+	 * it up.
+	 *
+	 * @return void
+	 */
+	public function destroy() {
+
+		parent::destroy();
+		foreach ($this->children as $childGroup) {
+			foreach ($childGroup as $child) {
+				$child->destroy();
+			}
+		}
+		$this->children = [];
+
+	}
 
 }