Upgrade to Docusaurus 3.10 and OpenAPI docs 5.0 (PaloAltoNetworks#1187)

* Upgrade to Docusaurus 3.10, openapi-docs 5.0

- Bump all @docusaurus/* packages from 3.9.2 to 3.10.0
- Bump docusaurus-plugin-openapi-docs and docusaurus-theme-openapi-docs from 4.7.1 to 5.0.0
- Rename future.experimental_faster to future.faster (renamed in 3.10)
- Fix DocCardProduct import: findFirstCategoryLink was renamed to findFirstSidebarItemLink and moved to @docusaurus/plugin-content-docs/client

Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>

* Fix HTML comment in MDX file for Docusaurus 3.10 compatibility

Convert HTML comment (<!-- -->) to MDX comment ({/* */}) in
terraform/docs/cloudngfw/intro.mdx. Docusaurus 3.10 with future.v4
enables stricter MDX parsing that rejects HTML comments.

Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>

* Bump fast-xml-parser to ^4.5.5 to fix 5 security vulnerabilities

Resolves CVEs affecting fast-xml-parser < 4.5.5: entity encoding
bypass via regex injection (critical), DoS through entity expansion
(high), numeric entity expansion bypass (high), entity expansion
limits bypass (medium), and stack overflow in XMLBuilder (low).

Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>

---------

Co-authored-by: Claude Opus 4.6 <noreply@anthropic.com>

Author: sserrata

docusaurus.config.ts

@@ -21,7 +21,7 @@ if (process.env.CI_MERGE_REQUEST_IID) {
 
 const config = {
   future: {
-    experimental_faster: (process.env.DOCUSAURUS_FASTER ?? "true") === "true",
+    faster: (process.env.DOCUSAURUS_FASTER ?? "true") === "true",
     v4: true
   },
   title: "Develop with Palo Alto Networks",

package.json

@@ -45,20 +45,20 @@
   },
   "dependencies": {
     "@docsearch/react": "^4.6.2",
-    "@docusaurus/core": "3.9.2",
-    "@docusaurus/faster": "3.9.2",
-    "@docusaurus/plugin-client-redirects": "3.9.2",
-    "@docusaurus/preset-classic": "3.9.2",
-    "@docusaurus/theme-classic": "3.9.2",
-    "@docusaurus/theme-mermaid": "3.9.2",
+    "@docusaurus/core": "3.10.0",
+    "@docusaurus/faster": "3.10.0",
+    "@docusaurus/plugin-client-redirects": "3.10.0",
+    "@docusaurus/preset-classic": "3.10.0",
+    "@docusaurus/theme-classic": "3.10.0",
+    "@docusaurus/theme-mermaid": "3.10.0",
     "@tabler/icons-react": "^3.41.1",
     "@tailwindcss/postcss": "^4.2.2",
     "algoliasearch": "^5.50.1",
     "clsx": "^1.2.1",
-    "docusaurus-plugin-openapi-docs": "4.7.1",
+    "docusaurus-plugin-openapi-docs": "5.0.0",
     "docusaurus-plugin-sass": "^0.2.2",
-    "docusaurus-theme-openapi-docs": "4.7.1",
-    "fast-xml-parser": "^4.0.10",
+    "docusaurus-theme-openapi-docs": "5.0.0",
+    "fast-xml-parser": "^4.5.5",
     "motion": "^12.38.0",
     "@pandev/plugin-sitemap-coveo": "./plugin-sitemap-coveo",
     "react": "^19.2.4",

products/terraform/docs/cloudngfw/intro.mdx

@@ -23,14 +23,14 @@ Cloud NGFW can be deployed and configured with [Terraform](https://www.terraform
 
 - **Cloud NGFW for Azure is leveraging the existing Azurerm provider**
 
-<!---
+{/*
 This documentation is split into four sections:
 
 - Getting started tutorials: Start here if you are new to Terraform for Cloud NGFW
 - How-to guides: Useful for achieving specific real-world objectives or solving specific real-world challenges
 - Background info: Higher level content discussing the "why"
 - Reference documentation: Lists the modules available for Cloud NGFW, with their correct usage including examples
--->
+*/}
 
 ## Provider Reference
 

src/theme/DocCardProduct/index.js

@@ -8,9 +8,9 @@ import React from "react";
 import clsx from "clsx";
 import Link from "@docusaurus/Link";
 import {
-  findFirstCategoryLink,
+  findFirstSidebarItemLink,
   useDocById,
-} from "@docusaurus/theme-common/internal";
+} from "@docusaurus/plugin-content-docs/client";
 import isInternalUrl from "@docusaurus/isInternalUrl";
 import styles from "./styles.module.css";
 function CardContainer({ href, children }) {
@@ -38,7 +38,7 @@ function CardLayout({ href, icon, title, description }) {
   );
 }
 function CardCategory({ item }) {
-  const href = findFirstCategoryLink(item);
+  const href = findFirstSidebarItemLink(item);
   return (
     <CardLayout
       href={href}