Merge pull request #38 from useparcel/codsen-parser

.prettierrc

@@ -0,0 +1,3 @@
+{
+  "tabWidth": 2
+}

package.json

@@ -37,7 +37,8 @@
     "url": "^0.11.0",
     "util": "^0.12.3",
     "webpack": "^5.3.2",
-    "webpack-cli": "^4.1.0"
+    "webpack-cli": "^4.1.0",
+    "webpack-node-externals": "^2.5.2"
   },
   "eslintConfig": {
     "parser": "@babel/eslint-parser",

packages/css-select-codsen-parser/README.md

@@ -0,0 +1,44 @@
+# css-select-codsen-parser
+
+An adapter for [`css-select`](https://www.npmjs.com/package/css-select) to allow querying of [`codsen-parser`](https://www.npmjs.com/package/codsen-parser) generated trees.
+
+## Install
+
+```
+$ npm install css-select-codsen-parser
+```
+
+## Usage
+
+To use this adapter, first you must run the AST through `prepare`.
+
+```js
+const parse = require("codsen-parser");
+const CSSselect = require("css-select");
+const { prepare, adapter } = require("css-select-codsen-parser");
+
+const ast = prepare(
+  parse(`
+    <div id="greeting">
+      Hello <span class="name">Alice</span>
+    </div>
+  `)
+);
+
+const nodes = cssSelect("#greeting .name", ast, { adapter });
+// => [ { type: 'tag', start: 37, end: 56, value: '<span class="name">'... ]
+```
+
+## API
+
+## prepare(ast)
+
+**Note:** This method modifies the AST directly.
+
+Accepts an AST generated by [`codsen-parser`](https://www.npmjs.com/package/codsen-parser).
+
+Returns the same AST.
+
+## adapter
+
+[`css-select`](https://www.npmjs.com/package/css-select) adapter. See [documentation](https://github.com/fb55/css-select#options) on how to use a custom adapter.