Merge branch 'release/0.9.3'

Add missing semicolon to end if-then-statement

.gitignore

@@ -1,8 +1,12 @@
-# OS X
-.DS_Store
-
 # Xcode
+#
+# gitignore contributors: remember to update Global/Xcode.gitignore, Objective-C.gitignore & Swift.gitignore
+
+## Build generated
 build/
+DerivedData
+
+## Various settings
 *.pbxuser
 !default.pbxuser
 *.mode1v3
@@ -12,13 +16,28 @@ build/
 *.perspectivev3
 !default.perspectivev3
 xcuserdata
+
+## Other
 *.xccheckout
-profile
 *.moved-aside
-DerivedData
+*.xcuserstate
+*.xcscmblueprint
+
+## Obj-C/Swift specific
 *.hmap
 *.ipa
 
 # CocoaPods
-Pods
+#
+# We recommend against adding the Pods directory to your .gitignore. However
+# you should judge for yourself, the pros and cons are mentioned at:
+# http://guides.cocoapods.org/using/using-cocoapods.html#should-i-check-the-pods-directory-into-source-control
+#
+Pods/
 
+# Carthage
+#
+# Add this line if you want to avoid checking in source code from Carthage dependencies.
+Carthage/Checkouts
+
+Carthage/Build

.travis.yml

@@ -0,0 +1,42 @@
+language: objective-c
+osx_image: xcode7.3
+
+branches:
+  except:
+    - gh-pages
+
+install:
+  - gem install xcpretty
+
+env:
+  global:
+    - LC_CTYPE=en_US.UTF-8
+    - LANG=en_US.UTF-8
+    - WORKSPACE=HTMLKit.xcworkspace
+    - IOS_FRAMEWORK_SCHEME=HTMLKit-iOS
+    - OSX_FRAMEWORK_SCHEME=HTMLKit-OSX
+    - WATCHOS_FRAMEWORK_SCHEME="HTMLKit-watchOS"
+    - TVOS_FRAMEWORK_SCHEME="HTMLKit-tvOS"
+    - IOS_SDK=iphonesimulator9.3
+    - OSX_SDK=macosx10.11
+    - WATCHOS_SDK=watchsimulator2.2
+    - TVOS_SDK=appletvsimulator9.2
+  matrix:
+    - DESTINATION="OS=9.0,name=iPhone 6"            SIMULATOR="iPhone 6 (9.0)"            SCHEME="$IOS_FRAMEWORK_SCHEME"      SDK="$IOS_SDK"
+    - DESTINATION="OS=9.1,name=iPhone 6 Plus"       SIMULATOR="iPhone 6 Plus (9.1)"       SCHEME="$IOS_FRAMEWORK_SCHEME"      SDK="$IOS_SDK"
+    - DESTINATION="OS=9.2,name=iPhone 6S"           SIMULATOR="iPhone 6S (9.2)"           SCHEME="$IOS_FRAMEWORK_SCHEME"      SDK="$IOS_SDK"
+    - DESTINATION="OS=9.3,name=iPhone 6S Plus"      SIMULATOR="iPhone 6S Plus (9.3)"      SCHEME="$IOS_FRAMEWORK_SCHEME"      SDK="$IOS_SDK"
+    - DESTINATION="arch=x86_64"                     SIMULATOR=""                          SCHEME="$OSX_FRAMEWORK_SCHEME"      SDK="$OSX_SDK"
+    - DESTINATION="OS=2.2,name=Apple Watch - 42mm"  SIMULATOR="Apple Watch - 42mm (2.2)"  SCHEME="$WATCHOS_FRAMEWORK_SCHEME"  SDK="$WATCHOS_SDK"
+    - DESTINATION="OS=9.2,name=Apple TV 1080p"      SIMULATOR="Apple TV 1080p (9.2)"      SCHEME="$TVOS_FRAMEWORK_SCHEME"     SDK="$TVOS_SDK"
+
+script:
+  - set -o pipefail
+  - xcodebuild -version
+  - xcodebuild -showsdks
+  - SIMULATOR_ID=$(xcrun instruments -s devices | grep -io "$SIMULATOR \[.*\]" | grep -o "\[.*\]" | sed "s/^\[\(.*\)\]$/\1/")
+  - open -b com.apple.iphonesimulator --args -CurrentDeviceUDID $SIMULATOR_ID
+  - xcodebuild -workspace "$WORKSPACE" -scheme "$SCHEME" -sdk "$SDK" -destination "$DESTINATION" -configuration Debug ONLY_ACTIVE_ARCH=NO clean build | xcpretty -c
+  - if [ "$SDK" != "$WATCHOS_SDK" ]; then
+      xcodebuild -workspace "$WORKSPACE" -scheme "$SCHEME" -sdk "$SDK" -destination "$DESTINATION" -configuration Debug ONLY_ACTIVE_ARCH=NO test | xcpretty -c;
+    fi

CHANGELOG.md

