docgen: support hardhat3-style branches in injectTemplates

[ernestognw]

Summary

The docgen-pipeline (#140) assumed a Hardhat 2 / solidity-docgen source repo: docs/config.js, docs/templates-md/, kebab-case helpers, all CJS. The hardhat3 branch of openzeppelin-contracts ships an in-tree docgen plugin that:

• reads docs/config.mjs (ESM, loaded via import() in prepare-docs.sh)
• looks for templates in docs/templates/
• defaults to pageExtension: '.adoc'
• loads helpers only from helpers.ts / properties.ts via await import() — and only picks up ESM named function exports

Result on run 26575968521: our injection wrote docs/config.js and docs/templates-md/, both silently ignored. The plugin ran with the source repo's own AsciiDoc templates, copied .adoc files into content/contracts/latest/api/, fumadocs couldn't route them, and every guide xref into the API 404'd — 200 errors in next-validate-link.

What this PR does

• Sniff the layout in injectTemplates. If the cloned repo has docs/config.mjs, treat it as the new layout; otherwise fall through to the legacy code path unchanged.
• For the new layout:
  • Overwrite docs/config.mjs with docgen/config-md.mjs (forces pageExtension: '.mdx' and templates: 'docs/templates').
  • Wipe and re-populate docs/templates/, renaming helpers.js / properties.js to .cjs (the hardhat3 branch sets \"type\": \"module\" so plain .js would be treated as ESM and our module.exports would break). Patch the internal require('./helpers') in properties.cjs accordingly.
  • Emit thin ESM shim files helpers.ts / properties.ts that re-export each function — the new plugin's loader only walks .ts named exports.
• Rename kebab-case helpers (oz-version, has-functions, typed-params, …) to camelCase across templates and helpers/properties modules. ESM named exports can't carry hyphens, and Handlebars is name-agnostic, so this is transparent to solidity-docgen on older tags.

Verified locally

Ran the updated generate-api-docs.js against the hardhat3 branch end to end (hardhat docgen + convert-adoc.js + pnpm run lint:links). 200 → 1 broken link. The residual is a pre-existing EIP712 NatSpec xref to /<base>/learn/upgrading-smart-contracts that also fails today on content/contracts/5.x/ — unrelated to this change.

Test plan

• Re-run Generate API Docs - Contracts with tag_name: hardhat3 and trigger_type: commit; confirm the validate step is clean (or only flags the EIP712 learn-module xref).
• Re-run Generate API Docs - Contracts with default tag_name: v5.6.1; confirm legacy path still works.
• Spot-check the resulting PR against the live site: anchors like /contracts/latest/api/access#AccessManager-RoleRevoked-uint64-address- resolve.

🤖 Generated with Claude Code

[netlify]

✅ Deploy Preview for openzeppelin-docs-v2 ready!

Name	Link
🔨 Latest commit	ae4ad28
🔍 Latest deploy log	https://app.netlify.com/projects/openzeppelin-docs-v2/deploys/6a191c9ea5b7d1000841c142
😎 Deploy Preview	https://deploy-preview-174--openzeppelin-docs-v2.netlify.app
📱 Preview on mobile	Toggle QR Code... Use your smartphone camera to open QR code link.

---

To edit notification comments on pull requests, go to your Netlify project configuration.

[Amxx]

I believe this is usually done using

Suggested change

	return [
	`import ${varName} from '${sourcePath}';`,
	"",
	...exports.map(e => `export const ${e} = ${varName}.${e};`),
	"",
	].join("\n");
	return `export { `e.join(",")` } from "${sourcePath}";`;

Basically, that gives things like what we can find in ethers.ts

export {
    getAddress, getIcapAddress,
    getCreateAddress, getCreate2Address,
    isAddressable, isAddress, resolveAddress
} from "./address/index.js";

[Amxx]

that is assuming we don't need the varName to be declared and its only used as an intermediary

[Amxx]

Suggested change

	let newLayout = false;
	try {
	await fs.access(path.join(tempDir, "docs", "config.mjs"));
	newLayout = true;
	} catch {}
	const newLayout = await fs.access(path.join(tempDir, "docs", "config.mjs")).then(() => true, () => false);