init

Author: davidkudera

.gitignore

@@ -0,0 +1,4 @@
+.idea/
+node_modules/
+
+npm-debug.log

.travis.yml

@@ -0,0 +1,5 @@
+language: node_js
+
+node_js:
+  - "node"
+  - "iojs"

LICENSE

@@ -0,0 +1,21 @@
+The MIT License (MIT)
+
+Copyright (c) 2017 David Kudera
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in
+all copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN
+THE SOFTWARE.

README.md

@@ -0,0 +1,102 @@
+# Slicky/QuerySelector
+
+CSS selectors implemented in javascript
+
+This library does not depend on any javascript DOM parser and can be used in either browser or node environment.
+
+It can work with native DOM in browser, with parse5 or any other library.
+
+## Installation
+
+```
+$ npm install @slicky/query-selector
+```
+
+## Custom DocumentWalker
+
+First you will need to implement few methods, which will be used by this library to read the DOM.
+
+**Example of the simplest document walker:**
+
+```typescript
+import {IDocumentWalker, DocumentNode, DocumentParent} from '@slicky/query-selector';
+
+
+class CustomDocumentWalker implements IDocumentWalker
+{
+
+
+	public getNodeName(node: DocumentNode): string
+	{
+		return node.nodeName;
+	}
+
+
+	public isElement(node: DocumentNode): boolean
+	{
+		return node.type === 'string';
+	}
+
+
+	public isString(node: DocumentNode): boolean
+	{
+		return node.type === 'string';
+	}
+
+
+	public getParentNode(node: DocumentNode): DocumentParent
+	{
+		return node.parentNode;
+	}
+
+
+	public getChildNodes(parent: DocumentParent): Array<DocumentNode>
+	{
+		return parent.childNodes;
+	}
+
+
+	public getAttribute(node: DocumentNode, name: string): string
+	{
+		return node.attributes[name];
+	}
+	
+}
+```
+
+## Usage
+
+```typescript
+import {Matcher} from '@slicky/query-selector';
+
+
+let matcher = new Matcher(new CustomDocumentWalker);
+let dom = loadCustomDOM();
+
+
+let element = matcher.querySelector(dom, 'div a.btn:first-child');	// one element
+let elements = matcher.querySelectorAll(dom, 'a.btn');				// array of elements
+let matches = matcher.matches(element, 'a.btn');					// true
+```
+
+## API
+
+* `querySelector`: similar to [Document.querySelector()](https://developer.mozilla.org/en-US/docs/Web/API/Document/querySelector)
+* `querySelectorAll`: similar to [Document.querySelectorAll()](https://developer.mozilla.org/en-US/docs/Web/API/Document/querySelectorAll)
+* `matches`: similar to [Element.matches()](https://developer.mozilla.org/en-US/docs/Web/API/Element/matches)
+
+## Supported selectors
+
+* [Type selector](https://developer.mozilla.org/en-US/docs/Web/CSS/Type_selectors) (`div`)
+* [Class selector](https://developer.mozilla.org/en-US/docs/Web/CSS/Class_selectors) (`.btn`)
+* [ID selector](https://developer.mozilla.org/en-US/docs/Web/CSS/ID_selectors) (`#header`)
+* [Attribute selectors](https://developer.mozilla.org/en-US/docs/Web/CSS/Attribute_selectors) (`[attr]`, ...)
+* [Adjacent sibling selector](https://developer.mozilla.org/en-US/docs/Web/CSS/Adjacent_sibling_selectors) (`span + i`)
+* [General sibling selector](https://developer.mozilla.org/en-US/docs/Web/CSS/General_sibling_selectors) (`span ~ i`)
+* [Child selector](https://developer.mozilla.org/en-US/docs/Web/CSS/Child_selectors) (`span > i`)
+* [Descendant selector](https://developer.mozilla.org/en-US/docs/Web/CSS/Descendant_selectors) (`span i`)
+* [Empty](https://developer.mozilla.org/en-US/docs/Web/CSS/:empty) (`:empty`)
+* [First child](https://developer.mozilla.org/en-US/docs/Web/CSS/:first-child) (`:first-child`)
+* [First of type](https://developer.mozilla.org/en-US/docs/Web/CSS/:first-of-type) (`:first-of-type`)
+* [Last child](https://developer.mozilla.org/en-US/docs/Web/CSS/:last-child) (`:last-child`)
+* [Last of type](https://developer.mozilla.org/en-US/docs/Web/CSS/:last-of-type) (`:last-of-type`)

lib/ast.d.ts

@@ -0,0 +1,66 @@
+export declare enum ASTNodeType {
+    QUERY = 0,
+    SELECTOR = 1,
+    PARTS = 2,
+    ELEMENT = 3,
+    CLASS = 4,
+    ID = 5,
+    PSEUDO_CLASS = 6,
+    ATTRIBUTE = 7,
+    DESCENDANT = 8,
+    CHILD = 9,
+    ADJACENT_SIBLING = 10,
+    GENERAL_SIBLING = 11,
+}
+export declare type ASTSimpleSelector = ASTElement | ASTId | ASTClass | ASTPseudoClass | ASTAttribute;
+export declare type ASTSelectorNode = ASTParts | ASTDescendant | ASTChild | ASTAdjacentSibling | ASTGeneralSibling;
+export interface ASTNode {
+    type: ASTNodeType;
+}
+export interface ASTQuery extends ASTNode {
+    type: ASTNodeType.QUERY;
+    selectors: Array<ASTSelector>;
+}
+export interface ASTSelector extends ASTNode {
+    type: ASTNodeType.SELECTOR;
+    nodes: Array<ASTSelectorNode>;
+}
+export interface ASTParts extends ASTNode {
+    type: ASTNodeType.PARTS;
+    parts: Array<ASTSimpleSelector>;
+}
+export interface ASTElement extends ASTNode {
+    type: ASTNodeType.ELEMENT;
+    name: string;
+}
+export interface ASTClass extends ASTNode {
+    type: ASTNodeType.CLASS;
+    name: string;
+}
+export interface ASTId extends ASTNode {
+    type: ASTNodeType.ID;
+    name: string;
+}
+export interface ASTPseudoClass extends ASTNode {
+    type: ASTNodeType.PSEUDO_CLASS;
+    name: string;
+}
+export interface ASTAttribute extends ASTNode {
+    type: ASTNodeType.ATTRIBUTE;
+    caseSensitive: boolean;
+    name: string;
+    operator?: string;
+    value?: string;
+}
+export interface ASTDescendant extends ASTNode {
+    type: ASTNodeType.DESCENDANT;
+}
+export interface ASTChild extends ASTNode {
+    type: ASTNodeType.CHILD;
+}
+export interface ASTAdjacentSibling extends ASTNode {
+    type: ASTNodeType.ADJACENT_SIBLING;
+}
+export interface ASTGeneralSibling extends ASTNode {
+    type: ASTNodeType.GENERAL_SIBLING;
+}

lib/ast.js

@@ -0,0 +1,17 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+var ASTNodeType;
+(function (ASTNodeType) {
+    ASTNodeType[ASTNodeType["QUERY"] = 0] = "QUERY";
+    ASTNodeType[ASTNodeType["SELECTOR"] = 1] = "SELECTOR";
+    ASTNodeType[ASTNodeType["PARTS"] = 2] = "PARTS";
+    ASTNodeType[ASTNodeType["ELEMENT"] = 3] = "ELEMENT";
+    ASTNodeType[ASTNodeType["CLASS"] = 4] = "CLASS";
+    ASTNodeType[ASTNodeType["ID"] = 5] = "ID";
+    ASTNodeType[ASTNodeType["PSEUDO_CLASS"] = 6] = "PSEUDO_CLASS";
+    ASTNodeType[ASTNodeType["ATTRIBUTE"] = 7] = "ATTRIBUTE";
+    ASTNodeType[ASTNodeType["DESCENDANT"] = 8] = "DESCENDANT";
+    ASTNodeType[ASTNodeType["CHILD"] = 9] = "CHILD";
+    ASTNodeType[ASTNodeType["ADJACENT_SIBLING"] = 10] = "ADJACENT_SIBLING";
+    ASTNodeType[ASTNodeType["GENERAL_SIBLING"] = 11] = "GENERAL_SIBLING";
+})(ASTNodeType = exports.ASTNodeType || (exports.ASTNodeType = {}));

lib/data.d.ts

@@ -0,0 +1,2 @@
+export declare const OPERATORS: string[];
+export declare const SELECTOR_SEPARATOR = ",";

lib/data.js

@@ -0,0 +1,6 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.OPERATORS = [
+    '~=', '|=', '^=', '$=', '*=', '=', '+', '~', '>',
+];
+exports.SELECTOR_SEPARATOR = ',';

lib/documentWalker.d.ts

@@ -0,0 +1,10 @@
+export declare type DocumentNode = Object;
+export declare type DocumentParent = DocumentNode | Object;
+export interface IDocumentWalker {
+    getNodeName(node: DocumentNode): string;
+    isElement(node: DocumentNode): boolean;
+    isString(node: DocumentNode): boolean;
+    getParentNode(node: DocumentNode): DocumentParent;
+    getChildNodes(parent: DocumentParent): Array<DocumentNode>;
+    getAttribute(node: DocumentNode, name: string): string;
+}

lib/documentWalker.js

@@ -0,0 +1,2 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });