feat: migrate to starlight

node_modules/vfile-location/index.d.ts

@@ -0,0 +1,2 @@
+export { location } from "./lib/index.js";
+export type Location = import('./lib/index.js').Location;

node_modules/vfile-location/index.js

@@ -0,0 +1,5 @@
+/**
+ * @typedef {import('./lib/index.js').Location} Location
+ */
+
+export {location} from './lib/index.js'

node_modules/vfile-location/lib/index.d.ts

@@ -0,0 +1,61 @@
+/**
+ * Create an index of the given document to translate between line/column and
+ * offset based positional info.
+ *
+ * Also implemented in Rust in [`wooorm/markdown-rs`][markdown-rs].
+ *
+ * [markdown-rs]: https://github.com/wooorm/markdown-rs/blob/main/src/util/location.rs
+ *
+ * @param {VFile | Value} file
+ *   File to index.
+ * @returns {Location}
+ *   Accessors for index.
+ */
+export function location(file: VFile | Value): Location;
+export type VFile = import('vfile').VFile;
+export type Value = import('vfile').Value;
+export type UnistPoint = import('unist').Point;
+/**
+ * unist point, allowed as input.
+ */
+export type PointLike = {
+    /**
+     * Line.
+     */
+    line?: number | null | undefined;
+    /**
+     * Column.
+     */
+    column?: number | null | undefined;
+    /**
+     * Offset.
+     */
+    offset?: number | null | undefined;
+};
+/**
+ * Get the line/column based `Point` for `offset` in the bound indices.
+ *
+ * Returns `undefined` when given out of bounds input.
+ *
+ * Also implemented in Rust in [`wooorm/markdown-rs`][markdown-rs].
+ *
+ * [markdown-rs]: https://github.com/wooorm/markdown-rs/blob/main/src/util/location.rs
+ */
+export type ToPoint = (offset?: number | null | undefined) => UnistPoint | undefined;
+/**
+ * Get the `offset` from a line/column based `Point` in the bound indices.
+ */
+export type ToOffset = (point?: PointLike | null | undefined) => number | undefined;
+/**
+ * Accessors for index.
+ */
+export type Location = {
+    /**
+     *   Get the line/column based `Point` for `offset` in the bound indices.
+     */
+    toPoint: ToPoint;
+    /**
+     *   Get the `offset` from a line/column based `Point` in the bound indices.
+     */
+    toOffset: ToOffset;
+};

node_modules/vfile-location/lib/index.js

@@ -0,0 +1,121 @@
+/**
+ * @typedef {import('vfile').VFile} VFile
+ * @typedef {import('vfile').Value} Value
+ * @typedef {import('unist').Point} UnistPoint
+ */
+
+/**
+ *
+ * @typedef PointLike
+ *   unist point, allowed as input.
+ * @property {number | null | undefined} [line]
+ *   Line.
+ * @property {number | null | undefined} [column]
+ *   Column.
+ * @property {number | null | undefined} [offset]
+ *   Offset.
+ *
+ * @callback ToPoint
+ *   Get the line/column based `Point` for `offset` in the bound indices.
+ *
+ *   Returns `undefined` when given out of bounds input.
+ *
+ *   Also implemented in Rust in [`wooorm/markdown-rs`][markdown-rs].
+ *
+ *   [markdown-rs]: https://github.com/wooorm/markdown-rs/blob/main/src/util/location.rs
+ * @param {number | null | undefined} [offset]
+ *   Something that should be an `offset.
+ * @returns {UnistPoint | undefined}
+ *   Point, if `offset` is valid and in-bounds input.
+ *
+ * @callback ToOffset
+ *   Get the `offset` from a line/column based `Point` in the bound indices.
+ * @param {PointLike | null | undefined} [point]
+ *   Something that should be a `point.
+ * @returns {number | undefined}
+ *   Offset (`number`) or `undefined` for invalid or out of bounds input.
+ *
+ * @typedef Location
+ *   Accessors for index.
+ * @property {ToPoint} toPoint
+ *   Get the line/column based `Point` for `offset` in the bound indices.
+ * @property {ToOffset} toOffset
+ *   Get the `offset` from a line/column based `Point` in the bound indices.
+ */
+
+const search = /\r?\n|\r/g
+
+/**
+ * Create an index of the given document to translate between line/column and
+ * offset based positional info.
+ *
+ * Also implemented in Rust in [`wooorm/markdown-rs`][markdown-rs].
+ *
+ * [markdown-rs]: https://github.com/wooorm/markdown-rs/blob/main/src/util/location.rs
+ *
+ * @param {VFile | Value} file
+ *   File to index.
+ * @returns {Location}
+ *   Accessors for index.
+ */
+export function location(file) {
+  const value = String(file)
+  /**
+   * List, where each index is a line number (0-based), and each value is the
+   * byte index *after* where the line ends.
+   *
+   * @type {Array<number>}
+   */
+  const indices = []
+
+  search.lastIndex = 0
+
+  while (search.test(value)) {
+    indices.push(search.lastIndex)
+  }
+
+  indices.push(value.length + 1)
+
+  return {toPoint, toOffset}
+
+  /** @type {ToPoint} */
+  function toPoint(offset) {
+    let index = -1
+
+    if (
+      typeof offset === 'number' &&
+      offset > -1 &&
+      offset < indices[indices.length - 1]
+    ) {
+      while (++index < indices.length) {
+        if (indices[index] > offset) {
+          return {
+            line: index + 1,
+            column: offset - (index > 0 ? indices[index - 1] : 0) + 1,
+            offset
+          }
+        }
+      }
+    }
+  }
+
+  /** @type {ToOffset} */
+  function toOffset(point) {
+    const line = point && point.line
+    const column = point && point.column
+
+    if (
+      typeof line === 'number' &&
+      typeof column === 'number' &&
+      !Number.isNaN(line) &&
+      !Number.isNaN(column) &&
+      line - 1 in indices
+    ) {
+      const offset = (indices[line - 2] || 0) + column - 1 || 0
+
+      if (offset > -1 && offset < indices[indices.length - 1]) {
+        return offset
+      }
+    }
+  }
+}

