@rse/ase 0.0.30 → 0.0.32

package/plugin/node_modules/micromark-extension-directive/lib/syntax.js

@@ -0,0 +1,25 @@
+/**
+ * @import {Extension} from 'micromark-util-types'
+ */
+
+import { directiveContainer } from './directive-container.js';
+import { directiveLeaf } from './directive-leaf.js';
+import { directiveText } from './directive-text.js';
+
+/**
+ * Create an extension for `micromark` to enable directive syntax.
+ *
+ * @returns {Extension}
+ *   Extension for `micromark` that can be passed in `extensions`, to
+ *   enable directive syntax.
+ */
+export function directive() {
+  return {
+    text: {
+      [58]: directiveText
+    },
+    flow: {
+      [58]: [directiveContainer, directiveLeaf]
+    }
+  };
+}

package/plugin/node_modules/micromark-extension-directive/license

@@ -0,0 +1,22 @@
+(The MIT License)
+
+Copyright (c) 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/plugin/node_modules/micromark-extension-directive/package.json

@@ -0,0 +1,124 @@
+{
+  "author": "Titus Wormer <tituswormer@gmail.com> (https://wooorm.com)",
+  "bugs": "https://github.com/micromark/micromark-extension-directive/issues",
+  "contributors": [
+    "Titus Wormer <tituswormer@gmail.com> (https://wooorm.com)"
+  ],
+  "dependencies": {
+    "devlop": "^1.0.0",
+    "micromark-factory-space": "^2.0.0",
+    "micromark-factory-whitespace": "^2.0.0",
+    "micromark-util-character": "^2.0.0",
+    "micromark-util-symbol": "^2.0.0",
+    "micromark-util-types": "^2.0.0",
+    "parse-entities": "^4.0.0"
+  },
+  "description": "micromark extension to support generic directives (`:cite[smith04]`)",
+  "devDependencies": {
+    "@types/node": "^22.0.0",
+    "c8": "^10.0.0",
+    "html-void-elements": "^3.0.0",
+    "micromark": "^4.0.0",
+    "micromark-build": "^2.0.0",
+    "prettier": "^3.0.0",
+    "remark-cli": "^12.0.0",
+    "remark-preset-wooorm": "^11.0.0",
+    "type-coverage": "^2.0.0",
+    "typescript": "^5.0.0",
+    "xo": "^0.60.0"
+  },
+  "exports": {
+    "development": "./dev/index.js",
+    "default": "./index.js"
+  },
+  "files": [
+    "dev/",
+    "index.d.ts",
+    "index.js",
+    "lib/"
+  ],
+  "funding": {
+    "type": "opencollective",
+    "url": "https://opencollective.com/unified"
+  },
+  "keywords": [
+    "container",
+    "directive",
+    "extension",
+    "generic",
+    "markdown",
+    "micromark-extension",
+    "micromark",
+    "unified"
+  ],
+  "license": "MIT",
+  "name": "micromark-extension-directive",
+  "prettier": {
+    "bracketSpacing": false,
+    "semi": false,
+    "singleQuote": true,
+    "tabWidth": 2,
+    "trailingComma": "none",
+    "useTabs": false
+  },
+  "remarkConfig": {
+    "plugins": [
+      "remark-preset-wooorm"
+    ]
+  },
+  "repository": "micromark/micromark-extension-directive",
+  "scripts": {
+    "build": "tsc --build --clean && tsc --build && type-coverage && micromark-build",
+    "format": "remark --frail --output --quiet -- . && prettier --log-level warn --write -- . && 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"
+  },
+  "sideEffects": false,
+  "typeCoverage": {
+    "atLeast": 100,
+    "strict": true
+  },
+  "type": "module",
+  "version": "4.0.0",
+  "xo": {
+    "overrides": [
+      {
+        "files": [
+          "**/*.d.ts"
+        ],
+        "rules": {
+          "@typescript-eslint/array-type": [
+            "error",
+            {
+              "default": "generic"
+            }
+          ],
+          "@typescript-eslint/ban-types": [
+            "error",
+            {
+              "extendDefaults": true
+            }
+          ],
+          "@typescript-eslint/consistent-indexed-object-style": [
+            "error",
+            "index-signature"
+          ],
+          "@typescript-eslint/consistent-type-definitions": [
+            "error",
+            "interface"
+          ]
+        }
+      }
+    ],
+    "prettier": true,
+    "rules": {
+      "logical-assignment-operators": "off",
+      "max-params": "off",
+      "unicorn/no-this-assignment": "off",
+      "unicorn/prefer-at": "off"
+    }
+  }
+}

package/plugin/node_modules/micromark-extension-directive/readme.md

