v0.87.4: docs in the tarball, renderDocument, a help default
The docs-on-site engine window: the surface the cairn.pub docs pipeline builds on.
Added
createRenderergainsrenderDocument, a sibling torenderMarkdownthat additionally returns the rendered page'sheadings(DocHeading[]:id, flattenedtext,depth), collected from the final rehype tree afterrehypeSlugand any siterehypePluginshave run. A page that needs a table of contents or a heading anchor list callsrenderDocumentinstead of re-parsingrenderMarkdown's HTML string.renderMarkdownis unchanged. No consumer action.- The published docs tree (
docs/reference,docs/guides,docs/explanation,docs/tutorial,docs/README.md) now ships inside the npm tarball, so a consumer site can read the docs at build time without a separate checkout.docs/internal,docs/superpowers, anddocs/STATUS.mdstay out, and thecheck:packagegate asserts both directions. Cost: 501 to 562 files, 1.73 MB to 1.96 MB packed.
Changed
- The admin's Get Help hand-off now has a default destination: a site that sets no
editor.supportContactgetshttps://cairn.pub/help, cairn's own hosted editor help, instead of the self-serve empty state. An explicit value still wins, and an explicit empty string restores the prior no-link state. A site that relied on unset meaning no link shows the hosted-help link until it sets one of those two.
No breaking changes; no Consumers must: actions.