From bc8421ee0eb4fe0da9a8d3a005098cb3e74f163a Mon Sep 17 00:00:00 2001
From: Rob Marsal <rob@reveng.ai>
Date: Mon, 13 Oct 2025 17:41:46 +0100
Subject: [PATCH 1/2] fix: typescript docs not being put in a docs directory

---
 .../codegen/languages/TypeScriptClientCodegen.java       | 9 +++++++++
 1 file changed, 9 insertions(+)

diff --git a/modules/openapi-generator/src/main/java/org/openapitools/codegen/languages/TypeScriptClientCodegen.java b/modules/openapi-generator/src/main/java/org/openapitools/codegen/languages/TypeScriptClientCodegen.java
index b3305c904f5b..896ec2dbcc50 100644
--- a/modules/openapi-generator/src/main/java/org/openapitools/codegen/languages/TypeScriptClientCodegen.java
+++ b/modules/openapi-generator/src/main/java/org/openapitools/codegen/languages/TypeScriptClientCodegen.java
@@ -100,6 +100,8 @@ public class TypeScriptClientCodegen extends AbstractTypeScriptClientCodegen imp
     private final DateTimeFormatter iso8601Date = DateTimeFormatter.ISO_DATE;
     private final DateTimeFormatter iso8601DateTime = DateTimeFormatter.ISO_DATE_TIME;
 
+    protected String apiDocPath = "docs/";
+
     public TypeScriptClientCodegen() {
         super();
 
@@ -400,6 +402,11 @@ public ModelsMap postProcessModels(ModelsMap objs) {
         return objs;
     }
 
+    @Override
+    public String apiDocFileFolder() {
+        return (outputFolder + File.separator + apiDocPath);
+    }
+
     private List<Map<String, String>> toTsImports(CodegenModel cm, Set<String> imports) {
         List<Map<String, String>> tsImports = new ArrayList<>();
         for (String im : imports) {
@@ -432,6 +439,8 @@ public void processOpts() {
         apiPackage = this.apiPackage + ".apis";
         testPackage = this.testPackage + ".tests";
 
+        additionalProperties.put("apiDocPath", apiDocPath);
+
         additionalProperties.putIfAbsent(FRAMEWORK_SWITCH, FRAMEWORKS[0]);
         supportingFiles.add(new SupportingFile("index.mustache", "index.ts"));
 

From 12c84d2a4b1e2aac6d401dda15ecf63dfc9db4cf Mon Sep 17 00:00:00 2001
From: Rob Marsal <rob@reveng.ai>
Date: Tue, 14 Oct 2025 12:48:33 +0100
Subject: [PATCH 2/2] fix: platform agnostic path separator

---
 .../openapitools/codegen/languages/TypeScriptClientCodegen.java | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/modules/openapi-generator/src/main/java/org/openapitools/codegen/languages/TypeScriptClientCodegen.java b/modules/openapi-generator/src/main/java/org/openapitools/codegen/languages/TypeScriptClientCodegen.java
index 896ec2dbcc50..3ab788ef8b14 100644
--- a/modules/openapi-generator/src/main/java/org/openapitools/codegen/languages/TypeScriptClientCodegen.java
+++ b/modules/openapi-generator/src/main/java/org/openapitools/codegen/languages/TypeScriptClientCodegen.java
@@ -404,7 +404,7 @@ public ModelsMap postProcessModels(ModelsMap objs) {
 
     @Override
     public String apiDocFileFolder() {
-        return (outputFolder + File.separator + apiDocPath);
+        return (outputFolder + "/" + apiDocPath).replace('/', File.separatorChar);
     }
 
     private List<Map<String, String>> toTsImports(CodegenModel cm, Set<String> imports) {