Files
Loki/frontend/node_modules/unist-util-position/readme.md
T
MichaelandClaude Opus 5 b405adea6c Jauge de contexte, espace disque sur partage agrégé, panneau Fichiers
Trois défauts sans rapport entre eux, tous visibles à l'écran.

Jauge de contexte bloquée à « 0 / N (0 %) » : le comptage exact vient de
usage.prompt_tokens (include_usage), qu'un llama-server récent a cessé de
renvoyer. On note désormais si l'usage est arrivé ; sinon la fin de tour
publie l'estimation qui pilote déjà la compaction — approximative, mais
jamais absente. Et la souscription envoie la valeur courante juste après
le rattrapage : une page rechargée affichait zéro sur une discussion
pourtant pleine, faute d'événement ctx_used dans la fenêtre rejouée.

Espace disque : « il ne reste que 11,9 Go » sur un partage Unraid qui en
a des centaines. /mnt/user est servi par shfs, un FUSE qui agrège
plusieurs disques — statfs y renvoie l'espace d'un seul, et ce chiffre
REFUSAIT l'installation du modèle. Les systèmes de fichiers qui
approximent (FUSE, overlay, NFS, CIFS, Ceph, Gluster) sont reconnus par
leur magie : leur chiffre reste affiché, précédé d'un « ~ », mais ne
bloque plus rien.

Panneau Fichiers : le panneau entier défilait, emportant vers le haut
l'en-tête, le fil d'Ariane et le pied (occupation disque, bouton .zip)
dès qu'il y avait quelques fichiers. Seule la liste défile maintenant ;
le pied reste en bas et l'état vide se centre.

Co-Authored-By: Claude Opus 5 <noreply@anthropic.com>
2026-08-19 08:28:53 +02:00

244 lines
6.4 KiB
Markdown
Raw Blame History

This file contains ambiguous Unicode characters
This file contains Unicode characters that might be confused with other characters. If you think that this is intentional, you can safely ignore this warning. Use the Escape button to reveal them.
# unist-util-position
[![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]
[unist][] utility to get positional info of nodes.
## Contents
* [What is this?](#what-is-this)
* [When should I use this?](#when-should-i-use-this)
* [Install](#install)
* [Use](#use)
* [API](#api)
* [`position(node)`](#positionnode)
* [`pointEnd(node)`](#pointendnode)
* [`pointStart(node)`](#pointstartnode)
* [Types](#types)
* [Compatibility](#compatibility)
* [Related](#related)
* [Contribute](#contribute)
* [License](#license)
## What is this?
This utility helps with accessing positional info on a potentially dirty tree.
## When should I use this?
The positional info is typically consistent and proper in unist trees generated
by our ecosystem, but, user plugins could mess that up.
If you’re making a reusable plugin, and accessing the positional info often, you
might want to guard against that by using this utility.
You might also find the utility [`unist-util-generated`][unist-util-generated]
useful to check whether a node is considered to be generated (not in the
original input file).
You might also enjoy
[`unist-util-stringify-position`][unist-util-stringify-position] when you want
to display positional info to users.
## Install
This package is [ESM only][esm].
In Node.js (version 16+), install with [npm][]:
```sh
npm install unist-util-position
```
In Deno with [`esm.sh`][esmsh]:
```js
import {pointEnd, pointStart, position} from 'https://esm.sh/unist-util-position@5'
```
In browsers with [`esm.sh`][esmsh]:
```html
<script type="module">
import {pointEnd, pointStart, position} from 'https://esm.sh/unist-util-position@5?bundle'
</script>
```
## Use
```js
import {fromMarkdown} from 'mdast-util-from-markdown'
import {pointEnd, pointStart, position} from 'unist-util-position'
const tree = fromMarkdown('# foo\n\n* bar\n')
console.log(position(tree))
console.log(pointStart(tree))
console.log(pointEnd(tree))
```
Yields:
```js
{start: {line: 1, column: 1, offset: 0}, end: {line: 4, column: 1, offset: 13}}
{line: 1, column: 1, offset: 0}
{line: 4, column: 1, offset: 13}
```
## API
This package exports the identifiers [`pointEnd`][pointend],
[`pointStart`][pointstart], and [`position`][position].
There is no default export.
### `position(node)`
Get the positional info of `node`.
###### Parameters
* `node` ([`Node`][node])
— node
###### Returns
Position, if valid ([`Position`][unist-position] or `undefined`).
### `pointEnd(node)`
Get the ending point of `node`.
###### Parameters
* `node` ([`Node`][node])
— node
###### Returns
Point, if valid ([`Point`][unist-point] or `undefined`).
### `pointStart(node)`
Get the starting point of `node`.
###### Parameters
* `node` ([`Node`][node])
— node
###### Returns
Point, if valid ([`Point`][unist-point] or `undefined`).
## 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, `unist-util-position@^5`,
compatible with Node.js 16.
## Related
* [`unist-util-stringify-position`](https://github.com/syntax-tree/unist-util-stringify-position)
— serialize a node, position, or point as a human readable location
* [`unist-util-position-from-estree`](https://github.com/syntax-tree/unist-util-position-from-estree)
— get a position from an estree node
* [`unist-util-remove-position`](https://github.com/syntax-tree/unist-util-remove-position)
— remove positions from tree
* [`unist-util-generated`](https://github.com/syntax-tree/unist-util-generated)
— check if a node is generated
* [`unist-util-source`](https://github.com/syntax-tree/unist-util-source)
— get the source of a node
## Contribute
See [`contributing.md`][contributing] in [`syntax-tree/.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/syntax-tree/unist-util-position/workflows/main/badge.svg
[build]: https://github.com/syntax-tree/unist-util-position/actions
[coverage-badge]: https://img.shields.io/codecov/c/github/syntax-tree/unist-util-position.svg
[coverage]: https://codecov.io/github/syntax-tree/unist-util-position
[downloads-badge]: https://img.shields.io/npm/dm/unist-util-position.svg
[downloads]: https://www.npmjs.com/package/unist-util-position
[size-badge]: https://img.shields.io/badge/dynamic/json?label=minzipped%20size&query=$.size.compressedSize&url=https://deno.bundlejs.com/?q=unist-util-position
[size]: https://bundlejs.com/?q=unist-util-position
[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/syntax-tree/unist/discussions
[npm]: https://docs.npmjs.com/cli/install
[esm]: https://gist.github.com/sindresorhus/a39789f98801d908bbc7ff3ecc99d99c
[esmsh]: https://esm.sh
[typescript]: https://www.typescriptlang.org
[license]: license
[author]: https://wooorm.com
[health]: https://github.com/syntax-tree/.github
[contributing]: https://github.com/syntax-tree/.github/blob/main/contributing.md
[support]: https://github.com/syntax-tree/.github/blob/main/support.md
[coc]: https://github.com/syntax-tree/.github/blob/main/code-of-conduct.md
[unist]: https://github.com/syntax-tree/unist
[node]: https://github.com/syntax-tree/unist#node
[unist-position]: https://github.com/syntax-tree/unist#position
[unist-point]: https://github.com/syntax-tree/unist#point
[unist-util-generated]: https://github.com/syntax-tree/unist-util-generated
[unist-util-stringify-position]: https://github.com/syntax-tree/unist-util-stringify-position
[position]: #positionnode
[pointend]: #pointendnode
[pointstart]: #pointstartnode