🎉 initiate project *astro_rewrite*
This commit is contained in:
parent
ffd4d5e86c
commit
2ba37bfbe3
8658 changed files with 2268794 additions and 2538 deletions
2
node_modules/vfile-location/index.d.ts
generated
vendored
Normal file
2
node_modules/vfile-location/index.d.ts
generated
vendored
Normal file
|
|
@ -0,0 +1,2 @@
|
|||
export {location} from './lib/index.js'
|
||||
export type Location = import('./lib/index.js').Location
|
||||
5
node_modules/vfile-location/index.js
generated
vendored
Normal file
5
node_modules/vfile-location/index.js
generated
vendored
Normal file
|
|
@ -0,0 +1,5 @@
|
|||
/**
|
||||
* @typedef {import('./lib/index.js').Location} Location
|
||||
*/
|
||||
|
||||
export {location} from './lib/index.js'
|
||||
111
node_modules/vfile-location/lib/index.d.ts
generated
vendored
Normal file
111
node_modules/vfile-location/lib/index.d.ts
generated
vendored
Normal file
|
|
@ -0,0 +1,111 @@
|
|||
/**
|
||||
* @typedef {import('vfile').VFile} VFile
|
||||
* @typedef {import('vfile').Value} Value
|
||||
*/
|
||||
/**
|
||||
* @typedef Point
|
||||
* unist point, where `line` and `column` can be `undefined`.
|
||||
* @property {number | undefined} line
|
||||
* Line.
|
||||
* @property {number | undefined} column
|
||||
* Column.
|
||||
* @property {number | undefined} [offset]
|
||||
* Offset.
|
||||
*
|
||||
* @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 a line/column-based `point` from `offset`.
|
||||
* @param {number | null | undefined} [offset]
|
||||
* Something that should be an `offset.
|
||||
* @returns {Point}
|
||||
* Point, line/column are undefined for invalid or out of bounds input.
|
||||
*
|
||||
* @callback ToOffset
|
||||
* Get an offset from a line/column-based `point`.
|
||||
* @param {Point | null | undefined} [point]
|
||||
* Something that should be a `point.
|
||||
* @returns {number}
|
||||
* Offset or `-1` for invalid or out of bounds input.
|
||||
*
|
||||
* @typedef Location
|
||||
* Accessors for index.
|
||||
* @property {ToPoint} toPoint
|
||||
* Get a line/column-based `point` from `offset`.
|
||||
* @property {ToOffset} toOffset
|
||||
* Get an offset from a line/column-based `point`.
|
||||
*/
|
||||
/**
|
||||
* Index the given document so you can translate between line/column and offset
|
||||
* based positional info.
|
||||
*
|
||||
* @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
|
||||
/**
|
||||
* unist point, where `line` and `column` can be `undefined`.
|
||||
*/
|
||||
export type Point = {
|
||||
/**
|
||||
* Line.
|
||||
*/
|
||||
line: number | undefined
|
||||
/**
|
||||
* Column.
|
||||
*/
|
||||
column: number | undefined
|
||||
/**
|
||||
* Offset.
|
||||
*/
|
||||
offset?: number | undefined
|
||||
}
|
||||
/**
|
||||
* unist point, allowed as input.
|
||||
*/
|
||||
export type PointLike = {
|
||||
/**
|
||||
* Line.
|
||||
*/
|
||||
line?: number | null | undefined
|
||||
/**
|
||||
* Column.
|
||||
*/
|
||||
column?: number | null | undefined
|
||||
/**
|
||||
* Offset.
|
||||
*/
|
||||
offset?: number | null | undefined
|
||||
}
|
||||
/**
|
||||
* Get a line/column-based `point` from `offset`.
|
||||
*/
|
||||
export type ToPoint = (offset?: number | null | undefined) => Point
|
||||
/**
|
||||
* Get an offset from a line/column-based `point`.
|
||||
*/
|
||||
export type ToOffset = (point?: Point | null | undefined) => number
|
||||
/**
|
||||
* Accessors for index.
|
||||
*/
|
||||
export type Location = {
|
||||
/**
|
||||
* Get a line/column-based `point` from `offset`.
|
||||
*/
|
||||
toPoint: ToPoint
|
||||
/**
|
||||
* Get an offset from a line/column-based `point`.
|
||||
*/
|
||||
toOffset: ToOffset
|
||||
}
|
||||
114
node_modules/vfile-location/lib/index.js
generated
vendored
Normal file
114
node_modules/vfile-location/lib/index.js
generated
vendored
Normal file
|
|
@ -0,0 +1,114 @@
|
|||
/**
|
||||
* @typedef {import('vfile').VFile} VFile
|
||||
* @typedef {import('vfile').Value} Value
|
||||
*/
|
||||
|
||||
/**
|
||||
* @typedef Point
|
||||
* unist point, where `line` and `column` can be `undefined`.
|
||||
* @property {number | undefined} line
|
||||
* Line.
|
||||
* @property {number | undefined} column
|
||||
* Column.
|
||||
* @property {number | undefined} [offset]
|
||||
* Offset.
|
||||
*
|
||||
* @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 a line/column-based `point` from `offset`.
|
||||
* @param {number | null | undefined} [offset]
|
||||
* Something that should be an `offset.
|
||||
* @returns {Point}
|
||||
* Point, line/column are undefined for invalid or out of bounds input.
|
||||
*
|
||||
* @callback ToOffset
|
||||
* Get an offset from a line/column-based `point`.
|
||||
* @param {Point | null | undefined} [point]
|
||||
* Something that should be a `point.
|
||||
* @returns {number}
|
||||
* Offset or `-1` for invalid or out of bounds input.
|
||||
*
|
||||
* @typedef Location
|
||||
* Accessors for index.
|
||||
* @property {ToPoint} toPoint
|
||||
* Get a line/column-based `point` from `offset`.
|
||||
* @property {ToOffset} toOffset
|
||||
* Get an offset from a line/column-based `point`.
|
||||
*/
|
||||
|
||||
/**
|
||||
* Index the given document so you can translate between line/column and offset
|
||||
* based positional info.
|
||||
*
|
||||
* @param {VFile | Value} file
|
||||
* File to index.
|
||||
* @returns {Location}
|
||||
* Accessors for index.
|
||||
*/
|
||||
export function location(file) {
|
||||
const value = String(file)
|
||||
/** @type {Array<number>} */
|
||||
const indices = []
|
||||
const search = /\r?\n|\r/g
|
||||
|
||||
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
|
||||
}
|
||||
}
|
||||
}
|
||||
}
|
||||
|
||||
return {line: undefined, column: undefined, offset: undefined}
|
||||
}
|
||||
|
||||
/** @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
|
||||
}
|
||||
}
|
||||
|
||||
return -1
|
||||
}
|
||||
}
|
||||
22
node_modules/vfile-location/license
generated
vendored
Normal file
22
node_modules/vfile-location/license
generated
vendored
Normal file
|
|
@ -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.
|
||||
81
node_modules/vfile-location/package.json
generated
vendored
Normal file
81
node_modules/vfile-location/package.json
generated
vendored
Normal file
|
|
@ -0,0 +1,81 @@
|
|||
{
|
||||
"name": "vfile-location",
|
||||
"version": "4.1.0",
|
||||
"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",
|
||||
"main": "index.js",
|
||||
"types": "index.d.ts",
|
||||
"files": [
|
||||
"lib/",
|
||||
"index.d.ts",
|
||||
"index.js"
|
||||
],
|
||||
"dependencies": {
|
||||
"@types/unist": "^2.0.0",
|
||||
"vfile": "^5.0.0"
|
||||
},
|
||||
"devDependencies": {
|
||||
"@types/node": "^18.0.0",
|
||||
"c8": "^7.0.0",
|
||||
"prettier": "^2.0.0",
|
||||
"remark-cli": "^11.0.0",
|
||||
"remark-preset-wooorm": "^9.0.0",
|
||||
"type-coverage": "^2.0.0",
|
||||
"typescript": "^4.0.0",
|
||||
"xo": "^0.53.0"
|
||||
},
|
||||
"scripts": {
|
||||
"prepack": "npm run build && npm run format",
|
||||
"build": "tsc --build --clean && tsc --build && type-coverage",
|
||||
"format": "remark . -qfo && prettier . -w --loglevel warn && xo --fix",
|
||||
"test-api": "node --conditions development test.js",
|
||||
"test-coverage": "c8 --check-coverage --100 --reporter lcov npm run test-api",
|
||||
"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": [
|
||||
"remark-preset-wooorm"
|
||||
]
|
||||
},
|
||||
"typeCoverage": {
|
||||
"atLeast": 100,
|
||||
"detail": true,
|
||||
"strict": true
|
||||
}
|
||||
}
|
||||
185
node_modules/vfile-location/readme.md
generated
vendored
Normal file
185
node_modules/vfile-location/readme.md
generated
vendored
Normal file
|
|
@ -0,0 +1,185 @@
|
|||
# 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 14.14+ and 16.0+), install with [npm][]:
|
||||
|
||||
```sh
|
||||
npm install vfile-location
|
||||
```
|
||||
|
||||
In Deno with [`esm.sh`][esmsh]:
|
||||
|
||||
```js
|
||||
import {location} from 'https://esm.sh/vfile-location@4'
|
||||
```
|
||||
|
||||
In browsers with [`esm.sh`][esmsh]:
|
||||
|
||||
```html
|
||||
<script type="module">
|
||||
import {location} from 'https://esm.sh/vfile-location@4?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)`
|
||||
|
||||
Index the given document so you can translate between line/column and offset
|
||||
based positional info.
|
||||
|
||||
###### Parameters
|
||||
|
||||
* `file` (`string`, `Buffer`, or [`VFile`][vfile])
|
||||
— file to index
|
||||
|
||||
###### Returns
|
||||
|
||||
Accessors for index ([`Location`][api-location-map]).
|
||||
|
||||
### `Location`
|
||||
|
||||
Accessors for index (TypeScript type).
|
||||
|
||||
###### Fields
|
||||
|
||||
* `toPoint` (`(offset?: number) => Point`)
|
||||
— get a line/column-based [`Point`][point] from `offset`
|
||||
* `toOffset` (`(point?: Point) => number`)
|
||||
— get an offset from a line/column-based [`point`][point]
|
||||
|
||||
## 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 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.
|
||||
|
||||
## 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/bundlephobia/minzip/vfile-location.svg
|
||||
|
||||
[size]: https://bundlephobia.com/result?p=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
|
||||
Loading…
Add table
Add a link
Reference in a new issue