@@ -0,0 +1,140 @@
+# Change Log
+
+## [0.9.3](https://github.com/iabudiab/HTMLKit/releases/tag/0.9.3)
+
+Released on 2016.07.16
+
+This release passes all html5lib-tests as of 2016.07.16
+
+### Added
+
+- `watchOS` and `tvOS` targets
+- Updated HTML5Lib-Tests submodule (c305da7)
+
+## [0.9.2](https://github.com/iabudiab/HTMLKit/releases/tag/0.9.2)
+
+Released on 2016.05.18
+
+This release passes all html5lib-tests as of 2016.05.18
+
+### Added
+
+- Handling for `<menu>` and `<menuitem>`
+- Changelog
+
+### Changed
+
+- Updated adoption agency algorithm according to the latest specification, see:
+	- [whatwg/html@22ce3c3](https://github.com/whatwg/html/commit/22ce3c3)
+	- [Mozilla Bug 901319](https://bugzilla.mozilla.org/show_bug.cgi?id=901319)
+	- [Chrome Issue 268121](https://bugs.chromium.org/p/chromium/issues/detail?id=268121) 
+	- [WebKit Bug 119478](https://bugs.webkit.org/show_bug.cgi?id=119478)
+- `<isindex>` is completely removed from the spec now, therefore it is dropped from the implementation
+- `Tokenizer` and `Tree-Construction` tests are now generated dynamically
+- Test failures are collected by a `XCTestObservation` for better reporting
+	
+- `<isindex>` is completely removed from the spec now, therefore it is dropped from the implementation
+- `Tokenizer` and `Tree-Construction` tests are now generated dynamically
+- Test failures are collected by a `XCTestObservation` for better reporting
+
+### Fixed
+
+- Parser now checks the qualified name instead of the local name when handling elements in the `MathML` and `SVG` namespaces
+
+
+## [0.9.1](https://github.com/iabudiab/HTMLKit/releases/tag/0.9.1)
+
+Released on 2016.01.29
+
+### Added
+
+- Travis-CI integration.
+- CocoaPods spec.
+
+
+### Changed
+
+- Warnings are treated as errors.
+
+### Fixed
+
+- Warnings related to format specifier and loss of precision due to NS(U)-integer usage.
+- Replaced `@returns` with `@return` throughout the documentation to play nicely with Jazzy.
+- Some README examples used Swift syntax.
+
+## [0.9.0](https://github.com/iabudiab/HTMLKit/releases/tag/0.9.0)
+
+Released on 2015.12.23
+
+This is the first public release of `HTMLKit`.
+
+### Added
+
+- `iOS` & `OSX` Frameworks.
+- Source code documentation.
+- CSS Selectors extension (analogous to jQuery selectors).
+- `DOMTokenList` for malipulating `HTMLElements` attributes as a list, e.g. `class`.
+- Handling for `<ruby>` elements in the Parser implementation.
+	- Updated HTML5Lib-Tests submodule (56c435f)
+- Xcode Playground with Swift documentation.
+
+### Removed
+
+- Unused namespaces.
+- Historical node types.
+
+
+### Fixed
+
+- `lt`, `gt` & `eq` CSS Selectors method declarations.
+
+## [0.3.0](https://github.com/iabudiab/HTMLKit/releases/tag/0.3.0)
+
+Released on 2015.11.29
+
+### Added
+
+- CSS3 Selectors support.
+- Nullability annotations.
+- `HTMLNode` properties for previous and next sibling elements.
+- `HTMLNode` methods for accessing child elements (analogous to child nodes).
+- `NSCharacterSet` category for HTML-related character sets.
+
+### Fixed
+
+- `InputStreaReader`'s reconsume-logic that is required by the CSS Parser.
+
+## [0.2.0](https://github.com/iabudiab/HTMLKit/releases/tag/0.1.0)
+
+Released on 2015.06.06
+
+### Added
+
+- `HTMLDocument` methods to access `root`, `head` & `body` elements.
+- `innerHTML` implementation for the `HTMLElement`.
+- `HTMLNode` methods to append, prepend, check containment and descendancy of nodes.
+- `HTMLNode` methods to enumerate child nodes.
+- Implementations for `NodeIterator` and `NodeFilter`
+- Implementation for `TreeWalker`
+- Validation for DOM manipulations.
+- Tests for the DOM implementation.
+
+### Changed
+
+- `type` property renamed to `nodeType` in `HTMLNode`.
+- `firstChildNode` and `lastChildNode` renamed to `firtChild` and `lastChild` in `HTMLNode`.
+
+### Removed
+
+- `baseURI` proeprty from `HTMLNode`
+- `HTMLNodeTreeEnumerator` is superseded by the `HTMLNodeIterator`. 
+
+## [0.1.0](https://github.com/iabudiab/HTMLKit/releases/tag/0.1.0)
+
+Released on 2015.04.20
+
+### Added
+
+- Initial release.
+- Initial DOM implementation.
+- Tokenizer and Parser pass all [HTML5Lib](https://github.com/html5lib/html5lib-tests) tokenizer and tree construction tests except for `<ruby>` elements.

HTMLKit.playground/Pages/CSS Selectors.xcplaygroundpage/Contents.swift

@@ -0,0 +1,80 @@
+//: [Previous](@previous)
+/*:
+# CSS3 Selectors
+
+HTMLKit understands CSS3 selectors making node-selection a piece of cake:
+*/
+
+import HTMLKit
+
+let htmlString = "<div><h1>HTMLKit</h1><p class='greeting'>Hello there!</p><p class='description'>This is a demo of HTMLKit</p></div>"
+let document = HTMLDocument(string: htmlString)
+
+/*:
+All CSS3 selectors are supported and you use them the way you always have:
+*/
+var paragraphs = document.querySelectorAll("p")
+var paragraphsOrHeaders = document.querySelectorAll("p, h1")
+var hasClassAttribute = document.querySelectorAll("[class]")
+var greetings = document.querySelectorAll(".greeting")
+var classNameStartsWith_de = document.querySelectorAll("[class^='de']")
+
+var hasAdjacentHeader = document.querySelectorAll("h1 + *")
+var hasSiblingHeader = document.querySelectorAll("h1 ~ *")
+var hasSiblingParagraph = document.querySelectorAll("p ~ *")
+
+var nonParagraphChildOfDiv = document.querySelectorAll("div :not(p)")
+
+/*:
+HTMLKit also provides API to create selector instances in a type-safe manner without the need to parse them first. The previous examples would like this:
+*/
+paragraphs = document.elementsMatchingSelector(typeSelector("p"))
+paragraphsOrHeaders = document.elementsMatchingSelector(
+	anyOf([
+		typeSelector("p"), typeSelector("h1")
+	])
+)
+
+hasClassAttribute = document.elementsMatchingSelector(hasAttributeSelector("class"))
+greetings = document.elementsMatchingSelector(classSelector("greeting"))
+classNameStartsWith_de = document.elementsMatchingSelector(attributeSelector(.Begins, "class", "de"))
+
+hasAdjacentHeader = document.elementsMatchingSelector(adjacentSiblingSelector(typeSelector("h1")))
+hasAdjacentHeader = document.elementsMatchingSelector(generalSiblingSelector(typeSelector("h1")))
+hasAdjacentHeader = document.elementsMatchingSelector(generalSiblingSelector(typeSelector("p")))
+
+nonParagraphChildOfDiv = document.elementsMatchingSelector(
+	allOf([
+		childOfElementSelector(typeSelector("div")),
+		not(typeSelector("p"))
+	])
+)
+
+/*:
+Here are more examples
+*/
+
+let firstDivElement = document.firstElementMatchingSelector(typeSelector("div"))!
+
+var secondChildOfDiv = firstDivElement.querySelectorAll(":nth-child(2)")
+var secondOfType = firstDivElement.querySelectorAll(":nth-of-type(2n)")
+
+secondChildOfDiv = firstDivElement.elementsMatchingSelector(nthChildSelector(CSSNthExpression(an: 0, b: 2)))
+secondOfType = firstDivElement.elementsMatchingSelector(nthOfTypeSelector(CSSNthExpression(an: 2, b: 0)))
+
+
+var notParagraphAndNotDiv = firstDivElement.querySelectorAll(":not(p):not(div)")
+notParagraphAndNotDiv = firstDivElement.elementsMatchingSelector(
+	allOf([
+		not(typeSelector("p")),
+		not(typeSelector("div"))
+	])
+)
+
+/*:
+One more thing! You can also create your own selectors. You either subclass the CSSSelector or just use the block-based wrapper. For example the previous selector can be implemented like this:
+*/
+let myAwesomeSelector = namedBlockSelector("myAwesomeSelector", { (element) -> Bool in
+	return element.tagName != "p" && element.tagName != "div"
+})
+firstDivElement.elementsMatchingSelector(myAwesomeSelector)

HTMLKit.playground/Pages/CSS Selectors.xcplaygroundpage/timeline.xctimeline

@@ -0,0 +1,6 @@
+<?xml version="1.0" encoding="UTF-8"?>
+<Timeline
+   version = "3.0">
+   <TimelineItems>
+   </TimelineItems>
+</Timeline>

HTMLKit.playground/Pages/Intro.xcplaygroundpage/Contents.swift

@@ -0,0 +1,30 @@
+/*:
+# HTMLKit
+
+![Logo](HTMLKit.png)
+
+****
+
+An Objective-C kit for your everyday HTML needs.
+
+****
+
+HTMLKit is a [WHATWG](https://html.spec.whatwg.org/multipage/) specification-compliant framework for parsing and serializing HTML documents and document fragments for iOS and OSX. HTMLKit parses real-world HTML the same way modern web browsers would.
+
+****
+
+HTMLKit is available under the MIT License
+
+****
+
+# Table of Contents
+
+- [Parsing Document](Parsing%20Documents)
+- [Parsing Fragments](Parsing%20Fragments)
+- [The DOM](The%20DOM)
+- [CSS Selectors](CSS%20Selectors)
+
+****
+
+[Next](@next)
+*/

HTMLKit.playground/Pages/Intro.xcplaygroundpage/timeline.xctimeline

@@ -0,0 +1,27 @@
+<?xml version="1.0" encoding="UTF-8"?>
+<Timeline
+   version = "3.0">
+   <TimelineItems>
+      <LoggerValueHistoryTimelineItem
+         documentLocation = "#CharacterRangeLen=0&amp;CharacterRangeLoc=572&amp;EndingColumnNumber=5&amp;EndingLineNumber=27&amp;StartingColumnNumber=1&amp;StartingLineNumber=26&amp;Timestamp=472575682.16404"
+         selectedRepresentationIndex = "0"
+         shouldTrackSuperviewWidth = "NO">
+      </LoggerValueHistoryTimelineItem>
+      <LoggerValueHistoryTimelineItem
+         documentLocation = "#CharacterRangeLen=0&amp;CharacterRangeLoc=572&amp;EndingColumnNumber=9&amp;EndingLineNumber=27&amp;StartingColumnNumber=5&amp;StartingLineNumber=26&amp;Timestamp=472575682.164357"
+         selectedRepresentationIndex = "0"
+         shouldTrackSuperviewWidth = "NO">
+      </LoggerValueHistoryTimelineItem>
+      <LoggerValueHistoryTimelineItem
+         documentLocation = "#CharacterRangeLen=0&amp;CharacterRangeLoc=572&amp;EndingColumnNumber=9&amp;EndingLineNumber=27&amp;StartingColumnNumber=5&amp;StartingLineNumber=26&amp;Timestamp=472575682.16458"
+         selectedRepresentationIndex = "0"
+         shouldTrackSuperviewWidth = "NO">
+      </LoggerValueHistoryTimelineItem>
+      <LoggerValueHistoryTimelineItem
+         documentLocation = "#CharacterRangeLen=0&amp;CharacterRangeLoc=572&amp;EndingColumnNumber=9&amp;EndingLineNumber=1&amp;StartingColumnNumber=5&amp;StartingLineNumber=1&amp;Timestamp=472575682.164803"
+         lockedSize = "{309, 236}"
+         selectedRepresentationIndex = "0"
+         shouldTrackSuperviewWidth = "NO">
+      </LoggerValueHistoryTimelineItem>
+   </TimelineItems>
+</Timeline>

HTMLKit.playground/Pages/Parsing Documents.xcplaygroundpage/Contents.swift

@@ -0,0 +1,29 @@
+//: [Previous](@previous)
+/*:
+# Parsing HTML Documents
+*/
+
+import HTMLKit
+
+/*:
+Given some HTML content
+*/
+
+let htmlString = try! String(contentsOfURL: [#FileReference(fileReferenceLiteral: "HTMLKit.html")#])
+
+/*:
+You can parse it using the HTMLParser:
+*/
+
+let parser = HTMLParser(string: htmlString)
+let documentViaParser = parser.parseDocument()
+documentViaParser.innerHTML
+
+/*:
+You can also create a document from a given HTML string directly:
+*/
+
+let document = HTMLDocument(string: htmlString)
+document.innerHTML
+
+//: [Next](@next)

HTMLKit.playground/Pages/Parsing Documents.xcplaygroundpage/timeline.xctimeline

@@ -0,0 +1,12 @@
+<?xml version="1.0" encoding="UTF-8"?>
+<Timeline
+   version = "3.0">
+   <TimelineItems>
+      <LoggerValueHistoryTimelineItem
+         documentLocation = "#CharacterRangeLen=1&amp;CharacterRangeLoc=318&amp;EndingColumnNumber=26&amp;EndingLineNumber=13&amp;StartingColumnNumber=1&amp;StartingLineNumber=13&amp;Timestamp=472578634.909266"
+         lockedSize = "{800, 186}"
+         selectedRepresentationIndex = "0"
+         shouldTrackSuperviewWidth = "NO">
+      </LoggerValueHistoryTimelineItem>
+   </TimelineItems>
+</Timeline>

HTMLKit.playground/Pages/Parsing Fragments.xcplaygroundpage/Contents.swift

@@ -0,0 +1,38 @@
+//: [Previous](@previous)
+/*:
+# Parsing Document Fragments
+*/
+
+import HTMLKit
+
+/*:
+Given some HTML content
+*/
+
+let htmlString = "<div><p>Hello HTMLKit</p></div><td>some table data"
+
+/*:
+You can prase it as a document fragment in a specified context element:
+*/
+
+let parser = HTMLParser(string: htmlString)
+
+let tableContext = HTMLElement(tagName: "table")
+var elements = parser.parseFragmentWithContextElement(tableContext)
+
+for element in elements {
+	print(element.outerHTML)
+}
+
+/*:
+The same parser instance can be reusued:
+*/
+
+let bodyContext = HTMLElement(tagName: "body")
+elements = parser.parseFragmentWithContextElement(bodyContext)
+
+for element in elements {
+	print(element.outerHTML)
+}
+
+//: [Next](@next)

HTMLKit.playground/Pages/Parsing Fragments.xcplaygroundpage/timeline.xctimeline

@@ -0,0 +1,48 @@
+<?xml version="1.0" encoding="UTF-8"?>
+<Timeline
+   version = "3.0">
+   <TimelineItems>
+      <LoggerValueHistoryTimelineItem
+         documentLocation = "#CharacterRangeLen=0&amp;CharacterRangeLoc=356&amp;EndingColumnNumber=16&amp;EndingLineNumber=23&amp;StartingColumnNumber=2&amp;StartingLineNumber=23&amp;Timestamp=472578641.006172"
+         lockedSize = "{775, 114}"
+         selectedRepresentationIndex = "1"
+         shouldTrackSuperviewWidth = "NO">
+      </LoggerValueHistoryTimelineItem>
+      <LoggerValueHistoryTimelineItem
+         documentLocation = "#CharacterRangeLen=0&amp;CharacterRangeLoc=356&amp;EndingColumnNumber=23&amp;EndingLineNumber=23&amp;StartingColumnNumber=2&amp;StartingLineNumber=23&amp;Timestamp=472578641.006502"
+         lockedSize = "{775, 80}"
+         selectedRepresentationIndex = "1"
+         shouldTrackSuperviewWidth = "NO">
+      </LoggerValueHistoryTimelineItem>
+      <LoggerValueHistoryTimelineItem
+         documentLocation = "#CharacterRangeLen=21&amp;CharacterRangeLoc=262&amp;EndingColumnNumber=23&amp;EndingLineNumber=13&amp;StartingColumnNumber=2&amp;StartingLineNumber=13&amp;Timestamp=472578641.006717"
+         lockedSize = "{775, 76}"
+         selectedRepresentationIndex = "1"
+         shouldTrackSuperviewWidth = "YES">
+      </LoggerValueHistoryTimelineItem>
+      <LoggerValueHistoryTimelineItem
+         documentLocation = "#CharacterRangeLen=24&amp;CharacterRangeLoc=453&amp;EndingColumnNumber=26&amp;EndingLineNumber=23&amp;StartingColumnNumber=2&amp;StartingLineNumber=23&amp;Timestamp=472578641.006933"
+         lockedSize = "{775, 83}"
+         selectedRepresentationIndex = "1"
+         shouldTrackSuperviewWidth = "NO">
+      </LoggerValueHistoryTimelineItem>
+      <LoggerValueHistoryTimelineItem
+         documentLocation = "#CharacterRangeLen=24&amp;CharacterRangeLoc=668&amp;EndingColumnNumber=26&amp;EndingLineNumber=34&amp;StartingColumnNumber=2&amp;StartingLineNumber=34&amp;Timestamp=472578641.007156"
+         lockedSize = "{775, 76}"
+         selectedRepresentationIndex = "1"
+         shouldTrackSuperviewWidth = "YES">
+      </LoggerValueHistoryTimelineItem>
+      <LoggerValueHistoryTimelineItem
+         documentLocation = "#CharacterRangeLen=24&amp;CharacterRangeLoc=281&amp;EndingColumnNumber=26&amp;EndingLineNumber=13&amp;StartingColumnNumber=2&amp;StartingLineNumber=13&amp;Timestamp=472579861.71569"
+         lockedSize = "{775, 68}"
+         selectedRepresentationIndex = "1"
+         shouldTrackSuperviewWidth = "NO">
+      </LoggerValueHistoryTimelineItem>
+      <LoggerValueHistoryTimelineItem
+         documentLocation = "#CharacterRangeLen=24&amp;CharacterRangeLoc=448&amp;EndingColumnNumber=26&amp;EndingLineNumber=21&amp;StartingColumnNumber=2&amp;StartingLineNumber=21&amp;Timestamp=472579861.71569"
+         lockedSize = "{775, 68}"
+         selectedRepresentationIndex = "1"
+         shouldTrackSuperviewWidth = "YES">
+      </LoggerValueHistoryTimelineItem>
+   </TimelineItems>
+</Timeline>

HTMLKit.playground/Pages/The DOM.xcplaygroundpage/Contents.swift

@@ -0,0 +1,79 @@
+//: [Previous](@previous)
+/*:
+# The DOM
+
+HTMLKit provides a rich DOM implementation for manipulating and navigating the document tree. Here are some of the features:
+*/
+
+import HTMLKit
+
+let htmlString = "<div><h1>HTMLKit</h1><p>Hello there!</p></div>"
+let document = HTMLDocument(string: htmlString)
+
+/*:
+Create new elements and assign attributes
+*/
+
+let description = HTMLElement(tagName:"meta", attributes: ["name": "description"])
+description["content"] = "HTMLKit for iOS & OSX"
+
+/*:
+Append nodes to the document
+*/
+let head = document.head!
+head.appendNode(description)
+document.innerHTML
+
+let body = document.body!
+let nodes = [
+	HTMLElement(tagName: "div", attributes: ["class": "red"]),
+	HTMLElement(tagName: "div", attributes: ["class": "green"]),
+	HTMLElement(tagName: "div", attributes: ["class": "blue"])
+]
+body.appendNodes(nodes)
+body.innerHTML
+
+/*:
+Enumerate child elements and perform DOM manipulation
+*/
+body.enumerateChildElementsUsingBlock { (element, index, stop) -> Void in
+	if element.tagName == "div" {
+		let lorem = HTMLElement(tagName: "p")
+		lorem.textContent = "Lorem ipsum: \(index)"
+		element.appendNode(lorem)
+	}
+}
+body.innerHTML
+
+/*:
+Remove nodes from the document
+*/
+body.removeChildNodeAtIndex(1)
+body.innerHTML
+
+/*:
+Navigate to child and sibling nodes
+*/
+body.lastChild!.removeFromParentNode()
+let greenDiv = body.firstChild!.nextSibling!
+
+/*:
+Manipulate the HTML directly
+*/
+greenDiv.innerHTML = "<ul><li>item 1<li>item 2"
+
+/*:
+Iterate the DOM tree with custom filters
+*/
+let filter = HTMLNodeFilterBlock.filterWithBlock { (node) -> HTMLNodeFilterValue in
+	if node.childNodesCount() != 1 {
+		return .Reject
+	}
+	return .Accept
+}
+
+for element in body.nodeIteratorWithShowOptions(.Element, filter: filter) {
+	element.outerHTML
+}
+
+//: [Next](@next)

HTMLKit.playground/Pages/The DOM.xcplaygroundpage/timeline.xctimeline

@@ -0,0 +1,150 @@
+<?xml version="1.0" encoding="UTF-8"?>
+<Timeline
+   version = "3.0">
+   <TimelineItems>
+      <LoggerValueHistoryTimelineItem
+         documentLocation = "#CharacterRangeLen=19&amp;CharacterRangeLoc=575&amp;EndingColumnNumber=26&amp;EndingLineNumber=24&amp;StartingColumnNumber=1&amp;StartingLineNumber=24&amp;Timestamp=472578662.196737"
+         lockedSize = "{763, 104}"
+         selectedRepresentationIndex = "0"
+         shouldTrackSuperviewWidth = "YES">
+      </LoggerValueHistoryTimelineItem>
+      <LoggerValueHistoryTimelineItem
+         documentLocation = "#CharacterRangeLen=15&amp;CharacterRangeLoc=843&amp;EndingColumnNumber=22&amp;EndingLineNumber=33&amp;StartingColumnNumber=1&amp;StartingLineNumber=33&amp;Timestamp=472578662.197012"
+         lockedSize = "{763, 75}"
+         selectedRepresentationIndex = "0"
+         shouldTrackSuperviewWidth = "NO">
+      </LoggerValueHistoryTimelineItem>
+      <LoggerValueHistoryTimelineItem
+         documentLocation = "#CharacterRangeLen=1&amp;CharacterRangeLoc=1757&amp;EndingColumnNumber=44&amp;EndingLineNumber=75&amp;StartingColumnNumber=2&amp;StartingLineNumber=75&amp;Timestamp=472578674.159974"
+         lockedSize = "{763, 176}"
+         selectedRepresentationIndex = "1"
+         shouldTrackSuperviewWidth = "NO">
+      </LoggerValueHistoryTimelineItem>
+      <LoggerValueHistoryTimelineItem
+         documentLocation = "#CharacterRangeLen=14&amp;CharacterRangeLoc=844&amp;EndingColumnNumber=15&amp;EndingLineNumber=33&amp;StartingColumnNumber=1&amp;StartingLineNumber=33&amp;Timestamp=472578662.197451"
+         lockedSize = "{762, 70}"
+         selectedRepresentationIndex = "0"
+         shouldTrackSuperviewWidth = "NO">
+      </LoggerValueHistoryTimelineItem>
+      <LoggerValueHistoryTimelineItem
+         documentLocation = "#CharacterRangeLen=18&amp;CharacterRangeLoc=576&amp;EndingColumnNumber=19&amp;EndingLineNumber=24&amp;StartingColumnNumber=1&amp;StartingLineNumber=24&amp;Timestamp=472578662.197662"
+         lockedSize = "{752, 99}"
+         selectedRepresentationIndex = "0"
+         shouldTrackSuperviewWidth = "NO">
+      </LoggerValueHistoryTimelineItem>
+      <LoggerValueHistoryTimelineItem
+         documentLocation = "#CharacterRangeLen=1&amp;CharacterRangeLoc=1757&amp;EndingColumnNumber=16&amp;EndingLineNumber=75&amp;StartingColumnNumber=2&amp;StartingLineNumber=75&amp;Timestamp=472578674.160606"
+         lockedSize = "{763, 102}"
+         selectedRepresentationIndex = "1"
+         shouldTrackSuperviewWidth = "NO">
+      </LoggerValueHistoryTimelineItem>
+      <LoggerValueHistoryTimelineItem
+         documentLocation = "#CharacterRangeLen=18&amp;CharacterRangeLoc=1740&amp;EndingColumnNumber=39&amp;EndingLineNumber=75&amp;StartingColumnNumber=2&amp;StartingLineNumber=75&amp;Timestamp=472578674.160818"
+         lockedSize = "{759, 149}"
+         selectedRepresentationIndex = "1"
+         shouldTrackSuperviewWidth = "NO">
+      </LoggerValueHistoryTimelineItem>
+      <LoggerValueHistoryTimelineItem
+         documentLocation = "#CharacterRangeLen=17&amp;CharacterRangeLoc=1741&amp;EndingColumnNumber=19&amp;EndingLineNumber=75&amp;StartingColumnNumber=2&amp;StartingLineNumber=75&amp;Timestamp=472578674.161034"
+         lockedSize = "{763, 120}"
+         selectedRepresentationIndex = "1"
+         shouldTrackSuperviewWidth = "NO">
+      </LoggerValueHistoryTimelineItem>
+      <LoggerValueHistoryTimelineItem
+         documentLocation = "#CharacterRangeLen=14&amp;CharacterRangeLoc=1230&amp;EndingColumnNumber=15&amp;EndingLineNumber=51&amp;StartingColumnNumber=1&amp;StartingLineNumber=51&amp;Timestamp=472578674.161242"
+         lockedSize = "{763, 94}"
+         selectedRepresentationIndex = "0"
+         shouldTrackSuperviewWidth = "NO">
+      </LoggerValueHistoryTimelineItem>
+      <LoggerValueHistoryTimelineItem
+         documentLocation = "#CharacterRangeLen=14&amp;CharacterRangeLoc=1145&amp;EndingColumnNumber=15&amp;EndingLineNumber=45&amp;StartingColumnNumber=1&amp;StartingLineNumber=45&amp;Timestamp=472578674.161449"
+         lockedSize = "{760, 97}"
+         selectedRepresentationIndex = "0"
+         shouldTrackSuperviewWidth = "NO">
+      </LoggerValueHistoryTimelineItem>
+      <LoggerValueHistoryTimelineItem
+         documentLocation = "#CharacterRangeLen=8&amp;CharacterRangeLoc=1332&amp;EndingColumnNumber=13&amp;EndingLineNumber=57&amp;StartingColumnNumber=5&amp;StartingLineNumber=57&amp;Timestamp=472578674.161666"
+         lockedSize = "{763, 74}"
+         selectedRepresentationIndex = "0"
+         shouldTrackSuperviewWidth = "NO">
+      </LoggerValueHistoryTimelineItem>
+      <LoggerValueHistoryTimelineItem
+         documentLocation = "#CharacterRangeLen=18&amp;CharacterRangeLoc=397&amp;EndingColumnNumber=19&amp;EndingLineNumber=14&amp;StartingColumnNumber=1&amp;StartingLineNumber=14&amp;Timestamp=472578662.199111"
+         lockedSize = "{762, 90}"
+         selectedRepresentationIndex = "0"
+         shouldTrackSuperviewWidth = "NO">
+      </LoggerValueHistoryTimelineItem>
+      <LoggerValueHistoryTimelineItem
+         documentLocation = "#CharacterRangeLen=14&amp;CharacterRangeLoc=701&amp;EndingColumnNumber=15&amp;EndingLineNumber=26&amp;StartingColumnNumber=1&amp;StartingLineNumber=26&amp;Timestamp=472578662.199312"
+         lockedSize = "{763, 76}"
+         selectedRepresentationIndex = "0"
+         shouldTrackSuperviewWidth = "NO">
+      </LoggerValueHistoryTimelineItem>
+      <LoggerValueHistoryTimelineItem
+         documentLocation = "#CharacterRangeLen=14&amp;CharacterRangeLoc=1002&amp;EndingColumnNumber=15&amp;EndingLineNumber=38&amp;StartingColumnNumber=1&amp;StartingLineNumber=38&amp;Timestamp=472578674.162269"
+         lockedSize = "{763, 92}"
+         selectedRepresentationIndex = "0"
+         shouldTrackSuperviewWidth = "NO">
+      </LoggerValueHistoryTimelineItem>
+      <LoggerValueHistoryTimelineItem
+         documentLocation = "#CharacterRangeLen=14&amp;CharacterRangeLoc=1049&amp;EndingColumnNumber=15&amp;EndingLineNumber=41&amp;StartingColumnNumber=1&amp;StartingLineNumber=41&amp;Timestamp=472578674.162475"
+         lockedSize = "{763, 83}"
+         selectedRepresentationIndex = "0"
+         shouldTrackSuperviewWidth = "NO">
+      </LoggerValueHistoryTimelineItem>
+      <LoggerValueHistoryTimelineItem
+         documentLocation = "#CharacterRangeLen=8&amp;CharacterRangeLoc=1108&amp;EndingColumnNumber=13&amp;EndingLineNumber=44&amp;StartingColumnNumber=5&amp;StartingLineNumber=44&amp;Timestamp=472578674.162693"
+         lockedSize = "{763, 73}"
+         selectedRepresentationIndex = "0"
+         shouldTrackSuperviewWidth = "NO">
+      </LoggerValueHistoryTimelineItem>
+      <LoggerValueHistoryTimelineItem
+         documentLocation = "#CharacterRangeLen=17&amp;CharacterRangeLoc=1598&amp;EndingColumnNumber=19&amp;EndingLineNumber=68&amp;StartingColumnNumber=2&amp;StartingLineNumber=68&amp;Timestamp=472578674.162898"
+         lockedSize = "{763, 92}"
+         selectedRepresentationIndex = "1"
+         shouldTrackSuperviewWidth = "NO">
+      </LoggerValueHistoryTimelineItem>
+      <LoggerValueHistoryTimelineItem
+         documentLocation = "#CharacterRangeLen=8&amp;CharacterRangeLoc=1410&amp;EndingColumnNumber=9&amp;EndingLineNumber=61&amp;StartingColumnNumber=1&amp;StartingLineNumber=59&amp;Timestamp=472578674.163102"
+         lockedSize = "{763, 60}"
+         selectedRepresentationIndex = "0"
+         shouldTrackSuperviewWidth = "NO">
+      </LoggerValueHistoryTimelineItem>
+      <LoggerValueHistoryTimelineItem
+         documentLocation = "#CharacterRangeLen=14&amp;CharacterRangeLoc=590&amp;EndingColumnNumber=15&amp;EndingLineNumber=21&amp;StartingColumnNumber=1&amp;StartingLineNumber=21&amp;Timestamp=472579886.937978"
+         lockedSize = "{763, 50}"
+         selectedRepresentationIndex = "0"
+         shouldTrackSuperviewWidth = "NO">
+      </LoggerValueHistoryTimelineItem>
+      <LoggerValueHistoryTimelineItem
+         documentLocation = "#CharacterRangeLen=14&amp;CharacterRangeLoc=830&amp;EndingColumnNumber=15&amp;EndingLineNumber=30&amp;StartingColumnNumber=1&amp;StartingLineNumber=30&amp;Timestamp=472579886.937978"
+         lockedSize = "{763, 50}"
+         selectedRepresentationIndex = "0"
+         shouldTrackSuperviewWidth = "YES">
+      </LoggerValueHistoryTimelineItem>
+      <LoggerValueHistoryTimelineItem
+         documentLocation = "#CharacterRangeLen=14&amp;CharacterRangeLoc=877&amp;EndingColumnNumber=15&amp;EndingLineNumber=33&amp;StartingColumnNumber=1&amp;StartingLineNumber=33&amp;Timestamp=472579886.937978"
+         lockedSize = "{763, 50}"
+         selectedRepresentationIndex = "0"
+         shouldTrackSuperviewWidth = "YES">
+      </LoggerValueHistoryTimelineItem>
+      <LoggerValueHistoryTimelineItem
+         documentLocation = "#CharacterRangeLen=8&amp;CharacterRangeLoc=936&amp;EndingColumnNumber=13&amp;EndingLineNumber=36&amp;StartingColumnNumber=5&amp;StartingLineNumber=36&amp;Timestamp=472579886.937978"
+         lockedSize = "{763, 50}"
+         selectedRepresentationIndex = "0"
+         shouldTrackSuperviewWidth = "NO">
+      </LoggerValueHistoryTimelineItem>
+      <LoggerValueHistoryTimelineItem
+         documentLocation = "#CharacterRangeLen=8&amp;CharacterRangeLoc=978&amp;EndingColumnNumber=9&amp;EndingLineNumber=38&amp;StartingColumnNumber=1&amp;StartingLineNumber=38&amp;Timestamp=472579886.937978"
+         lockedSize = "{763, 50}"
+         selectedRepresentationIndex = "0"
+         shouldTrackSuperviewWidth = "YES">
+      </LoggerValueHistoryTimelineItem>
+      <LoggerValueHistoryTimelineItem
+         documentLocation = "#CharacterRangeLen=17&amp;CharacterRangeLoc=1261&amp;EndingColumnNumber=19&amp;EndingLineNumber=48&amp;StartingColumnNumber=2&amp;StartingLineNumber=48&amp;Timestamp=472579886.937978"
+         lockedSize = "{763, 92}"
+         selectedRepresentationIndex = "1"
+         shouldTrackSuperviewWidth = "NO">
+      </LoggerValueHistoryTimelineItem>
+   </TimelineItems>
+</Timeline>

HTMLKit.playground/Resources/HTMLKit.html

@@ -0,0 +1,11 @@
+<html>
+	<head>
+		<title>HTMLKit</title>
+	</head>
+	<body>
+		<h1>HTMLKit</h1>
+		<p>HTMLKit is a <a href="https://html.spec.whatwg.org/multipage">WHATWG specification-compliant</a> Objective-C framework for parsing and serializing HTML documents and document fragments for iOS and OSX.</p>
+		<p>HTMLKit parses real-world HTML the same way modern web browsers would.</p>
+		<p>HTMLKit comes armed with a <a href="http://www.w3.org/TR/css3-selectors">CSS3 Selectors</a> engine for querying the DOM.</p>
+	</body>
+</html>

HTMLKit.playground/contents.xcplayground

@@ -0,0 +1,10 @@
+<?xml version="1.0" encoding="UTF-8" standalone="yes"?>
+<playground version='6.0' target-platform='ios' display-mode='rendered'>
+    <pages>
+        <page name='Intro'/>
+        <page name='Parsing Documents'/>
+        <page name='Parsing Fragments'/>
+        <page name='The DOM'/>
+        <page name='CSS Selectors'/>
+    </pages>
+</playground>

HTMLKit.playground/playground.xcworkspace/contents.xcworkspacedata

@@ -0,0 +1,7 @@
+<?xml version="1.0" encoding="UTF-8"?>
+<Workspace
+   version = "1.0">
+   <FileRef
+      location = "self:">
+   </FileRef>
+</Workspace>

HTMLKit.podspec

@@ -0,0 +1,23 @@
+Pod::Spec.new do |s|
+  s.name               = "HTMLKit"
+  s.version            = "0.9.3"
+  s.summary            = "HTMLKit, an Objective-C framework for your everyday HTML needs."
+  s.license            = "MIT"
+  s.homepage           = "https://github.com/iabudiab/HTMLKit"
+  s.author             = "iabudiab"
+  s.social_media_url   = "https://twitter.com/_iabudiab"
+
+  s.ios.deployment_target = "8.0"
+  s.osx.deployment_target = "10.9"
+  s.watchos.deployment_target = "2.0"
+  s.tvos.deployment_target = "9.0"
+
+  s.source = { :git => "https://github.com/iabudiab/HTMLKit.git", :tag => s.version }
+
+  s.source_files         = "HTMLKit", "HTMLKit/**/*.{h,m}"
+  s.private_header_files = [
+    'HTMLKit/**/*{HTMLToken,HTMLTokens,HTMLTagToken,HTMLCharacterToken,HTMLCommentToken,HTMLDOCTYPEToken,HTMLEOFToken,HTMLTokenizer,HTMLTokenizerCharacters,HTMLTokenizerEntities,HTMLTokenizerStates,HTMLElementAdjustment,HTMLElementTypes,HTMLInputStreamReader,HTMLListOfActiveFormattingElements,HTMLNodeTraversal,HTMLParseErrorToken,HTMLParserInsertionModes,HTMLStackOfOpenElements,HTMLNode+Private,HTMLMarker,CSSCodePoints,CSSInputStream}.h'
+  ]
+
+  s.requires_arc = true
+end

HTMLKit.xcodeproj/xcshareddata/xcschemes/HTMLKit-OSX.xcscheme

@@ -0,0 +1,113 @@
+<?xml version="1.0" encoding="UTF-8"?>
+<Scheme
+   LastUpgradeVersion = "0710"
+   version = "1.3">
+   <BuildAction
+      parallelizeBuildables = "YES"
+      buildImplicitDependencies = "YES">
+      <BuildActionEntries>
+         <BuildActionEntry
+            buildForTesting = "YES"
+            buildForRunning = "YES"
+            buildForProfiling = "YES"
+            buildForArchiving = "YES"
+            buildForAnalyzing = "YES">
+            <BuildableReference
+               BuildableIdentifier = "primary"
+               BlueprintIdentifier = "625A14AB19C7829400AD0C32"
+               BuildableName = "HTMLKit.framework"
+               BlueprintName = "HTMLKit-OSX"
+               ReferencedContainer = "container:HTMLKit.xcodeproj">
+            </BuildableReference>
+         </BuildActionEntry>
+      </BuildActionEntries>
+   </BuildAction>
+   <TestAction
+      buildConfiguration = "Debug"
+      selectedDebuggerIdentifier = "Xcode.DebuggerFoundation.Debugger.LLDB"
+      selectedLauncherIdentifier = "Xcode.DebuggerFoundation.Launcher.LLDB"
+      shouldUseLaunchSchemeArgsEnv = "YES">
+      <Testables>
+         <TestableReference
+            skipped = "NO">
+            <BuildableReference
+               BuildableIdentifier = "primary"
+               BlueprintIdentifier = "625A14C219C7829400AD0C32"
+               BuildableName = "HTMLKitTests-OSX.xctest"
+               BlueprintName = "HTMLKitTests-OSX"
+               ReferencedContainer = "container:HTMLKit.xcodeproj">
+            </BuildableReference>
+            <SkippedTests>
+               <Test
+                  Identifier = "HTMLKitParserPerformance">
+               </Test>
+               <Test
+                  Identifier = "HTMLKitParserPerformance/testParserPerformance">
+               </Test>
+               <Test
+                  Identifier = "HTMLKitTokenizerPerformance">
+               </Test>
+               <Test
+                  Identifier = "HTMLKitTokenizerPerformance/testTokenizerPerformance">
+               </Test>
+            </SkippedTests>
+         </TestableReference>
+      </Testables>
+      <MacroExpansion>
+         <BuildableReference
+            BuildableIdentifier = "primary"
+            BlueprintIdentifier = "625A14AB19C7829400AD0C32"
+            BuildableName = "HTMLKit.framework"
+            BlueprintName = "HTMLKit-OSX"
+            ReferencedContainer = "container:HTMLKit.xcodeproj">
+         </BuildableReference>
+      </MacroExpansion>
+      <AdditionalOptions>
+      </AdditionalOptions>
+   </TestAction>
+   <LaunchAction
+      buildConfiguration = "Debug"
+      selectedDebuggerIdentifier = "Xcode.DebuggerFoundation.Debugger.LLDB"
+      selectedLauncherIdentifier = "Xcode.DebuggerFoundation.Launcher.LLDB"
+      launchStyle = "0"
+      useCustomWorkingDirectory = "NO"
+      ignoresPersistentStateOnLaunch = "NO"
+      debugDocumentVersioning = "YES"
+      debugServiceExtension = "internal"
+      allowLocationSimulation = "YES">
+      <MacroExpansion>
+         <BuildableReference
+            BuildableIdentifier = "primary"
+            BlueprintIdentifier = "625A14AB19C7829400AD0C32"
+            BuildableName = "HTMLKit.framework"
+            BlueprintName = "HTMLKit-OSX"
+            ReferencedContainer = "container:HTMLKit.xcodeproj">
+         </BuildableReference>
+      </MacroExpansion>
+      <AdditionalOptions>
+      </AdditionalOptions>
+   </LaunchAction>
+   <ProfileAction
+      buildConfiguration = "Release"
+      shouldUseLaunchSchemeArgsEnv = "YES"
+      savedToolIdentifier = ""
+      useCustomWorkingDirectory = "NO"
+      debugDocumentVersioning = "YES">
+      <MacroExpansion>
+         <BuildableReference
+            BuildableIdentifier = "primary"
+            BlueprintIdentifier = "625A14AB19C7829400AD0C32"
+            BuildableName = "HTMLKit.framework"
+            BlueprintName = "HTMLKit-OSX"
+            ReferencedContainer = "container:HTMLKit.xcodeproj">
+         </BuildableReference>
+      </MacroExpansion>
+   </ProfileAction>
+   <AnalyzeAction
+      buildConfiguration = "Debug">
+   </AnalyzeAction>
+   <ArchiveAction
+      buildConfiguration = "Release"
+      revealArchiveInOrganizer = "YES">
+   </ArchiveAction>
+</Scheme>

HTMLKit.xcodeproj/xcshareddata/xcschemes/HTMLKit-iOS.xcscheme

@@ -0,0 +1,114 @@
+<?xml version="1.0" encoding="UTF-8"?>
+<Scheme
+   LastUpgradeVersion = "0710"
+   version = "1.3">
+   <BuildAction
+      parallelizeBuildables = "YES"
+      buildImplicitDependencies = "YES">
+      <BuildActionEntries>
+         <BuildActionEntry
+            buildForTesting = "YES"
+            buildForRunning = "YES"
+            buildForProfiling = "YES"
+            buildForArchiving = "YES"
+            buildForAnalyzing = "YES">
+            <BuildableReference
+               BuildableIdentifier = "primary"
+               BlueprintIdentifier = "62ECBF4C1C0B6C7600AF847B"
+               BuildableName = "HTMLKit.framework"
+               BlueprintName = "HTMLKit-iOS"
+               ReferencedContainer = "container:HTMLKit.xcodeproj">
+            </BuildableReference>
+         </BuildActionEntry>
+      </BuildActionEntries>
+   </BuildAction>
+   <TestAction
+      buildConfiguration = "Debug"
+      selectedDebuggerIdentifier = "Xcode.DebuggerFoundation.Debugger.LLDB"
+      selectedLauncherIdentifier = "Xcode.DebuggerFoundation.Launcher.LLDB"
+      shouldUseLaunchSchemeArgsEnv = "YES"
+      codeCoverageEnabled = "YES">
+      <Testables>
+         <TestableReference
+            skipped = "NO">
+            <BuildableReference
+               BuildableIdentifier = "primary"
+               BlueprintIdentifier = "62ECBF551C0B6C7600AF847B"
+               BuildableName = "HTMLKitTests-iOS.xctest"
+               BlueprintName = "HTMLKitTests-iOS"
+               ReferencedContainer = "container:HTMLKit.xcodeproj">
+            </BuildableReference>
+            <SkippedTests>
+               <Test
+                  Identifier = "HTMLKitParserPerformance">
+               </Test>
+               <Test
+                  Identifier = "HTMLKitParserPerformance/testParserPerformance">
+               </Test>
+               <Test
+                  Identifier = "HTMLKitTokenizerPerformance">
+               </Test>
+               <Test
+                  Identifier = "HTMLKitTokenizerPerformance/testTokenizerPerformance">
+               </Test>
+            </SkippedTests>
+         </TestableReference>
+      </Testables>
+      <MacroExpansion>
+         <BuildableReference
+            BuildableIdentifier = "primary"
+            BlueprintIdentifier = "62ECBF4C1C0B6C7600AF847B"
+            BuildableName = "HTMLKit.framework"
+            BlueprintName = "HTMLKit-iOS"
+            ReferencedContainer = "container:HTMLKit.xcodeproj">
+         </BuildableReference>
+      </MacroExpansion>
+      <AdditionalOptions>
+      </AdditionalOptions>
+   </TestAction>
+   <LaunchAction
+      buildConfiguration = "Debug"
+      selectedDebuggerIdentifier = "Xcode.DebuggerFoundation.Debugger.LLDB"
+      selectedLauncherIdentifier = "Xcode.DebuggerFoundation.Launcher.LLDB"
+      launchStyle = "0"
+      useCustomWorkingDirectory = "NO"
+      ignoresPersistentStateOnLaunch = "NO"
+      debugDocumentVersioning = "YES"
+      debugServiceExtension = "internal"
+      allowLocationSimulation = "YES">
+      <MacroExpansion>
+         <BuildableReference
+            BuildableIdentifier = "primary"
+            BlueprintIdentifier = "62ECBF4C1C0B6C7600AF847B"
+            BuildableName = "HTMLKit.framework"
+            BlueprintName = "HTMLKit-iOS"
+            ReferencedContainer = "container:HTMLKit.xcodeproj">
+         </BuildableReference>
+      </MacroExpansion>
+      <AdditionalOptions>
+      </AdditionalOptions>
+   </LaunchAction>
+   <ProfileAction
+      buildConfiguration = "Release"
+      shouldUseLaunchSchemeArgsEnv = "YES"
+      savedToolIdentifier = ""
+      useCustomWorkingDirectory = "NO"
+      debugDocumentVersioning = "YES">
+      <MacroExpansion>
+         <BuildableReference
+            BuildableIdentifier = "primary"
+            BlueprintIdentifier = "62ECBF4C1C0B6C7600AF847B"
+            BuildableName = "HTMLKit.framework"
+            BlueprintName = "HTMLKit-iOS"
+            ReferencedContainer = "container:HTMLKit.xcodeproj">
+         </BuildableReference>
+      </MacroExpansion>
+   </ProfileAction>
+   <AnalyzeAction
+      buildConfiguration = "Debug">
+   </AnalyzeAction>
+   <ArchiveAction
+      buildConfiguration = "Release"
+      revealArchiveInOrganizer = "YES">
+   </ArchiveAction>
+</Scheme>

HTMLKit.xcodeproj/xcshareddata/xcschemes/HTMLKit-tvOS.xcscheme

@@ -0,0 +1,107 @@
+<?xml version="1.0" encoding="UTF-8"?>
+<Scheme
+   LastUpgradeVersion = "0730"
+   version = "1.3">
+   <BuildAction
+      parallelizeBuildables = "YES"
+      buildImplicitDependencies = "YES">
+      <BuildActionEntries>
+         <BuildActionEntry
+            buildForTesting = "YES"
+            buildForRunning = "YES"
+            buildForProfiling = "YES"
+            buildForArchiving = "YES"
+            buildForAnalyzing = "YES">
+            <BuildableReference
+               BuildableIdentifier = "primary"
+               BlueprintIdentifier = "62857CE91D39A262008DC254"
+               BuildableName = "HTMLKit.framework"
+               BlueprintName = "HTMLKit-tvOS"
+               ReferencedContainer = "container:HTMLKit.xcodeproj">
+            </BuildableReference>
+         </BuildActionEntry>
+      </BuildActionEntries>
+   </BuildAction>
+   <TestAction
+      buildConfiguration = "Debug"
+      selectedDebuggerIdentifier = "Xcode.DebuggerFoundation.Debugger.LLDB"
+      selectedLauncherIdentifier = "Xcode.DebuggerFoundation.Launcher.LLDB"
+      shouldUseLaunchSchemeArgsEnv = "YES">
+      <Testables>
+         <TestableReference
+            skipped = "NO">
+            <BuildableReference
+               BuildableIdentifier = "primary"
+               BlueprintIdentifier = "62857CF21D39A262008DC254"
+               BuildableName = "HTMLKit-tvOSTests.xctest"
+               BlueprintName = "HTMLKit-tvOSTests"
+               ReferencedContainer = "container:HTMLKit.xcodeproj">
+            </BuildableReference>
+            <SkippedTests>
+               <Test
+                  Identifier = "HTMLKitParserPerformance">
+               </Test>
+               <Test
+                  Identifier = "HTMLKitTokenizerPerformance">
+               </Test>
+            </SkippedTests>
+         </TestableReference>
+      </Testables>
+      <MacroExpansion>
+         <BuildableReference
+            BuildableIdentifier = "primary"
+            BlueprintIdentifier = "62857CE91D39A262008DC254"
+            BuildableName = "HTMLKit.framework"
+            BlueprintName = "HTMLKit-tvOS"
+            ReferencedContainer = "container:HTMLKit.xcodeproj">
+         </BuildableReference>
+      </MacroExpansion>
+      <AdditionalOptions>
+      </AdditionalOptions>
+   </TestAction>
+   <LaunchAction
+      buildConfiguration = "Debug"
+      selectedDebuggerIdentifier = "Xcode.DebuggerFoundation.Debugger.LLDB"
+      selectedLauncherIdentifier = "Xcode.DebuggerFoundation.Launcher.LLDB"
+      launchStyle = "0"
+      useCustomWorkingDirectory = "NO"
+      ignoresPersistentStateOnLaunch = "NO"
+      debugDocumentVersioning = "YES"
+      debugServiceExtension = "internal"
+      allowLocationSimulation = "YES">
+      <MacroExpansion>
+         <BuildableReference
+            BuildableIdentifier = "primary"
+            BlueprintIdentifier = "62857CE91D39A262008DC254"
+            BuildableName = "HTMLKit.framework"
+            BlueprintName = "HTMLKit-tvOS"
+            ReferencedContainer = "container:HTMLKit.xcodeproj">
+         </BuildableReference>
+      </MacroExpansion>
+      <AdditionalOptions>
+      </AdditionalOptions>
+   </LaunchAction>
+   <ProfileAction
+      buildConfiguration = "Release"
+      shouldUseLaunchSchemeArgsEnv = "YES"
+      savedToolIdentifier = ""
+      useCustomWorkingDirectory = "NO"
+      debugDocumentVersioning = "YES">
+      <MacroExpansion>
+         <BuildableReference
+            BuildableIdentifier = "primary"
+            BlueprintIdentifier = "62857CE91D39A262008DC254"
+            BuildableName = "HTMLKit.framework"
+            BlueprintName = "HTMLKit-tvOS"
+            ReferencedContainer = "container:HTMLKit.xcodeproj">
+         </BuildableReference>
+      </MacroExpansion>
+   </ProfileAction>
+   <AnalyzeAction
+      buildConfiguration = "Debug">
+   </AnalyzeAction>
+   <ArchiveAction
+      buildConfiguration = "Release"
+      revealArchiveInOrganizer = "YES">
+   </ArchiveAction>
+</Scheme>

HTMLKit.xcodeproj/xcshareddata/xcschemes/HTMLKit-watchOS.xcscheme

@@ -0,0 +1,80 @@
+<?xml version="1.0" encoding="UTF-8"?>
+<Scheme
+   LastUpgradeVersion = "0730"
+   version = "1.3">
+   <BuildAction
+      parallelizeBuildables = "YES"
+      buildImplicitDependencies = "YES">
+      <BuildActionEntries>
+         <BuildActionEntry
+            buildForTesting = "YES"
+            buildForRunning = "YES"
+            buildForProfiling = "YES"
+            buildForArchiving = "YES"
+            buildForAnalyzing = "YES">
+            <BuildableReference
+               BuildableIdentifier = "primary"
+               BlueprintIdentifier = "62857C4D1D398642008DC254"
+               BuildableName = "HTMLKit.framework"
+               BlueprintName = "HTMLKit-watchOS"
+               ReferencedContainer = "container:HTMLKit.xcodeproj">
+            </BuildableReference>
+         </BuildActionEntry>
+      </BuildActionEntries>
+   </BuildAction>
+   <TestAction
+      buildConfiguration = "Debug"
+      selectedDebuggerIdentifier = "Xcode.DebuggerFoundation.Debugger.LLDB"
+      selectedLauncherIdentifier = "Xcode.DebuggerFoundation.Launcher.LLDB"
+      shouldUseLaunchSchemeArgsEnv = "YES">
+      <Testables>
+      </Testables>
+      <AdditionalOptions>
+      </AdditionalOptions>
+   </TestAction>
+   <LaunchAction
+      buildConfiguration = "Debug"
+      selectedDebuggerIdentifier = "Xcode.DebuggerFoundation.Debugger.LLDB"
+      selectedLauncherIdentifier = "Xcode.DebuggerFoundation.Launcher.LLDB"
+      launchStyle = "0"
+      useCustomWorkingDirectory = "NO"
+      ignoresPersistentStateOnLaunch = "NO"
+      debugDocumentVersioning = "YES"
+      debugServiceExtension = "internal"
+      allowLocationSimulation = "YES">
+      <MacroExpansion>
+         <BuildableReference
+            BuildableIdentifier = "primary"
+            BlueprintIdentifier = "62857C4D1D398642008DC254"
+            BuildableName = "HTMLKit.framework"
+            BlueprintName = "HTMLKit-watchOS"
+            ReferencedContainer = "container:HTMLKit.xcodeproj">
+         </BuildableReference>
+      </MacroExpansion>
+      <AdditionalOptions>
+      </AdditionalOptions>
+   </LaunchAction>
+   <ProfileAction
+      buildConfiguration = "Release"
+      shouldUseLaunchSchemeArgsEnv = "YES"
+      savedToolIdentifier = ""
+      useCustomWorkingDirectory = "NO"
+      debugDocumentVersioning = "YES">
+      <MacroExpansion>
+         <BuildableReference
+            BuildableIdentifier = "primary"
+            BlueprintIdentifier = "62857C4D1D398642008DC254"
+            BuildableName = "HTMLKit.framework"
+            BlueprintName = "HTMLKit-watchOS"
+            ReferencedContainer = "container:HTMLKit.xcodeproj">
+         </BuildableReference>
+      </MacroExpansion>
+   </ProfileAction>
+   <AnalyzeAction
+      buildConfiguration = "Debug">
+   </AnalyzeAction>
+   <ArchiveAction
+      buildConfiguration = "Release"
+      revealArchiveInOrganizer = "YES">
+   </ArchiveAction>
+</Scheme>

HTMLKit.xcworkspace/contents.xcworkspacedata

@@ -0,0 +1,10 @@
+<?xml version="1.0" encoding="UTF-8"?>
+<Workspace
+   version = "1.0">
+   <FileRef
+      location = "group:HTMLKit.xcodeproj">
+   </FileRef>
+   <FileRef
+      location = "group:HTMLKit.playground">
+   </FileRef>
+</Workspace>

HTMLKit/CSSAttributeSelector.h

@@ -0,0 +1,72 @@
+//
+//  CSSAttributeSelector.h
+//  HTMLKit
+//
+//  Created by Iska on 14/05/15.
+//  Copyright (c) 2015 BrainCookie. All rights reserved.
+//
+
+#import <Foundation/Foundation.h>
+#import "CSSSelector.h"
+
+NS_ASSUME_NONNULL_BEGIN
+
+/**
+ CSS Attribute Selector.
+ */
+@interface CSSAttributeSelector : CSSSelector
+
+/**
+ The selector type.
+ */
+@property (nonatomic, assign, readonly) CSSAttributeSelectorType type;
+
+/**
+ The attribute name which should be matched.
+ */
+@property (nonatomic, strong, readonly) NSString *name;
+
+/**
+ The attribute value against which should be checked.
+ */
+@property (nonatomic, strong, readonly) NSString *value;
+
+/**
+ Intializes and returns a CSS class selector.
+
+ @param className The class name to match.
+ @return A new instance of class selector.
+ */
++ (instancetype)classSelector:(NSString *)className;
+
+/**
+ Intializes and returns a CSS id selector.
+
+ @param elementId The element id to match.
+ @return A new instance of id selector.
+ */
++ (instancetype)idSelector:(NSString *)elementId;
+
+/**
+ Intializes and returns a CSS has-attribute selector.
+
+ @param attributeName The attribute name to match.
+ @return A new instance of has-attribute selector.
+ */
++ (instancetype)hasAttributeSelector:(NSString *)attributeName;
+
+/**
+ Intializes and returns a CSS attribute selector.
+
+ @param type The selector type.
+ @param name The attribute name to match.
+ @param value The value to match.
+ @return A new instance of attribute selector.
+ */
+- (instancetype)initWithType:(CSSAttributeSelectorType)type
+			   attributeName:(NSString *)name
+			  attrbiuteValue:(NSString *)value;
+
+@end
+
+NS_ASSUME_NONNULL_END

HTMLKit/CSSAttributeSelector.m

@@ -0,0 +1,111 @@
+//
+//  CSSAttributeSelector.m
+//  HTMLKit
+//
+//  Created by Iska on 14/05/15.
+//  Copyright (c) 2015 BrainCookie. All rights reserved.
+//
+
+#import "CSSAttributeSelector.h"
+#import "HTMLElement.h"
+#import "NSCharacterSet+HTMLKit.h"
+
+@interface CSSAttributeSelector ()
+{
+	CSSAttributeSelectorType _type;
+	NSString *_name;
+	NSString *_value;
+}
+@end
+
+@implementation CSSAttributeSelector
+
++ (instancetype)classSelector:(NSString *)className
+{
+	return [[self alloc] initWithType:CSSAttributeSelectorIncludes attributeName:@"class" attrbiuteValue:className];
+}
+
++ (instancetype)idSelector:(NSString *)elementId
+{
+	return [[self alloc] initWithType:CSSAttributeSelectorExactMatch attributeName:@"id" attrbiuteValue:elementId];
+}
+
++ (instancetype)hasAttributeSelector:(NSString *)attributeName
+{
+	return [[self alloc] initWithType:CSSAttributeSelectorExists attributeName:attributeName attrbiuteValue:@""];
+}
+
+- (instancetype)initWithType:(CSSAttributeSelectorType)type
+			   attributeName:(NSString *)name
+			  attrbiuteValue:(NSString *)value
+{
+	self = [super init];
+	if (self) {
+		_type = type;
+		_name = [name copy];
+		_value = value ? [value copy]: @"";
+	}
+	return self;
+}
+
+- (BOOL)acceptElement:(HTMLElement *)element
+{
+	switch (_type) {
+		case CSSAttributeSelectorExists:
+		{
+			return !!element[_name];
+		}
+		case CSSAttributeSelectorExactMatch:
+		{
+			return [element[_name] isEqualToString:_value];
+		}
+		case CSSAttributeSelectorIncludes:
+		{
+			NSArray *components = [element[_name] componentsSeparatedByCharactersInSet:[NSCharacterSet HTMLWhitespaceCharacterSet]];
+			return [components containsObject:_value];
+		}
+		case CSSAttributeSelectorBegins:
+		{
+			return [element[_name] hasPrefix:_value];
+		}
+		case CSSAttributeSelectorEnds:
+		{
+			return [element[_name] hasSuffix:_value];
+		}
+		case CSSAttributeSelectorContains:
+		{
+			return [element[_name] containsString:_value];
+		}
+		case CSSAttributeSelectorHyphen:
+		{
+			return [element[_name] isEqualToString:_value] || [element[_name] hasPrefix:[_value stringByAppendingString:@"-"]];
+		}
+		case CSSAttributeSelectorNot:
+		{
+			return ![element[_name] isEqualToString:_value];
+		}
+		default:
+			return NO;
+	}
+}
+
+#pragma mark - Description
+
+- (NSString *)debugDescription
+{
+	if (self.type == CSSAttributeSelectorExists) {
+		return [NSString stringWithFormat:@"[%@]", self.name];
+	}
+
+	NSString *matcher = @{@(CSSAttributeSelectorExactMatch): @"=",
+						  @(CSSAttributeSelectorIncludes): @"~=",
+						  @(CSSAttributeSelectorBegins): @"^=",
+						  @(CSSAttributeSelectorEnds): @"$=",
+						  @(CSSAttributeSelectorContains): @"*=",
+						  @(CSSAttributeSelectorHyphen): @"|=",
+						  @(CSSAttributeSelectorNot): @"!="}[@(self.type)];
+
+	return [NSString stringWithFormat:@"[%@%@'%@']", self.name, matcher, self.value];
+}
+
+@end

HTMLKit/CSSCodePoints.h

@@ -0,0 +1,144 @@
+//
+//  CSSTokenizer	CODEPOINTs.h
+//  HTMLKit
+//
+//  Created by Iska on 08/06/15.
+//  Copyright (c) 2015 BrainCookie. All rights reserved.
+//
+
+///------------------------------------------------------
+/// HTMLKit private header
+//------------------------------------------------------
+
+#define CODEPOINTS \
+	CODEPOINT( CONTROL, 0x0080 ) \
+	CODEPOINT( CHARACTER_TABULATION, 0x0009 ) \
+	CODEPOINT( LINE_FEED, 0x000A ) \
+	CODEPOINT( SPACE, 0x0020 ) \
+	CODEPOINT( QUOTATION_MARK, 0x0022 ) \
+	CODEPOINT( NUMBER_SIGN, 0x0023 ) \
+	CODEPOINT( DOLLAR_SIGN, 0x0024 ) \
+	CODEPOINT( APOSTROPHE, 0x0027 ) \
+	CODEPOINT( LEFT_PARENTHESIS, 0x0028 ) \
+	CODEPOINT( RIGHT_PARENTHESIS, 0x0029 ) \
+	CODEPOINT( ASTERIX, 0x002A ) \
+	CODEPOINT( PLUS_SIGN, 0x002B ) \
+	CODEPOINT( COMMA, 0x002C ) \
+	CODEPOINT( HYPHEN_MINUS, 0x002D ) \
+	CODEPOINT( FULL_STOP, 0x002E ) \
+	CODEPOINT( DIGIT_ZERO, 0x0030 ) \
+	CODEPOINT( DIGIT_NINE, 0x0039 ) \
+	CODEPOINT( COLON, 0x003A ) \
+	CODEPOINT( EQUALS_SIGN, 0x003D ) \
+	CODEPOINT( GREATER_THAN_SIGN, 0x003E ) \
+	CODEPOINT( LATIN_CAPITAL_LETTER_A, 0x0041 ) \
+	CODEPOINT( LATIN_CAPITAL_LETTER_F, 0x0046 ) \
+	CODEPOINT( LATIN_CAPITAL_LETTER_Z, 0x005A ) \
+	CODEPOINT( LEFT_SQUARE_BRACKET, 0x005B ) \
+	CODEPOINT( REVERSE_SOLIDUS, 0x005C ) \
+	CODEPOINT( RIGHT_SQUARE_BRACKET, 0x005D ) \
+	CODEPOINT( CIRCUMFLEX_ACCENT, 0x005E ) \
+	CODEPOINT( LOW_LINE, 0x005F ) \
+	CODEPOINT( LATIN_SMALL_LETTER_A, 0x0061 ) \
+	CODEPOINT( LATIN_SMALL_LETTER_F, 0x0066 ) \
+	CODEPOINT( LATIN_SMALL_LETTER_Z, 0x007A ) \
+	CODEPOINT( VERTICAL_LINE, 0x007C ) \
+	CODEPOINT( TILDE, 0x007E ) \
+	CODEPOINT( REPLACEMENT_CHARACTER, 0xFFFD )
+
+#define CODEPOINT( name, value ) static UniChar const name = value;
+CODEPOINTS
+#undef CODEPOINT
+
+NS_INLINE BOOL isWhitespace(UTF32Char codePoint)
+{
+	return (codePoint == CHARACTER_TABULATION ||
+			codePoint == LINE_FEED ||
+			codePoint == SPACE);
+}
+
+NS_INLINE BOOL isCombinator(UTF32Char codePoint)
+{
+	return (codePoint == SPACE ||
+			codePoint == PLUS_SIGN ||
+			codePoint == COMMA ||
+			codePoint == GREATER_THAN_SIGN ||
+			codePoint == TILDE);
+}
+
+NS_INLINE BOOL isDigit(UTF32Char codePoint)
+{
+	return codePoint >= DIGIT_ZERO && codePoint <= DIGIT_NINE;
+}
+
+NS_INLINE BOOL isHexDigit(UTF32Char codePoint)
+{
+	return ((codePoint >= DIGIT_ZERO && codePoint <= DIGIT_NINE) ||
+			(codePoint >= LATIN_CAPITAL_LETTER_A && codePoint <= LATIN_CAPITAL_LETTER_F) ||
+			(codePoint >= LATIN_SMALL_LETTER_A && codePoint <= LATIN_SMALL_LETTER_F));
+}
+
+NS_INLINE BOOL isQuote(UTF32Char codePoint)
+{
+	return codePoint == QUOTATION_MARK || codePoint == APOSTROPHE;
+}
+
+NS_INLINE BOOL isNewLine(UTF32Char codePoint)
+{
+	return codePoint == LINE_FEED;
+}
+
+NS_INLINE BOOL isNameStart(UTF32Char codePoint)
+{
+	return ((codePoint >= LATIN_CAPITAL_LETTER_A && codePoint <= LATIN_CAPITAL_LETTER_Z) ||
+			(codePoint >= LATIN_SMALL_LETTER_A && codePoint <= LATIN_SMALL_LETTER_Z) ||
+			codePoint >= CONTROL ||
+			codePoint == LOW_LINE);
+}
+
+NS_INLINE BOOL isName(UTF32Char codePoint)
+{
+	return isNameStart(codePoint) || isDigit(codePoint) || codePoint == HYPHEN_MINUS;
+}
+
+NS_INLINE BOOL isValidEscape(UTF32Char first, UTF32Char second)
+{
+	if (first != REVERSE_SOLIDUS || isNewLine(second)) {
+		return false;
+	}
+
+	return YES;
+}
+
+NS_INLINE BOOL isValidEscapedCodePoint(UTF32Char codePoint)
+{
+	return (codePoint != 0 &&
+			!(codePoint >= 0xD800 && codePoint <= 0x0DFFF) &&
+			codePoint <= 0x10FFFF);
+}
+
+NS_INLINE BOOL isValidIdentifierStart(UTF32Char first, UTF32Char second, UTF32Char third)
+{
+	if (first == HYPHEN_MINUS) {
+		if (isNameStart(second) ||
+			second == HYPHEN_MINUS ||
+			isValidEscape(second, third)) {
+			return YES;
+		} else {
+			return NO;
+		}
+	} else if (isNameStart(first)) {
+		return YES;
+	} else if (first == REVERSE_SOLIDUS) {
+		return isValidEscape(first, second);
+	} else {
+		return NO;
+	}
+}
+
+NS_INLINE void AppendCodePoint(CFMutableStringRef string, UTF32Char codePoint)
+{
+	UniChar pair[2];
+	Boolean isPair = CFStringGetSurrogatePairForLongCharacter(codePoint, pair);
+	CFStringAppendCharacters(string, pair, isPair ? 2 : 1);
+}

HTMLKit/CSSCombinatorSelector.h

@@ -0,0 +1,52 @@
+//
+//  CSSCombinatorSelector.h
+//  HTMLKit
+//
+//  Created by Iska on 12/10/15.
+//  Copyright © 2015 BrainCookie. All rights reserved.
+//
+
+#import "CSSSelector.h"
+
+NS_ASSUME_NONNULL_BEGIN
+
+/**
+ CSS Combinator Selector.
+ */
+@interface CSSCombinatorSelector : CSSSelector
+
+/**
+ Initializes and returns a CSS child-of-element selector, e.g. 'div > p'
+
+ @param selector The selector matching the parent element.
+ @return A new instance of the child of element selector.
+ */
++ (instancetype)childOfElementCombinator:(CSSSelector *)selector;
+
+/**
+ Initializes and returns a CSS descendant-of-element selector, e.g. 'div p'
+
+ @param selector The selector matching the ancestor element.
+ @return A new instance of the descendant of element selector.
+ */
++ (instancetype)descendantOfElementCombinator:(CSSSelector *)selector;
+
+/**
+ Initializes and returns a CSS adjacent sibling selector, e.g. 'p + a'
+
+ @param selector The selector matching the adjacent sibling element.
+ @return A new instance of the adjacent sibling selector.
+ */
++ (instancetype)adjacentSiblingCombinator:(CSSSelector *)selector;
+
+/**
+ Initializes and returns a CSS general sibling selector, e.g. 'p ~ a'
+
+ @param selector The selector matching the general sibling element.
+ @return A new instance of the general sibling selector.
+ */
++ (instancetype)generalSiblingCombinator:(CSSSelector *)selector;
+
+@end
+
+NS_ASSUME_NONNULL_END

HTMLKit/CSSCombinatorSelector.m

@@ -0,0 +1,155 @@
+//
+//  CSSCombinatorSelector.m
+//  HTMLKit
+//
+//  Created by Iska on 12/10/15.
+//  Copyright © 2015 BrainCookie. All rights reserved.
+//
+
+#import "CSSCombinatorSelector.h"
+#import "HTMLElement.h"
+#import "HTMLNode+Private.h"
+
+#pragma mark - Declarations
+
+@interface CSSChildOfElementCombinatorSelector : CSSCombinatorSelector
+@end
+
+@interface CSSDecendantOfElementCombinatorSelector : CSSCombinatorSelector
+@end
+
+@interface CSSAdjacentSiblingCombinatorSelector : CSSCombinatorSelector
+@end
+
+@interface CSSGeneralSiblingCombinatorSelector : CSSCombinatorSelector
+@end
+
+#pragma mark - Base Combinator
+
+@interface CSSCombinatorSelector ()
+{
+	CSSSelector *_selector;
+}
+@property (nonatomic, strong, readonly) CSSSelector *selector;
+@end
+
+@implementation CSSCombinatorSelector
+@synthesize selector = _selector;
+
++ (instancetype)childOfElementCombinator:(CSSSelector *)selector
+{
+	return [[CSSChildOfElementCombinatorSelector alloc] initWithSelector:selector];
+}
+
++ (instancetype)descendantOfElementCombinator:(CSSSelector *)selector
+{
+	return [[CSSDecendantOfElementCombinatorSelector alloc] initWithSelector:selector];
+}
+
++ (instancetype)adjacentSiblingCombinator:(CSSSelector *)selector
+{
+	return [[CSSAdjacentSiblingCombinatorSelector alloc] initWithSelector:selector];
+}
+
++ (instancetype)generalSiblingCombinator:(CSSSelector *)selector
+{
+	return [[CSSGeneralSiblingCombinatorSelector alloc] initWithSelector:selector];
+}
+
+- (instancetype)initWithSelector:(CSSSelector *)selector
+{
+	self = [super init];
+	if (self) {
+		_selector = selector;
+	}
+	return self;
+}
+
+@end
+
+#pragma mark - Child OfElement Combinator
+
+@implementation CSSChildOfElementCombinatorSelector
+
+- (BOOL)acceptElement:(HTMLElement *)element
+{
+	HTMLElement *parent = element.parentElement;
+	return parent != nil && [self.selector acceptElement:parent];
+}
+
+- (NSString *)debugDescription
+{
+	return [NSString stringWithFormat:@"%@ > ", self.selector.debugDescription];
+}
+
+@end
+
+#pragma mark - Decendant Of Element Combinator
+
+@implementation CSSDecendantOfElementCombinatorSelector
+
+- (BOOL)acceptElement:(HTMLElement *)element
+{
+	HTMLElement *parent = element.parentElement;
+
+	while (parent != nil) {
+		if ([self.selector acceptElement:parent]) {
+			return YES;
+		}
+		parent = parent.parentElement;
+	}
+
+	return NO;
+}
+
+- (NSString *)debugDescription
+{
+	return [NSString stringWithFormat:@"%@ ", self.selector.debugDescription];
+}
+
+@end
+
+#pragma mark - Adjacent Sibling Combinator
+
+@implementation CSSAdjacentSiblingCombinatorSelector
+
+- (BOOL)acceptElement:(HTMLElement *)element
+{
+	HTMLNode *previous = element.previousSiblingElement;
+	if (previous == nil || previous.nodeType != HTMLNodeElement) {
+		return NO;
+	}
+	return [self.selector acceptElement:previous.asElement];
+}
+
+- (NSString *)debugDescription
+{
+	return [NSString stringWithFormat:@"%@ + ", self.selector.debugDescription];
+}
+
+@end
+
+#pragma mark - General Sibling Combinator
+
+@implementation CSSGeneralSiblingCombinatorSelector
+
+- (BOOL)acceptElement:(HTMLElement *)element
+{
+	HTMLNode *previous = element.previousSiblingElement;
+
+	while (previous != nil && previous.nodeType == HTMLNodeElement) {
+		if ([self.selector acceptElement:previous.asElement]) {
+			return YES;
+		}
+		previous = previous.previousSiblingElement;
+	}
+
+	return NO;
+}
+
+- (NSString *)debugDescription
+{
+	return [NSString stringWithFormat:@"%@ ~ ", self.selector.debugDescription];
+}
+
+@end

HTMLKit/CSSCompoundSelector.h

@@ -0,0 +1,43 @@
+//
+//  CSSCompoundSelector.h
+//  HTMLKit
+//
+//  Created by Iska on 18/10/15.
+//  Copyright © 2015 BrainCookie. All rights reserved.
+//
+
+#import "CSSSelector.h"
+
+NS_ASSUME_NONNULL_BEGIN
+
+/**
+ A Compound Selector, groups other selectors with a 'all-of' or 'any-of' relationship.
+ */
+@interface CSSCompoundSelector : CSSSelector
+
+/**
+ Initializes and returns a new compound selector matching only elements that match all of the specified selectors.
+
+ @param selectors The selectors list.
+ @return A new instance of the All-Of selector.
+ */
++ (instancetype)andSelector:(NSArray<CSSSelector *> *)selectors;
+
+/**
+ Initializes and returns a new compound selector matching all elements that match at least one of the specified selectors.
+
+ @param selectors The selectors list.
+ @return A new instance of the Any-Of selector.
+ */
++ (instancetype)orSelector:(NSArray<CSSSelector *> *)selectors;
+
+/**
+ Add the specified selector to the compound.
+
+ @param selector The selector to add.
+ */
+- (void)addSelector:(CSSSelector *)selector;
+
+@end
+
+NS_ASSUME_NONNULL_END

HTMLKit/CSSCompoundSelector.m

@@ -0,0 +1,99 @@
+//
+//  CSSCompoundSelector.m
+//  HTMLKit
+//
+//  Created by Iska on 18/10/15.
+//  Copyright © 2015 BrainCookie. All rights reserved.
+//
+
+#import "CSSCompoundSelector.h"
+
+#pragma mark - Declarations
+
+@interface CSSAndCompoundSelector : CSSCompoundSelector
+@end
+
+@interface CSSOrCompoundSelector : CSSCompoundSelector
+@end
+
+#pragma mark - Base Combinator
+
+@interface CSSCompoundSelector ()
+{
+	NSMutableArray *_selectors;
+}
+@property (nonatomic, strong, readonly) NSArray *selectors;
+@end
+
+@implementation CSSCompoundSelector
+@synthesize selectors = _selectors;
+
++ (instancetype)andSelector:(NSArray *)selectors
+{
+	return [[CSSAndCompoundSelector alloc] initWithSelectors:selectors];
+}
+
++ (instancetype)orSelector:(NSArray *)selectors
+{
+	return [[CSSOrCompoundSelector alloc] initWithSelectors:selectors];
+}
+
+- (instancetype)initWithSelectors:(NSArray *)selectors
+{
+	self = [super init];
+	if (self) {
+		_selectors = [[NSMutableArray alloc] initWithArray:selectors];
+	}
+	return self;
+}
+
+- (void)addSelector:(CSSSelector *)selector
+{
+	[_selectors addObject:selector];
+}
+
+@end
+
+#pragma mark - And Compound Selector
+
+@implementation CSSAndCompoundSelector
+
+- (BOOL)acceptElement:(HTMLElement *)element
+{
+	for (CSSSelector *selector in self.selectors) {
+		if (![selector acceptElement:element]) {
+			return NO;
+		}
+	}
+	return YES;
+}
+
+- (NSString *)debugDescription
+{
+	NSArray *descriptions = [self.selectors valueForKey:@"debugDescription"];
+	return [descriptions componentsJoinedByString:@""];
+}
+
+@end
+
+#pragma mark - Or Compound Selector
+
+@implementation CSSOrCompoundSelector
+
+- (BOOL)acceptElement:(HTMLElement *)element
+{
+	for (CSSSelector *selector in self.selectors) {
+		if ([selector acceptElement:element]) {
+			return YES;
+		}
+	}
+	return NO;
+}
+
+- (NSString *)debugDescription
+{
+	NSArray *descriptions = [self.selectors valueForKey:@"debugDescription"];
+	return [descriptions componentsJoinedByString:@","];
+}
+
+@end

HTMLKit/CSSInputStream.h

@@ -0,0 +1,62 @@
+//
+//  CSSInputStream.h
+//  HTMLKit
+//
+//  Created by Iska on 07/06/15.
+//  Copyright (c) 2015 BrainCookie. All rights reserved.
+//
+
+///------------------------------------------------------
+/// HTMLKit private header
+///------------------------------------------------------
+
+#import <Foundation/Foundation.h>
+#import "HTMLInputStreamReader.h"
+
+/**
+ The CSS Inpute Stream.
+
+ Extends the HTML Input Stream with methods relevant to CSS selectors tokenizing/parsing.
+ */
+@interface CSSInputStream : HTMLInputStreamReader
+
+/**
+ Consumes leading whitespace characters.
+ */
+- (void)consumeWhitespace;
+
+/**
+ Consumes a CSS identifier.
+ http://www.w3.org/TR/css-syntax-3/#consume-an-ident-like-token
+ http://www.w3.org/TR/css-syntax-3/#consume-a-string-token
+ http://www.w3.org/TR/css-syntax-3/#would-start-an-identifier
+
+ @return A consumed identifier, `nil` if the stream doesn't start with a valid identifier.
+ */
+- (NSString *)consumeIdentifier;
+
+/**
+ Consumes characters until the specified code-point is met.
+
+ @param endingCodePoint The code-point at which the input stream stops consuming.
+ @return The consumed string, `nil` nothing was consumed.
+ */
+- (NSString *)consumeStringWithEndingCodePoint:(UTF32Char)endingCodePoint;
+
+/**
+ Consumes an escaped code point.
+ http://www.w3.org/TR/css-syntax-3/#consume-an-escaped-code-point
+ http://www.w3.org/TR/css-syntax-3/#starts-with-a-valid-escape
+
+ @return The value of the escaped code-point.
+ */
+- (UTF32Char)consumeEscapedCodePoint;
+
+/**
+ Consumes a CSS selector combinator.
+ 
+ @return The consumed combinator, `nil` if nothing was consumed.
+ */
+- (NSString *)consumeCombinator;
+
+@end

HTMLKit/CSSInputStream.m

@@ -0,0 +1,128 @@
+//
+//  CSSInputStream.m
+//  HTMLKit
+//
+//  Created by Iska on 07/06/15.
+//  Copyright (c) 2015 BrainCookie. All rights reserved.
+//
+
+#import "CSSInputStream.h"
+#import "CSSCodePoints.h"
+
+@interface HTMLInputStreamReader ()
+- (void)emitParseError:(NSString *)reason;
+@end
+
+@implementation CSSInputStream
+
+- (void)consumeWhitespace
+{
+	while (isWhitespace(self.nextInputCharacter)) {
+		[self consumeNextInputCharacter];
+	}
+}
+
+- (NSString *)consumeIdentifier
+{
+	CFMutableStringRef value = CFStringCreateMutable(kCFAllocatorDefault, 0);
+
+	if (!isValidIdentifierStart([self inputCharacterPointAtOffset:0],
+								[self inputCharacterPointAtOffset:1],
+								[self inputCharacterPointAtOffset:2])) {
+		return nil;
+	}
+
+	while (YES) {
+		UTF32Char codePoint = [self consumeNextInputCharacter];
+		if (codePoint == EOF) {
+			break;
+		} else if (isName(codePoint)) {
+			AppendCodePoint(value, codePoint);
+		} else if (isValidEscape(codePoint, [self inputCharacterPointAtOffset:1])) {
+			UTF32Char escapedCodePoint = [self consumeEscapedCodePoint];
+			AppendCodePoint(value, escapedCodePoint);
+		} else {
+			[self reconsumeCurrentInputCharacter];
+			break;
+		}
+	}
+
+	return (__bridge NSString *)(CFStringGetLength(value) > 0 ? value : nil);
+}
+
+- (NSString *)consumeStringWithEndingCodePoint:(UTF32Char)endingCodePoint
+{
+	CFMutableStringRef value = CFStringCreateMutable(kCFAllocatorDefault, 0);
+
+	while (YES) {
+		UTF32Char codePoint = [self consumeNextInputCharacter];
+		if (codePoint == endingCodePoint) {
+			break;
+		}
+
+		switch (codePoint) {
+			case EOF:
+				break;
+			case LINE_FEED:
+				[self emitParseError:@"New-line character (0x000A) in CSS attribute value"];
+				[self reconsumeCurrentInputCharacter];
+				break;
+			case REVERSE_SOLIDUS:
+			{
+				UTF32Char next = self.nextInputCharacter;
+				if (next == EOF) {
+					continue;
+				} else if (next == LINE_FEED) {
+					[self consumeNextInputCharacter];
+				} else {
+					UTF32Char escapedCodePoint = [self consumeNextInputCharacter];
+					AppendCodePoint(value, escapedCodePoint);
+				}
+			}
+			default:
+				AppendCodePoint(value, codePoint);
+				break;
+		}
+	}
+
+	return (__bridge NSString *)(CFStringGetLength(value) > 0 ? value : nil);
+}
+
+- (UTF32Char)consumeEscapedCodePoint
+{
+	UTF32Char codePoint = [self consumeNextInputCharacter];
+
+	if (isHexDigit(codePoint)) {
+		CFMutableStringRef hexString = CFStringCreateMutable(kCFAllocatorDefault, 6);
+		AppendCodePoint(hexString, codePoint);
+
+		while (isHexDigit(self.nextInputCharacter) && CFStringGetLength(hexString) <= 6) {
+			UniChar codePoint = [self consumeNextInputCharacter];
+			CFStringAppendCharacters(hexString, &codePoint, 1);
+		}
+
+		if (isWhitespace(self.nextInputCharacter)) {
+			[self consumeNextInputCharacter];
+		}
+
+		NSScanner *scanner = [NSScanner scannerWithString:(__bridge NSString *)(hexString)];
+		unsigned int number;
+		[scanner scanHexInt:&number];
+
+		return isValidEscapedCodePoint(number) ? number : REPLACEMENT_CHARACTER;
+	} else if (codePoint == EOF) {
+		return REPLACEMENT_CHARACTER;
+	}
+
+	return codePoint;
+}
+
+- (NSString *)consumeCombinator
+{
+	NSString *combinator = [self consumeCharactersInString:@" >+~"];
+	combinator = [combinator stringByTrimmingCharactersInSet:[NSCharacterSet whitespaceAndNewlineCharacterSet]];
+
+	return combinator;
+}
+
+@end

HTMLKit/CSSNthExpressionParser.h

@@ -0,0 +1,31 @@
+//
+//  CSSNthExpression.h
+//  HTMLKit
+//
+//  Created by Iska on 10/10/15.
+//  Copyright © 2015 BrainCookie. All rights reserved.
+//
+
+#import <Foundation/Foundation.h>
+#import "CSSSelectors.h"
+
+NS_ASSUME_NONNULL_BEGIN
+
+/**
+ The Nth-Expression Parser.
+
+ Parses CSS nth-expressions, e.g. '-2n+3', 'odd', ...etc.
+ */
+@interface CSSNthExpressionParser : NSObject
+
+/**
+ Parses a CSS nth-exrepssion string.
+
+ @param expression The expression string to parse.
+ @see CSSNthExpression
+ */
++ (CSSNthExpression)parseExpression:(NSString *)expression;
+
+@end
+
+NS_ASSUME_NONNULL_END

HTMLKit/CSSNthExpressionParser.m

@@ -0,0 +1,50 @@
+//
+//  CSSNthExpression.m
+//  HTMLKit
+//
+//  Created by Iska on 10/10/15.
+//  Copyright © 2015 BrainCookie. All rights reserved.
+//
+
+#import "CSSNthExpressionParser.h"
+#import "CSSCodePoints.h"
+#import "NSString+HTMLKit.h"
+#import "NSCharacterSet+HTMLKit.h"
+
+@implementation CSSNthExpressionParser
+
++ (CSSNthExpression)parseExpression:(NSString *)expression
+{
+	NSCharacterSet *whitespace = [NSCharacterSet whitespaceAndNewlineCharacterSet];
+
+	NSString *string = [expression.lowercaseString copy];
+	string = [[string stringByTrimmingCharactersInSet:whitespace] copy];
+
+	if ([string isEqualToStringIgnoringCase:@"odd"]) {
+		return CSSNthExpressionOdd;
+	} else if ([string isEqualToStringIgnoringCase:@"even"]) {
+		return CSSNthExpressionEven;
+	}
+
+	NSCharacterSet *set = [[NSCharacterSet CSSNthExpressionCharacterSet] invertedSet];
+	if ([string rangeOfCharacterFromSet:set].location != NSNotFound) {
+		return CSSNthExpressionMake(0, 0);
+	}
+	NSArray *parts = [string componentsSeparatedByString:@"n"];
+
+	if (parts.count == 1) {
+		NSInteger b = [parts[0] integerValue];
+		return CSSNthExpressionMake(0, b);
+	} else if (parts.count == 2) {
+		NSInteger a = [parts[0] integerValue];
+		if (a == 0) {
+			a = [parts[0] isEqualToString:@"-"] ? -1 : 1;
+		}
+		NSInteger b = [parts[1] integerValue];
+		return CSSNthExpressionMake(a, b);
+	} else {
+		return CSSNthExpressionMake(0, 0);
+	}
+}
+
+@end

HTMLKit/CSSNthExpressionSelector.h

@@ -0,0 +1,72 @@
+//
+//  CSSNthExpressionSelector.h
+//  HTMLKit
+//
+//  Created by Iska on 10/10/15.
+//  Copyright © 2015 BrainCookie. All rights reserved.
+//
+
+#import "CSSSelector.h"
+
+NS_ASSUME_NONNULL_BEGIN
+
+/**
+ CSS Nth-Expression Selector.
+ */
+@interface CSSNthExpressionSelector : CSSSelector
+
+/**
+ The pseudo-class name.
+ */
+@property (nonatomic, strong, readonly) NSString *className;
+
+/**
+ The nth-expression.
+
+ @see CSSNthExpression
+ */
+@property (nonatomic, assign, readonly) CSSNthExpression expression;
+
+/**
+ Initializes a new CSS nth-child selector, e.g. ':nth-child(2n+3)'
+
+ @param expression The nth-expression.
+ @return Nth-Child selector for the specified expression.
+
+ @see CSSNthExpression
+ */
++ (instancetype)nthChildSelector:(CSSNthExpression)expression;
+
+/**
+ Initializes a new CSS nth-last-child selector, e.g. ':nth-last-child(2n+3)'
+
+ @param expression The nth-expression.
+ @return Nth-Last-Child selector for the specified expression.
+
+ @see CSSNthExpression
+ */
++ (instancetype)nthLastChildSelector:(CSSNthExpression)expression;
+
+/**
+ Initializes a new CSS nth-of-type selector, e.g. ':nth-of-type(2n+3)'
+
+ @param expression The nth-expression.
+ @return Nth-Of-Type selector for the specified expression.
+
+ @see CSSNthExpression
+ */
++ (instancetype)nthOfTypeSelector:(CSSNthExpression)expression;
+
+/**
+ Initializes a new CSS nth-last-of-type selector, e.g. ':nth-last-of-type(2n+3)'
+
+ @param expression The nth-expression.
+ @return Nth-Last-Of-Type selector for the specified expression.
+
+ @see CSSNthExpression
+ */
++ (instancetype)nthLastOfTypeSelector:(CSSNthExpression)expression;
+
+@end
+
+NS_ASSUME_NONNULL_END

HTMLKit/CSSNthExpressionSelector.m

@@ -0,0 +1,131 @@
+//
+//  CSSNthExpressionSelector.m
+//  HTMLKit
+//
+//  Created by Iska on 10/10/15.
+//  Copyright © 2015 BrainCookie. All rights reserved.
+//
+
+#import "CSSNthExpressionSelector.h"
+#import "HTMLElement.h"
+#import "HTMLNode+Private.h"
+
+#pragma mark - Nth-Expression
+
+const CSSNthExpression CSSNthExpressionOdd = (CSSNthExpression) {
+	.an = 2, .b = 1
+};
+
+const CSSNthExpression CSSNthExpressionEven = (CSSNthExpression) {
+	.an = 2, .b = 0
+};
+
+NSString * _Nonnull NSStringFromNthExpression(CSSNthExpression expression)
+{
+	if (expression.an == 0 && expression.b == 0) {
+		return @"invalid";
+	}
+
+	if (expression.an == 0) {
+		return [NSString stringWithFormat:@"%ld", (long)expression.b];
+	}
+	if (expression.b == 0) {
+		return [NSString stringWithFormat:@"%ldn", (long)expression.an];
+	}
+
+	return [NSString stringWithFormat:@"%ldn%+ld", (long)expression.an, (long)expression.b];
+}
+
+#pragma mark - Implementation
+
+NSInteger computeIndex(NSEnumerator *enumerator, HTMLElement *element)
+{
+	NSInteger index = 0;
+	for (HTMLNode *node in enumerator) {
+		if (node.nodeType != HTMLNodeElement) {
+			continue;
+		}
+
+		if ([node.asElement.tagName isEqualToString:element.tagName]) {
+			index++;
+		}
+
+		if (node == element) {
+			break;
+		}
+	}
+
+	return index;
+}
+
+@interface CSSNthExpressionSelector ()
+{
+	NSString *_className;
+	CSSNthExpression _expression;
+	NSInteger (^ _computeIndex)(HTMLElement *);
+}
+@end
+
+@implementation CSSNthExpressionSelector
+@synthesize expression = _expression;
+@synthesize className = _className;
+
++ (instancetype)nthChildSelector:(CSSNthExpression)expression
+{
+	return [[self alloc] initWithClassName:@"nth-child" expression:expression block:^NSInteger(HTMLElement *element) {
+		return [element.parentElement indexOfChildElement:element] + 1;
+	}];
+}
+
++ (instancetype)nthLastChildSelector:(CSSNthExpression)expression
+{
+	return [[self alloc] initWithClassName:@"nth-last-child" expression:expression block:^NSInteger(HTMLElement *element) {
+		return element.parentElement.childElementsCount - [element.parentElement indexOfChildElement:element];
+	}];
+}
+
++ (instancetype)nthOfTypeSelector:(CSSNthExpression)expression
+{
+	return [[self alloc] initWithClassName:@"nth-of-type" expression:expression block:^NSInteger(HTMLElement *element) {
+		return computeIndex(element.parentElement.childNodes.array.objectEnumerator, element);
+	}];
+}
+
++ (instancetype)nthLastOfTypeSelector:(CSSNthExpression)expression
+{
+	return [[self alloc] initWithClassName:@"nth-last-of-type" expression:expression block:^NSInteger(HTMLElement *element) {
+		return computeIndex(element.parentElement.childNodes.array.reverseObjectEnumerator, element);
+	}];
+}
+
+- (instancetype)initWithClassName:(NSString *)className
+					   expression:(CSSNthExpression)expression
+							block:(NSInteger (^)(HTMLElement *element))block
+{
+	self = [super init];
+	if (self) {
+		_className = [className copy];
+		_expression = expression;
+		_computeIndex = [block copy];
+	}
+	return self;
+}
+
+- (BOOL)acceptElement:(HTMLElement *)element
+{
+	NSInteger index = _computeIndex(element);
+
+	if (_expression.an == 0) {
+		return index == _expression.b;
+	} else {
+		NSInteger diff = (index - _expression.b);
+		return (diff * _expression.an >= 0) && (diff % _expression.an == 0);
+	}
+}
+
+- (NSString *)debugDescription
+{
+	return [NSString stringWithFormat:@":%@(%@)", self.className, NSStringFromNthExpression(self.expression)];
+}
+
+@end

HTMLKit/CSSPseudoClassSelector.h

@@ -0,0 +1,34 @@
+//
+//  CSSPseudoClassSelector.h
+//  HTMLKit
+//
+//  Created by Iska on 06/10/15.
+//  Copyright © 2015 BrainCookie. All rights reserved.
+//
+
+#import "CSSSelector.h"
+
+NS_ASSUME_NONNULL_BEGIN
+
+/**
+ Base class for CSS Pseudo Class Selectors. This is just a simple named wrapper around another selector.
+ */
+@interface CSSPseudoClassSelector : CSSSelector
+
+/**
+ The pseudo-class name.
+ */
+@property (nonatomic, strong, readonly)  NSString *className;
+
+/**
+ Initializes and return a new pseudo-class selector.
+
+ @param className The pseudo class name.
+ @param selector The underlying selector.
+ @return A new instance of a pseudo-class selector.
+ */
+- (instancetype)initWithClassName:(NSString *)className selector:(CSSSelector *)selector;
+
+@end
+
+NS_ASSUME_NONNULL_END

HTMLKit/CSSPseudoClassSelector.m

@@ -0,0 +1,46 @@
+//
+//  CSSPseudoClassSelector.m
+//  HTMLKit
+//
+//  Created by Iska on 06/10/15.
+//  Copyright © 2015 BrainCookie. All rights reserved.
+//
+
+#import "CSSPseudoClassSelector.h"
+
+@interface CSSPseudoClassSelector ()
+{
+	NSString *_className;
+	CSSSelector *_selector;
+}
+@end
+
+@implementation CSSPseudoClassSelector
+@synthesize className = _className;
+
+- (instancetype)initWithClassName:(NSString *)className selector:(CSSSelector *)selector
+{
+	self = [super init];
+	if (self) {
+		_className = [className copy];
+		_selector = selector;
+	}
+	return self;
+}
+
+-(BOOL)acceptElement:(HTMLElement *)element
+{
+	return [_selector acceptElement:element];
+}
+
+- (NSString *)debugDescription
+{
+	return [NSString stringWithFormat:@":%@", self.className];
+}
+
+- (NSString *)description
+{
+	return [NSString stringWithFormat:@"<%@: %p '%@'>", self.class, self, self.debugDescription];
+}
+
+@end

HTMLKit/CSSPseudoFunctionSelector.h

@@ -0,0 +1,38 @@
+//
+//  CSSPseudoFunctionSelector.h
+//  HTMLKit
+//
+//  Created by Iska on 07/10/15.
+//  Copyright © 2015 BrainCookie. All rights reserved.
+//
+
+#import "CSSSelector.h"
+
+NS_ASSUME_NONNULL_BEGIN
+
+/**
+ CSS Pseudo-Function Selector
+ */
+@interface CSSPseudoFunctionSelector : CSSSelector
+
+/**
+ Initializes and returns a CSS nagation selector, e.g. ':not(div)'
+
+ @param selector The selector which should be negated.
+ @return A new instance of the negation selector.
+ */
++ (instancetype)notSelector:(CSSSelector *)selector;
+
+/**
+ Initializes and returns a CSS has-descendant selector, e.g. 'div:has(p)'
+
+ @discussion 'div:has(p)' matches all <div> elements which have a descendant <p> element.
+
+ @param selector The selector matching a descendant element.
+ @return A new instance of the has-descendant selector.
+ */
++ (instancetype)hasSelector:(CSSSelector *)selector;
+
+@end
+
+NS_ASSUME_NONNULL_END

HTMLKit/CSSPseudoFunctionSelector.m

@@ -0,0 +1,91 @@
+//
+//  CSSPseudoFunctionSelector.m
+//  HTMLKit
+//
+//  Created by Iska on 07/10/15.
+//  Copyright © 2015 BrainCookie. All rights reserved.
+//
+
+#import "CSSPseudoFunctionSelector.h"
+#import "HTMLElement.h"
+#import "HTMLNode+Private.h"
+
+#pragma mark - Declarations
+
+@interface CSSNotSelector : CSSPseudoFunctionSelector
+@end
+
+@interface CSSHasSelector : CSSPseudoFunctionSelector
+@end
+
+#pragma mark - Base Function Selector
+
+@interface CSSPseudoFunctionSelector ()
+{
+	CSSSelector *_selector;
+}
+@property (nonatomic, strong, readonly) CSSSelector *selector;
+@end
+
+@implementation CSSPseudoFunctionSelector
+@synthesize selector = _selector;
+
++ (instancetype)notSelector:(CSSSelector *)selector
+{
+	return [[CSSNotSelector alloc] initWithSelector:selector];
+}
+
++ (instancetype)hasSelector:(CSSSelector *)selector
+{
+	return [[CSSHasSelector alloc] initWithSelector:selector];
+}
+
+- (instancetype)initWithSelector:(CSSSelector *)selector
+{
+	self = [super init];
+	if (self) {
+		_selector = selector;
+	}
+	return self;
+}
+
+@end
+
+#pragma mark - Not Selector
+
+@implementation CSSNotSelector
+
+- (BOOL)acceptElement:(HTMLElement *)element
+{
+	return ![self.selector acceptElement:element];
+}
+
+- (NSString *)debugDescription
+{
+	return [NSString stringWithFormat:@":not(%@)", self.selector.debugDescription];
+}
+
+@end
+
+#pragma mark - Has Selector
+
+@implementation CSSHasSelector
+
+- (BOOL)acceptElement:(HTMLElement *)element
+{
+	HTMLNodeIterator *iterator = [element nodeIteratorWithShowOptions:HTMLNodeFilterShowAll filter:nil];
+	for (HTMLNode *descendant in iterator) {
+		if (descendant.nodeType == HTMLNodeElement && [self.selector acceptElement:descendant.asElement]) {
+			return YES;
+		}
+	}
+
+	return NO;
+}
+
+- (NSString *)debugDescription
+{
+	return [NSString stringWithFormat:@":has(%@)", self.selector.debugDescription];
+}
+
+@end

HTMLKit/CSSSelector.h

@@ -0,0 +1,90 @@
+//
+//  HTMLSelector.h
+//  HTMLKit
+//
+//  Created by Iska on 02/05/15.
+//  Copyright (c) 2015 BrainCookie. All rights reserved.
+//
+
+#import <Foundation/Foundation.h>
+
+NS_ASSUME_NONNULL_BEGIN
+
+#pragma mark - Attribute Selector Type
+
+/**
+ Attribute selector type.
+ */
+typedef NS_ENUM(NSUInteger, CSSAttributeSelectorType)
+{
+	/** Attribute exists: '[src]' */
+	CSSAttributeSelectorExists,
+
+	/** Attribute has exact value: '[title="HTMLKit"]' */
+	CSSAttributeSelectorExactMatch,
+
+	/** Attribute includes value: '[title~="foo"]' */
+	CSSAttributeSelectorIncludes,
+
+	/** Attribute's value begins with: '[title^="HTML"]' */
+	CSSAttributeSelectorBegins,
+
+	/** Attribute's value ends with: '[title$="Kit"]' */
+	CSSAttributeSelectorEnds,
+
+	/** Attribute's value ends with: '[title*="ML"]' */
+	CSSAttributeSelectorContains,
+
+	/** Attribute's value ends with: '[title|="en"]' */
+	CSSAttributeSelectorHyphen,
+
+	/** Attribute's value does not equal: '[title!="foo"]' */
+	CSSAttributeSelectorNot
+};
+
+#pragma mark - CSS Nth-Expression
+
+/**
+ CSS Nth-Expression
+ */
+typedef struct CSSNthExpression
+{
+	NSInteger an;
+	NSInteger b;
+} CSSNthExpression;
+
+NS_INLINE CSSNthExpression CSSNthExpressionMake(NSInteger an, NSInteger b) {
+	return (CSSNthExpression){ .an = an, .b = b };
+}
+
+extern const CSSNthExpression CSSNthExpressionOdd;
+extern const CSSNthExpression CSSNthExpressionEven;
+extern NSString * _Nonnull NSStringFromNthExpression(CSSNthExpression expression);
+
+#pragma mark - Base Selector Class
+
+@class HTMLElement;
+
+/**
+ Base class for all CSS Selector implementations
+ */
+@interface CSSSelector : NSObject 
+
+/**
+ Initializes and returns a new instance of CSS Selector.
+ 
+ @param string The selector string which will be parsed.
+ @return A new instance of a parsed CSS Selector, `nil` if the string is not a valid selector string.
+ */
++ (nullable instancetype)selectorWithString:(NSString *)stirng;
+
+/**
+ Implementations should override this method to provide the selector-sprecific logic for matching elements.
+
+ @abstract Use one of the concrete subclasses.
+ */
+- (BOOL)acceptElement:(HTMLElement *)element;
+
+@end
+
+NS_ASSUME_NONNULL_END

HTMLKit/CSSSelector.m

@@ -0,0 +1,44 @@
+//
+//  CSSSelector.m
+//  HTMLKit
+//
+//  Created by Iska on 15/10/15.
+//  Copyright (c) 2015 BrainCookie. All rights reserved.
+//
+
+#import <Foundation/Foundation.h>
+#import "CSSSelector.h"
+#import "CSSSelectorParser.h"
+
+@implementation CSSSelector
+
++ (instancetype)selectorWithString:(NSString *)string
+{
+	NSError *error = nil;
+	CSSSelector *instance = [CSSSelectorParser parseSelector:string error:&error];
+	if (error) {
+		return nil;
+	}
+	return instance;
+}
+
+- (BOOL)acceptElement:(HTMLElement *)element
+{
+	[self doesNotRecognizeSelector:_cmd];
+	return NO;
+}
+
+#pragma mark - Description
+
+- (NSString *)debugDescription
+{
+	[self doesNotRecognizeSelector:_cmd];
+	return @"";
+}
+
+- (NSString *)description
+{
+	return [NSString stringWithFormat:@"<%@: %p '%@'>", self.class, self, self.debugDescription];
+}
+
+@end

HTMLKit/CSSSelectorBlock.h

@@ -0,0 +1,31 @@
+//
+//  CSSSelectorBlock.h
+//  HTMLKit
+//
+//  Created by Iska on 20/10/15.
+//  Copyright © 2015 BrainCookie. All rights reserved.
+//
+
+#import "CSSSelector.h"
+
+NS_ASSUME_NONNULL_BEGIN
+
+@class HTMLElement;
+
+/**
+ A block-based CSS Selector implementation
+ */
+@interface CSSSelectorBlock : CSSSelector
+
+/**
+ Initializes and returns a new block-based selector.
+
+ @param name The name of the selector.
+ @param block The block that should match desired elements.
+ @return A new instance of the block-based selector.
+ */
+- (instancetype)initWithName:(NSString *)name block:(BOOL (^)(HTMLElement *))block;
+
+@end
+
+NS_ASSUME_NONNULL_END

HTMLKit/CSSSelectorBlock.m

@@ -0,0 +1,40 @@
+//
+//  CSSSelectorBlock.m
+//  HTMLKit
+//
+//  Created by Iska on 20/10/15.
+//  Copyright © 2015 BrainCookie. All rights reserved.
+//
+
+#import "CSSSelectorBlock.h"
+
+@interface CSSSelectorBlock ()
+{
+	NSString *_name;
+	BOOL (^ _acceptBlock)(HTMLElement *);
+}
+@end
+
+@implementation CSSSelectorBlock
+
+- (instancetype)initWithName:(NSString *)name block:(BOOL (^)(HTMLElement *))block
+{
+	self = [super init];
+	if (self) {
+		_name = [name copy];
+		_acceptBlock = [block copy];
+	}
+	return self;
+}
+
+- (BOOL)acceptElement:(HTMLElement *)element
+{
+	return _acceptBlock ? _acceptBlock(element) : NO;
+}
+
+- (NSString *)debugDescription
+{
+	return _name;
+}
+
+@end

HTMLKit/CSSSelectorParser.h

@@ -0,0 +1,36 @@
+//
+//  CSSSelectorParser.h
+//  HTMLKit
+//
+//  Created by Iska on 02/10/15.
+//  Copyright © 2015 BrainCookie. All rights reserved.
+//
+
+#import <Foundation/Foundation.h>
+
+NS_ASSUME_NONNULL_BEGIN
+
+@class CSSSelector;
+
+/**
+ The CSS Selectors Parser.
+
+ Parses CSS Level 3 Selectors:
+ http://www.w3.org/TR/css3-selectors/
+ */
+@interface CSSSelectorParser : NSObject
+
+/**
+ Parses a CSS3 selector string.
+
+ @param string The CSS3 selector string.
+ @param error If an error occurs, upon return contains an `NSError` object that describes the problem.
+ @return A parsed CSSSelector, `nil` if an error occurred.
+
+ @see CSSelector
+ */
++ (CSSSelector *)parseSelector:(NSString *)string error:(NSError **)error;
+
+@end
+
+NS_ASSUME_NONNULL_END

HTMLKit/CSSSelectorParser.m

@@ -0,0 +1,426 @@
+//
+//  CSSSelectorParser.m
+//  HTMLKit
+//
+//  Created by Iska on 02/10/15.
+//  Copyright © 2015 BrainCookie. All rights reserved.
+//
+
+#import "CSSSelectorParser.h"
+#import "CSSInputStream.h"
+#import "CSSCodePoints.h"
+#import "CSSSelectors.h"
+#import "NSString+HTMLKit.h"
+#import "NSCharacterSet+HTMLKit.h"
+#import "CSSNthExpressionParser.h"
+#import "CSSCompoundSelector.h"
+#import "HTMLKitErrorDomain.h"
+
+@interface CSSSelectorParser ()
+{
+	NSString *_string;
+	CSSInputStream *_inputStream;
+	NSUInteger _location;
+
+	NSMutableArray *_selectors;
+}
+@end
+
+@implementation CSSSelectorParser
+
++ (CSSSelector *)parseSelector:(NSString *)string error:(NSError * __autoreleasing *)error
+{
+	CSSSelectorParser *parser = [[CSSSelectorParser alloc] initWithString:string];
+	CSSSelector *selector = [parser parse:error];
+
+	return selector;
+}
+
+#pragma mark - Init
+
+- (instancetype)initWithString:(NSString *)string
+{
+	self = [super init];
+	if (self) {
+		_string = [self preprocessInput:string];
+		_location = 0;
+	}
+	return self;
+}
+
+- (NSString *)preprocessInput:(NSString *)string
+{
+	string = [string stringByTrimmingCharactersInSet:[NSCharacterSet whitespaceAndNewlineCharacterSet]];
+	string = [string stringByReplacingOccurrencesOfString:@"\r\n" withString:@"\n"];
+	string = [string stringByReplacingOccurrencesOfString:@"\r" withString:@"\n"];
+	string = [string stringByReplacingOccurrencesOfString:@"\f" withString:@"\n"];
+	string = [string stringByReplacingOccurrencesOfString:@"\0" withString:@"\uFFFD"];
+
+	return string;
+}
+
+#pragma mark - Errors
+
+- (void)emitError:(NSError * __autoreleasing *)error reason:(NSString *)reason
+{
+	[self emitError:error reason:reason location:_location + _inputStream.currentLocation];
+}
+
+- (void)emitError:(NSError * __autoreleasing *)error reason:(NSString *)reason location:(NSUInteger)location
+{
+	NSDictionary *userInfo = @{
+							   NSLocalizedDescriptionKey: @"Error parsing selector",
+							   NSLocalizedFailureReasonErrorKey: reason,
+							   CSSSelectorStringKey: _string,
+							   CSSSelectorErrorLocationKey: @(location)
+							   };
+
+	if(error && *error == nil) {
+		*error = [NSError errorWithDomain:HTMLKitSelectorErrorDomain code:HTMLKitSelectorParseError userInfo:userInfo];
+	}
+}
+
+#pragma mark - Parsing
+
+- (CSSSelector *)parse:(NSError * __autoreleasing *)error
+{
+	if (_string.length == 0) {
+		[self emitError:error reason:@"Empty selector" location:0];
+		return nil;
+	}
+
+	NSArray *allSubSelectors = [_string componentsSeparatedByString:@","];
+	NSMutableArray *parsed = [NSMutableArray array];
+
+	for (NSString *subSelector in allSubSelectors) {
+		if ([subSelector isEqualToString:@""]) {
+			[self emitError:error reason:@"Empty selector" location:_location];
+			break;
+		}
+
+		CSSSelector *selector = [self parseSelector:subSelector error:error];
+		if (selector == nil) {
+			break;
+		}
+		[parsed addObject:selector];
+
+		_location += subSelector.length;
+	}
+
+	if (error && *error != nil) {
+		return nil;
+	}
+
+	if (parsed.count > 1) {
+		return anyOf(parsed);
+	}
+
+	return parsed.firstObject;
+}
+
+- (CSSSelector *)parseSelector:(NSString *)selectorString error:(NSError * __autoreleasing *)error
+{
+	_inputStream = [[CSSInputStream alloc] initWithString:selectorString];
+	[_inputStream consumeWhitespace];
+
+	CSSSelector *result = nil;
+
+	while (YES) {
+		CSSSelector *selector = [self parseSequenceOfSimpleSelectors:error];
+		if (selector == nil) {
+			break;
+		}
+
+		result = result ? allOf(@[result, selector]) : selector;
+
+		UTF32Char next = _inputStream.nextInputCharacter;
+
+		if (isCombinator(next)) {
+			NSString *combinator = [_inputStream consumeCombinator];
+
+			if ([combinator isEqualToString:@""]) {
+				result = descendantOfElementSelector(result);
+			} else if ([combinator isEqualToString:@">"]) {
+				result = childOfElementSelector(result);
+			} else if ([combinator isEqualToString:@"+"]) {
+				result = adjacentSiblingSelector(result);
+			} else if ([combinator isEqualToString:@"~"]) {
+				result = generalSiblingSelector(result);
+			}
+		}
+	}
+
+	return result;
+}
+
+- (CSSSelector *)parseSequenceOfSimpleSelectors:(NSError * __autoreleasing *)error
+{
+	NSMutableArray *selectors = [NSMutableArray array];
+
+	CSSSelector *typeSelector = [self parseTypeSelector:error];
+	if (typeSelector != nil) {
+		[selectors addObject:typeSelector];
+	}
+
+	while (YES) {
+		UTF32Char next = _inputStream.nextInputCharacter;
+		if (next == EOF || isCombinator(next)) {
+			break;
+		}
+
+		CSSSelector *simpleSelector = [self parseSimpleSelector:error];
+		if (simpleSelector == nil) {
+			return nil;
+		}
+		[selectors addObject:simpleSelector];
+	}
+
+	if (selectors.count > 1) {
+		return allOf(selectors);
+	}
+
+	return selectors.firstObject;
+}
+
+- (CSSSelector *)parseTypeSelector:(NSError * __autoreleasing *)error
+{
+	NSString *identifier = [_inputStream consumeIdentifier];
+	if (identifier != nil) {
+		return typeSelector(identifier);
+	}
+
+	if ([_inputStream consumeCharacter:ASTERIX]) {
+		return universalSelector();
+	}
+
+	return nil;
+}
+
+- (CSSSelector *)parseSimpleSelector:(NSError * __autoreleasing *)error
+{
+	CSSSelector *typeSelector = [self parseTypeSelector:error];
+	if (typeSelector != nil) {
+		return typeSelector;
+	}
+
+	UTF32Char codePoint = [_inputStream consumeNextInputCharacter];
+	switch (codePoint) {
+		case NUMBER_SIGN:
+		{
+			NSString *elementId = [_inputStream consumeIdentifier];
+			if (elementId == nil) {
+				[self emitError:error reason:@"Invalid character"];
+				return nil;
+			}
+			return  idSelector(elementId);
+		}
+		case FULL_STOP:
+		{
+			NSString *className = [_inputStream consumeIdentifier];
+			if (className == nil) {
+				[self emitError:error reason:@"Invalid character"];
+				return nil;
+			}
+			return classSelector(className);
+		}
+		case LEFT_SQUARE_BRACKET:
+		{
+			return [self parseAttributeSelector:error];
+		}
+		case COLON:
+		{
+			return [self parsePseudoSelector:error];
+		}
+		default:
+		{
+			[self emitError:error reason:@"Invalid character"];
+			return nil;
+		}
+	}
+}
+
+- (CSSSelector *)parseAttributeSelector:(NSError * __autoreleasing *)error
+{
+	NSString *attribute = [_inputStream consumeIdentifier];
+	if (attribute == nil) {
+		[self emitError:error reason:@"Invalid character" location:_location + _inputStream.currentLocation + 1];
+		return nil;
+	}
+	[_inputStream consumeWhitespace];
+
+	CSSAttributeSelectorType type = CSSAttributeSelectorExists;
+
+	NSString *operator = [_inputStream consumeCharactersInString:@"=~|^$*!"];
+
+	if ([operator isEqualToString:@"="]) {
+		type = CSSAttributeSelectorExactMatch;
+	} else if ([operator isEqualToString:@"~="]) {
+		type = CSSAttributeSelectorIncludes;
+	} else if ([operator isEqualToString:@"|="]) {
+		type = CSSAttributeSelectorHyphen;
+	} else if ([operator isEqualToString:@"^="]) {
+		type = CSSAttributeSelectorBegins;
+	} else if ([operator isEqualToString:@"$="]) {
+		type = CSSAttributeSelectorEnds;
+	} else if ([operator isEqualToString:@"*="]) {
+		type = CSSAttributeSelectorContains;
+	} else if ([operator isEqualToString:@"!="]) {
+		type = CSSAttributeSelectorNot;
+	}
+
+	NSString *value = nil;
+	[_inputStream consumeWhitespace];
+
+	UTF32Char next = _inputStream.nextInputCharacter;
+	if (isQuote(next)) {
+		UTF32Char quote = [_inputStream consumeNextInputCharacter];
+		value =  [_inputStream consumeStringWithEndingCodePoint:quote];
+	} else {
+		value = [_inputStream consumeIdentifier];
+	}
+
+	[_inputStream consumeWhitespace];
+
+	// Consume RIGHT_SQUARE_BRACKET
+	if (![_inputStream consumeCharacter:RIGHT_SQUARE_BRACKET]) {
+		[self emitError:error reason:@"Expected closing right square bracket ']'"];
+	}
+
+	if (type == CSSAttributeSelectorExists) {
+		return hasAttributeSelector(attribute);
+	}
+
+	return attributeSelector(type, attribute, value);
+}
+
+- (CSSSelector *)parsePseudoSelector:(NSError * __autoreleasing *)error
+{
+	NSString *pseudoClass = [_inputStream consumeIdentifier];
+
+	if ([pseudoClass hasPrefix:@"nth"]) {
+		[_inputStream consumeWhitespace];
+		if (![_inputStream consumeCharacter:LEFT_PARENTHESIS]) {
+			[self emitError:error reason:@"Expected opening left parenthesis '('"];
+		}
+
+		NSString *functionExpression = [_inputStream consumeCharactersUpToString:@")"];
+		CSSNthExpression expression = [CSSNthExpressionParser parseExpression:functionExpression];
+
+		[_inputStream consumeWhitespace];
+		if (![_inputStream consumeCharacter:RIGHT_PARENTHESIS]) {
+			[self emitError:error reason:@"Expected closing right parenthesis ')'"];
+		}
+
+		if ([pseudoClass isEqualToString:@"nth-child"]) {
+			return nthChildSelector(expression);
+		} else if ([pseudoClass isEqualToString:@"nth-last-child"]) {
+			return nthLastChildSelector(expression);
+		} else if ([pseudoClass isEqualToString:@"nth-of-type"]) {
+			return nthOfTypeSelector(expression);
+		} else if ([pseudoClass isEqualToString:@"nth-last-of-type"]) {
+			return nthLastOfTypeSelector(expression);
+		}
+	} else if ([pseudoClass isEqualToString:@"not"]) {
+		[_inputStream consumeWhitespace];
+		if (![_inputStream consumeCharacter:LEFT_PARENTHESIS]) {
+			[self emitError:error reason:@"Expected opening left parenthesis '('"];
+		}
+
+		CSSSelector *subSelector = [self parseSimpleSelector:error];
+		[_inputStream consumeWhitespace];
+		if (![_inputStream consumeCharacter:RIGHT_PARENTHESIS]) {
+			[self emitError:error reason:@"Expected closing right parenthesis ')'"];
+		}
+
+		return not(subSelector);
+	} else if ([pseudoClass isEqualToAny:@"lt", @"gt", @"eq", nil]) {
+		[_inputStream consumeWhitespace];
+		if (![_inputStream consumeCharacter:LEFT_PARENTHESIS]) {
+			[self emitError:error reason:@"Expected opening left parenthesis '('"];
+		}
+
+		NSDecimal decimal;
+		if (![_inputStream consumeDecimalNumber:&decimal]) {
+			[self emitError:error reason:@"Expected a decimal number"];
+		}
+
+		[_inputStream consumeWhitespace];
+		if (![_inputStream consumeCharacter:RIGHT_PARENTHESIS]) {
+			[self emitError:error reason:@"Expected closing right parenthesis ')'"];
+		}
+
+		NSDecimalNumber *number = [[NSDecimalNumber alloc] initWithDecimal:decimal];
+		if ([pseudoClass isEqualToString:@"lt"]) {
+			return ltSelector(number.integerValue);
+		} else if ([pseudoClass isEqualToString:@"gt"]) {
+			return gtSelector(number.integerValue);
+		} else if ([pseudoClass isEqualToString:@"eq"]) {
+			return eqSelector(number.integerValue);
+		}
+	} else {
+		if ([pseudoClass isEqualToString:@"even"]) {
+			return evenSlector();
+		} else if ([pseudoClass isEqualToString:@"odd"]) {
+			return oddSelector();
+		} else if ([pseudoClass isEqualToString:@"first-child"]) {
+			return firstChildSelector();
+		} else if ([pseudoClass isEqualToString:@"last-child"]) {
+			return lastChildSelector();
+		} else if ([pseudoClass isEqualToString:@"first-of-type"]) {
+			return firstOfTypeSelector();
+		} else if ([pseudoClass isEqualToString:@"last-of-type"]) {
+			return lastOfTypeSelector();
+		} else if ([pseudoClass isEqualToString:@"only-child"]) {
+			return onlyChildSelector();
+		} else if ([pseudoClass isEqualToString:@"only-of-type"]) {
+			return onlyOfTypeSelector();
+		} else if ([pseudoClass isEqualToString:@"root"]) {
+			return rootSelector();
+		} else if ([pseudoClass isEqualToString:@"empty"]) {
+			return emptySelector();
+		} else if ([pseudoClass isEqualToString:@"link"]) {
+			return linkSelector();
+		} else if ([pseudoClass isEqualToString:@"enabled"]) {
+			return enabledSelector();
+		} else if ([pseudoClass isEqualToString:@"disabled"]) {
+			return disabledSelector();
+		} else if ([pseudoClass isEqualToString:@"checked"]) {
+			return checkedSelector();
+		}
+
+		else if ([pseudoClass isEqualToString:@"button"]) {
+			return buttonSelector();
+		} else if ([pseudoClass isEqualToString:@"checkbox"]) {
+			return checkboxSelector();
+		} else if ([pseudoClass isEqualToString:@"file"]) {
+			return fileSelector();
+		} else if ([pseudoClass isEqualToString:@"header"]) {
+			return headerSelector();
+		} else if ([pseudoClass isEqualToString:@"image"]) {
+			return imageSelector();
+		} else if ([pseudoClass isEqualToString:@"optional"]) {
+			return optionalSelector();
+		} else if ([pseudoClass isEqualToString:@"parent"]) {
+			return parentSelector();
+		} else if ([pseudoClass isEqualToString:@"password"]) {
+			return passwordSelector();
+		} else if ([pseudoClass isEqualToString:@"radio"]) {
+			return radioSelector();
+		} else if ([pseudoClass isEqualToString:@"reset"]) {
+			return resetSelector();
+		} else if ([pseudoClass isEqualToString:@"submit"]) {
+			return submitSelector();
+		} else if ([pseudoClass isEqualToString:@"text"]) {
+			return textSelector();
+		} else if ([pseudoClass isEqualToString:@"required"]) {
+			return requiredSelector();
+		} else if ([pseudoClass isEqualToString:@"reset"]) {
+			return resetSelector();
+		}
+	}
+	NSString *reason = [NSString stringWithFormat:@"Unknown pseudo class: %@", pseudoClass];
+	[self emitError:error reason:reason];
+	return nil;
+}
+
+@end

HTMLKit/CSSSelectors.h

@@ -0,0 +1,277 @@
+//
+//  CSSSelectors.h
+//  HTMLKit
+//
+//  Created by Iska on 14/05/15.
+//  Copyright (c) 2015 BrainCookie. All rights reserved.
+//
+
+#import "CSSSelector.h"
+#import "CSSTypeSelector.h"
+#import "CSSAttributeSelector.h"
+#import "CSSPseudoClassSelector.h"
+#import "CSSPseudoFunctionSelector.h"
+#import "CSSNthExpressionSelector.h"
+#import "CSSCombinatorSelector.h"
+#import "CSSCompoundSelector.h"
+#import "CSSSelectorBlock.h"
+#import "CSSStructuralPseudoSelectors.h"
+
+NS_ASSUME_NONNULL_BEGIN
+
+#pragma mark - Type Selectors
+
+/**
+ Universal CSS selector: '*'
+
+ @return The universal CSS selector.
+ */
+extern CSSSelector * universalSelector();
+
+/**
+ CSS type selector, e.g. 'div', 'p', ...etc.
+ 
+ @param type The element type.
+ @return Type selector for the specified type.
+ */
+extern CSSSelector * typeSelector(NSString *type);
+
+#pragma mark - Atribute Selectors
+
+/**
+ CSS id selector, e.g. '#someId'
+
+ @param elementId The element id.
+ @return Id selector for the specified element id.
+ */
+extern CSSSelector * idSelector(NSString *elementId);
+
+/**
+ CSS class selector, e.g. '.someClass'
+
+ @param className The class name.
+ @return Class selector for the specified class name.
+ */
+extern CSSSelector * classSelector(NSString *className);
+
+/**
+ CSS has-attribute selector, e.g. '[href]'
+
+ @param attribute The attribute.
+ @return Has-Attribute selector for the specified attribute.
+ */
+extern CSSSelector * hasAttributeSelector(NSString *attribute);
+
+/**
+ CSS attribute selector, e.g. '[src*="html"]', '[class^="top"]', '[title&="HTML"]', ...etc.
+
+ @param type The attribute selector type.
+ @param attribute The attribute.
+ @param value The value of the attribute.
+ @return Attribute selector.
+ 
+ @see CSSAttributeSelectorType
+ */
+extern CSSSelector * attributeSelector(CSSAttributeSelectorType type,
+												 NSString *attribute,
+												 NSString *value);
+
+#pragma mark - Nth-Expression Selectors
+
+/**
+ CSS nth-child selector, e.g. ':nth-child(2n+3)'
+
+ @param expression The nth-expression.
+ @return Nth-Child selector for the specified expression.
+
+ @see CSSNthExpression
+ */
+extern CSSSelector * nthChildSelector(CSSNthExpression expression);
+
+/**
+ CSS nth-last-child selector, e.g. ':nth-last-child(2n+3)'
+
+ @param expression The nth-expression.
+ @return Nth-Last-Child selector for the specified expression.
+
+ @see CSSNthExpression
+ */
+extern CSSSelector * nthLastChildSelector(CSSNthExpression expression);
+
+/**
+ CSS nth-of-type selector, e.g. ':nth-of-type(2n+3)'
+
+ @param expression The nth-expression.
+ @return Nth-Of-Type selector for the specified expression.
+
+ @see CSSNthExpression
+ */
+extern CSSSelector * nthOfTypeSelector(CSSNthExpression expression);
+
+/**
+ CSS nth-last-of-type selector, e.g. ':nth-last-of-type(2n+3)'
+
+ @param expression The nth-expression.
+ @return Nth-Last-Of-Type selector for the specified expression.
+
+ @see CSSNthExpression
+ */
+extern CSSSelector * nthLastOfTypeSelector(CSSNthExpression expression);
+
+/**
+ CSS odd-child selector: ':nth-child(odd)'
+ 
+ This is analogous to ':nth-child(2n+1)'
+
+ @return Odd-Child selector.
+ */
+extern CSSSelector * oddSelector();
+
+/**
+ CSS even-child selector: ':nth-child(even)'
+
+ This is analogous to ':nth-child(2n)'
+
+ @return Even-Child selector.
+ */
+extern CSSSelector * evenSlector();
+
+/**
+ CSS first-child selector: ':nth-child(1)'
+
+ @return First-Child selector.
+ */
+extern CSSSelector * firstChildSelector();
+
+/**
+ CSS first-child selector: ':nth-last-child(1)'
+
+ @return First-Child selector.
+ */
+extern CSSSelector * lastChildSelector();
+
+/**
+ CSS first-of-type selector: ':nth-first-of-type(1)'
+
+ @return First-Of-Type selector.
+ */
+extern CSSSelector * firstOfTypeSelector();
+
+/**
+ CSS last-of-type selector: ':nth-last-of-type(1)'
+
+ @return Last-Of-Type selector.
+ */
+extern CSSSelector * lastOfTypeSelector();
+
+/**
+ CSS only-child selector: ':first-child:last-child'
+
+ @return Only-Child selector.
+ */
+extern CSSSelector * onlyChildSelector();
+
+/**
+ CSS only-of-type selector: ':first-of-type:last-of-type'
+
+ @return Only-Of-Type selector.
+ */
+extern CSSSelector * onlyOfTypeSelector();
+
+#pragma mark - Combinators
+
+/**
+ CSS child-of-element selector, e.g. 'div > p'
+
+ @param selector The selector matching the parent element.
+ @return A child of element selector.
+ */
+extern CSSSelector * childOfElementSelector(CSSSelector *selector);
+
+/**
+ CSS descendant-of-element selector, e.g. 'div p'
+
+ @param selector The selector matching the ancestor element.
+ @return A descendant of element selector.
+ */
+extern CSSSelector * descendantOfElementSelector(CSSSelector *selector);
+
+/**
+ CSS adjacent sibling selector, e.g. 'p + a'
+
+ @param selector The selector matching the adjacent sibling element.
+ @return A adjacent sibling selector.
+ */
+extern CSSSelector * adjacentSiblingSelector(CSSSelector *selector);
+
+/**
+ CSS general sibling selector, e.g. 'p ~ a'
+
+ @param selector The selector matching the general sibling element.
+ @return A general sibling selector.
+ */
+extern CSSSelector * generalSiblingSelector(CSSSelector *selector);
+
+#pragma mark - Pseudo Functions
+
+/**
+ CSS nagation selector: ':not(div)'
+ 
+ @param selector The selector which should be negated.
+ @return A negation selector.
+ */
+extern CSSSelector * not(CSSSelector *selector);
+
+/**
+ CSS has-descendant selector, e.g. 'div:has(p)'
+
+ @discussion 'div:has(p)' matches all <div> elements which have a descendant <p> element.
+
+ @param selector The selector matching a descendant element.
+ @return A has-descendant selector.
+ */
+extern CSSSelector * has(CSSSelector *selector);
+
+#pragma mark - Compound Selectors
+
+/**
+ A compound selector matching only elements that match all of the specified selectors.
+
+ @param selectors The selectors list.
+ @return All-Of selector.
+ */
+extern CSSSelector * allOf(NSArray<CSSSelector *> *selectors);
+
+/**
+ A compound selector matching all elements that match at least one of the specified selectors.
+
+ @param selectors The selectors list.
+ @return Any-Of selector.
+ */
+extern CSSSelector * anyOf(NSArray<CSSSelector *> *selectors);
+
+#pragma mark - Pseudo
+
+/**
+ Creates a new named-pseudo selector.
+
+ @discussion The name specified when creating a selector is prefixed with colon.
+
+ @param name The name of the selector.
+ @param selector The underlying selector.
+ @return A named-pseudo selector.
+ */
+extern CSSSelector * namedPseudoSelector(NSString *name, CSSSelector *selector);
+
+#pragma mark - Block
+
+/**
+ Creates a new named selector with a specified block.
+
+ @param name The name of the selector.
+ @param acceptBlock The block which provides the implementation for the accept-element logic.
+ @return A named-block selector.
+ */
+extern CSSSelector * namedBlockSelector(NSString *name, BOOL (^ acceptBlock)(HTMLElement *element));
+
+NS_ASSUME_NONNULL_END

HTMLKit/CSSSelectors.m

@@ -0,0 +1,177 @@
+//
+//  CSSSelectors.m
+//  HTMLKit
+//
+//  Created by Iska on 19/10/15.
+//  Copyright © 2015 BrainCookie. All rights reserved.
+//
+
+#import "CSSSelectors.h"
+#import "CSSTypeSelector.h"
+#import "CSSAttributeSelector.h"
+#import "CSSPseudoClassSelector.h"
+#import "CSSPseudoFunctionSelector.h"
+#import "CSSNthExpressionSelector.h"
+#import "CSSCombinatorSelector.h"
+#import "CSSCompoundSelector.h"
+#import "CSSSelectorBlock.h"
+
+#pragma mark - Type Selectors
+
+CSSSelector * universalSelector()
+{
+	return [CSSTypeSelector universalSelector];
+}
+
+CSSSelector * typeSelector(NSString *type)
+{
+	return [[CSSTypeSelector alloc] initWithType:type];
+}
+
+#pragma mark - Atribute Selectors
+
+CSSSelector * idSelector(NSString *elementId)
+{
+	return [CSSAttributeSelector idSelector:elementId];
+}
+
+CSSSelector * classSelector(NSString *className)
+{
+	return [CSSAttributeSelector classSelector:className];
+}
+
+CSSSelector * hasAttributeSelector(NSString *attribute)
+{
+	return [CSSAttributeSelector hasAttributeSelector:attribute];
+}
+
+CSSSelector * attributeSelector(CSSAttributeSelectorType type,
+												NSString *attribute,
+												NSString *value)
+{
+	return [[CSSAttributeSelector alloc] initWithType:type attributeName:attribute attrbiuteValue:value];
+}
+
+#pragma mark - Nth-Expression Selectors
+
+CSSSelector * nthChildSelector(CSSNthExpression expression)
+{
+	return [CSSNthExpressionSelector nthChildSelector:expression];
+}
+
+CSSSelector * nthLastChildSelector(CSSNthExpression expression)
+{
+	return [CSSNthExpressionSelector nthLastChildSelector:expression];
+}
+
+CSSSelector * nthOfTypeSelector(CSSNthExpression expression)
+{
+	return [CSSNthExpressionSelector nthOfTypeSelector:expression];
+}
+
+CSSSelector * nthLastOfTypeSelector(CSSNthExpression expression)
+{
+	return [CSSNthExpressionSelector nthLastOfTypeSelector:expression];
+}
+
+#pragma mark - Nth-Expression Shorthand
+
+CSSSelector * oddSelector()
+{
+	return namedPseudoSelector(@"odd", nthChildSelector(CSSNthExpressionOdd));
+}
+
+CSSSelector * evenSlector()
+{
+	return namedPseudoSelector(@"even", nthChildSelector(CSSNthExpressionEven));
+}
+
+CSSSelector * firstChildSelector()
+{
+	return namedPseudoSelector(@"first-child", nthChildSelector(CSSNthExpressionMake(0, 1)));
+}
+
+CSSSelector * lastChildSelector()
+{
+	return namedPseudoSelector(@"last-child", nthLastChildSelector(CSSNthExpressionMake(0, 1)));
+}
+
+CSSSelector * firstOfTypeSelector()
+{
+	return namedPseudoSelector(@"first-of-type", nthOfTypeSelector(CSSNthExpressionMake(0, 1)));
+}
+
+CSSSelector * lastOfTypeSelector()
+{
+	return namedPseudoSelector(@"last-of-type", nthLastOfTypeSelector(CSSNthExpressionMake(0, 1)));
+}
+
+CSSSelector * onlyChildSelector()
+{
+	return namedPseudoSelector(@"only-child", allOf(@[firstChildSelector(), lastChildSelector()]));
+}
+
+CSSSelector * onlyOfTypeSelector()
+{
+	return namedPseudoSelector(@"only-of-type", allOf(@[firstOfTypeSelector(), lastOfTypeSelector()]));
+}
+
+#pragma mark - Combinators
+
+CSSSelector * childOfElementSelector(CSSSelector *selector)
+{
+	return [CSSCombinatorSelector childOfElementCombinator:selector];
+}
+
+CSSSelector * descendantOfElementSelector(CSSSelector *selector)
+{
+	return [CSSCombinatorSelector descendantOfElementCombinator:selector];
+}
+
+CSSSelector * adjacentSiblingSelector(CSSSelector *selector)
+{
+	return [CSSCombinatorSelector adjacentSiblingCombinator:selector];
+}
+
+CSSSelector * generalSiblingSelector(CSSSelector *selector)
+{
+	return [CSSCombinatorSelector generalSiblingCombinator:selector];
+}
+
+#pragma mark - Pseudo Functions
+
+CSSSelector * not(CSSSelector *selector)
+{
+	return [CSSPseudoFunctionSelector notSelector:selector];
+}
+
+CSSSelector * has(CSSSelector *selector)
+{
+	return [CSSPseudoFunctionSelector hasSelector:selector];
+}
+
+#pragma mark - Compound Selectors
+
+CSSSelector * allOf( NSArray<CSSSelector *> * selectors)
+{
+	return [CSSCompoundSelector andSelector:selectors];
+}
+
+CSSSelector * anyOf( NSArray<CSSSelector *> * selectors)
+{
+	return [CSSCompoundSelector orSelector:selectors];
+}
+
+#pragma mark - Pseudo
+
+CSSSelector * namedPseudoSelector(NSString *name, CSSSelector *selector)
+{
+	return [[CSSPseudoClassSelector alloc] initWithClassName:name selector:selector];
+}
+
+#pragma mark - Block
+
+CSSSelector * namedBlockSelector(NSString *name, BOOL (^ acceptBlock)(HTMLElement *element))
+{
+	return [[CSSSelectorBlock alloc] initWithName:name block:acceptBlock];
+}

HTMLKit/CSSStructuralPseudoSelectors.h

@@ -0,0 +1,145 @@
+//
+//  CSSStructuralPseudoSelector.h
+//  HTMLKit
+//
+//  Created by Iska on 11/10/15.
+//  Copyright © 2015 BrainCookie. All rights reserved.
+//
+
+@class CSSSelector;
+
+NS_ASSUME_NONNULL_BEGIN
+
+/**
+ @return Root element selector: ':root'
+ */
+extern CSSSelector * rootSelector();
+
+/**
+ @return Empy element selector: ':empty'
+ */
+extern CSSSelector * emptySelector();
+
+/**
+ @return A parent element selector: ':parent'
+ */
+extern CSSSelector * parentSelector();
+
+/**
+ @return A button element selector: ':button'
+ */
+extern CSSSelector * buttonSelector();
+
+/**
+ @return A checkbox element selector: ':checkbox'
+ */
+extern CSSSelector * checkboxSelector();
+
+/**
+ @return A file element selector: ':file'
+ */
+extern CSSSelector * fileSelector();
+
+/**
+ @return A header element selector: ':header'
+ */
+extern CSSSelector * headerSelector();
+
+/**
+ @return An image element selector: ':image'
+ */
+extern CSSSelector * imageSelector();
+
+/**
+ @return A parent element selector: ':parent'
+ */
+extern CSSSelector * inputSelector();
+
+/**
+ @return A link element selector: ':link'
+ */
+extern CSSSelector * linkSelector();
+
+/**
+ @return A password element selector: ':password'
+ */
+extern CSSSelector * passwordSelector();
+
+/**
+ @return A radio element selector: ':radio'
+ */
+extern CSSSelector * radioSelector();
+
+/**
+ @return A reset element selector: ':reset'
+ */
+extern CSSSelector * resetSelector();
+
+/**
+ @return A submit element selector: ':submit'
+ */
+extern CSSSelector * submitSelector();
+
+/**
+ @return A text element selector: ':text'
+ */
+extern CSSSelector * textSelector();
+
+/**
+ @return An enabled element selector: ':enabled'
+ */
+extern CSSSelector * enabledSelector();
+
+/**
+ @return A disabled element selector: ':disabled'
+ */
+extern CSSSelector * disabledSelector();
+
+/**
+ @return A checked element selector: ':checked'
+ */
+extern CSSSelector * checkedSelector();
+
+/**
+ @return An optional element selector: ':optional'
+ */
+extern CSSSelector * optionalSelector();
+
+/**
+ @return A required element selector: ':required'
+ */
+extern CSSSelector * requiredSelector();
+
+/**
+ Less-than selector, e.g. 'lt(2)'
+
+ Selects all elements at an index less than the specified index. A negative index counts backwards from the last element.
+
+ @param index The zero-based index of the element to match.
+ @return A Less-Than selector.
+ */
+extern CSSSelector * ltSelector(NSInteger index);
+
+/**
+ Greater-than selector, e.g. 'gt(2)'
+
+ Selects all elements at an index greater than the specified index. A negative index counts backwards from the 
+ last element.
+
+ @param index The zero-based index of the element to match.
+ @return A Greater-Than selector.
+ */
+extern CSSSelector * gtSelector(NSInteger index);
+
+/**
+ Equal selector, e.g. 'eq(3)'
+
+ Selects the element at the specified index. A negative index counts backwards from the last element.
+
+ @param index The zero-based index of the element to match.
+ @return An Equal selector.
+ */
+extern CSSSelector * eqSelector(NSInteger index);
+
+
+NS_ASSUME_NONNULL_END

HTMLKit/CSSStructuralPseudoSelectors.m

@@ -0,0 +1,313 @@
+//
+//  CSSStructuralPseudoSelector.m
+//  HTMLKit
+//
+//  Created by Iska on 11/10/15.
+//  Copyright © 2015 BrainCookie. All rights reserved.
+//
+
+#import "CSSStructuralPseudoSelectors.h"
+#import "CSSSelectors.h"
+#import "HTMLElement.h"
+#import "NSString+HTMLKit.h"
+
+#pragma mark - Elements
+
+CSSSelector * rootSelector()
+{
+	return namedBlockSelector(@":root", ^BOOL(HTMLElement * element) {
+		return element.parentElement == nil;
+	});
+}
+
+CSSSelector * emptySelector()
+{
+	return namedBlockSelector(@":empty", ^BOOL(HTMLElement * element) {
+		for (HTMLNode *child in element.childNodes) {
+			if (child.nodeType == HTMLNodeElement) {
+				return NO;
+			} else if (child.nodeType == HTMLNodeText && child.textContent.length > 0) {
+				return NO;
+			}
+		}
+		return YES;
+	});
+}
+
+CSSSelector * parentSelector()
+{
+	return namedBlockSelector(@":parent", ^BOOL(HTMLElement * element) {
+		return element.childNodesCount > 0;
+	});
+}
+
+CSSSelector * buttonSelector()
+{
+	return namedBlockSelector(@":button", ^BOOL(HTMLElement * _Nonnull element) {
+		if ([element.tagName isEqualToString:@"button"]) {
+			return YES;
+		}
+		if ([element.tagName isEqualToString:@"input"] && [element[@"type"] isEqualToString:@"button"]) {
+			return YES;
+		}
+		return NO;
+	});
+}
+
+CSSSelector * checkboxSelector()
+{
+	return namedBlockSelector(@":checkbox", ^BOOL(HTMLElement * _Nonnull element) {
+		if ([element[@"type"] isEqualToString:@"checkbox"]) {
+			return YES;
+		}
+		return NO;
+	});
+}
+
+CSSSelector * fileSelector()
+{
+	return namedBlockSelector(@":file", ^BOOL(HTMLElement * _Nonnull element) {
+		if ([element[@"type"] isEqualToString:@"file"]) {
+			return YES;
+		}
+		return NO;
+	});
+}
+
+CSSSelector * headerSelector()
+{
+	return namedBlockSelector(@":header", ^BOOL(HTMLElement * _Nonnull element) {
+		if ([element.tagName isEqualToAny:@"h1", @"h2", @"h3", @"h4", @"h5", @"h6", nil]) {
+			return YES;
+		}
+		return NO;
+	});
+}
+
+CSSSelector * imageSelector()
+{
+	return namedBlockSelector(@":image", ^BOOL(HTMLElement * _Nonnull element) {
+		if ([element[@"type"] isEqualToString:@"image"]) {
+			return YES;
+		}
+		return NO;
+	});
+}
+
+CSSSelector * inputSelector()
+{
+	return namedBlockSelector(@":input", ^BOOL(HTMLElement * _Nonnull element) {
+		if ([element.tagName isEqualToAny:@"button", @"input", @"select", @"textarea", nil]) {
+			return YES;
+		}
+		return NO;
+	});
+}
+
+CSSSelector * linkSelector()
+{
+	// https://html.spec.whatwg.org/multipage/scripting.html#selector-link
+	return namedBlockSelector(@":link", ^BOOL(HTMLElement * element) {
+		if ([element hasAttribute:@"href"]) {
+			return [element.tagName isEqualToAny:@"a", @"area", @"link", nil];
+		}
+		return NO;
+	});
+}
+
+CSSSelector * passwordSelector()
+{
+	return namedBlockSelector(@":password", ^BOOL(HTMLElement * _Nonnull element) {
+		if ([element[@"type"] isEqualToString:@"password"]) {
+			return YES;
+		}
+		return NO;
+	});
+}
+
+CSSSelector * radioSelector()
+{
+	return namedBlockSelector(@":radio", ^BOOL(HTMLElement * _Nonnull element) {
+		if ([element[@"type"] isEqualToString:@"radio"]) {
+			return YES;
+		}
+		return NO;
+	});
+}
+
+CSSSelector * resetSelector()
+{
+	return namedBlockSelector(@":reset", ^BOOL(HTMLElement * _Nonnull element) {
+		if ([element[@"type"] isEqualToString:@"reset"]) {
+			return YES;
+		}
+		return NO;
+	});
+}
+
+CSSSelector * submitSelector()
+{
+	return namedBlockSelector(@":submit", ^BOOL(HTMLElement * _Nonnull element) {
+		if ([element.tagName isEqualToString:@"input"] && [element[@"type"] isEqualToString:@"submit"]) {
+			return YES;
+		}
+		if ([element.tagName isEqualToString:@"button"] && [element[@"type"] isEqualToString:@"submit"]) {
+			return YES;
+		}
+		return NO;
+	});
+}
+
+CSSSelector * textSelector()
+{
+	return namedBlockSelector(@":text", ^BOOL(HTMLElement * _Nonnull element) {
+		if ([element[@"type"] isEqualToString:@"text"]) {
+			return YES;
+		}
+		return NO;
+	});
+}
+
+#pragma mark - State
+
+CSSSelector * enabledSelector()
+{
+	// https://html.spec.whatwg.org/multipage/scripting.html#selector-enabled
+	CSSSelector *candiate = anyOf(@[
+									typeSelector(@"button"),
+									typeSelector(@"input"),
+									typeSelector(@"select"),
+									typeSelector(@"textarea"),
+									typeSelector(@"optgroup"),
+									typeSelector(@"option"),
+									typeSelector(@"menuitem"),
+									typeSelector(@"fieldset"),
+									]);
+	return namedPseudoSelector(@"enabled", allOf(@[candiate, not(disabledSelector())]));
+}
+
+CSSSelector * disabledSelector()
+{
+	// https://html.spec.whatwg.org/multipage/scripting.html#selector-disabled
+	CSSSelector *disabledAttribute = hasAttributeSelector(@"disabled");
+
+	// https://html.spec.whatwg.org/multipage/forms.html#concept-fieldset-disabled
+	CSSSelector *disabledFieldset = allOf(@[typeSelector(@"fieldset"), disabledAttribute]);
+	CSSSelector *firstLegend = allOf(@[typeSelector(@"legend"), firstOfTypeSelector()]);
+	CSSSelector *firstLegendDecendantDisabledFieldSet = allOf(@[firstLegend, descendantOfElementSelector(disabledFieldset)]);
+
+	// https://html.spec.whatwg.org/multipage/forms.html#concept-fe-disabled
+	CSSSelector *disabledForm = anyOf(@[
+										anyOf(@[
+												allOf(@[typeSelector(@"button"), disabledAttribute]),
+												allOf(@[typeSelector(@"input"), disabledAttribute]),
+												allOf(@[typeSelector(@"select"), disabledAttribute]),
+												allOf(@[typeSelector(@"textarea"), disabledAttribute])
+												]),
+										allOf(@[
+												descendantOfElementSelector(disabledFieldset),
+												not(firstLegendDecendantDisabledFieldSet)
+												])
+										]);
+
+	// https://html.spec.whatwg.org/multipage/scripting.html#selector-disabled
+	CSSSelector *disabledMenuItem = allOf(@[typeSelector(@"menuitem"), disabledAttribute]);
+	CSSSelector *disabledOptgroup = allOf(@[typeSelector(@"optgroup"), disabledAttribute]);
+
+	// https://html.spec.whatwg.org/multipage/forms.html#concept-option-disabled
+	CSSSelector *disabledOption = allOf(@[
+										  typeSelector(@"option"),
+										  anyOf(@[
+												  disabledAttribute,
+												  descendantOfElementSelector(disabledOptgroup)])
+										  ]);
+	return namedPseudoSelector(@"disabled",
+							   anyOf(@[disabledOption, disabledOptgroup, disabledMenuItem, disabledForm, disabledFieldset]));
+}
+
+CSSSelector * checkedSelector()
+{
+	// https://html.spec.whatwg.org/multipage/scripting.html#selector-checked
+	CSSSelector *candidate = anyOf(@[
+									 typeSelector(@"input"),
+									 typeSelector(@"option"),
+									 typeSelector(@"menutitem")
+									 ]);
+	CSSSelector *hasAttribute = anyOf(@[
+										hasAttributeSelector(@"checked"),
+										hasAttributeSelector(@"selected")
+										]);
+
+	return namedPseudoSelector(@"checked", allOf(@[candidate, hasAttribute]));
+}
+
+CSSSelector * optionalSelector()
+{
+	// https://html.spec.whatwg.org/multipage/scripting.html#selector-optional
+	CSSSelector *candidate = anyOf(@[
+									 typeSelector(@"input"),
+									 typeSelector(@"select"),
+									 typeSelector(@"textarea")
+									 ]);
+	CSSSelector *noAttribute = not(hasAttributeSelector(@"required"));
+
+	return namedPseudoSelector(@"optional", allOf(@[candidate, noAttribute]));
+}
+
+CSSSelector * requiredSelector()
+{
+	// https://html.spec.whatwg.org/multipage/scripting.html#selector-required
+	// https://html.spec.whatwg.org/multipage/forms.html#concept-input-required
+	CSSSelector *candidate = anyOf(@[
+									 typeSelector(@"input"),
+									 typeSelector(@"select"),
+									 typeSelector(@"textarea")
+									 ]);
+	CSSSelector *hasAttribute = hasAttributeSelector(@"required");
+
+	return namedPseudoSelector(@"required", allOf(@[candidate, hasAttribute]));
+}
+
+#pragma mark - Positional
+
+CSSSelector * ltSelector(NSInteger index)
+{
+	NSString *name = [NSString stringWithFormat:@":lt(%ld)", (long)index];
+	return namedBlockSelector(name, ^BOOL(HTMLElement * _Nonnull element) {
+		NSUInteger elementIndex = [element.parentElement indexOfChildNode:element];
+
+		if (index > 0) {
+			return elementIndex < index;
+		} else {
+			return elementIndex < element.parentElement.childNodesCount - index - 1;
+		}
+	});
+}
+
+CSSSelector * gtSelector(NSInteger index)
+{
+	NSString *name = [NSString stringWithFormat:@":gt(%ld)", (long)index];
+	return namedBlockSelector(name, ^BOOL(HTMLElement * _Nonnull element) {
+		NSUInteger elementIndex = [element.parentElement indexOfChildNode:element];
+
+		if (index > 0) {
+			return elementIndex > index;
+		} else {
+			return elementIndex > element.parentElement.childNodesCount - index - 1;
+		}
+	});
+}
+
+CSSSelector * eqSelector(NSInteger index)
+{
+	NSString *name = [NSString stringWithFormat:@":eq(%ld)", (long)index];
+	return namedBlockSelector(name, ^BOOL(HTMLElement * _Nonnull element) {
+		NSUInteger elementIndex = [element.parentElement indexOfChildNode:element];
+
+		if (index > 0) {
+			return elementIndex == index;
+		} else {
+			return elementIndex == element.parentElement.childNodesCount - index - 1;
+		}
+	});
+}

HTMLKit/CSSTypeSelector.h

@@ -0,0 +1,41 @@
+//
+//  CSSTypeSelector.h
+//  HTMLKit
+//
+//  Created by Iska on 13/05/15.
+//  Copyright (c) 2015 BrainCookie. All rights reserved.
+//
+
+#import <Foundation/Foundation.h>
+#import "CSSSelector.h"
+
+NS_ASSUME_NONNULL_BEGIN
+
+/**
+ CSS Type Selector.
+ */
+@interface CSSTypeSelector : CSSSelector
+
+/**
+ The type of elements being matched.
+ */
+@property (nonatomic, strong, readonly) NSString *type;
+
+/**
+ Returns the universal selector.
+
+ @return A new instance of a universal selector that matches all elements.
+ */
++ (instancetype)universalSelector;
+
+/**
+ Initializes a new selector for the specified type.
+
+ @param type The type of elements that should be matched.
+ @return A new instance of a type selector.
+ */
+- (instancetype)initWithType:(NSString *)type;
+
+@end
+
+NS_ASSUME_NONNULL_END

HTMLKit/CSSTypeSelector.m

@@ -0,0 +1,50 @@
+//
+//  CSSTypeSelector.m
+//  HTMLKit
+//
+//  Created by Iska on 13/05/15.
+//  Copyright (c) 2015 BrainCookie. All rights reserved.
+//
+
+#import "CSSTypeSelector.h"
+#import "HTMLElement.h"
+#import "NSString+HTMLKit.h"
+
+@interface CSSTypeSelector ()
+{
+	NSString *_type;
+}
+@end
+
+@implementation CSSTypeSelector
+
++ (instancetype)universalSelector
+{
+	return [[self alloc] initWithType:@"*"];
+}
+
+- (instancetype)initWithType:(NSString *)type
+{
+	self = [super init];
+	if (self) {
+		_type = [type copy];
+	}
+	return self;
+}
+
+- (BOOL)acceptElement:(HTMLElement *)element
+{
+	if ([_type isEqualToString:@"*"] || [_type isEqualToStringIgnoringCase:element.tagName]) {
+		return YES;
+	}
+	return NO;
+}
+
+#pragma mark - Description
+
+- (NSString *)debugDescription
+{
+	return self.type;
+}
+
+@end

HTMLKit/HTMLCharacterToken.h

@@ -6,22 +6,76 @@
 //  Copyright (c) 2014 BrainCookie. All rights reserved.
 //
 
+///------------------------------------------------------
+/// HTMLKit private header
+///------------------------------------------------------
+
 #import <Foundation/Foundation.h>
 #import "HTMLToken.h"
 
+/**
+ HTML Character Token
+ */
 @interface HTMLCharacterToken : HTMLToken
 
+/** @brief The characters in this token. */
 @property (nonatomic, copy) NSString *characters;
 
+/**
+ Initializes a new character token.
+ 
+ @param string The string with which to initialize the token.
+ @return A new instance of a character token.
+ */
 - (instancetype)initWithString:(NSString *)string;
 
+/**
+ Appends the given string to this token.
+ 
+ @param string The string to append.
+ */
 - (void)appendString:(NSString *)string;
+
+/**
+ Checks whether this token is a whitespace character token.
+
+ @discussion HTML whitespace characters are: CHARACTER TABULATION U+0009, LINE FEED U+000A, FORM FEED U+000C,
+ CARRIAGE RETURN U+000D, and SPACE U+0020
+
+ @return `YES` if this token contains only whitespace characters, `NO` otherwise.
+ */
 - (BOOL)isWhitespaceToken;
+
+/**
+ Checks whether this token is empty.
+
+ @return `YES` if this token is empty, `NO` otherwise.
+ */
 - (BOOL)isEmpty;
 
+/**
+ Retains all leading whitespace characters in this token.
+ */
 - (void)retainLeadingWhitespace;
+
+/**
+ Trims all leading whitespace characters in this token.
+ */
 - (void)trimLeadingWhitespace;
+
+/**
+ Trims the characters in this token from a given index
+ 
+ @param index The start index from which to trim the token.
+ */
 - (void)trimFormIndex:(NSUInteger)index;
+
+/**
+ Splits this token retaining only characters after the leading whitespace. The leading whitespace characters are then
+ returned a new characters token.
+
+ @return A characters token with leading whitespace characters. Returns 'nil` if no leading whitespace exists.
+ */
 - (HTMLCharacterToken *)tokenBySplitingLeadingWhiteSpace;
 
 @end

HTMLKit/HTMLComment.h

@@ -8,10 +8,24 @@
 
 #import "HTMLNode.h"
 
+NS_ASSUME_NONNULL_BEGIN
+
+/**
+ A HTML Comment node
+ */
 @interface HTMLComment : HTMLNode
 
+/** @brief The comment string. */
 @property (nonatomic, copy) NSString *data;
 
+/**
+ Initializes a new HTML comment node.
+
+ @param data The comment string.
+ @return A new isntance of a HTML comment node.
+ */
 - (instancetype)initWithData:(NSString *)data;
 
 @end
+
+NS_ASSUME_NONNULL_END

HTMLKit/HTMLComment.m

@@ -7,9 +7,15 @@
 //
 
 #import "HTMLComment.h"
+#import "HTMLNode+Private.h"
 
 @implementation HTMLComment
 
+- (instancetype)init
+{
+	return [self initWithData:@""];
+}
+
 - (instancetype)initWithData:(NSString *)data
 {
 	self = [super initWithName:@"#comment" type:HTMLNodeComment];

HTMLKit/HTMLCommentToken.h

@@ -6,15 +6,34 @@
 //  Copyright (c) 2014 BrainCookie. All rights reserved.
 //
 
+///------------------------------------------------------
+/// HTMLKit private header
+///------------------------------------------------------
+
 #import <Foundation/Foundation.h>
 #import "HTMLToken.h"
 
+/**
+ HTML Comment Token
+ */
 @interface HTMLCommentToken : HTMLToken
 
+/** @brief The comment string in this token. */
 @property (nonatomic, copy) NSString *data;
 
+/**
+ Initializes a new comment token.
+
+ @param string The string with which to initialize the token.
+ @return A new instance of a comment token.
+ */
 - (instancetype)initWithData:(NSString *)data;
 
+/**
+ Appends the given string to this token.
+
+ @param string The string to append.
+ */
 - (void)appendStringToData:(NSString *)string;
 
 @end

HTMLKit/HTMLDOCTYPEToken.h

@@ -6,20 +6,57 @@
 //  Copyright (c) 2014 BrainCookie. All rights reserved.
 //
 
+///------------------------------------------------------
+/// HTMLKit private header
+///------------------------------------------------------
+
 #import <Foundation/Foundation.h>
 #import "HTMLToken.h"
 
+/**
+ HTML DOCTYPE Token
+ */
 @interface HTMLDOCTYPEToken : HTMLToken
 
+/** @brief The DOCTYPE's name. */
 @property (nonatomic, copy) NSString *name;
+
+/** @brief The DOCTYPE's public identifier. */
 @property (nonatomic, strong) NSMutableString *publicIdentifier;
+
+/** @brief The DOCTYPE's system identifier. */
 @property (nonatomic, strong) NSMutableString *systemIdentifier;
+
+/** @brief Flag whether this DOCTYPE forces quirks mode. */
 @property (nonatomic, assign) BOOL forceQuirks;
 
+/**
+ Initializes a new DOCTYPE token.
+
+ @param name The name with which to initialize the token.
+ @return A new instance of a DOCTYPE token.
+ */
 - (instancetype)initWithName:(NSString *)name;
 
+/**
+ Appends the given string to this DOCTYPE's name.
+
+ @param string The string to append.
+ */
 - (void)appendStringToName:(NSString *)string;
+
+/**
+ Appends the given string to this DOCTYPE's public identifier.
+
+ @param string The string to append.
+ */
 - (void)appendStringToPublicIdentifier:(NSString *)string;
+
+/**
+ Appends the given string to this DOCTYPE's system identifier.
+
+ @param string The string to append.
+ */
 - (void)appendStringToSystemIdentifier:(NSString *)string;
 
 @end

HTMLKit/HTMLDOM.h

@@ -9,8 +9,16 @@
 #import "HTMLNode.h"
 #import "HTMLDocument.h"
 #import "HTMLDocumentType.h"
+#import "HTMLDocumentFragment.h"
 #import "HTMLElement.h"
 #import "HTMLComment.h"
 #import "HTMLText.h"
 #import "HTMLTemplate.h"
-#import "HTMLDocumentFragment.h"
+#import "HTMLDOMTokenList.h"
+#import "HTMLNodeIterator.h"
+#import "HTMLTreeWalker.h"
+#import "HTMLNodeFilter.h"
+
+#import "HTMLKitDOMExceptions.h"
+#import "HTMLNamespaces.h"
+#import "HTMLQuirksMode.h"

HTMLKit/HTMLDOMTokenList.h

@@ -0,0 +1,108 @@
+//
+//  HTMLDOMTokenList.h
+//  HTMLKit
+//
+//  Created by Iska on 30/11/15.
+//  Copyright © 2015 BrainCookie. All rights reserved.
+//
+
+#import <Foundation/Foundation.h>
+
+NS_ASSUME_NONNULL_BEGIN
+
+@class HTMLElement;
+
+/**
+ A HTML DOM Token List.
+
+ The DOM Token List is used for manipulating an element's attributes that contain muliplte values separated by a space.
+
+ https://dom.spec.whatwg.org/#interface-domtokenlist
+ */
+@interface HTMLDOMTokenList : NSObject
+
+/** @brief The associated context element. */
+@property (nonatomic, strong, readonly) HTMLElement *element;
+
+/** @brief The associated attribute. */
+@property (nonatomic, strong, readonly) NSString *attribute;
+
+/**
+ Initializes a new DOM token list.
+
+ @param element The associated context element.
+ @param attribute The associated attribute.
+ @param value The initial attribute's value.
+ @return A new instance of the DOM token list.
+ */
+- (instancetype)initWithElement:(HTMLElement *)element attribute:(NSString *)attribute value:(NSString *)value;
+
+/**
+ @return The length of this token list
+ */
+- (NSUInteger)length;
+
+/**
+ Checks whether this list contains the given token.
+ 
+ @param token The token.
+ @return `YES` if the given token is in this list, `NO` otherwise.
+ */
+- (BOOL)contains:(NSString *)token;
+
+/**
+ Add the given tokens to the list.
+
+ @param tokens The tokens to add.
+ */
+- (void)add:(NSArray<NSString *> *)tokens;
+
+/**
+ Removes the given tokens from the list.
+
+ @param tokens The tokens to remove.
+ */
+- (void)remove:(NSArray<NSString *> *)tokens;
+
+/**
+ Toggles the given token.
+
+ @param token The token to toggle.
+ @return `YES` if the token was added to the list, `NO` if it was removed from it.
+ */
+- (BOOL)toggle:(NSString *)token;
+
+/**
+ Replaces the given token with new token.
+
+ @param token The token to replace.
+ @param newToken The replacement token.
+ */
+- (void)replaceToken:(NSString *)token withToken:(NSString *)newToken;
+
+/**
+ Returns the value of the token at the given index.
+
+ @param index The index at which to return the token.
+ @return The token at the given index. If index is greater than or equal to the value returned by count, an
+ NSRangeException is raised.
+ */
+- (NSString *)objectAtIndexedSubscript:(NSUInteger)index;
+
+/**
+ Set the token at the given index.
+
+ @param obj The token to set.
+ @param index The index at which to set the token. If index is greater than or equal to the value returned by count, an
+ NSRangeException is raised.
+ */
+- (void)setObject:(NSString *)obj atIndexedSubscript:(NSUInteger)index;
+
+/**
+ @return The string representation of this token list, which can be used as the attribute's value.
+ */
+- (NSString *)stringify;
+
+@end
+
+NS_ASSUME_NONNULL_END

HTMLKit/HTMLDOMTokenList.m

@@ -0,0 +1,109 @@
+//
+//  HTMLDOMTokenList.m
+//  HTMLKit
+//
+//  Created by Iska on 30/11/15.
+//  Copyright © 2015 BrainCookie. All rights reserved.
+//
+
+#import "HTMLDOMTokenList.h"
+#import "HTMLElement.h"
+
+@interface HTMLDOMTokenList ()
+{
+	HTMLElement *_element;
+	NSString *_attribute;
+	NSMutableOrderedSet *_tokens;
+}
+@end
+
+@implementation HTMLDOMTokenList
+@synthesize element = _element;
+@synthesize attribute = _attribute;
+
+#pragma mark - Init
+
+- (instancetype)initWithElement:(HTMLElement *)element attribute:(NSString *)attribute value:(NSString *)value
+{
+	self = [super init];
+	if (self) {
+		_element = element;
+		_attribute = [attribute copy];
+		_tokens = [NSMutableOrderedSet new];
+		[self add:[value componentsSeparatedByString:@" "]];
+	}
+	return self;
+}
+
+#pragma mark - Access
+
+- (void)updateValue
+{
+	_element[_attribute] = self.stringify;
+}
+
+- (NSUInteger)length
+{
+	return _tokens.count;
+}
+
+- (BOOL)contains:(NSString *)token
+{
+	return [_tokens containsObject:token];
+}
+
+- (void)add:(NSArray<NSString *> *)tokens
+{
+	for (NSString *token in tokens) {
+		if (![token isEqualToString:@""]) {
+			[_tokens addObject:token];
+		}
+	}
+	[self updateValue];
+}
+
+- (void)remove:(NSArray<NSString *> *)tokens
+{
+	for (NSString *token in tokens) {
+		[_tokens removeObject:token];
+	}
+	[self updateValue];
+}
+
+- (BOOL)toggle:(NSString *)token
+{
+	if ([_tokens containsObject:token]) {
+		[_tokens removeObject:token];
+		[self updateValue];
+		return NO;
+	} else {
+		[_tokens addObject:token];
+		[self updateValue];
+		return YES;
+	}
+}
+
+- (void)replaceToken:(NSString *)token withToken:(NSString *)newToken
+{
+	NSUInteger index = [_tokens indexOfObject:token];
+	_tokens[index] = newToken;
+	[self updateValue];
+}
+
+- (NSString *)objectAtIndexedSubscript:(NSUInteger)index
+{
+	return _tokens[index];
+}
+
+- (void)setObject:(NSString *)obj atIndexedSubscript:(NSUInteger)index
+{
+	_tokens[index] = obj;
+	[self updateValue];
+}
+
+- (NSString *)stringify
+{
+	return [_tokens.array componentsJoinedByString:@" "];
+}
+
+@end

HTMLKit/HTMLDocument.h

@@ -10,6 +10,12 @@
 #import "HTMLDocumentType.h"
 #import "HTMLQuirksMode.h"
 
+NS_ASSUME_NONNULL_BEGIN
+
+/**
+ The document's ready state. The document is `Loading` while being parsed, `Complete` otherwise. The `Interactive` state
+ is not supported.
+ */
 typedef NS_ENUM(short, HTMLDocumentReadyState)
 {
 	HTMLDocumentLoading,
@@ -17,18 +23,76 @@ typedef NS_ENUM(short, HTMLDocumentReadyState)
 	HTMLDocumentComplete
 };
 
+/**
+ The HTML Document. This is the root of a parsed DOM tree.
+
+ https://html.spec.whatwg.org/multipage/dom.html#documents
+ */
 @interface HTMLDocument : HTMLNode
 
-@property (nonatomic, strong) HTMLDocumentType *documentType;
+/** 
+ The document's DOCTYPE.
+ 
+ @see HTMLDocumentType
+ */
+@property (nonatomic, strong, nullable) HTMLDocumentType *documentType;
 
+/**
+ The document's quirks mode.
+
+ @see HTMLQuirksMode
+ */
 @property (nonatomic, assign) HTMLQuirksMode quirksMode;
 
-@property (nonatomic, copy, readonly) NSString *compatMode;
-
+/**
+ The document's ready state.
+ 
+ @see HTMLDocumentReadyState
+ */
 @property (nonatomic, assign, readonly) HTMLDocumentReadyState readyState;
 
+/**
+ The document's root element, which is the first element in tree order, if any. Usually it is the <html> element.
+ */
+@property (nonatomic, strong, nullable) HTMLElement *rootElement;
+
+/**
+ The document element, i.e. the <html> element, if it exists.
+ */
+@property (nonatomic, strong, nullable) HTMLElement *documentElement;
+
+/**
+ The document's <head> element, if it exists.
+ */
+@property (nonatomic, strong, nullable) HTMLElement *head;
+
+/**
+ The document's <body> element, if it exists.
+ */
+@property (nonatomic, strong, nullable) HTMLElement *body;
+
+/**
+ Retunrs a new HTML Document instance with the given HTML string.
+ 
+ @param string The HTML string to parse into a document.
+ */
++ (instancetype)documentWithString:(NSString *)string;
+
+/**
+ Adopts a given node into this document, i.e. the document becomes the new owner of the node. Raises a HTMLKitNotSupportedError
+ exception if node is an instance of HTMLDocument.
+ 
+ @param node The node to adopt.
+ @return The adopted node
+ */
 - (HTMLNode *)adoptNode:(HTMLNode *)node;
 
+/**
+ Returns the associated HTML Document proxy instance, which owns the template contents of all its template elements.
+ https://html.spec.whatwg.org/multipage/scripting.html#associated-inert-template-document
+ */
 - (HTMLDocument *)associatedInertTemplateDocument;
 
 @end
+
+NS_ASSUME_NONNULL_END

HTMLKit/HTMLDocument.m

@@ -7,16 +7,21 @@
 //
 
 #import "HTMLDocument.h"
-#import "HTMLKitExceptions.h"
+#import "HTMLParser.h"
+#import "HTMLNodeIterator.h"
+#import "HTMLKitDOMExceptions.h"
+#import "HTMLNode+Private.h"
 
-@interface HTMLNode (Private)
-@property (nonatomic, weak) HTMLDocument *ownerDocument;
-@property (nonatomic, weak) HTMLNode *parentNode;
+@interface HTMLNodeIterator (Private)
+- (void)runRemovingStepsForNode:(HTMLNode *)oldNode
+				  withOldParent:(HTMLNode *)oldParent
+		  andOldPreviousSibling:(HTMLNode *)oldPreviousSibling;
 @end
 
 @interface HTMLDocument ()
 {
 	HTMLDocument *_inertTemplateDocument;
+	NSMutableArray *_nodeIterators;
 }
 @property (nonatomic, assign) HTMLDocumentReadyState readyState;
 @end
@@ -25,11 +30,18 @@
 
 #pragma mark - Init
 
++ (instancetype)documentWithString:(NSString *)string
+{
+	HTMLParser *parser = [[HTMLParser alloc] initWithString:string];
+	return [parser parseDocument];
+}
+
 - (instancetype)init
 {
 	self = [super initWithName:@"#document" type:HTMLNodeDocument];
 	if (self) {
 		_readyState = HTMLDocumentLoading;
+		_nodeIterators = [NSMutableArray new];
 	}
 	return self;
 }
@@ -57,6 +69,91 @@
 	}
 }
 
+#pragma mark - 
+
+- (HTMLElement *)rootElement
+{
+	for (HTMLNode *node = self.firstChild; node; node = node.nextSibling) {
+		if (node.nodeType == HTMLNodeElement) {
+			return node.asElement;
+		}
+	}
+	return nil;
+}
+
+- (void)setRootElement:(HTMLElement *)rootElement
+{
+	[self replaceChildNode:self.rootElement withNode:rootElement];
+}
+
+- (HTMLElement *)documentElement
+{
+	for (HTMLNode *node in [self nodeIteratorWithShowOptions:HTMLNodeFilterShowElement filter:nil]) {
+		if ([node.asElement.tagName isEqualToString:@"html"]) {
+			return node.asElement;
+		}
+	}
+	return nil;
+}
+
+- (void)setDocumentElement:(HTMLElement *)documentElement
+{
+	[self replaceChildNode:self.documentElement withNode:documentElement];
+}
+
+- (HTMLElement *)head
+{
+	for (HTMLNode *node in [self nodeIteratorWithShowOptions:HTMLNodeFilterShowElement filter:nil]) {
+		if ([node.asElement.tagName isEqualToString:@"head"]) {
+			return node.asElement;
+		}
+	}
+	return nil;
+}
+
+- (void)setHead:(HTMLElement *)head
+{
+	[self replaceChildNode:self.head withNode:head];
+}
+
+- (HTMLElement *)body
+{
+	for (HTMLNode *node in [self nodeIteratorWithShowOptions:HTMLNodeFilterShowElement filter:nil]) {
+		if ([node.asElement.tagName isEqualToString:@"body"]) {
+			return node.asElement;
+		}
+	}
+	return nil;
+}
+
+- (void)setBody:(HTMLElement *)body
+{
+	[self replaceChildNode:self.body withNode:body];
+}
+
+#pragma mark - Node Iterators
+
+- (void)attachNodeIterator:(HTMLNodeIterator *)iterator
+{
+	[_nodeIterators addObject:iterator];
+}
+
+- (void)detachNodeIterator:(HTMLNodeIterator *)iterator
+{
+	[_nodeIterators removeObject:iterator];
+}
+
+- (void)runRemovingStepsForNode:(HTMLNode *)oldNode
+				  withOldParent:(HTMLNode *)oldParent
+		  andOldPreviousSibling:(HTMLNode *)oldPreviousSibling
+{
+	for (HTMLNodeIterator *iterator in _nodeIterators) {
+		[iterator runRemovingStepsForNode:oldNode
+							 withOldParent:oldParent
+					 andOldPreviousSibling:oldPreviousSibling];
+	}
+}
+
 #pragma mark - Mutation Algorithms
 
 - (HTMLNode *)adoptNode:(HTMLNode *)node
@@ -65,7 +162,7 @@
 		return nil;
 	}
 
-	if (node.type == HTMLNodeDocument) {
+	if (node.nodeType == HTMLNodeDocument) {
 		[NSException raise:HTMLKitNotSupportedError
 					format:@"%@: Not Fount Error, adopting a document node. The operation is not supported.", NSStringFromSelector(_cmd)];
 	}

HTMLKit/HTMLDocumentFragment.h

@@ -8,8 +8,24 @@
 
 #import "HTMLNode.h"
 
+NS_ASSUME_NONNULL_BEGIN
+
+/**
+ A HTML Document Fragment. Represents a minimal document object that has no parent. It is used as a light-weight 
+ version of Document
+
+ https://dom.spec.whatwg.org/#interface-documentfragment
+ */
 @interface HTMLDocumentFragment : HTMLNode
 
-- (instancetype)initWithDocument:(HTMLDocument *)document;
+/**
+ Initializes a new document fragment with the given document as owner.
+ 
+ @param document The owner document.
+ @return A new instance of a document fragment.
+ */
+- (instancetype)initWithDocument:(nullable HTMLDocument *)document;
 
 @end
+
+NS_ASSUME_NONNULL_END

HTMLKit/HTMLDocumentFragment.m

@@ -8,13 +8,15 @@
 
 #import "HTMLDocumentFragment.h"
 #import "HTMLText.h"
-
-@interface HTMLNode ()
-@property (nonatomic, weak) HTMLDocument *ownerDocument;
-@end
+#import "HTMLNode+Private.h"
 
 @implementation HTMLDocumentFragment
 
+- (instancetype)init
+{
+	return [self initWithDocument:nil];
+}
+
 - (instancetype)initWithDocument:(HTMLDocument *)document
 {
 	self = [super initWithName:@"#document-fragment" type:HTMLNodeDocumentFragment];
@@ -27,8 +29,8 @@
 - (NSString *)textContent
 {
 	NSMutableString *content = [NSMutableString string];
-	for (HTMLNode *node in self.treeEnumerator) {
-		if (node.type == HTMLNodeText) {
+	for (HTMLNode *node in self.nodeIterator) {
+		if (node.nodeType == HTMLNodeText) {
 			[content appendString:[(HTMLText *)node data]];
 		}
 	}

HTMLKit/HTMLDocumentType.h

@@ -9,17 +9,56 @@
 #import "HTMLNode.h"
 #import "HTMLQuirksMode.h"
 
+NS_ASSUME_NONNULL_BEGIN
+
+/**
+ A HTML Document Type node. There is only one valid document type, which is `<!DOCTYPE html>`.
+ 
+ Other DOCTYPES, e.g. <!DOCTYPE html PUBLIC "-//W3C//DTD HTML 4.01//EN" "http://www.w3.org/TR/html4/strict.dtd">
+ are obsolete but permitted.
+
+ https://dom.spec.whatwg.org/#interface-documenttype
+ */
 @interface HTMLDocumentType : HTMLNode
 
+/**
+ The public identifier
+ */
 @property (nonatomic, copy, readonly) NSString *publicIdentifier;
 
+/**
+ The system identifier
+ */
 @property (nonatomic, copy, readonly) NSString *systemIdentifier;
 
-- (instancetype)initWithName:(NSString *)name
-			publicIdentifier:(NSString *)publicIdentifier
-			systemIdentifier:(NSString *)systemIdentifier;
+/**
+ Initializes and returns a new isntance of a Document Type node.
 
+ @param name The name.
+ @param publicIdentifier The public identifier.
+ @param systemIdentifier The system identigier
+ @return A new document type instance.
+ */
+- (instancetype)initWithName:(NSString *)name
+			publicIdentifier:(nullable NSString *)publicIdentifier
+			systemIdentifier:(nullable NSString *)systemIdentifier;
+
+/**
+ Checks whether this DOCTYPE is valid.
+ 
+ @return `YES` if this is a valid DOCTYPE, `NO` otherwise.
+ */
 - (BOOL)isValid;
+
+/**
+ Return the quirks mode of this DOCTYPE.
+
+ @return The quirks mode.
+
+ @see HTMLQuirksMode
+ */
 - (HTMLQuirksMode)quirksMode;
 
 @end
+
+NS_ASSUME_NONNULL_END

HTMLKit/HTMLDocumentType.m

@@ -8,6 +8,7 @@
 
 #import "HTMLDocumentType.h"
 #import "NSString+HTMLKit.h"
+#import "HTMLNode+Private.h"
 
 NS_INLINE BOOL nilOrEqual(id first, id second) {
 	return (first == nil) || ([first isEqual:second]);
@@ -22,6 +23,11 @@ NS_INLINE BOOL nilOrEqual(id first, id second) {
 
 @implementation HTMLDocumentType
 
+- (instancetype)init
+{
+	return [self initWithName:@"html" publicIdentifier:nil systemIdentifier:nil];
+}
+
 - (instancetype)initWithName:(NSString *)name
 			publicIdentifier:(NSString *)publicIdentifier
 			systemIdentifier:(NSString *)systemIdentifier

HTMLKit/HTMLEOFToken.h

@@ -6,10 +6,18 @@
 //  Copyright (c) 2015 BrainCookie. All rights reserved.
 //
 
+///------------------------------------------------------
+/// HTMLKit private header
+///------------------------------------------------------
+
 #import "HTMLToken.h"
 
+/**
+ A HTML EOF Token.
+ */
 @interface HTMLEOFToken : HTMLToken
 
+/** Returns the singleton instance of the EOF Token. */
 + (instancetype)token;
 
 @end

HTMLKit/HTMLElement.h

@@ -9,26 +9,115 @@
 #import <Foundation/Foundation.h>
 #import "HTMLNamespaces.h"
 #import "HTMLNode.h"
+#import "HTMLDOMTokenList.h"
 
+NS_ASSUME_NONNULL_BEGIN
+
+/**
+  A HTML Element.
+
+ https://html.spec.whatwg.org/multipage/dom.html#elements
+ https://html.spec.whatwg.org/multipage/syntax.html#elements-2
+ */
 @interface HTMLElement : HTMLNode
 
+/**
+ The namesapce of this element.
+
+ @see HTMLNamespace
+ */
 @property (nonatomic, assign, readonly) HTMLNamespace htmlNamespace;
 
+/**
+ The elemen's tag name.
+ */
 @property (nonatomic, copy, readonly) NSString *tagName;
 
-@property (nonatomic, strong) NSMutableDictionary *attributes;
-
+/**
+ The elemen's id attribute value. Empty string if the element has no id attribute.
+ */
 @property (nonatomic, copy)	NSString *elementId;
 
+/**
+ The elemen's class attribute value. Empty string if the element has no class attribute.
+ */
 @property (nonatomic, copy)	NSString *className;
 
-- (instancetype)initWithTagName:(NSString *)tagName;
-- (instancetype)initWithTagName:(NSString *)tagName attributes:(NSDictionary *)attributes;
-- (instancetype)initWithTagName:(NSString *)tagName attributes:(NSDictionary *)attributes namespace:(HTMLNamespace)htmlNamespace;
+/**
+ The element's class attribute as a DOM Token List
 
+ @see HTMLDOMTokenList
+ */
+@property (nonatomic, strong, readonly)	HTMLDOMTokenList *classList;
+
+/**
+ The element's attribites.
+ */
+@property (nonatomic, strong) NSMutableDictionary *attributes;
+
+/**
+ @warning Use one of the initWithTagName: methods instead.
+ */
+- (instancetype)init NS_UNAVAILABLE;
+
+/**
+ Initializes a new HTML element with the given tag name.
+ 
+ @param tagname The tag name.
+ @return A new HTML element.
+ */
+- (instancetype)initWithTagName:(NSString *)tagName;
+
+/**
+ Initializes a new HTML element with the given tag name and attributes.
+
+ @param tagname The tag name.
+ @param attributes The attributes.
+ @return A new HTML element.
+ */
+- (instancetype)initWithTagName:(NSString *)tagName attributes:(NSDictionary *)attributes;
+
+/**
+ Initializes a new HTML element with the given tag name, namespace, and attributes.
+
+ @param tagname The tag name.
+ @param namespace The namespace.
+ @param attributes The attributes.
+ @return A new HTML element.
+ */
+- (instancetype)initWithTagName:(NSString *)tagName namespace:(HTMLNamespace)htmlNamespace attributes:(NSDictionary *)attributes;
+
+/**
+ Checks whether this element has an attribute with the given name.
+ 
+ @param name The attribute name.
+ @return `YES` if the element has such an attributes, `NO` otherwise.
+ */
 - (BOOL)hasAttribute:(NSString *)name;
-- (NSString *)objectForKeyedSubscript:(NSString *)name;
+
+/**
+ Returns the value of the attribute with the given name.
+ 
+ @param name The attribute's name.
+ @return The attribute's value, `nil` if the element doesn't have such attribute.
+ */
+- (nullable NSString *)objectForKeyedSubscript:(NSString *)name;
+
+/**
+ Set the value of the attribute with the given name.
+
+ @param value The value to set.
+ @param name The attribute's name.
+ */
 - (void)setObject:(NSString *)value forKeyedSubscript:(NSString *)attribute;
+
+/**
+ Removes the attribute with the given name.
+ 
+ @param name The attribute to remove.
+ */
 - (void)removeAttribute:(NSString *)name;
 
 @end
+
+NS_ASSUME_NONNULL_END

HTMLKit/HTMLElement.m

@@ -7,11 +7,13 @@
 //
 
 #import "HTMLElement.h"
+#import "HTMLParser.h"
 #import "HTMLDocument.h"
 #import "HTMLText.h"
-
+#import "HTMLDOMTokenList.h"
 #import "HTMLOrderedDictionary.h"
 #import "NSString+HTMLKit.h"
+#import "HTMLNode+Private.h"
 
 @interface HTMLElement ()
 {
@@ -25,20 +27,20 @@
 
 - (instancetype)init
 {
-	return [self initWithTagName:nil];
+	return [self initWithTagName:@""];
 }
 
 - (instancetype)initWithTagName:(NSString *)tagName
 {
-	return [self initWithTagName:tagName attributes:nil];
+	return [self initWithTagName:tagName attributes:@{}];
 }
 
 - (instancetype)initWithTagName:(NSString *)tagName attributes:(NSDictionary *)attributes
 {
-	return [self initWithTagName:tagName attributes:attributes namespace:HTMLNamespaceHTML];
+	return [self initWithTagName:tagName namespace:HTMLNamespaceHTML attributes:attributes];
 }
 
-- (instancetype)initWithTagName:(NSString *)tagName attributes:(NSDictionary *)attributes namespace:(HTMLNamespace)htmlNamespace
+- (instancetype)initWithTagName:(NSString *)tagName namespace:(HTMLNamespace)htmlNamespace attributes:(NSDictionary *)attributes
 {
 	self = [super initWithName:tagName type:HTMLNodeElement];
 	if (self) {
@@ -52,18 +54,35 @@
 	return self;
 }
 
-#pragma mark - Attributes
+#pragma mark - Special Attributes
 
 - (NSString *)elementId
 {
 	return _attributes[@"id"] ?: @"";
 }
 
+- (void)setElementId:(NSString *)elementId
+{
+	_attributes[@"id"] = elementId;
+}
+
 - (NSString *)className
 {
-	return _attributes[@"class"];
+	return _attributes[@"class"] ?: @"";
 }
 
+- (void)setClassName:(NSString *)className
+{
+	_attributes[@"class"] = className;
+}
+
+- (HTMLDOMTokenList *)classList
+{
+	return [[HTMLDOMTokenList alloc] initWithElement:self attribute:@"class" value:self.className];
+}
+
+#pragma mark - Attributes
+
 - (BOOL)hasAttribute:(NSString *)name
 {
 	return _attributes[name] != nil;
@@ -87,8 +106,8 @@
 - (NSString *)textContent
 {
 	NSMutableString *content = [NSMutableString string];
-	for (HTMLNode *node in self.treeEnumerator) {
-		if (node.type == HTMLNodeText) {
+	for (HTMLNode *node in self.nodeIterator) {
+		if (node.nodeType == HTMLNodeText) {
 			[content appendString:[(HTMLText *)node data]];
 		}
 	}
@@ -101,6 +120,14 @@
 	[self replaceAllChildNodesWithNode:node];
 }
 
+- (void)setInnerHTML:(NSString *)innerHTML
+{
+	HTMLParser *parser = [[HTMLParser alloc] initWithString:innerHTML];
+	NSArray	*fragmentNodes = [parser parseFragmentWithContextElement:self];
+	[self removeAllChildNodes];
+	[self appendNodes:fragmentNodes];
+}
+
 #pragma mark - NSCopying
 
 - (id)copyWithZone:(NSZone *)zone
@@ -137,8 +164,8 @@
 		return result;
 	}
 
-	if ([self.tagName isEqualToAny:@"pre", @"textarea", @"listing", nil] && self.firstChiledNode.type == HTMLNodeText) {
-		HTMLText *textNode = (HTMLText *)self.firstChiledNode;
+	if ([self.tagName isEqualToAny:@"pre", @"textarea", @"listing", nil] && self.firstChild.nodeType == HTMLNodeText) {
+		HTMLText *textNode = (HTMLText *)self.firstChild;
 		if ([textNode.data hasPrefix:@"\n"]) {
 			[result appendString:@"\n"];
 		}
@@ -171,4 +198,9 @@
 	return description;
 }
 
+- (NSString *)debugDescription
+{
+	return self.description;
+}
+
 @end

HTMLKit/HTMLElementAdjustment.h

@@ -6,6 +6,10 @@
 //  Copyright (c) 2015 BrainCookie. All rights reserved.
 //
 
+///------------------------------------------------------
+/// HTMLKit private header
+///------------------------------------------------------
+
 #import	"HTMLElement.h"
 #import "HTMLTokens.h"
 #import "HTMLNamespaces.h"

HTMLKit/HTMLElementTypes.h

@@ -6,6 +6,10 @@
 //  Copyright (c) 2015 BrainCookie. All rights reserved.
 //
 
+///------------------------------------------------------
+/// HTMLKit private header
+///------------------------------------------------------
+
 #import	"HTMLElement.h"
 #import "HTMLNamespaces.h"
 #import "NSString+HTMLKit.h"
@@ -35,8 +39,8 @@ NS_INLINE BOOL IsSpecialElement(HTMLElement *element)
 				@"dir", @"div", @"dl", @"dt", @"embed", @"fieldset", @"figcaption",
 				@"figure", @"footer", @"form", @"frame", @"frameset", @"h1", @"h2", @"h3",
 				@"h4", @"h5", @"h6", @"head", @"header", @"hgroup", @"hr", @"html", @"iframe",
-				@"img", @"input", @"isindex", @"li", @"link", @"listing", @"main", @"marquee",
-				@"menu", @"menuitem", @"meta", @"nav", @"noembed", @"noframes", @"noscript",
+				@"img", @"input", @"li", @"link", @"listing", @"main", @"marquee",
+				@"menu", @"meta", @"nav", @"noembed", @"noframes", @"noscript",
 				@"object", @"ol", @"p", @"param", @"plaintext", @"pre", @"script", @"section",
 				@"select", @"source", @"style", @"summary", @"table", @"tbody", @"td",
 				@"template", @"textarea", @"tfoot", @"th", @"thead", @"title", @"tr",

HTMLKit/HTMLInputStreamReader.h

@@ -6,8 +6,17 @@
 //  Copyright (c) 2014 BrainCookie. All rights reserved.
 //
 
+///------------------------------------------------------
+/// HTMLKit private header
+///------------------------------------------------------
+
 #import <Foundation/Foundation.h>
 
+/** 
+ Typedef for the error callback block.
+
+ @param reason The string describing the reason of the reported error.
+ */
 typedef void (^ HTMLStreamReaderErrorCallback)(NSString *reason);
 
 /**
@@ -16,29 +25,143 @@ typedef void (^ HTMLStreamReaderErrorCallback)(NSString *reason);
  */
 @interface HTMLInputStreamReader : NSObject
 
+/** @brief The underlying string with which this stream reader was initialized */
 @property (nonatomic, readonly) NSString *string;
+
+/** @brief The current scan location */
 @property (nonatomic, readonly) NSUInteger currentLocation;
+
+/** @brief An error callback block, which gets called when encountering errors while reading the stream */
 @property (nonatomic, copy) HTMLStreamReaderErrorCallback errorCallback;
 
+/**
+ Initializes a new Input Stream Reader with the given string.
+ 
+ @param string The HTML string
+ @return A new instance of the Input Stream Reader.
+ */
 - (id)initWithString:(NSString *)string;
 
+/**
+ Returns the current input character.
+ 
+ @return The current code point in the input stream as a `UTF32Char`.
+ */
 - (UTF32Char)currentInputCharacter;
+
+/**
+ Returns the next input character without consuming it.
+
+ @return The next code point in the input stream as a `UTF32Char`. Returns `EOF` if the stream is fully consumed.
+ */
 - (UTF32Char)nextInputCharacter;
 
+/**
+ Returns the input character at a given offset without consuming it.
+
+ @param offset The offset of the character.
+ @return The code point in the input stream as a `UTF32Char` at the given offset.
+ */
+- (UTF32Char)inputCharacterPointAtOffset:(NSUInteger)offset;
+
+/**
+ Consumes and returns the next input character. Consuming a characters advances the current scan location of the
+ input stream.
+
+ @return The next code point in the input stream as a `UTF32Char`. Returns `EOF` if the stream is fully consumed.
+ */
 - (UTF32Char)consumeNextInputCharacter;
+
+/**
+ Causes the next input character to return the current input character.
+ */
 - (void)reconsumeCurrentInputCharacter;
+
+/** @brief Unconsumes the current input character. */
 - (void)unconsumeCurrentInputCharacter;
 
+/**
+ Consumes the given character at the current location.
+ 
+ @param character The character to consume.
+ @return YES if the given character was consumed at the current location, NO otherwise.
+ */
 - (BOOL)consumeCharacter:(UTF32Char)character;
+
+/**
+ Consumes characters at the current location matching an unsigned number.
+
+ @param result Upon return, contains the consumed unsigned number. Pass `NULL` to skip over an unsigned number at the
+ current location.
+ @return YES if an unsigned number could be consumed at the current location, NO otherwise.
+ */
 - (BOOL)consumeNumber:(unsigned long long *)result;
+
+/**
+ Consumes characters at the current location matching a decimal number.
+
+ @param result Upon return, contains the consumed decimal number. Pass `NULL` to skip over a decimal number at the
+ current location.
+ @return YES if a decimal number could be consumed at the current location, NO otherwise.
+ */
+- (BOOL)consumeDecimalNumber:(NSDecimal *)result;
+
+/**
+ Consumes characters at the current location matching a hexadecimal number.
+
+ @param result Upon return, contains the consumed hexadecimal number. Pass `NULL` to skip over a hexadecimal number at 
+ the current location.
+ @return YES if a hexadecimal number could be consumed at the current location, NO otherwise.
+ */
 - (BOOL)consumeHexNumber:(unsigned long long *)result;
+
+/**
+ Consumes the given string at the current location.
+
+ @param string The string to consume.
+ @param caseSensitive YES if the string's case should be ignored, NO otherwise
+ @return YES if the given string was consumed at the current location, NO otherwise.
+ */
 - (BOOL)consumeString:(NSString *)string caseSensitive:(BOOL)caseSensitive;
+
+/**
+ Consumes characters starting at the current location until any character in a given string is encountered.
+
+ @param characters The string containing the characters to consume up to.
+ @return A string containing the consumed characters. Returns `nil` if none were consumed.
+ */
 - (NSString *)consumeCharactersUpToCharactersInString:(NSString *)characters;
+
+/**
+ Consumes characters starting at the current location until a given string is encountered.
+
+ @param string The string to consume up to.
+ @return A string containing the consumed characters. Returns `nil` if none were consumed.
+ */
 - (NSString *)consumeCharactersUpToString:(NSString *)string;
+
+/**
+ Consumes characters as long as the match the characters in the given string starting at the current location.
+
+ @param characters A string with the characters to consume.
+ @return A string containing the consumed characters. Returns `nil` if none were found.
+ */
+- (NSString *)consumeCharactersInString:(NSString *)characters;
+
+/**
+ Consumes alphanumeric characters starting at the current location.
+
+ @return A string containing the consumed alphanumeric characters. Returns `nil` if none were found.
+ */
 - (NSString *)consumeAlphanumericCharacters;
 
+/** @brief Marks the current stream scan location. */
 - (void)markCurrentLocation;
+
+/** @brief Resets the stream's scan location to the previously marked location. */
 - (void)rewindToMarkedLocation;
+
+/** @brief Resets the stream to its begining. */
 - (void)reset;
 
 @end

HTMLKit/HTMLInputStreamReader.m

@@ -8,6 +8,7 @@
 
 #import "HTMLInputStreamReader.h"
 #import "HTMLTokenizerCharacters.h"
+#import "NSCharacterSet+HTMLKit.h"
 
 #pragma mark - HTMLInputStreamReader
 
@@ -39,6 +40,7 @@
 	if (self) {
 		_string = [string copy];
 		_scanner = [[NSScanner alloc] initWithString:string];
+		_scanner.charactersToBeSkipped = nil;
 		CFStringInitInlineBuffer((CFStringRef)_string, &_buffer, CFRangeMake(0, _string.length));
 	}
 	return self;
@@ -63,7 +65,6 @@
 - (UTF32Char)nextInputCharacter
 {
 	if (_reconsume) {
-		_reconsume = NO;
 		return _currentInputCharacter;
 	}
 
@@ -81,7 +82,7 @@
 		return LINE_FEED;
 	}
 	if (CFStringIsSurrogateLowCharacter(nextInputCharacter)) {
-		NSString *reason = [NSString stringWithFormat:@"Non-Unicode character found (an isolated low surrogate: 0x%X)", nextInputCharacter];
+		NSString *reason = [NSString stringWithFormat:@"Non-Unicode character found (an isolated low surrogate: 0x%X)", (unsigned int)nextInputCharacter];
 		[self emitParseError:reason];
 		return nextInputCharacter;
 	}
@@ -89,7 +90,7 @@
 	if (CFStringIsSurrogateHighCharacter(nextInputCharacter)) {
 		UniChar surrogateLow = CFStringGetCharacterFromInlineBuffer(&_buffer, _location + 1);
 		if (CFStringIsSurrogateLowCharacter(surrogateLow) == NO) {
-			NSString *reason = [NSString stringWithFormat:@"Non-Unicode character found (an isolated high surrogate: 0x%X)", nextInputCharacter];
+			NSString *reason = [NSString stringWithFormat:@"Non-Unicode character found (an isolated high surrogate: 0x%X)", (unsigned int)nextInputCharacter];
 			[self emitParseError:reason];
 			return nextInputCharacter;
 		}
@@ -99,13 +100,18 @@
 	}
 
 	if (isControlOrUndefinedCharacter(nextInputCharacter)) {
-		NSString *reason = [NSString stringWithFormat:@"A control/undefined character found: (0x%X)", nextInputCharacter];
+		NSString *reason = [NSString stringWithFormat:@"A control/undefined character found: (0x%X)", (unsigned int)nextInputCharacter];
 		[self emitParseError:reason];
 	}
 
 	return nextInputCharacter;
 }
 
+- (UTF32Char)inputCharacterPointAtOffset:(NSUInteger)offset
+{
+	return CFStringGetCharacterFromInlineBuffer(&_buffer, _location + offset);
+}
+
 - (UTF32Char)consumeNextInputCharacter
 {
 	if (_reconsume) {
@@ -124,9 +130,12 @@
 {
 	UTF32Char nextInputCharacter = [self nextInputCharacter];
 	if (nextInputCharacter == character) {
-		_location += _consume;
-		_scanner.scanLocation = _location;
-		_currentInputCharacter = nextInputCharacter;
+		if (!_reconsume) {
+			_location += _consume;
+			_scanner.scanLocation = _location;
+			_currentInputCharacter = nextInputCharacter;
+		}
+		_reconsume = NO;
 		return YES;
 	}
 	return NO;
@@ -143,9 +152,20 @@
 	return success;
 }
 
+- (BOOL)consumeDecimalNumber:(NSDecimal *)result
+{
+	NSDecimal scanned;
+	BOOL success = [_scanner scanDecimal:&scanned];
+	if (success == NO) return NO;
+
+	*result = scanned;
+	_location = _scanner.scanLocation;
+	return success;
+}
+
 - (BOOL)consumeHexNumber:(unsigned long long *)result
 {
-	NSCharacterSet *set = [NSCharacterSet characterSetWithCharactersInString:@"0123456789ABCDEFabcdef"];
+	NSCharacterSet *set = [NSCharacterSet HTMLHexNumberCharacterSet];
 
 	NSString *string = nil;
 	BOOL success = [_scanner scanCharactersFromSet:set intoString:&string];
@@ -193,6 +213,26 @@
 	return consumed;
 }
 
+- (NSString *)consumeCharactersInString:(NSString *)characters
+{
+	NSCharacterSet *set = [NSCharacterSet characterSetWithCharactersInString:characters];
+
+	if (_reconsume) {
+		_scanner.scanLocation--;
+	}
+
+	NSString *string = nil;
+	BOOL success = [_scanner scanCharactersFromSet:set intoString:&string];
+	if (success == NO) {
+		_scanner.scanLocation++;
+		return nil;
+	}
+
+	_reconsume = NO;
+	_location = _scanner.scanLocation;
+	return string;
+}
+
 - (NSString *)consumeAlphanumericCharacters
 {
 	NSCharacterSet *set = [NSCharacterSet alphanumericCharacterSet];

HTMLKit/HTMLKit-Info.plist

@@ -9,7 +9,7 @@
 	<key>CFBundleIconFile</key>
 	<string></string>
 	<key>CFBundleIdentifier</key>
-	<string>com.braincookie.${PRODUCT_NAME:rfc1034identifier}</string>
+	<string>$(PRODUCT_BUNDLE_IDENTIFIER)</string>
 	<key>CFBundleInfoDictionaryVersion</key>
 	<string>6.0</string>
 	<key>CFBundleName</key>
@@ -17,7 +17,7 @@
 	<key>CFBundlePackageType</key>
 	<string>FMWK</string>
 	<key>CFBundleShortVersionString</key>
-	<string>1.0</string>
+	<string>0.9.3</string>
 	<key>CFBundleSignature</key>
 	<string>????</string>
 	<key>CFBundleVersion</key>

HTMLKit/HTMLKit.h

@@ -8,6 +8,20 @@
 
 #import <Foundation/Foundation.h>
 
-@interface HTMLKit : NSObject
+//! Project version number for HTMLKit.
+extern double HTMLKitVersionNumber;
 
-@end
+//! Project version string for HTMLKit.
+extern const unsigned char HTMLKitVersionString[];
+
+#import "HTMLDOM.h"
+#import "HTMLParser.h"
+#import "HTMLKitErrorDomain.h"
+#import "HTMLOrderedDictionary.h"
+
+#import "CSSSelectors.h"
+#import "CSSSelectorParser.h"
+#import "CSSNthExpressionParser.h"
+
+#import "NSString+HTMLKit.h"
+#import "NSCharacterSet+HTMLKit.h"

HTMLKit/HTMLKit.m

@@ -1,13 +0,0 @@
-//
-//  HTMLKit.m
-//  HTMLKit
-//
-//  Created by Iska on 15/09/14.
-//  Copyright (c) 2014 BrainCookie. All rights reserved.
-//
-
-#import "HTMLKit.h"
-
-@implementation HTMLKit
-
-@end

HTMLKit/HTMLKitDOMExceptions.h

@@ -0,0 +1,14 @@
+//
+//  HTMLKitExceptions.h
+//  HTMLKit
+//
+//  Created by Iska on 17/03/15.
+//  Copyright (c) 2015 BrainCookie. All rights reserved.
+//
+
+extern NSString * const HTMLKitHierarchyRequestError;
+extern NSString * const HTMLKitNotFoundError;
+extern NSString * const HTMLKitNotSupportedError;
+
+extern NSString * const HTMLKitSyntaxError;
+extern NSString * const HTMLKitInvalidCharacterError;

HTMLKit/HTMLKitDOMExceptions.m

@@ -6,8 +6,10 @@
 //  Copyright (c) 2015 BrainCookie. All rights reserved.
 //
 
-#import "HTMLKitExceptions.h"
+#import "HTMLKitDOMExceptions.h"
 
 NSString * const HTMLKitHierarchyRequestError = @"HierarchyRequestError";
 NSString * const HTMLKitNotFoundError = @"NotFoundError";
 NSString * const HTMLKitNotSupportedError = @"NotSupportedError";
+NSString * const HTMLKitSyntaxError = @"SyntaxError";
+NSString * const HTMLKitInvalidCharacterError = @"InvalidCharacterError";

HTMLKit/HTMLKitErrorDomain.h

@@ -0,0 +1,23 @@
+//
+//  HTMLKitErrorDomain.h
+//  HTMLKit
+//
+//  Created by Iska on 24/11/15.
+//  Copyright © 2015 BrainCookie. All rights reserved.
+//
+
+#ifndef HTMLKitErrorDomain_h
+#define HTMLKitErrorDomain_h
+
+static NSString *const HTMLKitErrorDomain = @"HTMLKit";
+static NSString *const HTMLKitSelectorErrorDomain = @"HTMLKitSelector";
+
+static NSString *const CSSSelectorStringKey = @"CSSSelectorString";
+static NSString *const CSSSelectorErrorLocationKey = @"CSSSelectorErrorLocation";
+
+NS_ENUM(NSInteger)
+{
+	HTMLKitSelectorParseError = 4200
+};
+
+#endif /* HTMLKitErrorDomain_h */

HTMLKit/HTMLKitExceptions.h

@@ -1,11 +0,0 @@
-//
-//  HTMLKitExceptions.h
-//  HTMLKit
-//
-//  Created by Iska on 17/03/15.
-//  Copyright (c) 2015 BrainCookie. All rights reserved.
-//
-
-FOUNDATION_EXPORT NSString * const HTMLKitHierarchyRequestError;
-FOUNDATION_EXPORT NSString * const HTMLKitNotFoundError;
-FOUNDATION_EXPORT NSString * const HTMLKitNotSupportedError;

HTMLKit/HTMLListOfActiveFormattingElements.h

@@ -6,33 +6,134 @@
 //  Copyright (c) 2015 BrainCookie. All rights reserved.
 //
 
+///------------------------------------------------------
+/// HTMLKit private header
+///------------------------------------------------------
+
 #import <Foundation/Foundation.h>
 #import "HTMLElement.h"
 
+/**
+ The List of Active Formatting Elements. It is used to handle mis-nested formatting element tags.
+ 
+ https://html.spec.whatwg.org/multipage/syntax.html#the-list-of-active-formatting-elements
+ */
 @interface HTMLListOfActiveFormattingElements : NSObject
 
+/**
+ Returns the object at the specified index.
+
+ @param index An index within the bounds of the list.
+ @return The node located at index.
+ */
 - (id)objectAtIndexedSubscript:(NSUInteger)index;
+
+/**
+ Replaces the object at the index with the new object.
+
+ @param obj The node with which to replace the object at given index in the list.
+ @param idx The index of the object to be replaced.
+ */
 - (void)setObject:(id)obj atIndexedSubscript:(NSUInteger)idx;
+
+/**
+ Returns the index of the given node in the list.
+
+ @param node The node.
+ @return The index of the given node in the list.
+ */
 - (NSUInteger)indexOfElement:(id)node;
 
+/**
+ Adds the given element to the list.
+ 
+ @param element The element to add.
+ */
 - (void)addElement:(HTMLElement *)element;
+
+/**
+ Removes the given element from the list.
+
+ @param element The element to remove.
+ */
 - (void)removeElement:(id)element;
+
+/**
+ Checks whether the given element is in the list.
+
+ @param element The element to check.
+ @return `YES` if element is in the list, `NO` otherwise.
+ */
 - (BOOL)containsElement:(id)element;
 
+/**
+ Inserts the given element at the index into the list.
+
+ @param element The element to insert.
+ @param index The index at which the element should be inserted.
+ */
 - (void)insertElement:(HTMLElement *)element atIndex:(NSUInteger)index;
+
+/**
+ Replaces the element at the given index in the list with the new element.
+
+ @param index The index of the element to be replaced.
+ @param element The element with which to replace the element at given index in the list.
+ */
 - (void)replaceElementAtIndex:(NSUInteger)index withElement:(HTMLElement *)element;
 
+/**
+ Returns the last element in this list.
+ 
+ @return The last entry.
+ */
 - (id)lastEntry;
 
+/**
+ Adds a marker to the end of this list
+ */
 - (void)addMarker;
+
+/**
+ Clears all elements from the end of this list upto the last marker.
+ */
 - (void)clearUptoLastMarker;
 
+/**
+ Returns the last element in the list having the given tag name, that is between the end of the list and the last marker 
+ in the list, if any, or the start of the list otherwise.
+ 
+ @param tagName The tag name.
+ @return The formatting element.
+ */
 - (HTMLElement *)formattingElementWithTagName:(NSString *)tagName;
 
+/**
+ Returns the count of elements in this list.
+
+ @return The elements count.
+ */
 - (NSUInteger)count;
+
+/**
+ Checks whether this list is empty.
+
+ @return `YES` if the stack is empty, `NO` otherwise.
+ */
 - (BOOL)isEmpty;
 
+/**
+ Return an object enumerator over this list.
+
+ @return An enumerator
+ */
 - (NSEnumerator *)enumerator;
+
+/**
+ Return an object enumerator over this list.
+
+ @return An enumerator
+ */
 - (NSEnumerator *)reverseObjectEnumerator;
 
 @end

HTMLKit/HTMLListOfActiveFormattingElements.m

@@ -52,7 +52,7 @@
 		}
 		if (node.htmlNamespace == element.htmlNamespace &&
 			[node.tagName isEqualToString:element.tagName] &&
-			[node.attributes isEqualTo:element.attributes]) {
+			[node.attributes isEqual:element.attributes]) {
 			existing++;
 		}
 		if (existing == 3) {

HTMLKit/HTMLMarker.h

@@ -6,10 +6,22 @@
 //  Copyright (c) 2015 BrainCookie. All rights reserved.
 //
 
+///------------------------------------------------------
+/// HTMLKit private header
+///------------------------------------------------------
+
 #import <Foundation/Foundation.h>
 
+/**
+ A Maker that is used in the List of Active Formatting Elements.
+ 
+ @see HTMLListOfActiveFormattingElements
+ */
 @interface HTMLMarker : NSObject
 
+/**
+ Returns the singleton instance of the Marker.
+ */
 + (instancetype)marker;
 
 @end

HTMLKit/HTMLNamespaces.h

@@ -6,12 +6,18 @@
 //  Copyright (c) 2014 BrainCookie. All rights reserved.
 //
 
+/**
+ HTML Namespaces
+ https://html.spec.whatwg.org/multipage/infrastructure.html#namespaces
+ */
 typedef NS_ENUM(NSInteger, HTMLNamespace)
 {
+	/** The default HTML namespace. */
 	HTMLNamespaceHTML,
+
+	/** The namespace for most of the <math> elements. */
 	HTMLNamespaceMathML,
-	HTMLNamespaceSVG,
-	HTMLNamespaceXLink,
-	HTMLNamespaceXML,
-	HTMLNamespaceXMLNS,
+
+	/** The namespace for most of the <svg> elements. */
+	HTMLNamespaceSVG
 };

HTMLKit/HTMLNode+Private.h

@@ -0,0 +1,54 @@
+//
+//  HTMLNode+Private.h
+//  HTMLKit
+//
+//  Created by Iska on 20/12/15.
+//  Copyright © 2015 BrainCookie. All rights reserved.
+//
+
+///------------------------------------------------------
+/// HTMLKit private header
+///------------------------------------------------------
+
+#import <HTMLKit/HTMLKit.h>
+
+/**
+ Private HTML Node methods which are not intended for public API.
+ */
+@interface HTMLNode ()
+
+/**
+ A read-write redeclaration of the same property in the public API.
+ */
+@property (nonatomic, weak) HTMLDocument *ownerDocument;
+
+/**
+ A read-write redeclaration of the same property in the public API.
+ */
+@property (nonatomic, weak) HTMLNode *parentNode;
+
+/**
+ Designated initializer of the HTML Node, which, however, should not be used directly. It is intended to be called only 
+ by subclasses.
+
+ @abstract Use concrete subclasses of the HTML Node.
+ 
+ @param name The node's name.
+ @param type The node's type.
+ @return A new instance of a HTML Node.
+ */
+- (instancetype)initWithName:(NSString *)name type:(HTMLNodeType)type NS_DESIGNATED_INITIALIZER;
+
+/**
+ Casts this node to a HTML Element. This cast should only be performed after the appropriate check.
+ */
+- (HTMLElement *)asElement;
+
+/**
+ Returns the same string representation of the DOM tree rooted at this node that is used by html5lib-tests.
+ 
+ @disucssion This method is indended for testing purposes.
+ */
+- (NSString *)treeDescription;
+
+@end

HTMLKit/HTMLNode.h

@@ -7,92 +7,420 @@
 //
 
 #import <Foundation/Foundation.h>
+#import "HTMLNodeIterator.h"
 
+NS_ASSUME_NONNULL_BEGIN
+
+/**
+ The HTML node type
+ */
 typedef NS_ENUM(short, HTMLNodeType)
 {
 	HTMLNodeElement = 1,
-	HTMLNodeAttribute = 2, // historical
 	HTMLNodeText = 3,
-	HTMLNodeCDATASection = 4, // historical
-	HTMLNodeEntityReference = 5, // historical
-	HTMLNodeEntity = 6, // historical
 	HTMLNodeProcessingInstruction = 7,
 	HTMLNodeComment = 8,
 	HTMLNodeDocument = 9,
 	HTMLNodeDocumentType = 10,
 	HTMLNodeDocumentFragment = 11,
-	HTMLNodeNotation = 12 // historical
+};
+
+/**
+ A node's position in the HTML document when compared with other nodes.
+ */
+typedef NS_ENUM(unsigned short, HTMLDocumentPosition)
+{
+	HTMLDocumentPositionEquivalent = 0x0,
+	HTMLDocumentPositionDisconnected = 0x01,
+	HTMLDocumentPositionPreceding = 0x02,
+	HTMLDocumentPositionFollowing = 0x04,
+	HTMLDocumentPositionContains = 0x08,
+	HTMLDocumentPositionContainedBy = 0x10,
+	HTMLDocumentPositionImplementationSpecific = 0x20
 };
 
 @class HTMLDocument;
 @class HTMLElement;
+@class CSSSelector;
 
+/**
+ A HTML Node, the base class for all HTML DOM entities.
+
+ HTMLKit provides a partial implementation of the WHATWG DOM specification: https://dom.spec.whatwg.org/
+ */
 @interface HTMLNode : NSObject <NSCopying>
 
-@property (nonatomic, assign, readonly) HTMLNodeType type;
+/**
+ The node type.
 
+ @see HTMLNodeType
+ */
+@property (nonatomic, assign, readonly) HTMLNodeType nodeType;
+
+/** 
+ The node name as described in https://dom.spec.whatwg.org/#dom-node-nodename
+
+ @warning This is not the HTML Element tag name.
+ */
 @property (nonatomic, strong, readonly) NSString *name;
 
-@property (nonatomic, weak, readonly) HTMLDocument *ownerDocument;
+/**
+ The owner document of this node. 
 
-@property (nonatomic, strong, readonly) NSString *baseURI;
+ @see HTMLDocument
+ */
+@property (nonatomic, weak, readonly, nullable) HTMLDocument *ownerDocument;
 
-@property (nonatomic, weak, readonly) HTMLNode *parentNode;
+/**
+ The parent node of this node, if any.
+ */
+@property (nonatomic, weak, readonly, nullable) HTMLNode *parentNode;
 
-@property (nonatomic, weak, readonly) HTMLElement *parentElement;
+/**
+ The parent element of this node, if any.
 
+ @discussion This property returns nil if the parent is a non-element node.
+ */
+@property (nonatomic, weak, readonly, nullable) HTMLElement *parentElement;
+
+/**
+ A read-only ordered set of child nodes.
+ */
 @property (nonatomic, strong, readonly) NSOrderedSet *childNodes;
 
-@property (nonatomic, strong, readonly) HTMLNode *firstChiledNode;
+/**
+ The first child node, if any.
+ */
+@property (nonatomic, strong, readonly, nullable) HTMLNode *firstChild;
 
-@property (nonatomic, strong, readonly) HTMLNode *lastChildNode;
+/**
+ The last child node, if any.
+ */
+@property (nonatomic, strong, readonly, nullable) HTMLNode *lastChild;
 
-@property (nonatomic, strong, readonly) HTMLNode *previousSibling;
+/**
+ The previous sibling node in the document, if any.
+ */
+@property (nonatomic, strong, readonly, nullable) HTMLNode *previousSibling;
 
-@property (nonatomic, strong, readonly) HTMLNode *nextSibling;
+/**
+ The next sibling node in the document, if any.
+ */
+@property (nonatomic, strong, readonly, nullable) HTMLNode *nextSibling;
 
+/**
+ The previous sibling element in the document, if any.
+
+ @discussion Previous non-element nodes will be skipped till an element is found.
+ */
+@property (nonatomic, strong, readonly, nullable) HTMLElement *previousSiblingElement;
+
+/**
+ The next sibling element in the document, if any.
+
+ @discussion Next non-element nodes will be skipped till an element is found.
+ */
+@property (nonatomic, strong, readonly, nullable) HTMLElement *nextSiblingElement;
+
+/**
+ The text content of this node.
+ */
 @property (nonatomic, copy) NSString *textContent;
 
-- (instancetype)initWithName:(NSString *)name type:(HTMLNodeType)type;
+/**
+ The outer HTML string.
+ */
+@property (nonatomic, strong, readonly)	NSString *outerHTML;
 
+/**
+ The inner HTML string.
+ */
+@property (nonatomic, copy)	NSString *innerHTML;
+
+/**
+ @abstract Use concrete subclasses of the HTML Node.
+ */
+- (instancetype)init NS_UNAVAILABLE;
+
+/**
+ Checks whether this node has child nodes.
+ 
+ @return `YES` if this node has any children, `NO` otherwise.
+ */
 - (BOOL)hasChildNodes;
 
+/**
+ Checks whether this node has child nodes of the given type.
+
+ @param type The type to check.
+ @return `YES` if this node has any children of the given type, `NO` otherwise.
+ */
 - (BOOL)hasChildNodeOfType:(HTMLNodeType)type;
 
+/**
+ Returns the cound of child nodes.
+
+ @return The child nodes count.
+ */
 - (NSUInteger)childNodesCount;
 
+/**
+ Returns the child node at a given index.
+
+ @param index The index at which to return the child node.
+ @return The child node at a index. If index is greater than or equal to the value returned by count, an 
+ NSRangeException is raised.
+ */
 - (HTMLNode *)childNodeAtIndex:(NSUInteger)index;
 
+/**
+ Returns the index of the given child node in the set of child nodes.
+
+ @param node The node.
+ @return The index of the given node in the children set.
+ */
 - (NSUInteger)indexOfChildNode:(HTMLNode *)node;
 
-- (HTMLNode *)insertNode:(HTMLNode *)node beforeChildNode:(HTMLNode *)child;
+/**
+ Returns the cound of child elements.
 
+ @discussion This method count only nodes of type HTMLNodeElement.
+
+ @return The child elements count.
+ */
+- (NSUInteger)childElementsCount;
+
+/**
+ Returns the child element at a given index.
+
+ @param index The index at which to return the child element.
+ @return The child element at a index. If index is greater than or equal to the value returned by count, an
+ NSRangeException is raised.
+ */
+- (HTMLElement *)childElementAtIndex:(NSUInteger)index;
+
+/**
+ Returns the index of the given child element in the set of child nodes.
+
+ @param node The element.
+ @return The index of the given element in the children set.
+ */
+- (NSUInteger)indexOfChildElement:(HTMLElement *)element;
+
+/**
+ Prepends the given node to the set of child nodes.
+
+ @param node The node to prepend.
+ @return The node being prepended.
+ */
+- (HTMLNode *)prependNode:(HTMLNode *)node;
+
+/**
+ Prepends the given array of nodes to the set of child nodes.
+
+ @param node The nodes to prepend.
+ */
+- (void)prependNodes:(NSArray *)nodes;
+
+/**
+ Appends the given node to the set of child nodes.
+
+ @param node The node to append.
+ @return The node being appended.
+ */
 - (HTMLNode *)appendNode:(HTMLNode *)node;
 
+/**
+ Appends the given array of nodes to the set of child nodes.
+
+ @param nodes The nodes to append.
+ */
 - (void)appendNodes:(NSArray *)nodes;
 
-- (HTMLNode *)replaceChildNode:(HTMLNode *)node withNode:(HTMLNode *)replacement;
+/**
+ Inserts a given node before a child node.
+ 
+ @param node The node to insert.
+ @param child A reference child node before which the new node should be inserted. If child is `nil` then the new node
+ will be inserted as the last child node.
+ @return The node being inserted.
+ */
+- (HTMLNode *)insertNode:(HTMLNode *)node beforeChildNode:(nullable HTMLNode *)child;
 
+/**
+ Replaces a given child node whith new node.
+
+ @param child The child node to replace.
+ @param replacement The replacement node.
+ @return The replacement node.
+ */
+- (HTMLNode *)replaceChildNode:(HTMLNode *)child withNode:(HTMLNode *)replacement;
+
+/**
+ Replaces all child nodes with the given node.
+ 
+ @param node The node which will replace all child nodes.
+ */
 - (void)replaceAllChildNodesWithNode:(HTMLNode *)node;
 
+/**
+ Removes this node from its parent.
+
+ @discussion This will detach the node from its parent and in turn from its previous document.
+ */
+- (void)removeFromParentNode;
+
+/**
+ Removes the given child node from children.
+
+ @param node The node to remove.
+ */
 - (HTMLNode *)removeChildNode:(HTMLNode *)node;
 
+/**
+ Removes the child node at index from children.
+
+ @param index The index of the node to remove.
+ */
 - (HTMLNode *)removeChildNodeAtIndex:(NSUInteger)index;
 
+/**
+ Changes children ownership from this node to the given node.
+ 
+ @discussion Running this method will append all children of this node to the given node. This node will have no children
+ afterwards.
+
+ @param node The node which will reparent children of this node.
+ */
 - (void)reparentChildNodesIntoNode:(HTMLNode *)node;
 
+/**
+ Removes all child nodes.
+ */
 - (void)removeAllChildNodes;
 
+/**
+ Compares the position of this node with the given node in the document.
+
+ @param node The node with which to comapre the position.
+ @return The HTMLDocumentPosition of this node in relation to the given node.
+
+ @see HTMLDocumentPosition
+ */
+- (HTMLDocumentPosition)compareDocumentPositionWithNode:(HTMLNode *)node;
+
+/**
+ Checks whether this node is descendant of the given node.
+ 
+ @param node The node to check.
+ @return `YES` if this node is descendant of the gicen node, `NO` otherwsie.
+ */
+- (BOOL)isDescendantOfNode:(HTMLNode *)node;
+
+/**
+ Checks whether this node contains the given node.
+
+ @param node The node to check.
+ @return `YES` if this node contains the given node, `NO` otherwsie.
+ */
+- (BOOL)containsNode:(HTMLNode *)node;
+
+/**
+ Enumerates and applies `block` on each child node.
+ 
+ @block The block to run for each child node.
+ */
 - (void)enumerateChildNodesUsingBlock:(void (^)(HTMLNode *node, NSUInteger idx, BOOL *stop))block;
 
-- (NSEnumerator *)treeEnumerator;
+/**
+ Enumerates and applies `block` on each child element.
 
-- (NSEnumerator *)reverseTreeEnumerator;
+ @discussion This method only enumerates child elements.
 
-- (NSString *)outerHTML;
+ @block The block to run for each child element.
+ */
+- (void)enumerateChildElementsUsingBlock:(void (^)(HTMLElement *element, NSUInteger idx, BOOL *stop))block;
 
-- (NSString *)innerHTML;
+/**
+ Returns a node iterator rooted at this node whith no filter and HTMLNodeFilterShowAll.
 
-- (NSString *)treeDescription;
+ @return A new node iterator whose root is this node.
+
+ @see HTMLNodeIterator
+ @see HTMLNodeFilterShowOptions
+ */
+- (HTMLNodeIterator	*)nodeIterator;
+
+/**
+ Returns a node iterator rooted at this node.
+
+ @param showOptions The iterator's show options.
+ @param filter The iterator's filter.
+ @return A new node iterator whose root is this node.
+
+ @see HTMLNodeIterator
+ @see HTMLNodeFilterShowOptions
+ */
+- (HTMLNodeIterator *)nodeIteratorWithShowOptions:(HTMLNodeFilterShowOptions)showOptions
+										   filter:(nullable id<HTMLNodeFilter>)filter;
+
+/**
+ Returns a node iterator rooted at this node.
+
+ @param showOptions The iterator's show options.
+ @param filter The iterator's filter block.
+ @return A new node iterator whose root is this node.
+
+ @see HTMLNodeIterator
+ @see HTMLNodeFilterShowOptions
+ */
+- (HTMLNodeIterator *)nodeIteratorWithShowOptions:(HTMLNodeFilterShowOptions)showOptions
+									  filterBlock:(HTMLNodeFilterValue (^)(HTMLNode *node))filter;
+
+/**
+ Returns the first element in the DOM tree rooted at this node, that is matched by the given selector string.
+ 
+ @param selector The CSS seletor string.
+ @return The first element that is matched by the parsed selector. Rerturns `nil` if the selector could not be parsed
+ or no element was matched.
+
+ @see firstElementMatchingSelector:
+ @see CSSSelector
+ */
+- (nullable HTMLElement *)querySelector:(NSString *)selector;
+
+/**
+ Returns all elements in the DOM tree rooted at this node, that are matched by the given selector string.
+
+ @param selector The CSS seletor string.
+ @return The elements that are matched by the parsed selector. Rerturns an empty array if the selector could not be parsed
+ or no elements were matched.
+
+ @see elementsMatchingSelector:
+ @see CSSSelector
+ */
+- (NSArray<HTMLElement *> *)querySelectorAll:(NSString *)selector;
+
+/**
+ Returns the first element in the DOM tree rooted at this node, that is matched by the given selector.
+
+ @param selector The CSS seletor.
+ @return The first element that is matched by the parsed selector. Rerturns `nil` if no element was matched.
+
+ @see CSSSelector
+ */
+- (nullable HTMLElement *)firstElementMatchingSelector:(CSSSelector *)selector;
+
+/**
+ Returns all elements in the DOM tree rooted at this node, that are matched by the given selector.
+
+ @param selector The CSS seletor.
+ @return The elements that are matched by the parsed selector. Rerturns an empty array if no elements were matched.
+
+ @see CSSSelector
+ */
+- (NSArray<HTMLElement *> *)elementsMatchingSelector:(CSSSelector *)selector;
 
 @end
+
+NS_ASSUME_NONNULL_END

HTMLKit/HTMLNode.m

@@ -7,19 +7,26 @@
 //
 
 #import "HTMLNode.h"
+#import "HTMLNode+Private.h"
 #import "HTMLDocument.h"
 #import "HTMLDocumentType.h"
 #import "HTMLElement.h"
 #import "HTMLText.h"
 #import "HTMLComment.h"
-#import "HTMLKitExceptions.h"
-#import "HTMLNodeTreeEnumerator.h"
+#import "HTMLKitDOMExceptions.h"
+#import "HTMLNodeFilter.h"
+#import "CSSSelector.h"
+
+@interface HTMLDocument (Private)
+- (void)runRemovingStepsForNode:(HTMLNode *)oldNode
+				  withOldParent:(HTMLNode *)oldParent
+		  andOldPreviousSibling:(HTMLNode *)oldPreviousSibling;
+@end
 
 @interface HTMLNode ()
 {
 	NSMutableOrderedSet *_childNodes;
 }
-@property (nonatomic, weak) HTMLDocument *ownerDocument;
 @end
 
 @implementation HTMLNode
@@ -32,7 +39,7 @@
 	self = [super init];
 	if (self) {
 		_name = name;
-		_type = type;
+		_nodeType = type;
 		_childNodes = [NSMutableOrderedSet new];
 	}
 	return self;
@@ -42,7 +49,7 @@
 
 - (HTMLDocument *)ownerDocument
 {
-	if (_type == HTMLNodeDocument) {
+	if (_nodeType == HTMLNodeDocument) {
 		return (HTMLDocument *)self;
 	} else {
 		return _ownerDocument;
@@ -55,12 +62,6 @@
 	[self.childNodes.array makeObjectsPerformSelector:@selector(setOwnerDocument:) withObject:ownerDocument];
 }
 
-- (void)setBaseURI:(NSString *)baseURI
-{
-	_baseURI = [baseURI copy];
-	[self.childNodes.array makeObjectsPerformSelector:@selector(setBaseURI:) withObject:baseURI];
-}
-
 - (void)setParentNode:(HTMLNode *)parentNode
 {
 	_parentNode = parentNode;
@@ -68,15 +69,15 @@
 
 - (HTMLElement *)parentElement
 {
-	return _parentNode.type == HTMLNodeElement ? (HTMLElement *)_parentNode : nil;
+	return _parentNode.nodeType == HTMLNodeElement ? (HTMLElement *)_parentNode : nil;
 }
 
-- (HTMLNode *)firstChiledNode
+- (HTMLNode *)firstChild
 {
 	return self.childNodes.firstObject;
 }
 
-- (HTMLNode *)lastChildNode
+- (HTMLNode *)lastChild
 {
 	return self.childNodes.lastObject;
 }
@@ -99,11 +100,36 @@
 	return [_parentNode childNodeAtIndex:index + 1];
 }
 
+- (HTMLElement *)previousSiblingElement
+{
+	HTMLNode *node = self.previousSibling;
+	while (node && node.nodeType != HTMLNodeElement) {
+		node = node.previousSibling;
+	}
+	return node.asElement;
+}
+
+- (HTMLElement *)nextSiblingElement
+{
+	HTMLNode *node = self.previousSibling;
+	while (node && node.nodeType != HTMLNodeElement) {
+		node = node.nextSibling;
+	}
+	return node.asElement;
+}
+
 - (NSString *)textContent
 {
 	return nil;
 }
 
+#pragma mark - Cast
+
+- (HTMLElement *)asElement
+{
+	return (HTMLElement *)self;
+}
+
 #pragma mark - Child Nodes
 
 - (BOOL)hasChildNodes
@@ -114,7 +140,7 @@
 - (BOOL)hasChildNodeOfType:(HTMLNodeType)type
 {
 	NSUInteger index = [self.childNodes indexOfObjectPassingTest:^BOOL(id obj, NSUInteger idx, BOOL *stop) {
-		if ([(HTMLNode *)obj type] == type) {
+		if ([(HTMLNode *)obj nodeType] == type) {
 			*stop = YES;
 			return YES;
 		}
@@ -134,40 +160,105 @@
 	return [self.childNodes objectAtIndex:index];
 }
 
+- (NSUInteger)childElementsCount
+{
+	return [self.childNodes indexesOfObjectsPassingTest:^BOOL(HTMLNode *  _Nonnull node, NSUInteger idx, BOOL * _Nonnull stop) {
+		return node.nodeType == HTMLNodeElement;
+	}].count;
+}
+
 - (NSUInteger)indexOfChildNode:(HTMLNode *)node
 {
 	return [self.childNodes indexOfObject:node];
 }
 
-- (HTMLNode *)insertNode:(HTMLNode *)node beforeChildNode:(HTMLNode *)child
+- (HTMLElement *)childElementAtIndex:(NSUInteger)index
 {
-	node = [self preInsertNode:node beforeChildNode:child];
-	node.parentNode = self;
-	return node;
+	NSUInteger counter = 0;
+	for (HTMLNode *node in self.childNodes) {
+		if (node.nodeType == HTMLNodeElement) {
+			if (counter == index) {
+				return node.asElement;
+			}
+			counter++;
+		}
+	}
+	return nil;
+}
+
+- (NSUInteger)indexOfChildElement:(HTMLElement *)element
+{
+	NSUInteger counter = 0;
+	for (HTMLNode *node in self.childNodes) {
+		if (node.nodeType == HTMLNodeElement) {
+			if (node == element) {
+				return counter;
+			}
+			counter++;
+		}
+	}
+	return NSNotFound;
+}
+
+- (HTMLNode *)prependNode:(HTMLNode *)node
+{
+	return [self insertNode:node beforeChildNode:self.firstChild];
+}
+
+- (void)prependNodes:(NSArray *)nodes
+{
+	for (id node in nodes.reverseObjectEnumerator) {
+		[self insertNode:node beforeChildNode:self.firstChild];
+	}
 }
 
 - (HTMLNode *)appendNode:(HTMLNode *)node
 {
-	node = [self preInsertNode:node beforeChildNode:nil];
-	node.parentNode = self;
-	return node;
+	return [self insertNode:node beforeChildNode:nil];
 }
 
 - (void)appendNodes:(NSArray *)nodes
 {
 	for (id node in nodes) {
-		[self appendNode:node];
+		[self insertNode:node beforeChildNode:nil];
 	}
 }
 
+- (HTMLNode *)insertNode:(HTMLNode *)node beforeChildNode:(HTMLNode *)child
+{
+#ifndef HTMLKIT_NO_DOM_CHECKS
+	[self ensurePreInsertionValidityOfNode:node beforeChildNode:child];
+#endif
+
+	[self.ownerDocument adoptNode:node];
+
+	NSArray *nodes = node.nodeType == HTMLNodeDocumentFragment ? [NSArray arrayWithArray:node.childNodes.array] : @[node];
+
+	NSUInteger index = [self indexOfChildNode:child];
+	if (index != NSNotFound) {
+		NSIndexSet *indexes = [NSIndexSet indexSetWithIndexesInRange:NSMakeRange(index, nodes.count)];
+		[(NSMutableOrderedSet *)self.childNodes insertObjects:nodes atIndexes:indexes];
+	} else {
+		[(NSMutableOrderedSet *)self.childNodes addObjectsFromArray:nodes];
+	}
+
+	if (node.nodeType == HTMLNodeDocumentFragment) {
+		[node removeAllChildNodes];
+	}
+
+	[nodes makeObjectsPerformSelector:@selector(setParentNode:) withObject:self];
+
+	return node;
+}
+
 - (HTMLNode *)replaceChildNode:(HTMLNode *)child withNode:(HTMLNode *)node
 {
+#ifndef HTMLKIT_NO_DOM_CHECKS
 	[self ensureReplacementValidityOfChildNode:child withNode:node];
+#endif
 
-	[self.ownerDocument adoptNode:node];
-	NSUInteger index = [self indexOfChildNode:child];
-	node.parentNode = self;
-	[(NSMutableOrderedSet *)self.childNodes replaceObjectAtIndex:index withObject:node];
+	[self insertNode:node beforeChildNode:child];
+	[child removeFromParentNode];
 	return child;
 }
 
@@ -181,6 +272,11 @@
 	}
 }
 
+- (void)removeFromParentNode
+{
+	[self.parentNode removeChildNode:self];
+}
+
 - (HTMLNode *)removeChildNode:(HTMLNode *)child
 {
 	if (child.parentNode != self) {
@@ -189,8 +285,16 @@
 		 NSStringFromSelector(_cmd), child];
 	}
 
+	HTMLNode *oldNode = child;
+	HTMLNode *oldParent = child.parentNode;
+	HTMLNode *oldPreviousSibling = child.previousSibling;
+
 	[(NSMutableOrderedSet *)self.childNodes removeObject:child];
 	child.parentNode = nil;
+
+	[self.ownerDocument runRemovingStepsForNode:oldNode
+								  withOldParent:oldParent
+						  andOldPreviousSibling:oldPreviousSibling];
 	return child;
 }
 
@@ -205,14 +309,95 @@
 	for (HTMLNode *child in self.childNodes.array) {
 		[node appendNode:child];
 	}
-	[self removeAllChildNodes];
+	[(NSMutableOrderedSet *)self.childNodes removeAllObjects];
 }
 
 - (void)removeAllChildNodes
 {
+	[self.childNodes.array makeObjectsPerformSelector:@selector(setParentNode:) withObject:nil];
 	[(NSMutableOrderedSet *)self.childNodes removeAllObjects];
 }
 
+- (HTMLDocumentPosition)compareDocumentPositionWithNode:(HTMLNode *)otherNode
+{
+	if (otherNode == nil) {
+		return HTMLDocumentPositionDisconnected;
+	}
+
+	if (self == otherNode) {
+		return HTMLDocumentPositionEquivalent;
+	}
+
+	NSArray * (^ ancestorNodes) (HTMLNode *) = ^ NSArray * (HTMLNode *node) {
+		NSMutableArray *ancestors = [NSMutableArray array];
+		for (HTMLNode *node = self; node; node = node.parentNode) {
+			[ancestors addObject:node];
+		}
+		return ancestors;
+	};
+
+	NSArray *ancestors1 = ancestorNodes(self);
+	NSArray *ancestors2 = ancestorNodes(otherNode);
+
+	if (ancestors1.lastObject != ancestors2.lastObject) {
+		return HTMLDocumentPositionDisconnected |
+		HTMLDocumentPositionImplementationSpecific |
+		HTMLDocumentPositionFollowing;
+	}
+
+	for (NSUInteger i = MIN(ancestors1.count - 1, ancestors2.count - 1); i; --i) {
+		HTMLNode *child1 = ancestors1[i];
+		HTMLNode *child2 = ancestors2[i];
+
+		if (child1 != child2) {
+			for (HTMLNode *sibling = child1.nextSibling; sibling; sibling = sibling.nextSibling) {
+				if (sibling == child2) {
+					return HTMLDocumentPositionFollowing;
+				}
+			}
+			return HTMLDocumentPositionPreceding;
+		}
+	}
+
+	if (ancestors1.count < ancestors2.count) {
+		return HTMLDocumentPositionContainedBy | HTMLDocumentPositionFollowing;
+	} else {
+		return HTMLDocumentPositionContains | HTMLDocumentPositionPreceding;
+	}
+}
+
+- (BOOL)isDescendantOfNode:(HTMLNode *)otherNode
+{
+	if (otherNode == nil) {
+		return NO;
+	}
+
+	if (self.ownerDocument != otherNode.ownerDocument) {
+		return NO;
+	}
+
+	if (!otherNode.hasChildNodes) {
+		return NO;
+	}
+
+	if (otherNode.nodeType == HTMLNodeDocument) {
+		return self.nodeType != HTMLNodeDocument && self.ownerDocument == otherNode;
+	}
+
+	for (HTMLNode *parentNode = self.parentNode; parentNode; parentNode = parentNode.parentNode) {
+		if (parentNode == otherNode) {
+			return YES;
+		}
+	}
+
+	return NO;
+}
+
+- (BOOL)containsNode:(HTMLNode *)otherNode
+{
+	return self == otherNode || [otherNode isDescendantOfNode:self];
+}
+
 #pragma mark - Enumeration
 
 - (void)enumerateChildNodesUsingBlock:(void (^)(HTMLNode *node, NSUInteger idx, BOOL *stop))block
@@ -226,40 +411,92 @@
 	}];
 }
 
-- (NSEnumerator *)treeEnumerator
+- (void)enumerateChildElementsUsingBlock:(void (^)(HTMLElement *element, NSUInteger idx, BOOL *stop))block
 {
-	return [[HTMLNodeTreeEnumerator alloc] initWithNode:self reverse:NO];
-}
-
-- (NSEnumerator *)reverseTreeEnumerator
-{
-	return [[HTMLNodeTreeEnumerator alloc] initWithNode:self reverse:YES];
-}
-
-#pragma mark - Mutation Algorithms
-
-- (HTMLNode *)preInsertNode:(HTMLNode *)node beforeChildNode:(HTMLNode *)child
-{
-	[self ensurePreInsertionValidityOfNode:node beforeChildNode:child];
-	[self.ownerDocument adoptNode:node];
-	NSUInteger index = [self indexOfChildNode:child];
-	if (index != NSNotFound) {
-		[(NSMutableOrderedSet *)self.childNodes insertObject:node atIndex:index];
-	} else {
-		[(NSMutableOrderedSet *)self.childNodes addObject:node];
+	if (block == nil) {
+		return;
 	}
 
-	return node;
+	[self.childNodes enumerateObjectsUsingBlock:^(id obj, NSUInteger idx, BOOL *stop) {
+		if ([obj isKindOfClass:[HTMLElement class]]) {
+			block([obj asElement], idx, stop);
+		}
+	}];
 }
 
-NS_INLINE void CheckParentValid(HTMLNode *node, NSString *cmd)
+- (HTMLNodeIterator	*)nodeIterator
 {
-	if (node.type != HTMLNodeDocument &&
-		node.type != HTMLNodeDocumentFragment &&
-		node.type != HTMLNodeElement) {
+	return [self nodeIteratorWithShowOptions:HTMLNodeFilterShowAll filter:nil];
+}
+
+- (HTMLNodeIterator *)nodeIteratorWithShowOptions:(HTMLNodeFilterShowOptions)showOptions
+										   filter:(id<HTMLNodeFilter>)filter
+{
+	return [[HTMLNodeIterator alloc] initWithNode:self showOptions:showOptions filter:filter];
+}
+
+- (HTMLNodeIterator *)nodeIteratorWithShowOptions:(HTMLNodeFilterShowOptions)showOptions
+									  filterBlock:(HTMLNodeFilterValue (^)(HTMLNode *node))block
+{
+	HTMLNodeFilterBlock *filter = [HTMLNodeFilterBlock filterWithBlock:block];
+	return [[HTMLNodeIterator alloc] initWithNode:self showOptions:showOptions filter:filter];
+}
+
+#pragma mark - Selectors
+
+- (HTMLElement *)querySelector:(NSString *)selectorString
+{
+	CSSSelector *selector = [CSSSelector selectorWithString:selectorString];
+	return [self firstElementMatchingSelector:selector];
+}
+
+- (NSArray<HTMLElement *> *)querySelectorAll:(NSString *)selectorString
+{
+	CSSSelector *selector = [CSSSelector selectorWithString:selectorString];
+	return [self elementsMatchingSelector:selector];
+}
+
+- (HTMLElement *)firstElementMatchingSelector:(CSSSelector *)selector
+{
+	if (selector == nil) {
+		return nil;
+	}
+
+	for (HTMLElement *element in [self nodeIteratorWithShowOptions:HTMLNodeFilterShowElement filter:nil]) {
+		if ([selector acceptElement:element]) {
+			return element;
+		}
+	}
+	return nil;
+}
+
+- (NSArray<HTMLElement *> *)elementsMatchingSelector:(CSSSelector *)selector
+{
+	if (selector == nil) {
+		return @[];
+	}
+
+	NSMutableArray *result = [NSMutableArray array];
+	for (HTMLElement *element in [self nodeIteratorWithShowOptions:HTMLNodeFilterShowElement filter:nil]) {
+		if ([selector acceptElement:element]) {
+			[result addObject:element];
+		}
+	}
+	return result;
+}
+
+#ifndef HTMLKIT_NO_DOM_CHECKS
+
+#pragma mark - Validity Checks
+
+NS_INLINE void CheckParentValid(HTMLNode *parent, NSString *cmd)
+{
+	if (parent.nodeType != HTMLNodeDocument &&
+		parent.nodeType != HTMLNodeDocumentFragment &&
+		parent.nodeType != HTMLNodeElement) {
 		[NSException raise:HTMLKitHierarchyRequestError
 					format:@"%@: Hierarchy Request Error, inserting into %@ is not allowed. The operation would yield an incorrect node tree.",
-		 cmd, node.name];
+		 cmd, parent.name];
 	}
 }
 
@@ -275,11 +512,11 @@ NS_INLINE void CheckChildsParent(HTMLNode *parent, HTMLNode *child, NSString *cm
 
 NS_INLINE void CheckInsertedNodeValid(HTMLNode *node, NSString *cmd)
 {
-	if (node.type != HTMLNodeDocumentFragment &&
-		node.type != HTMLNodeDocumentType &&
-		node.type != HTMLNodeElement &&
-		node.type != HTMLNodeText &&
-		node.type != HTMLNodeComment) {
+	if (node.nodeType != HTMLNodeDocumentFragment &&
+		node.nodeType != HTMLNodeDocumentType &&
+		node.nodeType != HTMLNodeElement &&
+		node.nodeType != HTMLNodeText &&
+		node.nodeType != HTMLNodeComment) {
 		[NSException raise:HTMLKitHierarchyRequestError
 					format:@"%@: Hierarchy Request Error, inserting a %@ is not allowed. The operation would yield an incorrect node tree.",
 		 cmd, node.name];
@@ -288,13 +525,13 @@ NS_INLINE void CheckInsertedNodeValid(HTMLNode *node, NSString *cmd)
 
 NS_INLINE void CheckInvalidCombination(HTMLNode *parent, HTMLNode *node, NSString *cmd)
 {
-	if (node.type == HTMLNodeText && parent.type == HTMLNodeDocument) {
+	if (node.nodeType == HTMLNodeText && parent.nodeType == HTMLNodeDocument) {
 		[NSException raise:HTMLKitHierarchyRequestError
 					format:@"%@: Hierarchy Request Error, inserting a text node %@ into docuement is not allowed. The operation would yield an incorrect node tree.",
 		 cmd, parent.name];
 	}
 
-	if (node.type == HTMLNodeDocumentType && parent.type != HTMLNodeDocument) {
+	if (node.nodeType == HTMLNodeDocumentType && parent.nodeType != HTMLNodeDocument) {
 		[NSException raise:HTMLKitHierarchyRequestError
 					format:@"%@: Hierarchy Request Error, inserting a doctype %@ into a non-document node is not allowed. The operation would yield an incorrect node tree.",
 		 cmd, parent.name];
@@ -313,28 +550,28 @@ NS_INLINE void CheckInvalidCombination(HTMLNode *parent, HTMLNode *node, NSStrin
 
 	void (^ hierarchyError)() = ^{
 		[NSException raise:HTMLKitHierarchyRequestError
-					format:@"%@: Hierarchy Request Error. The operation would yield an incorrect node tree.",
-		 NSStringFromSelector(_cmd)];
+					format:@"%@: Hierarchy Request Error, inserting (%@) into (%@). The operation would yield an incorrect node tree.",
+		 NSStringFromSelector(_cmd), self, node];
 	};
 
-	if (self.type == HTMLNodeDocument) {
-		switch (node.type) {
+	if (self.nodeType == HTMLNodeDocument) {
+		switch (node.nodeType) {
 			case HTMLNodeDocumentFragment:
-				if (self.childNodesCount > 1 ||
-					[self hasChildNodeOfType:HTMLNodeText]) {
+				if (node.childNodesCount > 1 ||
+					[node hasChildNodeOfType:HTMLNodeText]) {
 					hierarchyError();
-				} else if (self.childNodesCount == 1) {
-					if (self.hasChildNodes ||
-						child.type == HTMLNodeDocumentType ||
-						child.nextSibling.type == HTMLNodeDocumentType) {
+				} else if (node.childNodesCount == 1) {
+					if ([self hasChildNodeOfType:HTMLNodeElement] ||
+						child.nodeType == HTMLNodeDocumentType ||
+						child.nextSibling.nodeType == HTMLNodeDocumentType) {
 						hierarchyError();
 					}
 				}
 				break;
 			case HTMLNodeElement:
 				if ([self hasChildNodeOfType:HTMLNodeElement] ||
-					child.type == HTMLNodeDocumentType ||
-					(child != nil && child.nextSibling.type == HTMLNodeDocumentType)) {
+					child.nodeType == HTMLNodeDocumentType ||
+					(child != nil && child.nextSibling.nodeType == HTMLNodeDocumentType)) {
 					hierarchyError();
 				}
 				break;
@@ -367,43 +604,42 @@ NS_INLINE void CheckInvalidCombination(HTMLNode *parent, HTMLNode *node, NSStrin
 		 NSStringFromSelector(_cmd)];
 	};
 
-	if (self.type == HTMLNodeDocument) {
-		switch (node.type) {
+	void (^ checkParentHasAnotherChildOfType)(HTMLNodeType) = ^ void (HTMLNodeType type) {
+		[self enumerateChildNodesUsingBlock:^(HTMLNode *node, NSUInteger idx, BOOL *stop) {
+			if (node.nodeType == type && node != child) {
+				*stop = YES;
+				hierarchyError();
+			}
+		}];
+	};
+
+	if (self.nodeType == HTMLNodeDocument) {
+		switch (node.nodeType) {
 			case HTMLNodeDocumentFragment:
-				if (self.childNodesCount > 1 ||
-					[self hasChildNodeOfType:HTMLNodeText]) {
+				if (node.childNodesCount > 1 ||
+					[node hasChildNodeOfType:HTMLNodeText]) {
 					hierarchyError();
-				} else if (self.childNodesCount == 1) {
-					if (self.firstChiledNode != node ||
-						child.nextSibling.type == HTMLNodeDocumentType) {
+				} else if (node.childNodesCount == 1) {
+					if (child.nextSibling.nodeType == HTMLNodeDocumentType) {
 						hierarchyError();
 					}
+					checkParentHasAnotherChildOfType(HTMLNodeElement);
 				}
 				break;
 			case HTMLNodeElement:
 			{
-				if (child.nextSibling.type == HTMLNodeDocumentType) {
+				if (child.nextSibling.nodeType == HTMLNodeDocumentType) {
 					hierarchyError();
 				}
-				[self enumerateChildNodesUsingBlock:^(HTMLNode *node, NSUInteger idx, BOOL *stop) {
-					if (node.type == HTMLNodeElement && node != child) {
-						*stop = YES;
-						hierarchyError();
-					}
-				}];
+				checkParentHasAnotherChildOfType(HTMLNodeElement);
 				break;
 			}
 			case HTMLNodeDocumentType:
 			{
-				if (child.previousSibling.type == HTMLNodeElement) {
+				if (child.previousSibling.nodeType == HTMLNodeElement) {
 					hierarchyError();
 				}
-				[self enumerateChildNodesUsingBlock:^(HTMLNode *node, NSUInteger idx, BOOL *stop) {
-					if (node.type == HTMLNodeDocument && node != child) {
-						*stop = YES;
-						hierarchyError();
-					}
-				}];
+				checkParentHasAnotherChildOfType(HTMLNodeDocumentType);
 				break;
 			}
 			default:
@@ -412,11 +648,13 @@ NS_INLINE void CheckInvalidCombination(HTMLNode *parent, HTMLNode *node, NSStrin
 	}
 }
 
+#endif
+
 #pragma mark - NSCopying
 
 - (id)copyWithZone:(NSZone *)zone
 {
-	HTMLNode *copy = [[self.class alloc] initWithName:self.name type:self.type];
+	HTMLNode *copy = [[self.class alloc] initWithName:self.name type:self.nodeType];
 	return copy;
 }
 
@@ -433,6 +671,11 @@ NS_INLINE void CheckInvalidCombination(HTMLNode *parent, HTMLNode *node, NSStrin
 	return [[self.childNodes.array valueForKey:@"outerHTML"] componentsJoinedByString:@""];
 }
 
+- (void)setInnerHTML:(NSString *)outerHTML
+{
+	[self doesNotRecognizeSelector:_cmd];
+}
+
 #pragma mark - Description
 
 - (NSString *)treeDescription
@@ -466,12 +709,7 @@ NS_INLINE void CheckInvalidCombination(HTMLNode *parent, HTMLNode *node, NSStrin
 
 - (NSString *)description
 {
-	return [NSString stringWithFormat:@"<%@: %p %@>", self.class, self, self.name];
-}
-
-- (NSString *)debugDescription
-{
-	return self.treeDescription;
+	return [NSString stringWithFormat:@"<%@: %p '%@'>", self.class, self, self.name];
 }
 
 - (id)debugQuickLookObject

HTMLKit/HTMLNodeFilter.h

@@ -0,0 +1,98 @@
+//
+//  HTMLNodeFilter.h
+//  HTMLKit
+//
+//  Created by Iska on 27/05/15.
+//  Copyright (c) 2015 BrainCookie. All rights reserved.
+//
+
+#import <Foundation/Foundation.h>
+
+NS_ASSUME_NONNULL_BEGIN
+
+/**
+ The node filter's value when applied to a given HTML node. The node filter can either accept a node, skip it, or 
+ reject it. Rejecting a node means skipping the node itself and all of it descendants.
+ */
+typedef NS_ENUM(unsigned short, HTMLNodeFilterValue)
+{
+	HTMLNodeFilterAccept = 1,
+	HTMLNodeFilterReject = 2,
+	HTMLNodeFilterSkip = 3
+};
+
+/**
+ The show options for the HTML node iterator and tree walker.
+ 
+ @see HTMLNodeIterator
+ @see HTMLTreeWalker
+ */
+typedef NS_OPTIONS(unsigned long, HTMLNodeFilterShowOptions)
+{
+	HTMLNodeFilterShowAll = 0xFFFFFFFF,
+	HTMLNodeFilterShowElement = 0x1,
+	HTMLNodeFilterShowText = 0x4,
+	HTMLNodeFilterShowComment = 0x80,
+	HTMLNodeFilterShowDocument = 0x100,
+	HTMLNodeFilterShowDocumentType = 0x200,
+	HTMLNodeFilterShowDocumentFragment = 0x400
+};
+
+
+#pragma mark - Node Filter
+
+@class HTMLNode;
+
+/**
+ A HTML Node Filter which can be used with a node iterator or a tree walker.
+ 
+ @see HTMLNodeIterator
+ @see HTMLTreeWalker
+ */
+@protocol HTMLNodeFilter <NSObject>
+@required
+/**
+ The implementation should return a HTMLNodeFilterValue to indicate accepting, skipping or rejecting a node.
+ 
+ @param node The node to be filtered.
+ @return `HTMLNodeFilterAccept` if accepted, `HTMLNodeFilterSkip` if skipped, or `HTMLNodeFilterReject` if rejected.
+ */
+- (HTMLNodeFilterValue)acceptNode:(HTMLNode *)node;
+
+@end
+
+#pragma mark - Block Filter
+
+/**
+ A concrete block-based HTML Node Filter implementation.
+ */
+@interface HTMLNodeFilterBlock : NSObject <HTMLNodeFilter>
+
+/**
+ Initializes and returns a new instance of this filter.
+ 
+ @param block The block to apply on each node to be filtered.
+ */
++ (instancetype)filterWithBlock:(HTMLNodeFilterValue (^)(HTMLNode *node))block;
+
+@end
+
+#pragma mark - CSS Selector Filter
+
+@class CSSSelector;
+
+/**
+ A concrete css-selector-based HTML Node Filter implementation.
+ */
+@interface HTMLSelectorNodeFilter : NSObject <HTMLNodeFilter>
+
+/**
+ Initializes and returns a new instance of this filter.
+
+ @param selector The selector to apply on each node to be filtered.
+ */
++ (instancetype)filterWithSelector:(CSSSelector *)selector;
+
+@end
+
+NS_ASSUME_NONNULL_END

HTMLKit/HTMLNodeFilter.m

@@ -0,0 +1,86 @@
+//
+//  HTMLNodeFilter.m
+//  HTMLKit
+//
+//  Created by Iska on 05/06/15.
+//  Copyright (c) 2015 BrainCookie. All rights reserved.
+//
+
+#import "HTMLNodeFilter.h"
+#import "HTMLNode.h"
+#import "HTMLNode+Private.h"
+#import "CSSSelector.h"
+
+#pragma mark - Block Filter
+
+@interface HTMLNodeFilterBlock ()
+{
+	BOOL (^ _block)(HTMLNode *);
+}
+@end
+
+@implementation HTMLNodeFilterBlock
+
++ (instancetype)filterWithBlock:(HTMLNodeFilterValue (^)(HTMLNode *))block
+{
+	return [[self alloc] initWithBlock:block];
+}
+
+- (instancetype)initWithBlock:(HTMLNodeFilterValue (^)(HTMLNode *))block
+{
+	self = [super init];
+	if (self) {
+		_block = [block copy];
+	}
+	return self;
+}
+
+- (HTMLNodeFilterValue)acceptNode:(HTMLNode *)node
+{
+	if (!_block) {
+		return HTMLNodeFilterSkip;
+	}
+
+	return _block(node);
+}
+
+@end
+
+#pragma mark - CSS Selector Filter
+
+@interface HTMLSelectorNodeFilter ()
+{
+	CSSSelector *_selector;
+}
+@end
+
+@implementation HTMLSelectorNodeFilter
+
++ (instancetype)filterWithSelector:(CSSSelector *)selector
+{
+	return [[self alloc] initWithSelector:selector];
+}
+
+- (instancetype)initWithSelector:(CSSSelector *)selector
+{
+	self = [super init];
+	if (self) {
+		_selector = selector;
+	}
+	return self;
+}
+
+- (HTMLNodeFilterValue)acceptNode:(HTMLNode *)node
+{
+	if (node.nodeType != HTMLNodeElement) {
+		return HTMLNodeFilterSkip;
+	}
+
+	if ([_selector acceptElement:node.asElement]) {
+		return HTMLNodeFilterAccept;
+	}
+
+	return HTMLNodeFilterSkip;
+}
+
+@end

HTMLKit/HTMLNodeIterator.h

@@ -0,0 +1,95 @@
+//
+//  HTMLNodeIterator.h
+//  HTMLKit
+//
+//  Created by Iska on 27/05/15.
+//  Copyright (c) 2015 BrainCookie. All rights reserved.
+//
+
+#import <Foundation/Foundation.h>
+#import "HTMLNodeFilter.h"
+
+NS_ASSUME_NONNULL_BEGIN
+
+@class HTMLNode;
+
+/**
+ A HTML Node Iterator, which iterates the nodes in the DOM in tree order, i.e. depth-first traversal of the tree.
+
+ https://dom.spec.whatwg.org/#interface-nodeiterator
+ */
+@interface HTMLNodeIterator : NSEnumerator<HTMLNode *>
+
+/**
+ The root element of this iterator, i.e. the traversed tree is rooted at this element.
+ */
+@property (nonatomic, strong, readonly) HTMLNode *root;
+
+/**
+ The current reference node.
+ */
+@property (nonatomic, strong, readonly) HTMLNode *referenceNode;
+
+/**
+ Whether the iterator's pointer is before the reference node.
+ */
+@property (nonatomic, assign, readonly) BOOL pointerBeforeReferenceNode;
+
+/**
+ The iterator's show options. These options control what types of elements are shown or skipped during iteration.
+
+ @see HTMLNodeFilterShowOptions
+ */
+@property (nonatomic, assign, readonly) HTMLNodeFilterShowOptions whatToShow;
+
+/**
+ A node filter, that is applied to each node during iteration.
+
+ @see HTMLNodeFilter
+ */
+@property (nonatomic, strong, readonly, nullable) id<HTMLNodeFilter> filter;
+
+
+/**
+ Initializes a new node iterator with no filter and HTMLNodeFilterShowAll show options.
+
+ @param node The root node.
+ @return A new instance of a node iterator.
+ */
+- (instancetype)initWithNode:(HTMLNode *)node;
+
+/**
+ Initializes a new node iterator with HTMLNodeFilterShowAll show options.
+
+ @param node The root node.
+ @param filter The node filter to use.
+ @return A new instance of a node iterator.
+ */
+- (instancetype)initWithNode:(HTMLNode *)node
+					  filter:(nullable id<HTMLNodeFilter>)filter;
+
+/**
+ Initializes a new node iterator.
+
+ @param node The root node.
+ @param showOptions The show options for the iterator.
+ @param filter The node filter to use.
+ @return A new instance of a node iterator.
+ */
+- (instancetype)initWithNode:(HTMLNode *)node
+				 showOptions:(HTMLNodeFilterShowOptions)showOptions
+					  filter:(nullable id<HTMLNodeFilter>)filter;
+
+/**
+ @return The next iterated node in tree order, `nil` if there are no more nodes to iterate.
+ */
+- (nullable HTMLNode *)nextNode;
+
+/**
+ @return The previous iterated node in tree order, `nil` if there are no more nodes to iterate.
+ */
+- (nullable HTMLNode *)previousNode;
+
+@end
+
+NS_ASSUME_NONNULL_END

HTMLKit/HTMLNodeIterator.m

@@ -0,0 +1,157 @@
+//
+//  HTMLNodeIterator.m
+//  HTMLKit
+//
+//  Created by Iska on 27/05/15.
+//  Copyright (c) 2015 BrainCookie. All rights reserved.
+//
+
+#import "HTMLNodeIterator.h"
+#import "HTMLDocument.h"
+#import "HTMLNode.h"
+#import "HTMLNodeFilter.h"
+#import "HTMLNodeTraversal.h"
+
+typedef NS_ENUM(short, TraverseDirection)
+{
+	TraverseDirectionNext,
+	TraverseDirectionPrevious
+};
+
+@interface HTMLDocument (Private)
+- (void)attachNodeIterator:(HTMLNodeIterator *)iterator;
+- (void)detachNodeIterator:(HTMLNodeIterator *)iterator;
+@end
+
+@interface HTMLNodeIterator ()
+{
+	HTMLNode *_root;
+}
+@end
+
+@implementation HTMLNodeIterator
+
+#pragma mark - Lifecycle
+
+- (instancetype)initWithNode:(HTMLNode *)node
+{
+	return [self initWithNode:node filter:nil];
+}
+
+- (instancetype)initWithNode:(HTMLNode *)node
+					  filter:(id<HTMLNodeFilter>)filter
+{
+	return [self initWithNode:node showOptions:HTMLNodeFilterShowAll filter:filter];
+}
+
+- (instancetype)initWithNode:(HTMLNode *)node
+				 showOptions:(HTMLNodeFilterShowOptions)showOptions
+					  filter:(id<HTMLNodeFilter>)filter
+{
+	self = [super init];
+	if (self) {
+		_root = node;
+		_filter = filter;
+		_whatToShow = showOptions;
+		_referenceNode = _root;
+		_pointerBeforeReferenceNode	= YES;
+		[_root.ownerDocument attachNodeIterator:self];
+	}
+	return self;
+}
+
+- (void)dealloc
+{
+	[_root.ownerDocument detachNodeIterator:self];
+}
+
+#pragma mark - Removing Steps
+
+- (void)runRemovingStepsForNode:(HTMLNode *)oldNode
+				   withOldParent:(HTMLNode *)oldParent
+		   andOldPreviousSibling:(HTMLNode *)oldPreviousSibling
+{
+	if ([oldNode containsNode:_root]) {
+		return;
+	}
+
+	if (![oldNode containsNode:_referenceNode]) {
+		return;
+	}
+
+	if (_pointerBeforeReferenceNode) {
+		HTMLNode *nextSibling = oldPreviousSibling != nil ? oldPreviousSibling.nextSibling : oldParent.firstChild;
+		if (nextSibling != nil) {
+			_referenceNode = nextSibling;
+			return;
+		}
+
+		HTMLNode *next = FollowingNode(oldParent, _root);
+		if ([_root containsNode:next]) {
+			_referenceNode = next;
+			return;
+		}
+
+		_pointerBeforeReferenceNode	= NO;
+	}
+
+	HTMLNode * (^ lastInclusiveDescendant) (HTMLNode *) = ^ HTMLNode * (HTMLNode *node) {
+		while (node.lastChild) {
+			node = node.lastChild;
+		}
+		return node;
+	};
+
+	_referenceNode = oldPreviousSibling != nil ? lastInclusiveDescendant(oldPreviousSibling) : oldParent;
+}
+
+#pragma mark - Traversal
+
+- (HTMLNode *)traverseInDirection:(TraverseDirection)direction
+{
+	HTMLNode *node = self.referenceNode;
+	BOOL beforeNode = self.pointerBeforeReferenceNode;
+
+	do {
+		if (direction == TraverseDirectionNext) {
+			if (!beforeNode) {
+				node = FollowingNode(node, self.root);
+				if (node == nil) {
+					return nil;
+				}
+			}
+			beforeNode = NO;
+		} else {
+			if (beforeNode) {
+				node = PrecedingNode(node, self.root);
+				if (node == nil) {
+					return nil;
+				}
+			}
+			beforeNode = YES;
+		}
+	} while (FilterNode(self.filter, self.whatToShow, node) != HTMLNodeFilterAccept);
+
+	_referenceNode = node;
+	_pointerBeforeReferenceNode = beforeNode;
+	return node;
+}
+
+- (HTMLNode *)nextNode
+{
+	return [self traverseInDirection:TraverseDirectionNext];
+}
+
+- (HTMLNode *)previousNode
+{
+	return [self traverseInDirection:TraverseDirectionPrevious];
+}
+
+#pragma mark - NSEnumerator
+
+- (id)nextObject
+{
+	return self.nextNode;
+}
+
+@end

HTMLKit/HTMLNodeTraversal.h

@@ -0,0 +1,21 @@
+//
+//  HTMLNodeTraversal.h
+//  HTMLKit
+//
+//  Created by Iska on 05/06/15.
+//  Copyright (c) 2015 BrainCookie. All rights reserved.
+//
+
+///------------------------------------------------------
+/// HTMLKit private header
+///------------------------------------------------------
+
+#import <Foundation/Foundation.h>
+#import "HTMLNodeFilter.h"
+
+@class HTMLNode;
+
+extern HTMLNode * PrecedingNode(HTMLNode *node, HTMLNode *root);
+extern HTMLNode * FollowingNode(HTMLNode *node, HTMLNode *root);
+extern HTMLNode * FollowingNodeSkippingChildren(HTMLNode *node, HTMLNode *root);
+extern HTMLNodeFilterValue FilterNode(id<HTMLNodeFilter> filter, HTMLNodeFilterShowOptions whatToShow, HTMLNode *node);

HTMLKit/HTMLNodeTraversal.m

@@ -0,0 +1,76 @@
+//
+//  HTMLNodeTraversal.m
+//  HTMLKit
+//
+//  Created by Iska on 05/06/15.
+//  Copyright (c) 2015 BrainCookie. All rights reserved.
+//
+
+#import "HTMLNodeTraversal.h"
+#import "HTMLNode.h"
+#import "HTMLNodeFilter.h"
+
+HTMLNode * PrecedingNode(HTMLNode *node, HTMLNode *root)
+{
+	HTMLNode *previous = node.previousSibling;
+	if (previous != nil) {
+		while (previous.lastChild != nil) {
+			previous = previous.lastChild;
+		}
+		return previous;
+	}
+
+	if (node == root) {
+		return nil;
+	}
+
+	return node.parentNode;
+}
+
+HTMLNode * FollowingNode(HTMLNode *node, HTMLNode *root)
+{
+	if (node.firstChild != nil) {
+		return node.firstChild;
+	}
+
+	do {
+		if (node == root) {
+			return nil;
+		}
+		if (node.nextSibling != nil) {
+			return node.nextSibling;
+		}
+		node = node.parentNode;
+	} while (node != nil);
+
+	return nil;
+}
+
+HTMLNode * FollowingNodeSkippingChildren(HTMLNode *node, HTMLNode *root)
+{
+	do {
+		if (node == root) {
+			return nil;
+		}
+		if (node.nextSibling != nil) {
+			return node.nextSibling;
+		}
+		node = node.parentNode;
+	} while (node != nil);
+
+	return nil;
+}
+
+HTMLNodeFilterValue FilterNode(id<HTMLNodeFilter> filter, HTMLNodeFilterShowOptions whatToShow, HTMLNode *node)
+{
+	unsigned long nthBit = (1 << (node.nodeType - 1)) & whatToShow;
+	if (!nthBit) {
+		return HTMLNodeFilterSkip;
+	}
+
+	if (filter == nil) {
+		return HTMLNodeFilterAccept;
+	}
+
+	return [filter acceptNode:node];
+}

HTMLKit/HTMLNodeTreeEnumerator.h

@@ -1,17 +0,0 @@
-//
-//  HTMLNodeTreeEnumerator.h
-//  HTMLKit
-//
-//  Created by Iska on 28/03/15.
-//  Copyright (c) 2015 BrainCookie. All rights reserved.
-//
-
-#import <Foundation/Foundation.h>
-
-@class HTMLNode;
-
-@interface HTMLNodeTreeEnumerator : NSEnumerator
-
-- (instancetype)initWithNode:(HTMLNode *)node reverse:(BOOL)reverse;
-
-@end

HTMLKit/HTMLNodeTreeEnumerator.m

@@ -1,54 +0,0 @@
-//
-//  HTMLNodeTreeEnumerator.m
-//  HTMLKit
-//
-//  Created by Iska on 28/03/15.
-//  Copyright (c) 2015 BrainCookie. All rights reserved.
-//
-
-#import "HTMLNodeTreeEnumerator.h"
-#import "HTMLNode.h"
-
-@interface HTMLNodeTreeEnumerator ()
-{
-	BOOL _reverse;
-	NSMutableArray *_stack;
-}
-@end
-
-@implementation HTMLNodeTreeEnumerator
-
-- (instancetype)initWithNode:(HTMLNode *)node reverse:(BOOL)reverse
-{
-	self = [super init];
-	if (self) {
-		_reverse = reverse;
-		_stack = [[NSMutableArray alloc] initWithObjects:node, nil];
-	}
-	return self;
-}
-
-- (id)nextObject
-{
-	if (_stack.count == 0) {
-		return nil;
-	}
-
-	HTMLNode *node = _stack.lastObject;
-	[_stack removeLastObject];
-
-	NSArray *childNodes = node.childNodes.array;
-	if (childNodes != nil && childNodes.count > 0) {
-		if (childNodes.count > 1) {
-			NSRange range = NSMakeRange(_reverse ? 0 : 1, childNodes.count - 1);
-			NSArray *rest = [childNodes subarrayWithRange:range];
-
-			[_stack addObjectsFromArray:_reverse ? rest : rest.reverseObjectEnumerator.allObjects];
-		}
-		[_stack addObject:_reverse ? childNodes.lastObject : childNodes.firstObject];
-	}
-
-	return node;
-}
-
-@end

HTMLKit/HTMLOrderedDictionary.h

@@ -8,18 +8,83 @@
 
 #import <Foundation/Foundation.h>
 
-@interface HTMLOrderedDictionary : NSMutableDictionary
+NS_ASSUME_NONNULL_BEGIN
 
-- (id)objectAtIndex:(NSUInteger)index;
-- (void)setObject:(id)anObject forKey:(id<NSCopying>)aKey atIndex:(NSUInteger)index;
+/**
+ An ordered mutable dictionary, that preserves the order of its keys.
+ */
+@interface HTMLOrderedDictionary<KeyType, ObjectType> : NSMutableDictionary<KeyType, ObjectType>
+
+/**
+ Returns the object at the specified index.
+
+ @param index An index within the bounds of the dictionary.
+ @return The object located at index.
+ */
+- (ObjectType)objectAtIndex:(NSUInteger)index;
+
+/**
+ Sets the object for the given key at the specified index.
+
+ @param anObject The object.
+ @param aKey The key.
+ @param index An index within the bounds of the dictionary.
+ */
+- (void)setObject:(ObjectType)anObject forKey:(KeyType<NSCopying>)aKey atIndex:(NSUInteger)index;
+
+/**
+ Removes the key-value pair located at the specified index.
+
+ @param index An index within the bounds of the dictionary.
+ */
 - (void)removeObjectAtIndex:(NSUInteger)index;
-- (void)replaceKeyValueAtIndex:(NSUInteger)index withObject:(id)anObject andKey:(id<NSCopying>)aKey;
-- (void)replaceKey:(id<NSCopying>)aKey withKey:(id<NSCopying>)newKey;
-- (NSUInteger)indexOfKey:(id<NSCopying>)aKey;
 
-- (id)objectAtIndexedSubscript:(NSUInteger)index;
-- (void)setObject:(id)obj atIndexedSubscript:(NSUInteger)index;
+/**
+ Replaces the key-value pair located at the specified index.
 
-- (NSEnumerator *)reverseKeyEnumerator;
+ @param index An index within the bounds of the dictionary.
+ @param anObject The new object.
+ @param aKey The new key.
+ */
+- (void)replaceKeyValueAtIndex:(NSUInteger)index withObject:(ObjectType)anObject andKey:(KeyType<NSCopying>)aKey;
+
+/**
+ Replaces a key keeping the same object.
+
+ @param aKey The old key to replace.
+ @param newKey The new key.
+ */
+- (void)replaceKey:(KeyType<NSCopying>)aKey withKey:(KeyType<NSCopying>)newKey;
+
+/**
+ Returns the index of the given key in the dictionary.
+
+ @param aKey The key.
+ @return The index of the given key in the dictionary.
+ */
+- (NSUInteger)indexOfKey:(KeyType<NSCopying>)aKey;
+
+/**
+ Returns the object at the specified index.
+
+ @param index An index within the bounds of the dictionary.
+ @return The object located at index.
+ */
+- (ObjectType)objectAtIndexedSubscript:(NSUInteger)index;
+
+/**
+ Replaces the object at the index with the new object.
+
+ @param obj The obj with which to replace the object at given index in the dictionary.
+ @param index The index of the object to be replaced.
+ */
+- (void)setObject:(ObjectType)obj atIndexedSubscript:(NSUInteger)index;
+
+/**
+ @return A reverse key enumerator.
+ */
+- (NSEnumerator<KeyType> *)reverseKeyEnumerator;
 
 @end
+
+NS_ASSUME_NONNULL_END

HTMLKit/HTMLParseErrorToken.h

@@ -6,14 +6,31 @@
 //  Copyright (c) 2014 BrainCookie. All rights reserved.
 //
 
+///------------------------------------------------------
+/// HTMLKit private header
+///------------------------------------------------------
+
 #import <Foundation/Foundation.h>
 #import "HTMLToken.h"
 
+/**
+ HTML Parse Error Token
+ */
 @interface HTMLParseErrorToken : HTMLToken
 
+/** @brief The error's reason message. */
 @property (nonatomic, copy) NSString *reason;
+
+/** @brief The error's location in the stream. */
 @property (nonatomic, assign) NSUInteger location;
 
+/**
+ Initializes a new Parse Error token.
+
+ @param reason The error's reason message.
+ @param location The error's location in the stream.
+ @return A new instance of a parse error token.
+ */
 - (instancetype)initWithReasonMessage:(NSString *)reason andStreamLocation:(NSUInteger)location;
 
 @end

HTMLKit/HTMLParseErrorToken.m

@@ -32,7 +32,7 @@
 
 - (NSString *)description
 {
-	return [NSString stringWithFormat:@"<%@: %p Reason='%@' Location='%lu'>", self.class, self, _reason, _location];
+	return [NSString stringWithFormat:@"<%@: %p Reason='%@' Location='%lu'>", self.class, self, _reason, (unsigned long)_location];
 }
 
 @end