Add initial implementation

.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

.github/workflows/main.yml

@@ -0,0 +1,21 @@
+name: main
+on:
+  - pull_request
+  - push
+jobs:
+  main:
+    name: ${{matrix.node}}
+    runs-on: ubuntu-latest
+    steps:
+      - uses: actions/checkout@v3
+      - uses: actions/setup-node@v3
+        with:
+          node-version: ${{matrix.node}}
+      - run: npm install
+      - run: npm test
+      - uses: codecov/codecov-action@v3
+    strategy:
+      matrix:
+        node:
+          - lts/fermium
+          - node

.gitignore

@@ -0,0 +1,7 @@
+.DS_Store
+*.d.ts
+*.log
+*.tgz
+coverage/
+node_modules/
+yarn.lock

.npmrc

@@ -0,0 +1 @@
+package-lock=false

.prettierignore

@@ -0,0 +1,2 @@
+coverage/
+*.md

index.js

@@ -0,0 +1,6 @@
+export {
+  lspPositionToUnistPoint,
+  lspRangeToUnistPosition,
+  unistPointToLspPosition,
+  unistPositionToLspRange
+} from './lib/index.js'

lib/index.js

@@ -0,0 +1,58 @@
+/**
+ * @typedef {import('unist').Point} Point
+ * @typedef {import('unist').Position} UnistPosition
+ * @typedef {import('vscode-languageserver-types').Position} LspPosition
+ * @typedef {import('vscode-languageserver-types').Range} Range
+ */
+
+/**
+ * Convert a unist point to an LSP position.
+ *
+ * @param {Point} point The unist point to convert.
+ * @returns {LspPosition} The point converted to an LSP position.
+ */
+export function unistPointToLspPosition(point) {
+  return {
+    character: point.column - 1,
+    line: point.line - 1
+  }
+}
+
+/**
+ * Convert an LSP position to a unist point.
+ *
+ * @param {LspPosition} position The LSP position to convert.
+ * @returns {Point} The position converted to a unist point.
+ */
+export function lspPositionToUnistPoint(position) {
+  return {
+    column: position.character + 1,
+    line: position.line + 1
+  }
+}
+
+/**
+ * Convert a unist position to an LSP range.
+ *
+ * @param {UnistPosition} position The unist position to convert.
+ * @returns {Range} The position converted to an LSP range.
+ */
+export function unistPositionToLspRange(position) {
+  return {
+    start: unistPointToLspPosition(position.start),
+    end: unistPointToLspPosition(position.end)
+  }
+}
+
+/**
+ * Convert an LSP range to a unist position.
+ *
+ * @param {Range} range The LSP range to convert.
+ * @returns {UnistPosition} The range converted to a unist position.
+ */
+export function lspRangeToUnistPosition(range) {
+  return {
+    start: lspPositionToUnistPoint(range.start),
+    end: lspPositionToUnistPoint(range.end)
+  }
+}

package.json

