@stesura/references

Per note kind: mints missing refs, lists the notes in anchor order (the anchors’ numbers are noteAnchorStore’s) and keeps the bodies in the doc-level container matched to them, creating missing bodies and deleting orphans and duplicates. One doc walk and one appended transaction for all kinds.

Footnotes in anchor (= numbering) order, from the merged notes plugin state.

Endnotes in anchor (= numbering) order, from the merged notes plugin state.

Replaces the selection with a cross-reference (or inserts it at the caret) and node-selects it. The references store derives its label from the target (docs/partially-executed/derived-state-stores-plan.md, DS-9), except where it is stored: a text reference’s bookmark text and a page reference’s page.

Returns false if targetId or refTo is empty, if a text or page reference has no text (an empty label renders as an invisible node), or if canInsertCrossReference fails.

Whether a cross-reference could replace the current selection: the positional half of insertCrossReference’s guard, usable before a target is picked. The toolbar probes it.

Selects the node a cross-reference points at and scrolls it into view.

Returns false for a missing, unresolvable or missingReference-flagged target, so the caller’s default handling still runs (REF-44).

Inserts a footnote anchor at the end of the selection. The notes plugin numbers it and creates its body. See createInsertNoteAnchor.

Inserts an endnote anchor at the end of the selection. The notes plugin numbers it and creates its body (and the endnotes container if missing). See createInsertNoteAnchor.

Deletes a footnote: its body and every anchor referencing it, as one undoable step. Backs the note panel banner’s “Delete footnote”.

Deletes an endnote: its body and every anchor referencing it, as one undoable step. Backs the note panel banner’s “Delete endnote”.

Selects the footnote anchor before (-1) or after (1) footnoteRef in numbering order, then calls onNavigate with its ref. Doesn’t wrap: false at either end and for an unknown ref.

Selects the endnote anchor before (-1) or after (1) endnoteRef in numbering order, then calls onNavigate with its ref. Doesn’t wrap: false at either end and for an unknown ref.

Selects the next footnote anchor after the selection, wrapping around. The probe is true whenever the doc has a navigable footnote anchor.

Selects the footnote anchor before the selection, wrapping around. The probe is true whenever the doc has a navigable footnote anchor.

Selects the next endnote anchor after the selection, wrapping around. The probe is true whenever the doc has a navigable endnote anchor.

Selects the endnote anchor before the selection, wrapping around. The probe is true whenever the doc has a navigable endnote anchor.

Whether the selection covers exactly one cross_reference.

The cross_reference node the selection covers exactly, or null. “Edit” replaces from..to, so a selection running past the node would lose that text (A1).

The node a cross-reference points at, with its position, or undefined.

Mirrors crossReferencesPlugin’s target map so the label, the preview and the jump agree: numbered types only, header/footer regions and hidden content skipped (REF-44), last match wins on a duplicate id.

The fullContext label of a numbered target: each level of its counter path rendered with the level’s own segment of the list’s level text (see ownSegment), joined with separator. Owning segments is what keeps "%1.%2."-style level texts from repeating the parent chain.

Bullet levels, levels without a config and level texts that don’t name their own placeholder contribute nothing. The path stops at the first non-numeric segment (0 is valid).

The localized “above”/“below” label of an aboveBelow cross-reference.

Returns the node and position of the doc-level footnotes container.

Returns the node and position of the doc-level endnotes container, if it exists (it is created lazily by the notes plugin when the first endnote is inserted).

Cross-references whose target is gone (Word’s “Error! Reference source not found.”), for createIssueTools. No automatic fix: the agent or the user points them at a new target.