@tiangong-lca/pcr 0.3.1 → 0.4.1

package/node_modules/micromark-extension-gfm-autolink-literal/license

@@ -0,0 +1,22 @@
+(The MIT License)
+
+Copyright (c) 2020 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.

package/node_modules/micromark-extension-gfm-autolink-literal/package.json

@@ -0,0 +1,116 @@
+{
+  "name": "micromark-extension-gfm-autolink-literal",
+  "version": "2.1.0",
+  "description": "micromark extension to support GFM autolink literals",
+  "license": "MIT",
+  "keywords": [
+    "micromark",
+    "micromark-extension",
+    "literal",
+    "url",
+    "autolink",
+    "auto",
+    "link",
+    "gfm",
+    "markdown",
+    "unified"
+  ],
+  "repository": "micromark/micromark-extension-gfm-autolink-literal",
+  "bugs": "https://github.com/micromark/micromark-extension-gfm-autolink-literal/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)"
+  ],
+  "sideEffects": false,
+  "type": "module",
+  "files": [
+    "dev/",
+    "lib/",
+    "index.d.ts",
+    "index.js"
+  ],
+  "exports": {
+    "development": "./dev/index.js",
+    "default": "./index.js"
+  },
+  "dependencies": {
+    "micromark-util-character": "^2.0.0",
+    "micromark-util-sanitize-uri": "^2.0.0",
+    "micromark-util-symbol": "^2.0.0",
+    "micromark-util-types": "^2.0.0"
+  },
+  "devDependencies": {
+    "@types/node": "^20.0.0",
+    "c8": "^10.0.0",
+    "create-gfm-fixtures": "^1.0.0",
+    "micromark": "^4.0.0",
+    "micromark-build": "^2.0.0",
+    "prettier": "^3.0.0",
+    "rehype": "^13.0.0",
+    "remark-cli": "^12.0.0",
+    "remark-preset-wooorm": "^10.0.0",
+    "type-coverage": "^2.0.0",
+    "typescript": "^5.0.0",
+    "xo": "^0.58.0"
+  },
+  "scripts": {
+    "prepack": "npm run build && npm run format",
+    "build": "tsc --build --clean && tsc --build && type-coverage && micromark-build",
+    "format": "remark . -qfo && prettier . -w --log-level warn && xo --fix",
+    "test-api-prod": "node --conditions production test/index.js",
+    "test-api-dev": "node --conditions development test/index.js",
+    "test-api": "npm run test-api-dev && npm run test-api-prod",
+    "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": {
+      "complexity": "off",
+      "unicorn/no-this-assignment": "off",
+      "unicorn/prefer-at": "off",
+      "unicorn/prefer-string-replace-all": "off"
+    },
+    "overrides": [
+      {
+        "files": [
+          "**/*.ts"
+        ],
+        "rules": {
+          "@typescript-eslint/consistent-type-definitions": 0
+        }
+      },
+      {
+        "files": [
+          "test/**/*.js"
+        ],
+        "rules": {
+          "no-await-in-loop": 0
+        }
+      }
+    ]
+  }
+}

package/node_modules/micromark-extension-gfm-autolink-literal/readme.md

