chore: Regenerate llms.txs and add new shared section

Author: zeljkoX

README.md

@@ -114,6 +114,14 @@ In the case you want to setup an automated GitHub workflow to create these API d
 3. Follow existing directory structure for consistency
 4. Update navigation if adding new product categories
 
+### Updating `llms.txt`
+
+The `public/llms.txt` file is generated from the navigation tree and MDX frontmatter. Run the generator whenever you add, remove, rename, or reorder navigation items, or when you update page descriptions that should appear in `llms.txt`.
+
+```bash
+pnpm run generate:llms-txt
+```
+
 ### Versioning
 
 - Version-specific content in numbered subdirectories (e.g., `contracts/4.x/`)

public/llms.txt

@@ -2,7 +2,7 @@
 
 > Security-first libraries, tools, and infrastructure for building on Ethereum and other blockchains. Covers smart contract libraries for Solidity, Cairo, Stylus, Sui, Midnight, Stellar, Zama FHEVM, and Polkadot; operational tools (Defender, Monitor, Relayer, UI Builder); and the Upgrades Plugins and Contract Wizard.
 
-Each ecosystem section lists the smart-contract libraries and language-specific guides for that chain. Cross-ecosystem tools — Defender, Monitor, Relayer, UI Builder, Role Manager — are grouped at the end under "Open Source Tools" to avoid duplication. Unversioned URLs (for example `/contracts/`) redirect to the latest supported version.
+Each ecosystem section lists the smart-contract libraries and language-specific guides for that chain. Cross-ecosystem developer libraries and tools are grouped at the end to avoid duplication. Unversioned URLs (for example `/contracts/`) redirect to the latest supported version.
 
 ## Ethereum & EVM
 
