Sync v12 core docs

[tsnobip]

A draft to sync Stdlib docs (#981) based on #990.

Current state:

• syncing JS docs crashes fixed
• Stdlib docs are exported as Core and not as Stdlib fixed

[vercel]

The latest updates on your projects. Learn more about Vercel for Git ↗︎

Name	Status	Preview	Comments	Updated (UTC)
rescript-lang.org	✅ Ready (Inspect)	Visit Preview	💬 Add feedback	Jun 16, 2025 1:19pm

[cloudflare-workers-and-pages]

Deploying rescript-lang-org with    Cloudflare Pages

Latest commit:	9adeb35
Status:	✅  Deploy successful!
Preview URL:	https://cad28eab.rescript-lang.pages.dev
Branch Preview URL:	https://sync-v12-core-docs.rescript-lang.pages.dev

View logs

[fhammerschmidt]

Can you still generate docs for Core/v11 with these changes?

[Copilot]

Pull Request Overview

This PR prepares the documentation sync for v12 by updating naming and version logic to expose Stdlib instead of Core. Key changes include conditional handling of API category names, updates to version selection and constants, revised Node binding for process execution, and corresponding updates to the docs pages and JSON TOC.

Reviewed Changes

Copilot reviewed 11 out of 11 changed files in this pull request and generated no comments.

Show a summary per file

File	Description
src/layouts/ApiOverviewLayout.res	Uses conditional logic to display “Stdlib” for v12.0.0 and above and falls back to “Core” otherwise.
src/components/VersionSelect.res	Adjusts the rendering of the section header based on the availability of versions.
src/common/Constants.res	Renames and repurposes version arrays from “coreVersions” to “stdlibVersions” with updated logic.
src/bindings/Node.res	Updates the execSync binding to accept optional options.
src/ApiDocs.res	Revises key usage and string replacements to support the Stdlib naming convention.
scripts/gendocs.res	Reorders arguments, updates command examples, and adds error handling with an increased max buffer.
pages/docs/manual/v12.0.0/api.mdx	Updates headings and content to reflect the transition from “ReScript Core” to “Stdlib”.
data/api/v12.0.0/toc_tree.json	Updates the JSON TOC to align with the new naming and structure.

Comments suppressed due to low confidence (2)

scripts/gendocs.res:32

• Reordering arguments in the gendocs script changes the expected parameter positions; please update the related documentation and any call sites to ensure compatibility.

let version = switch args->Array.get(1) {

src/common/Constants.res:28

• [nitpick] Ensure that the new variable name 'stdlibVersions' accurately reflects its purpose across the codebase and update any accompanying comments or documentation for clarity.

let stdlibVersions = versions.latest === "v11.0.0" ? [latestVersion] : [("v11.0.0", "v11"), latestVersion]

[tsnobip]

Can you still generate docs for Core/v11 with these changes?

@fhammerschmidt hmm likely not. What I could do would be to remove the diffs on gendocs since I'll move this logic to rescript monorepo anyway.

[fhammerschmidt]

Yes that makes the most sense to move the logic there for v12.

[fhammerschmidt]

Selecting a version from Belt should keep one in Belt but it currently jumps to Stdlib or Core as well.

[tsnobip]

Selecting a version from Belt should keep one in Belt but it currently jumps to Stdlib or Core as well.

good catch!