@@ -0,0 +1,422 @@
+# micromark-extension-gfm-autolink-literal
+
+[![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]
+
+[micromark][] extensions to support GFM [literal autolinks][spec].
+
+## Contents
+
+* [What is this?](#what-is-this)
+* [When to use this](#when-to-use-this)
+* [Install](#install)
+* [Use](#use)
+* [API](#api)
+  * [`gfmAutolinkLiteral()`](#gfmautolinkliteral)
+  * [`gfmAutolinkLiteralHtml()`](#gfmautolinkliteralhtml)
+* [Bugs](#bugs)
+* [Authoring](#authoring)
+* [HTML](#html)
+* [CSS](#css)
+* [Syntax](#syntax)
+* [Types](#types)
+* [Compatibility](#compatibility)
+* [Security](#security)
+* [Related](#related)
+* [Contribute](#contribute)
+* [License](#license)
+
+## What is this?
+
+This package contains extensions that add support for the extra autolink syntax
+enabled by GFM to [`micromark`][micromark].
+
+GitHub employs different algorithms to autolink: one at parse time and one at
+transform time (similar to how @mentions are done at transform time).
+This difference can be observed because character references and escapes are
+handled differently.
+But also because issues/PRs/comments omit (perhaps by accident?) the second
+algorithm for `www.`, `http://`, and `https://` links (but not for email links).
+
+As this is a syntax extension, it focuses on the first algorithm.
+The second algorithm is performed by
+[`mdast-util-gfm-autolink-literal`][mdast-util-gfm-autolink-literal].
+The `html` part of this micromark extension does not operate on an AST and hence
+can’t perform the second algorithm.
+
+The implementation of autolink literal on github.com is currently buggy.
+The bugs have been reported on [`cmark-gfm`][cmark-gfm].
+This micromark extension matches github.com except for its bugs.
+
+## When to use this
+
+This project is useful when you want to support autolink literals in markdown.
+
+You can use these extensions when you are working with [`micromark`][micromark].
+To support all GFM features, use
+[`micromark-extension-gfm`][micromark-extension-gfm] instead.
+
+When you need a syntax tree, combine this package with
+[`mdast-util-gfm-autolink-literal`][mdast-util-gfm-autolink-literal].
+
+All these packages are used in [`remark-gfm`][remark-gfm], which focusses on
+making it easier to transform content by abstracting these internals away.
+
+## Install
+
+This package is [ESM only][esm].
+In Node.js (version 16+), install with [npm][]:
+
+```sh
+npm install micromark-extension-gfm-autolink-literal
+```
+
+In Deno with [`esm.sh`][esmsh]:
+
+```js
+import {gfmAutolinkLiteral, gfmAutolinkLiteralHtml} from 'https://esm.sh/micromark-extension-gfm-autolink-literal@2'
+```
+
+In browsers with [`esm.sh`][esmsh]:
+
+```html
+<script type="module">
+  import {gfmAutolinkLiteral, gfmAutolinkLiteralHtml} from 'https://esm.sh/micromark-extension-gfm-autolink-literal@2?bundle'
+</script>
+```
+
+## Use
+
+```js
+import {micromark} from 'micromark'
+import {
+  gfmAutolinkLiteral,
+  gfmAutolinkLiteralHtml
+} from 'micromark-extension-gfm-autolink-literal'
+
+const output = micromark('Just a URL: www.example.com.', {
+  extensions: [gfmAutolinkLiteral()],
+  htmlExtensions: [gfmAutolinkLiteralHtml()]
+})
+
+console.log(output)
+```
+
+Yields:
+
+```html
+<p>Just a URL: <a href="http://www.example.com">www.example.com</a>.</p>
+```
+
+## API
+
+This package exports the identifiers
+[`gfmAutolinkLiteral`][api-gfm-autolink-literal] and
+[`gfmAutolinkLiteralHtml`][api-gfm-autolink-literal-html].
+There is no default export.
+
+The export map supports the [`development` condition][development].
+Run `node --conditions development module.js` to get instrumented dev code.
+Without this condition, production code is loaded.
+
+### `gfmAutolinkLiteral()`
+
+Create an extension for `micromark` to support GitHub autolink literal
+syntax.
+
+###### Parameters
+
+Extension for `micromark` that can be passed in `extensions` to enable GFM
+autolink literal syntax ([`Extension`][micromark-extension]).
+
+### `gfmAutolinkLiteralHtml()`
+
+Create an HTML extension for `micromark` to support GitHub autolink literal
+when serializing to HTML.
+
+###### Parameters
+
+Extension for `micromark` that can be passed in `htmlExtensions` to support
+GitHub autolink literal when serializing to HTML
+([`HtmlExtension`][micromark-html-extension]).
+
+## Bugs
+
+GitHub’s own algorithm to parse autolink literals contains three bugs.
+A smaller bug is left unfixed in this project for consistency.
+Two main bugs are not present in this project.
+The issues relating to autolink literals are:
+
+* [GFM autolink extension (`www.`, `https?://` parts): links don’t work when
+  after bracket](https://github.com/github/cmark-gfm/issues/278)\
+  fixed here ✅
+* [GFM autolink extension (`www.` part): uppercase does not match on
+  issues/PRs/comments](https://github.com/github/cmark-gfm/issues/280)\
+  fixed here ✅
+* [GFM autolink extension (`www.` part): the word `www`
+  matches](https://github.com/github/cmark-gfm/issues/279)\
+  present here for consistency
+
+## Authoring
+
+It is recommended to use labels, either with a resource or a definition,
+instead of autolink literals, as those allow relative URLs and descriptive
+text to explain the URL in prose.
+
+## HTML
+
+GFM autolink literals relate to the `<a>` element in HTML.
+See [*§ 4.5.1 The `a` element*][html-a] in the HTML spec for more info.
+When an email autolink is used, the string `mailto:` is prepended when
+generating the `href` attribute of the hyperlink.
+When a www autolink is used, the string `http://` is prepended.
+
+## CSS
+
+As hyperlinks are the fundamental thing that makes the web, you will most
+definitely have CSS for `a` elements already.
+The same CSS can be used for autolink literals, too.
+
+GitHub itself does not apply interesting CSS to autolink literals.
+For any link, it currently (June 2022) [uses][css]:
+
+```css
+a {
+  background-color: transparent;
+  color: #58a6ff;
+  text-decoration: none;
+}
+
+a:active,
+a:hover {
+  outline-width: 0;
+}
+
+a:hover {
+  text-decoration: underline;
+}
+
+a:not([href]) {
+  color: inherit;
+  text-decoration: none;
+}
+```
+
+## Syntax
+
+Autolink literals form with, roughly, the following BNF:
+
+```bnf
+gfm_autolink_literal ::= gfm_protocol_autolink | gfm_www_autolink | gfm_email_autolink
+
+; Restriction: the code before must be `www_autolink_before`.
+; Restriction: the code after `.` must not be eof.
+www_autolink ::= 3('w' | 'W') '.' [domain [path]]
+www_autolink_before ::= eof | eol | space_or_tab | '(' | '*' | '_' | '[' | ']' | '~'
+
+; Restriction: the code before must be `http_autolink_before`.
+; Restriction: the code after the protocol must be `http_autolink_protocol_after`.
+http_autolink ::= ('h' | 'H') 2('t' | 'T') ('p' | 'P') ['s' | 'S'] ':' 2'/' domain [path]
+http_autolink_before ::= byte - ascii_alpha
+http_autolink_protocol_after ::= byte - eof - eol - ascii_control - unicode_whitespace - ode_punctuation
+
+; Restriction: the code before must be `email_autolink_before`.
+; Restriction: `ascii_digit` may not occur in the last label part of the label.
+email_autolink ::= 1*('+' | '-' | '.' | '_' | ascii_alphanumeric) '@' 1*(1*label_segment l_dot_cont) 1*label_segment
+email_autolink_before ::= byte - ascii_alpha - '/'
+
+; Restriction: `_` may not occur in the last two domain parts.
+domain ::= 1*(url_ampt_cont | domain_punct_cont | '-' | byte - eof - ascii_control - ode_whitespace - unicode_punctuation)
+; Restriction: must not be followed by `punct`.
+domain_punct_cont ::= '.' | '_'
+; Restriction: must not be followed by `char-ref`.
+url_ampt_cont ::= '&'
+
+; Restriction: a counter `balance = 0` is increased for every `(`, and decreased for every `)`.
+; Restriction: `)` must not be `paren_at_end`.
+path ::= 1*(url_ampt_cont | path_punctuation_cont | '(' | ')' | byte - eof - eol - space_or_tab)
+; Restriction: must not be followed by `punct`.
+path_punctuation_cont ::= trailing_punctuation - '<'
+; Restriction: must be followed by `punct` and `balance` must be less than `0`.
+paren_at_end ::= ')'
+
+label_segment ::= label_dash_underscore_cont | ascii_alpha | ascii_digit
+; Restriction: if followed by `punct`, the whole email autolink is invalid.
+label_dash_underscore_cont ::= '-' | '_'
+; Restriction: must not be followed by `punct`.
+label_dot_cont ::= '.'
+
+punct ::= *trailing_punctuation ( byte - eof - eol - space_or_tab - '<' )
+char_ref ::= *ascii_alpha ';' path_end
+trailing_punctuation ::= '!' | '"' | '\'' | ')' | '*' | ',' | '.' | ':' | ';' | '<' | '?' | '_' | '~'
+```
+
+The grammar for GFM autolink literal is very relaxed: basically anything
+except for whitespace is allowed after a prefix.
+To use whitespace characters and otherwise impossible characters, in URLs,
+you can use percent encoding:
+
+```markdown
+https://example.com/alpha%20bravo
+```
+
+Yields:
+
+```html
+<p><a href="https://example.com/alpha%20bravo">https://example.com/alpha%20bravo</a></p>
+```
+
+There are several cases where incorrect encoding of URLs would, in other
+languages, result in a parse error.
+In markdown, there are no errors, and URLs are normalized.
+In addition, many characters are percent encoded
+([`sanitizeUri`][micromark-util-sanitize-uri]).
+For example:
+
+```markdown
+www.a👍b%
+```
+
+Yields:
+
+```html
+<p><a href="http://www.a%F0%9F%91%8Db%25">www.a👍b%</a></p>
+```
+
+There is a big difference between how www and protocol literals work
+compared to how email literals work.
+The first two are done when parsing, and work like anything else in
+markdown.
+But email literals are handled afterwards: when everything is parsed, we
+look back at the events to figure out if there were email addresses.
+This particularly affects how they interleave with character escapes and
+character references.
+
+## Types
+
+This package is fully typed with [TypeScript][].
+It exports no additional types.
+
+## 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,
+`micromark-extension-gfm-autolink-literal@^2`, compatible with Node.js 16.
+
+This package works with `micromark` version `3` and later.
+
+## Security
+
+This package is safe.
+Unlike other links in CommonMark, which allow arbitrary protocols, this
+construct always produces safe links.
+
+## Related
+
+* [`micromark-extension-gfm`][micromark-extension-gfm]
+  — support all of GFM
+* [`mdast-util-gfm-autolink-literal`][mdast-util-gfm-autolink-literal]
+  — support all of GFM in mdast
+* [`mdast-util-gfm`][mdast-util-gfm]
+  — support all of GFM in mdast
+* [`remark-gfm`][remark-gfm]
+  — support all of GFM in remark
+
+## Contribute
+
+See [`contributing.md` in `micromark/.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] © [Titus Wormer][author]
+
+<!-- Definitions -->
+
+[build-badge]: https://github.com/micromark/micromark-extension-gfm-autolink-literal/workflows/main/badge.svg
+
+[build]: https://github.com/micromark/micromark-extension-gfm-autolink-literal/actions
+
+[coverage-badge]: https://img.shields.io/codecov/c/github/micromark/micromark-extension-gfm-autolink-literal.svg
+
+[coverage]: https://codecov.io/github/micromark/micromark-extension-gfm-autolink-literal
+
+[downloads-badge]: https://img.shields.io/npm/dm/micromark-extension-gfm-autolink-literal.svg
+
+[downloads]: https://www.npmjs.com/package/micromark-extension-gfm-autolink-literal
+
+[size-badge]: https://img.shields.io/badge/dynamic/json?label=minzipped%20size&query=$.size.compressedSize&url=https://deno.bundlejs.com/?q=micromark-extension-gfm-autolink-literal
+
+[size]: https://bundlejs.com/?q=micromark-extension-gfm-autolink-literal
+
+[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/micromark/micromark/discussions
+
+[npm]: https://docs.npmjs.com/cli/install
+
+[esmsh]: https://esm.sh
+
+[license]: license
+
+[author]: https://wooorm.com
+
+[contributing]: https://github.com/micromark/.github/blob/main/contributing.md
+
+[support]: https://github.com/micromark/.github/blob/main/support.md
+
+[coc]: https://github.com/micromark/.github/blob/main/code-of-conduct.md
+
+[esm]: https://gist.github.com/sindresorhus/a39789f98801d908bbc7ff3ecc99d99c
+
+[typescript]: https://www.typescriptlang.org
+
+[development]: https://nodejs.org/api/packages.html#packages_resolving_user_conditions
+
+[micromark]: https://github.com/micromark/micromark
+
+[micromark-extension-gfm]: https://github.com/micromark/micromark-extension-gfm
+
+[micromark-util-sanitize-uri]: https://github.com/micromark/micromark/tree/main/packages/micromark-util-sanitize-uri
+
+[micromark-extension]: https://github.com/micromark/micromark#syntaxextension
+
+[micromark-html-extension]: https://github.com/micromark/micromark#htmlextension
+
+[mdast-util-gfm]: https://github.com/syntax-tree/mdast-util-gfm
+
+[mdast-util-gfm-autolink-literal]: https://github.com/syntax-tree/mdast-util-gfm-autolink-literal
+
+[remark-gfm]: https://github.com/remarkjs/remark-gfm
+
+[spec]: https://github.github.com/gfm/#autolinks-extension-
+
+[html-a]: https://html.spec.whatwg.org/multipage/text-level-semantics.html#the-a-element
+
+[css]: https://github.com/sindresorhus/github-markdown-css
+
+[cmark-gfm]: https://github.com/github/cmark-gfm
+
+[api-gfm-autolink-literal]: #gfmautolinkliteral
+
+[api-gfm-autolink-literal-html]: #gfmautolinkliteralhtml