node_modules/vfile-location/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.

node_modules/vfile-location/package.json

@@ -0,0 +1,87 @@
+{
+  "name": "vfile-location",
+  "version": "5.0.2",
+  "description": "vfile utility to convert between positional (line and column-based) and offset (range-based) locations",
+  "license": "MIT",
+  "keywords": [
+    "vfile",
+    "vfile-util",
+    "util",
+    "utility",
+    "virtual",
+    "file",
+    "location",
+    "point",
+    "position",
+    "offset"
+  ],
+  "repository": "vfile/vfile-location",
+  "bugs": "https://github.com/vfile/vfile-location/issues",
+  "funding": {
+    "type": "opencollective",
+    "url": "https://opencollective.com/unified"
+  },
+  "author": "Titus Wormer <tituswormer@gmail.com> (https://wooorm.com)",
+  "contributors": [
+    "Titus Wormer <tituswormer@gmail.com> (https://wooorm.com)",
+    "Christian Murphy <christian.murphy.42@gmail.com>"
+  ],
+  "sideEffects": false,
+  "type": "module",
+  "exports": {
+    "types": "./index.d.ts",
+    "default": "./index.js"
+  },
+  "files": [
+    "lib/",
+    "index.d.ts",
+    "index.js"
+  ],
+  "dependencies": {
+    "@types/unist": "^3.0.0",
+    "vfile": "^6.0.0"
+  },
+  "devDependencies": {
+    "@types/node": "^20.0.0",
+    "c8": "^8.0.0",
+    "prettier": "^3.0.0",
+    "remark-cli": "^11.0.0",
+    "remark-preset-wooorm": "^9.0.0",
+    "type-coverage": "^2.0.0",
+    "typescript": "^5.0.0",
+    "xo": "^0.56.0"
+  },
+  "scripts": {
+    "prepack": "npm run build && npm run format",
+    "build": "tsc --build --clean && tsc --build && type-coverage",
+    "format": "remark . -qfo && prettier . -w --log-level warn && xo --fix",
+    "test-api": "node --conditions development test.js",
+    "test-coverage": "c8 --100 --reporter lcov npm run test-api",
+    "test": "npm run build && npm run format && npm run test-coverage"
+  },
+  "prettier": {
+    "bracketSpacing": false,
+    "semi": false,
+    "singleQuote": true,
+    "tabWidth": 2,
+    "trailingComma": "none",
+    "useTabs": false
+  },
+  "remarkConfig": {
+    "plugins": [
+      "remark-preset-wooorm"
+    ]
+  },
+  "typeCoverage": {
+    "atLeast": 100,
+    "detail": true,
+    "ignoreCatch": true,
+    "strict": true
+  },
+  "xo": {
+    "prettier": true,
+    "rules": {
+      "unicorn/prefer-at": "off"
+    }
+  }
+}

node_modules/vfile-location/readme.md

