Initial commit

Author: wooorm

.editorconfig

@@ -0,0 +1,9 @@
+root = true
+
+[*]
+indent_style = space
+indent_size = 2
+end_of_line = lf
+charset = utf-8
+trim_trailing_whitespace = true
+insert_final_newline = true

.gitignore

@@ -0,0 +1,7 @@
+.DS_Store
+*.log
+.nyc_output/
+coverage/
+node_modules/
+unist-util-source.js
+unist-util-source.min.js

.travis.yml

@@ -0,0 +1,22 @@
+language: node_js
+node_js:
+- '0.11'
+- '6.0'
+after_success: bash <(curl -s https://codecov.io/bash)
+deploy:
+  - provider: npm
+    email: tituswormer@gmail.com
+    api_key:
+      secure: pxHatSGmro/OrE+BnXSwakDGwq8IaaCf0FhrdQj8TvAx3a2JJcmpHDVXQiK6QdDGDCMTrfaMUFMtWcpWYOVpUiSyDTvoRLRxEeGqEsDgLZkAxt1rGcU5EiCfaSdhDpMZHxAW586NLqqMvcrVAFMgM504GRWWrH7atYH8Xy9lMiefaJEDtc3a0lMkLnliMFg29nVgSp5KUKvHbY8i+pUsxvo11H0T4NGeiKgnkcwN5bVKsOWBY1zgbEHigF/I8XaUkOr/o94j9SGDD3qRVmoXbufZoav1YSIxuWDdkFxIvsUNje5yCMSxQFMyAQ5Sl7HMDbNkoPRB98A80SbJq+vggm14mmWdhTeiwwHWqoA7VbcRKKmChLZ5V/z26+JWA1dKcMruYGcfVBSxkQNs599jpXyJYtmIJ7KFLy5FJrKT6iMXYQIssZYk9HZ2hjebmXFdW9nzki5qvarRDI13aFLFC/81owC9Mk0Xyf0ofH5oybzvXX0IR6CrGPv0TIC2p+m/itRqHbX7TQVgvA2/i+K8UY1ByRkxCVfhU1GasBHkTZLgR7Qap8XrB6U7bGVjuOziPea3S/KVkwb964xtbYILrYfobcgmv7aMxYRbT+a41l468h5GFSHfPu8NDc/qH16xgMrytB5kAQvXV+217/Xe+aXjLA+lV1IqbAcXwVs5orY=
+    on:
+      tags: true
+      node: '6.0'
+  - provider: releases
+    api_key:
+      secure: nNUQKTPTsbRQKgV1mUQ9jt52w+lNGrQtEpd975K9jQGxWvBNJaHb0eTDbuJCO7+OgG77yKiGQcr9gc7oM4WjFFcLoR2qWxRXsgGuyAIiMU85RRBvHXp7+gv1Qa/ko15MKmJo0ACxizAEiT6SIpwdQpo0AaopQKxg26pNN9S52YK6WtUjbgbIjRbcntFXi2CByO6W5d3rXX2pWgoE+j+Qm2UpA8j09i6pghVUcBb+7ngy8D0PBYnXW3pTKzZiFuhdW93n2VPl553q0FQe9jQyoaC0DYkeT1JOyLCd7uME+mZaCsiue2gdWlY6Vbbitv4ccK0qvUblMPvusDV5LJGz2c8V3L9+uC90x30LO1sX/XXG26nyuN2YrKqdmuJJWVqr3cz6c6Z94yBdcnuReJqo1IOuUetwo1fKnB7G9k3qkhDKc3PPzB5Xz/VlKQTnzS5TrSrzog8wWYQhauU5EO/+Bivyyf7FUc+/+ykSIVS+ysfwZw65wOrNaAW3oPs0kJdouXsdotcWsSt+Xbp6FMkhju92xifdWr99MrXzsMpB/ToNdHgQ3LPp+JrU61ASfcb3ojH8k+SggVI5LnsDKtoBIQy8LyWr6FHAwxDadtjyuBAPul/+emLQiUalzG9Y3/+lmQDWT2piha0W0Fw643F/GdxNrdKqws6/MX70el2VhMY=
+    file:
+      - "unist-util-source.js"
+      - "unist-util-source.min.js"
+    on:
+      tags: true
+      node: '6.0'

LICENSE

@@ -0,0 +1,22 @@
+(The MIT License)
+
+Copyright (c) 2016 Titus Wormer <tituswormer@gmail.com>
+
+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.

index.js

@@ -0,0 +1,45 @@
+/**
+ * @author Titus Wormer
+ * @copyright 2016 Titus Wormer
+ * @license MIT
+ * @module unist:util:source
+ * @fileoverview Get the source of a node or location.
+ */
+
+'use strict';
+
+var location = require('vfile-location');
+
+module.exports = source;
+
+function source(value, file) {
+  var doc = String(file);
+  var loc = location(file);
+  var val = value && value.position ? value.position : value || {};
+  var start;
+  var end;
+  var indents;
+  var indent;
+  var lines;
+  var length;
+  var index;
+
+  start = loc.toOffset(val.start);
+  end = loc.toOffset(val.end);
+  indents = val.indent || [];
+
+  if (start === -1 || end === -1) {
+    return null;
+  }
+
+  lines = doc.slice(start, end).split('\n');
+  length = lines.length;
+  index = 0;
+
+  while (++index < length) {
+    indent = indents[index - 1];
+    lines[index] = lines[index].slice(indent ? indent - 1 : 0);
+  }
+
+  return lines.join('\n');
+}

package.json

@@ -0,0 +1,60 @@
+{
+  "name": "unist-util-source",
+  "version": "0.0.0",
+  "description": "Utility to get the source of a value",
+  "license": "MIT",
+  "keywords": [
+    "unist",
+    "node",
+    "location",
+    "source"
+  ],
+  "repository": "https://github.com/wooorm/unist-util-source.git",
+  "bugs": "https://github.com/wooorm/hast-util-to-html/issues",
+  "author": "Titus Wormer <tituswormer@gmail.com> (http://wooorm.com)",
+  "contributors": [
+    "Titus Wormer <tituswormer@gmail.com> (http://wooorm.com)"
+  ],
+  "dependencies": {
+    "vfile-location": "^2.0.1"
+  },
+  "files": [
+    "index.js"
+  ],
+  "devDependencies": {
+    "browserify": "^13.0.1",
+    "esmangle": "^1.0.1",
+    "nyc": "^8.1.0",
+    "remark": "^6.0.1",
+    "remark-cli": "^2.0.0",
+    "remark-preset-wooorm": "^1.0.0",
+    "tape": "^4.0.0",
+    "xo": "^0.16.0"
+  },
+  "scripts": {
+    "build-md": "remark . --quiet --frail",
+    "build-bundle": "browserify index.js --bare -s unistUtilSource > unist-util-source.js",
+    "build-mangle": "esmangle < unist-util-source.js > unist-util-source.min.js",
+    "build": "npm run build-md && npm run build-bundle && npm run build-mangle",
+    "lint": "xo",
+    "test-api": "node test",
+    "test-coverage": "nyc --reporter lcov tape test",
+    "test": "npm run build && npm run lint && npm run test-coverage"
+  },
+  "nyc": {
+    "check-coverage": true,
+    "lines": 100,
+    "functions": 100,
+    "branches": 100
+  },
+  "xo": {
+    "space": true,
+    "ignores": [
+      "unist-util-source.js"
+    ]
+  },
+  "remarkConfig": {
+    "output": true,
+    "presets": "wooorm"
+  }
+}

readme.md

@@ -0,0 +1,77 @@
+# unist-util-source [![Build Status][travis-badge]][travis] [![Coverage Status][codecov-badge]][codecov]
+
+[**Unist**][unist] utility to get the source of a [Node][] or
+[Location][].
+
+## Installation
+
+[npm][npm-install]:
+
+```bash
+npm install unist-util-source
+```
+
+## Usage
+
+```js
+var remark = require('remark');
+var source = require('./');
+
+remark()
+  .use(function () {
+    return transformer;
+    function transformer(tree, file) {
+      var list = tree.children[0].children[0];
+      console.log(source(list, file));
+    }
+  })
+  .process('> + **[Hello](./example)**\n> world.');
+```
+
+Yields:
+
+```txt
++ **[Hello](./example)**
+world.
+```
+
+## API
+
+### `source(value, file)`
+
+###### Parameters
+
+*   `value` ([`Node`][node] or [`Location`][location]) — Value to get.
+*   `file` ([`VFile`][vfile]) — Virtual file in which `value` exists.
+
+###### Returns
+
+`string?` — Source of `value` in `file`, if available.
+
+## License
+
+[MIT][license] © [Titus Wormer][author]
+
+<!-- Definitions -->
+
+[travis-badge]: https://img.shields.io/travis/wooorm/unist-util-source.svg
+
+[travis]: https://travis-ci.org/wooorm/unist-util-source
+
+[codecov-badge]: https://img.shields.io/codecov/c/github/wooorm/unist-util-source.svg
+
+[codecov]: https://codecov.io/github/wooorm/unist-util-source
+
+[npm-install]: https://docs.npmjs.com/cli/install
+
+[license]: LICENSE
+
+[author]: http://wooorm.com
+
+[unist]: https://github.com/wooorm/unist
+
+[node]: https://github.com/wooorm/unist#node
+
+[location]: https://github.com/wooorm/unist#location
+
+[vfile]: https://github.com/wooorm/vfile

test.js

@@ -0,0 +1,65 @@
+/**
+ * @author Titus Wormer
+ * @copyright 2016 Titus Wormer
+ * @license MIT
+ * @module unist:util:source
+ * @fileoverview Test suite for `unit-util-source`.
+ */
+
+'use strict';
+
+/* Dependencies. */
+var test = require('tape');
+var remark = require('remark');
+var source = require('./');
+
+/* Tests. */
+test('unist-util-source', function (t) {
+  t.plan(10);
+
+  remark().use(function () {
+    return transformer;
+    function transformer(tree, file) {
+      var node = tree;
+
+      t.equal(source(node, file), '> + **[Hello](./example)**\n> world.');
+
+      /* Blockquote. */
+      node = tree.children[0];
+      t.equal(source(node, file), '> + **[Hello](./example)**\n> world.');
+
+      /* List. */
+      node = node.children[0];
+      t.equal(source(node, file), '+ **[Hello](./example)**\nworld.');
+
+      /* List-item. */
+      node = node.children[0];
+      t.equal(source(node, file), '+ **[Hello](./example)**\nworld.');
+
+      /* Paragraph. */
+      node = node.children[0];
+      t.equal(source(node, file), '**[Hello](./example)**\nworld.');
+
+      /* Strong. */
+      node = node.children[0];
+      t.equal(source(node, file), '**[Hello](./example)**');
+
+      /* Link. */
+      node = node.children[0];
+      t.equal(source(node, file), '[Hello](./example)');
+
+      /* Text. */
+      node = node.children[0];
+      t.equal(source(node, file), 'Hello');
+
+      /* Generated. */
+      t.equal(source({type: node.type, value: node.value}, file), null);
+
+      /* Missing. */
+      t.equal(source(null, file), null);
+    }
+  }).process([
+    '> + **[Hello](./example)**',
+    '> world.'
+  ].join('\n'));
+});