Merge branch 'hotfix/2.1.1'

Closes #13

. codecov.yml

@@ -0,0 +1,5 @@
+codecov:
+  branch: develop
+
+ignore:
+  - "Tests/"

.gitignore

@@ -26,6 +26,7 @@ xcuserdata
 ## Obj-C/Swift specific
 *.hmap
 *.ipa
+.build/
 
 # CocoaPods
 #
@@ -39,5 +40,7 @@ Pods/
 #
 # Add this line if you want to avoid checking in source code from Carthage dependencies.
 Carthage/Checkouts
+Carthage/Build
 
-Carthage/Build
+# Jazzy
+docs/

.gitmodules

@@ -1,3 +1,3 @@
-[submodule "HTMLKitTests/html5lib-tests"]
-	path = HTMLKitTests/html5lib-tests
+[submodule "html5lib-tests"]
+	path = Tests/html5lib-tests
 	url = https://github.com/html5lib/html5lib-tests.git

.jazzy.yaml

@@ -0,0 +1,123 @@
+module: HTMLKit
+module_version: 2.1.1
+author: Iskandar Abudiab 
+author_url: https://twitter.com/iabudiab
+github_url: https://github.com/iabudiab/HTMLKit
+github_file_prefix: https://github.com/iabudiab/HTMLKit/tree/master
+output: docs
+umbrella_header: Sources/include/HTMLKit.h
+clean: true
+objc: true
+skip_undocumented: true
+
+custom_categories:
+  - name: Parsing
+    children:
+    - HTMLParser
+
+  - name: DOM
+    children:
+    - HTMLNamespace
+    - HTMLNode
+    - HTMLNodeType
+    - HTMLElement
+    - HTMLDocument
+    - HTMLDocumentReadyState
+    - HTMLQuirksMode
+    - HTMLDocumentType
+    - HTMLDocumentFragment
+    - HTMLDocumentPosition
+    - HTMLCharacterData
+    - HTMLText
+    - HTMLComment
+    - HTMLTemplate
+    - HTMLDOMTokenList
+    - HTMLRange
+
+  - name: Iteration & Filtering
+    children:
+    - HTMLNodeIterator
+    - HTMLNodeFilter
+    - HTMLNodeFilterShowOptions
+    - HTMLNodeFilterValue
+    - HTMLNodeFilterBlock
+    - HTMLSelectorNodeFilter
+    - HTMLTreeWalker
+
+  - name: Structures
+    children:
+    - HTMLOrderedDictionary
+    - CSSNthExpression
+
+  - name: CSS Selectors Implementation
+    children:
+    - CSSSelector
+    - CSSSelectorParser
+    - CSSTypeSelector
+    - CSSAttributeSelector
+    - CSSNthExpressionParser
+    - CSSNthExpressionSelector
+    - CSSPseudoClassSelector
+    - CSSPseudoFunctionSelector
+    - CSSSelectorBlock
+    - CSSCombinatorSelector
+    - CSSCompoundSelector
+
+  - name: Typed Selectors and Extensions
+    children:
+    - adjacentSiblingSelector
+    - allOf
+    - anyOf
+    - attributeSelector
+    - buttonSelector
+    - checkboxSelector
+    - checkedSelector
+    - childOfElementSelector
+    - classSelector
+    - descendantOfElementSelector
+    - disabledSelector
+    - emptySelector
+    - enabledSelector
+    - eqSelector
+    - evenSlector
+    - fileSelector
+    - firstChildSelector
+    - firstOfTypeSelector
+    - generalSiblingSelector
+    - gtSelector
+    - has
+    - hasAttributeSelector
+    - headerSelector
+    - idSelector
+    - imageSelector
+    - inputSelector
+    - lastChildSelector
+    - lastOfTypeSelector
+    - linkSelector
+    - ltSelector
+    - namedBlockSelector
+    - namedPseudoSelector
+    - not
+    - nthChildSelector
+    - nthLastChildSelector
+    - nthLastOfTypeSelector
+    - nthOfTypeSelector
+    - oddSelector
+    - onlyChildSelector
+    - onlyOfTypeSelector
+    - optionalSelector
+    - parentSelector
+    - passwordSelector
+    - radioSelector
+    - requiredSelector
+    - resetSelector
+    - rootSelector
+    - submitSelector
+    - textSelector
+    - typeSelector
+    - universalSelector
+
+    - name: Categories
+      children:
+      - NSCharacterSet(HTMLKit)
+      - NSString(HTMLKit)

.travis.yml