@@ -0,0 +1,74 @@
+{
+  "name": "unist-lsp",
+  "version": "0.0.0",
+  "description": "Utility to convert between unist and language server protocol",
+  "license": "MIT",
+  "keywords": [
+    "unist",
+    "util",
+    "utility",
+    "lsp",
+    "language-server-protocol"
+  ],
+  "repository": "syntax-tree/unist-lsp",
+  "bugs": "https://github.com/syntax-tree/unist-lsp/issues",
+  "funding": {
+    "type": "opencollective",
+    "url": "https://opencollective.com/unified"
+  },
+  "author": "Remco Haszing <remcohaszing@gmail.com>",
+  "contributors": [
+    "Remco Haszing <remcohaszing@gmail.com>"
+  ],
+  "sideEffects": false,
+  "type": "module",
+  "exports": "./index.js",
+  "files": [
+    "index.d.ts",
+    "index.js"
+  ],
+  "dependencies": {
+    "@types/unist": "^2.0.0",
+    "vscode-languageserver-types": "^3.0.0"
+  },
+  "devDependencies": {
+    "@types/tape": "^4.0.0",
+    "c8": "^7.0.0",
+    "prettier": "^2.0.0",
+    "remark-cli": "^11.0.0",
+    "remark-preset-wooorm": "^9.0.0",
+    "tape": "^5.0.0",
+    "type-coverage": "^2.0.0",
+    "typescript": "^4.0.0",
+    "xo": "^0.52.0"
+  },
+  "scripts": {
+    "prepack": "npm run build && npm run format",
+    "build": "tsc && type-coverage",
+    "format": "remark . -qfo && prettier -w . --loglevel warn  && xo --fix",
+    "test-api": "node test/index.js",
+    "test-coverage": "c8 --100 --reporter lcov node test/index.js",
+    "test": "npm run build && npm run format && npm run test-coverage"
+  },
+  "prettier": {
+    "tabWidth": 2,
+    "useTabs": false,
+    "singleQuote": true,
+    "bracketSpacing": false,
+    "semi": false,
+    "trailingComma": "none"
+  },
+  "xo": {
+    "prettier": true
+  },
+  "remarkConfig": {
+    "plugins": [
+      "preset-wooorm"
+    ]
+  },
+  "typeCoverage": {
+    "atLeast": 100,
+    "detail": true,
+    "strict": true
+  }
+}

readme.md