@@ -444,6 +444,21 @@ Each ecosystem section lists the smart-contract libraries and language-specific
 - [Innovation & Research — Privacy](https://docs.openzeppelin.com/impact/privacy)
 - [Innovation & Research — Tokenization & Real World Assets](https://docs.openzeppelin.com/impact/tokenization-and-real-world-assets)
 
+## Developer Libraries
+
+- [Ecosystem Adapters — Overview](https://docs.openzeppelin.com/ecosystem-adapters)
+- [Ecosystem Adapters — Architecture](https://docs.openzeppelin.com/ecosystem-adapters/architecture)
+- [Ecosystem Adapters — Getting Started](https://docs.openzeppelin.com/ecosystem-adapters/getting-started)
+- [Ecosystem Adapters — Supported Ecosystems](https://docs.openzeppelin.com/ecosystem-adapters/supported-ecosystems)
+- [Ecosystem Adapters — Building an Adapter](https://docs.openzeppelin.com/ecosystem-adapters/building-an-adapter)
+- [UIKit — Overview](https://docs.openzeppelin.com/tools/uikit)
+- [UIKit — Getting Started](https://docs.openzeppelin.com/tools/uikit/getting-started)
+- [UIKit — Architecture](https://docs.openzeppelin.com/tools/uikit/architecture)
+- [UIKit — Components](https://docs.openzeppelin.com/tools/uikit/components)
+- [UIKit — React Integration](https://docs.openzeppelin.com/tools/uikit/react-integration)
+- [UIKit — Theming & Styling](https://docs.openzeppelin.com/tools/uikit/theming)
+- [UIKit — Storage](https://docs.openzeppelin.com/tools/uikit/storage)
+
 ## Open Source Tools
 
 - [Relayer — Overview](https://docs.openzeppelin.com/relayer/1.4.x)

scripts/generate-llms-txt.ts

@@ -38,10 +38,15 @@ const INTRO = `# OpenZeppelin Docs
 
 > Security-first libraries, tools, and infrastructure for building on Ethereum and other blockchains. Covers smart contract libraries for Solidity, Cairo, Stylus, Sui, Midnight, Stellar, Zama FHEVM, and Polkadot; operational tools (Defender, Monitor, Relayer, UI Builder); and the Upgrades Plugins and Contract Wizard.
 
-Each ecosystem section lists the smart-contract libraries and language-specific guides for that chain. Cross-ecosystem tools — Defender, Monitor, Relayer, UI Builder, Role Manager — are grouped at the end under "Open Source Tools" to avoid duplication. Unversioned URLs (for example \`/contracts/\`) redirect to the latest supported version.
+Each ecosystem section lists the smart-contract libraries and language-specific guides for that chain. Cross-ecosystem developer libraries and tools are grouped at the end to avoid duplication. Unversioned URLs (for example \`/contracts/\`) redirect to the latest supported version.
 `;
 
-const SHARED_TOOLS_SEPARATOR = "Open Source Tools";
+const SHARED_SECTION_NAMES = [
+	"Developer Libraries",
+	"Open Source Tools",
+] as const;
+type SharedSectionName = (typeof SHARED_SECTION_NAMES)[number];
+const SHARED_SECTION_NAME_SET = new Set<string>(SHARED_SECTION_NAMES);
 
 const frontmatterCache = new Map<
 	string,
@@ -160,18 +165,32 @@ function walk(nodes: NavigationNode[], ctx: WalkContext): void {
 	}
 }
 
-function splitSharedTools(nodes: NavigationNode[]): {
+function splitSharedSections(nodes: NavigationNode[]): {
 	ecosystem: NavigationNode[];
-	shared: NavigationNode[];
+	shared: Map<SharedSectionName, NavigationNode[]>;
 } {
-	const separatorIndex = nodes.findIndex(
-		(n) => n.type === "separator" && n.name === SHARED_TOOLS_SEPARATOR,
-	);
-	if (separatorIndex === -1) return { ecosystem: nodes, shared: [] };
-	return {
-		ecosystem: nodes.slice(0, separatorIndex),
-		shared: nodes.slice(separatorIndex + 1),
-	};
+	const ecosystem: NavigationNode[] = [];
+	const shared = new Map<SharedSectionName, NavigationNode[]>();
+	let currentSharedSection: SharedSectionName | null = null;
+
+	for (const node of nodes) {
+		if (node.type === "separator" && SHARED_SECTION_NAME_SET.has(node.name)) {
+			currentSharedSection = node.name as SharedSectionName;
+			if (!shared.has(currentSharedSection)) {
+				shared.set(currentSharedSection, []);
+			}
+			continue;
+		}
+
+		if (currentSharedSection) {
+			shared.get(currentSharedSection)?.push(node);
+			continue;
+		}
+
+		ecosystem.push(node);
+	}
+
+	return { ecosystem, shared };
 }
 
 function mergeByName(nodes: NavigationNode[]): NavigationNode[] {
@@ -234,12 +253,11 @@ function renderSection(
 }
 
 function main(): void {
-	const sharedSeen = new Set<string>();
 	const ecosystemSections: string[] = [];
-	const sharedToolNodes: NavigationNode[] = [];
+	const sharedSectionNodes = new Map<SharedSectionName, NavigationNode[]>();
 
 	for (const tree of TREES) {
-		const { ecosystem, shared } = splitSharedTools(tree.children);
+		const { ecosystem, shared } = splitSharedSections(tree.children);
 
 		const section = renderSection(
 			`## ${tree.name}`,
@@ -248,17 +266,22 @@ function main(): void {
 		);
 		if (section) ecosystemSections.push(section);
 
-		for (const node of shared) sharedToolNodes.push(node);
+		for (const [sectionName, nodes] of shared) {
+			const existing = sharedSectionNodes.get(sectionName) ?? [];
+			sharedSectionNodes.set(sectionName, [...existing, ...nodes]);
+		}
 	}
 
-	const toolsSection = renderSection(
-		`## Open Source Tools`,
-		mergeByName(sharedToolNodes),
-		sharedSeen,
-	);
-
 	const parts = [INTRO, ...ecosystemSections];
-	if (toolsSection) parts.push(toolsSection);
+	for (const sectionName of SHARED_SECTION_NAMES) {
+		const nodes = sharedSectionNodes.get(sectionName) ?? [];
+		const section = renderSection(
+			`## ${sectionName}`,
+			mergeByName(nodes),
+			new Set<string>(),
+		);
+		if (section) parts.push(section);
+	}
 
 	writeFileSync(OUTPUT_PATH, parts.join("\n"), "utf8");