chore(master): release 5.61.0

[yc-ui-bot]

🤖 I have created a release beep boop

5.61.0 (2026-09-22)

Features

• add addAlternateMeta option (#1710) (8277869)
• add analytics to toc schema (#1836) (46357f7)
• add disableCsp config option (#1776) (e056ac3)
• add error if duplicated key (#1652) (e5f75b6)
• Add mode "content" for single file DOCSTOOLS-5984 (3792860)
• add openapi companion DOCSTOOLS-5791 (8240cd9)
• added color extension (#2045) (3d97b50)
• added crawler manifest (#1771) (efca399)
• added crawler section in .yfm support (#1807) (75c350f)
• added endPages (#1792) (434a095)
• added footer (#2073) (53f79ed)
• added init command (#1748) (16a26b7)
• added notifications in crawler manifest (#1984) (dd64f96)
• added page tags (#2158) (1a864a3)
• added summary field in meta (#2261) (1c4d1c4)
• added support for documentation with ya.make (#2030) (00ed72b)
• added type option in neuroExpert (#1853) (c8a1a49)
• ai: Add link alternate to md companion DOCSTOOLS-6313 (f286589)
• ai: Add link llms DOCSTOOLS-6317 (926e5e2)
• analytics: add csp rules when metrika counter is configured (#1846) (8a81d87)
• build audience-specific documentation DOCSTOOLS-6553 (0e9ddd8)
• build-content-map: content-fingerprint manifest for cross-build diff (#1951) (b965e91)
• build: emit build stats file with timing and counters (#1905) (66a9dcd)
• build: emit static Markdown companions (4a2b898)
• build: enable build-stats and build-content by default for md2md (#1976) (029b4b5)
• build: generate llms.txt and llms-full.txt (#1986) (2492619)
• cli: add --disable-csp CLI flag (#1795) (0439a96)
• cli: add token-level source tracking to includes plugin (013b06b)
• cli: support static base href (24a725b)
• Embedding the include at the bottom of the page (c673209)
• enable merge includes (fb2a582)
• generic-includer: add linkIndex option (#1784) (bb3ee39)
• generic-includer: add linkIndexAutotitle option for directory titles from index.md (#1898) (52c9672)
• generic-includer: add opt-in natural sort options (#1901) (e0e0d27)
• implement max openapi include size (2e327d1)
• Include wtih indent and hash (cb11158)
• infra: remove cli-tests DOCSTOOLS-4734 (cb9aa5e)
• llms: add viewer audience variants (a55e657)
• preserve Markdown actions config (7ffd3e7)
• removed schemas and replaced it with @diplodoc/ajv (#2004) (df65a89)
• schemas: add analytics.metrika property to yfm schema (#1825) (4e3f857)
• Set YFM009 Error, support miltiline termDefinitions (82fae22)
• Simple inline includes (203d15d)
• themer: add code highlight theme configuration and tests (#1966) (99bebb3)
• translate: add --report flag with a machine-readable run report (#2224) (584995d)
• translate: add AI translation provider (Yandex AI Studio / OpenAI / OpenRouter / Anthropic) (#1906) (2b2f8a9)
• translate: add translation quality eval harness (#2225) (d99f3f2)
• translate: align existing translations block by block when seeding (#2272) (c3eae2d)
• translate: allow the fallback model on its own endpoint (#2255) (6e1a8a6)
• translate: copy assets into the translated output (#2163) (ed1f0d9)
• translate: eval series as the gate before a model change (#2282) (c92ab94)
• translate: model benchmark with a pairwise judge (#2256) (fb7aac0)
• translate: optional LLM-as-judge quality report for AI translations (#2136) (305809a)
• translate: pass document context to AI translation prompts (#2134) (2215c4d)
• translate: persistent translation cache for AI providers (#2135) (84975c7)
• translate: seed the translation cache from existing translations (#2206) (3bf7c1f)
• translate: support --context-file for AI providers DOCSTOOLS-6493 (#2205) (c8c6e96)
• translate: support --fallback-model for AI providers (#2204) (50834cc)
• translate: support --include-vcs-diff for translating only changed files (#2189) (d280fb4)
• use generateID from utils DOCSTOOLS-5561 (02b65ed)

Bug Fixes

• add raw param for content mode (035b978)
• add codeLineWrapping to BaseConfig (c3640cc)
• add frontmatter from include when parent is empty DOCSTOOLS-6100 (8fded44)
• add gallery flag to config (7f3a2a4)
• add liquid cycles for md2md DOCSTOOLS-5853 (1080d0a)
• add llms format resolve with defined method (b3ffe47)
• Add llms url, add llms feature in build-stats DOCSTOOLS-5956 (913c0ef)
• Add llmsFullMaxSize param DOCSTOOLS-6204 (6304521)
• add missing CSP for contributors on leading pages (#1785) (843f065)
• Add openapi spec links to llms.txt DOCSTOOLS-6346 (eaed307)
• add RA in builm manifest with empty rules (92ae662)
• add resolve llms enable (0deaac2)
• add restricted-access to build-manifest DOCSTOOLS-6180 (36c2ca8)
• add source maps for included (c5e45b6)
• add theme to front matter (#1706) (ee7ace2)
• add timeout arg for translate provider (23dce21)
• Add validate toc structure DOCSTOOLS-5856 yandex-cloud/docs#1088 (036826a)
• add warning for arcadia vcs (#1892) (bf8353a)
• added arc root (#2099) (6db7f17)
• added crawler-manifest when -f html (#2049) (c91a625)
• added customLabel to neuro expert (#1754) (ddf994b)
• added DOCS_CONFIG support (#2060) (cdfed90)
• added theme.css on search page (#2232) (662be50)
• added ya.make ignore command (#2177) (1f03917)
• address audience build review DOCSTOOLS-6553 (fa5ccc6)
• adjust llms.txt/llms-full.txt format to meet llmstxt.org spec (25c491a)
• assets: move asset size validation to markdown hook and optimize… (#1994) (932c3b5)
• bug in cache dump with 1 include and different hash (ea472d3)
• bugs 19-23 for mergeIncludes (66e5b1e)
• bugs 28-29 (c2173cd)
• bugs 31-33 (df787cf)
• build-content-map: stabilize content hash for inlined SVG ids (#2013) (128cf6e)
• build: address companion sonar findings (6855efb)
• build: copy images referenced only by gallery-src (#2273) (6b40188)
• build: filter companion graphs before collection (c2aae71)
• build: initialize AI config for companions (d3dc216)
• build: preserve visibility in companion includes (24e3f30)
• bundless (b3feea1)
• ci: update snapshot DOCSTOOLS-6241 (d3e1726)
• ci: update snapshots with amend on default (06cd209)
• Clear llms-full from style, script DOCSTOOLS-6205 (70ca214)
• cli: avoid backtracking in base path normalization (0af3f67)
• cli: avoid markdown lint plugin side effects (b52daf9)
• cli: limit markdown lint to audience validation (6405640)
• cli: omit merged line number from visibility errors DOCSTOOLS-6553 (4cd4686)
• cli: preserve markdown link destinations (7428448)
• cli: use describedby for llms.txt metadata (9754c78)
• copy pdf icon as custom resource (0f36c8d)
• correct read llmsFullMaxSize DOCSTOOLS-6204 (4330f44)
• correct title for openapi companion DOCSTOOLS-6346 (68c1f21)
• correct use features with plugins on include pages DOCSTOOLS-5398 (59a8824)
• deps: Update @diplodoc/ajv@0.0.6 (#2033) (34a8078)
• deps: Update @diplodoc/ajv@0.0.7 (0b2791c)
• deps: Update @diplodoc/ajv@0.1.1 (#2072) (08f6d39)
• deps: Update @diplodoc/ajv@0.1.4, @diplodoc/client@5.10.0, @diplodoc/translation@1.7.28, dev:@diplodoc/mermaid-extension@2.2.1, dev:@diplodoc/openapi-extension@5.2.3, dev:@diplodoc/page-constructor-extension@0.13.11 (#2122) (ef5c92f)
• deps: Update @diplodoc/ajv@0.1.5 (831b7b5)
• deps: Update @diplodoc/ajv@0.4.2 (3a68198)
• deps: Update @diplodoc/ajv@0.5.0 (#2262) (7b1e454)
• deps: Update @diplodoc/ajv@0.6.1 (#2280) (b397a4d)
• deps: Update @diplodoc/client to 5.2.3 (#1712) (69bb2b1)
• deps: Update @diplodoc/client to 5.2.5 (#1725) (649e571)
• deps: Update @diplodoc/client to 5.2.6 (#1728) (1d9b099)
• deps: Update @diplodoc/client to 5.2.8 (#1747) (96972f6)
• deps: Update @diplodoc/client@5.10.2 (#2133) (727ddb9)
• deps: Update @diplodoc/client@5.10.3 (dad2eba)
• deps: Update @diplodoc/client@5.11.1 (6e8ce7f)
• deps: Update @diplodoc/client@5.11.3 (96be9fe)
• deps: Update @diplodoc/client@5.11.4 (a50b85a)
• deps: Update @diplodoc/client@5.11.7 (#2195) (f49c20e)
• deps: Update @diplodoc/client@5.12.2 (#2253) (570a3eb)
• deps: Update @diplodoc/client@5.13.0, dev:@diplodoc/page-constructor-extension@0.13.16 (452bfb5)
• deps: Update @diplodoc/client@5.13.2 (#2268) (ec0b779)
• deps: Update @diplodoc/client@5.2.11, @diplodoc/transform@4.71.0 (691cf45)
• deps: Update @diplodoc/client@5.2.12 (#1801) (dad3f4a)
• deps: Update @diplodoc/client@5.2.13 (#1808) (de700e3)
• deps: Update @diplodoc/client@5.2.15 (#1822) (2a5d8f6)
• deps: Update @diplodoc/client@5.2.16 (#1826) (30a538e)
• deps: Update @diplodoc/client@5.3.1 (#1832) (218b1d1)
• deps: Update @diplodoc/client@5.4.0 (#1857) (2617ea8)
• deps: Update @diplodoc/client@5.4.1 (#1860) (957034d)
• deps: Update @diplodoc/client@5.5.0 (#1861) (bc2e9b0)
• deps: Update @diplodoc/client@5.5.1 (#1864) (fc561ad)
• deps: Update @diplodoc/client@5.5.2 (22262e3)
• deps: Update @diplodoc/client@5.5.3 (4889ec3)
• deps: Update @diplodoc/client@5.5.4 (#1911) (b27e948)
• deps: Update @diplodoc/client@5.6.1 (bdb7299)
• deps: Update @diplodoc/client@5.7.0 (#1941) (3f078bf)
• deps: Update @diplodoc/client@5.7.1 (#1942) (e926f69)
• deps: Update @diplodoc/client@5.7.2 (154b2e2)
• deps: Update @diplodoc/client@5.7.3 (#1956) (920c91d)
• deps: Update @diplodoc/client@5.7.5 (#1963) (350652d)
• deps: Update @diplodoc/client@5.7.7 (a5cc810)
• deps: Update @diplodoc/client@5.7.8 (a47977f)
• deps: Update @diplodoc/client@5.7.9 (#1992) (d406594)
• deps: Update @diplodoc/client@5.8.1 (#2070) (a56b9aa)
• deps: Update @diplodoc/client@5.9.2 (#2082) (312fbe4)
• deps: Update @diplodoc/components@5.17.4 (a2c73ba)
• deps: Update @diplodoc/liquid@1.5.2 (#1962) (6664653)
• deps: Update @diplodoc/mermaid-extension@2.1.3 (#2001) (5caacf6)
• deps: Update @diplodoc/page-constructor-extension to 0.13.2 (#1761) (8e5ecda)
• deps: Update @diplodoc/page-constructor-extension@0.13.4 (#1953) (dbbaf36)
• deps: Update @diplodoc/page-constructor-extension@0.13.8 (#2078) (f63ce13)
• deps: Update @diplodoc/search-extension to 3.0.2 (#1732) (8ba2e51)
• deps: Update @diplodoc/transform to 4.70.0 (04aa1f0)
• deps: Update @diplodoc/transform to 4.70.1 (#1736) (6435d63)
• deps: Update @diplodoc/transform to 4.70.2 (ec6b767)
• deps: Update @diplodoc/transform@4.73.2, @diplodoc/client@5.2.14 (#1813) (a2bcc75)
• deps: Update @diplodoc/transform@4.75.1 (#1927) (f92b016)
• deps: Update @diplodoc/transform@4.75.4, @diplodoc/translation@1.7.24 (#1964) (99f5f8c)
• deps: Update @diplodoc/transform@4.76.1 (f39224d)
• deps: Update @diplodoc/transform@4.76.2 (a442127)
• deps: Update @diplodoc/transform@4.77.1, @diplodoc/client@5.9.2 (55e5529)
• deps: Update @diplodoc/transform@4.77.10 (368bd9a)
• deps: Update @diplodoc/transform@4.77.12 (8fd3c7a)
• deps: Update @diplodoc/transform@4.77.13 (8c39735)
• deps: Update @diplodoc/transform@4.77.14 (34086cc)
• deps: Update @diplodoc/transform@4.77.15 (93c192f)
• deps: Update @diplodoc/transform@4.77.6 (ed78a59)
• deps: Update @diplodoc/transform@4.77.7 (#2121) (447391a)
• deps: Update @diplodoc/transform@4.77.8 (#2130) (1a95b2b)
• deps: Update @diplodoc/translation@1.7.21 (2cc971d)
• deps: Update @diplodoc/translation@1.7.22 (f8da04a)
• deps: Update @diplodoc/translation@1.7.26 (7ba5159)
• deps: Update @diplodoc/translation@1.7.30 (#2182) (cf1e77b)
• deps: Update @diplodoc/utils@2.2.3 (#1960) (2bf1d77)
• deps: Update @diplodoc/utils@2.3.5 (#2100) (2aea830)
• deps: Update @diplodoc/yfmlint@1.7.0 (#1837) (47a653a)
• deps: Update @diplodoc/yfmlint@1.7.1 (#1844) (554c156)
• deps: Update @diplodoc/yfmlint@1.7.2 (#1851) (afa3366)
• deps: Update @diplodoc/yfmlint@1.7.3 (#1855) (290fab3)
• deps: Update @diplodoc/yfmlint@1.7.5 (#1885) (f69b21f)
• deps: update client, transform (87e75a6)
• deps: Update client, transform (5171f9e)
• deps: Update dev:@diplodoc/mermaid-extension@2.1.2 (68e5834)
• deps: Update dev:@diplodoc/mermaid-extension@2.2.0 (#2069) (e2c4f4a)
• deps: Update dev:@diplodoc/mermaid-extension@2.2.3 (df10ecf)
• deps: Update dev:@diplodoc/page-constructor-extension@0.13.13 (094c84b)
• deps: Update dev:@diplodoc/search-extension@3.0.5 (#1873) (debac90)
• deps: Update dev:@diplodoc/search-extension@3.1.1, @diplodoc/client@5.11.5 (#2191) (5483fae)
• deps: Update dev:@diplodoc/search-extension@3.1.2 (#2251) (d5b86df)
• deps: update e2e snapshot (59d375f)
• deps: Update openapi@5.1.3 and test (d2ae11d)
• deps: updated node to 24 (#1957) (cf937da)
• dir "constructor" not in build manifest (e1501d3)
• do not copy twice toc entry (b78508a)
• do not fail translate extract on link-included tocs (#2107) (0fa0a5a)
• e2e for new transform (d0169f4)
• e2e: regression test (ec1e9d8)
• e2e: Unknown highlight.js theme: "github-dark" (540149a)
• e2e: update llms metadata snapshots (90df29f)
• e2e: update transform regression snapshots (59708ab)
• edit meta keywords parse (80b5612)
• empty include content handle (#1950) (96124ba)
• enable build manifest by default (481c10c)
• exclude build dir from repeated input (3bbbc7d)
• exclude hidden from llms and llms-full DOCSTOOLS-6195 (0538e11)
• extend copy assets with file directive link (22fbc30)
• filter fake links (#2054) (c0c19a5)
• fixed anchor in md (#1839) (0dd1b00)
• fixed anchors to non-heading elements (#2052) (5f509fe)
• fixed arcadia-vcs (#1907) (a59d063)
• fixed autotitles on windows (#2009) (1f07a7e)
• fixed bundledDeps (#1827) (d013d74)
• fixed crawler manifest (#1923) (f23e3cd)
• fixed crawler manifest (#1998) (6f28ef9)
• fixed getAuthors (#1930) (3150074)
• fixed handling of the label field in toc.yaml (#1720) (7a24352)
• fixed init (#1996) (f2f8a94)
• fixed meta set (#2194) (5c225c8)
• fixed non-working options in .yfm (#1708) (7656e6c)
• fixed pc in md files in pdf (#1979) (d179d34)
• fixed pc md images (#2021) (c7451e2)
• fixed search favicon (#1730) (475726a)
• goals of the neuroexpert's actions in the metrics (#1908) (ada52fe)
• hash for tests (09ab447)
• improved tag normalization (#2190) (904c8b0)
• llms: check noIndex in docs-viewer namespace (9fa1806)
• llms: exclude noIndex pages from llms.txt and llms-full.txt (6740058)
• llms: preserve audience separators (890d5ac)
• llms: preserve merge behavior while restoring separators (b516ab0)
• llms: read noIndex from source file instead of MetaService (2819fa2)
• meta fields parse to html and update snapshots (45e9975)
• metadata lost (#1698) (5c914b7)
• no add indent in term definitions (5a9991c)
• pdf multi toc (d53bd74)
• preserve PDF footnote links (#2267) (3b06f69)
• race for write file (30cdb6e)
• regression bug 29 (0692761)
• remove diplodoc components from deps (#2148) (5d06192)
• remove node url DOCSTOOLS-6242 (d2aaea5)
• rm extra wraps on compose (0d495d5)
• sorted alternates and contributors (#1743) (249018c)
• stop merge includes with indent out and in (fc0b1ee)
• Support includes in terms (c687b6c)
• switch page-constructor to CSR mode to fix hydration bugs (#1726) (f9a9271)
• template: preserve whitespace in body interpolation in Template.dump (a4c491a), closes #1893
• templating: cleanup empty directories (#1991) (ea826ea)
• terms in merge includes DOCSTOOLS-3760 (50312d9)
• tests: do not ship the translate eval e2e and corpus in the npm package (#2234) (a43b6c7)
• tests: fix flap tests for vcsPath (8be58d7)
• tests: normalize bundle test DOCSTOOLS-5718 (7e3154e)
• trailing slash and blockquote DOCSTOOLS-6001 (e86163c)
• translate/seed: tolerate per-file load and extraction errors (#2220) (77961e6)
• translate: do not require --auth when the auth header comes via api headers (#2188) (e594a92)
• translate: keep link-included tocs in translate and seed file lists (#2270) (16da1c3)
• translate: recover from models which reject temperature (#2257) (2e81018)
• translate: retry untranslated units and heal poisoned cache entries (#2170) (aa1a6a6)
• translate: seed translations whose edge markers were hoisted into their skeleton (#2284) (348de81)
• translate: stop relying on the model echoing xliff wrappers (#2159) (b3605c1)
• translate: stop shipping units the model returns untranslated (#2277) (b4a58e7)
• translate: strip emphasis the model adds around fragments (#2254) (56ff3ee)
• translate: survive sustained rate limit windows in ai provider (#2186) (b92a350)
• translate: usability fixes for AI provider after field trial (#2150) (deb30e4)
• update e2e snapshots (e155a60)
• update file formats (dc9ff56)
• update transform (ff298ef)
• update transform + tests DOCSTOOLS-6054 (6445a1f)
• updated e2e snapshots (d604ee1)
• Upgrade typescript to 5.9.3 DOCSTOOLS-6357 (ad248cd)
• Upgrade typescript to 6.0.3 DOCSTOOLS-6359 (8204740)
• vcs path (#1971) (bfd0755)
• yaml compose format fix (0ca1043)
• yfmlint: keep error level after double normalization #5243 (4c352b3)

Performance Improvements

• build: skip fallback parsing for regular pages (722509d)
• meta: avoid duplicate path normalization (39fb290)

Miscellaneous Chores

• master: release 5.61.0 (afe8760)

---

This PR was generated with Release Please. See documentation.

[diplodoc-bot]

Auto-approved by diplodoc-bot (machine user, member of @diplodoc-platform/team) for an automated bot PR (dependency update / release). The change is generated by automation; this approval only satisfies branch-protection review requirements. CI must still pass.

[sonarqubecloud]

Quality Gate passed

Issues
0 New issues
0 Accepted issues

Measures
0 Security Hotspots
0.0% Coverage on New Code
0.0% Duplication on New Code

See analysis details on SonarQube Cloud