@@ -0,0 +1,206 @@
+# unist-lsp
+
+[![Build][build-badge]][build]
+[![Coverage][coverage-badge]][coverage]
+[![Downloads][downloads-badge]][downloads]
+[![Size][size-badge]][size]
+[![Sponsors][sponsors-badge]][collective]
+[![Backers][backers-badge]][collective]
+[![Chat][chat-badge]][chat]
+
+Utility to convert between [unist][] and  [language server protocol][].
+
+## Contents
+
+*   [What is this?](#what-is-this)
+*   [When should I use this?](#when-should-i-use-this)
+*   [Install](#install)
+*   [Use](#use)
+*   [API](#api)
+    *   [`unistPointToLspPosition(point)`](#unistpointtolsppositionpoint)
+    *   [`unist-lsp(position)`](#unist-lspposition)
+    *   [`unistPositionToLspRange(position)`](#unistpositiontolsprangeposition)
+    *   [`lspRangeToUnistPosition(range)`](#lsprangetounistpositionrange)
+*   [Types](#types)
+*   [Compatibility](#compatibility)
+*   [Security](#security)
+*   [Related](#related)
+*   [Contribute](#contribute)
+*   [License](#license)
+
+## What is this?
+
+This package is a utility that takes converts between [unist][] and
+[language server protocol][].
+
+## When should I use this?
+
+This project is useful when you want to deal with unist ASTs and a language
+server.
+
+## Install
+
+This package is [ESM only][esm].
+In Node.js (version 14.14+, or 16.0+), install with [npm][]:
+
+```sh
+npm install unist-lsp
+```
+
+In Deno with [`esm.sh`][esmsh]:
+
+```js
+import {
+  lspPositionToUnistPoint,
+  lspRangeToUnistPosition,
+  unistPointToLspPosition,
+  unistPositionToLspRange,
+} from "https://esm.sh/unist-lsp@?0"
+```
+
+In browsers with [`esm.sh`][esmsh]:
+
+```html
+<script type="module">
+  import {
+    lspPositionToUnistPoint,
+    lspRangeToUnistPosition,
+    unistPointToLspPosition,
+    unistPositionToLspRange,
+  } from "https://esm.sh/unist-lsp@?0"
+</script>
+```
+
+## Use
+
+Say we have the following `example.md`:
+
+```markdown
+## Hello **World**!
+```
+
+…and next to it a module `example.js`:
+
+```js
+import {promises as fs} from 'node:fs'
+import {fromMarkdown} from 'mdast-util-from-markdown'
+
+
+const markdown = String(await fs.readFile('example.md'))
+const mdast = fromMarkdown(markdown)
+
+const range = unistPositionToLspRange(mdast.position)
+
+console.dir(range)
+```
+
+…now running `node example.js` yields:
+
+```html
+{ start: { line: 0, character: 0 }, end: { line: 0, character: 19 } }
+```
+
+## API
+
+This package exports the identifiers  `lspPositionToUnistPoint`, `lspRangeToUnistPosition`, `unistPointToLspPosition`, and `unistPositionToLspRange`
+There is no default export.
+
+### `unistPointToLspPosition(point)`
+
+Convert a unist point to a language server protocol position.
+
+### `unist-lsp(position)`
+
+Convert a language server protocol position to a unist point.
+
+### `unistPositionToLspRange(position)`
+
+Convert a unist position to a language server protocol range.
+
+### `lspRangeToUnistPosition(range)`
+
+Convert a language server protocol range to a unist position.
+
+## Types
+
+This package is fully typed with [TypeScript][].
+
+## Compatibility
+
+Projects maintained by the unified collective are compatible with all maintained
+versions of Node.js.
+As of now, that is Node.js 14.14+, and 16.0+.
+Our projects sometimes work with older versions, but this is not guaranteed.
+
+## Security
+
+## Related
+
+*   [`unist`][unist]
+    — a specification for abstract syntax trees
+*   [`language server protocol`](https://microsoft.github.io/language-server-protocol)
+    — a protocol for communicating between an editor and a language server
+
+## Contribute
+
+See [`contributing.md` in `syntax-tree/.github`][contributing] for ways to get
+started.
+See [`support.md`][support] for ways to get help.
+
+This project has a [code of conduct][coc].
+By interacting with this repository, organization, or community you agree to
+abide by its terms.
+
+## License
+
+[MIT][license] © [Remco Haszing][author]
+
+<!-- Definitions -->
+
+[build-badge]: https://github.com/syntax-tree/unist-lsp/workflows/main/badge.svg
+
+[build]: https://github.com/syntax-tree/unist-lsp/actions
+
+[coverage-badge]: https://img.shields.io/codecov/c/github/syntax-tree/unist-lsp.svg
+
+[coverage]: https://codecov.io/github/syntax-tree/unist-lsp
+
+[downloads-badge]: https://img.shields.io/npm/dm/unist-lsp.svg
+
+[downloads]: https://www.npmjs.com/package/unist-lsp
+
+[size-badge]: https://img.shields.io/bundlephobia/minzip/unist-lsp.svg
+
+[size]: https://bundlephobia.com/result?p=unist-lsp
+
+[sponsors-badge]: https://opencollective.com/unified/sponsors/badge.svg
+
+[backers-badge]: https://opencollective.com/unified/backers/badge.svg
+
+[collective]: https://opencollective.com/unified
+
+[chat-badge]: https://img.shields.io/badge/chat-discussions-success.svg
+
+[chat]: https://github.com/syntax-tree/unist/discussions
+
+[language server protocol]: https://microsoft.github.io/language-server-protocol
+
+[license]: license
+
+[npm]: https://docs.npmjs.com/cli/install
+
+[author]: https://github.com/remcohaszing
+
+[esm]: https://gist.github.com/sindresorhus/a39789f98801d908bbc7ff3ecc99d99c
+
+[esmsh]: https://esm.sh
+
+[typescript]: https://www.typescriptlang.org
+
+[contributing]: https://github.com/syntax-tree/.github/blob/HEAD/contributing.md
+
+[support]: https://github.com/syntax-tree/.github/blob/HEAD/support.md
+
+[coc]: https://github.com/syntax-tree/.github/blob/HEAD/code-of-conduct.md
+
+[unist]: https://github.com/syntax-tree/unist