Bounding rectangle coordinates for highlight positioning. All values stored as strings to preserve floating-point precision since ATProto only supports integer type.

Properties

height

requiredstring

Page height reference (as string to preserve float precision)

pageNumber

requiredinteger

1-indexed page number for the bounding rectangle

minimum: 1

width

requiredstring

Page width reference (as string to preserve float precision)

x1

requiredstring

Left edge coordinate (as string to preserve float precision)

x2

requiredstring

Right edge coordinate (as string to preserve float precision)

y1

requiredstring

Top edge coordinate (as string to preserve float precision)

y2

requiredstring

Bottom edge coordinate (as string to preserve float precision)

#eprintLink

object

Link to another eprint/preprint

Properties

doi

string

DOI if available

title

requiredstring

Eprint title

type

requiredstring

const: "eprint"

uri

requiredstring · at-uri

AT-URI of the eprint

#externalIdLink

object

Link to an external identifier (Wikidata, ROR, ORCID, etc.)

Properties

identifier

requiredstring

Identifier value (e.g., Q42 for Wikidata)

label

requiredstring

Display label for the entity

system

requiredstring

External identifier system

knownValues: wikidata | ror | orcid | isni | viaf | lcsh | fast | credit | spdx | fundref | mesh | aat | gnd | anzsrc | arxiv | doi | pmid | pmcid

type

requiredstring

const: "externalId"

uri

string · uri

Full URI for the external entity

#graphNodeLink

object

Link to a knowledge graph node (type or object, with optional subkind)

Properties

id

string

Node UUID identifier

kind

requiredstring

Node kind: 'type' for classifications, 'object' for instances

knownValues: type | object

label

requiredstring

Display label for the node

slug

string

Human-readable slug (e.g., 'computer-science')

subkind

string

Subkind slug (e.g., 'field', 'facet', 'institution', 'contribution-type')

subkindUri

string · at-uri

AT-URI of the subkind type node

type

requiredstring

const: "graphNode"

uri

requiredstring · at-uri

AT-URI of the graph node

#textPositionSelector

object

W3C TextPositionSelector for character-based targeting

Properties

boundingRect

ref

Bounding rectangle for visual positioning

Reference

#boundingRect

end

requiredinteger

End character offset

minimum: 0

pageNumber

requiredinteger

0-indexed page number in the document

minimum: 0

start

requiredinteger

Start character offset

minimum: 0

type

requiredstring

const: "TextPositionSelector"

#textQuoteSelector

object

W3C TextQuoteSelector for resilient text matching

Properties

exact

requiredstring

The exact text to match

prefix

string

Text immediately before the match

maxLength: 32

suffix

string

Text immediately after the match

maxLength: 32

type

requiredstring

const: "TextQuoteSelector"

#textSpanTarget

object

W3C Web Annotation target for text spans

Properties

refinedBy

ref

Optional position selector for precise targeting

Reference

#textPositionSelector

selector

requiredref

Primary selector for resilient text matching

Reference

#textQuoteSelector

source

requiredstring · at-uri

AT-URI of the source document

Similar lexicons

semantic match

Lexicons whose schemas describe something close to this one. Check them before publishing a new one that overlaps.

pub.chive.review.entityLink
record

Link from a text span in a preprint to a knowledge graph entity
pub.chive.annotation.listForEprint
query

List annotations for a specific eprint with optional filtering
pub.chive.annotation.comment
record

Inline annotation on a specific text span in an eprint