Brunobkr/llama.cpp_AlgMor24_github

1# hast-util-parse-selector2 3[![Build][build-badge]][build]4[![Coverage][coverage-badge]][coverage]5[![Downloads][downloads-badge]][downloads]6[![Size][size-badge]][size]7[![Sponsors][sponsors-badge]][collective]8[![Backers][backers-badge]][collective]9[![Chat][chat-badge]][chat]10 11[hast][] utility to create an element from a simple CSS selector.12 13## Contents14 15*   [What is this?](#what-is-this)16*   [When should I use this?](#when-should-i-use-this)17*   [Install](#install)18*   [Use](#use)19*   [API](#api)20    *   [`parseSelector(selector?[, defaultTagName])`](#parseselectorselector-defaulttagname)21*   [Types](#types)22*   [Compatibility](#compatibility)23*   [Security](#security)24*   [Related](#related)25*   [Contribute](#contribute)26*   [License](#license)27 28## What is this?29 30This package is a tiny utility that helps create elements.31 32## When should I use this?33 34This utility is super niche.35You probably want the more powerful [`hastscript`][hastscript] or36[`hast-util-from-selector`][hast-util-from-selector]37 38## Install39 40This package is [ESM only][esm].41In Node.js (version 16+), install with [npm][]:42 43```sh44npm install hast-util-parse-selector45```46 47In Deno with [`esm.sh`][esmsh]:48 49```js50import {parseSelector} from 'https://esm.sh/hast-util-parse-selector@4'51```52 53In browsers with [`esm.sh`][esmsh]:54 55```html56<script type="module">57  import {parseSelector} from 'https://esm.sh/hast-util-parse-selector@4?bundle'58</script>59```60 61## Use62 63```js64import {parseSelector} from 'hast-util-parse-selector'65 66console.log(parseSelector('.quux#bar.baz.qux'))67```68 69Yields:70 71```js72{ type: 'element',73  tagName: 'div',74  properties: { id: 'bar', className: [ 'quux', 'baz', 'qux' ] },75  children: [] }76```77 78## API79 80This package exports the identifier [`parseSelector`][api-parse-selector].81There is no default export.82 83### `parseSelector(selector?[, defaultTagName])`84 85Create a hast element from a simple CSS selector.86 87###### Parameters88 89*   `selector` (`string`, optional)90    —  simple CSS selector, can contain a tag name (`foo`), classes (`.bar`),91    and an ID (`#baz`), multiple classes are allowed, uses the last ID if92    multiple IDs are found93*   `defaultTagName` (`string`, default: `'div'`)94    — tag name to use if `selector` does not specify one95 96###### Returns97 98Built element ([`Element`][element]).99 100## Types101 102This package is fully typed with [TypeScript][].103It exports no additional types.104 105## Compatibility106 107Projects maintained by the unified collective are compatible with maintained108versions of Node.js.109 110When we cut a new major release, we drop support for unmaintained versions of111Node.112This means we try to keep the current release line,113`hast-util-parse-selector@^4`, compatible with Node.js 16.114 115## Security116 117Improper use of the `selector` or `defaultTagName` can open you up to a118[cross-site scripting (XSS)][xss] attack as the value of `tagName`, when119resolving to `script`, injects a `script` element into the syntax tree.120 121Do not use user input in `selector` or use122[`hast-util-santize`][hast-util-sanitize].123 124## Related125 126*   [`hast-util-from-selector`](https://github.com/syntax-tree/hast-util-from-selector)127    — parse complex CSS selectors to nodes128 129## Contribute130 131See [`contributing.md`][contributing] in [`syntax-tree/.github`][health] for132ways to get started.133See [`support.md`][support] for ways to get help.134 135This project has a [code of conduct][coc].136By interacting with this repository, organization, or community you agree to137abide by its terms.138 139## License140 141[MIT][license] © [Titus Wormer][author]142 143<!-- Definitions -->144 145[build-badge]: https://github.com/syntax-tree/hast-util-parse-selector/workflows/main/badge.svg146 147[build]: https://github.com/syntax-tree/hast-util-parse-selector/actions148 149[coverage-badge]: https://img.shields.io/codecov/c/github/syntax-tree/hast-util-parse-selector.svg150 151[coverage]: https://codecov.io/github/syntax-tree/hast-util-parse-selector152 153[downloads-badge]: https://img.shields.io/npm/dm/hast-util-parse-selector.svg154 155[downloads]: https://www.npmjs.com/package/hast-util-parse-selector156 157[size-badge]: https://img.shields.io/badge/dynamic/json?label=minzipped%20size&query=$.size.compressedSize&url=https://deno.bundlejs.com/?q=hast-util-parse-selector158 159[size]: https://bundlejs.com/?q=hast-util-parse-selector160 161[sponsors-badge]: https://opencollective.com/unified/sponsors/badge.svg162 163[backers-badge]: https://opencollective.com/unified/backers/badge.svg164 165[collective]: https://opencollective.com/unified166 167[chat-badge]: https://img.shields.io/badge/chat-discussions-success.svg168 169[chat]: https://github.com/syntax-tree/unist/discussions170 171[npm]: https://docs.npmjs.com/cli/install172 173[esm]: https://gist.github.com/sindresorhus/a39789f98801d908bbc7ff3ecc99d99c174 175[esmsh]: https://esm.sh176 177[typescript]: https://www.typescriptlang.org178 179[license]: license180 181[author]: https://wooorm.com182 183[health]: https://github.com/syntax-tree/.github184 185[contributing]: https://github.com/syntax-tree/.github/blob/main/contributing.md186 187[support]: https://github.com/syntax-tree/.github/blob/main/support.md188 189[coc]: https://github.com/syntax-tree/.github/blob/main/code-of-conduct.md190 191[hast]: https://github.com/syntax-tree/hast192 193[hast-util-sanitize]: https://github.com/syntax-tree/hast-util-sanitize194 195[hastscript]: https://github.com/syntax-tree/hastscript196 197[hast-util-from-selector]: https://github.com/syntax-tree/hast-util-from-selector198 199[element]: https://github.com/syntax-tree/hast#element200 201[xss]: https://en.wikipedia.org/wiki/Cross-site_scripting202 203[api-parse-selector]: #parseselectorselector-defaulttagname204