panache-cli 3.9.0__tar.gz → 3.10.0__tar.gz

{panache_cli-3.9.0 → panache_cli-3.10.0}/Cargo.lock

@@ -166,9 +166,9 @@ checksum = "bef38d45163c2f1dde094a7dfd33ccf595c92905c8f8f4fdc18d06fb1037718a"
 
 [[package]]
 name = "bitflags"
-version = "2.13.1"
+version = "2.13.2"
 source = "registry+https://github.com/rust-lang/crates.io-index"
-checksum = "b588b76d00fde79687d7646a9b5bdf3cc0f655e0bbd080335a95d7e96f3587da"
+checksum = "3ded4057c258ba199e2d26386d3af3780957ecaee6c4ef4041c6b4b8b97c0b06"
 
 [[package]]
 name = "borrow-or-share"
@@ -309,9 +309,9 @@ checksum = "1d07550c9036bf2ae0c684c4297d503f838287c83c53686d05370d0e139ae570"
 
 [[package]]
 name = "console"
-version = "0.16.4"
+version = "0.16.6"
 source = "registry+https://github.com/rust-lang/crates.io-index"
-checksum = "4fe5f465a4f6fee88fad41b85d990f84c835335e85b5d9e6e63e0d06d28cba7c"
+checksum = "e96a4956774c13c126a8b5af4daa79384f4d826534c95a02d76afb39e2ab64e3"
 dependencies = [
  "encode_unicode",
  "libc",
@@ -568,9 +568,9 @@ dependencies = [
 
 [[package]]
 name = "fancy-regex"
-version = "0.19.0"
+version = "0.19.1"
 source = "registry+https://github.com/rust-lang/crates.io-index"
-checksum = "476de73bddf2ef8490aa4ee8f1cf40b430bf1d56c48c22080e5186952cd580e6"
+checksum = "52e0387578e845beb7a1acff126228499f26cb18edf12919cc513bb863266464"
 dependencies = [
  "bit-set",
  "regex-automata",
@@ -731,9 +731,9 @@ dependencies = [
 
 [[package]]
 name = "hashlink"
-version = "0.12.1"
+version = "0.12.2"
 source = "registry+https://github.com/rust-lang/crates.io-index"
-checksum = "32069d97bb81e38fa67eab65e3393bf804bb85969f2bc06bf13f64aef5aba248"
+checksum = "a596f1b20ed2cc5ecac41a164aaebc7258057060f06c0cf7a2ba3991ee7990fb"
 dependencies = [
  "hashbrown 0.17.1",
 ]
@@ -1250,7 +1250,7 @@ checksum = "1a80800c0488c3a21695ea981a54918fbb37abf04f4d0720c453632255e2ff0e"
 
 [[package]]
 name = "panache"
-version = "3.9.0"
+version = "3.10.0"
 dependencies = [
  "annotate-snippets",
  "assert_cmd",
@@ -1295,7 +1295,7 @@ dependencies = [
 
 [[package]]
 name = "panache-formatter"
-version = "0.24.0"
+version = "0.24.1"
 dependencies = [
  "badness-formatter",
  "insta",
@@ -1315,7 +1315,7 @@ dependencies = [
 
 [[package]]
 name = "panache-parser"
-version = "0.29.0"
+version = "0.29.1"
 dependencies = [
  "badness-parser",
  "entities",
@@ -1570,7 +1570,7 @@ version = "0.5.18"
 source = "registry+https://github.com/rust-lang/crates.io-index"
 checksum = "ed2bf2547551a7053d6fdfafda3f938979645c44812fbfcda098faae3f1a362d"
 dependencies = [
- "bitflags 2.13.1",
+ "bitflags 2.13.2",
 ]
 
 [[package]]
@@ -1699,7 +1699,7 @@ version = "1.1.4"
 source = "registry+https://github.com/rust-lang/crates.io-index"
 checksum = "b6fe4565b9518b83ef4f91bb47ce29620ca828bd32cb7e408f0062e9930ba190"
 dependencies = [
- "bitflags 2.13.1",
+ "bitflags 2.13.2",
  "errno",
  "libc",
  "linux-raw-sys",
@@ -2064,9 +2064,9 @@ dependencies = [
 
 [[package]]
 name = "toml"
-version = "1.1.5+spec-1.1.0"
+version = "1.1.6+spec-1.1.0"
 source = "registry+https://github.com/rust-lang/crates.io-index"
-checksum = "12c0ba9680044b4ce98d391a62094047eada0d64860b80166c39f4a6b5640785"
+checksum = "920602543f0911ab71da12c50d59701da54c196d1a2bf5cb4b75667f137a406a"
 dependencies = [
  "indexmap",
  "serde_core",
@@ -2164,9 +2164,9 @@ checksum = "06abde3611657adf66d383f00b093d7faecc7fa57071cce2578660c9f1010821"
 
 [[package]]
 name = "uuid"
-version = "1.26.0"
+version = "1.26.1"
 source = "registry+https://github.com/rust-lang/crates.io-index"
-checksum = "b5772d71c9be8a8a6ac2117d949c5b224c1b72241bb611d9a3012edcf8af7812"
+checksum = "2ef6dac1e96601b4fb3acccccff2139741fcb757cb9a36089bf5be91cfb285ce"
 dependencies = [
  "getrandom 0.4.3",
  "js-sys",
@@ -2394,18 +2394,18 @@ dependencies = [
 
 [[package]]
 name = "zerocopy"
-version = "0.8.56"
+version = "0.8.57"
 source = "registry+https://github.com/rust-lang/crates.io-index"
-checksum = "556764e583adb45a9f8d413c2a147fa7e8d821e48e12b14fd560b607998b75eb"
+checksum = "d35102a9f36d089ccae9e4c6802bc118be4487b80aaffc0ab4e0cf5ce92d2873"
 dependencies = [
  "zerocopy-derive",
 ]
 
 [[package]]
 name = "zerocopy-derive"
-version = "0.8.56"
+version = "0.8.57"
 source = "registry+https://github.com/rust-lang/crates.io-index"
-checksum = "f2ab42fc20575779bd240faa45f94a74256f755c0fa9e89f0ede20d91d0cdfc1"
+checksum = "146c01f5ab44258da43cf276c74a2763db2ff3969c9c652c3f2de07041d0b2bc"
 dependencies = [
  "proc-macro2",
  "quote",

{panache_cli-3.9.0 → panache_cli-3.10.0}/Cargo.toml

@@ -9,7 +9,7 @@ authors = ["Johan Larsson <johan@jolars.co>"]
 
 [package]
 name = "panache"
-version = "3.9.0"
+version = "3.10.0"
 edition.workspace = true
 rust-version.workspace = true
 # `distill_quarto_schema` is a dev-only vendoring bin (src/bin/); keep bare
@@ -51,11 +51,11 @@ path = "src/main.rs"
 required-features = ["cli"]
 
 [dependencies]
-panache-formatter = { path = "crates/panache-formatter", version = "0.24.0", features = [
+panache-formatter = { path = "crates/panache-formatter", version = "0.24.1", features = [
     "serde",
     "schema",
 ] }
-panache-parser = { path = "crates/panache-parser", version = "0.29.0", features = [
+panache-parser = { path = "crates/panache-parser", version = "0.29.1", features = [
     "serde",
     "schema",
 ] }

{panache_cli-3.9.0 → panache_cli-3.10.0}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: panache-cli
-Version: 3.9.0
+Version: 3.10.0
 Classifier: Development Status :: 5 - Production/Stable
 Classifier: Environment :: Console
 Classifier: Intended Audience :: Developers

{panache_cli-3.9.0 → panache_cli-3.10.0}/crates/panache-formatter/CHANGELOG.md

@@ -1,5 +1,18 @@
 # Changelog
 
+## [0.24.1](https://github.com/jolars/panache/compare/panache-formatter-v0.24.0...panache-formatter-v0.24.1) (2026-09-11)
+
+### Bug Fixes
+- **formatter:** avoid duplicate quote prefixes ([`59fe1ce`](https://github.com/jolars/panache/commit/59fe1ce681cf657493b670473d05ba1638603aac))
+- **formatter:** stabilize semantic list wrapping ([`1346dfa`](https://github.com/jolars/panache/commit/1346dfaa31ca3915f61de2b3e7fa0e58d44a9953))
+- **formatter:** wrap separate math expressions ([`d7685b7`](https://github.com/jolars/panache/commit/d7685b7ee0d18c554814c95462c689d7c793f53a))
+
+### Performance Improvements
+- **formatter:** cache document sentence profiles ([`c7df8a3`](https://github.com/jolars/panache/commit/c7df8a367d2e38185075e9b06023733c82ff9de4))
+
+### Dependencies
+- updated crates/panache-parser to v0.29.1
+
 ## [0.24.0](https://github.com/jolars/panache/compare/panache-formatter-v0.23.0...panache-formatter-v0.24.0) (2026-09-06)
 
 ### Features

{panache_cli-3.9.0 → panache_cli-3.10.0}/crates/panache-formatter/Cargo.toml

@@ -1,6 +1,6 @@
 [package]
 name = "panache-formatter"
-version = "0.24.0"
+version = "0.24.1"
 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.29.0" }
+panache-parser = { path = "../panache-parser", version = "0.29.1" }
 log = { version = "0.4.31", features = ["release_max_level_debug"] }
 rowan = "0.17.0"
 serde = { version = "1.0.228", features = ["derive"], optional = true }

{panache_cli-3.9.0 → panache_cli-3.10.0}/crates/panache-formatter/src/formatter/core.rs

@@ -13,12 +13,14 @@ use super::headings;
 use super::inline;
 use super::inline_layout;
 use super::paragraphs;
+use super::sentence_wrap::SentenceProfileCache;
 use super::tables;
 use super::utils::is_structural_block;
 
 pub struct Formatter {
     pub(super) output: String,
     pub(super) config: Config,
+    pub(super) sentence_profile: SentenceProfileCache,
     pub(super) consecutive_blank_lines: usize,
     pub(super) fenced_div_depth: usize,
     pub(super) formatted_code: FormattedCodeMap,
@@ -48,6 +50,7 @@ impl Formatter {
         Self {
             output: String::with_capacity(8192),
             config,
+            sentence_profile: SentenceProfileCache::default(),
             consecutive_blank_lines: 0,
             fenced_div_depth: 0,
             formatted_code,
@@ -99,9 +102,13 @@ impl Formatter {
         node: &SyntaxNode,
         width: usize,
     ) -> Vec<String> {
-        inline_layout::wrapped_lines_for_paragraph(&self.config, node, width, &|n| {
-            self.format_inline_node(n)
-        })
+        inline_layout::wrapped_lines_for_paragraph(
+            &self.config,
+            &self.sentence_profile,
+            node,
+            width,
+            &|n| self.format_inline_node(n),
+        )
     }
 
     pub(super) fn wrapped_lines_for_paragraph_with_widths(
@@ -109,21 +116,31 @@ impl Formatter {
         node: &SyntaxNode,
         widths: &[usize],
     ) -> Vec<String> {
-        inline_layout::wrapped_lines_for_paragraph_with_widths(&self.config, node, widths, &|n| {
-            self.format_inline_node(n)
-        })
+        inline_layout::wrapped_lines_for_paragraph_with_widths(
+            &self.config,
+            &self.sentence_profile,
+            node,
+            widths,
+            &|n| self.format_inline_node(n),
+        )
     }
 
     pub(super) fn sentence_lines_for_paragraph(&self, node: &SyntaxNode) -> Vec<String> {
-        inline_layout::sentence_lines_for_paragraph(&self.config, node, &|n| {
-            self.format_inline_node(n)
-        })
+        inline_layout::sentence_lines_for_paragraph(
+            &self.config,
+            &self.sentence_profile,
+            node,
+            &|n| self.format_inline_node(n),
+        )
     }
 
     pub(super) fn semantic_lines_for_paragraph(&self, node: &SyntaxNode) -> Vec<String> {
-        inline_layout::semantic_lines_for_paragraph(&self.config, node, &|n| {
-            self.format_inline_node(n)
-        })
+        inline_layout::semantic_lines_for_paragraph(
+            &self.config,
+            &self.sentence_profile,
+            node,
+            &|n| self.format_inline_node(n),
+        )
     }
 
     pub(super) fn format_heading(&self, node: &SyntaxNode) -> String {

{panache_cli-3.9.0 → panache_cli-3.10.0}/crates/panache-formatter/src/formatter/inline_layout.rs

@@ -1,10 +1,10 @@
 use crate::config::{Config, Dialect};
 use crate::formatter::sentence_wrap::{
-    ResolvedProfile, SentenceBoundaryClass, SentenceLanguage, SentenceSegment,
-    is_sentence_boundary_segment, resolve_profile,
+    ResolvedProfile, SentenceBoundaryClass, SentenceLanguage, SentenceProfileCache,
+    SentenceSegment, is_sentence_boundary_segment,
 };
 use crate::formatter::smart::normalize_smart_punctuation;
-use crate::syntax::{LatexCommand, SyntaxKind, SyntaxNode};
+use crate::syntax::{LatexCommand, ListItem, SyntaxKind, SyntaxNode};
 use panache_parser::parser::inlines::subscript::try_parse_subscript;
 use rowan::NodeOrToken;
 use rowan::ast::AstNode;
@@ -435,6 +435,26 @@ fn is_unsafe_list_line_start_piece(piece: &str) -> bool {
         || is_bullet_list_marker_piece(piece)
 }
 
+fn escape_fancy_list_marker(piece: &str) -> Option<String> {
+    let unescaped = match piece.rsplit_once('\\') {
+        Some((head, punctuation @ ("." | ")"))) => Cow::Owned(format!("{head}{punctuation}")),
+        _ => Cow::Borrowed(piece),
+    };
+    if !is_fancy_alpha_marker_piece(&unescaped)
+        && !is_fancy_roman_marker_piece(&unescaped)
+        && !is_fancy_paren_decimal_marker_piece(&unescaped)
+        && !is_fancy_paren_alpha_or_roman_marker_piece(&unescaped)
+    {
+        return None;
+    }
+    if matches!(unescaped, Cow::Owned(_)) {
+        return Some(piece.to_string());
+    }
+    let mut escaped = piece.to_string();
+    escaped.insert(piece.len() - 1, '\\');
+    Some(escaped)
+}
+
 fn is_atx_heading_marker_piece(piece: &str) -> bool {
     !piece.is_empty() && piece.len() <= 6 && piece.bytes().all(|b| b == b'#')
 }
@@ -460,6 +480,7 @@ struct StreamingCoreSink<'a> {
     avoid_definition_marker_line_start: bool,
     avoid_heading_line_start: bool,
     avoid_tilde_fence_line_start: bool,
+    escape_fancy_list_line_start: bool,
 }
 
 impl<'a> StreamingCoreSink<'a> {
@@ -492,6 +513,7 @@ impl<'a> StreamingCoreSink<'a> {
             avoid_definition_marker_line_start,
             avoid_heading_line_start,
             avoid_tilde_fence_line_start,
+            escape_fancy_list_line_start: false,
         }
     }
 
@@ -534,12 +556,24 @@ impl<'a> StreamingCoreSink<'a> {
             self.line.push(' ');
             self.line_width += 1;
         }
-        self.line.push_str(&segment.text);
-        self.line_width += piece_width;
+        // Reindenting lazy list-item text can turn a preserved line's literal
+        // marker into a sublist. Keep it literal and attached to its text on
+        // subsequent passes, when its punctuation is already escaped.
+        let escaped_marker = (self.escape_fancy_list_line_start && !self.line_has_piece)
+            .then(|| escape_fancy_list_marker(&segment.text))
+            .flatten();
+        if let Some(escaped) = &escaped_marker {
+            self.line.push_str(escaped);
+            self.line_width += UnicodeWidthStr::width(escaped.as_str());
+        } else {
+            self.line.push_str(&segment.text);
+            self.line_width += piece_width;
+        }
         self.line_has_piece = true;
         self.prev_ws_after = segment.has_whitespace_after;
 
         if self.sentence_mode
+            && escaped_marker.is_none()
             && is_sentence_boundary_segment(&segment, next_segment, is_last, self.profile)
             && !next_segment.is_some_and(|next| self.piece_would_start_unsafe_line(&next.text))
         {
@@ -1362,6 +1396,7 @@ fn process_node_recursive(
 
 pub(super) fn wrapped_lines_for_paragraph(
     config: &Config,
+    sentence_profile: &SentenceProfileCache,
     node: &SyntaxNode,
     width: usize,
     format_inline_fn: &dyn Fn(&SyntaxNode) -> String,
@@ -1372,6 +1407,7 @@ pub(super) fn wrapped_lines_for_paragraph(
     log::trace!("wrapped_lines_for_paragraph called with width={}", width);
     let out_lines = wrapped_lines_for_node(
         config,
+        sentence_profile,
         node,
         &[width],
         format_inline_fn,
@@ -1383,6 +1419,7 @@ pub(super) fn wrapped_lines_for_paragraph(
 
 pub(super) fn wrapped_lines_for_paragraph_with_widths(
     config: &Config,
+    sentence_profile: &SentenceProfileCache,
     node: &SyntaxNode,
     widths: &[usize],
     format_inline_fn: &dyn Fn(&SyntaxNode) -> String,
@@ -1393,6 +1430,7 @@ pub(super) fn wrapped_lines_for_paragraph_with_widths(
     log::trace!("wrapped_lines_for_paragraph_with_widths called");
     let out_lines = wrapped_lines_for_node(
         config,
+        sentence_profile,
         node,
         widths,
         format_inline_fn,
@@ -1404,6 +1442,7 @@ pub(super) fn wrapped_lines_for_paragraph_with_widths(
 
 pub(super) fn sentence_lines_for_paragraph(
     config: &Config,
+    sentence_profile: &SentenceProfileCache,
     node: &SyntaxNode,
     format_inline_fn: &dyn Fn(&SyntaxNode) -> String,
 ) -> Vec<String> {
@@ -1413,6 +1452,7 @@ pub(super) fn sentence_lines_for_paragraph(
     log::trace!("sentence_lines_for_paragraph called");
     wrapped_lines_for_node(
         config,
+        sentence_profile,
         node,
         &[],
         format_inline_fn,
@@ -1422,6 +1462,7 @@ pub(super) fn sentence_lines_for_paragraph(
 
 pub(super) fn semantic_lines_for_paragraph(
     config: &Config,
+    sentence_profile: &SentenceProfileCache,
     node: &SyntaxNode,
     format_inline_fn: &dyn Fn(&SyntaxNode) -> String,
 ) -> Vec<String> {
@@ -1431,6 +1472,7 @@ pub(super) fn semantic_lines_for_paragraph(
     log::trace!("semantic_lines_for_paragraph called");
     wrapped_lines_for_node(
         config,
+        sentence_profile,
         node,
         &[],
         format_inline_fn,
@@ -1501,6 +1543,7 @@ fn east_asian_break_creates_subscript(config: &Config, node: &SyntaxNode) -> boo
 
 pub(super) fn wrapped_lines_for_node(
     config: &Config,
+    sentence_profile: &SentenceProfileCache,
     node: &SyntaxNode,
     widths: &[usize],
     format_inline_fn: &dyn Fn(&SyntaxNode) -> String,
@@ -1513,8 +1556,11 @@ pub(super) fn wrapped_lines_for_node(
     } else {
         &[1]
     };
-    let mut extra_abbreviations = Vec::new();
-    let profile = resolve_profile(node, config, &mut extra_abbreviations);
+    let profile = if sentence_mode {
+        sentence_profile.resolve(node, config)
+    } else {
+        ResolvedProfile::builtin_only(SentenceLanguage::English)
+    };
     let escape_literal_tildes =
         !options.preserve_newlines && east_asian_break_creates_subscript(config, node);
     let mut builder = TraversalBuilder::new(
@@ -1529,6 +1575,11 @@ pub(super) fn wrapped_lines_for_node(
         options.preserve_newlines,
         escape_literal_tildes,
     );
+    builder.sink.escape_fancy_list_line_start = options.preserve_newlines
+        && config.parser_extensions.fancy_lists
+        && node
+            .ancestors()
+            .any(|ancestor| ListItem::can_cast(ancestor.kind()));
     process_node_recursive(
         config,
         node,

{panache_cli-3.9.0 → panache_cli-3.10.0}/crates/panache-formatter/src/formatter/lists.rs

@@ -8,7 +8,7 @@ use panache_parser::parser::blocks::headings::try_parse_atx_heading;
 use rowan::NodeOrToken;
 
 use super::Formatter;
-use super::preserve::{self, preserve_lines};
+use super::preserve::{preserve_lines, preserve_lines_unprefixed};
 use super::utils::is_block_element;
 
 impl Formatter {
@@ -573,7 +573,7 @@ impl Formatter {
         match wrap_mode {
             WrapMode::Preserve => {
                 let escaped = self.config.formatter_extensions.escaped_line_breaks;
-                for line in preserve::preserve_lines(node, escaped) {
+                for line in preserve_lines_unprefixed(node, escaped) {
                     self.output.push_str(&" ".repeat(indent));
                     self.output.push_str(line.trim_start());
                     self.output.push('\n');
@@ -1184,6 +1184,7 @@ impl Formatter {
                 .map(|source| {
                     inline_layout::wrapped_lines_for_node(
                         &self.config,
+                        &self.sentence_profile,
                         source,
                         &line_widths,
                         &|n| self.format_inline_node(n),
@@ -1210,7 +1211,7 @@ impl Formatter {
                 Some(
                     content_node
                         .as_ref()
-                        .map(|content| preserve::preserve_lines(content, escaped))
+                        .map(|content| preserve_lines_unprefixed(content, escaped))
                         .unwrap_or_default(),
                 )
             }
@@ -1235,6 +1236,7 @@ impl Formatter {
                         .map(|source| {
                             inline_layout::wrapped_lines_for_node(
                                 &self.config,
+                                &self.sentence_profile,
                                 source,
                                 &[],
                                 &|n| self.format_inline_node(n),
@@ -1587,10 +1589,18 @@ impl Formatter {
                             " ".repeat(list_indent.spaces_after),
                         );
                         let table_str = match child.kind() {
-                            SyntaxKind::PIPE_TABLE => {
-                                tables::format_pipe_table(&child, &self.config, content_indent)
-                            }
-                            _ => tables::format_grid_table(&child, &self.config, content_indent),
+                            SyntaxKind::PIPE_TABLE => tables::format_pipe_table(
+                                &child,
+                                &self.config,
+                                &self.sentence_profile,
+                                content_indent,
+                            ),
+                            _ => tables::format_grid_table(
+                                &child,
+                                &self.config,
+                                &self.sentence_profile,
+                                content_indent,
+                            ),
                         };
                         let first_line_indent = " ".repeat(content_indent);
                         self.output.push_str(&prefix);

{panache_cli-3.9.0 → panache_cli-3.10.0}/crates/panache-formatter/src/formatter/math/STYLE.md

@@ -68,6 +68,9 @@ This line hygiene does not otherwise normalize or reflow the preserved content.
 - Panache retains an authored environment-row boundary after a standalone TeX
   control space. The pinned formatter moves the control space onto the next row;
   Panache keeps the semantic space at the physical line end.
+- Panache wraps independent equations at top-level punctuation. The pinned
+  formatter treats their relations as one chain and can strand the second
+  equation's left-hand side at the end of the preceding line.
 
 ## Rules
 
@@ -276,20 +279,31 @@ This line hygiene does not otherwise normalize or reflow the preserved content.
    `:`.
 
 7. **Display line-breaking.** In `reflow` mode, a free display row (`$$…$$`,
-   non-environment) wider than `line-width` is broken at its **top-level**
-   operators in a hierarchy keyed on parser `MathBreakPriority` (**relations** >
-   **binary** > everything else). It chooses a subset of those candidates
-   instead of breaking at every operator. The deterministic layout score charges
-   squared overflow more heavily than a continuation, prefers a later relation
-   break to a binary break, and prefers a binary break to separating the first
+   non-environment) wider than `line-width` is broken after **top-level**
+   punctuation, around `\qquad`, or before top-level operators. Operator
+   candidates follow parser `MathBreakPriority` (**relations** > **binary** >
+   everything else). It chooses a subset of those candidates instead of breaking
+   at every operator. The deterministic layout score charges squared overflow
+   more heavily than a continuation, prefers punctuation and later relation
+   breaks to binary breaks, and prefers a binary break to separating the first
    relation from its left-hand side. Ties favor the smaller maximum line width,
    then the smaller sum of squared line widths. This packs complete operator
    segments together when they fit instead of stranding `\pm`, `\cdot`, or a
    short relation on its own line.
 
+   Top-level punctuation, such as commas and semicolons, and `\qquad` separate
+   independent expressions. A selected break after punctuation starts at the
+   display indent and leaves the punctuation attached to the preceding
+   expression. When a break selects `\qquad`, the command occupies its own
+   source line at the display indent, followed by the next expression at that
+   same indent. Its width does not affect that expression's wrapping or relation
+   alignment. Expressions that fit together keep `\qquad` inline.
+
    A selected later relation starts a continuation aligned under the **first
-   relation**---the classic stacked-`=` layout for an equality/comparison chain.
-   A selected binary continuation sits **flush** under that relation segment's
+   relation in its expression**---the classic stacked-`=` layout for an
+   equality/comparison chain. The anchor is the relation's printed column; if
+   the first relation moves to a new line, later relations follow that column. A
+   selected binary continuation sits **flush** under that relation segment's
    right-hand side. The relation/RHS offset alone supplies the visual nesting;
    binary continuations never pick up an extra step. A top-level conditioning
    bar (`\mid`) identifies neighboring relations as separate predicates rather
@@ -334,12 +348,12 @@ This line hygiene does not otherwise normalize or reflow the preserved content.
    content, `line-width`, and `math-indent`---the author's own line breaks and
    indentation are never preserved, only recomputed.
 
-   - **Top-level only.** An operator at delimiter depth > 0 --- inside the flat
-     token runs `(…)` or `[…]` --- is never a break candidate. Structural
-     `MATH_DELIMITED` (`\left…\right`), `MATH_GROUP`, and `MATH_ENVIRONMENT`
-     nodes are opaque operands that the break scan never descends into, so their
-     interior operators are likewise excluded.
-   - **Spaced operators only.** A candidate has parser
+   - **Top-level only.** Punctuation or an operator at delimiter depth > 0 ---
+     inside the flat token runs `(…)` or `[…]` --- is never a break candidate.
+     Structural `MATH_DELIMITED` (`\left…\right`), `MATH_GROUP`, and
+     `MATH_ENVIRONMENT` nodes are opaque operands that the break scan never
+     descends into, so their interior operators are likewise excluded.
+   - **Spaced operators only.** An operator candidate has parser
      `MathBreakPriority::Binary` or `MathBreakPriority::Relation`; a unary
      `+`/`-` is `Ord` and never a break site. Typed lowering keeps the semantic
      atom stream intact across continuation segments, so a leading binary