@@ -0,0 +1,451 @@
+# micromark-extension-directive
+
+[![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 [directives][prop] (`:cite[smith04]` and
+such).
+
+## Contents
+
+* [What is this?](#what-is-this)
+* [When to use this](#when-to-use-this)
+* [Install](#install)
+* [Use](#use)
+* [API](#api)
+  * [`directive()`](#directive)
+  * [`directiveHtml(options?)`](#directivehtmloptions)
+  * [`Directive`](#directive-1)
+  * [`Handle`](#handle)
+  * [`HtmlOptions`](#htmloptions)
+* [Authoring](#authoring)
+* [HTML](#html)
+* [CSS](#css)
+* [Syntax](#syntax)
+* [Compatibility](#compatibility)
+* [Security](#security)
+* [Related](#related)
+* [Contribute](#contribute)
+* [License](#license)
+
+## What is this?
+
+This package contains two extensions that add support for directive syntax in
+markdown to [`micromark`][micromark].
+
+## When to use this
+
+This project is useful when you want to solve the need for an infinite number
+of potential extensions to markdown in a single markdown-esque way.
+
+You can use these extensions when you are working with [`micromark`][micromark]
+already.
+
+When you need a syntax tree,
+you can combine this package with
+[`mdast-util-directive`][mdast-util-directive].
+
+All these packages are used [`remark-directive`][remark-directive],
+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][]:
+
+[npm][]:
+
+```sh
+npm install micromark-extension-directive
+```
+
+In Deno with [`esm.sh`][esmsh]:
+
+```js
+import {directive, directiveHtml} from 'https://esm.sh/micromark-extension-directive@4'
+```
+
+In browsers with [`esm.sh`][esmsh]:
+
+```html
+<script type="module">
+  import {directive, directiveHtml} from 'https://esm.sh/micromark-extension-directive@4?bundle'
+</script>
+```
+
+## Use
+
+Say our document `example.md` contains:
+
+```markdown
+A lovely language know as :abbr[HTML]{title="HyperText Markup Language"}.
+```
+
+…and our module `example.js` looks as follows:
+
+```js
+/**
+ * @import {Handle} from 'micromark-extension-directive'
+ * @import {CompileContext} from 'micromark-util-types'
+ */
+
+import fs from 'node:fs/promises'
+import {micromark} from 'micromark'
+import {directive, directiveHtml} from 'micromark-extension-directive'
+
+const output = micromark(await fs.readFile('example.md'), {
+  extensions: [directive()],
+  htmlExtensions: [directiveHtml({abbr})]
+})
+
+console.log(output)
+
+/**
+ * @this {CompileContext}
+ * @type {Handle}
+ * @returns {false | undefined}
+ */
+function abbr(d) {
+  if (d.type !== 'textDirective') return false
+
+  this.tag('<abbr')
+
+  if (d.attributes && 'title' in d.attributes) {
+    this.tag(' title="' + this.encode(d.attributes.title) + '"')
+  }
+
+  this.tag('>')
+  this.raw(d.label || '')
+  this.tag('</abbr>')
+}
+```
+
+…now running `node example.js` yields:
+
+```html
+<p>A lovely language know as <abbr title="HyperText Markup Language">HTML</abbr>.</p>
+```
+
+## API
+
+This package exports the identifiers [`directive`][api-directive] and
+[`directiveHtml`][api-directive-html].
+There is no default export.
+It exports the [TypeScript][] types
+[`Directive`][api-directive-type],
+[`Handle`][api-handle],
+and [`HtmlOptions`][api-html-options].
+
+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.
+
+### `directive()`
+
+Create an extension for `micromark` to enable directive syntax.
+
+###### Returns
+
+Extension for `micromark` that can be passed in `extensions`,
+to enable directive syntax
+([`Extension`][micromark-extension]).
+
+### `directiveHtml(options?)`
+
+Create an extension for `micromark` to support directives when serializing to
+HTML.
+
+> 👉 **Note**:
+> this uses KaTeX to render math.
+
+###### Parameters
+
+* `options`
+  ([`HtmlOptions`][api-html-options], default: `{}`)
+  — configuration
+
+###### Returns
+
+Extension for `micromark` that can be passed in `htmlExtensions`,
+to support directives when serializing to HTML
+([`HtmlExtension`][micromark-html-extension]).
+
+### `Directive`
+
+Structure representing a directive (TypeScript type).
+
+###### Fields
+
+* `type`
+  (`'containerDirective'`, `'leafDirective'`, or `'textDirective'`)
+  — kind
+* `name`
+  (`string`)
+  — name of directive
+* `label`
+  (`string` or `undefined`)
+  — compiled HTML content that was in `[brackets]`
+* `attributes`
+  (`Record<string, string>` or `undefined`)
+  — object w/ HTML attributes
+* `content`
+  (`string` or `undefined`)
+  — compiled HTML content inside container directive
+
+### `Handle`
+
+Handle a directive (TypeScript type).
+
+###### Parameters
+
+* `this` ([`CompileContext`][micromark-compile-context])
+  — current context
+* `directive` ([`Directive`][api-directive-type])
+  — directive
+
+###### Returns
+
+Signal whether the directive was handled
+(`boolean`, default: `true`).
+Yield `false` to let the fallback (a special handle for `'*'`) handle it.
+
+### `HtmlOptions`
+
+Configuration (TypeScript type).
+
+> 👉 **Note**:
+> the special field `'*'` can be used to specify a fallback handle to handle
+> all otherwise unhandled directives.
+
+###### Type
+
+```ts
+type HtmlOptions = Record<string, Handle>
+```
+
+## Authoring
+
+When authoring markdown with directives,
+keep in mind that they don’t work in most places.
+On your own site it can be great!
+
+## HTML
+
+You can define how directives are turned into HTML.
+If directives are not handled,
+they do not emit anything.
+
+## CSS
+
+How to display directives is left as an exercise for the reader.
+
+## Syntax
+
+The syntax looks like this:
+
+```markdown
+Directives in text can form with a single colon,
+such as :cite[smith04].
+Their syntax is `:name[label]{attributes}`.
+
+Leafs (block without content) can form by using two colons:
+
+::youtube[Video of a cat in a box]{vid=01ab2cd3efg}
+
+Their syntax is `::name[label]{attributes}` on its own line.
+
+Containers (blocks with content) can form by using three colons:
+
+:::spoiler
+He dies.
+:::
+
+The `name` part is required.
+The first character must be a letter,
+other characters can be alphanumerical, `-`, and `_`.
+`-` or `_` cannot end a name.
+
+The `[label]` part is optional (`:x` and `:x[]` are equivalent)†.
+When used,
+it can include text constructs such as emphasis and so on: `x[a *b* c]`.
+
+The `{attributes}` part is optional (`:x` and `:x{}` are equivalent)†.
+When used,
+it is handled like HTML attributes, such as that `{a}`, `{a=""}`, and `{a=''}`
+but also `{a=b}`, `{a="b"}`, and `{a='b'}` are equivalent.
+Shortcuts are available for `id=` (`{#readme}` for `{id=readme}`) and
+`class` (`{.big}` for `{class=big}`).
+When multiple ids are found,
+the last is used; when multiple classes are found,
+they are combined:
+`{.red class=green .blue}` is equivalent to
+`{.red .green .blue}` and `{class="red green blue"}`.
+
+† there is one case where a name must be followed by an empty label or empty
+attributes:
+a *text* directive that only has a name,
+cannot be followed by a colon.
+So,
+`:red:` doesn’t work.
+Use either `:red[]` or `:red{}` instead.
+The reason for this is to allow GitHub emoji (gemoji) and directives to coexist.
+
+Containers can be nested by using more colons outside:
+
+::::spoiler
+He dies.
+
+:::spoiler
+She is born.
+:::
+::::
+
+The closing fence must include the same or more colons as the opening.
+If no closing is found,
+the container runs to the end of its parent container
+(block quote, list item, document, or other container).
+
+::::spoiler
+These three are not enough to close
+:::
+So this line is also part of the container.
+```
+
+Note that while other implementations are sometimes loose in what they allow,
+this implementation mimics CommonMark as closely as possible:
+
+* whitespace is not allowed between colons and name (~~`: a`~~),
+  name and label (~~`:a []`~~),
+  name and attributes (~~`:a {}`~~),
+  or label and attributes (~~`:a[] {}`~~)
+  — because it’s not allowed in links either
+  (~~`[] ()`~~)
+* no trailing colons allowed on the opening fence of a container
+  (~~`:::a:::`~~)
+  — because it’s not allowed in fenced code either
+* the label and attributes in a leaf or container cannot include line endings
+  (~~`::a[b\nc]`~~)
+  — because it’s not allowed in fenced code either
+
+## 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-directive@4`,
+compatible with Node.js 16.
+
+This package works with `micromark` version `4` and later.
+
+## Security
+
+This package is safe assuming that you write safe handlers.
+Any vulnerability in your code could open you to a
+[cross-site scripting (XSS)][xss] attack.
+
+## Related
+
+* [`remark-directive`][remark-directive]
+  — remark plugin to support directives
+* [`mdast-util-directive`][mdast-util-directive]
+  — mdast utility to support directives
+
+## 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 -->
+
+[api-directive]: #directive
+
+[api-directive-html]: #directivehtmloptions
+
+[api-directive-type]: #directive-1
+
+[api-handle]: #handle
+
+[api-html-options]: #htmloptions
+
+[author]: https://wooorm.com
+
+[backers-badge]: https://opencollective.com/unified/backers/badge.svg
+
+[build]: https://github.com/micromark/micromark-extension-directive/actions
+
+[build-badge]: https://github.com/micromark/micromark-extension-directive/workflows/main/badge.svg
+
+[chat]: https://github.com/micromark/micromark/discussions
+
+[chat-badge]: https://img.shields.io/badge/chat-discussions-success.svg
+
+[coc]: https://github.com/micromark/.github/blob/main/code-of-conduct.md
+
+[collective]: https://opencollective.com/unified
+
+[contributing]: https://github.com/micromark/.github/blob/main/contributing.md
+
+[coverage]: https://codecov.io/github/micromark/micromark-extension-directive
+
+[coverage-badge]: https://img.shields.io/codecov/c/github/micromark/micromark-extension-directive.svg
+
+[development]: https://nodejs.org/api/packages.html#packages_resolving_user_conditions
+
+[downloads]: https://www.npmjs.com/package/micromark-extension-directive
+
+[downloads-badge]: https://img.shields.io/npm/dm/micromark-extension-directive.svg
+
+[esm]: https://gist.github.com/sindresorhus/a39789f98801d908bbc7ff3ecc99d99c
+
+[esmsh]: https://esm.sh
+
+[license]: license
+
+[mdast-util-directive]: https://github.com/syntax-tree/mdast-util-directive
+
+[micromark]: https://github.com/micromark/micromark
+
+[micromark-compile-context]: https://github.com/micromark/micromark/blob/41e3c4c/packages/micromark-util-types/index.js#L457
+
+[micromark-extension]: https://github.com/micromark/micromark#syntaxextension
+
+[micromark-html-extension]: https://github.com/micromark/micromark#htmlextension
+
+[npm]: https://docs.npmjs.com/cli/install
+
+[prop]: https://talk.commonmark.org/t/generic-directives-plugins-syntax/444
+
+[remark-directive]: https://github.com/remarkjs/remark-directive
+
+[size]: https://bundlejs.com/?q=micromark-extension-directive
+
+[size-badge]: https://img.shields.io/badge/dynamic/json?label=minzipped%20size&query=$.size.compressedSize&url=https://deno.bundlejs.com/?q=micromark-extension-directive
+
+[sponsors-badge]: https://opencollective.com/unified/sponsors/badge.svg
+
+[support]: https://github.com/micromark/.github/blob/main/support.md
+
+[typescript]: https://www.typescriptlang.org
+
+[xss]: https://en.wikipedia.org/wiki/Cross-site_scripting

package/plugin/node_modules/micromark-extension-gfm-autolink-literal/dev/index.d.ts

@@ -0,0 +1,24 @@
+export {gfmAutolinkLiteral} from './lib/syntax.js'
+export {gfmAutolinkLiteralHtml} from './lib/html.js'
+
+/**
+ * Augment types.
+ */
+declare module 'micromark-util-types' {
+  /**
+   * Augment token with a field to improve performance.
+   */
+  interface Token {
+    _gfmAutolinkLiteralWalkedInto?: boolean
+  }
+
+  /**
+   * Token types.
+   */
+  interface TokenTypeMap {
+    literalAutolink: 'literalAutolink'
+    literalAutolinkEmail: 'literalAutolinkEmail'
+    literalAutolinkHttp: 'literalAutolinkHttp'
+    literalAutolinkWww: 'literalAutolinkWww'
+  }
+}

package/plugin/node_modules/micromark-extension-gfm-autolink-literal/dev/index.js

@@ -0,0 +1,2 @@
+export {gfmAutolinkLiteral} from './lib/syntax.js'
+export {gfmAutolinkLiteralHtml} from './lib/html.js'

package/plugin/node_modules/micromark-extension-gfm-autolink-literal/dev/lib/html.d.ts

@@ -0,0 +1,10 @@
+/**
+ * Create an HTML extension for `micromark` to support GitHub autolink literal
+ * when serializing to HTML.
+ *
+ * @returns {HtmlExtension}
+ *   Extension for `micromark` that can be passed in `htmlExtensions` to
+ *   support GitHub autolink literal when serializing to HTML.
+ */
+export function gfmAutolinkLiteralHtml(): HtmlExtension;
+import type { HtmlExtension } from 'micromark-util-types';