lukeed/tidyPublic

feat: format JSDoc comments

Luke decided JSDoc comments are formatted by default, as
prettier-plugin-jsdoc does; js.jsdoc: false turns it off. Port bun's
JSDoc formatter onto tidy's CSS, JSON and YAML formatters and an mdast
built from pulldown-cmark. It matches 149 of oxfmt's 150 fixtures.
The JS oracle compares with Prettier without plugins, so it turns
JSDoc off.
LELuke Edwards authored
437fd4cPatch
Parentaac7046
70 files changed+2026-60
StackedSplit
crates/tidy/src/config.rs+6 โˆ’2
crates/tidy/src/js/ast/jsdoc.rs+516 โˆ’0
crates/tidy/src/js/ast/mod.rs+1 โˆ’0
crates/tidy/src/js/detached/jsdoc.rs+0 โˆ’8
crates/tidy/src/js/jsdoc/embedded.rs+71 โˆ’26
crates/tidy/src/js/jsdoc/imports.rs+2 โˆ’1
crates/tidy/src/js/jsdoc/line_buffer.rs+1 โˆ’1
crates/tidy/src/js/jsdoc/markdown.rs+5 โˆ’5
crates/tidy/src/js/jsdoc/mdast.rs+467 โˆ’0
crates/tidy/src/js/jsdoc/mod.rs+3 โˆ’2
crates/tidy/src/js/jsdoc/normalize.rs+2 โˆ’2
crates/tidy/src/js/jsdoc/param_order.rs+3 โˆ’3
crates/tidy/src/js/jsdoc/serialize.rs+1 โˆ’1
crates/tidy/src/js/jsdoc/strings.rs+86 โˆ’0
crates/tidy/src/js/jsdoc/tag_formatters.rs+1 โˆ’1
crates/tidy/src/js/jsdoc/text.rs+1 โˆ’1
crates/tidy/src/js/jsdoc/wrap.rs+1 โˆ’1
crates/tidy/src/js/mod.rs+4 โˆ’1
crates/tidy/tests/deviations.json+14 โˆ’0
crates/tidy/tests/deviations.rs+12 โˆ’0
crates/tidy/tests/fixtures/jsdoc/default-015-multi-line-codegen.js+4 โˆ’0
crates/tidy/tests/fixtures/jsdoc/default-015-multi-line-codegen.out.js+1 โˆ’0
crates/tidy/tests/fixtures/jsdoc/descriptions-005-dash-list.out.ts+38 โˆ’0
crates/tidy/tests/fixtures/jsdoc/descriptions-005-dash-list.ts+40 โˆ’0
crates/tidy/tests/fixtures/jsdoc/descriptions-011-nested-list.out.ts+15 โˆ’0
crates/tidy/tests/fixtures/jsdoc/descriptions-011-nested-list.ts+13 โˆ’0
crates/tidy/tests/fixtures/jsdoc/descriptions-017-markdown-format.out.ts+27 โˆ’0
crates/tidy/tests/fixtures/jsdoc/descriptions-017-markdown-format.ts+32 โˆ’0
crates/tidy/tests/fixtures/jsdoc/descriptions-024-markdown-table.out.ts+16 โˆ’0
crates/tidy/tests/fixtures/jsdoc/descriptions-024-markdown-table.ts+16 โˆ’0
crates/tidy/tests/fixtures/jsdoc/descriptions-029-jsdoc-link.out.ts+22 โˆ’0
crates/tidy/tests/fixtures/jsdoc/descriptions-029-jsdoc-link.ts+25 โˆ’0
crates/tidy/tests/fixtures/jsdoc/descriptions-031-markdown-link.out.ts+1 โˆ’0
crates/tidy/tests/fixtures/jsdoc/descriptions-031-markdown-link.ts+4 โˆ’0
crates/tidy/tests/fixtures/jsdoc/descriptions-036-indented-code.out.ts+6 โˆ’0
crates/tidy/tests/fixtures/jsdoc/descriptions-036-indented-code.ts+7 โˆ’0
crates/tidy/tests/fixtures/jsdoc/descriptions-037-fenced-code.out.ts+6 โˆ’0
crates/tidy/tests/fixtures/jsdoc/descriptions-037-fenced-code.ts+9 โˆ’0
crates/tidy/tests/fixtures/jsdoc/descriptions-039-reference-style-link.out.ts+7 โˆ’0
crates/tidy/tests/fixtures/jsdoc/descriptions-039-reference-style-link.ts+8 โˆ’0
crates/tidy/tests/fixtures/jsdoc/descriptions-044-hard-break-trailing-spaces.js+14 โˆ’0
crates/tidy/tests/fixtures/jsdoc/descriptions-044-hard-break-trailing-spaces.out.js+14 โˆ’0
crates/tidy/tests/fixtures/jsdoc/example-tag-005-example-json.js+16 โˆ’0
crates/tidy/tests/fixtures/jsdoc/example-tag-005-example-json.out.js+14 โˆ’0
crates/tidy/tests/fixtures/jsdoc/files-order.jsx+15 โˆ’0
crates/tidy/tests/fixtures/jsdoc/files-order.out.jsx+15 โˆ’0
crates/tidy/tests/fixtures/jsdoc/main-002-regular-jsdoc.js+23 โˆ’0
crates/tidy/tests/fixtures/jsdoc/main-002-regular-jsdoc.out.js+26 โˆ’0
crates/tidy/tests/fixtures/jsdoc/main-003-jsdoc-default-values.js+8 โˆ’0
crates/tidy/tests/fixtures/jsdoc/main-003-jsdoc-default-values.out.js+7 โˆ’0
crates/tidy/tests/fixtures/jsdoc/main-004-single-line-conversion.js+12 โˆ’0
crates/tidy/tests/fixtures/jsdoc/main-004-single-line-conversion.out.js+9 โˆ’0
crates/tidy/tests/fixtures/jsdoc/main-006-inner-types.js+19 โˆ’0
crates/tidy/tests/fixtures/jsdoc/main-006-inner-types.out.js+9 โˆ’0
crates/tidy/tests/fixtures/jsdoc/main-007-params-ordering-10-tags.js+16 โˆ’0
crates/tidy/tests/fixtures/jsdoc/main-007-params-ordering-10-tags.out.js+17 โˆ’0
crates/tidy/tests/fixtures/jsdoc/main-021-jsdoc-tags.js+15 โˆ’0
crates/tidy/tests/fixtures/jsdoc/main-021-jsdoc-tags.out.js+13 โˆ’0
crates/tidy/tests/fixtures/jsdoc/main-022-example-tag.js+19 โˆ’0
crates/tidy/tests/fixtures/jsdoc/main-022-example-tag.out.js+17 โˆ’0
crates/tidy/tests/fixtures/jsdoc/main-026-block-quote.js+17 โˆ’0
crates/tidy/tests/fixtures/jsdoc/main-026-block-quote.out.js+15 โˆ’0
crates/tidy/tests/fixtures/jsdoc/typescript-001-typedef-object.out.ts+40 โˆ’0
crates/tidy/tests/fixtures/jsdoc/typescript-001-typedef-object.ts+49 โˆ’0
crates/tidy/tests/fixtures/jsdoc/typescript-007-long-union-types.out.ts+13 โˆ’0
crates/tidy/tests/fixtures/jsdoc/typescript-007-long-union-types.ts+9 โˆ’0
crates/tidy/tests/jsdoc.rs+70 โˆ’0
crates/tidy_napi/src/lib.rs+3 โˆ’3
deviations.md+16 โˆ’0
tests/oracle/js.ts+2 โˆ’2