@@ -0,0 +1,190 @@
+# vfile-location
+
+[![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]
+
+[vfile][] utility to convert between positional (line and column-based) and
+offsets (range-based) locations.
+
+## Contents
+
+*   [What is this?](#what-is-this)
+*   [When should I use this?](#when-should-i-use-this)
+*   [Install](#install)
+*   [Use](#use)
+*   [API](#api)
+    *   [`location(file)`](#locationfile)
+    *   [`Location`](#location)
+*   [Types](#types)
+*   [Compatibility](#compatibility)
+*   [Contribute](#contribute)
+*   [License](#license)
+
+## What is this?
+
+This is a tiny but useful package to convert between arbitrary places in a
+file.
+
+## When should I use this?
+
+This utility is useful when ASTs nodes don’t cut it.
+For example, when you are making a lint rule that looks for dangerous
+characters in a file, which you accomplish by searching the raw file value,
+and still want to report it to users.
+
+## Install
+
+This package is [ESM only][esm].
+In Node.js (version 16+), install with [npm][]:
+
+```sh
+npm install vfile-location
+```
+
+In Deno with [`esm.sh`][esmsh]:
+
+```js
+import {location} from 'https://esm.sh/vfile-location@5'
+```
+
+In browsers with [`esm.sh`][esmsh]:
+
+```html
+<script type="module">
+  import {location} from 'https://esm.sh/vfile-location@5?bundle'
+</script>
+```
+
+## Use
+
+```js
+import {VFile} from 'vfile'
+import {location} from 'vfile-location'
+
+const place = location(new VFile('foo\nbar\nbaz'))
+
+const offset = place.toOffset({line: 3, column: 3}) // => 10
+place.toPoint(offset) // => {line: 3, column: 3, offset: 10}
+```
+
+## API
+
+This package exports the identifier [`location`][api-location].
+There is no default export.
+
+### `location(file)`
+
+Create an index of the given document to translate between line/column and
+offset based positional info.
+
+###### Parameters
+
+*   `file` ([`VFile`][vfile], `Buffer`, or `string`)
+    — file to index
+
+###### Returns
+
+Accessors for index ([`Location`][api-location-map]).
+
+### `Location`
+
+Accessors for index (TypeScript type).
+
+###### Fields
+
+*   `toPoint` (`(offset: number) => Point | undefined`)
+    — get the line/column based [`Point`][point] for `offset` in the bound
+    indices
+*   `toOffset` (`(point: Point) => number | undefined`)
+    — get the `offset` from a line/column based [`Point`][point] in the bound
+    indices
+
+## Types
+
+This package is fully typed with [TypeScript][].
+It exports the additional type [`Location`][api-location-map].
+
+## Compatibility
+
+Projects maintained by the unified collective are compatible with maintained
+versions of Node.js.
+
+When we cut a new major release, we drop support for unmaintained versions of
+Node.
+This means we try to keep the current release line, `vfile-location@^5`,
+compatible with Node.js 16.
+
+## Contribute
+
+See [`contributing.md`][contributing] in [`vfile/.github`][health] 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] © [Titus Wormer][author]
+
+<!-- Definitions -->
+
+[build-badge]: https://github.com/vfile/vfile-location/workflows/main/badge.svg
+
+[build]: https://github.com/vfile/vfile-location/actions
+
+[coverage-badge]: https://img.shields.io/codecov/c/github/vfile/vfile-location.svg
+
+[coverage]: https://codecov.io/github/vfile/vfile-location
+
+[downloads-badge]: https://img.shields.io/npm/dm/vfile-location.svg
+
+[downloads]: https://www.npmjs.com/package/vfile-location
+
+[size-badge]: https://img.shields.io/badge/dynamic/json?label=minzipped%20size&query=$.size.compressedSize&url=https://deno.bundlejs.com/?q=vfile-location
+
+[size]: https://bundlejs.com/?q=vfile-location
+
+[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/vfile/vfile/discussions
+
+[npm]: https://docs.npmjs.com/cli/install
+
+[esm]: https://gist.github.com/sindresorhus/a39789f98801d908bbc7ff3ecc99d99c
+
+[esmsh]: https://esm.sh
+
+[typescript]: https://www.typescriptlang.org
+
+[contributing]: https://github.com/vfile/.github/blob/main/contributing.md
+
+[support]: https://github.com/vfile/.github/blob/main/support.md
+
+[health]: https://github.com/vfile/.github
+
+[coc]: https://github.com/vfile/.github/blob/main/code-of-conduct.md
+
+[license]: license
+
+[author]: https://wooorm.com
+
+[vfile]: https://github.com/vfile/vfile
+
+[point]: https://github.com/syntax-tree/unist#point
+
+[api-location]: #locationfile
+
+[api-location-map]: #location