@@ -0,0 +1,45 @@
+language: objective-c
+osx_image: xcode9
+
+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
+    - MACOS_FRAMEWORK_SCHEME=HTMLKit-macOS
+    - WATCHOS_FRAMEWORK_SCHEME="HTMLKit-watchOS"
+    - TVOS_FRAMEWORK_SCHEME="HTMLKit-tvOS"
+    - IOS_SDK=iphonesimulator11.0
+    - MACOS_SDK=macosx10.13
+    - WATCHOS_SDK=watchsimulator4.0
+    - TVOS_SDK=appletvsimulator11.0
+  matrix:
+    - DESTINATION="arch=x86_64"                                SCHEME="$MACOS_FRAMEWORK_SCHEME"      SDK="$MACOS_SDK"
+    - DESTINATION="OS=9.3,name=iPhone 6s Plus"                 SCHEME="$IOS_FRAMEWORK_SCHEME"        SDK="$IOS_SDK"
+    - DESTINATION="OS=10.3.1,name=iPhone 7 Plus"               SCHEME="$IOS_FRAMEWORK_SCHEME"        SDK="$IOS_SDK"
+    - DESTINATION="OS=11.0,name=iPhone X"                      SCHEME="$IOS_FRAMEWORK_SCHEME"        SDK="$IOS_SDK"
+    - DESTINATION="OS=3.2,name=Apple Watch Series 2 - 42mm"    SCHEME="$WATCHOS_FRAMEWORK_SCHEME"    SDK="$WATCHOS_SDK"
+    - DESTINATION="OS=4.0,name=Apple Watch Series 3 - 42mm"    SCHEME="$WATCHOS_FRAMEWORK_SCHEME"    SDK="$WATCHOS_SDK"
+    - DESTINATION="OS=10.2,name=Apple TV 1080p"                SCHEME="$TVOS_FRAMEWORK_SCHEME"       SDK="$TVOS_SDK"
+    - DESTINATION="OS=11.0,name=Apple TV 4K"                   SCHEME="$TVOS_FRAMEWORK_SCHEME"       SDK="$TVOS_SDK"
+
+script:
+  - set -o pipefail
+  - xcodebuild -version
+  - xcodebuild -showsdks
+  - travis_retry xcodebuild -workspace "$WORKSPACE" -scheme "$SCHEME" -sdk "$SDK" -destination "$DESTINATION" -configuration Debug ONLY_ACTIVE_ARCH=NO clean build | xcpretty -c
+  - if [ "$SDK" != "$WATCHOS_SDK" ]; then
+      travis_retry xcodebuild -workspace "$WORKSPACE" -scheme "$SCHEME" -sdk "$SDK" -destination "$DESTINATION" -configuration Debug ONLY_ACTIVE_ARCH=NO GCC_INSTRUMENT_PROGRAM_FLOW_ARCS=YES GCC_GENERATE_TEST_COVERAGE_FILES=YES test | xcpretty -c;
+    fi
+
+after_success:
+  - bash <(curl -s https://codecov.io/bash)
+

CHANGELOG.md

@@ -0,0 +1,299 @@
+# Change Log
+
+## [2.1.1](https://github.com/iabudiab/HTMLKit/releases/tag/2.1.1) 
+
+Released on 2017.10.13
+
+### Hotfix
+
+- Fixed documentation comments
+	- Should fix CocoaDocs generation and percentage
+
+
+## [2.1.0](https://github.com/iabudiab/HTMLKit/releases/tag/2.1.0) 
+
+Released on 2017.10.12
+
+### Added
+
+- Standarized tokenizer error codes:
+	- [whatwg/html#2701](https://github.com/whatwg/html/pull/2701)
+	- [html5lib/html5lib-tests#92](https://github.com/html5lib/html5lib-tests/pull/92)
+
+### Updated
+
+- Project for Xcode 9
+- Travis config for iOS 11.0, macOS 10.13, tvOS 11.0 and watchOS 4.0
+- Updated HTML5Lib-Tests submodule (cbafeba)
+
+## [2.0.6](https://github.com/iabudiab/HTMLKit/releases/tag/2.0.6) 
+
+Released on 2017.05.02
+
+### Added
+
+- Memory consumption improvements (issue #10)
+	- Allocate `childNodes` collection in `HTMLNode` only when inserting child nodes
+	- Replace `NSStringFromSelector` calls with constants in `HTMLNode` validations
+	- Improve `reverseObjectEnumerator` usage while parsing HTML
+	- Rewrite internal logic of the `HTMLStackOfOpenElements` to prevent excessive allocations
+
+
+## [2.0.5](https://github.com/iabudiab/HTMLKit/releases/tag/2.0.5) 
+
+Released on 2017.04.19
+
+### Fixed
+
+- Xcode 8.3 issue with modulemaps
+	- Temporary workaround (renamed modulemap file)
+- Memory Leaks in `CSSInputStream`
+
+### Added
+
+- Minor memory consumption improvements
+	- Collections for child nodes or attributes of HTML Nodes or Elements are allocated lazily
+	- Underyling data string of `CharacterData` is allocated on first access
+	- Autorelease pool for the main `HTMLTokenizer` loop
+
+
+## [2.0.4](https://github.com/iabudiab/HTMLKit/releases/tag/2.0.4) 
+
+Released on 2017.04.2
+
+### Fixed
+
+- Testing with Swift 3.1
+	- Fixed by @tali in PR #8
+
+### Deprecated
+
+- `HTMLRange` initializers with typo
+	- `initWithDowcument:startContainer:startOffset:endContainer:endOffset:`
+
+
+## [2.0.3](https://github.com/iabudiab/HTMLKit/releases/tag/2.0.3) 
+
+Released on 2017.03.6
+
+### Fixed
+
+- Compilation for Swift 3.1
+	- Fixed by @tali in PR #6
+
+
+## [2.0.2](https://github.com/iabudiab/HTMLKit/releases/tag/2.0.2) 
+
+Released on 2017.02.26
+
+### Fixed
+
+- Retain cycles in `HTMLNodeIterator` (issue #4)
+- Retain cycles in `HTMLRange` (issue #5)
+- The layout of `HTMLKit` tests module for Swift Package Manager
+
+
+## [2.0.1](https://github.com/iabudiab/HTMLKit/releases/tag/2.0.1) 
+
+Released on 2017.02.20
+
+### Hotifx
+
+- Set `INSTALL_PATH` and `DYLIB_INSTALL_NAME_BASE` to `@rpath` for macOS target
+	- This fixes embedding `HTMLKit` in a Cocoa application
+
+
+## [2.0.0](https://github.com/iabudiab/HTMLKit/releases/tag/2.0.0) 
+
+Released on 2017.02.11
+
+### Spec Change
+
+- Make `<menuitem>` parse like an unkonwn element. See:
+	- [whatwg/html#2319](https://github.com/whatwg/html/pull/2319)
+	- [html5lib/html5lib-tests#88](https://github.com/html5lib/html5lib-tests/pull/88)
+
+### Updated
+
+- Updated HTML5Lib-Tests submodule (13f1805)
+
+
+## [1.1.0](https://github.com/iabudiab/HTMLKit/releases/tag/1.1.0) 
+
+Released on 2017.01.14
+
+### Added
+
+- `DOM Ranges` implementation ([spec](https://dom.spec.whatwg.org/#ranges))
+- `HTMLChatacterData` as base class for `HTMLText` & `HTMLComment`
+	- `HTMLText` and `HTMLComment` no longer extend `HTMLNode` directly
+- `splitText` implementation for `HTMLText` nodes
+- `index` property for `HTMLNode`
+- `cloneNodeDeep` method for `HTMLNode`
+
+### Deprecated
+
+- `appendString` method in `HTMLText` in favor of `appendData` from the supperclass `HTMLCharacterData`
+
+
+## [1.0.0](https://github.com/iabudiab/HTMLKit/releases/tag/1.0.0) 
+
+Released on 2016.09.28
+
+### Added
+
+- Jazzy configuration file
+- Example HTMLKit project
+
+### Updated
+
+- Project for Xcode 8
+- Playground syntax for Swift 3
+- Travis config for iOS 10.0, macOS 10.12, tvOS 10.0 and watchOS 3.0
+- Deployment targets to macOS 10.9, iOS 9.0, tvOS 9.0 and watchOS 2.0
+
+### Fixed
+
+- Nullability annotation in `CSSSelectorParser` class
+- Missing lightweight generics in `HTMLParser`, `HTMLNode` & `HTMLElement`
+
+## [0.9.4](https://github.com/iabudiab/HTMLKit/releases/tag/0.9.4) 
+
+Released on 2016.09.03
+
+### Added
+
+- `Swift Package Manager` support
+
+## [0.9.3](https://github.com/iabudiab/HTMLKit/releases/tag/0.9.3)
+
+Released on 2016.07.16
+
+This release passes all tokenizer and tree construction 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 tokenizer and tree construction 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
+
+
+### 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.

Example/HTMLKitExample/HTMLKitExample.xcodeproj/project.pbxproj

@@ -0,0 +1,273 @@
+// !$*UTF8*$!
+{
+	archiveVersion = 1;
+	classes = {
+	};
+	objectVersion = 46;
+	objects = {
+
+/* Begin PBXBuildFile section */
+		629A63CD1D9AFE0E0089679F /* main.swift in Sources */ = {isa = PBXBuildFile; fileRef = 629A63CC1D9AFE0E0089679F /* main.swift */; };
+/* End PBXBuildFile section */
+
+/* Begin PBXCopyFilesBuildPhase section */
+		629A63C71D9AFE0E0089679F /* CopyFiles */ = {
+			isa = PBXCopyFilesBuildPhase;
+			buildActionMask = 2147483647;
+			dstPath = /usr/share/man/man1/;
+			dstSubfolderSpec = 0;
+			files = (
+			);
+			runOnlyForDeploymentPostprocessing = 1;
+		};
+/* End PBXCopyFilesBuildPhase section */
+
+/* Begin PBXFileReference section */
+		629A63C91D9AFE0E0089679F /* HTMLKitExample */ = {isa = PBXFileReference; explicitFileType = "compiled.mach-o.executable"; includeInIndex = 0; path = HTMLKitExample; sourceTree = BUILT_PRODUCTS_DIR; };
+		629A63CC1D9AFE0E0089679F /* main.swift */ = {isa = PBXFileReference; lastKnownFileType = sourcecode.swift; path = main.swift; sourceTree = "<group>"; };
+/* End PBXFileReference section */
+
+/* Begin PBXFrameworksBuildPhase section */
+		629A63C61D9AFE0E0089679F /* Frameworks */ = {
+			isa = PBXFrameworksBuildPhase;
+			buildActionMask = 2147483647;
+			files = (
+			);
+			runOnlyForDeploymentPostprocessing = 0;
+		};
+/* End PBXFrameworksBuildPhase section */
+
+/* Begin PBXGroup section */
+		629A63C01D9AFE0E0089679F = {
+			isa = PBXGroup;
+			children = (
+				629A63CB1D9AFE0E0089679F /* HTMLKitExample */,
+				629A63CA1D9AFE0E0089679F /* Products */,
+			);
+			sourceTree = "<group>";
+		};
+		629A63CA1D9AFE0E0089679F /* Products */ = {
+			isa = PBXGroup;
+			children = (
+				629A63C91D9AFE0E0089679F /* HTMLKitExample */,
+			);
+			name = Products;
+			sourceTree = "<group>";
+		};
+		629A63CB1D9AFE0E0089679F /* HTMLKitExample */ = {
+			isa = PBXGroup;
+			children = (
+				629A63CC1D9AFE0E0089679F /* main.swift */,
+			);
+			path = HTMLKitExample;
+			sourceTree = "<group>";
+		};
+/* End PBXGroup section */
+
+/* Begin PBXNativeTarget section */
+		629A63C81D9AFE0E0089679F /* HTMLKitExample */ = {
+			isa = PBXNativeTarget;
+			buildConfigurationList = 629A63D01D9AFE0E0089679F /* Build configuration list for PBXNativeTarget "HTMLKitExample" */;
+			buildPhases = (
+				629A63C51D9AFE0E0089679F /* Sources */,
+				629A63C61D9AFE0E0089679F /* Frameworks */,
+				629A63C71D9AFE0E0089679F /* CopyFiles */,
+			);
+			buildRules = (
+			);
+			dependencies = (
+			);
+			name = HTMLKitExample;
+			productName = HTMLKitExample;
+			productReference = 629A63C91D9AFE0E0089679F /* HTMLKitExample */;
+			productType = "com.apple.product-type.tool";
+		};
+/* End PBXNativeTarget section */
+
+/* Begin PBXProject section */
+		629A63C11D9AFE0E0089679F /* Project object */ = {
+			isa = PBXProject;
+			attributes = {
+				LastSwiftUpdateCheck = 0800;
+				LastUpgradeCheck = 0900;
+				ORGANIZATIONNAME = iabudiab;
+				TargetAttributes = {
+					629A63C81D9AFE0E0089679F = {
+						CreatedOnToolsVersion = 8.0;
+						ProvisioningStyle = Automatic;
+					};
+				};
+			};
+			buildConfigurationList = 629A63C41D9AFE0E0089679F /* Build configuration list for PBXProject "HTMLKitExample" */;
+			compatibilityVersion = "Xcode 3.2";
+			developmentRegion = English;
+			hasScannedForEncodings = 0;
+			knownRegions = (
+				en,
+			);
+			mainGroup = 629A63C01D9AFE0E0089679F;
+			productRefGroup = 629A63CA1D9AFE0E0089679F /* Products */;
+			projectDirPath = "";
+			projectRoot = "";
+			targets = (
+				629A63C81D9AFE0E0089679F /* HTMLKitExample */,
+			);
+		};
+/* End PBXProject section */
+
+/* Begin PBXSourcesBuildPhase section */
+		629A63C51D9AFE0E0089679F /* Sources */ = {
+			isa = PBXSourcesBuildPhase;
+			buildActionMask = 2147483647;
+			files = (
+				629A63CD1D9AFE0E0089679F /* main.swift in Sources */,
+			);
+			runOnlyForDeploymentPostprocessing = 0;
+		};
+/* End PBXSourcesBuildPhase section */
+
+/* Begin XCBuildConfiguration section */
+		629A63CE1D9AFE0E0089679F /* Debug */ = {
+			isa = XCBuildConfiguration;
+			buildSettings = {
+				ALWAYS_SEARCH_USER_PATHS = NO;
+				CLANG_ANALYZER_NONNULL = YES;
+				CLANG_CXX_LANGUAGE_STANDARD = "gnu++0x";
+				CLANG_CXX_LIBRARY = "libc++";
+				CLANG_ENABLE_MODULES = YES;
+				CLANG_ENABLE_OBJC_ARC = YES;
+				CLANG_WARN_BLOCK_CAPTURE_AUTORELEASING = YES;
+				CLANG_WARN_BOOL_CONVERSION = YES;
+				CLANG_WARN_COMMA = YES;
+				CLANG_WARN_CONSTANT_CONVERSION = YES;
+				CLANG_WARN_DIRECT_OBJC_ISA_USAGE = YES_ERROR;
+				CLANG_WARN_DOCUMENTATION_COMMENTS = YES;
+				CLANG_WARN_EMPTY_BODY = YES;
+				CLANG_WARN_ENUM_CONVERSION = YES;
+				CLANG_WARN_INFINITE_RECURSION = YES;
+				CLANG_WARN_INT_CONVERSION = YES;
+				CLANG_WARN_NON_LITERAL_NULL_CONVERSION = YES;
+				CLANG_WARN_OBJC_LITERAL_CONVERSION = YES;
+				CLANG_WARN_OBJC_ROOT_CLASS = YES_ERROR;
+				CLANG_WARN_RANGE_LOOP_ANALYSIS = YES;
+				CLANG_WARN_STRICT_PROTOTYPES = YES;
+				CLANG_WARN_SUSPICIOUS_MOVE = YES;
+				CLANG_WARN_SUSPICIOUS_MOVES = YES;
+				CLANG_WARN_UNREACHABLE_CODE = YES;
+				CLANG_WARN__DUPLICATE_METHOD_MATCH = YES;
+				CODE_SIGN_IDENTITY = "-";
+				COPY_PHASE_STRIP = NO;
+				DEBUG_INFORMATION_FORMAT = dwarf;
+				ENABLE_STRICT_OBJC_MSGSEND = YES;
+				ENABLE_TESTABILITY = YES;
+				GCC_C_LANGUAGE_STANDARD = gnu99;
+				GCC_DYNAMIC_NO_PIC = NO;
+				GCC_NO_COMMON_BLOCKS = YES;
+				GCC_OPTIMIZATION_LEVEL = 0;
+				GCC_PREPROCESSOR_DEFINITIONS = (
+					"DEBUG=1",
+					"$(inherited)",
+				);
+				GCC_WARN_64_TO_32_BIT_CONVERSION = YES;
+				GCC_WARN_ABOUT_RETURN_TYPE = YES_ERROR;
+				GCC_WARN_UNDECLARED_SELECTOR = YES;
+				GCC_WARN_UNINITIALIZED_AUTOS = YES_AGGRESSIVE;
+				GCC_WARN_UNUSED_FUNCTION = YES;
+				GCC_WARN_UNUSED_VARIABLE = YES;
+				MACOSX_DEPLOYMENT_TARGET = 10.11;
+				MTL_ENABLE_DEBUG_INFO = YES;
+				ONLY_ACTIVE_ARCH = YES;
+				SDKROOT = macosx;
+				SWIFT_OPTIMIZATION_LEVEL = "-Onone";
+			};
+			name = Debug;
+		};
+		629A63CF1D9AFE0E0089679F /* Release */ = {
+			isa = XCBuildConfiguration;
+			buildSettings = {
+				ALWAYS_SEARCH_USER_PATHS = NO;
+				CLANG_ANALYZER_NONNULL = YES;
+				CLANG_CXX_LANGUAGE_STANDARD = "gnu++0x";
+				CLANG_CXX_LIBRARY = "libc++";
+				CLANG_ENABLE_MODULES = YES;
+				CLANG_ENABLE_OBJC_ARC = YES;
+				CLANG_WARN_BLOCK_CAPTURE_AUTORELEASING = YES;
+				CLANG_WARN_BOOL_CONVERSION = YES;
+				CLANG_WARN_COMMA = YES;
+				CLANG_WARN_CONSTANT_CONVERSION = YES;
+				CLANG_WARN_DIRECT_OBJC_ISA_USAGE = YES_ERROR;
+				CLANG_WARN_DOCUMENTATION_COMMENTS = YES;
+				CLANG_WARN_EMPTY_BODY = YES;
+				CLANG_WARN_ENUM_CONVERSION = YES;
+				CLANG_WARN_INFINITE_RECURSION = YES;
+				CLANG_WARN_INT_CONVERSION = YES;
+				CLANG_WARN_NON_LITERAL_NULL_CONVERSION = YES;
+				CLANG_WARN_OBJC_LITERAL_CONVERSION = YES;
+				CLANG_WARN_OBJC_ROOT_CLASS = YES_ERROR;
+				CLANG_WARN_RANGE_LOOP_ANALYSIS = YES;
+				CLANG_WARN_STRICT_PROTOTYPES = YES;
+				CLANG_WARN_SUSPICIOUS_MOVE = YES;
+				CLANG_WARN_SUSPICIOUS_MOVES = YES;
+				CLANG_WARN_UNREACHABLE_CODE = YES;
+				CLANG_WARN__DUPLICATE_METHOD_MATCH = YES;
+				CODE_SIGN_IDENTITY = "-";
+				COPY_PHASE_STRIP = NO;
+				DEBUG_INFORMATION_FORMAT = "dwarf-with-dsym";
+				ENABLE_NS_ASSERTIONS = NO;
+				ENABLE_STRICT_OBJC_MSGSEND = YES;
+				GCC_C_LANGUAGE_STANDARD = gnu99;
+				GCC_NO_COMMON_BLOCKS = YES;
+				GCC_WARN_64_TO_32_BIT_CONVERSION = YES;
+				GCC_WARN_ABOUT_RETURN_TYPE = YES_ERROR;
+				GCC_WARN_UNDECLARED_SELECTOR = YES;
+				GCC_WARN_UNINITIALIZED_AUTOS = YES_AGGRESSIVE;
+				GCC_WARN_UNUSED_FUNCTION = YES;
+				GCC_WARN_UNUSED_VARIABLE = YES;
+				MACOSX_DEPLOYMENT_TARGET = 10.11;
+				MTL_ENABLE_DEBUG_INFO = NO;
+				SDKROOT = macosx;
+				SWIFT_OPTIMIZATION_LEVEL = "-Owholemodule";
+			};
+			name = Release;
+		};
+		629A63D11D9AFE0E0089679F /* Debug */ = {
+			isa = XCBuildConfiguration;
+			buildSettings = {
+				PRODUCT_NAME = "$(TARGET_NAME)";
+				SWIFT_VERSION = 3.0;
+			};
+			name = Debug;
+		};
+		629A63D21D9AFE0E0089679F /* Release */ = {
+			isa = XCBuildConfiguration;
+			buildSettings = {
+				PRODUCT_NAME = "$(TARGET_NAME)";
+				SWIFT_VERSION = 3.0;
+			};
+			name = Release;
+		};
+/* End XCBuildConfiguration section */
+
+/* Begin XCConfigurationList section */
+		629A63C41D9AFE0E0089679F /* Build configuration list for PBXProject "HTMLKitExample" */ = {
+			isa = XCConfigurationList;
+			buildConfigurations = (
+				629A63CE1D9AFE0E0089679F /* Debug */,
+				629A63CF1D9AFE0E0089679F /* Release */,
+			);
+			defaultConfigurationIsVisible = 0;
+			defaultConfigurationName = Release;
+		};
+		629A63D01D9AFE0E0089679F /* Build configuration list for PBXNativeTarget "HTMLKitExample" */ = {
+			isa = XCConfigurationList;
+			buildConfigurations = (
+				629A63D11D9AFE0E0089679F /* Debug */,
+				629A63D21D9AFE0E0089679F /* Release */,
+			);
+			defaultConfigurationIsVisible = 0;
+			defaultConfigurationName = Release;
+		};
+/* End XCConfigurationList section */
+	};
+	rootObject = 629A63C11D9AFE0E0089679F /* Project object */;
+}

Example/HTMLKitExample/HTMLKitExample.xcodeproj/project.xcworkspace/contents.xcworkspacedata

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

Example/HTMLKitExample/HTMLKitExample.xcodeproj/xcshareddata/xcschemes/HTMLKitExample.xcscheme

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

Example/HTMLKitExample/HTMLKitExample/main.swift

@@ -0,0 +1,167 @@
+//
+//  main.swift
+//  HTMLKitExample
+//
+//  Created by Iska on 27/09/16.
+//  Copyright © 2016 iabudiab. All rights reserved.
+//
+
+import HTMLKit
+
+// Simple scraper that is able to load a page, query via CSS Selectors, and following links
+class Scraper {
+
+	enum ScrapingError: Error {
+		case DocumentNotLoaded
+		case ElementNotFound(String)
+		case InvalidAnchorUrl(String)
+		case CouldNotLoadPage(URL)
+	}
+
+	private var url: URL
+	private(set) var document: HTMLDocument?
+
+	init(url: URL) {
+		self.url = url
+		self.document = nil
+	}
+
+	func load() throws {
+		try loadDocument(at: url)
+	}
+
+	func listElements(matching selector: CSSSelector) throws -> [HTMLElement] {
+		guard let document = document else {
+			throw ScrapingError.DocumentNotLoaded
+		}
+
+		return document.elements(matching: selector)
+	}
+
+	func followLink(matchingSelector selector: CSSSelector) throws {
+		guard let document = document else {
+			throw ScrapingError.DocumentNotLoaded
+		}
+
+		guard let link = document.firstElement(matching: selector) else {
+			throw ScrapingError.ElementNotFound(selector.debugDescription)
+		}
+
+		guard let targetUrl = URL(string: link["href"], relativeTo: url) else {
+			throw ScrapingError.InvalidAnchorUrl(link["href"])
+		}
+
+		try loadDocument(at: targetUrl)
+	}
+
+	private func loadDocument(at url: URL) throws {
+		guard let content = try? String(contentsOf: url) else {
+			throw ScrapingError.CouldNotLoadPage(url)
+		}
+		document = HTMLDocument(string: content)
+	}
+}
+
+// A custom block-based selector, that matches only elements having the given text content:
+// i.e. textContentSelector("Hello") will match <p>Hello</p> and <a href='example.com'>Hello</a>
+// but wont match <div>World</div> or <p>Hello there</p>
+func textContentSelector(text: String) -> CSSSelector {
+	return namedBlockSelector("[@textContent='\(text)']") { (element) -> Bool in
+		return element.textContent == text
+	}
+}
+
+// Helper function to create a typed-selector matching an anchor element that has the given
+// text content.
+func anchorElement(havingContent: String) -> CSSSelector {
+	return allOf(
+		[
+			typeSelector("a"),
+			textContentSelector(text: havingContent)
+		]
+	)
+}
+
+// Helper function to print the content of a github repository file content
+func printRepositoryFile(element: HTMLElement) {
+
+	// A node iterator filter that iterates only <td> elements of class "content" i.e. <td class='content'>
+	let contentIterator = element.nodeIterator(showOptions: .element) { (node) -> HTMLNodeFilterValue in
+		guard let element = node as? HTMLElement else { return .reject }
+
+		if element.tagName == "td" && element["class"] == "content" {
+			return .accept
+		}
+
+		return .reject
+	}
+
+	for td in contentIterator {
+		// The cast is necessary because Swift3 wont import the generics info of the NSEnumerator class
+		// i.e. the nextObject() function alwasy has the following signature 'func nextObject() -> Any?'
+		let title = (td as AnyObject).textContent.trimmingCharacters(in: CharacterSet.whitespacesAndNewlines)
+		print("- \(title)")
+	}
+}
+
+let htmlKitUrl = URL(string: "https://github.com/iabudiab/HTMLKit")!
+let scraper = Scraper(url: htmlKitUrl)
+
+do {
+	// Load the page
+	try scraper.load()
+
+	// Parse the selector
+	let repositoryContent = try CSSSelectorParser.parseSelector("[role='main'] .repository-content > .file-wrap > .files tr.js-navigation-item")
+
+	// Query matching elements
+	let files =  try scraper.listElements(matching: repositoryContent)
+
+	print("HTMLKit repositroy root:")
+	files.forEach(printRepositoryFile)
+} catch let error {
+	print(error)
+}
+
+do {
+	// Follow some links
+	try scraper.followLink(matchingSelector: anchorElement(havingContent: "Sources"))
+	try scraper.followLink(matchingSelector: anchorElement(havingContent: "HTMLEOFToken.m"))
+
+	// The following selector: "[role='main'] div.file table.js-file-line-container td:nth-child(2)"
+	// can be defined in type-safe manner:
+	let selector = allOf([
+		descendantOfElementSelector(
+			attributeSelector(.exactMatch, "role", "main")
+		),
+		descendantOfElementSelector(
+			allOf([
+				typeSelector("div"),
+				classSelector("file")
+			])
+		),
+		descendantOfElementSelector(
+			allOf([
+				typeSelector("table"),
+				classSelector("js-file-line-container")
+			])
+		),
+		typeSelector("td"),
+		nthChildSelector(
+			CSSNthExpressionMake(0, 2)
+		)
+	])
+
+	// Query matching elements
+	let elements = try scraper.listElements(matching: selector)
+
+	// This will print the source code for the "HTMLEOFToken.m" file under this url:
+	// https://github.com/iabudiab/HTMLKit/blob/master/Sources/HTMLEOFToken.m
+
+	print("\nHTMLEOFToken:")
+	elements.forEach {
+		print($0.textContent)
+	}
+} catch let error {
+	print(error)
+}

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.elements(matching: typeSelector("p"))
+paragraphsOrHeaders = document.elements(matching: 
+	anyOf([
+		typeSelector("p"), typeSelector("h1")
+	])
+)
+
+hasClassAttribute = document.elements(matching: hasAttributeSelector("class"))
+greetings = document.elements(matching: classSelector("greeting"))
+classNameStartsWith_de = document.elements(matching: attributeSelector(.begins, "class", "de"))
+
+hasAdjacentHeader = document.elements(matching: adjacentSiblingSelector(typeSelector("h1")))
+hasAdjacentHeader = document.elements(matching: generalSiblingSelector(typeSelector("h1")))
+hasAdjacentHeader = document.elements(matching: generalSiblingSelector(typeSelector("p")))
+
+nonParagraphChildOfDiv = document.elements(matching: 
+	allOf([
+		childOfElementSelector(typeSelector("div")),
+		not(typeSelector("p"))
+	])
+)
+
+/*:
+Here are more examples
+*/
+
+let firstDivElement = document.firstElement(matching: typeSelector("div"))!
+
+var secondChildOfDiv = firstDivElement.querySelectorAll(":nth-child(2)")
+var secondOfType = firstDivElement.querySelectorAll(":nth-of-type(2n)")
+
+secondChildOfDiv = firstDivElement.elements(matching: nthChildSelector(CSSNthExpression(an: 0, b: 2)))
+secondOfType = firstDivElement.elements(matching: nthOfTypeSelector(CSSNthExpression(an: 2, b: 0)))
+
+
+var notParagraphAndNotDiv = firstDivElement.querySelectorAll(":not(p):not(div)")
+notParagraphAndNotDiv = firstDivElement.elements(matching: 
+	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.elements(matching: myAwesomeSelector)

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,30 @@
+//: [Previous](@previous)
+/*:
+# Parsing HTML Documents
+*/
+
+import HTMLKit
+
+/*:
+Given some HTML content
+*/
+
+let htmlString = "<div><h1>HTMLKit</h1><p class='greeting'>Hello there!</p><p class='description'>This is a demo of HTMLKit</p></div>"
+htmlString
+
+/*:
+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,22 @@
+<?xml version="1.0" encoding="UTF-8"?>
+<Timeline
+   version = "3.0">
+   <TimelineItems>
+      <LoggerValueHistoryTimelineItem
+         documentLocation = "#CharacterRangeLen=0&amp;CharacterRangeLoc=581&amp;EndingColumnNumber=26&amp;EndingLineNumber=11&amp;StartingColumnNumber=1&amp;StartingLineNumber=11&amp;Timestamp=496084829.845787"
+         lockedSize = "{800, 186}"
+         selectedRepresentationIndex = "0"
+         shouldTrackSuperviewWidth = "NO">
+      </LoggerValueHistoryTimelineItem>
+      <LoggerValueHistoryTimelineItem
+         documentLocation = "#CharacterRangeLen=27&amp;CharacterRangeLoc=393&amp;EndingColumnNumber=28&amp;EndingLineNumber=20&amp;StartingColumnNumber=1&amp;StartingLineNumber=20&amp;Timestamp=496084834.772773"
+         selectedRepresentationIndex = "0"
+         shouldTrackSuperviewWidth = "NO">
+      </LoggerValueHistoryTimelineItem>
+      <LoggerValueHistoryTimelineItem
+         documentLocation = "#CharacterRangeLen=18&amp;CharacterRangeLoc=544&amp;EndingColumnNumber=19&amp;EndingLineNumber=27&amp;StartingColumnNumber=1&amp;StartingLineNumber=27&amp;Timestamp=496084834.772773"
+         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.parseFragment(withContextElement: tableContext)
+
+for element in elements {
+	print(element.outerHTML)
+}
+
+/*:
+The same parser instance can be reusued:
+*/
+
+let bodyContext = HTMLElement(tagName: "body")
+elements = parser.parseFragment(withContextElement: 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=455&amp;EndingColumnNumber=26&amp;EndingLineNumber=23&amp;StartingColumnNumber=2&amp;StartingLineNumber=23&amp;Timestamp=495492881.371878"
+         lockedSize = "{775, 83}"
+         selectedRepresentationIndex = "1"
+         shouldTrackSuperviewWidth = "NO">
+      </LoggerValueHistoryTimelineItem>
+      <LoggerValueHistoryTimelineItem
+         documentLocation = "#CharacterRangeLen=24&amp;CharacterRangeLoc=672&amp;EndingColumnNumber=26&amp;EndingLineNumber=34&amp;StartingColumnNumber=2&amp;StartingLineNumber=34&amp;Timestamp=495493308.359844"
+         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=450&amp;EndingColumnNumber=26&amp;EndingLineNumber=21&amp;StartingColumnNumber=2&amp;StartingLineNumber=21&amp;Timestamp=495492881.372527"
+         lockedSize = "{775, 68}"
+         selectedRepresentationIndex = "1"
+         shouldTrackSuperviewWidth = "YES">
+      </LoggerValueHistoryTimelineItem>
+   </TimelineItems>
+</Timeline>

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

@@ -0,0 +1,81 @@
+//: [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.append(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.append(nodes)
+body.innerHTML
+
+/*:
+Enumerate child elements and perform DOM manipulation
+*/
+body.enumerateChildElements { (element, index, stop) -> Void in
+	if element.tagName == "div" {
+		let lorem = HTMLElement(tagName: "p")
+		lorem.textContent = "Lorem ipsum: \(index)"
+		element.append(lorem)
+	}
+}
+body.innerHTML
+
+/*:
+Remove nodes from the document
+*/
+body.removeChildNode(at: 1)
+body.innerHTML
+
+/*:
+Navigate to child and sibling nodes
+*/
+body.lastChild!.removeFromParentNode()
+let greenDiv = body.firstChild!.nextSibling!
+greenDiv.outerHTML
+
+/*:
+Manipulate the HTML directly
+*/
+greenDiv.innerHTML = "<ul><li>item 1<li>item 2"
+greenDiv.outerHTML
+
+/*:
+Iterate the DOM tree with custom filters
+*/
+let filter = HTMLNodeFilterBlock.filter { (node) -> HTMLNodeFilterValue in
+	if node.childNodesCount() != 1 {
+		return .reject
+	}
+	return .accept
+}
+
+for element in body.nodeIterator(showOptions: .element, filter: filter) {
+	(element as! AnyObject).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=571&amp;EndingColumnNumber=26&amp;EndingLineNumber=24&amp;StartingColumnNumber=1&amp;StartingLineNumber=24&amp;Timestamp=495493395.434491"
+         lockedSize = "{763, 104}"
+         selectedRepresentationIndex = "0"
+         shouldTrackSuperviewWidth = "YES">
+      </LoggerValueHistoryTimelineItem>
+      <LoggerValueHistoryTimelineItem
+         documentLocation = "#CharacterRangeLen=15&amp;CharacterRangeLoc=834&amp;EndingColumnNumber=22&amp;EndingLineNumber=33&amp;StartingColumnNumber=1&amp;StartingLineNumber=33&amp;Timestamp=495493408.111041"
+         lockedSize = "{763, 75}"
+         selectedRepresentationIndex = "0"
+         shouldTrackSuperviewWidth = "NO">
+      </LoggerValueHistoryTimelineItem>
+      <LoggerValueHistoryTimelineItem
+         documentLocation = "#CharacterRangeLen=1&amp;CharacterRangeLoc=1774&amp;EndingColumnNumber=44&amp;EndingLineNumber=77&amp;StartingColumnNumber=2&amp;StartingLineNumber=77&amp;Timestamp=496085091.150842"
+         lockedSize = "{763, 176}"
+         selectedRepresentationIndex = "1"
+         shouldTrackSuperviewWidth = "NO">
+      </LoggerValueHistoryTimelineItem>
+      <LoggerValueHistoryTimelineItem
+         documentLocation = "#CharacterRangeLen=14&amp;CharacterRangeLoc=835&amp;EndingColumnNumber=15&amp;EndingLineNumber=33&amp;StartingColumnNumber=1&amp;StartingLineNumber=33&amp;Timestamp=495493408.111552"
+         lockedSize = "{762, 70}"
+         selectedRepresentationIndex = "0"
+         shouldTrackSuperviewWidth = "NO">
+      </LoggerValueHistoryTimelineItem>
+      <LoggerValueHistoryTimelineItem
+         documentLocation = "#CharacterRangeLen=18&amp;CharacterRangeLoc=572&amp;EndingColumnNumber=19&amp;EndingLineNumber=24&amp;StartingColumnNumber=1&amp;StartingLineNumber=24&amp;Timestamp=495493395.435449"
+         lockedSize = "{752, 99}"
+         selectedRepresentationIndex = "0"
+         shouldTrackSuperviewWidth = "NO">
+      </LoggerValueHistoryTimelineItem>
+      <LoggerValueHistoryTimelineItem
+         documentLocation = "#CharacterRangeLen=1&amp;CharacterRangeLoc=1774&amp;EndingColumnNumber=16&amp;EndingLineNumber=77&amp;StartingColumnNumber=2&amp;StartingLineNumber=77&amp;Timestamp=496085091.151491"
+         lockedSize = "{763, 102}"
+         selectedRepresentationIndex = "1"
+         shouldTrackSuperviewWidth = "NO">
+      </LoggerValueHistoryTimelineItem>
+      <LoggerValueHistoryTimelineItem
+         documentLocation = "#CharacterRangeLen=33&amp;CharacterRangeLoc=1742&amp;EndingColumnNumber=39&amp;EndingLineNumber=77&amp;StartingColumnNumber=2&amp;StartingLineNumber=77&amp;Timestamp=496085091.151711"
+         lockedSize = "{759, 149}"
+         selectedRepresentationIndex = "1"
+         shouldTrackSuperviewWidth = "NO">
+      </LoggerValueHistoryTimelineItem>
+      <LoggerValueHistoryTimelineItem
+         documentLocation = "#CharacterRangeLen=32&amp;CharacterRangeLoc=1743&amp;EndingColumnNumber=19&amp;EndingLineNumber=77&amp;StartingColumnNumber=2&amp;StartingLineNumber=77&amp;Timestamp=496085091.151931"
+         lockedSize = "{763, 120}"
+         selectedRepresentationIndex = "1"
+         shouldTrackSuperviewWidth = "NO">
+      </LoggerValueHistoryTimelineItem>
+      <LoggerValueHistoryTimelineItem
+         documentLocation = "#CharacterRangeLen=14&amp;CharacterRangeLoc=1204&amp;EndingColumnNumber=15&amp;EndingLineNumber=51&amp;StartingColumnNumber=1&amp;StartingLineNumber=51&amp;Timestamp=495493441.437517"
+         lockedSize = "{763, 94}"
+         selectedRepresentationIndex = "0"
+         shouldTrackSuperviewWidth = "NO">
+      </LoggerValueHistoryTimelineItem>
+      <LoggerValueHistoryTimelineItem
+         documentLocation = "#CharacterRangeLen=14&amp;CharacterRangeLoc=1122&amp;EndingColumnNumber=15&amp;EndingLineNumber=45&amp;StartingColumnNumber=1&amp;StartingLineNumber=45&amp;Timestamp=495493427.982381"
+         lockedSize = "{760, 97}"
+         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=697&amp;EndingColumnNumber=15&amp;EndingLineNumber=26&amp;StartingColumnNumber=1&amp;StartingLineNumber=26&amp;Timestamp=495493395.437213"
+         lockedSize = "{763, 76}"
+         selectedRepresentationIndex = "0"
+         shouldTrackSuperviewWidth = "NO">
+      </LoggerValueHistoryTimelineItem>
+      <LoggerValueHistoryTimelineItem
+         documentLocation = "#CharacterRangeLen=14&amp;CharacterRangeLoc=983&amp;EndingColumnNumber=15&amp;EndingLineNumber=38&amp;StartingColumnNumber=1&amp;StartingLineNumber=38&amp;Timestamp=495493427.983236"
+         lockedSize = "{763, 92}"
+         selectedRepresentationIndex = "0"
+         shouldTrackSuperviewWidth = "NO">
+      </LoggerValueHistoryTimelineItem>
+      <LoggerValueHistoryTimelineItem
+         documentLocation = "#CharacterRangeLen=14&amp;CharacterRangeLoc=1030&amp;EndingColumnNumber=15&amp;EndingLineNumber=41&amp;StartingColumnNumber=1&amp;StartingLineNumber=41&amp;Timestamp=495493427.983458"
+         lockedSize = "{763, 83}"
+         selectedRepresentationIndex = "0"
+         shouldTrackSuperviewWidth = "NO">
+      </LoggerValueHistoryTimelineItem>
+      <LoggerValueHistoryTimelineItem
+         documentLocation = "#CharacterRangeLen=8&amp;CharacterRangeLoc=1089&amp;EndingColumnNumber=13&amp;EndingLineNumber=44&amp;StartingColumnNumber=5&amp;StartingLineNumber=44&amp;Timestamp=495493427.983688"
+         lockedSize = "{763, 73}"
+         selectedRepresentationIndex = "0"
+         shouldTrackSuperviewWidth = "NO">
+      </LoggerValueHistoryTimelineItem>
+      <LoggerValueHistoryTimelineItem
+         documentLocation = "#CharacterRangeLen=17&amp;CharacterRangeLoc=1601&amp;EndingColumnNumber=19&amp;EndingLineNumber=70&amp;StartingColumnNumber=2&amp;StartingLineNumber=70&amp;Timestamp=496085091.153628"
+         lockedSize = "{763, 92}"
+         selectedRepresentationIndex = "1"
+         shouldTrackSuperviewWidth = "NO">
+      </LoggerValueHistoryTimelineItem>
+      <LoggerValueHistoryTimelineItem
+         documentLocation = "#CharacterRangeLen=14&amp;CharacterRangeLoc=586&amp;EndingColumnNumber=15&amp;EndingLineNumber=21&amp;StartingColumnNumber=1&amp;StartingLineNumber=21&amp;Timestamp=495493395.438545"
+         lockedSize = "{763, 50}"
+         selectedRepresentationIndex = "0"
+         shouldTrackSuperviewWidth = "NO">
+      </LoggerValueHistoryTimelineItem>
+      <LoggerValueHistoryTimelineItem
+         documentLocation = "#CharacterRangeLen=9&amp;CharacterRangeLoc=826&amp;EndingColumnNumber=15&amp;EndingLineNumber=30&amp;StartingColumnNumber=1&amp;StartingLineNumber=30&amp;Timestamp=495493408.115325"
+         lockedSize = "{763, 50}"
+         selectedRepresentationIndex = "0"
+         shouldTrackSuperviewWidth = "YES">
+      </LoggerValueHistoryTimelineItem>
+      <LoggerValueHistoryTimelineItem
+         documentLocation = "#CharacterRangeLen=14&amp;CharacterRangeLoc=868&amp;EndingColumnNumber=15&amp;EndingLineNumber=33&amp;StartingColumnNumber=1&amp;StartingLineNumber=33&amp;Timestamp=495493408.115547"
+         lockedSize = "{763, 50}"
+         selectedRepresentationIndex = "0"
+         shouldTrackSuperviewWidth = "YES">
+      </LoggerValueHistoryTimelineItem>
+      <LoggerValueHistoryTimelineItem
+         documentLocation = "#CharacterRangeLen=8&amp;CharacterRangeLoc=927&amp;EndingColumnNumber=13&amp;EndingLineNumber=36&amp;StartingColumnNumber=5&amp;StartingLineNumber=36&amp;Timestamp=495493408.115762"
+         lockedSize = "{763, 50}"
+         selectedRepresentationIndex = "0"
+         shouldTrackSuperviewWidth = "NO">
+      </LoggerValueHistoryTimelineItem>
+      <LoggerValueHistoryTimelineItem
+         documentLocation = "#CharacterRangeLen=8&amp;CharacterRangeLoc=959&amp;EndingColumnNumber=9&amp;EndingLineNumber=38&amp;StartingColumnNumber=1&amp;StartingLineNumber=38&amp;Timestamp=495493427.985192"
+         lockedSize = "{763, 50}"
+         selectedRepresentationIndex = "0"
+         shouldTrackSuperviewWidth = "YES">
+      </LoggerValueHistoryTimelineItem>
+      <LoggerValueHistoryTimelineItem
+         documentLocation = "#CharacterRangeLen=17&amp;CharacterRangeLoc=1235&amp;EndingColumnNumber=19&amp;EndingLineNumber=48&amp;StartingColumnNumber=2&amp;StartingLineNumber=48&amp;Timestamp=495493441.440785"
+         lockedSize = "{763, 92}"
+         selectedRepresentationIndex = "1"
+         shouldTrackSuperviewWidth = "NO">
+      </LoggerValueHistoryTimelineItem>
+      <LoggerValueHistoryTimelineItem
+         documentLocation = "#CharacterRangeLen=18&amp;CharacterRangeLoc=1451&amp;EndingColumnNumber=19&amp;EndingLineNumber=64&amp;StartingColumnNumber=1&amp;StartingLineNumber=64&amp;Timestamp=496085091.155099"
+         lockedSize = "{740, 65}"
+         selectedRepresentationIndex = "0"
+         shouldTrackSuperviewWidth = "YES">
+      </LoggerValueHistoryTimelineItem>
+      <LoggerValueHistoryTimelineItem
+         documentLocation = "#CharacterRangeLen=18&amp;CharacterRangeLoc=1347&amp;EndingColumnNumber=19&amp;EndingLineNumber=58&amp;StartingColumnNumber=1&amp;StartingLineNumber=58&amp;Timestamp=496085092.425909"
+         lockedSize = "{740, 69}"
+         selectedRepresentationIndex = "0"
+         shouldTrackSuperviewWidth = "NO">
+      </LoggerValueHistoryTimelineItem>
+   </TimelineItems>
+</Timeline>

HTMLKit.playground/contents.xcplayground

@@ -0,0 +1,10 @@
+<?xml version="1.0" encoding="UTF-8" standalone="yes"?>
+<playground version='6.0' target-platform='macos' display-mode='rendered' last-migration='0800'>
+    <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            = "2.1.1"
+  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         = "Sources", "Sources/**/*.{h,m}"
+  s.private_header_files = [
+    'Sources/**/*{HTMLToken,HTMLTokens,HTMLTagToken,HTMLCharacterToken,HTMLCommentToken,HTMLDOCTYPEToken,HTMLEOFToken,HTMLTokenizer,HTMLTokenizerCharacters,HTMLTokenizerEntities,HTMLTokenizerStates,HTMLElementAdjustment,HTMLElementTypes,HTMLInputStreamReader,HTMLListOfActiveFormattingElements,HTMLParseErrorToken,HTMLParserInsertionModes,HTMLStackOfOpenElements,HTMLMarker,HTMLNode+Private,HTMLDocument+Private,HTMLCharacterData+Private,HTMLRange+Private,HTMLParser+Private,HTMLNodeIterator+Private,HTMLNodeTraversal,HTMLDOMUtils,CSSCodePoints,CSSInputStream}.h'
+  ]
+
+  s.requires_arc = true
+end

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

@@ -0,0 +1,116 @@
+<?xml version="1.0" encoding="UTF-8"?>
+<Scheme
+   LastUpgradeVersion = "0900"
+   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"
+      language = ""
+      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"
+      language = ""
+      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-macOS.xcscheme

@@ -0,0 +1,116 @@
+<?xml version="1.0" encoding="UTF-8"?>
+<Scheme
+   LastUpgradeVersion = "0900"
+   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-macOS"
+               ReferencedContainer = "container:HTMLKit.xcodeproj">
+            </BuildableReference>
+         </BuildActionEntry>
+      </BuildActionEntries>
+   </BuildAction>
+   <TestAction
+      buildConfiguration = "Debug"
+      selectedDebuggerIdentifier = "Xcode.DebuggerFoundation.Debugger.LLDB"
+      selectedLauncherIdentifier = "Xcode.DebuggerFoundation.Launcher.LLDB"
+      language = ""
+      shouldUseLaunchSchemeArgsEnv = "YES"
+      codeCoverageEnabled = "YES">
+      <Testables>
+         <TestableReference
+            skipped = "NO">
+            <BuildableReference
+               BuildableIdentifier = "primary"
+               BlueprintIdentifier = "625A14C219C7829400AD0C32"
+               BuildableName = "HTMLKitTests-macOS.xctest"
+               BlueprintName = "HTMLKitTests-macOS"
+               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-macOS"
+            ReferencedContainer = "container:HTMLKit.xcodeproj">
+         </BuildableReference>
+      </MacroExpansion>
+      <AdditionalOptions>
+      </AdditionalOptions>
+   </TestAction>
+   <LaunchAction
+      buildConfiguration = "Debug"
+      selectedDebuggerIdentifier = "Xcode.DebuggerFoundation.Debugger.LLDB"
+      selectedLauncherIdentifier = "Xcode.DebuggerFoundation.Launcher.LLDB"
+      language = ""
+      launchStyle = "0"
+      useCustomWorkingDirectory = "NO"
+      ignoresPersistentStateOnLaunch = "NO"
+      debugDocumentVersioning = "YES"
+      debugServiceExtension = "internal"
+      allowLocationSimulation = "YES">
+      <MacroExpansion>
+         <BuildableReference
+            BuildableIdentifier = "primary"
+            BlueprintIdentifier = "625A14AB19C7829400AD0C32"
+            BuildableName = "HTMLKit.framework"
+            BlueprintName = "HTMLKit-macOS"
+            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-macOS"
+            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,110 @@
+<?xml version="1.0" encoding="UTF-8"?>
+<Scheme
+   LastUpgradeVersion = "0900"
+   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"
+      language = ""
+      shouldUseLaunchSchemeArgsEnv = "YES"
+      codeCoverageEnabled = "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"
+      language = ""
+      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,83 @@
+<?xml version="1.0" encoding="UTF-8"?>
+<Scheme
+   LastUpgradeVersion = "0900"
+   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"
+      language = ""
+      shouldUseLaunchSchemeArgsEnv = "YES"
+      codeCoverageEnabled = "YES">
+      <Testables>
+      </Testables>
+      <AdditionalOptions>
+      </AdditionalOptions>
+   </TestAction>
+   <LaunchAction
+      buildConfiguration = "Debug"
+      selectedDebuggerIdentifier = "Xcode.DebuggerFoundation.Debugger.LLDB"
+      selectedLauncherIdentifier = "Xcode.DebuggerFoundation.Launcher.LLDB"
+      language = ""
+      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

@@ -4,4 +4,10 @@
    <FileRef
       location = "group:HTMLKit.xcodeproj">
    </FileRef>
+   <FileRef
+      location = "group:HTMLKit.playground">
+   </FileRef>
+   <FileRef
+      location = "group:Example/HTMLKitExample/HTMLKitExample.xcodeproj">
+   </FileRef>
 </Workspace>

HTMLKit/CSSAttributeSelector.h

@@ -1,30 +0,0 @@
-//
-//  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
-
-@interface CSSAttributeSelector : CSSSelector
-
-@property (nonatomic, assign) CSSAttributeSelectorType type;
-@property (nonatomic, strong, readonly) NSString *name;
-@property (nonatomic, strong, readonly) NSString *value;
-
-+ (instancetype)classSelector:(NSString *)className;
-+ (instancetype)idSelector:(NSString *)elementId;
-+ (instancetype)hasAttributeSelector:(NSString *)attributeName;
-
-- (instancetype)initWithType:(CSSAttributeSelectorType)type
-						attributeName:(NSString *)name
-			  attrbiuteValue:(NSString *)value;
-
-@end
-
-NS_ASSUME_NONNULL_END

HTMLKit/CSSCombinatorSelector.h

@@ -1,22 +0,0 @@
-//
-//  CSSCombinatorSelector.h
-//  HTMLKit
-//
-//  Created by Iska on 12/10/15.
-//  Copyright © 2015 BrainCookie. All rights reserved.
-//
-
-#import "CSSSelector.h"
-
-NS_ASSUME_NONNULL_BEGIN
-
-@interface CSSCombinatorSelector : CSSSelector
-
-+ (instancetype)childOfElementCombinator:(CSSSelector *)selector;
-+ (instancetype)descendantOfElementCombinator:(CSSSelector *)selector;
-+ (instancetype)adjacentSiblingCombinator:(CSSSelector *)selector;
-+ (instancetype)generalSiblingCombinator:(CSSSelector *)selector;
-
-@end
-
-NS_ASSUME_NONNULL_END

HTMLKit/CSSCompoundSelector.h

@@ -1,22 +0,0 @@
-//
-//  CSSCompoundSelector.h
-//  HTMLKit
-//
-//  Created by Iska on 18/10/15.
-//  Copyright © 2015 BrainCookie. All rights reserved.
-//
-
-#import "CSSSelector.h"
-
-NS_ASSUME_NONNULL_BEGIN
-
-@interface CSSCompoundSelector : CSSSelector
-
-+ (instancetype)andSelector:(NSArray<CSSSelector *> *)selectors;
-+ (instancetype)orSelector:(NSArray<CSSSelector *> *)selectors;
-
-- (void)addSelector:(CSSSelector *)selector;
-
-@end
-
-NS_ASSUME_NONNULL_END

HTMLKit/CSSInputStream.h

@@ -1,20 +0,0 @@
-//
-//  CSSInputStream.h
-//  HTMLKit
-//
-//  Created by Iska on 07/06/15.
-//  Copyright (c) 2015 BrainCookie. All rights reserved.
-//
-
-#import <Foundation/Foundation.h>
-#import "HTMLInputStreamReader.h"
-
-@interface CSSInputStream : HTMLInputStreamReader
-
-- (void)consumeWhitespace;
-- (NSString *)consumeIdentifier;
-- (NSString *)consumeStringWithEndingCodePoint:(UTF32Char)endingCodePoint;
-- (UTF32Char)consumeEscapedCodePoint;
-- (NSString *)consumeCombinator;
-
-@end

HTMLKit/CSSNthExpressionSelector.h

@@ -1,25 +0,0 @@
-//
-//  CSSNthExpressionSelector.h
-//  HTMLKit
-//
-//  Created by Iska on 10/10/15.
-//  Copyright © 2015 BrainCookie. All rights reserved.
-//
-
-#import "CSSSelector.h"
-
-NS_ASSUME_NONNULL_BEGIN
-
-@interface CSSNthExpressionSelector : CSSSelector
-
-@property (nonatomic, strong, readonly) NSString *className;
-@property (nonatomic, assign, readonly) CSSNthExpression expression;
-
-+ (instancetype)nthChildSelector:(CSSNthExpression)expression;
-+ (instancetype)nthLastChildSelector:(CSSNthExpression)expression;
-+ (instancetype)nthOfTypeSelector:(CSSNthExpression)expression;
-+ (instancetype)nthLastOfTypeSelector:(CSSNthExpression)expression;
-
-@end
-
-NS_ASSUME_NONNULL_END

HTMLKit/CSSPseudoFunctionSelector.h

@@ -1,20 +0,0 @@
-//
-//  CSSPseudoFunctionSelector.h
-//  HTMLKit
-//
-//  Created by Iska on 07/10/15.
-//  Copyright © 2015 BrainCookie. All rights reserved.
-//
-
-#import "CSSSelector.h"
-
-NS_ASSUME_NONNULL_BEGIN
-
-@interface CSSPseudoFunctionSelector : CSSSelector
-
-+ (instancetype)notSelector:(CSSSelector *)selector;
-+ (instancetype)hasSelector:(CSSSelector *)selector;
-
-@end
-
-NS_ASSUME_NONNULL_END

HTMLKit/CSSSelector.h

@@ -1,49 +0,0 @@
-//
-//  HTMLSelector.h
-//  HTMLKit
-//
-//  Created by Iska on 02/05/15.
-//  Copyright (c) 2015 BrainCookie. All rights reserved.
-//
-
-#import <Foundation/Foundation.h>
-
-#pragma mark - Attribute Selector Type
-
-typedef NS_ENUM(NSUInteger, CSSAttributeSelectorType)
-{
-	CSSAttributeSelectorExists,
-	CSSAttributeSelectorExactMatch,
-	CSSAttributeSelectorIncludes,
-	CSSAttributeSelectorBegins,
-	CSSAttributeSelectorEnds,
-	CSSAttributeSelectorContains,
-	CSSAttributeSelectorHyphen,
-	CSSAttributeSelectorNot
-};
-
-#pragma mark - 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;
-
-@interface CSSSelector : NSObject 
-
-- (BOOL)acceptElement:(nonnull HTMLElement *)element;
-
-@end

HTMLKit/CSSSelectorParser.h

@@ -1,17 +0,0 @@
-//
-//  CSSSelectorParser.h
-//  HTMLKit
-//
-//  Created by Iska on 02/10/15.
-//  Copyright © 2015 BrainCookie. All rights reserved.
-//
-
-#import <Foundation/Foundation.h>
-
-@class CSSSelector;
-
-@interface CSSSelectorParser : NSObject
-
-+ (CSSSelector *)parseSelector:(NSString *)string error:(NSError **)error;
-
-@end

HTMLKit/CSSSelectors.h

@@ -1,71 +0,0 @@
-//
-//  CSSSelectors.h
-//  HTMLKit
-//
-//  Created by Iska on 14/05/15.
-//  Copyright (c) 2015 BrainCookie. All rights reserved.
-//
-
-#import "CSSSelector.h"
-#import "CSSStructuralPseudoSelectors.h"
-
-NS_ASSUME_NONNULL_BEGIN
-
-#pragma mark - Type Selectors
-
-extern CSSSelector * universalSelector();
-extern CSSSelector * typeSelector(NSString *type);
-
-#pragma mark - Atribute Selectors
-
-extern CSSSelector * idSelector(NSString *elementId);
-extern CSSSelector * classSelector(NSString *className);
-extern CSSSelector * hasAttributeSelector(NSString *attribute);
-extern CSSSelector * attributeSelector(CSSAttributeSelectorType type,
-												 NSString *attribute,
-												 NSString *value);
-
-#pragma mark - Nth-Expression Selectors
-
-extern CSSSelector * nthChildSelector(CSSNthExpression expression);
-extern CSSSelector * nthLastChildSelector(CSSNthExpression expression);
-extern CSSSelector * nthOfTypeSelector(CSSNthExpression expression);
-extern CSSSelector * nthLastOfTypeSelector(CSSNthExpression expression);
-
-extern CSSSelector * oddSelector();
-extern CSSSelector * evenSlector();
-
-extern CSSSelector * firstChildSelector();
-extern CSSSelector * lastChildSelector();
-extern CSSSelector * firstOfTypeSelector();
-extern CSSSelector * lastOfTypeSelector();
-
-extern CSSSelector * onlyChildSelector();
-extern CSSSelector * onlyOfTypeSelector();
-
-#pragma mark - Combinators
-
-extern CSSSelector * childOfElementSelector(CSSSelector *selector);
-extern CSSSelector * descendantOfElementSelector(CSSSelector *selector);
-extern CSSSelector * adjacentSiblingSelector(CSSSelector *selector);
-extern CSSSelector * generalSiblingSelector(CSSSelector *selector);
-
-#pragma mark - Pseudo Functions
-
-extern CSSSelector * nay(CSSSelector *selector);
-extern CSSSelector * has(CSSSelector *selector);
-
-#pragma mark - Compound Selectors
-
-extern CSSSelector * allOf(NSArray<CSSSelector *> *selectors);
-extern CSSSelector * anyOf(NSArray<CSSSelector *> *selectors);
-
-#pragma mark - Pseudo
-
-extern CSSSelector * namedPseudoSelector(NSString *name, CSSSelector *selector);
-
-#pragma mark - Block
-
-extern CSSSelector * namedBlockSelector(NSString *name, BOOL (^ acceptBlock)(HTMLElement *element));
-
-NS_ASSUME_NONNULL_END

HTMLKit/CSSStructuralPseudoSelectors.h

@@ -1,40 +0,0 @@
-//
-//  CSSStructuralPseudoSelector.h
-//  HTMLKit
-//
-//  Created by Iska on 11/10/15.
-//  Copyright © 2015 BrainCookie. All rights reserved.
-//
-
-@class CSSSelector;
-
-NS_ASSUME_NONNULL_BEGIN
-
-extern CSSSelector * rootSelector();
-extern CSSSelector * emptySelector();
-extern CSSSelector * parentSelector();
-
-extern CSSSelector * buttonSelector();
-extern CSSSelector * checkboxSelector();
-extern CSSSelector * fileSelector();
-extern CSSSelector * headerSelector();
-extern CSSSelector * imageSelector();
-extern CSSSelector * inputSelector();
-extern CSSSelector * linkSelector();
-extern CSSSelector * passwordSelector();
-extern CSSSelector * radioSelector();
-extern CSSSelector * resetSelector();
-extern CSSSelector * submitSelector();
-extern CSSSelector * textSelector();
-
-extern CSSSelector * enabledSelector();
-extern CSSSelector * disabledSelector();
-extern CSSSelector * checkedSelector();
-extern CSSSelector * optionalSelector();
-extern CSSSelector * requiredSelector();
-
-extern CSSSelector * ltSelector();
-extern CSSSelector * gtSelector();
-extern CSSSelector * eqSelector();
-
-NS_ASSUME_NONNULL_END

HTMLKit/HTMLCharacterToken.h

@@ -1,27 +0,0 @@
-//
-//  HTMLCharacterToken.h
-//  HTMLKit
-//
-//  Created by Iska on 23/10/14.
-//  Copyright (c) 2014 BrainCookie. All rights reserved.
-//
-
-#import <Foundation/Foundation.h>
-#import "HTMLToken.h"
-
-@interface HTMLCharacterToken : HTMLToken
-
-@property (nonatomic, copy) NSString *characters;
-
-- (instancetype)initWithString:(NSString *)string;
-
-- (void)appendString:(NSString *)string;
-- (BOOL)isWhitespaceToken;
-- (BOOL)isEmpty;
-
-- (void)retainLeadingWhitespace;
-- (void)trimLeadingWhitespace;
-- (void)trimFormIndex:(NSUInteger)index;
-- (HTMLCharacterToken *)tokenBySplitingLeadingWhiteSpace;
-
-@end

HTMLKit/HTMLComment.h

@@ -1,17 +0,0 @@
-//
-//  HTMLComment.h
-//  HTMLKit
-//
-//  Created by Iska on 25/02/15.
-//  Copyright (c) 2015 BrainCookie. All rights reserved.
-//
-
-#import "HTMLNode.h"
-
-@interface HTMLComment : HTMLNode
-
-@property (nonatomic, copy) NSString *data;
-
-- (instancetype)initWithData:(NSString *)data;
-
-@end

HTMLKit/HTMLCommentToken.h

@@ -1,20 +0,0 @@
-//
-//  HTMLCommentToken.h
-//  HTMLKit
-//
-//  Created by Iska on 23/10/14.
-//  Copyright (c) 2014 BrainCookie. All rights reserved.
-//
-
-#import <Foundation/Foundation.h>
-#import "HTMLToken.h"
-
-@interface HTMLCommentToken : HTMLToken
-
-@property (nonatomic, copy) NSString *data;
-
-- (instancetype)initWithData:(NSString *)data;
-
-- (void)appendStringToData:(NSString *)string;
-
-@end

HTMLKit/HTMLDOCTYPEToken.h

@@ -1,25 +0,0 @@
-//
-//  HTMLDOCTYPEToken.h
-//  HTMLKit
-//
-//  Created by Iska on 23/10/14.
-//  Copyright (c) 2014 BrainCookie. All rights reserved.
-//
-
-#import <Foundation/Foundation.h>
-#import "HTMLToken.h"
-
-@interface HTMLDOCTYPEToken : HTMLToken
-
-@property (nonatomic, copy) NSString *name;
-@property (nonatomic, strong) NSMutableString *publicIdentifier;
-@property (nonatomic, strong) NSMutableString *systemIdentifier;
-@property (nonatomic, assign) BOOL forceQuirks;
-
-- (instancetype)initWithName:(NSString *)name;
-
-- (void)appendStringToName:(NSString *)string;
-- (void)appendStringToPublicIdentifier:(NSString *)string;
-- (void)appendStringToSystemIdentifier:(NSString *)string;
-
-@end

HTMLKit/HTMLDocument.h

@@ -1,44 +0,0 @@
-//
-//  HTMLDocument.h
-//  HTMLKit
-//
-//  Created by Iska on 25/02/15.
-//  Copyright (c) 2015 BrainCookie. All rights reserved.
-//
-
-#import "HTMLNode.h"
-#import "HTMLDocumentType.h"
-#import "HTMLQuirksMode.h"
-
-typedef NS_ENUM(short, HTMLDocumentReadyState)
-{
-	HTMLDocumentLoading,
-	HTMLDocumentInteractive, // Not used
-	HTMLDocumentComplete
-};
-
-@interface HTMLDocument : HTMLNode
-
-@property (nonatomic, strong) HTMLDocumentType *documentType;
-
-@property (nonatomic, assign) HTMLQuirksMode quirksMode;
-
-@property (nonatomic, copy, readonly) NSString *compatMode;
-
-@property (nonatomic, assign, readonly) HTMLDocumentReadyState readyState;
-
-@property (nonatomic, strong) HTMLElement *rootElement;
-
-@property (nonatomic, strong) HTMLElement *documentElement;
-
-@property (nonatomic, strong) HTMLElement *head;
-
-@property (nonatomic, strong) HTMLElement *body;
-
-+ (instancetype)documentWithString:(NSString *)string;
-
-- (HTMLNode *)adoptNode:(HTMLNode *)node;
-
-- (HTMLDocument *)associatedInertTemplateDocument;
-
-@end

HTMLKit/HTMLDocumentFragment.h

@@ -1,15 +0,0 @@
-//
-//  HTMLDocumentFragment.h
-//  HTMLKit
-//
-//  Created by Iska on 12/04/15.
-//  Copyright (c) 2015 BrainCookie. All rights reserved.
-//
-
-#import "HTMLNode.h"
-
-@interface HTMLDocumentFragment : HTMLNode
-
-- (instancetype)initWithDocument:(HTMLDocument *)document;
-
-@end

HTMLKit/HTMLDocumentType.h

@@ -1,25 +0,0 @@
-//
-//  HTMLDocumentType.h
-//  HTMLKit
-//
-//  Created by Iska on 25/02/15.
-//  Copyright (c) 2015 BrainCookie. All rights reserved.
-//
-
-#import "HTMLNode.h"
-#import "HTMLQuirksMode.h"
-
-@interface HTMLDocumentType : HTMLNode
-
-@property (nonatomic, copy, readonly) NSString *publicIdentifier;
-
-@property (nonatomic, copy, readonly) NSString *systemIdentifier;
-
-- (instancetype)initWithName:(NSString *)name
-			publicIdentifier:(NSString *)publicIdentifier
-			systemIdentifier:(NSString *)systemIdentifier;
-
-- (BOOL)isValid;
-- (HTMLQuirksMode)quirksMode;
-
-@end

HTMLKit/HTMLEOFToken.h

@@ -1,15 +0,0 @@
-//
-//  HTMLEOFToken.h
-//  HTMLKit
-//
-//  Created by Iska on 15/03/15.
-//  Copyright (c) 2015 BrainCookie. All rights reserved.
-//
-
-#import "HTMLToken.h"
-
-@interface HTMLEOFToken : HTMLToken
-
-+ (instancetype)token;
-
-@end

HTMLKit/HTMLElement.h

@@ -1,34 +0,0 @@
-//
-//  HTMLElement.h
-//  HTMLKit
-//
-//  Created by Iska on 05/10/14.
-//  Copyright (c) 2014 BrainCookie. All rights reserved.
-//
-
-#import <Foundation/Foundation.h>
-#import "HTMLNamespaces.h"
-#import "HTMLNode.h"
-
-@interface HTMLElement : HTMLNode
-
-@property (nonatomic, assign, readonly) HTMLNamespace htmlNamespace;
-
-@property (nonatomic, copy, readonly) NSString *tagName;
-
-@property (nonatomic, strong) NSMutableDictionary *attributes;
-
-@property (nonatomic, copy)	NSString *elementId;
-
-@property (nonatomic, copy)	NSString *className;
-
-- (instancetype)initWithTagName:(NSString *)tagName;
-- (instancetype)initWithTagName:(NSString *)tagName attributes:(NSDictionary *)attributes;
-- (instancetype)initWithTagName:(NSString *)tagName namespace:(HTMLNamespace)htmlNamespace attributes:(NSDictionary *)attributes;
-
-- (BOOL)hasAttribute:(NSString *)name;
-- (NSString *)objectForKeyedSubscript:(NSString *)name;
-- (void)setObject:(NSString *)value forKeyedSubscript:(NSString *)attribute;
-- (void)removeAttribute:(NSString *)name;
-
-@end

HTMLKit/HTMLInputStreamReader.h

@@ -1,46 +0,0 @@
-//
-//  HTMLInputStreamReader.h
-//  HTMLKit
-//
-//  Created by Iska on 15/09/14.
-//  Copyright (c) 2014 BrainCookie. All rights reserved.
-//
-
-#import <Foundation/Foundation.h>
-
-typedef void (^ HTMLStreamReaderErrorCallback)(NSString *reason);
-
-/**
- * HTML Input Stream Reader processor conforming to the HTML standard
- * http://www.whatwg.org/specs/web-apps/current-work/multipage/syntax.html#preprocessing-the-input-stream
- */
-@interface HTMLInputStreamReader : NSObject
-
-@property (nonatomic, readonly) NSString *string;
-@property (nonatomic, readonly) NSUInteger currentLocation;
-@property (nonatomic, copy) HTMLStreamReaderErrorCallback errorCallback;
-
-- (id)initWithString:(NSString *)string;
-
-- (UTF32Char)currentInputCharacter;
-- (UTF32Char)nextInputCharacter;
-- (UTF32Char)inputCharacterPointAtOffset:(NSUInteger)offset;
-
-- (UTF32Char)consumeNextInputCharacter;
-- (void)reconsumeCurrentInputCharacter;
-- (void)unconsumeCurrentInputCharacter;
-
-- (BOOL)consumeCharacter:(UTF32Char)character;
-- (BOOL)consumeNumber:(unsigned long long *)result;
-- (BOOL)consumeHexNumber:(unsigned long long *)result;
-- (BOOL)consumeString:(NSString *)string caseSensitive:(BOOL)caseSensitive;
-- (NSString *)consumeCharactersUpToCharactersInString:(NSString *)characters;
-- (NSString *)consumeCharactersUpToString:(NSString *)string;
-- (NSString *)consumeCharactersInString:(NSString *)characters;
-- (NSString *)consumeAlphanumericCharacters;
-
-- (void)markCurrentLocation;
-- (void)rewindToMarkedLocation;
-- (void)reset;
-
-@end

HTMLKit/HTMLKit-Prefix.pch

@@ -1,9 +0,0 @@
-//
-//  Prefix header
-//
-//  The contents of this file are implicitly included at the beginning of every source file.
-//
-
-#ifdef __OBJC__
-	#import <Foundation/Foundation.h>
-#endif

HTMLKit/HTMLKit.h

@@ -1,12 +0,0 @@
-//
-//  HTMLKit.h
-//  HTMLKit
-//
-//  Created by Iska on 15/09/14.
-//  Copyright (c) 2014 BrainCookie. All rights reserved.
-//
-
-#import "HTMLParser.h"
-#import "HTMLDOM.h"
-#import "CSSSelectors.h"
-#import "HTMLKitErrorDomain.h"

HTMLKit/HTMLKitDOMExceptions.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/HTMLKitDOMExceptions.m

@@ -1,13 +0,0 @@
-//
-//  HTMLKitExceptions.m
-//  HTMLKit
-//
-//  Created by Iska on 17/03/15.
-//  Copyright (c) 2015 BrainCookie. All rights reserved.
-//
-
-#import "HTMLKitDOMExceptions.h"
-
-NSString * const HTMLKitHierarchyRequestError = @"HierarchyRequestError";
-NSString * const HTMLKitNotFoundError = @"NotFoundError";
-NSString * const HTMLKitNotSupportedError = @"NotSupportedError";

HTMLKit/HTMLListOfActiveFormattingElements.h

@@ -1,38 +0,0 @@
-//
-//  HTMLListOfActiveFormattingElements.h
-//  HTMLKit
-//
-//  Created by Iska on 22/03/15.
-//  Copyright (c) 2015 BrainCookie. All rights reserved.
-//
-
-#import <Foundation/Foundation.h>
-#import "HTMLElement.h"
-
-@interface HTMLListOfActiveFormattingElements : NSObject
-
-- (id)objectAtIndexedSubscript:(NSUInteger)index;
-- (void)setObject:(id)obj atIndexedSubscript:(NSUInteger)idx;
-- (NSUInteger)indexOfElement:(id)node;
-
-- (void)addElement:(HTMLElement *)element;
-- (void)removeElement:(id)element;
-- (BOOL)containsElement:(id)element;
-
-- (void)insertElement:(HTMLElement *)element atIndex:(NSUInteger)index;
-- (void)replaceElementAtIndex:(NSUInteger)index withElement:(HTMLElement *)element;
-
-- (id)lastEntry;
-
-- (void)addMarker;
-- (void)clearUptoLastMarker;
-
-- (HTMLElement *)formattingElementWithTagName:(NSString *)tagName;
-
-- (NSUInteger)count;
-- (BOOL)isEmpty;
-
-- (NSEnumerator *)enumerator;
-- (NSEnumerator *)reverseObjectEnumerator;
-
-@end

HTMLKit/HTMLMarker.h

@@ -1,15 +0,0 @@
-//
-//  HTMLMarker.h
-//  HTMLKit
-//
-//  Created by Iska on 02/03/15.
-//  Copyright (c) 2015 BrainCookie. All rights reserved.
-//
-
-#import <Foundation/Foundation.h>
-
-@interface HTMLMarker : NSObject
-
-+ (instancetype)marker;
-
-@end

HTMLKit/HTMLNamespaces.h

@@ -1,17 +0,0 @@
-//
-//  HTMLNamespaces.h
-//  HTMLKit
-//
-//  Created by Iska on 03/11/14.
-//  Copyright (c) 2014 BrainCookie. All rights reserved.
-//
-
-typedef NS_ENUM(NSInteger, HTMLNamespace)
-{
-	HTMLNamespaceHTML,
-	HTMLNamespaceMathML,
-	HTMLNamespaceSVG,
-	HTMLNamespaceXLink,
-	HTMLNamespaceXML,
-	HTMLNamespaceXMLNS,
-};

HTMLKit/HTMLNode.h

@@ -1,140 +0,0 @@
-//
-//  HTMLNode.h
-//  HTMLKit
-//
-//  Created by Iska on 24/02/15.
-//  Copyright (c) 2015 BrainCookie. All rights reserved.
-//
-
-#import <Foundation/Foundation.h>
-#import "HTMLNodeIterator.h"
-
-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
-};
-
-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;
-
-@interface HTMLNode : NSObject <NSCopying>
-
-@property (nonatomic, assign, readonly) HTMLNodeType nodeType;
-
-@property (nonatomic, strong, readonly) NSString *name;
-
-@property (nonatomic, weak, readonly) HTMLDocument *ownerDocument;
-
-@property (nonatomic, weak, readonly) HTMLNode *parentNode;
-
-@property (nonatomic, weak, readonly) HTMLElement *parentElement;
-
-@property (nonatomic, strong, readonly) NSOrderedSet *childNodes;
-
-@property (nonatomic, strong, readonly) HTMLNode *firstChild;
-
-@property (nonatomic, strong, readonly) HTMLNode *lastChild;
-
-@property (nonatomic, strong, readonly) HTMLNode *previousSibling;
-
-@property (nonatomic, strong, readonly) HTMLNode *nextSibling;
-
-@property (nonatomic, strong, readonly) HTMLElement *previousSiblingElement;
-
-@property (nonatomic, strong, readonly) HTMLElement *nextSiblingElement;
-
-@property (nonatomic, copy) NSString *textContent;
-
-@property (nonatomic, strong, readonly)	NSString *outerHTML;
-
-@property (nonatomic, copy)	NSString *innerHTML;
-
-- (instancetype)init NS_UNAVAILABLE;
-
-- (instancetype)initWithName:(NSString *)name type:(HTMLNodeType)type;
-
-- (HTMLElement *)asElement;
-
-- (BOOL)hasChildNodes;
-
-- (BOOL)hasChildNodeOfType:(HTMLNodeType)type;
-
-- (NSUInteger)childNodesCount;
-
-- (HTMLNode *)childNodeAtIndex:(NSUInteger)index;
-
-- (NSUInteger)indexOfChildNode:(HTMLNode *)node;
-
-- (NSUInteger)childElementsCount;
-
-- (HTMLElement *)childElementAtIndex:(NSUInteger)index;
-
-- (NSUInteger)indexOfChildElement:(HTMLElement *)element;
-
-- (HTMLNode *)prependNode:(HTMLNode *)node;
-
-- (void)prependNodes:(NSArray *)nodes;
-
-- (HTMLNode *)appendNode:(HTMLNode *)node;
-
-- (void)appendNodes:(NSArray *)nodes;
-
-- (HTMLNode *)insertNode:(HTMLNode *)node beforeChildNode:(HTMLNode *)child;
-
-- (HTMLNode *)replaceChildNode:(HTMLNode *)node withNode:(HTMLNode *)replacement;
-
-- (void)replaceAllChildNodesWithNode:(HTMLNode *)node;
-
-- (void)removeFromParentNode;
-
-- (HTMLNode *)removeChildNode:(HTMLNode *)node;
-
-- (HTMLNode *)removeChildNodeAtIndex:(NSUInteger)index;
-
-- (void)reparentChildNodesIntoNode:(HTMLNode *)node;
-
-- (void)removeAllChildNodes;
-
-- (HTMLDocumentPosition)compareDocumentPositionWithNode:(HTMLNode *)node;
-- (BOOL)isDescendantOfNode:(HTMLNode *)node;
-- (BOOL)containsNode:(HTMLNode *)node;
-
-- (void)enumerateChildNodesUsingBlock:(void (^)(HTMLNode *node, NSUInteger idx, BOOL *stop))block;
-
-- (void)enumerateChildElementsUsingBlock:(void (^)(HTMLElement *element, NSUInteger idx, BOOL *stop))block;
-
-- (HTMLNodeIterator	*)nodeIterator;
-- (HTMLNodeIterator *)nodeIteratorWithShowOptions:(HTMLNodeFilterShowOptions)showOptions
-										   filter:(id<HTMLNodeFilter>)filter;
-- (HTMLNodeIterator *)nodeIteratorWithShowOptions:(HTMLNodeFilterShowOptions)showOptions
-									  filterBlock:(HTMLNodeFilterValue (^)(HTMLNode *node))filter;
-
-- (HTMLElement *)firstElementMatchingSelector:(CSSSelector *)selector;
-- (NSArray<HTMLElement *> *)elementsMatchingSelector:(CSSSelector *)selector;
-
-- (NSString *)treeDescription;
-
-@end

HTMLKit/HTMLNodeFilter.h

@@ -1,56 +0,0 @@
-//
-//  HTMLNodeFilter.h
-//  HTMLKit
-//
-//  Created by Iska on 27/05/15.
-//  Copyright (c) 2015 BrainCookie. All rights reserved.
-//
-
-#import <Foundation/Foundation.h>
-
-typedef NS_ENUM(unsigned short, HTMLNodeFilterValue)
-{
-	HTMLNodeFilterAccept = 1,
-	HTMLNodeFilterReject = 2,
-	HTMLNodeFilterSkip = 3
-};
-
-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;
-
-@protocol HTMLNodeFilter <NSObject>
-
-- (HTMLNodeFilterValue)acceptNode:(HTMLNode *)node;
-
-@end
-
-#pragma mark - Block Filter
-
-@interface HTMLNodeFilterBlock : NSObject <HTMLNodeFilter>
-
-+ (instancetype)filterWithBlock:(HTMLNodeFilterValue (^)(HTMLNode *node))block;
-
-@end
-
-#pragma mark - CSS Selector Filter
-
-@class CSSSelector;
-
-@interface HTMLSelectorNodeFilter : NSObject <HTMLNodeFilter>
-
-+ (instancetype)filterWithSelector:(CSSSelector *)selector;
-
-@end

HTMLKit/HTMLNodeIterator.h

@@ -1,36 +0,0 @@
-//
-//  HTMLNodeIterator.h
-//  HTMLKit
-//
-//  Created by Iska on 27/05/15.
-//  Copyright (c) 2015 BrainCookie. All rights reserved.
-//
-
-#import <Foundation/Foundation.h>
-#import "HTMLNodeFilter.h"
-
-@class HTMLNode;
-
-@interface HTMLNodeIterator : NSEnumerator
-
-@property (nonatomic, strong, readonly) HTMLNode *root;
-@property (nonatomic, strong, readonly) HTMLNode *referenceNode;
-@property (nonatomic, assign, readonly) BOOL pointerBeforeReferenceNode;
-@property (nonatomic, assign, readonly) HTMLNodeFilterShowOptions whatToShow;
-@property (nonatomic, strong, readonly) id<HTMLNodeFilter> filter;
-
-+ (instancetype)iteratorWithNode:(HTMLNode *)node
-					 showOptions:(HTMLNodeFilterShowOptions)showOptions
-						  filter:(HTMLNodeFilterValue (^)(HTMLNode *node))filter;
-
-- (instancetype)initWithNode:(HTMLNode *)node;
-- (instancetype)initWithNode:(HTMLNode *)node
-					  filter:(id<HTMLNodeFilter>)filter;
-- (instancetype)initWithNode:(HTMLNode *)node
-				 showOptions:(HTMLNodeFilterShowOptions)showOptions
-					  filter:(id<HTMLNodeFilter>)filter;
-
-- (HTMLNode *)nextNode;
-- (HTMLNode *)previousNode;
-
-@end

HTMLKit/HTMLOrderedDictionary.h

@@ -1,29 +0,0 @@
-//
-//  HTMLOrderedDictionary.h
-//  HTMLKit
-//
-//  Created by Iska on 14/03/15.
-//  Copyright (c) 2015 BrainCookie. All rights reserved.
-//
-
-#import <Foundation/Foundation.h>
-
-NS_ASSUME_NONNULL_BEGIN
-
-@interface HTMLOrderedDictionary<KeyType, ObjectType> : NSMutableDictionary<KeyType, ObjectType>
-
-- (ObjectType)objectAtIndex:(NSUInteger)index;
-- (void)setObject:(ObjectType)anObject forKey:(KeyType<NSCopying>)aKey atIndex:(NSUInteger)index;
-- (void)removeObjectAtIndex:(NSUInteger)index;
-- (void)replaceKeyValueAtIndex:(NSUInteger)index withObject:(ObjectType)anObject andKey:(KeyType<NSCopying>)aKey;
-- (void)replaceKey:(KeyType<NSCopying>)aKey withKey:(KeyType<NSCopying>)newKey;
-- (NSUInteger)indexOfKey:(KeyType<NSCopying>)aKey;
-
-- (ObjectType)objectAtIndexedSubscript:(NSUInteger)index;
-- (void)setObject:(ObjectType)obj atIndexedSubscript:(NSUInteger)index;
-
-- (NSEnumerator *)reverseKeyEnumerator;
-
-@end
-
-NS_ASSUME_NONNULL_END

HTMLKit/HTMLParseErrorToken.h

@@ -1,19 +0,0 @@
-//
-//  HTMLParseErrorToken.h
-//  HTMLKit
-//
-//  Created by Iska on 23/10/14.
-//  Copyright (c) 2014 BrainCookie. All rights reserved.
-//
-
-#import <Foundation/Foundation.h>
-#import "HTMLToken.h"
-
-@interface HTMLParseErrorToken : HTMLToken
-
-@property (nonatomic, copy) NSString *reason;
-@property (nonatomic, assign) NSUInteger location;
-
-- (instancetype)initWithReasonMessage:(NSString *)reason andStreamLocation:(NSUInteger)location;
-
-@end

HTMLKit/HTMLParseErrorToken.m

@@ -1,38 +0,0 @@
-//
-//  HTMLParseErrorToken.m
-//  HTMLKit
-//
-//  Created by Iska on 23/10/14.
-//  Copyright (c) 2014 BrainCookie. All rights reserved.
-//
-
-#import "HTMLParseErrorToken.h"
-
-@interface HTMLParseErrorToken ()
-{
-	NSString *_reason;
-	NSUInteger _location;
-}
-@end
-
-@implementation HTMLParseErrorToken
-@synthesize reason = _reason;
-@synthesize location = _location;
-
-- (instancetype)initWithReasonMessage:(NSString *)reason andStreamLocation:(NSUInteger)location
-{
-	self = [super init];
-	if (self) {
-		self.type = HTMLTokenTypeParseError;
-		_reason = [reason copy];
-		_location = location;
-	}
-	return self;
-}
-
-- (NSString *)description
-{
-	return [NSString stringWithFormat:@"<%@: %p Reason='%@' Location='%lu'>", self.class, self, _reason, _location];
-}
-
-@end

HTMLKit/HTMLParser.h

@@ -1,22 +0,0 @@
-//
-//  HTMLParser.h
-//  HTMLKit
-//
-//  Created by Iska on 04/10/14.
-//  Copyright (c) 2014 BrainCookie. All rights reserved.
-//
-
-#import <Foundation/Foundation.h>
-#import "HTMLElement.h"
-
-@interface HTMLParser : NSObject
-
-@property (nonatomic, strong, readonly) NSArray *parseErrors;
-@property (nonatomic, strong, readonly) HTMLDocument *document;
-
-- (instancetype)initWithString:(NSString *)string;
-
-- (HTMLDocument *)parseDocument;
-- (NSArray *)parseFragmentWithContextElement:(HTMLElement *)contextElement;
-
-@end

HTMLKit/HTMLStackOfOpenElements.h

@@ -1,55 +0,0 @@
-//
-//  HTMLStackOfOpenElements.h
-//  HTMLKit
-//
-//  Created by Iska on 08/03/15.
-//  Copyright (c) 2015 BrainCookie. All rights reserved.
-//
-
-#import <Foundation/Foundation.h>
-#import "HTMLElement.h"
-
-@interface HTMLStackOfOpenElements : NSObject <NSFastEnumeration>
-
-- (HTMLElement *)currentNode;
-- (HTMLElement *)firstNode;
-- (HTMLElement *)lastNode;
-
-- (id)objectAtIndexedSubscript:(NSUInteger)index;
-- (void)setObject:(id)obj atIndexedSubscript:(NSUInteger)idx;
-- (NSUInteger)indexOfElement:(id)node;
-
-- (void)pushElement:(HTMLElement *)element;
-- (void)removeElement:(id)element;
-- (BOOL)containsElement:(id)element;
-- (BOOL)containsElementWithTagName:(NSString *)tagName;
-
-- (void)insertElement:(HTMLElement *)element atIndex:(NSUInteger)index;
-- (void)replaceElementAtIndex:(NSUInteger)index withElement:(HTMLElement *)element;
-
-- (void)popCurrentNode;
-- (void)popElementsUntilElementPoppedWithTagName:(NSString *)tagName;
-- (void)popElementsUntilAnElementPoppedWithAnyOfTagNames:(NSArray *)tagNames;
-- (void)popElementsUntilElementPopped:(HTMLElement *)element;
-- (void)popElementsUntilTemplateElementPopped;
-- (void)clearBackToTableContext;
-- (void)clearBackToTableBodyContext;
-- (void)clearBackToTableRowContext;
-- (void)popAll;
-
-- (HTMLElement *)hasElementInScopeWithTagName:(NSString *)tagName;
-- (HTMLElement *)hasAnyElementInScopeWithAnyOfTagNames:(NSArray *)tagNames;
-- (HTMLElement *)hasElementInListItemScopeWithTagName:(NSString *)tagName;
-- (HTMLElement *)hasElementInButtonScopeWithTagName:(NSString *)tagName;
-- (HTMLElement *)hasElementInTableScopeWithTagName:(NSString *)tagName;
-- (HTMLElement *)hasElementInTableScopeWithAnyOfTagNames:(NSArray *)tagNames;
-- (HTMLElement *)hasElementInSelectScopeWithTagName:(NSString *)tagName;
-- (HTMLElement *)furthestBlockAfterIndex:(NSUInteger)index;
-
-- (NSUInteger)count;
-- (BOOL)isEmpy;
-
-- (NSEnumerator *)enumerator;
-- (NSEnumerator *)reverseObjectEnumerator;
-
-@end

HTMLKit/HTMLText.h

@@ -1,19 +0,0 @@
-//
-//  HTMLText.h
-//  HTMLKit
-//
-//  Created by Iska on 26/02/15.
-//  Copyright (c) 2015 BrainCookie. All rights reserved.
-//
-
-#import "HTMLNode.h"
-
-@interface HTMLText : HTMLNode
-
-@property (nonatomic, copy) NSMutableString *data;
-
-- (instancetype)initWithData:(NSString *)data;
-
-- (void)appendString:(NSString *)string;
-
-@end

HTMLKit/HTMLText.m

@@ -1,78 +0,0 @@
-//
-//  HTMLText.m
-//  HTMLKit
-//
-//  Created by Iska on 26/02/15.
-//  Copyright (c) 2015 BrainCookie. All rights reserved.
-//
-
-#import "HTMLText.h"
-#import "HTMLElement.h"
-#import "NSString+HTMLKit.h"
-
-@implementation HTMLText
-
-- (instancetype)init
-{
-	return [self initWithData:@""];
-}
-
-- (instancetype)initWithData:(NSString *)data
-{
-	self = [super initWithName:@"#text" type:HTMLNodeText];
-	if (self) {
-		_data = [[NSMutableString alloc] initWithString:data ?: @""];
-	}
-	return self;
-}
-
-- (NSString *)textContent
-{
-	return [self.data copy];
-}
-
-- (void)setTextContent:(NSString *)textContent
-{
-	[self.data setString:textContent ?: @""];
-}
-
-- (void)appendString:(NSString *)string
-{
-	[self.data appendString:string];
-}
-
-#pragma mark - NSCopying
-
-- (id)copyWithZone:(NSZone *)zone
-{
-	HTMLText *copy = [super copyWithZone:zone];
-	copy.data = self.data;
-	return copy;
-}
-
-#pragma mark - Serialization
-
-- (NSString *)outerHTML
-{
-	if ([self.parentElement.tagName isEqualToAny:@"style", @"script", @"xmp", @"iframe", @"noembed", @"noframes",
-		 @"plaintext", @"noscript", nil]) {
-		return self.data;
-	} else {
-		NSRange range = NSMakeRange(0, self.data.length);
-		NSMutableString *escaped = [self.data mutableCopy];
-		[escaped replaceOccurrencesOfString:@"&" withString:@"&" options:0 range:range];
-		[escaped replaceOccurrencesOfString:@"\00A0" withString:@" " options:0 range:range];
-		[escaped replaceOccurrencesOfString:@"<" withString:@"&lt;" options:0 range:range];
-		[escaped replaceOccurrencesOfString:@">" withString:@"&gt;" options:0 range:range];
-		return escaped;
-	}
-}
-
-#pragma mark - Description
-
-- (NSString *)description
-{
-	return [NSString stringWithFormat:@"<%@: %p \"%@\">", self.class, self, self.data];
-}
-
-@end

HTMLKit/HTMLToken.h

@@ -1,54 +0,0 @@
-//
-//  HTMLToken.h
-//  HTMLKit
-//
-//  Created by Iska on 20/09/14.
-//  Copyright (c) 2014 BrainCookie. All rights reserved.
-//
-
-#import <Foundation/Foundation.h>
-
-@class HTMLDOCTYPEToken;
-@class HTMLTagToken;
-@class HTMLStartTagToken;
-@class HTMLEndTagToken;
-@class HTMLCommentToken;
-@class HTMLCharacterToken;
-@class HTMLParseErrorToken;
-
-NS_INLINE BOOL bothNilOrEqual(id first, id second) {
-	return (first == nil && second == nil) || ([first isEqual:second]);
-}
-
-typedef NS_ENUM(NSUInteger, HTMLTokenType)
-{
-	HTMLTokenTypeCharacter,
-	HTMLTokenTypeComment,
-	HTMLTokenTypeDoctype,
-	HTMLTokenTypeEndTag,
-	HTMLTokenTypeEOF,
-	HTMLTokenTypeParseError,
-	HTMLTokenTypeStartTag
-};
-
-@interface HTMLToken : NSObject
-
-@property (nonatomic, assign) HTMLTokenType type;
-
-- (BOOL)isDoctypeToken;
-- (BOOL)isStartTagToken;
-- (BOOL)isEndTagToken;
-- (BOOL)isCommentToken;
-- (BOOL)isCharacterToken;
-- (BOOL)isEOFToken;
-- (BOOL)isParseError;
-
-- (HTMLDOCTYPEToken *)asDoctypeToken;
-- (HTMLTagToken *)asTagToken;
-- (HTMLStartTagToken *)asStartTagToken;
-- (HTMLEndTagToken *)asEndTagToken;
-- (HTMLCommentToken *)asCommentToken;
-- (HTMLCharacterToken *)asCharacterToken;
-- (HTMLParseErrorToken *)asParseError;
-
-@end

HTMLKit/HTMLTokenizer.h

@@ -1,28 +0,0 @@
-//
-//  HTMLTokenizer.h
-//  HTMLKit
-//
-//  Created by Iska on 19/09/14.
-//  Copyright (c) 2014 BrainCookie. All rights reserved.
-//
-
-#import <Foundation/Foundation.h>
-#import "HTMLToken.h"
-#import "HTMLTokenizerStates.h"
-
-/**
- * HTML Tokenizer
- * https://html.spec.whatwg.org/multipage/syntax.html#tokenization
- */
-
-@class HTMLParser;
-
-@interface HTMLTokenizer : NSEnumerator
-
-@property (nonatomic, readonly) NSString *string;
-@property (nonatomic, assign) HTMLTokenizerState state;
-@property (nonatomic, weak, readonly) HTMLParser *parser;
-
-- (instancetype)initWithString:(NSString *)string;
-
-@end

HTMLKit/HTMLTokenizerEntities.h

@@ -1,16 +0,0 @@
-//
-//  HTMLTokenizerEntities.h
-//  HTMLKit
-//
-//  Created by Iska on 11/10/14.
-//  Copyright (c) 2014 BrainCookie. All rights reserved.
-//
-
-#import <Foundation/Foundation.h>
-
-@interface HTMLTokenizerEntities : NSObject
-
-+ (NSArray *)entities;
-+ (NSString *)replacementAtIndex:(NSUInteger)index;
-
-@end

HTMLKit/HTMLTreeWalker.h

@@ -1,36 +0,0 @@
-//
-//  HTMLTreeWalker.h
-//  HTMLKit
-//
-//  Created by Iska on 05/06/15.
-//  Copyright (c) 2015 BrainCookie. All rights reserved.
-//
-
-#import <Foundation/Foundation.h>
-#import "HTMLNodeFilter.h"
-
-@class HTMLNode;
-
-@interface HTMLTreeWalker : NSObject
-
-@property (nonatomic, strong, readonly) HTMLNode *root;
-@property (nonatomic, assign, readonly) HTMLNodeFilterShowOptions whatToShow;
-@property (nonatomic, strong, readonly) id<HTMLNodeFilter> filter;
-@property (nonatomic, strong) HTMLNode *currentNode;
-
-- (instancetype)initWithNode:(HTMLNode *)node;
-- (instancetype)initWithNode:(HTMLNode *)node
-					  filter:(id<HTMLNodeFilter>)filter;
-- (instancetype)initWithNode:(HTMLNode *)node
-				 showOptions:(HTMLNodeFilterShowOptions)showOptions
-					  filter:(id<HTMLNodeFilter>)filter;
-
-- (HTMLNode *)parentNode;
-- (HTMLNode *)firstChild;
-- (HTMLNode *)lastChild;
-- (HTMLNode *)previousSibling;
-- (HTMLNode *)nextSibling;
-- (HTMLNode *)previousNode;
-- (HTMLNode *)nextNode;
-
-@end

HTMLKit/NSCharacterSet+HTMLKit.h

@@ -1,17 +0,0 @@
-//
-//  NSCharacterSet+HTMLKit.h
-//  HTMLKit
-//
-//  Created by Iska on 14/05/15.
-//  Copyright (c) 2015 BrainCookie. All rights reserved.
-//
-
-#import <Foundation/Foundation.h>
-
-@interface NSCharacterSet (HTMLKit)
-
-+ (instancetype)HTMLWhitespaceCharacterSet;
-+ (instancetype)HTMLHexNumberCharacterSet;
-+ (instancetype)CSSNthExpressionCharacterSet;
-
-@end

HTMLKit/NSString+HTMLKit.h

@@ -1,19 +0,0 @@
-//
-//  NSString+HTMLKit.h
-//  HTMLKit
-//
-//  Created by Iska on 02/03/15.
-//  Copyright (c) 2015 BrainCookie. All rights reserved.
-//
-
-#import <Foundation/Foundation.h>
-
-@interface NSString (HTMLKit)
-
-- (BOOL)isEqualToStringIgnoringCase:(NSString *)aString;
-- (BOOL)isEqualToAny:(NSString *)first, ... NS_REQUIRES_NIL_TERMINATION;
-- (BOOL)hasPrefixIgnoringCase:(NSString *)aString;
-- (BOOL)isHTMLWhitespaceString;
-- (NSUInteger)leadingHTMLWhitespaceLength;
-
-@end

HTMLKit/en.lproj/InfoPlist.strings

@@ -1,2 +0,0 @@
-/* Localized versions of Info.plist keys */
-

HTMLKitTests/en.lproj/InfoPlist.strings

@@ -1,2 +0,0 @@
-/* Localized versions of Info.plist keys */
-

Package.swift

@@ -0,0 +1,6 @@
+import PackageDescription
+
+let package = Package(
+	name: "HTMLKit",
+	exclude: ["Tests/Fixtures", "Tests/css-tests", "Tests/html5lib-tests"]
+)

README.md

@@ -1,11 +1,327 @@
 # HTMLKit
 
-An Objective-C kit for your everyday HTML needs.
+![HTMLKit Logo](https://raw.githubusercontent.com/iabudiab/HTMLKit/master/HTMLKit.png)
+
+An Objective-C framework for your everyday HTML needs.
+
+[![Build Status](https://img.shields.io/travis/iabudiab/HTMLKit/master.svg?style=flat)](https://travis-ci.org/iabudiab/HTMLKit)
+[![codecov](https://codecov.io/gh/iabudiab/HTMLKit/branch/master/graph/badge.svg)](https://codecov.io/gh/iabudiab/HTMLKit)
+[![Carthage Compatible](https://img.shields.io/badge/Carthage-compatible-4BC51D.svg?style=flat)](https://github.com/Carthage/Carthage)
+[![CocoaPods Compatible](https://img.shields.io/cocoapods/v/HTMLKit.svg?style=flat)](https://cocoapods.org/pods/HTMLKit)
+[![CocoaDocs](https://img.shields.io/cocoapods/metrics/doc-percent/HTMLKit.svg?style=flat)](http://cocoadocs.org/docsets/HTMLKit)
+[![Platform](https://img.shields.io/cocoapods/p/HTMLKit.svg?style=flat)](http://cocoadocs.org/docsets/HTMLKit)
+[![License MIT](https://img.shields.io/badge/license-MIT-4481C7.svg?style=flat)](https://opensource.org/licenses/MIT)
+
+- [Quick Overview](#overview)
+- [Installation](#installation)
+- [Parsing](#parsing)
+- [The DOM](#the-dom)
+- [CSS3 Selectors](#css3-selectors)
 
 # Quick Overview
 
-HTMLKit is a [WHATWG](https://html.spec.whatwg.org/multipage/) specification-compliant library for parsing and serializing HTML documents and document fragments for OSX and iOS. HTMLKit parses real-world HTML the same way modern web browsers would.
+HTMLKit is a [WHATWG specification](https://html.spec.whatwg.org/multipage/)-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 provides a rich DOM implementation for manipulating and navigating the document tree. It also understands [CSS3 selectors](http://www.w3.org/TR/css3-selectors/) making node-selection and querying the DOM a piece of cake.
+
+## DOM Validation
+
+DOM mutations are validated as described in the [WHATWG DOM Standard](https://dom.spec.whatwg.org). Invalid DOM manipulations throw hierarchy-related exceptions. You can disable these validations, which will also increase the performance by about 20-30%, by defining the `HTMLKIT_NO_DOM_CHECKS` compiler constant.
+
+## Tests
+
+HTMLKit passes all of the [HTML5Lib](https://github.com/html5lib/html5lib-tests) Tokenizer and Tree Construction tests. The `html5lib-tests` is configured as a git-submodule. If you plan to run the tests, do not forget to pull it too.
+
+The CSS3 Selector implementation is tested with an adapted version of the [CSS3 Selectors Test Suite](http://www.w3.org/Style/CSS/Test/CSS3/Selectors/current/html/full/flat/index.html), ignoring the tests that require user interaction, session history, and scripting.
+
+## Does it Swift?
+
+Check out the playground!
+
+# Installation
+
+## Carthage
+
+[Carthage](https://github.com/Carthage/Carthage) is a decentralized dependency manager that builds your dependencies and provides you with binary frameworks.
+
+If you don't have Carthage yet, you can install it with Homebrew using the following command:
+
+```bash
+$ brew update
+$ brew install carthage
+```
+
+To add `HTMLKit` as a dependency into your project using Carthage just add the following line in your `Cartfile`:
+
+```
+github "iabudiab/HTMLKit"
+```
+
+Then run the following command to build the framework and drag the built `HTMLKit.framework` into your Xcode project.
+
+```bash
+$ carthage update
+```
+
+## CocoaPods
+
+[CocoaPods](http://cocoapods.org) is a dependency manager for Cocoa projects.
+
+If you don't have CocoaPods yet, you can install it with the following command:
+
+```bash
+$ gem install cocoapods
+```
+
+To add `HTMLKit` as a dependency into your project using CocoaPods just add the following in your `Podfile`:
+
+```ruby
+use_frameworks!
+
+target 'MyTarget' do
+  pod 'HTMLKit', '~> 2.0'
+end
+```
+
+Then, run the following command:
+
+```bash
+$ pod install
+```
+
+## Swift Package Manager
+
+[Swift Package Manager](https://github.com/apple/swift-package-manager) is the package manager for the Swift programming language.
+
+Add `HTMLKit` to your `Package.swift` dependecies:
+
+```swift
+.Package(url: "https://github.com/iabudiab/HTMLKit", majorVersion: 2)
+```
+
+Then run:
+
+```bash
+$ swift build
+```
+
+## Manually
+
+1- Add `HTMLKit` as git submodule
+
+```bash
+$ git submodule add https://github.com/iabudiab/HTMLKit.git
+```
+
+2- Open the `HTMLKit` folder and drag'n'drop the `HTMLKit.xcodeproj` into the Project Navigator in Xcode to add it as a sub-project.
+
+3- In the General panel of your target add `HTMLKit.framework` under the `Embedded Binaries` 
+
+# Parsing
+
+## Parsing Documents
+
+Given some HTML content, you can parse it either via the `HTMLParser` or instatiate a `HTMLDocument` directly:
+
+```objective-c
+NSString *htmlString = @"<div><h1>HTMLKit</h1><p>Hello there!</p></div>";
+
+// Via parser
+HTMLParser *parser = [[HTMLParser alloc] initWithString:htmlString];
+HTMLDocument *document = [parser parseDocument];
+
+// Via static initializer
+HTMLDocument *document = [HTMLDocument documentWithString:htmlString];
+```
+
+## Parsing Fragments
+
+You can also prase HTML content as a document fragment with a specified context element:
+
+```objective-c
+NSString *htmlString = @"<div><h1>HTMLKit</h1><p>Hello there!</p></div>";
+
+HTMLParser *parser = [[HTMLParser alloc] initWithString: htmlString];
+
+HTMLElement *tableContext = [[HTMLElement alloc] initWithTagName:@"table"];
+NSArray *nodes = [parser parseFragmentWithContextElement:tableContext];
+
+for (HTMLNode *node in nodes) {
+	NSLog(@"%@", node.outerHTML);
+}
+
+// The same parser instance can be reusued:
+HTMLElement *bodyContext = [[HTMLElement alloc] initWithTagName:@"body"];
+nodes = [parser parseFragmentWithContextElement:bodyContext];
+```
+
+# The DOM
+
+The DOM tree can be manipulated in several ways, here are just a few:
+
+* Create new elements and assign attributes
+
+```objective-c
+HTMLElement *description = [[HTMLElement alloc] initWithTagName:@"meta"  attributes: @{@"name": @"description"}];
+description[@"content"] = @"HTMLKit for iOS & OSX";
+```
+
+* Append nodes to the document
+
+```objective-c
+HTMLElement *head = document.head;
+[head appendNode:description];
+
+HTMLElement *body = document.body;
+NSArray *nodes = @[
+	[[HTMLElement alloc] initWithTagName:@"div" attributes: @{@"class": @"red"}],
+	[[HTMLElement alloc] initWithTagName:@"div" attributes: @{@"class": @"green"}],
+	[[HTMLElement alloc] initWithTagName:@"div" attributes: @{@"class": @"blue"}]
+];
+[body appendNodes:nodes];
+```
+
+* Enumerate child elements and perform DOM editing
+
+```objective-c
+[body enumerateChildElementsUsingBlock:^(HTMLElement *element, NSUInteger idx, BOOL *stop) {
+	if ([element.tagName isEqualToString:@"div"]) {
+		HTMLElement *lorem = [[HTMLElement alloc] initWithTagName:@"p"];
+		lorem.textContent = [NSString stringWithFormat:@"Lorem ipsum: %lu", (unsigned long)idx];
+		[element appendNode:lorem];
+	}
+}];
+```
+
+* Remove nodes from the document
+
+```objective-c
+[body removeChildNodeAtIndex:1];
+[head removeAllChildNodes];
+[body.lastChild removeFromParentNode];
+```
+
+* Manipulate the HTML directly
+
+```objective-c
+greenDiv.innerHTML = @"<ul><li>item 1<li>item 2";
+```
+
+* Navigate to child and sibling nodes
+
+```objective-c
+HTMLNode *firstChild = body.firstChild;
+HTMLNode *greenDiv = firstChild.nextSibling;
+```
+
+* Iterate the DOM tree with custom filters
+
+```objective-c
+HTMLNodeFilterBlock *filter =[HTMLNodeFilterBlock filterWithBlock:^ HTMLNodeFilterValue (HTMLNode *node) {
+	if (node.childNodesCount != 1) {
+		return HTMLNodeFilterReject;
+	}
+	return HTMLNodeFilterAccept;
+}];
+
+for (HTMLElement *element in [body nodeIteratorWithShowOptions:HTMLNodeFilterShowElement filter:filter]) {
+	NSLog(@"%@", element.outerHTML);
+}
+```
+
+* Create and manipulate DOM Ranges
+
+```objective-c
+HTMLDocument *document = [HTMLDocument documentWithString:@"<div><h1>HTMLKit</h1><p id='foo'>Hello there!</p></div>"];
+HTMLRange *range = [[HTMLRange alloc] initWithDocument:document];
+
+HTMLNode *paragraph = [document querySelector:@"#foo"];
+[range selectNode:paragraph];
+[range extractContents];
+```
+
+# CSS3 Selectors
+
+All CSS3 Selectors are supported except for the pseudo-elements (`::first-line`, `::first-letter`, ...etc.). You can use them the way you always have:
+
+```objective-c
+// Given the document:
+NSString *htmlString = @"<div><h1>HTMLKit</h1><p class='greeting'>Hello there!</p><p class='description'>This is a demo of HTMLKit</p></div>";
+HTMLDocument *document = [HTMLDocument documentWithString: htmlString];
+
+// Here are some of the supported selectors
+NSArray *paragraphs = [document querySelectorAll:@"p"];
+NSArray *paragraphsOrHeaders = [document querySelectorAll:@"p, h1"];
+NSArray *hasClassAttribute = [document querySelectorAll:@"[class]"];
+NSArray *greetings = [document querySelectorAll:@".greeting"];
+NSArray *classNameStartsWith_de = [document querySelectorAll:@"[class^='de']"];
+
+NSArray *hasAdjacentHeader = [document querySelectorAll:@"h1 + *"];
+NSArray *hasSiblingHeader = [document querySelectorAll:@"h1 ~ *"];
+NSArray *hasSiblingParagraph = [document querySelectorAll:@"p ~ *"];
+
+NSArray *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:
+
+```objective-c
+NSArray *paragraphs = [document elementsMatchingSelector:typeSelector(@"p")];
+NSArray *paragraphsOrHeaders = [document elementsMatchingSelector:
+	anyOf(@[
+		typeSelector(@"p"), typeSelector(@"h1")
+	])
+];
+
+NSArray *hasClassAttribute = [document elementsMatchingSelector:hasAttributeSelector(@"class")];
+NSArray *greetings = [document elementsMatchingSelector:classSelector(@"greeting")];
+NSArray *classNameStartsWith_de = [document elementsMatchingSelector:attributeSelector(CSSAttributeSelectorBegins, @"class", @"de")];
+
+NSArray *hasAdjacentHeader = [document elementsMatchingSelector:adjacentSiblingSelector(typeSelector(@"h1"))];
+NSArray *hasSiblingHeader = [document elementsMatchingSelector:generalSiblingSelector(typeSelector(@"h1"))];
+NSArray *hasSiblingParagraph = [document elementsMatchingSelector:generalSiblingSelector(typeSelector(@"p"))];
+
+NSArray *nonParagraphChildOfDiv = [document elementsMatchingSelector:
+	allOf(@[
+		childOfElementSelector(typeSelector(@"div")),
+		not(typeSelector(@"p"))
+	])
+];
+```
+
+Here are more examples:
+
+```objective-c
+HTMLNode *firstDivElement = [document firstElementMatchingSelector:typeSelector(@"div")];
+
+NSArray *secondChildOfDiv = [firstDivElement querySelectorAll:@":nth-child(2)"];
+NSArray *secondOfType = [firstDivElement querySelectorAll:@":nth-of-type(2n)"];
+
+secondChildOfDiv = [firstDivElement elementsMatchingSelector:nthChildSelector(CSSNthExpressionMake(0, 2))];
+secondOfType = [firstDivElement elementsMatchingSelector:nthOfTypeSelector(CSSNthExpressionMake(2, 0))];
+
+NSArray *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:
+
+```objective-c
+CSSSelector *myAwesomeSelector = namedBlockSelector(@"myAwesomeSelector", ^BOOL (HTMLElement *element) {
+	return ![element.tagName isEqualToString:@"p"] && ![element.tagName isEqualToString:@"div"];
+});
+notParagraphAndNotDiv = [firstDivElement elementsMatchingSelector:myAwesomeSelector];
+```
+
+# Change Log
+
+See the [CHANGELOG.md](CHANGELOG.md) for more info.
 
 # License
 
-HTMLKit is available under the MIT license. See the LICENSE file for more info.
+HTMLKit is available under the MIT license. See the [LICENSE](LICENSE) file for more info.

Sources/CSSAttributeSelector.m

@@ -41,7 +41,7 @@
 {
 	self = [super init];
 	if (self) {
-		self.type = type;
+		_type = type;
 		_name = [name copy];
 		_value = value ? [value copy]: @"";
 	}

Sources/CSSCombinatorSelector.m

@@ -8,6 +8,7 @@
 
 #import "CSSCombinatorSelector.h"
 #import "HTMLElement.h"
+#import "HTMLNode+Private.h"
 
 #pragma mark - Declarations
 

Sources/CSSInputStream.m

@@ -24,14 +24,14 @@
 
 - (NSString *)consumeIdentifier
 {
-	CFMutableStringRef value = CFStringCreateMutable(kCFAllocatorDefault, 0);
-
 	if (!isValidIdentifierStart([self inputCharacterPointAtOffset:0],
 								[self inputCharacterPointAtOffset:1],
 								[self inputCharacterPointAtOffset:2])) {
 		return nil;
 	}
 
+	CFMutableStringRef value = CFStringCreateMutable(kCFAllocatorDefault, 0);
+
 	while (YES) {
 		UTF32Char codePoint = [self consumeNextInputCharacter];
 		if (codePoint == EOF) {
@@ -47,7 +47,12 @@
 		}
 	}
 
-	return (__bridge NSString *)(CFStringGetLength(value) > 0 ? value : nil);
+	if (CFStringGetLength(value) > 0) {
+		return (__bridge_transfer NSString *)value;
+	}
+
+	CFRelease(value);
+	return nil;
 }
 
 - (NSString *)consumeStringWithEndingCodePoint:(UTF32Char)endingCodePoint
@@ -85,7 +90,12 @@
 		}
 	}
 
-	return (__bridge NSString *)(CFStringGetLength(value) > 0 ? value : nil);
+	if (CFStringGetLength(value) > 0) {
+		return (__bridge_transfer NSString *)value;
+	}
+
+	CFRelease(value);
+	return nil;
 }
 
 - (UTF32Char)consumeEscapedCodePoint
@@ -105,8 +115,8 @@
 			[self consumeNextInputCharacter];
 		}
 
-		NSScanner *scanner = [NSScanner scannerWithString:(__bridge NSString *)(hexString)];
-		UTF32Char number;
+		NSScanner *scanner = [NSScanner scannerWithString:(__bridge_transfer NSString *)(hexString)];
+		unsigned int number;
 		[scanner scanHexInt:&number];
 
 		return isValidEscapedCodePoint(number) ? number : REPLACEMENT_CHARACTER;

Sources/CSSNthExpressionSelector.m

@@ -8,6 +8,7 @@
 
 #import "CSSNthExpressionSelector.h"
 #import "HTMLElement.h"
+#import "HTMLNode+Private.h"
 
 #pragma mark - Nth-Expression
 
@@ -26,13 +27,13 @@ NSString * _Nonnull NSStringFromNthExpression(CSSNthExpression expression)
 	}
 
 	if (expression.an == 0) {
-		return [NSString stringWithFormat:@"%ld", expression.b];
+		return [NSString stringWithFormat:@"%ld", (long)expression.b];
 	}
 	if (expression.b == 0) {
-		return [NSString stringWithFormat:@"%ldn", expression.an];
+		return [NSString stringWithFormat:@"%ldn", (long)expression.an];
 	}
 
-	return [NSString stringWithFormat:@"%ldn%+ld", expression.an, expression.b];
+	return [NSString stringWithFormat:@"%ldn%+ld", (long)expression.an, (long)expression.b];
 }
 
 #pragma mark - Implementation

Sources/CSSPseudoFunctionSelector.m

@@ -8,6 +8,7 @@
 
 #import "CSSPseudoFunctionSelector.h"
 #import "HTMLElement.h"
+#import "HTMLNode+Private.h"
 
 #pragma mark - Declarations
 
@@ -72,8 +73,9 @@
 
 - (BOOL)acceptElement:(HTMLElement *)element
 {
-	for (HTMLNode *child in element.childNodes) {
-		if (child.nodeType == HTMLNodeElement && [self.selector acceptElement:child.asElement]) {
+	HTMLNodeIterator *iterator = [element nodeIteratorWithShowOptions:HTMLNodeFilterShowAll filter:nil];
+	for (HTMLNode *descendant in iterator) {
+		if (descendant.nodeType == HTMLNodeElement && [self.selector acceptElement:descendant.asElement]) {
 			return YES;
 		}
 	}

Sources/CSSSelector.m

@@ -8,9 +8,20 @@
 
 #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];

Sources/CSSSelectorParser.m

@@ -61,6 +61,11 @@
 
 #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 = @{
@@ -70,7 +75,7 @@
 							   CSSSelectorErrorLocationKey: @(location)
 							   };
 
-	if(error) {
+	if(error && *error == nil) {
 		*error = [NSError errorWithDomain:HTMLKitSelectorErrorDomain code:HTMLKitSelectorParseError userInfo:userInfo];
 	}
 }
@@ -102,7 +107,7 @@
 		_location += subSelector.length;
 	}
 
-	if (*error != nil) {
+	if (error && *error != nil) {
 		return nil;
 	}
 
@@ -204,7 +209,7 @@
 		{
 			NSString *elementId = [_inputStream consumeIdentifier];
 			if (elementId == nil) {
-				[self emitError:error reason:@"Invalid character" location:_location + _inputStream.currentLocation];
+				[self emitError:error reason:@"Invalid character"];
 				return nil;
 			}
 			return  idSelector(elementId);
@@ -213,7 +218,7 @@
 		{
 			NSString *className = [_inputStream consumeIdentifier];
 			if (className == nil) {
-				[self emitError:error reason:@"Invalid character" location:_location + _inputStream.currentLocation];
+				[self emitError:error reason:@"Invalid character"];
 				return nil;
 			}
 			return classSelector(className);
@@ -228,7 +233,7 @@
 		}
 		default:
 		{
-			[self emitError:error reason:@"Invalid character" location:_location + _inputStream.currentLocation];
+			[self emitError:error reason:@"Invalid character"];
 			return nil;
 		}
 	}
@@ -278,7 +283,7 @@
 
 	// Consume RIGHT_SQUARE_BRACKET
 	if (![_inputStream consumeCharacter:RIGHT_SQUARE_BRACKET]) {
-		[self emitError:error reason:@"Expected closing right square bracket ']'" location:_location + _inputStream.currentLocation];
+		[self emitError:error reason:@"Expected closing right square bracket ']'"];
 	}
 
 	if (type == CSSAttributeSelectorExists) {
@@ -295,7 +300,7 @@
 	if ([pseudoClass hasPrefix:@"nth"]) {
 		[_inputStream consumeWhitespace];
 		if (![_inputStream consumeCharacter:LEFT_PARENTHESIS]) {
-			[self emitError:error reason:@"Expected opening left parenthesis '('" location:_location + _inputStream.currentLocation];
+			[self emitError:error reason:@"Expected opening left parenthesis '('"];
 		}
 
 		NSString *functionExpression = [_inputStream consumeCharactersUpToString:@")"];
@@ -303,7 +308,7 @@
 
 		[_inputStream consumeWhitespace];
 		if (![_inputStream consumeCharacter:RIGHT_PARENTHESIS]) {
-			[self emitError:error reason:@"Expected closing right parenthesis ')'" location:_location + _inputStream.currentLocation];
+			[self emitError:error reason:@"Expected closing right parenthesis ')'"];
 		}
 
 		if ([pseudoClass isEqualToString:@"nth-child"]) {
@@ -318,16 +323,40 @@
 	} else if ([pseudoClass isEqualToString:@"not"]) {
 		[_inputStream consumeWhitespace];
 		if (![_inputStream consumeCharacter:LEFT_PARENTHESIS]) {
-			[self emitError:error reason:@"Expected opening left parenthesis '('" location:_location + _inputStream.currentLocation];
+			[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 ')'" location:_location + _inputStream.currentLocation];
+			[self emitError:error reason:@"Expected closing right parenthesis ')'"];
 		}
 
-		return nay(subSelector);
+		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();
@@ -358,9 +387,39 @@
 		} 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 location:_location + _inputStream.currentLocation];
+	[self emitError:error reason:reason];
 	return nil;
 }
 

Sources/CSSSelectors.m

@@ -140,7 +140,7 @@ CSSSelector * generalSiblingSelector(CSSSelector *selector)
 
 #pragma mark - Pseudo Functions
 
-CSSSelector * nay(CSSSelector *selector)
+CSSSelector * not(CSSSelector *selector)
 {
 	return [CSSPseudoFunctionSelector notSelector:selector];
 }

Sources/CSSStructuralPseudoSelectors.m

@@ -183,7 +183,7 @@ CSSSelector * enabledSelector()
 									typeSelector(@"menuitem"),
 									typeSelector(@"fieldset"),
 									]);
-	return namedPseudoSelector(@"enabled", allOf(@[candiate, nay(disabledSelector())]));
+	return namedPseudoSelector(@"enabled", allOf(@[candiate, not(disabledSelector())]));
 }
 
 CSSSelector * disabledSelector()
@@ -206,7 +206,7 @@ CSSSelector * disabledSelector()
 												]),
 										allOf(@[
 												descendantOfElementSelector(disabledFieldset),
-												nay(firstLegendDecendantDisabledFieldSet)
+												not(firstLegendDecendantDisabledFieldSet)
 												])
 										]);
 
@@ -249,7 +249,7 @@ CSSSelector * optionalSelector()
 									 typeSelector(@"select"),
 									 typeSelector(@"textarea")
 									 ]);
-	CSSSelector *noAttribute = nay(hasAttributeSelector(@"required"));
+	CSSSelector *noAttribute = not(hasAttributeSelector(@"required"));
 
 	return namedPseudoSelector(@"optional", allOf(@[candidate, noAttribute]));
 }
@@ -270,25 +270,37 @@ CSSSelector * requiredSelector()
 
 #pragma mark - Positional
 
-CSSSelector * ltSelector(NSUInteger index)
+CSSSelector * ltSelector(NSInteger index)
 {
-	NSString *name = [NSString stringWithFormat:@":lt(%lu)", (unsigned long)index];
+	NSString *name = [NSString stringWithFormat:@":lt(%ld)", (long)index];
 	return namedBlockSelector(name, ^BOOL(HTMLElement * _Nonnull element) {
-		return [element.parentElement indexOfChildNode:element] < index;
+		NSUInteger elementIndex = [element.parentElement indexOfChildNode:element];
+
+		if (index > 0) {
+			return elementIndex < index;
+		} else {
+			return elementIndex < element.parentElement.childNodesCount - index - 1;
+		}
 	});
 }
 
-CSSSelector * gtSelector(NSUInteger index)
+CSSSelector * gtSelector(NSInteger index)
 {
-	NSString *name = [NSString stringWithFormat:@":gt(%lu)", (unsigned long)index];
+	NSString *name = [NSString stringWithFormat:@":gt(%ld)", (long)index];
 	return namedBlockSelector(name, ^BOOL(HTMLElement * _Nonnull element) {
-		return [element.parentElement indexOfChildNode:element] > index;
+		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(%lu)", (unsigned long)index];
+	NSString *name = [NSString stringWithFormat:@":eq(%ld)", (long)index];
 	return namedBlockSelector(name, ^BOOL(HTMLElement * _Nonnull element) {
 		NSUInteger elementIndex = [element.parentElement indexOfChildNode:element];
 

Sources/HTMLCharacterData.m

@@ -0,0 +1,114 @@
+//
+//  HTMLCharacterData.m
+//  HTMLKit
+//
+//  Created by Iska on 26/11/16.
+//  Copyright © 2016 BrainCookie. All rights reserved.
+//
+
+#import "HTMLCharacterData.h"
+#import "HTMLNode+Private.h"
+#import "HTMLDocument+Private.h"
+#import "HTMLKitDOMExceptions.h"
+
+@interface HTMLCharacterData ()
+{
+	NSMutableString *_data;
+}
+@end
+
+@implementation HTMLCharacterData
+@synthesize data = _data;
+
+- (instancetype)initWithName:(NSString *)name type:(HTMLNodeType)type data:(NSString *)data
+{
+	self = [super initWithName:name type:type];
+	if (self) {
+		if (data) {
+			_data = [[NSMutableString alloc] initWithString:data];
+		}
+	}
+	return self;
+}
+
+- (NSString *)data
+{
+	if (_data == nil) {
+		_data = [[NSMutableString alloc] initWithString:@""];
+	}
+
+	return _data;
+}
+
+- (NSString *)textContent
+{
+	return [self.data copy];
+}
+
+- (void)setTextContent:(NSString *)textContent
+{
+	[self setData:textContent];
+}
+
+- (NSUInteger)length
+{
+	return self.data.length;
+}
+
+#pragma mark - Data
+
+NS_INLINE void CheckValidOffset(HTMLCharacterData *node, NSUInteger offset, NSString *cmd)
+{
+	if (offset > node.length) {
+		[NSException raise:HTMLKitIndexSizeError
+					format:@"%@: Index Size Error, invalid index %lu for character data node %@.",
+		 cmd, (unsigned long)offset, node];
+	}
+}
+
+- (void)setData:(NSString *)data
+{
+	[self replaceDataInRange:NSMakeRange(0, self.length) withData:data];
+}
+
+- (void)appendData:(NSString *)data
+{
+	[self replaceDataInRange:NSMakeRange(self.length, 0) withData:data];
+}
+
+- (void)insertData:(NSString *)data atOffset:(NSUInteger)offset
+{
+	[self replaceDataInRange:NSMakeRange(offset, 0) withData:data];
+}
+
+- (void)deleteDataInRange:(NSRange)range
+{
+	[self replaceDataInRange:range withData:@""];
+}
+
+- (void)replaceDataInRange:(NSRange)range withData:(NSString *)data
+{
+	CheckValidOffset(self, range.location, NSStringFromSelector(_cmd));
+
+	range.length = MIN(range.length, self.length - range.location);
+
+	[(NSMutableString *)self.data replaceCharactersInRange:range withString:data];
+	[self.ownerDocument didRemoveCharacterDataInNode:self atOffset:range.location withLength:range.length];
+	[self.ownerDocument didAddCharacterDataToNode:self atOffset:range.location withLength:data.length];
+}
+
+- (NSString *)substringDataWithRange:(NSRange)range
+{
+	return [_data substringWithRange:range];
+}
+
+#pragma mark - NSCopying
+
+- (id)copyWithZone:(NSZone *)zone
+{
+	HTMLCharacterData *copy = [super copyWithZone:zone];
+	copy->_data = [_data mutableCopy];
+	return copy;
+}
+
+@end

Sources/HTMLComment.m

@@ -7,40 +7,18 @@
 //
 
 #import "HTMLComment.h"
+#import "HTMLCharacterData+Private.h"
 
 @implementation HTMLComment
 
 - (instancetype)init
 {
-	return [self initWithData:nil];
+	return [self initWithData:@""];
 }
 
 - (instancetype)initWithData:(NSString *)data
 {
-	self = [super initWithName:@"#comment" type:HTMLNodeComment];
-	if (self) {
-		self.data = data ?: @"";
-	}
-	return self;
-}
-
-- (NSString *)textContent
-{
-	return self.data;
-}
-
-- (void)setTextContent:(NSString *)textContent
-{
-	self.data = textContent ?: @"";
-}
-
-#pragma mark - NSCopying
-
-- (id)copyWithZone:(NSZone *)zone
-{
-	HTMLComment *copy = [super copyWithZone:zone];
-	copy.data = self.data;
-	return copy;
+	return [super initWithName:@"#comment" type:HTMLNodeComment data:data];
 }
 
 #pragma mark - Serialization

Sources/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

Sources/HTMLDOMUtils.m

@@ -0,0 +1,32 @@
+//
+//  HTMLDOMUtils.m
+//  HTMLKit
+//
+//  Created by Iska on 03/12/16.
+//  Copyright © 2016 BrainCookie. All rights reserved.
+//
+
+#import "HTMLDOMUtils.h"
+#import "HTMLNode.h"
+
+extern HTMLNode * GetCommonAncestorContainer(HTMLNode *nodeA, HTMLNode *nodeB)
+{
+	for (HTMLNode *parentA = nodeA; parentA != nil; parentA = parentA.parentNode) {
+		for (HTMLNode *parentB = nodeB; parentB != nil; parentB = parentB.parentNode) {
+			if (parentA == parentB) {
+				return parentA;
+			}
+		}
+	}
+
+	return nil;
+}
+
+extern NSArray<HTMLNode *> * GetAncestorNodes(HTMLNode *node)
+{
+	NSMutableArray *ancestors = [NSMutableArray array];
+	for (HTMLNode *it = node; it; it = it.parentNode) {
+		[ancestors addObject:it];
+	}
+	return ancestors;
+}