Fix docFxZip archive naming to use original source file name

- Store original source file name before updating to docfx.json
- Use original source file name for zip archive base name
- Allows override via archiveBaseName property on docFxZip task
- Results in: {originalSourceFileName}-docfx.zip format

Author: gamma

CHANGELOG.md

@@ -1,5 +1,13 @@
 # gradle-docfx-plugin changelog
 
+## 0.1.0
+
+### Fixed
+* **Fixed docFxZip archive naming**: Zip archive now uses the original source file name (e.g., `inetsoftware.Reporting.dll`) instead of the generated `docfx.json` filename
+  * Archive name format: `{originalSourceFileName}-docfx.zip` (e.g., `inetsoftware.Reporting.dll-docfx.zip`)
+  * Users can override by setting `archiveBaseName` on the `docFxZip` task in `build.gradle`
+  * This ensures consistent artifact naming that matches the source assembly
+
 ## 0.0.9
 
 ### Added

gradle.properties

@@ -1 +1 @@
-version = 0.1.0-SNAPSHOT
+version = 0.1.0

src/main/groovy/de/inetsoftware/docfx/DocFxPlugin.groovy

@@ -82,30 +82,62 @@ class DocFxPlugin implements Plugin<Project> {
                 into "/"
             }
 
-            // Set archive base name from source file name
-            def baseName = sourceFile.name
-            if (baseName.endsWith('.json')) {
-                baseName = baseName.substring(0, baseName.length() - 5)
-            }
+            // Set archive base name from original source file name (if available)
+            // This allows the zip to be named after the original source (e.g., inetsoftware.Reporting.dll)
+            // instead of the generated docfx.json file
+            // User can override this by setting archiveBaseName on docFxZip task in build.gradle
+            def baseName = null
 
-            // Set archiveBaseName (works for both Gradle 8 and 9)
+            // Check if user has already set archiveBaseName
+            def currentBaseName = null
             try {
                 if (zipTask.hasProperty('archiveBaseName')) {
                     def prop = zipTask.archiveBaseName
                     if (prop instanceof org.gradle.api.provider.Property) {
                         // Gradle 9+ - Property API
-                        if (!prop.isPresent() || prop.get() == project.name) {
-                            prop.set(baseName)
+                        if (prop.isPresent()) {
+                            currentBaseName = prop.get()
                         }
                     } else {
                         // Gradle 8 - direct property
-                        if (prop == null || prop == project.name) {
+                        currentBaseName = prop
+                    }
+                }
+            } catch (Exception e) {
+                // Ignore
+            }
+            
+            // Only set archiveBaseName if user hasn't set it and it's still the default (project.name)
+            if (currentBaseName == null || currentBaseName == project.name) {
+                // Use original source file name if available (stored before docFx updated extension.source)
+                if (extension.originalSourceFileName != null && !extension.originalSourceFileName.trim().isEmpty()) {
+                    baseName = extension.originalSourceFileName
+                    project.logger.debug("docFxZip: Using original source file name for archive: ${baseName}")
+                } else {
+                    // Fallback to current source file name (docfx.json)
+                    baseName = sourceFile.name
+                    if (baseName.endsWith('.json')) {
+                        baseName = baseName.substring(0, baseName.length() - 5)
+                    }
+                }
+                
+                // Set archiveBaseName (works for both Gradle 8 and 9)
+                try {
+                    if (zipTask.hasProperty('archiveBaseName')) {
+                        def prop = zipTask.archiveBaseName
+                        if (prop instanceof org.gradle.api.provider.Property) {
+                            // Gradle 9+ - Property API
+                            prop.set(baseName)
+                        } else {
+                            // Gradle 8 - direct property
                             zipTask.archiveBaseName = baseName
                         }
                     }
+                } catch (Exception e) {
+                    project.logger.debug("Could not set archiveBaseName: ${e.message}")
                 }
-            } catch (Exception e) {
-                project.logger.debug("Could not set archiveBaseName: ${e.message}")
+            } else {
+                project.logger.debug("docFxZip: Using user-configured archiveBaseName: ${currentBaseName}")
             }
 
             // Configure inputs/outputs for up-to-date checking

src/main/groovy/de/inetsoftware/docfx/DocfxExtension.groovy

@@ -15,6 +15,10 @@ class DocfxExtension {
     Map<String, String> environment = [:]
     Closure additionalResources = null
 
+    // Internal: stores original source file name before it's updated to docfx.json
+    // Used by zip task to name the archive based on original source (e.g., inetsoftware.Reporting.dll)
+    String originalSourceFileName = null
+    
     // DocFX configuration options for auto-generated docfx.json
     String template = "statictoc"
     String markdownEngine = "markdig"

src/main/groovy/de/inetsoftware/docfx/Docs.groovy

@@ -35,6 +35,11 @@ class Docs extends DocfxDefaultTask {
             return
         }
 
+        // Store original source file name for zip task naming (before we update extension.source)
+        // This allows the zip task to use the original file name (e.g., inetsoftware.Reporting.dll)
+        // instead of the generated docfx.json name
+        extension.originalSourceFileName = sourceFile.name
+
         // Auto-generate docfx.json if source is not a JSON file
         File docfxJsonFile
         if (!extension.isSourceJsonFile()) {