[{"_1":2,"_3":-5,"_4":-5},"loaderData",{"_5":6,"_7":8,"_9":10,"_11":12},"actionData","errors","root",{"_301":-5,"_304":305,"_306":307},"routes/shell",{"_181":182,"_300":-5,"_301":-5,"_302":303},"routes/repo",{"_174":-7,"_175":176,"_177":178,"_179":180,"_181":182,"_183":26,"_184":26,"_185":26,"_186":26,"_187":26,"_188":26,"_189":190,"_191":192,"_193":26,"_194":-7,"_195":-7,"_196":197,"_198":199,"_200":201,"_202":-5,"_203":204,"_205":206,"_207":208,"_209":210},"routes/repo.commit",{"_13":14,"_15":16,"_17":18},"commit",{"_145":22,"_150":151,"_152":153,"_154":155,"_156":157,"_158":-5,"_159":160,"_161":162},"diff",{"_19":20,"_21":22,"_23":24,"_25":26},"checks",[],"old","cd07a31daba8bde7ece3696087ebbfb40f463865","new","a467e0afd5cf68a9ea5275e98400e90b2e218415","files",[27],"truncated",false,{"_28":29,"_19":30,"_21":31,"_32":33,"_34":35,"_36":37,"_38":39},"path","crates/tidy/src/markdown/handoff.md",{"_145":149,"_147":148},{"_145":146,"_147":148},"kind","text","add",13,"del",6,"hunks",[40,41],{"_42":108,"_44":109,"_46":108,"_48":110,"_50":111},{"_42":43,"_44":45,"_46":47,"_48":49,"_50":51},"aStart",38,"aLen",22,"bStart",41,"bLen",26,"ops",[52,53,54,55,56,57,58,59,60,61,62,63,64,65,66,67,68,69,70,71,72,73,74,75,76,77,78,79,80,81],{"_82":83,"_84":85},{"_82":83,"_84":107},{"_82":83,"_84":106},{"_82":36,"_84":105},{"_82":34,"_84":104},{"_82":83,"_84":85},{"_82":83,"_84":103},{"_82":83,"_84":85},{"_82":83,"_84":102},{"_82":83,"_84":85},{"_82":36,"_84":101},{"_82":36,"_84":100},{"_82":34,"_84":99},{"_82":34,"_84":85},{"_82":34,"_84":98},{"_82":34,"_84":97},{"_82":83,"_84":96},{"_82":34,"_84":95},{"_82":83,"_84":85},{"_82":83,"_84":94},{"_82":83,"_84":85},{"_82":83,"_84":93},{"_82":83,"_84":92},{"_82":83,"_84":91},{"_82":36,"_84":90},{"_82":34,"_84":89},{"_82":34,"_84":88},{"_82":83,"_84":87},{"_82":83,"_84":86},{"_82":83,"_84":85},"tag","eq","line","","- An emphasis mark right after a `*` is `_`. Prettier writes `*`, which merges into `***` and nests the other way.","- Link targets and definitions stay as written where Prettier's form would read differently: unbalanced parentheses, `<`, `>`, a backslash, text that decodes as an entity, or a title with `(` in parentheses.","- With `wrap: never`, the line after a hard break in a one-line footnote keeps its indent. Prettier drops it, which reads the same but worse.","- An indented continuation line that would open a fence, a thematic break, or an HTML block keeps its indent. Prettier drops the indent, which opens the block.","- An indented continuation line that would open a fence, a thematic break, or an HTML block joins the line before. Prettier keeps the line break there, which changes the document.","- Collapsing spaces, trimming code line ends, keeping HTML beside a paragraph or HTML block, and keeping HTML indents apply to every preset, not only Prettier's: all are layout, and none changes how the document parses.","- HTML blocks in a task item keep their indent. Prettier indents their lines after the first past the task box, and adds 4 more spaces on every pass.","- Setext headings become ATX. Prettier 3.9 keeps setext.","Kept on purpose:","4. pulldown-cmark doesn't close a fence followed by tabs (```` ```→→ ````), which CommonMark allows, so the rest of the file reads as code. That's a parser bug to report upstream.","3. A code span over two lines in a list item or quote: Prettier writes the second line with no indent and no `>`. That still parses the same but reads worse, so it isn't planned.","2. A `|` inside a code span in a table cell splits the cell in GFM, and Prettier trims the pieces differently.","1. Deep Hugo templates (bootstrap's `examples/_index.md`): Prettier reads nested Liquid and HTML as HTML blocks and keeps their lines as written.","Most of what C still misses is setext headings, kept as ATX on purpose. The rest:","2. Footnote definitions: Prettier keeps the text on the `[^1]:` line only for one paragraph that is on one line (or with `wrap: never`). Otherwise the text starts on the next line, indented 4.","1. Hugo and Liquid templates (bootstrap, most of what C still misses): Prettier parses `{{ }}` and `{% %}` as their own nodes, keeps the indents of their paragraph lines, and puts no blank line around them.","Most files first. The rules are in Prettier's `src/language-markdown/print/` (`mdast.js`, `children.js`, `list.js`): read them before guessing.","## Known gaps against Prettier","- **Prettier**: the target is Prettier 3.9.10. `mise run oracle:prettier -- ... [--show ]` formats one copy with Prettier (cached in `target/oracle`), one with mdtidy, counts identical files, and sorts the differences by kind. It hands mdtidy every file by name, because the CLI skips hidden folders on purpose. Last result: A 870/872, B 2,141/2,142, C 3,442/3,466, D 283/310. The semantics oracle passes on all four. `bun fmt` is close (8 misses, all inside code blocks) but it is not the reference.","- **Prettier**: the target is Prettier 3.9.10. `mise run oracle:prettier -- ... [--show ]` formats one copy with Prettier (cached in `target/oracle`), one with mdtidy, counts identical files, and sorts the differences by kind. It hands mdtidy every file by name, because the CLI skips hidden folders on purpose. Last result: A 870/872, B 2,140/2,142, C 3,416/3,466, D 278/310. The semantics oracle passes on all four. `bun fmt` is close (8 misses, all inside code blocks) but it is not the reference.","- **Speed**: `mise run bench:ab -- [--rev ] ...` builds the working tree and `` (HEAD by default, in a temporary worktree), times both checking the folders in both orders, and compares medians: means swing with machine load. Each fix on 2026-10-30 and 2026-11-01 was within noise; together they cost about 2–3% (about 38 to 39 ms on A + B).","- **Semantics**: `MDTIDY_CORPUS=[:...] mise run oracle:semantics`. Every output re-parses to the same events (adjacent text merged, soft breaks as spaces, whitespace collapsed) and settles after one pass. It runs the Prettier preset, the Preserve preset, `wrap: always` at width 40, and `wrap: never`. It caught every real bug so far: trust it over reading diffs. When a file fails, `mise run oracle:shrink -- [mdtidy options...]` removes lines while it still fails and prints the few that are left. The events it compares come from `tests/support/events.rs`, shared by the test and the `events` example.",17,12,15,[112,113,114,115,116,117,118,119,120,121,122,123,124,125,126,127,128],{"_82":83,"_84":144},{"_82":83,"_84":85},{"_82":83,"_84":143},{"_82":36,"_84":142},{"_82":34,"_84":141},{"_82":83,"_84":140},{"_82":83,"_84":139},{"_82":83,"_84":138},{"_82":83,"_84":137},{"_82":36,"_84":136},{"_82":34,"_84":135},{"_82":34,"_84":134},{"_82":34,"_84":133},{"_82":34,"_84":132},{"_82":83,"_84":131},{"_82":83,"_84":130},{"_82":83,"_84":129},"- **Prettier rules** (from `printer-markdown`): adjacent sibling lists alternate `-`/`*` and `.`/`)`, git-diff-friendly numbering, `isAligned` with tab width 2, `_` emphasis falling back to `*` next to a word or inside emphasis, `---` (or `***` inside a list), backtick fences one longer than any run inside, aligned tables that only compact under `wrap: never`, the block after `` on the very next line, code spans with the fewest backticks that no run inside matches, one space for each run of spaces in text, sibling definitions on adjacent lines, no trailing whitespace on code lines, and a task item's first paragraph indented past its box (`BOX`).","- **Code blocks are buffered** for the `format_with` callback. Front matter goes to it before parsing starts.","- **Paragraphs are buffered only when wrapping** (`wrap.rs`). A line never starts with something that opens a block (`opens_block`).","- **Footnotes** read ahead to their end to decide whether the text starts on the `[^1]:` line (`footnote.rs`).","- **Liquid** (`{{ }}`, `{% %}`, Hugo shortcodes) is a block of its own in Prettier's parser and paragraph text in pulldown-cmark's. mdtidy keeps pulldown-cmark's reading and copies Prettier's layout where it is safe (`liquid.rs`): no blank line beside a Liquid line, lazy Liquid lines stay at the margin, an HTML start after a Liquid line keeps the rest of the paragraph as written, and filling never breaks a Liquid tag or the lines beside one.","- **Definitions have no events.** pulldown-cmark lists one per label, so the gap after each sibling block (`cursor`) is parsed for the ones it left out (`define.rs`). Definitions are flushed before a container ends and after a list ends, since a list's range stretches over the definitions after it.","- **An indented continuation line never opens a block** (`opener.rs`). Without its indent, a line starting with `>`, `#`, or a list marker joins the line before; a line of `=` or `-` gets a backslash; a fence, a break, or a block HTML tag keeps its break and indent at the top level, and joins inside containers.","- **An indented continuation line never opens a block** (`opener.rs`). Without its indent, a line starting with `>`, `#`, a list marker, a fence, a break, or a block HTML tag joins the line before; a line of `=` or `-` gets a backslash.","- **Front matter is found by hand**, with Prettier's rule, only at the very start (`front.rs`). pulldown-cmark's metadata flags are off because they find front matter anywhere, even inside a list item.","- **Blank lines between list items follow the source** (`Gap::Source`, `blank()`). Inside an item they follow the source too, unless the item is loose by Prettier's `isLooseListItem` (a blank line between direct children, or before the next item): then every block gets one, except a nested list.","- **Lookahead is a small buffer** (`Events`). It reads up to three ordered-list items for Prettier's numbering and alignment rules before the first item is written, and each item reads ahead to its end to decide whether it is loose (`loose`).","- **Containers are a prefix stack** (`Container`: quote, list item, footnote, indented code). A list item's marker replaces its indent on its first line.","- **The writer is a folder module.** `writer/mod.rs` holds the event loop; `layout.rs` (gaps and prefixes), `list.rs`, `code.rs`, `inline.rs`, `define.rs` (definitions), `footnote.rs`, and `liquid.rs` (soft breaks) are child modules that reach its private state. `front.rs` finds front matter and `opener.rs` finds lines that would open a block. Keep each file under 800 lines: split again rather than grow `mod.rs`.","- **The writer is a folder module.** `writer/mod.rs` holds the event loop and layout; `list.rs`, `code.rs`, and `inline.rs` are child modules that reach its private state. `front.rs` finds front matter and `opener.rs` finds lines that would open a block.","- **Blocks are normalized, inlines are mostly copied.** Text, HTML, entities, escapes, and image alt text are written as source slices. A text event's range starts after a backslash escape, so the writer extends it back one byte (`writer/mod.rs`, `Event::Text`). Text loses runs of spaces (`collapse`, which uses memchr so plain text costs no copy), code spans get their delimiters rewritten (`span`), and link text goes through the same path as other inline content (`Link`). Inline link and image targets and definitions are written from their parsed values (`writer/inline.rs`: `tail`, `definition`), except where that would read differently: then the source stays.","One pass over pulldown-cmark's offset events, writing straight into a `String`. No tree and no layout document. That is the whole speed story: keep it _streaming_.","oid","034afbd","mode","100644","24a0f5b","parents",[20],"author",{"_164":165,"_166":167,"_172":173},"committer",{"_164":165,"_166":167,"_172":173},"message","docs: update handoff\n\nFootnotes and Liquid are done; repeated definitions are kept. Record\nthe new modules, how definitions and Liquid lines are handled, the\nmatch counts, and what is left, including a pulldown-cmark fence bug.","signature","subject","docs: update handoff","authors",[163],{"_164":165,"_166":167,"_168":169,"_170":171},"name","Luke Edwards","email","luke.edwards05@gmail.com","login","lukeed","avatarUrl","https://avatars.githubusercontent.com/u/5855893?v=4","time",1793549994,"documentNavigation","repo","lukeed/tidy","repoId","b2cac5cc-818f-4958-803a-7d401ccd9a90","ownerId","user:5855893","site","nexthub","private","admin","settings","maintainer","triage","starred","stars",0,"watchers",1,"watching","pinned","notify","views",[256,257,258,259,260,261,262,263,264,265,266,267,268],"navigation",{"_196":197,"_217":218,"_219":220,"_221":222,"_223":224,"_225":226,"_82":227},"sources",[],"viewer","meta",{"_212":85,"_213":169,"_214":85,"_183":26,"_215":211,"_216":26,"_189":190,"_191":192},"branches",[211],"tags",[],"cloneUrl","https://git.nexthub.sh/lukeed/tidy.git","main","description","owner","section","head","empty","pins",[239,240,241],"documents",{"_236":237,"_238":190},"code",{"_233":234,"_235":190},"automations",{"_230":231,"_232":-5},"delivery",{"_228":190,"_229":-5},"W1_y18R9FUcyveBRlHeRXdVTtjo","releases","applications","workflows",2,"deployments","commits",350,"changes","counts",{},"total",{"_242":235,"_164":254,"_28":235,"_245":255,"_194":247,"_248":26,"_249":247,"_250":190},{"_242":251,"_164":252,"_28":251,"_245":253,"_194":247,"_248":26,"_249":247,"_250":190},{"_242":243,"_164":244,"_28":243,"_245":246,"_194":247,"_248":26,"_249":247,"_250":190},"id","issues","Issues","filters",{},true,"saved","pinnable","count","tasks","Tasks",{},"Changes",{},{"_242":235,"_164":254,"_28":235,"_245":299,"_194":247,"_248":26,"_249":247},{"_242":251,"_164":252,"_28":251,"_245":298,"_194":247,"_248":26,"_249":247},{"_242":243,"_164":244,"_28":243,"_245":297,"_194":247,"_248":26,"_249":247},{"_242":294,"_164":295,"_28":294,"_245":296,"_194":26,"_248":26,"_249":247},{"_242":291,"_164":292,"_28":291,"_245":293,"_194":26,"_248":26,"_249":247},{"_242":230,"_164":289,"_28":223,"_245":290,"_194":26,"_248":26,"_249":247},{"_242":232,"_164":286,"_28":287,"_245":288,"_194":26,"_248":26,"_249":247},{"_242":228,"_164":284,"_28":228,"_245":285,"_194":26,"_248":26,"_249":247},{"_242":280,"_164":281,"_28":282,"_245":283,"_194":26,"_248":26,"_249":247},{"_242":219,"_164":278,"_28":219,"_245":279,"_194":26,"_248":26,"_249":26},{"_242":275,"_164":276,"_28":275,"_245":277,"_194":26,"_248":26,"_249":26},{"_242":272,"_164":273,"_28":272,"_245":274,"_194":26,"_248":26,"_249":26},{"_242":269,"_164":270,"_28":269,"_245":271,"_194":26,"_248":26,"_249":26},"decisions","Decisions",{},"changelog","Changelog",{},"roadmap","Roadmap",{},"Documents",{},"activity","Activity","insights",{},"Releases",{},"Deployments","automations/deployments",{},"Workflows",{},"discussions","Discussions",{},"goals","Goals",{},{},{},{},"groups","user","agents",[],"now",1794584330335,"sidebar","expanded"]