rohit-gohri · Mar 20, 2025 · Mar 20, 2025 · Mar 20, 2025 · Mar 20, 2025 · Mar 20, 2025
diff --git a/CHANGELOG.md b/CHANGELOG.md
@@ -1,5 +1,14 @@
 # Redocusaurus
 
+## redocusaurus@2.2.2
+
+
+## docusaurus-plugin-redoc@2.2.2
+
+
+## docusaurus-theme-redoc@2.2.2
+
+
 ## redocusaurus@2.2.1
 
 

diff --git a/packages/docusaurus-plugin-redoc/CHANGELOG.md b/packages/docusaurus-plugin-redoc/CHANGELOG.md
@@ -1,5 +1,11 @@
 # docusaurus-plugin-redoc
 
+## 2.2.2
+
+### Patch Changes
+
+- [#402](https://github.com/rohit-gohri/redocusaurus/pull/402) [`ba2bd9c`](https://github.com/rohit-gohri/redocusaurus/commit/ba2bd9c5964df7f88ce1b5e7c08d2fcf5cd889f3) Thanks [@ctreatma](https://github.com/ctreatma)! - Add support for relative spec download URLs
+
 ## 2.2.1
 
 ### Patch Changes

diff --git a/packages/docusaurus-plugin-redoc/package.json b/packages/docusaurus-plugin-redoc/package.json
@@ -1,6 +1,6 @@
 {
   "name": "docusaurus-plugin-redoc",
-  "version": "2.2.1",
+  "version": "2.2.2",
   "description": "Redoc Plugin for DocusaurusV2",
   "main": "dist/index.js",
   "types": "dist/index.d.ts",

diff --git a/packages/docusaurus-plugin-redoc/src/index.ts b/packages/docusaurus-plugin-redoc/src/index.ts
@@ -42,7 +42,7 @@ export default function redocPlugin(
 }> {
   const { baseUrl } = context.siteConfig;
   const options: PluginOptionsWithDefault = { ...DEFAULT_OPTIONS, ...opts };
-  const { debug, spec, url: downloadUrl, config, themeId } = options;
+  const { debug, spec, url: downloadUrl, config, themeId, normalizeUrl: normalizeDownloadUrl } = options;
 
   let url = downloadUrl;
   const isSpecFile = fs.existsSync(spec);
@@ -127,6 +127,7 @@ export default function redocPlugin(
         url,
         themeId,
         isSpecFile,
+        normalizeUrl: normalizeDownloadUrl,
         // eslint-disable-next-line @typescript-eslint/no-explicit-any
         spec: content.converted as any,
       };

diff --git a/packages/docusaurus-plugin-redoc/src/options.ts b/packages/docusaurus-plugin-redoc/src/options.ts
@@ -35,6 +35,7 @@ export interface PluginOptions extends PluginDirectUsageOptions {
   spec: string;
   url?: string;
   route?: string;
+  normalizeUrl?: boolean;
 }
 
 export interface PluginOptionsWithDefault extends PluginOptions {
@@ -44,6 +45,7 @@ export interface PluginOptionsWithDefault extends PluginOptions {
 export const DEFAULT_OPTIONS = {
   layout: {},
   debug: false,
+  normalizeUrl: true,
 } satisfies Omit<PluginOptions, 'spec'>;
 
 export const PluginOptionSchema = Joi.object<PluginOptions>({
@@ -56,6 +58,7 @@ export const PluginOptionSchema = Joi.object<PluginOptions>({
   // Basic
   spec: Joi.string(),
   url: Joi.string().uri({ allowRelative: true }).optional(),
+  normalizeUrl: Joi.boolean().default(DEFAULT_OPTIONS.normalizeUrl),
   route: Joi.string().uri({ relativeOnly: true }).optional(),
   layout: Joi.any().default(DEFAULT_OPTIONS.layout),
 });
diff --git a/packages/docusaurus-theme-redoc/CHANGELOG.md b/packages/docusaurus-theme-redoc/CHANGELOG.md
@@ -1,5 +1,11 @@
 # docusaurus-theme-redoc
 
+## 2.2.2
+
+### Patch Changes
+
+- [#402](https://github.com/rohit-gohri/redocusaurus/pull/402) [`ba2bd9c`](https://github.com/rohit-gohri/redocusaurus/commit/ba2bd9c5964df7f88ce1b5e7c08d2fcf5cd889f3) Thanks [@ctreatma](https://github.com/ctreatma)! - Add support for relative spec download URLs
+
 ## 2.2.1
 
 ### Patch Changes

diff --git a/packages/docusaurus-theme-redoc/package.json b/packages/docusaurus-theme-redoc/package.json
@@ -1,6 +1,6 @@
 {
   "name": "docusaurus-theme-redoc",
-  "version": "2.2.1",
+  "version": "2.2.2",
   "description": "Redoc Component for DocusaurusV2",
   "main": "dist/index.js",
   "types": "dist/index.d.ts",

diff --git a/packages/docusaurus-theme-redoc/src/redocData.ts b/packages/docusaurus-theme-redoc/src/redocData.ts
@@ -30,7 +30,7 @@ const getDefaultTheme = (
         prism: {
           additionalLanguages: ['scala'],
         },
-      },
+      }
     },
     customTheme,
   );
@@ -148,6 +148,7 @@ export function getRedocThemes(
 export async function getGlobalData({
   primaryColor,
   primaryColorDark = primaryColor,
+  //normalizeUrl = true,
   theme: customThemeDeprecated,
   options,
 }: ThemeOptions): Promise<GlobalData> {

diff --git a/packages/docusaurus-theme-redoc/src/theme/Redoc/ServerStyles.tsx b/packages/docusaurus-theme-redoc/src/theme/Redoc/ServerStyles.tsx
@@ -40,7 +40,8 @@ export function ServerStyles({
   lightThemeOptions: RedocRawOptions;
   darkThemeOptions: RedocRawOptions;
 }) {
-  const fullUrl = useBaseUrl(specProps.url, { absolute: true });
+  const absoluteUrl = useBaseUrl(specProps.url, { absolute: true });
+  const fullUrl = specProps.normalizeUrl ? absoluteUrl : specProps.url;
 
   const lightCss = prefixCssSelectors(
     renderCss(new AppStore(specProps.spec, fullUrl, lightThemeOptions)),

diff --git a/packages/docusaurus-theme-redoc/src/types/common.ts b/packages/docusaurus-theme-redoc/src/types/common.ts
@@ -9,6 +9,7 @@ export interface SpecProps {
   url?: string;
   isSpecFile?: boolean;
   themeId?: string;
+  normalizeUrl?: boolean;
 }
 
 export type RedocProps = SpecProps;

diff --git a/packages/docusaurus-theme-redoc/src/types/modules.ts b/packages/docusaurus-theme-redoc/src/types/modules.ts
@@ -4,6 +4,7 @@ interface SpecProps {
   url?: string;
   isSpecFile?: boolean;
   themeId?: string;
+  normalizeUrl?: boolean;
 }
 
 declare module '@theme/Redoc' {

diff --git a/packages/docusaurus-theme-redoc/src/utils/useSpec.ts b/packages/docusaurus-theme-redoc/src/utils/useSpec.ts
@@ -17,11 +17,12 @@ let currentStore: AppStore | null = null;
  * Released under the MIT License
  */
 export function useSpec(
-  { spec, url, themeId }: SpecProps,
+  { spec, url, themeId, normalizeUrl }: SpecProps,
   optionsOverrides?: RedocRawOptions,
 ) {
   const specOptions = useSpecOptions(themeId, optionsOverrides);
-  const fullUrl = useBaseUrl(url, { absolute: true });
+  const absoluteUrl = useBaseUrl(url, { absolute: true });
+  const fullUrl = normalizeUrl ? absoluteUrl : url;
   const isBrowser = useIsBrowser();
   const isDarkTheme = useColorMode().colorMode === 'dark';
 

diff --git a/packages/redocusaurus/CHANGELOG.md b/packages/redocusaurus/CHANGELOG.md
@@ -1,5 +1,13 @@
 # redocusaurus
 
+## 2.2.2
+
+### Patch Changes
+
+- Updated dependencies [[`ba2bd9c`](https://github.com/rohit-gohri/redocusaurus/commit/ba2bd9c5964df7f88ce1b5e7c08d2fcf5cd889f3)]:
+  - docusaurus-plugin-redoc@2.2.2
+  - docusaurus-theme-redoc@2.2.2
+
 ## 2.2.1
 
 ### Patch Changes

diff --git a/packages/redocusaurus/package.json b/packages/redocusaurus/package.json
@@ -1,6 +1,6 @@
 {
   "name": "redocusaurus",
-  "version": "2.2.1",
+  "version": "2.2.2",
   "description": "Redoc for DocusaurusV2",
   "main": "dist/index.js",
   "exports": {
@@ -41,8 +41,8 @@
   },
   "homepage": "https://redocusaurus.vercel.app/",
   "dependencies": {
-    "docusaurus-plugin-redoc": "2.2.1",
-    "docusaurus-theme-redoc": "2.2.1"
+    "docusaurus-plugin-redoc": "2.2.2",
+    "docusaurus-theme-redoc": "2.2.2"
   },
   "peerDependencies": {
     "@docusaurus/theme-common": "^3.6.0",

diff --git a/website/package.json b/website/package.json
@@ -30,7 +30,7 @@
     "clsx": "^1.2.1",
     "react": "^18.3.1",
     "react-dom": "^18.3.1",
-    "redocusaurus": "^2.2.1"
+    "redocusaurus": "^2.2.2"
   },
   "devDependencies": {
     "@percy/cli": "^1.28.8",