panache-cli 3.17.1__tar.gz → 3.17.2__tar.gz

{panache_cli-3.17.1 → panache_cli-3.17.2}/Cargo.lock

@@ -121,9 +121,9 @@ checksum = "f2032f911046de80f0a198e0901378627c33f59ea0ac00e363d481118bd70a53"
 
 [[package]]
 name = "badness-formatter"
-version = "0.10.2"
+version = "0.11.0"
 source = "registry+https://github.com/rust-lang/crates.io-index"
-checksum = "b174164ae9bb3abaa0115a64ecb11a54cdee5c93c9104c1cdf2c5da282039d76"
+checksum = "0165f729bcb3de3e5b19936829abb6e32204d5762ed93a2c131e65c3c9495810"
 dependencies = [
  "badness-parser",
  "rowan 0.17.0",
@@ -131,9 +131,9 @@ dependencies = [
 
 [[package]]
 name = "badness-parser"
-version = "0.11.1"
+version = "0.11.2"
 source = "registry+https://github.com/rust-lang/crates.io-index"
-checksum = "32b45795e07c88249e867c1f2dd84ca0d5d78062753fb5fa75c8eb1ece8e202b"
+checksum = "75b997df78399ddfa09f747bbe52f8e1c8afc374e3fc95540cd312632b939744"
 dependencies = [
  "phf 0.14.0",
  "phf_codegen",
@@ -294,9 +294,9 @@ dependencies = [
 
 [[package]]
 name = "clapdown"
-version = "0.2.0"
+version = "0.3.0"
 source = "registry+https://github.com/rust-lang/crates.io-index"
-checksum = "68bcefa13c36a119d957224c65214f792139033a34f8157297ac2a7fff5a343a"
+checksum = "d8f2a42d22b905f09c7e696e2f46a17e4aa956c8d8b8cd09806137fd99c8544c"
 dependencies = [
  "clap",
 ]
@@ -850,9 +850,9 @@ dependencies = [
 
 [[package]]
 name = "jsonschema"
-version = "0.59.0"
+version = "0.60.1"
 source = "registry+https://github.com/rust-lang/crates.io-index"
-checksum = "1b320ad34c177093d21622edc9215bb608294c2333ff296672c0c8265a5ee60c"
+checksum = "65de752665c4a06528af6759955eecf60ba73ae7442d35349963a09c8031cd71"
 dependencies = [
  "ahash",
  "bytecount",
@@ -878,23 +878,24 @@ dependencies = [
 
 [[package]]
 name = "jsonschema-regex"
-version = "0.59.0"
+version = "0.60.2"
 source = "registry+https://github.com/rust-lang/crates.io-index"
-checksum = "1472f7be79026f79e01a9b172263311e829d7c210d57b39cb57037abc0ce0500"
+checksum = "107aeb6ff14b8deb5610096a8ce5c554ec89806b521147eaeb3cae05b07edb7a"
 dependencies = [
  "regex-syntax",
 ]
 
 [[package]]
 name = "jsonschema-value"
-version = "0.59.0"
+version = "0.60.2"
 source = "registry+https://github.com/rust-lang/crates.io-index"
-checksum = "e5a7550a7a84787e715ead0b47e01fa8c6bb7c3413630f91a8f2094c06c2078a"
+checksum = "e281d6b177bb4834f2ffd6f92aa0443cffe29c996b251c8d94eb6f456186feba"
 dependencies = [
  "ahash",
  "bytecount",
  "fraction",
  "getrandom 0.3.4",
+ "memchr",
  "num-cmp",
  "num-traits",
  "serde_json",
@@ -1114,7 +1115,7 @@ checksum = "1a80800c0488c3a21695ea981a54918fbb37abf04f4d0720c453632255e2ff0e"
 
 [[package]]
 name = "panache"
-version = "3.17.1"
+version = "3.17.2"
 dependencies = [
  "annotate-snippets",
  "assert_cmd",
@@ -1159,7 +1160,7 @@ dependencies = [
 
 [[package]]
 name = "panache-formatter"
-version = "0.28.1"
+version = "0.28.2"
 dependencies = [
  "badness-formatter",
  "insta",
@@ -1179,7 +1180,7 @@ dependencies = [
 
 [[package]]
 name = "panache-parser"
-version = "0.34.1"
+version = "0.34.2"
 dependencies = [
  "badness-parser",
  "entities",
@@ -1461,9 +1462,9 @@ dependencies = [
 
 [[package]]
 name = "referencing"
-version = "0.59.0"
+version = "0.60.2"
 source = "registry+https://github.com/rust-lang/crates.io-index"
-checksum = "473f4dcca28ead7ee0f8e5b5d0bbae2549f4fc4c958fb20af328961b6c174be3"
+checksum = "f42818036d3b37cda6bd4c494543158a36e431cb717015ef7c93acc6ba214d3b"
 dependencies = [
  "ahash",
  "fluent-uri 0.4.1",

{panache_cli-3.17.1 → panache_cli-3.17.2}/Cargo.toml

@@ -9,7 +9,7 @@ authors = ["Johan Larsson <johan@jolars.co>"]
 
 [package]
 name = "panache"
-version = "3.17.1"
+version = "3.17.2"
 edition.workspace = true
 rust-version.workspace = true
 # `distill_quarto_schema` is a dev-only vendoring bin (src/bin/); keep bare
@@ -55,11 +55,11 @@ path = "src/main.rs"
 required-features = ["cli"]
 
 [dependencies]
-panache-formatter = { path = "crates/panache-formatter", version = "0.28.1", features = [
+panache-formatter = { path = "crates/panache-formatter", version = "0.28.2", features = [
     "serde",
     "schema",
 ] }
-panache-parser = { path = "crates/panache-parser", version = "0.34.1", features = [
+panache-parser = { path = "crates/panache-parser", version = "0.34.2", features = [
     "serde",
     "schema",
 ] }
@@ -95,7 +95,7 @@ similar-asserts = "2.0.0"
 insta = { version = "1.47.2", features = ["json"] }
 assert_cmd = "2.2.2"
 predicates = "3.1.4"
-jsonschema = { version = "0.59.0", default-features = false }
+jsonschema = { version = "0.60.1", default-features = false }
 
 [target.'cfg(not(target_arch = "wasm32"))'.dependencies]
 rayon = "1.10.0"
@@ -117,7 +117,7 @@ lsp = [
 clap = { version = "4.6.1", features = ["derive", "env"] }
 clap_complete = "4.6.0"
 clap_mangen = "0.3.0"
-clapdown = "0.2.0"
+clapdown = "0.3.0"
 flate2 = "1.1.9"
 
 [package.metadata.deb]

{panache_cli-3.17.1 → panache_cli-3.17.2}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: panache-cli
-Version: 3.17.1
+Version: 3.17.2
 Classifier: Development Status :: 5 - Production/Stable
 Classifier: Environment :: Console
 Classifier: Intended Audience :: Developers
@@ -37,6 +37,7 @@ Code](https://vsmarketplacebadges.dev/version-short/jolars.panache.svg?logo=vsix
 version](https://badge.fury.io/py/panache-cli.svg?icon=si%3Apython)](https://badge.fury.io/py/panache-cli)
 [![npm
 version](https://badge.fury.io/js/@panache-cli%2Fpanache.svg?icon=si%3Anpm)](https://badge.fury.io/js/@panache-cli%2Fpanache)
+[![DOI](https://img.shields.io/badge/DOI-10.5281%2Fzenodo.18608442-blue)](https://doi.org/10.5281/zenodo.18608442)
 
 Panache is a language server, formatter, and linter for Quarto and other
 Markdown flavors, built in Rust with a lossless CST parser and support for
@@ -337,3 +338,12 @@ documentation, well-structured code, and testing infrastructure provided by
 Pandoc. We also owe significant debt to the rust-analyzer project, on which
 Panache is heavily inspired.
 
+## Citation
+
+If you use Panache in your research, please cite the release you used. Select
+that release in the [Zenodo archive](https://doi.org/10.5281/zenodo.18608442)
+and export its citation. To cite Panache generally, use the concept DOI
+`10.5281/zenodo.18608442`.
+
+Machine-readable metadata is available in [CITATION.cff](CITATION.cff).
+

{panache_cli-3.17.1 → panache_cli-3.17.2}/README.md

@@ -11,6 +11,7 @@ Code](https://vsmarketplacebadges.dev/version-short/jolars.panache.svg?logo=vsix
 version](https://badge.fury.io/py/panache-cli.svg?icon=si%3Apython)](https://badge.fury.io/py/panache-cli)
 [![npm
 version](https://badge.fury.io/js/@panache-cli%2Fpanache.svg?icon=si%3Anpm)](https://badge.fury.io/js/@panache-cli%2Fpanache)
+[![DOI](https://img.shields.io/badge/DOI-10.5281%2Fzenodo.18608442-blue)](https://doi.org/10.5281/zenodo.18608442)
 
 Panache is a language server, formatter, and linter for Quarto and other
 Markdown flavors, built in Rust with a lossless CST parser and support for
@@ -310,3 +311,12 @@ The development of Panache has simplified considerably thanks to the extensive
 documentation, well-structured code, and testing infrastructure provided by
 Pandoc. We also owe significant debt to the rust-analyzer project, on which
 Panache is heavily inspired.
+
+## Citation
+
+If you use Panache in your research, please cite the release you used. Select
+that release in the [Zenodo archive](https://doi.org/10.5281/zenodo.18608442)
+and export its citation. To cite Panache generally, use the concept DOI
+`10.5281/zenodo.18608442`.
+
+Machine-readable metadata is available in [CITATION.cff](CITATION.cff).

{panache_cli-3.17.1 → panache_cli-3.17.2}/crates/panache-formatter/CHANGELOG.md

@@ -1,5 +1,11 @@
 # Changelog
 
+## [0.28.2](https://github.com/jolars/panache/compare/panache-formatter-v0.28.1...panache-formatter-v0.28.2) (2026-10-30)
+
+### Dependencies
+
+- updated crates/panache-parser to v0.34.2
+
 ## [0.28.1](https://github.com/jolars/panache/compare/panache-formatter-v0.28.0...panache-formatter-v0.28.1) (2026-10-26)
 
 ### Bug Fixes

{panache_cli-3.17.1 → panache_cli-3.17.2}/crates/panache-formatter/Cargo.toml

@@ -1,6 +1,6 @@
 [package]
 name = "panache-formatter"
-version = "0.28.1"
+version = "0.28.2"
 edition.workspace = true
 rust-version.workspace = true
 include = [
@@ -19,7 +19,7 @@ keywords = ["quarto", "pandoc", "markdown", "formatter"]
 categories = ["text-processing"]
 
 [dependencies]
-panache-parser = { path = "../panache-parser", version = "0.34.1" }
+panache-parser = { path = "../panache-parser", version = "0.34.2" }
 log = { version = "0.4.31", features = ["release_max_level_debug"] }
 rowan = "0.17.0"
 serde = { version = "1.0.228", features = ["derive"], optional = true }
@@ -32,7 +32,7 @@ serde = ["dep:serde", "panache-parser/serde"]
 schema = ["serde", "dep:schemars", "panache-parser/schema"]
 
 [dev-dependencies]
-badness-formatter = "=0.10.2"
+badness-formatter = "=0.11.0"
 serde_json = "1.0.150"
 insta = { version = "1.47.2", features = ["json"] }
 # TEMPORARY: cross-validation oracle only (tests/yaml_cross_validation.rs).

{panache_cli-3.17.1 → panache_cli-3.17.2}/crates/panache-parser/CHANGELOG.md

@@ -1,5 +1,12 @@
 # Changelog
 
+## [0.34.2](https://github.com/jolars/panache/compare/panache-parser-v0.34.1...panache-parser-v0.34.2) (2026-10-30)
+
+### Bug Fixes
+
+- **lint:** validate custom cross-reference targets ([`f4f3a1d`](https://github.com/jolars/panache/commit/f4f3a1db60ec5ee2d537c72c60668426d696ecd9)), closes [#591](https://github.com/jolars/panache/issues/591)
+- **parser:** capture narrative citation suffixes ([`3b50e47`](https://github.com/jolars/panache/commit/3b50e47a2ccbae75974ab1926a24825b4c4f1c18)), fixes [#590](https://github.com/jolars/panache/issues/590)
+
 ## [0.34.1](https://github.com/jolars/panache/compare/panache-parser-v0.34.0...panache-parser-v0.34.1) (2026-10-26)
 
 ### Bug Fixes

{panache_cli-3.17.1 → panache_cli-3.17.2}/crates/panache-parser/Cargo.toml

@@ -1,6 +1,6 @@
 [package]
 name = "panache-parser"
-version = "0.34.1"
+version = "0.34.2"
 edition.workspace = true
 rust-version.workspace = true
 readme = "README.md"
@@ -44,6 +44,6 @@ serde = { version = "1.0.228", features = ["derive"] }
 serde_json = "1.0.150"
 
 [dev-dependencies]
-badness-parser = "=0.11.1"
+badness-parser = "=0.11.2"
 insta = "1.47.2"
 toml = "1.1.2"

{panache_cli-3.17.1 → panache_cli-3.17.2}/crates/panache-parser/src/pandoc_ast.rs

@@ -3542,9 +3542,6 @@ fn inlines_from(parent: &SyntaxNode) -> Vec<Inline> {
             NodeOrToken::Node(n) if n.kind() == SyntaxKind::LATEX_COMMAND => {
                 emit_latex_command_with_absorb(&n, &mut iter, &mut out);
             }
-            NodeOrToken::Node(n) if n.kind() == SyntaxKind::CITATION => {
-                emit_citation_with_absorb(&n, &mut iter, &mut out);
-            }
             NodeOrToken::Node(n) => push_inline_node(&n, &mut out),
         }
     }
@@ -3554,62 +3551,6 @@ fn inlines_from(parent: &SyntaxNode) -> Vec<Inline> {
     out
 }
 
-/// Pandoc absorbs `@key [locator]` into a single AuthorInText `Cite` with
-/// the bracketed text becoming the citation's suffix. The parser emits two
-/// separate nodes: `CITATION` (bare `@key`, no surrounding brackets) and an
-/// adjacent `LINK` whose bracketed text has no destination. When the
-/// CITATION is bare and we can verify both the next siblings (a single
-/// `TEXT` whitespace token followed by a `LINK` node lacking
-/// `LINK_DEST_START`), consume both and absorb the link's text as suffix.
-fn emit_citation_with_absorb<I>(
-    node: &SyntaxNode,
-    iter: &mut std::iter::Peekable<I>,
-    out: &mut Vec<Inline>,
-) where
-    I: Iterator<Item = rowan::SyntaxElement<crate::syntax::PanacheLanguage>>,
-{
-    let bracketed = node
-        .children_with_tokens()
-        .filter_map(|el| el.into_token())
-        .any(|t| t.kind() == SyntaxKind::LINK_START);
-    if bracketed {
-        render_citation_inline(node, out, None);
-        return;
-    }
-    let next_sibling_pair = node.next_sibling_or_token().and_then(|el1| {
-        let t = el1.as_token().cloned()?;
-        if t.kind() != SyntaxKind::TEXT || !t.text().starts_with(' ') {
-            return None;
-        }
-        let space_text = t.text().to_string();
-        let link_el = t.next_sibling_or_token()?;
-        let link = link_el.as_node().cloned()?;
-        if link.kind() != SyntaxKind::LINK && link.kind() != SyntaxKind::UNRESOLVED_REFERENCE {
-            return None;
-        }
-        let has_dest = link
-            .children_with_tokens()
-            .filter_map(|el| el.into_token())
-            .any(|tok| tok.kind() == SyntaxKind::LINK_DEST_START);
-        if has_dest {
-            return None;
-        }
-        let link_text = link
-            .children()
-            .find(|c| c.kind() == SyntaxKind::LINK_TEXT)
-            .map(|tt| tt.text().to_string())
-            .unwrap_or_default();
-        Some((space_text, link_text))
-    });
-    if let Some((_space_text, locator_text)) = next_sibling_pair {
-        iter.next();
-        iter.next();
-        render_citation_inline(node, out, Some(&locator_text));
-    } else {
-        render_citation_inline(node, out, None);
-    }
-}
-
 /// Pandoc's tex inline reader absorbs trailing horizontal whitespace into the
 /// raw command when (and only when) the command is `\letters` with no brace
 /// arguments — `\foo bar` becomes `RawInline tex "\\foo "` + `Str "bar"`,
@@ -3656,7 +3597,7 @@ fn push_inline_node(node: &SyntaxNode, out: &mut Vec<Inline>) {
     match node.kind() {
         SyntaxKind::LINK => render_link_inline(node, out),
         SyntaxKind::IMAGE_LINK => render_image_inline(node, out),
-        SyntaxKind::CITATION => render_citation_inline(node, out, None),
+        SyntaxKind::CITATION => render_citation_inline(node, out),
         SyntaxKind::UNRESOLVED_REFERENCE => render_unresolved_reference_inline(node, out),
         _ => out.push(inline_from_node(node)),
     }
@@ -3755,14 +3696,9 @@ fn render_unresolved_reference_inline(node: &SyntaxNode, out: &mut Vec<Inline>)
 /// `Str "N"` (just the digits — surrounding parens come from adjacent
 /// source bytes which our coalesce pass merges back in). Otherwise we
 /// project the CITATION node as a proper `Cite [Citation, ...] [Inline,
-/// ...]` per pandoc's citation reader. `extra_suffix_text` carries an
-/// absorbed `[locator]` (pandoc absorbs `@key [locator]` into the Cite as
-/// the citation's suffix); the literal text reflects the absorbed bytes.
-fn render_citation_inline(
-    node: &SyntaxNode,
-    out: &mut Vec<Inline>,
-    extra_suffix_text: Option<&str>,
-) {
+/// ...]` per pandoc's citation reader, including any narrative suffix
+/// captured in the citation node.
+fn render_citation_inline(node: &SyntaxNode, out: &mut Vec<Inline>) {
     let first_key = node
         .children_with_tokens()
         .filter_map(|el| el.into_token())
@@ -3784,13 +3720,15 @@ fn render_citation_inline(
     let mut builders: Vec<CitationBuilder> = Vec::new();
     let mut current: Option<CitationBuilder> = None;
     let mut pending_prefix = String::new();
+    let mut in_brackets = bracketed;
     for el in node.children_with_tokens() {
         let token = match el {
             NodeOrToken::Token(t) => t,
             _ => continue,
         };
         match token.kind() {
-            SyntaxKind::LINK_START | SyntaxKind::LINK_DEST => {}
+            SyntaxKind::LINK_START | SyntaxKind::LINK_DEST | SyntaxKind::CITATION_SUFFIX_END => {}
+            SyntaxKind::CITATION_SUFFIX_START => in_brackets = true,
             SyntaxKind::CITATION_BRACE_OPEN | SyntaxKind::CITATION_BRACE_CLOSE => {}
             SyntaxKind::CITATION_MARKER => {
                 if let Some(c) = current.take() {
@@ -3798,7 +3736,7 @@ fn render_citation_inline(
                 }
                 let mode = if token.text() == "-@" {
                     CitationMode::SuppressAuthor
-                } else if bracketed {
+                } else if in_brackets {
                     CitationMode::NormalCitation
                 } else {
                     CitationMode::AuthorInText
@@ -3832,15 +3770,6 @@ fn render_citation_inline(
         builders.push(c);
     }
 
-    if let Some(extra) = extra_suffix_text
-        && let Some(last) = builders.last_mut()
-    {
-        if !last.suffix_raw.is_empty() && !extra.starts_with(' ') {
-            last.suffix_raw.push(' ');
-        }
-        last.suffix_raw.push_str(extra);
-    }
-
     let note_offset: u32 = node.text_range().start().into();
     let note_num = REFS_CTX
         .with(|c| {
@@ -3856,12 +3785,19 @@ fn render_citation_inline(
         .map(|b| b.into_citation(note_num))
         .collect();
 
-    let mut literal = node.text().to_string();
-    if let Some(extra) = extra_suffix_text {
-        literal.push(' ');
-        literal.push('[');
-        literal.push_str(extra);
-        literal.push(']');
+    let mut literal = String::new();
+    for token in node.children_with_tokens().filter_map(|el| el.into_token()) {
+        match token.kind() {
+            SyntaxKind::LINE_PREFIX => {}
+            SyntaxKind::CITATION_SUFFIX_START => {
+                if !literal.ends_with(char::is_whitespace) {
+                    literal.push(' ');
+                }
+                literal.push('[');
+            }
+            SyntaxKind::CITATION_MARKER if !bracketed && literal.is_empty() => literal.push('@'),
+            _ => literal.push_str(token.text()),
+        }
     }
     let text_inlines = literal_inlines(&literal);
 
@@ -5492,6 +5428,23 @@ mod tests {
         serde_json::from_str(&s).expect("to_pandoc_json must emit valid JSON")
     }
 
+    #[test]
+    fn narrative_citation_projects_suffix_and_preserves_the_following_reference() {
+        let output = parse_to_json("@a\n[p. 4; @b] and [missing]");
+        let inlines = &output["blocks"][0]["c"];
+        let citations = &inlines[0]["c"][0];
+        assert_eq!(citations[0]["citationId"], "a");
+        assert_eq!(citations[0]["citationMode"]["t"], "AuthorInText");
+        assert_eq!(
+            citations[0]["citationSuffix"],
+            json!([{"t": "Str", "c": "p.\u{a0}4"}])
+        );
+        assert_eq!(citations[1]["citationId"], "b");
+        assert_eq!(citations[1]["citationMode"]["t"], "NormalCitation");
+        assert_eq!(inlines[0]["c"][1][1]["t"], "SoftBreak");
+        assert_eq!(inlines[4], json!({"t": "Str", "c": "[missing]"}));
+    }
+
     fn pandoc_options() -> crate::options::ParserOptions {
         flavor_options(crate::options::Flavor::Pandoc)
     }

{panache_cli-3.17.1 → panache_cli-3.17.2}/crates/panache-parser/src/parser/inlines/citations.rs

@@ -7,7 +7,52 @@
 //! - Author-in-text: `@doe99` (bare, without brackets)
 
 use super::sink::InlineSink;
-use crate::syntax::SyntaxKind;
+use crate::{options::ParserOptions, syntax::SyntaxKind};
+
+/// Narrative suffixes yield to links, reference shapes, and bracketed spans.
+/// Their closing bracket must be found by parsing inlines, since emphasis and
+/// raw TeX can contain otherwise unmatched closing brackets.
+pub(super) fn narrative_suffix_end(
+    text: &str,
+    key_end: usize,
+    end: usize,
+    config: &ParserOptions,
+) -> Option<usize> {
+    let tail = &text[key_end..end];
+    let rest = tail.trim_start_matches([' ', '\t', '\r', '\n']);
+    if !rest.starts_with('[') {
+        return None;
+    }
+    let open = end - rest.len();
+    let ctx = super::links::LinkScanContext::from_options(config);
+    if config.extensions.inline_links
+        && super::links::try_parse_inline_link_parts(rest, false, ctx).is_some()
+    {
+        return None;
+    }
+    if config.extensions.bracketed_spans
+        && super::bracketed_spans::try_parse_bracketed_span(rest).is_some()
+    {
+        return None;
+    }
+    if config.extensions.reference_links
+        && let Some((_, _, label, _, shortcut)) = super::links::try_parse_reference_link(
+            rest,
+            config.extensions.shortcut_reference_links,
+            config.extensions.inline_links,
+            config.extensions.spaced_reference_links,
+            ctx,
+        )
+        && (!shortcut
+            || config
+                .refdef_labels
+                .as_ref()
+                .is_some_and(|labels| labels.contains(&super::refdef_map::normalize_label(&label))))
+    {
+        return None;
+    }
+    super::core::inline_bracket_end(text, open + 1, end, config).map(|close| close + 1)
+}
 
 /// Try to parse a bracketed citation starting at the current position.
 /// Returns Some((length, content)) if successful, None otherwise.
@@ -253,9 +298,7 @@ pub fn is_crossref_key(key: &str, custom_prefixes: &[String]) -> bool {
 
 /// Whether `key`'s prefix (the segment before the first `-`) appears in
 /// `custom_prefixes`. Unlike [`is_quarto_crossref_key`], this matches *only*
-/// the configured extension prefixes, so callers can tell an extension-injected
-/// cross-reference (whose target panache can't resolve) apart from a built-in
-/// one (whose target it can and should validate).
+/// the configured prefixes. Matching is case-insensitive.
 pub fn has_custom_crossref_prefix(key: &str, custom_prefixes: &[String]) -> bool {
     if custom_prefixes.is_empty() {
         return false;
@@ -584,6 +627,15 @@ fn emit_bracketed_citation_content(builder: &mut impl InlineSink, content: &str)
 
 /// Emit a bare citation node to the builder.
 pub(crate) fn emit_bare_citation(builder: &mut impl InlineSink, key: &str, has_suppress: bool) {
+    emit_narrative_citation(builder, key, has_suppress, "");
+}
+
+pub(super) fn emit_narrative_citation(
+    builder: &mut impl InlineSink,
+    key: &str,
+    has_suppress: bool,
+    suffix: &str,
+) {
     builder.start_node(SyntaxKind::CITATION.into());
 
     if has_suppress {
@@ -600,6 +652,23 @@ pub(crate) fn emit_bare_citation(builder: &mut impl InlineSink, key: &str, has_s
         builder.token(SyntaxKind::CITATION_KEY.into(), key);
     }
 
+    if !suffix.is_empty() {
+        let content = suffix.trim_start_matches([' ', '\t', '\r', '\n']);
+        let gap = &suffix[..suffix.len() - content.len()];
+        for part in gap.split_inclusive('\n') {
+            let horizontal = part.trim_end_matches(['\r', '\n']);
+            if !horizontal.is_empty() {
+                builder.token(SyntaxKind::WHITESPACE.into(), horizontal);
+            }
+            if horizontal.len() < part.len() {
+                builder.token(SyntaxKind::NEWLINE.into(), &part[horizontal.len()..]);
+            }
+        }
+        builder.token(SyntaxKind::CITATION_SUFFIX_START.into(), "[");
+        emit_bracketed_citation_content(builder, &content[1..content.len() - 1]);
+        builder.token(SyntaxKind::CITATION_SUFFIX_END.into(), "]");
+    }
+
     builder.finish_node();
 }